@runtypelabs/sdk 4.5.0 → 4.6.1

package/dist/index.d.cts

@@ -6804,6 +6804,95 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/docs/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Search documentation
+         * @description Semantic search over the published Runtype documentation corpus. Returns a synthesized answer with citations. Use this for prose/how-to questions; for deterministic schemas and build guidance use the /v1/documentation endpoints.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description Natural-language documentation question. */
+                        query: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Documentation search result (MCP content blocks) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            content: ({
+                                text?: string;
+                                type: string;
+                            } & {
+                                [key: string]: unknown;
+                            })[];
+                        };
+                    };
+                };
+                /** @description Invalid parameters */
+                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 Documentation search is not enabled */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Upstream documentation search failed */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/documentation": {
         parameters: {
             query?: never;
@@ -13647,6 +13736,10 @@ interface paths {
                     surface_id?: string;
                     /** @description Filter by status (open, closed, archived, all) */
                     status?: string;
+                    /** @description Filter by agent mode (auto, human, all) */
+                    agentMode?: string;
+                    /** @description Filter by agent mode (deprecated, use agentMode) */
+                    agent_mode?: string;
                     /** @description Search by subject, participant name, or email */
                     search?: string;
                 };
@@ -13664,6 +13757,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: ({
+                                agentMode: string;
                                 createdAt: string;
                                 externalParticipantId: string | null;
                                 externalThreadId: string | null;
@@ -13675,6 +13769,10 @@ interface paths {
                                 status: string;
                                 subject: string | null;
                                 surfaceId: string;
+                                takeoverActorId: string | null;
+                                takeoverActorType: string | null;
+                                takeoverAt: string | null;
+                                takeoverReason: string | null;
                                 timezone: string | null;
                                 updatedAt: string;
                             } & {
@@ -13768,6 +13866,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            agentMode: string;
                             context?: {
                                 [key: string]: unknown;
                             };
@@ -13790,6 +13889,10 @@ interface paths {
                                 type: string | null;
                             };
                             surfaceId: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
                             timezone: string | null;
                             updatedAt: string;
                         } & {
@@ -13870,6 +13973,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            agentMode: string;
                             context?: {
                                 [key: string]: unknown;
                             };
@@ -13892,6 +13996,10 @@ interface paths {
                                 type: string | null;
                             };
                             surfaceId: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
                             timezone: string | null;
                             updatedAt: string;
                         } & {
@@ -13981,6 +14089,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            agentMode: string;
                             context?: {
                                 [key: string]: unknown;
                             };
@@ -14003,6 +14112,10 @@ interface paths {
                                 type: string | null;
                             };
                             surfaceId: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
                             timezone: string | null;
                             updatedAt: string;
                         } & {
@@ -14346,6 +14459,369 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/messaging/conversations/{id}/resume": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Resume agent handling
+         * @description Switch a messaging conversation from human-operator mode back to automatic agent handling.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Conversation resumed to auto mode */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            agentMode: string;
+                            id: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
+                            updatedAt: string;
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @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 Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation already in auto mode */
+                409: {
+                    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/messaging/conversations/{id}/send": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send human-authored message
+         * @description Send a human-authored outbound message through the conversation's messaging channel.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        content: string;
+                        metadata?: {
+                            attachments?: {
+                                contentType: string;
+                                name: string;
+                                size: number;
+                                url?: string;
+                            }[];
+                            externalTimestamp?: string;
+                            headers?: {
+                                [key: string]: string;
+                            };
+                        };
+                        /** @default true */
+                        requireHumanMode?: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Message sent to channel */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            deliveryResult: {
+                                deliveryStatus: string;
+                                externalMessageId: string | null;
+                            } & {
+                                [key: string]: unknown;
+                            };
+                            message: {
+                                content: string;
+                                conversationId: string;
+                                createdAt: string;
+                                direction: string | null;
+                                externalMessageId: string | null;
+                                id?: string;
+                                metadata: {
+                                    [key: string]: unknown;
+                                };
+                                role: string;
+                            } & {
+                                [key: string]: unknown;
+                            };
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @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 Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation or surface cannot be addressed */
+                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 Channel delivery failed */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/messaging/conversations/{id}/takeover": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Take over conversation
+         * @description Switch a messaging conversation into human-operator mode so inbound messages are persisted but agent replies are suppressed.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        reason?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Conversation switched to human mode */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            agentMode: string;
+                            id: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
+                            updatedAt: string;
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @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 Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation already in human mode */
+                409: {
+                    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/messaging/imap/{surfaceId}/poll-now": {
         parameters: {
             query?: never;
@@ -17651,7 +18127,9 @@ interface paths {
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    includeEditorContext?: string;
+                };
                 header?: never;
                 path: {
                     id: string;
@@ -17674,6 +18152,17 @@ interface paths {
                             createdAt: string;
                             dashboardUrl?: string;
                             description: string | null;
+                            editorContext?: {
+                                agentConfigMap: {
+                                    [key: string]: unknown;
+                                };
+                                flowStepsMap: {
+                                    [key: string]: {
+                                        name: string;
+                                        type: string;
+                                    }[];
+                                };
+                            };
                             icon: string | null;
                             id: string;
                             name: string;
@@ -34342,6 +34831,18 @@ interface DispatchRequest {
     };
     secrets?: Record<string, string>;
     inputs?: Record<string, unknown>;
+    /**
+     * End-user identity for multi-tenant SaaS callers whose users are not Runtype account
+     * holders. Exposed as `{{_endUser.id}}`, `{{_endUser.email}}`, etc. in template variables
+     * — used most commonly by agent memory namespace templates like `{{_endUser.id}}` to
+     * shard long-term memory per end-user. Extra fields (name, tier, custom claims) are
+     * forwarded verbatim and exposed under `_endUser.*`.
+     */
+    endUser?: {
+        id: string;
+        email?: string;
+        [key: string]: unknown;
+    };
     options?: {
         streamResponse?: boolean;
         modelOverride?: string;
@@ -37862,6 +38363,18 @@ interface AgentExecuteRequest {
     messages: AgentMessage[];
     /** Variables to pass to the agent */
     variables?: Record<string, unknown>;
+    /**
+     * End-user identity for multi-tenant SaaS callers whose users are not Runtype account
+     * holders. Exposed as `{{_endUser.id}}`, `{{_endUser.email}}`, etc. in template variables
+     * — used most commonly by agent memory namespace templates like `{{_endUser.id}}` to
+     * shard long-term memory per end-user. Extra fields (name, tier, custom claims) are
+     * forwarded verbatim and exposed under `_endUser.*`.
+     */
+    endUser?: {
+        id: string;
+        email?: string;
+        [key: string]: unknown;
+    };
     /** Enable streaming response (default: true) */
     streamResponse?: boolean;
     /** Enable debug mode to include all fields in events */

package/dist/index.d.ts

@@ -6804,6 +6804,95 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/docs/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Search documentation
+         * @description Semantic search over the published Runtype documentation corpus. Returns a synthesized answer with citations. Use this for prose/how-to questions; for deterministic schemas and build guidance use the /v1/documentation endpoints.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description Natural-language documentation question. */
+                        query: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Documentation search result (MCP content blocks) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            content: ({
+                                text?: string;
+                                type: string;
+                            } & {
+                                [key: string]: unknown;
+                            })[];
+                        };
+                    };
+                };
+                /** @description Invalid parameters */
+                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 Documentation search is not enabled */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Upstream documentation search failed */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/documentation": {
         parameters: {
             query?: never;
@@ -13647,6 +13736,10 @@ interface paths {
                     surface_id?: string;
                     /** @description Filter by status (open, closed, archived, all) */
                     status?: string;
+                    /** @description Filter by agent mode (auto, human, all) */
+                    agentMode?: string;
+                    /** @description Filter by agent mode (deprecated, use agentMode) */
+                    agent_mode?: string;
                     /** @description Search by subject, participant name, or email */
                     search?: string;
                 };
@@ -13664,6 +13757,7 @@ interface paths {
                     content: {
                         "application/json": {
                             data: ({
+                                agentMode: string;
                                 createdAt: string;
                                 externalParticipantId: string | null;
                                 externalThreadId: string | null;
@@ -13675,6 +13769,10 @@ interface paths {
                                 status: string;
                                 subject: string | null;
                                 surfaceId: string;
+                                takeoverActorId: string | null;
+                                takeoverActorType: string | null;
+                                takeoverAt: string | null;
+                                takeoverReason: string | null;
                                 timezone: string | null;
                                 updatedAt: string;
                             } & {
@@ -13768,6 +13866,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            agentMode: string;
                             context?: {
                                 [key: string]: unknown;
                             };
@@ -13790,6 +13889,10 @@ interface paths {
                                 type: string | null;
                             };
                             surfaceId: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
                             timezone: string | null;
                             updatedAt: string;
                         } & {
@@ -13870,6 +13973,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            agentMode: string;
                             context?: {
                                 [key: string]: unknown;
                             };
@@ -13892,6 +13996,10 @@ interface paths {
                                 type: string | null;
                             };
                             surfaceId: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
                             timezone: string | null;
                             updatedAt: string;
                         } & {
@@ -13981,6 +14089,7 @@ interface paths {
                     };
                     content: {
                         "application/json": {
+                            agentMode: string;
                             context?: {
                                 [key: string]: unknown;
                             };
@@ -14003,6 +14112,10 @@ interface paths {
                                 type: string | null;
                             };
                             surfaceId: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
                             timezone: string | null;
                             updatedAt: string;
                         } & {
@@ -14346,6 +14459,369 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/messaging/conversations/{id}/resume": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Resume agent handling
+         * @description Switch a messaging conversation from human-operator mode back to automatic agent handling.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Conversation resumed to auto mode */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            agentMode: string;
+                            id: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
+                            updatedAt: string;
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @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 Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation already in auto mode */
+                409: {
+                    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/messaging/conversations/{id}/send": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send human-authored message
+         * @description Send a human-authored outbound message through the conversation's messaging channel.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        content: string;
+                        metadata?: {
+                            attachments?: {
+                                contentType: string;
+                                name: string;
+                                size: number;
+                                url?: string;
+                            }[];
+                            externalTimestamp?: string;
+                            headers?: {
+                                [key: string]: string;
+                            };
+                        };
+                        /** @default true */
+                        requireHumanMode?: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Message sent to channel */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            deliveryResult: {
+                                deliveryStatus: string;
+                                externalMessageId: string | null;
+                            } & {
+                                [key: string]: unknown;
+                            };
+                            message: {
+                                content: string;
+                                conversationId: string;
+                                createdAt: string;
+                                direction: string | null;
+                                externalMessageId: string | null;
+                                id?: string;
+                                metadata: {
+                                    [key: string]: unknown;
+                                };
+                                role: string;
+                            } & {
+                                [key: string]: unknown;
+                            };
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @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 Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation or surface cannot be addressed */
+                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 Channel delivery failed */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/messaging/conversations/{id}/takeover": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Take over conversation
+         * @description Switch a messaging conversation into human-operator mode so inbound messages are persisted but agent replies are suppressed.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        reason?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Conversation switched to human mode */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            agentMode: string;
+                            id: string;
+                            takeoverActorId: string | null;
+                            takeoverActorType: string | null;
+                            takeoverAt: string | null;
+                            takeoverReason: string | null;
+                            updatedAt: string;
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @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 Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Conversation already in human mode */
+                409: {
+                    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/messaging/imap/{surfaceId}/poll-now": {
         parameters: {
             query?: never;
@@ -17651,7 +18127,9 @@ interface paths {
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    includeEditorContext?: string;
+                };
                 header?: never;
                 path: {
                     id: string;
@@ -17674,6 +18152,17 @@ interface paths {
                             createdAt: string;
                             dashboardUrl?: string;
                             description: string | null;
+                            editorContext?: {
+                                agentConfigMap: {
+                                    [key: string]: unknown;
+                                };
+                                flowStepsMap: {
+                                    [key: string]: {
+                                        name: string;
+                                        type: string;
+                                    }[];
+                                };
+                            };
                             icon: string | null;
                             id: string;
                             name: string;
@@ -34342,6 +34831,18 @@ interface DispatchRequest {
     };
     secrets?: Record<string, string>;
     inputs?: Record<string, unknown>;
+    /**
+     * End-user identity for multi-tenant SaaS callers whose users are not Runtype account
+     * holders. Exposed as `{{_endUser.id}}`, `{{_endUser.email}}`, etc. in template variables
+     * — used most commonly by agent memory namespace templates like `{{_endUser.id}}` to
+     * shard long-term memory per end-user. Extra fields (name, tier, custom claims) are
+     * forwarded verbatim and exposed under `_endUser.*`.
+     */
+    endUser?: {
+        id: string;
+        email?: string;
+        [key: string]: unknown;
+    };
     options?: {
         streamResponse?: boolean;
         modelOverride?: string;
@@ -37862,6 +38363,18 @@ interface AgentExecuteRequest {
     messages: AgentMessage[];
     /** Variables to pass to the agent */
     variables?: Record<string, unknown>;
+    /**
+     * End-user identity for multi-tenant SaaS callers whose users are not Runtype account
+     * holders. Exposed as `{{_endUser.id}}`, `{{_endUser.email}}`, etc. in template variables
+     * — used most commonly by agent memory namespace templates like `{{_endUser.id}}` to
+     * shard long-term memory per end-user. Extra fields (name, tier, custom claims) are
+     * forwarded verbatim and exposed under `_endUser.*`.
+     */
+    endUser?: {
+        id: string;
+        email?: string;
+        [key: string]: unknown;
+    };
     /** Enable streaming response (default: true) */
     streamResponse?: boolean;
     /** Enable debug mode to include all fields in events */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "4.5.0",
+  "version": "4.6.1",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",