run-dmcp 0.1.0 → 0.3.0

package/dist/utils/output-schemas.d.ts

@@ -76,17 +76,17 @@ export declare const gameMenuOutputSchema: {
         setting: string;
         id: string;
         name: string;
+        createdAt: string;
         style: string;
         updatedAt: string;
-        createdAt: string;
         webUiUrl?: string | undefined;
     }, {
         setting: string;
         id: string;
         name: string;
+        createdAt: string;
         style: string;
         updatedAt: string;
-        createdAt: string;
         webUiUrl?: string | undefined;
     }>, "many">;
     instruction: z.ZodString;
@@ -148,6 +148,597 @@ export declare const characterOutputSchema: {
     }>;
     locationId: z.ZodNullable<z.ZodString>;
     notes: z.ZodString;
+    voice: z.ZodNullable<z.ZodObject<{
+        pitch: z.ZodEnum<["very_low", "low", "medium", "high", "very_high"]>;
+        speed: z.ZodEnum<["very_slow", "slow", "medium", "fast", "very_fast"]>;
+        tone: z.ZodString;
+        accent: z.ZodOptional<z.ZodString>;
+        quirks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tone: string;
+        pitch: "very_low" | "low" | "medium" | "high" | "very_high";
+        speed: "medium" | "very_slow" | "slow" | "fast" | "very_fast";
+        description?: string | undefined;
+        accent?: string | undefined;
+        quirks?: string[] | undefined;
+    }, {
+        tone: string;
+        pitch: "very_low" | "low" | "medium" | "high" | "very_high";
+        speed: "medium" | "very_slow" | "slow" | "fast" | "very_fast";
+        description?: string | undefined;
+        accent?: string | undefined;
+        quirks?: string[] | undefined;
+    }>>;
+    imageGen: z.ZodNullable<z.ZodObject<{
+        subject: z.ZodObject<{
+            type: z.ZodEnum<["character", "location", "item", "scene"]>;
+            primaryDescription: z.ZodString;
+            physicalTraits: z.ZodOptional<z.ZodObject<{
+                age: z.ZodOptional<z.ZodString>;
+                gender: z.ZodOptional<z.ZodString>;
+                bodyType: z.ZodOptional<z.ZodString>;
+                height: z.ZodOptional<z.ZodString>;
+                skinTone: z.ZodOptional<z.ZodString>;
+                hairColor: z.ZodOptional<z.ZodString>;
+                hairStyle: z.ZodOptional<z.ZodString>;
+                eyeColor: z.ZodOptional<z.ZodString>;
+                facialFeatures: z.ZodOptional<z.ZodString>;
+                distinguishingMarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                height?: string | undefined;
+                age?: string | undefined;
+                gender?: string | undefined;
+                bodyType?: string | undefined;
+                skinTone?: string | undefined;
+                hairColor?: string | undefined;
+                hairStyle?: string | undefined;
+                eyeColor?: string | undefined;
+                facialFeatures?: string | undefined;
+                distinguishingMarks?: string[] | undefined;
+            }, {
+                height?: string | undefined;
+                age?: string | undefined;
+                gender?: string | undefined;
+                bodyType?: string | undefined;
+                skinTone?: string | undefined;
+                hairColor?: string | undefined;
+                hairStyle?: string | undefined;
+                eyeColor?: string | undefined;
+                facialFeatures?: string | undefined;
+                distinguishingMarks?: string[] | undefined;
+            }>>;
+            attire: z.ZodOptional<z.ZodObject<{
+                description: z.ZodString;
+                colors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                materials: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                accessories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                colors?: string[] | undefined;
+                materials?: string[] | undefined;
+                accessories?: string[] | undefined;
+            }, {
+                description: string;
+                colors?: string[] | undefined;
+                materials?: string[] | undefined;
+                accessories?: string[] | undefined;
+            }>>;
+            environment: z.ZodOptional<z.ZodObject<{
+                setting: z.ZodString;
+                timeOfDay: z.ZodOptional<z.ZodString>;
+                weather: z.ZodOptional<z.ZodString>;
+                lighting: z.ZodOptional<z.ZodString>;
+                architecture: z.ZodOptional<z.ZodString>;
+                vegetation: z.ZodOptional<z.ZodString>;
+                notableFeatures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                setting: string;
+                timeOfDay?: string | undefined;
+                weather?: string | undefined;
+                lighting?: string | undefined;
+                architecture?: string | undefined;
+                vegetation?: string | undefined;
+                notableFeatures?: string[] | undefined;
+            }, {
+                setting: string;
+                timeOfDay?: string | undefined;
+                weather?: string | undefined;
+                lighting?: string | undefined;
+                architecture?: string | undefined;
+                vegetation?: string | undefined;
+                notableFeatures?: string[] | undefined;
+            }>>;
+            objectDetails: z.ZodOptional<z.ZodObject<{
+                material: z.ZodOptional<z.ZodString>;
+                size: z.ZodOptional<z.ZodString>;
+                condition: z.ZodOptional<z.ZodString>;
+                glowOrEffects: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                size?: string | undefined;
+                material?: string | undefined;
+                condition?: string | undefined;
+                glowOrEffects?: string | undefined;
+            }, {
+                size?: string | undefined;
+                material?: string | undefined;
+                condition?: string | undefined;
+                glowOrEffects?: string | undefined;
+            }>>;
+            pose: z.ZodOptional<z.ZodString>;
+            expression: z.ZodOptional<z.ZodString>;
+            action: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "character" | "location" | "item" | "scene";
+            primaryDescription: string;
+            physicalTraits?: {
+                height?: string | undefined;
+                age?: string | undefined;
+                gender?: string | undefined;
+                bodyType?: string | undefined;
+                skinTone?: string | undefined;
+                hairColor?: string | undefined;
+                hairStyle?: string | undefined;
+                eyeColor?: string | undefined;
+                facialFeatures?: string | undefined;
+                distinguishingMarks?: string[] | undefined;
+            } | undefined;
+            attire?: {
+                description: string;
+                colors?: string[] | undefined;
+                materials?: string[] | undefined;
+                accessories?: string[] | undefined;
+            } | undefined;
+            environment?: {
+                setting: string;
+                timeOfDay?: string | undefined;
+                weather?: string | undefined;
+                lighting?: string | undefined;
+                architecture?: string | undefined;
+                vegetation?: string | undefined;
+                notableFeatures?: string[] | undefined;
+            } | undefined;
+            objectDetails?: {
+                size?: string | undefined;
+                material?: string | undefined;
+                condition?: string | undefined;
+                glowOrEffects?: string | undefined;
+            } | undefined;
+            pose?: string | undefined;
+            expression?: string | undefined;
+            action?: string | undefined;
+        }, {
+            type: "character" | "location" | "item" | "scene";
+            primaryDescription: string;
+            physicalTraits?: {
+                height?: string | undefined;
+                age?: string | undefined;
+                gender?: string | undefined;
+                bodyType?: string | undefined;
+                skinTone?: string | undefined;
+                hairColor?: string | undefined;
+                hairStyle?: string | undefined;
+                eyeColor?: string | undefined;
+                facialFeatures?: string | undefined;
+                distinguishingMarks?: string[] | undefined;
+            } | undefined;
+            attire?: {
+                description: string;
+                colors?: string[] | undefined;
+                materials?: string[] | undefined;
+                accessories?: string[] | undefined;
+            } | undefined;
+            environment?: {
+                setting: string;
+                timeOfDay?: string | undefined;
+                weather?: string | undefined;
+                lighting?: string | undefined;
+                architecture?: string | undefined;
+                vegetation?: string | undefined;
+                notableFeatures?: string[] | undefined;
+            } | undefined;
+            objectDetails?: {
+                size?: string | undefined;
+                material?: string | undefined;
+                condition?: string | undefined;
+                glowOrEffects?: string | undefined;
+            } | undefined;
+            pose?: string | undefined;
+            expression?: string | undefined;
+            action?: string | undefined;
+        }>;
+        style: z.ZodObject<{
+            artisticStyle: z.ZodString;
+            genre: z.ZodString;
+            mood: z.ZodString;
+            colorScheme: z.ZodOptional<z.ZodString>;
+            influences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            qualityTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            negativeElements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            genre: string;
+            artisticStyle: string;
+            mood: string;
+            colorScheme?: string | undefined;
+            qualityTags?: string[] | undefined;
+            influences?: string[] | undefined;
+            negativeElements?: string[] | undefined;
+        }, {
+            genre: string;
+            artisticStyle: string;
+            mood: string;
+            colorScheme?: string | undefined;
+            qualityTags?: string[] | undefined;
+            influences?: string[] | undefined;
+            negativeElements?: string[] | undefined;
+        }>;
+        composition: z.ZodObject<{
+            framing: z.ZodString;
+            cameraAngle: z.ZodOptional<z.ZodString>;
+            aspectRatio: z.ZodOptional<z.ZodString>;
+            focusPoint: z.ZodOptional<z.ZodString>;
+            background: z.ZodOptional<z.ZodString>;
+            depth: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            framing: string;
+            background?: string | undefined;
+            aspectRatio?: string | undefined;
+            cameraAngle?: string | undefined;
+            focusPoint?: string | undefined;
+            depth?: string | undefined;
+        }, {
+            framing: string;
+            background?: string | undefined;
+            aspectRatio?: string | undefined;
+            cameraAngle?: string | undefined;
+            focusPoint?: string | undefined;
+            depth?: string | undefined;
+        }>;
+        prompts: z.ZodOptional<z.ZodObject<{
+            generic: z.ZodOptional<z.ZodString>;
+            sdxl: z.ZodOptional<z.ZodString>;
+            dalle: z.ZodOptional<z.ZodString>;
+            midjourney: z.ZodOptional<z.ZodString>;
+            flux: z.ZodOptional<z.ZodString>;
+            comfyui: z.ZodOptional<z.ZodObject<{
+                positive: z.ZodString;
+                negative: z.ZodString;
+                checkpoint: z.ZodOptional<z.ZodString>;
+                loras: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    weight: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    weight: number;
+                    name: string;
+                }, {
+                    weight: number;
+                    name: string;
+                }>, "many">>;
+                samplerSettings: z.ZodOptional<z.ZodObject<{
+                    sampler: z.ZodOptional<z.ZodString>;
+                    scheduler: z.ZodOptional<z.ZodString>;
+                    steps: z.ZodOptional<z.ZodNumber>;
+                    cfg: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                }, {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                positive: string;
+                negative: string;
+                checkpoint?: string | undefined;
+                loras?: {
+                    weight: number;
+                    name: string;
+                }[] | undefined;
+                samplerSettings?: {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                } | undefined;
+            }, {
+                positive: string;
+                negative: string;
+                checkpoint?: string | undefined;
+                loras?: {
+                    weight: number;
+                    name: string;
+                }[] | undefined;
+                samplerSettings?: {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                } | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            dalle?: string | undefined;
+            sdxl?: string | undefined;
+            midjourney?: string | undefined;
+            comfyui?: {
+                positive: string;
+                negative: string;
+                checkpoint?: string | undefined;
+                loras?: {
+                    weight: number;
+                    name: string;
+                }[] | undefined;
+                samplerSettings?: {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                } | undefined;
+            } | undefined;
+            flux?: string | undefined;
+            generic?: string | undefined;
+        }, {
+            dalle?: string | undefined;
+            sdxl?: string | undefined;
+            midjourney?: string | undefined;
+            comfyui?: {
+                positive: string;
+                negative: string;
+                checkpoint?: string | undefined;
+                loras?: {
+                    weight: number;
+                    name: string;
+                }[] | undefined;
+                samplerSettings?: {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                } | undefined;
+            } | undefined;
+            flux?: string | undefined;
+            generic?: string | undefined;
+        }>>;
+        generations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            tool: z.ZodString;
+            prompt: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+            base64: z.ZodOptional<z.ZodString>;
+            seed: z.ZodOptional<z.ZodNumber>;
+            timestamp: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            tool: string;
+            prompt: string;
+            timestamp: string;
+            url?: string | undefined;
+            base64?: string | undefined;
+            seed?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }, {
+            id: string;
+            tool: string;
+            prompt: string;
+            timestamp: string;
+            url?: string | undefined;
+            base64?: string | undefined;
+            seed?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        consistency: z.ZodOptional<z.ZodObject<{
+            characterRef: z.ZodOptional<z.ZodString>;
+            seedImage: z.ZodOptional<z.ZodString>;
+            colorPalette: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            styleRef: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            characterRef?: string | undefined;
+            seedImage?: string | undefined;
+            colorPalette?: string[] | undefined;
+            styleRef?: string | undefined;
+        }, {
+            characterRef?: string | undefined;
+            seedImage?: string | undefined;
+            colorPalette?: string[] | undefined;
+            styleRef?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        style: {
+            genre: string;
+            artisticStyle: string;
+            mood: string;
+            colorScheme?: string | undefined;
+            qualityTags?: string[] | undefined;
+            influences?: string[] | undefined;
+            negativeElements?: string[] | undefined;
+        };
+        subject: {
+            type: "character" | "location" | "item" | "scene";
+            primaryDescription: string;
+            physicalTraits?: {
+                height?: string | undefined;
+                age?: string | undefined;
+                gender?: string | undefined;
+                bodyType?: string | undefined;
+                skinTone?: string | undefined;
+                hairColor?: string | undefined;
+                hairStyle?: string | undefined;
+                eyeColor?: string | undefined;
+                facialFeatures?: string | undefined;
+                distinguishingMarks?: string[] | undefined;
+            } | undefined;
+            attire?: {
+                description: string;
+                colors?: string[] | undefined;
+                materials?: string[] | undefined;
+                accessories?: string[] | undefined;
+            } | undefined;
+            environment?: {
+                setting: string;
+                timeOfDay?: string | undefined;
+                weather?: string | undefined;
+                lighting?: string | undefined;
+                architecture?: string | undefined;
+                vegetation?: string | undefined;
+                notableFeatures?: string[] | undefined;
+            } | undefined;
+            objectDetails?: {
+                size?: string | undefined;
+                material?: string | undefined;
+                condition?: string | undefined;
+                glowOrEffects?: string | undefined;
+            } | undefined;
+            pose?: string | undefined;
+            expression?: string | undefined;
+            action?: string | undefined;
+        };
+        composition: {
+            framing: string;
+            background?: string | undefined;
+            aspectRatio?: string | undefined;
+            cameraAngle?: string | undefined;
+            focusPoint?: string | undefined;
+            depth?: string | undefined;
+        };
+        consistency?: {
+            characterRef?: string | undefined;
+            seedImage?: string | undefined;
+            colorPalette?: string[] | undefined;
+            styleRef?: string | undefined;
+        } | undefined;
+        prompts?: {
+            dalle?: string | undefined;
+            sdxl?: string | undefined;
+            midjourney?: string | undefined;
+            comfyui?: {
+                positive: string;
+                negative: string;
+                checkpoint?: string | undefined;
+                loras?: {
+                    weight: number;
+                    name: string;
+                }[] | undefined;
+                samplerSettings?: {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                } | undefined;
+            } | undefined;
+            flux?: string | undefined;
+            generic?: string | undefined;
+        } | undefined;
+        generations?: {
+            id: string;
+            tool: string;
+            prompt: string;
+            timestamp: string;
+            url?: string | undefined;
+            base64?: string | undefined;
+            seed?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }, {
+        style: {
+            genre: string;
+            artisticStyle: string;
+            mood: string;
+            colorScheme?: string | undefined;
+            qualityTags?: string[] | undefined;
+            influences?: string[] | undefined;
+            negativeElements?: string[] | undefined;
+        };
+        subject: {
+            type: "character" | "location" | "item" | "scene";
+            primaryDescription: string;
+            physicalTraits?: {
+                height?: string | undefined;
+                age?: string | undefined;
+                gender?: string | undefined;
+                bodyType?: string | undefined;
+                skinTone?: string | undefined;
+                hairColor?: string | undefined;
+                hairStyle?: string | undefined;
+                eyeColor?: string | undefined;
+                facialFeatures?: string | undefined;
+                distinguishingMarks?: string[] | undefined;
+            } | undefined;
+            attire?: {
+                description: string;
+                colors?: string[] | undefined;
+                materials?: string[] | undefined;
+                accessories?: string[] | undefined;
+            } | undefined;
+            environment?: {
+                setting: string;
+                timeOfDay?: string | undefined;
+                weather?: string | undefined;
+                lighting?: string | undefined;
+                architecture?: string | undefined;
+                vegetation?: string | undefined;
+                notableFeatures?: string[] | undefined;
+            } | undefined;
+            objectDetails?: {
+                size?: string | undefined;
+                material?: string | undefined;
+                condition?: string | undefined;
+                glowOrEffects?: string | undefined;
+            } | undefined;
+            pose?: string | undefined;
+            expression?: string | undefined;
+            action?: string | undefined;
+        };
+        composition: {
+            framing: string;
+            background?: string | undefined;
+            aspectRatio?: string | undefined;
+            cameraAngle?: string | undefined;
+            focusPoint?: string | undefined;
+            depth?: string | undefined;
+        };
+        consistency?: {
+            characterRef?: string | undefined;
+            seedImage?: string | undefined;
+            colorPalette?: string[] | undefined;
+            styleRef?: string | undefined;
+        } | undefined;
+        prompts?: {
+            dalle?: string | undefined;
+            sdxl?: string | undefined;
+            midjourney?: string | undefined;
+            comfyui?: {
+                positive: string;
+                negative: string;
+                checkpoint?: string | undefined;
+                loras?: {
+                    weight: number;
+                    name: string;
+                }[] | undefined;
+                samplerSettings?: {
+                    sampler?: string | undefined;
+                    scheduler?: string | undefined;
+                    steps?: number | undefined;
+                    cfg?: number | undefined;
+                } | undefined;
+            } | undefined;
+            flux?: string | undefined;
+            generic?: string | undefined;
+        } | undefined;
+        generations?: {
+            id: string;
+            tool: string;
+            prompt: string;
+            timestamp: string;
+            url?: string | undefined;
+            base64?: string | undefined;
+            seed?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }>>;
     createdAt: z.ZodString;
 };
 export declare const characterListOutputSchema: {
@@ -547,7 +1138,7 @@ export declare const resourceOutputSchema: {
     id: z.ZodString;
     gameId: z.ZodString;
     ownerId: z.ZodNullable<z.ZodString>;
-    ownerType: z.ZodEnum<["game", "character"]>;
+    ownerType: z.ZodEnum<["game", "character", "faction", "location"]>;
     name: z.ZodString;
     description: z.ZodString;
     category: z.ZodNullable<z.ZodString>;

package/dist/utils/output-schemas.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { imageGenSchema, voiceSchema } from "../schemas/index.js";
 /**
  * Shared output schemas for MCP tools.
  * These enable clients to validate structured outputs from tools.
@@ -89,6 +90,8 @@ export const characterOutputSchema = {
     status: characterStatusSchema,
     locationId: z.string().nullable(),
     notes: z.string(),
+    voice: voiceSchema.nullable(),
+    imageGen: imageGenSchema.nullable(),
     createdAt: z.string(),
 };
 export const characterListOutputSchema = {
@@ -275,7 +278,7 @@ export const resourceOutputSchema = {
     id: z.string(),
     gameId: z.string(),
     ownerId: z.string().nullable(),
-    ownerType: z.enum(["game", "character"]),
+    ownerType: z.enum(["game", "character", "faction", "location"]),
     name: z.string(),
     description: z.string(),
     category: z.string().nullable(),

package/dist/utils/webui.d.ts

@@ -1,3 +1,35 @@
+/**
+ * Port the web UI listens on when nothing says otherwise.
+ */
+export declare const DEFAULT_HTTP_PORT = 3456;
+/**
+ * Which port the web UI should listen on, read from an environment rather than
+ * from the ambient process, so the answer can be tested from a value.
+ *
+ * An out-of-range or unparseable DMCP_HTTP_PORT falls back to the default. The
+ * inherited code did `parseInt(value || "3456", 10)` and handed the NaN
+ * straight to `listen()`, which quietly bound a random port instead -- an
+ * operator who mistyped a port got a working server on an address they could
+ * not predict. `0` is kept, because that is the real way to ask for any free
+ * port.
+ */
+export declare function httpPortFromEnv(env?: NodeJS.ProcessEnv): number;
+/**
+ * Whether the executable should serve the web UI.
+ *
+ * The web UI is an application's feature, not a library's: a process that only
+ * needs the engine has no use for an admin page, and one that starts a server
+ * squats a port and cannot exit. Importing this package therefore starts
+ * nothing at all (see src/index.ts), and the shipped executable serves the
+ * web UI by default -- unless DMCP_NO_HTTP says not to, which is what a host
+ * that spawns this as an MCP subprocess sets for it.
+ *
+ * `0`, `false` and an empty value leave it on, because a launcher that writes
+ * `DMCP_NO_HTTP=${disabled ? 1 : 0}` means the web UI to run when it writes 0.
+ * These are literal tokens in a variable this project defines, not an attempt
+ * to read intent out of prose.
+ */
+export declare function webUiEnabled(env?: NodeJS.ProcessEnv): boolean;
 /**
  * Set the actual HTTP port after server starts
  */