@peasant-labs/schema 0.54.0 → 0.57.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.
@@ -1,7 +1,9 @@
1
+ // Code generated from the canonical Go/OpenAPI contract. DO NOT EDIT.
1
2
  // publication-contract-semantic-refinement
2
3
  import { collectiveContractIssue } from "../../../collective-validation.js";
3
4
  // This file is auto-generated by @hey-api/openapi-ts
4
5
  import * as z from 'zod';
6
+ const closedSet = () => (schema) => schema;
5
7
  export const zActivityEdge = z.object({
6
8
  from: z.string(),
7
9
  taskCount: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
@@ -12,33 +14,33 @@ export const zActivityEdge = z.object({
12
14
  *
13
15
  * Closed session graph value
14
16
  */
15
- export const zActorOrigin = z.enum([
17
+ export const zActorOrigin = closedSet()(z.enum([
16
18
  'operator',
17
19
  'agent_delegate',
18
20
  'harness',
19
21
  'unknown'
20
- ]);
22
+ ]));
21
23
  /**
22
24
  * Annotation Axis
23
25
  *
24
26
  * Subscription dimension for annotation channels
25
27
  */
26
- export const zAnnotationAxis = z.enum([
28
+ export const zAnnotationAxis = closedSet()(z.enum([
27
29
  'type',
28
30
  'session',
29
31
  'project'
30
- ]);
32
+ ]));
31
33
  /**
32
34
  * Annotation Datatype
33
35
  *
34
36
  * Storage type for annotation values (maps to SQLite STRICT column type)
35
37
  */
36
- export const zAnnotationDatatype = z.enum([
38
+ export const zAnnotationDatatype = closedSet()(z.enum([
37
39
  'text',
38
40
  'integer',
39
41
  'real',
40
42
  'boolean'
41
- ]);
43
+ ]));
42
44
  export const zAnnotationEntryTarget = z.object({
43
45
  endIndex: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
44
46
  entryIndex: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
@@ -58,12 +60,12 @@ export const zAnnotationManifestResponse = z.object({
58
60
  *
59
61
  * Per-item annotation push outcome
60
62
  */
61
- export const zAnnotationPushStatus = z.enum([
63
+ export const zAnnotationPushStatus = closedSet()(z.enum([
62
64
  'created',
63
65
  'updated',
64
66
  'skipped',
65
67
  'error'
66
- ]);
68
+ ]));
67
69
  export const zAnnotationPushResult = z.object({
68
70
  contentHash: z.string().optional(),
69
71
  error: z.string().optional(),
@@ -81,22 +83,22 @@ export const zAnnotationPushResponse = z.object({
81
83
  *
82
84
  * ISO 11179 lifecycle state of an annotation type
83
85
  */
84
- export const zAnnotationStatus = z.enum([
86
+ export const zAnnotationStatus = closedSet()(z.enum([
85
87
  'proposed',
86
88
  'active',
87
89
  'deprecated',
88
90
  'retired'
89
- ]);
91
+ ]));
90
92
  /**
91
93
  * Annotator Kind
92
94
  *
93
95
  * Type of entity that produced an annotation: human, agent (AI model), or rule (automated classifier)
94
96
  */
95
- export const zAnnotatorKind = z.enum([
97
+ export const zAnnotatorKind = closedSet()(z.enum([
96
98
  'human',
97
99
  'agent',
98
100
  'rule'
99
- ]);
101
+ ]));
100
102
  export const zAnnotatorSummary = z.object({
101
103
  description: z.string().optional(),
102
104
  displayName: z.string(),
@@ -112,18 +114,18 @@ export const zAnnotatorSummary = z.object({
112
114
  *
113
115
  * Producer-supplied conclusion for a session-to-commit association: confirmed or candidate
114
116
  */
115
- export const zAssociationConclusion = z.enum(['confirmed', 'candidate']);
117
+ export const zAssociationConclusion = closedSet()(z.enum(['confirmed', 'candidate']));
116
118
  /**
117
119
  * Association Evidence Kind
118
120
  *
119
121
  * Atomic observation supporting a session-to-commit association
120
122
  */
121
- export const zAssociationEvidenceKind = z.enum([
123
+ export const zAssociationEvidenceKind = closedSet()(z.enum([
122
124
  'recorded_commit',
123
125
  'touched_file',
124
126
  'branch_membership',
125
127
  'time_window'
126
- ]);
128
+ ]));
127
129
  export const zAssociationEvidenceObservation = z.object({
128
130
  branchName: z.string().nullish(),
129
131
  kind: zAssociationEvidenceKind,
@@ -244,7 +246,7 @@ export const zAuthoritativeTimestampInfo = z.object({
244
246
  *
245
247
  * Git hook that publishes an auto-publish rule's sessions
246
248
  */
247
- export const zAutoPublishEvent = z.enum(['pre-push', 'post-commit']);
249
+ export const zAutoPublishEvent = closedSet()(z.enum(['pre-push', 'post-commit']));
248
250
  export const zAutoPublishHookRemedy = z.object({
249
251
  message: z.string().min(1),
250
252
  snippet: z.string().optional()
@@ -254,12 +256,12 @@ export const zAutoPublishHookRemedy = z.object({
254
256
  *
255
257
  * State of one repository's auto-publish hook for one event
256
258
  */
257
- export const zAutoPublishHookStatus = z.enum([
259
+ export const zAutoPublishHookStatus = closedSet()(z.enum([
258
260
  'absent',
259
261
  'installed',
260
262
  'blocked',
261
263
  'failed'
262
- ]);
264
+ ]));
263
265
  export const zAutoPublishHook = z.object({
264
266
  event: zAutoPublishEvent,
265
267
  remedy: zAutoPublishHookRemedy.optional(),
@@ -282,7 +284,7 @@ export const zAutoPublishRemovalResponse = z.object({
282
284
  *
283
285
  * What an auto-publish rule's match pattern names
284
286
  */
285
- export const zAutoPublishRuleKind = z.enum(['folder', 'remote']);
287
+ export const zAutoPublishRuleKind = closedSet()(z.enum(['folder', 'remote']));
286
288
  export const zBatchCreateAnnotationsErrorResponse = z.object({
287
289
  error: z.string(),
288
290
  failingIndex: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808)
@@ -295,7 +297,7 @@ export const zBatchCreateAnnotationsResponse = z.object({
295
297
  *
296
298
  * Claude Code built-in slash command name without the leading slash
297
299
  */
298
- export const zBuiltinCommand = z.enum([
300
+ export const zBuiltinCommand = closedSet()(z.enum([
299
301
  'exit',
300
302
  'compact',
301
303
  'clear',
@@ -322,7 +324,7 @@ export const zBuiltinCommand = z.enum([
322
324
  'privacy-settings',
323
325
  'help',
324
326
  'commands'
325
- ]);
327
+ ]));
326
328
  export const zCLILoginQuery = z.object({
327
329
  port: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
328
330
  state: z.string()
@@ -339,7 +341,7 @@ export const zCanonicalPublishGitContext = z.object({
339
341
  *
340
342
  * Strength of the evidence connecting a recorded session to a code change
341
343
  */
342
- export const zChangeBinding = z.enum(['bound', 'candidate']);
344
+ export const zChangeBinding = closedSet()(z.enum(['bound', 'candidate']));
343
345
  export const zChangeSummary = z.object({
344
346
  aheadCount: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
345
347
  baseHash: z.string().optional(),
@@ -363,7 +365,7 @@ export const zChangeSummary = z.object({
363
365
  *
364
366
  * Subscribable WebSocket data stream
365
367
  */
366
- export const zChannelTopic = z.enum([
368
+ export const zChannelTopic = closedSet()(z.enum([
367
369
  'dashboard',
368
370
  'sessions',
369
371
  'session_detail',
@@ -372,7 +374,7 @@ export const zChannelTopic = z.enum([
372
374
  'annotations',
373
375
  'project_familiarity',
374
376
  'kickstart'
375
- ]);
377
+ ]));
376
378
  export const zChannelSubscription = z.object({
377
379
  axis: zAnnotationAxis.optional(),
378
380
  id: z.string().optional(),
@@ -388,66 +390,66 @@ export const zChildSessionRef = z.object({
388
390
  *
389
391
  * Available saved evidence or explicitly unknown source ranges
390
392
  */
391
- export const zCollectiveEvidenceCoverage = z.enum(['available', 'unknown']);
393
+ export const zCollectiveEvidenceCoverage = closedSet()(z.enum(['available', 'unknown']));
392
394
  /**
393
395
  * Collective Fetch Commit
394
396
  *
395
397
  * Committed effect, including earlier commits before cancellation
396
398
  */
397
- export const zCollectiveFetchCommit = z.enum([
399
+ export const zCollectiveFetchCommit = closedSet()(z.enum([
398
400
  'updated',
399
401
  'unchanged',
400
402
  'retained'
401
- ]);
403
+ ]));
402
404
  /**
403
405
  * Collective Fetch Domain
404
406
  *
405
407
  * Independently installed complete metadata dataset
406
408
  */
407
- export const zCollectiveFetchDomain = z.enum([
409
+ export const zCollectiveFetchDomain = closedSet()(z.enum([
408
410
  'catalog',
409
411
  'history',
410
412
  'associations'
411
- ]);
413
+ ]));
412
414
  /**
413
415
  * Collective Fetch Outcome
414
416
  *
415
417
  * Complete only when every requested required scope completed
416
418
  */
417
- export const zCollectiveFetchOutcome = z.enum([
419
+ export const zCollectiveFetchOutcome = closedSet()(z.enum([
418
420
  'complete',
419
421
  'partial',
420
422
  'failed'
421
- ]);
423
+ ]));
422
424
  /**
423
425
  * Collective Fetch State
424
426
  *
425
427
  * One invocation result; a failed domain retains prior completed dates
426
428
  */
427
- export const zCollectiveFetchState = z.enum([
429
+ export const zCollectiveFetchState = closedSet()(z.enum([
428
430
  'complete',
429
431
  'failed',
430
432
  'cancelled',
431
433
  'superseded',
432
434
  'not_requested'
433
- ]);
435
+ ]));
434
436
  /**
435
437
  * Collective Observation Reason
436
438
  *
437
439
  * Independent dated relevance reason, not authority
438
440
  */
439
- export const zCollectiveObservationReason = z.enum([
441
+ export const zCollectiveObservationReason = closedSet()(z.enum([
440
442
  'membership',
441
443
  'contribution',
442
444
  'organization',
443
445
  'explicit'
444
- ]);
446
+ ]));
445
447
  /**
446
448
  * Collective Observation Source
447
449
  *
448
450
  * Narrow metadata source, no world directory or transcript content
449
451
  */
450
- export const zCollectiveObservationSource = z.enum([
452
+ export const zCollectiveObservationSource = closedSet()(z.enum([
451
453
  'membership',
452
454
  'contribution-discovery',
453
455
  'organization',
@@ -455,38 +457,38 @@ export const zCollectiveObservationSource = z.enum([
455
457
  'submissions',
456
458
  'attempts',
457
459
  'associations'
458
- ]);
460
+ ]));
459
461
  /**
460
462
  * Collective Observation State
461
463
  *
462
464
  * Dated disclosure state, never current authorization
463
465
  */
464
- export const zCollectiveObservationState = z.enum([
466
+ export const zCollectiveObservationState = closedSet()(z.enum([
465
467
  'observed',
466
468
  'unavailable',
467
469
  'invalidated'
468
- ]);
470
+ ]));
469
471
  /**
470
472
  * Collective Operation
471
473
  *
472
474
  * Operation whose actual outcome is recorded
473
475
  */
474
- export const zCollectiveOperation = z.enum([
476
+ export const zCollectiveOperation = closedSet()(z.enum([
475
477
  'publish',
476
478
  'share',
477
479
  'fetch',
478
480
  'pull'
479
- ]);
481
+ ]));
480
482
  /**
481
483
  * Collective Source Outcome
482
484
  *
483
485
  * Privacy-safe source outcome without hidden reasons
484
486
  */
485
- export const zCollectiveSourceOutcome = z.enum([
487
+ export const zCollectiveSourceOutcome = closedSet()(z.enum([
486
488
  'disclosed',
487
489
  'not_disclosed',
488
490
  'failed'
489
- ]);
491
+ ]));
490
492
  export const zCommandInvocation = z.object({
491
493
  args: z.string().optional(),
492
494
  name: z.string()
@@ -504,11 +506,11 @@ export const zCommitInfo = z.object({
504
506
  *
505
507
  * Strength of evidence behind a derived relationship: high, medium, or low
506
508
  */
507
- export const zConfidence = z.enum([
509
+ export const zConfidence = closedSet()(z.enum([
508
510
  'high',
509
511
  'medium',
510
512
  'low'
511
- ]);
513
+ ]));
512
514
  /**
513
515
  * Content Capability
514
516
  *
@@ -520,13 +522,13 @@ export const zContentCapability = z.string();
520
522
  *
521
523
  * Payload kind carried by a transcript content envelope
522
524
  */
523
- export const zContentKind = z.enum(['session_detail']);
525
+ export const zContentKind = closedSet()(z.enum(['session_detail']));
524
526
  /**
525
527
  * Content Origin
526
528
  *
527
529
  * Closed session graph value
528
530
  */
529
- export const zContentOrigin = z.enum([
531
+ export const zContentOrigin = closedSet()(z.enum([
530
532
  'submitted_input',
531
533
  'harness_context',
532
534
  'agent_output',
@@ -535,17 +537,17 @@ export const zContentOrigin = z.enum([
535
537
  'system_control',
536
538
  'generated_summary',
537
539
  'unknown'
538
- ]);
540
+ ]));
539
541
  /**
540
542
  * Content Ownership
541
543
  *
542
544
  * Closed session graph value
543
545
  */
544
- export const zContentOwnership = z.enum([
546
+ export const zContentOwnership = closedSet()(z.enum([
545
547
  'local',
546
548
  'inherited',
547
549
  'uncertain'
548
- ]);
550
+ ]));
549
551
  export const zContractVersion = z.string().nullable();
550
552
  /**
551
553
  * Opaque versioned selected-category traversal token; not cacheRevision or authority
@@ -592,18 +594,18 @@ export const zDayStats = z.object({
592
594
  *
593
595
  * Recency band for project file familiarity
594
596
  */
595
- export const zDecayLevel = z.enum([
597
+ export const zDecayLevel = closedSet()(z.enum([
596
598
  'fresh',
597
599
  'fading',
598
600
  'stale',
599
601
  'unexplored'
600
- ]);
602
+ ]));
601
603
  /**
602
604
  * Delivery Origin
603
605
  *
604
606
  * Closed session graph value
605
607
  */
606
- export const zDeliveryOrigin = z.enum([
608
+ export const zDeliveryOrigin = closedSet()(z.enum([
607
609
  'session_admission',
608
610
  'guardian_review',
609
611
  'subagent_delivery',
@@ -611,7 +613,7 @@ export const zDeliveryOrigin = z.enum([
611
613
  'tool_delivery',
612
614
  'system_lifecycle',
613
615
  'unknown'
614
- ]);
616
+ ]));
615
617
  export const zDiagnosticEntry = z.object({
616
618
  errorType: z.string(),
617
619
  location: z.string(),
@@ -627,11 +629,11 @@ export const zDiagnosticsInfo = z.object({
627
629
  *
628
630
  * Unified-diff line kind: context, addition, or deletion
629
631
  */
630
- export const zDiffLineKind = z.enum([
632
+ export const zDiffLineKind = closedSet()(z.enum([
631
633
  'context',
632
634
  'add',
633
635
  'del'
634
- ]);
636
+ ]));
635
637
  export const zDiffLine = z.object({
636
638
  kind: zDiffLineKind,
637
639
  text: z.string()
@@ -651,24 +653,24 @@ export const zDiffHunk = z.object({
651
653
  *
652
654
  * Kind of one item in the prompt digest chain: a session boundary, a human prompt, a skill invocation marker, or a commit anchor
653
655
  */
654
- export const zDigestItemKind = z.enum([
656
+ export const zDigestItemKind = closedSet()(z.enum([
655
657
  'session',
656
658
  'prompt',
657
659
  'skill',
658
660
  'commit'
659
- ]);
661
+ ]));
660
662
  /**
661
663
  * Earlier History State
662
664
  *
663
665
  * Closed session graph value
664
666
  */
665
- export const zEarlierHistoryState = z.enum(['uncertain_migrated', 'uncertain_unresolved']);
667
+ export const zEarlierHistoryState = closedSet()(z.enum(['uncertain_migrated', 'uncertain_unresolved']));
666
668
  /**
667
669
  * Edge Violation Kind
668
670
  *
669
671
  * Structural violation detected on a map edge
670
672
  */
671
- export const zEdgeViolationKind = z.enum(['cycle', 'wrong_way']);
673
+ export const zEdgeViolationKind = closedSet()(z.enum(['cycle', 'wrong_way']));
672
674
  export const zEdgeViolation = z.object({
673
675
  from: z.string(),
674
676
  kind: zEdgeViolationKind,
@@ -679,7 +681,7 @@ export const zEdgeViolation = z.object({
679
681
  *
680
682
  * Classification of a single entry within an agent session transcript
681
683
  */
682
- export const zEntryType = z.enum([
684
+ export const zEntryType = closedSet()(z.enum([
683
685
  'text',
684
686
  'tool_use',
685
687
  'tool_result',
@@ -688,20 +690,20 @@ export const zEntryType = z.enum([
688
690
  'error',
689
691
  'result',
690
692
  'image'
691
- ]);
693
+ ]));
692
694
  /**
693
695
  * Evidence Kind
694
696
  *
695
697
  * Closed session graph value
696
698
  */
697
- export const zEvidenceKind = z.enum([
699
+ export const zEvidenceKind = closedSet()(z.enum([
698
700
  'native_typed',
699
701
  'lifecycle_typed',
700
702
  'existing_adapter',
701
703
  'retained_last_good',
702
704
  'unknown',
703
705
  'conflict'
704
- ]);
706
+ ]));
705
707
  export const zExchangeCodeRequest = z.object({
706
708
  code: z.string(),
707
709
  state: z.string()
@@ -717,12 +719,12 @@ export const zExchangeCodeResponse = z.object({
717
719
  *
718
720
  * Git file delta status: modified, added, deleted, or renamed
719
721
  */
720
- export const zFileChangeStatus = z.enum([
722
+ export const zFileChangeStatus = closedSet()(z.enum([
721
723
  'M',
722
724
  'A',
723
725
  'D',
724
726
  'R'
725
- ]);
727
+ ]));
726
728
  export const zChangeDiffPayload = z.object({
727
729
  binary: z.boolean(),
728
730
  branch: z.string(),
@@ -762,7 +764,7 @@ export const zFrictionCluster = z.object({
762
764
  *
763
765
  * AI coding tool or development environment
764
766
  */
765
- export const zHarness = z.enum([
767
+ export const zHarness = closedSet()(z.enum([
766
768
  'claude-code',
767
769
  'gemini-cli',
768
770
  'codex',
@@ -779,7 +781,7 @@ export const zHarness = z.enum([
779
781
  'kiro-crew',
780
782
  'antigravity-cli',
781
783
  'antigravity-ide'
782
- ]);
784
+ ]));
783
785
  export const zHealthResponse = z.object({
784
786
  status: z.string()
785
787
  });
@@ -794,20 +796,20 @@ export const zHostSlug = z.string().regex(/^[a-zA-Z0-9._<>-]+$/);
794
796
  *
795
797
  * Recorded image media type: image/png or image/jpeg
796
798
  */
797
- export const zImageMediaType = z.enum(['image/png', 'image/jpeg']);
799
+ export const zImageMediaType = closedSet()(z.enum(['image/png', 'image/jpeg']));
798
800
  /**
799
801
  * Input Modality
800
802
  *
801
803
  * Closed session graph value
802
804
  */
803
- export const zInputModality = z.enum([
805
+ export const zInputModality = closedSet()(z.enum([
804
806
  'none',
805
807
  'text',
806
808
  'media',
807
809
  'user_action',
808
810
  'mixed',
809
811
  'unknown'
810
- ]);
812
+ ]));
811
813
  export const zInsightClassification = z.object({
812
814
  category: z.string(),
813
815
  cause: z.string(),
@@ -820,29 +822,29 @@ export const zInsightClassification = z.object({
820
822
  *
821
823
  * What a SessionInsight observed: a decision, friction, an unusual rate elevation, or a retry loop
822
824
  */
823
- export const zInsightKind = z.enum([
825
+ export const zInsightKind = closedSet()(z.enum([
824
826
  'decision',
825
827
  'friction',
826
828
  'unusual',
827
829
  'retry_loop'
828
- ]);
830
+ ]));
829
831
  /**
830
832
  * Insight Provenance
831
833
  *
832
834
  * How a SessionInsight was produced: mechanical (rule-derived) or mined
833
835
  */
834
- export const zInsightProvenance = z.enum(['mechanical', 'mined']);
836
+ export const zInsightProvenance = closedSet()(z.enum(['mechanical', 'mined']));
835
837
  /**
836
838
  * Interaction Type
837
839
  *
838
840
  * How deeply a session engaged with a project file
839
841
  */
840
- export const zInteractionType = z.enum([
842
+ export const zInteractionType = closedSet()(z.enum([
841
843
  'mentioned',
842
844
  'read',
843
845
  'discussed',
844
846
  'questioned'
845
- ]);
847
+ ]));
846
848
  export const zInterpretationDiagnostics = z.object({
847
849
  partial: z.boolean()
848
850
  });
@@ -851,17 +853,17 @@ export const zInterpretationDiagnostics = z.object({
851
853
  *
852
854
  * Content license for a published transcript
853
855
  */
854
- export const zLicense = z.enum([
856
+ export const zLicense = closedSet()(z.enum([
855
857
  'CC0-1.0',
856
858
  'CC-BY-4.0',
857
859
  'CC-BY-SA-4.0'
858
- ]);
860
+ ]));
859
861
  /**
860
862
  * Local Collective Suggestion Reason
861
863
  *
862
864
  * Why the local server suggests a collective for a session
863
865
  */
864
- export const zLocalCollectiveSuggestionReason = z.enum(['linked_repository', 'linked_github_org']);
866
+ export const zLocalCollectiveSuggestionReason = closedSet()(z.enum(['linked_repository', 'linked_github_org']));
865
867
  export const zLocalCollectiveSuggestion = z.object({
866
868
  match: z.string(),
867
869
  reason: zLocalCollectiveSuggestionReason
@@ -871,23 +873,23 @@ export const zLocalCollectiveSuggestion = z.object({
871
873
  *
872
874
  * Actual request effect, never collective approval
873
875
  */
874
- export const zLocalConfirmedContributionOutcome = z.enum(['published', 'submitted']);
876
+ export const zLocalConfirmedContributionOutcome = closedSet()(z.enum(['published', 'submitted']));
875
877
  /**
876
878
  * Local Contribution Evidence Kind
877
879
  *
878
880
  * One independently bounded evidence category
879
881
  */
880
- export const zLocalContributionEvidenceKind = z.enum([
882
+ export const zLocalContributionEvidenceKind = closedSet()(z.enum([
881
883
  'remote-attempts',
882
884
  'receipts',
883
885
  'operation-diagnostics'
884
- ]);
886
+ ]));
885
887
  /**
886
888
  * Kickstart Close Reason
887
889
  *
888
890
  * Why a kickstart session ended: committed or expired
889
891
  */
890
- export const zLocalKickstartCloseReason = z.enum(['committed', 'expired']);
892
+ export const zLocalKickstartCloseReason = closedSet()(z.enum(['committed', 'expired']));
891
893
  export const zLocalKickstartConnect = z.object({
892
894
  afterStop: z.string().optional(),
893
895
  offered: z.boolean(),
@@ -899,17 +901,17 @@ export const zLocalKickstartConnect = z.object({
899
901
  *
900
902
  * Boundary offer answer: accept or skip. accept requires village to be connected
901
903
  */
902
- export const zLocalKickstartConnectAnswer = z.enum(['accept', 'skip']);
904
+ export const zLocalKickstartConnectAnswer = closedSet()(z.enum(['accept', 'skip']));
903
905
  /**
904
906
  * Kickstart Diff Line Type
905
907
  *
906
908
  * Structured config-diff line: add, del, or ctx
907
909
  */
908
- export const zLocalKickstartDiffLineType = z.enum([
910
+ export const zLocalKickstartDiffLineType = closedSet()(z.enum([
909
911
  'add',
910
912
  'del',
911
913
  'ctx'
912
- ]);
914
+ ]));
913
915
  export const zLocalKickstartDiffLine = z.object({
914
916
  newNo: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808).optional(),
915
917
  oldNo: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808).optional(),
@@ -921,7 +923,7 @@ export const zLocalKickstartDiffLine = z.object({
921
923
  *
922
924
  * Machine-readable reason a kickstart route refused a request or could not finish it. Each token answers with one HTTP status
923
925
  */
924
- export const zLocalKickstartErrorCode = z.enum([
926
+ export const zLocalKickstartErrorCode = closedSet()(z.enum([
925
927
  'kickstart_body_missing',
926
928
  'kickstart_body_invalid',
927
929
  'kickstart_scope_invalid',
@@ -951,7 +953,7 @@ export const zLocalKickstartErrorCode = z.enum([
951
953
  'kickstart_unavailable',
952
954
  'kickstart_config_busy',
953
955
  'kickstart_config_changing'
954
- ]);
956
+ ]));
955
957
  export const zLocalKickstartErrorResponse = z.object({
956
958
  code: zLocalKickstartErrorCode,
957
959
  error: z.string().min(1)
@@ -961,26 +963,26 @@ export const zLocalKickstartErrorResponse = z.object({
961
963
  *
962
964
  * Live kickstart topic discriminator. One event carries one session id
963
965
  */
964
- export const zLocalKickstartEventKind = z.enum([
966
+ export const zLocalKickstartEventKind = closedSet()(z.enum([
965
967
  'session',
966
968
  'answers',
967
969
  'conflicts',
968
970
  'scan',
969
971
  'ingest',
970
972
  'closed'
971
- ]);
973
+ ]));
972
974
  /**
973
975
  * Kickstart Field Kind
974
976
  *
975
977
  * Control shape of one kickstart field
976
978
  */
977
- export const zLocalKickstartFieldKind = z.enum([
979
+ export const zLocalKickstartFieldKind = closedSet()(z.enum([
978
980
  'toggle',
979
981
  'choice',
980
982
  'action',
981
983
  'tree',
982
984
  'notice'
983
- ]);
985
+ ]));
984
986
  export const zLocalKickstartGuide = z.object({
985
987
  hints: z.array(z.string()).optional(),
986
988
  intro: z.string().optional()
@@ -999,12 +1001,12 @@ export const zLocalKickstartDiff = z.object({
999
1001
  *
1000
1002
  * Import state pushed on the kickstart topic
1001
1003
  */
1002
- export const zLocalKickstartIngestState = z.enum([
1004
+ export const zLocalKickstartIngestState = closedSet()(z.enum([
1003
1005
  'idle',
1004
1006
  'running',
1005
1007
  'busy',
1006
1008
  'failed'
1007
- ]);
1009
+ ]));
1008
1010
  export const zLocalKickstartIngest = z.object({
1009
1011
  error: z.string().optional(),
1010
1012
  new: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808),
@@ -1017,13 +1019,13 @@ export const zLocalKickstartIngest = z.object({
1017
1019
  *
1018
1020
  * Typed preview or example line
1019
1021
  */
1020
- export const zLocalKickstartLineKind = z.enum([
1022
+ export const zLocalKickstartLineKind = closedSet()(z.enum([
1021
1023
  'text',
1022
1024
  'label',
1023
1025
  'before',
1024
1026
  'after',
1025
1027
  'spacer'
1026
- ]);
1028
+ ]));
1027
1029
  export const zLocalKickstartLine = z.object({
1028
1030
  kind: zLocalKickstartLineKind,
1029
1031
  text: z.string()
@@ -1033,13 +1035,13 @@ export const zLocalKickstartLine = z.object({
1033
1035
  *
1034
1036
  * One finish action. auto-publish-settings links to the settings section; it does not install a hook
1035
1037
  */
1036
- export const zLocalKickstartNextStep = z.enum([
1038
+ export const zLocalKickstartNextStep = closedSet()(z.enum([
1037
1039
  'config',
1038
1040
  'web-start',
1039
1041
  'village-login',
1040
1042
  'village-push',
1041
1043
  'auto-publish-settings'
1042
- ]);
1044
+ ]));
1043
1045
  export const zLocalKickstartCommitted = z.object({
1044
1046
  configPath: z.string().min(1),
1045
1047
  diagnostics: z.array(z.string()).optional(),
@@ -1052,22 +1054,22 @@ export const zLocalKickstartCommitted = z.object({
1052
1054
  *
1053
1055
  * Row kind in the selection forest
1054
1056
  */
1055
- export const zLocalKickstartNodeKind = z.enum([
1057
+ export const zLocalKickstartNodeKind = closedSet()(z.enum([
1056
1058
  'project',
1057
1059
  'group',
1058
1060
  'branch',
1059
1061
  'session'
1060
- ]);
1062
+ ]));
1061
1063
  /**
1062
1064
  * Kickstart Node State
1063
1065
  *
1064
1066
  * Server-computed selection of one forest row: none, some, or all. locked is a boolean, not a state
1065
1067
  */
1066
- export const zLocalKickstartNodeState = z.enum([
1068
+ export const zLocalKickstartNodeState = closedSet()(z.enum([
1067
1069
  'none',
1068
1070
  'some',
1069
1071
  'all'
1070
- ]);
1072
+ ]));
1071
1073
  export const zLocalKickstartNode = z.object({
1072
1074
  childCount: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808).optional(),
1073
1075
  harness: z.string().optional(),
@@ -1092,18 +1094,18 @@ export const zLocalKickstartPreview = z.object({
1092
1094
  *
1093
1095
  * Which side of one conflict row to keep: mine is the draft, theirs is the file
1094
1096
  */
1095
- export const zLocalKickstartResolution = z.enum(['mine', 'theirs']);
1097
+ export const zLocalKickstartResolution = closedSet()(z.enum(['mine', 'theirs']));
1096
1098
  /**
1097
1099
  * Kickstart Scan State
1098
1100
  *
1099
1101
  * Discovery job state pushed on the kickstart topic
1100
1102
  */
1101
- export const zLocalKickstartScanState = z.enum([
1103
+ export const zLocalKickstartScanState = closedSet()(z.enum([
1102
1104
  'idle',
1103
1105
  'running',
1104
1106
  'done',
1105
1107
  'error'
1106
- ]);
1108
+ ]));
1107
1109
  export const zLocalKickstartScan = z.object({
1108
1110
  done: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808),
1109
1111
  droppedLabels: z.array(z.string()).max(3).optional(),
@@ -1120,7 +1122,7 @@ export const zLocalKickstartScan = z.object({
1120
1122
  *
1121
1123
  * Answer set a kickstart session collects: the whole wizard, or the selection page
1122
1124
  */
1123
- export const zLocalKickstartScope = z.enum(['full', 'selection']);
1125
+ export const zLocalKickstartScope = closedSet()(z.enum(['full', 'selection']));
1124
1126
  export const zLocalKickstartOpenRequest = z.object({
1125
1127
  scope: zLocalKickstartScope
1126
1128
  }).strict();
@@ -1133,12 +1135,12 @@ export const zLocalKickstartStatus = z.object({
1133
1135
  *
1134
1136
  * Layout of one kickstart stop
1135
1137
  */
1136
- export const zLocalKickstartStopKind = z.enum([
1138
+ export const zLocalKickstartStopKind = closedSet()(z.enum([
1137
1139
  'connection',
1138
1140
  'config',
1139
1141
  'review',
1140
1142
  'ingest'
1141
- ]);
1143
+ ]));
1142
1144
  export const zLocalKickstartSummary = z.object({
1143
1145
  effects: z.array(z.string()),
1144
1146
  values: z.array(z.string())
@@ -1156,7 +1158,7 @@ export const zLocalKickstartVillage = z.object({
1156
1158
  *
1157
1159
  * Failure or uncertain remote effect, never successful contribution
1158
1160
  */
1159
- export const zLocalOperationDiagnosticOutcome = z.enum(['failed', 'uncertain']);
1161
+ export const zLocalOperationDiagnosticOutcome = closedSet()(z.enum(['failed', 'uncertain']));
1160
1162
  export const zLocalPublicationAttemptFailure = z.object({
1161
1163
  attemptedAt: z.iso.datetime({ offset: true }),
1162
1164
  message: z.string()
@@ -1166,20 +1168,20 @@ export const zLocalPublicationAttemptFailure = z.object({
1166
1168
  *
1167
1169
  * Whether a local session has a publication on Village
1168
1170
  */
1169
- export const zLocalPublicationState = z.enum(['unpublished', 'published']);
1171
+ export const zLocalPublicationState = closedSet()(z.enum(['unpublished', 'published']));
1170
1172
  /**
1171
1173
  * Local Setting Kind
1172
1174
  *
1173
1175
  * JSON type of one local setting's value
1174
1176
  */
1175
- export const zLocalSettingKind = z.enum([
1177
+ export const zLocalSettingKind = closedSet()(z.enum([
1176
1178
  'boolean',
1177
1179
  'integer',
1178
1180
  'string',
1179
1181
  'string_list',
1180
1182
  'choice',
1181
1183
  'structured'
1182
- ]);
1184
+ ]));
1183
1185
  export const zLocalSettingRefusal = z.object({
1184
1186
  error: z.string().min(1),
1185
1187
  key: z.string().min(1)
@@ -1286,12 +1288,12 @@ export const zLocalSettingUpdateRequest = z.object({
1286
1288
  *
1287
1289
  * Root publication filter; auto uses the canonical live hook decision
1288
1290
  */
1289
- export const zLocalSyncPublicationFilter = z.enum([
1291
+ export const zLocalSyncPublicationFilter = closedSet()(z.enum([
1290
1292
  'all',
1291
1293
  'not-published',
1292
1294
  'published',
1293
1295
  'auto'
1294
- ]);
1296
+ ]));
1295
1297
  export const zLocalSyncSessionTotals = z.object({
1296
1298
  sessions: z.int().gte(0).lte(9007199254740991)
1297
1299
  });
@@ -1310,11 +1312,11 @@ export const zMapEdge = z.object({
1310
1312
  *
1311
1313
  * Path-derived map node classification
1312
1314
  */
1313
- export const zMapNodeKind = z.enum([
1315
+ export const zMapNodeKind = closedSet()(z.enum([
1314
1316
  'module',
1315
1317
  'package',
1316
1318
  'file'
1317
- ]);
1319
+ ]));
1318
1320
  export const zMedianP90 = z.object({
1319
1321
  count: z.int().gte(0).lte(9007199254740991),
1320
1322
  median: z.number().nullable(),
@@ -1331,7 +1333,7 @@ export const zAnalyticsSessionStats = z.object({
1331
1333
  *
1332
1334
  * WebSocket message discriminator
1333
1335
  */
1334
- export const zMessageType = z.enum([
1336
+ export const zMessageType = closedSet()(z.enum([
1335
1337
  'subscribe',
1336
1338
  'unsubscribe',
1337
1339
  'dashboard',
@@ -1344,7 +1346,7 @@ export const zMessageType = z.enum([
1344
1346
  'connected',
1345
1347
  'error',
1346
1348
  'kickstart'
1347
- ]);
1349
+ ]));
1348
1350
  export const zClientMessage = z.object({
1349
1351
  channels: z.array(zChannelSubscription).optional(),
1350
1352
  type: zMessageType
@@ -1382,31 +1384,31 @@ export const zNativeAttachmentRef = z.object({
1382
1384
  *
1383
1385
  * Kind of bounded non-conversational native metadata
1384
1386
  */
1385
- export const zNativeMetadataKind = z.enum([
1387
+ export const zNativeMetadataKind = closedSet()(z.enum([
1386
1388
  'pi.custom.data',
1387
1389
  'pi.custommessage.details',
1388
1390
  'pi.toolresult.details',
1389
1391
  'pi.compaction.details',
1390
1392
  'pi.branchsummary.details'
1391
- ]);
1393
+ ]));
1392
1394
  /**
1393
1395
  * Native Metadata Source Type
1394
1396
  *
1395
1397
  * Native source category for public metadata
1396
1398
  */
1397
- export const zNativeMetadataSourceType = z.enum([
1399
+ export const zNativeMetadataSourceType = closedSet()(z.enum([
1398
1400
  'pi.custom',
1399
1401
  'pi.custom_message',
1400
1402
  'pi.message',
1401
1403
  'pi.compaction',
1402
1404
  'pi.branch_summary'
1403
- ]);
1405
+ ]));
1404
1406
  /**
1405
1407
  * Native Pi Message Role
1406
1408
  *
1407
1409
  * Pi message role needed for public metadata validation
1408
1410
  */
1409
- export const zNativePiMessageRole = z.enum(['toolResult']);
1411
+ export const zNativePiMessageRole = closedSet()(z.enum(['toolResult']));
1410
1412
  /**
1411
1413
  * Observed Model ID
1412
1414
  *
@@ -1418,12 +1420,12 @@ export const zObservedModelID = z.string().min(1).regex(/^(?:|[^\s])(?:[\s\S]
1418
1420
  *
1419
1421
  * Why an image part carries no bytes: unsupported (wins for a non-recorded media type), too_large, missing, or not_published
1420
1422
  */
1421
- export const zOmittedReason = z.enum([
1423
+ export const zOmittedReason = closedSet()(z.enum([
1422
1424
  'too_large',
1423
1425
  'unsupported',
1424
1426
  'missing',
1425
1427
  'not_published'
1426
- ]);
1428
+ ]));
1427
1429
  export const zImagePart = z.object({
1428
1430
  byteSize: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808).optional(),
1429
1431
  height: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808).optional(),
@@ -1437,14 +1439,14 @@ export const zImagePart = z.object({
1437
1439
  *
1438
1440
  * Bounded failure category; retry is corrective text only
1439
1441
  */
1440
- export const zOperationIssueCode = z.enum([
1442
+ export const zOperationIssueCode = closedSet()(z.enum([
1441
1443
  'auth',
1442
1444
  'remote',
1443
1445
  'contract',
1444
1446
  'deadline',
1445
1447
  'persistence',
1446
1448
  'superseded'
1447
- ]);
1449
+ ]));
1448
1450
  export const zOperationIssue = z.object({
1449
1451
  code: zOperationIssueCode,
1450
1452
  message: z.string().min(1).max(2048),
@@ -1506,11 +1508,11 @@ export const zOwnerUpdateLicenseIntent = z.enum([
1506
1508
  *
1507
1509
  * Closed page size set for local list reads: 25, 50, or 100. The value is a number on the wire; an omitted maximum maps to 25 before validation.
1508
1510
  */
1509
- export const zPageSize = z.union([
1511
+ export const zPageSize = closedSet()(z.union([
1510
1512
  z.literal(25),
1511
1513
  z.literal(50),
1512
1514
  z.literal(100)
1513
- ]);
1515
+ ]));
1514
1516
  export const zPersonalMedians = z.object({
1515
1517
  retryShare: z.number().nullish(),
1516
1518
  specQualityScore: z.number().nullish(),
@@ -1592,21 +1594,21 @@ export const zPublicRevisionRef = z.string().min(1).max(96).refine((value) => !/
1592
1594
  *
1593
1595
  * Closed session graph value
1594
1596
  */
1595
- export const zPublicSourceAnchorKind = z.enum([
1597
+ export const zPublicSourceAnchorKind = closedSet()(z.enum([
1596
1598
  'general_source_session',
1597
1599
  'before_redacted_entry',
1598
1600
  'through_redacted_entry'
1599
- ]);
1601
+ ]));
1600
1602
  /**
1601
1603
  * Publish Operation Kind
1602
1604
  *
1603
1605
  * Mutation semantic for one publish operation arm
1604
1606
  */
1605
- export const zPublishOperationKind = z.enum([
1607
+ export const zPublishOperationKind = closedSet()(z.enum([
1606
1608
  'preserve',
1607
1609
  'replace',
1608
1610
  'append'
1609
- ]);
1611
+ ]));
1610
1612
  export const zPublishLicenseOperation = z.object({
1611
1613
  kind: zPublishOperationKind,
1612
1614
  license: zLicense.nullable()
@@ -1698,12 +1700,12 @@ export const zPublishAssociationOperation = z.object({
1698
1700
  *
1699
1701
  * Optional metadata result, independent of required content success
1700
1702
  */
1701
- export const zPullAssociationMetadataState = z.enum([
1703
+ export const zPullAssociationMetadataState = closedSet()(z.enum([
1702
1704
  'observed',
1703
1705
  'stale',
1704
1706
  'unknown',
1705
1707
  'invalidated'
1706
- ]);
1708
+ ]));
1707
1709
  export const zPullAssociationMetadataResult = z.object({
1708
1710
  observedAt: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullish(),
1709
1711
  state: zPullAssociationMetadataState,
@@ -1715,22 +1717,22 @@ export const zPullAssociationMetadataResult = z.object({
1715
1717
  *
1716
1718
  * Whether per-file read attribution is recoverable for a node's editing sessions: complete, partial, or unavailable
1717
1719
  */
1718
- export const zReadAttributionState = z.enum([
1720
+ export const zReadAttributionState = closedSet()(z.enum([
1719
1721
  'complete',
1720
1722
  'partial',
1721
1723
  'unavailable'
1722
- ]);
1724
+ ]));
1723
1725
  /**
1724
1726
  * Read State Grade
1725
1727
  *
1726
1728
  * Ordinal explicit read-state act: none, viewed, reviewed, or reviewed_in_detail
1727
1729
  */
1728
- export const zReadStateGrade = z.enum([
1730
+ export const zReadStateGrade = closedSet()(z.enum([
1729
1731
  'none',
1730
1732
  'viewed',
1731
1733
  'reviewed',
1732
1734
  'reviewed_in_detail'
1733
- ]);
1735
+ ]));
1734
1736
  export const zMapNode = z.object({
1735
1737
  agentEditedCount: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
1736
1738
  attributedRegionCount: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
@@ -1791,14 +1793,14 @@ export const zRedactionInfo = z.object({
1791
1793
  *
1792
1794
  * Closed session graph value
1793
1795
  */
1794
- export const zRelationshipNavigationStatus = z.enum([
1796
+ export const zRelationshipNavigationStatus = closedSet()(z.enum([
1795
1797
  'resolved',
1796
1798
  'general_link_only',
1797
1799
  'known_unavailable',
1798
1800
  'inaccessible',
1799
1801
  'unknown',
1800
1802
  'conflicting'
1801
- ]);
1803
+ ]));
1802
1804
  export const zHelperContextSummary = z.object({
1803
1805
  groupId: z.string(),
1804
1806
  ownerStatus: zRelationshipNavigationStatus
@@ -1812,13 +1814,13 @@ export const zHelperContextSummary = z.object({
1812
1814
  *
1813
1815
  * Closed session graph value
1814
1816
  */
1815
- export const zRelationshipTargetState = z.enum([
1817
+ export const zRelationshipTargetState = closedSet()(z.enum([
1816
1818
  'target_known',
1817
1819
  'target_known_retained',
1818
1820
  'explicit_none',
1819
1821
  'unknown',
1820
1822
  'conflicting_current_native_evidence'
1821
- ]);
1823
+ ]));
1822
1824
  export const zRetainedUnknownRecord = z.object({
1823
1825
  kind: z.string().min(1),
1824
1826
  namespace: z.string().min(1),
@@ -1844,45 +1846,45 @@ export const zReviewSuggestion = z.object({
1844
1846
  *
1845
1847
  * Mechanism the resolver used to map a ghost commit to its successor
1846
1848
  */
1847
- export const zRewriteMethod = z.enum([
1849
+ export const zRewriteMethod = closedSet()(z.enum([
1848
1850
  'hash',
1849
1851
  'patch_id',
1850
1852
  'author_identity',
1851
1853
  'message_embedded',
1852
1854
  'temporal',
1853
1855
  'none'
1854
- ]);
1856
+ ]));
1855
1857
  /**
1856
1858
  * Rewrite Resolution
1857
1859
  *
1858
1860
  * Whether a ledger-observed commit hash is live, was rewritten, or could not be resolved
1859
1861
  */
1860
- export const zRewriteResolution = z.enum([
1862
+ export const zRewriteResolution = closedSet()(z.enum([
1861
1863
  'live',
1862
1864
  'rewritten',
1863
1865
  'unresolved'
1864
- ]);
1866
+ ]));
1865
1867
  /**
1866
1868
  * Role
1867
1869
  *
1868
1870
  * Sender role of a message turn
1869
1871
  */
1870
- export const zRole = z.enum([
1872
+ export const zRole = closedSet()(z.enum([
1871
1873
  'user',
1872
1874
  'assistant',
1873
1875
  'tool',
1874
1876
  'system'
1875
- ]);
1877
+ ]));
1876
1878
  /**
1877
1879
  * Scale Kind
1878
1880
  *
1879
1881
  * Stevens measurement level: nominal (categories without order), ordinal (ordered categories), continuous (numeric range)
1880
1882
  */
1881
- export const zScaleKind = z.enum([
1883
+ export const zScaleKind = closedSet()(z.enum([
1882
1884
  'nominal',
1883
1885
  'ordinal',
1884
1886
  'continuous'
1885
- ]);
1887
+ ]));
1886
1888
  export const zSchemaVersionResponse = z.object({
1887
1889
  annotationSchemaVersion: z.string(),
1888
1890
  contentCapabilities: z.array(z.string()).optional(),
@@ -1909,7 +1911,7 @@ export const zScryTranscriptRecord = z.object({
1909
1911
  *
1910
1912
  * Whether scry examined the transcript; unchecked means scry declined unsupported content or harness
1911
1913
  */
1912
- export const zScryVerdict = z.enum(['checked', 'unchecked']);
1914
+ export const zScryVerdict = closedSet()(z.enum(['checked', 'unchecked']));
1913
1915
  export const zScryCheckResponse = z.object({
1914
1916
  flaggedTurns: z.array(z.int().gte(0).lte(9007199254740991)),
1915
1917
  scryVersion: z.string().regex(/^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/),
@@ -2044,27 +2046,27 @@ export const zSessionInsight = z.object({
2044
2046
  *
2045
2047
  * Closed session graph value
2046
2048
  */
2047
- export const zSessionListItemKind = z.enum(['transcript', 'context_container']);
2049
+ export const zSessionListItemKind = closedSet()(z.enum(['transcript', 'context_container']));
2048
2050
  /**
2049
2051
  * Session Origin
2050
2052
  *
2051
2053
  * Who drove a recorded session, as declared by the producer that recorded it
2052
2054
  */
2053
- export const zSessionOrigin = z.enum([
2055
+ export const zSessionOrigin = closedSet()(z.enum([
2054
2056
  'user',
2055
2057
  'agent',
2056
2058
  'unknown'
2057
- ]);
2059
+ ]));
2058
2060
  /**
2059
2061
  * Session Outcome
2060
2062
  *
2061
2063
  * Resolution status of the session
2062
2064
  */
2063
- export const zSessionOutcome = z.enum([
2065
+ export const zSessionOutcome = closedSet()(z.enum([
2064
2066
  'resolved',
2065
2067
  'partial',
2066
2068
  'failed'
2067
- ]);
2069
+ ]));
2068
2070
  export const zAuthoritativeQualityMetrics = z.object({
2069
2071
  computeVersion: z.int().nullish(),
2070
2072
  computedAt: z.int().nullish(),
@@ -2165,12 +2167,12 @@ export const zSessionPullRequest = z.object({
2165
2167
  *
2166
2168
  * Closed session graph value
2167
2169
  */
2168
- export const zSessionPurpose = z.enum([
2170
+ export const zSessionPurpose = closedSet()(z.enum([
2169
2171
  'interaction',
2170
2172
  'delegated_work',
2171
2173
  'helper_review',
2172
2174
  'unknown'
2173
- ]);
2175
+ ]));
2174
2176
  export const zHelperGroupSummary = z.object({
2175
2177
  groupId: z.string(),
2176
2178
  helperThreadCount: z.int().gte(0).lte(9007199254740991),
@@ -2186,7 +2188,7 @@ export const zHelperGroupSummary = z.object({
2186
2188
  *
2187
2189
  * Closed session graph value
2188
2190
  */
2189
- export const zSessionRelationshipKind = z.enum(['started_by', 'context_from']);
2191
+ export const zSessionRelationshipKind = closedSet()(z.enum(['started_by', 'context_from']));
2190
2192
  export const zSessionScorecard = z.object({
2191
2193
  costTotalUsd: z.number().nullish(),
2192
2194
  m2TokenOutcomeRatio: z.number().nullish(),
@@ -2220,7 +2222,7 @@ export const zSessionStats = z.object({
2220
2222
  *
2221
2223
  * Record a local teammate identity rests on; only a native dynamic workflow spawn is recorded
2222
2224
  */
2223
- export const zSessionTeammateEvidence = z.enum(['native_dynamic_workflow']);
2225
+ export const zSessionTeammateEvidence = closedSet()(z.enum(['native_dynamic_workflow']));
2224
2226
  export const zSessionTeammate = z.object({
2225
2227
  evidence: zSessionTeammateEvidence,
2226
2228
  name: z.string().min(1).regex(/^[^\x00-\x1F\x7F-\x9F]*$/),
@@ -2308,7 +2310,7 @@ export const zSessionsPayload = z.object({
2308
2310
  *
2309
2311
  * Transcript file format
2310
2312
  */
2311
- export const zSourceFormat = z.enum(['jsonl', 'json']);
2313
+ export const zSourceFormat = closedSet()(z.enum(['jsonl', 'json']));
2312
2314
  export const zAuthoritativeSourceInfo = z.object({
2313
2315
  filePath: z.string().optional(),
2314
2316
  format: zSourceFormat
@@ -2322,13 +2324,13 @@ export const zSourceInfo = z.object({
2322
2324
  *
2323
2325
  * Reason why a session or turn ended (ACP-aligned)
2324
2326
  */
2325
- export const zStopReason = z.enum([
2327
+ export const zStopReason = closedSet()(z.enum([
2326
2328
  'end_turn',
2327
2329
  'cancelled',
2328
2330
  'max_tokens',
2329
2331
  'max_turn_requests',
2330
2332
  'refusal'
2331
- ]);
2333
+ ]));
2332
2334
  export const zSubagentRef = z.object({
2333
2335
  parentUuid: zSessionID,
2334
2336
  sessionId: zSessionID
@@ -2357,13 +2359,13 @@ export const zSyncAuthResponse = z.object({
2357
2359
  *
2358
2360
  * Why a held local session cannot be published yet
2359
2361
  */
2360
- export const zSyncHoldReason = z.enum(['metrics_missing', 'metadata_missing']);
2362
+ export const zSyncHoldReason = closedSet()(z.enum(['metrics_missing', 'metadata_missing']));
2361
2363
  /**
2362
2364
  * Sync Login Status
2363
2365
  *
2364
2366
  * Result of starting the Village sign-in from the local server
2365
2367
  */
2366
- export const zSyncLoginStatus = z.enum(['pending', 'already_authenticated']);
2368
+ export const zSyncLoginStatus = closedSet()(z.enum(['pending', 'already_authenticated']));
2367
2369
  export const zSyncLoginResponse = z.object({
2368
2370
  status: zSyncLoginStatus
2369
2371
  });
@@ -2372,7 +2374,7 @@ export const zSyncLoginResponse = z.object({
2372
2374
  *
2373
2375
  * Result of ending this computer's Village sign-in
2374
2376
  */
2375
- export const zSyncLogoutStatus = z.enum(['logged_out', 'already_logged_out']);
2377
+ export const zSyncLogoutStatus = closedSet()(z.enum(['logged_out', 'already_logged_out']));
2376
2378
  export const zSyncLogoutResponse = z.object({
2377
2379
  status: zSyncLogoutStatus
2378
2380
  });
@@ -2381,35 +2383,35 @@ export const zSyncLogoutResponse = z.object({
2381
2383
  *
2382
2384
  * Outcome of one session in a push
2383
2385
  */
2384
- export const zSyncPushSessionStatus = z.enum([
2386
+ export const zSyncPushSessionStatus = closedSet()(z.enum([
2385
2387
  'new',
2386
2388
  'updated',
2387
2389
  'skipped',
2388
2390
  'error',
2389
2391
  'held'
2390
- ]);
2392
+ ]));
2391
2393
  /**
2392
2394
  * Sync Push Step
2393
2395
  *
2394
2396
  * One step a push runs for a session
2395
2397
  */
2396
- export const zSyncPushStep = z.enum([
2398
+ export const zSyncPushStep = closedSet()(z.enum([
2397
2399
  'content',
2398
2400
  'add_collective',
2399
2401
  'remove_collective'
2400
- ]);
2402
+ ]));
2401
2403
  /**
2402
2404
  * Sync Push Step Outcome
2403
2405
  *
2404
2406
  * Result of one push step
2405
2407
  */
2406
- export const zSyncPushStepOutcome = z.enum([
2408
+ export const zSyncPushStepOutcome = closedSet()(z.enum([
2407
2409
  'succeeded',
2408
2410
  'pending_approval',
2409
2411
  'skipped',
2410
2412
  'failed',
2411
2413
  'not_attempted'
2412
- ]);
2414
+ ]));
2413
2415
  export const zSyncRedactionItem = z.object({
2414
2416
  category: z.string(),
2415
2417
  contextAfter: z.array(z.string()),
@@ -2443,12 +2445,12 @@ export const zSyncRedactionsResponse = z.object({
2443
2445
  *
2444
2446
  * Publication status of one listed local session; held rows always carry a hold reason
2445
2447
  */
2446
- export const zSyncStatus = z.enum([
2448
+ export const zSyncStatus = closedSet()(z.enum([
2447
2449
  'new',
2448
2450
  'updated',
2449
2451
  'synced',
2450
2452
  'held'
2451
- ]);
2453
+ ]));
2452
2454
  export const zLocalSyncSummary = z.object({
2453
2455
  conversationTurnCount: z.int().gte(0).lte(9007199254740991).optional(),
2454
2456
  durationMs: z.coerce.bigint().min(BigInt('-9223372036854775808'), { error: 'Invalid value: Expected int64 to be >= -9223372036854775808' }).max(BigInt('9223372036854775807'), { error: 'Invalid value: Expected int64 to be <= 9223372036854775807' }),
@@ -2571,14 +2573,14 @@ export const zLocalSyncSessionsPayload = z.object({
2571
2573
  *
2572
2574
  * What is being annotated: session-level, entry-level (turn/tool call), meta-annotation, project-level, a specific file version (content-hash keyed read-state receipt), or a durable session-to-commit association
2573
2575
  */
2574
- export const zTargetKind = z.enum([
2576
+ export const zTargetKind = closedSet()(z.enum([
2575
2577
  'session',
2576
2578
  'entry',
2577
2579
  'annotation',
2578
2580
  'project',
2579
2581
  'file_version',
2580
2582
  'association'
2581
- ]);
2583
+ ]));
2582
2584
  export const zAnnotationPushItem = z.intersection(z.union([
2583
2585
  z.object({
2584
2586
  targetAssociationId: zAssociationID,
@@ -2863,7 +2865,7 @@ export const zProjectTasksPayload = z.object({
2863
2865
  *
2864
2866
  * Canonical reasoning-effort level of assistant-generated output: off, minimal, low, medium, high, xhigh, max, ultra, ultracode. off is the single disabled state, ultra is above max, and ultracode is a distinct level. Omit the field when the level is unknown; never infer it from token budgets.
2865
2867
  */
2866
- export const zThinkingLevel = z.enum([
2868
+ export const zThinkingLevel = closedSet()(z.enum([
2867
2869
  'off',
2868
2870
  'minimal',
2869
2871
  'low',
@@ -2873,7 +2875,7 @@ export const zThinkingLevel = z.enum([
2873
2875
  'max',
2874
2876
  'ultra',
2875
2877
  'ultracode'
2876
- ]);
2878
+ ]));
2877
2879
  /**
2878
2880
  * Thinking Level Raw
2879
2881
  *
@@ -2955,7 +2957,7 @@ export const zTokenUsageDetail = z.object({
2955
2957
  *
2956
2958
  * Classification of a tool call, aligned with ACP ToolCallUpdate.kind
2957
2959
  */
2958
- export const zToolCallKind = z.enum([
2960
+ export const zToolCallKind = closedSet()(z.enum([
2959
2961
  'read',
2960
2962
  'edit',
2961
2963
  'delete',
@@ -2965,7 +2967,7 @@ export const zToolCallKind = z.enum([
2965
2967
  'think',
2966
2968
  'fetch',
2967
2969
  'other'
2968
- ]);
2970
+ ]));
2969
2971
  export const zAuthoritativeSessionEntry = z.object({
2970
2972
  contentPreview: z.string().nullish(),
2971
2973
  depth: z.int(),
@@ -3074,11 +3076,11 @@ export const zTranscriptEntryLocateRequest = z.object({
3074
3076
  *
3075
3077
  * Closed session graph value
3076
3078
  */
3077
- export const zTranscriptEntryReferenceKind = z.enum([
3079
+ export const zTranscriptEntryReferenceKind = closedSet()(z.enum([
3078
3080
  'source',
3079
3081
  'tool_call',
3080
3082
  'tool_result'
3081
- ]);
3083
+ ]));
3082
3084
  export const zTranscriptFlaggedTurn = z.object({
3083
3085
  position: z.number().refine(Number.isInteger).gte(0).lte(9223372036854775808),
3084
3086
  turn: z.int().gte(0).lte(9007199254740991).optional()
@@ -3205,49 +3207,49 @@ export const zSessionDetailHeaderPayload = z.object({
3205
3207
  *
3206
3208
  * Closed session graph value
3207
3209
  */
3208
- export const zTranscriptNativePresence = z.enum([
3210
+ export const zTranscriptNativePresence = closedSet()(z.enum([
3209
3211
  'absent',
3210
3212
  'present',
3211
3213
  'withheld'
3212
- ]);
3214
+ ]));
3213
3215
  /**
3214
3216
  * Transcript Read Transport Kind
3215
3217
  *
3216
3218
  * Closed session graph value
3217
3219
  */
3218
- export const zTranscriptReadTransportKind = z.enum(['local_session', 'village_transcript']);
3220
+ export const zTranscriptReadTransportKind = closedSet()(z.enum(['local_session', 'village_transcript']));
3219
3221
  /**
3220
3222
  * Transcript Read Validation
3221
3223
  *
3222
3224
  * Closed session graph value
3223
3225
  */
3224
- export const zTranscriptReadValidation = z.enum([
3226
+ export const zTranscriptReadValidation = closedSet()(z.enum([
3225
3227
  'published_strict',
3226
3228
  'served_legacy',
3227
3229
  'migrated'
3228
- ]);
3230
+ ]));
3229
3231
  /**
3230
3232
  * Transcript Recorded Index State
3231
3233
  *
3232
3234
  * Closed session graph value
3233
3235
  */
3234
- export const zTranscriptRecordedIndexState = z.enum([
3236
+ export const zTranscriptRecordedIndexState = closedSet()(z.enum([
3235
3237
  'present',
3236
3238
  'absent',
3237
3239
  'invalid'
3238
- ]);
3240
+ ]));
3239
3241
  /**
3240
3242
  * Transcript Retained State
3241
3243
  *
3242
3244
  * Closed session graph value
3243
3245
  */
3244
- export const zTranscriptRetainedState = z.enum(['absent', 'deferred']);
3246
+ export const zTranscriptRetainedState = closedSet()(z.enum(['absent', 'deferred']));
3245
3247
  /**
3246
3248
  * Transcript Segment Partition Kind
3247
3249
  *
3248
3250
  * Closed session graph value
3249
3251
  */
3250
- export const zTranscriptSegmentPartitionKind = z.enum(['main', 'history']);
3252
+ export const zTranscriptSegmentPartitionKind = closedSet()(z.enum(['main', 'history']));
3251
3253
  export const zTranscriptSegmentPartition = z.object({
3252
3254
  kind: zTranscriptSegmentPartitionKind,
3253
3255
  sectionIndex: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808).nullish()
@@ -3325,18 +3327,18 @@ export const zTranscriptContentHeader = z.object({
3325
3327
  *
3326
3328
  * License value for the owner transcript update operation: a canonical menu license, or the empty string to clear. Clearing a license that was actually granted is refused, because a granted Creative Commons license is irrevocable.
3327
3329
  */
3328
- export const zTranscriptUpdateLicense = z.enum([
3330
+ export const zTranscriptUpdateLicense = closedSet()(z.enum([
3329
3331
  '',
3330
3332
  'CC0-1.0',
3331
3333
  'CC-BY-4.0',
3332
3334
  'CC-BY-SA-4.0'
3333
- ]);
3335
+ ]));
3334
3336
  /**
3335
3337
  * TranscriptUpdateVisibility
3336
3338
  *
3337
3339
  * Visibility values accepted by the owner transcript update operation. Organization-scoped visibility is deferred and is deliberately not offered here.
3338
3340
  */
3339
- export const zTranscriptUpdateVisibility = z.enum(['private', 'public']);
3341
+ export const zTranscriptUpdateVisibility = closedSet()(z.enum(['private', 'public']));
3340
3342
  export const zOwnerTranscriptUpdateRequest = z.object({
3341
3343
  description: z.string().optional(),
3342
3344
  license: zOwnerUpdateLicenseIntent.optional(),
@@ -3384,11 +3386,11 @@ export const zTranscriptUpdateRequest = z.object({
3384
3386
  *
3385
3387
  * Closed session graph value
3386
3388
  */
3387
- export const zTranscriptUsagePresence = z.enum([
3389
+ export const zTranscriptUsagePresence = closedSet()(z.enum([
3388
3390
  'present',
3389
3391
  'empty',
3390
3392
  'unknown'
3391
- ]);
3393
+ ]));
3392
3394
  export const zTranscriptHistorySection = z.object({
3393
3395
  index: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
3394
3396
  state: z.string().optional(),
@@ -3401,7 +3403,7 @@ export const zTranscriptHistorySection = z.object({
3401
3403
  *
3402
3404
  * Closed session graph value
3403
3405
  */
3404
- export const zTranscriptViewerProjection = z.enum(['anonymous', 'authenticated']);
3406
+ export const zTranscriptViewerProjection = closedSet()(z.enum(['anonymous', 'authenticated']));
3405
3407
  export const zTranscriptWindow = z.object({
3406
3408
  anchorTurn: z.int().gte(0).lte(9007199254740991),
3407
3409
  firstTurn: z.int().gte(0).lte(9007199254740991),
@@ -3424,7 +3426,7 @@ export const zTrendsPayload = z.object({
3424
3426
  *
3425
3427
  * Kind of one ordered turn content part: text or image
3426
3428
  */
3427
- export const zTurnPartType = z.enum(['text', 'image']);
3429
+ export const zTurnPartType = closedSet()(z.enum(['text', 'image']));
3428
3430
  export const zTurnContentPart = z.object({
3429
3431
  image: zImagePart.optional(),
3430
3432
  text: z.string().optional(),
@@ -3487,11 +3489,11 @@ export const zTurnContentPart = z.object({
3487
3489
  *
3488
3490
  * Who created an annotation type: system (built-in), user (individual), or group (shared)
3489
3491
  */
3490
- export const zTypeOrigin = z.enum([
3492
+ export const zTypeOrigin = closedSet()(z.enum([
3491
3493
  'system',
3492
3494
  'user',
3493
3495
  'group'
3494
- ]);
3496
+ ]));
3495
3497
  export const zUICapabilitiesResponse = z.object({
3496
3498
  uiCapabilities: z.array(z.string()).optional()
3497
3499
  }).strict();
@@ -3580,22 +3582,22 @@ export const zSessionPullRequestsResponse = z.object({
3580
3582
  *
3581
3583
  * Completeness of the five base token fields
3582
3584
  */
3583
- export const zUsageCompleteness = z.enum([
3585
+ export const zUsageCompleteness = closedSet()(z.enum([
3584
3586
  'complete',
3585
3587
  'partial',
3586
3588
  'unknown'
3587
- ]);
3589
+ ]));
3588
3590
  export const zUsageOwnerID = z.string().nullable();
3589
3591
  /**
3590
3592
  * Usage Scope
3591
3593
  *
3592
3594
  * Native owner scope for detailed token and cost evidence
3593
3595
  */
3594
- export const zUsageScope = z.enum([
3596
+ export const zUsageScope = closedSet()(z.enum([
3595
3597
  'assistant',
3596
3598
  'tool',
3597
3599
  'summary'
3598
- ]);
3600
+ ]));
3599
3601
  export const zUsageDetail = z.object({
3600
3602
  completeness: zUsageCompleteness,
3601
3603
  cost: zRecordedCostDetail.nullish(),
@@ -3777,7 +3779,7 @@ export const zTranscriptContent = z.object({
3777
3779
  *
3778
3780
  * ISO 11179 value domain: enumerated (finite allowed set) or described (range/pattern constraint)
3779
3781
  */
3780
- export const zValueDomainKind = z.enum(['enumerated', 'described']);
3782
+ export const zValueDomainKind = closedSet()(z.enum(['enumerated', 'described']));
3781
3783
  export const zValueDomain = z.object({
3782
3784
  constraintSpec: z.string().optional(),
3783
3785
  datatype: zAnnotationDatatype,
@@ -3813,7 +3815,7 @@ export const zTaxonomyNode = z.object({
3813
3815
  *
3814
3816
  * Collective roles an owner may assign through the member role endpoint
3815
3817
  */
3816
- export const zVillageAssignableCollectiveRole = z.enum(['contributor', 'member']);
3818
+ export const zVillageAssignableCollectiveRole = closedSet()(z.enum(['contributor', 'member']));
3817
3819
  export const zVillageAvailableRepository = z.object({
3818
3820
  is_private: z.boolean(),
3819
3821
  name: z.string(),
@@ -3837,21 +3839,21 @@ export const zVillageBatchShareRequest = z.object({
3837
3839
  *
3838
3840
  * How a collective accepts new members and contributions
3839
3841
  */
3840
- export const zVillageCollectiveAcceptanceMode = z.enum([
3842
+ export const zVillageCollectiveAcceptanceMode = closedSet()(z.enum([
3841
3843
  'open',
3842
3844
  'verified_only',
3843
3845
  'curated'
3844
- ]);
3846
+ ]));
3845
3847
  /**
3846
3848
  * Village Group Data Access
3847
3849
  *
3848
3850
  * Who may read a collective's pooled transcript data
3849
3851
  */
3850
- export const zVillageCollectiveDataAccess = z.enum([
3852
+ export const zVillageCollectiveDataAccess = closedSet()(z.enum([
3851
3853
  'members_only',
3852
3854
  'contributors',
3853
3855
  'public'
3854
- ]);
3856
+ ]));
3855
3857
  export const zVillageCollectiveInvitationRequest = z.object({
3856
3858
  username: z.string().min(1)
3857
3859
  });
@@ -3870,12 +3872,12 @@ export const zVillageCollectiveModelBreakdown = z.object({
3870
3872
  *
3871
3873
  * A user's role in one collective
3872
3874
  */
3873
- export const zVillageCollectiveRole = z.enum([
3875
+ export const zVillageCollectiveRole = closedSet()(z.enum([
3874
3876
  'owner',
3875
3877
  'member',
3876
3878
  'contributor',
3877
3879
  'pending'
3878
- ]);
3880
+ ]));
3879
3881
  export const zVillageCollectiveStatusRoleResponse = z.object({
3880
3882
  role: zVillageCollectiveRole,
3881
3883
  status: z.string()
@@ -3893,19 +3895,19 @@ export const zVillageCollectiveTranscriptStats = z.object({
3893
3895
  *
3894
3896
  * The caller's role in a collective, or an empty string when the caller has none
3895
3897
  */
3896
- export const zVillageCollectiveViewerRole = z.enum([
3898
+ export const zVillageCollectiveViewerRole = closedSet()(z.enum([
3897
3899
  '',
3898
3900
  'owner',
3899
3901
  'member',
3900
3902
  'contributor',
3901
3903
  'pending'
3902
- ]);
3904
+ ]));
3903
3905
  /**
3904
3906
  * Village Contribution Status
3905
3907
  *
3906
3908
  * Status assigned when a new collective contribution is opened
3907
3909
  */
3908
- export const zVillageContributionStatus = z.enum(['approved', 'pending']);
3910
+ export const zVillageContributionStatus = closedSet()(z.enum(['approved', 'pending']));
3909
3911
  export const zVillageBatchShareEntry = z.object({
3910
3912
  status: zVillageContributionStatus,
3911
3913
  transcript_id: zTranscriptID
@@ -3962,19 +3964,19 @@ export const zVillageNotificationEmail = z.object({
3962
3964
  *
3963
3965
  * Which source tier produced a resolved project display name
3964
3966
  */
3965
- export const zVillageProjectNameSource = z.enum([
3967
+ export const zVillageProjectNameSource = closedSet()(z.enum([
3966
3968
  'override',
3967
3969
  'consented',
3968
3970
  'remote',
3969
3971
  'path',
3970
3972
  'privacy'
3971
- ]);
3973
+ ]));
3972
3974
  /**
3973
3975
  * Village Prompts Check Mode
3974
3976
  *
3975
3977
  * Check-run conclusion policy for a collective's linked repositories when no prompts are attached
3976
3978
  */
3977
- export const zVillagePromptsCheckMode = z.enum(['informational', 'required']);
3979
+ export const zVillagePromptsCheckMode = closedSet()(z.enum(['informational', 'required']));
3978
3980
  /**
3979
3981
  * Village Public Owner
3980
3982
  *
@@ -4063,19 +4065,19 @@ export const zVillagePendingShare = z.object({
4063
4065
  *
4064
4066
  * How a person is shown to the viewer: their public profile, or anonymous. Readers treat a kind they do not know as anonymous.
4065
4067
  */
4066
- export const zVillagePublicOwnerKind = z.enum(['profile', 'anonymous']);
4068
+ export const zVillagePublicOwnerKind = closedSet()(z.enum(['profile', 'anonymous']));
4067
4069
  /**
4068
4070
  * Village Pull Request Attachment State
4069
4071
  *
4070
4072
  * Current lifecycle state of a pull request's prompt attachment
4071
4073
  */
4072
- export const zVillagePullRequestAttachmentState = z.enum([
4074
+ export const zVillagePullRequestAttachmentState = closedSet()(z.enum([
4073
4075
  'requested',
4074
4076
  'waiting',
4075
4077
  'preview',
4076
4078
  'attached',
4077
4079
  'detached'
4078
- ]);
4080
+ ]));
4079
4081
  export const zVillagePromptRequest = z.object({
4080
4082
  head_remote: z.string(),
4081
4083
  name: z.string(),
@@ -4122,7 +4124,7 @@ export const zVillageRepositoryCommitsResponse = z.object({
4122
4124
  *
4123
4125
  * Decision applied by a collective owner to pending submissions
4124
4126
  */
4125
- export const zVillageReviewDecision = z.enum(['approved', 'rejected']);
4127
+ export const zVillageReviewDecision = closedSet()(z.enum(['approved', 'rejected']));
4126
4128
  export const zVillageBatchReviewRequest = z.object({
4127
4129
  status: zVillageReviewDecision,
4128
4130
  transcript_ids: z.array(zTranscriptID)
@@ -4141,24 +4143,24 @@ export const zVillageSetNotificationEmailRequest = z.object({
4141
4143
  *
4142
4144
  * Actor class that decided one collective share event
4143
4145
  */
4144
- export const zVillageShareEventActor = z.enum([
4146
+ export const zVillageShareEventActor = closedSet()(z.enum([
4145
4147
  '',
4146
4148
  'owner',
4147
4149
  'collective',
4148
4150
  'moderator'
4149
- ]);
4151
+ ]));
4150
4152
  /**
4151
4153
  * Village Share Status
4152
4154
  *
4153
4155
  * Status of one collective share-attempt event. Pending, approved, and rejected can appear in current projections; retracted and revoked are terminal ledger states.
4154
4156
  */
4155
- export const zVillageShareStatus = z.enum([
4157
+ export const zVillageShareStatus = closedSet()(z.enum([
4156
4158
  'pending',
4157
4159
  'approved',
4158
4160
  'rejected',
4159
4161
  'retracted',
4160
4162
  'revoked'
4161
- ]);
4163
+ ]));
4162
4164
  export const zVillageShareEvent = z.object({
4163
4165
  decided_at: z.iso.datetime().regex(/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,9})?Z$/).nullable(),
4164
4166
  decided_by_actor: zVillageShareEventActor,
@@ -4189,7 +4191,7 @@ export const zVillageStatusResponse = z.object({
4189
4191
  *
4190
4192
  * Whether leaving a collective retracts contributed transcripts by default
4191
4193
  */
4192
- export const zVillageTranscriptDeletionPolicy = z.enum(['user_choice', 'mandatory']);
4194
+ export const zVillageTranscriptDeletionPolicy = closedSet()(z.enum(['user_choice', 'mandatory']));
4193
4195
  export const zVillageTranscriptIntegrity = z.object({
4194
4196
  flagged_turns: z.array(z.int().gte(0).lte(9007199254740991))
4195
4197
  }).strict();
@@ -4210,11 +4212,11 @@ export const zVillageTranscriptPullRequestsResponse = z.object({
4210
4212
  *
4211
4213
  * Village transcript visibility as stored and served by web routes
4212
4214
  */
4213
- export const zVillageTranscriptVisibility = z.enum([
4215
+ export const zVillageTranscriptVisibility = closedSet()(z.enum([
4214
4216
  'private',
4215
4217
  'shared',
4216
4218
  'public'
4217
- ]);
4219
+ ]));
4218
4220
  export const zVillageCollectiveTranscript = z.object({
4219
4221
  blob_size_bytes: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808).nullable(),
4220
4222
  compute_version: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808).nullable(),
@@ -5162,11 +5164,11 @@ export const zVillageVisibleCollective = z.object({
5162
5164
  *
5163
5165
  * Access control level for a published transcript
5164
5166
  */
5165
- export const zVisibility = z.enum([
5167
+ export const zVisibility = closedSet()(z.enum([
5166
5168
  'private',
5167
5169
  'group',
5168
5170
  'public'
5169
- ]);
5171
+ ]));
5170
5172
  export const zLegacyPullTranscriptInfo = z.object({
5171
5173
  annotationCount: z.number().refine(Number.isInteger).gte(-9223372036854775808).lte(9223372036854775808),
5172
5174
  contentHash: z.string().optional(),
@@ -5273,7 +5275,7 @@ export const zPullListResponse = z.object({
5273
5275
  *
5274
5276
  * Optional desired final access for legacy compatibility; content replacement remains private and widening occurs separately
5275
5277
  */
5276
- export const zVisibilityIntent = z.enum(['private', 'public']);
5278
+ export const zVisibilityIntent = closedSet()(z.enum(['private', 'public']));
5277
5279
  export const zAuthoritativePublishRequest = z.object({
5278
5280
  client: zAuthoritativeClientInfo.optional(),
5279
5281
  contentHash: zTranscriptContentHash,