godot-cli 0.1.0

package/dist/lib/setup-mcp.js

@@ -0,0 +1,118 @@
+import * as path from 'path';
+import { CLOUD_MCP_URL, DEFAULT_CUSTOM_HOST, ENV_HOST, ENV_TOKEN, MCP_HUB_PATH, } from '../utils/connection.js';
+import { getAgentById, getAgentIds, writeJsonAgentConfig, MCP_SERVER_NAME, } from '../utils/agents.js';
+import { emitProgress } from './progress.js';
+import { requireExistingPath } from './validation.js';
+/**
+ * Normalize an env-supplied value (trim + strip a single wrapping double-quote
+ * pair), mirroring the addon's `GodotMcpConfig.NormalizeEnv`.
+ */
+function normalizeEnv(raw) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    return trimmed.replace(/^"(.*)"$/, '$1');
+}
+/**
+ * Resolve the MCP-client URL an external AI agent should connect to. This is
+ * the `<host>/mcp` streamable-HTTP endpoint (NOT the plugin's
+ * `<host>/hub/mcp-server` SignalR endpoint), matching the addon's
+ * `GodotMcpConfig.ResolveMcpClientUrl`:
+ *   1. explicit `--url` override (host) → `<host>/mcp`
+ *   2. GODOT_MCP_HOST env (Custom host) → `<host>/mcp`
+ *   3. default cloud MCP URL (https://ai-game.dev/mcp)
+ */
+function resolveMcpClientUrl(optUrl) {
+    const host = optUrl ?? normalizeEnv(process.env[ENV_HOST]);
+    if (!host)
+        return CLOUD_MCP_URL;
+    const trimmed = host.replace(/\/$/, '');
+    if (trimmed.toLowerCase().endsWith(MCP_HUB_PATH))
+        return trimmed;
+    return trimmed + MCP_HUB_PATH;
+}
+/**
+ * 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 async function setupMcp(opts) {
+    const warnings = [];
+    try {
+        if (!opts || typeof opts.agentId !== 'string' || opts.agentId.length === 0) {
+            return {
+                kind: 'failure',
+                success: false,
+                warnings,
+                error: new Error(`agentId is required. Available agent IDs: ${getAgentIds().join(', ')}`),
+            };
+        }
+        const agent = getAgentById(opts.agentId);
+        if (!agent) {
+            return {
+                kind: 'failure',
+                success: false,
+                warnings,
+                error: new Error(`Unknown agent: "${opts.agentId}". Available agent IDs: ${getAgentIds().join(', ')}`),
+            };
+        }
+        // Resolve project path. If supplied it must exist; otherwise fall back to cwd.
+        let projectPath;
+        if (opts.godotProjectPath) {
+            const validated = requireExistingPath(opts.godotProjectPath);
+            if (!validated.ok) {
+                return { kind: 'failure', success: false, warnings, error: validated.error };
+            }
+            projectPath = validated.projectPath;
+        }
+        else {
+            projectPath = path.resolve(process.cwd());
+        }
+        emitProgress(opts.onProgress, {
+            phase: 'start',
+            message: `Configuring ${agent.name} for ${projectPath}`,
+        });
+        const serverUrl = resolveMcpClientUrl(opts.url);
+        const token = opts.token ?? normalizeEnv(process.env[ENV_TOKEN]) ?? '';
+        const authRequired = token.length > 0;
+        const configPath = agent.getConfigPath(projectPath);
+        const props = agent.getHttpProps(serverUrl, token, authRequired);
+        writeJsonAgentConfig(configPath, agent.bodyPath, MCP_SERVER_NAME, props, agent.httpRemoveKeys);
+        emitProgress(opts.onProgress, {
+            phase: 'manifest-patched',
+            message: `Wrote ${configPath}`,
+            manifestPath: configPath,
+        });
+        emitProgress(opts.onProgress, { phase: 'done', message: `${agent.name} configured successfully.` });
+        return {
+            kind: 'success',
+            success: true,
+            agentId: agent.id,
+            configPath,
+            serverUrl,
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/** List every agent id known to `setupMcp`. */
+export function listAgentIds() {
+    return getAgentIds();
+}
+// Re-export the constants so the CLI command can surface the default URL in help.
+export { CLOUD_MCP_URL, DEFAULT_CUSTOM_HOST };
+//# sourceMappingURL=setup-mcp.js.map

package/dist/lib/setup-mcp.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Discriminated union describing every progress event the library can emit to
+ * the optional `onProgress` callback. Consumers narrow on `event.phase`.
+ */
+export type ProgressEvent = {
+    phase: 'start';
+    message: string;
+} | {
+    phase: 'manifest-patched';
+    message: string;
+    manifestPath: string;
+} | {
+    phase: 'editor-resolved';
+    message: string;
+    editorPath: string;
+} | {
+    phase: 'connection-details';
+    message: string;
+    projectPath: string;
+    editorPath: string;
+    envVars: Record<string, string>;
+} | {
+    phase: 'launching-editor';
+    message: string;
+    editorPath: string;
+    projectPath: string;
+} | {
+    phase: 'editor-launched';
+    message: string;
+    pid?: number;
+} | {
+    phase: 'done';
+    message: string;
+};
+export type ProgressCallback = (event: ProgressEvent) => void;
+export type ResultKind = 'success' | 'failure';
+export interface SetupMcpOptions {
+    /** Agent to configure. Use `listAgentIds()` to discover valid values. */
+    agentId: string;
+    /** Optional Godot project path. Defaults to `process.cwd()` if omitted. */
+    godotProjectPath?: string;
+    /** Explicit MCP server URL override (the `<host>/mcp` client endpoint). */
+    url?: string;
+    /** Auth token override. */
+    token?: string;
+    onProgress?: ProgressCallback;
+}
+export interface SetupMcpSuccess {
+    kind: 'success';
+    success: true;
+    agentId: string;
+    configPath: string;
+    serverUrl: string;
+    warnings: string[];
+}
+export interface SetupMcpFailure {
+    kind: 'failure';
+    success: false;
+    warnings: string[];
+    error: Error;
+}
+export type SetupMcpResult = SetupMcpSuccess | SetupMcpFailure;
+/** Auth option propagated to the editor as `GODOT_MCP_AUTH_OPTION`. */
+export type OpenProjectAuthOption = 'None' | 'Required';
+/** Connection mode propagated to the editor as `GODOT_MCP_CONNECTION_MODE`. */
+export type OpenProjectConnectionMode = 'Cloud' | 'Custom';
+export interface OpenProjectOptions {
+    /** Path to the Godot project to open. Defaults to `process.cwd()`. */
+    projectPath?: string;
+    /** Explicit Godot editor executable path (skips resolution). */
+    editorPath?: string;
+    /** If `true`, skip wiring the GODOT_MCP_* env vars onto the editor process. */
+    noConnect?: boolean;
+    /** MCP server host — sets `GODOT_MCP_HOST`. */
+    url?: string;
+    /** Cloud base URL override — sets `GODOT_MCP_CLOUD_URL`. */
+    cloudUrl?: string;
+    /** Auth token — sets `GODOT_MCP_TOKEN`. */
+    token?: string;
+    /** Auth option — sets `GODOT_MCP_AUTH_OPTION`. */
+    auth?: OpenProjectAuthOption;
+    /** Connection mode — sets `GODOT_MCP_CONNECTION_MODE`. */
+    mode?: OpenProjectConnectionMode;
+    /** Log level — sets `GODOT_MCP_LOG_LEVEL`. */
+    logLevel?: string;
+    onProgress?: ProgressCallback;
+}
+export interface OpenProjectSuccess {
+    kind: 'success';
+    success: true;
+    editorPath: string;
+    editorPid?: number;
+    projectPath: string;
+    warnings: string[];
+    /** True when an editor was already running for this project; launch skipped. */
+    alreadyRunning?: boolean;
+}
+export interface OpenProjectFailure {
+    kind: 'failure';
+    success: false;
+    projectPath?: string;
+    editorPath?: string;
+    warnings: string[];
+    errorMessage: string;
+    error: Error;
+}
+export type OpenProjectResult = OpenProjectSuccess | OpenProjectFailure;
+/**
+ * Subset of `OpenProjectOptions` consumed by `buildOpenEnv` — every field here
+ * maps to a `GODOT_MCP_*` environment variable.
+ */
+export interface OpenEnvInputs {
+    noConnect?: OpenProjectOptions['noConnect'];
+    url?: OpenProjectOptions['url'];
+    cloudUrl?: OpenProjectOptions['cloudUrl'];
+    token?: OpenProjectOptions['token'];
+    auth?: OpenProjectOptions['auth'];
+    mode?: OpenProjectOptions['mode'];
+    logLevel?: OpenProjectOptions['logLevel'];
+}
+export type RunToolFailureReason = 'invalid-input' | 'connection-refused' | 'connection-reset' | 'network-error' | 'timeout' | 'http-error' | 'unknown';
+/**
+ * Options accepted by both {@link runTool} and {@link runSystemTool}.
+ *
+ * `url` (the MCP server base URL) MUST be provided — unlike the Unity CLI there
+ * is no deterministic project-path→port fallback, because the Godot plugin is a
+ * server-less client whose persisted config lives in `user://` (outside the
+ * project tree).
+ */
+export interface RunToolOptions {
+    /** Tool name to invoke. URL-encoded into the `{name}` route segment. */
+    toolName: string;
+    /** MCP server base URL (no trailing slash required). REQUIRED. */
+    url?: string;
+    /** Bearer token override. */
+    token?: string;
+    /** Tool arguments serialized as the JSON request body. Defaults to `{}`. */
+    input?: unknown;
+    /** Per-request timeout in milliseconds. Defaults to `60000`. */
+    timeoutMs?: number;
+    /** Optional abort signal. */
+    signal?: AbortSignal;
+    /** Optional fetch injection point for tests. */
+    fetchImpl?: typeof fetch;
+}
+export interface RunToolSuccess {
+    kind: 'success';
+    success: true;
+    endpoint: string;
+    httpStatus: number;
+    data: unknown;
+}
+export interface RunToolFailure {
+    kind: 'failure';
+    success: false;
+    endpoint: string;
+    reason: RunToolFailureReason;
+    httpStatus?: number;
+    data?: unknown;
+    message: string;
+    error?: Error;
+}
+export type RunToolResult = RunToolSuccess | RunToolFailure;
+export type RunSystemToolOptions = RunToolOptions;
+export type RunSystemToolResult = RunToolResult;
+export type RunSystemToolSuccess = RunToolSuccess;
+export type RunSystemToolFailure = RunToolFailure;
+export interface InstallPluginOptions {
+    /** Absolute or relative path to the Godot project root. */
+    godotProjectPath: string;
+    onProgress?: ProgressCallback;
+}
+export interface InstallPluginSuccess {
+    kind: 'success';
+    success: true;
+    /** True when the plugin was newly enabled; false when it was already enabled. */
+    changed: boolean;
+    projectGodotPath: string;
+    enabledPlugins: string[];
+    warnings: string[];
+}
+export interface InstallPluginFailure {
+    kind: 'failure';
+    success: false;
+    projectGodotPath?: string;
+    warnings: string[];
+    error: Error;
+}
+export type InstallPluginResult = InstallPluginSuccess | InstallPluginFailure;
+export interface RemovePluginOptions {
+    godotProjectPath: string;
+    onProgress?: ProgressCallback;
+}
+export interface RemovePluginSuccess {
+    kind: 'success';
+    success: true;
+    /** True when the plugin was disabled; false when it was already absent. */
+    changed: boolean;
+    projectGodotPath: string;
+    enabledPlugins: string[];
+    warnings: string[];
+}
+export interface RemovePluginFailure {
+    kind: 'failure';
+    success: false;
+    projectGodotPath?: string;
+    warnings: string[];
+    error: Error;
+}
+export type RemovePluginResult = RemovePluginSuccess | RemovePluginFailure;

package/dist/lib/types.js

@@ -0,0 +1,8 @@
+// Shared public types for the godot-cli library API.
+//
+// This file is re-exported from `lib.ts` — consumers should import
+// from `godot-cli` (the package root), NOT from deep paths.
+//
+// No top-level side effects, no runtime deps beyond TypeScript types.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,mEAAmE;AACnE,4DAA4D;AAC5D,EAAE;AACF,sEAAsE"}

package/dist/lib/validation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Small, side-effect-free input-validation helpers shared by the
+ * library-facing API functions. Each helper returns a discriminated union so
+ * call sites can pattern-match without throwing across the public boundary.
+ */
+export type ValidatedPath = {
+    ok: true;
+    projectPath: string;
+} | {
+    ok: false;
+    error: Error;
+};
+export type ValidatedGodotProject = {
+    ok: true;
+    projectPath: string;
+    projectGodotPath: string;
+} | {
+    ok: false;
+    projectGodotPath?: string;
+    error: Error;
+};
+/** Require a non-empty string and resolve it to an absolute path. */
+export declare function requireProjectPath(raw: unknown): ValidatedPath;
+/**
+ * Require a non-empty path AND that the path hosts a Godot project (identified
+ * by the presence of `project.godot`).
+ */
+export declare function requireGodotProject(raw: unknown): ValidatedGodotProject;
+/** Require that the given path exists on disk (need not host a project.godot). */
+export declare function requireExistingPath(raw: unknown): ValidatedPath;

package/dist/lib/validation.js

@@ -0,0 +1,44 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/** Require a non-empty string and resolve it to an absolute path. */
+export function requireProjectPath(raw) {
+    if (typeof raw !== 'string' || raw.length === 0) {
+        return {
+            ok: false,
+            error: new Error('godotProjectPath is required and must be a non-empty string.'),
+        };
+    }
+    return { ok: true, projectPath: path.resolve(raw) };
+}
+/**
+ * Require a non-empty path AND that the path hosts a Godot project (identified
+ * by the presence of `project.godot`).
+ */
+export function requireGodotProject(raw) {
+    const outer = requireProjectPath(raw);
+    if (!outer.ok)
+        return outer;
+    const projectGodotPath = path.join(outer.projectPath, 'project.godot');
+    if (!fs.existsSync(projectGodotPath)) {
+        return {
+            ok: false,
+            projectGodotPath,
+            error: new Error(`Not a valid Godot project (missing project.godot): ${outer.projectPath}`),
+        };
+    }
+    return { ok: true, projectPath: outer.projectPath, projectGodotPath };
+}
+/** Require that the given path exists on disk (need not host a project.godot). */
+export function requireExistingPath(raw) {
+    const outer = requireProjectPath(raw);
+    if (!outer.ok)
+        return outer;
+    if (!fs.existsSync(outer.projectPath)) {
+        return {
+            ok: false,
+            error: new Error(`Project path does not exist: ${outer.projectPath}`),
+        };
+    }
+    return outer;
+}
+//# sourceMappingURL=validation.js.map

package/dist/lib/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/lib/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAgB7B,qEAAqE;AACrE,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,IAAI,KAAK,CAAC,8DAA8D,CAAC;SACjF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,gBAAgB;YAChB,KAAK,EAAE,IAAI,KAAK,CAAC,sDAAsD,KAAK,CAAC,WAAW,EAAE,CAAC;SAC5F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,gBAAgB,EAAE,CAAC;AACxE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,IAAI,KAAK,CAAC,gCAAgC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib.d.ts

@@ -0,0 +1,5 @@
+export { openProject } from './lib/open.js';
+export { runTool, runSystemTool } from './lib/run-tool.js';
+export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
+export { installPlugin, removePlugin } from './lib/install-plugin.js';
+export type { ProgressEvent, ProgressCallback, ResultKind, OpenProjectOptions, OpenProjectResult, OpenProjectSuccess, OpenProjectFailure, OpenProjectAuthOption, OpenProjectConnectionMode, RunToolOptions, RunToolResult, RunToolSuccess, RunToolFailure, RunToolFailureReason, RunSystemToolOptions, RunSystemToolResult, RunSystemToolSuccess, RunSystemToolFailure, SetupMcpOptions, SetupMcpResult, SetupMcpSuccess, SetupMcpFailure, InstallPluginOptions, InstallPluginResult, InstallPluginSuccess, InstallPluginFailure, RemovePluginOptions, RemovePluginResult, RemovePluginSuccess, RemovePluginFailure, } from './lib/types.js';

package/dist/lib.js

@@ -0,0 +1,19 @@
+// Library entry point for `godot-cli`.
+//
+// Constraints:
+// - NO top-level side effects. Importing this file must not open sockets, spin
+//   up spinners, write to stdout/stderr, or parse argv.
+// - NO `commander` import reachable from this file.
+// - Every result is a discriminated union keyed on `kind`. Successes are
+//   `{ kind: 'success', success: true, ... }`; failures are
+//   `{ kind: 'failure', success: false, error }`. Errors are never thrown past
+//   the public boundary. Narrow on `kind` for type-safe access.
+// - Progress is surfaced via an optional `onProgress` callback, not globals.
+//
+// Consumers: `import { openProject } from 'godot-cli'` (maps to this file
+// via the `exports` field in package.json).
+export { openProject } from './lib/open.js';
+export { runTool, runSystemTool } from './lib/run-tool.js';
+export { setupMcp, listAgentIds } from './lib/setup-mcp.js';
+export { installPlugin, removePlugin } from './lib/install-plugin.js';
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +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,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/utils/agents.d.ts

@@ -0,0 +1,31 @@
+/**
+ * An AI-agent MCP-client configurator. Mirrors the Godot addon's
+ * `GodotAgentConfigurator` registry (`addons/godot_mcp/UI/Agents/`), adapted
+ * to the CLI's file-writing surface. Each agent knows where its MCP-client
+ * config lives and what HTTP-transport server entry to write.
+ *
+ * Godot is a server-less client: the plugin connects out to a server, and an
+ * external AI client connects to the same server's `<host>/mcp` streamable-HTTP
+ * endpoint. So every configurator here writes an HTTP server entry pointing at
+ * the resolved MCP-client URL (NOT the plugin's `<host>/hub/mcp-server` SignalR
+ * endpoint).
+ */
+export interface AgentDefinition {
+    id: string;
+    name: string;
+    configPathDisplay: string;
+    bodyPath: string;
+    /** Resolve the absolute config-file path for a given project root. */
+    getConfigPath(projectPath: string): string;
+    /** Build the HTTP server entry written under `bodyPath[MCP_SERVER_NAME]`. */
+    getHttpProps(url: string, token: string, authRequired: boolean): Record<string, unknown>;
+    /** Keys to delete from a pre-existing entry before merging new props. */
+    httpRemoveKeys: string[];
+}
+declare const MCP_SERVER_NAME = "ai-game-developer";
+export declare const agentRegistry: readonly AgentDefinition[];
+export declare function getAgentById(id: string): AgentDefinition | undefined;
+export declare function getAgentIds(): string[];
+export declare function listAgentTable(heading: string, locationLabel: string, locationFn: (agent: AgentDefinition) => string): void;
+export declare function writeJsonAgentConfig(configPath: string, bodyPath: string, serverName: string, props: Record<string, unknown>, removeKeys: string[]): void;
+export { MCP_SERVER_NAME };