foundryvtt-mcp 1.5.0 → 1.5.2

package/dist/tools/handlers/combat-order.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Shared combatant turn-order helper (#214).
+ *
+ * FoundryVTT resolves `Combat#turn` against the **initiative-sorted** turn
+ * order, not the stored (creation) order of `Combat#combatants`. Every handler
+ * that maps a `turn` index onto a combatant — the read path
+ * (`get_combat_state`) and the write path (`next_turn`) alike — must therefore
+ * derive that list here, so the two can never drift apart through slightly
+ * different comparators.
+ *
+ * The comparator mirrors core's `Combat._sortCombatants`: initiative
+ * descending, non-numeric (un-rolled) initiative last, ties broken by document
+ * id so the order is deterministic and stable.
+ */
+import type { WorldCombat } from '../../foundry/types.js';
+/** A single combatant embedded in a `WorldCombat` document. */
+export type WorldCombatant = WorldCombat['combatants'][number];
+/**
+ * Compares two combatants by Foundry's turn-order rules.
+ *
+ * Initiative descending; combatants without a rolled initiative go last; ties
+ * (including two un-rolled combatants, whose difference is `NaN`) fall back to
+ * the document id so the ordering is total and deterministic.
+ */
+export declare function compareCombatants(a: WorldCombatant, b: WorldCombatant): number;
+/**
+ * Returns the combatants of `combat` in turn order.
+ *
+ * Sorts a **copy** — `combat` is a live reference into the world-data cache, so
+ * sorting in place would silently reorder cached state as a side effect of a
+ * read.
+ */
+export declare function getTurnOrder(combat: WorldCombat): WorldCombatant[];
+/**
+ * Whether the encounter is under way, derived the way core derives it.
+ *
+ * `Combat#started` is a **client-side getter** (`turns.length > 0 && round >
+ * 0`), not schema data: `BaseCombat.defineSchema()` does not declare it, so a
+ * Combat document read out of `worldData` never carries the key. Reading
+ * `combat.started` therefore evaluates to `undefined` on every real world —
+ * only hand-written fixtures have it — so started-ness is computed here from
+ * the two fields the transport does deliver.
+ */
+export declare function isCombatStarted(combat: WorldCombat): boolean;
+/**
+ * Returns the combatant `combat.turn` currently points at, if any.
+ *
+ * Yields `undefined` when nobody is acting yet — the encounter has not been
+ * started (initiatives are commonly assigned during round 0 setup), `turn` is
+ * null, or the stored index no longer resolves to a combatant.
+ */
+export declare function getCurrentCombatant(combat: WorldCombat): WorldCombatant | undefined;
+/**
+ * Computes where `actingCombatantId` lands in the turn order once `change` is
+ * applied — i.e. the `turn` index that keeps the same combatant acting.
+ *
+ * The change is projected onto a copy rather than read back from the cache:
+ * `setCombatantInitiative` resolves on the `modifyDocument` ack, while the
+ * cache is updated by the separate broadcast, so the cached initiative may or
+ * may not have caught up by the time this runs. Projecting is correct either
+ * way (re-applying the same value is a no-op).
+ *
+ * @returns the new index, or `undefined` if the acting combatant is gone.
+ */
+export declare function turnIndexAfterInitiativeChange(combat: WorldCombat, change: {
+    combatantId: string;
+    initiative: number;
+}, actingCombatantId: string): number | undefined;
+//# sourceMappingURL=combat-order.d.ts.map

package/dist/tools/handlers/combat-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat-order.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/combat-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAS/D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAS9E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,EAAE,CAElE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAKnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACnD,iBAAiB,EAAE,MAAM,GACxB,MAAM,GAAG,SAAS,CASpB"}

package/dist/tools/handlers/combat-order.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview Shared combatant turn-order helper (#214).
+ *
+ * FoundryVTT resolves `Combat#turn` against the **initiative-sorted** turn
+ * order, not the stored (creation) order of `Combat#combatants`. Every handler
+ * that maps a `turn` index onto a combatant — the read path
+ * (`get_combat_state`) and the write path (`next_turn`) alike — must therefore
+ * derive that list here, so the two can never drift apart through slightly
+ * different comparators.
+ *
+ * The comparator mirrors core's `Combat._sortCombatants`: initiative
+ * descending, non-numeric (un-rolled) initiative last, ties broken by document
+ * id so the order is deterministic and stable.
+ */
+/** Un-rolled / malformed initiative sorts to the very end of the order. */
+function initiativeOf(c) {
+    return typeof c.initiative === 'number' && Number.isFinite(c.initiative)
+        ? c.initiative
+        : Number.NEGATIVE_INFINITY;
+}
+/**
+ * Compares two combatants by Foundry's turn-order rules.
+ *
+ * Initiative descending; combatants without a rolled initiative go last; ties
+ * (including two un-rolled combatants, whose difference is `NaN`) fall back to
+ * the document id so the ordering is total and deterministic.
+ */
+export function compareCombatants(a, b) {
+    const byInitiative = initiativeOf(b) - initiativeOf(a);
+    if (byInitiative && !Number.isNaN(byInitiative)) {
+        return byInitiative;
+    }
+    if (a._id === b._id) {
+        return 0;
+    }
+    return a._id > b._id ? 1 : -1;
+}
+/**
+ * Returns the combatants of `combat` in turn order.
+ *
+ * Sorts a **copy** — `combat` is a live reference into the world-data cache, so
+ * sorting in place would silently reorder cached state as a side effect of a
+ * read.
+ */
+export function getTurnOrder(combat) {
+    return [...combat.combatants].sort(compareCombatants);
+}
+/**
+ * Whether the encounter is under way, derived the way core derives it.
+ *
+ * `Combat#started` is a **client-side getter** (`turns.length > 0 && round >
+ * 0`), not schema data: `BaseCombat.defineSchema()` does not declare it, so a
+ * Combat document read out of `worldData` never carries the key. Reading
+ * `combat.started` therefore evaluates to `undefined` on every real world —
+ * only hand-written fixtures have it — so started-ness is computed here from
+ * the two fields the transport does deliver.
+ */
+export function isCombatStarted(combat) {
+    return combat.round > 0 && combat.combatants.length > 0;
+}
+/**
+ * Returns the combatant `combat.turn` currently points at, if any.
+ *
+ * Yields `undefined` when nobody is acting yet — the encounter has not been
+ * started (initiatives are commonly assigned during round 0 setup), `turn` is
+ * null, or the stored index no longer resolves to a combatant.
+ */
+export function getCurrentCombatant(combat) {
+    if (!isCombatStarted(combat) || combat.turn === null || combat.turn === undefined) {
+        return undefined;
+    }
+    return getTurnOrder(combat)[combat.turn];
+}
+/**
+ * Computes where `actingCombatantId` lands in the turn order once `change` is
+ * applied — i.e. the `turn` index that keeps the same combatant acting.
+ *
+ * The change is projected onto a copy rather than read back from the cache:
+ * `setCombatantInitiative` resolves on the `modifyDocument` ack, while the
+ * cache is updated by the separate broadcast, so the cached initiative may or
+ * may not have caught up by the time this runs. Projecting is correct either
+ * way (re-applying the same value is a no-op).
+ *
+ * @returns the new index, or `undefined` if the acting combatant is gone.
+ */
+export function turnIndexAfterInitiativeChange(combat, change, actingCombatantId) {
+    const projected = {
+        ...combat,
+        combatants: combat.combatants.map((c) => c._id === change.combatantId ? { ...c, initiative: change.initiative } : c),
+    };
+    const index = getTurnOrder(projected).findIndex((c) => c._id === actingCombatantId);
+    return index === -1 ? undefined : index;
+}
+//# sourceMappingURL=combat-order.js.map

package/dist/tools/handlers/combat-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat-order.js","sourceRoot":"","sources":["../../../src/tools/handlers/combat-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,2EAA2E;AAC3E,SAAS,YAAY,CAAC,CAAiB;IACrC,OAAO,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QACtE,CAAC,CAAC,CAAC,CAAC,UAAU;QACd,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAiB,EAAE,CAAiB;IACpE,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAAmB,EACnB,MAAmD,EACnD,iBAAyB;IAEzB,MAAM,SAAS,GAAgB;QAC7B,GAAG,MAAM;QACT,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAC3E;KACF,CAAC;IACF,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC;IACpF,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1C,CAAC"}

package/dist/tools/handlers/combat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combat.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/combat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,aAAa;;;;;GAgD7B"}
+{"version":3,"file":"combat.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/combat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,aAAa;;;;;GAkD7B"}

package/dist/tools/handlers/combat.js

@@ -1,6 +1,7 @@
 /**
  * Combat state tool handler
  */
+import { getTurnOrder } from './combat-order.js';
 import { withToolError } from './utils.js';
 export async function handleGetCombatState(_args, foundryClient) {
     return withToolError('get combat state', async () => {
@@ -10,8 +11,10 @@ export async function handleGetCombatState(_args, foundryClient) {
                 content: [{ type: 'text', text: 'No active combat encounter.' }],
             };
         }
-        const combatants = combat.combatants
-            .sort((a, b) => (b.initiative ?? -999) - (a.initiative ?? -999))
+        // `combat` is a live reference into the world-data cache: sort a COPY via
+        // the shared helper so a read never reorders cached state (#214). The same
+        // helper backs `next_turn`, so both tools agree on what `combat.turn` means.
+        const combatants = getTurnOrder(combat)
             .map((c, i) => {
             const current = combat.turn === i ? ' <-- CURRENT' : '';
             const status = c.defeated ? ' [DEFEATED]' : c.hidden ? ' [HIDDEN]' : '';

package/dist/tools/handlers/combat.js.map

@@ -1 +1 @@
-{"version":3,"file":"combat.js","sourceRoot":"","sources":["../../../src/tools/handlers/combat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA8B,EAC9B,aAA4B;IAE5B,OAAO,aAAa,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,EAAE,CAAC;aACjE,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU;aACjC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,CAAC;aAC/D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACZ,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAEnE,qDAAqD;YACrD,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,UAAiD,CAAC;oBAC3E,MAAM,MAAM,GAAG,EAAE,EAAE,EAAkD,CAAC;oBACtE,MAAM,MAAM,GAAG,EAAE,EAAE,EAAoC,CAAC;oBACxD,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,IAAI,QAAQ,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;oBAC7D,CAAC;oBACD,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,IAAI,QAAQ,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC;oBACxC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,IAAI,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;QACvE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B,MAAM,CAAC,KAAK,OAAO,UAAU,EAAE;iBACnE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"combat.js","sourceRoot":"","sources":["../../../src/tools/handlers/combat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA8B,EAC9B,aAA4B;IAE5B,OAAO,aAAa,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,EAAE,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,EAAE,CAAC;aACjE,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,2EAA2E;QAC3E,6EAA6E;QAC7E,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACZ,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAEnE,qDAAqD;YACrD,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,UAAiD,CAAC;oBAC3E,MAAM,MAAM,GAAG,EAAE,EAAE,EAAkD,CAAC;oBACtE,MAAM,MAAM,GAAG,EAAE,EAAE,EAAoC,CAAC;oBACxD,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,IAAI,QAAQ,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;oBAC7D,CAAC;oBACD,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,IAAI,QAAQ,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC;oBACxC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,IAAI,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;QACvE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B,MAAM,CAAC,KAAK,OAAO,UAAU,EAAE;iBACnE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/handlers/diagnostics.d.ts

@@ -26,6 +26,13 @@ export declare function handleGetRecentLogs(args: {
 }>;
 /**
  * Handles log search requests
+ *
+ * `searchLogs()` resolves to a `LogSearchResponse` object; matched entries live
+ * under `response.logs` and the upstream match count under `response.matches`.
+ *
+ * - `level`: forwarded to the search request when it names a real log level
+ * - `limit`: applied to the rendered entries (default 50, hard cap 1000); it
+ *   does not shrink the reported `matches` total
  */
 export declare function handleSearchLogs(args: {
     query: string;
@@ -39,6 +46,12 @@ export declare function handleSearchLogs(args: {
 }>;
 /**
  * Handles system health requests
+ *
+ * Every value rendered here is a field `SystemHealthSchema` actually declares.
+ * The schema strips unknown keys, so metrics it does not model (CPU, disk,
+ * response time, throughput) cannot be reported and are deliberately absent
+ * rather than rendered as a permanent `N/A`. Optional fields (`server.uptime`,
+ * `performance.memory`) are omitted when the server does not supply them.
  */
 export declare function handleGetSystemHealth(_args: Record<string, unknown>, diagnosticsClient: DiagnosticsClient): Promise<{
     content: {
@@ -59,6 +72,18 @@ export declare function handleDiagnoseErrors(args: {
 }>;
 /**
  * Handles comprehensive health status requests
+ *
+ * The system-health section reads the nested fields `SystemHealthSchema`
+ * declares. Playtime is not reported: `getWorldInfo()` has no genuine source
+ * for it and hard-codes 0.
+ *
+ * The world section carries {@link STALE_WORLD_DATA_NOTICE} whenever the cache
+ * has stopped following live document changes (#217). Reads keep being served
+ * from that snapshot, which is the right call — a flagged answer beats no
+ * answer — but rendering it bare presents a point-in-time copy as though it
+ * were live. It matters most right after an automatic reconnect, where the
+ * connection line legitimately reads "✅ Connected" while the cache is still
+ * missing every broadcast the outage swallowed.
  */
 export declare function handleGetHealthStatus(_args: Record<string, unknown>, foundryClient: FoundryClient, diagnosticsClient: DiagnosticsClient): Promise<{
     content: {

package/dist/tools/handlers/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AASnE;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,iBAAiB,EAAE,iBAAiB;;;;;GAqErC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,iBAAiB,EAAE,iBAAiB;;;;;GAoCrC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,iBAAiB,EAAE,iBAAiB;;;;;GA0BrC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,iBAAiB,EAAE,gBAAgB;;;;;GA+CpC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,iBAAiB;;;;;GA0CrC"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAqBnE;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,iBAAiB,EAAE,iBAAiB;;;;;GAqErC;AAkBD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,iBAAiB,EAAE,iBAAiB;;;;;GA8CrC;AA0BD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,iBAAiB,EAAE,iBAAiB;;;;;GAkDrC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,iBAAiB,EAAE,gBAAgB;;;;;GA+CpC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,iBAAiB;;;;;GAyDrC"}

package/dist/tools/handlers/diagnostics.js

@@ -4,11 +4,21 @@
  * Handles system diagnostics, logging, and health monitoring.
  */
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { LogEntrySchema } from '../../diagnostics/types.js';
 import { withToolError } from './utils.js';
 /** Valid log levels recognized by the tool schema */
 const VALID_LOG_LEVELS = new Set(['debug', 'info', 'warn', 'error', 'log', 'notification']);
 /** Hard upper bound on entries returned, regardless of caller-supplied limit */
 const MAX_LOG_LIMIT = 1000;
+/** Default number of search hits rendered when the caller supplies no limit */
+const DEFAULT_SEARCH_LIMIT = 50;
+/**
+ * Shown whenever `FoundryClient.isWorldDataStale()` is set (#217): the cached
+ * world snapshot is still being served, but it stopped following live document
+ * changes when the socket dropped and nothing replays the gap.
+ */
+const STALE_WORLD_DATA_NOTICE = '⚠️ **Stale:** this snapshot stopped following live changes when the connection dropped, ' +
+    'and document changes made since are missing. Run `refresh_world_data` to resync.';
 /**
  * Handles recent log retrieval requests
  *
@@ -76,33 +86,65 @@ ${logEntries || 'No log entries found.'}`,
         };
     });
 }
+/**
+ * Resolves a caller-supplied level string to a level the search endpoint accepts.
+ *
+ * The tool schema advertises `debug`, which has no counterpart in the log
+ * entry level enum; such values are dropped rather than sent upstream.
+ *
+ * @returns the normalized level, or `undefined` when unsupported/absent
+ */
+function resolveSearchLevel(level) {
+    if (typeof level !== 'string' || level === '') {
+        return undefined;
+    }
+    const parsed = LogEntrySchema.shape.level.safeParse(level.toLowerCase());
+    return parsed.success ? parsed.data : undefined;
+}
 /**
  * Handles log search requests
+ *
+ * `searchLogs()` resolves to a `LogSearchResponse` object; matched entries live
+ * under `response.logs` and the upstream match count under `response.matches`.
+ *
+ * - `level`: forwarded to the search request when it names a real log level
+ * - `limit`: applied to the rendered entries (default 50, hard cap 1000); it
+ *   does not shrink the reported `matches` total
  */
 export async function handleSearchLogs(args, diagnosticsClient) {
-    const { query, level } = args;
+    const { query, level, limit } = args;
     if (!query || typeof query !== 'string') {
         throw new McpError(ErrorCode.InvalidParams, 'Query is required and must be a string');
     }
+    const searchLevel = resolveSearchLevel(level);
+    const effectiveLimit = Math.min(Math.max(1, limit ?? DEFAULT_SEARCH_LIMIT), MAX_LOG_LIMIT);
+    let levelLabel = 'All levels';
+    if (searchLevel !== undefined) {
+        levelLabel = searchLevel;
+    }
+    else if (level) {
+        levelLabel = `${level} (unsupported — not applied)`;
+    }
     return withToolError('search logs', async () => {
-        const logs = await diagnosticsClient.searchLogs({ pattern: query });
-        const logEntries = Array.isArray(logs)
-            ? logs
-                .map((log) => {
-                const logEntry = log;
-                return `[${logEntry.timestamp || new Date().toISOString()}] **${(logEntry.level || 'INFO').toUpperCase()}** ${logEntry.message || String(log)}`;
-            })
-                .join('\n')
-            : 'No logs available';
-        const logCount = Array.isArray(logs) ? logs.length : 0;
+        const response = await diagnosticsClient.searchLogs({
+            pattern: query,
+            ...(searchLevel !== undefined ? { level: searchLevel } : {}),
+        });
+        const shown = response.logs.slice(0, effectiveLimit);
+        const logEntries = shown
+            .map((entry) => `[${entry.timestamp}] **${entry.level.toUpperCase()}** ${entry.message}`)
+            .join('\n');
         return {
             content: [
                 {
                     type: 'text',
                     text: `🔍 **Log Search Results**
 **Query:** "${query}"
-**Level Filter:** ${level || 'All levels'}
-**Results:** ${logCount}
+**Level Filter:** ${levelLabel}
+**Limit:** ${effectiveLimit}
+**Timeframe:** ${response.searchTimeframe}
+**Matches:** ${response.matches}
+**Showing:** ${shown.length}
 
 ${logEntries || 'No matching log entries found.'}`,
                 },
@@ -110,29 +152,76 @@ ${logEntries || 'No matching log entries found.'}`,
         };
     });
 }
+/**
+ * Formats an uptime in seconds as a compact human-readable duration
+ */
+function formatUptime(seconds) {
+    const total = Math.max(0, Math.floor(seconds));
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${total % 60}s`;
+    }
+    return `${total}s`;
+}
+/**
+ * Formats a byte count (as reported by `process.memoryUsage()`) in binary
+ * megabytes (MiB, the unit Node.js tooling conventionally labels "MB")
+ */
+function formatMegabytes(bytes) {
+    return `${Math.round(bytes / (1024 * 1024))} MB`;
+}
 /**
  * Handles system health requests
+ *
+ * Every value rendered here is a field `SystemHealthSchema` actually declares.
+ * The schema strips unknown keys, so metrics it does not model (CPU, disk,
+ * response time, throughput) cannot be reported and are deliberately absent
+ * rather than rendered as a permanent `N/A`. Optional fields (`server.uptime`,
+ * `performance.memory`) are omitted when the server does not supply them.
  */
 export async function handleGetSystemHealth(_args, diagnosticsClient) {
     return withToolError('get system health', async () => {
         const health = await diagnosticsClient.getSystemHealth();
+        const { server, users, modules, performance, logs } = health;
+        const serverLines = [
+            `- **FoundryVTT Version:** ${server.foundryVersion}`,
+            `- **Game System:** ${server.systemVersion}`,
+            `- **World:** ${server.worldId}`,
+        ];
+        if (server.uptime !== undefined) {
+            serverLines.push(`- **Uptime:** ${formatUptime(server.uptime)}`);
+        }
+        const performanceLines = [`- **Connected Clients:** ${performance.connectedClients}`];
+        if (performance.memory) {
+            performanceLines.push(`- **Memory (heap):** ${formatMegabytes(performance.memory.heapUsed)} used / ${formatMegabytes(performance.memory.heapTotal)} total`, `- **Memory (RSS):** ${formatMegabytes(performance.memory.rss)}`);
+        }
         return {
             content: [
                 {
                     type: 'text',
                     text: `🏥 **System Health Status**
-**Overall Status:** ${health.status || 'Unknown'}
-**CPU Usage:** ${health.cpu || 'N/A'}%
-**Memory Usage:** ${health.memory || 'N/A'}%
-**Disk Usage:** ${health.disk || 'N/A'}%
-**Uptime:** ${health.uptime || 'N/A'} seconds
+**Overall Status:** ${health.status}
+**Reported At:** ${health.timestamp}
 
-**Active Connections:** ${health.connections || 'N/A'}
-**Last Error:** ${health.lastError || 'None'}
+**Server:**
+${serverLines.join('\n')}
 
-**Performance Metrics:**
-- **Response Time:** ${health.responseTime || 'N/A'}ms
-- **Throughput:** ${health.throughput || 'N/A'} requests/sec`,
+**Sessions:**
+- **Users:** ${users.active} active / ${users.total} total (${users.gm} GM)
+- **Modules:** ${modules.active} active / ${modules.total} installed
+
+**Performance:**
+${performanceLines.join('\n')}
+
+**Logs:**
+- **Buffer:** ${logs.bufferSize} entries
+- **Recent Errors:** ${logs.recentErrors}
+- **Recent Warnings:** ${logs.recentWarnings}
+- **Error Rate:** ${logs.errorRate}%`,
                 },
             ],
         };
@@ -182,6 +271,18 @@ ${diagnosis.recommendations.map((rec) => `- ${rec}`).join('\n')}
 }
 /**
  * Handles comprehensive health status requests
+ *
+ * The system-health section reads the nested fields `SystemHealthSchema`
+ * declares. Playtime is not reported: `getWorldInfo()` has no genuine source
+ * for it and hard-codes 0.
+ *
+ * The world section carries {@link STALE_WORLD_DATA_NOTICE} whenever the cache
+ * has stopped following live document changes (#217). Reads keep being served
+ * from that snapshot, which is the right call — a flagged answer beats no
+ * answer — but rendering it bare presents a point-in-time copy as though it
+ * were live. It matters most right after an automatic reconnect, where the
+ * connection line legitimately reads "✅ Connected" while the cache is still
+ * missing every broadcast the outage swallowed.
  */
 export async function handleGetHealthStatus(_args, foundryClient, diagnosticsClient) {
     return withToolError('get health status', async () => {
@@ -189,32 +290,45 @@ export async function handleGetHealthStatus(_args, foundryClient, diagnosticsCli
             foundryClient.getWorldInfo().catch(() => null),
             diagnosticsClient.getSystemHealth().catch(() => null),
         ]);
+        const worldLines = worldInfo
+            ? [
+                `- **Title:** ${worldInfo.title}`,
+                `- **System:** ${worldInfo.system}`,
+                `- **Core Version:** ${worldInfo.coreVersion}`,
+            ]
+            : ['ℹ️ Not available'];
+        if (foundryClient.isWorldDataStale()) {
+            worldLines.unshift(STALE_WORLD_DATA_NOTICE);
+        }
+        let healthSection = 'ℹ️ Not available';
+        if (systemHealth) {
+            const healthLines = [
+                `- **Status:** ${systemHealth.status}`,
+                `- **Users:** ${systemHealth.users.active} active / ${systemHealth.users.total} total`,
+            ];
+            if (systemHealth.server.uptime !== undefined) {
+                healthLines.push(`- **Uptime:** ${formatUptime(systemHealth.server.uptime)}`);
+            }
+            if (systemHealth.performance.memory) {
+                healthLines.push(`- **Memory (heap used):** ${formatMegabytes(systemHealth.performance.memory.heapUsed)}`);
+            }
+            healthLines.push(`- **Recent Errors:** ${systemHealth.logs.recentErrors} (warnings: ${systemHealth.logs.recentWarnings})`);
+            healthSection = `\n${healthLines.join('\n')}`;
+        }
         return {
             content: [
                 {
                     type: 'text',
-                    text: `🩺 **Comprehensive Health Status**
+                    text: `\u{1FA7A} **Comprehensive Health Status**
 
 **FoundryVTT Connection:**
 ${foundryClient.isConnected() ? '✅ Connected' : '❌ Disconnected'}
 
 **World Information:**
-${worldInfo
-                        ? `
-- **Title:** ${worldInfo.title}
-- **System:** ${worldInfo.system}
-- **Core Version:** ${worldInfo.coreVersion}
-- **Playtime:** ${Math.floor(worldInfo.playtime / 3600)} hours`
-                        : 'ℹ️ Not available'}
+${worldLines.join('\n')}
 
 **System Health:**
-${systemHealth
-                        ? `
-- **Status:** ${systemHealth.status || 'Unknown'}
-- **CPU:** ${systemHealth.cpu || 'N/A'}%
-- **Memory:** ${systemHealth.memory || 'N/A'}%
-- **Uptime:** ${Math.floor((systemHealth.uptime || 0) / 3600)} hours`
-                        : 'ℹ️ Not available'}`,
+${healthSection}`,
                 },
             ],
         };

package/dist/tools/handlers/diagnostics.js.map

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

package/dist/tools/handlers/dice.d.ts

@@ -11,7 +11,7 @@ import { BaseTool, type ToolContext, type ToolResult } from '../base.js';
  */
 export declare class RollDiceTool extends BaseTool {
     readonly name = "roll_dice";
-    readonly description = "Roll dice using standard RPG notation (e.g., 1d20, 3d6+4)";
+    readonly description = "Roll dice and return the total with a per-term breakdown. Dice terms and whole numbers joined by + or -, with whitespace allowed anywhere (\"1d20+5\", \"1d20 + 5\", \"1d20+5+3\", \"2d6 + 1d4\", \"3d6\"; a count-less \"d20\" means one die), always work and every term counts towards the total - that is the portable grammar, safe on either transport. Multiplication and Foundry modifier syntax such as \"4d6kh3\" or \"1d20r1\" are rejected on both transports, with an error naming the offending character and its position, never dropped from the total in silence. Parentheses are the one difference: with FOUNDRY_API_KEY set the formula goes to FoundryVTT's own Roll engine, which evaluates them, while the default Socket.IO transport rolls locally and rejects them by name - and a REST roll that cannot reach the server falls back to that same local roller, so a parenthesised formula can still fail there. Prefer the expanded form when it matters. Use when: the user asks for a check, save, attack, damage, or any random result.";
     readonly inputSchema: {
         type: string;
         properties: {

package/dist/tools/handlers/dice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dice.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/dice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,+DAA+D;IACnF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;MAalB;cAEc,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;CAavB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,UAAU,CAAC,CAMrB"}
+{"version":3,"file":"dice.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/dice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGzE;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,2gCAAyB;IAC7C,QAAQ,CAAC,WAAW;;;;;;;;;;;;;MAalB;cAEc,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;CAavB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/tools/handlers/dice.js

@@ -7,12 +7,13 @@
 import { logger } from '../../utils/logger.js';
 // import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 import { BaseTool } from '../base.js';
+import { ROLL_DICE_DESCRIPTION } from '../definitions.js';
 /**
  * Dice rolling tool implementation
  */
 export class RollDiceTool extends BaseTool {
     name = 'roll_dice';
-    description = 'Roll dice using standard RPG notation (e.g., 1d20, 3d6+4)';
+    description = ROLL_DICE_DESCRIPTION;
     inputSchema = {
         type: 'object',
         properties: {

package/dist/tools/handlers/dice.js.map

@@ -1 +1 @@
-{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../src/tools/handlers/dice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,4EAA4E;AAC5E,OAAO,EAAE,QAAQ,EAAqC,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,2DAA2D,CAAC;IAC1E,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB,CAAC;IAEQ,KAAK,CAAC,gBAAgB,CAC9B,IAA6B,EAC7B,OAAoB;QAEpB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAA4C,CAAC;QAEzE,MAAM,CAAC,IAAI,CAAC,iBAAiB,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAErE,OAAO,IAAI,CAAC,kBAAkB,CAAC;eACpB,MAAM,CAAC,OAAO;aAChB,MAAM,CAAC,KAAK;iBACR,MAAM,CAAC,SAAS;EAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;iBACpC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACnC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAGC,EACD,aAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,YAAY,EAAE,CAAC;IAChC,MAAM,OAAO,GAAgB;QAC3B,aAAa;KACd,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../src/tools/handlers/dice.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,4EAA4E;AAC5E,OAAO,EAAE,QAAQ,EAAqC,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IAC/B,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,qBAAqB,CAAC;IACpC,WAAW,GAAG;QACrB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB,CAAC;IAEQ,KAAK,CAAC,gBAAgB,CAC9B,IAA6B,EAC7B,OAAoB;QAEpB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAA4C,CAAC;QAEzE,MAAM,CAAC,IAAI,CAAC,iBAAiB,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAErE,OAAO,IAAI,CAAC,kBAAkB,CAAC;eACpB,MAAM,CAAC,OAAO;aAChB,MAAM,CAAC,KAAK;iBACR,MAAM,CAAC,SAAS;EAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;iBACpC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACnC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAGC,EACD,aAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,YAAY,EAAE,CAAC;IAChC,MAAM,OAAO,GAAgB;QAC3B,aAAa;KACd,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/tools/handlers/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,iBAAiB;;;;;;GAmCrC"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK7D,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,iBAAiB;;;;;;GAmCrC"}