@tangle-network/agent-interface 0.54.0 → 0.56.0

package/dist/environment-runtime.d.ts

@@ -10,6 +10,7 @@ import type { AgentWorkspaceBranching } from "./workspace-branching.js";
 import type { AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentProfileRef, AgentSessionStatus, CheckpointRef, CheckpointRequest, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from "./environment-requests.js";
 import type { AgentExactProcessEgressMode, AgentExactProcessProvider } from "./environment-exact-process.js";
 import type { AgentEnvironmentObservation } from "./environment-observation.js";
+import type { AgentInteractiveSession, AgentInteractiveSessionRef, AgentInteractiveSessionStart } from "./environment-interactive.js";
 import type { AgentTerminalSession, TerminalAttachRequest, TerminalAttachResult } from "./environment-terminal.js";
 export interface AgentTurnInput {
     prompt?: string;
@@ -688,6 +689,12 @@ export interface AgentEnvironment {
     terminal?(terminalSessionId: string, options?: {
         signal?: AbortSignal;
     }): AgentTerminalSession;
+    /** Start one native coding-agent TUI bound to an exact admitted run. */
+    startInteractive?(request: AgentInteractiveSessionStart, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentInteractiveSessionRef>;
+    /** Reconstruct the exact native coding-agent TUI named by a durable reference. */
+    interactive?(ref: AgentInteractiveSessionRef): AgentInteractiveSession;
     refresh?(options?: {
         signal?: AbortSignal;
     }): Promise<void>;
@@ -766,6 +773,19 @@ export interface AgentEnvironmentCapabilities {
         resize: boolean;
         reattach: boolean;
     };
+    /** Present only when the provider can start and rediscover exact agent TUIs. */
+    interactiveAgent?: {
+        start: boolean;
+        /** Provider-issued generation claims fence recovered coordinators. */
+        control: boolean;
+        status: boolean;
+        attach: boolean;
+        reattach: boolean;
+        sendPrompt: boolean;
+        input: boolean;
+        resize: boolean;
+        stop: boolean;
+    };
 }
 /** Strict runtime validator for provider capability negotiation. */
 export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
@@ -875,6 +895,17 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
         resize: z.ZodBoolean;
         reattach: z.ZodBoolean;
     }, z.core.$strict>>;
+    interactiveAgent: z.ZodOptional<z.ZodObject<{
+        start: z.ZodBoolean;
+        control: z.ZodBoolean;
+        status: z.ZodBoolean;
+        attach: z.ZodBoolean;
+        reattach: z.ZodBoolean;
+        sendPrompt: z.ZodBoolean;
+        input: z.ZodBoolean;
+        resize: z.ZodBoolean;
+        stop: z.ZodBoolean;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export interface CreateAgentEnvironmentInput {
     profile: AgentProfileRef;

package/dist/environment-runtime.js

@@ -189,6 +189,19 @@ export const AgentEnvironmentCapabilitiesSchema = z
         reattach: z.boolean(),
     })
         .optional(),
+    interactiveAgent: z
+        .strictObject({
+        start: z.boolean(),
+        control: z.boolean(),
+        status: z.boolean(),
+        attach: z.boolean(),
+        reattach: z.boolean(),
+        sendPrompt: z.boolean(),
+        input: z.boolean(),
+        resize: z.boolean(),
+        stop: z.boolean(),
+    })
+        .optional(),
 })
     .superRefine((capabilities, refinement) => {
     if (capabilities.retainedControl !== undefined &&
@@ -249,6 +262,44 @@ export const AgentEnvironmentCapabilitiesSchema = z
             message: "interactive terminal input, resize, and reattach each require attach",
         });
     }
+    const interactiveAgent = capabilities.interactiveAgent;
+    if (interactiveAgent !== undefined &&
+        (interactiveAgent.status ||
+            interactiveAgent.attach ||
+            interactiveAgent.reattach ||
+            interactiveAgent.sendPrompt ||
+            interactiveAgent.input ||
+            interactiveAgent.resize ||
+            interactiveAgent.stop) &&
+        !interactiveAgent.start) {
+        refinement.addIssue({
+            code: "custom",
+            path: ["interactiveAgent"],
+            message: "interactive agent status, attach, reattach, sendPrompt, input, resize, and stop each require start",
+        });
+    }
+    if (interactiveAgent !== undefined &&
+        (interactiveAgent.attach ||
+            interactiveAgent.sendPrompt ||
+            interactiveAgent.input ||
+            interactiveAgent.resize ||
+            interactiveAgent.stop) &&
+        !interactiveAgent.control) {
+        refinement.addIssue({
+            code: "custom",
+            path: ["interactiveAgent", "control"],
+            message: "interactive agent mutation requires provider-issued control claims",
+        });
+    }
+    if (interactiveAgent !== undefined &&
+        (interactiveAgent.reattach || interactiveAgent.input || interactiveAgent.resize) &&
+        !interactiveAgent.attach) {
+        refinement.addIssue({
+            code: "custom",
+            path: ["interactiveAgent"],
+            message: "interactive agent reattach, input, and resize each require attach",
+        });
+    }
     const extensions = capabilities.profile.extensions;
     if (extensions && new Set(extensions).size !== extensions.length) {
         refinement.addIssue({

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export * from "./host-services.js";
 export * from "./mcp.js";
 export * from "./provider-adapter.js";
 export type * from "./environment-provider.js";
-export { AgentEnvironmentCapabilitiesSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, ObservationStateSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, assertObservationCredentialFree, observationContainsCredential, observationOf, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
+export { AgentEnvironmentCapabilitiesSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, ObservationStateSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, assertObservationCredentialFree, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
 export * from "./plan.js";
 export * from "./runtime-control.js";
 export * from "./portable-context.js";

package/dist/index.js

@@ -7,7 +7,7 @@ export * from "./provider-config.js";
 export * from "./host-services.js";
 export * from "./mcp.js";
 export * from "./provider-adapter.js";
-export { AgentEnvironmentCapabilitiesSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, ObservationStateSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, assertObservationCredentialFree, observationContainsCredential, observationOf, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
+export { AgentEnvironmentCapabilitiesSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, ObservationStateSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, assertObservationCredentialFree, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
 export * from "./plan.js";
 export * from "./runtime-control.js";
 export * from "./portable-context.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",