@dalmasonto/taskflow-mcp 1.0.33 → 2.0.0

package/dist/events.js

@@ -0,0 +1,407 @@
+/**
+ * Listen to the agent's server-sent event stream so messages reach the terminal
+ * the instant they are sent.
+ *
+ * This is v1's tmux-bridge idea (`task_flow/mcp-server/src/tmux-bridge.ts`):
+ * hold a stream open for the life of the session and inject on arrival, instead
+ * of polling. Polling made delivery as slow as the interval and cost a request
+ * per tick even in silence.
+ *
+ * It cannot use `EventSource`: agents authenticate with `Authorization: Agent
+ * <key>`, and EventSource cannot set headers. Node's fetch can, so the SSE frame
+ * parsing is done here — it is a small, well-specified format.
+ */
+/** Backoff between reconnects: fast first retry, then double, capped. */
+const RECONNECT_BASE_MS = 1_000;
+const RECONNECT_MAX_MS = 30_000;
+/**
+ * Treat the stream as dead after this long with NOTHING on it — not even a
+ * keep-alive comment.
+ *
+ * A dropped connection does not reliably surface as an error: when the server
+ * goes away mid-stream, `reader.read()` can stay pending forever, so the
+ * listener sits there believing it is connected while nothing is delivered.
+ * Waiting for an error is waiting for an event that never comes; the only sound
+ * signal is the absence of expected traffic. The server sends SSE keep-alives
+ * every ~15s, so silence well past that means the stream is gone.
+ */
+const STREAM_IDLE_TIMEOUT_MS = 45_000;
+/**
+ * Hard cap on the SSE read buffer (#44). Frames here are id-only and tiny; a
+ * buffer this large means the server is streaming a frame that never terminates
+ * with `\n\n`. Because bytes keep arriving, the idle watchdog never trips — so
+ * without this cap the buffer would grow to OOM. Past it we abort and reconnect.
+ */
+const MAX_STREAM_BUFFER_BYTES = 1_048_576; // 1 MiB
+/**
+ * Hold the stream open, reconnecting with backoff.
+ *
+ * Never rejects: a stream that cannot connect retries quietly forever, because
+ * the agent must keep working whether or not the dashboard is reachable.
+ */
+export function startAgentEventStream(options) {
+    const log = options.log ?? (() => { });
+    const doFetch = options.fetchImpl ?? fetch;
+    const url = `${options.server.replace(/\/+$/, "")}/api/taskflow/agents/events`;
+    let stopped = false;
+    let attempt = 0;
+    let everConnected = false;
+    let controller = null;
+    let retryTimer = null;
+    const scheduleRetry = () => {
+        if (stopped)
+            return;
+        const ceiling = Math.min(RECONNECT_BASE_MS * 2 ** attempt, RECONNECT_MAX_MS);
+        const delay = Math.round(ceiling / 2 + Math.random() * (ceiling / 2));
+        attempt += 1;
+        retryTimer = setTimeout(connect, delay);
+        retryTimer.unref?.();
+    };
+    const connect = async () => {
+        if (stopped)
+            return;
+        controller = new AbortController();
+        try {
+            const res = await doFetch(url, {
+                headers: { Authorization: `Agent ${options.key}`, Accept: "text/event-stream" },
+                signal: controller.signal,
+            });
+            if (!res.ok || !res.body) {
+                scheduleRetry();
+                return;
+            }
+            attempt = 0;
+            log("event stream connected");
+            // A RE-connect may have missed messages while it was down; let the caller
+            // catch up. The first connect needs no catch-up — nothing was missed yet.
+            if (everConnected)
+                void options.onReconnect?.();
+            everConnected = true;
+            // Parse SSE frames. `data:` may be split across TCP chunks, so text is
+            // buffered until a blank line terminates the frame.
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            // Watchdog: abort a stream that has gone quiet, which forces the read to
+            // settle and drops us into the reconnect path. Created AFTER getReader()
+            // (which can throw) and cleared in the finally below, so a throw between
+            // connect and the loop can never leak a watchdog — a leaked one would
+            // close over the reassigned `controller` and abort the NEXT live
+            // connection every ~15s (#44).
+            let lastActivity = Date.now();
+            const watchdog = setInterval(() => {
+                if (Date.now() - lastActivity > STREAM_IDLE_TIMEOUT_MS) {
+                    log("event stream idle — assuming it died, reconnecting");
+                    controller?.abort();
+                }
+            }, Math.floor(STREAM_IDLE_TIMEOUT_MS / 3));
+            watchdog.unref?.();
+            try {
+                for (;;) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    // Any byte counts as life, keep-alive comments included.
+                    lastActivity = Date.now();
+                    buffer += decoder.decode(value, { stream: true });
+                    let boundary = buffer.indexOf("\n\n");
+                    while (boundary !== -1) {
+                        const frame = buffer.slice(0, boundary);
+                        buffer = buffer.slice(boundary + 2);
+                        handleFrame(frame, options);
+                        boundary = buffer.indexOf("\n\n");
+                    }
+                    // A frame that never terminates would grow `buffer` unbounded while
+                    // bytes keep arriving (so the watchdog never trips) — cap it and force a
+                    // reconnect instead of growing to OOM (#44).
+                    if (buffer.length > MAX_STREAM_BUFFER_BYTES) {
+                        log("event stream buffer exceeded cap without a frame terminator — reconnecting");
+                        controller?.abort();
+                        break;
+                    }
+                }
+            }
+            finally {
+                clearInterval(watchdog);
+            }
+            if (!stopped) {
+                log("event stream closed by server");
+                scheduleRetry();
+            }
+        }
+        catch (err) {
+            if (!stopped) {
+                log(`event stream error: ${err.message.split("\n")[0]}`);
+                scheduleRetry();
+            }
+        }
+    };
+    void connect();
+    return {
+        stop: () => {
+            stopped = true;
+            if (retryTimer)
+                clearTimeout(retryTimer);
+            controller?.abort();
+        },
+        reconnectNow: () => {
+            if (stopped)
+                return;
+            // Abort settles the pending read, which lands in the reconnect path.
+            // Reset the backoff: this is a known-cause drop, not a flapping server.
+            attempt = 0;
+            controller?.abort();
+        },
+    };
+}
+/** Pull the `data:` lines out of one SSE frame and dispatch a message event. */
+export function handleFrame(frame, options) {
+    const data = frame
+        .split("\n")
+        .filter((line) => line.startsWith("data:"))
+        .map((line) => line.slice(5).trimStart())
+        .join("\n");
+    if (!data)
+        return;
+    let envelope;
+    try {
+        envelope = JSON.parse(data);
+    }
+    catch {
+        return;
+    }
+    // A prompt being ANSWERED is an update, not a creation — the row was created
+    // when the question appeared. So prompts are routed before the created-only
+    // filter below, or every answer would be dropped.
+    if (envelope.c?.endsWith(":prompts")) {
+        if (isAnsweredPrompt(envelope.d))
+            void options.onPromptAnswered?.(envelope.d);
+        return;
+    }
+    // Terminal keys: fields are projected inline, so act straight off the event.
+    // Broadcast to the whole project — the handler filters by `agent`.
+    if (envelope.c?.endsWith(":terminal_inputs")) {
+        const row = envelope.d;
+        if (row && typeof row.agent === "number" && typeof row.keys === "string") {
+            void options.onTerminalKey?.({ agent: row.agent, keys: row.keys });
+        }
+        return;
+    }
+    // Creations AND edits matter for delivery (#107): an edited message is the
+    // sender saying "proceed with THIS version", so it must reach the pane again.
+    // Deletes stay silent — there is nothing new for the agent to read.
+    if (envelope.e !== "created" && envelope.e !== "updated")
+        return;
+    // Every table in a project shares the `project:{id}:*` room family, and a chat
+    // event is now id-only — indistinguishable from an id-only task or read-cursor
+    // row except by the group name. Without this check every task edit would be
+    // typed into the agent's pane as though someone had spoken to it.
+    if (!envelope.c?.endsWith(":messages"))
+        return;
+    const row = envelope.d;
+    // The id is all the wire carries, and all that is needed: the body is fetched
+    // back over the authorized read API, which re-checks the channel roster.
+    // Requiring `body_markdown` here is what silently killed live delivery when
+    // chat became id-only — the guard rejected every real event.
+    if (!row || typeof row.id !== "number")
+        return;
+    void options.onMessage(row, envelope.e);
+}
+/**
+ * Whether a message should be delivered to THIS agent's terminal.
+ *
+ * Every message the agent can see is delivered EXCEPT its own — an agent must
+ * stay aware of all channel traffic so it can chat / add information (#40 review).
+ * Whether it may ACT on the message is a SEPARATE signal (`canActOnMessage`)
+ * surfaced as guidance in the notice, NOT a delivery gate. Its own messages are
+ * still skipped: echoing them back reads as a new instruction and could loop the
+ * agent against itself.
+ */
+export function shouldDeliver(message, selfAgentId) {
+    if (message.sender_kind === "agent" && message.sender_agent === selfAgentId)
+        return false;
+    return true;
+}
+/**
+ * Whether THIS agent is a TARGET of the message and may act on it — build,
+ * execute, take ownership. A non-target still RECEIVES the message (to reply or
+ * add information) but must not act; `formatIncoming` says so.
+ *
+ * - An empty/absent target set is a broadcast: everyone may act.
+ * - Otherwise the agent may act only if it is one of the AGENT targets. A
+ *   message tagged only at users leaves every agent a non-target.
+ */
+export function canActOnMessage(message, selfAgentId) {
+    if (message.targets && message.targets.length > 0) {
+        return message.targets.some((t) => t.kind === "agent" && t.id === selfAgentId);
+    }
+    // Back-compat: rows written before `targets` carry only the single
+    // `target_agent`. Null there is a broadcast.
+    if (message.target_agent != null)
+        return message.target_agent === selfAgentId;
+    return true;
+}
+/**
+ * How much of a notice may be typed into the pane.
+ *
+ * The notice is delivered by TYPING it into a live tmux pane, so it has to stay
+ * bounded — but the old 240-char cap silently ate the tail of any real message.
+ * A request lost its second half mid-sentence and the agent answered the half it
+ * got, with nothing indicating more existed.
+ */
+const MAX_NOTICE_CHARS = 1_000;
+/** Bytes as something a human (or an agent deciding whether to read it) can judge. */
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * The one-line notice typed into the agent's pane for an incoming message.
+ *
+ * Attachments are listed explicitly. A pushed message used to carry body text
+ * only, so a file arrived invisibly: the agent read the message, answered it,
+ * and never learned anything was attached. Name, size and url are all included
+ * so the agent can decide whether to pull the file without another round trip.
+ *
+ * The manifest is built FIRST and the body flexes into whatever room is left.
+ * If something has to be dropped it must be prose, never the pointer to the
+ * files — the manifest is precisely what tells the agent there is more to fetch.
+ */
+/**
+ * The context block appended to a notice: the ids an agent needs to act on the
+ * message without a round trip — scope a query to the project, act on the task,
+ * reply to the right person, or `mark_read` the message. Gated on `project`
+ * (a real delivered message always has one; the bare wire event does not), and
+ * kept on ONE line — a newline would submit the prompt early. Like the
+ * attachment manifest, it is never the part that gets truncated.
+ */
+function contextSuffix(message) {
+    if (message.project == null)
+        return "";
+    const parts = [
+        `project=${message.project}`,
+        `channel=${message.channel}`,
+        `message=${message.id}`,
+    ];
+    if (message.task != null)
+        parts.push(`task=${message.task}`);
+    const sender = message.sender_user != null
+        ? `user:${message.sender_user}`
+        : message.sender_agent != null
+            ? `agent:${message.sender_agent}`
+            : null;
+    if (sender)
+        parts.push(`from=${sender}`);
+    return ` ⟦ctx ${parts.join(" ")}⟧`;
+}
+export function formatIncoming(message, attachments = [], selfAgentId, edited = false) {
+    const who = message.sender_label || (message.sender_kind === "user" ? "User" : "Agent");
+    // #40 review: a non-target still receives the message but is told, clearly and
+    // up front, NOT to act on it — only to reply / add information if useful. When
+    // selfAgentId is unknown, or the agent is a target/broadcast recipient, there
+    // is no guard and the message reads normally.
+    const guard = selfAgentId != null && !canActOnMessage(message, selfAgentId)
+        ? "🚫 DO NOT ACT — you are not the target of this message. You may reply or add information in chat, but do not build or execute on it. "
+        : "";
+    // #107: an edit is redelivered so the agent proceeds from the REVISED words —
+    // said explicitly, or the agent reads it as a brand-new (duplicate) request.
+    const head = edited
+        ? `[taskflow] ${guard}✏️ EDITED message from ${who} (supersedes the earlier version — continue from this revision): `
+        : `[taskflow] ${guard}Message from ${who}: `;
+    const manifest = attachments.length
+        ? ` 📎 ${attachments.length} attachment${attachments.length === 1 ? "" : "s"}: ` +
+            attachments.map((a) => `${a.name} (${humanSize(a.size_bytes)}) ${a.url}`).join("; ")
+        : "";
+    const ctx = contextSuffix(message);
+    // Newlines would submit the prompt early; collapse before measuring so the
+    // budget reflects what is actually typed.
+    const body = message.body_markdown.replace(/\s+/gu, " ").trim();
+    // The manifest AND the context block are pointers the agent must keep; only
+    // the prose flexes into the room left after them.
+    const room = MAX_NOTICE_CHARS - head.length - manifest.length - ctx.length;
+    if (body.length <= room)
+        return `${head}${body}${manifest}${ctx}`;
+    // Say so. A truncated notice that looks complete is how a request gets
+    // half-answered; the agent needs to know to go and read the rest.
+    const hint = " …[truncated — call check_messages for the full message]";
+    const kept = body.slice(0, Math.max(0, room - hint.length));
+    return `${head}${kept}${hint}${manifest}${ctx}`;
+}
+/**
+ * The keystrokes that answer a prompt, as verified against a live Claude Code
+ * session — not inferred from the UI's appearance.
+ *
+ * SINGLE-select: the number HIGHLIGHTS the option; Enter submits it.
+ *     press "2"      -> option 2 highlighted, still waiting
+ *     press Enter    -> "You selected: Green"
+ *
+ * This one was wrong here until 2026-07-21. The comment claimed the number both
+ * selected and submitted, so the agent was left sitting on a prompt the
+ * dashboard already showed as answered — the worst shape of failure, because
+ * the human sees a completed action and the agent sees nothing.
+ *
+ * MULTI-select: numbers TOGGLE checkboxes, then Right opens the review screen
+ * ("Ready to submit your answers?" — 1. Submit / 2. Cancel). This function only
+ * REACHES that screen; the submit key is appended once by keystrokesForPrompt,
+ * because a multi-question set lands on the identical screen. Verified live
+ * 2026-07-21: a single multi-select question sat on that review screen because
+ * nothing pressed the final key.
+ *     press "1" -> [✔] Lint
+ *     press "3" -> [✔] Tests
+ *     press Right -> review screen (submit handled by the caller)
+ *
+ * Getting this wrong is not a cosmetic bug: sending a single digit to a
+ * multi-select ticks one box and leaves the agent still waiting, and sending
+ * Enter instead of Right submits an empty answer.
+ */
+export function answerKeystrokes(choices, kind) {
+    if (!choices.length)
+        return [];
+    if (kind !== "multi")
+        return [String(choices[0]), "Enter"];
+    // Toggle each, then Right to open the review screen. The submit at that screen
+    // is NOT here — it is shared with multi-question sets and owned by
+    // keystrokesForPrompt. A trailing "1" here (as it was) highlighted submit
+    // without an Enter and left the agent waiting, the same bug single-select had.
+    return [...choices.map(String), "Right"];
+}
+/** The numbers a human chose, from whichever field carries them. */
+export function chosenNumbers(prompt) {
+    if (prompt.answer_json) {
+        try {
+            const parsed = JSON.parse(prompt.answer_json);
+            if (Array.isArray(parsed))
+                return parsed.filter((n) => typeof n === "number");
+        }
+        catch {
+            /* fall through to the single value */
+        }
+    }
+    return prompt.answer != null ? [prompt.answer] : [];
+}
+/**
+ * Whether this event is a human decision this agent should act on.
+ *
+ * `answered` and `cancelled` are BOTH actionable: cancel is the other button on
+ * the review screen, and reaching it means replaying every answer first, so it
+ * is just as much a keystroke sequence as submit.
+ *
+ * `answered_by` is what separates a human cancel from the agent clearing its own
+ * prompt — it times out, or someone answers in the terminal directly, and the
+ * row is marked cancelled with nobody attributed. Firing keys for that would
+ * type digits at a screen the agent has already left.
+ */
+export function isAnsweredPrompt(row) {
+    const prompt = row;
+    if (!prompt || typeof prompt.id !== "number")
+        return false;
+    if (prompt.answer == null && !prompt.answer_json)
+        return false;
+    if (prompt.status === "answered")
+        return true;
+    return prompt.status === "cancelled" && prompt.answered_by != null;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,8 @@
 #!/usr/bin/env node
-import 'dotenv/config';
+/**
+ * Bin entry: load `.taskflow.json`, build the MCP server, and serve over stdio.
+ *
+ * A configuration failure prints a clear message to stderr and exits non-zero so
+ * the human fixes the credential file rather than getting a silent dead server.
+ */
+export {};