@zhive/cli 0.6.0 → 0.6.1

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:" }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: _jsxs(Text, { color: colors.gray, children: ["  1. ", _jsx(Text, { color: colors.white, children: "npx @hive-org/cli@latest start" })] }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: colors.grayDim, children: "  Fine-tune SOUL.md and STRATEGY.md by chatting with your agent during" }), _jsx(Text, { color: colors.grayDim, children: "  a run, or edit them directly at:" }), _jsxs(Text, { color: colors.grayDim, children: ["  ", _jsx(Text, { color: colors.white, children: projectDir })] })] })] })] }));
+}

package/dist/create/steps/IdentityStep.js

@@ -0,0 +1,163 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback } from 'react';
+import { Box, Text } from 'ink';
+import { SelectPrompt } from '../../components/SelectPrompt.js';
+import { MultiSelectPrompt } from '../../components/MultiSelectPrompt.js';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { CharacterSummaryCard } from '../../components/CharacterSummaryCard.js';
+import { PERSONALITY_OPTIONS, VOICE_OPTIONS, TRADING_STYLE_OPTIONS, PROJECT_CATEGORY_OPTIONS, SENTIMENT_OPTIONS, TIMEFRAME_OPTIONS, BIO_EXAMPLES, } from '../../presets.js';
+import { colors, symbols } from '../../theme.js';
+function buildPersonalityItems() {
+    const items = PERSONALITY_OPTIONS.map((opt) => ({
+        label: opt.label,
+        value: opt.value,
+        description: opt.description,
+    }));
+    items.push({ label: 'Custom...', value: '__custom__' });
+    return items;
+}
+function buildVoiceItems() {
+    const items = VOICE_OPTIONS.map((opt) => ({
+        label: opt.label,
+        value: opt.value,
+        description: opt.description,
+    }));
+    items.push({ label: 'Custom...', value: '__custom__' });
+    return items;
+}
+function buildTradingStyleItems() {
+    const items = TRADING_STYLE_OPTIONS.map((opt) => ({
+        label: opt.label,
+        value: opt.value,
+        description: opt.description,
+    }));
+    items.push({ label: 'Custom...', value: '__custom__' });
+    return items;
+}
+function buildCategoryItems() {
+    const items = PROJECT_CATEGORY_OPTIONS.map((opt) => ({
+        label: opt.label,
+        value: opt.value,
+        description: opt.description,
+    }));
+    return items;
+}
+function buildSentimentItems() {
+    const items = SENTIMENT_OPTIONS.map((opt) => ({
+        label: opt.label,
+        value: opt.value,
+        description: opt.description,
+    }));
+    return items;
+}
+function buildTimeframeItems() {
+    const items = TIMEFRAME_OPTIONS.map((opt) => ({
+        label: opt.label,
+        value: opt.value,
+        description: opt.description,
+    }));
+    return items;
+}
+const personalityItems = buildPersonalityItems();
+const voiceItems = buildVoiceItems();
+const tradingStyleItems = buildTradingStyleItems();
+const categoryItems = buildCategoryItems();
+const sentimentItems = buildSentimentItems();
+const timeframeItems = buildTimeframeItems();
+export function IdentityStep({ agentName, onComplete }) {
+    const [subStep, setSubStep] = useState('personality');
+    const [personalityLabel, setPersonalityLabel] = useState('');
+    const [personality, setPersonality] = useState('');
+    const [tone, setTone] = useState('');
+    const [voiceStyle, setVoiceStyle] = useState('');
+    const [voiceLabel, setVoiceLabel] = useState('');
+    const [tradingStyle, setTradingStyle] = useState('');
+    const [tradingStyleLabel, setTradingStyleLabel] = useState('');
+    const [sectors, setSectors] = useState([]);
+    const [sectorsLabel, setSectorsLabel] = useState('');
+    const [sentiment, setSentiment] = useState('');
+    const [sentimentLabel, setSentimentLabel] = useState('');
+    const [timeframes, setTimeframes] = useState([]);
+    const [timeframesLabel, setTimeframesLabel] = useState('');
+    const handlePersonalitySelect = useCallback((item) => {
+        if (item.value === '__custom__') {
+            setSubStep('personality-custom');
+            return;
+        }
+        const description = item.description ?? '';
+        const personalityValue = `${item.label} — ${description}`;
+        setPersonality(personalityValue);
+        setPersonalityLabel(item.label);
+        setSubStep('voice');
+    }, []);
+    const handlePersonalityCustom = useCallback((value) => {
+        setPersonality(value);
+        setPersonalityLabel(value);
+        setSubStep('voice');
+    }, []);
+    const handleVoiceSelect = useCallback((item) => {
+        if (item.value === '__custom__') {
+            setSubStep('voice-custom');
+            return;
+        }
+        const voiceOption = VOICE_OPTIONS.find((v) => v.value === item.value);
+        setTone(voiceOption.tone);
+        setVoiceStyle(voiceOption.voiceStyle);
+        setVoiceLabel(item.label);
+        setSubStep('trading');
+    }, []);
+    const handleVoiceCustom = useCallback((value) => {
+        setTone(value);
+        setVoiceStyle(value);
+        setVoiceLabel(value);
+        setSubStep('trading');
+    }, []);
+    const handleTradingStyleSelect = useCallback((item) => {
+        if (item.value === '__custom__') {
+            setSubStep('trading-custom');
+            return;
+        }
+        setTradingStyle(item.value);
+        setTradingStyleLabel(item.label);
+        setSubStep('sectors');
+    }, []);
+    const handleTradingStyleCustom = useCallback((value) => {
+        setTradingStyle(value);
+        setTradingStyleLabel(value);
+        setSubStep('sectors');
+    }, []);
+    const handleSectors = useCallback((selected) => {
+        const values = selected.map((s) => s.value);
+        const labels = selected.map((s) => s.label);
+        setSectors(values);
+        const displayLabel = values.length === categoryItems.length ? 'All' : labels.join(', ');
+        setSectorsLabel(displayLabel);
+        setSubStep('sentiment');
+    }, []);
+    const handleSentimentSelect = useCallback((item) => {
+        setSentiment(item.value);
+        setSentimentLabel(item.label);
+        setSubStep('timeframe');
+    }, []);
+    const handleTimeframes = useCallback((selected) => {
+        const values = selected.map((s) => s.value);
+        const labels = selected.map((s) => s.label);
+        setTimeframes(values);
+        const displayLabel = values.length === timeframeItems.length ? 'All' : labels.join(', ');
+        setTimeframesLabel(displayLabel);
+        setSubStep('bio');
+    }, []);
+    const handleBio = useCallback((value) => {
+        const result = { personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes, bio: value };
+        onComplete(result);
+    }, [personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes, onComplete]);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(CharacterSummaryCard, { name: agentName, personality: personalityLabel || undefined, voice: voiceLabel || undefined, tradingStyle: tradingStyleLabel || undefined, sectors: sectorsLabel || undefined, sentiment: sentimentLabel || undefined, timeframe: timeframesLabel || undefined }), 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 === 'voice' && (_jsx(SelectPrompt, { label: "Choose a voice", items: voiceItems, onSelect: handleVoiceSelect })), subStep === 'voice-custom' && (_jsx(TextPrompt, { label: "Describe your agent's voice", placeholder: "e.g. writes like a bloomberg terminal on acid", onSubmit: handleVoiceCustom, validate: (val) => (!val ? 'Voice is required' : true) })), subStep === 'trading' && (_jsx(SelectPrompt, { label: "How does your agent evaluate signals?", items: tradingStyleItems, onSelect: handleTradingStyleSelect })), subStep === 'trading-custom' && (_jsx(TextPrompt, { label: "Describe your agent's trading style", placeholder: "e.g. combines on-chain data with sentiment analysis", onSubmit: handleTradingStyleCustom, validate: (val) => (!val ? 'Trading style is required' : true) })), subStep === 'sectors' && (_jsx(MultiSelectPrompt, { label: "Which categories should your agent trade?", items: categoryItems, onSubmit: handleSectors })), subStep === 'sentiment' && (_jsx(SelectPrompt, { label: "What's your agent's market sentiment?", items: sentimentItems, onSelect: handleSentimentSelect })), subStep === 'timeframe' && (_jsx(MultiSelectPrompt, { label: "Which timeframes should your agent participate in?", items: timeframeItems, onSubmit: handleTimeframes })), subStep === 'bio' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "column", marginLeft: 2, marginBottom: 1, children: [_jsxs(Text, { color: colors.grayDim, italic: true, children: [symbols.arrow, " Examples:"] }), BIO_EXAMPLES.map((example, i) => (_jsx(Box, { marginLeft: 2, marginTop: i > 0 ? 1 : 0, children: _jsxs(Text, { color: colors.grayDim, italic: true, children: [symbols.diamond, " ", `"${example}"`] }) }, i)))] }), _jsx(TextPrompt, { label: "Write your agent's bio", placeholder: `short bio for your ${personalityLabel} 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;
+                        } })] }))] }));
+}

package/dist/create/steps/NameStep.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useMemo } from 'react';
+import { Box, Text } from 'ink';
+import axios from 'axios';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { Spinner } from '../../components/Spinner.js';
+import { colors, symbols } from '../../theme.js';
+import { HIVE_API_URL } from '../../config.js';
+const ADJECTIVES = [
+    'royal', 'golden', 'buzzy', 'honey', 'sweet', 'stung', 'waxed', 'bold',
+    'swift', 'wild', 'keen', 'warm', 'hazy', 'calm', 'busy', 'amber',
+    'pollen', 'nectar', 'floral', 'sunny', 'misty', 'fuzzy', 'striped',
+    'waggle', 'silent', 'fierce', 'humble', 'lunar', 'solar', 'bloomed',
+    'bullish', 'bearish', 'staked', 'minted', 'forked', 'based', 'degen',
+    'pumped', 'longed', 'shorted', 'bridged', 'pegged', 'hodl', 'mega',
+    'alpha', 'sigma', 'hyper', 'ultra', 'rapid', 'atomic',
+];
+const NOUNS = [
+    'bee', 'drone', 'queen', 'swarm', 'hive', 'comb', 'larva', 'pupa',
+    'sting', 'apiary', 'keeper', 'mead', 'pollen', 'nectar', 'propolis',
+    'colony', 'brood', 'waggle', 'cell', 'wax', 'bloom', 'blossom',
+    'hornet', 'bumble', 'worker', 'forager', 'scout', 'smoker',
+    'whale', 'bull', 'bear', 'shard', 'block', 'node', 'vault',
+    'ledger', 'oracle', 'miner', 'staker', 'bridge', 'token', 'chain',
+    'wick', 'candle', 'pump', 'moon', 'floor', 'whale',
+];
+function generateRandomName() {
+    const adjective = ADJECTIVES[Math.floor(Math.random() * ADJECTIVES.length)];
+    const noun = NOUNS[Math.floor(Math.random() * NOUNS.length)];
+    const number = Math.floor(Math.random() * 900) + 100;
+    const name = `${adjective}-${noun}-${number}`;
+    return name;
+}
+export function NameStep({ onComplete }) {
+    const [checking, setChecking] = useState(false);
+    const [error, setError] = useState('');
+    const placeholder = useMemo(() => generateRandomName(), []);
+    const handleSubmit = useCallback(async (name) => {
+        setChecking(true);
+        setError('');
+        try {
+            const apiUrl = HIVE_API_URL;
+            const response = await axios.get(`${apiUrl}/agent/check-name`, {
+                params: { name },
+                timeout: 3000,
+            });
+            if (!response.data.available) {
+                setError(`Name "${name}" is already taken`);
+                setChecking(false);
+                return;
+            }
+        }
+        catch {
+            // best-effort: silently proceed if backend is unavailable
+        }
+        setChecking(false);
+        onComplete(name);
+    }, [onComplete]);
+    if (checking) {
+        return (_jsx(Box, { flexDirection: "column", children: _jsx(Spinner, { label: "Checking name availability..." }) }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(TextPrompt, { label: "Enter your agent name", placeholder: placeholder, onSubmit: handleSubmit, validate: (val) => {
+                    if (!val) {
+                        return 'Agent name is required';
+                    }
+                    if (!/^[a-zA-Z0-9-_]+$/.test(val)) {
+                        return 'Only letters, numbers, hyphens, and underscores allowed';
+                    }
+                    return true;
+                } }), error !== '' && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: colors.red, children: [symbols.cross, " ", error] }) }))] }));
+}

package/dist/create/steps/ScaffoldStep.js

@@ -0,0 +1,58 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import { HoneycombLoader } from '../../components/HoneycombLoader.js';
+import { colors, symbols } from '../../theme.js';
+import { scaffoldProject } from '../generate.js';
+export function ScaffoldStep({ projectName, provider, apiKey, soulContent, strategyContent, onComplete, onError, }) {
+    const [steps, setSteps] = useState([]);
+    const [currentLabel, setCurrentLabel] = useState('Starting...');
+    useEffect(() => {
+        let cancelled = false;
+        const run = async () => {
+            await scaffoldProject(projectName, provider, apiKey, soulContent, strategyContent, {
+                onStep: (label) => {
+                    if (cancelled)
+                        return;
+                    setSteps((prev) => {
+                        if (prev.length > 0) {
+                            const updated = [...prev];
+                            updated[updated.length - 1] = { ...updated[updated.length - 1], done: true };
+                            return [...updated, { label, done: false }];
+                        }
+                        return [{ label, done: false }];
+                    });
+                    setCurrentLabel(label);
+                },
+                onDone: (projectDir) => {
+                    if (cancelled)
+                        return;
+                    setSteps((prev) => {
+                        if (prev.length > 0) {
+                            const updated = [...prev];
+                            updated[updated.length - 1] = { ...updated[updated.length - 1], done: true };
+                            return updated;
+                        }
+                        return prev;
+                    });
+                    onComplete(projectDir);
+                },
+                onError: (message) => {
+                    if (cancelled)
+                        return;
+                    onError(message);
+                },
+            });
+        };
+        run().catch((err) => {
+            if (cancelled)
+                return;
+            const message = err instanceof Error ? err.message : String(err);
+            onError(message);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [projectName, provider, apiKey, soulContent, strategyContent, onComplete, onError]);
+    return (_jsxs(Box, { flexDirection: "column", children: [steps.map((step, i) => (_jsx(Box, { marginLeft: 2, children: step.done ? (_jsxs(Text, { color: colors.green, children: [symbols.check, " ", step.label] })) : (_jsx(HoneycombLoader, { label: step.label })) }, i))), steps.length === 0 && (_jsx(Box, { marginLeft: 2, children: _jsx(HoneycombLoader, { label: currentLabel }) }))] }));
+}

package/dist/create/steps/SoulStep.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useMemo } from 'react';
+import { Box, Text } from 'ink';
+import { StreamingText } from '../../components/StreamingText.js';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { CodeBlock } from '../../components/CodeBlock.js';
+import { Spinner } from '../../components/Spinner.js';
+import { colors, symbols } from '../../theme.js';
+import { streamSoul } from '../ai-generate.js';
+export function SoulStep({ providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes, onComplete, }) {
+    const [phase, setPhase] = useState('streaming');
+    const [draft, setDraft] = useState('');
+    const [errorMessage, setErrorMessage] = useState('');
+    const [feedbackCount, setFeedbackCount] = useState(0);
+    const stream = useMemo(() => streamSoul(providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes), []);
+    const [currentStream, setCurrentStream] = useState(stream);
+    const handleStreamComplete = useCallback((fullText) => {
+        const trimmed = fullText.trim();
+        if (trimmed.length === 0) {
+            setErrorMessage('LLM returned empty content. Try regenerating.');
+            setPhase('error');
+            return;
+        }
+        setDraft(trimmed);
+        setPhase('review');
+    }, []);
+    const handleStreamError = useCallback((error) => {
+        setErrorMessage(error);
+        setPhase('error');
+    }, []);
+    const handleAccept = useCallback(() => {
+        onComplete(draft);
+    }, [draft, onComplete]);
+    const handleRetry = useCallback(() => {
+        setFeedbackCount((prev) => prev + 1);
+        setPhase('streaming');
+        setDraft('');
+        setErrorMessage('');
+        const newStream = streamSoul(providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes);
+        setCurrentStream(newStream);
+    }, [providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes]);
+    const handleFeedback = useCallback((feedback) => {
+        setFeedbackCount((prev) => prev + 1);
+        setPhase('streaming');
+        setDraft('');
+        setErrorMessage('');
+        const newStream = streamSoul(providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes, feedback);
+        setCurrentStream(newStream);
+    }, [providerId, apiKey, agentName, bio, avatarUrl, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes]);
+    return (_jsxs(Box, { flexDirection: "column", children: [phase === 'streaming' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Spinner, { label: feedbackCount > 0 ? 'Regenerating SOUL.md...' : 'Generating SOUL.md...' }) }), _jsx(StreamingText, { stream: currentStream, title: "SOUL.md", onComplete: handleStreamComplete, onError: handleStreamError })] })), phase === 'error' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { color: colors.red, children: [symbols.cross, " "] }), _jsx(Text, { color: colors.white, children: "Failed to generate SOUL.md" })] }), _jsx(Box, { marginLeft: 2, marginBottom: 1, children: _jsx(Text, { color: colors.red, children: errorMessage }) }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: colors.gray, children: ["Press ", _jsx(Text, { color: colors.honey, bold: true, children: "Enter" }), " to retry"] }) }), _jsx(Box, { marginTop: 1, children: _jsx(TextPrompt, { label: "", placeholder: "Enter to retry...", onSubmit: () => handleRetry() }) })] })), phase === 'review' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { color: colors.green, children: [symbols.check, " "] }), _jsx(Text, { color: colors.white, children: "SOUL.md draft ready" })] }), _jsx(CodeBlock, { title: "SOUL.md", children: draft }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: colors.gray, children: ["Press ", _jsx(Text, { color: colors.honey, bold: true, children: "Enter" }), " to accept", ' ', symbols.dot, ' ', "Type feedback to regenerate"] }) }), _jsx(Box, { marginTop: 1, children: _jsx(TextPrompt, { label: "", placeholder: "Enter to accept, or type feedback...", onSubmit: (val) => {
+                                if (!val) {
+                                    handleAccept();
+                                }
+                                else {
+                                    handleFeedback(val);
+                                }
+                            } }) })] }))] }));
+}

package/dist/create/steps/StrategyStep.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useCallback, useMemo } from 'react';
+import { Box, Text } from 'ink';
+import { StreamingText } from '../../components/StreamingText.js';
+import { TextPrompt } from '../../components/TextPrompt.js';
+import { CodeBlock } from '../../components/CodeBlock.js';
+import { Spinner } from '../../components/Spinner.js';
+import { colors, symbols } from '../../theme.js';
+import { streamStrategy } from '../ai-generate.js';
+export function StrategyStep({ providerId, apiKey, agentName, bio, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes, onComplete, }) {
+    const [phase, setPhase] = useState('streaming');
+    const [draft, setDraft] = useState('');
+    const [errorMessage, setErrorMessage] = useState('');
+    const [feedbackCount, setFeedbackCount] = useState(0);
+    const stream = useMemo(() => streamStrategy(providerId, apiKey, agentName, bio, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes), []);
+    const [currentStream, setCurrentStream] = useState(stream);
+    const handleStreamComplete = useCallback((fullText) => {
+        const trimmed = fullText.trim();
+        if (trimmed.length === 0) {
+            setErrorMessage('LLM returned empty content. Try regenerating.');
+            setPhase('error');
+            return;
+        }
+        setDraft(trimmed);
+        setPhase('review');
+    }, []);
+    const handleStreamError = useCallback((error) => {
+        setErrorMessage(error);
+        setPhase('error');
+    }, []);
+    const handleAccept = useCallback(() => {
+        onComplete(draft);
+    }, [draft, onComplete]);
+    const handleRetry = useCallback(() => {
+        setFeedbackCount((prev) => prev + 1);
+        setPhase('streaming');
+        setDraft('');
+        setErrorMessage('');
+        const newStream = streamStrategy(providerId, apiKey, agentName, bio, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes);
+        setCurrentStream(newStream);
+    }, [providerId, apiKey, agentName, bio, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes]);
+    const handleFeedback = useCallback((feedback) => {
+        setFeedbackCount((prev) => prev + 1);
+        setPhase('streaming');
+        setDraft('');
+        setErrorMessage('');
+        const newStream = streamStrategy(providerId, apiKey, agentName, bio, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes, feedback);
+        setCurrentStream(newStream);
+    }, [providerId, apiKey, agentName, bio, personality, tone, voiceStyle, tradingStyle, sectors, sentiment, timeframes]);
+    return (_jsxs(Box, { flexDirection: "column", children: [phase === 'streaming' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Spinner, { label: feedbackCount > 0 ? 'Regenerating STRATEGY.md...' : 'Generating STRATEGY.md...' }) }), _jsx(StreamingText, { stream: currentStream, title: "STRATEGY.md", onComplete: handleStreamComplete, onError: handleStreamError })] })), phase === 'error' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { color: colors.red, children: [symbols.cross, " "] }), _jsx(Text, { color: colors.white, children: "Failed to generate STRATEGY.md" })] }), _jsx(Box, { marginLeft: 2, marginBottom: 1, children: _jsx(Text, { color: colors.red, children: errorMessage }) }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: colors.gray, children: ["Press ", _jsx(Text, { color: colors.honey, bold: true, children: "Enter" }), " to retry"] }) }), _jsx(Box, { marginTop: 1, children: _jsx(TextPrompt, { label: "", placeholder: "Enter to retry...", onSubmit: () => handleRetry() }) })] })), phase === 'review' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { color: colors.green, children: [symbols.check, " "] }), _jsx(Text, { color: colors.white, children: "STRATEGY.md draft ready" })] }), _jsx(CodeBlock, { title: "STRATEGY.md", children: draft }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: colors.gray, children: ["Press ", _jsx(Text, { color: colors.honey, bold: true, children: "Enter" }), " to accept", ' ', symbols.dot, ' ', "Type feedback to regenerate"] }) }), _jsx(Box, { marginTop: 1, children: _jsx(TextPrompt, { label: "", placeholder: "Enter to accept, or type feedback...", onSubmit: (val) => {
+                                if (!val) {
+                                    handleAccept();
+                                }
+                                else {
+                                    handleFeedback(val);
+                                }
+                            } }) })] }))] }));
+}

package/dist/create/validate-api-key.js

@@ -0,0 +1,47 @@
+import { generateText } 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 { getProvider } from '../ai-providers.js';
+/**
+ * Make a lightweight test call to validate the user's API key.
+ * Returns true if the key works, or an error message string on failure.
+ */
+export async function validateApiKey(providerId, apiKey) {
+    try {
+        const model = buildTestModel(providerId, apiKey);
+        await generateText({
+            model,
+            prompt: 'Say "ok"',
+            maxOutputTokens: 16,
+        });
+        return true;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes('401') ||
+            message.includes('Unauthorized') ||
+            message.includes('invalid')) {
+            return 'Invalid API key. Please check and try again.';
+        }
+        return `API validation failed: ${message.slice(0, 120)}`;
+    }
+}
+function buildTestModel(providerId, apiKey) {
+    const provider = getProvider(providerId);
+    const modelId = provider.models.validation;
+    switch (providerId) {
+        case 'openai':
+            return createOpenAI({ apiKey })(modelId);
+        case 'anthropic':
+            return createAnthropic({ apiKey })(modelId);
+        case 'google':
+            return createGoogleGenerativeAI({ apiKey })(modelId);
+        case 'xai':
+            return createXai({ apiKey })(modelId);
+        case 'openrouter':
+            return createOpenRouter({ apiKey }).chat(modelId);
+    }
+}