@agentteams/cli 0.1.75 → 0.1.77

package/dist/mcp-registration/clients.js

@@ -0,0 +1,300 @@
+import { join } from 'node:path';
+/**
+ * Registry of the eight AgentTeams runner engines that can host an MCP client.
+ *
+ * Every entry below was verified on 2026-07-25 against the vendor's public docs
+ * *and* against a local install (`<tool> mcp add --help`, plus a two-run
+ * idempotency check where the tool ships a registration command). The
+ * `verifiedAt` / `docsUrl` fields exist so a future contract drift is traceable
+ * to the day the claim was made.
+ *
+ * Deliberate exclusions: Orca is a worktree runner environment, not an MCP
+ * client (register the agents it launches instead), and `GEMINI` is a
+ * deprecated runner type.
+ *
+ * `runnerType` mirrors `packages/core-constants`'s `RUNNER_TYPES`. The public
+ * CLI is published from a `cli/`-only subtree split, so that private package
+ * cannot be a runtime dependency; a monorepo-only drift test asserts the two
+ * key sets stay identical instead.
+ */
+function xdgConfigHome(context) {
+    const override = context.env.XDG_CONFIG_HOME;
+    return override && override.length > 0 ? override : join(context.homeDir, '.config');
+}
+function kimiHome(context) {
+    const override = context.env.KIMI_CODE_HOME;
+    return override && override.length > 0 ? override : join(context.homeDir, '.kimi-code');
+}
+function codexHome(context) {
+    const override = context.env.CODEX_HOME;
+    return override && override.length > 0 ? override : join(context.homeDir, '.codex');
+}
+function copilotHome(context) {
+    const override = context.env.COPILOT_HOME;
+    return override && override.length > 0 ? override : join(context.homeDir, '.copilot');
+}
+function envFlags(spec, flag) {
+    return Object.entries(spec.env).flatMap(([key, value]) => [flag, `${key}=${value}`]);
+}
+const ALREADY_REGISTERED = [/already exists/i];
+export const MCP_CLIENTS = [
+    {
+        id: 'claude-code',
+        runnerType: 'CLAUDE_CODE',
+        label: 'Claude Code',
+        executables: ['claude'],
+        secretReference: 'dollarBraces',
+        configSignals: (context) => [join(context.homeDir, '.claude.json'), join(context.homeDir, '.claude')],
+        docsUrl: 'https://code.claude.com/docs/en/mcp',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            user: {
+                configPath: (context) => join(context.homeDir, '.claude.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'stdio',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.mcp.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'stdio',
+                strategy: 'vendorCommand',
+                vendor: {
+                    buildArgs: (spec, name) => [
+                        'mcp',
+                        'add',
+                        name,
+                        '--scope',
+                        'project',
+                        ...envFlags(spec, '-e'),
+                        '--',
+                        spec.command,
+                        ...spec.args,
+                    ],
+                    rerunBehavior: 'refuse',
+                    alreadyRegisteredPatterns: ALREADY_REGISTERED,
+                },
+            },
+        },
+    },
+    {
+        id: 'codex',
+        runnerType: 'CODEX',
+        label: 'Codex',
+        executables: ['codex'],
+        secretReference: 'codexEnvVars',
+        configSignals: (context) => [join(codexHome(context), 'config.toml'), codexHome(context)],
+        docsUrl: 'https://developers.openai.com/codex/mcp',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            user: {
+                configPath: (context) => join(codexHome(context), 'config.toml'),
+                format: 'toml',
+                strategy: 'configOnly',
+                configOnlyReason: 'Codex inherits secrets through `env_vars`, but `codex mcp add --env` accepts values only through argv. The CLI therefore prints a safe TOML snippet instead of exposing the API key in the process list.',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.codex', 'config.toml'),
+                format: 'toml',
+                strategy: 'configOnly',
+                configOnlyReason: 'Codex project config is TOML and `codex mcp add` only targets the user config. The CLI has no comment-preserving TOML editor, so rewriting the file would drop your comments and key order.',
+            },
+        },
+    },
+    {
+        id: 'copilot-cli',
+        runnerType: 'COPILOT_CLI',
+        label: 'GitHub Copilot CLI',
+        executables: ['copilot'],
+        secretReference: 'dollarBraces',
+        configSignals: (context) => [join(copilotHome(context), 'mcp-config.json'), copilotHome(context)],
+        docsUrl: 'https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            user: {
+                configPath: (context) => join(copilotHome(context), 'mcp-config.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'stdio',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.mcp.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'stdio',
+                strategy: 'jsonMerge',
+            },
+        },
+    },
+    {
+        id: 'opencode',
+        runnerType: 'OPENCODE',
+        label: 'OpenCode',
+        executables: ['opencode'],
+        secretReference: 'opencodeEnv',
+        configSignals: (context) => [
+            join(xdgConfigHome(context), 'opencode', 'opencode.jsonc'),
+            join(xdgConfigHome(context), 'opencode', 'opencode.json'),
+            join(xdgConfigHome(context), 'opencode'),
+        ],
+        docsUrl: 'https://opencode.ai/docs/mcp-servers',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            user: {
+                configPath: (context) => join(xdgConfigHome(context), 'opencode', 'opencode.jsonc'),
+                format: 'jsonc',
+                containerKey: 'mcp',
+                entryShape: 'opencode',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, 'opencode.json'),
+                format: 'json',
+                containerKey: 'mcp',
+                entryShape: 'opencode',
+                strategy: 'jsonMerge',
+            },
+        },
+    },
+    {
+        id: 'amp',
+        runnerType: 'AMP',
+        label: 'Amp',
+        executables: ['amp'],
+        secretReference: 'dollarBraces',
+        configSignals: (context) => [
+            join(xdgConfigHome(context), 'amp', 'settings.json'),
+            join(xdgConfigHome(context), 'amp'),
+        ],
+        docsUrl: 'https://ampcode.com/manual',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            user: {
+                configPath: (context) => join(xdgConfigHome(context), 'amp', 'settings.json'),
+                format: 'json',
+                containerKey: 'amp.mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.amp', 'settings.json'),
+                format: 'json',
+                containerKey: 'amp.mcpServers',
+                entryShape: 'plain',
+                strategy: 'vendorCommand',
+                vendor: {
+                    buildArgs: (spec, name) => [
+                        'mcp',
+                        'add',
+                        name,
+                        '--workspace',
+                        ...envFlags(spec, '--env'),
+                        '--',
+                        spec.command,
+                        ...spec.args,
+                    ],
+                    rerunBehavior: 'refuse',
+                    alreadyRegisteredPatterns: ALREADY_REGISTERED,
+                },
+            },
+        },
+    },
+    {
+        id: 'cursor-cli',
+        runnerType: 'CURSOR_CLI',
+        label: 'Cursor CLI',
+        executables: ['cursor-agent'],
+        secretReference: 'dollarBraces',
+        configSignals: (context) => [join(context.homeDir, '.cursor', 'mcp.json'), join(context.homeDir, '.cursor')],
+        docsUrl: 'https://docs.cursor.com/context/model-context-protocol',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            // Verified 2026.07.16: `cursor-agent mcp` exposes only login/list/enable/
+            // disable — there is no `add`, so the config file is the only contract.
+            user: {
+                configPath: (context) => join(context.homeDir, '.cursor', 'mcp.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.cursor', 'mcp.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+        },
+    },
+    {
+        id: 'kimi-cli',
+        runnerType: 'KIMI_CLI',
+        label: 'Kimi CLI',
+        executables: ['kimi'],
+        secretReference: 'dollarBraces',
+        extraBinDirs: (context) => [join(kimiHome(context), 'bin')],
+        configSignals: (context) => [join(kimiHome(context), 'mcp.json'), kimiHome(context)],
+        docsUrl: 'https://www.kimi.com/code/docs/en/kimi-code-cli/customization/mcp.html',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            // Verified 0.29.0: kimi-code exposes no `mcp` subcommand at all; it loads
+            // `<KIMI_CODE_HOME>/mcp.json` and `<cwd>/.kimi-code/mcp.json` directly.
+            user: {
+                configPath: (context) => join(kimiHome(context), 'mcp.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.kimi-code', 'mcp.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+        },
+    },
+    {
+        id: 'antigravity',
+        runnerType: 'ANTIGRAVITY',
+        label: 'Antigravity',
+        executables: ['agy', 'antigravity'],
+        secretReference: 'dollarBraces',
+        configSignals: (context) => [
+            join(context.homeDir, '.gemini', 'config', 'mcp_config.json'),
+            join(context.homeDir, '.gemini', 'antigravity'),
+        ],
+        docsUrl: 'https://antigravity.google/docs/mcp',
+        verifiedAt: '2026-07-25',
+        scopes: {
+            // Verified 1.1.2: the `agy` CLI has no `mcp` subcommand; `mcp_config.json`
+            // with an `mcpServers` map is the documented contract.
+            user: {
+                configPath: (context) => join(context.homeDir, '.gemini', 'config', 'mcp_config.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+            project: {
+                configPath: (context) => join(context.cwd, '.agents', 'mcp_config.json'),
+                format: 'json',
+                containerKey: 'mcpServers',
+                entryShape: 'plain',
+                strategy: 'jsonMerge',
+            },
+        },
+    },
+];
+export function findClient(clientId) {
+    return MCP_CLIENTS.find((client) => client.id === clientId);
+}
+export function listClientIds() {
+    return MCP_CLIENTS.map((client) => client.id);
+}
+//# sourceMappingURL=clients.js.map

package/dist/mcp-registration/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/mcp-registration/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;;;;;;;;;;GAiBG;AAEH,SAAS,aAAa,CAAC,OAAuB;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC7C,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,QAAQ,CAAC,OAAuB;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5C,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,SAAS,CAAC,OAAuB;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACxC,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,WAAW,CAAC,OAAuB;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1C,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAmB,EAAE,IAAY;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,kBAAkB,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD;QACE,EAAE,EAAE,aAAa;QACjB,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,CAAC,QAAQ,CAAC;QACvB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACrG,OAAO,EAAE,qCAAqC;QAC9C,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC;gBAC9D,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;gBACvD,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,eAAe;gBACzB,MAAM,EAAE;oBACN,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;wBACzB,KAAK;wBACL,KAAK;wBACL,IAAI;wBACJ,SAAS;wBACT,SAAS;wBACT,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;wBACvB,IAAI;wBACJ,IAAI,CAAC,OAAO;wBACZ,GAAG,IAAI,CAAC,IAAI;qBACb;oBACD,aAAa,EAAE,QAAQ;oBACvB,yBAAyB,EAAE,kBAAkB;iBAC9C;aACF;SACF;KACF;IACD;QACE,EAAE,EAAE,OAAO;QACX,UAAU,EAAE,OAAO;QACnB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,CAAC,OAAO,CAAC;QACtB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QACzF,OAAO,EAAE,yCAAyC;QAClD,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;gBAChE,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,YAAY;gBACtB,gBAAgB,EACd,0MAA0M;aAC7M;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC;gBACnE,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,YAAY;gBACtB,gBAAgB,EACd,6LAA6L;aAChM;SACF;KACF;IACD;QACE,EAAE,EAAE,aAAa;QACjB,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,CAAC,SAAS,CAAC;QACxB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QACjG,OAAO,EAAE,0FAA0F;QACnG,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;gBACtE,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;gBACvD,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;SACF;KACF;IACD;QACE,EAAE,EAAE,UAAU;QACd,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,eAAe,EAAE,aAAa;QAC9B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC;YAC1D,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC;YACzD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;SACzC;QACD,OAAO,EAAE,sCAAsC;QAC/C,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC;gBACnF,MAAM,EAAE,OAAO;gBACf,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,UAAU;gBACtB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC;gBAC3D,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,UAAU;gBACtB,QAAQ,EAAE,WAAW;aACtB;SACF;KACF;IACD;QACE,EAAE,EAAE,KAAK;QACT,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,CAAC,KAAK,CAAC;QACpB,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC;YACpD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;SACpC;QACD,OAAO,EAAE,4BAA4B;QACrC,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC;gBAC7E,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,gBAAgB;gBAC9B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC;gBACnE,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,gBAAgB;gBAC9B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,eAAe;gBACzB,MAAM,EAAE;oBACN,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;wBACzB,KAAK;wBACL,KAAK;wBACL,IAAI;wBACJ,aAAa;wBACb,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;wBAC1B,IAAI;wBACJ,IAAI,CAAC,OAAO;wBACZ,GAAG,IAAI,CAAC,IAAI;qBACb;oBACD,aAAa,EAAE,QAAQ;oBACvB,yBAAyB,EAAE,kBAAkB;iBAC9C;aACF;SACF;KACF;IACD;QACE,EAAE,EAAE,YAAY;QAChB,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,CAAC,cAAc,CAAC;QAC7B,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC5G,OAAO,EAAE,wDAAwD;QACjE,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,0EAA0E;YAC1E,wEAAwE;YACxE,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC;gBACrE,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC;gBACjE,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;SACF;KACF;IACD;QACE,EAAE,EAAE,UAAU;QACd,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,CAAC,MAAM,CAAC;QACrB,eAAe,EAAE,cAAc;QAC/B,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpF,OAAO,EAAE,wEAAwE;QACjF,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,0EAA0E;YAC1E,wEAAwE;YACxE,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;gBAC5D,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,CAAC;gBACpE,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;SACF;KACF;IACD;QACE,EAAE,EAAE,aAAa;QACjB,UAAU,EAAE,aAAa;QACzB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC;QACnC,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,CAAC;YAC7D,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC;SAChD;QACD,OAAO,EAAE,qCAAqC;QAC9C,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,2EAA2E;YAC3E,uDAAuD;YACvD,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,CAAC;gBACtF,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;YACD,OAAO,EAAE;gBACP,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,iBAAiB,CAAC;gBACxE,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,OAAO;gBACnB,QAAQ,EAAE,WAAW;aACtB;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/mcp-registration/detect.d.ts

@@ -0,0 +1,23 @@
+import type { DetectionSignal, McpPathContext } from './types.js';
+/**
+ * CLI-local client detection.
+ *
+ * The daemon has its own executable resolver, but the public CLI is published
+ * from a `cli/`-only subtree split and cannot import `daemon/src/executable.ts`.
+ * The lookup is kept injectable so tests drive it with a fake PATH and a
+ * temporary HOME rather than the developer's real machine.
+ */
+export interface DetectionDependencies {
+    context: McpPathContext;
+    fileExists?: (path: string) => boolean;
+    /** Windows resolves executables through PATHEXT; the default mirrors that. */
+    executableSuffixes?: string[];
+}
+/**
+ * Config traces and an executable are independent signals: a client counts as a
+ * candidate when either one is present. Reporting *which* signal fired is what
+ * lets a user tell "installed but never configured" apart from "config left
+ * behind by an uninstall".
+ */
+export declare function detectClients(dependencies: DetectionDependencies): DetectionSignal[];
+//# sourceMappingURL=detect.d.ts.map

package/dist/mcp-registration/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/mcp-registration/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAuB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;;;GAOG;AAEH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AA2BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,qBAAqB,GAAG,eAAe,EAAE,CAsBpF"}

package/dist/mcp-registration/detect.js

@@ -0,0 +1,48 @@
+import { existsSync } from 'node:fs';
+import { delimiter, join } from 'node:path';
+import { MCP_CLIENTS } from './clients.js';
+function defaultSuffixes(platform) {
+    return platform === 'win32' ? ['', '.cmd', '.exe', '.bat', '.ps1'] : [''];
+}
+function resolveExecutable(client, dependencies) {
+    const { context, fileExists } = dependencies;
+    const suffixes = dependencies.executableSuffixes ?? defaultSuffixes(process.platform);
+    const pathDirs = (context.env.PATH ?? '').split(delimiter).filter((entry) => entry.length > 0);
+    const extraDirs = client.extraBinDirs ? client.extraBinDirs(context) : [];
+    for (const directory of [...pathDirs, ...extraDirs]) {
+        for (const executable of client.executables) {
+            for (const suffix of suffixes) {
+                const candidate = join(directory, `${executable}${suffix}`);
+                if (fileExists(candidate))
+                    return candidate;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Config traces and an executable are independent signals: a client counts as a
+ * candidate when either one is present. Reporting *which* signal fired is what
+ * lets a user tell "installed but never configured" apart from "config left
+ * behind by an uninstall".
+ */
+export function detectClients(dependencies) {
+    const fileExists = dependencies.fileExists ?? existsSync;
+    const resolved = { ...dependencies, fileExists };
+    return MCP_CLIENTS.map((client) => {
+        const configPaths = client.configSignals(dependencies.context).filter((path) => fileExists(path));
+        const executablePath = resolveExecutable(client, resolved);
+        const hasConfig = configPaths.length > 0;
+        const hasExecutable = executablePath !== null;
+        const evidence = hasConfig && hasExecutable ? 'both' : hasConfig ? 'configured' : hasExecutable ? 'executable' : 'none';
+        return {
+            clientId: client.id,
+            label: client.label,
+            evidence,
+            executablePath,
+            configPaths,
+            detected: hasConfig || hasExecutable,
+        };
+    });
+}
+//# sourceMappingURL=detect.js.map

package/dist/mcp-registration/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/mcp-registration/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAmB3C,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,iBAAiB,CACxB,MAA2B,EAC3B,YAAyF;IAEzF,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC;IAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,kBAAkB,IAAI,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/F,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1E,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;QACpD,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;gBAC5D,IAAI,UAAU,CAAC,SAAS,CAAC;oBAAE,OAAO,SAAS,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,YAAmC;IAC/D,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,IAAI,UAAU,CAAC;IACzD,MAAM,QAAQ,GAAG,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,CAAC;IAEjD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAClG,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE3D,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,cAAc,KAAK,IAAI,CAAC;QAC9C,MAAM,QAAQ,GACZ,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;QAEzG,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ;YACR,cAAc;YACd,WAAW;YACX,QAAQ,EAAE,SAAS,IAAI,aAAa;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/mcp-registration/index.d.ts

@@ -0,0 +1,50 @@
+import type { DetectionDependencies } from './detect.js';
+import { type McpCredentials } from './serverSpec.js';
+import type { McpPathContext } from './types.js';
+import type { VendorRunner } from './vendorCommand.js';
+export { MCP_CLIENTS, findClient, listClientIds } from './clients.js';
+export { detectClients } from './detect.js';
+export { buildBatchPlan, installClient, resolveInstallExitCode, runBatchInstall } from './install.js';
+export { renderConfigSnippet, renderVendorCommandLine, redactSecrets } from './render.js';
+export { buildServerSpec, MCP_SERVER_NAME, CREDENTIAL_ENV_KEYS } from './serverSpec.js';
+export type { McpCredentials } from './serverSpec.js';
+export * from './types.js';
+declare const MCP_CLIENT_ID_LIST: ("claude-code" | "codex" | "copilot-cli" | "opencode" | "amp" | "cursor-cli" | "kimi-cli" | "antigravity")[];
+export { MCP_CLIENT_ID_LIST };
+export interface McpRegistrationCommandOptions {
+    client?: string;
+    scope?: string;
+    serverEntry?: string;
+    yes?: boolean;
+    apiKey?: string;
+    apiUrl?: string;
+    projectId?: string;
+    teamId?: string;
+}
+/** Injection seams so tests drive a temporary HOME/cwd and a fake vendor CLI. */
+export interface McpRegistrationDependencies {
+    context?: Partial<McpPathContext>;
+    credentials?: McpCredentials;
+    vendorRunner?: VendorRunner;
+    detectionDependencies?: Omit<DetectionDependencies, 'context'>;
+}
+export interface CommandOutput {
+    text: string;
+    json: unknown;
+    exitCode: number;
+}
+/**
+ * `config` is the escape hatch: it renders the exact fragment each client
+ * expects and never touches a file, a vendor CLI or the network. The API key is
+ * always emitted with the target client's environment-reference contract so
+ * the output stays safe to paste into a terminal, an issue or a code review.
+ */
+export declare function runMcpConfigCommand(options: McpRegistrationCommandOptions, dependencies?: McpRegistrationDependencies): CommandOutput;
+/**
+ * `install` has two modes:
+ *  - `--client <id>`: apply a single client/scope (project scope allowed here).
+ *  - no `--client`: detect local clients and print the plan. Only `--yes` turns
+ *    that plan into writes, and only at user scope.
+ */
+export declare function runMcpInstallCommand(options: McpRegistrationCommandOptions, dependencies?: McpRegistrationDependencies): CommandOutput;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-registration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-registration/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,KAAK,EAA8B,cAAc,EAAY,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACxF,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,YAAY,CAAC;AAE3B,QAAA,MAAM,kBAAkB,8GAAkB,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,qBAAqB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,6BAA6B,EACtC,YAAY,CAAC,EAAE,2BAA2B,GACzC,aAAa,CA2Cf;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,6BAA6B,EACtC,YAAY,CAAC,EAAE,2BAA2B,GACzC,aAAa,CA0Ff"}

package/dist/mcp-registration/index.js

@@ -0,0 +1,205 @@
+import { homedir } from 'node:os';
+import { getConfigurationNotFoundMessage, loadConfig } from '../utils/config.js';
+import { buildConfigOverrides } from '../utils/apiContext.js';
+import { findClient, listClientIds } from './clients.js';
+import { buildBatchPlan, installClient, resolveInstallExitCode, runBatchInstall } from './install.js';
+import { renderConfigSnippet, renderVendorCommandLine } from './render.js';
+import { buildServerSpec, MCP_SERVER_NAME } from './serverSpec.js';
+export { MCP_CLIENTS, findClient, listClientIds } from './clients.js';
+export { detectClients } from './detect.js';
+export { buildBatchPlan, installClient, resolveInstallExitCode, runBatchInstall } from './install.js';
+export { renderConfigSnippet, renderVendorCommandLine, redactSecrets } from './render.js';
+export { buildServerSpec, MCP_SERVER_NAME, CREDENTIAL_ENV_KEYS } from './serverSpec.js';
+export * from './types.js';
+const MCP_CLIENT_ID_LIST = listClientIds();
+export { MCP_CLIENT_ID_LIST };
+function resolveCredentials(options, dependencies) {
+    if (dependencies?.credentials)
+        return dependencies.credentials;
+    const config = loadConfig(buildConfigOverrides(options));
+    if (!config)
+        throw new Error(getConfigurationNotFoundMessage());
+    return {
+        apiKey: config.apiKey,
+        projectId: config.projectId,
+        teamId: config.teamId,
+        apiUrl: config.apiUrl,
+    };
+}
+function resolvePathContext(overrides) {
+    return {
+        homeDir: overrides?.homeDir ?? homedir(),
+        cwd: overrides?.cwd ?? process.cwd(),
+        env: overrides?.env ?? process.env,
+    };
+}
+function parseScope(value) {
+    if (value === undefined || value === null || value === '')
+        return 'user';
+    if (value === 'user' || value === 'project')
+        return value;
+    throw new Error(`Unsupported scope: ${String(value)}. Use "user" or "project".`);
+}
+function parseClientId(value) {
+    const client = findClient(value);
+    if (!client) {
+        throw new Error(`Unknown client: ${value}. Supported clients: ${MCP_CLIENT_ID_LIST.join(', ')}.`);
+    }
+    return client.id;
+}
+/**
+ * `config` is the escape hatch: it renders the exact fragment each client
+ * expects and never touches a file, a vendor CLI or the network. The API key is
+ * always emitted with the target client's environment-reference contract so
+ * the output stays safe to paste into a terminal, an issue or a code review.
+ */
+export function runMcpConfigCommand(options, dependencies) {
+    const credentials = resolveCredentials(options, dependencies);
+    const context = resolvePathContext(dependencies?.context);
+    const scope = parseScope(options.scope);
+    const clientIds = options.client ? [parseClientId(options.client)] : MCP_CLIENT_ID_LIST;
+    const spec = buildServerSpec({ credentials, secretMode: 'reference', serverEntry: options.serverEntry });
+    const sections = clientIds.map((clientId) => {
+        const client = findClient(clientId);
+        if (!client)
+            throw new Error(`Unknown client: ${clientId}`);
+        const definition = client.scopes[scope];
+        return {
+            clientId,
+            label: client.label,
+            scope,
+            configPath: definition.configPath(context),
+            format: definition.format,
+            strategy: definition.strategy,
+            docsUrl: client.docsUrl,
+            verifiedAt: client.verifiedAt,
+            snippet: renderConfigSnippet(client, scope, spec, MCP_SERVER_NAME),
+            vendorCommand: renderVendorCommandLine(client, scope, spec, MCP_SERVER_NAME),
+            configOnlyReason: definition.configOnlyReason ?? null,
+        };
+    });
+    const lines = [
+        `AgentTeams MCP config (${scope} scope) — project ${credentials.projectId}, team ${credentials.teamId}`,
+        'The API key is rendered with the selected client’s environment-reference syntax. Export AGENTTEAMS_API_KEY before the client starts.',
+    ];
+    for (const section of sections) {
+        lines.push('');
+        lines.push(`## ${section.label} (${section.clientId})`);
+        lines.push(`File: ${section.configPath}`);
+        if (section.configOnlyReason)
+            lines.push(`Note: ${section.configOnlyReason}`);
+        if (section.vendorCommand)
+            lines.push(`Command: ${section.vendorCommand}`);
+        lines.push(section.snippet);
+        lines.push(`Docs: ${section.docsUrl} (verified ${section.verifiedAt})`);
+    }
+    return { text: lines.join('\n'), json: { scope, clients: sections }, exitCode: 0 };
+}
+function formatDetectionEvidence(entry) {
+    if (entry.evidence === 'none')
+        return 'not detected';
+    const parts = [];
+    if (entry.executablePath)
+        parts.push(`executable ${entry.executablePath}`);
+    if (entry.configPaths.length > 0)
+        parts.push(`config ${entry.configPaths[0]}`);
+    return `${entry.evidence} (${parts.join(', ')})`;
+}
+function renderResultLine(result) {
+    return `- ${result.clientId} [${result.outcome}] ${result.detail}`;
+}
+function summarize(results) {
+    return {
+        applied: results.filter((r) => r.outcome === 'INSTALLED' || r.outcome === 'ALREADY_REGISTERED').length,
+        skipped: results.filter((r) => r.outcome === 'SKIPPED_CONFIG_ONLY' || r.outcome === 'SKIPPED_NOT_DETECTED').length,
+        failed: results.filter((r) => r.outcome === 'FAILED').length,
+    };
+}
+const USER_SCOPE_BINDING_WARNING = 'Warning: a user-scope registration is machine-wide. If this client already has an "agentteams" server pointing at a different AgentTeams project, applying this plan re-points it.';
+/**
+ * `install` has two modes:
+ *  - `--client <id>`: apply a single client/scope (project scope allowed here).
+ *  - no `--client`: detect local clients and print the plan. Only `--yes` turns
+ *    that plan into writes, and only at user scope.
+ */
+export function runMcpInstallCommand(options, dependencies) {
+    const credentials = resolveCredentials(options, dependencies);
+    const context = resolvePathContext(dependencies?.context);
+    const scope = parseScope(options.scope);
+    if (options.client) {
+        const client = findClient(parseClientId(options.client));
+        if (!client)
+            throw new Error(`Unknown client: ${options.client}`);
+        const result = installClient({
+            client,
+            scope,
+            credentials,
+            context,
+            serverEntry: options.serverEntry,
+            vendorRunner: dependencies?.vendorRunner,
+        });
+        const lines = [
+            `AgentTeams MCP install — ${client.label} (${scope} scope)`,
+            `Project ${credentials.projectId}, team ${credentials.teamId}`,
+        ];
+        if (scope === 'user')
+            lines.push(USER_SCOPE_BINDING_WARNING);
+        lines.push(renderResultLine(result));
+        if (result.backupPath)
+            lines.push(`Backup: ${result.backupPath}`);
+        if (result.manualSnippet) {
+            lines.push('Manual fallback:');
+            lines.push(result.manualSnippet);
+        }
+        return {
+            text: lines.join('\n'),
+            json: { scope, results: [result], summary: summarize([result]) },
+            exitCode: resolveInstallExitCode([result]),
+        };
+    }
+    if (scope === 'project') {
+        throw new Error('Batch install does not support --scope project: project files are repository state and must be chosen per client. Re-run with --client <id> --scope project.');
+    }
+    if (!options.yes) {
+        const plan = buildBatchPlan({
+            context,
+            credentials,
+            detectionDependencies: dependencies?.detectionDependencies,
+        });
+        const lines = [
+            'AgentTeams MCP install — dry run (no files were changed)',
+            `Plan: register "${MCP_SERVER_NAME}" at user scope for project ${plan.binding.projectId}, team ${plan.binding.teamId}`,
+            USER_SCOPE_BINDING_WARNING,
+            '',
+        ];
+        for (const entry of plan.entries) {
+            lines.push(`- ${entry.clientId} [${entry.applicable ? 'will apply' : 'skip'}] ${formatDetectionEvidence(entry)}`);
+            lines.push(`    target: ${entry.targetPath} via ${entry.strategy}`);
+            if (entry.reason)
+                lines.push(`    reason: ${entry.reason}`);
+        }
+        lines.push('');
+        lines.push('Re-run with --yes to apply, or use `agentteams mcp config --client <id>` for a manual snippet.');
+        return { text: lines.join('\n'), json: { scope: 'user', dryRun: true, plan }, exitCode: 0 };
+    }
+    const { plan, results } = runBatchInstall({
+        context,
+        credentials,
+        serverEntry: options.serverEntry,
+        vendorRunner: dependencies?.vendorRunner,
+        detectionDependencies: dependencies?.detectionDependencies,
+    });
+    const summary = summarize(results);
+    const lines = [
+        `AgentTeams MCP install — applied at user scope for project ${plan.binding.projectId}, team ${plan.binding.teamId}`,
+        ...results.map(renderResultLine),
+        '',
+        `Summary: ${summary.applied} registered, ${summary.skipped} skipped, ${summary.failed} failed.`,
+    ];
+    return {
+        text: lines.join('\n'),
+        json: { scope: 'user', dryRun: false, plan, results, summary },
+        exitCode: resolveInstallExitCode(results),
+    };
+}
+//# sourceMappingURL=index.js.map