@peasant-labs/schema 0.1.0-rc10 → 0.1.0-rc12

package/dist/internal/generated/village-api.d.ts

@@ -179,7 +179,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Publish a transcript with session entries to the village. */
+        /** @description Publish exact transcript bytes with typed JSON metadata. Creation returns 201 and replacement returns 200; both carry the complete authoritative receipt. */
         post: operations["publishTranscript"];
         delete?: never;
         options?: never;
@@ -187,6 +187,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/transcripts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** @description Update an owned transcript's metadata and governance axes. Every field is optional: omission preserves stored state; empty title, description, or tags clear those fields; license null requests clear; and a canonical license replaces. Explicit null for title, description, tags, or visibility is rejected, as are unknown fields and invalid or duplicate tags. Clearing an already granted Creative Commons license remains subject to the server's irrevocability rule. Only the owner may call this operation. A successful update returns the complete typed authoritative editable state, including the canonical transcript URL and positive update timestamp. Visibility accepts private and public; organization-scoped visibility remains deferred. */
+        patch: operations["updateTranscript"];
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -199,19 +216,32 @@ export interface components {
          * @enum {string}
          */
         BestiaryHarness: Schema.Harness;
-        OpenapiTranscriptPublishRequest: {
-            diagnostics?: components["schemas"]["SchemaDiagnosticsInfo"];
-            entries?: components["schemas"]["SchemaSessionEntry"][];
-            git?: components["schemas"]["SchemaGitContext"];
-            identity?: components["schemas"]["SchemaSessionIdentity"];
+        FormDataOpenapiTranscriptPublishMultipartRequest: {
+            /** @description PublishRequest JSON encoded with Content-Type application/json. */
+            metadata: components["schemas"]["OpenapiAuthoritativeTranscriptPublishRequest"];
+            /** @description Exact transcript bytes whose SHA3-256 digest equals metadata.contentHash. */
+            transcript_file: components["schemas"]["MultipartFileHeader"];
+        };
+        /** Format: binary */
+        MultipartFileHeader: string;
+        OpenapiAuthoritativeTranscriptPublishRequest: {
+            contentHash: components["schemas"]["SchemaTranscriptContentHash"];
+            diagnostics?: components["schemas"]["SchemaAuthoritativeDiagnosticsInfo"];
+            entries?: components["schemas"]["SchemaAuthoritativeSessionEntry"][];
+            git?: components["schemas"]["SchemaAuthoritativeGitContext"];
+            identity?: components["schemas"]["SchemaAuthoritativeSessionIdentity"];
             license?: components["schemas"]["SchemaLicense"];
-            model: components["schemas"]["SchemaModelInfo"];
-            project?: components["schemas"]["SchemaProjectContext"];
-            quality?: components["schemas"]["SchemaQualityMetrics"];
-            source?: components["schemas"]["SchemaSourceInfo"];
-            stats?: components["schemas"]["SchemaSessionStats"];
-            subagents?: components["schemas"]["SchemaSubagentRef"][];
-            timestamp?: components["schemas"]["SchemaTimestampInfo"];
+            model: components["schemas"]["SchemaAuthoritativeModelInfo"];
+            project?: components["schemas"]["SchemaAuthoritativeProjectContext"];
+            quality?: components["schemas"]["SchemaAuthoritativeQualityMetrics"];
+            source?: components["schemas"]["SchemaAuthoritativeSourceInfo"];
+            stats?: components["schemas"]["SchemaAuthoritativeSessionStats"];
+            subagents?: components["schemas"]["SchemaAuthoritativeSubagentRef"][];
+            timestamp?: components["schemas"]["SchemaAuthoritativeTimestampInfo"];
+            visibilityIntent?: components["schemas"]["SchemaVisibilityIntent"];
+        };
+        OpenapiTranscriptUpdateErrorResponse: {
+            error: string;
         };
         SchemaAnnotationEntryTarget: Schema.AnnotationEntryTarget;
         SchemaAnnotationManifestResponse: Schema.AnnotationManifestResponse;
@@ -244,9 +274,20 @@ export interface components {
          * @example assoc-20260726:session-a:commit-1
          */
         SchemaAssociationID: Schema.AssociationID;
-        SchemaCommitInfo: Schema.CommitInfo;
-        SchemaDiagnosticEntry: Schema.DiagnosticEntry;
-        SchemaDiagnosticsInfo: Schema.DiagnosticsInfo;
+        SchemaAuthoritativeCommitInfo: Schema.AuthoritativeCommitInfo;
+        SchemaAuthoritativeDiagnosticEntry: Schema.AuthoritativeDiagnosticEntry;
+        SchemaAuthoritativeDiagnosticsInfo: Schema.AuthoritativeDiagnosticsInfo;
+        SchemaAuthoritativeGitContext: Schema.AuthoritativeGitContext;
+        SchemaAuthoritativeModelInfo: Schema.AuthoritativeModelInfo;
+        SchemaAuthoritativeProjectContext: Schema.AuthoritativeProjectContext;
+        SchemaAuthoritativePublishResponse: Schema.AuthoritativePublishResponse;
+        SchemaAuthoritativeQualityMetrics: Schema.AuthoritativeQualityMetrics;
+        SchemaAuthoritativeSessionEntry: Schema.AuthoritativeSessionEntry;
+        SchemaAuthoritativeSessionIdentity: Schema.AuthoritativeSessionIdentity;
+        SchemaAuthoritativeSessionStats: Schema.AuthoritativeSessionStats;
+        SchemaAuthoritativeSourceInfo: Schema.AuthoritativeSourceInfo;
+        SchemaAuthoritativeSubagentRef: Schema.AuthoritativeSubagentRef;
+        SchemaAuthoritativeTimestampInfo: Schema.AuthoritativeTimestampInfo;
         /**
          * Entry Type
          * @description Classification of a single entry within an agent session transcript
@@ -258,7 +299,6 @@ export interface components {
         SchemaEntryType: Schema.EntryType;
         SchemaExchangeCodeRequest: Schema.ExchangeCodeRequest;
         SchemaExchangeCodeResponse: Schema.ExchangeCodeResponse;
-        SchemaGitContext: Schema.GitContext;
         /**
          * Host Slug
          * @description Sanitized, filesystem-safe identifier derived from git remote; contains only [a-zA-Z0-9._<>-]
@@ -281,8 +321,10 @@ export interface components {
          * @example codex-mini-latest
          */
         SchemaModelID: Schema.ModelID;
-        SchemaModelInfo: Schema.ModelInfo;
-        SchemaProjectContext: Schema.ProjectContext;
+        SchemaOwnerTranscriptUpdateRequest: Schema.OwnerTranscriptUpdateRequest;
+        SchemaOwnerTranscriptUpdateResponse: Schema.OwnerTranscriptUpdateResponse;
+        /** @description Omitted preserves, null requests clear, and a canonical license replaces */
+        SchemaOwnerUpdateLicenseIntent: Schema.OwnerUpdateLicenseIntent;
         /**
          * Project Hash
          * @description SHA-256 hex digest of the project's origin URL or local path
@@ -290,7 +332,13 @@ export interface components {
          */
         SchemaProjectHash: Schema.ProjectHash;
         SchemaProvenance: Schema.Provenance;
-        SchemaPublishResponse: Schema.PublishResponse;
+        SchemaPublishAppliedState: Schema.PublishAppliedState;
+        SchemaPublishNormalizedValues: Schema.PublishNormalizedValues;
+        /**
+         * Publish Request Fingerprint
+         * @description SHA3-256 digest of the canonical domain-separated publish operation
+         */
+        SchemaPublishRequestFingerprint: Schema.PublishRequestFingerprint;
         SchemaPublishedAssociation: Schema.PublishedAssociation;
         SchemaPullAnnotation: Schema.PullAnnotation;
         SchemaPullListResponse: Schema.PullListResponse;
@@ -299,7 +347,6 @@ export interface components {
         SchemaPullSkipGateResponse: Schema.PullSkipGateResponse;
         SchemaPullSkipGateResult: Schema.PullSkipGateResult;
         SchemaPullTranscriptInfo: Schema.PullTranscriptInfo;
-        SchemaQualityMetrics: Schema.QualityMetrics;
         /**
          * Role
          * @description Sender role of a message turn
@@ -309,7 +356,6 @@ export interface components {
          */
         SchemaRole: Schema.Role;
         SchemaSchemaVersionResponse: Schema.SchemaVersionResponse;
-        SchemaSessionEntry: Schema.SessionEntry;
         /**
          * Session ID
          * Format: session-id
@@ -322,7 +368,6 @@ export interface components {
          * @example ABCDEFGHIJKLMNOPQRST234567
          */
         SchemaSessionID: Schema.SessionID;
-        SchemaSessionIdentity: Schema.SessionIdentity;
         /**
          * Session Outcome
          * @description Resolution status of the session
@@ -332,7 +377,6 @@ export interface components {
          * @enum {string}
          */
         SchemaSessionOutcome: Schema.SessionOutcome;
-        SchemaSessionStats: Schema.SessionStats;
         /**
          * Source Format
          * @description Transcript file format
@@ -341,7 +385,6 @@ export interface components {
          * @enum {string}
          */
         SchemaSourceFormat: Schema.SourceFormat;
-        SchemaSourceInfo: Schema.SourceInfo;
         /**
          * Stop Reason
          * @description Reason why a session or turn ended (ACP-aligned)
@@ -350,7 +393,6 @@ export interface components {
          * @enum {string}
          */
         SchemaStopReason: Schema.StopReason;
-        SchemaSubagentRef: Schema.SubagentRef;
         /**
          * Target Kind
          * @description What is being annotated: session-level, entry-level (turn/tool call), meta-annotation, project-level, a specific file version (content-hash keyed read-state receipt), or a durable session-to-commit association
@@ -361,7 +403,6 @@ export interface components {
          * @enum {string}
          */
         SchemaTargetKind: Schema.TargetKind;
-        SchemaTimestampInfo: Schema.TimestampInfo;
         /**
          * Tool Call Kind
          * @description Classification of a tool call, aligned with ACP ToolCallUpdate.kind
@@ -371,6 +412,11 @@ export interface components {
          * @enum {string}
          */
         SchemaToolCallKind: Schema.ToolCallKind;
+        /**
+         * Transcript Content Hash
+         * @description SHA3-256 digest of the exact transcript file bytes
+         */
+        SchemaTranscriptContentHash: Schema.TranscriptContentHash;
         /**
          * Transcript ID
          * Format: uuid
@@ -378,6 +424,14 @@ export interface components {
          * @example 99d59925-36bc-424c-a789-8be54d9702ba
          */
         SchemaTranscriptID: Schema.TranscriptID;
+        /**
+         * TranscriptUpdateVisibility
+         * @description Visibility values accepted by the owner transcript update operation. Organization-scoped visibility is deferred and is deliberately not offered here.
+         * @example public
+         * @example private
+         * @enum {string}
+         */
+        SchemaTranscriptUpdateVisibility: Schema.TranscriptUpdateVisibility;
         /**
          * Visibility
          * @description Access control level for a published transcript
@@ -386,6 +440,14 @@ export interface components {
          * @enum {string}
          */
         SchemaVisibility: Schema.Visibility;
+        /**
+         * Visibility Intent
+         * @description Optional desired final access for legacy compatibility; content replacement remains private and widening occurs separately
+         * @example private
+         * @example public
+         * @enum {string}
+         */
+        SchemaVisibilityIntent: Schema.VisibilityIntent;
         /**
          * Visibility
          * @description Access control level for a published transcript
@@ -632,9 +694,45 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: {
+        requestBody: {
+            content: {
+                "multipart/form-data": components["schemas"]["FormDataOpenapiTranscriptPublishMultipartRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SchemaAuthoritativePublishResponse"];
+                };
+            };
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SchemaAuthoritativePublishResponse"];
+                };
+            };
+        };
+    };
+    updateTranscript: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Transcript identifier */
+                id: components["schemas"]["SchemaTranscriptID"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
             content: {
-                "application/json": components["schemas"]["OpenapiTranscriptPublishRequest"];
+                "application/json": components["schemas"]["SchemaOwnerTranscriptUpdateRequest"];
             };
         };
         responses: {
@@ -644,7 +742,52 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SchemaPublishResponse"];
+                    "application/json": components["schemas"]["SchemaOwnerTranscriptUpdateResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OpenapiTranscriptUpdateErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OpenapiTranscriptUpdateErrorResponse"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OpenapiTranscriptUpdateErrorResponse"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OpenapiTranscriptUpdateErrorResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OpenapiTranscriptUpdateErrorResponse"];
                 };
             };
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peasant-labs/schema",
-  "version": "0.1.0-rc10",
+  "version": "0.1.0-rc12",
   "description": "Generated TypeScript contract bindings for the peasant-labs schema module",
   "license": "Apache-2.0",
   "repository": {
@@ -68,7 +68,7 @@
     "generate": "openapi-ts -f openapi-ts.config.mjs && node scripts/generate-contract-support.mjs",
     "build": "node scripts/build.mjs",
     "typecheck": "pnpm run build && tsc --noEmit -p tsconfig.test.json",
-    "test": "pnpm run build && node --test tests/*.test.mjs",
+    "test": "pnpm run build && node --test --test-concurrency=1 tests/*.test.mjs",
     "package:audit": "pnpm run build && node scripts/package-audit.mjs",
     "package:smoke": "pnpm run build && node scripts/package-smoke.mjs"
   }