@peasant-labs/schema 0.53.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.
@@ -1067,7 +1067,7 @@ export interface paths {
1067
1067
  path?: never;
1068
1068
  cookie?: never;
1069
1069
  };
1070
- /** @description Advertise the annotation schema version plus push and pull contract windows and the deployment-specific content-capability set. contentCapabilities omitted or empty means none and null is invalid. Its items are opaque, forward-open revision strings: clients match exactly without SemVer or suffix parsing, ignore unknown tokens, and tolerate/deduplicate duplicates; server output contains only pinned known tokens, rejects duplicates, has no semantic order, and is serialized lexicographically. observed_model_v1 is required exactly when any root or nested assistant turn carries observedModel, not for session model alone. It guarantees assistant-only value validation before persistence with no invalid database or blob side effects and byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are not guaranteed. */
1070
+ /** @description Advertise the annotation schema version plus push and pull contract windows and the deployment-specific content-capability set. segmentedReadVersion and minSegmentedReadVersion are emitted together or omitted together; a lone member is invalid, and an absent or empty pair means 0.1.0 only. An empty string counts as absent; null and non-string members are invalid. Clients compare these opaque versions by exact token membership, never inferred ordering. contentCapabilities omitted or empty means none and null is invalid. Its items are opaque, forward-open revision strings: clients match exactly without SemVer or suffix parsing, ignore unknown tokens, and tolerate/deduplicate duplicates; server output contains only pinned known tokens, rejects duplicates, has no semantic order, and is serialized lexicographically. observed_model_v1 is required exactly when any root or nested assistant turn carries observedModel, not for session model alone. It guarantees assistant-only value validation before persistence with no invalid database or blob side effects and byte-exact accepted observedModel strings through storage, typed migration, rewrite, serving, and pull; JSON whitespace and key order are not guaranteed. */
1071
1071
  get: operations["getSchemaVersion"];
1072
1072
  put?: never;
1073
1073
  post?: never;
@@ -1135,7 +1135,7 @@ export interface paths {
1135
1135
  path?: never;
1136
1136
  cookie?: never;
1137
1137
  };
1138
- /** @description Get transcript metadata and viewer-authorized relationship navigation. Navigation is read-only and is never stored in transcript content. Nonowner collective associations use the same narrow viewer-visible/contributor-discoverable projection as the dedicated collective read; omitted associations do not disclose hidden existence. Query failures are 500, never successful empty arrays. integrity is present only when the transcript is flagged, for any reader allowed to read the transcript, whatever its visibility; its presence is the flag. Its flagged_turns are zero-based positions in the top-level sessionDetail.turns array (never TurnDetail.index values, never earlierHistory or child sessions) of the content whose bare hash is transcript.content_hash. A reader highlights turns only when the content read's Village-Content-Hash header equals transcript.content_hash. An empty list means the flag stands with no turn flagged in the current copy. A clean, pending or failed check adds nothing. */
1138
+ /** @description Get transcript metadata and viewer-authorized relationship navigation. Navigation is read-only and is never stored in transcript content. Nonowner collective associations use the same narrow viewer-visible/contributor-discoverable projection as the dedicated collective read; omitted associations do not disclose hidden existence. Query failures are 500, never successful empty arrays. integrity is present only when the transcript is flagged, for any reader allowed to read the transcript, whatever its visibility; its presence is the flag. Its flagged_turns are zero-based positions in the top-level sessionDetail.turns array (never TurnDetail.index values, never earlierHistory or child sessions) of the content whose bare hash is transcript.content_hash. The header read's flaggedTurns use served main-partition positions after filtering instead. A reader highlights turns only when the content read's Village-Content-Hash header equals transcript.content_hash. An empty list means the flag stands with no turn flagged in the current copy. A clean, pending or failed check adds nothing. A transcript its publisher retracted answers 410 to its last audience, and 404 to every other viewer and to a retracted private transcript; the pull reads answer 404 in every such case. */
1139
1139
  get: operations["getTranscriptMetadata"];
1140
1140
  put?: never;
1141
1141
  post?: never;
@@ -1170,7 +1170,7 @@ export interface paths {
1170
1170
  path?: never;
1171
1171
  cookie?: never;
1172
1172
  };
1173
- /** @description Get the durable transcript content envelope. This response never includes authorized relationship navigation. When the transcript's owner is anonymous to this viewer, sessionDetail is served without its repository identity: project, workingDirectory, gitBranch, gitRemote and every childSessions[].project are absent. Text inside the conversation is content and is not covered. */
1173
+ /** @description Get the durable transcript content envelope. This response never includes authorized relationship navigation. When the transcript's owner is anonymous to this viewer, sessionDetail is served without its repository identity: project, workingDirectory, gitBranch, gitRemote and every childSessions[].project are absent. Text inside the conversation is content and is not covered. A transcript whose stored content an operator recorded as lost answers 410 after access is decided. */
1174
1174
  get: operations["getTranscriptContent"];
1175
1175
  put?: never;
1176
1176
  post?: never;
@@ -1180,6 +1180,23 @@ export interface paths {
1180
1180
  patch?: never;
1181
1181
  trace?: never;
1182
1182
  };
1183
+ "/api/v1/transcripts/{id}/header": {
1184
+ parameters: {
1185
+ query?: never;
1186
+ header?: never;
1187
+ path?: never;
1188
+ cookie?: never;
1189
+ };
1190
+ /** @description Read bounded session metadata without turns or retained records. The header carries its revision and representation, optional stored-content hash, served-position integrity marks and retained-evidence availability. A mark's turn identity is omitted when the served row has no usable recorded index. The hash and marks are omitted for migrated or repository-withheld projections. Repository fields follow getTranscriptContent's withholding rule. Access, owner visibility and integrity are checked before conditional revalidation; denied viewers receive 404, stale revision or representation receives 409, and a temporary load refusal receives 503 with Retry-After. Successful headers require private revalidation with ETag; refusal responses are no-store. A transcript whose stored content an operator recorded as lost answers 410 after access is decided. */
1191
+ get: operations["getTranscriptHeader"];
1192
+ put?: never;
1193
+ post?: never;
1194
+ delete?: never;
1195
+ options?: never;
1196
+ head?: never;
1197
+ patch?: never;
1198
+ trace?: never;
1199
+ };
1183
1200
  "/api/v1/transcripts/{id}/pulls": {
1184
1201
  parameters: {
1185
1202
  query?: never;
@@ -1204,7 +1221,14 @@ export interface paths {
1204
1221
  path?: never;
1205
1222
  cookie?: never;
1206
1223
  };
1207
- /** @description Read the transcript's segment directory: one ref per segment, each a bounded run of whole turns, and no turn content. It is the same directory type the local dashboard API serves, cut by the shared rule (schema.CutTranscriptSegments with schema.TranscriptSegmentBudgetBytes), so the same turns give the same refs on every server. sessionId is the published session's id. The directory is paged: page is one-based and omitted defaults to 1, and totalSegments counts every page. revision is optional and the current revision is served when it is omitted; a stale revision is a 409 naming both revisions, and a segment cut under another revision must not be placed beside this directory. A non-numeric or non-positive page is a 400. Access follows getTranscriptContent: a transcript this viewer may not read is a 404. */
1224
+ /**
1225
+ * @description Read a transcript's segment directory, without turn content, using the shared whole-turn cut. V1 is unchanged; v=2 opts into the additive positioned protocol. The positioned protocol serves every legacy shape /content serves, preserving route and content identities separately; rows are cooked before cutting and carry their producer-assigned display numbers. Select main or a history section with partition and section. A directory at or below 10000 refs is unpaged; above it each response holds one page of at most 10000 refs with the true total. page is one-based, defaults to 1, is rejected with 400 when invalid, and a page beyond the end is 404 after access is decided. Revision and representation are optional echoes; a mismatch is 409. Access follows getTranscriptContent; a denied viewer receives 404. A temporary load refusal is 503 with Retry-After. A transcript whose stored content an operator recorded as lost answers 410 after access is decided.
1226
+ *
1227
+ * Protocol generation selectors (omission is v=0):
1228
+ * - v=0 -> 0.1.0
1229
+ * - v=1 -> 0.1.0
1230
+ * - v=2 -> 0.2.0
1231
+ */
1208
1232
  get: operations["getTranscriptSegments"];
1209
1233
  put?: never;
1210
1234
  post?: never;
@@ -1214,6 +1238,23 @@ export interface paths {
1214
1238
  patch?: never;
1215
1239
  trace?: never;
1216
1240
  };
1241
+ "/api/v1/transcripts/{id}/segments/locate": {
1242
+ parameters: {
1243
+ query?: never;
1244
+ header?: never;
1245
+ path?: never;
1246
+ cookie?: never;
1247
+ };
1248
+ get?: never;
1249
+ put?: never;
1250
+ /** @description Locate a reference in the served main partition. The request carries the expected revision, representation and public content hash, but no location kind or partition selector. After access and hash verification, the first exact source, tool call or tool result member in served order wins. A denied viewer and a missing reference receive the same non-disclosing 404; the reference is never echoed. A stale revision or representation is 409, and a temporary load refusal is 503 with Retry-After. A transcript whose stored content an operator recorded as lost answers 410 after access is decided. */
1251
+ post: operations["locateTranscriptEntry"];
1252
+ delete?: never;
1253
+ options?: never;
1254
+ head?: never;
1255
+ patch?: never;
1256
+ trace?: never;
1257
+ };
1217
1258
  "/api/v1/transcripts/{id}/segments/{index}": {
1218
1259
  parameters: {
1219
1260
  query?: never;
@@ -1221,7 +1262,14 @@ export interface paths {
1221
1262
  path?: never;
1222
1263
  cookie?: never;
1223
1264
  };
1224
- /** @description Read one transcript segment by its directory ordinal. Every turn it serves is whole, and its firstTurn and lastTurn are exactly the range the directory declared. Each turn row embeds the shared turn detail beside truncated and the pre-bound byteLength. hasOlder and hasNewer say whether the transcript continues on that side. revision is optional and the current revision is served when it is omitted. A non-numeric or negative index is a 400, an index at or past totalSegments is a 404 naming the directory's segment count, and a stale revision is a 409 naming both revisions. A segment that cannot be served whole is refused with 409, never served short. Access and the repository-identity rule follow getTranscriptContent: a transcript this viewer may not read is a 404. */
1265
+ /**
1266
+ * @description Read one whole-turn segment by directory ordinal. V1 is unchanged; its firstTurn and lastTurn match the directory and each turn carries its truncated flag and pre-bound byteLength. A v1 segment that cannot be served whole is refused with 409, never served short. v=2 opts into the additive positioned protocol. The positioned protocol carries the served rows, including each producer-assigned display number, with native records attached to rows in this segment. Legacy turns retain their served shape. Select main or a history section with partition and section. A non-numeric or negative index is 400, an index beyond the directory is 404, and a stale revision or representation is 409. Access and repository withholding follow getTranscriptContent; a denied viewer receives 404. A temporary load refusal is 503 with Retry-After. A transcript whose stored content an operator recorded as lost answers 410 after access is decided.
1267
+ *
1268
+ * Protocol generation selectors (omission is v=0):
1269
+ * - v=0 -> 0.1.0
1270
+ * - v=1 -> 0.1.0
1271
+ * - v=2 -> 0.2.0
1272
+ */
1225
1273
  get: operations["getTranscriptSegment"];
1226
1274
  put?: never;
1227
1275
  post?: never;
@@ -1272,7 +1320,14 @@ export interface paths {
1272
1320
  path?: never;
1273
1321
  cookie?: never;
1274
1322
  };
1275
- /** @description Resolve a turn identity to a contiguous transcript window and answer a descriptor that names where the window is, never what is in it. The rule is the shared one (schema.ResolveTranscriptWindow). anchor is a non-negative turn identity: when the turn there is a user turn it is the anchor, otherwise the read snaps to the nearest lower user turn, or the nearest higher one when none is lower, and requestedAnchor and anchorTurn report both. span is the number of assistant turns collected on each side, 1..10, and omitted defaults to the design value 10; the parameter narrows a window and cannot widen it. segments is the ordered contiguous run of segment ordinals that covers the range; the viewer loads exactly those through getTranscriptSegment. sessionId is the published session's id. revision is optional and the current revision is served when it is omitted. A missing, non-numeric, or negative anchor and a span outside 1..10 are 400; a transcript with no user turn is a 404, because a window requires one; a stale revision is a 409 naming both revisions. Access follows getTranscriptContent: a transcript this viewer may not read is a 404. */
1323
+ /**
1324
+ * @description Resolve a transcript window to a descriptor, never turn content. V1 requires an anchor and retains its existing shared resolver. The positioned protocol is opt-in with v=2, and omitting anchor selects the default window; otherwise the shared positioned resolver snaps the recorded identity to a user row. OpenAPI retains the shared required v1 anchor because one parameter cannot express version-conditional requiredness; the positioned route accepts omission. The contiguous segment run covers the window and the requested row when one exists. span is 1..10 assistant turns on each side, default 10. Select main or a history section with partition and section. Invalid anchor or span is 400; an unresolvable window is 404; a stale revision or representation is 409. Access follows getTranscriptContent; a denied viewer receives 404. A temporary load refusal is 503 with Retry-After. A transcript whose stored content an operator recorded as lost answers 410 after access is decided.
1325
+ *
1326
+ * Protocol generation selectors (omission is v=0):
1327
+ * - v=0 -> 0.1.0
1328
+ * - v=1 -> 0.1.0
1329
+ * - v=2 -> 0.2.0
1330
+ */
1276
1331
  get: operations["getTranscriptWindow"];
1277
1332
  put?: never;
1278
1333
  post?: never;
@@ -1771,6 +1826,10 @@ export interface components {
1771
1826
  * @enum {integer}
1772
1827
  */
1773
1828
  SchemaPageSize: Schema.PageSize;
1829
+ SchemaPositionedDirectory: Schema.PositionedDirectory;
1830
+ SchemaPositionedSegment: Schema.PositionedSegment;
1831
+ SchemaPositionedSegmentRef: Schema.PositionedSegmentRef;
1832
+ SchemaPositionedWindow: Schema.PositionedWindow;
1774
1833
  /**
1775
1834
  * Project Hash
1776
1835
  * @description SHA-256 hex digest of the project's origin URL or local path
@@ -1983,6 +2042,20 @@ export interface components {
1983
2042
  * @description SHA3-256 digest of the exact transcript file bytes
1984
2043
  */
1985
2044
  SchemaTranscriptContentHash: Schema.TranscriptContentHash;
2045
+ SchemaTranscriptContentHeader: Schema.TranscriptContentHeader;
2046
+ SchemaTranscriptEntryLocateRequest: Schema.TranscriptEntryLocateRequest;
2047
+ SchemaTranscriptEntryMatch: Schema.TranscriptEntryMatch;
2048
+ /**
2049
+ * Transcript Entry Reference Kind
2050
+ * @description Closed session graph value
2051
+ * @example source
2052
+ * @example tool_call
2053
+ * @example tool_result
2054
+ * @enum {string}
2055
+ */
2056
+ SchemaTranscriptEntryReferenceKind: Schema.TranscriptEntryReferenceKind;
2057
+ SchemaTranscriptFlaggedTurn: Schema.TranscriptFlaggedTurn;
2058
+ SchemaTranscriptHistorySection: Schema.TranscriptHistorySection;
1986
2059
  /**
1987
2060
  * Transcript ID
1988
2061
  * Format: uuid
@@ -1990,9 +2063,66 @@ export interface components {
1990
2063
  * @example 99d59925-36bc-424c-a789-8be54d9702ba
1991
2064
  */
1992
2065
  SchemaTranscriptID: Schema.TranscriptID;
2066
+ /**
2067
+ * Transcript Native Presence
2068
+ * @description Closed session graph value
2069
+ * @example absent
2070
+ * @example present
2071
+ * @example withheld
2072
+ * @enum {string}
2073
+ */
2074
+ SchemaTranscriptNativePresence: Schema.TranscriptNativePresence;
2075
+ SchemaTranscriptReadContext: Schema.TranscriptReadContext;
2076
+ SchemaTranscriptReadTransport: Schema.TranscriptReadTransport;
2077
+ /**
2078
+ * Transcript Read Transport Kind
2079
+ * @description Closed session graph value
2080
+ * @example local_session
2081
+ * @example village_transcript
2082
+ * @enum {string}
2083
+ */
2084
+ SchemaTranscriptReadTransportKind: Schema.TranscriptReadTransportKind;
2085
+ /**
2086
+ * Transcript Read Validation
2087
+ * @description Closed session graph value
2088
+ * @example published_strict
2089
+ * @example served_legacy
2090
+ * @example migrated
2091
+ * @enum {string}
2092
+ */
2093
+ SchemaTranscriptReadValidation: Schema.TranscriptReadValidation;
2094
+ /**
2095
+ * Transcript Recorded Index State
2096
+ * @description Closed session graph value
2097
+ * @example present
2098
+ * @example absent
2099
+ * @example invalid
2100
+ * @enum {string}
2101
+ */
2102
+ SchemaTranscriptRecordedIndexState: Schema.TranscriptRecordedIndexState;
2103
+ /**
2104
+ * Transcript Retained State
2105
+ * @description Closed session graph value
2106
+ * @example absent
2107
+ * @example deferred
2108
+ * @enum {string}
2109
+ */
2110
+ SchemaTranscriptRetainedState: Schema.TranscriptRetainedState;
1993
2111
  SchemaTranscriptSegment: Schema.TranscriptSegment;
1994
2112
  SchemaTranscriptSegmentDirectory: Schema.TranscriptSegmentDirectory;
2113
+ SchemaTranscriptSegmentPartition: Schema.TranscriptSegmentPartition;
2114
+ /**
2115
+ * Transcript Segment Partition Kind
2116
+ * @description Closed session graph value
2117
+ * @example main
2118
+ * @example history
2119
+ * @enum {string}
2120
+ */
2121
+ SchemaTranscriptSegmentPartitionKind: Schema.TranscriptSegmentPartitionKind;
1995
2122
  SchemaTranscriptSegmentRef: Schema.TranscriptSegmentRef;
2123
+ SchemaTranscriptSegmentRow: Schema.TranscriptSegmentRow;
2124
+ SchemaTranscriptServedTurn: Schema.TranscriptServedTurn;
2125
+ SchemaTranscriptSessionHeader: Schema.TranscriptSessionHeader;
1996
2126
  SchemaTranscriptTurn: Schema.TranscriptTurn;
1997
2127
  /**
1998
2128
  * TranscriptUpdateVisibility
@@ -2002,6 +2132,15 @@ export interface components {
2002
2132
  * @enum {string}
2003
2133
  */
2004
2134
  SchemaTranscriptUpdateVisibility: Schema.TranscriptUpdateVisibility;
2135
+ /**
2136
+ * Transcript Usage Presence
2137
+ * @description Closed session graph value
2138
+ * @example present
2139
+ * @example empty
2140
+ * @example unknown
2141
+ * @enum {string}
2142
+ */
2143
+ SchemaTranscriptUsagePresence: Schema.TranscriptUsagePresence;
2005
2144
  SchemaTranscriptWindow: Schema.TranscriptWindow;
2006
2145
  SchemaTurnContentPart: Schema.TurnContentPart;
2007
2146
  SchemaTurnDetail: Schema.TurnDetail;
@@ -6538,6 +6677,15 @@ export interface operations {
6538
6677
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6539
6678
  };
6540
6679
  };
6680
+ /** @description Gone. The transcript was retracted by its publisher; its content has been deleted and cannot be shown. Only the last audience of the transcript sees this answer; every other viewer receives the same 404 as an unknown id. */
6681
+ 410: {
6682
+ headers: {
6683
+ [name: string]: unknown;
6684
+ };
6685
+ content: {
6686
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6687
+ };
6688
+ };
6541
6689
  /** @description Internal Server Error */
6542
6690
  500: {
6543
6691
  headers: {
@@ -6712,6 +6860,145 @@ export interface operations {
6712
6860
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6713
6861
  };
6714
6862
  };
6863
+ /** @description Gone. The transcript's stored content has been lost and cannot be loaded; an operator recorded the loss. Access is decided first, so a viewer who may not read the transcript receives 404. */
6864
+ 410: {
6865
+ headers: {
6866
+ [name: string]: unknown;
6867
+ };
6868
+ content: {
6869
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6870
+ };
6871
+ };
6872
+ };
6873
+ };
6874
+ getTranscriptHeader: {
6875
+ parameters: {
6876
+ query?: {
6877
+ /** @description Optional revision to read; omission selects the current revision. */
6878
+ revision?: string;
6879
+ /** @description Optional projection identity to revalidate; a mismatch requires reload. */
6880
+ representation?: string;
6881
+ };
6882
+ header?: {
6883
+ /** @description Optional entity tag of the previously authorized header. */
6884
+ "If-None-Match"?: string;
6885
+ };
6886
+ path: {
6887
+ /** @description Transcript identifier */
6888
+ id: components["schemas"]["SchemaTranscriptID"];
6889
+ };
6890
+ cookie?: never;
6891
+ };
6892
+ requestBody?: never;
6893
+ responses: {
6894
+ /** @description OK */
6895
+ 200: {
6896
+ headers: {
6897
+ /** @description private, no-cache when the revision is named; no-store when no revision is named or a migration rewrite was not installed. */
6898
+ "Cache-Control"?: string;
6899
+ /** @description Entity tag over the authorized header's revalidation inputs. */
6900
+ ETag?: string;
6901
+ /** @description Authorization, Cookie */
6902
+ Vary?: string;
6903
+ [name: string]: unknown;
6904
+ };
6905
+ content: {
6906
+ "application/json": components["schemas"]["SchemaTranscriptContentHeader"];
6907
+ };
6908
+ };
6909
+ /** @description Not modified after authorization and revalidation. */
6910
+ 304: {
6911
+ headers: {
6912
+ /** @description private, no-cache when the revision is named; no-store when no revision is named or a migration rewrite was not installed. */
6913
+ "Cache-Control"?: string;
6914
+ /** @description Entity tag over the authorized header's revalidation inputs. */
6915
+ ETag?: string;
6916
+ /** @description Authorization, Cookie */
6917
+ Vary?: string;
6918
+ [name: string]: unknown;
6919
+ };
6920
+ content?: never;
6921
+ };
6922
+ /** @description Bad Request */
6923
+ 400: {
6924
+ headers: {
6925
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6926
+ "Cache-Control"?: string;
6927
+ /** @description Authorization, Cookie */
6928
+ Vary?: string;
6929
+ [name: string]: unknown;
6930
+ };
6931
+ content: {
6932
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6933
+ };
6934
+ };
6935
+ /** @description Not Found */
6936
+ 404: {
6937
+ headers: {
6938
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6939
+ "Cache-Control"?: string;
6940
+ /** @description Authorization, Cookie */
6941
+ Vary?: string;
6942
+ [name: string]: unknown;
6943
+ };
6944
+ content: {
6945
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6946
+ };
6947
+ };
6948
+ /** @description Conflict */
6949
+ 409: {
6950
+ headers: {
6951
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6952
+ "Cache-Control"?: string;
6953
+ /** @description Authorization, Cookie */
6954
+ Vary?: string;
6955
+ [name: string]: unknown;
6956
+ };
6957
+ content: {
6958
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6959
+ };
6960
+ };
6961
+ /** @description Gone. The transcript's stored content has been lost and cannot be loaded; an operator recorded the loss. Access is decided first, so a viewer who may not read the transcript receives 404. */
6962
+ 410: {
6963
+ headers: {
6964
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6965
+ "Cache-Control"?: string;
6966
+ /** @description Authorization, Cookie */
6967
+ Vary?: string;
6968
+ [name: string]: unknown;
6969
+ };
6970
+ content: {
6971
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6972
+ };
6973
+ };
6974
+ /** @description Internal Server Error */
6975
+ 500: {
6976
+ headers: {
6977
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6978
+ "Cache-Control"?: string;
6979
+ /** @description Authorization, Cookie */
6980
+ Vary?: string;
6981
+ [name: string]: unknown;
6982
+ };
6983
+ content: {
6984
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6985
+ };
6986
+ };
6987
+ /** @description Service Unavailable */
6988
+ 503: {
6989
+ headers: {
6990
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6991
+ "Cache-Control"?: string;
6992
+ /** @description When to retry a temporary load or admission refusal. */
6993
+ "Retry-After"?: string;
6994
+ /** @description Authorization, Cookie */
6995
+ Vary?: string;
6996
+ [name: string]: unknown;
6997
+ };
6998
+ content: {
6999
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7000
+ };
7001
+ };
6715
7002
  };
6716
7003
  };
6717
7004
  listTranscriptPullRequests: {
@@ -6780,6 +7067,19 @@ export interface operations {
6780
7067
  page?: number;
6781
7068
  /** @description Revision to read; omitted serves the current revision */
6782
7069
  revision?: string;
7070
+ /**
7071
+ * @description Protocol generation selectors (omission is v=0):
7072
+ * - v=0 -> 0.1.0
7073
+ * - v=1 -> 0.1.0
7074
+ * - v=2 -> 0.2.0
7075
+ */
7076
+ v?: 0 | 1 | 2;
7077
+ /** @description Positioned partition: main or history; omitted selects main. */
7078
+ partition?: components["schemas"]["SchemaTranscriptSegmentPartitionKind"];
7079
+ /** @description History section index. Required for history and omitted for main. */
7080
+ section?: number;
7081
+ /** @description Optional positioned representation to revalidate; a mismatch requires reload. */
7082
+ representation?: string;
6783
7083
  };
6784
7084
  header?: never;
6785
7085
  path: {
@@ -6793,15 +7093,134 @@ export interface operations {
6793
7093
  /** @description OK */
6794
7094
  200: {
6795
7095
  headers: {
7096
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7097
+ "Cache-Control"?: string;
7098
+ /** @description Authorization, Cookie */
7099
+ Vary?: string;
7100
+ [name: string]: unknown;
7101
+ };
7102
+ content: {
7103
+ "application/json": components["schemas"]["SchemaTranscriptSegmentDirectory"] | components["schemas"]["SchemaPositionedDirectory"];
7104
+ };
7105
+ };
7106
+ /** @description Bad Request */
7107
+ 400: {
7108
+ headers: {
7109
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7110
+ "Cache-Control"?: string;
7111
+ /** @description Authorization, Cookie */
7112
+ Vary?: string;
7113
+ [name: string]: unknown;
7114
+ };
7115
+ content: {
7116
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7117
+ };
7118
+ };
7119
+ /** @description Not Found */
7120
+ 404: {
7121
+ headers: {
7122
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7123
+ "Cache-Control"?: string;
7124
+ /** @description Authorization, Cookie */
7125
+ Vary?: string;
7126
+ [name: string]: unknown;
7127
+ };
7128
+ content: {
7129
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7130
+ };
7131
+ };
7132
+ /** @description Conflict */
7133
+ 409: {
7134
+ headers: {
7135
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7136
+ "Cache-Control"?: string;
7137
+ /** @description Authorization, Cookie */
7138
+ Vary?: string;
7139
+ [name: string]: unknown;
7140
+ };
7141
+ content: {
7142
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7143
+ };
7144
+ };
7145
+ /** @description Gone. The transcript's stored content has been lost and cannot be loaded; an operator recorded the loss. Access is decided first, so a viewer who may not read the transcript receives 404. */
7146
+ 410: {
7147
+ headers: {
7148
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7149
+ "Cache-Control"?: string;
7150
+ /** @description Authorization, Cookie */
7151
+ Vary?: string;
7152
+ [name: string]: unknown;
7153
+ };
7154
+ content: {
7155
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7156
+ };
7157
+ };
7158
+ /** @description Internal Server Error */
7159
+ 500: {
7160
+ headers: {
7161
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7162
+ "Cache-Control"?: string;
7163
+ /** @description Authorization, Cookie */
7164
+ Vary?: string;
7165
+ [name: string]: unknown;
7166
+ };
7167
+ content: {
7168
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7169
+ };
7170
+ };
7171
+ /** @description Service Unavailable */
7172
+ 503: {
7173
+ headers: {
7174
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7175
+ "Cache-Control"?: string;
7176
+ /** @description When to retry a temporary load or admission refusal. */
7177
+ "Retry-After"?: string;
7178
+ /** @description Authorization, Cookie */
7179
+ Vary?: string;
7180
+ [name: string]: unknown;
7181
+ };
7182
+ content: {
7183
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7184
+ };
7185
+ };
7186
+ };
7187
+ };
7188
+ locateTranscriptEntry: {
7189
+ parameters: {
7190
+ query?: never;
7191
+ header?: never;
7192
+ path: {
7193
+ /** @description Transcript identifier */
7194
+ id: components["schemas"]["SchemaTranscriptID"];
7195
+ };
7196
+ cookie?: never;
7197
+ };
7198
+ requestBody: {
7199
+ content: {
7200
+ "application/json": components["schemas"]["SchemaTranscriptEntryLocateRequest"];
7201
+ };
7202
+ };
7203
+ responses: {
7204
+ /** @description OK */
7205
+ 200: {
7206
+ headers: {
7207
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7208
+ "Cache-Control"?: string;
7209
+ /** @description Authorization, Cookie */
7210
+ Vary?: string;
6796
7211
  [name: string]: unknown;
6797
7212
  };
6798
7213
  content: {
6799
- "application/json": components["schemas"]["SchemaTranscriptSegmentDirectory"];
7214
+ "application/json": components["schemas"]["SchemaTranscriptEntryMatch"];
6800
7215
  };
6801
7216
  };
6802
7217
  /** @description Bad Request */
6803
7218
  400: {
6804
7219
  headers: {
7220
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7221
+ "Cache-Control"?: string;
7222
+ /** @description Authorization, Cookie */
7223
+ Vary?: string;
6805
7224
  [name: string]: unknown;
6806
7225
  };
6807
7226
  content: {
@@ -6811,6 +7230,10 @@ export interface operations {
6811
7230
  /** @description Not Found */
6812
7231
  404: {
6813
7232
  headers: {
7233
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7234
+ "Cache-Control"?: string;
7235
+ /** @description Authorization, Cookie */
7236
+ Vary?: string;
6814
7237
  [name: string]: unknown;
6815
7238
  };
6816
7239
  content: {
@@ -6820,6 +7243,23 @@ export interface operations {
6820
7243
  /** @description Conflict */
6821
7244
  409: {
6822
7245
  headers: {
7246
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7247
+ "Cache-Control"?: string;
7248
+ /** @description Authorization, Cookie */
7249
+ Vary?: string;
7250
+ [name: string]: unknown;
7251
+ };
7252
+ content: {
7253
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7254
+ };
7255
+ };
7256
+ /** @description Gone. The transcript's stored content has been lost and cannot be loaded; an operator recorded the loss. Access is decided first, so a viewer who may not read the transcript receives 404. */
7257
+ 410: {
7258
+ headers: {
7259
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7260
+ "Cache-Control"?: string;
7261
+ /** @description Authorization, Cookie */
7262
+ Vary?: string;
6823
7263
  [name: string]: unknown;
6824
7264
  };
6825
7265
  content: {
@@ -6829,6 +7269,25 @@ export interface operations {
6829
7269
  /** @description Internal Server Error */
6830
7270
  500: {
6831
7271
  headers: {
7272
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7273
+ "Cache-Control"?: string;
7274
+ /** @description Authorization, Cookie */
7275
+ Vary?: string;
7276
+ [name: string]: unknown;
7277
+ };
7278
+ content: {
7279
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7280
+ };
7281
+ };
7282
+ /** @description Service Unavailable */
7283
+ 503: {
7284
+ headers: {
7285
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7286
+ "Cache-Control"?: string;
7287
+ /** @description When to retry a temporary load or admission refusal. */
7288
+ "Retry-After"?: string;
7289
+ /** @description Authorization, Cookie */
7290
+ Vary?: string;
6832
7291
  [name: string]: unknown;
6833
7292
  };
6834
7293
  content: {
@@ -6842,6 +7301,19 @@ export interface operations {
6842
7301
  query?: {
6843
7302
  /** @description Revision to read; omitted serves the current revision */
6844
7303
  revision?: string;
7304
+ /**
7305
+ * @description Protocol generation selectors (omission is v=0):
7306
+ * - v=0 -> 0.1.0
7307
+ * - v=1 -> 0.1.0
7308
+ * - v=2 -> 0.2.0
7309
+ */
7310
+ v?: 0 | 1 | 2;
7311
+ /** @description Positioned partition: main or history; omitted selects main. */
7312
+ partition?: components["schemas"]["SchemaTranscriptSegmentPartitionKind"];
7313
+ /** @description History section index. Required for history and omitted for main. */
7314
+ section?: number;
7315
+ /** @description Optional positioned representation to revalidate; a mismatch requires reload. */
7316
+ representation?: string;
6845
7317
  };
6846
7318
  header?: never;
6847
7319
  path: {
@@ -6857,15 +7329,23 @@ export interface operations {
6857
7329
  /** @description OK */
6858
7330
  200: {
6859
7331
  headers: {
7332
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7333
+ "Cache-Control"?: string;
7334
+ /** @description Authorization, Cookie */
7335
+ Vary?: string;
6860
7336
  [name: string]: unknown;
6861
7337
  };
6862
7338
  content: {
6863
- "application/json": components["schemas"]["SchemaTranscriptSegment"];
7339
+ "application/json": components["schemas"]["SchemaTranscriptSegment"] | components["schemas"]["SchemaPositionedSegment"];
6864
7340
  };
6865
7341
  };
6866
7342
  /** @description Bad Request */
6867
7343
  400: {
6868
7344
  headers: {
7345
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7346
+ "Cache-Control"?: string;
7347
+ /** @description Authorization, Cookie */
7348
+ Vary?: string;
6869
7349
  [name: string]: unknown;
6870
7350
  };
6871
7351
  content: {
@@ -6875,6 +7355,10 @@ export interface operations {
6875
7355
  /** @description Not Found */
6876
7356
  404: {
6877
7357
  headers: {
7358
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7359
+ "Cache-Control"?: string;
7360
+ /** @description Authorization, Cookie */
7361
+ Vary?: string;
6878
7362
  [name: string]: unknown;
6879
7363
  };
6880
7364
  content: {
@@ -6884,6 +7368,23 @@ export interface operations {
6884
7368
  /** @description Conflict */
6885
7369
  409: {
6886
7370
  headers: {
7371
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7372
+ "Cache-Control"?: string;
7373
+ /** @description Authorization, Cookie */
7374
+ Vary?: string;
7375
+ [name: string]: unknown;
7376
+ };
7377
+ content: {
7378
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7379
+ };
7380
+ };
7381
+ /** @description Gone. The transcript's stored content has been lost and cannot be loaded; an operator recorded the loss. Access is decided first, so a viewer who may not read the transcript receives 404. */
7382
+ 410: {
7383
+ headers: {
7384
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7385
+ "Cache-Control"?: string;
7386
+ /** @description Authorization, Cookie */
7387
+ Vary?: string;
6887
7388
  [name: string]: unknown;
6888
7389
  };
6889
7390
  content: {
@@ -6893,6 +7394,25 @@ export interface operations {
6893
7394
  /** @description Internal Server Error */
6894
7395
  500: {
6895
7396
  headers: {
7397
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7398
+ "Cache-Control"?: string;
7399
+ /** @description Authorization, Cookie */
7400
+ Vary?: string;
7401
+ [name: string]: unknown;
7402
+ };
7403
+ content: {
7404
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7405
+ };
7406
+ };
7407
+ /** @description Service Unavailable */
7408
+ 503: {
7409
+ headers: {
7410
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7411
+ "Cache-Control"?: string;
7412
+ /** @description When to retry a temporary load or admission refusal. */
7413
+ "Retry-After"?: string;
7414
+ /** @description Authorization, Cookie */
7415
+ Vary?: string;
6896
7416
  [name: string]: unknown;
6897
7417
  };
6898
7418
  content: {
@@ -7052,6 +7572,19 @@ export interface operations {
7052
7572
  span?: number;
7053
7573
  /** @description Revision to read; omitted serves the current revision */
7054
7574
  revision?: string;
7575
+ /**
7576
+ * @description Protocol generation selectors (omission is v=0):
7577
+ * - v=0 -> 0.1.0
7578
+ * - v=1 -> 0.1.0
7579
+ * - v=2 -> 0.2.0
7580
+ */
7581
+ v?: 0 | 1 | 2;
7582
+ /** @description Positioned partition: main or history; omitted selects main. */
7583
+ partition?: components["schemas"]["SchemaTranscriptSegmentPartitionKind"];
7584
+ /** @description History section index. Required for history and omitted for main. */
7585
+ section?: number;
7586
+ /** @description Optional positioned representation to revalidate; a mismatch requires reload. */
7587
+ representation?: string;
7055
7588
  };
7056
7589
  header?: never;
7057
7590
  path: {
@@ -7065,15 +7598,23 @@ export interface operations {
7065
7598
  /** @description OK */
7066
7599
  200: {
7067
7600
  headers: {
7601
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7602
+ "Cache-Control"?: string;
7603
+ /** @description Authorization, Cookie */
7604
+ Vary?: string;
7068
7605
  [name: string]: unknown;
7069
7606
  };
7070
7607
  content: {
7071
- "application/json": components["schemas"]["SchemaTranscriptWindow"];
7608
+ "application/json": components["schemas"]["SchemaTranscriptWindow"] | components["schemas"]["SchemaPositionedWindow"];
7072
7609
  };
7073
7610
  };
7074
7611
  /** @description Bad Request */
7075
7612
  400: {
7076
7613
  headers: {
7614
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7615
+ "Cache-Control"?: string;
7616
+ /** @description Authorization, Cookie */
7617
+ Vary?: string;
7077
7618
  [name: string]: unknown;
7078
7619
  };
7079
7620
  content: {
@@ -7083,6 +7624,10 @@ export interface operations {
7083
7624
  /** @description Not Found */
7084
7625
  404: {
7085
7626
  headers: {
7627
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7628
+ "Cache-Control"?: string;
7629
+ /** @description Authorization, Cookie */
7630
+ Vary?: string;
7086
7631
  [name: string]: unknown;
7087
7632
  };
7088
7633
  content: {
@@ -7092,6 +7637,23 @@ export interface operations {
7092
7637
  /** @description Conflict */
7093
7638
  409: {
7094
7639
  headers: {
7640
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7641
+ "Cache-Control"?: string;
7642
+ /** @description Authorization, Cookie */
7643
+ Vary?: string;
7644
+ [name: string]: unknown;
7645
+ };
7646
+ content: {
7647
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7648
+ };
7649
+ };
7650
+ /** @description Gone. The transcript's stored content has been lost and cannot be loaded; an operator recorded the loss. Access is decided first, so a viewer who may not read the transcript receives 404. */
7651
+ 410: {
7652
+ headers: {
7653
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7654
+ "Cache-Control"?: string;
7655
+ /** @description Authorization, Cookie */
7656
+ Vary?: string;
7095
7657
  [name: string]: unknown;
7096
7658
  };
7097
7659
  content: {
@@ -7101,6 +7663,25 @@ export interface operations {
7101
7663
  /** @description Internal Server Error */
7102
7664
  500: {
7103
7665
  headers: {
7666
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7667
+ "Cache-Control"?: string;
7668
+ /** @description Authorization, Cookie */
7669
+ Vary?: string;
7670
+ [name: string]: unknown;
7671
+ };
7672
+ content: {
7673
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7674
+ };
7675
+ };
7676
+ /** @description Service Unavailable */
7677
+ 503: {
7678
+ headers: {
7679
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7680
+ "Cache-Control"?: string;
7681
+ /** @description When to retry a temporary load or admission refusal. */
7682
+ "Retry-After"?: string;
7683
+ /** @description Authorization, Cookie */
7684
+ Vary?: string;
7104
7685
  [name: string]: unknown;
7105
7686
  };
7106
7687
  content: {