codex-taskflow 0.1.0

package/dist/codex-runner.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Codex subagent runner — the Codex host's `SubagentRunner` implementation.
+ *
+ * Spawns an isolated `codex exec --json` process per task and folds its JSONL
+ * event stream into the same host-neutral `RunResult` the pi runner produces,
+ * so the engine (runtime.ts) treats a Codex subagent identically to a pi one.
+ *
+ * Real codex JSONL schema (codex-cli ≥ 0.142), observed empirically:
+ *   {"type":"thread.started","thread_id":"…"}
+ *   {"type":"turn.started"}
+ *   {"type":"item.started",  "item":{"id","type":"command_execution","command","status":"in_progress",…}}
+ *   {"type":"item.completed","item":{"id","type":"command_execution","command","exit_code","status":"completed",…}}
+ *   {"type":"item.completed","item":{"id","type":"agent_message","text":"…"}}   ← final answer
+ *   {"type":"item.completed","item":{"id","type":"error","message":"…"}}        ← warning OR fatal
+ *   {"type":"turn.completed","usage":{"input_tokens","cached_input_tokens","output_tokens","reasoning_output_tokens"}}
+ *
+ * Mapping to the pi contract:
+ *   - output      = text of the LAST `agent_message` item
+ *   - usage.input = input_tokens; usage.output = output_tokens + reasoning_output_tokens;
+ *     usage.cacheRead = cached_input_tokens; turns = number of `turn.completed`
+ *   - lastActivity for streaming = latest agent_message text or a one-line
+ *     command summary
+ *   - benign warnings (the "Under-development features" / "Skill descriptions"
+ *     notices) are NOT treated as failures — only a fatal error item or a
+ *     non-zero exit is.
+ *
+ * Process handling (idle watchdog, abort, signal-kill detection, stderr cap,
+ * error sanitization) mirrors the pi runner so behavior is uniform across hosts.
+ */
+import { type AgentConfig, type LiveUpdate, type RunOptions, type RunResult, type SubagentRunner, type UsageStats } from "taskflow-core";
+/** Accumulated state folded from a codex JSONL event stream. */
+export interface CodexAccumulator {
+    usage: UsageStats;
+    model?: string;
+    /** Final answer = text of the last agent_message item seen. */
+    finalText: string;
+    lastActivity: string;
+    /** Set when a fatal (non-benign) error item is seen. */
+    fatalError?: string;
+}
+export declare function newCodexAccumulator(model?: string): CodexAccumulator;
+/**
+ * Fold one codex JSONL line into the accumulator. Returns a LiveUpdate when the
+ * stream produced new activity (for streaming), else null. Empty/malformed
+ * lines are ignored — robust to partial buffers and noise, unit-testable
+ * without spawning a process.
+ */
+export declare function foldCodexEventLine(acc: CodexAccumulator, line: string): LiveUpdate | null;
+/**
+ * Run a single subagent task via `codex exec --json`. Resolves the agent from
+ * `agents` by name; returns the same structured `RunResult` the pi runner does.
+ */
+export declare function runCodexAgentTask(defaultCwd: string, agents: AgentConfig[], agentName: string, task: string, opts: RunOptions, globalThinking?: string): Promise<RunResult>;
+/**
+ * The Codex host's `SubagentRunner`. Drops into `RuntimeDeps.runTask` exactly
+ * like `piSubagentRunner`, so the engine runs unchanged on Codex.
+ */
+export declare const codexSubagentRunner: SubagentRunner<AgentConfig>;
+//# sourceMappingURL=codex-runner.d.ts.map

package/dist/codex-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-runner.d.ts","sourceRoot":"","sources":["../src/codex-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAKN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,MAAM,eAAe,CAAC;AAwBvB,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAEpE;AAOD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA+CzF;AAqBD;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS,CAAC,CA4KpB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,WAAW,CAE3D,CAAC"}

package/dist/codex-runner.js

@@ -0,0 +1,322 @@
+/**
+ * Codex subagent runner — the Codex host's `SubagentRunner` implementation.
+ *
+ * Spawns an isolated `codex exec --json` process per task and folds its JSONL
+ * event stream into the same host-neutral `RunResult` the pi runner produces,
+ * so the engine (runtime.ts) treats a Codex subagent identically to a pi one.
+ *
+ * Real codex JSONL schema (codex-cli ≥ 0.142), observed empirically:
+ *   {"type":"thread.started","thread_id":"…"}
+ *   {"type":"turn.started"}
+ *   {"type":"item.started",  "item":{"id","type":"command_execution","command","status":"in_progress",…}}
+ *   {"type":"item.completed","item":{"id","type":"command_execution","command","exit_code","status":"completed",…}}
+ *   {"type":"item.completed","item":{"id","type":"agent_message","text":"…"}}   ← final answer
+ *   {"type":"item.completed","item":{"id","type":"error","message":"…"}}        ← warning OR fatal
+ *   {"type":"turn.completed","usage":{"input_tokens","cached_input_tokens","output_tokens","reasoning_output_tokens"}}
+ *
+ * Mapping to the pi contract:
+ *   - output      = text of the LAST `agent_message` item
+ *   - usage.input = input_tokens; usage.output = output_tokens + reasoning_output_tokens;
+ *     usage.cacheRead = cached_input_tokens; turns = number of `turn.completed`
+ *   - lastActivity for streaming = latest agent_message text or a one-line
+ *     command summary
+ *   - benign warnings (the "Under-development features" / "Skill descriptions"
+ *     notices) are NOT treated as failures — only a fatal error item or a
+ *     non-zero exit is.
+ *
+ * Process handling (idle watchdog, abort, signal-kill detection, stderr cap,
+ * error sanitization) mirrors the pi runner so behavior is uniform across hosts.
+ */
+import { spawn } from "node:child_process";
+import { emptyUsage, isFailed, sanitizeErrorMessage, TRANSPORT_ERROR_PLACEHOLDER, } from "taskflow-core";
+const activeChildren = new Set();
+const killAll = () => {
+    for (const pid of activeChildren) {
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch { /* already dead */ }
+    }
+};
+process.on("exit", killAll);
+/** Same idle window as the pi runner: a child silent this long is wedged. */
+const DEFAULT_IDLE_TIMEOUT_MS = 5 * 60_000;
+/** Benign codex `error` items that are warnings, not failures. Matched as a
+ *  prefix/substring so version drift in the message tail still classifies. */
+const BENIGN_ERROR_MARKERS = [
+    "Under-development features",
+    "Skill descriptions were shortened",
+];
+function isBenignCodexError(message) {
+    return BENIGN_ERROR_MARKERS.some((m) => message.includes(m));
+}
+export function newCodexAccumulator(model) {
+    return { usage: emptyUsage(), model, finalText: "", lastActivity: "" };
+}
+function shortCmd(cmd) {
+    const s = String(cmd ?? "").replace(/\s+/g, " ").trim();
+    return s.length > 64 ? `${s.slice(0, 64)}…` : s;
+}
+/**
+ * Fold one codex JSONL line into the accumulator. Returns a LiveUpdate when the
+ * stream produced new activity (for streaming), else null. Empty/malformed
+ * lines are ignored — robust to partial buffers and noise, unit-testable
+ * without spawning a process.
+ */
+export function foldCodexEventLine(acc, line) {
+    if (!line.trim())
+        return null;
+    let event;
+    try {
+        event = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    let activity = "";
+    if (event.type === "turn.completed" && event.usage) {
+        const u = event.usage;
+        acc.usage.turns++;
+        acc.usage.input += u.input_tokens || 0;
+        acc.usage.output += (u.output_tokens || 0) + (u.reasoning_output_tokens || 0);
+        acc.usage.cacheRead += u.cached_input_tokens || 0;
+        acc.usage.contextTokens = (u.input_tokens || 0) + (u.output_tokens || 0);
+    }
+    else if (event.type === "item.completed" || event.type === "item.started") {
+        const item = event.item;
+        if (!item)
+            return null;
+        switch (item.type) {
+            case "agent_message":
+                if (typeof item.text === "string" && item.text.trim()) {
+                    // Final answer is the LAST agent_message; keep overwriting.
+                    if (event.type === "item.completed")
+                        acc.finalText = item.text;
+                    activity = item.text.trim();
+                }
+                break;
+            case "command_execution":
+                activity = `$ ${shortCmd(item.command)}`;
+                break;
+            case "error":
+                if (typeof item.message === "string" && !isBenignCodexError(item.message)) {
+                    acc.fatalError = item.message;
+                    activity = `error: ${item.message}`;
+                }
+                break;
+            default:
+                // file_change / reasoning / mcp_tool_call / etc. — note generically.
+                if (typeof item.type === "string")
+                    activity = item.type;
+        }
+    }
+    else {
+        return null; // thread.started / turn.started — nothing to fold.
+    }
+    if (activity)
+        acc.lastActivity = activity.replace(/\s+/g, " ").trim();
+    return { text: acc.lastActivity, usage: { ...acc.usage }, model: acc.model };
+}
+/** Override the codex binary (tests / unusual installs). */
+function codexBin() {
+    return process.env.PI_TASKFLOW_CODEX_BIN || "codex";
+}
+/**
+ * Map a phase's tool whitelist to a codex sandbox mode. Codex has no per-tool
+ * whitelist; it has sandbox policies. The conservative mapping: a phase that
+ * only reads (no write/edit/bash in its whitelist) gets `read-only`; anything
+ * else gets `workspace-write`. No whitelist → workspace-write (the engine's
+ * default-capable agent). `danger-full-access` is never selected automatically.
+ */
+function sandboxForTools(tools) {
+    if (!tools || tools.length === 0)
+        return "workspace-write";
+    const mutating = new Set(["write", "edit", "bash", "apply_patch"]);
+    const canMutate = tools.some((t) => mutating.has(t));
+    return canMutate ? "workspace-write" : "read-only";
+}
+/**
+ * Run a single subagent task via `codex exec --json`. Resolves the agent from
+ * `agents` by name; returns the same structured `RunResult` the pi runner does.
+ */
+export async function runCodexAgentTask(defaultCwd, agents, agentName, task, opts, globalThinking) {
+    const agent = agents.find((a) => a.name === agentName);
+    if (!agent) {
+        const available = agents.map((a) => `"${a.name}"`).join(", ") || "none";
+        return {
+            agent: agentName,
+            task,
+            exitCode: 1,
+            output: "",
+            stderr: `Unknown agent: "${agentName}". Available: ${available}.`,
+            usage: emptyUsage(),
+            errorMessage: `Unknown agent: ${agentName}`,
+            stopReason: "error",
+        };
+    }
+    const model = opts.model ?? agent.model;
+    const tools = opts.tools ?? agent.tools;
+    const sandbox = sandboxForTools(tools);
+    void globalThinking; // codex has no thinking-level flag on exec; reserved.
+    // codex exec [PROMPT] --json --skip-git-repo-check -s <sandbox> [-m model] [-C cwd]
+    // The agent's system prompt is prepended to the task as guidance, since
+    // `codex exec` has no separate append-system-prompt flag. We keep it compact.
+    const fullPrompt = agent.systemPrompt.trim()
+        ? `${agent.systemPrompt.trim()}\n\n---\n\nTask: ${task}`
+        : `Task: ${task}`;
+    const args = ["exec", "--json", "--skip-git-repo-check", "-s", sandbox];
+    if (model)
+        args.push("-m", model);
+    const cwd = opts.cwd ?? defaultCwd;
+    if (cwd)
+        args.push("-C", cwd);
+    args.push(fullPrompt);
+    const acc = newCodexAccumulator(model);
+    const result = {
+        agent: agentName,
+        task,
+        exitCode: 0,
+        output: "",
+        stderr: "",
+        usage: emptyUsage(),
+        model,
+    };
+    let wasAborted = false;
+    let idleTimedOut = false;
+    let killedBySignal;
+    const exitCode = await new Promise((resolve) => {
+        const proc = spawn(codexBin(), args, {
+            cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env },
+        });
+        if (proc.pid)
+            activeChildren.add(proc.pid);
+        let buffer = "";
+        let idleTimer;
+        let forceTimer;
+        const idleMs = opts.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        const clearTimers = () => {
+            if (idleTimer)
+                clearTimeout(idleTimer);
+            if (forceTimer)
+                clearTimeout(forceTimer);
+        };
+        const hardKill = () => {
+            idleTimedOut = true;
+            proc.kill("SIGTERM");
+            forceTimer = setTimeout(() => proc.kill("SIGKILL"), 5000);
+            forceTimer.unref();
+        };
+        const armIdle = () => {
+            if (idleTimer)
+                clearTimeout(idleTimer);
+            if (idleMs <= 0)
+                return;
+            idleTimer = setTimeout(hardKill, idleMs);
+            idleTimer.unref();
+        };
+        armIdle();
+        const processLine = (line) => {
+            const live = foldCodexEventLine(acc, line);
+            if (live && opts.onLive)
+                opts.onLive(live);
+        };
+        proc.stdout.on("data", (data) => {
+            armIdle();
+            buffer += data.toString();
+            const lines = buffer.split("\n");
+            buffer = lines.pop() || "";
+            for (const line of lines)
+                processLine(line);
+        });
+        const STDERR_MAX_LEN = 64 * 1024;
+        let stderrCapped = false;
+        proc.stderr.on("data", (data) => {
+            if (!stderrCapped) {
+                result.stderr += data.toString();
+                if (result.stderr.length >= STDERR_MAX_LEN) {
+                    result.stderr = result.stderr.slice(0, STDERR_MAX_LEN) + "\n[...stderr truncated at 64KB]";
+                    stderrCapped = true;
+                }
+            }
+        });
+        proc.on("close", (code, signal) => {
+            if (proc.pid)
+                activeChildren.delete(proc.pid);
+            clearTimers();
+            if (buffer.trim())
+                processLine(buffer);
+            if (code === null && signal)
+                killedBySignal = signal;
+            resolve(code ?? 0);
+        });
+        proc.on("error", (err) => {
+            clearTimers();
+            if (!result.stderr)
+                result.stderr = err.message;
+            if (!result.errorMessage)
+                result.errorMessage = err.message;
+            resolve(1);
+        });
+        if (opts.signal) {
+            const kill = () => {
+                wasAborted = true;
+                proc.kill("SIGTERM");
+                const forceKill = setTimeout(() => proc.kill("SIGKILL"), 5000);
+                forceKill.unref();
+            };
+            if (opts.signal.aborted)
+                kill();
+            else
+                opts.signal.addEventListener("abort", kill, { once: true });
+        }
+    });
+    result.exitCode = exitCode;
+    result.usage = acc.usage;
+    result.model = acc.model;
+    result.output = acc.finalText;
+    if (acc.fatalError) {
+        result.exitCode = result.exitCode || 1;
+        result.stopReason = "error";
+        result.errorMessage = acc.fatalError;
+    }
+    else {
+        result.stopReason = exitCode === 0 ? "end" : "error";
+    }
+    if (exitCode === 0 && killedBySignal && !idleTimedOut && !wasAborted) {
+        result.exitCode = 1;
+        result.stopReason = "error";
+        result.errorMessage = `Subagent killed by signal ${killedBySignal}`;
+    }
+    if (idleTimedOut) {
+        result.stopReason = "error";
+        result.idleTimeout = true;
+        result.errorMessage = `Subagent stalled: no output for ${Math.round((opts.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS) / 1000)}s (idle timeout) — killed`;
+    }
+    else if (wasAborted) {
+        result.stopReason = "aborted";
+        result.errorMessage = "Subagent was aborted";
+    }
+    if (isFailed(result)) {
+        if (!result.output) {
+            result.output = TRANSPORT_ERROR_PLACEHOLDER;
+            if (!result.errorMessage) {
+                result.errorMessage =
+                    result.stderr || `Subagent exited with code ${result.exitCode} (stopReason: ${result.stopReason ?? "unknown"})`;
+            }
+        }
+        if (result.errorMessage)
+            result.errorMessage = sanitizeErrorMessage(result.errorMessage);
+    }
+    return result;
+}
+/**
+ * The Codex host's `SubagentRunner`. Drops into `RuntimeDeps.runTask` exactly
+ * like `piSubagentRunner`, so the engine runs unchanged on Codex.
+ */
+export const codexSubagentRunner = {
+    runTask: runCodexAgentTask,
+};
+//# sourceMappingURL=codex-runner.js.map

package/dist/codex-runner.js.map

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

package/dist/mcp/bin.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Executable entry for the pi-taskflow MCP server.
+ *
+ * Register with Codex:
+ *   codex mcp add taskflow -- node --experimental-strip-types \
+ *     /abs/path/to/extensions/mcp/bin.ts
+ *
+ * (or point at a compiled .js). Codex then launches this as a stdio MCP server
+ * and the taskflow_* tools become available inside codex. The server discovers
+ * saved flows + agents from its launch cwd, and runs each subagent as a codex
+ * session, so no pi process is required.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/mcp/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/mcp/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/mcp/bin.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Executable entry for the pi-taskflow MCP server.
+ *
+ * Register with Codex:
+ *   codex mcp add taskflow -- node --experimental-strip-types \
+ *     /abs/path/to/extensions/mcp/bin.ts
+ *
+ * (or point at a compiled .js). Codex then launches this as a stdio MCP server
+ * and the taskflow_* tools become available inside codex. The server discovers
+ * saved flows + agents from its launch cwd, and runs each subagent as a codex
+ * session, so no pi process is required.
+ */
+import { startMcpServer } from "./server.js";
+startMcpServer(process.cwd())
+    .then(() => process.exit(0))
+    .catch((e) => {
+    // Never write non-JSON to stdout (it would corrupt the MCP stream); log to
+    // stderr and exit non-zero so the client sees the transport drop.
+    process.stderr.write(`pi-taskflow mcp server fatal: ${e instanceof Error ? e.stack ?? e.message : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/mcp/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/mcp/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;KAC3B,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAC3B,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACZ,2EAA2E;IAC3E,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/mcp/jsonrpc.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Minimal, dependency-free stdio JSON-RPC 2.0 transport for an MCP server.
+ *
+ * pi-taskflow ships ZERO runtime dependencies (a core selling point), so we do
+ * NOT pull in `@modelcontextprotocol/sdk`. MCP's stdio transport is just
+ * newline-delimited JSON-RPC 2.0 over stdin/stdout — small enough to implement
+ * on Node built-ins. This module handles framing + dispatch only; the MCP
+ * method semantics live in server.ts.
+ *
+ * Wire format: one JSON object per line on stdin (a request or notification),
+ * one JSON object per line on stdout (a response). Notifications (no `id`) get
+ * no response. Anything we can't parse is answered with a JSON-RPC parse error
+ * when an id is recoverable, else dropped (never crash the loop).
+ */
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** Standard JSON-RPC / MCP error codes we use. */
+export declare const RPC: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+};
+/** Thrown by a handler to return a structured JSON-RPC error to the client. */
+export declare class RpcError extends Error {
+    code: number;
+    data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/**
+ * A method handler. Return a JSON-serializable result, or throw `RpcError` for
+ * a structured failure. Returning `undefined` for a request (has id) sends
+ * `result: null`; for a notification it is ignored.
+ */
+export type RpcHandler = (params: unknown) => Promise<unknown> | unknown;
+/**
+ * Run a JSON-RPC stdio loop over the given streams (defaults to process
+ * stdin/stdout). Resolves when the input stream ends (client disconnect).
+ */
+export declare function serveStdio(handlers: Record<string, RpcHandler>, io?: {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}): Promise<void>;
+//# sourceMappingURL=jsonrpc.d.ts.map

package/dist/mcp/jsonrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/mcp/jsonrpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,kDAAkD;AAClD,eAAO,MAAM,GAAG;;;;;;CAMN,CAAC;AAEX,+EAA+E;AAC/E,qBAAa,QAAS,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;gBACH,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAMzD;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GACxE,OAAO,CAAC,IAAI,CAAC,CA+Ef"}

package/dist/mcp/jsonrpc.js

@@ -0,0 +1,118 @@
+/**
+ * Minimal, dependency-free stdio JSON-RPC 2.0 transport for an MCP server.
+ *
+ * pi-taskflow ships ZERO runtime dependencies (a core selling point), so we do
+ * NOT pull in `@modelcontextprotocol/sdk`. MCP's stdio transport is just
+ * newline-delimited JSON-RPC 2.0 over stdin/stdout — small enough to implement
+ * on Node built-ins. This module handles framing + dispatch only; the MCP
+ * method semantics live in server.ts.
+ *
+ * Wire format: one JSON object per line on stdin (a request or notification),
+ * one JSON object per line on stdout (a response). Notifications (no `id`) get
+ * no response. Anything we can't parse is answered with a JSON-RPC parse error
+ * when an id is recoverable, else dropped (never crash the loop).
+ */
+/** Standard JSON-RPC / MCP error codes we use. */
+export const RPC = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+};
+/** Thrown by a handler to return a structured JSON-RPC error to the client. */
+export class RpcError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = "RpcError";
+        this.code = code;
+        this.data = data;
+    }
+}
+/**
+ * Run a JSON-RPC stdio loop over the given streams (defaults to process
+ * stdin/stdout). Resolves when the input stream ends (client disconnect).
+ */
+export function serveStdio(handlers, io = {}) {
+    const input = io.input ?? process.stdin;
+    const output = io.output ?? process.stdout;
+    const write = (obj) => {
+        output.write(JSON.stringify(obj) + "\n");
+    };
+    const respondOk = (id, result) => {
+        write({ jsonrpc: "2.0", id, result: result === undefined ? null : result });
+    };
+    const respondErr = (id, err) => {
+        write({ jsonrpc: "2.0", id, error: err });
+    };
+    const handleLine = async (line) => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch {
+            // No recoverable id — per JSON-RPC, a parse error uses id:null.
+            respondErr(null, { code: RPC.PARSE_ERROR, message: "Parse error" });
+            return;
+        }
+        const isNotification = msg.id === undefined || msg.id === null;
+        const id = (msg.id ?? null);
+        if (msg.jsonrpc !== "2.0" || typeof msg.method !== "string") {
+            if (!isNotification)
+                respondErr(id, { code: RPC.INVALID_REQUEST, message: "Invalid Request" });
+            return;
+        }
+        const handler = handlers[msg.method];
+        if (!handler) {
+            // Unknown notifications are silently ignored (e.g. notifications/*).
+            if (!isNotification)
+                respondErr(id, { code: RPC.METHOD_NOT_FOUND, message: `Method not found: ${msg.method}` });
+            return;
+        }
+        try {
+            const result = await handler(msg.params);
+            if (!isNotification)
+                respondOk(id, result);
+        }
+        catch (e) {
+            if (isNotification)
+                return; // can't report errors for notifications
+            if (e instanceof RpcError) {
+                respondErr(id, { code: e.code, message: e.message, data: e.data });
+            }
+            else {
+                const message = e instanceof Error ? e.message : String(e);
+                respondErr(id, { code: RPC.INTERNAL_ERROR, message });
+            }
+        }
+    };
+    return new Promise((resolve) => {
+        let buffer = "";
+        // Serialize line handling so responses are emitted in request order even
+        // when handlers are async (MCP clients tolerate interleaving, but ordered
+        // output is simpler to reason about and test).
+        let chain = Promise.resolve();
+        input.on("data", (data) => {
+            buffer += data.toString();
+            let i;
+            while ((i = buffer.indexOf("\n")) >= 0) {
+                const line = buffer.slice(0, i);
+                buffer = buffer.slice(i + 1);
+                chain = chain.then(() => handleLine(line));
+            }
+        });
+        input.on("end", () => {
+            chain = chain.then(() => {
+                if (buffer.trim())
+                    return handleLine(buffer);
+            }).then(() => resolve());
+        });
+        input.on("close", () => resolve());
+    });
+}
+//# sourceMappingURL=jsonrpc.js.map

package/dist/mcp/jsonrpc.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * pi-taskflow as an MCP server for Codex (and any MCP client).
+ *
+ * Exposes the taskflow engine as MCP tools so a Codex user can declare and run
+ * verifiable task DAGs from inside codex — the mirror of codex-runner.ts (which
+ * lets taskflow *call* codex). Here taskflow is *called by* codex: each subagent
+ * a flow spawns is itself a `codex exec` process (via codexSubagentRunner), so
+ * the whole thing closes the loop with no pi process required.
+ *
+ * Protocol: MCP over stdio, JSON-RPC 2.0 (newline-delimited). Implemented on the
+ * dependency-free transport in ./jsonrpc.ts — pi-taskflow keeps its zero-runtime
+ * -deps guarantee; we do NOT use @modelcontextprotocol/sdk.
+ *
+ * Tools exposed:
+ *   - taskflow_run     : run an inline or saved flow, return the final output
+ *   - taskflow_list    : list saved flows discoverable in this cwd
+ *   - taskflow_show    : show a saved flow's definition
+ *   - taskflow_verify  : statically verify a flow (no execution)
+ *   - taskflow_compile : render a flow as a Mermaid diagram + verify report
+ */
+import { type RpcHandler } from "./jsonrpc.ts";
+/**
+ * Build the per-call tool handlers. `cwd` is the directory the server was
+ * launched in (where saved flows + agents are discovered, and where codex
+ * subagents run).
+ */
+export declare function makeToolHandlers(cwd: string): Record<string, (args: Record<string, unknown>) => Promise<unknown>>;
+/** Build the full MCP method dispatch table (protocol + tools). */
+export declare function makeMcpHandlers(cwd: string): Record<string, RpcHandler>;
+/** Start the stdio MCP server. Resolves when the client disconnects. */
+export declare function startMcpServer(cwd?: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AA0H1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CA+DjH;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA2BvE;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}

package/dist/mcp/server.js

@@ -0,0 +1,215 @@
+/**
+ * pi-taskflow as an MCP server for Codex (and any MCP client).
+ *
+ * Exposes the taskflow engine as MCP tools so a Codex user can declare and run
+ * verifiable task DAGs from inside codex — the mirror of codex-runner.ts (which
+ * lets taskflow *call* codex). Here taskflow is *called by* codex: each subagent
+ * a flow spawns is itself a `codex exec` process (via codexSubagentRunner), so
+ * the whole thing closes the loop with no pi process required.
+ *
+ * Protocol: MCP over stdio, JSON-RPC 2.0 (newline-delimited). Implemented on the
+ * dependency-free transport in ./jsonrpc.ts — pi-taskflow keeps its zero-runtime
+ * -deps guarantee; we do NOT use @modelcontextprotocol/sdk.
+ *
+ * Tools exposed:
+ *   - taskflow_run     : run an inline or saved flow, return the final output
+ *   - taskflow_list    : list saved flows discoverable in this cwd
+ *   - taskflow_show    : show a saved flow's definition
+ *   - taskflow_verify  : statically verify a flow (no execution)
+ *   - taskflow_compile : render a flow as a Mermaid diagram + verify report
+ */
+import { RpcError, RPC, serveStdio } from "./jsonrpc.js";
+import { codexSubagentRunner } from "../codex-runner.js";
+import { discoverAgents, executeTaskflow, getFlow, listFlows, compileTaskflow, verifyTaskflow, desugar, isShorthand, validateTaskflow, } from "taskflow-core";
+const PROTOCOL_VERSION = "2025-06-18";
+const SERVER_INFO = { name: "pi-taskflow", title: "pi-taskflow", version: "0.0.28" };
+/** MCP tools/call content block (text only — sufficient for our outputs). */
+function textContent(text, isError = false) {
+    return { content: [{ type: "text", text }], isError };
+}
+const TOOLS = [
+    {
+        name: "taskflow_run",
+        title: "Run a taskflow",
+        description: "Run a taskflow DAG and return its final output. Provide EITHER `name` (a saved flow) OR `define` (an inline flow definition: {name, phases:[…]} or a shorthand {task} / {tasks} / {chain}). Subagents execute as codex sessions. Intermediate phase outputs stay in the runtime; only the final phase output is returned.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                name: { type: "string", description: "Name of a saved flow to run." },
+                define: { type: "object", description: "Inline flow definition (full DAG or shorthand)." },
+                args: { type: "object", description: "Invocation arguments interpolated as {args.X}." },
+                incremental: { type: "boolean", description: "Default every phase to cross-run cache reuse." },
+            },
+        },
+    },
+    {
+        name: "taskflow_list",
+        title: "List saved taskflows",
+        description: "List the saved taskflows discoverable from the current working directory (user + project scope).",
+        inputSchema: { type: "object", additionalProperties: false, properties: {} },
+    },
+    {
+        name: "taskflow_show",
+        title: "Show a saved taskflow",
+        description: "Show a saved flow's full definition as JSON.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: { name: { type: "string", description: "Name of the saved flow." } },
+            required: ["name"],
+        },
+    },
+    {
+        name: "taskflow_verify",
+        title: "Verify a taskflow",
+        description: "Statically verify a flow (cycles, missing deps, undefined refs, …) WITHOUT executing it. Provide `name` or `define`.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                name: { type: "string" },
+                define: { type: "object" },
+            },
+        },
+    },
+    {
+        name: "taskflow_compile",
+        title: "Compile a taskflow to a diagram",
+        description: "Render a flow as a Mermaid flowchart + a static verification report (markdown). No execution. Provide `name` or `define`.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                name: { type: "string" },
+                define: { type: "object" },
+            },
+        },
+    },
+];
+/** Resolve a flow from params: inline `define` (desugared) or saved `name`. */
+function resolveFlow(cwd, params) {
+    if (params.define !== undefined && params.define !== null) {
+        return isShorthand(params.define) ? desugar(params.define) : params.define;
+    }
+    if (params.name) {
+        const saved = getFlow(cwd, params.name);
+        if (!saved)
+            throw new RpcError(RPC.INVALID_PARAMS, `No saved flow named "${params.name}" found from ${cwd}.`);
+        return saved.def;
+    }
+    throw new RpcError(RPC.INVALID_PARAMS, "Provide either `name` (a saved flow) or `define` (an inline flow).");
+}
+function mkRunState(def, args, cwd) {
+    return {
+        runId: `mcp-${def.name ?? "flow"}-${Date.now()}`,
+        flowName: def.name ?? "flow",
+        def,
+        args,
+        status: "running",
+        phases: {},
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+        cwd,
+    };
+}
+/**
+ * Build the per-call tool handlers. `cwd` is the directory the server was
+ * launched in (where saved flows + agents are discovered, and where codex
+ * subagents run).
+ */
+export function makeToolHandlers(cwd) {
+    return {
+        taskflow_run: async (args) => {
+            const def = resolveFlow(cwd, args);
+            const v = validateTaskflow(def);
+            if (!v.ok)
+                return textContent(`Flow is invalid:\n- ${v.errors.join("\n- ")}`, true);
+            const { agents } = discoverAgents(cwd, "both");
+            const deps = {
+                cwd,
+                agents,
+                runTask: codexSubagentRunner.runTask,
+            };
+            const state = mkRunState(def, args.args ?? {}, cwd);
+            if (args.incremental === true)
+                deps.cacheScopeDefault = "cross-run";
+            const res = await executeTaskflow(state, deps);
+            const header = res.ok ? "✓ taskflow complete" : "✗ taskflow did not fully succeed";
+            const usage = res.totalUsage;
+            const usageLine = `\n\n— usage: ${usage.turns} turns, in ${usage.input}, out ${usage.output}`;
+            return textContent(`${header}\n\n${res.finalOutput}${usageLine}`, !res.ok);
+        },
+        taskflow_list: async () => {
+            const flows = listFlows(cwd);
+            if (flows.length === 0)
+                return textContent("No saved taskflows found from this directory.");
+            const lines = flows.map((f) => `- ${f.name} (${f.scope}) — ${f.def.phases.length} phase(s)`);
+            return textContent(`Saved taskflows:\n${lines.join("\n")}`);
+        },
+        taskflow_show: async (args) => {
+            const name = String(args.name ?? "");
+            const saved = getFlow(cwd, name);
+            if (!saved)
+                return textContent(`No saved flow named "${name}".`, true);
+            return textContent("```json\n" + JSON.stringify(saved.def, null, 2) + "\n```");
+        },
+        taskflow_verify: async (args) => {
+            const def = resolveFlow(cwd, args);
+            // Two layers: validateTaskflow catches structural errors (cycles, missing
+            // deps, undefined refs); verifyTaskflow adds the deeper static-quality
+            // issues. Combine both so the tool matches the `/tf verify` behavior.
+            const val = validateTaskflow(def);
+            const result = verifyTaskflow(def);
+            const errors = result.issues.filter((i) => i.severity === "error");
+            const warnings = result.issues.filter((i) => i.severity === "warning");
+            const passed = val.ok && result.ok && errors.length === 0;
+            const ok = passed ? "✓ verification PASSED" : "✗ verification FAILED";
+            const fmt = (i) => `- ${i.category}${i.phaseId ? ` [${i.phaseId}]` : ""}: ${i.message}`;
+            const valErrs = val.errors.length ? `\n\nErrors:\n- ${val.errors.join("\n- ")}` : "";
+            const errs = errors.length ? `${valErrs ? "" : "\n\nErrors:"}\n${errors.map(fmt).join("\n")}` : "";
+            const allWarn = [...val.warnings.map((w) => `- ${w}`), ...warnings.map(fmt)];
+            const warns = allWarn.length ? `\n\nWarnings:\n${allWarn.join("\n")}` : "";
+            return textContent(`${ok}${valErrs}${errs}${warns}`, !passed);
+        },
+        taskflow_compile: async (args) => {
+            const def = resolveFlow(cwd, args);
+            const result = compileTaskflow(def);
+            return textContent(result.markdown, !result.verification.ok);
+        },
+    };
+}
+/** Build the full MCP method dispatch table (protocol + tools). */
+export function makeMcpHandlers(cwd) {
+    const tools = makeToolHandlers(cwd);
+    let initialized = false;
+    return {
+        initialize: () => {
+            initialized = true;
+            return {
+                protocolVersion: PROTOCOL_VERSION,
+                capabilities: { tools: { listChanged: false } },
+                serverInfo: SERVER_INFO,
+            };
+        },
+        // Client tells us it's ready — notification, no response.
+        "notifications/initialized": () => {
+            initialized = true;
+        },
+        ping: () => ({}),
+        "tools/list": () => ({ tools: TOOLS }),
+        "tools/call": async (params) => {
+            const p = (params ?? {});
+            const tool = tools[p.name ?? ""];
+            if (!tool)
+                throw new RpcError(RPC.INVALID_PARAMS, `Unknown tool: ${p.name}`);
+            void initialized; // tolerant: we don't hard-gate on initialize ordering
+            return await tool(p.arguments ?? {});
+        },
+    };
+}
+/** Start the stdio MCP server. Resolves when the client disconnects. */
+export function startMcpServer(cwd = process.cwd()) {
+    return serveStdio(makeMcpHandlers(cwd));
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "codex-taskflow",
+  "version": "0.1.0",
+  "description": "Run pi-taskflow on OpenAI Codex: a Codex subagent runner plus an MCP server that exposes taskflow_* tools to Codex users.",
+  "keywords": [
+    "codex",
+    "codex-cli",
+    "mcp",
+    "taskflow",
+    "orchestration",
+    "subagents",
+    "workflow"
+  ],
+  "license": "MIT",
+  "author": "heggria <bshengtao@gmail.com>",
+  "homepage": "https://github.com/heggria/pi-taskflow#readme",
+  "bugs": {
+    "url": "https://github.com/heggria/pi-taskflow/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heggria/pi-taskflow.git",
+    "directory": "packages/codex-taskflow"
+  },
+  "type": "module",
+  "main": "./dist/codex-runner.js",
+  "types": "./dist/codex-runner.d.ts",
+  "bin": {
+    "codex-taskflow-mcp": "./dist/mcp/bin.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "taskflow-core": "0.1.0"
+  }
+}