@runtypelabs/sdk 9.5.0 → 9.6.0

package/dist/index.cjs

@@ -6484,7 +6484,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.5.0".length > 0 ? "9.5.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.6.0".length > 0 ? "9.6.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/dist/index.d.cts

@@ -564,7 +564,6 @@ interface paths {
                                 id: string;
                                 lastRunAt?: string | null;
                                 name: string;
-                                primaryFlowId: string | null;
                                 status: string;
                                 updatedAt: string;
                             }[];
@@ -977,7 +976,11 @@ interface paths {
                         icon?: string;
                         maxTurns?: number;
                         name: string;
-                        primaryFlowId?: string | null;
+                        /**
+                         * @deprecated
+                         * @description primaryFlowId is retired: primary-flow agents were removed (ADR 0024). Attach the flow to the agent as a runtime tool ({ toolType: 'flow', flowId }) or dispatch the flow directly via POST /v1/dispatch.
+                         */
+                        primaryFlowId?: null;
                     };
                 };
             };
@@ -1026,7 +1029,6 @@ interface paths {
                             lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
-                            primaryFlowId: string | null;
                             publishedVersionId: string | null;
                             status: string;
                             updatedAt: string;
@@ -1699,11 +1701,6 @@ interface paths {
                             lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
-                            primaryFlow: {
-                                id: string;
-                                name: string;
-                            } | null;
-                            primaryFlowId: string | null;
                             publishedVersionId: string | null;
                             status: string;
                             updatedAt: string;
@@ -2107,7 +2104,11 @@ interface paths {
                         icon?: string;
                         maxTurns?: number;
                         name?: string;
-                        primaryFlowId?: string | null;
+                        /**
+                         * @deprecated
+                         * @description primaryFlowId is retired: primary-flow agents were removed (ADR 0024). Attach the flow to the agent as a runtime tool ({ toolType: 'flow', flowId }) or dispatch the flow directly via POST /v1/dispatch.
+                         */
+                        primaryFlowId?: null;
                     };
                 };
             };
@@ -2143,7 +2144,6 @@ interface paths {
                             lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
-                            primaryFlowId: string | null;
                             publishedVersionId: string | null;
                             status: string;
                             updatedAt: string;
@@ -3567,9 +3567,6 @@ interface paths {
                             hostDependencies: components["schemas"]["RuntimeHostDependency"][];
                             id: string;
                             name: string;
-                            primaryFlow?: {
-                                [key: string]: unknown;
-                            };
                         };
                     };
                 };
@@ -3768,7 +3765,6 @@ interface paths {
                             id: string;
                             name: string;
                             organizationId: string | null;
-                            primaryFlowId: string | null;
                             status: string;
                             updatedAt: string;
                             userId: string;
@@ -5040,6 +5036,8 @@ interface paths {
                     content: {
                         "application/json": {
                             hasOrganization: boolean;
+                            /** @enum {string|null} */
+                            onboardingIntent: "build_new" | "connect_existing" | "unstated" | null;
                             orgId?: string | null;
                             orgRole?: string | null;
                             orgSlug?: string | null;
@@ -5245,23 +5243,23 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        /** @description Agent to execute per record instead of a flow. Each record then carries its conversation in metadata.messages. */
-                        agentId?: string;
+                        /** @description Agent to execute per record instead of a flow. Saved records are loaded and their conversation read from metadata.messages; inline records reach the agent only when their type is _agent_eval or _agent_schedule and metadata.messages carries the conversation. Any other inline record type fails per record. */
+                        agentId?: string | null;
                         flowDefinition?: components["schemas"]["BatchFlowDefinition"];
                         /** @description Saved flow to execute per record. One of flowId, flowDefinition, or agentId is required. */
-                        flowId?: string;
+                        flowId?: string | null;
                         /** @description Flow input variables applied to every record execution. */
                         inputs?: {
                             [key: string]: unknown;
-                        };
+                        } | null;
                         /** @description Conversation seed passed unchanged to every record execution. Records cannot see each other's history. */
                         messages?: ({
                             content?: unknown;
                             role: string;
                         } & {
                             [key: string]: unknown;
-                        })[];
-                        options?: {
+                        })[] | null;
+                        options?: ({
                             /** @description Records admitted to one processing chunk before progress is flushed and batch gates are re-checked. */
                             chunkSize?: number;
                             /** @description Flow-wide deadline passed to every per-record flow execution. */
@@ -5282,11 +5280,11 @@ interface paths {
                             timeoutMs?: number;
                         } & {
                             [key: string]: unknown;
-                        };
+                        }) | null;
                         /** @description Saved record ids to process. May be combined with records; the batch runs the union. At least one of recordIds or records must be non-empty. Maximum 50000 records per batch across both. */
-                        recordIds?: string[];
+                        recordIds?: string[] | null;
                         /** @description Inline records to process without saving them first. May be combined with recordIds. Maximum 50000 records per batch across both. */
-                        records?: components["schemas"]["BatchInlineRecord"][];
+                        records?: components["schemas"]["BatchInlineRecord"][] | null;
                     } & {
                         [key: string]: unknown;
                     };
@@ -7818,7 +7816,7 @@ interface paths {
                             };
                             /** @description The created (or resumed) client session ID. */
                             sessionId: string;
-                            /** @description The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record, including the case where an agent-only token resolves its agent to a primary flow. Absent only on the data-only Runtype App branch, which is not chat-capable. */
+                            /** @description The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record; an agent-only token resolves to its agent id. Absent only on the data-only Runtype App branch, which is not chat-capable. */
                             targetId?: string;
                             /** @description The browser's anonymous visitor identity. Present when the request opts into visitor history (or supplies a visitor token, identity proof, or conversation id). Authenticates the `/client/conversations*` history routes, which the site-wide client token alone cannot reach. */
                             visitor?: {
@@ -42215,6 +42213,256 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/surfaces/{surfaceId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get surface details
+         * @description Get an authorized surface by its globally unique ID, including items and keys.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    surfaceId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Surface details */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            behavior?: unknown;
+                            createdAt: string;
+                            /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
+                            endpoint: string | null;
+                            id: string;
+                            inbound?: unknown;
+                            items: {
+                                agentId: string | null;
+                                agentType: string | null;
+                                cachedSkills: unknown[] | null;
+                                capabilityId: string;
+                                capabilityName: string | null;
+                                config?: unknown;
+                                createdAt: string;
+                                displayOrder: number | null;
+                                enabled: boolean;
+                                endpointSlug: string | null;
+                                exposedDescription: string | null;
+                                exposedName: string | null;
+                                flowId: string | null;
+                                id: string;
+                                isEntryPoint: boolean;
+                                parametersSchema?: unknown;
+                            }[];
+                            keys: {
+                                canReveal: boolean;
+                                createdAt: string;
+                                environment: string;
+                                expiresAt: string | null;
+                                id: string;
+                                isActive: boolean;
+                                isDevelopment: boolean;
+                                keyHint: string | null;
+                                keyPrefix: string;
+                                lastUsedAt: string | null;
+                                name: string | null;
+                                rateLimitPerDay: number | null;
+                                rateLimitPerMinute: number | null;
+                                scopeTargetIds: string[] | null;
+                                scopes: string[];
+                                usageCount: number | null;
+                            }[];
+                            name: string;
+                            outbound?: unknown;
+                            productId: string;
+                            scopeTargets: {
+                                capabilityId?: string;
+                                id: string;
+                                name: string;
+                                surfaceItemId?: string;
+                            }[];
+                            status: string;
+                            type: string;
+                            updatedAt: string;
+                            webhookHealth: components["schemas"]["WebhookHealth"];
+                        };
+                    };
+                };
+                /** @description Invalid surface 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 Surface 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"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/surfaces/{surfaceId}/test-deliveries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send a provider fixture through a surface’s real ingress
+         * @description Resolve an authorized surface by its globally unique ID and send a provider-native fixture through the same authenticated ingress used by production deliveries.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    surfaceId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        fixture: "github.pull_request.opened" | "github.pull_request.merged_plan";
+                        planningPath?: string;
+                        pullRequest: number;
+                        repeat?: number;
+                        repository: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Provider delivery attempts accepted by the surface ingress. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Invalid fixture or repository state. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Authentication required. */
+                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 Surface not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The surface or provider credential is not ready. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description GitHub or the surface ingress rejected the delivery. */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/tool-approval-grants": {
         parameters: {
             query?: never;
@@ -44193,6 +44441,91 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/users/onboarding/intent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Set onboarding intent
+         * @description Record what the authenticated user came to Runtype to do (dashboard only). Readable afterwards on GET /v1/auth/me.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        onboardingIntent: "build_new" | "connect_existing" | "unstated";
+                    };
+                };
+            };
+            responses: {
+                /** @description Stored onboarding intent */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            onboardingIntent: "build_new" | "connect_existing" | "unstated";
+                        };
+                    };
+                };
+                /** @description Validation error */
+                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 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/users/onboarding/reset": {
         parameters: {
             query?: never;
@@ -44300,6 +44633,7 @@ interface paths {
                                 enableDashboardAssistant: boolean;
                                 enableEndUserUsageAnalytics: boolean;
                                 enableMassiveWebRender: boolean;
+                                enableOnboardingIntentGate: boolean;
                                 enableRuntown: boolean;
                                 enableRuntypeApps: boolean;
                                 enableSelfServeOauthClients: boolean;
@@ -45111,8 +45445,8 @@ interface components {
             targetKind: "flow" | "agent";
         };
         /** @description Inline flow definition executed per record without saving the flow. */
-        BatchFlowDefinition: {
-            description?: string;
+        BatchFlowDefinition: ({
+            description?: string | null;
             /** @description Saved-flow identity retained when the definition is a pinned snapshot. */
             id?: string;
             name: string;
@@ -45122,7 +45456,7 @@ interface components {
             }[];
         } & {
             [key: string]: unknown;
-        };
+        }) | null;
         /** @description An ad-hoc record processed in place of a saved record. Inline records never touch the records table; each is minted a synthetic id for the lifetime of the batch. */
         BatchInlineRecord: {
             /** @description Arbitrary JSON payload exposed to the flow as {{_record.metadata.*}}. Any shape is accepted; nothing is written to the records table. */
@@ -56116,7 +56450,6 @@ interface Agent {
     name: string;
     description: string | null;
     agentType: string;
-    primaryFlowId: string | null;
     config: Record<string, unknown> | null;
     externalConfig: Record<string, unknown> | null;
     createdAt: string;

package/dist/index.d.ts

@@ -564,7 +564,6 @@ interface paths {
                                 id: string;
                                 lastRunAt?: string | null;
                                 name: string;
-                                primaryFlowId: string | null;
                                 status: string;
                                 updatedAt: string;
                             }[];
@@ -977,7 +976,11 @@ interface paths {
                         icon?: string;
                         maxTurns?: number;
                         name: string;
-                        primaryFlowId?: string | null;
+                        /**
+                         * @deprecated
+                         * @description primaryFlowId is retired: primary-flow agents were removed (ADR 0024). Attach the flow to the agent as a runtime tool ({ toolType: 'flow', flowId }) or dispatch the flow directly via POST /v1/dispatch.
+                         */
+                        primaryFlowId?: null;
                     };
                 };
             };
@@ -1026,7 +1029,6 @@ interface paths {
                             lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
-                            primaryFlowId: string | null;
                             publishedVersionId: string | null;
                             status: string;
                             updatedAt: string;
@@ -1699,11 +1701,6 @@ interface paths {
                             lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
-                            primaryFlow: {
-                                id: string;
-                                name: string;
-                            } | null;
-                            primaryFlowId: string | null;
                             publishedVersionId: string | null;
                             status: string;
                             updatedAt: string;
@@ -2107,7 +2104,11 @@ interface paths {
                         icon?: string;
                         maxTurns?: number;
                         name?: string;
-                        primaryFlowId?: string | null;
+                        /**
+                         * @deprecated
+                         * @description primaryFlowId is retired: primary-flow agents were removed (ADR 0024). Attach the flow to the agent as a runtime tool ({ toolType: 'flow', flowId }) or dispatch the flow directly via POST /v1/dispatch.
+                         */
+                        primaryFlowId?: null;
                     };
                 };
             };
@@ -2143,7 +2144,6 @@ interface paths {
                             lastModifiedSource: string | null;
                             name: string;
                             organizationId: string | null;
-                            primaryFlowId: string | null;
                             publishedVersionId: string | null;
                             status: string;
                             updatedAt: string;
@@ -3567,9 +3567,6 @@ interface paths {
                             hostDependencies: components["schemas"]["RuntimeHostDependency"][];
                             id: string;
                             name: string;
-                            primaryFlow?: {
-                                [key: string]: unknown;
-                            };
                         };
                     };
                 };
@@ -3768,7 +3765,6 @@ interface paths {
                             id: string;
                             name: string;
                             organizationId: string | null;
-                            primaryFlowId: string | null;
                             status: string;
                             updatedAt: string;
                             userId: string;
@@ -5040,6 +5036,8 @@ interface paths {
                     content: {
                         "application/json": {
                             hasOrganization: boolean;
+                            /** @enum {string|null} */
+                            onboardingIntent: "build_new" | "connect_existing" | "unstated" | null;
                             orgId?: string | null;
                             orgRole?: string | null;
                             orgSlug?: string | null;
@@ -5245,23 +5243,23 @@ interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        /** @description Agent to execute per record instead of a flow. Each record then carries its conversation in metadata.messages. */
-                        agentId?: string;
+                        /** @description Agent to execute per record instead of a flow. Saved records are loaded and their conversation read from metadata.messages; inline records reach the agent only when their type is _agent_eval or _agent_schedule and metadata.messages carries the conversation. Any other inline record type fails per record. */
+                        agentId?: string | null;
                         flowDefinition?: components["schemas"]["BatchFlowDefinition"];
                         /** @description Saved flow to execute per record. One of flowId, flowDefinition, or agentId is required. */
-                        flowId?: string;
+                        flowId?: string | null;
                         /** @description Flow input variables applied to every record execution. */
                         inputs?: {
                             [key: string]: unknown;
-                        };
+                        } | null;
                         /** @description Conversation seed passed unchanged to every record execution. Records cannot see each other's history. */
                         messages?: ({
                             content?: unknown;
                             role: string;
                         } & {
                             [key: string]: unknown;
-                        })[];
-                        options?: {
+                        })[] | null;
+                        options?: ({
                             /** @description Records admitted to one processing chunk before progress is flushed and batch gates are re-checked. */
                             chunkSize?: number;
                             /** @description Flow-wide deadline passed to every per-record flow execution. */
@@ -5282,11 +5280,11 @@ interface paths {
                             timeoutMs?: number;
                         } & {
                             [key: string]: unknown;
-                        };
+                        }) | null;
                         /** @description Saved record ids to process. May be combined with records; the batch runs the union. At least one of recordIds or records must be non-empty. Maximum 50000 records per batch across both. */
-                        recordIds?: string[];
+                        recordIds?: string[] | null;
                         /** @description Inline records to process without saving them first. May be combined with recordIds. Maximum 50000 records per batch across both. */
-                        records?: components["schemas"]["BatchInlineRecord"][];
+                        records?: components["schemas"]["BatchInlineRecord"][] | null;
                     } & {
                         [key: string]: unknown;
                     };
@@ -7818,7 +7816,7 @@ interface paths {
                             };
                             /** @description The created (or resumed) client session ID. */
                             sessionId: string;
-                            /** @description The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record, including the case where an agent-only token resolves its agent to a primary flow. Absent only on the data-only Runtype App branch, which is not chat-capable. */
+                            /** @description The flow or agent this session executes against, resolved server-side. Canonical replacement for `flow.id`, and the exact key to pass as `targetId` when listing or deleting this conversation's history. Matches the value stored on the conversation record; an agent-only token resolves to its agent id. Absent only on the data-only Runtype App branch, which is not chat-capable. */
                             targetId?: string;
                             /** @description The browser's anonymous visitor identity. Present when the request opts into visitor history (or supplies a visitor token, identity proof, or conversation id). Authenticates the `/client/conversations*` history routes, which the site-wide client token alone cannot reach. */
                             visitor?: {
@@ -42215,6 +42213,256 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/surfaces/{surfaceId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get surface details
+         * @description Get an authorized surface by its globally unique ID, including items and keys.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    surfaceId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Surface details */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            behavior?: unknown;
+                            createdAt: string;
+                            /** @description Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, ...). Clients should use this instead of constructing the URL themselves. */
+                            endpoint: string | null;
+                            id: string;
+                            inbound?: unknown;
+                            items: {
+                                agentId: string | null;
+                                agentType: string | null;
+                                cachedSkills: unknown[] | null;
+                                capabilityId: string;
+                                capabilityName: string | null;
+                                config?: unknown;
+                                createdAt: string;
+                                displayOrder: number | null;
+                                enabled: boolean;
+                                endpointSlug: string | null;
+                                exposedDescription: string | null;
+                                exposedName: string | null;
+                                flowId: string | null;
+                                id: string;
+                                isEntryPoint: boolean;
+                                parametersSchema?: unknown;
+                            }[];
+                            keys: {
+                                canReveal: boolean;
+                                createdAt: string;
+                                environment: string;
+                                expiresAt: string | null;
+                                id: string;
+                                isActive: boolean;
+                                isDevelopment: boolean;
+                                keyHint: string | null;
+                                keyPrefix: string;
+                                lastUsedAt: string | null;
+                                name: string | null;
+                                rateLimitPerDay: number | null;
+                                rateLimitPerMinute: number | null;
+                                scopeTargetIds: string[] | null;
+                                scopes: string[];
+                                usageCount: number | null;
+                            }[];
+                            name: string;
+                            outbound?: unknown;
+                            productId: string;
+                            scopeTargets: {
+                                capabilityId?: string;
+                                id: string;
+                                name: string;
+                                surfaceItemId?: string;
+                            }[];
+                            status: string;
+                            type: string;
+                            updatedAt: string;
+                            webhookHealth: components["schemas"]["WebhookHealth"];
+                        };
+                    };
+                };
+                /** @description Invalid surface 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 Surface 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"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/surfaces/{surfaceId}/test-deliveries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Send a provider fixture through a surface’s real ingress
+         * @description Resolve an authorized surface by its globally unique ID and send a provider-native fixture through the same authenticated ingress used by production deliveries.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    surfaceId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        fixture: "github.pull_request.opened" | "github.pull_request.merged_plan";
+                        planningPath?: string;
+                        pullRequest: number;
+                        repeat?: number;
+                        repository: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Provider delivery attempts accepted by the surface ingress. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description Invalid fixture or repository state. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Authentication required. */
+                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 Surface not found. */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description The surface or provider credential is not ready. */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description GitHub or the surface ingress rejected the delivery. */
+                502: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/tool-approval-grants": {
         parameters: {
             query?: never;
@@ -44193,6 +44441,91 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/users/onboarding/intent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Set onboarding intent
+         * @description Record what the authenticated user came to Runtype to do (dashboard only). Readable afterwards on GET /v1/auth/me.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        onboardingIntent: "build_new" | "connect_existing" | "unstated";
+                    };
+                };
+            };
+            responses: {
+                /** @description Stored onboarding intent */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {string} */
+                            onboardingIntent: "build_new" | "connect_existing" | "unstated";
+                        };
+                    };
+                };
+                /** @description Validation error */
+                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 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/users/onboarding/reset": {
         parameters: {
             query?: never;
@@ -44300,6 +44633,7 @@ interface paths {
                                 enableDashboardAssistant: boolean;
                                 enableEndUserUsageAnalytics: boolean;
                                 enableMassiveWebRender: boolean;
+                                enableOnboardingIntentGate: boolean;
                                 enableRuntown: boolean;
                                 enableRuntypeApps: boolean;
                                 enableSelfServeOauthClients: boolean;
@@ -45111,8 +45445,8 @@ interface components {
             targetKind: "flow" | "agent";
         };
         /** @description Inline flow definition executed per record without saving the flow. */
-        BatchFlowDefinition: {
-            description?: string;
+        BatchFlowDefinition: ({
+            description?: string | null;
             /** @description Saved-flow identity retained when the definition is a pinned snapshot. */
             id?: string;
             name: string;
@@ -45122,7 +45456,7 @@ interface components {
             }[];
         } & {
             [key: string]: unknown;
-        };
+        }) | null;
         /** @description An ad-hoc record processed in place of a saved record. Inline records never touch the records table; each is minted a synthetic id for the lifetime of the batch. */
         BatchInlineRecord: {
             /** @description Arbitrary JSON payload exposed to the flow as {{_record.metadata.*}}. Any shape is accepted; nothing is written to the records table. */
@@ -56116,7 +56450,6 @@ interface Agent {
     name: string;
     description: string | null;
     agentType: string;
-    primaryFlowId: string | null;
     config: Record<string, unknown> | null;
     externalConfig: Record<string, unknown> | null;
     createdAt: string;

package/dist/index.mjs

@@ -6289,7 +6289,7 @@ var Runtype = class {
 
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.5.0".length > 0 ? "9.5.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.6.0".length > 0 ? "9.6.0" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "9.5.0",
+  "version": "9.6.0",
   "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",