wotann 0.5.0

package/dist/ui/input/mouse.js

@@ -0,0 +1,239 @@
+/**
+ * OSC 1006 extended mouse input — Wave 6-OO TUI v2 Phase 2.
+ *
+ * ── What this is ─────────────────────────────────────────────────────
+ * A self-contained mouse-event source for the TUI. We use the
+ * "SGR" (Select Graphic Rendition) extended mouse protocol — DEC mode
+ * 1006 — which gives us:
+ *   - Coordinates beyond column/row 223 (the X10/normal modes are
+ *     limited to ASCII byte ranges).
+ *   - Press, release, and (with mode 1003) move events.
+ *   - A clean, deterministic ANSI parse — no ambiguous bytes mixed
+ *     with the keyboard stream.
+ *
+ * The wire format on the input stream is:
+ *
+ *   ESC [ < <button>;<col>;<row> M     (press / drag)
+ *   ESC [ < <button>;<col>;<row> m     (release)
+ *
+ * `<button>` is a bitmask: low 2 bits = button (0=L, 1=M, 2=R, 3=move),
+ * bit 5 = motion flag, bit 6 = wheel.
+ *
+ * ── Honest fallback (QB#6) ───────────────────────────────────────────
+ * Many terminals do not support OSC 1006 (legacy emulators, dumb
+ * pipes, CI logs). We can NOT reliably feature-detect from the
+ * outside — sending the enable bytes to a non-supporting terminal is
+ * a no-op (the bytes are silently consumed). So we adopt a
+ * conservative stance:
+ *   - If `process.stdin.isTTY` is false, do nothing — there is no
+ *     terminal to enable the mode on.
+ *   - If `WOTANN_DISABLE_MOUSE=1` is set, do nothing (escape hatch
+ *     for users on terminals where the protocol garbles input).
+ *   - The hook always returns the latest event when one parses, and
+ *     `null` otherwise. Consumers that never see an event simply get
+ *     a no-op behavior — no crashes, no fake clicks.
+ *
+ * ── Per-instance state (QB#7) ────────────────────────────────────────
+ * The MouseInputController owns its own subscriber set, raw buffer,
+ * and enable flag. It is NOT a module-global singleton. Tests and
+ * mocked environments can construct fresh instances with a mock
+ * stdin without polluting global state. The exported
+ * `useMouseEvents` hook ALSO uses per-instance React state and only
+ * reaches into a shared controller when one was injected via props.
+ */
+import { useEffect, useRef, useState } from "react";
+// ── Wire-protocol constants ──────────────────────────────────────────
+/** Enable SGR (1006) extended mouse mode + any-event tracking (1003). */
+export const MOUSE_ENABLE_SEQUENCE = "\x1b[?1006h\x1b[?1003h";
+/** Disable both modes — restores the terminal's default cursor handling. */
+export const MOUSE_DISABLE_SEQUENCE = "\x1b[?1006l\x1b[?1003l";
+/**
+ * Regex matching ONE complete OSC 1006 SGR mouse report. ANSI ESC byte (0x1B)
+ * is the literal first byte of every SGR mouse report — it's meaningful
+ * payload, not noise. The eslint-disable below silences no-control-regex
+ * specifically for this regex line where the control char is intentional.
+ */
+// eslint-disable-next-line no-control-regex
+const MOUSE_REPORT_PATTERN = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
+// ── Decoder ──────────────────────────────────────────────────────────
+/**
+ * Decode the button bitmask used by SGR mouse mode.
+ *
+ * Bits laid out per xterm's ctlseqs spec:
+ *   bits 0-1 — button index (0=L, 1=M, 2=R, 3=release-on-X10/no-button)
+ *   bit  2   — Shift held
+ *   bit  3   — Meta/Alt held
+ *   bit  4   — Control held
+ *   bit  5   — Motion (drag if button held; move if not)
+ *   bit  6   — Wheel event (button 0 = up, 1 = down)
+ */
+export function decodeMouseButton(maskByte, action) {
+    if (action === "move")
+        return "none";
+    const isWheel = (maskByte & 0b0100_0000) !== 0;
+    const lowBits = maskByte & 0b0000_0011;
+    if (isWheel) {
+        return lowBits === 0 ? "wheel-up" : "wheel-down";
+    }
+    switch (lowBits) {
+        case 0:
+            return "left";
+        case 1:
+            return "middle";
+        case 2:
+            return "right";
+        default:
+            return "none";
+    }
+}
+/**
+ * Parse zero or more mouse reports from a chunk of stdin bytes.
+ *
+ * Returns the structured events AND the residue (bytes that did not
+ * match any report) so callers can pass non-mouse bytes onward to the
+ * keyboard handler. Pure function — no internal state.
+ */
+export function parseMouseEvents(chunk) {
+    const events = [];
+    let residue = "";
+    let lastIndex = 0;
+    // Re-create the regex per call to avoid lastIndex bleed across
+    // unrelated chunks (the global flag stores state on the regex).
+    const pattern = new RegExp(MOUSE_REPORT_PATTERN.source, "g");
+    let match = pattern.exec(chunk);
+    while (match !== null) {
+        residue += chunk.slice(lastIndex, match.index);
+        lastIndex = match.index + match[0].length;
+        const maskRaw = Number.parseInt(match[1] ?? "0", 10);
+        const x = Number.parseInt(match[2] ?? "0", 10);
+        const y = Number.parseInt(match[3] ?? "0", 10);
+        const terminator = match[4];
+        if (Number.isFinite(maskRaw) && Number.isFinite(x) && Number.isFinite(y)) {
+            const isMotion = (maskRaw & 0b0010_0000) !== 0;
+            const action = isMotion ? "move" : terminator === "M" ? "press" : "release";
+            const button = decodeMouseButton(maskRaw, action);
+            events.push({ x, y, button, action });
+        }
+        match = pattern.exec(chunk);
+    }
+    residue += chunk.slice(lastIndex);
+    return { events, residue };
+}
+/**
+ * MouseInputController — owns enable/disable state + subscriber list
+ * for ONE stdin/stdout pair. Construct fresh instances per UI session.
+ */
+export class MouseInputController {
+    stdin;
+    stdout;
+    listeners = new Set();
+    buffer = "";
+    enabled = false;
+    dataHandler = (data) => {
+        this.handleData(typeof data === "string" ? data : data.toString("utf8"));
+    };
+    constructor(options = {}) {
+        this.stdin = options.stdin ?? process.stdin;
+        this.stdout = options.stdout ?? process.stdout;
+        if (!options.skipEnable) {
+            this.enable();
+        }
+    }
+    /** Whether mouse tracking is currently enabled. */
+    isEnabled() {
+        return this.enabled;
+    }
+    /** Whether the current stdin/stdout pair is suitable for mouse mode. */
+    isSupported() {
+        if (process.env["WOTANN_DISABLE_MOUSE"] === "1")
+            return false;
+        if (!this.stdin.isTTY)
+            return false;
+        if (!this.stdout.isTTY)
+            return false;
+        return true;
+    }
+    enable() {
+        if (this.enabled)
+            return;
+        if (!this.isSupported()) {
+            // Honest no-op — record state, do not attach listeners.
+            this.enabled = false;
+            return;
+        }
+        this.stdout.write(MOUSE_ENABLE_SEQUENCE);
+        this.stdin.on("data", this.dataHandler);
+        this.enabled = true;
+    }
+    disable() {
+        if (!this.enabled)
+            return;
+        this.stdout.write(MOUSE_DISABLE_SEQUENCE);
+        this.stdin.off("data", this.dataHandler);
+        this.enabled = false;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** Number of active subscribers — exposed for tests / instrumentation. */
+    listenerCount() {
+        return this.listeners.size;
+    }
+    handleData(chunk) {
+        this.buffer += chunk;
+        const parsed = parseMouseEvents(this.buffer);
+        this.buffer = parsed.residue;
+        for (const event of parsed.events) {
+            for (const listener of this.listeners) {
+                listener(event);
+            }
+        }
+    }
+}
+/**
+ * Subscribe to mouse events from the active controller.
+ *
+ * Returns the most recently observed event, or null when nothing
+ * has happened yet (or the terminal does not support OSC 1006).
+ */
+export function useMouseEvents(options = {}) {
+    const [event, setEvent] = useState(null);
+    const controllerRef = useRef(null);
+    const ownsController = useRef(false);
+    // Resolve / construct the controller exactly once per mount.
+    if (controllerRef.current === null) {
+        if (options.controller) {
+            controllerRef.current = options.controller;
+            ownsController.current = false;
+        }
+        else {
+            controllerRef.current = new MouseInputController();
+            ownsController.current = true;
+        }
+    }
+    useEffect(() => {
+        const controller = controllerRef.current;
+        if (controller === null)
+            return;
+        if (options.disabled)
+            return;
+        if (!controller.isEnabled())
+            return;
+        const unsubscribe = controller.subscribe((next) => {
+            setEvent(next);
+        });
+        return () => {
+            unsubscribe();
+            if (ownsController.current && controller.listenerCount() === 0) {
+                controller.disable();
+            }
+        };
+    }, [options.disabled]);
+    if (options.disabled)
+        return null;
+    return event;
+}
+//# sourceMappingURL=mouse.js.map

package/dist/ui/input/mouse.js.map

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

package/dist/ui/keybindings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Keybinding system: configurable shortcuts for TUI navigation.
+ * Ctrl+M model switch, Ctrl+T thinking depth, Ctrl+/ search, Tab panels.
+ */
+export interface Keybinding {
+    readonly key: string;
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+    readonly shift?: boolean;
+    readonly action: string;
+    readonly description: string;
+}
+export declare class KeybindingManager {
+    private readonly bindings;
+    constructor(customBindings?: readonly Keybinding[]);
+    private keySignature;
+    matchKey(input: string, key: {
+        ctrl?: boolean;
+        meta?: boolean;
+        shift?: boolean;
+    }): string | null;
+    getBindings(): readonly Keybinding[];
+    getBindingForAction(action: string): Keybinding | undefined;
+    rebind(action: string, newKey: Omit<Keybinding, "action" | "description">): boolean;
+}
+//# sourceMappingURL=keybindings.d.ts.map

package/dist/ui/keybindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.d.ts","sourceRoot":"","sources":["../../src/ui/keybindings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AA6BD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;gBAEnD,cAAc,CAAC,EAAE,SAAS,UAAU,EAAE;IAOlD,OAAO,CAAC,YAAY;IASpB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI;IAMhG,WAAW,IAAI,SAAS,UAAU,EAAE;IAIpC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,OAAO;CAepF"}

package/dist/ui/keybindings.js

@@ -0,0 +1,76 @@
+/**
+ * Keybinding system: configurable shortcuts for TUI navigation.
+ * Ctrl+M model switch, Ctrl+T thinking depth, Ctrl+/ search, Tab panels.
+ */
+const DEFAULT_KEYBINDINGS = [
+    { key: "return", action: "send", description: "Send prompt" },
+    { key: "r", ctrl: true, action: "history-search", description: "Search prompt history" },
+    { key: "m", ctrl: true, action: "model-switch", description: "Switch model/provider" },
+    { key: "t", ctrl: true, action: "thinking-depth", description: "Cycle thinking depth" },
+    { key: "v", ctrl: true, action: "voice-capture", description: "Capture voice prompt" },
+    { key: "/", ctrl: true, action: "global-search", description: "Global search" },
+    // Codex CLI pattern: Ctrl+G launches `$VISUAL` (or `$EDITOR`)
+    // pre-populated with the current input. Lets users compose long
+    // prompts in their real editor (vim/neovim/vscode/etc.) instead
+    // of fighting Ink's single-line input cell.
+    { key: "g", ctrl: true, action: "external-editor", description: "Edit prompt in $VISUAL" },
+    { key: "i", ctrl: true, action: "context-inspect", description: "Context source inspector" },
+    { key: "b", ctrl: true, action: "terminal-blocks", description: "Toggle terminal blocks view" },
+    // Wave 3G additions — command palette, clear convo, last response.
+    { key: "p", ctrl: true, action: "command-palette", description: "Open command palette" },
+    { key: "k", ctrl: true, action: "clear-conversation", description: "Clear conversation" },
+    { key: "l", ctrl: true, action: "last-response", description: "Copy last assistant response" },
+    { key: "y", ctrl: true, action: "theme-cycle", description: "Cycle Norse themes" },
+    { key: "c", ctrl: true, action: "cancel", description: "Cancel / Exit" },
+    { key: "d", ctrl: true, action: "exit", description: "Exit" },
+    { key: "tab", action: "cycle-panel", description: "Cycle panel focus" },
+    { key: "escape", action: "close-overlay", description: "Close overlay" },
+    { key: "up", action: "history-prev", description: "Previous history" },
+    { key: "down", action: "history-next", description: "Next history" },
+];
+export class KeybindingManager {
+    bindings = new Map();
+    constructor(customBindings) {
+        const bindings = customBindings ?? DEFAULT_KEYBINDINGS;
+        for (const b of bindings) {
+            this.bindings.set(this.keySignature(b), b);
+        }
+    }
+    keySignature(b) {
+        const parts = [];
+        if (b.ctrl)
+            parts.push("ctrl");
+        if (b.meta)
+            parts.push("meta");
+        if (b.shift)
+            parts.push("shift");
+        parts.push(b.key);
+        return parts.join("+");
+    }
+    matchKey(input, key) {
+        const sig = this.keySignature({ key: input, ...key });
+        const binding = this.bindings.get(sig);
+        return binding?.action ?? null;
+    }
+    getBindings() {
+        return [...this.bindings.values()];
+    }
+    getBindingForAction(action) {
+        return [...this.bindings.values()].find((b) => b.action === action);
+    }
+    rebind(action, newKey) {
+        const existing = [...this.bindings.entries()].find(([_, b]) => b.action === action);
+        if (!existing)
+            return false;
+        const [oldSig, oldBinding] = existing;
+        this.bindings.delete(oldSig);
+        const newBinding = {
+            ...newKey,
+            action: oldBinding.action,
+            description: oldBinding.description,
+        };
+        this.bindings.set(this.keySignature(newBinding), newBinding);
+        return true;
+    }
+}
+//# sourceMappingURL=keybindings.js.map

package/dist/ui/keybindings.js.map

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

package/dist/ui/raven/raven-state.d.ts

@@ -0,0 +1,69 @@
+/**
+ * WOTANN Raven — aperiodic mascot state machine (C17).
+ *
+ * Port of OpenClaw's "Critter" pattern to WOTANN's Norse theme. The
+ * Critter's novelty over generic spinners was the *aperiodic cadence*
+ * — frames fire at variable intervals keyed to the mascot's mood, so
+ * the thing feels alive instead of mechanical. This module owns the
+ * pure state engine; rendering (ASCII for the terminal, SVG for the
+ * menu bar, complication for watchOS) lives in separate callers.
+ *
+ * Huginn (Thought) & Muninn (Memory) are Odin's ravens. The mood
+ * `preening` is a nod to a bored raven fiddling with its feathers —
+ * when the agent has been idle for minutes the Raven softly tidies
+ * itself so the UI still shows liveness without demanding attention.
+ */
+export type RavenMood = "idle" | "alert" | "thinking" | "listening" | "error" | "celebrating" | "preening";
+export type EyeState = "open" | "half" | "closed" | "wink";
+export type Facing = "left" | "right";
+export interface RavenState {
+    readonly mood: RavenMood;
+    readonly energy: number;
+    readonly facing: Facing;
+    readonly eye: EyeState;
+    readonly since: number;
+    readonly revision: number;
+}
+export interface RavenContext {
+    /** How many ms since the last user or agent action. */
+    readonly idleMs: number;
+    /** Whether a tool call is currently running. */
+    readonly toolActive: boolean;
+    /** Recent error count in the last 30s. */
+    readonly recentErrors: number;
+    /** Set true when the last agent turn completed successfully. */
+    readonly justCompleted: boolean;
+    /** Set true when the microphone is open (voice-mode listening). */
+    readonly listening: boolean;
+}
+export declare const RAVEN_TUNING: {
+    /** Idle ms before we drop into `preening`. */
+    readonly preeningAfterIdleMs: 60000;
+    /** Minimum ticks between aperiodic samples. */
+    readonly minTickDelayMs: 180;
+    /** Maximum delay between ticks — when truly idle we barely move. */
+    readonly maxTickDelayMs: 7000;
+    /** Error recency to flip into `error` mood. */
+    readonly errorMood_recentErrorsAtLeast: 1;
+};
+export declare function initialState(now?: number): RavenState;
+export declare function deriveMood(ctx: RavenContext): RavenMood;
+export declare function tick(prev: RavenState, ctx: RavenContext, now: number): RavenState;
+/**
+ * Returns the next tick delay for the given state. The delay is a base
+ * value per-mood plus a mood-scaled jitter; the jitter ensures no two
+ * consecutive frames share a timestamp, which is what gives the Raven
+ * its "breathing" feel.
+ *
+ * `random` is injectable so tests can pin the schedule. Production
+ * callers pass `Math.random`.
+ */
+export declare function nextDelayMs(state: RavenState, random?: () => number): number;
+/**
+ * Minimal ASCII rendering for terminal surfaces. The menu-bar SVG and
+ * watchOS complication renderers will live next to this but share
+ * the same state input — the whole point is that mood/energy/eye are
+ * the contract, not any one visual format.
+ */
+export declare function renderAscii(state: RavenState): string;
+//# sourceMappingURL=raven-state.d.ts.map

package/dist/ui/raven/raven-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raven-state.d.ts","sourceRoot":"","sources":["../../../src/ui/raven/raven-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,OAAO,GACP,UAAU,GACV,WAAW,GACX,OAAO,GACP,aAAa,GACb,UAAU,CAAC;AAEf,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAID,eAAO,MAAM,YAAY;IACvB,8CAA8C;;IAE9C,+CAA+C;;IAE/C,oEAAoE;;IAEpE,+CAA+C;;CAEvC,CAAC;AAIX,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAmB,GAAG,UAAU,CASjE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CAQvD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAuBjF;AAyCD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAyBzF;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAUrD"}

package/dist/ui/raven/raven-state.js

@@ -0,0 +1,185 @@
+/**
+ * WOTANN Raven — aperiodic mascot state machine (C17).
+ *
+ * Port of OpenClaw's "Critter" pattern to WOTANN's Norse theme. The
+ * Critter's novelty over generic spinners was the *aperiodic cadence*
+ * — frames fire at variable intervals keyed to the mascot's mood, so
+ * the thing feels alive instead of mechanical. This module owns the
+ * pure state engine; rendering (ASCII for the terminal, SVG for the
+ * menu bar, complication for watchOS) lives in separate callers.
+ *
+ * Huginn (Thought) & Muninn (Memory) are Odin's ravens. The mood
+ * `preening` is a nod to a bored raven fiddling with its feathers —
+ * when the agent has been idle for minutes the Raven softly tidies
+ * itself so the UI still shows liveness without demanding attention.
+ */
+// ── Tuning constants ─────────────────────────────────────────
+export const RAVEN_TUNING = {
+    /** Idle ms before we drop into `preening`. */
+    preeningAfterIdleMs: 60_000,
+    /** Minimum ticks between aperiodic samples. */
+    minTickDelayMs: 180,
+    /** Maximum delay between ticks — when truly idle we barely move. */
+    maxTickDelayMs: 7_000,
+    /** Error recency to flip into `error` mood. */
+    errorMood_recentErrorsAtLeast: 1,
+};
+// ── State derivation ─────────────────────────────────────────
+export function initialState(now = Date.now()) {
+    return {
+        mood: "idle",
+        energy: 0.3,
+        facing: "right",
+        eye: "open",
+        since: now,
+        revision: 0,
+    };
+}
+export function deriveMood(ctx) {
+    if (ctx.recentErrors >= RAVEN_TUNING.errorMood_recentErrorsAtLeast)
+        return "error";
+    if (ctx.justCompleted)
+        return "celebrating";
+    if (ctx.listening)
+        return "listening";
+    if (ctx.toolActive)
+        return "thinking";
+    if (ctx.idleMs >= RAVEN_TUNING.preeningAfterIdleMs)
+        return "preening";
+    if (ctx.idleMs < 1_500)
+        return "alert";
+    return "idle";
+}
+export function tick(prev, ctx, now) {
+    const nextMood = deriveMood(ctx);
+    const moodChanged = nextMood !== prev.mood;
+    const since = moodChanged ? now : prev.since;
+    const nextEnergy = blendEnergy(prev.energy, targetEnergy(nextMood));
+    const nextEye = nextEyeState(prev.eye, nextMood, now);
+    // Facing flips on mood changes keyed to errors/completion so the
+    // visual shift is explicit. Idle stretches preserve facing.
+    const nextFacing = moodChanged && (nextMood === "error" || nextMood === "celebrating")
+        ? prev.facing === "left"
+            ? "right"
+            : "left"
+        : prev.facing;
+    return {
+        mood: nextMood,
+        energy: nextEnergy,
+        facing: nextFacing,
+        eye: nextEye,
+        since,
+        revision: prev.revision + 1,
+    };
+}
+function targetEnergy(mood) {
+    switch (mood) {
+        case "error":
+            return 0.85;
+        case "celebrating":
+            return 1.0;
+        case "thinking":
+            return 0.6;
+        case "listening":
+            return 0.7;
+        case "alert":
+            return 0.55;
+        case "idle":
+            return 0.3;
+        case "preening":
+            return 0.15;
+    }
+}
+function blendEnergy(prev, target) {
+    // First-order low-pass filter so energy eases toward target instead
+    // of jumping, which would look like stutter on a 60-fps display.
+    return prev + (target - prev) * 0.25;
+}
+function nextEyeState(prev, mood, now) {
+    // Deterministic blink schedule keyed to `now` so tests can assert it.
+    // Blink every ~3.2s in idle/preening; eyes stay open while active.
+    if (mood === "error")
+        return "wink"; // cheeky wink on error — playful cue
+    if (mood === "celebrating")
+        return "open";
+    if (mood === "thinking")
+        return "open";
+    const blinkWindow = Math.floor(now / 3_200) % 8;
+    if (blinkWindow === 0)
+        return "closed";
+    if (blinkWindow === 1 || blinkWindow === 7)
+        return "half";
+    return prev === "closed" || prev === "half" ? "open" : prev;
+}
+// ── Aperiodic scheduling ─────────────────────────────────────
+/**
+ * Returns the next tick delay for the given state. The delay is a base
+ * value per-mood plus a mood-scaled jitter; the jitter ensures no two
+ * consecutive frames share a timestamp, which is what gives the Raven
+ * its "breathing" feel.
+ *
+ * `random` is injectable so tests can pin the schedule. Production
+ * callers pass `Math.random`.
+ */
+export function nextDelayMs(state, random = Math.random) {
+    const { mood } = state;
+    const base = mood === "thinking"
+        ? 220
+        : mood === "listening"
+            ? 260
+            : mood === "celebrating"
+                ? 300
+                : mood === "error"
+                    ? 340
+                    : mood === "alert"
+                        ? 480
+                        : mood === "preening"
+                            ? 3_200
+                            : 1_600; // idle
+    // Jitter is a multiplicative window so delays scale with the base.
+    // Window is ±40% for active moods, ±70% for preening (bored bird).
+    const jitterWindow = mood === "preening" || mood === "idle" ? 0.7 : 0.4;
+    const jitter = (random() * 2 - 1) * jitterWindow;
+    const raw = Math.round(base * (1 + jitter));
+    const clamped = Math.max(RAVEN_TUNING.minTickDelayMs, Math.min(RAVEN_TUNING.maxTickDelayMs, raw));
+    return clamped;
+}
+// ── ASCII renderer (terminal + early TUI usage) ──────────────
+/**
+ * Minimal ASCII rendering for terminal surfaces. The menu-bar SVG and
+ * watchOS complication renderers will live next to this but share
+ * the same state input — the whole point is that mood/energy/eye are
+ * the contract, not any one visual format.
+ */
+export function renderAscii(state) {
+    const eye = state.eye === "closed" ? "–" : state.eye === "half" ? "~" : state.eye === "wink" ? "*" : "o";
+    const beakFull = state.energy > 0.55 ? "<" : "c";
+    const beakRight = state.facing === "left" ? beakFull : ">";
+    const beakLeft = state.facing === "right" ? (state.energy > 0.55 ? ">" : "c") : beakLeftFor(state);
+    void beakLeft; // kept to document the two-sided beak choice
+    const body = bodyForMood(state.mood, state.energy);
+    return state.facing === "right" ? `${body} ${eye}${beakRight}` : `${beakRight}${eye} ${body}`;
+}
+function beakLeftFor(state) {
+    return state.energy > 0.55 ? "<" : "c";
+}
+function bodyForMood(mood, energy) {
+    switch (mood) {
+        case "thinking":
+            return energy > 0.5 ? "v" : "~";
+        case "error":
+            return "!";
+        case "celebrating":
+            return "*";
+        case "listening":
+            return "^";
+        case "alert":
+            return "^";
+        case "preening":
+            return ".";
+        case "idle":
+        default:
+            return "o";
+    }
+}
+//# sourceMappingURL=raven-state.js.map

package/dist/ui/raven/raven-state.js.map

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