@agentteams/cli 0.1.76 → 0.1.78

package/dist/mcp/server.js

@@ -0,0 +1,107 @@
+import { createRequire } from 'node:module';
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/server';
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
+import { handleError } from '../utils/errors.js';
+import { resolveMcpToolContext } from './context.js';
+import { getResourceSpecs } from './resources.js';
+import { createCliContextToolsClient, getToolSpecs } from './tools.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+export const MCP_SERVER_NAME = '@agentteams/cli';
+/**
+ * Build one MCP server instance. `serveStdio` calls this per connection (and
+ * per discarded `server/discover` probe), so it must stay side-effect free
+ * apart from stderr diagnostics.
+ *
+ * This module is the only place allowed to import the MCP SDK or assemble MCP
+ * response envelopes: domain handlers stay SDK-agnostic so upgrading the
+ * pinned beta only touches this adapter.
+ */
+export function createMcpServer(context, version = pkg.version) {
+    // Read-only surface: tools plus single-entity resource templates. Prompts
+    // and Extensions stay out of scope for Phase 1.
+    const server = new McpServer({ name: MCP_SERVER_NAME, version }, { capabilities: { tools: {}, resources: {} } });
+    registerTools(server, context);
+    registerResources(server, context);
+    return server;
+}
+/** The single `registerTool` loop — tool envelopes are assembled only here. */
+function registerTools(server, context) {
+    const client = createCliContextToolsClient(context);
+    for (const spec of getToolSpecs()) {
+        server.registerTool(spec.name, {
+            title: spec.title,
+            description: spec.description,
+            inputSchema: spec.inputSchema,
+        }, async (args) => {
+            try {
+                // The SDK has already validated `args` against `spec.inputSchema`
+                // before this callback runs, so the record cast is safe.
+                const result = await spec.handler(args, client);
+                return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+            }
+            catch (error) {
+                // API failures are reported as a tool error so the connection survives.
+                return {
+                    content: [{ type: 'text', text: handleError(error, { apiUrl: context.apiUrl }) }],
+                    isError: true,
+                };
+            }
+        });
+    }
+}
+/**
+ * The single `registerResource` loop — resource envelopes and JSON-RPC error
+ * mapping live only here. Every template hides enumeration (`list: undefined`):
+ * entity listing is the search/list tools' job, and a full dump would be
+ * unbounded.
+ */
+function registerResources(server, context) {
+    for (const spec of getResourceSpecs()) {
+        server.registerResource(spec.name, new ResourceTemplate(spec.uriTemplate, { list: undefined }), {
+            title: spec.title,
+            description: spec.description,
+            mimeType: 'application/json',
+        }, async (uri, variables) => {
+            try {
+                const result = await spec.handler(normalizeVariables(variables), context);
+                return {
+                    contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(result) }],
+                };
+            }
+            catch (error) {
+                // Unlike tools (isError envelope), resource failures surface as
+                // JSON-RPC errors: rethrow with the translated message and let the
+                // SDK build the error frame — the connection itself survives.
+                throw new Error(handleError(error, { apiUrl: context.apiUrl }));
+            }
+        });
+    }
+}
+/** The SDK hands template variables as `string | string[]`; specs expect plain strings. */
+function normalizeVariables(variables) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(variables)) {
+        normalized[key] = Array.isArray(value) ? (value[0] ?? '') : value;
+    }
+    return normalized;
+}
+/**
+ * Start the stdio MCP server. stdout is reserved for JSON-RPC frames, so every
+ * diagnostic goes to stderr.
+ */
+export function startMcpServer(options = {}) {
+    const context = resolveMcpToolContext(options);
+    writeDiagnostic(`serving stdio (cli ${pkg.version}) apiUrl=${context.apiUrl} projectId=${context.projectId}`);
+    return serveStdio((ctx) => {
+        // The era tells us whether the client negotiated the modern
+        // (`server/discover`) or legacy (`initialize`) revision — the key
+        // observation this spike has to record.
+        writeDiagnostic(`connection era=${ctx.era}`);
+        return createMcpServer(context);
+    });
+}
+function writeDiagnostic(message) {
+    process.stderr.write(`[agentteams mcp] ${message}\n`);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,12 @@
+import { SEARCH_TOOL_NAME, type ContextToolsClient, type ContextToolSpec } from '@agentteams/context-tools';
+import type { McpToolContext } from './context.js';
+export { SEARCH_TOOL_NAME };
+export type McpToolSpec = ContextToolSpec;
+/**
+ * Bind the transport-independent context-tool contract to the CLI's existing
+ * authenticated HTTP functions. MCP envelopes remain in server.ts.
+ */
+export declare function createCliContextToolsClient(context: McpToolContext): ContextToolsClient;
+/** Every tool the MCP server exposes, in registration order. */
+export declare function getToolSpecs(): McpToolSpec[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAEhB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAUnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAe1C;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CA0BvF;AAED,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAE5C"}

package/dist/mcp/tools.js

@@ -0,0 +1,54 @@
+import { getContextToolSpecs, SEARCH_TOOL_NAME, } from '@agentteams/context-tools';
+import { getCoAction, listCoActions } from '../api/coaction.js';
+import { getCodeReview, getCodeReviewFinding, listCodeReviews } from '../api/codeReview.js';
+import { getComment, listComments, listFindingComments, listTaskComments } from '../api/comment.js';
+import { getConvention, listConventions } from '../api/convention.js';
+import { getDocument, listDocuments } from '../api/document.js';
+import { getPlanRunbook, listPlans } from '../api/plan.js';
+import { getPostMortem, listPostMortems } from '../api/postmortem.js';
+import { getReport, listReports } from '../api/report.js';
+import { searchEntities } from '../api/search.js';
+export { SEARCH_TOOL_NAME };
+function scalarListParams(params) {
+    return params;
+}
+function documentListParams(params) {
+    return {
+        ...params,
+        ...(Array.isArray(params.tags) ? { tags: params.tags.join(',') } : {}),
+    };
+}
+/**
+ * Bind the transport-independent context-tool contract to the CLI's existing
+ * authenticated HTTP functions. MCP envelopes remain in server.ts.
+ */
+export function createCliContextToolsClient(context) {
+    const { apiUrl, projectId, headers } = context;
+    return {
+        search: (params) => searchEntities(apiUrl, projectId, headers, params),
+        listPlans: (params) => listPlans(apiUrl, projectId, headers, scalarListParams(params)),
+        getPlan: (id) => getPlanRunbook(apiUrl, projectId, headers, id),
+        listCompletionReports: (params) => listReports(apiUrl, projectId, headers, scalarListParams(params)),
+        getCompletionReport: (id) => getReport(apiUrl, projectId, headers, id),
+        listCoActions: (params) => listCoActions(apiUrl, projectId, headers, scalarListParams(params)),
+        getCoAction: (id) => getCoAction(apiUrl, projectId, headers, id),
+        listPostMortems: (params) => listPostMortems(apiUrl, projectId, headers, scalarListParams(params)),
+        getPostMortem: (id) => getPostMortem(apiUrl, projectId, headers, id),
+        listDocuments: (params) => listDocuments(apiUrl, projectId, headers, documentListParams(params)),
+        getDocument: (id) => getDocument(apiUrl, projectId, headers, id),
+        listConventions: (params) => listConventions(apiUrl, projectId, headers, scalarListParams(params)),
+        getConvention: (id) => getConvention(apiUrl, projectId, headers, id),
+        listCodeReviews: (params) => listCodeReviews(apiUrl, projectId, headers, scalarListParams(params)),
+        getCodeReview: (id) => getCodeReview(apiUrl, projectId, headers, id),
+        listComments: (planId, params) => listComments(apiUrl, projectId, headers, planId, scalarListParams(params)),
+        listFindingComments: (findingId, params) => listFindingComments(apiUrl, projectId, headers, findingId, scalarListParams(params)),
+        listTaskComments: (taskId, params) => listTaskComments(apiUrl, projectId, headers, taskId, scalarListParams(params)),
+        getComment: (id) => getComment(apiUrl, projectId, headers, id),
+        getCodeReviewFinding: (id, codeReviewId) => getCodeReviewFinding(apiUrl, projectId, headers, id, codeReviewId),
+    };
+}
+/** Every tool the MCP server exposes, in registration order. */
+export function getToolSpecs() {
+    return getContextToolSpecs();
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAK5B,SAAS,gBAAgB,CAAC,MAAyB;IACjD,OAAO,MAA0B,CAAC;AACpC,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAyB;IACnD,OAAO;QACL,GAAG,MAAM;QACT,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAuB;IACjE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;QACtE,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACtF,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,qBAAqB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACpG,mBAAmB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QACtE,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC9F,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClG,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QACpE,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAChG,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClG,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QACpE,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClG,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QACpE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5G,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CACzC,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACtF,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CACnC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChF,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9D,oBAAoB,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,CAAC;KAC/G,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY;IAC1B,OAAO,mBAAmB,EAAE,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Config files written here belong to the user, not to AgentTeams: they hold
+ * other MCP servers, editor preferences and (for user scope) API keys. Every
+ * write therefore goes backup → temp file in the same directory → rename, so a
+ * crash or a full disk can never leave a truncated config behind.
+ */
+/** Suffix is deterministic so `install` twice does not accumulate backup files. */
+export declare const BACKUP_SUFFIX = ".agentteams-backup";
+/** User-scope files can carry a literal API key, so they must not be world-readable. */
+export declare const USER_SCOPE_FILE_MODE = 384;
+export declare const PROJECT_SCOPE_FILE_MODE = 420;
+export interface AtomicWriteResult {
+    path: string;
+    /** Absolute path of the backup, or null when the file did not exist yet. */
+    backupPath: string | null;
+    created: boolean;
+    mode: number;
+}
+/**
+ * Replace `path` with `content` atomically.
+ *
+ * @param targetMode - when present, force the replacement to this mode while
+ * preserving the original mode on the backup.
+ */
+export declare function writeConfigFileAtomically(path: string, content: string, defaultMode: number, targetMode?: number): AtomicWriteResult;
+//# sourceMappingURL=atomicWrite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atomicWrite.d.ts","sourceRoot":"","sources":["../../src/mcp-registration/atomicWrite.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,mFAAmF;AACnF,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAElD,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,MAAQ,CAAC;AAC1C,eAAO,MAAM,uBAAuB,MAAQ,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAUD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,iBAAiB,CA+BnB"}

package/dist/mcp-registration/atomicWrite.js

@@ -0,0 +1,58 @@
+import { chmodSync, copyFileSync, mkdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * Config files written here belong to the user, not to AgentTeams: they hold
+ * other MCP servers, editor preferences and (for user scope) API keys. Every
+ * write therefore goes backup → temp file in the same directory → rename, so a
+ * crash or a full disk can never leave a truncated config behind.
+ */
+/** Suffix is deterministic so `install` twice does not accumulate backup files. */
+export const BACKUP_SUFFIX = '.agentteams-backup';
+/** User-scope files can carry a literal API key, so they must not be world-readable. */
+export const USER_SCOPE_FILE_MODE = 0o600;
+export const PROJECT_SCOPE_FILE_MODE = 0o644;
+function existingMode(path) {
+    try {
+        return statSync(path).mode & 0o777;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Replace `path` with `content` atomically.
+ *
+ * @param targetMode - when present, force the replacement to this mode while
+ * preserving the original mode on the backup.
+ */
+export function writeConfigFileAtomically(path, content, defaultMode, targetMode) {
+    const directory = dirname(path);
+    mkdirSync(directory, { recursive: true });
+    const previousMode = existingMode(path);
+    const created = previousMode === null;
+    const mode = targetMode ?? previousMode ?? defaultMode;
+    let backupPath = null;
+    if (!created) {
+        backupPath = `${path}${BACKUP_SUFFIX}`;
+        copyFileSync(path, backupPath);
+        chmodSync(backupPath, previousMode ?? defaultMode);
+    }
+    // Same directory as the target: `rename` is only atomic within a filesystem.
+    const temporaryPath = join(directory, `.${Date.now().toString(36)}-${process.pid}.agentteams-tmp`);
+    try {
+        writeFileSync(temporaryPath, content, { encoding: 'utf-8', mode });
+        chmodSync(temporaryPath, mode);
+        renameSync(temporaryPath, path);
+    }
+    catch (error) {
+        try {
+            unlinkSync(temporaryPath);
+        }
+        catch {
+            // The temp file may never have been created; the original is untouched either way.
+        }
+        throw error;
+    }
+    return { path, backupPath, created, mode };
+}
+//# sourceMappingURL=atomicWrite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atomicWrite.js","sourceRoot":"","sources":["../../src/mcp-registration/atomicWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAElD,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAU7C,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,OAAe,EACf,WAAmB,EACnB,UAAmB;IAEnB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,YAAY,KAAK,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,IAAI,YAAY,IAAI,WAAW,CAAC;IAEvD,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,UAAU,GAAG,GAAG,IAAI,GAAG,aAAa,EAAE,CAAC;QACvC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/B,SAAS,CAAC,UAAU,EAAE,YAAY,IAAI,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,6EAA6E;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;IACnG,IAAI,CAAC;QACH,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC/B,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,UAAU,CAAC,aAAa,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;QACrF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { McpClientDefinition, McpClientId } from './types.js';
+export declare const MCP_CLIENTS: McpClientDefinition[];
+export declare function findClient(clientId: string): McpClientDefinition | undefined;
+export declare function listClientIds(): McpClientId[];
+//# sourceMappingURL=clients.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/mcp-registration/clients.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AA+ClG,eAAO,MAAM,WAAW,EAAE,mBAAmB,EA+P5C,CAAC;AAEF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE5E;AAED,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAE7C"}

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":"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"}

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"}