@tangle-network/agent-interface 0.51.0 → 0.52.0

package/README.md

@@ -9,6 +9,7 @@ shapes; higher-level packages import from here rather than redefining them.
 
 `AgentRunControlRef` identifies a retained run without depending on a live JavaScript object and may carry the provider's admission digest so reconstruction can reject changed-input reuse.
 `RuntimeEventEnvelope` adds stable run, event, sequence, cursor, and timestamp fields around the existing `StreamEvent` union, and its runtime schema validates every canonical event variant.
+The canonical `cancelled` status identifies caller cancellation and remains distinct from `failed`.
 Providers advertise `retainedControl` only when exact run, result, event, cancellation, replay, detach, turn, and session identity are all implemented together.
 `AgentEnvironment.metadata` is the detached snapshot returned by create or get, so recovery can check persisted annotations without listing environments.
 Metadata can include caller-authored values and does not prove authorization or authorship.

package/dist/environment-terminal.d.ts

@@ -147,11 +147,23 @@ export declare function terminalSessionUsable(ref: TerminalSessionRef, nowIso: s
 /** Bind an attach result to the parent execution and terminal it targeted. */
 export declare function terminalAttachResultMatchesRequest(request: TerminalAttachRequest, result: TerminalAttachResult): boolean;
 /**
- * Live handle for one interactive terminal. Signatures only; a provider adapter
- * binds the transport in phase two.
+ * The replay cursors a terminal handle can serve.
+ *
+ * `earliest` is the oldest cursor `events` accepts and `latest` is the newest
+ * frame the handle holds. A handle retains a bounded number of frames, so a
+ * consumer that holds no cursor, or holds one the handle dropped, reads this
+ * window to resume from a cursor that still exists.
  */
+export declare const TerminalReplayWindowSchema: z.ZodObject<{
+    earliest: z.ZodNumber;
+    latest: z.ZodNumber;
+}, z.core.$strict>;
+export type TerminalReplayWindow = z.infer<typeof TerminalReplayWindowSchema>;
+/** Live handle for one interactive terminal. */
 export interface AgentTerminalSession {
     readonly ref: TerminalSessionRef;
+    /** Cursors this handle can serve, so an evicted cursor is recoverable. */
+    readonly cursors: TerminalReplayWindow;
     input(input: TerminalInput, options?: {
         signal?: AbortSignal;
     }): Promise<void>;

package/dist/environment-terminal.js

@@ -160,3 +160,15 @@ export function terminalAttachResultMatchesRequest(request, result) {
     }
     return true;
 }
+/**
+ * The replay cursors a terminal handle can serve.
+ *
+ * `earliest` is the oldest cursor `events` accepts and `latest` is the newest
+ * frame the handle holds. A handle retains a bounded number of frames, so a
+ * consumer that holds no cursor, or holds one the handle dropped, reads this
+ * window to resume from a cursor that still exists.
+ */
+export const TerminalReplayWindowSchema = z.strictObject({
+    earliest: z.number().int().nonnegative(),
+    latest: z.number().int().nonnegative(),
+});

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, 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, 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, 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, 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/runtime-control.js

@@ -291,7 +291,13 @@ export const CanonicalStreamEventSchema = z.discriminatedUnion("type", [
     }),
     z.strictObject({
         type: z.literal("status"),
-        status: z.enum(["started", "processing", "completed", "failed"]),
+        status: z.enum([
+            "started",
+            "processing",
+            "completed",
+            "failed",
+            "cancelled",
+        ]),
         detail: boundedStringSchema.optional(),
     }),
     z.strictObject({

package/dist/stream-events.d.ts

@@ -6,6 +6,7 @@ export type MessagePartUpdatedEvent = {
     part: Part;
     delta?: string;
 };
+export type StreamStatus = "started" | "processing" | "completed" | "failed" | "cancelled";
 export type StreamEvent = MessagePartUpdatedEvent | {
     type: "tool-heartbeat";
     toolName: string;
@@ -24,7 +25,7 @@ export type StreamEvent = MessagePartUpdatedEvent | {
     elapsedMs?: number;
 } | {
     type: "status";
-    status: "started" | "processing" | "completed" | "failed";
+    status: StreamStatus;
     detail?: string;
 } | {
     type: "warning";

package/package.json

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