@peasant-labs/schema 0.1.0-rc10

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 (37) hide show
  1. package/LICENSE +13 -0
  2. package/README.md +66 -0
  3. package/dist/fixtures/quality.d.ts +81 -0
  4. package/dist/fixtures/quality.js +36 -0
  5. package/dist/fixtures/timeline.d.ts +53 -0
  6. package/dist/fixtures/timeline.js +2 -0
  7. package/dist/fixtures.d.ts +2 -0
  8. package/dist/fixtures.js +2 -0
  9. package/dist/index.d.ts +8 -0
  10. package/dist/index.js +36 -0
  11. package/dist/internal/generated/contract/zod.gen.d.ts +3441 -0
  12. package/dist/internal/generated/contract/zod.gen.js +1623 -0
  13. package/dist/internal/generated/enums.gen.d.ts +406 -0
  14. package/dist/internal/generated/enums.gen.js +445 -0
  15. package/dist/internal/generated/local-api.d.ts +1047 -0
  16. package/dist/internal/generated/local-api.js +1 -0
  17. package/dist/internal/generated/public-contract.gen.d.ts +2 -0
  18. package/dist/internal/generated/public-contract.gen.js +2 -0
  19. package/dist/internal/generated/quality-fixtures.gen.d.ts +2 -0
  20. package/dist/internal/generated/quality-fixtures.gen.js +367 -0
  21. package/dist/internal/generated/testcase.gen.d.ts +17 -0
  22. package/dist/internal/generated/testcase.gen.js +20 -0
  23. package/dist/internal/generated/timeline-fixtures.gen.d.ts +2 -0
  24. package/dist/internal/generated/timeline-fixtures.gen.js +1554 -0
  25. package/dist/internal/generated/versions.gen.d.ts +4 -0
  26. package/dist/internal/generated/versions.gen.js +5 -0
  27. package/dist/internal/generated/village-api.d.ts +652 -0
  28. package/dist/internal/generated/village-api.js +1 -0
  29. package/dist/local-api.d.ts +4 -0
  30. package/dist/local-api.js +1 -0
  31. package/dist/testcase.d.ts +32 -0
  32. package/dist/testcase.js +144 -0
  33. package/dist/types.d.ts +2 -0
  34. package/dist/types.js +2 -0
  35. package/dist/village-api.d.ts +4 -0
  36. package/dist/village-api.js +1 -0
  37. package/package.json +75 -0
@@ -0,0 +1,1047 @@
1
+ import type * as Schema from "../../index.js";
2
+ export interface paths {
3
+ "/api/v1/annotation-types": {
4
+ parameters: {
5
+ query?: never;
6
+ header?: never;
7
+ path?: never;
8
+ cookie?: never;
9
+ };
10
+ /** @description List all registered annotation types. */
11
+ get: operations["listAnnotationTypes"];
12
+ put?: never;
13
+ post?: never;
14
+ delete?: never;
15
+ options?: never;
16
+ head?: never;
17
+ patch?: never;
18
+ trace?: never;
19
+ };
20
+ "/api/v1/annotations": {
21
+ parameters: {
22
+ query?: never;
23
+ header?: never;
24
+ path?: never;
25
+ cookie?: never;
26
+ };
27
+ /** @description List annotations for a session. */
28
+ get: operations["listAnnotations"];
29
+ put?: never;
30
+ /** @description Create a new annotation. */
31
+ post: operations["createAnnotation"];
32
+ delete?: never;
33
+ options?: never;
34
+ head?: never;
35
+ patch?: never;
36
+ trace?: never;
37
+ };
38
+ "/api/v1/config/mock": {
39
+ parameters: {
40
+ query?: never;
41
+ header?: never;
42
+ path?: never;
43
+ cookie?: never;
44
+ };
45
+ /** @description Get mock data configuration. */
46
+ get: operations["getMockConfig"];
47
+ put?: never;
48
+ post?: never;
49
+ delete?: never;
50
+ options?: never;
51
+ head?: never;
52
+ patch?: never;
53
+ trace?: never;
54
+ };
55
+ "/api/v1/health": {
56
+ parameters: {
57
+ query?: never;
58
+ header?: never;
59
+ path?: never;
60
+ cookie?: never;
61
+ };
62
+ /** @description Health check endpoint. */
63
+ get: operations["getHealth"];
64
+ put?: never;
65
+ post?: never;
66
+ delete?: never;
67
+ options?: never;
68
+ head?: never;
69
+ patch?: never;
70
+ trace?: never;
71
+ };
72
+ "/api/v1/map/{projectHash}": {
73
+ parameters: {
74
+ query?: never;
75
+ header?: never;
76
+ path?: never;
77
+ cookie?: never;
78
+ };
79
+ /** @description Get the full map graph for a project (optionally at a commit). */
80
+ get: operations["getMapGraph"];
81
+ put?: never;
82
+ post?: never;
83
+ delete?: never;
84
+ options?: never;
85
+ head?: never;
86
+ patch?: never;
87
+ trace?: never;
88
+ };
89
+ "/api/v1/map/{projectHash}/node": {
90
+ parameters: {
91
+ query?: never;
92
+ header?: never;
93
+ path?: never;
94
+ cookie?: never;
95
+ };
96
+ /** @description Get the rail panel detail for one map node. */
97
+ get: operations["getMapNodeDetail"];
98
+ put?: never;
99
+ post?: never;
100
+ delete?: never;
101
+ options?: never;
102
+ head?: never;
103
+ patch?: never;
104
+ trace?: never;
105
+ };
106
+ "/api/v1/map/{projectHash}/tasks": {
107
+ parameters: {
108
+ query?: never;
109
+ header?: never;
110
+ path?: never;
111
+ cookie?: never;
112
+ };
113
+ /** @description List a project's tasks (reverse-chronological, cap 500). */
114
+ get: operations["listProjectTasks"];
115
+ put?: never;
116
+ post?: never;
117
+ delete?: never;
118
+ options?: never;
119
+ head?: never;
120
+ patch?: never;
121
+ trace?: never;
122
+ };
123
+ "/api/v1/projects/resolve": {
124
+ parameters: {
125
+ query?: never;
126
+ header?: never;
127
+ path?: never;
128
+ cookie?: never;
129
+ };
130
+ /** @description Resolve one explicit project display identity without enumerating sibling projects. */
131
+ get: operations["resolveProject"];
132
+ put?: never;
133
+ post?: never;
134
+ delete?: never;
135
+ options?: never;
136
+ head?: never;
137
+ patch?: never;
138
+ trace?: never;
139
+ };
140
+ "/api/v1/projects/summary": {
141
+ parameters: {
142
+ query?: never;
143
+ header?: never;
144
+ path?: never;
145
+ cookie?: never;
146
+ };
147
+ /** @description List per-project summary rows for the home picker (sessions, recorded coverage, last work, open changes). */
148
+ get: operations["listProjectSummaries"];
149
+ put?: never;
150
+ post?: never;
151
+ delete?: never;
152
+ options?: never;
153
+ head?: never;
154
+ patch?: never;
155
+ trace?: never;
156
+ };
157
+ "/api/v1/review/{projectHash}": {
158
+ parameters: {
159
+ query?: never;
160
+ header?: never;
161
+ path?: never;
162
+ cookie?: never;
163
+ };
164
+ /** @description List a project's changes (open branches, then merged). */
165
+ get: operations["listReviewChanges"];
166
+ put?: never;
167
+ post?: never;
168
+ delete?: never;
169
+ options?: never;
170
+ head?: never;
171
+ patch?: never;
172
+ trace?: never;
173
+ };
174
+ "/api/v1/review/{projectHash}/change": {
175
+ parameters: {
176
+ query?: never;
177
+ header?: never;
178
+ path?: never;
179
+ cookie?: never;
180
+ };
181
+ /** @description Get the Review detail payload for one branch. */
182
+ get: operations["getChangeDetail"];
183
+ put?: never;
184
+ post?: never;
185
+ delete?: never;
186
+ options?: never;
187
+ head?: never;
188
+ patch?: never;
189
+ trace?: never;
190
+ };
191
+ "/api/v1/review/{projectHash}/diff": {
192
+ parameters: {
193
+ query?: never;
194
+ header?: never;
195
+ path?: never;
196
+ cookie?: never;
197
+ };
198
+ /** @description Get the rendered per-file unified diff for one changed file of a branch. */
199
+ get: operations["getChangeDiff"];
200
+ put?: never;
201
+ post?: never;
202
+ delete?: never;
203
+ options?: never;
204
+ head?: never;
205
+ patch?: never;
206
+ trace?: never;
207
+ };
208
+ "/api/v1/search": {
209
+ parameters: {
210
+ query?: never;
211
+ header?: never;
212
+ path?: never;
213
+ cookie?: never;
214
+ };
215
+ /** @description Full-text search across recorded (redacted) message entries; matches the first ~2000 chars of each turn plus truncated tool input/output. */
216
+ get: operations["searchMessages"];
217
+ put?: never;
218
+ post?: never;
219
+ delete?: never;
220
+ options?: never;
221
+ head?: never;
222
+ patch?: never;
223
+ trace?: never;
224
+ };
225
+ "/api/v1/sessions": {
226
+ parameters: {
227
+ query?: never;
228
+ header?: never;
229
+ path?: never;
230
+ cookie?: never;
231
+ };
232
+ /** @description List session summaries. */
233
+ get: operations["listSessions"];
234
+ put?: never;
235
+ post?: never;
236
+ delete?: never;
237
+ options?: never;
238
+ head?: never;
239
+ patch?: never;
240
+ trace?: never;
241
+ };
242
+ "/api/v1/sessions/{id}": {
243
+ parameters: {
244
+ query?: never;
245
+ header?: never;
246
+ path?: never;
247
+ cookie?: never;
248
+ };
249
+ /** @description Get session detail by ID. */
250
+ get: operations["getSession"];
251
+ put?: never;
252
+ post?: never;
253
+ delete?: never;
254
+ options?: never;
255
+ head?: never;
256
+ patch?: never;
257
+ trace?: never;
258
+ };
259
+ "/api/v1/shutdown": {
260
+ parameters: {
261
+ query?: never;
262
+ header?: never;
263
+ path?: never;
264
+ cookie?: never;
265
+ };
266
+ get?: never;
267
+ put?: never;
268
+ /** @description Gracefully shutdown the server (localhost only). */
269
+ post: operations["postShutdown"];
270
+ delete?: never;
271
+ options?: never;
272
+ head?: never;
273
+ patch?: never;
274
+ trace?: never;
275
+ };
276
+ }
277
+ export type webhooks = Record<string, never>;
278
+ export interface components {
279
+ schemas: {
280
+ AnnotationsPayload: Schema.AnnotationsPayload;
281
+ /**
282
+ * Harness
283
+ * @description AI coding tool or development environment
284
+ * @example claude-code
285
+ * @example opencode
286
+ * @enum {string}
287
+ */
288
+ BestiaryHarness: Schema.Harness;
289
+ ClientMessage: Schema.ClientMessage;
290
+ DashboardPayload: Schema.DashboardPayload;
291
+ QualityPayload: Schema.QualityPayload;
292
+ SchemaActivityEdge: Schema.ActivityEdge;
293
+ /**
294
+ * Annotation Axis
295
+ * @description Subscription dimension for annotation channels
296
+ * @example type
297
+ * @example session
298
+ * @example project
299
+ * @enum {string}
300
+ */
301
+ SchemaAnnotationAxis: Schema.AnnotationAxis;
302
+ /**
303
+ * Annotation Datatype
304
+ * @description Storage type for annotation values (maps to SQLite STRICT column type)
305
+ * @example text
306
+ * @example integer
307
+ * @enum {string}
308
+ */
309
+ SchemaAnnotationDatatype: Schema.AnnotationDatatype;
310
+ /**
311
+ * Annotation Status
312
+ * @description ISO 11179 lifecycle state of an annotation type
313
+ * @example active
314
+ * @example deprecated
315
+ * @enum {string}
316
+ */
317
+ SchemaAnnotationStatus: Schema.AnnotationStatus;
318
+ SchemaAnnotationSummary: Schema.AnnotationSummary;
319
+ SchemaAnnotationTypeSummary: Schema.AnnotationTypeSummary;
320
+ /**
321
+ * Annotator Kind
322
+ * @description Type of entity that produced an annotation: human, agent (AI model), or rule (automated classifier)
323
+ * @example human
324
+ * @example agent
325
+ * @example rule
326
+ * @enum {string}
327
+ */
328
+ SchemaAnnotatorKind: Schema.AnnotatorKind;
329
+ /**
330
+ * Association Conclusion
331
+ * @description Producer-supplied conclusion for a session-to-commit association: confirmed or candidate
332
+ * @example confirmed
333
+ * @example candidate
334
+ * @enum {string}
335
+ */
336
+ SchemaAssociationConclusion: Schema.AssociationConclusion;
337
+ /**
338
+ * Association Evidence Kind
339
+ * @description Atomic observation supporting a session-to-commit association
340
+ * @example recorded_commit
341
+ * @example touched_file
342
+ * @example branch_membership
343
+ * @example time_window
344
+ * @enum {string}
345
+ */
346
+ SchemaAssociationEvidenceKind: Schema.AssociationEvidenceKind;
347
+ SchemaAssociationEvidenceObservation: Schema.AssociationEvidenceObservation;
348
+ /**
349
+ * Association ID
350
+ * @description Opaque durable Peasant identifier for one session-to-commit association
351
+ * @example assoc-20260726:session-a:commit-1
352
+ */
353
+ SchemaAssociationID: Schema.AssociationID;
354
+ /**
355
+ * Change Binding
356
+ * @description Strength of the evidence connecting a recorded session to a code change
357
+ * @example bound
358
+ * @example candidate
359
+ * @enum {string}
360
+ */
361
+ SchemaChangeBinding: Schema.ChangeBinding;
362
+ SchemaChangeDetailPayload: Schema.ChangeDetailPayload;
363
+ SchemaChangeDiffPayload: Schema.ChangeDiffPayload;
364
+ SchemaChangeSession: Schema.ChangeSession;
365
+ SchemaChangeSummary: Schema.ChangeSummary;
366
+ SchemaChannelSubscription: Schema.ChannelSubscription;
367
+ /**
368
+ * Channel Topic
369
+ * @description Subscribable WebSocket data stream
370
+ * @example dashboard
371
+ * @example sessions
372
+ * @example session_detail
373
+ * @example trends
374
+ * @example quality
375
+ * @example annotations
376
+ * @example project_familiarity
377
+ * @enum {string}
378
+ */
379
+ SchemaChannelTopic: Schema.ChannelTopic;
380
+ SchemaChildSessionRef: Schema.ChildSessionRef;
381
+ SchemaCommitRef: Schema.CommitRef;
382
+ /**
383
+ * Confidence
384
+ * @description Strength of evidence behind a derived relationship: high, medium, or low
385
+ * @example high
386
+ * @example medium
387
+ * @example low
388
+ * @enum {string}
389
+ */
390
+ SchemaConfidence: Schema.Confidence;
391
+ SchemaCreateAnnotationRequest: Schema.CreateAnnotationRequest;
392
+ SchemaCreateAnnotationResponse: Schema.CreateAnnotationResponse;
393
+ SchemaDayStats: Schema.DayStats;
394
+ SchemaDiffHunk: Schema.DiffHunk;
395
+ SchemaDiffLine: Schema.DiffLine;
396
+ /**
397
+ * Diff Line Kind
398
+ * @description Unified-diff line kind: context, addition, or deletion
399
+ * @example context
400
+ * @example add
401
+ * @example del
402
+ * @enum {string}
403
+ */
404
+ SchemaDiffLineKind: Schema.DiffLineKind;
405
+ SchemaEdgeViolation: Schema.EdgeViolation;
406
+ /**
407
+ * Edge Violation Kind
408
+ * @description Structural violation detected on a map edge
409
+ * @example cycle
410
+ * @example wrong_way
411
+ * @enum {string}
412
+ */
413
+ SchemaEdgeViolationKind: Schema.EdgeViolationKind;
414
+ /**
415
+ * Entry Type
416
+ * @description Classification of a single entry within an agent session transcript
417
+ * @example text
418
+ * @example tool_use
419
+ * @example tool_result
420
+ * @enum {string}
421
+ */
422
+ SchemaEntryType: Schema.EntryType;
423
+ SchemaFileChange: Schema.FileChange;
424
+ /**
425
+ * File Change Status
426
+ * @description Git file delta status: modified, added, deleted, or renamed
427
+ * @example M
428
+ * @example A
429
+ * @example D
430
+ * @example R
431
+ * @enum {string}
432
+ */
433
+ SchemaFileChangeStatus: Schema.FileChangeStatus;
434
+ SchemaFrictionCluster: Schema.FrictionCluster;
435
+ SchemaHealthResponse: Schema.HealthResponse;
436
+ SchemaInsightClassification: Schema.InsightClassification;
437
+ SchemaInsightEvidence: Schema.InsightEvidence;
438
+ /**
439
+ * Insight Kind
440
+ * @description What a SessionInsight observed: a decision, friction, an unusual rate elevation, or a retry loop
441
+ * @example decision
442
+ * @example friction
443
+ * @example unusual
444
+ * @example retry_loop
445
+ * @enum {string}
446
+ */
447
+ SchemaInsightKind: Schema.InsightKind;
448
+ /**
449
+ * Insight Provenance
450
+ * @description How a SessionInsight was produced: mechanical (rule-derived) or mined
451
+ * @example mechanical
452
+ * @example mined
453
+ * @enum {string}
454
+ */
455
+ SchemaInsightProvenance: Schema.InsightProvenance;
456
+ SchemaMapEdge: Schema.MapEdge;
457
+ SchemaMapGraphPayload: Schema.MapGraphPayload;
458
+ SchemaMapNode: Schema.MapNode;
459
+ SchemaMapNodeDetailPayload: Schema.MapNodeDetailPayload;
460
+ /**
461
+ * Map Node Kind
462
+ * @description Path-derived map node classification
463
+ * @example module
464
+ * @example package
465
+ * @example file
466
+ * @enum {string}
467
+ */
468
+ SchemaMapNodeKind: Schema.MapNodeKind;
469
+ SchemaMapSlice: Schema.MapSlice;
470
+ /**
471
+ * Message Type
472
+ * @description WebSocket message discriminator
473
+ * @example subscribe
474
+ * @example unsubscribe
475
+ * @example dashboard
476
+ * @example sessions
477
+ * @example session_detail
478
+ * @example trends
479
+ * @example quality
480
+ * @example annotations
481
+ * @example project_familiarity
482
+ * @example connected
483
+ * @example error
484
+ * @enum {string}
485
+ */
486
+ SchemaMessageType: Schema.MessageType;
487
+ SchemaMockConfigResponse: Schema.MockConfigResponse;
488
+ /**
489
+ * Project Hash
490
+ * @description SHA-256 hex digest of the project's origin URL or local path
491
+ * @example a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2
492
+ */
493
+ SchemaProjectHash: Schema.ProjectHash;
494
+ SchemaProjectResolutionPayload: Schema.ProjectResolutionPayload;
495
+ SchemaProjectSummariesPayload: Schema.ProjectSummariesPayload;
496
+ SchemaProjectSummary: Schema.ProjectSummary;
497
+ SchemaProjectTasksPayload: Schema.ProjectTasksPayload;
498
+ SchemaProvenance: Schema.Provenance;
499
+ SchemaQualitySession: Schema.QualitySession;
500
+ /**
501
+ * Read Attribution State
502
+ * @description Whether per-file read attribution is recoverable for a node's editing sessions: complete, partial, or unavailable
503
+ * @example complete
504
+ * @example partial
505
+ * @example unavailable
506
+ * @enum {string}
507
+ */
508
+ SchemaReadAttributionState: Schema.ReadAttributionState;
509
+ /**
510
+ * Read State Grade
511
+ * @description Ordinal explicit read-state act: none, viewed, reviewed, or reviewed_in_detail
512
+ * @example none
513
+ * @example viewed
514
+ * @example reviewed
515
+ * @example reviewed_in_detail
516
+ * @enum {string}
517
+ */
518
+ SchemaReadStateGrade: Schema.ReadStateGrade;
519
+ SchemaReviewListPayload: Schema.ReviewListPayload;
520
+ /**
521
+ * Rewrite Method
522
+ * @description Mechanism the resolver used to map a ghost commit to its successor
523
+ * @example hash
524
+ * @example patch_id
525
+ * @example author_identity
526
+ * @example message_embedded
527
+ * @example temporal
528
+ * @example none
529
+ * @enum {string}
530
+ */
531
+ SchemaRewriteMethod: Schema.RewriteMethod;
532
+ /**
533
+ * Rewrite Resolution
534
+ * @description Whether a ledger-observed commit hash is live, was rewritten, or could not be resolved
535
+ * @example live
536
+ * @example rewritten
537
+ * @example unresolved
538
+ * @enum {string}
539
+ */
540
+ SchemaRewriteResolution: Schema.RewriteResolution;
541
+ SchemaRewrittenCommit: Schema.RewrittenCommit;
542
+ /**
543
+ * Role
544
+ * @description Sender role of a message turn
545
+ * @example user
546
+ * @example assistant
547
+ * @enum {string}
548
+ */
549
+ SchemaRole: Schema.Role;
550
+ /**
551
+ * Scale Kind
552
+ * @description Stevens measurement level: nominal (categories without order), ordinal (ordered categories), continuous (numeric range)
553
+ * @example nominal
554
+ * @example ordinal
555
+ * @example continuous
556
+ * @enum {string}
557
+ */
558
+ SchemaScaleKind: Schema.ScaleKind;
559
+ SchemaSearchPayload: Schema.SearchPayload;
560
+ SchemaSearchResult: Schema.SearchResult;
561
+ SchemaSessionAssociation: Schema.SessionAssociation;
562
+ SchemaSessionDetailPayload: Schema.SessionDetailPayload;
563
+ /**
564
+ * Session ID
565
+ * Format: session-id
566
+ * @description Unique session identifier (UUID, agent-{hex}, ses_{id}, sess_{id} (ACP), msg_{id}, or a Strike session ID)
567
+ * @example 99d59925-36bc-424c-a789-8be54d9702ba
568
+ * @example agent-a3aee4f
569
+ * @example ses_3cd91f52effeXd3QAJ54jOyzv5
570
+ * @example sess_3cd91f52effeXd3QAJ54jOyzv5
571
+ * @example 20260728T123456.123456789Z-ABCDEFGHIJKLMNOPQRST234567
572
+ * @example ABCDEFGHIJKLMNOPQRST234567
573
+ */
574
+ SchemaSessionID: Schema.SessionID;
575
+ SchemaSessionInsight: Schema.SessionInsight;
576
+ /**
577
+ * Session Outcome
578
+ * @description Resolution status of the session
579
+ * @example resolved
580
+ * @example partial
581
+ * @example failed
582
+ * @enum {string}
583
+ */
584
+ SchemaSessionOutcome: Schema.SessionOutcome;
585
+ SchemaSessionScorecard: Schema.SessionScorecard;
586
+ SchemaSessionSummary: Schema.SessionSummary;
587
+ SchemaSessionsPayload: Schema.SessionsPayload;
588
+ SchemaShutdownResponse: Schema.ShutdownResponse;
589
+ /**
590
+ * Stop Reason
591
+ * @description Reason why a session or turn ended (ACP-aligned)
592
+ * @example end_turn
593
+ * @example max_tokens
594
+ * @enum {string}
595
+ */
596
+ SchemaStopReason: Schema.StopReason;
597
+ /**
598
+ * Target Kind
599
+ * @description 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
600
+ * @example session
601
+ * @example entry
602
+ * @example file_version
603
+ * @example association
604
+ * @enum {string}
605
+ */
606
+ SchemaTargetKind: Schema.TargetKind;
607
+ SchemaTaskSummary: Schema.TaskSummary;
608
+ SchemaTimelineSessionRef: Schema.TimelineSessionRef;
609
+ SchemaToolCallDetail: Schema.ToolCallDetail;
610
+ /**
611
+ * Tool Call Kind
612
+ * @description Classification of a tool call, aligned with ACP ToolCallUpdate.kind
613
+ * @example read
614
+ * @example edit
615
+ * @example execute
616
+ * @enum {string}
617
+ */
618
+ SchemaToolCallKind: Schema.ToolCallKind;
619
+ SchemaTurnDetail: Schema.TurnDetail;
620
+ /**
621
+ * Type Origin
622
+ * @description Who created an annotation type: system (built-in), user (individual), or group (shared)
623
+ * @example system
624
+ * @example user
625
+ * @enum {string}
626
+ */
627
+ SchemaTypeOrigin: Schema.TypeOrigin;
628
+ SchemaUnusualSignal: Schema.UnusualSignal;
629
+ SchemaValueDomain: Schema.ValueDomain;
630
+ /**
631
+ * Value Domain Kind
632
+ * @description ISO 11179 value domain: enumerated (finite allowed set) or described (range/pattern constraint)
633
+ * @example enumerated
634
+ * @example described
635
+ * @enum {string}
636
+ */
637
+ SchemaValueDomainKind: Schema.ValueDomainKind;
638
+ ServerMessage: Schema.ServerMessage;
639
+ SessionDetailPayload: Schema.SessionDetailPayload;
640
+ TrendsPayload: Schema.TrendsPayload;
641
+ };
642
+ responses: never;
643
+ parameters: never;
644
+ requestBodies: never;
645
+ headers: never;
646
+ pathItems: never;
647
+ }
648
+ export type $defs = Record<string, never>;
649
+ export interface operations {
650
+ listAnnotationTypes: {
651
+ parameters: {
652
+ query?: {
653
+ /** @description Filter by lifecycle status (active, deprecated, etc.) */
654
+ status?: string;
655
+ /** @description Filter by origin (system, user, group) */
656
+ origin?: string;
657
+ };
658
+ header?: never;
659
+ path?: never;
660
+ cookie?: never;
661
+ };
662
+ requestBody?: never;
663
+ responses: {
664
+ /** @description OK */
665
+ 200: {
666
+ headers: {
667
+ [name: string]: unknown;
668
+ };
669
+ content: {
670
+ "application/json": null | components["schemas"]["SchemaAnnotationTypeSummary"][];
671
+ };
672
+ };
673
+ };
674
+ };
675
+ listAnnotations: {
676
+ parameters: {
677
+ query: {
678
+ /** @description Session ID to filter annotations */
679
+ session_id: string;
680
+ };
681
+ header?: never;
682
+ path?: never;
683
+ cookie?: never;
684
+ };
685
+ requestBody?: never;
686
+ responses: {
687
+ /** @description OK */
688
+ 200: {
689
+ headers: {
690
+ [name: string]: unknown;
691
+ };
692
+ content: {
693
+ "application/json": null | components["schemas"]["SchemaAnnotationSummary"][];
694
+ };
695
+ };
696
+ };
697
+ };
698
+ createAnnotation: {
699
+ parameters: {
700
+ query?: never;
701
+ header?: never;
702
+ path?: never;
703
+ cookie?: never;
704
+ };
705
+ requestBody?: {
706
+ content: {
707
+ "application/json": components["schemas"]["SchemaCreateAnnotationRequest"];
708
+ };
709
+ };
710
+ responses: {
711
+ /** @description Created */
712
+ 201: {
713
+ headers: {
714
+ [name: string]: unknown;
715
+ };
716
+ content: {
717
+ "application/json": components["schemas"]["SchemaCreateAnnotationResponse"];
718
+ };
719
+ };
720
+ };
721
+ };
722
+ getMockConfig: {
723
+ parameters: {
724
+ query?: never;
725
+ header?: never;
726
+ path?: never;
727
+ cookie?: never;
728
+ };
729
+ requestBody?: never;
730
+ responses: {
731
+ /** @description OK */
732
+ 200: {
733
+ headers: {
734
+ [name: string]: unknown;
735
+ };
736
+ content: {
737
+ "application/json": components["schemas"]["SchemaMockConfigResponse"];
738
+ };
739
+ };
740
+ };
741
+ };
742
+ getHealth: {
743
+ parameters: {
744
+ query?: never;
745
+ header?: never;
746
+ path?: never;
747
+ cookie?: never;
748
+ };
749
+ requestBody?: never;
750
+ responses: {
751
+ /** @description OK */
752
+ 200: {
753
+ headers: {
754
+ [name: string]: unknown;
755
+ };
756
+ content: {
757
+ "application/json": components["schemas"]["SchemaHealthResponse"];
758
+ };
759
+ };
760
+ };
761
+ };
762
+ getMapGraph: {
763
+ parameters: {
764
+ query?: {
765
+ /** @description Optional commit SHA to build the graph at (default HEAD) */
766
+ commit?: string;
767
+ };
768
+ header?: never;
769
+ path: {
770
+ /** @description Opaque project hash */
771
+ projectHash: components["schemas"]["SchemaProjectHash"];
772
+ };
773
+ cookie?: never;
774
+ };
775
+ requestBody?: never;
776
+ responses: {
777
+ /** @description OK */
778
+ 200: {
779
+ headers: {
780
+ [name: string]: unknown;
781
+ };
782
+ content: {
783
+ "application/json": components["schemas"]["SchemaMapGraphPayload"];
784
+ };
785
+ };
786
+ };
787
+ };
788
+ getMapNodeDetail: {
789
+ parameters: {
790
+ query: {
791
+ /** @description Repo-relative node ID */
792
+ path: string;
793
+ };
794
+ header?: never;
795
+ path: {
796
+ /** @description Opaque project hash */
797
+ projectHash: components["schemas"]["SchemaProjectHash"];
798
+ };
799
+ cookie?: never;
800
+ };
801
+ requestBody?: never;
802
+ responses: {
803
+ /** @description OK */
804
+ 200: {
805
+ headers: {
806
+ [name: string]: unknown;
807
+ };
808
+ content: {
809
+ "application/json": components["schemas"]["SchemaMapNodeDetailPayload"];
810
+ };
811
+ };
812
+ };
813
+ };
814
+ listProjectTasks: {
815
+ parameters: {
816
+ query?: {
817
+ /** @description Optional file or directory filter */
818
+ file?: string;
819
+ };
820
+ header?: never;
821
+ path: {
822
+ /** @description Opaque project hash */
823
+ projectHash: components["schemas"]["SchemaProjectHash"];
824
+ };
825
+ cookie?: never;
826
+ };
827
+ requestBody?: never;
828
+ responses: {
829
+ /** @description OK */
830
+ 200: {
831
+ headers: {
832
+ [name: string]: unknown;
833
+ };
834
+ content: {
835
+ "application/json": components["schemas"]["SchemaProjectTasksPayload"];
836
+ };
837
+ };
838
+ };
839
+ };
840
+ resolveProject: {
841
+ parameters: {
842
+ query: {
843
+ /** @description Exact project display identity from a saved route */
844
+ name: string;
845
+ };
846
+ header?: never;
847
+ path?: never;
848
+ cookie?: never;
849
+ };
850
+ requestBody?: never;
851
+ responses: {
852
+ /** @description OK */
853
+ 200: {
854
+ headers: {
855
+ [name: string]: unknown;
856
+ };
857
+ content: {
858
+ "application/json": components["schemas"]["SchemaProjectResolutionPayload"];
859
+ };
860
+ };
861
+ };
862
+ };
863
+ listProjectSummaries: {
864
+ parameters: {
865
+ query?: never;
866
+ header?: never;
867
+ path?: never;
868
+ cookie?: never;
869
+ };
870
+ requestBody?: never;
871
+ responses: {
872
+ /** @description OK */
873
+ 200: {
874
+ headers: {
875
+ [name: string]: unknown;
876
+ };
877
+ content: {
878
+ "application/json": components["schemas"]["SchemaProjectSummariesPayload"];
879
+ };
880
+ };
881
+ };
882
+ };
883
+ listReviewChanges: {
884
+ parameters: {
885
+ query?: never;
886
+ header?: never;
887
+ path: {
888
+ /** @description Opaque project hash */
889
+ projectHash: components["schemas"]["SchemaProjectHash"];
890
+ };
891
+ cookie?: never;
892
+ };
893
+ requestBody?: never;
894
+ responses: {
895
+ /** @description OK */
896
+ 200: {
897
+ headers: {
898
+ [name: string]: unknown;
899
+ };
900
+ content: {
901
+ "application/json": components["schemas"]["SchemaReviewListPayload"];
902
+ };
903
+ };
904
+ };
905
+ };
906
+ getChangeDetail: {
907
+ parameters: {
908
+ query: {
909
+ /** @description Branch name (may contain slashes) */
910
+ branch: string;
911
+ };
912
+ header?: never;
913
+ path: {
914
+ /** @description Opaque project hash */
915
+ projectHash: components["schemas"]["SchemaProjectHash"];
916
+ };
917
+ cookie?: never;
918
+ };
919
+ requestBody?: never;
920
+ responses: {
921
+ /** @description OK */
922
+ 200: {
923
+ headers: {
924
+ [name: string]: unknown;
925
+ };
926
+ content: {
927
+ "application/json": components["schemas"]["SchemaChangeDetailPayload"];
928
+ };
929
+ };
930
+ };
931
+ };
932
+ getChangeDiff: {
933
+ parameters: {
934
+ query: {
935
+ /** @description Branch name (may contain slashes) */
936
+ branch: string;
937
+ /** @description Repo-relative file path */
938
+ file: string;
939
+ };
940
+ header?: never;
941
+ path: {
942
+ /** @description Opaque project hash */
943
+ projectHash: components["schemas"]["SchemaProjectHash"];
944
+ };
945
+ cookie?: never;
946
+ };
947
+ requestBody?: never;
948
+ responses: {
949
+ /** @description OK */
950
+ 200: {
951
+ headers: {
952
+ [name: string]: unknown;
953
+ };
954
+ content: {
955
+ "application/json": components["schemas"]["SchemaChangeDiffPayload"];
956
+ };
957
+ };
958
+ };
959
+ };
960
+ searchMessages: {
961
+ parameters: {
962
+ query: {
963
+ /** @description Search query (min 2 chars; whitespace tokens ANDed) */
964
+ q: string;
965
+ /** @description Max results (default 20, capped at 50) */
966
+ limit?: number;
967
+ };
968
+ header?: never;
969
+ path?: never;
970
+ cookie?: never;
971
+ };
972
+ requestBody?: never;
973
+ responses: {
974
+ /** @description OK */
975
+ 200: {
976
+ headers: {
977
+ [name: string]: unknown;
978
+ };
979
+ content: {
980
+ "application/json": components["schemas"]["SchemaSearchPayload"];
981
+ };
982
+ };
983
+ };
984
+ };
985
+ listSessions: {
986
+ parameters: {
987
+ query?: never;
988
+ header?: never;
989
+ path?: never;
990
+ cookie?: never;
991
+ };
992
+ requestBody?: never;
993
+ responses: {
994
+ /** @description OK */
995
+ 200: {
996
+ headers: {
997
+ [name: string]: unknown;
998
+ };
999
+ content: {
1000
+ "application/json": components["schemas"]["SchemaSessionsPayload"];
1001
+ };
1002
+ };
1003
+ };
1004
+ };
1005
+ getSession: {
1006
+ parameters: {
1007
+ query?: never;
1008
+ header?: never;
1009
+ path: {
1010
+ id: string;
1011
+ };
1012
+ cookie?: never;
1013
+ };
1014
+ requestBody?: never;
1015
+ responses: {
1016
+ /** @description OK */
1017
+ 200: {
1018
+ headers: {
1019
+ [name: string]: unknown;
1020
+ };
1021
+ content: {
1022
+ "application/json": components["schemas"]["SchemaSessionDetailPayload"];
1023
+ };
1024
+ };
1025
+ };
1026
+ };
1027
+ postShutdown: {
1028
+ parameters: {
1029
+ query?: never;
1030
+ header?: never;
1031
+ path?: never;
1032
+ cookie?: never;
1033
+ };
1034
+ requestBody?: never;
1035
+ responses: {
1036
+ /** @description OK */
1037
+ 200: {
1038
+ headers: {
1039
+ [name: string]: unknown;
1040
+ };
1041
+ content: {
1042
+ "application/json": components["schemas"]["SchemaShutdownResponse"];
1043
+ };
1044
+ };
1045
+ };
1046
+ };
1047
+ }