@runtypelabs/sdk 4.8.0 → 4.9.0

package/dist/index.d.cts

@@ -3240,6 +3240,826 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/apps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List apps
+         * @description List apps for the authenticated owner, newest first.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Apps */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                activeVersionId: string | null;
+                                clientTokenId: string | null;
+                                createdAt: string;
+                                description: string | null;
+                                hostname: string;
+                                id: string;
+                                name: string;
+                                shortId: string;
+                                slug: string;
+                                /** @enum {string} */
+                                status: "active" | "suspended";
+                                updatedAt: string;
+                                url: string;
+                                /** @enum {string} */
+                                visibility: "public" | "unlisted";
+                            }[];
+                        };
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Create an app
+         * @description Create an app. The hostname is {slug}-{shortId}.runtype.run; a client token scoped to that origin is auto-provisioned. Upload a version and activate it to start serving.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        description?: string;
+                        name: string;
+                        /** @description Hostname slug: lowercase letters, digits, and hyphens; must start with a letter. The app serves at {slug}-{shortId}.runtype.run. */
+                        slug: string;
+                        /**
+                         * @default unlisted
+                         * @enum {string}
+                         */
+                        visibility?: "public" | "unlisted";
+                    };
+                };
+            };
+            responses: {
+                /** @description App created */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            activeVersionId: string | null;
+                            clientTokenId: string | null;
+                            createdAt: string;
+                            description: string | null;
+                            hostname: string;
+                            id: string;
+                            name: string;
+                            shortId: string;
+                            slug: string;
+                            /** @enum {string} */
+                            status: "active" | "suspended";
+                            updatedAt: string;
+                            url: string;
+                            /** @enum {string} */
+                            visibility: "public" | "unlisted";
+                        };
+                    };
+                };
+                /** @description Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Plan limit reached */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/apps/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get an app */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description App */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            activeVersionId: string | null;
+                            clientTokenId: string | null;
+                            createdAt: string;
+                            description: string | null;
+                            hostname: string;
+                            id: string;
+                            name: string;
+                            shortId: string;
+                            slug: string;
+                            /** @enum {string} */
+                            status: "active" | "suspended";
+                            updatedAt: string;
+                            url: string;
+                            /** @enum {string} */
+                            visibility: "public" | "unlisted";
+                        };
+                    };
+                };
+                /** @description Invalid id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        /**
+         * Delete an app
+         * @description Delete an app, its versions, and its routing. Stored bundle files are cleaned up in the background; the auto-provisioned client token is deactivated.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                        };
+                    };
+                };
+                /** @description Invalid id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update an app
+         * @description Update name, description, visibility, or status. Setting status to suspended makes the edge serve 410 for the app.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        description?: string | null;
+                        name?: string;
+                        /** @enum {string} */
+                        status?: "active" | "suspended";
+                        /** @enum {string} */
+                        visibility?: "public" | "unlisted";
+                    };
+                };
+            };
+            responses: {
+                /** @description Updated app */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            activeVersionId: string | null;
+                            clientTokenId: string | null;
+                            createdAt: string;
+                            description: string | null;
+                            hostname: string;
+                            id: string;
+                            name: string;
+                            shortId: string;
+                            slug: string;
+                            /** @enum {string} */
+                            status: "active" | "suspended";
+                            updatedAt: string;
+                            url: string;
+                            /** @enum {string} */
+                            visibility: "public" | "unlisted";
+                        };
+                    };
+                };
+                /** @description Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Plan limit reached */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/v1/apps/{id}/activate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Activate an app version
+         * @description Flip the active-version pointer to the given version (deploy or rollback). Syncs the app client token to the manifest capabilities and updates edge routing.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        versionId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Activated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            app: {
+                                activeVersionId: string | null;
+                                clientTokenId: string | null;
+                                createdAt: string;
+                                description: string | null;
+                                hostname: string;
+                                id: string;
+                                name: string;
+                                shortId: string;
+                                slug: string;
+                                /** @enum {string} */
+                                status: "active" | "suspended";
+                                updatedAt: string;
+                                url: string;
+                                /** @enum {string} */
+                                visibility: "public" | "unlisted";
+                            };
+                            version: {
+                                appId: string;
+                                bundleHash: string;
+                                createdAt: string;
+                                createdBy: string;
+                                fileCount: number;
+                                id: string;
+                                manifest: {
+                                    /** @enum {string} */
+                                    auth: "none" | "optional" | "required";
+                                    capabilities: {
+                                        agents: string[];
+                                        flows: string[];
+                                    };
+                                    data: {
+                                        /** @enum {string} */
+                                        access: "read" | "read-write";
+                                        namespace: string;
+                                    }[];
+                                    description?: string;
+                                    name: string;
+                                };
+                                sizeBytes: number;
+                                /** @enum {string} */
+                                status: "uploaded" | "active" | "superseded";
+                                versionNumber: number;
+                            };
+                        };
+                    };
+                };
+                /** @description Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/apps/{id}/versions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List an app's versions
+         * @description List all versions of an app, newest first.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Versions */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                appId: string;
+                                bundleHash: string;
+                                createdAt: string;
+                                createdBy: string;
+                                fileCount: number;
+                                id: string;
+                                manifest: {
+                                    /** @enum {string} */
+                                    auth: "none" | "optional" | "required";
+                                    capabilities: {
+                                        agents: string[];
+                                        flows: string[];
+                                    };
+                                    data: {
+                                        /** @enum {string} */
+                                        access: "read" | "read-write";
+                                        namespace: string;
+                                    }[];
+                                    description?: string;
+                                    name: string;
+                                };
+                                sizeBytes: number;
+                                /** @enum {string} */
+                                status: "uploaded" | "active" | "superseded";
+                                versionNumber: number;
+                            }[];
+                        };
+                    };
+                };
+                /** @description Invalid id */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Upload an app version
+         * @description Upload a zip bundle as a new version. The bundle must contain index.html and runtype.app.json at the root. Uploading does not change what is served; call activate to deploy.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            /** @description The app bundle as a zip archive. */
+            requestBody: {
+                content: {
+                    "application/zip": string;
+                };
+            };
+            responses: {
+                /** @description Version uploaded */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            appId: string;
+                            bundleHash: string;
+                            createdAt: string;
+                            createdBy: string;
+                            fileCount: number;
+                            id: string;
+                            manifest: {
+                                /** @enum {string} */
+                                auth: "none" | "optional" | "required";
+                                capabilities: {
+                                    agents: string[];
+                                    flows: string[];
+                                };
+                                data: {
+                                    /** @enum {string} */
+                                    access: "read" | "read-write";
+                                    namespace: string;
+                                }[];
+                                description?: string;
+                                name: string;
+                            };
+                            sizeBytes: number;
+                            /** @enum {string} */
+                            status: "uploaded" | "active" | "superseded";
+                            versionNumber: number;
+                        };
+                    };
+                };
+                /** @description Invalid bundle */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Plan limit reached */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Manifest uses reserved features */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description App storage not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/assets/preview/{orgId}/{assetId}": {
         parameters: {
             query?: never;
@@ -3428,7 +4248,7 @@ interface paths {
         };
         /**
          * Get current user info
-         * @description Get the current user and organization info from the Clerk session.
+         * @description Get the current user and organization info for the authenticated caller (Clerk session or API key).
          */
         get: {
             parameters: {
@@ -10313,50 +11133,185 @@ interface paths {
                 };
             };
         };
-        put?: never;
+        put?: never;
+        /**
+         * Create or update an integration config
+         * @description Stores an API key for the specified integration provider. Storing a NEW integration key requires the BYOK (Bring Your Own Key) entitlement; rotating a key that already exists for the provider is always allowed.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Integration provider name */
+                    provider: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description API key for the provider */
+                        apiKey: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Integration config saved */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                        };
+                    };
+                };
+                /** @description Invalid request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description BYOK entitlement required */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        /**
+         * Delete an integration config
+         * @description Removes the API key and configuration for the specified integration provider.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Integration provider name */
+                    provider: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Integration config deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                        };
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Forbidden */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/integrations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Create or update an integration config
-         * @description Stores an API key for the specified integration provider. Storing a NEW integration key requires the BYOK (Bring Your Own Key) entitlement; rotating a key that already exists for the provider is always allowed.
+         * List integrations
+         * @description List all available integrations with the caller’s configuration status. Optionally filter credential status by environment.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Integration provider name */
-                    provider: string;
+                query?: {
+                    environment?: string;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        /** @description API key for the provider */
-                        apiKey: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Integration config saved */
+                /** @description List of integrations with configuration status */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            success: boolean;
+                            integrations: {
+                                category: string;
+                                description: string;
+                                documentationUrl?: string;
+                                icon?: string;
+                                id: string;
+                                isConfigured: boolean;
+                                missingCredentials: string[];
+                                name: string;
+                                requiredCredentials: string[];
+                                toolCount: number;
+                            }[];
+                            total: number;
                         };
                     };
                 };
-                /** @description Invalid request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
                 /** @description Unauthorized */
                 401: {
                     headers: {
@@ -10366,16 +11321,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description BYOK entitlement required */
-                402: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["Error"];
-                    };
-                };
-                /** @description Forbidden */
+                /** @description Insufficient permissions */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -10395,30 +11341,39 @@ interface paths {
                 };
             };
         };
+        put?: never;
         /**
-         * Delete an integration config
-         * @description Removes the API key and configuration for the specified integration provider.
+         * Reserve a new integration
+         * @description Reserve a new integration row server-side. Returns a pending row scoped to the authenticated owner whose id may be embedded in provider manifests before credentials are supplied.
          */
-        delete: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Integration provider name */
-                    provider: string;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        provider: "slack" | "telegram";
+                    };
+                };
+            };
             responses: {
-                /** @description Integration config deleted */
-                200: {
+                /** @description Pending integration reserved */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            success: boolean;
+                            createdAt: string;
+                            expiresAt: string;
+                            id: string;
+                            provider: string;
+                            status: string;
                         };
                     };
                 };
@@ -10431,7 +11386,7 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
-                /** @description Forbidden */
+                /** @description Insufficient permissions */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -10440,14 +11395,24 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/integrations": {
+    "/v1/integrations/category/{category}": {
         parameters: {
             query?: never;
             header?: never;
@@ -10455,21 +11420,21 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List integrations
-         * @description List all available integrations with the caller’s configuration status. Optionally filter credential status by environment.
+         * List integrations by category
+         * @description List integrations within a given category along with the caller’s configuration status for each.
          */
         get: {
             parameters: {
-                query?: {
-                    environment?: string;
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    category: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description List of integrations with configuration status */
+                /** @description List of integrations in the category */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -10522,38 +11487,50 @@ interface paths {
             };
         };
         put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/integrations/connections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Reserve a new integration
-         * @description Reserve a new integration row server-side. Returns a pending row scoped to the authenticated owner whose id may be embedded in provider manifests before credentials are supplied.
+         * List connected integration accounts
+         * @description List the caller's connected integration accounts (with their integration IDs) for a provider. Use the integration ID to pin a tool instance to a specific connection, e.g. a Granola tool's toolConfigs integrationId.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query: {
+                    /** @description Integration provider, e.g. granola or slack. */
+                    provider: string;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        /** @enum {string} */
-                        provider: "slack" | "telegram";
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Pending integration reserved */
-                201: {
+                /** @description Connected accounts for the provider */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            createdAt: string;
-                            expiresAt: string;
-                            id: string;
-                            provider: string;
-                            status: string;
+                            connections: {
+                                accountName: string;
+                                createdAt: string;
+                                integrationId: string;
+                                provider: string;
+                                status: string;
+                            }[];
                         };
                     };
                 };
@@ -10586,13 +11563,15 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/integrations/category/{category}": {
+    "/v1/integrations/credentials-status": {
         parameters: {
             query?: never;
             header?: never;
@@ -10600,40 +11579,41 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List integrations by category
-         * @description List integrations within a given category along with the caller’s configuration status for each.
+         * Get integration credential status
+         * @description Return which environments have credentials configured for each integration for the authenticated caller.
          */
         get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    category: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description List of integrations in the category */
+                /** @description Per-environment credential status */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            integrations: {
-                                category: string;
+                            integrations: ({
                                 description: string;
                                 documentationUrl?: string;
-                                icon?: string;
+                                environments: {
+                                    all: boolean;
+                                    development: boolean;
+                                    production: boolean;
+                                };
+                                hasPlatformKey?: boolean;
+                                hasUserKey?: boolean;
                                 id: string;
                                 isConfigured: boolean;
-                                missingCredentials: string[];
                                 name: string;
-                                requiredCredentials: string[];
-                                toolCount: number;
-                            }[];
-                            total: number;
+                            } & {
+                                [key: string]: unknown;
+                            })[];
                         };
                     };
                 };
@@ -10674,49 +11654,44 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/integrations/credentials-status": {
+    "/v1/integrations/granola/install": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get integration credential status
-         * @description Return which environments have credentials configured for each integration for the authenticated caller.
+         * Install Granola integration
+         * @description Install or upsert a Granola integration for the authenticated owner. Verifies the pasted API key against the Granola public API before storing it in the secret store. Re-pasting the same key updates the existing connection.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        apiKey: string;
+                        displayName?: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Per-environment credential status */
+                /** @description Granola integration installed */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            integrations: ({
-                                description: string;
-                                documentationUrl?: string;
-                                environments: {
-                                    all: boolean;
-                                    development: boolean;
-                                    production: boolean;
-                                };
-                                hasPlatformKey?: boolean;
-                                hasUserKey?: boolean;
-                                id: string;
-                                isConfigured: boolean;
-                                name: string;
-                            } & {
-                                [key: string]: unknown;
-                            })[];
+                            created: boolean;
+                            integrationId: string;
                         };
                     };
                 };
@@ -10738,6 +11713,15 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Granola rejected the API key (invalid key or plan does not include API access) */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -10747,10 +11731,17 @@ interface paths {
                         "application/json": components["schemas"]["Error"];
                     };
                 };
+                /** @description Granola API unreachable during key verification */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -14018,6 +15009,8 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            /** @description When the response was served from cache, the cache write time. Null for fresh responses. */
+                            cachedAt?: string | null;
                             data: {
                                 byCategory: {
                                     [key: string]: number;
@@ -32011,7 +33004,9 @@ interface paths {
                             dashboardUrl: string;
                             email: string | null;
                             features: {
+                                dashboardAssistantModel: string;
                                 enableAgentSkills: boolean;
+                                enableDashboardAssistant: boolean;
                                 productGeneratorModel: string;
                             };
                             id: string;
@@ -39180,6 +40175,12 @@ interface LocalToolExecutionLoopSnapshot {
 }
 interface ExecuteWithLocalToolsOptions {
     onLocalToolResult?: (snapshot: LocalToolExecutionLoopSnapshot) => AgentCompleteEvent | null | undefined;
+    /**
+     * Polled after each local tool execution. Returning true ends the session
+     * early (synthetic `agent_complete`) so queued user steering can be
+     * delivered at the next session boundary instead of after the full session.
+     */
+    shouldInterrupt?: () => boolean;
 }
 /**
  * Status of a long-task agent run
@@ -39435,6 +40436,20 @@ interface RunTaskOptions {
     workflow?: WorkflowDefinition;
     /** IDs of built-in tools to enable for the agent (e.g., "exa", "firecrawl", "dalle") */
     toolIds?: string[];
+    /**
+     * Mid-run steering queue: called at every session boundary; returned
+     * messages are DRAINED and injected as user steering at the start of the
+     * next session's context. Pair with `hasQueuedUserMessages` to also end
+     * in-flight sessions early at the next local-tool pause.
+     */
+    getQueuedUserMessages?: () => string[] | undefined;
+    /**
+     * Non-draining peek at the steering queue. When it returns true after a
+     * local tool executes, the current session ends early (synthetic
+     * `agent_complete`) so the queued steering is delivered within seconds
+     * instead of after the session completes.
+     */
+    hasQueuedUserMessages?: () => boolean;
 }
 /**
  * Final result returned by `agents.runTask()`