taskflow-mcp-core 0.1.6

package/dist/mcp/jsonrpc.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Minimal, dependency-free stdio JSON-RPC 2.0 transport for an MCP server.
+ *
+ * taskflow-core 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.
+ *
+ * taskflow-core 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,38 @@
+/**
+ * taskflow as an MCP server (host-neutral core).
+ *
+ * Exposes the taskflow engine as MCP tools so an MCP host (Codex, Claude Code,
+ * or any MCP client) can declare and run verifiable task DAGs from inside its
+ * own session. Each host adapter binds this server to its own `SubagentRunner`
+ * (codex → `codex exec` subagents, claude → `claude -p` subagents), 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 — taskflow-core keeps its zero-
+ * runtime-deps guarantee; we do NOT use @modelcontextprotocol/sdk.
+ *
+ * This module is intentionally NOT in the barrel (index.ts) — hosts import it
+ * via the `taskflow-mcp` package (it is NOT re-exported from taskflow-core.
+ *
+ * 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 DAG diagram (SVG image) + status line
+ *   - taskflow_peek    : inspect a stored run's intermediate phase output
+ */
+import { type RpcHandler } from "./jsonrpc.ts";
+import type { SubagentRunner, AgentConfig } from "taskflow-core";
+/**
+ * Build the per-call tool handlers. `cwd` is the directory the server was
+ * launched in (where saved flows + agents are discovered, and where subagents
+ * run). `runner` is the host's SubagentRunner (codex/claude) — each phase's
+ * subagent executes through it.
+ */
+export declare function makeToolHandlers(cwd: string, runner: SubagentRunner<AgentConfig>): Record<string, (args: Record<string, unknown>) => Promise<unknown>>;
+/** Build the full MCP method dispatch table (protocol + tools). */
+export declare function makeMcpHandlers(cwd: string, runner: SubagentRunner<AgentConfig>): Record<string, RpcHandler>;
+/** Start the stdio MCP server. Resolves when the client disconnects. */
+export declare function startMcpServer(runner: SubagentRunner<AgentConfig>, 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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AA+B1E,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA8PjE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAuOrE;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA2B5G;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9G"}