@tangle-network/agent-interface 1.6.0 → 1.7.0

package/dist/environment-runtime.d.ts

@@ -7,7 +7,7 @@ import type { TokenUsage } from "./execution-types.js";
 import { type InteractionAcknowledgement, type InteractionCapabilities, type InteractionResponseCommand, type RequestedInteractions } from "./interaction.js";
 import { type ContextTransferReceipt, type ContextTransferRequest, type NativeContextBoundaryProof, type NativeContextContinuationRequest, type NativeContextContinuationTurn } from "./portable-context.js";
 import { type AgentRunCancellationAcknowledgement, type AgentRunCancellationRequest, type AgentRunControlRef } from "./runtime-control.js";
-import type { AgentWorkspaceBranching } from "./workspace-branching.js";
+import type { AgentWorkspaceBranching, AgentWorkspaceBranchingProvider } 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";
@@ -997,6 +997,15 @@ export declare function createAgentEnvironmentWithIdempotency<T extends object>(
 export interface AgentEnvironmentProvider {
     readonly name: string;
     readonly exactProcess?: AgentExactProcessProvider;
+    /**
+     * Reconstruct a source-scoped branching handle after a coordinator restart.
+     *
+     * This surface is intentionally separate from an environment-owned handle:
+     * lookup and cleanup requests identify operations, not their source. The
+     * provider owns source resolution and the underlying platform calls. A
+     * returned handle is bound to that source and must reject other scopes.
+     */
+    readonly workspaceBranching?: AgentWorkspaceBranchingProvider;
     capabilities(): AgentEnvironmentCapabilities | Promise<AgentEnvironmentCapabilities>;
     validateProfile?(profile: AgentProfileRef): AgentProfileValidationResult | Promise<AgentProfileValidationResult>;
     /**

package/dist/workspace-cleanup.d.ts

@@ -81,5 +81,20 @@ export interface AgentWorkspaceBranching {
         signal?: AbortSignal;
     }): Promise<WorkspaceCleanupAcknowledgement>;
 }
+/**
+ * Provider-level entry point for reconstructing branch operations by source.
+ *
+ * Environment handles are process-local views. A coordinator that restarts
+ * must obtain a fresh source-scoped handle before it looks up or cleans a
+ * checkpoint or fork. The returned handle must reject a resource that does
+ * not belong to its source scope. Providers return null when the source is
+ * absent, the resolved environment id does not match, or the deployment
+ * cannot prove the complete branching surface.
+ */
+export interface AgentWorkspaceBranchingProvider {
+    forEnvironment(sourceEnvironmentId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<AgentWorkspaceBranching | null>;
+}
 /** Bind cleanup confirmation to the exact provider resource and operation. */
 export declare function workspaceCleanupAcknowledgementMatches(request: WorkspaceCleanupRequest, acknowledgement: WorkspaceCleanupAcknowledgement): boolean;

package/package.json

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