@tangle-network/agent-interface 1.2.0 → 1.4.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.
@@ -1,1930 +1,2 @@
1
- import { z } from "zod";
2
- import type { AgentTerminalSession } from "./environment-terminal.js";
3
- import { type AgentExactRunControlRef } from "./runtime-control.js";
4
- declare const AgentInteractiveSessionRunCoordinatesSchema: z.ZodObject<{
5
- provider: z.ZodString;
6
- environmentId: z.ZodString;
7
- sessionId: z.ZodString;
8
- executionId: z.ZodString;
9
- }, z.core.$strict>;
10
- export type AgentInteractiveSessionRunCoordinates = z.infer<typeof AgentInteractiveSessionRunCoordinatesSchema>;
11
- /**
12
- * Durable identity of one coding-agent TUI.
13
- *
14
- * This reference identifies the exact admitted run and preparation receipt.
15
- * It is not a generic shell id and cannot be used to create another process.
16
- */
17
- export declare const AgentInteractiveSessionRefSchema: z.ZodObject<{
18
- run: z.ZodObject<{
19
- runId: z.ZodString;
20
- provider: z.ZodString;
21
- environmentId: z.ZodString;
22
- sessionId: z.ZodString;
23
- executionId: z.ZodString;
24
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
25
- }, z.core.$strict>;
26
- preparationReceipt: z.ZodObject<{
27
- kind: z.ZodLiteral<"agent-execution-preparation">;
28
- schemaVersion: z.ZodLiteral<1>;
29
- preparationId: z.ZodString;
30
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
31
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
32
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
33
- backend: z.ZodString;
34
- harness: z.ZodEnum<{
35
- "claude-code": "claude-code";
36
- nanoclaw: "nanoclaw";
37
- codex: "codex";
38
- opencode: "opencode";
39
- "kimi-code": "kimi-code";
40
- pi: "pi";
41
- prime: "prime";
42
- gemini: "gemini";
43
- hermes: "hermes";
44
- openclaw: "openclaw";
45
- amp: "amp";
46
- "factory-droids": "factory-droids";
47
- forge: "forge";
48
- cursor: "cursor";
49
- acp: "acp";
50
- "cli-base": "cli-base";
51
- }>;
52
- harnessVersion: z.ZodString;
53
- resolvedModel: z.ZodObject<{
54
- requested: z.ZodString;
55
- resolved: z.ZodString;
56
- provider: z.ZodOptional<z.ZodString>;
57
- reasoningEffort: z.ZodOptional<z.ZodObject<{
58
- requested: z.ZodEnum<{
59
- none: "none";
60
- minimal: "minimal";
61
- low: "low";
62
- medium: "medium";
63
- high: "high";
64
- xhigh: "xhigh";
65
- ultracode: "ultracode";
66
- }>;
67
- resolved: z.ZodOptional<z.ZodEnum<{
68
- none: "none";
69
- minimal: "minimal";
70
- low: "low";
71
- medium: "medium";
72
- high: "high";
73
- xhigh: "xhigh";
74
- ultracode: "ultracode";
75
- }>>;
76
- fidelity: z.ZodEnum<{
77
- exact: "exact";
78
- unsupported: "unsupported";
79
- clamped: "clamped";
80
- }>;
81
- }, z.core.$strict>>;
82
- }, z.core.$strict>;
83
- workspace: z.ZodObject<{
84
- leaseId: z.ZodString;
85
- provider: z.ZodString;
86
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
87
- isolation: z.ZodEnum<{
88
- "per-run": "per-run";
89
- shared: "shared";
90
- }>;
91
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
92
- sourceSnapshotPolicy: z.ZodObject<{
93
- kind: z.ZodLiteral<"provider-declared">;
94
- name: z.ZodString;
95
- version: z.ZodNumber;
96
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
97
- }, z.core.$strict>;
98
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
99
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
100
- }, z.core.$strict>;
101
- axisResults: z.ZodArray<z.ZodObject<{
102
- axis: z.ZodEnum<{
103
- name: "name";
104
- systemPrompt: "systemPrompt";
105
- appendSystemPrompt: "appendSystemPrompt";
106
- instructions: "instructions";
107
- files: "files";
108
- tools: "tools";
109
- skills: "skills";
110
- commands: "commands";
111
- description: "description";
112
- version: "version";
113
- tags: "tags";
114
- harness: "harness";
115
- permissions: "permissions";
116
- mcp: "mcp";
117
- connections: "connections";
118
- subagents: "subagents";
119
- hooks: "hooks";
120
- modes: "modes";
121
- confidential: "confidential";
122
- metadata: "metadata";
123
- extensions: "extensions";
124
- modelDefault: "modelDefault";
125
- modelSmall: "modelSmall";
126
- modelProvider: "modelProvider";
127
- modelReasoningEffort: "modelReasoningEffort";
128
- modelMetadata: "modelMetadata";
129
- resourceTools: "resourceTools";
130
- resourceAgents: "resourceAgents";
131
- resourceInstructions: "resourceInstructions";
132
- resourceFailOnError: "resourceFailOnError";
133
- }>;
134
- disposition: z.ZodEnum<{
135
- unsupported: "unsupported";
136
- behavior: "behavior";
137
- control: "control";
138
- overridden: "overridden";
139
- }>;
140
- owner: z.ZodEnum<{
141
- runtime: "runtime";
142
- executor: "executor";
143
- }>;
144
- mechanism: z.ZodString;
145
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
146
- path: z.ZodOptional<z.ZodString>;
147
- reason: z.ZodOptional<z.ZodString>;
148
- }, z.core.$strict>>;
149
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
150
- materializer: z.ZodObject<{
151
- name: z.ZodString;
152
- version: z.ZodString;
153
- }, z.core.$strict>;
154
- expiresAtMs: z.ZodNumber;
155
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
156
- }, z.core.$strict>;
157
- incarnationId: z.ZodString;
158
- startedAt: z.ZodISODateTime;
159
- }, z.core.$strict>;
160
- export type AgentInteractiveSessionRef = z.infer<typeof AgentInteractiveSessionRefSchema>;
161
- /**
162
- * Provider-issued write authority for one exact interactive process.
163
- *
164
- * Expiry blocks mutations but does not kill the coding process. A coordinator
165
- * can issue a new compare-and-swap claim after expiry. The provider's PTY owner
166
- * lease remains the separate process-cleanup authority.
167
- */
168
- export declare const AgentInteractiveSessionControlClaimSchema: z.ZodObject<{
169
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
170
- generation: z.ZodNumber;
171
- leaseId: z.ZodString;
172
- holderId: z.ZodString;
173
- expiresAt: z.ZodISODateTime;
174
- }, z.core.$strict>;
175
- export type AgentInteractiveSessionControlClaim = z.infer<typeof AgentInteractiveSessionControlClaimSchema>;
176
- export interface AgentInteractiveSessionControlClaimRequestMaterial {
177
- operationId: string;
178
- ref: AgentInteractiveSessionRef;
179
- holderId: string;
180
- /** Compare-and-swap value. Use zero when no coordinator currently holds a claim. */
181
- expectedGeneration: number;
182
- }
183
- export interface AgentInteractiveSessionControlClaimRequest extends AgentInteractiveSessionControlClaimRequestMaterial {
184
- requestDigest: `sha256:${string}`;
185
- }
186
- export declare function agentInteractiveSessionControlClaimRequestDigest(value: AgentInteractiveSessionControlClaimRequestMaterial): `sha256:${string}`;
187
- export declare const AgentInteractiveSessionControlClaimRequestSchema: z.ZodObject<{
188
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
189
- operationId: z.ZodString;
190
- ref: z.ZodObject<{
191
- run: z.ZodObject<{
192
- runId: z.ZodString;
193
- provider: z.ZodString;
194
- environmentId: z.ZodString;
195
- sessionId: z.ZodString;
196
- executionId: z.ZodString;
197
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
198
- }, z.core.$strict>;
199
- preparationReceipt: z.ZodObject<{
200
- kind: z.ZodLiteral<"agent-execution-preparation">;
201
- schemaVersion: z.ZodLiteral<1>;
202
- preparationId: z.ZodString;
203
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
204
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
205
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
206
- backend: z.ZodString;
207
- harness: z.ZodEnum<{
208
- "claude-code": "claude-code";
209
- nanoclaw: "nanoclaw";
210
- codex: "codex";
211
- opencode: "opencode";
212
- "kimi-code": "kimi-code";
213
- pi: "pi";
214
- prime: "prime";
215
- gemini: "gemini";
216
- hermes: "hermes";
217
- openclaw: "openclaw";
218
- amp: "amp";
219
- "factory-droids": "factory-droids";
220
- forge: "forge";
221
- cursor: "cursor";
222
- acp: "acp";
223
- "cli-base": "cli-base";
224
- }>;
225
- harnessVersion: z.ZodString;
226
- resolvedModel: z.ZodObject<{
227
- requested: z.ZodString;
228
- resolved: z.ZodString;
229
- provider: z.ZodOptional<z.ZodString>;
230
- reasoningEffort: z.ZodOptional<z.ZodObject<{
231
- requested: z.ZodEnum<{
232
- none: "none";
233
- minimal: "minimal";
234
- low: "low";
235
- medium: "medium";
236
- high: "high";
237
- xhigh: "xhigh";
238
- ultracode: "ultracode";
239
- }>;
240
- resolved: z.ZodOptional<z.ZodEnum<{
241
- none: "none";
242
- minimal: "minimal";
243
- low: "low";
244
- medium: "medium";
245
- high: "high";
246
- xhigh: "xhigh";
247
- ultracode: "ultracode";
248
- }>>;
249
- fidelity: z.ZodEnum<{
250
- exact: "exact";
251
- unsupported: "unsupported";
252
- clamped: "clamped";
253
- }>;
254
- }, z.core.$strict>>;
255
- }, z.core.$strict>;
256
- workspace: z.ZodObject<{
257
- leaseId: z.ZodString;
258
- provider: z.ZodString;
259
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
260
- isolation: z.ZodEnum<{
261
- "per-run": "per-run";
262
- shared: "shared";
263
- }>;
264
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
265
- sourceSnapshotPolicy: z.ZodObject<{
266
- kind: z.ZodLiteral<"provider-declared">;
267
- name: z.ZodString;
268
- version: z.ZodNumber;
269
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
270
- }, z.core.$strict>;
271
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
272
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
273
- }, z.core.$strict>;
274
- axisResults: z.ZodArray<z.ZodObject<{
275
- axis: z.ZodEnum<{
276
- name: "name";
277
- systemPrompt: "systemPrompt";
278
- appendSystemPrompt: "appendSystemPrompt";
279
- instructions: "instructions";
280
- files: "files";
281
- tools: "tools";
282
- skills: "skills";
283
- commands: "commands";
284
- description: "description";
285
- version: "version";
286
- tags: "tags";
287
- harness: "harness";
288
- permissions: "permissions";
289
- mcp: "mcp";
290
- connections: "connections";
291
- subagents: "subagents";
292
- hooks: "hooks";
293
- modes: "modes";
294
- confidential: "confidential";
295
- metadata: "metadata";
296
- extensions: "extensions";
297
- modelDefault: "modelDefault";
298
- modelSmall: "modelSmall";
299
- modelProvider: "modelProvider";
300
- modelReasoningEffort: "modelReasoningEffort";
301
- modelMetadata: "modelMetadata";
302
- resourceTools: "resourceTools";
303
- resourceAgents: "resourceAgents";
304
- resourceInstructions: "resourceInstructions";
305
- resourceFailOnError: "resourceFailOnError";
306
- }>;
307
- disposition: z.ZodEnum<{
308
- unsupported: "unsupported";
309
- behavior: "behavior";
310
- control: "control";
311
- overridden: "overridden";
312
- }>;
313
- owner: z.ZodEnum<{
314
- runtime: "runtime";
315
- executor: "executor";
316
- }>;
317
- mechanism: z.ZodString;
318
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
319
- path: z.ZodOptional<z.ZodString>;
320
- reason: z.ZodOptional<z.ZodString>;
321
- }, z.core.$strict>>;
322
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
323
- materializer: z.ZodObject<{
324
- name: z.ZodString;
325
- version: z.ZodString;
326
- }, z.core.$strict>;
327
- expiresAtMs: z.ZodNumber;
328
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
329
- }, z.core.$strict>;
330
- incarnationId: z.ZodString;
331
- startedAt: z.ZodISODateTime;
332
- }, z.core.$strict>;
333
- holderId: z.ZodString;
334
- expectedGeneration: z.ZodNumber;
335
- }, z.core.$strict>;
336
- export interface AgentInteractiveSessionControlClaimAcknowledgement {
337
- operationId: string;
338
- requestDigest: `sha256:${string}`;
339
- ref: AgentInteractiveSessionRef;
340
- status: "accepted" | "replayed" | "conflict" | "unknown";
341
- control?: AgentInteractiveSessionControlClaim;
342
- /** Why a provider rejected this claim request. */
343
- conflictReason?: "generation_mismatch" | "operation_reuse";
344
- /** Current non-secret generation for a compare-and-swap conflict. */
345
- currentGeneration?: number;
346
- /** Present when this operation id already names different material. */
347
- existingRequestDigest?: `sha256:${string}`;
348
- message?: string;
349
- retryable?: boolean;
350
- }
351
- export declare const AgentInteractiveSessionControlClaimAcknowledgementSchema: z.ZodObject<{
352
- operationId: z.ZodString;
353
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
354
- ref: z.ZodObject<{
355
- run: z.ZodObject<{
356
- runId: z.ZodString;
357
- provider: z.ZodString;
358
- environmentId: z.ZodString;
359
- sessionId: z.ZodString;
360
- executionId: z.ZodString;
361
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
362
- }, z.core.$strict>;
363
- preparationReceipt: z.ZodObject<{
364
- kind: z.ZodLiteral<"agent-execution-preparation">;
365
- schemaVersion: z.ZodLiteral<1>;
366
- preparationId: z.ZodString;
367
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
368
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
369
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
370
- backend: z.ZodString;
371
- harness: z.ZodEnum<{
372
- "claude-code": "claude-code";
373
- nanoclaw: "nanoclaw";
374
- codex: "codex";
375
- opencode: "opencode";
376
- "kimi-code": "kimi-code";
377
- pi: "pi";
378
- prime: "prime";
379
- gemini: "gemini";
380
- hermes: "hermes";
381
- openclaw: "openclaw";
382
- amp: "amp";
383
- "factory-droids": "factory-droids";
384
- forge: "forge";
385
- cursor: "cursor";
386
- acp: "acp";
387
- "cli-base": "cli-base";
388
- }>;
389
- harnessVersion: z.ZodString;
390
- resolvedModel: z.ZodObject<{
391
- requested: z.ZodString;
392
- resolved: z.ZodString;
393
- provider: z.ZodOptional<z.ZodString>;
394
- reasoningEffort: z.ZodOptional<z.ZodObject<{
395
- requested: z.ZodEnum<{
396
- none: "none";
397
- minimal: "minimal";
398
- low: "low";
399
- medium: "medium";
400
- high: "high";
401
- xhigh: "xhigh";
402
- ultracode: "ultracode";
403
- }>;
404
- resolved: z.ZodOptional<z.ZodEnum<{
405
- none: "none";
406
- minimal: "minimal";
407
- low: "low";
408
- medium: "medium";
409
- high: "high";
410
- xhigh: "xhigh";
411
- ultracode: "ultracode";
412
- }>>;
413
- fidelity: z.ZodEnum<{
414
- exact: "exact";
415
- unsupported: "unsupported";
416
- clamped: "clamped";
417
- }>;
418
- }, z.core.$strict>>;
419
- }, z.core.$strict>;
420
- workspace: z.ZodObject<{
421
- leaseId: z.ZodString;
422
- provider: z.ZodString;
423
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
424
- isolation: z.ZodEnum<{
425
- "per-run": "per-run";
426
- shared: "shared";
427
- }>;
428
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
429
- sourceSnapshotPolicy: z.ZodObject<{
430
- kind: z.ZodLiteral<"provider-declared">;
431
- name: z.ZodString;
432
- version: z.ZodNumber;
433
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
434
- }, z.core.$strict>;
435
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
436
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
437
- }, z.core.$strict>;
438
- axisResults: z.ZodArray<z.ZodObject<{
439
- axis: z.ZodEnum<{
440
- name: "name";
441
- systemPrompt: "systemPrompt";
442
- appendSystemPrompt: "appendSystemPrompt";
443
- instructions: "instructions";
444
- files: "files";
445
- tools: "tools";
446
- skills: "skills";
447
- commands: "commands";
448
- description: "description";
449
- version: "version";
450
- tags: "tags";
451
- harness: "harness";
452
- permissions: "permissions";
453
- mcp: "mcp";
454
- connections: "connections";
455
- subagents: "subagents";
456
- hooks: "hooks";
457
- modes: "modes";
458
- confidential: "confidential";
459
- metadata: "metadata";
460
- extensions: "extensions";
461
- modelDefault: "modelDefault";
462
- modelSmall: "modelSmall";
463
- modelProvider: "modelProvider";
464
- modelReasoningEffort: "modelReasoningEffort";
465
- modelMetadata: "modelMetadata";
466
- resourceTools: "resourceTools";
467
- resourceAgents: "resourceAgents";
468
- resourceInstructions: "resourceInstructions";
469
- resourceFailOnError: "resourceFailOnError";
470
- }>;
471
- disposition: z.ZodEnum<{
472
- unsupported: "unsupported";
473
- behavior: "behavior";
474
- control: "control";
475
- overridden: "overridden";
476
- }>;
477
- owner: z.ZodEnum<{
478
- runtime: "runtime";
479
- executor: "executor";
480
- }>;
481
- mechanism: z.ZodString;
482
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
483
- path: z.ZodOptional<z.ZodString>;
484
- reason: z.ZodOptional<z.ZodString>;
485
- }, z.core.$strict>>;
486
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
487
- materializer: z.ZodObject<{
488
- name: z.ZodString;
489
- version: z.ZodString;
490
- }, z.core.$strict>;
491
- expiresAtMs: z.ZodNumber;
492
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
493
- }, z.core.$strict>;
494
- incarnationId: z.ZodString;
495
- startedAt: z.ZodISODateTime;
496
- }, z.core.$strict>;
497
- status: z.ZodEnum<{
498
- unknown: "unknown";
499
- conflict: "conflict";
500
- accepted: "accepted";
501
- replayed: "replayed";
502
- }>;
503
- control: z.ZodOptional<z.ZodObject<{
504
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
505
- generation: z.ZodNumber;
506
- leaseId: z.ZodString;
507
- holderId: z.ZodString;
508
- expiresAt: z.ZodISODateTime;
509
- }, z.core.$strict>>;
510
- conflictReason: z.ZodOptional<z.ZodEnum<{
511
- generation_mismatch: "generation_mismatch";
512
- operation_reuse: "operation_reuse";
513
- }>>;
514
- currentGeneration: z.ZodOptional<z.ZodNumber>;
515
- existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
516
- message: z.ZodOptional<z.ZodString>;
517
- retryable: z.ZodOptional<z.ZodBoolean>;
518
- }, z.core.$strict>;
519
- export declare function agentInteractiveSessionControlClaimAcknowledgementMatchesRequest(request: AgentInteractiveSessionControlClaimRequest, acknowledgement: AgentInteractiveSessionControlClaimAcknowledgement): boolean;
520
- /** Bind a provider-issued control claim to the exact process it can mutate. */
521
- export declare function agentInteractiveSessionControlClaimMatchesRef(ref: AgentInteractiveSessionRef, claim: AgentInteractiveSessionControlClaim): boolean;
522
- /** Compare two claims for one process without making a provider state claim. */
523
- export declare function agentInteractiveSessionControlClaimIsNewer(candidate: AgentInteractiveSessionControlClaim, current: AgentInteractiveSessionControlClaim): boolean;
524
- /**
525
- * Start one native coding-agent TUI from caller-owned request material.
526
- *
527
- * The provider owns profile materialization and returns its preparation receipt
528
- * in the resulting reference. Replaying the same exact request/run returns the
529
- * same reference, even after the process exits; changed material cannot reuse it.
530
- */
531
- export declare const AgentInteractiveSessionStartSchema: z.ZodObject<{
532
- run: z.ZodObject<{
533
- runId: z.ZodString;
534
- provider: z.ZodString;
535
- environmentId: z.ZodString;
536
- sessionId: z.ZodString;
537
- executionId: z.ZodString;
538
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
539
- }, z.core.$strict>;
540
- profile: z.ZodObject<{
541
- name: z.ZodOptional<z.ZodString>;
542
- description: z.ZodOptional<z.ZodString>;
543
- version: z.ZodOptional<z.ZodString>;
544
- tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
545
- prompt: z.ZodOptional<z.ZodObject<{
546
- systemPrompt: z.ZodOptional<z.ZodString>;
547
- appendSystemPrompt: z.ZodOptional<z.ZodString>;
548
- instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
549
- }, z.core.$strict>>;
550
- model: z.ZodOptional<z.ZodObject<{
551
- default: z.ZodOptional<z.ZodString>;
552
- small: z.ZodOptional<z.ZodString>;
553
- provider: z.ZodOptional<z.ZodString>;
554
- reasoningEffort: z.ZodOptional<z.ZodEnum<{
555
- none: "none";
556
- minimal: "minimal";
557
- low: "low";
558
- medium: "medium";
559
- high: "high";
560
- xhigh: "xhigh";
561
- ultracode: "ultracode";
562
- }>>;
563
- maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
564
- maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
565
- maxTotalOutputTokens: z.ZodOptional<z.ZodNumber>;
566
- metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
567
- }, z.core.$strict>>;
568
- harness: z.ZodOptional<z.ZodEnum<{
569
- "claude-code": "claude-code";
570
- nanoclaw: "nanoclaw";
571
- codex: "codex";
572
- opencode: "opencode";
573
- "kimi-code": "kimi-code";
574
- pi: "pi";
575
- prime: "prime";
576
- gemini: "gemini";
577
- hermes: "hermes";
578
- openclaw: "openclaw";
579
- amp: "amp";
580
- "factory-droids": "factory-droids";
581
- forge: "forge";
582
- cursor: "cursor";
583
- acp: "acp";
584
- "cli-base": "cli-base";
585
- }>>;
586
- 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>>>;
587
- tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
588
- mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
589
- connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
590
- connectionId: z.ZodString;
591
- capabilities: z.ZodArray<z.ZodString>;
592
- alias: z.ZodOptional<z.ZodString>;
593
- }, z.core.$strict>>>;
594
- subagents: z.ZodOptional<z.ZodType<Record<string, {
595
- description?: string | undefined;
596
- prompt?: string | undefined;
597
- model?: string | undefined;
598
- tools?: Record<string, boolean> | undefined;
599
- permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
600
- maxSteps?: number | undefined;
601
- metadata?: Record<string, unknown> | undefined;
602
- }>, unknown, z.core.$ZodTypeInternals<Record<string, {
603
- description?: string | undefined;
604
- prompt?: string | undefined;
605
- model?: string | undefined;
606
- tools?: Record<string, boolean> | undefined;
607
- permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
608
- maxSteps?: number | undefined;
609
- metadata?: Record<string, unknown> | undefined;
610
- }>, unknown>>>;
611
- resources: z.ZodOptional<z.ZodObject<{
612
- files: z.ZodOptional<z.ZodArray<z.ZodObject<{
613
- path: z.ZodString;
614
- resource: z.ZodUnion<readonly [z.ZodObject<{
615
- kind: z.ZodLiteral<"inline">;
616
- name: z.ZodString;
617
- content: z.ZodString;
618
- }, z.core.$strict>, z.ZodObject<{
619
- kind: z.ZodLiteral<"github">;
620
- repository: z.ZodOptional<z.ZodString>;
621
- path: z.ZodString;
622
- ref: z.ZodOptional<z.ZodString>;
623
- name: z.ZodOptional<z.ZodString>;
624
- }, z.core.$strict>]>;
625
- executable: z.ZodOptional<z.ZodBoolean>;
626
- }, z.core.$strict>>>;
627
- tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
628
- kind: z.ZodLiteral<"inline">;
629
- name: z.ZodString;
630
- content: z.ZodString;
631
- }, z.core.$strict>, z.ZodObject<{
632
- kind: z.ZodLiteral<"github">;
633
- repository: z.ZodOptional<z.ZodString>;
634
- path: z.ZodString;
635
- ref: z.ZodOptional<z.ZodString>;
636
- name: z.ZodOptional<z.ZodString>;
637
- }, z.core.$strict>]>>>;
638
- skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
639
- kind: z.ZodLiteral<"inline">;
640
- name: z.ZodString;
641
- content: z.ZodString;
642
- }, z.core.$strict>, z.ZodObject<{
643
- kind: z.ZodLiteral<"github">;
644
- repository: z.ZodOptional<z.ZodString>;
645
- path: z.ZodString;
646
- ref: z.ZodOptional<z.ZodString>;
647
- name: z.ZodOptional<z.ZodString>;
648
- }, z.core.$strict>]>>>;
649
- agents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
650
- kind: z.ZodLiteral<"inline">;
651
- name: z.ZodString;
652
- content: z.ZodString;
653
- }, z.core.$strict>, z.ZodObject<{
654
- kind: z.ZodLiteral<"github">;
655
- repository: z.ZodOptional<z.ZodString>;
656
- path: z.ZodString;
657
- ref: z.ZodOptional<z.ZodString>;
658
- name: z.ZodOptional<z.ZodString>;
659
- }, z.core.$strict>]>>>;
660
- commands: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
661
- kind: z.ZodLiteral<"inline">;
662
- name: z.ZodString;
663
- content: z.ZodString;
664
- }, z.core.$strict>, z.ZodObject<{
665
- kind: z.ZodLiteral<"github">;
666
- repository: z.ZodOptional<z.ZodString>;
667
- path: z.ZodString;
668
- ref: z.ZodOptional<z.ZodString>;
669
- name: z.ZodOptional<z.ZodString>;
670
- }, z.core.$strict>]>>>;
671
- instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
672
- kind: z.ZodLiteral<"inline">;
673
- name: z.ZodString;
674
- content: z.ZodString;
675
- }, z.core.$strict>, z.ZodObject<{
676
- kind: z.ZodLiteral<"github">;
677
- repository: z.ZodOptional<z.ZodString>;
678
- path: z.ZodString;
679
- ref: z.ZodOptional<z.ZodString>;
680
- name: z.ZodOptional<z.ZodString>;
681
- }, z.core.$strict>]>]>>;
682
- failOnError: z.ZodOptional<z.ZodBoolean>;
683
- }, z.core.$strict>>;
684
- hooks: z.ZodOptional<z.ZodType<Record<string, {
685
- command: string;
686
- timeoutMs?: number | undefined;
687
- blocking?: boolean | undefined;
688
- matcher?: string | undefined;
689
- env?: Record<string, {
690
- kind: "public";
691
- value: string;
692
- } | {
693
- kind: "secret-ref";
694
- key: string;
695
- format?: "raw" | "bearer" | undefined;
696
- }> | undefined;
697
- }[]>, unknown, z.core.$ZodTypeInternals<Record<string, {
698
- command: string;
699
- timeoutMs?: number | undefined;
700
- blocking?: boolean | undefined;
701
- matcher?: string | undefined;
702
- env?: Record<string, {
703
- kind: "public";
704
- value: string;
705
- } | {
706
- kind: "secret-ref";
707
- key: string;
708
- format?: "raw" | "bearer" | undefined;
709
- }> | undefined;
710
- }[]>, unknown>>>;
711
- modes: z.ZodOptional<z.ZodType<Record<string, {
712
- description?: string | undefined;
713
- model?: string | undefined;
714
- prompt?: string | undefined;
715
- tools?: Record<string, boolean> | undefined;
716
- permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
717
- metadata?: Record<string, unknown> | undefined;
718
- }>, unknown, z.core.$ZodTypeInternals<Record<string, {
719
- description?: string | undefined;
720
- model?: string | undefined;
721
- prompt?: string | undefined;
722
- tools?: Record<string, boolean> | undefined;
723
- permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
724
- metadata?: Record<string, unknown> | undefined;
725
- }>, unknown>>>;
726
- confidential: z.ZodOptional<z.ZodObject<{
727
- tee: z.ZodOptional<z.ZodString>;
728
- attestationNonce: z.ZodOptional<z.ZodString>;
729
- sealed: z.ZodOptional<z.ZodBoolean>;
730
- attestationRefresh: z.ZodOptional<z.ZodBoolean>;
731
- }, z.core.$strict>>;
732
- metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
733
- extensions: z.ZodOptional<z.ZodType<Record<string, Record<string, unknown> | undefined>, unknown, z.core.$ZodTypeInternals<Record<string, Record<string, unknown> | undefined>, unknown>>>;
734
- }, z.core.$strict>;
735
- requestedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
736
- initialPrompt: z.ZodOptional<z.ZodString>;
737
- cwd: z.ZodOptional<z.ZodString>;
738
- cols: z.ZodOptional<z.ZodNumber>;
739
- rows: z.ZodOptional<z.ZodNumber>;
740
- }, z.core.$strict>;
741
- export type AgentInteractiveSessionStart = z.infer<typeof AgentInteractiveSessionStartSchema>;
742
- export type AgentInteractiveSessionStartInput = Omit<AgentInteractiveSessionStart, "run">;
743
- /** Digest the exact process-start request independently of its derived run id. */
744
- export declare function agentInteractiveSessionRequestDigest(coordinates: AgentInteractiveSessionRunCoordinates, input: AgentInteractiveSessionStartInput): `sha256:${string}`;
745
- /** Mint the one exact run reference a provider must acknowledge for this start. */
746
- export declare function agentInteractiveSessionRunRef(coordinates: AgentInteractiveSessionRunCoordinates, input: AgentInteractiveSessionStartInput): AgentExactRunControlRef;
747
- /** Geometry for one attachment to the existing coding-agent TUI. */
748
- export declare const AgentInteractiveSessionAttachSchema: z.ZodObject<{
749
- control: z.ZodObject<{
750
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
751
- generation: z.ZodNumber;
752
- leaseId: z.ZodString;
753
- holderId: z.ZodString;
754
- expiresAt: z.ZodISODateTime;
755
- }, z.core.$strict>;
756
- cols: z.ZodOptional<z.ZodNumber>;
757
- rows: z.ZodOptional<z.ZodNumber>;
758
- }, z.core.$strict>;
759
- export type AgentInteractiveSessionAttach = z.infer<typeof AgentInteractiveSessionAttachSchema>;
760
- /** Provider-observed lifecycle of one native coding-agent TUI. */
761
- export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
762
- state: z.ZodLiteral<"running">;
763
- ref: z.ZodObject<{
764
- run: z.ZodObject<{
765
- runId: z.ZodString;
766
- provider: z.ZodString;
767
- environmentId: z.ZodString;
768
- sessionId: z.ZodString;
769
- executionId: z.ZodString;
770
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
771
- }, z.core.$strict>;
772
- preparationReceipt: z.ZodObject<{
773
- kind: z.ZodLiteral<"agent-execution-preparation">;
774
- schemaVersion: z.ZodLiteral<1>;
775
- preparationId: z.ZodString;
776
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
777
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
778
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
779
- backend: z.ZodString;
780
- harness: z.ZodEnum<{
781
- "claude-code": "claude-code";
782
- nanoclaw: "nanoclaw";
783
- codex: "codex";
784
- opencode: "opencode";
785
- "kimi-code": "kimi-code";
786
- pi: "pi";
787
- prime: "prime";
788
- gemini: "gemini";
789
- hermes: "hermes";
790
- openclaw: "openclaw";
791
- amp: "amp";
792
- "factory-droids": "factory-droids";
793
- forge: "forge";
794
- cursor: "cursor";
795
- acp: "acp";
796
- "cli-base": "cli-base";
797
- }>;
798
- harnessVersion: z.ZodString;
799
- resolvedModel: z.ZodObject<{
800
- requested: z.ZodString;
801
- resolved: z.ZodString;
802
- provider: z.ZodOptional<z.ZodString>;
803
- reasoningEffort: z.ZodOptional<z.ZodObject<{
804
- requested: z.ZodEnum<{
805
- none: "none";
806
- minimal: "minimal";
807
- low: "low";
808
- medium: "medium";
809
- high: "high";
810
- xhigh: "xhigh";
811
- ultracode: "ultracode";
812
- }>;
813
- resolved: z.ZodOptional<z.ZodEnum<{
814
- none: "none";
815
- minimal: "minimal";
816
- low: "low";
817
- medium: "medium";
818
- high: "high";
819
- xhigh: "xhigh";
820
- ultracode: "ultracode";
821
- }>>;
822
- fidelity: z.ZodEnum<{
823
- exact: "exact";
824
- unsupported: "unsupported";
825
- clamped: "clamped";
826
- }>;
827
- }, z.core.$strict>>;
828
- }, z.core.$strict>;
829
- workspace: z.ZodObject<{
830
- leaseId: z.ZodString;
831
- provider: z.ZodString;
832
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
833
- isolation: z.ZodEnum<{
834
- "per-run": "per-run";
835
- shared: "shared";
836
- }>;
837
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
838
- sourceSnapshotPolicy: z.ZodObject<{
839
- kind: z.ZodLiteral<"provider-declared">;
840
- name: z.ZodString;
841
- version: z.ZodNumber;
842
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
843
- }, z.core.$strict>;
844
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
845
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
846
- }, z.core.$strict>;
847
- axisResults: z.ZodArray<z.ZodObject<{
848
- axis: z.ZodEnum<{
849
- name: "name";
850
- systemPrompt: "systemPrompt";
851
- appendSystemPrompt: "appendSystemPrompt";
852
- instructions: "instructions";
853
- files: "files";
854
- tools: "tools";
855
- skills: "skills";
856
- commands: "commands";
857
- description: "description";
858
- version: "version";
859
- tags: "tags";
860
- harness: "harness";
861
- permissions: "permissions";
862
- mcp: "mcp";
863
- connections: "connections";
864
- subagents: "subagents";
865
- hooks: "hooks";
866
- modes: "modes";
867
- confidential: "confidential";
868
- metadata: "metadata";
869
- extensions: "extensions";
870
- modelDefault: "modelDefault";
871
- modelSmall: "modelSmall";
872
- modelProvider: "modelProvider";
873
- modelReasoningEffort: "modelReasoningEffort";
874
- modelMetadata: "modelMetadata";
875
- resourceTools: "resourceTools";
876
- resourceAgents: "resourceAgents";
877
- resourceInstructions: "resourceInstructions";
878
- resourceFailOnError: "resourceFailOnError";
879
- }>;
880
- disposition: z.ZodEnum<{
881
- unsupported: "unsupported";
882
- behavior: "behavior";
883
- control: "control";
884
- overridden: "overridden";
885
- }>;
886
- owner: z.ZodEnum<{
887
- runtime: "runtime";
888
- executor: "executor";
889
- }>;
890
- mechanism: z.ZodString;
891
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
892
- path: z.ZodOptional<z.ZodString>;
893
- reason: z.ZodOptional<z.ZodString>;
894
- }, z.core.$strict>>;
895
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
896
- materializer: z.ZodObject<{
897
- name: z.ZodString;
898
- version: z.ZodString;
899
- }, z.core.$strict>;
900
- expiresAtMs: z.ZodNumber;
901
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
902
- }, z.core.$strict>;
903
- incarnationId: z.ZodString;
904
- startedAt: z.ZodISODateTime;
905
- }, z.core.$strict>;
906
- }, z.core.$strict>, z.ZodObject<{
907
- state: z.ZodLiteral<"exited">;
908
- ref: z.ZodObject<{
909
- run: z.ZodObject<{
910
- runId: z.ZodString;
911
- provider: z.ZodString;
912
- environmentId: z.ZodString;
913
- sessionId: z.ZodString;
914
- executionId: z.ZodString;
915
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
916
- }, z.core.$strict>;
917
- preparationReceipt: z.ZodObject<{
918
- kind: z.ZodLiteral<"agent-execution-preparation">;
919
- schemaVersion: z.ZodLiteral<1>;
920
- preparationId: z.ZodString;
921
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
922
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
923
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
924
- backend: z.ZodString;
925
- harness: z.ZodEnum<{
926
- "claude-code": "claude-code";
927
- nanoclaw: "nanoclaw";
928
- codex: "codex";
929
- opencode: "opencode";
930
- "kimi-code": "kimi-code";
931
- pi: "pi";
932
- prime: "prime";
933
- gemini: "gemini";
934
- hermes: "hermes";
935
- openclaw: "openclaw";
936
- amp: "amp";
937
- "factory-droids": "factory-droids";
938
- forge: "forge";
939
- cursor: "cursor";
940
- acp: "acp";
941
- "cli-base": "cli-base";
942
- }>;
943
- harnessVersion: z.ZodString;
944
- resolvedModel: z.ZodObject<{
945
- requested: z.ZodString;
946
- resolved: z.ZodString;
947
- provider: z.ZodOptional<z.ZodString>;
948
- reasoningEffort: z.ZodOptional<z.ZodObject<{
949
- requested: z.ZodEnum<{
950
- none: "none";
951
- minimal: "minimal";
952
- low: "low";
953
- medium: "medium";
954
- high: "high";
955
- xhigh: "xhigh";
956
- ultracode: "ultracode";
957
- }>;
958
- resolved: z.ZodOptional<z.ZodEnum<{
959
- none: "none";
960
- minimal: "minimal";
961
- low: "low";
962
- medium: "medium";
963
- high: "high";
964
- xhigh: "xhigh";
965
- ultracode: "ultracode";
966
- }>>;
967
- fidelity: z.ZodEnum<{
968
- exact: "exact";
969
- unsupported: "unsupported";
970
- clamped: "clamped";
971
- }>;
972
- }, z.core.$strict>>;
973
- }, z.core.$strict>;
974
- workspace: z.ZodObject<{
975
- leaseId: z.ZodString;
976
- provider: z.ZodString;
977
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
978
- isolation: z.ZodEnum<{
979
- "per-run": "per-run";
980
- shared: "shared";
981
- }>;
982
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
983
- sourceSnapshotPolicy: z.ZodObject<{
984
- kind: z.ZodLiteral<"provider-declared">;
985
- name: z.ZodString;
986
- version: z.ZodNumber;
987
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
988
- }, z.core.$strict>;
989
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
990
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
991
- }, z.core.$strict>;
992
- axisResults: z.ZodArray<z.ZodObject<{
993
- axis: z.ZodEnum<{
994
- name: "name";
995
- systemPrompt: "systemPrompt";
996
- appendSystemPrompt: "appendSystemPrompt";
997
- instructions: "instructions";
998
- files: "files";
999
- tools: "tools";
1000
- skills: "skills";
1001
- commands: "commands";
1002
- description: "description";
1003
- version: "version";
1004
- tags: "tags";
1005
- harness: "harness";
1006
- permissions: "permissions";
1007
- mcp: "mcp";
1008
- connections: "connections";
1009
- subagents: "subagents";
1010
- hooks: "hooks";
1011
- modes: "modes";
1012
- confidential: "confidential";
1013
- metadata: "metadata";
1014
- extensions: "extensions";
1015
- modelDefault: "modelDefault";
1016
- modelSmall: "modelSmall";
1017
- modelProvider: "modelProvider";
1018
- modelReasoningEffort: "modelReasoningEffort";
1019
- modelMetadata: "modelMetadata";
1020
- resourceTools: "resourceTools";
1021
- resourceAgents: "resourceAgents";
1022
- resourceInstructions: "resourceInstructions";
1023
- resourceFailOnError: "resourceFailOnError";
1024
- }>;
1025
- disposition: z.ZodEnum<{
1026
- unsupported: "unsupported";
1027
- behavior: "behavior";
1028
- control: "control";
1029
- overridden: "overridden";
1030
- }>;
1031
- owner: z.ZodEnum<{
1032
- runtime: "runtime";
1033
- executor: "executor";
1034
- }>;
1035
- mechanism: z.ZodString;
1036
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1037
- path: z.ZodOptional<z.ZodString>;
1038
- reason: z.ZodOptional<z.ZodString>;
1039
- }, z.core.$strict>>;
1040
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1041
- materializer: z.ZodObject<{
1042
- name: z.ZodString;
1043
- version: z.ZodString;
1044
- }, z.core.$strict>;
1045
- expiresAtMs: z.ZodNumber;
1046
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1047
- }, z.core.$strict>;
1048
- incarnationId: z.ZodString;
1049
- startedAt: z.ZodISODateTime;
1050
- }, z.core.$strict>;
1051
- endedAt: z.ZodISODateTime;
1052
- reason: z.ZodEnum<{
1053
- stopped: "stopped";
1054
- exited: "exited";
1055
- lost: "lost";
1056
- }>;
1057
- exitCode: z.ZodOptional<z.ZodNumber>;
1058
- exitSignal: z.ZodOptional<z.ZodString>;
1059
- }, z.core.$strict>, z.ZodObject<{
1060
- state: z.ZodLiteral<"unknown">;
1061
- ref: z.ZodObject<{
1062
- run: z.ZodObject<{
1063
- runId: z.ZodString;
1064
- provider: z.ZodString;
1065
- environmentId: z.ZodString;
1066
- sessionId: z.ZodString;
1067
- executionId: z.ZodString;
1068
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1069
- }, z.core.$strict>;
1070
- preparationReceipt: z.ZodObject<{
1071
- kind: z.ZodLiteral<"agent-execution-preparation">;
1072
- schemaVersion: z.ZodLiteral<1>;
1073
- preparationId: z.ZodString;
1074
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1075
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1076
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1077
- backend: z.ZodString;
1078
- harness: z.ZodEnum<{
1079
- "claude-code": "claude-code";
1080
- nanoclaw: "nanoclaw";
1081
- codex: "codex";
1082
- opencode: "opencode";
1083
- "kimi-code": "kimi-code";
1084
- pi: "pi";
1085
- prime: "prime";
1086
- gemini: "gemini";
1087
- hermes: "hermes";
1088
- openclaw: "openclaw";
1089
- amp: "amp";
1090
- "factory-droids": "factory-droids";
1091
- forge: "forge";
1092
- cursor: "cursor";
1093
- acp: "acp";
1094
- "cli-base": "cli-base";
1095
- }>;
1096
- harnessVersion: z.ZodString;
1097
- resolvedModel: z.ZodObject<{
1098
- requested: z.ZodString;
1099
- resolved: z.ZodString;
1100
- provider: z.ZodOptional<z.ZodString>;
1101
- reasoningEffort: z.ZodOptional<z.ZodObject<{
1102
- requested: z.ZodEnum<{
1103
- none: "none";
1104
- minimal: "minimal";
1105
- low: "low";
1106
- medium: "medium";
1107
- high: "high";
1108
- xhigh: "xhigh";
1109
- ultracode: "ultracode";
1110
- }>;
1111
- resolved: z.ZodOptional<z.ZodEnum<{
1112
- none: "none";
1113
- minimal: "minimal";
1114
- low: "low";
1115
- medium: "medium";
1116
- high: "high";
1117
- xhigh: "xhigh";
1118
- ultracode: "ultracode";
1119
- }>>;
1120
- fidelity: z.ZodEnum<{
1121
- exact: "exact";
1122
- unsupported: "unsupported";
1123
- clamped: "clamped";
1124
- }>;
1125
- }, z.core.$strict>>;
1126
- }, z.core.$strict>;
1127
- workspace: z.ZodObject<{
1128
- leaseId: z.ZodString;
1129
- provider: z.ZodString;
1130
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1131
- isolation: z.ZodEnum<{
1132
- "per-run": "per-run";
1133
- shared: "shared";
1134
- }>;
1135
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1136
- sourceSnapshotPolicy: z.ZodObject<{
1137
- kind: z.ZodLiteral<"provider-declared">;
1138
- name: z.ZodString;
1139
- version: z.ZodNumber;
1140
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1141
- }, z.core.$strict>;
1142
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1143
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1144
- }, z.core.$strict>;
1145
- axisResults: z.ZodArray<z.ZodObject<{
1146
- axis: z.ZodEnum<{
1147
- name: "name";
1148
- systemPrompt: "systemPrompt";
1149
- appendSystemPrompt: "appendSystemPrompt";
1150
- instructions: "instructions";
1151
- files: "files";
1152
- tools: "tools";
1153
- skills: "skills";
1154
- commands: "commands";
1155
- description: "description";
1156
- version: "version";
1157
- tags: "tags";
1158
- harness: "harness";
1159
- permissions: "permissions";
1160
- mcp: "mcp";
1161
- connections: "connections";
1162
- subagents: "subagents";
1163
- hooks: "hooks";
1164
- modes: "modes";
1165
- confidential: "confidential";
1166
- metadata: "metadata";
1167
- extensions: "extensions";
1168
- modelDefault: "modelDefault";
1169
- modelSmall: "modelSmall";
1170
- modelProvider: "modelProvider";
1171
- modelReasoningEffort: "modelReasoningEffort";
1172
- modelMetadata: "modelMetadata";
1173
- resourceTools: "resourceTools";
1174
- resourceAgents: "resourceAgents";
1175
- resourceInstructions: "resourceInstructions";
1176
- resourceFailOnError: "resourceFailOnError";
1177
- }>;
1178
- disposition: z.ZodEnum<{
1179
- unsupported: "unsupported";
1180
- behavior: "behavior";
1181
- control: "control";
1182
- overridden: "overridden";
1183
- }>;
1184
- owner: z.ZodEnum<{
1185
- runtime: "runtime";
1186
- executor: "executor";
1187
- }>;
1188
- mechanism: z.ZodString;
1189
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1190
- path: z.ZodOptional<z.ZodString>;
1191
- reason: z.ZodOptional<z.ZodString>;
1192
- }, z.core.$strict>>;
1193
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1194
- materializer: z.ZodObject<{
1195
- name: z.ZodString;
1196
- version: z.ZodString;
1197
- }, z.core.$strict>;
1198
- expiresAtMs: z.ZodNumber;
1199
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1200
- }, z.core.$strict>;
1201
- incarnationId: z.ZodString;
1202
- startedAt: z.ZodISODateTime;
1203
- }, z.core.$strict>;
1204
- message: z.ZodString;
1205
- retryable: z.ZodBoolean;
1206
- }, z.core.$strict>], "state">;
1207
- export type AgentInteractiveSessionStatus = z.infer<typeof AgentInteractiveSessionStatusSchema>;
1208
- export interface AgentInteractiveSessionStopCommandMaterial {
1209
- operationId: string;
1210
- ref: AgentInteractiveSessionRef;
1211
- control: AgentInteractiveSessionControlClaim;
1212
- }
1213
- export interface AgentInteractiveSessionStopCommand extends AgentInteractiveSessionStopCommandMaterial {
1214
- requestDigest: `sha256:${string}`;
1215
- }
1216
- export declare function agentInteractiveSessionStopRequestDigest(value: AgentInteractiveSessionStopCommandMaterial): `sha256:${string}`;
1217
- export declare const AgentInteractiveSessionStopCommandSchema: z.ZodObject<{
1218
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1219
- operationId: z.ZodString;
1220
- ref: z.ZodObject<{
1221
- run: z.ZodObject<{
1222
- runId: z.ZodString;
1223
- provider: z.ZodString;
1224
- environmentId: z.ZodString;
1225
- sessionId: z.ZodString;
1226
- executionId: z.ZodString;
1227
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1228
- }, z.core.$strict>;
1229
- preparationReceipt: z.ZodObject<{
1230
- kind: z.ZodLiteral<"agent-execution-preparation">;
1231
- schemaVersion: z.ZodLiteral<1>;
1232
- preparationId: z.ZodString;
1233
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1234
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1235
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1236
- backend: z.ZodString;
1237
- harness: z.ZodEnum<{
1238
- "claude-code": "claude-code";
1239
- nanoclaw: "nanoclaw";
1240
- codex: "codex";
1241
- opencode: "opencode";
1242
- "kimi-code": "kimi-code";
1243
- pi: "pi";
1244
- prime: "prime";
1245
- gemini: "gemini";
1246
- hermes: "hermes";
1247
- openclaw: "openclaw";
1248
- amp: "amp";
1249
- "factory-droids": "factory-droids";
1250
- forge: "forge";
1251
- cursor: "cursor";
1252
- acp: "acp";
1253
- "cli-base": "cli-base";
1254
- }>;
1255
- harnessVersion: z.ZodString;
1256
- resolvedModel: z.ZodObject<{
1257
- requested: z.ZodString;
1258
- resolved: z.ZodString;
1259
- provider: z.ZodOptional<z.ZodString>;
1260
- reasoningEffort: z.ZodOptional<z.ZodObject<{
1261
- requested: z.ZodEnum<{
1262
- none: "none";
1263
- minimal: "minimal";
1264
- low: "low";
1265
- medium: "medium";
1266
- high: "high";
1267
- xhigh: "xhigh";
1268
- ultracode: "ultracode";
1269
- }>;
1270
- resolved: z.ZodOptional<z.ZodEnum<{
1271
- none: "none";
1272
- minimal: "minimal";
1273
- low: "low";
1274
- medium: "medium";
1275
- high: "high";
1276
- xhigh: "xhigh";
1277
- ultracode: "ultracode";
1278
- }>>;
1279
- fidelity: z.ZodEnum<{
1280
- exact: "exact";
1281
- unsupported: "unsupported";
1282
- clamped: "clamped";
1283
- }>;
1284
- }, z.core.$strict>>;
1285
- }, z.core.$strict>;
1286
- workspace: z.ZodObject<{
1287
- leaseId: z.ZodString;
1288
- provider: z.ZodString;
1289
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1290
- isolation: z.ZodEnum<{
1291
- "per-run": "per-run";
1292
- shared: "shared";
1293
- }>;
1294
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1295
- sourceSnapshotPolicy: z.ZodObject<{
1296
- kind: z.ZodLiteral<"provider-declared">;
1297
- name: z.ZodString;
1298
- version: z.ZodNumber;
1299
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1300
- }, z.core.$strict>;
1301
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1302
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1303
- }, z.core.$strict>;
1304
- axisResults: z.ZodArray<z.ZodObject<{
1305
- axis: z.ZodEnum<{
1306
- name: "name";
1307
- systemPrompt: "systemPrompt";
1308
- appendSystemPrompt: "appendSystemPrompt";
1309
- instructions: "instructions";
1310
- files: "files";
1311
- tools: "tools";
1312
- skills: "skills";
1313
- commands: "commands";
1314
- description: "description";
1315
- version: "version";
1316
- tags: "tags";
1317
- harness: "harness";
1318
- permissions: "permissions";
1319
- mcp: "mcp";
1320
- connections: "connections";
1321
- subagents: "subagents";
1322
- hooks: "hooks";
1323
- modes: "modes";
1324
- confidential: "confidential";
1325
- metadata: "metadata";
1326
- extensions: "extensions";
1327
- modelDefault: "modelDefault";
1328
- modelSmall: "modelSmall";
1329
- modelProvider: "modelProvider";
1330
- modelReasoningEffort: "modelReasoningEffort";
1331
- modelMetadata: "modelMetadata";
1332
- resourceTools: "resourceTools";
1333
- resourceAgents: "resourceAgents";
1334
- resourceInstructions: "resourceInstructions";
1335
- resourceFailOnError: "resourceFailOnError";
1336
- }>;
1337
- disposition: z.ZodEnum<{
1338
- unsupported: "unsupported";
1339
- behavior: "behavior";
1340
- control: "control";
1341
- overridden: "overridden";
1342
- }>;
1343
- owner: z.ZodEnum<{
1344
- runtime: "runtime";
1345
- executor: "executor";
1346
- }>;
1347
- mechanism: z.ZodString;
1348
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1349
- path: z.ZodOptional<z.ZodString>;
1350
- reason: z.ZodOptional<z.ZodString>;
1351
- }, z.core.$strict>>;
1352
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1353
- materializer: z.ZodObject<{
1354
- name: z.ZodString;
1355
- version: z.ZodString;
1356
- }, z.core.$strict>;
1357
- expiresAtMs: z.ZodNumber;
1358
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1359
- }, z.core.$strict>;
1360
- incarnationId: z.ZodString;
1361
- startedAt: z.ZodISODateTime;
1362
- }, z.core.$strict>;
1363
- control: z.ZodObject<{
1364
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1365
- generation: z.ZodNumber;
1366
- leaseId: z.ZodString;
1367
- holderId: z.ZodString;
1368
- expiresAt: z.ZodISODateTime;
1369
- }, z.core.$strict>;
1370
- }, z.core.$strict>;
1371
- export type AgentInteractiveSessionStopEffect = "stop_requested" | "stopped" | "not_live" | "unknown";
1372
- export interface AgentInteractiveSessionStopAcknowledgement {
1373
- operationId: string;
1374
- requestDigest: `sha256:${string}`;
1375
- ref: AgentInteractiveSessionRef;
1376
- control: AgentInteractiveSessionControlClaim;
1377
- status: "accepted" | "replayed" | "conflict" | "unknown";
1378
- effect: AgentInteractiveSessionStopEffect;
1379
- message?: string;
1380
- retryable?: boolean;
1381
- existingRequestDigest?: `sha256:${string}`;
1382
- }
1383
- export declare const AgentInteractiveSessionStopAcknowledgementSchema: z.ZodObject<{
1384
- operationId: z.ZodString;
1385
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1386
- ref: z.ZodObject<{
1387
- run: z.ZodObject<{
1388
- runId: z.ZodString;
1389
- provider: z.ZodString;
1390
- environmentId: z.ZodString;
1391
- sessionId: z.ZodString;
1392
- executionId: z.ZodString;
1393
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1394
- }, z.core.$strict>;
1395
- preparationReceipt: z.ZodObject<{
1396
- kind: z.ZodLiteral<"agent-execution-preparation">;
1397
- schemaVersion: z.ZodLiteral<1>;
1398
- preparationId: z.ZodString;
1399
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1400
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1401
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1402
- backend: z.ZodString;
1403
- harness: z.ZodEnum<{
1404
- "claude-code": "claude-code";
1405
- nanoclaw: "nanoclaw";
1406
- codex: "codex";
1407
- opencode: "opencode";
1408
- "kimi-code": "kimi-code";
1409
- pi: "pi";
1410
- prime: "prime";
1411
- gemini: "gemini";
1412
- hermes: "hermes";
1413
- openclaw: "openclaw";
1414
- amp: "amp";
1415
- "factory-droids": "factory-droids";
1416
- forge: "forge";
1417
- cursor: "cursor";
1418
- acp: "acp";
1419
- "cli-base": "cli-base";
1420
- }>;
1421
- harnessVersion: z.ZodString;
1422
- resolvedModel: z.ZodObject<{
1423
- requested: z.ZodString;
1424
- resolved: z.ZodString;
1425
- provider: z.ZodOptional<z.ZodString>;
1426
- reasoningEffort: z.ZodOptional<z.ZodObject<{
1427
- requested: z.ZodEnum<{
1428
- none: "none";
1429
- minimal: "minimal";
1430
- low: "low";
1431
- medium: "medium";
1432
- high: "high";
1433
- xhigh: "xhigh";
1434
- ultracode: "ultracode";
1435
- }>;
1436
- resolved: z.ZodOptional<z.ZodEnum<{
1437
- none: "none";
1438
- minimal: "minimal";
1439
- low: "low";
1440
- medium: "medium";
1441
- high: "high";
1442
- xhigh: "xhigh";
1443
- ultracode: "ultracode";
1444
- }>>;
1445
- fidelity: z.ZodEnum<{
1446
- exact: "exact";
1447
- unsupported: "unsupported";
1448
- clamped: "clamped";
1449
- }>;
1450
- }, z.core.$strict>>;
1451
- }, z.core.$strict>;
1452
- workspace: z.ZodObject<{
1453
- leaseId: z.ZodString;
1454
- provider: z.ZodString;
1455
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1456
- isolation: z.ZodEnum<{
1457
- "per-run": "per-run";
1458
- shared: "shared";
1459
- }>;
1460
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1461
- sourceSnapshotPolicy: z.ZodObject<{
1462
- kind: z.ZodLiteral<"provider-declared">;
1463
- name: z.ZodString;
1464
- version: z.ZodNumber;
1465
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1466
- }, z.core.$strict>;
1467
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1468
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1469
- }, z.core.$strict>;
1470
- axisResults: z.ZodArray<z.ZodObject<{
1471
- axis: z.ZodEnum<{
1472
- name: "name";
1473
- systemPrompt: "systemPrompt";
1474
- appendSystemPrompt: "appendSystemPrompt";
1475
- instructions: "instructions";
1476
- files: "files";
1477
- tools: "tools";
1478
- skills: "skills";
1479
- commands: "commands";
1480
- description: "description";
1481
- version: "version";
1482
- tags: "tags";
1483
- harness: "harness";
1484
- permissions: "permissions";
1485
- mcp: "mcp";
1486
- connections: "connections";
1487
- subagents: "subagents";
1488
- hooks: "hooks";
1489
- modes: "modes";
1490
- confidential: "confidential";
1491
- metadata: "metadata";
1492
- extensions: "extensions";
1493
- modelDefault: "modelDefault";
1494
- modelSmall: "modelSmall";
1495
- modelProvider: "modelProvider";
1496
- modelReasoningEffort: "modelReasoningEffort";
1497
- modelMetadata: "modelMetadata";
1498
- resourceTools: "resourceTools";
1499
- resourceAgents: "resourceAgents";
1500
- resourceInstructions: "resourceInstructions";
1501
- resourceFailOnError: "resourceFailOnError";
1502
- }>;
1503
- disposition: z.ZodEnum<{
1504
- unsupported: "unsupported";
1505
- behavior: "behavior";
1506
- control: "control";
1507
- overridden: "overridden";
1508
- }>;
1509
- owner: z.ZodEnum<{
1510
- runtime: "runtime";
1511
- executor: "executor";
1512
- }>;
1513
- mechanism: z.ZodString;
1514
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1515
- path: z.ZodOptional<z.ZodString>;
1516
- reason: z.ZodOptional<z.ZodString>;
1517
- }, z.core.$strict>>;
1518
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1519
- materializer: z.ZodObject<{
1520
- name: z.ZodString;
1521
- version: z.ZodString;
1522
- }, z.core.$strict>;
1523
- expiresAtMs: z.ZodNumber;
1524
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1525
- }, z.core.$strict>;
1526
- incarnationId: z.ZodString;
1527
- startedAt: z.ZodISODateTime;
1528
- }, z.core.$strict>;
1529
- control: z.ZodObject<{
1530
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1531
- generation: z.ZodNumber;
1532
- leaseId: z.ZodString;
1533
- holderId: z.ZodString;
1534
- expiresAt: z.ZodISODateTime;
1535
- }, z.core.$strict>;
1536
- status: z.ZodEnum<{
1537
- unknown: "unknown";
1538
- conflict: "conflict";
1539
- accepted: "accepted";
1540
- replayed: "replayed";
1541
- }>;
1542
- effect: z.ZodEnum<{
1543
- unknown: "unknown";
1544
- stopped: "stopped";
1545
- not_live: "not_live";
1546
- stop_requested: "stop_requested";
1547
- }>;
1548
- message: z.ZodOptional<z.ZodString>;
1549
- retryable: z.ZodOptional<z.ZodBoolean>;
1550
- existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1551
- }, z.core.$strict>;
1552
- export declare function agentInteractiveSessionStopAcknowledgementMatchesCommand(command: AgentInteractiveSessionStopCommand, acknowledgement: AgentInteractiveSessionStopAcknowledgement): boolean;
1553
- /** Terminal returned after attach; every write remains bound to this claim. */
1554
- export interface AgentInteractiveTerminalSession extends AgentTerminalSession {
1555
- readonly control: AgentInteractiveSessionControlClaim;
1556
- }
1557
- export interface AgentInteractiveSessionPromptCommandMaterial {
1558
- operationId: string;
1559
- ref: AgentInteractiveSessionRef;
1560
- control: AgentInteractiveSessionControlClaim;
1561
- prompt: string;
1562
- }
1563
- export interface AgentInteractiveSessionPromptCommand extends AgentInteractiveSessionPromptCommandMaterial {
1564
- requestDigest: `sha256:${string}`;
1565
- }
1566
- export declare function agentInteractiveSessionPromptRequestDigest(value: AgentInteractiveSessionPromptCommandMaterial): `sha256:${string}`;
1567
- export declare const AgentInteractiveSessionPromptCommandSchema: z.ZodObject<{
1568
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1569
- operationId: z.ZodString;
1570
- ref: z.ZodObject<{
1571
- run: z.ZodObject<{
1572
- runId: z.ZodString;
1573
- provider: z.ZodString;
1574
- environmentId: z.ZodString;
1575
- sessionId: z.ZodString;
1576
- executionId: z.ZodString;
1577
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1578
- }, z.core.$strict>;
1579
- preparationReceipt: z.ZodObject<{
1580
- kind: z.ZodLiteral<"agent-execution-preparation">;
1581
- schemaVersion: z.ZodLiteral<1>;
1582
- preparationId: z.ZodString;
1583
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1584
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1585
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1586
- backend: z.ZodString;
1587
- harness: z.ZodEnum<{
1588
- "claude-code": "claude-code";
1589
- nanoclaw: "nanoclaw";
1590
- codex: "codex";
1591
- opencode: "opencode";
1592
- "kimi-code": "kimi-code";
1593
- pi: "pi";
1594
- prime: "prime";
1595
- gemini: "gemini";
1596
- hermes: "hermes";
1597
- openclaw: "openclaw";
1598
- amp: "amp";
1599
- "factory-droids": "factory-droids";
1600
- forge: "forge";
1601
- cursor: "cursor";
1602
- acp: "acp";
1603
- "cli-base": "cli-base";
1604
- }>;
1605
- harnessVersion: z.ZodString;
1606
- resolvedModel: z.ZodObject<{
1607
- requested: z.ZodString;
1608
- resolved: z.ZodString;
1609
- provider: z.ZodOptional<z.ZodString>;
1610
- reasoningEffort: z.ZodOptional<z.ZodObject<{
1611
- requested: z.ZodEnum<{
1612
- none: "none";
1613
- minimal: "minimal";
1614
- low: "low";
1615
- medium: "medium";
1616
- high: "high";
1617
- xhigh: "xhigh";
1618
- ultracode: "ultracode";
1619
- }>;
1620
- resolved: z.ZodOptional<z.ZodEnum<{
1621
- none: "none";
1622
- minimal: "minimal";
1623
- low: "low";
1624
- medium: "medium";
1625
- high: "high";
1626
- xhigh: "xhigh";
1627
- ultracode: "ultracode";
1628
- }>>;
1629
- fidelity: z.ZodEnum<{
1630
- exact: "exact";
1631
- unsupported: "unsupported";
1632
- clamped: "clamped";
1633
- }>;
1634
- }, z.core.$strict>>;
1635
- }, z.core.$strict>;
1636
- workspace: z.ZodObject<{
1637
- leaseId: z.ZodString;
1638
- provider: z.ZodString;
1639
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1640
- isolation: z.ZodEnum<{
1641
- "per-run": "per-run";
1642
- shared: "shared";
1643
- }>;
1644
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1645
- sourceSnapshotPolicy: z.ZodObject<{
1646
- kind: z.ZodLiteral<"provider-declared">;
1647
- name: z.ZodString;
1648
- version: z.ZodNumber;
1649
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1650
- }, z.core.$strict>;
1651
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1652
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1653
- }, z.core.$strict>;
1654
- axisResults: z.ZodArray<z.ZodObject<{
1655
- axis: z.ZodEnum<{
1656
- name: "name";
1657
- systemPrompt: "systemPrompt";
1658
- appendSystemPrompt: "appendSystemPrompt";
1659
- instructions: "instructions";
1660
- files: "files";
1661
- tools: "tools";
1662
- skills: "skills";
1663
- commands: "commands";
1664
- description: "description";
1665
- version: "version";
1666
- tags: "tags";
1667
- harness: "harness";
1668
- permissions: "permissions";
1669
- mcp: "mcp";
1670
- connections: "connections";
1671
- subagents: "subagents";
1672
- hooks: "hooks";
1673
- modes: "modes";
1674
- confidential: "confidential";
1675
- metadata: "metadata";
1676
- extensions: "extensions";
1677
- modelDefault: "modelDefault";
1678
- modelSmall: "modelSmall";
1679
- modelProvider: "modelProvider";
1680
- modelReasoningEffort: "modelReasoningEffort";
1681
- modelMetadata: "modelMetadata";
1682
- resourceTools: "resourceTools";
1683
- resourceAgents: "resourceAgents";
1684
- resourceInstructions: "resourceInstructions";
1685
- resourceFailOnError: "resourceFailOnError";
1686
- }>;
1687
- disposition: z.ZodEnum<{
1688
- unsupported: "unsupported";
1689
- behavior: "behavior";
1690
- control: "control";
1691
- overridden: "overridden";
1692
- }>;
1693
- owner: z.ZodEnum<{
1694
- runtime: "runtime";
1695
- executor: "executor";
1696
- }>;
1697
- mechanism: z.ZodString;
1698
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1699
- path: z.ZodOptional<z.ZodString>;
1700
- reason: z.ZodOptional<z.ZodString>;
1701
- }, z.core.$strict>>;
1702
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1703
- materializer: z.ZodObject<{
1704
- name: z.ZodString;
1705
- version: z.ZodString;
1706
- }, z.core.$strict>;
1707
- expiresAtMs: z.ZodNumber;
1708
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1709
- }, z.core.$strict>;
1710
- incarnationId: z.ZodString;
1711
- startedAt: z.ZodISODateTime;
1712
- }, z.core.$strict>;
1713
- control: z.ZodObject<{
1714
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1715
- generation: z.ZodNumber;
1716
- leaseId: z.ZodString;
1717
- holderId: z.ZodString;
1718
- expiresAt: z.ZodISODateTime;
1719
- }, z.core.$strict>;
1720
- prompt: z.ZodString;
1721
- }, z.core.$strict>;
1722
- export interface AgentInteractiveSessionPromptAcknowledgement {
1723
- operationId: string;
1724
- requestDigest: `sha256:${string}`;
1725
- ref: AgentInteractiveSessionRef;
1726
- control: AgentInteractiveSessionControlClaim;
1727
- status: "accepted" | "replayed" | "conflict" | "unknown";
1728
- message?: string;
1729
- retryable?: boolean;
1730
- existingRequestDigest?: `sha256:${string}`;
1731
- }
1732
- export declare const AgentInteractiveSessionPromptAcknowledgementSchema: z.ZodObject<{
1733
- operationId: z.ZodString;
1734
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1735
- ref: z.ZodObject<{
1736
- run: z.ZodObject<{
1737
- runId: z.ZodString;
1738
- provider: z.ZodString;
1739
- environmentId: z.ZodString;
1740
- sessionId: z.ZodString;
1741
- executionId: z.ZodString;
1742
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1743
- }, z.core.$strict>;
1744
- preparationReceipt: z.ZodObject<{
1745
- kind: z.ZodLiteral<"agent-execution-preparation">;
1746
- schemaVersion: z.ZodLiteral<1>;
1747
- preparationId: z.ZodString;
1748
- requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1749
- authoredProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1750
- effectiveProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1751
- backend: z.ZodString;
1752
- harness: z.ZodEnum<{
1753
- "claude-code": "claude-code";
1754
- nanoclaw: "nanoclaw";
1755
- codex: "codex";
1756
- opencode: "opencode";
1757
- "kimi-code": "kimi-code";
1758
- pi: "pi";
1759
- prime: "prime";
1760
- gemini: "gemini";
1761
- hermes: "hermes";
1762
- openclaw: "openclaw";
1763
- amp: "amp";
1764
- "factory-droids": "factory-droids";
1765
- forge: "forge";
1766
- cursor: "cursor";
1767
- acp: "acp";
1768
- "cli-base": "cli-base";
1769
- }>;
1770
- harnessVersion: z.ZodString;
1771
- resolvedModel: z.ZodObject<{
1772
- requested: z.ZodString;
1773
- resolved: z.ZodString;
1774
- provider: z.ZodOptional<z.ZodString>;
1775
- reasoningEffort: z.ZodOptional<z.ZodObject<{
1776
- requested: z.ZodEnum<{
1777
- none: "none";
1778
- minimal: "minimal";
1779
- low: "low";
1780
- medium: "medium";
1781
- high: "high";
1782
- xhigh: "xhigh";
1783
- ultracode: "ultracode";
1784
- }>;
1785
- resolved: z.ZodOptional<z.ZodEnum<{
1786
- none: "none";
1787
- minimal: "minimal";
1788
- low: "low";
1789
- medium: "medium";
1790
- high: "high";
1791
- xhigh: "xhigh";
1792
- ultracode: "ultracode";
1793
- }>>;
1794
- fidelity: z.ZodEnum<{
1795
- exact: "exact";
1796
- unsupported: "unsupported";
1797
- clamped: "clamped";
1798
- }>;
1799
- }, z.core.$strict>>;
1800
- }, z.core.$strict>;
1801
- workspace: z.ZodObject<{
1802
- leaseId: z.ZodString;
1803
- provider: z.ZodString;
1804
- identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1805
- isolation: z.ZodEnum<{
1806
- "per-run": "per-run";
1807
- shared: "shared";
1808
- }>;
1809
- sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1810
- sourceSnapshotPolicy: z.ZodObject<{
1811
- kind: z.ZodLiteral<"provider-declared">;
1812
- name: z.ZodString;
1813
- version: z.ZodNumber;
1814
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1815
- }, z.core.$strict>;
1816
- preparedWorkspaceDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1817
- profileActivationDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1818
- }, z.core.$strict>;
1819
- axisResults: z.ZodArray<z.ZodObject<{
1820
- axis: z.ZodEnum<{
1821
- name: "name";
1822
- systemPrompt: "systemPrompt";
1823
- appendSystemPrompt: "appendSystemPrompt";
1824
- instructions: "instructions";
1825
- files: "files";
1826
- tools: "tools";
1827
- skills: "skills";
1828
- commands: "commands";
1829
- description: "description";
1830
- version: "version";
1831
- tags: "tags";
1832
- harness: "harness";
1833
- permissions: "permissions";
1834
- mcp: "mcp";
1835
- connections: "connections";
1836
- subagents: "subagents";
1837
- hooks: "hooks";
1838
- modes: "modes";
1839
- confidential: "confidential";
1840
- metadata: "metadata";
1841
- extensions: "extensions";
1842
- modelDefault: "modelDefault";
1843
- modelSmall: "modelSmall";
1844
- modelProvider: "modelProvider";
1845
- modelReasoningEffort: "modelReasoningEffort";
1846
- modelMetadata: "modelMetadata";
1847
- resourceTools: "resourceTools";
1848
- resourceAgents: "resourceAgents";
1849
- resourceInstructions: "resourceInstructions";
1850
- resourceFailOnError: "resourceFailOnError";
1851
- }>;
1852
- disposition: z.ZodEnum<{
1853
- unsupported: "unsupported";
1854
- behavior: "behavior";
1855
- control: "control";
1856
- overridden: "overridden";
1857
- }>;
1858
- owner: z.ZodEnum<{
1859
- runtime: "runtime";
1860
- executor: "executor";
1861
- }>;
1862
- mechanism: z.ZodString;
1863
- evidenceDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1864
- path: z.ZodOptional<z.ZodString>;
1865
- reason: z.ZodOptional<z.ZodString>;
1866
- }, z.core.$strict>>;
1867
- executionPlanDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1868
- materializer: z.ZodObject<{
1869
- name: z.ZodString;
1870
- version: z.ZodString;
1871
- }, z.core.$strict>;
1872
- expiresAtMs: z.ZodNumber;
1873
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1874
- }, z.core.$strict>;
1875
- incarnationId: z.ZodString;
1876
- startedAt: z.ZodISODateTime;
1877
- }, z.core.$strict>;
1878
- control: z.ZodObject<{
1879
- refDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1880
- generation: z.ZodNumber;
1881
- leaseId: z.ZodString;
1882
- holderId: z.ZodString;
1883
- expiresAt: z.ZodISODateTime;
1884
- }, z.core.$strict>;
1885
- status: z.ZodEnum<{
1886
- unknown: "unknown";
1887
- conflict: "conflict";
1888
- accepted: "accepted";
1889
- replayed: "replayed";
1890
- }>;
1891
- message: z.ZodOptional<z.ZodString>;
1892
- retryable: z.ZodOptional<z.ZodBoolean>;
1893
- existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1894
- }, z.core.$strict>;
1895
- export declare function agentInteractiveSessionPromptAcknowledgementMatchesCommand(command: AgentInteractiveSessionPromptCommand, acknowledgement: AgentInteractiveSessionPromptAcknowledgement): boolean;
1896
- /**
1897
- * Exact native TUI selected for one run.
1898
- *
1899
- * `attach` reaches the existing process. It never creates a shell or starts a
1900
- * second coding-agent process. Detach and terminal close affect only the live
1901
- * socket; `stop` terminates the provider-owned coding-agent process.
1902
- */
1903
- export interface AgentInteractiveSession {
1904
- readonly ref: AgentInteractiveSessionRef;
1905
- /** Claim a newer provider generation after coordinator recovery. */
1906
- claimControl(request: AgentInteractiveSessionControlClaimRequest, options?: {
1907
- signal?: AbortSignal;
1908
- }): Promise<AgentInteractiveSessionControlClaimAcknowledgement>;
1909
- status(options?: {
1910
- signal?: AbortSignal;
1911
- }): Promise<AgentInteractiveSessionStatus>;
1912
- attach(request: AgentInteractiveSessionAttach, options?: {
1913
- signal?: AbortSignal;
1914
- }): Promise<AgentInteractiveTerminalSession>;
1915
- sendPrompt?(
1916
- /** The provider persists this operation before delivering the prompt. */
1917
- command: AgentInteractiveSessionPromptCommand, options?: {
1918
- signal?: AbortSignal;
1919
- }): Promise<AgentInteractiveSessionPromptAcknowledgement>;
1920
- stop(command: AgentInteractiveSessionStopCommand, options?: {
1921
- signal?: AbortSignal;
1922
- }): Promise<AgentInteractiveSessionStopAcknowledgement>;
1923
- }
1924
- /** Parse a start request and prove its profile identity before provider work. */
1925
- export declare function exactAgentInteractiveSessionStart(value: AgentInteractiveSessionStart): AgentInteractiveSessionStart;
1926
- /** Prove that a provider returned the exact run and preparation receipt requested. */
1927
- export declare function agentInteractiveSessionRefMatchesStart(request: AgentInteractiveSessionStart, ref: AgentInteractiveSessionRef): boolean;
1928
- /** Prove that a status belongs to the handle that requested it. */
1929
- export declare function agentInteractiveSessionStatusMatchesRef(ref: AgentInteractiveSessionRef, status: AgentInteractiveSessionStatus): boolean;
1930
- export {};
1
+ export * from "./environment-interactive-control.js";
2
+ export * from "./environment-interactive-start.js";