godot-cli 0.1.0

package/dist/utils/agents.js

@@ -0,0 +1,188 @@
+import chalk from 'chalk';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+// ---------------------------------------------------------------------------
+// Platform helpers
+// ---------------------------------------------------------------------------
+function appData() {
+    return process.env['APPDATA'] ?? path.join(os.homedir(), 'AppData', 'Roaming');
+}
+function home() {
+    return os.homedir();
+}
+function isWindows() {
+    return process.platform === 'win32';
+}
+function isMac() {
+    return process.platform === 'darwin';
+}
+function authHeaders(token, authRequired) {
+    if (authRequired && token) {
+        return { Authorization: `Bearer ${token}` };
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Agent Registry
+// ---------------------------------------------------------------------------
+const MCP_SERVER_NAME = 'ai-game-developer';
+export const agentRegistry = [
+    // ── Claude Code ──────────────────────────────────────────────
+    {
+        id: 'claude-code',
+        name: 'Claude Code',
+        configPathDisplay: '.mcp.json',
+        bodyPath: 'mcpServers',
+        getConfigPath: (p) => path.join(p, '.mcp.json'),
+        getHttpProps: (url, token, authRequired) => ({
+            type: 'http',
+            url,
+            ...(authHeaders(token, authRequired) ? { headers: authHeaders(token, authRequired) } : {}),
+        }),
+        httpRemoveKeys: ['command', 'args'],
+    },
+    // ── Claude Desktop ───────────────────────────────────────────
+    {
+        id: 'claude-desktop',
+        name: 'Claude Desktop',
+        configPathDisplay: '~/Claude/claude_desktop_config.json',
+        bodyPath: 'mcpServers',
+        getConfigPath: () => {
+            if (isWindows()) {
+                return path.join(appData(), 'Claude', 'claude_desktop_config.json');
+            }
+            if (isMac()) {
+                return path.join(home(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+            }
+            return path.join(home(), '.config', 'Claude', 'claude_desktop_config.json');
+        },
+        getHttpProps: (url, token, authRequired) => ({
+            type: 'http',
+            url,
+            ...(authHeaders(token, authRequired) ? { headers: authHeaders(token, authRequired) } : {}),
+        }),
+        httpRemoveKeys: ['command', 'args'],
+    },
+    // ── Cursor ───────────────────────────────────────────────────
+    {
+        id: 'cursor',
+        name: 'Cursor',
+        configPathDisplay: '.cursor/mcp.json',
+        bodyPath: 'mcpServers',
+        getConfigPath: (p) => path.join(p, '.cursor', 'mcp.json'),
+        getHttpProps: (url, token, authRequired) => ({
+            type: 'http',
+            url,
+            ...(authHeaders(token, authRequired) ? { headers: authHeaders(token, authRequired) } : {}),
+        }),
+        httpRemoveKeys: ['command', 'args'],
+    },
+    // ── VS Code (Copilot) ────────────────────────────────────────
+    {
+        id: 'vscode',
+        name: 'Visual Studio Code (Copilot)',
+        configPathDisplay: '.vscode/mcp.json',
+        bodyPath: 'servers',
+        getConfigPath: (p) => path.join(p, '.vscode', 'mcp.json'),
+        getHttpProps: (url, token, authRequired) => ({
+            type: 'http',
+            url,
+            ...(authHeaders(token, authRequired) ? { headers: authHeaders(token, authRequired) } : {}),
+        }),
+        httpRemoveKeys: ['command', 'args'],
+    },
+    // ── Custom (generic mcpServers entry written to a caller path) ─
+    {
+        id: 'custom',
+        name: 'Custom (generic MCP client)',
+        configPathDisplay: 'mcp.json',
+        bodyPath: 'mcpServers',
+        getConfigPath: (p) => path.join(p, 'mcp.json'),
+        getHttpProps: (url, token, authRequired) => ({
+            type: 'http',
+            url,
+            ...(authHeaders(token, authRequired) ? { headers: authHeaders(token, authRequired) } : {}),
+        }),
+        httpRemoveKeys: ['command', 'args'],
+    },
+];
+// ---------------------------------------------------------------------------
+// Lookup helpers
+// ---------------------------------------------------------------------------
+export function getAgentById(id) {
+    return agentRegistry.find((a) => a.id === id);
+}
+export function getAgentIds() {
+    return agentRegistry.map((a) => a.id);
+}
+export function listAgentTable(heading, locationLabel, locationFn) {
+    const sorted = [...agentRegistry].sort((a, b) => a.id.localeCompare(b.id));
+    const colId = 'ID';
+    const colLoc = locationLabel;
+    const wId = Math.max(colId.length, ...sorted.map((a) => a.id.length));
+    const wLoc = Math.max(colLoc.length, ...sorted.map((a) => locationFn(a).length));
+    const sep = chalk.dim;
+    const hBar = (w) => '─'.repeat(w);
+    console.log(`\n${chalk.bold.cyan(heading)}\n`);
+    // Header
+    console.log(sep('  ┌─') + sep(hBar(wId)) + sep('─┬─') + sep(hBar(wLoc)) + sep('─┐'));
+    console.log(sep('  │ ') + chalk.bold.white(colId.padEnd(wId)) + sep(' │ ') + chalk.bold.white(colLoc.padEnd(wLoc)) + sep(' │'));
+    console.log(sep('  ├─') + sep(hBar(wId)) + sep('─┼─') + sep(hBar(wLoc)) + sep('─┤'));
+    // Rows
+    for (const agent of sorted) {
+        const loc = locationFn(agent);
+        console.log(sep('  │ ') + chalk.yellow(agent.id.padEnd(wId)) + sep(' │ ') + chalk.green(loc.padEnd(wLoc)) + sep(' │'));
+    }
+    // Footer
+    console.log(sep('  └─') + sep(hBar(wId)) + sep('─┴─') + sep(hBar(wLoc)) + sep('─┘'));
+    console.log('');
+}
+// ---------------------------------------------------------------------------
+// Config file writing — JSON
+// ---------------------------------------------------------------------------
+export function writeJsonAgentConfig(configPath, bodyPath, serverName, props, removeKeys) {
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    let root = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            root = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            // If the file is malformed, start fresh
+            root = {};
+        }
+        if (!root || typeof root !== 'object' || Array.isArray(root)) {
+            root = {};
+        }
+    }
+    // Navigate/create bodyPath
+    let body = root[bodyPath];
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+        body = {};
+        root[bodyPath] = body;
+    }
+    // Remove deprecated "Godot-MCP" entries
+    delete body['Godot-MCP'];
+    // Get or create the server entry
+    let entry = body[serverName];
+    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+        entry = {};
+    }
+    // Remove stale keys
+    for (const key of removeKeys) {
+        delete entry[key];
+    }
+    // Merge new properties
+    for (const [key, value] of Object.entries(props)) {
+        entry[key] = value;
+    }
+    body[serverName] = entry;
+    root[bodyPath] = body;
+    fs.writeFileSync(configPath, JSON.stringify(root, null, 2) + '\n');
+}
+export { MCP_SERVER_NAME };
+//# sourceMappingURL=agents.js.map

package/dist/utils/agents.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Project-local feature-override config the CLI manages. Godot's plugin
+ * persists its live config in `user://godot-mcp-config.json` (outside the
+ * project tree), which the CLI cannot reliably reach. This file is the CLI's
+ * own in-project surface for declaring which tools/prompts/resources should be
+ * enabled/disabled — a small, explicit, version-controllable override list a
+ * user can commit alongside the project.
+ */
+export declare const CONFIG_RELATIVE_PATH = ".godot-mcp/features.json";
+export interface McpFeature {
+    name: string;
+    enabled: boolean;
+}
+export interface GodotMcpFeaturesConfig {
+    tools?: McpFeature[];
+    prompts?: McpFeature[];
+    resources?: McpFeature[];
+    [key: string]: unknown;
+}
+export declare function getConfigPath(projectPath: string): string;
+/** Create a default (empty) features config. */
+export declare function createDefaultConfig(): GodotMcpFeaturesConfig;
+/** Read the features config from a project. Returns null when absent. */
+export declare function readConfig(projectPath: string): GodotMcpFeaturesConfig | null;
+/** Write the features config, creating the parent directory if needed. */
+export declare function writeConfig(projectPath: string, config: GodotMcpFeaturesConfig): void;
+/** Read the config, creating it with defaults if it does not exist. */
+export declare function getOrCreateConfig(projectPath: string): GodotMcpFeaturesConfig;
+/**
+ * Update a feature group (tools / prompts / resources) in the config.
+ *   - enableNames: set these to enabled=true
+ *   - disableNames: set these to enabled=false
+ *   - enableAll / disableAll: override every feature already present
+ */
+export declare function updateFeatures(config: GodotMcpFeaturesConfig, featureType: 'tools' | 'prompts' | 'resources', options: {
+    enableNames?: string[];
+    disableNames?: string[];
+    enableAll?: boolean;
+    disableAll?: boolean;
+}): void;

package/dist/utils/config.js

@@ -0,0 +1,97 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Project-local feature-override config the CLI manages. Godot's plugin
+ * persists its live config in `user://godot-mcp-config.json` (outside the
+ * project tree), which the CLI cannot reliably reach. This file is the CLI's
+ * own in-project surface for declaring which tools/prompts/resources should be
+ * enabled/disabled — a small, explicit, version-controllable override list a
+ * user can commit alongside the project.
+ */
+export const CONFIG_RELATIVE_PATH = '.godot-mcp/features.json';
+export function getConfigPath(projectPath) {
+    return path.join(projectPath, CONFIG_RELATIVE_PATH);
+}
+/** Create a default (empty) features config. */
+export function createDefaultConfig() {
+    return { tools: [], prompts: [], resources: [] };
+}
+/** Read the features config from a project. Returns null when absent. */
+export function readConfig(projectPath) {
+    const configPath = getConfigPath(projectPath);
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    const json = fs.readFileSync(configPath, 'utf-8');
+    try {
+        return JSON.parse(json);
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new SyntaxError(`Malformed JSON in config file: ${configPath}\n${err.message}`);
+        }
+        throw err;
+    }
+}
+/** Write the features config, creating the parent directory if needed. */
+export function writeConfig(projectPath, config) {
+    const configPath = getConfigPath(projectPath);
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+/** Read the config, creating it with defaults if it does not exist. */
+export function getOrCreateConfig(projectPath) {
+    if (fs.existsSync(getConfigPath(projectPath))) {
+        return readConfig(projectPath);
+    }
+    const config = createDefaultConfig();
+    writeConfig(projectPath, config);
+    return config;
+}
+/**
+ * Update a feature group (tools / prompts / resources) in the config.
+ *   - enableNames: set these to enabled=true
+ *   - disableNames: set these to enabled=false
+ *   - enableAll / disableAll: override every feature already present
+ */
+export function updateFeatures(config, featureType, options) {
+    const rawFeatures = config[featureType];
+    const features = Array.isArray(rawFeatures)
+        ? rawFeatures.filter((f) => typeof f === 'object' && f !== null && typeof f.name === 'string' && typeof f.enabled === 'boolean')
+        : [];
+    if (options.enableAll) {
+        for (const f of features)
+            f.enabled = true;
+        config[featureType] = features;
+        return;
+    }
+    if (options.disableAll) {
+        for (const f of features)
+            f.enabled = false;
+        config[featureType] = features;
+        return;
+    }
+    if (options.enableNames) {
+        for (const name of options.enableNames) {
+            const existing = features.find((f) => f.name === name);
+            if (existing)
+                existing.enabled = true;
+            else
+                features.push({ name, enabled: true });
+        }
+    }
+    if (options.disableNames) {
+        for (const name of options.disableNames) {
+            const existing = features.find((f) => f.name === name);
+            if (existing)
+                existing.enabled = false;
+            else
+                features.push({ name, enabled: false });
+        }
+    }
+    config[featureType] = features;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/connection.d.ts

@@ -0,0 +1,57 @@
+/** Default hosted cloud base URL (GodotMcpConfig.DefaultCloudBaseUrl). */
+export declare const DEFAULT_CLOUD_BASE_URL = "https://ai-game.dev";
+/** The MCP hub path appended to a base host (GodotMcpConfig.CloudHubPath). */
+export declare const MCP_HUB_PATH = "/mcp";
+/** Resolved cloud MCP-client URL (base + /mcp). */
+export declare const CLOUD_MCP_URL = "https://ai-game.dev/mcp";
+/** Default custom-mode host (GodotMcpConfig.DefaultCustomHost). */
+export declare const DEFAULT_CUSTOM_HOST = "http://localhost:8080";
+export declare const ENV_CLOUD_URL = "GODOT_MCP_CLOUD_URL";
+export declare const ENV_HOST = "GODOT_MCP_HOST";
+export declare const ENV_TOKEN = "GODOT_MCP_TOKEN";
+export declare const ENV_CONNECTION_MODE = "GODOT_MCP_CONNECTION_MODE";
+export declare const ENV_AUTH_OPTION = "GODOT_MCP_AUTH_OPTION";
+export declare const ENV_LOG_LEVEL = "GODOT_MCP_LOG_LEVEL";
+export interface ConnectionOptions {
+    path?: string;
+    url?: string;
+    token?: string;
+}
+/**
+ * Returns true if the given directory looks like a Godot project — i.e.
+ * it contains a `project.godot` file. Pure / no I/O beyond `fs.existsSync`.
+ */
+export declare function isGodotProject(dir: string): boolean;
+/**
+ * Resolve the project path from positional arg, --path option, or cwd.
+ */
+export declare function resolveProjectPath(positionalPath: string | undefined, options: ConnectionOptions): string;
+/**
+ * Resolve the project path and validate it is a Godot project.
+ * Skips validation when --url is provided (explicit server override).
+ */
+export declare function resolveAndValidateProjectPath(positionalPath: string | undefined, options: ConnectionOptions): string;
+/**
+ * Resolve the MCP server base URL + auth token for direct-tool-call requests
+ * (the `<base>/api/tools/<name>` HTTP API exposed by a Godot-MCP server).
+ *
+ * URL priority:
+ *   1. --url flag (explicit override)
+ *   2. GODOT_MCP_HOST env (Custom-mode host)
+ *   3. GODOT_MCP_CLOUD_URL env / Cloud mode → cloud base (https://ai-game.dev)
+ *   4. default custom host (http://localhost:8080)
+ *
+ * Token priority:
+ *   1. --token flag (explicit override)
+ *   2. GODOT_MCP_TOKEN env
+ *
+ * Unlike the Unity CLI, there is NO deterministic project-path→port hash:
+ * the Godot plugin is a server-less client whose persisted config lives in
+ * `user://` (outside the project tree), so the CLI cannot read a project-local
+ * config file. Resolution is therefore env-var + cloud-default based, and
+ * `--url` is the authoritative override for a local/self-hosted server.
+ */
+export declare function resolveConnection(_projectPath: string, options: ConnectionOptions): {
+    url: string;
+    token: string | undefined;
+};

package/dist/utils/connection.js

@@ -0,0 +1,129 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { verbose } from './ui.js';
+import * as ui from './ui.js';
+// --- Godot MCP connection constants (mirror addons/godot_mcp GodotMcpConfig). ---
+/** Default hosted cloud base URL (GodotMcpConfig.DefaultCloudBaseUrl). */
+export const DEFAULT_CLOUD_BASE_URL = 'https://ai-game.dev';
+/** The MCP hub path appended to a base host (GodotMcpConfig.CloudHubPath). */
+export const MCP_HUB_PATH = '/mcp';
+/** Resolved cloud MCP-client URL (base + /mcp). */
+export const CLOUD_MCP_URL = `${DEFAULT_CLOUD_BASE_URL}${MCP_HUB_PATH}`;
+/** Default custom-mode host (GodotMcpConfig.DefaultCustomHost). */
+export const DEFAULT_CUSTOM_HOST = 'http://localhost:8080';
+// --- Environment-variable names the addon reads (GodotMcpConfig EnvX consts). ---
+export const ENV_CLOUD_URL = 'GODOT_MCP_CLOUD_URL';
+export const ENV_HOST = 'GODOT_MCP_HOST';
+export const ENV_TOKEN = 'GODOT_MCP_TOKEN';
+export const ENV_CONNECTION_MODE = 'GODOT_MCP_CONNECTION_MODE';
+export const ENV_AUTH_OPTION = 'GODOT_MCP_AUTH_OPTION';
+export const ENV_LOG_LEVEL = 'GODOT_MCP_LOG_LEVEL';
+/**
+ * Returns true if the given directory looks like a Godot project — i.e.
+ * it contains a `project.godot` file. Pure / no I/O beyond `fs.existsSync`.
+ */
+export function isGodotProject(dir) {
+    return fs.existsSync(path.join(dir, 'project.godot'));
+}
+/**
+ * Resolve the project path from positional arg, --path option, or cwd.
+ */
+export function resolveProjectPath(positionalPath, options) {
+    const resolved = path.resolve(positionalPath ?? options.path ?? process.cwd());
+    if ((positionalPath !== undefined || options.path !== undefined) && !fs.existsSync(resolved)) {
+        ui.error(`Project path does not exist: ${resolved}`);
+        process.exit(1);
+    }
+    return resolved;
+}
+/**
+ * Resolve the project path and validate it is a Godot project.
+ * Skips validation when --url is provided (explicit server override).
+ */
+export function resolveAndValidateProjectPath(positionalPath, options) {
+    const resolved = resolveProjectPath(positionalPath, options);
+    // Skip Godot project validation when --url is explicitly provided
+    if (options.url) {
+        return resolved;
+    }
+    if (!isGodotProject(resolved)) {
+        ui.error(`Not a Godot project (missing project.godot): ${resolved}`);
+        ui.info('Provide a Godot project path as an argument, or use --url to connect to a server directly.');
+        process.exit(1);
+    }
+    return resolved;
+}
+/**
+ * Strip a single pair of wrapping double-quotes and surrounding whitespace
+ * from an environment value, mirroring the addon's `GodotMcpConfig.NormalizeEnv`
+ * so `GODOT_MCP_TOKEN="abc"` yields `abc`.
+ */
+function normalizeEnv(raw) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    return trimmed.replace(/^"(.*)"$/, '$1');
+}
+/** True when the configured/env mode is Cloud (case-insensitive, name only). */
+function isCloudMode() {
+    const mode = normalizeEnv(process.env[ENV_CONNECTION_MODE]);
+    return mode !== undefined && mode.toLowerCase() === 'cloud';
+}
+/**
+ * Resolve the MCP server base URL + auth token for direct-tool-call requests
+ * (the `<base>/api/tools/<name>` HTTP API exposed by a Godot-MCP server).
+ *
+ * URL priority:
+ *   1. --url flag (explicit override)
+ *   2. GODOT_MCP_HOST env (Custom-mode host)
+ *   3. GODOT_MCP_CLOUD_URL env / Cloud mode → cloud base (https://ai-game.dev)
+ *   4. default custom host (http://localhost:8080)
+ *
+ * Token priority:
+ *   1. --token flag (explicit override)
+ *   2. GODOT_MCP_TOKEN env
+ *
+ * Unlike the Unity CLI, there is NO deterministic project-path→port hash:
+ * the Godot plugin is a server-less client whose persisted config lives in
+ * `user://` (outside the project tree), so the CLI cannot read a project-local
+ * config file. Resolution is therefore env-var + cloud-default based, and
+ * `--url` is the authoritative override for a local/self-hosted server.
+ */
+export function resolveConnection(_projectPath, options) {
+    let url;
+    if (options.url) {
+        url = options.url.replace(/\/$/, '');
+        verbose(`Using explicit --url: ${url}`);
+    }
+    else {
+        const envHost = normalizeEnv(process.env[ENV_HOST]);
+        const envCloud = normalizeEnv(process.env[ENV_CLOUD_URL]);
+        if (envHost) {
+            url = envHost.replace(/\/$/, '');
+            verbose(`Using ${ENV_HOST}: ${url}`);
+        }
+        else if (envCloud) {
+            url = envCloud.replace(new RegExp(`${MCP_HUB_PATH}$`), '').replace(/\/$/, '');
+            verbose(`Using ${ENV_CLOUD_URL} base: ${url}`);
+        }
+        else if (isCloudMode()) {
+            url = DEFAULT_CLOUD_BASE_URL;
+            verbose(`Using default cloud base URL: ${url}`);
+        }
+        else {
+            url = DEFAULT_CUSTOM_HOST;
+            verbose(`Using default custom host: ${url}`);
+        }
+    }
+    const token = options.token ?? normalizeEnv(process.env[ENV_TOKEN]);
+    if (options.token) {
+        verbose('Using explicit --token');
+    }
+    else if (token) {
+        verbose(`Using ${ENV_TOKEN}`);
+    }
+    return { url, token };
+}
+//# sourceMappingURL=connection.js.map

package/dist/utils/connection.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * Environment variables that, when set, point directly at a Godot editor
+ * binary. Checked before PATH and common install dirs. `GODOT_BIN` is the
+ * conventional name; `GODOT4_BIN` is honored for setups that pin a Godot 4
+ * binary alongside a legacy Godot 3 one.
+ */
+export declare const GODOT_BIN_ENV_VARS: readonly ["GODOT_BIN", "GODOT4_BIN"];
+/**
+ * Resolve the Godot editor binary path.
+ *
+ * Resolution order (first hit wins):
+ *   1. An explicit `editorPath` argument (validated to be an existing file).
+ *   2. `GODOT_BIN` / `GODOT4_BIN` environment variables.
+ *   3. The first matching Godot binary on `PATH`.
+ *   4. Per-OS common install directories (Windows prefers the mono build;
+ *      macOS resolves the `.app/Contents/MacOS` binary; Linux scans common
+ *      extracted-binary locations).
+ *
+ * Returns the absolute path, or `null` when no Godot binary can be located.
+ * Pure / no spawn — exported for unit tests (the `os`/env are injectable via
+ * the running process; tests stub `fs` + env).
+ */
+export declare function findGodotBinary(editorPath?: string, os?: NodeJS.Platform): string | null;
+export interface LaunchEditorCallbacks {
+    /** Fired once the OS reports the child process has spawned. */
+    onSpawn?: (pid: number | undefined) => void;
+    /** Fired if the spawn itself fails (binary missing, permission denied, …). */
+    onError?: (err: Error) => void;
+}
+/**
+ * Spawn the Godot editor binary opening the given project, optionally with
+ * `GODOT_MCP_*` connection environment variables. Mirrors the Unity CLI's
+ * `launchEditor`: spawns detached, with `stdio: 'ignore'`, and `unref()`s so
+ * the parent process can exit without waiting on the editor.
+ *
+ * Godot's editor-open invocation is `--editor --path <project>` (the
+ * `--editor` flag forces the project to open in the editor rather than run).
+ *
+ * Library-safe (no process.exit, no stdout/stderr writes — observability is
+ * the caller's responsibility via the optional callbacks).
+ */
+export declare function launchEditor(editorPath: string, projectPath: string, env?: Record<string, string>, callbacks?: LaunchEditorCallbacks): import('child_process').ChildProcess;