@tangle-network/agent-interface 5.0.0 → 5.1.0

package/dist/agent-candidate.d.ts

@@ -37,6 +37,18 @@ export interface AgentCandidateArtifactRef {
     sha256: Sha256Digest;
     byteLength: number;
 }
+/** Reads one content-addressed object through an authorized closed-locator resolver. */
+export interface AgentCandidateArtifactPort {
+    read(ref: AgentCandidateArtifactRef): Promise<Uint8Array>;
+    /** Stream an artifact without materializing its complete contents. */
+    readStream?(ref: AgentCandidateArtifactRef, options?: {
+        signal?: AbortSignal;
+    }): AsyncIterable<Uint8Array>;
+    /** Find an already stored object by its exact content digest and length. */
+    locate?(object: Pick<AgentCandidateArtifactRef, "sha256" | "byteLength">, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentCandidateArtifactRef | undefined>;
+}
 /** Bytes embedded directly in a candidate manifest. */
 export interface AgentCandidateEmbeddedArtifact {
     encoding: "base64";

package/dist/environment-runtime.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import type { AgentRuntimeAttachments } from "./runtime-attachments.js";
 export { AgentRuntimeAttachmentsSchema, type AgentRuntimeAttachments } from "./runtime-attachments.js";
-import type { Sha256Digest } from "./agent-candidate.js";
+import type { AgentCandidateArtifactPort, Sha256Digest } from "./agent-candidate.js";
 import type { AgentProfile, AgentProfileCapabilities, AgentProfileValidationResult } from "./agent-profile.js";
 import type { InputPart } from "./parts.js";
 import type { StreamEvent } from "./stream-events.js";
@@ -1358,13 +1358,15 @@ export interface AgentEnvironmentCapabilities {
         /** The provider exposes the exact continued run before terminal output. */
         admissionControl?: boolean;
     };
-    /** Present only when fresh-session portable context transfer is durable. */
+    /** Durable portable-context lookup and independently qualified fresh-session admission. */
     contextTransfer?: {
         freshSession: boolean;
         requestIdempotency: boolean;
         lookup: boolean;
         /** get(id, { contextTransfer }) verifies the durable receipt and enables only its first turn. */
         attach?: boolean;
+        /** Restores accepted snapshot refs before native admission. Absent or false means unsupported. */
+        workspaceSnapshot?: boolean;
     };
     /** Absent when the provider cannot originate or answer interactions. */
     interactions?: InteractionCapabilities;
@@ -1521,6 +1523,7 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
         requestIdempotency: z.ZodBoolean;
         lookup: z.ZodBoolean;
         attach: z.ZodOptional<z.ZodBoolean>;
+        workspaceSnapshot: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     interactions: z.ZodOptional<z.ZodObject<{
         kinds: z.ZodArray<z.ZodString>;
@@ -2185,6 +2188,8 @@ export interface AgentEnvironmentProvider {
 export interface AgentContextTransferProvider {
     transfer(request: ContextTransferRequest, options?: {
         signal?: AbortSignal;
+        /** Authorized source artifacts for this attempt; never part of the accepted wire request. */
+        artifacts?: AgentCandidateArtifactPort;
     }): Promise<ContextTransferResult>;
     lookup(request: ContextTransferRequest, options?: {
         signal?: AbortSignal;

package/dist/environment-runtime.js

@@ -199,6 +199,7 @@ export const AgentEnvironmentCapabilitiesSchema = z
         requestIdempotency: z.boolean(),
         lookup: z.boolean(),
         attach: z.boolean().optional(),
+        workspaceSnapshot: z.boolean().optional(),
     })
         .optional(),
     interactions: InteractionCapabilitiesSchema.optional(),
@@ -318,14 +319,16 @@ export const AgentEnvironmentCapabilitiesSchema = z
             message: "native continuation requires retained control for early admission",
         });
     }
-    if (capabilities.contextTransfer !== undefined &&
-        (!capabilities.contextTransfer.freshSession ||
-            !capabilities.contextTransfer.requestIdempotency ||
-            !capabilities.contextTransfer.lookup)) {
+    const contextTransfer = capabilities.contextTransfer;
+    if (contextTransfer !== undefined &&
+        (!contextTransfer.lookup ||
+            (contextTransfer.freshSession && !contextTransfer.requestIdempotency) ||
+            ((contextTransfer.attach === true || contextTransfer.workspaceSnapshot === true) &&
+                (!contextTransfer.freshSession || !contextTransfer.requestIdempotency)))) {
         refinement.addIssue({
             code: "custom",
             path: ["contextTransfer"],
-            message: "context transfer requires fresh-session admission, request idempotency, and lookup together",
+            message: "context transfer requires durable lookup; fresh admission, attachment, and snapshot transfer require fresh-session admission and request idempotency together",
         });
     }
     const durableBranching = [

package/package.json

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