godot-cli 0.16.2 → 0.17.0

package/dist/commands/configure.js

@@ -4,6 +4,7 @@ import * as path from 'path';
 import * as ui from '../utils/ui.js';
 import { verbose } from '../utils/ui.js';
 import { getOrCreateConfig, writeConfig, updateFeatures, } from '../utils/config.js';
+import { configureAgentViaServer } from '../lib/configure-agent.js';
 function parseCommaSeparated(value) {
     return value.split(',').map((s) => s.trim()).filter(Boolean);
 }
@@ -21,9 +22,11 @@ function snapshotFeatures(config, key) {
         .map((f) => ({ name: f.name, enabled: f.enabled }));
 }
 export const configureCommand = new Command('configure')
-    .description('List / enable / disable MCP tools, prompts, and resources in the project-local .godot-mcp/features.json')
+    .description('Configure an AI agent for the project (--agent <id> proxies to the managed gamedev-mcp-server binary, writing that client\'s MCP config with the derived pin + port), OR list / enable / disable MCP tools, prompts, and resources in the project-local .godot-mcp/features.json')
     .argument('[path]', 'Path to the Godot project')
     .option('--path <path>', 'Path to the Godot project')
+    .option('--agent <id>', 'Configure an AI agent by proxying to the managed gamedev-mcp-server binary (requires install-plugin --with-server)')
+    .option('--url <url>', 'Explicit MCP server URL override forwarded to the server binary (--agent only)')
     .option('--enable-tools <names>', 'Enable specific tools (comma-separated)', parseCommaSeparated)
     .option('--disable-tools <names>', 'Disable specific tools (comma-separated)', parseCommaSeparated)
     .option('--enable-all-tools', 'Enable all tools')
@@ -48,6 +51,26 @@ export const configureCommand = new Command('configure')
         ui.error(`Project path does not exist: ${projectPath}`);
         process.exit(1);
     }
+    // --agent: proxy to the managed gamedev-mcp-server binary's configurator surface.
+    if (options.agent !== undefined) {
+        ui.heading(`Configuring agent "${options.agent}"`);
+        const spinner = ui.startSpinner('Proxying to the managed server binary...');
+        const result = await configureAgentViaServer({
+            godotProjectPath: projectPath,
+            agentId: options.agent,
+            url: options.url,
+        });
+        if (result.kind === 'failure') {
+            spinner.error('Failed to configure agent');
+            ui.error(result.error.message);
+            process.exit(1);
+        }
+        spinner.success(`Configured "${result.agentId}" via ${result.serverBinaryPath}`);
+        if (result.output.trim().length > 0) {
+            console.log(result.output.trimEnd());
+        }
+        return;
+    }
     verbose(`Loading config for project: ${projectPath}`);
     const toolsAction = options.list
         ? undefined

package/dist/commands/configure.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure.js","sourceRoot":"","sources":["../../src/commands/configure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAE5B,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AASD,SAAS,WAAW,CAClB,MAA4B,EAC5B,OAA6B,EAC7B,SAA8B,EAC9B,UAA+B;IAE/B,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACvE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAC/E,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA8B,EAAE,GAAsC;IAC9F,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,GAAG;SACP,MAAM,CACL,CAAC,CAAC,EAAmB,EAAE,CACrB,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS,CACtG;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;KACrD,WAAW,CAAC,yGAAyG,CAAC;KACtH,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAC/C,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAAC;KACpD,MAAM,CAAC,wBAAwB,EAAE,yCAAyC,EAAE,mBAAmB,CAAC;KAChG,MAAM,CAAC,yBAAyB,EAAE,0CAA0C,EAAE,mBAAmB,CAAC;KAClG,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;KAChD,MAAM,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;KAClD,MAAM,CAAC,0BAA0B,EAAE,2CAA2C,EAAE,mBAAmB,CAAC;KACpG,MAAM,CAAC,2BAA2B,EAAE,4CAA4C,EAAE,mBAAmB,CAAC;KACtG,MAAM,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;KACpD,MAAM,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;KACtD,MAAM,CAAC,4BAA4B,EAAE,6CAA6C,EAAE,mBAAmB,CAAC;KACxG,MAAM,CAAC,6BAA6B,EAAE,8CAA8C,EAAE,mBAAmB,CAAC;KAC1G,MAAM,CAAC,wBAAwB,EAAE,sBAAsB,CAAC;KACxD,MAAM,CAAC,yBAAyB,EAAE,uBAAuB,CAAC;KAC1D,MAAM,CAAC,QAAQ,EAAE,4BAA4B,CAAC;KAC9C,MAAM,CACL,KAAK,EACH,cAAkC,EAClC,OAeC,EACD,EAAE;IACF,MAAM,YAAY,GAAG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IACpD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,EAAE,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,EAAE,CAAC,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC;IAEtD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI;QAC9B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5G,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpH,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI;QAClC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CACT,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,kBAAkB,EAC1B,OAAO,CAAC,mBAAmB,CAC5B,CAAC;IAEN,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,CAAC,CAA4B,EAAW,EAAE,CACvD,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;IAEhH,IAAI,MAAM,CAAC,WAAW,CAAC;QAAE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,WAAY,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,aAAa,CAAC;QAAE,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,aAAc,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,eAAe,CAAC;QAAE,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,eAAgB,CAAC,CAAC;IAEnF,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAEpC,MAAM,aAAa,GAAG,CAAC,YAAoB,EAAE,QAAsB,EAAE,EAAE;YACrE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACzB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,EAAE,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;QAEF,aAAa,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,aAAa,CAAC,SAAS,EAAE,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;QAC9D,aAAa,CAAC,WAAW,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,+BAA+B,CAAC,CAAC;IACzC,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;AACpD,CAAC,CACF,CAAC"}
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../../src/commands/configure.ts"],"names":[],"mappings":"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"}

package/dist/commands/install-plugin.js

@@ -1,9 +1,13 @@
 import { Command } from 'commander';
 import { createRequire } from 'module';
+import * as fs from 'fs';
 import * as path from 'path';
 import * as ui from '../utils/ui.js';
 import { verbose } from '../utils/ui.js';
+import { DEFAULT_CLOUD_BASE_URL } from '../utils/connection.js';
 import { installPlugin } from '../lib/install-plugin.js';
+import { installServer } from '../lib/install-server.js';
+import { enrollPlugin } from '../lib/enroll.js';
 /** The CLI's own version — the default addon release version to download. */
 function cliVersion() {
     try {
@@ -15,15 +19,47 @@ function cliVersion() {
         return '';
     }
 }
+/** Read a single enrollment code from stdin (so it never lands in argv / shell history). */
+function readEnrollCodeFromStdin() {
+    let content;
+    try {
+        content = fs.readFileSync(0, 'utf-8');
+    }
+    catch {
+        ui.error('Failed to read the enrollment code from stdin.');
+        process.exit(1);
+    }
+    const code = content.trim();
+    if (code.length === 0) {
+        ui.error('No enrollment code received on stdin.');
+        process.exit(1);
+    }
+    return code;
+}
 export const installPluginCommand = new Command('install-plugin')
-    .description('Install the godot_mcp addon into a Godot C# project: materialize res://addons/godot_mcp/ (download the matching GitHub release, or --source a local copy), add the required NuGet PackageReferences and the extension-catalog <EmbeddedResource> to the project .csproj, and enable the plugin in project.godot.')
+    .description('Install the godot_mcp addon into a Godot C# project: materialize res://addons/godot_mcp/ (download the matching GitHub release, or --source a local copy), add the required NuGet PackageReferences and the extension-catalog <EmbeddedResource> to the project .csproj, and enable the plugin in project.godot. Optionally download the RID-matched gamedev-mcp-server binary (--with-server) and/or redeem an agent enrollment code (--enroll / --enroll-stdin).')
     .argument('[path]', 'Path to the Godot project')
     .option('--path <path>', 'Path to the Godot project')
     .option('--source <path>', 'Install the addon from a local directory (offline / dev / CI) instead of downloading it')
     .option('--version <x.y.z>', 'Addon release version to download (defaults to this CLI version). Ignored with --source.')
+    .option('--with-server', 'Also download the RID-matched gamedev-mcp-server binary into the CLI-managed dir (verified against the release SHA256SUMS)')
+    .option('--server-source <path>', 'Install the server binary from a local directory or .zip (offline / dev / CI) instead of downloading it. Implies --with-server.')
+    .option('--server-version <x.y.z>', "Server version to download (defaults to the addon's pinned ServerVersion). Ignored with --server-source.")
+    .option('--enroll <code>', 'Redeem an agent enrollment code (plants a plugin credential, no browser hop)')
+    .option('--enroll-stdin', 'Read the enrollment code from stdin instead of argv (keeps it out of shell history)')
+    .option('--base-url <url>', 'Cloud base URL to redeem the enrollment code against (default: https://ai-game.dev)')
     .action(async (positionalPath, options) => {
     const resolvedPath = positionalPath ?? options.path ?? process.cwd();
     const projectPath = path.resolve(resolvedPath);
+    // Resolve the enrollment code (argv vs stdin) up-front so misuse fails fast.
+    if (options.enroll !== undefined && options.enrollStdin) {
+        ui.error('Use either --enroll <code> or --enroll-stdin, not both.');
+        process.exit(1);
+    }
+    const enrollCode = options.enrollStdin ? readEnrollCodeFromStdin() : options.enroll;
+    const wantServer = options.withServer === true || options.serverSource !== undefined;
+    let failed = false;
+    // 1. Addon install (the existing real installer — always runs).
     ui.heading('Installing godot_mcp addon');
     verbose(`Project path: ${projectPath}`);
     if (options.source)
@@ -58,13 +94,9 @@ export const installPluginCommand = new Command('install-plugin')
     }
     // csproj outcome.
     if (result.csproj.csprojPath) {
-        const summary = result.csproj.packages
-            .map((p) => `${p.id}@${p.version} (${p.action})`)
-            .join(', ');
+        const summary = result.csproj.packages.map((p) => `${p.id}@${p.version} (${p.action})`).join(', ');
         ui.label('NuGet packages', summary || '(none)');
-        const embedSummary = result.csproj.embeds
-            .map((e) => `${e.logicalName} (${e.action})`)
-            .join(', ');
+        const embedSummary = result.csproj.embeds.map((e) => `${e.logicalName} (${e.action})`).join(', ');
         ui.label('Embedded resources', embedSummary || '(none)');
     }
     ui.label('project.godot', result.projectGodotPath);
@@ -73,5 +105,65 @@ export const installPluginCommand = new Command('install-plugin')
         console.log('');
         ui.warn(warning);
     }
+    // 2. Server binary (--with-server / --server-source).
+    if (wantServer) {
+        console.log('');
+        ui.heading('Downloading gamedev-mcp-server');
+        const serverSpinner = ui.startSpinner('Installing server binary...');
+        const serverResult = await installServer({
+            godotProjectPath: projectPath,
+            source: options.serverSource,
+            version: options.serverVersion,
+        });
+        if (serverResult.kind === 'failure') {
+            serverSpinner.error('Failed to install server binary');
+            ui.error(serverResult.error.message);
+            failed = true;
+        }
+        else {
+            serverSpinner.success(serverResult.source === 'download'
+                ? `gamedev-mcp-server ${serverResult.version} (${serverResult.rid}) verified + installed`
+                : `gamedev-mcp-server installed from local source (${serverResult.rid})`);
+            ui.label('Server binary', serverResult.executablePath);
+            for (const warning of serverResult.warnings) {
+                console.log('');
+                ui.warn(warning);
+            }
+        }
+    }
+    // 3. Enrollment (--enroll / --enroll-stdin).
+    if (enrollCode !== undefined) {
+        console.log('');
+        ui.heading('Redeeming enrollment code');
+        const enrollSpinner = ui.startSpinner('Redeeming...');
+        const enrollResult = await enrollPlugin({
+            godotProjectPath: projectPath,
+            code: enrollCode,
+            baseUrl: options.baseUrl ?? DEFAULT_CLOUD_BASE_URL,
+        });
+        if (enrollResult.kind === 'failure') {
+            enrollSpinner.error('Enrollment failed');
+            ui.error(enrollResult.error.message);
+            failed = true;
+        }
+        else {
+            enrollSpinner.success('Enrolled — plugin credential planted in the machine store');
+            ui.label('Server target', enrollResult.serverTarget);
+            ui.label('Project pin', enrollResult.pin);
+            if (enrollResult.port !== undefined)
+                ui.label('Local port', String(enrollResult.port));
+            ui.label('Credential', enrollResult.credentialsPath);
+            ui.label('Project marker', enrollResult.markerPath);
+            if (enrollResult.pinnedConfigs.length > 0) {
+                ui.label('Pinned configs', enrollResult.pinnedConfigs.join(', '));
+            }
+            for (const warning of enrollResult.warnings) {
+                console.log('');
+                ui.warn(warning);
+            }
+        }
+    }
+    if (failed)
+        process.exit(1);
 });
 //# sourceMappingURL=install-plugin.js.map

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

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

package/dist/commands/login.js

@@ -1,24 +1,30 @@
 import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
 import * as ui from '../utils/ui.js';
 import { verbose } from '../utils/ui.js';
-import { resolveProjectPath, DEFAULT_CLOUD_BASE_URL } from '../utils/connection.js';
-import { readCloudToken, readCredentials } from '../utils/credentials.js';
+import { DEFAULT_CLOUD_BASE_URL } from '../utils/connection.js';
+import { readCredentials } from '../utils/credentials.js';
+import { readMachineCredentials, getMachineCredentialsPath } from '../utils/machine-credentials.js';
 import { runCloudLogin } from '../utils/cloud-login.js';
 export const loginCommand = new Command('login')
-    .description('Authenticate with the Godot-MCP cloud server (ai-game.dev) via the RFC 8628 device-authorization flow and persist the cloud token so `godot-cli open --mode Cloud` connects without a manual --token.')
-    .argument('[path]', 'Godot project path — where the token is saved (defaults to current directory)')
-    .option('--path <path>', 'Godot project path (defaults to current directory)')
+    .description('Authenticate with the Godot-MCP cloud server (ai-game.dev) via the RFC 8628 device-authorization flow. ' +
+    'By default the credential is saved to the shared machine store (~/.ai-game-dev/credentials.json, 0600 / ' +
+    'DPAPI) so you sign in once per machine and the editor plugin auto-adopts it. Use --project <path> to keep ' +
+    'a per-project credential (project-local .godot-mcp/credentials.json, gitignored) instead.')
+    .argument('[path]', 'Project path for a per-project credential override (alias of --project). Omit for the machine store.')
+    .option('--project <path>', 'Save a per-project credential under <path>/.godot-mcp/ instead of the machine store')
+    .option('--path <path>', 'Alias of --project (kept for backward compatibility)')
     .option('--base-url <url>', 'Override the cloud base URL (default: https://ai-game.dev)')
-    .option('--force', 'Re-authenticate even if a cloud token is already saved')
+    .option('--force', 'Re-authenticate even if a credential is already saved')
     .action(async (positionalPath, options) => {
-    const projectPath = resolveProjectPath(positionalPath, options);
-    verbose(`Project path: ${projectPath}`);
     const baseUrl = (options.baseUrl ?? DEFAULT_CLOUD_BASE_URL).replace(/\/$/, '');
-    // Only short-circuit when a token is saved AND it was issued against the SAME
-    // base URL. Otherwise `login --base-url <other>` (without --force) would silently
-    // reuse a token minted for a different server. readCloudToken() truthy implies the
-    // credentials file parsed, so the follow-up readCredentials() cannot throw here.
-    if (!options.force && readCloudToken(projectPath) && readCredentials(projectPath)?.cloudBaseUrl === baseUrl) {
+    const { sink, savedLocationLabel } = resolveSink(positionalPath, options);
+    verbose(`Credential store: ${savedLocationLabel}`);
+    // Only short-circuit when a credential is saved in the SAME store AND it was issued against the
+    // SAME base URL. Otherwise `login --base-url <other>` (without --force) would silently reuse a
+    // credential minted for a different server.
+    if (!options.force && isAlreadyAuthenticated(sink, baseUrl)) {
         ui.success('Already authenticated with the cloud server.');
         ui.info('Use --force to re-authenticate.');
         return;
@@ -26,13 +32,45 @@ export const loginCommand = new Command('login')
     ui.heading('Cloud Authentication');
     ui.label('Server', baseUrl);
     ui.divider();
-    const token = await runCloudLogin(projectPath, { baseUrl });
+    const token = await runCloudLogin({ baseUrl, sink });
     if (token) {
-        ui.success('Authentication complete. Cloud token saved to .godot-mcp/credentials.json.');
+        ui.success(`Authentication complete. Cloud token saved to ${savedLocationLabel}.`);
         ui.info('Run: godot-cli open --mode Cloud   (no --token needed).');
     }
     else {
         process.exit(1);
     }
 });
+/**
+ * Resolve where the credential should be stored. A project override (via --project, the legacy
+ * --path, or the positional arg) selects the project-local store; otherwise the shared machine store.
+ */
+function resolveSink(positionalPath, options) {
+    const overrideRaw = options.project ?? options.path ?? positionalPath;
+    if (overrideRaw !== undefined) {
+        const projectPath = path.resolve(overrideRaw);
+        if (!fs.existsSync(projectPath)) {
+            ui.error(`Project path does not exist: ${projectPath}`);
+            process.exit(1);
+        }
+        return {
+            sink: { kind: 'project', projectPath },
+            savedLocationLabel: path.join(projectPath, '.godot-mcp', 'credentials.json'),
+        };
+    }
+    return { sink: { kind: 'machine' }, savedLocationLabel: getMachineCredentialsPath() };
+}
+function isAlreadyAuthenticated(sink, baseUrl) {
+    try {
+        if (sink.kind === 'project') {
+            const creds = readCredentials(sink.projectPath);
+            return !!creds?.cloudToken && creds.cloudBaseUrl === baseUrl;
+        }
+        const creds = readMachineCredentials(sink.storeBaseDir);
+        return !!creds?.accessToken && creds.serverTarget === baseUrl;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQxD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CACV,uMAAuM,CACxM;KACA,QAAQ,CAAC,QAAQ,EAAE,+EAA+E,CAAC;KACnG,MAAM,CAAC,eAAe,EAAE,oDAAoD,CAAC;KAC7E,MAAM,CAAC,kBAAkB,EAAE,4DAA4D,CAAC;KACxF,MAAM,CAAC,SAAS,EAAE,wDAAwD,CAAC;KAC3E,MAAM,CAAC,KAAK,EAAE,cAAkC,EAAE,OAAqB,EAAE,EAAE;IAC1E,MAAM,WAAW,GAAG,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAChE,OAAO,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE/E,8EAA8E;IAC9E,kFAAkF;IAClF,mFAAmF;IACnF,iFAAiF;IACjF,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,YAAY,KAAK,OAAO,EAAE,CAAC;QAC5G,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;QAC3D,EAAE,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5B,EAAE,CAAC,OAAO,EAAE,CAAC;IAEb,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5D,IAAI,KAAK,EAAE,CAAC;QACV,EAAE,CAAC,OAAO,CAAC,4EAA4E,CAAC,CAAC;QACzF,EAAE,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACpG,OAAO,EAAE,aAAa,EAAuB,MAAM,yBAAyB,CAAC;AAS7E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CACV,yGAAyG;IACvG,0GAA0G;IAC1G,4GAA4G;IAC5G,2FAA2F,CAC9F;KACA,QAAQ,CAAC,QAAQ,EAAE,sGAAsG,CAAC;KAC1H,MAAM,CAAC,kBAAkB,EAAE,qFAAqF,CAAC;KACjH,MAAM,CAAC,eAAe,EAAE,sDAAsD,CAAC;KAC/E,MAAM,CAAC,kBAAkB,EAAE,4DAA4D,CAAC;KACxF,MAAM,CAAC,SAAS,EAAE,uDAAuD,CAAC;KAC1E,MAAM,CAAC,KAAK,EAAE,cAAkC,EAAE,OAAqB,EAAE,EAAE;IAC1E,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAE/E,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC1E,OAAO,CAAC,qBAAqB,kBAAkB,EAAE,CAAC,CAAC;IAEnD,gGAAgG;IAChG,+FAA+F;IAC/F,4CAA4C;IAC5C,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5D,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;QAC3D,EAAE,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5B,EAAE,CAAC,OAAO,EAAE,CAAC;IAEb,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,IAAI,KAAK,EAAE,CAAC;QACV,EAAE,CAAC,OAAO,CAAC,iDAAiD,kBAAkB,GAAG,CAAC,CAAC;QACnF,EAAE,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,SAAS,WAAW,CAClB,cAAkC,EAClC,OAAqB;IAErB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;IACtE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE;YACtC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,kBAAkB,CAAC;SAC7E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAoB,EAAE,OAAe;IACnE,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChD,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxD,OAAO,CAAC,CAAC,KAAK,EAAE,WAAW,IAAI,KAAK,CAAC,YAAY,KAAK,OAAO,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/lib/configure-agent.d.ts

@@ -0,0 +1,20 @@
+import type { ConfigureAgentOptions, ConfigureAgentResult } from './types.js';
+/**
+ * Proxy `configure --agent <id>` to the CLI-managed `gamedev-mcp-server` binary's
+ * own `configure` subcommand (design 06 / 09 workflow 1B, step 2). The downloaded
+ * server binary — placed by `install-plugin --with-server` in the CLI's managed
+ * dir, NOT on PATH — owns the shared C# configurator registry and writes the
+ * agent's MCP-client config (with the derived `port=` + `project=` pin). The CLI
+ * merely locates the managed binary and spawns:
+ *
+ *   <managed-server> configure --agent <id> [--url <url>]     (cwd = project root)
+ *
+ * forwarding the agent id + optional URL and the binary's exit code. cwd is the
+ * project root so the server derives this project's pin + port. When no managed
+ * binary exists (the user never ran `--with-server`), a clean failure tells them
+ * to run it first — NOT a cryptic ENOENT.
+ *
+ * Library-safe: never throws past the boundary; captures the server's output and
+ * returns it (the command prints it). `spawnImpl` is injectable for tests.
+ */
+export declare function configureAgentViaServer(opts: ConfigureAgentOptions): Promise<ConfigureAgentResult>;

package/dist/lib/configure-agent.js

@@ -0,0 +1,115 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn } from 'child_process';
+import { getManagedServerExecutablePath } from './install-server.js';
+import { emitProgress } from './progress.js';
+/**
+ * Proxy `configure --agent <id>` to the CLI-managed `gamedev-mcp-server` binary's
+ * own `configure` subcommand (design 06 / 09 workflow 1B, step 2). The downloaded
+ * server binary — placed by `install-plugin --with-server` in the CLI's managed
+ * dir, NOT on PATH — owns the shared C# configurator registry and writes the
+ * agent's MCP-client config (with the derived `port=` + `project=` pin). The CLI
+ * merely locates the managed binary and spawns:
+ *
+ *   <managed-server> configure --agent <id> [--url <url>]     (cwd = project root)
+ *
+ * forwarding the agent id + optional URL and the binary's exit code. cwd is the
+ * project root so the server derives this project's pin + port. When no managed
+ * binary exists (the user never ran `--with-server`), a clean failure tells them
+ * to run it first — NOT a cryptic ENOENT.
+ *
+ * Library-safe: never throws past the boundary; captures the server's output and
+ * returns it (the command prints it). `spawnImpl` is injectable for tests.
+ */
+export async function configureAgentViaServer(opts) {
+    const warnings = [];
+    try {
+        const projectPath = path.resolve(opts.godotProjectPath);
+        if (!fs.existsSync(projectPath)) {
+            throw new Error(`Project path does not exist: ${projectPath}`);
+        }
+        const agentId = (opts.agentId ?? '').trim();
+        if (agentId.length === 0) {
+            throw new Error('An agent id is required (configure --agent <id>).');
+        }
+        const serverBinaryPath = getManagedServerExecutablePath(projectPath);
+        if (!fs.existsSync(serverBinaryPath)) {
+            throw new Error(`No managed server binary found at ${serverBinaryPath}. ` +
+                `Run \`godot-cli install-plugin --with-server\` first to download it.`);
+        }
+        const args = ['configure', '--agent', agentId];
+        if (opts.url && opts.url.trim().length > 0) {
+            args.push('--url', opts.url.trim());
+        }
+        emitProgress(opts.onProgress, {
+            phase: 'start',
+            message: `Proxying to ${serverBinaryPath} ${args.join(' ')}`,
+        });
+        const run = await runServerConfigure(serverBinaryPath, args, projectPath, opts.spawnImpl);
+        if (run.code !== 0) {
+            const detail = run.output.trim();
+            const err = new Error(`The managed server \`configure --agent ${agentId}\` exited with code ${run.code ?? 'null'}.` +
+                (detail.length > 0 ? `\n${detail}` : ''));
+            return { kind: 'failure', success: false, exitCode: run.code ?? undefined, warnings, error: err };
+        }
+        emitProgress(opts.onProgress, { phase: 'done', message: `Configured ${agentId} via the managed server.` });
+        return {
+            kind: 'success',
+            success: true,
+            agentId,
+            serverBinaryPath,
+            args,
+            exitCode: 0,
+            output: run.output,
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+/**
+ * Spawn the managed server's `configure` subcommand, capturing stdout+stderr, and
+ * resolve once it exits. A spawn `error` (e.g. the binary is not executable)
+ * resolves as a non-zero run rather than throwing past the boundary. `spawnImpl`
+ * is injectable for unit tests.
+ */
+function runServerConfigure(bin, args, cwd, spawnImpl = spawn) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (run) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(run);
+        };
+        let child;
+        try {
+            child = spawnImpl(bin, args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            finish({ code: 127, output: `Failed to spawn "${bin}": ${msg}` });
+            return;
+        }
+        let output = '';
+        child.stdout?.on('data', (chunk) => {
+            output += chunk.toString();
+        });
+        child.stderr?.on('data', (chunk) => {
+            output += chunk.toString();
+        });
+        child.on('error', (err) => {
+            finish({ code: 127, output: `${output}\nFailed to run "${bin}": ${err.message}` });
+        });
+        child.on('close', (code) => {
+            finish({ code, output });
+        });
+    });
+}
+//# sourceMappingURL=configure-agent.js.map

package/dist/lib/configure-agent.js.map

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

package/dist/lib/enroll.d.ts

@@ -0,0 +1,21 @@
+import type { EnrollPluginOptions, EnrollPluginResult } from './types.js';
+/**
+ * Redeem a D13 enrollment code and complete the agent-first onboarding for a
+ * project (design 06 / 09 workflow 1A, step 3), with NO browser hop:
+ *
+ *  1. POST the code to the cloud AS `enroll/redeem` endpoint → an `mcp:plugin`
+ *     JWT + refresh token + the server-target URL the code was minted for.
+ *  2. Persist the plugin credential to the SHARED machine store
+ *     (`~/.ai-game-dev/credentials.json`, 0600 / DPAPI) so the editor plugin
+ *     auto-adopts it (D12) — zero editor clicks.
+ *  3. Write the project marker (`.ai-game-dev/project.json`) with the server
+ *     target, the D14 pin, and — for a localhost target — the deterministic
+ *     local port.
+ *  4. Upsert the D14 pin into any existing project-local agent config entry so a
+ *     server the user added manually before enrolling becomes pinned.
+ *
+ * Library-safe: never throws past the boundary; returns a `{ kind }` union. On a
+ * redeem failure NOTHING is written (the machine store + marker + configs are
+ * left as found).
+ */
+export declare function enrollPlugin(opts: EnrollPluginOptions): Promise<EnrollPluginResult>;

package/dist/lib/enroll.js

@@ -0,0 +1,100 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { DEFAULT_CLOUD_BASE_URL } from '../utils/connection.js';
+import { redeemEnrollment } from '../utils/enroll.js';
+import { writeMachineCredentials, readMachineCredentials, getMachineCredentialsPath, } from '../utils/machine-credentials.js';
+import { derivePin, derivePort } from '../utils/project-identity.js';
+import { writeProjectMarker, getProjectMarkerPath, isLocalhostUrl, upsertPinIntoAgentConfigs, } from '../utils/project-marker.js';
+import { emitProgress } from './progress.js';
+/**
+ * Redeem a D13 enrollment code and complete the agent-first onboarding for a
+ * project (design 06 / 09 workflow 1A, step 3), with NO browser hop:
+ *
+ *  1. POST the code to the cloud AS `enroll/redeem` endpoint → an `mcp:plugin`
+ *     JWT + refresh token + the server-target URL the code was minted for.
+ *  2. Persist the plugin credential to the SHARED machine store
+ *     (`~/.ai-game-dev/credentials.json`, 0600 / DPAPI) so the editor plugin
+ *     auto-adopts it (D12) — zero editor clicks.
+ *  3. Write the project marker (`.ai-game-dev/project.json`) with the server
+ *     target, the D14 pin, and — for a localhost target — the deterministic
+ *     local port.
+ *  4. Upsert the D14 pin into any existing project-local agent config entry so a
+ *     server the user added manually before enrolling becomes pinned.
+ *
+ * Library-safe: never throws past the boundary; returns a `{ kind }` union. On a
+ * redeem failure NOTHING is written (the machine store + marker + configs are
+ * left as found).
+ */
+export async function enrollPlugin(opts) {
+    const warnings = [];
+    try {
+        const projectPath = path.resolve(opts.godotProjectPath);
+        if (!fs.existsSync(projectPath)) {
+            throw new Error(`Project path does not exist: ${projectPath}`);
+        }
+        const baseUrl = (opts.baseUrl ?? DEFAULT_CLOUD_BASE_URL).replace(/\/$/, '');
+        emitProgress(opts.onProgress, { phase: 'enroll-redeeming', message: 'Redeeming enrollment code' });
+        const redeem = await redeemEnrollment({ code: opts.code, baseUrl, fetchImpl: opts.fetchImpl });
+        if (!redeem.success) {
+            // A redeem failure is terminal but non-throwing — nothing was written.
+            throw new Error(redeem.message);
+        }
+        const { access_token, refresh_token, expires_in, server_url } = redeem.credential;
+        const serverTarget = server_url;
+        // 2. Machine store: plant the plugin credential, preserving any existing
+        // identity fields (e.g. `subject`), replacing token material + server target.
+        let existing = {};
+        try {
+            existing = readMachineCredentials(opts.storeBaseDir) ?? {};
+        }
+        catch {
+            existing = {};
+        }
+        const expiresAt = typeof expires_in === 'number' && expires_in > 0
+            ? new Date(Date.now() + expires_in * 1000).toISOString()
+            : undefined;
+        writeMachineCredentials({
+            ...existing,
+            version: 1,
+            accessToken: access_token,
+            refreshToken: refresh_token,
+            ...(expiresAt ? { expiresAt } : {}),
+            serverTarget,
+        }, opts.storeBaseDir);
+        const credentialsPath = getMachineCredentialsPath(opts.storeBaseDir);
+        emitProgress(opts.onProgress, { phase: 'enroll-redeemed', message: 'Credential planted', serverTarget });
+        // 3. Project marker: server target + pin (+ derived port for a localhost target).
+        const pin = derivePin(projectPath);
+        const localhost = isLocalhostUrl(serverTarget);
+        const port = localhost ? derivePort(projectPath) : undefined;
+        writeProjectMarker(projectPath, {
+            serverTarget,
+            pin,
+            ...(port !== undefined ? { port } : {}),
+        });
+        const markerPath = getProjectMarkerPath(projectPath);
+        // 4. Upsert the pin into any existing project-local agent config entry.
+        const pinnedConfigs = upsertPinIntoAgentConfigs(projectPath, pin);
+        emitProgress(opts.onProgress, { phase: 'done', message: 'Enrollment complete.' });
+        return {
+            kind: 'success',
+            success: true,
+            serverTarget,
+            pin,
+            port,
+            credentialsPath,
+            markerPath,
+            pinnedConfigs,
+            warnings,
+        };
+    }
+    catch (err) {
+        return {
+            kind: 'failure',
+            success: false,
+            warnings,
+            error: err instanceof Error ? err : new Error(String(err)),
+        };
+    }
+}
+//# sourceMappingURL=enroll.js.map

package/dist/lib/enroll.js.map

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