@mythxengine/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Proto Labs AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/assemble.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assemble.test.d.ts.map

package/dist/__tests__/assemble.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/assemble.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/assemble.test.js

@@ -0,0 +1,81 @@
+import { describe, it, expect } from "vitest";
+import { mergeById } from "../tools/worldpack/assemble.js";
+describe("mergeById", () => {
+    it("returns base items when no expansions", () => {
+        const base = [
+            { id: "a", name: "Alpha" },
+            { id: "b", name: "Beta" },
+        ];
+        const result = mergeById(base, []);
+        expect(result).toEqual(base);
+    });
+    it("adds new items from expansions", () => {
+        const base = [{ id: "a", name: "Alpha" }];
+        const expanded = [{ id: "b", name: "Beta" }];
+        const result = mergeById(base, expanded);
+        expect(result).toHaveLength(2);
+        expect(result.find((i) => i.id === "b")).toEqual({ id: "b", name: "Beta" });
+    });
+    it("deep merges matching items by ID", () => {
+        const base = [
+            { id: "x", name: "Original", value: 1, nested: { a: 10, b: 20 } },
+        ];
+        const expanded = [
+            { id: "x", value: 99, nested: { b: 200 } },
+        ];
+        const result = mergeById(base, expanded);
+        expect(result[0]).toEqual({
+            id: "x",
+            name: "Original", // preserved
+            value: 99, // overwritten
+            nested: { a: 10, b: 200 }, // deep merged
+        });
+    });
+    it("does not mutate original arrays", () => {
+        const base = [{ id: "a", name: "Original", nested: { a: 1 } }];
+        const expanded = [{ id: "a", nested: { b: 2 } }];
+        const baseCopy = JSON.parse(JSON.stringify(base));
+        mergeById(base, expanded);
+        expect(base).toEqual(baseCopy);
+    });
+    it("handles complex archetype-like expansion", () => {
+        const base = [
+            {
+                id: "fighter",
+                name: "Fighter",
+                features: ["Attack", "Defend"],
+                stats: { hp: 12, armor: 2 },
+            },
+        ];
+        const expanded = [
+            {
+                id: "fighter",
+                name: "Fighter",
+                features: ["Attack", "Defend"],
+                stats: { hp: 12, armor: 2 },
+                skills: ["Cleave", "Shield Bash"],
+            },
+        ];
+        const result = mergeById(base, expanded);
+        const fighter = result[0];
+        expect(fighter.name).toBe("Fighter");
+        expect(fighter.features).toEqual(["Attack", "Defend"]);
+        expect(fighter.stats).toEqual({ hp: 12, armor: 2 });
+        expect(fighter.skills).toEqual(["Cleave", "Shield Bash"]);
+    });
+    it("preserves order with base items first", () => {
+        const base = [
+            { id: "a", value: 1 },
+            { id: "b", value: 2 },
+        ];
+        const expanded = [
+            { id: "c", value: 3 },
+            { id: "a", value: 100 },
+        ];
+        const result = mergeById(base, expanded);
+        const ids = result.map((i) => i.id);
+        expect(ids).toEqual(["a", "b", "c"]);
+        expect(result[0].value).toBe(100); // merged value
+    });
+});
+//# sourceMappingURL=assemble.test.js.map

package/dist/__tests__/assemble.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * RPG MCP Server
+ *
+ * A Model Context Protocol server for tabletop RPG game mechanics.
+ * Provides tools for dice rolling, character management, combat tracking,
+ * and session persistence.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * RPG MCP Server
+ *
+ * A Model Context Protocol server for tabletop RPG game mechanics.
+ * Provides tools for dice rolling, character management, combat tracking,
+ * and session persistence.
+ */
+import { createMCPServer, startMCPServer } from "./server.js";
+import { createToolRegistry } from "./tools/index.js";
+import { createResourceHandler } from "./resources/index.js";
+const SERVER_NAME = "rpg-mcp";
+const SERVER_VERSION = "0.1.0";
+async function main() {
+    // Create tool registry
+    const tools = createToolRegistry();
+    // Create resource handler
+    const resources = createResourceHandler();
+    // Create server
+    const server = createMCPServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    }, {
+        tools,
+        resources,
+        onError: (error, toolName) => ({
+            message: `Error in ${toolName}: ${error.message}`,
+            isError: true,
+        }),
+    });
+    // Start server
+    await startMCPServer(server, SERVER_NAME);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,uBAAuB;IACvB,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IAEnC,0BAA0B;IAC1B,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAC;IAE1C,gBAAgB;IAChB,MAAM,MAAM,GAAG,eAAe,CAC5B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,EACD;QACE,KAAK;QACL,SAAS;QACT,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7B,OAAO,EAAE,YAAY,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE;YACjD,OAAO,EAAE,IAAI;SACd,CAAC;KACH,CACF,CAAC;IAEF,eAAe;IACf,MAAM,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Resource handlers
+ */
+import type { ResourceHandler } from "../server.js";
+/**
+ * Create resource handler for session data
+ */
+export declare function createResourceHandler(): ResourceHandler;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAiOvD"}

package/dist/resources/index.js

@@ -0,0 +1,202 @@
+/**
+ * MCP Resource handlers
+ */
+import { sessionManager, listSessions } from "../state/manager.js";
+import { worldPackManager, listWorldPacks } from "../state/worldpacks.js";
+/**
+ * Create resource handler for session data
+ */
+export function createResourceHandler() {
+    return {
+        async list() {
+            const sessionIds = await listSessions();
+            const resources = [];
+            // Add sessions list resource
+            resources.push({
+                uri: "rpg://sessions",
+                name: "All Sessions",
+                mimeType: "application/json",
+            });
+            // Add world packs list resource
+            resources.push({
+                uri: "rpg://worlds",
+                name: "All World Packs",
+                mimeType: "application/json",
+            });
+            // Add individual world pack resources
+            const packIds = await listWorldPacks();
+            for (const packId of packIds) {
+                const pack = await worldPackManager.get(packId);
+                if (pack) {
+                    resources.push({
+                        uri: `rpg://worlds/${packId}`,
+                        name: pack.meta.name,
+                        mimeType: "application/json",
+                    });
+                }
+            }
+            // Add individual session resources
+            for (const id of sessionIds) {
+                const session = await sessionManager.get(id);
+                if (session) {
+                    resources.push({
+                        uri: `rpg://session/${id}`,
+                        name: session.metadata.name,
+                        mimeType: "application/json",
+                    });
+                    // Add character resources for this session
+                    for (const [charId, char] of Object.entries(session.characters)) {
+                        resources.push({
+                            uri: `rpg://session/${id}/character/${charId}`,
+                            name: `${char.name} (${session.metadata.name})`,
+                            mimeType: "application/json",
+                        });
+                    }
+                    // Add generation resource if generation session exists
+                    if (session.generation) {
+                        resources.push({
+                            uri: `rpg://generation/${id}`,
+                            name: `Generation State (${session.metadata.name})`,
+                            mimeType: "application/json",
+                        });
+                    }
+                }
+            }
+            return resources;
+        },
+        async read(uri) {
+            const url = new URL(uri);
+            if (url.protocol !== "rpg:") {
+                throw new Error(`Unknown protocol: ${url.protocol}`);
+            }
+            const path = url.pathname.replace(/^\/\//, "");
+            const parts = path.split("/");
+            // rpg://sessions
+            if (path === "sessions") {
+                const sessionIds = await listSessions();
+                const sessions = await Promise.all(sessionIds.map(async (id) => {
+                    const session = await sessionManager.get(id);
+                    return session
+                        ? {
+                            id: session.metadata.id,
+                            name: session.metadata.name,
+                            createdAt: session.metadata.createdAt,
+                            characterCount: Object.keys(session.characters).length,
+                        }
+                        : null;
+                }));
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify({ sessions: sessions.filter(Boolean) }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // rpg://session/:id
+            if (parts[0] === "session" && parts.length === 2) {
+                const sessionId = parts[1];
+                const session = await sessionManager.get(sessionId);
+                if (!session) {
+                    throw new Error(`Session not found: ${sessionId}`);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(session, null, 2),
+                        },
+                    ],
+                };
+            }
+            // rpg://session/:id/character/:charId
+            if (parts[0] === "session" && parts[2] === "character" && parts.length === 4) {
+                const sessionId = parts[1];
+                const characterId = parts[3];
+                const session = await sessionManager.get(sessionId);
+                if (!session) {
+                    throw new Error(`Session not found: ${sessionId}`);
+                }
+                const character = session.characters[characterId];
+                if (!character) {
+                    throw new Error(`Character not found: ${characterId}`);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(character, null, 2),
+                        },
+                    ],
+                };
+            }
+            // rpg://generation/:sessionId
+            if (parts[0] === "generation" && parts.length === 2) {
+                const sessionId = parts[1];
+                const session = await sessionManager.get(sessionId);
+                if (!session) {
+                    throw new Error(`Session not found: ${sessionId}`);
+                }
+                if (!session.generation) {
+                    throw new Error(`No generation state for session: ${sessionId}`);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(session.generation, null, 2),
+                        },
+                    ],
+                };
+            }
+            // rpg://worlds
+            if (path === "worlds") {
+                const packIds = await listWorldPacks();
+                const packs = await Promise.all(packIds.map(async (id) => {
+                    const pack = await worldPackManager.get(id);
+                    return pack
+                        ? {
+                            id: pack.meta.id,
+                            name: pack.meta.name,
+                            tagline: pack.meta.tagline,
+                            contentCounts: pack.meta.contentCounts,
+                        }
+                        : null;
+                }));
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify({ worlds: packs.filter(Boolean) }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // rpg://worlds/:packId
+            if (parts[0] === "worlds" && parts.length === 2) {
+                const packId = parts[1];
+                const pack = await worldPackManager.get(packId);
+                if (!pack) {
+                    throw new Error(`World pack not found: ${packId}`);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(pack, null, 2),
+                        },
+                    ],
+                };
+            }
+            throw new Error(`Unknown resource: ${uri}`);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MCP Server factory
+ * Adapted from rogue-borg shared-mcp-server
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { MCPToolRegistry } from "@mythxengine/types";
+export interface MCPServerConfig {
+    name: string;
+    version: string;
+}
+export interface ResourceHandler {
+    list: () => Promise<Array<{
+        uri: string;
+        name: string;
+        mimeType?: string;
+    }>>;
+    read: (uri: string) => Promise<{
+        contents: Array<{
+            uri: string;
+            mimeType: string;
+            text: string;
+        }>;
+    }>;
+}
+export interface MCPServerOptions {
+    tools: MCPToolRegistry;
+    resources?: ResourceHandler;
+    onError?: (error: Error, toolName: string) => {
+        message: string;
+        isError: boolean;
+    };
+}
+/**
+ * Create an MCP server with the given tools
+ */
+export declare function createMCPServer(config: MCPServerConfig, options: MCPServerOptions): Server;
+/**
+ * Start the MCP server with stdio transport
+ */
+export declare function startMCPServer(server: Server, serverName: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7E,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACtG;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CACrF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAuFR;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItF"}

package/dist/server.js

@@ -0,0 +1,91 @@
+/**
+ * MCP Server factory
+ * Adapted from rogue-borg shared-mcp-server
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Create an MCP server with the given tools
+ */
+export function createMCPServer(config, options) {
+    const server = new Server({
+        name: config.name,
+        version: config.version,
+    }, {
+        capabilities: {
+            tools: {
+                listChanged: false,
+            },
+            resources: options.resources ? {} : undefined,
+        },
+    });
+    // List tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: Array.from(options.tools.values()).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        })),
+    }));
+    // Call tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const tool = options.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        try {
+            const args = request.params.arguments || {};
+            const result = await tool.handler(args);
+            // If result already has content field, return as-is
+            if (result && typeof result === "object" && "content" in result) {
+                return result;
+            }
+            // Wrap result in standard MCP format
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (options.onError) {
+                const customError = options.onError(error instanceof Error ? error : new Error(String(error)), toolName);
+                return {
+                    content: [{ type: "text", text: customError.message }],
+                    isError: customError.isError,
+                };
+            }
+            return {
+                content: [{ type: "text", text: `Error: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+    });
+    // Resource handlers (if provided)
+    if (options.resources) {
+        server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            const resources = await options.resources.list();
+            return { resources };
+        });
+        server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const result = await options.resources.read(request.params.uri);
+            return result;
+        });
+    }
+    return server;
+}
+/**
+ * Start the MCP server with stdio transport
+ */
+export async function startMCPServer(server, serverName) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${serverName} MCP Server running on stdio`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/state/manager.d.ts

@@ -0,0 +1,88 @@
+/**
+ * File-based session state persistence
+ * Adapted from rogue-borg shared-mcp-state
+ */
+import type { SessionState, GenerationManifest, ManifestStep } from "@mythxengine/types";
+/**
+ * Get the generation directory for a session
+ */
+export declare function getGenerationDir(sessionId: string): string;
+/**
+ * Ensure the generation directory exists
+ */
+export declare function ensureGenerationDir(sessionId: string): Promise<string>;
+/**
+ * Write a step file atomically (temp file + rename)
+ */
+export declare function writeStepFile(sessionId: string, filename: string, data: unknown): Promise<void>;
+/**
+ * Read a step file
+ */
+export declare function readStepFile(sessionId: string, filename: string): Promise<unknown | null>;
+/**
+ * Read the generation manifest with validation
+ */
+export declare function readManifest(sessionId: string): Promise<GenerationManifest | null>;
+/**
+ * Write the generation manifest atomically
+ */
+export declare function writeManifest(sessionId: string, manifest: GenerationManifest): Promise<void>;
+/**
+ * Create initial manifest for a new generation session
+ */
+export declare function createManifest(sessionId: string, campaignSeed: string, tier: "small" | "medium" | "large", settings?: GenerationManifest["settings"], rulesConfig?: unknown): GenerationManifest;
+/**
+ * Add a step to the manifest
+ */
+export declare function addManifestStep(manifest: GenerationManifest, type: string, file?: string): ManifestStep;
+/**
+ * Find a step in the manifest by type
+ */
+export declare function findManifestStep(manifest: GenerationManifest, type: string): ManifestStep | undefined;
+/**
+ * Update a step's status in the manifest
+ * @returns true if step was found and updated, false otherwise
+ */
+export declare function updateManifestStep(manifest: GenerationManifest, type: string, updates: Partial<ManifestStep>): boolean;
+/**
+ * List all step files in the generation directory
+ */
+export declare function listStepFiles(sessionId: string): Promise<string[]>;
+/**
+ * List all expansion files in the generation directory
+ */
+export declare function listExpansionFiles(sessionId: string): Promise<string[]>;
+/**
+ * Load a session from disk
+ */
+export declare function loadSession(sessionId: string): Promise<SessionState | null>;
+/**
+ * Save a session to disk
+ */
+export declare function saveSession(state: SessionState): Promise<void>;
+/**
+ * Get or create a session
+ */
+export declare function getOrCreateSession(sessionId: string, name?: string): Promise<SessionState>;
+/**
+ * Delete a session
+ */
+export declare function deleteSession(sessionId: string): Promise<void>;
+/**
+ * List all sessions
+ */
+export declare function listSessions(): Promise<string[]>;
+/**
+ * Session state manager class for convenient access
+ */
+export declare class SessionManager {
+    private cache;
+    get(sessionId: string): Promise<SessionState | null>;
+    getOrCreate(sessionId: string, name?: string): Promise<SessionState>;
+    save(state: SessionState): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    list(): Promise<string[]>;
+    clearCache(): void;
+}
+export declare const sessionManager: SessionManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/state/manager.d.ts.map

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