@agentteams/cli 0.1.76 → 0.1.78

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-registration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,+BAA+B,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAe,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AACtH,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAuB,MAAM,iBAAiB,CAAC;AAIxF,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;AAExF,cAAc,YAAY,CAAC;AAE3B,MAAM,kBAAkB,GAAG,aAAa,EAAE,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,CAAC;AA2B9B,SAAS,kBAAkB,CACzB,OAAsC,EACtC,YAA0C;IAE1C,IAAI,YAAY,EAAE,WAAW;QAAE,OAAO,YAAY,CAAC,WAAW,CAAC;IAE/D,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,OAAkC,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,EAAE,CAAC,CAAC;IAChE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAmC;IAC7D,OAAO;QACL,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,OAAO,EAAE;QACxC,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACpC,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC;IACzE,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAsC,EACtC,YAA0C;IAE1C,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAExF,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzG,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK;YACL,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC;YAC1C,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC;YAClE,aAAa,EAAE,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC;YAC5E,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,IAAI,IAAI;SACtD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa;QACtB,0BAA0B,KAAK,qBAAqB,WAAW,CAAC,SAAS,UAAU,WAAW,CAAC,MAAM,EAAE;QACvG,sIAAsI;KACvI,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,gBAAgB;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC9E,IAAI,OAAO,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,OAAO,cAAc,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAmC;IAClE,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO,cAAc,CAAC;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,GAAG,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAqB;IAC7C,OAAO,KAAK,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,SAAS,CAAC,OAAwB;IACzC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,KAAK,oBAAoB,CAAC,CAAC,MAAM;QACtG,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,qBAAqB,IAAI,CAAC,CAAC,OAAO,KAAK,sBAAsB,CAAC,CAAC,MAAM;QAClH,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,MAAM;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,0BAA0B,GAC9B,oLAAoL,CAAC;AAEvL;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsC,EACtC,YAA0C;IAE1C,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,aAAa,CAAC;YAC3B,MAAM;YACN,KAAK;YACL,WAAW;YACX,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,YAAY,EAAE,YAAY;SACzC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,4BAA4B,MAAM,CAAC,KAAK,KAAK,KAAK,SAAS;YAC3D,WAAW,WAAW,CAAC,SAAS,UAAU,WAAW,CAAC,MAAM,EAAE;SAC/D,CAAC;QACF,IAAI,KAAK,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QAED,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE;YAChE,QAAQ,EAAE,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,8JAA8J,CAC/J,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,cAAc,CAAC;YAC1B,OAAO;YACP,WAAW;YACX,qBAAqB,EAAE,YAAY,EAAE,qBAAqB;SAC3D,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,0DAA0D;YAC1D,mBAAmB,eAAe,+BAA+B,IAAI,CAAC,OAAO,CAAC,SAAS,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YACtH,0BAA0B;YAC1B,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,KAAK,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClH,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gGAAgG,CAAC,CAAC;QAE7G,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC9F,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC;QACxC,OAAO;QACP,WAAW;QACX,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,YAAY,EAAE,YAAY;QACxC,qBAAqB,EAAE,YAAY,EAAE,qBAAqB;KAC3D,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG;QACZ,8DAA8D,IAAI,CAAC,OAAO,CAAC,SAAS,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;QACnH,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAChC,EAAE;QACF,YAAY,OAAO,CAAC,OAAO,gBAAgB,OAAO,CAAC,OAAO,aAAa,OAAO,CAAC,MAAM,UAAU;KAChG,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QAC9D,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC;KAC1C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,66 @@
+import { type DetectionDependencies } from './detect.js';
+import { renderConfigSnippet, renderVendorCommandLine } from './render.js';
+import { type McpCredentials } from './serverSpec.js';
+import type { DetectionSignal, InstallResult, McpClientDefinition, McpPathContext, McpScope } from './types.js';
+import { type VendorRunner } from './vendorCommand.js';
+export interface InstallClientOptions {
+    client: McpClientDefinition;
+    scope: McpScope;
+    credentials: McpCredentials;
+    context: McpPathContext;
+    serverEntry?: string;
+    serverName?: string;
+    vendorRunner?: VendorRunner;
+}
+/** Apply (or explicitly decline to apply) the AgentTeams entry for one client/scope. */
+export declare function installClient(options: InstallClientOptions): InstallResult;
+export interface BatchPlanEntry {
+    clientId: McpClientDefinition['id'];
+    label: string;
+    evidence: DetectionSignal['evidence'];
+    executablePath: string | null;
+    configPaths: string[];
+    scope: McpScope;
+    strategy: McpClientDefinition['scopes'][McpScope]['strategy'];
+    targetPath: string;
+    applicable: boolean;
+    reason?: string;
+}
+export interface BatchPlan {
+    scope: McpScope;
+    entries: BatchPlanEntry[];
+    /** A single user-scope registration binds the client to one AgentTeams project. */
+    binding: {
+        projectId: string;
+        teamId: string;
+    };
+}
+export interface BuildBatchPlanOptions {
+    context: McpPathContext;
+    credentials: McpCredentials;
+    detection?: DetectionSignal[];
+    detectionDependencies?: Omit<DetectionDependencies, 'context'>;
+}
+/**
+ * Detection plan for the no-argument `install`. Nothing here touches the
+ * filesystem — the caller prints it and stops unless `--yes` was passed.
+ */
+export declare function buildBatchPlan(options: BuildBatchPlanOptions): BatchPlan;
+export interface RunBatchInstallOptions extends BuildBatchPlanOptions {
+    serverEntry?: string;
+    serverName?: string;
+    vendorRunner?: VendorRunner;
+}
+/**
+ * Apply the plan client by client. One client's failure must not strand the
+ * rest, so every entry is attempted and the caller derives the exit code from
+ * the collected outcomes.
+ */
+export declare function runBatchInstall(options: RunBatchInstallOptions): {
+    plan: BatchPlan;
+    results: InstallResult[];
+};
+/** Non-zero exit only for real failures; "config only" and "not detected" are expected states. */
+export declare function resolveInstallExitCode(results: InstallResult[]): number;
+export { renderConfigSnippet, renderVendorCommandLine };
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/mcp-registration/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAkC,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AA4JD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA8B1E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACtC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,mFAAmF;IACnF,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,cAAc,CAAC;IAC5B,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,qBAAqB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAiCxE;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,CAkC9G;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAEvE;AAED,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/mcp-registration/install.js

@@ -0,0 +1,244 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { PROJECT_SCOPE_FILE_MODE, USER_SCOPE_FILE_MODE, writeConfigFileAtomically } from './atomicWrite.js';
+import { findClient, MCP_CLIENTS } from './clients.js';
+import { detectClients } from './detect.js';
+import { McpConfigParseError, upsertContainerEntry } from './jsonc.js';
+import { buildEntryValue, redactSecrets, renderConfigSnippet, renderVendorCommandLine } from './render.js';
+import { buildServerSpec, MCP_SERVER_NAME } from './serverSpec.js';
+import { runVendorCommand } from './vendorCommand.js';
+function firstLines(text, limit = 4) {
+    return text
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .slice(0, limit)
+        .join(' / ');
+}
+function installViaVendorCommand(options, configPath, manualSnippet) {
+    const { client, scope, context } = options;
+    const serverName = options.serverName ?? MCP_SERVER_NAME;
+    const definition = client.scopes[scope];
+    const vendor = definition.vendor;
+    if (!vendor)
+        throw new Error(`No vendor command configured for ${client.id}/${scope}`);
+    const spec = buildServerSpec({
+        credentials: options.credentials,
+        secretMode: scope === 'user' ? 'literal' : 'reference',
+        serverEntry: options.serverEntry,
+    });
+    const executable = client.executables[0];
+    const runner = options.vendorRunner ?? runVendorCommand;
+    const outcome = runner(executable, vendor.buildArgs(spec, serverName), { cwd: context.cwd, env: context.env });
+    const base = { clientId: client.id, scope, strategy: definition.strategy, configPath };
+    if (outcome.spawnError) {
+        return {
+            ...base,
+            outcome: 'FAILED',
+            detail: `Could not run \`${executable}\`: ${outcome.spawnError}`,
+            manualSnippet,
+        };
+    }
+    // Vendor CLIs echo their own argv on failure, and user-scope argv carries the
+    // API key, so nothing reaches the caller before passing through redaction.
+    const combined = redactSecrets(`${outcome.stdout}\n${outcome.stderr}`, [options.credentials.apiKey]);
+    const alreadyRegistered = (vendor.alreadyRegisteredPatterns ?? []).some((pattern) => pattern.test(combined));
+    if (alreadyRegistered) {
+        return {
+            ...base,
+            outcome: 'ALREADY_REGISTERED',
+            detail: `\`${executable}\` reports "${serverName}" is already registered and refuses to overwrite it. Remove it with the client's own \`mcp remove\` command and re-run, or apply the snippet manually.`,
+            manualSnippet,
+        };
+    }
+    if (outcome.status === 0) {
+        return {
+            ...base,
+            outcome: 'INSTALLED',
+            detail: vendor.rerunBehavior === 'update'
+                ? `Registered "${serverName}" via \`${executable} mcp add\` (re-running updates the entry in place).`
+                : `Registered "${serverName}" via \`${executable} mcp add\`.`,
+        };
+    }
+    return {
+        ...base,
+        outcome: 'FAILED',
+        detail: `\`${executable} mcp add\` exited with code ${String(outcome.status)}: ${firstLines(combined) || 'no output'}`,
+        manualSnippet,
+    };
+}
+function installViaJsonMerge(options, configPath, manualSnippet) {
+    const { client, scope } = options;
+    const serverName = options.serverName ?? MCP_SERVER_NAME;
+    const definition = client.scopes[scope];
+    const containerKey = definition.containerKey;
+    if (!containerKey)
+        throw new Error(`No container key configured for ${client.id}/${scope}`);
+    const base = { clientId: client.id, scope, strategy: definition.strategy, configPath };
+    const spec = buildServerSpec({
+        credentials: options.credentials,
+        // Project files are committable, so they never receive a literal key.
+        secretMode: scope === 'user' ? 'literal' : 'reference',
+        serverEntry: options.serverEntry,
+    });
+    let source = '';
+    if (existsSync(configPath)) {
+        try {
+            source = readFileSync(configPath, 'utf-8');
+        }
+        catch (error) {
+            return {
+                ...base,
+                outcome: 'FAILED',
+                detail: `Could not read ${configPath}: ${error instanceof Error ? error.message : String(error)}`,
+                manualSnippet,
+            };
+        }
+    }
+    let edited;
+    try {
+        edited = upsertContainerEntry(source, {
+            containerKey,
+            entryKey: serverName,
+            entryValue: buildEntryValue(definition.entryShape ?? 'plain', spec, client.secretReference),
+        });
+    }
+    catch (error) {
+        const reason = error instanceof McpConfigParseError ? error.message : String(error);
+        return {
+            ...base,
+            outcome: 'FAILED',
+            detail: `${configPath} could not be parsed (${reason}). The file was left unchanged — fix it or apply the snippet manually.`,
+            manualSnippet,
+        };
+    }
+    if (edited.unchanged) {
+        return {
+            ...base,
+            outcome: 'ALREADY_REGISTERED',
+            detail: `"${serverName}" is already present in ${configPath} with identical settings; nothing was written.`,
+        };
+    }
+    try {
+        const written = writeConfigFileAtomically(configPath, edited.text, scope === 'user' ? USER_SCOPE_FILE_MODE : PROJECT_SCOPE_FILE_MODE, scope === 'user' ? USER_SCOPE_FILE_MODE : undefined);
+        return {
+            ...base,
+            outcome: 'INSTALLED',
+            detail: edited.existed
+                ? `Updated the "${serverName}" entry in ${configPath}.`
+                : `Added "${serverName}" to ${configPath}.`,
+            backupPath: written.backupPath ?? undefined,
+        };
+    }
+    catch (error) {
+        return {
+            ...base,
+            outcome: 'FAILED',
+            detail: `Could not write ${configPath}: ${error instanceof Error ? error.message : String(error)}. The original file was left unchanged.`,
+            manualSnippet,
+        };
+    }
+}
+/** Apply (or explicitly decline to apply) the AgentTeams entry for one client/scope. */
+export function installClient(options) {
+    const { client, scope } = options;
+    const serverName = options.serverName ?? MCP_SERVER_NAME;
+    const definition = client.scopes[scope];
+    const configPath = definition.configPath(options.context);
+    const displaySpec = buildServerSpec({
+        credentials: options.credentials,
+        secretMode: 'reference',
+        serverEntry: options.serverEntry,
+    });
+    const manualSnippet = renderConfigSnippet(client, scope, displaySpec, serverName);
+    if (definition.strategy === 'configOnly') {
+        return {
+            clientId: client.id,
+            scope,
+            strategy: 'configOnly',
+            configPath,
+            outcome: 'SKIPPED_CONFIG_ONLY',
+            detail: definition.configOnlyReason ?? 'No safe automated write path for this client/scope.',
+            manualSnippet,
+        };
+    }
+    if (definition.strategy === 'vendorCommand') {
+        return installViaVendorCommand(options, configPath, manualSnippet);
+    }
+    return installViaJsonMerge(options, configPath, manualSnippet);
+}
+/**
+ * Detection plan for the no-argument `install`. Nothing here touches the
+ * filesystem — the caller prints it and stops unless `--yes` was passed.
+ */
+export function buildBatchPlan(options) {
+    const detection = options.detection ?? detectClients({ context: options.context, ...(options.detectionDependencies ?? {}) });
+    const entries = MCP_CLIENTS.map((client) => {
+        const signal = detection.find((candidate) => candidate.clientId === client.id);
+        const definition = client.scopes.user;
+        const detected = signal?.detected ?? false;
+        const applicable = detected && definition.strategy !== 'configOnly';
+        let reason;
+        if (!detected)
+            reason = 'Not detected on this machine.';
+        else if (definition.strategy === 'configOnly')
+            reason = definition.configOnlyReason;
+        return {
+            clientId: client.id,
+            label: client.label,
+            evidence: signal?.evidence ?? 'none',
+            executablePath: signal?.executablePath ?? null,
+            configPaths: signal?.configPaths ?? [],
+            scope: 'user',
+            strategy: definition.strategy,
+            targetPath: definition.configPath(options.context),
+            applicable,
+            reason,
+        };
+    });
+    return {
+        scope: 'user',
+        entries,
+        binding: { projectId: options.credentials.projectId, teamId: options.credentials.teamId },
+    };
+}
+/**
+ * Apply the plan client by client. One client's failure must not strand the
+ * rest, so every entry is attempted and the caller derives the exit code from
+ * the collected outcomes.
+ */
+export function runBatchInstall(options) {
+    const plan = buildBatchPlan(options);
+    const results = [];
+    for (const entry of plan.entries) {
+        const client = findClient(entry.clientId);
+        if (!client)
+            continue;
+        if (!entry.applicable) {
+            results.push({
+                clientId: entry.clientId,
+                scope: 'user',
+                strategy: entry.strategy,
+                configPath: entry.targetPath,
+                outcome: entry.strategy === 'configOnly' ? 'SKIPPED_CONFIG_ONLY' : 'SKIPPED_NOT_DETECTED',
+                detail: entry.reason ?? 'Skipped.',
+            });
+            continue;
+        }
+        results.push(installClient({
+            client,
+            scope: 'user',
+            credentials: options.credentials,
+            context: options.context,
+            serverEntry: options.serverEntry,
+            serverName: options.serverName,
+            vendorRunner: options.vendorRunner,
+        }));
+    }
+    return { plan, results };
+}
+/** Non-zero exit only for real failures; "config only" and "not detected" are expected states. */
+export function resolveInstallExitCode(results) {
+    return results.some((result) => result.outcome === 'FAILED') ? 1 : 0;
+}
+export { renderConfigSnippet, renderVendorCommandLine };
+//# sourceMappingURL=install.js.map