@tangle-network/agent-interface 0.55.0 → 0.56.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.
@@ -11,7 +11,7 @@ export type AgentInteractiveSessionRunCoordinates = z.infer<typeof AgentInteract
11
11
  /**
12
12
  * Durable identity of one coding-agent TUI.
13
13
  *
14
- * This reference identifies the exact admitted run and effective profile.
14
+ * This reference identifies the exact admitted run and preparation receipt.
15
15
  * It is not a generic shell id and cannot be used to create another process.
16
16
  */
17
17
  export declare const AgentInteractiveSessionRefSchema: z.ZodObject<{
@@ -23,31 +23,511 @@ export declare const AgentInteractiveSessionRefSchema: z.ZodObject<{
23
23
  executionId: z.ZodString;
24
24
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
25
25
  }, z.core.$strict>;
26
- requestedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
27
- admittedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
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>;
28
157
  incarnationId: z.ZodString;
29
- harness: z.ZodEnum<{
30
- "claude-code": "claude-code";
31
- nanoclaw: "nanoclaw";
32
- codex: "codex";
33
- opencode: "opencode";
34
- "kimi-code": "kimi-code";
35
- pi: "pi";
36
- prime: "prime";
37
- gemini: "gemini";
38
- hermes: "hermes";
39
- openclaw: "openclaw";
40
- amp: "amp";
41
- "factory-droids": "factory-droids";
42
- forge: "forge";
43
- cursor: "cursor";
44
- acp: "acp";
45
- "cli-base": "cli-base";
46
- }>;
47
158
  startedAt: z.ZodISODateTime;
48
159
  }, z.core.$strict>;
49
160
  export type AgentInteractiveSessionRef = z.infer<typeof AgentInteractiveSessionRefSchema>;
50
- /** Start one native coding-agent TUI for an already admitted run. */
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
+ */
51
531
  export declare const AgentInteractiveSessionStartSchema: z.ZodObject<{
52
532
  run: z.ZodObject<{
53
533
  runId: z.ZodString;
@@ -266,6 +746,13 @@ export declare function agentInteractiveSessionRequestDigest(coordinates: AgentI
266
746
  export declare function agentInteractiveSessionRunRef(coordinates: AgentInteractiveSessionRunCoordinates, input: AgentInteractiveSessionStartInput): AgentExactRunControlRef;
267
747
  /** Geometry for one attachment to the existing coding-agent TUI. */
268
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>;
269
756
  cols: z.ZodOptional<z.ZodNumber>;
270
757
  rows: z.ZodOptional<z.ZodNumber>;
271
758
  }, z.core.$strict>;
@@ -282,27 +769,138 @@ export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnio
282
769
  executionId: z.ZodString;
283
770
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
284
771
  }, z.core.$strict>;
285
- requestedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
286
- admittedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
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>;
287
903
  incarnationId: z.ZodString;
288
- harness: z.ZodEnum<{
289
- "claude-code": "claude-code";
290
- nanoclaw: "nanoclaw";
291
- codex: "codex";
292
- opencode: "opencode";
293
- "kimi-code": "kimi-code";
294
- pi: "pi";
295
- prime: "prime";
296
- gemini: "gemini";
297
- hermes: "hermes";
298
- openclaw: "openclaw";
299
- amp: "amp";
300
- "factory-droids": "factory-droids";
301
- forge: "forge";
302
- cursor: "cursor";
303
- acp: "acp";
304
- "cli-base": "cli-base";
305
- }>;
306
904
  startedAt: z.ZodISODateTime;
307
905
  }, z.core.$strict>;
308
906
  }, z.core.$strict>, z.ZodObject<{
@@ -316,27 +914,138 @@ export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnio
316
914
  executionId: z.ZodString;
317
915
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
318
916
  }, z.core.$strict>;
319
- requestedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
320
- admittedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
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>;
321
1048
  incarnationId: z.ZodString;
322
- harness: z.ZodEnum<{
323
- "claude-code": "claude-code";
324
- nanoclaw: "nanoclaw";
325
- codex: "codex";
326
- opencode: "opencode";
327
- "kimi-code": "kimi-code";
328
- pi: "pi";
329
- prime: "prime";
330
- gemini: "gemini";
331
- hermes: "hermes";
332
- openclaw: "openclaw";
333
- amp: "amp";
334
- "factory-droids": "factory-droids";
335
- forge: "forge";
336
- cursor: "cursor";
337
- acp: "acp";
338
- "cli-base": "cli-base";
339
- }>;
340
1049
  startedAt: z.ZodISODateTime;
341
1050
  }, z.core.$strict>;
342
1051
  endedAt: z.ZodISODateTime;
@@ -358,33 +1067,832 @@ export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnio
358
1067
  executionId: z.ZodString;
359
1068
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
360
1069
  }, z.core.$strict>;
361
- requestedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
362
- admittedProfileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
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>;
363
1201
  incarnationId: z.ZodString;
364
- harness: z.ZodEnum<{
365
- "claude-code": "claude-code";
366
- nanoclaw: "nanoclaw";
367
- codex: "codex";
368
- opencode: "opencode";
369
- "kimi-code": "kimi-code";
370
- pi: "pi";
371
- prime: "prime";
372
- gemini: "gemini";
373
- hermes: "hermes";
374
- openclaw: "openclaw";
375
- amp: "amp";
376
- "factory-droids": "factory-droids";
377
- forge: "forge";
378
- cursor: "cursor";
379
- acp: "acp";
380
- "cli-base": "cli-base";
381
- }>;
382
1202
  startedAt: z.ZodISODateTime;
383
1203
  }, z.core.$strict>;
384
1204
  message: z.ZodString;
385
1205
  retryable: z.ZodBoolean;
386
1206
  }, z.core.$strict>], "state">;
387
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
+ not_live: "not_live";
1545
+ stopped: "stopped";
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;
388
1896
  /**
389
1897
  * Exact native TUI selected for one run.
390
1898
  *
@@ -394,22 +1902,28 @@ export type AgentInteractiveSessionStatus = z.infer<typeof AgentInteractiveSessi
394
1902
  */
395
1903
  export interface AgentInteractiveSession {
396
1904
  readonly ref: AgentInteractiveSessionRef;
1905
+ /** Claim a newer provider generation after coordinator recovery. */
1906
+ claimControl(request: AgentInteractiveSessionControlClaimRequest, options?: {
1907
+ signal?: AbortSignal;
1908
+ }): Promise<AgentInteractiveSessionControlClaimAcknowledgement>;
397
1909
  status(options?: {
398
1910
  signal?: AbortSignal;
399
1911
  }): Promise<AgentInteractiveSessionStatus>;
400
- attach(request?: AgentInteractiveSessionAttach, options?: {
1912
+ attach(request: AgentInteractiveSessionAttach, options?: {
401
1913
  signal?: AbortSignal;
402
- }): Promise<AgentTerminalSession>;
403
- sendPrompt?(prompt: string, options?: {
1914
+ }): Promise<AgentInteractiveTerminalSession>;
1915
+ sendPrompt?(
1916
+ /** The provider persists this operation before delivering the prompt. */
1917
+ command: AgentInteractiveSessionPromptCommand, options?: {
404
1918
  signal?: AbortSignal;
405
- }): Promise<void>;
406
- stop(options?: {
1919
+ }): Promise<AgentInteractiveSessionPromptAcknowledgement>;
1920
+ stop(command: AgentInteractiveSessionStopCommand, options?: {
407
1921
  signal?: AbortSignal;
408
- }): Promise<AgentInteractiveSessionStatus>;
1922
+ }): Promise<AgentInteractiveSessionStopAcknowledgement>;
409
1923
  }
410
1924
  /** Parse a start request and prove its profile identity before provider work. */
411
1925
  export declare function exactAgentInteractiveSessionStart(value: AgentInteractiveSessionStart): AgentInteractiveSessionStart;
412
- /** Prove that a provider returned the exact run, profile, and runner requested. */
1926
+ /** Prove that a provider returned the exact run and preparation receipt requested. */
413
1927
  export declare function agentInteractiveSessionRefMatchesStart(request: AgentInteractiveSessionStart, ref: AgentInteractiveSessionRef): boolean;
414
1928
  /** Prove that a status belongs to the handle that requested it. */
415
1929
  export declare function agentInteractiveSessionStatusMatchesRef(ref: AgentInteractiveSessionRef, status: AgentInteractiveSessionStatus): boolean;