@tangle-network/agent-provider-tangle 0.14.1 → 0.14.3

package/dist/tangle-types.d.ts

@@ -1,5 +1,5 @@
 import type { BackendRegistryEntry, BackendRegistryResponse, BackendType, CreateSandboxOptions, ExecResult as SandboxExecResult, PromptOptions, PromptResult, SandboxEvent } from "@tangle-network/sandbox";
-import type { AgentRunCancellationAcknowledgement, AgentRunCancellationRequest, AgentExecutionPreparationReceipt, AgentInteractiveSessionControlClaim, AgentInteractiveSessionControlClaimAcknowledgement, AgentInteractiveSessionControlClaimRequest, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionStopAcknowledgement, AgentInteractiveSessionStopCommand, AgentProfile, ConfidentialAttestation, ConfidentialExecutionEnvironment, InputPart, InteractionRequest, InteractionResponseCommand } from "@tangle-network/agent-interface";
+import type { AgentRunCancellationAcknowledgement, AgentRunCancellationRequest, AgentInteractiveSessionControlClaim, AgentInteractiveSessionControlClaimAcknowledgement, AgentInteractiveSessionControlClaimRequest, AgentInteractiveSessionAttach, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionRef, AgentInteractiveSessionStart, AgentInteractiveSessionStatus, AgentInteractiveSessionStopAcknowledgement, AgentInteractiveSessionStopCommand, AgentInteractiveTerminalSession, ConfidentialAttestation, ConfidentialExecutionEnvironment, InputPart, InteractionRequest, InteractionResponseCommand } from "@tangle-network/agent-interface";
 import type { AgentEnvironmentCapabilities, AgentEnvironmentProvider, CreateAgentEnvironmentInput } from "@tangle-network/agent-interface/environment-provider";
 /**
  * The platform verdict for the create call that returned a sandbox.
@@ -335,57 +335,45 @@ export interface SandboxTerminalsLike {
         handlers?: SandboxTerminalHandlersLike;
     }): Promise<SandboxTerminalStreamLike>;
 }
-/** Identity returned by the Sandbox exact interactive-session route. */
-export interface SandboxInteractiveSessionIdentityLike {
-    sessionId: string;
-    harness: BackendType;
-    startedAt: string;
-    /** Provider-issued process incarnation. Replays return this exact value. */
-    incarnationId: string;
-    /** Canonical provider admission receipt for the effective route. */
-    preparationReceipt: AgentExecutionPreparationReceipt;
-}
-/** Start acknowledgement from the canonical Sandbox interactive API. */
-export interface SandboxInteractiveSessionInfoLike extends SandboxInteractiveSessionIdentityLike {
-    streamUrl: string;
-}
-/** Lifecycle returned by the Sandbox exact interactive-session route. */
-export type SandboxInteractiveSessionStatusLike = (SandboxInteractiveSessionInfoLike & {
+/** Start result returned by the Sandbox exact interactive-session route. */
+export type SandboxInteractiveSessionStartResultLike = {
     state: "running";
-}) | (SandboxInteractiveSessionIdentityLike & {
+    ref: AgentInteractiveSessionRef;
+    control: AgentInteractiveSessionControlClaim;
+    streamUrl: string;
+} | {
     state: "exited";
+    ref: AgentInteractiveSessionRef;
+    control: AgentInteractiveSessionControlClaim;
     endedAt: string;
     exitCode?: number;
     exitSignal?: string;
     reason: "exited" | "stopped" | "lost";
-});
+};
 /** Existing Sandbox SDK handle for one coding harness's native TUI. */
 export interface SandboxInteractiveSessionLike {
-    start(options: {
-        harness: BackendType;
-        model?: string;
-        cwd?: string;
-        cols?: number;
-        rows?: number;
-        profile: AgentProfile;
-        initialPrompt?: string;
-        /** Derived from the exact run; owned by the Sandbox creation ledger. */
-        idempotencyKey: string;
-        /** Exact request digest paired with the idempotency key. */
-        requestDigest: `sha256:${string}`;
-    }): Promise<SandboxInteractiveSessionInfoLike>;
-    claimControl(request: AgentInteractiveSessionControlClaimRequest): Promise<AgentInteractiveSessionControlClaimAcknowledgement>;
-    status(): Promise<SandboxInteractiveSessionStatusLike | null>;
-    attach(options: {
-        control: AgentInteractiveSessionControlClaim;
-        cols?: number;
-        rows?: number;
-        handlers?: SandboxTerminalHandlersLike;
-    }): Promise<SandboxTerminalStreamLike>;
-    /** Validate the current generation before each PTY mutation. */
-    validateControl(control: AgentInteractiveSessionControlClaim): Promise<void>;
-    sendPrompt(command: AgentInteractiveSessionPromptCommand): Promise<AgentInteractiveSessionPromptAcknowledgement>;
-    stop(command: AgentInteractiveSessionStopCommand): Promise<AgentInteractiveSessionStopAcknowledgement>;
+    start(request: AgentInteractiveSessionStart, options?: {
+        signal?: AbortSignal;
+    }): Promise<SandboxInteractiveSessionStartResultLike>;
+    claimControl(request: AgentInteractiveSessionControlClaimRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentInteractiveSessionControlClaimAcknowledgement>;
+    status(options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentInteractiveSessionStatus | null>;
+    attachAgentTerminal(request: AgentInteractiveSessionAttach, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentInteractiveTerminalSession>;
+    /** Confirm that this claim is still the current writable generation. */
+    validateControl(control: AgentInteractiveSessionControlClaim, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    sendPrompt(command: AgentInteractiveSessionPromptCommand, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentInteractiveSessionPromptAcknowledgement>;
+    stop(command: AgentInteractiveSessionStopCommand, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentInteractiveSessionStopAcknowledgement>;
 }
 export interface SandboxInstanceLike {
     id: string;
@@ -502,7 +490,10 @@ export interface SandboxInstanceLike {
 export interface SandboxSessionLike {
     readonly id: string;
     /** Exact native coding-agent TUI bound to this session id. */
-    interactive?(): unknown;
+    interactive?(options?: {
+        ref?: AgentInteractiveSessionRef;
+        control?: AgentInteractiveSessionControlClaim;
+    }): unknown;
     status(options?: {
         signal?: AbortSignal;
     }): Promise<unknown | null>;