aiden-runtime 4.1.2 → 4.1.4

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

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/display/sessionEndCard.ts — Aiden v4.1.3-repl-polish
+ *
+ * Renders a compact session-end summary card from a SessionDistillation.
+ *
+ * Returned as an array of plain lines (WITHOUT trailing '\n'). The caller
+ * writes them with a newline appended, e.g.:
+ *
+ *   for (const line of renderSessionEndCard(dist, colorize)) {
+ *     display.write(line + '\n');
+ *   }
+ *
+ * Design rules (from spec):
+ *   - Skip entirely when user_turns === 0 (silent/internal sessions).
+ *   - Label column is colon-aligned to column LABEL_COL (14).
+ *   - Session ID rendered in 'session' color (soft cyan).
+ *   - Bullets / decisions / open_items shown only when non-empty.
+ *   - Takes a `colorize` callback instead of a SkinEngine directly, so
+ *     the function is fully unit-testable without a Display stack.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSessionEndCard = renderSessionEndCard;
+/** Width of the "Label:" prefix, colon included, padded to this column. */
+const LABEL_COL = 14;
+/** Horizontal rule width (chars). */
+const HR_WIDTH = 48;
+// ── Internal helpers ──────────────────────────────────────────────────────────
+function labelRow(label, value) {
+    return `${`${label}:`.padEnd(LABEL_COL)}${value}`;
+}
+/**
+ * Format a wall-clock duration from two ISO timestamps.
+ * Returns '—' when the delta is ≤0 or non-finite (e.g. partial distillation).
+ */
+function fmtDuration(startIso, endIso) {
+    const ms = new Date(endIso).getTime() - new Date(startIso).getTime();
+    if (!Number.isFinite(ms) || ms <= 0)
+        return '—';
+    const sec = ms / 1000;
+    if (sec < 60)
+        return `${Math.round(sec)}s`;
+    const mins = Math.floor(sec / 60);
+    const remSec = Math.round(sec - mins * 60);
+    return remSec > 0 ? `${mins}m ${remSec}s` : `${mins}m`;
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Render a session-end card from `dist`.
+ *
+ * @param dist              Completed SessionDistillation (may be partial).
+ * @param colorize          Skin-aware colorizer — `(text, kind) => coloredText`.
+ * @param distillationPath  Absolute path the distillation JSON was written to,
+ *                          if any. Rendered as a `Distillation:` row so the
+ *                          user has something concrete to inspect / pass to
+ *                          recall_session. Omitted from the card when null /
+ *                          undefined (e.g. write failed earlier).
+ * @returns                 Array of lines (no trailing newlines). Empty when
+ *                          `user_turns === 0`.
+ */
+function renderSessionEndCard(dist, colorize, distillationPath) {
+    if (dist.user_turns === 0)
+        return [];
+    const lines = [];
+    const hr = colorize('─'.repeat(HR_WIDTH), 'muted');
+    const bullet = colorize('•', 'muted');
+    // ── Header block ───────────────────────────────────────────────────────
+    lines.push(hr);
+    lines.push(labelRow('Session', colorize(dist.session_id, 'session')));
+    lines.push(labelRow('Duration', fmtDuration(dist.started_at, dist.ended_at)));
+    lines.push(labelRow('Turns', String(dist.user_turns)));
+    lines.push(labelRow('Exit', dist.exit_path));
+    if (dist.files_touched.length > 0) {
+        // Show at most 6 files; truncate list with '…' if longer.
+        const shown = dist.files_touched.slice(0, 6);
+        const suffix = dist.files_touched.length > 6
+            ? ` … +${dist.files_touched.length - 6} more`
+            : '';
+        lines.push(labelRow('Files', shown.join(', ') + suffix));
+    }
+    else {
+        lines.push(labelRow('Files', colorize('(none)', 'muted')));
+    }
+    if (dist.tools_used.length > 0) {
+        const top = [...dist.tools_used]
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 5)
+            .map(t => `${t.name}(${t.count})`)
+            .join(', ');
+        lines.push(labelRow('Tools', top));
+    }
+    if (distillationPath) {
+        lines.push(labelRow('Distillation', colorize(distillationPath, 'muted')));
+    }
+    lines.push(hr);
+    // ── Semantic sections (LLM-generated, may be empty on partial) ─────────
+    if (dist.bullets.length > 0) {
+        lines.push('');
+        lines.push(colorize('What happened:', 'heading'));
+        for (const b of dist.bullets) {
+            lines.push(`  ${bullet} ${b}`);
+        }
+    }
+    if (dist.decisions.length > 0) {
+        lines.push('');
+        lines.push(colorize('Decisions:', 'heading'));
+        for (const d of dist.decisions) {
+            lines.push(`  ${bullet} ${d}`);
+        }
+    }
+    if (dist.open_items.length > 0) {
+        lines.push('');
+        lines.push(colorize('Open items:', 'heading'));
+        for (const o of dist.open_items) {
+            lines.push(`  ${bullet} ${o}`);
+        }
+    }
+    // Blank line so "Goodbye." has breathing room.
+    lines.push('');
+    return lines;
+}

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

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/display/toolTrail.ts — Aiden v4.1.3-repl-polish
+ *
+ * Icon + verb lookup for the compact tool-trail rows.
+ *
+ * Format rendered by Display.toolRow():
+ *
+ *   ┊ {icon} {verb:12} {detail:40}
+ *
+ * Rules:
+ *   - Exact tool-name match tried first (lowercased), then substring,
+ *     then the '·' / 'calling' fallback.
+ *   - Success outcomes are SILENT — the running row is erased and nothing
+ *     persists. Only failed/degraded/blocked rows leave a trace.
+ *   - This module is pure (no I/O, no side effects) so it can be tested
+ *     in full isolation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRAIL_PIPE = exports.TRAIL_DETAIL_CAP = exports.TRAIL_VERB_PAD = void 0;
+exports.iconForTool = iconForTool;
+exports.padVerb = padVerb;
+exports.truncDetail = truncDetail;
+/** Width the verb field is padded / trimmed to. */
+exports.TRAIL_VERB_PAD = 12;
+/** Hard cap on the detail (arg-preview) field. */
+exports.TRAIL_DETAIL_CAP = 40;
+/** Row-prefix glyph that replaces the old indent dots. */
+exports.TRAIL_PIPE = '┊';
+/**
+ * Ordered lookup table: tool name patterns → { icon, verb }.
+ *
+ * Exact match (lowercased tool name present in `keys`) is tried before
+ * substring match. Entries are ordered from most-specific to most-generic
+ * so that e.g. `recall_session` matches 'recalling' before the generic
+ * `memory` → 'recalling' entry would.
+ *
+ * Keep entries grouped by semantic category to make auditing easy.
+ */
+const TRAIL_MAP = [
+    // ── Observe / read / list ────────────────────────────────────────────
+    { keys: ['file_read', 'read_file', 'read_text_file', 'read_multiple_files',
+            'file_list', 'list_directory', 'list_directory_with_sizes',
+            'directory_tree', 'file_info', 'get_file_info',
+            'observe', 'read', 'list'],
+        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' },
+    // ── Execute / run / shell ────────────────────────────────────────────
+    { keys: ['bash', 'powershell', 'execute_code', 'skill_view',
+            'shortcuts_execute', 'javascript_tool',
+            'shell_exec', 'process_spawn', 'process_kill',
+            'run', 'execute', 'exec'],
+        icon: '⚡', verb: 'running' },
+    // ── Clipboard ────────────────────────────────────────────────────────
+    { keys: ['clipboard_read', 'clipboard_write', 'clipboard'],
+        icon: '📋', verb: 'copying' },
+    // ── Web / fetch / browse ─────────────────────────────────────────────
+    { keys: ['web_search', 'web_fetch', 'fetch_url', 'fetch_page',
+            'open_url', 'navigate', 'get_page_text', 'read_page',
+            'browser_extract', 'browser_get_url',
+            'search_cloudflare_documentation', 'search_vercel_documentation',
+            'search_mcp_registry',
+            'browser', 'fetch', 'search'],
+        icon: '🌐', verb: 'fetching' },
+    // ── Memory / recall ──────────────────────────────────────────────────
+    { keys: ['recall_session', 'session_search', 'session_list',
+            'memory_add', 'memory_search',
+            'recall', 'memory'],
+        icon: '🧠', verb: 'recalling' },
+    // ── Think / analyse / summarise ──────────────────────────────────────
+    { keys: ['session_summary', 'deep_research', 'analyze', 'think', 'plan'],
+        icon: '🧠', verb: 'thinking' },
+    // ── Skills / tools / catalog ─────────────────────────────────────────
+    { keys: ['skills_list', 'list_connectors', 'suggest_connectors',
+            'skill'],
+        icon: '📋', verb: 'listing' },
+    // ── Screen / capture / inspect ───────────────────────────────────────
+    { keys: ['screenshot', 'browser_screenshot', 'aiden__screenshot',
+            'preview_screenshot', 'preview_snapshot', 'preview_inspect',
+            'computer', 'upload_image', 'read_media_file'],
+        icon: '🖥', verb: 'capturing' },
+    // ── Media control ────────────────────────────────────────────────────
+    // v4.1.4-media: the new three-layer media-control bundle.
+    // Listed BEFORE the launch category so substring matching on `media_*`
+    // tool names hits this category first — without this split, every
+    // media_* name's substring would collide with the 'media' key in the
+    // launch bucket and render as verb "launching".
+    { keys: ['media_key', 'media_sessions', 'media_transport',
+            'now_playing', 'youtube_search'],
+        icon: '▶', verb: 'media' },
+    // ── Media launch / open ──────────────────────────────────────────────
+    // Note: `'media'` as a substring key was removed in v4.1.4 because it
+    // false-matched the new media_* control tools above. Launch tools
+    // (`app_launch`, `open_url`, etc.) are explicit-keyed.
+    { keys: ['app_launch', 'open_url', 'open', 'launch'],
+        icon: '▶', verb: 'launching' },
+    // ── Deploy / build / publish ─────────────────────────────────────────
+    { keys: ['deploy_to_vercel', 'deploy_edge_function', 'apply_migration',
+            'push_notification',
+            'deploy', 'build', 'package', 'push'],
+        icon: '📦', verb: 'deploying' },
+    // ── Message / notify / send ──────────────────────────────────────────
+    { keys: ['create_draft', 'reply_to_toolbar_thread',
+            'send', 'message', 'notify', 'email', 'reply'],
+        icon: '💬', verb: 'sending' },
+    // ── Verify / test / health ───────────────────────────────────────────
+    { keys: ['get_advisors', 'confirm_cost', 'subsystem_health',
+            'verify', 'test', 'doctor', 'health'],
+        icon: '🛡', verb: 'verifying' },
+    // ── Database / query ─────────────────────────────────────────────────
+    { keys: ['execute_sql', 'd1_database_query',
+            'query', 'sql'],
+        icon: '🗄', verb: 'querying' },
+];
+/**
+ * Return the trail icon and verb for `name`.
+ *
+ * 1. Exact match — lowercased tool name is in `entry.keys`
+ * 2. Substring match — any key appears in the lowercased name
+ * 3. Default fallback: `{ icon: '⚡', verb: 'calling' }` — generic
+ *    energy glyph for unmapped tools so the row still visually parses
+ *    as a tool event even when the category is unknown.
+ *
+ * Pure — no side effects. Safe to call in hot paths.
+ */
+function iconForTool(name) {
+    const lc = name.toLowerCase();
+    // Pass 1 — exact match
+    for (const entry of TRAIL_MAP) {
+        if (entry.keys.includes(lc)) {
+            return { icon: entry.icon, verb: entry.verb };
+        }
+    }
+    // Pass 2 — substring match (insertion order = priority)
+    for (const entry of TRAIL_MAP) {
+        for (const key of entry.keys) {
+            if (lc.includes(key)) {
+                return { icon: entry.icon, verb: entry.verb };
+            }
+        }
+    }
+    return { icon: '⚡', verb: 'calling' };
+}
+/**
+ * Pad or trim `verb` to exactly TRAIL_VERB_PAD characters.
+ * Pure helper used by Display.toolRow() to keep columns aligned.
+ */
+function padVerb(verb) {
+    if (verb.length > exports.TRAIL_VERB_PAD)
+        return verb.slice(0, exports.TRAIL_VERB_PAD);
+    return verb.padEnd(exports.TRAIL_VERB_PAD);
+}
+/**
+ * Truncate `s` to TRAIL_DETAIL_CAP chars, appending '…' when cut.
+ * Collapses internal whitespace first so multi-line args stay on one line.
+ */
+function truncDetail(s) {
+    const flat = s.replace(/\s+/g, ' ').trim();
+    if (flat.length <= exports.TRAIL_DETAIL_CAP)
+        return flat;
+    return flat.slice(0, exports.TRAIL_DETAIL_CAP - 1) + '…';
+}