@relayflows/core 0.0.1 → 1.0.0

package/dist/agent-handle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Thin adapter over the harness-driver's `SpawnedAgentHandle`.
+ *
+ * The driver (`@agent-relay/harness-driver` ≥ 8.2) owns the real lifecycle
+ * logic — event subscription, replay-correct exit/idle resolution, exit
+ * code/signal capture. This wrapper only maps its structured results
+ * (`{ reason, code, signal }` / `{ reason, idleSecs }`) back to the simple
+ * string contract the workflow runner has always used (`'exited'` / `'timeout'`
+ * / `'idle'`), so `runner.ts` keeps consuming handles unchanged.
+ */
+import type { SpawnedAgentHandle } from '@agent-relay/harness-driver';
+export declare class WorkflowAgentHandle {
+    private readonly inner;
+    constructor(inner: SpawnedAgentHandle);
+    get name(): string;
+    get runtime(): SpawnedAgentHandle['runtime'];
+    get exitCode(): number | undefined;
+    get exitSignal(): string | undefined;
+    /** Resolves `'exited'` when the agent exits, or `'timeout'` after `timeoutMs`. */
+    waitForExit(timeoutMs?: number): Promise<'exited' | 'timeout'>;
+    /** Resolves `'idle'` on the next idle signal, `'exited'` if it exits first, or `'timeout'`. */
+    waitForIdle(timeoutMs?: number): Promise<'idle' | 'exited' | 'timeout'>;
+    release(reason?: string): Promise<{
+        name: string;
+    }>;
+}
+//# sourceMappingURL=agent-handle.d.ts.map

package/dist/agent-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-handle.d.ts","sourceRoot":"","sources":["../src/agent-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAEtD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAE3C;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,kFAAkF;IAC5E,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAKpE,+FAA+F;IACzF,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAK7E,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAGpD"}

package/dist/agent-handle.js

@@ -0,0 +1,32 @@
+export class WorkflowAgentHandle {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    get name() {
+        return this.inner.name;
+    }
+    get runtime() {
+        return this.inner.runtime;
+    }
+    get exitCode() {
+        return this.inner.exitCode;
+    }
+    get exitSignal() {
+        return this.inner.exitSignal;
+    }
+    /** Resolves `'exited'` when the agent exits, or `'timeout'` after `timeoutMs`. */
+    async waitForExit(timeoutMs) {
+        const { reason } = await this.inner.waitForExit(timeoutMs);
+        return reason;
+    }
+    /** Resolves `'idle'` on the next idle signal, `'exited'` if it exits first, or `'timeout'`. */
+    async waitForIdle(timeoutMs) {
+        const { reason } = await this.inner.waitForIdle(timeoutMs);
+        return reason;
+    }
+    release(reason) {
+        return this.inner.release(reason);
+    }
+}
+//# sourceMappingURL=agent-handle.js.map

package/dist/agent-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-handle.js","sourceRoot":"","sources":["../src/agent-handle.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,KAAyB;QAAzB,UAAK,GAAL,KAAK,CAAoB;IAAG,CAAC;IAE1D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;IAC/B,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,WAAW,CAAC,SAAkB;QAClC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,WAAW,CAAC,SAAkB;QAClC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,MAAe;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/api-executor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * API Executor — calls LLM provider APIs directly via fetch().
+ * Used when agent cli is 'api'. No sandbox, no CLI, no PTY.
+ */
+type Provider = 'anthropic' | 'openai' | 'google';
+declare function detectProvider(model: string): Provider;
+declare function getApiKey(provider: Provider, envSecrets?: Record<string, string>): string;
+export interface ApiExecutorOptions {
+    envSecrets?: Record<string, string>;
+    defaultModel?: string;
+    defaultMaxTokens?: number;
+    skills?: string;
+}
+export declare function executeApiStep(model: string, task: string, options?: ApiExecutorOptions): Promise<string>;
+export { detectProvider, getApiKey };
+//# sourceMappingURL=api-executor.d.ts.map

package/dist/api-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-executor.d.ts","sourceRoot":"","sources":["../src/api-executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,iBAAS,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAK/C;AAED,iBAAS,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAWlF;AAkED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnH;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}

package/dist/api-executor.js

@@ -0,0 +1,94 @@
+/**
+ * API Executor — calls LLM provider APIs directly via fetch().
+ * Used when agent cli is 'api'. No sandbox, no CLI, no PTY.
+ */
+function detectProvider(model) {
+    if (model.startsWith('claude'))
+        return 'anthropic';
+    if (model.startsWith('gpt') || model.startsWith('o1') || model.startsWith('o3') || model.startsWith('o4'))
+        return 'openai';
+    if (model.startsWith('gemini'))
+        return 'google';
+    return 'anthropic';
+}
+function getApiKey(provider, envSecrets) {
+    const envMap = {
+        anthropic: ['ANTHROPIC_API_KEY'],
+        openai: ['OPENAI_API_KEY'],
+        google: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'],
+    };
+    for (const key of envMap[provider]) {
+        const value = envSecrets?.[key] ?? process.env[key];
+        if (value)
+            return value;
+    }
+    throw new Error(`No API key for "${provider}". Set ${envMap[provider].join(' or ')}.`);
+}
+async function callAnthropic(apiKey, model, task, maxTokens, systemPrompt) {
+    const res = await fetch('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' },
+        body: JSON.stringify({
+            model, max_tokens: maxTokens,
+            ...(systemPrompt ? { system: systemPrompt } : {}),
+            messages: [{ role: 'user', content: task }],
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`Anthropic API error (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    return {
+        content: data.content.filter(c => c.type === 'text').map(c => c.text ?? '').join(''),
+        model: data.model,
+        usage: data.usage ? { inputTokens: data.usage.input_tokens, outputTokens: data.usage.output_tokens } : undefined,
+    };
+}
+async function callOpenAI(apiKey, model, task, maxTokens, systemPrompt) {
+    const messages = [];
+    if (systemPrompt)
+        messages.push({ role: 'system', content: systemPrompt });
+    messages.push({ role: 'user', content: task });
+    const res = await fetch('https://api.openai.com/v1/chat/completions', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', 'authorization': `Bearer ${apiKey}` },
+        body: JSON.stringify({ model, max_tokens: maxTokens, messages }),
+    });
+    if (!res.ok)
+        throw new Error(`OpenAI API error (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    return {
+        content: data.choices[0]?.message?.content ?? '',
+        model: data.model,
+        usage: data.usage ? { inputTokens: data.usage.prompt_tokens, outputTokens: data.usage.completion_tokens } : undefined,
+    };
+}
+async function callGoogle(apiKey, model, task, maxTokens, systemPrompt) {
+    const res = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', 'x-goog-api-key': apiKey },
+        body: JSON.stringify({
+            ...(systemPrompt ? { systemInstruction: { parts: [{ text: systemPrompt }] } } : {}),
+            contents: [{ parts: [{ text: task }] }],
+            generationConfig: { maxOutputTokens: maxTokens },
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`Google API error (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    return {
+        content: data.candidates[0]?.content?.parts?.map(p => p.text).join('') ?? '',
+        model,
+        usage: data.usageMetadata ? { inputTokens: data.usageMetadata.promptTokenCount, outputTokens: data.usageMetadata.candidatesTokenCount } : undefined,
+    };
+}
+const PROVIDER_CALLERS = { anthropic: callAnthropic, openai: callOpenAI, google: callGoogle };
+export async function executeApiStep(model, task, options = {}) {
+    const resolvedModel = model || options.defaultModel || 'claude-sonnet-4-20250514';
+    const maxTokens = options.defaultMaxTokens ?? 4096;
+    const provider = detectProvider(resolvedModel);
+    const apiKey = getApiKey(provider, options.envSecrets);
+    const response = await PROVIDER_CALLERS[provider](apiKey, resolvedModel, task, maxTokens, options.skills);
+    return response.content;
+}
+export { detectProvider, getApiKey };
+//# sourceMappingURL=api-executor.js.map

package/dist/api-executor.js.map

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

package/dist/barrier.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Barrier Manager — synchronization barriers with all/any/majority semantics.
+ *
+ * Barriers gate downstream workflow steps until a set of upstream agents
+ * or steps have resolved. Supports three resolution modes:
+ *
+ * - **all**      — every agent in `waitFor` must resolve (default)
+ * - **any**      — at least one agent resolves
+ * - **majority** — more than half of `waitFor` must resolve
+ */
+import { EventEmitter } from 'node:events';
+import type { DbClient } from './coordinator.js';
+export type BarrierMode = 'all' | 'any' | 'majority';
+export interface BarrierDefinition {
+    name: string;
+    waitFor: string[];
+    mode?: BarrierMode;
+    timeoutMs?: number;
+}
+export interface BarrierRow {
+    id: string;
+    runId: string;
+    barrierName: string;
+    waitFor: string[];
+    resolved: string[];
+    isSatisfied: boolean;
+    timeoutMs: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface BarrierManagerEvents {
+    'barrier:created': (barrier: BarrierRow) => void;
+    'barrier:resolved': (barrierName: string, agent: string) => void;
+    'barrier:satisfied': (barrier: BarrierRow) => void;
+    'barrier:timeout': (barrier: BarrierRow) => void;
+}
+export declare class BarrierManager extends EventEmitter {
+    private db;
+    /** In-memory mode tracking (not persisted — set once at creation). */
+    private modes;
+    private timeoutTimers;
+    constructor(db: DbClient);
+    /**
+     * Create a barrier for a workflow run.
+     */
+    createBarrier(runId: string, definition: BarrierDefinition): Promise<BarrierRow>;
+    /**
+     * Bulk-create barriers from a list of definitions (e.g. from coordination config).
+     */
+    createBarriers(runId: string, definitions: BarrierDefinition[]): Promise<BarrierRow[]>;
+    /**
+     * Mark an agent/step as resolved for a barrier. Returns whether the
+     * barrier is now fully satisfied.
+     */
+    resolve(runId: string, barrierName: string, agent: string): Promise<{
+        satisfied: boolean;
+        barrier: BarrierRow;
+    }>;
+    getBarrier(runId: string, barrierName: string): Promise<BarrierRow | null>;
+    getBarriers(runId: string): Promise<BarrierRow[]>;
+    getUnsatisfiedBarriers(runId: string): Promise<BarrierRow[]>;
+    /**
+     * Check if a named barrier is satisfied (useful for gating downstream work).
+     */
+    isSatisfied(runId: string, barrierName: string): Promise<boolean>;
+    cleanup(): void;
+    private checkSatisfied;
+    private markSatisfied;
+    private scheduleTimeout;
+    private clearTimeout;
+}
+//# sourceMappingURL=barrier.d.ts.map

package/dist/barrier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrier.d.ts","sourceRoot":"","sources":["../src/barrier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IACjD,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,mBAAmB,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IACnD,iBAAiB,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CAClD;AAID,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,EAAE,CAAW;IACrB,sEAAsE;IACtE,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,aAAa,CAAoD;gBAE7D,EAAE,EAAE,QAAQ;IAOxB;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA+BtB;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,iBAAiB,EAAE,GAC/B,OAAO,CAAC,UAAU,EAAE,CAAC;IAUxB;;;OAGG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,CAAC;IAsCjD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ1E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQjD,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQlE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,cAAc;YAcR,aAAa;IAmB3B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/barrier.js

@@ -0,0 +1,162 @@
+/**
+ * Barrier Manager — synchronization barriers with all/any/majority semantics.
+ *
+ * Barriers gate downstream workflow steps until a set of upstream agents
+ * or steps have resolved. Supports three resolution modes:
+ *
+ * - **all**      — every agent in `waitFor` must resolve (default)
+ * - **any**      — at least one agent resolves
+ * - **majority** — more than half of `waitFor` must resolve
+ */
+import { randomBytes } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+// ── Manager ─────────────────────────────────────────────────────────────────
+export class BarrierManager extends EventEmitter {
+    db;
+    /** In-memory mode tracking (not persisted — set once at creation). */
+    modes = new Map();
+    timeoutTimers = new Map();
+    constructor(db) {
+        super();
+        this.db = db;
+    }
+    // ── Create ──────────────────────────────────────────────────────────────
+    /**
+     * Create a barrier for a workflow run.
+     */
+    async createBarrier(runId, definition) {
+        const id = `bar_${Date.now()}_${randomBytes(4).toString('hex')}`;
+        const now = new Date().toISOString();
+        const mode = definition.mode ?? 'all';
+        const { rows } = await this.db.query(`INSERT INTO workflow_barriers (id, run_id, barrier_name, wait_for, resolved, is_satisfied, timeout_ms, created_at, updated_at)
+       VALUES ($1, $2, $3, $4, '[]'::jsonb, FALSE, $5, $6, $6)
+       RETURNING *`, [
+            id,
+            runId,
+            definition.name,
+            JSON.stringify(definition.waitFor),
+            definition.timeoutMs ?? null,
+            now,
+        ]);
+        const barrier = rows[0];
+        const key = `${runId}:${definition.name}`;
+        this.modes.set(key, mode);
+        if (definition.timeoutMs) {
+            this.scheduleTimeout(barrier, definition.timeoutMs);
+        }
+        this.emit('barrier:created', barrier);
+        return barrier;
+    }
+    /**
+     * Bulk-create barriers from a list of definitions (e.g. from coordination config).
+     */
+    async createBarriers(runId, definitions) {
+        const results = [];
+        for (const def of definitions) {
+            results.push(await this.createBarrier(runId, def));
+        }
+        return results;
+    }
+    // ── Resolve ─────────────────────────────────────────────────────────────
+    /**
+     * Mark an agent/step as resolved for a barrier. Returns whether the
+     * barrier is now fully satisfied.
+     */
+    async resolve(runId, barrierName, agent) {
+        const now = new Date().toISOString();
+        // Atomic: append agent to resolved array if not already present.
+        const { rows } = await this.db.query(`UPDATE workflow_barriers
+       SET resolved = CASE
+             WHEN resolved @> $3::jsonb THEN resolved
+             ELSE resolved || $3::jsonb
+           END,
+           updated_at = $4
+       WHERE run_id = $1 AND barrier_name = $2 AND is_satisfied = FALSE
+       RETURNING *`, [runId, barrierName, JSON.stringify(agent), now]);
+        if (rows.length === 0) {
+            // Barrier may already be satisfied or not exist.
+            const existing = await this.getBarrier(runId, barrierName);
+            if (!existing)
+                throw new Error(`Barrier ${barrierName} not found for run ${runId}`);
+            return { satisfied: existing.isSatisfied, barrier: existing };
+        }
+        const barrier = rows[0];
+        this.emit('barrier:resolved', barrierName, agent);
+        const key = `${runId}:${barrierName}`;
+        const mode = this.modes.get(key) ?? 'all';
+        if (this.checkSatisfied(barrier, mode)) {
+            return this.markSatisfied(barrier);
+        }
+        return { satisfied: false, barrier };
+    }
+    // ── Queries ─────────────────────────────────────────────────────────────
+    async getBarrier(runId, barrierName) {
+        const { rows } = await this.db.query(`SELECT * FROM workflow_barriers WHERE run_id = $1 AND barrier_name = $2`, [runId, barrierName]);
+        return rows[0] ?? null;
+    }
+    async getBarriers(runId) {
+        const { rows } = await this.db.query(`SELECT * FROM workflow_barriers WHERE run_id = $1 ORDER BY created_at ASC`, [runId]);
+        return rows;
+    }
+    async getUnsatisfiedBarriers(runId) {
+        const { rows } = await this.db.query(`SELECT * FROM workflow_barriers WHERE run_id = $1 AND is_satisfied = FALSE ORDER BY created_at ASC`, [runId]);
+        return rows;
+    }
+    /**
+     * Check if a named barrier is satisfied (useful for gating downstream work).
+     */
+    async isSatisfied(runId, barrierName) {
+        const barrier = await this.getBarrier(runId, barrierName);
+        return barrier?.isSatisfied ?? false;
+    }
+    // ── Cleanup ─────────────────────────────────────────────────────────────
+    cleanup() {
+        for (const timer of this.timeoutTimers.values())
+            clearTimeout(timer);
+        this.timeoutTimers.clear();
+        this.modes.clear();
+    }
+    // ── Private ─────────────────────────────────────────────────────────────
+    checkSatisfied(barrier, mode) {
+        const waitFor = Array.isArray(barrier.waitFor) ? barrier.waitFor : [];
+        const resolved = Array.isArray(barrier.resolved) ? barrier.resolved : [];
+        switch (mode) {
+            case 'all':
+                return waitFor.every((w) => resolved.includes(w));
+            case 'any':
+                return resolved.length > 0;
+            case 'majority':
+                return resolved.length > waitFor.length / 2;
+        }
+    }
+    async markSatisfied(barrier) {
+        const now = new Date().toISOString();
+        const { rows } = await this.db.query(`UPDATE workflow_barriers SET is_satisfied = TRUE, updated_at = $2
+       WHERE id = $1
+       RETURNING *`, [barrier.id, now]);
+        const updated = rows[0];
+        const key = `${barrier.runId}:${barrier.barrierName}`;
+        this.clearTimeout(key);
+        this.emit('barrier:satisfied', updated);
+        return { satisfied: true, barrier: updated };
+    }
+    scheduleTimeout(barrier, timeoutMs) {
+        const key = `${barrier.runId}:${barrier.barrierName}`;
+        const timer = setTimeout(async () => {
+            const current = await this.getBarrier(barrier.runId, barrier.barrierName);
+            if (current && !current.isSatisfied) {
+                this.emit('barrier:timeout', current);
+            }
+        }, timeoutMs);
+        timer.unref();
+        this.timeoutTimers.set(key, timer);
+    }
+    clearTimeout(key) {
+        const timer = this.timeoutTimers.get(key);
+        if (timer) {
+            globalThis.clearTimeout(timer);
+            this.timeoutTimers.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=barrier.js.map

package/dist/barrier.js.map

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

package/dist/budget-tracker.d.ts

@@ -0,0 +1,75 @@
+export interface BudgetTrackerStepConfig {
+    stepName: string;
+    agentName: string;
+    maxTokens?: number;
+}
+export interface BudgetTrackerOptions {
+    perAgent?: number;
+    perWorkflow?: number;
+    workflowBudget?: number;
+    steps?: BudgetTrackerStepConfig[];
+}
+export interface TokenUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    total: number;
+}
+export interface BudgetAvailability {
+    allowed: boolean;
+    reason?: string;
+}
+export interface OverBudgetResult {
+    over: boolean;
+    reason?: string;
+}
+export interface BudgetStatus {
+    agentLimitExceeded: boolean;
+    workflowBudgetExceeded: boolean;
+    workflowBudgetExhausted: boolean;
+}
+export interface StepBudgetStatus {
+    used?: number;
+    limit?: number;
+    over: boolean;
+}
+export interface WorkflowBudgetStatus {
+    used: number;
+    limit?: number;
+    exhausted: boolean;
+}
+export interface RunSummaryBudgetData {
+    steps: Map<string, StepBudgetStatus>;
+    workflow?: WorkflowBudgetStatus;
+}
+export declare class BudgetExceededError extends Error {
+    readonly stepName: string;
+    readonly budgetType: 'agent' | 'workflow';
+    readonly limit: number;
+    readonly actual: number;
+    readonly used: number;
+    constructor(stepName: string, budgetType: 'agent' | 'workflow', limit: number, actual: number);
+}
+export declare class BudgetTracker {
+    private readonly defaultAgentBudget?;
+    private readonly workflowBudget?;
+    private readonly stepLimits;
+    private readonly stepUsage;
+    private totalUsage;
+    private workflowBudgetExhausted;
+    constructor(options: BudgetTrackerOptions);
+    recordUsage(stepName: string, usage: number | Partial<Omit<TokenUsage, 'total'>>): void;
+    getStepUsage(stepName: string): TokenUsage;
+    getTotalUsage(): TokenUsage;
+    getRemainingBudget(): {
+        agent?: number;
+        workflow?: number;
+    };
+    checkCanSpawn(stepName: string): BudgetAvailability;
+    isOverBudget(stepName: string): OverBudgetResult;
+    getBudgetStatus(stepName: string): BudgetStatus;
+    getStepBudgetStatus(stepName: string): StepBudgetStatus | undefined;
+    getRunSummaryBudgetData(): RunSummaryBudgetData | undefined;
+    private getStepLimit;
+}
+//# sourceMappingURL=budget-tracker.d.ts.map

package/dist/budget-tracker.d.ts.map

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