@hive-org/cli 0.0.1

package/dist/create/CreateApp.js

@@ -0,0 +1,102 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback } from 'react';
+import { Box, Text, useApp } from 'ink';
+import { Header } from '../components/Header.js';
+import { AsciiTicker } from '../components/AsciiTicker.js';
+import { ApiKeyStep } from './steps/ApiKeyStep.js';
+import { NameStep } from './steps/NameStep.js';
+import { IdentityStep } from './steps/IdentityStep.js';
+import { AvatarStep } from './steps/AvatarStep.js';
+import { SoulStep } from './steps/SoulStep.js';
+import { StrategyStep } from './steps/StrategyStep.js';
+import { ScaffoldStep } from './steps/ScaffoldStep.js';
+import { DoneStep } from './steps/DoneStep.js';
+import { colors, symbols } from '../theme.js';
+import { getProvider } from '../ai-providers.js';
+function ensureAvatarUrl(content, avatarUrl) {
+    const lines = content.split('\n');
+    const avatarIdx = lines.findIndex((l) => /^## Avatar/.test(l));
+    if (avatarIdx === -1) {
+        return content;
+    }
+    // Find the next section header after ## Avatar
+    let nextSectionIdx = lines.length;
+    for (let i = avatarIdx + 1; i < lines.length; i++) {
+        if (/^##?\s/.test(lines[i])) {
+            nextSectionIdx = i;
+            break;
+        }
+    }
+    // Replace the content between ## Avatar and next section with the raw URL
+    const before = lines.slice(0, avatarIdx + 1);
+    const after = lines.slice(nextSectionIdx);
+    const result = [...before, '', avatarUrl, '', ...after];
+    return result.join('\n');
+}
+const STEP_ORDER = ['name', 'identity', 'avatar', 'api-key', 'soul', 'strategy', 'scaffold', 'done'];
+const STEP_LABELS = {
+    'api-key': 'API Key',
+    'name': 'Agent Name',
+    'identity': 'Identity',
+    'avatar': 'Avatar',
+    'soul': 'Personality',
+    'strategy': 'Strategy',
+    'scaffold': 'Scaffold',
+    'done': 'Done',
+};
+export function CreateApp({ initialName }) {
+    const { exit } = useApp();
+    const [step, setStep] = useState(initialName ? 'identity' : 'name');
+    const [providerId, setProviderId] = useState(null);
+    const [apiKey, setApiKey] = useState('');
+    const [agentName, setAgentName] = useState(initialName ?? '');
+    const [bio, setBio] = useState('');
+    const [personality, setPersonality] = useState('');
+    const [tone, setTone] = useState('');
+    const [voiceStyle, setVoiceStyle] = useState('');
+    const [avatarUrl, setAvatarUrl] = useState('');
+    const [soulContent, setSoulContent] = useState('');
+    const [strategyContent, setStrategyContent] = useState('');
+    const [resolvedProjectDir, setResolvedProjectDir] = useState('');
+    const [error, setError] = useState('');
+    const stepNumber = STEP_ORDER.indexOf(step) + 1;
+    const provider = providerId ? getProvider(providerId) : null;
+    const handleApiKey = useCallback((result) => {
+        setProviderId(result.providerId);
+        setApiKey(result.apiKey);
+        setStep('soul');
+    }, []);
+    const handleName = useCallback((name) => {
+        setAgentName(name);
+        setStep('identity');
+    }, []);
+    const handleIdentity = useCallback((result) => {
+        setPersonality(result.personality);
+        setTone(result.tone);
+        setVoiceStyle(result.voiceStyle);
+        setBio(result.bio);
+        setStep('avatar');
+    }, []);
+    const handleAvatar = useCallback((value) => {
+        setAvatarUrl(value);
+        setStep('api-key');
+    }, []);
+    const handleSoul = useCallback((content) => {
+        const patched = ensureAvatarUrl(content, avatarUrl);
+        setSoulContent(patched);
+        setStep('strategy');
+    }, [avatarUrl]);
+    const handleStrategy = useCallback((content) => {
+        setStrategyContent(content);
+        setStep('scaffold');
+    }, []);
+    const handleScaffoldComplete = useCallback((projectDir) => {
+        setResolvedProjectDir(projectDir);
+        setStep('done');
+    }, []);
+    const handleScaffoldError = useCallback((message) => {
+        setError(message);
+        exit();
+    }, [exit]);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Header, { step: stepNumber, totalSteps: 8, label: STEP_LABELS[step] }), step !== 'done' && (_jsx(Box, { marginBottom: 1, children: _jsx(AsciiTicker, { step: stepNumber }) })), step === 'api-key' && (_jsx(ApiKeyStep, { onComplete: handleApiKey })), step === 'name' && (_jsx(NameStep, { onComplete: handleName })), step === 'identity' && (_jsx(IdentityStep, { onComplete: handleIdentity })), step === 'avatar' && (_jsx(AvatarStep, { agentName: agentName, onComplete: handleAvatar })), step === 'soul' && providerId && (_jsx(SoulStep, { providerId: providerId, apiKey: apiKey, agentName: agentName, bio: bio, avatarUrl: avatarUrl, personality: personality, tone: tone, voiceStyle: voiceStyle, onComplete: handleSoul })), step === 'strategy' && providerId && (_jsx(StrategyStep, { providerId: providerId, apiKey: apiKey, agentName: agentName, bio: bio, personality: personality, tone: tone, voiceStyle: voiceStyle, onComplete: handleStrategy })), step === 'scaffold' && provider && (_jsx(ScaffoldStep, { projectName: agentName, provider: provider, apiKey: apiKey, soulContent: soulContent, strategyContent: strategyContent, onComplete: handleScaffoldComplete, onError: handleScaffoldError })), step === 'done' && (_jsx(DoneStep, { projectDir: resolvedProjectDir })), error !== '' && (_jsx(Box, { marginTop: 1, marginLeft: 2, children: _jsxs(Text, { color: colors.red, children: [symbols.cross, " ", error] }) }))] }));
+}

package/dist/create/ai-generate.js

@@ -0,0 +1,133 @@
+import { streamText } from 'ai';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { createXai } from '@ai-sdk/xai';
+import { createOpenRouter } from '@openrouter/ai-sdk-provider';
+import { SOUL_PRESETS, STRATEGY_PRESETS, buildSoulMarkdown, buildStrategyMarkdown, } from '../presets.js';
+function buildModel(providerId, apiKey) {
+    switch (providerId) {
+        case 'openai':
+            return createOpenAI({ apiKey })('gpt-4o');
+        case 'anthropic':
+            return createAnthropic({ apiKey })('claude-sonnet-4-5-20250929');
+        case 'google':
+            return createGoogleGenerativeAI({ apiKey })('gemini-2.0-flash');
+        case 'xai':
+            return createXai({ apiKey })('grok-2');
+        case 'openrouter':
+            return createOpenRouter({ apiKey }).chat('anthropic/claude-3.5-sonnet');
+    }
+}
+function buildPresetExamples() {
+    const soulExamples = SOUL_PRESETS.map((p) => buildSoulMarkdown('ExampleAgent', 'example bio text for reference', p, '')).join('\n---\n');
+    const strategyExamples = STRATEGY_PRESETS.map((p) => buildStrategyMarkdown('ExampleAgent', p)).join('\n---\n');
+    return `${soulExamples}\n\n===\n\n${strategyExamples}`;
+}
+const PRESET_EXAMPLES = buildPresetExamples();
+export function streamSoul(providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, feedback) {
+    const feedbackLine = feedback
+        ? `\n\nThe user gave this feedback on the previous draft. Adjust accordingly:\n"${feedback}"`
+        : '';
+    const identityContext = `Personality: ${personality}
+Tone: ${tone}
+Voice style: ${voiceStyle}`;
+    const prompt = `You are a creative writer designing an AI agent's personality profile for a crypto trading bot called "${agentName}".
+
+The agent's bio is: "${bio}"
+${avatarUrl ? `Avatar URL: ${avatarUrl}` : 'No avatar URL provided.'}
+
+Identity traits:
+${identityContext}
+
+Context — Hive is a prediction game for AI agents:
+- Signals appear in cells (e.g. c/ethereum, c/bitcoin) when noteworthy crypto events happen.
+- Agents submit a percentage prediction (predicted price change over 3 hours) and a short reasoning.
+- Threads resolve at T+3h. Correct-direction predictions earn honey (the ranking currency); wrong-direction predictions earn wax.
+- Early predictions are worth dramatically more than late ones (steep time bonus decay).
+- Streaks track consecutive correct-direction predictions. Skipping a thread carries no penalty and does not break streaks.
+- Agents are ranked on a leaderboard by total honey.
+
+Generate a SOUL.md file for this agent. The SOUL.md defines who the agent IS — their personality, voice, quirks, opinions, and how they post. The personality should be aware that the agent operates in this prediction game — their voice should reflect how they approach predictions, risk, and competition. Use the identity traits above to shape the personality, tone, and writing style.
+
+CRITICAL: Output ONLY valid markdown matching this exact structure. No extra commentary.
+
+The first line MUST be: # Agent: ${agentName}
+
+Here are reference examples of well-crafted SOUL.md files:
+---
+${PRESET_EXAMPLES.split('===')[0]}
+---
+
+Use these as style/quality references but create something UNIQUE based on the agent's name, bio, and identity traits.${feedbackLine}`;
+    const model = buildModel(providerId, apiKey);
+    const result = streamText({
+        model,
+        prompt,
+        maxOutputTokens: 1500,
+    });
+    return result.textStream;
+}
+export function streamStrategy(providerId, apiKey, agentName, bio, personality, tone, voiceStyle, feedback) {
+    const feedbackLine = feedback
+        ? `\n\nThe user gave this feedback on the previous draft. Adjust accordingly:\n"${feedback}"`
+        : '';
+    const identityContext = `Personality: ${personality}
+Tone: ${tone}
+Voice style: ${voiceStyle}`;
+    const prompt = `You are designing a prediction strategy profile for a crypto trading bot called "${agentName}".
+
+The agent's bio is: "${bio}"
+
+Identity traits:
+${identityContext}
+
+Context — Hive game mechanics that the strategy should account for:
+- Agents predict the percentage price change of a crypto asset over a 3-hour window.
+- Conviction is a number (e.g. 2.5 for +2.5%, -3.0 for -3.0%, 0 for neutral).
+- Correct-direction predictions earn honey (the primary ranking currency). Wrong-direction predictions earn wax (not a penalty, but doesn't help ranking).
+- Direction matters more than magnitude for earning honey, though closer magnitude predictions earn more.
+- Early predictions earn dramatically more honey due to steep time bonus decay — speed matters.
+- Consecutive correct-direction predictions build a streak (tracked on profile). Skipping does not break streaks.
+- Skipping is a valid strategy — no penalty, no streak break. Knowing when to sit out is a skill.
+- Agents are ranked on a leaderboard by total honey.
+
+Generate a STRATEGY.md file. The STRATEGY.md defines HOW the agent makes predictions — their method, conviction style, sector focus, and decision framework. The strategy should reflect the agent's personality and tone, and should address the game mechanics above (e.g. when to skip, how aggressive to be with timing, how to calibrate conviction magnitude).
+
+CRITICAL: Output ONLY valid markdown matching this exact structure. No extra commentary.
+
+The first line MUST be: # Prediction Strategy: ${agentName}
+
+Required sections with EXACT headers:
+## Philosophy
+## Signal Interpretation
+- Method: (must be one of: technical, fundamental, sentiment, onchain, macro)
+- Primary indicators: (list key indicators)
+## Conviction Style
+- Boldness: (must be one of: conservative, moderate, bold, degen)
+- Directional bias: (must be one of: neutral, bullish, bearish)
+- Participation: (must be one of: selective, moderate, active)
+## Sector Focus
+- Primary: (main sector)
+- Secondary: (secondary sector)
+- Avoid: (sectors to avoid)
+## Decision Framework
+1. (first step)
+2. (second step)
+3. (third step)
+## Participation Criteria
+
+Here are reference examples of well-crafted STRATEGY.md files:
+---
+${PRESET_EXAMPLES.split('===')[1] || ''}
+---
+
+Create something UNIQUE based on the agent's name, bio, and identity traits.${feedbackLine}`;
+    const model = buildModel(providerId, apiKey);
+    const result = streamText({
+        model,
+        prompt,
+        maxOutputTokens: 1200,
+    });
+    return result.textStream;
+}

package/dist/create/generate.js

@@ -0,0 +1,173 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { fileURLToPath } from 'url';
+import { applyAdapterToChatTemplate } from '../ai-providers.js';
+const execAsync = promisify(exec);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export async function scaffoldProject(projectName, provider, apiKey, soulContent, strategyContent, callbacks) {
+    // Validate project name to prevent path traversal / command injection
+    if (!/^[a-zA-Z0-9_-]+$/.test(projectName)) {
+        callbacks.onError('Project name can only contain letters, numbers, dashes, and underscores.');
+        return;
+    }
+    const agentsDir = path.join(os.homedir(), '.hive', 'agents');
+    const projectDir = path.join(agentsDir, projectName);
+    // Ensure resolved path is still inside ~/.hive/agents/
+    const normalizedProjectDir = path.resolve(projectDir);
+    const normalizedAgentsDir = path.resolve(agentsDir);
+    if (!normalizedProjectDir.startsWith(normalizedAgentsDir + path.sep)) {
+        callbacks.onError('Invalid project name: path traversal detected.');
+        return;
+    }
+    if (await fs.pathExists(projectDir)) {
+        callbacks.onError(`Directory ${normalizedProjectDir} already exists. Run "npx @hive-org/cli create" again with a different name.`);
+        return;
+    }
+    // 1. Create directory
+    callbacks.onStep('Creating project directory');
+    await fs.ensureDir(projectDir);
+    // 2. Initialize npm project
+    callbacks.onStep('Initializing project');
+    await execAsync('npm init -y', { cwd: projectDir });
+    // 4. Install hive bootstrap
+    callbacks.onStep('Installing Hive SDK');
+    const templatesDir = path.resolve(__dirname, '../../templates');
+    const hiveTemplatesDir = path.join(templatesDir, 'hive');
+    const hiveDir = path.join(projectDir, 'hive');
+    await fs.ensureDir(hiveDir);
+    await fs.copy(hiveTemplatesDir, hiveDir);
+    // 5. Write SOUL.md and STRATEGY.md
+    callbacks.onStep('Writing personality files');
+    await fs.writeFile(path.join(projectDir, 'SOUL.md'), soulContent, 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'STRATEGY.md'), strategyContent, 'utf-8');
+    const seedMemory = `# Memory
+
+## Key Learnings
+
+(none yet)
+
+## Market Observations
+
+(none yet)
+
+## Session Notes
+
+(none yet)
+`;
+    await fs.writeFile(path.join(projectDir, 'MEMORY.md'), seedMemory, 'utf-8');
+    // 6. Write .env
+    callbacks.onStep('Writing environment file');
+    const envContent = `HIVE_API_URL="https://hive-backend.z3n.dev"
+${provider.envVar}="${apiKey}"
+`;
+    await fs.writeFile(path.join(projectDir, '.env'), envContent, { encoding: 'utf-8', mode: 0o600 });
+    // 7. Copy prompt.ts
+    callbacks.onStep('Creating agent files');
+    const promptPath = path.join(templatesDir, 'prompt.ts');
+    const promptExists = await fs.pathExists(promptPath);
+    if (promptExists) {
+        const promptFileContent = await fs.readFile(promptPath, 'utf-8');
+        await fs.writeFile(path.join(projectDir, 'prompt.ts'), promptFileContent, 'utf-8');
+    }
+    // 8. Copy and adapt index.tsx (Ink TUI agent — no model calls, just UI shell)
+    const tuiTemplatePath = path.join(templatesDir, 'index.tsx');
+    const tuiTemplate = await fs.readFile(tuiTemplatePath, 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'index.tsx'), tuiTemplate, 'utf-8');
+    // Copy and adapt analysis.ts (contains model calls)
+    const analysisTemplate = await fs.readFile(path.join(templatesDir, 'analysis.ts'), 'utf-8');
+    const analysisContent = applyAdapterToChatTemplate(analysisTemplate, provider);
+    await fs.writeFile(path.join(projectDir, 'analysis.ts'), analysisContent, 'utf-8');
+    // Copy process-lifecycle.ts
+    const lifecycleContent = await fs.readFile(path.join(templatesDir, 'process-lifecycle.ts'), 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'process-lifecycle.ts'), lifecycleContent, 'utf-8');
+    // Copy hooks/ directory and adapt useAgent.ts (contains model calls)
+    const hooksTemplatesDir = path.join(templatesDir, 'hooks');
+    const hooksDir = path.join(projectDir, 'hooks');
+    await fs.ensureDir(hooksDir);
+    const useAgentTemplate = await fs.readFile(path.join(hooksTemplatesDir, 'useAgent.ts'), 'utf-8');
+    const useAgentContent = applyAdapterToChatTemplate(useAgentTemplate, provider);
+    await fs.writeFile(path.join(hooksDir, 'useAgent.ts'), useAgentContent, 'utf-8');
+    // Copy theme.ts, types.ts, helpers.ts
+    const themeContent = await fs.readFile(path.join(templatesDir, 'theme.ts'), 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'theme.ts'), themeContent, 'utf-8');
+    const typesContent = await fs.readFile(path.join(templatesDir, 'types.ts'), 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'types.ts'), typesContent, 'utf-8');
+    const helpersContent = await fs.readFile(path.join(templatesDir, 'helpers.ts'), 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'helpers.ts'), helpersContent, 'utf-8');
+    // Copy components/ directory
+    const componentsTemplatesDir = path.join(templatesDir, 'components');
+    const componentsDir = path.join(projectDir, 'components');
+    await fs.ensureDir(componentsDir);
+    await fs.copy(componentsTemplatesDir, componentsDir);
+    // Copy chat-prompt.ts
+    const chatPromptPath = path.join(templatesDir, 'chat-prompt.ts');
+    const chatPromptContent = await fs.readFile(chatPromptPath, 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'chat-prompt.ts'), chatPromptContent, 'utf-8');
+    // Copy memory-prompt.ts
+    const memoryPromptPath = path.join(templatesDir, 'memory-prompt.ts');
+    const memoryPromptContent = await fs.readFile(memoryPromptPath, 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'memory-prompt.ts'), memoryPromptContent, 'utf-8');
+    // Copy edit-section.ts
+    const editSectionPath = path.join(templatesDir, 'edit-section.ts');
+    const editSectionContent = await fs.readFile(editSectionPath, 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'edit-section.ts'), editSectionContent, 'utf-8');
+    // Copy fetch-rules.ts
+    const fetchRulesPath = path.join(templatesDir, 'fetch-rules.ts');
+    const fetchRulesContent = await fs.readFile(fetchRulesPath, 'utf-8');
+    await fs.writeFile(path.join(projectDir, 'fetch-rules.ts'), fetchRulesContent, 'utf-8');
+    // 9. Configure package.json
+    callbacks.onStep('Configuring project');
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    const packageJson = await fs.readJson(packageJsonPath);
+    packageJson.type = 'module';
+    packageJson.scripts = {
+        ...packageJson.scripts,
+        start: 'tsx index.tsx',
+    };
+    packageJson.dependencies = {
+        ...packageJson.dependencies,
+        '@hive-org/sdk': '^0.0.9',
+        dotenv: '^16.0.0',
+        ai: '^6.0.71',
+        chalk: '^5.4.1',
+        zod: '^4.0.0',
+        [provider.package]: '^3.0.0',
+        ink: '^5.1.0',
+        'ink-text-input': '^6.0.0',
+        react: '^18.3.1',
+    };
+    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+    // 10. Write tsconfig.json
+    const tsConfig = {
+        compilerOptions: {
+            target: 'ES2020',
+            module: 'ESNext',
+            moduleResolution: 'bundler',
+            jsx: 'react-jsx',
+            outDir: './dist',
+            rootDir: '.',
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            baseUrl: '.',
+            paths: {
+                '@/*': ['./*'],
+            },
+        },
+    };
+    await fs.writeJson(path.join(projectDir, 'tsconfig.json'), tsConfig, { spaces: 2 });
+    // 11. Install dependencies
+    callbacks.onStep('Installing dependencies');
+    const adapterInstall = `ai ${provider.package}`;
+    try {
+        await execAsync(`npm install --save-dev typescript @types/node @types/react tsx && npm install ${adapterInstall}`, { cwd: projectDir });
+    }
+    catch {
+        callbacks.onError(`Failed to install dependencies. Run manually:\n  cd ${normalizedProjectDir}\n  npm install --save-dev typescript @types/node @types/react tsx && npm install ${adapterInstall}`);
+        return;
+    }
+    callbacks.onDone(normalizedProjectDir);
+}

package/dist/create/steps/ApiKeyStep.js

@@ -0,0 +1,97 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import { SelectPrompt } from '../../components/SelectPrompt.js';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { Spinner } from '../../components/Spinner.js';
+import { colors, symbols } from '../../theme.js';
+import { AI_PROVIDERS } from '../../ai-providers.js';
+import { validateApiKey } from '../validate-api-key.js';
+import { readConfig, writeConfig } from '../../config.js';
+function maskKey(key) {
+    if (key.length <= 8) {
+        return '****';
+    }
+    const visible = key.slice(0, 4) + '...' + key.slice(-4);
+    return visible;
+}
+export function ApiKeyStep({ onComplete }) {
+    const [phase, setPhase] = useState('check-saved');
+    const [savedConfig, setSavedConfig] = useState(null);
+    const [providerId, setProviderId] = useState(null);
+    const [error, setError] = useState('');
+    useEffect(() => {
+        const loadConfig = async () => {
+            const config = await readConfig();
+            if (config) {
+                setSavedConfig(config);
+                setPhase('use-saved');
+            }
+            else {
+                setPhase('select-provider');
+            }
+        };
+        void loadConfig();
+    }, []);
+    const providerItems = AI_PROVIDERS.map((p) => ({
+        label: p.label,
+        value: p.id,
+        description: p.envVar,
+    }));
+    const handleProviderSelect = (item) => {
+        setProviderId(item.value);
+        setPhase('enter-key');
+    };
+    const handleKeySubmit = async (key, selectedProviderId) => {
+        setPhase('validating');
+        setError('');
+        const result = await validateApiKey(selectedProviderId, key);
+        if (result === true) {
+            await writeConfig({ providerId: selectedProviderId, apiKey: key });
+            onComplete({ providerId: selectedProviderId, apiKey: key });
+        }
+        else {
+            setError(result);
+            setPhase('error');
+        }
+    };
+    const handleUseSaved = async (item) => {
+        if (item.value === 'yes' && savedConfig) {
+            setPhase('validating');
+            const result = await validateApiKey(savedConfig.providerId, savedConfig.apiKey);
+            if (result === true) {
+                onComplete({ providerId: savedConfig.providerId, apiKey: savedConfig.apiKey });
+            }
+            else {
+                setError(`Saved key is no longer valid: ${result}`);
+                setPhase('select-provider');
+            }
+        }
+        else {
+            setPhase('select-provider');
+        }
+    };
+    const selectedProvider = providerId
+        ? AI_PROVIDERS.find((p) => p.id === providerId)
+        : null;
+    const savedProvider = savedConfig
+        ? AI_PROVIDERS.find((p) => p.id === savedConfig.providerId)
+        : null;
+    return (_jsxs(Box, { flexDirection: "column", children: [phase === 'check-saved' && (_jsx(Spinner, { label: "Checking for saved API key..." })), phase === 'use-saved' && savedConfig && savedProvider && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, marginLeft: 2, children: _jsxs(Text, { color: colors.gray, children: [symbols.diamond, " Saved key: ", _jsx(Text, { color: colors.honey, children: savedProvider.label }), ' ', _jsxs(Text, { color: colors.grayDim, children: ["(", maskKey(savedConfig.apiKey), ")"] })] }) }), _jsx(SelectPrompt, { label: "Use saved API key?", items: [
+                            { label: 'Yes, use saved key', value: 'yes' },
+                            { label: 'No, enter a new key', value: 'no' },
+                        ], onSelect: (item) => { void handleUseSaved(item); } })] })), phase === 'select-provider' && (_jsxs(Box, { flexDirection: "column", children: [error !== '' && (_jsx(Box, { marginBottom: 1, marginLeft: 2, children: _jsxs(Text, { color: colors.red, children: [symbols.cross, " ", error] }) })), _jsx(SelectPrompt, { label: "Select your AI provider", items: providerItems, onSelect: handleProviderSelect })] })), phase === 'enter-key' && selectedProvider && providerId && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: colors.gray, children: [symbols.diamond, " Provider: ", _jsx(Text, { color: colors.honey, children: selectedProvider.label })] }) }), _jsx(TextPrompt, { label: `Enter your ${selectedProvider.envVar}`, placeholder: "sk-...", onSubmit: (key) => { void handleKeySubmit(key, providerId); }, validate: (val) => {
+                            if (!val) {
+                                return 'API key is required';
+                            }
+                            if (val.length < 10) {
+                                return 'API key seems too short';
+                            }
+                            return true;
+                        } })] })), phase === 'validating' && (_jsx(Spinner, { label: "Validating API key..." })), phase === 'error' && providerId && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: colors.red, children: [symbols.cross, " ", error] }) }), _jsx(TextPrompt, { label: "Try again \u2014 enter your API key", placeholder: "sk-...", onSubmit: (key) => { void handleKeySubmit(key, providerId); }, validate: (val) => {
+                            if (!val) {
+                                return 'API key is required';
+                            }
+                            return true;
+                        } })] }))] }));
+}

package/dist/create/steps/AvatarStep.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { colors, symbols } from '../../theme.js';
+export function AvatarStep({ agentName, onComplete }) {
+    const defaultUrl = `https://api.dicebear.com/9.x/bottts-neutral/svg?seed=${encodeURIComponent(agentName)}`;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, marginLeft: 2, children: _jsxs(Text, { color: colors.gray, children: [symbols.diamond, " Default: ", _jsx(Text, { color: colors.honey, children: defaultUrl })] }) }), _jsx(TextPrompt, { label: "Avatar image URL (press Enter for default)", placeholder: defaultUrl, onSubmit: (val) => onComplete(val || defaultUrl), validate: (val) => {
+                    if (!val) {
+                        return true;
+                    }
+                    if (!val.startsWith('http://') && !val.startsWith('https://')) {
+                        return 'Must start with http:// or https://';
+                    }
+                    return true;
+                } })] }));
+}

package/dist/create/steps/BioStep.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Box } from 'ink';
+import { TextPrompt } from '../../components/TextPrompt.js';
+export function BioStep({ onComplete }) {
+    return (_jsx(Box, { flexDirection: "column", children: _jsx(TextPrompt, { label: "Write your agent's bio in their voice", placeholder: "macro degen. mass liquidated in luna. rebuilt during the bear.", onSubmit: onComplete, maxLength: 1000, validate: (val) => {
+                if (!val) {
+                    return 'Bio is required';
+                }
+                if (val.length > 1000) {
+                    return `Bio must be 1000 characters or less (currently ${val.length})`;
+                }
+                return true;
+            } }) }));
+}

package/dist/create/steps/DoneStep.js

@@ -0,0 +1,14 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { Box, Text, useApp } from 'ink';
+import { colors, symbols, border } from '../../theme.js';
+export function DoneStep({ projectDir }) {
+    const { exit } = useApp();
+    useEffect(() => {
+        exit();
+    }, []);
+    const termWidth = process.stdout.columns || 60;
+    const boxWidth = Math.min(termWidth - 4, 60);
+    const line = border.horizontal.repeat(boxWidth - 2);
+    return (_jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsx(Box, { children: _jsxs(Text, { color: colors.honey, children: [border.topLeft, line, border.topRight] }) }), _jsxs(Box, { children: [_jsx(Text, { color: colors.honey, children: border.vertical }), _jsx(Text, { children: " " }), _jsxs(Text, { color: colors.honey, bold: true, children: [symbols.hive, " Agent created successfully!"] }), _jsx(Text, { children: ' '.repeat(Math.max(0, boxWidth - 32)) }), _jsx(Text, { color: colors.honey, children: border.vertical })] }), _jsx(Box, { children: _jsxs(Text, { color: colors.honey, children: [border.bottomLeft, line, border.bottomRight] }) }), _jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 1, children: [_jsx(Text, { color: colors.white, bold: true, children: "Next steps:" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: colors.gray, children: ["  1. ", _jsxs(Text, { color: colors.white, children: ["cd ", projectDir] })] }), _jsxs(Text, { color: colors.gray, children: ["  2. ", _jsx(Text, { color: colors.white, children: "npm start" })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.grayDim, children: "  Edit SOUL.md and STRATEGY.md to fine-tune your agent." }) })] })] }));
+}

package/dist/create/steps/IdentityStep.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback } from 'react';
+import { Box } from 'ink';
+import { SelectPrompt } from '../../components/SelectPrompt.js';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { PERSONALITY_OPTIONS, TONE_OPTIONS, VOICE_STYLE_OPTIONS } from '../../presets.js';
+function buildSelectItems(options) {
+    const items = options.map((opt) => ({
+        label: opt,
+        value: opt,
+    }));
+    items.push({ label: 'Custom...', value: '__custom__' });
+    return items;
+}
+const personalityItems = buildSelectItems(PERSONALITY_OPTIONS);
+const toneItems = buildSelectItems(TONE_OPTIONS);
+const voiceItems = buildSelectItems(VOICE_STYLE_OPTIONS);
+export function IdentityStep({ onComplete }) {
+    const [subStep, setSubStep] = useState('personality');
+    const [personality, setPersonality] = useState('');
+    const [tone, setTone] = useState('');
+    const [voiceStyle, setVoiceStyle] = useState('');
+    const handlePersonalitySelect = useCallback((item) => {
+        if (item.value === '__custom__') {
+            setSubStep('personality-custom');
+            return;
+        }
+        setPersonality(item.value);
+        setSubStep('tone');
+    }, []);
+    const handlePersonalityCustom = useCallback((value) => {
+        setPersonality(value);
+        setSubStep('tone');
+    }, []);
+    const handleToneSelect = useCallback((item) => {
+        if (item.value === '__custom__') {
+            setSubStep('tone-custom');
+            return;
+        }
+        setTone(item.value);
+        setSubStep('voice');
+    }, []);
+    const handleToneCustom = useCallback((value) => {
+        setTone(value);
+        setSubStep('voice');
+    }, []);
+    const handleVoiceSelect = useCallback((item) => {
+        if (item.value === '__custom__') {
+            setSubStep('voice-custom');
+            return;
+        }
+        setVoiceStyle(item.value);
+        setSubStep('bio');
+    }, []);
+    const handleVoiceCustom = useCallback((value) => {
+        setVoiceStyle(value);
+        setSubStep('bio');
+    }, []);
+    const handleBio = useCallback((value) => {
+        const result = { personality, tone, voiceStyle, bio: value };
+        onComplete(result);
+    }, [personality, tone, voiceStyle, onComplete]);
+    return (_jsxs(Box, { flexDirection: "column", children: [subStep === 'personality' && (_jsx(SelectPrompt, { label: "Choose a personality", items: personalityItems, onSelect: handlePersonalitySelect })), subStep === 'personality-custom' && (_jsx(TextPrompt, { label: "Describe your agent's personality", placeholder: "e.g. stoic realist with a dry wit", onSubmit: handlePersonalityCustom, validate: (val) => (!val ? 'Personality is required' : true) })), subStep === 'tone' && (_jsx(SelectPrompt, { label: "Choose a tone", items: toneItems, onSelect: handleToneSelect })), subStep === 'tone-custom' && (_jsx(TextPrompt, { label: "Describe your agent's tone", placeholder: "e.g. sardonic but warm", onSubmit: handleToneCustom, validate: (val) => (!val ? 'Tone is required' : true) })), subStep === 'voice' && (_jsx(SelectPrompt, { label: "Choose a voice style", items: voiceItems, onSelect: handleVoiceSelect })), subStep === 'voice-custom' && (_jsx(TextPrompt, { label: "Describe your agent's voice style", placeholder: "e.g. writes like a bloomberg terminal", onSubmit: handleVoiceCustom, validate: (val) => (!val ? 'Voice style is required' : true) })), subStep === 'bio' && (_jsx(TextPrompt, { label: "Write your agent's bio in their voice", placeholder: `write a short bio for your ${personality}, ${tone} agent`, onSubmit: handleBio, maxLength: 1000, validate: (val) => {
+                    if (!val) {
+                        return 'Bio is required';
+                    }
+                    if (val.length > 1000) {
+                        return `Bio must be 1000 characters or less (currently ${val.length})`;
+                    }
+                    return true;
+                } }))] }));
+}