aiden-runtime 4.0.2 → 4.1.1

package/dist/cli/v4/commands/cron.js

@@ -65,6 +65,7 @@ const node_fs_1 = require("node:fs");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const os = __importStar(require("node:os"));
+const table_1 = require("../table");
 const cronManager_1 = require("../../../core/cronManager");
 const NAME_RE = /^[A-Za-z0-9_-]+$/;
 const LOGS_DIR = path.join(os.homedir(), '.aiden', 'cron-logs');
@@ -128,7 +129,11 @@ function shortId(id) {
 function colourResult(ctx, result) {
     if (result === 'ok')
         return '✓';
-    if (result === 'fail')
+    if (result === 'warn')
+        return '∼';
+    if (result === 'fail'
+        || result === 'error'
+        || result === 'timeout')
         return '✗';
     return '·';
 }
@@ -180,22 +185,18 @@ function cmdList(ctx) {
         schedule: j.schedule,
         enabled: j.enabled ? 'on' : 'off',
         lastRun: fmtTime(j.lastRun),
-        glyph: colourResult(ctx, j.lastResult),
+        result: j.lastResult ?? '—',
     }));
-    const widths = {
-        id: Math.max(2, ...rows.map(r => r.id.length)),
-        name: Math.max(4, ...rows.map(r => r.name.length)),
-        schedule: Math.max(8, ...rows.map(r => r.schedule.length)),
-        enabled: 3,
-        lastRun: Math.max(7, ...rows.map(r => r.lastRun.length)),
-    };
-    ctx.display.write(`  ${'ID'.padEnd(widths.id)}  ${'NAME'.padEnd(widths.name)}  ` +
-        `${'SCHEDULE'.padEnd(widths.schedule)}  EN   ${'LAST RUN'.padEnd(widths.lastRun)}  R\n`);
-    for (const r of rows) {
-        ctx.display.write(`  ${r.id.padEnd(widths.id)}  ${r.name.padEnd(widths.name)}  ` +
-            `${r.schedule.padEnd(widths.schedule)}  ${r.enabled.padEnd(3)}  ` +
-            `${r.lastRun.padEnd(widths.lastRun)}  ${r.glyph}\n`);
-    }
+    ctx.display.write((0, table_1.renderTable)(rows, [
+        { key: 'id', header: 'ID', align: 'left' },
+        { key: 'name', header: 'Name', align: 'left', flex: true },
+        { key: 'schedule', header: 'Schedule', align: 'left' },
+        { key: 'enabled', header: 'En', align: 'center',
+            color: (v) => (v === 'on' ? 'success' : 'muted') },
+        { key: 'lastRun', header: 'Last Run', align: 'left' },
+        { key: 'result', header: 'R', align: 'center',
+            color: (v) => (v === 'ok' ? 'success' : v === 'fail' ? 'error' : 'muted') },
+    ]));
 }
 async function cmdRun(ctx, args) {
     const job = resolveJob(args[0] ?? '');
@@ -278,6 +279,29 @@ function cmdDisable(ctx, args) {
     else
         ctx.display.printError('Disable failed.');
 }
+async function cmdStatus(ctx) {
+    const diag = await (0, cronManager_1.getDiagnostics)();
+    ctx.display.info(`Aiden cron — ${cronManager_1.AIDEN_CRON_BUILD}`);
+    ctx.display.write(`  schema version : ${diag.schemaVersion}\n`);
+    ctx.display.write(`  tick interval  : ${diag.tickMs}ms\n`);
+    ctx.display.write(`  fire timeout   : ${diag.timeoutMs}ms\n`);
+    ctx.display.write(`  heartbeat      : ${diag.heartbeatActive ? 'active' : 'idle'}\n`);
+    ctx.display.write(`  last heartbeat : ${diag.lastHeartbeatAt ?? 'never'}\n`);
+    ctx.display.write(`  skipped ticks  : ${diag.skippedTicks}\n`);
+    ctx.display.write(`  fires (boot)   : ${diag.firesStarted}\n`);
+    ctx.display.write(`  lock           : ${diag.lock.held ? 'held' : 'free'} (${diag.lock.path})\n`);
+    if (diag.recentFires.length > 0) {
+        ctx.display.write(`  recent fires:\n`);
+        for (const r of diag.recentFires) {
+            const tag = r.status === 'ok' ? '✓'
+                : r.status === 'warn' ? '∼'
+                    : r.status === 'timeout' ? 'T'
+                        : '✗';
+            ctx.display.write(`    ${tag} [${r.jobId.slice(0, 8)}]  ${fmtTime(r.startedAt)}  ${r.durationMs}ms` +
+                `${r.error ? '  ' + r.error.slice(0, 60) : ''}\n`);
+        }
+    }
+}
 async function cmdRemove(ctx, args) {
     const job = resolveJob(args[0] ?? '');
     if (!job) {
@@ -335,6 +359,9 @@ exports.cron = {
             case 'info':
                 cmdShow(ctx, rest);
                 break;
+            case 'status':
+                await cmdStatus(ctx);
+                break;
             case 'logs':
             case 'log':
                 await cmdLogs(ctx, rest);
@@ -361,6 +388,7 @@ exports.cron = {
                 ctx.display.write('  /cron logs <id|name>\n');
                 ctx.display.write('  /cron enable|disable <id|name>\n');
                 ctx.display.write('  /cron remove <id|name>\n');
+                ctx.display.write('  /cron status                  (v4.1-cron diagnostics)\n');
                 ctx.display.dim('Schedules: cron expr ("0 9 * * *"), interval ("every 2m"), one-shot ISO.');
                 break;
             default:

package/dist/cli/v4/commands/fanout.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/commands/fanout.ts — Phase v4.1-subagent
+ *
+ * `aiden fanout "<query>" --n=3 --merge=combine [--mode=ensemble]`
+ * one-shot CLI subcommand. Spins up N parallel children against the
+ * built-in agent runtime, prints the merged answer, and exits.
+ *
+ * Dry-run mode (`--dry-run` flag, OR env `AIDEN_FANOUT_DRY_RUN=1`)
+ * uses synthetic in-process stubs for both children and aggregator
+ * — no LLM calls. Used by the runtime smoke to verify the
+ * Promise.all + merge dispatch path against the BUILT artifact
+ * without depending on provider keys or network access.
+ *
+ * The slash-command counterpart (`/fanout` inside the REPL) lives
+ * in this same module — it shares the same arg parser. The REPL
+ * registers the slash command via `core/v4/commandRegistry`; the
+ * CLI subcommand is wired in `cli/v4/aidenCLI.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFanoutArgs = parseFanoutArgs;
+exports.runFanoutCli = runFanoutCli;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const fanout_1 = require("../../../core/v4/subagent/fanout");
+function parseFanoutArgs(argv) {
+    const args = { positional: [] };
+    let i = 0;
+    while (i < argv.length) {
+        const a = argv[i];
+        if (a === '--dry-run') {
+            args.dryRun = true;
+            i += 1;
+            continue;
+        }
+        const eq = a.startsWith('--') ? a.indexOf('=') : -1;
+        let key = null;
+        let value = null;
+        if (eq > 0) {
+            key = a.slice(2, eq);
+            value = a.slice(eq + 1);
+            i += 1;
+        }
+        else if (a.startsWith('--')) {
+            key = a.slice(2);
+            value = argv[i + 1] ?? '';
+            i += 2;
+        }
+        else {
+            args.positional.push(a);
+            i += 1;
+            continue;
+        }
+        switch (key) {
+            case 'n':
+                args.n = Number.parseInt(value, 10);
+                break;
+            case 'merge':
+                if (value === 'all' || value === 'vote' || value === 'pick-best' || value === 'combine') {
+                    args.merge = value;
+                }
+                break;
+            case 'mode':
+                if (value === 'partition' || value === 'ensemble') {
+                    args.mode = value;
+                }
+                break;
+            case 'timeout-ms':
+            case 'timeoutMs':
+                args.timeoutMs = Number.parseInt(value, 10);
+                break;
+            default:
+                // Unknown flag — silently dropped, user gets feedback via missing-defaults.
+                break;
+        }
+    }
+    return {
+        query: args.positional.join(' '),
+        n: typeof args.n === 'number' && Number.isFinite(args.n) ? args.n : 3,
+        merge: args.merge ?? 'combine',
+        mode: args.mode ?? 'ensemble',
+        timeoutMs: args.timeoutMs,
+        dryRun: args.dryRun ?? false,
+    };
+}
+/** Run the CLI subcommand. Returns the process exit code. */
+async function runFanoutCli(argv, opts = {}) {
+    const writeOut = opts.writeOut ?? ((t) => process.stdout.write(t));
+    const writeErr = opts.writeErr ?? ((t) => process.stderr.write(t));
+    const env = opts.env ?? process.env;
+    const args = parseFanoutArgs(argv);
+    if (!args.query) {
+        writeErr('Usage: aiden fanout "<query>" [--n=3] [--merge=combine] [--mode=ensemble] [--dry-run]\n');
+        return 1;
+    }
+    const dryRun = args.dryRun || env.AIDEN_FANOUT_DRY_RUN === '1' || env.AIDEN_FANOUT_DRY_RUN === 'true';
+    if (!dryRun) {
+        // Phase v4.1-subagent.1 — live mode boots a real agent runtime,
+        // pulls the wired subagent_fanout handler out of the registry,
+        // and dispatches one fanout call. The runtime build is the same
+        // one `aiden chat` / `aiden mcp` use; provider resolution, plugin
+        // discovery, etc. all run. On systems with no providers configured
+        // it'll surface the same friendly error the chat REPL does.
+        try {
+            // Lazy-import buildAgentRuntime to avoid pulling its (large)
+            // dependency graph into every CLI invocation. mcp / subagent /
+            // version don't need it.
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { buildAgentRuntime } = require('../aidenCLI');
+            const runtime = await buildAgentRuntime({}, {});
+            const registry = runtime.toolRegistry;
+            const handler = registry.get('subagent_fanout');
+            if (!handler) {
+                writeErr('aiden fanout: subagent_fanout not registered (build bug)\n');
+                return 1;
+            }
+            const toolArgs = {
+                mode: args.mode,
+                n: args.n,
+                merge: args.merge,
+            };
+            if (args.mode === 'ensemble') {
+                toolArgs.query = args.query;
+            }
+            else {
+                toolArgs.tasks = Array.from({ length: args.n }, (_, i) => ({
+                    goal: `Task ${i + 1} from CLI: ${args.query}`,
+                }));
+            }
+            if (args.timeoutMs)
+                toolArgs.timeoutMs = args.timeoutMs;
+            const result = await handler.execute(toolArgs, {
+                cwd: process.cwd(),
+                paths: runtime.paths,
+                sessions: runtime.sessionManager,
+                memory: runtime.memoryManager,
+                skillLoader: runtime.skillLoader,
+            });
+            if (!result.success) {
+                writeErr(`aiden fanout: ${result.error ?? 'unknown error'}\n`);
+                return 1;
+            }
+            writeOut(`fanout (live)\n`);
+            writeOut(`  mode:      ${args.mode}\n`);
+            writeOut(`  n:         ${args.n}\n`);
+            writeOut(`  merge:     ${args.merge}\n`);
+            writeOut(`  query:     ${args.query}\n`);
+            if (result.diagnostics) {
+                writeOut(`  succeeded: ${result.diagnostics.succeeded}/${args.n}\n`);
+                writeOut(`  totalMs:   ${result.diagnostics.totalMs}\n`);
+                writeOut(`  providers: ${result.diagnostics.providerDistribution.join(', ')}\n`);
+            }
+            writeOut(`\n--- merged ---\n`);
+            if (args.merge === 'all' && result.results) {
+                for (const r of result.results) {
+                    writeOut(`\n[${r.index}] ${r.providerId}:${r.modelId} (${r.elapsedMs}ms)\n`);
+                    writeOut(`${r.error ? `[error: ${r.error}]` : r.output}\n`);
+                }
+            }
+            else {
+                writeOut(`${result.merged ?? '(no merged output)'}\n`);
+            }
+            return 0;
+        }
+        catch (err) {
+            writeErr(`aiden fanout failed: ${err.message}\n`);
+            return 1;
+        }
+    }
+    // ── Dry-run path: stub providers, stub child runner, stub aggregator
+    // ─ exercises the Promise.all + abort + merge plumbing against the
+    // built artifact without touching network or provider keys.
+    const providers = [
+        { providerId: 'stub-a', modelId: 'fake-model' },
+        { providerId: 'stub-b', modelId: 'fake-model' },
+    ];
+    const stubAdapter = {
+        apiMode: 'chat_completions',
+        async call() {
+            return {
+                content: '[dry-run aggregator]',
+                toolCalls: [],
+                finishReason: 'stop',
+                usage: { inputTokens: 0, outputTokens: 0 },
+            };
+        },
+    };
+    try {
+        const result = await (0, fanout_1.runFanout)({
+            mode: args.mode,
+            query: args.query,
+            tasks: args.mode === 'partition'
+                ? Array.from({ length: args.n }, (_, i) => ({
+                    goal: `Task ${i + 1} from CLI: ${args.query}`,
+                }))
+                : undefined,
+            n: args.n,
+            merge: args.merge,
+            providers,
+            runChild: async ({ index, prompt, provider }) => {
+                return `[dry-run child ${index} via ${provider.providerId}] echo: ${prompt}`;
+            },
+            aggregatorAdapter: stubAdapter,
+            aggregatorModel: { providerId: 'stub-a', modelId: 'fake-model' },
+            timeoutMs: args.timeoutMs,
+        });
+        writeOut(`fanout dry-run\n`);
+        writeOut(`  mode:      ${args.mode}\n`);
+        writeOut(`  n:         ${args.n}\n`);
+        writeOut(`  merge:     ${args.merge}\n`);
+        writeOut(`  query:     ${args.query}\n`);
+        writeOut(`  succeeded: ${result.diagnostics.succeeded}/${args.n}\n`);
+        writeOut(`  totalMs:   ${result.diagnostics.totalMs}\n`);
+        writeOut(`  providers: ${result.diagnostics.providerDistribution.join(', ')}\n`);
+        writeOut(`\n--- merged ---\n`);
+        if (args.merge === 'all') {
+            for (const r of result.results) {
+                writeOut(`\n[${r.index}] ${r.providerId}:${r.modelId} (${r.elapsedMs}ms)\n`);
+                writeOut(`${r.output}\n`);
+            }
+        }
+        else {
+            writeOut(`${result.merged ?? '(no merged output)'}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        writeErr(`fanout failed: ${err.message}\n`);
+        return 1;
+    }
+}

package/dist/cli/v4/commands/help.js

@@ -46,6 +46,14 @@ exports.SUBSECTION_MAP = {
     quit: 'System',
     yolo: 'System',
     usage: 'System',
+    cron: 'System',
+    setup: 'System',
+    channel: 'System',
+    // Phase v4.1-tier3.1 + tier3-essentials commands.
+    voice: 'System',
+    status: 'System',
+    show: 'System',
+    history: 'System',
     // ── Authentication ──
     auth: 'Authentication',
     // ── Help ──
@@ -58,7 +66,7 @@ exports.help = {
     name: 'help',
     description: 'List available slash commands.',
     category: 'system',
-    icon: '❔',
+    icon: '?',
     aliases: ['h', '?'],
     handler: async (ctx) => {
         const all = ctx.registry.list();
@@ -71,21 +79,24 @@ exports.help = {
         for (const c of system) {
             buckets.get(subsectionFor(c.name)).push(c);
         }
+        // Tier-3.1: gate icon column on AIDEN_UI_ICONS=1 (default OFF).
+        const showIcons = process.env.AIDEN_UI_ICONS === '1';
         for (const sec of exports.SUBSECTION_ORDER) {
             const cmds = buckets.get(sec);
             if (cmds.length === 0)
                 continue;
             ctx.display.dim(`── ${sec} ──`);
             for (const c of cmds) {
-                const icon = c.icon ?? ' ';
-                ctx.display.write(`  ${icon} /${c.name.padEnd(14)} ${c.description}\n`);
+                const prefix = showIcons ? `${c.icon ?? ' '} ` : '';
+                ctx.display.write(`  ${prefix}/${c.name.padEnd(14)} ${c.description}\n`);
             }
             ctx.display.write('\n');
         }
         if (skill.length > 0) {
             ctx.display.dim('── Skills ──');
             for (const c of skill) {
-                ctx.display.write(`  ⚡ /${c.name.padEnd(14)} ${c.description}\n`);
+                const prefix = showIcons ? '⚡ ' : '';
+                ctx.display.write(`  ${prefix}/${c.name.padEnd(14)} ${c.description}\n`);
             }
         }
         return {};

package/dist/cli/v4/commands/history.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Copyright (c) 2026 Shiva Deore (Taracod).
+ * Licensed under AGPL-3.0. See LICENSE for details.
+ *
+ * Aiden — local-first agent.
+ */
+/**
+ * cli/v4/commands/history.ts — Phase v4.1-tier3-essentials
+ *
+ * `/history [list|clear] [N]`
+ *
+ *   /history          — list last 50 entries (newest first)
+ *   /history list 200 — list last 200 (clamped to HISTORY_MAX_ENTRIES)
+ *   /history clear    — wipe the on-disk history (with double-Enter
+ *                       confirmation)
+ *
+ * The on-disk file is `<aidenHome>/.aiden_history`, written by
+ * `historyStore.appendHistory`. This command is read-only except for
+ * `clear`, which removes the file entirely.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.history = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const historyStore_1 = require("../historyStore");
+const paths_1 = require("../../../core/v4/paths");
+const HISTORY_FILENAME = '.aiden_history';
+exports.history = {
+    name: 'history',
+    description: 'List or clear the on-disk prompt history.',
+    category: 'system',
+    handler: async (ctx) => {
+        const sub = (ctx.args[0] ?? 'list').toLowerCase();
+        if (sub === 'list') {
+            const limit = (() => {
+                const arg = ctx.args[1];
+                const n = arg ? parseInt(arg, 10) : 50;
+                if (!Number.isFinite(n) || n <= 0)
+                    return 50;
+                return Math.min(n, historyStore_1.HISTORY_MAX_ENTRIES);
+            })();
+            const entries = await (0, historyStore_1.loadRecent)(limit);
+            if (entries.length === 0) {
+                ctx.display.dim('(history is empty)');
+                return {};
+            }
+            ctx.display.info(`History (last ${entries.length}):`);
+            // Newest first; render as numbered list. Truncate each entry
+            // to keep the display tidy — full entry is one Enter away on
+            // arrow-up in the new prompt.
+            entries.forEach((entry, i) => {
+                const oneLine = entry.replace(/\s+/g, ' ').trim();
+                const display = oneLine.length > 100 ? oneLine.slice(0, 99) + '…' : oneLine;
+                ctx.display.write(`  ${String(i + 1).padStart(3, ' ')}. ${display}\n`);
+            });
+            return {};
+        }
+        if (sub === 'clear') {
+            const confirm = ctx.args[1];
+            if (confirm !== '--yes') {
+                ctx.display.warn('History clear requires confirmation.');
+                ctx.display.dim('Run `/history clear --yes` to wipe the on-disk history file.');
+                return {};
+            }
+            const filePath = node_path_1.default.join((0, paths_1.resolveAidenPaths)().root, HISTORY_FILENAME);
+            try {
+                await node_fs_1.promises.rm(filePath, { force: true });
+                // Also drop any sibling .tmp left from an interrupted append.
+                await node_fs_1.promises.rm(`${filePath}.tmp`, { force: true });
+                ctx.display.success('History cleared.');
+            }
+            catch (err) {
+                ctx.display.printError(`Failed to clear history: ${err.message}`);
+            }
+            return {};
+        }
+        ctx.display.printError(`Unknown subcommand: ${sub}`, 'Try: /history list [N] | /history clear --yes');
+        return {};
+    },
+};

package/dist/cli/v4/commands/index.js

@@ -12,7 +12,7 @@
  * and registers each on the global CommandRegistry at boot.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.allCommands = exports.setup = exports.cron = exports.doctor = exports.license = exports.auth = exports.plugins = exports.streaming = exports.debugPrompt = exports.identity = exports.providers = exports.quit = exports.clear = exports.verbose = exports.reasoning = exports.reloadMcp = exports.skills = exports.skin = exports.yolo = exports.usage = exports.compress = exports.title = exports.save = exports.personality = exports.model = exports.tools = exports.help = void 0;
+exports.allCommands = exports.history = exports.show = exports.status = exports.voice = exports.channel = exports.setup = exports.cron = exports.doctor = exports.license = exports.auth = exports.plugins = exports.streaming = exports.debugPrompt = exports.identity = exports.providers = exports.quit = exports.clear = exports.verbose = exports.reasoning = exports.reloadMcp = exports.skills = exports.skin = exports.yolo = exports.usage = exports.compress = exports.title = exports.save = exports.personality = exports.model = exports.tools = exports.help = void 0;
 const help_1 = require("./help");
 Object.defineProperty(exports, "help", { enumerable: true, get: function () { return help_1.help; } });
 const tools_1 = require("./tools");
@@ -65,6 +65,16 @@ const cron_1 = require("./cron");
 Object.defineProperty(exports, "cron", { enumerable: true, get: function () { return cron_1.cron; } });
 const setup_1 = require("./setup");
 Object.defineProperty(exports, "setup", { enumerable: true, get: function () { return setup_1.setup; } });
+const channel_1 = require("./channel");
+Object.defineProperty(exports, "channel", { enumerable: true, get: function () { return channel_1.channel; } });
+const voice_1 = require("./voice");
+Object.defineProperty(exports, "voice", { enumerable: true, get: function () { return voice_1.voice; } });
+const status_1 = require("./status");
+Object.defineProperty(exports, "status", { enumerable: true, get: function () { return status_1.status; } });
+const show_1 = require("./show");
+Object.defineProperty(exports, "show", { enumerable: true, get: function () { return show_1.show; } });
+const history_1 = require("./history");
+Object.defineProperty(exports, "history", { enumerable: true, get: function () { return history_1.history; } });
 /** All built-in system commands, in canonical order. */
 exports.allCommands = [
     help_1.help,
@@ -88,6 +98,11 @@ exports.allCommands = [
     doctor_1.doctor,
     cron_1.cron,
     setup_1.setup,
+    channel_1.channel,
+    voice_1.voice,
+    status_1.status,
+    show_1.show,
+    history_1.history,
     reloadMcp_1.reloadMcp,
     reasoning_1.reasoning,
     verbose_1.verbose,