taskflow-core 0.1.0

package/dist/frontmatter.js

@@ -0,0 +1,107 @@
+/**
+ * Minimal YAML-frontmatter parser for agent `.md` files.
+ *
+ * Vendored so taskflow-core stays dependency-free (the host SDK's
+ * `parseFrontmatter` pulls in the `yaml` package). Agent frontmatter is flat
+ * `key: value` — scalars, quoted strings, comma lists, or inline `[a, b]`
+ * sequences — which is all this parser needs to support. Anything it can't
+ * parse degrades to a string value (the caller already tolerates that).
+ */
+const normalizeNewlines = (value) => value.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+function extract(content) {
+    const normalized = normalizeNewlines(content);
+    if (!normalized.startsWith("---"))
+        return { yamlString: null, body: normalized };
+    const endIndex = normalized.indexOf("\n---", 3);
+    if (endIndex === -1)
+        return { yamlString: null, body: normalized };
+    return {
+        yamlString: normalized.slice(4, endIndex),
+        body: normalized.slice(endIndex + 4).trim(),
+    };
+}
+/** Strip one layer of matching quotes. */
+function unquote(s) {
+    const t = s.trim();
+    if (t.length >= 2 && ((t[0] === '"' && t.at(-1) === '"') || (t[0] === "'" && t.at(-1) === "'"))) {
+        return t.slice(1, -1);
+    }
+    return t;
+}
+/** Parse a scalar value, an inline `[a, b]` sequence, or a quoted string. */
+function parseValue(raw) {
+    const v = raw.trim();
+    if (v === "")
+        return "";
+    // Inline flow sequence: [a, b, c]
+    if (v.startsWith("[") && v.endsWith("]")) {
+        const inner = v.slice(1, -1).trim();
+        if (!inner)
+            return [];
+        return inner.split(",").map((x) => unquote(x)).filter((x) => x.length > 0);
+    }
+    // Booleans / null kept as their YAML meaning so the caller can reject them.
+    if (v === "true")
+        return true;
+    if (v === "false")
+        return false;
+    if (v === "null" || v === "~")
+        return null;
+    return unquote(v);
+}
+/**
+ * Parse frontmatter from a markdown file. Returns `{ frontmatter, body }`.
+ * Lines that aren't `key: value` (e.g. block sequences) are skipped; the caller
+ * only relies on flat keys.
+ */
+export function parseFrontmatter(content) {
+    const { yamlString, body } = extract(content);
+    if (!yamlString)
+        return { frontmatter: {}, body };
+    const frontmatter = {};
+    const lines = yamlString.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        // Block sequence item (`- value`) is consumed by its parent key below.
+        if (trimmed.startsWith("- "))
+            continue;
+        const colon = trimmed.indexOf(":");
+        if (colon === -1)
+            continue;
+        const key = trimmed.slice(0, colon).trim();
+        if (!key)
+            continue;
+        const rest = trimmed.slice(colon + 1).trim();
+        if (rest === "") {
+            // Possibly a block sequence: collect following `- item` lines.
+            const items = [];
+            let j = i + 1;
+            for (; j < lines.length; j++) {
+                const next = lines[j];
+                const nt = next.trim();
+                if (nt === "" || nt.startsWith("#"))
+                    continue;
+                if (next.match(/^\s+-\s/)) {
+                    items.push(unquote(nt.replace(/^-\s*/, "")));
+                }
+                else
+                    break;
+            }
+            if (items.length > 0) {
+                frontmatter[key] = items.filter((x) => x.length > 0);
+                i = j - 1; // skip consumed sequence lines
+            }
+            else {
+                frontmatter[key] = "";
+            }
+            continue;
+        }
+        frontmatter[key] = parseValue(rest);
+    }
+    return { frontmatter, body };
+}
+export const stripFrontmatter = (content) => parseFrontmatter(content).body;
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/host/runner-types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Host-neutral subagent execution contract.
+ *
+ * This is the seam that lets pi-taskflow's engine run on any host (pi, Codex,
+ * …) without knowing how a subagent is actually spawned. The engine
+ * (`runtime.ts`) only ever talks to a `SubagentRunner`; each host ships one
+ * concrete implementation:
+ *
+ *   - pi    → `piSubagentRunner`  (spawns `pi --mode json -p …`, in runner.ts)
+ *   - codex → `codexSubagentRunner` (spawns `codex exec --json …`, future)
+ *
+ * The data types here (`RunResult`, `RunOptions`, `LiveUpdate`) are
+ * deliberately host-agnostic: they describe *what* a subagent run produces, not
+ * *how* it was produced. Nothing in this file imports a host SDK.
+ *
+ * `runner.ts` re-exports these types so every existing
+ * `import { RunResult, RunOptions, … } from "./runner.ts"` keeps working
+ * unchanged — this file is purely additive.
+ */
+import type { UsageStats } from "../usage.ts";
+/**
+ * Minimal structural `Message` shape the core parser needs. Vendored (instead of
+ * importing `@earendil-works/pi-ai`) so `taskflow-core` stays host-SDK-free. A
+ * host whose subagent emits richer messages can pass them through — only these
+ * fields are read structurally; everything else is accessed defensively.
+ */
+export interface CoreMessagePart {
+    type: string;
+    text?: string;
+    name?: string;
+    arguments?: Record<string, unknown>;
+}
+export interface CoreMessage {
+    role: string;
+    content: CoreMessagePart[];
+    [k: string]: unknown;
+}
+/** The structured outcome of a single subagent run, independent of host. */
+export interface RunResult {
+    agent: string;
+    task: string;
+    exitCode: number;
+    output: string;
+    stderr: string;
+    usage: UsageStats;
+    model?: string;
+    stopReason?: string;
+    errorMessage?: string;
+    /** Total subagent attempts incl. retries (set by the runtime's retry wrapper). */
+    attempts?: number;
+    /** Set when the subagent was killed by the idle watchdog (not a user abort). */
+    idleTimeout?: boolean;
+}
+/** A streaming progress tick from a running subagent. */
+export interface LiveUpdate {
+    /** Latest assistant text or tool activity (single-line, truncated upstream). */
+    text: string;
+    usage: UsageStats;
+    model?: string;
+}
+/** Per-run knobs the engine passes to whichever host runner executes the task. */
+export interface RunOptions {
+    model?: string;
+    thinking?: string;
+    tools?: string[];
+    cwd?: string;
+    signal?: AbortSignal;
+    /** Fires on each assistant turn with the latest activity + accumulated usage. */
+    onLive?: (live: LiveUpdate) => void;
+    /**
+     * Idle watchdog: if the subagent produces no output for this many ms, it is
+     * considered stalled (hung stream / provider stall / tool deadlock) and is
+     * killed. Resets on every output chunk. 0/undefined keeps the host default.
+     */
+    idleTimeoutMs?: number;
+    /**
+     * Shared Context Tree (opt-in). When set, the spawned subagent is given the
+     * blackboard dir + node id so it can register the ctx_* tools (read/write/
+     * report/spawn). A host that cannot inject these may ignore them (fail-open:
+     * context sharing simply degrades to "no sharing").
+     */
+    ctxDir?: string;
+    nodeId?: string;
+}
+/**
+ * The minimal contract a host must satisfy to execute taskflow subagents.
+ *
+ * `agents` is the resolved agent roster (name → model/prompt/tools); the runner
+ * looks up `agentName` in it. `globalThinking` is the flow-level default applied
+ * when neither the per-phase opts nor the agent frontmatter set a thinking
+ * level. A runner MUST resolve a successful run to a `RunResult` (never throw
+ * for an ordinary subagent failure) — set `exitCode`/`stopReason`/`errorMessage`
+ * instead, so the engine's retry and fail-soft logic can act on it.
+ */
+export interface SubagentRunner<TAgent = unknown> {
+    runTask(defaultCwd: string, agents: TAgent[], agentName: string, task: string, opts: RunOptions, globalThinking?: string): Promise<RunResult>;
+}
+//# sourceMappingURL=runner-types.d.ts.map

package/dist/host/runner-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-types.d.ts","sourceRoot":"","sources":["../../src/host/runner-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AACD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IAC1B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC/C,OAAO,CACN,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS,CAAC,CAAC;CACtB"}

package/dist/host/runner-types.js

@@ -0,0 +1,21 @@
+/**
+ * Host-neutral subagent execution contract.
+ *
+ * This is the seam that lets pi-taskflow's engine run on any host (pi, Codex,
+ * …) without knowing how a subagent is actually spawned. The engine
+ * (`runtime.ts`) only ever talks to a `SubagentRunner`; each host ships one
+ * concrete implementation:
+ *
+ *   - pi    → `piSubagentRunner`  (spawns `pi --mode json -p …`, in runner.ts)
+ *   - codex → `codexSubagentRunner` (spawns `codex exec --json …`, future)
+ *
+ * The data types here (`RunResult`, `RunOptions`, `LiveUpdate`) are
+ * deliberately host-agnostic: they describe *what* a subagent run produces, not
+ * *how* it was produced. Nothing in this file imports a host SDK.
+ *
+ * `runner.ts` re-exports these types so every existing
+ * `import { RunResult, RunOptions, … } from "./runner.ts"` keeps working
+ * unchanged — this file is purely additive.
+ */
+export {};
+//# sourceMappingURL=runner-types.js.map

package/dist/host/runner-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-types.js","sourceRoot":"","sources":["../../src/host/runner-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * taskflow-core — the host-neutral engine.
+ *
+ * Barrel of everything the pi / codex adapters consume. The engine has no host
+ * SDK dependency: schema (DSL + validation), runtime (DAG execution), cache,
+ * interpolation, verification, the FlowIR compile seam, the shared context tree,
+ * agent discovery, persistence, and the host-neutral SubagentRunner contract.
+ *
+ * Adapters inject their own subagent runner via `RuntimeDeps.runTask`.
+ */
+export * from "./schema.ts";
+export * from "./runtime.ts";
+export * from "./cache.ts";
+export * from "./interpolate.ts";
+export * from "./verify.ts";
+export * from "./usage.ts";
+export * from "./stale.ts";
+export * from "./workspace.ts";
+export * from "./context-store.ts";
+export * from "./compile.ts";
+export * from "./store.ts";
+export * from "./agents.ts";
+export * from "./runner-core.ts";
+export * from "./host/runner-types.ts";
+export * from "./flowir/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAK7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+/**
+ * taskflow-core — the host-neutral engine.
+ *
+ * Barrel of everything the pi / codex adapters consume. The engine has no host
+ * SDK dependency: schema (DSL + validation), runtime (DAG execution), cache,
+ * interpolation, verification, the FlowIR compile seam, the shared context tree,
+ * agent discovery, persistence, and the host-neutral SubagentRunner contract.
+ *
+ * Adapters inject their own subagent runner via `RuntimeDeps.runTask`.
+ */
+export * from "./schema.js";
+export * from "./runtime.js";
+export * from "./cache.js";
+export * from "./interpolate.js";
+export * from "./verify.js";
+export * from "./usage.js";
+export * from "./stale.js";
+export * from "./workspace.js";
+export * from "./context-store.js";
+export * from "./compile.js";
+// NOTE: detached-runner.ts is intentionally NOT re-exported — it is a spawn-only
+// entry point with top-level argv parsing + process.exit. Importing it via the
+// barrel would run that entry on every `import` of taskflow-core. The pi adapter
+// spawns it directly by file path.
+export * from "./store.js";
+export * from "./agents.js";
+export * from "./runner-core.js";
+export * from "./host/runner-types.js";
+export * from "./flowir/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC"}

package/dist/interpolate.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Template interpolation for taskflow tasks.
+ *
+ * Supported placeholders:
+ *   {args.X}            invocation argument
+ *   {steps.ID.output}   prior phase final output (string)
+ *   {steps.ID.json}     prior phase output parsed as JSON (stringified back if object)
+ *   {previous.output}   alias for the immediately-preceding completed phase output
+ *   {item} / {item.f}   map loop variable (or custom name via phase.as)
+ *
+ * Unknown placeholders are left intact rather than throwing, so a
+ * partially-specified task still runs. The unresolved refs are returned in
+ * `missing[]`; the runtime surfaces them as a phase warning (see
+ * `warnUnresolvedRefs` in runtime.ts) — logged and persisted to
+ * `PhaseState.warnings`.
+ */
+export interface InterpolationContext {
+    args: Record<string, unknown>;
+    steps: Record<string, {
+        output: string;
+        json?: unknown;
+    }>;
+    previousOutput?: string;
+    /** loop variable bindings, e.g. { item: {...} } */
+    locals?: Record<string, unknown>;
+    /** Observed-read hook (M3): invoked once per successfully-resolved
+     *  placeholder path, so the runtime can capture which upstream phases a
+     *  phase actually consumed (its observed readSet). Unresolved refs do NOT
+     *  fire it (they become `missing` warnings instead). Default undefined →
+     *  zero overhead, fully backward-compatible. */
+    onRead?: (ref: string) => void;
+}
+export interface InterpolationResult {
+    text: string;
+    missing: string[];
+}
+export declare function interpolate(template: string | null | undefined, ctx: InterpolationContext): InterpolationResult;
+export declare function safeParse(text: string): unknown;
+/** Coerce a parsed value into an array for map fan-out. */
+export declare function coerceArray(value: unknown): unknown[] | null;
+/**
+ * Evaluate a `when` expression to a boolean. Returns `{ value, error }`.
+ * Parse errors set `error` and fail OPEN (`value: true`) so a broken guard
+ * never silently drops a phase.
+ */
+export declare function tryEvaluateCondition(expr: string, ctx: InterpolationContext): {
+    value: boolean;
+    error?: string;
+};
+/** Boolean convenience wrapper over {@link tryEvaluateCondition}. */
+export declare function evaluateCondition(expr: string, ctx: InterpolationContext): boolean;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../src/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;;oDAIgD;IAChD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAID,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,GAAG,EAAE,oBAAoB,GACvB,mBAAmB,CAarB;AAkFD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA8D/C;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAU5D;AA8ND;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,oBAAoB,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAWpC;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAElF"}