@tangle-network/agent-interface 1.8.0 → 2.0.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 (48) hide show
  1. package/README.md +14 -0
  2. package/dist/agent-candidate-code-schema.d.ts +17 -17
  3. package/dist/agent-candidate-execution-plan-schema.d.ts +179 -179
  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 +17 -17
  7. package/dist/agent-candidate-promotion-schema.d.ts +1085 -1085
  8. package/dist/agent-candidate-receipt-schema.d.ts +195 -195
  9. package/dist/agent-candidate-schema-common.d.ts +6 -0
  10. package/dist/agent-candidate-schema-common.js +25 -10
  11. package/dist/agent-candidate-schema.d.ts +30 -30
  12. package/dist/agent-candidate-task-schema.d.ts +16 -16
  13. package/dist/agent-execution-limits.d.ts +1 -1
  14. package/dist/agent-execution-preparation-receipt.d.ts +71 -71
  15. package/dist/agent-improvement-measurement-schema.d.ts +26 -26
  16. package/dist/agent-instance.d.ts +2 -2
  17. package/dist/agent-profile-improvement-schema.d.ts +75 -75
  18. package/dist/agent-workspace-lease.d.ts +4 -4
  19. package/dist/certified-context.d.ts +2 -2
  20. package/dist/environment-command-turn.js +4 -1
  21. package/dist/environment-interactive-control.d.ts +422 -422
  22. package/dist/environment-interactive-start.d.ts +17 -17
  23. package/dist/environment-observation.d.ts +39 -39
  24. package/dist/environment-provider.d.ts +1 -0
  25. package/dist/environment-provider.js +1 -0
  26. package/dist/environment-requests.d.ts +22 -2
  27. package/dist/environment-requests.js +29 -1
  28. package/dist/environment-runtime.d.ts +53 -20
  29. package/dist/environment-runtime.js +23 -0
  30. package/dist/harness.d.ts +11 -11
  31. package/dist/index.d.ts +1 -1
  32. package/dist/index.js +1 -1
  33. package/dist/interaction-envelope.d.ts +26 -26
  34. package/dist/interaction-fields.d.ts +22 -22
  35. package/dist/interaction-permissions.d.ts +2 -2
  36. package/dist/portable-context-base.d.ts +1 -1
  37. package/dist/portable-context-continuation.d.ts +4 -4
  38. package/dist/portable-context-plan-request.d.ts +1 -1
  39. package/dist/portable-context-plan.d.ts +5 -5
  40. package/dist/portable-context-shared.d.ts +1 -1
  41. package/dist/portable-context-transfer.d.ts +6 -6
  42. package/dist/profile-schema.d.ts +37 -37
  43. package/dist/runtime-control.d.ts +10 -10
  44. package/dist/workspace-cleanup.d.ts +3 -3
  45. package/dist/workspace-cwd.d.ts +28 -0
  46. package/dist/workspace-cwd.js +77 -0
  47. package/dist/workspace-fork.d.ts +4 -4
  48. package/package.json +6 -6
@@ -122,10 +122,10 @@ export declare const agentCandidateMemoryPolicySchema: z.ZodDiscriminatedUnion<[
122
122
  }, z.core.$strict>], "mode">;
123
123
  export declare const agentCandidateLineageSchema: z.ZodObject<{
124
124
  source: z.ZodEnum<{
125
- human: "human";
126
- optimizer: "optimizer";
127
125
  compound: "compound";
126
+ human: "human";
128
127
  import: "import";
128
+ optimizer: "optimizer";
129
129
  }>;
130
130
  parentDigests: z.ZodOptional<z.ZodArray<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>>;
131
131
  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
- observed: "observed";
11
10
  estimated: "estimated";
11
+ observed: "observed";
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
- succeeded: "succeeded";
20
19
  failed: "failed";
20
+ succeeded: "succeeded";
21
21
  }>;
22
22
  model: z.ZodString;
23
23
  startedAtMs: z.ZodNumber;
@@ -29,33 +29,11 @@ export declare const agentCandidateModelSettlementCallSchema: z.ZodObject<{
29
29
  reasoningTokens: z.ZodNumber;
30
30
  costUsdNanos: z.ZodNumber;
31
31
  costProvenance: z.ZodEnum<{
32
- observed: "observed";
33
32
  estimated: "estimated";
33
+ observed: "observed";
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>>;
59
37
  kind: z.ZodLiteral<"agent-candidate-model-settlement-material">;
60
38
  executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
61
39
  preparationId: z.ZodString;
@@ -68,13 +46,13 @@ export declare const agentCandidateModelSettlementMaterialSchema: z.ZodObject<{
68
46
  model: z.ZodString;
69
47
  snapshot: z.ZodString;
70
48
  reasoningEffort: z.ZodEnum<{
71
- none: "none";
72
- minimal: "minimal";
49
+ high: "high";
73
50
  low: "low";
74
51
  medium: "medium";
75
- high: "high";
76
- xhigh: "xhigh";
52
+ minimal: "minimal";
53
+ none: "none";
77
54
  ultracode: "ultracode";
55
+ xhigh: "xhigh";
78
56
  }>;
79
57
  }, z.core.$strict>;
80
58
  usage: z.ZodObject<{
@@ -85,31 +63,37 @@ export declare const agentCandidateModelSettlementMaterialSchema: z.ZodObject<{
85
63
  modelCalls: z.ZodNumber;
86
64
  costUsdNanos: z.ZodNumber;
87
65
  costProvenance: z.ZodEnum<{
88
- observed: "observed";
89
66
  estimated: "estimated";
67
+ observed: "observed";
90
68
  }>;
91
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
+ estimated: "estimated";
89
+ observed: "observed";
90
+ }>;
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
- }[];
113
97
  kind: "agent-candidate-model-settlement-material";
114
98
  executionPlanDigest: `sha256:${string}`;
115
99
  preparationId: string;
@@ -121,7 +105,7 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
121
105
  provider: string;
122
106
  model: string;
123
107
  snapshot: string;
124
- reasoningEffort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
108
+ reasoningEffort: "high" | "low" | "medium" | "minimal" | "none" | "ultracode" | "xhigh";
125
109
  };
126
110
  usage: {
127
111
  inputTokens: number;
@@ -130,14 +114,13 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
130
114
  reasoningTokens: number;
131
115
  modelCalls: number;
132
116
  costUsdNanos: number;
133
- costProvenance: "observed" | "estimated";
117
+ costProvenance: "estimated" | "observed";
134
118
  };
135
- }, unknown, z.core.$ZodTypeInternals<{
136
119
  calls: {
137
120
  callId: string;
138
121
  generationId: string;
139
122
  traceSpanId: string;
140
- status: "succeeded" | "failed";
123
+ status: "failed" | "succeeded";
141
124
  model: string;
142
125
  startedAtMs: number;
143
126
  endedAtMs: number;
@@ -147,8 +130,9 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
147
130
  cachedInputTokens: number;
148
131
  reasoningTokens: number;
149
132
  costUsdNanos: number;
150
- costProvenance: "observed" | "estimated";
133
+ costProvenance: "estimated" | "observed";
151
134
  }[];
135
+ }, unknown, z.core.$ZodTypeInternals<{
152
136
  kind: "agent-candidate-model-settlement-material";
153
137
  executionPlanDigest: `sha256:${string}`;
154
138
  preparationId: string;
@@ -160,7 +144,7 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
160
144
  provider: string;
161
145
  model: string;
162
146
  snapshot: string;
163
- reasoningEffort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
147
+ reasoningEffort: "high" | "low" | "medium" | "minimal" | "none" | "ultracode" | "xhigh";
164
148
  };
165
149
  usage: {
166
150
  inputTokens: number;
@@ -169,8 +153,24 @@ export declare const agentCandidateModelSettlementEvidenceSchema: z.ZodObject<{
169
153
  reasoningTokens: number;
170
154
  modelCalls: number;
171
155
  costUsdNanos: number;
172
- costProvenance: "observed" | "estimated";
156
+ costProvenance: "estimated" | "observed";
173
157
  };
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<{
@@ -591,8 +591,8 @@ export declare const agentCandidateBenchmarkResultMaterialSchema: z.ZodObject<{
591
591
  modelCalls: z.ZodNumber;
592
592
  costUsdNanos: z.ZodNumber;
593
593
  costProvenance: z.ZodEnum<{
594
- observed: "observed";
595
594
  estimated: "estimated";
595
+ observed: "observed";
596
596
  }>;
597
597
  }, z.core.$strict>;
598
598
  timing: z.ZodObject<{
@@ -656,7 +656,7 @@ export declare const agentCandidateBenchmarkResultEvidenceSchema: z.ZodObject<{
656
656
  reasoningTokens: number;
657
657
  modelCalls: number;
658
658
  costUsdNanos: number;
659
- costProvenance: "observed" | "estimated";
659
+ costProvenance: "estimated" | "observed";
660
660
  };
661
661
  timing: {
662
662
  startedAtMs: number;
@@ -715,7 +715,7 @@ export declare const agentCandidateBenchmarkResultEvidenceSchema: z.ZodObject<{
715
715
  reasoningTokens: number;
716
716
  modelCalls: number;
717
717
  costUsdNanos: number;
718
- costProvenance: "observed" | "estimated";
718
+ costProvenance: "estimated" | "observed";
719
719
  };
720
720
  timing: {
721
721
  startedAtMs: number;
@@ -27,13 +27,13 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
27
27
  }, z.core.$strict>>;
28
28
  model: z.ZodOptional<z.ZodObject<{
29
29
  reasoningEffort: z.ZodOptional<z.ZodEnum<{
30
- none: "none";
31
- minimal: "minimal";
30
+ high: "high";
32
31
  low: "low";
33
32
  medium: "medium";
34
- high: "high";
35
- xhigh: "xhigh";
33
+ minimal: "minimal";
34
+ none: "none";
36
35
  ultracode: "ultracode";
36
+ xhigh: "xhigh";
37
37
  }>>;
38
38
  maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
39
39
  maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -43,22 +43,22 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
43
43
  provider: z.ZodOptional<z.ZodString>;
44
44
  }, z.core.$strict>>;
45
45
  harness: z.ZodOptional<z.ZodEnum<{
46
+ acp: "acp";
47
+ amp: "amp";
46
48
  "claude-code": "claude-code";
47
- nanoclaw: "nanoclaw";
49
+ "cli-base": "cli-base";
48
50
  codex: "codex";
49
- opencode: "opencode";
50
- "kimi-code": "kimi-code";
51
- pi: "pi";
52
- prime: "prime";
51
+ cursor: "cursor";
52
+ "factory-droids": "factory-droids";
53
+ forge: "forge";
53
54
  gemini: "gemini";
54
55
  hermes: "hermes";
56
+ "kimi-code": "kimi-code";
57
+ nanoclaw: "nanoclaw";
55
58
  openclaw: "openclaw";
56
- amp: "amp";
57
- "factory-droids": "factory-droids";
58
- forge: "forge";
59
- cursor: "cursor";
60
- acp: "acp";
61
- "cli-base": "cli-base";
59
+ opencode: "opencode";
60
+ pi: "pi";
61
+ prime: "prime";
62
62
  }>>;
63
63
  permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<{
64
64
  allow: "allow";
@@ -68,9 +68,9 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
68
68
  tools: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
69
69
  mcp: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<AgentCandidateMcpServer, unknown, z.core.$ZodTypeInternals<AgentCandidateMcpServer, unknown>>>>;
70
70
  subagents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
71
+ description: z.ZodOptional<z.ZodString>;
71
72
  prompt: z.ZodOptional<z.ZodString>;
72
73
  tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
73
- description: z.ZodOptional<z.ZodString>;
74
74
  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>>>;
75
75
  model: z.ZodOptional<z.ZodString>;
76
76
  maxSteps: z.ZodOptional<z.ZodNumber>;
@@ -547,9 +547,9 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
547
547
  }, z.core.$strict>>>;
548
548
  }, z.core.$strict>>>>;
549
549
  modes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
550
+ description: z.ZodOptional<z.ZodString>;
550
551
  prompt: z.ZodOptional<z.ZodString>;
551
552
  tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
552
- description: z.ZodOptional<z.ZodString>;
553
553
  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>>>;
554
554
  model: z.ZodOptional<z.ZodString>;
555
555
  }, z.core.$strict>>>;