@runtypelabs/sdk 1.22.0 → 1.24.0

package/dist/index.d.ts

@@ -1,1685 +1,1688 @@
 /**
- * SDK type definitions — self-contained for zero-dependency npm distribution.
+ * Error Handling Types
  *
- * 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.
+ * Provides consistent error handling configuration across all step types
+ * with support for retry, model fallback, step fallback, and flow fallback.
+ *
+ * Note: These types are inlined from the internal shared package to avoid
+ * requiring users to install @runtypelabs/shared.
  */
-type JsonPrimitive = string | number | boolean | null;
-type JsonArray = JsonValue[];
-type JsonObject = {
-    [key: string]: JsonValue;
-};
-type JsonValue = JsonPrimitive | JsonObject | JsonArray;
-type Metadata = JsonObject;
-interface JSONSchema {
-    type: 'object' | 'string' | 'number' | 'boolean' | 'array' | 'null';
-    properties?: Record<string, JSONSchema>;
-    required?: string[];
-    items?: JSONSchema;
-    description?: string;
-    default?: JsonValue;
-    enum?: JsonPrimitive[];
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-}
-interface ClientConfig {
-    apiKey?: string;
-    baseUrl?: string;
-    apiVersion?: string;
-    timeout?: number;
-    headers?: Record<string, string>;
-}
-interface PaginationResponse<T> {
-    data: T[];
-    pagination: {
-        nextCursor: string | null;
-        prevCursor: string | null;
-        hasMore: boolean;
-        hasPrev: boolean;
-        limit: number;
-        currentOffset: number;
-        totalPages?: number;
-        currentPage?: number;
-        totalCount?: number;
-    };
-}
-interface ApiResponse<T> {
-    data?: T;
-    success?: boolean;
-    error?: string;
-    message?: string;
-}
-interface FlowStep {
-    id: string;
-    flowId: string;
-    type: string;
-    name: string;
-    order: number;
-    enabled: boolean;
-    config: Record<string, unknown>;
-    outputVariable?: string | null;
-    streamOutput?: boolean;
-    createdAt: string;
-    updatedAt: string;
+type ErrorHandlingMode = 'fail' | 'continue' | 'fallback';
+/**
+ * Base fallback configuration
+ */
+interface BaseFallback {
+    delay?: number;
 }
-interface Flow {
-    id: string;
-    name: string;
-    description?: string | null;
-    status: 'draft' | 'active' | 'paused' | 'failed';
-    config?: JsonObject;
-    userId: string;
-    organizationId: string | null;
-    createdAt: string;
-    updatedAt: string;
-    lastRunAt?: string | null;
-    /** Flow steps embedded in the flow response */
-    flowSteps?: FlowStep[];
-    /** Number of steps in the flow */
-    stepCount?: number;
+/**
+ * Retry fallback - retry the same step with same config
+ */
+interface RetryFallback extends BaseFallback {
+    type: 'retry';
 }
-interface Prompt$1 {
-    id: string;
-    name: string;
-    text: string;
-    responseFormat: 'default' | 'json' | 'markdown' | 'html' | 'xml';
+/**
+ * Model fallback for prompts - retry with different model/settings
+ */
+interface ModelFallback extends BaseFallback {
+    type: 'model';
     model: string;
-    isStreamed: boolean;
-    tools: string[];
-    inputVariables?: string;
-    estimatedTokens?: number;
-    estimatedCost?: string;
-    userId: string;
-    createdAt: string;
-    updatedAt: string;
-    flows?: FlowAttachment[];
-}
-interface FlowAttachment {
-    flowId: string;
-    flowName: string;
-    order: number;
-}
-interface RuntypeRecord {
-    id: string;
-    type: string;
-    name: string;
-    metadata: Metadata;
-    metadataLabels?: {
-        [key: string]: string;
-    };
-    metadataSchema?: {
-        keys: string[];
-        keyMapping?: {
-            [key: string]: string;
-        };
-        keyTypes?: {
-            [key: string]: string;
-        };
-        types?: {
-            [key: string]: string;
-        };
-        sizeKb: number;
-        keyCount: number;
-        updatedAt: string;
-    };
-    messages?: Array<{
-        role: 'user' | 'assistant';
-        content: string | unknown[];
-    }> | null;
-    availableFields?: string[];
-    userId: string;
-    organizationId?: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-interface ApiKey {
-    id: string;
-    name: string;
-    keyPrefix: string;
-    searchHint?: string;
-    permissions: string[];
-    isActive: boolean;
-    expiresAt?: string;
-    allowedIps: string[];
-    createdAt: string;
-    updatedAt?: string;
-    lastUsedAt?: string;
-}
-interface ModelConfig {
-    id: string;
-    provider: string;
-    modelId: string;
-    displayName?: string;
-    /** @deprecated Use keyStatus instead */
-    supportsCustomKey: boolean;
-    keyStatus?: 'platform' | 'custom' | 'needs_setup';
-    costPer1kTokens?: number;
-    contextLength?: number;
-    maxOutputTokens?: number;
+    temperature?: number;
     maxTokens?: number;
-    supportsStreaming?: boolean;
-    supportedResponseFormats?: string[];
-    supportsSearch?: boolean;
-    isEnabled: boolean;
-    isDefault: boolean;
-    settings: JsonObject;
-    createdAt: string;
-    updatedAt: string;
-    providerKeyId?: string | null;
-    requiresIntegration?: string;
-    apiKey?: string;
-    scope?: 'personal' | 'organization';
-    organizationId?: string;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    seed?: number;
 }
-interface UserProfile {
-    id: string;
-    firstName?: string;
-    lastName?: string;
-    email: string;
-    preferences?: {
-        theme?: 'light' | 'dark' | 'system';
-        notifications?: boolean;
-        defaultModel?: string;
-    };
+/**
+ * Step fallback for context steps - run a different step type
+ */
+interface StepFallback extends BaseFallback {
+    type: 'step';
+    stepType: string;
+    stepConfig: Record<string, unknown>;
 }
-interface CreateFlowRequest {
-    name: string;
-    description?: string;
-    flowSteps?: Array<{
-        type: 'prompt' | 'context' | 'condition' | 'output' | 'email';
-        name: string;
-        order?: number;
-        enabled?: boolean;
-        config: JsonObject;
-    }>;
+/**
+ * Flow fallback - call another flow
+ */
+interface FlowFallback extends BaseFallback {
+    type: 'flow';
+    flowId: string;
+    inputs?: Record<string, unknown>;
 }
-interface CreatePromptRequest {
-    flowIds?: string[];
-    name: string;
-    text: string;
-    responseFormat?: 'json' | 'markdown' | 'text' | 'html' | 'xml';
-    model?: string;
-    inputVariables?: string;
+/**
+ * Union of all prompt fallback types
+ */
+type PromptFallback = RetryFallback | ModelFallback;
+/**
+ * Union of all context step fallback types
+ */
+type ContextFallback = RetryFallback | StepFallback | FlowFallback;
+/**
+ * Error handling configuration for prompts
+ */
+interface PromptErrorHandling {
+    onError: ErrorHandlingMode;
+    fallbacks?: PromptFallback[];
 }
-interface CreateRecordRequest {
-    type: string;
-    name: string;
-    metadata?: Metadata;
-}
-interface BulkEditCondition {
-    field: string;
-    operator: 'equals' | 'equals_ci' | 'not_equals' | 'contains' | 'not_contains';
-    value: string | number | boolean;
-}
-interface BulkEditRequest {
-    recordIds?: string[];
-    conditions?: BulkEditCondition[];
-    updates?: JsonObject;
-    deleteFields?: string[];
-    dryRun?: boolean;
-    applyToAll?: boolean;
-}
-interface BulkEditResult {
-    id: string;
-    before: JsonObject;
-    after: JsonObject;
-}
-interface BulkEditResponse {
-    data: BulkEditResult[];
-    recordIds?: number[];
-}
-interface ProviderApiKey {
-    id: number;
-    provider: 'openai' | 'anthropic' | 'huggingface' | 'google' | 'xai' | 'mixlayer' | 'togetherai';
-    name: string;
-    keyPreview: string;
-    isDefault: boolean;
-    isActive: boolean;
-    usageCount: number;
-    lastUsedAt?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface CreateProviderKeyRequest {
-    provider: 'openai' | 'anthropic' | 'huggingface' | 'google' | 'xai' | 'mixlayer' | 'togetherai';
-    name: string;
-    apiKey: string;
-    isDefault?: boolean;
-}
-interface UpdateProviderKeyRequest {
-    name?: string;
-    apiKey?: string;
-    isDefault?: boolean;
-    isActive?: boolean;
-}
-interface CreateApiKeyRequest {
-    name: string;
-    permissions?: string[];
-    expiresAt?: string;
-    allowedIps?: string[];
-    environment?: 'test' | 'production';
-}
-interface CreateModelConfigRequest {
-    provider: 'mixlayer' | 'openai' | 'anthropic' | 'google' | 'xai' | 'huggingface' | 'togetherai';
-    modelId: string;
-    apiKey?: string;
-    settings?: JsonObject;
-}
-/** Content part types for multi-modal messages */
-interface TextContentPart {
-    type: 'text';
-    text: string;
-}
-interface ImageContentPart {
-    type: 'image';
-    image: string;
-    mimeType?: string;
-}
-interface FileContentPart {
-    type: 'file';
-    data: string;
-    mimeType: string;
-    filename: string;
+/**
+ * Error handling configuration for context steps
+ */
+interface ContextErrorHandling {
+    onError: ErrorHandlingMode;
+    fallbacks?: ContextFallback[];
 }
-type MessageContent = string | Array<TextContentPart | ImageContentPart | FileContentPart>;
+
 /**
- * Options for upsert mode - controls conflict detection and versioning
+ * FlowResult - Wrapper for streaming flow execution responses
+ *
+ * Provides convenient methods for processing streaming responses
+ * from the Runtype API dispatch endpoint.
  */
-interface UpsertOptions$1 {
-    /** Whether to create a version snapshot before updating (default: true) */
-    createVersionOnChange?: boolean;
-    /** Allow overwriting changes made via dashboard/API (default: false) */
-    allowOverwriteExternalChanges?: boolean;
+
+/**
+ * Result wrapper for flow execution
+ *
+ * Provides multiple ways to consume the streaming response:
+ * - `.stream(callbacks)` - Process with callbacks
+ * - `.getResult(stepName)` - Get result from a specific step
+ * - `.getAllResults()` - Get all step results
+ * - `.raw` - Access the raw Response for manual handling
+ *
+ * @example
+ * ```typescript
+ * const result = await flow.run(apiClient, options)
+ *
+ * // Option 1: Process with callbacks
+ * const summary = await result.stream({
+ *   onStepDelta: (text) => process.stdout.write(text),
+ * })
+ *
+ * // Option 2: Just get a specific step's result
+ * const analysis = await result.getResult('Analyze Data')
+ *
+ * // Option 3: Get all results
+ * const allResults = await result.getAllResults()
+ * ```
+ */
+declare class FlowResult {
+    private response;
+    private consumed;
+    private cachedSummary;
+    constructor(response: Response, summary?: FlowSummary);
+    /**
+     * Get the raw Response object for manual handling
+     *
+     * Note: The response body can only be consumed once.
+     * Using this will prevent using other methods like stream() or getResult().
+     */
+    get raw(): Response;
+    /**
+     * Check if the response has already been consumed
+     */
+    get isConsumed(): boolean;
+    /**
+     * Process the streaming response with callbacks
+     *
+     * @param callbacks - Callbacks for different event types
+     * @returns Promise resolving to FlowSummary when complete
+     *
+     * @example
+     * ```typescript
+     * const summary = await result.stream({
+     *   onStepStart: (event) => console.log('Starting:', event.name),
+     *   onStepDelta: (text) => process.stdout.write(text),
+     *   onStepComplete: (result, event) => console.log('Done:', event.name),
+     *   onFlowComplete: (event) => console.log('Flow complete!'),
+     * })
+     * ```
+     */
+    stream(callbacks?: StreamCallbacks): Promise<FlowSummary>;
+    /**
+     * Get the result from a specific step by its name
+     *
+     * Matches against the `name` property you set when creating the step.
+     * - **Case-sensitive**: `'Analyze'` ≠ `'analyze'`
+     * - **Exact match only**: no partial or fuzzy matching
+     * - Returns `undefined` if no step with that name is found
+     *
+     * @param stepName - The exact step name (from the `name` property when creating the step)
+     * @returns The step's result, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * // When building:
+     * .prompt({ name: 'Analyze Screenshot', model: 'gpt-4', ... })
+     *
+     * // When retrieving (must match exactly):
+     * const analysis = await result.getResult('Analyze Screenshot')  // ✓ Works
+     * const analysis = await result.getResult('analyze screenshot')  // ✗ undefined
+     * ```
+     */
+    getResult(stepName: string): Promise<any>;
+    /**
+     * Get all step results as a Map
+     *
+     * @returns Map of step name to result
+     *
+     * @example
+     * ```typescript
+     * const allResults = await result.getAllResults()
+     * for (const [stepName, result] of allResults) {
+     *   console.log(stepName, result)
+     * }
+     * ```
+     */
+    getAllResults(): Promise<Map<string, any>>;
+    /**
+     * Get the flow summary after processing
+     *
+     * @returns FlowSummary with execution details
+     */
+    getSummary(): Promise<FlowSummary>;
+    /**
+     * Ensure the stream has been processed and return the summary
+     */
+    private ensureSummary;
+    /**
+     * Ensure the response hasn't been consumed yet
+     */
+    private ensureNotConsumed;
 }
+
 /**
- * Environment type for dispatch requests
+ * FlowBuilder - Fluent builder for constructing dispatch configurations
+ *
+ * Provides a chainable API for building flows with steps, making flow
+ * construction more readable and type-safe.
+ *
+ * @example
+ * ```typescript
+ * import { FlowBuilder } from '@runtypelabs/sdk'
+ *
+ * const config = new FlowBuilder()
+ *   .createFlow({ name: "My Flow" })
+ *   .withRecord({ name: "Record", type: "data", metadata: { key: "value" } })
+ *   .fetchUrl({ name: "Fetch", url: "https://api.example.com", outputVariable: "data" })
+ *   .prompt({ name: "Process", model: "gpt-4", userPrompt: "Analyze: {{data}}" })
+ *   .withOptions({ streamResponse: true, flowMode: "virtual" })
+ *   .build()
+ * ```
  */
-type DispatchEnvironment = 'development' | 'production';
-interface DispatchRequest {
-    record?: {
-        id?: number | string;
-        name?: string;
-        type?: string;
-        metadata?: Metadata;
-    };
-    flow: {
-        id?: string;
-        name?: string;
-        steps?: Array<any>;
-    };
-    messages?: Array<{
-        role: 'system' | 'user' | 'assistant';
-        content: MessageContent;
+
+interface PromptStepConfig$1 {
+    name: string;
+    model: string;
+    userPrompt: string;
+    systemPrompt?: string;
+    previousMessages?: string | Array<{
+        role: string;
+        content: string;
     }>;
-    secrets?: Record<string, string>;
-    inputs?: Record<string, unknown>;
-    options?: {
-        streamResponse?: boolean;
-        modelOverride?: string;
-        recordMode?: 'existing' | 'create' | 'virtual';
-        flowMode?: 'existing' | 'create' | 'virtual' | 'upsert';
-        storeResults?: boolean;
-        autoAppendMetadata?: boolean;
-        debugMode?: boolean;
-        environment?: DispatchEnvironment;
-        createVersion?: boolean;
-        versionType?: 'published' | 'draft' | 'test' | 'virtual';
-        versionLabel?: string;
-        versionNotes?: string;
-        flowVersionId?: string;
-        upsertOptions?: UpsertOptions$1;
-        flowTimeoutMs?: number;
-        stepTimeoutMs?: number;
-    };
-}
-interface ListParams {
-    limit?: number;
-    cursor?: string;
-    direction?: 'next' | 'prev';
-}
-interface RecordListParams extends ListParams {
-    metadataKeys?: string;
-    metadataKeysAll?: string;
-    minFields?: number;
-    maxFields?: number;
-    metadataTypes?: string;
-    hasLargeFields?: boolean;
-    minSizeKb?: number;
-    maxSizeKb?: number;
-    sortBy?: string;
-    sortOrder?: 'asc' | 'desc';
-    includeFields?: boolean;
+    outputVariable?: string;
+    responseFormat?: 'text' | 'json';
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+    seed?: number;
+    maxTokens?: number;
+    /**
+     * Enable reasoning/extended thinking for models that support it.
+     * - `true`: Enable with provider defaults
+     * - `ReasoningConfig`: Fine-grained control over reasoning behavior
+     *
+     * @example GPT-5 with streaming reasoning
+     * ```typescript
+     * reasoning: { enabled: true, reasoningSummary: 'auto' }
+     * ```
+     */
+    reasoning?: boolean | ReasoningConfig;
+    streamOutput?: boolean;
+    /** Tools configuration - supports saved tools (toolIds) and inline runtime tools */
+    tools?: ToolsConfig;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | PromptErrorHandling;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface Tool {
-    id: string;
-    userId: string;
-    organizationId?: string;
+interface FetchUrlStepConfig$1 {
     name: string;
-    description: string;
-    toolType: 'flow' | 'custom' | 'external' | 'local' | 'subagent';
-    parametersSchema: JSONSchema;
-    config: ToolConfig;
-    isActive: boolean;
-    createdAt: string;
-    updatedAt: string;
-}
-type ToolConfig = FlowToolConfig | CustomToolConfig | ExternalToolConfig | LocalToolConfig | SubagentToolConfig;
-interface FlowToolConfig {
-    flowId?: string;
-    toolId?: string;
-    parameterMapping: Record<string, string>;
-    outputMapping?: string;
-}
-interface CustomToolConfig {
-    code: string;
-    timeout: number;
-    allowedApis: string[];
-}
-interface ExternalToolConfig {
     url: string;
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
     headers?: Record<string, string>;
     body?: string;
-    authType?: 'none' | 'bearer' | 'api_key';
+    responseType?: 'json' | 'text' | 'xml';
+    markdownIfAvailable?: boolean;
+    outputVariable?: string;
+    fetchMethod?: 'http' | 'firecrawl';
+    firecrawl?: {
+        formats?: string[];
+        [key: string]: any;
+    };
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface LocalToolConfig {
-    [key: string]: JsonValue;
+interface CrawlStepConfig {
+    name: string;
+    url: string;
+    limit?: number;
+    depth?: number;
+    source?: string;
+    formats?: string[];
+    render?: boolean;
+    maxAge?: number;
+    modifiedSince?: string;
+    options?: Record<string, unknown>;
+    authenticate?: Record<string, unknown>;
+    cookies?: Array<Record<string, unknown>>;
+    setExtraHTTPHeaders?: Record<string, string>;
+    gotoOptions?: Record<string, unknown>;
+    waitForSelector?: string;
+    rejectResourceTypes?: string[];
+    rejectRequestPattern?: string | string[];
+    userAgent?: string;
+    jsonOptions?: Record<string, unknown>;
+    outputVariable?: string;
+    streamOutput?: boolean;
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    pollIntervalMs?: number;
+    completionTimeoutMs?: number;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface SubagentToolConfig {
-    agentId?: string;
-    agent?: JsonObject;
-    allowedTools: string[];
-    maxTurns?: number;
-    maxCost?: number;
-    timeoutMs?: number;
-    outputFormat?: 'text' | 'json' | 'last_message';
-    inheritMessages?: boolean;
-    taskTemplate?: string;
+interface TransformDataStepConfig$1 {
+    name: string;
+    script: string;
+    outputVariable?: string;
+    sandboxProvider?: 'quickjs' | 'daytona' | 'cloudflare-worker';
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface BuiltInTool {
-    id: string;
+interface SetVariableStepConfig$1 {
     name: string;
-    description: string;
-    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'artifact' | 'data_management' | 'commerce' | 'browser';
-    providers: string[];
-    parametersSchema: JSONSchema;
-    defaultConfig?: JsonObject;
-    documentationUrl?: string;
+    variableName: string;
+    value: string | number | boolean | object;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ToolExecution {
-    id: string;
-    toolId: string;
-    flowExecutionId?: string;
-    stepId?: string;
-    userId: string;
-    inputParameters: JsonObject;
-    outputResult: JsonValue;
-    status: 'pending' | 'success' | 'failed';
-    errorMessage?: string;
-    executionTimeMs?: number;
-    createdAt: string;
+interface ConditionalStepConfig$1 {
+    name: string;
+    condition: string;
+    trueSteps?: any[];
+    falseSteps?: any[];
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface CreateToolRequest {
+interface SearchStepConfig$1 {
     name: string;
-    description: string;
-    toolType: 'flow' | 'custom' | 'external' | 'subagent';
-    parametersSchema: JSONSchema;
-    config: ToolConfig;
+    provider: string;
+    query: string;
+    maxResults?: number;
+    outputVariable?: string;
+    returnCitations?: boolean;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface UpdateToolRequest {
-    name?: string;
-    description?: string;
-    parametersSchema?: JSONSchema;
-    config?: ToolConfig;
-    isActive?: boolean;
+interface SendEmailStepConfig$1 {
+    name: string;
+    to: string;
+    from?: string;
+    subject: string;
+    html: string;
+    outputVariable?: string;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ExecuteToolRequest {
-    toolId: string;
-    parameters: JsonObject;
+interface SendStreamStepConfig$1 {
+    name: string;
+    message: string;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ExecuteToolResponse {
-    executionId: string;
-    result: JsonValue;
-    status: 'success' | 'failed';
-    errorMessage?: string;
-    executionTimeMs: number;
+/**
+ * Operator allowlist for chip-style record filters. Mirrors the API's
+ * `record-filter-compiler.ts`. Kept inline here to avoid a hard dependency
+ * on `@runtypelabs/shared` from the published SDK.
+ */
+type RecordFilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'notIn' | 'isSet' | 'isNotSet' | 'isTrue' | 'isFalse' | 'withinLastDays' | 'olderThanDays';
+interface RecordFilterCondition {
+    field: string;
+    op: RecordFilterOperator;
+    value?: unknown;
 }
-interface DeploySandboxRequest {
-    code: string;
-    packageJson?: string;
-    language?: 'javascript' | 'typescript' | 'python';
-    port?: number;
-    sandboxId?: string;
-    startCommand?: string;
-    files?: Record<string, string>;
+interface RecordFilterGroup {
+    op: 'and' | 'or';
+    conditions: Array<RecordFilterCondition | RecordFilterGroup>;
 }
-interface DeploySandboxResponse {
-    sandboxId: string;
-    previewUrl: string;
-    output: string;
-    status: 'running' | 'error';
-    error?: string;
-}
-interface DeployCfSandboxRequest {
-    code: string;
-    packageJson?: string;
-    language?: 'javascript' | 'typescript' | 'python';
-    port?: number;
-    sandboxId?: string;
-    startCommand?: string;
-    files?: Record<string, string>;
-}
-interface DeployCfSandboxResponse {
-    sandboxId: string;
-    previewUrl: string;
-    output: string;
-    status: 'running' | 'error';
-    stage?: 'validate_port' | 'validate_files' | 'write_package_json' | 'npm_install' | 'write_main_file' | 'write_additional_files' | 'start_process' | 'expose_port';
-    error?: string;
+interface RecordFilter {
+    type: string;
+    where?: RecordFilterCondition | RecordFilterGroup;
 }
-interface ModelUsageQueryParams {
-    startDate?: string;
-    endDate?: string;
-    period?: 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'current_month' | 'last_month' | 'current_year';
-    granularity?: 'hour' | 'day' | 'week' | 'month';
-    modelConfigId?: string;
+interface RetrieveRecordStepConfig$1 {
+    name: string;
+    recordType?: string;
+    recordName?: string;
+    /**
+     * Optional chip-style filter (metadata + top-level columns: id, name,
+     * createdAt, updatedAt). Coexists with recordType/recordName for
+     * backward compatibility; the API executor prefers recordFilter when
+     * both are set.
+     */
+    recordFilter?: RecordFilter;
+    fieldsToInclude?: string[];
+    fieldsToExclude?: string[];
+    outputVariable?: string;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ModelUsageSummary {
-    totalRequests: number;
-    totalCost: number;
-    totalTokens: number;
-    platformCost?: number;
-    userCost?: number;
-    platformTokens?: number;
-    userTokens?: number;
+interface UpsertRecordStepConfig$1 {
+    name: string;
+    recordType: string;
+    recordName?: string;
+    sourceVariable?: string;
+    mergeStrategy?: 'merge' | 'replace';
+    outputVariable?: string;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ModelUsageDetail {
-    modelId: string;
-    modelName?: string;
-    provider: string;
-    requestCount: number;
-    totalCost: number;
-    totalTokens: number;
-    avgCostPerRequest: number;
+interface VectorSearchStepConfig$1 {
+    name: string;
+    query: string;
+    recordType?: string;
+    embeddingModel?: string;
+    limit?: number;
+    threshold?: number;
+    outputVariable?: string;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ModelUsageTimeSeries {
-    date: string;
-    requests: number;
-    cost: number;
-    tokens: number;
+interface GenerateEmbeddingStepConfig$1 {
+    name: string;
+    text: string;
+    embeddingModel?: string;
+    maxLength?: number;
+    outputVariable?: string;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface ModelUsageResponse {
-    meta: {
-        startDate: string;
-        endDate: string;
-        period?: string;
-        granularity?: string;
+interface WaitUntilStepConfig$1 {
+    name: string;
+    delayMs?: number;
+    continueOnTimeout?: boolean;
+    poll?: {
+        enabled: boolean;
+        intervalMs?: number;
+        maxAttempts?: number;
+        condition?: string;
     };
-    summary: ModelUsageSummary;
-    usageByModel: Record<string, ModelUsageDetail>;
-    timeSeries?: ModelUsageTimeSeries[];
+    outputVariable?: string;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface RuntimeTool {
+interface SendEventStepConfig$1 {
     name: string;
-    description: string;
-    toolType: 'flow' | 'custom' | 'external' | 'local' | 'subagent';
-    parametersSchema: JSONSchema;
-    config?: RuntimeToolConfig;
-}
-type RuntimeToolConfig = RuntimeFlowToolConfig | RuntimeCustomToolConfig | RuntimeExternalToolConfig | RuntimeLocalToolConfig | RuntimeSubagentToolConfig;
-interface RuntimeLocalToolConfig {
-    [key: string]: JsonValue;
-}
-interface RuntimeFlowToolConfig {
-    flowId?: string;
-    toolId?: string;
-    parameterMapping?: Record<string, string>;
-    outputMapping?: string;
+    provider: string;
+    eventName: string;
+    properties?: Record<string, any>;
+    outputVariable?: string;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface RuntimeCustomToolConfig {
-    code: string;
-    language?: 'javascript' | 'typescript' | 'python';
-    sandboxProvider?: 'quickjs' | 'daytona' | 'cloudflare-worker';
-    timeout?: number;
+interface SendTextStepConfig$1 {
+    name: string;
+    to: string;
+    from?: string;
+    message: string;
+    outputVariable?: string;
+    /** Error handling configuration - supports simple mode or fallback chains */
+    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-interface RuntimeExternalToolConfig {
-    url: string;
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
-    headers?: Record<string, string>;
-    body?: string;
+interface FetchGitHubStepConfig$1 {
+    name: string;
+    repository: string;
+    branch?: string;
+    path?: string;
+    outputVariable?: string;
+    streamOutput?: boolean;
+    enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
-type RuntimeSubagentToolConfig = SubagentToolConfig;
-interface AgentSubagentConfig {
-    toolPool: string[];
-    defaultMaxTurns?: number;
-    maxTurnsLimit?: number;
-    maxSpawnsPerRun?: number;
-    defaultModel?: string;
-    allowNesting?: boolean;
-    defaultTimeoutMs?: number;
+interface FlowConfig$1 {
+    name: string;
+    description?: string;
 }
-interface CustomMCPServerAuth {
-    type: 'bearer' | 'api_key' | 'basic' | 'custom_header' | 'oauth2' | 'none';
-    headerName?: string;
-    token?: string;
-    username?: string;
-    password?: string;
-    oauth2?: {
-        accessToken?: string;
-        refreshToken?: string;
-        tokenEndpoint?: string;
-        clientId?: string;
-        clientSecret?: string;
-        expiresAt?: number;
-        scope?: string;
-        issuer?: string;
-    };
+/**
+ * Configuration for upsert flow - includes flow name and upsert behavior options
+ */
+interface UpsertFlowConfig$1 extends FlowConfig$1 {
+    /** Whether to create a version snapshot before updating (default: true) */
+    createVersionOnChange?: boolean;
+    /** Allow overwriting changes made via dashboard/API (default: false) */
+    allowOverwriteExternalChanges?: boolean;
 }
-interface CustomMCPServer {
-    id: string;
+interface RecordConfig$1 {
+    id?: number | string;
     name?: string;
-    url: string;
-    auth?: CustomMCPServerAuth;
-    allowedTools?: string[];
-    timeout?: number;
-    transport?: 'streamable_http' | 'rest';
-    enabled?: boolean;
-}
-interface ToolsConfig {
-    toolIds?: string[];
-    runtimeTools?: RuntimeTool[];
-    subagentConfig?: AgentSubagentConfig;
-    mcpServers?: CustomMCPServer[];
-    maxToolCalls?: number;
-    toolCallStrategy?: 'auto' | 'required' | 'none';
-    parallelCalls?: boolean;
-    toolConfigs?: Record<string, JsonObject>;
-}
-interface ReasoningConfig {
-    enabled: boolean;
-    reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    reasoningSummary?: 'auto' | 'detailed';
-    budgetTokens?: number;
-    thinkingBudget?: number;
-    includeThoughts?: boolean;
+    type?: string;
+    metadata?: Record<string, any>;
 }
-type ReasoningValue = boolean | ReasoningConfig;
-
 /**
- * Error Handling Types
- *
- * Provides consistent error handling configuration across all step types
- * with support for retry, model fallback, step fallback, and flow fallback.
- *
- * Note: These types are inlined from the internal shared package to avoid
- * requiring users to install @runtypelabs/shared.
- */
-type ErrorHandlingMode = 'fail' | 'continue' | 'fallback';
-/**
- * Base fallback configuration
+ * Options for upsert mode - controls conflict detection and versioning
  */
-interface BaseFallback {
-    delay?: number;
+interface UpsertOptions$1 {
+    /** Whether to create a version snapshot before updating (default: true) */
+    createVersionOnChange?: boolean;
+    /** Allow overwriting changes made via dashboard/API (default: false) */
+    allowOverwriteExternalChanges?: boolean;
 }
-/**
- * Retry fallback - retry the same step with same config
- */
-interface RetryFallback extends BaseFallback {
-    type: 'retry';
+interface DispatchOptions$1 {
+    streamResponse?: boolean;
+    modelOverride?: string;
+    recordMode?: 'existing' | 'create' | 'virtual';
+    flowMode?: 'existing' | 'create' | 'virtual' | 'upsert';
+    storeResults?: boolean;
+    autoAppendMetadata?: boolean;
+    debugMode?: boolean;
+    createVersion?: boolean;
+    versionType?: 'published' | 'draft' | 'test' | 'virtual';
+    versionLabel?: string;
+    versionNotes?: string;
+    flowVersionId?: string;
+    /** Options for upsert mode (only used when flowMode is 'upsert') */
+    upsertOptions?: UpsertOptions$1;
+    flowTimeoutMs?: number;
+    stepTimeoutMs?: number;
 }
-/**
- * Model fallback for prompts - retry with different model/settings
- */
-interface ModelFallback extends BaseFallback {
-    type: 'model';
-    model: string;
-    temperature?: number;
-    maxTokens?: number;
-    topP?: number;
-    topK?: number;
-    frequencyPenalty?: number;
-    presencePenalty?: number;
-    seed?: number;
+interface Message$1 {
+    role: 'system' | 'user' | 'assistant';
+    content: MessageContent;
 }
-/**
- * Step fallback for context steps - run a different step type
- */
-interface StepFallback extends BaseFallback {
-    type: 'step';
+interface FlowPausedEvent {
+    type: 'flow_await';
+    executionId: string;
+    flowId: string;
+    toolId: string;
+    toolName: string;
+    awaitedAt: string;
+}
+interface StepWaitingLocalEvent {
+    type: 'step_await';
+    id: string;
+    name: string;
+    index: number;
     stepType: string;
-    stepConfig: Record<string, unknown>;
+    toolId: string;
+    toolName: string;
+    executionId: string;
+    parameters: any;
 }
 /**
- * Flow fallback - call another flow
+ * Emitted when a fallback chain starts execution
  */
-interface FlowFallback extends BaseFallback {
-    type: 'flow';
-    flowId: string;
-    inputs?: Record<string, unknown>;
+interface FallbacksInitiatedEvent {
+    type: 'fallbacks_initiated';
+    id: string;
+    totalFallbacks: number;
+    originalError: string;
+    timestamp: string;
 }
 /**
- * Union of all prompt fallback types
+ * Emitted when a fallback attempt starts
  */
-type PromptFallback = RetryFallback | ModelFallback;
+interface FallbackStartEvent {
+    type: 'fallback_start';
+    id: string;
+    attempt: number;
+    fallbackType: string;
+    timestamp: string;
+}
 /**
- * Union of all context step fallback types
+ * Emitted when a fallback attempt succeeds
  */
-type ContextFallback = RetryFallback | StepFallback | FlowFallback;
+interface FallbackSuccessEvent {
+    type: 'fallback_success';
+    id: string;
+    attempt: number;
+    fallbackType: string;
+    timestamp: string;
+}
 /**
- * Error handling configuration for prompts
+ * Emitted when a fallback attempt fails
  */
-interface PromptErrorHandling {
-    onError: ErrorHandlingMode;
-    fallbacks?: PromptFallback[];
+interface FallbackFailEvent {
+    type: 'fallback_fail';
+    id: string;
+    attempt: number;
+    fallbackType: string;
+    error: string;
+    timestamp: string;
 }
 /**
- * Error handling configuration for context steps
+ * Emitted when all fallbacks in the chain have been exhausted
  */
-interface ContextErrorHandling {
-    onError: ErrorHandlingMode;
-    fallbacks?: ContextFallback[];
+interface FallbacksExhaustedEvent {
+    type: 'fallbacks_exhausted';
+    id: string;
+    totalAttempts: number;
+    finalError: string;
+    timestamp: string;
+}
+interface FlowStartEvent {
+    type: 'flow_start';
+    flowId: string;
+    flowName: string;
+    totalSteps: number;
+}
+interface StepStartEvent {
+    type: 'step_start';
+    id: string;
+    name: string;
+    index: number;
+    stepType: string;
+}
+interface StepDeltaEvent {
+    type: 'step_delta';
+    id: string;
+    index: number;
+    /** Streaming text fragment. */
+    text: string;
+}
+interface StepCompleteEvent {
+    type: 'step_complete';
+    id: string;
+    name: string;
+    index: number;
+    stepType: string;
+    /** Step result - used by all step types */
+    result?: any;
+    executionTime: number;
+}
+interface FlowCompleteEvent {
+    type: 'flow_complete';
+    flowId: string;
+    totalSteps: number;
+    successfulSteps: number;
+    failedSteps: number;
+    executionTime: number;
+}
+interface FlowErrorEvent {
+    type: 'flow_error';
+    error: string;
+    stepId?: string;
 }
-
 /**
- * FlowResult - Wrapper for streaming flow execution responses
- *
- * Provides convenient methods for processing streaming responses
- * from the Runtype API dispatch endpoint.
+ * Union type of all possible SSE events
  */
-
+type StreamEvent = FlowStartEvent | StepStartEvent | StepDeltaEvent | StepCompleteEvent | FlowCompleteEvent | FlowErrorEvent | FlowPausedEvent | StepWaitingLocalEvent | FallbacksInitiatedEvent | FallbackStartEvent | FallbackSuccessEvent | FallbackFailEvent | FallbacksExhaustedEvent;
 /**
- * Result wrapper for flow execution
- *
- * Provides multiple ways to consume the streaming response:
- * - `.stream(callbacks)` - Process with callbacks
- * - `.getResult(stepName)` - Get result from a specific step
- * - `.getAllResults()` - Get all step results
- * - `.raw` - Access the raw Response for manual handling
+ * Callbacks for streaming flow execution
  *
  * @example
  * ```typescript
- * const result = await flow.run(apiClient, options)
- *
- * // Option 1: Process with callbacks
- * const summary = await result.stream({
- *   onStepDelta: (text) => process.stdout.write(text),
+ * await flow.run(apiClient, options, {
+ *   onStepStart: (event) => console.log('Starting:', event.name),
+ *   onStepDelta: (chunk, event) => process.stdout.write(chunk),
+ *   onStepComplete: (result, event) => console.log('Done:', event.name),
+ *   onFlowComplete: (event) => console.log('Flow complete'),
+ *   onError: (error) => console.error(error),
  * })
- *
- * // Option 2: Just get a specific step's result
- * const analysis = await result.getResult('Analyze Data')
- *
- * // Option 3: Get all results
- * const allResults = await result.getAllResults()
  * ```
  */
-declare class FlowResult {
-    private response;
-    private consumed;
-    private cachedSummary;
-    constructor(response: Response, summary?: FlowSummary);
+interface StreamCallbacks {
+    /** Called when flow execution starts */
+    onFlowStart?: (event: FlowStartEvent) => void;
+    /** Called when a step starts executing */
+    onStepStart?: (event: StepStartEvent) => void;
+    /** Called for each text fragment of streaming output from a step */
+    onStepDelta?: (text: string, event: StepDeltaEvent) => void;
+    /** Called when a step completes */
+    onStepComplete?: (result: any, event: StepCompleteEvent) => void;
+    /** Called when the entire flow completes */
+    onFlowComplete?: (event: FlowCompleteEvent) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+}
+/**
+ * Summary returned after flow execution completes
+ */
+interface FlowSummary {
+    flowId: string;
+    flowName: string;
+    totalSteps: number;
+    successfulSteps: number;
+    failedSteps: number;
+    executionTime: number;
+    /** Results from each step, keyed by step name */
+    results: Map<string, any>;
+    /** Whether the flow completed successfully */
+    success: boolean;
+}
+declare class FlowBuilder {
+    private flowConfig;
+    private steps;
+    private recordConfig;
+    private messagesConfig;
+    private inputsConfig;
+    private optionsConfig;
+    private stepCounter;
+    private existingFlowId;
     /**
-     * Get the raw Response object for manual handling
-     *
-     * Note: The response body can only be consumed once.
-     * Using this will prevent using other methods like stream() or getResult().
-     */
-    get raw(): Response;
-    /**
-     * Check if the response has already been consumed
+     * Initialize the flow with a name and optional description.
+     * Use this for virtual/one-off flows or when specifying flowMode in run().
      */
-    get isConsumed(): boolean;
+    createFlow(config: FlowConfig$1): this;
     /**
-     * Process the streaming response with callbacks
-     *
-     * @param callbacks - Callbacks for different event types
-     * @returns Promise resolving to FlowSummary when complete
+     * Define a flow for upsert - creates if it doesn't exist, updates if steps changed.
+     * This is the recommended pattern for code-first flow management.
      *
      * @example
      * ```typescript
-     * const summary = await result.stream({
-     *   onStepStart: (event) => console.log('Starting:', event.name),
-     *   onStepDelta: (text) => process.stdout.write(text),
-     *   onStepComplete: (result, event) => console.log('Done:', event.name),
-     *   onFlowComplete: (event) => console.log('Flow complete!'),
-     * })
+     * const result = await new FlowBuilder()
+     *   .upsertFlow({
+     *     name: 'My Flow',
+     *     createVersionOnChange: true
+     *   })
+     *   .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
+     *   .run(apiClient, { streamResponse: true })
      * ```
      */
-    stream(callbacks?: StreamCallbacks): Promise<FlowSummary>;
+    upsertFlow(config: UpsertFlowConfig$1): this;
     /**
-     * Get the result from a specific step by its name
-     *
-     * Matches against the `name` property you set when creating the step.
-     * - **Case-sensitive**: `'Analyze'` ≠ `'analyze'`
-     * - **Exact match only**: no partial or fuzzy matching
-     * - Returns `undefined` if no step with that name is found
-     *
-     * @param stepName - The exact step name (from the `name` property when creating the step)
-     * @returns The step's result, or undefined if not found
+     * Use an existing flow by ID instead of defining steps inline
      *
      * @example
      * ```typescript
-     * // When building:
-     * .prompt({ name: 'Analyze Screenshot', model: 'gpt-4', ... })
-     *
-     * // When retrieving (must match exactly):
-     * const analysis = await result.getResult('Analyze Screenshot')  // ✓ Works
-     * const analysis = await result.getResult('analyze screenshot')  // ✗ undefined
+     * const result = await new FlowBuilder()
+     *   .useExistingFlow('flow_abc123')
+     *   .withRecord({ name: 'Test', type: 'data' })
+     *   .run(apiClient, { streamResponse: true })
      * ```
      */
-    getResult(stepName: string): Promise<any>;
+    useExistingFlow(flowId: string): this;
     /**
-     * Get all step results as a Map
-     *
-     * @returns Map of step name to result
+     * Set the record configuration
+     */
+    withRecord(config: RecordConfig$1): this;
+    /**
+     * Set conversation messages
+     */
+    withMessages(messages: Message$1[]): this;
+    /**
+     * Set top-level input variables accessible as {{varName}} in templates
      *
      * @example
      * ```typescript
-     * const allResults = await result.getAllResults()
-     * for (const [stepName, result] of allResults) {
-     *   console.log(stepName, result)
-     * }
+     * const result = await new FlowBuilder()
+     *   .useExistingFlow('flow_abc123')
+     *   .withInputs({
+     *     customerName: 'John',
+     *     topic: 'billing'
+     *   })
+     *   .run(apiClient, { streamResponse: true })
      * ```
      */
-    getAllResults(): Promise<Map<string, any>>;
+    withInputs(inputs: Record<string, unknown>): this;
     /**
-     * Get the flow summary after processing
-     *
-     * @returns FlowSummary with execution details
+     * Set dispatch options
      */
-    getSummary(): Promise<FlowSummary>;
+    withOptions(options: DispatchOptions$1): this;
     /**
-     * Ensure the stream has been processed and return the summary
+     * Add a prompt step
      */
-    private ensureSummary;
+    prompt(config: PromptStepConfig$1): this;
     /**
-     * Ensure the response hasn't been consumed yet
+     * Add a crawl step
      */
-    private ensureNotConsumed;
-}
-
-/**
- * FlowBuilder - Fluent builder for constructing dispatch configurations
- *
- * Provides a chainable API for building flows with steps, making flow
- * construction more readable and type-safe.
- *
- * @example
- * ```typescript
- * import { FlowBuilder } from '@runtypelabs/sdk'
- *
- * const config = new FlowBuilder()
- *   .createFlow({ name: "My Flow" })
- *   .withRecord({ name: "Record", type: "data", metadata: { key: "value" } })
- *   .fetchUrl({ name: "Fetch", url: "https://api.example.com", outputVariable: "data" })
- *   .prompt({ name: "Process", model: "gpt-4", userPrompt: "Analyze: {{data}}" })
- *   .withOptions({ streamResponse: true, flowMode: "virtual" })
- *   .build()
- * ```
- */
-
-interface PromptStepConfig$1 {
-    name: string;
-    model: string;
-    userPrompt: string;
-    systemPrompt?: string;
-    previousMessages?: string | Array<{
-        role: string;
-        content: string;
-    }>;
-    outputVariable?: string;
-    responseFormat?: 'text' | 'json';
-    temperature?: number;
-    topP?: number;
-    topK?: number;
-    frequencyPenalty?: number;
-    presencePenalty?: number;
-    seed?: number;
-    maxTokens?: number;
+    crawl(config: CrawlStepConfig): this;
     /**
-     * Enable reasoning/extended thinking for models that support it.
-     * - `true`: Enable with provider defaults
-     * - `ReasoningConfig`: Fine-grained control over reasoning behavior
+     * Add a fetch URL step
+     */
+    fetchUrl(config: FetchUrlStepConfig$1): this;
+    /**
+     * Add a transform data step
+     */
+    transformData(config: TransformDataStepConfig$1): this;
+    /**
+     * Add a set variable step
+     */
+    setVariable(config: SetVariableStepConfig$1): this;
+    /**
+     * Add a conditional step
+     */
+    conditional(config: ConditionalStepConfig$1): this;
+    /**
+     * Add a search step
+     */
+    search(config: SearchStepConfig$1): this;
+    /**
+     * Add a send email step
+     */
+    sendEmail(config: SendEmailStepConfig$1): this;
+    /**
+     * Add a send stream step
+     */
+    sendStream(config: SendStreamStepConfig$1): this;
+    /**
+     * Add a retrieve record step
+     */
+    retrieveRecord(config: RetrieveRecordStepConfig$1): this;
+    /**
+     * Add an upsert record step
+     */
+    upsertRecord(config: UpsertRecordStepConfig$1): this;
+    /**
+     * Add a vector search step
+     */
+    vectorSearch(config: VectorSearchStepConfig$1): this;
+    /**
+     * Add a generate embedding step
+     */
+    generateEmbedding(config: GenerateEmbeddingStepConfig$1): this;
+    /**
+     * Add a wait until step
+     */
+    waitUntil(config: WaitUntilStepConfig$1): this;
+    /**
+     * Add a send event step
+     */
+    sendEvent(config: SendEventStepConfig$1): this;
+    /**
+     * Add a send text step
+     */
+    sendText(config: SendTextStepConfig$1): this;
+    /**
+     * Add a fetch GitHub step
+     */
+    fetchGitHub(config: FetchGitHubStepConfig$1): this;
+    /**
+     * Attach a subagent runtime tool to the most recent prompt step.
      *
-     * @example GPT-5 with streaming reasoning
+     * A subagent tool spawns a focused child agent in its own context window
+     * when the parent's model calls it. The child runs with a whitelisted tool
+     * subset drawn from `allowedTools` (every entry must be available on the
+     * parent step). The parent only sees the child's final result.
+     *
+     * Pass either `agentId` (for a saved agent in the same org) or `agent`
+     * (an inline exported-agent JSON shape) — exactly one is required.
+     *
+     * @example
      * ```typescript
-     * reasoning: { enabled: true, reasoningSummary: 'auto' }
+     * new FlowBuilder()
+     *   .createFlow({ name: 'Research' })
+     *   .prompt({ name: 'Plan', model: 'claude-sonnet-4-5', userPrompt: '...' })
+     *   .withSubagentTool('research_topic', {
+     *     agentId: 'agent_01h...',
+     *     allowedTools: ['builtin:exa_search'],
+     *     outputFormat: 'text',
+     *   })
      * ```
      */
-    reasoning?: boolean | ReasoningConfig;
-    streamOutput?: boolean;
-    /** Tools configuration - supports saved tools (toolIds) and inline runtime tools */
-    tools?: ToolsConfig;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | PromptErrorHandling;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface FetchUrlStepConfig$1 {
-    name: string;
-    url: string;
-    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    headers?: Record<string, string>;
-    body?: string;
-    responseType?: 'json' | 'text' | 'xml';
-    markdownIfAvailable?: boolean;
-    outputVariable?: string;
-    fetchMethod?: 'http' | 'firecrawl';
-    firecrawl?: {
-        formats?: string[];
-        [key: string]: any;
-    };
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface CrawlStepConfig {
-    name: string;
-    url: string;
-    limit?: number;
-    depth?: number;
-    source?: string;
-    formats?: string[];
-    render?: boolean;
-    maxAge?: number;
-    modifiedSince?: string;
-    options?: Record<string, unknown>;
-    authenticate?: Record<string, unknown>;
-    cookies?: Array<Record<string, unknown>>;
-    setExtraHTTPHeaders?: Record<string, string>;
-    gotoOptions?: Record<string, unknown>;
-    waitForSelector?: string;
-    rejectResourceTypes?: string[];
-    rejectRequestPattern?: string | string[];
-    userAgent?: string;
-    jsonOptions?: Record<string, unknown>;
-    outputVariable?: string;
-    streamOutput?: boolean;
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    pollIntervalMs?: number;
-    completionTimeoutMs?: number;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface TransformDataStepConfig$1 {
-    name: string;
-    script: string;
-    outputVariable?: string;
-    sandboxProvider?: 'quickjs' | 'daytona' | 'cloudflare-worker';
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface SetVariableStepConfig$1 {
-    name: string;
-    variableName: string;
-    value: string | number | boolean | object;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface ConditionalStepConfig$1 {
-    name: string;
-    condition: string;
-    trueSteps?: any[];
-    falseSteps?: any[];
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface SearchStepConfig$1 {
-    name: string;
-    provider: string;
-    query: string;
-    maxResults?: number;
-    outputVariable?: string;
-    returnCitations?: boolean;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface SendEmailStepConfig$1 {
-    name: string;
-    to: string;
-    from?: string;
-    subject: string;
-    html: string;
-    outputVariable?: string;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface SendStreamStepConfig$1 {
-    name: string;
-    message: string;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
+    withSubagentTool(name: string, opts: {
+        description?: string;
+        agentId?: string;
+        agent?: JsonObject;
+        allowedTools: string[];
+        parametersSchema?: JSONSchema;
+        maxTurns?: number;
+        maxCost?: number;
+        timeoutMs?: number;
+        outputFormat?: 'text' | 'json' | 'last_message';
+        inheritMessages?: boolean;
+        taskTemplate?: string;
+    }): this;
+    /**
+     * Enable agent-driven dynamic subagent spawning on the most recent prompt
+     * step (surface C of the subagent design).
+     *
+     * When set, the API synthesizes a `spawn_subagent` tool the parent's model
+     * 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. The API validates pool entries and rejects escalation.
+     *
+     * @example
+     * ```typescript
+     * new FlowBuilder()
+     *   .createFlow({ name: 'Explore' })
+     *   .prompt({ name: 'Research', model: 'claude-sonnet-4-5', userPrompt: '...' })
+     *   .withSubagents({
+     *     toolPool: ['builtin:exa_search', 'mcp:*'],
+     *     maxSpawnsPerRun: 3,
+     *     allowNesting: false,
+     *   })
+     * ```
+     */
+    withSubagents(opts: AgentSubagentConfig): this;
+    /**
+     * Build the final dispatch request configuration
+     */
+    build(): DispatchRequest;
+    /**
+     * Build and execute the flow with the provided client
+     *
+     * Returns a FlowResult that can be used to:
+     * - Process with callbacks via `.stream(callbacks)`
+     * - Get a specific step result via `.getResult(stepName)`
+     * - Get all results via `.getAllResults()`
+     * - Access raw response via `.raw`
+     *
+     * @param client - Client with dispatch capability
+     * @param options - Optional execution options (merged with any .withOptions() settings)
+     * @returns FlowResult for processing the streaming response
+     *
+     * @example
+     * ```typescript
+     * // Simple execution with result extraction
+     * const result = await flow.run(apiClient, { streamResponse: true })
+     * const analysis = await result.getResult('Analyze Data')
+     *
+     * // With streaming callbacks
+     * const result = await flow.run(apiClient, options)
+     * await result.stream({
+     *   onStepDelta: (chunk) => process.stdout.write(chunk),
+     *   onFlowComplete: () => console.log('Done!'),
+     * })
+     * ```
+     */
+    run(client: DispatchClient, options?: DispatchOptions$1): Promise<FlowResult>;
+    /**
+     * Build and execute the flow with callbacks for streaming events
+     *
+     * @param client - Client with dispatch capability
+     * @param options - Execution options (merged with any .withOptions() settings)
+     * @param callbacks - Callbacks for streaming events
+     * @returns FlowSummary when execution completes
+     *
+     * @example
+     * ```typescript
+     * const summary = await flow.run(apiClient, options, {
+     *   onStepStart: (event) => console.log('Starting:', event.name),
+     *   onStepDelta: (chunk) => process.stdout.write(chunk),
+     *   onStepComplete: (result, event) => console.log('Done:', event.name),
+     *   onFlowComplete: (event) => console.log('Flow complete!'),
+     * })
+     * ```
+     */
+    run(client: DispatchClient, options: DispatchOptions$1, callbacks: StreamCallbacks): Promise<FlowSummary>;
+    /**
+     * Set a run condition (when predicate) on the last added step.
+     * If the expression evaluates to falsy at runtime, the step is skipped.
+     *
+     * @example
+     * ```typescript
+     * new FlowBuilder()
+     *   .createFlow({ name: 'Conditional' })
+     *   .prompt({ name: 'Summarize', model: 'gpt-4', userPrompt: '...' })
+     *   .when('data.length > 0')
+     *   .build()
+     * ```
+     */
+    when(expression: string): this;
+    private addStep;
 }
 /**
- * Operator allowlist for chip-style record filters. Mirrors the API's
- * `record-filter-compiler.ts`. Kept inline here to avoid a hard dependency
- * on `@runtypelabs/shared` from the published SDK.
+ * Interface for clients that can dispatch flows
  */
-type RecordFilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'notIn' | 'isSet' | 'isNotSet' | 'isTrue' | 'isFalse' | 'withinLastDays' | 'olderThanDays';
-interface RecordFilterCondition {
-    field: string;
-    op: RecordFilterOperator;
-    value?: unknown;
-}
-interface RecordFilterGroup {
-    op: 'and' | 'or';
-    conditions: Array<RecordFilterCondition | RecordFilterGroup>;
-}
-interface RecordFilter {
-    type: string;
-    where?: RecordFilterCondition | RecordFilterGroup;
-}
-interface RetrieveRecordStepConfig$1 {
-    name: string;
-    recordType?: string;
-    recordName?: string;
+interface DispatchClient {
     /**
-     * Optional chip-style filter (metadata + top-level columns: id, name,
-     * createdAt, updatedAt). Coexists with recordType/recordName for
-     * backward compatibility; the API executor prefers recordFilter when
-     * both are set.
+     * Run a flow with local tools (automatic pause/resume loop)
+     *
+     * @param config - The dispatch request configuration
+     * @param localTools - Map of tool names to async functions that execute the tool logic
+     * @param callbacks - Optional callbacks for streaming events
+     * @returns The final result of the flow execution or summary if streaming
      */
-    recordFilter?: RecordFilter;
-    fieldsToInclude?: string[];
-    fieldsToExclude?: string[];
-    outputVariable?: string;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface UpsertRecordStepConfig$1 {
-    name: string;
-    recordType: string;
-    recordName?: string;
-    sourceVariable?: string;
-    mergeStrategy?: 'merge' | 'replace';
-    outputVariable?: string;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
-}
-interface VectorSearchStepConfig$1 {
-    name: string;
-    query: string;
-    recordType?: string;
-    embeddingModel?: string;
-    limit?: number;
-    threshold?: number;
-    outputVariable?: string;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
+    runWithLocalTools(config: DispatchRequest, localTools: Record<string, (args: any) => Promise<any>>, callbacks?: StreamCallbacks): Promise<FlowResult | FlowSummary>;
+    dispatch(config: DispatchRequest): Promise<Response>;
 }
-interface GenerateEmbeddingStepConfig$1 {
-    name: string;
-    text: string;
-    embeddingModel?: string;
-    maxLength?: number;
-    outputVariable?: string;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
+/**
+ * FlowBuilder that is bound to a client for direct execution
+ *
+ * @example
+ * ```typescript
+ * // Via RuntypeClient.flow()
+ * const result = await runtype
+ *   .flow('My Flow')
+ *   .fetchUrl({ name: 'Fetch', url: '...', outputVariable: 'data' })
+ *   .prompt({ name: 'Process', model: 'gpt-4', userPrompt: '...' })
+ *   .run({ streamResponse: true })
+ *
+ * const data = await result.getResult('Process')
+ * ```
+ */
+declare class ClientFlowBuilder extends FlowBuilder {
+    private boundClient;
+    constructor(client: DispatchClient, name: string);
+    /**
+     * Build and execute the flow using the bound client
+     *
+     * For ClientFlowBuilder, you can either:
+     * 1. Pass a client (which is ignored, the bound client is used)
+     * 2. Pass options directly as the first argument
+     *
+     * @example
+     * ```typescript
+     * // Simple execution (no args needed)
+     * const result = await builder.run()
+     * const data = await result.getResult('Process')
+     *
+     * // With options only
+     * const result = await builder.run({ streamResponse: true, flowMode: 'virtual' })
+     *
+     * // With options and callbacks
+     * const summary = await builder.run({ streamResponse: true }, {
+     *   onStepDelta: (chunk) => process.stdout.write(chunk),
+     *   onFlowComplete: () => console.log('Done!'),
+     * })
+     *
+     * // Parent class signature (client ignored)
+     * const result = await builder.run(someClient, { streamResponse: true })
+     * ```
+     */
+    run(): Promise<FlowResult>;
+    run(options: DispatchOptions$1): Promise<FlowResult>;
+    run(options: DispatchOptions$1, callbacks: StreamCallbacks): Promise<FlowSummary>;
+    run(localTools: Record<string, (args: any) => Promise<any>>): Promise<FlowResult>;
+    run(options: DispatchOptions$1, localTools: Record<string, (args: any) => Promise<any>>): Promise<FlowResult>;
+    run(localTools: Record<string, (args: any) => Promise<any>>, callbacks: StreamCallbacks): Promise<FlowSummary>;
+    run(options: DispatchOptions$1, localTools: Record<string, (args: any) => Promise<any>>, callbacks: StreamCallbacks): Promise<FlowSummary>;
+    run(client: DispatchClient, options?: DispatchOptions$1): Promise<FlowResult>;
+    run(client: DispatchClient, options: DispatchOptions$1, callbacks: StreamCallbacks): Promise<FlowSummary>;
 }
-interface WaitUntilStepConfig$1 {
+/**
+ * Create an external runtime tool definition.
+ *
+ * External tools make HTTP requests to external APIs with support for
+ * variable substitution in URLs and headers.
+ *
+ * Special internal variables are available for auth:
+ * - `{{_internal.auth_token}}` - Bearer token for Runtype API auth
+ * - `{{_internal.user_id}}` - Current user ID
+ * - `{{_internal.org_id}}` - Current organization ID
+ *
+ * @example
+ * ```typescript
+ * const listFlowsTool = createExternalTool({
+ *   name: 'list_flows',
+ *   description: 'List all flows in the workspace',
+ *   parametersSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       limit: { type: 'number', description: 'Max results', default: 20 }
+ *     }
+ *   },
+ *   url: 'https://api.runtype.com/v1/flows',
+ *   method: 'GET',
+ *   headers: { Authorization: '{{_internal.auth_token}}' }
+ * })
+ * ```
+ */
+declare function createExternalTool(config: {
     name: string;
-    delayMs?: number;
-    continueOnTimeout?: boolean;
-    poll?: {
-        enabled: boolean;
-        intervalMs?: number;
-        maxAttempts?: number;
-        condition?: string;
+    description: string;
+    parametersSchema: any;
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: string;
+}): RuntimeTool;
+
+/**
+ * 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[];
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+type Metadata = JsonObject;
+interface JSONSchema {
+    type: 'object' | 'string' | 'number' | 'boolean' | 'array' | 'null';
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    description?: string;
+    default?: JsonValue;
+    enum?: JsonPrimitive[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+interface ClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    apiVersion?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+interface PaginationResponse<T> {
+    data: T[];
+    pagination: {
+        nextCursor: string | null;
+        prevCursor: string | null;
+        hasMore: boolean;
+        hasPrev: boolean;
+        limit: number;
+        currentOffset: number;
+        totalPages?: number;
+        currentPage?: number;
+        totalCount?: number;
     };
-    outputVariable?: string;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
 }
-interface SendEventStepConfig$1 {
-    name: string;
-    provider: string;
-    eventName: string;
-    properties?: Record<string, any>;
-    outputVariable?: string;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
+interface ApiResponse<T> {
+    data?: T;
+    success?: boolean;
+    error?: string;
+    message?: string;
 }
-interface SendTextStepConfig$1 {
+interface FlowStep {
+    id: string;
+    flowId: string;
+    type: string;
     name: string;
-    to: string;
-    from?: string;
-    message: string;
-    outputVariable?: string;
-    /** Error handling configuration - supports simple mode or fallback chains */
-    errorHandling?: ErrorHandlingMode | ContextErrorHandling;
+    order: number;
+    enabled: boolean;
+    config: Record<string, unknown>;
+    outputVariable?: string | null;
     streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
+    createdAt: string;
+    updatedAt: string;
 }
-interface FetchGitHubStepConfig$1 {
+interface Flow {
+    id: string;
     name: string;
-    repository: string;
-    branch?: string;
-    path?: string;
-    outputVariable?: string;
-    streamOutput?: boolean;
-    enabled?: boolean;
-    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
-    when?: string;
+    description?: string | null;
+    status: 'draft' | 'active' | 'paused' | 'failed';
+    config?: JsonObject;
+    userId: string;
+    organizationId: string | null;
+    createdAt: string;
+    updatedAt: string;
+    lastRunAt?: string | null;
+    /** Flow steps embedded in the flow response */
+    flowSteps?: FlowStep[];
+    /** Number of steps in the flow */
+    stepCount?: number;
 }
-interface FlowConfig$1 {
+interface Prompt$1 {
+    id: string;
     name: string;
-    description?: string;
-}
-/**
- * Configuration for upsert flow - includes flow name and upsert behavior options
- */
-interface UpsertFlowConfig$1 extends FlowConfig$1 {
-    /** Whether to create a version snapshot before updating (default: true) */
-    createVersionOnChange?: boolean;
-    /** Allow overwriting changes made via dashboard/API (default: false) */
-    allowOverwriteExternalChanges?: boolean;
+    text: string;
+    responseFormat: 'default' | 'json' | 'markdown' | 'html' | 'xml';
+    model: string;
+    isStreamed: boolean;
+    tools: string[];
+    inputVariables?: string;
+    estimatedTokens?: number;
+    estimatedCost?: string;
+    userId: string;
+    createdAt: string;
+    updatedAt: string;
+    flows?: FlowAttachment[];
 }
-interface RecordConfig$1 {
-    id?: number | string;
-    name?: string;
-    type?: string;
-    metadata?: Record<string, any>;
+interface FlowAttachment {
+    flowId: string;
+    flowName: string;
+    order: number;
 }
-/**
- * Options for upsert mode - controls conflict detection and versioning
- */
-interface UpsertOptions {
-    /** Whether to create a version snapshot before updating (default: true) */
-    createVersionOnChange?: boolean;
-    /** Allow overwriting changes made via dashboard/API (default: false) */
-    allowOverwriteExternalChanges?: boolean;
-}
-interface DispatchOptions$1 {
-    streamResponse?: boolean;
-    modelOverride?: string;
-    recordMode?: 'existing' | 'create' | 'virtual';
-    flowMode?: 'existing' | 'create' | 'virtual' | 'upsert';
-    storeResults?: boolean;
-    autoAppendMetadata?: boolean;
-    debugMode?: boolean;
-    createVersion?: boolean;
-    versionType?: 'published' | 'draft' | 'test' | 'virtual';
-    versionLabel?: string;
-    versionNotes?: string;
-    flowVersionId?: string;
-    /** Options for upsert mode (only used when flowMode is 'upsert') */
-    upsertOptions?: UpsertOptions;
-    flowTimeoutMs?: number;
-    stepTimeoutMs?: number;
-}
-interface Message$1 {
-    role: 'system' | 'user' | 'assistant';
-    content: MessageContent;
-}
-interface FlowPausedEvent {
-    type: 'flow_await';
-    executionId: string;
-    flowId: string;
-    toolId: string;
-    toolName: string;
-    awaitedAt: string;
-}
-interface StepWaitingLocalEvent {
-    type: 'step_await';
+interface RuntypeRecord {
     id: string;
+    type: string;
     name: string;
-    index: number;
-    stepType: string;
-    toolId: string;
-    toolName: string;
-    executionId: string;
-    parameters: any;
-}
-/**
- * Emitted when a fallback chain starts execution
- */
-interface FallbacksInitiatedEvent {
-    type: 'fallbacks_initiated';
-    id: string;
-    totalFallbacks: number;
-    originalError: string;
-    timestamp: string;
+    metadata: Metadata;
+    metadataLabels?: {
+        [key: string]: string;
+    };
+    metadataSchema?: {
+        keys: string[];
+        keyMapping?: {
+            [key: string]: string;
+        };
+        keyTypes?: {
+            [key: string]: string;
+        };
+        types?: {
+            [key: string]: string;
+        };
+        sizeKb: number;
+        keyCount: number;
+        updatedAt: string;
+    };
+    messages?: Array<{
+        role: 'user' | 'assistant';
+        content: string | unknown[];
+    }> | null;
+    availableFields?: string[];
+    userId: string;
+    organizationId?: string | null;
+    createdAt: string;
+    updatedAt: string;
 }
-/**
- * Emitted when a fallback attempt starts
- */
-interface FallbackStartEvent {
-    type: 'fallback_start';
+interface ApiKey {
     id: string;
-    attempt: number;
-    fallbackType: string;
-    timestamp: string;
+    name: string;
+    keyPrefix: string;
+    searchHint?: string;
+    permissions: string[];
+    isActive: boolean;
+    expiresAt?: string;
+    allowedIps: string[];
+    createdAt: string;
+    updatedAt?: string;
+    lastUsedAt?: string;
 }
-/**
- * Emitted when a fallback attempt succeeds
- */
-interface FallbackSuccessEvent {
-    type: 'fallback_success';
+interface ModelConfig {
     id: string;
-    attempt: number;
-    fallbackType: string;
-    timestamp: string;
+    provider: string;
+    modelId: string;
+    displayName?: string;
+    /** @deprecated Use keyStatus instead */
+    supportsCustomKey: boolean;
+    keyStatus?: 'platform' | 'custom' | 'needs_setup';
+    costPer1kTokens?: number;
+    contextLength?: number;
+    maxOutputTokens?: number;
+    maxTokens?: number;
+    supportsStreaming?: boolean;
+    supportedResponseFormats?: string[];
+    supportsSearch?: boolean;
+    isEnabled: boolean;
+    isDefault: boolean;
+    settings: JsonObject;
+    createdAt: string;
+    updatedAt: string;
+    providerKeyId?: string | null;
+    requiresIntegration?: string;
+    apiKey?: string;
+    scope?: 'personal' | 'organization';
+    organizationId?: string;
 }
-/**
- * Emitted when a fallback attempt fails
- */
-interface FallbackFailEvent {
-    type: 'fallback_fail';
+interface UserProfile {
     id: string;
-    attempt: number;
-    fallbackType: string;
-    error: string;
-    timestamp: string;
+    firstName?: string;
+    lastName?: string;
+    email: string;
+    preferences?: {
+        theme?: 'light' | 'dark' | 'system';
+        notifications?: boolean;
+        defaultModel?: string;
+    };
 }
-/**
- * Emitted when all fallbacks in the chain have been exhausted
- */
-interface FallbacksExhaustedEvent {
-    type: 'fallbacks_exhausted';
-    id: string;
-    totalAttempts: number;
-    finalError: string;
-    timestamp: string;
+interface CreateFlowRequest {
+    name: string;
+    description?: string;
+    flowSteps?: Array<{
+        type: 'prompt' | 'context' | 'condition' | 'output' | 'email';
+        name: string;
+        order?: number;
+        enabled?: boolean;
+        config: JsonObject;
+    }>;
 }
-interface FlowStartEvent {
-    type: 'flow_start';
-    flowId: string;
-    flowName: string;
-    totalSteps: number;
+interface CreatePromptRequest {
+    flowIds?: string[];
+    name: string;
+    text: string;
+    responseFormat?: 'json' | 'markdown' | 'text' | 'html' | 'xml';
+    model?: string;
+    inputVariables?: string;
 }
-interface StepStartEvent {
-    type: 'step_start';
-    id: string;
+interface CreateRecordRequest {
+    type: string;
     name: string;
-    index: number;
-    stepType: string;
+    metadata?: Metadata;
 }
-interface StepDeltaEvent {
-    type: 'step_delta';
-    id: string;
-    index: number;
-    /** Streaming text fragment. */
-    text: string;
+interface BulkEditCondition {
+    field: string;
+    operator: 'equals' | 'equals_ci' | 'not_equals' | 'contains' | 'not_contains';
+    value: string | number | boolean;
 }
-interface StepCompleteEvent {
-    type: 'step_complete';
+interface BulkEditRequest {
+    recordIds?: string[];
+    conditions?: BulkEditCondition[];
+    /** Type-scoped record-filter DSL. Mutually exclusive with `conditions`. */
+    recordFilter?: RecordFilter;
+    updates?: JsonObject;
+    deleteFields?: string[];
+    dryRun?: boolean;
+    applyToAll?: boolean;
+}
+interface BulkEditResult {
     id: string;
+    before: JsonObject;
+    after: JsonObject;
+}
+interface BulkEditResponse {
+    data: BulkEditResult[];
+    recordIds?: number[];
+}
+interface ProviderApiKey {
+    id: number;
+    provider: 'openai' | 'anthropic' | 'huggingface' | 'google' | 'xai' | 'mixlayer' | 'togetherai';
     name: string;
-    index: number;
-    stepType: string;
-    /** Step result - used by all step types */
-    result?: any;
-    executionTime: number;
+    keyPreview: string;
+    isDefault: boolean;
+    isActive: boolean;
+    usageCount: number;
+    lastUsedAt?: string;
+    createdAt: string;
+    updatedAt: string;
 }
-interface FlowCompleteEvent {
-    type: 'flow_complete';
-    flowId: string;
-    totalSteps: number;
-    successfulSteps: number;
-    failedSteps: number;
-    executionTime: number;
+interface CreateProviderKeyRequest {
+    provider: 'openai' | 'anthropic' | 'huggingface' | 'google' | 'xai' | 'mixlayer' | 'togetherai';
+    name: string;
+    apiKey: string;
+    isDefault?: boolean;
 }
-interface FlowErrorEvent {
-    type: 'flow_error';
-    error: string;
-    stepId?: string;
+interface UpdateProviderKeyRequest {
+    name?: string;
+    apiKey?: string;
+    isDefault?: boolean;
+    isActive?: boolean;
 }
-/**
- * Union type of all possible SSE events
- */
-type StreamEvent = FlowStartEvent | StepStartEvent | StepDeltaEvent | StepCompleteEvent | FlowCompleteEvent | FlowErrorEvent | FlowPausedEvent | StepWaitingLocalEvent | FallbacksInitiatedEvent | FallbackStartEvent | FallbackSuccessEvent | FallbackFailEvent | FallbacksExhaustedEvent;
-/**
- * Callbacks for streaming flow execution
- *
- * @example
- * ```typescript
- * await flow.run(apiClient, options, {
- *   onStepStart: (event) => console.log('Starting:', event.name),
- *   onStepDelta: (chunk, event) => process.stdout.write(chunk),
- *   onStepComplete: (result, event) => console.log('Done:', event.name),
- *   onFlowComplete: (event) => console.log('Flow complete'),
- *   onError: (error) => console.error(error),
- * })
- * ```
+interface CreateApiKeyRequest {
+    name: string;
+    permissions?: string[];
+    expiresAt?: string;
+    allowedIps?: string[];
+    environment?: 'test' | 'production';
+}
+interface CreateModelConfigRequest {
+    provider: 'mixlayer' | 'openai' | 'anthropic' | 'google' | 'xai' | 'huggingface' | 'togetherai';
+    modelId: string;
+    apiKey?: string;
+    settings?: JsonObject;
+}
+/** Content part types for multi-modal messages */
+interface TextContentPart {
+    type: 'text';
+    text: string;
+}
+interface ImageContentPart {
+    type: 'image';
+    image: string;
+    mimeType?: string;
+}
+interface FileContentPart {
+    type: 'file';
+    data: string;
+    mimeType: string;
+    filename: string;
+}
+type MessageContent = string | Array<TextContentPart | ImageContentPart | FileContentPart>;
+/**
+ * Options for upsert mode - controls conflict detection and versioning
  */
-interface StreamCallbacks {
-    /** Called when flow execution starts */
-    onFlowStart?: (event: FlowStartEvent) => void;
-    /** Called when a step starts executing */
-    onStepStart?: (event: StepStartEvent) => void;
-    /** Called for each text fragment of streaming output from a step */
-    onStepDelta?: (text: string, event: StepDeltaEvent) => void;
-    /** Called when a step completes */
-    onStepComplete?: (result: any, event: StepCompleteEvent) => void;
-    /** Called when the entire flow completes */
-    onFlowComplete?: (event: FlowCompleteEvent) => void;
-    /** Called when an error occurs */
-    onError?: (error: Error) => void;
+interface UpsertOptions {
+    /** Whether to create a version snapshot before updating (default: true) */
+    createVersionOnChange?: boolean;
+    /** Allow overwriting changes made via dashboard/API (default: false) */
+    allowOverwriteExternalChanges?: boolean;
 }
 /**
- * Summary returned after flow execution completes
+ * Environment type for dispatch requests
  */
-interface FlowSummary {
-    flowId: string;
-    flowName: string;
-    totalSteps: number;
-    successfulSteps: number;
-    failedSteps: number;
-    executionTime: number;
-    /** Results from each step, keyed by step name */
-    results: Map<string, any>;
-    /** Whether the flow completed successfully */
-    success: boolean;
+type DispatchEnvironment = 'development' | 'production';
+interface DispatchRequest {
+    record?: {
+        id?: number | string;
+        name?: string;
+        type?: string;
+        metadata?: Metadata;
+    };
+    flow: {
+        id?: string;
+        name?: string;
+        contentHash?: string;
+        steps?: Array<any>;
+    };
+    messages?: Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: MessageContent;
+    }>;
+    secrets?: Record<string, string>;
+    inputs?: Record<string, unknown>;
+    options?: {
+        streamResponse?: boolean;
+        modelOverride?: string;
+        recordMode?: 'existing' | 'create' | 'virtual';
+        flowMode?: 'existing' | 'create' | 'virtual' | 'upsert';
+        storeResults?: boolean;
+        autoAppendMetadata?: boolean;
+        debugMode?: boolean;
+        environment?: DispatchEnvironment;
+        createVersion?: boolean;
+        versionType?: 'published' | 'draft' | 'test' | 'virtual';
+        versionLabel?: string;
+        versionNotes?: string;
+        flowVersionId?: string;
+        upsertOptions?: UpsertOptions;
+        flowTimeoutMs?: number;
+        stepTimeoutMs?: number;
+    };
 }
-declare class FlowBuilder {
-    private flowConfig;
-    private steps;
-    private recordConfig;
-    private messagesConfig;
-    private inputsConfig;
-    private optionsConfig;
-    private stepCounter;
-    private existingFlowId;
-    /**
-     * Initialize the flow with a name and optional description.
-     * Use this for virtual/one-off flows or when specifying flowMode in run().
-     */
-    createFlow(config: FlowConfig$1): this;
-    /**
-     * Define a flow for upsert - creates if it doesn't exist, updates if steps changed.
-     * This is the recommended pattern for code-first flow management.
-     *
-     * @example
-     * ```typescript
-     * const result = await new FlowBuilder()
-     *   .upsertFlow({
-     *     name: 'My Flow',
-     *     createVersionOnChange: true
-     *   })
-     *   .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
-     *   .run(apiClient, { streamResponse: true })
-     * ```
-     */
-    upsertFlow(config: UpsertFlowConfig$1): this;
-    /**
-     * Use an existing flow by ID instead of defining steps inline
-     *
-     * @example
-     * ```typescript
-     * const result = await new FlowBuilder()
-     *   .useExistingFlow('flow_abc123')
-     *   .withRecord({ name: 'Test', type: 'data' })
-     *   .run(apiClient, { streamResponse: true })
-     * ```
-     */
-    useExistingFlow(flowId: string): this;
-    /**
-     * Set the record configuration
-     */
-    withRecord(config: RecordConfig$1): this;
-    /**
-     * Set conversation messages
-     */
-    withMessages(messages: Message$1[]): this;
-    /**
-     * Set top-level input variables accessible as {{varName}} in templates
-     *
-     * @example
-     * ```typescript
-     * const result = await new FlowBuilder()
-     *   .useExistingFlow('flow_abc123')
-     *   .withInputs({
-     *     customerName: 'John',
-     *     topic: 'billing'
-     *   })
-     *   .run(apiClient, { streamResponse: true })
-     * ```
-     */
-    withInputs(inputs: Record<string, unknown>): this;
-    /**
-     * Set dispatch options
-     */
-    withOptions(options: DispatchOptions$1): this;
-    /**
-     * Add a prompt step
-     */
-    prompt(config: PromptStepConfig$1): this;
-    /**
-     * Add a crawl step
-     */
-    crawl(config: CrawlStepConfig): this;
-    /**
-     * Add a fetch URL step
-     */
-    fetchUrl(config: FetchUrlStepConfig$1): this;
-    /**
-     * Add a transform data step
-     */
-    transformData(config: TransformDataStepConfig$1): this;
-    /**
-     * Add a set variable step
-     */
-    setVariable(config: SetVariableStepConfig$1): this;
-    /**
-     * Add a conditional step
-     */
-    conditional(config: ConditionalStepConfig$1): this;
-    /**
-     * Add a search step
-     */
-    search(config: SearchStepConfig$1): this;
-    /**
-     * Add a send email step
-     */
-    sendEmail(config: SendEmailStepConfig$1): this;
-    /**
-     * Add a send stream step
-     */
-    sendStream(config: SendStreamStepConfig$1): this;
-    /**
-     * Add a retrieve record step
-     */
-    retrieveRecord(config: RetrieveRecordStepConfig$1): this;
-    /**
-     * Add an upsert record step
-     */
-    upsertRecord(config: UpsertRecordStepConfig$1): this;
-    /**
-     * Add a vector search step
-     */
-    vectorSearch(config: VectorSearchStepConfig$1): this;
-    /**
-     * Add a generate embedding step
-     */
-    generateEmbedding(config: GenerateEmbeddingStepConfig$1): this;
-    /**
-     * Add a wait until step
-     */
-    waitUntil(config: WaitUntilStepConfig$1): this;
-    /**
-     * Add a send event step
-     */
-    sendEvent(config: SendEventStepConfig$1): this;
-    /**
-     * Add a send text step
-     */
-    sendText(config: SendTextStepConfig$1): this;
-    /**
-     * Add a fetch GitHub step
-     */
-    fetchGitHub(config: FetchGitHubStepConfig$1): this;
-    /**
-     * Attach a subagent runtime tool to the most recent prompt step.
-     *
-     * A subagent tool spawns a focused child agent in its own context window
-     * when the parent's model calls it. The child runs with a whitelisted tool
-     * subset drawn from `allowedTools` (every entry must be available on the
-     * parent step). The parent only sees the child's final result.
-     *
-     * Pass either `agentId` (for a saved agent in the same org) or `agent`
-     * (an inline exported-agent JSON shape) — exactly one is required.
-     *
-     * @example
-     * ```typescript
-     * new FlowBuilder()
-     *   .createFlow({ name: 'Research' })
-     *   .prompt({ name: 'Plan', model: 'claude-sonnet-4-5', userPrompt: '...' })
-     *   .withSubagentTool('research_topic', {
-     *     agentId: 'agent_01h...',
-     *     allowedTools: ['builtin:exa_search'],
-     *     outputFormat: 'text',
-     *   })
-     * ```
-     */
-    withSubagentTool(name: string, opts: {
-        description?: string;
-        agentId?: string;
-        agent?: JsonObject;
-        allowedTools: string[];
-        parametersSchema?: JSONSchema;
-        maxTurns?: number;
-        maxCost?: number;
-        timeoutMs?: number;
-        outputFormat?: 'text' | 'json' | 'last_message';
-        inheritMessages?: boolean;
-        taskTemplate?: string;
-    }): this;
-    /**
-     * Enable agent-driven dynamic subagent spawning on the most recent prompt
-     * step (surface C of the subagent design).
-     *
-     * When set, the API synthesizes a `spawn_subagent` tool the parent's model
-     * 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. The API validates pool entries and rejects escalation.
-     *
-     * @example
-     * ```typescript
-     * new FlowBuilder()
-     *   .createFlow({ name: 'Explore' })
-     *   .prompt({ name: 'Research', model: 'claude-sonnet-4-5', userPrompt: '...' })
-     *   .withSubagents({
-     *     toolPool: ['builtin:exa_search', 'mcp:*'],
-     *     maxSpawnsPerRun: 3,
-     *     allowNesting: false,
-     *   })
-     * ```
-     */
-    withSubagents(opts: AgentSubagentConfig): this;
-    /**
-     * Build the final dispatch request configuration
-     */
-    build(): DispatchRequest;
-    /**
-     * Build and execute the flow with the provided client
-     *
-     * Returns a FlowResult that can be used to:
-     * - Process with callbacks via `.stream(callbacks)`
-     * - Get a specific step result via `.getResult(stepName)`
-     * - Get all results via `.getAllResults()`
-     * - Access raw response via `.raw`
-     *
-     * @param client - Client with dispatch capability
-     * @param options - Optional execution options (merged with any .withOptions() settings)
-     * @returns FlowResult for processing the streaming response
-     *
-     * @example
-     * ```typescript
-     * // Simple execution with result extraction
-     * const result = await flow.run(apiClient, { streamResponse: true })
-     * const analysis = await result.getResult('Analyze Data')
-     *
-     * // With streaming callbacks
-     * const result = await flow.run(apiClient, options)
-     * await result.stream({
-     *   onStepDelta: (chunk) => process.stdout.write(chunk),
-     *   onFlowComplete: () => console.log('Done!'),
-     * })
-     * ```
-     */
-    run(client: DispatchClient, options?: DispatchOptions$1): Promise<FlowResult>;
-    /**
-     * Build and execute the flow with callbacks for streaming events
-     *
-     * @param client - Client with dispatch capability
-     * @param options - Execution options (merged with any .withOptions() settings)
-     * @param callbacks - Callbacks for streaming events
-     * @returns FlowSummary when execution completes
-     *
-     * @example
-     * ```typescript
-     * const summary = await flow.run(apiClient, options, {
-     *   onStepStart: (event) => console.log('Starting:', event.name),
-     *   onStepDelta: (chunk) => process.stdout.write(chunk),
-     *   onStepComplete: (result, event) => console.log('Done:', event.name),
-     *   onFlowComplete: (event) => console.log('Flow complete!'),
-     * })
-     * ```
-     */
-    run(client: DispatchClient, options: DispatchOptions$1, callbacks: StreamCallbacks): Promise<FlowSummary>;
-    /**
-     * Set a run condition (when predicate) on the last added step.
-     * If the expression evaluates to falsy at runtime, the step is skipped.
-     *
-     * @example
-     * ```typescript
-     * new FlowBuilder()
-     *   .createFlow({ name: 'Conditional' })
-     *   .prompt({ name: 'Summarize', model: 'gpt-4', userPrompt: '...' })
-     *   .when('data.length > 0')
-     *   .build()
-     * ```
-     */
-    when(expression: string): this;
-    private addStep;
+interface ListParams {
+    limit?: number;
+    cursor?: string;
+    direction?: 'next' | 'prev';
+}
+interface RecordListParams extends ListParams {
+    metadataKeys?: string;
+    metadataKeysAll?: string;
+    minFields?: number;
+    maxFields?: number;
+    metadataTypes?: string;
+    hasLargeFields?: boolean;
+    minSizeKb?: number;
+    maxSizeKb?: number;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+    includeFields?: boolean;
+}
+interface Tool {
+    id: string;
+    userId: string;
+    organizationId?: string;
+    name: string;
+    description: string;
+    toolType: 'flow' | 'custom' | 'external' | 'local' | 'subagent';
+    parametersSchema: JSONSchema;
+    config: ToolConfig;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+type ToolConfig = FlowToolConfig | CustomToolConfig | ExternalToolConfig | LocalToolConfig | SubagentToolConfig;
+interface FlowToolConfig {
+    flowId?: string;
+    toolId?: string;
+    parameterMapping: Record<string, string>;
+    outputMapping?: string;
+}
+interface CustomToolConfig {
+    code: string;
+    timeout: number;
+    allowedApis: string[];
+}
+interface ExternalToolConfig {
+    url: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: string;
+    authType?: 'none' | 'bearer' | 'api_key';
+}
+interface LocalToolConfig {
+    [key: string]: JsonValue;
+}
+interface SubagentToolConfig {
+    agentId?: string;
+    agent?: JsonObject;
+    allowedTools: string[];
+    maxTurns?: number;
+    maxCost?: number;
+    timeoutMs?: number;
+    outputFormat?: 'text' | 'json' | 'last_message';
+    inheritMessages?: boolean;
+    taskTemplate?: string;
+}
+interface BuiltInTool {
+    id: string;
+    name: string;
+    description: string;
+    category: 'image_generation' | 'web_search' | 'web_scraping' | 'code_execution' | 'file_operations' | 'data_analysis' | 'knowledge_retrieval' | 'text_to_speech' | 'voice_processing' | 'third_party_api' | 'artifact' | 'data_management' | 'commerce' | 'browser';
+    providers: string[];
+    parametersSchema: JSONSchema;
+    defaultConfig?: JsonObject;
+    documentationUrl?: string;
+}
+interface ToolExecution {
+    id: string;
+    toolId: string;
+    flowExecutionId?: string;
+    stepId?: string;
+    userId: string;
+    inputParameters: JsonObject;
+    outputResult: JsonValue;
+    status: 'pending' | 'success' | 'failed';
+    errorMessage?: string;
+    executionTimeMs?: number;
+    createdAt: string;
+}
+interface CreateToolRequest {
+    name: string;
+    description: string;
+    toolType: 'flow' | 'custom' | 'external' | 'subagent';
+    parametersSchema: JSONSchema;
+    config: ToolConfig;
+}
+interface UpdateToolRequest {
+    name?: string;
+    description?: string;
+    parametersSchema?: JSONSchema;
+    config?: ToolConfig;
+    isActive?: boolean;
+}
+interface ExecuteToolRequest {
+    toolId: string;
+    parameters: JsonObject;
+}
+interface ExecuteToolResponse {
+    executionId: string;
+    result: JsonValue;
+    status: 'success' | 'failed';
+    errorMessage?: string;
+    executionTimeMs: number;
 }
-/**
- * Interface for clients that can dispatch flows
- */
-interface DispatchClient {
-    /**
-     * Run a flow with local tools (automatic pause/resume loop)
-     *
-     * @param config - The dispatch request configuration
-     * @param localTools - Map of tool names to async functions that execute the tool logic
-     * @param callbacks - Optional callbacks for streaming events
-     * @returns The final result of the flow execution or summary if streaming
-     */
-    runWithLocalTools(config: DispatchRequest, localTools: Record<string, (args: any) => Promise<any>>, callbacks?: StreamCallbacks): Promise<FlowResult | FlowSummary>;
-    dispatch(config: DispatchRequest): Promise<Response>;
+interface DeploySandboxRequest {
+    code: string;
+    packageJson?: string;
+    language?: 'javascript' | 'typescript' | 'python';
+    port?: number;
+    sandboxId?: string;
+    startCommand?: string;
+    files?: Record<string, string>;
 }
-/**
- * FlowBuilder that is bound to a client for direct execution
- *
- * @example
- * ```typescript
- * // Via RuntypeClient.flow()
- * const result = await runtype
- *   .flow('My Flow')
- *   .fetchUrl({ name: 'Fetch', url: '...', outputVariable: 'data' })
- *   .prompt({ name: 'Process', model: 'gpt-4', userPrompt: '...' })
- *   .run({ streamResponse: true })
- *
- * const data = await result.getResult('Process')
- * ```
- */
-declare class ClientFlowBuilder extends FlowBuilder {
-    private boundClient;
-    constructor(client: DispatchClient, name: string);
-    /**
-     * Build and execute the flow using the bound client
-     *
-     * For ClientFlowBuilder, you can either:
-     * 1. Pass a client (which is ignored, the bound client is used)
-     * 2. Pass options directly as the first argument
-     *
-     * @example
-     * ```typescript
-     * // Simple execution (no args needed)
-     * const result = await builder.run()
-     * const data = await result.getResult('Process')
-     *
-     * // With options only
-     * const result = await builder.run({ streamResponse: true, flowMode: 'virtual' })
-     *
-     * // With options and callbacks
-     * const summary = await builder.run({ streamResponse: true }, {
-     *   onStepDelta: (chunk) => process.stdout.write(chunk),
-     *   onFlowComplete: () => console.log('Done!'),
-     * })
-     *
-     * // Parent class signature (client ignored)
-     * const result = await builder.run(someClient, { streamResponse: true })
-     * ```
-     */
-    run(): Promise<FlowResult>;
-    run(options: DispatchOptions$1): Promise<FlowResult>;
-    run(options: DispatchOptions$1, callbacks: StreamCallbacks): Promise<FlowSummary>;
-    run(localTools: Record<string, (args: any) => Promise<any>>): Promise<FlowResult>;
-    run(options: DispatchOptions$1, localTools: Record<string, (args: any) => Promise<any>>): Promise<FlowResult>;
-    run(localTools: Record<string, (args: any) => Promise<any>>, callbacks: StreamCallbacks): Promise<FlowSummary>;
-    run(options: DispatchOptions$1, localTools: Record<string, (args: any) => Promise<any>>, callbacks: StreamCallbacks): Promise<FlowSummary>;
-    run(client: DispatchClient, options?: DispatchOptions$1): Promise<FlowResult>;
-    run(client: DispatchClient, options: DispatchOptions$1, callbacks: StreamCallbacks): Promise<FlowSummary>;
+interface DeploySandboxResponse {
+    sandboxId: string;
+    previewUrl: string;
+    output: string;
+    status: 'running' | 'error';
+    error?: string;
 }
-/**
- * Create an external runtime tool definition.
- *
- * External tools make HTTP requests to external APIs with support for
- * variable substitution in URLs and headers.
- *
- * Special internal variables are available for auth:
- * - `{{_internal.auth_token}}` - Bearer token for Runtype API auth
- * - `{{_internal.user_id}}` - Current user ID
- * - `{{_internal.org_id}}` - Current organization ID
- *
- * @example
- * ```typescript
- * const listFlowsTool = createExternalTool({
- *   name: 'list_flows',
- *   description: 'List all flows in the workspace',
- *   parametersSchema: {
- *     type: 'object',
- *     properties: {
- *       limit: { type: 'number', description: 'Max results', default: 20 }
- *     }
- *   },
- *   url: 'https://api.runtype.com/v1/flows',
- *   method: 'GET',
- *   headers: { Authorization: '{{_internal.auth_token}}' }
- * })
- * ```
- */
-declare function createExternalTool(config: {
+interface DeployCfSandboxRequest {
+    code: string;
+    packageJson?: string;
+    language?: 'javascript' | 'typescript' | 'python';
+    port?: number;
+    sandboxId?: string;
+    startCommand?: string;
+    files?: Record<string, string>;
+}
+interface DeployCfSandboxResponse {
+    sandboxId: string;
+    previewUrl: string;
+    output: string;
+    status: 'running' | 'error';
+    stage?: 'validate_port' | 'validate_files' | 'write_package_json' | 'npm_install' | 'write_main_file' | 'write_additional_files' | 'start_process' | 'expose_port';
+    error?: string;
+}
+interface ModelUsageQueryParams {
+    startDate?: string;
+    endDate?: string;
+    period?: 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'current_month' | 'last_month' | 'current_year';
+    granularity?: 'hour' | 'day' | 'week' | 'month';
+    modelConfigId?: string;
+}
+interface ModelUsageSummary {
+    totalRequests: number;
+    totalCost: number;
+    totalTokens: number;
+    platformCost?: number;
+    userCost?: number;
+    platformTokens?: number;
+    userTokens?: number;
+}
+interface ModelUsageDetail {
+    modelId: string;
+    modelName?: string;
+    provider: string;
+    requestCount: number;
+    totalCost: number;
+    totalTokens: number;
+    avgCostPerRequest: number;
+}
+interface ModelUsageTimeSeries {
+    date: string;
+    requests: number;
+    cost: number;
+    tokens: number;
+}
+interface ModelUsageResponse {
+    meta: {
+        startDate: string;
+        endDate: string;
+        period?: string;
+        granularity?: string;
+    };
+    summary: ModelUsageSummary;
+    usageByModel: Record<string, ModelUsageDetail>;
+    timeSeries?: ModelUsageTimeSeries[];
+}
+interface RuntimeTool {
     name: string;
     description: string;
-    parametersSchema: any;
+    toolType: 'flow' | 'custom' | 'external' | 'local' | 'subagent';
+    parametersSchema: JSONSchema;
+    config?: RuntimeToolConfig;
+}
+type RuntimeToolConfig = RuntimeFlowToolConfig | RuntimeCustomToolConfig | RuntimeExternalToolConfig | RuntimeLocalToolConfig | RuntimeSubagentToolConfig;
+interface RuntimeLocalToolConfig {
+    [key: string]: JsonValue;
+}
+interface RuntimeFlowToolConfig {
+    flowId?: string;
+    toolId?: string;
+    parameterMapping?: Record<string, string>;
+    outputMapping?: string;
+}
+interface RuntimeCustomToolConfig {
+    code: string;
+    language?: 'javascript' | 'typescript' | 'python';
+    sandboxProvider?: 'quickjs' | 'daytona' | 'cloudflare-worker';
+    timeout?: number;
+}
+interface RuntimeExternalToolConfig {
     url: string;
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
     headers?: Record<string, string>;
     body?: string;
-}): RuntimeTool;
+}
+type RuntimeSubagentToolConfig = SubagentToolConfig;
+interface AgentSubagentConfig {
+    toolPool: string[];
+    defaultMaxTurns?: number;
+    maxTurnsLimit?: number;
+    maxSpawnsPerRun?: number;
+    defaultModel?: string;
+    allowNesting?: boolean;
+    defaultTimeoutMs?: number;
+}
+interface CustomMCPServerAuth {
+    type: 'bearer' | 'api_key' | 'basic' | 'custom_header' | 'oauth2' | 'none';
+    headerName?: string;
+    token?: string;
+    username?: string;
+    password?: string;
+    oauth2?: {
+        accessToken?: string;
+        refreshToken?: string;
+        tokenEndpoint?: string;
+        clientId?: string;
+        clientSecret?: string;
+        expiresAt?: number;
+        scope?: string;
+        issuer?: string;
+    };
+}
+interface CustomMCPServer {
+    id: string;
+    name?: string;
+    url: string;
+    auth?: CustomMCPServerAuth;
+    allowedTools?: string[];
+    timeout?: number;
+    transport?: 'streamable_http' | 'rest';
+    enabled?: boolean;
+}
+interface ToolsConfig {
+    toolIds?: string[];
+    runtimeTools?: RuntimeTool[];
+    subagentConfig?: AgentSubagentConfig;
+    mcpServers?: CustomMCPServer[];
+    maxToolCalls?: number;
+    toolCallStrategy?: 'auto' | 'required' | 'none';
+    parallelCalls?: boolean;
+    toolConfigs?: Record<string, JsonObject>;
+}
+interface ReasoningConfig {
+    enabled: boolean;
+    reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    reasoningSummary?: 'auto' | 'detailed';
+    budgetTokens?: number;
+    thinkingBudget?: number;
+    includeThoughts?: boolean;
+}
+type ReasoningValue = boolean | ReasoningConfig;
 
 /**
  * FlowsNamespace - Static namespace for flow operations
@@ -1933,6 +1936,13 @@ declare class RuntypeFlowBuilder {
      */
     runWithLocalTools(localTools: Record<string, (args: unknown) => Promise<unknown>>, callbacks?: StreamCallbacks): Promise<FlowResult>;
     build(): DispatchRequest;
+    /**
+     * Persisted flow protocol (APQ-style): send hash-only first, retry with
+     * full definition on FLOW_DEFINITION_REQUIRED. For non-upsert modes,
+     * dispatches directly.
+     */
+    private dispatchWithPersistedFlow;
+    private computeContentHash;
     private addStep;
 }
 
@@ -3155,6 +3165,10 @@ declare class FlowsEndpoint {
      * Delete a flow
      */
     delete(id: string): Promise<void>;
+    /**
+     * Export a flow as a self-contained runtime definition for @runtypelabs/runtime
+     */
+    exportRuntime(id: string): Promise<any>;
     /**
      * Run a flow on all records of a specific type
      */
@@ -4534,6 +4548,10 @@ declare class AgentsEndpoint {
      * Delete an agent
      */
     delete(id: string): Promise<void>;
+    /**
+     * Export an agent as a self-contained runtime definition for @runtypelabs/runtime
+     */
+    exportRuntime(id: string): Promise<any>;
     /**
      * Evaluate a model-proposed runtime tool against a configurable allowlist policy.
      * Useful for local `propose_runtime_tool` handlers before follow-up execution.
@@ -5433,4 +5451,4 @@ declare function getLikelySupportingCandidatePaths(bestCandidatePath: string | u
 declare function getDefaultPlanPath(taskName: string): string;
 declare function sanitizeTaskSlug(taskName: string): string;
 
-export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions$1 as UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };
+export { type Agent, type AgentApprovalCompleteEvent, type AgentApprovalStartEvent, type AgentCompleteEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentExecuteRequest, type AgentExecuteResponse, type AgentIterationCompleteEvent, type AgentIterationStartEvent, type AgentMediaEvent, type AgentMessage, type AgentPausedEvent, type AgentPingEvent, type AgentReflectionEvent, type AgentRuntimeToolDefinition, type AgentStartEvent, type AgentStreamCallbacks, type AgentSubagentConfig, type AgentToolCompleteEvent, type AgentToolDeltaEvent, type AgentToolInputCompleteEvent, type AgentToolInputDeltaEvent, type AgentToolStartEvent, type AgentTurnCompleteEvent, type AgentTurnDeltaEvent, type AgentTurnStartEvent, AgentsEndpoint, AnalyticsEndpoint, type ApiClient, type ApiKey, ApiKeysEndpoint, type ApiResponse, type ApplyGeneratedProposalOptions, type ApplyGeneratedProposalResult, type AttachRuntimeToolsOptions, type BaseAgentEvent, BatchBuilder, type BatchClient, type BatchListParams, type BatchOptions, type BatchRequest, type BatchResult, type BatchScheduleConfig, type BatchStatus, BatchesNamespace, type BuiltInTool, type BulkEditCondition, type BulkEditRequest, type BulkEditResponse, type BulkEditResult, ChatEndpoint, ClientBatchBuilder, type ClientConfig, type ClientConversation, ClientEvalBuilder, ClientFlowBuilder, type ClientToken, type ClientTokenConfig, type ClientTokenEnvironment, type ClientTokenVersionPin, ClientTokensEndpoint, type ClientWidgetTheme, type ConditionalStepConfig$1 as ConditionalStepConfig, type ContextErrorHandling, type ContextFallback, ContextTemplatesEndpoint, type CreateApiKeyRequest, type CreateClientTokenRequest, type CreateClientTokenResponse, type CreateFlowRequest, type CreateModelConfigRequest, type CreatePromptData, type CreatePromptRequest, type CreateProviderKeyRequest, type CreateRecordRequest, type CreateToolRequest, type CustomMCPServer, type CustomMCPServerAuth, type CustomToolConfig, type DeployCfSandboxRequest, type DeployCfSandboxResponse, type DeploySandboxRequest, type DeploySandboxResponse, type DispatchClient, DispatchEndpoint, type DispatchEnvironment, type DispatchOptions$1 as DispatchOptions, type DispatchRequest, type ErrorHandlingMode, EvalBuilder, type EvalClient, EvalEndpoint, type EvalListParams, type EvalOptions, type EvalRecord, type EvalRequest, type EvalResult, type EvalRunConfig, EvalRunner, type EvalStatus, EvalsNamespace, type ExecuteToolRequest, type ExecuteToolResponse, type ExternalToolConfig, type FallbackFailEvent, type FallbackStartEvent, type FallbackSuccessEvent, type FallbacksExhaustedEvent, type FallbacksInitiatedEvent, type FetchGitHubStepConfig$1 as FetchGitHubStepConfig, type FetchUrlStepConfig$1 as FetchUrlStepConfig, type FieldFormat, type FileContentPart, type Flow, type FlowAttachment, FlowBuilder, type FlowCompleteEvent, type FlowConfig$1 as FlowConfig, type FlowErrorEvent, type FlowFallback, type FlowPausedEvent, FlowResult, type FlowStartEvent, type FlowStep, FlowStepsEndpoint, type FlowSummary, type FlowToolConfig, FlowsEndpoint, FlowsNamespace, type GenerateEmbeddingStepConfig$1 as GenerateEmbeddingStepConfig, type GeneratedRuntimeToolGateDecision, type GeneratedRuntimeToolGateOptions, type ImageContentPart, type JSONSchema, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListConversationsResponse, type ListParams, type LocalToolConfig, type LocalToolDefinition, type LocalToolExecutionCompleteEvent, type LocalToolExecutionLoopSnapshotSlice, type LocalToolExecutionStartEvent, type Message$1 as Message, type MessageContent, type Metadata, type ModelConfig, ModelConfigsEndpoint, type ModelFallback, type ModelOverride, type ModelUsageDetail, type ModelUsageQueryParams, type ModelUsageResponse, type ModelUsageSummary, type ModelUsageTimeSeries, type PaginationResponse, type Prompt$1 as Prompt, type PromptErrorHandling, type PromptFallback, type PromptListParams, type PromptRunOptions, PromptRunner, type PromptStepConfig$1 as PromptStepConfig, PromptsEndpoint, PromptsNamespace, type ProviderApiKey, type ReasoningConfig, type ReasoningValue, type RecordConfig$1 as RecordConfig, type RecordFilter, type RecordFilterCondition, type RecordFilterGroup, type RecordFilterOperator, type RecordListParams, RecordsEndpoint, type RetrieveRecordStepConfig$1 as RetrieveRecordStepConfig, type RetryFallback, type RunTaskContextBudgetBreakdown, type RunTaskContextCompactionEvent, type RunTaskContextCompactionStrategy, type RunTaskContextNoticeEvent, type RunTaskContinuation, type RunTaskOnContextCompaction, type RunTaskOnContextNotice, type RunTaskOnSession, type RunTaskOptions, type RunTaskResult, type RunTaskResumeState, type RunTaskSessionSummary, type RunTaskState, type RunTaskStateSlice, type RunTaskStatus, type RunTaskToolTraceSlice, type RuntimeCustomToolConfig, type RuntimeExternalToolConfig, type RuntimeFlowToolConfig, type RuntimeLocalToolConfig, type RuntimeSubagentToolConfig, type RuntimeTool, type RuntimeToolConfig, Runtype, RuntypeApiError, RuntypeClient, type ConditionalStepConfig as RuntypeConditionalStepConfig, type RuntypeConfig, type FetchGitHubStepConfig as RuntypeFetchGitHubStepConfig, type FetchUrlStepConfig as RuntypeFetchUrlStepConfig, RuntypeFlowBuilder, type FlowConfig as RuntypeFlowConfig, type GenerateEmbeddingStepConfig as RuntypeGenerateEmbeddingStepConfig, type Message as RuntypeMessage, type ModelOverride$1 as RuntypeModelOverride, type Prompt as RuntypePrompt, type PromptStepConfig as RuntypePromptStepConfig, type RuntypeRecord, type RecordConfig as RuntypeRecordConfig, type RetrieveRecordStepConfig as RuntypeRetrieveRecordStepConfig, type SearchStepConfig as RuntypeSearchStepConfig, type SendEmailStepConfig as RuntypeSendEmailStepConfig, type SendEventStepConfig as RuntypeSendEventStepConfig, type SendStreamStepConfig as RuntypeSendStreamStepConfig, type SendTextStepConfig as RuntypeSendTextStepConfig, type SetVariableStepConfig as RuntypeSetVariableStepConfig, type TransformDataStepConfig as RuntypeTransformDataStepConfig, type UpsertFlowConfig as RuntypeUpsertFlowConfig, type UpsertRecordStepConfig as RuntypeUpsertRecordStepConfig, type VectorSearchStepConfig as RuntypeVectorSearchStepConfig, type WaitUntilStepConfig as RuntypeWaitUntilStepConfig, STEP_FIELD_REGISTRY, STEP_TYPE_TO_METHOD, type SearchStepConfig$1 as SearchStepConfig, type SendEmailStepConfig$1 as SendEmailStepConfig, type SendEventStepConfig$1 as SendEventStepConfig, type SendStreamStepConfig$1 as SendStreamStepConfig, type SendTextStepConfig$1 as SendTextStepConfig, type SetVariableStepConfig$1 as SetVariableStepConfig, type StepCompleteEvent, type StepDeltaEvent, type StepFallback, type StepFieldMeta, type StepStartEvent, type StepWaitingLocalEvent, type StreamCallbacks, type StreamEvent, type SubagentToolConfig, type TextContentPart, type Tool, type ToolConfig, type ToolExecution, type ToolsConfig, ToolsEndpoint, type TransformDataStepConfig$1 as TransformDataStepConfig, type UpdateClientTokenRequest, type UpdatePromptData, type UpdateProviderKeyRequest, type UpdateToolRequest, type UpsertFlowConfig$1 as UpsertFlowConfig, type UpsertOptions, type UpsertRecordStepConfig$1 as UpsertRecordStepConfig, type UserProfile, UsersEndpoint, type VectorSearchStepConfig$1 as VectorSearchStepConfig, type WaitUntilStepConfig$1 as WaitUntilStepConfig, type WorkflowContext, type WorkflowDefinition, type WorkflowPhase, applyGeneratedRuntimeToolProposalToDispatchRequest, attachRuntimeToolsToDispatchRequest, buildGeneratedRuntimeToolGateOutput, createClient, createExternalTool, defaultWorkflow, deployWorkflow, evaluateGeneratedRuntimeToolProposal, gameWorkflow, getDefaultPlanPath, getLikelySupportingCandidatePaths, isDiscoveryToolName, isMarathonArtifactPath, isPreservationSensitiveTask, normalizeCandidatePath, parseFinalBuffer, parseSSEChunk, processStream, sanitizeTaskSlug, streamEvents };