@iamjameslennon/ddb-mcp 2.7.1 → 2.9.0

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

@@ -0,0 +1,133 @@
+/**
+ * Shared types for the character module.
+ *
+ * Phase 1 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * `Mod`, `ClassEntry`, `InventoryItem`, `CharData` are all currently aliased
+ * to `Record<string, unknown>`. They will be tightened to proper shapes
+ * post-refactor (see follow-up A in the refactor doc) — the aliases exist so
+ * future tightening is a one-place change instead of a sweep.
+ */
+export type CharData = Record<string, unknown>;
+export type Mod = Record<string, unknown>;
+export type ClassEntry = Record<string, unknown>;
+export type InventoryItem = Record<string, unknown>;
+/** `type:"proficiency"` — skill/save/tool/weapon/armor/language proficiency grant. */
+export interface ProficiencyMod {
+    type: "proficiency";
+    subType: string;
+}
+/** `type:"expertise"` — doubles proficiency bonus on the given skill/tool. */
+export interface ExpertiseMod {
+    type: "expertise";
+    subType: string;
+}
+/** `type:"half-proficiency"` — half-prof (Jack of All Trades family). */
+export interface HalfProficiencyMod {
+    type: "half-proficiency";
+    subType: string;
+}
+/**
+ * `type:"bonus"` — additive numeric modifier. Most varied mod type in DDB:
+ * AC, skill bonuses, ability-score buffs, HP-per-level, initiative, speed,
+ * hit/damage. The value is in `value` OR `fixedValue` (use `??` —
+ * "whichever is present"), or computed from `statId` (e.g. Gloom Stalker
+ * Dread Ambusher adds WIS mod to initiative). `bonusTypes` indicates a
+ * dynamic value source (e.g. `[1]` = use the proficiency bonus).
+ * `isGranted: false` on a race mod means the player declined the ASI
+ * (2024 floating-ASI rule).
+ */
+export interface BonusMod {
+    type: "bonus";
+    subType: string;
+    value?: number | null;
+    fixedValue?: number | null;
+    statId?: number | null;
+    isGranted?: boolean;
+    bonusTypes?: number[];
+}
+/**
+ * `type:"set"` — replaces the base value (e.g. Belt of Giant Strength sets STR
+ * to 23, Boots of Striding and Springing set walking speed to 40, Draconic
+ * Resilience sets unarmored AC base via `unarmored-armor-class`).
+ * `componentId` discriminates dual-encoded set+sense pairs from same-source
+ * extensions in the sense calculation.
+ */
+export interface SetMod {
+    type: "set";
+    subType: string;
+    value?: number | null;
+    fixedValue?: number | null;
+    statId?: number | null;
+    componentId?: number;
+}
+/**
+ * `type:"set-base"` — baseline-establishing set, used by senses (e.g. race
+ * darkvision baseline 60 ft.). Functionally identical to `set` for the
+ * baseline pass; the distinct type exists because DDB sometimes emits both.
+ */
+export interface SetBaseMod {
+    type: "set-base";
+    subType: string;
+    value?: number | null;
+    fixedValue?: number | null;
+    componentId?: number;
+}
+/**
+ * `type:"sense"` — grants or extends a sense (Darkvision, Blindsight, etc.).
+ * Pass 2 of the sense calculation uses `componentId` to decide whether the mod
+ * is a dual encoding of the baseline (take max) or an extension from a
+ * different source (additive — Gloom Stalker Umbral Sight +30 ft on race
+ * darkvision 60 ft).
+ */
+export interface SenseMod {
+    type: "sense";
+    subType: string;
+    value?: number | null;
+    componentId?: number;
+}
+/** `type:"resistance"` — damage resistance grant (e.g. "fire", "cold"). */
+export interface ResistanceMod {
+    type: "resistance";
+    subType: string;
+}
+/** `type:"immunity"` — damage immunity grant (e.g. "poison", "psychic"). */
+export interface ImmunityMod {
+    type: "immunity";
+    subType: string;
+}
+/** `type:"vulnerability"` — damage vulnerability grant. */
+export interface VulnerabilityMod {
+    type: "vulnerability";
+    subType: string;
+}
+/**
+ * `type:"language"` — language proficiency grant. The standard race/class/feat
+ * source for languages. The other two storage mechanisms (custom proficiencies
+ * with `type: 3`, and `characterValues` entries with `typeId: 35`) live
+ * outside `modifiers` and don't use this interface.
+ */
+export interface LanguageMod {
+    type: "language";
+    subType: string;
+}
+export type ParseSection = "summary" | "combat" | "spells" | "inventory" | "features" | "concentration" | "notes" | "full";
+/**
+ * The shared context object passed to every per-domain computer module.
+ *
+ * Computed once by `computeCoreStats(char)` (Phase 2) and threaded through
+ * vitals/stats/spells/etc. Avoids each module re-deriving statMods,
+ * profBonus, allMods, etc.
+ */
+export interface CoreStats {
+    readonly char: CharData;
+    readonly allMods: readonly Mod[];
+    readonly statTotals: readonly number[];
+    readonly statMods: readonly number[];
+    readonly profBonus: number;
+    readonly totalLevel: number;
+    readonly classes: readonly ClassEntry[];
+    readonly inventory: readonly InventoryItem[];
+    readonly resolveTemplates: (text: string, classLevel?: number) => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/character/types.js

@@ -0,0 +1,12 @@
+/**
+ * Shared types for the character module.
+ *
+ * Phase 1 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * `Mod`, `ClassEntry`, `InventoryItem`, `CharData` are all currently aliased
+ * to `Record<string, unknown>`. They will be tightened to proper shapes
+ * post-refactor (see follow-up A in the refactor doc) — the aliases exist so
+ * future tightening is a one-place change instead of a sweep.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/character/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

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

@@ -0,0 +1,34 @@
+/**
+ * Vitals domain — HP, hit dice, speed (all 5 modes), initiative, death saves.
+ * Owns the vitals block.
+ *
+ * Phase 3 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * AC is its own module ([Phase 4 → ac.ts]) — `formatVitalsBlock` takes it as
+ * a separate parameter rather than including it in `Vitals`, since AC isn't
+ * a vitals concern.
+ */
+import type { CoreStats } from "./types.js";
+export interface HitPoints {
+    current: number;
+    max: number;
+    temp: number;
+}
+export interface DeathSaves {
+    successes: number;
+    failures: number;
+}
+export interface Vitals {
+    hp: HitPoints;
+    hitDice: string[];
+    initiative: number;
+    speed: string[];
+    deathSaves: DeathSaves;
+}
+export declare function computeVitals(core: CoreStats): Vitals;
+/**
+ * `ac` is computed by ./ac.js (Phase 4) and threaded in here separately
+ * because AC has its own module. `profBonus` is from CoreStats.
+ */
+export declare function formatVitalsBlock(v: Vitals, ac: number, profBonus: number): string[];
+//# sourceMappingURL=vitals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../../../src/tools/character/vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAwB,SAAS,EAAO,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,SAAS;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACzE,MAAM,WAAW,UAAU;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAEnE,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,SAAS,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAmKD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAQrD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpF"}

package/dist/tools/character/vitals.js

@@ -0,0 +1,198 @@
+/**
+ * Vitals domain — HP, hit dice, speed (all 5 modes), initiative, death saves.
+ * Owns the vitals block.
+ *
+ * Phase 3 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * AC is its own module ([Phase 4 → ac.ts]) — `formatVitalsBlock` takes it as
+ * a separate parameter rather than including it in `Vitals`, since AC isn't
+ * a vitals concern.
+ */
+import { arr, hasRemarkableAthlete, isBonusMod, isHalfProficiencyMod, isSetMod, num, obj, signed, str } from "./helpers.js";
+// ── HP ───────────────────────────────────────────────────────────────────────
+function computeHp(core) {
+    const { char, allMods, statMods, totalLevel } = core;
+    // baseHitPoints does NOT include the CON modifier — must add conMod × level.
+    const conMod = statMods[2];
+    // Tough feat and Dwarven Toughness grant type:"bonus" subType:"hit-points-per-level" (value 2 or 1).
+    const hpPerLevelBonus = allMods
+        .filter(m => isBonusMod(m) && m.subType === "hit-points-per-level")
+        .reduce((s, m) => s + num(m.value ?? m.fixedValue), 0);
+    // When the player rolls for HP (or manually edits their max), DDB stores the
+    // final value in `overrideHitPoints`. This already includes CON mod and any
+    // hit-points-per-level features baked in — we must NOT add them on top.
+    // `bonusHitPoints` (items, Aid, etc.) still stacks on top either way.
+    // A literal 0 is treated as "not overridden" — defensive against malformed data.
+    const override = num(char.overrideHitPoints);
+    const bonus = num(char.bonusHitPoints);
+    const max = override > 0
+        ? override + bonus
+        : num(char.baseHitPoints) + bonus + ((conMod + hpPerLevelBonus) * totalLevel);
+    const current = max - num(char.removedHitPoints);
+    const temp = num(char.temporaryHitPoints);
+    return { current, max, temp };
+}
+// ── Hit dice ─────────────────────────────────────────────────────────────────
+function computeHitDice(classes) {
+    return classes.map(c => {
+        const die = num(obj(c.definition).hitDice);
+        const lvl = num(c.level);
+        const used = num(c.hitDiceUsed);
+        return `${lvl}d${die} (${lvl - used} remaining)`;
+    });
+}
+// ── Speed ────────────────────────────────────────────────────────────────────
+function computeSpeed(core) {
+    const { char, allMods } = core;
+    const weightSpeeds = obj(obj(obj(char.race).weightSpeeds).normal);
+    // Tasha's optional class features (Roving, Canny, Tireless, etc.) live in
+    // char.options.class. When preferences.enableOptionalClassFeatures is
+    // false, DDB does NOT include them in char.classes[].classFeatures, but
+    // their modifiers still appear in char.modifiers.class with
+    // `isGranted: true`. The website ignores those orphan modifiers; we must
+    // too. Discriminator: the modifier's componentId must match the id of a
+    // feature actually present in classFeatures/subclassFeatures. Hand-built
+    // fixtures don't set componentId at all (cid=0) — those bypass the filter
+    // unchanged.
+    const grantedClassFeatureIds = new Set();
+    for (const c of arr(char.classes)) {
+        for (const cf of arr(c.classFeatures)) {
+            const id = num(obj(cf.definition).id);
+            if (id)
+                grantedClassFeatureIds.add(id);
+        }
+        for (const cf of arr(obj(c.subclassDefinition).classFeatures)) {
+            const id = num(obj(cf.definition).id);
+            if (id)
+                grantedClassFeatureIds.add(id);
+        }
+    }
+    // Build the set of modifier object identities (by reference) that originate
+    // from a class/subclass category but whose componentId is orphaned — these
+    // must be skipped. Other sources (race, feat, item, background, condition)
+    // never get filtered.
+    const skippedClassMods = new Set();
+    for (const [source, list] of Object.entries(obj(char.modifiers))) {
+        if (source !== "class" && source !== "subclass")
+            continue;
+        for (const m of arr(list)) {
+            const cid = num(m.componentId);
+            if (cid !== 0 && !grantedClassFeatureIds.has(cid))
+                skippedClassMods.add(m);
+        }
+    }
+    const isApplicable = (m) => !skippedClassMods.has(m);
+    // DDB uses three subType patterns for speed modifiers:
+    //   - `innate-speed-{axis}` — race-granted base / overrides (e.g. Dwarven slow speed)
+    //   - `speed-{axis}` — class/feat/subclass axis-specific bonus (e.g. Scout's Superior Mobility, Ranger's Roving)
+    //   - `speed` (no axis suffix) — generic walking-speed bonus (e.g. Barbarian Fast Movement, Mobile feat, Longstrider)
+    // `set` mods override the base axis speed; `bonus` mods stack on top.
+    const speedCalc = (axis, base, fallback = 0) => {
+        const subTypes = new Set([`innate-speed-${axis}`, `speed-${axis}`]);
+        // The bare "speed" subType is a walking-default bonus only; never applies to fly/swim/climb/burrow.
+        if (axis === "walking")
+            subTypes.add("speed");
+        const override = allMods
+            .filter(m => isSetMod(m) && subTypes.has(m.subType) && num(m.value ?? m.fixedValue) > 0 && isApplicable(m))
+            .reduce((max, m) => Math.max(max, num(m.value ?? m.fixedValue)), 0);
+        const bonus = allMods
+            .filter(m => isBonusMod(m) && subTypes.has(m.subType) && isApplicable(m))
+            .reduce((s, m) => s + num(m.value ?? m.fixedValue), 0);
+        return (override || base || fallback) + bonus;
+    };
+    // Monk Unarmored Movement uses "unarmored-movement" rather than "innate-speed-walking".
+    // Per PHB: only applies "while you are not wearing armor or wielding a
+    // shield." Gate on the absence of any equipped item with filterType="Armor"
+    // (which covers both body armor and shields, since DDB uses armorTypeId
+    // 1/2/3 for light/medium/heavy and 4 for shield, all under the same
+    // filterType).
+    const hasEquippedArmorOrShield = arr(char.inventory).some(i => i.equipped === true && str(obj(i.definition).filterType) === "Armor");
+    const unarmoredMoveBonus = hasEquippedArmorOrShield
+        ? 0
+        : allMods
+            .filter(m => isBonusMod(m) && m.subType === "unarmored-movement" && isApplicable(m))
+            .reduce((s, m) => s + num(m.value ?? m.fixedValue), 0);
+    const walkSpeed = speedCalc("walking", num(weightSpeeds.walk), 30) + unarmoredMoveBonus;
+    const flySpeed = speedCalc("flying", num(weightSpeeds.fly));
+    const swimSpeed = speedCalc("swimming", num(weightSpeeds.swim));
+    const climbSpeed = speedCalc("climbing", num(weightSpeeds.climb));
+    const burrowSpeed = speedCalc("burrowing", num(weightSpeeds.burrow));
+    const parts = [`${walkSpeed} ft.`];
+    if (flySpeed > 0)
+        parts.push(`fly ${flySpeed} ft.`);
+    if (swimSpeed > 0)
+        parts.push(`swim ${swimSpeed} ft.`);
+    if (climbSpeed > 0)
+        parts.push(`climb ${climbSpeed} ft.`);
+    if (burrowSpeed > 0)
+        parts.push(`burrow ${burrowSpeed} ft.`);
+    return parts;
+}
+// ── Initiative ───────────────────────────────────────────────────────────────
+function computeInitiative(core) {
+    const { allMods, statMods, classes, profBonus } = core;
+    const dexMod = statMods[1];
+    const initiativeBonus = allMods
+        .filter(m => isBonusMod(m) && m.subType === "initiative")
+        .reduce((s, m) => {
+        // bonusTypes [1] means the bonus value is the proficiency bonus, not a fixed number
+        const usesProfBonus = arr(m.bonusTypes).includes(1) && (m.fixedValue == null && m.value == null);
+        if (usesProfBonus)
+            return s + profBonus;
+        if (m.value != null)
+            return s + num(m.value);
+        if (m.fixedValue != null)
+            return s + num(m.fixedValue);
+        // statId-based bonus (e.g. Gloom Stalker Dread Ambusher adds WIS mod to initiative)
+        const sid = num(m.statId);
+        return s + (sid > 0 ? statMods[sid - 1] : 0);
+    }, 0);
+    // Half-proficiency to initiative comes from two distinct sources:
+    //
+    //   1. Bard's Jack of All Trades emits an explicit
+    //      `type:"half-proficiency" subType:"initiative"` modifier (in addition
+    //      to its `subType:"ability-checks"` modifier that drives skills).
+    //      PHB rule: round DOWN.
+    //   2. Champion Fighter's Remarkable Athlete emits NO modifier at all —
+    //      detection is by subclass name + level (see hasRemarkableAthlete).
+    //      PHB rule: round UP.
+    //
+    // We must NOT infer initiative half-prof from `subType:"ability-checks"`
+    // alone — the DDB website doesn't. If a character has both JoAT and RA
+    // somehow (Bard 2 / Champion 7 multiclass), take the max rather than
+    // double-stacking.
+    const joatInit = allMods.some(m => isHalfProficiencyMod(m) && m.subType === "initiative")
+        ? Math.floor(profBonus / 2)
+        : 0;
+    const raInit = hasRemarkableAthlete(classes) ? Math.ceil(profBonus / 2) : 0;
+    return dexMod + initiativeBonus + Math.max(joatInit, raInit);
+}
+// ── Death saves ──────────────────────────────────────────────────────────────
+function computeDeathSaves(char) {
+    const ds = obj(char.deathSaves);
+    return { successes: num(ds.successCount), failures: num(ds.failCount) };
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+export function computeVitals(core) {
+    return {
+        hp: computeHp(core),
+        hitDice: computeHitDice(core.classes),
+        initiative: computeInitiative(core),
+        speed: computeSpeed(core),
+        deathSaves: computeDeathSaves(core.char),
+    };
+}
+/**
+ * `ac` is computed by ./ac.js (Phase 4) and threaded in here separately
+ * because AC has its own module. `profBonus` is from CoreStats.
+ */
+export function formatVitalsBlock(v, ac, profBonus) {
+    return [
+        `HP: ${v.hp.current}/${v.hp.max}   Temp HP: ${v.hp.temp || "—"}   Prof Bonus: ${signed(profBonus)}`,
+        `Hit Dice: ${v.hitDice.join(" / ")}`,
+        `AC: ${ac}   Initiative: ${signed(v.initiative)}   Speed: ${v.speed.join(", ")}`,
+        `Death Saves: Successes ${v.deathSaves.successes}/3   Failures ${v.deathSaves.failures}/3`,
+        ``,
+    ];
+}
+//# sourceMappingURL=vitals.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Weapons domain — weapon attack rolls for equipped inventory weapons.
+ *
+ * Phase 6a of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Owns ability-mod selection (finesse, ranged, Martial Arts monk weapons),
+ * proficiency bonus, magic enhancement (+1/+2/+3 from grantedModifiers), and
+ * duplicate consolidation (×2 daggers, etc.). Output is pre-formatted lines
+ * to preserve byte-for-byte parity with the original inline code.
+ */
+import type { CoreStats } from "./types.js";
+export declare function computeWeaponAttacks(core: CoreStats): string[];
+//# sourceMappingURL=weapons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"weapons.d.ts","sourceRoot":"","sources":["../../../src/tools/character/weapons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAgF9D"}

package/dist/tools/character/weapons.js

@@ -0,0 +1,79 @@
+/**
+ * Weapons domain — weapon attack rolls for equipped inventory weapons.
+ *
+ * Phase 6a of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Owns ability-mod selection (finesse, ranged, Martial Arts monk weapons),
+ * proficiency bonus, magic enhancement (+1/+2/+3 from grantedModifiers), and
+ * duplicate consolidation (×2 daggers, etc.). Output is pre-formatted lines
+ * to preserve byte-for-byte parity with the original inline code.
+ */
+import { arr, isBonusMod, isProficiencyMod, num, obj, signed, str } from "./helpers.js";
+export function computeWeaponAttacks(core) {
+    const { allMods, classes, inventory, statMods, profBonus } = core;
+    const dexMod = statMods[1];
+    const weaponProfSlugs = new Set(allMods.filter(isProficiencyMod).map(m => m.subType));
+    const isWeaponProficient = (def) => {
+        const catId = num(def.categoryId); // 1=simple, 2=martial
+        const typeName = str(def.type).toLowerCase().replace(/[,\s]+/g, "-");
+        return (catId === 1 && weaponProfSlugs.has("simple-weapons")) ||
+            (catId === 2 && weaponProfSlugs.has("martial-weapons")) ||
+            weaponProfSlugs.has(typeName);
+    };
+    // Martial Arts: allows DEX for monk weapons (simple melee + shortsword, no Two-Handed/Heavy)
+    const hasMartialArts = allMods.some(m => str(m.subType) === "martial-arts") ||
+        classes.some(c => arr(c.classFeatures).some(cf => str(obj(cf.definition).name) === "Martial Arts" &&
+            num(obj(cf.definition).requiredLevel || 1) <= num(c.level)));
+    const weaponInventoryMap = new Map();
+    for (const i of inventory) {
+        const def = obj(i.definition);
+        if (str(def.filterType) !== "Weapon")
+            continue;
+        if (i.equipped !== true)
+            continue; // only show equipped weapons in ACTIONS
+        const wName = str(def.name);
+        const dmg = obj(def.damage);
+        const dmgDice = str(dmg.diceString);
+        const dmgType = str(def.damageType).toLowerCase();
+        const attackType = num(def.attackType); // 1=melee, 2=ranged
+        const props = arr(def.properties).map(p => str(p.name));
+        const isFinesse = props.includes("Finesse");
+        const isRanged = attackType === 2;
+        const range = num(def.range);
+        const longRange = num(def.longRange);
+        const mastery = str(def.mastery);
+        // Magic enhancement bonus from grantedModifiers (e.g. +1 weapon)
+        const magicBonus = arr(def.grantedModifiers)
+            .filter(gm => isBonusMod(gm) && gm.subType === "magic")
+            .reduce((s, gm) => s + num(gm.value ?? gm.fixedValue), 0);
+        // Monk weapons: simple melee or shortsword, no Two-Handed/Heavy
+        const isMonkWeapon = hasMartialArts &&
+            !props.includes("Two-Handed") && !props.includes("Heavy") &&
+            ((num(def.categoryId) === 1 && attackType === 1) || str(def.name) === "Shortsword");
+        // Ability modifier for attack/damage
+        const usesDex = isRanged || ((isFinesse || isMonkWeapon) && dexMod > statMods[0]);
+        const abilityMod = usesDex ? dexMod : statMods[0];
+        const profMod = isWeaponProficient(def) ? profBonus : 0;
+        const hitBonus = abilityMod + profMod + magicBonus;
+        const dmgBonus = abilityMod + magicBonus;
+        const dmgStr = dmgBonus !== 0 ? `${dmgDice}${signed(dmgBonus)}` : dmgDice;
+        const rangeStr = isRanged ? `range ${range}/${longRange} ft.` : `reach 5 ft.`;
+        const propsStr = [...props, ...(mastery ? [mastery] : [])].join(", ");
+        const line = `• ${wName.padEnd(16)} ${signed(hitBonus)} to hit   ${dmgStr} ${dmgType}   ${rangeStr}${propsStr ? `   ${propsStr}` : ""}`;
+        // Consolidate duplicates by key
+        const key = wName + dmgDice;
+        const existing = weaponInventoryMap.get(key);
+        if (existing) {
+            existing.qty += num(i.quantity) || 1;
+        }
+        else {
+            weaponInventoryMap.set(key, { lines: [line], qty: num(i.quantity) || 1 });
+        }
+    }
+    const weaponAttacks = [];
+    for (const { lines, qty } of weaponInventoryMap.values()) {
+        weaponAttacks.push(qty > 1 ? lines[0].replace("•", `• ×${qty}`) : lines[0]);
+    }
+    return weaponAttacks;
+}
+//# sourceMappingURL=weapons.js.map

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

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

package/dist/tools/character.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Public API surface for character tools. The 1000-line `parseCharacterData`
+ * and 220-line `getDefinition` that used to live here have been carved into
+ * per-domain modules under `./character/` — see docs/character-refactor.md.
+ *
+ * What stays here: network/IO (getCharacter, downloadCharacter,
+ * listCharacters, findCharacterByName), the in-process JSON cache, and
+ * thin re-exports of the moved entry points.
+ */
+import type { ParseSection } from "./character/types.js";
+export { parseCharacterData } from "./character/parse.js";
+export { getDefinition } from "./character/definition.js";
+/** Wipe the in-process character JSON cache. */
+export declare function clearCharacterCache(): void;
 /**
  * Resolve a character name to a numeric ID using the character list API.
  * Resolution order: exact match → substring match → Levenshtein ≤3 on full
@@ -8,8 +22,7 @@ export declare function findCharacterByName(name: string): Promise<{
     id: string;
     name: string;
 } | null>;
-export declare function parseCharacterData(raw: Record<string, unknown>, sections?: "summary" | "combat" | "spells" | "inventory" | "features" | "concentration" | "notes" | "full"): string;
-export declare function parseCharacter(characterId: string, sections?: "summary" | "combat" | "spells" | "inventory" | "features" | "concentration" | "notes" | "full"): Promise<string>;
+export declare function parseCharacter(characterId: string, sections?: ParseSection): Promise<string>;
 /**
  * Fetch raw character JSON from the DnD Beyond API.
  * Uses saved session cookies — no browser needed after initial login.
@@ -17,5 +30,4 @@ export declare function parseCharacter(characterId: string, sections?: "summary"
 export declare function getCharacter(characterId: string): Promise<string>;
 export declare function downloadCharacter(characterId: string, outputPath?: string): Promise<string>;
 export declare function listCharacters(): Promise<string>;
-export declare function getDefinition(characterId: string, query: string): Promise<string>;
 //# sourceMappingURL=character.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../src/tools/character.ts"],"names":[],"mappings":"AAkCA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA8BpG;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,GAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,OAAO,GAAG,MAAe,GACjH,MAAM,CA++BR;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,OAAO,GAAG,MAAe,GACjH,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAkCtD;AA2MD,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB"}
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../src/tools/character.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAQzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAW1D,gDAAgD;AAChD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAoCpG;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,YAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAkCtD"}