aiden-runtime 4.0.0 → 4.0.2

package/README.md

@@ -59,7 +59,7 @@ Local-first · Self-healing routing · Browser & terminal control · Persistent
 <p align="center">
   <img src="https://img.shields.io/badge/Vitest-4-6e9f18?logo=vitest&logoColor=white&style=for-the-badge" alt="Vitest 4" />
   <img src="https://img.shields.io/badge/esbuild-bundler-ffcf00?logo=esbuild&logoColor=black&style=for-the-badge" alt="esbuild" />
-  <img src="https://img.shields.io/badge/electron--builder-NSIS-47848f?style=for-the-badge" alt="electron-builder" />
+  <img src="https://img.shields.io/badge/install-npm%20global-cb3837?logo=npm&logoColor=white&style=for-the-badge" alt="npm install -g aiden-runtime" />
 </p>
 
 <p align="center">
@@ -139,7 +139,7 @@ Most AI agents answer questions. Aiden runs work end-to-end on your machine.
 - **Plugin extension** — drop a plugin into `<aiden-home>/plugins/` and call `ctx.commandRegistry.register()` to add slash commands without touching core
 - **Open source** — AGPL-3.0 core, Apache-2.0 skills. Read every line, modify anything, contribute back.
 
-Aiden is a local-first AI operating system. It runs entirely on your machine — no cloud account required, no telemetry, no data leaving your hardware unless you configure a cloud provider. It ships with a signed Windows installer, Linux AppImage and .deb, and runs in headless API mode on macOS. Features: 68 bundled skills, 42 built-in tools across 11 categories, multi-layer memory architecture, self-healing provider routing across 19 providers, the ability to control your screen, browse the web, run code, send emails and messages, manage files, and hold a full conversation — offline via Ollama.
+Aiden is a local-first AI operating system. It runs entirely on your machine — no cloud account required, no telemetry, no data leaving your hardware unless you configure a cloud provider. It installs as a global npm package (`aiden-runtime`, ~16 MB) on Windows, Linux, WSL, and macOS — Node.js 18+ is the only prerequisite. Features: 68 bundled skills, 42 built-in tools across 11 categories, multi-layer memory architecture, self-healing provider routing across 19 providers, the ability to control your screen, browse the web, run code, send emails and messages, manage files, and hold a full conversation — offline via Ollama.
 
 ---
 
@@ -164,12 +164,14 @@ For commercial deployments with support and indemnification, see [aiden.taracod.
 
 ## Platform support
 
-| Platform | GUI app | API + CLI | Skills available |
-|---|---|---|---|
-| **Windows 10/11** | ✅ signed installer | ✅ | All 68 (including Windows-only skills) |
-| **Linux** | ✅ AppImage / .deb | ✅ headless | ~62 (Windows-only skills auto-skipped) |
-| **WSL 2** | — | ✅ headless | ~62 (Windows-only skills auto-skipped) |
-| **macOS** | — | ✅ headless | ~62 (Windows-only skills auto-skipped) |
+All platforms use the same npm-based install path. Node.js 18+ is the only prerequisite.
+
+| Platform | Install | Skills available |
+|---|---|---|
+| **Windows 10/11** | ✅ `npm install -g aiden-runtime` | All 68 (including Windows-only skills) |
+| **Linux** | ✅ `npm install -g aiden-runtime` | ~62 (Windows-only skills auto-skipped) |
+| **WSL 2** | ✅ `npm install -g aiden-runtime` | ~62 (Windows-only skills auto-skipped) |
+| **macOS** | ✅ `npm install -g aiden-runtime` | ~62 (Windows-only skills auto-skipped) |
 
 Windows-only skills (clipboard history, Defender, OneNote, Outlook COM, registry, Task Scheduler, etc.) are tagged `platform: windows` and silently skipped on other platforms at load time.
 
@@ -224,18 +226,18 @@ npm install -g aiden-runtime
 aiden
 ```
 
-### Prerequisites (for installer / manual builds)
+### Prerequisites (all platforms)
 - Node.js 18+
-- Git
+- Git (only for the manual install path below)
 - Ollama (optional, for offline mode): [ollama.ai](https://ollama.ai)
 
-### Windows — signed installer
+### Windows — one-line install
 
 ```powershell
 irm aiden.taracod.com/install.ps1 | iex
 ```
 
-Or [download the signed installer](https://github.com/taracodlabs/aiden-releases/releases/latest) manually. Windows 10/11, 64-bit, ~500 MB disk space.
+The installer verifies Node.js 18+ then runs `npm install -g aiden-runtime`. Same package as `npx aiden-runtime` above; just adds the `aiden` command to your PATH so you can launch from any terminal.
 
 ### Linux / WSL / macOS — one-line install
 
@@ -648,7 +650,7 @@ Both the terminal CLI and the browser dashboard (`localhost:4200/ui`) expose the
 
 - **TypeScript 5.9** — strict mode, full typing across core, providers, CLI, API.
 - **Node.js 18+** — runtime; `node-fetch` not needed (built-in `fetch`).
-- **Electron 41** — Windows NSIS installer, Linux AppImage + .deb.
+- **Electron 41** — optional desktop wrapper; primary install is npm-based.
 - **Next.js (app router)** — `dashboard-next/` for the browser UI.
 - **React 18** — dashboard component model.
 - **Playwright 1.58** — browser automation backbone.
@@ -658,7 +660,7 @@ Both the terminal CLI and the browser dashboard (`localhost:4200/ui`) expose the
 - **croner** — cron scheduler.
 - **discord.js**, **@slack/web-api**, **whatsapp-web.js**, **twilio**, **nodemailer**, **imap-simple** — channel adapters.
 - **Vitest 4** — test runner; ~1,500 unit + integration tests.
-- **esbuild** + **electron-builder** — build pipeline.
+- **esbuild** — bundler for the npm package; **electron-builder** — optional desktop wrapper.
 - **Cloudflare Workers** — landing page + license server + install-script proxy.
 
 ---

package/dist/cli/v4/aidenCLI.js

@@ -58,6 +58,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEnvSource = exports.loadAidenEnvFile = void 0;
 exports.main = main;
@@ -71,6 +74,7 @@ exports.runSkillsSubcommand = runSkillsSubcommand;
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const commander_1 = require("commander");
 const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
 const chatSession_1 = require("./chatSession");
 const aidenTUI_1 = require("./aidenTUI");
 const display_1 = require("./display");
@@ -106,6 +110,7 @@ const runtimeResolver_1 = require("../../providers/v4/runtimeResolver");
 const chatCompletionsAdapter_1 = require("../../providers/v4/chatCompletionsAdapter");
 const providerFallback_1 = require("../../core/v4/providerFallback");
 const skillBundledRestore_1 = require("../../core/v4/skillBundledRestore");
+const providerDetection_1 = require("../../core/v4/firstRun/providerDetection");
 const aidenLogger_1 = require("../../core/v4/aidenLogger");
 const plugins_1 = require("../../core/v4/plugins");
 const providerAuth_1 = require("../../core/v4/auth/providerAuth");
@@ -351,9 +356,70 @@ async function buildAgentRuntime(cliOpts, opts) {
     }
     const config = new config_1.ConfigManager(paths);
     await config.load();
-    if (await (0, setupWizard_1.isFreshInstall)(paths)) {
-        process.stdout.write('Aiden is not configured yet. Running setup wizard…\n');
-        await (0, setupWizard_1.runSetupWizard)({ paths });
+    // Phase 30.2 — fresh-user UX. Detection extends the old
+    // `isFreshInstall`-only gate so we cover three new failure modes:
+    //   1. fresh user with no env / no OAuth / no config → wizard fires
+    //      (was working under the old gate; still does).
+    //   2. user with config.yaml pointing at chatgpt-plus but a stale /
+    //      missing OAuth token file → wizard fires (was NOT under old
+    //      code — it saw config.yaml present and proceeded into a
+    //      broken resolve, which surfaced as a confusing rate-limit
+    //      error on the user's first chat).
+    //   3. user with no config but Ollama running OR an env API key
+    //      → wizard fires anyway. ConfigManager's DEFAULT_CONFIG points
+    //      at `anthropic / claude-opus-4-7`, which doesn't match the
+    //      detected env / Ollama, so skipping the wizard would surface
+    //      the same confusing "missing ANTHROPIC_API_KEY" error.
+    //   4. moat-boot test fixtures that stub `providers.fake.apiKey`
+    //      inline in config.yaml count as configured — `isFreshInstall`
+    //      already returns false for them so `wizardNeeded` stays false.
+    const detection = await (0, providerDetection_1.detectAvailableProviders)({ paths });
+    const configuredProviderBroken = !!detection.configProvider &&
+        !detection.configuredProviderHasCredentials;
+    const wizardNeeded = !detection.hasAnyProvider ||
+        configuredProviderBroken ||
+        (await (0, setupWizard_1.isFreshInstall)(paths));
+    // Phase 30.2.1: when the wizard returns 'skipped' (explore mode) we
+    // boot the REPL with a NullAdapter instead of trying to resolve a
+    // real provider. Flagged here, set inside the wizard block, and
+    // consumed when building the adapter.
+    let exploreMode = false;
+    if (wizardNeeded) {
+        if (!detection.hasAnyProvider) {
+            // Truly empty: no env, no OAuth, no Ollama, no inline config.
+            process.stdout.write(`\n${(0, providerDetection_1.summarizeDetection)(detection)}\n`);
+        }
+        else if (configuredProviderBroken) {
+            // Config points at a provider we can't credential-resolve.
+            process.stdout.write(`\nConfigured provider '${detection.configProvider}' has no usable credentials ` +
+                `at ${node_path_1.default.join(paths.root, 'auth', `${detection.configProvider}.json`)}.\n`);
+        }
+        else {
+            // Detected something (env / oauth / ollama) but config.yaml is
+            // missing or empty — DEFAULT_CONFIG would route to anthropic and
+            // the resolver would fail. Surface the detection so the user
+            // sees what we found, then walk them through proper setup.
+            process.stdout.write(`\n${(0, providerDetection_1.summarizeDetection)(detection)}\n`);
+            process.stdout.write('config.yaml is empty — let\'s pick a provider that matches.\n');
+        }
+        process.stdout.write('Launching setup wizard…\n\n');
+        const result = await (0, setupWizard_1.runSetupWizard)({ paths });
+        // Phase 30.2.1: three exit states.
+        if (result.status === 'exited') {
+            // Recovery option [5] — clean exit, no REPL.
+            process.exit(0);
+        }
+        if (result.status === 'skipped') {
+            // Recovery option [4] "explore mode" OR Ctrl+C cancellation.
+            // Boot continues into the REPL with a NullAdapter; chat is
+            // intercepted by ChatSession, slash commands work normally.
+            // Flagged here and consumed below where the adapter is built.
+            exploreMode = true;
+        }
+        // 'configured' (or 'skipped' — we still want the env/.env reload
+        // for slash commands like /providers that read fresh state) →
+        // re-load both so the resolver sees what the wizard wrote.
+        (0, envSources_1.loadAidenEnvFile)(paths.envFile);
         await config.load();
     }
     const providerId = cliOpts.provider ??
@@ -385,19 +451,32 @@ async function buildAgentRuntime(cliOpts, opts) {
     const credentialResolver = new credentialResolver_1.CredentialResolver(paths.authJson);
     const resolver = new runtimeResolver_1.RuntimeResolver(credentialResolver);
     let adapter;
-    try {
-        adapter = await resolver.resolve({ providerId, modelId, config, paths });
+    if (exploreMode) {
+        // Phase 30.2.1 — wizard skipped. Use a NullAdapter so AidenAgent
+        // construction succeeds; ChatSession will intercept chat attempts
+        // BEFORE calling the adapter and surface the friendly message.
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { NullAdapter } = require('../../providers/v4/nullAdapter');
+        adapter = new NullAdapter();
     }
-    catch (err) {
-        display.printError(`Could not resolve provider '${providerId}' / model '${modelId}': ${err.message}`, 'Run `aiden model` to pick a valid provider, or `aiden doctor`.');
-        process.exit(1);
+    else {
+        try {
+            adapter = await resolver.resolve({ providerId, modelId, config, paths });
+        }
+        catch (err) {
+            display.printError(`Could not resolve provider '${providerId}' / model '${modelId}': ${err.message}`, 'Run `aiden model` to pick a valid provider, or `aiden doctor`.');
+            process.exit(1);
+        }
     }
     // Phase 16b.1: wrap chat_completions providers in a FallbackAdapter so
     // 429s on Groq slot 1 transparently retry Groq slot 2/3 and Together.
     // Only activates when there's at least one *additional* slot configured
     // beyond the primary — otherwise the wrapper would just rethrow.
+    // Phase 30.2.1: skip in explore mode — wrapping a NullAdapter in
+    // FallbackAdapter would just defer the friendly error one layer.
     let fallbackAdapter = null;
-    if (adapter.apiMode === 'chat_completions' &&
+    if (!exploreMode &&
+        adapter.apiMode === 'chat_completions' &&
         (providerId === 'groq' || providerId === 'together')) {
         const slots = buildAgentFallbackSlots(adapter, providerId, modelId);
         const reachable = slots.filter((s) => s.keyPresent);
@@ -820,6 +899,7 @@ async function buildAgentRuntime(cliOpts, opts) {
         fallbackAdapter,
         personalityManager,
         pluginLoader,
+        exploreMode,
     };
 }
 async function runInteractiveChat(cliOpts, opts) {
@@ -846,6 +926,9 @@ async function runInteractiveChat(cliOpts, opts) {
         paths: runtime.paths,
         personalityManager: runtime.personalityManager,
         pluginLoader: runtime.pluginLoader,
+        // Phase 30.2.1 — boot card renders "model not configured" and
+        // chat attempts get the friendly NotConfiguredError message.
+        unconfigured: runtime.exploreMode,
     };
     if (cliOpts.tui) {
         await (0, aidenTUI_1.runTuiMode)({

package/dist/cli/v4/chatSession.js

@@ -212,6 +212,18 @@ class ChatSession {
     }
     // ── Inner: a single agent turn ─────────────────────────────────────
     async runAgentTurn(userInput) {
+        // Phase 30.2.1 — explore mode: short-circuit BEFORE building the
+        // turn-status spinner / agent call. The wizard skipped, so there's
+        // no real provider to talk to. Print a friendly redirect to /setup
+        // (or the env-var alternative) and return — REPL stays alive, user
+        // can run slash commands or hit /quit.
+        if (this.opts.unconfigured) {
+            void userInput; // silence unused-arg warning when this branch fires
+            this.opts.display.write('\n');
+            this.opts.display.printError('No AI provider configured yet.', 'Run /setup to configure a provider, or set an API key environment variable (e.g. GROQ_API_KEY).');
+            this.opts.display.write('\n');
+            return;
+        }
         // Phase 22 Task 4: status bar reflects the live phase. Set on
         // entry, cleared in both success and error paths below.
         this.setStatusState({ kind: 'generating', sinceMs: Date.now() });
@@ -353,11 +365,15 @@ class ChatSession {
             skillsLoaded = 0;
         }
         // PIECE 1 — status pills row.
+        // Phase 30.2.1: in explore mode the model pill renders "not
+        // configured" instead of the DEFAULT_CONFIG fallback, so a fresh
+        // user who skipped the wizard isn't misled by a stale model name.
         display.write(display.statusPillsRow({
             coreOnline: true,
             mode: 'auto',
             model: this.currentModelId,
             memoryActive: true,
+            providerOk: !this.opts.unconfigured,
         }) + '\n');
         display.write(`  ${display.rule()}\n`);
         display.write('\n');

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.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.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");
@@ -63,6 +63,8 @@ const doctor_1 = require("./doctor");
 Object.defineProperty(exports, "doctor", { enumerable: true, get: function () { return doctor_1.doctor; } });
 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; } });
 /** All built-in system commands, in canonical order. */
 exports.allCommands = [
     help_1.help,
@@ -85,6 +87,7 @@ exports.allCommands = [
     license_1.license,
     doctor_1.doctor,
     cron_1.cron,
+    setup_1.setup,
     reloadMcp_1.reloadMcp,
     reasoning_1.reasoning,
     verbose_1.verbose,

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setup = void 0;
+const setupWizard_1 = require("../setupWizard");
+exports.setup = {
+    name: 'setup',
+    description: 'Re-run the setup wizard (configure provider + API key).',
+    category: 'system',
+    icon: '⚙',
+    handler: async (ctx) => {
+        if (!ctx.paths) {
+            ctx.display.printError('Cannot run wizard from this context — no paths available.', 'This is a wiring bug; please report.');
+            return;
+        }
+        const result = await (0, setupWizard_1.runSetupWizard)({
+            paths: ctx.paths,
+            display: ctx.display,
+            force: true,
+        });
+        if (result.status === 'configured' && result.ran) {
+            ctx.display.write('\nProvider configured. ' +
+                'Restart Aiden (`/quit` then re-run `aiden`) to pick up the new provider.\n\n');
+        }
+        else if (result.status === 'skipped') {
+            ctx.display.write('\nStill in explore mode. Run /setup again whenever you\'re ready.\n\n');
+        }
+        else if (result.status === 'exited') {
+            // Wizard explicitly chose to exit — but we're inside a REPL,
+            // so just report and stay in the session.
+            ctx.display.dim('Wizard exited; continuing existing session.');
+        }
+        return;
+    },
+};

package/dist/cli/v4/display.js

@@ -305,11 +305,13 @@ class Display {
         const lab = (s) => sk.applyColors(s, 'muted');
         const val = (s) => sk.applyColors(s, 'agent');
         const pill = (on, label, value) => `${dot(on)} ${lab(label)} ${val(value)}`;
+        const providerOk = args.providerOk !== false;
+        const modelValue = providerOk ? args.model : 'not configured';
         return ('  ' +
             [
                 pill(args.coreOnline, 'core', args.coreOnline ? 'online' : 'starting'),
                 pill(true, 'mode', args.mode),
-                pill(true, 'model', args.model),
+                pill(providerOk, 'model', modelValue),
                 pill(args.memoryActive, 'memory', args.memoryActive ? 'active' : 'off'),
             ].join('    '));
     }