@iamjameslennon/ddb-mcp 2.8.0 → 2.9.1

package/dist/tools/character/actions.js

@@ -0,0 +1,110 @@
+/**
+ * Actions domain — ACTIONS / BONUS ACTIONS / REACTIONS / LIMITED USE.
+ * Owns the combat block.
+ *
+ * Phase 6b of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Filters Circle Spell entries (Dark Bargain campaign leak), surfaces
+ * activationType 3/4 spells into bonus-action and reaction lists (with the
+ * spellbook prepared/ritual gate applied), and computes "X used / Y max"
+ * for limited-use features (including stat-mod-keyed uses like Bardic
+ * Inspiration). Output is pre-formatted lines.
+ */
+import { arr, num, obj, signed, str } from "./helpers.js";
+import { computeWeaponAttacks } from "./weapons.js";
+// ── Action source extraction ─────────────────────────────────────────────────
+function getAllActions(char) {
+    // activation.activationType: 1=action, 3=bonus action, 4=reaction, 8=special (skip)
+    // Filter Circle Spell entries — these leak from the Dark Bargain campaign feature
+    // and don't represent real character abilities on the website.
+    return Object.values(obj(char.actions))
+        .flatMap(v => arr(v))
+        .filter(a => a != null && !str(a.name).startsWith("Circle Spell") && str(a.name) !== "Initiate a Circle Spell");
+}
+const activationType = (a) => num(obj(a.activation).activationType);
+// ── Bonus-action and reaction spells ─────────────────────────────────────────
+function getCharSpellsForActions(char, classes) {
+    // Bonus-action and reaction spells — activationType 3=bonus action, 4=reaction.
+    // Apply the same prepared/ritual filter used in the main SPELLS section for spellbook
+    // classes (Wizards) so unprepared non-ritual spells don't bleed into these sections.
+    return [
+        ...arr(char.classSpells).flatMap(cs => {
+            const classEntry = classes.find(c => c.id === cs.characterClassId);
+            const isSpellbook = str(obj(classEntry?.definition ?? {}).name) === "Wizard";
+            return arr(cs.spells).filter(s => !isSpellbook || s.prepared === true || obj(s.definition).ritual === true);
+        }),
+        ...Object.values(obj(char.spells)).flatMap(v => arr(v)),
+    ].filter(Boolean);
+}
+const spellActivationType = (s) => num(obj(obj(s.definition).activation).activationType);
+function formatSpellAction(s) {
+    const def = obj(s.definition);
+    const lvl = num(def.level);
+    const slotStr = lvl === 0 ? "cantrip" : `${lvl === 1 ? "1st" : lvl === 2 ? "2nd" : lvl === 3 ? "3rd" : `${lvl}th`}-level slot`;
+    return `• ${str(def.name)} (spell, ${slotStr})`;
+}
+// ── Limited-use features ─────────────────────────────────────────────────────
+function buildLimitedUseLines(allActions, statMods) {
+    return allActions
+        .filter(a => {
+        const lu = obj(a.limitedUse);
+        // maxUses=0 with statModifierUsesId means uses = that stat modifier (e.g. CHA for Bardic Inspiration)
+        return lu.maxUses !== undefined && (num(lu.maxUses) > 0 || lu.statModifierUsesId != null);
+    })
+        .map(a => {
+        const lu = obj(a.limitedUse);
+        const resetLabels = { 1: "Short Rest", 2: "Long Rest" };
+        const reset = resetLabels[num(lu.resetType)] ?? "Rest";
+        let maxStr = num(lu.maxUses) > 0
+            ? String(num(lu.maxUses))
+            : lu.statModifierUsesId != null
+                ? `${signed(statMods[num(lu.statModifierUsesId) - 1])} (stat)`
+                : "?";
+        const used = num(lu.numberUsed);
+        return `• ${str(a.name)}   ${used} used / ${maxStr} max   (${reset})`;
+    });
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+export function computeActions(core) {
+    const { char, classes, statMods } = core;
+    const allActions = getAllActions(char);
+    const allCharSpells = getCharSpellsForActions(char, classes);
+    // Spell activationTypes (from rule-data): 1=Action, 2=No Action, 3=Bonus Action, 4=Reaction, 8=Special
+    const bonusActionSpells = allCharSpells.filter(s => spellActivationType(s) === 3).map(formatSpellAction);
+    const reactionSpells = allCharSpells.filter(s => spellActivationType(s) === 4).map(formatSpellAction);
+    // activationType 3 = bonus action in class actions, 4 = reaction
+    // activationType 1 = action (weapon masteries — skip, shown in ACTIONS already)
+    // activationType 8 = special/passive — skip
+    const bonusActions = [
+        ...allActions.filter(a => activationType(a) === 3).map(a => `• ${str(a.name)}`),
+        ...bonusActionSpells,
+    ];
+    // Reactions: Opportunity Attack is universal, then class reactions, then reaction spells
+    const reactions = [
+        "• Opportunity Attack",
+        ...allActions.filter(a => activationType(a) === 4).map(a => `• ${str(a.name)}`),
+        ...reactionSpells,
+    ];
+    const limitedUseFeatures = buildLimitedUseLines(allActions, statMods);
+    return {
+        weaponAttacks: computeWeaponAttacks(core),
+        bonusActions,
+        reactions,
+        limitedUseFeatures,
+    };
+}
+export function formatCombatBlock(a) {
+    return [
+        `ACTIONS`,
+        ...(a.weaponAttacks.length ? a.weaponAttacks : ["  (none)"]),
+        ``,
+        `BONUS ACTIONS`,
+        ...(a.bonusActions.length ? a.bonusActions : ["  (none)"]),
+        ``,
+        `REACTIONS`,
+        ...(a.reactions.length ? a.reactions : ["  (none)"]),
+        ``,
+        ...(a.limitedUseFeatures.length ? [`LIMITED USE`, ...a.limitedUseFeatures, ``] : []),
+    ];
+}
+//# sourceMappingURL=actions.js.map

package/dist/tools/character/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/tools/character/actions.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/core.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `computeCoreStats(char)` — the foundation context object for the character
+ * module.
+ *
+ * Phase 2 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Computes the values that every per-domain module (vitals, stats, ac,
+ * weapons, spells, …) needs: flattened modifiers, classes, total level,
+ * proficiency bonus, ability scores + mods, inventory, and the template
+ * resolver. Computed once at the top of `parseCharacterData` and threaded
+ * downstream.
+ */
+import type { CharData, CoreStats } from "./types.js";
+export declare function computeCoreStats(char: CharData): CoreStats;
+//# sourceMappingURL=core.d.ts.map

package/dist/tools/character/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/tools/character/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAc,SAAS,EAAsB,MAAM,YAAY,CAAC;AAEtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CA4I1D"}

package/dist/tools/character/core.js

@@ -0,0 +1,156 @@
+/**
+ * `computeCoreStats(char)` — the foundation context object for the character
+ * module.
+ *
+ * Phase 2 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Computes the values that every per-domain module (vitals, stats, ac,
+ * weapons, spells, …) needs: flattened modifiers, classes, total level,
+ * proficiency bonus, ability scores + mods, inventory, and the template
+ * resolver. Computed once at the top of `parseCharacterData` and threaded
+ * downstream.
+ */
+import { arr, isBonusMod, isSetMod, num, modOf, obj, statKeys, statNames } from "./helpers.js";
+import { makeResolveTemplates } from "./templates.js";
+export function computeCoreStats(char) {
+    const classes = arr(char.classes);
+    const totalLevel = classes.reduce((s, c) => s + num(c.level), 0);
+    const profBonus = Math.floor((totalLevel - 1) / 4) + 2;
+    // PHB multiclass rule: only the *starting* class grants saving-throw
+    // proficiencies. DDB still hoists every class's Proficiencies-feature
+    // modifiers into modifiers.class regardless, so we drop the non-starting
+    // save-prof entries here at the source. Collect the starting class's
+    // classFeature + subclassFeature ids; a save-prof mod whose componentId
+    // is in that set is from the starting class and stays.
+    const startingClass = classes.find(c => c.isStartingClass === true) ?? classes[0];
+    const startingClassFeatureIds = new Set();
+    if (startingClass) {
+        for (const cf of arr(startingClass.classFeatures)) {
+            const id = num(obj(cf.definition).id);
+            if (id)
+                startingClassFeatureIds.add(id);
+        }
+        for (const cf of arr(obj(startingClass.subclassDefinition).classFeatures)) {
+            const id = num(obj(cf.definition).id);
+            if (id)
+                startingClassFeatureIds.add(id);
+        }
+    }
+    const isStartingClassSaveProf = (m) => {
+        if (m.type !== "proficiency")
+            return true;
+        if (typeof m.subType !== "string" || !m.subType.includes("saving-throws"))
+            return true;
+        const cid = num(m.componentId);
+        // cid === 0 means no componentId (hand-built fixtures, older DDB data) —
+        // keep, since we can't disprove it's from the starting class.
+        return cid === 0 || startingClassFeatureIds.has(cid);
+    };
+    const allMods = Object.entries(obj(char.modifiers)).flatMap(([source, list]) => {
+        const mods = arr(list);
+        return source === "class" || source === "subclass"
+            ? mods.filter(isStartingClassSaveProf)
+            : mods;
+    });
+    // ── Ability Scores ─────────────────────────────────────────────────────────
+    const baseStats = arr(char.stats);
+    const bonusStats = arr(char.bonusStats);
+    const overrideStats = arr(char.overrideStats);
+    // Sum ability-score `bonus` modifiers, but iterate per-source so we can
+    // gate race-sourced bonuses on `isGranted`. In the 2024 rules ability
+    // score increases come from the character's background (origin feat),
+    // not from race — DDB still emits the race-categorized ASI modifiers in
+    // the JSON, but they carry `isGranted: false` and the website ignores
+    // them. We must too, or the race ASI gets double-counted against
+    // char.stats (which already includes it).
+    //
+    // EXCEPTION: 2014 Half-Elf grants +2 CHA fixed plus two player-chosen +1s.
+    // The chosen ones are ALSO emitted as race mods with `isGranted: false` —
+    // same flag the 2024 declined-ASIs use. Discriminator: 2014 Half-Elf pairs
+    // each chosen +1 with a `choices.race` entry whose `optionValue` is in the
+    // 3520..3525 range (STR..CHA) and whose `componentId` matches the mod's.
+    // Build a multiset of (componentId, abilityIdx) picks and consume one per
+    // matching mod so duplicate picks (Danyr's STR+STR) stack correctly.
+    const ABILITY_OPTION_BASE = 3520;
+    const playerRaceAbilityPicks = [];
+    for (const ch of arr(obj(char.choices).race)) {
+        const opt = num(ch.optionValue);
+        if (opt < ABILITY_OPTION_BASE || opt > ABILITY_OPTION_BASE + 5)
+            continue;
+        playerRaceAbilityPicks.push({
+            componentId: num(ch.componentId),
+            abilityIdx: opt - ABILITY_OPTION_BASE,
+        });
+    }
+    const consumeMatchingRacePick = (componentId, abilityIdx) => {
+        const i = playerRaceAbilityPicks.findIndex(p => p.componentId === componentId && p.abilityIdx === abilityIdx);
+        if (i < 0)
+            return false;
+        playerRaceAbilityPicks.splice(i, 1);
+        return true;
+    };
+    const scoreBonuses = {};
+    for (const [source, list] of Object.entries(obj(char.modifiers))) {
+        for (const m of arr(list)) {
+            if (!isBonusMod(m))
+                continue;
+            if (!m.subType.endsWith("-score"))
+                continue;
+            const idx = statKeys.indexOf(m.subType.replace("-score", ""));
+            if (idx < 0)
+                continue;
+            if (source === "race" && m.isGranted === false) {
+                // Allow through only if the player has a matching race-ability pick
+                // (2014 Half-Elf shape). Otherwise this is a declined 2024-style ASI.
+                if (!consumeMatchingRacePick(num(m.componentId), idx))
+                    continue;
+            }
+            scoreBonuses[idx + 1] = (scoreBonuses[idx + 1] ?? 0) + num(m.fixedValue);
+        }
+    }
+    const scoreSetValues = {};
+    for (const m of allMods) {
+        if (isSetMod(m) && m.subType.endsWith("-score")) {
+            const idx = statKeys.indexOf(m.subType.replace("-score", ""));
+            if (idx >= 0) {
+                const setVal = num(m.fixedValue ?? m.value);
+                if (setVal > 0)
+                    scoreSetValues[idx + 1] = Math.max(scoreSetValues[idx + 1] ?? 0, setVal);
+            }
+        }
+    }
+    // PHB cap: ability scores from race/class/feat/background ASI sources max
+    // out at 20 (both 2014 and 2024 PHB). Two sources are explicitly allowed
+    // to exceed: manual overrides via `overrideStats` and `type:"set"` item
+    // modifiers (Belt of Giant Strength, Manual of Bodily Health, etc.).
+    // Without this cap, characters like Calderax (base 18 + multiple +1 ASIs)
+    // display as 21 (+5) while the DDB website shows 20 (+5).
+    const ABILITY_SCORE_CAP = 20;
+    const statTotals = statNames.map((_, i) => {
+        const id = i + 1;
+        const base = baseStats.find(s => num(s.id) === id);
+        const bonus = bonusStats.find(s => num(s.id) === id);
+        const override = overrideStats.find(s => num(s.id) === id);
+        const baseVal = num(base?.value ?? 0);
+        const bonusVal = num(bonus?.value ?? 0);
+        const overrideVal = override?.value != null ? num(override.value) : null;
+        const calculated = overrideVal != null ? overrideVal : baseVal + bonusVal + (scoreBonuses[id] ?? 0);
+        const capped = overrideVal != null ? calculated : Math.min(calculated, ABILITY_SCORE_CAP);
+        return scoreSetValues[id] != null ? Math.max(capped, scoreSetValues[id]) : capped;
+    });
+    const statMods = statTotals.map(modOf);
+    const inventory = arr(char.inventory);
+    const resolveTemplates = makeResolveTemplates(profBonus, totalLevel);
+    return {
+        char,
+        allMods,
+        statTotals,
+        statMods,
+        profBonus,
+        totalLevel,
+        classes,
+        inventory,
+        resolveTemplates,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/tools/character/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/tools/character/core.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/defenses.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Defenses domain — damage resistances / immunities / vulnerabilities and
+ * active conditions. Owns the defenses block.
+ *
+ * Phase 5b of the character.ts refactor — see docs/character-refactor.md.
+ */
+import type { CoreStats } from "./types.js";
+export interface Defenses {
+    resistances: string[];
+    immunities: string[];
+    vulnerabilities: string[];
+    conditions: string[];
+}
+export declare function computeDefenses(core: CoreStats): Defenses;
+export declare function formatDefensesBlock(d: Defenses): string[];
+//# sourceMappingURL=defenses.d.ts.map

package/dist/tools/character/defenses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defenses.d.ts","sourceRoot":"","sources":["../../../src/tools/character/defenses.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAczD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CASzD"}

package/dist/tools/character/defenses.js

@@ -0,0 +1,27 @@
+/**
+ * Defenses domain — damage resistances / immunities / vulnerabilities and
+ * active conditions. Owns the defenses block.
+ *
+ * Phase 5b of the character.ts refactor — see docs/character-refactor.md.
+ */
+import { arr, capitalize, isImmunityMod, isResistanceMod, isVulnerabilityMod, str } from "./helpers.js";
+export function computeDefenses(core) {
+    const { char, allMods } = core;
+    return {
+        resistances: [...new Set(allMods.filter(isResistanceMod).map(m => capitalize(m.subType)))],
+        immunities: [...new Set(allMods.filter(isImmunityMod).map(m => capitalize(m.subType)))],
+        vulnerabilities: [...new Set(allMods.filter(isVulnerabilityMod).map(m => capitalize(m.subType)))],
+        conditions: arr(char.conditions).map(c => str(c.id)),
+    };
+}
+export function formatDefensesBlock(d) {
+    return [
+        `DEFENSES`,
+        `  Resistances: ${d.resistances.length ? d.resistances.join(", ") : "(none)"}`,
+        `  Immunities: ${d.immunities.length ? d.immunities.join(", ") : "(none)"}`,
+        `  Vulnerabilities: ${d.vulnerabilities.length ? d.vulnerabilities.join(", ") : "(none)"}`,
+        `CONDITIONS: ${d.conditions.length ? d.conditions.join(", ") : "(none)"}`,
+        ``,
+    ];
+}
+//# sourceMappingURL=defenses.js.map

package/dist/tools/character/defenses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defenses.js","sourceRoot":"","sources":["../../../src/tools/character/defenses.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAUxG,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,OAAO;QACL,WAAW,EAAE,CAAC,GAAG,IAAI,GAAG,CACtB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAChE,CAAC;QACF,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CACrB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAC9D,CAAC;QACF,eAAe,EAAE,CAAC,GAAG,IAAI,GAAG,CAC1B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CACnE,CAAC;QACF,UAAU,EAAE,GAAG,CAA0B,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,CAAW;IAC7C,OAAO;QACL,UAAU;QACV,kBAAkB,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC9E,iBAAiB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3E,sBAAsB,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC1F,eAAe,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACzE,EAAE;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/character/definition.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Definition lookup — searches a character's known spells, feats, class &
+ * subclass features, racial traits, background feature, and equipped items
+ * for a name match, and returns formatted definitions for the hits.
+ *
+ * Phase 9 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * `getDefinition` is the public entry point (re-exported from character.ts).
+ * It depends on `getCharacter` from the network/IO layer in character.ts
+ * — that import is intentionally one-way (definition consumes IO, not
+ * the other way around).
+ */
+export declare function getDefinition(characterId: string, query: string): Promise<string>;
+//# sourceMappingURL=definition.d.ts.map

package/dist/tools/character/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/tools/character/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA+MH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/tools/character/definition.js

@@ -0,0 +1,205 @@
+/**
+ * Definition lookup — searches a character's known spells, feats, class &
+ * subclass features, racial traits, background feature, and equipped items
+ * for a name match, and returns formatted definitions for the hits.
+ *
+ * Phase 9 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * `getDefinition` is the public entry point (re-exported from character.ts).
+ * It depends on `getCharacter` from the network/IO layer in character.ts
+ * — that import is intentionally one-way (definition consumes IO, not
+ * the other way around).
+ */
+import { stripHtml as stripHtmlFull } from "../../utils.js";
+import { getCharacter } from "../character.js";
+import { levenshteinDistance } from "./helpers.js";
+function matchesDefinitionQuery(name, query) {
+    const n = name.toLowerCase();
+    const q = query.toLowerCase();
+    if (n.includes(q))
+        return true;
+    return name.split(/\s+/).some(w => levenshteinDistance(q, w.toLowerCase()) <= 2);
+}
+function formatSpellResult(spell) {
+    const d = (spell.definition ?? spell);
+    const name = String(d.name ?? "Unknown");
+    const level = Number(d.level ?? 0);
+    const school = String(d.school ?? "");
+    const levelLabel = level === 0 ? "Cantrip" : `Level ${level}`;
+    const ACTIVATION_TYPES = { 1: "Action", 3: "Bonus Action", 6: "Reaction" };
+    const act = d.activation;
+    const castingTime = act
+        ? `${act.activationTime} ${ACTIVATION_TYPES[Number(act.activationType)] ?? "Action"}`
+        : "1 Action";
+    const rng = d.range;
+    let range = "Self";
+    if (rng) {
+        if (rng.rangeValue && rng.origin !== "Self")
+            range = `${rng.rangeValue} ft`;
+        else
+            range = String(rng.origin ?? "Self");
+        if (rng.aoeType && rng.aoeValue)
+            range += ` (${rng.aoeValue}-ft ${rng.aoeType})`;
+    }
+    const dur = d.duration;
+    let duration = "Instantaneous";
+    if (dur) {
+        const isConc = dur.durationType === "Concentration";
+        if (dur.durationInterval && dur.durationUnit) {
+            duration = `${isConc ? "Concentration, up to " : ""}${dur.durationInterval} ${dur.durationUnit}${Number(dur.durationInterval) > 1 ? "s" : ""}`;
+        }
+        else if (isConc) {
+            duration = "Concentration";
+        }
+    }
+    const components = (Array.isArray(d.components) ? d.components : [])
+        .map((c) => ({ 1: "V", 2: "S", 3: "M" })[c])
+        .filter(Boolean)
+        .join(", ");
+    const matNote = d.componentsDescription ? ` (${d.componentsDescription})` : "";
+    const lines = [
+        `${name} (${levelLabel} ${school})`,
+        `Casting Time: ${castingTime}`,
+        `Range: ${range}`,
+        `Components: ${components || "None"}${matNote}`,
+        `Duration: ${duration}`,
+    ];
+    if (d.ritual)
+        lines.push("Ritual: Yes");
+    lines.push("", stripHtmlFull(String(d.description ?? "")));
+    return lines.join("\n");
+}
+function formatFeatResult(feat) {
+    const d = (feat.definition ?? feat);
+    const lines = [String(d.name ?? "Unknown")];
+    if (d.prerequisite)
+        lines.push(`Prerequisite: ${d.prerequisite}`);
+    lines.push("", stripHtmlFull(String(d.description ?? d.snippet ?? "")));
+    return lines.join("\n");
+}
+function formatClassFeatureResult(feature, className, level) {
+    const d = (feature.definition ?? feature);
+    const name = String(d.name ?? feature.name ?? "Unknown");
+    const desc = stripHtmlFull(String(d.description ?? d.snippet ?? ""));
+    return `${name} (${className}, Level ${level})\n\n${desc}`;
+}
+function formatRacialTraitResult(trait, raceName) {
+    const d = (trait.definition ?? trait);
+    const name = String(d.name ?? "Unknown");
+    const desc = stripHtmlFull(String(d.description ?? d.snippet ?? ""));
+    return `${name} (${raceName})\n\n${desc}`;
+}
+function formatItemResult(item) {
+    const d = (item.definition ?? item);
+    const name = String(d.name ?? "Unknown");
+    const type = String(d.type ?? "Item");
+    const rarity = String(d.rarity ?? "Common");
+    const weight = d.weight != null ? `Weight: ${d.weight} lb\n` : "";
+    const desc = stripHtmlFull(String(d.description ?? ""));
+    return `${name} (${type}, ${rarity})\n${weight}\n${desc}`;
+}
+function searchDefinitions(char, query) {
+    const results = [];
+    // searchDefinitions intentionally keeps these as locals (not the shared
+    // helpers) — its tolerance for unexpected shapes differs slightly (e.g.
+    // it accepts `spell.name` as a fallback for `spell.definition.name`).
+    const arr = (v) => (Array.isArray(v) ? v : []);
+    const obj = (v) => v != null && typeof v === "object" && !Array.isArray(v) ? v : {};
+    const str = (v) => (typeof v === "string" ? v : "");
+    const num = (v) => (typeof v === "number" ? v : 0);
+    // ── Spells ────────────────────────────────────────────────────────────────
+    const allSpells = [
+        ...arr(char.classSpells).flatMap(cs => arr(cs.spells)),
+        ...Object.values(obj(char.spells)).flatMap(v => arr(v)),
+    ];
+    for (const spell of allSpells) {
+        const name = str(obj(spell.definition).name || spell.name);
+        if (name && matchesDefinitionQuery(name, query)) {
+            results.push({ type: "Spell", text: formatSpellResult(spell) });
+        }
+    }
+    // ── Feats ─────────────────────────────────────────────────────────────────
+    for (const feat of arr(char.feats)) {
+        const name = str(obj(feat.definition).name);
+        if (name && matchesDefinitionQuery(name, query)) {
+            results.push({ type: "Feat", text: formatFeatResult(feat) });
+        }
+    }
+    // ── Class & Subclass Features ─────────────────────────────────────────────
+    const seen = new Set();
+    for (const cls of arr(char.classes)) {
+        const charLevel = num(cls.level);
+        const className = str(obj(cls.definition).name);
+        for (const cf of arr(cls.classFeatures)) {
+            const d = obj(cf.definition);
+            const name = str(d.name);
+            const requiredLevel = num(d.requiredLevel || 1);
+            if (requiredLevel <= charLevel && name && matchesDefinitionQuery(name, query) && !seen.has(name)) {
+                seen.add(name);
+                results.push({
+                    type: "Class Feature",
+                    text: formatClassFeatureResult(cf, className, requiredLevel),
+                });
+            }
+        }
+        const subDef = obj(cls.subclassDefinition);
+        const subName = str(subDef.name);
+        for (const cf of arr(subDef.classFeatures)) {
+            const d = obj(cf.definition);
+            const name = str(d.name);
+            const requiredLevel = num(d.requiredLevel || 1);
+            const label = subName ? `${className} / ${subName}` : className;
+            if (requiredLevel <= charLevel && name && matchesDefinitionQuery(name, query) && !seen.has(name)) {
+                seen.add(name);
+                results.push({
+                    type: "Subclass Feature",
+                    text: formatClassFeatureResult(cf, label, requiredLevel),
+                });
+            }
+        }
+    }
+    // ── Racial Traits ─────────────────────────────────────────────────────────
+    const raceName = str(obj(char.race).fullName || obj(char.race).baseName);
+    for (const trait of arr(obj(char.race).racialTraits)) {
+        const name = str(obj(trait.definition).name);
+        if (name && matchesDefinitionQuery(name, query)) {
+            results.push({ type: "Racial Trait", text: formatRacialTraitResult(trait, raceName) });
+        }
+    }
+    // ── Background Feature ────────────────────────────────────────────────────
+    const bgDef = obj(obj(char.background).definition);
+    const bgFeatureName = str(bgDef.featureName);
+    if (bgFeatureName && matchesDefinitionQuery(bgFeatureName, query)) {
+        const bgName = str(bgDef.name);
+        const bgDesc = stripHtmlFull(str(bgDef.featureDescription));
+        results.push({
+            type: "Background Feature",
+            text: `${bgFeatureName} (${bgName})\n\n${bgDesc}`,
+        });
+    }
+    // ── Equipped Items ────────────────────────────────────────────────────────
+    for (const item of arr(char.inventory)) {
+        if (!item.equipped)
+            continue;
+        const name = str(obj(item.definition).name);
+        if (name && matchesDefinitionQuery(name, query)) {
+            results.push({ type: "Item", text: formatItemResult(item) });
+        }
+    }
+    return results;
+}
+export async function getDefinition(characterId, query) {
+    const jsonData = await getCharacter(characterId);
+    const raw = JSON.parse(jsonData);
+    const char = (raw?.data ?? raw);
+    const hits = searchDefinitions(char, query);
+    if (hits.length === 0) {
+        return `No definition found matching "${query}" on this character. Try a partial name like "hunter" for Hunter's Mark.`;
+    }
+    if (hits.length > 3) {
+        const list = hits.map((h, i) => `${i + 1}. [${h.type}] ${h.text.split("\n")[0]}`).join("\n");
+        return `Found ${hits.length} matches for "${query}". Be more specific, or here are the matches:\n\n${list}`;
+    }
+    return hits.map(h => `[${h.type}]\n${h.text}`).join("\n\n===\n\n");
+}
+//# sourceMappingURL=definition.js.map

package/dist/tools/character/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/tools/character/definition.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/features.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Features domain — feats (real + disguised), class features, racial traits,
+ * background feature. Owns the features block.
+ *
+ * Phase 5c of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Output strings are pre-formatted (e.g. featLines = ["• Great Weapon Master: …"])
+ * to preserve byte-for-byte parity with the original inline code.
+ */
+import type { CoreStats } from "./types.js";
+export interface BackgroundFeature {
+    name: string;
+    isFeat: boolean;
+    descSnippet: string;
+}
+export interface Features {
+    featLines: string[];
+    disguisedFeatLines: string[];
+    realFeatCount: number;
+    classFeatureLines: string[];
+    racialTraitLines: string[];
+    background: BackgroundFeature;
+}
+export declare function computeFeatures(core: CoreStats): Features;
+export declare function formatFeaturesBlock(f: Features): string[];
+//# sourceMappingURL=features.d.ts.map

package/dist/tools/character/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/tools/character/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAwB,SAAS,EAAO,MAAM,YAAY,CAAC;AAGvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAqED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAWzD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CA0BzD"}