@genart-dev/mcp-server 0.1.0

package/dist/lib.d.cts

@@ -0,0 +1,98 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { EventEmitter } from 'events';
+import { WorkspaceDefinition, SketchDefinition } from '@genart-dev/core';
+
+/**
+ * EditorState — server-scoped mutable state for the MCP server.
+ * Tracks the active workspace, loaded sketches, and current selection.
+ * Emits mutation events for real-time state broadcasting.
+ */
+
+/** A loaded sketch with its parsed definition and absolute file path. */
+interface LoadedSketch {
+    definition: SketchDefinition;
+    path: string;
+}
+/** Mutation event types emitted by EditorState. */
+type EditorMutationType = "workspace:loaded" | "workspace:saved" | "workspace:updated" | "sketch:loaded" | "sketch:created" | "sketch:updated" | "sketch:saved" | "sketch:removed" | "sketch:deleted" | "selection:changed";
+/** Payload for EditorState mutation events. */
+interface EditorMutationEvent {
+    type: EditorMutationType;
+    payload: unknown;
+}
+/** Serializable snapshot of the full editor state. */
+interface EditorStateSnapshot {
+    workspacePath: string | null;
+    workspace: WorkspaceDefinition | null;
+    sketches: Array<{
+        id: string;
+        definition: SketchDefinition;
+        path: string;
+    }>;
+    selection: string[];
+}
+/** Server-scoped mutable state for the MCP server. */
+declare class EditorState extends EventEmitter {
+    /** Absolute path to the active .genart-workspace file, or null. */
+    workspacePath: string | null;
+    /** Parsed workspace definition, or null if no workspace is open. */
+    workspace: WorkspaceDefinition | null;
+    /** Loaded sketches keyed by sketch ID. */
+    sketches: Map<string, LoadedSketch>;
+    /** Currently selected sketch IDs. */
+    selection: Set<string>;
+    /**
+     * Base directory for all file operations. When set, all paths are
+     * resolved relative to this directory and constrained within it.
+     * Used by mcp-host for per-session sandboxing.
+     */
+    basePath: string | null;
+    /**
+     * When true, the server is running remotely and cannot access the
+     * user's local filesystem. Tools return file content in responses
+     * instead of writing to disk. Set by mcp-host for HTTP-based sessions.
+     */
+    remoteMode: boolean;
+    constructor(options?: {
+        basePath?: string;
+        remoteMode?: boolean;
+    });
+    /** Update the working directory / sandbox base path. */
+    setBasePath(dir: string): void;
+    /** Resolve a file path, respecting the sandbox basePath when set. */
+    resolvePath(file: string): string;
+    /** Resolve a sketch file reference (relative to workspace dir) to an absolute path. */
+    resolveSketchPath(file: string): string;
+    /** Load a workspace from disk and all its referenced sketches. */
+    loadWorkspace(absPath: string): Promise<void>;
+    /** Load a single sketch from disk and add it to the cache. */
+    loadSketch(absPath: string): Promise<SketchDefinition>;
+    /** Get a loaded sketch by ID. */
+    getSketch(id: string): LoadedSketch | undefined;
+    /** Require a loaded sketch by ID, throwing if not found. */
+    requireSketch(id: string): LoadedSketch;
+    /** Require an open workspace, throwing if none is open. */
+    requireWorkspace(): WorkspaceDefinition;
+    /** Remove a sketch from the in-memory cache. */
+    removeSketch(id: string): void;
+    /** Save the active workspace to disk. */
+    saveWorkspace(): Promise<void>;
+    /** Save a sketch to disk. */
+    saveSketch(id: string): Promise<void>;
+    /** Update the selection and return the new set. */
+    setSelection(ids: string[]): void;
+    /** Get a serializable snapshot of the full editor state. */
+    getSnapshot(): EditorStateSnapshot;
+    /** Emit a mutation event for external listeners (WebSocket broadcast, sidecar IPC). */
+    emitMutation(type: EditorMutationType, payload: unknown): void;
+}
+
+/**
+ * MCP server creation and tool registration.
+ * Creates a McpServer instance with all tools, resources, and prompts.
+ */
+
+/** Create and configure the MCP server with all tools. */
+declare function createServer(state: EditorState): McpServer;
+
+export { type EditorMutationEvent, type EditorMutationType, EditorState, type EditorStateSnapshot, type LoadedSketch, createServer };

package/dist/lib.d.ts

@@ -0,0 +1,98 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { EventEmitter } from 'events';
+import { WorkspaceDefinition, SketchDefinition } from '@genart-dev/core';
+
+/**
+ * EditorState — server-scoped mutable state for the MCP server.
+ * Tracks the active workspace, loaded sketches, and current selection.
+ * Emits mutation events for real-time state broadcasting.
+ */
+
+/** A loaded sketch with its parsed definition and absolute file path. */
+interface LoadedSketch {
+    definition: SketchDefinition;
+    path: string;
+}
+/** Mutation event types emitted by EditorState. */
+type EditorMutationType = "workspace:loaded" | "workspace:saved" | "workspace:updated" | "sketch:loaded" | "sketch:created" | "sketch:updated" | "sketch:saved" | "sketch:removed" | "sketch:deleted" | "selection:changed";
+/** Payload for EditorState mutation events. */
+interface EditorMutationEvent {
+    type: EditorMutationType;
+    payload: unknown;
+}
+/** Serializable snapshot of the full editor state. */
+interface EditorStateSnapshot {
+    workspacePath: string | null;
+    workspace: WorkspaceDefinition | null;
+    sketches: Array<{
+        id: string;
+        definition: SketchDefinition;
+        path: string;
+    }>;
+    selection: string[];
+}
+/** Server-scoped mutable state for the MCP server. */
+declare class EditorState extends EventEmitter {
+    /** Absolute path to the active .genart-workspace file, or null. */
+    workspacePath: string | null;
+    /** Parsed workspace definition, or null if no workspace is open. */
+    workspace: WorkspaceDefinition | null;
+    /** Loaded sketches keyed by sketch ID. */
+    sketches: Map<string, LoadedSketch>;
+    /** Currently selected sketch IDs. */
+    selection: Set<string>;
+    /**
+     * Base directory for all file operations. When set, all paths are
+     * resolved relative to this directory and constrained within it.
+     * Used by mcp-host for per-session sandboxing.
+     */
+    basePath: string | null;
+    /**
+     * When true, the server is running remotely and cannot access the
+     * user's local filesystem. Tools return file content in responses
+     * instead of writing to disk. Set by mcp-host for HTTP-based sessions.
+     */
+    remoteMode: boolean;
+    constructor(options?: {
+        basePath?: string;
+        remoteMode?: boolean;
+    });
+    /** Update the working directory / sandbox base path. */
+    setBasePath(dir: string): void;
+    /** Resolve a file path, respecting the sandbox basePath when set. */
+    resolvePath(file: string): string;
+    /** Resolve a sketch file reference (relative to workspace dir) to an absolute path. */
+    resolveSketchPath(file: string): string;
+    /** Load a workspace from disk and all its referenced sketches. */
+    loadWorkspace(absPath: string): Promise<void>;
+    /** Load a single sketch from disk and add it to the cache. */
+    loadSketch(absPath: string): Promise<SketchDefinition>;
+    /** Get a loaded sketch by ID. */
+    getSketch(id: string): LoadedSketch | undefined;
+    /** Require a loaded sketch by ID, throwing if not found. */
+    requireSketch(id: string): LoadedSketch;
+    /** Require an open workspace, throwing if none is open. */
+    requireWorkspace(): WorkspaceDefinition;
+    /** Remove a sketch from the in-memory cache. */
+    removeSketch(id: string): void;
+    /** Save the active workspace to disk. */
+    saveWorkspace(): Promise<void>;
+    /** Save a sketch to disk. */
+    saveSketch(id: string): Promise<void>;
+    /** Update the selection and return the new set. */
+    setSelection(ids: string[]): void;
+    /** Get a serializable snapshot of the full editor state. */
+    getSnapshot(): EditorStateSnapshot;
+    /** Emit a mutation event for external listeners (WebSocket broadcast, sidecar IPC). */
+    emitMutation(type: EditorMutationType, payload: unknown): void;
+}
+
+/**
+ * MCP server creation and tool registration.
+ * Creates a McpServer instance with all tools, resources, and prompts.
+ */
+
+/** Create and configure the MCP server with all tools. */
+declare function createServer(state: EditorState): McpServer;
+
+export { type EditorMutationEvent, type EditorMutationType, EditorState, type EditorStateSnapshot, type LoadedSketch, createServer };