@tangle-network/agent-interface 3.2.0 → 5.0.0

package/dist/workspace-snapshot.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import type { AgentCandidateArtifactRef, Sha256Digest } from "./agent-candidate.js";
+import { type AgentWorkspaceLeaseRecord } from "./agent-workspace-lease.js";
+/** Public source binding. A lease identifier or artifact locator grants no authority. */
+export type AgentWorkspaceSnapshotSource = Pick<AgentWorkspaceLeaseRecord, "leaseId" | "workspace" | "sourceSnapshotDigest" | "sourceSnapshotPolicy"> & {
+    leaseRecordDigest: Sha256Digest;
+};
+/**
+ * Reference-only projection of the canonical candidate workspace archive.
+ * Runtime resolves and verifies the canonical manifest and archive before restore. The manifest
+ * digest binds file bytes and modes; the archive hash additionally binds Git HEAD and index state.
+ * Capture requires the source owner's private lease. Acceptance binds this complete value, not
+ * only `digest`. Receivers authorize each closed artifact reference for the accepted operation.
+ */
+export interface AgentWorkspaceSnapshotRef {
+    kind: "agent-candidate-workspace-snapshot";
+    digest: Sha256Digest;
+    manifest: AgentCandidateArtifactRef;
+    archive: AgentCandidateArtifactRef;
+    source: AgentWorkspaceSnapshotSource;
+}
+export declare const AgentWorkspaceSnapshotRefSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
+    digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+    manifest: z.ZodObject<{
+        locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"s3">;
+            bucket: z.ZodString;
+            key: z.ZodString;
+            region: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"ipfs">;
+            cid: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"private-cas">;
+            namespace: z.ZodString;
+            digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        }, z.core.$strict>], "kind">;
+        sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        byteLength: z.ZodNumber;
+    }, z.core.$strict>;
+    archive: z.ZodObject<{
+        locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"s3">;
+            bucket: z.ZodString;
+            key: z.ZodString;
+            region: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"ipfs">;
+            cid: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"private-cas">;
+            namespace: z.ZodString;
+            digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        }, z.core.$strict>], "kind">;
+        sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        byteLength: z.ZodNumber;
+    }, z.core.$strict>;
+    source: z.ZodObject<{
+        leaseId: z.ZodString;
+        leaseRecordDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        workspace: z.ZodObject<{
+            provider: z.ZodString;
+            root: z.ZodString;
+            identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        }, z.core.$strict>;
+        sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        sourceSnapshotPolicy: z.ZodObject<{
+            kind: z.ZodLiteral<"provider-declared">;
+            name: z.ZodString;
+            version: z.ZodNumber;
+            digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Acceptance identity of the complete reference, including Git archive and source binding. */
+export declare function agentWorkspaceSnapshotRefDigest(snapshot: AgentWorkspaceSnapshotRef): Sha256Digest;

package/dist/workspace-snapshot.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { agentCandidateArtifactRefSchema } from "./agent-candidate-artifact-schema.js";
+import { canonicalCandidateDigest, sha256DigestSchema } from "./agent-candidate-schema-common.js";
+import { agentWorkspaceAllocationIdentitySchema, } from "./agent-workspace-lease.js";
+import { agentWorkspacePublicIdentifierSchema, agentWorkspaceSourceSnapshotPolicySchema, } from "./agent-workspace-source-snapshot.js";
+const nonemptyArtifactRefSchema = agentCandidateArtifactRefSchema.superRefine((ref, ctx) => {
+    if (!Number.isSafeInteger(ref.byteLength) || ref.byteLength < 1) {
+        ctx.addIssue({ code: "custom", path: ["byteLength"], message: "workspace artifact length must be a positive safe integer" });
+    }
+});
+export const AgentWorkspaceSnapshotRefSchema = z.strictObject({
+    kind: z.literal("agent-candidate-workspace-snapshot"),
+    digest: sha256DigestSchema,
+    manifest: nonemptyArtifactRefSchema,
+    archive: nonemptyArtifactRefSchema,
+    source: z.strictObject({
+        leaseId: agentWorkspacePublicIdentifierSchema,
+        leaseRecordDigest: sha256DigestSchema,
+        workspace: agentWorkspaceAllocationIdentitySchema,
+        sourceSnapshotDigest: sha256DigestSchema,
+        sourceSnapshotPolicy: agentWorkspaceSourceSnapshotPolicySchema,
+    }),
+}).superRefine((snapshot, ctx) => {
+    if (snapshot.digest !== snapshot.manifest.sha256) {
+        ctx.addIssue({ code: "custom", path: ["manifest", "sha256"], message: "workspace digest must equal the canonical manifest hash" });
+    }
+});
+/** Acceptance identity of the complete reference, including Git archive and source binding. */
+export function agentWorkspaceSnapshotRefDigest(snapshot) {
+    return canonicalCandidateDigest(AgentWorkspaceSnapshotRefSchema.parse(snapshot));
+}

package/package.json

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