run-dmcp 0.1.0

package/dist/register/display.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDisplayTools(server: McpServer): void;

package/dist/register/display.js

@@ -0,0 +1,263 @@
+import { z } from "zod";
+import { getDisplayConfig, setDisplayConfig, resetDisplayConfig, applyThemePreset, listThemePresets, getGameDisplayConfig, setGameDisplayConfig, applyGameThemePreset, resetGameTheme, inferAndApplyTheme, } from "../tools/display.js";
+import { ANNOTATIONS } from "../utils/tool-annotations.js";
+// All available theme presets
+const themePresetNames = [
+    "high-fantasy",
+    "dark-fantasy",
+    "sci-fi",
+    "cyberpunk",
+    "western",
+    "noir",
+    "cosmic-horror",
+    "steampunk",
+    "post-apocalyptic",
+    "pirate",
+    "modern",
+    "superhero",
+];
+export function registerDisplayTools(server) {
+    // Get display configuration
+    server.registerTool("get_display_config", {
+        description: "Get the current display configuration for the web viewer (colors, fonts, visibility options)",
+        inputSchema: {},
+        annotations: ANNOTATIONS.READ_ONLY,
+    }, async () => {
+        const config = getDisplayConfig();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(config, null, 2),
+                },
+            ],
+        };
+    });
+    // Set display configuration (full or partial)
+    server.registerTool("set_display_config", {
+        description: "Set display configuration for the web viewer. Can set any subset of options.",
+        inputSchema: {
+            bgColor: z.string().optional().describe("Background color (e.g., '#1a1a2e')"),
+            bgSecondary: z.string().optional().describe("Secondary background color"),
+            bgElevated: z.string().optional().describe("Elevated surface background"),
+            textColor: z.string().optional().describe("Main text color"),
+            textMuted: z.string().optional().describe("Muted text color"),
+            accentColor: z.string().optional().describe("Accent color for links and highlights"),
+            accentHover: z.string().optional().describe("Accent color on hover"),
+            borderColor: z.string().optional().describe("Border color"),
+            successColor: z.string().optional().describe("Success/positive color"),
+            warningColor: z.string().optional().describe("Warning/caution color"),
+            dangerColor: z.string().optional().describe("Danger/error color"),
+            codeBackground: z.string().optional().describe("Code/monospace block background"),
+            codeText: z.string().optional().describe("Code/monospace text color"),
+            borderRadius: z
+                .enum(["sharp", "rounded", "soft"])
+                .optional()
+                .describe("Border radius style: sharp (0px), rounded (12px), soft (24px)"),
+            cardStyle: z
+                .enum(["clean", "grungy", "tech", "parchment", "metallic", "wooden"])
+                .optional()
+                .describe("Card visual style"),
+            fontDisplay: z.string().optional().describe("Display/heading font (Google Font name)"),
+            fontBody: z.string().optional().describe("Body text font (Google Font name)"),
+            fontMono: z.string().optional().describe("Monospace font (Google Font name)"),
+            showHealthBars: z.boolean().optional().describe("Show health bars on character cards"),
+            showConditionTags: z.boolean().optional().describe("Show condition tags"),
+            showImages: z.boolean().optional().describe("Show images in the viewer"),
+            appTitle: z.string().optional().describe("Custom title for the web viewer"),
+        },
+        annotations: ANNOTATIONS.SET,
+    }, async (args) => {
+        const config = setDisplayConfig(args);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Display configuration updated:\n${JSON.stringify(config, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // Reset display configuration
+    server.registerTool("reset_display_config", {
+        description: "Reset display configuration to defaults",
+        inputSchema: {},
+        annotations: ANNOTATIONS.SET,
+    }, async () => {
+        const config = resetDisplayConfig();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Display configuration reset to defaults:\n${JSON.stringify(config, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // Apply theme preset (global)
+    server.registerTool("apply_theme_preset", {
+        description: "Apply a predefined theme preset globally. Available presets include genre-specific themes with appropriate colors, fonts, and styles.",
+        inputSchema: {
+            preset: z
+                .enum(themePresetNames)
+                .describe("Theme preset name"),
+        },
+        annotations: ANNOTATIONS.SET,
+    }, async ({ preset }) => {
+        const config = applyThemePreset(preset);
+        if (!config) {
+            return {
+                content: [{ type: "text", text: `Unknown preset: ${preset}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Applied '${preset}' theme preset:\n${JSON.stringify(config, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // List theme presets
+    server.registerTool("list_theme_presets", {
+        description: "List all available theme presets with their colors and styles",
+        inputSchema: {},
+        annotations: ANNOTATIONS.READ_ONLY,
+    }, async () => {
+        const presets = listThemePresets();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Available theme presets:\n${JSON.stringify(presets, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // ============================================
+    // Per-Game Theme Tools
+    // ============================================
+    // Get game theme
+    server.registerTool("get_game_theme", {
+        description: "Get the display configuration for a specific game",
+        inputSchema: {
+            gameId: z.string().describe("The game ID"),
+        },
+        annotations: ANNOTATIONS.READ_ONLY,
+    }, async ({ gameId }) => {
+        const config = getGameDisplayConfig(gameId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(config, null, 2),
+                },
+            ],
+        };
+    });
+    // Set game theme
+    server.registerTool("set_game_theme", {
+        description: "Set display configuration for a specific game. Each game can have its own visual theme.",
+        inputSchema: {
+            gameId: z.string().describe("The game ID"),
+            bgColor: z.string().optional().describe("Background color"),
+            bgSecondary: z.string().optional().describe("Secondary background"),
+            bgElevated: z.string().optional().describe("Elevated surface background"),
+            textColor: z.string().optional().describe("Text color"),
+            textMuted: z.string().optional().describe("Muted text"),
+            accentColor: z.string().optional().describe("Accent color"),
+            accentHover: z.string().optional().describe("Accent hover color"),
+            borderColor: z.string().optional().describe("Border color"),
+            successColor: z.string().optional().describe("Success color"),
+            warningColor: z.string().optional().describe("Warning color"),
+            dangerColor: z.string().optional().describe("Danger color"),
+            codeBackground: z.string().optional().describe("Code block background"),
+            codeText: z.string().optional().describe("Code text color"),
+            borderRadius: z.enum(["sharp", "rounded", "soft"]).optional().describe("Border radius style"),
+            cardStyle: z.enum(["clean", "grungy", "tech", "parchment", "metallic", "wooden"]).optional().describe("Card style"),
+            fontDisplay: z.string().optional().describe("Display font"),
+            fontBody: z.string().optional().describe("Body font"),
+            fontMono: z.string().optional().describe("Mono font"),
+            showHealthBars: z.boolean().optional().describe("Show health bars"),
+            showConditionTags: z.boolean().optional().describe("Show condition tags"),
+            showImages: z.boolean().optional().describe("Show images"),
+            appTitle: z.string().optional().describe("App title"),
+        },
+        annotations: ANNOTATIONS.SET,
+    }, async ({ gameId, ...config }) => {
+        const updated = setGameDisplayConfig(gameId, config);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Game theme updated for ${gameId}:\n${JSON.stringify(updated, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // Apply preset to game
+    server.registerTool("apply_game_theme_preset", {
+        description: "Apply a predefined theme preset to a specific game. This allows different games to have completely different visual themes.",
+        inputSchema: {
+            gameId: z.string().describe("The game ID"),
+            preset: z.enum(themePresetNames).describe("Theme preset name"),
+        },
+        annotations: ANNOTATIONS.SET,
+    }, async ({ gameId, preset }) => {
+        const config = applyGameThemePreset(gameId, preset);
+        if (!config) {
+            return {
+                content: [{ type: "text", text: `Unknown preset: ${preset}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Applied '${preset}' theme to game ${gameId}:\n${JSON.stringify(config, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // Reset game theme
+    server.registerTool("reset_game_theme", {
+        description: "Remove a game's custom theme, reverting to the global theme",
+        inputSchema: {
+            gameId: z.string().describe("The game ID"),
+        },
+        annotations: ANNOTATIONS.SET,
+    }, async ({ gameId }) => {
+        resetGameTheme(gameId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Game theme reset. Game ${gameId} will now use the global theme.`,
+                },
+            ],
+        };
+    });
+    // Auto-apply theme based on genre
+    server.registerTool("auto_theme_game", {
+        description: "Automatically apply an appropriate theme to a game based on its genre and setting. Call this when creating a new game to set up the visual style.",
+        inputSchema: {
+            gameId: z.string().describe("The game ID"),
+            genre: z.string().describe("Game genre (e.g., 'fantasy', 'sci-fi', 'western', 'noir')"),
+            setting: z.string().optional().describe("Optional setting description for more accurate theme matching"),
+        },
+        annotations: ANNOTATIONS.SET,
+    }, async ({ gameId, genre, setting }) => {
+        const config = inferAndApplyTheme(gameId, genre, setting);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Auto-themed game ${gameId} based on genre "${genre}":\n${JSON.stringify(config, null, 2)}`,
+                },
+            ],
+        };
+    });
+}

package/dist/register/factions.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFactionTools(server: McpServer): void;

package/dist/register/factions.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import * as factionTools from "../tools/faction.js";
+import { LIMITS } from "../utils/validation.js";
+import { ANNOTATIONS } from "../utils/tool-annotations.js";
+export function registerFactionTools(server) {
+    server.registerTool("create_faction", {
+        description: "Create a new faction/organization",
+        inputSchema: {
+            gameId: z.string().max(100).describe("The game ID"),
+            name: z.string().min(1).max(LIMITS.NAME_MAX).describe("Faction name"),
+            description: z.string().max(LIMITS.DESCRIPTION_MAX).optional().describe("Faction description"),
+            leaderId: z.string().max(100).optional().describe("Character ID of the leader"),
+            headquartersId: z.string().max(100).optional().describe("Location ID of headquarters"),
+            resources: z.record(z.number()).optional().describe("Initial resources (e.g., {gold: 1000, soldiers: 50})"),
+            goals: z.array(z.string().max(LIMITS.DESCRIPTION_MAX)).max(LIMITS.ARRAY_MAX).optional().describe("Faction goals"),
+            traits: z.array(z.string().max(LIMITS.NAME_MAX)).max(LIMITS.ARRAY_MAX).optional().describe("Faction traits (e.g., ['secretive', 'militant'])"),
+            status: z.enum(["active", "disbanded", "hidden"]).optional().describe("Faction status"),
+        },
+        annotations: ANNOTATIONS.CREATE,
+    }, async (params) => {
+        const faction = factionTools.createFaction(params);
+        return {
+            content: [{ type: "text", text: JSON.stringify(faction, null, 2) }],
+        };
+    });
+    server.registerTool("get_faction", {
+        description: "Get a faction by ID",
+        inputSchema: {
+            factionId: z.string().max(100).describe("The faction ID"),
+        },
+        annotations: ANNOTATIONS.READ_ONLY,
+    }, async ({ factionId }) => {
+        const faction = factionTools.getFaction(factionId);
+        if (!faction) {
+            return {
+                content: [{ type: "text", text: "Faction not found" }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(faction, null, 2) }],
+        };
+    });
+    server.registerTool("update_faction", {
+        description: "Update a faction's details",
+        inputSchema: {
+            factionId: z.string().max(100).describe("The faction ID"),
+            name: z.string().max(LIMITS.NAME_MAX).optional().describe("New name"),
+            description: z.string().max(LIMITS.DESCRIPTION_MAX).optional().describe("New description"),
+            leaderId: z.string().max(100).nullable().optional().describe("New leader ID (null to remove)"),
+            headquartersId: z.string().max(100).nullable().optional().describe("New headquarters ID (null to remove)"),
+            traits: z.array(z.string().max(LIMITS.NAME_MAX)).max(LIMITS.ARRAY_MAX).optional().describe("Replace traits"),
+            status: z.enum(["active", "disbanded", "hidden"]).optional().describe("New status"),
+        },
+        annotations: ANNOTATIONS.UPDATE,
+    }, async ({ factionId, ...updates }) => {
+        const faction = factionTools.updateFaction(factionId, updates);
+        if (!faction) {
+            return {
+                content: [{ type: "text", text: "Faction not found" }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(faction, null, 2) }],
+        };
+    });
+    server.registerTool("delete_faction", {
+        description: "Delete a faction",
+        inputSchema: {
+            factionId: z.string().max(100).describe("The faction ID"),
+        },
+        annotations: ANNOTATIONS.DESTRUCTIVE,
+    }, async ({ factionId }) => {
+        const success = factionTools.deleteFaction(factionId);
+        return {
+            content: [{ type: "text", text: success ? "Faction deleted" : "Faction not found" }],
+            isError: !success,
+        };
+    });
+    server.registerTool("list_factions", {
+        description: "List factions in a game",
+        inputSchema: {
+            gameId: z.string().max(100).describe("The game ID"),
+            status: z.enum(["active", "disbanded", "hidden"]).optional().describe("Filter by status"),
+        },
+        annotations: ANNOTATIONS.READ_ONLY,
+    }, async ({ gameId, status }) => {
+        const factions = factionTools.listFactions(gameId, status ? { status } : undefined);
+        return {
+            content: [{ type: "text", text: JSON.stringify(factions, null, 2) }],
+        };
+    });
+    // ============================================================================
+    // CONSOLIDATED: UPDATE FACTION RESOURCE (replaces modify_faction_resource + set_faction_resource)
+    // ============================================================================
+    server.registerTool("update_faction_resource", {
+        description: "Update a faction resource value. Use mode 'delta' to add/subtract, or 'set' to set an absolute value.",
+        inputSchema: {
+            factionId: z.string().max(100).describe("The faction ID"),
+            resource: z.string().max(LIMITS.NAME_MAX).describe("Resource name (e.g., 'gold', 'soldiers')"),
+            mode: z.enum(["delta", "set"]).describe("'delta' to add/subtract from current value, 'set' to set absolute value"),
+            value: z.number().describe("Amount to add/subtract (for delta) or absolute value (for set). Values <= 0 remove the resource."),
+        },
+        annotations: ANNOTATIONS.UPDATE,
+    }, async (params) => {
+        const faction = factionTools.updateFactionResource(params);
+        if (!faction) {
+            return {
+                content: [{ type: "text", text: "Faction not found" }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(faction, null, 2) }],
+        };
+    });
+    // ============================================================================
+    // CONSOLIDATED: MODIFY FACTION GOALS (replaces add_faction_goal + complete_faction_goal)
+    // ============================================================================
+    server.registerTool("modify_faction_goals", {
+        description: "Add and/or complete faction goals in a single call. More efficient than separate add/complete calls.",
+        inputSchema: {
+            factionId: z.string().max(100).describe("The faction ID"),
+            add: z.array(z.string().max(LIMITS.DESCRIPTION_MAX)).max(LIMITS.ARRAY_MAX).optional().describe("Goals to add"),
+            complete: z.array(z.number()).max(LIMITS.ARRAY_MAX).optional().describe("Indices of goals to complete (0-based)"),
+        },
+        annotations: ANNOTATIONS.UPDATE,
+    }, async ({ factionId, add, complete }) => {
+        if (!add?.length && !complete?.length) {
+            return {
+                content: [{ type: "text", text: "No goals to add or complete" }],
+                isError: true,
+            };
+        }
+        const result = factionTools.modifyFactionGoals(factionId, { add, complete });
+        if (!result) {
+            return {
+                content: [{ type: "text", text: "Faction not found" }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        factionId: result.faction.id,
+                        goals: result.faction.goals,
+                        added: result.added,
+                        completed: result.completed,
+                    }, null, 2) }],
+        };
+    });
+    // ============================================================================
+    // CONSOLIDATED: MODIFY FACTION TRAITS (replaces add_faction_trait + remove_faction_trait)
+    // ============================================================================
+    server.registerTool("modify_faction_traits", {
+        description: "Add and/or remove faction traits in a single call. More efficient than separate add/remove calls.",
+        inputSchema: {
+            factionId: z.string().max(100).describe("The faction ID"),
+            add: z.array(z.string().max(LIMITS.NAME_MAX)).max(LIMITS.ARRAY_MAX).optional().describe("Traits to add"),
+            remove: z.array(z.string().max(LIMITS.NAME_MAX)).max(LIMITS.ARRAY_MAX).optional().describe("Traits to remove"),
+        },
+        annotations: ANNOTATIONS.UPDATE,
+    }, async ({ factionId, add, remove }) => {
+        if (!add?.length && !remove?.length) {
+            return {
+                content: [{ type: "text", text: "No traits to add or remove" }],
+                isError: true,
+            };
+        }
+        const result = factionTools.modifyFactionTraits(factionId, { add, remove });
+        if (!result) {
+            return {
+                content: [{ type: "text", text: "Faction not found" }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        factionId: result.faction.id,
+                        traits: result.faction.traits,
+                        added: result.added,
+                        removed: result.removed,
+                    }, null, 2) }],
+        };
+    });
+}

package/dist/register/images.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerImageTools(server: McpServer): void;