monomind 1.11.13 → 1.11.14

package/packages/@monomind/cli/dist/src/workflow/dag-executor.js

@@ -0,0 +1,116 @@
+import { buildDAG, detectCycles, topologicalSort } from './dag-builder.js';
+import { resolveContext } from './context-resolver.js';
+import { getMonitor } from '../production/monitoring.js';
+function classifyError(err) {
+    const msg = err.message.toLowerCase();
+    if (msg.includes('rate limit') || msg.includes('429') || msg.includes('too many requests'))
+        return 'RATE_LIMIT';
+    if (msg.includes('timed out') || msg.includes('timeout'))
+        return 'TIMEOUT';
+    if (msg.includes('validation') || msg.includes('invalid') || msg.includes('schema'))
+        return 'VALIDATION';
+    return 'UNKNOWN';
+}
+export class DAGExecutor {
+    runner;
+    constructor(runner) {
+        this.runner = runner;
+    }
+    async execute(tasks) {
+        const dag = buildDAG(tasks);
+        const cycles = detectCycles(dag);
+        if (cycles.length > 0) {
+            throw new Error(`Cycle detected in task DAG: ${cycles[0].join(' → ')}`);
+        }
+        const levels = topologicalSort(dag);
+        const results = new Map();
+        for (const level of levels) {
+            const levelResults = await Promise.all(level.map(async (task) => {
+                const context = resolveContext(task, results);
+                const timeoutMs = task.timeoutMs ?? 300_000;
+                let timeoutHandle;
+                const timeoutPromise = new Promise((_, reject) => {
+                    timeoutHandle = setTimeout(() => reject(new Error(`Task "${task.id}" timed out after ${timeoutMs}ms`)), timeoutMs);
+                });
+                const result = await Promise.race([
+                    this.runWithRetry(task, context),
+                    timeoutPromise,
+                ]).finally(() => {
+                    if (timeoutHandle)
+                        clearTimeout(timeoutHandle);
+                }).catch((err) => {
+                    const isTimeout = String(err).includes('timed out');
+                    if (isTimeout) {
+                        // Visible in monomind control — leaked task still running in background
+                        getMonitor().counter('dag.task.timeout_leak', 1, {
+                            taskId: task.id,
+                            agentSlug: task.agentSlug,
+                        });
+                    }
+                    return {
+                        taskId: task.id,
+                        agentSlug: task.agentSlug,
+                        output: null,
+                        outputRaw: '',
+                        latencyMs: 0,
+                        retryCount: 0,
+                        completedAt: Date.now(),
+                        status: isTimeout ? 'timeout' : 'error',
+                        error: String(err),
+                    };
+                });
+                return result;
+            }));
+            for (const result of levelResults) {
+                results.set(result.taskId, result);
+            }
+        }
+        return results;
+    }
+    async runWithRetry(task, context) {
+        const policy = task.retryPolicy ?? {
+            maxAttempts: 1,
+            initialDelayMs: 0,
+            backoffMultiplier: 1,
+            jitterMs: 0,
+            retryOn: [],
+        };
+        let lastError;
+        let actualAttempts = 0;
+        for (let attempt = 0; attempt < policy.maxAttempts; attempt++) {
+            actualAttempts = attempt + 1;
+            try {
+                return await this.runner(task, context);
+            }
+            catch (err) {
+                lastError = err;
+                // If retryOn is non-empty, check whether this error category matches.
+                // Unmatched errors consume the attempt but do not get retried further.
+                if (policy.retryOn.length > 0) {
+                    const category = classifyError(lastError);
+                    if (!policy.retryOn.includes(category)) {
+                        break;
+                    }
+                }
+                if (attempt < policy.maxAttempts - 1) {
+                    const delay = policy.initialDelayMs *
+                        Math.pow(policy.backoffMultiplier, attempt) +
+                        Math.random() * policy.jitterMs;
+                    await new Promise((r) => setTimeout(r, delay));
+                }
+            }
+        }
+        return {
+            taskId: task.id,
+            agentSlug: task.agentSlug,
+            output: null,
+            outputRaw: '',
+            latencyMs: 0,
+            retryCount: actualAttempts,
+            completedAt: Date.now(),
+            status: 'error',
+            error: lastError?.message ?? 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=dag-executor.js.map

package/packages/@monomind/cli/dist/src/workflow/dag-types.d.ts

@@ -0,0 +1,41 @@
+export interface RetryPolicy {
+    maxAttempts: number;
+    initialDelayMs: number;
+    backoffMultiplier: number;
+    jitterMs: number;
+    retryOn: Array<'RATE_LIMIT' | 'TIMEOUT' | 'VALIDATION' | 'UNKNOWN'>;
+}
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+export interface DAGTask {
+    id: string;
+    description: string;
+    agentSlug: string;
+    contextDeps?: string[];
+    outputSchema?: string;
+    timeoutMs?: number;
+    retryPolicy?: RetryPolicy;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    config?: Record<string, unknown>;
+}
+export interface TaskResult {
+    taskId: string;
+    agentSlug: string;
+    output: unknown;
+    outputRaw: string;
+    tokenUsage?: {
+        input: number;
+        output: number;
+    };
+    latencyMs: number;
+    retryCount: number;
+    completedAt: number;
+    status: 'success' | 'error' | 'timeout';
+    error?: string;
+}
+export type DAGLevel = DAGTask[];
+export interface DAG {
+    tasks: Map<string, DAGTask>;
+    edges: Map<string, Set<string>>;
+    reverseEdges: Map<string, Set<string>>;
+}
+//# sourceMappingURL=dag-types.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/dag-types.js

@@ -0,0 +1,8 @@
+export const DEFAULT_RETRY_POLICY = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    backoffMultiplier: 2.0,
+    jitterMs: 500,
+    retryOn: ['RATE_LIMIT', 'TIMEOUT'],
+};
+//# sourceMappingURL=dag-types.js.map

package/packages/@monomind/cli/dist/src/workflow/dsl-parser.d.ts

@@ -0,0 +1,12 @@
+import { type WorkflowDefinition } from './dsl-schema.js';
+export declare class DSLParser {
+    /**
+     * Load and validate a workflow definition from a YAML or JSON file.
+     */
+    static loadFromFile(filePath: string): WorkflowDefinition;
+    /**
+     * Validate an unknown object against the workflow definition schema.
+     */
+    static loadFromObject(raw: unknown): WorkflowDefinition;
+}
+//# sourceMappingURL=dsl-parser.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/dsl-parser.js

@@ -0,0 +1,20 @@
+import { readFileSync } from 'node:fs';
+import YAML from 'yaml';
+import { workflowDefinitionSchema, } from './dsl-schema.js';
+export class DSLParser {
+    /**
+     * Load and validate a workflow definition from a YAML or JSON file.
+     */
+    static loadFromFile(filePath) {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = filePath.endsWith('.json') ? JSON.parse(raw) : YAML.parse(raw);
+        return DSLParser.loadFromObject(parsed);
+    }
+    /**
+     * Validate an unknown object against the workflow definition schema.
+     */
+    static loadFromObject(raw) {
+        return workflowDefinitionSchema.parse(raw);
+    }
+}
+//# sourceMappingURL=dsl-parser.js.map

package/packages/@monomind/cli/dist/src/workflow/dsl-schema.d.ts

@@ -0,0 +1,165 @@
+import { z } from 'zod';
+export declare const agentStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"agent">;
+    agent: z.ZodString;
+    task: z.ZodString;
+    context_deps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    output_key: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    retry_policy: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        initialDelayMs: z.ZodOptional<z.ZodNumber>;
+        backoffMultiplier: z.ZodOptional<z.ZodNumber>;
+        jitterMs: z.ZodOptional<z.ZodNumber>;
+        retryOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
+            RATE_LIMIT: "RATE_LIMIT";
+            TIMEOUT: "TIMEOUT";
+            VALIDATION: "VALIDATION";
+        }>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const parallelStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"parallel">;
+    steps: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const sequenceStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"sequence">;
+    steps: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const conditionalStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"conditional">;
+    condition: z.ZodString;
+    if_true: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    if_false: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const mapReduceStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"map_reduce">;
+    items: z.ZodString;
+    map_agent: z.ZodString;
+    map_task: z.ZodString;
+    reduce_agent: z.ZodString;
+    reduce_task: z.ZodString;
+    concurrent: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const loopStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"loop">;
+    condition: z.ZodString;
+    max_iterations: z.ZodNumber;
+    body: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>;
+export declare const workflowStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"agent">;
+    agent: z.ZodString;
+    task: z.ZodString;
+    context_deps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    output_key: z.ZodOptional<z.ZodString>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    retry_policy: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        initialDelayMs: z.ZodOptional<z.ZodNumber>;
+        backoffMultiplier: z.ZodOptional<z.ZodNumber>;
+        jitterMs: z.ZodOptional<z.ZodNumber>;
+        retryOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            UNKNOWN: "UNKNOWN";
+            RATE_LIMIT: "RATE_LIMIT";
+            TIMEOUT: "TIMEOUT";
+            VALIDATION: "VALIDATION";
+        }>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"parallel">;
+    steps: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"sequence">;
+    steps: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"conditional">;
+    condition: z.ZodString;
+    if_true: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    if_false: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"map_reduce">;
+    items: z.ZodString;
+    map_agent: z.ZodString;
+    map_task: z.ZodString;
+    reduce_agent: z.ZodString;
+    reduce_task: z.ZodString;
+    concurrent: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"loop">;
+    condition: z.ZodString;
+    max_iterations: z.ZodNumber;
+    body: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+}, z.core.$strip>], "type">;
+export type WorkflowStep = z.infer<typeof workflowStepSchema>;
+export declare const workflowDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"agent">;
+        agent: z.ZodString;
+        task: z.ZodString;
+        context_deps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        output_key: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        retry_policy: z.ZodOptional<z.ZodObject<{
+            maxAttempts: z.ZodOptional<z.ZodNumber>;
+            initialDelayMs: z.ZodOptional<z.ZodNumber>;
+            backoffMultiplier: z.ZodOptional<z.ZodNumber>;
+            jitterMs: z.ZodOptional<z.ZodNumber>;
+            retryOn: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                UNKNOWN: "UNKNOWN";
+                RATE_LIMIT: "RATE_LIMIT";
+                TIMEOUT: "TIMEOUT";
+                VALIDATION: "VALIDATION";
+            }>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"parallel">;
+        steps: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"sequence">;
+        steps: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"conditional">;
+        condition: z.ZodString;
+        if_true: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        if_false: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"map_reduce">;
+        items: z.ZodString;
+        map_agent: z.ZodString;
+        map_task: z.ZodString;
+        reduce_agent: z.ZodString;
+        reduce_task: z.ZodString;
+        concurrent: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"loop">;
+        condition: z.ZodString;
+        max_iterations: z.ZodNumber;
+        body: z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export type WorkflowDefinition = z.infer<typeof workflowDefinitionSchema>;
+//# sourceMappingURL=dsl-schema.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/dsl-schema.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+// ---------- Retry policy (reuse shape from dag-types) ----------
+const retryPolicySchema = z.object({
+    maxAttempts: z.number().int().min(1).max(10).optional(),
+    initialDelayMs: z.number().int().min(0).optional(),
+    backoffMultiplier: z.number().min(1).optional(),
+    jitterMs: z.number().int().min(0).optional(),
+    retryOn: z
+        .array(z.enum(['RATE_LIMIT', 'TIMEOUT', 'VALIDATION', 'UNKNOWN']))
+        .optional(),
+});
+// ---------- Lazy wrapper for recursive step references ----------
+// Use ZodTypeAny to avoid circular type reference (WorkflowStep is defined below)
+const lazyStep = z.lazy(() => workflowStepSchema);
+// ---------- 6 step-type schemas ----------
+export const agentStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('agent'),
+    agent: z.string().min(1),
+    task: z.string().min(1),
+    context_deps: z.array(z.string()).optional(),
+    output_key: z.string().optional(),
+    timeout_ms: z.number().int().positive().optional(),
+    retry_policy: retryPolicySchema.optional(),
+});
+export const parallelStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('parallel'),
+    steps: z.array(lazyStep).min(2).max(50),
+});
+export const sequenceStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('sequence'),
+    steps: z.array(lazyStep).min(1),
+});
+export const conditionalStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('conditional'),
+    condition: z.string().min(1),
+    if_true: lazyStep,
+    if_false: lazyStep.optional(),
+});
+export const mapReduceStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('map_reduce'),
+    items: z.string().min(1),
+    map_agent: z.string().min(1),
+    map_task: z.string().min(1),
+    reduce_agent: z.string().min(1),
+    reduce_task: z.string().min(1),
+    concurrent: z.number().int().min(1).max(500).optional(),
+});
+export const loopStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('loop'),
+    condition: z.string().min(1),
+    max_iterations: z.number().int().min(1).max(100),
+    body: z.array(lazyStep).min(1),
+});
+// ---------- Discriminated union of all step types ----------
+export const workflowStepSchema = z.discriminatedUnion('type', [
+    agentStepSchema,
+    parallelStepSchema,
+    sequenceStepSchema,
+    conditionalStepSchema,
+    mapReduceStepSchema,
+    loopStepSchema,
+]);
+// ---------- Semver regex ----------
+const semverRegex = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
+// ---------- Top-level workflow definition ----------
+export const workflowDefinitionSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().regex(semverRegex, 'version must be valid semver (e.g. 1.0.0)'),
+    description: z.string().optional(),
+    variables: z.record(z.string(), z.unknown()).optional(),
+    steps: z.array(workflowStepSchema).min(1),
+}).refine((def) => {
+    const ids = def.steps.map((s) => s.id);
+    return ids.length === new Set(ids).size;
+}, { message: 'Workflow step IDs must be unique', path: ['steps'] });
+//# sourceMappingURL=dsl-schema.js.map

package/packages/@monomind/cli/dist/src/workflow/index.d.ts

@@ -0,0 +1,13 @@
+export { buildDAG, detectCycles, topologicalSort } from './dag-builder.js';
+export { DAGExecutor, type TaskRunner } from './dag-executor.js';
+export { resolveContext, ContextResolutionError } from './context-resolver.js';
+export type { DAGTask, TaskResult, DAGLevel, DAG, RetryPolicy, } from './dag-types.js';
+export { DEFAULT_RETRY_POLICY } from './dag-types.js';
+export { workflowStepSchema, workflowDefinitionSchema, agentStepSchema, parallelStepSchema, sequenceStepSchema, conditionalStepSchema, mapReduceStepSchema, loopStepSchema, } from './dsl-schema.js';
+export type { WorkflowStep, WorkflowDefinition } from './dsl-schema.js';
+export { DSLParser } from './dsl-parser.js';
+export { substitute } from './template-engine.js';
+export { evaluateCondition } from './condition-evaluator.js';
+export { WorkflowExecutor } from './workflow-executor.js';
+export type { AgentDispatcher, StepResult, WorkflowResult, } from './workflow-executor.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/index.js

@@ -0,0 +1,11 @@
+export { buildDAG, detectCycles, topologicalSort } from './dag-builder.js';
+export { DAGExecutor } from './dag-executor.js';
+export { resolveContext, ContextResolutionError } from './context-resolver.js';
+export { DEFAULT_RETRY_POLICY } from './dag-types.js';
+// DSL workflow modules
+export { workflowStepSchema, workflowDefinitionSchema, agentStepSchema, parallelStepSchema, sequenceStepSchema, conditionalStepSchema, mapReduceStepSchema, loopStepSchema, } from './dsl-schema.js';
+export { DSLParser } from './dsl-parser.js';
+export { substitute } from './template-engine.js';
+export { evaluateCondition } from './condition-evaluator.js';
+export { WorkflowExecutor } from './workflow-executor.js';
+//# sourceMappingURL=index.js.map

package/packages/@monomind/cli/dist/src/workflow/template-engine.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Substitute {{variable}} and {{step-id.field}} placeholders in a template
+ * string using values from a context object.
+ *
+ * - `{{variable}}` resolves to `context[variable]`
+ * - `{{a.b.c}}` resolves to nested path `context.a.b.c`
+ *
+ * Safe regex-based — no eval.
+ */
+export declare function substitute(template: string, context: Record<string, unknown>): string;
+//# sourceMappingURL=template-engine.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/template-engine.js

@@ -0,0 +1,40 @@
+/**
+ * Substitute {{variable}} and {{step-id.field}} placeholders in a template
+ * string using values from a context object.
+ *
+ * - `{{variable}}` resolves to `context[variable]`
+ * - `{{a.b.c}}` resolves to nested path `context.a.b.c`
+ *
+ * Safe regex-based — no eval.
+ */
+export function substitute(template, context) {
+    return template.replace(/\{\{([\w./-]+)\}\}/g, (_match, path) => {
+        const value = resolvePath(context, path);
+        if (value === undefined) {
+            return `{{${path}}}`;
+        }
+        return String(value);
+    });
+}
+const BLOCKED_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function resolvePath(obj, path) {
+    const segments = path.split('.');
+    let current = obj;
+    for (const segment of segments) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== 'object') {
+            return undefined;
+        }
+        if (BLOCKED_KEYS.has(segment)) {
+            return undefined;
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, segment)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+//# sourceMappingURL=template-engine.js.map

package/packages/@monomind/cli/dist/src/workflow/workflow-executor.d.ts

@@ -0,0 +1,29 @@
+import type { WorkflowDefinition } from './dsl-schema.js';
+export interface AgentDispatcher {
+    dispatch(agent: string, task: string, context: Record<string, unknown>): Promise<unknown>;
+}
+export interface StepResult {
+    stepId: string;
+    output: unknown;
+    status: 'success' | 'error';
+    error?: string;
+}
+export interface WorkflowResult {
+    workflowName: string;
+    status: 'success' | 'error';
+    stepResults: StepResult[];
+    context: Record<string, unknown>;
+}
+export declare class WorkflowExecutor {
+    private readonly dispatcher;
+    constructor(dispatcher: AgentDispatcher);
+    execute(workflow: WorkflowDefinition): Promise<WorkflowResult>;
+    private executeStep;
+    private executeAgent;
+    private executeParallel;
+    private executeSequence;
+    private executeConditional;
+    private executeMapReduce;
+    private executeLoop;
+}
+//# sourceMappingURL=workflow-executor.d.ts.map