godot-cli 0.1.0

package/dist/lib/install-plugin.d.ts

@@ -0,0 +1,22 @@
+import { projectGodotPath as resolveProjectGodotPath } from '../utils/project-godot.js';
+import type { InstallPluginOptions, InstallPluginResult, RemovePluginOptions, RemovePluginResult } from './types.js';
+/**
+ * Enable the `godot_mcp` addon in a project's `project.godot` `[editor_plugins]`
+ * `enabled` array. Library-safe: no stdout noise, no process.exit, no throws
+ * past the public boundary.
+ *
+ * v1 is intentionally minimal — it only flips the project.godot plugin-enable
+ * state. It does NOT copy addon files or patch the consumer `.csproj` with the
+ * NuGet PackageReferences the addon needs (that is the consumer's responsibility
+ * per the addon's install docs); a warning surfaces that requirement.
+ *
+ * Idempotent: enabling an already-enabled plugin returns `changed: false`.
+ */
+export declare function installPlugin(opts: InstallPluginOptions): Promise<InstallPluginResult>;
+/**
+ * Disable the `godot_mcp` addon in a project's `project.godot`
+ * `[editor_plugins]` `enabled` array. Idempotent: disabling an already-absent
+ * plugin returns `changed: false`. Does NOT delete addon files.
+ */
+export declare function removePlugin(opts: RemovePluginOptions): Promise<RemovePluginResult>;
+export { resolveProjectGodotPath };

package/dist/lib/install-plugin.js

@@ -0,0 +1,118 @@
+import * as fs from 'fs';
+import { GODOT_MCP_PLUGIN_PATH, projectGodotPath as resolveProjectGodotPath, togglePluginInText, } from '../utils/project-godot.js';
+import { emitProgress } from './progress.js';
+import { requireGodotProject } from './validation.js';
+/**
+ * Enable the `godot_mcp` addon in a project's `project.godot` `[editor_plugins]`
+ * `enabled` array. Library-safe: no stdout noise, no process.exit, no throws
+ * past the public boundary.
+ *
+ * v1 is intentionally minimal — it only flips the project.godot plugin-enable
+ * state. It does NOT copy addon files or patch the consumer `.csproj` with the
+ * NuGet PackageReferences the addon needs (that is the consumer's responsibility
+ * per the addon's install docs); a warning surfaces that requirement.
+ *
+ * Idempotent: enabling an already-enabled plugin returns `changed: false`.
+ */
+export async function installPlugin(opts) {
+    const warnings = [];
+    try {
+        const validated = requireGodotProject(opts?.godotProjectPath);
+        if (!validated.ok) {
+            return {
+                kind: 'failure',
+                success: false,
+                projectGodotPath: validated.projectGodotPath,
+                warnings,
+                error: validated.error,
+            };
+        }
+        const { projectPath, projectGodotPath } = validated;
+        emitProgress(opts.onProgress, {
+            phase: 'start',
+            message: `Enabling godot_mcp addon for ${projectPath}`,
+        });
+        const text = fs.readFileSync(projectGodotPath, 'utf-8');
+        const result = togglePluginInText(text, true, GODOT_MCP_PLUGIN_PATH);
+        if (result.kind === 'changed') {
+            fs.writeFileSync(projectGodotPath, result.text);
+            emitProgress(opts.onProgress, {
+                phase: 'manifest-patched',
+                message: `Wrote ${projectGodotPath}`,
+                manifestPath: projectGodotPath,
+            });
+        }
+        warnings.push('Ensure the project .csproj declares the com.IvanMurzak.ReflectorNet and com.IvanMurzak.McpPlugin PackageReferences the addon needs (see the addon README).');
+        emitProgress(opts.onProgress, { phase: 'done', message: 'godot_mcp addon enabled.' });
+        return {
+            kind: 'success',
+            success: true,
+            changed: result.kind === 'changed',
+            projectGodotPath,
+            enabledPlugins: result.enabled,
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/**
+ * Disable the `godot_mcp` addon in a project's `project.godot`
+ * `[editor_plugins]` `enabled` array. Idempotent: disabling an already-absent
+ * plugin returns `changed: false`. Does NOT delete addon files.
+ */
+export async function removePlugin(opts) {
+    const warnings = [];
+    try {
+        const validated = requireGodotProject(opts?.godotProjectPath);
+        if (!validated.ok) {
+            return {
+                kind: 'failure',
+                success: false,
+                projectGodotPath: validated.projectGodotPath,
+                warnings,
+                error: validated.error,
+            };
+        }
+        const { projectPath, projectGodotPath } = validated;
+        emitProgress(opts.onProgress, {
+            phase: 'start',
+            message: `Disabling godot_mcp addon for ${projectPath}`,
+        });
+        const text = fs.readFileSync(projectGodotPath, 'utf-8');
+        const result = togglePluginInText(text, false, GODOT_MCP_PLUGIN_PATH);
+        if (result.kind === 'changed') {
+            fs.writeFileSync(projectGodotPath, result.text);
+            emitProgress(opts.onProgress, {
+                phase: 'manifest-patched',
+                message: `Wrote ${projectGodotPath}`,
+                manifestPath: projectGodotPath,
+            });
+        }
+        emitProgress(opts.onProgress, { phase: 'done', message: 'godot_mcp addon disabled.' });
+        return {
+            kind: 'success',
+            success: true,
+            changed: result.kind === 'changed',
+            projectGodotPath,
+            enabledPlugins: result.enabled,
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+export { resolveProjectGodotPath };
+//# sourceMappingURL=install-plugin.js.map

package/dist/lib/install-plugin.js.map

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

package/dist/lib/open.d.ts

@@ -0,0 +1,34 @@
+import type { OpenEnvInputs, OpenProjectOptions, OpenProjectResult } from './types.js';
+/**
+ * Resolve the project path from an explicit option or fall back to the supplied
+ * cwd. Returns an absolute path plus a flag indicating whether the cwd fallback
+ * was used. Pure / no I/O.
+ */
+export declare function resolveProjectPath(optionPath: string | undefined, cwd: string): {
+    projectPath: string;
+    usedCwdFallback: boolean;
+};
+/**
+ * Returns true if `projectPath` looks like a Godot project — i.e. it contains a
+ * `project.godot` file. Pure / no I/O beyond `fs.existsSync`.
+ */
+export declare function isGodotProjectDir(projectPath: string): boolean;
+/**
+ * Build the `GODOT_MCP_*` env-var map propagated to the editor process when
+ * `noConnect !== true`. Pure (returns a fresh object); validates `auth` /
+ * `mode` enums and throws on bad input — the `openProject` boundary catches the
+ * throw and returns it as a `{ kind: 'failure' }` result.
+ *
+ * Exported for tests so the env-var assembly can be exercised without a real
+ * editor launch.
+ */
+export declare function buildOpenEnv(options: OpenEnvInputs): Record<string, string> | undefined;
+/**
+ * Open a Godot project in the Godot editor — the library-callable equivalent of
+ * the `open` CLI command. Library-safe: never calls `process.exit`, never
+ * prints to stdout/stderr, never throws past the public boundary.
+ *
+ * Launches `<godot> --editor --path <project>` with the `GODOT_MCP_*` connection
+ * env vars wired on.
+ */
+export declare function openProject(options: OpenProjectOptions): Promise<OpenProjectResult>;

package/dist/lib/open.js

@@ -0,0 +1,198 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { findGodotBinary, launchEditor } from '../utils/godot-editor.js';
+import { findGodotProcess } from '../utils/godot-process.js';
+import { ENV_AUTH_OPTION, ENV_CLOUD_URL, ENV_CONNECTION_MODE, ENV_HOST, ENV_LOG_LEVEL, ENV_TOKEN, } from '../utils/connection.js';
+import { emitProgress } from './progress.js';
+/**
+ * Resolve the project path from an explicit option or fall back to the supplied
+ * cwd. Returns an absolute path plus a flag indicating whether the cwd fallback
+ * was used. Pure / no I/O.
+ */
+export function resolveProjectPath(optionPath, cwd) {
+    const explicit = optionPath;
+    const resolvedPath = explicit ?? cwd;
+    return {
+        projectPath: path.resolve(resolvedPath),
+        usedCwdFallback: explicit === undefined,
+    };
+}
+/**
+ * Returns true if `projectPath` looks like a Godot project — i.e. it contains a
+ * `project.godot` file. Pure / no I/O beyond `fs.existsSync`.
+ */
+export function isGodotProjectDir(projectPath) {
+    return fs.existsSync(path.join(projectPath, 'project.godot'));
+}
+function isValidAuth(v) {
+    return v === 'None' || v === 'Required';
+}
+function isValidMode(v) {
+    return v === 'Cloud' || v === 'Custom';
+}
+/**
+ * Build the `GODOT_MCP_*` env-var map propagated to the editor process when
+ * `noConnect !== true`. Pure (returns a fresh object); validates `auth` /
+ * `mode` enums and throws on bad input — the `openProject` boundary catches the
+ * throw and returns it as a `{ kind: 'failure' }` result.
+ *
+ * Exported for tests so the env-var assembly can be exercised without a real
+ * editor launch.
+ */
+export function buildOpenEnv(options) {
+    if (options.noConnect === true)
+        return undefined;
+    const env = {};
+    if (options.url !== undefined)
+        env[ENV_HOST] = options.url;
+    if (options.cloudUrl !== undefined)
+        env[ENV_CLOUD_URL] = options.cloudUrl;
+    if (options.token !== undefined)
+        env[ENV_TOKEN] = options.token;
+    if (options.logLevel !== undefined)
+        env[ENV_LOG_LEVEL] = options.logLevel;
+    if (options.auth !== undefined) {
+        if (!isValidAuth(options.auth)) {
+            throw new Error('auth must be "None" or "Required"');
+        }
+        env[ENV_AUTH_OPTION] = options.auth;
+    }
+    if (options.mode !== undefined) {
+        if (!isValidMode(options.mode)) {
+            throw new Error('mode must be "Cloud" or "Custom"');
+        }
+        env[ENV_CONNECTION_MODE] = options.mode;
+    }
+    return Object.keys(env).length > 0 ? env : undefined;
+}
+/**
+ * Open a Godot project in the Godot editor — the library-callable equivalent of
+ * the `open` CLI command. Library-safe: never calls `process.exit`, never
+ * prints to stdout/stderr, never throws past the public boundary.
+ *
+ * Launches `<godot> --editor --path <project>` with the `GODOT_MCP_*` connection
+ * env vars wired on.
+ */
+export async function openProject(options) {
+    const warnings = [];
+    let resolvedProjectPath;
+    let resolvedEditorPath;
+    try {
+        const { projectPath } = resolveProjectPath(options.projectPath, process.cwd());
+        resolvedProjectPath = projectPath;
+        if (!fs.existsSync(projectPath)) {
+            throw new Error(`Project path does not exist: ${projectPath}`);
+        }
+        if (!isGodotProjectDir(projectPath)) {
+            throw new Error(`Not a Godot project (missing project.godot): ${projectPath}`);
+        }
+        emitProgress(options.onProgress, {
+            phase: 'start',
+            message: `Opening Godot project at ${projectPath}`,
+        });
+        // Validate auth/mode BEFORE editor resolution so a typo fails fast.
+        const env = buildOpenEnv(options);
+        // Already-running short-circuit.
+        const existingProcess = findGodotProcess(projectPath);
+        if (existingProcess) {
+            warnings.push(`Godot is already running with this project (PID: ${existingProcess.pid}). Skipping launch.`);
+            emitProgress(options.onProgress, {
+                phase: 'done',
+                message: 'Godot is already running for this project — launch skipped.',
+            });
+            return {
+                kind: 'success',
+                success: true,
+                editorPath: existingProcess.commandLine.split(/\s+/)[0] ?? '',
+                editorPid: existingProcess.pid,
+                projectPath,
+                warnings,
+                alreadyRunning: true,
+            };
+        }
+        // Locate the Godot binary.
+        const editorPath = findGodotBinary(options.editorPath);
+        if (!editorPath) {
+            throw new Error('No Godot editor binary found. Set GODOT_BIN (or GODOT4_BIN), add godot to PATH, or pass --editor-path.');
+        }
+        resolvedEditorPath = editorPath;
+        emitProgress(options.onProgress, {
+            phase: 'editor-resolved',
+            message: `Resolved Godot editor at ${editorPath}`,
+            editorPath,
+        });
+        emitProgress(options.onProgress, {
+            phase: 'connection-details',
+            message: env
+                ? 'MCP connection environment variables prepared'
+                : 'No MCP connection environment variables (--no-connect or no options provided)',
+            projectPath,
+            editorPath,
+            envVars: env ?? {},
+        });
+        emitProgress(options.onProgress, {
+            phase: 'launching-editor',
+            message: 'Launching Godot editor',
+            editorPath,
+            projectPath,
+        });
+        const child = launchEditor(editorPath, projectPath, env, {
+            onSpawn: (pid) => {
+                emitProgress(options.onProgress, {
+                    phase: 'editor-launched',
+                    message: `Launched Godot editor (PID: ${pid ?? 'unknown'})`,
+                    pid,
+                });
+            },
+            onError: (err) => {
+                warnings.push(`Editor spawn reported error: ${err.message}`);
+            },
+        });
+        const pid = await waitForSpawn(child);
+        emitProgress(options.onProgress, { phase: 'done', message: 'Editor launched.' });
+        return {
+            kind: 'success',
+            success: true,
+            editorPath,
+            editorPid: pid,
+            projectPath,
+            warnings,
+        };
+    }
+    catch (err) {
+        const errorObj = err instanceof Error ? err : new Error(String(err));
+        return {
+            kind: 'failure',
+            success: false,
+            projectPath: resolvedProjectPath,
+            editorPath: resolvedEditorPath,
+            warnings,
+            errorMessage: errorObj.message,
+            error: errorObj,
+        };
+    }
+}
+/**
+ * Resolve to the spawned PID once the child process emits its `spawn` event, or
+ * to `undefined` if a short timeout elapses or the process emits `error` first.
+ * Library-safe: never throws, never blocks process exit (the caller detached).
+ */
+function waitForSpawn(child, timeoutMs = 2000) {
+    return new Promise((resolve) => {
+        if (child.pid !== undefined && child.pid !== null) {
+            resolve(child.pid);
+            return;
+        }
+        let settled = false;
+        const finish = (pid) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(pid);
+        };
+        child.once('spawn', () => finish(child.pid ?? undefined));
+        child.once('error', () => finish(undefined));
+        setTimeout(() => finish(child.pid ?? undefined), timeoutMs).unref();
+    });
+}
+//# sourceMappingURL=open.js.map

package/dist/lib/open.js.map

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

package/dist/lib/progress.d.ts

@@ -0,0 +1,7 @@
+import type { ProgressCallback, ProgressEvent } from './types.js';
+/**
+ * Forward a single progress event to the caller's optional callback,
+ * swallowing any exception the callback throws. A broken onProgress handler
+ * must never abort the underlying library operation.
+ */
+export declare function emitProgress(onProgress: ProgressCallback | undefined, event: ProgressEvent): void;

package/dist/lib/progress.js

@@ -0,0 +1,16 @@
+/**
+ * Forward a single progress event to the caller's optional callback,
+ * swallowing any exception the callback throws. A broken onProgress handler
+ * must never abort the underlying library operation.
+ */
+export function emitProgress(onProgress, event) {
+    if (!onProgress)
+        return;
+    try {
+        onProgress(event);
+    }
+    catch {
+        // Intentionally ignored — see doc comment.
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAwC,EAAE,KAAoB;IACzF,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,IAAI,CAAC;QACH,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC"}

package/dist/lib/run-tool.d.ts

@@ -0,0 +1,12 @@
+import type { RunToolOptions, RunToolResult } from './types.js';
+/**
+ * Invoke a regular MCP tool over the Godot plugin's HTTP API.
+ * POSTs to `<url>/api/tools/{name}`. No console output, no `process.exit`;
+ * errors are returned in the `kind: 'failure'` variant.
+ */
+export declare function runTool(opts: RunToolOptions): Promise<RunToolResult>;
+/**
+ * Invoke a system tool (not exposed to MCP clients) over the Godot plugin's
+ * HTTP API. POSTs to `<url>/api/system-tools/{name}`.
+ */
+export declare function runSystemTool(opts: RunToolOptions): Promise<RunToolResult>;

package/dist/lib/run-tool.js

@@ -0,0 +1,192 @@
+// Library-safe `runTool` / `runSystemTool` implementations.
+//
+// Constraints (same contract as the rest of `lib/*.ts`):
+// - No commander, no spinners, no process.exit, no console output.
+// - Errors are returned in `{ kind: 'failure', success: false, ... }`,
+//   never thrown past the public boundary.
+const DEFAULT_TIMEOUT_MS = 60000;
+/**
+ * Invoke a regular MCP tool over the Godot plugin's HTTP API.
+ * POSTs to `<url>/api/tools/{name}`. No console output, no `process.exit`;
+ * errors are returned in the `kind: 'failure'` variant.
+ */
+export async function runTool(opts) {
+    return invokeTool('/api/tools', opts);
+}
+/**
+ * Invoke a system tool (not exposed to MCP clients) over the Godot plugin's
+ * HTTP API. POSTs to `<url>/api/system-tools/{name}`.
+ */
+export async function runSystemTool(opts) {
+    return invokeTool('/api/system-tools', opts);
+}
+async function invokeTool(routePrefix, opts) {
+    const validationFailure = validateOptions(opts);
+    if (validationFailure)
+        return validationFailure;
+    const url = opts.url.replace(/\/$/, '');
+    const token = opts.token;
+    const body = serializeInput(opts.input);
+    if ('error' in body) {
+        return makeFailure({
+            endpoint: '',
+            reason: 'invalid-input',
+            message: body.error.message,
+            error: body.error,
+        });
+    }
+    const endpoint = `${url}${routePrefix}/${encodeURIComponent(opts.toolName)}`;
+    const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    const timeoutMs = typeof opts.timeoutMs === 'number' && opts.timeoutMs > 0 ? opts.timeoutMs : DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const externalAbort = () => controller.abort();
+    if (opts.signal) {
+        if (opts.signal.aborted)
+            controller.abort();
+        else
+            opts.signal.addEventListener('abort', externalAbort, { once: true });
+    }
+    const headers = { 'Content-Type': 'application/json' };
+    if (token)
+        headers['Authorization'] = `Bearer ${token}`;
+    try {
+        const response = await fetchImpl(endpoint, {
+            method: 'POST',
+            headers,
+            body: body.json,
+            signal: controller.signal,
+        });
+        const text = await safeReadText(response);
+        const data = parseJsonOrText(text);
+        if (!response.ok) {
+            return makeFailure({
+                endpoint,
+                reason: 'http-error',
+                httpStatus: response.status,
+                data,
+                message: response.statusText || `HTTP ${response.status}`,
+            });
+        }
+        const success = {
+            kind: 'success',
+            success: true,
+            endpoint,
+            httpStatus: response.status,
+            data,
+        };
+        return success;
+    }
+    catch (err) {
+        return classifyFetchError(err, endpoint, timeoutMs);
+    }
+    finally {
+        clearTimeout(timer);
+        opts.signal?.removeEventListener('abort', externalAbort);
+    }
+}
+function validateOptions(opts) {
+    if (!opts || typeof opts !== 'object') {
+        return makeFailure({
+            endpoint: '',
+            reason: 'invalid-input',
+            message: 'options object is required.',
+        });
+    }
+    if (typeof opts.toolName !== 'string' || opts.toolName.trim().length === 0) {
+        return makeFailure({
+            endpoint: '',
+            reason: 'invalid-input',
+            message: 'toolName is required and must be a non-empty string.',
+        });
+    }
+    const hasUrl = typeof opts.url === 'string' && opts.url.length > 0;
+    if (!hasUrl) {
+        return makeFailure({
+            endpoint: '',
+            reason: 'invalid-input',
+            message: 'url is required (the Godot-MCP server base URL).',
+        });
+    }
+    return null;
+}
+function serializeInput(input) {
+    if (input === undefined || input === null)
+        return { json: '{}' };
+    if (typeof input === 'string') {
+        try {
+            JSON.parse(input);
+            return { json: input };
+        }
+        catch (err) {
+            return {
+                error: new Error(`input string is not valid JSON: ${err instanceof Error ? err.message : String(err)}`),
+            };
+        }
+    }
+    if (typeof input !== 'object') {
+        return {
+            error: new Error('input must be a plain object, JSON string, undefined, or null.'),
+        };
+    }
+    try {
+        return { json: JSON.stringify(input) };
+    }
+    catch (err) {
+        return {
+            error: new Error(`input could not be serialized to JSON: ${err instanceof Error ? err.message : String(err)}`),
+        };
+    }
+}
+async function safeReadText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return '';
+    }
+}
+function parseJsonOrText(text) {
+    if (text.length === 0)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function getCause(err) {
+    if (!(err instanceof Error) || !('cause' in err))
+        return undefined;
+    return err.cause;
+}
+function classifyFetchError(err, endpoint, timeoutMs) {
+    if (err instanceof Error && err.name === 'AbortError') {
+        return makeFailure({
+            endpoint,
+            reason: 'timeout',
+            message: `Tool call timed out after ${timeoutMs}ms.`,
+            error: err,
+        });
+    }
+    const error = err instanceof Error ? err : new Error(String(err));
+    const causeCode = getCause(err)?.code;
+    let reason = 'unknown';
+    if (causeCode === 'ECONNREFUSED')
+        reason = 'connection-refused';
+    else if (causeCode === 'ECONNRESET')
+        reason = 'connection-reset';
+    else if (causeCode === 'ENOTFOUND' || causeCode === 'EAI_AGAIN')
+        reason = 'network-error';
+    return makeFailure({
+        endpoint,
+        reason,
+        message: error.message,
+        error,
+    });
+}
+function makeFailure(fields) {
+    return { kind: 'failure', success: false, ...fields };
+}
+//# sourceMappingURL=run-tool.js.map

package/dist/lib/run-tool.js.map

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

package/dist/lib/setup-mcp.d.ts

@@ -0,0 +1,16 @@
+import { CLOUD_MCP_URL, DEFAULT_CUSTOM_HOST } from '../utils/connection.js';
+import type { SetupMcpOptions, SetupMcpResult } from './types.js';
+/**
+ * Write MCP configuration for the given AI agent so it can talk to a Godot-MCP
+ * server. Library-safe: no stdout noise, no process.exit, no throws past the
+ * public boundary.
+ *
+ * Writes an HTTP server entry pointing at the resolved MCP-client URL. The
+ * Godot config body shape mirrors the addon's `AgentConfigJson` / `AgentConfigPaths`
+ * conventions (`.mcp.json` under `mcpServers` for Claude Code, `.vscode/mcp.json`
+ * under `servers` for VS Code, etc.).
+ */
+export declare function setupMcp(opts: SetupMcpOptions): Promise<SetupMcpResult>;
+/** List every agent id known to `setupMcp`. */
+export declare function listAgentIds(): string[];
+export { CLOUD_MCP_URL, DEFAULT_CUSTOM_HOST };