aiden-runtime 4.0.1 → 4.0.2

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('    '));
     }