@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/ashxj-spinners.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=ashxj-spinners.d.ts.map

package/dist/builtin-extensions/ashxj-spinners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ashxj-spinners.d.ts","sourceRoot":"","sources":["../../src/builtin-extensions/ashxj-spinners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAgItF,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CA0K/C","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport { spinners } from \"unicode-animations\";\n\n// Spinners come from the `unicode-animations` package; see\n// https://www.npmjs.com/package/unicode-animations for the full catalog.\n// On each state entry we pick a random spinner from that state's pool, and\n// we re-roll the kaomoji on a timer while the state is active (see\n// KAOMOJI_REROLL_MS), so the working-indicator row keeps varying instead of\n// freezing on one (spinner, kaomoji) pair for the whole state.\ntype SpinnerName = keyof typeof spinners;\n\ntype State = \"idle\" | \"startup\" | \"thinking\" | \"searching\" | \"editing\" | \"toolRunning\" | \"complete\" | \"error\";\n\n// `thinking` and `toolRunning` share one combined pool for both spinners and\n// kaomoji, so the two states are visually interchangeable. The combined\n// spinner pool is the union of the former thinking spinners (rain, breathe,\n// checkerboard, sparkle) and the former toolRunning spinners (braille,\n// snake). The combined kaomoji pool is the union of both former kaomoji\n// sets plus the new toolRunning entries below (6 spinners x 14 kaomoji).\nconst THINKING_TOOL_SPINNER_POOL: readonly SpinnerName[] = [\n  \"rain\",\n  \"breathe\",\n  \"checkerboard\",\n  \"sparkle\",\n  \"braille\",\n  \"snake\",\n];\n\nconst THINKING_TOOL_KAOMOJI_POOL: readonly string[] = [\n  // formerly `thinking`\n  \"(ᵕ—ᴗ—)\",            // determined\n  \"(˵ ¬ᴗ¬˵)\",            // clever\n  \"(⸝⸝ᵕᴗᵕ⸝⸝)\",         // admiring gaze\n  \"⸜(｡˃ ᵕ ˂ )⸝♡\",      // blushing happy\n  \"(˶>⩊<˶)\",            // cheerful\n  \"૮⸝⸝> ̫ <⸝⸝ ა\",      // pleading with worry\n  \"(˶  >   ₃  < ˶)\",     // licking lips\n  // formerly `toolRunning`\n  \"(๑´>᎑<)~*\",          // reaching for hug, eager\n  // new\n  \"₍^. .^₎⟆\",\n  \"(ㅅ´ ˘ `)\",\n  \"(„• ֊ •„)\",\n  \"(˶˃ ᵕ ˂˶)\",\n  \"⡞⠳⣄⣀⣠⠞⢷ ֹ۪\",\n  \"（˶•̀ ᎑-˶）\",\n];\n\nconst SPINNER_POOL_FOR_STATE: Record<State, readonly SpinnerName[]> = {\n  idle:        [],\n  startup:     [],\n  thinking:    THINKING_TOOL_SPINNER_POOL,\n  searching:   [\"diagswipe\", \"scan\", \"cascade\"],\n  editing:     [\"columns\", \"fillsweep\"],\n  toolRunning: THINKING_TOOL_SPINNER_POOL,\n  complete:    [],\n  error:       [\"pulse\"],\n};\n\nconst KAOMOJI_FOR_STATE: Record<State, readonly string[]> = {\n  // idle, startup, complete are silent: no kaomoji.\n  idle:        [],\n  startup:     [],\n  thinking:    THINKING_TOOL_KAOMOJI_POOL,\n  searching:   [\n    \"(⸝⸝⩌ ⤙ ⩌⸝⸝)\",       // confused\n    \"(╹ -╹)?\",             // questioning\n  ],\n  editing:     [\n    \"(ᵕ • ᴗ •)\",           // content\n    \"(˶ᵔ ᵕ ᵔ˶) ‹𝟹\",        // warm with small heart\n    \"(๑ᵔ⤙ᵔ๑)\",            // gleeful\n  ],\n  toolRunning: THINKING_TOOL_KAOMOJI_POOL,\n  complete:    [],\n  error:       [\n    \"(,,>﹏<,,)\",           // crying\n    \"(⸝⸝ ♡﹏♡⸝⸝)\",        // apologetic crying\n    \"\\\"૮₍ ˶•⤙•˶ ₎ა\",     // pleading paws\n    \"(╥﹏╥)\",               // heavy crying\n    \"(˶°ㅁ°)!!\",           // shocked\n    \"(,,•᷄﹏‎•᷅,,)\",       // distressed\n  ],\n};\n\nconst SEARCH_RE = /(search|find|grep|list|ls|fuzzy|query)/i;\nconst EDIT_RE = /(^|[_\\-\\s])(write|edit|patch|create|delete|remove|replace|insert|update|apply_?patch|apply_?edit|str_?replace|str_?replace_?editor|create_?file|delete_?file|write_?file|edit_?file|insert_?content|append_?file|modify_?file)([_\\-\\s]|$)/i;\n\nconst TRANSIENT_MS = 3000;\n// Minimum time a visible \"active\" state must persist before being replaced.\n// Prevents flicker (e.g. error -> thinking clobbering the error before the\n// user can see it). The TTL only gates active->active transitions:\n//   - Active -> active: TTL applies (within 3s, the new state is rejected)\n//   - Active -> silent (idle/startup/complete): TTL bypassed (end-of-turn)\n//   - Active -> error: TTL bypassed (error always wins)\n//   - Silent -> active: TTL bypassed (silent states aren't in STATES_WITH_TTL)\n// Auto-revert timers bypass this by calling doApplyState directly.\nconst STATE_TTL_MS = 3000;\nconst STATES_WITH_TTL: ReadonlySet<State> = new Set<State>([\n  \"thinking\", \"searching\", \"editing\", \"toolRunning\", \"error\",\n]);\nconst SILENT_STATES: ReadonlySet<State> = new Set<State>([\n  \"idle\", \"startup\", \"complete\",\n]);\n\n// How often the kaomoji is re-rolled while an active state is showing. Set\n// long (30 s) so it only kicks in for genuinely long tasks; short states\n// finish before the first re-roll and show a single kaomoji. The spinner is\n// NOT re-rolled on this timer (restarting its animation would stutter); the\n// spinner only changes on state transitions.\nconst KAOMOJI_REROLL_MS = 30000;\n\nfunction pick<T>(arr: readonly T[]): T {\n  return arr[Math.floor(Math.random() * arr.length)]!;\n}\n\n// Like pick, but never returns `current` (so a re-roll always produces a\n// visible change). Pools of length <= 1 can't vary, so they return the\n// sole element unchanged.\nfunction pickOther<T>(arr: readonly T[], current: T): T {\n  if (arr.length <= 1) return arr[0]!;\n  let v: T;\n  do {\n    v = pick(arr);\n  } while (v === current);\n  return v;\n}\n\nexport default function (pi: ExtensionAPI): void {\n  let state: State = \"idle\";\n  let stateEnteredAt = 0;\n  let currentKaomoji = \"\";\n  let transientTimer: ReturnType<typeof setTimeout> | undefined;\n  let rerollTimer: ReturnType<typeof setInterval> | undefined;\n\n  function clearTransient(): void {\n    if (transientTimer !== undefined) {\n      clearTimeout(transientTimer);\n      transientTimer = undefined;\n    }\n  }\n\n  function clearReroll(): void {\n    if (rerollTimer !== undefined) {\n      clearInterval(rerollTimer);\n      rerollTimer = undefined;\n    }\n  }\n\n  function doApplyState(next: State, ctx: ExtensionContext): void {\n    state = next;\n    stateEnteredAt = Date.now();\n\n    const spinnerPool = SPINNER_POOL_FOR_STATE[next];\n    if (spinnerPool.length > 0) {\n      const spinnerName = pick(spinnerPool);\n      const def = spinners[spinnerName];\n      const frames = def.frames.map(f => ctx.ui.theme.fg(\"accent\", f));\n      ctx.ui.setWorkingIndicator({ frames, intervalMs: def.interval });\n    } else {\n      ctx.ui.setWorkingIndicator({ frames: [] });\n    }\n\n    const kaomojiPool = KAOMOJI_FOR_STATE[next];\n    currentKaomoji = kaomojiPool.length > 0 ? pick(kaomojiPool) : \"\";\n    ctx.ui.setWorkingMessage(currentKaomoji);\n\n    clearReroll();\n    clearTransient();\n\n    // Re-roll the kaomoji periodically while an active state is showing, so\n    // a long thinking / toolRunning / error / searching / editing stretch\n    // cycles through kaomoji instead of freezing on one. The spinner stays\n    // put for the whole state (see KAOMOJI_REROLL_MS). Pools of length <= 1\n    // can't vary, so skip them; silent states have empty pools and are also\n    // skipped.\n    if (kaomojiPool.length > 1) {\n      rerollTimer = setInterval(() => rerollKaomoji(ctx), KAOMOJI_REROLL_MS);\n    }\n\n    if (next === \"complete\" || next === \"startup\") {\n      transientTimer = setTimeout(() => doApplyState(\"idle\", ctx), TRANSIENT_MS);\n    }\n  }\n\n  function rerollKaomoji(ctx: ExtensionContext): void {\n    const pool = KAOMOJI_FOR_STATE[state];\n    if (pool.length <= 1) return;\n    currentKaomoji = pickOther(pool, currentKaomoji);\n    ctx.ui.setWorkingMessage(currentKaomoji);\n  }\n\n  function applyState(next: State, ctx: ExtensionContext, options: { force?: boolean } = {}): void {\n    if (ctx.mode !== \"tui\") return;\n    // Enforce minimum TTL on event-driven transitions, with three exceptions:\n    //   - `error` always wins (so tool_execution_end can always set error).\n    //   - Silent states (idle, startup, complete) bypass TTL — they're\n    //     end-of-turn markers, not active states that need minimum display.\n    //     Without this, agent_end within 3s of turn_start would be rejected,\n    //     leaving the spinner stuck in the active state.\n    //   - `force: true` bypasses TTL — used for tool_execution_start so the\n    //     spinner syncs with the tool bubble the moment it appears.\n    // Auto-revert timers bypass this by calling doApplyState directly.\n    if (\n      !options.force &&\n      !SILENT_STATES.has(next) &&\n      next !== \"error\" &&\n      STATES_WITH_TTL.has(state) &&\n      Date.now() - stateEnteredAt < STATE_TTL_MS\n    ) {\n      return;\n    }\n    doApplyState(next, ctx);\n  }\n\n  pi.on(\"session_start\", (event, ctx) => {\n    if (ctx.mode !== \"tui\") return;\n    ctx.ui.setTitle(\"ashxj\");\n    doApplyState(event.reason === \"startup\" ? \"startup\" : \"idle\", ctx);\n  });\n\n  pi.on(\"turn_start\", (_event, ctx) => {\n    applyState(\"thinking\", ctx);\n  });\n\n  pi.on(\"tool_execution_start\", (event, ctx) => {\n    // Hook on tool_execution_start (not tool_call) so the spinner activates\n    // at the same moment the tool bubble appears in the UI. tool_call fires\n    // earlier (when the LLM decides to call the tool, before execution), and\n    // the bubble only appears once the tool actually starts — so hooking on\n    // tool_call creates a visual desync between spinner and bubble.\n    // Bonus: tools blocked at tool_call never run, so tool_execution_start\n    // won't fire and the spinner won't activate for blocked tools.\n    // `force: true` bypasses the 3s TTL so the spinner syncs with the\n    // bubble immediately, even if the previous active state is still\n    // within its minimum display window.\n    if (state === \"error\") return;\n    const name = event.toolName;\n    const force = true;\n    if (SEARCH_RE.test(name)) {\n      applyState(\"searching\", ctx, { force });\n    } else if (EDIT_RE.test(name)) {\n      applyState(\"editing\", ctx, { force });\n    } else {\n      applyState(\"toolRunning\", ctx, { force });\n    }\n  });\n\n  pi.on(\"tool_execution_end\", (event, ctx) => {\n    if (event.isError) {\n      applyState(\"error\", ctx);\n    }\n  });\n\n  pi.on(\"turn_end\", (_event, ctx) => {\n    // A turn that ran a tool ends with the spinner still on the tool state\n    // (searching/editing/toolRunning). The next turn_start would revert to\n    // thinking, but it's TTL-gated and gets rejected for fast tools (<3s),\n    // which leaves the spinner stuck on the tool state for the whole next\n    // turn. Revert to thinking here, right after the turn's tools finish.\n    // turn_end fires once per turn after all its (concurrent) tools\n    // complete, so this is safe for parallel tool calls. Only force out of\n    // tool states, never out of error (error has priority and is handled\n    // by agent_end). No-op on turns that had no tools (state is already\n    // thinking).\n    if (state === \"searching\" || state === \"editing\" || state === \"toolRunning\") {\n      applyState(\"thinking\", ctx, { force: true });\n    }\n  });\n\n  pi.on(\"agent_end\", (event, ctx) => {\n    const last = event.messages.at(-1);\n    if (!last || last.role !== \"assistant\") {\n      applyState(\"idle\", ctx);\n      return;\n    }\n    const stopReason = (last as { stopReason?: string }).stopReason;\n    if (stopReason === \"stop\" || stopReason === \"length\") {\n      applyState(\"complete\", ctx);\n    } else if (stopReason === \"error\" || stopReason === \"aborted\") {\n      applyState(\"error\", ctx);\n    } else if (stopReason === \"toolUse\") {\n    } else {\n      applyState(\"idle\", ctx);\n    }\n  });\n\n  pi.on(\"session_shutdown\", (_event, ctx) => {\n    clearTransient();\n    clearReroll();\n    if (ctx.mode === \"tui\") {\n      ctx.ui.setWorkingIndicator({ frames: [] });\n      ctx.ui.setWorkingMessage(\"\");\n    }\n    state = \"idle\";\n    stateEnteredAt = 0;\n    currentKaomoji = \"\";\n  });\n}"]}

package/dist/builtin-extensions/ashxj-spinners.js

@@ -0,0 +1,271 @@
+import { spinners } from "unicode-animations";
+// `thinking` and `toolRunning` share one combined pool for both spinners and
+// kaomoji, so the two states are visually interchangeable. The combined
+// spinner pool is the union of the former thinking spinners (rain, breathe,
+// checkerboard, sparkle) and the former toolRunning spinners (braille,
+// snake). The combined kaomoji pool is the union of both former kaomoji
+// sets plus the new toolRunning entries below (6 spinners x 14 kaomoji).
+const THINKING_TOOL_SPINNER_POOL = [
+    "rain",
+    "breathe",
+    "checkerboard",
+    "sparkle",
+    "braille",
+    "snake",
+];
+const THINKING_TOOL_KAOMOJI_POOL = [
+    // formerly `thinking`
+    "(ᵕ—ᴗ—)", // determined
+    "(˵ ¬ᴗ¬˵)", // clever
+    "(⸝⸝ᵕᴗᵕ⸝⸝)", // admiring gaze
+    "⸜(｡˃ ᵕ ˂ )⸝♡", // blushing happy
+    "(˶>⩊<˶)", // cheerful
+    "૮⸝⸝> ̫ <⸝⸝ ა", // pleading with worry
+    "(˶  >   ₃  < ˶)", // licking lips
+    // formerly `toolRunning`
+    "(๑´>᎑<)~*", // reaching for hug, eager
+    // new
+    "₍^. .^₎⟆",
+    "(ㅅ´ ˘ `)",
+    "(„• ֊ •„)",
+    "(˶˃ ᵕ ˂˶)",
+    "⡞⠳⣄⣀⣠⠞⢷ ֹ۪",
+    "（˶•̀ ᎑-˶）",
+];
+const SPINNER_POOL_FOR_STATE = {
+    idle: [],
+    startup: [],
+    thinking: THINKING_TOOL_SPINNER_POOL,
+    searching: ["diagswipe", "scan", "cascade"],
+    editing: ["columns", "fillsweep"],
+    toolRunning: THINKING_TOOL_SPINNER_POOL,
+    complete: [],
+    error: ["pulse"],
+};
+const KAOMOJI_FOR_STATE = {
+    // idle, startup, complete are silent: no kaomoji.
+    idle: [],
+    startup: [],
+    thinking: THINKING_TOOL_KAOMOJI_POOL,
+    searching: [
+        "(⸝⸝⩌ ⤙ ⩌⸝⸝)", // confused
+        "(╹ -╹)?", // questioning
+    ],
+    editing: [
+        "(ᵕ • ᴗ •)", // content
+        "(˶ᵔ ᵕ ᵔ˶) ‹𝟹", // warm with small heart
+        "(๑ᵔ⤙ᵔ๑)", // gleeful
+    ],
+    toolRunning: THINKING_TOOL_KAOMOJI_POOL,
+    complete: [],
+    error: [
+        "(,,>﹏<,,)", // crying
+        "(⸝⸝ ♡﹏♡⸝⸝)", // apologetic crying
+        "\"૮₍ ˶•⤙•˶ ₎ა", // pleading paws
+        "(╥﹏╥)", // heavy crying
+        "(˶°ㅁ°)!!", // shocked
+        "(,,•᷄﹏‎•᷅,,)", // distressed
+    ],
+};
+const SEARCH_RE = /(search|find|grep|list|ls|fuzzy|query)/i;
+const EDIT_RE = /(^|[_\-\s])(write|edit|patch|create|delete|remove|replace|insert|update|apply_?patch|apply_?edit|str_?replace|str_?replace_?editor|create_?file|delete_?file|write_?file|edit_?file|insert_?content|append_?file|modify_?file)([_\-\s]|$)/i;
+const TRANSIENT_MS = 3000;
+// Minimum time a visible "active" state must persist before being replaced.
+// Prevents flicker (e.g. error -> thinking clobbering the error before the
+// user can see it). The TTL only gates active->active transitions:
+//   - Active -> active: TTL applies (within 3s, the new state is rejected)
+//   - Active -> silent (idle/startup/complete): TTL bypassed (end-of-turn)
+//   - Active -> error: TTL bypassed (error always wins)
+//   - Silent -> active: TTL bypassed (silent states aren't in STATES_WITH_TTL)
+// Auto-revert timers bypass this by calling doApplyState directly.
+const STATE_TTL_MS = 3000;
+const STATES_WITH_TTL = new Set([
+    "thinking", "searching", "editing", "toolRunning", "error",
+]);
+const SILENT_STATES = new Set([
+    "idle", "startup", "complete",
+]);
+// How often the kaomoji is re-rolled while an active state is showing. Set
+// long (30 s) so it only kicks in for genuinely long tasks; short states
+// finish before the first re-roll and show a single kaomoji. The spinner is
+// NOT re-rolled on this timer (restarting its animation would stutter); the
+// spinner only changes on state transitions.
+const KAOMOJI_REROLL_MS = 30000;
+function pick(arr) {
+    return arr[Math.floor(Math.random() * arr.length)];
+}
+// Like pick, but never returns `current` (so a re-roll always produces a
+// visible change). Pools of length <= 1 can't vary, so they return the
+// sole element unchanged.
+function pickOther(arr, current) {
+    if (arr.length <= 1)
+        return arr[0];
+    let v;
+    do {
+        v = pick(arr);
+    } while (v === current);
+    return v;
+}
+export default function (pi) {
+    let state = "idle";
+    let stateEnteredAt = 0;
+    let currentKaomoji = "";
+    let transientTimer;
+    let rerollTimer;
+    function clearTransient() {
+        if (transientTimer !== undefined) {
+            clearTimeout(transientTimer);
+            transientTimer = undefined;
+        }
+    }
+    function clearReroll() {
+        if (rerollTimer !== undefined) {
+            clearInterval(rerollTimer);
+            rerollTimer = undefined;
+        }
+    }
+    function doApplyState(next, ctx) {
+        state = next;
+        stateEnteredAt = Date.now();
+        const spinnerPool = SPINNER_POOL_FOR_STATE[next];
+        if (spinnerPool.length > 0) {
+            const spinnerName = pick(spinnerPool);
+            const def = spinners[spinnerName];
+            const frames = def.frames.map(f => ctx.ui.theme.fg("accent", f));
+            ctx.ui.setWorkingIndicator({ frames, intervalMs: def.interval });
+        }
+        else {
+            ctx.ui.setWorkingIndicator({ frames: [] });
+        }
+        const kaomojiPool = KAOMOJI_FOR_STATE[next];
+        currentKaomoji = kaomojiPool.length > 0 ? pick(kaomojiPool) : "";
+        ctx.ui.setWorkingMessage(currentKaomoji);
+        clearReroll();
+        clearTransient();
+        // Re-roll the kaomoji periodically while an active state is showing, so
+        // a long thinking / toolRunning / error / searching / editing stretch
+        // cycles through kaomoji instead of freezing on one. The spinner stays
+        // put for the whole state (see KAOMOJI_REROLL_MS). Pools of length <= 1
+        // can't vary, so skip them; silent states have empty pools and are also
+        // skipped.
+        if (kaomojiPool.length > 1) {
+            rerollTimer = setInterval(() => rerollKaomoji(ctx), KAOMOJI_REROLL_MS);
+        }
+        if (next === "complete" || next === "startup") {
+            transientTimer = setTimeout(() => doApplyState("idle", ctx), TRANSIENT_MS);
+        }
+    }
+    function rerollKaomoji(ctx) {
+        const pool = KAOMOJI_FOR_STATE[state];
+        if (pool.length <= 1)
+            return;
+        currentKaomoji = pickOther(pool, currentKaomoji);
+        ctx.ui.setWorkingMessage(currentKaomoji);
+    }
+    function applyState(next, ctx, options = {}) {
+        if (ctx.mode !== "tui")
+            return;
+        // Enforce minimum TTL on event-driven transitions, with three exceptions:
+        //   - `error` always wins (so tool_execution_end can always set error).
+        //   - Silent states (idle, startup, complete) bypass TTL — they're
+        //     end-of-turn markers, not active states that need minimum display.
+        //     Without this, agent_end within 3s of turn_start would be rejected,
+        //     leaving the spinner stuck in the active state.
+        //   - `force: true` bypasses TTL — used for tool_execution_start so the
+        //     spinner syncs with the tool bubble the moment it appears.
+        // Auto-revert timers bypass this by calling doApplyState directly.
+        if (!options.force &&
+            !SILENT_STATES.has(next) &&
+            next !== "error" &&
+            STATES_WITH_TTL.has(state) &&
+            Date.now() - stateEnteredAt < STATE_TTL_MS) {
+            return;
+        }
+        doApplyState(next, ctx);
+    }
+    pi.on("session_start", (event, ctx) => {
+        if (ctx.mode !== "tui")
+            return;
+        ctx.ui.setTitle("ashxj");
+        doApplyState(event.reason === "startup" ? "startup" : "idle", ctx);
+    });
+    pi.on("turn_start", (_event, ctx) => {
+        applyState("thinking", ctx);
+    });
+    pi.on("tool_execution_start", (event, ctx) => {
+        // Hook on tool_execution_start (not tool_call) so the spinner activates
+        // at the same moment the tool bubble appears in the UI. tool_call fires
+        // earlier (when the LLM decides to call the tool, before execution), and
+        // the bubble only appears once the tool actually starts — so hooking on
+        // tool_call creates a visual desync between spinner and bubble.
+        // Bonus: tools blocked at tool_call never run, so tool_execution_start
+        // won't fire and the spinner won't activate for blocked tools.
+        // `force: true` bypasses the 3s TTL so the spinner syncs with the
+        // bubble immediately, even if the previous active state is still
+        // within its minimum display window.
+        if (state === "error")
+            return;
+        const name = event.toolName;
+        const force = true;
+        if (SEARCH_RE.test(name)) {
+            applyState("searching", ctx, { force });
+        }
+        else if (EDIT_RE.test(name)) {
+            applyState("editing", ctx, { force });
+        }
+        else {
+            applyState("toolRunning", ctx, { force });
+        }
+    });
+    pi.on("tool_execution_end", (event, ctx) => {
+        if (event.isError) {
+            applyState("error", ctx);
+        }
+    });
+    pi.on("turn_end", (_event, ctx) => {
+        // A turn that ran a tool ends with the spinner still on the tool state
+        // (searching/editing/toolRunning). The next turn_start would revert to
+        // thinking, but it's TTL-gated and gets rejected for fast tools (<3s),
+        // which leaves the spinner stuck on the tool state for the whole next
+        // turn. Revert to thinking here, right after the turn's tools finish.
+        // turn_end fires once per turn after all its (concurrent) tools
+        // complete, so this is safe for parallel tool calls. Only force out of
+        // tool states, never out of error (error has priority and is handled
+        // by agent_end). No-op on turns that had no tools (state is already
+        // thinking).
+        if (state === "searching" || state === "editing" || state === "toolRunning") {
+            applyState("thinking", ctx, { force: true });
+        }
+    });
+    pi.on("agent_end", (event, ctx) => {
+        const last = event.messages.at(-1);
+        if (!last || last.role !== "assistant") {
+            applyState("idle", ctx);
+            return;
+        }
+        const stopReason = last.stopReason;
+        if (stopReason === "stop" || stopReason === "length") {
+            applyState("complete", ctx);
+        }
+        else if (stopReason === "error" || stopReason === "aborted") {
+            applyState("error", ctx);
+        }
+        else if (stopReason === "toolUse") {
+        }
+        else {
+            applyState("idle", ctx);
+        }
+    });
+    pi.on("session_shutdown", (_event, ctx) => {
+        clearTransient();
+        clearReroll();
+        if (ctx.mode === "tui") {
+            ctx.ui.setWorkingIndicator({ frames: [] });
+            ctx.ui.setWorkingMessage("");
+        }
+        state = "idle";
+        stateEnteredAt = 0;
+        currentKaomoji = "";
+    });
+}
+//# sourceMappingURL=ashxj-spinners.js.map

package/dist/builtin-extensions/ashxj-spinners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ashxj-spinners.js","sourceRoot":"","sources":["../../src/builtin-extensions/ashxj-spinners.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport { spinners } from \"unicode-animations\";\n\n// Spinners come from the `unicode-animations` package; see\n// https://www.npmjs.com/package/unicode-animations for the full catalog.\n// On each state entry we pick a random spinner from that state's pool, and\n// we re-roll the kaomoji on a timer while the state is active (see\n// KAOMOJI_REROLL_MS), so the working-indicator row keeps varying instead of\n// freezing on one (spinner, kaomoji) pair for the whole state.\ntype SpinnerName = keyof typeof spinners;\n\ntype State = \"idle\" | \"startup\" | \"thinking\" | \"searching\" | \"editing\" | \"toolRunning\" | \"complete\" | \"error\";\n\n// `thinking` and `toolRunning` share one combined pool for both spinners and\n// kaomoji, so the two states are visually interchangeable. The combined\n// spinner pool is the union of the former thinking spinners (rain, breathe,\n// checkerboard, sparkle) and the former toolRunning spinners (braille,\n// snake). The combined kaomoji pool is the union of both former kaomoji\n// sets plus the new toolRunning entries below (6 spinners x 14 kaomoji).\nconst THINKING_TOOL_SPINNER_POOL: readonly SpinnerName[] = [\n  \"rain\",\n  \"breathe\",\n  \"checkerboard\",\n  \"sparkle\",\n  \"braille\",\n  \"snake\",\n];\n\nconst THINKING_TOOL_KAOMOJI_POOL: readonly string[] = [\n  // formerly `thinking`\n  \"(ᵕ—ᴗ—)\",            // determined\n  \"(˵ ¬ᴗ¬˵)\",            // clever\n  \"(⸝⸝ᵕᴗᵕ⸝⸝)\",         // admiring gaze\n  \"⸜(｡˃ ᵕ ˂ )⸝♡\",      // blushing happy\n  \"(˶>⩊<˶)\",            // cheerful\n  \"૮⸝⸝> ̫ <⸝⸝ ა\",      // pleading with worry\n  \"(˶  >   ₃  < ˶)\",     // licking lips\n  // formerly `toolRunning`\n  \"(๑´>᎑<)~*\",          // reaching for hug, eager\n  // new\n  \"₍^. .^₎⟆\",\n  \"(ㅅ´ ˘ `)\",\n  \"(„• ֊ •„)\",\n  \"(˶˃ ᵕ ˂˶)\",\n  \"⡞⠳⣄⣀⣠⠞⢷ ֹ۪\",\n  \"（˶•̀ ᎑-˶）\",\n];\n\nconst SPINNER_POOL_FOR_STATE: Record<State, readonly SpinnerName[]> = {\n  idle:        [],\n  startup:     [],\n  thinking:    THINKING_TOOL_SPINNER_POOL,\n  searching:   [\"diagswipe\", \"scan\", \"cascade\"],\n  editing:     [\"columns\", \"fillsweep\"],\n  toolRunning: THINKING_TOOL_SPINNER_POOL,\n  complete:    [],\n  error:       [\"pulse\"],\n};\n\nconst KAOMOJI_FOR_STATE: Record<State, readonly string[]> = {\n  // idle, startup, complete are silent: no kaomoji.\n  idle:        [],\n  startup:     [],\n  thinking:    THINKING_TOOL_KAOMOJI_POOL,\n  searching:   [\n    \"(⸝⸝⩌ ⤙ ⩌⸝⸝)\",       // confused\n    \"(╹ -╹)?\",             // questioning\n  ],\n  editing:     [\n    \"(ᵕ • ᴗ •)\",           // content\n    \"(˶ᵔ ᵕ ᵔ˶) ‹𝟹\",        // warm with small heart\n    \"(๑ᵔ⤙ᵔ๑)\",            // gleeful\n  ],\n  toolRunning: THINKING_TOOL_KAOMOJI_POOL,\n  complete:    [],\n  error:       [\n    \"(,,>﹏<,,)\",           // crying\n    \"(⸝⸝ ♡﹏♡⸝⸝)\",        // apologetic crying\n    \"\\\"૮₍ ˶•⤙•˶ ₎ა\",     // pleading paws\n    \"(╥﹏╥)\",               // heavy crying\n    \"(˶°ㅁ°)!!\",           // shocked\n    \"(,,•᷄﹏‎•᷅,,)\",       // distressed\n  ],\n};\n\nconst SEARCH_RE = /(search|find|grep|list|ls|fuzzy|query)/i;\nconst EDIT_RE = /(^|[_\\-\\s])(write|edit|patch|create|delete|remove|replace|insert|update|apply_?patch|apply_?edit|str_?replace|str_?replace_?editor|create_?file|delete_?file|write_?file|edit_?file|insert_?content|append_?file|modify_?file)([_\\-\\s]|$)/i;\n\nconst TRANSIENT_MS = 3000;\n// Minimum time a visible \"active\" state must persist before being replaced.\n// Prevents flicker (e.g. error -> thinking clobbering the error before the\n// user can see it). The TTL only gates active->active transitions:\n//   - Active -> active: TTL applies (within 3s, the new state is rejected)\n//   - Active -> silent (idle/startup/complete): TTL bypassed (end-of-turn)\n//   - Active -> error: TTL bypassed (error always wins)\n//   - Silent -> active: TTL bypassed (silent states aren't in STATES_WITH_TTL)\n// Auto-revert timers bypass this by calling doApplyState directly.\nconst STATE_TTL_MS = 3000;\nconst STATES_WITH_TTL: ReadonlySet<State> = new Set<State>([\n  \"thinking\", \"searching\", \"editing\", \"toolRunning\", \"error\",\n]);\nconst SILENT_STATES: ReadonlySet<State> = new Set<State>([\n  \"idle\", \"startup\", \"complete\",\n]);\n\n// How often the kaomoji is re-rolled while an active state is showing. Set\n// long (30 s) so it only kicks in for genuinely long tasks; short states\n// finish before the first re-roll and show a single kaomoji. The spinner is\n// NOT re-rolled on this timer (restarting its animation would stutter); the\n// spinner only changes on state transitions.\nconst KAOMOJI_REROLL_MS = 30000;\n\nfunction pick<T>(arr: readonly T[]): T {\n  return arr[Math.floor(Math.random() * arr.length)]!;\n}\n\n// Like pick, but never returns `current` (so a re-roll always produces a\n// visible change). Pools of length <= 1 can't vary, so they return the\n// sole element unchanged.\nfunction pickOther<T>(arr: readonly T[], current: T): T {\n  if (arr.length <= 1) return arr[0]!;\n  let v: T;\n  do {\n    v = pick(arr);\n  } while (v === current);\n  return v;\n}\n\nexport default function (pi: ExtensionAPI): void {\n  let state: State = \"idle\";\n  let stateEnteredAt = 0;\n  let currentKaomoji = \"\";\n  let transientTimer: ReturnType<typeof setTimeout> | undefined;\n  let rerollTimer: ReturnType<typeof setInterval> | undefined;\n\n  function clearTransient(): void {\n    if (transientTimer !== undefined) {\n      clearTimeout(transientTimer);\n      transientTimer = undefined;\n    }\n  }\n\n  function clearReroll(): void {\n    if (rerollTimer !== undefined) {\n      clearInterval(rerollTimer);\n      rerollTimer = undefined;\n    }\n  }\n\n  function doApplyState(next: State, ctx: ExtensionContext): void {\n    state = next;\n    stateEnteredAt = Date.now();\n\n    const spinnerPool = SPINNER_POOL_FOR_STATE[next];\n    if (spinnerPool.length > 0) {\n      const spinnerName = pick(spinnerPool);\n      const def = spinners[spinnerName];\n      const frames = def.frames.map(f => ctx.ui.theme.fg(\"accent\", f));\n      ctx.ui.setWorkingIndicator({ frames, intervalMs: def.interval });\n    } else {\n      ctx.ui.setWorkingIndicator({ frames: [] });\n    }\n\n    const kaomojiPool = KAOMOJI_FOR_STATE[next];\n    currentKaomoji = kaomojiPool.length > 0 ? pick(kaomojiPool) : \"\";\n    ctx.ui.setWorkingMessage(currentKaomoji);\n\n    clearReroll();\n    clearTransient();\n\n    // Re-roll the kaomoji periodically while an active state is showing, so\n    // a long thinking / toolRunning / error / searching / editing stretch\n    // cycles through kaomoji instead of freezing on one. The spinner stays\n    // put for the whole state (see KAOMOJI_REROLL_MS). Pools of length <= 1\n    // can't vary, so skip them; silent states have empty pools and are also\n    // skipped.\n    if (kaomojiPool.length > 1) {\n      rerollTimer = setInterval(() => rerollKaomoji(ctx), KAOMOJI_REROLL_MS);\n    }\n\n    if (next === \"complete\" || next === \"startup\") {\n      transientTimer = setTimeout(() => doApplyState(\"idle\", ctx), TRANSIENT_MS);\n    }\n  }\n\n  function rerollKaomoji(ctx: ExtensionContext): void {\n    const pool = KAOMOJI_FOR_STATE[state];\n    if (pool.length <= 1) return;\n    currentKaomoji = pickOther(pool, currentKaomoji);\n    ctx.ui.setWorkingMessage(currentKaomoji);\n  }\n\n  function applyState(next: State, ctx: ExtensionContext, options: { force?: boolean } = {}): void {\n    if (ctx.mode !== \"tui\") return;\n    // Enforce minimum TTL on event-driven transitions, with three exceptions:\n    //   - `error` always wins (so tool_execution_end can always set error).\n    //   - Silent states (idle, startup, complete) bypass TTL — they're\n    //     end-of-turn markers, not active states that need minimum display.\n    //     Without this, agent_end within 3s of turn_start would be rejected,\n    //     leaving the spinner stuck in the active state.\n    //   - `force: true` bypasses TTL — used for tool_execution_start so the\n    //     spinner syncs with the tool bubble the moment it appears.\n    // Auto-revert timers bypass this by calling doApplyState directly.\n    if (\n      !options.force &&\n      !SILENT_STATES.has(next) &&\n      next !== \"error\" &&\n      STATES_WITH_TTL.has(state) &&\n      Date.now() - stateEnteredAt < STATE_TTL_MS\n    ) {\n      return;\n    }\n    doApplyState(next, ctx);\n  }\n\n  pi.on(\"session_start\", (event, ctx) => {\n    if (ctx.mode !== \"tui\") return;\n    ctx.ui.setTitle(\"ashxj\");\n    doApplyState(event.reason === \"startup\" ? \"startup\" : \"idle\", ctx);\n  });\n\n  pi.on(\"turn_start\", (_event, ctx) => {\n    applyState(\"thinking\", ctx);\n  });\n\n  pi.on(\"tool_execution_start\", (event, ctx) => {\n    // Hook on tool_execution_start (not tool_call) so the spinner activates\n    // at the same moment the tool bubble appears in the UI. tool_call fires\n    // earlier (when the LLM decides to call the tool, before execution), and\n    // the bubble only appears once the tool actually starts — so hooking on\n    // tool_call creates a visual desync between spinner and bubble.\n    // Bonus: tools blocked at tool_call never run, so tool_execution_start\n    // won't fire and the spinner won't activate for blocked tools.\n    // `force: true` bypasses the 3s TTL so the spinner syncs with the\n    // bubble immediately, even if the previous active state is still\n    // within its minimum display window.\n    if (state === \"error\") return;\n    const name = event.toolName;\n    const force = true;\n    if (SEARCH_RE.test(name)) {\n      applyState(\"searching\", ctx, { force });\n    } else if (EDIT_RE.test(name)) {\n      applyState(\"editing\", ctx, { force });\n    } else {\n      applyState(\"toolRunning\", ctx, { force });\n    }\n  });\n\n  pi.on(\"tool_execution_end\", (event, ctx) => {\n    if (event.isError) {\n      applyState(\"error\", ctx);\n    }\n  });\n\n  pi.on(\"turn_end\", (_event, ctx) => {\n    // A turn that ran a tool ends with the spinner still on the tool state\n    // (searching/editing/toolRunning). The next turn_start would revert to\n    // thinking, but it's TTL-gated and gets rejected for fast tools (<3s),\n    // which leaves the spinner stuck on the tool state for the whole next\n    // turn. Revert to thinking here, right after the turn's tools finish.\n    // turn_end fires once per turn after all its (concurrent) tools\n    // complete, so this is safe for parallel tool calls. Only force out of\n    // tool states, never out of error (error has priority and is handled\n    // by agent_end). No-op on turns that had no tools (state is already\n    // thinking).\n    if (state === \"searching\" || state === \"editing\" || state === \"toolRunning\") {\n      applyState(\"thinking\", ctx, { force: true });\n    }\n  });\n\n  pi.on(\"agent_end\", (event, ctx) => {\n    const last = event.messages.at(-1);\n    if (!last || last.role !== \"assistant\") {\n      applyState(\"idle\", ctx);\n      return;\n    }\n    const stopReason = (last as { stopReason?: string }).stopReason;\n    if (stopReason === \"stop\" || stopReason === \"length\") {\n      applyState(\"complete\", ctx);\n    } else if (stopReason === \"error\" || stopReason === \"aborted\") {\n      applyState(\"error\", ctx);\n    } else if (stopReason === \"toolUse\") {\n    } else {\n      applyState(\"idle\", ctx);\n    }\n  });\n\n  pi.on(\"session_shutdown\", (_event, ctx) => {\n    clearTransient();\n    clearReroll();\n    if (ctx.mode === \"tui\") {\n      ctx.ui.setWorkingIndicator({ frames: [] });\n      ctx.ui.setWorkingMessage(\"\");\n    }\n    state = \"idle\";\n    stateEnteredAt = 0;\n    currentKaomoji = \"\";\n  });\n}"]}

package/dist/builtin-extensions/ashxj-thinking.d.ts

@@ -0,0 +1,65 @@
+/**
+ * batxj-thinking extension
+ *
+ * `/thinking [level]` slash command to view or set the reasoning level,
+ * plus `/thinking show|hide|toggle` for thinking-block visibility.
+ *
+ * Loaded by pi via jiti — no build step, plain TypeScript.
+ *
+ * NOTE on type imports: this file deliberately declares structural types
+ * rather than importing from `@earendil-works/pi-coding-agent` (or
+ * `@earendil-works/pi-tui`). pi-coding-agent's `index.d.ts` re-exports
+ * from internal `.d.ts` files that contain subpath imports like
+ * `@earendil-works/pi-ai/compat`, which fail to resolve under the default
+ * `tsc` settings when a file argument is passed (the spec'd
+ * `tsc --noEmit index.ts` script). Declaring the types we use inline
+ * keeps the typecheck self-contained.
+ */
+/** Mirrored from `@earendil-works/pi-agent-core` `ThinkingLevel`. */
+type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+/** Mirrored from `@earendil-works/pi-tui` `AutocompleteItem`. */
+interface AutocompleteItem {
+    value: string;
+    label: string;
+    description?: string;
+}
+/** A trimmed view of a `Model` — only the fields the picker reads. */
+interface ModelLike {
+    id?: string;
+    reasoning?: boolean;
+    thinkingLevelMap?: Record<string, string | null>;
+}
+/** A trimmed view of `ExtensionContext` — only the methods/props we use. */
+interface ExtensionContextLike {
+    mode: "tui" | "rpc" | "json" | "print";
+    model: ModelLike | undefined;
+    ui: {
+        notify(message: string, type?: "info" | "warning" | "error"): void;
+        select(title: string, options: string[], opts?: {
+            signal?: AbortSignal;
+            timeout?: number;
+        }): Promise<string | undefined>;
+    };
+}
+/** A trimmed view of `ExtensionCommandContext` — only the methods/props we use. */
+interface ExtensionCommandContextLike extends ExtensionContextLike {
+    getThinkingLevel(): ThinkingLevel;
+    /** Reload extensions, skills, prompts, and themes. Re-reads settings.json
+     *  from disk (session.reload() → settingsManager.reload()), so persisted
+     *  runtime settings like `hideThinkingBlock` are live-applied. The captured
+     *  `ctx`/`pi` are stale after this resolves — do not use them afterward. */
+    reload(): Promise<void>;
+}
+/** A trimmed view of `ExtensionAPI` — only the methods we use. */
+interface ExtensionAPI {
+    registerCommand(name: string, options: {
+        description?: string;
+        getArgumentCompletions?(prefix: string): AutocompleteItem[] | null | Promise<AutocompleteItem[] | null>;
+        handler(args: string, ctx: ExtensionCommandContextLike): Promise<void> | void;
+    }): void;
+    getThinkingLevel(): ThinkingLevel;
+    setThinkingLevel(level: ThinkingLevel): void;
+}
+export default function (pi: ExtensionAPI): void;
+export {};
+//# sourceMappingURL=ashxj-thinking.d.ts.map

package/dist/builtin-extensions/ashxj-thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ashxj-thinking.d.ts","sourceRoot":"","sources":["../../src/builtin-extensions/ashxj-thinking.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAUH,qEAAqE;AAErE,KAAK,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAErF,iEAAiE;AACjE,UAAU,gBAAgB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wEAAsE;AACtE,UAAU,SAAS;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,8EAA4E;AAC5E,UAAU,oBAAoB;IAC7B,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,EAAE,EAAE;QACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;QACnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;KACzH,CAAC;CACF;AAED,qFAAmF;AACnF,UAAU,2BAA4B,SAAQ,oBAAoB;IACjE,gBAAgB,IAAI,aAAa,CAAC;IAClC;;;kFAG4E;IAC5E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,oEAAkE;AAClE,UAAU,YAAY;IACrB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,sBAAsB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QACxG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC9E,GAAG,IAAI,CAAC;IACT,gBAAgB,IAAI,aAAa,CAAC;IAClC,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAC7C;AAmLD,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CAgH/C","sourcesContent":["// @ts-nocheck\n// Vendored from https://github.com/ashx-j/ashxj-thinking @ 0330a34\n// (\"Remove custom footer — keep only /thinking command\"), single-file ashxj\n// convention. lunR patches are marked `// lunr:`.\n/**\n * batxj-thinking extension\n *\n * `/thinking [level]` slash command to view or set the reasoning level,\n * plus `/thinking show|hide|toggle` for thinking-block visibility.\n *\n * Loaded by pi via jiti — no build step, plain TypeScript.\n *\n * NOTE on type imports: this file deliberately declares structural types\n * rather than importing from `@earendil-works/pi-coding-agent` (or\n * `@earendil-works/pi-tui`). pi-coding-agent's `index.d.ts` re-exports\n * from internal `.d.ts` files that contain subpath imports like\n * `@earendil-works/pi-ai/compat`, which fail to resolve under the default\n * `tsc` settings when a file argument is passed (the spec'd\n * `tsc --noEmit index.ts` script). Declaring the types we use inline\n * keeps the typecheck self-contained.\n */\n\nimport { readFileSync, writeFileSync, existsSync, renameSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\n// ---------------------------------------------------------------------------\n// Minimal structural types (see file header for why these are inline)\n// ---------------------------------------------------------------------------\n\n/** Mirrored from `@earendil-works/pi-agent-core` `ThinkingLevel`. */\n// lunr: added \"max\" — lunR's ThinkingLevel union includes it.\ntype ThinkingLevel = \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\n/** Mirrored from `@earendil-works/pi-tui` `AutocompleteItem`. */\ninterface AutocompleteItem {\n\tvalue: string;\n\tlabel: string;\n\tdescription?: string;\n}\n\n/** A trimmed view of a `Model` — only the fields the picker reads. */\ninterface ModelLike {\n\tid?: string;\n\treasoning?: boolean;\n\tthinkingLevelMap?: Record<string, string | null>;\n}\n\n/** A trimmed view of `ExtensionContext` — only the methods/props we use. */\ninterface ExtensionContextLike {\n\tmode: \"tui\" | \"rpc\" | \"json\" | \"print\";\n\tmodel: ModelLike | undefined;\n\tui: {\n\t\tnotify(message: string, type?: \"info\" | \"warning\" | \"error\"): void;\n\t\tselect(title: string, options: string[], opts?: { signal?: AbortSignal; timeout?: number }): Promise<string | undefined>;\n\t};\n}\n\n/** A trimmed view of `ExtensionCommandContext` — only the methods/props we use. */\ninterface ExtensionCommandContextLike extends ExtensionContextLike {\n\tgetThinkingLevel(): ThinkingLevel;\n\t/** Reload extensions, skills, prompts, and themes. Re-reads settings.json\n\t *  from disk (session.reload() → settingsManager.reload()), so persisted\n\t *  runtime settings like `hideThinkingBlock` are live-applied. The captured\n\t *  `ctx`/`pi` are stale after this resolves — do not use them afterward. */\n\treload(): Promise<void>;\n}\n\n/** A trimmed view of `ExtensionAPI` — only the methods we use. */\ninterface ExtensionAPI {\n\tregisterCommand(name: string, options: {\n\t\tdescription?: string;\n\t\tgetArgumentCompletions?(prefix: string): AutocompleteItem[] | null | Promise<AutocompleteItem[] | null>;\n\t\thandler(args: string, ctx: ExtensionCommandContextLike): Promise<void> | void;\n\t}): void;\n\tgetThinkingLevel(): ThinkingLevel;\n\tsetThinkingLevel(level: ThinkingLevel): void;\n}\n\n// ---------------------------------------------------------------------------\n// Thinking level config\n// ---------------------------------------------------------------------------\n\n/** All known levels, in display order. */\n// lunr: \"max\" appended (lunR supports it; filtered per-model below when unsupported).\nconst ALL_LEVELS_7: readonly ThinkingLevel[] = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"];\n/** Default 5 — used when the active model is undefined (we don't know whether `xhigh`/`max` are supported). */\nconst ALL_LEVELS_5: readonly ThinkingLevel[] = [\"off\", \"minimal\", \"low\", \"medium\", \"high\"];\n\n/** Per-level descriptions. Mirrored from `THINKING_DESCRIPTIONS` in settings-selector.ts. */\nconst THINKING_DESCRIPTIONS: Record<ThinkingLevel, string> = {\n\toff: \"No reasoning\",\n\tminimal: \"Very brief reasoning (~1k tokens)\",\n\tlow: \"Light reasoning (~2k tokens)\",\n\tmedium: \"Moderate reasoning (~8k tokens)\",\n\thigh: \"Deep reasoning (~16k tokens)\",\n\txhigh: \"Extra-high reasoning (~32k tokens)\",\n\t// lunr: added — mirrors settings-selector.ts.\n\tmax: \"Maximum reasoning\",\n};\n\n/** Returns the levels valid for the given model, in display order. */\nfunction availableLevelsFor(model: ModelLike | undefined): readonly ThinkingLevel[] {\n\tif (!model) return ALL_LEVELS_5;\n\tif (model.reasoning === false) return [\"off\" as const];\n\t// Filter out levels the model marks as unsupported (null entry).\n\treturn ALL_LEVELS_7.filter((lvl) => {\n\t\tconst m = model.thinkingLevelMap;\n\t\tif (m && Object.prototype.hasOwnProperty.call(m, lvl) && (m as Record<string, string | null>)[lvl] === null) {\n\t\t\treturn false;\n\t\t}\n\t\treturn true;\n\t});\n}\n\n/** Builds the inline `<padded level> — <description>` label for a level. */\nfunction formatLevelLabel(level: ThinkingLevel): string {\n\treturn `${level.padEnd(8)} \\u2014 ${THINKING_DESCRIPTIONS[level]}`;\n}\n\n// ---------------------------------------------------------------------------\n// Persisted thinking-block visibility (hideThinkingBlock)\n//\n// pi has no public extension API to toggle thinking-block visibility live.\n// The live in-session toggle is `app.thinking.toggle` (default Ctrl+T) wired to\n// `toggleThinkingBlockVisibility()` in interactive-mode.js, which calls\n// `SettingsManager.setHideThinkingBlock()` + rebuilds the chat. That method is\n// not exposed on ExtensionContext / ExtensionCommandContext / ExtensionAPI.\n//\n// What extensions CAN do is persist the `hideThinkingBlock` boolean to the\n// global agent settings file (`~/.lunr/agent/settings.json`); the\n// `SettingsManager` reads it on startup. And because `ctx.reload()` drives\n// `session.reload()` → `settingsManager.reload()` (re-reads disk) →\n// `restoreChatBeforeSessionStart()` copies the new value into\n// `this.hideThinkingBlock` and calls `rebuildChatFromMessages()` (which\n// reconstructs every AssistantMessageComponent with the new hide flag), the\n// persisted value IS live-applied within the session by `await ctx.reload()`\n// (verified against pi 0.80.3). In non-TUI modes `ctx.reload()` is a no-op,\n// so the setting simply applies on next start.\n//\n// The instant keybinding path (Ctrl+T) still works and is the lowest-latency\n// toggle; the command is the discoverable, persistable, completions-friendly\n// equivalent.\n// ---------------------------------------------------------------------------\n\n/** Returns the path to lunR's global agent settings file.\n *  lunr: lunR's agent dir is `~/.lunr/agent` (upstream hardcoded `~/.pi/agent`).\n *  Honors the `PI_CODING_AGENT_DIR` env override like core config.ts does;\n *  a custom agent dir is not exposed to extensions, so this is the only\n *  location we can write to be picked up by\n *  `SettingsManager.tryLoadFromStorage(\"global\")`. */\nfunction agentSettingsPath(): string {\n\tconst envDir = process.env.PI_CODING_AGENT_DIR;\n\tif (envDir) {\n\t\t// Match core normalizePath(): expand a leading ~ (~/ and, on win32, ~\\).\n\t\tconst home = homedir();\n\t\tconst expanded =\n\t\t\tenvDir === \"~\"\n\t\t\t\t? home\n\t\t\t\t: envDir.startsWith(\"~/\") || (process.platform === \"win32\" && envDir.startsWith(\"~\\\\\"))\n\t\t\t\t\t? join(home, envDir.slice(2))\n\t\t\t\t\t: envDir;\n\t\treturn join(expanded, \"settings.json\");\n\t}\n\treturn join(homedir(), \".lunr\", \"agent\", \"settings.json\");\n}\n\n// ---------------------------------------------------------------------------\n// lunR customize bridge for persisted thinking-block visibility.\n// When the bridge is present (TUI / gateway sessions), reads/writes go through\n// SettingsManager (lockfile + merge). Falls back to direct file I/O when the\n// extension loads in a context without the bridge (e.g. upstream pi).\n// ---------------------------------------------------------------------------\ninterface CustomizeBridge {\n\tgetHideThinkingBlock(): boolean;\n\tsetHideThinkingBlock(hide: boolean): void;\n}\n\nfunction getCustomizeBridge(): CustomizeBridge | undefined {\n\treturn (globalThis as Record<symbol, unknown>)[Symbol.for(\"@lunr/customize\")] as CustomizeBridge | undefined;\n}\n\n/** Returns the persisted `hideThinkingBlock` value (default false, matching\n *  `getHideThinkingBlock()` which returns `this.settings.hideThinkingBlock ?? false`).\n *  Never throws — on any error (missing file, bad JSON) returns false. */\nfunction readHideThinkingBlock(): boolean {\n\tconst bridge = getCustomizeBridge();\n\tif (bridge) return bridge.getHideThinkingBlock();\n\ttry {\n\t\tconst p = agentSettingsPath();\n\t\tif (!existsSync(p)) return false;\n\t\tconst cfg = JSON.parse(readFileSync(p, \"utf8\")) as { hideThinkingBlock?: boolean };\n\t\treturn cfg.hideThinkingBlock === true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Persist `hideThinkingBlock` to the global agent settings file (safe merge).\n *\n * - Preserves all other keys (merge, never overwrite the whole file).\n * - Matches pi's 2-space indentation + trailing newline.\n * - On invalid JSON in the existing file, backs it up to `settings.json.bak`\n *   before writing a fresh file, so a corrupted file is never written back.\n * - Never throws; on any error `ok` is false and the caller notifies the user.\n *\n * `createdFresh` is true when the file didn't exist (or was corrupt and backed\n * up) before this write — the handler uses it to warn that a global settings\n * file was created here.\n */\nfunction writeHideThinkingBlock(hide: boolean): {\n\tok: boolean;\n\tcreatedFresh: boolean;\n} {\n\tconst bridge = getCustomizeBridge();\n\tif (bridge) {\n\t\ttry {\n\t\t\tbridge.setHideThinkingBlock(hide);\n\t\t\treturn { ok: true, createdFresh: false };\n\t\t} catch {\n\t\t\treturn { ok: false, createdFresh: false };\n\t\t}\n\t}\n\ttry {\n\t\tconst p = agentSettingsPath();\n\t\tlet cfg: Record<string, unknown> = {};\n\t\tlet createdFresh = false;\n\t\tif (existsSync(p)) {\n\t\t\ttry {\n\t\t\t\tcfg = JSON.parse(readFileSync(p, \"utf8\")) as Record<string, unknown>;\n\t\t\t} catch {\n\t\t\t\t// Existing file is corrupt — back it up, then start fresh.\n\t\t\t\ttry {\n\t\t\t\t\trenameSync(p, `${p}.bak`);\n\t\t\t\t} catch {\n\t\t\t\t\t// If backup fails, still proceed to overwrite (best effort).\n\t\t\t\t}\n\t\t\t\tcfg = {};\n\t\t\t\tcreatedFresh = true;\n\t\t\t}\n\t\t} else {\n\t\t\tcreatedFresh = true;\n\t\t}\n\t\tcfg.hideThinkingBlock = hide;\n\t\twriteFileSync(p, JSON.stringify(cfg, null, 2) + \"\\n\", \"utf8\");\n\t\treturn { ok: true, createdFresh };\n\t} catch {\n\t\treturn { ok: false, createdFresh: false };\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Extension entry point\n// ---------------------------------------------------------------------------\n\nexport default function (pi: ExtensionAPI): void {\n\tpi.registerCommand(\"thinking\", {\n\t\tdescription: \"View or set the reasoning level for the current model, or toggle thinking-block visibility with show/hide/toggle\",\n\t\tgetArgumentCompletions(prefix: string): AutocompleteItem[] {\n\t\t\tconst lower = prefix.toLowerCase();\n\t\t\t// Visibility sub-options first, filtered by prefix, alongside the levels.\n\t\t\tconst visibility: AutocompleteItem[] = [\n\t\t\t\t{ value: \"show\", label: \"show\", description: \"Show thinking blocks (persisted to settings.json)\" },\n\t\t\t\t{ value: \"hide\", label: \"hide\", description: \"Hide thinking blocks (persisted to settings.json)\" },\n\t\t\t\t{ value: \"toggle\", label: \"toggle\", description: \"Toggle thinking blocks (persisted to settings.json)\" },\n\t\t\t];\n\t\t\tconst levels = availableLevelsFor(currentModel(pi));\n\t\t\tconst levelItems = levels\n\t\t\t\t.filter((lvl) => lvl.startsWith(lower))\n\t\t\t\t.map((lvl) => ({ value: lvl, label: lvl, description: THINKING_DESCRIPTIONS[lvl] }));\n\t\t\treturn [\n\t\t\t\t...visibility.filter((v) => v.value.startsWith(lower)),\n\t\t\t\t...levelItems,\n\t\t\t];\n\t\t},\n\t\thandler: async (args: string, ctx: ExtensionCommandContextLike) => {\n\t\t\tconst trimmed = args.trim();\n\t\t\tconst lower = trimmed.toLowerCase();\n\n\t\t\t// ---- Visibility sub-options: /thinking show | hide | toggle ----\n\t\t\t// Caught first so `hide`/`show`/`toggle` are never parsed as levels.\n\t\t\t// Works in every mode: only uses ctx.ui.notify + file I/O + ctx.reload().\n\t\t\tif (lower === \"show\" || lower === \"hide\" || lower === \"toggle\") {\n\t\t\t\tconst current = readHideThinkingBlock();\n\t\t\t\tconst next = lower === \"toggle\" ? !current : lower === \"hide\";\n\t\t\t\tif (next === current) {\n\t\t\t\t\tctx.ui.notify(`Thinking blocks already ${current ? \"hidden\" : \"shown\"}.`, \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst result = writeHideThinkingBlock(next);\n\t\t\t\tif (!result.ok) {\n\t\t\t\t\t// lunr: settings path is lunR's (see agentSettingsPath).\n\t\t\t\t\tctx.ui.notify(`Failed to update ${agentSettingsPath()}`, \"error\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\t// The notify MUST run before `await ctx.reload()`: after reload the\n\t\t\t\t// loader invalidates this `ctx`/`pi` as stale. ctx.reload() live-\n\t\t\t\t// applies the setting (verified against pi 0.80.3: it drives\n\t\t\t\t// session.reload() → settingsManager.reload() re-reads disk →\n\t\t\t\t// restoreChatBeforeSessionStart copies the new value into\n\t\t\t\t// this.hideThinkingBlock → rebuildChatFromMessages() rebuilds every\n\t\t\t\t// AssistantMessageComponent with the new hide flag). In non-TUI\n\t\t\t\t// modes ctx.reload() is a no-op; the setting then applies on next\n\t\t\t\t// start. The instant keybinding path (Ctrl+T) also still works.\n\t\t\t\tconst verb = next ? \"hidden\" : \"shown\";\n\t\t\t\tconst note = result.createdFresh\n\t\t\t\t\t? `Thinking blocks ${verb}. (Created ${agentSettingsPath()} with this setting.)`\n\t\t\t\t\t: `Thinking blocks ${verb}.`;\n\t\t\t\tctx.ui.notify(note, \"info\");\n\t\t\t\tawait ctx.reload();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst levels = availableLevelsFor(ctx.model);\n\t\t\tconst currentLevel: ThinkingLevel = pi.getThinkingLevel();\n\t\t\tconst validSet = new Set<ThinkingLevel>(levels);\n\n\t\t\t// No-arg form → open a picker. Skip in non-TUI modes — same pattern\n\t\t\t// as batxj-animations per AGENTS.md §5.\n\t\t\tif (trimmed === \"\") {\n\t\t\t\tif (ctx.mode !== \"tui\") {\n\t\t\t\t\tctx.ui.notify(`Thinking level: ${currentLevel}`, \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (levels.length === 0) {\n\t\t\t\t\tctx.ui.notify(\"No thinking levels available for this model.\", \"warning\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst options = levels.map((lvl) =>\n\t\t\t\t\t(lvl === currentLevel ? \"\\u25CF \" : \"  \") + formatLevelLabel(lvl),\n\t\t\t\t);\n\t\t\t\tconst chosen = await ctx.ui.select(\n\t\t\t\t\t`Thinking level (current: ${currentLevel})`,\n\t\t\t\t\toptions,\n\t\t\t\t);\n\t\t\t\tif (chosen === undefined) return;\n\t\t\t\t// Chosen string starts with the current-marker (\"● \") or two-space\n\t\t\t\t// gutter; strip the prefix and extract the first token (the level).\n\t\t\t\tconst stripped = chosen.replace(/^[\\u25CF ]\\s?/, \"\").trimStart();\n\t\t\t\tconst level = stripped.split(/\\s+/)[0] as ThinkingLevel;\n\t\t\t\tif (!validSet.has(level)) {\n\t\t\t\t\tctx.ui.notify(`Unsupported thinking level: ${level}`, \"error\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (level === currentLevel) return; // no-op\n\t\t\t\tpi.setThinkingLevel(level);\n\t\t\t\tctx.ui.notify(`Thinking level: ${level}`, \"info\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Direct-set form: `/thinking <level>`\n\t\t\tconst requested = trimmed.toLowerCase() as ThinkingLevel;\n\t\t\tif (!validSet.has(requested)) {\n\t\t\t\tctx.ui.notify(\n\t\t\t\t\t`Invalid thinking level: \"${trimmed}\". Valid: ${levels.join(\", \")}`,\n\t\t\t\t\t\"error\",\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (requested === currentLevel) {\n\t\t\t\tctx.ui.notify(`Thinking level: ${requested} (unchanged)`, \"info\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tpi.setThinkingLevel(requested);\n\t\t\tctx.ui.notify(`Thinking level: ${requested}`, \"info\");\n\t\t},\n\t});\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Read the current model from the ExtensionAPI runtime. The spec mentions\n * `pi.getModel()`; pi doesn't expose that name on the API object itself, but\n * the bound `ExtensionContextActions` (which the runtime decorates onto\n * events) does include `getModel()`. We duck-type against the loader so this\n * file stays decoupled from non-public internals. When unavailable (e.g.\n * during autocomplete, before any session has bound), returns undefined and\n * the caller falls back to the default 5-level set.\n */\nfunction currentModel(pi: ExtensionAPI): ModelLike | undefined {\n\tconst fn = (pi as unknown as { getModel?: () => unknown }).getModel;\n\tif (typeof fn === \"function\") {\n\t\treturn fn.call(pi) as ModelLike | undefined;\n\t}\n\treturn undefined;\n}\n"]}