agent-relay 2.3.2 → 2.3.5

package/packages/sdk-ts/dist/workflows/coordinator.js

@@ -0,0 +1,353 @@
+/**
+ * Swarm Coordinator — pattern selection, agent topology, and workflow lifecycle.
+ *
+ * Orchestrates workflow runs: picks the right swarm pattern (or auto-selects),
+ * resolves agent topology from the config, and drives the run through its
+ * lifecycle states (pending → running → completed / failed / cancelled).
+ */
+import { randomBytes } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+// ── Pattern auto-selection ──────────────────────────────────────────────────
+/**
+ * Mapping used when auto-selecting a pattern from config heuristics.
+ * The coordinator checks the config shape and picks the best match.
+ */
+const PATTERN_HEURISTICS = [
+    {
+        test: (c) => Array.isArray(c.workflows) &&
+            c.workflows.some((w) => w.steps.some((s) => s.dependsOn?.length)),
+        pattern: 'dag',
+    },
+    {
+        test: (c) => c.coordination?.consensusStrategy !== undefined,
+        pattern: 'consensus',
+    },
+    {
+        test: (c) => Array.isArray(c.workflows) &&
+            c.workflows.some((w) => {
+                const names = w.steps.map((s) => s.agent);
+                return new Set(names).size === names.length && names.length > 2;
+            }),
+        pattern: 'pipeline',
+    },
+    {
+        test: (c) => c.agents.length > 3 && c.agents.some((a) => a.role === 'lead'),
+        pattern: 'hierarchical',
+    },
+    {
+        test: (c) => c.agents.some((a) => a.role === 'hub' || a.role === 'coordinator'),
+        pattern: 'hub-spoke',
+    },
+    {
+        // Default: many independent agents → fan-out
+        test: () => true,
+        pattern: 'fan-out',
+    },
+];
+// ── Coordinator ─────────────────────────────────────────────────────────────
+export class SwarmCoordinator extends EventEmitter {
+    db;
+    constructor(db) {
+        super();
+        this.db = db;
+    }
+    // ── Pattern selection ───────────────────────────────────────────────────
+    /**
+     * Select the swarm pattern to use for a config. If the config already
+     * specifies a pattern, it is returned as-is. Otherwise heuristics apply.
+     */
+    selectPattern(config) {
+        if (config.swarm.pattern) {
+            return config.swarm.pattern;
+        }
+        for (const h of PATTERN_HEURISTICS) {
+            if (h.test(config))
+                return h.pattern;
+        }
+        return 'fan-out';
+    }
+    // ── Topology resolution ─────────────────────────────────────────────────
+    /**
+     * Build the agent communication topology for a given config and pattern.
+     */
+    resolveTopology(config, pattern) {
+        const p = pattern ?? this.selectPattern(config);
+        const agents = config.agents;
+        const edges = new Map();
+        const names = agents.map((a) => a.name);
+        switch (p) {
+            case 'fan-out': {
+                // Hub (first agent or role=lead) fans out to all others; no inter-worker edges.
+                const hub = this.pickHub(agents);
+                const others = names.filter((n) => n !== hub);
+                edges.set(hub, others);
+                for (const o of others)
+                    edges.set(o, [hub]);
+                return { pattern: p, agents, edges, hub };
+            }
+            case 'pipeline': {
+                // Linear chain following workflow step order or agent list order.
+                const order = this.resolvePipelineOrder(config, names);
+                for (let i = 0; i < order.length; i++) {
+                    edges.set(order[i], i < order.length - 1 ? [order[i + 1]] : []);
+                }
+                return { pattern: p, agents, edges, pipelineOrder: order };
+            }
+            case 'hub-spoke': {
+                const hub = this.pickHub(agents);
+                const spokes = names.filter((n) => n !== hub);
+                edges.set(hub, spokes);
+                for (const s of spokes)
+                    edges.set(s, [hub]);
+                return { pattern: p, agents, edges, hub };
+            }
+            case 'consensus':
+            case 'debate':
+            case 'mesh': {
+                // Full mesh — every agent can talk to every other.
+                for (const n of names) {
+                    edges.set(n, names.filter((o) => o !== n));
+                }
+                return { pattern: p, agents, edges };
+            }
+            case 'handoff': {
+                // Chain with explicit handoff: each agent passes to the next.
+                const order = this.resolvePipelineOrder(config, names);
+                for (let i = 0; i < order.length; i++) {
+                    edges.set(order[i], i < order.length - 1 ? [order[i + 1]] : []);
+                }
+                return { pattern: p, agents, edges, pipelineOrder: order };
+            }
+            case 'cascade': {
+                // Primary tries first; on failure, falls through to next.
+                for (let i = 0; i < names.length; i++) {
+                    edges.set(names[i], i < names.length - 1 ? [names[i + 1]] : []);
+                }
+                return { pattern: p, agents, edges, pipelineOrder: names };
+            }
+            case 'dag': {
+                // Edges derived from workflow step dependencies.
+                const stepEdges = this.resolveDAGEdges(config);
+                for (const n of names) {
+                    if (!stepEdges.has(n))
+                        stepEdges.set(n, []);
+                }
+                return { pattern: p, agents, edges: stepEdges };
+            }
+            case 'hierarchical': {
+                const hub = this.pickHub(agents);
+                const subordinates = names.filter((n) => n !== hub);
+                edges.set(hub, subordinates);
+                for (const s of subordinates)
+                    edges.set(s, [hub]);
+                return { pattern: p, agents, edges, hub };
+            }
+            default: {
+                // Fallback: full mesh.
+                for (const n of names) {
+                    edges.set(n, names.filter((o) => o !== n));
+                }
+                return { pattern: p, agents, edges };
+            }
+        }
+    }
+    // ── Lifecycle: create run ───────────────────────────────────────────────
+    async createRun(workspaceId, config) {
+        const id = `run_${Date.now()}_${randomBytes(4).toString('hex')}`;
+        const pattern = this.selectPattern(config);
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`INSERT INTO workflow_runs (id, workspace_id, workflow_name, pattern, status, config, started_at, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, 'pending', $5, $6, $6, $6)
+       RETURNING *`, [id, workspaceId, config.name, pattern, JSON.stringify(config), now]);
+        const run = rows[0];
+        this.emit('run:created', run);
+        return run;
+    }
+    // ── Lifecycle: start run ────────────────────────────────────────────────
+    async startRun(runId) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_runs SET status = 'running', started_at = $2, updated_at = $2
+       WHERE id = $1 AND status = 'pending'
+       RETURNING *`, [runId, now]);
+        if (rows.length === 0) {
+            throw new Error(`Run ${runId} not found or not in pending state`);
+        }
+        const run = rows[0];
+        this.emit('run:started', run);
+        return run;
+    }
+    // ── Lifecycle: complete / fail / cancel ─────────────────────────────────
+    async completeRun(runId, stateSnapshot) {
+        return this.transitionRun(runId, 'completed', undefined, stateSnapshot);
+    }
+    async failRun(runId, error) {
+        return this.transitionRun(runId, 'failed', error);
+    }
+    async cancelRun(runId) {
+        return this.transitionRun(runId, 'cancelled');
+    }
+    // ── Step management ─────────────────────────────────────────────────────
+    async createSteps(runId, config) {
+        const workflows = config.workflows ?? [];
+        const created = [];
+        for (const wf of workflows) {
+            for (const step of wf.steps) {
+                const id = `step_${Date.now()}_${randomBytes(4).toString('hex')}`;
+                const now = new Date().toISOString();
+                const { rows } = await this.db.query(`INSERT INTO workflow_steps (id, run_id, step_name, agent_name, status, task, depends_on, created_at, updated_at)
+           VALUES ($1, $2, $3, $4, 'pending', $5, $6, $7, $7)
+           RETURNING *`, [
+                    id,
+                    runId,
+                    step.name,
+                    step.agent,
+                    step.task,
+                    JSON.stringify(step.dependsOn ?? []),
+                    now,
+                ]);
+                created.push(rows[0]);
+            }
+        }
+        return created;
+    }
+    async startStep(stepId) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_steps SET status = 'running', started_at = $2, updated_at = $2
+       WHERE id = $1 AND status = 'pending'
+       RETURNING *`, [stepId, now]);
+        if (rows.length === 0) {
+            throw new Error(`Step ${stepId} not found or not in pending state`);
+        }
+        const step = rows[0];
+        this.emit('step:started', step);
+        return step;
+    }
+    async completeStep(stepId, output) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_steps SET status = 'completed', output = $2, completed_at = $3, updated_at = $3
+       WHERE id = $1 AND status = 'running'
+       RETURNING *`, [stepId, output ?? null, now]);
+        if (rows.length === 0) {
+            throw new Error(`Step ${stepId} not found or not in running state`);
+        }
+        const step = rows[0];
+        this.emit('step:completed', step);
+        return step;
+    }
+    async failStep(stepId, error) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_steps SET status = 'failed', error = $2, completed_at = $3, updated_at = $3
+       WHERE id = $1 AND status = 'running'
+       RETURNING *`, [stepId, error, now]);
+        if (rows.length === 0) {
+            throw new Error(`Step ${stepId} not found or not in running state`);
+        }
+        const step = rows[0];
+        this.emit('step:failed', step);
+        return step;
+    }
+    async skipStep(stepId) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_steps SET status = 'skipped', completed_at = $2, updated_at = $2
+       WHERE id = $1
+       RETURNING *`, [stepId, now]);
+        if (rows.length === 0) {
+            throw new Error(`Step ${stepId} not found`);
+        }
+        return rows[0];
+    }
+    // ── Queries ─────────────────────────────────────────────────────────────
+    async getRun(runId) {
+        const { rows } = await this.db.query(`SELECT * FROM workflow_runs WHERE id = $1`, [runId]);
+        return rows[0] ?? null;
+    }
+    async getSteps(runId) {
+        const { rows } = await this.db.query(`SELECT * FROM workflow_steps WHERE run_id = $1 ORDER BY created_at ASC`, [runId]);
+        return rows;
+    }
+    async getReadySteps(runId) {
+        const steps = await this.getSteps(runId);
+        const completedNames = new Set(steps.filter((s) => s.status === 'completed').map((s) => s.stepName));
+        return steps.filter((s) => {
+            if (s.status !== 'pending')
+                return false;
+            const deps = Array.isArray(s.dependsOn) ? s.dependsOn : [];
+            return deps.every((d) => completedNames.has(d));
+        });
+    }
+    async getRunsByWorkspace(workspaceId, status) {
+        if (status) {
+            const { rows } = await this.db.query(`SELECT * FROM workflow_runs WHERE workspace_id = $1 AND status = $2 ORDER BY created_at DESC`, [workspaceId, status]);
+            return rows;
+        }
+        const { rows } = await this.db.query(`SELECT * FROM workflow_runs WHERE workspace_id = $1 ORDER BY created_at DESC`, [workspaceId]);
+        return rows;
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────
+    async transitionRun(runId, status, error, stateSnapshot) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_runs
+       SET status = $2, completed_at = $3, error = $4, state_snapshot = $5, updated_at = $3
+       WHERE id = $1
+       RETURNING *`, [
+            runId,
+            status,
+            now,
+            error ?? null,
+            stateSnapshot ? JSON.stringify(stateSnapshot) : null,
+        ]);
+        if (rows.length === 0) {
+            throw new Error(`Run ${runId} not found`);
+        }
+        const run = rows[0];
+        const eventName = `run:${status}`;
+        this.emit(eventName, run);
+        return run;
+    }
+    pickHub(agents) {
+        const lead = agents.find((a) => a.role === 'lead' || a.role === 'hub' || a.role === 'coordinator');
+        return lead?.name ?? agents[0].name;
+    }
+    resolvePipelineOrder(config, fallback) {
+        const workflow = config.workflows?.[0];
+        if (!workflow)
+            return fallback;
+        // Use step order — each step's agent in sequence, deduped.
+        const seen = new Set();
+        const order = [];
+        for (const step of workflow.steps) {
+            if (!seen.has(step.agent)) {
+                seen.add(step.agent);
+                order.push(step.agent);
+            }
+        }
+        return order.length > 0 ? order : fallback;
+    }
+    resolveDAGEdges(config) {
+        const edges = new Map();
+        const workflows = config.workflows ?? [];
+        for (const wf of workflows) {
+            // Build step-name → agent-name mapping.
+            const stepAgent = new Map();
+            for (const step of wf.steps) {
+                stepAgent.set(step.name, step.agent);
+            }
+            for (const step of wf.steps) {
+                if (!step.dependsOn?.length)
+                    continue;
+                for (const dep of step.dependsOn) {
+                    const fromAgent = stepAgent.get(dep);
+                    if (!fromAgent)
+                        continue;
+                    const existing = edges.get(fromAgent) ?? [];
+                    if (!existing.includes(step.agent)) {
+                        existing.push(step.agent);
+                    }
+                    edges.set(fromAgent, existing);
+                }
+            }
+        }
+        return edges;
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/packages/sdk-ts/dist/workflows/coordinator.js.map

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

package/packages/sdk-ts/dist/workflows/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./types.js";
+export * from "./runner.js";
+export * from "./memory-db.js";
+export * from "./run.js";
+export * from "./builder.js";
+export * from "./coordinator.js";
+export * from "./barrier.js";
+export * from "./state.js";
+export * from "./templates.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/sdk-ts/dist/workflows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/packages/sdk-ts/dist/workflows/index.js

@@ -0,0 +1,10 @@
+export * from "./types.js";
+export * from "./runner.js";
+export * from "./memory-db.js";
+export * from "./run.js";
+export * from "./builder.js";
+export * from "./coordinator.js";
+export * from "./barrier.js";
+export * from "./state.js";
+export * from "./templates.js";
+//# sourceMappingURL=index.js.map

package/packages/sdk-ts/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/packages/sdk-ts/dist/workflows/memory-db.d.ts

@@ -0,0 +1,17 @@
+import type { WorkflowRunRow, WorkflowStepRow } from './types.js';
+import type { WorkflowDb } from './runner.js';
+/**
+ * In-memory implementation of WorkflowDb for local workflow runs.
+ * No persistence — state lives only for the duration of the process.
+ */
+export declare class InMemoryWorkflowDb implements WorkflowDb {
+    private runs;
+    private steps;
+    insertRun(run: WorkflowRunRow): Promise<void>;
+    updateRun(id: string, patch: Partial<WorkflowRunRow>): Promise<void>;
+    getRun(id: string): Promise<WorkflowRunRow | null>;
+    insertStep(step: WorkflowStepRow): Promise<void>;
+    updateStep(id: string, patch: Partial<WorkflowStepRow>): Promise<void>;
+    getStepsByRunId(runId: string): Promise<WorkflowStepRow[]>;
+}
+//# sourceMappingURL=memory-db.d.ts.map

package/packages/sdk-ts/dist/workflows/memory-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../../src/workflows/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,KAAK,CAAsC;IAE7C,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIlD,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAGjE"}

package/packages/sdk-ts/dist/workflows/memory-db.js

@@ -0,0 +1,33 @@
+/**
+ * In-memory implementation of WorkflowDb for local workflow runs.
+ * No persistence — state lives only for the duration of the process.
+ */
+export class InMemoryWorkflowDb {
+    runs = new Map();
+    steps = new Map();
+    async insertRun(run) {
+        this.runs.set(run.id, { ...run });
+    }
+    async updateRun(id, patch) {
+        const existing = this.runs.get(id);
+        if (!existing)
+            return;
+        this.runs.set(id, { ...existing, ...patch, updatedAt: new Date().toISOString() });
+    }
+    async getRun(id) {
+        return this.runs.get(id) ?? null;
+    }
+    async insertStep(step) {
+        this.steps.set(step.id, { ...step });
+    }
+    async updateStep(id, patch) {
+        const existing = this.steps.get(id);
+        if (!existing)
+            return;
+        this.steps.set(id, { ...existing, ...patch, updatedAt: new Date().toISOString() });
+    }
+    async getStepsByRunId(runId) {
+        return Array.from(this.steps.values()).filter((s) => s.runId === runId);
+    }
+}
+//# sourceMappingURL=memory-db.js.map

package/packages/sdk-ts/dist/workflows/memory-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.js","sourceRoot":"","sources":["../../src/workflows/memory-db.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;IACzC,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,KAAK,CAAC,SAAS,CAAC,GAAmB;QACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,KAA8B;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAqB;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,KAA+B;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/packages/sdk-ts/dist/workflows/run.d.ts

@@ -0,0 +1,31 @@
+import type { AgentRelayOptions } from '../relay.js';
+import type { WorkflowRunRow } from './types.js';
+import { type WorkflowEventListener, type VariableContext } from './runner.js';
+/**
+ * Options for the `runWorkflow` convenience function.
+ */
+export interface RunWorkflowOptions {
+    /** Workflow name within the YAML file. Defaults to the first workflow. */
+    workflow?: string;
+    /** Template variable substitutions for {{variable}} placeholders. */
+    vars?: VariableContext;
+    /** Working directory. Defaults to process.cwd(). */
+    cwd?: string;
+    /** AgentRelay options (all optional — broker starts automatically). */
+    relay?: AgentRelayOptions;
+    /** Progress callback for workflow events. */
+    onEvent?: WorkflowEventListener;
+}
+/**
+ * Run a workflow from a relay.yaml file with zero configuration.
+ *
+ * @example
+ * ```typescript
+ * import { runWorkflow } from "@agent-relay/broker-sdk/workflows";
+ *
+ * const result = await runWorkflow("workflows/daytona-migration.yaml");
+ * console.log(result.status); // "completed" | "failed"
+ * ```
+ */
+export declare function runWorkflow(yamlPath: string, options?: RunWorkflowOptions): Promise<WorkflowRunRow>;
+//# sourceMappingURL=run.d.ts.map

package/packages/sdk-ts/dist/workflows/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/workflows/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAkB,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/packages/sdk-ts/dist/workflows/run.js

@@ -0,0 +1,24 @@
+import { WorkflowRunner } from './runner.js';
+/**
+ * Run a workflow from a relay.yaml file with zero configuration.
+ *
+ * @example
+ * ```typescript
+ * import { runWorkflow } from "@agent-relay/broker-sdk/workflows";
+ *
+ * const result = await runWorkflow("workflows/daytona-migration.yaml");
+ * console.log(result.status); // "completed" | "failed"
+ * ```
+ */
+export async function runWorkflow(yamlPath, options = {}) {
+    const runner = new WorkflowRunner({
+        cwd: options.cwd,
+        relay: options.relay,
+    });
+    if (options.onEvent) {
+        runner.on(options.onEvent);
+    }
+    const config = await runner.parseYamlFile(yamlPath);
+    return runner.execute(config, options.workflow, options.vars);
+}
+//# sourceMappingURL=run.js.map

package/packages/sdk-ts/dist/workflows/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/workflows/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAoD,MAAM,aAAa,CAAC;AAkB/F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}

package/packages/sdk-ts/dist/workflows/runner.d.ts

@@ -0,0 +1,119 @@
+/**
+ * WorkflowRunner — parses relay.yaml, validates config, resolves templates,
+ * executes steps (sequential/parallel/DAG), runs verification checks,
+ * persists state to DB, and supports pause/resume/abort with retries.
+ */
+import type { RelayYamlConfig, WorkflowRunRow, WorkflowStepRow } from './types.js';
+import type { AgentRelayOptions } from '../relay.js';
+/** Minimal DB adapter so the runner is not coupled to a specific driver. */
+export interface WorkflowDb {
+    insertRun(run: WorkflowRunRow): Promise<void>;
+    updateRun(id: string, patch: Partial<WorkflowRunRow>): Promise<void>;
+    getRun(id: string): Promise<WorkflowRunRow | null>;
+    insertStep(step: WorkflowStepRow): Promise<void>;
+    updateStep(id: string, patch: Partial<WorkflowStepRow>): Promise<void>;
+    getStepsByRunId(runId: string): Promise<WorkflowStepRow[]>;
+}
+export type WorkflowEvent = {
+    type: 'run:started';
+    runId: string;
+} | {
+    type: 'run:completed';
+    runId: string;
+} | {
+    type: 'run:failed';
+    runId: string;
+    error: string;
+} | {
+    type: 'run:cancelled';
+    runId: string;
+} | {
+    type: 'step:started';
+    runId: string;
+    stepName: string;
+} | {
+    type: 'step:completed';
+    runId: string;
+    stepName: string;
+    output?: string;
+} | {
+    type: 'step:failed';
+    runId: string;
+    stepName: string;
+    error: string;
+} | {
+    type: 'step:skipped';
+    runId: string;
+    stepName: string;
+} | {
+    type: 'step:retrying';
+    runId: string;
+    stepName: string;
+    attempt: number;
+};
+export type WorkflowEventListener = (event: WorkflowEvent) => void;
+export interface WorkflowRunnerOptions {
+    db?: WorkflowDb;
+    workspaceId?: string;
+    relay?: AgentRelayOptions;
+    cwd?: string;
+    summaryDir?: string;
+}
+export interface VariableContext {
+    [key: string]: string | number | boolean | undefined;
+}
+export declare class WorkflowRunner {
+    private readonly db;
+    private readonly workspaceId;
+    private readonly relayOptions;
+    private readonly cwd;
+    private readonly summaryDir;
+    private relay?;
+    private abortController?;
+    private paused;
+    private pauseResolver?;
+    private listeners;
+    constructor(options?: WorkflowRunnerOptions);
+    on(listener: WorkflowEventListener): () => void;
+    private emit;
+    /** Parse a relay.yaml file from disk. */
+    parseYamlFile(filePath: string): Promise<RelayYamlConfig>;
+    /** Parse a relay.yaml string. */
+    parseYamlString(raw: string, source?: string): RelayYamlConfig;
+    /** Validate a config object against the RelayYamlConfig shape. */
+    validateConfig(config: unknown, source?: string): asserts config is RelayYamlConfig;
+    private validateWorkflow;
+    private detectCycles;
+    /** Resolve {{variable}} placeholders in all task strings. */
+    resolveVariables(config: RelayYamlConfig, vars: VariableContext): RelayYamlConfig;
+    private interpolate;
+    private resolveDotPath;
+    /** Build a nested context from completed step outputs for {{steps.X.output}} resolution. */
+    private buildStepOutputContext;
+    /** Interpolate step-output variables, silently skipping unresolved ones (they may be user vars). */
+    private interpolateStepTask;
+    /** Execute a named workflow from a validated config. */
+    execute(config: RelayYamlConfig, workflowName?: string, vars?: VariableContext): Promise<WorkflowRunRow>;
+    /** Resume a previously paused or partially completed run. */
+    resume(runId: string, vars?: VariableContext): Promise<WorkflowRunRow>;
+    /** Pause execution. Currently-running steps will finish but no new steps start. */
+    pause(): void;
+    /** Resume after a pause(). */
+    unpause(): void;
+    /** Abort the current run. Running agents are released. */
+    abort(): void;
+    private executeSteps;
+    private findReadySteps;
+    private executeStep;
+    private spawnAndWait;
+    private runVerification;
+    private updateRunStatus;
+    private markStepFailed;
+    private markDownstreamSkipped;
+    private checkAborted;
+    private waitIfPaused;
+    private delay;
+    private generateId;
+    private generateShortId;
+}
+//# sourceMappingURL=runner.d.ts.map