@roll-agent/browser-use-agent 0.26.1 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/SKILL.md +36 -8
  2. package/dist/browser-observation.d.ts +1 -0
  3. package/dist/execution-visual-feedback.d.ts +61 -0
  4. package/dist/goal/compact-request.d.ts +5 -0
  5. package/dist/goal/contracts.d.ts +1732 -0
  6. package/dist/goal/decisions.d.ts +55 -0
  7. package/dist/goal/dependency-observation.d.ts +7 -0
  8. package/dist/goal/execution-context.d.ts +593 -0
  9. package/dist/goal/form-context.d.ts +639 -0
  10. package/dist/goal/form-handoff.d.ts +152 -0
  11. package/dist/goal/form-loop-progress.d.ts +9 -0
  12. package/dist/goal/form-policy.d.ts +13 -0
  13. package/dist/goal/host.d.ts +6 -0
  14. package/dist/goal/interaction-feedback.d.ts +82 -0
  15. package/dist/goal/loop.d.ts +12 -0
  16. package/dist/goal/observation-retry.d.ts +3 -0
  17. package/dist/goal/observation.d.ts +981 -0
  18. package/dist/goal/operate-handoff.d.ts +3 -0
  19. package/dist/goal/picker-observation.d.ts +56 -0
  20. package/dist/goal/picker-state.d.ts +96 -0
  21. package/dist/goal/reachability.d.ts +2 -0
  22. package/dist/goal/task-evidence.d.ts +33 -0
  23. package/dist/goal/task-freshness.d.ts +86 -0
  24. package/dist/goal/task-loop.d.ts +5 -0
  25. package/dist/goal/task-observation.d.ts +5 -0
  26. package/dist/goal/task-policy.d.ts +174 -0
  27. package/dist/goal/task-progress-policy.d.ts +25 -0
  28. package/dist/goal/task-progress.d.ts +353 -0
  29. package/dist/goal/task-sources.d.ts +13 -0
  30. package/dist/index.js +1 -1
  31. package/dist/native-visual-activity-session.d.ts +38 -1
  32. package/dist/tools/browser-operate.d.ts +252 -0
  33. package/dist/tools/zhipin-diagnose-browser-state.d.ts +4 -4
  34. package/dist/tools/zhipin-generate-reply-preview.d.ts +1 -1
  35. package/dist/tools/zhipin-get-candidate-info.d.ts +1 -1
  36. package/dist/tools/zhipin-scroll-view.d.ts +5 -5
  37. package/package.json +3 -3
  38. package/references/browser-exploration.md +52 -0
  39. package/references/env.yaml +11 -0
@@ -0,0 +1,1732 @@
1
+ import { z } from "zod";
2
+ export declare const TaskAssistantPurposeSchema: z.ZodEnum<["preflight", "resolve_value", "resolve_batch", "validate_value", "validate_batch", "review_field", "review", "clarify"]>;
3
+ export declare const ResolvedTaskValueSchema: z.ZodObject<{
4
+ text: z.ZodString;
5
+ source: z.ZodEnum<["supplied", "derived", "generated", "selected"]>;
6
+ sourceIds: z.ZodArray<z.ZodString, "many">;
7
+ evidence: z.ZodString;
8
+ }, "strip", z.ZodTypeAny, {
9
+ source: "selected" | "supplied" | "derived" | "generated";
10
+ text: string;
11
+ evidence: string;
12
+ sourceIds: string[];
13
+ }, {
14
+ source: "selected" | "supplied" | "derived" | "generated";
15
+ text: string;
16
+ evidence: string;
17
+ sourceIds: string[];
18
+ }>;
19
+ export type ResolvedTaskValue = z.infer<typeof ResolvedTaskValueSchema>;
20
+ export declare const BrowserOperateInputSchema: z.ZodObject<{
21
+ pageId: z.ZodString;
22
+ goal: z.ZodString;
23
+ formTask: z.ZodOptional<z.ZodObject<{
24
+ mode: z.ZodEnum<["create", "edit"]>;
25
+ stopAt: z.ZodDefault<z.ZodEnum<["applied", "current-view"]>>;
26
+ fields: z.ZodEffects<z.ZodArray<z.ZodDiscriminatedUnion<"intent", [z.ZodObject<{
27
+ name: z.ZodString;
28
+ intent: z.ZodLiteral<"set">;
29
+ valueName: z.ZodString;
30
+ comparison: z.ZodDefault<z.ZodEnum<["auto", "literal", "semantic"]>>;
31
+ }, "strict", z.ZodTypeAny, {
32
+ name: string;
33
+ intent: "set";
34
+ comparison: "auto" | "literal" | "semantic";
35
+ valueName: string;
36
+ }, {
37
+ name: string;
38
+ intent: "set";
39
+ valueName: string;
40
+ comparison?: "auto" | "literal" | "semantic" | undefined;
41
+ }>, z.ZodObject<{
42
+ name: z.ZodString;
43
+ intent: z.ZodLiteral<"preserve">;
44
+ }, "strict", z.ZodTypeAny, {
45
+ name: string;
46
+ intent: "preserve";
47
+ }, {
48
+ name: string;
49
+ intent: "preserve";
50
+ }>]>, "many">, ({
51
+ name: string;
52
+ intent: "set";
53
+ comparison: "auto" | "literal" | "semantic";
54
+ valueName: string;
55
+ } | {
56
+ name: string;
57
+ intent: "preserve";
58
+ })[], ({
59
+ name: string;
60
+ intent: "set";
61
+ valueName: string;
62
+ comparison?: "auto" | "literal" | "semantic" | undefined;
63
+ } | {
64
+ name: string;
65
+ intent: "preserve";
66
+ })[]>;
67
+ }, "strict", z.ZodTypeAny, {
68
+ mode: "create" | "edit";
69
+ stopAt: "applied" | "current-view";
70
+ fields: ({
71
+ name: string;
72
+ intent: "set";
73
+ comparison: "auto" | "literal" | "semantic";
74
+ valueName: string;
75
+ } | {
76
+ name: string;
77
+ intent: "preserve";
78
+ })[];
79
+ }, {
80
+ mode: "create" | "edit";
81
+ fields: ({
82
+ name: string;
83
+ intent: "set";
84
+ valueName: string;
85
+ comparison?: "auto" | "literal" | "semantic" | undefined;
86
+ } | {
87
+ name: string;
88
+ intent: "preserve";
89
+ })[];
90
+ stopAt?: "applied" | "current-view" | undefined;
91
+ }>>;
92
+ readTask: z.ZodOptional<z.ZodObject<{
93
+ target: z.ZodString;
94
+ captureView: z.ZodString;
95
+ outputs: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
96
+ terminal: z.ZodObject<{
97
+ view: z.ZodString;
98
+ selectedTab: z.ZodOptional<z.ZodString>;
99
+ }, "strict", z.ZodTypeAny, {
100
+ view: string;
101
+ selectedTab?: string | undefined;
102
+ }, {
103
+ view: string;
104
+ selectedTab?: string | undefined;
105
+ }>;
106
+ }, "strict", z.ZodTypeAny, {
107
+ target: string;
108
+ captureView: string;
109
+ outputs: string[];
110
+ terminal: {
111
+ view: string;
112
+ selectedTab?: string | undefined;
113
+ };
114
+ }, {
115
+ target: string;
116
+ captureView: string;
117
+ outputs: string[];
118
+ terminal: {
119
+ view: string;
120
+ selectedTab?: string | undefined;
121
+ };
122
+ }>>;
123
+ values: z.ZodDefault<z.ZodArray<z.ZodObject<{
124
+ name: z.ZodString;
125
+ text: z.ZodString;
126
+ }, "strip", z.ZodTypeAny, {
127
+ name: string;
128
+ text: string;
129
+ }, {
130
+ name: string;
131
+ text: string;
132
+ }>, "many">>;
133
+ delegatedDecisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
134
+ maxTextCalls: z.ZodDefault<z.ZodNumber>;
135
+ maxRecoveryDecisions: z.ZodDefault<z.ZodNumber>;
136
+ allowedOrigins: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
137
+ blockedNames: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
138
+ engine: z.ZodOptional<z.ZodEnum<["jev", "sampling"]>>;
139
+ strategy: z.ZodDefault<z.ZodEnum<["task", "fields"]>>;
140
+ model: z.ZodOptional<z.ZodString>;
141
+ maxSteps: z.ZodDefault<z.ZodNumber>;
142
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
143
+ browserActionApproval: z.ZodOptional<z.ZodObject<{
144
+ id: z.ZodString;
145
+ }, "strip", z.ZodTypeAny, {
146
+ id: string;
147
+ }, {
148
+ id: string;
149
+ }>>;
150
+ }, "strip", z.ZodTypeAny, {
151
+ values: {
152
+ name: string;
153
+ text: string;
154
+ }[];
155
+ pageId: string;
156
+ timeoutMs: number;
157
+ allowedOrigins: string[];
158
+ goal: string;
159
+ delegatedDecisions: string[];
160
+ maxTextCalls: number;
161
+ maxRecoveryDecisions: number;
162
+ blockedNames: string[];
163
+ strategy: "task" | "fields";
164
+ maxSteps: number;
165
+ model?: string | undefined;
166
+ browserActionApproval?: {
167
+ id: string;
168
+ } | undefined;
169
+ formTask?: {
170
+ mode: "create" | "edit";
171
+ stopAt: "applied" | "current-view";
172
+ fields: ({
173
+ name: string;
174
+ intent: "set";
175
+ comparison: "auto" | "literal" | "semantic";
176
+ valueName: string;
177
+ } | {
178
+ name: string;
179
+ intent: "preserve";
180
+ })[];
181
+ } | undefined;
182
+ readTask?: {
183
+ target: string;
184
+ captureView: string;
185
+ outputs: string[];
186
+ terminal: {
187
+ view: string;
188
+ selectedTab?: string | undefined;
189
+ };
190
+ } | undefined;
191
+ engine?: "jev" | "sampling" | undefined;
192
+ }, {
193
+ pageId: string;
194
+ allowedOrigins: string[];
195
+ goal: string;
196
+ values?: {
197
+ name: string;
198
+ text: string;
199
+ }[] | undefined;
200
+ timeoutMs?: number | undefined;
201
+ model?: string | undefined;
202
+ browserActionApproval?: {
203
+ id: string;
204
+ } | undefined;
205
+ formTask?: {
206
+ mode: "create" | "edit";
207
+ fields: ({
208
+ name: string;
209
+ intent: "set";
210
+ valueName: string;
211
+ comparison?: "auto" | "literal" | "semantic" | undefined;
212
+ } | {
213
+ name: string;
214
+ intent: "preserve";
215
+ })[];
216
+ stopAt?: "applied" | "current-view" | undefined;
217
+ } | undefined;
218
+ readTask?: {
219
+ target: string;
220
+ captureView: string;
221
+ outputs: string[];
222
+ terminal: {
223
+ view: string;
224
+ selectedTab?: string | undefined;
225
+ };
226
+ } | undefined;
227
+ delegatedDecisions?: string[] | undefined;
228
+ maxTextCalls?: number | undefined;
229
+ maxRecoveryDecisions?: number | undefined;
230
+ blockedNames?: string[] | undefined;
231
+ engine?: "jev" | "sampling" | undefined;
232
+ strategy?: "task" | "fields" | undefined;
233
+ maxSteps?: number | undefined;
234
+ }>;
235
+ export type BrowserOperateInput = z.infer<typeof BrowserOperateInputSchema>;
236
+ export declare const BrowserOperateOutputSchema: z.ZodObject<{
237
+ status: z.ZodEnum<["model_done", "interaction_done", "needs_input", "needs_reasoning", "blocked", "step_limit", "failed", "cancelled"]>;
238
+ verified: z.ZodLiteral<false>;
239
+ handoff: z.ZodOptional<z.ZodObject<{
240
+ observationFresh: z.ZodBoolean;
241
+ diagnosticsOmitted: z.ZodLiteral<true>;
242
+ totalSteps: z.ZodNumber;
243
+ omittedSteps: z.ZodNumber;
244
+ fields: z.ZodArray<z.ZodObject<Pick<{
245
+ id: z.ZodString;
246
+ name: z.ZodString;
247
+ intent: z.ZodEnum<["set", "preserve"]>;
248
+ comparison: z.ZodEnum<["auto", "literal", "semantic"]>;
249
+ expected: z.ZodOptional<z.ZodString>;
250
+ binding: z.ZodOptional<z.ZodObject<{
251
+ identity: z.ZodString;
252
+ readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
253
+ key: z.ZodOptional<z.ZodString>;
254
+ name: z.ZodString;
255
+ role: z.ZodString;
256
+ fieldLabel: z.ZodOptional<z.ZodString>;
257
+ }, "strip", z.ZodTypeAny, {
258
+ role: string;
259
+ name: string;
260
+ identity: string;
261
+ key?: string | undefined;
262
+ fieldLabel?: string | undefined;
263
+ readOnlyDisplay?: true | undefined;
264
+ }, {
265
+ role: string;
266
+ name: string;
267
+ identity: string;
268
+ key?: string | undefined;
269
+ fieldLabel?: string | undefined;
270
+ readOnlyDisplay?: true | undefined;
271
+ }>>;
272
+ entry: z.ZodOptional<z.ZodObject<{
273
+ identity: z.ZodString;
274
+ readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
275
+ key: z.ZodOptional<z.ZodString>;
276
+ name: z.ZodString;
277
+ role: z.ZodString;
278
+ fieldLabel: z.ZodOptional<z.ZodString>;
279
+ }, "strip", z.ZodTypeAny, {
280
+ role: string;
281
+ name: string;
282
+ identity: string;
283
+ key?: string | undefined;
284
+ fieldLabel?: string | undefined;
285
+ readOnlyDisplay?: true | undefined;
286
+ }, {
287
+ role: string;
288
+ name: string;
289
+ identity: string;
290
+ key?: string | undefined;
291
+ fieldLabel?: string | undefined;
292
+ readOnlyDisplay?: true | undefined;
293
+ }>>;
294
+ entryProof: z.ZodOptional<z.ZodObject<{
295
+ fingerprint: z.ZodString;
296
+ status: z.ZodEnum<["satisfied", "unsatisfied", "unknown"]>;
297
+ }, "strip", z.ZodTypeAny, {
298
+ status: "unknown" | "satisfied" | "unsatisfied";
299
+ fingerprint: string;
300
+ }, {
301
+ status: "unknown" | "satisfied" | "unsatisfied";
302
+ fingerprint: string;
303
+ }>>;
304
+ initial: z.ZodOptional<z.ZodString>;
305
+ current: z.ZodOptional<z.ZodString>;
306
+ status: z.ZodEnum<["unknown", "unsatisfied", "satisfied"]>;
307
+ reason: z.ZodString;
308
+ fingerprint: z.ZodOptional<z.ZodString>;
309
+ target: z.ZodOptional<z.ZodObject<{
310
+ key: z.ZodString;
311
+ label: z.ZodString;
312
+ optionsKey: z.ZodString;
313
+ }, "strip", z.ZodTypeAny, {
314
+ label: string;
315
+ key: string;
316
+ optionsKey: string;
317
+ }, {
318
+ label: string;
319
+ key: string;
320
+ optionsKey: string;
321
+ }>>;
322
+ semanticProof: z.ZodOptional<z.ZodObject<{
323
+ fingerprint: z.ZodString;
324
+ status: z.ZodEnum<["satisfied", "unsatisfied"]>;
325
+ }, "strip", z.ZodTypeAny, {
326
+ status: "satisfied" | "unsatisfied";
327
+ fingerprint: string;
328
+ }, {
329
+ status: "satisfied" | "unsatisfied";
330
+ fingerprint: string;
331
+ }>>;
332
+ }, "status" | "id" | "name" | "reason" | "intent"> & {
333
+ expected: z.ZodOptional<z.ZodString>;
334
+ current: z.ZodOptional<z.ZodString>;
335
+ valueTruncated: z.ZodBoolean;
336
+ }, "strip", z.ZodTypeAny, {
337
+ status: "unknown" | "satisfied" | "unsatisfied";
338
+ id: string;
339
+ name: string;
340
+ reason: string;
341
+ intent: "set" | "preserve";
342
+ valueTruncated: boolean;
343
+ expected?: string | undefined;
344
+ current?: string | undefined;
345
+ }, {
346
+ status: "unknown" | "satisfied" | "unsatisfied";
347
+ id: string;
348
+ name: string;
349
+ reason: string;
350
+ intent: "set" | "preserve";
351
+ valueTruncated: boolean;
352
+ expected?: string | undefined;
353
+ current?: string | undefined;
354
+ }>, "many">;
355
+ next: z.ZodString;
356
+ }, "strip", z.ZodTypeAny, {
357
+ fields: {
358
+ status: "unknown" | "satisfied" | "unsatisfied";
359
+ id: string;
360
+ name: string;
361
+ reason: string;
362
+ intent: "set" | "preserve";
363
+ valueTruncated: boolean;
364
+ expected?: string | undefined;
365
+ current?: string | undefined;
366
+ }[];
367
+ observationFresh: boolean;
368
+ diagnosticsOmitted: true;
369
+ totalSteps: number;
370
+ omittedSteps: number;
371
+ next: string;
372
+ }, {
373
+ fields: {
374
+ status: "unknown" | "satisfied" | "unsatisfied";
375
+ id: string;
376
+ name: string;
377
+ reason: string;
378
+ intent: "set" | "preserve";
379
+ valueTruncated: boolean;
380
+ expected?: string | undefined;
381
+ current?: string | undefined;
382
+ }[];
383
+ observationFresh: boolean;
384
+ diagnosticsOmitted: true;
385
+ totalSteps: number;
386
+ omittedSteps: number;
387
+ next: string;
388
+ }>>;
389
+ progress: z.ZodOptional<z.ZodObject<{
390
+ taskRunId: z.ZodString;
391
+ contractDigest: z.ZodString;
392
+ phase: z.ZodEnum<["collect", "return", "done"]>;
393
+ evidence: z.ZodArray<z.ZodObject<{
394
+ id: z.ZodString;
395
+ field: z.ZodString;
396
+ text: z.ZodString;
397
+ observationId: z.ZodString;
398
+ documentId: z.ZodString;
399
+ frameId: z.ZodString;
400
+ url: z.ZodString;
401
+ regionId: z.ZodString;
402
+ regionName: z.ZodString;
403
+ start: z.ZodNumber;
404
+ end: z.ZodNumber;
405
+ observedAt: z.ZodString;
406
+ attribution: z.ZodLiteral<"model-selected-observed-text">;
407
+ }, "strip", z.ZodTypeAny, {
408
+ id: string;
409
+ url: string;
410
+ frameId: string;
411
+ documentId: string;
412
+ text: string;
413
+ field: string;
414
+ end: number;
415
+ observedAt: string;
416
+ observationId: string;
417
+ regionId: string;
418
+ regionName: string;
419
+ start: number;
420
+ attribution: "model-selected-observed-text";
421
+ }, {
422
+ id: string;
423
+ url: string;
424
+ frameId: string;
425
+ documentId: string;
426
+ text: string;
427
+ field: string;
428
+ end: number;
429
+ observedAt: string;
430
+ observationId: string;
431
+ regionId: string;
432
+ regionName: string;
433
+ start: number;
434
+ attribution: "model-selected-observed-text";
435
+ }>, "many">;
436
+ invalidatedEvidence: z.ZodArray<z.ZodObject<{
437
+ id: z.ZodString;
438
+ field: z.ZodString;
439
+ text: z.ZodString;
440
+ observationId: z.ZodString;
441
+ documentId: z.ZodString;
442
+ frameId: z.ZodString;
443
+ url: z.ZodString;
444
+ regionId: z.ZodString;
445
+ regionName: z.ZodString;
446
+ start: z.ZodNumber;
447
+ end: z.ZodNumber;
448
+ observedAt: z.ZodString;
449
+ attribution: z.ZodLiteral<"model-selected-observed-text">;
450
+ }, "strip", z.ZodTypeAny, {
451
+ id: string;
452
+ url: string;
453
+ frameId: string;
454
+ documentId: string;
455
+ text: string;
456
+ field: string;
457
+ end: number;
458
+ observedAt: string;
459
+ observationId: string;
460
+ regionId: string;
461
+ regionName: string;
462
+ start: number;
463
+ attribution: "model-selected-observed-text";
464
+ }, {
465
+ id: string;
466
+ url: string;
467
+ frameId: string;
468
+ documentId: string;
469
+ text: string;
470
+ field: string;
471
+ end: number;
472
+ observedAt: string;
473
+ observationId: string;
474
+ regionId: string;
475
+ regionName: string;
476
+ start: number;
477
+ attribution: "model-selected-observed-text";
478
+ }>, "many">;
479
+ missing: z.ZodArray<z.ZodString, "many">;
480
+ capturedRegion: z.ZodOptional<z.ZodObject<{
481
+ documentId: z.ZodString;
482
+ frameId: z.ZodString;
483
+ url: z.ZodString;
484
+ id: z.ZodString;
485
+ name: z.ZodString;
486
+ digest: z.ZodString;
487
+ }, "strip", z.ZodTypeAny, {
488
+ id: string;
489
+ url: string;
490
+ name: string;
491
+ frameId: string;
492
+ documentId: string;
493
+ digest: string;
494
+ }, {
495
+ id: string;
496
+ url: string;
497
+ name: string;
498
+ frameId: string;
499
+ documentId: string;
500
+ digest: string;
501
+ }>>;
502
+ conflicts: z.ZodNumber;
503
+ }, "strip", z.ZodTypeAny, {
504
+ missing: string[];
505
+ taskRunId: string;
506
+ contractDigest: string;
507
+ phase: "collect" | "return" | "done";
508
+ evidence: {
509
+ id: string;
510
+ url: string;
511
+ frameId: string;
512
+ documentId: string;
513
+ text: string;
514
+ field: string;
515
+ end: number;
516
+ observedAt: string;
517
+ observationId: string;
518
+ regionId: string;
519
+ regionName: string;
520
+ start: number;
521
+ attribution: "model-selected-observed-text";
522
+ }[];
523
+ invalidatedEvidence: {
524
+ id: string;
525
+ url: string;
526
+ frameId: string;
527
+ documentId: string;
528
+ text: string;
529
+ field: string;
530
+ end: number;
531
+ observedAt: string;
532
+ observationId: string;
533
+ regionId: string;
534
+ regionName: string;
535
+ start: number;
536
+ attribution: "model-selected-observed-text";
537
+ }[];
538
+ conflicts: number;
539
+ capturedRegion?: {
540
+ id: string;
541
+ url: string;
542
+ name: string;
543
+ frameId: string;
544
+ documentId: string;
545
+ digest: string;
546
+ } | undefined;
547
+ }, {
548
+ missing: string[];
549
+ taskRunId: string;
550
+ contractDigest: string;
551
+ phase: "collect" | "return" | "done";
552
+ evidence: {
553
+ id: string;
554
+ url: string;
555
+ frameId: string;
556
+ documentId: string;
557
+ text: string;
558
+ field: string;
559
+ end: number;
560
+ observedAt: string;
561
+ observationId: string;
562
+ regionId: string;
563
+ regionName: string;
564
+ start: number;
565
+ attribution: "model-selected-observed-text";
566
+ }[];
567
+ invalidatedEvidence: {
568
+ id: string;
569
+ url: string;
570
+ frameId: string;
571
+ documentId: string;
572
+ text: string;
573
+ field: string;
574
+ end: number;
575
+ observedAt: string;
576
+ observationId: string;
577
+ regionId: string;
578
+ regionName: string;
579
+ start: number;
580
+ attribution: "model-selected-observed-text";
581
+ }[];
582
+ conflicts: number;
583
+ capturedRegion?: {
584
+ id: string;
585
+ url: string;
586
+ name: string;
587
+ frameId: string;
588
+ documentId: string;
589
+ digest: string;
590
+ } | undefined;
591
+ }>>;
592
+ execution: z.ZodOptional<z.ZodObject<{
593
+ invocationId: z.ZodString;
594
+ revision: z.ZodNumber;
595
+ documentChanged: z.ZodBoolean;
596
+ latestObservation: z.ZodOptional<z.ZodString>;
597
+ focus: z.ZodOptional<z.ZodString>;
598
+ changes: z.ZodArray<z.ZodObject<{
599
+ observationId: z.ZodString;
600
+ identity: z.ZodString;
601
+ field: z.ZodString;
602
+ kind: z.ZodEnum<["changed", "became_unknown", "appeared"]>;
603
+ before: z.ZodOptional<z.ZodString>;
604
+ after: z.ZodOptional<z.ZodString>;
605
+ afterAction: z.ZodOptional<z.ZodString>;
606
+ scope: z.ZodEnum<["delegated", "preserved", "unassigned"]>;
607
+ }, "strip", z.ZodTypeAny, {
608
+ scope: "delegated" | "preserved" | "unassigned";
609
+ kind: "changed" | "became_unknown" | "appeared";
610
+ field: string;
611
+ observationId: string;
612
+ identity: string;
613
+ before?: string | undefined;
614
+ after?: string | undefined;
615
+ afterAction?: string | undefined;
616
+ }, {
617
+ scope: "delegated" | "preserved" | "unassigned";
618
+ kind: "changed" | "became_unknown" | "appeared";
619
+ field: string;
620
+ observationId: string;
621
+ identity: string;
622
+ before?: string | undefined;
623
+ after?: string | undefined;
624
+ afterAction?: string | undefined;
625
+ }>, "many">;
626
+ lastAction: z.ZodOptional<z.ZodObject<{
627
+ operation: z.ZodString;
628
+ target: z.ZodOptional<z.ZodString>;
629
+ executed: z.ZodBoolean;
630
+ error: z.ZodOptional<z.ZodString>;
631
+ }, "strip", z.ZodTypeAny, {
632
+ executed: boolean;
633
+ operation: string;
634
+ target?: string | undefined;
635
+ error?: string | undefined;
636
+ }, {
637
+ executed: boolean;
638
+ operation: string;
639
+ target?: string | undefined;
640
+ error?: string | undefined;
641
+ }>>;
642
+ form: z.ZodOptional<z.ZodObject<{
643
+ mode: z.ZodEnum<["create", "edit"]>;
644
+ stopAt: z.ZodEnum<["applied", "current-view"]>;
645
+ fields: z.ZodArray<z.ZodObject<{
646
+ id: z.ZodString;
647
+ name: z.ZodString;
648
+ intent: z.ZodEnum<["set", "preserve"]>;
649
+ comparison: z.ZodEnum<["auto", "literal", "semantic"]>;
650
+ expected: z.ZodOptional<z.ZodString>;
651
+ binding: z.ZodOptional<z.ZodObject<{
652
+ identity: z.ZodString;
653
+ readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
654
+ key: z.ZodOptional<z.ZodString>;
655
+ name: z.ZodString;
656
+ role: z.ZodString;
657
+ fieldLabel: z.ZodOptional<z.ZodString>;
658
+ }, "strip", z.ZodTypeAny, {
659
+ role: string;
660
+ name: string;
661
+ identity: string;
662
+ key?: string | undefined;
663
+ fieldLabel?: string | undefined;
664
+ readOnlyDisplay?: true | undefined;
665
+ }, {
666
+ role: string;
667
+ name: string;
668
+ identity: string;
669
+ key?: string | undefined;
670
+ fieldLabel?: string | undefined;
671
+ readOnlyDisplay?: true | undefined;
672
+ }>>;
673
+ entry: z.ZodOptional<z.ZodObject<{
674
+ identity: z.ZodString;
675
+ readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
676
+ key: z.ZodOptional<z.ZodString>;
677
+ name: z.ZodString;
678
+ role: z.ZodString;
679
+ fieldLabel: z.ZodOptional<z.ZodString>;
680
+ }, "strip", z.ZodTypeAny, {
681
+ role: string;
682
+ name: string;
683
+ identity: string;
684
+ key?: string | undefined;
685
+ fieldLabel?: string | undefined;
686
+ readOnlyDisplay?: true | undefined;
687
+ }, {
688
+ role: string;
689
+ name: string;
690
+ identity: string;
691
+ key?: string | undefined;
692
+ fieldLabel?: string | undefined;
693
+ readOnlyDisplay?: true | undefined;
694
+ }>>;
695
+ entryProof: z.ZodOptional<z.ZodObject<{
696
+ fingerprint: z.ZodString;
697
+ status: z.ZodEnum<["satisfied", "unsatisfied", "unknown"]>;
698
+ }, "strip", z.ZodTypeAny, {
699
+ status: "unknown" | "satisfied" | "unsatisfied";
700
+ fingerprint: string;
701
+ }, {
702
+ status: "unknown" | "satisfied" | "unsatisfied";
703
+ fingerprint: string;
704
+ }>>;
705
+ initial: z.ZodOptional<z.ZodString>;
706
+ current: z.ZodOptional<z.ZodString>;
707
+ status: z.ZodEnum<["unknown", "unsatisfied", "satisfied"]>;
708
+ reason: z.ZodString;
709
+ fingerprint: z.ZodOptional<z.ZodString>;
710
+ target: z.ZodOptional<z.ZodObject<{
711
+ key: z.ZodString;
712
+ label: z.ZodString;
713
+ optionsKey: z.ZodString;
714
+ }, "strip", z.ZodTypeAny, {
715
+ label: string;
716
+ key: string;
717
+ optionsKey: string;
718
+ }, {
719
+ label: string;
720
+ key: string;
721
+ optionsKey: string;
722
+ }>>;
723
+ semanticProof: z.ZodOptional<z.ZodObject<{
724
+ fingerprint: z.ZodString;
725
+ status: z.ZodEnum<["satisfied", "unsatisfied"]>;
726
+ }, "strip", z.ZodTypeAny, {
727
+ status: "satisfied" | "unsatisfied";
728
+ fingerprint: string;
729
+ }, {
730
+ status: "satisfied" | "unsatisfied";
731
+ fingerprint: string;
732
+ }>>;
733
+ }, "strip", z.ZodTypeAny, {
734
+ status: "unknown" | "satisfied" | "unsatisfied";
735
+ id: string;
736
+ name: string;
737
+ reason: string;
738
+ intent: "set" | "preserve";
739
+ comparison: "auto" | "literal" | "semantic";
740
+ expected?: string | undefined;
741
+ target?: {
742
+ label: string;
743
+ key: string;
744
+ optionsKey: string;
745
+ } | undefined;
746
+ fingerprint?: string | undefined;
747
+ binding?: {
748
+ role: string;
749
+ name: string;
750
+ identity: string;
751
+ key?: string | undefined;
752
+ fieldLabel?: string | undefined;
753
+ readOnlyDisplay?: true | undefined;
754
+ } | undefined;
755
+ entry?: {
756
+ role: string;
757
+ name: string;
758
+ identity: string;
759
+ key?: string | undefined;
760
+ fieldLabel?: string | undefined;
761
+ readOnlyDisplay?: true | undefined;
762
+ } | undefined;
763
+ entryProof?: {
764
+ status: "unknown" | "satisfied" | "unsatisfied";
765
+ fingerprint: string;
766
+ } | undefined;
767
+ initial?: string | undefined;
768
+ current?: string | undefined;
769
+ semanticProof?: {
770
+ status: "satisfied" | "unsatisfied";
771
+ fingerprint: string;
772
+ } | undefined;
773
+ }, {
774
+ status: "unknown" | "satisfied" | "unsatisfied";
775
+ id: string;
776
+ name: string;
777
+ reason: string;
778
+ intent: "set" | "preserve";
779
+ comparison: "auto" | "literal" | "semantic";
780
+ expected?: string | undefined;
781
+ target?: {
782
+ label: string;
783
+ key: string;
784
+ optionsKey: string;
785
+ } | undefined;
786
+ fingerprint?: string | undefined;
787
+ binding?: {
788
+ role: string;
789
+ name: string;
790
+ identity: string;
791
+ key?: string | undefined;
792
+ fieldLabel?: string | undefined;
793
+ readOnlyDisplay?: true | undefined;
794
+ } | undefined;
795
+ entry?: {
796
+ role: string;
797
+ name: string;
798
+ identity: string;
799
+ key?: string | undefined;
800
+ fieldLabel?: string | undefined;
801
+ readOnlyDisplay?: true | undefined;
802
+ } | undefined;
803
+ entryProof?: {
804
+ status: "unknown" | "satisfied" | "unsatisfied";
805
+ fingerprint: string;
806
+ } | undefined;
807
+ initial?: string | undefined;
808
+ current?: string | undefined;
809
+ semanticProof?: {
810
+ status: "satisfied" | "unsatisfied";
811
+ fingerprint: string;
812
+ } | undefined;
813
+ }>, "many">;
814
+ focus: z.ZodOptional<z.ZodString>;
815
+ panel: z.ZodOptional<z.ZodObject<{
816
+ key: z.ZodString;
817
+ status: z.ZodEnum<["pending", "accepted", "rejected"]>;
818
+ queryIdentity: z.ZodOptional<z.ZodString>;
819
+ }, "strip", z.ZodTypeAny, {
820
+ status: "pending" | "rejected" | "accepted";
821
+ key: string;
822
+ queryIdentity?: string | undefined;
823
+ }, {
824
+ status: "pending" | "rejected" | "accepted";
825
+ key: string;
826
+ queryIdentity?: string | undefined;
827
+ }>>;
828
+ }, "strip", z.ZodTypeAny, {
829
+ mode: "create" | "edit";
830
+ stopAt: "applied" | "current-view";
831
+ fields: {
832
+ status: "unknown" | "satisfied" | "unsatisfied";
833
+ id: string;
834
+ name: string;
835
+ reason: string;
836
+ intent: "set" | "preserve";
837
+ comparison: "auto" | "literal" | "semantic";
838
+ expected?: string | undefined;
839
+ target?: {
840
+ label: string;
841
+ key: string;
842
+ optionsKey: string;
843
+ } | undefined;
844
+ fingerprint?: string | undefined;
845
+ binding?: {
846
+ role: string;
847
+ name: string;
848
+ identity: string;
849
+ key?: string | undefined;
850
+ fieldLabel?: string | undefined;
851
+ readOnlyDisplay?: true | undefined;
852
+ } | undefined;
853
+ entry?: {
854
+ role: string;
855
+ name: string;
856
+ identity: string;
857
+ key?: string | undefined;
858
+ fieldLabel?: string | undefined;
859
+ readOnlyDisplay?: true | undefined;
860
+ } | undefined;
861
+ entryProof?: {
862
+ status: "unknown" | "satisfied" | "unsatisfied";
863
+ fingerprint: string;
864
+ } | undefined;
865
+ initial?: string | undefined;
866
+ current?: string | undefined;
867
+ semanticProof?: {
868
+ status: "satisfied" | "unsatisfied";
869
+ fingerprint: string;
870
+ } | undefined;
871
+ }[];
872
+ panel?: {
873
+ status: "pending" | "rejected" | "accepted";
874
+ key: string;
875
+ queryIdentity?: string | undefined;
876
+ } | undefined;
877
+ focus?: string | undefined;
878
+ }, {
879
+ mode: "create" | "edit";
880
+ stopAt: "applied" | "current-view";
881
+ fields: {
882
+ status: "unknown" | "satisfied" | "unsatisfied";
883
+ id: string;
884
+ name: string;
885
+ reason: string;
886
+ intent: "set" | "preserve";
887
+ comparison: "auto" | "literal" | "semantic";
888
+ expected?: string | undefined;
889
+ target?: {
890
+ label: string;
891
+ key: string;
892
+ optionsKey: string;
893
+ } | undefined;
894
+ fingerprint?: string | undefined;
895
+ binding?: {
896
+ role: string;
897
+ name: string;
898
+ identity: string;
899
+ key?: string | undefined;
900
+ fieldLabel?: string | undefined;
901
+ readOnlyDisplay?: true | undefined;
902
+ } | undefined;
903
+ entry?: {
904
+ role: string;
905
+ name: string;
906
+ identity: string;
907
+ key?: string | undefined;
908
+ fieldLabel?: string | undefined;
909
+ readOnlyDisplay?: true | undefined;
910
+ } | undefined;
911
+ entryProof?: {
912
+ status: "unknown" | "satisfied" | "unsatisfied";
913
+ fingerprint: string;
914
+ } | undefined;
915
+ initial?: string | undefined;
916
+ current?: string | undefined;
917
+ semanticProof?: {
918
+ status: "satisfied" | "unsatisfied";
919
+ fingerprint: string;
920
+ } | undefined;
921
+ }[];
922
+ panel?: {
923
+ status: "pending" | "rejected" | "accepted";
924
+ key: string;
925
+ queryIdentity?: string | undefined;
926
+ } | undefined;
927
+ focus?: string | undefined;
928
+ }>>;
929
+ }, "strip", z.ZodTypeAny, {
930
+ changes: {
931
+ scope: "delegated" | "preserved" | "unassigned";
932
+ kind: "changed" | "became_unknown" | "appeared";
933
+ field: string;
934
+ observationId: string;
935
+ identity: string;
936
+ before?: string | undefined;
937
+ after?: string | undefined;
938
+ afterAction?: string | undefined;
939
+ }[];
940
+ revision: number;
941
+ invocationId: string;
942
+ documentChanged: boolean;
943
+ form?: {
944
+ mode: "create" | "edit";
945
+ stopAt: "applied" | "current-view";
946
+ fields: {
947
+ status: "unknown" | "satisfied" | "unsatisfied";
948
+ id: string;
949
+ name: string;
950
+ reason: string;
951
+ intent: "set" | "preserve";
952
+ comparison: "auto" | "literal" | "semantic";
953
+ expected?: string | undefined;
954
+ target?: {
955
+ label: string;
956
+ key: string;
957
+ optionsKey: string;
958
+ } | undefined;
959
+ fingerprint?: string | undefined;
960
+ binding?: {
961
+ role: string;
962
+ name: string;
963
+ identity: string;
964
+ key?: string | undefined;
965
+ fieldLabel?: string | undefined;
966
+ readOnlyDisplay?: true | undefined;
967
+ } | undefined;
968
+ entry?: {
969
+ role: string;
970
+ name: string;
971
+ identity: string;
972
+ key?: string | undefined;
973
+ fieldLabel?: string | undefined;
974
+ readOnlyDisplay?: true | undefined;
975
+ } | undefined;
976
+ entryProof?: {
977
+ status: "unknown" | "satisfied" | "unsatisfied";
978
+ fingerprint: string;
979
+ } | undefined;
980
+ initial?: string | undefined;
981
+ current?: string | undefined;
982
+ semanticProof?: {
983
+ status: "satisfied" | "unsatisfied";
984
+ fingerprint: string;
985
+ } | undefined;
986
+ }[];
987
+ panel?: {
988
+ status: "pending" | "rejected" | "accepted";
989
+ key: string;
990
+ queryIdentity?: string | undefined;
991
+ } | undefined;
992
+ focus?: string | undefined;
993
+ } | undefined;
994
+ focus?: string | undefined;
995
+ latestObservation?: string | undefined;
996
+ lastAction?: {
997
+ executed: boolean;
998
+ operation: string;
999
+ target?: string | undefined;
1000
+ error?: string | undefined;
1001
+ } | undefined;
1002
+ }, {
1003
+ changes: {
1004
+ scope: "delegated" | "preserved" | "unassigned";
1005
+ kind: "changed" | "became_unknown" | "appeared";
1006
+ field: string;
1007
+ observationId: string;
1008
+ identity: string;
1009
+ before?: string | undefined;
1010
+ after?: string | undefined;
1011
+ afterAction?: string | undefined;
1012
+ }[];
1013
+ revision: number;
1014
+ invocationId: string;
1015
+ documentChanged: boolean;
1016
+ form?: {
1017
+ mode: "create" | "edit";
1018
+ stopAt: "applied" | "current-view";
1019
+ fields: {
1020
+ status: "unknown" | "satisfied" | "unsatisfied";
1021
+ id: string;
1022
+ name: string;
1023
+ reason: string;
1024
+ intent: "set" | "preserve";
1025
+ comparison: "auto" | "literal" | "semantic";
1026
+ expected?: string | undefined;
1027
+ target?: {
1028
+ label: string;
1029
+ key: string;
1030
+ optionsKey: string;
1031
+ } | undefined;
1032
+ fingerprint?: string | undefined;
1033
+ binding?: {
1034
+ role: string;
1035
+ name: string;
1036
+ identity: string;
1037
+ key?: string | undefined;
1038
+ fieldLabel?: string | undefined;
1039
+ readOnlyDisplay?: true | undefined;
1040
+ } | undefined;
1041
+ entry?: {
1042
+ role: string;
1043
+ name: string;
1044
+ identity: string;
1045
+ key?: string | undefined;
1046
+ fieldLabel?: string | undefined;
1047
+ readOnlyDisplay?: true | undefined;
1048
+ } | undefined;
1049
+ entryProof?: {
1050
+ status: "unknown" | "satisfied" | "unsatisfied";
1051
+ fingerprint: string;
1052
+ } | undefined;
1053
+ initial?: string | undefined;
1054
+ current?: string | undefined;
1055
+ semanticProof?: {
1056
+ status: "satisfied" | "unsatisfied";
1057
+ fingerprint: string;
1058
+ } | undefined;
1059
+ }[];
1060
+ panel?: {
1061
+ status: "pending" | "rejected" | "accepted";
1062
+ key: string;
1063
+ queryIdentity?: string | undefined;
1064
+ } | undefined;
1065
+ focus?: string | undefined;
1066
+ } | undefined;
1067
+ focus?: string | undefined;
1068
+ latestObservation?: string | undefined;
1069
+ lastAction?: {
1070
+ executed: boolean;
1071
+ operation: string;
1072
+ target?: string | undefined;
1073
+ error?: string | undefined;
1074
+ } | undefined;
1075
+ }>>;
1076
+ elapsedMs: z.ZodNumber;
1077
+ steps: z.ZodArray<z.ZodObject<{
1078
+ step: z.ZodNumber;
1079
+ observationMs: z.ZodNumber;
1080
+ decisionMs: z.ZodNumber;
1081
+ decisionAttempts: z.ZodOptional<z.ZodNumber>;
1082
+ actionMs: z.ZodNumber;
1083
+ textMs: z.ZodOptional<z.ZodNumber>;
1084
+ recovery: z.ZodOptional<z.ZodBoolean>;
1085
+ distributions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1086
+ probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
1087
+ confidence: z.ZodOptional<z.ZodNumber>;
1088
+ }, "strip", z.ZodTypeAny, {
1089
+ probabilities: Record<string, number>;
1090
+ confidence?: number | undefined;
1091
+ }, {
1092
+ probabilities: Record<string, number>;
1093
+ confidence?: number | undefined;
1094
+ }>>>;
1095
+ operation: z.ZodString;
1096
+ requirement: z.ZodOptional<z.ZodString>;
1097
+ target: z.ZodOptional<z.ZodString>;
1098
+ valueName: z.ZodOptional<z.ZodString>;
1099
+ executed: z.ZodBoolean;
1100
+ error: z.ZodOptional<z.ZodString>;
1101
+ requestedModel: z.ZodString;
1102
+ resolvedModel: z.ZodString;
1103
+ provider: z.ZodString;
1104
+ usage: z.ZodOptional<z.ZodObject<{
1105
+ inputTokens: z.ZodOptional<z.ZodNumber>;
1106
+ outputTokens: z.ZodOptional<z.ZodNumber>;
1107
+ cost: z.ZodOptional<z.ZodNumber>;
1108
+ }, "strip", z.ZodTypeAny, {
1109
+ cost?: number | undefined;
1110
+ inputTokens?: number | undefined;
1111
+ outputTokens?: number | undefined;
1112
+ }, {
1113
+ cost?: number | undefined;
1114
+ inputTokens?: number | undefined;
1115
+ outputTokens?: number | undefined;
1116
+ }>>;
1117
+ }, "strip", z.ZodTypeAny, {
1118
+ executed: boolean;
1119
+ step: number;
1120
+ provider: string;
1121
+ requestedModel: string;
1122
+ resolvedModel: string;
1123
+ operation: string;
1124
+ observationMs: number;
1125
+ decisionMs: number;
1126
+ actionMs: number;
1127
+ target?: string | undefined;
1128
+ error?: string | undefined;
1129
+ usage?: {
1130
+ cost?: number | undefined;
1131
+ inputTokens?: number | undefined;
1132
+ outputTokens?: number | undefined;
1133
+ } | undefined;
1134
+ distributions?: Record<string, {
1135
+ probabilities: Record<string, number>;
1136
+ confidence?: number | undefined;
1137
+ }> | undefined;
1138
+ valueName?: string | undefined;
1139
+ decisionAttempts?: number | undefined;
1140
+ textMs?: number | undefined;
1141
+ recovery?: boolean | undefined;
1142
+ requirement?: string | undefined;
1143
+ }, {
1144
+ executed: boolean;
1145
+ step: number;
1146
+ provider: string;
1147
+ requestedModel: string;
1148
+ resolvedModel: string;
1149
+ operation: string;
1150
+ observationMs: number;
1151
+ decisionMs: number;
1152
+ actionMs: number;
1153
+ target?: string | undefined;
1154
+ error?: string | undefined;
1155
+ usage?: {
1156
+ cost?: number | undefined;
1157
+ inputTokens?: number | undefined;
1158
+ outputTokens?: number | undefined;
1159
+ } | undefined;
1160
+ distributions?: Record<string, {
1161
+ probabilities: Record<string, number>;
1162
+ confidence?: number | undefined;
1163
+ }> | undefined;
1164
+ valueName?: string | undefined;
1165
+ decisionAttempts?: number | undefined;
1166
+ textMs?: number | undefined;
1167
+ recovery?: boolean | undefined;
1168
+ requirement?: string | undefined;
1169
+ }>, "many">;
1170
+ error: z.ZodOptional<z.ZodString>;
1171
+ question: z.ZodOptional<z.ZodString>;
1172
+ recoveryDecisions: z.ZodOptional<z.ZodNumber>;
1173
+ fieldEvidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
1174
+ field: z.ZodString;
1175
+ instruction: z.ZodString;
1176
+ expected: z.ZodOptional<z.ZodString>;
1177
+ current: z.ZodOptional<z.ZodString>;
1178
+ status: z.ZodEnum<["pending", "applied", "preserved"]>;
1179
+ source: z.ZodOptional<z.ZodString>;
1180
+ targetKey: z.ZodString;
1181
+ }, "strip", z.ZodTypeAny, {
1182
+ status: "pending" | "preserved" | "applied";
1183
+ field: string;
1184
+ instruction: string;
1185
+ targetKey: string;
1186
+ expected?: string | undefined;
1187
+ source?: string | undefined;
1188
+ current?: string | undefined;
1189
+ }, {
1190
+ status: "pending" | "preserved" | "applied";
1191
+ field: string;
1192
+ instruction: string;
1193
+ targetKey: string;
1194
+ expected?: string | undefined;
1195
+ source?: string | undefined;
1196
+ current?: string | undefined;
1197
+ }>, "many">>;
1198
+ pendingRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1199
+ finalObservation: z.ZodOptional<z.ZodUnknown>;
1200
+ resolvedValues: z.ZodOptional<z.ZodArray<z.ZodObject<{
1201
+ text: z.ZodString;
1202
+ source: z.ZodEnum<["supplied", "derived", "generated", "selected"]>;
1203
+ sourceIds: z.ZodArray<z.ZodString, "many">;
1204
+ evidence: z.ZodString;
1205
+ } & {
1206
+ field: z.ZodString;
1207
+ targetKey: z.ZodOptional<z.ZodString>;
1208
+ }, "strip", z.ZodTypeAny, {
1209
+ source: "selected" | "supplied" | "derived" | "generated";
1210
+ text: string;
1211
+ field: string;
1212
+ evidence: string;
1213
+ sourceIds: string[];
1214
+ targetKey?: string | undefined;
1215
+ }, {
1216
+ source: "selected" | "supplied" | "derived" | "generated";
1217
+ text: string;
1218
+ field: string;
1219
+ evidence: string;
1220
+ sourceIds: string[];
1221
+ targetKey?: string | undefined;
1222
+ }>, "many">>;
1223
+ textCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
1224
+ purpose: z.ZodEnum<["preflight", "resolve_value", "resolve_batch", "validate_value", "validate_batch", "review_field", "review", "clarify"]>;
1225
+ elapsedMs: z.ZodNumber;
1226
+ cached: z.ZodBoolean;
1227
+ startedAtMs: z.ZodOptional<z.ZodNumber>;
1228
+ endedAtMs: z.ZodOptional<z.ZodNumber>;
1229
+ modelCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
1230
+ provider: z.ZodString;
1231
+ requestedModel: z.ZodString;
1232
+ resolvedModel: z.ZodString;
1233
+ elapsedMs: z.ZodNumber;
1234
+ fallback: z.ZodOptional<z.ZodBoolean>;
1235
+ error: z.ZodOptional<z.ZodString>;
1236
+ usage: z.ZodOptional<z.ZodObject<{
1237
+ inputTokens: z.ZodOptional<z.ZodNumber>;
1238
+ outputTokens: z.ZodOptional<z.ZodNumber>;
1239
+ cost: z.ZodOptional<z.ZodNumber>;
1240
+ }, "strip", z.ZodTypeAny, {
1241
+ cost?: number | undefined;
1242
+ inputTokens?: number | undefined;
1243
+ outputTokens?: number | undefined;
1244
+ }, {
1245
+ cost?: number | undefined;
1246
+ inputTokens?: number | undefined;
1247
+ outputTokens?: number | undefined;
1248
+ }>>;
1249
+ }, "strip", z.ZodTypeAny, {
1250
+ elapsedMs: number;
1251
+ provider: string;
1252
+ requestedModel: string;
1253
+ resolvedModel: string;
1254
+ error?: string | undefined;
1255
+ usage?: {
1256
+ cost?: number | undefined;
1257
+ inputTokens?: number | undefined;
1258
+ outputTokens?: number | undefined;
1259
+ } | undefined;
1260
+ fallback?: boolean | undefined;
1261
+ }, {
1262
+ elapsedMs: number;
1263
+ provider: string;
1264
+ requestedModel: string;
1265
+ resolvedModel: string;
1266
+ error?: string | undefined;
1267
+ usage?: {
1268
+ cost?: number | undefined;
1269
+ inputTokens?: number | undefined;
1270
+ outputTokens?: number | undefined;
1271
+ } | undefined;
1272
+ fallback?: boolean | undefined;
1273
+ }>, "many">>;
1274
+ }, "strip", z.ZodTypeAny, {
1275
+ elapsedMs: number;
1276
+ purpose: "preflight" | "resolve_value" | "resolve_batch" | "validate_value" | "validate_batch" | "review_field" | "review" | "clarify";
1277
+ cached: boolean;
1278
+ startedAtMs?: number | undefined;
1279
+ endedAtMs?: number | undefined;
1280
+ modelCalls?: {
1281
+ elapsedMs: number;
1282
+ provider: string;
1283
+ requestedModel: string;
1284
+ resolvedModel: string;
1285
+ error?: string | undefined;
1286
+ usage?: {
1287
+ cost?: number | undefined;
1288
+ inputTokens?: number | undefined;
1289
+ outputTokens?: number | undefined;
1290
+ } | undefined;
1291
+ fallback?: boolean | undefined;
1292
+ }[] | undefined;
1293
+ }, {
1294
+ elapsedMs: number;
1295
+ purpose: "preflight" | "resolve_value" | "resolve_batch" | "validate_value" | "validate_batch" | "review_field" | "review" | "clarify";
1296
+ cached: boolean;
1297
+ startedAtMs?: number | undefined;
1298
+ endedAtMs?: number | undefined;
1299
+ modelCalls?: {
1300
+ elapsedMs: number;
1301
+ provider: string;
1302
+ requestedModel: string;
1303
+ resolvedModel: string;
1304
+ error?: string | undefined;
1305
+ usage?: {
1306
+ cost?: number | undefined;
1307
+ inputTokens?: number | undefined;
1308
+ outputTokens?: number | undefined;
1309
+ } | undefined;
1310
+ fallback?: boolean | undefined;
1311
+ }[] | undefined;
1312
+ }>, "many">>;
1313
+ }, "strip", z.ZodTypeAny, {
1314
+ status: "failed" | "cancelled" | "needs_input" | "model_done" | "interaction_done" | "needs_reasoning" | "blocked" | "step_limit";
1315
+ elapsedMs: number;
1316
+ verified: false;
1317
+ steps: {
1318
+ executed: boolean;
1319
+ step: number;
1320
+ provider: string;
1321
+ requestedModel: string;
1322
+ resolvedModel: string;
1323
+ operation: string;
1324
+ observationMs: number;
1325
+ decisionMs: number;
1326
+ actionMs: number;
1327
+ target?: string | undefined;
1328
+ error?: string | undefined;
1329
+ usage?: {
1330
+ cost?: number | undefined;
1331
+ inputTokens?: number | undefined;
1332
+ outputTokens?: number | undefined;
1333
+ } | undefined;
1334
+ distributions?: Record<string, {
1335
+ probabilities: Record<string, number>;
1336
+ confidence?: number | undefined;
1337
+ }> | undefined;
1338
+ valueName?: string | undefined;
1339
+ decisionAttempts?: number | undefined;
1340
+ textMs?: number | undefined;
1341
+ recovery?: boolean | undefined;
1342
+ requirement?: string | undefined;
1343
+ }[];
1344
+ error?: string | undefined;
1345
+ progress?: {
1346
+ missing: string[];
1347
+ taskRunId: string;
1348
+ contractDigest: string;
1349
+ phase: "collect" | "return" | "done";
1350
+ evidence: {
1351
+ id: string;
1352
+ url: string;
1353
+ frameId: string;
1354
+ documentId: string;
1355
+ text: string;
1356
+ field: string;
1357
+ end: number;
1358
+ observedAt: string;
1359
+ observationId: string;
1360
+ regionId: string;
1361
+ regionName: string;
1362
+ start: number;
1363
+ attribution: "model-selected-observed-text";
1364
+ }[];
1365
+ invalidatedEvidence: {
1366
+ id: string;
1367
+ url: string;
1368
+ frameId: string;
1369
+ documentId: string;
1370
+ text: string;
1371
+ field: string;
1372
+ end: number;
1373
+ observedAt: string;
1374
+ observationId: string;
1375
+ regionId: string;
1376
+ regionName: string;
1377
+ start: number;
1378
+ attribution: "model-selected-observed-text";
1379
+ }[];
1380
+ conflicts: number;
1381
+ capturedRegion?: {
1382
+ id: string;
1383
+ url: string;
1384
+ name: string;
1385
+ frameId: string;
1386
+ documentId: string;
1387
+ digest: string;
1388
+ } | undefined;
1389
+ } | undefined;
1390
+ execution?: {
1391
+ changes: {
1392
+ scope: "delegated" | "preserved" | "unassigned";
1393
+ kind: "changed" | "became_unknown" | "appeared";
1394
+ field: string;
1395
+ observationId: string;
1396
+ identity: string;
1397
+ before?: string | undefined;
1398
+ after?: string | undefined;
1399
+ afterAction?: string | undefined;
1400
+ }[];
1401
+ revision: number;
1402
+ invocationId: string;
1403
+ documentChanged: boolean;
1404
+ form?: {
1405
+ mode: "create" | "edit";
1406
+ stopAt: "applied" | "current-view";
1407
+ fields: {
1408
+ status: "unknown" | "satisfied" | "unsatisfied";
1409
+ id: string;
1410
+ name: string;
1411
+ reason: string;
1412
+ intent: "set" | "preserve";
1413
+ comparison: "auto" | "literal" | "semantic";
1414
+ expected?: string | undefined;
1415
+ target?: {
1416
+ label: string;
1417
+ key: string;
1418
+ optionsKey: string;
1419
+ } | undefined;
1420
+ fingerprint?: string | undefined;
1421
+ binding?: {
1422
+ role: string;
1423
+ name: string;
1424
+ identity: string;
1425
+ key?: string | undefined;
1426
+ fieldLabel?: string | undefined;
1427
+ readOnlyDisplay?: true | undefined;
1428
+ } | undefined;
1429
+ entry?: {
1430
+ role: string;
1431
+ name: string;
1432
+ identity: string;
1433
+ key?: string | undefined;
1434
+ fieldLabel?: string | undefined;
1435
+ readOnlyDisplay?: true | undefined;
1436
+ } | undefined;
1437
+ entryProof?: {
1438
+ status: "unknown" | "satisfied" | "unsatisfied";
1439
+ fingerprint: string;
1440
+ } | undefined;
1441
+ initial?: string | undefined;
1442
+ current?: string | undefined;
1443
+ semanticProof?: {
1444
+ status: "satisfied" | "unsatisfied";
1445
+ fingerprint: string;
1446
+ } | undefined;
1447
+ }[];
1448
+ panel?: {
1449
+ status: "pending" | "rejected" | "accepted";
1450
+ key: string;
1451
+ queryIdentity?: string | undefined;
1452
+ } | undefined;
1453
+ focus?: string | undefined;
1454
+ } | undefined;
1455
+ focus?: string | undefined;
1456
+ latestObservation?: string | undefined;
1457
+ lastAction?: {
1458
+ executed: boolean;
1459
+ operation: string;
1460
+ target?: string | undefined;
1461
+ error?: string | undefined;
1462
+ } | undefined;
1463
+ } | undefined;
1464
+ resolvedValues?: {
1465
+ source: "selected" | "supplied" | "derived" | "generated";
1466
+ text: string;
1467
+ field: string;
1468
+ evidence: string;
1469
+ sourceIds: string[];
1470
+ targetKey?: string | undefined;
1471
+ }[] | undefined;
1472
+ question?: string | undefined;
1473
+ handoff?: {
1474
+ fields: {
1475
+ status: "unknown" | "satisfied" | "unsatisfied";
1476
+ id: string;
1477
+ name: string;
1478
+ reason: string;
1479
+ intent: "set" | "preserve";
1480
+ valueTruncated: boolean;
1481
+ expected?: string | undefined;
1482
+ current?: string | undefined;
1483
+ }[];
1484
+ observationFresh: boolean;
1485
+ diagnosticsOmitted: true;
1486
+ totalSteps: number;
1487
+ omittedSteps: number;
1488
+ next: string;
1489
+ } | undefined;
1490
+ recoveryDecisions?: number | undefined;
1491
+ fieldEvidence?: {
1492
+ status: "pending" | "preserved" | "applied";
1493
+ field: string;
1494
+ instruction: string;
1495
+ targetKey: string;
1496
+ expected?: string | undefined;
1497
+ source?: string | undefined;
1498
+ current?: string | undefined;
1499
+ }[] | undefined;
1500
+ pendingRequirements?: string[] | undefined;
1501
+ finalObservation?: unknown;
1502
+ textCalls?: {
1503
+ elapsedMs: number;
1504
+ purpose: "preflight" | "resolve_value" | "resolve_batch" | "validate_value" | "validate_batch" | "review_field" | "review" | "clarify";
1505
+ cached: boolean;
1506
+ startedAtMs?: number | undefined;
1507
+ endedAtMs?: number | undefined;
1508
+ modelCalls?: {
1509
+ elapsedMs: number;
1510
+ provider: string;
1511
+ requestedModel: string;
1512
+ resolvedModel: string;
1513
+ error?: string | undefined;
1514
+ usage?: {
1515
+ cost?: number | undefined;
1516
+ inputTokens?: number | undefined;
1517
+ outputTokens?: number | undefined;
1518
+ } | undefined;
1519
+ fallback?: boolean | undefined;
1520
+ }[] | undefined;
1521
+ }[] | undefined;
1522
+ }, {
1523
+ status: "failed" | "cancelled" | "needs_input" | "model_done" | "interaction_done" | "needs_reasoning" | "blocked" | "step_limit";
1524
+ elapsedMs: number;
1525
+ verified: false;
1526
+ steps: {
1527
+ executed: boolean;
1528
+ step: number;
1529
+ provider: string;
1530
+ requestedModel: string;
1531
+ resolvedModel: string;
1532
+ operation: string;
1533
+ observationMs: number;
1534
+ decisionMs: number;
1535
+ actionMs: number;
1536
+ target?: string | undefined;
1537
+ error?: string | undefined;
1538
+ usage?: {
1539
+ cost?: number | undefined;
1540
+ inputTokens?: number | undefined;
1541
+ outputTokens?: number | undefined;
1542
+ } | undefined;
1543
+ distributions?: Record<string, {
1544
+ probabilities: Record<string, number>;
1545
+ confidence?: number | undefined;
1546
+ }> | undefined;
1547
+ valueName?: string | undefined;
1548
+ decisionAttempts?: number | undefined;
1549
+ textMs?: number | undefined;
1550
+ recovery?: boolean | undefined;
1551
+ requirement?: string | undefined;
1552
+ }[];
1553
+ error?: string | undefined;
1554
+ progress?: {
1555
+ missing: string[];
1556
+ taskRunId: string;
1557
+ contractDigest: string;
1558
+ phase: "collect" | "return" | "done";
1559
+ evidence: {
1560
+ id: string;
1561
+ url: string;
1562
+ frameId: string;
1563
+ documentId: string;
1564
+ text: string;
1565
+ field: string;
1566
+ end: number;
1567
+ observedAt: string;
1568
+ observationId: string;
1569
+ regionId: string;
1570
+ regionName: string;
1571
+ start: number;
1572
+ attribution: "model-selected-observed-text";
1573
+ }[];
1574
+ invalidatedEvidence: {
1575
+ id: string;
1576
+ url: string;
1577
+ frameId: string;
1578
+ documentId: string;
1579
+ text: string;
1580
+ field: string;
1581
+ end: number;
1582
+ observedAt: string;
1583
+ observationId: string;
1584
+ regionId: string;
1585
+ regionName: string;
1586
+ start: number;
1587
+ attribution: "model-selected-observed-text";
1588
+ }[];
1589
+ conflicts: number;
1590
+ capturedRegion?: {
1591
+ id: string;
1592
+ url: string;
1593
+ name: string;
1594
+ frameId: string;
1595
+ documentId: string;
1596
+ digest: string;
1597
+ } | undefined;
1598
+ } | undefined;
1599
+ execution?: {
1600
+ changes: {
1601
+ scope: "delegated" | "preserved" | "unassigned";
1602
+ kind: "changed" | "became_unknown" | "appeared";
1603
+ field: string;
1604
+ observationId: string;
1605
+ identity: string;
1606
+ before?: string | undefined;
1607
+ after?: string | undefined;
1608
+ afterAction?: string | undefined;
1609
+ }[];
1610
+ revision: number;
1611
+ invocationId: string;
1612
+ documentChanged: boolean;
1613
+ form?: {
1614
+ mode: "create" | "edit";
1615
+ stopAt: "applied" | "current-view";
1616
+ fields: {
1617
+ status: "unknown" | "satisfied" | "unsatisfied";
1618
+ id: string;
1619
+ name: string;
1620
+ reason: string;
1621
+ intent: "set" | "preserve";
1622
+ comparison: "auto" | "literal" | "semantic";
1623
+ expected?: string | undefined;
1624
+ target?: {
1625
+ label: string;
1626
+ key: string;
1627
+ optionsKey: string;
1628
+ } | undefined;
1629
+ fingerprint?: string | undefined;
1630
+ binding?: {
1631
+ role: string;
1632
+ name: string;
1633
+ identity: string;
1634
+ key?: string | undefined;
1635
+ fieldLabel?: string | undefined;
1636
+ readOnlyDisplay?: true | undefined;
1637
+ } | undefined;
1638
+ entry?: {
1639
+ role: string;
1640
+ name: string;
1641
+ identity: string;
1642
+ key?: string | undefined;
1643
+ fieldLabel?: string | undefined;
1644
+ readOnlyDisplay?: true | undefined;
1645
+ } | undefined;
1646
+ entryProof?: {
1647
+ status: "unknown" | "satisfied" | "unsatisfied";
1648
+ fingerprint: string;
1649
+ } | undefined;
1650
+ initial?: string | undefined;
1651
+ current?: string | undefined;
1652
+ semanticProof?: {
1653
+ status: "satisfied" | "unsatisfied";
1654
+ fingerprint: string;
1655
+ } | undefined;
1656
+ }[];
1657
+ panel?: {
1658
+ status: "pending" | "rejected" | "accepted";
1659
+ key: string;
1660
+ queryIdentity?: string | undefined;
1661
+ } | undefined;
1662
+ focus?: string | undefined;
1663
+ } | undefined;
1664
+ focus?: string | undefined;
1665
+ latestObservation?: string | undefined;
1666
+ lastAction?: {
1667
+ executed: boolean;
1668
+ operation: string;
1669
+ target?: string | undefined;
1670
+ error?: string | undefined;
1671
+ } | undefined;
1672
+ } | undefined;
1673
+ resolvedValues?: {
1674
+ source: "selected" | "supplied" | "derived" | "generated";
1675
+ text: string;
1676
+ field: string;
1677
+ evidence: string;
1678
+ sourceIds: string[];
1679
+ targetKey?: string | undefined;
1680
+ }[] | undefined;
1681
+ question?: string | undefined;
1682
+ handoff?: {
1683
+ fields: {
1684
+ status: "unknown" | "satisfied" | "unsatisfied";
1685
+ id: string;
1686
+ name: string;
1687
+ reason: string;
1688
+ intent: "set" | "preserve";
1689
+ valueTruncated: boolean;
1690
+ expected?: string | undefined;
1691
+ current?: string | undefined;
1692
+ }[];
1693
+ observationFresh: boolean;
1694
+ diagnosticsOmitted: true;
1695
+ totalSteps: number;
1696
+ omittedSteps: number;
1697
+ next: string;
1698
+ } | undefined;
1699
+ recoveryDecisions?: number | undefined;
1700
+ fieldEvidence?: {
1701
+ status: "pending" | "preserved" | "applied";
1702
+ field: string;
1703
+ instruction: string;
1704
+ targetKey: string;
1705
+ expected?: string | undefined;
1706
+ source?: string | undefined;
1707
+ current?: string | undefined;
1708
+ }[] | undefined;
1709
+ pendingRequirements?: string[] | undefined;
1710
+ finalObservation?: unknown;
1711
+ textCalls?: {
1712
+ elapsedMs: number;
1713
+ purpose: "preflight" | "resolve_value" | "resolve_batch" | "validate_value" | "validate_batch" | "review_field" | "review" | "clarify";
1714
+ cached: boolean;
1715
+ startedAtMs?: number | undefined;
1716
+ endedAtMs?: number | undefined;
1717
+ modelCalls?: {
1718
+ elapsedMs: number;
1719
+ provider: string;
1720
+ requestedModel: string;
1721
+ resolvedModel: string;
1722
+ error?: string | undefined;
1723
+ usage?: {
1724
+ cost?: number | undefined;
1725
+ inputTokens?: number | undefined;
1726
+ outputTokens?: number | undefined;
1727
+ } | undefined;
1728
+ fallback?: boolean | undefined;
1729
+ }[] | undefined;
1730
+ }[] | undefined;
1731
+ }>;
1732
+ export type BrowserOperateOutput = z.infer<typeof BrowserOperateOutputSchema>;