godot-cli 0.29.0 → 0.31.0

package/dist/lib/exec.d.ts

@@ -0,0 +1,65 @@
+import type { EnsureResult } from '@baizor/gamedev-cli-core';
+import { type EnsureEditorDeps, type EnsureEditorOptions, type EnsureEditorResult } from './session.js';
+import type { RunToolFailure, RunToolOptions, RunToolResult } from './types.js';
+export declare const SCRIPT_EXECUTE_TOOL = "script-execute";
+/**
+ * Default `script-execute` call timeout. Longer than the server `tool-timeout` the addon passes
+ * (`GodotMcpServerView.ToolTimeoutMs`, parity-tested), so a call the server gives up on returns the server's
+ * timeout error instead of a client abort.
+ */
+export declare const DEFAULT_EXEC_TIMEOUT_MS = 310000;
+/** Injection points for tests. */
+export interface ExecDeps extends EnsureEditorDeps {
+    invoke: (options: RunToolOptions) => Promise<RunToolResult>;
+}
+export interface ExecCodeOptions extends EnsureEditorOptions {
+    code: string;
+    usings?: string[];
+    include?: string[];
+    /** Tool call timeout. Default {@link DEFAULT_EXEC_TIMEOUT_MS}. */
+    timeoutMs?: number;
+    deps?: Partial<ExecDeps>;
+}
+export interface ExecCodeSuccess {
+    kind: 'success';
+    success: true;
+    /** The server that ran the code. */
+    baseUrl: string;
+    /** How the editor was obtained (cli-core EditorSession): `running`, `foreign`, `owned` or `started`. */
+    editor: EnsureResult<string>['source'];
+    /** Parsed `script-execute` response body. */
+    data: unknown;
+}
+export interface ExecCodeFailure {
+    kind: 'failure';
+    success: false;
+    /** {@link ensureEditor}'s reasons, or `tool-failed`: the call failed. */
+    reason: Extract<EnsureEditorResult, {
+        kind: 'failure';
+    }>['reason'] | 'tool-failed';
+    /** The server that was called (`tool-failed` only). */
+    baseUrl?: string;
+    /** The underlying call failure (`tool-failed` only). */
+    toolFailure?: RunToolFailure;
+    message: string;
+    error?: Error;
+}
+export type ExecCodeResult = ExecCodeSuccess | ExecCodeFailure;
+/**
+ * Run C# in the project's editor. A running editor (GUI or headless) is reused and never closed; otherwise one is
+ * started headless (or windowed) on the project's local server that quits by itself after `idleSeconds` without
+ * tool calls, so the next call stays warm.
+ */
+export declare function execCode(options: ExecCodeOptions): Promise<ExecCodeResult>;
+/** Request body for `script-execute`; empty lists are left out. */
+export declare function buildScriptExecuteInput(code: string, usings: string[], include: string[]): Record<string, unknown>;
+/** The tool's own error text when the server reports one (`{ error }` / text content), else the call failure. */
+export declare function toolErrorText(failure: RunToolFailure): string;
+/**
+ * The tool's text output and whether it reported success. RQL tool format (the default): the text content
+ * (`System.Int32: 3`, then `logs:` lines). JSON format: `{ structured: { result: { result, logs } } }`, shown the same way.
+ */
+export declare function readToolResponse(data: unknown): {
+    ok: boolean;
+    text: string;
+};

package/dist/lib/exec.js

@@ -0,0 +1,79 @@
+// Library-safe `execCode`: run C# in a project's Godot editor through `script-execute`, starting a warm headless
+// editor (cli-core EditorSession) when none is running. No console output, no `process.exit`.
+import { runTool } from './run-tool.js';
+import { ensureEditor } from './session.js';
+export const SCRIPT_EXECUTE_TOOL = 'script-execute';
+/**
+ * Default `script-execute` call timeout. Longer than the server `tool-timeout` the addon passes
+ * (`GodotMcpServerView.ToolTimeoutMs`, parity-tested), so a call the server gives up on returns the server's
+ * timeout error instead of a client abort.
+ */
+export const DEFAULT_EXEC_TIMEOUT_MS = 310000;
+/**
+ * Run C# in the project's editor. A running editor (GUI or headless) is reused and never closed; otherwise one is
+ * started headless (or windowed) on the project's local server that quits by itself after `idleSeconds` without
+ * tool calls, so the next call stays warm.
+ */
+export async function execCode(options) {
+    const editor = await ensureEditor(options);
+    if (editor.kind === 'failure')
+        return editor;
+    const { ensured } = editor;
+    options.onStatus?.('Running...');
+    const baseUrl = ensured.ready;
+    const result = await (options.deps?.invoke ?? runTool)({
+        toolName: SCRIPT_EXECUTE_TOOL,
+        url: baseUrl,
+        ...(options.token ? { token: options.token } : {}),
+        input: buildScriptExecuteInput(options.code, options.usings ?? [], options.include ?? []),
+        timeoutMs: options.timeoutMs ?? DEFAULT_EXEC_TIMEOUT_MS,
+    });
+    if (result.kind === 'failure') {
+        return { kind: 'failure', success: false, reason: 'tool-failed', baseUrl, toolFailure: result, message: toolErrorText(result), error: result.error };
+    }
+    return { kind: 'success', success: true, baseUrl, editor: ensured.source, data: result.data };
+}
+/** Request body for `script-execute`; empty lists are left out. */
+export function buildScriptExecuteInput(code, usings, include) {
+    return {
+        csharpCode: code,
+        ...(usings.length > 0 ? { usings } : {}),
+        ...(include.length > 0 ? { include } : {}),
+    };
+}
+/** The tool's own error text when the server reports one (`{ error }` / text content), else the call failure. */
+export function toolErrorText(failure) {
+    const data = failure.data;
+    if (typeof data === 'string' && data.length > 0)
+        return data;
+    if (data && typeof data === 'object' && typeof data.error === 'string')
+        return data.error;
+    return failure.message;
+}
+/**
+ * The tool's text output and whether it reported success. RQL tool format (the default): the text content
+ * (`System.Int32: 3`, then `logs:` lines). JSON format: `{ structured: { result: { result, logs } } }`, shown the same way.
+ */
+export function readToolResponse(data) {
+    if (typeof data === 'string')
+        return { ok: true, text: data };
+    const response = data;
+    const ok = response?.status === undefined || response.status === 'success';
+    const texts = (response?.content ?? []).filter((c) => c?.type === 'text' && typeof c.text === 'string').map((c) => c.text);
+    if (texts.length > 0)
+        return { ok, text: texts.join('\n') };
+    const result = response?.structured?.result;
+    if (result && typeof result === 'object' && 'result' in result) {
+        const member = result.result;
+        // A scalar member carries `value`; an object (Node, Vector3, ...) its `fields` / `props`.
+        const value = member?.value !== undefined ? member.value : member?.fields !== undefined || member?.props !== undefined
+            ? { ...(member.fields !== undefined ? { fields: member.fields } : {}), ...(member.props !== undefined ? { props: member.props } : {}) }
+            : null;
+        let text = member ? `${member.typeName ?? 'object'}: ${typeof value === 'string' ? value : JSON.stringify(value)}` : 'null';
+        if (Array.isArray(result.logs) && result.logs.length > 0)
+            text += '\nlogs:\n' + result.logs.join('\n');
+        return { ok, text };
+    }
+    return { ok, text: data === undefined ? '' : JSON.stringify(data) };
+}
+//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

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

package/dist/lib/session.d.ts

@@ -0,0 +1,79 @@
+import { EditorSession, type EditorSessionOptions, type EngineAdapter, type EnsureResult, type SessionProcessOps } from '@baizor/gamedev-cli-core';
+import type { BuildProjectResult } from './types.js';
+/** The plugin's system tool that saves and quits a CLI-started editor (a windowless one gets no WM_CLOSE). */
+export declare const SESSION_CLOSE_TOOL = "session-close";
+export interface GodotSessionOptions {
+    projectPath: string;
+    /**
+     * The server the editor's plugin connects to and the session probes. Default: the project's local port
+     * (`http://localhost:<derived>`). A non-loopback URL is rejected: headless sessions are local only.
+     * {@link ensureEditor} prefers the server of a verified live CLI editor of the project (its lease).
+     */
+    url?: string;
+    /** Bearer token: the started editor uses it (auth Required) and every probe / call sends it. */
+    token?: string;
+    /** Explicit Godot executable (else GODOT_BIN / PATH / common install locations). */
+    editorPath?: string;
+    /** A started editor quits after this many seconds without tool calls. `0` = never. Default 300. */
+    idleSeconds?: number;
+    /** How long to wait for a started editor's MCP server. Default 300000. */
+    readyTimeoutMs?: number;
+    /** Runs under the session's startup lock right before it starts an editor (the C# build). */
+    beforeLaunch?: EditorSessionOptions<string>['beforeLaunch'];
+    onStatus?: (message: string) => void;
+    /** Tests: OS process primitives. */
+    processOps?: Partial<SessionProcessOps>;
+}
+export interface GodotSession {
+    session: EditorSession<string>;
+    /** The local server URL the session probes and a started editor binds. */
+    url: string;
+}
+/**
+ * Environment of an editor the session starts: Custom mode on the local URL, the plugin starts the local server
+ * (there is no dock button to press in a headless editor), and the token when one is given.
+ */
+export declare function sessionEditorEnv(url: string, token: string | undefined): Record<string, string>;
+/**
+ * The Godot adapter with the CLI's hooks: running-editor detection (its pid, so the session notices when it exits)
+ * and the plugin-side graceful close through the verified lease (its nonce, and the server it was started on;
+ * `url` serves a lease written before cli-core 0.7.1, which has no `serverUrl`).
+ */
+export declare function godotSessionAdapter(url: string, token: string | undefined): EngineAdapter;
+/** Build the session of a Godot project. Throws when `url` is not local. */
+export declare function createGodotSession(options: GodotSessionOptions): GodotSession;
+/** Injection points for tests. */
+export interface EnsureEditorDeps {
+    ensure: (session: EditorSession<string>, mode: 'headless' | 'window') => Promise<EnsureResult<string>>;
+    build: (projectPath: string) => Promise<BuildProjectResult>;
+}
+export interface EnsureEditorOptions extends Omit<GodotSessionOptions, 'beforeLaunch'> {
+    /** Start the editor with a window instead of headless (only when none is running yet). */
+    window?: boolean;
+    /** Build the C# assembly before starting an editor. Default true. */
+    build?: boolean;
+    deps?: Partial<EnsureEditorDeps>;
+}
+export type EnsureEditorResult = {
+    kind: 'success';
+    success: true;
+    godot: GodotSession;
+    ensured: EnsureResult<string>;
+} | {
+    kind: 'failure';
+    success: false;
+    /**
+     * `invalid-options`: e.g. a non-local URL; `build-failed`: the C# build before the start failed;
+     * `launch-failed`: no editor could be started; `not-ready`: its server never answered.
+     */
+    reason: 'invalid-options' | 'build-failed' | 'launch-failed' | 'not-ready';
+    message: string;
+    error?: Error;
+};
+/**
+ * A ready editor of the project (the `exec` / `open --headless` policy): reuse a running one, otherwise build the
+ * C# assembly (Godot does not build it in a headless editor, and a missing assembly disables the addon) and start
+ * ours. The build runs under the session's startup lock, only when this call starts the editor: parallel cold calls
+ * build once and join that editor.
+ */
+export declare function ensureEditor(options: EnsureEditorOptions): Promise<EnsureEditorResult>;

package/dist/lib/session.js

@@ -0,0 +1,168 @@
+// Godot editor sessions on the shared cli-core EditorSession (Code-Exec plan §4.6): reuse any running editor of
+// the project, otherwise start our own (headless by default) connected to the project's LOCAL MCP server, with a
+// lease so only our own editor is ever closed. Library-safe: no console output, no `process.exit`.
+import * as path from 'path';
+import { EditorSession, EditorSessionError, godotAdapter, mcpReadinessProbe, } from '@baizor/gamedev-cli-core';
+import { buildProject } from './build.js';
+import { runSystemTool } from './run-tool.js';
+import { findGodotBinary } from '../utils/godot-editor.js';
+import { findGodotProcess } from '../utils/godot-process.js';
+import { isLocalhostUrl } from '../utils/project-marker.js';
+import { ENV_AUTH_OPTION, ENV_CONNECTION_MODE, ENV_HOST, ENV_START_SERVER, ENV_TOKEN, localProjectUrl, } from '../utils/connection.js';
+/** The plugin's system tool that saves and quits a CLI-started editor (a windowless one gets no WM_CLOSE). */
+export const SESSION_CLOSE_TOOL = 'session-close';
+/** How long to wait for a user's own editor whose local server does not answer yet (it may still be loading). */
+const FOREIGN_READY_TIMEOUT_MS = 60000;
+/** The connection mode of an editor the session starts (a local server), in its env and its lease. */
+const SESSION_CONNECTION_MODE = 'Custom';
+/**
+ * Environment of an editor the session starts: Custom mode on the local URL, the plugin starts the local server
+ * (there is no dock button to press in a headless editor), and the token when one is given.
+ */
+export function sessionEditorEnv(url, token) {
+    return {
+        [ENV_CONNECTION_MODE]: SESSION_CONNECTION_MODE,
+        [ENV_HOST]: url,
+        [ENV_START_SERVER]: 'true',
+        ...(token ? { [ENV_TOKEN]: token, [ENV_AUTH_OPTION]: 'Required' } : {}),
+    };
+}
+/**
+ * The Godot adapter with the CLI's hooks: running-editor detection (its pid, so the session notices when it exits)
+ * and the plugin-side graceful close through the verified lease (its nonce, and the server it was started on;
+ * `url` serves a lease written before cli-core 0.7.1, which has no `serverUrl`).
+ */
+export function godotSessionAdapter(url, token) {
+    return {
+        ...godotAdapter,
+        editor: {
+            ...godotAdapter.editor,
+            findRunningEditor: async (projectRoot) => findGodotProcess(projectRoot)?.pid ?? false,
+            requestClose: async (_pid, _projectRoot, lease) => {
+                if (lease === undefined)
+                    return false;
+                const result = await runSystemTool({
+                    toolName: SESSION_CLOSE_TOOL,
+                    url: lease.serverUrl ?? url,
+                    ...(token ? { token } : {}),
+                    input: { nonce: lease.nonce },
+                    timeoutMs: 15000,
+                });
+                // A refusing tool (wrong nonce, an addon without session-close) answers 200 with status "error".
+                return result.kind === 'success' && result.data?.status !== 'error';
+            },
+        },
+    };
+}
+function normalizeUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+/** Build the session of a Godot project. Throws when `url` is not local. */
+export function createGodotSession(options) {
+    const projectRoot = path.resolve(options.projectPath);
+    const url = normalizeUrl(options.url ?? localProjectUrl(projectRoot));
+    if (!isLocalhostUrl(url)) {
+        throw new Error(`editor sessions connect to a local server only; ${url} is not on this machine`);
+    }
+    const session = new EditorSession({
+        adapter: godotSessionAdapter(url, options.token),
+        projectRoot,
+        probeReady: mcpReadinessProbe({ urls: [url], ...(options.token ? { token: options.token } : {}) }),
+        editorBinary: () => {
+            const binary = findGodotBinary(options.editorPath);
+            if (!binary)
+                throw new Error('no Godot editor binary found (pass --editor-path or set GODOT_BIN)');
+            return binary;
+        },
+        env: sessionEditorEnv(url, options.token),
+        // The resolved, normalised connection the started editor gets (env above), recorded in the lease.
+        serverUrl: url,
+        connectionMode: SESSION_CONNECTION_MODE,
+        // The user's editor without a reachable local server: it may still be loading, but do not wait the full start budget.
+        foreignReadyTimeoutMs: Math.min(options.readyTimeoutMs ?? FOREIGN_READY_TIMEOUT_MS, FOREIGN_READY_TIMEOUT_MS),
+        ...(options.beforeLaunch ? { beforeLaunch: options.beforeLaunch } : {}),
+        ...(options.idleSeconds !== undefined ? { idleSeconds: options.idleSeconds } : {}),
+        ...(options.readyTimeoutMs !== undefined ? { readyTimeoutMs: options.readyTimeoutMs } : {}),
+        ...(options.onStatus ? { onStatus: options.onStatus } : {}),
+        ...(options.processOps ? { processOps: options.processOps } : {}),
+    });
+    return { session, url };
+}
+/** The pre-launch C# build failed (thrown from `beforeLaunch`, which `ensure` propagates unchanged). */
+class BuildFailedError extends Error {
+    constructor(buildError) {
+        super(buildError.message);
+        this.buildError = buildError;
+    }
+}
+/**
+ * A ready editor of the project (the `exec` / `open --headless` policy): reuse a running one, otherwise build the
+ * C# assembly (Godot does not build it in a headless editor, and a missing assembly disables the addon) and start
+ * ours. The build runs under the session's startup lock, only when this call starts the editor: parallel cold calls
+ * build once and join that editor.
+ */
+export async function ensureEditor(options) {
+    const deps = {
+        ensure: (session, mode) => session.ensure({ mode }),
+        build: (projectPath) => buildProject({ projectPath }),
+        ...options.deps,
+    };
+    const fail = (reason, err, hint = '') => {
+        const error = err instanceof Error ? err : new Error(String(err));
+        return { kind: 'failure', success: false, reason, message: error.message + hint, error };
+    };
+    const beforeLaunch = async (projectRoot) => {
+        options.onStatus?.('Building C# assembly...');
+        let built;
+        try {
+            built = await deps.build(projectRoot);
+        }
+        catch (err) {
+            throw new BuildFailedError(err instanceof Error ? err : new Error(String(err)));
+        }
+        if (built.kind === 'failure')
+            throw new BuildFailedError(built.error);
+    };
+    const sessionOptions = { ...options, ...(options.build !== false ? { beforeLaunch } : {}) };
+    let godot;
+    try {
+        godot = createGodotSession(sessionOptions);
+        // Our editor of this project runs: talk to the server it was started on (it may differ from --url /
+        // GODOT_MCP_HOST). Only a lease cli-core verified live counts: a crashed editor's lease may name a port that
+        // another project's editor serves now.
+        const leasedUrl = (await godot.session.ownedSession())?.serverUrl;
+        if (leasedUrl !== undefined && isLocalhostUrl(leasedUrl) && normalizeUrl(leasedUrl) !== godot.url) {
+            godot = createGodotSession({ ...sessionOptions, url: leasedUrl });
+        }
+    }
+    catch (err) {
+        return fail('invalid-options', err);
+    }
+    try {
+        return { kind: 'success', success: true, godot, ensured: await deps.ensure(godot.session, options.window ? 'window' : 'headless') };
+    }
+    catch (err) {
+        if (err instanceof BuildFailedError)
+            return fail('build-failed', err.buildError);
+        const sessionError = err instanceof EditorSessionError ? err : undefined;
+        let hint = '';
+        if (sessionError?.reason === 'not-ready') {
+            if (sessionError.source === 'foreign') {
+                // Core's message says what is wrong; add only how to fix it in Godot.
+                hint = ` (Godot: in that editor's AI Game Developer dock choose Custom mode and start the server on ${godot.url})`;
+            }
+            else if (sessionError.source === 'started') {
+                // The editor this call started never answered (e.g. the addon failed to load): it would never idle out.
+                const closed = await godot.session.closeOwned({ timeoutMs: 5000, force: true });
+                hint = closed.kind === 'closed' ? ` (stopped the unresponsive editor, PID ${closed.pid}; see its log)` : '';
+            }
+            else {
+                // Another call's editor: that call may still be waiting for it, so it is not stopped here.
+                hint = ' (an editor started by another godot-cli call; `godot-cli close --owned-only --force` stops it)';
+            }
+        }
+        const notReady = sessionError?.reason === 'exited' || sessionError?.reason === 'not-ready';
+        return fail(notReady ? 'not-ready' : 'launch-failed', err, hint);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/lib/session.js.map

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

package/dist/lib.d.ts

@@ -1,4 +1,8 @@
 export { openProject } from './lib/open.js';
+export { execCode, readToolResponse, buildScriptExecuteInput, SCRIPT_EXECUTE_TOOL } from './lib/exec.js';
+export type { ExecCodeOptions, ExecCodeResult, ExecCodeSuccess, ExecCodeFailure } from './lib/exec.js';
+export { createGodotSession, ensureEditor, SESSION_CLOSE_TOOL } from './lib/session.js';
+export type { GodotSession, GodotSessionOptions, EnsureEditorOptions, EnsureEditorResult } from './lib/session.js';
 export { buildProject } from './lib/build.js';
 export { createProject } from './lib/create-project.js';
 export { runTool, runSystemTool } from './lib/run-tool.js';

package/dist/lib.js

@@ -13,6 +13,8 @@
 // Consumers: `import { openProject } from 'godot-cli'` (maps to this file
 // via the `exports` field in package.json).
 export { openProject } from './lib/open.js';
+export { execCode, readToolResponse, buildScriptExecuteInput, SCRIPT_EXECUTE_TOOL } from './lib/exec.js';
+export { createGodotSession, ensureEditor, SESSION_CLOSE_TOOL } from './lib/session.js';
 export { buildProject } from './lib/build.js';
 export { createProject } from './lib/create-project.js';
 export { runTool, runSystemTool } from './lib/run-tool.js';

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,eAAe;AACf,+EAA+E;AAC/E,wDAAwD;AACxD,oDAAoD;AACpD,yEAAyE;AACzE,4DAA4D;AAC5D,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,0FAA0F;AAC1F,yFAAyF;AACzF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,eAAe;AACf,+EAA+E;AAC/E,wDAAwD;AACxD,oDAAoD;AACpD,yEAAyE;AACzE,4DAA4D;AAC5D,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzG,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,0FAA0F;AAC1F,yFAAyF;AACzF,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/utils/addon-deps.d.ts

@@ -4,7 +4,18 @@ export interface AddonPackageReference {
     id: string;
     /** The pinned version (the `Version=` attribute). */
     version: string;
+    /**
+     * Only editor (`#if TOOLS`) code uses the package: it is written with `EDITOR_ONLY_CONDITION`, so Godot's
+     * export builds leave it out (an exported game ships no RQL / Roslyn).
+     */
+    editorOnly?: boolean;
 }
+/**
+ * The MSBuild condition of an editor-only `<PackageReference>`: every configuration except Godot's two export
+ * builds (`ExportDebug` / `ExportRelease`, the ones without `TOOLS`). The Godot SDK applies the same rule to
+ * GodotSharpEditor. Godot-MCP.csproj marks its editor-only packages with this exact attribute.
+ */
+export declare const EDITOR_ONLY_CONDITION = "'$(Configuration)' != 'ExportDebug' and '$(Configuration)' != 'ExportRelease'";
 /**
  * A single `<EmbeddedResource>` the consumer csproj must declare so an asset the
  * addon reads at editor runtime via `GetManifestResourceStream` is embedded into
@@ -21,7 +32,7 @@ export interface AddonEmbeddedResource {
 /**
  * The NuGet `PackageReference`s the addon of THIS CLI's version needs (fallback when
  * the installed addon carries no `nuget-deps.json`), mirroring `Godot-MCP.csproj`.
- * Order matches the addon csproj (ReflectorNet, McpPlugin, then Rql).
+ * Order matches the addon csproj (ReflectorNet, McpPlugin, Rql, then Code-Exec and its Roslyn).
  */
 export declare const ADDON_PACKAGE_REFERENCES: readonly AddonPackageReference[];
 /**

package/dist/utils/addon-deps.js

@@ -9,21 +9,33 @@
 // addon zips that predate that manifest. They mirror the addon's own reused pins in
 // `Godot-MCP.csproj` (`com.IvanMurzak.ReflectorNet`, `com.IvanMurzak.McpPlugin`) at
 // this CLI's version — the SAME values, never a bump of those pins. `com.IvanMurzak.Rql` (the RQL data layer of
-// the editor tools, PolyForm Shield 1.0.0) is a direct dependency of the addon sources since 1.0. A parity test
+// the editor tools, PolyForm Shield 1.0.0) is a direct dependency of the addon sources since 1.0; Code-Exec
+// (`com.IvanMurzak.CodeExec` + the source-only `.Roslyn` adapter, compiled against the pinned
+// `Microsoft.CodeAnalysis.CSharp`) runs `script-execute`. Those four are `editorOnly`: only `#if TOOLS` code
+// uses them, so exported games ship neither RQL nor Roslyn. A parity test
 // (`cli/tests/addon-deps-parity.test.ts`) reads `Godot-MCP.csproj` and FAILS the
 // build if these constants ever drift from the addon's pins, so the scaffold can
 // never silently install a mismatched version.
 //
 // No top-level side effects; pure data + pure string transforms only.
+/**
+ * The MSBuild condition of an editor-only `<PackageReference>`: every configuration except Godot's two export
+ * builds (`ExportDebug` / `ExportRelease`, the ones without `TOOLS`). The Godot SDK applies the same rule to
+ * GodotSharpEditor. Godot-MCP.csproj marks its editor-only packages with this exact attribute.
+ */
+export const EDITOR_ONLY_CONDITION = "'$(Configuration)' != 'ExportDebug' and '$(Configuration)' != 'ExportRelease'";
 /**
  * The NuGet `PackageReference`s the addon of THIS CLI's version needs (fallback when
  * the installed addon carries no `nuget-deps.json`), mirroring `Godot-MCP.csproj`.
- * Order matches the addon csproj (ReflectorNet, McpPlugin, then Rql).
+ * Order matches the addon csproj (ReflectorNet, McpPlugin, Rql, then Code-Exec and its Roslyn).
  */
 export const ADDON_PACKAGE_REFERENCES = [
     { id: 'com.IvanMurzak.ReflectorNet', version: '5.4.3' },
-    { id: 'com.IvanMurzak.McpPlugin', version: '8.9.0' },
-    { id: 'com.IvanMurzak.Rql', version: '0.1.1' },
+    { id: 'com.IvanMurzak.McpPlugin', version: '8.11.0' },
+    { id: 'com.IvanMurzak.Rql', version: '0.1.1', editorOnly: true },
+    { id: 'com.IvanMurzak.CodeExec', version: '0.2.1', editorOnly: true },
+    { id: 'com.IvanMurzak.CodeExec.Roslyn', version: '0.2.1', editorOnly: true },
+    { id: 'Microsoft.CodeAnalysis.CSharp', version: '4.12.0', editorOnly: true },
 ];
 /**
  * The exact `<EmbeddedResource>`s the consumer's project `.csproj` needs, single-sourced

package/dist/utils/addon-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"addon-deps.js","sourceRoot":"","sources":["../../src/utils/addon-deps.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,oEAAoE;AACpE,6BAA6B;AAC7B,EAAE;AACF,gFAAgF;AAChF,0EAA0E;AAC1E,mFAAmF;AACnF,oFAAoF;AACpF,oFAAoF;AACpF,gHAAgH;AAChH,gHAAgH;AAChH,iFAAiF;AACjF,iFAAiF;AACjF,+CAA+C;AAC/C,EAAE;AACF,sEAAsE;AAwBtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,EAAE,EAAE,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;IACvD,EAAE,EAAE,EAAE,0BAA0B,EAAE,OAAO,EAAE,OAAO,EAAE;IACpD,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE;CACtC,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE;QACE,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,mCAAmC;KACjD;CACO,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC,CAAC"}
+{"version":3,"file":"addon-deps.js","sourceRoot":"","sources":["../../src/utils/addon-deps.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,oEAAoE;AACpE,6BAA6B;AAC7B,EAAE;AACF,gFAAgF;AAChF,0EAA0E;AAC1E,mFAAmF;AACnF,oFAAoF;AACpF,oFAAoF;AACpF,gHAAgH;AAChH,4GAA4G;AAC5G,8FAA8F;AAC9F,6GAA6G;AAC7G,0EAA0E;AAC1E,iFAAiF;AACjF,iFAAiF;AACjF,+CAA+C;AAC/C,EAAE;AACF,sEAAsE;AAetE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,+EAA+E,CAAC;AAgBrH;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,EAAE,EAAE,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE;IACvD,EAAE,EAAE,EAAE,0BAA0B,EAAE,OAAO,EAAE,QAAQ,EAAE;IACrD,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IAChE,EAAE,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IACrE,EAAE,EAAE,EAAE,gCAAgC,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE;IAC5E,EAAE,EAAE,EAAE,+BAA+B,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;CACpE,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE;QACE,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,mCAAmC;KACjD;CACO,CAAC;AAEX,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC,CAAC"}

package/dist/utils/addon-nuget-deps.d.ts

@@ -7,11 +7,15 @@ export interface ResolvedAddonNugetDeps {
     file?: string;
     warnings: string[];
 }
-/** Every `<PackageReference Include=".." Version="..">` in a csproj text, in document order. */
+/**
+ * Every `<PackageReference Include=".." Version="..">` in a csproj text, in document order. A reference whose
+ * `Condition` is `EDITOR_ONLY_CONDITION` is editor-only.
+ */
 export declare function parseCsprojPackageReferences(csprojText: string): AddonPackageReference[];
 /**
- * Parse a `nuget-deps.json` manifest (`{ "packageReferences": [{ "id", "version" }] }`).
- * Throws on malformed JSON, a missing/empty list, or an invalid entry.
+ * Parse a `nuget-deps.json` manifest (`{ "packageReferences": [{ "id", "version", "editorOnly"? }] }`).
+ * Manifests that predate `editorOnly` mark nothing editor-only, which those addons need (their RQL sources
+ * compile into export builds). Throws on malformed JSON, a missing/empty list, or an invalid entry.
  */
 export declare function parseAddonNugetDeps(text: string): AddonPackageReference[];
 /**

package/dist/utils/addon-nuget-deps.js

@@ -1,6 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { ADDON_PACKAGE_REFERENCES } from './addon-deps.js';
+import { ADDON_PACKAGE_REFERENCES, EDITOR_ONLY_CONDITION } from './addon-deps.js';
 // Resolve the NuGet PackageReferences the INSTALLED addon needs, so `install-plugin`
 // pins the consumer csproj to what that addon release was built against — not to the
 // constants baked into this CLI build (they differ whenever the addon version differs
@@ -22,24 +22,28 @@ const ADDON_CSPROJ_FILE = 'Godot-MCP.csproj';
 // NuGet-shaped ids and versions are accepted (no quotes, `<`, `&`, whitespace).
 const NUGET_ID_RE = /^[A-Za-z0-9_][A-Za-z0-9_.-]*$/;
 const NUGET_VERSION_RE = /^[0-9A-Za-z][0-9A-Za-z.+-]*$/;
-function validRef(id, version) {
+function validRef(id, version, editorOnly) {
     return typeof id === 'string' && typeof version === 'string' && NUGET_ID_RE.test(id) && NUGET_VERSION_RE.test(version)
-        ? { id, version }
+        ? { id, version, ...(editorOnly && { editorOnly }) }
         : null;
 }
-/** Every `<PackageReference Include=".." Version="..">` in a csproj text, in document order. */
+/**
+ * Every `<PackageReference Include=".." Version="..">` in a csproj text, in document order. A reference whose
+ * `Condition` is `EDITOR_ONLY_CONDITION` is editor-only.
+ */
 export function parseCsprojPackageReferences(csprojText) {
     const refs = [];
     for (const element of csprojText.match(/<PackageReference\b[^>]*>/gi) ?? []) {
-        const ref = validRef(/\bInclude\s*=\s*"([^"]+)"/i.exec(element)?.[1], /\bVersion\s*=\s*"([^"]+)"/i.exec(element)?.[1]);
+        const ref = validRef(/\bInclude\s*=\s*"([^"]+)"/i.exec(element)?.[1], /\bVersion\s*=\s*"([^"]+)"/i.exec(element)?.[1], /\bCondition\s*=\s*"([^"]*)"/i.exec(element)?.[1] === EDITOR_ONLY_CONDITION);
         if (ref !== null)
             refs.push(ref);
     }
     return refs;
 }
 /**
- * Parse a `nuget-deps.json` manifest (`{ "packageReferences": [{ "id", "version" }] }`).
- * Throws on malformed JSON, a missing/empty list, or an invalid entry.
+ * Parse a `nuget-deps.json` manifest (`{ "packageReferences": [{ "id", "version", "editorOnly"? }] }`).
+ * Manifests that predate `editorOnly` mark nothing editor-only, which those addons need (their RQL sources
+ * compile into export builds). Throws on malformed JSON, a missing/empty list, or an invalid entry.
  */
 export function parseAddonNugetDeps(text) {
     const parsed = JSON.parse(text);
@@ -49,7 +53,7 @@ export function parseAddonNugetDeps(text) {
     }
     return list.map((entry, i) => {
         const e = entry;
-        const ref = validRef(e?.id, e?.version);
+        const ref = validRef(e?.id, e?.version, e?.editorOnly === true);
         if (ref === null)
             throw new Error(`packageReferences[${i}] is not a valid { id, version } pair`);
         return ref;

package/dist/utils/addon-nuget-deps.js.map

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