@agentteams/cli 0.1.75 → 0.1.77

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

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

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

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Minimal JSONC reader plus a surgical single-entry editor.
+ *
+ * MCP client config files are user-owned: OpenCode ships `opencode.jsonc`, and
+ * Cursor/Antigravity/Kimi users routinely keep comments and a hand-picked key
+ * order in their `mcp.json`. A `JSON.parse` → `JSON.stringify` round-trip would
+ * silently delete those comments and reorder everything, so writes are done as
+ * a text splice that touches only the AgentTeams entry and leaves every other
+ * byte of the document exactly where it was.
+ */
+export declare class McpConfigParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse JSON with comments and trailing commas. Returns `undefined` for an
+ * empty document — an untouched client config file is frequently zero bytes,
+ * and that is a "create it" signal rather than a corruption signal.
+ */
+export declare function parseJsonc(text: string): unknown;
+export interface UpsertContainerEntryOptions {
+    /** Top-level key holding the server map, e.g. `mcpServers`, `mcp`, `amp.mcpServers`. */
+    containerKey: string;
+    entryKey: string;
+    entryValue: unknown;
+}
+export interface UpsertContainerEntryResult {
+    text: string;
+    /** The entry was already present before this edit. */
+    existed: boolean;
+    /** The entry was already present *and* byte-identical, so nothing was rewritten. */
+    unchanged: boolean;
+}
+/**
+ * Insert or replace `containerKey.entryKey` in a JSON/JSONC document without
+ * reformatting anything else.
+ *
+ * @throws {McpConfigParseError} when the document is not parseable, or when the
+ * root / container is not an object. Callers must treat this as "leave the
+ * user's file untouched" rather than as permission to overwrite it.
+ */
+export declare function upsertContainerEntry(source: string, options: UpsertContainerEntryOptions): UpsertContainerEntryResult;
+/** Read `containerKey.entryKey` from a parsed document, if present. */
+export declare function readContainerEntry(source: string, containerKey: string, entryKey: string): unknown;
+//# sourceMappingURL=jsonc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc.d.ts","sourceRoot":"","sources":["../../src/mcp-registration/jsonc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAqHD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmChD;AAuCD,MAAM,WAAW,2BAA2B;IAC1C,wFAAwF;IACxF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,GAAG,0BAA0B,CAkErH;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMlG"}

package/dist/mcp-registration/jsonc.js

@@ -0,0 +1,266 @@
+/**
+ * Minimal JSONC reader plus a surgical single-entry editor.
+ *
+ * MCP client config files are user-owned: OpenCode ships `opencode.jsonc`, and
+ * Cursor/Antigravity/Kimi users routinely keep comments and a hand-picked key
+ * order in their `mcp.json`. A `JSON.parse` → `JSON.stringify` round-trip would
+ * silently delete those comments and reorder everything, so writes are done as
+ * a text splice that touches only the AgentTeams entry and leaves every other
+ * byte of the document exactly where it was.
+ */
+export class McpConfigParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'McpConfigParseError';
+    }
+}
+const WHITESPACE = new Set([' ', '\t', '\n', '\r']);
+/** Skip whitespace and `//` / block comments starting at `index`. */
+function skipTrivia(text, index) {
+    let i = index;
+    while (i < text.length) {
+        const char = text[i];
+        if (WHITESPACE.has(char)) {
+            i += 1;
+            continue;
+        }
+        if (char === '/' && text[i + 1] === '/') {
+            i += 2;
+            while (i < text.length && text[i] !== '\n')
+                i += 1;
+            continue;
+        }
+        if (char === '/' && text[i + 1] === '*') {
+            i += 2;
+            while (i < text.length && !(text[i] === '*' && text[i + 1] === '/'))
+                i += 1;
+            i = Math.min(i + 2, text.length);
+            continue;
+        }
+        break;
+    }
+    return i;
+}
+function scanString(text, index) {
+    let i = index + 1;
+    while (i < text.length) {
+        const char = text[i];
+        if (char === '\\') {
+            i += 2;
+            continue;
+        }
+        if (char === '"')
+            return i + 1;
+        i += 1;
+    }
+    throw new McpConfigParseError('Unterminated string literal');
+}
+/** Return the index just past the value that starts at (or after) `index`. */
+function scanValue(text, index) {
+    const start = skipTrivia(text, index);
+    const char = text[start];
+    if (char === undefined)
+        throw new McpConfigParseError('Unexpected end of input');
+    if (char === '"')
+        return scanString(text, start);
+    if (char === '{' || char === '[') {
+        const close = char === '{' ? '}' : ']';
+        let depth = 0;
+        let i = start;
+        while (i < text.length) {
+            const current = text[i];
+            if (current === '"') {
+                i = scanString(text, i);
+                continue;
+            }
+            if (current === '/' && (text[i + 1] === '/' || text[i + 1] === '*')) {
+                i = skipTrivia(text, i);
+                continue;
+            }
+            if (current === char)
+                depth += 1;
+            else if (current === close) {
+                depth -= 1;
+                if (depth === 0)
+                    return i + 1;
+            }
+            i += 1;
+        }
+        throw new McpConfigParseError('Unterminated object or array');
+    }
+    let i = start;
+    while (i < text.length && !WHITESPACE.has(text[i]) && text[i] !== ',' && text[i] !== '}' && text[i] !== ']') {
+        i += 1;
+    }
+    if (i === start)
+        throw new McpConfigParseError(`Unexpected token "${char}"`);
+    return i;
+}
+/** List the direct members of the object whose `{` sits at `objectStart`. */
+function listMembers(text, objectStart) {
+    const members = [];
+    let i = skipTrivia(text, objectStart + 1);
+    while (i < text.length && text[i] !== '}') {
+        if (text[i] === ',') {
+            i = skipTrivia(text, i + 1);
+            continue;
+        }
+        if (text[i] !== '"')
+            throw new McpConfigParseError('Expected a quoted object key');
+        const keyStart = i;
+        const keyEnd = scanString(text, i);
+        const key = JSON.parse(text.slice(keyStart, keyEnd));
+        const colon = skipTrivia(text, keyEnd);
+        if (text[colon] !== ':')
+            throw new McpConfigParseError(`Expected ":" after object key "${key}"`);
+        const valueStart = skipTrivia(text, colon + 1);
+        const valueEnd = scanValue(text, valueStart);
+        members.push({ key, keyStart, valueStart, valueEnd });
+        i = skipTrivia(text, valueEnd);
+    }
+    return members;
+}
+/**
+ * Parse JSON with comments and trailing commas. Returns `undefined` for an
+ * empty document — an untouched client config file is frequently zero bytes,
+ * and that is a "create it" signal rather than a corruption signal.
+ */
+export function parseJsonc(text) {
+    if (text.trim().length === 0)
+        return undefined;
+    let normalized = '';
+    let i = 0;
+    while (i < text.length) {
+        const char = text[i];
+        if (char === '"') {
+            const end = scanString(text, i);
+            normalized += text.slice(i, end);
+            i = end;
+            continue;
+        }
+        if (char === '/' && (text[i + 1] === '/' || text[i + 1] === '*')) {
+            normalized += ' ';
+            i = skipTrivia(text, i);
+            continue;
+        }
+        if (char === ',') {
+            const next = skipTrivia(text, i + 1);
+            if (text[next] === '}' || text[next] === ']') {
+                normalized += ' ';
+                i += 1;
+                continue;
+            }
+        }
+        normalized += char;
+        i += 1;
+    }
+    try {
+        return JSON.parse(normalized);
+    }
+    catch (error) {
+        throw new McpConfigParseError(error instanceof Error ? error.message : String(error));
+    }
+}
+function detectIndentUnit(text) {
+    const match = /\n([ \t]+)\S/.exec(text);
+    return match ? match[1] : '  ';
+}
+function lineIndentOf(text, index) {
+    const lineStart = text.lastIndexOf('\n', index) + 1;
+    const match = /^[ \t]*/.exec(text.slice(lineStart, index));
+    return match ? match[0] : '';
+}
+function serializeValue(value, indentUnit, baseIndent) {
+    const json = JSON.stringify(value, null, indentUnit);
+    return json
+        .split('\n')
+        .map((line, lineIndex) => (lineIndex === 0 ? line : `${baseIndent}${line}`))
+        .join('\n');
+}
+function appendMember(text, objectStart, memberText, memberIndent) {
+    const objectEnd = scanValue(text, objectStart) - 1;
+    const members = listMembers(text, objectStart);
+    if (members.length === 0) {
+        const closingIndent = lineIndentOf(text, objectStart);
+        return `${text.slice(0, objectStart + 1)}\n${memberIndent}${memberText}\n${closingIndent}${text.slice(objectEnd)}`;
+    }
+    const last = members[members.length - 1];
+    const afterLast = skipTrivia(text, last.valueEnd);
+    const hasTrailingComma = text[afterLast] === ',';
+    const insertAt = hasTrailingComma ? afterLast + 1 : last.valueEnd;
+    const separator = hasTrailingComma ? '' : ',';
+    return `${text.slice(0, insertAt)}${separator}\n${memberIndent}${memberText}${text.slice(insertAt)}`;
+}
+/**
+ * Insert or replace `containerKey.entryKey` in a JSON/JSONC document without
+ * reformatting anything else.
+ *
+ * @throws {McpConfigParseError} when the document is not parseable, or when the
+ * root / container is not an object. Callers must treat this as "leave the
+ * user's file untouched" rather than as permission to overwrite it.
+ */
+export function upsertContainerEntry(source, options) {
+    const { containerKey, entryKey, entryValue } = options;
+    const indentUnit = detectIndentUnit(source);
+    if (source.trim().length === 0) {
+        const entry = serializeValue(entryValue, indentUnit, indentUnit.repeat(2));
+        const text = `{\n${indentUnit}${JSON.stringify(containerKey)}: {\n` +
+            `${indentUnit.repeat(2)}${JSON.stringify(entryKey)}: ${entry}\n` +
+            `${indentUnit}}\n}\n`;
+        return { text, existed: false, unchanged: false };
+    }
+    // Validate before splicing: a corrupt document must fail loudly here so the
+    // caller can preserve the original instead of writing a half-repaired file.
+    parseJsonc(source);
+    const rootStart = skipTrivia(source, 0);
+    if (source[rootStart] !== '{') {
+        throw new McpConfigParseError('The top-level value must be an object');
+    }
+    const container = listMembers(source, rootStart).find((member) => member.key === containerKey);
+    if (!container) {
+        const memberIndent = lineIndentOf(source, rootStart) + indentUnit;
+        const entry = serializeValue(entryValue, indentUnit, `${memberIndent}${indentUnit}`);
+        const memberText = `${JSON.stringify(containerKey)}: {\n` +
+            `${memberIndent}${indentUnit}${JSON.stringify(entryKey)}: ${entry}\n` +
+            `${memberIndent}}`;
+        return { text: appendMember(source, rootStart, memberText, memberIndent), existed: false, unchanged: false };
+    }
+    if (source[container.valueStart] !== '{') {
+        throw new McpConfigParseError(`"${containerKey}" exists but is not an object`);
+    }
+    const entries = listMembers(source, container.valueStart);
+    const existing = entries.find((member) => member.key === entryKey);
+    if (existing) {
+        const baseIndent = lineIndentOf(source, existing.keyStart);
+        const entry = serializeValue(entryValue, indentUnit, baseIndent);
+        if (source.slice(existing.valueStart, existing.valueEnd) === entry) {
+            return { text: source, existed: true, unchanged: true };
+        }
+        return {
+            text: `${source.slice(0, existing.valueStart)}${entry}${source.slice(existing.valueEnd)}`,
+            existed: true,
+            unchanged: false,
+        };
+    }
+    const memberIndent = entries.length > 0
+        ? lineIndentOf(source, entries[0].keyStart)
+        : lineIndentOf(source, container.keyStart) + indentUnit;
+    const entry = serializeValue(entryValue, indentUnit, memberIndent);
+    const memberText = `${JSON.stringify(entryKey)}: ${entry}`;
+    return {
+        text: appendMember(source, container.valueStart, memberText, memberIndent),
+        existed: false,
+        unchanged: false,
+    };
+}
+/** Read `containerKey.entryKey` from a parsed document, if present. */
+export function readContainerEntry(source, containerKey, entryKey) {
+    const parsed = parseJsonc(source);
+    if (parsed === undefined || parsed === null || typeof parsed !== 'object')
+        return undefined;
+    const container = parsed[containerKey];
+    if (container === null || typeof container !== 'object')
+        return undefined;
+    return container[entryKey];
+}
+//# sourceMappingURL=jsonc.js.map