@peasant-labs/schema 0.35.0 → 0.37.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.
@@ -1008,6 +1008,23 @@ export interface paths {
1008
1008
  patch?: never;
1009
1009
  trace?: never;
1010
1010
  };
1011
+ "/api/v1/pull/transcripts/{id}/publish-metadata": {
1012
+ parameters: {
1013
+ query?: never;
1014
+ header?: never;
1015
+ path?: never;
1016
+ cookie?: never;
1017
+ };
1018
+ /** @description Get the publish metadata village stored for the transcript: the validated publish request, re-encoded, not a reconstruction. Only the transcript's owner, or an owner of a collective the transcript was submitted to (pending or approved), may read it. Every other caller gets 404, including one who can read the transcript, so the route never reveals more than the transcript does. It also answers 404 when the transcript's owner is anonymous to the caller (the public-owner rule decides), so it never exposes a hidden owner's repository, paths or commit authors. 404 also means village holds no stored metadata for the transcript (transcripts published before metadata was stored). 406 means the requested pull contract is below village's minimum. */
1019
+ get: operations["getPullTranscriptPublishMetadata"];
1020
+ put?: never;
1021
+ post?: never;
1022
+ delete?: never;
1023
+ options?: never;
1024
+ head?: never;
1025
+ patch?: never;
1026
+ trace?: never;
1027
+ };
1011
1028
  "/api/v1/pulls/{owner}/{name}/{number}": {
1012
1029
  parameters: {
1013
1030
  query?: never;
@@ -1118,7 +1135,7 @@ export interface paths {
1118
1135
  path?: never;
1119
1136
  cookie?: never;
1120
1137
  };
1121
- /** @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. */
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 public and flagged, and 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. */
1122
1139
  get: operations["getTranscriptMetadata"];
1123
1140
  put?: never;
1124
1141
  post?: never;
@@ -1163,6 +1180,23 @@ export interface paths {
1163
1180
  patch?: never;
1164
1181
  trace?: never;
1165
1182
  };
1183
+ "/api/v1/transcripts/{id}/integrity-check": {
1184
+ parameters: {
1185
+ query?: never;
1186
+ header?: never;
1187
+ path?: never;
1188
+ cookie?: never;
1189
+ };
1190
+ get?: never;
1191
+ put?: never;
1192
+ /** @description Ask village to check one of the caller's own transcripts for integrity. Only the signed-in owner may call it. The call is synchronous: the response carries the answer. Statuses are decided in this order: 401 when the caller is signed out; 400 for a malformed id; 404 when the caller cannot read the transcript; 403 when the caller can read it but does not own it; 409 when the owner's transcript is public; 503 when the check is not available; 429 when the owner's daily allowance is used up; otherwise village runs the check, and answers 503 if it does not complete, or 200. 409 means a public transcript, which is checked automatically. 429 means the owner's daily checks for the UTC day are used up. 503 means the check is not available now. A check that does not complete spends nothing, and an unchecked result spends nothing. The answer is only flagged, not_flagged or unchecked, with no turns, rule or field. remaining_today is the number of checks left after this one. A requested check is never shown publicly and never affects the public status. */
1193
+ post: operations["checkTranscriptIntegrity"];
1194
+ delete?: never;
1195
+ options?: never;
1196
+ head?: never;
1197
+ patch?: never;
1198
+ trace?: never;
1199
+ };
1166
1200
  "/api/v1/transcripts/{id}/pulls": {
1167
1201
  parameters: {
1168
1202
  query?: never;
@@ -1424,6 +1458,7 @@ export interface components {
1424
1458
  /** Format: binary */
1425
1459
  MultipartFileHeader: string;
1426
1460
  OpenapiAuthoritativeTranscriptPublishRequest: {
1461
+ client?: components["schemas"]["SchemaAuthoritativeClientInfo"];
1427
1462
  contentHash: components["schemas"]["SchemaTranscriptContentHash"];
1428
1463
  diagnostics?: components["schemas"]["SchemaAuthoritativeDiagnosticsInfo"];
1429
1464
  entries?: components["schemas"]["SchemaAuthoritativeSessionEntry"][];
@@ -1485,12 +1520,14 @@ export interface components {
1485
1520
  * @example assoc-20260726:session-a:commit-1
1486
1521
  */
1487
1522
  SchemaAssociationID: Schema.AssociationID;
1523
+ SchemaAuthoritativeClientInfo: Schema.AuthoritativeClientInfo;
1488
1524
  SchemaAuthoritativeCommitInfo: Schema.AuthoritativeCommitInfo;
1489
1525
  SchemaAuthoritativeDiagnosticEntry: Schema.AuthoritativeDiagnosticEntry;
1490
1526
  SchemaAuthoritativeDiagnosticsInfo: Schema.AuthoritativeDiagnosticsInfo;
1491
1527
  SchemaAuthoritativeGitContext: Schema.AuthoritativeGitContext;
1492
1528
  SchemaAuthoritativeModelInfo: Schema.AuthoritativeModelInfo;
1493
1529
  SchemaAuthoritativeProjectContext: Schema.AuthoritativeProjectContext;
1530
+ SchemaAuthoritativePublishRequest: Schema.AuthoritativePublishRequest;
1494
1531
  SchemaAuthoritativePublishResponse: Schema.AuthoritativePublishResponse;
1495
1532
  SchemaAuthoritativeQualityMetrics: Schema.AuthoritativeQualityMetrics;
1496
1533
  SchemaAuthoritativeSessionEntry: Schema.AuthoritativeSessionEntry;
@@ -1899,6 +1936,8 @@ export interface components {
1899
1936
  */
1900
1937
  SchemaTranscriptUpdateVisibility: Schema.TranscriptUpdateVisibility;
1901
1938
  SchemaTurnDetail: Schema.TurnDetail;
1939
+ SchemaUnverifiedPullRequest: Schema.UnverifiedPullRequest;
1940
+ SchemaUnverifiedPullRequestSource: Schema.UnverifiedPullRequestSource;
1902
1941
  /**
1903
1942
  * Usage Completeness
1904
1943
  * @description Completeness of the five base token fields
@@ -2017,6 +2056,16 @@ export interface components {
2017
2056
  SchemaVillageGroupedCollectiveDetailResponse: Schema.VillageGroupedCollectiveDetailResponse;
2018
2057
  SchemaVillageGroupedContributableResponse: Schema.VillageGroupedContributableResponse;
2019
2058
  SchemaVillageHelperMembersPayload: Schema.VillageHelperMembersPayload;
2059
+ SchemaVillageIntegrityCheckResponse: Schema.VillageIntegrityCheckResponse;
2060
+ /**
2061
+ * Village Integrity Check Result
2062
+ * @description What an owner's integrity check found; unchecked means scry declined and the daily allowance is not spent
2063
+ * @example flagged
2064
+ * @example not_flagged
2065
+ * @example unchecked
2066
+ * @enum {string}
2067
+ */
2068
+ SchemaVillageIntegrityCheckResult: Schema.VillageIntegrityCheckResult;
2020
2069
  SchemaVillageInvitedCollective: Schema.VillageInvitedCollective;
2021
2070
  SchemaVillageLinkRepositoryRequest: Schema.VillageLinkRepositoryRequest;
2022
2071
  SchemaVillageLinkedRepositoriesResponse: Schema.VillageLinkedRepositoriesResponse;
@@ -2126,6 +2175,7 @@ export interface components {
2126
2175
  * @enum {string}
2127
2176
  */
2128
2177
  SchemaVillageTranscriptDeletionPolicy: Schema.VillageTranscriptDeletionPolicy;
2178
+ SchemaVillageTranscriptIntegrity: Schema.VillageTranscriptIntegrity;
2129
2179
  SchemaVillageTranscriptListResponse: Schema.VillageTranscriptListResponse;
2130
2180
  SchemaVillageTranscriptListRow: Schema.VillageTranscriptListRow;
2131
2181
  SchemaVillageTranscriptMetadataResponse: Schema.VillageTranscriptMetadataResponse;
@@ -5908,6 +5958,69 @@ export interface operations {
5908
5958
  };
5909
5959
  };
5910
5960
  };
5961
+ getPullTranscriptPublishMetadata: {
5962
+ parameters: {
5963
+ query?: never;
5964
+ header?: {
5965
+ /** @description Optional. The newest pull contract this client reads, as MAJOR.MINOR.PATCH digits (for example 0.3.0). Village serves the highest version it supports that is no newer than this and no older than its minimum. Omitted or malformed (0.3, v0.3.0, any other text), it is treated as absent and Village serves its default (pullContractVersion), so a client with a buggy header still pulls. Below Village's minimum, the read is refused with 406 and a VillageErrorResponse. */
5966
+ "Peasant-Pull-Contract"?: string;
5967
+ };
5968
+ path: {
5969
+ id: string;
5970
+ };
5971
+ cookie?: never;
5972
+ };
5973
+ requestBody?: never;
5974
+ responses: {
5975
+ /** @description OK */
5976
+ 200: {
5977
+ headers: {
5978
+ /** @description The pull contract version this response was served under. 0.2.0 bodies are the Legacy* envelope; 0.3.0 and any later 0.3.z bodies are the public owner envelope. */
5979
+ "Peasant-Pull-Contract": string;
5980
+ [name: string]: unknown;
5981
+ };
5982
+ content: {
5983
+ "application/json": components["schemas"]["SchemaAuthoritativePublishRequest"];
5984
+ };
5985
+ };
5986
+ /** @description Unauthorized */
5987
+ 401: {
5988
+ headers: {
5989
+ [name: string]: unknown;
5990
+ };
5991
+ content: {
5992
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
5993
+ };
5994
+ };
5995
+ /** @description Not Found */
5996
+ 404: {
5997
+ headers: {
5998
+ [name: string]: unknown;
5999
+ };
6000
+ content: {
6001
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6002
+ };
6003
+ };
6004
+ /** @description Not Acceptable */
6005
+ 406: {
6006
+ headers: {
6007
+ [name: string]: unknown;
6008
+ };
6009
+ content: {
6010
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6011
+ };
6012
+ };
6013
+ /** @description Internal Server Error */
6014
+ 500: {
6015
+ headers: {
6016
+ [name: string]: unknown;
6017
+ };
6018
+ content: {
6019
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6020
+ };
6021
+ };
6022
+ };
6023
+ };
5911
6024
  getPullRequestAttachment: {
5912
6025
  parameters: {
5913
6026
  query?: never;
@@ -6503,6 +6616,8 @@ export interface operations {
6503
6616
  /** @description OK */
6504
6617
  200: {
6505
6618
  headers: {
6619
+ /** @description The bare content_hash, without quotes, of the stored copy this response was served from; it is not a hash of the served bytes. A rewrite on read sends the new hash, and withholding repository fields for an anonymous owner does not change it. Absent while village holds no hash for the served copy. A reader highlights flagged turns only when it equals transcript.content_hash from the metadata read. A plain header, not an ETag. */
6620
+ "Village-Content-Hash"?: components["schemas"]["SchemaTranscriptContentHash"];
6506
6621
  [name: string]: unknown;
6507
6622
  };
6508
6623
  content: {
@@ -6529,6 +6644,101 @@ export interface operations {
6529
6644
  };
6530
6645
  };
6531
6646
  };
6647
+ checkTranscriptIntegrity: {
6648
+ parameters: {
6649
+ query?: never;
6650
+ header?: never;
6651
+ path: {
6652
+ /** @description Transcript identifier */
6653
+ id: components["schemas"]["SchemaTranscriptID"];
6654
+ };
6655
+ cookie?: never;
6656
+ };
6657
+ requestBody?: never;
6658
+ responses: {
6659
+ /** @description OK */
6660
+ 200: {
6661
+ headers: {
6662
+ [name: string]: unknown;
6663
+ };
6664
+ content: {
6665
+ "application/json": components["schemas"]["SchemaVillageIntegrityCheckResponse"];
6666
+ };
6667
+ };
6668
+ /** @description Bad Request */
6669
+ 400: {
6670
+ headers: {
6671
+ [name: string]: unknown;
6672
+ };
6673
+ content: {
6674
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6675
+ };
6676
+ };
6677
+ /** @description Unauthorized */
6678
+ 401: {
6679
+ headers: {
6680
+ [name: string]: unknown;
6681
+ };
6682
+ content: {
6683
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6684
+ };
6685
+ };
6686
+ /** @description Forbidden */
6687
+ 403: {
6688
+ headers: {
6689
+ [name: string]: unknown;
6690
+ };
6691
+ content: {
6692
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6693
+ };
6694
+ };
6695
+ /** @description Not Found */
6696
+ 404: {
6697
+ headers: {
6698
+ [name: string]: unknown;
6699
+ };
6700
+ content: {
6701
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6702
+ };
6703
+ };
6704
+ /** @description Conflict */
6705
+ 409: {
6706
+ headers: {
6707
+ [name: string]: unknown;
6708
+ };
6709
+ content: {
6710
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6711
+ };
6712
+ };
6713
+ /** @description Too Many Requests */
6714
+ 429: {
6715
+ headers: {
6716
+ [name: string]: unknown;
6717
+ };
6718
+ content: {
6719
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6720
+ };
6721
+ };
6722
+ /** @description Internal Server Error */
6723
+ 500: {
6724
+ headers: {
6725
+ [name: string]: unknown;
6726
+ };
6727
+ content: {
6728
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6729
+ };
6730
+ };
6731
+ /** @description Service Unavailable */
6732
+ 503: {
6733
+ headers: {
6734
+ [name: string]: unknown;
6735
+ };
6736
+ content: {
6737
+ "application/json": components["schemas"]["SchemaVillageErrorResponse"];
6738
+ };
6739
+ };
6740
+ };
6741
+ };
6532
6742
  listTranscriptPullRequests: {
6533
6743
  parameters: {
6534
6744
  query?: never;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@peasant-labs/schema",
3
- "version": "0.35.0",
3
+ "version": "0.37.0",
4
4
  "description": "Generated TypeScript contract bindings for the peasant-labs schema module",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {