@vibexp/api-client 0.2.0 → 0.4.0

package/dist/schema.d.ts

@@ -51,10 +51,17 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Initiate WorkOS login
-         * @description Generates a CSRF state, stores it in a signed `vx_state` cookie, and returns the
-         *     WorkOS AuthKit authorization URL. The client should redirect the user to this URL
-         *     to begin the authentication flow.
+         * Initiate login with an identity provider
+         * @description Selects an enabled identity provider, generates a CSRF state, stores the
+         *     (state, provider) pair in a signed `vx_state` cookie, and returns the
+         *     provider's authorization URL. The client should redirect the user to this
+         *     URL to begin the authentication flow.
+         *
+         *     The provider is chosen with the `provider` query parameter, whose value is
+         *     one of the deployment's enabled providers (e.g. `google`, `github`,
+         *     `oidc`). When exactly one provider is enabled the parameter may be omitted
+         *     and that provider is used. When several are enabled the parameter is
+         *     required; an unknown or disabled value is rejected (no silent default).
          */
         get: operations["login"];
         put?: never;
@@ -65,6 +72,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/auth/providers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List enabled login providers
+         * @description Returns the login providers enabled in this deployment's configuration,
+         *     each with a canonical `name` (the value to pass as `?provider=` to
+         *     `GET /api/v1/auth/login`) and a human-readable `display_name` for the
+         *     login UI. The login screen uses this to render a provider picker instead
+         *     of hardcoding the provider list. The list is stable-sorted and may be
+         *     empty when no provider is configured.
+         */
+        get: operations["listAuthProviders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/auth/callback": {
         parameters: {
             query?: never;
@@ -73,11 +105,13 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Handle WorkOS OAuth callback
-         * @description Validates the CSRF `vx_state` cookie, exchanges the authorization code with WorkOS,
-         *     looks up or creates the user, writes a session cookie, and issues a 302 redirect
-         *     to the frontend home page. This endpoint is called by the browser after the user
-         *     authenticates with WorkOS — it does not return a JSON body on success.
+         * Handle the identity-provider OAuth callback
+         * @description Validates the CSRF `vx_state` cookie, recovers the provider bound to it,
+         *     exchanges the authorization code with that provider, looks up or creates
+         *     the user, writes a session cookie, and issues a 302 redirect to the
+         *     frontend home page. This endpoint is called by the browser after the user
+         *     authenticates with the upstream provider — it does not return a JSON body
+         *     on success.
          */
         get: operations["authCallback"];
         put?: never;
@@ -122,8 +156,8 @@ export interface paths {
         /**
          * Dev login (development only)
          * @description Creates or retrieves a user by email address and sets a session cookie without
-         *     going through WorkOS. Only available when the server is running in development
-         *     mode (`DEV_LOGIN_ENABLED=true`). Returns 404 in all other environments.
+         *     going through an external identity provider. Only available when the server is
+         *     running in development mode (`DEV_LOGIN_ENABLED=true`). Returns 404 in all other environments.
          */
         post: operations["devLogin"];
         delete?: never;
@@ -142,8 +176,8 @@ export interface paths {
         /**
          * Get current user information
          * @description Returns information about the currently authenticated user. Authentication is
-         *     verified via the encrypted session cookie (`vx_session`) set during the WorkOS
-         *     OAuth flow or dev login.
+         *     verified via the encrypted session cookie (`vx_session`) set during the
+         *     identity-provider OAuth flow or dev login.
          */
         get: operations["getMe"];
         put?: never;
@@ -2642,11 +2676,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/embedding-providers": {
+    "/api/v1/{team_id}/embedding-providers": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         /**
@@ -2671,11 +2708,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/embedding-providers/{id}": {
+    "/api/v1/{team_id}/embedding-providers/{id}": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         /**
@@ -2705,11 +2745,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/embedding-providers/validate": {
+    "/api/v1/{team_id}/embedding-providers/validate": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         get?: never;
@@ -2728,11 +2771,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/settings/embedding-providers": {
+    "/api/v1/{team_id}/settings/embedding-providers": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         /**
@@ -2757,11 +2803,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/settings/embedding-providers/{id}": {
+    "/api/v1/{team_id}/settings/embedding-providers/{id}": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         /**
@@ -2792,11 +2841,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/settings/embedding-providers/validate": {
+    "/api/v1/{team_id}/settings/embedding-providers/validate": {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         get?: never;
@@ -3108,32 +3160,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/website/contact/send-message": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Send a contact form message
-         * @description Submits a contact form message from the public marketing website and fans it out
-         *     to the email provider. This is a public endpoint (no authentication) with a very
-         *     strict per-IP rate limit; exceeding it returns 429. Request body is capped at 64 KB.
-         *     Note — error responses deviate from the standard `ErrorResponse` shape: validation
-         *     failures (400) and email-send failures (500) return a `ContactFormResponse` with
-         *     `success: false`, while malformed JSON (400) and oversized bodies (413) return a
-         *     plain-text message.
-         */
-        post: operations["sendContactMessage"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/v1/{team_id}/feed-items/{item_id}/replies": {
         parameters: {
             query?: never;
@@ -3294,13 +3320,13 @@ export interface components {
             /** @example user_123 */
             id: string;
             /**
-             * @description Legacy Google OAuth subject identifier (may be null for WorkOS-only accounts)
+             * @description Legacy Google OAuth subject identifier (may be null for non-Google accounts)
              * @example google_456
              */
             google_id?: string | null;
             /**
-             * @description Identity provider name (e.g. "workos")
-             * @example workos
+             * @description Identity provider name (e.g. "google", "oidc")
+             * @example oidc
              */
             idp_provider?: string | null;
             /**
@@ -3344,12 +3370,12 @@ export interface components {
              */
             version: number;
         };
-        /** @description Response body returned by GET /api/v1/auth/login containing the WorkOS authorization URL */
+        /** @description Response body returned by GET /api/v1/auth/login containing the authorization URL */
         LoginResponse: {
             /**
              * Format: uri
-             * @description WorkOS authorization URL to redirect the user to for authentication
-             * @example https://api.workos.com/user_management/authorize?client_id=...&redirect_uri=...&state=...&provider=GoogleOAuth
+             * @description Identity-provider authorization URL to redirect the user to for authentication
+             * @example https://idp.example.com/authorize?client_id=...&redirect_uri=...&state=...
              */
             url: string;
         };
@@ -3361,6 +3387,29 @@ export interface components {
              */
             message: string;
         };
+        /** @description One enabled login provider, with display metadata for the login UI */
+        AuthProvider: {
+            /**
+             * @description Canonical provider name, also the value to pass as the `provider`
+             *     query parameter to GET /api/v1/auth/login (e.g. `google`, `github`,
+             *     `oidc`).
+             * @example google
+             */
+            name: string;
+            /**
+             * @description Human-readable label for the provider button in the login UI
+             * @example Google
+             */
+            display_name: string;
+        };
+        /**
+         * @description Response body returned by GET /api/v1/auth/providers listing the login
+         *     providers enabled in this deployment's configuration.
+         */
+        ProvidersResponse: {
+            /** @description Enabled login providers, stable-sorted by canonical name */
+            providers: components["schemas"]["AuthProvider"][];
+        };
         /** @description Request body for POST /api/v1/auth/dev/login (development environment only) */
         DevLoginRequest: {
             /**
@@ -4020,10 +4069,31 @@ export interface components {
             id: string;
             /** @example user_123 */
             user_id: string;
+            /**
+             * Format: uuid
+             * @description Team that owns this provider.
+             * @example b1234567-89ab-cdef-0123-456789abcdef
+             */
+            team_id?: string | null;
             /** @example OpenAI Embeddings */
             name: string;
             /** @example openai */
             provider_type: string;
+            /**
+             * @description Embedding model this provider requests. Must return the fixed vector width VibeXP stores (1024).
+             * @example text-embedding-3-small
+             */
+            model: string;
+            /**
+             * @description In-Go text-chunker size used when embedding documents.
+             * @example 1000
+             */
+            chunk_size: number;
+            /**
+             * @description Overlap between adjacent chunks.
+             * @example 200
+             */
+            chunk_overlap: number;
             /** @example false */
             is_default: boolean;
             /**
@@ -4053,6 +4123,21 @@ export interface components {
             name: string;
             /** @example openai */
             provider_type: string;
+            /**
+             * @description Embedding model that must return 1024-dimensional vectors.
+             * @example text-embedding-3-small
+             */
+            model: string;
+            /**
+             * @description Optional chunker size; defaults to 1000 when omitted.
+             * @example 1000
+             */
+            chunk_size?: number;
+            /**
+             * @description Optional chunk overlap; defaults to 200 when omitted.
+             * @example 200
+             */
+            chunk_overlap?: number;
             /** @example false */
             is_default?: boolean;
             /**
@@ -4068,6 +4153,9 @@ export interface components {
         UpdateEmbeddingProviderRequest: {
             name?: string;
             provider_type?: string;
+            model?: string;
+            chunk_size?: number;
+            chunk_overlap?: number;
             is_default?: boolean;
             /** Format: uri */
             base_url?: string;
@@ -4086,6 +4174,11 @@ export interface components {
         ValidateEmbeddingProviderRequest: {
             /** @example openai_compatible */
             provider_type: string;
+            /**
+             * @description Embedding model to probe. The provider is accepted only if it returns vectors of the fixed dimension VibeXP stores (1024).
+             * @example text-embedding-3-small
+             */
+            model: string;
             /**
              * Format: uri
              * @example https://api.openai.com/v1
@@ -4106,6 +4199,11 @@ export interface components {
                 response_time_ms?: number;
                 /** @example 200 */
                 status_code?: number;
+                /**
+                 * @description Vector width the provider returned during the probe.
+                 * @example 1024
+                 */
+                dimension?: number;
                 /** @example Connection timeout */
                 error_details?: string;
             };
@@ -4154,25 +4252,6 @@ export interface components {
             /** @description List of resource usage items */
             resources?: components["schemas"]["ResourceUsageItem"][];
         };
-        ContactFormRequest: {
-            /** @example John Doe */
-            name: string;
-            /**
-             * Format: email
-             * @example john@example.com
-             */
-            email: string;
-            /** @example +1234567890 */
-            phone_number?: string | null;
-            /** @example I'm interested in your services. */
-            message: string;
-        };
-        ContactFormResponse: {
-            /** @example Message sent successfully */
-            message: string;
-            /** @example true */
-            success: boolean;
-        };
         SupportRequest: {
             /** @example I need help with configuring my API keys. */
             text: string;
@@ -7704,14 +7783,21 @@ export interface operations {
     };
     login: {
         parameters: {
-            query?: never;
+            query?: {
+                /**
+                 * @description Canonical name of the identity provider to use (e.g. `google`,
+                 *     `github`, `oidc`). Optional when a single provider is enabled;
+                 *     required when more than one is enabled.
+                 */
+                provider?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description WorkOS authorization URL generated successfully */
+            /** @description Authorization URL generated successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7720,6 +7806,56 @@ export interface operations {
                     "application/json": components["schemas"]["LoginResponse"];
                 };
             };
+            /**
+             * @description The `provider` value is unknown/disabled, or it was omitted while
+             *     multiple providers are enabled.
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description No identity provider is configured (web login unavailable) */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listAuthProviders: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Enabled providers listed successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProvidersResponse"];
+                };
+            };
             /** @description Internal server error */
             500: {
                 headers: {
@@ -7734,7 +7870,7 @@ export interface operations {
     authCallback: {
         parameters: {
             query: {
-                /** @description Authorization code returned by WorkOS after user authentication */
+                /** @description Authorization code returned by the identity provider after user authentication */
                 code: string;
                 /** @description CSRF state value that must match the signed `vx_state` cookie */
                 state?: string;
@@ -7750,7 +7886,7 @@ export interface operations {
                 headers: {
                     /** @description Frontend home URL (e.g. https://app.example.com/) */
                     Location?: string;
-                    /** @description Encrypted session cookie (`vx_session`) containing the WorkOS access token */
+                    /** @description Encrypted session cookie (`vx_session`) containing the identity-provider access token */
                     "Set-Cookie"?: string;
                     [name: string]: unknown;
                 };
@@ -7774,7 +7910,7 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description WorkOS authentication failed or session could not be created */
+            /** @description Identity provider authentication failed or session could not be created */
             500: {
                 headers: {
                     [name: string]: unknown;
@@ -16720,7 +16856,10 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
@@ -16758,7 +16897,10 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
@@ -16819,6 +16961,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
                 /** @description Embedding provider ID */
                 id: string;
             };
@@ -16869,6 +17013,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
                 /** @description Embedding provider ID */
                 id: string;
             };
@@ -16932,6 +17078,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
                 /** @description Embedding provider ID */
                 id: string;
             };
@@ -16988,7 +17136,10 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
@@ -17039,7 +17190,10 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
@@ -17077,7 +17231,10 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
@@ -17138,6 +17295,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
                 /** @description Embedding provider ID */
                 id: string;
             };
@@ -17188,6 +17347,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
                 /** @description Embedding provider ID */
                 id: string;
             };
@@ -17251,6 +17412,8 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
                 /** @description Embedding provider ID */
                 id: string;
             };
@@ -17307,7 +17470,10 @@ export interface operations {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                /** @description Team that owns the embedding provider(s). */
+                team_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
@@ -18468,70 +18634,6 @@ export interface operations {
             };
         };
     };
-    sendContactMessage: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ContactFormRequest"];
-            };
-        };
-        responses: {
-            /** @description Message sent successfully */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ContactFormResponse"];
-                };
-            };
-            /**
-             * @description Validation failed (JSON body with `success: false`) or malformed JSON
-             *     (plain-text "Invalid JSON format")
-             */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ContactFormResponse"];
-                    "text/plain": string;
-                };
-            };
-            /** @description Request body exceeds the 64 KB size limit (plain-text body) */
-            413: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "text/plain": string;
-                };
-            };
-            /** @description Per-IP rate limit exceeded (plain-text body) */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "text/plain": string;
-                };
-            };
-            /** @description Failed to send message via the email provider (JSON body with `success` false) */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ContactFormResponse"];
-                };
-            };
-        };
-    };
     listFeedItemReplies: {
         parameters: {
             query?: {