@iamjameslennon/ddb-mcp 2.3.0

package/dist/tools/navigate.js

@@ -0,0 +1,67 @@
+import { getPage } from "../browser.js";
+export async function navigate(context, url) {
+    const page = await getPage(context);
+    // Only allow D&D Beyond URLs — validate the actual hostname to prevent subdomain spoofing.
+    let validatedUrl;
+    try {
+        validatedUrl = new URL(url);
+    }
+    catch {
+        throw new Error("Invalid URL.");
+    }
+    const h = validatedUrl.hostname;
+    if (validatedUrl.protocol !== "https:" || !(h === "dndbeyond.com" || h.endsWith(".dndbeyond.com"))) {
+        throw new Error("Only D&D Beyond URLs (https://www.dndbeyond.com/...) are supported.");
+    }
+    await page.goto(url, { waitUntil: "networkidle", timeout: 30000 });
+    // Extract page text content and convert to readable markdown-ish format
+    const content = await page.evaluate(() => {
+        // Remove scripts and styles
+        document.querySelectorAll("script, style, nav, footer, .ad-container, .advertisement").forEach((el) => el.remove());
+        // Try to get the main content area
+        const main = document.querySelector("main, article, .main-content, .page-content, #content") ?? document.body;
+        return main.innerText;
+    });
+    const truncated = content.length > 8000 ? content.slice(0, 8000) + "\n\n[Content truncated — use ddb_read_book or a more specific URL to get full content]" : content;
+    return `URL: ${url}\n\n${truncated}`;
+}
+export async function interact(context, action, selector, value) {
+    const page = await getPage(context);
+    switch (action) {
+        case "click": {
+            // Filter to visible elements before .first() — prevents matching hidden
+            // nav dropdown links that appear earlier in the DOM than the intended target.
+            const locator = page.locator(selector).filter({ visible: true }).first();
+            await locator.waitFor({ state: "visible", timeout: 10000 });
+            await locator.click();
+            await page.waitForTimeout(1000);
+            return `Clicked element: ${selector}`;
+        }
+        case "fill": {
+            if (value === undefined)
+                throw new Error("'value' is required for fill action.");
+            await page.locator(selector).first().fill(value);
+            await page.waitForTimeout(500);
+            return `Filled '${selector}'.`;
+        }
+        case "screenshot": {
+            const screenshotPath = `${process.env.HOME}/Downloads/ddb-screenshot-${Date.now()}.png`;
+            await page.screenshot({ path: screenshotPath, fullPage: false });
+            return `Screenshot saved to: ${screenshotPath}`;
+        }
+        default:
+            throw new Error(`Unknown action: ${action}. Use 'click', 'fill', or 'screenshot'.`);
+    }
+}
+export async function getCurrentPageContent(context) {
+    const page = await getPage(context);
+    const url = page.url();
+    const content = await page.evaluate(() => {
+        document.querySelectorAll("script, style, nav, footer, .ad-container").forEach((el) => el.remove());
+        const main = document.querySelector("main, article, .main-content, .page-content") ?? document.body;
+        return main.innerText;
+    });
+    const truncated = content.length > 8000 ? content.slice(0, 8000) + "\n[truncated]" : content;
+    return `Current URL: ${url}\n\n${truncated}`;
+}
+//# sourceMappingURL=navigate.js.map

package/dist/tools/navigate.js.map

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

package/dist/tools/reference.d.ts

@@ -0,0 +1,58 @@
+/**
+ * reference.ts — Game reference tools: conditions, spells, items
+ *
+ * Conditions: hardcoded lookup table, no API required.
+ * Spells: built from character-service always-known/prepared endpoints
+ *         across all 8 spellcasting classes; cached 24 h.
+ * Items: single game-data/items endpoint; cached 24 h.
+ *
+ * All character-service endpoints use the cobalt Bearer token.
+ */
+export declare function getCondition(conditionName: string): string;
+/**
+ * Supplements the spell compendium with spells from a parsed character's
+ * classSpells array. Captures cantrips and chosen spells absent from the
+ * always-known endpoints. Called from parseCharacterData().
+ */
+export declare function addCharacterSpellsToCompendium(char: Record<string, unknown>): void;
+export declare function searchSpells(params: {
+    name?: string;
+    level?: number;
+    school?: string;
+    concentration?: boolean;
+    ritual?: boolean;
+    limit?: number;
+    offset?: number;
+}): Promise<string>;
+export declare function getSpell(spellName: string): Promise<string>;
+export declare function searchItems(params: {
+    name?: string;
+    rarity?: string;
+    type?: string;
+}): Promise<string>;
+export declare function getItem(itemName: string): Promise<string>;
+export declare function searchRaces(name?: string, limit?: number, offset?: number): Promise<string>;
+export declare function searchClasses(name?: string, limit?: number, offset?: number): Promise<string>;
+export declare function searchBackgrounds(name?: string, limit?: number, offset?: number): Promise<string>;
+export declare function searchFeats(params: {
+    name?: string;
+    prerequisite?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<string>;
+export declare function searchClassFeatures(params: {
+    name?: string;
+    className?: string;
+    level?: number;
+    limit?: number;
+    offset?: number;
+}): Promise<string>;
+export declare function searchRacialTraits(params: {
+    name?: string;
+    raceName?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<string>;
+export declare function searchRules(query?: string): Promise<string>;
+export declare function getRule(nameOrSlug: string, maxChars?: number, query?: string): Promise<string>;
+//# sourceMappingURL=reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/tools/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkKH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CA0B1D;AAsID;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA0BlF;AAmDD,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4DlB;AAED,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBjE;AA2FD,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B/D;AA4CD,wBAAsB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDjG;AAmBD,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDnG;AAYD,wBAAsB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CvG;AAcD,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB;AAgBD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDlB;AAeD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlB;AAMD,wBAAsB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjE;AAED,wBAAsB,OAAO,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAMjB"}