@tangle-network/agent-interface 0.19.0 → 0.21.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.
@@ -0,0 +1,1081 @@
1
+ import { z } from "zod";
2
+ export declare const agentCandidateTraceEvidenceSchema: z.ZodObject<{
3
+ schemaVersion: z.ZodLiteral<1>;
4
+ artifact: z.ZodUnion<readonly [z.ZodObject<{
5
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
6
+ kind: z.ZodLiteral<"s3">;
7
+ bucket: z.ZodString;
8
+ key: z.ZodString;
9
+ region: z.ZodOptional<z.ZodString>;
10
+ }, z.core.$strict>, z.ZodObject<{
11
+ kind: z.ZodLiteral<"ipfs">;
12
+ cid: z.ZodString;
13
+ path: z.ZodOptional<z.ZodString>;
14
+ }, z.core.$strict>], "kind">;
15
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
16
+ byteLength: z.ZodNumber;
17
+ }, z.core.$strict>, z.ZodObject<{
18
+ encoding: z.ZodLiteral<"base64">;
19
+ content: z.ZodString;
20
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
21
+ byteLength: z.ZodNumber;
22
+ }, z.core.$strict>]>;
23
+ eventCount: z.ZodNumber;
24
+ modelCallCount: z.ZodNumber;
25
+ }, z.core.$strict>;
26
+ export declare const agentCandidateModelUsageSchema: z.ZodObject<{
27
+ resolved: z.ZodObject<{
28
+ requested: z.ZodString;
29
+ provider: z.ZodString;
30
+ model: z.ZodString;
31
+ snapshot: z.ZodString;
32
+ reasoningEffort: z.ZodEnum<{
33
+ none: "none";
34
+ minimal: "minimal";
35
+ low: "low";
36
+ medium: "medium";
37
+ high: "high";
38
+ xhigh: "xhigh";
39
+ ultracode: "ultracode";
40
+ }>;
41
+ }, z.core.$strict>;
42
+ usage: z.ZodObject<{
43
+ costUsd: z.ZodNumber;
44
+ inputTokens: z.ZodNumber;
45
+ outputTokens: z.ZodNumber;
46
+ cachedInputTokens: z.ZodOptional<z.ZodNumber>;
47
+ modelCalls: z.ZodNumber;
48
+ }, z.core.$strict>;
49
+ }, z.core.$strict>;
50
+ export declare const agentCandidateMemoryReceiptSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
51
+ mode: z.ZodLiteral<"disabled">;
52
+ }, z.core.$strict>, z.ZodObject<{
53
+ mode: z.ZodLiteral<"isolated">;
54
+ scope: z.ZodLiteral<"task">;
55
+ effectiveNamespace: z.ZodString;
56
+ resetEvidenceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
57
+ beforeStateDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
58
+ afterState: z.ZodObject<{
59
+ schemaVersion: z.ZodLiteral<1>;
60
+ kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
61
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
62
+ material: z.ZodObject<{
63
+ schemaVersion: z.ZodLiteral<1>;
64
+ kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
65
+ files: z.ZodArray<z.ZodObject<{
66
+ path: z.ZodString;
67
+ mode: z.ZodUnion<readonly [z.ZodLiteral<420>, z.ZodLiteral<493>]>;
68
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
69
+ byteLength: z.ZodNumber;
70
+ }, z.core.$strict>>;
71
+ }, z.core.$strict>;
72
+ manifest: z.ZodUnion<readonly [z.ZodObject<{
73
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
74
+ kind: z.ZodLiteral<"s3">;
75
+ bucket: z.ZodString;
76
+ key: z.ZodString;
77
+ region: z.ZodOptional<z.ZodString>;
78
+ }, z.core.$strict>, z.ZodObject<{
79
+ kind: z.ZodLiteral<"ipfs">;
80
+ cid: z.ZodString;
81
+ path: z.ZodOptional<z.ZodString>;
82
+ }, z.core.$strict>], "kind">;
83
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
84
+ byteLength: z.ZodNumber;
85
+ }, z.core.$strict>, z.ZodObject<{
86
+ encoding: z.ZodLiteral<"base64">;
87
+ content: z.ZodString;
88
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
89
+ byteLength: z.ZodNumber;
90
+ }, z.core.$strict>]>;
91
+ archive: z.ZodUnion<readonly [z.ZodObject<{
92
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
93
+ kind: z.ZodLiteral<"s3">;
94
+ bucket: z.ZodString;
95
+ key: z.ZodString;
96
+ region: z.ZodOptional<z.ZodString>;
97
+ }, z.core.$strict>, z.ZodObject<{
98
+ kind: z.ZodLiteral<"ipfs">;
99
+ cid: z.ZodString;
100
+ path: z.ZodOptional<z.ZodString>;
101
+ }, z.core.$strict>], "kind">;
102
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
103
+ byteLength: z.ZodNumber;
104
+ }, z.core.$strict>, z.ZodObject<{
105
+ encoding: z.ZodLiteral<"base64">;
106
+ content: z.ZodString;
107
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
108
+ byteLength: z.ZodNumber;
109
+ }, z.core.$strict>]>;
110
+ }, z.core.$strict>;
111
+ }, z.core.$strict>], "mode">;
112
+ export declare const agentCandidateTerminationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
113
+ kind: z.ZodLiteral<"exit">;
114
+ exitCode: z.ZodNumber;
115
+ }, z.core.$strict>, z.ZodObject<{
116
+ kind: z.ZodLiteral<"timeout">;
117
+ timeoutMs: z.ZodNumber;
118
+ }, z.core.$strict>, z.ZodObject<{
119
+ kind: z.ZodLiteral<"signal">;
120
+ signal: z.ZodString;
121
+ }, z.core.$strict>, z.ZodObject<{
122
+ kind: z.ZodLiteral<"cancelled">;
123
+ }, z.core.$strict>], "kind">;
124
+ export declare const agentCandidateMaterializationReceiptSchema: z.ZodObject<{
125
+ schemaVersion: z.ZodLiteral<1>;
126
+ kind: z.ZodLiteral<"agent-candidate-materialization">;
127
+ digestAlgorithm: z.ZodLiteral<"rfc8785-sha256">;
128
+ bundleDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
129
+ profilePlan: z.ZodObject<{
130
+ schemaVersion: z.ZodLiteral<1>;
131
+ kind: z.ZodLiteral<"agent-profile-workspace-plan">;
132
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
133
+ material: z.ZodType<{
134
+ version: 1;
135
+ harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
136
+ files: {
137
+ relPath: string;
138
+ mode: number;
139
+ contentSha256: `sha256:${string}`;
140
+ }[];
141
+ env: Record<string, {
142
+ kind: "public";
143
+ value: string;
144
+ }>;
145
+ flags: {
146
+ kind: "public";
147
+ value: string;
148
+ }[];
149
+ unsupported: {
150
+ dimension: string;
151
+ reason: string;
152
+ }[];
153
+ }, unknown, z.core.$ZodTypeInternals<{
154
+ version: 1;
155
+ harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
156
+ files: {
157
+ relPath: string;
158
+ mode: number;
159
+ contentSha256: `sha256:${string}`;
160
+ }[];
161
+ env: Record<string, {
162
+ kind: "public";
163
+ value: string;
164
+ }>;
165
+ flags: {
166
+ kind: "public";
167
+ value: string;
168
+ }[];
169
+ unsupported: {
170
+ dimension: string;
171
+ reason: string;
172
+ }[];
173
+ }, unknown>>;
174
+ artifact: z.ZodUnion<readonly [z.ZodObject<{
175
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
176
+ kind: z.ZodLiteral<"s3">;
177
+ bucket: z.ZodString;
178
+ key: z.ZodString;
179
+ region: z.ZodOptional<z.ZodString>;
180
+ }, z.core.$strict>, z.ZodObject<{
181
+ kind: z.ZodLiteral<"ipfs">;
182
+ cid: z.ZodString;
183
+ path: z.ZodOptional<z.ZodString>;
184
+ }, z.core.$strict>], "kind">;
185
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
186
+ byteLength: z.ZodNumber;
187
+ }, z.core.$strict>, z.ZodObject<{
188
+ encoding: z.ZodLiteral<"base64">;
189
+ content: z.ZodString;
190
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
191
+ byteLength: z.ZodNumber;
192
+ }, z.core.$strict>]>;
193
+ }, z.core.$strict>;
194
+ executionPlan: z.ZodObject<{
195
+ schemaVersion: z.ZodLiteral<1>;
196
+ kind: z.ZodLiteral<"agent-candidate-execution-plan">;
197
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
198
+ material: z.ZodType<{
199
+ schemaVersion: 1;
200
+ kind: "agent-candidate-execution-plan-material";
201
+ bundleDigest: `sha256:${string}`;
202
+ executionId: string;
203
+ attempt: {
204
+ number: number;
205
+ maxAttempts: number;
206
+ retryPolicy: "none" | "pre-model-infrastructure-only";
207
+ };
208
+ task: {
209
+ benchmark: string;
210
+ benchmarkVersion: string;
211
+ taskId: string;
212
+ splitDigest: `sha256:${string}`;
213
+ instruction: {
214
+ encoding: "utf8";
215
+ sha256: `sha256:${string}`;
216
+ byteLength: number;
217
+ delivery: {
218
+ kind: "argv-append";
219
+ } | {
220
+ kind: "stdin-utf8";
221
+ } | {
222
+ kind: "utf8-file";
223
+ env: "TANGLE_CANDIDATE_TASK_PATH";
224
+ path: "/tangle/input/task.txt";
225
+ };
226
+ };
227
+ repository: {
228
+ identity: string;
229
+ rootIdentity: string;
230
+ baseCommit: string;
231
+ baseTree: string;
232
+ };
233
+ workspace: {
234
+ schemaVersion: 1;
235
+ kind: "agent-candidate-workspace-snapshot";
236
+ digest: `sha256:${string}`;
237
+ material: {
238
+ schemaVersion: 1;
239
+ kind: "agent-candidate-workspace-manifest";
240
+ files: {
241
+ path: string;
242
+ mode: 420 | 493;
243
+ sha256: `sha256:${string}`;
244
+ byteLength: number;
245
+ }[];
246
+ };
247
+ manifest: {
248
+ locator: {
249
+ kind: "s3";
250
+ bucket: string;
251
+ key: string;
252
+ region?: string | undefined;
253
+ } | {
254
+ kind: "ipfs";
255
+ cid: string;
256
+ path?: string | undefined;
257
+ };
258
+ sha256: `sha256:${string}`;
259
+ byteLength: number;
260
+ } | {
261
+ encoding: "base64";
262
+ content: string;
263
+ sha256: `sha256:${string}`;
264
+ byteLength: number;
265
+ };
266
+ archive: {
267
+ locator: {
268
+ kind: "s3";
269
+ bucket: string;
270
+ key: string;
271
+ region?: string | undefined;
272
+ } | {
273
+ kind: "ipfs";
274
+ cid: string;
275
+ path?: string | undefined;
276
+ };
277
+ sha256: `sha256:${string}`;
278
+ byteLength: number;
279
+ } | {
280
+ encoding: "base64";
281
+ content: string;
282
+ sha256: `sha256:${string}`;
283
+ byteLength: number;
284
+ };
285
+ };
286
+ };
287
+ workspaces: {
288
+ taskRoot: string;
289
+ candidateRoot?: string | undefined;
290
+ };
291
+ codeKind: "disabled" | "no-op" | "git-patch";
292
+ profile: {
293
+ planDigest: `sha256:${string}`;
294
+ targetWorkspace: "candidate" | "task";
295
+ mountPaths: string[];
296
+ };
297
+ harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
298
+ harnessVersion: string;
299
+ container: {
300
+ image: string;
301
+ indexDigest: `sha256:${string}`;
302
+ source: "pinned-container" | "evaluator-task-container";
303
+ manifestDigest: `sha256:${string}`;
304
+ platform: {
305
+ os: string;
306
+ architecture: string;
307
+ variant?: string | undefined;
308
+ };
309
+ };
310
+ model: {
311
+ policy: "single";
312
+ resolved: {
313
+ requested: string;
314
+ provider: string;
315
+ model: string;
316
+ snapshot: string;
317
+ reasoningEffort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
318
+ };
319
+ access: {
320
+ kind: "evaluator-mediated";
321
+ grantDigest: `sha256:${string}`;
322
+ };
323
+ routes: ({
324
+ kind: "primary";
325
+ requested?: string | undefined;
326
+ } | {
327
+ kind: "small";
328
+ requested: string;
329
+ } | {
330
+ kind: "mode";
331
+ name: string;
332
+ requested: string;
333
+ } | {
334
+ kind: "subagent";
335
+ name: string;
336
+ requested: string;
337
+ })[];
338
+ };
339
+ launch: {
340
+ executable: string;
341
+ args: {
342
+ kind: "public";
343
+ value: string;
344
+ }[];
345
+ env: Record<string, {
346
+ kind: "public";
347
+ value: string;
348
+ }>;
349
+ cwd: {
350
+ workspace: "candidate" | "task";
351
+ path: string;
352
+ };
353
+ };
354
+ memory: {
355
+ mode: "isolated";
356
+ scope: "task";
357
+ effectiveNamespace: string;
358
+ reset: {
359
+ kind: "fresh";
360
+ evidence: {
361
+ locator: {
362
+ kind: "s3";
363
+ bucket: string;
364
+ key: string;
365
+ region?: string | undefined;
366
+ } | {
367
+ kind: "ipfs";
368
+ cid: string;
369
+ path?: string | undefined;
370
+ };
371
+ sha256: `sha256:${string}`;
372
+ byteLength: number;
373
+ } | {
374
+ encoding: "base64";
375
+ content: string;
376
+ sha256: `sha256:${string}`;
377
+ byteLength: number;
378
+ };
379
+ emptyStateDigest: `sha256:${string}`;
380
+ };
381
+ beforeState: {
382
+ schemaVersion: 1;
383
+ kind: "agent-candidate-workspace-snapshot";
384
+ digest: `sha256:${string}`;
385
+ material: {
386
+ schemaVersion: 1;
387
+ kind: "agent-candidate-workspace-manifest";
388
+ files: {
389
+ path: string;
390
+ mode: 420 | 493;
391
+ sha256: `sha256:${string}`;
392
+ byteLength: number;
393
+ }[];
394
+ };
395
+ manifest: {
396
+ locator: {
397
+ kind: "s3";
398
+ bucket: string;
399
+ key: string;
400
+ region?: string | undefined;
401
+ } | {
402
+ kind: "ipfs";
403
+ cid: string;
404
+ path?: string | undefined;
405
+ };
406
+ sha256: `sha256:${string}`;
407
+ byteLength: number;
408
+ } | {
409
+ encoding: "base64";
410
+ content: string;
411
+ sha256: `sha256:${string}`;
412
+ byteLength: number;
413
+ };
414
+ archive: {
415
+ locator: {
416
+ kind: "s3";
417
+ bucket: string;
418
+ key: string;
419
+ region?: string | undefined;
420
+ } | {
421
+ kind: "ipfs";
422
+ cid: string;
423
+ path?: string | undefined;
424
+ };
425
+ sha256: `sha256:${string}`;
426
+ byteLength: number;
427
+ } | {
428
+ encoding: "base64";
429
+ content: string;
430
+ sha256: `sha256:${string}`;
431
+ byteLength: number;
432
+ };
433
+ };
434
+ seedDigest?: `sha256:${string}` | undefined;
435
+ } | {
436
+ mode: "disabled";
437
+ };
438
+ limits: {
439
+ timeoutMs: number;
440
+ maxSteps: number;
441
+ maxModelCalls: number;
442
+ maxInputTokens: number;
443
+ maxOutputTokens: number;
444
+ maxCostUsd: number;
445
+ };
446
+ network: {
447
+ mode: "disabled";
448
+ };
449
+ candidateWorkspace?: {
450
+ schemaVersion: 1;
451
+ kind: "agent-candidate-workspace-snapshot";
452
+ digest: `sha256:${string}`;
453
+ material: {
454
+ schemaVersion: 1;
455
+ kind: "agent-candidate-workspace-manifest";
456
+ files: {
457
+ path: string;
458
+ mode: 420 | 493;
459
+ sha256: `sha256:${string}`;
460
+ byteLength: number;
461
+ }[];
462
+ };
463
+ manifest: {
464
+ locator: {
465
+ kind: "s3";
466
+ bucket: string;
467
+ key: string;
468
+ region?: string | undefined;
469
+ } | {
470
+ kind: "ipfs";
471
+ cid: string;
472
+ path?: string | undefined;
473
+ };
474
+ sha256: `sha256:${string}`;
475
+ byteLength: number;
476
+ } | {
477
+ encoding: "base64";
478
+ content: string;
479
+ sha256: `sha256:${string}`;
480
+ byteLength: number;
481
+ };
482
+ archive: {
483
+ locator: {
484
+ kind: "s3";
485
+ bucket: string;
486
+ key: string;
487
+ region?: string | undefined;
488
+ } | {
489
+ kind: "ipfs";
490
+ cid: string;
491
+ path?: string | undefined;
492
+ };
493
+ sha256: `sha256:${string}`;
494
+ byteLength: number;
495
+ } | {
496
+ encoding: "base64";
497
+ content: string;
498
+ sha256: `sha256:${string}`;
499
+ byteLength: number;
500
+ };
501
+ } | undefined;
502
+ knowledgeManifestDigest?: `sha256:${string}` | undefined;
503
+ }, unknown, z.core.$ZodTypeInternals<{
504
+ schemaVersion: 1;
505
+ kind: "agent-candidate-execution-plan-material";
506
+ bundleDigest: `sha256:${string}`;
507
+ executionId: string;
508
+ attempt: {
509
+ number: number;
510
+ maxAttempts: number;
511
+ retryPolicy: "none" | "pre-model-infrastructure-only";
512
+ };
513
+ task: {
514
+ benchmark: string;
515
+ benchmarkVersion: string;
516
+ taskId: string;
517
+ splitDigest: `sha256:${string}`;
518
+ instruction: {
519
+ encoding: "utf8";
520
+ sha256: `sha256:${string}`;
521
+ byteLength: number;
522
+ delivery: {
523
+ kind: "argv-append";
524
+ } | {
525
+ kind: "stdin-utf8";
526
+ } | {
527
+ kind: "utf8-file";
528
+ env: "TANGLE_CANDIDATE_TASK_PATH";
529
+ path: "/tangle/input/task.txt";
530
+ };
531
+ };
532
+ repository: {
533
+ identity: string;
534
+ rootIdentity: string;
535
+ baseCommit: string;
536
+ baseTree: string;
537
+ };
538
+ workspace: {
539
+ schemaVersion: 1;
540
+ kind: "agent-candidate-workspace-snapshot";
541
+ digest: `sha256:${string}`;
542
+ material: {
543
+ schemaVersion: 1;
544
+ kind: "agent-candidate-workspace-manifest";
545
+ files: {
546
+ path: string;
547
+ mode: 420 | 493;
548
+ sha256: `sha256:${string}`;
549
+ byteLength: number;
550
+ }[];
551
+ };
552
+ manifest: {
553
+ locator: {
554
+ kind: "s3";
555
+ bucket: string;
556
+ key: string;
557
+ region?: string | undefined;
558
+ } | {
559
+ kind: "ipfs";
560
+ cid: string;
561
+ path?: string | undefined;
562
+ };
563
+ sha256: `sha256:${string}`;
564
+ byteLength: number;
565
+ } | {
566
+ encoding: "base64";
567
+ content: string;
568
+ sha256: `sha256:${string}`;
569
+ byteLength: number;
570
+ };
571
+ archive: {
572
+ locator: {
573
+ kind: "s3";
574
+ bucket: string;
575
+ key: string;
576
+ region?: string | undefined;
577
+ } | {
578
+ kind: "ipfs";
579
+ cid: string;
580
+ path?: string | undefined;
581
+ };
582
+ sha256: `sha256:${string}`;
583
+ byteLength: number;
584
+ } | {
585
+ encoding: "base64";
586
+ content: string;
587
+ sha256: `sha256:${string}`;
588
+ byteLength: number;
589
+ };
590
+ };
591
+ };
592
+ workspaces: {
593
+ taskRoot: string;
594
+ candidateRoot?: string | undefined;
595
+ };
596
+ codeKind: "disabled" | "no-op" | "git-patch";
597
+ profile: {
598
+ planDigest: `sha256:${string}`;
599
+ targetWorkspace: "candidate" | "task";
600
+ mountPaths: string[];
601
+ };
602
+ harness: "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "acp" | "cli-base";
603
+ harnessVersion: string;
604
+ container: {
605
+ image: string;
606
+ indexDigest: `sha256:${string}`;
607
+ source: "pinned-container" | "evaluator-task-container";
608
+ manifestDigest: `sha256:${string}`;
609
+ platform: {
610
+ os: string;
611
+ architecture: string;
612
+ variant?: string | undefined;
613
+ };
614
+ };
615
+ model: {
616
+ policy: "single";
617
+ resolved: {
618
+ requested: string;
619
+ provider: string;
620
+ model: string;
621
+ snapshot: string;
622
+ reasoningEffort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
623
+ };
624
+ access: {
625
+ kind: "evaluator-mediated";
626
+ grantDigest: `sha256:${string}`;
627
+ };
628
+ routes: ({
629
+ kind: "primary";
630
+ requested?: string | undefined;
631
+ } | {
632
+ kind: "small";
633
+ requested: string;
634
+ } | {
635
+ kind: "mode";
636
+ name: string;
637
+ requested: string;
638
+ } | {
639
+ kind: "subagent";
640
+ name: string;
641
+ requested: string;
642
+ })[];
643
+ };
644
+ launch: {
645
+ executable: string;
646
+ args: {
647
+ kind: "public";
648
+ value: string;
649
+ }[];
650
+ env: Record<string, {
651
+ kind: "public";
652
+ value: string;
653
+ }>;
654
+ cwd: {
655
+ workspace: "candidate" | "task";
656
+ path: string;
657
+ };
658
+ };
659
+ memory: {
660
+ mode: "isolated";
661
+ scope: "task";
662
+ effectiveNamespace: string;
663
+ reset: {
664
+ kind: "fresh";
665
+ evidence: {
666
+ locator: {
667
+ kind: "s3";
668
+ bucket: string;
669
+ key: string;
670
+ region?: string | undefined;
671
+ } | {
672
+ kind: "ipfs";
673
+ cid: string;
674
+ path?: string | undefined;
675
+ };
676
+ sha256: `sha256:${string}`;
677
+ byteLength: number;
678
+ } | {
679
+ encoding: "base64";
680
+ content: string;
681
+ sha256: `sha256:${string}`;
682
+ byteLength: number;
683
+ };
684
+ emptyStateDigest: `sha256:${string}`;
685
+ };
686
+ beforeState: {
687
+ schemaVersion: 1;
688
+ kind: "agent-candidate-workspace-snapshot";
689
+ digest: `sha256:${string}`;
690
+ material: {
691
+ schemaVersion: 1;
692
+ kind: "agent-candidate-workspace-manifest";
693
+ files: {
694
+ path: string;
695
+ mode: 420 | 493;
696
+ sha256: `sha256:${string}`;
697
+ byteLength: number;
698
+ }[];
699
+ };
700
+ manifest: {
701
+ locator: {
702
+ kind: "s3";
703
+ bucket: string;
704
+ key: string;
705
+ region?: string | undefined;
706
+ } | {
707
+ kind: "ipfs";
708
+ cid: string;
709
+ path?: string | undefined;
710
+ };
711
+ sha256: `sha256:${string}`;
712
+ byteLength: number;
713
+ } | {
714
+ encoding: "base64";
715
+ content: string;
716
+ sha256: `sha256:${string}`;
717
+ byteLength: number;
718
+ };
719
+ archive: {
720
+ locator: {
721
+ kind: "s3";
722
+ bucket: string;
723
+ key: string;
724
+ region?: string | undefined;
725
+ } | {
726
+ kind: "ipfs";
727
+ cid: string;
728
+ path?: string | undefined;
729
+ };
730
+ sha256: `sha256:${string}`;
731
+ byteLength: number;
732
+ } | {
733
+ encoding: "base64";
734
+ content: string;
735
+ sha256: `sha256:${string}`;
736
+ byteLength: number;
737
+ };
738
+ };
739
+ seedDigest?: `sha256:${string}` | undefined;
740
+ } | {
741
+ mode: "disabled";
742
+ };
743
+ limits: {
744
+ timeoutMs: number;
745
+ maxSteps: number;
746
+ maxModelCalls: number;
747
+ maxInputTokens: number;
748
+ maxOutputTokens: number;
749
+ maxCostUsd: number;
750
+ };
751
+ network: {
752
+ mode: "disabled";
753
+ };
754
+ candidateWorkspace?: {
755
+ schemaVersion: 1;
756
+ kind: "agent-candidate-workspace-snapshot";
757
+ digest: `sha256:${string}`;
758
+ material: {
759
+ schemaVersion: 1;
760
+ kind: "agent-candidate-workspace-manifest";
761
+ files: {
762
+ path: string;
763
+ mode: 420 | 493;
764
+ sha256: `sha256:${string}`;
765
+ byteLength: number;
766
+ }[];
767
+ };
768
+ manifest: {
769
+ locator: {
770
+ kind: "s3";
771
+ bucket: string;
772
+ key: string;
773
+ region?: string | undefined;
774
+ } | {
775
+ kind: "ipfs";
776
+ cid: string;
777
+ path?: string | undefined;
778
+ };
779
+ sha256: `sha256:${string}`;
780
+ byteLength: number;
781
+ } | {
782
+ encoding: "base64";
783
+ content: string;
784
+ sha256: `sha256:${string}`;
785
+ byteLength: number;
786
+ };
787
+ archive: {
788
+ locator: {
789
+ kind: "s3";
790
+ bucket: string;
791
+ key: string;
792
+ region?: string | undefined;
793
+ } | {
794
+ kind: "ipfs";
795
+ cid: string;
796
+ path?: string | undefined;
797
+ };
798
+ sha256: `sha256:${string}`;
799
+ byteLength: number;
800
+ } | {
801
+ encoding: "base64";
802
+ content: string;
803
+ sha256: `sha256:${string}`;
804
+ byteLength: number;
805
+ };
806
+ } | undefined;
807
+ knowledgeManifestDigest?: `sha256:${string}` | undefined;
808
+ }, unknown>>;
809
+ artifact: z.ZodUnion<readonly [z.ZodObject<{
810
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
811
+ kind: z.ZodLiteral<"s3">;
812
+ bucket: z.ZodString;
813
+ key: z.ZodString;
814
+ region: z.ZodOptional<z.ZodString>;
815
+ }, z.core.$strict>, z.ZodObject<{
816
+ kind: z.ZodLiteral<"ipfs">;
817
+ cid: z.ZodString;
818
+ path: z.ZodOptional<z.ZodString>;
819
+ }, z.core.$strict>], "kind">;
820
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
821
+ byteLength: z.ZodNumber;
822
+ }, z.core.$strict>, z.ZodObject<{
823
+ encoding: z.ZodLiteral<"base64">;
824
+ content: z.ZodString;
825
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
826
+ byteLength: z.ZodNumber;
827
+ }, z.core.$strict>]>;
828
+ }, z.core.$strict>;
829
+ candidateWorkspace: z.ZodOptional<z.ZodObject<{
830
+ schemaVersion: z.ZodLiteral<1>;
831
+ kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
832
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
833
+ material: z.ZodObject<{
834
+ schemaVersion: z.ZodLiteral<1>;
835
+ kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
836
+ files: z.ZodArray<z.ZodObject<{
837
+ path: z.ZodString;
838
+ mode: z.ZodUnion<readonly [z.ZodLiteral<420>, z.ZodLiteral<493>]>;
839
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
840
+ byteLength: z.ZodNumber;
841
+ }, z.core.$strict>>;
842
+ }, z.core.$strict>;
843
+ manifest: z.ZodUnion<readonly [z.ZodObject<{
844
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
845
+ kind: z.ZodLiteral<"s3">;
846
+ bucket: z.ZodString;
847
+ key: z.ZodString;
848
+ region: z.ZodOptional<z.ZodString>;
849
+ }, z.core.$strict>, z.ZodObject<{
850
+ kind: z.ZodLiteral<"ipfs">;
851
+ cid: z.ZodString;
852
+ path: z.ZodOptional<z.ZodString>;
853
+ }, z.core.$strict>], "kind">;
854
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
855
+ byteLength: z.ZodNumber;
856
+ }, z.core.$strict>, z.ZodObject<{
857
+ encoding: z.ZodLiteral<"base64">;
858
+ content: z.ZodString;
859
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
860
+ byteLength: z.ZodNumber;
861
+ }, z.core.$strict>]>;
862
+ archive: z.ZodUnion<readonly [z.ZodObject<{
863
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
864
+ kind: z.ZodLiteral<"s3">;
865
+ bucket: z.ZodString;
866
+ key: z.ZodString;
867
+ region: z.ZodOptional<z.ZodString>;
868
+ }, z.core.$strict>, z.ZodObject<{
869
+ kind: z.ZodLiteral<"ipfs">;
870
+ cid: z.ZodString;
871
+ path: z.ZodOptional<z.ZodString>;
872
+ }, z.core.$strict>], "kind">;
873
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
874
+ byteLength: z.ZodNumber;
875
+ }, z.core.$strict>, z.ZodObject<{
876
+ encoding: z.ZodLiteral<"base64">;
877
+ content: z.ZodString;
878
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
879
+ byteLength: z.ZodNumber;
880
+ }, z.core.$strict>]>;
881
+ }, z.core.$strict>>;
882
+ codeKind: z.ZodEnum<{
883
+ disabled: "disabled";
884
+ "no-op": "no-op";
885
+ "git-patch": "git-patch";
886
+ }>;
887
+ materializedTree: z.ZodOptional<z.ZodString>;
888
+ harness: z.ZodEnum<{
889
+ "claude-code": "claude-code";
890
+ claude: "claude";
891
+ claudish: "claudish";
892
+ nanoclaw: "nanoclaw";
893
+ codex: "codex";
894
+ opencode: "opencode";
895
+ "kimi-code": "kimi-code";
896
+ kimi: "kimi";
897
+ pi: "pi";
898
+ gemini: "gemini";
899
+ hermes: "hermes";
900
+ openclaw: "openclaw";
901
+ amp: "amp";
902
+ "factory-droids": "factory-droids";
903
+ acp: "acp";
904
+ "cli-base": "cli-base";
905
+ }>;
906
+ harnessVersion: z.ZodString;
907
+ container: z.ZodObject<{
908
+ source: z.ZodEnum<{
909
+ "pinned-container": "pinned-container";
910
+ "evaluator-task-container": "evaluator-task-container";
911
+ }>;
912
+ image: z.ZodString;
913
+ indexDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
914
+ manifestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
915
+ platform: z.ZodObject<{
916
+ os: z.ZodString;
917
+ architecture: z.ZodString;
918
+ variant: z.ZodOptional<z.ZodString>;
919
+ }, z.core.$strict>;
920
+ }, z.core.$strict>;
921
+ resolvedModel: z.ZodObject<{
922
+ requested: z.ZodString;
923
+ provider: z.ZodString;
924
+ model: z.ZodString;
925
+ snapshot: z.ZodString;
926
+ reasoningEffort: z.ZodEnum<{
927
+ none: "none";
928
+ minimal: "minimal";
929
+ low: "low";
930
+ medium: "medium";
931
+ high: "high";
932
+ xhigh: "xhigh";
933
+ ultracode: "ultracode";
934
+ }>;
935
+ }, z.core.$strict>;
936
+ knowledgeManifestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
937
+ entrypoint: z.ZodOptional<z.ZodObject<{
938
+ path: z.ZodString;
939
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
940
+ byteLength: z.ZodNumber;
941
+ }, z.core.$strict>>;
942
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
943
+ }, z.core.$strict>;
944
+ export declare const agentCandidateRunReceiptSchema: z.ZodObject<{
945
+ schemaVersion: z.ZodLiteral<1>;
946
+ kind: z.ZodLiteral<"agent-candidate-run">;
947
+ digestAlgorithm: z.ZodLiteral<"rfc8785-sha256">;
948
+ bundleDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
949
+ materializationReceiptDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
950
+ executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
951
+ memory: z.ZodDiscriminatedUnion<[z.ZodObject<{
952
+ mode: z.ZodLiteral<"disabled">;
953
+ }, z.core.$strict>, z.ZodObject<{
954
+ mode: z.ZodLiteral<"isolated">;
955
+ scope: z.ZodLiteral<"task">;
956
+ effectiveNamespace: z.ZodString;
957
+ resetEvidenceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
958
+ beforeStateDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
959
+ afterState: z.ZodObject<{
960
+ schemaVersion: z.ZodLiteral<1>;
961
+ kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
962
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
963
+ material: z.ZodObject<{
964
+ schemaVersion: z.ZodLiteral<1>;
965
+ kind: z.ZodLiteral<"agent-candidate-workspace-manifest">;
966
+ files: z.ZodArray<z.ZodObject<{
967
+ path: z.ZodString;
968
+ mode: z.ZodUnion<readonly [z.ZodLiteral<420>, z.ZodLiteral<493>]>;
969
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
970
+ byteLength: z.ZodNumber;
971
+ }, z.core.$strict>>;
972
+ }, z.core.$strict>;
973
+ manifest: z.ZodUnion<readonly [z.ZodObject<{
974
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
975
+ kind: z.ZodLiteral<"s3">;
976
+ bucket: z.ZodString;
977
+ key: z.ZodString;
978
+ region: z.ZodOptional<z.ZodString>;
979
+ }, z.core.$strict>, z.ZodObject<{
980
+ kind: z.ZodLiteral<"ipfs">;
981
+ cid: z.ZodString;
982
+ path: z.ZodOptional<z.ZodString>;
983
+ }, z.core.$strict>], "kind">;
984
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
985
+ byteLength: z.ZodNumber;
986
+ }, z.core.$strict>, z.ZodObject<{
987
+ encoding: z.ZodLiteral<"base64">;
988
+ content: z.ZodString;
989
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
990
+ byteLength: z.ZodNumber;
991
+ }, z.core.$strict>]>;
992
+ archive: z.ZodUnion<readonly [z.ZodObject<{
993
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
994
+ kind: z.ZodLiteral<"s3">;
995
+ bucket: z.ZodString;
996
+ key: z.ZodString;
997
+ region: z.ZodOptional<z.ZodString>;
998
+ }, z.core.$strict>, z.ZodObject<{
999
+ kind: z.ZodLiteral<"ipfs">;
1000
+ cid: z.ZodString;
1001
+ path: z.ZodOptional<z.ZodString>;
1002
+ }, z.core.$strict>], "kind">;
1003
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1004
+ byteLength: z.ZodNumber;
1005
+ }, z.core.$strict>, z.ZodObject<{
1006
+ encoding: z.ZodLiteral<"base64">;
1007
+ content: z.ZodString;
1008
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1009
+ byteLength: z.ZodNumber;
1010
+ }, z.core.$strict>]>;
1011
+ }, z.core.$strict>;
1012
+ }, z.core.$strict>], "mode">;
1013
+ usage: z.ZodObject<{
1014
+ costUsd: z.ZodNumber;
1015
+ inputTokens: z.ZodNumber;
1016
+ outputTokens: z.ZodNumber;
1017
+ cachedInputTokens: z.ZodOptional<z.ZodNumber>;
1018
+ modelCalls: z.ZodNumber;
1019
+ }, z.core.$strict>;
1020
+ modelUsage: z.ZodObject<{
1021
+ resolved: z.ZodObject<{
1022
+ requested: z.ZodString;
1023
+ provider: z.ZodString;
1024
+ model: z.ZodString;
1025
+ snapshot: z.ZodString;
1026
+ reasoningEffort: z.ZodEnum<{
1027
+ none: "none";
1028
+ minimal: "minimal";
1029
+ low: "low";
1030
+ medium: "medium";
1031
+ high: "high";
1032
+ xhigh: "xhigh";
1033
+ ultracode: "ultracode";
1034
+ }>;
1035
+ }, z.core.$strict>;
1036
+ usage: z.ZodObject<{
1037
+ costUsd: z.ZodNumber;
1038
+ inputTokens: z.ZodNumber;
1039
+ outputTokens: z.ZodNumber;
1040
+ cachedInputTokens: z.ZodOptional<z.ZodNumber>;
1041
+ modelCalls: z.ZodNumber;
1042
+ }, z.core.$strict>;
1043
+ }, z.core.$strict>;
1044
+ trace: z.ZodObject<{
1045
+ schemaVersion: z.ZodLiteral<1>;
1046
+ artifact: z.ZodUnion<readonly [z.ZodObject<{
1047
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
1048
+ kind: z.ZodLiteral<"s3">;
1049
+ bucket: z.ZodString;
1050
+ key: z.ZodString;
1051
+ region: z.ZodOptional<z.ZodString>;
1052
+ }, z.core.$strict>, z.ZodObject<{
1053
+ kind: z.ZodLiteral<"ipfs">;
1054
+ cid: z.ZodString;
1055
+ path: z.ZodOptional<z.ZodString>;
1056
+ }, z.core.$strict>], "kind">;
1057
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1058
+ byteLength: z.ZodNumber;
1059
+ }, z.core.$strict>, z.ZodObject<{
1060
+ encoding: z.ZodLiteral<"base64">;
1061
+ content: z.ZodString;
1062
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1063
+ byteLength: z.ZodNumber;
1064
+ }, z.core.$strict>]>;
1065
+ eventCount: z.ZodNumber;
1066
+ modelCallCount: z.ZodNumber;
1067
+ }, z.core.$strict>;
1068
+ termination: z.ZodDiscriminatedUnion<[z.ZodObject<{
1069
+ kind: z.ZodLiteral<"exit">;
1070
+ exitCode: z.ZodNumber;
1071
+ }, z.core.$strict>, z.ZodObject<{
1072
+ kind: z.ZodLiteral<"timeout">;
1073
+ timeoutMs: z.ZodNumber;
1074
+ }, z.core.$strict>, z.ZodObject<{
1075
+ kind: z.ZodLiteral<"signal">;
1076
+ signal: z.ZodString;
1077
+ }, z.core.$strict>, z.ZodObject<{
1078
+ kind: z.ZodLiteral<"cancelled">;
1079
+ }, z.core.$strict>], "kind">;
1080
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1081
+ }, z.core.$strict>;