@tangle-network/agent-interface 0.27.2 → 0.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/dist/agent-candidate-artifact-schema.d.ts +0 -3
  2. package/dist/agent-candidate-artifact-schema.js +0 -2
  3. package/dist/agent-candidate-code-schema.d.ts +0 -10
  4. package/dist/agent-candidate-code-schema.js +0 -1
  5. package/dist/agent-candidate-execution-plan-schema.d.ts +173 -382
  6. package/dist/agent-candidate-execution-plan-schema.js +100 -138
  7. package/dist/agent-candidate-lineage-schema.d.ts +1 -31
  8. package/dist/agent-candidate-lineage-schema.js +3 -34
  9. package/dist/agent-candidate-outcome-schema.d.ts +48 -36
  10. package/dist/agent-candidate-outcome-schema.js +23 -32
  11. package/dist/agent-candidate-promotion-schema.d.ts +11021 -2411
  12. package/dist/agent-candidate-promotion-schema.js +495 -109
  13. package/dist/agent-candidate-receipt-schema.d.ts +260 -344
  14. package/dist/agent-candidate-receipt-schema.js +82 -11
  15. package/dist/agent-candidate-schema-common.d.ts +8 -0
  16. package/dist/agent-candidate-schema-common.js +35 -1
  17. package/dist/agent-candidate-schema.d.ts +2 -44
  18. package/dist/agent-candidate-schema.js +3 -29
  19. package/dist/agent-candidate-task-schema.d.ts +643 -0
  20. package/dist/agent-candidate-task-schema.js +191 -0
  21. package/dist/agent-candidate.d.ts +173 -94
  22. package/dist/agent-candidate.test-fixture.d.ts +0 -32
  23. package/dist/agent-candidate.test-fixture.js +0 -32
  24. package/dist/index.d.ts +0 -1
  25. package/dist/index.js +0 -1
  26. package/dist/profile-diff.d.ts +0 -1
  27. package/dist/profile-schema.d.ts +9 -0
  28. package/dist/profile-schema.js +14 -6
  29. package/package.json +2 -2
  30. package/dist/agent-candidate-compat.d.ts +0 -1918
  31. package/dist/agent-candidate-compat.js +0 -340
@@ -1,6 +1,51 @@
1
1
  import { z } from "zod";
2
+ export declare const agentCandidateBenchmarkInputEvidenceSchema: z.ZodObject<{
3
+ suite: z.ZodObject<{
4
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
5
+ material: z.ZodUnion<readonly [z.ZodObject<{
6
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
7
+ kind: z.ZodLiteral<"s3">;
8
+ bucket: z.ZodString;
9
+ key: z.ZodString;
10
+ region: z.ZodOptional<z.ZodString>;
11
+ }, z.core.$strict>, z.ZodObject<{
12
+ kind: z.ZodLiteral<"ipfs">;
13
+ cid: z.ZodString;
14
+ path: z.ZodOptional<z.ZodString>;
15
+ }, z.core.$strict>], "kind">;
16
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
17
+ byteLength: z.ZodNumber;
18
+ }, z.core.$strict>, z.ZodObject<{
19
+ encoding: z.ZodLiteral<"base64">;
20
+ content: z.ZodString;
21
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
22
+ byteLength: z.ZodNumber;
23
+ }, z.core.$strict>]>;
24
+ }, z.core.$strict>;
25
+ task: z.ZodObject<{
26
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
27
+ material: z.ZodUnion<readonly [z.ZodObject<{
28
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
29
+ kind: z.ZodLiteral<"s3">;
30
+ bucket: z.ZodString;
31
+ key: z.ZodString;
32
+ region: z.ZodOptional<z.ZodString>;
33
+ }, z.core.$strict>, z.ZodObject<{
34
+ kind: z.ZodLiteral<"ipfs">;
35
+ cid: z.ZodString;
36
+ path: z.ZodOptional<z.ZodString>;
37
+ }, z.core.$strict>], "kind">;
38
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
39
+ byteLength: z.ZodNumber;
40
+ }, z.core.$strict>, z.ZodObject<{
41
+ encoding: z.ZodLiteral<"base64">;
42
+ content: z.ZodString;
43
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
44
+ byteLength: z.ZodNumber;
45
+ }, z.core.$strict>]>;
46
+ }, z.core.$strict>;
47
+ }, z.core.$strict>;
2
48
  export declare const agentCandidateTraceEvidenceSchema: z.ZodObject<{
3
- schemaVersion: z.ZodLiteral<1>;
4
49
  artifact: z.ZodUnion<readonly [z.ZodObject<{
5
50
  locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
6
51
  kind: z.ZodLiteral<"s3">;
@@ -32,11 +77,9 @@ export declare const agentCandidateMemoryReceiptSchema: z.ZodDiscriminatedUnion<
32
77
  resetEvidenceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
33
78
  beforeStateDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
34
79
  afterState: z.ZodObject<{
35
- schemaVersion: z.ZodLiteral<2>;
36
80
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
37
81
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
38
82
  material: z.ZodObject<{
39
- schemaVersion: z.ZodLiteral<2>;
40
83
  kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
41
84
  files: z.ZodArray<z.ZodObject<{
42
85
  path: z.ZodString;
@@ -98,175 +141,147 @@ export declare const agentCandidateTerminationSchema: z.ZodDiscriminatedUnion<[z
98
141
  kind: z.ZodLiteral<"cancelled">;
99
142
  }, z.core.$strict>], "kind">;
100
143
  export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
101
- schemaVersion: z.ZodLiteral<2>;
102
144
  kind: z.ZodLiteral<"agent-candidate-materialization">;
103
145
  digestAlgorithm: z.ZodLiteral<"rfc8785-sha256">;
104
146
  bundleDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
105
- profilePlan: z.ZodObject<{
106
- schemaVersion: z.ZodLiteral<1>;
107
- kind: z.ZodLiteral<"agent-profile-workspace-plan">;
108
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
109
- material: z.ZodType<{
110
- version: 1;
111
- harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
112
- files: {
113
- relPath: string;
114
- mode: number;
115
- contentSha256: `sha256:${string}`;
116
- }[];
117
- env: Record<string, {
118
- kind: "public";
119
- value: string;
120
- }>;
121
- flags: {
122
- kind: "public";
123
- value: string;
124
- }[];
125
- unsupported: {
126
- dimension: string;
127
- reason: string;
128
- }[];
129
- }, unknown, z.core.$ZodTypeInternals<{
130
- version: 1;
131
- harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
132
- files: {
133
- relPath: string;
134
- mode: number;
135
- contentSha256: `sha256:${string}`;
136
- }[];
137
- env: Record<string, {
138
- kind: "public";
139
- value: string;
140
- }>;
141
- flags: {
142
- kind: "public";
143
- value: string;
144
- }[];
145
- unsupported: {
146
- dimension: string;
147
- reason: string;
148
- }[];
149
- }, unknown>>;
150
- artifact: z.ZodUnion<readonly [z.ZodObject<{
151
- locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
152
- kind: z.ZodLiteral<"s3">;
153
- bucket: z.ZodString;
154
- key: z.ZodString;
155
- region: z.ZodOptional<z.ZodString>;
147
+ benchmark: z.ZodObject<{
148
+ suite: z.ZodObject<{
149
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
150
+ material: z.ZodUnion<readonly [z.ZodObject<{
151
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
152
+ kind: z.ZodLiteral<"s3">;
153
+ bucket: z.ZodString;
154
+ key: z.ZodString;
155
+ region: z.ZodOptional<z.ZodString>;
156
+ }, z.core.$strict>, z.ZodObject<{
157
+ kind: z.ZodLiteral<"ipfs">;
158
+ cid: z.ZodString;
159
+ path: z.ZodOptional<z.ZodString>;
160
+ }, z.core.$strict>], "kind">;
161
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
162
+ byteLength: z.ZodNumber;
156
163
  }, z.core.$strict>, z.ZodObject<{
157
- kind: z.ZodLiteral<"ipfs">;
158
- cid: z.ZodString;
159
- path: z.ZodOptional<z.ZodString>;
160
- }, z.core.$strict>], "kind">;
161
- sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
162
- byteLength: z.ZodNumber;
163
- }, z.core.$strict>, z.ZodObject<{
164
- encoding: z.ZodLiteral<"base64">;
164
+ encoding: z.ZodLiteral<"base64">;
165
+ content: z.ZodString;
166
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
167
+ byteLength: z.ZodNumber;
168
+ }, z.core.$strict>]>;
169
+ }, z.core.$strict>;
170
+ task: z.ZodObject<{
171
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
172
+ material: z.ZodUnion<readonly [z.ZodObject<{
173
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
174
+ kind: z.ZodLiteral<"s3">;
175
+ bucket: z.ZodString;
176
+ key: z.ZodString;
177
+ region: z.ZodOptional<z.ZodString>;
178
+ }, z.core.$strict>, z.ZodObject<{
179
+ kind: z.ZodLiteral<"ipfs">;
180
+ cid: z.ZodString;
181
+ path: z.ZodOptional<z.ZodString>;
182
+ }, z.core.$strict>], "kind">;
183
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
184
+ byteLength: z.ZodNumber;
185
+ }, z.core.$strict>, z.ZodObject<{
186
+ encoding: z.ZodLiteral<"base64">;
187
+ content: z.ZodString;
188
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
189
+ byteLength: z.ZodNumber;
190
+ }, z.core.$strict>]>;
191
+ }, z.core.$strict>;
192
+ }, z.core.$strict>;
193
+ profileActivation: z.ZodObject<{
194
+ kind: z.ZodLiteral<"agent-candidate-profile-activation">;
195
+ profilePlan: z.ZodObject<{
196
+ kind: z.ZodLiteral<"agent-profile-workspace-plan">;
197
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
198
+ material: z.ZodType<{
199
+ sourceProfileDigest: `sha256:${string}`;
200
+ harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
201
+ files: {
202
+ relPath: string;
203
+ mode: number;
204
+ contentSha256: `sha256:${string}`;
205
+ }[];
206
+ env: Record<string, {
207
+ kind: "public";
208
+ value: string;
209
+ }>;
210
+ flags: {
211
+ kind: "public";
212
+ value: string;
213
+ }[];
214
+ unsupported: {
215
+ dimension: string;
216
+ reason: string;
217
+ }[];
218
+ }, unknown, z.core.$ZodTypeInternals<{
219
+ sourceProfileDigest: `sha256:${string}`;
220
+ harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
221
+ files: {
222
+ relPath: string;
223
+ mode: number;
224
+ contentSha256: `sha256:${string}`;
225
+ }[];
226
+ env: Record<string, {
227
+ kind: "public";
228
+ value: string;
229
+ }>;
230
+ flags: {
231
+ kind: "public";
232
+ value: string;
233
+ }[];
234
+ unsupported: {
235
+ dimension: string;
236
+ reason: string;
237
+ }[];
238
+ }, unknown>>;
239
+ artifact: z.ZodUnion<readonly [z.ZodObject<{
240
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
241
+ kind: z.ZodLiteral<"s3">;
242
+ bucket: z.ZodString;
243
+ key: z.ZodString;
244
+ region: z.ZodOptional<z.ZodString>;
245
+ }, z.core.$strict>, z.ZodObject<{
246
+ kind: z.ZodLiteral<"ipfs">;
247
+ cid: z.ZodString;
248
+ path: z.ZodOptional<z.ZodString>;
249
+ }, z.core.$strict>], "kind">;
250
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
251
+ byteLength: z.ZodNumber;
252
+ }, z.core.$strict>, z.ZodObject<{
253
+ encoding: z.ZodLiteral<"base64">;
254
+ content: z.ZodString;
255
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
256
+ byteLength: z.ZodNumber;
257
+ }, z.core.$strict>]>;
258
+ }, z.core.$strict>;
259
+ files: z.ZodArray<z.ZodObject<{
260
+ path: z.ZodString;
261
+ mode: z.ZodNumber;
165
262
  content: z.ZodString;
166
- sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
167
- byteLength: z.ZodNumber;
168
- }, z.core.$strict>]>;
263
+ }, z.core.$strict>>;
264
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
169
265
  }, z.core.$strict>;
170
266
  executionPlan: z.ZodObject<{
171
- schemaVersion: z.ZodLiteral<2>;
172
267
  kind: z.ZodLiteral<"agent-candidate-execution-plan">;
173
268
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
174
269
  material: z.ZodType<{
175
- schemaVersion: 2;
176
270
  kind: "agent-candidate-execution-plan-material";
177
- bundleDigest: `sha256:${string}`;
178
- executionId: string;
179
- attempt: {
180
- number: number;
181
- maxAttempts: number;
182
- retryPolicy: "none" | "pre-model-infrastructure-only";
183
- };
184
- task: {
185
- benchmark: string;
186
- benchmarkVersion: string;
187
- taskId: string;
188
- splitDigest: `sha256:${string}`;
189
- instruction: {
190
- encoding: "utf8";
191
- sha256: `sha256:${string}`;
192
- byteLength: number;
193
- delivery: {
194
- kind: "argv-append";
195
- } | {
196
- kind: "stdin-utf8";
197
- } | {
198
- kind: "utf8-file";
199
- env: "TANGLE_CANDIDATE_TASK_PATH";
200
- path: "/tangle/input/task.txt";
201
- };
202
- };
203
- outcome: {
204
- kind: "workspace";
205
- } | {
206
- kind: "output";
207
- mediaType: string;
208
- maxBytes: number;
209
- };
210
- workspace: {
211
- schemaVersion: 2;
212
- kind: "agent-candidate-workspace-snapshot";
213
- digest: `sha256:${string}`;
214
- material: {
215
- schemaVersion: 2;
216
- kind: "agent-candidate-workspace-manifest";
217
- files: {
218
- path: string;
219
- mode: number;
220
- sha256: `sha256:${string}`;
221
- byteLength: number;
222
- }[];
223
- };
224
- manifest: {
225
- locator: {
226
- kind: "s3";
227
- bucket: string;
228
- key: string;
229
- region?: string | undefined;
230
- } | {
231
- kind: "ipfs";
232
- cid: string;
233
- path?: string | undefined;
234
- };
235
- sha256: `sha256:${string}`;
236
- byteLength: number;
237
- } | {
238
- encoding: "base64";
239
- content: string;
240
- sha256: `sha256:${string}`;
241
- byteLength: number;
242
- };
243
- archive: {
244
- locator: {
245
- kind: "s3";
246
- bucket: string;
247
- key: string;
248
- region?: string | undefined;
249
- } | {
250
- kind: "ipfs";
251
- cid: string;
252
- path?: string | undefined;
253
- };
254
- sha256: `sha256:${string}`;
255
- byteLength: number;
256
- } | {
257
- encoding: "base64";
258
- content: string;
259
- sha256: `sha256:${string}`;
260
- byteLength: number;
261
- };
262
- };
263
- repository?: {
264
- identity: string;
265
- rootIdentity: string;
266
- baseCommit: string;
267
- baseTree: string;
268
- } | undefined;
271
+ runCell: {
272
+ kind: "agent-candidate-run-cell";
273
+ experimentDigest: `sha256:${string}`;
274
+ arm: "candidate" | "baseline";
275
+ bundleDigest: `sha256:${string}`;
276
+ suiteDigest: `sha256:${string}`;
277
+ taskDigest: `sha256:${string}`;
278
+ taskIndex: number;
279
+ repetition: number;
280
+ seed: number;
281
+ attempt: number;
282
+ digest: `sha256:${string}`;
269
283
  };
284
+ executionId: string;
270
285
  workspaces: {
271
286
  taskRoot: string;
272
287
  candidateRoot?: string | undefined;
@@ -279,6 +294,23 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
279
294
  };
280
295
  harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
281
296
  harnessVersion: string;
297
+ instructionDelivery: {
298
+ kind: "argv-append";
299
+ } | {
300
+ kind: "stdin-utf8";
301
+ } | {
302
+ kind: "utf8-file";
303
+ env: "TANGLE_CANDIDATE_TASK_PATH";
304
+ path: "/tangle/input/task.txt";
305
+ };
306
+ limits: {
307
+ timeoutMs: number;
308
+ maxSteps: number;
309
+ maxModelCalls: number;
310
+ maxInputTokens: number;
311
+ maxOutputTokens: number;
312
+ maxCostUsd: number;
313
+ };
282
314
  container: {
283
315
  image: string;
284
316
  indexDigest: `sha256:${string}`;
@@ -325,24 +357,6 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
325
357
  requested: string;
326
358
  })[];
327
359
  };
328
- grader: {
329
- name: string;
330
- version: string;
331
- artifact: {
332
- locator: {
333
- kind: "s3";
334
- bucket: string;
335
- key: string;
336
- region?: string | undefined;
337
- } | {
338
- kind: "ipfs";
339
- cid: string;
340
- path?: string | undefined;
341
- };
342
- sha256: `sha256:${string}`;
343
- byteLength: number;
344
- };
345
- };
346
360
  launch: {
347
361
  executable: string;
348
362
  args: {
@@ -386,11 +400,9 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
386
400
  emptyStateDigest: `sha256:${string}`;
387
401
  };
388
402
  beforeState: {
389
- schemaVersion: 2;
390
403
  kind: "agent-candidate-workspace-snapshot";
391
404
  digest: `sha256:${string}`;
392
405
  material: {
393
- schemaVersion: 2;
394
406
  kind: "agent-candidate-workspace-manifest";
395
407
  files: {
396
408
  path: string;
@@ -442,23 +454,13 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
442
454
  } | {
443
455
  mode: "disabled";
444
456
  };
445
- limits: {
446
- timeoutMs: number;
447
- maxSteps: number;
448
- maxModelCalls: number;
449
- maxInputTokens: number;
450
- maxOutputTokens: number;
451
- maxCostUsd: number;
452
- };
453
457
  network: {
454
458
  mode: "disabled";
455
459
  };
456
460
  candidateWorkspace?: {
457
- schemaVersion: 2;
458
461
  kind: "agent-candidate-workspace-snapshot";
459
462
  digest: `sha256:${string}`;
460
463
  material: {
461
- schemaVersion: 2;
462
464
  kind: "agent-candidate-workspace-manifest";
463
465
  files: {
464
466
  path: string;
@@ -508,101 +510,21 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
508
510
  } | undefined;
509
511
  knowledgeManifestDigest?: `sha256:${string}` | undefined;
510
512
  }, unknown, z.core.$ZodTypeInternals<{
511
- schemaVersion: 2;
512
513
  kind: "agent-candidate-execution-plan-material";
513
- bundleDigest: `sha256:${string}`;
514
- executionId: string;
515
- attempt: {
516
- number: number;
517
- maxAttempts: number;
518
- retryPolicy: "none" | "pre-model-infrastructure-only";
519
- };
520
- task: {
521
- benchmark: string;
522
- benchmarkVersion: string;
523
- taskId: string;
524
- splitDigest: `sha256:${string}`;
525
- instruction: {
526
- encoding: "utf8";
527
- sha256: `sha256:${string}`;
528
- byteLength: number;
529
- delivery: {
530
- kind: "argv-append";
531
- } | {
532
- kind: "stdin-utf8";
533
- } | {
534
- kind: "utf8-file";
535
- env: "TANGLE_CANDIDATE_TASK_PATH";
536
- path: "/tangle/input/task.txt";
537
- };
538
- };
539
- outcome: {
540
- kind: "workspace";
541
- } | {
542
- kind: "output";
543
- mediaType: string;
544
- maxBytes: number;
545
- };
546
- workspace: {
547
- schemaVersion: 2;
548
- kind: "agent-candidate-workspace-snapshot";
549
- digest: `sha256:${string}`;
550
- material: {
551
- schemaVersion: 2;
552
- kind: "agent-candidate-workspace-manifest";
553
- files: {
554
- path: string;
555
- mode: number;
556
- sha256: `sha256:${string}`;
557
- byteLength: number;
558
- }[];
559
- };
560
- manifest: {
561
- locator: {
562
- kind: "s3";
563
- bucket: string;
564
- key: string;
565
- region?: string | undefined;
566
- } | {
567
- kind: "ipfs";
568
- cid: string;
569
- path?: string | undefined;
570
- };
571
- sha256: `sha256:${string}`;
572
- byteLength: number;
573
- } | {
574
- encoding: "base64";
575
- content: string;
576
- sha256: `sha256:${string}`;
577
- byteLength: number;
578
- };
579
- archive: {
580
- locator: {
581
- kind: "s3";
582
- bucket: string;
583
- key: string;
584
- region?: string | undefined;
585
- } | {
586
- kind: "ipfs";
587
- cid: string;
588
- path?: string | undefined;
589
- };
590
- sha256: `sha256:${string}`;
591
- byteLength: number;
592
- } | {
593
- encoding: "base64";
594
- content: string;
595
- sha256: `sha256:${string}`;
596
- byteLength: number;
597
- };
598
- };
599
- repository?: {
600
- identity: string;
601
- rootIdentity: string;
602
- baseCommit: string;
603
- baseTree: string;
604
- } | undefined;
514
+ runCell: {
515
+ kind: "agent-candidate-run-cell";
516
+ experimentDigest: `sha256:${string}`;
517
+ arm: "candidate" | "baseline";
518
+ bundleDigest: `sha256:${string}`;
519
+ suiteDigest: `sha256:${string}`;
520
+ taskDigest: `sha256:${string}`;
521
+ taskIndex: number;
522
+ repetition: number;
523
+ seed: number;
524
+ attempt: number;
525
+ digest: `sha256:${string}`;
605
526
  };
527
+ executionId: string;
606
528
  workspaces: {
607
529
  taskRoot: string;
608
530
  candidateRoot?: string | undefined;
@@ -615,6 +537,23 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
615
537
  };
616
538
  harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
617
539
  harnessVersion: string;
540
+ instructionDelivery: {
541
+ kind: "argv-append";
542
+ } | {
543
+ kind: "stdin-utf8";
544
+ } | {
545
+ kind: "utf8-file";
546
+ env: "TANGLE_CANDIDATE_TASK_PATH";
547
+ path: "/tangle/input/task.txt";
548
+ };
549
+ limits: {
550
+ timeoutMs: number;
551
+ maxSteps: number;
552
+ maxModelCalls: number;
553
+ maxInputTokens: number;
554
+ maxOutputTokens: number;
555
+ maxCostUsd: number;
556
+ };
618
557
  container: {
619
558
  image: string;
620
559
  indexDigest: `sha256:${string}`;
@@ -661,24 +600,6 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
661
600
  requested: string;
662
601
  })[];
663
602
  };
664
- grader: {
665
- name: string;
666
- version: string;
667
- artifact: {
668
- locator: {
669
- kind: "s3";
670
- bucket: string;
671
- key: string;
672
- region?: string | undefined;
673
- } | {
674
- kind: "ipfs";
675
- cid: string;
676
- path?: string | undefined;
677
- };
678
- sha256: `sha256:${string}`;
679
- byteLength: number;
680
- };
681
- };
682
603
  launch: {
683
604
  executable: string;
684
605
  args: {
@@ -722,11 +643,9 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
722
643
  emptyStateDigest: `sha256:${string}`;
723
644
  };
724
645
  beforeState: {
725
- schemaVersion: 2;
726
646
  kind: "agent-candidate-workspace-snapshot";
727
647
  digest: `sha256:${string}`;
728
648
  material: {
729
- schemaVersion: 2;
730
649
  kind: "agent-candidate-workspace-manifest";
731
650
  files: {
732
651
  path: string;
@@ -778,23 +697,13 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
778
697
  } | {
779
698
  mode: "disabled";
780
699
  };
781
- limits: {
782
- timeoutMs: number;
783
- maxSteps: number;
784
- maxModelCalls: number;
785
- maxInputTokens: number;
786
- maxOutputTokens: number;
787
- maxCostUsd: number;
788
- };
789
700
  network: {
790
701
  mode: "disabled";
791
702
  };
792
703
  candidateWorkspace?: {
793
- schemaVersion: 2;
794
704
  kind: "agent-candidate-workspace-snapshot";
795
705
  digest: `sha256:${string}`;
796
706
  material: {
797
- schemaVersion: 2;
798
707
  kind: "agent-candidate-workspace-manifest";
799
708
  files: {
800
709
  path: string;
@@ -865,11 +774,9 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
865
774
  }, z.core.$strict>]>;
866
775
  }, z.core.$strict>;
867
776
  candidateWorkspace: z.ZodOptional<z.ZodObject<{
868
- schemaVersion: z.ZodLiteral<2>;
869
777
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
870
778
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
871
779
  material: z.ZodObject<{
872
- schemaVersion: z.ZodLiteral<2>;
873
780
  kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
874
781
  files: z.ZodArray<z.ZodObject<{
875
782
  path: z.ZodString;
@@ -980,12 +887,17 @@ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
980
887
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
981
888
  }, z.core.$strict>;
982
889
  export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
983
- schemaVersion: z.ZodLiteral<3>;
984
890
  kind: z.ZodLiteral<"agent-candidate-run">;
985
891
  digestAlgorithm: z.ZodLiteral<"rfc8785-sha256">;
986
892
  bundleDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
893
+ runCellDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
987
894
  materializationReceiptDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
988
895
  executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
896
+ timing: z.ZodObject<{
897
+ startedAtMs: z.ZodNumber;
898
+ endedAtMs: z.ZodNumber;
899
+ durationMs: z.ZodNumber;
900
+ }, z.core.$strict>;
989
901
  memory: z.ZodDiscriminatedUnion<[z.ZodObject<{
990
902
  mode: z.ZodLiteral<"disabled">;
991
903
  }, z.core.$strict>, z.ZodObject<{
@@ -995,11 +907,9 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
995
907
  resetEvidenceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
996
908
  beforeStateDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
997
909
  afterState: z.ZodObject<{
998
- schemaVersion: z.ZodLiteral<2>;
999
910
  kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
1000
911
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1001
912
  material: z.ZodObject<{
1002
- schemaVersion: z.ZodLiteral<2>;
1003
913
  kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
1004
914
  files: z.ZodArray<z.ZodObject<{
1005
915
  path: z.ZodString;
@@ -1049,7 +959,6 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1049
959
  }, z.core.$strict>;
1050
960
  }, z.core.$strict>], "mode">;
1051
961
  trace: z.ZodObject<{
1052
- schemaVersion: z.ZodLiteral<1>;
1053
962
  artifact: z.ZodUnion<readonly [z.ZodObject<{
1054
963
  locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
1055
964
  kind: z.ZodLiteral<"s3">;
@@ -1099,7 +1008,6 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1099
1008
  byteLength: z.ZodNumber;
1100
1009
  }, z.core.$strict>;
1101
1010
  modelSettlement: z.ZodObject<{
1102
- schemaVersion: z.ZodLiteral<2>;
1103
1011
  kind: z.ZodLiteral<"agent-candidate-model-settlement">;
1104
1012
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1105
1013
  material: z.ZodType<{
@@ -1137,7 +1045,6 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1137
1045
  modelCalls: number;
1138
1046
  costUsdNanos: number;
1139
1047
  };
1140
- schemaVersion: 2;
1141
1048
  }, unknown, z.core.$ZodTypeInternals<{
1142
1049
  calls: {
1143
1050
  callId: string;
@@ -1173,7 +1080,6 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1173
1080
  modelCalls: number;
1174
1081
  costUsdNanos: number;
1175
1082
  };
1176
- schemaVersion: 2;
1177
1083
  }, unknown>>;
1178
1084
  artifact: z.ZodUnion<readonly [z.ZodObject<{
1179
1085
  locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1196,11 +1102,9 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1196
1102
  }, z.core.$strict>]>;
1197
1103
  }, z.core.$strict>;
1198
1104
  taskOutcome: z.ZodObject<{
1199
- schemaVersion: z.ZodLiteral<2>;
1200
1105
  kind: z.ZodLiteral<"agent-candidate-task-outcome">;
1201
1106
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1202
1107
  material: z.ZodType<{
1203
- schemaVersion: 2;
1204
1108
  kind: "agent-candidate-task-outcome-material";
1205
1109
  executionPlanDigest: `sha256:${string}`;
1206
1110
  outcome: {
@@ -1218,11 +1122,9 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1218
1122
  tree: string;
1219
1123
  };
1220
1124
  afterState: {
1221
- schemaVersion: 2;
1222
1125
  kind: "agent-candidate-workspace-snapshot";
1223
1126
  digest: `sha256:${string}`;
1224
1127
  material: {
1225
- schemaVersion: 2;
1226
1128
  kind: "agent-candidate-workspace-manifest";
1227
1129
  files: {
1228
1130
  path: string;
@@ -1309,7 +1211,6 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1309
1211
  };
1310
1212
  };
1311
1213
  }, unknown, z.core.$ZodTypeInternals<{
1312
- schemaVersion: 2;
1313
1214
  kind: "agent-candidate-task-outcome-material";
1314
1215
  executionPlanDigest: `sha256:${string}`;
1315
1216
  outcome: {
@@ -1327,11 +1228,9 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1327
1228
  tree: string;
1328
1229
  };
1329
1230
  afterState: {
1330
- schemaVersion: 2;
1331
1231
  kind: "agent-candidate-workspace-snapshot";
1332
1232
  digest: `sha256:${string}`;
1333
1233
  material: {
1334
- schemaVersion: 2;
1335
1234
  kind: "agent-candidate-workspace-manifest";
1336
1235
  files: {
1337
1236
  path: string;
@@ -1439,23 +1338,16 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1439
1338
  }, z.core.$strict>]>;
1440
1339
  }, z.core.$strict>;
1441
1340
  benchmarkResult: z.ZodObject<{
1442
- schemaVersion: z.ZodLiteral<1>;
1443
1341
  kind: z.ZodLiteral<"agent-candidate-benchmark-result">;
1444
1342
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1445
1343
  material: z.ZodType<{
1446
- schemaVersion: 1;
1447
1344
  kind: "agent-candidate-benchmark-result-material";
1448
1345
  executionPlanDigest: `sha256:${string}`;
1449
1346
  taskOutcomeDigest: `sha256:${string}`;
1450
- benchmark: {
1451
- name: string;
1452
- version: string;
1453
- taskId: string;
1454
- splitDigest: `sha256:${string}`;
1455
- };
1456
1347
  grader: {
1457
1348
  name: string;
1458
1349
  version: string;
1350
+ format: "tangle-grader";
1459
1351
  artifact: {
1460
1352
  locator: {
1461
1353
  kind: "s3";
@@ -1485,6 +1377,21 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1485
1377
  sha256: `sha256:${string}`;
1486
1378
  byteLength: number;
1487
1379
  };
1380
+ grading: {
1381
+ usage: {
1382
+ inputTokens: number;
1383
+ outputTokens: number;
1384
+ cachedInputTokens: number;
1385
+ reasoningTokens: number;
1386
+ modelCalls: number;
1387
+ costUsdNanos: number;
1388
+ };
1389
+ timing: {
1390
+ startedAtMs: number;
1391
+ endedAtMs: number;
1392
+ durationMs: number;
1393
+ };
1394
+ };
1488
1395
  score: number;
1489
1396
  passed: boolean;
1490
1397
  dimensions: {
@@ -1492,19 +1399,13 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1492
1399
  score: number;
1493
1400
  }[];
1494
1401
  }, unknown, z.core.$ZodTypeInternals<{
1495
- schemaVersion: 1;
1496
1402
  kind: "agent-candidate-benchmark-result-material";
1497
1403
  executionPlanDigest: `sha256:${string}`;
1498
1404
  taskOutcomeDigest: `sha256:${string}`;
1499
- benchmark: {
1500
- name: string;
1501
- version: string;
1502
- taskId: string;
1503
- splitDigest: `sha256:${string}`;
1504
- };
1505
1405
  grader: {
1506
1406
  name: string;
1507
1407
  version: string;
1408
+ format: "tangle-grader";
1508
1409
  artifact: {
1509
1410
  locator: {
1510
1411
  kind: "s3";
@@ -1534,6 +1435,21 @@ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
1534
1435
  sha256: `sha256:${string}`;
1535
1436
  byteLength: number;
1536
1437
  };
1438
+ grading: {
1439
+ usage: {
1440
+ inputTokens: number;
1441
+ outputTokens: number;
1442
+ cachedInputTokens: number;
1443
+ reasoningTokens: number;
1444
+ modelCalls: number;
1445
+ costUsdNanos: number;
1446
+ };
1447
+ timing: {
1448
+ startedAtMs: number;
1449
+ endedAtMs: number;
1450
+ durationMs: number;
1451
+ };
1452
+ };
1537
1453
  score: number;
1538
1454
  passed: boolean;
1539
1455
  dimensions: {