ai-workflows 2.1.3 → 2.3.0

package/dist/worker/topological-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topological-executor.js","sourceRoot":"","sources":["../../src/worker/topological-executor.ts"],"names":[],"mappings":"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"}

package/dist/worker/workflow-builder.d.ts

@@ -0,0 +1,286 @@
+/**
+ * WorkflowBuilder DSL - Declarative workflow definition with fluent API
+ *
+ * Provides a builder pattern for creating durable workflows with:
+ * - Step definitions with dependencies
+ * - Event triggers
+ * - Scheduled execution
+ * - Type-safe execution context
+ *
+ * ## Features
+ *
+ * - **Fluent API**: Chain methods for intuitive workflow definition
+ * - **Step Dependencies**: Declare execution order with `.dependsOn()`
+ * - **Event Triggers**: React to domain events with `.on('Noun.event')`
+ * - **Schedule Triggers**: Run on intervals with `.every()`
+ * - **Error Handling**: Per-step error handlers with `.onError()`
+ * - **Parallel Execution**: Steps without dependencies run concurrently
+ * - **Cycle Detection**: Automatically detects circular dependencies
+ *
+ * ## Basic Usage
+ *
+ * @example
+ * ```typescript
+ * import { WorkflowBuilder } from 'ai-workflows/worker'
+ *
+ * const workflow = WorkflowBuilder.create('order-process')
+ *   .step('validate', async (input) => {
+ *     return { valid: true }
+ *   })
+ *   .step('charge', async (input, ctx) => {
+ *     const validation = ctx.getStepResult<{ valid: boolean }>('validate')
+ *     if (!validation.valid) throw new Error('Invalid order')
+ *     return { charged: true }
+ *   }).dependsOn('validate')
+ *   .step('fulfill', fulfillOrder).dependsOn('charge')
+ *   .on('Order.placed').do('validate')
+ *   .build()
+ *
+ * // Execute the workflow
+ * const results = await workflow.execute({ orderId: 'order-123' })
+ * ```
+ *
+ * ## With DurableStep
+ *
+ * @example
+ * ```typescript
+ * import { WorkflowBuilder, DurableStep } from 'ai-workflows/worker'
+ *
+ * const fetchData = new DurableStep('fetch-data', async ({ url }) => {
+ *   return fetch(url).then(r => r.json())
+ * })
+ *
+ * const workflow = WorkflowBuilder.create('data-pipeline')
+ *   .step(fetchData)
+ *   .step('process', processData).dependsOn('fetch-data')
+ *   .build()
+ * ```
+ *
+ * ## Scheduled Workflows
+ *
+ * @example
+ * ```typescript
+ * const workflow = WorkflowBuilder.create('daily-report')
+ *   .step('generate', generateReport)
+ *   .step('send', sendReport).dependsOn('generate')
+ *   .every('day').at('9am').do('generate')
+ *   .build()
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { DurableStep, type StepConfig, type RetryConfig } from './durable-step.js';
+/**
+ * Configuration for WorkflowBuilder
+ */
+export interface WorkflowBuilderConfig {
+    /** Human-readable description of the workflow */
+    description?: string;
+    /** Version string (semver recommended) */
+    version?: string;
+    /** Default timeout for all steps */
+    timeout?: string | number;
+    /** Default retry configuration for all steps */
+    retries?: RetryConfig;
+}
+/**
+ * Step definition stored in the builder
+ */
+export interface StepDefinition<TInput = unknown, TOutput = unknown> {
+    /** Unique step name */
+    name: string;
+    /** The step function */
+    fn: (input: TInput, ctx: ExecutionContext) => Promise<TOutput>;
+    /** Step configuration (retries, timeout) */
+    config?: StepConfig;
+    /** Dependencies (step names this step depends on) */
+    dependencies: Array<{
+        name: string;
+        options?: DependencyOptions;
+    }>;
+    /** Error handler */
+    errorHandler?: (error: Error, ctx: ExecutionContext) => unknown | Promise<unknown>;
+    /** DurableStep wrapper */
+    durableStep?: DurableStep<TInput, TOutput>;
+}
+/**
+ * Options for dependency declarations
+ */
+export interface DependencyOptions {
+    /** Dependency type: 'hard' (default) or 'soft' (can proceed on failure) */
+    type?: 'hard' | 'soft';
+    /** Timeout for waiting on dependency */
+    timeout?: string | number;
+}
+/**
+ * Event trigger configuration
+ */
+export interface TriggerConfig {
+    /** Event name (Noun.event format) */
+    event: string;
+    /** Step name to trigger (or inline function was converted to implicit step) */
+    stepName: string;
+    /** Filter function */
+    filter?: (event: unknown) => boolean;
+}
+/**
+ * Schedule trigger configuration
+ */
+export interface ScheduleConfig {
+    /** Schedule expression (interval, cron, or natural language) */
+    schedule: string;
+    /** Numeric value for interval (e.g., 5 for every(5).minutes()) */
+    value?: number;
+    /** Time of day (e.g., '9am') */
+    time?: string;
+    /** Timezone (e.g., 'America/New_York') */
+    timezone?: string;
+    /** Step name to execute */
+    stepName: string;
+}
+/**
+ * Built workflow definition (immutable)
+ */
+export interface BuiltWorkflow<TInput = unknown, TResults = Record<string, unknown>> {
+    /** Workflow name */
+    readonly name: string;
+    /** All registered steps */
+    readonly steps: ReadonlyArray<StepDefinition>;
+    /** Workflow triggers */
+    readonly triggers: {
+        readonly events: ReadonlyArray<TriggerConfig>;
+        readonly schedules: ReadonlyArray<ScheduleConfig>;
+    };
+    /** Dependency graph (step -> dependencies) */
+    readonly dependencyGraph: Map<string, string[]>;
+    /** Topologically sorted execution order */
+    readonly executionOrder: string[];
+    /** Workflow metadata */
+    readonly metadata?: WorkflowBuilderConfig;
+    /** Whether compatible with Cloudflare Workflows */
+    readonly isCloudflareCompatible: boolean;
+    /** Execute the workflow */
+    execute: (input?: TInput) => Promise<TResults>;
+}
+/**
+ * Execution context passed to step functions
+ */
+export interface ExecutionContext {
+    /** Get result of a previously executed step */
+    getStepResult: <T = unknown>(stepName: string) => T;
+    /** Current workflow input */
+    readonly input: unknown;
+    /** All step results so far */
+    readonly results: Record<string, unknown>;
+}
+/**
+ * Step chain for configuring a step after adding it
+ */
+export interface StepChain {
+    /** Declare dependencies for this step */
+    dependsOn(step: string, options?: DependencyOptions): StepChain;
+    dependsOn(steps: string[]): StepChain;
+    /** Set timeout for this step */
+    timeout(duration: string | number): StepChain;
+    /** Set retry configuration */
+    retries(config: RetryConfig): StepChain;
+    /** Set error handler */
+    onError(handler: (error: Error, ctx: ExecutionContext) => unknown | Promise<unknown>): StepChain;
+    /** Add another step (returns to builder) */
+    step<TI = unknown, TO = unknown>(name: string, fn: (input: TI, ctx: ExecutionContext) => Promise<TO>): StepChain;
+    step<TI = unknown, TO = unknown>(name: string, config: StepConfig, fn: (input: TI, ctx: ExecutionContext) => Promise<TO>): StepChain;
+    step<TI = unknown, TO = unknown>(durableStep: DurableStep<TI, TO>): StepChain;
+    /** Register event trigger */
+    on<T = unknown>(event: string): EventTriggerChain<T>;
+    /** Register schedule trigger */
+    every(schedule: string): ScheduleTriggerChain;
+    every(value: number): NumericScheduleChain;
+    /** Build the workflow */
+    build(): BuiltWorkflow;
+}
+/**
+ * Event trigger chain for configuring event-triggered steps
+ */
+export interface EventTriggerChain<T = unknown> {
+    /** Add a filter function */
+    filter(predicate: (event: T) => boolean): EventTriggerChain<T>;
+    /** Execute a step when event fires */
+    do(stepName: string): StepChain;
+    do(fn: (event: T) => Promise<unknown>): StepChain;
+}
+/**
+ * Schedule trigger chain for configuring scheduled steps
+ */
+export interface ScheduleTriggerChain {
+    /** Set time of day */
+    at(time: string): ScheduleTriggerChain;
+    /** Set timezone */
+    timezone(tz: string): ScheduleTriggerChain;
+    /** Execute a step on schedule */
+    do(stepName: string): StepChain;
+    do(fn: () => Promise<unknown>): StepChain;
+}
+/**
+ * Numeric schedule chain (for every(5).minutes() pattern)
+ */
+export interface NumericScheduleChain {
+    minutes(): ScheduleTriggerChain;
+    hours(): ScheduleTriggerChain;
+    days(): ScheduleTriggerChain;
+    seconds(): ScheduleTriggerChain;
+}
+/**
+ * WorkflowBuilder - Static factory for creating workflow definitions
+ *
+ * @example
+ * ```ts
+ * const workflow = WorkflowBuilder.create('order-process')
+ *   .step('validate', validateOrder)
+ *   .step('charge', chargePayment).dependsOn('validate')
+ *   .on('Order.placed').do('validate')
+ *   .build()
+ * ```
+ */
+export declare class WorkflowBuilder {
+    /** Workflow name */
+    readonly name: string;
+    /** Workflow configuration */
+    readonly config?: WorkflowBuilderConfig;
+    private impl;
+    private constructor();
+    /**
+     * Create a new workflow builder
+     *
+     * @param name - Unique workflow name
+     * @param config - Optional workflow configuration
+     * @returns WorkflowBuilder instance
+     */
+    static create(name: string, config?: WorkflowBuilderConfig): WorkflowBuilder;
+    /**
+     * Add a step to the workflow
+     */
+    step<TI = unknown, TO = unknown>(name: string, fn: (input: TI, ctx: ExecutionContext) => Promise<TO>): StepChain;
+    step<TI = unknown, TO = unknown>(name: string, config: StepConfig, fn: (input: TI, ctx: ExecutionContext) => Promise<TO>): StepChain;
+    step<TI = unknown, TO = unknown>(durableStep: DurableStep<TI, TO>): StepChain;
+    /**
+     * Register an event trigger
+     */
+    on<T = unknown>(event: string): EventTriggerChain<T>;
+    /**
+     * Register a schedule trigger
+     */
+    every(schedule: string): ScheduleTriggerChain;
+    every(value: number): NumericScheduleChain;
+    /**
+     * Declare dependencies for the most recently added step
+     * This allows for: builder.step('a', fn).step('b', fn).dependsOn('a')
+     */
+    dependsOn(step: string, options?: DependencyOptions): WorkflowBuilder;
+    dependsOn(steps: string[]): WorkflowBuilder;
+    /**
+     * Build the workflow definition
+     */
+    build(): BuiltWorkflow;
+}
+export { DurableStep, type StepConfig, type RetryConfig };
+//# sourceMappingURL=workflow-builder.d.ts.map

package/dist/worker/workflow-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-builder.d.ts","sourceRoot":"","sources":["../../src/worker/workflow-builder.ts"],"names":[],"mappings":"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"}