godot-mcp-runtime 2.3.0 → 3.1.0

package/dist/utils/bridge-manager.js

@@ -0,0 +1,186 @@
+import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { logDebug } from './logger.js';
+import { addAutoloadEntry, parseAutoloads, removeAutoloadEntry } from './autoload-ini.js';
+const BRIDGE_AUTOLOAD_NAME = 'McpBridge';
+const BRIDGE_SCRIPT_FILENAME = 'mcp_bridge.gd';
+const MCP_GITIGNORE_ENTRY = '.mcp/';
+// Matches the baked-port marker line inserted in src/scripts/mcp_bridge.gd —
+// `const PORT := <int>` — so inject() can rewrite the integer per project.
+const BAKED_PORT_REGEX = /const PORT := \d+/;
+/**
+ * Owns the McpBridge autoload artifact: the script copy in the target project,
+ * the `[autoload]` entry in project.godot, the `.mcp/.gdignore` marker, and the
+ * `.gitignore` augmentation. GodotRunner delegates to this for inject/cleanup
+ * during run_project / attach_project / stop_project flows.
+ *
+ * The project-root bridge script is runtime-owned and refreshed on first
+ * injection for a manager session so a rebuilt server cannot talk to stale
+ * GDScript from an earlier run. Idempotent within a session via
+ * `injectedProjects`: a second `inject()` call for the same path short-circuits
+ * without rewriting project.godot.
+ */
+export class BridgeManager {
+    bridgeScriptPath;
+    injectedProjects = new Set();
+    repairedProjects = new Set();
+    /**
+     * Last port baked into the on-disk script per project. Used by the
+     * race-detection helper in runtime-tools to spot a concurrent re-inject
+     * after a bridge-wait timeout.
+     */
+    lastInjectedPort = new Map();
+    constructor(bridgeScriptPath) {
+        this.bridgeScriptPath = bridgeScriptPath;
+    }
+    inject(projectPath, port) {
+        // Always rewrite the destination — the per-project bridge script may
+        // differ from the template by exactly the baked integer, so a size/mtime
+        // shortcut no longer maps to "up-to-date." Bake the resolved port into
+        // the const PORT line so the running game listens on the exact port the
+        // Node side will connect to.
+        const template = readFileSync(this.bridgeScriptPath, 'utf8');
+        if (!BAKED_PORT_REGEX.test(template)) {
+            throw new Error(`Bridge script template at ${this.bridgeScriptPath} is missing the 'const PORT := <int>' marker`);
+        }
+        const baked = template.replace(BAKED_PORT_REGEX, `const PORT := ${port}`);
+        const destScript = join(projectPath, BRIDGE_SCRIPT_FILENAME);
+        writeFileSync(destScript, baked, 'utf8');
+        this.lastInjectedPort.set(projectPath, port);
+        logDebug(`Wrote bridge autoload at ${destScript} (baked port ${port})`);
+        if (this.injectedProjects.has(projectPath)) {
+            logDebug('Bridge already injected for this project; refreshed script only.');
+            return;
+        }
+        this.ensureMcpGdignore(projectPath);
+        this.ensureGitignored(projectPath);
+        const projectFile = join(projectPath, 'project.godot');
+        const existing = parseAutoloads(projectFile);
+        const alreadyRegistered = existing.some((a) => a.name === BRIDGE_AUTOLOAD_NAME);
+        if (alreadyRegistered) {
+            logDebug('Bridge autoload already present, skipping injection');
+        }
+        else {
+            addAutoloadEntry(projectFile, BRIDGE_AUTOLOAD_NAME, BRIDGE_SCRIPT_FILENAME, true);
+            logDebug('Injected bridge autoload into project.godot');
+        }
+        this.injectedProjects.add(projectPath);
+    }
+    cleanup(projectPath) {
+        this.removeBridgeArtifacts(projectPath);
+        this.injectedProjects.delete(projectPath);
+        this.repairedProjects.delete(projectPath);
+        this.lastInjectedPort.delete(projectPath);
+    }
+    /**
+     * Read the port currently baked into the project's bridge script. Returns
+     * the integer on success, or null if the file is missing, unreadable, or
+     * lacks the marker. Used to detect concurrent re-inject after a bridge-
+     * wait timeout (another MCP client may have rewritten the port).
+     */
+    readBakedPort(projectPath) {
+        const destScript = join(projectPath, BRIDGE_SCRIPT_FILENAME);
+        if (!existsSync(destScript))
+            return null;
+        try {
+            const content = readFileSync(destScript, 'utf8');
+            const match = content.match(BAKED_PORT_REGEX);
+            if (!match)
+                return null;
+            const parsed = Number.parseInt(match[0].replace(/^const PORT := /, ''), 10);
+            if (!Number.isFinite(parsed) || parsed <= 0 || parsed > 65535)
+                return null;
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * If project.godot still has an `McpBridge=` line but the script file is
+     * missing, the autoload would crash every subsequent headless op. Detect and
+     * clean the orphan before running an operation.
+     *
+     * Cached per project: once a path has been checked clean, skip the file
+     * reads on subsequent ops in the same session.
+     */
+    repairOrphaned(projectPath) {
+        if (this.repairedProjects.has(projectPath))
+            return;
+        const projectFile = join(projectPath, 'project.godot');
+        const bridgeScript = join(projectPath, BRIDGE_SCRIPT_FILENAME);
+        if (!existsSync(projectFile))
+            return;
+        if (existsSync(bridgeScript)) {
+            this.repairedProjects.add(projectPath);
+            return;
+        }
+        try {
+            const content = readFileSync(projectFile, 'utf8');
+            if (content.includes(`${BRIDGE_AUTOLOAD_NAME}=`)) {
+                this.removeBridgeArtifacts(projectPath);
+                logDebug('Cleaned up orphaned McpBridge autoload entry');
+            }
+            this.repairedProjects.add(projectPath);
+        }
+        catch (err) {
+            logDebug(`Non-fatal: Failed to check/repair orphaned bridge: ${err}`);
+        }
+    }
+    removeBridgeArtifacts(projectPath) {
+        try {
+            const projectFile = join(projectPath, 'project.godot');
+            if (existsSync(projectFile)) {
+                const removed = removeAutoloadEntry(projectFile, BRIDGE_AUTOLOAD_NAME);
+                if (removed) {
+                    logDebug(`Removed ${BRIDGE_AUTOLOAD_NAME} autoload from project.godot`);
+                }
+            }
+        }
+        catch (err) {
+            logDebug(`Non-fatal: Failed to clean ${BRIDGE_AUTOLOAD_NAME} from project.godot: ${err}`);
+        }
+        try {
+            const scriptFile = join(projectPath, BRIDGE_SCRIPT_FILENAME);
+            if (existsSync(scriptFile)) {
+                unlinkSync(scriptFile);
+                logDebug(`Removed ${BRIDGE_SCRIPT_FILENAME} from project`);
+            }
+        }
+        catch (err) {
+            logDebug(`Non-fatal: Failed to remove ${BRIDGE_SCRIPT_FILENAME}: ${err}`);
+        }
+        try {
+            const uidFile = join(projectPath, `${BRIDGE_SCRIPT_FILENAME}.uid`);
+            if (existsSync(uidFile)) {
+                unlinkSync(uidFile);
+                logDebug(`Removed ${BRIDGE_SCRIPT_FILENAME}.uid from project`);
+            }
+        }
+        catch (err) {
+            logDebug(`Non-fatal: Failed to remove ${BRIDGE_SCRIPT_FILENAME}.uid: ${err}`);
+        }
+    }
+    ensureMcpGdignore(projectPath) {
+        const mcpDir = join(projectPath, '.mcp');
+        mkdirSync(mcpDir, { recursive: true });
+        writeFileSync(join(mcpDir, '.gdignore'), '', 'utf8');
+        logDebug('Created .mcp/.gdignore');
+    }
+    ensureGitignored(projectPath) {
+        const gitignorePath = join(projectPath, '.gitignore');
+        if (existsSync(gitignorePath)) {
+            const gitignoreContent = readFileSync(gitignorePath, 'utf8');
+            if (!gitignoreContent.includes(MCP_GITIGNORE_ENTRY)) {
+                const newline = gitignoreContent.endsWith('\n') ? '' : '\n';
+                writeFileSync(gitignorePath, gitignoreContent + newline + MCP_GITIGNORE_ENTRY + '\n', 'utf8');
+                logDebug('Added .mcp/ to existing .gitignore');
+            }
+        }
+        else {
+            writeFileSync(gitignorePath, MCP_GITIGNORE_ENTRY + '\n', 'utf8');
+            logDebug('Created .gitignore with .mcp/ entry');
+        }
+    }
+}
+//# sourceMappingURL=bridge-manager.js.map

package/dist/utils/bridge-manager.js.map

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

package/dist/utils/bridge-protocol.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Wire format shared between the Node-side `GodotRunner.sendCommand` and the
+ * GDScript-side `McpBridge` autoload.
+ *
+ * KEEP IN SYNC: src/scripts/mcp_bridge.gd implements the same framing on the
+ * Godot side. Any change here MUST be mirrored there (and vice versa).
+ *
+ * Frame: 4-byte big-endian length prefix + UTF-8 JSON payload.
+ * Max frame size is 16 MiB; oversize frames are rejected on receive.
+ */
+export declare const DEFAULT_BRIDGE_PORT = 9900;
+export declare const MAX_FRAME_BYTES: number;
+export declare const FRAME_HEADER_BYTES = 4;
+/**
+ * Find an available TCP port by binding to port 0 (OS-assigned ephemeral port),
+ * reading the assigned port, and closing the listener. The brief TOCTOU window
+ * between close and the consumer's listen is acceptable — if a collision occurs,
+ * the bridge readiness check will surface the failure.
+ */
+export declare function findFreePort(): Promise<number>;
+/**
+ * Encode a JSON string as a length-prefixed frame.
+ */
+export declare function encodeFrame(payload: string): Buffer;
+export interface ParseFramesResult {
+    frames: Buffer[];
+    remainder: Buffer;
+}
+/**
+ * Pull as many complete frames as possible from a streaming buffer. Any
+ * partial frame at the tail is returned as `remainder` for the next call.
+ *
+ * Throws if a header advertises a payload larger than {@link MAX_FRAME_BYTES} —
+ * the caller should treat this as a fatal protocol error and close the socket.
+ */
+export declare function parseFrames(buffer: Buffer): ParseFramesResult;
+//# sourceMappingURL=bridge-protocol.d.ts.map

package/dist/utils/bridge-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-protocol.d.ts","sourceRoot":"","sources":["../../src/utils/bridge-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,eAAe,QAAmB,CAAC;AAChD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAkB9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAoB7D"}

package/dist/utils/bridge-protocol.js

@@ -0,0 +1,78 @@
+/**
+ * Wire format shared between the Node-side `GodotRunner.sendCommand` and the
+ * GDScript-side `McpBridge` autoload.
+ *
+ * KEEP IN SYNC: src/scripts/mcp_bridge.gd implements the same framing on the
+ * Godot side. Any change here MUST be mirrored there (and vice versa).
+ *
+ * Frame: 4-byte big-endian length prefix + UTF-8 JSON payload.
+ * Max frame size is 16 MiB; oversize frames are rejected on receive.
+ */
+import * as net from 'net';
+export const DEFAULT_BRIDGE_PORT = 9900;
+export const MAX_FRAME_BYTES = 16 * 1024 * 1024;
+export const FRAME_HEADER_BYTES = 4;
+/**
+ * Find an available TCP port by binding to port 0 (OS-assigned ephemeral port),
+ * reading the assigned port, and closing the listener. The brief TOCTOU window
+ * between close and the consumer's listen is acceptable — if a collision occurs,
+ * the bridge readiness check will surface the failure.
+ */
+export function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const srv = net.createServer();
+        srv.listen(0, '127.0.0.1', () => {
+            const addr = srv.address();
+            if (!addr || typeof addr === 'string') {
+                srv.close();
+                reject(new Error('Failed to determine assigned port'));
+                return;
+            }
+            const port = addr.port;
+            srv.close(() => resolve(port));
+        });
+        // One-shot: only fires before listen() succeeds. If listen succeeded,
+        // we proceed to srv.close() in the listening callback — a later error
+        // is not possible from this server, so the listener stays safely dormant.
+        srv.on('error', reject);
+    });
+}
+/**
+ * Encode a JSON string as a length-prefixed frame.
+ */
+export function encodeFrame(payload) {
+    const body = Buffer.from(payload, 'utf8');
+    if (body.length > MAX_FRAME_BYTES) {
+        throw new Error(`Bridge frame too large: ${body.length} bytes (limit ${MAX_FRAME_BYTES})`);
+    }
+    const frame = Buffer.allocUnsafe(FRAME_HEADER_BYTES + body.length);
+    frame.writeUInt32BE(body.length, 0);
+    body.copy(frame, FRAME_HEADER_BYTES);
+    return frame;
+}
+/**
+ * Pull as many complete frames as possible from a streaming buffer. Any
+ * partial frame at the tail is returned as `remainder` for the next call.
+ *
+ * Throws if a header advertises a payload larger than {@link MAX_FRAME_BYTES} —
+ * the caller should treat this as a fatal protocol error and close the socket.
+ */
+export function parseFrames(buffer) {
+    const frames = [];
+    let offset = 0;
+    while (buffer.length - offset >= FRAME_HEADER_BYTES) {
+        const len = buffer.readUInt32BE(offset);
+        if (len > MAX_FRAME_BYTES) {
+            throw new Error(`Bridge frame header advertises ${len} bytes, exceeds limit ${MAX_FRAME_BYTES}`);
+        }
+        const frameStart = offset + FRAME_HEADER_BYTES;
+        const frameEnd = frameStart + len;
+        if (buffer.length < frameEnd)
+            break;
+        frames.push(buffer.subarray(frameStart, frameEnd));
+        offset = frameEnd;
+    }
+    const remainder = offset === 0 ? buffer : buffer.subarray(offset);
+    return { frames, remainder };
+}
+//# sourceMappingURL=bridge-protocol.js.map

package/dist/utils/bridge-protocol.js.map

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

package/dist/utils/godot-runner.d.ts

@@ -1,4 +1,13 @@
 import type { ChildProcess } from 'child_process';
+/**
+ * Thrown when the bridge socket closes (Godot exited, port closed, or peer
+ * dropped the connection mid-flight). Lets callers distinguish
+ * "session ended" from generic transport errors.
+ */
+export declare class BridgeDisconnectedError extends Error {
+    constructor(message: string);
+}
+export declare const BRIDGE_WAIT_SPAWNED_TIMEOUT_MS = 8000;
 /**
  * Normalize a path for cross-platform comparison.
  * Folds Windows backslashes to forward slashes and strips trailing slashes,
@@ -14,6 +23,7 @@ export declare function extractJson(output: string): string;
  * Strip Godot banner and debug lines from output, keeping only meaningful content.
  */
 export declare function cleanOutput(output: string): string;
+export declare function cleanStdout(stdout: string): string;
 export interface GodotProcess {
     process: ChildProcess;
     output: string[];
@@ -33,7 +43,6 @@ export interface RuntimeStopResult {
 export interface GodotServerConfig {
     godotPath?: string;
     debugMode?: boolean;
-    strictPathValidation?: boolean;
 }
 export interface OperationParams {
     [key: string]: unknown;
@@ -64,11 +73,63 @@ export interface ToolDefinition {
     };
     annotations?: ToolAnnotations;
 }
-export declare function logDebug(message: string): void;
-export declare function logError(message: string): void;
+export interface ToolResponse {
+    content: Array<{
+        type: string;
+        text?: string;
+        [k: string]: unknown;
+    }>;
+    isError?: boolean;
+    [k: string]: unknown;
+}
+export type ToolHandler = (runner: GodotRunner, args: OperationParams) => Promise<ToolResponse> | ToolResponse;
 export declare function normalizeParameters(params: OperationParams): OperationParams;
 export declare function convertCamelToSnakeCase(params: OperationParams): OperationParams;
+/**
+ * Check whether a display server (X11 / Wayland) is available on the current
+ * platform.  On macOS and Windows the display subsystem is always present;
+ * on Linux we probe the standard environment variables.
+ */
+export declare function checkDisplayAvailable(): boolean;
 export declare function validatePath(path: string): boolean;
+/**
+ * Stricter check for paths that must stay inside `projectPath`. Rejects `..`
+ * (via `validatePath`) and absolute paths that escape the project root.
+ * `path.join('/project', '/etc/passwd')` resolves to `/etc/passwd`, so the
+ * basic `..`-substring check alone permits absolute-path traversal.
+ *
+ * Tolerates a leading `res://` (Godot's project-root URI) by stripping it
+ * before resolving — autoload entries and resource paths use this prefix.
+ */
+export declare function validateSubPath(projectPath: string, userPath: string): boolean;
+/**
+ * Validate a Godot scene-tree path (NodePath). Scene-tree paths are a
+ * separate namespace from filesystem paths — they address nodes inside
+ * a scene, not files on disk, so the project-root containment check
+ * in `validateSubPath` does not apply.
+ *
+ * Rejects empty strings and `..` segments. Accepts both relative
+ * (`root/Player`) and absolute (`/root/Player`) Godot forms; the
+ * codebase convention is the relative form.
+ */
+export declare function validateNodePath(path: string): boolean;
+/**
+ * True when `child` resolves to `parent` or a path beneath it. Used by
+ * defense-in-depth checks on bridge-returned paths (e.g. screenshot files
+ * that must live under `.mcp/screenshots/`).
+ */
+export declare function isUnderDir(parent: string, child: string): boolean;
+/**
+ * Return `error.message` when `error` is an `Error`, otherwise `'Unknown error'`.
+ * Centralizes the catch-block boilerplate so handlers can build error responses
+ * without repeating the `instanceof Error` ternary.
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Build the absolute path to a project's `project.godot` manifest. Use this
+ * instead of `join(dir, 'project.godot')` ad hoc.
+ */
+export declare function projectGodotPath(projectDir: string): string;
 /**
  * Extract the first [ERROR] message from GDScript stderr output.
  * Falls back to a generic message if no [ERROR] line is found.
@@ -96,44 +157,69 @@ export declare function validateSceneArgs(args: OperationParams, opts?: {
 export declare class GodotRunner {
     private godotPath;
     private operationsScriptPath;
-    private bridgeScriptPath;
+    private bridge;
     private validatedPaths;
-    private injectedProjects;
-    private strictPathValidation;
+    private cachedVersion;
     activeProcess: GodotProcess | null;
     activeProjectPath: string | null;
     activeSessionMode: RuntimeSessionMode | null;
+    activeBridgePort: number | null;
+    private socket;
+    private rxChunks;
+    private rxTotal;
+    private inFlight;
     constructor(config?: GodotServerConfig);
     private isValidGodotPathSync;
     private spawnAsync;
     private isValidGodotPath;
     detectGodotPath(): Promise<void>;
     getGodotPath(): string | null;
+    /**
+     * Read the port currently baked into the project's bridge script. Returns
+     * null if the file is missing or malformed. Thin pass-through to
+     * BridgeManager — used by bridge-wait-timeout race detection.
+     */
+    readBakedBridgePort(projectPath: string): number | null;
     getVersion(): Promise<string>;
-    isGodot44OrLater(version: string): boolean;
     executeOperation(operation: string, params: OperationParams, projectPath: string, timeoutMs?: number): Promise<OperationResult>;
     launchEditor(projectPath: string): ChildProcess;
-    runProject(projectPath: string, scene?: string, background?: boolean): GodotProcess;
-    attachProject(projectPath: string): void;
-    stopProject(): RuntimeStopResult | null;
+    runProject(projectPath: string, scene?: string, background?: boolean, bridgePort?: number): Promise<GodotProcess>;
+    attachProject(projectPath: string, bridgePort?: number): Promise<void>;
+    stopProject(): Promise<RuntimeStopResult | null>;
     hasActiveRuntimeSession(): boolean;
-    private removeAutoloadEntry;
     /**
-     * Idempotent within a session: short-circuits on `injectedProjects` so a
-     * second `attach_project`/`run_project` call does not rewrite `project.godot`.
+     * Send a JSON command to the McpBridge over a long-lived TCP connection.
+     *
+     * MCP serializes tool calls so we hold one in-flight command at a time. The
+     * socket is lazy-connected on first call and persists across commands until
+     * `closeConnection` (or a peer-side close). A close mid-flight rejects with
+     * `BridgeDisconnectedError`; a per-command timeout rejects but does NOT
+     * close the socket — a slow command does not invalidate the session.
      */
-    injectBridgeAutoload(projectPath: string): void;
-    cleanupBridgeAutoload(projectPath: string): void;
-    private repairOrphanedBridge;
     sendCommand(command: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<string>;
+    /**
+     * Tear down the bridge socket. Idempotent. Any in-flight command is
+     * rejected with a session-ended error.
+     */
+    closeConnection(): void;
+    private resetRxBuffer;
     getErrorCount(): number;
     getErrorsSince(marker: number): string[];
     private static readonly SCRIPT_ERROR_PATTERNS;
+    private static readonly RETRYABLE_BRIDGE_COMMANDS;
     extractRuntimeErrors(lines: string[]): string[];
+    private sendCommandWithReconnect;
     sendCommandWithErrors(command: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<{
         response: string;
         runtimeErrors: string[];
     }>;
+    /**
+     * Shared poll loop for `waitForBridge` (spawned) and `waitForBridgeAttached`.
+     * Sends `ping` payloads until the bridge replies with a pong that
+     * `validatePong` accepts, the deadline passes, or `shouldAbort` reports
+     * the spawned process has exited.
+     */
+    private pollBridge;
     waitForBridgeAttached(timeoutMs?: number, intervalMs?: number): Promise<{
         ready: boolean;
         error?: string;

package/dist/utils/godot-runner.d.ts.map

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