@co-engram/openclaw 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yang Yang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# Co-Engram
+
+**Team memory with neuroscience-inspired plasticity.**
+English | [中文](./README.zh-CN.md)
+
+Co-Engram is a self-evolving memory system for AI agents and teams. Unlike traditional vector stores that only retrieve, Co-Engram models memory after the brain: engrams strengthen with use, weaken when they fail, consolidate during sleep, and verify themselves through metacognition.
+
+Works with **Claude Code** (via MCP) and **OpenClaw** (via plugin SDK), with a host-agnostic TypeScript core you can embed anywhere.
+
+## Why Co-Engram
+
+| Differentiator            | What it means                                                                                                                                                                    |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Three-file separation** | Every memory is split into `content.md` / `meta.yaml` / `synapses.yaml` so content diffs stay clean in Git while metadata evolves independently.                                 |
+| **Self-maintaining**      | A maintenance engine runs `light` (RPE-based reinforcement), `deep` (consolidation), and `rem` (metacognition upgrade/refute) stages automatically — no manual tagging required. |
+| **Host-agnostic core**    | `@co-engram/core` has zero host dependencies. Same memory, same tools, whether you use Claude Code, OpenClaw, or your own agent.                                                 |
+
+## Quickstart
+
+Three commands to get Co-Engram working inside Claude Code:
+
+```bash
+# 1. Install the MCP server globally
+npm install -g @co-engram/claude-code
+
+# 2. Initialize the data repo (a separate Git repo, not inside this project)
+mkdir -p ~/team-memory && cd ~/team-memory && git init
+
+# 3. Wire into Claude Code
+claude mcp add co-engram \
+  -e CO_ENGRAM_DATA_ROOT=$HOME/team-memory \
+  -e CO_ENGRAM_MAINTENANCE=1 \
+  --scope user \
+  -- co-engram-mcp
+```
+
+Restart Claude Code, run `/mcp` in a new session, and you should see 25 `co-engram` tools loaded.
+
+**Zero-install alternative** (skip step 1): replace `co-engram-mcp` in step 3 with `npx -y @co-engram/claude-code`.
+
+For OpenClaw integration, see [docs/host-openclaw.md](./docs/host-openclaw.md).
+
+## Architecture
+
+```mermaid
+flowchart TB
+  subgraph Host["Host layer"]
+    CC["Claude Code"]
+    OC["OpenClaw"]
+  end
+
+  subgraph Adapter["Adapter layer"]
+    A1["@co-engram/claude-code<br/>(MCP server, stdio)"]
+    A2["@co-engram/openclaw<br/>(plugin SDK)"]
+  end
+
+  subgraph Core["@co-engram/core<br/>(host-agnostic)"]
+    Tools["25 tools<br/>engrams · synapses · skills"]
+    Engine["Maintenance engine<br/>light · deep · rem"]
+    Retrieval["FTS + graph retrieval"]
+  end
+
+  subgraph Data["Data layer (separate Git repo)"]
+    Engrams["engrams/{content,meta,synapses}"]
+    Skills["skills/"]
+  end
+
+  subgraph Cache["Cache layer (gitignored)"]
+    Derived[".co-engram/<br/>FTS index · vectors"]
+  end
+
+  CC --> A1
+  OC --> A2
+  A1 --> Tools
+  A2 --> Tools
+  Tools --> Engine
+  Tools --> Retrieval
+  Retrieval --> Derived
+  Engine --> Data
+  Tools --> Data
+```
+
+## Packages
+
+| Package                                                | What it does                                                | Install                              |
+| ------------------------------------------------------ | ----------------------------------------------------------- | ------------------------------------ |
+| [`@co-engram/core`](./packages/core)                   | Host-agnostic memory engine + 25 tools + maintenance engine | `npm install @co-engram/core`        |
+| [`@co-engram/claude-code`](./packages/claude-code-mcp) | MCP server adapter for Claude Code                          | `npm install @co-engram/claude-code` |
+| [`@co-engram/openclaw`](./packages/openclaw-plugin)    | Plugin SDK adapter for OpenClaw                             | `npm install @co-engram/openclaw`    |
+| [`@co-engram/e2e`](./packages/e2e)                     | Cross-host end-to-end tests (private, not published)        | workspace only                       |
+
+## Tool Catalog
+
+Co-Engram exposes **25 native tools** grouped into five concerns, plus 2 OpenClaw-compatible `memory_*` wrappers (registered only under `@co-engram/openclaw`).
+
+**Engrams** (12) — the core memory units
+`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`
+
+**Synapses** (4) — typed connections between engrams
+`synapse_create` · `synapse_get` · `synapse_list` · `synapse_delete`
+
+**Skills** (2) — procedural memory
+`skill_get` · `skill_invoke`
+
+**Learning loop** (4) — verification, contradiction, evolution
+`close_learning_loop` · `contradiction_resolve` · `upgrade_verification` · `get_evolution_lineage`
+
+**Memory proposals** (3) — implicit capture from conversations
+`engram_list_proposals` · `engram_accept_proposal` · `engram_dismiss_proposal`
+
+**OpenClaw memory protocol** (2) — host-compatible wrappers, registered only under `@co-engram/openclaw`
+`memory_search` · `memory_get`
+
+> The `memory_*` tools declare `kind: "memory"` in `openclaw.plugin.json` so OpenClaw treats Co-Engram as the primary memory plugin (mutually exclusive with `memory-core`). They are thin adapters over `engram_search` / `engram_get` that hide Co-Engram internal terminology and inject a self-evolving prompt section via `registerMemoryCapability.promptBuilder`.
+
+For full signatures, inputs, and examples, see [docs/tool-reference.md](./docs/tool-reference.md).
+
+## Configuration
+
+### Environment variables (Claude Code MCP server)
+
+All optional. Set them in `claude mcp add -e KEY=value` or your shell.
+
+| Variable                                  | Default              | Purpose                                                                                                                             |
+| ----------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `CO_ENGRAM_DATA_ROOT`                     | `$HOME/team-memory`  | Absolute path to the data Git repo                                                                                                  |
+| `CO_ENGRAM_DEFAULT_CREATED_BY`            | `unknown`            | Default author for new engrams                                                                                                      |
+| `CO_ENGRAM_LANGUAGE`                      | `en`                 | Language for tool descriptions / viewer UI / prompts (`en` \| `zh`). Falls back to `~/team-memory/.co-engram/config.json` if unset. |
+| `CO_ENGRAM_MAINTENANCE`                   | `0`                  | Set to `1` to start the maintenance engine                                                                                          |
+| `CO_ENGRAM_MAINTENANCE_ENABLED_STAGES`    | `light,deep,rem`     | Comma-separated stage list                                                                                                          |
+| `CO_ENGRAM_MAINTENANCE_LIGHT_INTERVAL_MS` | `300000` (5 min)     | Light stage interval                                                                                                                |
+| `CO_ENGRAM_MAINTENANCE_DEEP_INTERVAL_MS`  | `3600000` (1 hour)   | Deep stage interval                                                                                                                 |
+| `CO_ENGRAM_MAINTENANCE_REM_INTERVAL_MS`   | `604800000` (7 days) | REM stage interval                                                                                                                  |
+| `CO_ENGRAM_MAINTENANCE_LEARNING_RATE`     | `0.1`                | RPE learning rate                                                                                                                   |
+
+### OpenClaw manifest config
+
+For OpenClaw, configuration goes in the plugin manifest. See [docs/host-openclaw.md](./docs/host-openclaw.md) for the full schema.
+
+### One-shot setup for OpenClaw hosts
+
+After installing the plugin into a co-claw / OpenClaw gateway, run the bundled setup
+script to merge recommended defaults into `~/.openclaw/openclaw.json` and claim the
+`memory` exclusive slot:
+
+```bash
+# Dry-run: prints the planned diff, no writes
+pnpm --filter @co-engram/openclaw apply:openclaw
+
+# Apply (writes config + timestamped backup)
+pnpm --filter @co-engram/openclaw apply:openclaw --yes
+
+# Apply + restart gateway
+pnpm --filter @co-engram/openclaw apply:openclaw --yes --restart
+
+# Via the published bin (no checkout needed)
+npx @co-engram/openclaw setup --yes --restart
+```
+
+The merge is idempotent and only fills fields the user has not set explicitly —
+existing values (including `false`) are preserved. Recommended defaults:
+
+| Field              | Value  | Why                                    |
+| ------------------ | ------ | -------------------------------------- |
+| `language`         | `"zh"` | Tool descriptions / viewer UI language |
+| `startMaintenance` | `true` | Run light/deep/rem auto-maintenance    |
+| `startViewer`      | `true` | HTTP viewer on `127.0.0.1:18799`       |
+| `auditEnabled`     | `true` | Persist `.co-engram/audit.jsonl`       |
+
+Note: `startMaintenance` / `startViewer` / `auditEnabled` already default to
+`true` in the manifest configSchema (so zero-config installs get them for free).
+This script forces them on even for hosts that already shipped with older
+defaults, and additionally claims `plugins.slots.memory` (which manifest cannot
+do alone — it requires the host to record the slot).
+
+## Comparisons
+
+| Feature              | Co-Engram                 | mem0               | Letta            | LangChain Memory   |
+| -------------------- | ------------------------- | ------------------ | ---------------- | ------------------ |
+| Storage model        | 3-file Git-friendly       | Vector + graph     | Vector + state   | Vector / key-value |
+| Plasticity (LTP/LTD) | Yes (RPE-driven)          | Manual API         | Manual API       | Manual API         |
+| Auto maintenance     | Yes (light/deep/rem)      | No                 | No               | No                 |
+| Metacognition        | Yes (5-dim truth score)   | No                 | No               | No                 |
+| Host coupling        | None (host-agnostic core) | Tight (Python SDK) | Tight (REST API) | Tight (Python SDK) |
+| License              | MIT                       | Apache-2.0         | Apache-2.0       | MIT                |
+
+## Roadmap
+
+See [GitHub Issues](https://github.com/co-engram/co-engram/issues) for the live roadmap. Highlights:
+
+- **TypeDoc-generated tool reference** — replace hand-written `docs/tool-reference.md` with auto-generated API docs
+- **Provider-backed abstraction layer** — LLM-driven REM stage for narrative abstraction
+- **Web UI** — browse engrams, inspect synapse graph, trigger maintenance manually
+- **More host adapters** — Continue.dev, Cursor, Aider
+- **1.0 release** — once API is stable and we have real production users
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, test commands, and PR conventions. For security reports, see [SECURITY.md](./SECURITY.md).
+
+## License
+
+[MIT](./LICENSE) — © 2026 Yang Yang

package/dist/adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Adapter：把 host-agnostic 的 Co-Engram Tool 转为 OpenClaw ToolDescriptor
+ *
+ * @module @co-engram/openclaw
+ */
+import { type Tool, type ToolContext, type Language } from "@co-engram/core";
+import type { OpenClawToolDescriptor, ToolExecuteResult } from "./types.js";
+/**
+ * 把任意值包装为 OpenClaw tool execute 的返回结构
+ *
+ * 对常见的列表型返回(engram_list / engram_search / memory_search 等),渲染为
+ * markdown 文本而不是 JSON——OpenClaw 收到 type:'json' 时会把数组渲染成"图表",
+ * 让 LLM 误判为不可读。改用 type:'text' + markdown,LLM 一眼就能解析。
+ */
+/**
+ * 把任意值包装为 OpenClaw tool execute 的返回结构
+ *
+ * 对常见的列表型返回(engram_list / engram_search / memory_search 等),渲染为
+ * markdown 文本而不是 JSON——OpenClaw 收到 type:'json' 时会把数组渲染成"图表",
+ * 让 LLM 误判为不可读。改用 type:'text' + markdown,LLM 一眼就能解析。
+ *
+ * 同时识别 engram_get / memory_get 的非列表形状,避免 OpenClaw UI 把单条 engram
+ * 数据渲染成"卡片/图表",让 agent 误以为"图片没显示"。
+ */
+export declare function toToolResult(data: unknown, ctx: ToolContext): ToolExecuteResult;
+/**
+ * 把单个 Co-Engram Tool 转为 OpenClaw ToolDescriptor
+ *
+ * @param language 工具描述本地化语言(默认英文)
+ */
+export declare function adaptTool(tool: Tool, ctx: ToolContext, language?: Language): OpenClawToolDescriptor;
+/**
+ * 批量适配所有工具
+ */
+export declare function adaptAllTools(tools: readonly Tool[], ctx: ToolContext, language?: Language): readonly OpenClawToolDescriptor[];
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAGpB;;;;;;GAMG;AACH;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,GACf,iBAAiB,CAiBnB;AAkSD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,WAAW,EAChB,QAAQ,GAAE,QAA2B,GACpC,sBAAsB,CAwBxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,GAAG,EAAE,WAAW,EAChB,QAAQ,GAAE,QAA2B,GACpC,SAAS,sBAAsB,EAAE,CAEnC"}

package/dist/adapter.js

@@ -0,0 +1,330 @@
+/**
+ * Adapter：把 host-agnostic 的 Co-Engram Tool 转为 OpenClaw ToolDescriptor
+ *
+ * @module @co-engram/openclaw
+ */
+import { localizeToolDescription, resolveLlmDescription, DEFAULT_LANGUAGE, } from "@co-engram/core";
+import { TOOL_JSON_SCHEMAS } from "./json-schemas.js";
+/**
+ * 把任意值包装为 OpenClaw tool execute 的返回结构
+ *
+ * 对常见的列表型返回(engram_list / engram_search / memory_search 等),渲染为
+ * markdown 文本而不是 JSON——OpenClaw 收到 type:'json' 时会把数组渲染成"图表",
+ * 让 LLM 误判为不可读。改用 type:'text' + markdown,LLM 一眼就能解析。
+ */
+/**
+ * 把任意值包装为 OpenClaw tool execute 的返回结构
+ *
+ * 对常见的列表型返回(engram_list / engram_search / memory_search 等),渲染为
+ * markdown 文本而不是 JSON——OpenClaw 收到 type:'json' 时会把数组渲染成"图表",
+ * 让 LLM 误判为不可读。改用 type:'text' + markdown,LLM 一眼就能解析。
+ *
+ * 同时识别 engram_get / memory_get 的非列表形状,避免 OpenClaw UI 把单条 engram
+ * 数据渲染成"卡片/图表",让 agent 误以为"图片没显示"。
+ */
+export function toToolResult(data, ctx) {
+    const text = renderForLlm(data, ctx);
+    if (text !== null) {
+        return {
+            content: [{ type: "text", text }],
+            details: { ok: true },
+        };
+    }
+    return {
+        content: [
+            {
+                type: "json",
+                data,
+            },
+        ],
+        details: { ok: true },
+    };
+}
+/**
+ * 把工具返回值渲染为 LLM 友好的 markdown 文本
+ *
+ * 已识别模式(全部渲染为 type:'text',避免 OpenClaw UI 把 JSON 渲染成
+ * 图表卡片让 agent 误判为"图片没显示"):
+ *
+ *   1. { results: [...], total }  — engram_list / engram_search / memory_search
+ *   2. { tier: 'catalog'|'digest'|'content'|'meta'|'synapses', ... }  — engram_get
+ *   3. { id, content, metadata, relatedIds }  — memory_get
+ *
+ * summary 处理:catalog 级结果(engram_list)本身不带 summary,这里通过
+ * ctx.repository.readDigest(id) 在 adapter 层附加,保持 core 工具的返回类型不变。
+ * 检索类工具(engram_search/memory_search)结果可能自带 summary,优先用自带的。
+ *
+ * 不识别的返回 null(调用方回退到 JSON)。
+ */
+function renderForLlm(data, ctx) {
+    if (!data || typeof data !== "object")
+        return null;
+    const obj = data;
+    // 模式 1:列表型
+    if (Array.isArray(obj["results"])) {
+        return renderListResult(obj, ctx);
+    }
+    // 模式 2:engram_get(tier-based) — tier 是已知字符串即识别
+    //   catalog/digest/content/meta 都有 entry;synapses 只有 bundle(无 entry)
+    const tier = obj["tier"];
+    if (typeof tier === "string" &&
+        /^(catalog|digest|content|meta|synapses)$/.test(tier)) {
+        return renderEngramGetResult(obj);
+    }
+    // 模式 3:memory_get(id + content + metadata + relatedIds)
+    if (typeof obj["id"] === "string" &&
+        typeof obj["content"] === "string" &&
+        typeof obj["metadata"] === "object") {
+        return renderMemoryGetResult(obj);
+    }
+    return null;
+}
+/** 渲染列表型结果(engram_list / engram_search / memory_search) */
+function renderListResult(obj, ctx) {
+    const results = obj["results"];
+    const lines = [];
+    const total = typeof obj["total"] === "number"
+        ? obj["total"]
+        : results.length;
+    lines.push(`共 ${total} 条记忆(展示前 ${results.length} 条):`);
+    lines.push("");
+    for (let i = 0; i < results.length; i++) {
+        const item = results[i];
+        if (!item || typeof item !== "object")
+            continue;
+        const id = String(item["id"] ?? "?");
+        const title = String(item["title"] ?? "(无标题)");
+        const explicitSummary = item["summary"] ? String(item["summary"]) : "";
+        const summary = explicitSummary || (id !== "?" ? safeReadDigestSummary(ctx, id) : "");
+        // kind / tags 兼容两种形状:
+        //   - engram_list/engram_search: item.kind, item.domainTags(顶层)
+        //   - memory_search: item.metadata.kind, item.metadata.tags(嵌套 metadata)
+        const meta = typeof item["metadata"] === "object"
+            ? item["metadata"]
+            : {};
+        const kind = item["kind"]
+            ? String(item["kind"])
+            : meta["kind"]
+                ? String(meta["kind"])
+                : "";
+        const rawTags = Array.isArray(item["domainTags"])
+            ? item["domainTags"]
+            : Array.isArray(meta["tags"])
+                ? meta["tags"]
+                : [];
+        const tags = rawTags.map(String).join(", ");
+        const score = typeof item["score"] === "number"
+            ? ` (score: ${item["score"].toFixed(2)})`
+            : "";
+        lines.push(`${i + 1}. **${title}**${score}`);
+        lines.push(`   - id: \`${id}\``);
+        if (kind)
+            lines.push(`   - kind: ${kind}`);
+        if (tags)
+            lines.push(`   - tags: ${tags}`);
+        if (summary)
+            lines.push(`   - summary: ${summary}`);
+    }
+    lines.push("");
+    lines.push("用户想看某条的完整内容时,根据 id 调 engram_get 或 memory_get。");
+    return lines.join("\n");
+}
+/** 渲染 engram_get 各 tier 结果 */
+function renderEngramGetResult(obj) {
+    const tier = String(obj["tier"] ?? "");
+    const entry = obj["entry"];
+    const lines = [];
+    // synapses tier 没有 entry,但有 bundle — 直接走突触渲染
+    if (tier === "synapses") {
+        return renderSynapsesBundle(obj);
+    }
+    if (entry) {
+        const title = String(entry["title"] ?? "(无标题)");
+        const id = String(entry["id"] ?? "?");
+        const kind = entry["kind"] ? String(entry["kind"]) : "";
+        const tags = Array.isArray(entry["domainTags"])
+            ? entry["domainTags"].map(String).join(", ")
+            : "";
+        lines.push(`## ${title}`);
+        lines.push("");
+        lines.push(`- id: \`${id}\``);
+        if (kind)
+            lines.push(`- kind: ${kind}`);
+        if (tags)
+            lines.push(`- tags: ${tags}`);
+        lines.push("");
+    }
+    if (tier === "content" && typeof obj["content"] === "string") {
+        lines.push("### 内容");
+        lines.push("");
+        lines.push(obj["content"]);
+        return lines.join("\n");
+    }
+    if (tier === "digest") {
+        const digest = obj["digest"];
+        if (digest) {
+            lines.push("### 摘要");
+            lines.push("");
+            if (typeof digest["summary"] === "string" && digest["summary"]) {
+                lines.push(String(digest["summary"]));
+            }
+            if (typeof digest["importance"] === "number") {
+                lines.push(``);
+                lines.push(`importance: ${digest["importance"]}`);
+            }
+            lines.push(``);
+            lines.push(`(digest tier — 要完整内容调 \`engram_get(id, tier="content")\`)`);
+        }
+        return lines.join("\n");
+    }
+    if (tier === "meta") {
+        const meta = obj["meta"];
+        if (meta) {
+            lines.push("### 元数据");
+            lines.push("");
+            for (const [k, v] of Object.entries(meta)) {
+                if (k === "content")
+                    continue;
+                lines.push(`- ${k}: ${formatMetaValue(v)}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    if (tier === "catalog") {
+        lines.push(`(catalog tier — 只有元数据;要完整内容调 \`engram_get(id, tier="content")\`)`);
+        return lines.join("\n");
+    }
+    if (tier === "synapses") {
+        return renderSynapsesBundle(obj);
+    }
+    return lines.join("\n");
+}
+/** 渲染 synapses bundle(engram_get synapses tier) */
+function renderSynapsesBundle(obj) {
+    const bundle = obj["bundle"];
+    const lines = [];
+    if (!bundle)
+        return "(无 synapses)";
+    lines.push("### 突触(synapses)");
+    lines.push("");
+    const outgoing = Array.isArray(bundle["outgoing"]) ? bundle["outgoing"] : [];
+    const incoming = Array.isArray(bundle["incoming"]) ? bundle["incoming"] : [];
+    if (outgoing.length > 0) {
+        lines.push(`**Outgoing (${outgoing.length}):**`);
+        for (const s of outgoing) {
+            const to = String(s["to"] ?? "?");
+            const kind = String(s["kind"] ?? "?");
+            const weight = typeof s["weight"] === "number" ? s["weight"] : "";
+            lines.push(`- → \`${to}\` (${kind}${weight !== "" ? `, w=${weight}` : ""})`);
+        }
+        lines.push("");
+    }
+    if (incoming.length > 0) {
+        lines.push(`**Incoming (${incoming.length}):**`);
+        for (const s of incoming) {
+            const from = String(s["from"] ?? "?");
+            const kind = String(s["kind"] ?? "?");
+            const weight = typeof s["weight"] === "number" ? s["weight"] : "";
+            lines.push(`- ← \`${from}\` (${kind}${weight !== "" ? `, w=${weight}` : ""})`);
+        }
+    }
+    if (outgoing.length === 0 && incoming.length === 0) {
+        lines.push("(无 synapses)");
+    }
+    return lines.join("\n");
+}
+/** 渲染 memory_get 结果(OpenClaw 兼容包装) */
+function renderMemoryGetResult(obj) {
+    const id = String(obj["id"] ?? "?");
+    const content = String(obj["content"] ?? "");
+    const metadata = obj["metadata"];
+    const relatedIds = Array.isArray(obj["relatedIds"])
+        ? obj["relatedIds"]
+        : [];
+    const lines = [];
+    lines.push(`## Memory \`${id}\``);
+    lines.push("");
+    if (metadata) {
+        lines.push("### 元数据");
+        lines.push("");
+        for (const [k, v] of Object.entries(metadata)) {
+            lines.push(`- ${k}: ${formatMetaValue(v)}`);
+        }
+        lines.push("");
+    }
+    lines.push("### 内容");
+    lines.push("");
+    lines.push(content);
+    if (relatedIds.length > 0) {
+        lines.push("");
+        lines.push("### 相关记忆");
+        lines.push("");
+        for (const rid of relatedIds) {
+            lines.push(`- \`${String(rid)}\``);
+        }
+    }
+    return lines.join("\n");
+}
+/** 元数据值的紧凑展示 */
+function formatMetaValue(v) {
+    if (v === null || v === undefined)
+        return "(无)";
+    if (Array.isArray(v))
+        return v.map(String).join(", ");
+    if (typeof v === "object")
+        return JSON.stringify(v);
+    return String(v);
+}
+/**
+ * 安全读取 digest 的 summary,失败返回空字符串
+ *
+ * 用于给 catalog 级结果(engram_list)在 adapter 层补 summary。
+ */
+function safeReadDigestSummary(ctx, id) {
+    try {
+        return ctx.repository.readDigest(id)?.summary ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+function toErrorResult(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        details: { ok: false, error: message },
+    };
+}
+/**
+ * 把单个 Co-Engram Tool 转为 OpenClaw ToolDescriptor
+ *
+ * @param language 工具描述本地化语言(默认英文)
+ */
+export function adaptTool(tool, ctx, language = DEFAULT_LANGUAGE) {
+    const jsonSchema = TOOL_JSON_SCHEMAS[tool.name] ?? {
+        type: "object",
+        additionalProperties: true,
+    };
+    return {
+        name: tool.name,
+        label: tool.name,
+        description: resolveLlmDescription(tool, language, localizeToolDescription(tool.name, language, tool.description)),
+        parameters: jsonSchema,
+        async execute(_toolCallId, params, _signal) {
+            try {
+                const result = await tool.execute(params ?? {}, ctx);
+                return toToolResult(result, ctx);
+            }
+            catch (error) {
+                return toErrorResult(error);
+            }
+        },
+    };
+}
+/**
+ * 批量适配所有工具
+ */
+export function adaptAllTools(tools, ctx, language = DEFAULT_LANGUAGE) {
+    return tools.map((t) => adaptTool(t, ctx, language));
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/auto-onboard.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OpenClaw 插件专属:auto-onboard bundle 路径解析。
+ *
+ * 核心逻辑(findGitRepoRoot / autoOnboardMergeDriver 等)在 `@co-engram/core/merge/auto-onboard`,
+ * 这里只保留 host-specific 的 bundle 定位(取决于 host 的 node_modules 布局)。
+ *
+ * @module @co-engram/openclaw
+ */
+export { resolveMergeDriverBundle, findGitRepoRoot, autoOnboardMergeDriver, type AutoOnboardResult, } from "@co-engram/core";
+/**
+ * 自动定位已安装的 `@co-engram/core` 中的 merge-driver bundle。
+ *
+ * 通过 `createRequire` 解析 `@co-engram/core/types` 子路径,exports 字段已暴露。
+ * 该子路径只能 import 不能 require,所以显式传 `conditions: ['import','default']`。
+ *
+ * 失败(如 bundle 未构建 / 解析不到)返回 null,不抛错 —— auto-onboard 按跳过处理。
+ */
+export declare function findInstalledMergeDriverBundle(): string | null;
+//# sourceMappingURL=auto-onboard.d.ts.map

package/dist/auto-onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-onboard.d.ts","sourceRoot":"","sources":["../src/auto-onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,GAAG,IAAI,CAe9D"}