Table of Contents

Class SandboxStatus

Namespace
Openshell.V1
Assembly
OpenShell.Sdk.dll

User-facing sandbox status derived by the gateway from compute-driver observations.

Public status does not embed driver-only flags such as deleting.

public sealed class SandboxStatus : IMessage<SandboxStatus>, IEquatable<SandboxStatus>, IDeepCloneable<SandboxStatus>, IBufferMessage, IMessage
Inheritance
SandboxStatus
Implements
IMessage<SandboxStatus>
IDeepCloneable<SandboxStatus>
IBufferMessage
IMessage
Inherited Members

Constructors

SandboxStatus() 

public SandboxStatus()

SandboxStatus(SandboxStatus) 

public SandboxStatus(SandboxStatus other)

Parameters

other SandboxStatus

Fields

AgentFdFieldNumber

Field number for the "agent_fd" field.

public const int AgentFdFieldNumber = 3

Field Value

int

AgentPodFieldNumber

Field number for the "agent_pod" field.

public const int AgentPodFieldNumber = 2

Field Value

int

ConditionsFieldNumber

Field number for the "conditions" field.

public const int ConditionsFieldNumber = 5

Field Value

int

ConfigurationActivatedFieldNumber

Field number for the "configuration_activated" field.

public const int ConfigurationActivatedFieldNumber = 12

Field Value

int

ConfigurationAdmissionFieldNumber

Field number for the "configuration_admission" field.

public const int ConfigurationAdmissionFieldNumber = 11

Field Value

int

CurrentPolicyVersionFieldNumber

Field number for the "current_policy_version" field.

public const int CurrentPolicyVersionFieldNumber = 7

Field Value

int

EndpointStatusesFieldNumber

Field number for the "endpoint_statuses" field.

public const int EndpointStatusesFieldNumber = 10

Field Value

int

ExitCodeFieldNumber

Field number for the "exit_code" field.

public const int ExitCodeFieldNumber = 9

Field Value

int

LastTokenGrantFailureFieldNumber

Field number for the "last_token_grant_failure" field.

public const int LastTokenGrantFailureFieldNumber = 17

Field Value

int

MainProcessInstanceIdFieldNumber

Field number for the "main_process_instance_id" field.

public const int MainProcessInstanceIdFieldNumber = 8

Field Value

int

MainProcessStartedTimeFieldNumber

Field number for the "main_process_started_time" field.

public const int MainProcessStartedTimeFieldNumber = 16

Field Value

int

NextRestartTimeFieldNumber

Field number for the "next_restart_time" field.

public const int NextRestartTimeFieldNumber = 15

Field Value

int

PhaseFieldNumber

Field number for the "phase" field.

public const int PhaseFieldNumber = 6

Field Value

int

ProvisioningFieldNumber

Field number for the "provisioning" field.

public const int ProvisioningFieldNumber = 13

Field Value

int

RestartCountFieldNumber

Field number for the "restart_count" field.

public const int RestartCountFieldNumber = 14

Field Value

int

SandboxFdFieldNumber

Field number for the "sandbox_fd" field.

public const int SandboxFdFieldNumber = 4

Field Value

int

Properties

AgentFd

File descriptor or endpoint for reaching the agent service, when available.

public string AgentFd { get; set; }

Property Value

string

AgentPod

Name of the agent pod or equivalent runtime instance.

public string AgentPod { get; set; }

Property Value

string

Conditions

Latest user-facing readiness and lifecycle conditions.

public RepeatedField<SandboxCondition> Conditions { get; }

Property Value

RepeatedField<SandboxCondition>

ConfigurationActivated

Durable first-acceptance marker. Absent on legacy records; never reset by restart.

public bool ConfigurationActivated { get; set; }

Property Value

bool

ConfigurationAdmission

Independent of infrastructure phase; retained across driver observations.

public SandboxConfigurationAdmission ConfigurationAdmission { get; set; }

Property Value

SandboxConfigurationAdmission

CurrentPolicyVersion

Currently active policy version (updated when sandbox reports loaded).

public uint CurrentPolicyVersion { get; set; }

Property Value

uint

Descriptor 

public static MessageDescriptor Descriptor { get; }

Property Value

MessageDescriptor

EndpointStatuses

Last accepted network result for each configured tool server endpoint. Currently populated for MCP-over-HTTP endpoints. These passive results remain separate from sandbox lifecycle conditions and readiness.

public RepeatedField<EndpointStatus> EndpointStatuses { get; }

Property Value

RepeatedField<EndpointStatus>

ExitCode

Most recent normalized main process result. Signal exits use 128 + signal number. Cleared when a replacement main process becomes ready.

public int ExitCode { get; set; }

Property Value

int

HasConfigurationActivated

Gets whether the "configuration_activated" field is set

public bool HasConfigurationActivated { get; }

Property Value

bool

HasExitCode

Gets whether the "exit_code" field is set

public bool HasExitCode { get; }

Property Value

bool

LastTokenGrantFailure

Latest refused token grant across all outbound HTTP protocols, including failures before a configured endpoint or credential could be selected. Matching grant success or a policy, provider, or supervisor reset clears it.

public TokenGrantFailureObservation LastTokenGrantFailure { get; set; }

Property Value

TokenGrantFailureObservation

MainProcessInstanceId

Supervisor instance currently associated with the canonical main process. The gateway uses this to reject stale exit reports after a restart.

public string MainProcessInstanceId { get; set; }

Property Value

string

MainProcessStartedTime

Time when the current main process became ready.

public Timestamp MainProcessStartedTime { get; set; }

Property Value

Timestamp

NextRestartTime

Deadline for the next restart attempt or recovery check.

public Timestamp NextRestartTime { get; set; }

Property Value

Timestamp

Parser 

public static MessageParser<SandboxStatus> Parser { get; }

Property Value

MessageParser<SandboxStatus>

Phase

Gateway-derived lifecycle summary.

public SandboxPhase Phase { get; set; }

Property Value

SandboxPhase

Provisioning

Gateway-owned provisioning deadlines, retained after timeout for inspection and retry.

public SandboxProvisioning Provisioning { get; set; }

Property Value

SandboxProvisioning

RestartCount

Consecutive policy-driven restart number in the current crash loop.

public uint RestartCount { get; set; }

Property Value

uint

SandboxFd

File descriptor or endpoint for reaching the sandbox service, when available.

public string SandboxFd { get; set; }

Property Value

string

Methods

CalculateSize()

Calculates the size of this message in Protocol Buffer wire format, in bytes.

public int CalculateSize()

Returns

int

The number of bytes required to write this message to a coded output stream.

ClearConfigurationActivated()

Clears the value of the "configuration_activated" field

public void ClearConfigurationActivated()

ClearExitCode()

Clears the value of the "exit_code" field

public void ClearExitCode()

Clone()

Creates a deep clone of this object.

public SandboxStatus Clone()

Returns

SandboxStatus

A deep clone of this object.

Equals(SandboxStatus)

Indicates whether the current object is equal to another object of the same type.

public bool Equals(SandboxStatus other)

Parameters

other SandboxStatus

An object to compare with this object.

Returns

bool

true if the current object is equal to the other parameter; otherwise, false.

Equals(object)

Determines whether the specified object is equal to the current object.

public override bool Equals(object other)

Parameters

other object

Returns

bool

true if the specified object is equal to the current object; otherwise, false.

GetHashCode()

Serves as the default hash function.

public override int GetHashCode()

Returns

int

A hash code for the current object.

MergeFrom(CodedInputStream)

Merges the data from the specified coded input stream with the current message.

public void MergeFrom(CodedInputStream input)

Parameters

input CodedInputStream

Remarks

See the user guide for precise merge semantics.

MergeFrom(SandboxStatus)

Merges the given message into this one.

public void MergeFrom(SandboxStatus other)

Parameters

other SandboxStatus

Remarks

See the user guide for precise merge semantics.

ToString()

Returns a string that represents the current object.

public override string ToString()

Returns

string

A string that represents the current object.

WriteTo(CodedOutputStream)

Writes the data to the given coded output stream.

public void WriteTo(CodedOutputStream output)

Parameters

output CodedOutputStream

Coded output stream to write the data to. Must not be null.