@tangle-network/sandbox 0.9.4-develop.20260706173746.524da5c → 0.9.4-develop.20260708064110.11c25f9

package/dist/agent/index.d.ts

@@ -1,5 +1,5 @@
-import { G as CodeExecutionResult, J as CodeResultPart, K as CodeLanguage, W as CodeExecutionOptions, n as SandboxInstance } from "../sandbox-fNryFSXI.js";
-import { i as SandboxClient } from "../client-CKM1dsk7.js";
+import { G as CodeExecutionResult, J as CodeResultPart, K as CodeLanguage, W as CodeExecutionOptions, n as SandboxInstance } from "../sandbox-BL2LosMy.js";
+import { i as SandboxClient } from "../client-AUfz_t4l.js";
 import * as _$_modelcontextprotocol_sdk_server_index_js0 from "@modelcontextprotocol/sdk/server/index.js";
 
 //#region src/agent/tools/_specs.d.ts

package/dist/{client-IVFN239a.js → client-13KFLnXC.js}

@@ -1,4 +1,4 @@
-import { f as encodePromptForWire, l as exportTraceBundle, m as parseSSEStream, s as normalizeConnection, t as SandboxInstance } from "./sandbox-J7ZJIpTI.js";
+import { c as normalizeConnection, h as parseSSEStream, n as normalizeStartupDiagnostics, p as encodePromptForWire, t as SandboxInstance, u as exportTraceBundle } from "./sandbox-B6-5VUWS.js";
 import { d as ValidationError, f as parseErrorResponse, i as NotFoundError, r as NetworkError, t as AuthError, u as TimeoutError } from "./errors-DZsfJUuc.js";
 //#region src/resources.ts
 /**
@@ -1677,7 +1677,8 @@ var SandboxClient = class {
 			lastActivityAt: data.lastActivityAt ? new Date(data.lastActivityAt) : void 0,
 			expiresAt: data.expiresAt ? new Date(data.expiresAt) : void 0,
 			error: data.error,
-			gpuLease: data.gpuLease
+			gpuLease: data.gpuLease,
+			startupDiagnostics: normalizeStartupDiagnostics(data.startupDiagnostics) ?? void 0
 		};
 	}
 	_tokenRefreshHandlers = /* @__PURE__ */ new Set();

package/dist/{client-CKM1dsk7.d.ts → client-AUfz_t4l.d.ts}

@@ -1,4 +1,4 @@
-import { $ as CreateSandboxFleetOptions, $n as SandboxFleetMachineRecord, An as PublishPublicTemplateVersionOptions, B as BatchResult, Bn as SandboxEnvironment, Br as SshKeysManager, Ct as FleetDispatchStreamOptions, Dn as PublicTemplateInfo, Dt as FleetPromptDispatchOptions, Et as FleetMachineId, Hn as SandboxFleetArtifact, Jt as IntelligenceReport, Kn as SandboxFleetDispatchResponse, Mn as ReapExpiredSandboxFleetsResult, Nn as ReconcileSandboxFleetsOptions, On as PublicTemplateVersionInfo, Ot as FleetPromptDispatchResult, Pn as ReconcileSandboxFleetsResult, Q as CreateRequestOptions, Qr as TokenRefreshHandler, Qt as IntelligenceReportWindow, R as BatchEvent, Rn as SandboxClientConfig, Sn as PromptResult, St as FleetDispatchResultBufferOptions, Tt as FleetExecDispatchResult, Un as SandboxFleetArtifactSpec, V as BatchTask, Wn as SandboxFleetCostEstimate, Wr as SubscriptionInfo, Xt as IntelligenceReportCompareTo, Yn as SandboxFleetInfo, Yt as IntelligenceReportBudget, Z as CreateIntelligenceReportOptions, _t as ExecResult, a as TraceExportSink, ar as SandboxFleetToken, bn as PromptInputPart, bt as FleetDispatchCancelResult, et as CreateSandboxFleetTokenOptions, fr as SandboxFleetWorkspaceReconcileResult, gt as ExecOptions, hr as SandboxInfo, i as TraceExportResult, ii as UsageInfo, j as AttachSandboxFleetMachineOptions, jn as ReapExpiredSandboxFleetsOptions, jr as SecretsManager, kn as PublishPublicTemplateOptions, lr as SandboxFleetTraceOptions, mr as SandboxFleetWorkspaceSnapshotResult, n as SandboxInstance, nn as ListSandboxOptions, nt as CreateSandboxOptions, or as SandboxFleetTraceBundle, pr as SandboxFleetWorkspaceRestoreResult, qn as SandboxFleetDriverCapability, rr as SandboxFleetOperationsSummary, t as HttpClient, tn as ListSandboxFleetOptions, tr as SandboxFleetManifest, tt as CreateSandboxFleetWithCoordinatorOptions, ur as SandboxFleetUsage, wt as FleetExecDispatchOptions, xn as PromptOptions, xt as FleetDispatchResultBuffer, z as BatchOptions } from "./sandbox-fNryFSXI.js";
+import { $ as CreateSandboxFleetOptions, $n as SandboxFleetMachineRecord, An as PublishPublicTemplateVersionOptions, B as BatchResult, Bn as SandboxEnvironment, Br as SshKeysManager, Ct as FleetDispatchStreamOptions, Dn as PublicTemplateInfo, Dt as FleetPromptDispatchOptions, Et as FleetMachineId, Hn as SandboxFleetArtifact, Jt as IntelligenceReport, Kn as SandboxFleetDispatchResponse, Mn as ReapExpiredSandboxFleetsResult, Nn as ReconcileSandboxFleetsOptions, On as PublicTemplateVersionInfo, Ot as FleetPromptDispatchResult, Pn as ReconcileSandboxFleetsResult, Q as CreateRequestOptions, Qr as TokenRefreshHandler, Qt as IntelligenceReportWindow, R as BatchEvent, Rn as SandboxClientConfig, Sn as PromptResult, St as FleetDispatchResultBufferOptions, Tt as FleetExecDispatchResult, Un as SandboxFleetArtifactSpec, V as BatchTask, Wn as SandboxFleetCostEstimate, Wr as SubscriptionInfo, Xt as IntelligenceReportCompareTo, Yn as SandboxFleetInfo, Yt as IntelligenceReportBudget, Z as CreateIntelligenceReportOptions, _t as ExecResult, a as TraceExportSink, ar as SandboxFleetToken, bn as PromptInputPart, bt as FleetDispatchCancelResult, et as CreateSandboxFleetTokenOptions, fr as SandboxFleetWorkspaceReconcileResult, gt as ExecOptions, hr as SandboxInfo, i as TraceExportResult, ii as UsageInfo, j as AttachSandboxFleetMachineOptions, jn as ReapExpiredSandboxFleetsOptions, jr as SecretsManager, kn as PublishPublicTemplateOptions, lr as SandboxFleetTraceOptions, mr as SandboxFleetWorkspaceSnapshotResult, n as SandboxInstance, nn as ListSandboxOptions, nt as CreateSandboxOptions, or as SandboxFleetTraceBundle, pr as SandboxFleetWorkspaceRestoreResult, qn as SandboxFleetDriverCapability, rr as SandboxFleetOperationsSummary, t as HttpClient, tn as ListSandboxFleetOptions, tr as SandboxFleetManifest, tt as CreateSandboxFleetWithCoordinatorOptions, ur as SandboxFleetUsage, wt as FleetExecDispatchOptions, xn as PromptOptions, xt as FleetDispatchResultBuffer, z as BatchOptions } from "./sandbox-BL2LosMy.js";
 
 //#region src/lib/sse-parser.d.ts
 /**

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { Rn as SandboxClientConfig, _t as ExecResult, br as SandboxStatus, dn as PreviewLinkInfo, fn as PreviewLinkManager, gt as ExecOptions, hr as SandboxInfo, n as SandboxInstance, nt as CreateSandboxOptions, on as NetworkConfig } from "./sandbox-fNryFSXI.js";
-import { i as SandboxClient } from "./client-CKM1dsk7.js";
+import { Rn as SandboxClientConfig, _t as ExecResult, br as SandboxStatus, dn as PreviewLinkInfo, fn as PreviewLinkManager, gt as ExecOptions, hr as SandboxInfo, n as SandboxInstance, nt as CreateSandboxOptions, on as NetworkConfig } from "./sandbox-BL2LosMy.js";
+import { i as SandboxClient } from "./client-AUfz_t4l.js";
 import { a as PartialFailureError, c as SandboxErrorJson, d as StateError, f as TimeoutError, i as NotFoundError, l as SandboxFailureDetail, n as CapabilityError, o as QuotaError, p as ValidationError, r as NetworkError, s as SandboxError, t as AuthError, u as ServerError } from "./errors-1Se5ATyZ.js";
 export { AuthError, CapabilityError, type CreateSandboxOptions, type ExecOptions, type ExecResult, type NetworkConfig, NetworkError, NotFoundError, PartialFailureError, type PreviewLinkInfo, type PreviewLinkManager, QuotaError, SandboxClient as Sandbox, SandboxClient, type SandboxClientConfig, SandboxError, type SandboxErrorJson, type SandboxFailureDetail, type SandboxInfo, SandboxInstance, type SandboxStatus, ServerError, StateError, TimeoutError, ValidationError };

package/dist/core.js

@@ -1,4 +1,4 @@
-import { t as SandboxInstance } from "./sandbox-J7ZJIpTI.js";
+import { t as SandboxInstance } from "./sandbox-B6-5VUWS.js";
 import { a as PartialFailureError, c as ServerError, d as ValidationError, i as NotFoundError, l as StateError, n as CapabilityError, o as QuotaError, r as NetworkError, s as SandboxError, t as AuthError, u as TimeoutError } from "./errors-DZsfJUuc.js";
-import { n as SandboxClient } from "./client-IVFN239a.js";
+import { n as SandboxClient } from "./client-13KFLnXC.js";
 export { AuthError, CapabilityError, NetworkError, NotFoundError, PartialFailureError, QuotaError, SandboxClient as Sandbox, SandboxClient, SandboxError, SandboxInstance, ServerError, StateError, TimeoutError, ValidationError };

package/dist/{index-8IkXi8y9.d.ts → index-BRq19VvF.d.ts}

@@ -1,4 +1,4 @@
-import { n as SandboxInstance, nt as CreateSandboxOptions, t as HttpClient } from "./sandbox-fNryFSXI.js";
+import { n as SandboxInstance, nt as CreateSandboxOptions, t as HttpClient } from "./sandbox-BL2LosMy.js";
 
 //#region src/tangle/abi.d.ts
 /**
@@ -341,6 +341,11 @@ declare class TangleSandboxClient implements HttpClient {
    * Create a sandbox via on-chain job submission.
    */
   create(options?: CreateSandboxOptions): Promise<SandboxInstance>;
+  /**
+   * Get a sandbox by id. Rehydrates from the operator API when configured so
+   * app servers can resolve sandboxes created by earlier requests.
+   */
+  get(id: string): Promise<SandboxInstance | null>;
   /**
    * Route interception for SandboxInstance lifecycle calls.
    *

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { $ as CreateSandboxFleetOptions, $n as SandboxFleetMachineRecord, $r as ToolsConfig, $t as ListMessagesOptions, A as AttachGpuLeaseOptions, An as PublishPublicTemplateVersionOptions, Ar as SecretInfo, At as GitAuth, B as BatchResult, Bn as SandboxEnvironment, Bt as GpuLeaseExecResult, C as SandboxMcpEndpoint, Ci as defineAgentProfile, Cn as ProvisionEvent, Cr as SandboxTraceExport, Ct as FleetDispatchStreamOptions, D as AcceleratorKind, Dn as PublicTemplateInfo, Dr as ScopedTokenScope, Dt as FleetPromptDispatchOptions, E as buildSandboxMcpConfig, Ei as mergeAgentProfiles, En as ProvisionStep, Er as ScopedToken, Et as FleetMachineId, F as BackendManager, Fn as RunCodeOptions, Fr as SessionMessage, Ft as GitStatus, Gn as SandboxFleetDispatchFailureClass, Gr as TaskOptions, Gt as HostAgentDriverConfig, H as BatchTaskResult, Hn as SandboxFleetArtifact, Hr as StartupOperation, Ht as GpuLeaseProviderName, I as BackendStatus, In as SSHCommandDescriptor, Ir as SessionStatus, It as GpuLease, Jn as SandboxFleetDriverTimings, Jr as TeeAttestationReport, Jt as IntelligenceReport, Kn as SandboxFleetDispatchResponse, Kr as TaskResult, Kt as HostAgentRuntimeBackend, L as BackendType, Ln as SSHCredentials, Lr as SnapshotInfo, Lt as GpuLeaseBilling, M as BackendCapabilities, Mn as ReapExpiredSandboxFleetsResult, Mr as SessionEventStreamOptions, Mt as GitCommit, N as BackendConfig, Nn as ReconcileSandboxFleetsOptions, Nr as SessionInfo, Nt as GitConfig, O as AccessPolicyRule, On as PublicTemplateVersionInfo, Or as SearchMatch, P as BackendInfo, Pn as ReconcileSandboxFleetsResult, Pr as SessionListOptions, Pt as GitDiff, Qn as SandboxFleetMachineMeteredUsage, Qr as TokenRefreshHandler, Qt as IntelligenceReportWindow, R as BatchEvent, Rn as SandboxClientConfig, Rr as SnapshotOptions, Rt as GpuLeaseCommandResult, S as SandboxMcpConfig, Si as AgentSubagentProfile, Sn as PromptResult, Sr as SandboxTraceEvent, St as FleetDispatchResultBufferOptions, T as buildControlPlaneMcpConfig, Ti as defineInlineResource, Tn as ProvisionStatus, Tr as SandboxUser, U as BranchOptions, Un as SandboxFleetArtifactSpec, Ur as StorageConfig, Ut as GpuLeaseStatus, V as BatchTask, Vn as SandboxEvent, Vr as StartupDiagnostics, Vt as GpuLeaseManager, Wn as SandboxFleetCostEstimate, Wr as SubscriptionInfo, Wt as GpuType, X as CreateGpuLeaseOptions, Xn as SandboxFleetIntelligenceEnvelope, Xr as TeePublicKey, Xt as IntelligenceReportCompareTo, Y as CompletedTurnResult, Yn as SandboxFleetInfo, Yr as TeeAttestationResponse, Yt as IntelligenceReportBudget, Z as CreateIntelligenceReportOptions, Zn as SandboxFleetMachine, Zr as TeePublicKeyResponse, Zt as IntelligenceReportSubjectType, _ as StartInteractiveOptions, _i as AgentProfilePrompt, _n as ProcessSignal, _r as SandboxPermissionsConfig, _t as ExecResult, a as TraceExportSink, ai as WaitForOptions, an as MkdirOptions, ar as SandboxFleetToken, at as DispatchPromptOptions, b as CONTROL_PLANE_MCP_SERVER_NAME, bi as AgentProfileValidationIssue, br as SandboxStatus, bt as FleetDispatchCancelResult, c as otelTraceIdForTangleTrace, ci as WriteManyOptions, cn as NonHostAgentDriverConfig, cr as SandboxFleetTraceExport, ct as DownloadProgress, d as InteractiveAuthFile, di as AgentProfileConfidential, dn as PreviewLinkInfo, dr as SandboxFleetWorkspace, dt as DriverInfo, ei as TurnDriveResult, en as ListOptions, er as SandboxFleetMachineSpec, f as InteractiveSessionHandle, fi as AgentProfileConnection, fn as PreviewLinkManager, fr as SandboxFleetWorkspaceReconcileResult, ft as DriverType, g as RespondToPermissionOptions, gi as AgentProfilePermissionValue, gn as ProcessManager, gr as SandboxIntelligenceEnvelope, gt as ExecOptions, h as InterruptResult, hi as AgentProfileModelHints, hn as ProcessLogEntry, hr as SandboxInfo, ht as EventStreamOptions, i as TraceExportResult, ii as UsageInfo, in as MintScopedTokenOptions, ir as SandboxFleetPolicy, it as DirectoryPermission, j as AttachSandboxFleetMachineOptions, jn as ReapExpiredSandboxFleetsOptions, jr as SecretsManager, jt as GitBranch, k as AddUserOptions, kn as PublishPublicTemplateOptions, kr as SearchOptions, kt as GPU_LEASE_PROVIDER_NAMES, l as toOtelJson, li as AgentProfile, ln as PermissionLevel, lr as SandboxFleetTraceOptions, lt as DriveTurnOptions, m as InteractiveSessionInfo, mi as AgentProfileMcpServer, mn as ProcessInfo, mr as SandboxFleetWorkspaceSnapshotResult, mt as EgressPolicy, n as SandboxInstance, ni as UploadOptions, nn as ListSandboxOptions, nr as SandboxFleetManifestMachine, nt as CreateSandboxOptions, o as buildTraceExportPayload, oi as WriteFileOptions, on as NetworkConfig, or as SandboxFleetTraceBundle, ot as DispatchedSession, p as InteractiveSessionHost, pi as AgentProfileFileMount, pn as Process, pr as SandboxFleetWorkspaceRestoreResult, pt as EgressManager, q as CodeResult, qn as SandboxFleetDriverCapability, qr as TeeAttestationOptions, qt as InstalledTool, r as TraceExportFormat, ri as UploadProgress, rn as McpServerConfig, rr as SandboxFleetOperationsSummary, rt as DeleteOptions, s as exportTraceBundle, si as WriteManyFile, sn as NetworkManager, sr as SandboxFleetTraceEvent, st as DownloadOptions, ti as UpdateUserOptions, tn as ListSandboxFleetOptions, tr as SandboxFleetManifest, tt as CreateSandboxFleetWithCoordinatorOptions, u as SandboxSession, ui as AgentProfileCapabilities, un as PermissionsManager, ur as SandboxFleetUsage, ut as DriverConfig, v as BuildControlPlaneMcpConfigOptions, vi as AgentProfileResourceRef, vn as ProcessSpawnOptions, vr as SandboxResourceUsage, vt as FileInfo, w as SandboxMcpServerEntry, wi as defineGitHubResource, wn as ProvisionResult, wr as SandboxTraceOptions, wt as FleetExecDispatchOptions, x as SANDBOX_MCP_SERVER_NAME, xi as AgentProfileValidationResult, xn as PromptOptions, xr as SandboxTraceBundle, xt as FleetDispatchResultBuffer, y as BuildSandboxMcpConfigOptions, yi as AgentProfileResources, yn as ProcessStatus, yr as SandboxResources, yt as FileSystem, z as BatchOptions, zn as SandboxConnection, zr as SnapshotResult, zt as GpuLeaseExecOptions } from "./sandbox-fNryFSXI.js";
-import { a as Team, c as SandboxFleet, d as ParsedSSEEvent, f as parseSSEStream, i as SandboxClient, l as SandboxFleetClient, n as IntelligenceClient, o as TeamInvitation, r as InviteTeamMemberOptions, s as TeamMember, t as CreateTeamOptions, u as ParseSSEStreamOptions } from "./client-CKM1dsk7.js";
+import { $ as CreateSandboxFleetOptions, $n as SandboxFleetMachineRecord, $r as ToolsConfig, $t as ListMessagesOptions, A as AttachGpuLeaseOptions, An as PublishPublicTemplateVersionOptions, Ar as SecretInfo, At as GitAuth, B as BatchResult, Bn as SandboxEnvironment, Bt as GpuLeaseExecResult, C as SandboxMcpEndpoint, Ci as defineAgentProfile, Cn as ProvisionEvent, Cr as SandboxTraceExport, Ct as FleetDispatchStreamOptions, D as AcceleratorKind, Dn as PublicTemplateInfo, Dr as ScopedTokenScope, Dt as FleetPromptDispatchOptions, E as buildSandboxMcpConfig, Ei as mergeAgentProfiles, En as ProvisionStep, Er as ScopedToken, Et as FleetMachineId, F as BackendManager, Fn as RunCodeOptions, Fr as SessionMessage, Ft as GitStatus, Gn as SandboxFleetDispatchFailureClass, Gr as TaskOptions, Gt as HostAgentDriverConfig, H as BatchTaskResult, Hn as SandboxFleetArtifact, Hr as StartupOperation, Ht as GpuLeaseProviderName, I as BackendStatus, In as SSHCommandDescriptor, Ir as SessionStatus, It as GpuLease, Jn as SandboxFleetDriverTimings, Jr as TeeAttestationReport, Jt as IntelligenceReport, Kn as SandboxFleetDispatchResponse, Kr as TaskResult, Kt as HostAgentRuntimeBackend, L as BackendType, Ln as SSHCredentials, Lr as SnapshotInfo, Lt as GpuLeaseBilling, M as BackendCapabilities, Mn as ReapExpiredSandboxFleetsResult, Mr as SessionEventStreamOptions, Mt as GitCommit, N as BackendConfig, Nn as ReconcileSandboxFleetsOptions, Nr as SessionInfo, Nt as GitConfig, O as AccessPolicyRule, On as PublicTemplateVersionInfo, Or as SearchMatch, P as BackendInfo, Pn as ReconcileSandboxFleetsResult, Pr as SessionListOptions, Pt as GitDiff, Qn as SandboxFleetMachineMeteredUsage, Qr as TokenRefreshHandler, Qt as IntelligenceReportWindow, R as BatchEvent, Rn as SandboxClientConfig, Rr as SnapshotOptions, Rt as GpuLeaseCommandResult, S as SandboxMcpConfig, Si as AgentSubagentProfile, Sn as PromptResult, Sr as SandboxTraceEvent, St as FleetDispatchResultBufferOptions, T as buildControlPlaneMcpConfig, Ti as defineInlineResource, Tn as ProvisionStatus, Tr as SandboxUser, U as BranchOptions, Un as SandboxFleetArtifactSpec, Ur as StorageConfig, Ut as GpuLeaseStatus, V as BatchTask, Vn as SandboxEvent, Vr as StartupDiagnostics, Vt as GpuLeaseManager, Wn as SandboxFleetCostEstimate, Wr as SubscriptionInfo, Wt as GpuType, X as CreateGpuLeaseOptions, Xn as SandboxFleetIntelligenceEnvelope, Xr as TeePublicKey, Xt as IntelligenceReportCompareTo, Y as CompletedTurnResult, Yn as SandboxFleetInfo, Yr as TeeAttestationResponse, Yt as IntelligenceReportBudget, Z as CreateIntelligenceReportOptions, Zn as SandboxFleetMachine, Zr as TeePublicKeyResponse, Zt as IntelligenceReportSubjectType, _ as StartInteractiveOptions, _i as AgentProfilePrompt, _n as ProcessSignal, _r as SandboxPermissionsConfig, _t as ExecResult, a as TraceExportSink, ai as WaitForOptions, an as MkdirOptions, ar as SandboxFleetToken, at as DispatchPromptOptions, b as CONTROL_PLANE_MCP_SERVER_NAME, bi as AgentProfileValidationIssue, br as SandboxStatus, bt as FleetDispatchCancelResult, c as otelTraceIdForTangleTrace, ci as WriteManyOptions, cn as NonHostAgentDriverConfig, cr as SandboxFleetTraceExport, ct as DownloadProgress, d as InteractiveAuthFile, di as AgentProfileConfidential, dn as PreviewLinkInfo, dr as SandboxFleetWorkspace, dt as DriverInfo, ei as TurnDriveResult, en as ListOptions, er as SandboxFleetMachineSpec, f as InteractiveSessionHandle, fi as AgentProfileConnection, fn as PreviewLinkManager, fr as SandboxFleetWorkspaceReconcileResult, ft as DriverType, g as RespondToPermissionOptions, gi as AgentProfilePermissionValue, gn as ProcessManager, gr as SandboxIntelligenceEnvelope, gt as ExecOptions, h as InterruptResult, hi as AgentProfileModelHints, hn as ProcessLogEntry, hr as SandboxInfo, ht as EventStreamOptions, i as TraceExportResult, ii as UsageInfo, in as MintScopedTokenOptions, ir as SandboxFleetPolicy, it as DirectoryPermission, j as AttachSandboxFleetMachineOptions, jn as ReapExpiredSandboxFleetsOptions, jr as SecretsManager, jt as GitBranch, k as AddUserOptions, kn as PublishPublicTemplateOptions, kr as SearchOptions, kt as GPU_LEASE_PROVIDER_NAMES, l as toOtelJson, li as AgentProfile, ln as PermissionLevel, lr as SandboxFleetTraceOptions, lt as DriveTurnOptions, m as InteractiveSessionInfo, mi as AgentProfileMcpServer, mn as ProcessInfo, mr as SandboxFleetWorkspaceSnapshotResult, mt as EgressPolicy, n as SandboxInstance, ni as UploadOptions, nn as ListSandboxOptions, nr as SandboxFleetManifestMachine, nt as CreateSandboxOptions, o as buildTraceExportPayload, oi as WriteFileOptions, on as NetworkConfig, or as SandboxFleetTraceBundle, ot as DispatchedSession, p as InteractiveSessionHost, pi as AgentProfileFileMount, pn as Process, pr as SandboxFleetWorkspaceRestoreResult, pt as EgressManager, q as CodeResult, qn as SandboxFleetDriverCapability, qr as TeeAttestationOptions, qt as InstalledTool, r as TraceExportFormat, ri as UploadProgress, rn as McpServerConfig, rr as SandboxFleetOperationsSummary, rt as DeleteOptions, s as exportTraceBundle, si as WriteManyFile, sn as NetworkManager, sr as SandboxFleetTraceEvent, st as DownloadOptions, ti as UpdateUserOptions, tn as ListSandboxFleetOptions, tr as SandboxFleetManifest, tt as CreateSandboxFleetWithCoordinatorOptions, u as SandboxSession, ui as AgentProfileCapabilities, un as PermissionsManager, ur as SandboxFleetUsage, ut as DriverConfig, v as BuildControlPlaneMcpConfigOptions, vi as AgentProfileResourceRef, vn as ProcessSpawnOptions, vr as SandboxResourceUsage, vt as FileInfo, w as SandboxMcpServerEntry, wi as defineGitHubResource, wn as ProvisionResult, wr as SandboxTraceOptions, wt as FleetExecDispatchOptions, x as SANDBOX_MCP_SERVER_NAME, xi as AgentProfileValidationResult, xn as PromptOptions, xr as SandboxTraceBundle, xt as FleetDispatchResultBuffer, y as BuildSandboxMcpConfigOptions, yi as AgentProfileResources, yn as ProcessStatus, yr as SandboxResources, yt as FileSystem, z as BatchOptions, zn as SandboxConnection, zr as SnapshotResult, zt as GpuLeaseExecOptions } from "./sandbox-BL2LosMy.js";
+import { a as Team, c as SandboxFleet, d as ParsedSSEEvent, f as parseSSEStream, i as SandboxClient, l as SandboxFleetClient, n as IntelligenceClient, o as TeamInvitation, r as InviteTeamMemberOptions, s as TeamMember, t as CreateTeamOptions, u as ParseSSEStreamOptions } from "./client-AUfz_t4l.js";
 import { d as AnyTokenPayload, h as IssueCollaborationTokenOptions, m as CollaborationTokenPayload, p as CollaborationAccess } from "./index-D-2pH_70.js";
 import { _ as CollaborationTransportConfig, a as CollaborationClient, c as CollaborationClientConfig, d as CollaborationDocumentRef, f as CollaborationFileBridgeOptions, g as CollaborationTokenRefreshResponse, h as CollaborationTokenRefreshRequest, i as parseCollaborationDocumentId, l as CollaborationDocumentAdapter, m as CollaborationPermissions, n as buildCollaborationDocumentId, o as CollaborationBootstrapRequest, p as CollaborationFileEvent, r as normalizeCollaborationPath, s as CollaborationBootstrapResponse, t as CollaborationFileBridge, u as CollaborationDocumentChange, v as SaveCollaborationSnapshotRequest, y as SaveCollaborationSnapshotResponse } from "./index-D7bwmNs8.js";
 import { a as PartialFailureError, c as SandboxErrorJson, d as StateError, f as TimeoutError, i as NotFoundError, l as SandboxFailureDetail, n as CapabilityError, o as QuotaError, p as ValidationError, r as NetworkError, s as SandboxError, t as AuthError, u as ServerError } from "./errors-1Se5ATyZ.js";
-import { s as TangleSandboxClientConfig, t as TangleSandboxClient } from "./index-8IkXi8y9.js";
+import { s as TangleSandboxClientConfig, t as TangleSandboxClient } from "./index-BRq19VvF.js";
 
 //#region src/attestation-heartbeat.d.ts
 interface TeeAttestationHeartbeatSample {

package/dist/index.js

@@ -1,8 +1,8 @@
-import { a as collectAgentResponseText, c as buildTraceExportPayload, d as toOtelJson, g as serializeForSidecar, h as normalizeRuntimeBackendConfig, i as applySandboxEventText, l as exportTraceBundle, m as parseSSEStream, n as SandboxSession, o as getSandboxEventText, p as encodeTextForWire, r as InteractiveSessionHandle, t as SandboxInstance, u as otelTraceIdForTangleTrace } from "./sandbox-J7ZJIpTI.js";
+import { _ as serializeForSidecar, a as applySandboxEventText, d as otelTraceIdForTangleTrace, f as toOtelJson, g as normalizeRuntimeBackendConfig, h as parseSSEStream, i as InteractiveSessionHandle, l as buildTraceExportPayload, m as encodeTextForWire, o as collectAgentResponseText, r as SandboxSession, s as getSandboxEventText, t as SandboxInstance, u as exportTraceBundle } from "./sandbox-B6-5VUWS.js";
 import { a as PartialFailureError, c as ServerError, d as ValidationError, i as NotFoundError, l as StateError, n as CapabilityError, o as QuotaError, r as NetworkError, s as SandboxError, t as AuthError, u as TimeoutError } from "./errors-DZsfJUuc.js";
-import { a as DEFAULT_SANDBOX_SIZE, c as resolveSandboxResources, i as SandboxFleetClient, l as sandboxResourcesForSize, n as SandboxClient, o as SANDBOX_SIZE_PRESETS, r as SandboxFleet, s as SANDBOX_SIZE_PRESET_NAMES, t as IntelligenceClient } from "./client-IVFN239a.js";
+import { a as DEFAULT_SANDBOX_SIZE, c as resolveSandboxResources, i as SandboxFleetClient, l as sandboxResourcesForSize, n as SandboxClient, o as SANDBOX_SIZE_PRESETS, r as SandboxFleet, s as SANDBOX_SIZE_PRESET_NAMES, t as IntelligenceClient } from "./client-13KFLnXC.js";
 import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "./collaboration-BxlfZ2Uh.js";
-import { t as TangleSandboxClient } from "./tangle-BR-mu2qI.js";
+import { t as TangleSandboxClient } from "./tangle-CaIGtgCR.js";
 import { defineAgentProfile, defineGitHubResource, defineInlineResource, mergeAgentProfiles } from "@tangle-network/agent-interface";
 //#region src/confidential.ts
 function generateAttestationNonce(bytes = 32) {

package/dist/{sandbox-J7ZJIpTI.js → sandbox-B6-5VUWS.js}

@@ -632,7 +632,7 @@ var InteractiveSessionHandle = class {
 * A single agent session inside a sandbox. Created via
 * `box.session(id)` — does not hit the network until a method is called.
 */
-var SandboxSession = class {
+var SandboxSession = class SandboxSession {
 	/**
 	* @internal SDK-internal constructor — apps should call `box.session(id)`.
 	*/
@@ -675,6 +675,16 @@ var SandboxSession = class {
 		return this.box._sessionResult(this.id);
 	}
 	/**
+	* List persisted messages for this session, including in-flight assistant
+	* content when the runtime has flushed partial output.
+	*/
+	async messages(opts = {}) {
+		return this.box.messages({
+			...opts,
+			sessionId: this.id
+		});
+	}
+	/**
 	* Continue this session with an additional prompt. Equivalent to
 	* `box.prompt(message, { ...opts, sessionId: this.id })` but reads
 	* naturally on a Session reference.
@@ -697,6 +707,18 @@ var SandboxSession = class {
 		return this.box._sessionCancel(this.id);
 	}
 	/**
+	* Fork this session into a new queued session. The fork shares the
+	* parent workspace and copies conversation history up to `messageId`
+	* when supplied.
+	*/
+	async fork(opts) {
+		const info = await this.box._sessionFork(this.id, opts);
+		return {
+			session: new SandboxSession(this.box, info.id),
+			info
+		};
+	}
+	/**
 	* Drive this session's harness in INTERACTIVE mode: spawn its native TUI,
 	* stream the live framebuffer, and inject prompts as keystrokes. Distinct
 	* from the headless `prompt()`/`events()` surface above. Lazy — does not hit
@@ -1648,6 +1670,7 @@ var SandboxInstance = class SandboxInstance {
 					turnId: options?.turnId,
 					metadata: options?.context,
 					requireVisibleAssistantOutput: options?.requireVisibleAssistantOutput,
+					...timeoutMs ? { timeoutMs } : {},
 					...options?.detach ? { detach: true } : {},
 					backend: normalizeRuntimeBackendConfig(options?.backend ?? this.defaultRuntimeBackend, { model: options?.model })
 				})
@@ -2480,6 +2503,7 @@ var SandboxInstance = class SandboxInstance {
 		const params = new URLSearchParams();
 		if (options?.all) params.set("all", "true");
 		if (options?.long) params.set("long", "true");
+		if (options?.sessionId) params.set("sessionId", options.sessionId);
 		const query = params.toString();
 		const url = query ? `/fs/list${path}?${query}` : `/fs/list${path}`;
 		const response = await this.runtimeFetch(url, { method: "GET" });
@@ -4179,6 +4203,28 @@ var SandboxInstance = class SandboxInstance {
 			metadata: m.info.metadata
 		}));
 	}
+	async _sessionFork(id, opts = {}) {
+		await this.ensureRunning();
+		const body = {};
+		if (opts.messageId !== void 0) body.messageID = opts.messageId;
+		if (opts.targetBackend !== void 0) body.targetBackend = opts.targetBackend;
+		if (opts.targetModel !== void 0) body.targetModel = opts.targetModel;
+		if (opts.files !== void 0) body.files = opts.files;
+		const response = await this.runtimeFetch(`/agents/sessions/${encodeURIComponent(id)}/forks`, {
+			method: "POST",
+			body: JSON.stringify(body)
+		});
+		if (!response.ok) {
+			const responseBody = await response.text();
+			throw parseErrorResponse(response.status, responseBody, void 0, response.headers);
+		}
+		const info = normalizeSessionInfo(await response.json());
+		if (!info) throw new ServerError("Session fork response missing session id", 502, {
+			origin: "runtime",
+			endpoint: `/agents/sessions/${encodeURIComponent(id)}/forks`
+		});
+		return info;
+	}
 	/**
 	* Look up a cached turn result by idempotency key. Returns the cached
 	* payload if a turn with this `turnId` previously completed on the
@@ -4527,6 +4573,7 @@ function normalizeSessionInfo(raw) {
 	const status = raw.status || "running";
 	return {
 		id,
+		parentId: typeof raw.parentID === "string" ? raw.parentID : typeof raw.parentId === "string" ? raw.parentId : void 0,
 		status: [
 			"queued",
 			"running",
@@ -4609,4 +4656,4 @@ function quoteForShell(value) {
 	return `'${value.replace(/'/g, "'\\''")}'`;
 }
 //#endregion
-export { collectAgentResponseText as a, buildTraceExportPayload as c, toOtelJson as d, encodePromptForWire as f, serializeForSidecar as g, normalizeRuntimeBackendConfig as h, applySandboxEventText as i, exportTraceBundle as l, parseSSEStream as m, SandboxSession as n, getSandboxEventText as o, encodeTextForWire as p, InteractiveSessionHandle as r, normalizeConnection as s, SandboxInstance as t, otelTraceIdForTangleTrace as u };
+export { serializeForSidecar as _, applySandboxEventText as a, normalizeConnection as c, otelTraceIdForTangleTrace as d, toOtelJson as f, normalizeRuntimeBackendConfig as g, parseSSEStream as h, InteractiveSessionHandle as i, buildTraceExportPayload as l, encodeTextForWire as m, normalizeStartupDiagnostics as n, collectAgentResponseText as o, encodePromptForWire as p, SandboxSession as r, getSandboxEventText as s, SandboxInstance as t, exportTraceBundle as u };

package/dist/{sandbox-fNryFSXI.d.ts → sandbox-BL2LosMy.d.ts}

@@ -1589,6 +1589,8 @@ type SessionStatus = "queued" | "running" | "completed" | "failed" | "cancelled"
 interface SessionInfo {
   /** Stable session id assigned by the sandbox runtime. */
   id: string;
+  /** Parent session id when this session was forked from another session. */
+  parentId?: string;
   /** Current lifecycle state. */
   status: SessionStatus;
   /** Backend identifier (e.g. provider name). */
@@ -1650,6 +1652,28 @@ interface ListMessagesOptions {
   /** Only return messages newer than this Unix-ms timestamp. */
   since?: number;
 }
+/**
+ * Options for `box.session(id).fork()` — create a new session from an
+ * existing conversation, optionally at a message boundary.
+ */
+interface SessionForkOptions {
+  /** Fork at this message boundary. */
+  messageId?: string;
+  /** Target backend type for cross-backend forks. Defaults to parent backend. */
+  targetBackend?: BackendType;
+  /** Model override for the target backend. */
+  targetModel?: {
+    provider?: string;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+  };
+  /**
+   * Files to include. The runtime currently rejects non-empty file lists;
+   * exposed here so the SDK type tracks the wire contract exactly.
+   */
+  files?: string[];
+}
 /**
  * One message on a session — user, assistant, or system. The metadata
  * field carries the durability marker set by the sidecar:
@@ -3868,6 +3892,8 @@ interface ListOptions {
   all?: boolean;
   /** Include full metadata (like ls -l) */
   long?: boolean;
+  /** Task session id for session-specific workspace isolation. */
+  sessionId?: string;
 }
 /**
  * Options for creating directories.
@@ -4444,6 +4470,8 @@ interface SandboxSessionHost extends InteractiveSessionHost {
   _sessionEvents(id: string, opts?: SessionEventStreamOptions): AsyncGenerator<SandboxEvent>;
   _sessionResult(id: string): Promise<PromptResult>;
   _sessionCancel(id: string): Promise<void>;
+  messages(opts: ListMessagesOptions): Promise<SessionMessage[]>;
+  _sessionFork(id: string, opts?: SessionForkOptions): Promise<SessionInfo>;
   _respondToPermission(id: string, permissionID: string, options: RespondToPermissionOptions): Promise<void>;
   _interrupt(id: string): Promise<InterruptResult>;
   _answerQuestion(id: string, answers: Record<string, string[]>): Promise<void>;
@@ -4490,6 +4518,11 @@ declare class SandboxSession {
    * (e.g. `dispatchPrompt`).
    */
   result(): Promise<PromptResult>;
+  /**
+   * List persisted messages for this session, including in-flight assistant
+   * content when the runtime has flushed partial output.
+   */
+  messages(opts?: Omit<ListMessagesOptions, "sessionId">): Promise<SessionMessage[]>;
   /**
    * Continue this session with an additional prompt. Equivalent to
    * `box.prompt(message, { ...opts, sessionId: this.id })` but reads
@@ -4505,6 +4538,15 @@ declare class SandboxSession {
    * aborting a session with nothing in flight is a no-op.
    */
   cancel(): Promise<void>;
+  /**
+   * Fork this session into a new queued session. The fork shares the
+   * parent workspace and copies conversation history up to `messageId`
+   * when supplied.
+   */
+  fork(opts?: SessionForkOptions): Promise<{
+    session: SandboxSession;
+    info: SessionInfo;
+  }>;
   /**
    * Drive this session's harness in INTERACTIVE mode: spawn its native TUI,
    * stream the live framebuffer, and inject prompts as keystrokes. Distinct
@@ -5528,6 +5570,7 @@ declare class SandboxInstance {
    * abort stamps `interrupted: true` explicitly.
    */
   messages(opts: ListMessagesOptions): Promise<SessionMessage[]>;
+  _sessionFork(id: string, opts?: SessionForkOptions): Promise<SessionInfo>;
   /**
    * Look up a cached turn result by idempotency key. Returns the cached
    * payload if a turn with this `turnId` previously completed on the

package/dist/tangle/index.d.ts

@@ -1,2 +1,2 @@
-import { a as TANGLE_JOBS_CONTRACT, c as AgentSandboxBlueprintAbi, d as SandboxCreateParamTypes, f as SandboxCreateResponseParamTypes, i as TANGLE_CHAIN_ID, l as ITangleJobsAbi, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, p as SandboxIdParamTypes, r as JOB_SANDBOX_DELETE, s as TangleSandboxClientConfig, t as TangleSandboxClient, u as JsonResponseParamTypes } from "../index-8IkXi8y9.js";
+import { a as TANGLE_JOBS_CONTRACT, c as AgentSandboxBlueprintAbi, d as SandboxCreateParamTypes, f as SandboxCreateResponseParamTypes, i as TANGLE_CHAIN_ID, l as ITangleJobsAbi, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, p as SandboxIdParamTypes, r as JOB_SANDBOX_DELETE, s as TangleSandboxClientConfig, t as TangleSandboxClient, u as JsonResponseParamTypes } from "../index-BRq19VvF.js";
 export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TANGLE_MAINNET_RPC, TangleSandboxClient, TangleSandboxClientConfig };

package/dist/tangle/index.js

@@ -1,2 +1,2 @@
-import { a as TANGLE_JOBS_CONTRACT, c as ITangleJobsAbi, d as SandboxCreateResponseParamTypes, f as SandboxIdParamTypes, i as TANGLE_CHAIN_ID, l as JsonResponseParamTypes, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, r as JOB_SANDBOX_DELETE, s as AgentSandboxBlueprintAbi, t as TangleSandboxClient, u as SandboxCreateParamTypes } from "../tangle-BR-mu2qI.js";
+import { a as TANGLE_JOBS_CONTRACT, c as ITangleJobsAbi, d as SandboxCreateResponseParamTypes, f as SandboxIdParamTypes, i as TANGLE_CHAIN_ID, l as JsonResponseParamTypes, n as JOB_SANDBOX_CREATE, o as TANGLE_MAINNET_RPC, r as JOB_SANDBOX_DELETE, s as AgentSandboxBlueprintAbi, t as TangleSandboxClient, u as SandboxCreateParamTypes } from "../tangle-CaIGtgCR.js";
 export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TANGLE_MAINNET_RPC, TangleSandboxClient };

package/dist/{tangle-BR-mu2qI.js → tangle-CaIGtgCR.js}

@@ -1,4 +1,5 @@
-import { t as SandboxInstance } from "./sandbox-J7ZJIpTI.js";
+import { t as SandboxInstance } from "./sandbox-B6-5VUWS.js";
+import { f as parseErrorResponse } from "./errors-DZsfJUuc.js";
 //#region src/tangle/abi.ts
 /**
 * Tangle Contract ABI Definitions
@@ -572,6 +573,14 @@ var TangleChainClient = class {
 };
 //#endregion
 //#region src/tangle/client.ts
+/**
+* TangleSandboxClient — on-chain sandbox lifecycle via EVM calls.
+*
+* Implements HttpClient so `SandboxInstance` works unchanged. Lifecycle
+* operations (create/stop/resume/delete) go on-chain via Tangle jobs, and
+* runtime operations are routed directly to the sandbox runtime URL
+* returned by the on-chain job result.
+*/
 function randomHexToken(bytes) {
 	if (typeof globalThis.crypto === "undefined" || typeof globalThis.crypto.getRandomValues !== "function") throw new Error("randomHexToken: globalThis.crypto.getRandomValues is unavailable; this runtime cannot generate cryptographically secure nonces. Run on a host with WebCrypto support (Node 20+, browsers, Workers).");
 	const buf = new Uint8Array(bytes);
@@ -613,6 +622,81 @@ function requirePathGroup(match, index) {
 	if (value === void 0) throw new Error(`Path matcher missing group ${index}`);
 	return value;
 }
+function asRecord(value) {
+	return value && typeof value === "object" ? value : void 0;
+}
+function readString(record, keys) {
+	if (!record) return void 0;
+	for (const key of keys) {
+		const value = record[key];
+		if (typeof value === "string" && value.length > 0) return value;
+	}
+}
+function entryMetadata(entry) {
+	const metadata = {
+		...entry.metadata ?? {},
+		...entry.teeAttestationJson ? { teeAttestationJson: entry.teeAttestationJson } : {},
+		...entry.teePublicKeyJson ? { teePublicKeyJson: entry.teePublicKeyJson } : {},
+		...entry.attestationNonce ? { attestationNonce: entry.attestationNonce } : {}
+	};
+	return Object.keys(metadata).length > 0 ? metadata : void 0;
+}
+function sandboxInfoFromEntry(entry) {
+	return {
+		id: entry.id,
+		name: entry.name,
+		status: entry.status === "deleted" ? "stopped" : entry.status,
+		connection: entry.runtimeUrl ? {
+			runtimeUrl: entry.runtimeUrl,
+			authToken: entry.runtimeToken
+		} : void 0,
+		metadata: entryMetadata(entry),
+		createdAt: entry.createdAt
+	};
+}
+function sandboxEntryFromWire(fallbackId, raw) {
+	const connection = asRecord(raw.connection);
+	const metadata = asRecord(raw.metadata);
+	const id = readString(raw, [
+		"id",
+		"sandboxId",
+		"sandbox_id"
+	]) ?? fallbackId;
+	const runtimeUrl = readString(connection, [
+		"runtimeUrl",
+		"sidecarUrl",
+		"sidecar_url"
+	]) ?? readString(raw, [
+		"runtimeUrl",
+		"sidecarUrl",
+		"sidecar_url"
+	]) ?? "";
+	const runtimeToken = readString(connection, [
+		"authToken",
+		"runtimeToken",
+		"sidecarToken"
+	]) ?? readString(raw, [
+		"authToken",
+		"runtimeToken",
+		"sidecarToken",
+		"token"
+	]) ?? "";
+	const rawStatus = readString(raw, ["status"]) ?? "running";
+	const createdAtRaw = readString(raw, ["createdAt", "created_at"]);
+	const createdAt = createdAtRaw ? new Date(createdAtRaw) : /* @__PURE__ */ new Date();
+	return {
+		id,
+		name: readString(raw, ["name"]),
+		runtimeUrl,
+		runtimeToken,
+		status: rawStatus === "stopped" || rawStatus === "deleted" || rawStatus === "running" ? rawStatus : "running",
+		createdAt,
+		metadata,
+		teeAttestationJson: readString(raw, ["teeAttestationJson"]),
+		teePublicKeyJson: readString(raw, ["teePublicKeyJson"]),
+		attestationNonce: readString(raw, ["attestationNonce"])
+	};
+}
 var TangleSandboxClient = class {
 	chain;
 	sandboxes = /* @__PURE__ */ new Map();
@@ -649,32 +733,32 @@ var TangleSandboxClient = class {
 		if (runtimeUrl && !runtimeToken) throw new Error("Create job returned a runtime URL without an auth token");
 		const entry = {
 			id: sandboxId,
+			name: options?.name,
 			runtimeUrl,
 			runtimeToken,
 			status: "running",
 			createdAt: /* @__PURE__ */ new Date(),
+			metadata: createOptions.metadata,
 			teeAttestationJson: responseJson.teeAttestationJson,
 			teePublicKeyJson: responseJson.teePublicKeyJson,
 			attestationNonce: attestationNonceFromOptions(createOptions)
 		};
 		this.sandboxes.set(sandboxId, entry);
-		const info = {
-			id: sandboxId,
-			name: options?.name,
-			status: "running",
-			connection: runtimeUrl ? {
-				runtimeUrl,
-				authToken: runtimeToken
-			} : void 0,
-			metadata: {
-				...createOptions.metadata ?? {},
-				...entry.teeAttestationJson ? { teeAttestationJson: entry.teeAttestationJson } : {},
-				...entry.teePublicKeyJson ? { teePublicKeyJson: entry.teePublicKeyJson } : {},
-				...entry.attestationNonce ? { attestationNonce: entry.attestationNonce } : {}
-			},
-			createdAt: entry.createdAt
-		};
-		return new SandboxInstance(this, info);
+		return new SandboxInstance(this, sandboxInfoFromEntry(entry));
+	}
+	/**
+	* Get a sandbox by id. Rehydrates from the operator API when configured so
+	* app servers can resolve sandboxes created by earlier requests.
+	*/
+	async get(id) {
+		const response = await this.fetch(`/v1/sandboxes/${encodeURIComponent(id)}`);
+		if (response.status === 404) return null;
+		if (!response.ok) {
+			const body = await response.text();
+			throw parseErrorResponse(response.status, body, void 0, response.headers);
+		}
+		const data = await response.json();
+		return new SandboxInstance(this, sandboxInfoFromEntry(sandboxEntryFromWire(id, data)));
 	}
 	/**
 	* Route interception for SandboxInstance lifecycle calls.
@@ -696,22 +780,16 @@ var TangleSandboxClient = class {
 		const getMatch = path.match(/^\/v1\/sandboxes\/([^/]+)$/);
 		if (getMatch && method === "GET") {
 			const id = decodeURIComponent(requirePathGroup(getMatch, 1));
-			const entry = this.sandboxes.get(id);
+			let entry = this.sandboxes.get(id);
+			if (!entry && this.operatorApiUrl) {
+				const operatorResponse = await this.fetchOperatorApi(`/api/sandboxes/${encodeURIComponent(id)}`, { method: "GET" });
+				if (!operatorResponse.ok) return operatorResponse;
+				entry = sandboxEntryFromWire(id, await operatorResponse.json());
+				this.sandboxes.set(entry.id, entry);
+			}
 			if (!entry) return new Response(JSON.stringify({ error: "Not found" }), { status: 404 });
-			return new Response(JSON.stringify({
-				id: entry.id,
-				status: entry.status,
-				connection: entry.runtimeUrl ? {
-					runtimeUrl: entry.runtimeUrl,
-					authToken: entry.runtimeToken
-				} : void 0,
-				metadata: {
-					...entry.teeAttestationJson ? { teeAttestationJson: entry.teeAttestationJson } : {},
-					...entry.teePublicKeyJson ? { teePublicKeyJson: entry.teePublicKeyJson } : {},
-					...entry.attestationNonce ? { attestationNonce: entry.attestationNonce } : {}
-				},
-				createdAt: entry.createdAt.toISOString()
-			}), {
+			const info = sandboxInfoFromEntry(entry);
+			return new Response(JSON.stringify(info), {
 				status: 200,
 				headers: { "Content-Type": "application/json" }
 			});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox",
-  "version": "0.9.4-develop.20260706173746.524da5c",
+  "version": "0.9.4-develop.20260708064110.11c25f9",
   "description": "Client SDK for the Tangle Sandbox platform - build AI agent applications with dev containers",
   "type": "module",
   "main": "./dist/index.js",