@runtypelabs/sdk 1.18.0 → 1.19.0

package/dist/index.cjs

@@ -7578,6 +7578,24 @@ var FlowBuilder = class {
     }
     return new FlowResult(response);
   }
+  /**
+   * 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) {
+    const lastStep = this.steps[this.steps.length - 1];
+    if (lastStep) lastStep.when = expression;
+    return this;
+  }
   // ============================================================================
   // Private Helpers
   // ============================================================================

package/dist/index.d.cts

@@ -376,7 +376,8 @@ interface Tool {
 }
 type ToolConfig = FlowToolConfig | CustomToolConfig | ExternalToolConfig | LocalToolConfig | SubagentToolConfig;
 interface FlowToolConfig {
-    flowId: string;
+    flowId?: string;
+    toolId?: string;
     parameterMapping: Record<string, string>;
     outputMapping?: string;
 }
@@ -596,7 +597,8 @@ interface RuntimeLocalToolConfig {
     [key: string]: JsonValue;
 }
 interface RuntimeFlowToolConfig {
-    flowId: string;
+    flowId?: string;
+    toolId?: string;
     parameterMapping?: Record<string, string>;
     outputMapping?: string;
 }
@@ -958,6 +960,8 @@ interface PromptStepConfig$1 {
     /** 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;
@@ -977,6 +981,8 @@ interface FetchUrlStepConfig$1 {
     errorHandling?: ErrorHandlingMode | ContextErrorHandling;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface CrawlStepConfig {
     name: string;
@@ -1004,6 +1010,8 @@ interface CrawlStepConfig {
     pollIntervalMs?: number;
     completionTimeoutMs?: number;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface TransformDataStepConfig$1 {
     name: string;
@@ -1012,12 +1020,16 @@ interface TransformDataStepConfig$1 {
     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;
@@ -1025,6 +1037,8 @@ interface ConditionalStepConfig$1 {
     trueSteps?: any[];
     falseSteps?: any[];
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface SearchStepConfig$1 {
     name: string;
@@ -1037,6 +1051,8 @@ interface SearchStepConfig$1 {
     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;
@@ -1049,11 +1065,15 @@ interface SendEmailStepConfig$1 {
     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;
 }
 interface RetrieveRecordStepConfig$1 {
     name: string;
@@ -1064,6 +1084,8 @@ interface RetrieveRecordStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface UpsertRecordStepConfig$1 {
     name: string;
@@ -1076,6 +1098,8 @@ interface UpsertRecordStepConfig$1 {
     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;
@@ -1087,6 +1111,8 @@ interface VectorSearchStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface GenerateEmbeddingStepConfig$1 {
     name: string;
@@ -1096,6 +1122,8 @@ interface GenerateEmbeddingStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface WaitUntilStepConfig$1 {
     name: string;
@@ -1112,6 +1140,8 @@ interface WaitUntilStepConfig$1 {
     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;
@@ -1123,6 +1153,8 @@ interface SendEventStepConfig$1 {
     errorHandling?: ErrorHandlingMode | ContextErrorHandling;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface SendTextStepConfig$1 {
     name: string;
@@ -1134,6 +1166,8 @@ interface SendTextStepConfig$1 {
     errorHandling?: ErrorHandlingMode | ContextErrorHandling;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface FetchGitHubStepConfig$1 {
     name: string;
@@ -1143,6 +1177,8 @@ interface FetchGitHubStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface FlowConfig$1 {
     name: string;
@@ -1598,6 +1634,20 @@ declare class FlowBuilder {
      * ```
      */
     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;
 }
 /**

package/dist/index.d.ts

@@ -376,7 +376,8 @@ interface Tool {
 }
 type ToolConfig = FlowToolConfig | CustomToolConfig | ExternalToolConfig | LocalToolConfig | SubagentToolConfig;
 interface FlowToolConfig {
-    flowId: string;
+    flowId?: string;
+    toolId?: string;
     parameterMapping: Record<string, string>;
     outputMapping?: string;
 }
@@ -596,7 +597,8 @@ interface RuntimeLocalToolConfig {
     [key: string]: JsonValue;
 }
 interface RuntimeFlowToolConfig {
-    flowId: string;
+    flowId?: string;
+    toolId?: string;
     parameterMapping?: Record<string, string>;
     outputMapping?: string;
 }
@@ -958,6 +960,8 @@ interface PromptStepConfig$1 {
     /** 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;
@@ -977,6 +981,8 @@ interface FetchUrlStepConfig$1 {
     errorHandling?: ErrorHandlingMode | ContextErrorHandling;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface CrawlStepConfig {
     name: string;
@@ -1004,6 +1010,8 @@ interface CrawlStepConfig {
     pollIntervalMs?: number;
     completionTimeoutMs?: number;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface TransformDataStepConfig$1 {
     name: string;
@@ -1012,12 +1020,16 @@ interface TransformDataStepConfig$1 {
     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;
@@ -1025,6 +1037,8 @@ interface ConditionalStepConfig$1 {
     trueSteps?: any[];
     falseSteps?: any[];
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface SearchStepConfig$1 {
     name: string;
@@ -1037,6 +1051,8 @@ interface SearchStepConfig$1 {
     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;
@@ -1049,11 +1065,15 @@ interface SendEmailStepConfig$1 {
     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;
 }
 interface RetrieveRecordStepConfig$1 {
     name: string;
@@ -1064,6 +1084,8 @@ interface RetrieveRecordStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface UpsertRecordStepConfig$1 {
     name: string;
@@ -1076,6 +1098,8 @@ interface UpsertRecordStepConfig$1 {
     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;
@@ -1087,6 +1111,8 @@ interface VectorSearchStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface GenerateEmbeddingStepConfig$1 {
     name: string;
@@ -1096,6 +1122,8 @@ interface GenerateEmbeddingStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface WaitUntilStepConfig$1 {
     name: string;
@@ -1112,6 +1140,8 @@ interface WaitUntilStepConfig$1 {
     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;
@@ -1123,6 +1153,8 @@ interface SendEventStepConfig$1 {
     errorHandling?: ErrorHandlingMode | ContextErrorHandling;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface SendTextStepConfig$1 {
     name: string;
@@ -1134,6 +1166,8 @@ interface SendTextStepConfig$1 {
     errorHandling?: ErrorHandlingMode | ContextErrorHandling;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface FetchGitHubStepConfig$1 {
     name: string;
@@ -1143,6 +1177,8 @@ interface FetchGitHubStepConfig$1 {
     outputVariable?: string;
     streamOutput?: boolean;
     enabled?: boolean;
+    /** JavaScript predicate evaluated at runtime. If falsy, the step is skipped. */
+    when?: string;
 }
 interface FlowConfig$1 {
     name: string;
@@ -1598,6 +1634,20 @@ declare class FlowBuilder {
      * ```
      */
     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;
 }
 /**

package/dist/index.mjs

@@ -7508,6 +7508,24 @@ var FlowBuilder = class {
     }
     return new FlowResult(response);
   }
+  /**
+   * 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) {
+    const lastStep = this.steps[this.steps.length - 1];
+    if (lastStep) lastStep.when = expression;
+    return this;
+  }
   // ============================================================================
   // Private Helpers
   // ============================================================================

package/package.json

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