@tangle-network/sandbox 0.23.0 → 0.24.0-develop.20260814134500.1b07ee8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
- import { C as CodeResultPart, S as CodeLanguage, b as CodeExecutionOptions, x as CodeExecutionResult } from "../types-CxkpqFzN.js";
2
- import { n as SandboxInstance } from "../sandbox-Bqcme9Sj.js";
3
- import { i as Sandbox } from "../client-CF7SC1l6.js";
1
+ import { C as CodeResultPart, S as CodeLanguage, b as CodeExecutionOptions, x as CodeExecutionResult } from "../types-DL7FzacJ.js";
2
+ import { r as SandboxInstance } from "../sandbox-BoBp6F83.js";
3
+ import { i as Sandbox } from "../client-DaOyHsvP.js";
4
4
  import * as _$_modelcontextprotocol_sdk_server_index_js0 from "@modelcontextprotocol/sdk/server/index.js";
5
5
 
6
6
  //#region src/agent/tools/_specs.d.ts
@@ -1,6 +1,6 @@
1
- import { c as combineAbortSignals, d as applyRequestedModel, f as assertCurrentBackendType, l as encodePromptForWire, m as backendTypeSchema, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as normalizeRuntimeBackendConfig, u as encodeTextForWire } from "./runtime-api-Co-Ow_VR.js";
2
- import { a as NetworkError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-D2aWy99l.js";
3
- import { g as normalizeConnection, n as createSandboxInstanceFromResponse, r as normalizeStartupDiagnostics, v as exportTraceBundle, x as parseSSEStream } from "./sandbox-CEOxB8dH.js";
1
+ import { c as combineAbortSignals, d as applyRequestedModel, f as assertCurrentBackendType, l as encodePromptForWire, m as backendTypeSchema, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as normalizeRuntimeBackendConfig, u as encodeTextForWire } from "./runtime-api-CK-4S7oA.js";
2
+ import { a as NetworkError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
3
+ import { S as parseSSEStream, _ as normalizeConnection, i as normalizeStartupDiagnostics, n as createSandboxInstanceFromResponse, r as normalizeSandboxCreateReceipt, y as exportTraceBundle } from "./sandbox-NvbxFwTv.js";
4
4
  import { agentProfileSchema } from "@tangle-network/agent-interface";
5
5
  import { z } from "zod";
6
6
  //#region ../../../packages/runtime-contracts/dist/git-policy.js
@@ -3100,7 +3100,8 @@ var Sandbox = class {
3100
3100
  expiresAt: data.expiresAt ? new Date(data.expiresAt) : void 0,
3101
3101
  error: data.error,
3102
3102
  gpuLease: data.gpuLease,
3103
- startupDiagnostics: normalizeStartupDiagnostics(data.startupDiagnostics) ?? void 0
3103
+ startupDiagnostics: normalizeStartupDiagnostics(data.startupDiagnostics) ?? void 0,
3104
+ createReceipt: normalizeSandboxCreateReceipt(data.createReceipt) ?? void 0
3104
3105
  };
3105
3106
  }
3106
3107
  _tokenRefreshHandlers = /* @__PURE__ */ new Set();
@@ -1,5 +1,5 @@
1
- import { $n as SandboxFleetArtifactSpec, A as CreateSandboxFleetTokenOptions, Ai as TokenRefreshHandler, An as PublishPublicTemplateOptions, Cn as PromptResult, Cr as SandboxFleetWorkspaceRestoreResult, Ct as FleetExecDispatchOptions, D as CreateIntelligenceReportOptions, Dt as FleetPromptDispatchResult, Er as SandboxInfo, Et as FleetPromptDispatchOptions, Fn as ReconcileSandboxFleetsResult, Ii as UsageInfo, Jn as SandboxConfig, Jt as IntelligenceReportCompareTo, Kt as IntelligenceReport, M as CreateSandboxOptions, Mn as ReapExpiredSandboxFleetsOptions, Nn as ReapExpiredSandboxFleetsResult, O as CreateRequestOptions, On as PublicTemplateInfo, Pn as ReconcileSandboxFleetsOptions, Qi as BatchEvent, Qn as SandboxFleetArtifact, Sn as PromptOptions, Sr as SandboxFleetWorkspaceReconcileResult, St as FleetDriveTurnRequest, Tr as SandboxIdentity, Tt as FleetMachineId, Xn as SandboxEnvironment, Xt as IntelligenceReportWindow, Zr as SecretsManager, _t as FleetDispatchCancelResult, a as AttachSandboxFleetMachineOptions, ar as SandboxFleetInfo, br as SandboxFleetUsage, bt as FleetDispatchStreamOptions, dr as SandboxFleetManifest, en as ListSandboxFleetOptions, er as SandboxFleetCostEstimate, f as BatchResult, gr as SandboxFleetTraceBundle, hi as SshKeysManager, hr as SandboxFleetToken, j as CreateSandboxFleetWithCoordinatorOptions, jn as PublishPublicTemplateVersionOptions, k as CreateSandboxFleetOptions, kn as PublicTemplateVersionInfo, lr as SandboxFleetMachineRecord, m as BatchRunRequest, nr as SandboxFleetDispatchResponse, nt as ExecOptions, p as BatchRunOptions, pr as SandboxFleetOperationsSummary, qt as IntelligenceReportBudget, rr as SandboxFleetDriverCapability, rt as ExecResult, tn as ListSandboxOptions, vt as FleetDispatchResultBuffer, wr as SandboxFleetWorkspaceSnapshotResult, wt as FleetExecDispatchResult, xn as PromptInputPart, xt as FleetDriveTurnOutcome, yi as SubscriptionInfo, yr as SandboxFleetTraceOptions, yt as FleetDispatchResultBufferOptions } from "./types-CxkpqFzN.js";
2
- import { c as TraceExportResult, l as TraceExportSink, n as SandboxInstance, t as HttpClient } from "./sandbox-Bqcme9Sj.js";
1
+ import { $t as IntelligenceReportWindow, A as CreateSandboxFleetTokenOptions, Ar as SandboxFleetWorkspaceRestoreResult, Bi as TokenRefreshHandler, Cr as SandboxFleetTraceBundle, Ct as FleetExecDispatchOptions, D as CreateIntelligenceReportOptions, Dr as SandboxFleetUsage, Dt as FleetPromptDispatchResult, En as PromptResult, Er as SandboxFleetTraceOptions, Et as FleetPromptDispatchOptions, Fn as ReapExpiredSandboxFleetsOptions, In as ReapExpiredSandboxFleetsResult, Ki as UsageInfo, Ln as ReconcileSandboxFleetsOptions, M as CreateSandboxOptions, Mn as PublicTemplateVersionInfo, Mr as SandboxIdentity, Nn as PublishPublicTemplateOptions, Nr as SandboxInfo, O as CreateRequestOptions, Pn as PublishPublicTemplateVersionOptions, Rn as ReconcileSandboxFleetsResult, Sr as SandboxFleetToken, St as FleetDriveTurnRequest, Ti as SshKeysManager, Tn as PromptOptions, Tt as FleetMachineId, Xt as IntelligenceReportBudget, Yt as IntelligenceReport, Zn as SandboxConfig, Zt as IntelligenceReportCompareTo, _t as FleetDispatchCancelResult, a as AttachSandboxFleetMachineOptions, ar as SandboxFleetArtifact, br as SandboxFleetOperationsSummary, bt as FleetDispatchStreamOptions, f as BatchResult, fr as SandboxFleetInfo, gr as SandboxFleetMachineRecord, ii as SecretsManager, in as ListSandboxOptions, j as CreateSandboxFleetWithCoordinatorOptions, jn as PublicTemplateInfo, jr as SandboxFleetWorkspaceSnapshotResult, k as CreateSandboxFleetOptions, ki as SubscriptionInfo, kr as SandboxFleetWorkspaceReconcileResult, la as BatchEvent, lr as SandboxFleetDispatchResponse, m as BatchRunRequest, nt as ExecOptions, or as SandboxFleetArtifactSpec, p as BatchRunOptions, rn as ListSandboxFleetOptions, rr as SandboxEnvironment, rt as ExecResult, sr as SandboxFleetCostEstimate, ur as SandboxFleetDriverCapability, vr as SandboxFleetManifest, vt as FleetDispatchResultBuffer, wn as PromptInputPart, wt as FleetExecDispatchResult, xt as FleetDriveTurnOutcome, yt as FleetDispatchResultBufferOptions } from "./types-DL7FzacJ.js";
2
+ import { l as TraceExportResult, n as HttpClient, r as SandboxInstance, u as TraceExportSink } from "./sandbox-BoBp6F83.js";
3
3
 
4
4
  //#region src/lib/sse-parser.d.ts
5
5
  /**
@@ -1,2 +1,2 @@
1
- import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "../collaboration-CqPA0kar.js";
1
+ import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "../collaboration-COCXdRrk.js";
2
2
  export { CollaborationClient, CollaborationFileBridge, buildCollaborationDocumentId, normalizeCollaborationPath, parseCollaborationDocumentId };
@@ -1,4 +1,4 @@
1
- import { a as NetworkError, f as TimeoutError, m as parseErrorResponse } from "./errors-D2aWy99l.js";
1
+ import { a as NetworkError, f as TimeoutError, m as parseErrorResponse } from "./errors-C6kn-3zt.js";
2
2
  //#region src/collaboration/client.ts
3
3
  const DEFAULT_TIMEOUT_MS = 3e4;
4
4
  function normalizeBaseUrl(url) {
package/dist/core.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { Er as SandboxInfo, Jn as SandboxConfig, M as CreateSandboxOptions, Pr as SandboxStatus, an as NetworkConfig, dn as PreviewLinkManager, fn as PreviewLinkWaitOptions, nt as ExecOptions, rt as ExecResult, un as PreviewLinkInfo, xn as PromptInputPart } from "./types-CxkpqFzN.js";
2
- import { a as WorkspaceImagePublishResult, i as WorkspaceImagePublishRequestOptions, n as SandboxInstance, o as WorkspaceImages, r as WorkspaceImagePublishInput } from "./sandbox-Bqcme9Sj.js";
3
- import { i as Sandbox } from "./client-CF7SC1l6.js";
1
+ import { M as CreateSandboxOptions, Nr as SandboxInfo, Vr as SandboxStatus, Zn as SandboxConfig, cn as NetworkConfig, hn as PreviewLinkWaitOptions, mn as PreviewLinkManager, nt as ExecOptions, pn as PreviewLinkInfo, rt as ExecResult, wn as PromptInputPart } from "./types-DL7FzacJ.js";
2
+ import { a as WorkspaceImagePublishRequestOptions, i as WorkspaceImagePublishInput, o as WorkspaceImagePublishResult, r as SandboxInstance, s as WorkspaceImages } from "./sandbox-BoBp6F83.js";
3
+ import { i as Sandbox } from "./client-DaOyHsvP.js";
4
4
  import { a as NetworkError, c as QuotaError, d as SandboxFailureDetail, f as ServerError, h as ValidationError, i as FileWriteConflictError, l as SandboxError, m as TimeoutError, n as CapabilityError, o as NotFoundError, p as StateError, s as PartialFailureError, t as AuthError, u as SandboxErrorJson } from "./errors-Bdy5jXzc.js";
5
5
  export { AuthError, CapabilityError, type CreateSandboxOptions, type ExecOptions, type ExecResult, FileWriteConflictError, type NetworkConfig, NetworkError, NotFoundError, PartialFailureError, type PreviewLinkInfo, type PreviewLinkManager, type PreviewLinkWaitOptions, type PromptInputPart, QuotaError, Sandbox, type SandboxConfig, SandboxError, type SandboxErrorJson, type SandboxFailureDetail, type SandboxInfo, SandboxInstance, type SandboxStatus, ServerError, StateError, TimeoutError, ValidationError, type WorkspaceImagePublishInput, type WorkspaceImagePublishRequestOptions, type WorkspaceImagePublishResult, WorkspaceImages };
package/dist/core.js CHANGED
@@ -1,4 +1,4 @@
1
- import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-D2aWy99l.js";
2
- import { n as Sandbox } from "./client-ClR-isrv.js";
3
- import { i as WorkspaceImages, t as SandboxInstance } from "./sandbox-CEOxB8dH.js";
1
+ import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
2
+ import { n as Sandbox } from "./client-CMjk9V9B.js";
3
+ import { a as WorkspaceImages, t as SandboxInstance } from "./sandbox-NvbxFwTv.js";
4
4
  export { AuthError, CapabilityError, FileWriteConflictError, NetworkError, NotFoundError, PartialFailureError, QuotaError, Sandbox, SandboxError, SandboxInstance, ServerError, StateError, TimeoutError, ValidationError, WorkspaceImages };
@@ -273,9 +273,12 @@ function parseErrorResponse(status, body, context, headers) {
273
273
  const rawReason = typeof data.reason === "string" ? data.reason : typeof errorObj === "object" && errorObj !== null ? errorObj.reason : void 0;
274
274
  const reason = typeof rawReason === "string" && rawReason.trim().length > 0 ? rawReason.trim() : void 0;
275
275
  const code = asErrorCode(data.code) ?? nestedCode;
276
+ const rawLog = typeof errorObj === "object" && errorObj !== null ? errorObj.log : void 0;
277
+ const logTail = typeof rawLog === "string" && rawLog.trim().length > 0 ? rawLog.trim() : void 0;
276
278
  const prefix = context ? `${context.method ?? "REQUEST"} ${context.path ?? ""}: ` : "";
277
279
  const composedMessage = shouldAppendDetails ? `${baseMessage}: ${details}` : baseMessage;
278
- const message = `${prefix}${reason && !composedMessage.includes(reason) ? `${composedMessage}: ${reason}` : composedMessage}`;
280
+ const messageWithReason = `${prefix}${reason && !composedMessage.includes(reason) ? `${composedMessage}: ${reason}` : composedMessage}`;
281
+ const message = logTail && !messageWithReason.includes(logTail) ? `${messageWithReason}\n${logTail}` : messageWithReason;
279
282
  const metadata = {
280
283
  origin: inferOrigin(headers, context),
281
284
  endpoint: context?.path ?? headers?.get("x-tangle-request-path") ?? void 0,
@@ -1,5 +1,5 @@
1
- import { M as CreateSandboxOptions } from "./types-CxkpqFzN.js";
2
- import { n as SandboxInstance, t as HttpClient } from "./sandbox-Bqcme9Sj.js";
1
+ import { M as CreateSandboxOptions } from "./types-DL7FzacJ.js";
2
+ import { n as HttpClient, r as SandboxInstance } from "./sandbox-BoBp6F83.js";
3
3
 
4
4
  //#region src/tangle/abi.d.ts
5
5
  /**
package/dist/index.d.ts CHANGED
@@ -1,10 +1,10 @@
1
- import { $ as EnsureDevServerOptions, $i as BatchEventDataMap, $n as SandboxFleetArtifactSpec, $r as SendSessionMessageRequest, $t as ListOptions, Ai as TokenRefreshHandler, An as PublishPublicTemplateOptions, Ar as SandboxResourceUsage, At as GitBranch, B as DownloadOptions, Bi as WriteManyFile, Bn as RolloutChildResult, Br as SandboxTerminals, Bt as GpuLeaseManager, Ci as TaskSessionInfo, Cn as PromptResult, Cr as SandboxFleetWorkspaceRestoreResult, Ct as FleetExecDispatchOptions, D as CreateIntelligenceReportOptions, Di as TeeAttestationResponse, Dn as ProvisionStep, Dr as SandboxIntelligenceEnvelope, E as CreateGpuLeaseOptions, Ei as TeeAttestationReport, En as ProvisionStatus, Er as SandboxInfo, Et as FleetPromptDispatchOptions, F as DeleteOptions, Fi as UploadProgress, Fn as ReconcileSandboxFleetsResult, Fr as SandboxTerminalAttachOptions, Ft as GpuLease, G as DriverType, Gi as TerminalStream, Gn as RolloutTurnPart, Gr as SandboxUser, Gt as InstalledTool, H as DriveTurnOptions, Hi as TERMINAL_WS_ECHO_SUBPROTOCOL, Hn as RolloutScorer, Hr as SandboxTraceEvent, Ht as GpuLeaseStatus, I as DevServerInfo, Ii as UsageInfo, In as RenameOptions, Ir as SandboxTerminalCreateOptions, It as GpuLeaseBilling, J as EffectiveBackend, Ji as TerminalStreamHandlers, Jn as SandboxConfig, Jr as SearchMatch, Jt as IntelligenceReportCompareTo, K as DurablePlan, Ki as TerminalStreamAuthFormat, Kn as SSHCommandDescriptor, Kr as ScopedToken, Kt as IntelligenceReport, L as DirectoryPermission, Li as WaitForOptions, Lr as SandboxTerminalInfo, Lt as GpuLeaseCommandResult, M as CreateSandboxOptions, Mi as TurnDriveResult, Mn as ReapExpiredSandboxFleetsOptions, Mr as SandboxRuntimeCapabilities, Mt as GitConfig, N as CreateSessionOptions, Ni as UpdateUserOptions, Nn as ReapExpiredSandboxFleetsResult, Nr as SandboxRuntimeHealth, Nt as GitDiff, O as CreateRequestOptions, Oi as TeePublicKey, On as PublicTemplateInfo, Or as SandboxPortBinding, Ot as GPU_LEASE_PROVIDER_NAMES, P as CreateTaskSessionOptions, Pi as UploadOptions, Pn as ReconcileSandboxFleetsOptions, Pr as SandboxStatus, Pt as GitStatus, Q as EgressPolicy, Qi as BatchEvent, Qn as SandboxFleetArtifact, Qr as SendSessionMessageOptions, Qt as ListMessagesOptions, R as DispatchPromptOptions, Ri as WaitForRolloutOptions, Rr as SandboxTerminalManager, Rt as GpuLeaseExecOptions, Si as TaskSessionFileChange, Sn as PromptOptions, Sr as SandboxFleetWorkspaceReconcileResult, St as FleetDriveTurnRequest, T as CompletedTurnResult, Ti as TeeAttestationOptions, Tn as ProvisionResult, Tr as SandboxIdentity, Tt as FleetMachineId, U as DriverConfig, Ui as TerminalExitInfo, Un as RolloutStartResult, Ur as SandboxTraceExport, Ut as HostAgentDriverConfig, V as DownloadProgress, Vi as WriteManyOptions, Vn as RolloutOptions, Vr as SandboxTraceBundle, Vt as GpuLeaseProviderName, W as DriverInfo, Wi as TerminalReadyInfo, Wn as RolloutStatus, Wr as SandboxTraceOptions, Wt as HostAgentRuntimeBackend, X as EffectiveBackendSource, Xi as TerminalStreamToken, Xn as SandboxEnvironment, Xr as SecretInfo, Xt as IntelligenceReportWindow, Y as EffectiveBackendProfile, Yi as TerminalStreamOptions, Yn as SandboxConnection, Yr as SearchOptions, Yt as IntelligenceReportSubjectType, Z as EgressManager, Zi as BatchBackendStats, Zn as SandboxEvent, Zr as SecretsManager, _ as BranchOptions, _i as StartupOperation, _n as ProcessManager, _r as SandboxFleetTraceEvent, _t as FleetDispatchCancelResult, a as AttachSandboxFleetMachineOptions, ai as SessionInfo, an as NetworkConfig, ar as SandboxFleetInfo, at as FileReadBatchOptions, bi as TaskSessionChanges, bn as ProcessStatus, br as SandboxFleetUsage, bt as FleetDispatchStreamOptions, c as BackendInfo, ci as SessionMessage, cn as PermissionLevel, cr as SandboxFleetMachineMeteredUsage, ct as FileReadResult, d as BatchBackend, di as SessionStatus, dn as PreviewLinkManager, dr as SandboxFleetManifest, dt as FileTreeFile, ea as BatchSidecarGroup, ei as SentSessionMessage, en as ListSandboxFleetOptions, er as SandboxFleetCostEstimate, et as EventStreamOptions, f as BatchResult, fi as SnapshotInfo, fn as PreviewLinkWaitOptions, fr as SandboxFleetManifestMachine, ft as FileTreeOptions, g as BatchTaskResult, gi as StartupDiagnostics, gn as ProcessLogEntry, gr as SandboxFleetTraceBundle, gt as FileWriteResult, h as BatchTask, hn as ProcessListOptions, hr as SandboxFleetToken, ht as FileUsageResult, i as AttachGpuLeaseOptions, ia as parseBackendType, ii as SessionForkOptions, in as MkdirOptions, ir as SandboxFleetDriverTimings, it as FileInfo, j as CreateSandboxFleetWithCoordinatorOptions, ji as TokenUsage, jn as PublishPublicTemplateVersionOptions, jr as SandboxResources, jt as GitCommit, k as CreateSandboxFleetOptions, ki as TeePublicKeyResponse, kn as PublicTemplateVersionInfo, kr as SandboxPortPreviewLink, kt as GitAuth, l as BackendManager, li as SessionMessageInputPart, ln as PermissionsManager, lr as SandboxFleetMachineRecord, lt as FileRenameResult, m as BatchRunRequest, mi as SnapshotResult, mn as ProcessInfo, mr as SandboxFleetPolicy, mt as FileUsageOptions, n as AccessPolicyRule, na as PublicBatchRunRequest, ni as SessionEventStreamOptions, nn as McpServerConfig, nr as SandboxFleetDispatchResponse, nt as ExecOptions, o as BackendCapabilities, oi as SessionInterruptOptions, on as NetworkManager, or as SandboxFleetIntelligenceEnvelope, ot as FileReadBatchResult, p as BatchRunOptions, pi as SnapshotOptions, pn as Process, pr as SandboxFleetOperationsSummary, pt as FileTreeResult, q as DurablePlanDecisionResult, qi as TerminalStreamError, qn as SSHCredentials, qr as ScopedTokenScope, qt as IntelligenceReportBudget, r as AddUserOptions, ra as BackendType, ri as SessionFailureReason, rn as MintScopedTokenOptions, rr as SandboxFleetDriverCapability, rt as ExecResult, s as BackendConfig, si as SessionListOptions, sn as NonHostAgentDriverConfig, sr as SandboxFleetMachine, st as FileReadError, t as AcceleratorKind, ta as BatchTaskUsage, ti as SessionBackendCredentials, tn as ListSandboxOptions, tr as SandboxFleetDispatchFailureClass, tt as ExactProcessSpawnOptions, u as BackendStatus, ui as SessionResultOptions, un as PreviewLinkInfo, ur as SandboxFleetMachineSpec, ut as FileSystem, v as ChunkedUploadOptions, vi as StorageConfig, vn as ProcessSignal, vr as SandboxFleetTraceExport, vt as FleetDispatchResultBuffer, w as CommitTaskSessionOptions, wi as TaskSessionProfile, wn as ProvisionEvent, wr as SandboxFleetWorkspaceSnapshotResult, xi as TaskSessionCommitResult, xn as PromptInputPart, xr as SandboxFleetWorkspace, xt as FleetDriveTurnOutcome, y as ChunkedUploadResult, yi as SubscriptionInfo, yn as ProcessSpawnOptions, yr as SandboxFleetTraceOptions, yt as FleetDispatchResultBufferOptions, z as DispatchedSession, zi as WriteFileOptions, zn as Rollout, zr as SandboxTerminalRequestOptions, zt as GpuLeaseExecResult } from "./types-CxkpqFzN.js";
2
- import { A as BuildSandboxMcpConfigOptions, C as RespondToPermissionOptions, D as SandboxInteractionResolution, E as SandboxInteractionConflict, F as SandboxMcpServerEntry, I as buildControlPlaneMcpConfig, L as buildSandboxMcpConfig, M as SANDBOX_MCP_SERVER_NAME, N as SandboxMcpConfig, O as SandboxInteractionResult, P as SandboxMcpEndpoint, S as InterruptResult, T as SandboxInteractionCommandResult, _ as InteractiveAuthFile, a as WorkspaceImagePublishResult, b as InteractiveSessionInfo, c as TraceExportResult, d as exportTraceBundle, f as otelTraceIdForTangleTrace, g as InteractiveAttachOptions, h as SandboxSession, i as WorkspaceImagePublishRequestOptions, j as CONTROL_PLANE_MCP_SERVER_NAME, k as BuildControlPlaneMcpConfigOptions, l as TraceExportSink, m as SandboxTaskSession, n as SandboxInstance, o as WorkspaceImages, p as toOtelJson, r as WorkspaceImagePublishInput, s as TraceExportFormat, u as buildTraceExportPayload, v as InteractiveSessionHandle, w as StartInteractiveOptions, x as InteractiveSessionStatus, y as InteractiveSessionHost } from "./sandbox-Bqcme9Sj.js";
3
- import { a as Team, c as SessionBroadcastEvent, d as SandboxFleetClient, f as ParseSSEStreamOptions, i as Sandbox, l as SessionBroadcastResult, m as parseSSEStream, n as IntelligenceClient, o as TeamInvitation, p as ParsedSSEEvent, r as InviteTeamMemberOptions, s as TeamMember, t as CreateTeamOptions, u as SandboxFleet } from "./client-CF7SC1l6.js";
1
+ import { $ as EnsureDevServerOptions, $i as TERMINAL_WS_ECHO_SUBPROTOCOL, $n as SandboxCreateOutcome, $r as ScopedToken, $t as IntelligenceReportWindow, Ai as TaskSessionChanges, An as ProvisionStep, Ar as SandboxFleetWorkspaceRestoreResult, At as ForkLookupOptions, B as DownloadOptions, Bi as TokenRefreshHandler, Br as SandboxRuntimeHealth, Bt as GpuLeaseCommandResult, Ci as SnapshotOptions, Cn as ProcessStatus, Cr as SandboxFleetTraceBundle, Ct as FleetExecDispatchOptions, D as CreateIntelligenceReportOptions, Di as StartupOperation, Dn as ProvisionEvent, Dr as SandboxFleetUsage, E as CreateGpuLeaseOptions, Ei as StartupDiagnostics, En as PromptResult, Er as SandboxFleetTraceOptions, Et as FleetPromptDispatchOptions, F as DeleteOptions, Fi as TeeAttestationOptions, Fn as ReapExpiredSandboxFleetsOptions, Fr as SandboxPortBinding, Ft as GitConfig, G as DriverType, Gi as UploadProgress, Gn as RolloutScorer, Gr as SandboxTerminalManager, Gt as GpuLeaseStatus, H as DriveTurnOptions, Hi as TurnDriveResult, Hn as Rollout, Hr as SandboxTerminalAttachOptions, Ht as GpuLeaseExecResult, I as DevServerInfo, Ii as TeeAttestationReport, In as ReapExpiredSandboxFleetsResult, Ir as SandboxPortPreviewLink, It as GitDiff, J as EffectiveBackend, Ji as WaitForRolloutOptions, Jn as RolloutTurnPart, Jr as SandboxTraceBundle, Jt as InstalledTool, K as DurablePlan, Ki as UsageInfo, Kn as RolloutStartResult, Kr as SandboxTerminalRequestOptions, Kt as HostAgentDriverConfig, L as DirectoryPermission, Li as TeeAttestationResponse, Ln as ReconcileSandboxFleetsOptions, Lr as SandboxResourceUsage, Lt as GitStatus, M as CreateSandboxOptions, Mi as TaskSessionFileChange, Mn as PublicTemplateVersionInfo, Mr as SandboxIdentity, Mt as GitAuth, N as CreateSessionOptions, Ni as TaskSessionInfo, Nn as PublishPublicTemplateOptions, Nr as SandboxInfo, Nt as GitBranch, O as CreateRequestOptions, Oi as StorageConfig, On as ProvisionResult, Or as SandboxFleetWorkspace, Ot as ForkCounts, P as CreateTaskSessionOptions, Pi as TaskSessionProfile, Pn as PublishPublicTemplateVersionOptions, Pr as SandboxIntelligenceEnvelope, Pt as GitCommit, Q as EgressPolicy, Qi as WriteManyOptions, Qn as SandboxConnection, Qr as SandboxUser, Qt as IntelligenceReportSubjectType, R as DispatchPromptOptions, Ri as TeePublicKey, Rn as ReconcileSandboxFleetsResult, Rr as SandboxResources, Rt as GpuLease, Si as SnapshotInfo, Sn as ProcessSpawnOptions, Sr as SandboxFleetToken, St as FleetDriveTurnRequest, T as CompletedTurnResult, Tn as PromptOptions, Tr as SandboxFleetTraceExport, Tt as FleetMachineId, U as DriverConfig, Ui as UpdateUserOptions, Un as RolloutChildResult, Ur as SandboxTerminalCreateOptions, Ut as GpuLeaseManager, V as DownloadProgress, Vi as TokenUsage, Vr as SandboxStatus, Vt as GpuLeaseExecOptions, W as DriverInfo, Wi as UploadOptions, Wn as RolloutOptions, Wr as SandboxTerminalInfo, Wt as GpuLeaseProviderName, X as EffectiveBackendSource, Xi as WriteFileOptions, Xn as SSHCredentials, Xr as SandboxTraceExport, Xt as IntelligenceReportBudget, Y as EffectiveBackendProfile, Yi as WorkspaceOperationLookup, Yn as SSHCommandDescriptor, Yr as SandboxTraceEvent, Yt as IntelligenceReport, Z as EgressManager, Zi as WriteManyFile, Zn as SandboxConfig, Zr as SandboxTraceOptions, Zt as IntelligenceReportCompareTo, _ as BranchOptions, _i as SessionResultOptions, _n as ProcessInfo, _r as SandboxFleetMachineSpec, _t as FleetDispatchCancelResult, a as AttachSandboxFleetMachineOptions, aa as TerminalStreamHandlers, ai as SendSessionMessageOptions, an as McpServerConfig, ar as SandboxFleetArtifact, at as FileReadBatchOptions, bi as SnapshotDeleteOutcome, bn as ProcessManager, br as SandboxFleetOperationsSummary, bt as FleetDispatchStreamOptions, c as BackendInfo, ca as BatchBackendStats, ci as SessionBackendCredentials, cn as NetworkConfig, cr as SandboxFleetDispatchFailureClass, ct as FileReadResult, d as BatchBackend, da as BatchSidecarGroup, di as SessionForkOptions, dn as PermissionLevel, dr as SandboxFleetDriverTimings, dt as FileTreeFile, ea as TerminalExitInfo, ei as ScopedTokenScope, er as SandboxCreateReceipt, et as EventStreamOptions, f as BatchResult, fa as BatchTaskUsage, fi as SessionInfo, fn as PermissionsManager, fr as SandboxFleetInfo, ft as FileTreeOptions, g as BatchTaskResult, gi as SessionMessageInputPart, gn as Process, gr as SandboxFleetMachineRecord, gt as FileWriteResult, h as BatchTask, ha as parseBackendType, hi as SessionMessage, hn as PreviewLinkWaitOptions, hr as SandboxFleetMachineMeteredUsage, ht as FileUsageResult, i as AttachGpuLeaseOptions, ia as TerminalStreamError, ii as SecretsManager, in as ListSandboxOptions, ir as SandboxEvent, it as FileInfo, j as CreateSandboxFleetWithCoordinatorOptions, ji as TaskSessionCommitResult, jn as PublicTemplateInfo, jr as SandboxFleetWorkspaceSnapshotResult, jt as GPU_LEASE_PROVIDER_NAMES, k as CreateSandboxFleetOptions, ki as SubscriptionInfo, kn as ProvisionStatus, kr as SandboxFleetWorkspaceReconcileResult, kt as ForkIdempotency, l as BackendManager, la as BatchEvent, li as SessionEventStreamOptions, ln as NetworkManager, lr as SandboxFleetDispatchResponse, lt as FileRenameResult, m as BatchRunRequest, ma as BackendType, mi as SessionListOptions, mn as PreviewLinkManager, mr as SandboxFleetMachine, mt as FileUsageOptions, n as AccessPolicyRule, na as TerminalStream, ni as SearchOptions, nn as ListOptions, nr as SandboxDeleteOutcome, nt as ExecOptions, o as BackendCapabilities, oa as TerminalStreamOptions, oi as SendSessionMessageRequest, on as MintScopedTokenOptions, or as SandboxFleetArtifactSpec, ot as FileReadBatchResult, p as BatchRunOptions, pa as PublicBatchRunRequest, pi as SessionInterruptOptions, pn as PreviewLinkInfo, pr as SandboxFleetIntelligenceEnvelope, pt as FileTreeResult, q as DurablePlanDecisionResult, qi as WaitForOptions, qn as RolloutStatus, qr as SandboxTerminals, qt as HostAgentRuntimeBackend, r as AddUserOptions, ra as TerminalStreamAuthFormat, ri as SecretInfo, rn as ListSandboxFleetOptions, rr as SandboxEnvironment, rt as ExecResult, s as BackendConfig, sa as TerminalStreamToken, si as SentSessionMessage, sn as MkdirOptions, sr as SandboxFleetCostEstimate, st as FileReadError, t as AcceleratorKind, ta as TerminalReadyInfo, ti as SearchMatch, tn as ListMessagesOptions, tr as SandboxDeleteAcknowledgement, tt as ExactProcessSpawnOptions, u as BackendStatus, ua as BatchEventDataMap, ui as SessionFailureReason, un as NonHostAgentDriverConfig, ur as SandboxFleetDriverCapability, ut as FileSystem, v as ChunkedUploadOptions, vi as SessionStatus, vn as ProcessListOptions, vr as SandboxFleetManifest, vt as FleetDispatchResultBuffer, w as CommitTaskSessionOptions, wi as SnapshotResult, wn as PromptInputPart, wr as SandboxFleetTraceEvent, xi as SnapshotIdempotency, xn as ProcessSignal, xr as SandboxFleetPolicy, xt as FleetDriveTurnOutcome, y as ChunkedUploadResult, yi as SnapshotDeleteAcknowledgement, yn as ProcessLogEntry, yr as SandboxFleetManifestMachine, yt as FleetDispatchResultBufferOptions, z as DispatchedSession, zi as TeePublicKeyResponse, zn as RenameOptions, zr as SandboxRuntimeCapabilities, zt as GpuLeaseBilling } from "./types-DL7FzacJ.js";
2
+ import { A as BuildControlPlaneMcpConfigOptions, C as InterruptResult, D as SandboxInteractionConflict, E as SandboxInteractionCommandResult, F as SandboxMcpEndpoint, I as SandboxMcpServerEntry, L as buildControlPlaneMcpConfig, M as CONTROL_PLANE_MCP_SERVER_NAME, N as SANDBOX_MCP_SERVER_NAME, O as SandboxInteractionResolution, P as SandboxMcpConfig, R as buildSandboxMcpConfig, S as InteractiveSessionStatus, T as StartInteractiveOptions, _ as InteractiveAttachOptions, a as WorkspaceImagePublishRequestOptions, b as InteractiveSessionHost, c as TraceExportFormat, d as buildTraceExportPayload, f as exportTraceBundle, g as SandboxSession, h as SandboxTaskSession, i as WorkspaceImagePublishInput, j as BuildSandboxMcpConfigOptions, k as SandboxInteractionResult, l as TraceExportResult, m as toOtelJson, o as WorkspaceImagePublishResult, p as otelTraceIdForTangleTrace, r as SandboxInstance, s as WorkspaceImages, t as ForkAcknowledgement, u as TraceExportSink, v as InteractiveAuthFile, w as RespondToPermissionOptions, x as InteractiveSessionInfo, y as InteractiveSessionHandle } from "./sandbox-BoBp6F83.js";
3
+ import { a as Team, c as SessionBroadcastEvent, d as SandboxFleetClient, f as ParseSSEStreamOptions, i as Sandbox, l as SessionBroadcastResult, m as parseSSEStream, n as IntelligenceClient, o as TeamInvitation, p as ParsedSSEEvent, r as InviteTeamMemberOptions, s as TeamMember, t as CreateTeamOptions, u as SandboxFleet } from "./client-DaOyHsvP.js";
4
4
  import { d as AnyTokenPayload, h as IssueCollaborationTokenOptions, m as CollaborationTokenPayload, p as CollaborationAccess } from "./index-DtRFVx5U.js";
5
5
  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-Cp1KYanB.js";
6
6
  import { a as NetworkError, c as QuotaError, d as SandboxFailureDetail, f as ServerError, h as ValidationError, i as FileWriteConflictError, l as SandboxError, m as TimeoutError, n as CapabilityError, o as NotFoundError, p as StateError, r as EgressProxyRecoveryError, s as PartialFailureError, t as AuthError, u as SandboxErrorJson } from "./errors-Bdy5jXzc.js";
7
- import { s as TangleSandboxClientConfig, t as TangleSandboxClient } from "./index-Cx3hAzB9.js";
7
+ import { s as TangleSandboxClientConfig, t as TangleSandboxClient } from "./index-DIuMQrlL.js";
8
8
  import * as _$_tangle_network_agent_interface0 from "@tangle-network/agent-interface";
9
9
  import { AgentProfile, AgentProfile as AgentProfile$1, AgentProfileCapabilities, AgentProfileConfidential, AgentProfileConfigValue, AgentProfileConnection, AgentProfileFileMount, AgentProfileFileMount as AgentProfileFileMount$1, AgentProfileMcpServer, AgentProfileModelHints, AgentProfilePermissionValue, AgentProfilePrompt, AgentProfileResourceRef, AgentProfileResources, AgentProfileSecurityPolicy, AgentProfileValidationIssue, AgentProfileValidationResult, AgentRunCancellationAcknowledgement, AgentRunCancellationRequest, AgentSubagentProfile, Capability, SANDBOX_SIZE_PRESET_NAMES, SandboxSizePreset } from "@tangle-network/agent-interface";
10
10
  import { z } from "zod";
@@ -4425,4 +4425,4 @@ interface RouterEvalMatrixCaseResult {
4425
4425
  }
4426
4426
  declare function runTangleRouterEvalMatrixInSandbox(options: RunTangleRouterEvalMatrixInSandboxOptions): Promise<RunTangleRouterEvalMatrixInSandboxResult>;
4427
4427
  //#endregion
4428
- export { type AcceleratorKind, type AccessPolicyRule, type AddUserOptions, type AgentProfile, type AgentProfileCapabilities, type AgentProfileConnection, type AgentProfileFileMount, type AgentProfileMcpServer, type AgentProfileModelHints, type AgentProfilePermissionValue, type AgentProfilePrompt, type AgentProfileResourceRef, type AgentProfileResources, type AgentProfileSecurityPolicy, type AgentProfileValidationIssue, type AgentProfileValidationResult, type AgentRunCancellationAcknowledgement, type AgentRunCancellationRequest, type AgentSubagentProfile, type AnyTokenPayload, type AttachGpuLeaseOptions, type AttachSandboxFleetMachineOptions, AuthError, type BackendCapabilities, type BackendConfig, type BackendInfo, type BackendManager, type BackendStatus, type BackendType, type BatchBackend, type BatchBackendStats, type BatchEvent, type BatchEventDataMap, type BatchResult, type BatchResultAccumulator, type BatchRunOptions, type BatchRunRequest, type BatchSidecarGroup, type BatchTask, type BatchTaskResult, type BatchTaskUsage, type BranchOptions, type BuildControlPlaneMcpConfigOptions, type BuildProgressEvent, type BuildSandboxMcpConfigOptions, CONTROL_PLANE_MCP_SERVER_NAME, type Capability, CapabilityError, type ChunkedUploadOptions, type ChunkedUploadResult, type CollaborationAccess, type CollaborationBootstrapRequest, type CollaborationBootstrapResponse, CollaborationClient, type CollaborationClientConfig, type CollaborationDocumentAdapter, type CollaborationDocumentChange, type CollaborationDocumentRef, CollaborationFileBridge, type CollaborationFileBridgeOptions, type CollaborationFileEvent, type CollaborationPermissions, type CollaborationTokenPayload, type CollaborationTokenRefreshRequest, type CollaborationTokenRefreshResponse, type CollaborationTransportConfig, type CommitTaskSessionOptions, type CompletedTurnResult, type ConfidentialSandboxResult, type ConfidentialTeeType, type CreateConfidentialSandboxOptions, type CreateGpuLeaseOptions, type CreateIntelligenceReportOptions, type CreateRequestOptions, type CreateSandboxFleetOptions, type CreateSandboxFleetWithCoordinatorOptions, type CreateSandboxOptions, type CreateSessionOptions, type CreateTaskSessionOptions, type CreateTeamOptions, DEFAULT_SANDBOX_SIZE, type DeleteOptions, type DevServerInfo, type DirectoryPermission, type DispatchPromptOptions, type DispatchedSession, type DownloadOptions, type DownloadProgress, type DriveTurnOptions, type DriverConfig, type DriverInfo, type DriverType, type DurablePlan, type DurablePlanDecisionResult, type EffectiveBackend, type EffectiveBackendProfile, type EffectiveBackendSource, type EgressManager, type EgressPolicy, EgressProxyRecoveryError, type EnsureDevServerOptions, type EventStreamOptions, type ExactProcessSpawnOptions, type ExecOptions, type ExecResult, type FileInfo, type FileReadBatchOptions, type FileReadBatchResult, type FileReadError, type FileReadResult, type FileRenameResult, type FileSystem, type FileTreeFile, type FileTreeOptions, type FileTreeResult, type FileUsageOptions, type FileUsageResult, FileWriteConflictError, type FileWriteResult, type FleetDispatchCancelResult, type FleetDispatchResultBuffer, type FleetDispatchResultBufferOptions, type FleetDispatchStreamOptions, type FleetDriveTurnOutcome, type FleetDriveTurnRequest, type FleetExecDispatchOptions, type FleetMachineId, type FleetPromptDispatchOptions, GPU_LEASE_PROVIDER_NAMES, type GitAuth, type GitBranch, type GitCommit, type GitConfig, type GitDiff, type GitStatus, type GpuLease, type GpuLeaseBilling, type GpuLeaseCommandResult, type GpuLeaseExecOptions, type GpuLeaseExecResult, type GpuLeaseManager, type GpuLeaseProviderName, type GpuLeaseStatus, type HostAgentDriverConfig, type HostAgentRuntimeBackend, Image, type ImageBuildClient, type ImageBuildClientConfig, type ImageBuildFetchClient, type ImageBuildOptions, type ImageBuildResult, ImageBuilder, type ImageSpec, type InstalledTool, IntelligenceClient, type IntelligenceReport, type IntelligenceReportBudget, type IntelligenceReportCompareTo, type IntelligenceReportSubjectType, type IntelligenceReportWindow, type InteractiveAttachOptions, type InteractiveAuthFile, InteractiveSessionHandle, type InteractiveSessionHost, type InteractiveSessionInfo, type InteractiveSessionStatus, type InterruptResult, type InviteTeamMemberOptions, type IssueCollaborationTokenOptions, type ListMessagesOptions, type ListOptions, type ListSandboxFleetOptions, type ListSandboxOptions, MANAGE_SANDBOXES_PARAMETERS, MANAGE_SANDBOXES_TOOL_NAME, type ManageSandboxesInput, type ManageSandboxesTool, type ManageSandboxesToolOptions, type MaterializeProfileFileMountsOptions, type MaterializeProfileFileMountsResult, type McpServerConfig, type MintScopedTokenOptions, type MkdirOptions, type NetworkConfig, NetworkError, type NetworkManager, type NonHostAgentDriverConfig, NotFoundError, type ParseSSEStreamOptions, type ParsedSSEEvent, PartialFailureError, type PermissionLevel, type PermissionsManager, type PreviewLinkInfo, type PreviewLinkManager, type PreviewLinkWaitOptions, type Process, type ProcessInfo, type ProcessListOptions, type ProcessLogEntry, type ProcessManager, type ProcessSignal, type ProcessSpawnOptions, type ProcessStatus, type PromptInputPart, type PromptOptions, type PromptResult, type ProvisionEvent, type ProvisionResult, type ProvisionStatus, type ProvisionStep, type PublicTemplateInfo, type PublicTemplateVersionInfo, type PublishPublicTemplateOptions, type PublishPublicTemplateVersionOptions, QuotaError, type ReapExpiredSandboxFleetsOptions, type ReapExpiredSandboxFleetsResult, type ReconcileSandboxFleetsOptions, type ReconcileSandboxFleetsResult, type RenameOptions, type RespondToPermissionOptions, type Rollout, type RolloutChildResult, type RolloutOptions, type RolloutScorer, type RolloutStartResult, type RolloutStatus, type RolloutTurnPart, type RouterEvalMatrixAgentProfile, type RouterEvalMatrixCaseResult, type RouterEvalMatrixHarness, type RouterEvalMatrixPayload, type RouterEvalMatrixSandboxBox, type RouterEvalMatrixSandboxClient, type RouterEvalMatrixScenario, type RouterEvalMatrixSuiteResponse, type RouterImportedRunResponse, type RouterSearchConfig, type RouterSearchConfigOptions, type RunTangleRouterEvalMatrixInSandboxOptions, type RunTangleRouterEvalMatrixInSandboxResult, SANDBOX_MCP_SERVER_NAME, SANDBOX_SIZE_PRESETS, SANDBOX_SIZE_PRESET_NAMES, type SSHCommandDescriptor, type SSHCredentials, Sandbox, type SandboxConfig, type SandboxConnection, type SandboxEnvironment, SandboxError, type SandboxErrorJson, type SandboxEvent, type SandboxFailureDetail, SandboxFleet, type SandboxFleetArtifact, type SandboxFleetArtifactSpec, SandboxFleetClient, type SandboxFleetCostEstimate, type SandboxFleetDispatchFailureClass, type SandboxFleetDispatchResponse, type SandboxFleetDriverCapability, type SandboxFleetDriverTimings, type SandboxFleetInfo, type SandboxFleetIntelligenceEnvelope, type SandboxFleetMachine, type SandboxFleetMachineMeteredUsage, type SandboxFleetMachineRecord, type SandboxFleetMachineSpec, type SandboxFleetManifest, type SandboxFleetManifestMachine, type SandboxFleetOperationsSummary, type SandboxFleetPolicy, type SandboxFleetToken, type SandboxFleetTraceBundle, type SandboxFleetTraceEvent, type SandboxFleetTraceExport, type SandboxFleetTraceOptions, type SandboxFleetUsage, type SandboxFleetWorkspace, type SandboxFleetWorkspaceReconcileResult, type SandboxFleetWorkspaceRestoreResult, type SandboxFleetWorkspaceSnapshotResult, type SandboxIdentity, type SandboxInfo, SandboxInstance, type SandboxIntelligenceEnvelope, type SandboxInteractionCommandResult, type SandboxInteractionConflict, type SandboxInteractionResolution, type SandboxInteractionResult, type SandboxMcpConfig, type SandboxMcpEndpoint, type SandboxMcpServerEntry, type SandboxPortBinding, type SandboxPortPreviewLink, type SandboxResourceUsage, type SandboxResources, type SandboxRuntimeCapabilities, type SandboxRuntimeHealth, SandboxSession, type SandboxSizePreset, type SandboxStatus, SandboxTaskSession, type SandboxTerminalAttachOptions, type SandboxTerminalCreateOptions, type SandboxTerminalInfo, type SandboxTerminalManager, type SandboxTerminalRequestOptions, type SandboxTerminals, type SandboxTraceBundle, type SandboxTraceEvent, type SandboxTraceExport, type SandboxTraceOptions, type SandboxUser, type SaveCollaborationSnapshotRequest, type SaveCollaborationSnapshotResponse, type ScopedToken, type ScopedTokenScope, type SearchMatch, type SearchOptions, type SecretInfo, type SecretsManager, type SendSessionMessageOptions, type SendSessionMessageRequest, type SentSessionMessage, ServerError, type SessionBackendCredentials, type SessionBroadcastEvent, type SessionBroadcastResult, type SessionEventStreamOptions, type SessionFailureReason, type SessionForkOptions, type SessionInfo, type SessionInterruptOptions, type SessionListOptions, type SessionMessage, type SessionMessageInputPart, type SessionResultOptions, type SessionStatus, type SnapshotInfo, type SnapshotOptions, type SnapshotResult, type SplitInlineProfileFileMountsResult, type SplitInlineProfileSkillsResult, type StartInteractiveOptions, type StartupDiagnostics, type StartupOperation, StateError, type StorageConfig, type SubscriptionInfo, TERMINAL_WS_ECHO_SUBPROTOCOL, TangleSandboxClient, type TangleSandboxClientConfig, type TangleSearchProvider, type TaskSessionChanges, type TaskSessionCommitResult, type TaskSessionFileChange, type TaskSessionInfo, type TaskSessionProfile, type Team, type TeamInvitation, type TeamMember, type TeeAttestationHeartbeat, type TeeAttestationHeartbeatOptions, type TeeAttestationHeartbeatSample, type TeeAttestationOptions, type TeeAttestationReport, type TeeAttestationResponse, type TeePublicKey, type TeePublicKeyResponse, type TerminalExitInfo, type TerminalReadyInfo, TerminalStream, type TerminalStreamAuthFormat, TerminalStreamError, type TerminalStreamHandlers, type TerminalStreamOptions, type TerminalStreamToken, TimeoutError, type TokenRefreshHandler, type TokenUsage, type TraceExportFormat, type TraceExportResult, type TraceExportSink, type TurnDriveResult, type UpdateUserOptions, type UploadOptions, type UploadProgress, type UsageInfo, ValidationError, type WaitForOptions, type WaitForRolloutOptions, type WorkspaceImagePublishInput, type WorkspaceImagePublishRequestOptions, type WorkspaceImagePublishResult, WorkspaceImages, type WriteFileOptions, type WriteManyFile, type WriteManyOptions, applySandboxEventText, buildCollaborationDocumentId, buildControlPlaneMcpConfig, buildSandboxMcpConfig, buildTangleRouterEvalMatrixRequest, buildTangleRouterResponsesWebSearchRequest, buildTangleRouterSearchBackend, buildTangleRouterSearchProfile, buildTraceExportPayload, collectAgentFinalMessageText, collectAgentResponseText, createBatchResultAccumulator, createConfidentialSandbox, createManageSandboxesTool, exportTraceBundle, fetchTangleRouterSearchConfig, generateAttestationNonce, generateDockerfile, getSandboxEventText, isToolBearingEvent, manageSandboxesInputSchema, materializeProfileFileMounts, normalizeCollaborationPath, normalizeRuntimeBackendConfig, otelTraceIdForTangleTrace, parseBackendType, parseCollaborationDocumentId, parseSSEStream, resolveSandboxResources, runTangleRouterEvalMatrixInSandbox, sandboxResourcesForSize, splitInlineProfileFileMounts, splitInlineProfileSkills, startTeeAttestationHeartbeat, toOtelJson, validateBatchRunRequest, validateDeferredProfileFileMounts };
4428
+ export { type AcceleratorKind, type AccessPolicyRule, type AddUserOptions, type AgentProfile, type AgentProfileCapabilities, type AgentProfileConnection, type AgentProfileFileMount, type AgentProfileMcpServer, type AgentProfileModelHints, type AgentProfilePermissionValue, type AgentProfilePrompt, type AgentProfileResourceRef, type AgentProfileResources, type AgentProfileSecurityPolicy, type AgentProfileValidationIssue, type AgentProfileValidationResult, type AgentRunCancellationAcknowledgement, type AgentRunCancellationRequest, type AgentSubagentProfile, type AnyTokenPayload, type AttachGpuLeaseOptions, type AttachSandboxFleetMachineOptions, AuthError, type BackendCapabilities, type BackendConfig, type BackendInfo, type BackendManager, type BackendStatus, type BackendType, type BatchBackend, type BatchBackendStats, type BatchEvent, type BatchEventDataMap, type BatchResult, type BatchResultAccumulator, type BatchRunOptions, type BatchRunRequest, type BatchSidecarGroup, type BatchTask, type BatchTaskResult, type BatchTaskUsage, type BranchOptions, type BuildControlPlaneMcpConfigOptions, type BuildProgressEvent, type BuildSandboxMcpConfigOptions, CONTROL_PLANE_MCP_SERVER_NAME, type Capability, CapabilityError, type ChunkedUploadOptions, type ChunkedUploadResult, type CollaborationAccess, type CollaborationBootstrapRequest, type CollaborationBootstrapResponse, CollaborationClient, type CollaborationClientConfig, type CollaborationDocumentAdapter, type CollaborationDocumentChange, type CollaborationDocumentRef, CollaborationFileBridge, type CollaborationFileBridgeOptions, type CollaborationFileEvent, type CollaborationPermissions, type CollaborationTokenPayload, type CollaborationTokenRefreshRequest, type CollaborationTokenRefreshResponse, type CollaborationTransportConfig, type CommitTaskSessionOptions, type CompletedTurnResult, type ConfidentialSandboxResult, type ConfidentialTeeType, type CreateConfidentialSandboxOptions, type CreateGpuLeaseOptions, type CreateIntelligenceReportOptions, type CreateRequestOptions, type CreateSandboxFleetOptions, type CreateSandboxFleetWithCoordinatorOptions, type CreateSandboxOptions, type CreateSessionOptions, type CreateTaskSessionOptions, type CreateTeamOptions, DEFAULT_SANDBOX_SIZE, type DeleteOptions, type DevServerInfo, type DirectoryPermission, type DispatchPromptOptions, type DispatchedSession, type DownloadOptions, type DownloadProgress, type DriveTurnOptions, type DriverConfig, type DriverInfo, type DriverType, type DurablePlan, type DurablePlanDecisionResult, type EffectiveBackend, type EffectiveBackendProfile, type EffectiveBackendSource, type EgressManager, type EgressPolicy, EgressProxyRecoveryError, type EnsureDevServerOptions, type EventStreamOptions, type ExactProcessSpawnOptions, type ExecOptions, type ExecResult, type FileInfo, type FileReadBatchOptions, type FileReadBatchResult, type FileReadError, type FileReadResult, type FileRenameResult, type FileSystem, type FileTreeFile, type FileTreeOptions, type FileTreeResult, type FileUsageOptions, type FileUsageResult, FileWriteConflictError, type FileWriteResult, type FleetDispatchCancelResult, type FleetDispatchResultBuffer, type FleetDispatchResultBufferOptions, type FleetDispatchStreamOptions, type FleetDriveTurnOutcome, type FleetDriveTurnRequest, type FleetExecDispatchOptions, type FleetMachineId, type FleetPromptDispatchOptions, type ForkAcknowledgement, type ForkCounts, type ForkIdempotency, type ForkLookupOptions, GPU_LEASE_PROVIDER_NAMES, type GitAuth, type GitBranch, type GitCommit, type GitConfig, type GitDiff, type GitStatus, type GpuLease, type GpuLeaseBilling, type GpuLeaseCommandResult, type GpuLeaseExecOptions, type GpuLeaseExecResult, type GpuLeaseManager, type GpuLeaseProviderName, type GpuLeaseStatus, type HostAgentDriverConfig, type HostAgentRuntimeBackend, Image, type ImageBuildClient, type ImageBuildClientConfig, type ImageBuildFetchClient, type ImageBuildOptions, type ImageBuildResult, ImageBuilder, type ImageSpec, type InstalledTool, IntelligenceClient, type IntelligenceReport, type IntelligenceReportBudget, type IntelligenceReportCompareTo, type IntelligenceReportSubjectType, type IntelligenceReportWindow, type InteractiveAttachOptions, type InteractiveAuthFile, InteractiveSessionHandle, type InteractiveSessionHost, type InteractiveSessionInfo, type InteractiveSessionStatus, type InterruptResult, type InviteTeamMemberOptions, type IssueCollaborationTokenOptions, type ListMessagesOptions, type ListOptions, type ListSandboxFleetOptions, type ListSandboxOptions, MANAGE_SANDBOXES_PARAMETERS, MANAGE_SANDBOXES_TOOL_NAME, type ManageSandboxesInput, type ManageSandboxesTool, type ManageSandboxesToolOptions, type MaterializeProfileFileMountsOptions, type MaterializeProfileFileMountsResult, type McpServerConfig, type MintScopedTokenOptions, type MkdirOptions, type NetworkConfig, NetworkError, type NetworkManager, type NonHostAgentDriverConfig, NotFoundError, type ParseSSEStreamOptions, type ParsedSSEEvent, PartialFailureError, type PermissionLevel, type PermissionsManager, type PreviewLinkInfo, type PreviewLinkManager, type PreviewLinkWaitOptions, type Process, type ProcessInfo, type ProcessListOptions, type ProcessLogEntry, type ProcessManager, type ProcessSignal, type ProcessSpawnOptions, type ProcessStatus, type PromptInputPart, type PromptOptions, type PromptResult, type ProvisionEvent, type ProvisionResult, type ProvisionStatus, type ProvisionStep, type PublicTemplateInfo, type PublicTemplateVersionInfo, type PublishPublicTemplateOptions, type PublishPublicTemplateVersionOptions, QuotaError, type ReapExpiredSandboxFleetsOptions, type ReapExpiredSandboxFleetsResult, type ReconcileSandboxFleetsOptions, type ReconcileSandboxFleetsResult, type RenameOptions, type RespondToPermissionOptions, type Rollout, type RolloutChildResult, type RolloutOptions, type RolloutScorer, type RolloutStartResult, type RolloutStatus, type RolloutTurnPart, type RouterEvalMatrixAgentProfile, type RouterEvalMatrixCaseResult, type RouterEvalMatrixHarness, type RouterEvalMatrixPayload, type RouterEvalMatrixSandboxBox, type RouterEvalMatrixSandboxClient, type RouterEvalMatrixScenario, type RouterEvalMatrixSuiteResponse, type RouterImportedRunResponse, type RouterSearchConfig, type RouterSearchConfigOptions, type RunTangleRouterEvalMatrixInSandboxOptions, type RunTangleRouterEvalMatrixInSandboxResult, SANDBOX_MCP_SERVER_NAME, SANDBOX_SIZE_PRESETS, SANDBOX_SIZE_PRESET_NAMES, type SSHCommandDescriptor, type SSHCredentials, Sandbox, type SandboxConfig, type SandboxConnection, type SandboxCreateOutcome, type SandboxCreateReceipt, type SandboxDeleteAcknowledgement, type SandboxDeleteOutcome, type SandboxEnvironment, SandboxError, type SandboxErrorJson, type SandboxEvent, type SandboxFailureDetail, SandboxFleet, type SandboxFleetArtifact, type SandboxFleetArtifactSpec, SandboxFleetClient, type SandboxFleetCostEstimate, type SandboxFleetDispatchFailureClass, type SandboxFleetDispatchResponse, type SandboxFleetDriverCapability, type SandboxFleetDriverTimings, type SandboxFleetInfo, type SandboxFleetIntelligenceEnvelope, type SandboxFleetMachine, type SandboxFleetMachineMeteredUsage, type SandboxFleetMachineRecord, type SandboxFleetMachineSpec, type SandboxFleetManifest, type SandboxFleetManifestMachine, type SandboxFleetOperationsSummary, type SandboxFleetPolicy, type SandboxFleetToken, type SandboxFleetTraceBundle, type SandboxFleetTraceEvent, type SandboxFleetTraceExport, type SandboxFleetTraceOptions, type SandboxFleetUsage, type SandboxFleetWorkspace, type SandboxFleetWorkspaceReconcileResult, type SandboxFleetWorkspaceRestoreResult, type SandboxFleetWorkspaceSnapshotResult, type SandboxIdentity, type SandboxInfo, SandboxInstance, type SandboxIntelligenceEnvelope, type SandboxInteractionCommandResult, type SandboxInteractionConflict, type SandboxInteractionResolution, type SandboxInteractionResult, type SandboxMcpConfig, type SandboxMcpEndpoint, type SandboxMcpServerEntry, type SandboxPortBinding, type SandboxPortPreviewLink, type SandboxResourceUsage, type SandboxResources, type SandboxRuntimeCapabilities, type SandboxRuntimeHealth, SandboxSession, type SandboxSizePreset, type SandboxStatus, SandboxTaskSession, type SandboxTerminalAttachOptions, type SandboxTerminalCreateOptions, type SandboxTerminalInfo, type SandboxTerminalManager, type SandboxTerminalRequestOptions, type SandboxTerminals, type SandboxTraceBundle, type SandboxTraceEvent, type SandboxTraceExport, type SandboxTraceOptions, type SandboxUser, type SaveCollaborationSnapshotRequest, type SaveCollaborationSnapshotResponse, type ScopedToken, type ScopedTokenScope, type SearchMatch, type SearchOptions, type SecretInfo, type SecretsManager, type SendSessionMessageOptions, type SendSessionMessageRequest, type SentSessionMessage, ServerError, type SessionBackendCredentials, type SessionBroadcastEvent, type SessionBroadcastResult, type SessionEventStreamOptions, type SessionFailureReason, type SessionForkOptions, type SessionInfo, type SessionInterruptOptions, type SessionListOptions, type SessionMessage, type SessionMessageInputPart, type SessionResultOptions, type SessionStatus, type SnapshotDeleteAcknowledgement, type SnapshotDeleteOutcome, type SnapshotIdempotency, type SnapshotInfo, type SnapshotOptions, type SnapshotResult, type SplitInlineProfileFileMountsResult, type SplitInlineProfileSkillsResult, type StartInteractiveOptions, type StartupDiagnostics, type StartupOperation, StateError, type StorageConfig, type SubscriptionInfo, TERMINAL_WS_ECHO_SUBPROTOCOL, TangleSandboxClient, type TangleSandboxClientConfig, type TangleSearchProvider, type TaskSessionChanges, type TaskSessionCommitResult, type TaskSessionFileChange, type TaskSessionInfo, type TaskSessionProfile, type Team, type TeamInvitation, type TeamMember, type TeeAttestationHeartbeat, type TeeAttestationHeartbeatOptions, type TeeAttestationHeartbeatSample, type TeeAttestationOptions, type TeeAttestationReport, type TeeAttestationResponse, type TeePublicKey, type TeePublicKeyResponse, type TerminalExitInfo, type TerminalReadyInfo, TerminalStream, type TerminalStreamAuthFormat, TerminalStreamError, type TerminalStreamHandlers, type TerminalStreamOptions, type TerminalStreamToken, TimeoutError, type TokenRefreshHandler, type TokenUsage, type TraceExportFormat, type TraceExportResult, type TraceExportSink, type TurnDriveResult, type UpdateUserOptions, type UploadOptions, type UploadProgress, type UsageInfo, ValidationError, type WaitForOptions, type WaitForRolloutOptions, type WorkspaceImagePublishInput, type WorkspaceImagePublishRequestOptions, type WorkspaceImagePublishResult, WorkspaceImages, type WorkspaceOperationLookup, type WriteFileOptions, type WriteManyFile, type WriteManyOptions, applySandboxEventText, buildCollaborationDocumentId, buildControlPlaneMcpConfig, buildSandboxMcpConfig, buildTangleRouterEvalMatrixRequest, buildTangleRouterResponsesWebSearchRequest, buildTangleRouterSearchBackend, buildTangleRouterSearchProfile, buildTraceExportPayload, collectAgentFinalMessageText, collectAgentResponseText, createBatchResultAccumulator, createConfidentialSandbox, createManageSandboxesTool, exportTraceBundle, fetchTangleRouterSearchConfig, generateAttestationNonce, generateDockerfile, getSandboxEventText, isToolBearingEvent, manageSandboxesInputSchema, materializeProfileFileMounts, normalizeCollaborationPath, normalizeRuntimeBackendConfig, otelTraceIdForTangleTrace, parseBackendType, parseCollaborationDocumentId, parseSSEStream, resolveSandboxResources, runTangleRouterEvalMatrixInSandbox, sandboxResourcesForSize, splitInlineProfileFileMounts, splitInlineProfileSkills, startTeeAttestationHeartbeat, toOtelJson, validateBatchRunRequest, validateDeferredProfileFileMounts };
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
- import { h as parseBackendType, m as backendTypeSchema, p as normalizeRuntimeBackendConfig } from "./runtime-api-Co-Ow_VR.js";
2
- import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, r as EgressProxyRecoveryError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-D2aWy99l.js";
3
- import { a as splitInlineProfileSkills, c as SandboxFleetClient, i as splitInlineProfileFileMounts, l as createBatchResultAccumulator, n as Sandbox, o as validateDeferredProfileFileMounts, r as materializeProfileFileMounts, s as SandboxFleet, t as IntelligenceClient, u as validateBatchRunRequest } from "./client-ClR-isrv.js";
4
- import { _ as buildTraceExportPayload, a as TERMINAL_WS_ECHO_SUBPROTOCOL, b as toOtelJson, c as SandboxTaskSession, d as applySandboxEventText, f as collectAgentFinalMessageText, h as isToolBearingEvent, i as WorkspaceImages, l as SandboxSession, m as getSandboxEventText, o as TerminalStream, p as collectAgentResponseText, s as TerminalStreamError, t as SandboxInstance, u as InteractiveSessionHandle, v as exportTraceBundle, x as parseSSEStream, y as otelTraceIdForTangleTrace } from "./sandbox-CEOxB8dH.js";
5
- import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "./collaboration-CqPA0kar.js";
6
- import { t as TangleSandboxClient } from "./tangle-BDdxSi54.js";
1
+ import { h as parseBackendType, m as backendTypeSchema, p as normalizeRuntimeBackendConfig } from "./runtime-api-CK-4S7oA.js";
2
+ import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, r as EgressProxyRecoveryError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
3
+ import { a as splitInlineProfileSkills, c as SandboxFleetClient, i as splitInlineProfileFileMounts, l as createBatchResultAccumulator, n as Sandbox, o as validateDeferredProfileFileMounts, r as materializeProfileFileMounts, s as SandboxFleet, t as IntelligenceClient, u as validateBatchRunRequest } from "./client-CMjk9V9B.js";
4
+ import { S as parseSSEStream, a as WorkspaceImages, b as otelTraceIdForTangleTrace, c as TerminalStreamError, d as InteractiveSessionHandle, f as applySandboxEventText, g as isToolBearingEvent, h as getSandboxEventText, l as SandboxTaskSession, m as collectAgentResponseText, o as TERMINAL_WS_ECHO_SUBPROTOCOL, p as collectAgentFinalMessageText, s as TerminalStream, t as SandboxInstance, u as SandboxSession, v as buildTraceExportPayload, x as toOtelJson, y as exportTraceBundle } from "./sandbox-NvbxFwTv.js";
5
+ import { a as CollaborationClient, i as parseCollaborationDocumentId, n as buildCollaborationDocumentId, r as normalizeCollaborationPath, t as CollaborationFileBridge } from "./collaboration-COCXdRrk.js";
6
+ import { t as TangleSandboxClient } from "./tangle-DfKDt5Nz.js";
7
7
  import { SANDBOX_SIZE_PRESET_NAMES, agentProfileConfidentialSchema, agentProfileSchema } from "@tangle-network/agent-interface";
8
8
  import { z } from "zod";
9
9
  //#region src/confidential.ts
@@ -1,4 +1,4 @@
1
- import { a as NetworkError, f as TimeoutError, m as parseErrorResponse } from "../errors-D2aWy99l.js";
1
+ import { a as NetworkError, f as TimeoutError, m as parseErrorResponse } from "../errors-C6kn-3zt.js";
2
2
  //#region src/intelligence/index.ts
3
3
  /**
4
4
  * `@tangle-network/sandbox/intelligence` — browser-safe typed client for the
@@ -1,4 +1,4 @@
1
- import { a as NetworkError, c as QuotaError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, n as CapabilityError, p as ValidationError, u as ServerError } from "./errors-D2aWy99l.js";
1
+ import { a as NetworkError, c as QuotaError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, n as CapabilityError, p as ValidationError, u as ServerError } from "./errors-C6kn-3zt.js";
2
2
  import { AgentExactRunControlRefSchema, agentProfileSchema, harnessTypeSchema } from "@tangle-network/agent-interface";
3
3
  import { z } from "zod";
4
4
  //#region ../../../packages/runtime-contracts/dist/backend-types.js
package/dist/runtime.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { $r as SendSessionMessageRequest, Ci as TaskSessionInfo, Fi as UploadProgress, In as RenameOptions, Ir as SandboxTerminalCreateOptions, Lr as SandboxTerminalInfo, N as CreateSessionOptions, Nr as SandboxRuntimeHealth, Or as SandboxPortBinding, P as CreateTaskSessionOptions, Qr as SendSessionMessageOptions, Qt as ListMessagesOptions, Rr as SandboxTerminalManager, ai as SessionInfo, at as FileReadBatchOptions, bi as TaskSessionChanges, ci as SessionMessage, ei as SentSessionMessage, ft as FileTreeOptions, gt as FileWriteResult, ht as FileUsageResult, lt as FileRenameResult, mt as FileUsageOptions, ot as FileReadBatchResult, pt as FileTreeResult, v as ChunkedUploadOptions, w as CommitTaskSessionOptions, xi as TaskSessionCommitResult, y as ChunkedUploadResult, zi as WriteFileOptions, zr as SandboxTerminalRequestOptions } from "./types-CxkpqFzN.js";
1
+ import { Ai as TaskSessionChanges, Br as SandboxRuntimeHealth, Fr as SandboxPortBinding, Gi as UploadProgress, Gr as SandboxTerminalManager, Kr as SandboxTerminalRequestOptions, N as CreateSessionOptions, Ni as TaskSessionInfo, P as CreateTaskSessionOptions, Ur as SandboxTerminalCreateOptions, Wr as SandboxTerminalInfo, Xi as WriteFileOptions, ai as SendSessionMessageOptions, at as FileReadBatchOptions, fi as SessionInfo, ft as FileTreeOptions, gt as FileWriteResult, hi as SessionMessage, ht as FileUsageResult, ji as TaskSessionCommitResult, lt as FileRenameResult, mt as FileUsageOptions, oi as SendSessionMessageRequest, ot as FileReadBatchResult, pt as FileTreeResult, si as SentSessionMessage, tn as ListMessagesOptions, v as ChunkedUploadOptions, w as CommitTaskSessionOptions, y as ChunkedUploadResult, zn as RenameOptions } from "./types-DL7FzacJ.js";
2
2
  import { a as NetworkError, c as QuotaError, d as SandboxFailureDetail, f as ServerError, h as ValidationError, i as FileWriteConflictError, l as SandboxError, m as TimeoutError, n as CapabilityError, o as NotFoundError, p as StateError, s as PartialFailureError, t as AuthError, u as SandboxErrorJson } from "./errors-Bdy5jXzc.js";
3
3
 
4
4
  //#region src/lib/chunked-upload.d.ts
package/dist/runtime.js CHANGED
@@ -1,5 +1,5 @@
1
- import { a as uploadChunked, c as combineAbortSignals, t as SandboxRuntimeApi } from "./runtime-api-Co-Ow_VR.js";
2
- import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-D2aWy99l.js";
1
+ import { a as uploadChunked, c as combineAbortSignals, t as SandboxRuntimeApi } from "./runtime-api-CK-4S7oA.js";
2
+ import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, i as FileWriteConflictError, l as SandboxError, n as CapabilityError, o as NotFoundError, p as ValidationError, s as PartialFailureError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
3
3
  //#region src/runtime-client.ts
4
4
  const DEFAULT_RUNTIME_TIMEOUT_MS = 3e4;
5
5
  function requireToken(token) {
@@ -1,4 +1,4 @@
1
- import { $r as SendSessionMessageRequest, Ar as SandboxResourceUsage, At as GitBranch, Bi as WriteManyFile, Br as SandboxTerminals, Bt as GpuLeaseManager, Ci as TaskSessionInfo, Cn as PromptResult, Di as TeeAttestationResponse, Er as SandboxInfo, Fr as SandboxTerminalAttachOptions, Ft as GpuLease, Gi as TerminalStream, Gt as InstalledTool, H as DriveTurnOptions, Ji as TerminalStreamHandlers, Jr as SearchMatch, Jt as IntelligenceReportCompareTo, K as DurablePlan, Kn as SSHCommandDescriptor, Kr as ScopedToken, Kt as IntelligenceReport, Li as WaitForOptions, Ln as RestoreSnapshotOptions, Mi as TurnDriveResult, Mr as SandboxRuntimeCapabilities, N as CreateSessionOptions, Nr as SandboxRuntimeHealth, Nt as GitDiff, Or as SandboxPortBinding, P as CreateTaskSessionOptions, Pr as SandboxStatus, Pt as GitStatus, Qr as SendSessionMessageOptions, Qt as ListMessagesOptions, R as DispatchPromptOptions, Ri as WaitForRolloutOptions, Rn as ResumeOptions, S as CodeLanguage, Sn as PromptOptions, T as CompletedTurnResult, Ti as TeeAttestationOptions, Tn as ProvisionResult, Un as RolloutStartResult, Vi as WriteManyOptions, Vn as RolloutOptions, Vr as SandboxTraceBundle, W as DriverInfo, Wr as SandboxTraceOptions, Xt as IntelligenceReportWindow, Yn as SandboxConnection, Yr as SearchOptions, Z as EgressManager, Zn as SandboxEvent, Zt as JsonValue, _ as BranchOptions, _n as ProcessManager, ai as SessionInfo, b as CodeExecutionOptions, bi as TaskSessionChanges, ci as SessionMessage, dn as PreviewLinkManager, ei as SentSessionMessage, et as EventStreamOptions, fi as SnapshotInfo, gi as StartupDiagnostics, gr as SandboxFleetTraceBundle, gt as FileWriteResult, ii as SessionForkOptions, jt as GitCommit, ki as TeePublicKeyResponse, l as BackendManager, ln as PermissionsManager, mi as SnapshotResult, ni as SessionEventStreamOptions, nt as ExecOptions, oi as SessionInterruptOptions, on as NetworkManager, pi as SnapshotOptions, q as DurablePlanDecisionResult, qn as SSHCredentials, qt as IntelligenceReportBudget, ra as BackendType, rn as MintScopedTokenOptions, rt as ExecResult, s as BackendConfig, si as SessionListOptions, ui as SessionResultOptions, ut as FileSystem, w as CommitTaskSessionOptions, wn as ProvisionEvent, x as CodeExecutionResult, xi as TaskSessionCommitResult, xn as PromptInputPart, z as DispatchedSession, zi as WriteFileOptions, zn as Rollout } from "./types-CxkpqFzN.js";
1
+ import { $r as ScopedToken, $t as IntelligenceReportWindow, Ai as TaskSessionChanges, At as ForkLookupOptions, Bn as RestoreSnapshotOptions, Br as SandboxRuntimeHealth, Ci as SnapshotOptions, Cr as SandboxFleetTraceBundle, Dn as ProvisionEvent, Ei as StartupDiagnostics, En as PromptResult, Fi as TeeAttestationOptions, Fr as SandboxPortBinding, H as DriveTurnOptions, Hi as TurnDriveResult, Hn as Rollout, Hr as SandboxTerminalAttachOptions, It as GitDiff, Ji as WaitForRolloutOptions, Jr as SandboxTraceBundle, Jt as InstalledTool, K as DurablePlan, Kn as RolloutStartResult, Li as TeeAttestationResponse, Lr as SandboxResourceUsage, Lt as GitStatus, N as CreateSessionOptions, Ni as TaskSessionInfo, Nr as SandboxInfo, Nt as GitBranch, On as ProvisionResult, Ot as ForkCounts, P as CreateTaskSessionOptions, Pt as GitCommit, Qi as WriteManyOptions, Qn as SandboxConnection, R as DispatchPromptOptions, Rt as GpuLease, S as CodeLanguage, Si as SnapshotInfo, T as CompletedTurnResult, Tn as PromptOptions, Ut as GpuLeaseManager, Vn as ResumeOptions, Vr as SandboxStatus, W as DriverInfo, Wn as RolloutOptions, Xi as WriteFileOptions, Xn as SSHCredentials, Xt as IntelligenceReportBudget, Yi as WorkspaceOperationLookup, Yn as SSHCommandDescriptor, Yt as IntelligenceReport, Z as EgressManager, Zi as WriteManyFile, Zr as SandboxTraceOptions, Zt as IntelligenceReportCompareTo, _ as BranchOptions, _i as SessionResultOptions, aa as TerminalStreamHandlers, ai as SendSessionMessageOptions, b as CodeExecutionOptions, bn as ProcessManager, di as SessionForkOptions, en as JsonValue, er as SandboxCreateReceipt, et as EventStreamOptions, fi as SessionInfo, fn as PermissionsManager, gt as FileWriteResult, hi as SessionMessage, ir as SandboxEvent, ji as TaskSessionCommitResult, kt as ForkIdempotency, l as BackendManager, li as SessionEventStreamOptions, ln as NetworkManager, ma as BackendType, mi as SessionListOptions, mn as PreviewLinkManager, na as TerminalStream, ni as SearchOptions, nt as ExecOptions, oi as SendSessionMessageRequest, on as MintScopedTokenOptions, pi as SessionInterruptOptions, q as DurablePlanDecisionResult, qi as WaitForOptions, qr as SandboxTerminals, rt as ExecResult, s as BackendConfig, si as SentSessionMessage, ti as SearchMatch, tn as ListMessagesOptions, tr as SandboxDeleteAcknowledgement, ut as FileSystem, w as CommitTaskSessionOptions, wi as SnapshotResult, wn as PromptInputPart, x as CodeExecutionResult, yi as SnapshotDeleteAcknowledgement, z as DispatchedSession, zi as TeePublicKeyResponse, zr as SandboxRuntimeCapabilities } from "./types-DL7FzacJ.js";
2
2
  import { AgentProfile, AgentRunCancellationAcknowledgement, AgentRunCancellationRequest, InteractionAcknowledgement, InteractionData, InteractionRequest, InteractionResponseCommand } from "@tangle-network/agent-interface";
3
3
  import { z } from "zod";
4
4
 
@@ -658,6 +658,19 @@ interface ToolsCapability {
658
658
  /** Run a command with a specific tool */
659
659
  run(tool: string, args: string[]): Promise<ExecResult>;
660
660
  }
661
+ /**
662
+ * One fork of a running sandbox, reported with its fan-out accounting.
663
+ *
664
+ * `children` holds the sandboxes that exist. A partial fan-out is never
665
+ * reported as a whole one: `complete` is false whenever `materializedCount` is
666
+ * below `requestedCount`, and the caller decides what to do about the
667
+ * shortfall.
668
+ */
669
+ interface ForkAcknowledgement extends ForkCounts {
670
+ children: SandboxInstance[];
671
+ /** Present only for a keyed fork against an API that reports it. */
672
+ idempotency?: ForkIdempotency;
673
+ }
661
674
  /**
662
675
  * A sandbox instance with methods for interaction.
663
676
  */
@@ -728,6 +741,23 @@ declare class SandboxInstance {
728
741
  * ```
729
742
  */
730
743
  startupDiagnostics(): StartupDiagnostics | null;
744
+ /**
745
+ * The platform verdict for the create call that returned this sandbox: did
746
+ * the call allocate the environment, or did it replay an earlier create that
747
+ * carried the same idempotency key.
748
+ *
749
+ * Present only on a freshly created box; `null` for a box resolved by id and
750
+ * `null` when the platform reported no receipt. Delete the environment only
751
+ * on a `created` outcome — every other value permits another caller to hold
752
+ * it, and a delete then destroys work that caller depends on.
753
+ *
754
+ * @example
755
+ * ```typescript
756
+ * const receipt = box.createReceipt();
757
+ * if (receipt?.outcome === "created") await box.delete();
758
+ * ```
759
+ */
760
+ createReceipt(): SandboxCreateReceipt | null;
731
761
  /**
732
762
  * Serialize to the public sandbox shape for logs and structured
733
763
  * output. Secrets in `connection` (currently `authToken`) are
@@ -1460,7 +1490,21 @@ declare class SandboxInstance {
1460
1490
  restorePaths(snapshotId: string, paths: string[]): Promise<SnapshotResult>;
1461
1491
  private waitForSnapshotRestore;
1462
1492
  private waitForSnapshotVisible;
1463
- deleteSnapshot(snapshotId: string): Promise<void>;
1493
+ /**
1494
+ * Delete a snapshot.
1495
+ *
1496
+ * Deleting a snapshot that is already gone succeeds and reports
1497
+ * `already_absent`, so a retry after an uncertain failure does not raise. A
1498
+ * 404 means this sandbox is unknown, not that the snapshot was missing.
1499
+ */
1500
+ deleteSnapshot(snapshotId: string): Promise<SnapshotDeleteAcknowledgement>;
1501
+ /**
1502
+ * Ask whether the snapshot bound to an idempotency key is decided.
1503
+ *
1504
+ * Pass the same options the create carried: the service derives the request
1505
+ * digest from them, so a caller never reproduces its canonical form.
1506
+ */
1507
+ getSnapshotOperation(idempotencyKey: string, options?: Pick<SnapshotOptions, "tags">): Promise<WorkspaceOperationLookup>;
1464
1508
  /**
1465
1509
  * Restore from the latest snapshot in customer-provided storage.
1466
1510
  * Only available when using BYOS3 (calls the runtime directly).
@@ -1492,9 +1536,13 @@ declare class SandboxInstance {
1492
1536
  * parent's clean pages instead of each copying full guest memory. The parent
1493
1537
  * stays running.
1494
1538
  *
1539
+ * Returns only the children. A fan-out that materialized fewer than `count`
1540
+ * still resolves — the children are real — so compare the array length, or
1541
+ * call {@link fork} for the explicit `complete` flag.
1542
+ *
1495
1543
  * @param count - Number of children to create (must be >= 1).
1496
1544
  * @param options - Per-child overrides.
1497
- * @returns Exactly `count` new sandbox instances.
1545
+ * @returns The new sandbox instances that materialized.
1498
1546
  *
1499
1547
  * @example
1500
1548
  * ```typescript
@@ -1503,6 +1551,30 @@ declare class SandboxInstance {
1503
1551
  * ```
1504
1552
  */
1505
1553
  branch(count: number, options?: BranchOptions): Promise<SandboxInstance[]>;
1554
+ /**
1555
+ * Branch this RUNNING sandbox and report the fan-out, not only the children.
1556
+ *
1557
+ * `complete` is false when fewer children materialized than were requested,
1558
+ * so a partial fan-out is never read as a whole one. With an
1559
+ * `idempotencyKey`, a retry of the same key and options returns exactly the
1560
+ * children the first request materialized and creates none.
1561
+ *
1562
+ * @example
1563
+ * ```typescript
1564
+ * const forked = await box.fork(5, { idempotencyKey: "run-42" });
1565
+ * if (!forked.complete) {
1566
+ * console.warn(`${forked.materializedCount} of ${forked.requestedCount}`);
1567
+ * }
1568
+ * ```
1569
+ */
1570
+ fork(count: number, options?: BranchOptions): Promise<ForkAcknowledgement>;
1571
+ /**
1572
+ * Ask whether the fork bound to an idempotency key is decided.
1573
+ *
1574
+ * Pass the same count and options the fork carried: the service derives the
1575
+ * request digest from them, so a caller never reproduces its canonical form.
1576
+ */
1577
+ getForkOperation(idempotencyKey: string, options: ForkLookupOptions): Promise<WorkspaceOperationLookup>;
1506
1578
  /**
1507
1579
  * Speculative rollouts: branch this RUNNING sandbox into `n` copy-on-write
1508
1580
  * children, run the SAME agent turn in every child in parallel, and
@@ -1556,7 +1628,10 @@ declare class SandboxInstance {
1556
1628
  */
1557
1629
  resume(options?: ResumeOptions): Promise<void>;
1558
1630
  /**
1559
- * Delete the sandbox permanently.
1631
+ * Delete the sandbox permanently. This is how a forked child is destroyed.
1632
+ *
1633
+ * `outcome` separates `destroyed` from `already_absent`, so a retry after an
1634
+ * uncertain failure reports what really happened instead of raising.
1560
1635
  *
1561
1636
  * The delete response carries the orchestrator's per-phase delete breakdown
1562
1637
  * (`container_remove` / `storage_binding_wait` / `cleanup_parallel` /
@@ -1564,7 +1639,7 @@ declare class SandboxInstance {
1564
1639
  * {@link startupDiagnostics} returns it for post-mortem reads on the
1565
1640
  * now-gone sandbox.
1566
1641
  */
1567
- delete(): Promise<void>;
1642
+ delete(): Promise<SandboxDeleteAcknowledgement>;
1568
1643
  /**
1569
1644
  * Read the per-phase lifecycle breakdown off a stop/resume/delete response
1570
1645
  * body. Never throws: diagnostics are measurement data — a body that fails
@@ -1654,6 +1729,17 @@ declare class SandboxInstance {
1654
1729
  success: boolean;
1655
1730
  sessionId: string;
1656
1731
  }>;
1732
+ /**
1733
+ * Parse a sandbox API payload into `SandboxInfo`.
1734
+ *
1735
+ * `carryCreateFacts` supplies the create-time facts a refresh must keep:
1736
+ * the GPU lease, the startup diagnostics, and the create receipt each arrive
1737
+ * once on the create response and are absent from every later payload. They
1738
+ * describe ONE environment's creation, so they travel only when the payload
1739
+ * describes that same environment. A payload for a different sandbox — a
1740
+ * branch child parsed through its parent — passes no carry, or the child
1741
+ * would report its parent's create verdict.
1742
+ */
1657
1743
  private parseInfo;
1658
1744
  private sleep;
1659
1745
  /**
@@ -1866,4 +1952,4 @@ declare class SandboxInstance {
1866
1952
  }): Promise<DurablePlanDecisionResult>;
1867
1953
  }
1868
1954
  //#endregion
1869
- export { BuildSandboxMcpConfigOptions as A, RespondToPermissionOptions as C, SandboxInteractionResolution as D, SandboxInteractionConflict as E, SandboxMcpServerEntry as F, buildControlPlaneMcpConfig as I, buildSandboxMcpConfig as L, SANDBOX_MCP_SERVER_NAME as M, SandboxMcpConfig as N, SandboxInteractionResult as O, SandboxMcpEndpoint as P, InterruptResult as S, SandboxInteractionCommandResult as T, InteractiveAuthFile as _, WorkspaceImagePublishResult as a, InteractiveSessionInfo as b, TraceExportResult as c, exportTraceBundle as d, otelTraceIdForTangleTrace as f, InteractiveAttachOptions as g, SandboxSession as h, WorkspaceImagePublishRequestOptions as i, CONTROL_PLANE_MCP_SERVER_NAME as j, BuildControlPlaneMcpConfigOptions as k, TraceExportSink as l, SandboxTaskSession as m, SandboxInstance as n, WorkspaceImages as o, toOtelJson as p, WorkspaceImagePublishInput as r, TraceExportFormat as s, HttpClient as t, buildTraceExportPayload as u, InteractiveSessionHandle as v, StartInteractiveOptions as w, InteractiveSessionStatus as x, InteractiveSessionHost as y };
1955
+ export { BuildControlPlaneMcpConfigOptions as A, InterruptResult as C, SandboxInteractionConflict as D, SandboxInteractionCommandResult as E, SandboxMcpEndpoint as F, SandboxMcpServerEntry as I, buildControlPlaneMcpConfig as L, CONTROL_PLANE_MCP_SERVER_NAME as M, SANDBOX_MCP_SERVER_NAME as N, SandboxInteractionResolution as O, SandboxMcpConfig as P, buildSandboxMcpConfig as R, InteractiveSessionStatus as S, StartInteractiveOptions as T, InteractiveAttachOptions as _, WorkspaceImagePublishRequestOptions as a, InteractiveSessionHost as b, TraceExportFormat as c, buildTraceExportPayload as d, exportTraceBundle as f, SandboxSession as g, SandboxTaskSession as h, WorkspaceImagePublishInput as i, BuildSandboxMcpConfigOptions as j, SandboxInteractionResult as k, TraceExportResult as l, toOtelJson as m, HttpClient as n, WorkspaceImagePublishResult as o, otelTraceIdForTangleTrace as p, SandboxInstance as r, WorkspaceImages as s, ForkAcknowledgement as t, TraceExportSink as u, InteractiveAuthFile as v, RespondToPermissionOptions as w, InteractiveSessionInfo as x, InteractiveSessionHandle as y };
@@ -1,5 +1,5 @@
1
- import { a as uploadChunked, c as combineAbortSignals, d as applyRequestedModel, f as assertCurrentBackendType, i as sessionHeaders, l as encodePromptForWire, n as normalizeSessionInfo, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as normalizeRuntimeBackendConfig, r as appendSessionIdQuery, t as SandboxRuntimeApi } from "./runtime-api-Co-Ow_VR.js";
2
- import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, n as CapabilityError, o as NotFoundError, p as ValidationError, t as AuthError, u as ServerError } from "./errors-D2aWy99l.js";
1
+ import { a as uploadChunked, c as combineAbortSignals, d as applyRequestedModel, f as assertCurrentBackendType, i as sessionHeaders, l as encodePromptForWire, n as normalizeSessionInfo, o as SANDBOX_PROXY_REQUEST_MAX_BYTES, p as normalizeRuntimeBackendConfig, r as appendSessionIdQuery, t as SandboxRuntimeApi } from "./runtime-api-CK-4S7oA.js";
2
+ import { a as NetworkError, c as QuotaError, d as StateError, f as TimeoutError, l as SandboxError, m as parseErrorResponse, n as CapabilityError, o as NotFoundError, p as ValidationError, t as AuthError, u as ServerError } from "./errors-C6kn-3zt.js";
3
3
  import { AgentExactRunControlRefSchema, AgentRunCancellationAcknowledgementSchema, AgentRunCancellationRequestSchema, InteractionAcknowledgementSchema, InteractionBindingSchema, InteractionRequestSchema, InteractionResponseCommandSchema, InteractionResponseSchema, agentRunCancellationAcknowledgementMatchesRequest, canonicalCandidateDigest, sha256DigestSchema } from "@tangle-network/agent-interface";
4
4
  import { z } from "zod";
5
5
  import { readTokenCostUsd, readTokenUsage } from "@tangle-network/agent-core";
@@ -1744,6 +1744,7 @@ function normalizeStartupDiagnostics(raw) {
1744
1744
  service: typeof record.service === "string" ? record.service : void 0,
1745
1745
  status: typeof record.status === "string" ? record.status : void 0,
1746
1746
  durationMs,
1747
+ parent: typeof record.parent === "string" ? record.parent : void 0,
1747
1748
  metadata: record.metadata && typeof record.metadata === "object" ? record.metadata : void 0
1748
1749
  });
1749
1750
  if (durationMs !== void 0) phases[operation] = durationMs;
@@ -1754,6 +1755,30 @@ function normalizeStartupDiagnostics(raw) {
1754
1755
  phases
1755
1756
  };
1756
1757
  }
1758
+ const SANDBOX_CREATE_OUTCOMES = [
1759
+ "created",
1760
+ "idempotent_replay",
1761
+ "unknown"
1762
+ ];
1763
+ /**
1764
+ * Normalize the raw `createReceipt` field from a sandbox API response into a
1765
+ * {@link SandboxCreateReceipt}. Returns `null` when the payload is absent or
1766
+ * carries no boolean `idempotencyKeyApplied` — the platform emits the receipt
1767
+ * only on the create response, so most reads have no payload to normalize.
1768
+ *
1769
+ * An outcome this SDK version does not know becomes `unknown`: only a known
1770
+ * `created` proves that the call allocated the environment.
1771
+ */
1772
+ function normalizeSandboxCreateReceipt(raw) {
1773
+ if (!raw || typeof raw !== "object") return null;
1774
+ const record = raw;
1775
+ const idempotencyKeyApplied = record.idempotencyKeyApplied;
1776
+ if (typeof idempotencyKeyApplied !== "boolean") return null;
1777
+ return {
1778
+ outcome: SANDBOX_CREATE_OUTCOMES.includes(record.outcome) ? record.outcome : "unknown",
1779
+ idempotencyKeyApplied
1780
+ };
1781
+ }
1757
1782
  /**
1758
1783
  * Replace bearer-secret fields on a `SandboxConnection` with a sentinel
1759
1784
  * before serialization. The serialized shape is preserved (so external
@@ -2249,6 +2274,25 @@ var SandboxInstance = class SandboxInstance {
2249
2274
  return this.info.startupDiagnostics ?? null;
2250
2275
  }
2251
2276
  /**
2277
+ * The platform verdict for the create call that returned this sandbox: did
2278
+ * the call allocate the environment, or did it replay an earlier create that
2279
+ * carried the same idempotency key.
2280
+ *
2281
+ * Present only on a freshly created box; `null` for a box resolved by id and
2282
+ * `null` when the platform reported no receipt. Delete the environment only
2283
+ * on a `created` outcome — every other value permits another caller to hold
2284
+ * it, and a delete then destroys work that caller depends on.
2285
+ *
2286
+ * @example
2287
+ * ```typescript
2288
+ * const receipt = box.createReceipt();
2289
+ * if (receipt?.outcome === "created") await box.delete();
2290
+ * ```
2291
+ */
2292
+ createReceipt() {
2293
+ return this.info.createReceipt ?? null;
2294
+ }
2295
+ /**
2252
2296
  * Serialize to the public sandbox shape for logs and structured
2253
2297
  * output. Secrets in `connection` (currently `authToken`) are
2254
2298
  * redacted so that `JSON.stringify(box)` is safe to ship to log
@@ -2366,7 +2410,7 @@ var SandboxInstance = class SandboxInstance {
2366
2410
  throw parseErrorResponse(response.status, body, void 0, response.headers);
2367
2411
  }
2368
2412
  const data = await response.json();
2369
- this.info = this.parseInfo(data);
2413
+ this.info = this.parseInfo(data, this.info);
2370
2414
  sandboxStatusObservedAt.set(this, Date.now());
2371
2415
  }
2372
2416
  /**
@@ -4940,6 +4984,7 @@ var SandboxInstance = class SandboxInstance {
4940
4984
  */
4941
4985
  async snapshot(options) {
4942
4986
  if (options && "paths" in options) throw new Error("Path-scoped snapshot capture is not supported; create a whole-workspace snapshot and use restorePaths()");
4987
+ if (options?.idempotencyKey && options.storage) throw new Error("idempotencyKey is not supported with customer-provided storage; the BYOS3 snapshot path keeps no operation ledger");
4943
4988
  await this.ensureRunning();
4944
4989
  if (options?.storage) {
4945
4990
  const response = await this.runtimeFetch("/snapshots", {
@@ -4964,6 +5009,7 @@ var SandboxInstance = class SandboxInstance {
4964
5009
  }
4965
5010
  const response = await this.client.fetch(`/v1/sandboxes/${this.id}/snapshots`, {
4966
5011
  method: "POST",
5012
+ ...options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {},
4967
5013
  body: JSON.stringify({ tags: options?.tags })
4968
5014
  }, { timeoutMs: SNAPSHOT_CREATE_REQUEST_TIMEOUT_MS });
4969
5015
  if (!response.ok) {
@@ -4973,11 +5019,18 @@ var SandboxInstance = class SandboxInstance {
4973
5019
  const data = await response.json();
4974
5020
  const snapshotId = data.snapshotId ?? data.id;
4975
5021
  if (typeof snapshotId !== "string" || snapshotId.length === 0) throw new ServerError(`Snapshot create returned 200 but body had no snapshot ID: ${JSON.stringify(data).slice(0, 200)}`, response.status);
5022
+ const reportedOutcome = data.idempotency?.outcome;
5023
+ const reportedDigest = data.idempotency?.requestDigest;
5024
+ const idempotency = (reportedOutcome === "created" || reportedOutcome === "replayed") && typeof reportedDigest === "string" ? {
5025
+ outcome: reportedOutcome,
5026
+ requestDigest: reportedDigest
5027
+ } : void 0;
4976
5028
  const snapshot = {
4977
5029
  snapshotId,
4978
5030
  createdAt: new Date(data.createdAt ?? Date.now()),
4979
5031
  sizeBytes: data.sizeBytes,
4980
- tags: data.tags ?? []
5032
+ tags: data.tags ?? [],
5033
+ ...idempotency ? { idempotency } : {}
4981
5034
  };
4982
5035
  await this.waitForSnapshotVisible(snapshot.snapshotId, {
4983
5036
  createdAt: snapshot.createdAt,
@@ -5119,12 +5172,60 @@ var SandboxInstance = class SandboxInstance {
5119
5172
  };
5120
5173
  throw lastError instanceof Error ? lastError : new TimeoutError(SNAPSHOT_VISIBILITY_TIMEOUT_MS);
5121
5174
  }
5175
+ /**
5176
+ * Delete a snapshot.
5177
+ *
5178
+ * Deleting a snapshot that is already gone succeeds and reports
5179
+ * `already_absent`, so a retry after an uncertain failure does not raise. A
5180
+ * 404 means this sandbox is unknown, not that the snapshot was missing.
5181
+ */
5122
5182
  async deleteSnapshot(snapshotId) {
5123
5183
  const response = await this.client.fetch(`/v1/sandboxes/${this.id}/snapshots/${encodeURIComponent(snapshotId)}`, { method: "DELETE" });
5124
5184
  if (!response.ok) {
5125
5185
  const body = await response.text();
5126
5186
  throw parseErrorResponse(response.status, body, void 0, response.headers);
5127
5187
  }
5188
+ const body = await response.json().catch(() => ({}));
5189
+ return {
5190
+ snapshotId,
5191
+ outcome: body.outcome === "deleted" || body.outcome === "already_absent" ? body.outcome : "unknown"
5192
+ };
5193
+ }
5194
+ /**
5195
+ * Ask whether the snapshot bound to an idempotency key is decided.
5196
+ *
5197
+ * Pass the same options the create carried: the service derives the request
5198
+ * digest from them, so a caller never reproduces its canonical form.
5199
+ */
5200
+ async getSnapshotOperation(idempotencyKey, options) {
5201
+ const response = await this.client.fetch(`/v1/sandboxes/${this.id}/workspace-operations/lookup`, {
5202
+ method: "POST",
5203
+ body: JSON.stringify({
5204
+ kind: "checkpoint",
5205
+ idempotencyKey,
5206
+ request: { tags: options?.tags }
5207
+ })
5208
+ });
5209
+ if (!response.ok) {
5210
+ if (response.status === 404 || response.status === 405) return {
5211
+ outcome: "unknown",
5212
+ kind: "checkpoint"
5213
+ };
5214
+ const body = await response.text();
5215
+ throw parseErrorResponse(response.status, body, void 0, response.headers);
5216
+ }
5217
+ const body = await response.json().catch(() => ({}));
5218
+ const outcome = body?.outcome;
5219
+ if (outcome !== "found" && outcome !== "not_found" && outcome !== "conflict") return {
5220
+ ...body,
5221
+ outcome: "unknown",
5222
+ kind: "checkpoint"
5223
+ };
5224
+ return {
5225
+ ...body,
5226
+ outcome,
5227
+ kind: body?.kind ?? "checkpoint"
5228
+ };
5128
5229
  }
5129
5230
  /**
5130
5231
  * Restore from the latest snapshot in customer-provided storage.
@@ -5182,9 +5283,13 @@ var SandboxInstance = class SandboxInstance {
5182
5283
  * parent's clean pages instead of each copying full guest memory. The parent
5183
5284
  * stays running.
5184
5285
  *
5286
+ * Returns only the children. A fan-out that materialized fewer than `count`
5287
+ * still resolves — the children are real — so compare the array length, or
5288
+ * call {@link fork} for the explicit `complete` flag.
5289
+ *
5185
5290
  * @param count - Number of children to create (must be >= 1).
5186
5291
  * @param options - Per-child overrides.
5187
- * @returns Exactly `count` new sandbox instances.
5292
+ * @returns The new sandbox instances that materialized.
5188
5293
  *
5189
5294
  * @example
5190
5295
  * ```typescript
@@ -5193,9 +5298,29 @@ var SandboxInstance = class SandboxInstance {
5193
5298
  * ```
5194
5299
  */
5195
5300
  async branch(count, options) {
5301
+ return (await this.fork(count, options)).children;
5302
+ }
5303
+ /**
5304
+ * Branch this RUNNING sandbox and report the fan-out, not only the children.
5305
+ *
5306
+ * `complete` is false when fewer children materialized than were requested,
5307
+ * so a partial fan-out is never read as a whole one. With an
5308
+ * `idempotencyKey`, a retry of the same key and options returns exactly the
5309
+ * children the first request materialized and creates none.
5310
+ *
5311
+ * @example
5312
+ * ```typescript
5313
+ * const forked = await box.fork(5, { idempotencyKey: "run-42" });
5314
+ * if (!forked.complete) {
5315
+ * console.warn(`${forked.materializedCount} of ${forked.requestedCount}`);
5316
+ * }
5317
+ * ```
5318
+ */
5319
+ async fork(count, options) {
5196
5320
  if (!Number.isInteger(count) || count < 1) throw new ValidationError(`branch count must be an integer >= 1 (got ${count})`);
5197
5321
  const response = await this.client.fetch(`/v1/sandboxes/${this.id}/branch`, {
5198
5322
  method: "POST",
5323
+ ...options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {},
5199
5324
  body: JSON.stringify({
5200
5325
  count,
5201
5326
  env: options?.env,
@@ -5206,7 +5331,63 @@ var SandboxInstance = class SandboxInstance {
5206
5331
  const body = await response.text();
5207
5332
  throw parseErrorResponse(response.status, body, void 0, response.headers);
5208
5333
  }
5209
- return ((await response.json()).children ?? []).map((child) => createSandboxInstanceFromResponse(this.client, this.parseInfo(child), this.defaultRuntimeBackend));
5334
+ const data = await response.json();
5335
+ const children = (data.children ?? []).map((child) => createSandboxInstanceFromResponse(this.client, this.parseInfo(child), this.defaultRuntimeBackend));
5336
+ const materializedCount = children.length;
5337
+ const requestedCount = typeof data.fork?.requestedCount === "number" ? data.fork.requestedCount : count;
5338
+ const reportedOutcome = data.idempotency?.outcome;
5339
+ const reportedDigest = data.idempotency?.requestDigest;
5340
+ const idempotency = (reportedOutcome === "created" || reportedOutcome === "replayed") && typeof reportedDigest === "string" ? {
5341
+ outcome: reportedOutcome,
5342
+ requestDigest: reportedDigest
5343
+ } : void 0;
5344
+ return {
5345
+ children,
5346
+ requestedCount,
5347
+ materializedCount,
5348
+ complete: materializedCount === requestedCount,
5349
+ ...idempotency ? { idempotency } : {}
5350
+ };
5351
+ }
5352
+ /**
5353
+ * Ask whether the fork bound to an idempotency key is decided.
5354
+ *
5355
+ * Pass the same count and options the fork carried: the service derives the
5356
+ * request digest from them, so a caller never reproduces its canonical form.
5357
+ */
5358
+ async getForkOperation(idempotencyKey, options) {
5359
+ const response = await this.client.fetch(`/v1/sandboxes/${this.id}/workspace-operations/lookup`, {
5360
+ method: "POST",
5361
+ body: JSON.stringify({
5362
+ kind: "fork",
5363
+ idempotencyKey,
5364
+ request: {
5365
+ count: options.count,
5366
+ env: options.env,
5367
+ metadata: options.metadata
5368
+ }
5369
+ })
5370
+ });
5371
+ if (!response.ok) {
5372
+ if (response.status === 404 || response.status === 405) return {
5373
+ outcome: "unknown",
5374
+ kind: "fork"
5375
+ };
5376
+ const body = await response.text();
5377
+ throw parseErrorResponse(response.status, body, void 0, response.headers);
5378
+ }
5379
+ const body = await response.json().catch(() => ({}));
5380
+ const outcome = body?.outcome;
5381
+ if (outcome !== "found" && outcome !== "not_found" && outcome !== "conflict") return {
5382
+ ...body,
5383
+ outcome: "unknown",
5384
+ kind: "fork"
5385
+ };
5386
+ return {
5387
+ ...body,
5388
+ outcome,
5389
+ kind: body?.kind ?? "fork"
5390
+ };
5210
5391
  }
5211
5392
  /**
5212
5393
  * Speculative rollouts: branch this RUNNING sandbox into `n` copy-on-write
@@ -5323,7 +5504,10 @@ var SandboxInstance = class SandboxInstance {
5323
5504
  if (diagnostics) this.info.startupDiagnostics = diagnostics;
5324
5505
  }
5325
5506
  /**
5326
- * Delete the sandbox permanently.
5507
+ * Delete the sandbox permanently. This is how a forked child is destroyed.
5508
+ *
5509
+ * `outcome` separates `destroyed` from `already_absent`, so a retry after an
5510
+ * uncertain failure reports what really happened instead of raising.
5327
5511
  *
5328
5512
  * The delete response carries the orchestrator's per-phase delete breakdown
5329
5513
  * (`container_remove` / `storage_binding_wait` / `cleanup_parallel` /
@@ -5337,9 +5521,15 @@ var SandboxInstance = class SandboxInstance {
5337
5521
  const body = await response.text();
5338
5522
  throw parseErrorResponse(response.status, body, void 0, response.headers);
5339
5523
  }
5340
- const diagnostics = await this.readLifecycleDiagnostics(response);
5524
+ const data = await response.json().catch(() => null);
5525
+ const diagnostics = data ? normalizeStartupDiagnostics(data.startupDiagnostics) : null;
5341
5526
  if (diagnostics) this.info.startupDiagnostics = diagnostics;
5342
5527
  sandboxStatusObservedAt.delete(this);
5528
+ const outcome = data?.outcome === "destroyed" || data?.outcome === "already_absent" ? data.outcome : "unknown";
5529
+ return {
5530
+ sandboxId: this.id,
5531
+ outcome
5532
+ };
5343
5533
  }
5344
5534
  /**
5345
5535
  * Read the per-phase lifecycle breakdown off a stop/resume/delete response
@@ -5658,7 +5848,18 @@ var SandboxInstance = class SandboxInstance {
5658
5848
  sessionId: data.sessionId ?? opts.sessionId
5659
5849
  };
5660
5850
  }
5661
- parseInfo(data) {
5851
+ /**
5852
+ * Parse a sandbox API payload into `SandboxInfo`.
5853
+ *
5854
+ * `carryCreateFacts` supplies the create-time facts a refresh must keep:
5855
+ * the GPU lease, the startup diagnostics, and the create receipt each arrive
5856
+ * once on the create response and are absent from every later payload. They
5857
+ * describe ONE environment's creation, so they travel only when the payload
5858
+ * describes that same environment. A payload for a different sandbox — a
5859
+ * branch child parsed through its parent — passes no carry, or the child
5860
+ * would report its parent's create verdict.
5861
+ */
5862
+ parseInfo(data, carryCreateFacts) {
5662
5863
  const id = data.id ?? this.id;
5663
5864
  const incarnation = readFilesystemIncarnationTuple(data);
5664
5865
  const incarnationComplete = incarnation.complete;
@@ -5678,8 +5879,9 @@ var SandboxInstance = class SandboxInstance {
5678
5879
  lastActivityAt: data.lastActivityAt ? new Date(data.lastActivityAt) : void 0,
5679
5880
  expiresAt: data.expiresAt ? new Date(data.expiresAt) : void 0,
5680
5881
  error: data.error,
5681
- gpuLease: data.gpuLease ?? this.info.gpuLease,
5682
- startupDiagnostics: normalizeStartupDiagnostics(data.startupDiagnostics) ?? this.info?.startupDiagnostics
5882
+ gpuLease: data.gpuLease ?? carryCreateFacts?.gpuLease,
5883
+ startupDiagnostics: normalizeStartupDiagnostics(data.startupDiagnostics) ?? carryCreateFacts?.startupDiagnostics,
5884
+ createReceipt: normalizeSandboxCreateReceipt(data.createReceipt) ?? carryCreateFacts?.createReceipt
5683
5885
  };
5684
5886
  }
5685
5887
  sleep(ms) {
@@ -6557,4 +6759,4 @@ function quoteForShell(value) {
6557
6759
  return `'${value.replace(/'/g, "'\\''")}'`;
6558
6760
  }
6559
6761
  //#endregion
6560
- export { buildTraceExportPayload as _, TERMINAL_WS_ECHO_SUBPROTOCOL as a, toOtelJson as b, SandboxTaskSession as c, applySandboxEventText as d, collectAgentFinalMessageText as f, normalizeConnection as g, isToolBearingEvent as h, WorkspaceImages as i, SandboxSession as l, getSandboxEventText as m, createSandboxInstanceFromResponse as n, TerminalStream as o, collectAgentResponseText as p, normalizeStartupDiagnostics as r, TerminalStreamError as s, SandboxInstance as t, InteractiveSessionHandle as u, exportTraceBundle as v, parseSSEStream as x, otelTraceIdForTangleTrace as y };
6762
+ export { parseSSEStream as S, normalizeConnection as _, WorkspaceImages as a, otelTraceIdForTangleTrace as b, TerminalStreamError as c, InteractiveSessionHandle as d, applySandboxEventText as f, isToolBearingEvent as g, getSandboxEventText as h, normalizeStartupDiagnostics as i, SandboxTaskSession as l, collectAgentResponseText as m, createSandboxInstanceFromResponse as n, TERMINAL_WS_ECHO_SUBPROTOCOL as o, collectAgentFinalMessageText as p, normalizeSandboxCreateReceipt as r, TerminalStream as s, SandboxInstance as t, SandboxSession as u, buildTraceExportPayload as v, toOtelJson as x, exportTraceBundle as y };
@@ -1,2 +1,2 @@
1
- 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-Cx3hAzB9.js";
1
+ 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-DIuMQrlL.js";
2
2
  export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TANGLE_MAINNET_RPC, TangleSandboxClient, TangleSandboxClientConfig };
@@ -1,2 +1,2 @@
1
- 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-BDdxSi54.js";
1
+ 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-DfKDt5Nz.js";
2
2
  export { AgentSandboxBlueprintAbi, ITangleJobsAbi, JOB_SANDBOX_CREATE, JOB_SANDBOX_DELETE, JsonResponseParamTypes, SandboxCreateParamTypes, SandboxCreateResponseParamTypes, SandboxIdParamTypes, TANGLE_CHAIN_ID, TANGLE_JOBS_CONTRACT, TANGLE_MAINNET_RPC, TangleSandboxClient };
@@ -1,5 +1,5 @@
1
- import { m as parseErrorResponse } from "./errors-D2aWy99l.js";
2
- import { n as createSandboxInstanceFromResponse } from "./sandbox-CEOxB8dH.js";
1
+ import { m as parseErrorResponse } from "./errors-C6kn-3zt.js";
2
+ import { n as createSandboxInstanceFromResponse } from "./sandbox-NvbxFwTv.js";
3
3
  //#region src/tangle/abi.ts
4
4
  /**
5
5
  * Tangle Contract ABI Definitions
@@ -2057,6 +2057,13 @@ interface StartupOperation {
2057
2057
  status?: string;
2058
2058
  /** Wall-clock duration of the step in milliseconds, when measured. */
2059
2059
  durationMs?: number;
2060
+ /**
2061
+ * `operation` of the step whose wall CONTAINS this one; absent means the
2062
+ * step hangs directly under the flow total. Add only the steps that no
2063
+ * other step names as its parent — a parent re-measures the time its
2064
+ * children already report, so summing both over-counts the flow.
2065
+ */
2066
+ parent?: string;
2060
2067
  /** PII-scrubbed step detail (counts, ids, error codes). */
2061
2068
  metadata?: Record<string, unknown>;
2062
2069
  }
@@ -2070,6 +2077,10 @@ interface StartupOperation {
2070
2077
  * is a derived convenience map of operation name → `durationMs` for the
2071
2078
  * steps that reported a duration; steps without a measured duration are
2072
2079
  * omitted from `phases` but still present in `operations`.
2080
+ *
2081
+ * `phases` mixes containing steps with the steps they contain, so its values
2082
+ * do NOT add up to the flow wall. To add durations, filter `operations` to
2083
+ * those no other operation names as its `parent`.
2073
2084
  */
2074
2085
  interface StartupDiagnostics {
2075
2086
  /** Ordered startup steps exactly as the platform emitted them. */
@@ -2077,6 +2088,28 @@ interface StartupDiagnostics {
2077
2088
  /** Derived map of operation name → measured duration in milliseconds. */
2078
2089
  phases: Record<string, number>;
2079
2090
  }
2091
+ /**
2092
+ * What one `create()` call did to the sandbox environment.
2093
+ *
2094
+ * - `created`: the call allocated the environment. The platform states this
2095
+ * only when the create identity belonged to the call alone.
2096
+ * - `idempotent_replay`: the platform returned the environment that an earlier
2097
+ * call with the same idempotency key allocated. The call allocated nothing.
2098
+ * - `unknown`: the platform cannot prove either outcome, so another caller can
2099
+ * hold the environment.
2100
+ */
2101
+ type SandboxCreateOutcome = "created" | "idempotent_replay" | "unknown";
2102
+ /**
2103
+ * The platform verdict for one create call.
2104
+ *
2105
+ * Delete the environment only on a `created` outcome. `idempotencyKeyApplied`
2106
+ * reports whether the idempotency key selected the environment: a false value
2107
+ * means a retry of the same request allocates a second sandbox.
2108
+ */
2109
+ interface SandboxCreateReceipt {
2110
+ outcome: SandboxCreateOutcome;
2111
+ idempotencyKeyApplied: boolean;
2112
+ }
2080
2113
  /**
2081
2114
  * Full sandbox information returned from the API.
2082
2115
  */
@@ -2116,6 +2149,13 @@ interface SandboxInfo {
2116
2149
  * directly.
2117
2150
  */
2118
2151
  startupDiagnostics?: StartupDiagnostics;
2152
+ /**
2153
+ * The platform verdict for the create call that returned this sandbox.
2154
+ * Present only on the create response. An absent value means the platform
2155
+ * reported no receipt: treat it as `unknown`, never as `created`. Use
2156
+ * {@link SandboxInstance.createReceipt} rather than reading this directly.
2157
+ */
2158
+ createReceipt?: SandboxCreateReceipt;
2119
2159
  /** Resolved egress policy */
2120
2160
  egressPolicy?: EgressPolicy;
2121
2161
  /** Source of the egress policy */
@@ -3661,6 +3701,26 @@ interface SnapshotOptions {
3661
3701
  paths?: never;
3662
3702
  /** Customer-provided storage for BYOS3 (calls the runtime directly) */
3663
3703
  storage?: StorageConfig;
3704
+ /**
3705
+ * Retry identity for this snapshot. A retry with the same key and the same
3706
+ * options replays the stored result instead of taking a second snapshot; the
3707
+ * same key with different options is refused.
3708
+ *
3709
+ * Rejected together with `storage`: the BYOS3 path calls the runtime
3710
+ * directly and keeps no operation ledger, so the key would guard nothing.
3711
+ */
3712
+ idempotencyKey?: string;
3713
+ }
3714
+ /**
3715
+ * How a keyed snapshot resolved.
3716
+ *
3717
+ * `created` ran this snapshot. `replayed` returned the acknowledgement an
3718
+ * earlier request under the same key and options already stored. Absent when
3719
+ * the request carried no key, or when the API predates the field.
3720
+ */
3721
+ interface SnapshotIdempotency {
3722
+ outcome: "created" | "replayed";
3723
+ requestDigest: string;
3664
3724
  }
3665
3725
  /**
3666
3726
  * Result of a snapshot operation.
@@ -3674,6 +3734,57 @@ interface SnapshotResult {
3674
3734
  sizeBytes?: number;
3675
3735
  /** Tags applied to the snapshot */
3676
3736
  tags: string[];
3737
+ /** Present only for a keyed snapshot against an API that reports it. */
3738
+ idempotency?: SnapshotIdempotency;
3739
+ }
3740
+ /**
3741
+ * Outcome of deleting a snapshot.
3742
+ *
3743
+ * - `deleted`: this call removed the snapshot.
3744
+ * - `already_absent`: it was not there; the caller's intent already holds.
3745
+ * - `unknown`: the API did not report which, so neither is claimed. An API
3746
+ * deployed before this field existed answers `unknown` rather than throwing.
3747
+ */
3748
+ type SnapshotDeleteOutcome = "deleted" | "already_absent" | "unknown";
3749
+ interface SnapshotDeleteAcknowledgement {
3750
+ snapshotId: string;
3751
+ outcome: SnapshotDeleteOutcome;
3752
+ }
3753
+ /**
3754
+ * Outcome of deleting a sandbox, which is how a forked child is destroyed.
3755
+ *
3756
+ * - `destroyed`: this call removed the sandbox.
3757
+ * - `already_absent`: the runtime had already lost it; the caller's intent
3758
+ * already holds and the product-plane rows were finalized.
3759
+ * - `unknown`: the API did not report which, so neither is claimed. An API
3760
+ * deployed before this field existed answers `unknown` rather than throwing.
3761
+ */
3762
+ type SandboxDeleteOutcome = "destroyed" | "already_absent" | "unknown";
3763
+ interface SandboxDeleteAcknowledgement {
3764
+ sandboxId: string;
3765
+ outcome: SandboxDeleteOutcome;
3766
+ }
3767
+ /**
3768
+ * Whether the operation bound to an idempotency key is decided.
3769
+ *
3770
+ * - `found`: the key is decided; `state` says how.
3771
+ * - `not_found`: nothing claimed this key.
3772
+ * - `conflict`: the key is bound to a different request body.
3773
+ * - `unknown`: a request claimed the key and its result is still undecided, or
3774
+ * the API is too old to answer. Reconcile against real state before retrying.
3775
+ */
3776
+ interface WorkspaceOperationLookup {
3777
+ outcome: "found" | "not_found" | "conflict" | "unknown";
3778
+ kind: "checkpoint" | "fork";
3779
+ state?: "pending" | "succeeded" | "failed";
3780
+ requestDigest?: string;
3781
+ existingRequestDigest?: string;
3782
+ result?: Record<string, unknown>;
3783
+ failure?: {
3784
+ status: number;
3785
+ error: string;
3786
+ code?: string;
3787
+ };
3677
3788
  }
3678
3789
  interface RestoreSnapshotOptions {
3679
3790
  destinationPath?: string;
@@ -4258,6 +4369,42 @@ interface BranchOptions {
4258
4369
  * matching resources — children always inherit the parent's.
4259
4370
  */
4260
4371
  metadata?: Record<string, unknown>;
4372
+ /**
4373
+ * Retry identity for this fan-out. A retry with the same key and the same
4374
+ * options returns the children the first request materialized and creates
4375
+ * none; the same key with different options is refused.
4376
+ */
4377
+ idempotencyKey?: string;
4378
+ }
4379
+ /**
4380
+ * How a keyed fork resolved.
4381
+ *
4382
+ * `created` ran this fan-out. `replayed` returned the children an earlier
4383
+ * request under the same key and options already materialized. Absent when the
4384
+ * request carried no key, or when the API predates the field.
4385
+ */
4386
+ interface ForkIdempotency {
4387
+ outcome: "created" | "replayed";
4388
+ requestDigest: string;
4389
+ }
4390
+ /**
4391
+ * Fan-out accounting for one fork.
4392
+ *
4393
+ * `materializedCount` counts the children that exist. Below `requestedCount` it
4394
+ * is a partial fan-out and `complete` is false: the children are real and
4395
+ * usable, and the caller decides whether to fork the shortfall.
4396
+ */
4397
+ interface ForkCounts {
4398
+ requestedCount: number;
4399
+ materializedCount: number;
4400
+ complete: boolean;
4401
+ }
4402
+ /** Everything the API answers to a fork lookup, minus the children. */
4403
+ interface ForkLookupOptions {
4404
+ /** The count the fork asked for; part of the request identity. */
4405
+ count: number;
4406
+ env?: Record<string, string>;
4407
+ metadata?: Record<string, unknown>;
4261
4408
  }
4262
4409
  /**
4263
4410
  * One message part of the agent turn sent to every rollout child.
@@ -6274,4 +6421,4 @@ interface CodeExecutionOptions {
6274
6421
  idempotencyKey?: string;
6275
6422
  }
6276
6423
  //#endregion
6277
- export { EnsureDevServerOptions as $, BatchEventDataMap as $i, SandboxFleetArtifactSpec as $n, SendSessionMessageRequest as $r, ListOptions as $t, CreateSandboxFleetTokenOptions as A, TokenRefreshHandler as Ai, PublishPublicTemplateOptions as An, SandboxResourceUsage as Ar, GitBranch as At, DownloadOptions as B, WriteManyFile as Bi, RolloutChildResult as Bn, SandboxTerminals as Br, GpuLeaseManager as Bt, CodeResultPart as C, TaskSessionInfo as Ci, PromptResult as Cn, SandboxFleetWorkspaceRestoreResult as Cr, FleetExecDispatchOptions as Ct, CreateIntelligenceReportOptions as D, TeeAttestationResponse as Di, ProvisionStep as Dn, SandboxIntelligenceEnvelope as Dr, FleetPromptDispatchResult as Dt, CreateGpuLeaseOptions as E, TeeAttestationReport as Ei, ProvisionStatus as En, SandboxInfo as Er, FleetPromptDispatchOptions as Et, DeleteOptions as F, UploadProgress as Fi, ReconcileSandboxFleetsResult as Fn, SandboxTerminalAttachOptions as Fr, GpuLease as Ft, DriverType as G, TerminalStream as Gi, RolloutTurnPart as Gn, SandboxUser as Gr, InstalledTool as Gt, DriveTurnOptions as H, TERMINAL_WS_ECHO_SUBPROTOCOL as Hi, RolloutScorer as Hn, SandboxTraceEvent as Hr, GpuLeaseStatus as Ht, DevServerInfo as I, UsageInfo as Ii, RenameOptions as In, SandboxTerminalCreateOptions as Ir, GpuLeaseBilling as It, EffectiveBackend as J, TerminalStreamHandlers as Ji, SandboxConfig as Jn, SearchMatch as Jr, IntelligenceReportCompareTo as Jt, DurablePlan as K, TerminalStreamAuthFormat as Ki, SSHCommandDescriptor as Kn, ScopedToken as Kr, IntelligenceReport as Kt, DirectoryPermission as L, WaitForOptions as Li, RestoreSnapshotOptions as Ln, SandboxTerminalInfo as Lr, GpuLeaseCommandResult as Lt, CreateSandboxOptions as M, TurnDriveResult as Mi, ReapExpiredSandboxFleetsOptions as Mn, SandboxRuntimeCapabilities as Mr, GitConfig as Mt, CreateSessionOptions as N, UpdateUserOptions as Ni, ReapExpiredSandboxFleetsResult as Nn, SandboxRuntimeHealth as Nr, GitDiff as Nt, CreateRequestOptions as O, TeePublicKey as Oi, PublicTemplateInfo as On, SandboxPortBinding as Or, GPU_LEASE_PROVIDER_NAMES as Ot, CreateTaskSessionOptions as P, UploadOptions as Pi, ReconcileSandboxFleetsOptions as Pn, SandboxStatus as Pr, GitStatus as Pt, EgressPolicy as Q, BatchEvent as Qi, SandboxFleetArtifact as Qn, SendSessionMessageOptions as Qr, ListMessagesOptions as Qt, DispatchPromptOptions as R, WaitForRolloutOptions as Ri, ResumeOptions as Rn, SandboxTerminalManager as Rr, GpuLeaseExecOptions as Rt, CodeLanguage as S, TaskSessionFileChange as Si, PromptOptions as Sn, SandboxFleetWorkspaceReconcileResult as Sr, FleetDriveTurnRequest as St, CompletedTurnResult as T, TeeAttestationOptions as Ti, ProvisionResult as Tn, SandboxIdentity as Tr, FleetMachineId as Tt, DriverConfig as U, TerminalExitInfo as Ui, RolloutStartResult as Un, SandboxTraceExport as Ur, HostAgentDriverConfig as Ut, DownloadProgress as V, WriteManyOptions as Vi, RolloutOptions as Vn, SandboxTraceBundle as Vr, GpuLeaseProviderName as Vt, DriverInfo as W, TerminalReadyInfo as Wi, RolloutStatus as Wn, SandboxTraceOptions as Wr, HostAgentRuntimeBackend as Wt, EffectiveBackendSource as X, TerminalStreamToken as Xi, SandboxEnvironment as Xn, SecretInfo as Xr, IntelligenceReportWindow as Xt, EffectiveBackendProfile as Y, TerminalStreamOptions as Yi, SandboxConnection as Yn, SearchOptions as Yr, IntelligenceReportSubjectType as Yt, EgressManager as Z, BatchBackendStats as Zi, SandboxEvent as Zn, SecretsManager as Zr, JsonValue as Zt, BranchOptions as _, StartupOperation as _i, ProcessManager as _n, SandboxFleetTraceEvent as _r, FleetDispatchCancelResult as _t, AttachSandboxFleetMachineOptions as a, SessionInfo as ai, NetworkConfig as an, SandboxFleetInfo as ar, FileReadBatchOptions as at, CodeExecutionOptions as b, TaskSessionChanges as bi, ProcessStatus as bn, SandboxFleetUsage as br, FleetDispatchStreamOptions as bt, BackendInfo as c, SessionMessage as ci, PermissionLevel as cn, SandboxFleetMachineMeteredUsage as cr, FileReadResult as ct, BatchBackend as d, SessionStatus as di, PreviewLinkManager as dn, SandboxFleetManifest as dr, FileTreeFile as dt, BatchSidecarGroup as ea, SentSessionMessage as ei, ListSandboxFleetOptions as en, SandboxFleetCostEstimate as er, EventStreamOptions as et, BatchResult as f, SnapshotInfo as fi, PreviewLinkWaitOptions as fn, SandboxFleetManifestMachine as fr, FileTreeOptions as ft, BatchTaskResult as g, StartupDiagnostics as gi, ProcessLogEntry as gn, SandboxFleetTraceBundle as gr, FileWriteResult as gt, BatchTask as h, SshKeysManager as hi, ProcessListOptions as hn, SandboxFleetToken as hr, FileUsageResult as ht, AttachGpuLeaseOptions as i, parseBackendType as ia, SessionForkOptions as ii, MkdirOptions as in, SandboxFleetDriverTimings as ir, FileInfo as it, CreateSandboxFleetWithCoordinatorOptions as j, TokenUsage as ji, PublishPublicTemplateVersionOptions as jn, SandboxResources as jr, GitCommit as jt, CreateSandboxFleetOptions as k, TeePublicKeyResponse as ki, PublicTemplateVersionInfo as kn, SandboxPortPreviewLink as kr, GitAuth as kt, BackendManager as l, SessionMessageInputPart as li, PermissionsManager as ln, SandboxFleetMachineRecord as lr, FileRenameResult as lt, BatchRunRequest as m, SnapshotResult as mi, ProcessInfo as mn, SandboxFleetPolicy as mr, FileUsageOptions as mt, AccessPolicyRule as n, PublicBatchRunRequest as na, SessionEventStreamOptions as ni, McpServerConfig as nn, SandboxFleetDispatchResponse as nr, ExecOptions as nt, BackendCapabilities as o, SessionInterruptOptions as oi, NetworkManager as on, SandboxFleetIntelligenceEnvelope as or, FileReadBatchResult as ot, BatchRunOptions as p, SnapshotOptions as pi, Process as pn, SandboxFleetOperationsSummary as pr, FileTreeResult as pt, DurablePlanDecisionResult as q, TerminalStreamError as qi, SSHCredentials as qn, ScopedTokenScope as qr, IntelligenceReportBudget as qt, AddUserOptions as r, BackendType as ra, SessionFailureReason as ri, MintScopedTokenOptions as rn, SandboxFleetDriverCapability as rr, ExecResult as rt, BackendConfig as s, SessionListOptions as si, NonHostAgentDriverConfig as sn, SandboxFleetMachine as sr, FileReadError as st, AcceleratorKind as t, BatchTaskUsage as ta, SessionBackendCredentials as ti, ListSandboxOptions as tn, SandboxFleetDispatchFailureClass as tr, ExactProcessSpawnOptions as tt, BackendStatus as u, SessionResultOptions as ui, PreviewLinkInfo as un, SandboxFleetMachineSpec as ur, FileSystem as ut, ChunkedUploadOptions as v, StorageConfig as vi, ProcessSignal as vn, SandboxFleetTraceExport as vr, FleetDispatchResultBuffer as vt, CommitTaskSessionOptions as w, TaskSessionProfile as wi, ProvisionEvent as wn, SandboxFleetWorkspaceSnapshotResult as wr, FleetExecDispatchResult as wt, CodeExecutionResult as x, TaskSessionCommitResult as xi, PromptInputPart as xn, SandboxFleetWorkspace as xr, FleetDriveTurnOutcome as xt, ChunkedUploadResult as y, SubscriptionInfo as yi, ProcessSpawnOptions as yn, SandboxFleetTraceOptions as yr, FleetDispatchResultBufferOptions as yt, DispatchedSession as z, WriteFileOptions as zi, Rollout as zn, SandboxTerminalRequestOptions as zr, GpuLeaseExecResult as zt };
6424
+ export { EnsureDevServerOptions as $, TERMINAL_WS_ECHO_SUBPROTOCOL as $i, SandboxCreateOutcome as $n, ScopedToken as $r, IntelligenceReportWindow as $t, CreateSandboxFleetTokenOptions as A, TaskSessionChanges as Ai, ProvisionStep as An, SandboxFleetWorkspaceRestoreResult as Ar, ForkLookupOptions as At, DownloadOptions as B, TokenRefreshHandler as Bi, RestoreSnapshotOptions as Bn, SandboxRuntimeHealth as Br, GpuLeaseCommandResult as Bt, CodeResultPart as C, SnapshotOptions as Ci, ProcessStatus as Cn, SandboxFleetTraceBundle as Cr, FleetExecDispatchOptions as Ct, CreateIntelligenceReportOptions as D, StartupOperation as Di, ProvisionEvent as Dn, SandboxFleetUsage as Dr, FleetPromptDispatchResult as Dt, CreateGpuLeaseOptions as E, StartupDiagnostics as Ei, PromptResult as En, SandboxFleetTraceOptions as Er, FleetPromptDispatchOptions as Et, DeleteOptions as F, TeeAttestationOptions as Fi, ReapExpiredSandboxFleetsOptions as Fn, SandboxPortBinding as Fr, GitConfig as Ft, DriverType as G, UploadProgress as Gi, RolloutScorer as Gn, SandboxTerminalManager as Gr, GpuLeaseStatus as Gt, DriveTurnOptions as H, TurnDriveResult as Hi, Rollout as Hn, SandboxTerminalAttachOptions as Hr, GpuLeaseExecResult as Ht, DevServerInfo as I, TeeAttestationReport as Ii, ReapExpiredSandboxFleetsResult as In, SandboxPortPreviewLink as Ir, GitDiff as It, EffectiveBackend as J, WaitForRolloutOptions as Ji, RolloutTurnPart as Jn, SandboxTraceBundle as Jr, InstalledTool as Jt, DurablePlan as K, UsageInfo as Ki, RolloutStartResult as Kn, SandboxTerminalRequestOptions as Kr, HostAgentDriverConfig as Kt, DirectoryPermission as L, TeeAttestationResponse as Li, ReconcileSandboxFleetsOptions as Ln, SandboxResourceUsage as Lr, GitStatus as Lt, CreateSandboxOptions as M, TaskSessionFileChange as Mi, PublicTemplateVersionInfo as Mn, SandboxIdentity as Mr, GitAuth as Mt, CreateSessionOptions as N, TaskSessionInfo as Ni, PublishPublicTemplateOptions as Nn, SandboxInfo as Nr, GitBranch as Nt, CreateRequestOptions as O, StorageConfig as Oi, ProvisionResult as On, SandboxFleetWorkspace as Or, ForkCounts as Ot, CreateTaskSessionOptions as P, TaskSessionProfile as Pi, PublishPublicTemplateVersionOptions as Pn, SandboxIntelligenceEnvelope as Pr, GitCommit as Pt, EgressPolicy as Q, WriteManyOptions as Qi, SandboxConnection as Qn, SandboxUser as Qr, IntelligenceReportSubjectType as Qt, DispatchPromptOptions as R, TeePublicKey as Ri, ReconcileSandboxFleetsResult as Rn, SandboxResources as Rr, GpuLease as Rt, CodeLanguage as S, SnapshotInfo as Si, ProcessSpawnOptions as Sn, SandboxFleetToken as Sr, FleetDriveTurnRequest as St, CompletedTurnResult as T, SshKeysManager as Ti, PromptOptions as Tn, SandboxFleetTraceExport as Tr, FleetMachineId as Tt, DriverConfig as U, UpdateUserOptions as Ui, RolloutChildResult as Un, SandboxTerminalCreateOptions as Ur, GpuLeaseManager as Ut, DownloadProgress as V, TokenUsage as Vi, ResumeOptions as Vn, SandboxStatus as Vr, GpuLeaseExecOptions as Vt, DriverInfo as W, UploadOptions as Wi, RolloutOptions as Wn, SandboxTerminalInfo as Wr, GpuLeaseProviderName as Wt, EffectiveBackendSource as X, WriteFileOptions as Xi, SSHCredentials as Xn, SandboxTraceExport as Xr, IntelligenceReportBudget as Xt, EffectiveBackendProfile as Y, WorkspaceOperationLookup as Yi, SSHCommandDescriptor as Yn, SandboxTraceEvent as Yr, IntelligenceReport as Yt, EgressManager as Z, WriteManyFile as Zi, SandboxConfig as Zn, SandboxTraceOptions as Zr, IntelligenceReportCompareTo as Zt, BranchOptions as _, SessionResultOptions as _i, ProcessInfo as _n, SandboxFleetMachineSpec as _r, FleetDispatchCancelResult as _t, AttachSandboxFleetMachineOptions as a, TerminalStreamHandlers as aa, SendSessionMessageOptions as ai, McpServerConfig as an, SandboxFleetArtifact as ar, FileReadBatchOptions as at, CodeExecutionOptions as b, SnapshotDeleteOutcome as bi, ProcessManager as bn, SandboxFleetOperationsSummary as br, FleetDispatchStreamOptions as bt, BackendInfo as c, BatchBackendStats as ca, SessionBackendCredentials as ci, NetworkConfig as cn, SandboxFleetDispatchFailureClass as cr, FileReadResult as ct, BatchBackend as d, BatchSidecarGroup as da, SessionForkOptions as di, PermissionLevel as dn, SandboxFleetDriverTimings as dr, FileTreeFile as dt, TerminalExitInfo as ea, ScopedTokenScope as ei, JsonValue as en, SandboxCreateReceipt as er, EventStreamOptions as et, BatchResult as f, BatchTaskUsage as fa, SessionInfo as fi, PermissionsManager as fn, SandboxFleetInfo as fr, FileTreeOptions as ft, BatchTaskResult as g, SessionMessageInputPart as gi, Process as gn, SandboxFleetMachineRecord as gr, FileWriteResult as gt, BatchTask as h, parseBackendType as ha, SessionMessage as hi, PreviewLinkWaitOptions as hn, SandboxFleetMachineMeteredUsage as hr, FileUsageResult as ht, AttachGpuLeaseOptions as i, TerminalStreamError as ia, SecretsManager as ii, ListSandboxOptions as in, SandboxEvent as ir, FileInfo as it, CreateSandboxFleetWithCoordinatorOptions as j, TaskSessionCommitResult as ji, PublicTemplateInfo as jn, SandboxFleetWorkspaceSnapshotResult as jr, GPU_LEASE_PROVIDER_NAMES as jt, CreateSandboxFleetOptions as k, SubscriptionInfo as ki, ProvisionStatus as kn, SandboxFleetWorkspaceReconcileResult as kr, ForkIdempotency as kt, BackendManager as l, BatchEvent as la, SessionEventStreamOptions as li, NetworkManager as ln, SandboxFleetDispatchResponse as lr, FileRenameResult as lt, BatchRunRequest as m, BackendType as ma, SessionListOptions as mi, PreviewLinkManager as mn, SandboxFleetMachine as mr, FileUsageOptions as mt, AccessPolicyRule as n, TerminalStream as na, SearchOptions as ni, ListOptions as nn, SandboxDeleteOutcome as nr, ExecOptions as nt, BackendCapabilities as o, TerminalStreamOptions as oa, SendSessionMessageRequest as oi, MintScopedTokenOptions as on, SandboxFleetArtifactSpec as or, FileReadBatchResult as ot, BatchRunOptions as p, PublicBatchRunRequest as pa, SessionInterruptOptions as pi, PreviewLinkInfo as pn, SandboxFleetIntelligenceEnvelope as pr, FileTreeResult as pt, DurablePlanDecisionResult as q, WaitForOptions as qi, RolloutStatus as qn, SandboxTerminals as qr, HostAgentRuntimeBackend as qt, AddUserOptions as r, TerminalStreamAuthFormat as ra, SecretInfo as ri, ListSandboxFleetOptions as rn, SandboxEnvironment as rr, ExecResult as rt, BackendConfig as s, TerminalStreamToken as sa, SentSessionMessage as si, MkdirOptions as sn, SandboxFleetCostEstimate as sr, FileReadError as st, AcceleratorKind as t, TerminalReadyInfo as ta, SearchMatch as ti, ListMessagesOptions as tn, SandboxDeleteAcknowledgement as tr, ExactProcessSpawnOptions as tt, BackendStatus as u, BatchEventDataMap as ua, SessionFailureReason as ui, NonHostAgentDriverConfig as un, SandboxFleetDriverCapability as ur, FileSystem as ut, ChunkedUploadOptions as v, SessionStatus as vi, ProcessListOptions as vn, SandboxFleetManifest as vr, FleetDispatchResultBuffer as vt, CommitTaskSessionOptions as w, SnapshotResult as wi, PromptInputPart as wn, SandboxFleetTraceEvent as wr, FleetExecDispatchResult as wt, CodeExecutionResult as x, SnapshotIdempotency as xi, ProcessSignal as xn, SandboxFleetPolicy as xr, FleetDriveTurnOutcome as xt, ChunkedUploadResult as y, SnapshotDeleteAcknowledgement as yi, ProcessLogEntry as yn, SandboxFleetManifestMachine as yr, FleetDispatchResultBufferOptions as yt, DispatchedSession as z, TeePublicKeyResponse as zi, RenameOptions as zn, SandboxRuntimeCapabilities as zr, GpuLeaseBilling as zt };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/sandbox",
3
- "version": "0.23.0",
3
+ "version": "0.24.0-develop.20260814134500.1b07ee8",
4
4
  "description": "Client SDK for the Tangle Sandbox platform - build AI agent applications with dev containers",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",