@co-engram/core 0.1.1 → 0.1.3

package/dist/tools/synthesize-tools.js

@@ -0,0 +1,297 @@
+/**
+ * engram_synthesize 工具(Feature 1:手工触发 REM)
+ *
+ * 接受一组 engram id,调 LLM 综合形成 pattern engram,并对每个源 engram 创建
+ * `derives_from` synapse(pattern → source)。
+ *
+ * 与 REM dreaming 的关系:
+ *   - REM 是自动聚类 + 启发式抽象,后台定时跑
+ *   - 本工具是用户/agent 显式触发,语义层 LLM 抽象,精确度高
+ *   - Feature 2 会把 REM dreaming 的 abstractionProvider 替换为同等 LLM 路径
+ *
+ * 与 proposal-engine 的区别:
+ *   - proposal-engine 监听对话流自动累积 cluster → promotion
+ *   - 本工具不依赖 proposal-engine,直接由调用方提供源 engram id 列表
+ *
+ * @module @co-engram/core/tools
+ */
+import { randomUUID } from "node:crypto";
+import { validateInput } from "./tool.js";
+import { EngramSynthesizeInputSchema, } from "./schemas.js";
+// ============================================================
+// Prompt 模板(共享:engram_synthesize 工具 + REM LlmPatternAbstraction)
+// ============================================================
+export const SYNTHESIS_PROMPT = `You are synthesizing a team memory pattern from a set of related engrams.
+
+A "pattern" is a higher-order insight that connects or abstracts multiple specific memories into a reusable lesson, principle, or design rationale. It should be more than a summary — it should reveal what these memories have in common at a level that will help future conversations.
+
+Below are ${"<SAMPLE_COUNT>"} source engrams:
+
+${"<SAMPLES_BLOCK>"}
+
+${"<HINTS_BLOCK>"}
+
+Synthesize them into ONE pattern. Return STRICT JSON only (no markdown, no prose) with this shape:
+
+{
+  "title": "<4-10 word pattern title, must NOT just copy any source title>",
+  "summary": "<1-2 sentence plain-language summary of the pattern>",
+  "content": "<full pattern body in markdown, 100-500 words; explain the insight, evidence from sources, and how to apply it>",
+  "domainTags": ["<3-6 lowercase tags>"],
+  "confidence": <number 0..1 — how confident this is a real pattern vs cherry-picked coincidence>,
+  "reason": "<one sentence on why these sources support this pattern>"
+}
+
+ STRICT rules:
+  1. The pattern must be NON-TRIVIAL — if the sources are too unrelated, set confidence < 0.4 and explain why in reason.
+  2. Title must be different from every source title; reuse is a failure mode.
+  3. Content must reference specific details from sources (not generic platitudes).
+  4. domainTags should be the shared vocabulary across sources, not a union of all tags.
+  5. If any source is clearly off-topic from the others, exclude it mentally but list it in reason.`;
+// ============================================================
+// 辅助:解析 LLM 输出
+// ============================================================
+/**
+ * 解析 LLM 综合输出
+ *
+ * 容忍 markdown fence / 前后 prose / 嵌套 JSON 等不规范输出。
+ * 返回 null 表示无法解析,调用方 fallback / 抛错。
+ */
+export function parseSynthesisOutput(raw) {
+    let text = raw.trim();
+    // 剥 markdown fence
+    const fenceMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (fenceMatch) {
+        text = fenceMatch[1].trim();
+    }
+    // 抽取最外层 { ... }
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start)
+        return null;
+    const jsonStr = text.slice(start, end + 1);
+    let obj;
+    try {
+        obj = JSON.parse(jsonStr);
+    }
+    catch {
+        return null;
+    }
+    const title = typeof obj.title === "string" && obj.title.trim().length > 0
+        ? obj.title.trim().slice(0, 200)
+        : null;
+    const content = typeof obj.content === "string" && obj.content.trim().length > 0
+        ? obj.content.trim()
+        : null;
+    if (!title || !content)
+        return null;
+    const summary = typeof obj.summary === "string" && obj.summary.trim().length > 0
+        ? obj.summary.trim().slice(0, 300)
+        : content.slice(0, 200);
+    const domainTags = Array.isArray(obj.domainTags)
+        ? obj.domainTags
+            .filter((t) => typeof t === "string" && t.trim().length > 0)
+            .map((t) => t.trim().toLowerCase().slice(0, 50))
+            .slice(0, 5)
+        : [];
+    const confidence = typeof obj.confidence === "number" &&
+        Number.isFinite(obj.confidence) &&
+        obj.confidence >= 0 &&
+        obj.confidence <= 1
+        ? obj.confidence
+        : 0.5;
+    const reason = typeof obj.reason === "string" && obj.reason.trim().length > 0
+        ? obj.reason.trim().slice(0, 500)
+        : "LLM synthesis";
+    return { title, content, summary, domainTags, confidence, reason };
+}
+function loadAndValidateSources(repo, ids) {
+    const seen = new Set();
+    const sources = [];
+    const missing = [];
+    for (const id of ids) {
+        if (seen.has(id))
+            continue; // 自动去重
+        seen.add(id);
+        if (!repo.exists(id)) {
+            missing.push(id);
+            continue;
+        }
+        const e = repo.readEngram(id);
+        sources.push({
+            id: e.id,
+            title: e.title,
+            content: e.content,
+            summary: e.summary,
+            domainTags: [...e.domainTags],
+        });
+    }
+    return { sources, missing };
+}
+/** 构造给 LLM 的样本块(共享:engram_synthesize 工具 + REM LlmPatternAbstraction) */
+export function buildSamplesBlock(sources) {
+    return sources
+        .map((s, i) => {
+        const tags = s.domainTags.length > 0 ? s.domainTags.join(", ") : "(none)";
+        const body = s.content.length > 1500
+            ? `${s.content.slice(0, 1500)}...(truncated)`
+            : s.content;
+        return `--- Source [${i + 1}] id=${s.id} ---
+title: ${s.title}
+tags: ${tags}
+summary: ${s.summary}
+content:
+${body}`;
+    })
+        .join("\n\n");
+}
+// ============================================================
+// 工具实现
+// ============================================================
+/**
+ * engram_synthesize 工具
+ *
+ * 输入:ids + 可选 createdBy/domainTags/synthesisHints/dryRun
+ * 输出:patternEngramId + synapseIds + sourceIds + draft
+ *
+ * 副作用:创建 pattern engram(kind=pattern, sourceType=inferred) +
+ * 对每个源创建 derives_from synapse + append audit。
+ *
+ * 失败模式:
+ *   - ctx.llmClient 缺失 → 抛错带安装指引
+ *   - 源 engram 部分不存在 → 抛错列出缺失的 id(不部分执行)
+ *   - LLM 返回非 JSON → 抛错(不创建 engram,避免垃圾数据)
+ *   - LLM 调用抛错 → 透传(由调用方决定重试 / fallback)
+ */
+export const engramSynthesizeTool = {
+    name: "engram_synthesize",
+    description: '综合多条已有 engram 形成一条 pattern(模式)记忆。需要 ToolContext.llmClient(claude-code-mcp 默认从 ANTHROPIC_API_KEY 解析;openclaw-plugin 从 necessityLlm 配置或 ~/.openclaw/openclaw.json 解析)。流程:读源 → LLM 综合 → 创建 kind="pattern" engram → 对每个源连 derives_from synapse。dryRun=true 只返回草稿不创建。源 id 重复自动去重,源不存在抛错(不部分执行)。',
+    inputSchema: EngramSynthesizeInputSchema,
+    async execute(input, ctx) {
+        const parsed = validateInput(EngramSynthesizeInputSchema, input);
+        const llmClient = ctx.llmClient;
+        if (!llmClient) {
+            throw new Error("engram_synthesize requires LLM client. " +
+                "Configure necessityLlm in plugin config (MCP: persistedConfig.necessityLlm or ANTHROPIC_API_KEY env; " +
+                "OpenClaw: config.necessityLlm or ~/.openclaw/openclaw.json).");
+        }
+        // 1. 加载并校验源
+        const { sources, missing } = loadAndValidateSources(ctx.repository, parsed.ids);
+        if (missing.length > 0) {
+            throw new Error(`Source engrams not found: ${missing.join(", ")}. ` +
+                `Synthesis aborted (no partial execution).`);
+        }
+        if (sources.length < 2) {
+            throw new Error(`At least 2 unique source engrams required for synthesis (got ${sources.length}).`);
+        }
+        // 2. 调 LLM 综合
+        const samplesBlock = buildSamplesBlock(sources);
+        const hintsBlock = parsed.synthesisHints
+            ? `Additional guidance from caller:\n${parsed.synthesisHints}`
+            : "";
+        const prompt = SYNTHESIS_PROMPT.replace("<SAMPLE_COUNT>", String(sources.length))
+            .replace("<SAMPLES_BLOCK>", samplesBlock)
+            .replace("<HINTS_BLOCK>", hintsBlock);
+        let raw;
+        try {
+            // maxTokens 4000 留足 content body 长度 + reasoning 模型预算
+            raw = await llmClient.complete(prompt, {
+                maxTokens: 4000,
+                temperature: 0.3,
+                timeoutMs: 60_000,
+            });
+        }
+        catch (err) {
+            throw new Error(`LLM synthesis call failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (typeof raw !== "string" || raw.length === 0) {
+            throw new Error(`LLM returned non-string output (type=${typeof raw}); synthesis aborted.`);
+        }
+        const draft = parseSynthesisOutput(raw);
+        if (!draft) {
+            throw new Error(`Failed to parse LLM synthesis output as JSON. ` +
+                `First 200 chars: ${raw.slice(0, 200)}...`);
+        }
+        // 3. dry-run 模式:只返回草稿,不创建
+        if (parsed.dryRun === true) {
+            return {
+                synapseIds: [],
+                sourceIds: sources.map((s) => s.id),
+                draft,
+                dryRun: true,
+            };
+        }
+        // 4. 创建 pattern engram
+        const createdBy = parsed.createdBy ?? ctx.defaultCreatedBy ?? "unknown";
+        // 用户显式 domainTags 优先;否则用 LLM 推断的;再 fallback 到源 tags 的并集
+        const domainTags = parsed.domainTags && parsed.domainTags.length > 0
+            ? parsed.domainTags
+            : draft.domainTags.length > 0
+                ? draft.domainTags
+                : Array.from(new Set(sources.flatMap((s) => s.domainTags))).slice(0, 5);
+        const patternEngram = ctx.repository.createEngram({
+            title: draft.title,
+            content: draft.content,
+            summary: draft.summary,
+            kind: "pattern",
+            domainTags,
+            importance: 0.7,
+            confidence: draft.confidence,
+            sourceType: "inferred",
+            createdBy,
+        });
+        // 5. 创建 derives_from synapse(pattern → source)
+        const synapseIds = [];
+        const timestamp = patternEngram.createdAt;
+        for (const source of sources) {
+            const synapse = {
+                id: randomUUID(),
+                from: patternEngram.id,
+                to: source.id,
+                kind: "derives_from",
+                weight: 0.8,
+                direction: "directional",
+                evidence: [
+                    {
+                        description: `Pattern synthesized from ${sources.length} sources via engram_synthesize`,
+                        source: "llm-synthesis",
+                        confidence: draft.confidence,
+                        addedAt: timestamp,
+                        addedBy: createdBy,
+                    },
+                ],
+                createdBy,
+                createdAt: timestamp,
+                updatedAt: timestamp,
+                retrievalWeight: 0.8,
+                visibility: "public",
+            };
+            const stored = ctx.repository.addOutgoingSynapse(patternEngram.id, synapse);
+            synapseIds.push(stored.id);
+        }
+        // 6. audit + markDirty
+        ctx.auditLog?.append({
+            actor: "user",
+            action: "create",
+            engramId: patternEngram.id,
+            metadata: {
+                target: "pattern-via-synthesis",
+                sourceIds: sources.map((s) => s.id),
+                synapseIds,
+                title: draft.title,
+                confidence: draft.confidence,
+                createdBy,
+            },
+        });
+        ctx.markDirty?.();
+        return {
+            patternEngramId: patternEngram.id,
+            synapseIds,
+            sourceIds: sources.map((s) => s.id),
+            draft,
+            dryRun: false,
+        };
+    },
+};
+export const ALL_SYNTHESIZE_TOOLS = [engramSynthesizeTool];
+//# sourceMappingURL=synthesize-tools.js.map

package/dist/tools/synthesize-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-tools.js","sourceRoot":"","sources":["../../src/tools/synthesize-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,2BAA2B,GAE5B,MAAM,cAAc,CAAC;AAgCtB,+DAA+D;AAC/D,iEAAiE;AACjE,+DAA+D;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;YAIpB,gBAAgB;;EAE1B,iBAAiB;;EAEjB,eAAe;;;;;;;;;;;;;;;;;;oGAkBmF,CAAC;AAErG,+DAA+D;AAC/D,eAAe;AACf,+DAA+D;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAEtB,mBAAmB;IACnB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9D,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,gBAAgB;IAChB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAE3C,IAAI,GAOH,CAAC;IACF,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GACT,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC1D,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC9D,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;QACpB,CAAC,CAAC,IAAI,CAAC;IACX,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC9D,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAClC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE5B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAC9C,CAAC,CAAC,GAAG,CAAC,UAAU;aACX,MAAM,CACL,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACjE;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;aAC/C,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,UAAU,GACd,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;QAC/B,GAAG,CAAC,UAAU,IAAI,CAAC;QACnB,GAAG,CAAC,UAAU,IAAI,CAAC;QACjB,CAAC,CAAC,GAAG,CAAC,UAAU;QAChB,CAAC,CAAC,GAAG,CAAC;IAEV,MAAM,MAAM,GACV,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC5D,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACjC,CAAC,CAAC,eAAe,CAAC;IAEtB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACrE,CAAC;AAcD,SAAS,sBAAsB,CAC7B,IAAsB,EACtB,GAAsB;IAKtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS,CAAC,OAAO;QACnC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAW,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,OAAgC;IAChE,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACZ,MAAM,IAAI,GACR,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/D,MAAM,IAAI,GACR,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI;YACrB,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB;YAC7C,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAChB,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE;SACpC,CAAC,CAAC,KAAK;QACR,IAAI;WACD,CAAC,CAAC,OAAO;;EAElB,IAAI,EAAE,CAAC;IACL,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAE/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAG7B;IACF,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,4RAA4R;IAC9R,WAAW,EAAE,2BAA2B;IACxC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,MAAM,GAAG,aAAa,CAC1B,2BAA2B,EAC3B,KAAK,CACN,CAAC;QAEF,MAAM,SAAS,GAAG,GAAG,CAAC,SAAkC,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,yCAAyC;gBACvC,uGAAuG;gBACvG,8DAA8D,CACjE,CAAC;QACJ,CAAC;QAED,YAAY;QACZ,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACjD,2CAA2C,CAC9C,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,gEAAgE,OAAO,CAAC,MAAM,IAAI,CACnF,CAAC;QACJ,CAAC;QAED,cAAc;QACd,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc;YACtC,CAAC,CAAC,qCAAqC,MAAM,CAAC,cAAc,EAAE;YAC9D,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CACrC,gBAAgB,EAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CACvB;aACE,OAAO,CAAC,iBAAiB,EAAE,YAAY,CAAC;aACxC,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAExC,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,qDAAqD;YACrD,GAAG,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE;gBACrC,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,8BACE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,GAAG,uBAAuB,CAC1E,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,gDAAgD;gBAC9C,oBAAoB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAC7C,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO;gBACL,UAAU,EAAE,EAAE;gBACd,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,KAAK;gBACL,MAAM,EAAE,IAAI;aACb,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,gBAAgB,IAAI,SAAS,CAAC;QACxE,wDAAwD;QACxD,MAAM,UAAU,GACd,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAC/C,CAAC,CAAC,MAAM,CAAC,UAAU;YACnB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBAC3B,CAAC,CAAC,KAAK,CAAC,UAAU;gBAClB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAC7D,CAAC,EACD,CAAC,CACF,CAAC;QAEV,MAAM,aAAa,GAAG,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC;YAChD,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,SAAS;YACf,UAAU;YACV,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,UAAU;YACtB,SAAS;SACV,CAAC,CAAC;QAEH,+CAA+C;QAC/C,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;QAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAY;gBACvB,EAAE,EAAE,UAAU,EAAE;gBAChB,IAAI,EAAE,aAAa,CAAC,EAAE;gBACtB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,aAAa;gBACxB,QAAQ,EAAE;oBACR;wBACE,WAAW,EAAE,4BAA4B,OAAO,CAAC,MAAM,gCAAgC;wBACvF,MAAM,EAAE,eAAe;wBACvB,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,OAAO,EAAE,SAAS;wBAClB,OAAO,EAAE,SAAS;qBACnB;iBACF;gBACD,SAAS;gBACT,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,SAAS;gBACpB,eAAe,EAAE,GAAG;gBACpB,UAAU,EAAE,QAAQ;aACrB,CAAC;YACF,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAC9C,aAAa,CAAC,EAAE,EAChB,OAAO,CACR,CAAC;YACF,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,uBAAuB;QACvB,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,aAAa,CAAC,EAAE;YAC1B,QAAQ,EAAE;gBACR,MAAM,EAAE,uBAAuB;gBAC/B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,UAAU;gBACV,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,SAAS;aACV;SACF,CAAC,CAAC;QACH,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;QAElB,OAAO;YACL,eAAe,EAAE,aAAa,CAAC,EAAE;YACjC,UAAU;YACV,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,KAAK;YACL,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAoB,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/tools/tool-profile.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 工具暴露 profile(host-agnostic 单一源)
+ *
+ * 15 轮拉通分析的元2「双宿主无契约」修复:
+ * 此前 PROFILE_TOOL_SETS / PROFILE_TOOL_COUNTS 只存在于 claude-code-mcp,
+ * openclaw-plugin 完全没有 profile 选择机制。R13 实证 PROFILE_TOOL_COUNTS
+ * 三档全错(minimal 写 11 实际 12,standard 写 17 实际 18,full 写 28 实际 29)。
+ *
+ * 修复方向:host-agnostic 概念应放 core 单一源,两宿主 re-export 引用,
+ * 契约测试 trivially 满足(同一份对象引用)。PROFILE_TOOL_COUNTS 用 .size
+ * 自动算,永久防回归。
+ *
+ * @module @co-engram/core/tools
+ */
+import type { Tool } from "./tool.js";
+/**
+ * 三档 profile
+ */
+export type ToolProfile = "minimal" | "standard" | "full";
+/**
+ * 每档 profile 包含的工具名集合
+ *
+ * minimal: 12 个 —— 核心读写 + proposal 处理三件套 + engram_sync
+ *   proposal 工具进 minimal 的原因:维护引擎默认在后台运行,会持续产生
+ *   proposals。若 minimal 暴露了"待审核候选 N 条"提示却不容许处理,会形成
+ *   "看得到但处理不了"的体验断裂。把 list/accept/dismiss 提供到 minimal,
+ *   让 agent 在任何 profile 下都能闭环处理 proposal。
+ *   engram_sync 进 minimal:让所有 profile 都能主动掌控提交时机。
+ *
+ * standard: 19 个 = minimal 12 + 学习回路 + contradiction + 数据管理 +
+ *   自愈/路径树 + engram_synthesize + engram_audit_query
+ *
+ * full: 29 个 = 全部 native 工具(包含隐藏的管理类工具,调试用),
+ *   但不含 skill_invoke —— 它是 P0 stub(Task 3.2 移除,等 P1 真正实现再放回)
+ */
+export declare const PROFILE_TOOL_SETS: Record<ToolProfile, ReadonlySet<string>>;
+/**
+ * 解析 profile
+ *
+ * 优先级:
+ *   1. env.COA_ENGRAM_TOOLS_PROFILE / CO_ENGRAM_TOOLS_PROFILE
+ *   2. persistedConfig.toolsProfile
+ *   3. 默认 'standard'
+ *
+ * 未知值降级为默认 + 记录警告(调用方决定如何 logging)
+ */
+export declare function resolveProfile(env: Record<string, string | undefined>, persistedConfig?: {
+    readonly toolsProfile?: string;
+}): {
+    profile: ToolProfile;
+    source: "env" | "persisted" | "default";
+    warned?: string;
+};
+/**
+ * 按 profile 过滤工具列表
+ *
+ * full profile 不过滤(返回原数组)。
+ * minimal / standard 用 Set.has() 过滤。
+ */
+export declare function filterToolsByProfile(tools: readonly Tool[], profile: ToolProfile): readonly Tool[];
+/**
+ * 暴露给测试 / 日志:每档 profile 的工具数量
+ *
+ * 15 轮拉通 R13 实证:此前硬编码 11/17/28 全错(实际 12/18/29)。
+ * 改用 .size 自动算,永久防回归。
+ */
+export declare const PROFILE_TOOL_COUNTS: Record<ToolProfile, number>;
+//# sourceMappingURL=tool-profile.d.ts.map

package/dist/tools/tool-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-profile.d.ts","sourceRoot":"","sources":["../../src/tools/tool-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CA+EtE,CAAC;AAaF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,eAAe,CAAC,EAAE;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD;IACD,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAwBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,WAAW,GACnB,SAAS,IAAI,EAAE,CAIjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI3D,CAAC"}

package/dist/tools/tool-profile.js

@@ -0,0 +1,174 @@
+/**
+ * 工具暴露 profile(host-agnostic 单一源)
+ *
+ * 15 轮拉通分析的元2「双宿主无契约」修复:
+ * 此前 PROFILE_TOOL_SETS / PROFILE_TOOL_COUNTS 只存在于 claude-code-mcp,
+ * openclaw-plugin 完全没有 profile 选择机制。R13 实证 PROFILE_TOOL_COUNTS
+ * 三档全错(minimal 写 11 实际 12,standard 写 17 实际 18,full 写 28 实际 29)。
+ *
+ * 修复方向:host-agnostic 概念应放 core 单一源,两宿主 re-export 引用,
+ * 契约测试 trivially 满足(同一份对象引用)。PROFILE_TOOL_COUNTS 用 .size
+ * 自动算,永久防回归。
+ *
+ * @module @co-engram/core/tools
+ */
+/**
+ * 每档 profile 包含的工具名集合
+ *
+ * minimal: 12 个 —— 核心读写 + proposal 处理三件套 + engram_sync
+ *   proposal 工具进 minimal 的原因:维护引擎默认在后台运行,会持续产生
+ *   proposals。若 minimal 暴露了"待审核候选 N 条"提示却不容许处理,会形成
+ *   "看得到但处理不了"的体验断裂。把 list/accept/dismiss 提供到 minimal,
+ *   让 agent 在任何 profile 下都能闭环处理 proposal。
+ *   engram_sync 进 minimal:让所有 profile 都能主动掌控提交时机。
+ *
+ * standard: 19 个 = minimal 12 + 学习回路 + contradiction + 数据管理 +
+ *   自愈/路径树 + engram_synthesize + engram_audit_query
+ *
+ * full: 29 个 = 全部 native 工具(包含隐藏的管理类工具,调试用),
+ *   但不含 skill_invoke —— 它是 P0 stub(Task 3.2 移除,等 P1 真正实现再放回)
+ */
+export const PROFILE_TOOL_SETS = {
+    minimal: new Set([
+        "engram_search",
+        "engram_get",
+        "engram_create",
+        "engram_update",
+        "engram_list",
+        "synapse_create",
+        "engram_reinforce",
+        "engram_report_failure",
+        // proposal 处理三件套(避免后台 proposal 累积但无法闭环)
+        "engram_list_proposals",
+        "engram_accept_proposal",
+        "engram_dismiss_proposal",
+        // 手动 pull/commit/push(让所有 profile 都能主动掌控提交时机)
+        "engram_sync",
+    ]),
+    standard: new Set([
+        // minimal 12
+        "engram_search",
+        "engram_get",
+        "engram_create",
+        "engram_update",
+        "engram_list",
+        "synapse_create",
+        "engram_reinforce",
+        "engram_report_failure",
+        "engram_list_proposals",
+        "engram_accept_proposal",
+        "engram_dismiss_proposal",
+        "engram_sync",
+        // 学习回路 + contradiction + 数据管理
+        "engram_delete",
+        "close_learning_loop",
+        "contradiction_resolve",
+        // 仓库健康工具(自愈扫描 + 渐进式披露,面向所有用户)
+        "engram_doctor",
+        "engram_list_paths",
+        // LLM 综合(手工触发 REM,需 llmClient 注入)
+        "engram_synthesize",
+        // 审计查询(让挑剔用户不开 viewer 也能查事件历史)
+        "engram_audit_query",
+    ]),
+    full: new Set([
+        // 全部 native 工具(含自愈/路径树等高级工具)
+        "engram_create",
+        "engram_get",
+        "engram_update",
+        "engram_delete",
+        "engram_search",
+        "engram_list",
+        "engram_reinforce",
+        "engram_report_failure",
+        "engram_archive",
+        "engram_restore",
+        "engram_forget",
+        "engram_recompute_importance",
+        "synapse_create",
+        "synapse_get",
+        "synapse_list",
+        "synapse_delete",
+        "skill_get",
+        "close_learning_loop",
+        "contradiction_resolve",
+        "get_evolution_lineage",
+        "upgrade_verification",
+        "engram_list_proposals",
+        "engram_accept_proposal",
+        "engram_dismiss_proposal",
+        // 仓库健康工具(full-only)
+        "engram_doctor",
+        "engram_list_paths",
+        // LLM 综合
+        "engram_synthesize",
+        // 审计查询(让挑剔用户不开 viewer 也能查事件历史)
+        "engram_audit_query",
+        // 手动 pull/commit/push
+        "engram_sync",
+    ]),
+};
+const DEFAULT_PROFILE = "standard";
+/**
+ * 已知的 profile 值(用于验证)
+ */
+const KNOWN_PROFILES = new Set([
+    "minimal",
+    "standard",
+    "full",
+]);
+/**
+ * 解析 profile
+ *
+ * 优先级:
+ *   1. env.COA_ENGRAM_TOOLS_PROFILE / CO_ENGRAM_TOOLS_PROFILE
+ *   2. persistedConfig.toolsProfile
+ *   3. 默认 'standard'
+ *
+ * 未知值降级为默认 + 记录警告(调用方决定如何 logging)
+ */
+export function resolveProfile(env, persistedConfig) {
+    const envValue = env.CO_ENGRAM_TOOLS_PROFILE ?? env.COA_ENGRAM_TOOLS_PROFILE;
+    if (envValue !== undefined && envValue !== "") {
+        if (KNOWN_PROFILES.has(envValue)) {
+            return { profile: envValue, source: "env" };
+        }
+        return {
+            profile: DEFAULT_PROFILE,
+            source: "env",
+            warned: `Unknown CO_ENGRAM_TOOLS_PROFILE="${envValue}" (valid: minimal | standard | full), falling back to "${DEFAULT_PROFILE}"`,
+        };
+    }
+    if (persistedConfig?.toolsProfile &&
+        KNOWN_PROFILES.has(persistedConfig.toolsProfile)) {
+        return {
+            profile: persistedConfig.toolsProfile,
+            source: "persisted",
+        };
+    }
+    return { profile: DEFAULT_PROFILE, source: "default" };
+}
+/**
+ * 按 profile 过滤工具列表
+ *
+ * full profile 不过滤(返回原数组)。
+ * minimal / standard 用 Set.has() 过滤。
+ */
+export function filterToolsByProfile(tools, profile) {
+    if (profile === "full")
+        return tools;
+    const set = PROFILE_TOOL_SETS[profile];
+    return tools.filter((t) => set.has(t.name));
+}
+/**
+ * 暴露给测试 / 日志:每档 profile 的工具数量
+ *
+ * 15 轮拉通 R13 实证:此前硬编码 11/17/28 全错(实际 12/18/29)。
+ * 改用 .size 自动算,永久防回归。
+ */
+export const PROFILE_TOOL_COUNTS = {
+    minimal: PROFILE_TOOL_SETS.minimal.size,
+    standard: PROFILE_TOOL_SETS.standard.size,
+    full: PROFILE_TOOL_SETS.full.size,
+};
+//# sourceMappingURL=tool-profile.js.map

package/dist/tools/tool-profile.js.map

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

package/dist/tools/tool.d.ts

@@ -69,6 +69,30 @@ export interface ToolContext {
      * OpenClaw 适配器从 plugin config.defaultCreatedBy 读取。
      */
     readonly defaultCreatedBy?: string;
+    /**
+     * LLM 客户端（可选，用于 engram_synthesize 等需要语义综合的工具）。
+     *
+     * host adapter 注入；claude-code-mcp 走 Anthropic API，
+     * openclaw-plugin 走 OpenAI-compatible endpoint。
+     * 不注入时，engram_synthesize 等工具会拒绝调用并给出明确错误。
+     */
+    readonly llmClient?: import("../observability/necessity-evaluator.js").LlmClient;
+    /**
+     * 标记仓库脏（记忆内容发生变化）。
+     *
+     * 写操作工具在成功执行后调用此回调。
+     * 宿主在会话结束后据此判断是否需要 git commit。
+     */
+    markDirty?: () => void;
+    /**
+     * 宿主标识(P0-4:双宿主契约不一致修复)。
+     *
+     * 由 host adapter 在构造 ToolContext 时注入(claude-code-mcp 或 openclaw-plugin)。
+     * 工具在 auditLog.append 时透传,让 AuditEntry.host 字段记录来源宿主,
+     * 便于跨宿主行为审计与归因。未注入时 audit entry 的 host 字段为 undefined
+     * (向后兼容:旧调用路径不强制要求)。
+     */
+    readonly host?: "claude-code-mcp" | "openclaw-plugin" | string;
 }
 /**
  * 统一 Tool 接口

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

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,0BAA0B,EAAE,gBAAgB,CAAC;IACzE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAC;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,8BAA8B,EAAE,kBAAkB,CAAC;IACxF,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,sBAAsB,EAAE,cAAc,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,UAAU,CAAC;IAC/D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,QAAQ,CAAC;IACrE;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,2CAA2C,EAAE,oBAAoB,CAAC;IACzG;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,qCAAqC,EAAE,cAAc,CAAC;IACvF;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ;IAC9D,mBAAmB;IACnB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CASpE"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,0BAA0B,EAAE,gBAAgB,CAAC;IACzE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAC;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,8BAA8B,EAAE,kBAAkB,CAAC;IACxF,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,sBAAsB,EAAE,cAAc,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,UAAU,CAAC;IAC/D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,QAAQ,CAAC;IACrE;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,2CAA2C,EAAE,oBAAoB,CAAC;IACzG;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,qCAAqC,EAAE,cAAc,CAAC;IACvF;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,yCAAyC,EAAE,SAAS,CAAC;IACjF;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ;IAC9D,mBAAmB;IACnB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CASpE"}

package/dist/tools/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6EH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAkB,EAAE,GAAY;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqGH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAkB,EAAE,GAAY;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC"}

package/dist/types/disclosure.d.ts

@@ -52,6 +52,13 @@ export interface SearchFilter {
     readonly createdAfter?: string;
     readonly createdBefore?: string;
     readonly minImportance?: number;
+    /**
+     * 情境标签过滤(P0-3 修复:此前 interface / Zod schema / matchesFilter 三方都缺
+     * contextTags 字段,Zod 默认 strip unknown keys 导致用户传入被静默吞,所有
+     * engram 都通过 filter)。语义:engram.contextTags 与 filter.contextTags 有
+     * 交集则通过(与 domainTags 同语义)。
+     */
+    readonly contextTags?: readonly string[];
 }
 /** 检索请求 */
 export interface SearchRequest {

package/dist/types/disclosure.d.ts.map

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