@dewtech/dare-cli 2.0.1 → 2.2.0

package/dist/dag-runner/adapters/claude.js

@@ -0,0 +1,48 @@
+/**
+ * Claude adapter — calls the Anthropic Messages API to execute a task.
+ *
+ * Env: ANTHROPIC_API_KEY
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { AdapterCallError, MissingApiKeyError, pickModel, } from './index.js';
+const SYSTEM_PROMPT = 'You are a DARE subagent executing a single task from a DAG. Follow the prompt ' +
+    'exactly. When you finish, respond with a concise summary of what you did and the ' +
+    'paths of files you created or modified. Keep responses self-contained — your ' +
+    'output may be quoted into a downstream task.';
+export class ClaudeAdapter {
+    constructor() {
+        this.name = 'claude';
+    }
+    async call({ prompt, complexity, models, signal }) {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (!apiKey)
+            throw new MissingApiKeyError('claude', 'ANTHROPIC_API_KEY');
+        const model = pickModel(models, complexity);
+        const client = new Anthropic({ apiKey });
+        try {
+            const res = await client.messages.create({
+                model,
+                max_tokens: 4096,
+                system: SYSTEM_PROMPT,
+                messages: [{ role: 'user', content: prompt }],
+            }, { signal });
+            const text = res.content
+                .filter((b) => b.type === 'text')
+                .map((b) => b.text)
+                .join('\n');
+            const tokens = (res.usage?.input_tokens ?? 0) + (res.usage?.output_tokens ?? 0);
+            return { output: text, tokens };
+        }
+        catch (err) {
+            if (err instanceof MissingApiKeyError)
+                throw err;
+            throw new AdapterCallError('claude', extractErrorMessage(err), err);
+        }
+    }
+}
+function extractErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=claude.js.map

package/dist/dag-runner/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/dag-runner/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,GAIV,MAAM,YAAY,CAAC;AAEpB,MAAM,aAAa,GACjB,gFAAgF;IAChF,mFAAmF;IACnF,+EAA+E;IAC/E,8CAA8C,CAAC;AAEjD,MAAM,OAAO,aAAa;IAA1B;QACW,SAAI,GAAG,QAAiB,CAAC;IAiCpC,CAAC;IA/BC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAoB;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAEzE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CACtC;gBACE,KAAK;gBACL,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,aAAa;gBACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAC9C,EACD,EAAE,MAAM,EAAE,CACX,CAAC;YAEF,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO;iBACrB,MAAM,CAAC,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;iBAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,CAAC,CAAC;YAEhF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB;gBAAE,MAAM,GAAG,CAAC;YACjD,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/dag-runner/adapters/cursor.d.ts

@@ -0,0 +1,6 @@
+import { type AdapterCallInput, type AdapterCallResult, type RunnerAdapter } from './index.js';
+export declare class CursorAdapter implements RunnerAdapter {
+    readonly name: "cursor";
+    call({ prompt, complexity, models, signal }: AdapterCallInput): Promise<AdapterCallResult>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/dag-runner/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/dag-runner/adapters/cursor.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAoCjG"}

package/dist/dag-runner/adapters/cursor.js

@@ -0,0 +1,58 @@
+/**
+ * Cursor adapter — uses @cursor/sdk to execute a task as a local subagent.
+ *
+ * Env: CURSOR_API_KEY
+ *
+ * Compatible with the cookbook DAG Task Runner pattern (Agent.create + send + wait).
+ */
+import { Agent } from '@cursor/sdk';
+import { AdapterCallError, MissingApiKeyError, pickModel, } from './index.js';
+export class CursorAdapter {
+    constructor() {
+        this.name = 'cursor';
+    }
+    async call({ prompt, complexity, models, signal }) {
+        const apiKey = process.env.CURSOR_API_KEY;
+        if (!apiKey)
+            throw new MissingApiKeyError('cursor', 'CURSOR_API_KEY');
+        const model = pickModel(models, complexity);
+        let agent;
+        try {
+            agent = await Agent.create({
+                apiKey,
+                model: { id: model },
+                name: 'DARE DAG Subagent',
+            });
+            const run = await agent.send(prompt);
+            const onAbort = () => {
+                // Best-effort cancel; ignore failures.
+                run.cancel().catch(() => undefined);
+            };
+            if (signal.aborted)
+                onAbort();
+            else
+                signal.addEventListener('abort', onAbort, { once: true });
+            const result = await run.wait();
+            return { output: result.result ?? '' };
+        }
+        catch (err) {
+            if (err instanceof MissingApiKeyError)
+                throw err;
+            throw new AdapterCallError('cursor', extractErrorMessage(err), err);
+        }
+        finally {
+            try {
+                await agent?.close();
+            }
+            catch {
+                // ignore close failures — task already completed/failed
+            }
+        }
+    }
+}
+function extractErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=cursor.js.map

package/dist/dag-runner/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/dag-runner/adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,GAIV,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,aAAa;IAA1B;QACW,SAAI,GAAG,QAAiB,CAAC;IAsCpC,CAAC;IApCC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAoB;QACjE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAEtE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAE5C,IAAI,KAA2D,CAAC;QAChE,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;gBACzB,MAAM;gBACN,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;gBACpB,IAAI,EAAE,mBAAmB;aAC1B,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErC,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,uCAAuC;gBACvC,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC,CAAC;YACF,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;;gBACzB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB;gBAAE,MAAM,GAAG,CAAC;YACjD,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/dag-runner/adapters/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Runner adapters — execute a single DAG task by calling the underlying
+ * provider SDK (Anthropic, Cursor, Google).
+ *
+ * Each adapter must:
+ *   - read its API key from the documented env var (or throw a clear error)
+ *   - honor the AbortSignal forwarded by `withTimeout`
+ *   - return raw text output (capping is the runner's responsibility)
+ *   - report token usage when the SDK exposes it
+ */
+import type { Complexity, DagModelMap, RunnerName } from '../run_dag.js';
+export interface AdapterCallInput {
+    prompt: string;
+    complexity: Complexity;
+    models: DagModelMap;
+    signal: AbortSignal;
+}
+export interface AdapterCallResult {
+    output: string;
+    tokens?: number;
+}
+export interface RunnerAdapter {
+    readonly name: RunnerName;
+    call(input: AdapterCallInput): Promise<AdapterCallResult>;
+}
+export declare class MissingApiKeyError extends Error {
+    readonly runner: RunnerName;
+    readonly envVar: string;
+    constructor(runner: RunnerName, envVar: string);
+}
+export declare class AdapterCallError extends Error {
+    readonly runner: RunnerName;
+    readonly cause?: unknown | undefined;
+    constructor(runner: RunnerName, message: string, cause?: unknown | undefined);
+}
+/**
+ * Resolve a model id from complexity → model map, with a soft fallback.
+ */
+export declare function pickModel(models: DagModelMap | undefined, complexity: Complexity): string;
+/**
+ * Lazy factory — keeps SDK imports out of the require graph until the
+ * specific adapter is actually invoked. Avoids loading three SDKs when only
+ * one is in use.
+ */
+export declare function getAdapter(name: RunnerName): Promise<RunnerAdapter>;
+//# sourceMappingURL=index.d.ts.map

package/dist/dag-runner/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dag-runner/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3D;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACf,MAAM,EAAE,UAAU;aAAkB,MAAM,EAAE,MAAM;gBAAlD,MAAM,EAAE,UAAU,EAAkB,MAAM,EAAE,MAAM;CAO/E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aACb,MAAM,EAAE,UAAU;aAAmC,KAAK,CAAC,EAAE,OAAO;gBAApE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAIjG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CASzF;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBzE"}

package/dist/dag-runner/adapters/index.js

@@ -0,0 +1,55 @@
+export class MissingApiKeyError extends Error {
+    constructor(runner, envVar) {
+        super(`${runner} runner requires ${envVar} to be set. ` +
+            `Export it before running: setx ${envVar} <your-key>  (Windows)  or  export ${envVar}=<your-key>  (bash).`);
+        this.runner = runner;
+        this.envVar = envVar;
+        this.name = 'MissingApiKeyError';
+    }
+}
+export class AdapterCallError extends Error {
+    constructor(runner, message, cause) {
+        super(`${runner} adapter: ${message}`);
+        this.runner = runner;
+        this.cause = cause;
+        this.name = 'AdapterCallError';
+    }
+}
+/**
+ * Resolve a model id from complexity → model map, with a soft fallback.
+ */
+export function pickModel(models, complexity) {
+    if (!models) {
+        throw new Error(`No model mapping configured for complexity=${complexity}`);
+    }
+    const id = models[complexity];
+    if (!id) {
+        throw new Error(`Missing model for complexity=${complexity} in dare-dag.yaml`);
+    }
+    return id;
+}
+/**
+ * Lazy factory — keeps SDK imports out of the require graph until the
+ * specific adapter is actually invoked. Avoids loading three SDKs when only
+ * one is in use.
+ */
+export async function getAdapter(name) {
+    switch (name) {
+        case 'claude': {
+            const { ClaudeAdapter } = await import('./claude.js');
+            return new ClaudeAdapter();
+        }
+        case 'cursor': {
+            const { CursorAdapter } = await import('./cursor.js');
+            return new CursorAdapter();
+        }
+        case 'antigravity': {
+            const { AntigravityAdapter } = await import('./antigravity.js');
+            return new AntigravityAdapter();
+        }
+        default: {
+            throw new Error(`Unknown runner: ${name}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/dag-runner/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dag-runner/adapters/index.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAA4B,MAAkB,EAAkB,MAAc;QAC5E,KAAK,CACH,GAAG,MAAM,oBAAoB,MAAM,cAAc;YAC/C,kCAAkC,MAAM,sCAAsC,MAAM,sBAAsB,CAC7G,CAAC;QAJwB,WAAM,GAAN,MAAM,CAAY;QAAkB,WAAM,GAAN,MAAM,CAAQ;QAK5E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAA4B,MAAkB,EAAE,OAAe,EAAkB,KAAe;QAC9F,KAAK,CAAC,GAAG,MAAM,aAAa,OAAO,EAAE,CAAC,CAAC;QADb,WAAM,GAAN,MAAM,CAAY;QAAmC,UAAK,GAAL,KAAK,CAAU;QAE9F,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAA+B,EAAE,UAAsB;IAC/E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,mBAAmB,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB;IAC/C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACtD,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAChE,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAc,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/dag-runner/run_dag.d.ts

@@ -1,32 +1,71 @@
 /**
- * DARE Framework - DAG Task Runner
- * Adapted from Cursor Cookbook DAG Task Runner pattern
- * Executes tasks in parallel based on dependency graph
+ * DARE Framework — DAG Task Runner
+ *
+ * Executes tasks in parallel based on a dependency graph (Kahn's ranks),
+ * delegating actual execution to a per-runner adapter (Claude / Cursor /
+ * Antigravity). Adapted from the Cursor Cookbook DAG Task Runner pattern.
  */
+export type Complexity = 'LOW' | 'MED' | 'HIGH';
+export type RunnerName = 'cursor' | 'claude' | 'antigravity';
+export type TaskStatus = 'PENDING' | 'RUNNING' | 'DONE' | 'FAILED' | 'SKIPPED';
 export interface DagTask {
     id: string;
     title: string;
     depends_on: string[];
-    complexity: 'LOW' | 'MED' | 'HIGH';
+    complexity: Complexity;
     subtask_prompt: string;
-    status?: 'PENDING' | 'RUNNING' | 'DONE' | 'FAILED' | 'SKIPPED';
+    /** Optional path (relative to project root) to a spec file with detailed instructions. */
+    spec_file?: string;
+    status?: TaskStatus;
     output?: string;
+    /** Last error message when status is FAILED. */
+    error?: string;
     tokens?: number;
     duration?: number;
 }
+/** Hard limits applied per task during execution. */
+export interface DagLimits {
+    /** Snippet (in chars) of each parent's output injected into a child's context. */
+    parent_context_chars: number;
+    /** Cap (in chars) on the captured output of a single task. */
+    task_output_chars: number;
+    /** Per-task timeout, used by AbortController. */
+    timeout_seconds: number;
+}
+/** complexity → model mapping. */
+export type DagModelMap = Record<Complexity, string>;
+/**
+ * Per-runner model mapping. Legacy flat schema is normalized into this form
+ * by the YAML parser.
+ */
+export type DagModels = Partial<Record<RunnerName, DagModelMap>>;
 export interface Dag {
     title: string;
     version: string;
-    models: Record<string, string>;
+    generated?: string;
+    limits?: DagLimits;
+    models: DagModels;
     tasks: DagTask[];
 }
+/** Defaults used when a YAML omits the `limits` block. */
+export declare const DEFAULT_DAG_LIMITS: DagLimits;
 export interface RunDagOptions {
     parallel: boolean;
-    runner: string;
+    runner: RunnerName | string;
     canvasPath: string;
+    /** When true, only PENDING/FAILED tasks run (DONE/SKIPPED are kept). */
+    resume?: boolean;
+    /** Restrict execution to a single task id. */
+    onlyTaskId?: string;
 }
 /**
- * Main DAG runner - executes tasks in parallel based on dependency ranks
+ * Execute the DAG. Tasks are statefully mutated in place: status, output,
+ * error, tokens and duration get filled in as execution progresses.
  */
 export declare function runDag(dag: Dag, options: RunDagOptions): Promise<void>;
+/**
+ * Compute execution ranks for tasks based on dependencies.
+ * Tasks in the same rank can run in parallel (Kahn's algorithm).
+ */
+export declare function computeRanks(tasks: DagTask[]): Map<string, number>;
 //# sourceMappingURL=run_dag.d.ts.map

package/dist/dag-runner/run_dag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_dag.d.ts","sourceRoot":"","sources":["../../src/dag-runner/run_dag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AA2FD;;GAEG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4F5E"}
+{"version":3,"file":"run_dag.d.ts","sourceRoot":"","sources":["../../src/dag-runner/run_dag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD5E;AAiMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BlE"}