@co-engram/openclaw 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,236 @@
+/**
+ * OpenClaw Plugin API 最小化类型定义
+ *
+ * 不直接 import openclaw 包（避免版本耦合），
+ * 只定义我们需要用到的子集签名。
+ *
+ * host 在自己的 openclaw 项目里通过 definePluginEntry(api => ...)
+ * 把真实的 OpenClawPluginApi 传给 registerCoEngramTools。
+ *
+ * @module @co-engram/openclaw
+ */
+import type { MaintenanceConfig, ProposalEngineConfig, Language, PromptSignalSnapshot, NecessityEvaluator } from "@co-engram/core";
+/**
+ * JSON Schema 片段（OpenClaw tool parameters 接受 plain JSON Schema object）
+ */
+export type JsonSchemaObject = {
+    readonly type?: string;
+    readonly properties?: Record<string, unknown>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean;
+    readonly [key: string]: unknown;
+};
+/**
+ * AgentTool.execute 的返回结构（最小化）
+ */
+export interface ToolExecuteResult {
+    readonly content: ReadonlyArray<{
+        readonly type: "text" | "json";
+        readonly text?: string;
+        readonly data?: unknown;
+    }>;
+    readonly details?: Record<string, unknown>;
+}
+/**
+ * AnyAgentTool 最小子集（OpenClaw 期望的 tool shape）
+ */
+export interface OpenClawToolDescriptor {
+    readonly name: string;
+    readonly label?: string;
+    readonly description: string;
+    readonly parameters: JsonSchemaObject;
+    readonly execute: (toolCallId: string, params: unknown, signal?: AbortSignal) => Promise<ToolExecuteResult>;
+}
+/**
+ * api.registerTool 的最小签名（AnyAgentTool | Factory 都支持，这里简化）
+ */
+export type RegisterToolFn = (tool: OpenClawToolDescriptor, opts?: {
+    readonly name?: string;
+}) => void;
+/**
+ * 可选的下轮注入 hook（OpenClaw 真实 API 子集）
+ *
+ * 用于 M3b:会话开始时把候选提示注入下一轮 agent context。
+ * 如果 host 不支持,省略即可——plugin 会跳过自动注入。
+ */
+export interface PluginNextTurnInjectionInput {
+    readonly sessionKey: string;
+    readonly text: string;
+    readonly placement?: "prepend_context" | "append_context";
+    readonly idempotencyKey?: string;
+}
+export interface PluginNextTurnInjectionResult {
+    readonly enqueued: boolean;
+    readonly id?: string;
+    readonly sessionKey: string;
+}
+export type EnqueueNextTurnInjectionFn = (injection: PluginNextTurnInjectionInput) => Promise<PluginNextTurnInjectionResult>;
+/**
+ * 可选的 session hook(OpenClaw registerHook 子集)
+ *
+ * 用于 M3b:监听 session 'new' 事件以触发候选提示注入。
+ */
+export type SessionHookHandler = (event: {
+    readonly type: "session";
+    readonly action: string;
+    readonly sessionKey: string;
+    readonly context?: Readonly<Record<string, unknown>>;
+}) => Promise<void> | void;
+export type RegisterHookFn = (events: "session" | readonly string[], handler: SessionHookHandler, opts?: {
+    readonly name: string;
+    readonly description?: string;
+    readonly entry?: unknown;
+}) => void;
+/**
+ * Memory capability 注册参数
+ *
+ * 对应 OpenClaw `api.registerMemoryCapability({...})` 的子集。
+ * co-engram 目前只用 promptBuilder 字段;flushPlanResolver/runtime 留空
+ * (维护引擎自带定时器,不依赖 OpenClaw runtime 钩子)。
+ */
+export interface MemoryPromptBuilderParams {
+    readonly availableTools: ReadonlySet<string>;
+    readonly citationsMode?: "off" | "compact" | "full";
+}
+export type MemoryPromptBuilder = (params: MemoryPromptBuilderParams) => readonly string[];
+export interface MemoryCapabilityRegistration {
+    readonly promptBuilder?: MemoryPromptBuilder;
+    readonly flushPlanResolver?: unknown;
+    readonly runtime?: unknown;
+    readonly publicArtifacts?: unknown;
+}
+export type RegisterMemoryCapabilityFn = (capability: MemoryCapabilityRegistration) => void;
+/**
+ * before_prompt_build hook 事件
+ *
+ * OpenClaw 在 prompt 组装前触发,允许插件追加 system prompt 段。
+ * 用于在 workspace MEMORY.md 之后追加 co-engram 的实际记忆内容。
+ */
+export interface BeforePromptBuildEvent {
+    readonly prompt: string;
+    readonly messages?: readonly unknown[];
+}
+export interface BeforePromptBuildResult {
+    /** 追加到 base system prompt 末尾(workspace MEMORY.md / promptBuilder 段之后) */
+    readonly appendSystemContext?: string;
+    /** 前置到 base system prompt 开头 */
+    readonly prependSystemContext?: string;
+}
+export type BeforePromptBuildHandler = (event: BeforePromptBuildEvent) => Promise<BeforePromptBuildResult | void> | BeforePromptBuildResult | void;
+/**
+ * OpenClaw Plugin API 子集
+ *
+ * 实际 OpenClawPluginApi 有更多方法,但 co-engram 只需要 registerTool;
+ * enqueueNextTurnInjection / registerHook 可选(用于 M3b system prompt 注入)。
+ */
+export interface CoEngramPluginHostApi {
+    readonly registerTool: RegisterToolFn;
+    /** 可选:用于 M3b 候选提示注入 */
+    readonly enqueueNextTurnInjection?: EnqueueNextTurnInjectionFn;
+    /** 可选:用于监听 session 生命周期事件 */
+    readonly registerHook?: RegisterHookFn;
+    /** 可选:声明 memory capability(OpenClaw 主要记忆插件需要,触发 memory section 注入) */
+    readonly registerMemoryCapability?: RegisterMemoryCapabilityFn;
+    /** 可选:注册 plugin hook(OpenClaw api.on 子集) */
+    readonly on?: (event: "before_prompt_build", handler: BeforePromptBuildHandler) => void;
+    /** 可选:plugin config(由 OpenClaw 默认 entry 透传) */
+    readonly pluginConfig?: Record<string, unknown>;
+}
+/**
+ * 插件配置（来自 openclaw.plugin.json 的 configSchema）
+ */
+export interface CoEngramPluginConfig {
+    /** 数据仓库根路径（默认 ~/team-memory） */
+    readonly dataRoot?: string;
+    /** 是否启用 */
+    readonly enabled?: boolean;
+    /** 默认创建者（写入操作时若未指定 createdBy，用此值） */
+    readonly defaultCreatedBy?: string;
+    /** 工具描述、查看器 UI、提示词所用语言(默认 'en') */
+    readonly language?: Language;
+    /** 是否启动自动维护服务（默认 false，需宿主显式开启） */
+    readonly startMaintenance?: boolean;
+    /** 维护服务配置（light/deep/rem 间隔、learningRate 等），透传给 MaintenanceEngine */
+    readonly maintenanceConfig?: MaintenanceConfig;
+    /** 是否启用 audit log（默认 true） */
+    readonly auditEnabled?: boolean;
+    /** 是否启用 effectiveness 追踪（默认 true） */
+    readonly effectivenessEnabled?: boolean;
+    /** 是否启用 proposal engine（默认 true） */
+    readonly proposalEnabled?: boolean;
+    /** proposal engine 配置 */
+    readonly proposalConfig?: ProposalEngineConfig;
+    /**
+     * 必要性评估 LLM 配置(可选)
+     *
+     * 配置后,proposal engine 在 cluster 晋升前会用 LLM 判断"是否值得固化为团队记忆",
+     * 失败 fallback 到规则版(RuleBasedNecessityEvaluator)。
+     * 不配置时只走规则版,零 LLM 成本。
+     */
+    readonly necessityLlm?: NecessityLlmConfig;
+    /**
+     * 可选:宿主直接注入 NecessityEvaluator 实例(优先级高于 necessityLlm 配置)
+     *
+     * 让 OpenClaw 等高级宿主可以用自己的 LLM 调用设施构造评估器,绕过本插件
+     * 内置的 OpenAI-compatible fetch 实现。
+     */
+    readonly necessityEvaluator?: NecessityEvaluator;
+    /** 是否启动 viewer HTTP server（默认 false,M4） */
+    readonly startViewer?: boolean;
+    /** viewer 配置（端口/token 等） */
+    readonly viewerConfig?: ViewerConfig;
+    /**
+     * 是否在 plugin 启动时自动 onboard git merge driver(默认 true)。
+     *
+     * 启用后,启动时会检测 dataRoot 所在 git repo,自动安装 merge driver
+     * bundle / .gitattributes / .git/config(全部幂等)。
+     *
+     * 关闭后,用户需手动运行 `co-engram git enable`(P2.6 CLI)。
+     * 默认开启,匹配零手动步骤的 low-friction-defaults 原则。
+     */
+    readonly autoOnboardMergeDriver?: boolean;
+    /** 预计算的 prompt signals（由 entry.ts 从 .co-engram/prompt-signals.json 读取并注入） */
+    readonly promptSignals?: PromptSignalSnapshot;
+}
+/** Viewer 配置 */
+export interface ViewerConfig {
+    /** 端口(默认 18799) */
+    readonly port?: number;
+    /** Bearer token(可选) */
+    readonly token?: string;
+}
+/**
+ * 必要性评估 LLM 配置
+ *
+ * 用于 LlmNecessityEvaluator — proposal 晋升前的"必要性"判断。
+ * 失败 fallback 到规则版,所以配置不正确不会阻塞 proposal engine。
+ */
+export interface NecessityLlmConfig {
+    /**
+     * OpenAI-compatible chat completions endpoint
+     *
+     * 支持 OpenAI / Azure / 通义 / 智谱 / 本地 ollama 等。
+     * 自动追加 `/chat/completions` 后缀。
+     */
+    readonly endpoint: string;
+    /** API key */
+    readonly apiKey: string;
+    /** 模型名(如 'gpt-4o-mini' / 'qwen-turbo' / 'glm-4-flash') */
+    readonly model: string;
+    /** 可选额外 headers */
+    readonly headers?: Record<string, string>;
+}
+/**
+ * 默认配置
+ *
+ * - dataRoot / enabled / defaultCreatedBy 有固定默认值（必填）
+ * - startMaintenance 显式默认 false
+ * - maintenanceConfig 默认 undefined（交给 MaintenanceEngine 内置默认值）
+ * - audit/effectiveness/proposal 默认 true
+ */
+export declare const DEFAULT_CONFIG: Required<Pick<CoEngramPluginConfig, "dataRoot" | "enabled" | "defaultCreatedBy" | "startMaintenance">> & Pick<CoEngramPluginConfig, "maintenanceConfig"> & {
+    readonly auditEnabled: boolean;
+    readonly effectivenessEnabled: boolean;
+    readonly proposalEnabled: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,29 @@
+/**
+ * OpenClaw Plugin API 最小化类型定义
+ *
+ * 不直接 import openclaw 包（避免版本耦合），
+ * 只定义我们需要用到的子集签名。
+ *
+ * host 在自己的 openclaw 项目里通过 definePluginEntry(api => ...)
+ * 把真实的 OpenClawPluginApi 传给 registerCoEngramTools。
+ *
+ * @module @co-engram/openclaw
+ */
+/**
+ * 默认配置
+ *
+ * - dataRoot / enabled / defaultCreatedBy 有固定默认值（必填）
+ * - startMaintenance 显式默认 false
+ * - maintenanceConfig 默认 undefined（交给 MaintenanceEngine 内置默认值）
+ * - audit/effectiveness/proposal 默认 true
+ */
+export const DEFAULT_CONFIG = {
+    dataRoot: `${process.env.HOME ?? "/tmp"}/team-memory`,
+    enabled: true,
+    defaultCreatedBy: "openclaw",
+    startMaintenance: false,
+    auditEnabled: true,
+    effectivenessEnabled: true,
+    proposalEnabled: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoQH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAUrB;IACJ,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,cAAc;IACrD,OAAO,EAAE,IAAI;IACb,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,IAAI;IAClB,oBAAoB,EAAE,IAAI;IAC1B,eAAe,EAAE,IAAI;CACtB,CAAC"}

package/dist/viewer-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OpenClaw Viewer 适配(M4)
+ *
+ * 通过 dynamic import 从 @co-engram/viewer 加载 host-agnostic viewer 实现,
+ * 与 @co-engram/claude-code 共享同一份 viewer 源码。
+ *
+ * @module @co-engram/openclaw
+ */
+import type { Language, ToolContext } from "@co-engram/core";
+import type { ViewerConfig } from "./types.js";
+/** Viewer 运行时句柄(动态加载,类型宽松) */
+export interface ViewerRuntime {
+    readonly port: number;
+    readonly stop: () => Promise<void>;
+}
+/**
+ * 启动 viewer HTTP server
+ *
+ * 内部调用 @co-engram/viewer 的 startViewerServer。
+ *
+ * @throws 如果 @co-engram/viewer 未安装
+ */
+export declare function startViewerForOpenClaw(ctx: ToolContext, config?: ViewerConfig & {
+    readonly language?: Language;
+    readonly dataRoot?: string;
+}): Promise<ViewerRuntime>;
+/**
+ * 渲染 SPA HTML(仅用于测试 / 在 viewer 不可用时展示占位)
+ *
+ * 与 @co-engram/viewer 的 renderSpaHtml 保持同构。
+ */
+export declare function renderViewerHtml(options?: {
+    readonly tokenRequired?: boolean;
+    readonly language?: Language;
+}): Promise<string>;
+//# sourceMappingURL=viewer-loader.d.ts.map

package/dist/viewer-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-loader.d.ts","sourceRoot":"","sources":["../src/viewer-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,MAAM,GAAE,YAAY,GAAG;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACvB,GACL,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE;IACP,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACzB,GACL,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/viewer-loader.js

@@ -0,0 +1,45 @@
+/**
+ * OpenClaw Viewer 适配(M4)
+ *
+ * 通过 dynamic import 从 @co-engram/viewer 加载 host-agnostic viewer 实现,
+ * 与 @co-engram/claude-code 共享同一份 viewer 源码。
+ *
+ * @module @co-engram/openclaw
+ */
+/**
+ * 启动 viewer HTTP server
+ *
+ * 内部调用 @co-engram/viewer 的 startViewerServer。
+ *
+ * @throws 如果 @co-engram/viewer 未安装
+ */
+export async function startViewerForOpenClaw(ctx, config = {}) {
+    const mod = await dynamicImportViewer();
+    return mod.startViewerServer(ctx, config);
+}
+/**
+ * 渲染 SPA HTML(仅用于测试 / 在 viewer 不可用时展示占位)
+ *
+ * 与 @co-engram/viewer 的 renderSpaHtml 保持同构。
+ */
+export async function renderViewerHtml(options = {}) {
+    const mod = await dynamicImportViewer();
+    return mod.renderSpaHtml(options);
+}
+/** 动态加载 viewer 模块(隔离类型,避免编译期依赖) */
+async function dynamicImportViewer() {
+    try {
+        // 用字符串变量名避免 TypeScript 把它视为静态依赖
+        const specifier = "@co-engram/viewer";
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import(specifier);
+        if (typeof mod.startViewerServer !== "function") {
+            throw new Error("@co-engram/viewer missing startViewerServer export");
+        }
+        return mod;
+    }
+    catch (err) {
+        throw new Error(`Failed to load @co-engram/viewer. Install it first: pnpm add @co-engram/viewer. Cause: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=viewer-loader.js.map

package/dist/viewer-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-loader.js","sourceRoot":"","sources":["../src/viewer-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,SAGI,EAAE;IAEN,MAAM,GAAG,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACxC,OAAO,GAAG,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAGI,EAAE;IAEN,MAAM,GAAG,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACxC,OAAO,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,mCAAmC;AACnC,KAAK,UAAU,mBAAmB;IAehC,IAAI,CAAC;QACH,gCAAgC;QAChC,MAAM,SAAS,GAAG,mBAAmB,CAAC;QACtC,8DAA8D;QAC9D,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,GAcN,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0FAA0F,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7I,CAAC;IACJ,CAAC;AACH,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,137 @@
+{
+  "id": "co-engram",
+  "kind": "memory",
+  "activation": {
+    "onStartup": true
+  },
+  "contracts": {
+    "tools": [
+      "memory_search",
+      "memory_get",
+      "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",
+      "skill_invoke",
+      "close_learning_loop",
+      "contradiction_resolve",
+      "get_evolution_lineage",
+      "upgrade_verification",
+      "engram_list_proposals",
+      "engram_accept_proposal",
+      "engram_dismiss_proposal",
+      "engram_doctor",
+      "engram_list_paths"
+    ]
+  },
+  "name": "Co-Engram",
+  "description": "Team memory with neuroscience-inspired plasticity. Self-editing tools for engrams / synapses / skills. Acts as the primary memory plugin (kind=memory) — mutually exclusive with memory-core.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable or disable Co-Engram tool registration."
+      },
+      "dataRoot": {
+        "type": "string",
+        "description": "Absolute path to the team-memory repository (default: $HOME/team-memory)."
+      },
+      "defaultCreatedBy": {
+        "type": "string",
+        "description": "Default creator identifier when not specified on writes."
+      },
+      "language": {
+        "type": "string",
+        "enum": ["en", "zh"],
+        "default": "en",
+        "description": "Language for tool descriptions, viewer UI, and system prompts. Falls back to team-memory persisted config if unset."
+      },
+      "startMaintenance": {
+        "type": "boolean",
+        "default": true,
+        "description": "Start the auto-maintenance engine (light/deep/rem stages)."
+      },
+      "maintenanceConfig": {
+        "type": "object",
+        "additionalProperties": true,
+        "description": "Maintenance engine config (lightIntervalMs / deepIntervalMs / remIntervalMs / learningRate / enabledStages)."
+      },
+      "auditEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable audit log (.co-engram/audit.jsonl)."
+      },
+      "effectivenessEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable effectiveness tracking (retrieve_hit → effective/inconclusive)."
+      },
+      "proposalEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable implicit memory proposal engine (on by default for low-friction onboarding)."
+      },
+      "proposalConfig": {
+        "type": "object",
+        "additionalProperties": true,
+        "description": "Proposal engine config (threshold / similarityThreshold / maxSamples / defaultDismissDays / minMessageLength)."
+      },
+      "startViewer": {
+        "type": "boolean",
+        "default": true,
+        "description": "Start the web viewer HTTP server on 127.0.0.1:18799 (requires @co-engram/claude-code installed)."
+      },
+      "viewerConfig": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "port": { "type": "number", "default": 18799 },
+          "token": { "type": "string" }
+        },
+        "description": "Viewer server config (port / token)."
+      }
+    }
+  },
+  "uiHints": {
+    "enabled": {
+      "label": "Enable Co-Engram",
+      "help": "Globally enable or disable Co-Engram tool registration."
+    },
+    "dataRoot": {
+      "label": "Data Root",
+      "help": "Path to the team-memory Git repository where engrams are stored."
+    },
+    "startMaintenance": {
+      "label": "Start Maintenance",
+      "help": "Start P4 auto-maintenance (signal extraction + RPE + metacognition)."
+    },
+    "proposalEnabled": {
+      "label": "Implicit Memory Proposals",
+      "help": "Watch conversations and propose engrams after a topic is seen multiple times."
+    },
+    "startViewer": {
+      "label": "Start Web Viewer",
+      "help": "Launch a local-only HTTP viewer on 127.0.0.1:18799 (requires @co-engram/claude-code)."
+    },
+    "language": {
+      "label": "Language",
+      "help": "Tool description / viewer / prompt language: en (default) or zh."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@co-engram/openclaw",
+  "version": "0.1.0",
+  "description": "Co-Engram adapter for OpenClaw (plugin SDK).",
+  "license": "MIT",
+  "author": "Yang Yang <yang.yang29@zte.com.cn>",
+  "homepage": "https://github.com/co-engram/co-engram#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/co-engram/co-engram.git",
+    "directory": "packages/openclaw-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/co-engram/co-engram/issues"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "memory",
+    "ai-memory",
+    "agent-memory",
+    "engram",
+    "mcp"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "scripts/setup.mjs",
+    "scripts/sync-deps.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "co-engram-openclaw-setup": "./scripts/setup.mjs"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --reporter=verbose",
+    "typecheck": "tsc --noEmit",
+    "sync-deps": "node ./scripts/sync-deps.mjs",
+    "apply:openclaw": "node ./scripts/setup.mjs"
+  },
+  "dependencies": {
+    "@co-engram/core": "workspace:*",
+    "@co-engram/viewer": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./src/entry.ts"
+    ]
+  }
+}