@peasant-labs/schema 0.54.0 → 0.57.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- export declare const VillageAPIVersion: "0.41.0";
1
+ export declare const VillageAPIVersion: "0.42.0";
2
2
  export declare const PeasantLocalAPIVersion: "0.38.0";
3
3
  export declare const TypesVersion: "0.51.0";
4
4
  export declare const SegmentedReadAPIVersion: "0.2.0";
@@ -1,5 +1,5 @@
1
1
  // Code generated from the canonical Go/OpenAPI contract. DO NOT EDIT.
2
- export const VillageAPIVersion = "0.41.0";
2
+ export const VillageAPIVersion = "0.42.0";
3
3
  export const PeasantLocalAPIVersion = "0.38.0";
4
4
  export const TypesVersion = "0.51.0";
5
5
  export const SegmentedReadAPIVersion = "0.2.0";
@@ -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. 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. */
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;
@@ -1187,7 +1187,7 @@ export interface paths {
1187
1187
  path?: never;
1188
1188
  cookie?: never;
1189
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. */
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
1191
  get: operations["getTranscriptHeader"];
1192
1192
  put?: never;
1193
1193
  post?: never;
@@ -1222,7 +1222,7 @@ export interface paths {
1222
1222
  cookie?: never;
1223
1223
  };
1224
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.
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
1226
  *
1227
1227
  * Protocol generation selectors (omission is v=0):
1228
1228
  * - v=0 -> 0.1.0
@@ -1247,7 +1247,7 @@ export interface paths {
1247
1247
  };
1248
1248
  get?: never;
1249
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. */
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
1251
  post: operations["locateTranscriptEntry"];
1252
1252
  delete?: never;
1253
1253
  options?: never;
@@ -1263,7 +1263,7 @@ export interface paths {
1263
1263
  cookie?: never;
1264
1264
  };
1265
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.
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
1267
  *
1268
1268
  * Protocol generation selectors (omission is v=0):
1269
1269
  * - v=0 -> 0.1.0
@@ -1321,7 +1321,7 @@ export interface paths {
1321
1321
  cookie?: never;
1322
1322
  };
1323
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.
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
1325
  *
1326
1326
  * Protocol generation selectors (omission is v=0):
1327
1327
  * - v=0 -> 0.1.0
@@ -6677,6 +6677,15 @@ export interface operations {
6677
6677
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6678
6678
  };
6679
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
+ };
6680
6689
  /** @description Internal Server Error */
6681
6690
  500: {
6682
6691
  headers: {
@@ -6851,6 +6860,15 @@ export interface operations {
6851
6860
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6852
6861
  };
6853
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
+ };
6854
6872
  };
6855
6873
  };
6856
6874
  getTranscriptHeader: {
@@ -6940,6 +6958,19 @@ export interface operations {
6940
6958
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6941
6959
  };
6942
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
+ };
6943
6974
  /** @description Internal Server Error */
6944
6975
  500: {
6945
6976
  headers: {
@@ -7111,6 +7142,19 @@ export interface operations {
7111
7142
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7112
7143
  };
7113
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
+ };
7114
7158
  /** @description Internal Server Error */
7115
7159
  500: {
7116
7160
  headers: {
@@ -7209,6 +7253,19 @@ export interface operations {
7209
7253
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7210
7254
  };
7211
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;
7263
+ [name: string]: unknown;
7264
+ };
7265
+ content: {
7266
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7267
+ };
7268
+ };
7212
7269
  /** @description Internal Server Error */
7213
7270
  500: {
7214
7271
  headers: {
@@ -7321,6 +7378,19 @@ export interface operations {
7321
7378
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7322
7379
  };
7323
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;
7388
+ [name: string]: unknown;
7389
+ };
7390
+ content: {
7391
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7392
+ };
7393
+ };
7324
7394
  /** @description Internal Server Error */
7325
7395
  500: {
7326
7396
  headers: {
@@ -7577,6 +7647,19 @@ export interface operations {
7577
7647
  "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7578
7648
  };
7579
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;
7657
+ [name: string]: unknown;
7658
+ };
7659
+ content: {
7660
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
7661
+ };
7662
+ };
7580
7663
  /** @description Internal Server Error */
7581
7664
  500: {
7582
7665
  headers: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@peasant-labs/schema",
3
- "version": "0.54.0",
3
+ "version": "0.57.0",
4
4
  "description": "Generated TypeScript contract bindings for the peasant-labs schema module",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {