@peasant-labs/schema 0.52.0 → 0.54.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. */
1139
1139
  get: operations["getTranscriptMetadata"];
1140
1140
  put?: never;
1141
1141
  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. */
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.
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. */
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.
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.
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;
@@ -6714,6 +6853,123 @@ export interface operations {
6714
6853
  };
6715
6854
  };
6716
6855
  };
6856
+ getTranscriptHeader: {
6857
+ parameters: {
6858
+ query?: {
6859
+ /** @description Optional revision to read; omission selects the current revision. */
6860
+ revision?: string;
6861
+ /** @description Optional projection identity to revalidate; a mismatch requires reload. */
6862
+ representation?: string;
6863
+ };
6864
+ header?: {
6865
+ /** @description Optional entity tag of the previously authorized header. */
6866
+ "If-None-Match"?: string;
6867
+ };
6868
+ path: {
6869
+ /** @description Transcript identifier */
6870
+ id: components["schemas"]["SchemaTranscriptID"];
6871
+ };
6872
+ cookie?: never;
6873
+ };
6874
+ requestBody?: never;
6875
+ responses: {
6876
+ /** @description OK */
6877
+ 200: {
6878
+ headers: {
6879
+ /** @description private, no-cache when the revision is named; no-store when no revision is named or a migration rewrite was not installed. */
6880
+ "Cache-Control"?: string;
6881
+ /** @description Entity tag over the authorized header's revalidation inputs. */
6882
+ ETag?: string;
6883
+ /** @description Authorization, Cookie */
6884
+ Vary?: string;
6885
+ [name: string]: unknown;
6886
+ };
6887
+ content: {
6888
+ "application/json": components["schemas"]["SchemaTranscriptContentHeader"];
6889
+ };
6890
+ };
6891
+ /** @description Not modified after authorization and revalidation. */
6892
+ 304: {
6893
+ headers: {
6894
+ /** @description private, no-cache when the revision is named; no-store when no revision is named or a migration rewrite was not installed. */
6895
+ "Cache-Control"?: string;
6896
+ /** @description Entity tag over the authorized header's revalidation inputs. */
6897
+ ETag?: string;
6898
+ /** @description Authorization, Cookie */
6899
+ Vary?: string;
6900
+ [name: string]: unknown;
6901
+ };
6902
+ content?: never;
6903
+ };
6904
+ /** @description Bad Request */
6905
+ 400: {
6906
+ headers: {
6907
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6908
+ "Cache-Control"?: string;
6909
+ /** @description Authorization, Cookie */
6910
+ Vary?: string;
6911
+ [name: string]: unknown;
6912
+ };
6913
+ content: {
6914
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6915
+ };
6916
+ };
6917
+ /** @description Not Found */
6918
+ 404: {
6919
+ headers: {
6920
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6921
+ "Cache-Control"?: string;
6922
+ /** @description Authorization, Cookie */
6923
+ Vary?: string;
6924
+ [name: string]: unknown;
6925
+ };
6926
+ content: {
6927
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6928
+ };
6929
+ };
6930
+ /** @description Conflict */
6931
+ 409: {
6932
+ headers: {
6933
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6934
+ "Cache-Control"?: string;
6935
+ /** @description Authorization, Cookie */
6936
+ Vary?: string;
6937
+ [name: string]: unknown;
6938
+ };
6939
+ content: {
6940
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6941
+ };
6942
+ };
6943
+ /** @description Internal Server Error */
6944
+ 500: {
6945
+ headers: {
6946
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6947
+ "Cache-Control"?: string;
6948
+ /** @description Authorization, Cookie */
6949
+ Vary?: string;
6950
+ [name: string]: unknown;
6951
+ };
6952
+ content: {
6953
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6954
+ };
6955
+ };
6956
+ /** @description Service Unavailable */
6957
+ 503: {
6958
+ headers: {
6959
+ /** @description private, no-store for a successful read; no-store for a refusal. */
6960
+ "Cache-Control"?: string;
6961
+ /** @description When to retry a temporary load or admission refusal. */
6962
+ "Retry-After"?: string;
6963
+ /** @description Authorization, Cookie */
6964
+ Vary?: string;
6965
+ [name: string]: unknown;
6966
+ };
6967
+ content: {
6968
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6969
+ };
6970
+ };
6971
+ };
6972
+ };
6717
6973
  listTranscriptPullRequests: {
6718
6974
  parameters: {
6719
6975
  query?: never;
@@ -6780,6 +7036,19 @@ export interface operations {
6780
7036
  page?: number;
6781
7037
  /** @description Revision to read; omitted serves the current revision */
6782
7038
  revision?: string;
7039
+ /**
7040
+ * @description Protocol generation selectors (omission is v=0):
7041
+ * - v=0 -> 0.1.0
7042
+ * - v=1 -> 0.1.0
7043
+ * - v=2 -> 0.2.0
7044
+ */
7045
+ v?: 0 | 1 | 2;
7046
+ /** @description Positioned partition: main or history; omitted selects main. */
7047
+ partition?: components["schemas"]["SchemaTranscriptSegmentPartitionKind"];
7048
+ /** @description History section index. Required for history and omitted for main. */
7049
+ section?: number;
7050
+ /** @description Optional positioned representation to revalidate; a mismatch requires reload. */
7051
+ representation?: string;
6783
7052
  };
6784
7053
  header?: never;
6785
7054
  path: {
@@ -6793,15 +7062,121 @@ export interface operations {
6793
7062
  /** @description OK */
6794
7063
  200: {
6795
7064
  headers: {
7065
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7066
+ "Cache-Control"?: string;
7067
+ /** @description Authorization, Cookie */
7068
+ Vary?: string;
7069
+ [name: string]: unknown;
7070
+ };
7071
+ content: {
7072
+ "application/json": components["schemas"]["SchemaTranscriptSegmentDirectory"] | components["schemas"]["SchemaPositionedDirectory"];
7073
+ };
7074
+ };
7075
+ /** @description Bad Request */
7076
+ 400: {
7077
+ headers: {
7078
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7079
+ "Cache-Control"?: string;
7080
+ /** @description Authorization, Cookie */
7081
+ Vary?: string;
7082
+ [name: string]: unknown;
7083
+ };
7084
+ content: {
7085
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7086
+ };
7087
+ };
7088
+ /** @description Not Found */
7089
+ 404: {
7090
+ headers: {
7091
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7092
+ "Cache-Control"?: string;
7093
+ /** @description Authorization, Cookie */
7094
+ Vary?: string;
7095
+ [name: string]: unknown;
7096
+ };
7097
+ content: {
7098
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7099
+ };
7100
+ };
7101
+ /** @description Conflict */
7102
+ 409: {
7103
+ headers: {
7104
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7105
+ "Cache-Control"?: string;
7106
+ /** @description Authorization, Cookie */
7107
+ Vary?: string;
7108
+ [name: string]: unknown;
7109
+ };
7110
+ content: {
7111
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7112
+ };
7113
+ };
7114
+ /** @description Internal Server Error */
7115
+ 500: {
7116
+ headers: {
7117
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7118
+ "Cache-Control"?: string;
7119
+ /** @description Authorization, Cookie */
7120
+ Vary?: string;
7121
+ [name: string]: unknown;
7122
+ };
7123
+ content: {
7124
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7125
+ };
7126
+ };
7127
+ /** @description Service Unavailable */
7128
+ 503: {
7129
+ headers: {
7130
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7131
+ "Cache-Control"?: string;
7132
+ /** @description When to retry a temporary load or admission refusal. */
7133
+ "Retry-After"?: string;
7134
+ /** @description Authorization, Cookie */
7135
+ Vary?: string;
7136
+ [name: string]: unknown;
7137
+ };
7138
+ content: {
7139
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7140
+ };
7141
+ };
7142
+ };
7143
+ };
7144
+ locateTranscriptEntry: {
7145
+ parameters: {
7146
+ query?: never;
7147
+ header?: never;
7148
+ path: {
7149
+ /** @description Transcript identifier */
7150
+ id: components["schemas"]["SchemaTranscriptID"];
7151
+ };
7152
+ cookie?: never;
7153
+ };
7154
+ requestBody: {
7155
+ content: {
7156
+ "application/json": components["schemas"]["SchemaTranscriptEntryLocateRequest"];
7157
+ };
7158
+ };
7159
+ responses: {
7160
+ /** @description OK */
7161
+ 200: {
7162
+ headers: {
7163
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7164
+ "Cache-Control"?: string;
7165
+ /** @description Authorization, Cookie */
7166
+ Vary?: string;
6796
7167
  [name: string]: unknown;
6797
7168
  };
6798
7169
  content: {
6799
- "application/json": components["schemas"]["SchemaTranscriptSegmentDirectory"];
7170
+ "application/json": components["schemas"]["SchemaTranscriptEntryMatch"];
6800
7171
  };
6801
7172
  };
6802
7173
  /** @description Bad Request */
6803
7174
  400: {
6804
7175
  headers: {
7176
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7177
+ "Cache-Control"?: string;
7178
+ /** @description Authorization, Cookie */
7179
+ Vary?: string;
6805
7180
  [name: string]: unknown;
6806
7181
  };
6807
7182
  content: {
@@ -6811,6 +7186,10 @@ export interface operations {
6811
7186
  /** @description Not Found */
6812
7187
  404: {
6813
7188
  headers: {
7189
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7190
+ "Cache-Control"?: string;
7191
+ /** @description Authorization, Cookie */
7192
+ Vary?: string;
6814
7193
  [name: string]: unknown;
6815
7194
  };
6816
7195
  content: {
@@ -6820,6 +7199,10 @@ export interface operations {
6820
7199
  /** @description Conflict */
6821
7200
  409: {
6822
7201
  headers: {
7202
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7203
+ "Cache-Control"?: string;
7204
+ /** @description Authorization, Cookie */
7205
+ Vary?: string;
6823
7206
  [name: string]: unknown;
6824
7207
  };
6825
7208
  content: {
@@ -6829,6 +7212,25 @@ export interface operations {
6829
7212
  /** @description Internal Server Error */
6830
7213
  500: {
6831
7214
  headers: {
7215
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7216
+ "Cache-Control"?: string;
7217
+ /** @description Authorization, Cookie */
7218
+ Vary?: string;
7219
+ [name: string]: unknown;
7220
+ };
7221
+ content: {
7222
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7223
+ };
7224
+ };
7225
+ /** @description Service Unavailable */
7226
+ 503: {
7227
+ headers: {
7228
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7229
+ "Cache-Control"?: string;
7230
+ /** @description When to retry a temporary load or admission refusal. */
7231
+ "Retry-After"?: string;
7232
+ /** @description Authorization, Cookie */
7233
+ Vary?: string;
6832
7234
  [name: string]: unknown;
6833
7235
  };
6834
7236
  content: {
@@ -6842,6 +7244,19 @@ export interface operations {
6842
7244
  query?: {
6843
7245
  /** @description Revision to read; omitted serves the current revision */
6844
7246
  revision?: string;
7247
+ /**
7248
+ * @description Protocol generation selectors (omission is v=0):
7249
+ * - v=0 -> 0.1.0
7250
+ * - v=1 -> 0.1.0
7251
+ * - v=2 -> 0.2.0
7252
+ */
7253
+ v?: 0 | 1 | 2;
7254
+ /** @description Positioned partition: main or history; omitted selects main. */
7255
+ partition?: components["schemas"]["SchemaTranscriptSegmentPartitionKind"];
7256
+ /** @description History section index. Required for history and omitted for main. */
7257
+ section?: number;
7258
+ /** @description Optional positioned representation to revalidate; a mismatch requires reload. */
7259
+ representation?: string;
6845
7260
  };
6846
7261
  header?: never;
6847
7262
  path: {
@@ -6857,15 +7272,23 @@ export interface operations {
6857
7272
  /** @description OK */
6858
7273
  200: {
6859
7274
  headers: {
7275
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7276
+ "Cache-Control"?: string;
7277
+ /** @description Authorization, Cookie */
7278
+ Vary?: string;
6860
7279
  [name: string]: unknown;
6861
7280
  };
6862
7281
  content: {
6863
- "application/json": components["schemas"]["SchemaTranscriptSegment"];
7282
+ "application/json": components["schemas"]["SchemaTranscriptSegment"] | components["schemas"]["SchemaPositionedSegment"];
6864
7283
  };
6865
7284
  };
6866
7285
  /** @description Bad Request */
6867
7286
  400: {
6868
7287
  headers: {
7288
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7289
+ "Cache-Control"?: string;
7290
+ /** @description Authorization, Cookie */
7291
+ Vary?: string;
6869
7292
  [name: string]: unknown;
6870
7293
  };
6871
7294
  content: {
@@ -6875,6 +7298,10 @@ export interface operations {
6875
7298
  /** @description Not Found */
6876
7299
  404: {
6877
7300
  headers: {
7301
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7302
+ "Cache-Control"?: string;
7303
+ /** @description Authorization, Cookie */
7304
+ Vary?: string;
6878
7305
  [name: string]: unknown;
6879
7306
  };
6880
7307
  content: {
@@ -6884,6 +7311,10 @@ export interface operations {
6884
7311
  /** @description Conflict */
6885
7312
  409: {
6886
7313
  headers: {
7314
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7315
+ "Cache-Control"?: string;
7316
+ /** @description Authorization, Cookie */
7317
+ Vary?: string;
6887
7318
  [name: string]: unknown;
6888
7319
  };
6889
7320
  content: {
@@ -6893,6 +7324,25 @@ export interface operations {
6893
7324
  /** @description Internal Server Error */
6894
7325
  500: {
6895
7326
  headers: {
7327
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7328
+ "Cache-Control"?: string;
7329
+ /** @description Authorization, Cookie */
7330
+ Vary?: string;
7331
+ [name: string]: unknown;
7332
+ };
7333
+ content: {
7334
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7335
+ };
7336
+ };
7337
+ /** @description Service Unavailable */
7338
+ 503: {
7339
+ headers: {
7340
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7341
+ "Cache-Control"?: string;
7342
+ /** @description When to retry a temporary load or admission refusal. */
7343
+ "Retry-After"?: string;
7344
+ /** @description Authorization, Cookie */
7345
+ Vary?: string;
6896
7346
  [name: string]: unknown;
6897
7347
  };
6898
7348
  content: {
@@ -7052,6 +7502,19 @@ export interface operations {
7052
7502
  span?: number;
7053
7503
  /** @description Revision to read; omitted serves the current revision */
7054
7504
  revision?: string;
7505
+ /**
7506
+ * @description Protocol generation selectors (omission is v=0):
7507
+ * - v=0 -> 0.1.0
7508
+ * - v=1 -> 0.1.0
7509
+ * - v=2 -> 0.2.0
7510
+ */
7511
+ v?: 0 | 1 | 2;
7512
+ /** @description Positioned partition: main or history; omitted selects main. */
7513
+ partition?: components["schemas"]["SchemaTranscriptSegmentPartitionKind"];
7514
+ /** @description History section index. Required for history and omitted for main. */
7515
+ section?: number;
7516
+ /** @description Optional positioned representation to revalidate; a mismatch requires reload. */
7517
+ representation?: string;
7055
7518
  };
7056
7519
  header?: never;
7057
7520
  path: {
@@ -7065,15 +7528,23 @@ export interface operations {
7065
7528
  /** @description OK */
7066
7529
  200: {
7067
7530
  headers: {
7531
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7532
+ "Cache-Control"?: string;
7533
+ /** @description Authorization, Cookie */
7534
+ Vary?: string;
7068
7535
  [name: string]: unknown;
7069
7536
  };
7070
7537
  content: {
7071
- "application/json": components["schemas"]["SchemaTranscriptWindow"];
7538
+ "application/json": components["schemas"]["SchemaTranscriptWindow"] | components["schemas"]["SchemaPositionedWindow"];
7072
7539
  };
7073
7540
  };
7074
7541
  /** @description Bad Request */
7075
7542
  400: {
7076
7543
  headers: {
7544
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7545
+ "Cache-Control"?: string;
7546
+ /** @description Authorization, Cookie */
7547
+ Vary?: string;
7077
7548
  [name: string]: unknown;
7078
7549
  };
7079
7550
  content: {
@@ -7083,6 +7554,10 @@ export interface operations {
7083
7554
  /** @description Not Found */
7084
7555
  404: {
7085
7556
  headers: {
7557
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7558
+ "Cache-Control"?: string;
7559
+ /** @description Authorization, Cookie */
7560
+ Vary?: string;
7086
7561
  [name: string]: unknown;
7087
7562
  };
7088
7563
  content: {
@@ -7092,6 +7567,10 @@ export interface operations {
7092
7567
  /** @description Conflict */
7093
7568
  409: {
7094
7569
  headers: {
7570
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7571
+ "Cache-Control"?: string;
7572
+ /** @description Authorization, Cookie */
7573
+ Vary?: string;
7095
7574
  [name: string]: unknown;
7096
7575
  };
7097
7576
  content: {
@@ -7101,6 +7580,25 @@ export interface operations {
7101
7580
  /** @description Internal Server Error */
7102
7581
  500: {
7103
7582
  headers: {
7583
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7584
+ "Cache-Control"?: string;
7585
+ /** @description Authorization, Cookie */
7586
+ Vary?: string;
7587
+ [name: string]: unknown;
7588
+ };
7589
+ content: {
7590
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7591
+ };
7592
+ };
7593
+ /** @description Service Unavailable */
7594
+ 503: {
7595
+ headers: {
7596
+ /** @description private, no-store for a successful read; no-store for a refusal. */
7597
+ "Cache-Control"?: string;
7598
+ /** @description When to retry a temporary load or admission refusal. */
7599
+ "Retry-After"?: string;
7600
+ /** @description Authorization, Cookie */
7601
+ Vary?: string;
7104
7602
  [name: string]: unknown;
7105
7603
  };
7106
7604
  content: {