@tangle-network/agent-interface 1.1.0 → 1.3.0

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