@evomap/evolver-mcp 2.0.0-beta.2 → 2.0.0-beta.22

package/dist/stdio.js

@@ -8,11 +8,17 @@ import { buildEvolverTools } from './tools.js';
 import { buildEvolverPrimer } from './primer.js';
 import { EvolverMcpServer, UnknownToolError } from './server.js';
 import { reachableProxyClientFromEnv } from './proxyClient.js';
-import { loadEnvFileFromEnv } from './envFile.js';
-const envFile = loadEnvFileFromEnv(process.env);
-if (envFile.error) {
-    process.stderr.write(`[evolver-mcp] failed to load EVOLVER_ENV_FILE: ${envFile.error}\n`);
+import { loadEnvFileFromEnvOrThrow } from './envFile.js';
+import { bootstrap } from '@evomap/evolver-core';
+try {
+    loadEnvFileFromEnvOrThrow(process.env);
 }
+catch {
+    process.stderr.write('[evolver-mcp] fatal: failed to load EVOLVER_ENV_FILE\n');
+    process.exit(1);
+}
+// Emit deprecation warnings for any V1 env vars still present in the environment.
+bootstrap.checkV1EnvCompat(process.env);
 const store = new assetstore.LocalJsonlProvider(events.assetsDir());
 const mailboxPath = process.env['EVOLVER_MCP_MAILBOX'] ?? join(events.evomapHome(), 'mailbox', 'mcp.db');
 mkdirSync(dirname(mailboxPath), { recursive: true });

package/dist/tools.js

@@ -155,7 +155,7 @@ export function buildEvolverTools(deps) {
             // Self-onboarding (#mcp-onboarding): any MCP agent can learn the quiet reuse loop when it needs guidance.
             // Mirrors the initialize.instructions primer; always present, but no longer asks the agent to narrate routine work.
             name: 'evolver_guide',
-            description: '按需说明 evolver 的静默复用机制(search→reuse→capture 循环)与各工具何时调用；不要向用户叙述例行预检、状态或空搜索。',
+            description: '按需说明 evolver 的静默复用机制(Recipe search→express, Gene/Capsule 为 fallback；search→reuse→capture 循环)与各工具何时调用；不要向用户叙述例行预检、状态或空搜索。',
             inputSchema: { type: 'object', properties: {} },
             handler: async () => ({ guide: buildEvolverPrimer({ proxy: !!deps.proxy }) }),
         },
@@ -165,13 +165,14 @@ export function buildEvolverTools(deps) {
             // later observe, from this agent's transcript, which primed genes were used. NOT a hub search (that is
             // evolver_asset_search): this is the curated, already-approved local memory, ready to reuse quietly.
             name: 'evolver_recall',
-            description: '当本机已审核通过的可复用经验 gene 可能有帮助时调用；返回信任+审核双闸后的本地 gene，并记录一条 value.inject。若传入 sessionId(= 本会话 transcript 文件名去掉 .jsonl 后缀),后续 auto-recall 能从该 transcript 观测哪些注入 gene 真正被用,为经 MCP 接入的 AI 闭合自学习环;不传则仅记录归因、无法关联到会话。命中后静默复用，并在结果明确后用 evolver_asset_reuse_result 回报。',
+            description: 'Fallback：当本机已审核通过的可复用经验 gene 可能有帮助时调用（不是 Hub Recipe 搜索）。联网默认先 evolver_recipe_search / evolver_recipe_express。返回信任+审核双闸后的本地 gene，并记录一条 value.inject。若传入 sessionId(= 本会话 transcript 文件名去掉 .jsonl 后缀),后续 auto-recall 能从该 transcript 观测哪些注入 gene 真正被用,为经 MCP 接入的 AI 闭合自学习环;不传则仅记录归因、无法关联到会话。命中后静默复用，并在结果明确后用 evolver_asset_reuse_result 回报。',
             inputSchema: { type: 'object', properties: { limit: { type: 'number' }, sessionId: { type: 'string' } } },
             handler: async (a) => {
                 const limit = optionalNonNegativeNumberArg(a, 'limit', 'evolver_recall limit must be a non-negative number') ?? 5;
                 const sessionId = typeof a['sessionId'] === 'string' && a['sessionId'].trim() ? a['sessionId'].trim() : undefined;
                 const review = assetstore.reviewLedgerForStore(deps.store);
-                const genes = await assetstore.listApprovedGenes(deps.store, review, limit);
+                const provenance = assetstore.provenanceStoreForStore(deps.store);
+                const genes = await assetstore.listApprovedGenes(deps.store, review, limit, provenance);
                 const primed = genes.map((g) => {
                     const r = g;
                     const id = typeof r['id'] === 'string' ? r['id'] : String(r['asset_id']);
@@ -198,6 +199,68 @@ export function buildEvolverTools(deps) {
             },
         },
         ...(deps.proxy ? [{
+                name: 'evolver_recipe_search',
+                description: '默认第一步：通过本机 evolver-proxy 搜索 Hub 已发布 Recipe（有序 Gene/Capsule DNA）。命中后调用 evolver_recipe_express。无匹配时再 fallback 到 evolver_asset_search。旧客户端默认收到 Recipe 数组；设置 includePagination=true 可读取 nextCursor/hasMore。',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: { type: 'string' },
+                        query: { type: 'string' },
+                        text: { type: 'string' },
+                        limit: { type: 'number' },
+                        cursor: { type: 'string' },
+                        sort: { type: 'string' },
+                        includePagination: {
+                            type: 'boolean',
+                            description: 'Set true to return the recipe page envelope with nextCursor/hasMore. The default array shape remains backwards compatible.',
+                        },
+                    },
+                },
+                handler: async (a) => {
+                    const q = [a['q'], a['query'], a['text']].find((value) => typeof value === 'string' && value.trim().length > 0);
+                    const includePagination = a['includePagination'] === true;
+                    const receipt = record(await deps.proxy.searchRecipes({
+                        ...(q ? { q } : {}),
+                        ...(typeof a['limit'] === 'number' ? { limit: a['limit'] } : {}),
+                        ...(typeof a['cursor'] === 'string' ? { cursor: a['cursor'] } : {}),
+                        ...(typeof a['sort'] === 'string' ? { sort: a['sort'] } : {}),
+                    }));
+                    if (includePagination && (Array.isArray(receipt['recipes'])
+                        || Array.isArray(receipt['results'])
+                        || Array.isArray(receipt['items'])))
+                        return receipt;
+                    if (Array.isArray(receipt['recipes']))
+                        return receipt['recipes'];
+                    if (Array.isArray(receipt['results']))
+                        return receipt['results'];
+                    if (Array.isArray(receipt['items']))
+                        return receipt['items'];
+                    return receipt;
+                },
+            }, {
+                name: 'evolver_recipe_express',
+                description: '表达/执行一条 Recipe：只转发 Hub POST /a2a/recipe/{id}/express。Hub 按步骤展开 Gene 再 Capsule，从而产生全网 gene/capsule 调用。不要在本地解析 recipe JSON。',
+                inputSchema: {
+                    type: 'object',
+                    required: ['recipeId'],
+                    properties: {
+                        recipeId: { type: 'string' },
+                        inputPayload: { type: 'object' },
+                    },
+                },
+                handler: async (a) => {
+                    const recipeId = str(a['recipeId']).trim();
+                    if (!recipeId)
+                        throw new Error('evolver_recipe_express requires recipeId');
+                    const inputPayload = a['inputPayload'];
+                    return deps.proxy.expressRecipe({
+                        recipeId,
+                        ...(inputPayload && typeof inputPayload === 'object' && !Array.isArray(inputPayload)
+                            ? { inputPayload: inputPayload }
+                            : {}),
+                    });
+                },
+            }, {
                 name: 'evolver_proxy_status',
                 description: '检查本机 evolver-proxy 与 PHub 的连接状态. 需要 EVOLVER_PROXY_URL/EVOLVER_IPC_TOKEN.',
                 inputSchema: { type: 'object', properties: {} },
@@ -206,8 +269,8 @@ export function buildEvolverTools(deps) {
         {
             name: 'evolver_asset_search',
             description: deps.proxy
-                ? '通过本机 evolver-proxy 搜索 PHub 经验资产(Gene/Capsule/EvolutionEvent); AntiGene 是本地负经验资产, 会直接查本地库供人工 review.'
-                : '搜索本地经验资产库(Gene/Capsule/EvolutionEvent/AntiGene). 支持 kind/信号/类目/gene 反查/文本.',
+                ? 'Fallback：当 evolver_recipe_search 无匹配 Recipe 时，通过本机 evolver-proxy 直搜 PHub 经验资产(Gene/Capsule/EvolutionEvent)。AntiGene 是本地负经验资产, 会直接查本地库供人工 review. 真正复用应优先 evolver_recipe_express。'
+                : '搜索本地经验资产库(Gene/Capsule/EvolutionEvent/AntiGene). 支持 kind/信号/类目/gene 反查/文本. 联网 Recipe 搜索需要 evolver-proxy。',
             inputSchema: { type: 'object', properties: { kind: { type: 'string', enum: searchableKinds }, signalsAny: { type: 'array', items: { type: 'string' } }, category: { type: 'string' }, gene: { type: 'string' }, text: { type: 'string' }, limit: { type: 'number' } } },
             handler: async (a) => {
                 if (deps.proxy && a['kind'] === 'AntiGene') {
@@ -274,7 +337,7 @@ export function buildEvolverTools(deps) {
         },
         {
             name: 'evolver_distill_conversation',
-            description: '从当前 agent 对话中蒸馏可复用 Gene/Capsule. 需要具体 summary、strategy/evidence、artifacts、validation; core quality gate 会拒绝弱信号.',
+            description: '从当前对话蒸馏可复用能力. persist=true 只在结果可发布(经宿主验证)或为失败/无轨迹草稿时才落 Gene/Capsule; 携带调用方自报 success 轨迹而未经宿主验证时仅返回草稿不落库. 需要具体 summary、strategy/evidence、artifacts、validation; 质量闸门会将弱信号保留为草稿而不会发布. provider 若不具备 putBundle 能力，成对持久化会 fail-closed 并返回 bundle_persistence_unsupported. Hub 默认优先发布成 Recipe, 不再优先上 Skill Store. publish=true 时默认 compose_recipe, 可用 publish_recipe=false 关掉.',
             inputSchema: {
                 type: 'object',
                 required: ['summary'],
@@ -292,7 +355,8 @@ export function buildEvolverTools(deps) {
                     validation: { type: 'array', items: { type: 'string' } },
                     persist: { type: 'boolean' },
                     publish: { type: 'boolean' },
-                    min_score: { type: 'integer', minimum: 1, maximum: 10 },
+                    publish_recipe: { type: 'boolean', description: 'When publish=true, also compose and publish a Recipe. Defaults to true.' },
+                    min_score: { type: 'integer', minimum: 5, maximum: 10 },
                 },
             },
             handler: async (a) => {

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@evomap/evolver-mcp",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.22",
   "private": false,
   "type": "module",
+  "engines": {
+    "node": "^22.13.0 || >=23.4.0"
+  },
   "description": "Evolver MCP server (agent 工具发现入口)",
   "bin": {
     "evolver-mcp": "./dist/stdio.js"
@@ -17,12 +20,20 @@
     "./stdio": {
       "types": "./dist/stdio.d.ts",
       "default": "./dist/stdio.js"
+    },
+    "./product-bridge": {
+      "types": "./dist/productBridgeShim.d.ts",
+      "default": "./dist/productBridgeShim.js"
     }
   },
   "dependencies": {
-    "@evomap/evolver-core": "2.0.0-beta.2",
+    "@evomap/evolver-core": "2.0.0-beta.22",
     "smol-toml": "^1.6.1"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EvoMap/evolver.git"
+  },
   "publishConfig": {
     "access": "public",
     "tag": "v2-beta"