aiden-runtime 4.7.0 → 4.8.0

package/dist/cli/v4/design/tokens.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/design/tokens.ts — v4.8.0 Slice 2 design-system foundation.
+ *
+ * Color, glyph, and spacing tokens consumed by every subsequent slice
+ * (tables, panels, status bar, markdown, loading state). Hex strings
+ * here parallel the RGB tuples in `skinEngine.ts` — tokens.ts is the
+ * design intent, skinEngine is the runtime color authority for
+ * `applyColors(text, kind)`. Renderer slices (3+) consume these.
+ * isVerbose() reads env at call time (Ollama-options precedent).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERBOSE_MODE_ENV = exports.spacing = exports.glyphs = exports.colors = exports.TRAIL_PIPE = void 0;
+exports.isVerbose = isVerbose;
+// Re-export so consumers can import the trail gutter from tokens
+// alongside the rest of the design system. The original constant
+// stays at its current home for backward compatibility with code
+// that imports from `display/toolTrail` directly.
+var toolTrail_1 = require("../display/toolTrail");
+Object.defineProperty(exports, "TRAIL_PIPE", { enumerable: true, get: function () { return toolTrail_1.TRAIL_PIPE; } });
+// ── Colors ────────────────────────────────────────────────────────────────
+/**
+ * Hex color tokens. Mirrors skinEngine RGB tuples for existing kinds;
+ * adds `content.tertiary`, `semantic.info`, `surface.*` (renderer
+ * slices propagate these to skinEngine). Content primary lifted
+ * `#e0e0e0` → `#e8ebf0` for legibility on dark terminals.
+ */
+exports.colors = {
+    brand: {
+        /** Aiden signature orange — already used by skinEngine's `brand`. */
+        primary: '#FF6B35',
+        /** 30%-luma brand orange for borders and dim brand surfaces. */
+        muted: '#7a3119',
+    },
+    content: {
+        /** Brightest text — primary reply content, headings on dark bg. */
+        primary: '#e8ebf0',
+        /** Warm muted — gutter, secondary detail, post-action timeline. */
+        secondary: '#b8a89a',
+        /** Least-important text — captions, dim status, deprecated rows. */
+        tertiary: '#6a6a6a',
+    },
+    semantic: {
+        success: '#7fc28b',
+        warn: '#e0a040',
+        error: '#e05a5a',
+        info: '#7da7c7',
+    },
+    /**
+     * v4.8.0 Slice 7 hotfix #2 — per-metric accent palette for the
+     * packed status footer. Each metric gets a stable colour so
+     * cross-glance reading stays consistent: cyan model, amber tokens,
+     * purple turn count, teal timer. Maps to skinEngine ColorKinds at
+     * runtime: tool / warn / metric_turn / success.
+     */
+    metrics: {
+        model: '#9cdcfe',
+        tokens: '#e0a040',
+        turnCount: '#a48be0',
+        timer: '#7fc28b',
+    },
+    surface: {
+        /** Terminal background reference; tokens never paint bg directly. */
+        bg: '#0d0e10',
+        /** Elevated panel fill (Slice 4 cards / boxed surfaces). */
+        elevated: '#16181b',
+        /** Panel borders — frames around tables, capability cards. */
+        border: '#2a2a2a',
+        /** Section dividers — between boot card and REPL, between events. */
+        divider: '#3a3a3a',
+    },
+};
+// ── Glyphs ────────────────────────────────────────────────────────────────
+/**
+ * Centralized glyph vocabulary. Four namespaces — `event` (ui_* row
+ * glyphs), `status` (boot/footer chrome), `util` (bullets, dividers,
+ * checks), `trail` (tool-trail row prefix). Renderer slices (3+)
+ * replace inline literals with these references.
+ */
+exports.glyphs = {
+    event: {
+        /** ui_task_update status:'running' */
+        running: '⟳',
+        /** ui_task_done status:'success' */
+        done: '✓',
+        /** ui_task_done status:'failure' */
+        fail: '✗',
+        /** ui_task_done status:'blocked' / hard-blocked */
+        blocked: '⊘',
+        /** ui_task_update status:'paused' */
+        paused: '⏸',
+        /** ui_task_update status:'blocked' (soft block, awaiting input) */
+        hardBlock: '⛔',
+        /** ui_approval_request leading glyph + ui_toast kind:'warning' */
+        warning: '⚠',
+        /** ui_toast kind:'info' */
+        info: 'ℹ',
+        /** ui_command_result header glyph */
+        cmd: '▸',
+        /** ui_artifact_created kind:'file' */
+        file: '📄',
+        /** ui_artifact_created kind:'skill' */
+        skill: '🛠',
+        /** ui_artifact_created kind:'directory' */
+        directory: '📁',
+    },
+    status: {
+        /** User-prompt prefix + Aiden brand triangle (activityIndicator). */
+        triangle: '▲',
+        /** Solid filled dot — used for `●` status markers. */
+        dot: '●',
+        /** Hollow dot — companion to `dot` for inactive states. */
+        dotOpen: '○',
+        /** Status footer column separator. */
+        sep: '│',
+        /** Slice 7 — turn counter prefix. Slice 9 hotfix: glyph dropped
+         *  entirely. The bare colored number (purple `metric_turn` kind)
+         *  carries the meaning, matching the timer pattern. */
+        turn: '',
+        /** Slice 7 — session timer prefix. Slice 9 hotfix: `⌛` (U+231B
+         *  HOURGLASS WITH FLOWING SAND) restored. The font set Shiva
+         *  confirmed renders ●/○/▲ also renders this widely-supported
+         *  emoji-class hourglass. Trailing space owned by the segment
+         *  composition site to keep the token minimal. */
+        timer: '⌛',
+    },
+    util: {
+        /** Section / row divider. */
+        divider: '─',
+        /** Solid bullet for list rows. */
+        bullet: '●',
+        /** Hollow bullet (inactive / unselected). */
+        bulletOpen: '○',
+        /** Mid-dot — existing skin bullet for compact lists. */
+        midDot: '•',
+        /** Check-success — heavier than ui-event `✓` for emphasis. Slice 8
+         *  hotfix: VS16 (U+FE0F) appended to force emoji-presentation width
+         *  = 2 cells so `✔` renders with the same visual heft as `●`/`○`
+         *  bullets and doesn't sit flush against following text. Same fix
+         *  pattern as Slice 5 for `✏`/`👁`. */
+        check: '✔️',
+        /** Inline arrow — submenu, breadcrumb. */
+        arrow: '›',
+        /** Trail-style horizontal arrow — ui_command_result header. */
+        triArrow: '▸',
+    },
+    trail: {
+        /** Tool-trail gutter character. Re-exported from toolTrail.ts. */
+        gutter: '┊',
+    },
+    /**
+     * Box-drawing chrome for table + panel surfaces (Slice 3+). Renders
+     * sharp ASCII so wide-display terminals and narrow ConPTYs both
+     * align cleanly. Slice 4 reuses `hLine` for the panel divider.
+     */
+    chrome: {
+        topLeft: '┌', topRight: '┐', botLeft: '└', botRight: '┘',
+        teeDown: '┬', teeUp: '┴', teeRight: '├', teeLeft: '┤',
+        cross: '┼', hLine: '─', vLine: '│',
+    },
+    /**
+     * Aiden-native framed-panel chrome (Slice 4). Left-edge accent bar
+     * gives panels brand identity without a closing box; asymmetric
+     * chrome (top + bottom dividers, no corners) reads as intentional
+     * Aiden signature rather than borrowed pattern.
+     *
+     * v4.8.0 Slice 11c — bar glyph swapped from `▎` (U+258E LEFT ONE
+     * QUARTER BLOCK) to `│` (U+2502 BOX DRAWING LIGHT VERTICAL).
+     * `▎` rendered as outline-tofu on Cascadia / common Windows
+     * ConPTY fonts; `│` is universally supported across Consolas,
+     * Cascadia, SF Mono, JetBrains Mono, etc. (same source as the
+     * existing `chrome.vLine`). Brand identity now carried by colour,
+     * not by an exotic codepoint. Propagates to all panel surfaces:
+     * /help, approval prompt, Aiden reply header, setup wizard,
+     * Built solo card, and the framed-panel renderer.
+     */
+    panel: {
+        bar: '│',
+    },
+    /**
+     * v4.8.0 Slice 10d — rounded heavy frame for identity / credits
+     * surfaces (the "Built solo" scrollFooter being the first consumer).
+     * Distinct from `glyphs.chrome` which uses SHARP corners (`┌ ┐ └ ┘`)
+     * for table chrome — rounded corners signal "identity card" rather
+     * than "data table". Both glyph sets share `─` and `│` for sides
+     * (those live on `glyphs.chrome.hLine` / `vLine` to avoid duplication).
+     */
+    box: {
+        topLeft: '╭',
+        topRight: '╮',
+        bottomLeft: '╰',
+        bottomRight: '╯',
+    },
+    /**
+     * Status footer progress bar pair. v4.8.0 Slice 7 hotfix #3 — moved
+     * from hex dots (⬢/⬡) back to the U+25CF/U+25CB circle pair: those
+     * codepoints render in every monospace font (Consolas, Cascadia,
+     * SF Mono, JetBrains Mono, etc.) whereas the hex dots required
+     * Nerd Font / Apple Symbols fallback chains and rendered as `□`
+     * boxes on many setups. Colour still carries the meaning; the
+     * glyph just needs to render at all.
+     */
+    bar: {
+        filled: '●',
+        empty: '○',
+    },
+    /**
+     * v4.8.0 Slice 11 — single-row activity-indicator shimmer track.
+     * Replaces the prior 2-row layout (verb row + `▓`/`░` wave bar) with
+     * one row whose leading glyph cluster is a 4-cell `█` (U+2588 FULL
+     * BLOCK) segment sliding left-to-right on a muted `─` track. Both
+     * glyphs are CP437-safe and already shipping in chrome elsewhere
+     * (`hLine`, panel `bar`). Colour, not glyph, signals state: the
+     * filled block paints `brand`, the track paints `muted`.
+     */
+    shimmer: {
+        block: '█',
+        track: '─',
+    },
+};
+// ── Spacing ───────────────────────────────────────────────────────────────
+/**
+ * Integer spacing tokens. 0-indexed column counts; subagent depth
+ * indent is INSIDE the gutter (`┊` stays at col 0, indent shifts the
+ * glyph + content right).
+ */
+exports.spacing = {
+    indent: {
+        /** Column where the trail gutter `┊` lands. */
+        gutter: 0,
+        /** Column where the event glyph lands (after `┊` + space). */
+        glyph: 2,
+        /** Column where primary content text lands (after glyph + space). */
+        content: 4,
+        /** Column where secondary detail text lands (after primary + space). */
+        detail: 6,
+        /** Spaces per subagent depth level (inside the gutter). */
+        subagentPerDepth: 2,
+    },
+    between: {
+        /** Blank rows between related events in the same group. */
+        sameGroup: 0,
+        /** Blank rows between event groups. */
+        groups: 1,
+        /** Blank rows between top-level sections (boot card → REPL → events). */
+        sections: 2,
+    },
+};
+// ── Verbose-mode env-gated flag ───────────────────────────────────────────
+/** Env var name; Slice 5 consumes via isVerbose() to gate debug surfaces. */
+exports.VERBOSE_MODE_ENV = 'AIDEN_VERBOSE';
+/**
+ * Verbose flag, read at call time. Only literal `'1'` enables; any
+ * other value (`'true'`, `'yes'`, etc.) is off so the gate stays
+ * unambiguous. Matches the Ollama-options env-time-read precedent.
+ */
+function isVerbose() {
+    return process.env[exports.VERBOSE_MODE_ENV] === '1';
+}

package/dist/cli/v4/display/framedPanel.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/display/framedPanel.ts — v4.8.0 Slice 4. Aiden-native panel:
+ * left orange bar `▎`, top + bottom dividers (no corners), footer
+ * always present. Max 3 distinct colors per panel.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderFramedPanel = renderFramedPanel;
+const skinEngine_1 = require("../skinEngine");
+const tokens_1 = require("../design/tokens");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const stringWidth = require('string-width');
+function vWidth(s) {
+    try {
+        return stringWidth(s);
+    }
+    catch {
+        return s.length;
+    }
+}
+const BAR_COLOR = 'brand';
+function statusKind(s) {
+    if (s === 'active')
+        return 'success';
+    if (s === 'running')
+        return 'tool';
+    if (s === 'disabled')
+        return 'muted';
+    if (s === 'installed' || s === 'available')
+        return 'session';
+    return 'muted';
+}
+/**
+ * Render the Aiden-native framed panel. Returns a multi-line string
+ * with trailing newline; caller writes via `display.write`.
+ */
+/**
+ * v4.8.0 Slice 4 hotfix — word-boundary wrap. Returns the input split
+ * into chunks each ≤ `max` visible chars, preferring spaces. Used by
+ * the panel description column when the row's text exceeds the
+ * allocated width: subsequent chunks render on indented continuation
+ * lines instead of being truncated to `…`.
+ */
+function smartWrap(s, max) {
+    if (max <= 0 || vWidth(s) <= max)
+        return [s];
+    const out = [];
+    let rest = s;
+    while (vWidth(rest) > max) {
+        let cut = max;
+        const lastSpace = rest.slice(0, max).lastIndexOf(' ');
+        if (lastSpace >= Math.floor(max * 0.5))
+            cut = lastSpace;
+        out.push(rest.slice(0, cut).trimEnd());
+        rest = rest.slice(cut).trimStart();
+    }
+    if (rest.length > 0)
+        out.push(rest);
+    return out;
+}
+function renderFramedPanel(opts) {
+    const sk = (0, skinEngine_1.getSkinEngine)();
+    // v4.8.0 Slice 4 hotfix — read terminal width like table.ts does so
+    // wide terminals get wide panels instead of a hardcoded 72-col cap.
+    // Indent every row by 2 cells (matches table's `indent` default) so
+    // the left bar sits at col 2 rather than col 0 — col-0 paint reads
+    // as "terminal-edge artifact" instead of "panel boundary".
+    const indent = '  ';
+    const termCols = process.stdout.columns ?? 100;
+    const innerW = Math.max(40, opts.width ?? Math.min(termCols - indent.length, 110));
+    const bar = sk.applyColors(tokens_1.glyphs.panel.bar, BAR_COLOR);
+    const line = (content) => `${indent}${bar} ${content}`;
+    const maxCmd = Math.max(...opts.rows.map(r => vWidth(r.command)), 4);
+    const maxArgs = Math.max(...opts.rows.map(r => vWidth(r.args ?? '')), 0);
+    const cmdCol = maxCmd + 2;
+    const argsCol = maxArgs > 0 ? maxArgs + 2 : 0;
+    const maxStat = Math.max(...opts.rows.map(r => vWidth(r.status ?? '')), 0);
+    const statCol = maxStat > 0 ? maxStat + 2 : 0;
+    const descCol = Math.max(8, innerW - 2 - cmdCol - argsCol - statCol);
+    const lines = [];
+    const titlePaint = sk.applyColors(opts.title, 'heading');
+    if (opts.subtitle) {
+        const subRight = ' '.repeat(Math.max(0, innerW - 1 - vWidth(opts.title) - vWidth(opts.subtitle)));
+        lines.push(line(` ${titlePaint}${subRight}${sk.applyColors(opts.subtitle, 'muted')}`));
+    }
+    else {
+        lines.push(line(` ${titlePaint}`));
+    }
+    lines.push(line(' ' + sk.applyColors(tokens_1.glyphs.chrome.hLine.repeat(innerW - 2), 'muted')));
+    // Body rows — wrap descriptions instead of truncating.
+    const descIndent = '  ' + ' '.repeat(cmdCol) + ' '.repeat(argsCol);
+    for (const row of opts.rows) {
+        const cmd = sk.applyColors(row.command.padEnd(cmdCol), 'agent');
+        const args = argsCol > 0
+            ? sk.applyColors((row.args ?? '').padEnd(argsCol), 'muted')
+            : '';
+        const stat = statCol > 0 && row.status
+            ? sk.applyColors(row.status.padStart(maxStat), statusKind(row.status))
+            : (statCol > 0 ? ' '.repeat(statCol) : '');
+        const wrapped = smartWrap(row.description, descCol);
+        const head = sk.applyColors(wrapped[0].padEnd(descCol), 'muted');
+        lines.push(line(`  ${cmd}${args}${head}${stat ? ' ' + stat : ''}`));
+        for (let i = 1; i < wrapped.length; i++) {
+            lines.push(line(descIndent + sk.applyColors(wrapped[i].padEnd(descCol), 'muted')));
+        }
+    }
+    lines.push(line(' ' + sk.applyColors(tokens_1.glyphs.chrome.hLine.repeat(innerW - 2), 'muted')));
+    lines.push(line(' ' + sk.applyColors(opts.footer, 'muted')));
+    return lines.join('\n') + '\n';
+}

package/dist/cli/v4/display/toolTrail.js

@@ -49,12 +49,12 @@ const TRAIL_MAP = [
             'file_list', 'list_directory', 'list_directory_with_sizes',
             'directory_tree', 'file_info', 'get_file_info',
             'observe', 'read', 'list'],
-        icon: '👁', verb: 'reading' },
+        icon: '👁️', verb: 'reading' },
     // ── Write / edit / create ────────────────────────────────────────────
     { keys: ['file_write', 'write_file', 'edit_file', 'move_file',
             'notebook_edit', 'create_directory',
             'write', 'edit', 'create', 'save'],
-        icon: '✏', verb: 'writing' },
+        icon: '✏️', verb: 'writing' },
     // ── Execute / run / shell ────────────────────────────────────────────
     { keys: ['bash', 'powershell', 'execute_code', 'skill_view',
             'shortcuts_execute', 'javascript_tool',