@tangle-network/agent-interface 5.7.0 → 5.8.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 (44) hide show
  1. package/README.md +11 -2
  2. package/dist/agent-candidate-code-schema.d.ts +24 -24
  3. package/dist/agent-candidate-execution-plan-schema.d.ts +245 -245
  4. package/dist/agent-candidate-lineage-schema.d.ts +2 -2
  5. package/dist/agent-candidate-outcome-schema.d.ts +56 -56
  6. package/dist/agent-candidate-profile-schema.d.ts +22 -22
  7. package/dist/agent-candidate-promotion-schema.d.ts +1824 -1824
  8. package/dist/agent-candidate-receipt-schema.d.ts +201 -201
  9. package/dist/agent-candidate-schema-common.d.ts +3 -3
  10. package/dist/agent-candidate-schema.d.ts +36 -36
  11. package/dist/agent-candidate-task-schema.d.ts +16 -16
  12. package/dist/agent-execution-preparation-receipt.d.ts +81 -81
  13. package/dist/agent-improvement-measurement-schema.d.ts +25 -25
  14. package/dist/agent-profile-improvement-schema.d.ts +75 -75
  15. package/dist/agent-profile.d.ts +10 -28
  16. package/dist/agent-workspace-lease.d.ts +4 -4
  17. package/dist/environment-interactive-control.d.ts +473 -473
  18. package/dist/environment-interactive-start.d.ts +38 -29
  19. package/dist/environment-observation.d.ts +32 -32
  20. package/dist/environment-profile-capabilities.d.ts +1 -1
  21. package/dist/environment-runtime.d.ts +171 -144
  22. package/dist/harness-capabilities.d.ts +17 -18
  23. package/dist/harness-capabilities.js +41 -44
  24. package/dist/harness.d.ts +13 -11
  25. package/dist/harness.js +5 -0
  26. package/dist/interaction-envelope.d.ts +26 -26
  27. package/dist/interaction-fields.d.ts +22 -22
  28. package/dist/interaction-permissions.d.ts +2 -2
  29. package/dist/learning-state.d.ts +143 -143
  30. package/dist/portable-context-base.d.ts +1 -1
  31. package/dist/portable-context-commitments.d.ts +8 -8
  32. package/dist/portable-context-continuation.d.ts +4 -4
  33. package/dist/portable-context-plan-request.d.ts +1 -1
  34. package/dist/portable-context-plan-wire.d.ts +2 -2
  35. package/dist/portable-context-plan.d.ts +5 -5
  36. package/dist/portable-context-shared.d.ts +1 -1
  37. package/dist/portable-context-transfer.d.ts +43 -34
  38. package/dist/profile-schema.d.ts +78 -60
  39. package/dist/profile-schema.js +7 -3
  40. package/dist/proxy-secrets.d.ts +12 -12
  41. package/dist/runtime-control.d.ts +5 -5
  42. package/dist/workspace-cleanup.d.ts +3 -3
  43. package/dist/workspace-fork.d.ts +4 -4
  44. package/package.json +5 -5
@@ -156,11 +156,11 @@ export declare const generatedCandidateSources: readonly ["optimizer", "compound
156
156
  export declare function isGeneratedCandidateSource(source: AgentCandidateLineage["source"]): boolean;
157
157
  export declare const agentCandidateLineageSchema: z.ZodObject<{
158
158
  source: z.ZodEnum<{
159
- compound: "compound";
160
159
  "frontier-author": "frontier-author";
161
160
  human: "human";
162
- import: "import";
163
161
  optimizer: "optimizer";
162
+ compound: "compound";
163
+ import: "import";
164
164
  }>;
165
165
  parentDigests: z.ZodOptional<z.ZodArray<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>>;
166
166
  runIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -7,8 +7,8 @@ export declare const agentCandidateFixedSpendSchema: z.ZodObject<{
7
7
  modelCalls: z.ZodNumber;
8
8
  costUsdNanos: z.ZodNumber;
9
9
  costProvenance: z.ZodEnum<{
10
- estimated: "estimated";
11
10
  observed: "observed";
11
+ estimated: "estimated";
12
12
  }>;
13
13
  }, z.core.$strict>;
14
14
  export declare const agentCandidateModelSettlementCallSchema: z.ZodObject<{
@@ -16,8 +16,8 @@ export declare const agentCandidateModelSettlementCallSchema: z.ZodObject<{
16
16
  generationId: z.ZodString;
17
17
  traceSpanId: z.ZodString;
18
18
  status: z.ZodEnum<{
19
- failed: "failed";
20
19
  succeeded: "succeeded";
20
+ failed: "failed";
21
21
  }>;
22
22
  model: z.ZodString;
23
23
  startedAtMs: z.ZodNumber;
@@ -29,11 +29,33 @@ export declare const agentCandidateModelSettlementCallSchema: z.ZodObject<{
29
29
  reasoningTokens: z.ZodNumber;
30
30
  costUsdNanos: z.ZodNumber;
31
31
  costProvenance: z.ZodEnum<{
32
- estimated: "estimated";
33
32
  observed: "observed";
33
+ estimated: "estimated";
34
34
  }>;
35
35
  }, z.core.$strict>;
36
36
  export declare const agentCandidateModelSettlementMaterialSchema: z.ZodObject<{
37
+ calls: z.ZodArray<z.ZodObject<{
38
+ callId: z.ZodString;
39
+ generationId: z.ZodString;
40
+ traceSpanId: z.ZodString;
41
+ status: z.ZodEnum<{
42
+ succeeded: "succeeded";
43
+ failed: "failed";
44
+ }>;
45
+ model: z.ZodString;
46
+ startedAtMs: z.ZodNumber;
47
+ endedAtMs: z.ZodNumber;
48
+ inputTokens: z.ZodNumber;
49
+ accountedInputTokens: z.ZodNumber;
50
+ outputTokens: z.ZodNumber;
51
+ cachedInputTokens: z.ZodNumber;
52
+ reasoningTokens: z.ZodNumber;
53
+ costUsdNanos: z.ZodNumber;
54
+ costProvenance: z.ZodEnum<{
55
+ observed: "observed";
56
+ estimated: "estimated";
57
+ }>;
58
+ }, z.core.$strict>>;
37
59
  kind: z.ZodLiteral<"agent-candidate-model-settlement-material">;
38
60
  executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
39
61
  preparationId: z.ZodString;
@@ -46,13 +68,13 @@ export declare const agentCandidateModelSettlementMaterialSchema: z.ZodObject<{
46
68
  model: z.ZodString;
47
69
  snapshot: z.ZodString;
48
70
  reasoningEffort: z.ZodEnum<{
49
- high: "high";
71
+ none: "none";
72
+ minimal: "minimal";
50
73
  low: "low";
51
74
  medium: "medium";
52
- minimal: "minimal";
53
- none: "none";
54
- ultracode: "ultracode";
75
+ high: "high";
55
76
  xhigh: "xhigh";
77
+ ultracode: "ultracode";
56
78
  }>;
57
79
  }, z.core.$strict>;
58
80
  usage: z.ZodObject<{
@@ -63,37 +85,31 @@ export declare const agentCandidateModelSettlementMaterialSchema: z.ZodObject<{
63
85
  modelCalls: z.ZodNumber;
64
86
  costUsdNanos: z.ZodNumber;
65
87
  costProvenance: z.ZodEnum<{
66
- estimated: "estimated";
67
88
  observed: "observed";
68
- }>;
69
- }, z.core.$strict>;
70
- calls: z.ZodArray<z.ZodObject<{
71
- callId: z.ZodString;
72
- generationId: z.ZodString;
73
- traceSpanId: z.ZodString;
74
- status: z.ZodEnum<{
75
- failed: "failed";
76
- succeeded: "succeeded";
77
- }>;
78
- model: z.ZodString;
79
- startedAtMs: z.ZodNumber;
80
- endedAtMs: z.ZodNumber;
81
- inputTokens: z.ZodNumber;
82
- accountedInputTokens: z.ZodNumber;
83
- outputTokens: z.ZodNumber;
84
- cachedInputTokens: z.ZodNumber;
85
- reasoningTokens: z.ZodNumber;
86
- costUsdNanos: z.ZodNumber;
87
- costProvenance: z.ZodEnum<{
88
89
  estimated: "estimated";
89
- observed: "observed";
90
90
  }>;
91
- }, z.core.$strict>>;
91
+ }, z.core.$strict>;
92
92
  }, z.core.$strict>;
93
93
  export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
94
94
  kind: z.ZodLiteral<"agent-candidate-model-settlement">;
95
95
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
96
96
  material: z.ZodType<{
97
+ calls: {
98
+ callId: string;
99
+ generationId: string;
100
+ traceSpanId: string;
101
+ status: "succeeded" | "failed";
102
+ model: string;
103
+ startedAtMs: number;
104
+ endedAtMs: number;
105
+ inputTokens: number;
106
+ accountedInputTokens: number;
107
+ outputTokens: number;
108
+ cachedInputTokens: number;
109
+ reasoningTokens: number;
110
+ costUsdNanos: number;
111
+ costProvenance: "observed" | "estimated";
112
+ }[];
97
113
  kind: "agent-candidate-model-settlement-material";
98
114
  executionPlanDigest: `sha256:${string}`;
99
115
  preparationId: string;
@@ -105,7 +121,7 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
105
121
  provider: string;
106
122
  model: string;
107
123
  snapshot: string;
108
- reasoningEffort: "high" | "low" | "medium" | "minimal" | "none" | "ultracode" | "xhigh";
124
+ reasoningEffort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
109
125
  };
110
126
  usage: {
111
127
  inputTokens: number;
@@ -114,13 +130,14 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
114
130
  reasoningTokens: number;
115
131
  modelCalls: number;
116
132
  costUsdNanos: number;
117
- costProvenance: "estimated" | "observed";
133
+ costProvenance: "observed" | "estimated";
118
134
  };
135
+ }, unknown, z.core.$ZodTypeInternals<{
119
136
  calls: {
120
137
  callId: string;
121
138
  generationId: string;
122
139
  traceSpanId: string;
123
- status: "failed" | "succeeded";
140
+ status: "succeeded" | "failed";
124
141
  model: string;
125
142
  startedAtMs: number;
126
143
  endedAtMs: number;
@@ -130,9 +147,8 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
130
147
  cachedInputTokens: number;
131
148
  reasoningTokens: number;
132
149
  costUsdNanos: number;
133
- costProvenance: "estimated" | "observed";
150
+ costProvenance: "observed" | "estimated";
134
151
  }[];
135
- }, unknown, z.core.$ZodTypeInternals<{
136
152
  kind: "agent-candidate-model-settlement-material";
137
153
  executionPlanDigest: `sha256:${string}`;
138
154
  preparationId: string;
@@ -144,7 +160,7 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
144
160
  provider: string;
145
161
  model: string;
146
162
  snapshot: string;
147
- reasoningEffort: "high" | "low" | "medium" | "minimal" | "none" | "ultracode" | "xhigh";
163
+ reasoningEffort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
148
164
  };
149
165
  usage: {
150
166
  inputTokens: number;
@@ -153,24 +169,8 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
153
169
  reasoningTokens: number;
154
170
  modelCalls: number;
155
171
  costUsdNanos: number;
156
- costProvenance: "estimated" | "observed";
172
+ costProvenance: "observed" | "estimated";
157
173
  };
158
- calls: {
159
- callId: string;
160
- generationId: string;
161
- traceSpanId: string;
162
- status: "failed" | "succeeded";
163
- model: string;
164
- startedAtMs: number;
165
- endedAtMs: number;
166
- inputTokens: number;
167
- accountedInputTokens: number;
168
- outputTokens: number;
169
- cachedInputTokens: number;
170
- reasoningTokens: number;
171
- costUsdNanos: number;
172
- costProvenance: "estimated" | "observed";
173
- }[];
174
174
  }, unknown>>;
175
175
  artifact: z.ZodUnion<readonly [z.ZodObject<{
176
176
  locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -655,8 +655,8 @@ export declare const agentCandidateBenchmarkResultMaterialSchema: z.ZodObject<{
655
655
  modelCalls: z.ZodNumber;
656
656
  costUsdNanos: z.ZodNumber;
657
657
  costProvenance: z.ZodEnum<{
658
- estimated: "estimated";
659
658
  observed: "observed";
659
+ estimated: "estimated";
660
660
  }>;
661
661
  }, z.core.$strict>;
662
662
  timing: z.ZodObject<{
@@ -728,7 +728,7 @@ export declare const agentCandidateBenchmarkResultEvidenceSchema: z.ZodObject<{
728
728
  reasoningTokens: number;
729
729
  modelCalls: number;
730
730
  costUsdNanos: number;
731
- costProvenance: "estimated" | "observed";
731
+ costProvenance: "observed" | "estimated";
732
732
  };
733
733
  timing: {
734
734
  startedAtMs: number;
@@ -795,7 +795,7 @@ export declare const agentCandidateBenchmarkResultEvidenceSchema: z.ZodObject<{
795
795
  reasoningTokens: number;
796
796
  modelCalls: number;
797
797
  costUsdNanos: number;
798
- costProvenance: "estimated" | "observed";
798
+ costProvenance: "observed" | "estimated";
799
799
  };
800
800
  timing: {
801
801
  startedAtMs: number;
@@ -10,8 +10,8 @@ export declare const agentCandidateHookCommandSchema: z.ZodObject<{
10
10
  kind: z.ZodLiteral<"secret-ref">;
11
11
  key: z.ZodString;
12
12
  format: z.ZodOptional<z.ZodEnum<{
13
- bearer: "bearer";
14
13
  raw: "raw";
14
+ bearer: "bearer";
15
15
  }>>;
16
16
  }, z.core.$strict>], "kind">>>;
17
17
  timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -24,8 +24,8 @@ export declare const agentCandidateHookCommandSchema: z.ZodObject<{
24
24
  kind: z.ZodLiteral<"secret-ref">;
25
25
  key: z.ZodString;
26
26
  format: z.ZodOptional<z.ZodEnum<{
27
- bearer: "bearer";
28
27
  raw: "raw";
28
+ bearer: "bearer";
29
29
  }>>;
30
30
  }, z.core.$strict>], "kind">>>;
31
31
  }, z.core.$strict>;
@@ -41,13 +41,13 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
41
41
  }, z.core.$strict>>;
42
42
  model: z.ZodOptional<z.ZodObject<{
43
43
  reasoningEffort: z.ZodOptional<z.ZodEnum<{
44
- high: "high";
44
+ none: "none";
45
+ minimal: "minimal";
45
46
  low: "low";
46
47
  medium: "medium";
47
- minimal: "minimal";
48
- none: "none";
49
- ultracode: "ultracode";
48
+ high: "high";
50
49
  xhigh: "xhigh";
50
+ ultracode: "ultracode";
51
51
  }>>;
52
52
  maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
53
53
  maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -57,22 +57,22 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
57
57
  provider: z.ZodOptional<z.ZodString>;
58
58
  }, z.core.$strict>>;
59
59
  harness: z.ZodOptional<z.ZodEnum<{
60
- acp: "acp";
61
- amp: "amp";
62
60
  "claude-code": "claude-code";
63
- "cli-base": "cli-base";
64
- codex: "codex";
65
- cursor: "cursor";
66
- "factory-droids": "factory-droids";
67
- forge: "forge";
68
- gemini: "gemini";
69
- hermes: "hermes";
70
- "kimi-code": "kimi-code";
71
61
  nanoclaw: "nanoclaw";
72
- openclaw: "openclaw";
62
+ codex: "codex";
73
63
  opencode: "opencode";
64
+ "kimi-code": "kimi-code";
74
65
  pi: "pi";
75
66
  prime: "prime";
67
+ gemini: "gemini";
68
+ hermes: "hermes";
69
+ openclaw: "openclaw";
70
+ amp: "amp";
71
+ "factory-droids": "factory-droids";
72
+ forge: "forge";
73
+ cursor: "cursor";
74
+ acp: "acp";
75
+ "cli-base": "cli-base";
76
76
  }>>;
77
77
  proxySecrets: z.ZodOptional<z.ZodArray<z.ZodObject<{
78
78
  hosts: z.ZodReadonly<z.ZodArray<z.ZodString>>;
@@ -80,8 +80,8 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
80
80
  paths: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
81
81
  envName: z.ZodString;
82
82
  secretRef: z.ZodObject<{
83
- kind: z.ZodLiteral<"secret-ref">;
84
83
  key: z.ZodString;
84
+ kind: z.ZodLiteral<"secret-ref">;
85
85
  }, z.core.$strict>;
86
86
  presentation: z.ZodDiscriminatedUnion<[z.ZodObject<{
87
87
  type: z.ZodLiteral<"bearer">;
@@ -111,8 +111,8 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
111
111
  subagents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
112
112
  description: z.ZodOptional<z.ZodString>;
113
113
  prompt: z.ZodOptional<z.ZodString>;
114
- tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
115
114
  permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
115
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
116
116
  model: z.ZodOptional<z.ZodString>;
117
117
  maxSteps: z.ZodOptional<z.ZodNumber>;
118
118
  }, z.core.$strict>>>;
@@ -586,8 +586,8 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
586
586
  kind: z.ZodLiteral<"secret-ref">;
587
587
  key: z.ZodString;
588
588
  format: z.ZodOptional<z.ZodEnum<{
589
- bearer: "bearer";
590
589
  raw: "raw";
590
+ bearer: "bearer";
591
591
  }>>;
592
592
  }, z.core.$strict>], "kind">>>;
593
593
  timeoutMs: z.ZodOptional<z.ZodNumber>;
@@ -600,16 +600,16 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
600
600
  kind: z.ZodLiteral<"secret-ref">;
601
601
  key: z.ZodString;
602
602
  format: z.ZodOptional<z.ZodEnum<{
603
- bearer: "bearer";
604
603
  raw: "raw";
604
+ bearer: "bearer";
605
605
  }>>;
606
606
  }, z.core.$strict>], "kind">>>;
607
607
  }, z.core.$strict>>>>;
608
608
  modes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
609
609
  description: z.ZodOptional<z.ZodString>;
610
610
  prompt: z.ZodOptional<z.ZodString>;
611
- tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
612
611
  permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
612
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
613
613
  model: z.ZodOptional<z.ZodString>;
614
614
  }, z.core.$strict>>>;
615
615
  confidential: z.ZodOptional<z.ZodObject<{