@co-engram/openclaw 0.1.0

package/dist/llm-client.js.map

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

package/dist/maintenance-runtime.d.ts

@@ -0,0 +1,31 @@
+/**
+ * OpenClaw Plugin Maintenance Runtime（P4 D.2）
+ *
+ * 把 @co-engram/core 的 MaintenanceEngine 桥接到 OpenClaw 插件生命周期。
+ *
+ * 职责：
+ *   - 创建 DreamingScheduler + MaintenanceEngine（如果尚未提供）
+ *   - 启动 setInterval + unref 自托管调度（不依赖 OpenClaw 的 cron API）
+ *   - 把 MaintenanceConfig.trash 透传到 scheduler.deepOptions.trash
+ *   - 提供 stop() 供宿主在 shutdown 时清理
+ *
+ * 使用：
+ *   const { stop } = startMaintenanceRuntime({ repository, signalSink, dreamingScheduler })
+ *   // ... 应用运行期间自动维护
+ *   process.on('SIGTERM', () => stop())
+ *
+ * @module @co-engram/openclaw
+ */
+import { MaintenanceEngine, type MaintenanceConfig, type MaintenanceDeps } from "@co-engram/core";
+/**
+ * 启动维护运行时
+ *
+ * 如果 deps.dreamingScheduler 未提供,会自动创建一个,并应用 trash 透传。
+ *
+ * @returns stop 函数（停止所有定时器）
+ */
+export declare function startMaintenanceRuntime(deps: MaintenanceDeps, config?: MaintenanceConfig): {
+    readonly engine: MaintenanceEngine;
+    readonly stop: () => void;
+};
+//# sourceMappingURL=maintenance-runtime.d.ts.map

package/dist/maintenance-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-runtime.d.ts","sourceRoot":"","sources":["../src/maintenance-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,iBAAiB,EAGjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAYzB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,EACrB,MAAM,GAAE,iBAAsB,GAC7B;IAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAiCnE"}

package/dist/maintenance-runtime.js

@@ -0,0 +1,61 @@
+/**
+ * OpenClaw Plugin Maintenance Runtime（P4 D.2）
+ *
+ * 把 @co-engram/core 的 MaintenanceEngine 桥接到 OpenClaw 插件生命周期。
+ *
+ * 职责：
+ *   - 创建 DreamingScheduler + MaintenanceEngine（如果尚未提供）
+ *   - 启动 setInterval + unref 自托管调度（不依赖 OpenClaw 的 cron API）
+ *   - 把 MaintenanceConfig.trash 透传到 scheduler.deepOptions.trash
+ *   - 提供 stop() 供宿主在 shutdown 时清理
+ *
+ * 使用：
+ *   const { stop } = startMaintenanceRuntime({ repository, signalSink, dreamingScheduler })
+ *   // ... 应用运行期间自动维护
+ *   process.on('SIGTERM', () => stop())
+ *
+ * @module @co-engram/openclaw
+ */
+import { MaintenanceEngine, createDreamingScheduler, } from "@co-engram/core";
+function trashToDeepOptions(trash) {
+    if (!trash?.enabled)
+        return undefined;
+    return {
+        afterDays: trash.afterDays,
+        purgeAfterDays: trash.purgeAfterDays,
+    };
+}
+/**
+ * 启动维护运行时
+ *
+ * 如果 deps.dreamingScheduler 未提供,会自动创建一个,并应用 trash 透传。
+ *
+ * @returns stop 函数（停止所有定时器）
+ */
+export function startMaintenanceRuntime(deps, config = {}) {
+    const schedulerConfig = {
+        lightIntervalMs: config.lightIntervalMs,
+        deepIntervalMs: config.deepIntervalMs,
+        remIntervalMs: config.remIntervalMs,
+        deepOptions: { trash: trashToDeepOptions(config.trash) },
+    };
+    const dreamingScheduler = deps.dreamingScheduler ??
+        createDreamingScheduler(deps.repository, schedulerConfig);
+    const engine = new MaintenanceEngine({
+        repository: deps.repository,
+        signalSink: deps.signalSink,
+        dreamingScheduler,
+        ...(deps.effectivenessTracker
+            ? { effectivenessTracker: deps.effectivenessTracker }
+            : {}),
+        ...(deps.dataRoot ? { dataRoot: deps.dataRoot } : {}),
+    }, config);
+    engine.start();
+    return {
+        engine,
+        stop: () => {
+            engine.stop();
+        },
+    };
+}
+//# sourceMappingURL=maintenance-runtime.js.map

package/dist/maintenance-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-runtime.js","sourceRoot":"","sources":["../src/maintenance-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAMxB,MAAM,iBAAiB,CAAC;AAEzB,SAAS,kBAAkB,CACzB,KAAyC;IAEzC,IAAI,CAAC,KAAK,EAAE,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAqB,EACrB,SAA4B,EAAE;IAE9B,MAAM,eAAe,GAA2B;QAC9C,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KACzD,CAAC;IAEF,MAAM,iBAAiB,GACrB,IAAI,CAAC,iBAAiB;QACtB,uBAAuB,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAClC;QACE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,iBAAiB;QACjB,GAAG,CAAC,IAAI,CAAC,oBAAoB;YAC3B,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE;YACrD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,EACD,MAAM,CACP,CAAC;IAEF,MAAM,CAAC,KAAK,EAAE,CAAC;IAEf,OAAO;QACL,MAAM;QACN,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/memory-tools.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OpenClaw 兼容的 memory_search / memory_get 工具
+ *
+ * 这两个工具是 co-engram 对 OpenClaw memory 标准协议的适配层：
+ *   - 触发 OpenClaw 核心的 memory section 系统提示注入
+ *   - 提供与 memory-core / flexmem-local 兼容的 schema
+ *   - 内部仍走 co-engram 的 FTS + 图检索 + RPE 强化闭环
+ *
+ * 与 co-engram 原生 25 个工具的关系：
+ *   - memory_search 是 engram_search 的"对外友好版"（隐藏内部术语）
+ *   - memory_get 是 engram_get 的"对外友好版"（简化 schema）
+ *   - 25 个原生工具仍全部注册，提供 synapse/RPE/metacognition 等高级功能
+ *
+ * @module @co-engram/openclaw
+ */
+import { type ToolContext, type Language } from "@co-engram/core";
+import type { OpenClawToolDescriptor } from "./types.js";
+/**
+ * memory_search 返回的单条结果（简化 schema，对 LLM 友好）
+ *
+ * 注:title 字段非 OpenClaw memory slot 协议核心字段,仅用于 adapter markdown 渲染
+ * 时显示可读标题(避免渲染为"(无标题)")。OpenClaw 核心协议不会因多出这个字段
+ * 报错(JSON schema 是 input 端,output 端是 ToolExecuteResult 不受 schema 约束)。
+ */
+export interface MemorySearchHit {
+    readonly id: string;
+    readonly title?: string;
+    readonly content: string;
+    readonly score: number;
+    readonly metadata: {
+        readonly createdAt: string;
+        readonly importance: number;
+        readonly truthScore?: number;
+        readonly tags: readonly string[];
+        readonly kind: string;
+    };
+}
+/**
+ * memory_get 返回的富结构（单条 engram 详情）
+ */
+export interface MemoryGetResult {
+    readonly id: string;
+    readonly content: string;
+    readonly metadata: {
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly createdBy: string;
+        readonly importance: number;
+        readonly truthScore?: number;
+        readonly reinforcementCount: number;
+        readonly lastReinforcedAt: string | null;
+        readonly tags: readonly string[];
+        readonly kind: string;
+        readonly verificationStatus?: string;
+    };
+    readonly relatedIds: readonly string[];
+}
+/**
+ * 创建 memory_search 工具（OpenClaw 兼容）
+ *
+ * 内部调用 ctx.searchOrchestrator + ctx.repository.readDigest，
+ * 包装为 OpenClaw 期望的 ToolDescriptor。
+ *
+ * @param ctx co-engram ToolContext（含 repository + searchOrchestrator）
+ * @param language 错误消息语言
+ */
+export declare function createMemorySearchTool(ctx: ToolContext, language?: Language): OpenClawToolDescriptor;
+/**
+ * 创建 memory_get 工具（OpenClaw 兼容）
+ *
+ * 返回单条 engram 的富结构（含完整 content + 元数据 + 相关 id 列表）。
+ * synapse 图不展开（relatedIds 仅返回 id），需要详情走 synapse_list。
+ *
+ * @param ctx co-engram ToolContext
+ * @param language 错误消息语言
+ */
+export declare function createMemoryGetTool(ctx: ToolContext, language?: Language): OpenClawToolDescriptor;
+/**
+ * 批量创建两个 memory 工具
+ */
+export declare function createMemoryTools(ctx: ToolContext, language?: Language): readonly OpenClawToolDescriptor[];
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../src/memory-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,QAAQ,EAEd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAGpB;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAiGD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,EAChB,QAAQ,GAAE,QAA2B,GACpC,sBAAsB,CAyCxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,QAAQ,GAAE,QAA2B,GACpC,sBAAsB,CAkDxB;AAgCD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,QAAQ,GAAE,QAA2B,GACpC,SAAS,sBAAsB,EAAE,CAKnC"}

package/dist/memory-tools.js

@@ -0,0 +1,237 @@
+/**
+ * OpenClaw 兼容的 memory_search / memory_get 工具
+ *
+ * 这两个工具是 co-engram 对 OpenClaw memory 标准协议的适配层：
+ *   - 触发 OpenClaw 核心的 memory section 系统提示注入
+ *   - 提供与 memory-core / flexmem-local 兼容的 schema
+ *   - 内部仍走 co-engram 的 FTS + 图检索 + RPE 强化闭环
+ *
+ * 与 co-engram 原生 25 个工具的关系：
+ *   - memory_search 是 engram_search 的"对外友好版"（隐藏内部术语）
+ *   - memory_get 是 engram_get 的"对外友好版"（简化 schema）
+ *   - 25 个原生工具仍全部注册，提供 synapse/RPE/metacognition 等高级功能
+ *
+ * @module @co-engram/openclaw
+ */
+import { DEFAULT_LANGUAGE, localizeToolDescription, } from "@co-engram/core";
+import { toToolResult as toAdaptedToolResult } from "./adapter.js";
+/**
+ * memory_search 的 JSON Schema
+ */
+const MEMORY_SEARCH_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        query: {
+            type: "string",
+            description: "Natural language search query.",
+            minLength: 1,
+        },
+        maxResults: {
+            type: "number",
+            description: "Maximum number of results to return (default: 5, max: 20).",
+            minimum: 1,
+            maximum: 20,
+        },
+        minScore: {
+            type: "number",
+            description: "Minimum relevance score (0-1). Results below this are filtered out.",
+            minimum: 0,
+            maximum: 1,
+        },
+    },
+    required: ["query"],
+};
+/**
+ * memory_get 的 JSON Schema
+ */
+const MEMORY_GET_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        id: {
+            type: "string",
+            description: "Engram ID returned by memory_search.",
+            minLength: 1,
+        },
+    },
+    required: ["id"],
+};
+const DEFAULT_MAX_RESULTS = 5;
+const HARD_MAX_RESULTS = 20;
+const DEFAULT_MIN_SCORE = 0;
+const CONTENT_SUMMARY_LIMIT = 500;
+function toErrorResult(error, language) {
+    const message = error instanceof Error ? error.message : String(error);
+    const prefix = language === "zh" ? "错误" : "Error";
+    return {
+        content: [{ type: "text", text: `${prefix}: ${message}` }],
+        details: { ok: false, error: message },
+    };
+}
+function clampMaxResults(value) {
+    const n = typeof value === "number" ? value : DEFAULT_MAX_RESULTS;
+    return Math.max(1, Math.min(n, HARD_MAX_RESULTS));
+}
+function clampMinScore(value) {
+    const n = typeof value === "number" ? value : DEFAULT_MIN_SCORE;
+    return Math.max(0, Math.min(n, 1));
+}
+function truncate(text, limit) {
+    if (text.length <= limit)
+        return text;
+    return text.slice(0, limit) + "...";
+}
+/**
+ * 把 EngramDigest 转为 MemorySearchHit
+ *
+ * 隐藏 co-engram 内部术语（emotionalValence / freshness / sourceType 等），
+ * 只暴露对 LLM 决策有用的字段。
+ */
+function digestToHit(digest, score) {
+    return {
+        id: digest.id,
+        title: digest.title,
+        content: truncate(digest.summary || digest.title, CONTENT_SUMMARY_LIMIT),
+        score,
+        metadata: {
+            createdAt: digest.updatedAt,
+            importance: digest.importance,
+            tags: digest.domainTags,
+            kind: digest.kind,
+        },
+    };
+}
+/**
+ * 创建 memory_search 工具（OpenClaw 兼容）
+ *
+ * 内部调用 ctx.searchOrchestrator + ctx.repository.readDigest，
+ * 包装为 OpenClaw 期望的 ToolDescriptor。
+ *
+ * @param ctx co-engram ToolContext（含 repository + searchOrchestrator）
+ * @param language 错误消息语言
+ */
+export function createMemorySearchTool(ctx, language = DEFAULT_LANGUAGE) {
+    return {
+        name: "memory_search",
+        label: "Memory Search",
+        description: localizeToolDescription("memory_search", language, "Search team memory (engrams) using natural language. Returns relevant memory snippets with relevance scores. Call this when the user asks about past decisions, preferences, people, dates, or project context."),
+        parameters: MEMORY_SEARCH_SCHEMA,
+        async execute(_toolCallId, params) {
+            try {
+                const p = (params ?? {});
+                const query = typeof p.query === "string" ? p.query : "";
+                if (!query.trim()) {
+                    throw new Error("query is required and must be non-empty");
+                }
+                if (!ctx.searchOrchestrator) {
+                    throw new Error("SearchOrchestrator not available");
+                }
+                const maxResults = clampMaxResults(p.maxResults);
+                const minScore = clampMinScore(p.minScore);
+                const rawResults = ctx.searchOrchestrator.search(query, undefined, maxResults);
+                const hits = [];
+                for (const r of rawResults) {
+                    if (r.score < minScore)
+                        continue;
+                    const digest = ctx.repository.readDigest(r.id);
+                    if (!digest)
+                        continue;
+                    hits.push(digestToHit(digest, r.score));
+                }
+                return toAdaptedToolResult({ results: hits, total: hits.length }, ctx);
+            }
+            catch (error) {
+                return toErrorResult(error, language);
+            }
+        },
+    };
+}
+/**
+ * 创建 memory_get 工具（OpenClaw 兼容）
+ *
+ * 返回单条 engram 的富结构（含完整 content + 元数据 + 相关 id 列表）。
+ * synapse 图不展开（relatedIds 仅返回 id），需要详情走 synapse_list。
+ *
+ * @param ctx co-engram ToolContext
+ * @param language 错误消息语言
+ */
+export function createMemoryGetTool(ctx, language = DEFAULT_LANGUAGE) {
+    return {
+        name: "memory_get",
+        label: "Memory Get",
+        description: localizeToolDescription("memory_get", language, "Read full content of a single memory (engram) by ID. Returns content, metadata (importance, truthScore, reinforcementCount), and related memory IDs. Use after memory_search to dive into specifics."),
+        parameters: MEMORY_GET_SCHEMA,
+        async execute(_toolCallId, params) {
+            try {
+                const p = (params ?? {});
+                const id = typeof p.id === "string" ? p.id : "";
+                if (!id.trim()) {
+                    throw new Error("id is required");
+                }
+                const engram = ctx.repository.readEngram(id);
+                const outgoingFile = safeReadSynapses(ctx, id);
+                const relatedIds = extractRelatedIds(id, outgoingFile);
+                return toAdaptedToolResult({
+                    id: engram.id,
+                    content: engram.content,
+                    metadata: {
+                        createdAt: engram.createdAt,
+                        updatedAt: engram.updatedAt,
+                        createdBy: engram.createdBy,
+                        importance: engram.importance,
+                        tags: engram.domainTags,
+                        kind: engram.kind,
+                        reinforcementCount: engram.effectiveRetrievals + engram.failedUses,
+                        lastReinforcedAt: engram.lastEffectiveAt ?? null,
+                        ...(engram.confidence !== undefined
+                            ? { truthScore: engram.confidence }
+                            : {}),
+                        ...(engram.verificationStatus
+                            ? { verificationStatus: engram.verificationStatus }
+                            : {}),
+                    },
+                    relatedIds,
+                }, ctx);
+            }
+            catch (error) {
+                return toErrorResult(error, language);
+            }
+        },
+    };
+}
+/**
+ * 安全读取 synapses（engram 可能没有 synapses 文件）
+ */
+function safeReadSynapses(ctx, id) {
+    try {
+        const file = ctx.repository.readSynapses(id);
+        return file ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 从 synapse outgoing 抽取邻居 id（不展开详情，不扫 incoming 以避免全表扫描）
+ */
+function extractRelatedIds(selfId, bundle) {
+    if (!bundle)
+        return [];
+    const ids = new Set();
+    for (const s of bundle.outgoing) {
+        if (s.to && s.to !== selfId)
+            ids.add(s.to);
+    }
+    return Array.from(ids);
+}
+/**
+ * 批量创建两个 memory 工具
+ */
+export function createMemoryTools(ctx, language = DEFAULT_LANGUAGE) {
+    return [
+        createMemorySearchTool(ctx, language),
+        createMemoryGetTool(ctx, language),
+    ];
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/memory-tools.js.map

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

package/dist/plugin-entry.d.ts

@@ -0,0 +1,98 @@
+/**
+ * OpenClaw 插件注册入口
+ *
+ * 用户在 openclaw 项目里通过如下方式使用：
+ *
+ * ```ts
+ * import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry'
+ * import { registerCoEngramTools } from '@co-engram/openclaw'
+ * import { join } from 'node:path'
+ *
+ * export default definePluginEntry({
+ *   id: 'co-engram',
+ *   name: 'Co-Engram',
+ *   description: 'Team memory with neuroscience-inspired plasticity',
+ *   register(api) {
+ *     registerCoEngramTools(api, {
+ *       dataRoot: join(process.env.HOME!, 'team-memory'),
+ *     })
+ *   },
+ * })
+ * ```
+ *
+ * @module @co-engram/openclaw
+ */
+import { EngramRepository, SearchOrchestrator, type ToolContext, type Language } from "@co-engram/core";
+import type { CoEngramPluginConfig, CoEngramPluginHostApi } from "./types.js";
+import { DEFAULT_CONFIG } from "./types.js";
+import { type PromptSignals } from "./prompt-builder.js";
+/**
+ * 构建 ToolContext（含 repository / searchOrchestrator / signalSink + 可选 observability）
+ *
+ * P4: 新增 signalSink 注入（默认 FileSignalSink 写入 dataRoot/.co-engram/signals.jsonl）。
+ * M1: 新增 auditLog / effectivenessTracker / proposalEngine 注入。
+ */
+export declare function createCoEngramContext(config?: CoEngramPluginConfig): ToolContext;
+/**
+ * 重建搜索索引(全量)
+ *
+ * 用 collectDigestLines 取真实 DigestLine[](含 importance / decayHalfLifeDays /
+ * retrievalCount / reinforcementScore 等),让 SearchOrchestrator 的三因子打分
+ * (α·relevance + β·recency + γ·importance)能用真实数据,而不是全部默认 0.5。
+ *
+ * 这直接影响搜索质量:之前所有 engram importance 都被 stub 成 0.5,导致
+ * importance 因子对排名无贡献,高重要性 engram 没法浮上来。
+ */
+export declare function rebuildSearchIndex(search: SearchOrchestrator, repo: EngramRepository): void;
+/**
+ * 注册所有 Co-Engram 工具到 OpenClaw 插件 API
+ *
+ * P4 新增：
+ *   - 工具通过 wrapAllToolsWithSignalSink 包装,自动 append ToolCallEvent
+ *   - 可选 startMaintenance=true 时启动 MaintenanceEngine（默认 false,需宿主显式开启）
+ *
+ * M3b 新增:
+ *   - 如果 ctx.proposalEngine 存在 + api 提供 registerHook + enqueueNextTurnInjection,
+ *     注册 session 'new' hook,在会话开始时把候选提示注入下一轮 agent context
+ *
+ * @param api OpenClaw 插件 API（只需暴露 registerTool）
+ * @param config 配置（数据根路径等）
+ * @returns ctx + 可选的 maintenance stop 函数
+ */
+export declare function registerCoEngramTools(api: CoEngramPluginHostApi, config?: CoEngramPluginConfig): ToolContext & {
+    readonly stopMaintenance?: () => void;
+    /** 关闭跨进程 index watcher(主要用于插件卸载 / 测试隔离) */
+    readonly stopIndexWatcher?: () => void;
+    readonly language?: Language;
+    readonly promptSignals?: PromptSignals;
+};
+/**
+ * 异步启动 viewer
+ *
+ * 与 registerCoEngramTools 分离,因为 viewer 启动是异步的且需要 @co-engram/claude-code。
+ * 失败不抛到外层,只记 stderr——plugin 仍正常工作。
+ *
+ * @returns stop 函数;viewer 未启动时返回 undefined
+ */
+export declare function startCoEngramViewer(ctx: ToolContext & {
+    readonly language?: Language;
+}, config?: CoEngramPluginConfig): Promise<{
+    readonly stopViewer?: () => Promise<void>;
+    readonly viewerPort?: number;
+}>;
+/**
+ * 构造候选提示文本（OpenClaw 注入用）
+ *
+ * 与 MCP 侧保持一致,均走 i18n 字典。
+ */
+export declare function buildProposalPrompt(count: number, language?: Language): string;
+/**
+ * 仅供测试/独立使用：构建一个内存中的 ctx + 注册结果
+ */
+export declare function createCoEngramTools(config?: CoEngramPluginConfig): {
+    ctx: ToolContext;
+    tools: readonly import("./types.js").OpenClawToolDescriptor[];
+    rebuild: () => void;
+};
+export { DEFAULT_CONFIG };
+//# sourceMappingURL=plugin-entry.d.ts.map

package/dist/plugin-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-entry.d.ts","sourceRoot":"","sources":["../src/plugin-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAkBlB,KAAK,WAAW,EAGhB,KAAK,QAAQ,EAGd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAW7B;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,oBAAyB,GAChC,WAAW,CA6Eb;AAgCD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAEN;AAyED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,qBAAqB,EAC1B,MAAM,GAAE,oBAAyB,GAChC,WAAW,GAAG;IACf,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC,CAqMA;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,GAAG;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,EACnD,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC;IACT,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC,CA2BD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,QAA2B,GACpC,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,oBAAyB;;;;EAapE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}