godot-cli 0.38.0 → 0.39.0

package/dist/lib/check.js

@@ -0,0 +1,191 @@
+// `checkProject`: a CI gate without a running editor. Four separate processes (a cold single-process
+// `--build-solutions --quit` SIGSEGVs on C# [Tool] plugins, godot #81790 / #100805):
+//   1. `--headless --import`            materialise .godot/ (global class cache)
+//   2. `dotnet build` (C# projects)     compiler errors with file(line,col)
+//   3. `--headless --editor --quit`     the editor boots; the Godot-MCP addon must print its load marker
+//   4. `--headless -s <checker>`        load every GDScript, report parse errors with res://file:line
+// The verdict comes from the logs and markers, never from Godot's exit code. Library-safe.
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildProject, findProjectCsproj } from './build.js';
+import { GODOT_MCP_PLUGIN_PATH, parseEnabledPlugins, projectGodotPath } from '../utils/project-godot.js';
+import { ADDON_LOADED_MARKER, cliMarkerLines, parseGodotLog, parseMsbuildOutput, } from './godot-log.js';
+import { engineRan, headlessFailure, stoppedRun, prepareHeadless, remainingMs, runGodotStep, runImportStep, writeCliScript, } from './headless.js';
+/** Loads every `.gd` under res:// (addons only with --include-addons) and prints one marker per failing file. */
+export const CHECK_SCRIPT = `extends SceneTree
+# Written by godot-cli check. Loads every GDScript and prints a [godot-cli] marker per failure.
+
+const MARK := "[godot-cli] "
+const WARN_PREFIX := "debug/gdscript/warnings/"
+
+func _walk(dir: String, out: Array, include_addons: bool) -> void:
+\tvar d := DirAccess.open(dir)
+\tif d == null:
+\t\treturn
+\td.list_dir_begin()
+\tvar name := d.get_next()
+\twhile name != "":
+\t\tvar p := dir.path_join(name)
+\t\tif name.begins_with("."):
+\t\t\tpass
+\t\telif d.current_is_dir() and FileAccess.file_exists(p.path_join(".gdignore")):
+\t\t\tpass  # Godot skips a folder with a .gdignore
+\t\telif d.current_is_dir():
+\t\t\tif include_addons or p != "res://addons":
+\t\t\t\t_walk(p, out, include_addons)
+\t\telif name.get_extension() == "gd":
+\t\t\tout.append(p)
+\t\tname = d.get_next()
+
+func _load_ok(path: String) -> bool:
+\tvar s = ResourceLoader.load(path, "", ResourceLoader.CACHE_MODE_IGNORE)
+\tif s == null or not (s is Script):
+\t\treturn false
+\t# An @abstract script (4.5+) loads fine but cannot be instantiated.
+\treturn s.can_instantiate() or (s.has_method("is_abstract") and s.is_abstract())
+
+func _init() -> void:
+\tvar args := OS.get_cmdline_user_args()
+\tvar strict := args.has("--strict")
+\tvar files: Array = []
+\t_walk("res://", files, args.has("--include-addons"))
+\tvar clean: Array = []
+\tvar failed := 0
+\tfor f in files:
+\t\tif _load_ok(f):
+\t\t\tclean.append(f)
+\t\telse:
+\t\t\tfailed += 1
+\t\t\tprint(MARK + "script-failed " + f)
+\tvar warned := 0
+\tif strict and clean.size() > 0:
+\t\t# GDScript warnings only show in the script editor: raise the Warn-level ones to Error in memory (never saved).
+\t\tfor prop in ProjectSettings.get_property_list():
+\t\t\tvar n: String = prop["name"]
+\t\t\tif n.begins_with(WARN_PREFIX) and typeof(ProjectSettings.get_setting(n)) == TYPE_INT and ProjectSettings.get_setting(n) == 1:
+\t\t\t\tProjectSettings.set_setting(n, 2)
+\t\tprint(MARK + "warnings-pass")
+\t\tfor f in clean:
+\t\t\tif not _load_ok(f):
+\t\t\t\twarned += 1
+\t\t\t\tprint(MARK + "script-warned " + f)
+\tprint(MARK + "check-done files=%d failed=%d warned=%d" % [files.size(), failed, warned])
+\tquit(1 if failed > 0 else 0)
+`;
+/** True when project.godot enables the Godot-MCP addon. */
+export function isAddonEnabled(projectPath) {
+    try {
+        return parseEnabledPlugins(fs.readFileSync(projectGodotPath(projectPath), 'utf-8')).includes(GODOT_MCP_PLUGIN_PATH)
+            && fs.existsSync(path.join(projectPath, 'addons', 'godot_mcp', 'plugin.cfg'));
+    }
+    catch {
+        return false;
+    }
+}
+export async function checkProject(options) {
+    const prepared = prepareHeadless(options);
+    if (prepared.kind === 'failure')
+        return prepared;
+    const ctx = prepared;
+    const progress = options.onProgress ?? (() => undefined);
+    const diagnostics = [];
+    const engineMessages = [];
+    const addon = { enabled: isAddonEnabled(ctx.projectPath), loaded: null };
+    let gdscript = null;
+    let csharp = null;
+    const report = () => ({ projectPath: ctx.projectPath, steps: ctx.steps, diagnostics, engineMessages, addon, gdscript, csharp });
+    const fail = (failure) => ({ ...failure, ...report() });
+    const collect = (list) => {
+        for (const d of list)
+            (d.source === 'engine' ? engineMessages : diagnostics).push(d);
+    };
+    // 1. Import.
+    progress('Importing the project (godot --headless --import)...');
+    const imported = await runImportStep(ctx);
+    // Informational only: the import runs before the C# build (a fresh checkout's C# plugin fails to load here), and
+    // the GDScript pass below reports every script error again with its line.
+    engineMessages.push(...imported.diagnostics);
+    if (imported.failure && imported.failure.reason !== 'script-errors')
+        return fail(imported.failure);
+    // 2. C# build.
+    let compileFailed = false;
+    if (findProjectCsproj(ctx.projectPath, []) !== null) {
+        progress('Building C# (dotnet build)...');
+        const started = Date.now();
+        const built = await (options.build ?? ((p, timeoutMs) => buildProject({ projectPath: p, timeoutMs })))(ctx.projectPath, remainingMs(ctx));
+        const output = built.kind === 'success' ? built.output ?? '' : built.errorMessage;
+        ctx.steps.push({ name: 'dotnet-build', command: ['dotnet', 'build'], exitCode: built.kind === 'success' ? 0 : 1, timedOut: false, durationMs: Date.now() - started });
+        const compiler = parseMsbuildOutput(output);
+        diagnostics.push(...compiler);
+        compileFailed = built.kind === 'failure';
+        if (compileFailed && !compiler.some((d) => d.severity === 'error')) {
+            diagnostics.push({ severity: 'error', source: 'csharp', message: output.split(/\r?\n/)[0] });
+        }
+        csharp = { built: !compileFailed, skipped: false };
+        if (remainingMs(ctx) <= 0)
+            return fail(headlessFailure('timeout', 'The check timed out during the C# build.'));
+    }
+    else {
+        csharp = { built: false, skipped: true };
+    }
+    // 3. Editor boot (skipped when C# does not compile: every C# script, the addon included, would fail to load).
+    if (!compileFailed) {
+        progress('Booting the editor (godot --headless --editor --quit)...');
+        const editor = await runGodotStep(ctx, 'editor', ['--editor', '--quit']);
+        const editorStopped = stoppedRun(editor, 'The editor boot');
+        if (editorStopped)
+            return fail(editorStopped);
+        if (!engineRan(editor))
+            return fail(headlessFailure('script-errors', `The editor did not start (exit ${editor.exitCode}).`));
+        collect(parseGodotLog(editor.output));
+        if (addon.enabled) {
+            addon.loaded = editor.output.includes(ADDON_LOADED_MARKER);
+            if (!addon.loaded) {
+                diagnostics.push({ severity: 'error', source: 'gdscript', file: GODOT_MCP_PLUGIN_PATH, message: `The Godot-MCP addon did not load (no "${ADDON_LOADED_MARKER}" line in the editor log).` });
+            }
+        }
+    }
+    // 4. GDScript load check.
+    progress('Checking GDScript (godot --headless -s)...');
+    const script = writeCliScript(ctx, 'check.gd', CHECK_SCRIPT);
+    const userArgs = [...(options.strict ? ['--strict'] : []), ...(options.includeAddons ? ['--include-addons'] : [])];
+    const checked = await runGodotStep(ctx, 'gdscript', ['-s', script, ...(userArgs.length > 0 ? ['--', ...userArgs] : [])]);
+    const checkStopped = stoppedRun(checked, 'The GDScript check');
+    if (checkStopped)
+        return fail(checkStopped);
+    const markers = cliMarkerLines(checked.output);
+    const done = markers.map((m) => /^check-done files=(\d+) failed=(\d+) warned=(\d+)/.exec(m)).find((m) => m !== null);
+    if (!engineRan(checked) || !done) {
+        diagnostics.push({ severity: 'error', source: 'gdscript', message: `The GDScript check did not finish (exit ${checked.exitCode}, no check-done marker).` });
+    }
+    else {
+        gdscript = { files: Number(done[1]), failed: Number(done[2]), warned: Number(done[3]) };
+    }
+    // The checker's own frames ("at: _load_ok (res://.godot/godot-cli/check.gd)") never name the failing script.
+    collect(parseGodotLog(checked.output).filter((d) => !d.file?.startsWith('res://.godot/')));
+    for (const marker of markers) {
+        const failed = /^script-failed (\S+)/.exec(marker);
+        if (failed && !diagnostics.some((d) => d.file === failed[1] && d.severity === 'error')) {
+            diagnostics.push({ severity: 'error', source: 'gdscript', file: failed[1], message: 'The script failed to load.' });
+        }
+    }
+    const failing = failingDiagnostics(diagnostics, options.strict === true);
+    const errors = failing.filter((d) => d.severity === 'error');
+    const compileErrors = errors.filter((d) => d.source === 'csharp').length;
+    if (compileErrors > 0)
+        return fail(headlessFailure('compilation-failed', `C# compilation failed with ${compileErrors} error(s).`));
+    if (errors.length > 0)
+        return fail(headlessFailure('script-errors', `${errors.length} script error(s).`));
+    if (failing.length > 0)
+        return fail(headlessFailure('script-errors', `${failing.length} warning(s) (--strict).`));
+    return { kind: 'success', success: true, ...report() };
+}
+/**
+ * The diagnostics that fail a check: every error, plus with `strict` the GDScript warnings and C# compiler (CS)
+ * warnings (package and engine warnings never).
+ */
+export function failingDiagnostics(diagnostics, strict) {
+    return diagnostics.filter((d) => d.severity === 'error'
+        || (strict && (d.source === 'gdscript' || (d.source === 'csharp' && /^CS\d+$/.test(d.code ?? '')))));
+}
+//# sourceMappingURL=check.js.map

package/dist/lib/check.js.map

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

package/dist/lib/cli-guide.d.ts

@@ -0,0 +1,26 @@
+/** RQL recipes: [query, what it does]. */
+export type RqlRecipes = ReadonlyArray<readonly [string, string]>;
+/** A featured command: [name, usage, what it does]. */
+export type CommandRow = readonly [string, string, string];
+/** The CLI's command name. */
+export declare const CLI_NAME = "godot-cli";
+/** The recipes `rql --help` and the skill show; the root help shows the first {@link ROOT_RQL_RECIPES}. */
+export declare const RQL_RECIPES: RqlRecipes;
+/** How many recipes the root help shows. */
+export declare const ROOT_RQL_RECIPES = 7;
+/** The RQL language in two lines (`rql --help`, the skill's RQL reference). */
+export declare const RQL_LANGUAGE: string[];
+/** The editor commands the root help and the skill feature. */
+export declare const EDITOR_COMMANDS: readonly CommandRow[];
+/** The code commands (no editor needed). */
+export declare const CODE_COMMANDS: readonly CommandRow[];
+/** How an editor command gets its editor (the root help's heading). */
+export declare const EDITOR_START = "the first call starts a headless editor and keeps it warm; no open / status needed";
+/** Where the addon lives in a project: absent means `install-plugin` comes first. */
+export declare const PLUGIN_FOLDER = "addons/godot_mcp";
+/**
+ * The rules an agent needs beyond the recipes (the skill's list). Each answers a stumble seen in agent transcripts.
+ * Kept terse: the agent re-reads every byte of the skill on every later turn, and a rule worded as a warning invites
+ * extra checks.
+ */
+export declare const RQL_RULES: string[];

package/dist/lib/cli-guide.js

@@ -0,0 +1,51 @@
+// The one source of the agent-facing usage text: the root --help, `rql --help` and the `godot-cli` agent skill
+// (`setup-skills`) all render from these constants, so the three cannot drift apart.
+// Example names stay neutral (forest, cave, Lamp, Tree, Rock, Enemy): never a name a test or evaluation task uses.
+/** The CLI's command name. */
+export const CLI_NAME = 'godot-cli';
+/** The recipes `rql --help` and the skill show; the root help shows the first {@link ROOT_RQL_RECIPES}. */
+export const RQL_RECIPES = [
+    ['editor | call OpenScene("res://scenes/forest.tscn")', 'open a scene (writes no file): nodes lists the EDITED scene only'],
+    ['editor | call NewScene("res://scenes/cave.tscn", "Node2D", "Cave")', 'create, save and open a scene (path, root class, root name)'],
+    ['editor | call CreateNode("OmniLight3D", {name: "Lamp", position: [1, 3, 0]})', 'a new node under the scene root (meters, Y up)'],
+    ['nodes | where name starts-with "Tree" | select name class Position', 'read'],
+    ['nodes | where name contains "Enemy" | count', 'count'],
+    ['nodes | where name starts-with "Rock" | set Scale = Scale * 1.5', 'change (vectors compute per axis)'],
+    ['editor | call SaveScene()', 'write the edited scene to its .tscn; prints the files written'],
+    ['nodes | where name == "Old" | call Free()', 'delete'],
+    ['godot.resources("StandardMaterial3D") | select path props["albedo_color"]', 'resources of a class'],
+    ['nodes | where name == "Lamp" | set props["light_energy"] = 2', 'a Godot property or exported script variable by name: props["..."]'],
+];
+/** How many recipes the root help shows. */
+export const ROOT_RQL_RECIPES = 7;
+/** The RQL language in two lines (`rql --help`, the skill's RQL reference). */
+export const RQL_LANGUAGE = [
+    'Stages: where, select a b, sort x [desc], first N, count, get <member>, set a = expr, call Method(args).',
+    'Operators: == != < <= > >= and or not, contains, starts-with, ends-with, x in [a, b], $ is Node3D.',
+];
+/** The editor commands the root help and the skill feature. */
+export const EDITOR_COMMANDS = [
+    ['rql', "rql '<query>'", 'read or change scenes, nodes, resources (RQL; recipes below)'],
+    ['exec', "exec '<C#>'", 'C# in the editor'],
+    ['tools', 'tools [name]', "the editor's AI tools, or one in detail; run-tool <name> --input '<json>' calls one"],
+];
+/** The code commands (no editor needed). */
+export const CODE_COMMANDS = [
+    ['check', 'check', 'GDScript and C# errors (file:line), no editor needed'],
+    ['test', 'test', 'run GUT / gdUnit4 tests'],
+];
+/** How an editor command gets its editor (the root help's heading). */
+export const EDITOR_START = 'the first call starts a headless editor and keeps it warm; no open / status needed';
+/** Where the addon lives in a project: absent means `install-plugin` comes first. */
+export const PLUGIN_FOLDER = 'addons/godot_mcp';
+/**
+ * The rules an agent needs beyond the recipes (the skill's list). Each answers a stumble seen in agent transcripts.
+ * Kept terse: the agent re-reads every byte of the skill on every later turn, and a rule worded as a warning invites
+ * extra checks.
+ */
+export const RQL_RULES = [
+    '`nodes` lists only the edited scene (OpenScene first). Scene edits stay unsaved until `SaveScene()`; `NewScene` saves itself.',
+    'The output of `set` / `call` lists each change (old, new) and the files saved: that is the check, no re-read needed.',
+    'A wrong source or member fails with the valid names.',
+];
+//# sourceMappingURL=cli-guide.js.map

package/dist/lib/cli-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-guide.js","sourceRoot":"","sources":["../../src/lib/cli-guide.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,qFAAqF;AACrF,mHAAmH;AAOnH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,2GAA2G;AAC3G,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,CAAC,qDAAqD,EAAE,kEAAkE,CAAC;IAC3H,CAAC,oEAAoE,EAAE,6DAA6D,CAAC;IACrI,CAAC,8EAA8E,EAAE,gDAAgD,CAAC;IAClI,CAAC,oEAAoE,EAAE,MAAM,CAAC;IAC9E,CAAC,6CAA6C,EAAE,OAAO,CAAC;IACxD,CAAC,iEAAiE,EAAE,mCAAmC,CAAC;IACxG,CAAC,2BAA2B,EAAE,+DAA+D,CAAC;IAC9F,CAAC,2CAA2C,EAAE,QAAQ,CAAC;IACvD,CAAC,2EAA2E,EAAE,sBAAsB,CAAC;IACrG,CAAC,8DAA8D,EAAE,oEAAoE,CAAC;CACvI,CAAC;AAEF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,0GAA0G;IAC1G,oGAAoG;CACrG,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAA0B;IACpD,CAAC,KAAK,EAAE,eAAe,EAAE,8DAA8D,CAAC;IACxF,CAAC,MAAM,EAAE,aAAa,EAAE,kBAAkB,CAAC;IAC3C,CAAC,OAAO,EAAE,cAAc,EAAE,qFAAqF,CAAC;CACjH,CAAC;AAEF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,CAAC,OAAO,EAAE,OAAO,EAAE,sDAAsD,CAAC;IAC1E,CAAC,MAAM,EAAE,MAAM,EAAE,yBAAyB,CAAC;CAC5C,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,oFAAoF,CAAC;AAEjH,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,+HAA+H;IAC/H,sHAAsH;IACtH,sDAAsD;CACvD,CAAC"}

package/dist/lib/exec.d.ts

@@ -13,6 +13,11 @@ export interface ExecDeps extends EnsureEditorDeps {
     invoke: (options: RunToolOptions) => Promise<RunToolResult>;
 }
 export interface ExecCodeOptions extends EnsureEditorOptions {
+    /**
+     * Run on this server as is, starting no editor (Cloud mode: the ai-game.dev hub, where only an editor the user
+     * connected answers).
+     */
+    remoteUrl?: string;
     code: string;
     usings?: string[];
     include?: string[];
@@ -37,6 +42,10 @@ export interface ExecCodeFailure {
     reason: Extract<EnsureEditorResult, {
         kind: 'failure';
     }>['reason'] | 'tool-failed';
+    /** {@link ensureEditor}'s session reason, when the editor session failed. */
+    sessionReason?: Extract<EnsureEditorResult, {
+        kind: 'failure';
+    }>['sessionReason'];
     /** The server that was called (`tool-failed` only). */
     baseUrl?: string;
     /** The underlying call failure (`tool-failed` only). */
@@ -53,6 +62,16 @@ export type ExecCodeResult = ExecCodeSuccess | ExecCodeFailure;
 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 text of a tool answer whose content is all text blocks, joined; `undefined` for any other answer (an image, no
+ * content), which keeps its JSON.
+ */
+export declare function toolResponseText(data: unknown): string | undefined;
+/**
+ * A tool answer for the text-mode JSON print: each image or audio block's base64 `data` (a screenshot is megabytes) is
+ * replaced by a note naming its size; everything else is kept. `--format json` / `--raw` keep the data. Pure.
+ */
+export declare function withoutImageData(data: unknown): 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;
 /**

package/dist/lib/exec.js

@@ -15,12 +15,20 @@ export const DEFAULT_EXEC_TIMEOUT_MS = 310000;
  * 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;
+    let baseUrl;
+    let source;
+    if (options.remoteUrl) {
+        baseUrl = options.remoteUrl;
+        source = 'foreign';
+    }
+    else {
+        const editor = await ensureEditor(options);
+        if (editor.kind === 'failure')
+            return editor;
+        baseUrl = editor.ensured.ready;
+        source = editor.ensured.source;
+    }
     options.onStatus?.('Running...');
-    const baseUrl = ensured.ready;
     const result = await (options.deps?.invoke ?? runTool)({
         toolName: SCRIPT_EXECUTE_TOOL,
         url: baseUrl,
@@ -31,7 +39,7 @@ export async function execCode(options) {
     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 };
+    return { kind: 'success', success: true, baseUrl, editor: source, data: result.data };
 }
 /** Request body for `script-execute`; empty lists are left out. */
 export function buildScriptExecuteInput(code, usings, include) {
@@ -41,13 +49,56 @@ export function buildScriptExecuteInput(code, usings, include) {
         ...(include.length > 0 ? { include } : {}),
     };
 }
+/** The text blocks of a tool answer's `content`, and how many blocks it has in all. */
+function textBlocks(data) {
+    const content = data?.content;
+    const blocks = Array.isArray(content) ? content : [];
+    return { texts: blocks.filter((c) => c?.type === 'text' && typeof c.text === 'string').map((c) => c.text), blocks: blocks.length };
+}
+/**
+ * The text of a tool answer whose content is all text blocks, joined; `undefined` for any other answer (an image, no
+ * content), which keeps its JSON.
+ */
+export function toolResponseText(data) {
+    const { texts, blocks } = textBlocks(data);
+    return texts.length > 0 && texts.length === blocks ? texts.join('\n') : undefined;
+}
+/**
+ * A tool answer for the text-mode JSON print: each image or audio block's base64 `data` (a screenshot is megabytes) is
+ * replaced by a note naming its size; everything else is kept. `--format json` / `--raw` keep the data. Pure.
+ */
+export function withoutImageData(data) {
+    const content = data?.content;
+    if (!Array.isArray(content))
+        return data;
+    return {
+        ...data,
+        content: content.map((block) => (block?.type === 'image' || block?.type === 'audio') && typeof block.data === 'string'
+            ? { ...block, data: `<${block.data.length} base64 chars omitted: --format json keeps them>` }
+            : block),
+    };
+}
 /** 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;
+    if (data && typeof data === 'object') {
+        if (typeof data.error === 'string')
+            return data.error;
+        const { texts } = textBlocks(data);
+        if (texts.length > 0)
+            return texts.join('\n');
+        if (typeof data.message === 'string')
+            return data.message;
+        // ASP.NET ProblemDetails (a 400 for bad arguments): the title plus the field errors.
+        if (typeof data.title === 'string') {
+            const fields = data.errors && typeof data.errors === 'object'
+                ? Object.entries(data.errors).map(([k, v]) => `${k}: ${Array.isArray(v) ? v.join(' ') : String(v)}`)
+                : [];
+            return [data.title, typeof data.detail === 'string' ? data.detail : '', ...fields].filter(Boolean).join(' ');
+        }
+    }
     return failure.message;
 }
 /**
@@ -59,7 +110,7 @@ export function readToolResponse(data) {
         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);
+    const { texts } = textBlocks(response);
     if (texts.length > 0)
         return { ok, text: texts.join('\n') };
     const result = response?.structured?.result;
@@ -74,6 +125,6 @@ export function readToolResponse(data) {
             text += '\nlogs:\n' + result.logs.join('\n');
         return { ok, text };
     }
-    return { ok, text: data === undefined ? '' : JSON.stringify(data) };
+    return { ok, text: data === undefined ? '' : JSON.stringify(withoutImageData(data)) };
 }
 //# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

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

package/dist/lib/export-project.d.ts

@@ -0,0 +1,41 @@
+import { type Diagnostic } from './godot-log.js';
+import { type HeadlessBaseOptions, type HeadlessResult, type HeadlessStep } from './headless.js';
+export type ExportMode = 'release' | 'debug' | 'pack';
+export interface ExportOptions extends HeadlessBaseOptions {
+    preset: string;
+    /** Output file (relative to the current directory). */
+    output: string;
+    mode?: ExportMode;
+    /** Tests: the editor's version string (`4.5.1.stable.mono.official.f62fdbde1`). */
+    godotVersion?: string;
+}
+export interface ExportReport {
+    projectPath: string;
+    preset: string;
+    mode: ExportMode;
+    output: string;
+    sizeBytes?: number;
+    templatesDir?: string;
+    steps: HeadlessStep[];
+    diagnostics: Diagnostic[];
+}
+export type ExportResult = HeadlessResult<ExportReport>;
+export interface ExportPreset {
+    name: string;
+    platform: string;
+    customTemplateDebug: string;
+    customTemplateRelease: string;
+}
+/** The `[preset.N]` sections of export_presets.cfg. */
+export declare function readExportPresets(projectPath: string): ExportPreset[];
+/** Export templates folder name for a `--version` string: `4.5.1.stable.mono.official.f62fdbde1` → `4.5.1.stable.mono`. */
+export declare function templatesVersionDir(version: string): string;
+/** Godot's export templates root for this OS (or the self-contained `editor_data` next to the binary). */
+export declare function templatesRoot(binary: string, platform?: NodeJS.Platform): string;
+/**
+ * The editor's version: `--version` (stdout; a GUI build may print nothing to a pipe), else the official file name
+ * (`Godot_v4.5.1-stable_mono_win64.exe` → `4.5.1.stable.mono`).
+ */
+export declare function godotVersion(binary: string, timeoutMs: number): string | undefined;
+export declare function versionFromFileName(name: string): string | undefined;
+export declare function exportProject(options: ExportOptions): Promise<ExportResult>;