@kolisachint/hoocode-agent 0.5.30 → 0.5.32

package/dist/core/extensions/plugins/trigger-judge.js

@@ -0,0 +1,121 @@
+/**
+ * The model call G4 was designed around and never had.
+ *
+ * `trigger-eval.ts` takes its judge as a parameter so scoring stays testable
+ * without a model, and nothing in the tree ever passed one — so every G4 run
+ * has reported `not-run` since it was written. This is that judge.
+ *
+ * It is deliberately in its own module rather than inside `trigger-eval.ts`:
+ * the eval is pure and testable, this reaches the network, and the same
+ * separation lets the agent-selection eval reuse the judge without pulling in
+ * the plugin gate machinery.
+ *
+ * ## Why one call for all prompts
+ *
+ * The judge sees every candidate and every prompt at once. Per-prompt calls
+ * would be cleaner to reason about, but the question being scored is
+ * comparative — "which of these fires" — and batching keeps the candidate list
+ * identical across prompts, which is the thing that must not vary. It also
+ * makes the cost proportional to the corpus rather than to the case count.
+ */
+import { completeSimple } from "@kolisachint/hoocode-ai";
+/** Description characters per candidate. The opening states the trigger; past that it is filler. */
+const DESCRIPTION_CHARS = 600;
+const MAX_RESPONSE_TOKENS = 4_000;
+const JUDGE_SYSTEM_PROMPT = `You simulate how a coding agent picks a capability.
+
+You are given numbered CAPABILITIES (name and description) and numbered PROMPTS. For each prompt, answer with the ONE capability an agent would reach for, or null when none of them fits and the agent should just do the work itself.
+
+Rules:
+- Judge ONLY from the descriptions. Do not use knowledge about what these names usually mean elsewhere.
+- Pick the single best fit. When two fit, pick the one whose description names the prompt's situation more specifically.
+- Answer null when no description covers the prompt. Do not stretch a description to make it fit; a wrong pick and a null are both wrong, but pretending coverage hides the real failure.
+- Answer every prompt exactly once, in the order given.
+
+Output STRICT JSON, no markdown fence, no prose:
+{"verdicts":[{"prompt":0,"capability":"explore"},{"prompt":1,"capability":null}]}`;
+function buildPrompt(candidates, prompts) {
+    const lines = ["CAPABILITIES:"];
+    for (const [i, candidate] of candidates.entries()) {
+        lines.push(`${i}. ${candidate.name} — ${candidate.description.slice(0, DESCRIPTION_CHARS)}`);
+    }
+    lines.push("", "PROMPTS:");
+    for (const [i, prompt] of prompts.entries()) {
+        lines.push(`${i}. ${prompt}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Read the verdict list back, positionally.
+ *
+ * Returns one entry per prompt no matter what came back: a missing or
+ * unparseable row becomes null (read as "nothing fired") rather than shifting
+ * every later verdict onto the wrong prompt. `runTriggerEval` rejects a
+ * length mismatch outright, so the alternative to filling the gaps is
+ * discarding the whole run — and a hallucinated capability name is a real
+ * signal about the candidate list, not a reason to throw the batch away.
+ */
+export function parseTriggerVerdicts(response, candidates, promptCount) {
+    const verdicts = new Array(promptCount).fill(null);
+    const start = response.indexOf("{");
+    const end = response.lastIndexOf("}");
+    if (start < 0 || end <= start)
+        return verdicts;
+    let parsed;
+    try {
+        parsed = JSON.parse(response.slice(start, end + 1));
+    }
+    catch {
+        return verdicts;
+    }
+    const rows = parsed?.verdicts;
+    if (!Array.isArray(rows))
+        return verdicts;
+    const known = new Set(candidates.map((c) => c.name));
+    for (const row of rows) {
+        if (!row || typeof row !== "object")
+            continue;
+        const entry = row;
+        const index = typeof entry.prompt === "number" ? entry.prompt : Number.NaN;
+        if (!Number.isInteger(index) || index < 0 || index >= promptCount)
+            continue;
+        const capability = entry.capability;
+        if (capability === null || capability === undefined) {
+            verdicts[index] = null;
+            continue;
+        }
+        // A name that is not on the candidate list is a hallucination. Recording it
+        // as null keeps it wrong without letting it masquerade as a real pick.
+        verdicts[index] = typeof capability === "string" && known.has(capability) ? capability : null;
+    }
+    return verdicts;
+}
+/** A {@link TriggerJudge} backed by a real model. */
+export function createLlmTriggerJudge(deps) {
+    return async ({ candidates, prompts }) => {
+        if (candidates.length === 0 || prompts.length === 0)
+            return prompts.map(() => null);
+        const response = await completeSimple(deps.model, {
+            systemPrompt: JUDGE_SYSTEM_PROMPT,
+            messages: [
+                {
+                    role: "user",
+                    content: [{ type: "text", text: buildPrompt(candidates, prompts) }],
+                    timestamp: Date.now(),
+                },
+            ],
+        }, { maxTokens: MAX_RESPONSE_TOKENS, signal: deps.signal, apiKey: deps.apiKey, headers: deps.headers });
+        if (response.stopReason === "error") {
+            // Thrown, not swallowed: runTriggerEval turns this into `not-run` with
+            // the reason attached, which is the honest outcome. Returning nulls
+            // would score every case as "nothing fired" and read like a real result.
+            throw new Error(response.errorMessage || "trigger judge call failed");
+        }
+        const text = response.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("\n");
+        return parseTriggerVerdicts(text, candidates, prompts.length);
+    };
+}
+//# sourceMappingURL=trigger-judge.js.map

package/dist/core/extensions/plugins/trigger-judge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-judge.js","sourceRoot":"","sources":["../../../../src/core/extensions/plugins/trigger-judge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAc,MAAM,yBAAyB,CAAC;AAGrE,oGAAoG;AACpG,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC,MAAM,mBAAmB,GAAG;;;;;;;;;;;kFAWsD,CAAC;AAEnF,SAAS,WAAW,CAAC,UAAuC,EAAE,OAA0B,EAAU;IACjG,MAAM,KAAK,GAAa,CAAC,eAAe,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,IAAI,QAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC3B,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CACnC,QAAgB,EAChB,UAAuC,EACvC,WAAmB,EACK;IACxB,MAAM,QAAQ,GAA0B,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,QAAQ,CAAC;IAE/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAI,MAAiC,EAAE,QAAQ,CAAC;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,KAAK,GAAG,GAA8B,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,WAAW;YAAE,SAAS;QAC5E,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YACrD,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACvB,SAAS;QACV,CAAC;QACD,4EAA4E;QAC5E,uEAAuE;QACvE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,CAAC;IACD,OAAO,QAAQ,CAAC;AAAA,CAChB;AASD,qDAAqD;AACrD,MAAM,UAAU,qBAAqB,CAAC,IAAsB,EAAgB;IAC3E,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEpF,MAAM,QAAQ,GAAG,MAAM,cAAc,CACpC,IAAI,CAAC,KAAK,EACV;YACC,YAAY,EAAE,mBAAmB;YACjC,QAAQ,EAAE;gBACT;oBACC,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;oBACnE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACrB;aACD;SACD,EACD,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CACnG,CAAC;QAEF,IAAI,QAAQ,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;YACrC,uEAAuE;YACvE,oEAAoE;YACpE,yEAAyE;YACzE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,IAAI,2BAA2B,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aACrE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAAA,CAC9D,CAAC;AAAA,CACF","sourcesContent":["/**\n * The model call G4 was designed around and never had.\n *\n * `trigger-eval.ts` takes its judge as a parameter so scoring stays testable\n * without a model, and nothing in the tree ever passed one — so every G4 run\n * has reported `not-run` since it was written. This is that judge.\n *\n * It is deliberately in its own module rather than inside `trigger-eval.ts`:\n * the eval is pure and testable, this reaches the network, and the same\n * separation lets the agent-selection eval reuse the judge without pulling in\n * the plugin gate machinery.\n *\n * ## Why one call for all prompts\n *\n * The judge sees every candidate and every prompt at once. Per-prompt calls\n * would be cleaner to reason about, but the question being scored is\n * comparative — \"which of these fires\" — and batching keeps the candidate list\n * identical across prompts, which is the thing that must not vary. It also\n * makes the cost proportional to the corpus rather than to the case count.\n */\n\nimport { completeSimple, type Model } from \"@kolisachint/hoocode-ai\";\nimport type { TriggerCandidate, TriggerJudge, TriggerJudgeVerdict } from \"./trigger-eval.js\";\n\n/** Description characters per candidate. The opening states the trigger; past that it is filler. */\nconst DESCRIPTION_CHARS = 600;\nconst MAX_RESPONSE_TOKENS = 4_000;\n\nconst JUDGE_SYSTEM_PROMPT = `You simulate how a coding agent picks a capability.\n\nYou are given numbered CAPABILITIES (name and description) and numbered PROMPTS. For each prompt, answer with the ONE capability an agent would reach for, or null when none of them fits and the agent should just do the work itself.\n\nRules:\n- Judge ONLY from the descriptions. Do not use knowledge about what these names usually mean elsewhere.\n- Pick the single best fit. When two fit, pick the one whose description names the prompt's situation more specifically.\n- Answer null when no description covers the prompt. Do not stretch a description to make it fit; a wrong pick and a null are both wrong, but pretending coverage hides the real failure.\n- Answer every prompt exactly once, in the order given.\n\nOutput STRICT JSON, no markdown fence, no prose:\n{\"verdicts\":[{\"prompt\":0,\"capability\":\"explore\"},{\"prompt\":1,\"capability\":null}]}`;\n\nfunction buildPrompt(candidates: readonly TriggerCandidate[], prompts: readonly string[]): string {\n\tconst lines: string[] = [\"CAPABILITIES:\"];\n\tfor (const [i, candidate] of candidates.entries()) {\n\t\tlines.push(`${i}. ${candidate.name} — ${candidate.description.slice(0, DESCRIPTION_CHARS)}`);\n\t}\n\tlines.push(\"\", \"PROMPTS:\");\n\tfor (const [i, prompt] of prompts.entries()) {\n\t\tlines.push(`${i}. ${prompt}`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/**\n * Read the verdict list back, positionally.\n *\n * Returns one entry per prompt no matter what came back: a missing or\n * unparseable row becomes null (read as \"nothing fired\") rather than shifting\n * every later verdict onto the wrong prompt. `runTriggerEval` rejects a\n * length mismatch outright, so the alternative to filling the gaps is\n * discarding the whole run — and a hallucinated capability name is a real\n * signal about the candidate list, not a reason to throw the batch away.\n */\nexport function parseTriggerVerdicts(\n\tresponse: string,\n\tcandidates: readonly TriggerCandidate[],\n\tpromptCount: number,\n): TriggerJudgeVerdict[] {\n\tconst verdicts: TriggerJudgeVerdict[] = new Array(promptCount).fill(null);\n\tconst start = response.indexOf(\"{\");\n\tconst end = response.lastIndexOf(\"}\");\n\tif (start < 0 || end <= start) return verdicts;\n\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(response.slice(start, end + 1));\n\t} catch {\n\t\treturn verdicts;\n\t}\n\n\tconst rows = (parsed as { verdicts?: unknown })?.verdicts;\n\tif (!Array.isArray(rows)) return verdicts;\n\n\tconst known = new Set(candidates.map((c) => c.name));\n\tfor (const row of rows) {\n\t\tif (!row || typeof row !== \"object\") continue;\n\t\tconst entry = row as Record<string, unknown>;\n\t\tconst index = typeof entry.prompt === \"number\" ? entry.prompt : Number.NaN;\n\t\tif (!Number.isInteger(index) || index < 0 || index >= promptCount) continue;\n\t\tconst capability = entry.capability;\n\t\tif (capability === null || capability === undefined) {\n\t\t\tverdicts[index] = null;\n\t\t\tcontinue;\n\t\t}\n\t\t// A name that is not on the candidate list is a hallucination. Recording it\n\t\t// as null keeps it wrong without letting it masquerade as a real pick.\n\t\tverdicts[index] = typeof capability === \"string\" && known.has(capability) ? capability : null;\n\t}\n\treturn verdicts;\n}\n\nexport interface TriggerJudgeDeps {\n\tmodel: Model<any>;\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tsignal?: AbortSignal;\n}\n\n/** A {@link TriggerJudge} backed by a real model. */\nexport function createLlmTriggerJudge(deps: TriggerJudgeDeps): TriggerJudge {\n\treturn async ({ candidates, prompts }) => {\n\t\tif (candidates.length === 0 || prompts.length === 0) return prompts.map(() => null);\n\n\t\tconst response = await completeSimple(\n\t\t\tdeps.model,\n\t\t\t{\n\t\t\t\tsystemPrompt: JUDGE_SYSTEM_PROMPT,\n\t\t\t\tmessages: [\n\t\t\t\t\t{\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: buildPrompt(candidates, prompts) }],\n\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t{ maxTokens: MAX_RESPONSE_TOKENS, signal: deps.signal, apiKey: deps.apiKey, headers: deps.headers },\n\t\t);\n\n\t\tif (response.stopReason === \"error\") {\n\t\t\t// Thrown, not swallowed: runTriggerEval turns this into `not-run` with\n\t\t\t// the reason attached, which is the honest outcome. Returning nulls\n\t\t\t// would score every case as \"nothing fired\" and read like a real result.\n\t\t\tthrow new Error(response.errorMessage || \"trigger judge call failed\");\n\t\t}\n\n\t\tconst text = response.content\n\t\t\t.filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n\t\t\t.map((c) => c.text)\n\t\t\t.join(\"\\n\");\n\t\treturn parseTriggerVerdicts(text, candidates, prompts.length);\n\t};\n}\n"]}

package/dist/core/external-tools.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The external (Rust) binaries hoocode can use, and what each one is worth.
+ *
+ * hoocode is self-sufficient without any of them: `grep`/`find`/`search` fall
+ * back to pure-JS implementations, and the features that have no fallback
+ * (web, voice) are off or inert rather than broken. These binaries are an
+ * *expansion* layer, which is exactly why they were invisible - nothing failed
+ * loudly enough to tell anyone they existed.
+ *
+ * This module is the single description of that layer. The `/settings` pane
+ * renders it; the same table says which settings rows are gated on a binary, so
+ * a row that cannot do anything today can say so instead of lying.
+ */
+import { type ManagedTool, type ManagedToolStatus } from "../utils/tools-manager.js";
+/** How hoocode gets a binary it does not already have. */
+export type Acquisition = 
+/** Fetched in the background at startup. */
+"startup"
+/** Fetched the first time the feature is actually used. */
+ | "on-demand"
+/** Never fetched implicitly; install it yourself or point the env var at it. */
+ | "manual";
+export interface ExternalToolDoc {
+    tool: ManagedTool;
+    /** Row label in the pane. */
+    label: string;
+    /** What the binary does for hoocode, in one line. */
+    summary: string;
+    /** What it turns on, feature by feature. */
+    enables: string[];
+    /** What hoocode does instead when it is missing. Never "nothing works". */
+    fallback: string;
+    acquisition: Acquisition;
+    /** Env vars that change how this binary is resolved or driven. */
+    env: string[];
+    /**
+     * `/settings` row ids whose effect depends on this binary. A row listed here
+     * is annotated (not hidden) while the binary is missing: hiding it would
+     * recreate the discoverability hole this whole surface exists to close.
+     */
+    dependentRows: string[];
+    /** settings.json keys this binary gates, for docs and search. */
+    settingsKeys: string[];
+}
+/**
+ * Ordered so the two that silently make everything faster come first, then the
+ * three that add capability hoocode does not otherwise have.
+ */
+export declare const EXTERNAL_TOOLS: readonly ExternalToolDoc[];
+export interface ExternalToolStatus extends ExternalToolDoc, ManagedToolStatus {
+    installed: boolean;
+    /**
+     * Whether hoocode would fetch it if the feature were used right now. False in
+     * offline mode, and on Android where the published Linux builds do not run.
+     */
+    downloadable: boolean;
+}
+/** Short, fixed-width-ish status word for the pane's value column. */
+export declare function statusLabel(status: ExternalToolStatus): string;
+/**
+ * Resolve every external tool. Never downloads: this is what the pane shows
+ * *before* the user opts into anything.
+ */
+export declare function describeExternalTools(): ExternalToolStatus[];
+/** Index of pane-row id -> the tool it needs, for annotating gated rows. */
+export declare function buildRowGates(statuses: readonly ExternalToolStatus[]): Map<string, ExternalToolStatus>;
+//# sourceMappingURL=external-tools.d.ts.map

package/dist/core/external-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-tools.d.ts","sourceRoot":"","sources":["../../src/core/external-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAgC,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnH,0DAA0D;AAC1D,MAAM,MAAM,WAAW;AACtB,4CAA4C;AAC1C,SAAS;AACX,2DAA2D;GACzD,WAAW;AACb,gFAAgF;GAC9E,QAAQ,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,kEAAkE;IAClE,GAAG,EAAE,MAAM,EAAE,CAAC;IACd;;;;OAIG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EA+DpD,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,eAAe,EAAE,iBAAiB;IAC7E,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAY9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,EAAE,CAY5D;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAMtG","sourcesContent":["/**\n * The external (Rust) binaries hoocode can use, and what each one is worth.\n *\n * hoocode is self-sufficient without any of them: `grep`/`find`/`search` fall\n * back to pure-JS implementations, and the features that have no fallback\n * (web, voice) are off or inert rather than broken. These binaries are an\n * *expansion* layer, which is exactly why they were invisible - nothing failed\n * loudly enough to tell anyone they existed.\n *\n * This module is the single description of that layer. The `/settings` pane\n * renders it; the same table says which settings rows are gated on a binary, so\n * a row that cannot do anything today can say so instead of lying.\n */\n\nimport { getToolStatus, isOfflineMode, type ManagedTool, type ManagedToolStatus } from \"../utils/tools-manager.js\";\n\n/** How hoocode gets a binary it does not already have. */\nexport type Acquisition =\n\t/** Fetched in the background at startup. */\n\t| \"startup\"\n\t/** Fetched the first time the feature is actually used. */\n\t| \"on-demand\"\n\t/** Never fetched implicitly; install it yourself or point the env var at it. */\n\t| \"manual\";\n\nexport interface ExternalToolDoc {\n\ttool: ManagedTool;\n\t/** Row label in the pane. */\n\tlabel: string;\n\t/** What the binary does for hoocode, in one line. */\n\tsummary: string;\n\t/** What it turns on, feature by feature. */\n\tenables: string[];\n\t/** What hoocode does instead when it is missing. Never \"nothing works\". */\n\tfallback: string;\n\tacquisition: Acquisition;\n\t/** Env vars that change how this binary is resolved or driven. */\n\tenv: string[];\n\t/**\n\t * `/settings` row ids whose effect depends on this binary. A row listed here\n\t * is annotated (not hidden) while the binary is missing: hiding it would\n\t * recreate the discoverability hole this whole surface exists to close.\n\t */\n\tdependentRows: string[];\n\t/** settings.json keys this binary gates, for docs and search. */\n\tsettingsKeys: string[];\n}\n\n/**\n * Ordered so the two that silently make everything faster come first, then the\n * three that add capability hoocode does not otherwise have.\n */\nexport const EXTERNAL_TOOLS: readonly ExternalToolDoc[] = [\n\t{\n\t\ttool: \"rg\",\n\t\tlabel: \"ripgrep (rg)\",\n\t\tsummary: \"Fast path for content search.\",\n\t\tenables: [\"grep runs rg instead of the JS scanner\", \"the lexical half of search runs rg\"],\n\t\tfallback:\n\t\t\t\"A pure-JS scanner produces the same match shape, so results are identical - it is materially slower on large trees and respects fewer ignore-file edge cases.\",\n\t\tacquisition: \"startup\",\n\t\tenv: [\"HOOCODE_RG_BINARY\", \"HOOCODE_NATIVE_SEARCH=1 forces the JS path even when rg is present\"],\n\t\tdependentRows: [],\n\t\tsettingsKeys: [],\n\t},\n\t{\n\t\ttool: \"fd\",\n\t\tlabel: \"fd\",\n\t\tsummary: \"Fast path for filename search.\",\n\t\tenables: [\"find runs fd instead of the JS directory walker\"],\n\t\tfallback:\n\t\t\t\"A JS walker produces the same result shape - slower on large trees, and glob/ignore handling is the JS approximation rather than fd's.\",\n\t\tacquisition: \"startup\",\n\t\tenv: [\"HOOCODE_FD_BINARY\", \"HOOCODE_NATIVE_SEARCH=1 forces the JS path even when fd is present\"],\n\t\tdependentRows: [],\n\t\tsettingsKeys: [],\n\t},\n\t{\n\t\ttool: \"embsearch\",\n\t\tlabel: \"embsearch (semantic index)\",\n\t\tsummary: \"Local embedding index. The only source of semantic ranking in hoocode.\",\n\t\tenables: [\n\t\t\t\"search fuses semantic hits with its lexical hits\",\n\t\t\t\"MCP/capability deferral ranks tools by meaning rather than keyword\",\n\t\t],\n\t\tfallback:\n\t\t\t\"search is lexical-only and capability lookup ranks lexically. Nothing errors; queries phrased by intent rather than by token simply rank worse. Requires the ONNX build - the mock build is rejected on purpose, because it would rank at random while looking healthy.\",\n\t\tacquisition: \"on-demand\",\n\t\tenv: [\"HOOCODE_EMBSEARCH_BINARY\"],\n\t\tdependentRows: [\"group:embsearch\"],\n\t\tsettingsKeys: [\"enableEmbsearchTools\", \"embsearchBinaryPath\", \"embsearchThresholdBytes\"],\n\t},\n\t{\n\t\ttool: \"webtools\",\n\t\tlabel: \"webtools (webfetch/websearch)\",\n\t\tsummary: \"The network layer. Without it hoocode has no way to reach the internet.\",\n\t\tenables: [\"the webfetch tool\", \"the websearch tool\"],\n\t\tfallback:\n\t\t\t\"Both tools return an error when called. The web tool group is off by default, so a missing binary is invisible until you turn the group on.\",\n\t\tacquisition: \"on-demand\",\n\t\tenv: [\"HOOCODE_WEBTOOLS_BINARY\", \"HOOCODE_WEBTOOLS_TIMEOUT\"],\n\t\tdependentRows: [\"group:web\", \"webtools-timeout-secs\"],\n\t\tsettingsKeys: [\"enableWebTools\", \"webtools.timeoutSecs\"],\n\t},\n\t{\n\t\ttool: \"voicetools\",\n\t\tlabel: \"voicetools (voice input)\",\n\t\tsummary: \"Microphone capture and transcription for the TUI.\",\n\t\tenables: [\"push-to-talk voice input in the editor\"],\n\t\tfallback: \"Voice capture reports an error and never starts. Typing is unaffected.\",\n\t\tacquisition: \"on-demand\",\n\t\tenv: [\"VOICETOOLS_BIN\", \"HOOCODE_VOICETOOLS_BINARY\", \"VOICETOOLS_SILENCE_MS\"],\n\t\tdependentRows: [\"voice-silence-ms\"],\n\t\tsettingsKeys: [\"voice.silenceMs\"],\n\t},\n];\n\nexport interface ExternalToolStatus extends ExternalToolDoc, ManagedToolStatus {\n\tinstalled: boolean;\n\t/**\n\t * Whether hoocode would fetch it if the feature were used right now. False in\n\t * offline mode, and on Android where the published Linux builds do not run.\n\t */\n\tdownloadable: boolean;\n}\n\n/** Short, fixed-width-ish status word for the pane's value column. */\nexport function statusLabel(status: ExternalToolStatus): string {\n\tif (!status.installed) return status.downloadable ? \"not installed\" : \"unavailable\";\n\tswitch (status.source) {\n\t\tcase \"override\":\n\t\t\treturn \"env override\";\n\t\tcase \"managed\":\n\t\t\treturn \"installed\";\n\t\tcase \"path\":\n\t\t\treturn \"system\";\n\t\tdefault:\n\t\t\treturn \"installed\";\n\t}\n}\n\n/**\n * Resolve every external tool. Never downloads: this is what the pane shows\n * *before* the user opts into anything.\n */\nexport function describeExternalTools(): ExternalToolStatus[] {\n\tconst offline = isOfflineMode();\n\tconst android = process.platform === \"android\";\n\treturn EXTERNAL_TOOLS.map((doc) => {\n\t\tconst status = getToolStatus(doc.tool);\n\t\treturn {\n\t\t\t...doc,\n\t\t\t...status,\n\t\t\tinstalled: status.path !== null,\n\t\t\tdownloadable: !offline && !android && doc.acquisition !== \"manual\",\n\t\t};\n\t});\n}\n\n/** Index of pane-row id -> the tool it needs, for annotating gated rows. */\nexport function buildRowGates(statuses: readonly ExternalToolStatus[]): Map<string, ExternalToolStatus> {\n\tconst gates = new Map<string, ExternalToolStatus>();\n\tfor (const status of statuses) {\n\t\tfor (const rowId of status.dependentRows) gates.set(rowId, status);\n\t}\n\treturn gates;\n}\n"]}

package/dist/core/external-tools.js

@@ -0,0 +1,120 @@
+/**
+ * The external (Rust) binaries hoocode can use, and what each one is worth.
+ *
+ * hoocode is self-sufficient without any of them: `grep`/`find`/`search` fall
+ * back to pure-JS implementations, and the features that have no fallback
+ * (web, voice) are off or inert rather than broken. These binaries are an
+ * *expansion* layer, which is exactly why they were invisible - nothing failed
+ * loudly enough to tell anyone they existed.
+ *
+ * This module is the single description of that layer. The `/settings` pane
+ * renders it; the same table says which settings rows are gated on a binary, so
+ * a row that cannot do anything today can say so instead of lying.
+ */
+import { getToolStatus, isOfflineMode } from "../utils/tools-manager.js";
+/**
+ * Ordered so the two that silently make everything faster come first, then the
+ * three that add capability hoocode does not otherwise have.
+ */
+export const EXTERNAL_TOOLS = [
+    {
+        tool: "rg",
+        label: "ripgrep (rg)",
+        summary: "Fast path for content search.",
+        enables: ["grep runs rg instead of the JS scanner", "the lexical half of search runs rg"],
+        fallback: "A pure-JS scanner produces the same match shape, so results are identical - it is materially slower on large trees and respects fewer ignore-file edge cases.",
+        acquisition: "startup",
+        env: ["HOOCODE_RG_BINARY", "HOOCODE_NATIVE_SEARCH=1 forces the JS path even when rg is present"],
+        dependentRows: [],
+        settingsKeys: [],
+    },
+    {
+        tool: "fd",
+        label: "fd",
+        summary: "Fast path for filename search.",
+        enables: ["find runs fd instead of the JS directory walker"],
+        fallback: "A JS walker produces the same result shape - slower on large trees, and glob/ignore handling is the JS approximation rather than fd's.",
+        acquisition: "startup",
+        env: ["HOOCODE_FD_BINARY", "HOOCODE_NATIVE_SEARCH=1 forces the JS path even when fd is present"],
+        dependentRows: [],
+        settingsKeys: [],
+    },
+    {
+        tool: "embsearch",
+        label: "embsearch (semantic index)",
+        summary: "Local embedding index. The only source of semantic ranking in hoocode.",
+        enables: [
+            "search fuses semantic hits with its lexical hits",
+            "MCP/capability deferral ranks tools by meaning rather than keyword",
+        ],
+        fallback: "search is lexical-only and capability lookup ranks lexically. Nothing errors; queries phrased by intent rather than by token simply rank worse. Requires the ONNX build - the mock build is rejected on purpose, because it would rank at random while looking healthy.",
+        acquisition: "on-demand",
+        env: ["HOOCODE_EMBSEARCH_BINARY"],
+        dependentRows: ["group:embsearch"],
+        settingsKeys: ["enableEmbsearchTools", "embsearchBinaryPath", "embsearchThresholdBytes"],
+    },
+    {
+        tool: "webtools",
+        label: "webtools (webfetch/websearch)",
+        summary: "The network layer. Without it hoocode has no way to reach the internet.",
+        enables: ["the webfetch tool", "the websearch tool"],
+        fallback: "Both tools return an error when called. The web tool group is off by default, so a missing binary is invisible until you turn the group on.",
+        acquisition: "on-demand",
+        env: ["HOOCODE_WEBTOOLS_BINARY", "HOOCODE_WEBTOOLS_TIMEOUT"],
+        dependentRows: ["group:web", "webtools-timeout-secs"],
+        settingsKeys: ["enableWebTools", "webtools.timeoutSecs"],
+    },
+    {
+        tool: "voicetools",
+        label: "voicetools (voice input)",
+        summary: "Microphone capture and transcription for the TUI.",
+        enables: ["push-to-talk voice input in the editor"],
+        fallback: "Voice capture reports an error and never starts. Typing is unaffected.",
+        acquisition: "on-demand",
+        env: ["VOICETOOLS_BIN", "HOOCODE_VOICETOOLS_BINARY", "VOICETOOLS_SILENCE_MS"],
+        dependentRows: ["voice-silence-ms"],
+        settingsKeys: ["voice.silenceMs"],
+    },
+];
+/** Short, fixed-width-ish status word for the pane's value column. */
+export function statusLabel(status) {
+    if (!status.installed)
+        return status.downloadable ? "not installed" : "unavailable";
+    switch (status.source) {
+        case "override":
+            return "env override";
+        case "managed":
+            return "installed";
+        case "path":
+            return "system";
+        default:
+            return "installed";
+    }
+}
+/**
+ * Resolve every external tool. Never downloads: this is what the pane shows
+ * *before* the user opts into anything.
+ */
+export function describeExternalTools() {
+    const offline = isOfflineMode();
+    const android = process.platform === "android";
+    return EXTERNAL_TOOLS.map((doc) => {
+        const status = getToolStatus(doc.tool);
+        return {
+            ...doc,
+            ...status,
+            installed: status.path !== null,
+            downloadable: !offline && !android && doc.acquisition !== "manual",
+        };
+    });
+}
+/** Index of pane-row id -> the tool it needs, for annotating gated rows. */
+export function buildRowGates(statuses) {
+    const gates = new Map();
+    for (const status of statuses) {
+        for (const rowId of status.dependentRows)
+            gates.set(rowId, status);
+    }
+    return gates;
+}
+//# sourceMappingURL=external-tools.js.map

package/dist/core/external-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-tools.js","sourceRoot":"","sources":["../../src/core/external-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The external (Rust) binaries hoocode can use, and what each one is worth.\n *\n * hoocode is self-sufficient without any of them: `grep`/`find`/`search` fall\n * back to pure-JS implementations, and the features that have no fallback\n * (web, voice) are off or inert rather than broken. These binaries are an\n * *expansion* layer, which is exactly why they were invisible - nothing failed\n * loudly enough to tell anyone they existed.\n *\n * This module is the single description of that layer. The `/settings` pane\n * renders it; the same table says which settings rows are gated on a binary, so\n * a row that cannot do anything today can say so instead of lying.\n */\n\nimport { getToolStatus, isOfflineMode, type ManagedTool, type ManagedToolStatus } from \"../utils/tools-manager.js\";\n\n/** How hoocode gets a binary it does not already have. */\nexport type Acquisition =\n\t/** Fetched in the background at startup. */\n\t| \"startup\"\n\t/** Fetched the first time the feature is actually used. */\n\t| \"on-demand\"\n\t/** Never fetched implicitly; install it yourself or point the env var at it. */\n\t| \"manual\";\n\nexport interface ExternalToolDoc {\n\ttool: ManagedTool;\n\t/** Row label in the pane. */\n\tlabel: string;\n\t/** What the binary does for hoocode, in one line. */\n\tsummary: string;\n\t/** What it turns on, feature by feature. */\n\tenables: string[];\n\t/** What hoocode does instead when it is missing. Never \"nothing works\". */\n\tfallback: string;\n\tacquisition: Acquisition;\n\t/** Env vars that change how this binary is resolved or driven. */\n\tenv: string[];\n\t/**\n\t * `/settings` row ids whose effect depends on this binary. A row listed here\n\t * is annotated (not hidden) while the binary is missing: hiding it would\n\t * recreate the discoverability hole this whole surface exists to close.\n\t */\n\tdependentRows: string[];\n\t/** settings.json keys this binary gates, for docs and search. */\n\tsettingsKeys: string[];\n}\n\n/**\n * Ordered so the two that silently make everything faster come first, then the\n * three that add capability hoocode does not otherwise have.\n */\nexport const EXTERNAL_TOOLS: readonly ExternalToolDoc[] = [\n\t{\n\t\ttool: \"rg\",\n\t\tlabel: \"ripgrep (rg)\",\n\t\tsummary: \"Fast path for content search.\",\n\t\tenables: [\"grep runs rg instead of the JS scanner\", \"the lexical half of search runs rg\"],\n\t\tfallback:\n\t\t\t\"A pure-JS scanner produces the same match shape, so results are identical - it is materially slower on large trees and respects fewer ignore-file edge cases.\",\n\t\tacquisition: \"startup\",\n\t\tenv: [\"HOOCODE_RG_BINARY\", \"HOOCODE_NATIVE_SEARCH=1 forces the JS path even when rg is present\"],\n\t\tdependentRows: [],\n\t\tsettingsKeys: [],\n\t},\n\t{\n\t\ttool: \"fd\",\n\t\tlabel: \"fd\",\n\t\tsummary: \"Fast path for filename search.\",\n\t\tenables: [\"find runs fd instead of the JS directory walker\"],\n\t\tfallback:\n\t\t\t\"A JS walker produces the same result shape - slower on large trees, and glob/ignore handling is the JS approximation rather than fd's.\",\n\t\tacquisition: \"startup\",\n\t\tenv: [\"HOOCODE_FD_BINARY\", \"HOOCODE_NATIVE_SEARCH=1 forces the JS path even when fd is present\"],\n\t\tdependentRows: [],\n\t\tsettingsKeys: [],\n\t},\n\t{\n\t\ttool: \"embsearch\",\n\t\tlabel: \"embsearch (semantic index)\",\n\t\tsummary: \"Local embedding index. The only source of semantic ranking in hoocode.\",\n\t\tenables: [\n\t\t\t\"search fuses semantic hits with its lexical hits\",\n\t\t\t\"MCP/capability deferral ranks tools by meaning rather than keyword\",\n\t\t],\n\t\tfallback:\n\t\t\t\"search is lexical-only and capability lookup ranks lexically. Nothing errors; queries phrased by intent rather than by token simply rank worse. Requires the ONNX build - the mock build is rejected on purpose, because it would rank at random while looking healthy.\",\n\t\tacquisition: \"on-demand\",\n\t\tenv: [\"HOOCODE_EMBSEARCH_BINARY\"],\n\t\tdependentRows: [\"group:embsearch\"],\n\t\tsettingsKeys: [\"enableEmbsearchTools\", \"embsearchBinaryPath\", \"embsearchThresholdBytes\"],\n\t},\n\t{\n\t\ttool: \"webtools\",\n\t\tlabel: \"webtools (webfetch/websearch)\",\n\t\tsummary: \"The network layer. Without it hoocode has no way to reach the internet.\",\n\t\tenables: [\"the webfetch tool\", \"the websearch tool\"],\n\t\tfallback:\n\t\t\t\"Both tools return an error when called. The web tool group is off by default, so a missing binary is invisible until you turn the group on.\",\n\t\tacquisition: \"on-demand\",\n\t\tenv: [\"HOOCODE_WEBTOOLS_BINARY\", \"HOOCODE_WEBTOOLS_TIMEOUT\"],\n\t\tdependentRows: [\"group:web\", \"webtools-timeout-secs\"],\n\t\tsettingsKeys: [\"enableWebTools\", \"webtools.timeoutSecs\"],\n\t},\n\t{\n\t\ttool: \"voicetools\",\n\t\tlabel: \"voicetools (voice input)\",\n\t\tsummary: \"Microphone capture and transcription for the TUI.\",\n\t\tenables: [\"push-to-talk voice input in the editor\"],\n\t\tfallback: \"Voice capture reports an error and never starts. Typing is unaffected.\",\n\t\tacquisition: \"on-demand\",\n\t\tenv: [\"VOICETOOLS_BIN\", \"HOOCODE_VOICETOOLS_BINARY\", \"VOICETOOLS_SILENCE_MS\"],\n\t\tdependentRows: [\"voice-silence-ms\"],\n\t\tsettingsKeys: [\"voice.silenceMs\"],\n\t},\n];\n\nexport interface ExternalToolStatus extends ExternalToolDoc, ManagedToolStatus {\n\tinstalled: boolean;\n\t/**\n\t * Whether hoocode would fetch it if the feature were used right now. False in\n\t * offline mode, and on Android where the published Linux builds do not run.\n\t */\n\tdownloadable: boolean;\n}\n\n/** Short, fixed-width-ish status word for the pane's value column. */\nexport function statusLabel(status: ExternalToolStatus): string {\n\tif (!status.installed) return status.downloadable ? \"not installed\" : \"unavailable\";\n\tswitch (status.source) {\n\t\tcase \"override\":\n\t\t\treturn \"env override\";\n\t\tcase \"managed\":\n\t\t\treturn \"installed\";\n\t\tcase \"path\":\n\t\t\treturn \"system\";\n\t\tdefault:\n\t\t\treturn \"installed\";\n\t}\n}\n\n/**\n * Resolve every external tool. Never downloads: this is what the pane shows\n * *before* the user opts into anything.\n */\nexport function describeExternalTools(): ExternalToolStatus[] {\n\tconst offline = isOfflineMode();\n\tconst android = process.platform === \"android\";\n\treturn EXTERNAL_TOOLS.map((doc) => {\n\t\tconst status = getToolStatus(doc.tool);\n\t\treturn {\n\t\t\t...doc,\n\t\t\t...status,\n\t\t\tinstalled: status.path !== null,\n\t\t\tdownloadable: !offline && !android && doc.acquisition !== \"manual\",\n\t\t};\n\t});\n}\n\n/** Index of pane-row id -> the tool it needs, for annotating gated rows. */\nexport function buildRowGates(statuses: readonly ExternalToolStatus[]): Map<string, ExternalToolStatus> {\n\tconst gates = new Map<string, ExternalToolStatus>();\n\tfor (const status of statuses) {\n\t\tfor (const rowId of status.dependentRows) gates.set(rowId, status);\n\t}\n\treturn gates;\n}\n"]}

package/dist/core/keybindings.d.ts

@@ -9,6 +9,10 @@ interface AppKeybindings {
     "app.model.cycleBackward": true;
     "app.model.select": true;
     "app.tools.expand": true;
+    "app.view.cycleForward": true;
+    "app.view.cycleBackward": true;
+    "app.tools.unfoldOne": true;
+    "app.tools.foldOne": true;
     "app.thinking.toggle": true;
     "app.tasks.cycleView": true;
     "app.team.focus": true;
@@ -24,6 +28,10 @@ interface AppKeybindings {
     "app.session.tree": true;
     "app.session.fork": true;
     "app.session.resume": true;
+    "app.session.changeDirectory": true;
+    "app.settings.open": true;
+    "app.hotkeys.open": true;
+    "app.mode.cycle": true;
     "app.tree.foldOrUp": true;
     "app.tree.unfoldOrDown": true;
     "app.tree.editLabel": true;
@@ -52,6 +60,38 @@ declare module "@kolisachint/hoocode-tui" {
     interface Keybindings extends AppKeybindings {
     }
 }
+/**
+ * The cockpit layout.
+ *
+ * Three rings, and which ring a key belongs to is decided by its modifier:
+ *
+ * - **ctrl — the view.** What is on screen right now: expand, thinking blocks,
+ *   task panel, model cycling. Pressed many times a minute, so they sit under
+ *   the hand and never require a second modifier.
+ * - **alt — the cockpit.** What the agent *is* and where it works: model,
+ *   mode, working directory, settings, sessions. Pressed a few times a session.
+ * - **overlays.** Inside a picker, the query line is a text field, so every
+ *   `ctrl+<letter>` there belongs to the *text* (ctrl+a start of line, ctrl+u
+ *   kill line, ctrl+w kill word). A picker's own verbs are therefore all on
+ *   `alt+<letter>`, mnemonic to that picker; the picker captures keys while it
+ *   is open, so reusing a global letter there is unambiguous.
+ *
+ * Two rules keep the set learnable: shift reverses whatever the unshifted key
+ * does, and no binding takes a key the editor or the terminal already owns
+ * (ctrl+a/e/b/f/k/u/w/y/d/l/r/g, ctrl+s XOFF, ctrl+m == enter, ctrl+i == tab).
+ *
+ * Two constraints from the key parser shape which alt keys are usable at all,
+ * and `test/keybinding-layout.test.ts` holds both:
+ *
+ * - Only `alt+<letter>` and `alt+<digit>` survive a terminal without the Kitty
+ *   keyboard protocol. `alt+[` and `alt+]` arrive as the CSI and OSC
+ *   introducers and are not parsed as keys; nor is any shift-modified key, so a
+ *   `shift+…` default is a Kitty-only convenience on top of an unshifted key
+ *   that works everywhere (as `shift+ctrl+p` has always been).
+ * - Legacy `alt+p` and `alt+n` are also accepted as `alt+up` and `alt+down`
+ *   (the emacs previous/next aliases), so no scope may bind both halves of
+ *   either pair.
+ */
 export declare const KEYBINDINGS: {
     readonly "tui.editor.cursorUp": {
         readonly defaultKeys: "up";
@@ -206,12 +246,28 @@ export declare const KEYBINDINGS: {
         readonly description: "Cycle to previous model";
     };
     readonly "app.model.select": {
-        readonly defaultKeys: "ctrl+l";
+        readonly defaultKeys: "alt+m";
         readonly description: "Open model selector";
     };
     readonly "app.tools.expand": {
         readonly defaultKeys: "ctrl+o";
-        readonly description: "Toggle tool output";
+        readonly description: "Expand or collapse what is in front of you (tool bodies, header, summaries)";
+    };
+    readonly "app.view.cycleForward": {
+        readonly defaultKeys: "alt+o";
+        readonly description: "Cycle tool output view (radar → glance → full)";
+    };
+    readonly "app.view.cycleBackward": {
+        readonly defaultKeys: "shift+alt+o";
+        readonly description: "Cycle tool output view backward";
+    };
+    readonly "app.tools.unfoldOne": {
+        readonly defaultKeys: "alt+u";
+        readonly description: "Open the newest folded thing — a chain in radar, a tool body otherwise";
+    };
+    readonly "app.tools.foldOne": {
+        readonly defaultKeys: "shift+alt+u";
+        readonly description: "Re-fold the most recently opened chain or tool block";
     };
     readonly "app.thinking.toggle": {
         readonly defaultKeys: "ctrl+t";
@@ -221,10 +277,6 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+n";
         readonly description: "Cycle task panel view (tasks → subagents → teams, skips empty lenses)";
     };
-    readonly "app.session.toggleNamedFilter": {
-        readonly defaultKeys: "ctrl+n";
-        readonly description: "Toggle named session filter";
-    };
     readonly "app.team.focus": {
         readonly defaultKeys: "alt+n";
         readonly description: "Focus the team roster (navigate roles, n nudge, a attach)";
@@ -238,7 +290,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Attach to the selected team role (team focus mode)";
     };
     readonly "app.editor.external": {
-        readonly defaultKeys: "ctrl+g";
+        readonly defaultKeys: "alt+e";
         readonly description: "Open external editor";
     };
     readonly "app.message.followUp": {
@@ -254,24 +306,40 @@ export declare const KEYBINDINGS: {
         readonly description: "Paste image from clipboard";
     };
     readonly "app.input.voiceTranscribe": {
-        readonly defaultKeys: "ctrl+r";
+        readonly defaultKeys: "alt+r";
         readonly description: "Record voice and transcribe into the editor";
     };
     readonly "app.session.new": {
         readonly defaultKeys: [];
         readonly description: "Start a new session";
     };
-    readonly "app.session.tree": {
-        readonly defaultKeys: [];
-        readonly description: "Open session tree";
-    };
     readonly "app.session.fork": {
         readonly defaultKeys: [];
         readonly description: "Fork current session";
     };
+    readonly "app.session.tree": {
+        readonly defaultKeys: "alt+t";
+        readonly description: "Open session tree";
+    };
     readonly "app.session.resume": {
-        readonly defaultKeys: [];
-        readonly description: "Resume a session";
+        readonly defaultKeys: "alt+h";
+        readonly description: "Resume a session from history";
+    };
+    readonly "app.session.changeDirectory": {
+        readonly defaultKeys: "alt+w";
+        readonly description: "Change working directory (move to another repo without quitting)";
+    };
+    readonly "app.settings.open": {
+        readonly defaultKeys: "alt+s";
+        readonly description: "Open settings";
+    };
+    readonly "app.hotkeys.open": {
+        readonly defaultKeys: "alt+k";
+        readonly description: "Show keyboard shortcuts";
+    };
+    readonly "app.mode.cycle": {
+        readonly defaultKeys: "alt+g";
+        readonly description: "Cycle agent mode (ask → plan → build → debug)";
     };
     readonly "app.tree.foldOrUp": {
         readonly defaultKeys: ["ctrl+left", "alt+left"];
@@ -290,19 +358,23 @@ export declare const KEYBINDINGS: {
         readonly description: "Toggle tree label timestamps";
     };
     readonly "app.session.togglePath": {
-        readonly defaultKeys: "ctrl+p";
+        readonly defaultKeys: "alt+p";
         readonly description: "Toggle session path display";
     };
     readonly "app.session.toggleSort": {
-        readonly defaultKeys: "ctrl+s";
-        readonly description: "Toggle session sort mode";
+        readonly defaultKeys: "alt+o";
+        readonly description: "Toggle session sort order";
     };
     readonly "app.session.rename": {
-        readonly defaultKeys: "ctrl+r";
+        readonly defaultKeys: "alt+r";
         readonly description: "Rename session";
     };
+    readonly "app.session.toggleNamedFilter": {
+        readonly defaultKeys: "alt+n";
+        readonly description: "Toggle named session filter";
+    };
     readonly "app.session.delete": {
-        readonly defaultKeys: "ctrl+d";
+        readonly defaultKeys: "alt+x";
         readonly description: "Delete session";
     };
     readonly "app.session.deleteNoninvasive": {
@@ -310,19 +382,19 @@ export declare const KEYBINDINGS: {
         readonly description: "Delete session when query is empty";
     };
     readonly "app.models.save": {
-        readonly defaultKeys: "ctrl+s";
+        readonly defaultKeys: "alt+s";
         readonly description: "Save model selection";
     };
     readonly "app.models.enableAll": {
-        readonly defaultKeys: "ctrl+a";
+        readonly defaultKeys: "alt+a";
         readonly description: "Enable all models";
     };
     readonly "app.models.clearAll": {
-        readonly defaultKeys: "ctrl+x";
+        readonly defaultKeys: "alt+x";
         readonly description: "Clear all models";
     };
     readonly "app.models.toggleProvider": {
-        readonly defaultKeys: "ctrl+p";
+        readonly defaultKeys: "alt+g";
         readonly description: "Toggle all models for provider";
     };
     readonly "app.models.reorderUp": {
@@ -342,31 +414,31 @@ export declare const KEYBINDINGS: {
         readonly description: "Go back to the previous question";
     };
     readonly "app.tree.filter.default": {
-        readonly defaultKeys: "ctrl+d";
+        readonly defaultKeys: "alt+1";
         readonly description: "Tree filter: default view";
     };
     readonly "app.tree.filter.noTools": {
-        readonly defaultKeys: "ctrl+t";
+        readonly defaultKeys: "alt+2";
         readonly description: "Tree filter: hide tool results";
     };
     readonly "app.tree.filter.userOnly": {
-        readonly defaultKeys: "ctrl+u";
+        readonly defaultKeys: "alt+3";
         readonly description: "Tree filter: user messages only";
     };
     readonly "app.tree.filter.labeledOnly": {
-        readonly defaultKeys: "ctrl+l";
+        readonly defaultKeys: "alt+4";
         readonly description: "Tree filter: labeled entries only";
     };
     readonly "app.tree.filter.all": {
-        readonly defaultKeys: "ctrl+a";
+        readonly defaultKeys: "alt+5";
         readonly description: "Tree filter: show all entries";
     };
     readonly "app.tree.filter.cycleForward": {
-        readonly defaultKeys: "ctrl+o";
+        readonly defaultKeys: "alt+c";
         readonly description: "Tree filter: cycle forward";
     };
     readonly "app.tree.filter.cycleBackward": {
-        readonly defaultKeys: "shift+ctrl+o";
+        readonly defaultKeys: "shift+alt+c";
         readonly description: "Tree filter: cycle backward";
     };
 };