@agentteams/cli 0.1.75 → 0.1.77

package/dist/mcp/server.js

@@ -0,0 +1,106 @@
+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 { 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) {
+    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, context);
+                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,20 @@
+import { z } from 'zod';
+import type { McpToolContext } from './context.js';
+export declare const SEARCH_TOOL_NAME = "agentteams_search";
+/**
+ * SDK-agnostic tool description: the handler receives the parsed arguments and
+ * the resolved API context, and returns the upstream payload verbatim. Only the
+ * SDK adapter (`server.ts`) may wrap results into MCP envelopes — domain
+ * handlers must stay free of SDK types so a future SDK upgrade only touches the
+ * adapter.
+ */
+export interface McpToolSpec {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: z.ZodType;
+    handler: (args: Record<string, unknown>, context: McpToolContext) => Promise<unknown>;
+}
+/** 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,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AASpD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvF;AAkKD,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,WAAW,EAAE,CAW5C"}

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