@tangle-network/agent-interface 0.36.0 → 0.38.0

package/dist/agent-candidate-artifact-schema.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { agentCandidateGitHubRepositorySchema, gitObjectSchema, isSafeRelativePath, isWellFormedUnicode, looksLikeCredential, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
+import { agentImprovementSourceSchema } from "./agent-improvement-source.js";
 const base64Alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 const s3BucketPattern = /^(?!\d+\.\d+\.\d+\.\d+$)[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/;
 const awsRegionPattern = /^[a-z]{2}(?:-gov)?-[a-z]+-\d$/;
@@ -156,6 +157,16 @@ export function validateEmbeddedArtifact(artifact, ctx) {
         });
     }
 }
+function validateResourceSourceDigest(resource, ctx) {
+    if (resource.source !== undefined &&
+        resource.source.sourceDigest !== resource.sha256) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["source", "sourceDigest"],
+            message: "resource source digest must equal the frozen resource digest",
+        });
+    }
+}
 export const agentCandidateInlineResourceSchema = z
     .object({
     kind: z.literal("inline"),
@@ -163,6 +174,7 @@ export const agentCandidateInlineResourceSchema = z
     content: z.string().refine(isWellFormedUnicode),
     sha256: sha256DigestSchema,
     byteLength: z.number().int().nonnegative(),
+    source: agentImprovementSourceSchema.optional(),
 })
     .strict()
     .superRefine((resource, ctx) => {
@@ -173,6 +185,7 @@ export const agentCandidateInlineResourceSchema = z
             message: "byteLength must match UTF-8 content",
         });
     }
+    validateResourceSourceDigest(resource, ctx);
 });
 export const agentCandidateGitHubResourceSchema = z
     .object({
@@ -185,8 +198,10 @@ export const agentCandidateGitHubResourceSchema = z
     name: z.string().min(1).refine(isWellFormedUnicode).optional(),
     sha256: sha256DigestSchema,
     byteLength: z.number().int().nonnegative(),
+    source: agentImprovementSourceSchema.optional(),
 })
-    .strict();
+    .strict()
+    .superRefine(validateResourceSourceDigest);
 export const agentCandidateResourceRefSchema = z.discriminatedUnion("kind", [
     agentCandidateInlineResourceSchema,
     agentCandidateGitHubResourceSchema,

package/dist/agent-candidate-execution-plan-schema.d.ts

@@ -587,11 +587,10 @@ export declare const agentCandidateProfilePlanEvidenceSchema: z.ZodObject<{
     }, z.core.$strict>]>;
 }, z.core.$strict>;
 export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"agent-candidate-profile-activation">;
-    profilePlan: z.ZodObject<{
-        kind: z.ZodLiteral<"agent-profile-workspace-plan">;
-        digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-        material: z.ZodType<{
+    profilePlan: z.ZodType<{
+        kind: "agent-profile-workspace-plan";
+        digest: `sha256:${string}`;
+        material: {
             sourceProfileDigest: `sha256:${string}`;
             harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
             files: {
@@ -615,7 +614,30 @@ export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
                 kind: "public";
                 value: string;
             } | undefined;
-        }, unknown, z.core.$ZodTypeInternals<{
+        };
+        artifact: {
+            locator: {
+                kind: "s3";
+                bucket: string;
+                key: string;
+                region?: string | undefined;
+            } | {
+                kind: "ipfs";
+                cid: string;
+                path?: string | undefined;
+            };
+            sha256: `sha256:${string}`;
+            byteLength: number;
+        } | {
+            encoding: "base64";
+            content: string;
+            sha256: `sha256:${string}`;
+            byteLength: number;
+        };
+    }, unknown, z.core.$ZodTypeInternals<{
+        kind: "agent-profile-workspace-plan";
+        digest: `sha256:${string}`;
+        material: {
             sourceProfileDigest: `sha256:${string}`;
             harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
             files: {
@@ -639,33 +661,34 @@ export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
                 kind: "public";
                 value: string;
             } | undefined;
-        }, unknown>>;
-        artifact: z.ZodUnion<readonly [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>], "kind">;
-            sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            byteLength: z.ZodNumber;
-        }, z.core.$strict>, z.ZodObject<{
-            encoding: z.ZodLiteral<"base64">;
-            content: z.ZodString;
-            sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
-            byteLength: z.ZodNumber;
-        }, z.core.$strict>]>;
-    }, z.core.$strict>;
+        };
+        artifact: {
+            locator: {
+                kind: "s3";
+                bucket: string;
+                key: string;
+                region?: string | undefined;
+            } | {
+                kind: "ipfs";
+                cid: string;
+                path?: string | undefined;
+            };
+            sha256: `sha256:${string}`;
+            byteLength: number;
+        } | {
+            encoding: "base64";
+            content: string;
+            sha256: `sha256:${string}`;
+            byteLength: number;
+        };
+    }, unknown>>;
     files: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         mode: z.ZodNumber;
         content: z.ZodString;
     }, z.core.$strict>>;
     digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+    kind: z.ZodLiteral<"agent-candidate-profile-activation">;
 }, z.core.$strict>;
 export declare const agentCandidateExecutionPlanEvidenceSchema: z.ZodObject<{
     kind: z.ZodLiteral<"agent-candidate-execution-plan">;

package/dist/agent-candidate-execution-plan-schema.js

@@ -2,8 +2,9 @@ import { z } from "zod";
 import { agentCandidateArtifactRefSchema, agentCandidateCapturedArtifactSchema, agentCandidateWorkspaceSnapshotEvidenceSchema, } from "./agent-candidate-artifact-schema.js";
 import { agentCandidateContainerSchema, agentCandidateInstructionDeliverySchema, agentCandidateWorkingDirectorySchema, } from "./agent-candidate-code-schema.js";
 import { reasoningEffortSchema } from "./profile-schema.js";
-import { addDuplicateIssues, agentCandidateConfigValueSchema, agentCandidateMediaTypeSchema, environmentConfigSchema, gitObjectSchema, isCanonicalJsonValue, isObviouslyPrivateHostname, isSafeExecutable, isSafeRelativePath, isWellFormedUnicode, sameGitObjectFormat, sha256Utf8, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
+import { addDuplicateIssues, agentCandidateConfigValueSchema, agentCandidateMediaTypeSchema, environmentConfigSchema, gitObjectSchema, isCanonicalJsonValue, isObviouslyPrivateHostname, isSafeExecutable, isSafeRelativePath, sameGitObjectFormat, sha256Utf8, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
 import { harnessTypeSchema } from "./harness.js";
+import { createAgentProfileActivationEvidenceSchema } from "./agent-profile-activation.js";
 function isCanonicalAbsolutePath(value) {
     return (value.startsWith("/") &&
         value !== "/" &&
@@ -471,22 +472,9 @@ function planEvidenceSchema(kind, material) {
     });
 }
 export const agentCandidateProfilePlanEvidenceSchema = planEvidenceSchema("agent-profile-workspace-plan", agentCandidateProfilePlanMaterialSchema);
-export const agentCandidateProfileActivationSchema = z
-    .object({
+export const agentCandidateProfileActivationSchema = createAgentProfileActivationEvidenceSchema(agentCandidateProfilePlanEvidenceSchema)
+    .extend({
     kind: z.literal("agent-candidate-profile-activation"),
-    profilePlan: agentCandidateProfilePlanEvidenceSchema,
-    files: z.array(z
-        .object({
-        path: z
-            .string()
-            .refine((value) => isSafeRelativePath(value, false), "profile activation file must use a canonical relative path"),
-        mode: z.number().int().min(0).max(0o777),
-        content: z
-            .string()
-            .refine(isWellFormedUnicode, "profile activation content must be valid Unicode"),
-    })
-        .strict()),
-    digest: sha256DigestSchema,
 })
     .strict()
     .superRefine((activation, ctx) => {