@ytinnovation/harness-core 0.0.0

package/dist/mcp/command.d.ts

@@ -0,0 +1,19 @@
+import type { CommandRouter } from '../kernel/router.js';
+import { createDefaultMcpToolRegistry } from './tool-registry.js';
+import type { McpJsonSchema } from './types.js';
+interface McpCommandRuntimeOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+declare function renderMcpHelp(programName?: string): string;
+export declare function toMcpListToolsResult(toolRegistry: ReturnType<typeof createDefaultMcpToolRegistry>): {
+    tools: Array<{
+        name: string;
+        description: string;
+        inputSchema: McpJsonSchema;
+    }>;
+};
+export declare function runMcpCommand(args: string[], runtimeOptions?: McpCommandRuntimeOptions): Promise<number>;
+export declare function registerMcpCommand(router: CommandRouter): void;
+export { renderMcpHelp };
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/mcp/command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,UAAU,wBAAwB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,iBAAS,aAAa,CAAC,WAAW,SAAY,GAAG,MAAM,CAiBtD;AAgDD,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,GAC5D;IAAE,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;CAAE,CAQrF;AAkND,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+GlH;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE9D;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/mcp/command.js

@@ -0,0 +1,359 @@
+import { randomUUID } from 'node:crypto';
+import { userInfo } from 'node:os';
+import { basename, resolve } from 'node:path';
+import { resolveHarnessServiceBaseUrl } from '../cloud/harness-service-url.js';
+import { HarnessError } from '../contracts/errors.js';
+import { createGatewayClient } from '../gateway/client.js';
+import { createHarnessServiceGatewayHttpExchange } from '../gateway/service-http-exchange.js';
+import { createGatewayTokenProviderFromExchange } from '../gateway/token-exchange.js';
+import { createHarnessTelemetryEvent, reportHarnessTelemetryEvents } from '../cloud/telemetry-client.js';
+import { listRemoteTopAssets } from '../assets/remote-list.js';
+import { createEnterpriseAssetClient } from '../cloud/enterprise-asset-client.js';
+import { installPublishedAssetByName, parseInstallTargets } from '../assets/install.js';
+import { renderDebugBoundary, renderErrorBlock, renderJson, renderRemoteAssetList, renderSuccessBlock } from '../cli-output/renderers.js';
+import { bootstrapMcpServer } from './server.js';
+import { createDefaultMcpToolRegistry } from './tool-registry.js';
+function renderMcpHelp(programName = 'harness') {
+    return [
+        '运行和管理 Harness MCP 能力。',
+        '',
+        '用法：',
+        `  ${programName} mcp run [--cwd <path>]`,
+        `  ${programName} mcp list --remote [--json]`,
+        `  ${programName} mcp install <name> [--cwd <path>] [--agents] [--target cursor,agents] [--json]`,
+        '',
+        '选项：',
+        '  --cwd <path>  MCP Server 启动工作区根目录，默认当前目录。',
+        '  --remote      查看 harness-service 中的热门 MCP 配置资产。',
+        '  --target      install 目标，可为 cursor、agents 或 cursor,agents。',
+        '  --agents      install 时额外安装到 .agents。',
+        '  --json        list/install 子命令输出机器可读 JSON。',
+        '  -h, --help    查看帮助。',
+    ].join('\n');
+}
+function parseMcpRunArgs(args) {
+    let cwd = process.cwd();
+    let help = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+            continue;
+        }
+        if (arg === '--cwd') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('MCP_INVALID_ARGS', 'Missing value for --cwd.');
+            }
+            cwd = resolve(value);
+            index += 1;
+            continue;
+        }
+        throw new HarnessError('MCP_INVALID_ARGS', `Unknown mcp run option: ${arg}`);
+    }
+    return { cwd, help };
+}
+async function loadMcpServerSdk() {
+    const [lowLevelServer, transport, types] = await Promise.all([
+        import('@modelcontextprotocol/sdk/server'),
+        import('@modelcontextprotocol/sdk/server/stdio.js'),
+        import('@modelcontextprotocol/sdk/types.js'),
+    ]);
+    return { lowLevelServer, transport, types };
+}
+export function toMcpListToolsResult(toolRegistry) {
+    return {
+        tools: toolRegistry.map((tool) => ({
+            name: tool.definition.name,
+            description: tool.definition.description,
+            inputSchema: tool.definition.inputSchema,
+        })),
+    };
+}
+function isGatewayTokenEnforceEnabled() {
+    const raw = process.env.HARNESS_GATEWAY_TOKEN_ENFORCE?.trim().toLowerCase();
+    return raw === '1' || raw === 'true' || raw === 'yes';
+}
+function createOptionalMcpGateway(workspaceRoot, requestId) {
+    if (!isGatewayTokenEnforceEnabled()) {
+        return undefined;
+    }
+    const baseUrl = resolveHarnessServiceBaseUrl();
+    if (!baseUrl) {
+        return undefined;
+    }
+    const exchange = createHarnessServiceGatewayHttpExchange({
+        baseUrl,
+        authorizationBearer: process.env.HARNESS_SERVICE_BEARER_TOKEN?.trim(),
+    });
+    const tokenProvider = createGatewayTokenProviderFromExchange(exchange);
+    const client = createGatewayClient({ tokenProvider });
+    let actorId = process.env.HARNESS_ACTOR_ID?.trim();
+    if (!actorId) {
+        try {
+            actorId = userInfo().username;
+        }
+        catch {
+            actorId = undefined;
+        }
+    }
+    const sessionId = process.env.HARNESS_GATEWAY_SESSION_ID?.trim() || process.env.HARNESS_SESSION_ID?.trim();
+    return {
+        client,
+        requestContext: {
+            actorId: actorId ?? 'mcp-anonymous',
+            requestId,
+            commandName: 'harness mcp run',
+            projectId: process.env.HARNESS_PROJECT_ID?.trim() || basename(workspaceRoot),
+            projectName: process.env.HARNESS_PROJECT_NAME?.trim(),
+            ...(sessionId ? { sessionId } : {}),
+        },
+        targetModel: process.env.HARNESS_GATEWAY_TARGET_MODEL?.trim() || 'harness-mcp-gateway',
+    };
+}
+async function runMcpServerOverStdio(cwd) {
+    const startupStartedAt = Date.now();
+    const bootstrap = await bootstrapMcpServer({
+        workspaceRoot: cwd,
+    });
+    const toolRegistry = createDefaultMcpToolRegistry();
+    const { lowLevelServer: serverSdk, transport: transportSdk, types } = await loadMcpServerSdk();
+    const server = new serverSdk.Server({
+        name: bootstrap.registry.serverName,
+        version: bootstrap.registry.serverVersion,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    const toolByName = new Map(toolRegistry.map((tool) => [tool.definition.name, tool]));
+    server.setRequestHandler(types.ListToolsRequestSchema, async () => toMcpListToolsResult(toolRegistry));
+    server.setRequestHandler(types.CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const tool = toolByName.get(toolName);
+        if (!tool) {
+            throw new types.McpError(types.ErrorCode.InvalidParams, `Unknown tool: ${toolName}`);
+        }
+        try {
+            const gatewayLayer = createOptionalMcpGateway(bootstrap.registry.workspaceRoot, randomUUID());
+            const result = await tool.invoke(request.params.arguments, {
+                workspaceRoot: bootstrap.registry.workspaceRoot,
+                ...(gatewayLayer ? { gateway: gatewayLayer } : {}),
+            });
+            void reportHarnessTelemetryEvents([
+                createHarnessTelemetryEvent('mcp.tool.called', {
+                    source: 'mcp',
+                    command: toolName,
+                    success: true,
+                    payload: {
+                        workspaceRoot: bootstrap.registry.workspaceRoot,
+                    },
+                }),
+            ], { workspaceRoot: bootstrap.registry.workspaceRoot });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result.message,
+                    },
+                ],
+                structuredContent: result,
+                isError: result.status === 'error',
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            void reportHarnessTelemetryEvents([
+                createHarnessTelemetryEvent('mcp.tool.failed', {
+                    source: 'mcp',
+                    command: toolName,
+                    success: false,
+                    error_code: 'MCP_TOOL_INVOCATION_FAILED',
+                    payload: {
+                        message,
+                        workspaceRoot: bootstrap.registry.workspaceRoot,
+                    },
+                }),
+            ], { workspaceRoot: bootstrap.registry.workspaceRoot });
+            throw error;
+        }
+    });
+    const transport = new transportSdk.StdioServerTransport();
+    let stdinClosed = false;
+    let settled = false;
+    await new Promise((resolvePromise, rejectPromise) => {
+        let shutdownRequested = false;
+        const cleanup = () => {
+            process.stdin.off('end', onInputClosed);
+            process.stdin.off('close', onInputClosed);
+            process.off('SIGINT', onSigint);
+            process.off('SIGTERM', onSigterm);
+        };
+        const resolveOnce = () => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            resolvePromise();
+        };
+        const rejectOnce = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            rejectPromise(error instanceof Error ? error : new Error(String(error)));
+        };
+        const closeServerOnce = () => {
+            if (shutdownRequested) {
+                return;
+            }
+            shutdownRequested = true;
+            void server.close().catch(rejectOnce);
+        };
+        const onInputClosed = () => {
+            if (stdinClosed) {
+                return;
+            }
+            stdinClosed = true;
+            closeServerOnce();
+        };
+        const onSigint = () => {
+            closeServerOnce();
+        };
+        const onSigterm = () => {
+            closeServerOnce();
+        };
+        transport.onclose = resolveOnce;
+        transport.onerror = rejectOnce;
+        process.stdin.once('end', onInputClosed);
+        process.stdin.once('close', onInputClosed);
+        process.once('SIGINT', onSigint);
+        process.once('SIGTERM', onSigterm);
+        void server
+            .connect(transport)
+            .then(() => {
+            const durationMs = Date.now() - startupStartedAt;
+            const budgetMs = 1_000;
+            const debugLine = renderDebugBoundary('mcp run phase=startup', durationMs, budgetMs);
+            // MCP stdio protocol uses stdout; write operational diagnostics to stderr.
+            if (debugLine) {
+                console.error(debugLine);
+            }
+        })
+            .catch(rejectOnce);
+    });
+}
+export async function runMcpCommand(args, runtimeOptions = {}) {
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(renderMcpHelp());
+        return 0;
+    }
+    const subcommand = args[0];
+    if (subcommand === 'install') {
+        const json = args.includes('--json');
+        let cwd = process.cwd();
+        const rawArgs = args.slice(1).filter((arg) => arg !== '--json');
+        const parsedArgs = [];
+        for (let index = 0; index < rawArgs.length; index += 1) {
+            const arg = rawArgs[index];
+            if (!arg) {
+                continue;
+            }
+            if (arg === '--cwd') {
+                const value = rawArgs[index + 1];
+                if (!value || value.startsWith('--')) {
+                    throw new HarnessError('MCP_INVALID_ARGS', 'Missing value for --cwd.');
+                }
+                cwd = resolve(value);
+                index += 1;
+                continue;
+            }
+            parsedArgs.push(arg);
+        }
+        const { targets, rest } = parseInstallTargets(parsedArgs);
+        const name = rest[0]?.trim();
+        if (!name || rest.length !== 1) {
+            console.error(renderErrorBlock({
+                title: 'MCP 安装参数无效',
+                message: '用法：harness mcp install <name> [--cwd <path>] [--agents] [--target cursor,agents]',
+                code: 'MCP_INVALID_ARGS',
+            }));
+            return 1;
+        }
+        const client = createEnterpriseAssetClient({ baseUrl: runtimeOptions.baseUrl, fetchImpl: runtimeOptions.fetchImpl });
+        if (!client) {
+            console.error(renderErrorBlock({
+                title: 'MCP 配置安装失败',
+                message: 'HARNESS_SERVICE_URL is not configured.',
+                code: 'HARNESS_SERVICE_UNAVAILABLE',
+            }));
+            return 1;
+        }
+        try {
+            const result = await installPublishedAssetByName({
+                assetType: 'mcp-config',
+                name,
+                workspaceRoot: cwd,
+                targets,
+                client,
+            });
+            console.log(json ? renderJson(result) : renderSuccessBlock('MCP 配置安装完成', [
+                ['名称', result.name],
+                ['版本', result.version],
+                ['安装路径', result.targetPaths.join(', ')],
+            ]));
+            return 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(renderErrorBlock({ title: 'MCP 配置安装失败', message }));
+            return 1;
+        }
+    }
+    if (subcommand === 'list') {
+        const json = args.includes('--json');
+        const listArgs = args.slice(1).filter((arg) => arg !== '--json');
+        const hasRemote = listArgs.includes('--remote');
+        if (!hasRemote || listArgs.some((arg) => arg !== '--remote')) {
+            console.error(renderErrorBlock({
+                title: 'MCP 列表参数无效',
+                message: 'mcp list 仅支持 --remote 和 --json。',
+                code: 'MCP_INVALID_ARGS',
+            }));
+            return 1;
+        }
+        try {
+            const assets = await listRemoteTopAssets({ type: 'mcp-config' });
+            console.log(json ? renderJson({ assets }) : renderRemoteAssetList('远程热门 MCP 配置', assets));
+            return 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(renderErrorBlock({ title: '远程 MCP 配置列表读取失败', message }));
+            return 1;
+        }
+    }
+    if (subcommand !== 'run') {
+        console.error(renderErrorBlock({
+            title: '未知 MCP 子命令',
+            message: `无法识别子命令：${subcommand}`,
+            code: 'MCP_INVALID_ARGS',
+            suggestions: ['运行 harness mcp --help 查看可用命令。'],
+        }));
+        return 1;
+    }
+    const options = parseMcpRunArgs(args.slice(1));
+    if (options.help) {
+        console.log(renderMcpHelp());
+        return 0;
+    }
+    await runMcpServerOverStdio(options.cwd);
+    return 0;
+}
+export function registerMcpCommand(router) {
+    router.register('mcp', runMcpCommand);
+}
+export { renderMcpHelp };
+//# sourceMappingURL=command.js.map

package/dist/mcp/command.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,14 @@
+import type { McpServerOptions, McpToolDefinition } from './types.js';
+export interface BootstrapMcpServerOptions {
+    serverName?: string;
+    serverVersion?: string;
+    workspaceRoot?: string;
+    tools?: McpToolDefinition[];
+}
+export interface BootstrapMcpServerResult {
+    protocol: 'mcp';
+    transport: 'stdio';
+    registry: McpServerOptions;
+}
+export declare function bootstrapMcpServer(options?: BootstrapMcpServerOptions): Promise<BootstrapMcpServerResult>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGtE,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,KAAK,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAkCD,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAanC"}

package/dist/mcp/server.js

@@ -0,0 +1,44 @@
+import { stat } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { HarnessError } from '../contracts/errors.js';
+import { getDefaultMcpToolDefinitions } from './tool-registry.js';
+function normalizeTools(tools) {
+    const normalized = [...(tools ?? getDefaultMcpToolDefinitions())];
+    normalized.sort((left, right) => left.name.localeCompare(right.name));
+    return normalized;
+}
+async function assertValidWorkspaceRoot(workspaceRoot) {
+    const normalizedRoot = resolve(workspaceRoot);
+    if (normalizedRoot.trim().length === 0) {
+        throw new HarnessError('MCP_INVALID_CONFIG', 'Invalid MCP workspace root: value must not be empty.');
+    }
+    try {
+        const details = await stat(normalizedRoot);
+        if (!details.isDirectory()) {
+            throw new HarnessError('MCP_INVALID_CONFIG', `Invalid MCP workspace root: ${normalizedRoot} is not a directory.`);
+        }
+    }
+    catch (error) {
+        if (error instanceof HarnessError) {
+            throw error;
+        }
+        throw new HarnessError('MCP_INVALID_CONFIG', `Invalid MCP workspace root: ${normalizedRoot}`, {
+            cause: error,
+        });
+    }
+    return normalizedRoot;
+}
+export async function bootstrapMcpServer(options = {}) {
+    const workspaceRoot = await assertValidWorkspaceRoot(options.workspaceRoot ?? process.cwd());
+    return {
+        protocol: 'mcp',
+        transport: 'stdio',
+        registry: {
+            serverName: options.serverName ?? 'harness-mcp',
+            serverVersion: options.serverVersion ?? '0.0.0',
+            workspaceRoot,
+            tools: normalizeTools(options.tools),
+        },
+    };
+}
+//# 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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAelE,SAAS,cAAc,CAAC,KAAsC;IAC5D,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,4BAA4B,EAAE,CAAC,CAAC,CAAC;IAClE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,aAAqB;IAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,sDAAsD,CAAC,CAAC;IACvG,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,+BAA+B,cAAc,sBAAsB,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAClC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,+BAA+B,cAAc,EAAE,EAAE;YAC5F,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAqC,EAAE;IAEvC,MAAM,aAAa,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE7F,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE;YACR,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,aAAa;YAC/C,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,OAAO;YAC/C,aAAa;YACb,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC;SACrC;KACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tool-registry.d.ts

@@ -0,0 +1,38 @@
+import type { McpJsonSchema, McpToolDefinition, McpToolResult } from './types.js';
+import { type AddSkillData, type AddSkillInput, type AddSkillToolDependencies } from './tools/add-skill.js';
+import { type QueryKnowledgeData, type QueryKnowledgeInput } from './tools/query-knowledge.js';
+import { type ReadInstructionsData, type ReadInstructionsInput } from './tools/read-instructions.js';
+import { type SyncSpecData, type SyncSpecInput } from './tools/sync-spec.js';
+import { type UpdateRuleData, type UpdateRuleInput, type UpdateRuleToolDependencies } from './tools/update-rule.js';
+import { type AssembleInitAssetsData, type AssembleInitAssetsInput, type AssembleInitAssetsToolDependencies } from './tools/assemble-init-assets.js';
+import type { HarnessConfig } from '../contracts/config.js';
+import type { GatewayRequestContext } from '../gateway/auth.js';
+import type { GatewayClient } from '../gateway/client.js';
+export interface McpToolContext {
+    workspaceRoot: string;
+    harnessConfig?: Pick<HarnessConfig, 'specMountPath' | 'knowledgeMountPath'>;
+    gateway?: {
+        client: GatewayClient;
+        requestContext: Omit<GatewayRequestContext, 'workspaceRoot' | 'toolName'>;
+        targetModel?: string;
+    };
+}
+export type McpToolHandler<TInput = McpJsonSchema, TData = unknown> = (input: TInput | undefined, context: McpToolContext) => Promise<McpToolResult<TData>>;
+export interface RegisteredMcpTool<TInput = McpJsonSchema, TData = unknown> {
+    definition: McpToolDefinition;
+    invoke: McpToolHandler<TInput, TData>;
+}
+export type ReadInstructionsRegisteredTool = RegisteredMcpTool<ReadInstructionsInput, ReadInstructionsData>;
+export type AddSkillRegisteredTool = RegisteredMcpTool<AddSkillInput, AddSkillData>;
+export type QueryKnowledgeRegisteredTool = RegisteredMcpTool<QueryKnowledgeInput, QueryKnowledgeData>;
+export type SyncSpecRegisteredTool = RegisteredMcpTool<SyncSpecInput, SyncSpecData>;
+export type UpdateRuleRegisteredTool = RegisteredMcpTool<UpdateRuleInput, UpdateRuleData>;
+export type AssembleInitAssetsRegisteredTool = RegisteredMcpTool<AssembleInitAssetsInput, AssembleInitAssetsData>;
+export interface McpToolRegistryOptions {
+    addSkillDependencies?: Partial<AddSkillToolDependencies>;
+    updateRuleDependencies?: Partial<UpdateRuleToolDependencies>;
+    assembleInitAssetsDependencies?: Partial<AssembleInitAssetsToolDependencies>;
+}
+export declare function createDefaultMcpToolRegistry(options?: McpToolRegistryOptions): RegisteredMcpTool[];
+export declare function getDefaultMcpToolDefinitions(): McpToolDefinition[];
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/mcp/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,kCAAkC,EACxC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,oBAAoB,CAAC,CAAC;IAC5E,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,aAAa,CAAC;QACtB,cAAc,EAAE,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,UAAU,CAAC,CAAC;QAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,CACxB,MAAM,GAAG,aAAa,EACtB,KAAK,GAAG,OAAO,IACb,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAE1F,MAAM,WAAW,iBAAiB,CAChC,MAAM,GAAG,aAAa,EACtB,KAAK,GAAG,OAAO;IAEf,UAAU,EAAE,iBAAiB,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,CAC5D,qBAAqB,EACrB,oBAAoB,CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AAEpF,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;AAEtG,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACpF,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;AAC1F,MAAM,MAAM,gCAAgC,GAAG,iBAAiB,CAC9D,uBAAuB,EACvB,sBAAsB,CACvB,CAAC;AAMF,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACzD,sBAAsB,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC7D,8BAA8B,CAAC,EAAE,OAAO,CAAC,kCAAkC,CAAC,CAAC;CAC9E;AAED,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,sBAA2B,GAAG,iBAAiB,EAAE,CAqCtG;AAED,wBAAgB,4BAA4B,IAAI,iBAAiB,EAAE,CAElE"}

package/dist/mcp/tool-registry.js

@@ -0,0 +1,50 @@
+import { ADD_SKILL_TOOL, addSkillTool, createAddSkillTool, } from './tools/add-skill.js';
+import { QUERY_KNOWLEDGE_TOOL, queryKnowledgeTool, } from './tools/query-knowledge.js';
+import { READ_INSTRUCTIONS_TOOL, readInstructionsTool, } from './tools/read-instructions.js';
+import { SYNC_SPEC_TOOL, syncSpecTool, } from './tools/sync-spec.js';
+import { UPDATE_RULE_TOOL, updateRuleTool, createUpdateRuleTool, } from './tools/update-rule.js';
+import { ASSEMBLE_INIT_ASSETS_TOOL, assembleInitAssetsTool, createAssembleInitAssetsTool, } from './tools/assemble-init-assets.js';
+function sortDefinitions(tools) {
+    return [...tools].sort((left, right) => left.name.localeCompare(right.name));
+}
+export function createDefaultMcpToolRegistry(options = {}) {
+    const configuredAddSkillTool = options.addSkillDependencies
+        ? createAddSkillTool(options.addSkillDependencies)
+        : addSkillTool;
+    const configuredUpdateRuleTool = options.updateRuleDependencies
+        ? createUpdateRuleTool(options.updateRuleDependencies)
+        : updateRuleTool;
+    const configuredAssembleInitAssetsTool = options.assembleInitAssetsDependencies
+        ? createAssembleInitAssetsTool(options.assembleInitAssetsDependencies)
+        : assembleInitAssetsTool;
+    return [
+        {
+            definition: ADD_SKILL_TOOL,
+            invoke: configuredAddSkillTool,
+        },
+        {
+            definition: READ_INSTRUCTIONS_TOOL,
+            invoke: readInstructionsTool,
+        },
+        {
+            definition: QUERY_KNOWLEDGE_TOOL,
+            invoke: queryKnowledgeTool,
+        },
+        {
+            definition: SYNC_SPEC_TOOL,
+            invoke: syncSpecTool,
+        },
+        {
+            definition: ASSEMBLE_INIT_ASSETS_TOOL,
+            invoke: configuredAssembleInitAssetsTool,
+        },
+        {
+            definition: UPDATE_RULE_TOOL,
+            invoke: configuredUpdateRuleTool,
+        },
+    ];
+}
+export function getDefaultMcpToolDefinitions() {
+    return sortDefinitions(createDefaultMcpToolRegistry().map((tool) => tool.definition));
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/mcp/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,kBAAkB,GAInB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAGnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAGrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,cAAc,EACd,YAAY,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,GAIrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,4BAA4B,GAI7B,MAAM,iCAAiC,CAAC;AA4CzC,SAAS,eAAe,CAAC,KAA0B;IACjD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAQD,MAAM,UAAU,4BAA4B,CAAC,UAAkC,EAAE;IAC/E,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB;QACzD,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,oBAAoB,CAAC;QAClD,CAAC,CAAC,YAAY,CAAC;IACjB,MAAM,wBAAwB,GAAG,OAAO,CAAC,sBAAsB;QAC7D,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,sBAAsB,CAAC;QACtD,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,gCAAgC,GAAG,OAAO,CAAC,8BAA8B;QAC7E,CAAC,CAAC,4BAA4B,CAAC,OAAO,CAAC,8BAA8B,CAAC;QACtE,CAAC,CAAC,sBAAsB,CAAC;IAE3B,OAAO;QACL;YACE,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,sBAAsB;SACE;QAClC;YACE,UAAU,EAAE,sBAAsB;YAClC,MAAM,EAAE,oBAAoB;SACY;QAC1C;YACE,UAAU,EAAE,oBAAoB;YAChC,MAAM,EAAE,kBAAkB;SACY;QACxC;YACE,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,YAAY;SACY;QAClC;YACE,UAAU,EAAE,yBAAyB;YACrC,MAAM,EAAE,gCAAgC;SACE;QAC5C;YACE,UAAU,EAAE,gBAAgB;YAC5B,MAAM,EAAE,wBAAwB;SACE;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,eAAe,CAAC,4BAA4B,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/mcp/tools/add-skill.d.ts

@@ -0,0 +1,29 @@
+import type { InternalSkillProvider, ResolvedSkillPackage, SkillInstallAction } from '../../skills/types.js';
+import type { McpToolDefinition, McpToolResult } from '../types.js';
+export interface AddSkillToolContext {
+    workspaceRoot: string;
+}
+export interface AddSkillInput {
+    name?: string;
+    url?: string;
+    targetDir?: string;
+    dryRun?: boolean;
+}
+export interface AddSkillData {
+    action: SkillInstallAction;
+    skillName: string;
+    source: 'name' | 'url';
+    installPath: string;
+    reason: string;
+    dryRun: boolean;
+}
+export interface AddSkillToolDependencies {
+    internalProvider: InternalSkillProvider;
+    resolveByUrl: (url: URL) => Promise<ResolvedSkillPackage>;
+    now?: () => Date;
+}
+export declare const ADD_SKILL_TOOL: McpToolDefinition;
+export declare function createAddSkillTool(dependencies?: Partial<AddSkillToolDependencies>): (input: AddSkillInput | undefined, context: AddSkillToolContext) => Promise<McpToolResult<AddSkillData>>;
+export declare const addSkillTool: (input: AddSkillInput | undefined, context: AddSkillToolContext) => Promise<McpToolResult<AddSkillData>>;
+export type AddSkillTool = ReturnType<typeof createAddSkillTool>;
+//# sourceMappingURL=add-skill.d.ts.map

package/dist/mcp/tools/add-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-skill.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/add-skill.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAID,eAAO,MAAM,cAAc,EAAE,iBAyB5B,CAAC;AAqGF,wBAAgB,kBAAkB,CAAC,YAAY,GAAE,OAAO,CAAC,wBAAwB,CAAM,WAO5E,aAAa,GAAG,SAAS,WACvB,mBAAmB,KAC3B,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CA2ExC;AAED,eAAO,MAAM,YAAY,UA/Ed,aAAa,GAAG,SAAS,WACvB,mBAAmB,KAC3B,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CA6EQ,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}