@tangle-network/agent-interface 0.25.0 → 0.26.1

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

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { agentCandidateArtifactRefSchema, agentCandidateCapturedArtifactSchema, agentCandidateWorkspaceSnapshotEvidenceSchema, } from "./agent-candidate-artifact-schema.js";
 import { agentCandidateResolvedModelSchema } from "./agent-candidate-execution-plan-schema.js";
-import { gitObjectSchema, isCanonicalJsonValue, sameGitObjectFormat, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
+import { agentCandidateMediaTypeSchema, gitObjectSchema, isCanonicalJsonValue, sameGitObjectFormat, sha256DigestSchema, } from "./agent-candidate-schema-common.js";
 const safeCountSchema = z
     .number()
     .int()
@@ -24,18 +24,6 @@ export const agentCandidateFixedSpendSchema = z
 })
     .strict();
 export const agentCandidateModelSettlementCallSchema = z
-    .object({
-    callId: boundedIdentifierSchema,
-    traceSpanId: boundedIdentifierSchema,
-    model: boundedIdentifierSchema,
-    inputTokens: safeCountSchema,
-    outputTokens: safeCountSchema,
-    cachedInputTokens: safeCountSchema,
-    reasoningTokens: safeCountSchema,
-    costUsdNanos: safeCountSchema,
-})
-    .strict();
-export const agentCandidateModelSettlementCallV2Schema = z
     .object({
     callId: boundedIdentifierSchema,
     generationId: boundedIdentifierSchema,
@@ -76,26 +64,14 @@ const modelSettlementMaterialShape = {
     resolved: agentCandidateResolvedModelSchema,
     usage: agentCandidateFixedSpendSchema,
 };
-export const agentCandidateModelSettlementMaterialV1Schema = z
-    .object({
-    schemaVersion: z.literal(1),
-    ...modelSettlementMaterialShape,
-    calls: z.array(agentCandidateModelSettlementCallSchema),
-})
-    .strict()
-    .superRefine(refineModelSettlementMaterial);
-export const agentCandidateModelSettlementMaterialV2Schema = z
+export const agentCandidateModelSettlementMaterialSchema = z
     .object({
     schemaVersion: z.literal(2),
     ...modelSettlementMaterialShape,
-    calls: z.array(agentCandidateModelSettlementCallV2Schema),
+    calls: z.array(agentCandidateModelSettlementCallSchema),
 })
     .strict()
     .superRefine(refineModelSettlementMaterial);
-export const agentCandidateModelSettlementMaterialSchema = z.union([
-    agentCandidateModelSettlementMaterialV1Schema,
-    agentCandidateModelSettlementMaterialV2Schema,
-]);
 function refineModelSettlementMaterial(material, ctx) {
     const callIds = new Set();
     const traceSpanIds = new Set();
@@ -125,19 +101,14 @@ function refineModelSettlementMaterial(material, ctx) {
             });
         }
         traceSpanIds.add(call.traceSpanId);
-        const generationId = "generationId" in call && typeof call.generationId === "string"
-            ? call.generationId
-            : undefined;
-        if (generationId !== undefined) {
-            if (generationIds.has(generationId)) {
-                ctx.addIssue({
-                    code: "custom",
-                    path: ["calls", index, "generationId"],
-                    message: "model settlement generation ids must be unique",
-                });
-            }
-            generationIds.add(generationId);
+        if (generationIds.has(call.generationId)) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["calls", index, "generationId"],
+                message: "model settlement generation ids must be unique",
+            });
         }
+        generationIds.add(call.generationId);
         if (call.model !== material.resolved.model) {
             ctx.addIssue({
                 code: "custom",
@@ -179,7 +150,7 @@ function refineModelSettlementMaterial(material, ctx) {
         });
     }
 }
-export const agentCandidateModelSettlementEvidenceSchema = evidenceSchema("agent-candidate-model-settlement", agentCandidateModelSettlementMaterialSchema, "model settlement");
+export const agentCandidateModelSettlementEvidenceSchema = evidenceSchema(2, "agent-candidate-model-settlement", agentCandidateModelSettlementMaterialSchema, "model settlement");
 export const agentCandidateRepositoryStateSchema = z
     .object({
     identity: z.string().min(1),
@@ -199,42 +170,82 @@ export const agentCandidateRepositoryStateSchema = z
 });
 export const agentCandidateTaskOutcomeMaterialSchema = z
     .object({
-    schemaVersion: z.literal(1),
+    schemaVersion: z.literal(2),
     kind: z.literal("agent-candidate-task-outcome-material"),
     executionPlanDigest: sha256DigestSchema,
-    baseRepository: agentCandidateRepositoryStateSchema,
-    resultRepository: agentCandidateRepositoryStateSchema,
-    afterState: agentCandidateWorkspaceSnapshotEvidenceSchema,
-    gitDiff: z
-        .object({
-        format: z.literal("git-diff-binary"),
-        artifact: agentCandidateArtifactRefSchema,
-    })
-        .strict(),
+    outcome: z.discriminatedUnion("kind", [
+        z
+            .object({
+            kind: z.literal("workspace"),
+            baseRepository: agentCandidateRepositoryStateSchema,
+            resultRepository: agentCandidateRepositoryStateSchema,
+            afterState: agentCandidateWorkspaceSnapshotEvidenceSchema,
+            gitDiff: z
+                .object({
+                format: z.literal("git-diff-binary"),
+                artifact: agentCandidateArtifactRefSchema,
+            })
+                .strict(),
+        })
+            .strict(),
+        z
+            .object({
+            kind: z.literal("output"),
+            spec: z
+                .object({
+                mediaType: agentCandidateMediaTypeSchema,
+                maxBytes: z.number().int().positive().max(64 * 1024 * 1024),
+            })
+                .strict(),
+            artifact: agentCandidateArtifactRefSchema,
+        })
+            .strict(),
+    ]),
 })
     .strict()
     .superRefine((material, ctx) => {
-    if (material.baseRepository.identity !== material.resultRepository.identity) {
+    if (material.outcome.kind === "workspace" &&
+        material.outcome.baseRepository.identity !==
+            material.outcome.resultRepository.identity) {
         ctx.addIssue({
             code: "custom",
-            path: ["resultRepository", "identity"],
+            path: ["outcome", "resultRepository", "identity"],
             message: "base and result repository identities must match",
         });
     }
-    if (material.baseRepository.rootIdentity !==
-        material.resultRepository.rootIdentity) {
+    if (material.outcome.kind === "workspace" &&
+        material.outcome.baseRepository.rootIdentity !==
+            material.outcome.resultRepository.rootIdentity) {
         ctx.addIssue({
             code: "custom",
-            path: ["resultRepository", "rootIdentity"],
+            path: ["outcome", "resultRepository", "rootIdentity"],
             message: "base and result repository roots must match",
         });
     }
-    if (!sameGitObjectFormat(material.baseRepository.commit, material.resultRepository.commit) ||
-        !sameGitObjectFormat(material.baseRepository.tree, material.resultRepository.tree)) {
+    if (material.outcome.kind === "workspace") {
+        if (!sameGitObjectFormat(material.outcome.baseRepository.commit, material.outcome.resultRepository.commit) ||
+            !sameGitObjectFormat(material.outcome.baseRepository.tree, material.outcome.resultRepository.tree)) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["outcome", "resultRepository"],
+                message: "base and result repositories must use one Git object format",
+            });
+        }
+    }
+    if (material.outcome.kind === "output" &&
+        material.outcome.artifact.byteLength === 0) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["outcome", "artifact"],
+            message: "task outcome artifact cannot be empty",
+        });
+    }
+    if (material.outcome.kind === "output" &&
+        material.outcome.artifact.byteLength > material.outcome.spec.maxBytes) {
         ctx.addIssue({
             code: "custom",
-            path: ["resultRepository"],
-            message: "base and result repositories must use one Git object format",
+            path: ["outcome", "artifact", "byteLength"],
+            message: "task outcome artifact exceeds its signed byte limit",
         });
     }
     if (!isCanonicalJsonValue(material)) {
@@ -244,7 +255,7 @@ export const agentCandidateTaskOutcomeMaterialSchema = z
         });
     }
 });
-export const agentCandidateTaskOutcomeEvidenceSchema = evidenceSchema("agent-candidate-task-outcome", agentCandidateTaskOutcomeMaterialSchema, "task outcome");
+export const agentCandidateTaskOutcomeEvidenceSchema = evidenceSchema(2, "agent-candidate-task-outcome", agentCandidateTaskOutcomeMaterialSchema, "task outcome");
 export const agentCandidateBenchmarkDimensionSchema = z
     .object({
     name: normalizedDimensionNameSchema,
@@ -318,8 +329,8 @@ export const agentCandidateBenchmarkResultMaterialSchema = z
         });
     }
 });
-export const agentCandidateBenchmarkResultEvidenceSchema = evidenceSchema("agent-candidate-benchmark-result", agentCandidateBenchmarkResultMaterialSchema, "benchmark result");
-export function sameFixedSpend(left, right) {
+export const agentCandidateBenchmarkResultEvidenceSchema = evidenceSchema(1, "agent-candidate-benchmark-result", agentCandidateBenchmarkResultMaterialSchema, "benchmark result");
+function sameFixedSpend(left, right) {
     return (left.inputTokens === right.inputTokens &&
         left.outputTokens === right.outputTokens &&
         left.cachedInputTokens === right.cachedInputTokens &&
@@ -327,10 +338,10 @@ export function sameFixedSpend(left, right) {
         left.modelCalls === right.modelCalls &&
         left.costUsdNanos === right.costUsdNanos);
 }
-function evidenceSchema(kind, material, label) {
+function evidenceSchema(schemaVersion, kind, material, label) {
     return z
         .object({
-        schemaVersion: z.literal(1),
+        schemaVersion: z.literal(schemaVersion),
         kind: z.literal(kind),
         digest: sha256DigestSchema,
         material,