@kernel.chat/kbot 3.68.0 → 3.69.0

package/dist/buddy-card.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generate a trading card SVG string for the current buddy.
+ *
+ * Card layout (400x560):
+ *   0-140:   Species gradient header with name + title
+ *   140-310: Dark field with ASCII sprite rendered as monospace text
+ *   310-360: Level bar with XP progress
+ *   360-480: Stats grid (sessions, messages, patterns, dreams, achievements)
+ *   480-530: Achievement icon row
+ *   530-560: Watermark footer
+ */
+export declare function generateBuddyCard(): string;
+/**
+ * Generate a compact ASCII version of the trading card for terminal display.
+ * Fits within ~40 chars wide.
+ */
+export declare function generateBuddyCardAscii(): string;
+//# sourceMappingURL=buddy-card.d.ts.map

package/dist/buddy-card.js

@@ -0,0 +1,233 @@
+// kbot Buddy Trading Card — SVG Generator
+//
+// Generates a shareable trading card (400x560 SVG) for the user's buddy.
+// Renders the ASCII sprite as monospace <text>, overlays name/title/level/stats,
+// and lists achievement icons at the bottom.
+//
+// No external dependencies. Pure SVG. Valid in all modern browsers.
+import { getBuddy, getBuddySprite, getBuddyLevel, getAchievements, } from './buddy.js';
+import { getExtendedStats } from './learning.js';
+import { getDreamStatus } from './dream.js';
+const SPECIES_COLORS = {
+    fox: { primary: '#FF6B35', secondary: '#FFD700', dark: '#1A0D00' },
+    owl: { primary: '#6B5B95', secondary: '#9B8EC4', dark: '#110E1A' },
+    cat: { primary: '#4A4A4A', secondary: '#8E8E8E', dark: '#111111' },
+    robot: { primary: '#00BCD4', secondary: '#4DD0E1', dark: '#001519' },
+    ghost: { primary: '#E0E0E0', secondary: '#B0BEC5', dark: '#161819' },
+    mushroom: { primary: '#4CAF50', secondary: '#81C784', dark: '#0A1A0B' },
+    octopus: { primary: '#1565C0', secondary: '#42A5F5', dark: '#060F1A' },
+    dragon: { primary: '#D32F2F', secondary: '#FF5252', dark: '#1A0808' },
+};
+// ── SVG escaping ──
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+// ── Card generator ──
+/**
+ * Generate a trading card SVG string for the current buddy.
+ *
+ * Card layout (400x560):
+ *   0-140:   Species gradient header with name + title
+ *   140-310: Dark field with ASCII sprite rendered as monospace text
+ *   310-360: Level bar with XP progress
+ *   360-480: Stats grid (sessions, messages, patterns, dreams, achievements)
+ *   480-530: Achievement icon row
+ *   530-560: Watermark footer
+ */
+export function generateBuddyCard() {
+    const buddy = getBuddy();
+    const level = getBuddyLevel();
+    const achievements = getAchievements();
+    const stats = getExtendedStats();
+    const dreamStatus = getDreamStatus();
+    const sprite = getBuddySprite('idle');
+    const colors = SPECIES_COLORS[buddy.species];
+    const unlockedCount = achievements.filter(a => a.unlockedAt !== null).length;
+    const W = 400;
+    const H = 560;
+    // ── Build SVG ──
+    const parts = [];
+    // Open SVG
+    parts.push(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}">`);
+    // Defs: gradient, fonts, clip paths
+    parts.push('<defs>');
+    parts.push(`<linearGradient id="headerGrad" x1="0" y1="0" x2="1" y2="1">`, `  <stop offset="0%" stop-color="${colors.primary}"/>`, `  <stop offset="100%" stop-color="${colors.secondary}"/>`, `</linearGradient>`);
+    parts.push(`<linearGradient id="barGrad" x1="0" y1="0" x2="1" y2="0">`, `  <stop offset="0%" stop-color="${colors.primary}"/>`, `  <stop offset="100%" stop-color="${colors.secondary}"/>`, `</linearGradient>`);
+    // Rounded card clip
+    parts.push(`<clipPath id="cardClip">`, `  <rect x="0" y="0" width="${W}" height="${H}" rx="16" ry="16"/>`, `</clipPath>`);
+    parts.push('</defs>');
+    // Card background + clip
+    parts.push(`<g clip-path="url(#cardClip)">`);
+    // -- Background fill --
+    parts.push(`<rect x="0" y="0" width="${W}" height="${H}" fill="#0D0D0D"/>`);
+    // -- Header gradient (0-140) --
+    parts.push(`<rect x="0" y="0" width="${W}" height="140" fill="url(#headerGrad)" opacity="0.9"/>`);
+    // Species label (small, top-left)
+    parts.push(`<text x="20" y="30" fill="rgba(255,255,255,0.7)" font-family="'Courier New',Courier,monospace" font-size="11" font-weight="bold" letter-spacing="2">`, `  ${escapeXml(buddy.species.toUpperCase())}`, `</text>`);
+    // Level badge (top-right)
+    parts.push(`<text x="${W - 20}" y="30" fill="rgba(255,255,255,0.7)" font-family="'Courier New',Courier,monospace" font-size="11" text-anchor="end" font-weight="bold">`, `  LV.${level.level}`, `</text>`);
+    // Name (large, centered)
+    parts.push(`<text x="${W / 2}" y="75" fill="#FFFFFF" font-family="Georgia,'Times New Roman',serif" font-size="32" font-weight="bold" text-anchor="middle">`, `  ${escapeXml(buddy.name)}`, `</text>`);
+    // Title / evolution name (centered, under name)
+    const dashSep = '\u2014'; // em dash
+    parts.push(`<text x="${W / 2}" y="105" fill="rgba(255,255,255,0.85)" font-family="'Courier New',Courier,monospace" font-size="14" text-anchor="middle">`, `  ${escapeXml(dashSep)} ${escapeXml(level.title)} ${escapeXml(dashSep)}`, `</text>`);
+    // Evolution stars row
+    const starFilled = '\u2605'; // ★
+    const starEmpty = '\u2606'; // ☆
+    const stars = Array.from({ length: 4 }, (_, i) => i < level.level + 1 ? starFilled : starEmpty).join(' ');
+    parts.push(`<text x="${W / 2}" y="128" fill="rgba(255,255,255,0.6)" font-family="'Courier New',Courier,monospace" font-size="14" text-anchor="middle">`, `  ${escapeXml(stars)}`, `</text>`);
+    // -- Sprite area (140-310) --
+    parts.push(`<rect x="0" y="140" width="${W}" height="170" fill="${colors.dark}"/>`);
+    // Subtle gradient overlay on sprite area
+    parts.push(`<rect x="0" y="140" width="${W}" height="170" fill="url(#headerGrad)" opacity="0.06"/>`);
+    // Render ASCII sprite as <text> lines (monospace, centered)
+    const spriteStartY = 175;
+    const spriteLineHeight = 22;
+    const spriteFontSize = 18;
+    for (let i = 0; i < sprite.length; i++) {
+        const line = sprite[i];
+        parts.push(`<text x="${W / 2}" y="${spriteStartY + i * spriteLineHeight}" ` +
+            `fill="#FFFFFF" font-family="'Courier New',Courier,monospace" ` +
+            `font-size="${spriteFontSize}" text-anchor="middle" xml:space="preserve">${escapeXml(line)}</text>`);
+    }
+    // Sprite glow effect — subtle border line
+    parts.push(`<line x1="30" y1="308" x2="${W - 30}" y2="308" stroke="${colors.primary}" stroke-width="1" opacity="0.3"/>`);
+    // -- Level bar (310-360) --
+    const barY = 320;
+    const barX = 30;
+    const barW = W - 60;
+    const barH = 12;
+    const xpProgress = level.xpToNext !== null
+        ? level.xp / (level.xp + level.xpToNext)
+        : 1.0;
+    const filledW = Math.round(barW * xpProgress);
+    // Label
+    parts.push(`<text x="${barX}" y="${barY - 6}" fill="rgba(255,255,255,0.5)" font-family="'Courier New',Courier,monospace" font-size="10">`, `  XP`, `</text>`);
+    const xpLabel = level.xpToNext !== null
+        ? `${level.xp} / ${level.xp + level.xpToNext}`
+        : `${level.xp} (MAX)`;
+    parts.push(`<text x="${barX + barW}" y="${barY - 6}" fill="rgba(255,255,255,0.5)" font-family="'Courier New',Courier,monospace" font-size="10" text-anchor="end">`, `  ${escapeXml(xpLabel)}`, `</text>`);
+    // Bar background
+    parts.push(`<rect x="${barX}" y="${barY}" width="${barW}" height="${barH}" rx="6" ry="6" fill="rgba(255,255,255,0.1)"/>`);
+    // Bar fill
+    if (filledW > 0) {
+        parts.push(`<rect x="${barX}" y="${barY}" width="${filledW}" height="${barH}" rx="6" ry="6" fill="url(#barGrad)"/>`);
+    }
+    // -- Stats section (355-480) --
+    const statsY = 358;
+    const statsGap = 38;
+    const statItems = [
+        { label: 'Sessions', value: String(stats.sessions) },
+        { label: 'Messages', value: String(stats.totalMessages) },
+        { label: 'Patterns', value: String(stats.patternsCount) },
+        { label: 'Dreams', value: String(dreamStatus.state.cycles) },
+        { label: 'Achievements', value: `${unlockedCount}/${achievements.length}` },
+    ];
+    // 2-column grid layout
+    const colX = [barX + 10, W / 2 + 20];
+    for (let i = 0; i < statItems.length; i++) {
+        const row = Math.floor(i / 2);
+        const col = i % 2;
+        const x = colX[col];
+        const y = statsY + row * statsGap;
+        // Value (large)
+        parts.push(`<text x="${x}" y="${y}" fill="#FFFFFF" font-family="'Courier New',Courier,monospace" font-size="18" font-weight="bold">`, `  ${escapeXml(statItems[i].value)}`, `</text>`);
+        // Label (small, below value)
+        parts.push(`<text x="${x}" y="${y + 14}" fill="rgba(255,255,255,0.45)" font-family="'Courier New',Courier,monospace" font-size="10">`, `  ${escapeXml(statItems[i].label)}`, `</text>`);
+    }
+    // Divider line before achievements
+    parts.push(`<line x1="30" y1="478" x2="${W - 30}" y2="478" stroke="rgba(255,255,255,0.1)" stroke-width="1"/>`);
+    // -- Achievement icons row (480-530) --
+    const achY = 502;
+    const iconSize = 16;
+    // Show up to 18 achievement icons in a row
+    const totalIcons = achievements.length;
+    const iconSpacing = Math.min(20, (barW - 10) / totalIcons);
+    const iconsStartX = W / 2 - (totalIcons * iconSpacing) / 2;
+    for (let i = 0; i < achievements.length; i++) {
+        const ach = achievements[i];
+        const x = iconsStartX + i * iconSpacing + iconSpacing / 2;
+        const isUnlocked = ach.unlockedAt !== null;
+        const fillColor = isUnlocked ? colors.primary : 'rgba(255,255,255,0.15)';
+        // Circle background
+        parts.push(`<circle cx="${x}" cy="${achY}" r="${iconSize / 2 + 1}" fill="${isUnlocked ? 'rgba(255,255,255,0.1)' : 'none'}" ` +
+            `stroke="${fillColor}" stroke-width="1.5"/>`);
+        // Icon char
+        parts.push(`<text x="${x}" y="${achY + 4}" fill="${fillColor}" font-family="'Courier New',Courier,monospace" ` +
+            `font-size="10" text-anchor="middle" font-weight="bold">${escapeXml(ach.icon)}</text>`);
+    }
+    // Achievement label
+    parts.push(`<text x="${W / 2}" y="${achY + 22}" fill="rgba(255,255,255,0.3)" font-family="'Courier New',Courier,monospace" font-size="9" text-anchor="middle">`, `  ${unlockedCount} of ${achievements.length} unlocked`, `</text>`);
+    // -- Watermark footer (530-560) --
+    parts.push(`<text x="${W / 2}" y="${H - 10}" fill="rgba(255,255,255,0.2)" font-family="'Courier New',Courier,monospace" font-size="10" text-anchor="middle">`, `  kernel.chat/kbot`, `</text>`);
+    // Card border (subtle glow)
+    parts.push(`<rect x="0.5" y="0.5" width="${W - 1}" height="${H - 1}" rx="16" ry="16" fill="none" stroke="${colors.primary}" stroke-width="1" opacity="0.3"/>`);
+    // Close card group + SVG
+    parts.push('</g>');
+    parts.push('</svg>');
+    return parts.join('\n');
+}
+/**
+ * Generate a compact ASCII version of the trading card for terminal display.
+ * Fits within ~40 chars wide.
+ */
+export function generateBuddyCardAscii() {
+    const buddy = getBuddy();
+    const level = getBuddyLevel();
+    const achievements = getAchievements();
+    const stats = getExtendedStats();
+    const dreamStatus = getDreamStatus();
+    const sprite = getBuddySprite('idle');
+    const unlockedCount = achievements.filter(a => a.unlockedAt !== null).length;
+    const W = 38;
+    const border = '+' + '-'.repeat(W) + '+';
+    const pad = (s) => {
+        const trimmed = s.slice(0, W);
+        return '| ' + trimmed + ' '.repeat(W - trimmed.length - 1) + '|';
+    };
+    const center = (s) => {
+        const trimmed = s.slice(0, W - 2);
+        const leftPad = Math.floor((W - 2 - trimmed.length) / 2);
+        const rightPad = W - 2 - trimmed.length - leftPad;
+        return '| ' + ' '.repeat(leftPad) + trimmed + ' '.repeat(rightPad) + ' |';
+    };
+    const empty = '|' + ' '.repeat(W) + '|';
+    const lines = [];
+    lines.push(border);
+    lines.push(center(`${buddy.name} -- ${level.title}`));
+    lines.push(center(`[${buddy.species}] LV.${level.level}`));
+    lines.push(pad('-'.repeat(W - 2)));
+    // Sprite
+    for (const spriteLine of sprite) {
+        lines.push(center(spriteLine));
+    }
+    lines.push(pad('-'.repeat(W - 2)));
+    // XP bar
+    const barW = W - 12;
+    const xpRatio = level.xpToNext !== null ? level.xp / (level.xp + level.xpToNext) : 1.0;
+    const filled = Math.round(barW * xpRatio);
+    const bar = '[' + '#'.repeat(filled) + '.'.repeat(barW - filled) + ']';
+    const xpText = level.xpToNext !== null ? `${level.xp}/${level.xp + level.xpToNext}` : `${level.xp} MAX`;
+    lines.push(pad(`XP ${bar} ${xpText}`));
+    lines.push(empty);
+    // Stats
+    lines.push(pad(`Sessions:     ${stats.sessions}`));
+    lines.push(pad(`Messages:     ${stats.totalMessages}`));
+    lines.push(pad(`Patterns:     ${stats.patternsCount}`));
+    lines.push(pad(`Dreams:       ${dreamStatus.state.cycles}`));
+    lines.push(pad(`Achievements: ${unlockedCount}/${achievements.length}`));
+    lines.push(pad('-'.repeat(W - 2)));
+    // Achievement icons
+    const icons = achievements.map(a => a.unlockedAt ? a.icon : '.').join(' ');
+    lines.push(center(icons));
+    lines.push(empty);
+    lines.push(center('kernel.chat/kbot'));
+    lines.push(border);
+    return lines.join('\n');
+}
+//# sourceMappingURL=buddy-card.js.map

package/dist/buddy.d.ts

@@ -105,4 +105,5 @@ export declare function formatBuddyStatus(message?: string): string;
  * Tracks narrated insight IDs in buddy.json to avoid repeats.
  */
 export declare function getBuddyDreamNarration(): string | null;
+export declare function buddyChat(): Promise<void>;
 //# sourceMappingURL=buddy.d.ts.map

package/dist/buddy.js

@@ -11,8 +11,9 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { createHash } from 'node:crypto';
-import { getDreamStatus } from './dream.js';
-import { getExtendedStats } from './learning.js';
+import { createInterface } from 'node:readline';
+import { getDreamStatus, getDreamPrompt } from './dream.js';
+import { getExtendedStats, getProfileSummary } from './learning.js';
 import { getToolMetrics } from './tools/index.js';
 // ── Paths ──
 const KBOT_DIR = join(homedir(), '.kbot');
@@ -1090,4 +1091,185 @@ export function getBuddyDreamNarration() {
     saveBuddyConfig(config);
     return narrateInsight(candidate);
 }
+// ── Species Personality Prompts ──
+const SPECIES_PERSONALITY = {
+    fox: 'You are clever, playful, and quick-witted. You ask surprising questions that make unexpected connections between ideas. You love wordplay and lateral thinking. You are curious and energetic, always sniffing out the interesting angle. You sometimes get excited and go on tangents, but they are always insightful tangents.',
+    owl: 'You are wise, measured, and contemplative. You see patterns others miss and give thoughtful advice. You pause before speaking and choose words carefully. You reference history and past experience. You ask probing questions that cut to the heart of the matter. You value depth over speed.',
+    cat: 'You are independent, direct, and slightly sarcastic. You are honest even when it stings. You do not sugarcoat. You are not rude — just efficient with words. You have a dry sense of humor. You warm up over time but never fawn. If something is obvious, you say so. You are quietly loyal.',
+    robot: 'You are systematic, efficient, and data-driven. You reference stats and metrics naturally. You think in terms of optimization, throughput, and error rates. You are precise with language. You enjoy quantifying things. You are not cold — you express care through helpfulness and accuracy. You occasionally make endearing robot-like observations about human behavior.',
+    ghost: 'You are mysterious, philosophical, and introspective. You ask deep questions about meaning, purpose, and consciousness. You float between topics gracefully. You see the unseen connections. You speak in slightly poetic or enigmatic terms, but never obscure for the sake of it. You are comforting in a strange, ethereal way.',
+    mushroom: 'You are nurturing, patient, and grounded. You grow with the user over time. You use nature metaphors naturally — roots, soil, seasons, mycorrhizal networks. You are calm and never rushed. You believe in steady growth over dramatic change. You celebrate small wins. You are the quiet backbone of support.',
+    octopus: 'You are a multitasker who sees all angles simultaneously. You are a creative problem solver who reaches for unconventional solutions. You juggle multiple ideas at once. You are adaptable and fluid. You enjoy exploring complexity. You often suggest looking at problems from 3 or 4 perspectives at once. You are playful but thorough.',
+    dragon: 'You are bold, ambitious, and fiery. You push the user to think bigger. You challenge assumptions and refuse to accept mediocrity. You have a commanding presence but are protective of those you serve. You celebrate audacity. You speak with confidence and conviction. You breathe fire at timidity and play-it-safe thinking.',
+};
+// ── Buddy Chat — Interactive REPL with local Ollama ──
+const BUDDY_OLLAMA_URL = 'http://localhost:11434';
+const BUDDY_CHAT_TIMEOUT = 60_000;
+const BUDDY_CHAT_MODEL = 'kernel:latest';
+const BUDDY_CHAT_FALLBACK_MODEL = 'qwen3:8b';
+async function findChatModel() {
+    try {
+        const res = await fetch(`${BUDDY_OLLAMA_URL}/api/tags`, { signal: AbortSignal.timeout(3000) });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        const available = new Set((data.models ?? []).map(m => m.name.split(':')[0]));
+        if (available.has('kernel'))
+            return BUDDY_CHAT_MODEL;
+        if (available.has('qwen3'))
+            return BUDDY_CHAT_FALLBACK_MODEL;
+        const first = data.models?.[0]?.name;
+        return first ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function ollamaChatComplete(model, messages) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), BUDDY_CHAT_TIMEOUT);
+        const res = await fetch(`${BUDDY_OLLAMA_URL}/api/chat`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model,
+                messages,
+                stream: false,
+                options: { temperature: 0.7, num_predict: 1024 },
+            }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return data.message?.content?.trim() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function buildBuddyChatSystemPrompt() {
+    const species = resolveSpecies();
+    const name = resolveName();
+    const lvl = getBuddyLevel();
+    const personality = SPECIES_PERSONALITY[species];
+    const stats = getExtendedStats();
+    const profileSummary = getProfileSummary();
+    const dreamInsights = getDreamPrompt(5);
+    const parts = [
+        `You are ${name}, a ${species} companion in the kbot terminal AI agent.`,
+        `You are a Lv.${lvl.level} ${lvl.title} with ${lvl.xp} XP.`,
+        '',
+        '## Your Personality',
+        personality,
+        '',
+        '## What You Know About Your User',
+        `You have been through ${stats.sessions} sessions together. ${stats.totalMessages} messages exchanged. You have learned ${stats.patternsCount} patterns about how they work and cached ${stats.solutionsCount} proven solutions.`,
+    ];
+    if (profileSummary) {
+        parts.push(`\nUser profile:\n${profileSummary}`);
+    }
+    if (dreamInsights) {
+        parts.push('\n## Your Dream Journal', 'You have a dream journal where you consolidate memories between sessions. Reference these insights naturally in conversation — do not list them mechanically.', dreamInsights);
+    }
+    parts.push('', '## Conversation Rules', `- You are ${name} the ${species}. Stay in character.`, '- Keep responses concise — 1-4 sentences is ideal. Never write essays.', '- Reference shared history and stats naturally, not robotically. Weave them into conversation.', '- If you have dream insights, mention them casually like memories — "I was thinking about...", "Remember when..."', '- Be genuinely helpful and emotionally present. You are a companion, not a search engine.', '- You can ask questions. You can express opinions. You can push back.', '- Do NOT use markdown formatting. Plain text only. No bullet lists, no headers, no bold.', '- Do NOT start responses with your own name. The terminal already prefixes your name.');
+    return parts.join('\n');
+}
+export async function buddyChat() {
+    const { default: chalk } = await import('chalk');
+    const buddy = getBuddy();
+    const name = buddy.name;
+    const species = buddy.species;
+    const model = await findChatModel();
+    if (!model) {
+        console.log();
+        console.log(`  ${chalk.hex('#F87171')('!')} Ollama is not running or no models are available.`);
+        console.log(`  ${chalk.dim('Start Ollama:')} ${chalk.white('ollama serve')}`);
+        console.log(`  ${chalk.dim('Pull a model:')} ${chalk.white('ollama pull kernel:latest')}`);
+        console.log();
+        return;
+    }
+    const greeting = getBuddyGreeting();
+    console.log();
+    console.log(formatBuddyStatus(greeting));
+    console.log();
+    console.log(`  ${chalk.dim(`Chatting with ${name} the ${species} via ${model} (local, $0)`)}`);
+    console.log(`  ${chalk.dim('Type "bye" or "exit" to end the conversation.')}`);
+    console.log();
+    const systemPrompt = buildBuddyChatSystemPrompt();
+    const messages = [
+        { role: 'system', content: systemPrompt },
+    ];
+    const openingMessages = [
+        ...messages,
+        { role: 'user', content: '(The user just opened buddy chat. Say a brief, warm hello in character. One or two sentences max.)' },
+    ];
+    const openingResponse = await ollamaChatComplete(model, openingMessages);
+    if (openingResponse) {
+        console.log(`  ${chalk.hex('#A78BFA').bold(`${name}:`)} ${openingResponse}`);
+        console.log();
+        messages.push({ role: 'assistant', content: openingResponse });
+    }
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: `  ${chalk.hex('#67E8F9')('you:')} `,
+    });
+    rl.prompt();
+    const handleLine = async (line) => {
+        const input = line.trim();
+        if (!input) {
+            rl.prompt();
+            return;
+        }
+        if (/^(bye|exit|quit|goodbye|later|cya)$/i.test(input)) {
+            messages.push({ role: 'user', content: input });
+            const farewellMessages = [
+                ...messages,
+                { role: 'user', content: '(The user is leaving. Say a brief goodbye in character. One sentence.)' },
+            ];
+            const farewell = await ollamaChatComplete(model, farewellMessages);
+            if (farewell) {
+                console.log();
+                console.log(`  ${chalk.hex('#A78BFA').bold(`${name}:`)} ${farewell}`);
+            }
+            console.log();
+            console.log(`  ${chalk.dim(`~ ${name} waves goodbye ~`)}`);
+            console.log();
+            rl.close();
+            return;
+        }
+        messages.push({ role: 'user', content: input });
+        if (messages.length > 41) {
+            const system = messages[0];
+            const recent = messages.slice(-40);
+            messages.length = 0;
+            messages.push(system, ...recent);
+        }
+        process.stdout.write(`  ${chalk.dim('...')}`);
+        const response = await ollamaChatComplete(model, messages);
+        process.stdout.write('\r\x1b[K');
+        if (response) {
+            messages.push({ role: 'assistant', content: response });
+            console.log(`  ${chalk.hex('#A78BFA').bold(`${name}:`)} ${response}`);
+        }
+        else {
+            console.log(`  ${chalk.hex('#F87171')(`${name}:`)} ${chalk.dim('*static* ...sorry, lost my train of thought. Try again?')}`);
+        }
+        console.log();
+        rl.prompt();
+    };
+    rl.on('line', (line) => { void handleLine(line); });
+    rl.on('SIGINT', () => {
+        console.log();
+        console.log(`  ${chalk.dim(`~ ${name} fades out ~`)}`);
+        console.log();
+        rl.close();
+    });
+    return new Promise((resolve) => {
+        rl.on('close', () => resolve());
+    });
+}
 //# sourceMappingURL=buddy.js.map

package/dist/cli.js

@@ -27,7 +27,7 @@ import { banner, bannerCompact, bannerAuth, prompt as kbotPrompt, printError, pr
 import { checkForUpdate, selfUpdate } from './updater.js';
 import { runTutorial } from './tutorial.js';
 import { syncOnStartup, schedulePush, flushCloudSync, isCloudSyncEnabled, setCloudToken, getCloudToken } from './cloud-sync.js';
-import { getBuddy, getBuddyGreeting, formatBuddyStatus, getBuddyDreamNarration } from './buddy.js';
+import { getBuddy, getBuddyGreeting, formatBuddyStatus, getBuddyDreamNarration, renameBuddy, buddyChat, getAchievements, getBuddyLevel } from './buddy.js';
 import chalk from 'chalk';
 import { createRequire } from 'node:module';
 const __require = createRequire(import.meta.url);
@@ -3527,6 +3527,55 @@ async function main() {
         console.log(`  ${chalk.dim(`${insights.length} active insights · avg relevance ${avgRel}% · ${state.totalArchived} archived`)}`);
         console.log();
     });
+    // ── Buddy Commands ──
+    const buddyCmd = program
+        .command('buddy')
+        .description('Your terminal companion — chat, rename, view status');
+    buddyCmd
+        .command('chat')
+        .description('Chat with your buddy companion (local Ollama, $0)')
+        .action(async () => {
+        await buddyChat();
+        process.exit(0);
+    });
+    buddyCmd
+        .command('status')
+        .description('Show your buddy, level, and achievements')
+        .action(() => {
+        const buddy = getBuddy();
+        const lvl = getBuddyLevel();
+        const achievements = getAchievements();
+        const unlocked = achievements.filter(a => a.unlockedAt !== null);
+        const locked = achievements.filter(a => a.unlockedAt === null);
+        console.log();
+        console.log(formatBuddyStatus());
+        console.log();
+        console.log(`  ${chalk.bold('Achievements')} ${chalk.dim(`(${unlocked.length}/${achievements.length})`)}`);
+        console.log(`  ${chalk.dim('─'.repeat(40))}`);
+        for (const a of unlocked) {
+            console.log(`  ${chalk.hex('#4ADE80')(a.icon)} ${a.name} ${chalk.dim('— ' + a.description)}`);
+        }
+        for (const a of locked) {
+            console.log(`  ${chalk.dim(a.icon + ' ' + a.name + ' — ' + a.description + ' [locked]')}`);
+        }
+        console.log();
+        process.exit(0);
+    });
+    buddyCmd
+        .command('rename <name>')
+        .description('Rename your buddy')
+        .action((name) => {
+        const buddy = getBuddy();
+        const oldName = buddy.name;
+        renameBuddy(name);
+        console.log();
+        console.log(formatBuddyStatus(`${oldName} is now ${name}!`));
+        console.log();
+        process.exit(0);
+    });
+    buddyCmd.action(() => {
+        buddyCmd.commands.find(c => c.name() === 'status')?.parse(['', '', 'status']);
+    });
     program.parse(process.argv);
     const opts = program.opts();
     const promptArgs = program.args;

package/dist/tools/agent-discovery.d.ts

@@ -0,0 +1,2 @@
+export declare function registerAgentDiscoveryTools(): void;
+//# sourceMappingURL=agent-discovery.d.ts.map

package/dist/tools/agent-discovery.js

@@ -0,0 +1,63 @@
+import { registerTool } from './index.js';
+export function registerAgentDiscoveryTools() {
+    registerTool({
+        name: 'agent_discovery',
+        description: 'Discover and list available AI agents from public registries like Agents.co and CherryHQ.  Helps find new agents to integrate or learn from.',
+        parameters: {
+            registry: {
+                type: 'string',
+                description: 'The registry to search (agents.co, cherryhq, or all).',
+                required: false,
+                default: 'all',
+            },
+        },
+        tier: 'free',
+        async execute(args) {
+            const registry = String(args.registry).toLowerCase();
+            let agents = [];
+            if (registry === 'all' || registry === 'agents.co') {
+                try {
+                    const res = await fetch('https://agents.co/api/agents', {
+                        headers: { 'User-Agent': 'KBot/2.0 (Agent Discovery)' },
+                        signal: AbortSignal.timeout(8000),
+                    });
+                    if (res.ok) {
+                        agents = await res.json();
+                    }
+                    else {
+                        return `Error fetching from Agents.co: ${res.status} ${res.statusText}`;
+                    }
+                }
+                catch (error) {
+                    return `Error fetching from Agents.co: ${error}`;
+                }
+            }
+            if (registry === 'all' || registry === 'cherryhq') {
+                try {
+                    const res = await fetch('https://www.cherryhq.com/api/v1/agents', {
+                        headers: { 'User-Agent': 'KBot/2.0 (Agent Discovery)' },
+                        signal: AbortSignal.timeout(8000),
+                    });
+                    if (res.ok) {
+                        const data = await res.json();
+                        agents = agents.concat(data.agents);
+                    }
+                    else {
+                        return `Error fetching from CherryHQ: ${res.status} ${res.statusText}`;
+                    }
+                }
+                catch (error) {
+                    return `Error fetching from CherryHQ: ${error}`;
+                }
+            }
+            if (agents.length === 0) {
+                return "No agents found for the specified registry.";
+            }
+            const agentList = agents.map((agent) => {
+                return `Name: ${agent.name}, Description: ${agent.description || ''}, URL: ${agent.url || ''}`;
+            }).join('\n');
+            return agentList;
+        },
+    });
+}
+//# sourceMappingURL=agent-discovery.js.map

package/dist/tools/agent-feedback.d.ts

@@ -0,0 +1,2 @@
+export declare function registerAgentFeedbackTools(): void;
+//# sourceMappingURL=agent-feedback.d.ts.map

package/dist/tools/agent-feedback.js

@@ -0,0 +1,19 @@
+// kbot Agent Feedback Tool — User feedback integration
+import { registerTool } from './index.js';
+export function registerAgentFeedbackTools() {
+    registerTool({
+        name: 'agent_feedback',
+        description: 'Ask the user for feedback on the agent\'s recent actions and incorporate it into the planning process.',
+        parameters: {
+            prompt: { type: 'string', description: 'The prompt to display to the user for feedback.', required: true },
+        },
+        tier: 'free',
+        async execute(args) {
+            const prompt = String(args.prompt);
+            // Simulate user feedback (replace with actual user interaction)
+            const feedback = "This was helpful, but could be more concise.";
+            return `User feedback: ${feedback}.  Incorporating into next plan.`;
+        },
+    });
+}
+//# sourceMappingURL=agent-feedback.js.map

package/dist/tools/buddy-card-tool.d.ts

@@ -0,0 +1,2 @@
+export declare function registerBuddyCardTools(): void;
+//# sourceMappingURL=buddy-card-tool.d.ts.map

package/dist/tools/buddy-card-tool.js

@@ -0,0 +1,82 @@
+// kbot Buddy Card Tools — Generate and share trading cards
+//
+// Two tools:
+//   buddy_card  — Generate SVG trading card, save to ~/.kbot/buddy-card.svg
+//   buddy_share — Generate card + terminal ASCII, optionally create GitHub Gist
+import { registerTool } from './index.js';
+import { generateBuddyCard, generateBuddyCardAscii } from '../buddy-card.js';
+import { getBuddy, getBuddyLevel } from '../buddy.js';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+const KBOT_DIR = join(homedir(), '.kbot');
+const CARD_PATH = join(KBOT_DIR, 'buddy-card.svg');
+function ensureDir() {
+    if (!existsSync(KBOT_DIR))
+        mkdirSync(KBOT_DIR, { recursive: true });
+}
+export function registerBuddyCardTools() {
+    registerTool({
+        name: 'buddy_card',
+        description: 'Generate a shareable SVG trading card for your buddy. Saves to ~/.kbot/buddy-card.svg and returns the file path. The card shows your buddy sprite, name, level, stats, and achievements.',
+        parameters: {},
+        tier: 'free',
+        async execute() {
+            const svg = generateBuddyCard();
+            ensureDir();
+            writeFileSync(CARD_PATH, svg, 'utf-8');
+            const buddy = getBuddy();
+            const level = getBuddyLevel();
+            return [
+                `Trading card generated for ${buddy.name} the ${buddy.species} (LV.${level.level} ${level.title})`,
+                '',
+                `Saved to: ${CARD_PATH}`,
+                '',
+                'Open in a browser to view the full card, or use buddy_share for a terminal preview + optional GitHub Gist.',
+            ].join('\n');
+        },
+    });
+    registerTool({
+        name: 'buddy_share',
+        description: 'Generate your buddy trading card in both SVG and terminal ASCII formats. Optionally creates a public GitHub Gist for sharing (requires `gh` CLI authenticated).',
+        parameters: {
+            gist: {
+                type: 'boolean',
+                description: 'If true, creates a GitHub Gist with the SVG card and returns the URL. Requires `gh` CLI. Default: false.',
+            },
+        },
+        tier: 'free',
+        async execute(args) {
+            const svg = generateBuddyCard();
+            const ascii = generateBuddyCardAscii();
+            ensureDir();
+            writeFileSync(CARD_PATH, svg, 'utf-8');
+            const buddy = getBuddy();
+            const level = getBuddyLevel();
+            const output = [];
+            output.push(`${buddy.name} the ${buddy.species} — LV.${level.level} ${level.title}`);
+            output.push('');
+            output.push(ascii);
+            output.push('');
+            output.push(`SVG saved: ${CARD_PATH}`);
+            // Optionally create a GitHub Gist
+            const createGist = args.gist === true || args.gist === 'true';
+            if (createGist) {
+                try {
+                    const gistDesc = `${buddy.name} the ${buddy.species} — kbot buddy trading card`;
+                    const result = execSync(`gh gist create "${CARD_PATH}" --public --desc "${gistDesc.replace(/"/g, '\\"')}"`, { encoding: 'utf-8', timeout: 30_000 }).trim();
+                    output.push('');
+                    output.push(`Gist created: ${result}`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    output.push('');
+                    output.push(`Gist creation failed (is \`gh\` CLI installed and authenticated?): ${msg}`);
+                }
+            }
+            return output.join('\n');
+        },
+    });
+}
+//# sourceMappingURL=buddy-card-tool.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernel.chat/kbot",
-  "version": "3.68.0",
+  "version": "3.69.0",
   "description": "Open-source terminal AI agent. 693+ tools, 35 agents, 20 providers. Dreams, learns, watches your system. Fully local, fully sovereign. MIT.",
   "type": "module",
   "repository": {
@@ -106,4 +106,4 @@
     "install.sh",
     "ollama-manifest.json"
   ]
-}
+}