@crosshands/contract 0.1.6 → 0.2.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 (26) hide show
  1. package/dist/errors.d.ts +140 -55
  2. package/dist/errors.d.ts.map +1 -1
  3. package/dist/errors.js +33 -12
  4. package/dist/errors.js.map +1 -1
  5. package/dist/json-schema.d.ts +12 -300
  6. package/dist/json-schema.d.ts.map +1 -1
  7. package/dist/json-schema.js +10 -6
  8. package/dist/json-schema.js.map +1 -1
  9. package/dist/operations.d.ts +1434 -706
  10. package/dist/operations.d.ts.map +1 -1
  11. package/dist/operations.js +103 -8
  12. package/dist/operations.js.map +1 -1
  13. package/dist/provider.d.ts +6 -6
  14. package/dist/schemas.d.ts +328 -149
  15. package/dist/schemas.d.ts.map +1 -1
  16. package/dist/schemas.js +63 -11
  17. package/dist/schemas.js.map +1 -1
  18. package/dist/versions.d.ts +4 -4
  19. package/dist/versions.js +2 -2
  20. package/package.json +1 -1
  21. package/schemas/contract.json +8751 -46
  22. package/src/errors.ts +49 -19
  23. package/src/json-schema.ts +11 -6
  24. package/src/operations.ts +142 -9
  25. package/src/schemas.ts +79 -11
  26. package/src/versions.ts +2 -2
package/dist/schemas.d.ts CHANGED
@@ -139,31 +139,7 @@ export declare const MutationOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject
139
139
  }, z.core.$strict>, z.ZodObject<{
140
140
  state: z.ZodLiteral<"failed">;
141
141
  error: z.ZodOptional<z.ZodObject<{
142
- code: z.ZodEnum<{
143
- app_not_found: "app_not_found";
144
- app_unavailable: "app_unavailable";
145
- app_blocked: "app_blocked";
146
- window_not_found: "window_not_found";
147
- window_unavailable: "window_unavailable";
148
- window_not_focused: "window_not_focused";
149
- permission_denied: "permission_denied";
150
- stale_target: "stale_target";
151
- element_not_found: "element_not_found";
152
- element_not_clickable: "element_not_clickable";
153
- action_not_supported: "action_not_supported";
154
- value_not_settable: "value_not_settable";
155
- invalid_argument: "invalid_argument";
156
- timeout: "timeout";
157
- unsupported_capability: "unsupported_capability";
158
- provider_unavailable: "provider_unavailable";
159
- provider_crashed: "provider_crashed";
160
- version_incompatible: "version_incompatible";
161
- interaction_context_invalid: "interaction_context_invalid";
162
- interaction_context_expired: "interaction_context_expired";
163
- session_unavailable: "session_unavailable";
164
- screenshot_failed: "screenshot_failed";
165
- accessibility_error: "accessibility_error";
166
- }>;
142
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
167
143
  message: z.ZodString;
168
144
  retry: z.ZodBoolean;
169
145
  remediation: z.ZodString;
@@ -172,31 +148,32 @@ export declare const MutationOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject
172
148
  }, z.core.$strict>, z.ZodObject<{
173
149
  state: z.ZodLiteral<"not_attempted">;
174
150
  error: z.ZodOptional<z.ZodObject<{
175
- code: z.ZodEnum<{
176
- app_not_found: "app_not_found";
177
- app_unavailable: "app_unavailable";
178
- app_blocked: "app_blocked";
179
- window_not_found: "window_not_found";
180
- window_unavailable: "window_unavailable";
181
- window_not_focused: "window_not_focused";
182
- permission_denied: "permission_denied";
183
- stale_target: "stale_target";
184
- element_not_found: "element_not_found";
185
- element_not_clickable: "element_not_clickable";
186
- action_not_supported: "action_not_supported";
187
- value_not_settable: "value_not_settable";
188
- invalid_argument: "invalid_argument";
189
- timeout: "timeout";
190
- unsupported_capability: "unsupported_capability";
191
- provider_unavailable: "provider_unavailable";
192
- provider_crashed: "provider_crashed";
193
- version_incompatible: "version_incompatible";
194
- interaction_context_invalid: "interaction_context_invalid";
195
- interaction_context_expired: "interaction_context_expired";
196
- session_unavailable: "session_unavailable";
197
- screenshot_failed: "screenshot_failed";
198
- accessibility_error: "accessibility_error";
199
- }>;
151
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
152
+ message: z.ZodString;
153
+ retry: z.ZodBoolean;
154
+ remediation: z.ZodString;
155
+ details: z.ZodOptional<z.ZodUnknown>;
156
+ }, z.core.$strict>>;
157
+ }, z.core.$strict>], "state">;
158
+ export declare const PublicMutationOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
159
+ state: z.ZodLiteral<"verified">;
160
+ evidence: z.ZodOptional<z.ZodUnknown>;
161
+ }, z.core.$strict>, z.ZodObject<{
162
+ state: z.ZodLiteral<"indeterminate">;
163
+ reason: z.ZodOptional<z.ZodString>;
164
+ }, z.core.$strict>, z.ZodObject<{
165
+ state: z.ZodLiteral<"failed">;
166
+ error: z.ZodOptional<z.ZodObject<{
167
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable">>;
168
+ message: z.ZodString;
169
+ retry: z.ZodBoolean;
170
+ remediation: z.ZodString;
171
+ details: z.ZodOptional<z.ZodUnknown>;
172
+ }, z.core.$strict>>;
173
+ }, z.core.$strict>, z.ZodObject<{
174
+ state: z.ZodLiteral<"not_attempted">;
175
+ error: z.ZodOptional<z.ZodObject<{
176
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable">>;
200
177
  message: z.ZodString;
201
178
  retry: z.ZodBoolean;
202
179
  remediation: z.ZodString;
@@ -262,36 +239,180 @@ export declare const SnapshotResultSchema: z.ZodObject<{
262
239
  expiresAt: z.ZodOptional<z.ZodISODateTime>;
263
240
  }, z.core.$strict>>;
264
241
  issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
265
- code: z.ZodEnum<{
266
- app_not_found: "app_not_found";
267
- app_unavailable: "app_unavailable";
268
- app_blocked: "app_blocked";
269
- window_not_found: "window_not_found";
270
- window_unavailable: "window_unavailable";
271
- window_not_focused: "window_not_focused";
272
- permission_denied: "permission_denied";
273
- stale_target: "stale_target";
274
- element_not_found: "element_not_found";
275
- element_not_clickable: "element_not_clickable";
276
- action_not_supported: "action_not_supported";
277
- value_not_settable: "value_not_settable";
278
- invalid_argument: "invalid_argument";
279
- timeout: "timeout";
280
- unsupported_capability: "unsupported_capability";
281
- provider_unavailable: "provider_unavailable";
282
- provider_crashed: "provider_crashed";
283
- version_incompatible: "version_incompatible";
284
- interaction_context_invalid: "interaction_context_invalid";
285
- interaction_context_expired: "interaction_context_expired";
286
- session_unavailable: "session_unavailable";
287
- screenshot_failed: "screenshot_failed";
288
- accessibility_error: "accessibility_error";
242
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
243
+ message: z.ZodString;
244
+ retry: z.ZodBoolean;
245
+ remediation: z.ZodString;
246
+ details: z.ZodOptional<z.ZodUnknown>;
247
+ }, z.core.$strict>>>;
248
+ }, z.core.$strict>;
249
+ export type SnapshotResult = z.infer<typeof SnapshotResultSchema>;
250
+ export declare const GoalSchema: z.ZodString;
251
+ export declare const IntentTargetSchema: z.ZodObject<{
252
+ kind: z.ZodLiteral<"intent">;
253
+ }, z.core.$strict>;
254
+ export declare const SuggestionMoveSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
255
+ kind: z.ZodLiteral<"click">;
256
+ elementIndex: z.ZodNumber;
257
+ }, z.core.$strict>, z.ZodObject<{
258
+ kind: z.ZodLiteral<"setValue">;
259
+ elementIndex: z.ZodNumber;
260
+ }, z.core.$strict>, z.ZodObject<{
261
+ kind: z.ZodLiteral<"secondary">;
262
+ elementIndex: z.ZodNumber;
263
+ action: z.ZodString;
264
+ }, z.core.$strict>, z.ZodObject<{
265
+ kind: z.ZodLiteral<"scroll">;
266
+ elementIndex: z.ZodNumber;
267
+ direction: z.ZodEnum<{
268
+ up: "up";
269
+ down: "down";
270
+ left: "left";
271
+ right: "right";
272
+ }>;
273
+ }, z.core.$strict>, z.ZodObject<{
274
+ kind: z.ZodLiteral<"wait">;
275
+ }, z.core.$strict>, z.ZodObject<{
276
+ kind: z.ZodLiteral<"done">;
277
+ }, z.core.$strict>, z.ZodObject<{
278
+ kind: z.ZodLiteral<"blocked">;
279
+ reason: z.ZodString;
280
+ }, z.core.$strict>], "kind">;
281
+ export declare const SuggestionSchema: z.ZodObject<{
282
+ untrusted: z.ZodLiteral<true>;
283
+ snapshotId: z.ZodString;
284
+ move: z.ZodDiscriminatedUnion<[z.ZodObject<{
285
+ kind: z.ZodLiteral<"click">;
286
+ elementIndex: z.ZodNumber;
287
+ }, z.core.$strict>, z.ZodObject<{
288
+ kind: z.ZodLiteral<"setValue">;
289
+ elementIndex: z.ZodNumber;
290
+ }, z.core.$strict>, z.ZodObject<{
291
+ kind: z.ZodLiteral<"secondary">;
292
+ elementIndex: z.ZodNumber;
293
+ action: z.ZodString;
294
+ }, z.core.$strict>, z.ZodObject<{
295
+ kind: z.ZodLiteral<"scroll">;
296
+ elementIndex: z.ZodNumber;
297
+ direction: z.ZodEnum<{
298
+ up: "up";
299
+ down: "down";
300
+ left: "left";
301
+ right: "right";
289
302
  }>;
303
+ }, z.core.$strict>, z.ZodObject<{
304
+ kind: z.ZodLiteral<"wait">;
305
+ }, z.core.$strict>, z.ZodObject<{
306
+ kind: z.ZodLiteral<"done">;
307
+ }, z.core.$strict>, z.ZodObject<{
308
+ kind: z.ZodLiteral<"blocked">;
309
+ reason: z.ZodString;
310
+ }, z.core.$strict>], "kind">;
311
+ confidence: z.ZodOptional<z.ZodNumber>;
312
+ label: z.ZodOptional<z.ZodString>;
313
+ }, z.core.$strict>;
314
+ export type Suggestion = z.infer<typeof SuggestionSchema>;
315
+ export declare const ResolvedTargetSchema: z.ZodObject<{
316
+ kind: z.ZodLiteral<"element">;
317
+ elementIndex: z.ZodNumber;
318
+ }, z.core.$strict>;
319
+ export declare const PublicSnapshotResultSchema: z.ZodObject<{
320
+ context: z.ZodObject<{
321
+ brokerGeneration: z.ZodString;
322
+ providerGeneration: z.ZodString;
323
+ graphicalSessionId: z.ZodString;
324
+ process: z.ZodObject<{
325
+ pid: z.ZodNumber;
326
+ startedAt: z.ZodISODateTime;
327
+ executableId: z.ZodString;
328
+ }, z.core.$strict>;
329
+ appId: z.ZodString;
330
+ window: z.ZodObject<{
331
+ id: z.ZodString;
332
+ ownerPid: z.ZodNumber;
333
+ }, z.core.$strict>;
334
+ snapshotId: z.ZodString;
335
+ desktopEpoch: z.ZodNumber;
336
+ token: z.ZodString;
337
+ issuedAt: z.ZodISODateTime;
338
+ expiresAt: z.ZodISODateTime;
339
+ }, z.core.$strict>;
340
+ snapshot: z.ZodObject<{
341
+ id: z.ZodString;
342
+ app: z.ZodObject<{
343
+ id: z.ZodString;
344
+ name: z.ZodString;
345
+ bundleId: z.ZodNullable<z.ZodString>;
346
+ pid: z.ZodNumber;
347
+ isRunning: z.ZodBoolean;
348
+ }, z.core.$strict>;
349
+ window: z.ZodObject<{
350
+ id: z.ZodString;
351
+ appId: z.ZodString;
352
+ title: z.ZodString;
353
+ index: z.ZodNumber;
354
+ bounds: z.ZodObject<{
355
+ x: z.ZodNumber;
356
+ y: z.ZodNumber;
357
+ width: z.ZodNumber;
358
+ height: z.ZodNumber;
359
+ }, z.core.$strict>;
360
+ minimized: z.ZodBoolean;
361
+ }, z.core.$strict>;
362
+ treeText: z.ZodString;
363
+ elementCount: z.ZodNumber;
364
+ focusedElementRef: z.ZodNullable<z.ZodString>;
365
+ desktopEpoch: z.ZodNumber;
366
+ }, z.core.$strict>;
367
+ screenshot: z.ZodNullable<z.ZodObject<{
368
+ format: z.ZodLiteral<"png">;
369
+ width: z.ZodNumber;
370
+ height: z.ZodNumber;
371
+ scale: z.ZodNumber;
372
+ data: z.ZodOptional<z.ZodString>;
373
+ path: z.ZodOptional<z.ZodString>;
374
+ expiresAt: z.ZodOptional<z.ZodISODateTime>;
375
+ }, z.core.$strict>>;
376
+ issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
377
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable">>;
290
378
  message: z.ZodString;
291
379
  retry: z.ZodBoolean;
292
380
  remediation: z.ZodString;
293
381
  details: z.ZodOptional<z.ZodUnknown>;
294
382
  }, z.core.$strict>>>;
383
+ suggestion: z.ZodOptional<z.ZodObject<{
384
+ untrusted: z.ZodLiteral<true>;
385
+ snapshotId: z.ZodString;
386
+ move: z.ZodDiscriminatedUnion<[z.ZodObject<{
387
+ kind: z.ZodLiteral<"click">;
388
+ elementIndex: z.ZodNumber;
389
+ }, z.core.$strict>, z.ZodObject<{
390
+ kind: z.ZodLiteral<"setValue">;
391
+ elementIndex: z.ZodNumber;
392
+ }, z.core.$strict>, z.ZodObject<{
393
+ kind: z.ZodLiteral<"secondary">;
394
+ elementIndex: z.ZodNumber;
395
+ action: z.ZodString;
396
+ }, z.core.$strict>, z.ZodObject<{
397
+ kind: z.ZodLiteral<"scroll">;
398
+ elementIndex: z.ZodNumber;
399
+ direction: z.ZodEnum<{
400
+ up: "up";
401
+ down: "down";
402
+ left: "left";
403
+ right: "right";
404
+ }>;
405
+ }, z.core.$strict>, z.ZodObject<{
406
+ kind: z.ZodLiteral<"wait">;
407
+ }, z.core.$strict>, z.ZodObject<{
408
+ kind: z.ZodLiteral<"done">;
409
+ }, z.core.$strict>, z.ZodObject<{
410
+ kind: z.ZodLiteral<"blocked">;
411
+ reason: z.ZodString;
412
+ }, z.core.$strict>], "kind">;
413
+ confidence: z.ZodOptional<z.ZodNumber>;
414
+ label: z.ZodOptional<z.ZodString>;
415
+ }, z.core.$strict>>;
295
416
  }, z.core.$strict>;
296
417
  export declare const MutationResultSchema: z.ZodObject<{
297
418
  outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -303,31 +424,7 @@ export declare const MutationResultSchema: z.ZodObject<{
303
424
  }, z.core.$strict>, z.ZodObject<{
304
425
  state: z.ZodLiteral<"failed">;
305
426
  error: z.ZodOptional<z.ZodObject<{
306
- code: z.ZodEnum<{
307
- app_not_found: "app_not_found";
308
- app_unavailable: "app_unavailable";
309
- app_blocked: "app_blocked";
310
- window_not_found: "window_not_found";
311
- window_unavailable: "window_unavailable";
312
- window_not_focused: "window_not_focused";
313
- permission_denied: "permission_denied";
314
- stale_target: "stale_target";
315
- element_not_found: "element_not_found";
316
- element_not_clickable: "element_not_clickable";
317
- action_not_supported: "action_not_supported";
318
- value_not_settable: "value_not_settable";
319
- invalid_argument: "invalid_argument";
320
- timeout: "timeout";
321
- unsupported_capability: "unsupported_capability";
322
- provider_unavailable: "provider_unavailable";
323
- provider_crashed: "provider_crashed";
324
- version_incompatible: "version_incompatible";
325
- interaction_context_invalid: "interaction_context_invalid";
326
- interaction_context_expired: "interaction_context_expired";
327
- session_unavailable: "session_unavailable";
328
- screenshot_failed: "screenshot_failed";
329
- accessibility_error: "accessibility_error";
330
- }>;
427
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
331
428
  message: z.ZodString;
332
429
  retry: z.ZodBoolean;
333
430
  remediation: z.ZodString;
@@ -336,31 +433,7 @@ export declare const MutationResultSchema: z.ZodObject<{
336
433
  }, z.core.$strict>, z.ZodObject<{
337
434
  state: z.ZodLiteral<"not_attempted">;
338
435
  error: z.ZodOptional<z.ZodObject<{
339
- code: z.ZodEnum<{
340
- app_not_found: "app_not_found";
341
- app_unavailable: "app_unavailable";
342
- app_blocked: "app_blocked";
343
- window_not_found: "window_not_found";
344
- window_unavailable: "window_unavailable";
345
- window_not_focused: "window_not_focused";
346
- permission_denied: "permission_denied";
347
- stale_target: "stale_target";
348
- element_not_found: "element_not_found";
349
- element_not_clickable: "element_not_clickable";
350
- action_not_supported: "action_not_supported";
351
- value_not_settable: "value_not_settable";
352
- invalid_argument: "invalid_argument";
353
- timeout: "timeout";
354
- unsupported_capability: "unsupported_capability";
355
- provider_unavailable: "provider_unavailable";
356
- provider_crashed: "provider_crashed";
357
- version_incompatible: "version_incompatible";
358
- interaction_context_invalid: "interaction_context_invalid";
359
- interaction_context_expired: "interaction_context_expired";
360
- session_unavailable: "session_unavailable";
361
- screenshot_failed: "screenshot_failed";
362
- accessibility_error: "accessibility_error";
363
- }>;
436
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
364
437
  message: z.ZodString;
365
438
  retry: z.ZodBoolean;
366
439
  remediation: z.ZodString;
@@ -425,31 +498,7 @@ export declare const MutationResultSchema: z.ZodObject<{
425
498
  expiresAt: z.ZodOptional<z.ZodISODateTime>;
426
499
  }, z.core.$strict>>;
427
500
  issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
428
- code: z.ZodEnum<{
429
- app_not_found: "app_not_found";
430
- app_unavailable: "app_unavailable";
431
- app_blocked: "app_blocked";
432
- window_not_found: "window_not_found";
433
- window_unavailable: "window_unavailable";
434
- window_not_focused: "window_not_focused";
435
- permission_denied: "permission_denied";
436
- stale_target: "stale_target";
437
- element_not_found: "element_not_found";
438
- element_not_clickable: "element_not_clickable";
439
- action_not_supported: "action_not_supported";
440
- value_not_settable: "value_not_settable";
441
- invalid_argument: "invalid_argument";
442
- timeout: "timeout";
443
- unsupported_capability: "unsupported_capability";
444
- provider_unavailable: "provider_unavailable";
445
- provider_crashed: "provider_crashed";
446
- version_incompatible: "version_incompatible";
447
- interaction_context_invalid: "interaction_context_invalid";
448
- interaction_context_expired: "interaction_context_expired";
449
- session_unavailable: "session_unavailable";
450
- screenshot_failed: "screenshot_failed";
451
- accessibility_error: "accessibility_error";
452
- }>;
501
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
453
502
  message: z.ZodString;
454
503
  retry: z.ZodBoolean;
455
504
  remediation: z.ZodString;
@@ -457,6 +506,136 @@ export declare const MutationResultSchema: z.ZodObject<{
457
506
  }, z.core.$strict>>>;
458
507
  }, z.core.$strict>>;
459
508
  }, z.core.$strict>;
509
+ export type MutationResult = z.infer<typeof MutationResultSchema>;
510
+ export declare const PublicMutationResultSchema: z.ZodObject<{
511
+ outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
512
+ state: z.ZodLiteral<"verified">;
513
+ evidence: z.ZodOptional<z.ZodUnknown>;
514
+ }, z.core.$strict>, z.ZodObject<{
515
+ state: z.ZodLiteral<"indeterminate">;
516
+ reason: z.ZodOptional<z.ZodString>;
517
+ }, z.core.$strict>, z.ZodObject<{
518
+ state: z.ZodLiteral<"failed">;
519
+ error: z.ZodOptional<z.ZodObject<{
520
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable">>;
521
+ message: z.ZodString;
522
+ retry: z.ZodBoolean;
523
+ remediation: z.ZodString;
524
+ details: z.ZodOptional<z.ZodUnknown>;
525
+ }, z.core.$strict>>;
526
+ }, z.core.$strict>, z.ZodObject<{
527
+ state: z.ZodLiteral<"not_attempted">;
528
+ error: z.ZodOptional<z.ZodObject<{
529
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error" | "goal_mismatch" | "policy_unavailable" | "intent_unavailable">>;
530
+ message: z.ZodString;
531
+ retry: z.ZodBoolean;
532
+ remediation: z.ZodString;
533
+ details: z.ZodOptional<z.ZodUnknown>;
534
+ }, z.core.$strict>>;
535
+ }, z.core.$strict>], "state">;
536
+ freshState: z.ZodOptional<z.ZodObject<{
537
+ context: z.ZodObject<{
538
+ brokerGeneration: z.ZodString;
539
+ providerGeneration: z.ZodString;
540
+ graphicalSessionId: z.ZodString;
541
+ process: z.ZodObject<{
542
+ pid: z.ZodNumber;
543
+ startedAt: z.ZodISODateTime;
544
+ executableId: z.ZodString;
545
+ }, z.core.$strict>;
546
+ appId: z.ZodString;
547
+ window: z.ZodObject<{
548
+ id: z.ZodString;
549
+ ownerPid: z.ZodNumber;
550
+ }, z.core.$strict>;
551
+ snapshotId: z.ZodString;
552
+ desktopEpoch: z.ZodNumber;
553
+ token: z.ZodString;
554
+ issuedAt: z.ZodISODateTime;
555
+ expiresAt: z.ZodISODateTime;
556
+ }, z.core.$strict>;
557
+ snapshot: z.ZodObject<{
558
+ id: z.ZodString;
559
+ app: z.ZodObject<{
560
+ id: z.ZodString;
561
+ name: z.ZodString;
562
+ bundleId: z.ZodNullable<z.ZodString>;
563
+ pid: z.ZodNumber;
564
+ isRunning: z.ZodBoolean;
565
+ }, z.core.$strict>;
566
+ window: z.ZodObject<{
567
+ id: z.ZodString;
568
+ appId: z.ZodString;
569
+ title: z.ZodString;
570
+ index: z.ZodNumber;
571
+ bounds: z.ZodObject<{
572
+ x: z.ZodNumber;
573
+ y: z.ZodNumber;
574
+ width: z.ZodNumber;
575
+ height: z.ZodNumber;
576
+ }, z.core.$strict>;
577
+ minimized: z.ZodBoolean;
578
+ }, z.core.$strict>;
579
+ treeText: z.ZodString;
580
+ elementCount: z.ZodNumber;
581
+ focusedElementRef: z.ZodNullable<z.ZodString>;
582
+ desktopEpoch: z.ZodNumber;
583
+ }, z.core.$strict>;
584
+ screenshot: z.ZodNullable<z.ZodObject<{
585
+ format: z.ZodLiteral<"png">;
586
+ width: z.ZodNumber;
587
+ height: z.ZodNumber;
588
+ scale: z.ZodNumber;
589
+ data: z.ZodOptional<z.ZodString>;
590
+ path: z.ZodOptional<z.ZodString>;
591
+ expiresAt: z.ZodOptional<z.ZodISODateTime>;
592
+ }, z.core.$strict>>;
593
+ issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
594
+ code: z.ZodEnum<Record<"app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error", "app_not_found" | "app_unavailable" | "app_blocked" | "window_not_found" | "window_unavailable" | "window_not_focused" | "permission_denied" | "stale_target" | "element_not_found" | "element_not_clickable" | "action_not_supported" | "value_not_settable" | "invalid_argument" | "timeout" | "unsupported_capability" | "provider_unavailable" | "provider_crashed" | "version_incompatible" | "interaction_context_invalid" | "interaction_context_expired" | "session_unavailable" | "screenshot_failed" | "accessibility_error">>;
595
+ message: z.ZodString;
596
+ retry: z.ZodBoolean;
597
+ remediation: z.ZodString;
598
+ details: z.ZodOptional<z.ZodUnknown>;
599
+ }, z.core.$strict>>>;
600
+ }, z.core.$strict>>;
601
+ resolvedTarget: z.ZodOptional<z.ZodObject<{
602
+ kind: z.ZodLiteral<"element">;
603
+ elementIndex: z.ZodNumber;
604
+ }, z.core.$strict>>;
605
+ suggestion: z.ZodOptional<z.ZodObject<{
606
+ untrusted: z.ZodLiteral<true>;
607
+ snapshotId: z.ZodString;
608
+ move: z.ZodDiscriminatedUnion<[z.ZodObject<{
609
+ kind: z.ZodLiteral<"click">;
610
+ elementIndex: z.ZodNumber;
611
+ }, z.core.$strict>, z.ZodObject<{
612
+ kind: z.ZodLiteral<"setValue">;
613
+ elementIndex: z.ZodNumber;
614
+ }, z.core.$strict>, z.ZodObject<{
615
+ kind: z.ZodLiteral<"secondary">;
616
+ elementIndex: z.ZodNumber;
617
+ action: z.ZodString;
618
+ }, z.core.$strict>, z.ZodObject<{
619
+ kind: z.ZodLiteral<"scroll">;
620
+ elementIndex: z.ZodNumber;
621
+ direction: z.ZodEnum<{
622
+ up: "up";
623
+ down: "down";
624
+ left: "left";
625
+ right: "right";
626
+ }>;
627
+ }, z.core.$strict>, z.ZodObject<{
628
+ kind: z.ZodLiteral<"wait">;
629
+ }, z.core.$strict>, z.ZodObject<{
630
+ kind: z.ZodLiteral<"done">;
631
+ }, z.core.$strict>, z.ZodObject<{
632
+ kind: z.ZodLiteral<"blocked">;
633
+ reason: z.ZodString;
634
+ }, z.core.$strict>], "kind">;
635
+ confidence: z.ZodOptional<z.ZodNumber>;
636
+ label: z.ZodOptional<z.ZodString>;
637
+ }, z.core.$strict>>;
638
+ }, z.core.$strict>;
460
639
  export declare const ProviderSupportsSchema: z.ZodObject<{
461
640
  apps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
462
641
  windows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
package/dist/schemas.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAQvB,eAAO,MAAM,6BAA6B,aAA+C,CAAA;AAEzF,eAAO,MAAM,qBAAqB;;;;kBAMvB,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;kBAKtB,CAAA;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;kBAWzB,CAAA;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;kBAI1B,CAAA;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;kBAKvB,CAAA;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,aAAa;;;;;;kBAQf,CAAA;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;kBAgBlB,CAAA;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;kBAazB,CAAA;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUhB,CAAA;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAShC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOtB,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKtB,CAAA;AAIX,eAAO,MAAM,sBAAsB;;;;;;kBAQxB,CAAA;AAEX,eAAO,MAAM,4BAA4B;;;kBAK9B,CAAA;AAEX,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;kBAS5B,CAAA;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUzB,CAAA"}
1
+ {"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}