run-dmcp 0.1.0

package/dist/utils/verbosity.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+/**
+ * Verbosity levels for tool responses:
+ * - minimal: Just IDs and names - for quick lookups and references
+ * - standard: Common fields needed for most operations (default)
+ * - full: All fields including metadata - for detailed inspection
+ */
+export type VerbosityLevel = 'minimal' | 'standard' | 'full';
+export declare const verbositySchema: z.ZodDefault<z.ZodEnum<["minimal", "standard", "full"]>>;
+/**
+ * Field sets for each entity type by verbosity level
+ */
+export declare const VERBOSITY_FIELDS: {
+    readonly character: {
+        readonly minimal: readonly ["id", "name", "isPlayer"];
+        readonly standard: readonly ["id", "name", "isPlayer", "status", "locationId"];
+        readonly full: null;
+    };
+    readonly location: {
+        readonly minimal: readonly ["id", "name"];
+        readonly standard: readonly ["id", "name", "description", "properties"];
+        readonly full: null;
+    };
+    readonly quest: {
+        readonly minimal: readonly ["id", "name", "status"];
+        readonly standard: readonly ["id", "name", "description", "status", "objectives"];
+        readonly full: null;
+    };
+    readonly item: {
+        readonly minimal: readonly ["id", "name"];
+        readonly standard: readonly ["id", "name", "description", "quantity", "ownerId", "ownerType"];
+        readonly full: null;
+    };
+    readonly faction: {
+        readonly minimal: readonly ["id", "name"];
+        readonly standard: readonly ["id", "name", "description", "goals", "resources"];
+        readonly full: null;
+    };
+    readonly resource: {
+        readonly minimal: readonly ["id", "name", "currentValue"];
+        readonly standard: readonly ["id", "name", "description", "currentValue", "minValue", "maxValue"];
+        readonly full: null;
+    };
+    readonly note: {
+        readonly minimal: readonly ["id", "title", "isPinned"];
+        readonly standard: readonly ["id", "title", "content", "category", "isPinned", "createdAt"];
+        readonly full: null;
+    };
+};
+/**
+ * Filter an object to include only specified fields
+ */
+export declare function filterFields<T extends object>(obj: T, fields: readonly string[] | null): Partial<T>;
+/**
+ * Apply verbosity filtering to an array of entities
+ */
+export declare function applyVerbosity<T extends object>(entities: T[], entityType: keyof typeof VERBOSITY_FIELDS, verbosity: VerbosityLevel): Partial<T>[];

package/dist/utils/verbosity.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+export const verbositySchema = z
+    .enum(['minimal', 'standard', 'full'])
+    .default('standard')
+    .describe('Response verbosity: minimal (IDs/names only), standard (common fields), full (all fields)');
+/**
+ * Field sets for each entity type by verbosity level
+ */
+export const VERBOSITY_FIELDS = {
+    character: {
+        minimal: ['id', 'name', 'isPlayer'],
+        standard: ['id', 'name', 'isPlayer', 'status', 'locationId'],
+        full: null, // null means include all fields
+    },
+    location: {
+        minimal: ['id', 'name'],
+        standard: ['id', 'name', 'description', 'properties'],
+        full: null,
+    },
+    quest: {
+        minimal: ['id', 'name', 'status'],
+        standard: ['id', 'name', 'description', 'status', 'objectives'],
+        full: null,
+    },
+    item: {
+        minimal: ['id', 'name'],
+        standard: ['id', 'name', 'description', 'quantity', 'ownerId', 'ownerType'],
+        full: null,
+    },
+    faction: {
+        minimal: ['id', 'name'],
+        standard: ['id', 'name', 'description', 'goals', 'resources'],
+        full: null,
+    },
+    resource: {
+        minimal: ['id', 'name', 'currentValue'],
+        standard: ['id', 'name', 'description', 'currentValue', 'minValue', 'maxValue'],
+        full: null,
+    },
+    note: {
+        minimal: ['id', 'title', 'isPinned'],
+        standard: ['id', 'title', 'content', 'category', 'isPinned', 'createdAt'],
+        full: null,
+    },
+};
+/**
+ * Filter an object to include only specified fields
+ */
+export function filterFields(obj, fields) {
+    if (fields === null) {
+        return obj; // Return full object
+    }
+    const result = {};
+    for (const field of fields) {
+        if (field in obj) {
+            result[field] = obj[field];
+        }
+    }
+    return result;
+}
+/**
+ * Apply verbosity filtering to an array of entities
+ */
+export function applyVerbosity(entities, entityType, verbosity) {
+    const fields = VERBOSITY_FIELDS[entityType][verbosity];
+    return entities.map((entity) => filterFields(entity, fields));
+}

package/dist/utils/webui.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Set the actual HTTP port after server starts
+ */
+export declare function setHttpPort(port: number): void;
+/**
+ * Get the base URL for the HTTP web UI
+ */
+export declare function getWebUiBaseUrl(): string;
+/**
+ * Get the web UI URL for a game
+ */
+export declare function getGameUrl(gameId: string): string;
+/**
+ * Get the web UI URL for a character
+ */
+export declare function getCharacterUrl(characterId: string): string;
+/**
+ * Get the web UI URL for a location
+ */
+export declare function getLocationUrl(locationId: string): string;

package/dist/utils/webui.js

@@ -0,0 +1,35 @@
+/**
+ * Actual port the HTTP server is running on (set at runtime)
+ */
+let actualHttpPort = null;
+/**
+ * Set the actual HTTP port after server starts
+ */
+export function setHttpPort(port) {
+    actualHttpPort = port;
+}
+/**
+ * Get the base URL for the HTTP web UI
+ */
+export function getWebUiBaseUrl() {
+    const port = actualHttpPort ?? parseInt(process.env.DMCP_HTTP_PORT || "3456", 10);
+    return `http://localhost:${port}`;
+}
+/**
+ * Get the web UI URL for a game
+ */
+export function getGameUrl(gameId) {
+    return `${getWebUiBaseUrl()}/games/${gameId}`;
+}
+/**
+ * Get the web UI URL for a character
+ */
+export function getCharacterUrl(characterId) {
+    return `${getWebUiBaseUrl()}/characters/${characterId}`;
+}
+/**
+ * Get the web UI URL for a location
+ */
+export function getLocationUrl(locationId) {
+    return `${getWebUiBaseUrl()}/locations/${locationId}`;
+}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "run-dmcp",
+  "version": "0.1.0",
+  "description": "An MCP server for LLM-run interactive fiction where the server owns what is true - including when it was true. A continuation of DMCP.",
+  "license": "MIT",
+  "author": "Derek Ferguson",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JavaDerek/run-dmcp.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "run-dmcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && npm run build:client",
+    "build:server": "tsc",
+    "build:client": "cd client && npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "dev:client": "cd client && npm run dev",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:client": "cd client && npm run test",
+    "test:all": "npm run test:run && npm run test:client -- run",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0",
+    "express": "^5.0.1",
+    "sharp": "^0.34.5",
+    "uuid": "^10.0.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/sharp": "^0.31.1",
+    "@types/uuid": "^10.0.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.7.4",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.51.0",
+    "vitest": "^4.0.16"
+  },
+  "contributors": [
+    "Shawn Rushefsky (DMCP, the project this continues)"
+  ],
+  "keywords": [
+    "mcp",
+    "interactive-fiction",
+    "narrative",
+    "timeline",
+    "event-sourcing",
+    "llm",
+    "rpg"
+  ],
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ]
+}