waterplane 0.0.1 → 0.1.6

package/packages/host/dist/slash.js

@@ -0,0 +1,236 @@
+/**
+ * Slash-command catalogue. Combines the built-in Claude Code commands with
+ * the user's custom commands discovered from `.claude/commands/*.md` (project
+ * and personal scopes). The web client renders these in a palette; selecting
+ * one just types the command into the PTY, so anything `claude` accepts works
+ * even if it's not in this list. A plugin backend's OWN list (2.2 `commands`)
+ * is read at the bottom of this file, and so is what a delivery asks of it.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { sourceCommandsProblems } from "@waterplane/shared";
+import { claudeConfigDir } from "./claudeconfig.js";
+import { derive } from "./backends/derive.js";
+import { resolveBackend } from "./backends/index.js";
+// Common built-ins (Claude Code 2.x). Not exhaustive — custom + free typing
+// cover the rest. /btw is surfaced specially in the UI.
+const BUILTINS = [
+    ["/btw", "Queue a note for later without interrupting the current turn"],
+    ["/context", "Show context window usage breakdown"],
+    // The CLI's own command table (2.1.236) reads
+    // `{ name: "usage", aliases: ["cost", "stats"] }` — `usage` is the command and
+    // `cost` is an alias it keeps answering to, which is why its menu entry draws
+    // as "/usage (cost)". Both stay listed (an older CLI on someone's machine only
+    // has `/cost`), but the canonical one carries the CLI's own words and is what
+    // the toolbar sends.
+    ["/usage", "Show session cost, plan usage, and activity stats"],
+    ["/cost", "Show session cost, plan usage, and activity stats (alias of /usage)"],
+    ["/clear", "Clear conversation history"],
+    ["/compact", "Summarize and compact the conversation"],
+    ["/config", "Open settings"],
+    ["/model", "Switch the model"],
+    ["/effort", "Set the reasoning effort"],
+    ["/output-style", "Switch the output style"],
+    ["/agents", "Manage subagents"],
+    ["/mcp", "Manage MCP servers"],
+    ["/hooks", "Manage hooks"],
+    ["/permissions", "Manage tool permissions"],
+    ["/sandbox", "Manage sandbox settings"],
+    ["/add-dir", "Add a working directory to the session"],
+    ["/remote-control", "Drive this session from claude.ai (Remote Control)"],
+    ["/ide", "Connect to an IDE integration"],
+    ["/review", "Review a pull request"],
+    ["/pr-comments", "Show pull-request comments"],
+    ["/install-github-app", "Install the Claude GitHub app"],
+    ["/init", "Generate a CLAUDE.md for the repo"],
+    ["/memory", "Edit memory files"],
+    ["/todos", "Show the session's todo list"],
+    ["/resume", "Resume a previous session"],
+    ["/rewind", "Rewind to an earlier checkpoint"],
+    // Answered by the HOST, never typed: it opens the fork as a new tab here
+    // (`shared/slash.ts`'s `slashForkTitle` — the CLI's own would vanish into its daemon).
+    ["/fork", "Fork this conversation into a new tab (optional title after it)"],
+    ["/export", "Export the conversation"],
+    ["/bashes", "List background bash shells"],
+    ["/status", "Show session status"],
+    ["/statusline", "Configure the status line"],
+    ["/doctor", "Diagnose and verify the installation"],
+    ["/upgrade", "Upgrade Claude Code"],
+    ["/terminal-setup", "Configure terminal key bindings"],
+    ["/vim", "Toggle vim mode"],
+    ["/bug", "Report a bug to Anthropic"],
+    ["/feedback", "Send feedback to Anthropic"],
+    ["/privacy-settings", "Manage privacy settings"],
+    ["/release-notes", "Show release notes"],
+    ["/help", "List all commands"],
+    ["/login", "Authenticate"],
+    ["/logout", "Sign out"],
+];
+function discoverDir(dir, source) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    const walk = (base, prefix) => {
+        let entries;
+        try {
+            entries = readdirSync(base, { withFileTypes: true }).map((d) => (d.isDirectory() ? d.name + "/" : d.name));
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.endsWith("/")) {
+                walk(join(base, e.slice(0, -1)), `${prefix}${e.slice(0, -1)}:`);
+            }
+            else if (e.endsWith(".md")) {
+                out.push({ name: `/${prefix}${e.slice(0, -3)}`, source });
+            }
+        }
+    };
+    walk(dir, "");
+    return out;
+}
+export function listSlashCommands(cwd) {
+    const builtins = BUILTINS.map(([name, description]) => ({ name, source: "builtin", description }));
+    const project = discoverDir(join(cwd, ".claude", "commands"), "project");
+    const user = discoverDir(join(claudeConfigDir(), "commands"), "user");
+    // Dedupe by name, builtins first.
+    const seen = new Set();
+    const all = [];
+    for (const c of [...builtins, ...project, ...user]) {
+        if (seen.has(c.name))
+            continue;
+        seen.add(c.name);
+        all.push(c);
+    }
+    return all;
+}
+/**
+ * The TUI-local command list lives in `@waterplane/shared` now: the PHONE needs the
+ * same answer this file used to keep to itself, so that a view is not delivered
+ * into a session mid-turn like an interjection. Re-exported here because
+ * `deliver.ts` has always asked this module.
+ */
+export { isLocalCommand, startsNoTurn, worksUnannounced } from "@waterplane/shared";
+/** The longest a phone's slash sheet waits on a backend's list before saying it did not answer. */
+export const COMMANDS_LIST_WAIT_MS = 5000;
+/** The longest a DELIVERY waits on it: past this the descriptor's own rule decides, unasked. */
+export const COMMANDS_DELIVERY_WAIT_MS = 1500;
+/** A good list is reused this long by the sheet… */
+const SHEET_FRESH_MS = 60_000;
+/** …and this long by a delivery (a command's local-ness does not change between two sends). */
+const DELIVERY_FRESH_MS = 10 * 60_000;
+/** Good lists only, by backend + cwd; a failure is never remembered (the next ask may succeed). */
+const LISTS = new Map();
+/** One question per backend + cwd in flight; a second asker joins it. */
+const INFLIGHT = new Map();
+/** Test seam: forget every remembered list. */
+export function forgetBackendCommands() { LISTS.clear(); INFLIGHT.clear(); }
+function ask(b, cwd) {
+    const key = `${b.id}\n${cwd}`;
+    const running = INFLIGHT.get(key);
+    if (running)
+        return running;
+    const p = (async () => {
+        let answer;
+        try {
+            answer = await b.sources.commands.list(cwd);
+        }
+        catch (e) {
+            return { why: `${b.label} could not list its commands: ${e instanceof Error ? e.message : String(e)}` };
+        }
+        if (answer === null || answer === undefined)
+            return { why: `${b.label} cannot say which commands it has right now` };
+        const problems = sourceCommandsProblems(answer);
+        if (problems.length)
+            return { why: `${b.label}'s command list was dropped whole — ${problems[0]}` };
+        const list = answer;
+        LISTS.set(key, { at: Date.now(), list });
+        return { list };
+    })().finally(() => { if (INFLIGHT.get(key) === p)
+        INFLIGHT.delete(key); });
+    INFLIGHT.set(key, p);
+    return p;
+}
+/** The list, from memory while fresh, else asked — bounded: a list that does not come in time is a sentence. */
+async function listFor(b, cwd, freshMs, waitMs) {
+    const kept = LISTS.get(`${b.id}\n${cwd}`);
+    if (kept && Date.now() - kept.at < freshMs)
+        return { list: kept.list };
+    let timer;
+    const late = new Promise((r) => {
+        timer = setTimeout(() => {
+            // A list that never settles must not be joined by every later ask: drop it so the next asks afresh.
+            INFLIGHT.delete(`${b.id}\n${cwd}`);
+            r({ why: `${b.label} did not list its commands in time` });
+        }, waitMs);
+    });
+    try {
+        return await Promise.race([ask(b, cwd), late]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+const toRow = (c) => ({
+    name: c.name, source: "backend",
+    ...(c.description ? { description: c.description } : {}),
+    ...(c.args ? { args: c.args } : {}),
+    ...(c.local === true ? { local: true } : {}),
+});
+/**
+ * The slash sheet's answer for ONE backend (`GET /api/slash?backend=<id>`). A backend whose
+ * `commands` fact a source answers: its own list, every row `source: "backend"`. One with none:
+ * claude's set where its slash vocabulary IS claude's (`caps.slash === "claude"` — claude-local,
+ * claude-endpoint), else an empty list WITH the sentence. A failing, null, late or malformed
+ * answer is an empty list with the sentence, never a partial list and never claude's.
+ */
+export async function backendSlashCommands(b, cwd) {
+    if (!derive(b).askSource("commands")) {
+        if (b.caps.slash === "claude")
+            return { commands: listSlashCommands(cwd) };
+        return { commands: [], why: `${b.label} does not tell this host its slash commands` };
+    }
+    const got = await listFor(b, cwd, SHEET_FRESH_MS, COMMANDS_LIST_WAIT_MS);
+    if ("why" in got)
+        return { commands: [], why: got.why };
+    if (!got.list.length)
+        return { commands: [], why: `${b.label} lists no slash commands here` };
+    return { commands: got.list.map(toRow) };
+}
+/**
+ * Does `text`, typed into a session of backend `backendId`, open a VIEW (`local`) and/or start no
+ * turn (`noTurn`)? The two facts `deliver/deliverrun.ts` hangs the sweep's Esc and the submit
+ * proof off — asked of THE SESSION'S OWN descriptor (`delivery.isLocalCommand`/`startsNoTurn`):
+ * claude's are `@waterplane/shared`'s, so claude is unchanged; a plugin's are its own (opencode
+ * answers false, Copilot and Codex their measured lists), never claude's list typed at another
+ * binary. Then, for a backend whose source lists its commands, the CLI's own word on that
+ * command beats the static rule: `local: true` ⇒ both true (the proof is the screen moving),
+ * `local: false` ⇒ both false; absent, unlisted, or no list in time ⇒ the descriptor's rule.
+ * A backend this host no longer knows ⇒ neither (an ordinary prompt: a slower proof, never a
+ * wrong one).
+ */
+export async function deliveryCommandFacts(backendId, cwd, text) {
+    let b;
+    try {
+        b = resolveBackend(backendId);
+    }
+    catch {
+        return { local: false, noTurn: false };
+    }
+    const rule = (f) => { try {
+        return !!f(text);
+    }
+    catch {
+        return false;
+    } };
+    const local = rule(b.delivery.isLocalCommand);
+    const noTurn = rule(b.delivery.startsNoTurn);
+    const word = /^\/\S+/.exec(text.trim())?.[0];
+    if (!word || !cwd || !derive(b).askSource("commands"))
+        return { local, noTurn };
+    const got = await listFor(b, cwd, DELIVERY_FRESH_MS, COMMANDS_DELIVERY_WAIT_MS);
+    const said = "list" in got ? got.list.find((c) => c.name === word)?.local : undefined;
+    return typeof said === "boolean" ? { local: said, noTurn: said } : { local, noTurn };
+}
+//# sourceMappingURL=slash.js.map

package/packages/host/dist/slash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash.js","sourceRoot":"","sources":["../src/slash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,4EAA4E;AAC5E,wDAAwD;AACxD,MAAM,QAAQ,GAAuB;IACnC,CAAC,MAAM,EAAE,8DAA8D,CAAC;IACxE,CAAC,UAAU,EAAE,qCAAqC,CAAC;IACnD,8CAA8C;IAC9C,+EAA+E;IAC/E,8EAA8E;IAC9E,+EAA+E;IAC/E,8EAA8E;IAC9E,qBAAqB;IACrB,CAAC,QAAQ,EAAE,mDAAmD,CAAC;IAC/D,CAAC,OAAO,EAAE,qEAAqE,CAAC;IAChF,CAAC,QAAQ,EAAE,4BAA4B,CAAC;IACxC,CAAC,UAAU,EAAE,wCAAwC,CAAC;IACtD,CAAC,SAAS,EAAE,eAAe,CAAC;IAC5B,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAC9B,CAAC,SAAS,EAAE,0BAA0B,CAAC;IACvC,CAAC,eAAe,EAAE,yBAAyB,CAAC;IAC5C,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAC/B,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAC9B,CAAC,QAAQ,EAAE,cAAc,CAAC;IAC1B,CAAC,cAAc,EAAE,yBAAyB,CAAC;IAC3C,CAAC,UAAU,EAAE,yBAAyB,CAAC;IACvC,CAAC,UAAU,EAAE,wCAAwC,CAAC;IACtD,CAAC,iBAAiB,EAAE,oDAAoD,CAAC;IACzE,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACzC,CAAC,SAAS,EAAE,uBAAuB,CAAC;IACpC,CAAC,cAAc,EAAE,4BAA4B,CAAC;IAC9C,CAAC,qBAAqB,EAAE,+BAA+B,CAAC;IACxD,CAAC,OAAO,EAAE,mCAAmC,CAAC;IAC9C,CAAC,SAAS,EAAE,mBAAmB,CAAC;IAChC,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAC1C,CAAC,SAAS,EAAE,2BAA2B,CAAC;IACxC,CAAC,SAAS,EAAE,iCAAiC,CAAC;IAC9C,yEAAyE;IACzE,uFAAuF;IACvF,CAAC,OAAO,EAAE,iEAAiE,CAAC;IAC5E,CAAC,SAAS,EAAE,yBAAyB,CAAC;IACtC,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAC1C,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAClC,CAAC,aAAa,EAAE,2BAA2B,CAAC;IAC5C,CAAC,SAAS,EAAE,sCAAsC,CAAC;IACnD,CAAC,UAAU,EAAE,qBAAqB,CAAC;IACnC,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;IACtD,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAC3B,CAAC,MAAM,EAAE,2BAA2B,CAAC;IACrC,CAAC,WAAW,EAAE,4BAA4B,CAAC;IAC3C,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;IAChD,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IACxC,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAC9B,CAAC,QAAQ,EAAE,cAAc,CAAC;IAC1B,CAAC,SAAS,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,SAAS,WAAW,CAAC,GAAW,EAAE,MAA0B;IAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE;QAC5C,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7G,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAClE,CAAC;iBAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,QAAQ,GAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IACnH,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,kCAAkC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAWpF,mGAAmG;AACnG,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,gGAAgG;AAChG,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAC9C,oDAAoD;AACpD,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,+FAA+F;AAC/F,MAAM,iBAAiB,GAAG,EAAE,GAAG,MAAM,CAAC;AAKtC,mGAAmG;AACnG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiD,CAAC;AACvE,yEAAyE;AACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEnD,+CAA+C;AAC/C,MAAM,UAAU,qBAAqB,KAAW,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAElF,SAAS,GAAG,CAAC,CAAkB,EAAE,GAAW;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,IAAoB,EAAE;QACpC,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YAAC,MAAM,GAAG,MAAM,CAAC,CAAC,OAAQ,CAAC,QAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,iCAAiC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1G,CAAC;QACD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,6CAA6C,EAAE,CAAC;QACrH,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,uCAAuC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpG,MAAM,IAAI,GAAG,MAAyB,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,gHAAgH;AAChH,KAAK,UAAU,OAAO,CAAC,CAAkB,EAAE,GAAW,EAAE,OAAe,EAAE,MAAc;IACrF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC1C,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACvE,IAAI,KAAiC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,EAAE;QACpC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,oGAAoG;YACpG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;YACnC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,oCAAoC,EAAE,CAAC,CAAC;QAC7D,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QAAC,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;AAC1F,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAgB,EAAE,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS;IAC/B,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACtD,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,CAAkB,EAAE,GAAW;IACxE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,6CAA6C,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC;IACzE,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACxD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,+BAA+B,EAAE,CAAC;IAC9F,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,SAA6B,EAAE,GAAuB,EAAE,IAAY;IAC7G,IAAI,CAAoB,CAAC;IACzB,IAAI,CAAC;QAAC,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,CAAC;IACxF,MAAM,IAAI,GAAG,CAAC,CAAyB,EAAW,EAAE,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC,CAAC,CAAC,CAAC;IAC3G,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,yBAAyB,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,OAAO,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACvF,CAAC"}

package/packages/host/dist/sourceanswer.d.ts

@@ -0,0 +1,103 @@
+/**
+ * What a backend's OWN channel may ask the host to type, after `boxes.ts`'s `answerBox` put a
+ * person's (or a gated plugin's) answer to it — and the typing itself.
+ *
+ * Two shapes, both answers to a box the source posed and still holds open, never a prompt:
+ *
+ *  - `SourceKeys` — its dialog moved into its TUI and is answered by at most `SOURCE_KEYS_MAX`
+ *    keystrokes (a digit, an arrow, Return, Escape; 2.2: Tab, Shift+Tab);
+ *  - `SourceTyped` (contract 2.0) — its QUESTION is a form in its TUI and the answer is words
+ *    typed into that form (Copilot's `ask_user`): at most `SOURCE_TYPED_MAX` characters, no
+ *    control character at all, then optionally ONE Return as a second write (text and Return
+ *    together read as a paste). The one place words reach a session outside `deliver.ts` —
+ *    bounded here, typed only while the source still holds the question open, and every one a
+ *    `sent.json` row (`source: "phone"` for a person, `"plugin"` for a gated answer). It is not
+ *    a delivery: no echo is proven, no Return re-pressed. What it CAN check is the source
+ *    closing the question: no `closed` within `TYPED_CLOSE_MS` is said on the box.
+ *  - both at once, `{keys, typed, then?}` (2.1, `supports.dialogKeysThenTyped`) — a dialog row
+ *    whose key OPENS a reason field (Copilot's "No, and tell the agent why" past its hook
+ *    hold: `3` opens the field). Each half bounded as above; the keys, a `TYPED_AFTER_KEYS_MS`
+ *    pause for the field to draw, then the typed half exactly as a question's. `boxes.ts` lets
+ *    it through only for the words a PERSON typed on a `takesText` row.
+ *
+ * A PLAN the CLI posed on its own channel (`sources.plan`) is answered here too
+ * (`answerSourcePlan`): a person's tap calls ONE of its two verbs, at most once per plan, and
+ * its reply is `{ok}` or keys — never words.
+ *
+ * `deliver.ts` is not forked: nothing here finds a composer, proves an echo or retries.
+ */
+import { type SourceKeys, type SourcePlan, type SourceTyped, type SentSource } from "@waterplane/shared";
+/** How long a typed answer waits for the source to say its question closed. */
+export declare const TYPED_CLOSE_MS = 5000;
+/** Between the words and their Return: two writes, or the TUI reads one paste. */
+export declare const TYPED_RETURN_PAUSE_MS = 60;
+/** Between a dialog's keys and the words they open a field for: the field must be drawn first. */
+export declare const TYPED_AFTER_KEYS_MS = 500;
+/**
+ * Why `keys` is not something a source may have typed, or null when it may.
+ *
+ * At most `SOURCE_KEYS_MAX` keys, each a printable character or one of
+ * `SOURCE_CONTROL_KEYS` (longest first, so an arrow or Shift+Tab is one key and
+ * not an Escape plus two characters). Anything else — a control character, a
+ * bracketed paste, a prompt's worth of text — is not an answer to a box.
+ */
+export declare function sourceKeysProblem(keys: unknown): string | null;
+/** Why a `SourceTyped` is not something the host will type, or null when it will. */
+export declare function sourceTypedProblem(t: unknown): string | null;
+export interface SourceReplyDeps {
+    /** The core's raw-input path into THIS session (`core.input`), the one a digit tap takes. */
+    input(data: string): boolean;
+    /** The dialog or question that was answered is still one the channel holds open. */
+    stillOpen(): boolean;
+    /** A typed answer the source has not closed after `closeWaitMs`: the sentence for the box. */
+    onUnclosed?(sentence: string): void;
+    /** The backend's label, for the sentences. */
+    label?: string;
+    /** For the `sent.json` row of a typed answer. */
+    log?: {
+        sessionId: string;
+        source: Extract<SentSource, "phone" | "plugin">;
+    };
+    closeWaitMs?: number;
+    pauseMs?: number;
+    /** Keys-then-words: the pause after the keys (default `TYPED_AFTER_KEYS_MS`). */
+    keysPauseMs?: number;
+}
+/**
+ * What became of a source's reply to an answer: `{ok, reason}` as it said, or the keys /
+ * typed words it handed back, typed here — once, into this session, only while the thing
+ * answered is still open. Anything else is refused in words, nothing typed.
+ */
+export declare function applySourceReply(r: {
+    ok: boolean;
+    reason?: string;
+} | SourceKeys | SourceTyped | (SourceKeys & SourceTyped) | null | undefined, deps: SourceReplyDeps): Promise<{
+    ok: boolean;
+    reason?: string;
+}>;
+/** The plan box's two rows, as `sidechannel.ts`'s `planToPrompt` publishes them. */
+export declare const PLAN_APPROVE = 1;
+export declare const PLAN_KEEP = 2;
+/**
+ * A plan the CLI posed on its own channel, as the channel holds it until `closed`. `answering`
+ * is the at-most-once latch: set before a verb is called, released only when the answer provably
+ * did nothing (the source said no, threw, or its keys were refused or could not be typed). A
+ * second tap — another phone, a double tap under two ackIds — while it is set calls nothing.
+ */
+export interface PlanEntry {
+    plan: SourcePlan;
+    answering: boolean;
+}
+/**
+ * Rung 1 of `boxes.ts`'s `answerBox` for a PLAN: row 1 calls `approve()`, row 2 `keepPlanning()`.
+ * Only a person's tap (`byPerson`; the answer gate refuses a plan before it gets here, and this
+ * refuses again), never typed words. The verb's reply goes through `applySourceReply` — `{ok}`,
+ * or keys typed while the plan is still open; a reply carrying words is refused, nothing typed.
+ */
+export declare function answerSourcePlan(e: PlanEntry, choice: number, opts: {
+    byPerson: boolean;
+    text?: string;
+}, deps: SourceReplyDeps): Promise<{
+    ok: boolean;
+    reason?: string;
+}>;

package/packages/host/dist/sourceanswer.js

@@ -0,0 +1,193 @@
+/**
+ * What a backend's OWN channel may ask the host to type, after `boxes.ts`'s `answerBox` put a
+ * person's (or a gated plugin's) answer to it — and the typing itself.
+ *
+ * Two shapes, both answers to a box the source posed and still holds open, never a prompt:
+ *
+ *  - `SourceKeys` — its dialog moved into its TUI and is answered by at most `SOURCE_KEYS_MAX`
+ *    keystrokes (a digit, an arrow, Return, Escape; 2.2: Tab, Shift+Tab);
+ *  - `SourceTyped` (contract 2.0) — its QUESTION is a form in its TUI and the answer is words
+ *    typed into that form (Copilot's `ask_user`): at most `SOURCE_TYPED_MAX` characters, no
+ *    control character at all, then optionally ONE Return as a second write (text and Return
+ *    together read as a paste). The one place words reach a session outside `deliver.ts` —
+ *    bounded here, typed only while the source still holds the question open, and every one a
+ *    `sent.json` row (`source: "phone"` for a person, `"plugin"` for a gated answer). It is not
+ *    a delivery: no echo is proven, no Return re-pressed. What it CAN check is the source
+ *    closing the question: no `closed` within `TYPED_CLOSE_MS` is said on the box.
+ *  - both at once, `{keys, typed, then?}` (2.1, `supports.dialogKeysThenTyped`) — a dialog row
+ *    whose key OPENS a reason field (Copilot's "No, and tell the agent why" past its hook
+ *    hold: `3` opens the field). Each half bounded as above; the keys, a `TYPED_AFTER_KEYS_MS`
+ *    pause for the field to draw, then the typed half exactly as a question's. `boxes.ts` lets
+ *    it through only for the words a PERSON typed on a `takesText` row.
+ *
+ * A PLAN the CLI posed on its own channel (`sources.plan`) is answered here too
+ * (`answerSourcePlan`): a person's tap calls ONE of its two verbs, at most once per plan, and
+ * its reply is `{ok}` or keys — never words.
+ *
+ * `deliver.ts` is not forked: nothing here finds a composer, proves an echo or retries.
+ */
+import { SOURCE_KEYS_MAX, SOURCE_TYPED_MAX } from "@waterplane/shared";
+import { recordSent } from "./sentlog.js";
+/**
+ * The control keys a source may ask for — the ones a box walk presses, plus (2.2) Tab and
+ * Shift+Tab, which a mode cycle presses. Longest first: Shift+Tab is one key, not an Escape.
+ */
+const SOURCE_CONTROL_KEYS = ["\x1b[A", "\x1b[B", "\x1b[C", "\x1b[D", "\x1b[Z", "\r", "\t", "\x1b"];
+/** How long a typed answer waits for the source to say its question closed. */
+export const TYPED_CLOSE_MS = 5000;
+/** Between the words and their Return: two writes, or the TUI reads one paste. */
+export const TYPED_RETURN_PAUSE_MS = 60;
+/** Between a dialog's keys and the words they open a field for: the field must be drawn first. */
+export const TYPED_AFTER_KEYS_MS = 500;
+const isControl = (cp) => cp < 0x20 || (cp >= 0x7f && cp < 0xa0);
+/**
+ * Why `keys` is not something a source may have typed, or null when it may.
+ *
+ * At most `SOURCE_KEYS_MAX` keys, each a printable character or one of
+ * `SOURCE_CONTROL_KEYS` (longest first, so an arrow or Shift+Tab is one key and
+ * not an Escape plus two characters). Anything else — a control character, a
+ * bracketed paste, a prompt's worth of text — is not an answer to a box.
+ */
+export function sourceKeysProblem(keys) {
+    if (typeof keys !== "string" || keys.length === 0)
+        return "it asked for no keystrokes";
+    let n = 0;
+    for (let i = 0; i < keys.length; n++) {
+        const ctl = SOURCE_CONTROL_KEYS.find((k) => keys.startsWith(k, i));
+        if (ctl) {
+            i += ctl.length;
+            continue;
+        }
+        const cp = keys.codePointAt(i);
+        if (isControl(cp)) {
+            return `it asked for a control character (0x${cp.toString(16).padStart(2, "0")}) that is not Return, Escape, Tab, Shift+Tab or an arrow`;
+        }
+        i += cp > 0xffff ? 2 : 1;
+    }
+    if (n > SOURCE_KEYS_MAX)
+        return `it asked for ${n} keystrokes, and a box is answered with at most ${SOURCE_KEYS_MAX}`;
+    return null;
+}
+/** Why a `SourceTyped` is not something the host will type, or null when it will. */
+export function sourceTypedProblem(t) {
+    const o = t;
+    if (!o || typeof o.typed !== "string" || !o.typed.length)
+        return "it handed over nothing to type";
+    if (o.then !== undefined && o.then !== "\r")
+        return "it asked to end the words with a key that is not Return — only Return may follow them";
+    if (o.typed.length > SOURCE_TYPED_MAX)
+        return `it asked to type ${o.typed.length} characters, and an answer is typed with at most ${SOURCE_TYPED_MAX}`;
+    for (let i = 0; i < o.typed.length; i++) {
+        const c = o.typed.charCodeAt(i);
+        if (isControl(c))
+            return `the words hold a control character (0x${c.toString(16).padStart(2, "0")}) — typed words are one line, and Return comes only as \`then\``;
+    }
+    return null;
+}
+const refusedKeys = (why) => ({ ok: false, reason: `the CLI's own channel answered with keystrokes this host will not type — ${why}` });
+const refusedTyped = (why) => ({ ok: false, reason: `the CLI's own channel asked for words this host will not type — ${why}` });
+const gone = { ok: false, reason: "that question is no longer open — it was answered or withdrawn" };
+const pause = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * What became of a source's reply to an answer: `{ok, reason}` as it said, or the keys /
+ * typed words it handed back, typed here — once, into this session, only while the thing
+ * answered is still open. Anything else is refused in words, nothing typed.
+ */
+export async function applySourceReply(r, deps) {
+    if (r && typeof r === "object" && "keys" in r) {
+        const why = sourceKeysProblem(r.keys);
+        if (why)
+            return refusedKeys(why);
+        const words = "typed" in r ? r : null;
+        if (words) {
+            const wwhy = sourceTypedProblem(words);
+            if (wwhy)
+                return refusedTyped(wwhy);
+        }
+        if (!deps.stillOpen())
+            return { ...gone };
+        if (!deps.input(r.keys))
+            return { ok: false, reason: "session not available" };
+        if (!words)
+            return { ok: true };
+        await pause(deps.keysPauseMs ?? TYPED_AFTER_KEYS_MS);
+        if (!deps.stillOpen())
+            return { ok: false, reason: "the dialog closed after its keys — the keys were typed, the words were not" };
+        return typeWords(words, deps, r.keys);
+    }
+    if (r && typeof r === "object" && "typed" in r) {
+        const why = sourceTypedProblem(r);
+        if (why)
+            return refusedTyped(why);
+        if (!deps.stillOpen())
+            return { ...gone };
+        return typeWords(r, deps);
+    }
+    return r?.ok ? { ok: true } : { ok: false, reason: r?.reason || "the CLI's own channel did not take that answer" };
+}
+/** The typed half, validated and with its thing still open: words, pause, Return as its own write, the row, the close watch. */
+async function typeWords(r, deps, keys) {
+    if (!deps.input(r.typed))
+        return { ok: false, reason: "session not available" };
+    if (r.then === "\r") {
+        await pause(deps.pauseMs ?? TYPED_RETURN_PAUSE_MS);
+        // Closed in the pause (the form took the words alone): nothing left to press Return at.
+        if (deps.stillOpen() && !deps.input("\r"))
+            return { ok: false, reason: "session not available — the words were typed, the Return was not" };
+    }
+    if (deps.log) {
+        recordSent({
+            sessionId: deps.log.sessionId, actor: deps.log.source === "phone" ? "user" : "auto", source: deps.log.source,
+            kind: "answer", text: r.typed, result: "written",
+            detail: keys !== undefined
+                ? `typed into the reason field ${JSON.stringify(keys)} opened on ${deps.label ?? "the CLI"}'s own dialog${r.then ? ", then Return" : ""}`
+                : `typed into ${deps.label ?? "the CLI"}'s own question form${r.then ? ", then Return" : ""}`,
+        });
+    }
+    const wait = deps.closeWaitMs ?? TYPED_CLOSE_MS;
+    const t = setTimeout(() => {
+        if (!deps.stillOpen())
+            return;
+        deps.onUnclosed?.(`your answer was typed into ${deps.label ?? "the CLI"}'s own question, but it has not closed `
+            + `${Math.round(wait / 1000) || 1} s later — look at the terminal before answering again`);
+    }, wait);
+    t.unref?.();
+    return { ok: true };
+}
+/** The plan box's two rows, as `sidechannel.ts`'s `planToPrompt` publishes them. */
+export const PLAN_APPROVE = 1;
+export const PLAN_KEEP = 2;
+/**
+ * Rung 1 of `boxes.ts`'s `answerBox` for a PLAN: row 1 calls `approve()`, row 2 `keepPlanning()`.
+ * Only a person's tap (`byPerson`; the answer gate refuses a plan before it gets here, and this
+ * refuses again), never typed words. The verb's reply goes through `applySourceReply` — `{ok}`,
+ * or keys typed while the plan is still open; a reply carrying words is refused, nothing typed.
+ */
+export async function answerSourcePlan(e, choice, opts, deps) {
+    if (!opts.byPerson)
+        return { ok: false, reason: "a plan is always a person's call — only a tap on the phone or at the desk answers it" };
+    if (opts.text !== undefined)
+        return { ok: false, reason: "a plan is approved or sent back with a tap — it takes no typed words" };
+    if (choice !== PLAN_APPROVE && choice !== PLAN_KEEP)
+        return { ok: false, reason: `${choice} is not one of the box's options` };
+    if (e.answering)
+        return { ok: false, reason: `this plan was already answered — waiting for ${deps.label ?? "the CLI"} to close it` };
+    e.answering = true;
+    let r;
+    try {
+        r = await (choice === PLAN_APPROVE ? e.plan.approve() : e.plan.keepPlanning());
+    }
+    catch (err) {
+        e.answering = false;
+        return { ok: false, reason: `the CLI's own channel did not take that answer (${err?.message || String(err)})` };
+    }
+    if (r && typeof r === "object" && "typed" in r) {
+        e.answering = false;
+        return { ok: false, reason: "the CLI's own channel asked to type words into a plan — a plan is answered with a tap, so nothing was typed" };
+    }
+    const done = await applySourceReply(r, deps);
+    if (!done.ok)
+        e.answering = false;
+    return done;
+}
+//# sourceMappingURL=sourceanswer.js.map

package/packages/host/dist/sourceanswer.js.map

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

package/packages/host/dist/speedtest.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Bidirectional throughput probe + connection diagnostics for the "why is the
+ * file feature so slow" question. Three HTTP endpoints (see api.ts):
+ *   GET  /api/speedtest/download?bytes=N  — host→phone: streams N random bytes.
+ *   POST /api/speedtest/upload            — phone→host: drains + times the body.
+ *   GET  /api/speedtest/debug             — connection introspection (optional).
+ *
+ * The debug pass is the actually-useful bit: it looks at HOW the phone reached
+ * this host (the client IP the socket sees + the Host header it dialed) and, if
+ * that client is a Tailscale peer, runs `tailscale ping` against it to report
+ * whether THIS connection is a direct P2P path or relayed through a DERP server
+ * — the usual cause of a slow same-WiFi transfer. It also surfaces the host's
+ * LAN IPs so the phone can be told to hit `http://<lanIp>:8770` and skip the
+ * tunnel. All shell probes are best-effort and independently guarded.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+/** Stream `bytes` of incompressible data to the phone, honouring backpressure. */
+export declare function serveDownload(res: ServerResponse, bytes: number): void;
+/**
+ * Drain the upload body, counting bytes and measuring the server-side wall time
+ * from first to last byte (a cleaner throughput number than the client's, which
+ * includes connection setup + the response round-trip). Capped at MAX_TEST_BYTES.
+ */
+export declare function drainUpload(req: IncomingMessage): Promise<{
+    bytes: number;
+    ms: number;
+}>;
+export type PathKind = "tailscale" | "lan" | "loopback" | "public" | "unknown";
+export interface SpeedDebug {
+    /** The client IP as the host's socket sees it (normalized, ::ffff: stripped). */
+    clientIp: string;
+    /** How that IP classifies — the headline signal for direct-vs-tunnel. */
+    clientKind: PathKind;
+    /** The address the phone actually dialed (Host header) — 100.x vs 192.168.x. */
+    dialedHost: string;
+    /** True when the phone reached us over the Tailscale tunnel (client is 100.x). */
+    overTailscale: boolean;
+    /** This host's LAN IPv4s — hit http://<ip>:8770 to bypass the tunnel. */
+    lanIps: string[];
+    /** This host's Tailscale IPv4, if any. */
+    tailscaleIp: string | null;
+    /** Whether a usable `tailscale` CLI was found on the host. */
+    tailscaleCli: boolean;
+    /** For a Tailscale client: is this exact connection direct or relayed? */
+    route: "direct" | "derp" | "unknown";
+    /** DERP region code when relayed (e.g. "fra"), else null. */
+    derpRegion: string | null;
+    /** Raw probe output, for the collapsible details view. */
+    raw: {
+        ping?: string;
+        netcheck?: string;
+        status?: string;
+    };
+    /** One-line plain-English verdict for the UI to headline. */
+    verdict: string;
+}
+export declare function collectDebug(req: IncomingMessage): Promise<SpeedDebug>;