@tangle-network/agent-interface 0.40.0 → 0.41.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,716 @@
1
+ import { z } from "zod";
2
+ import type { Sha256Digest } from "./agent-candidate.js";
3
+ import type { BackendMessage, InputPart } from "./index.js";
4
+ import { type AgentRunControlRef } from "./runtime-control.js";
5
+ export interface PortableContextSourceBoundary {
6
+ runId: string;
7
+ messageId?: string;
8
+ provider?: string;
9
+ environmentId?: string;
10
+ sessionId?: string;
11
+ }
12
+ export declare const PortableContextSourceBoundarySchema: z.ZodObject<{
13
+ runId: z.ZodString;
14
+ messageId: z.ZodOptional<z.ZodString>;
15
+ provider: z.ZodOptional<z.ZodString>;
16
+ environmentId: z.ZodOptional<z.ZodString>;
17
+ sessionId: z.ZodOptional<z.ZodString>;
18
+ }, z.core.$strict>;
19
+ export interface PortableContextAttachmentRef {
20
+ messageId: string;
21
+ partIndex: number;
22
+ digest: Sha256Digest;
23
+ name?: string;
24
+ mediaType?: string;
25
+ }
26
+ export declare const PortableContextAttachmentRefSchema: z.ZodObject<{
27
+ messageId: z.ZodString;
28
+ partIndex: z.ZodNumber;
29
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
30
+ name: z.ZodOptional<z.ZodString>;
31
+ mediaType: z.ZodOptional<z.ZodString>;
32
+ }, z.core.$strict>;
33
+ export interface PortableConversationContext {
34
+ source: PortableContextSourceBoundary;
35
+ completeness: "complete" | "partial";
36
+ messages: BackendMessage[];
37
+ attachments: PortableContextAttachmentRef[];
38
+ digest: Sha256Digest;
39
+ }
40
+ type PortableConversationContextMaterial = Omit<PortableConversationContext, "digest">;
41
+ export declare function portableConversationContextDigest(context: PortableConversationContextMaterial): Sha256Digest;
42
+ export declare const PortableConversationContextSchema: z.ZodObject<{
43
+ source: z.ZodObject<{
44
+ runId: z.ZodString;
45
+ messageId: z.ZodOptional<z.ZodString>;
46
+ provider: z.ZodOptional<z.ZodString>;
47
+ environmentId: z.ZodOptional<z.ZodString>;
48
+ sessionId: z.ZodOptional<z.ZodString>;
49
+ }, z.core.$strict>;
50
+ completeness: z.ZodEnum<{
51
+ complete: "complete";
52
+ partial: "partial";
53
+ }>;
54
+ messages: z.ZodArray<z.ZodObject<{
55
+ id: z.ZodString;
56
+ role: z.ZodEnum<{
57
+ user: "user";
58
+ assistant: "assistant";
59
+ system: "system";
60
+ }>;
61
+ parts: z.ZodArray<z.ZodJSONSchema>;
62
+ timestamp: z.ZodISODateTime;
63
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
64
+ }, z.core.$strict>>;
65
+ attachments: z.ZodArray<z.ZodObject<{
66
+ messageId: z.ZodString;
67
+ partIndex: z.ZodNumber;
68
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
69
+ name: z.ZodOptional<z.ZodString>;
70
+ mediaType: z.ZodOptional<z.ZodString>;
71
+ }, z.core.$strict>>;
72
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
73
+ }, z.core.$strict>;
74
+ export interface PortableContextDestination {
75
+ runner: string;
76
+ provider?: string;
77
+ model?: string;
78
+ profileDigest?: Sha256Digest;
79
+ }
80
+ export declare const PortableContextDestinationSchema: z.ZodObject<{
81
+ runner: z.ZodString;
82
+ provider: z.ZodOptional<z.ZodString>;
83
+ model: z.ZodOptional<z.ZodString>;
84
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
85
+ }, z.core.$strict>;
86
+ export interface PortableContextPartPlan {
87
+ partIndex: number;
88
+ action: "include" | "transform" | "omit";
89
+ output?: InputPart;
90
+ reason?: string;
91
+ }
92
+ export declare const PortableContextPartPlanSchema: z.ZodObject<{
93
+ partIndex: z.ZodNumber;
94
+ action: z.ZodEnum<{
95
+ transform: "transform";
96
+ include: "include";
97
+ omit: "omit";
98
+ }>;
99
+ output: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
100
+ type: z.ZodLiteral<"text">;
101
+ text: z.ZodString;
102
+ }, z.core.$strict>, z.ZodObject<{
103
+ type: z.ZodLiteral<"file">;
104
+ filename: z.ZodOptional<z.ZodString>;
105
+ mediaType: z.ZodOptional<z.ZodString>;
106
+ url: z.ZodOptional<z.ZodString>;
107
+ path: z.ZodOptional<z.ZodString>;
108
+ content: z.ZodOptional<z.ZodString>;
109
+ }, z.core.$strict>, z.ZodObject<{
110
+ type: z.ZodLiteral<"image">;
111
+ filename: z.ZodOptional<z.ZodString>;
112
+ mediaType: z.ZodOptional<z.ZodString>;
113
+ url: z.ZodOptional<z.ZodString>;
114
+ path: z.ZodOptional<z.ZodString>;
115
+ }, z.core.$strict>], "type">>;
116
+ reason: z.ZodOptional<z.ZodString>;
117
+ }, z.core.$strict>;
118
+ export interface PortableContextMessagePlan {
119
+ messageId: string;
120
+ action: "include" | "omit";
121
+ parts: PortableContextPartPlan[];
122
+ reason?: string;
123
+ }
124
+ export declare const PortableContextMessagePlanSchema: z.ZodObject<{
125
+ messageId: z.ZodString;
126
+ action: z.ZodEnum<{
127
+ include: "include";
128
+ omit: "omit";
129
+ }>;
130
+ parts: z.ZodArray<z.ZodObject<{
131
+ partIndex: z.ZodNumber;
132
+ action: z.ZodEnum<{
133
+ transform: "transform";
134
+ include: "include";
135
+ omit: "omit";
136
+ }>;
137
+ output: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
138
+ type: z.ZodLiteral<"text">;
139
+ text: z.ZodString;
140
+ }, z.core.$strict>, z.ZodObject<{
141
+ type: z.ZodLiteral<"file">;
142
+ filename: z.ZodOptional<z.ZodString>;
143
+ mediaType: z.ZodOptional<z.ZodString>;
144
+ url: z.ZodOptional<z.ZodString>;
145
+ path: z.ZodOptional<z.ZodString>;
146
+ content: z.ZodOptional<z.ZodString>;
147
+ }, z.core.$strict>, z.ZodObject<{
148
+ type: z.ZodLiteral<"image">;
149
+ filename: z.ZodOptional<z.ZodString>;
150
+ mediaType: z.ZodOptional<z.ZodString>;
151
+ url: z.ZodOptional<z.ZodString>;
152
+ path: z.ZodOptional<z.ZodString>;
153
+ }, z.core.$strict>], "type">>;
154
+ reason: z.ZodOptional<z.ZodString>;
155
+ }, z.core.$strict>>;
156
+ reason: z.ZodOptional<z.ZodString>;
157
+ }, z.core.$strict>;
158
+ export interface PortableContextPlan {
159
+ planId: string;
160
+ /** Full immutable source so an executor can verify every decision itself. */
161
+ source: PortableConversationContext;
162
+ destination: PortableContextDestination;
163
+ messages: PortableContextMessagePlan[];
164
+ context: PortableConversationContext;
165
+ estimatedTokens?: number;
166
+ requiresAcceptance: boolean;
167
+ digest: Sha256Digest;
168
+ }
169
+ export type PortableContextPlanMaterial = Omit<PortableContextPlan, "digest">;
170
+ export declare function portableContextPlanDigest(plan: PortableContextPlanMaterial): Sha256Digest;
171
+ export declare const PortableContextPlanSchema: z.ZodObject<{
172
+ planId: z.ZodString;
173
+ source: z.ZodObject<{
174
+ source: z.ZodObject<{
175
+ runId: z.ZodString;
176
+ messageId: z.ZodOptional<z.ZodString>;
177
+ provider: z.ZodOptional<z.ZodString>;
178
+ environmentId: z.ZodOptional<z.ZodString>;
179
+ sessionId: z.ZodOptional<z.ZodString>;
180
+ }, z.core.$strict>;
181
+ completeness: z.ZodEnum<{
182
+ complete: "complete";
183
+ partial: "partial";
184
+ }>;
185
+ messages: z.ZodArray<z.ZodObject<{
186
+ id: z.ZodString;
187
+ role: z.ZodEnum<{
188
+ user: "user";
189
+ assistant: "assistant";
190
+ system: "system";
191
+ }>;
192
+ parts: z.ZodArray<z.ZodJSONSchema>;
193
+ timestamp: z.ZodISODateTime;
194
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
195
+ }, z.core.$strict>>;
196
+ attachments: z.ZodArray<z.ZodObject<{
197
+ messageId: z.ZodString;
198
+ partIndex: z.ZodNumber;
199
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
200
+ name: z.ZodOptional<z.ZodString>;
201
+ mediaType: z.ZodOptional<z.ZodString>;
202
+ }, z.core.$strict>>;
203
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
204
+ }, z.core.$strict>;
205
+ destination: z.ZodObject<{
206
+ runner: z.ZodString;
207
+ provider: z.ZodOptional<z.ZodString>;
208
+ model: z.ZodOptional<z.ZodString>;
209
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
210
+ }, z.core.$strict>;
211
+ messages: z.ZodArray<z.ZodObject<{
212
+ messageId: z.ZodString;
213
+ action: z.ZodEnum<{
214
+ include: "include";
215
+ omit: "omit";
216
+ }>;
217
+ parts: z.ZodArray<z.ZodObject<{
218
+ partIndex: z.ZodNumber;
219
+ action: z.ZodEnum<{
220
+ transform: "transform";
221
+ include: "include";
222
+ omit: "omit";
223
+ }>;
224
+ output: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
225
+ type: z.ZodLiteral<"text">;
226
+ text: z.ZodString;
227
+ }, z.core.$strict>, z.ZodObject<{
228
+ type: z.ZodLiteral<"file">;
229
+ filename: z.ZodOptional<z.ZodString>;
230
+ mediaType: z.ZodOptional<z.ZodString>;
231
+ url: z.ZodOptional<z.ZodString>;
232
+ path: z.ZodOptional<z.ZodString>;
233
+ content: z.ZodOptional<z.ZodString>;
234
+ }, z.core.$strict>, z.ZodObject<{
235
+ type: z.ZodLiteral<"image">;
236
+ filename: z.ZodOptional<z.ZodString>;
237
+ mediaType: z.ZodOptional<z.ZodString>;
238
+ url: z.ZodOptional<z.ZodString>;
239
+ path: z.ZodOptional<z.ZodString>;
240
+ }, z.core.$strict>], "type">>;
241
+ reason: z.ZodOptional<z.ZodString>;
242
+ }, z.core.$strict>>;
243
+ reason: z.ZodOptional<z.ZodString>;
244
+ }, z.core.$strict>>;
245
+ context: z.ZodObject<{
246
+ source: z.ZodObject<{
247
+ runId: z.ZodString;
248
+ messageId: z.ZodOptional<z.ZodString>;
249
+ provider: z.ZodOptional<z.ZodString>;
250
+ environmentId: z.ZodOptional<z.ZodString>;
251
+ sessionId: z.ZodOptional<z.ZodString>;
252
+ }, z.core.$strict>;
253
+ completeness: z.ZodEnum<{
254
+ complete: "complete";
255
+ partial: "partial";
256
+ }>;
257
+ messages: z.ZodArray<z.ZodObject<{
258
+ id: z.ZodString;
259
+ role: z.ZodEnum<{
260
+ user: "user";
261
+ assistant: "assistant";
262
+ system: "system";
263
+ }>;
264
+ parts: z.ZodArray<z.ZodJSONSchema>;
265
+ timestamp: z.ZodISODateTime;
266
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
267
+ }, z.core.$strict>>;
268
+ attachments: z.ZodArray<z.ZodObject<{
269
+ messageId: z.ZodString;
270
+ partIndex: z.ZodNumber;
271
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
272
+ name: z.ZodOptional<z.ZodString>;
273
+ mediaType: z.ZodOptional<z.ZodString>;
274
+ }, z.core.$strict>>;
275
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
276
+ }, z.core.$strict>;
277
+ estimatedTokens: z.ZodOptional<z.ZodNumber>;
278
+ requiresAcceptance: z.ZodBoolean;
279
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
280
+ }, z.core.$strict>;
281
+ export interface PortableContextPlanRequestMaterial {
282
+ source: PortableConversationContext;
283
+ destination: PortableContextDestination;
284
+ maxInputTokens?: number;
285
+ }
286
+ export declare function portableContextPlanRequestDigest(request: PortableContextPlanRequestMaterial): Sha256Digest;
287
+ export interface PortableContextPlanRequest extends PortableContextPlanRequestMaterial {
288
+ requestId: string;
289
+ requestDigest: Sha256Digest;
290
+ }
291
+ export declare const PortableContextPlanRequestSchema: z.ZodObject<{
292
+ requestId: z.ZodString;
293
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
294
+ source: z.ZodObject<{
295
+ source: z.ZodObject<{
296
+ runId: z.ZodString;
297
+ messageId: z.ZodOptional<z.ZodString>;
298
+ provider: z.ZodOptional<z.ZodString>;
299
+ environmentId: z.ZodOptional<z.ZodString>;
300
+ sessionId: z.ZodOptional<z.ZodString>;
301
+ }, z.core.$strict>;
302
+ completeness: z.ZodEnum<{
303
+ complete: "complete";
304
+ partial: "partial";
305
+ }>;
306
+ messages: z.ZodArray<z.ZodObject<{
307
+ id: z.ZodString;
308
+ role: z.ZodEnum<{
309
+ user: "user";
310
+ assistant: "assistant";
311
+ system: "system";
312
+ }>;
313
+ parts: z.ZodArray<z.ZodJSONSchema>;
314
+ timestamp: z.ZodISODateTime;
315
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
316
+ }, z.core.$strict>>;
317
+ attachments: z.ZodArray<z.ZodObject<{
318
+ messageId: z.ZodString;
319
+ partIndex: z.ZodNumber;
320
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
321
+ name: z.ZodOptional<z.ZodString>;
322
+ mediaType: z.ZodOptional<z.ZodString>;
323
+ }, z.core.$strict>>;
324
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
325
+ }, z.core.$strict>;
326
+ destination: z.ZodObject<{
327
+ runner: z.ZodString;
328
+ provider: z.ZodOptional<z.ZodString>;
329
+ model: z.ZodOptional<z.ZodString>;
330
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
331
+ }, z.core.$strict>;
332
+ maxInputTokens: z.ZodOptional<z.ZodNumber>;
333
+ }, z.core.$strict>;
334
+ interface PortableContextPlanResultBinding {
335
+ requestId: string;
336
+ requestDigest: Sha256Digest;
337
+ }
338
+ export type PortableContextPlanResult = (PortableContextPlanResultBinding & {
339
+ status: "ready";
340
+ plan: PortableContextPlan;
341
+ }) | (PortableContextPlanResultBinding & {
342
+ status: "over_limit";
343
+ estimatedTokens?: number;
344
+ maxInputTokens: number;
345
+ suggestedBoundaryMessageId?: string;
346
+ message: string;
347
+ }) | (PortableContextPlanResultBinding & {
348
+ status: "unsupported";
349
+ message: string;
350
+ });
351
+ export declare const PortableContextPlanResultSchema: z.ZodType<PortableContextPlanResult>;
352
+ /** Cross-check a planner result against the exact request and token budget. */
353
+ export declare function portableContextPlanResultMatchesRequest(request: PortableContextPlanRequest, result: PortableContextPlanResult): boolean;
354
+ export declare const ContextPlanAcceptanceSchema: z.ZodObject<{
355
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
356
+ acceptedAt: z.ZodISODateTime;
357
+ acceptedBy: z.ZodEnum<{
358
+ policy: "policy";
359
+ user: "user";
360
+ system: "system";
361
+ }>;
362
+ }, z.core.$strict>;
363
+ export type ContextPlanAcceptance = z.infer<typeof ContextPlanAcceptanceSchema>;
364
+ export interface ContextTransferRequestMaterial {
365
+ plan: PortableContextPlan;
366
+ acceptance: ContextPlanAcceptance;
367
+ }
368
+ export declare function contextTransferRequestDigest(request: ContextTransferRequestMaterial): Sha256Digest;
369
+ export declare const ContextTransferRequestSchema: z.ZodObject<{
370
+ operationId: z.ZodString;
371
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
372
+ plan: z.ZodObject<{
373
+ planId: z.ZodString;
374
+ source: z.ZodObject<{
375
+ source: z.ZodObject<{
376
+ runId: z.ZodString;
377
+ messageId: z.ZodOptional<z.ZodString>;
378
+ provider: z.ZodOptional<z.ZodString>;
379
+ environmentId: z.ZodOptional<z.ZodString>;
380
+ sessionId: z.ZodOptional<z.ZodString>;
381
+ }, z.core.$strict>;
382
+ completeness: z.ZodEnum<{
383
+ complete: "complete";
384
+ partial: "partial";
385
+ }>;
386
+ messages: z.ZodArray<z.ZodObject<{
387
+ id: z.ZodString;
388
+ role: z.ZodEnum<{
389
+ user: "user";
390
+ assistant: "assistant";
391
+ system: "system";
392
+ }>;
393
+ parts: z.ZodArray<z.ZodJSONSchema>;
394
+ timestamp: z.ZodISODateTime;
395
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
396
+ }, z.core.$strict>>;
397
+ attachments: z.ZodArray<z.ZodObject<{
398
+ messageId: z.ZodString;
399
+ partIndex: z.ZodNumber;
400
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
401
+ name: z.ZodOptional<z.ZodString>;
402
+ mediaType: z.ZodOptional<z.ZodString>;
403
+ }, z.core.$strict>>;
404
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
405
+ }, z.core.$strict>;
406
+ destination: z.ZodObject<{
407
+ runner: z.ZodString;
408
+ provider: z.ZodOptional<z.ZodString>;
409
+ model: z.ZodOptional<z.ZodString>;
410
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
411
+ }, z.core.$strict>;
412
+ messages: z.ZodArray<z.ZodObject<{
413
+ messageId: z.ZodString;
414
+ action: z.ZodEnum<{
415
+ include: "include";
416
+ omit: "omit";
417
+ }>;
418
+ parts: z.ZodArray<z.ZodObject<{
419
+ partIndex: z.ZodNumber;
420
+ action: z.ZodEnum<{
421
+ transform: "transform";
422
+ include: "include";
423
+ omit: "omit";
424
+ }>;
425
+ output: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
426
+ type: z.ZodLiteral<"text">;
427
+ text: z.ZodString;
428
+ }, z.core.$strict>, z.ZodObject<{
429
+ type: z.ZodLiteral<"file">;
430
+ filename: z.ZodOptional<z.ZodString>;
431
+ mediaType: z.ZodOptional<z.ZodString>;
432
+ url: z.ZodOptional<z.ZodString>;
433
+ path: z.ZodOptional<z.ZodString>;
434
+ content: z.ZodOptional<z.ZodString>;
435
+ }, z.core.$strict>, z.ZodObject<{
436
+ type: z.ZodLiteral<"image">;
437
+ filename: z.ZodOptional<z.ZodString>;
438
+ mediaType: z.ZodOptional<z.ZodString>;
439
+ url: z.ZodOptional<z.ZodString>;
440
+ path: z.ZodOptional<z.ZodString>;
441
+ }, z.core.$strict>], "type">>;
442
+ reason: z.ZodOptional<z.ZodString>;
443
+ }, z.core.$strict>>;
444
+ reason: z.ZodOptional<z.ZodString>;
445
+ }, z.core.$strict>>;
446
+ context: z.ZodObject<{
447
+ source: z.ZodObject<{
448
+ runId: z.ZodString;
449
+ messageId: z.ZodOptional<z.ZodString>;
450
+ provider: z.ZodOptional<z.ZodString>;
451
+ environmentId: z.ZodOptional<z.ZodString>;
452
+ sessionId: z.ZodOptional<z.ZodString>;
453
+ }, z.core.$strict>;
454
+ completeness: z.ZodEnum<{
455
+ complete: "complete";
456
+ partial: "partial";
457
+ }>;
458
+ messages: z.ZodArray<z.ZodObject<{
459
+ id: z.ZodString;
460
+ role: z.ZodEnum<{
461
+ user: "user";
462
+ assistant: "assistant";
463
+ system: "system";
464
+ }>;
465
+ parts: z.ZodArray<z.ZodJSONSchema>;
466
+ timestamp: z.ZodISODateTime;
467
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
468
+ }, z.core.$strict>>;
469
+ attachments: z.ZodArray<z.ZodObject<{
470
+ messageId: z.ZodString;
471
+ partIndex: z.ZodNumber;
472
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
473
+ name: z.ZodOptional<z.ZodString>;
474
+ mediaType: z.ZodOptional<z.ZodString>;
475
+ }, z.core.$strict>>;
476
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
477
+ }, z.core.$strict>;
478
+ estimatedTokens: z.ZodOptional<z.ZodNumber>;
479
+ requiresAcceptance: z.ZodBoolean;
480
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
481
+ }, z.core.$strict>;
482
+ acceptance: z.ZodObject<{
483
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
484
+ acceptedAt: z.ZodISODateTime;
485
+ acceptedBy: z.ZodEnum<{
486
+ policy: "policy";
487
+ user: "user";
488
+ system: "system";
489
+ }>;
490
+ }, z.core.$strict>;
491
+ }, z.core.$strict>;
492
+ export type ContextTransferRequest = z.infer<typeof ContextTransferRequestSchema>;
493
+ export declare const ContextTransferReceiptSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
494
+ status: z.ZodLiteral<"accepted" | "replayed">;
495
+ operationId: z.ZodString;
496
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
497
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
498
+ contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
499
+ destination: z.ZodObject<{
500
+ runner: z.ZodString;
501
+ provider: z.ZodOptional<z.ZodString>;
502
+ model: z.ZodOptional<z.ZodString>;
503
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
504
+ }, z.core.$strict>;
505
+ provider: z.ZodString;
506
+ environmentId: z.ZodString;
507
+ sessionId: z.ZodString;
508
+ sessionCreatedForOperationId: z.ZodString;
509
+ sessionCreatedAt: z.ZodISODateTime;
510
+ transferredMessageIds: z.ZodArray<z.ZodString>;
511
+ omittedMessageIds: z.ZodArray<z.ZodString>;
512
+ admittedAt: z.ZodISODateTime;
513
+ }, z.core.$strict>, z.ZodObject<{
514
+ status: z.ZodLiteral<"accepted" | "replayed">;
515
+ operationId: z.ZodString;
516
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
517
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
518
+ contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
519
+ destination: z.ZodObject<{
520
+ runner: z.ZodString;
521
+ provider: z.ZodOptional<z.ZodString>;
522
+ model: z.ZodOptional<z.ZodString>;
523
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
524
+ }, z.core.$strict>;
525
+ provider: z.ZodString;
526
+ environmentId: z.ZodString;
527
+ sessionId: z.ZodString;
528
+ sessionCreatedForOperationId: z.ZodString;
529
+ sessionCreatedAt: z.ZodISODateTime;
530
+ transferredMessageIds: z.ZodArray<z.ZodString>;
531
+ omittedMessageIds: z.ZodArray<z.ZodString>;
532
+ admittedAt: z.ZodISODateTime;
533
+ }, z.core.$strict>], "status">;
534
+ export type ContextTransferReceipt = z.infer<typeof ContextTransferReceiptSchema>;
535
+ export declare const ContextTransferResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
536
+ status: z.ZodLiteral<"accepted" | "replayed">;
537
+ operationId: z.ZodString;
538
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
539
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
540
+ contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
541
+ destination: z.ZodObject<{
542
+ runner: z.ZodString;
543
+ provider: z.ZodOptional<z.ZodString>;
544
+ model: z.ZodOptional<z.ZodString>;
545
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
546
+ }, z.core.$strict>;
547
+ provider: z.ZodString;
548
+ environmentId: z.ZodString;
549
+ sessionId: z.ZodString;
550
+ sessionCreatedForOperationId: z.ZodString;
551
+ sessionCreatedAt: z.ZodISODateTime;
552
+ transferredMessageIds: z.ZodArray<z.ZodString>;
553
+ omittedMessageIds: z.ZodArray<z.ZodString>;
554
+ admittedAt: z.ZodISODateTime;
555
+ }, z.core.$strict>, z.ZodObject<{
556
+ status: z.ZodLiteral<"accepted" | "replayed">;
557
+ operationId: z.ZodString;
558
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
559
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
560
+ contextDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
561
+ destination: z.ZodObject<{
562
+ runner: z.ZodString;
563
+ provider: z.ZodOptional<z.ZodString>;
564
+ model: z.ZodOptional<z.ZodString>;
565
+ profileDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
566
+ }, z.core.$strict>;
567
+ provider: z.ZodString;
568
+ environmentId: z.ZodString;
569
+ sessionId: z.ZodString;
570
+ sessionCreatedForOperationId: z.ZodString;
571
+ sessionCreatedAt: z.ZodISODateTime;
572
+ transferredMessageIds: z.ZodArray<z.ZodString>;
573
+ omittedMessageIds: z.ZodArray<z.ZodString>;
574
+ admittedAt: z.ZodISODateTime;
575
+ }, z.core.$strict>, z.ZodObject<{
576
+ status: z.ZodLiteral<"conflict">;
577
+ operationId: z.ZodString;
578
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
579
+ existingRequestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
580
+ }, z.core.$strict>, z.ZodObject<{
581
+ status: z.ZodEnum<{
582
+ unknown: "unknown";
583
+ transport_failure: "transport_failure";
584
+ }>;
585
+ operationId: z.ZodString;
586
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
587
+ message: z.ZodString;
588
+ retryable: z.ZodBoolean;
589
+ }, z.core.$strict>], "status">;
590
+ export type ContextTransferResult = z.infer<typeof ContextTransferResultSchema>;
591
+ /** Bind every transfer outcome to the exact operation before acting on it. */
592
+ export declare function contextTransferResultMatchesRequest(request: ContextTransferRequest, result: ContextTransferResult): boolean;
593
+ export declare const NativeContextBoundarySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
594
+ kind: z.ZodLiteral<"token">;
595
+ token: z.ZodString;
596
+ }, z.core.$strict>, z.ZodObject<{
597
+ kind: z.ZodLiteral<"revision">;
598
+ revision: z.ZodString;
599
+ }, z.core.$strict>, z.ZodObject<{
600
+ kind: z.ZodLiteral<"digest">;
601
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
602
+ }, z.core.$strict>, z.ZodObject<{
603
+ kind: z.ZodLiteral<"messages">;
604
+ messageIds: z.ZodArray<z.ZodString>;
605
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
606
+ }, z.core.$strict>], "kind">;
607
+ export type NativeContextBoundary = z.infer<typeof NativeContextBoundarySchema>;
608
+ export declare const NativeContextBoundaryProofSchema: z.ZodObject<{
609
+ runId: z.ZodString;
610
+ provider: z.ZodString;
611
+ environmentId: z.ZodString;
612
+ sessionId: z.ZodString;
613
+ boundary: z.ZodDiscriminatedUnion<[z.ZodObject<{
614
+ kind: z.ZodLiteral<"token">;
615
+ token: z.ZodString;
616
+ }, z.core.$strict>, z.ZodObject<{
617
+ kind: z.ZodLiteral<"revision">;
618
+ revision: z.ZodString;
619
+ }, z.core.$strict>, z.ZodObject<{
620
+ kind: z.ZodLiteral<"digest">;
621
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
622
+ }, z.core.$strict>, z.ZodObject<{
623
+ kind: z.ZodLiteral<"messages">;
624
+ messageIds: z.ZodArray<z.ZodString>;
625
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
626
+ }, z.core.$strict>], "kind">;
627
+ observedAt: z.ZodISODateTime;
628
+ }, z.core.$strict>;
629
+ export type NativeContextBoundaryProof = z.infer<typeof NativeContextBoundaryProofSchema>;
630
+ export interface NativeContextContinuationRequest {
631
+ operationId: string;
632
+ requestDigest: Sha256Digest;
633
+ run: AgentRunControlRef;
634
+ expectedBoundary: NativeContextBoundaryProof;
635
+ }
636
+ export interface NativeContextContinuationRequestMaterial {
637
+ run: AgentRunControlRef;
638
+ expectedBoundary: NativeContextBoundaryProof;
639
+ }
640
+ export declare function nativeContextContinuationRequestDigest(request: NativeContextContinuationRequestMaterial): Sha256Digest;
641
+ export declare const NativeContextContinuationRequestSchema: z.ZodObject<{
642
+ operationId: z.ZodString;
643
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
644
+ run: z.ZodObject<{
645
+ runId: z.ZodString;
646
+ provider: z.ZodString;
647
+ environmentId: z.ZodString;
648
+ sessionId: z.ZodOptional<z.ZodString>;
649
+ executionId: z.ZodOptional<z.ZodString>;
650
+ }, z.core.$strict>;
651
+ expectedBoundary: z.ZodObject<{
652
+ runId: z.ZodString;
653
+ provider: z.ZodString;
654
+ environmentId: z.ZodString;
655
+ sessionId: z.ZodString;
656
+ boundary: z.ZodDiscriminatedUnion<[z.ZodObject<{
657
+ kind: z.ZodLiteral<"token">;
658
+ token: z.ZodString;
659
+ }, z.core.$strict>, z.ZodObject<{
660
+ kind: z.ZodLiteral<"revision">;
661
+ revision: z.ZodString;
662
+ }, z.core.$strict>, z.ZodObject<{
663
+ kind: z.ZodLiteral<"digest">;
664
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
665
+ }, z.core.$strict>, z.ZodObject<{
666
+ kind: z.ZodLiteral<"messages">;
667
+ messageIds: z.ZodArray<z.ZodString>;
668
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
669
+ }, z.core.$strict>], "kind">;
670
+ observedAt: z.ZodISODateTime;
671
+ }, z.core.$strict>;
672
+ }, z.core.$strict>;
673
+ export declare const NativeContextContinuationAcknowledgementSchema: z.ZodObject<{
674
+ operationId: z.ZodString;
675
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
676
+ status: z.ZodEnum<{
677
+ conflict: "conflict";
678
+ accepted: "accepted";
679
+ transport_failure: "transport_failure";
680
+ replayed: "replayed";
681
+ boundary_mismatch: "boundary_mismatch";
682
+ unverified: "unverified";
683
+ unknown_session: "unknown_session";
684
+ }>;
685
+ historyMessagesSent: z.ZodNumber;
686
+ existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
687
+ actualBoundary: z.ZodOptional<z.ZodObject<{
688
+ runId: z.ZodString;
689
+ provider: z.ZodString;
690
+ environmentId: z.ZodString;
691
+ sessionId: z.ZodString;
692
+ boundary: z.ZodDiscriminatedUnion<[z.ZodObject<{
693
+ kind: z.ZodLiteral<"token">;
694
+ token: z.ZodString;
695
+ }, z.core.$strict>, z.ZodObject<{
696
+ kind: z.ZodLiteral<"revision">;
697
+ revision: z.ZodString;
698
+ }, z.core.$strict>, z.ZodObject<{
699
+ kind: z.ZodLiteral<"digest">;
700
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
701
+ }, z.core.$strict>, z.ZodObject<{
702
+ kind: z.ZodLiteral<"messages">;
703
+ messageIds: z.ZodArray<z.ZodString>;
704
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
705
+ }, z.core.$strict>], "kind">;
706
+ observedAt: z.ZodISODateTime;
707
+ }, z.core.$strict>>;
708
+ message: z.ZodOptional<z.ZodString>;
709
+ retryable: z.ZodOptional<z.ZodBoolean>;
710
+ }, z.core.$strict>;
711
+ export type NativeContextContinuationAcknowledgement = z.infer<typeof NativeContextContinuationAcknowledgementSchema>;
712
+ /** Exact cross-check required before committing a transfer receipt. */
713
+ export declare function contextTransferReceiptMatches(request: ContextTransferRequest, receipt: ContextTransferReceipt): boolean;
714
+ /** Exact cross-check required before accepting a native continuation result. */
715
+ export declare function nativeContextContinuationAcknowledgementMatches(request: NativeContextContinuationRequest, acknowledgement: NativeContextContinuationAcknowledgement): boolean;
716
+ export {};