@dreb/coding-agent 1.16.0

package/dist/core/buddy/buddy-manager.js

@@ -0,0 +1,399 @@
+/**
+ * BuddyManager — Core state machine for the buddy companion.
+ *
+ * Handles: bone rolling, soul generation, persistence, Ollama availability checks.
+ * Bones are deterministic from hash(username + hostname + salt + rerollCount).
+ * Soul is LLM-generated once on first hatch and persisted to buddy.json.
+ */
+import { completeSimple } from "@dreb/ai";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { hostname } from "os";
+import { join } from "path";
+import { getAgentDir } from "../../config.js";
+import { createBuddyRng } from "./buddy-prng.js";
+import { rollEyes, rollHat, rollSpecies, rollStats } from "./buddy-species.js";
+import { STAT_NAMES } from "./buddy-types.js";
+const BUDDY_SALT = "dreb-buddy-v1";
+const BUDDY_FILENAME = "buddy.json";
+const DEFAULT_BACKSTORY = "A mysterious past shrouded in legend.";
+/** Base Ollama model config — id/name are set dynamically from available models */
+const OLLAMA_MODEL_BASE = {
+    api: "openai-completions",
+    provider: "ollama",
+    baseUrl: "http://localhost:11434/v1",
+    reasoning: false,
+    input: ["text"],
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    contextWindow: 128000,
+    maxTokens: 2048,
+    compat: {
+        supportsDeveloperRole: false,
+        supportsReasoningEffort: false,
+    },
+};
+/** Max words for buddy response before truncation */
+const MAX_RESPONSE_WORDS = 300;
+/** Prompt for soul generation (uses parent LLM, not Ollama) */
+const SOUL_GENERATION_PROMPT = `You are generating a companion character for a coding assistant terminal app. Based on the species, rarity, and stats below, generate a creative name, a one-sentence personality description, and a funny fictional backstory.
+
+Species: {species}
+Rarity: {rarity}
+Stats: {stats}
+Shiny: {shiny}
+
+The name must NOT be a common English word, programming keyword, tool name, or command. It should be unique and distinctive — a proper noun that won't appear in normal conversation. The name must be 4-8 characters and easy to type on a QWERTY keyboard — use only common letters (a-z, avoid q, x, z, j). Do not use species name as the name.
+
+Respond in EXACTLY this format:
+NAME: <name>
+PERSONALITY: <one sentence personality>
+BACKSTORY: <2-3 sentence elaborate fictional backstory — funny, absurd, or dramatic. Include specific events, places, former occupations>`;
+/** Prompt for buddy reactions via Ollama */
+const REACTION_PROMPT = `You are {name}, a {species} companion in a terminal coding app. You are {personality}. Your backstory: {backstory}
+
+Something just happened. React with a short, in-character quip based on the context below. Be specific — reference what actually happened, not just that something happened. Max 20 words. No quotes, no prefixes, just the quip.
+
+Context:
+{event}`;
+const NAME_CALL_PROMPT = `You are {name}, a {species} companion in a terminal coding app. You are {personality}. Your backstory: {backstory}
+
+The user just said: "{message}"
+Recent context: {context}
+
+Respond to what the user said directly. Be in-character, reference your backstory occasionally. Max 30 words. No quotes, no prefixes, just your response.`;
+/**
+ * Check if Ollama is running and has models available.
+ * Uses the /api/tags endpoint.
+ */
+export async function checkOllama() {
+    try {
+        const res = await fetch("http://localhost:11434/api/tags", { signal: AbortSignal.timeout(3000) });
+        if (!res.ok) {
+            return { available: false, models: [], error: `Ollama returned ${res.status}` };
+        }
+        const data = (await res.json());
+        const models = (data.models ?? []).map((m) => m.name);
+        if (models.length === 0) {
+            return { available: false, models: [], error: "No models installed. Run: ollama pull llama3.2" };
+        }
+        return { available: true, models };
+    }
+    catch {
+        return { available: false, models: [], error: "Ollama is not running. Start it with: ollama serve" };
+    }
+}
+/**
+ * Pick the Ollama model for the buddy.
+ * Returns the stored model name if it's available, otherwise null.
+ */
+function pickOllamaModel(storedModel, availableModels) {
+    if (!storedModel)
+        return null;
+    // Check if the stored model is installed (exact match or prefix match without tag)
+    const match = availableModels.find((m) => m === storedModel || m.startsWith(`${storedModel}:`));
+    return match ?? null;
+}
+/**
+ * Truncate response to a maximum word count, appending "...[truncated]" if exceeded.
+ */
+export function truncateResponse(text, maxWords) {
+    const words = text.split(/\s+/);
+    if (words.length <= maxWords)
+        return text;
+    return `${words.slice(0, maxWords).join(" ")} ...[truncated]`;
+}
+// =============================================================================
+// Persistence
+// =============================================================================
+function getBuddyPath() {
+    return join(getAgentDir(), BUDDY_FILENAME);
+}
+function loadStored() {
+    const path = getBuddyPath();
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, "utf-8"));
+        // Validate required fields
+        if (typeof data.rerollCount === "number" &&
+            typeof data.name === "string" &&
+            typeof data.personality === "string") {
+            return {
+                rerollCount: data.rerollCount,
+                name: data.name,
+                personality: data.personality,
+                backstory: typeof data.backstory === "string" ? data.backstory : DEFAULT_BACKSTORY,
+                hatchedAt: data.hatchedAt ?? new Date().toISOString(),
+                ...(data.hidden !== undefined ? { hidden: data.hidden } : {}),
+                ...(typeof data.ollamaModel === "string" ? { ollamaModel: data.ollamaModel } : {}),
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function saveStored(stored) {
+    const path = getBuddyPath();
+    const dir = join(path, "..");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(path, JSON.stringify(stored, null, 2));
+}
+// =============================================================================
+// Bone rolling
+// =============================================================================
+function rollBones(rerollCount) {
+    const username = process.env.USER ?? process.env.LOGNAME ?? "user";
+    const host = hostname();
+    const rng = createBuddyRng(username, host, BUDDY_SALT, rerollCount);
+    // Roll species + rarity
+    const { species, rarity } = rollSpecies(rng);
+    // Roll shiny (1% chance)
+    const shiny = rng() < 0.01;
+    // Roll eyes and hat
+    const eyes = rollEyes(rng);
+    const hat = rollHat(rng);
+    // Roll stats
+    const stats = rollStats(rng, rarity);
+    return { species, rarity, shiny, stats, eyeStyle: eyes, hat };
+}
+// =============================================================================
+// Soul generation
+// =============================================================================
+/**
+ * Generate a soul (name + personality + backstory) using the parent LLM.
+ * Only called on first hatch or reroll.
+ */
+async function generateSoul(bones, parentModel, apiKey) {
+    const statsStr = STAT_NAMES.map((s) => `${s}: ${bones.stats[s]}`).join(", ");
+    const prompt = SOUL_GENERATION_PROMPT.replace("{species}", bones.species)
+        .replace("{rarity}", bones.rarity)
+        .replace("{stats}", statsStr)
+        .replace("{shiny}", bones.shiny ? "YES ✨" : "no");
+    const context = {
+        systemPrompt: "Generate a companion character. Respond in the exact format requested.",
+        messages: [{ role: "user", content: prompt, timestamp: Date.now() }],
+    };
+    try {
+        const response = await completeSimple(parentModel, context, { apiKey });
+        const text = response.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("");
+        // Parse NAME: ... and PERSONALITY: ... and BACKSTORY: ...
+        const nameMatch = text.match(/NAME:\s*(.+)/i);
+        const personalityMatch = text.match(/PERSONALITY:\s*(.+)/i);
+        const backstoryMatch = text.match(/BACKSTORY:\s*([\s\S]+)/i);
+        let name = nameMatch?.[1]?.trim() ?? bones.species;
+        const personality = personalityMatch?.[1]?.trim() ?? `A ${bones.rarity} ${bones.species} companion.`;
+        const backstory = backstoryMatch?.[1]?.trim() ?? DEFAULT_BACKSTORY;
+        // Enforce name length
+        if (name.length > 8)
+            name = name.slice(0, 8);
+        return { name, personality, backstory };
+    }
+    catch {
+        // Fallback if LLM fails
+        return {
+            name: bones.species,
+            personality: `A ${bones.rarity} ${bones.species} companion.`,
+            backstory: DEFAULT_BACKSTORY,
+        };
+    }
+}
+// =============================================================================
+// BuddyManager
+// =============================================================================
+export class BuddyManager {
+    state = null;
+    ollamaStatus = null;
+    /** Get current buddy state (null if not loaded) */
+    getState() {
+        return this.state;
+    }
+    /** Check if buddy exists on disk */
+    hasStoredBuddy() {
+        return loadStored() !== null;
+    }
+    /**
+     * Load or create buddy state.
+     * If stored buddy exists, loads soul and re-rolls bones.
+     * If no stored buddy, returns null (need to hatch first).
+     */
+    load() {
+        const stored = loadStored();
+        if (!stored)
+            return null;
+        const bones = rollBones(stored.rerollCount);
+        this.state = { ...bones, ...stored };
+        return this.state;
+    }
+    /**
+     * Hatch a new buddy. Generates bones, then uses parent LLM for soul.
+     * Returns the new state.
+     */
+    async hatch(parentModel, apiKey) {
+        const stored = loadStored();
+        const rerollCount = stored?.rerollCount ?? 0;
+        const bones = rollBones(rerollCount);
+        const { name, personality, backstory } = await generateSoul(bones, parentModel, apiKey);
+        const newStored = {
+            rerollCount,
+            name,
+            personality,
+            backstory,
+            hatchedAt: new Date().toISOString(),
+            ...(stored?.ollamaModel ? { ollamaModel: stored.ollamaModel } : {}),
+        };
+        saveStored(newStored);
+        this.state = { ...bones, ...newStored };
+        return this.state;
+    }
+    /**
+     * Reroll the buddy — new bones + new soul.
+     */
+    async reroll(parentModel, apiKey) {
+        const stored = loadStored();
+        const newRerollCount = (stored?.rerollCount ?? 0) + 1;
+        const bones = rollBones(newRerollCount);
+        const { name, personality, backstory } = await generateSoul(bones, parentModel, apiKey);
+        const newStored = {
+            rerollCount: newRerollCount,
+            name,
+            personality,
+            backstory,
+            hatchedAt: new Date().toISOString(),
+            ...(stored?.ollamaModel ? { ollamaModel: stored.ollamaModel } : {}),
+        };
+        saveStored(newStored);
+        this.state = { ...bones, ...newStored };
+        return this.state;
+    }
+    /** Get buddy's name (for name-call detection) */
+    getName() {
+        return this.state?.name ?? loadStored()?.name ?? null;
+    }
+    /**
+     * Shared Ollama chat helper. Checks availability, picks model, runs completion.
+     * Returns the response text, or null if Ollama is unavailable or no model configured.
+     */
+    async ollamaChat(context) {
+        // Check Ollama lazily, retry if previously unavailable
+        if (!this.ollamaStatus || !this.ollamaStatus.available) {
+            this.ollamaStatus = await checkOllama();
+        }
+        if (!this.ollamaStatus.available)
+            return null;
+        const modelName = pickOllamaModel(this.state?.ollamaModel, this.ollamaStatus.models);
+        if (!modelName)
+            return null;
+        const model = {
+            ...OLLAMA_MODEL_BASE,
+            id: modelName,
+            name: `${modelName} (Ollama)`,
+        };
+        let response;
+        try {
+            response = await completeSimple(model, context, {
+                apiKey: "ollama",
+                signal: AbortSignal.timeout(120000),
+            });
+        }
+        catch {
+            // Safety net for unexpected sync errors (e.g. provider not found).
+            // Normal runtime errors (timeout, connection) are handled via stopReason below.
+            this.ollamaStatus = null;
+            return null;
+        }
+        // Connection error — invalidate cache so next attempt re-checks Ollama
+        if (response.stopReason === "error") {
+            this.ollamaStatus = null;
+            return null;
+        }
+        // Timeout or abort — preserve cache (model is just slow, Ollama is fine)
+        if (response.stopReason === "aborted") {
+            return null;
+        }
+        let text = response.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("")
+            .trim();
+        // Truncate overly long responses
+        text = truncateResponse(text, MAX_RESPONSE_WORDS);
+        return text || null;
+    }
+    /**
+     * Generate a reaction to an event using Ollama.
+     * Returns null if Ollama is unavailable.
+     */
+    async react(event) {
+        if (!this.state)
+            return null;
+        const prompt = REACTION_PROMPT.replace("{name}", this.state.name)
+            .replace("{species}", this.state.species)
+            .replace("{personality}", this.state.personality)
+            .replace("{backstory}", this.state.backstory)
+            .replace("{event}", event);
+        const context = {
+            systemPrompt: "Respond with a short in-character quip. Max 20 words.",
+            messages: [{ role: "user", content: prompt, timestamp: Date.now() }],
+        };
+        return this.ollamaChat(context);
+    }
+    /**
+     * Respond to the user calling the buddy's name.
+     * Uses Ollama for the response.
+     */
+    async respondToNameCall(userMessage, recentContext) {
+        if (!this.state)
+            return null;
+        const prompt = NAME_CALL_PROMPT.replace("{name}", this.state.name)
+            .replace("{species}", this.state.species)
+            .replace("{personality}", this.state.personality)
+            .replace("{backstory}", this.state.backstory)
+            .replace("{message}", userMessage)
+            .replace("{context}", recentContext);
+        const context = {
+            systemPrompt: "Respond with a short friendly greeting. Max 30 words.",
+            messages: [{ role: "user", content: prompt, timestamp: Date.now() }],
+        };
+        return this.ollamaChat(context);
+    }
+    /** Get the configured Ollama model name, or null if not set */
+    getOllamaModel() {
+        return this.state?.ollamaModel ?? loadStored()?.ollamaModel ?? null;
+    }
+    /** Set the Ollama model for buddy reactions. Persists to disk. */
+    setOllamaModel(modelName) {
+        const stored = loadStored();
+        if (stored) {
+            stored.ollamaModel = modelName;
+            saveStored(stored);
+        }
+        if (this.state) {
+            this.state.ollamaModel = modelName;
+        }
+        // Invalidate Ollama status cache so next call picks up the new model
+        this.ollamaStatus = null;
+    }
+    /** Reset Ollama status cache (e.g. after detecting it became available) */
+    resetOllamaCache() {
+        this.ollamaStatus = null;
+    }
+    /** Update the hidden flag in persisted storage */
+    setHidden(hidden) {
+        const stored = loadStored();
+        if (stored) {
+            stored.hidden = hidden;
+            saveStored(stored);
+        }
+        // Keep in-memory state in sync so reset() reads current hidden flag
+        if (this.state) {
+            this.state.hidden = hidden;
+        }
+    }
+}
+//# sourceMappingURL=buddy-manager.js.map

package/dist/core/buddy/buddy-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-manager.js","sourceRoot":"","sources":["../../../src/core/buddy/buddy-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * BuddyManager — Core state machine for the buddy companion.\n *\n * Handles: bone rolling, soul generation, persistence, Ollama availability checks.\n * Bones are deterministic from hash(username + hostname + salt + rerollCount).\n * Soul is LLM-generated once on first hatch and persisted to buddy.json.\n */\n\nimport type { Context, Model } from \"@dreb/ai\";\nimport { completeSimple } from \"@dreb/ai\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { hostname } from \"os\";\nimport { join } from \"path\";\nimport { getAgentDir } from \"../../config.js\";\nimport { createBuddyRng } from \"./buddy-prng.js\";\nimport { rollEyes, rollHat, rollSpecies, rollStats } from \"./buddy-species.js\";\nimport type { BuddyState, CompanionBones, StoredCompanion } from \"./buddy-types.js\";\nimport { STAT_NAMES } from \"./buddy-types.js\";\n\nconst BUDDY_SALT = \"dreb-buddy-v1\";\nconst BUDDY_FILENAME = \"buddy.json\";\nconst DEFAULT_BACKSTORY = \"A mysterious past shrouded in legend.\";\n\n/** Base Ollama model config — id/name are set dynamically from available models */\nconst OLLAMA_MODEL_BASE: Omit<Model<\"openai-completions\">, \"id\" | \"name\"> = {\n\tapi: \"openai-completions\",\n\tprovider: \"ollama\",\n\tbaseUrl: \"http://localhost:11434/v1\",\n\treasoning: false,\n\tinput: [\"text\"],\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\tcontextWindow: 128000,\n\tmaxTokens: 2048,\n\tcompat: {\n\t\tsupportsDeveloperRole: false,\n\t\tsupportsReasoningEffort: false,\n\t},\n};\n\n/** Max words for buddy response before truncation */\nconst MAX_RESPONSE_WORDS = 300;\n\n/** Prompt for soul generation (uses parent LLM, not Ollama) */\nconst SOUL_GENERATION_PROMPT = `You are generating a companion character for a coding assistant terminal app. Based on the species, rarity, and stats below, generate a creative name, a one-sentence personality description, and a funny fictional backstory.\n\nSpecies: {species}\nRarity: {rarity}\nStats: {stats}\nShiny: {shiny}\n\nThe name must NOT be a common English word, programming keyword, tool name, or command. It should be unique and distinctive — a proper noun that won't appear in normal conversation. The name must be 4-8 characters and easy to type on a QWERTY keyboard — use only common letters (a-z, avoid q, x, z, j). Do not use species name as the name.\n\nRespond in EXACTLY this format:\nNAME: <name>\nPERSONALITY: <one sentence personality>\nBACKSTORY: <2-3 sentence elaborate fictional backstory — funny, absurd, or dramatic. Include specific events, places, former occupations>`;\n\n/** Prompt for buddy reactions via Ollama */\nconst REACTION_PROMPT = `You are {name}, a {species} companion in a terminal coding app. You are {personality}. Your backstory: {backstory}\n\nSomething just happened. React with a short, in-character quip based on the context below. Be specific — reference what actually happened, not just that something happened. Max 20 words. No quotes, no prefixes, just the quip.\n\nContext:\n{event}`;\n\nconst NAME_CALL_PROMPT = `You are {name}, a {species} companion in a terminal coding app. You are {personality}. Your backstory: {backstory}\n\nThe user just said: \"{message}\"\nRecent context: {context}\n\nRespond to what the user said directly. Be in-character, reference your backstory occasionally. Max 30 words. No quotes, no prefixes, just your response.`;\n\n// =============================================================================\n// Ollama availability\n// =============================================================================\n\nexport interface OllamaStatus {\n\tavailable: boolean;\n\tmodels: string[];\n\terror?: string;\n}\n\n/**\n * Check if Ollama is running and has models available.\n * Uses the /api/tags endpoint.\n */\nexport async function checkOllama(): Promise<OllamaStatus> {\n\ttry {\n\t\tconst res = await fetch(\"http://localhost:11434/api/tags\", { signal: AbortSignal.timeout(3000) });\n\t\tif (!res.ok) {\n\t\t\treturn { available: false, models: [], error: `Ollama returned ${res.status}` };\n\t\t}\n\t\tconst data = (await res.json()) as { models?: { name: string }[] };\n\t\tconst models = (data.models ?? []).map((m) => m.name);\n\t\tif (models.length === 0) {\n\t\t\treturn { available: false, models: [], error: \"No models installed. Run: ollama pull llama3.2\" };\n\t\t}\n\t\treturn { available: true, models };\n\t} catch {\n\t\treturn { available: false, models: [], error: \"Ollama is not running. Start it with: ollama serve\" };\n\t}\n}\n\n/**\n * Pick the Ollama model for the buddy.\n * Returns the stored model name if it's available, otherwise null.\n */\nfunction pickOllamaModel(storedModel: string | undefined, availableModels: string[]): string | null {\n\tif (!storedModel) return null;\n\t// Check if the stored model is installed (exact match or prefix match without tag)\n\tconst match = availableModels.find((m) => m === storedModel || m.startsWith(`${storedModel}:`));\n\treturn match ?? null;\n}\n\n/**\n * Truncate response to a maximum word count, appending \"...[truncated]\" if exceeded.\n */\nexport function truncateResponse(text: string, maxWords: number): string {\n\tconst words = text.split(/\\s+/);\n\tif (words.length <= maxWords) return text;\n\treturn `${words.slice(0, maxWords).join(\" \")} ...[truncated]`;\n}\n\n// =============================================================================\n// Persistence\n// =============================================================================\n\nfunction getBuddyPath(): string {\n\treturn join(getAgentDir(), BUDDY_FILENAME);\n}\n\nfunction loadStored(): StoredCompanion | null {\n\tconst path = getBuddyPath();\n\tif (!existsSync(path)) return null;\n\ttry {\n\t\tconst data = JSON.parse(readFileSync(path, \"utf-8\"));\n\t\t// Validate required fields\n\t\tif (\n\t\t\ttypeof data.rerollCount === \"number\" &&\n\t\t\ttypeof data.name === \"string\" &&\n\t\t\ttypeof data.personality === \"string\"\n\t\t) {\n\t\t\treturn {\n\t\t\t\trerollCount: data.rerollCount,\n\t\t\t\tname: data.name,\n\t\t\t\tpersonality: data.personality,\n\t\t\t\tbackstory: typeof data.backstory === \"string\" ? data.backstory : DEFAULT_BACKSTORY,\n\t\t\t\thatchedAt: data.hatchedAt ?? new Date().toISOString(),\n\t\t\t\t...(data.hidden !== undefined ? { hidden: data.hidden } : {}),\n\t\t\t\t...(typeof data.ollamaModel === \"string\" ? { ollamaModel: data.ollamaModel } : {}),\n\t\t\t};\n\t\t}\n\t\treturn null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction saveStored(stored: StoredCompanion): void {\n\tconst path = getBuddyPath();\n\tconst dir = join(path, \"..\");\n\tif (!existsSync(dir)) {\n\t\tmkdirSync(dir, { recursive: true });\n\t}\n\twriteFileSync(path, JSON.stringify(stored, null, 2));\n}\n\n// =============================================================================\n// Bone rolling\n// =============================================================================\n\nfunction rollBones(rerollCount: number): CompanionBones {\n\tconst username = process.env.USER ?? process.env.LOGNAME ?? \"user\";\n\tconst host = hostname();\n\tconst rng = createBuddyRng(username, host, BUDDY_SALT, rerollCount);\n\n\t// Roll species + rarity\n\tconst { species, rarity } = rollSpecies(rng);\n\n\t// Roll shiny (1% chance)\n\tconst shiny = rng() < 0.01;\n\n\t// Roll eyes and hat\n\tconst eyes = rollEyes(rng);\n\tconst hat = rollHat(rng);\n\n\t// Roll stats\n\tconst stats = rollStats(rng, rarity);\n\n\treturn { species, rarity, shiny, stats, eyeStyle: eyes, hat };\n}\n\n// =============================================================================\n// Soul generation\n// =============================================================================\n\n/**\n * Generate a soul (name + personality + backstory) using the parent LLM.\n * Only called on first hatch or reroll.\n */\nasync function generateSoul(\n\tbones: CompanionBones,\n\tparentModel: Model<\"openai-completions\">,\n\tapiKey: string,\n): Promise<{ name: string; personality: string; backstory: string }> {\n\tconst statsStr = STAT_NAMES.map((s) => `${s}: ${bones.stats[s]}`).join(\", \");\n\tconst prompt = SOUL_GENERATION_PROMPT.replace(\"{species}\", bones.species)\n\t\t.replace(\"{rarity}\", bones.rarity)\n\t\t.replace(\"{stats}\", statsStr)\n\t\t.replace(\"{shiny}\", bones.shiny ? \"YES ✨\" : \"no\");\n\n\tconst context: Context = {\n\t\tsystemPrompt: \"Generate a companion character. Respond in the exact format requested.\",\n\t\tmessages: [{ role: \"user\", content: prompt, timestamp: Date.now() }],\n\t};\n\n\ttry {\n\t\tconst response = await completeSimple(parentModel, context, { apiKey });\n\t\tconst text = response.content\n\t\t\t.filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n\t\t\t.map((c) => c.text)\n\t\t\t.join(\"\");\n\n\t\t// Parse NAME: ... and PERSONALITY: ... and BACKSTORY: ...\n\t\tconst nameMatch = text.match(/NAME:\\s*(.+)/i);\n\t\tconst personalityMatch = text.match(/PERSONALITY:\\s*(.+)/i);\n\t\tconst backstoryMatch = text.match(/BACKSTORY:\\s*([\\s\\S]+)/i);\n\n\t\tlet name = nameMatch?.[1]?.trim() ?? bones.species;\n\t\tconst personality = personalityMatch?.[1]?.trim() ?? `A ${bones.rarity} ${bones.species} companion.`;\n\t\tconst backstory = backstoryMatch?.[1]?.trim() ?? DEFAULT_BACKSTORY;\n\n\t\t// Enforce name length\n\t\tif (name.length > 8) name = name.slice(0, 8);\n\n\t\treturn { name, personality, backstory };\n\t} catch {\n\t\t// Fallback if LLM fails\n\t\treturn {\n\t\t\tname: bones.species,\n\t\t\tpersonality: `A ${bones.rarity} ${bones.species} companion.`,\n\t\t\tbackstory: DEFAULT_BACKSTORY,\n\t\t};\n\t}\n}\n\n// =============================================================================\n// BuddyManager\n// =============================================================================\n\nexport class BuddyManager {\n\tprivate state: BuddyState | null = null;\n\tprivate ollamaStatus: OllamaStatus | null = null;\n\n\t/** Get current buddy state (null if not loaded) */\n\tgetState(): BuddyState | null {\n\t\treturn this.state;\n\t}\n\n\t/** Check if buddy exists on disk */\n\thasStoredBuddy(): boolean {\n\t\treturn loadStored() !== null;\n\t}\n\n\t/**\n\t * Load or create buddy state.\n\t * If stored buddy exists, loads soul and re-rolls bones.\n\t * If no stored buddy, returns null (need to hatch first).\n\t */\n\tload(): BuddyState | null {\n\t\tconst stored = loadStored();\n\t\tif (!stored) return null;\n\n\t\tconst bones = rollBones(stored.rerollCount);\n\t\tthis.state = { ...bones, ...stored };\n\t\treturn this.state;\n\t}\n\n\t/**\n\t * Hatch a new buddy. Generates bones, then uses parent LLM for soul.\n\t * Returns the new state.\n\t */\n\tasync hatch(parentModel: Model<\"openai-completions\">, apiKey: string): Promise<BuddyState> {\n\t\tconst stored = loadStored();\n\t\tconst rerollCount = stored?.rerollCount ?? 0;\n\n\t\tconst bones = rollBones(rerollCount);\n\t\tconst { name, personality, backstory } = await generateSoul(bones, parentModel, apiKey);\n\n\t\tconst newStored: StoredCompanion = {\n\t\t\trerollCount,\n\t\t\tname,\n\t\t\tpersonality,\n\t\t\tbackstory,\n\t\t\thatchedAt: new Date().toISOString(),\n\t\t\t...(stored?.ollamaModel ? { ollamaModel: stored.ollamaModel } : {}),\n\t\t};\n\n\t\tsaveStored(newStored);\n\t\tthis.state = { ...bones, ...newStored };\n\t\treturn this.state;\n\t}\n\n\t/**\n\t * Reroll the buddy — new bones + new soul.\n\t */\n\tasync reroll(parentModel: Model<\"openai-completions\">, apiKey: string): Promise<BuddyState> {\n\t\tconst stored = loadStored();\n\t\tconst newRerollCount = (stored?.rerollCount ?? 0) + 1;\n\n\t\tconst bones = rollBones(newRerollCount);\n\t\tconst { name, personality, backstory } = await generateSoul(bones, parentModel, apiKey);\n\n\t\tconst newStored: StoredCompanion = {\n\t\t\trerollCount: newRerollCount,\n\t\t\tname,\n\t\t\tpersonality,\n\t\t\tbackstory,\n\t\t\thatchedAt: new Date().toISOString(),\n\t\t\t...(stored?.ollamaModel ? { ollamaModel: stored.ollamaModel } : {}),\n\t\t};\n\n\t\tsaveStored(newStored);\n\t\tthis.state = { ...bones, ...newStored };\n\t\treturn this.state;\n\t}\n\n\t/** Get buddy's name (for name-call detection) */\n\tgetName(): string | null {\n\t\treturn this.state?.name ?? loadStored()?.name ?? null;\n\t}\n\n\t/**\n\t * Shared Ollama chat helper. Checks availability, picks model, runs completion.\n\t * Returns the response text, or null if Ollama is unavailable or no model configured.\n\t */\n\tprivate async ollamaChat(context: Context): Promise<string | null> {\n\t\t// Check Ollama lazily, retry if previously unavailable\n\t\tif (!this.ollamaStatus || !this.ollamaStatus.available) {\n\t\t\tthis.ollamaStatus = await checkOllama();\n\t\t}\n\t\tif (!this.ollamaStatus.available) return null;\n\n\t\tconst modelName = pickOllamaModel(this.state?.ollamaModel, this.ollamaStatus.models);\n\t\tif (!modelName) return null;\n\t\tconst model: Model<\"openai-completions\"> = {\n\t\t\t...OLLAMA_MODEL_BASE,\n\t\t\tid: modelName,\n\t\t\tname: `${modelName} (Ollama)`,\n\t\t};\n\n\t\tlet response: import(\"@dreb/ai\").AssistantMessage;\n\t\ttry {\n\t\t\tresponse = await completeSimple(model, context, {\n\t\t\t\tapiKey: \"ollama\",\n\t\t\t\tsignal: AbortSignal.timeout(120000),\n\t\t\t});\n\t\t} catch {\n\t\t\t// Safety net for unexpected sync errors (e.g. provider not found).\n\t\t\t// Normal runtime errors (timeout, connection) are handled via stopReason below.\n\t\t\tthis.ollamaStatus = null;\n\t\t\treturn null;\n\t\t}\n\n\t\t// Connection error — invalidate cache so next attempt re-checks Ollama\n\t\tif (response.stopReason === \"error\") {\n\t\t\tthis.ollamaStatus = null;\n\t\t\treturn null;\n\t\t}\n\n\t\t// Timeout or abort — preserve cache (model is just slow, Ollama is fine)\n\t\tif (response.stopReason === \"aborted\") {\n\t\t\treturn null;\n\t\t}\n\n\t\tlet text = response.content\n\t\t\t.filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n\t\t\t.map((c) => c.text)\n\t\t\t.join(\"\")\n\t\t\t.trim();\n\n\t\t// Truncate overly long responses\n\t\ttext = truncateResponse(text, MAX_RESPONSE_WORDS);\n\n\t\treturn text || null;\n\t}\n\n\t/**\n\t * Generate a reaction to an event using Ollama.\n\t * Returns null if Ollama is unavailable.\n\t */\n\tasync react(event: string): Promise<string | null> {\n\t\tif (!this.state) return null;\n\n\t\tconst prompt = REACTION_PROMPT.replace(\"{name}\", this.state.name)\n\t\t\t.replace(\"{species}\", this.state.species)\n\t\t\t.replace(\"{personality}\", this.state.personality)\n\t\t\t.replace(\"{backstory}\", this.state.backstory)\n\t\t\t.replace(\"{event}\", event);\n\n\t\tconst context: Context = {\n\t\t\tsystemPrompt: \"Respond with a short in-character quip. Max 20 words.\",\n\t\t\tmessages: [{ role: \"user\", content: prompt, timestamp: Date.now() }],\n\t\t};\n\n\t\treturn this.ollamaChat(context);\n\t}\n\n\t/**\n\t * Respond to the user calling the buddy's name.\n\t * Uses Ollama for the response.\n\t */\n\tasync respondToNameCall(userMessage: string, recentContext: string): Promise<string | null> {\n\t\tif (!this.state) return null;\n\n\t\tconst prompt = NAME_CALL_PROMPT.replace(\"{name}\", this.state.name)\n\t\t\t.replace(\"{species}\", this.state.species)\n\t\t\t.replace(\"{personality}\", this.state.personality)\n\t\t\t.replace(\"{backstory}\", this.state.backstory)\n\t\t\t.replace(\"{message}\", userMessage)\n\t\t\t.replace(\"{context}\", recentContext);\n\n\t\tconst context: Context = {\n\t\t\tsystemPrompt: \"Respond with a short friendly greeting. Max 30 words.\",\n\t\t\tmessages: [{ role: \"user\", content: prompt, timestamp: Date.now() }],\n\t\t};\n\n\t\treturn this.ollamaChat(context);\n\t}\n\n\t/** Get the configured Ollama model name, or null if not set */\n\tgetOllamaModel(): string | null {\n\t\treturn this.state?.ollamaModel ?? loadStored()?.ollamaModel ?? null;\n\t}\n\n\t/** Set the Ollama model for buddy reactions. Persists to disk. */\n\tsetOllamaModel(modelName: string): void {\n\t\tconst stored = loadStored();\n\t\tif (stored) {\n\t\t\tstored.ollamaModel = modelName;\n\t\t\tsaveStored(stored);\n\t\t}\n\t\tif (this.state) {\n\t\t\tthis.state.ollamaModel = modelName;\n\t\t}\n\t\t// Invalidate Ollama status cache so next call picks up the new model\n\t\tthis.ollamaStatus = null;\n\t}\n\n\t/** Reset Ollama status cache (e.g. after detecting it became available) */\n\tresetOllamaCache(): void {\n\t\tthis.ollamaStatus = null;\n\t}\n\n\t/** Update the hidden flag in persisted storage */\n\tsetHidden(hidden: boolean): void {\n\t\tconst stored = loadStored();\n\t\tif (stored) {\n\t\t\tstored.hidden = hidden;\n\t\t\tsaveStored(stored);\n\t\t}\n\t\t// Keep in-memory state in sync so reset() reads current hidden flag\n\t\tif (this.state) {\n\t\t\tthis.state.hidden = hidden;\n\t\t}\n\t}\n}\n"]}

package/dist/core/buddy/buddy-prng.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Mulberry32 PRNG and FNV-1a hash for deterministic buddy generation.
+ * Bones are derived from hash(username + hostname + salt + rerollCount) on every session start.
+ */
+/** FNV-1a 32-bit hash of a string */
+export declare function fnv1a(str: string): number;
+/** Mulberry32 PRNG — fast, deterministic 32-bit */
+export declare function mulberry32(seed: number): () => number;
+/**
+ * Create a PRNG seeded from user identity + salt + reroll count.
+ * This ensures the same user gets the same buddy unless they reroll.
+ */
+export declare function createBuddySeed(username: string, hostname: string, salt: string, rerollCount: number): number;
+/**
+ * Create a PRNG from user identity. Returns a function that produces
+ * floats in [0, 1).
+ */
+export declare function createBuddyRng(username: string, hostname: string, salt: string, rerollCount: number): () => number;
+/** Roll an integer in [min, max] inclusive using the given RNG */
+export declare function rollInt(rng: () => number, min: number, max: number): number;
+/** Roll a float in [min, max) using the given RNG */
+export declare function rollFloat(rng: () => number, min: number, max: number): number;
+/**
+ * Pick a weighted item from a map of item -> weight.
+ * Returns the key whose cumulative weight contains the roll.
+ */
+export declare function rollWeighted<T extends string>(rng: () => number, weights: Record<T, number>): T;
+//# sourceMappingURL=buddy-prng.d.ts.map

package/dist/core/buddy/buddy-prng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-prng.d.ts","sourceRoot":"","sources":["../../../src/core/buddy/buddy-prng.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOzC;AAED,qDAAmD;AACnD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG7G;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,MAAM,CAElH;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAW/F","sourcesContent":["/**\n * Mulberry32 PRNG and FNV-1a hash for deterministic buddy generation.\n * Bones are derived from hash(username + hostname + salt + rerollCount) on every session start.\n */\n\n/** FNV-1a 32-bit hash of a string */\nexport function fnv1a(str: string): number {\n\tlet hash = 0x811c9dc5;\n\tfor (let i = 0; i < str.length; i++) {\n\t\thash ^= str.charCodeAt(i);\n\t\thash = Math.imul(hash, 0x01000193);\n\t}\n\treturn hash >>> 0;\n}\n\n/** Mulberry32 PRNG — fast, deterministic 32-bit */\nexport function mulberry32(seed: number): () => number {\n\tlet state = seed;\n\treturn () => {\n\t\tstate |= 0;\n\t\tstate = (state + 0x6d2b79f5) | 0;\n\t\tlet t = Math.imul(state ^ (state >>> 15), 1 | state);\n\t\tt = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n\t\treturn ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n\t};\n}\n\n/**\n * Create a PRNG seeded from user identity + salt + reroll count.\n * This ensures the same user gets the same buddy unless they reroll.\n */\nexport function createBuddySeed(username: string, hostname: string, salt: string, rerollCount: number): number {\n\tconst input = `${username}@${hostname}:${salt}:${rerollCount}`;\n\treturn fnv1a(input);\n}\n\n/**\n * Create a PRNG from user identity. Returns a function that produces\n * floats in [0, 1).\n */\nexport function createBuddyRng(username: string, hostname: string, salt: string, rerollCount: number): () => number {\n\treturn mulberry32(createBuddySeed(username, hostname, salt, rerollCount));\n}\n\n/** Roll an integer in [min, max] inclusive using the given RNG */\nexport function rollInt(rng: () => number, min: number, max: number): number {\n\treturn Math.floor(rng() * (max - min + 1)) + min;\n}\n\n/** Roll a float in [min, max) using the given RNG */\nexport function rollFloat(rng: () => number, min: number, max: number): number {\n\treturn rng() * (max - min) + min;\n}\n\n/**\n * Pick a weighted item from a map of item -> weight.\n * Returns the key whose cumulative weight contains the roll.\n */\nexport function rollWeighted<T extends string>(rng: () => number, weights: Record<T, number>): T {\n\tconst entries = Object.entries(weights) as [T, number][];\n\tconst total = entries.reduce((a, b) => a + b[1], 0);\n\tlet roll = rng() * total;\n\tfor (const [key, weight] of entries) {\n\t\troll -= weight;\n\t\tif (roll <= 0) return key;\n\t}\n\t// Fallback to last key (floating point edge case)\n\tconst keys = Object.keys(weights) as T[];\n\treturn keys[keys.length - 1];\n}\n"]}

package/dist/core/buddy/buddy-prng.js

@@ -0,0 +1,65 @@
+/**
+ * Mulberry32 PRNG and FNV-1a hash for deterministic buddy generation.
+ * Bones are derived from hash(username + hostname + salt + rerollCount) on every session start.
+ */
+/** FNV-1a 32-bit hash of a string */
+export function fnv1a(str) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+/** Mulberry32 PRNG — fast, deterministic 32-bit */
+export function mulberry32(seed) {
+    let state = seed;
+    return () => {
+        state |= 0;
+        state = (state + 0x6d2b79f5) | 0;
+        let t = Math.imul(state ^ (state >>> 15), 1 | state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/**
+ * Create a PRNG seeded from user identity + salt + reroll count.
+ * This ensures the same user gets the same buddy unless they reroll.
+ */
+export function createBuddySeed(username, hostname, salt, rerollCount) {
+    const input = `${username}@${hostname}:${salt}:${rerollCount}`;
+    return fnv1a(input);
+}
+/**
+ * Create a PRNG from user identity. Returns a function that produces
+ * floats in [0, 1).
+ */
+export function createBuddyRng(username, hostname, salt, rerollCount) {
+    return mulberry32(createBuddySeed(username, hostname, salt, rerollCount));
+}
+/** Roll an integer in [min, max] inclusive using the given RNG */
+export function rollInt(rng, min, max) {
+    return Math.floor(rng() * (max - min + 1)) + min;
+}
+/** Roll a float in [min, max) using the given RNG */
+export function rollFloat(rng, min, max) {
+    return rng() * (max - min) + min;
+}
+/**
+ * Pick a weighted item from a map of item -> weight.
+ * Returns the key whose cumulative weight contains the roll.
+ */
+export function rollWeighted(rng, weights) {
+    const entries = Object.entries(weights);
+    const total = entries.reduce((a, b) => a + b[1], 0);
+    let roll = rng() * total;
+    for (const [key, weight] of entries) {
+        roll -= weight;
+        if (roll <= 0)
+            return key;
+    }
+    // Fallback to last key (floating point edge case)
+    const keys = Object.keys(weights);
+    return keys[keys.length - 1];
+}
+//# sourceMappingURL=buddy-prng.js.map

package/dist/core/buddy/buddy-prng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-prng.js","sourceRoot":"","sources":["../../../src/core/buddy/buddy-prng.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mulberry32 PRNG and FNV-1a hash for deterministic buddy generation.\n * Bones are derived from hash(username + hostname + salt + rerollCount) on every session start.\n */\n\n/** FNV-1a 32-bit hash of a string */\nexport function fnv1a(str: string): number {\n\tlet hash = 0x811c9dc5;\n\tfor (let i = 0; i < str.length; i++) {\n\t\thash ^= str.charCodeAt(i);\n\t\thash = Math.imul(hash, 0x01000193);\n\t}\n\treturn hash >>> 0;\n}\n\n/** Mulberry32 PRNG — fast, deterministic 32-bit */\nexport function mulberry32(seed: number): () => number {\n\tlet state = seed;\n\treturn () => {\n\t\tstate |= 0;\n\t\tstate = (state + 0x6d2b79f5) | 0;\n\t\tlet t = Math.imul(state ^ (state >>> 15), 1 | state);\n\t\tt = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n\t\treturn ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n\t};\n}\n\n/**\n * Create a PRNG seeded from user identity + salt + reroll count.\n * This ensures the same user gets the same buddy unless they reroll.\n */\nexport function createBuddySeed(username: string, hostname: string, salt: string, rerollCount: number): number {\n\tconst input = `${username}@${hostname}:${salt}:${rerollCount}`;\n\treturn fnv1a(input);\n}\n\n/**\n * Create a PRNG from user identity. Returns a function that produces\n * floats in [0, 1).\n */\nexport function createBuddyRng(username: string, hostname: string, salt: string, rerollCount: number): () => number {\n\treturn mulberry32(createBuddySeed(username, hostname, salt, rerollCount));\n}\n\n/** Roll an integer in [min, max] inclusive using the given RNG */\nexport function rollInt(rng: () => number, min: number, max: number): number {\n\treturn Math.floor(rng() * (max - min + 1)) + min;\n}\n\n/** Roll a float in [min, max) using the given RNG */\nexport function rollFloat(rng: () => number, min: number, max: number): number {\n\treturn rng() * (max - min) + min;\n}\n\n/**\n * Pick a weighted item from a map of item -> weight.\n * Returns the key whose cumulative weight contains the roll.\n */\nexport function rollWeighted<T extends string>(rng: () => number, weights: Record<T, number>): T {\n\tconst entries = Object.entries(weights) as [T, number][];\n\tconst total = entries.reduce((a, b) => a + b[1], 0);\n\tlet roll = rng() * total;\n\tfor (const [key, weight] of entries) {\n\t\troll -= weight;\n\t\tif (roll <= 0) return key;\n\t}\n\t// Fallback to last key (floating point edge case)\n\tconst keys = Object.keys(weights) as T[];\n\treturn keys[keys.length - 1];\n}\n"]}

package/dist/core/buddy/buddy-species.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Species pool, eye styles, hats, and ASCII art frames for the buddy companion.
+ *
+ * Each species has 3 animation frames using {E} as eye placeholder.
+ * Frames cycle at 500ms for idle animation.
+ */
+import { Rarity, type SpeciesName, type Stat } from "./buddy-types.js";
+export interface SpeciesDef {
+    name: SpeciesName;
+    frames: string[][];
+    rarityFloor: Rarity;
+}
+export declare const ALL_SPECIES: SpeciesName[];
+/**
+ * Roll a species from the species pool based on rarity.
+ * Species can only appear if the rolled rarity meets their floor.
+ */
+export declare function rollSpecies(rng: () => number): {
+    species: SpeciesName;
+    rarity: Rarity;
+};
+/** Roll an eye style */
+export declare function rollEyes(rng: () => number): string;
+/** Roll a hat */
+export declare function rollHat(rng: () => number): string;
+/**
+ * Roll RPG-style stats: one peak, one dump, three random.
+ * Peak can hit 100, dump near floor.
+ */
+export declare function rollStats(rng: () => number, rarity: Rarity): Record<Stat, number>;
+/** Get the 3 animation frames for a species */
+export declare function getSpeciesFrames(species: SpeciesName): string[][];
+/** Replace {E} placeholder with actual eye character */
+export declare function applyEyes(frame: string[], eyes: string): string[];
+/** Get the maximum width of a species' frames */
+export declare function getSpeciesWidth(species: SpeciesName): number;
+//# sourceMappingURL=buddy-species.d.ts.map