@company-semantics/contracts 2.6.0 → 2.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "2.6.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 = '3b3621a12672' as const;
-export const SPEC_HASH_FULL = '3b3621a12672d03e48dad9007c700d26cadac5e1835ca7b6469ffd59366faa8e' as const;
+export const SPEC_HASH = '5639583592f3' as const;
+export const SPEC_HASH_FULL = '5639583592f37a84aa028b360d1cda28ec19a2e6bd82f053276349e646ec6809' as const;

package/src/api/generated.ts

@@ -1730,6 +1730,74 @@ export interface paths {
         patch: operations["updateOrgUnitDelegationScopes"];
         trace?: never;
     };
+    "/api/orgs/{orgId}/admins": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Grant org-admin authority to a user */
+        post: operations["grantOrgAdmin"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/orgs/{orgId}/admins/{userId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Revoke org-admin authority from a user */
+        delete: operations["revokeOrgAdmin"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/org-units/{unitId}/structural-leaders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Assign a user as structural leader of an org unit */
+        post: operations["assignOrgUnitStructuralLeader"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/org-units/{unitId}/structural-leaders/{userId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove a user as structural leader of an org unit */
+        delete: operations["removeOrgUnitStructuralLeader"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/org-units/{unitId}/memberships": {
         parameters: {
             query?: never;
@@ -2194,6 +2262,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/me/meetings/recordings/start": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** 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;
+        patch?: never;
+        trace?: never;
+    };
     "/api/internal-admin/impersonate/start": {
         parameters: {
             query?: never;
@@ -3592,6 +3711,40 @@ export interface components {
             note: string | null;
             scopes: ("doc.edit" | "doc.acl" | "members.manage")[];
         };
+        OrgAdminGrantResponse: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            orgId: string;
+            /** Format: uuid */
+            orgUnitId: string;
+            /** Format: uuid */
+            userId: string;
+            /** @enum {string} */
+            mechanism: "structural" | "rbac";
+            /** Format: uuid */
+            grantedByUserId: string;
+            grantedAt: string;
+            revokedAt: string | null;
+            reason: string | null;
+        };
+        StructuralLeaderAssignResponse: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            orgId: string;
+            /** Format: uuid */
+            orgUnitId: string;
+            /** Format: uuid */
+            userId: string;
+            /** @enum {string} */
+            mechanism: "structural" | "rbac";
+            /** Format: uuid */
+            grantedByUserId: string;
+            grantedAt: string;
+            revokedAt: string | null;
+            reason: string | null;
+        };
         OrgUnitMembershipListResponse: {
             /** Format: uuid */
             unitId: string;
@@ -3802,6 +3955,119 @@ export interface components {
         UpdateWorkItemTitleRequest: {
             title: string;
         };
+        /** @description Recording + work_item ids and the transcription session grant. */
+        StartMeetingRecordingResponse: {
+            /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+            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 Start a recording: create draft rows and mint a grant. */
+        StartMeetingRecordingRequest: {
+            /** @description ULID; unified trace key for the recording (INV-MTG-7). */
+            clientRecordingId: string;
+            /**
+             * @description Auto-detected meeting app that owns the system audio stream.
+             * @enum {string}
+             */
+            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;
@@ -6603,6 +6869,108 @@ export interface operations {
             };
         };
     };
+    grantOrgAdmin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: uuid */
+                    userId: string;
+                    reason?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Created authority overlay row */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgAdminGrantResponse"];
+                };
+            };
+        };
+    };
+    revokeOrgAdmin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                orgId: string;
+                userId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Authority revoked */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    assignOrgUnitStructuralLeader: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: uuid */
+                    userId: string;
+                    reason?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Created structural-leader overlay row */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StructuralLeaderAssignResponse"];
+                };
+            };
+        };
+    };
+    removeOrgUnitStructuralLeader: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+                userId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Structural-leader authority revoked */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listOrgUnitMemberships: {
         parameters: {
             query?: never;
@@ -7283,6 +7651,138 @@ export interface operations {
             };
         };
     };
+    startMeetingRecording: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StartMeetingRecordingRequest"];
+            };
+        };
+        responses: {
+            /** @description Recording + work_item ids and the provider-agnostic grant */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StartMeetingRecordingResponse"];
+                };
+            };
+            /** @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;
+                };
+                content?: never;
+            };
+            /** @description Transcription provider unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    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;