@spotpatch/shared 1.15.0 → 1.16.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 (40) hide show
  1. package/dist/{annotation-Cz-NNgR4.d.cts → annotation-eo_ltNRm.d.cts} +24 -1
  2. package/dist/{annotation-Cz-NNgR4.d.ts → annotation-eo_ltNRm.d.ts} +24 -1
  3. package/dist/{chunk-JTZFOTPT.js → chunk-7777QFBJ.js} +2 -2
  4. package/dist/{chunk-R3BQKCCY.js → chunk-D7R32NFF.js} +2 -2
  5. package/dist/{chunk-R6QJFNT2.js → chunk-FCY5V76A.js} +31 -1
  6. package/dist/chunk-FCY5V76A.js.map +1 -0
  7. package/dist/{contextual-ask-BbmHG3Z8.d.cts → contextual-ask-Dz3Mh9LR.d.cts} +105 -0
  8. package/dist/{contextual-ask-BbmHG3Z8.d.ts → contextual-ask-Dz3Mh9LR.d.ts} +105 -0
  9. package/dist/contextual-ask-browser.d.cts +1 -1
  10. package/dist/contextual-ask-browser.d.ts +1 -1
  11. package/dist/contextual-ask-node.cjs +24 -0
  12. package/dist/contextual-ask-node.cjs.map +1 -1
  13. package/dist/contextual-ask-node.d.cts +3 -3
  14. package/dist/contextual-ask-node.d.ts +3 -3
  15. package/dist/contextual-ask-node.js +2 -2
  16. package/dist/data-flow-runtime.d.cts +1 -1
  17. package/dist/data-flow-runtime.d.ts +1 -1
  18. package/dist/external-agent-node.cjs +26 -0
  19. package/dist/external-agent-node.cjs.map +1 -1
  20. package/dist/external-agent-node.d.cts +66 -36
  21. package/dist/external-agent-node.d.ts +66 -36
  22. package/dist/external-agent-node.js +2 -2
  23. package/dist/{external-handoff-BpoxbpPk.d.ts → external-handoff-BaPiKnYG.d.ts} +68 -38
  24. package/dist/{external-handoff-D1Ua2jIA.d.cts → external-handoff-ByHmcwWv.d.cts} +68 -38
  25. package/dist/external-handoff-browser.d.cts +3 -3
  26. package/dist/external-handoff-browser.d.ts +3 -3
  27. package/dist/index.cjs +34 -0
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +76 -31
  30. package/dist/index.d.ts +76 -31
  31. package/dist/index.js +11 -3
  32. package/dist/index.js.map +1 -1
  33. package/package.json +1 -1
  34. package/dist/chunk-R6QJFNT2.js.map +0 -1
  35. package/dist/{chunk-JTZFOTPT.js.map → chunk-7777QFBJ.js.map} +0 -0
  36. package/dist/{chunk-R3BQKCCY.js.map → chunk-D7R32NFF.js.map} +0 -0
  37. package/dist/{data-flow-runtime-tyqGH1OS.d.ts → data-flow-runtime-DhWpQoik.d.ts} +8 -8
  38. package/dist/{data-flow-runtime-Bfm5LbHE.d.cts → data-flow-runtime-w43iwvGA.d.cts} +8 -8
  39. package/dist/{external-agent-control-yC4ToQXg.d.cts → external-agent-control-DKxQACUv.d.cts} +28 -28
  40. package/dist/{external-agent-control-yC4ToQXg.d.ts → external-agent-control-DKxQACUv.d.ts} +28 -28
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { S as SpotAnnotation } from './annotation-Cz-NNgR4.cjs';
2
+ import { S as SpotAnnotation } from './annotation-eo_ltNRm.cjs';
3
3
 
4
4
  declare const EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION: 1;
5
5
  declare const EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION: 2;
@@ -44,19 +44,19 @@ type ExternalHandoffDispatchPhase = (typeof EXTERNAL_HANDOFF_DISPATCH_PHASES)[nu
44
44
  type ExternalHandoffReportableDispatchPhase = (typeof EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES)[number];
45
45
 
46
46
  declare const externalHandoffReportableDispatchPhaseSchema: z.ZodEnum<{
47
- dispatching: "dispatching";
47
+ failed: "failed";
48
48
  dispatched: "dispatched";
49
- working: "working";
50
49
  completed: "completed";
51
- failed: "failed";
50
+ dispatching: "dispatching";
51
+ working: "working";
52
52
  "delivery-unknown": "delivery-unknown";
53
53
  }>;
54
54
  declare const externalHandoffSummarySchema: z.ZodObject<{
55
55
  sessionId: z.ZodString;
56
56
  framework: z.ZodEnum<{
57
+ astro: "astro";
57
58
  vite: "vite";
58
59
  next: "next";
59
- astro: "astro";
60
60
  }>;
61
61
  revision: z.ZodNumber;
62
62
  cursor: z.ZodString;
@@ -68,8 +68,8 @@ declare const externalHandoffSummarySchema: z.ZodObject<{
68
68
  publishedAt: z.ZodISODateTime;
69
69
  expiresAt: z.ZodISODateTime;
70
70
  state: z.ZodEnum<{
71
- available: "available";
72
71
  expired: "expired";
72
+ available: "available";
73
73
  superseded: "superseded";
74
74
  }>;
75
75
  pickupCount: z.ZodNumber;
@@ -81,9 +81,9 @@ declare const externalHandoffSnapshotSchema: z.ZodObject<{
81
81
  session: z.ZodObject<{
82
82
  id: z.ZodString;
83
83
  framework: z.ZodEnum<{
84
+ astro: "astro";
84
85
  vite: "vite";
85
86
  next: "next";
86
- astro: "astro";
87
87
  }>;
88
88
  }, z.core.$strict>;
89
89
  revision: z.ZodNumber;
@@ -161,6 +161,21 @@ declare const externalHandoffSnapshotSchema: z.ZodObject<{
161
161
  }, z.core.$strict>>;
162
162
  }, z.core.$strict>;
163
163
  element: z.ZodObject<{
164
+ instance: z.ZodOptional<z.ZodObject<{
165
+ id: z.ZodString;
166
+ state: z.ZodEnum<{
167
+ captured: "captured";
168
+ changed: "changed";
169
+ detached: "detached";
170
+ restored: "restored";
171
+ }>;
172
+ selectorStatus: z.ZodEnum<{
173
+ "unique-at-capture": "unique-at-capture";
174
+ unavailable: "unavailable";
175
+ }>;
176
+ label: z.ZodString;
177
+ context: z.ZodString;
178
+ }, z.core.$strict>>;
164
179
  tagName: z.ZodString;
165
180
  selector: z.ZodString;
166
181
  sanitizedHtml: z.ZodString;
@@ -188,9 +203,9 @@ declare const externalHandoffSnapshotSchema: z.ZodObject<{
188
203
  code: z.ZodOptional<z.ZodObject<{
189
204
  relativePath: z.ZodString;
190
205
  language: z.ZodEnum<{
191
- astro: "astro";
192
206
  tsx: "tsx";
193
207
  jsx: "jsx";
208
+ astro: "astro";
194
209
  }>;
195
210
  startLine: z.ZodNumber;
196
211
  endLine: z.ZodNumber;
@@ -212,8 +227,8 @@ declare const activeAdapterSummarySchema: z.ZodObject<{
212
227
  }>;
213
228
  state: z.ZodEnum<{
214
229
  ready: "ready";
215
- busy: "busy";
216
230
  blocked: "blocked";
231
+ busy: "busy";
217
232
  }>;
218
233
  canDispatch: z.ZodBoolean;
219
234
  connectedAt: z.ZodISODateTime;
@@ -226,13 +241,13 @@ declare const dispatchSummarySchema: z.ZodObject<{
226
241
  }>;
227
242
  revision: z.ZodNumber;
228
243
  phase: z.ZodEnum<{
229
- dispatching: "dispatching";
244
+ queued: "queued";
245
+ failed: "failed";
230
246
  dispatched: "dispatched";
231
- working: "working";
232
247
  completed: "completed";
233
- failed: "failed";
248
+ dispatching: "dispatching";
249
+ working: "working";
234
250
  "delivery-unknown": "delivery-unknown";
235
- queued: "queued";
236
251
  }>;
237
252
  updatedAt: z.ZodISODateTime;
238
253
  }, z.core.$strict>;
@@ -311,6 +326,21 @@ declare const externalHandoffPublishRequestSchema: z.ZodObject<{
311
326
  }, z.core.$strict>>;
312
327
  }, z.core.$strict>;
313
328
  element: z.ZodObject<{
329
+ instance: z.ZodOptional<z.ZodObject<{
330
+ id: z.ZodString;
331
+ state: z.ZodEnum<{
332
+ captured: "captured";
333
+ changed: "changed";
334
+ detached: "detached";
335
+ restored: "restored";
336
+ }>;
337
+ selectorStatus: z.ZodEnum<{
338
+ "unique-at-capture": "unique-at-capture";
339
+ unavailable: "unavailable";
340
+ }>;
341
+ label: z.ZodString;
342
+ context: z.ZodString;
343
+ }, z.core.$strict>>;
314
344
  tagName: z.ZodString;
315
345
  selector: z.ZodString;
316
346
  sanitizedHtml: z.ZodString;
@@ -338,9 +368,9 @@ declare const externalHandoffPublishRequestSchema: z.ZodObject<{
338
368
  code: z.ZodOptional<z.ZodObject<{
339
369
  relativePath: z.ZodString;
340
370
  language: z.ZodEnum<{
341
- astro: "astro";
342
371
  tsx: "tsx";
343
372
  jsx: "jsx";
373
+ astro: "astro";
344
374
  }>;
345
375
  startLine: z.ZodNumber;
346
376
  endLine: z.ZodNumber;
@@ -375,8 +405,8 @@ declare const externalHandoffCapabilitySchema: z.ZodObject<{
375
405
  }>;
376
406
  state: z.ZodEnum<{
377
407
  ready: "ready";
378
- busy: "busy";
379
408
  blocked: "blocked";
409
+ busy: "busy";
380
410
  }>;
381
411
  canDispatch: z.ZodBoolean;
382
412
  connectedAt: z.ZodISODateTime;
@@ -389,13 +419,13 @@ declare const externalHandoffCapabilitySchema: z.ZodObject<{
389
419
  }>;
390
420
  revision: z.ZodNumber;
391
421
  phase: z.ZodEnum<{
392
- dispatching: "dispatching";
422
+ queued: "queued";
423
+ failed: "failed";
393
424
  dispatched: "dispatched";
394
- working: "working";
395
425
  completed: "completed";
396
- failed: "failed";
426
+ dispatching: "dispatching";
427
+ working: "working";
397
428
  "delivery-unknown": "delivery-unknown";
398
- queued: "queued";
399
429
  }>;
400
430
  updatedAt: z.ZodISODateTime;
401
431
  }, z.core.$strict>>;
@@ -411,8 +441,8 @@ declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.Z
411
441
  }>;
412
442
  state: z.ZodEnum<{
413
443
  ready: "ready";
414
- busy: "busy";
415
444
  blocked: "blocked";
445
+ busy: "busy";
416
446
  }>;
417
447
  canDispatch: z.ZodBoolean;
418
448
  connectedAt: z.ZodISODateTime;
@@ -425,13 +455,13 @@ declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.Z
425
455
  }>;
426
456
  revision: z.ZodNumber;
427
457
  phase: z.ZodEnum<{
428
- dispatching: "dispatching";
458
+ queued: "queued";
459
+ failed: "failed";
429
460
  dispatched: "dispatched";
430
- working: "working";
431
461
  completed: "completed";
432
- failed: "failed";
462
+ dispatching: "dispatching";
463
+ working: "working";
433
464
  "delivery-unknown": "delivery-unknown";
434
- queued: "queued";
435
465
  }>;
436
466
  updatedAt: z.ZodISODateTime;
437
467
  }, z.core.$strict>;
@@ -440,9 +470,9 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
440
470
  handoff: z.ZodObject<{
441
471
  sessionId: z.ZodString;
442
472
  framework: z.ZodEnum<{
473
+ astro: "astro";
443
474
  vite: "vite";
444
475
  next: "next";
445
- astro: "astro";
446
476
  }>;
447
477
  revision: z.ZodNumber;
448
478
  cursor: z.ZodString;
@@ -454,8 +484,8 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
454
484
  publishedAt: z.ZodISODateTime;
455
485
  expiresAt: z.ZodISODateTime;
456
486
  state: z.ZodEnum<{
457
- available: "available";
458
487
  expired: "expired";
488
+ available: "available";
459
489
  superseded: "superseded";
460
490
  }>;
461
491
  pickupCount: z.ZodNumber;
@@ -472,8 +502,8 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
472
502
  }>;
473
503
  state: z.ZodEnum<{
474
504
  ready: "ready";
475
- busy: "busy";
476
505
  blocked: "blocked";
506
+ busy: "busy";
477
507
  }>;
478
508
  canDispatch: z.ZodBoolean;
479
509
  connectedAt: z.ZodISODateTime;
@@ -486,13 +516,13 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
486
516
  }>;
487
517
  revision: z.ZodNumber;
488
518
  phase: z.ZodEnum<{
489
- dispatching: "dispatching";
519
+ queued: "queued";
520
+ failed: "failed";
490
521
  dispatched: "dispatched";
491
- working: "working";
492
522
  completed: "completed";
493
- failed: "failed";
523
+ dispatching: "dispatching";
524
+ working: "working";
494
525
  "delivery-unknown": "delivery-unknown";
495
- queued: "queued";
496
526
  }>;
497
527
  updatedAt: z.ZodISODateTime;
498
528
  }, z.core.$strict>;
@@ -503,9 +533,9 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
503
533
  handoff: z.ZodObject<{
504
534
  sessionId: z.ZodString;
505
535
  framework: z.ZodEnum<{
536
+ astro: "astro";
506
537
  vite: "vite";
507
538
  next: "next";
508
- astro: "astro";
509
539
  }>;
510
540
  revision: z.ZodNumber;
511
541
  cursor: z.ZodString;
@@ -517,8 +547,8 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
517
547
  publishedAt: z.ZodISODateTime;
518
548
  expiresAt: z.ZodISODateTime;
519
549
  state: z.ZodEnum<{
520
- available: "available";
521
550
  expired: "expired";
551
+ available: "available";
522
552
  superseded: "superseded";
523
553
  }>;
524
554
  pickupCount: z.ZodNumber;
@@ -531,8 +561,8 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
531
561
  }>;
532
562
  state: z.ZodEnum<{
533
563
  ready: "ready";
534
- busy: "busy";
535
564
  blocked: "blocked";
565
+ busy: "busy";
536
566
  }>;
537
567
  canDispatch: z.ZodBoolean;
538
568
  connectedAt: z.ZodISODateTime;
@@ -545,13 +575,13 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
545
575
  }>;
546
576
  revision: z.ZodNumber;
547
577
  phase: z.ZodEnum<{
548
- dispatching: "dispatching";
578
+ queued: "queued";
579
+ failed: "failed";
549
580
  dispatched: "dispatched";
550
- working: "working";
551
581
  completed: "completed";
552
- failed: "failed";
582
+ dispatching: "dispatching";
583
+ working: "working";
553
584
  "delivery-unknown": "delivery-unknown";
554
- queued: "queued";
555
585
  }>;
556
586
  updatedAt: z.ZodISODateTime;
557
587
  }, z.core.$strict>>;
@@ -1,7 +1,7 @@
1
- export { A as ActiveAdapterSummary, D as DispatchSummary, b as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS, c as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES, d as EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION, e as EXTERNAL_HANDOFF_DISPATCH_PHASES, f as EXTERNAL_HANDOFF_FRAMEWORKS, g as EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES, h as EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION, i as EXTERNAL_HANDOFF_STATES, j as ExternalHandoffActiveAdapterKind, k as ExternalHandoffActiveAdapterState, l as ExternalHandoffCapability, m as ExternalHandoffDispatchPhase, n as ExternalHandoffFramework, o as ExternalHandoffPublishDelivery, p as ExternalHandoffPublishRequest, q as ExternalHandoffPublishResult, r as ExternalHandoffReportableDispatchPhase, s as ExternalHandoffResolveDeliveryRequest, a as ExternalHandoffSnapshot, t as ExternalHandoffState, u as ExternalHandoffStatusRequest, v as ExternalHandoffStatusResult, w as ExternalHandoffSummary } from './external-handoff-D1Ua2jIA.cjs';
1
+ export { A as ActiveAdapterSummary, D as DispatchSummary, b as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS, c as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES, d as EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION, e as EXTERNAL_HANDOFF_DISPATCH_PHASES, f as EXTERNAL_HANDOFF_FRAMEWORKS, g as EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES, h as EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION, i as EXTERNAL_HANDOFF_STATES, j as ExternalHandoffActiveAdapterKind, k as ExternalHandoffActiveAdapterState, l as ExternalHandoffCapability, m as ExternalHandoffDispatchPhase, n as ExternalHandoffFramework, o as ExternalHandoffPublishDelivery, p as ExternalHandoffPublishRequest, q as ExternalHandoffPublishResult, r as ExternalHandoffReportableDispatchPhase, s as ExternalHandoffResolveDeliveryRequest, a as ExternalHandoffSnapshot, t as ExternalHandoffState, u as ExternalHandoffStatusRequest, v as ExternalHandoffStatusResult, w as ExternalHandoffSummary } from './external-handoff-ByHmcwWv.cjs';
2
2
  export { S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER } from './endpoints-O3ohYyAo.cjs';
3
- export { E as ExternalAgentAction, a as ExternalAgentConnectionState, b as ExternalAgentControlCancelRequest, c as ExternalAgentControlConnectRequest, d as ExternalAgentControlDisconnectRequest, e as ExternalAgentControlStatus, f as ExternalAgentErrorCode, g as ExternalAgentEvent, h as ExternalAgentEventsRequest, i as ExternalAgentManagedResult, j as ExternalAgentResultRequest } from './external-agent-control-yC4ToQXg.cjs';
4
- export { S as SpotAnnotation, a as SpotPatchLocale } from './annotation-Cz-NNgR4.cjs';
3
+ export { E as ExternalAgentAction, a as ExternalAgentConnectionState, b as ExternalAgentControlCancelRequest, c as ExternalAgentControlConnectRequest, d as ExternalAgentControlDisconnectRequest, e as ExternalAgentControlStatus, f as ExternalAgentErrorCode, g as ExternalAgentEvent, h as ExternalAgentEventsRequest, i as ExternalAgentManagedResult, j as ExternalAgentResultRequest } from './external-agent-control-DKxQACUv.cjs';
4
+ export { S as SpotAnnotation, a as SpotPatchLocale } from './annotation-eo_ltNRm.cjs';
5
5
  import 'zod';
6
6
 
7
7
  /** Browser-reachable errors only; keeps unrelated Agent/worktree codes out of the lazy UI. */
@@ -1,7 +1,7 @@
1
- export { A as ActiveAdapterSummary, D as DispatchSummary, b as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS, c as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES, d as EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION, e as EXTERNAL_HANDOFF_DISPATCH_PHASES, f as EXTERNAL_HANDOFF_FRAMEWORKS, g as EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES, h as EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION, i as EXTERNAL_HANDOFF_STATES, j as ExternalHandoffActiveAdapterKind, k as ExternalHandoffActiveAdapterState, l as ExternalHandoffCapability, m as ExternalHandoffDispatchPhase, n as ExternalHandoffFramework, o as ExternalHandoffPublishDelivery, p as ExternalHandoffPublishRequest, q as ExternalHandoffPublishResult, r as ExternalHandoffReportableDispatchPhase, s as ExternalHandoffResolveDeliveryRequest, a as ExternalHandoffSnapshot, t as ExternalHandoffState, u as ExternalHandoffStatusRequest, v as ExternalHandoffStatusResult, w as ExternalHandoffSummary } from './external-handoff-BpoxbpPk.js';
1
+ export { A as ActiveAdapterSummary, D as DispatchSummary, b as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS, c as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES, d as EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION, e as EXTERNAL_HANDOFF_DISPATCH_PHASES, f as EXTERNAL_HANDOFF_FRAMEWORKS, g as EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES, h as EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION, i as EXTERNAL_HANDOFF_STATES, j as ExternalHandoffActiveAdapterKind, k as ExternalHandoffActiveAdapterState, l as ExternalHandoffCapability, m as ExternalHandoffDispatchPhase, n as ExternalHandoffFramework, o as ExternalHandoffPublishDelivery, p as ExternalHandoffPublishRequest, q as ExternalHandoffPublishResult, r as ExternalHandoffReportableDispatchPhase, s as ExternalHandoffResolveDeliveryRequest, a as ExternalHandoffSnapshot, t as ExternalHandoffState, u as ExternalHandoffStatusRequest, v as ExternalHandoffStatusResult, w as ExternalHandoffSummary } from './external-handoff-BaPiKnYG.js';
2
2
  export { S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER } from './endpoints-O3ohYyAo.js';
3
- export { E as ExternalAgentAction, a as ExternalAgentConnectionState, b as ExternalAgentControlCancelRequest, c as ExternalAgentControlConnectRequest, d as ExternalAgentControlDisconnectRequest, e as ExternalAgentControlStatus, f as ExternalAgentErrorCode, g as ExternalAgentEvent, h as ExternalAgentEventsRequest, i as ExternalAgentManagedResult, j as ExternalAgentResultRequest } from './external-agent-control-yC4ToQXg.js';
4
- export { S as SpotAnnotation, a as SpotPatchLocale } from './annotation-Cz-NNgR4.js';
3
+ export { E as ExternalAgentAction, a as ExternalAgentConnectionState, b as ExternalAgentControlCancelRequest, c as ExternalAgentControlConnectRequest, d as ExternalAgentControlDisconnectRequest, e as ExternalAgentControlStatus, f as ExternalAgentErrorCode, g as ExternalAgentEvent, h as ExternalAgentEventsRequest, i as ExternalAgentManagedResult, j as ExternalAgentResultRequest } from './external-agent-control-DKxQACUv.js';
4
+ export { S as SpotAnnotation, a as SpotPatchLocale } from './annotation-eo_ltNRm.js';
5
5
  import 'zod';
6
6
 
7
7
  /** Browser-reachable errors only; keeps unrelated Agent/worktree codes out of the lazy UI. */
package/dist/index.cjs CHANGED
@@ -55,6 +55,9 @@ __export(index_exports, {
55
55
  DEFAULT_AGENT_LIMITS: () => DEFAULT_AGENT_LIMITS,
56
56
  DEFAULT_DATA_FLOW_LIMITS: () => DEFAULT_DATA_FLOW_LIMITS,
57
57
  DEFAULT_RUNTIME_DATA_FLOW_LIMITS: () => DEFAULT_RUNTIME_DATA_FLOW_LIMITS,
58
+ ELEMENT_INSTANCE_HINT_ATTRIBUTE: () => ELEMENT_INSTANCE_HINT_ATTRIBUTE,
59
+ ELEMENT_INSTANCE_LIMITS: () => ELEMENT_INSTANCE_LIMITS,
60
+ ELEMENT_INSTANCE_STATES: () => ELEMENT_INSTANCE_STATES,
58
61
  ERROR_CODES: () => ERROR_CODES,
59
62
  ERROR_CODE_VALUES: () => ERROR_CODE_VALUES,
60
63
  EXTERNAL_AGENT_ACTIONS: () => EXTERNAL_AGENT_ACTIONS,
@@ -82,6 +85,7 @@ __export(index_exports, {
82
85
  EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES: () => EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES,
83
86
  EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION: () => EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION,
84
87
  EXTERNAL_HANDOFF_STATES: () => EXTERNAL_HANDOFF_STATES,
88
+ INSTANCE_SELECTION_INSTRUCTIONS: () => INSTANCE_SELECTION_INSTRUCTIONS,
85
89
  MAX_ANNOTATION_INSTRUCTION_CHARACTERS: () => MAX_ANNOTATION_INSTRUCTION_CHARACTERS,
86
90
  MAX_ANNOTATION_TARGETS: () => MAX_ANNOTATION_TARGETS,
87
91
  MAX_TARGET_INSTRUCTION_CHARACTERS: () => MAX_TARGET_INSTRUCTION_CHARACTERS,
@@ -353,6 +357,24 @@ var SPOTPATCH_LOCALE_PREFERENCES = Object.freeze([
353
357
  ...SPOTPATCH_LOCALES
354
358
  ]);
355
359
 
360
+ // src/model/element-instance.ts
361
+ var ELEMENT_INSTANCE_LIMITS = Object.freeze({
362
+ idCharacters: 128,
363
+ contextCharacters: 1200,
364
+ labelCharacters: 160,
365
+ selectorCharacters: 2048,
366
+ ancestorDepth: 8,
367
+ locatorDepth: 32
368
+ });
369
+ var ELEMENT_INSTANCE_STATES = [
370
+ "captured",
371
+ "changed",
372
+ "detached",
373
+ "restored"
374
+ ];
375
+ var ELEMENT_INSTANCE_HINT_ATTRIBUTE = "data-spotpatch-instance";
376
+ var INSTANCE_SELECTION_INSTRUCTIONS = "Selected targets can be different rendered instances of the same source. Preserve each target and its instruction even when source locations match. Instance IDs identify captures, not business records. Selectors are capture-time evidence, never stable record IDs. Nearby DOM context is not a proven component boundary. Changed, detached, or restored instances are historical snapshots; verify their identity before changing code. Follow the requested scope: a selected instance does not by itself authorize changes to every instance or imply instance-only changes. For an instance-only request, establish the corresponding record/condition and check the shared component's impact; if evidence is insufficient, explain what is missing rather than guessing.";
377
+
356
378
  // src/model/contextual-ask.ts
357
379
  var import_zod2 = require("zod");
358
380
 
@@ -436,6 +458,13 @@ var CONTEXTUAL_ASK_PERMISSION_PROFILE = "spotpatch-ask-readonly";
436
458
  // src/model/context-schema.ts
437
459
  var import_zod = require("zod");
438
460
  var boundedString = (maximum) => import_zod.z.string().max(maximum);
461
+ var elementInstanceContextSchema = import_zod.z.strictObject({
462
+ id: import_zod.z.string().min(1).max(ELEMENT_INSTANCE_LIMITS.idCharacters).regex(/^[A-Za-z0-9_-]+$/u),
463
+ state: import_zod.z.enum(ELEMENT_INSTANCE_STATES),
464
+ selectorStatus: import_zod.z.enum(["unique-at-capture", "unavailable"]),
465
+ label: boundedString(ELEMENT_INSTANCE_LIMITS.labelCharacters),
466
+ context: boundedString(ELEMENT_INSTANCE_LIMITS.contextCharacters)
467
+ });
439
468
  var sourceRefSchema = import_zod.z.strictObject({
440
469
  fileId: boundedString(128).optional(),
441
470
  relativePath: boundedString(1024).optional(),
@@ -480,6 +509,7 @@ var spotTargetContextSchema = import_zod.z.strictObject({
480
509
  source: sourceRefSchema.optional()
481
510
  }),
482
511
  element: import_zod.z.strictObject({
512
+ instance: elementInstanceContextSchema.optional(),
483
513
  tagName: boundedString(128),
484
514
  selector: boundedString(2048),
485
515
  sanitizedHtml: boundedString(8192),
@@ -2404,6 +2434,9 @@ var SPOTPATCH_REPOSITORY_URL = "https://github.com/huanglvjing/spotpatch";
2404
2434
  DEFAULT_AGENT_LIMITS,
2405
2435
  DEFAULT_DATA_FLOW_LIMITS,
2406
2436
  DEFAULT_RUNTIME_DATA_FLOW_LIMITS,
2437
+ ELEMENT_INSTANCE_HINT_ATTRIBUTE,
2438
+ ELEMENT_INSTANCE_LIMITS,
2439
+ ELEMENT_INSTANCE_STATES,
2407
2440
  ERROR_CODES,
2408
2441
  ERROR_CODE_VALUES,
2409
2442
  EXTERNAL_AGENT_ACTIONS,
@@ -2431,6 +2464,7 @@ var SPOTPATCH_REPOSITORY_URL = "https://github.com/huanglvjing/spotpatch";
2431
2464
  EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES,
2432
2465
  EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION,
2433
2466
  EXTERNAL_HANDOFF_STATES,
2467
+ INSTANCE_SELECTION_INSTRUCTIONS,
2434
2468
  MAX_ANNOTATION_INSTRUCTION_CHARACTERS,
2435
2469
  MAX_ANNOTATION_TARGETS,
2436
2470
  MAX_TARGET_INSTRUCTION_CHARACTERS,