@company-semantics/contracts 0.118.0 → 0.120.0

package/src/api/generated.ts

@@ -56,13 +56,8 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Start passwordless auth flow
-         * @description Initiates passwordless authentication by generating and sending an OTP to the provided email.
-         *     Rate limited per email (3/15min) and per IP (20/hour).
-         *     If the user's org requires SSO, returns SSO_REQUIRED error with redirect info.
-         */
-        post: operations["startAuth"];
+        /** Start passwordless auth flow */
+        post: operations["authStart"];
         delete?: never;
         options?: never;
         head?: never;
@@ -78,12 +73,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Verify OTP and create session
-         * @description Verifies the OTP code and creates a session.
-         *     Sets an httpOnly session cookie on success.
-         *     Rate limited per email (5/10min) and per IP (20/hour).
-         */
+        /** Verify OTP and create session */
         post: operations["verifyAuth"];
         delete?: never;
         options?: never;
@@ -100,12 +90,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Revoke session and clear cookie
-         * @description Revokes the current session and clears the session cookie.
-         *     Safe to call without auth (clears cookie regardless).
-         *     Requires X-Requested-With header for CSRF protection.
-         */
+        /** Revoke session and clear cookie */
         post: operations["logout"];
         delete?: never;
         options?: never;
@@ -120,11 +105,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Get current authenticated user
-         * @description Returns the current user's authentication info.
-         *     Requires valid session cookie.
-         */
+        /** Get current authenticated user */
         get: operations["getAuthMe"];
         put?: never;
         post?: never;
@@ -141,11 +122,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Initiate SSO flow for organization
-         * @description Initiates SSO flow for an organization.
-         *     Validates org exists and has SSO configured, generates state token, and redirects to IdP.
-         */
+        /** Initiate SSO flow for organization */
         get: operations["initiateSso"];
         put?: never;
         post?: never;
@@ -162,20 +139,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * OIDC callback endpoint
-         * @description Handles OIDC callback from identity providers.
-         *     Validates state, exchanges code for tokens, creates session.
-         *     Redirects to return URL or login page on error.
-         */
+        /** OIDC callback endpoint */
         get: operations["handleOidcCallback"];
         put?: never;
-        /**
-         * SAML callback endpoint
-         * @description Handles SAML callback from identity providers.
-         *     Validates RelayState, processes SAML assertion, creates session.
-         *     Redirects to return URL or login page on error.
-         */
+        /** SAML callback endpoint */
         post: operations["handleSamlCallback"];
         delete?: never;
         options?: never;
@@ -190,11 +157,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Get current user and org context
-         * @description Returns the current user's identity fields and organization context.
-         *     Identity is resolved via request context (DEV_ORG_ID in dev, session in production).
-         */
+        /** Get current user and org context */
         get: operations["getCurrentUser"];
         put?: never;
         post?: never;
@@ -217,12 +180,7 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        /**
-         * Update current user's profile
-         * @description Updates the current user's name fields.
-         *     At least one field must be provided.
-         *     displayName is computed at read time and cannot be set directly.
-         */
+        /** Update current user profile */
         patch: operations["updateUserProfile"];
         trace?: never;
     };
@@ -317,11 +275,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Resync user avatar from Slack
-         * @description Manually resync the current user's avatar from their Slack profile.
-         *     Requires user to have a linked Slack identity and the org to have an active Slack connection.
-         */
+        /** Resync Slack avatar */
         post: operations["resyncSlackAvatar"];
         delete?: never;
         options?: never;
@@ -336,11 +290,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Initiate OAuth flow
-         * @description Creates a pending connection and redirects to the OAuth provider's consent screen.
-         *     Replaces raw OAuth URLs with first-party redirect for trust and tracking.
-         */
+        /** Initiate OAuth flow */
         get: operations["initiateOAuth"];
         put?: never;
         post?: never;
@@ -357,12 +307,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * OAuth callback handler
-         * @description Handles the OAuth callback from providers.
-         *     Verifies state, exchanges code for tokens, stores encrypted tokens.
-         *     Returns HTML success or error page.
-         */
+        /** OAuth callback handler */
         get: operations["handleOAuthCallback"];
         put?: never;
         post?: never;
@@ -404,9 +349,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * AI chat endpoint
-         * @description Streaming chat endpoint using Server-Sent Events (SSE).
-         *     Returns x-vercel-ai-ui-message-stream header for AI SDK compatibility.
+         * Send a chat message and receive a streaming AI response
+         * @description Streaming AI chat endpoint. x-streaming: true. Returns a text/event-stream using the Vercel AI SDK UI message stream protocol.
          */
         post: operations["postAiChat"];
         delete?: never;
@@ -1529,18 +1473,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * List user's saved chats
-         * @description Returns a list of chat summaries for the authenticated user in their current org.
-         *     Ordered by updatedAt descending (newest first).
-         */
+        /** List user's saved chats */
         get: operations["listChats"];
         put?: never;
-        /**
-         * Create/save a new chat
-         * @description Creates a new chat with initial messages.
-         *     interactionId must be unique within the org.
-         */
+        /** Create/save a new chat */
         post: operations["createChat"];
         delete?: never;
         options?: never;
@@ -1555,11 +1491,7 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Look up chat ID by client interaction ID
-         * @description Returns the chat ID associated with a client-generated interaction ID.
-         *     Used to resolve optimistically-created chats.
-         */
+        /** Look up chat ID by client interaction ID */
         get: operations["getChatByInteraction"];
         put?: never;
         post?: never;
@@ -1576,27 +1508,15 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * Get chat with messages
-         * @description Returns a chat with all its messages.
-         *     Only the chat owner can access their chats.
-         */
+        /** Get chat with messages */
         get: operations["getChat"];
         put?: never;
         post?: never;
-        /**
-         * Delete a chat
-         * @description Deletes a chat and all its messages (cascade).
-         *     Only the chat owner can delete their chats.
-         */
+        /** Delete a chat */
         delete: operations["deleteChat"];
         options?: never;
         head?: never;
-        /**
-         * Update chat title
-         * @description Updates the title of an existing chat.
-         *     Only the chat owner can update their chats.
-         */
+        /** Update chat title */
         patch: operations["updateChat"];
         trace?: never;
     };
@@ -1609,11 +1529,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Append messages to chat
-         * @description Appends new messages to an existing chat.
-         *     Sequence numbers are auto-assigned starting from the current max + 1.
-         */
+        /** Append messages to chat */
         post: operations["appendMessages"];
         delete?: never;
         options?: never;
@@ -1631,11 +1547,7 @@ export interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /**
-         * Delete a single message
-         * @description Deletes a single message from a chat.
-         *     Only the chat owner can delete messages from their chats.
-         */
+        /** Delete a single message */
         delete: operations["deleteMessage"];
         options?: never;
         head?: never;
@@ -1651,13 +1563,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Generate title for chat
-         * @description Triggers LLM-based title generation for a chat.
-         *     Respects title generation invariants:
-         *     - INV-TITLE-2: Skips if titleSource === 'manual'
-         *     - INV-TITLE-3: Skips if titleGeneratedAt !== null
-         */
+        /** Generate title for chat */
         post: operations["generateChatTitle"];
         delete?: never;
         options?: never;
@@ -1674,15 +1580,9 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Pin a chat
-         * @description Pins a chat to keep it at the top of the list.
-         */
+        /** Pin a chat */
         post: operations["pinChat"];
-        /**
-         * Unpin a chat
-         * @description Removes the pinned status from a chat.
-         */
+        /** Unpin a chat */
         delete: operations["unpinChat"];
         options?: never;
         head?: never;
@@ -1697,10 +1597,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Subscribe to real-time chat updates
-         * @description Server-Sent Events endpoint for real-time chat updates.
-         *     Emits invalidation events when chats are created, updated, or deleted.
-         *     Clients should invalidate their cache and refetch on event receipt.
+         * Stream chat update events via SSE
+         * @description Server-Sent Events stream for real-time chat updates. x-streaming: true. Event payloads conform to ChatSseEventSchema.
          */
         get: operations["chatEvents"];
         put?: never;
@@ -1718,18 +1616,10 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * List shares for a chat
-         * @description Returns all active (non-revoked) shares for a chat.
-         *     Only the chat owner can list shares.
-         */
+        /** List all active shares for a chat */
         get: operations["listShares"];
         put?: never;
-        /**
-         * Create share with snapshot
-         * @description Creates a share for a chat, capturing current message count as the snapshot boundary.
-         *     Only the chat owner can create shares.
-         */
+        /** Create a share for a chat */
         post: operations["createShare"];
         delete?: never;
         options?: never;
@@ -1747,19 +1637,11 @@ export interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /**
-         * Revoke a share
-         * @description Revokes a share by setting revokedAt timestamp (soft delete).
-         *     Only the chat owner can revoke shares.
-         */
+        /** Revoke a share */
         delete: operations["revokeShare"];
         options?: never;
         head?: never;
-        /**
-         * Update share visibility
-         * @description Updates a share's visibility or refreshes the snapshot boundary.
-         *     Only the chat owner can update shares.
-         */
+        /** Update a share's visibility or refresh snapshot */
         patch: operations["updateShare"];
         trace?: never;
     };
@@ -1770,14 +1652,8 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /**
-         * View shared chat (public)
-         * @description View a shared chat using its token.
-         *     Public shares are accessible to anyone with the token.
-         *     Private shares require authentication as the chat owner.
-         *     Returns 404 for invalid tokens, revoked shares, or unauthorized access (never leaks reason).
-         */
-        get: operations["viewSharedChat"];
+        /** View a shared chat by token */
+        get: operations["getSharedView"];
         put?: never;
         post?: never;
         delete?: never;
@@ -2352,46 +2228,45 @@ export interface components {
         MeResponse: {
             /** Format: uuid */
             userId: string;
-            /** Format: email */
             email: string;
             fullName: string;
-            preferredName?: string | null;
-            /** @description Computed at read time (preferredName ?? fullName) */
+            preferredName: string | null;
             displayName: string;
             /** @enum {string} */
             nameSource: "self" | "sso";
             nameEditable: boolean;
             primaryDepartmentId: string | null;
             slackUserId: string | null;
-            avatar: components["schemas"]["ResolvedAvatar"];
+            avatar: {
+                /** @enum {string} */
+                source: "slack" | "initials";
+                url?: string;
+                initials: string;
+            };
             /** Format: uuid */
             orgId: string;
             orgName: string | null;
             orgSlug: string;
-            /** @enum {string} */
-            plan: "free" | "pro" | "enterprise";
+            plan: string;
             hasMultipleOrgs: boolean;
             isInternalAdmin: boolean;
         };
-        /** @description At least one field must be provided */
         ProfileUpdateRequest: {
-            firstName?: string;
-            lastName?: string | null;
             fullName?: string;
-            /** @description Cannot contain control characters, newlines, or quotes */
             preferredName?: string | null;
+            primaryDepartmentId?: string | null;
         };
         ProfileUpdateResponse: {
             /** @constant */
             success: true;
             user: {
-                /** Format: uuid */
                 id: string;
-                firstName: string;
-                lastName?: string | null;
                 fullName: string;
-                preferredName?: string | null;
+                preferredName: string | null;
                 displayName: string;
+                /** @enum {string} */
+                nameSource: "self" | "sso";
+                primaryDepartmentId: string | null;
             };
         };
         ResyncSlackLogoResponse: {
@@ -2569,13 +2444,27 @@ export interface components {
             createdAt: string;
         };
         ChatWithMessages: {
-            chat: components["schemas"]["Chat"];
-            messages: components["schemas"]["ChatMessage"][];
+            id: string;
+            title: string | null;
+            messageCount: number;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+            isShared: boolean;
+            pinnedAt: string | null;
+            titleSource: ("auto" | "manual") | null;
+            titleGeneratedAt: string | null;
         };
         CreateChatRequest: {
             title: string;
             interactionId: string;
-            messages: components["schemas"]["NewMessage"][];
+            messages: {
+                /** @enum {string} */
+                role: "user" | "assistant";
+                content: string;
+                parts?: unknown[];
+            }[];
         };
         NewMessage: {
             /** @enum {string} */
@@ -2587,16 +2476,19 @@ export interface components {
             title: string;
         };
         AppendMessagesRequest: {
-            messages: components["schemas"]["NewMessage"][];
+            messages: {
+                /** @enum {string} */
+                role: "user" | "assistant";
+                content: string;
+                parts?: unknown[];
+            }[];
         };
         SuccessResponse: {
             /** @constant */
             success: true;
         };
         GenerateTitleResponse: {
-            /** @description The chat title (generated or existing) */
             title: string;
-            /** @description Whether title was newly generated (false if guards blocked) */
             isAutoGenerated: boolean;
         };
         /** @enum {string} */
@@ -2618,22 +2510,29 @@ export interface components {
             revokedAt?: string | null;
         };
         CreateShareRequest: {
-            visibility: components["schemas"]["ChatVisibility"];
+            /** @enum {string} */
+            visibility: "public" | "private";
             /** Format: email */
             recipientEmail?: string;
         };
         UpdateShareRequest: {
-            visibility?: components["schemas"]["ChatVisibility"];
+            /** @enum {string} */
+            visibility?: "public" | "private";
             updateSnapshot?: boolean;
         };
         SharedChatView: {
-            /** Format: uuid */
-            chatId: string;
             title: string;
-            messages: components["schemas"]["ChatMessage"][];
+            messages: {
+                /** @enum {string} */
+                role: "user" | "assistant";
+                content: string;
+                parts?: unknown[];
+            }[];
             /** Format: date-time */
             sharedAt: string;
-            visibility: components["schemas"]["ChatVisibility"];
+            sharedByName: string;
+            /** @enum {string} */
+            visibility: "private" | "public";
         };
         OrgBudgetConfig: {
             enabled: boolean;
@@ -2906,25 +2805,47 @@ export interface components {
             truncated: boolean;
         };
         AuthStartRequest: {
-            /**
-             * Format: email
-             * @description Email address for OTP delivery
-             */
+            /** Format: email */
             email: string;
         };
         AuthStartResponse: {
             /** @constant */
-            ok: true;
+            mode: "otp";
+            devOtp?: string;
+        } | {
+            /** @constant */
+            mode: "sso";
+            providers: string[];
+            redirectUrl: string;
+        } | {
+            /** @constant */
+            mode: "hybrid";
+            providers: string[];
+            redirectUrl: string;
+            /** @constant */
+            otpAllowed: true;
+            devOtp?: string;
         };
         AuthVerifyRequest: {
             /** Format: email */
             email: string;
-            /** @description 6-digit OTP code */
             code: string;
+            inviteToken?: string;
         };
         AuthVerifyResponse: {
+            /** @constant */
+            success: true;
             /** @constant */
             ok: true;
+        } | {
+            /** @constant */
+            success: true;
+            /** @constant */
+            ok: true;
+            /** @constant */
+            acceptedInvite: true;
+            orgId: string;
+            role: string;
         };
         OkResponse: {
             /** @constant */
@@ -2952,9 +2873,7 @@ export interface components {
             orgSlug: string;
         };
         SamlCallbackRequest: {
-            /** @description Base64-encoded SAML assertion */
             SAMLResponse: string;
-            /** @description State token for CSRF protection */
             RelayState: string;
         };
         InitiateTransferRequest: {
@@ -3409,6 +3328,180 @@ export interface components {
             /** @description Organization name (present when invite is valid) */
             orgName?: string;
         };
+        LogoutResponse: {
+            /** @constant */
+            success: true;
+            /** @constant */
+            ok: true;
+        };
+        ChatListResponse: {
+            chats: {
+                id: string;
+                title: string | null;
+                messageCount: number;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+                isShared: boolean;
+                pinnedAt: string | null;
+                titleSource: ("auto" | "manual") | null;
+                titleGeneratedAt: string | null;
+            }[];
+        };
+        CreateChatResponse: {
+            chat: {
+                id: string;
+                title: string | null;
+                messageCount: number;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+                isShared: boolean;
+                pinnedAt: string | null;
+                titleSource: ("auto" | "manual") | null;
+                titleGeneratedAt: string | null;
+            };
+        };
+        ChatByInteractionResponse: {
+            chatId: string;
+        };
+        CreateShareResponse: {
+            share: {
+                id: string;
+                chatId: string;
+                token: string;
+                /** @enum {string} */
+                visibility: "private" | "public";
+                shareUrl: string;
+                messageCountAtShare: number;
+                titleAtShare: string;
+                /** Format: date-time */
+                createdAt: string;
+                createdByName: string;
+                isRevoked: boolean;
+            };
+            shareUrl: string;
+        };
+        ListSharesResponse: {
+            shares: {
+                id: string;
+                chatId: string;
+                token: string;
+                /** @enum {string} */
+                visibility: "private" | "public";
+                shareUrl: string;
+                messageCountAtShare: number;
+                titleAtShare: string;
+                /** Format: date-time */
+                createdAt: string;
+                createdByName: string;
+                isRevoked: boolean;
+            }[];
+        };
+        UpdateShareResponse: {
+            share: {
+                id: string;
+                chatId: string;
+                token: string;
+                /** @enum {string} */
+                visibility: "private" | "public";
+                shareUrl: string;
+                messageCountAtShare: number;
+                titleAtShare: string;
+                /** Format: date-time */
+                createdAt: string;
+                createdByName: string;
+                isRevoked: boolean;
+            };
+        };
+        ChatSuccessResponse: {
+            /** @constant */
+            success: true;
+        };
+        ChatSseEvent: {
+            /** @constant */
+            v: 1;
+            /** Format: date-time */
+            timestamp: string;
+            eventId?: string;
+            /** @constant */
+            type: "chat.created";
+            data: {
+                chatId: string;
+                interactionId?: string;
+                title: string;
+                /** @enum {string} */
+                titleSource: "auto" | "manual";
+                pinnedAt: string | null;
+                messageCount: number;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+                isShared: boolean;
+            };
+        } | {
+            /** @constant */
+            v: 1;
+            /** Format: date-time */
+            timestamp: string;
+            eventId?: string;
+            /** @constant */
+            type: "chat.updated";
+            data: {
+                chatId: string;
+                title: string;
+                titleSource: ("auto" | "manual") | null;
+                titleGeneratedAt: string | null;
+                pinnedAt: string | null;
+                messageCount: number;
+                /** Format: date-time */
+                createdAt: string;
+                /** Format: date-time */
+                updatedAt: string;
+                isShared: boolean;
+            };
+            changed: ("title" | "titleSource" | "pinnedAt")[];
+        } | {
+            /** @constant */
+            v: 1;
+            /** Format: date-time */
+            timestamp: string;
+            eventId?: string;
+            /** @constant */
+            type: "chat.deleted";
+            data: {
+                chatId: string;
+            };
+        } | {
+            /** @constant */
+            v: 1;
+            /** Format: date-time */
+            timestamp: string;
+            eventId?: string;
+            /** @constant */
+            type: "invalidate.chat";
+            chatId: string;
+            /** @enum {string} */
+            reason: "external-mutation" | "bulk-operation" | "sync-required";
+        } | {
+            /** @constant */
+            v: 1;
+            /** Format: date-time */
+            timestamp: string;
+            eventId?: string;
+            /** @constant */
+            type: "invalidate.chat-list";
+            /** @enum {string} */
+            reason: "external-mutation" | "bulk-operation" | "sync-required";
+        };
+        AiChatRequest: {
+            messages: unknown[];
+            id?: string;
+            runtimeProfile?: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -3458,7 +3551,7 @@ export interface operations {
             };
         };
     };
-    startAuth: {
+    authStart: {
         parameters: {
             query?: never;
             header?: never;
@@ -3471,7 +3564,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description OTP sent successfully */
+            /** @description Auth mode resolved; OTP sent when applicable */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -3480,33 +3573,6 @@ export interface operations {
                     "application/json": components["schemas"]["AuthStartResponse"];
                 };
             };
-            /** @description Validation error (invalid email format) */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description SSO required for this user's organization */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["SSORequiredErrorResponse"];
-                };
-            };
-            /** @description Rate limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     verifyAuth: {
@@ -3522,7 +3588,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Authentication successful, session cookie set */
+            /** @description Session created; cookie set */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -3531,24 +3597,6 @@ export interface operations {
                     "application/json": components["schemas"]["AuthVerifyResponse"];
                 };
             };
-            /** @description Validation error or invalid/expired OTP */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["OTPErrorResponse"];
-                };
-            };
-            /** @description Rate limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     logout: {
@@ -3560,22 +3608,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Session revoked successfully */
+            /** @description Session revoked; cookie cleared */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["OkResponse"];
-                };
-            };
-            /** @description Missing CSRF header */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["LogoutResponse"];
                 };
             };
         };
@@ -3594,32 +3633,17 @@ export interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["AuthMeResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
+                content?: never;
             };
         };
     };
     initiateSso: {
         parameters: {
             query?: {
-                /** @description URL to redirect after successful auth (validated against allowlist) */
                 return_to?: string;
             };
             header?: never;
-            path: {
-                /** @description Organization slug */
-                orgSlug: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -3627,42 +3651,18 @@ export interface operations {
             /** @description Redirect to identity provider */
             302: {
                 headers: {
-                    /** @description Identity provider authorization URL */
-                    Location?: string;
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description SSO not configured for organization */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Organization not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     handleOidcCallback: {
         parameters: {
             query?: {
-                /** @description Authorization code from IdP */
                 code?: string;
-                /** @description State token for CSRF protection */
                 state?: string;
-                /** @description Error code if auth failed at IdP */
                 error?: string;
-                /** @description Human-readable error description */
                 error_description?: string;
             };
             header?: never;
@@ -3674,20 +3674,10 @@ export interface operations {
             /** @description Redirect to return URL or login page */
             302: {
                 headers: {
-                    Location?: string;
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Invalid callback parameters */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     handleSamlCallback: {
@@ -3706,20 +3696,10 @@ export interface operations {
             /** @description Redirect to return URL or login page */
             302: {
                 headers: {
-                    Location?: string;
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Invalid callback parameters */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     getCurrentUser: {
@@ -3740,24 +3720,6 @@ export interface operations {
                     "application/json": components["schemas"]["MeResponse"];
                 };
             };
-            /** @description User or organization not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Configuration error (e.g., missing DEV_ORG_ID) */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     updateUserProfile: {
@@ -3782,24 +3744,6 @@ export interface operations {
                     "application/json": components["schemas"]["ProfileUpdateResponse"];
                 };
             };
-            /** @description Validation error */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ValidationErrorResponse"];
-                };
-            };
-            /** @description User not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     listUserOrgs: {
@@ -3969,124 +3913,55 @@ export interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ResyncSlackAvatarResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description User not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Rate limit exceeded */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
+                content?: never;
             };
         };
     };
     initiateOAuth: {
         parameters: {
-            query?: {
-                /**
-                 * @deprecated
-                 * @description DEPRECATED: Organization ID derived from session.
-                 *     Query parameter accepted only in dev mode for backwards compatibility.
-                 *     Production: orgId is always derived from authenticated session.
-                 */
-                orgId?: string;
-            };
+            query?: never;
             header?: never;
-            path: {
-                provider: components["schemas"]["OAuthProvider"];
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Redirect to OAuth provider */
+            /** @description Redirect to OAuth provider consent screen */
             302: {
                 headers: {
-                    /** @description OAuth provider authorization URL */
-                    Location?: string;
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Invalid provider or missing/invalid orgId */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description OAuth initialization failed */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     handleOAuthCallback: {
         parameters: {
             query?: {
-                /** @description Authorization code from provider */
                 code?: string;
-                /** @description State token for CSRF protection */
                 state?: string;
-                /** @description Error code from provider (if authorization denied) */
                 error?: string;
-                /** @description Human-readable error description from provider */
                 error_description?: string;
             };
             header?: never;
-            path: {
-                provider: components["schemas"]["OAuthProvider"];
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Authorization successful (HTML page) */
+            /** @description HTML success or error page (for popup flows) */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "text/html": string;
-                };
+                content?: never;
             };
-            /** @description Authorization failed or invalid request (HTML page) */
-            400: {
+            /** @description Redirect to return URL on success */
+            302: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "text/html": string;
-                };
+                content?: never;
             };
         };
     };
@@ -4119,20 +3994,16 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ChatRequest"];
+                "application/json": components["schemas"]["AiChatRequest"];
             };
         };
         responses: {
-            /** @description SSE stream of chat responses */
+            /** @description AI chat stream (text/event-stream). Uses x-vercel-ai-ui-message-stream: v1. */
             200: {
                 headers: {
-                    /** @description AI SDK stream protocol version */
-                    "x-vercel-ai-ui-message-stream"?: "v1";
                     [name: string]: unknown;
                 };
-                content: {
-                    "text/event-stream": string;
-                };
+                content?: never;
             };
         };
     };
@@ -6633,10 +6504,10 @@ export interface operations {
     listChats: {
         parameters: {
             query?: {
-                search?: string;
                 limit?: number;
                 offset?: number;
-                includePinned?: boolean;
+                search?: string;
+                includePinned?: "true" | "false";
             };
             header?: never;
             path?: never;
@@ -6650,18 +6521,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        chats: components["schemas"]["ChatSummary"][];
-                    };
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ChatListResponse"];
                 };
             };
         };
@@ -6685,27 +6545,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        chat: components["schemas"]["Chat"];
-                    };
-                };
-            };
-            /** @description Missing required fields */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["CreateChatResponse"];
                 };
             };
         };
@@ -6714,10 +6554,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Client-generated interaction ID */
-                interactionId: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -6728,28 +6565,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        chatId: string;
-                    };
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found for this interaction ID */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ChatByInteractionResponse"];
                 };
             };
         };
@@ -6758,10 +6574,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -6775,34 +6588,13 @@ export interface operations {
                     "application/json": components["schemas"]["ChatWithMessages"];
                 };
             };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     deleteChat: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -6816,34 +6608,13 @@ export interface operations {
                     "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     updateChat: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
@@ -6861,43 +6632,13 @@ export interface operations {
                     "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
-            /** @description Missing title */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     appendMessages: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
@@ -6915,45 +6656,13 @@ export interface operations {
                     "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
-            /** @description Missing messages array */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     deleteMessage: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-                /** @description Message ID (UUID) */
-                messageId: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -6967,34 +6676,13 @@ export interface operations {
                     "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat or message not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     generateChatTitle: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -7008,34 +6696,13 @@ export interface operations {
                     "application/json": components["schemas"]["GenerateTitleResponse"];
                 };
             };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     pinChat: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -7049,34 +6716,13 @@ export interface operations {
                     "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     unpinChat: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -7090,24 +6736,6 @@ export interface operations {
                     "application/json": components["schemas"]["SuccessResponse"];
                 };
             };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     chatEvents: {
@@ -7119,22 +6747,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description SSE stream established */
+            /** @description SSE event stream (text/event-stream). Event payload: ChatSseEvent. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "text/event-stream": string;
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "text/event-stream": components["schemas"]["ChatSseEvent"];
                 };
             };
         };
@@ -7143,41 +6762,18 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                chatId: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description List of shares */
+            /** @description List of chat shares */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        shares: components["schemas"]["ChatShareInfo"][];
-                    };
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ListSharesResponse"];
                 };
             };
         };
@@ -7186,10 +6782,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Chat ID (UUID) */
-                chatId: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
@@ -7198,44 +6791,13 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Share created */
+            /** @description Share created successfully */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        share: components["schemas"]["ChatShareInfo"];
-                        /** @description Full URL for accessing the shared chat */
-                        shareUrl: string;
-                    };
-                };
-            };
-            /** @description Invalid visibility value */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Chat not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["CreateShareResponse"];
                 };
             };
         };
@@ -7244,39 +6806,18 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Share ID (UUID) */
-                shareId: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Share revoked */
+            /** @description Share revoked successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SuccessResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Share not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ChatSuccessResponse"];
                 };
             };
         };
@@ -7285,10 +6826,7 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Share ID (UUID) */
-                shareId: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
@@ -7297,52 +6835,22 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Share updated */
+            /** @description Share updated successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": {
-                        share: components["schemas"]["ChatShareInfo"];
-                    };
-                };
-            };
-            /** @description Invalid visibility value */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Not authenticated */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Share not found or access denied */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["UpdateShareResponse"];
                 };
             };
         };
     };
-    viewSharedChat: {
+    getSharedView: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Share token (high-entropy capability token) */
                 token: string;
             };
             cookie?: never;
@@ -7352,23 +6860,12 @@ export interface operations {
             /** @description Shared chat view */
             200: {
                 headers: {
-                    /** @description Prevents caching to ensure revocation takes effect */
-                    "Cache-Control"?: "no-store";
                     [name: string]: unknown;
                 };
                 content: {
                     "application/json": components["schemas"]["SharedChatView"];
                 };
             };
-            /** @description Shared chat not found (invalid token, revoked, or unauthorized) */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
         };
     };
     getCompanyMdTree: {