@company-semantics/contracts 2.7.0 → 2.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'dfd003162bb3' as const;
-export const SPEC_HASH_FULL = 'dfd003162bb3d11c451864139ca8ba09e494cfd652b177f8b5ee8611c0f54e2a' as const;
+export const SPEC_HASH = '5639583592f3' as const;
+export const SPEC_HASH_FULL = '5639583592f37a84aa028b360d1cda28ec19a2e6bd82f053276349e646ec6809' as const;

package/src/api/generated.ts

@@ -2262,7 +2262,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/me/meetings/recordings": {
+    "/api/me/meetings/recordings/start": {
         parameters: {
             query?: never;
             header?: never;
@@ -2271,8 +2271,42 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Mint a transcription session grant for a new recording */
-        post: operations["issueMeetingRecordingGrant"];
+        /** Start a recording: create draft rows and mint a transcription grant */
+        post: operations["startMeetingRecording"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/me/meetings/recordings/{id}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Apply a batch of recording events (v1 envelope) */
+        post: operations["appendMeetingRecordingEvents"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/me/meetings/recordings/{id}/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Finalize (or cancel) a recording; idempotent on checksum */
+        post: operations["completeMeetingRecording"];
         delete?: never;
         options?: never;
         head?: never;
@@ -3921,35 +3955,42 @@ export interface components {
         UpdateWorkItemTitleRequest: {
             title: string;
         };
-        /** @description Provider-agnostic grant the mac shell consumes. Mac never sees provider name (INV-MTG-15). */
-        TranscriptionSessionGrant: {
+        /** @description Recording + work_item ids and the transcription session grant. */
+        StartMeetingRecordingResponse: {
             /** @description ULID; unified trace key for the recording (INV-MTG-7). */
-            sessionId: string;
-            /** Format: uri */
-            connectUrl: string;
-            authHeaders: {
-                [key: string]: string;
-            };
-            /** Format: date-time */
-            expiresAt: string;
-            audioConfig: {
-                /** @constant */
-                sampleRateHz: 16000;
-                /** @constant */
-                channels: 2;
-                /** @constant */
-                encoding: "linear16";
-                /** @constant */
-                chunkMs: 200;
-            };
-            capabilities: {
-                interimResults: boolean;
-                multichannelDiarization: boolean;
-                reconnectionTokens: boolean;
+            recordingId: string;
+            /** Format: uuid */
+            workItemId: string;
+            /** @description Provider-agnostic grant the mac shell consumes. Mac never sees provider name (INV-MTG-15). */
+            grant: {
+                /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+                sessionId: string;
+                /** Format: uri */
+                connectUrl: string;
+                authHeaders: {
+                    [key: string]: string;
+                };
+                /** Format: date-time */
+                expiresAt: string;
+                audioConfig: {
+                    /** @constant */
+                    sampleRateHz: 16000;
+                    /** @constant */
+                    channels: 2;
+                    /** @constant */
+                    encoding: "linear16";
+                    /** @constant */
+                    chunkMs: 200;
+                };
+                capabilities: {
+                    interimResults: boolean;
+                    multichannelDiarization: boolean;
+                    reconnectionTokens: boolean;
+                };
             };
         };
-        /** @description Request a transcription session grant for a new recording. */
-        IssueMeetingRecordingGrantRequest: {
+        /** @description Start a recording: create draft rows and mint a grant. */
+        StartMeetingRecordingRequest: {
             /** @description ULID; unified trace key for the recording (INV-MTG-7). */
             clientRecordingId: string;
             /**
@@ -3958,6 +3999,75 @@ export interface components {
              */
             detectedApp: "zoom" | "teams" | "meet-browser" | "slack-huddle" | "manual";
         };
+        /** @description Result of applying an event batch. */
+        AppendMeetingRecordingEventsResponse: {
+            /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+            recordingId: string;
+            status: string;
+            chunksAccepted: number;
+        };
+        /** @description A batch of recording events (v1 envelope). */
+        AppendMeetingRecordingEventsRequest: {
+            eventSchemaVersion: number;
+            events: ({
+                /** @constant */
+                kind: "session_opened";
+                /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+                recordingId: string;
+                atMs: number;
+            } | {
+                /** @constant */
+                kind: "chunk_batch";
+                /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+                recordingId: string;
+                chunks: {
+                    /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+                    recordingId: string;
+                    /**
+                     * @description Capture stream identity. Mic = channel 0, system audio = channel 1.
+                     * @enum {string}
+                     */
+                    source: "mic" | "system";
+                    sequence: number;
+                    startedAtMs: number;
+                    endedAtMs: number;
+                    text: string;
+                    final: boolean;
+                    speakerLabel?: string | null;
+                    confidence?: number;
+                }[];
+            } | {
+                /** @constant */
+                kind: "quality_degraded";
+                /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+                recordingId: string;
+                reason: string;
+                atMs: number;
+            } | {
+                /** @constant */
+                kind: "session_stopped";
+                /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+                recordingId: string;
+                atMs: number;
+                expectedLastSequence: number;
+            })[];
+        };
+        /** @description Result of finalizing or cancelling a recording. */
+        CompleteMeetingRecordingResponse: {
+            /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+            recordingId: string;
+            status: string;
+            workItemId: string | null;
+            transcriptDocumentId: string | null;
+            idempotent: boolean;
+        };
+        /** @description Finalize (or cancel) a recording. Idempotent on checksum. */
+        CompleteMeetingRecordingRequest: {
+            expectedLastSequence: number;
+            totalDurationMs: number;
+            checksum: string;
+            cancelled?: boolean;
+        };
         ImpersonationSessionResponse: {
             session: {
                 impersonationSessionId: string;
@@ -7541,7 +7651,7 @@ export interface operations {
             };
         };
     };
-    issueMeetingRecordingGrant: {
+    startMeetingRecording: {
         parameters: {
             query?: never;
             header?: never;
@@ -7550,20 +7660,27 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["IssueMeetingRecordingGrantRequest"];
+                "application/json": components["schemas"]["StartMeetingRecordingRequest"];
             };
         };
         responses: {
-            /** @description Provider-agnostic transcription session grant */
+            /** @description Recording + work_item ids and the provider-agnostic grant */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TranscriptionSessionGrant"];
+                    "application/json": components["schemas"]["StartMeetingRecordingResponse"];
                 };
             };
-            /** @description Rate limit exceeded (10 issuances/user/hour) */
+            /** @description A recording is already in progress for this user */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Rate limit exceeded (10 starts/user/hour) */
             429: {
                 headers: {
                     [name: string]: unknown;
@@ -7579,6 +7696,93 @@ export interface operations {
             };
         };
     };
+    appendMeetingRecordingEvents: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AppendMeetingRecordingEventsRequest"];
+            };
+        };
+        responses: {
+            /** @description Event batch applied */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AppendMeetingRecordingEventsResponse"];
+                };
+            };
+            /** @description Unknown eventSchemaVersion */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Recording not found or not owned by this user */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Illegal state transition */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    completeMeetingRecording: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CompleteMeetingRecordingRequest"];
+            };
+        };
+        responses: {
+            /** @description Recording finalized or cancelled */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CompleteMeetingRecordingResponse"];
+                };
+            };
+            /** @description Recording not found or not owned by this user */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Conflicting checksum on an already-finalized recording */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     startImpersonation: {
         parameters: {
             query?: never;