@tangle-network/agent-runtime 0.300.0 → 0.306.1

package/dist/{workspace-archive-pz8YJ1fr.d.ts → workspace-streams-CpSmt3zx.d.ts}

@@ -20,8 +20,16 @@ interface AgentCandidateArtifactPort {
   readStream?(ref: AgentCandidateArtifactRef, options?: {
     signal?: AbortSignal;
   }): AsyncIterable<Uint8Array>;
+  /**
+   * The stored object with exactly this digest and length, or undefined when the store holds
+   * none. It finds an object by its content alone, so a workspace stored one object per file can
+   * skip every file the store already holds, and be read back from its manifest.
+   */
+  locate?(object: Pick<AgentCandidateArtifactRef, 'sha256' | 'byteLength'>, options?: {
+    signal?: AbortSignal;
+  }): Promise<AgentCandidateArtifactRef | undefined>;
 }
-type AgentCandidateOutputPurpose = 'execution-plan' | 'materialization-receipt' | 'candidate-workspace-manifest' | 'candidate-workspace-archive' | 'task-manifest' | 'task-archive' | 'task-patch' | 'task-output' | 'task-outcome' | 'memory-after-manifest' | 'memory-after-archive' | 'grader-evidence' | 'benchmark-result' | 'model-settlement' | 'trace' | 'executor-native-evidence' | 'executor-capture' | 'run-receipt' | 'knowledge-retrieval-config' | 'knowledge-evaluation' | 'failure-evidence';
+type AgentCandidateOutputPurpose = 'execution-plan' | 'materialization-receipt' | 'candidate-workspace-manifest' | 'candidate-workspace-archive' | 'candidate-workspace-file' | 'task-manifest' | 'task-archive' | 'task-patch' | 'task-output' | 'task-outcome' | 'memory-after-manifest' | 'memory-after-archive' | 'grader-evidence' | 'benchmark-result' | 'model-settlement' | 'trace' | 'executor-native-evidence' | 'executor-capture' | 'run-receipt' | 'knowledge-retrieval-config' | 'knowledge-evaluation' | 'failure-evidence';
 /** Durable content-addressed evidence store controlled only by the evaluator. */
 interface AgentCandidateOutputArtifactPort extends AgentCandidateArtifactPort {
   /** Consume all chunks before publishing; preserve put's identity and cancellation guarantees. */
@@ -550,5 +558,61 @@ declare function captureAgentCandidateWorkspaceFiles(input: readonly AgentCandid
 /** Create the standard bounded materializer for candidate execution ports. */
 declare function createAgentCandidateWorkspacePort(options?: CreateAgentCandidateWorkspacePortOptions): AgentCandidateWorkspacePort;
 //#endregion
-export { AgentCandidateProtectedModelSettlement as A, CanonicalCandidateDocument as B, AgentCandidateMemoryResetResult as C, AgentCandidateOutputPurpose as D, AgentCandidateOutputArtifactPort as E, AgentCandidateTaskExecution as F, PreparedAgentCandidateLaunch as G, PreparedAgentCandidateExecution as H, AgentCandidateVerificationPorts as I, VerifiedAgentCandidate as J, PreparedAgentCandidateTrace as K, AgentCandidateWorkspacePort as L, AgentCandidateProtectedRunCapture as M, AgentCandidateRepositoryPort as N, AgentCandidateProtectedModelActivation as O, AgentCandidateRunFinalization as P, CANDIDATE_TRACE_ENV as R, AgentCandidateMemoryPort as S, AgentCandidateModelPort as T, PreparedAgentCandidateInstruction as U, PersistedTaskOutcomeEvidence as V, PreparedAgentCandidateKnowledge as W, AgentCandidateExecutionRoots as X, VerifiedAgentCandidateTaskOutcome as Y, AgentCandidateExecutorRequest as _, captureAgentCandidateWorkspace as a, AgentCandidateExecutorWorkspaceFile as b, AgentCandidateArtifactPort as c, AgentCandidateContainerPort as d, AgentCandidateExecutionPorts as f, AgentCandidateExecutorProfileFile as g, AgentCandidateExecutorPort as h, CreateAgentCandidateWorkspacePortOptions as i, AgentCandidateProtectedModelSettlementCall as j, AgentCandidateProtectedModelReservation as k, AgentCandidateBenchmarkGraderIdentity as l, AgentCandidateExecutorMemoryCapture as m, CaptureAgentCandidateWorkspaceOptions as n, captureAgentCandidateWorkspaceFiles as o, AgentCandidateExecutorFinalCapture as p, ResolvedAgentCandidateContainer as q, CapturedAgentCandidateWorkspace as r, createAgentCandidateWorkspacePort as s, AgentCandidateWorkspaceArchiveLimits as t, AgentCandidateBenchmarkGraderPort as u, AgentCandidateExecutorStopRequest as v, AgentCandidateModelLimits as w, AgentCandidateExecutorWorkspaceInput as x, AgentCandidateExecutorTaskOutcomeCapture as y, CANDIDATE_TRACE_TAGS as z };
-//# sourceMappingURL=workspace-archive-pz8YJ1fr.d.ts.map
+//#region src/candidate-execution/workspace-streams.d.ts
+interface CaptureAgentCandidateWorkspaceToArtifactsOptions {
+  limits?: Partial<AgentCandidateWorkspaceArchiveLimits>;
+  artifactPersistence: NonNullable<CaptureAgentCandidateWorkspaceOptions['artifactPersistence']>;
+}
+/** Capture regular files to durable artifacts with memory bounded by the manifest and stream buffers. */
+declare function captureAgentCandidateWorkspaceToArtifacts(rootInput: string, options: CaptureAgentCandidateWorkspaceToArtifactsOptions): Promise<{
+  readonly snapshot: AgentCandidateWorkspaceSnapshotEvidence;
+}>;
+/**
+ * A workspace stored as one content-addressed object per file plus the manifest that names them.
+ *
+ * Its digest is the manifest's, the same identity an archived capture of the same files has. Two
+ * trees share every file they have in common, so storing one costs only the files no earlier
+ * capture in the store holds: on Discovery Lab run terraform-dc-tokens-20261006d, the files a
+ * director changed between two captures one to two minutes apart were 5.5 to 8.2 MB of a
+ * 60 to 70 MB workspace.
+ */
+interface AgentCandidateWorkspaceTree {
+  readonly kind: 'agent-candidate-workspace-tree';
+  /** The manifest's digest; the manifest is the object of this digest. */
+  readonly digest: Sha256Digest;
+  readonly manifest: AgentCandidateArtifactRef;
+  readonly files: number;
+  /** The bytes of every file in the workspace. */
+  readonly bytes: number;
+  /** The bytes this capture added to the store; every other file was already there. */
+  readonly storedBytes: number;
+}
+/**
+ * Store a workspace as a tree: each regular file the store does not already hold, then the
+ * manifest. The store must find objects by content (`locate`) and stream them.
+ */
+declare function captureAgentCandidateWorkspaceTreeToArtifacts(rootInput: string, options: CaptureAgentCandidateWorkspaceToArtifactsOptions): Promise<AgentCandidateWorkspaceTree>;
+/**
+ * Read a tree back by its digest and confirm the store holds every file it names. Returns the
+ * manifest; reading a file is `artifacts.read` of what `locate` returns for its digest.
+ */
+declare function verifyAgentCandidateWorkspaceTree(tree: Pick<AgentCandidateWorkspaceTree, 'digest' | 'manifest'>, artifacts: AgentCandidateArtifactPort, options?: {
+  limits?: Partial<AgentCandidateWorkspaceArchiveLimits>;
+  signal?: AbortSignal;
+}): Promise<AgentCandidateWorkspaceManifestMaterial>;
+interface AgentCandidateWorkspaceArtifactsOptions {
+  role: 'task' | 'candidate' | 'knowledge' | 'memory';
+  snapshot: AgentCandidateWorkspaceSnapshotEvidence;
+  artifacts: AgentCandidateArtifactPort;
+  limits?: Partial<AgentCandidateWorkspaceArchiveLimits>;
+  signal?: AbortSignal;
+}
+/** Verify durable regular-file workspace evidence without retaining archive or file contents. */
+declare function verifyAgentCandidateWorkspaceArtifacts(input: AgentCandidateWorkspaceArtifactsOptions): Promise<void>;
+/** Restore regular-file artifacts into an empty destination, publishing only after complete verification. */
+declare function materializeAgentCandidateWorkspaceFromArtifacts(input: AgentCandidateWorkspaceArtifactsOptions & {
+  destination: string;
+}): Promise<void>;
+//#endregion
+export { PreparedAgentCandidateLaunch as $, AgentCandidateMemoryPort as A, AgentCandidateProtectedRunCapture as B, AgentCandidateExecutorPort as C, AgentCandidateExecutorTaskOutcomeCapture as D, AgentCandidateExecutorStopRequest as E, AgentCandidateOutputPurpose as F, AgentCandidateWorkspacePort as G, AgentCandidateRunFinalization as H, AgentCandidateProtectedModelActivation as I, CanonicalCandidateDocument as J, CANDIDATE_TRACE_ENV as K, AgentCandidateProtectedModelReservation as L, AgentCandidateModelLimits as M, AgentCandidateModelPort as N, AgentCandidateExecutorWorkspaceFile as O, AgentCandidateOutputArtifactPort as P, PreparedAgentCandidateKnowledge as Q, AgentCandidateProtectedModelSettlement as R, AgentCandidateExecutorMemoryCapture as S, AgentCandidateExecutorRequest as T, AgentCandidateTaskExecution as U, AgentCandidateRepositoryPort as V, AgentCandidateVerificationPorts as W, PreparedAgentCandidateExecution as X, PersistedTaskOutcomeEvidence as Y, PreparedAgentCandidateInstruction as Z, AgentCandidateBenchmarkGraderIdentity as _, captureAgentCandidateWorkspaceTreeToArtifacts as a, AgentCandidateExecutionPorts as b, verifyAgentCandidateWorkspaceTree as c, CapturedAgentCandidateWorkspace as d, PreparedAgentCandidateTrace as et, CreateAgentCandidateWorkspacePortOptions as f, AgentCandidateArtifactPort as g, createAgentCandidateWorkspacePort as h, captureAgentCandidateWorkspaceToArtifacts as i, AgentCandidateExecutionRoots as it, AgentCandidateMemoryResetResult as j, AgentCandidateExecutorWorkspaceInput as k, AgentCandidateWorkspaceArchiveLimits as l, captureAgentCandidateWorkspaceFiles as m, AgentCandidateWorkspaceTree as n, VerifiedAgentCandidate as nt, materializeAgentCandidateWorkspaceFromArtifacts as o, captureAgentCandidateWorkspace as p, CANDIDATE_TRACE_TAGS as q, CaptureAgentCandidateWorkspaceToArtifactsOptions as r, VerifiedAgentCandidateTaskOutcome as rt, verifyAgentCandidateWorkspaceArtifacts as s, AgentCandidateWorkspaceArtifactsOptions as t, ResolvedAgentCandidateContainer as tt, CaptureAgentCandidateWorkspaceOptions as u, AgentCandidateBenchmarkGraderPort as v, AgentCandidateExecutorProfileFile as w, AgentCandidateExecutorFinalCapture as x, AgentCandidateContainerPort as y, AgentCandidateProtectedModelSettlementCall as z };
+//# sourceMappingURL=workspace-streams-CpSmt3zx.d.ts.map