@dalmasonto/taskflow-mcp 1.0.33 → 2.0.0

package/dist/runtime.js

@@ -0,0 +1,321 @@
+/**
+ * Everything that runs ONCE THERE IS A LIVE SESSION: the agent event stream
+ * (message delivery, prompt replay, terminal keys) and the tmux pane mirror.
+ *
+ * Extracted from `index.ts` because two callers need it — the bin entry at
+ * startup, and `select_profile` once a human has chosen an identity — and
+ * because a 170-line closure inside a bin entry is not a unit anyone can
+ * reason about.
+ *
+ * The pane is optional. Without one there is nothing to mirror and nowhere to
+ * type a message, so only the parts that need a pane are skipped; the session
+ * itself is already live and `check_messages` still works.
+ *
+ * It also holds the STARTUP entry (`startAgent`) and the two ways in — the bin
+ * entry at boot, and `select_profile` once a human has chosen an identity — so
+ * both take exactly the same path to a live agent.
+ */
+import { formatIncoming, shouldDeliver, startAgentEventStream } from "./events.js";
+import { detectTmuxPane, notifyPane, sendKeySteps, sendKeyToPane, startMirrorLoop, } from "./tmux.js";
+import { createSerialQueue } from "./pane-queue.js";
+import { stepsForPrompt } from "./prompts.js";
+import { resolveMessage } from "./resolve.js";
+import { findConfigPath, loadConfigFile, resolveProfileOrAsk, } from "./config.js";
+import { readStickyProfile, writeStickyProfile } from "./sessions-store.js";
+import { setNeedsProfile, startConnection } from "./connect.js";
+import { reportMirror } from "./mirror.js";
+const stderrLog = (line) => void process.stderr.write(`taskflow-mcp: ${line}\n`);
+/**
+ * Adapt the client to {@link MessageSource}.
+ *
+ * `MessagesPage.messages` is `unknown[]` — the client deliberately does not
+ * model every row shape — so the narrowing happens here, once, at the boundary
+ * rather than inside the resolver.
+ */
+function messageSourceFor(client) {
+    return {
+        listChannels: () => client.listChannels(),
+        listMessages: (params) => client.listMessages(params),
+    };
+}
+/**
+ * Attach the event stream (and, with a pane, the terminal mirror) to a live
+ * session.
+ *
+ * Returns a teardown that detaches BOTH. A profile switch must be able to call
+ * it: the mirror keeps calling `appendFrame(oldSession, …)` every couple of
+ * seconds and the backend reads a frame as proof of life, so an abandoned
+ * runtime keeps the OLD identity online in the dashboard however thoroughly its
+ * heartbeat was stopped — and its SSE stream keeps delivering that identity's
+ * DMs into this pane and marking them read as it. Idempotent.
+ */
+export function startAgentRuntime(ctx, log) {
+    const { client, session, profile, pane } = ctx;
+    if (pane)
+        log(`mirroring tmux pane ${pane}`);
+    // Every write to the pane — message delivery, prompt replay, terminal
+    // keys — goes through this ONE serial queue. The event stream dispatches
+    // handlers fire-and-forget, so without serialization two writes that land
+    // together interleave their `send-keys <text>` / `send-keys Enter` steps
+    // and one message's Enter submits another's text (see pane-queue.ts).
+    const paneQueue = createSerialQueue();
+    // Deliver ONE message to the pane, resolving it by id (chat is id-only on
+    // the wire). Shared by the live stream and the reconnect catch-up so both
+    // apply the same shouldDeliver + notify + mark-read. The pane write itself
+    // is serialized; the resolve/markRead round-trips stay outside the lock so
+    // network latency doesn't stall other deliveries.
+    //
+    // Without a pane there is nowhere to type it, so we stop BEFORE markRead: the
+    // read cursor means "the agent has seen this", and nothing saw it.
+    // `check_messages` defaults to unread_only, so advancing the cursor here
+    // would drop the message for good (see planning/spec-message-delivery.md) —
+    // leaving it unread is what makes `check_messages` still work.
+    const deliverMessageById = async (id, edited = false) => {
+        const message = await resolveMessage(messageSourceFor(client), id);
+        if (!message)
+            return;
+        if (!shouldDeliver(message, profile.agentId))
+            return;
+        if (!pane)
+            return;
+        await paneQueue(() => notifyPane(formatIncoming(message, message.attachments ?? [], profile.agentId, edited), pane, true));
+        // For an edit of an already-read message this is a no-op — the cursor only
+        // ever moves forward — which is exactly right: redelivery is a notice, not
+        // new unread state.
+        await client.markRead(message.channel, message.id);
+    };
+    // On RE-connect, deliver anything that arrived while the stream was down.
+    // The live push is at-most-once and never redelivers, so a message sent
+    // during a backend/session restart would otherwise only surface via a
+    // manual check_messages — the "messages aren't coming" gap. Delivering
+    // unread (oldest first) closes it; already-delivered messages are past the
+    // read cursor, so they are not repeated.
+    const catchUpUnread = async () => {
+        // Nowhere to deliver, and `deliverMessageById` would drop every one of
+        // them anyway — so fetching the backlog is pure cost. `check_messages`
+        // still surfaces them on demand, which is the whole point of leaving
+        // them unread.
+        if (!pane)
+            return;
+        try {
+            const channels = await client.listChannels();
+            const ids = [];
+            for (const channel of channels) {
+                const page = await client.listMessages({ channel: channel.id, unread: true });
+                for (const row of page.messages) {
+                    if (typeof row.id === "number")
+                        ids.push(row.id);
+                }
+            }
+            ids.sort((a, b) => a - b);
+            if (ids.length) {
+                log(`reconnect catch-up — ${ids.length} missed message(s)`);
+            }
+            for (const id of ids) {
+                try {
+                    await deliverMessageById(id);
+                }
+                catch (err) {
+                    log(`catch-up could not deliver ${id} (${err.message.split("\n")[0]})`);
+                }
+            }
+        }
+        catch (err) {
+            log(`reconnect catch-up failed (${err.message.split("\n")[0]})`);
+        }
+    };
+    // Instant delivery: hold the event stream open and write each incoming
+    // message straight into the pane. Polling would make a message as slow to
+    // arrive as the capture interval, which is what "messages don't appear in
+    // the terminal" actually was.
+    const events = startAgentEventStream({
+        server: profile.server,
+        key: profile.key,
+        log,
+        // Deliver messages missed while the stream was down (see catchUpUnread).
+        onReconnect: catchUpUnread,
+        // A human answered a question the agent is blocked on: press the keys.
+        onPromptAnswered: async (prompt) => {
+            // No pane, no keyboard to replay the answer on.
+            if (!pane)
+                return;
+            // A prompt may carry SEVERAL questions, each with its own kind, and
+            // the terminal shows them one at a time. stepsForPrompt replays them
+            // in order and returns nothing at all for a half-answered set —
+            // leftover digits would land on whichever screen came next. A
+            // free-text "Other" answer becomes a text step typed into the field.
+            const steps = stepsForPrompt(prompt.options_json ?? "", prompt.kind, prompt.question, prompt.answer_json, prompt.answer, prompt.answer_text_json ?? null, prompt.status === "cancelled" ? "cancel" : "submit");
+            if (!steps.length)
+                return;
+            try {
+                // Paced, not a tight loop: Claude Code's multi-select drops
+                // keystrokes that arrive while it is re-rendering a toggle.
+                // Serialized with message delivery so an incoming message can't type
+                // itself into the middle of this answer's key sequence.
+                await paneQueue(() => sendKeySteps(steps, pane));
+                log(`answered prompt ${prompt.id} with ${steps.length} step(s)`);
+            }
+            catch (err) {
+                log(`could not answer prompt ${prompt.id} (${err.message.split("\n")[0]})`);
+            }
+        },
+        onMessage: async (event, action) => {
+            // The event carries the row id and NOTHING else — chat is id-only on
+            // the wire (its group is per-project while its rows are channel-
+            // scoped, see resolve.ts). deliverMessageById fetches the body/sender/
+            // attachments back over the authorized read API, applies shouldDeliver
+            // (a message this agent cannot see, or its own, is skipped), types it
+            // into the pane, and advances the read cursor. An "updated" action is
+            // an edit (#107), delivered with an EDITED framing so the agent
+            // continues from the revised content rather than treating it as new.
+            try {
+                await deliverMessageById(event.id, action === "updated");
+            }
+            catch (err) {
+                log(`could not deliver message ${event.id} (${err.message.split("\n")[0]})`);
+            }
+        },
+        // A human pressed a key in the dashboard terminal. The event is broadcast
+        // to the whole project, so act only on keys addressed to THIS agent's
+        // pane; send-keys types it as a key NAME (not the literal word).
+        onTerminalKey: async (input) => {
+            // No pane, nothing to send the key to.
+            if (!pane)
+                return;
+            if (input.agent !== profile.agentId)
+                return;
+            try {
+                await paneQueue(() => sendKeyToPane(input.keys, pane));
+                log(`terminal key "${input.keys}" → pane ${pane}`);
+            }
+            catch (err) {
+                log(`could not send key "${input.keys}" (${err.message.split("\n")[0]})`);
+            }
+        },
+    });
+    // TASKFLOW_MIRROR=off suppresses the MIRROR only — never the connection. The
+    // agent still registers, heartbeats and receives messages; it just doesn't
+    // stream its terminal. (Before Task 6 this flag gated the whole startup, so
+    // turning off the mirror also took the agent offline.)
+    let stopMirror = null;
+    if (pane && process.env.TASKFLOW_MIRROR !== "off") {
+        stopMirror = startMirrorLoop({
+            client,
+            session,
+            target: pane,
+            log,
+            // The mirror talks to the backend every couple of seconds, so it notices a
+            // restart long before the stream's idle watchdog would. Hand that over
+            // rather than making the stream wait for silence to accumulate.
+            onError: (err) => {
+                if (/network error|fetch failed|ECONNREFUSED/i.test(err.message)) {
+                    events.reconnectNow();
+                }
+            },
+        });
+        // Publish what `whoami` reports. Since the mirror moved here, this module —
+        // not `startMirrorWithRetry` — is the only thing that knows the answer.
+        reportMirror({ state: "active", pane, attempts: 1 });
+    }
+    else {
+        reportMirror({
+            state: "off",
+            detail: pane ? "TASKFLOW_MIRROR=off" : "not running inside tmux — nothing to mirror",
+            attempts: 0,
+        });
+    }
+    let stopped = false;
+    return () => {
+        // Idempotent: the caller may tear down a runtime it already replaced, and
+        // stopping a mirror twice must not be an error worth thinking about.
+        if (stopped)
+            return;
+        stopped = true;
+        // Mirror first: it is what keeps a stale identity showing as online (the
+        // backend counts appended terminal frames as proof of life), and this
+        // teardown is idempotent-gated — if `events.stop()` threw first, the
+        // mirror would never stop and this function could not be retried.
+        stopMirror?.();
+        stopMirror = null;
+        events.stop();
+    };
+}
+/**
+ * Bring this agent online: resolve which identity this terminal is, then
+ * connect and start the runtime. When the repo defines several identities and
+ * nothing says which one this is, connect NOTHING and record `needs_profile` —
+ * guessing would silently collapse two terminals into one agent.
+ *
+ * Deliberately NOT conditional on tmux: registering a session is what makes the
+ * agent visible and reachable, and that must happen whether or not there is a
+ * pane to mirror.
+ */
+export async function startAgent(options = {}) {
+    const configPath = options.configPath ?? findConfigPath();
+    const config = loadConfigFile(configPath);
+    const pane = await detectTmuxPane().catch(() => null);
+    const sticky = readStickyProfile({ configPath, pane });
+    const resolution = resolveProfileOrAsk(config, { env: process.env, configPath, sticky });
+    if (resolution.kind === "ambiguous") {
+        const names = resolution.profiles.map((p) => p.name).join(", ");
+        setNeedsProfile(`${resolution.profiles.length} profiles defined (${names}); waiting for select_profile`);
+        stderrLog(`multiple identities (${names}) — the agent must ask its human, then call select_profile`);
+        return;
+    }
+    connectAs(resolution.profile, pane);
+}
+/** The live connection, so a profile switch can stop the one it replaces. */
+let current = null;
+/** Its runtime (event stream + mirror), which must go down with it. */
+let currentRuntime = null;
+/**
+ * Which `connectAs` call owns the slots above.
+ *
+ * `onSession` fires whenever registration finally succeeds — which, with the
+ * backend down, can be minutes after a newer `connectAs` superseded this one.
+ * Without the token that late callback would overwrite the LIVE runtime's
+ * teardown with a stale one, and the next switch would tear down the wrong
+ * mirror while leaving the old one streaming. Same ownership rule as
+ * `connect.ts`'s status.
+ */
+let runtimeOwner;
+/**
+ * Connect as a known profile and start the runtime. Used by `select_profile`.
+ *
+ * Nothing is awaited: `startConnection`'s `settled` stays pending for as long as
+ * the backend is down, so awaiting it here would keep the MCP server from
+ * serving a single tool call until the backend came up.
+ */
+export function connectAs(profile, pane) {
+    // A profile switch must not leave the old identity heartbeating: its session
+    // row would stay `connected` and the dashboard would show one agent twice.
+    // Stopping the heartbeat is not enough on its own — the old runtime's mirror
+    // keeps the row live by appending frames — so its runtime goes with it.
+    current?.stop();
+    currentRuntime?.();
+    currentRuntime = null;
+    const token = {};
+    runtimeOwner = token;
+    current = startConnection({
+        profile,
+        pane,
+        log: stderrLog,
+        onSession: (ctx) => {
+            const teardown = startAgentRuntime(ctx, stderrLog);
+            // Superseded while this connection was still registering: attach nothing
+            // and take it straight back down.
+            if (runtimeOwner !== token) {
+                teardown();
+                return;
+            }
+            currentRuntime = teardown;
+        },
+    });
+}
+/** Persist a human's pick for this terminal, then connect as it. */
+export async function selectProfile(profile) {
+    const pane = await detectTmuxPane().catch(() => null);
+    writeStickyProfile(profile.profileName, { configPath: profile.configPath, pane });
+    connectAs(profile, pane);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The TaskFlow MCP server (stdio transport).
+ *
+ * Loads `.taskflow.json` once, then registers one tool per meaningful agent
+ * operation. Each tool validates its arguments with zod, resolves a profile
+ * (per-call `profile` arg > `TASKFLOW_PROFILE` > `default_profile` > `main`),
+ * builds a {@link TaskflowClient} for that profile, calls the backend, and
+ * returns a concise text/JSON result. Errors are returned as tool errors
+ * (`isError: true`) with the backend's detail — never thrown out of the tool.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ProfileChoice } from "./config.js";
+import { type AgentSummary } from "./client.js";
+/**
+ * The refusal returned instead of guessing an identity.
+ *
+ * The server cannot prompt a human — MCP has no such primitive — but it can
+ * return a machine-readable refusal naming the exact follow-up call that
+ * resolves it. This is the typed-error equivalent for a protocol with no
+ * interaction primitive.
+ */
+export declare function ambiguityRefusal(profiles: ProfileChoice[]): string;
+/** Whether a roster row describes an agent that is live right now. */
+export declare function isLiveAgentStatus(status: string): boolean;
+/**
+ * Annotate each choice with whether that agent already has a live session, so
+ * the human can see which identity another terminal has taken.
+ *
+ * `agents` is null when liveness could not be determined; `in_use` is then
+ * omitted rather than guessed — a picker with names only is still usable, but a
+ * wrong `in_use` would send the human to the wrong terminal.
+ */
+export declare function markInUse(profiles: ProfileChoice[], agents: AgentSummary[] | null, agentIdByProfile: Record<string, number>): ProfileChoice[];
+/**
+ * The warning returned when a human picks an identity another terminal already
+ * holds.
+ *
+ * Deliberately NOT a refusal. A crashed terminal's session still looks live for
+ * the rest of the 90s window, so refusing would lock someone out of their own
+ * identity at the worst possible moment. The collision is real but recoverable;
+ * being unable to reconnect is neither.
+ *
+ * Returns undefined when there is nothing to warn about, so the caller can
+ * spread it into the result and have the field simply not appear.
+ */
+export declare function collisionWarning(profileName: string, live: AgentSummary | null): string | undefined;
+export interface BuildServerOptions {
+    configPath?: string;
+    startDir?: string;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Construct the MCP server with all tools registered. The config is loaded
+ * eagerly so a broken `.taskflow.json` fails fast at startup with a clear error.
+ */
+export declare function buildServer(options?: BuildServerOptions): McpServer;