@agentteams/cli 0.1.76 → 0.1.77

package/dist/mcp/tools.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import { getCoAction } from '../api/coaction.js';
+import { getConvention, listConventions } from '../api/convention.js';
+import { getDocument } from '../api/document.js';
+import { getPlanRunbook } from '../api/plan.js';
+import { getPostMortem } from '../api/postmortem.js';
+import { getReport } from '../api/report.js';
+import { searchEntities } from '../api/search.js';
+import { stripEntityIdPrefix } from '../utils/entityId.js';
+import { buildSearchParams, VALID_TYPES } from '../utils/searchParams.js';
+export const SEARCH_TOOL_NAME = 'agentteams_search';
+const SEARCH_TOOL_DESCRIPTION = [
+    'Search AgentTeams entities (plans, co-actions, completion reports, post-mortems, conventions, comments, code reviews, documents) in this project.',
+    'Scope: results are limited to the projectId configured for this CLI — the tool cannot search other projects.',
+    'Truncation: when the token budget trims the response, meta.truncatedByTokenBudget is true; per-item contentTokenCount tells you what fetching the full entity would cost.',
+    'Limitation: under agent API-key authentication the external issue/PR types (GITHUB_ISSUE, GITHUB_PR, GITLAB_ISSUE, GITLAB_MERGE_REQUEST, BITBUCKET_ISSUE, BITBUCKET_PR, LINEAR_ISSUE) always come back empty.',
+].join(' ');
+const searchToolSpec = {
+    name: SEARCH_TOOL_NAME,
+    title: 'Search AgentTeams',
+    description: SEARCH_TOOL_DESCRIPTION,
+    // 1:1 with the backend's searchQuerySchema. Defaults for limit/maxTokens
+    // stay unset so the backend remains the single source of truth.
+    inputSchema: z.object({
+        query: z.string().min(1).describe('Search query'),
+        types: z.array(z.enum(VALID_TYPES)).optional().describe('Entity types to filter by'),
+        limit: z.number().int().min(1).max(100).optional().describe('Max results (backend default: 20)'),
+        maxTokens: z.number().int().min(1).optional().describe('Token budget for the response'),
+    }),
+    // The full payload is passed through verbatim: summarizing away `meta` or
+    // `partialFailures` would let an agent read a truncated or partially failed
+    // search as "no results".
+    handler: async (args, context) => {
+        return searchEntities(context.apiUrl, context.projectId, context.headers, buildSearchParams({
+            query: args.query,
+            types: args.types,
+            limit: args.limit,
+            maxTokens: args.maxTokens,
+        }));
+    },
+};
+/**
+ * Detail-tool factory: `{ id }` in, upstream envelope out — verbatim. The id
+ * accepts both bare uuids and `agentteams_<type>_`-prefixed ids as they appear
+ * in search results and web-UI entity references.
+ */
+function createEntityGetToolSpec(options) {
+    return {
+        name: options.name,
+        title: options.title,
+        description: options.description,
+        inputSchema: z.object({
+            id: z.string().min(1).describe(options.idDescription),
+        }),
+        handler: async (args, context) => {
+            const id = stripEntityIdPrefix(args.id);
+            return options.fetch(context.apiUrl, context.projectId, context.headers, id);
+        },
+    };
+}
+const planGetToolSpec = createEntityGetToolSpec({
+    name: 'agentteams_plan_get',
+    title: 'Get AgentTeams Plan',
+    description: [
+        'Fetch one plan from this project as its full execution runbook: metadata, the complete contentMarkdown body, structured V2 tasks (including dependsOnTaskIds) and progress.',
+        'The upstream payload is returned verbatim — nothing is summarized or omitted.',
+        'Responses can be large, so check contentTokenCount on the agentteams_search result before fetching the full plan.',
+    ].join(' '),
+    idDescription: 'Plan id (bare uuid or agentteams_pln_-prefixed)',
+    fetch: getPlanRunbook,
+});
+const reportGetToolSpec = createEntityGetToolSpec({
+    name: 'agentteams_report_get',
+    title: 'Get AgentTeams Completion Report',
+    description: [
+        'Fetch one completion report from this project, including its full content and metrics.',
+        'The upstream payload is returned verbatim — nothing is summarized or omitted.',
+        'Responses can be large, so check contentTokenCount on the agentteams_search result before fetching the full report.',
+    ].join(' '),
+    idDescription: 'Completion report id (bare uuid or agentteams_rpt_-prefixed)',
+    fetch: getReport,
+});
+const coactionGetToolSpec = createEntityGetToolSpec({
+    name: 'agentteams_coaction_get',
+    title: 'Get AgentTeams Co-Action',
+    description: [
+        'Fetch one co-action (handoff record) from this project, including its full content.',
+        'The upstream payload is returned verbatim — nothing is summarized or omitted.',
+        'Responses can be large, so check contentTokenCount on the agentteams_search result before fetching the full co-action.',
+    ].join(' '),
+    idDescription: 'Co-action id (bare uuid or agentteams_act_-prefixed)',
+    fetch: getCoAction,
+});
+const postmortemGetToolSpec = createEntityGetToolSpec({
+    name: 'agentteams_postmortem_get',
+    title: 'Get AgentTeams Post-Mortem',
+    description: [
+        'Fetch one post-mortem from this project, including its full content.',
+        'The upstream payload is returned verbatim — nothing is summarized or omitted.',
+        'Responses can be large, so check contentTokenCount on the agentteams_search result before fetching the full post-mortem.',
+    ].join(' '),
+    idDescription: 'Post-mortem id (bare uuid or agentteams_pmt_-prefixed)',
+    fetch: getPostMortem,
+});
+const documentGetToolSpec = createEntityGetToolSpec({
+    name: 'agentteams_document_get',
+    title: 'Get AgentTeams Document',
+    description: [
+        'Fetch one document from this project, including its full body.',
+        'The upstream payload is returned verbatim — nothing is summarized or omitted.',
+        'Responses can be large, so check contentTokenCount on the agentteams_search result before fetching the full document.',
+    ].join(' '),
+    idDescription: 'Document id (bare uuid or agentteams_doc_-prefixed)',
+    fetch: getDocument,
+});
+const conventionListToolSpec = {
+    name: 'agentteams_convention_list',
+    title: 'List AgentTeams Conventions',
+    description: [
+        'List the conventions (coding rules, guides, skills) of this project with optional filters and pagination.',
+        'Use agentteams_search to discover relevant conventions; use this tool when you need exact filters or a paginated inventory.',
+        'The paginated data/meta envelope is returned verbatim; list items carry metadata only — fetch the full text with agentteams_convention_get.',
+    ].join(' '),
+    // 1:1 with the backend's conventionQuerySchema (+ paginationQuerySchema);
+    // defaults stay unset so the backend remains the single source of truth.
+    inputSchema: z.object({
+        category: z.string().optional().describe('Filter by category (e.g. rules, skills, guides, references)'),
+        scope: z.enum(['PROJECT', 'PERSONAL']).optional().describe('Filter by convention scope'),
+        archived: z
+            .enum(['ACTIVE', 'ARCHIVED', 'ALL'])
+            .optional()
+            .describe('Filter by archive state (backend default: ACTIVE)'),
+        search: z.string().optional().describe('Keyword filter on title/content'),
+        createdByMemberId: z.string().optional().describe('Filter by creator member id'),
+        page: z.number().int().min(0).optional().describe('Page number (backend default: 1)'),
+        pageSize: z.number().int().min(0).max(100).optional().describe('Page size (backend default: 20)'),
+    }),
+    handler: async (args, context) => {
+        const params = {};
+        for (const key of ['category', 'scope', 'archived', 'search', 'createdByMemberId', 'page', 'pageSize']) {
+            const value = args[key];
+            if (typeof value === 'string' || typeof value === 'number')
+                params[key] = value;
+        }
+        return listConventions(context.apiUrl, context.projectId, context.headers, params);
+    },
+};
+const conventionGetToolSpec = createEntityGetToolSpec({
+    name: 'agentteams_convention_get',
+    title: 'Get AgentTeams Convention',
+    description: [
+        'Fetch one convention from this project, including its full contentMarkdown.',
+        'Pass a convention id from agentteams_search, or use agentteams_convention_list first when you need exact filters.',
+        'The upstream payload is returned verbatim — nothing is summarized or omitted.',
+    ].join(' '),
+    idDescription: 'Convention id (bare uuid or agentteams_cnv_-prefixed)',
+    fetch: getConvention,
+});
+/** Every tool the MCP server exposes, in registration order. */
+export function getToolSpecs() {
+    return [
+        searchToolSpec,
+        planGetToolSpec,
+        reportGetToolSpec,
+        coactionGetToolSpec,
+        postmortemGetToolSpec,
+        documentGetToolSpec,
+        conventionListToolSpec,
+        conventionGetToolSpec,
+    ];
+}
+//# 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":"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"}

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