@tangle-network/sandbox 0.9.2 → 0.9.3-develop.20260627012805.bf68a85

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.
@@ -4254,25 +4254,8 @@ interface InteractiveSessionInfo {
4254
4254
  }
4255
4255
  /** Decision passed to `respondToPermission`. */
4256
4256
  interface RespondToPermissionOptions {
4257
- /** The human's decision for the awaiting permission request. */
4257
+ /** The human's decision for the awaiting permission interaction. */
4258
4258
  response: "allow" | "deny";
4259
- /**
4260
- * Optional audit metadata recorded alongside the decision (e.g. the
4261
- * reviewer's identity or a reason string). Opaque to the sandbox.
4262
- */
4263
- metadata?: Record<string, unknown>;
4264
- }
4265
- /** Result of `respondToPermission`. Mirrors the sidecar route contract. */
4266
- interface PermissionResponseResult {
4267
- /** The decision was persisted for audit. Always true on success. */
4268
- recorded: true;
4269
- /**
4270
- * True iff a live ACP `request_permission` was awaiting this decision and
4271
- * it was forwarded to the running agent. `false` means record-only — the
4272
- * request already resolved (e.g. timed out to the allowlist fallback) or
4273
- * the backend does not surface live permission requests.
4274
- */
4275
- forwarded: boolean;
4276
4259
  }
4277
4260
  /** Result of `interrupt`. */
4278
4261
  interface InterruptResult {
@@ -4329,7 +4312,7 @@ interface SandboxSessionHost extends InteractiveSessionHost {
4329
4312
  _sessionEvents(id: string, opts?: SessionEventStreamOptions): AsyncGenerator<SandboxEvent>;
4330
4313
  _sessionResult(id: string): Promise<PromptResult>;
4331
4314
  _sessionCancel(id: string): Promise<void>;
4332
- _respondToPermission(id: string, permissionID: string, options: RespondToPermissionOptions): Promise<PermissionResponseResult>;
4315
+ _respondToPermission(id: string, permissionID: string, options: RespondToPermissionOptions): Promise<void>;
4333
4316
  _interrupt(id: string): Promise<InterruptResult>;
4334
4317
  _answerQuestion(id: string, answers: Record<string, string[]>): Promise<void>;
4335
4318
  }
@@ -4398,11 +4381,11 @@ declare class SandboxSession {
4398
4381
  */
4399
4382
  interactive(): InteractiveSessionHandle;
4400
4383
  /**
4401
- * Resolve a pending permission request the agent raised mid-turn. Forwards
4402
- * `allow`/`deny` to a live ACP `request_permission` if one is awaiting, and
4403
- * always records the decision for audit. Returns `{ recorded, forwarded }`.
4384
+ * Resolve a pending permission interaction the agent raised mid-turn,
4385
+ * forwarding `allow`/`deny` to the blocked agent through the unified
4386
+ * interaction channel. Throws if no matching permission is outstanding.
4404
4387
  */
4405
- respondToPermission(permissionID: string, options: RespondToPermissionOptions): Promise<PermissionResponseResult>;
4388
+ respondToPermission(permissionID: string, options: RespondToPermissionOptions): Promise<void>;
4406
4389
  /**
4407
4390
  * Interrupt the session's current execution without deleting it. Returns
4408
4391
  * `{ cancelled: false }` when nothing was running — the no-op is reported
@@ -5516,11 +5499,16 @@ declare class SandboxInstance {
5516
5499
  /** @internal — invoked by InteractiveSessionHandle.stop(). */
5517
5500
  _stopInteractive(id: string): Promise<void>;
5518
5501
  /** @internal — invoked by SandboxSession.respondToPermission(). */
5519
- _respondToPermission(id: string, permissionID: string, options: RespondToPermissionOptions): Promise<PermissionResponseResult>;
5502
+ _respondToPermission(id: string, permissionID: string, options: RespondToPermissionOptions): Promise<void>;
5520
5503
  /** @internal — invoked by SandboxSession.interrupt(). */
5521
5504
  _interrupt(id: string): Promise<InterruptResult>;
5522
- /** @internal — invoked by SandboxSession.answer(). */
5505
+ /**
5506
+ * @internal — invoked by SandboxSession.answer(). Resolves the session's
5507
+ * outstanding question interaction and posts the answer through the
5508
+ * interaction response route. The positional answer arrays map onto the
5509
+ * question's `answerSpec` fields in order.
5510
+ */
5523
5511
  _answerQuestion(id: string, answers: Record<string, string[]>): Promise<void>;
5524
5512
  }
5525
5513
  //#endregion
5526
- export { CreateRequestOptions as $, SandboxFleetToken as $n, WaitForOptions as $r, MkdirOptions as $t, AddUserOptions as A, SSHCommandDescriptor as An, SessionStatus as Ar, ForkOptions as At, BatchResult as B, SandboxFleetDispatchResponse as Bn, TaskResult as Br, HostAgentRuntimeBackend as Bt, SandboxMcpConfig as C, PublishPublicTemplateOptions as Cn, SearchOptions as Cr, FleetDispatchResultBufferOptions as Ct, buildSandboxMcpConfig as D, ReconcileSandboxFleetsOptions as Dn, SessionInfo as Dr, FleetMachineId as Dt, buildControlPlaneMcpConfig as E, ReapExpiredSandboxFleetsResult as En, SessionEventStreamOptions as Er, FleetExecDispatchResult as Et, BackendManager as F, SandboxEvent as Fn, StartupDiagnostics as Fr, GitConfig as Ft, CheckpointResult as G, SandboxFleetMachine as Gn, TeePublicKeyResponse as Gr, IntelligenceReportSubjectType as Gt, BatchTaskResult as H, SandboxFleetDriverTimings as Hn, TeeAttestationReport as Hr, IntelligenceReport as Ht, BackendStatus as I, SandboxFleetArtifact as In, StartupOperation as Ir, GitDiff as It, CodeLanguage as J, SandboxFleetMachineSpec as Jn, TurnDriveResult as Jr, ListOptions as Jt, CodeExecutionOptions as K, SandboxFleetMachineMeteredUsage as Kn, TokenRefreshHandler as Kr, IntelligenceReportWindow as Kt, BackendType as L, SandboxFleetArtifactSpec as Ln, StorageConfig as Lr, GitStatus as Lt, BackendCapabilities as M, SandboxClientConfig as Mn, SnapshotOptions as Mr, GitAuth as Mt, BackendConfig as N, SandboxConnection as Nn, SnapshotResult as Nr, GitBranch as Nt, AcceleratorKind as O, ReconcileSandboxFleetsResult as On, SessionListOptions as Or, FleetPromptDispatchOptions as Ot, BackendInfo as P, SandboxEnvironment as Pn, SshKeysManager as Pr, GitCommit as Pt, CreateIntelligenceReportOptions as Q, SandboxFleetPolicy as Qn, UsageInfo as Qr, MintScopedTokenOptions as Qt, BatchEvent as R, SandboxFleetCostEstimate as Rn, SubscriptionInfo as Rr, GpuType as Rt, SANDBOX_MCP_SERVER_NAME as S, PublicTemplateVersionInfo as Sn, SearchMatch as Sr, FleetDispatchResultBuffer as St, SandboxMcpServerEntry as T, ReapExpiredSandboxFleetsOptions as Tn, SecretsManager as Tr, FleetExecDispatchOptions as Tt, CheckpointInfo as U, SandboxFleetInfo as Un, TeeAttestationResponse as Ur, IntelligenceReportBudget as Ut, BatchTask as V, SandboxFleetDriverCapability as Vn, TeeAttestationOptions as Vr, InstalledTool as Vt, CheckpointOptions as W, SandboxFleetIntelligenceEnvelope as Wn, TeePublicKey as Wr, IntelligenceReportCompareTo as Wt, CodeResultPart as X, SandboxFleetManifestMachine as Xn, UploadOptions as Xr, ListSandboxOptions as Xt, CodeResult as Y, SandboxFleetManifest as Yn, UpdateUserOptions as Yr, ListSandboxFleetOptions as Yt, CompletedTurnResult as Z, SandboxFleetOperationsSummary as Zn, UploadProgress as Zr, McpServerConfig as Zt, RespondToPermissionOptions as _, defineGitHubResource as _i, ProvisionEvent as _n, SandboxTraceExport as _r, ExecOptions as _t, TraceExportSink as a, AgentProfileConnection as ai, PreviewLinkInfo as an, SandboxFleetWorkspace as ar, DirectoryPermission as at, BuildSandboxMcpConfigOptions as b, ProvisionStep as bn, ScopedToken as br, FileSystem as bt, otelTraceIdForTangleTrace as c, AgentProfileModelHints as ci, ProcessInfo as cn, SandboxFleetWorkspaceSnapshotResult as cr, DownloadOptions as ct, InteractiveAuthFile as d, AgentProfileResourceRef as di, ProcessSignal as dn, SandboxPermissionsConfig as dr, DriverConfig as dt, WriteManyFile as ei, NetworkConfig as en, SandboxFleetTraceBundle as er, CreateSandboxFleetOptions as et, InteractiveSessionHandle as f, AgentProfileResources as fi, ProcessSpawnOptions as fn, SandboxResourceUsage as fr, DriverInfo as ft, PermissionResponseResult as g, defineAgentProfile as gi, PromptResult as gn, SandboxTraceEvent as gr, EventStreamOptions as gt, InterruptResult as h, AgentSubagentProfile as hi, PromptOptions as hn, SandboxTraceBundle as hr, EgressPolicy as ht, TraceExportResult as i, AgentProfileConfidential as ii, PermissionsManager as in, SandboxFleetUsage as ir, DeleteOptions as it, AttachSandboxFleetMachineOptions as j, SSHCredentials as jn, SnapshotInfo as jr, ForkResult as jt, AccessPolicyRule as k, RunCodeOptions as kn, SessionMessage as kr, FleetPromptDispatchResult as kt, toOtelJson as l, AgentProfilePermissionValue as li, ProcessLogEntry as ln, SandboxInfo as lr, DownloadProgress as lt, InteractiveSessionInfo as m, AgentProfileValidationResult as mi, PromptInputPart as mn, SandboxStatus as mr, EgressManager as mt, SandboxInstance as n, AgentProfile as ni, NonHostAgentDriverConfig as nn, SandboxFleetTraceExport as nr, CreateSandboxFleetWithCoordinatorOptions as nt, buildTraceExportPayload as o, AgentProfileFileMount as oi, PreviewLinkManager as on, SandboxFleetWorkspaceReconcileResult as or, DispatchPromptOptions as ot, InteractiveSessionHost as p, AgentProfileValidationIssue as pi, ProcessStatus as pn, SandboxResources as pr, DriverType as pt, CodeExecutionResult as q, SandboxFleetMachineRecord as qn, ToolsConfig as qr, ListMessagesOptions as qt, TraceExportFormat as r, AgentProfileCapabilities as ri, PermissionLevel as rn, SandboxFleetTraceOptions as rr, CreateSandboxOptions as rt, exportTraceBundle as s, AgentProfileMcpServer as si, Process as sn, SandboxFleetWorkspaceRestoreResult as sr, DispatchedSession as st, HttpClient as t, WriteManyOptions as ti, NetworkManager as tn, SandboxFleetTraceEvent as tr, CreateSandboxFleetTokenOptions as tt, SandboxSession as u, AgentProfilePrompt as ui, ProcessManager as un, SandboxIntelligenceEnvelope as ur, DriveTurnOptions as ut, StartInteractiveOptions as v, defineInlineResource as vi, ProvisionResult as vn, SandboxTraceOptions as vr, ExecResult as vt, SandboxMcpEndpoint as w, PublishPublicTemplateVersionOptions as wn, SecretInfo as wr, FleetDispatchStreamOptions as wt, CONTROL_PLANE_MCP_SERVER_NAME as x, PublicTemplateInfo as xn, ScopedTokenScope as xr, FleetDispatchCancelResult as xt, BuildControlPlaneMcpConfigOptions as y, mergeAgentProfiles as yi, ProvisionStatus as yn, SandboxUser as yr, FileInfo as yt, BatchOptions as z, SandboxFleetDispatchFailureClass as zn, TaskOptions as zr, HostAgentDriverConfig as zt };
5514
+ export { CreateSandboxFleetOptions as $, SandboxFleetTraceBundle as $n, WriteManyFile as $r, NetworkConfig as $t, AttachSandboxFleetMachineOptions as A, SSHCredentials as An, SnapshotInfo as Ar, ForkResult as At, BatchTask as B, SandboxFleetDriverCapability as Bn, TeeAttestationOptions as Br, InstalledTool as Bt, SandboxMcpEndpoint as C, PublishPublicTemplateVersionOptions as Cn, SecretInfo as Cr, FleetDispatchStreamOptions as Ct, AcceleratorKind as D, ReconcileSandboxFleetsResult as Dn, SessionListOptions as Dr, FleetPromptDispatchOptions as Dt, buildSandboxMcpConfig as E, ReconcileSandboxFleetsOptions as En, SessionInfo as Er, FleetMachineId as Et, BackendStatus as F, SandboxFleetArtifact as Fn, StartupOperation as Fr, GitDiff as Ft, CodeExecutionOptions as G, SandboxFleetMachineMeteredUsage as Gn, TokenRefreshHandler as Gr, IntelligenceReportWindow as Gt, CheckpointInfo as H, SandboxFleetInfo as Hn, TeeAttestationResponse as Hr, IntelligenceReportBudget as Ht, BackendType as I, SandboxFleetArtifactSpec as In, StorageConfig as Ir, GitStatus as It, CodeResult as J, SandboxFleetManifest as Jn, UpdateUserOptions as Jr, ListSandboxFleetOptions as Jt, CodeExecutionResult as K, SandboxFleetMachineRecord as Kn, ToolsConfig as Kr, ListMessagesOptions as Kt, BatchEvent as L, SandboxFleetCostEstimate as Ln, SubscriptionInfo as Lr, GpuType as Lt, BackendConfig as M, SandboxConnection as Mn, SnapshotResult as Mr, GitBranch as Mt, BackendInfo as N, SandboxEnvironment as Nn, SshKeysManager as Nr, GitCommit as Nt, AccessPolicyRule as O, RunCodeOptions as On, SessionMessage as Or, FleetPromptDispatchResult as Ot, BackendManager as P, SandboxEvent as Pn, StartupDiagnostics as Pr, GitConfig as Pt, CreateRequestOptions as Q, SandboxFleetToken as Qn, WaitForOptions as Qr, MkdirOptions as Qt, BatchOptions as R, SandboxFleetDispatchFailureClass as Rn, TaskOptions as Rr, HostAgentDriverConfig as Rt, SandboxMcpConfig as S, PublishPublicTemplateOptions as Sn, SearchOptions as Sr, FleetDispatchResultBufferOptions as St, buildControlPlaneMcpConfig as T, ReapExpiredSandboxFleetsResult as Tn, SessionEventStreamOptions as Tr, FleetExecDispatchResult as Tt, CheckpointOptions as U, SandboxFleetIntelligenceEnvelope as Un, TeePublicKey as Ur, IntelligenceReportCompareTo as Ut, BatchTaskResult as V, SandboxFleetDriverTimings as Vn, TeeAttestationReport as Vr, IntelligenceReport as Vt, CheckpointResult as W, SandboxFleetMachine as Wn, TeePublicKeyResponse as Wr, IntelligenceReportSubjectType as Wt, CompletedTurnResult as X, SandboxFleetOperationsSummary as Xn, UploadProgress as Xr, McpServerConfig as Xt, CodeResultPart as Y, SandboxFleetManifestMachine as Yn, UploadOptions as Yr, ListSandboxOptions as Yt, CreateIntelligenceReportOptions as Z, SandboxFleetPolicy as Zn, UsageInfo as Zr, MintScopedTokenOptions as Zt, StartInteractiveOptions as _, defineInlineResource as _i, ProvisionResult as _n, SandboxTraceOptions as _r, ExecResult as _t, TraceExportSink as a, AgentProfileFileMount as ai, PreviewLinkManager as an, SandboxFleetWorkspaceReconcileResult as ar, DispatchPromptOptions as at, CONTROL_PLANE_MCP_SERVER_NAME as b, PublicTemplateInfo as bn, ScopedTokenScope as br, FleetDispatchCancelResult as bt, otelTraceIdForTangleTrace as c, AgentProfilePermissionValue as ci, ProcessLogEntry as cn, SandboxInfo as cr, DownloadProgress as ct, InteractiveAuthFile as d, AgentProfileResources as di, ProcessSpawnOptions as dn, SandboxResourceUsage as dr, DriverInfo as dt, WriteManyOptions as ei, NetworkManager as en, SandboxFleetTraceEvent as er, CreateSandboxFleetTokenOptions as et, InteractiveSessionHandle as f, AgentProfileValidationIssue as fi, ProcessStatus as fn, SandboxResources as fr, DriverType as ft, RespondToPermissionOptions as g, defineGitHubResource as gi, ProvisionEvent as gn, SandboxTraceExport as gr, ExecOptions as gt, InterruptResult as h, defineAgentProfile as hi, PromptResult as hn, SandboxTraceEvent as hr, EventStreamOptions as ht, TraceExportResult as i, AgentProfileConnection as ii, PreviewLinkInfo as in, SandboxFleetWorkspace as ir, DirectoryPermission as it, BackendCapabilities as j, SandboxClientConfig as jn, SnapshotOptions as jr, GitAuth as jt, AddUserOptions as k, SSHCommandDescriptor as kn, SessionStatus as kr, ForkOptions as kt, toOtelJson as l, AgentProfilePrompt as li, ProcessManager as ln, SandboxIntelligenceEnvelope as lr, DriveTurnOptions as lt, InteractiveSessionInfo as m, AgentSubagentProfile as mi, PromptOptions as mn, SandboxTraceBundle as mr, EgressPolicy as mt, SandboxInstance as n, AgentProfileCapabilities as ni, PermissionLevel as nn, SandboxFleetTraceOptions as nr, CreateSandboxOptions as nt, buildTraceExportPayload as o, AgentProfileMcpServer as oi, Process as on, SandboxFleetWorkspaceRestoreResult as or, DispatchedSession as ot, InteractiveSessionHost as p, AgentProfileValidationResult as pi, PromptInputPart as pn, SandboxStatus as pr, EgressManager as pt, CodeLanguage as q, SandboxFleetMachineSpec as qn, TurnDriveResult as qr, ListOptions as qt, TraceExportFormat as r, AgentProfileConfidential as ri, PermissionsManager as rn, SandboxFleetUsage as rr, DeleteOptions as rt, exportTraceBundle as s, AgentProfileModelHints as si, ProcessInfo as sn, SandboxFleetWorkspaceSnapshotResult as sr, DownloadOptions as st, HttpClient as t, AgentProfile as ti, NonHostAgentDriverConfig as tn, SandboxFleetTraceExport as tr, CreateSandboxFleetWithCoordinatorOptions as tt, SandboxSession as u, AgentProfileResourceRef as ui, ProcessSignal as un, SandboxPermissionsConfig as ur, DriverConfig as ut, BuildControlPlaneMcpConfigOptions as v, mergeAgentProfiles as vi, ProvisionStatus as vn, SandboxUser as vr, FileInfo as vt, SandboxMcpServerEntry as w, ReapExpiredSandboxFleetsOptions as wn, SecretsManager as wr, FleetExecDispatchOptions as wt, SANDBOX_MCP_SERVER_NAME as x, PublicTemplateVersionInfo as xn, SearchMatch as xr, FleetDispatchResultBuffer as xt, BuildSandboxMcpConfigOptions as y, ProvisionStep as yn, ScopedToken as yr, FileSystem as yt, BatchResult as z, SandboxFleetDispatchResponse as zn, TaskResult as zr, HostAgentRuntimeBackend as zt };