@dreb/coding-agent 1.16.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-species.d.ts","sourceRoot":"","sources":["../../../src/core/buddy/buddy-species.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAoC,MAAM,EAAE,KAAK,WAAW,EAAc,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAMrH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AA2KD,eAAO,MAAM,WAAW,eAA6C,CAAC;AAYtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsBvF;AAMD,wBAAwB;AACxB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAGlD;AAED,iBAAiB;AACjB,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAGjD;AAsBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAyBjF;AAMD,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,EAAE,CAEjE;AAED,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAS5D","sourcesContent":["/**\n * Species pool, eye styles, hats, and ASCII art frames for the buddy companion.\n *\n * Each species has 3 animation frames using {E} as eye placeholder.\n * Frames cycle at 500ms for idle animation.\n */\n\nimport { rollWeighted } from \"./buddy-prng.js\";\nimport { EYE_STYLES, HATS, RARITY_WEIGHTS, Rarity, type SpeciesName, STAT_NAMES, type Stat } from \"./buddy-types.js\";\n\n// =============================================================================\n// Species Definitions — 18 species with ASCII art\n// =============================================================================\n\nexport interface SpeciesDef {\n\tname: SpeciesName;\n\tframes: string[][]; // 3 frames, each is string[] (lines)\n\trarityFloor: Rarity; // minimum rarity this species can appear at\n}\n\n/**\n * All 18 species with 3 animation frames each.\n * {E} is replaced at render time with the buddy's eye style.\n */\nconst SPECIES_DEFS: Record<SpeciesName, SpeciesDef> = {\n\tDuck: {\n\t\tname: \"Duck\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"   __     \", \"  {E}{E}    \", \" <  \\\\    \", \"  \\\\__\\\\   \", '  \"\"\"\"   '],\n\t\t\t[\"   __     \", \"  {E}{E}    \", \" <  \\\\    \", \"  \\\\__\\\\   \", '  \"\"\"\"   '],\n\t\t\t[\"   __     \", \"  {E}{E}    \", \" <  \\\\    \", \"  \\\\__\\\\   \", \"   ~~    \"],\n\t\t],\n\t},\n\tGoose: {\n\t\tname: \"Goose\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"     __   \", \"   {E}{E}   \", \"  <  \\\\   \", \"   \\\\__\\\\  \", '   \"\"\"\"  '],\n\t\t\t[\"    __    \", \"  {E}{E}   \", \" <  \\\\    \", \"  \\\\__\\\\   \", '  \"\"\"\"   '],\n\t\t\t[\"   __     \", \" {E}{E}    \", \"<  \\\\     \", \" \\\\__\\\\    \", ' \"\"\"\"    '],\n\t\t],\n\t},\n\tBlob: {\n\t\tname: \"Blob\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"  .---.  \", \" / {E}{E}\\\\ \", \"|  >  | \", \" \\\\ --- / \", \"  '---'  \"],\n\t\t\t[\"  .---.  \", \" / {E}{E}\\\\ \", \"|  <  | \", \" \\\\ --- / \", \"  '---'  \"],\n\t\t\t[\"  .---.  \", \" / o o\\\\ \", \"|  ~  | \", \" \\\\ -~- / \", \"  '---'  \"],\n\t\t],\n\t},\n\tCat: {\n\t\tname: \"Cat\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\" /\\\\_/\\\\  \", \"( {E}.{E} ) \", \" >  ^ <  \", \"  \\\\___/  \"],\n\t\t\t[\" /\\\\_/\\\\  \", \"( {E}-{E} ) \", \" >  = <  \", \"  \\\\___/  \"],\n\t\t\t[\" /\\\\_/\\\\  \", \"( {E}.{E} ) \", \" >    <  \", \"  \\\\___/  \"],\n\t\t],\n\t},\n\tDragon: {\n\t\tname: \"Dragon\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"    /\\\\    \", \"   /  \\\\   \", \"  /{E}{E}\\\\  \", \" / --  \\\\  \", \"/ /|  |\\\\\\\\ \", \"  \\\\ || /  \", \"   \\\\||/   \"],\n\t\t\t[\"    /\\\\    \", \"   /  \\\\   \", \"  /{E}{E}\\\\  \", \" / ~~  \\\\  \", \"/ /|  |\\\\ \\\\ \", \"  \\\\ || /  \", \"   \\\\||/   \"],\n\t\t\t[\"    /\\\\    \", \"   /  \\\\   \", \"  /{E}{E}\\\\  \", \" / --  \\\\  \", \"/ /|  |\\\\ \\\\ \", \"  \\\\ || /  \", \"    ||    \"],\n\t\t],\n\t},\n\tOctopus: {\n\t\tname: \"Octopus\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"   _  _   \", \"  {E}{E}   \", \" /| /|\\\\|  \", \"/ | \\\\ | \\\\ \", \"  |  | |  \"],\n\t\t\t[\"   _  _   \", \"  {E}{E}   \", \"\\\\| /|\\\\|/  \", \" | \\\\ | /| \", \"  |  | |  \"],\n\t\t\t[\"   _  _   \", \"  {E}{E}   \", \" /| /|\\\\|  \", \"  | \\\\ | \\\\ \", \" \\\\|  | |  \"],\n\t\t],\n\t},\n\tOwl: {\n\t\tname: \"Owl\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"  ,___,   \", \"  {E}{E}   \", \"  ([V])   \", ' ,\"   \",  ', \"  \\\\___/   \"],\n\t\t\t[\"  ,___,   \", \"  {E}{E}   \", \"  ([_])   \", ' ,\"   \",  ', \"  \\\\___/   \"],\n\t\t\t[\"  ,___,   \", \"  {E}{E}   \", \"  ([v])   \", ' ,\"   \",  ', \"  \\\\___/   \"],\n\t\t],\n\t},\n\tPenguin: {\n\t\tname: \"Penguin\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"   (°)   \", \"  /{E}{E}\\\\  \", \" / __  \\\\ \", \" \\\\    /  \", \"  \\\\__/   \"],\n\t\t\t[\"   (°)   \", \"  /{E}{E}\\\\  \", \" / __  \\\\ \", \" \\\\_  _/  \", \"   ||    \"],\n\t\t\t[\"   (°)   \", \"  /{E}{E}\\\\  \", \" / __  \\\\ \", \" \\\\    /  \", \"   ||    \"],\n\t\t],\n\t},\n\tTurtle: {\n\t\tname: \"Turtle\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"     ___  \", \"    {E}{E}  \", '  .-\"\"\"-. ', \" /  ___  \\\\\", \" \\\\_______/\", \"    ||    \"],\n\t\t\t[\"     ___  \", \"    {E}{E}  \", '  .-\"\"\"-. ', \" /  ___  \\\\\", \" \\\\_______/\", \"    ||    \"],\n\t\t\t[\"     ___  \", \"   _{E}{E}_ \", '  .-\"\"\"-. ', \" /  ___  \\\\\", \" \\\\_______/\", \"    ||    \"],\n\t\t],\n\t},\n\tSnail: {\n\t\tname: \"Snail\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"    ____  \", \"   /    \\\\ \", \"  | {E}{E} | \", \"  |  __  |\", \"   \\\\    / \", \"    ~~    \"],\n\t\t\t[\"    ____  \", \"   /    \\\\ \", \"  | {E}{E} | \", \"  |  __  |\", \"   \\\\    / \", \"    ~~    \"],\n\t\t\t[\"    ____  \", \"   /    \\\\ \", \"  | {E} {E}| \", \"  |  __  |\", \"   \\\\    / \", \"    ~~    \"],\n\t\t],\n\t},\n\tGhost: {\n\t\tname: \"Ghost\",\n\t\trarityFloor: Rarity.RARE,\n\t\tframes: [\n\t\t\t[\"   .---.  \", \"  / {E}{E}\\\\ \", \" |  >  | \", \" |     | \", \"  \\\\~~~~/ \", \"   ~~~~   \"],\n\t\t\t[\"   .---.  \", \"  / {E}{E}\\\\ \", \" |  ~  | \", \" |     | \", \"  \\\\ ~~~/ \", \"   ~~~~   \"],\n\t\t\t[\"   .---.  \", \"  / o o\\\\ \", \" |  _  | \", \" |     | \", \"  \\\\~~~~/ \", \"   ~~~~   \"],\n\t\t],\n\t},\n\tAxolotl: {\n\t\tname: \"Axolotl\",\n\t\trarityFloor: Rarity.RARE,\n\t\tframes: [\n\t\t\t[\"   \\\\||/   \", \"  //{E}{E}\\\\\\\\  \", \"  || > || \", \"  \\\\\\\\__//  \", '   \"||\"   '],\n\t\t\t[\"   \\\\||/   \", \"  //{E}{E}\\\\\\\\  \", \"  || < || \", \"  \\\\\\\\__//  \", '   \"||\"   '],\n\t\t\t[\"   \\\\||/   \", \"  //{E}{E}\\\\\\\\  \", \"  || w || \", \"  \\\\\\\\__//  \", '   \"||\"   '],\n\t\t],\n\t},\n\tCapybara: {\n\t\tname: \"Capybara\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"  _    _  \", \" {E}{E}  \", \"  >    <  \", \"  \\\\____/  \", \"   || ||  \"],\n\t\t\t[\"  _    _  \", \" {E}{E}  \", \"  >    <  \", \"  \\\\____/  \", \"   || ||  \"],\n\t\t\t[\"  _    _  \", \" {E} {E} \", \"  > w  <  \", \"  \\\\____/  \", \"   || ||  \"],\n\t\t],\n\t},\n\tCactus: {\n\t\tname: \"Cactus\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"    _    \", \"  _{E}{E}_  \", \" |  >  | \", \"_|     |_\", \" |     | \", \" |_____| \", \"   |||   \"],\n\t\t\t[\"    _    \", \"  _{E}{E}_  \", \" |  <  | \", \"_|     |_\", \" |     | \", \" |_____| \", \"   |||   \"],\n\t\t\t[\"    _    \", \"  _{E}{E}_  \", \" |  ~  | \", \"_|     |_\", \" |     | \", \" |_____| \", \"   |||   \"],\n\t\t],\n\t},\n\tRobot: {\n\t\tname: \"Robot\",\n\t\trarityFloor: Rarity.EPIC,\n\t\tframes: [\n\t\t\t[\"  [===]  \", \"  |{E}{E}|  \", \"  | __ | \", \"  |____| \", \"   |  |  \"],\n\t\t\t[\"  [===]  \", \"  |{E}{E}|  \", \"  | -- | \", \"  |____| \", \"   |  |  \"],\n\t\t\t[\"  [===]  \", \"  |{E}{E}|  \", \"  | ~~ | \", \"  |____| \", \"   |  |  \"],\n\t\t],\n\t},\n\tRabbit: {\n\t\tname: \"Rabbit\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"  /\\\\_/\\\\  \", \" /{E}{E}\\\\ \", \" |  > |  \", \"  \\\\__/   \", \"  /  \\\\   \"],\n\t\t\t[\"  /\\\\_/\\\\  \", \" /{E}{E}\\\\ \", \" |  < |  \", \"  \\\\__/   \", \"  /  \\\\   \"],\n\t\t\t[\"  /\\\\_/\\\\  \", \" /{E}{E}\\\\ \", \" | ~  |  \", \"  \\\\__/   \", \"   ||    \"],\n\t\t],\n\t},\n\tMushroom: {\n\t\tname: \"Mushroom\",\n\t\trarityFloor: Rarity.RARE,\n\t\tframes: [\n\t\t\t[\"   .--.  \", \"  /{E}{E}\\\\ \", \" |  >  | \", \"  \\\\--/   \", \"   ||    \", \"  _||_   \"],\n\t\t\t[\"   .--.  \", \"  /{E}{E}\\\\ \", \" |  <  | \", \"  \\\\--/   \", \"   ||    \", \"  _||_   \"],\n\t\t\t[\"   .--.  \", \"  /{E}{E}\\\\ \", \" |  ~  | \", \"  \\\\--/   \", \"   ||    \", \"  _||_   \"],\n\t\t],\n\t},\n\tChonk: {\n\t\tname: \"Chonk\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"  .----.  \", \" / {E}{E}\\\\  \", \"|  >   | \", \"|      | \", \" \\\\____/  \"],\n\t\t\t[\"  .----.  \", \" / {E}{E}\\\\  \", \"|  <   | \", \"|      | \", \" \\\\____/  \"],\n\t\t\t[\"  .----.  \", \" / {E}{E}\\\\  \", \"|  w   | \", \"|      | \", \" \\\\____/  \"],\n\t\t],\n\t},\n};\n\nexport const ALL_SPECIES = Object.keys(SPECIES_DEFS) as SpeciesName[];\n\n// =============================================================================\n// Species selection with rarity weighting\n// =============================================================================\n\n/** Species rarity multipliers — rarer species need at least that rarity roll */\nconst SPECIES_RARITY_FLOORS: Partial<Record<SpeciesName, Rarity>> = {};\nfor (const def of Object.values(SPECIES_DEFS)) {\n\tSPECIES_RARITY_FLOORS[def.name] = def.rarityFloor;\n}\n\n/**\n * Roll a species from the species pool based on rarity.\n * Species can only appear if the rolled rarity meets their floor.\n */\nexport function rollSpecies(rng: () => number): { species: SpeciesName; rarity: Rarity } {\n\t// First roll rarity\n\tconst rarity = rollWeighted(rng, RARITY_WEIGHTS);\n\n\t// Filter species available at this rarity tier\n\tconst rarityOrder = [Rarity.COMMON, Rarity.UNCOMMON, Rarity.RARE, Rarity.EPIC, Rarity.LEGENDARY];\n\tconst rarityIndex = rarityOrder.indexOf(rarity);\n\n\tconst available = ALL_SPECIES.filter((s) => {\n\t\tconst floor = SPECIES_RARITY_FLOORS[s] ?? Rarity.COMMON;\n\t\tconst floorIndex = rarityOrder.indexOf(floor);\n\t\treturn floorIndex <= rarityIndex; // species floor must be <= rolled rarity\n\t});\n\n\tif (available.length === 0) {\n\t\t// Shouldn't happen but fallback\n\t\treturn { species: \"Blob\", rarity: Rarity.COMMON };\n\t}\n\n\t// Pick random species from available\n\tconst idx = Math.floor(rng() * available.length);\n\treturn { species: available[idx], rarity };\n}\n\n// =============================================================================\n// Eye and hat selection\n// =============================================================================\n\n/** Roll an eye style */\nexport function rollEyes(rng: () => number): string {\n\tconst idx = Math.floor(rng() * EYE_STYLES.length);\n\treturn EYE_STYLES[idx];\n}\n\n/** Roll a hat */\nexport function rollHat(rng: () => number): string {\n\tconst idx = Math.floor(rng() * HATS.length);\n\treturn HATS[idx];\n}\n\n// =============================================================================\n// Stat rolling\n// =============================================================================\n\n/** Rarity-based stat floor */\nfunction statFloor(rarity: Rarity): number {\n\tswitch (rarity) {\n\t\tcase Rarity.COMMON:\n\t\t\treturn 10;\n\t\tcase Rarity.UNCOMMON:\n\t\t\treturn 20;\n\t\tcase Rarity.RARE:\n\t\t\treturn 35;\n\t\tcase Rarity.EPIC:\n\t\t\treturn 50;\n\t\tcase Rarity.LEGENDARY:\n\t\t\treturn 65;\n\t}\n}\n\n/**\n * Roll RPG-style stats: one peak, one dump, three random.\n * Peak can hit 100, dump near floor.\n */\nexport function rollStats(rng: () => number, rarity: Rarity): Record<Stat, number> {\n\tconst floor = statFloor(rarity);\n\tconst stats: Partial<Record<Stat, number>> = {};\n\n\t// Pick peak and dump stats (must be different)\n\tconst peakStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];\n\tlet dumpStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];\n\twhile (dumpStat === peakStat) {\n\t\tdumpStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];\n\t}\n\n\t// Peak: high roll (70-100)\n\tstats[peakStat] = Math.floor(rng() * 31) + 70;\n\n\t// Dump: near floor\n\tstats[dumpStat] = Math.floor(rng() * 20) + floor;\n\n\t// Others: normal range\n\tfor (const stat of STAT_NAMES) {\n\t\tif (!(stat in stats)) {\n\t\t\tstats[stat] = Math.floor(rng() * (100 - floor)) + floor;\n\t\t}\n\t}\n\n\treturn stats as Record<Stat, number>;\n}\n\n// =============================================================================\n// ASCII art rendering\n// =============================================================================\n\n/** Get the 3 animation frames for a species */\nexport function getSpeciesFrames(species: SpeciesName): string[][] {\n\treturn SPECIES_DEFS[species].frames;\n}\n\n/** Replace {E} placeholder with actual eye character */\nexport function applyEyes(frame: string[], eyes: string): string[] {\n\treturn frame.map((line) => line.replace(/\\{E\\}/g, eyes));\n}\n\n/** Get the maximum width of a species' frames */\nexport function getSpeciesWidth(species: SpeciesName): number {\n\tconst frames = SPECIES_DEFS[species].frames;\n\tlet maxW = 0;\n\tfor (const frame of frames) {\n\t\tfor (const line of frame) {\n\t\t\tmaxW = Math.max(maxW, line.length);\n\t\t}\n\t}\n\treturn maxW;\n}\n"]}

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

@@ -0,0 +1,287 @@
+/**
+ * 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 { rollWeighted } from "./buddy-prng.js";
+import { EYE_STYLES, HATS, RARITY_WEIGHTS, Rarity, STAT_NAMES } from "./buddy-types.js";
+/**
+ * All 18 species with 3 animation frames each.
+ * {E} is replaced at render time with the buddy's eye style.
+ */
+const SPECIES_DEFS = {
+    Duck: {
+        name: "Duck",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["   __     ", "  {E}{E}    ", " <  \\    ", "  \\__\\   ", '  """"   '],
+            ["   __     ", "  {E}{E}    ", " <  \\    ", "  \\__\\   ", '  """"   '],
+            ["   __     ", "  {E}{E}    ", " <  \\    ", "  \\__\\   ", "   ~~    "],
+        ],
+    },
+    Goose: {
+        name: "Goose",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["     __   ", "   {E}{E}   ", "  <  \\   ", "   \\__\\  ", '   """"  '],
+            ["    __    ", "  {E}{E}   ", " <  \\    ", "  \\__\\   ", '  """"   '],
+            ["   __     ", " {E}{E}    ", "<  \\     ", " \\__\\    ", ' """"    '],
+        ],
+    },
+    Blob: {
+        name: "Blob",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["  .---.  ", " / {E}{E}\\ ", "|  >  | ", " \\ --- / ", "  '---'  "],
+            ["  .---.  ", " / {E}{E}\\ ", "|  <  | ", " \\ --- / ", "  '---'  "],
+            ["  .---.  ", " / o o\\ ", "|  ~  | ", " \\ -~- / ", "  '---'  "],
+        ],
+    },
+    Cat: {
+        name: "Cat",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            [" /\\_/\\  ", "( {E}.{E} ) ", " >  ^ <  ", "  \\___/  "],
+            [" /\\_/\\  ", "( {E}-{E} ) ", " >  = <  ", "  \\___/  "],
+            [" /\\_/\\  ", "( {E}.{E} ) ", " >    <  ", "  \\___/  "],
+        ],
+    },
+    Dragon: {
+        name: "Dragon",
+        rarityFloor: Rarity.UNCOMMON,
+        frames: [
+            ["    /\\    ", "   /  \\   ", "  /{E}{E}\\  ", " / --  \\  ", "/ /|  |\\\\ ", "  \\ || /  ", "   \\||/   "],
+            ["    /\\    ", "   /  \\   ", "  /{E}{E}\\  ", " / ~~  \\  ", "/ /|  |\\ \\ ", "  \\ || /  ", "   \\||/   "],
+            ["    /\\    ", "   /  \\   ", "  /{E}{E}\\  ", " / --  \\  ", "/ /|  |\\ \\ ", "  \\ || /  ", "    ||    "],
+        ],
+    },
+    Octopus: {
+        name: "Octopus",
+        rarityFloor: Rarity.UNCOMMON,
+        frames: [
+            ["   _  _   ", "  {E}{E}   ", " /| /|\\|  ", "/ | \\ | \\ ", "  |  | |  "],
+            ["   _  _   ", "  {E}{E}   ", "\\| /|\\|/  ", " | \\ | /| ", "  |  | |  "],
+            ["   _  _   ", "  {E}{E}   ", " /| /|\\|  ", "  | \\ | \\ ", " \\|  | |  "],
+        ],
+    },
+    Owl: {
+        name: "Owl",
+        rarityFloor: Rarity.UNCOMMON,
+        frames: [
+            ["  ,___,   ", "  {E}{E}   ", "  ([V])   ", ' ,"   ",  ', "  \\___/   "],
+            ["  ,___,   ", "  {E}{E}   ", "  ([_])   ", ' ,"   ",  ', "  \\___/   "],
+            ["  ,___,   ", "  {E}{E}   ", "  ([v])   ", ' ,"   ",  ', "  \\___/   "],
+        ],
+    },
+    Penguin: {
+        name: "Penguin",
+        rarityFloor: Rarity.UNCOMMON,
+        frames: [
+            ["   (°)   ", "  /{E}{E}\\  ", " / __  \\ ", " \\    /  ", "  \\__/   "],
+            ["   (°)   ", "  /{E}{E}\\  ", " / __  \\ ", " \\_  _/  ", "   ||    "],
+            ["   (°)   ", "  /{E}{E}\\  ", " / __  \\ ", " \\    /  ", "   ||    "],
+        ],
+    },
+    Turtle: {
+        name: "Turtle",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["     ___  ", "    {E}{E}  ", '  .-"""-. ', " /  ___  \\", " \\_______/", "    ||    "],
+            ["     ___  ", "    {E}{E}  ", '  .-"""-. ', " /  ___  \\", " \\_______/", "    ||    "],
+            ["     ___  ", "   _{E}{E}_ ", '  .-"""-. ', " /  ___  \\", " \\_______/", "    ||    "],
+        ],
+    },
+    Snail: {
+        name: "Snail",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["    ____  ", "   /    \\ ", "  | {E}{E} | ", "  |  __  |", "   \\    / ", "    ~~    "],
+            ["    ____  ", "   /    \\ ", "  | {E}{E} | ", "  |  __  |", "   \\    / ", "    ~~    "],
+            ["    ____  ", "   /    \\ ", "  | {E} {E}| ", "  |  __  |", "   \\    / ", "    ~~    "],
+        ],
+    },
+    Ghost: {
+        name: "Ghost",
+        rarityFloor: Rarity.RARE,
+        frames: [
+            ["   .---.  ", "  / {E}{E}\\ ", " |  >  | ", " |     | ", "  \\~~~~/ ", "   ~~~~   "],
+            ["   .---.  ", "  / {E}{E}\\ ", " |  ~  | ", " |     | ", "  \\ ~~~/ ", "   ~~~~   "],
+            ["   .---.  ", "  / o o\\ ", " |  _  | ", " |     | ", "  \\~~~~/ ", "   ~~~~   "],
+        ],
+    },
+    Axolotl: {
+        name: "Axolotl",
+        rarityFloor: Rarity.RARE,
+        frames: [
+            ["   \\||/   ", "  //{E}{E}\\\\  ", "  || > || ", "  \\\\__//  ", '   "||"   '],
+            ["   \\||/   ", "  //{E}{E}\\\\  ", "  || < || ", "  \\\\__//  ", '   "||"   '],
+            ["   \\||/   ", "  //{E}{E}\\\\  ", "  || w || ", "  \\\\__//  ", '   "||"   '],
+        ],
+    },
+    Capybara: {
+        name: "Capybara",
+        rarityFloor: Rarity.UNCOMMON,
+        frames: [
+            ["  _    _  ", " {E}{E}  ", "  >    <  ", "  \\____/  ", "   || ||  "],
+            ["  _    _  ", " {E}{E}  ", "  >    <  ", "  \\____/  ", "   || ||  "],
+            ["  _    _  ", " {E} {E} ", "  > w  <  ", "  \\____/  ", "   || ||  "],
+        ],
+    },
+    Cactus: {
+        name: "Cactus",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["    _    ", "  _{E}{E}_  ", " |  >  | ", "_|     |_", " |     | ", " |_____| ", "   |||   "],
+            ["    _    ", "  _{E}{E}_  ", " |  <  | ", "_|     |_", " |     | ", " |_____| ", "   |||   "],
+            ["    _    ", "  _{E}{E}_  ", " |  ~  | ", "_|     |_", " |     | ", " |_____| ", "   |||   "],
+        ],
+    },
+    Robot: {
+        name: "Robot",
+        rarityFloor: Rarity.EPIC,
+        frames: [
+            ["  [===]  ", "  |{E}{E}|  ", "  | __ | ", "  |____| ", "   |  |  "],
+            ["  [===]  ", "  |{E}{E}|  ", "  | -- | ", "  |____| ", "   |  |  "],
+            ["  [===]  ", "  |{E}{E}|  ", "  | ~~ | ", "  |____| ", "   |  |  "],
+        ],
+    },
+    Rabbit: {
+        name: "Rabbit",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["  /\\_/\\  ", " /{E}{E}\\ ", " |  > |  ", "  \\__/   ", "  /  \\   "],
+            ["  /\\_/\\  ", " /{E}{E}\\ ", " |  < |  ", "  \\__/   ", "  /  \\   "],
+            ["  /\\_/\\  ", " /{E}{E}\\ ", " | ~  |  ", "  \\__/   ", "   ||    "],
+        ],
+    },
+    Mushroom: {
+        name: "Mushroom",
+        rarityFloor: Rarity.RARE,
+        frames: [
+            ["   .--.  ", "  /{E}{E}\\ ", " |  >  | ", "  \\--/   ", "   ||    ", "  _||_   "],
+            ["   .--.  ", "  /{E}{E}\\ ", " |  <  | ", "  \\--/   ", "   ||    ", "  _||_   "],
+            ["   .--.  ", "  /{E}{E}\\ ", " |  ~  | ", "  \\--/   ", "   ||    ", "  _||_   "],
+        ],
+    },
+    Chonk: {
+        name: "Chonk",
+        rarityFloor: Rarity.COMMON,
+        frames: [
+            ["  .----.  ", " / {E}{E}\\  ", "|  >   | ", "|      | ", " \\____/  "],
+            ["  .----.  ", " / {E}{E}\\  ", "|  <   | ", "|      | ", " \\____/  "],
+            ["  .----.  ", " / {E}{E}\\  ", "|  w   | ", "|      | ", " \\____/  "],
+        ],
+    },
+};
+export const ALL_SPECIES = Object.keys(SPECIES_DEFS);
+// =============================================================================
+// Species selection with rarity weighting
+// =============================================================================
+/** Species rarity multipliers — rarer species need at least that rarity roll */
+const SPECIES_RARITY_FLOORS = {};
+for (const def of Object.values(SPECIES_DEFS)) {
+    SPECIES_RARITY_FLOORS[def.name] = def.rarityFloor;
+}
+/**
+ * Roll a species from the species pool based on rarity.
+ * Species can only appear if the rolled rarity meets their floor.
+ */
+export function rollSpecies(rng) {
+    // First roll rarity
+    const rarity = rollWeighted(rng, RARITY_WEIGHTS);
+    // Filter species available at this rarity tier
+    const rarityOrder = [Rarity.COMMON, Rarity.UNCOMMON, Rarity.RARE, Rarity.EPIC, Rarity.LEGENDARY];
+    const rarityIndex = rarityOrder.indexOf(rarity);
+    const available = ALL_SPECIES.filter((s) => {
+        const floor = SPECIES_RARITY_FLOORS[s] ?? Rarity.COMMON;
+        const floorIndex = rarityOrder.indexOf(floor);
+        return floorIndex <= rarityIndex; // species floor must be <= rolled rarity
+    });
+    if (available.length === 0) {
+        // Shouldn't happen but fallback
+        return { species: "Blob", rarity: Rarity.COMMON };
+    }
+    // Pick random species from available
+    const idx = Math.floor(rng() * available.length);
+    return { species: available[idx], rarity };
+}
+// =============================================================================
+// Eye and hat selection
+// =============================================================================
+/** Roll an eye style */
+export function rollEyes(rng) {
+    const idx = Math.floor(rng() * EYE_STYLES.length);
+    return EYE_STYLES[idx];
+}
+/** Roll a hat */
+export function rollHat(rng) {
+    const idx = Math.floor(rng() * HATS.length);
+    return HATS[idx];
+}
+// =============================================================================
+// Stat rolling
+// =============================================================================
+/** Rarity-based stat floor */
+function statFloor(rarity) {
+    switch (rarity) {
+        case Rarity.COMMON:
+            return 10;
+        case Rarity.UNCOMMON:
+            return 20;
+        case Rarity.RARE:
+            return 35;
+        case Rarity.EPIC:
+            return 50;
+        case Rarity.LEGENDARY:
+            return 65;
+    }
+}
+/**
+ * Roll RPG-style stats: one peak, one dump, three random.
+ * Peak can hit 100, dump near floor.
+ */
+export function rollStats(rng, rarity) {
+    const floor = statFloor(rarity);
+    const stats = {};
+    // Pick peak and dump stats (must be different)
+    const peakStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];
+    let dumpStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];
+    while (dumpStat === peakStat) {
+        dumpStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];
+    }
+    // Peak: high roll (70-100)
+    stats[peakStat] = Math.floor(rng() * 31) + 70;
+    // Dump: near floor
+    stats[dumpStat] = Math.floor(rng() * 20) + floor;
+    // Others: normal range
+    for (const stat of STAT_NAMES) {
+        if (!(stat in stats)) {
+            stats[stat] = Math.floor(rng() * (100 - floor)) + floor;
+        }
+    }
+    return stats;
+}
+// =============================================================================
+// ASCII art rendering
+// =============================================================================
+/** Get the 3 animation frames for a species */
+export function getSpeciesFrames(species) {
+    return SPECIES_DEFS[species].frames;
+}
+/** Replace {E} placeholder with actual eye character */
+export function applyEyes(frame, eyes) {
+    return frame.map((line) => line.replace(/\{E\}/g, eyes));
+}
+/** Get the maximum width of a species' frames */
+export function getSpeciesWidth(species) {
+    const frames = SPECIES_DEFS[species].frames;
+    let maxW = 0;
+    for (const frame of frames) {
+        for (const line of frame) {
+            maxW = Math.max(maxW, line.length);
+        }
+    }
+    return maxW;
+}
+//# sourceMappingURL=buddy-species.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-species.js","sourceRoot":"","sources":["../../../src/core/buddy/buddy-species.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Species pool, eye styles, hats, and ASCII art frames for the buddy companion.\n *\n * Each species has 3 animation frames using {E} as eye placeholder.\n * Frames cycle at 500ms for idle animation.\n */\n\nimport { rollWeighted } from \"./buddy-prng.js\";\nimport { EYE_STYLES, HATS, RARITY_WEIGHTS, Rarity, type SpeciesName, STAT_NAMES, type Stat } from \"./buddy-types.js\";\n\n// =============================================================================\n// Species Definitions — 18 species with ASCII art\n// =============================================================================\n\nexport interface SpeciesDef {\n\tname: SpeciesName;\n\tframes: string[][]; // 3 frames, each is string[] (lines)\n\trarityFloor: Rarity; // minimum rarity this species can appear at\n}\n\n/**\n * All 18 species with 3 animation frames each.\n * {E} is replaced at render time with the buddy's eye style.\n */\nconst SPECIES_DEFS: Record<SpeciesName, SpeciesDef> = {\n\tDuck: {\n\t\tname: \"Duck\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"   __     \", \"  {E}{E}    \", \" <  \\\\    \", \"  \\\\__\\\\   \", '  \"\"\"\"   '],\n\t\t\t[\"   __     \", \"  {E}{E}    \", \" <  \\\\    \", \"  \\\\__\\\\   \", '  \"\"\"\"   '],\n\t\t\t[\"   __     \", \"  {E}{E}    \", \" <  \\\\    \", \"  \\\\__\\\\   \", \"   ~~    \"],\n\t\t],\n\t},\n\tGoose: {\n\t\tname: \"Goose\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"     __   \", \"   {E}{E}   \", \"  <  \\\\   \", \"   \\\\__\\\\  \", '   \"\"\"\"  '],\n\t\t\t[\"    __    \", \"  {E}{E}   \", \" <  \\\\    \", \"  \\\\__\\\\   \", '  \"\"\"\"   '],\n\t\t\t[\"   __     \", \" {E}{E}    \", \"<  \\\\     \", \" \\\\__\\\\    \", ' \"\"\"\"    '],\n\t\t],\n\t},\n\tBlob: {\n\t\tname: \"Blob\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"  .---.  \", \" / {E}{E}\\\\ \", \"|  >  | \", \" \\\\ --- / \", \"  '---'  \"],\n\t\t\t[\"  .---.  \", \" / {E}{E}\\\\ \", \"|  <  | \", \" \\\\ --- / \", \"  '---'  \"],\n\t\t\t[\"  .---.  \", \" / o o\\\\ \", \"|  ~  | \", \" \\\\ -~- / \", \"  '---'  \"],\n\t\t],\n\t},\n\tCat: {\n\t\tname: \"Cat\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\" /\\\\_/\\\\  \", \"( {E}.{E} ) \", \" >  ^ <  \", \"  \\\\___/  \"],\n\t\t\t[\" /\\\\_/\\\\  \", \"( {E}-{E} ) \", \" >  = <  \", \"  \\\\___/  \"],\n\t\t\t[\" /\\\\_/\\\\  \", \"( {E}.{E} ) \", \" >    <  \", \"  \\\\___/  \"],\n\t\t],\n\t},\n\tDragon: {\n\t\tname: \"Dragon\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"    /\\\\    \", \"   /  \\\\   \", \"  /{E}{E}\\\\  \", \" / --  \\\\  \", \"/ /|  |\\\\\\\\ \", \"  \\\\ || /  \", \"   \\\\||/   \"],\n\t\t\t[\"    /\\\\    \", \"   /  \\\\   \", \"  /{E}{E}\\\\  \", \" / ~~  \\\\  \", \"/ /|  |\\\\ \\\\ \", \"  \\\\ || /  \", \"   \\\\||/   \"],\n\t\t\t[\"    /\\\\    \", \"   /  \\\\   \", \"  /{E}{E}\\\\  \", \" / --  \\\\  \", \"/ /|  |\\\\ \\\\ \", \"  \\\\ || /  \", \"    ||    \"],\n\t\t],\n\t},\n\tOctopus: {\n\t\tname: \"Octopus\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"   _  _   \", \"  {E}{E}   \", \" /| /|\\\\|  \", \"/ | \\\\ | \\\\ \", \"  |  | |  \"],\n\t\t\t[\"   _  _   \", \"  {E}{E}   \", \"\\\\| /|\\\\|/  \", \" | \\\\ | /| \", \"  |  | |  \"],\n\t\t\t[\"   _  _   \", \"  {E}{E}   \", \" /| /|\\\\|  \", \"  | \\\\ | \\\\ \", \" \\\\|  | |  \"],\n\t\t],\n\t},\n\tOwl: {\n\t\tname: \"Owl\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"  ,___,   \", \"  {E}{E}   \", \"  ([V])   \", ' ,\"   \",  ', \"  \\\\___/   \"],\n\t\t\t[\"  ,___,   \", \"  {E}{E}   \", \"  ([_])   \", ' ,\"   \",  ', \"  \\\\___/   \"],\n\t\t\t[\"  ,___,   \", \"  {E}{E}   \", \"  ([v])   \", ' ,\"   \",  ', \"  \\\\___/   \"],\n\t\t],\n\t},\n\tPenguin: {\n\t\tname: \"Penguin\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"   (°)   \", \"  /{E}{E}\\\\  \", \" / __  \\\\ \", \" \\\\    /  \", \"  \\\\__/   \"],\n\t\t\t[\"   (°)   \", \"  /{E}{E}\\\\  \", \" / __  \\\\ \", \" \\\\_  _/  \", \"   ||    \"],\n\t\t\t[\"   (°)   \", \"  /{E}{E}\\\\  \", \" / __  \\\\ \", \" \\\\    /  \", \"   ||    \"],\n\t\t],\n\t},\n\tTurtle: {\n\t\tname: \"Turtle\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"     ___  \", \"    {E}{E}  \", '  .-\"\"\"-. ', \" /  ___  \\\\\", \" \\\\_______/\", \"    ||    \"],\n\t\t\t[\"     ___  \", \"    {E}{E}  \", '  .-\"\"\"-. ', \" /  ___  \\\\\", \" \\\\_______/\", \"    ||    \"],\n\t\t\t[\"     ___  \", \"   _{E}{E}_ \", '  .-\"\"\"-. ', \" /  ___  \\\\\", \" \\\\_______/\", \"    ||    \"],\n\t\t],\n\t},\n\tSnail: {\n\t\tname: \"Snail\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"    ____  \", \"   /    \\\\ \", \"  | {E}{E} | \", \"  |  __  |\", \"   \\\\    / \", \"    ~~    \"],\n\t\t\t[\"    ____  \", \"   /    \\\\ \", \"  | {E}{E} | \", \"  |  __  |\", \"   \\\\    / \", \"    ~~    \"],\n\t\t\t[\"    ____  \", \"   /    \\\\ \", \"  | {E} {E}| \", \"  |  __  |\", \"   \\\\    / \", \"    ~~    \"],\n\t\t],\n\t},\n\tGhost: {\n\t\tname: \"Ghost\",\n\t\trarityFloor: Rarity.RARE,\n\t\tframes: [\n\t\t\t[\"   .---.  \", \"  / {E}{E}\\\\ \", \" |  >  | \", \" |     | \", \"  \\\\~~~~/ \", \"   ~~~~   \"],\n\t\t\t[\"   .---.  \", \"  / {E}{E}\\\\ \", \" |  ~  | \", \" |     | \", \"  \\\\ ~~~/ \", \"   ~~~~   \"],\n\t\t\t[\"   .---.  \", \"  / o o\\\\ \", \" |  _  | \", \" |     | \", \"  \\\\~~~~/ \", \"   ~~~~   \"],\n\t\t],\n\t},\n\tAxolotl: {\n\t\tname: \"Axolotl\",\n\t\trarityFloor: Rarity.RARE,\n\t\tframes: [\n\t\t\t[\"   \\\\||/   \", \"  //{E}{E}\\\\\\\\  \", \"  || > || \", \"  \\\\\\\\__//  \", '   \"||\"   '],\n\t\t\t[\"   \\\\||/   \", \"  //{E}{E}\\\\\\\\  \", \"  || < || \", \"  \\\\\\\\__//  \", '   \"||\"   '],\n\t\t\t[\"   \\\\||/   \", \"  //{E}{E}\\\\\\\\  \", \"  || w || \", \"  \\\\\\\\__//  \", '   \"||\"   '],\n\t\t],\n\t},\n\tCapybara: {\n\t\tname: \"Capybara\",\n\t\trarityFloor: Rarity.UNCOMMON,\n\t\tframes: [\n\t\t\t[\"  _    _  \", \" {E}{E}  \", \"  >    <  \", \"  \\\\____/  \", \"   || ||  \"],\n\t\t\t[\"  _    _  \", \" {E}{E}  \", \"  >    <  \", \"  \\\\____/  \", \"   || ||  \"],\n\t\t\t[\"  _    _  \", \" {E} {E} \", \"  > w  <  \", \"  \\\\____/  \", \"   || ||  \"],\n\t\t],\n\t},\n\tCactus: {\n\t\tname: \"Cactus\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"    _    \", \"  _{E}{E}_  \", \" |  >  | \", \"_|     |_\", \" |     | \", \" |_____| \", \"   |||   \"],\n\t\t\t[\"    _    \", \"  _{E}{E}_  \", \" |  <  | \", \"_|     |_\", \" |     | \", \" |_____| \", \"   |||   \"],\n\t\t\t[\"    _    \", \"  _{E}{E}_  \", \" |  ~  | \", \"_|     |_\", \" |     | \", \" |_____| \", \"   |||   \"],\n\t\t],\n\t},\n\tRobot: {\n\t\tname: \"Robot\",\n\t\trarityFloor: Rarity.EPIC,\n\t\tframes: [\n\t\t\t[\"  [===]  \", \"  |{E}{E}|  \", \"  | __ | \", \"  |____| \", \"   |  |  \"],\n\t\t\t[\"  [===]  \", \"  |{E}{E}|  \", \"  | -- | \", \"  |____| \", \"   |  |  \"],\n\t\t\t[\"  [===]  \", \"  |{E}{E}|  \", \"  | ~~ | \", \"  |____| \", \"   |  |  \"],\n\t\t],\n\t},\n\tRabbit: {\n\t\tname: \"Rabbit\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"  /\\\\_/\\\\  \", \" /{E}{E}\\\\ \", \" |  > |  \", \"  \\\\__/   \", \"  /  \\\\   \"],\n\t\t\t[\"  /\\\\_/\\\\  \", \" /{E}{E}\\\\ \", \" |  < |  \", \"  \\\\__/   \", \"  /  \\\\   \"],\n\t\t\t[\"  /\\\\_/\\\\  \", \" /{E}{E}\\\\ \", \" | ~  |  \", \"  \\\\__/   \", \"   ||    \"],\n\t\t],\n\t},\n\tMushroom: {\n\t\tname: \"Mushroom\",\n\t\trarityFloor: Rarity.RARE,\n\t\tframes: [\n\t\t\t[\"   .--.  \", \"  /{E}{E}\\\\ \", \" |  >  | \", \"  \\\\--/   \", \"   ||    \", \"  _||_   \"],\n\t\t\t[\"   .--.  \", \"  /{E}{E}\\\\ \", \" |  <  | \", \"  \\\\--/   \", \"   ||    \", \"  _||_   \"],\n\t\t\t[\"   .--.  \", \"  /{E}{E}\\\\ \", \" |  ~  | \", \"  \\\\--/   \", \"   ||    \", \"  _||_   \"],\n\t\t],\n\t},\n\tChonk: {\n\t\tname: \"Chonk\",\n\t\trarityFloor: Rarity.COMMON,\n\t\tframes: [\n\t\t\t[\"  .----.  \", \" / {E}{E}\\\\  \", \"|  >   | \", \"|      | \", \" \\\\____/  \"],\n\t\t\t[\"  .----.  \", \" / {E}{E}\\\\  \", \"|  <   | \", \"|      | \", \" \\\\____/  \"],\n\t\t\t[\"  .----.  \", \" / {E}{E}\\\\  \", \"|  w   | \", \"|      | \", \" \\\\____/  \"],\n\t\t],\n\t},\n};\n\nexport const ALL_SPECIES = Object.keys(SPECIES_DEFS) as SpeciesName[];\n\n// =============================================================================\n// Species selection with rarity weighting\n// =============================================================================\n\n/** Species rarity multipliers — rarer species need at least that rarity roll */\nconst SPECIES_RARITY_FLOORS: Partial<Record<SpeciesName, Rarity>> = {};\nfor (const def of Object.values(SPECIES_DEFS)) {\n\tSPECIES_RARITY_FLOORS[def.name] = def.rarityFloor;\n}\n\n/**\n * Roll a species from the species pool based on rarity.\n * Species can only appear if the rolled rarity meets their floor.\n */\nexport function rollSpecies(rng: () => number): { species: SpeciesName; rarity: Rarity } {\n\t// First roll rarity\n\tconst rarity = rollWeighted(rng, RARITY_WEIGHTS);\n\n\t// Filter species available at this rarity tier\n\tconst rarityOrder = [Rarity.COMMON, Rarity.UNCOMMON, Rarity.RARE, Rarity.EPIC, Rarity.LEGENDARY];\n\tconst rarityIndex = rarityOrder.indexOf(rarity);\n\n\tconst available = ALL_SPECIES.filter((s) => {\n\t\tconst floor = SPECIES_RARITY_FLOORS[s] ?? Rarity.COMMON;\n\t\tconst floorIndex = rarityOrder.indexOf(floor);\n\t\treturn floorIndex <= rarityIndex; // species floor must be <= rolled rarity\n\t});\n\n\tif (available.length === 0) {\n\t\t// Shouldn't happen but fallback\n\t\treturn { species: \"Blob\", rarity: Rarity.COMMON };\n\t}\n\n\t// Pick random species from available\n\tconst idx = Math.floor(rng() * available.length);\n\treturn { species: available[idx], rarity };\n}\n\n// =============================================================================\n// Eye and hat selection\n// =============================================================================\n\n/** Roll an eye style */\nexport function rollEyes(rng: () => number): string {\n\tconst idx = Math.floor(rng() * EYE_STYLES.length);\n\treturn EYE_STYLES[idx];\n}\n\n/** Roll a hat */\nexport function rollHat(rng: () => number): string {\n\tconst idx = Math.floor(rng() * HATS.length);\n\treturn HATS[idx];\n}\n\n// =============================================================================\n// Stat rolling\n// =============================================================================\n\n/** Rarity-based stat floor */\nfunction statFloor(rarity: Rarity): number {\n\tswitch (rarity) {\n\t\tcase Rarity.COMMON:\n\t\t\treturn 10;\n\t\tcase Rarity.UNCOMMON:\n\t\t\treturn 20;\n\t\tcase Rarity.RARE:\n\t\t\treturn 35;\n\t\tcase Rarity.EPIC:\n\t\t\treturn 50;\n\t\tcase Rarity.LEGENDARY:\n\t\t\treturn 65;\n\t}\n}\n\n/**\n * Roll RPG-style stats: one peak, one dump, three random.\n * Peak can hit 100, dump near floor.\n */\nexport function rollStats(rng: () => number, rarity: Rarity): Record<Stat, number> {\n\tconst floor = statFloor(rarity);\n\tconst stats: Partial<Record<Stat, number>> = {};\n\n\t// Pick peak and dump stats (must be different)\n\tconst peakStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];\n\tlet dumpStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];\n\twhile (dumpStat === peakStat) {\n\t\tdumpStat = STAT_NAMES[Math.floor(rng() * STAT_NAMES.length)];\n\t}\n\n\t// Peak: high roll (70-100)\n\tstats[peakStat] = Math.floor(rng() * 31) + 70;\n\n\t// Dump: near floor\n\tstats[dumpStat] = Math.floor(rng() * 20) + floor;\n\n\t// Others: normal range\n\tfor (const stat of STAT_NAMES) {\n\t\tif (!(stat in stats)) {\n\t\t\tstats[stat] = Math.floor(rng() * (100 - floor)) + floor;\n\t\t}\n\t}\n\n\treturn stats as Record<Stat, number>;\n}\n\n// =============================================================================\n// ASCII art rendering\n// =============================================================================\n\n/** Get the 3 animation frames for a species */\nexport function getSpeciesFrames(species: SpeciesName): string[][] {\n\treturn SPECIES_DEFS[species].frames;\n}\n\n/** Replace {E} placeholder with actual eye character */\nexport function applyEyes(frame: string[], eyes: string): string[] {\n\treturn frame.map((line) => line.replace(/\\{E\\}/g, eyes));\n}\n\n/** Get the maximum width of a species' frames */\nexport function getSpeciesWidth(species: SpeciesName): number {\n\tconst frames = SPECIES_DEFS[species].frames;\n\tlet maxW = 0;\n\tfor (const frame of frames) {\n\t\tfor (const line of frame) {\n\t\t\tmaxW = Math.max(maxW, line.length);\n\t\t}\n\t}\n\treturn maxW;\n}\n"]}

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

@@ -0,0 +1,58 @@
+/**
+ * Shared types for the buddy companion system.
+ */
+/** RPG-style stats for a companion */
+export declare enum Stat {
+    DEBUGGING = "DEBUGGING",
+    PATIENCE = "PATIENCE",
+    CHAOS = "CHAOS",
+    WISDOM = "WISDOM",
+    SNARK = "SNARK"
+}
+export declare const STAT_NAMES: Stat[];
+export interface StatBlock {
+    [Stat.DEBUGGING]: number;
+    [Stat.PATIENCE]: number;
+    [Stat.CHAOS]: number;
+    [Stat.WISDOM]: number;
+    [Stat.SNARK]: number;
+}
+/** Rarity tiers with weights for rolling */
+export declare enum Rarity {
+    COMMON = "Common",
+    UNCOMMON = "Uncommon",
+    RARE = "Rare",
+    EPIC = "Epic",
+    LEGENDARY = "Legendary"
+}
+/** Weight for each rarity tier (out of 100) */
+export declare const RARITY_WEIGHTS: Record<Rarity, number>;
+/** Eye styles substituted into ASCII art via {E} placeholder */
+export declare const EYE_STYLES: readonly ["●", "○", "◉", "⊙", "◎", "°"];
+/** Hats rendered above the sprite */
+export declare const HATS: readonly ["", "🎩", "👑", "🎓", "🧢", "👒", "⛑️", "🪖"];
+/** Species identifiers */
+export type SpeciesName = "Duck" | "Goose" | "Blob" | "Cat" | "Dragon" | "Octopus" | "Owl" | "Penguin" | "Turtle" | "Snail" | "Ghost" | "Axolotl" | "Capybara" | "Cactus" | "Robot" | "Rabbit" | "Mushroom" | "Chonk";
+/** Deterministic bones — re-rolled from hash on every session */
+export interface CompanionBones {
+    species: SpeciesName;
+    rarity: Rarity;
+    shiny: boolean;
+    stats: StatBlock;
+    eyeStyle: string;
+    hat: string;
+}
+/** Persisted soul — generated once on first hatch */
+export interface StoredCompanion {
+    rerollCount: number;
+    name: string;
+    personality: string;
+    backstory: string;
+    hatchedAt: string;
+    hidden?: boolean;
+    ollamaModel?: string;
+}
+/** Full buddy state = bones (ephemeral) + soul (persisted) */
+export interface BuddyState extends CompanionBones, StoredCompanion {
+}
+//# sourceMappingURL=buddy-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-types.d.ts","sourceRoot":"","sources":["../../../src/core/buddy/buddy-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sCAAsC;AACtC,oBAAY,IAAI;IACf,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CACf;AAED,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C,MAAM,WAAW,SAAS;IACzB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4CAA4C;AAC5C,oBAAY,MAAM;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,SAAS,cAAc;CACvB;AAED,+CAA+C;AAC/C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,UAAU,oDAA0C,CAAC;AAElE,qCAAqC;AACrC,eAAO,MAAM,IAAI,yEASP,CAAC;AAEX,0BAA0B;AAC1B,MAAM,MAAM,WAAW,GACpB,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,QAAQ,GACR,SAAS,GACT,KAAK,GACL,SAAS,GACT,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,UAAU,GACV,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,UAAU,GACV,OAAO,CAAC;AAEX,mEAAiE;AACjE,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,uDAAqD;AACrD,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAW,SAAQ,cAAc,EAAE,eAAe;CAAG","sourcesContent":["/**\n * Shared types for the buddy companion system.\n */\n\n/** RPG-style stats for a companion */\nexport enum Stat {\n\tDEBUGGING = \"DEBUGGING\",\n\tPATIENCE = \"PATIENCE\",\n\tCHAOS = \"CHAOS\",\n\tWISDOM = \"WISDOM\",\n\tSNARK = \"SNARK\",\n}\n\nexport const STAT_NAMES = Object.values(Stat);\n\nexport interface StatBlock {\n\t[Stat.DEBUGGING]: number;\n\t[Stat.PATIENCE]: number;\n\t[Stat.CHAOS]: number;\n\t[Stat.WISDOM]: number;\n\t[Stat.SNARK]: number;\n}\n\n/** Rarity tiers with weights for rolling */\nexport enum Rarity {\n\tCOMMON = \"Common\",\n\tUNCOMMON = \"Uncommon\",\n\tRARE = \"Rare\",\n\tEPIC = \"Epic\",\n\tLEGENDARY = \"Legendary\",\n}\n\n/** Weight for each rarity tier (out of 100) */\nexport const RARITY_WEIGHTS: Record<Rarity, number> = {\n\t[Rarity.COMMON]: 60,\n\t[Rarity.UNCOMMON]: 25,\n\t[Rarity.RARE]: 10,\n\t[Rarity.EPIC]: 4,\n\t[Rarity.LEGENDARY]: 1,\n};\n\n/** Eye styles substituted into ASCII art via {E} placeholder */\nexport const EYE_STYLES = [\"●\", \"○\", \"◉\", \"⊙\", \"◎\", \"°\"] as const;\n\n/** Hats rendered above the sprite */\nexport const HATS = [\n\t\"\", // no hat\n\t\"🎩\",\n\t\"👑\",\n\t\"🎓\",\n\t\"🧢\",\n\t\"👒\",\n\t\"⛑️\",\n\t\"🪖\",\n] as const;\n\n/** Species identifiers */\nexport type SpeciesName =\n\t| \"Duck\"\n\t| \"Goose\"\n\t| \"Blob\"\n\t| \"Cat\"\n\t| \"Dragon\"\n\t| \"Octopus\"\n\t| \"Owl\"\n\t| \"Penguin\"\n\t| \"Turtle\"\n\t| \"Snail\"\n\t| \"Ghost\"\n\t| \"Axolotl\"\n\t| \"Capybara\"\n\t| \"Cactus\"\n\t| \"Robot\"\n\t| \"Rabbit\"\n\t| \"Mushroom\"\n\t| \"Chonk\";\n\n/** Deterministic bones — re-rolled from hash on every session */\nexport interface CompanionBones {\n\tspecies: SpeciesName;\n\trarity: Rarity;\n\tshiny: boolean;\n\tstats: StatBlock;\n\teyeStyle: string;\n\that: string;\n}\n\n/** Persisted soul — generated once on first hatch */\nexport interface StoredCompanion {\n\trerollCount: number;\n\tname: string;\n\tpersonality: string;\n\tbackstory: string;\n\thatchedAt: string;\n\thidden?: boolean; // true when user ran /buddy off\n\tollamaModel?: string; // user-chosen Ollama model for reactions\n}\n\n/** Full buddy state = bones (ephemeral) + soul (persisted) */\nexport interface BuddyState extends CompanionBones, StoredCompanion {}\n"]}

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

@@ -0,0 +1,46 @@
+/**
+ * Shared types for the buddy companion system.
+ */
+export { Stat };
+/** RPG-style stats for a companion */
+var Stat;
+(function (Stat) {
+    Stat["DEBUGGING"] = "DEBUGGING";
+    Stat["PATIENCE"] = "PATIENCE";
+    Stat["CHAOS"] = "CHAOS";
+    Stat["WISDOM"] = "WISDOM";
+    Stat["SNARK"] = "SNARK";
+})(Stat || (Stat = {}));
+export const STAT_NAMES = Object.values(Stat);
+export { Rarity };
+/** Rarity tiers with weights for rolling */
+var Rarity;
+(function (Rarity) {
+    Rarity["COMMON"] = "Common";
+    Rarity["UNCOMMON"] = "Uncommon";
+    Rarity["RARE"] = "Rare";
+    Rarity["EPIC"] = "Epic";
+    Rarity["LEGENDARY"] = "Legendary";
+})(Rarity || (Rarity = {}));
+/** Weight for each rarity tier (out of 100) */
+export const RARITY_WEIGHTS = {
+    [Rarity.COMMON]: 60,
+    [Rarity.UNCOMMON]: 25,
+    [Rarity.RARE]: 10,
+    [Rarity.EPIC]: 4,
+    [Rarity.LEGENDARY]: 1,
+};
+/** Eye styles substituted into ASCII art via {E} placeholder */
+export const EYE_STYLES = ["●", "○", "◉", "⊙", "◎", "°"];
+/** Hats rendered above the sprite */
+export const HATS = [
+    "", // no hat
+    "🎩",
+    "👑",
+    "🎓",
+    "🧢",
+    "👒",
+    "⛑️",
+    "🪖",
+];
+//# sourceMappingURL=buddy-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buddy-types.js","sourceRoot":"","sources":["../../../src/core/buddy/buddy-types.ts"],"names":[],"mappings":"AAAA;;GAEG;SAGS,IAAI;AADhB,sCAAsC;AACtC,IAAY,IAMX;AAND,WAAY,IAAI;IACf,+BAAuB,CAAA;IACvB,6BAAqB,CAAA;IACrB,uBAAe,CAAA;IACf,yBAAiB,CAAA;IACjB,uBAAe,CAAA;AAAC,CACjB,EANY,IAAI,KAAJ,IAAI,QAMf;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAWlC,MAAM;AADlB,4CAA4C;AAC5C,IAAY,MAMX;AAND,WAAY,MAAM;IACjB,2BAAiB,CAAA;IACjB,+BAAqB,CAAA;IACrB,uBAAa,CAAA;IACb,uBAAa,CAAA;IACb,iCAAuB,CAAA;AAAC,CACzB,EANY,MAAM,KAAN,MAAM,QAMjB;AAED,+CAA+C;AAC/C,MAAM,CAAC,MAAM,cAAc,GAA2B;IACrD,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE;IACnB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE;IACrB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;IACjB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAChB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAG,EAAE,KAAG,EAAE,KAAG,EAAE,KAAG,EAAE,KAAG,EAAE,IAAG,CAAU,CAAC;AAElE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;IACnB,EAAE,EAAE,SAAS;IACb,MAAG;IACH,MAAG;IACH,MAAG;IACH,MAAG;IACH,MAAG;IACH,QAAI;IACJ,MAAG;CACM,CAAC","sourcesContent":["/**\n * Shared types for the buddy companion system.\n */\n\n/** RPG-style stats for a companion */\nexport enum Stat {\n\tDEBUGGING = \"DEBUGGING\",\n\tPATIENCE = \"PATIENCE\",\n\tCHAOS = \"CHAOS\",\n\tWISDOM = \"WISDOM\",\n\tSNARK = \"SNARK\",\n}\n\nexport const STAT_NAMES = Object.values(Stat);\n\nexport interface StatBlock {\n\t[Stat.DEBUGGING]: number;\n\t[Stat.PATIENCE]: number;\n\t[Stat.CHAOS]: number;\n\t[Stat.WISDOM]: number;\n\t[Stat.SNARK]: number;\n}\n\n/** Rarity tiers with weights for rolling */\nexport enum Rarity {\n\tCOMMON = \"Common\",\n\tUNCOMMON = \"Uncommon\",\n\tRARE = \"Rare\",\n\tEPIC = \"Epic\",\n\tLEGENDARY = \"Legendary\",\n}\n\n/** Weight for each rarity tier (out of 100) */\nexport const RARITY_WEIGHTS: Record<Rarity, number> = {\n\t[Rarity.COMMON]: 60,\n\t[Rarity.UNCOMMON]: 25,\n\t[Rarity.RARE]: 10,\n\t[Rarity.EPIC]: 4,\n\t[Rarity.LEGENDARY]: 1,\n};\n\n/** Eye styles substituted into ASCII art via {E} placeholder */\nexport const EYE_STYLES = [\"●\", \"○\", \"◉\", \"⊙\", \"◎\", \"°\"] as const;\n\n/** Hats rendered above the sprite */\nexport const HATS = [\n\t\"\", // no hat\n\t\"🎩\",\n\t\"👑\",\n\t\"🎓\",\n\t\"🧢\",\n\t\"👒\",\n\t\"⛑️\",\n\t\"🪖\",\n] as const;\n\n/** Species identifiers */\nexport type SpeciesName =\n\t| \"Duck\"\n\t| \"Goose\"\n\t| \"Blob\"\n\t| \"Cat\"\n\t| \"Dragon\"\n\t| \"Octopus\"\n\t| \"Owl\"\n\t| \"Penguin\"\n\t| \"Turtle\"\n\t| \"Snail\"\n\t| \"Ghost\"\n\t| \"Axolotl\"\n\t| \"Capybara\"\n\t| \"Cactus\"\n\t| \"Robot\"\n\t| \"Rabbit\"\n\t| \"Mushroom\"\n\t| \"Chonk\";\n\n/** Deterministic bones — re-rolled from hash on every session */\nexport interface CompanionBones {\n\tspecies: SpeciesName;\n\trarity: Rarity;\n\tshiny: boolean;\n\tstats: StatBlock;\n\teyeStyle: string;\n\that: string;\n}\n\n/** Persisted soul — generated once on first hatch */\nexport interface StoredCompanion {\n\trerollCount: number;\n\tname: string;\n\tpersonality: string;\n\tbackstory: string;\n\thatchedAt: string;\n\thidden?: boolean; // true when user ran /buddy off\n\tollamaModel?: string; // user-chosen Ollama model for reactions\n}\n\n/** Full buddy state = bones (ephemeral) + soul (persisted) */\nexport interface BuddyState extends CompanionBones, StoredCompanion {}\n"]}

package/dist/core/buddy/index.d.ts

@@ -0,0 +1,7 @@
+export { type BuddyCallbacks, type BuddyCommandResult, BuddyController, type BuddyControllerConfig, } from "./buddy-controller.js";
+export { BuddyManager, checkOllama, type OllamaStatus } from "./buddy-manager.js";
+export { createBuddyRng, createBuddySeed, fnv1a, mulberry32, rollFloat, rollInt, rollWeighted } from "./buddy-prng.js";
+export { applyEyes, getSpeciesFrames, rollEyes, rollHat, rollSpecies, rollStats } from "./buddy-species.js";
+export type { BuddyState, CompanionBones, SpeciesName, StatBlock, StoredCompanion } from "./buddy-types.js";
+export { RARITY_WEIGHTS, Rarity, STAT_NAMES, Stat } from "./buddy-types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/buddy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/buddy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,eAAe,EACf,KAAK,qBAAqB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5G,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export {\n\ttype BuddyCallbacks,\n\ttype BuddyCommandResult,\n\tBuddyController,\n\ttype BuddyControllerConfig,\n} from \"./buddy-controller.js\";\nexport { BuddyManager, checkOllama, type OllamaStatus } from \"./buddy-manager.js\";\nexport { createBuddyRng, createBuddySeed, fnv1a, mulberry32, rollFloat, rollInt, rollWeighted } from \"./buddy-prng.js\";\nexport { applyEyes, getSpeciesFrames, rollEyes, rollHat, rollSpecies, rollStats } from \"./buddy-species.js\";\nexport type { BuddyState, CompanionBones, SpeciesName, StatBlock, StoredCompanion } from \"./buddy-types.js\";\nexport { RARITY_WEIGHTS, Rarity, STAT_NAMES, Stat } from \"./buddy-types.js\";\n"]}

package/dist/core/buddy/index.js

@@ -0,0 +1,6 @@
+export { BuddyController, } from "./buddy-controller.js";
+export { BuddyManager, checkOllama } from "./buddy-manager.js";
+export { createBuddyRng, createBuddySeed, fnv1a, mulberry32, rollFloat, rollInt, rollWeighted } from "./buddy-prng.js";
+export { applyEyes, getSpeciesFrames, rollEyes, rollHat, rollSpecies, rollStats } from "./buddy-species.js";
+export { RARITY_WEIGHTS, Rarity, STAT_NAMES, Stat } from "./buddy-types.js";
+//# sourceMappingURL=index.js.map

package/dist/core/buddy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/buddy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,eAAe,GAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAqB,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE5G,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export {\n\ttype BuddyCallbacks,\n\ttype BuddyCommandResult,\n\tBuddyController,\n\ttype BuddyControllerConfig,\n} from \"./buddy-controller.js\";\nexport { BuddyManager, checkOllama, type OllamaStatus } from \"./buddy-manager.js\";\nexport { createBuddyRng, createBuddySeed, fnv1a, mulberry32, rollFloat, rollInt, rollWeighted } from \"./buddy-prng.js\";\nexport { applyEyes, getSpeciesFrames, rollEyes, rollHat, rollSpecies, rollStats } from \"./buddy-species.js\";\nexport type { BuddyState, CompanionBones, SpeciesName, StatBlock, StoredCompanion } from \"./buddy-types.js\";\nexport { RARITY_WEIGHTS, Rarity, STAT_NAMES, Stat } from \"./buddy-types.js\";\n"]}

package/dist/core/compaction/branch-summarization.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Branch summarization for tree navigation.
+ *
+ * When navigating to a different point in the session tree, this generates
+ * a summary of the branch being left so context isn't lost.
+ */
+import type { AgentMessage } from "@dreb/agent-core";
+import type { Model } from "@dreb/ai";
+import type { ReadonlySessionManager, SessionEntry } from "../session-manager.js";
+import { type FileOperations } from "./utils.js";
+export interface BranchSummaryResult {
+    summary?: string;
+    readFiles?: string[];
+    modifiedFiles?: string[];
+    aborted?: boolean;
+    error?: string;
+}
+/** Details stored in BranchSummaryEntry.details for file tracking */
+export interface BranchSummaryDetails {
+    readFiles: string[];
+    modifiedFiles: string[];
+}
+export type { FileOperations } from "./utils.js";
+export interface BranchPreparation {
+    /** Messages extracted for summarization, in chronological order */
+    messages: AgentMessage[];
+    /** File operations extracted from tool calls */
+    fileOps: FileOperations;
+    /** Total estimated tokens in messages */
+    totalTokens: number;
+}
+export interface CollectEntriesResult {
+    /** Entries to summarize, in chronological order */
+    entries: SessionEntry[];
+    /** Common ancestor between old and new position, if any */
+    commonAncestorId: string | null;
+}
+export interface GenerateBranchSummaryOptions {
+    /** Model to use for summarization */
+    model: Model<any>;
+    /** API key for the model */
+    apiKey: string;
+    /** Abort signal for cancellation */
+    signal: AbortSignal;
+    /** Optional custom instructions for summarization */
+    customInstructions?: string;
+    /** If true, customInstructions replaces the default prompt instead of being appended */
+    replaceInstructions?: boolean;
+    /** Tokens reserved for prompt + LLM response (default 16384) */
+    reserveTokens?: number;
+}
+/**
+ * Collect entries that should be summarized when navigating from one position to another.
+ *
+ * Walks from oldLeafId back to the common ancestor with targetId, collecting entries
+ * along the way. Does NOT stop at compaction boundaries - those are included and their
+ * summaries become context.
+ *
+ * @param session - Session manager (read-only access)
+ * @param oldLeafId - Current position (where we're navigating from)
+ * @param targetId - Target position (where we're navigating to)
+ * @returns Entries to summarize and the common ancestor
+ */
+export declare function collectEntriesForBranchSummary(session: ReadonlySessionManager, oldLeafId: string | null, targetId: string): CollectEntriesResult;
+/**
+ * Prepare entries for summarization with token budget.
+ *
+ * Walks entries from NEWEST to OLDEST, adding messages until we hit the token budget.
+ * This ensures we keep the most recent context when the branch is too long.
+ *
+ * Also collects file operations from:
+ * - Tool calls in assistant messages
+ * - Existing branch_summary entries' details (for cumulative tracking)
+ *
+ * @param entries - Entries in chronological order
+ * @param tokenBudget - Maximum tokens to include (0 = no limit)
+ */
+export declare function prepareBranchEntries(entries: SessionEntry[], tokenBudget?: number): BranchPreparation;
+/**
+ * Generate a summary of abandoned branch entries.
+ *
+ * @param entries - Session entries to summarize (chronological order)
+ * @param options - Generation options
+ */
+export declare function generateBranchSummary(entries: SessionEntry[], options: GenerateBranchSummaryOptions): Promise<BranchSummaryResult>;
+//# sourceMappingURL=branch-summarization.d.ts.map