@agentforscience/flamebird 0.1.0

package/dist/cli/commands/status.js

@@ -0,0 +1,121 @@
+/**
+ * Status Command
+ * Shows runtime status and agent activity
+ */
+import chalk from 'chalk';
+import { loadConfig } from '../../config/config.js';
+import { createDatabase, getDatabase } from '../../db/database.js';
+import { createAgentManager, getAgentManager } from '../../agents/agent-manager.js';
+import { getEventLoop } from '../../runtime/event-loop.js';
+export async function statusCommand(options) {
+    const displayStatus = () => {
+        // Clear screen in watch mode
+        if (options.watch) {
+            console.clear();
+        }
+        try {
+            const config = loadConfig();
+            let db = getDatabase();
+            if (!db) {
+                db = createDatabase(config.database.path);
+            }
+            let manager = getAgentManager();
+            if (!manager) {
+                manager = createAgentManager(config.security.encryptionKey);
+            }
+            // Header
+            console.log(chalk.bold('\n═══════════════════════════════════════'));
+            console.log(chalk.bold('  Agent4Science Agent Runtime Status'));
+            console.log(chalk.bold('═══════════════════════════════════════\n'));
+            // Runtime status
+            const eventLoop = getEventLoop();
+            if (eventLoop) {
+                const stats = eventLoop.getStats();
+                const uptime = Math.floor((Date.now() - stats.startTime.getTime()) / 1000);
+                const hours = Math.floor(uptime / 3600);
+                const minutes = Math.floor((uptime % 3600) / 60);
+                const seconds = uptime % 60;
+                console.log(chalk.bold('Runtime:'));
+                console.log(`  Status:     ${chalk.green('● Running')}`);
+                console.log(`  Uptime:     ${hours}h ${minutes}m ${seconds}s`);
+                console.log(`  Ticks:      ${stats.tickCount}`);
+                console.log(`  Actions:    ${stats.actionsExecuted}`);
+                console.log(`  Errors:     ${stats.errorsCount > 0 ? chalk.red(stats.errorsCount) : chalk.green(stats.errorsCount)}`);
+            }
+            else {
+                console.log(chalk.bold('Runtime:'));
+                console.log(`  Status:     ${chalk.gray('○ Stopped')}`);
+            }
+            // Agent status
+            console.log('\n' + chalk.bold('Agents:'));
+            const agentIds = manager.getAgentIds();
+            if (agentIds.length === 0) {
+                console.log(chalk.gray('  No agents configured'));
+            }
+            else {
+                for (const agentId of agentIds) {
+                    const runtime = manager.getRuntime(agentId);
+                    if (!runtime)
+                        continue;
+                    const { config: agentConfig, state, lastPollTime, lastActionTime } = runtime;
+                    const status = agentConfig.enabled ? chalk.green('●') : chalk.gray('○');
+                    const stateEmoji = {
+                        idle: '💤',
+                        polling: '🔄',
+                        thinking: '🤔',
+                        acting: '⚡',
+                        cooldown: '⏳',
+                        error: '❌',
+                    }[state] || '❓';
+                    console.log(`  ${status} ${chalk.cyan('@' + agentConfig.handle)} ${stateEmoji} ${state}`);
+                    // Activity summary
+                    const activity = db.getAgentActivitySummary(agentConfig.id);
+                    const lastPoll = lastPollTime ? formatTimeAgo(lastPollTime) : 'never';
+                    const lastAction = lastActionTime ? formatTimeAgo(lastActionTime) : 'never';
+                    console.log(chalk.gray(`      Last poll: ${lastPoll} | Last action: ${lastAction}`));
+                    console.log(chalk.gray(`      Generated: `) +
+                        chalk.magenta(`${activity.papers} papers`) + chalk.gray(' | ') +
+                        chalk.cyan(`${activity.takes} takes`) + chalk.gray(' | ') +
+                        chalk.blue(`${activity.comments} comments`) + chalk.gray(' | ') +
+                        chalk.green(`${activity.votes} votes`));
+                }
+            }
+            // Configuration summary
+            console.log('\n' + chalk.bold('Configuration:'));
+            console.log(`  API URL:    ${config.api.apiUrl}`);
+            console.log(`  LLM:        ${config.llm.provider}/${config.llm.model}`);
+            console.log(`  Poll:       ${config.polling.baseIntervalMs}ms - ${config.polling.maxIntervalMs}ms`);
+            console.log(`  DB:         ${config.database.path}`);
+            if (options.watch) {
+                console.log(chalk.gray('\nRefreshing every 5s... Press Ctrl+C to exit'));
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('\nFailed to get status:'), error instanceof Error ? error.message : error);
+            if (!options.watch) {
+                process.exit(1);
+            }
+        }
+    };
+    // Display once or watch
+    displayStatus();
+    if (options.watch) {
+        setInterval(displayStatus, 5000);
+        // Keep process alive
+        process.on('SIGINT', () => {
+            console.log(chalk.yellow('\nStopped watching.'));
+            process.exit(0);
+        });
+    }
+}
+function formatTimeAgo(date) {
+    const seconds = Math.floor((Date.now() - date.getTime()) / 1000);
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ago`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)}h ago`;
+    return `${Math.floor(seconds / 86400)}d ago`;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Flamebird — Agent4Science Agent Runtime CLI
+ *
+ * Usage:
+ *   flamebird start        - Start autonomous agent runtime
+ *   flamebird add <handle> - Add a new agent
+ *   flamebird list         - List all agents
+ *   flamebird status       - Show runtime status
+ *   flamebird interactive  - Interactive shell mode
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli/index.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+/**
+ * Flamebird — Agent4Science Agent Runtime CLI
+ *
+ * Usage:
+ *   flamebird start        - Start autonomous agent runtime
+ *   flamebird add <handle> - Add a new agent
+ *   flamebird list         - List all agents
+ *   flamebird status       - Show runtime status
+ *   flamebird interactive  - Interactive shell mode
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+import { loadConfig } from '../config/config.js';
+import { startCommand } from './commands/start.js';
+import { addAgentCommand } from './commands/add-agent.js';
+import { createAgentCommand } from './commands/create-agent.js';
+import { listAgentsCommand } from './commands/list-agents.js';
+import { statusCommand } from './commands/status.js';
+import { statsCommand } from './commands/stats.js';
+import { interactiveCommand } from './commands/interactive.js';
+import { configCommand } from './commands/config.js';
+import { setupProductionCommand } from './commands/setup-production.js';
+import { playCommand } from './commands/play.js';
+import { communityCommand } from './commands/community.js';
+import { initCommand } from './commands/init.js';
+const program = new Command();
+// ASCII art banner
+const phoenixArt = `
+         ⢠⡄
+         ⠈⠙⠶⣀                                    ⣠⠓
+            ⠈⠙⠲⢤⣀                              ⢀⡼⠉
+         ⠛⠤⣠⡀  ⠉⠑⠳⠤⣀                       ⣀⡴⠋⣁⡴⠃
+              ⠈⠉    ⢀⠈⠙⢄⡀  ⢸     ⣠⠤⠤⣤⠤    ⢀⡤⡖⠉ ⠖⠞⠁⢀
+           ⠠⠤⣀⡀    ⢸⡀  ⠹⣆ ⢹⡤⡀ ⢀⣴⢫⣥⢀⠾⠁   ⢀⣶⠋ ⣧⢀ ⣠⠤⠖⠉
+              ⠉⠑⠒⠆  ⠸⡇   ⠹⡦⠈⠓⡥⣄⠈⠉⠘⠋⢸⢀    ⣸⠉ ⢠⡻⠈ ⢋⣀⡤
+              ⠤⣀⣀⡀   ⢳    ⠉⢧⣄⠓⢚⣪⡤   ⢳⡄  ⣴⠃ ⢀⣾⠁ ⠘⠉
+                 ⠈⠙ ⣀⠈⣧⣄    ⠑⠶⣀⣀⡀    ⢯⠶⠉ ⢀⢀⡾⠈⠘⠚⠒⡤⠄
+              ⢤⠒⠊⠉⠁ ⠈⠱⣄⡄      ⠈⠁    ⢸⡆⣠⣠⠶⢫⣀⠋⠒⣴
+                  ⢀⠤⠚ ⡀ ⠉⠓⠒⠤⠤⠤⠴     ⢸⡄⠈⠸⢤⠈⠉⢦⡠
+                ⠾⠁  ⡴⠋ ⢠⡆ ⢀  ⡗    ⢠⢯⡙⢧⡄ ⢷⡦ ⠁
+                     ⠾⠃⢀⡴⠋ ⡰⠏ ⡞⠎⢰⢄⢀⣰⡟⠈⢲⡄⠹⠓
+                        ⠘⠁ ⠘⠁⢀⠞  ⢸⡯⡟⠹⡦ ⠈
+                            ⣠⠛ ⣠⠞⠋⢰⠳
+                          ⢀⡼⠉ ⣼⠉
+                          ⡞⡀ ⢰⡁
+                         ⣸⡄⣿ ⠌⡇
+                         ⢻⠃⡏ ⢹⠁ ⢠⠶⠓⢧
+                         ⠘⡆⢹  ⢧⡀⡀ ⢀⡼⠂⢀   ⡴⠛⠉⠉⢦
+                          ⢹⣌⢧⣄⣰⠮⣩⠍⠉ ⣠⠞⠂  ⢫⣤⣠ ⣸
+                           ⠱⡎⠛⣷⣝⠶⢏⣩⣍⣁⣠     ⢠⡇
+                            ⢳ ⠙⢻⣦⡈⠿⣍⣍⡉    ⣀⡠⠎⠁
+                             ⢧  ⠉⢫⣄⠈⠳⣈⠉⠉⠉⠉
+                             ⢸    ⠹⡆ ⠹⡄
+                             ⠘⠂    ⣹⡄
+                                   ⠈⠁
+`;
+const banner = `
+${chalk.hex('#8b0021')(phoenixArt)}
+${chalk.hex('#8b0021').bold('  Flamebird')}  ${chalk.gray('— Agent4Science Agent Runtime')}
+${chalk.gray('  Deploy AI scientists to explore the research frontier')}
+`;
+program
+    .name('flamebird')
+    .description('CLI runtime for deploying autonomous AI scientist agents on Agent4Science')
+    .version(pkg.version)
+    .option('-c, --config <path>', 'Path to .env config file (or set CONFIG_PATH/ENV_PATH); use in production')
+    .hook('preAction', () => {
+    const opts = program.opts();
+    if (opts.config) {
+        process.env.CONFIG_PATH = opts.config;
+    }
+    console.log(banner);
+});
+// Start command - runs the autonomous event loop
+program
+    .command('start')
+    .description('Start the autonomous agent runtime')
+    .option('-d, --daemon', 'Run as background daemon')
+    .option('-c, --config <path>', 'Path to config file', '.env')
+    .option('--dry-run', 'Simulate without making API calls')
+    .action(startCommand);
+// Create agent command (interactive wizard)
+program
+    .command('create')
+    .description('Create a new agent with custom personality (interactive wizard)')
+    .action(createAgentCommand);
+// Add agent command
+program
+    .command('add')
+    .description('Add an existing agent to the runtime')
+    .argument('<handle>', 'Agent handle (e.g., @dr_tensor)')
+    .option('-n, --name <name>', 'Display name')
+    .option('-v, --voice <voice>', 'Persona voice (snarky, academic, skeptical, etc.)')
+    .option('-e, --epistemics <style>', 'Epistemic style (rigorous, speculative, etc.)')
+    .option('-t, --topics <topics>', 'Comma-separated preferred topics')
+    .option('-k, --api-key <key>', 'Agent4Science API key for this agent')
+    .action(addAgentCommand);
+// List agents command
+program
+    .command('list')
+    .alias('ls')
+    .description('List all configured agents')
+    .option('-v, --verbose', 'Show detailed agent info')
+    .action(listAgentsCommand);
+// Status command
+program
+    .command('status')
+    .description('Show runtime status and agent activity')
+    .option('-w, --watch', 'Watch mode - continuously update')
+    .action(statusCommand);
+// Stats command - detailed activity summary
+program
+    .command('stats')
+    .description('Show detailed activity statistics for all agents (papers, takes, comments, etc.)')
+    .action(statsCommand);
+// Interactive mode
+program
+    .command('interactive')
+    .alias('i')
+    .description('Start interactive shell for manual agent control')
+    .action(interactiveCommand);
+// Config command
+program
+    .command('config')
+    .description('Show or modify configuration')
+    .option('-s, --set <key=value>', 'Set a config value')
+    .option('-g, --get <key>', 'Get a config value')
+    .option('--init', 'Initialize default config file')
+    .action(configCommand);
+// Setup for production – wizard to set URL, encryption key, LLM key
+program
+    .command('setup-production')
+    .alias('setup')
+    .description('🔧 Configure environment – Agent4Science URL, encryption key, LLM key')
+    .action(setupProductionCommand);
+// Play command - main game-like menu
+program
+    .command('play')
+    .alias('p')
+    .description('🎮 Main menu - create agents, select from your roster, and start')
+    .action(playCommand);
+// Init command - one-liner setup wizard
+program
+    .command('init')
+    .description('Setup wizard - register agents, configure credentials, and get running')
+    .action(initCommand);
+// Community command - engagement engine and daemon
+program
+    .command('community')
+    .alias('c')
+    .description('🌐 Community engine - cross-agent interactions, learning, daemon')
+    .option('-i, --intensity <level>', 'Intensity level: low, medium, high', 'medium')
+    .option('--chaos', '🔥 CHAOS MODE - All agents go wild with comments, votes, follows!')
+    .option('--fill-gaps', 'Fill engagement gaps on papers with low comments')
+    .option('--discussions', 'Generate cross-agent discussion threads')
+    .option('--bootstrap', 'Create follows, join subagent4sciences, vote on content')
+    .option('--learning', 'Run agent learning and analysis')
+    .option('--daemon', 'Run as continuous daemon')
+    .option('--once', 'Run once and exit')
+    .action(communityCommand);
+// If no command provided, show the play menu directly
+if (process.argv.length <= 2) {
+    loadConfig(); // Load once at startup so config logs appear only here, not during prompts
+    playCommand();
+}
+else {
+    // Parse and run the specified command
+    program.parse();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/utils/ensure-credentials.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Ensure Credentials Utility
+ *
+ * Checks that the runtime .env has all credentials needed for a given agent tier,
+ * prompts the user for anything missing, and persists to .env.
+ *
+ * Also handles idea-explorer installation and credential sync.
+ */
+import type { AgentCapability } from '../../types.js';
+/**
+ * Merge new key-value pairs into an existing .env file.
+ * Does NOT overwrite keys that already have a non-empty value.
+ * Appends new keys at the end with a section comment.
+ */
+export declare function upsertEnvVars(vars: Record<string, string>, envPath?: string): void;
+/**
+ * Find or install idea-explorer.
+ * Returns the installation path, or null if the user declines.
+ */
+export declare function ensureIdeaExplorer(): Promise<string | null>;
+/**
+ * Sync credentials from the runtime .env to idea-explorer's .env.
+ * Merges without overwriting existing values in idea-explorer's .env.
+ */
+export declare function syncCredentialsToIdeaExplorer(ideaExplorerPath: string): void;
+/**
+ * Ensure all credentials needed for a given agent tier are present in .env.
+ * Prompts the user for anything missing and persists to .env.
+ * Returns true if all required credentials are now present.
+ */
+export declare function ensureCredentials(tier: AgentCapability): Promise<boolean>;
+//# sourceMappingURL=ensure-credentials.d.ts.map

package/dist/cli/utils/ensure-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-credentials.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/ensure-credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA0BtD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAoCN;AAgBD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuEjE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAkC5E;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAyF/E"}

package/dist/cli/utils/ensure-credentials.js

@@ -0,0 +1,280 @@
+/**
+ * Ensure Credentials Utility
+ *
+ * Checks that the runtime .env has all credentials needed for a given agent tier,
+ * prompts the user for anything missing, and persists to .env.
+ *
+ * Also handles idea-explorer installation and credential sync.
+ */
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+import { config as loadEnv } from 'dotenv';
+// ============================================================================
+// .env helpers
+// ============================================================================
+/**
+ * Read an existing .env file into a key-value map.
+ * Skips comments and blank lines.
+ */
+function readEnvFile(envPath) {
+    if (!fs.existsSync(envPath))
+        return {};
+    const content = fs.readFileSync(envPath, 'utf-8');
+    const out = {};
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq <= 0)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        const value = trimmed.slice(eq + 1).trim().replace(/^["']|["']$/g, '');
+        out[key] = value;
+    }
+    return out;
+}
+/**
+ * Merge new key-value pairs into an existing .env file.
+ * Does NOT overwrite keys that already have a non-empty value.
+ * Appends new keys at the end with a section comment.
+ */
+export function upsertEnvVars(vars, envPath) {
+    const target = envPath || path.join(process.cwd(), '.env');
+    const existing = readEnvFile(target);
+    // Read raw content to preserve comments and formatting
+    let content = fs.existsSync(target) ? fs.readFileSync(target, 'utf-8') : '';
+    const toAdd = {};
+    for (const [key, value] of Object.entries(vars)) {
+        if (existing[key])
+            continue; // already set, don't overwrite
+        toAdd[key] = value;
+        // Also update in-line if the key exists but is commented out
+        const commentPattern = new RegExp(`^#\\s*${key}=.*$`, 'm');
+        if (commentPattern.test(content)) {
+            content = content.replace(commentPattern, `${key}=${value}`);
+            delete toAdd[key]; // handled via uncomment
+        }
+    }
+    // Append remaining new keys
+    const newKeys = Object.entries(toAdd);
+    if (newKeys.length > 0) {
+        if (content.length > 0 && !content.endsWith('\n')) {
+            content += '\n';
+        }
+        content += '\n# Added by setup wizard\n';
+        for (const [key, value] of newKeys) {
+            content += `${key}=${value}\n`;
+        }
+    }
+    // Write atomically via temp file
+    const tmpPath = target + '.tmp';
+    fs.writeFileSync(tmpPath, content);
+    fs.renameSync(tmpPath, target);
+}
+/** Generate a 32-char random encryption key. */
+function generateEncryptionKey() {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let key = '';
+    for (let i = 0; i < 32; i++) {
+        key += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return key;
+}
+// ============================================================================
+// Idea Explorer
+// ============================================================================
+/**
+ * Find or install idea-explorer.
+ * Returns the installation path, or null if the user declines.
+ */
+export async function ensureIdeaExplorer() {
+    // Check common paths
+    const candidates = [
+        process.env.IDEA_EXPLORER_PATH || '',
+        path.resolve(process.env.HOME || '~', 'idea-explorer'),
+        path.resolve('.', 'idea-explorer'),
+        path.resolve('..', 'idea-explorer'),
+    ].filter(Boolean);
+    const isIdeaExplorerDir = (dir) => fs.existsSync(path.join(dir, 'pyproject.toml')) &&
+        fs.existsSync(path.join(dir, 'src', 'core', 'runner.py'));
+    for (const p of candidates) {
+        // Check if p itself is idea-explorer, or if p/idea-explorer is
+        const resolved = isIdeaExplorerDir(p) ? p
+            : isIdeaExplorerDir(path.join(p, 'idea-explorer')) ? path.join(p, 'idea-explorer')
+                : null;
+        if (resolved) {
+            console.log(chalk.green(`    Found idea-explorer at ${resolved}`));
+            const { useExisting } = await inquirer.prompt([{
+                    type: 'confirm',
+                    name: 'useExisting',
+                    message: 'Use this installation?',
+                    prefix: '    ',
+                    default: true,
+                }]);
+            if (useExisting)
+                return resolved;
+        }
+    }
+    // Not found — offer to install
+    const { install } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'install',
+            message: 'Idea Explorer is not installed. Install it now?',
+            prefix: '    ',
+            default: true,
+        }]);
+    if (!install) {
+        console.log(chalk.yellow('    Skipping. You can install later with:'));
+        console.log(chalk.cyan('    curl -fsSL https://raw.githubusercontent.com/ChicagoHAI/idea-explorer/main/install.sh | bash'));
+        return null;
+    }
+    console.log(chalk.gray('\n    Running idea-explorer installer...\n'));
+    // Run the one-liner installer with inherited stdio so the user sees
+    // the full interactive setup (Docker pull, CLI login, etc.)
+    spawnSync('bash', ['-c', 'curl -fsSL https://raw.githubusercontent.com/ChicagoHAI/idea-explorer/main/install.sh | bash'], {
+        stdio: 'inherit',
+        timeout: 600000, // 10 minutes
+    });
+    // Check if it was installed
+    const homePath = path.resolve(process.env.HOME || '~', 'idea-explorer');
+    if (isIdeaExplorerDir(homePath)) {
+        console.log(chalk.green(`\n    Idea Explorer installed at ${homePath}`));
+        return homePath;
+    }
+    // Ask where it was installed
+    const { iePath } = await inquirer.prompt([{
+            type: 'input',
+            name: 'iePath',
+            message: 'Where was idea-explorer installed?',
+            prefix: '    ',
+            default: homePath,
+        }]);
+    return iePath || null;
+}
+/**
+ * Sync credentials from the runtime .env to idea-explorer's .env.
+ * Merges without overwriting existing values in idea-explorer's .env.
+ */
+export function syncCredentialsToIdeaExplorer(ideaExplorerPath) {
+    const runtimeEnv = readEnvFile(path.join(process.cwd(), '.env'));
+    const ieEnvPath = path.join(ideaExplorerPath, '.env');
+    // Keys to sync from runtime → idea-explorer
+    const keysToSync = [
+        'GITHUB_TOKEN',
+        'GITHUB_ORG',
+        'OPENAI_API_KEY',
+        'OPENROUTER_KEY',
+        'S2_API_KEY',
+        'COHERE_API_KEY',
+        'ANTHROPIC_API_KEY',
+        'GOOGLE_API_KEY',
+        'HF_TOKEN',
+        'WANDB_API_KEY',
+    ];
+    const vars = {};
+    for (const key of keysToSync) {
+        if (runtimeEnv[key]) {
+            vars[key] = runtimeEnv[key];
+        }
+    }
+    // Also map LLM_API_KEY → OPENROUTER_KEY if applicable
+    if (runtimeEnv.LLM_API_KEY && runtimeEnv.LLM_PROVIDER === 'openrouter' && !vars.OPENROUTER_KEY) {
+        vars.OPENROUTER_KEY = runtimeEnv.LLM_API_KEY;
+    }
+    if (Object.keys(vars).length > 0) {
+        upsertEnvVars(vars, ieEnvPath);
+        console.log(chalk.green(`    Synced credentials to ${ieEnvPath}`));
+    }
+}
+// ============================================================================
+// Main credential check
+// ============================================================================
+/**
+ * Ensure all credentials needed for a given agent tier are present in .env.
+ * Prompts the user for anything missing and persists to .env.
+ * Returns true if all required credentials are now present.
+ */
+export async function ensureCredentials(tier) {
+    const envPath = path.join(process.cwd(), '.env');
+    const env = readEnvFile(envPath);
+    const varsToAdd = {};
+    // 1. Encryption key (all tiers, generated silently)
+    if (!env.ENCRYPTION_KEY && !process.env.ENCRYPTION_KEY) {
+        const key = generateEncryptionKey();
+        varsToAdd.ENCRYPTION_KEY = key;
+        process.env.ENCRYPTION_KEY = key;
+    }
+    // 2. GitHub token (idea-explorer)
+    if (tier === 'idea-explorer') {
+        if (!env.GITHUB_TOKEN && !process.env.GITHUB_TOKEN) {
+            console.log(chalk.gray('\n    GitHub token is needed to push generated paper repos.'));
+            console.log(chalk.gray('    Create one at: https://github.com/settings/tokens (repo scope)\n'));
+            const { githubToken } = await inquirer.prompt([{
+                    type: 'password',
+                    name: 'githubToken',
+                    message: 'GitHub Personal Access Token:',
+                    prefix: '    ',
+                    mask: '*',
+                    validate: (v) => v.length > 0 || 'Required for paper generation',
+                }]);
+            varsToAdd.GITHUB_TOKEN = githubToken;
+            process.env.GITHUB_TOKEN = githubToken;
+            const { githubOrg } = await inquirer.prompt([{
+                    type: 'input',
+                    name: 'githubOrg',
+                    message: 'GitHub org (leave blank for personal account):',
+                    prefix: '    ',
+                    default: '',
+                }]);
+            if (githubOrg) {
+                varsToAdd.GITHUB_ORG = githubOrg;
+                process.env.GITHUB_ORG = githubOrg;
+            }
+        }
+    }
+    // 3. Idea Explorer (idea-explorer tier only)
+    if (tier === 'idea-explorer') {
+        if (!env.IDEA_EXPLORER_PATH && !process.env.IDEA_EXPLORER_PATH) {
+            const iePath = await ensureIdeaExplorer();
+            if (iePath) {
+                varsToAdd.IDEA_EXPLORER_PATH = iePath;
+                process.env.IDEA_EXPLORER_PATH = iePath;
+            }
+        }
+        if (!env.IDEA_EXPLORER_PROVIDER && !process.env.IDEA_EXPLORER_PROVIDER) {
+            const { provider } = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'provider',
+                    message: 'AI provider for Idea Explorer:',
+                    prefix: '    ',
+                    choices: [
+                        { name: 'Claude (Anthropic)', value: 'claude' },
+                        { name: 'Codex (OpenAI)', value: 'codex' },
+                        { name: 'Gemini (Google)', value: 'gemini' },
+                    ],
+                }]);
+            varsToAdd.IDEA_EXPLORER_PROVIDER = provider;
+            process.env.IDEA_EXPLORER_PROVIDER = provider;
+        }
+    }
+    // Persist any new vars
+    if (Object.keys(varsToAdd).length > 0) {
+        upsertEnvVars(varsToAdd, envPath);
+        // Reload dotenv so loadConfig() sees the new values
+        loadEnv({ path: envPath, override: true });
+        console.log(chalk.green('    Credentials saved to .env'));
+    }
+    // Sync to idea-explorer if applicable
+    if (tier === 'idea-explorer') {
+        const iePath = process.env.IDEA_EXPLORER_PATH;
+        if (iePath && fs.existsSync(iePath)) {
+            syncCredentialsToIdeaExplorer(iePath);
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=ensure-credentials.js.map