@runtypelabs/sdk 1.21.0 → 1.21.1

package/dist/index.d.cts

@@ -1,6 +1,9 @@
 /**
- * Client-specific types with camelCase field names
- * These types transform the API's snake_case responses to camelCase for JavaScript/TypeScript consumers
+ * SDK type definitions — self-contained for zero-dependency npm distribution.
+ *
+ * These types mirror the canonical entity definitions in @runtypelabs/shared
+ * (packages/shared/src/types/entities.ts and client-types.ts). When adding or
+ * modifying entity fields, update both locations.
  */
 type JsonPrimitive = string | number | boolean | null;
 type JsonArray = JsonValue[];
@@ -52,24 +55,29 @@ interface ApiResponse<T> {
 }
 interface FlowStep {
     id: string;
+    flowId: string;
     type: string;
     name: string;
     order: number;
     enabled: boolean;
-    config: JsonObject;
+    config: Record<string, unknown>;
+    outputVariable?: string | null;
+    streamOutput?: boolean;
+    createdAt: string;
+    updatedAt: string;
 }
 interface Flow {
     id: string;
     name: string;
-    description?: string;
+    description?: string | null;
     status: 'draft' | 'active' | 'paused' | 'failed';
+    config?: JsonObject;
     userId: string;
-    organizationId?: string;
+    organizationId: string | null;
     createdAt: string;
     updatedAt: string;
-    lastRunAt?: string;
-    prompts?: Prompt$1[];
-    /** Flow steps embedded in the flow response (consolidated from flow_steps endpoint) */
+    lastRunAt?: string | null;
+    /** Flow steps embedded in the flow response */
     flowSteps?: FlowStep[];
     /** Number of steps in the flow */
     stepCount?: number;
@@ -124,6 +132,7 @@ interface RuntypeRecord {
     }> | null;
     availableFields?: string[];
     userId: string;
+    organizationId?: string | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -286,8 +295,6 @@ interface UpsertOptions$2 {
 }
 /**
  * Environment type for dispatch requests
- * - 'development': Use development credentials (default for testing in dashboard)
- * - 'production': Use production credentials (shows warning in UI)
  */
 type DispatchEnvironment = 'development' | 'production';
 interface DispatchRequest {
@@ -306,19 +313,7 @@ interface DispatchRequest {
         role: 'system' | 'user' | 'assistant';
         content: MessageContent;
     }>;
-    /**
-     * Secure credentials for tool authentication
-     * - Never logged or returned in responses
-     * - Only used for variable substitution in tool headers/URLs
-     * - Available as {{secrets.key_name}} in tool configurations
-     */
     secrets?: Record<string, string>;
-    /**
-     * Top-level input variables accessible as {{varName}} in templates
-     * - Allows simple syntax without _record.metadata prefix
-     * - Takes precedence over record.metadata when resolving variables
-     * - Keys cannot start with '_' (reserved for system variables)
-     */
     inputs?: Record<string, unknown>;
     options?: {
         streamResponse?: boolean;
@@ -328,12 +323,6 @@ interface DispatchRequest {
         storeResults?: boolean;
         autoAppendMetadata?: boolean;
         debugMode?: boolean;
-        /**
-         * Environment for credential lookup
-         * - 'development': Use development credentials (default)
-         * - 'production': Use production credentials
-         * Credentials are looked up with environment-specific first, then fallback to "all environments"
-         */
         environment?: DispatchEnvironment;
         createVersion?: boolean;
         versionType?: 'published' | 'draft' | 'test' | 'virtual';
@@ -398,33 +387,15 @@ interface ExternalToolConfig {
 interface LocalToolConfig {
     [key: string]: JsonValue;
 }
-/**
- * Subagent tool configuration (surfaces A + B in the subagent design plan).
- *
- * Surface A — saved subagent: set `agentId` to a saved agent in the same org.
- * Surface B — inline subagent: set `agent` to a full exported agent JSON shape
- *   validated by the API at dispatch time.
- *
- * Exactly one of `agentId` / `agent` must be present; the API validator enforces this.
- */
 interface SubagentToolConfig {
-    /** (A) Saved agent — org-scoped, ownership-checked at dispatch. */
     agentId?: string;
-    /** (B) Inline agent definition. Full exported-agent JSON shape. */
     agent?: JsonObject;
-    /** Tool subset granted to the child. REQUIRED. Must be a subset of the parent's resolved tools. */
     allowedTools: string[];
-    /** Override the child agent's loop maxTurns. Default 5. */
     maxTurns?: number;
-    /** Optional cap on the child's running cost. Default: inherits parent budget. */
     maxCost?: number;
-    /** Per-invocation timeout in ms. Default 300_000 (5 min). */
     timeoutMs?: number;
-    /** How the child's result is returned. Default 'text'. */
     outputFormat?: 'text' | 'json' | 'last_message';
-    /** If true, prepend the parent's current messages to the child's initial context. Default false. */
     inheritMessages?: boolean;
-    /** Optional template rendering the child's initial user message from the tool-call `parameters`. */
     taskTemplate?: string;
 }
 interface BuiltInTool {
@@ -505,10 +476,6 @@ interface DeployCfSandboxResponse {
     previewUrl: string;
     output: string;
     status: 'running' | 'error';
-    /**
-     * Last pipeline step that ran. On failure, identifies where it failed
-     * (e.g. 'npm_install', 'start_process').
-     */
     stage?: 'validate_port' | 'validate_files' | 'write_package_json' | 'npm_install' | 'write_main_file' | 'write_additional_files' | 'start_process' | 'expose_port';
     error?: string;
 }
@@ -554,36 +521,6 @@ interface ModelUsageResponse {
     usageByModel: Record<string, ModelUsageDetail>;
     timeSeries?: ModelUsageTimeSeries[];
 }
-/**
- * Runtime tool definition for inline tool definitions in requests.
- * These are not persisted - they're defined and used within a single request.
- *
- * Runtime tools allow you to define tools dynamically without saving them
- * to the database. They support the same tool types as saved tools:
- * - external: HTTP API calls with variable substitution
- * - custom: JavaScript/Python code execution
- * - flow: Execute another Runtype flow
- *
- * @example
- * ```typescript
- * const runtimeTool: RuntimeTool = {
- *   name: 'list_flows',
- *   description: 'List all flows in the workspace',
- *   toolType: 'external',
- *   parametersSchema: {
- *     type: 'object',
- *     properties: {
- *       limit: { type: 'number', default: 20 }
- *     }
- *   },
- *   config: {
- *     url: 'https://api.runtype.com/v1/flows',
- *     method: 'GET',
- *     headers: { Authorization: '{{_internal.auth_token}}' }
- *   }
- * }
- * ```
- */
 interface RuntimeTool {
     name: string;
     description: string;
@@ -591,9 +528,6 @@ interface RuntimeTool {
     parametersSchema: JSONSchema;
     config?: RuntimeToolConfig;
 }
-/**
- * Config options for runtime tools
- */
 type RuntimeToolConfig = RuntimeFlowToolConfig | RuntimeCustomToolConfig | RuntimeExternalToolConfig | RuntimeLocalToolConfig | RuntimeSubagentToolConfig;
 interface RuntimeLocalToolConfig {
     [key: string]: JsonValue;
@@ -616,80 +550,22 @@ interface RuntimeExternalToolConfig {
     headers?: Record<string, string>;
     body?: string;
 }
-/**
- * Runtime subagent tool config — inline form used when passing a subagent
- * tool via `runtimeTools[]` rather than saving it.
- *
- * Structurally identical to `SubagentToolConfig`: the API validates the same
- * fields on both paths, so keeping a single source of truth avoids silent
- * divergence if a field is added on one side only. Kept as a named alias for
- * readability at call sites that deal with runtime-only tools.
- */
 type RuntimeSubagentToolConfig = SubagentToolConfig;
-/**
- * Opt-in configuration for agent-driven dynamic subagent spawning (surface C
- * of the subagent design).
- *
- * When present on a prompt step's `tools.subagentConfig`, the API synthesizes
- * a `spawn_subagent` tool that the parent LLM can call at runtime to spin off
- * a focused child agent. The child's tools are drawn from `toolPool`, which
- * must be a subset of the parent step's resolved tools.
- */
 interface AgentSubagentConfig {
-    /** Pool of tool IDs the parent is permitted to grant. Supports wildcards (e.g. `mcp:*`). */
     toolPool: string[];
-    /** Default iteration cap for spawned subagents. Default 5. */
     defaultMaxTurns?: number;
-    /** Hard ceiling a subagent may request via maxTurns. Default 10. */
     maxTurnsLimit?: number;
-    /** Total spawns per top-level parent run. Default 5. */
     maxSpawnsPerRun?: number;
-    /** Default model for spawned subagents. Defaults to parent's model. */
     defaultModel?: string;
-    /** Whether spawned subagents can themselves spawn. Default false. */
     allowNesting?: boolean;
-    /** Default per-spawn timeout. Default 300_000. */
     defaultTimeoutMs?: number;
 }
-/**
- * Tools configuration for prompt steps.
- * Supports both saved tools (by ID) and runtime tools (inline definitions).
- *
- * @example
- * ```typescript
- * const toolsConfig: ToolsConfig = {
- *   // Reference saved tools by ID
- *   toolIds: ['tool_abc123', 'tool_def456'],
- *   // Or define tools inline
- *   runtimeTools: [
- *     {
- *       name: 'search_docs',
- *       description: 'Search documentation',
- *       toolType: 'external',
- *       parametersSchema: { ... },
- *       config: { url: '...', method: 'GET' }
- *     }
- *   ],
- *   maxToolCalls: 10,
- *   toolCallStrategy: 'auto'
- * }
- * ```
- */
-/**
- * Authentication configuration for custom MCP servers
- */
 interface CustomMCPServerAuth {
-    /** Authentication type */
     type: 'bearer' | 'api_key' | 'basic' | 'custom_header' | 'oauth2' | 'none';
-    /** Header name for api_key or custom_header auth types */
     headerName?: string;
-    /** Token/key value for bearer, api_key, or custom_header */
     token?: string;
-    /** Username for basic auth */
     username?: string;
-    /** Password for basic auth */
     password?: string;
-    /** OAuth2 credentials (for oauth2 auth type) */
     oauth2?: {
         accessToken?: string;
         refreshToken?: string;
@@ -701,135 +577,34 @@ interface CustomMCPServerAuth {
         issuer?: string;
     };
 }
-/**
- * Custom MCP server configuration for runtime use.
- *
- * Allows connecting to custom MCP-compatible servers at dispatch time,
- * with credentials passed inline (never logged or stored).
- *
- * @example
- * ```typescript
- * const mcpServer: CustomMCPServer = {
- *   id: 'notion',
- *   name: 'Notion Integration',
- *   url: 'https://my-notion-mcp.example.com/mcp',
- *   auth: {
- *     type: 'bearer',
- *     token: process.env.NOTION_MCP_TOKEN
- *   },
- *   timeout: 30000,
- *   allowedTools: ['create_page', 'search_pages']
- * }
- * ```
- */
 interface CustomMCPServer {
-    /** Unique identifier for this server instance (used in tool IDs: mcp:custom_{id}:toolname) */
     id: string;
-    /** Display name for UI/logging */
     name?: string;
-    /** Server URL (required) */
     url: string;
-    /** Authentication configuration (treated as secret, never logged) */
     auth?: CustomMCPServerAuth;
-    /** Optional: filter to only allow specific tools (by name) */
     allowedTools?: string[];
-    /** Optional: timeout in milliseconds (default: 30000, max: 60000) */
     timeout?: number;
-    /** Optional: transport type (default: 'streamable_http') */
     transport?: 'streamable_http' | 'rest';
-    /** Optional: whether the server is enabled (default: true) */
     enabled?: boolean;
 }
 interface ToolsConfig {
-    /** IDs of saved tools to use */
     toolIds?: string[];
-    /** Inline runtime tool definitions (not persisted) */
     runtimeTools?: RuntimeTool[];
-    /**
-     * Opt-in agent-driven subagent spawning. When set, the API synthesizes a
-     * `spawn_subagent` tool that the step's model can call at runtime. Pool
-     * entries must be a subset of the parent step's resolved tools.
-     */
     subagentConfig?: AgentSubagentConfig;
-    /**
-     * Custom MCP servers with credentials passed at runtime.
-     * Maximum 5 servers per step.
-     *
-     * @example
-     * ```typescript
-     * mcpServers: [{
-     *   id: 'notion',
-     *   url: 'https://my-mcp.example.com/mcp',
-     *   auth: { type: 'bearer', token: process.env.MCP_TOKEN }
-     * }]
-     * ```
-     */
     mcpServers?: CustomMCPServer[];
-    /** Maximum number of tool calls allowed per step */
     maxToolCalls?: number;
-    /** Tool call strategy: 'auto' (model decides), 'required' (must call), 'none' (disabled) */
     toolCallStrategy?: 'auto' | 'required' | 'none';
-    /** Whether to allow parallel tool calls */
     parallelCalls?: boolean;
-    /** Per-tool configuration overrides */
     toolConfigs?: Record<string, JsonObject>;
 }
-/**
- * Reasoning configuration for AI models that support extended thinking.
- *
- * Enables models like GPT-5, Claude 4, Gemini 2.5 to show their reasoning process.
- * Different providers have different configuration options.
- *
- * @example Simple boolean (uses provider defaults)
- * ```typescript
- * reasoning: true
- * ```
- *
- * @example GPT-5 with detailed reasoning
- * ```typescript
- * reasoning: {
- *   enabled: true,
- *   reasoningEffort: 'high',
- *   reasoningSummary: 'detailed'
- * }
- * ```
- *
- * @example Claude with thinking budget
- * ```typescript
- * reasoning: {
- *   enabled: true,
- *   budgetTokens: 16000
- * }
- * ```
- */
 interface ReasoningConfig {
-    /** Enable reasoning (required) */
     enabled: boolean;
-    /** Reasoning effort level for OpenAI models. 'xhigh' only available for GPT-5.1-Codex-Max */
     reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    /** Reasoning summary mode - required for GPT-5 streaming. 'auto' for condensed, 'detailed' for comprehensive */
     reasoningSummary?: 'auto' | 'detailed';
-    /** Maximum tokens for Claude extended thinking */
     budgetTokens?: number;
-    /** Maximum tokens for Gemini thinking */
     thinkingBudget?: number;
-    /** Whether to include thinking in the response */
     includeThoughts?: boolean;
 }
-/**
- * Reasoning configuration value - either a simple boolean or detailed config.
- *
- * @example Simple enable/disable
- * ```typescript
- * reasoning: true  // Enable with provider defaults
- * reasoning: false // Explicitly disable
- * ```
- *
- * @example Detailed configuration
- * ```typescript
- * reasoning: { enabled: true, reasoningEffort: 'high' }
- * ```
- */
 type ReasoningValue = boolean | ReasoningConfig;
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 /**
- * Client-specific types with camelCase field names
- * These types transform the API's snake_case responses to camelCase for JavaScript/TypeScript consumers
+ * SDK type definitions — self-contained for zero-dependency npm distribution.
+ *
+ * These types mirror the canonical entity definitions in @runtypelabs/shared
+ * (packages/shared/src/types/entities.ts and client-types.ts). When adding or
+ * modifying entity fields, update both locations.
  */
 type JsonPrimitive = string | number | boolean | null;
 type JsonArray = JsonValue[];
@@ -52,24 +55,29 @@ interface ApiResponse<T> {
 }
 interface FlowStep {
     id: string;
+    flowId: string;
     type: string;
     name: string;
     order: number;
     enabled: boolean;
-    config: JsonObject;
+    config: Record<string, unknown>;
+    outputVariable?: string | null;
+    streamOutput?: boolean;
+    createdAt: string;
+    updatedAt: string;
 }
 interface Flow {
     id: string;
     name: string;
-    description?: string;
+    description?: string | null;
     status: 'draft' | 'active' | 'paused' | 'failed';
+    config?: JsonObject;
     userId: string;
-    organizationId?: string;
+    organizationId: string | null;
     createdAt: string;
     updatedAt: string;
-    lastRunAt?: string;
-    prompts?: Prompt$1[];
-    /** Flow steps embedded in the flow response (consolidated from flow_steps endpoint) */
+    lastRunAt?: string | null;
+    /** Flow steps embedded in the flow response */
     flowSteps?: FlowStep[];
     /** Number of steps in the flow */
     stepCount?: number;
@@ -124,6 +132,7 @@ interface RuntypeRecord {
     }> | null;
     availableFields?: string[];
     userId: string;
+    organizationId?: string | null;
     createdAt: string;
     updatedAt: string;
 }
@@ -286,8 +295,6 @@ interface UpsertOptions$2 {
 }
 /**
  * Environment type for dispatch requests
- * - 'development': Use development credentials (default for testing in dashboard)
- * - 'production': Use production credentials (shows warning in UI)
  */
 type DispatchEnvironment = 'development' | 'production';
 interface DispatchRequest {
@@ -306,19 +313,7 @@ interface DispatchRequest {
         role: 'system' | 'user' | 'assistant';
         content: MessageContent;
     }>;
-    /**
-     * Secure credentials for tool authentication
-     * - Never logged or returned in responses
-     * - Only used for variable substitution in tool headers/URLs
-     * - Available as {{secrets.key_name}} in tool configurations
-     */
     secrets?: Record<string, string>;
-    /**
-     * Top-level input variables accessible as {{varName}} in templates
-     * - Allows simple syntax without _record.metadata prefix
-     * - Takes precedence over record.metadata when resolving variables
-     * - Keys cannot start with '_' (reserved for system variables)
-     */
     inputs?: Record<string, unknown>;
     options?: {
         streamResponse?: boolean;
@@ -328,12 +323,6 @@ interface DispatchRequest {
         storeResults?: boolean;
         autoAppendMetadata?: boolean;
         debugMode?: boolean;
-        /**
-         * Environment for credential lookup
-         * - 'development': Use development credentials (default)
-         * - 'production': Use production credentials
-         * Credentials are looked up with environment-specific first, then fallback to "all environments"
-         */
         environment?: DispatchEnvironment;
         createVersion?: boolean;
         versionType?: 'published' | 'draft' | 'test' | 'virtual';
@@ -398,33 +387,15 @@ interface ExternalToolConfig {
 interface LocalToolConfig {
     [key: string]: JsonValue;
 }
-/**
- * Subagent tool configuration (surfaces A + B in the subagent design plan).
- *
- * Surface A — saved subagent: set `agentId` to a saved agent in the same org.
- * Surface B — inline subagent: set `agent` to a full exported agent JSON shape
- *   validated by the API at dispatch time.
- *
- * Exactly one of `agentId` / `agent` must be present; the API validator enforces this.
- */
 interface SubagentToolConfig {
-    /** (A) Saved agent — org-scoped, ownership-checked at dispatch. */
     agentId?: string;
-    /** (B) Inline agent definition. Full exported-agent JSON shape. */
     agent?: JsonObject;
-    /** Tool subset granted to the child. REQUIRED. Must be a subset of the parent's resolved tools. */
     allowedTools: string[];
-    /** Override the child agent's loop maxTurns. Default 5. */
     maxTurns?: number;
-    /** Optional cap on the child's running cost. Default: inherits parent budget. */
     maxCost?: number;
-    /** Per-invocation timeout in ms. Default 300_000 (5 min). */
     timeoutMs?: number;
-    /** How the child's result is returned. Default 'text'. */
     outputFormat?: 'text' | 'json' | 'last_message';
-    /** If true, prepend the parent's current messages to the child's initial context. Default false. */
     inheritMessages?: boolean;
-    /** Optional template rendering the child's initial user message from the tool-call `parameters`. */
     taskTemplate?: string;
 }
 interface BuiltInTool {
@@ -505,10 +476,6 @@ interface DeployCfSandboxResponse {
     previewUrl: string;
     output: string;
     status: 'running' | 'error';
-    /**
-     * Last pipeline step that ran. On failure, identifies where it failed
-     * (e.g. 'npm_install', 'start_process').
-     */
     stage?: 'validate_port' | 'validate_files' | 'write_package_json' | 'npm_install' | 'write_main_file' | 'write_additional_files' | 'start_process' | 'expose_port';
     error?: string;
 }
@@ -554,36 +521,6 @@ interface ModelUsageResponse {
     usageByModel: Record<string, ModelUsageDetail>;
     timeSeries?: ModelUsageTimeSeries[];
 }
-/**
- * Runtime tool definition for inline tool definitions in requests.
- * These are not persisted - they're defined and used within a single request.
- *
- * Runtime tools allow you to define tools dynamically without saving them
- * to the database. They support the same tool types as saved tools:
- * - external: HTTP API calls with variable substitution
- * - custom: JavaScript/Python code execution
- * - flow: Execute another Runtype flow
- *
- * @example
- * ```typescript
- * const runtimeTool: RuntimeTool = {
- *   name: 'list_flows',
- *   description: 'List all flows in the workspace',
- *   toolType: 'external',
- *   parametersSchema: {
- *     type: 'object',
- *     properties: {
- *       limit: { type: 'number', default: 20 }
- *     }
- *   },
- *   config: {
- *     url: 'https://api.runtype.com/v1/flows',
- *     method: 'GET',
- *     headers: { Authorization: '{{_internal.auth_token}}' }
- *   }
- * }
- * ```
- */
 interface RuntimeTool {
     name: string;
     description: string;
@@ -591,9 +528,6 @@ interface RuntimeTool {
     parametersSchema: JSONSchema;
     config?: RuntimeToolConfig;
 }
-/**
- * Config options for runtime tools
- */
 type RuntimeToolConfig = RuntimeFlowToolConfig | RuntimeCustomToolConfig | RuntimeExternalToolConfig | RuntimeLocalToolConfig | RuntimeSubagentToolConfig;
 interface RuntimeLocalToolConfig {
     [key: string]: JsonValue;
@@ -616,80 +550,22 @@ interface RuntimeExternalToolConfig {
     headers?: Record<string, string>;
     body?: string;
 }
-/**
- * Runtime subagent tool config — inline form used when passing a subagent
- * tool via `runtimeTools[]` rather than saving it.
- *
- * Structurally identical to `SubagentToolConfig`: the API validates the same
- * fields on both paths, so keeping a single source of truth avoids silent
- * divergence if a field is added on one side only. Kept as a named alias for
- * readability at call sites that deal with runtime-only tools.
- */
 type RuntimeSubagentToolConfig = SubagentToolConfig;
-/**
- * Opt-in configuration for agent-driven dynamic subagent spawning (surface C
- * of the subagent design).
- *
- * When present on a prompt step's `tools.subagentConfig`, the API synthesizes
- * a `spawn_subagent` tool that the parent LLM can call at runtime to spin off
- * a focused child agent. The child's tools are drawn from `toolPool`, which
- * must be a subset of the parent step's resolved tools.
- */
 interface AgentSubagentConfig {
-    /** Pool of tool IDs the parent is permitted to grant. Supports wildcards (e.g. `mcp:*`). */
     toolPool: string[];
-    /** Default iteration cap for spawned subagents. Default 5. */
     defaultMaxTurns?: number;
-    /** Hard ceiling a subagent may request via maxTurns. Default 10. */
     maxTurnsLimit?: number;
-    /** Total spawns per top-level parent run. Default 5. */
     maxSpawnsPerRun?: number;
-    /** Default model for spawned subagents. Defaults to parent's model. */
     defaultModel?: string;
-    /** Whether spawned subagents can themselves spawn. Default false. */
     allowNesting?: boolean;
-    /** Default per-spawn timeout. Default 300_000. */
     defaultTimeoutMs?: number;
 }
-/**
- * Tools configuration for prompt steps.
- * Supports both saved tools (by ID) and runtime tools (inline definitions).
- *
- * @example
- * ```typescript
- * const toolsConfig: ToolsConfig = {
- *   // Reference saved tools by ID
- *   toolIds: ['tool_abc123', 'tool_def456'],
- *   // Or define tools inline
- *   runtimeTools: [
- *     {
- *       name: 'search_docs',
- *       description: 'Search documentation',
- *       toolType: 'external',
- *       parametersSchema: { ... },
- *       config: { url: '...', method: 'GET' }
- *     }
- *   ],
- *   maxToolCalls: 10,
- *   toolCallStrategy: 'auto'
- * }
- * ```
- */
-/**
- * Authentication configuration for custom MCP servers
- */
 interface CustomMCPServerAuth {
-    /** Authentication type */
     type: 'bearer' | 'api_key' | 'basic' | 'custom_header' | 'oauth2' | 'none';
-    /** Header name for api_key or custom_header auth types */
     headerName?: string;
-    /** Token/key value for bearer, api_key, or custom_header */
     token?: string;
-    /** Username for basic auth */
     username?: string;
-    /** Password for basic auth */
     password?: string;
-    /** OAuth2 credentials (for oauth2 auth type) */
     oauth2?: {
         accessToken?: string;
         refreshToken?: string;
@@ -701,135 +577,34 @@ interface CustomMCPServerAuth {
         issuer?: string;
     };
 }
-/**
- * Custom MCP server configuration for runtime use.
- *
- * Allows connecting to custom MCP-compatible servers at dispatch time,
- * with credentials passed inline (never logged or stored).
- *
- * @example
- * ```typescript
- * const mcpServer: CustomMCPServer = {
- *   id: 'notion',
- *   name: 'Notion Integration',
- *   url: 'https://my-notion-mcp.example.com/mcp',
- *   auth: {
- *     type: 'bearer',
- *     token: process.env.NOTION_MCP_TOKEN
- *   },
- *   timeout: 30000,
- *   allowedTools: ['create_page', 'search_pages']
- * }
- * ```
- */
 interface CustomMCPServer {
-    /** Unique identifier for this server instance (used in tool IDs: mcp:custom_{id}:toolname) */
     id: string;
-    /** Display name for UI/logging */
     name?: string;
-    /** Server URL (required) */
     url: string;
-    /** Authentication configuration (treated as secret, never logged) */
     auth?: CustomMCPServerAuth;
-    /** Optional: filter to only allow specific tools (by name) */
     allowedTools?: string[];
-    /** Optional: timeout in milliseconds (default: 30000, max: 60000) */
     timeout?: number;
-    /** Optional: transport type (default: 'streamable_http') */
     transport?: 'streamable_http' | 'rest';
-    /** Optional: whether the server is enabled (default: true) */
     enabled?: boolean;
 }
 interface ToolsConfig {
-    /** IDs of saved tools to use */
     toolIds?: string[];
-    /** Inline runtime tool definitions (not persisted) */
     runtimeTools?: RuntimeTool[];
-    /**
-     * Opt-in agent-driven subagent spawning. When set, the API synthesizes a
-     * `spawn_subagent` tool that the step's model can call at runtime. Pool
-     * entries must be a subset of the parent step's resolved tools.
-     */
     subagentConfig?: AgentSubagentConfig;
-    /**
-     * Custom MCP servers with credentials passed at runtime.
-     * Maximum 5 servers per step.
-     *
-     * @example
-     * ```typescript
-     * mcpServers: [{
-     *   id: 'notion',
-     *   url: 'https://my-mcp.example.com/mcp',
-     *   auth: { type: 'bearer', token: process.env.MCP_TOKEN }
-     * }]
-     * ```
-     */
     mcpServers?: CustomMCPServer[];
-    /** Maximum number of tool calls allowed per step */
     maxToolCalls?: number;
-    /** Tool call strategy: 'auto' (model decides), 'required' (must call), 'none' (disabled) */
     toolCallStrategy?: 'auto' | 'required' | 'none';
-    /** Whether to allow parallel tool calls */
     parallelCalls?: boolean;
-    /** Per-tool configuration overrides */
     toolConfigs?: Record<string, JsonObject>;
 }
-/**
- * Reasoning configuration for AI models that support extended thinking.
- *
- * Enables models like GPT-5, Claude 4, Gemini 2.5 to show their reasoning process.
- * Different providers have different configuration options.
- *
- * @example Simple boolean (uses provider defaults)
- * ```typescript
- * reasoning: true
- * ```
- *
- * @example GPT-5 with detailed reasoning
- * ```typescript
- * reasoning: {
- *   enabled: true,
- *   reasoningEffort: 'high',
- *   reasoningSummary: 'detailed'
- * }
- * ```
- *
- * @example Claude with thinking budget
- * ```typescript
- * reasoning: {
- *   enabled: true,
- *   budgetTokens: 16000
- * }
- * ```
- */
 interface ReasoningConfig {
-    /** Enable reasoning (required) */
     enabled: boolean;
-    /** Reasoning effort level for OpenAI models. 'xhigh' only available for GPT-5.1-Codex-Max */
     reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    /** Reasoning summary mode - required for GPT-5 streaming. 'auto' for condensed, 'detailed' for comprehensive */
     reasoningSummary?: 'auto' | 'detailed';
-    /** Maximum tokens for Claude extended thinking */
     budgetTokens?: number;
-    /** Maximum tokens for Gemini thinking */
     thinkingBudget?: number;
-    /** Whether to include thinking in the response */
     includeThoughts?: boolean;
 }
-/**
- * Reasoning configuration value - either a simple boolean or detailed config.
- *
- * @example Simple enable/disable
- * ```typescript
- * reasoning: true  // Enable with provider defaults
- * reasoning: false // Explicitly disable
- * ```
- *
- * @example Detailed configuration
- * ```typescript
- * reasoning: { enabled: true, reasoningEffort: 'high' }
- * ```
- */
 type ReasoningValue = boolean | ReasoningConfig;
 
 /**

package/package.json

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