abmind 0.0.1 → 0.1.0

package/dist/src/openclaw-plugin/engine.d.ts

@@ -0,0 +1,87 @@
+/**
+ * AbmindOpenClawEngine — implements the ContextEngine interface for OpenClaw.
+ *
+ * Holds a reference to its AbmindPluginRuntime (registered in runtime-store under
+ * the plugin's id). All state is per-instance: no process.env reads, no module-
+ * level mutables. Multiple engines can coexist in one process.
+ */
+import type { AbmindPluginRuntime } from "./types.js";
+export declare class AbmindOpenClawEngine {
+    private readonly runtime;
+    readonly info: {
+        id: string;
+        name: string;
+        version: string;
+        ownsCompaction: boolean;
+        turnMaintenanceMode: "background";
+    };
+    constructor(runtime: AbmindPluginRuntime);
+    ingest(params: {
+        sessionId: string;
+        sessionKey?: string;
+        message: any;
+        isHeartbeat?: boolean;
+    }): Promise<{
+        ingested: boolean;
+    }>;
+    assemble(params: {
+        sessionId: string;
+        sessionKey?: string;
+        messages?: any[];
+        tokenBudget?: number;
+        prompt?: string;
+    }): Promise<{
+        messages: {
+            role: "user" | "assistant" | "toolResult";
+            content: string;
+        }[];
+        estimatedTokens: number;
+        systemPromptAddition: string | undefined;
+    }>;
+    compact(params: {
+        sessionId: string;
+        sessionKey?: string;
+        tokenBudget?: number;
+        force?: boolean;
+    }): Promise<{
+        ok: boolean;
+        compacted: boolean;
+        reason: string;
+        result?: undefined;
+    } | {
+        ok: boolean;
+        compacted: boolean;
+        result: {
+            summary: string;
+            firstKeptEntryId: string;
+            tokensBefore: number;
+            tokensAfter: number;
+        };
+        reason?: undefined;
+    }>;
+    bootstrap(): Promise<{
+        bootstrapped: boolean;
+        reason: string;
+    }>;
+    maintain(): Promise<{
+        changed: boolean;
+        bytesFreed: number;
+        rewrittenEntries: number;
+    }>;
+    afterTurn(params: {
+        sessionId: string;
+        sessionKey?: string;
+        tokenBudget?: number;
+    }): Promise<void>;
+    ingestBatch(params: {
+        sessionId: string;
+        sessionKey?: string;
+        messages: any[];
+    }): Promise<{
+        ingestedCount: number;
+    }>;
+    prepareSubagentSpawn(): Promise<undefined>;
+    onSubagentEnded(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/openclaw-plugin/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/openclaw-plugin/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKtD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,QAAQ,CAAC,IAAI;;;;;;MAMX;gBAEU,OAAO,EAAE,mBAAmB;IAMlC,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;;;IAQ9F,QAAQ,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;IA0BpH,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;;;;;;;;;;IAwCjG,SAAS;;;;IACT,QAAQ;;;;;IAER,SAAS,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAwBlF,WAAW,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,CAAA;KAAE;;;IAS/E,oBAAoB;IACpB,eAAe;IAEf,OAAO;CAId"}

package/dist/src/openclaw-plugin/engine.js

@@ -0,0 +1,121 @@
+/**
+ * AbmindOpenClawEngine — implements the ContextEngine interface for OpenClaw.
+ *
+ * Holds a reference to its AbmindPluginRuntime (registered in runtime-store under
+ * the plugin's id). All state is per-instance: no process.env reads, no module-
+ * level mutables. Multiple engines can coexist in one process.
+ */
+import { removeRuntime } from "../runtime-store.js";
+import { toMessage, toAssistantRole } from "./message-adapter.js";
+import { toChatId } from "./session-mapper.js";
+import { renderForContext } from "../context-tier-renderer.js";
+export class AbmindOpenClawEngine {
+    runtime;
+    info = {
+        id: "abmind",
+        name: "abmind Memory + Context Engine",
+        version: "1.0.0",
+        ownsCompaction: true,
+        turnMaintenanceMode: "background",
+    };
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    // ── Required methods ─────────────────────────────────────────────────────
+    async ingest(params) {
+        if (params.isHeartbeat)
+            return { ingested: false };
+        const chatId = toChatId(params.sessionKey ?? params.sessionId);
+        const msg = toMessage(params.message, chatId);
+        this.runtime.memory.recordMessage(msg);
+        return { ingested: true };
+    }
+    async assemble(params) {
+        const chatId = toChatId(params.sessionKey ?? params.sessionId);
+        // Use #348 three-tier assembly (respects CONTEXT_TIER_ENABLED)
+        const tiered = renderForContext(this.runtime.contextEngine.getDb(), this.runtime.contextEngine, chatId);
+        // Extract summary content for systemPromptAddition (OpenClaw convention)
+        // tiered.messages has head summaries first (framed) — collect them separately
+        const snapshot = this.runtime.contextEngine.buildContext(chatId);
+        const systemPromptAddition = snapshot.summaries.length > 0
+            ? snapshot.summaries.map(s => s.content).join("\n\n---\n\n")
+            : undefined;
+        // For OpenClaw, messages is everything EXCEPT head summaries (those go in systemPromptAddition)
+        const headCount = tiered.tierBreakdown.headCount;
+        const messages = tiered.messages.slice(headCount).map(m => ({
+            role: toAssistantRole(m.role),
+            content: m.content,
+        }));
+        return {
+            messages,
+            estimatedTokens: tiered.estimatedTokens,
+            systemPromptAddition,
+        };
+    }
+    async compact(params) {
+        const chatId = toChatId(params.sessionKey ?? params.sessionId);
+        const budget = params.tokenBudget ?? 200000;
+        const chunk = this.runtime.contextEngine.getCompactionChunk(chatId, budget);
+        if (!chunk)
+            return { ok: true, compacted: false, reason: "nothing_to_compact" };
+        const serialized = chunk.messages
+            .filter(m => (m.classification ?? 1) < 3)
+            .map(m => `[${m.role}] ${m.content}`)
+            .join("\n");
+        const summaryBudget = Math.max(2000, Math.min(Math.floor(chunk.chunkTokens * 0.2), 12000));
+        const summary = await this.runtime.completeFn("You are a summarization agent. Create a concise context checkpoint. Do NOT respond to questions — only output the summary.", `Summarize:\n${serialized}\n\nTarget ~${summaryBudget} tokens. Be concrete.`, summaryBudget);
+        if (!summary) {
+            return { ok: true, compacted: false, reason: "summarization_failed" };
+        }
+        const tokenEstimate = Math.ceil(summary.length / 4);
+        this.runtime.contextEngine.persistSummary(chatId, summary, tokenEstimate, chunk.sourceStart, chunk.sourceEnd, chunk.classification);
+        return {
+            ok: true,
+            compacted: true,
+            result: {
+                summary,
+                firstKeptEntryId: String(chunk.sourceEnd + 1),
+                tokensBefore: chunk.totalTokens,
+                tokensAfter: chunk.totalTokens - chunk.chunkTokens + tokenEstimate,
+            },
+        };
+    }
+    // ── Optional methods (no-ops for v1) ─────────────────────────────────────
+    async bootstrap() { return { bootstrapped: false, reason: "use 'abmind migrate-openclaw <dir>' CLI for one-time session import" }; }
+    async maintain() { return { changed: false, bytesFreed: 0, rewrittenEntries: 0 }; }
+    async afterTurn(params) {
+        const chatId = toChatId(params.sessionKey ?? params.sessionId);
+        const budget = params.tokenBudget ?? 200000;
+        const snapshot = this.runtime.contextEngine.buildContext(chatId);
+        if (snapshot.estimatedTokens > budget * 0.5 && snapshot.messages.length > 12) {
+            const chunk = this.runtime.contextEngine.getCompactionChunk(chatId, budget);
+            if (chunk) {
+                const serialized = chunk.messages
+                    .filter(m => (m.classification ?? 1) < 3)
+                    .map(m => `[${m.role}] ${m.content}`)
+                    .join("\n");
+                const summaryBudget = Math.max(2000, Math.min(Math.floor(chunk.chunkTokens * 0.2), 12000));
+                const summary = await this.runtime.completeFn("You are a summarization agent. Create a concise context checkpoint.", `Summarize:\n${serialized}\n\nTarget ~${summaryBudget} tokens. Be concrete.`, summaryBudget);
+                if (summary) {
+                    this.runtime.contextEngine.persistSummary(chatId, summary, Math.ceil(summary.length / 4), chunk.sourceStart, chunk.sourceEnd, chunk.classification);
+                }
+            }
+        }
+    }
+    async ingestBatch(params) {
+        let count = 0;
+        for (const msg of params.messages) {
+            const result = await this.ingest({ sessionId: params.sessionId, sessionKey: params.sessionKey, message: msg });
+            if (result.ingested)
+                count++;
+        }
+        return { ingestedCount: count };
+    }
+    async prepareSubagentSpawn() { return undefined; }
+    async onSubagentEnded() { }
+    async dispose() {
+        this.runtime.db.close();
+        removeRuntime(this.runtime.pluginId);
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/openclaw-plugin/engine.js.map

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

package/dist/src/openclaw-plugin/hooks.d.ts

@@ -0,0 +1,41 @@
+/**
+ * hooks.ts — lifecycle hook builders for autoRecall + autoCapture.
+ *
+ * Both hooks are opt-in via plugin config (default false). When enabled, they
+ * are wired to OpenClaw's hook API in the plugin's register() function.
+ *
+ * - autoRecall: on "before_agent_start", search memories matching the user
+ *   prompt and inject top-N results into the agent's context. Closes the
+ *   gap where memory-lancedb's auto-recall beats abmind on default behavior.
+ *
+ * - autoCapture: on "agent_end", record the user message for later memory
+ *   extraction by the sleep pipeline. User messages ONLY (not assistant
+ *   output) — matches lossless-claw's self-poisoning mitigation.
+ *
+ * OpenClaw event payload types are `any` (option b.1). Handler contract is
+ * validated by OpenClaw at registration, not compile time.
+ */
+interface AutoRecallDeps {
+    pluginId: string;
+    maxResults: number;
+    minScore: number;
+}
+/**
+ * Build a `before_agent_start` handler that injects top-relevant memories
+ * into the agent's context for each user prompt.
+ *
+ * Handler reads the user prompt from the event, runs abmind recall, and
+ * returns additional context lines to inject. Empty result = no injection.
+ */
+export declare function buildAutoRecallHook(deps: AutoRecallDeps): (event: any) => Promise<any>;
+interface AutoCaptureDeps {
+    pluginId: string;
+}
+/**
+ * Build an `agent_end` handler that records user messages from the completed
+ * turn into abmind's messages table. Assistant output is NOT captured
+ * (self-poisoning mitigation).
+ */
+export declare function buildAutoCaptureHook(deps: AutoCaptureDeps): (event: any) => Promise<void>;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/src/openclaw-plugin/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/openclaw-plugin/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAmCtF;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAyBzF"}

package/dist/src/openclaw-plugin/hooks.js

@@ -0,0 +1,155 @@
+/**
+ * hooks.ts — lifecycle hook builders for autoRecall + autoCapture.
+ *
+ * Both hooks are opt-in via plugin config (default false). When enabled, they
+ * are wired to OpenClaw's hook API in the plugin's register() function.
+ *
+ * - autoRecall: on "before_agent_start", search memories matching the user
+ *   prompt and inject top-N results into the agent's context. Closes the
+ *   gap where memory-lancedb's auto-recall beats abmind on default behavior.
+ *
+ * - autoCapture: on "agent_end", record the user message for later memory
+ *   extraction by the sleep pipeline. User messages ONLY (not assistant
+ *   output) — matches lossless-claw's self-poisoning mitigation.
+ *
+ * OpenClaw event payload types are `any` (option b.1). Handler contract is
+ * validated by OpenClaw at registration, not compile time.
+ */
+import { getRuntime } from "../runtime-store.js";
+/**
+ * Build a `before_agent_start` handler that injects top-relevant memories
+ * into the agent's context for each user prompt.
+ *
+ * Handler reads the user prompt from the event, runs abmind recall, and
+ * returns additional context lines to inject. Empty result = no injection.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function buildAutoRecallHook(deps) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return async function autoRecallHandler(event) {
+        const runtime = getRuntime(deps.pluginId);
+        const prompt = extractPromptFromEvent(event);
+        if (!prompt)
+            return {}; // No prompt to key off — silent no-op
+        try {
+            const result = await runtime.memory.recallSearch({
+                translated: [prompt],
+                userId: extractUserId(event) ?? "default",
+                limit: deps.maxResults,
+                maxClassification: 2,
+            });
+            const hits = result.results.filter((h) => (h.score ?? 0) >= deps.minScore);
+            if (hits.length === 0)
+                return {};
+            const lines = [
+                `[Relevant memory — abmind auto-recall, ${hits.length} hit${hits.length > 1 ? "s" : ""}]`,
+                ...hits.map((h, i) => {
+                    const idx = i + 1;
+                    const date = h.date ? ` (${h.date})` : "";
+                    const type = h.memoryType ? `[${h.memoryType}] ` : "";
+                    return `${idx}. ${type}${h.content}${date}`;
+                }),
+            ];
+            // OpenClaw's hook result shape varies; we return { context: string[] }
+            // as a conservative pattern. Runtime validates.
+            return { context: lines };
+        }
+        catch {
+            // Recall failure is non-fatal — don't break the turn. Hook must return
+            // an empty/neutral value, never throw.
+            return {};
+        }
+    };
+}
+/**
+ * Build an `agent_end` handler that records user messages from the completed
+ * turn into abmind's messages table. Assistant output is NOT captured
+ * (self-poisoning mitigation).
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function buildAutoCaptureHook(deps) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return async function autoCaptureHandler(event) {
+        const runtime = getRuntime(deps.pluginId);
+        const userMessages = extractUserMessages(event);
+        if (userMessages.length === 0)
+            return;
+        const userId = extractUserId(event) ?? "default";
+        const sessionId = extractSessionId(event) ?? "default";
+        const baseTimestamp = Date.now();
+        try {
+            for (let i = 0; i < userMessages.length; i++) {
+                runtime.memory.recordMessage({
+                    role: "user",
+                    content: userMessages[i],
+                    timestamp: baseTimestamp + i, // preserve ordering within the turn
+                    userId,
+                    sessionId,
+                });
+            }
+        }
+        catch {
+            // Capture failure is non-fatal — don't break the turn.
+        }
+    };
+}
+// ── Event shape extraction ────────────────────────────────────────────────
+// OpenClaw event payloads are not typed at our boundary. These helpers try
+// common shapes (user prompt, messages array) and fall back gracefully.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractPromptFromEvent(event) {
+    if (!event || typeof event !== "object")
+        return null;
+    // Most common: event.prompt or event.userPrompt
+    if (typeof event.prompt === "string")
+        return event.prompt;
+    if (typeof event.userPrompt === "string")
+        return event.userPrompt;
+    // Alternative: event.messages is an array, last user message wins
+    if (Array.isArray(event.messages)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        for (let i = event.messages.length - 1; i >= 0; i--) {
+            const m = event.messages[i];
+            if (m?.role === "user" && typeof m.content === "string")
+                return m.content;
+        }
+    }
+    return null;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractUserMessages(event) {
+    if (!event || typeof event !== "object")
+        return [];
+    if (!Array.isArray(event.messages))
+        return [];
+    const results = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    for (const m of event.messages) {
+        if (m?.role === "user" && typeof m.content === "string")
+            results.push(m.content);
+    }
+    return results;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractUserId(event) {
+    if (!event || typeof event !== "object")
+        return null;
+    if (typeof event.userId === "string")
+        return event.userId;
+    if (typeof event.agentId === "string")
+        return event.agentId;
+    if (typeof event.sessionKey === "string")
+        return event.sessionKey;
+    return null;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractSessionId(event) {
+    if (!event || typeof event !== "object")
+        return null;
+    if (typeof event.sessionId === "string")
+        return event.sessionId;
+    if (typeof event.sessionKey === "string")
+        return event.sessionKey;
+    return null;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/openclaw-plugin/hooks.js.map

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

package/dist/src/openclaw-plugin/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenClaw ContextEngine plugin for abmind.
+ * Drop-in replacement for lossless-claw.
+ *
+ * Per-instance isolation: config is constructed from plugin input (no process.env
+ * mutation) and the runtime is registered under a pluginId so multiple instances
+ * in the same process don't collide. See runtime-store.ts for the pattern.
+ */
+import type { AbmindPluginConfig } from "./types.js";
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: {
+        parse(value: unknown): AbmindPluginConfig;
+    };
+    register(api: any): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/openclaw-plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/openclaw-plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,YAAY,CAAC;;;;;;qBA8BzD,OAAO,GAAG,kBAAkB;;kBAe7B,GAAG;;AArBnB,wBA6GE"}

package/dist/src/openclaw-plugin/index.js

@@ -0,0 +1,145 @@
+/**
+ * OpenClaw ContextEngine plugin for abmind.
+ * Drop-in replacement for lossless-claw.
+ *
+ * Per-instance isolation: config is constructed from plugin input (no process.env
+ * mutation) and the runtime is registered under a pluginId so multiple instances
+ * in the same process don't collide. See runtime-store.ts for the pattern.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { ContextEngine } from "../context-engine.js";
+import { initializeDatabase } from "../memory-db.js";
+import { MemoryManager } from "../memory-manager.js";
+import { MEMORY_CONFIG_DEFAULTS } from "../memory-config.js";
+import { registerRuntime, removeRuntime, hasRuntime } from "../runtime-store.js";
+import { AbmindOpenClawEngine } from "./engine.js";
+import { createAbmindRecallTool, createAbmindStoreTool } from "./tools.js";
+import { createMemoryPluginRuntime } from "./runtime-adapter.js";
+import { buildPromptSection } from "./prompt-builder.js";
+import { buildListArtifacts } from "./public-artifacts.js";
+import { buildAutoRecallHook, buildAutoCaptureHook } from "./hooks.js";
+/**
+ * Construct a plugin-local MemoryConfig from plugin input and defaults.
+ * Does NOT read or mutate process.env — all relevant values come from pluginConfig
+ * or documented defaults. Multi-instance safe.
+ */
+function buildPluginMemoryConfig(stateDir) {
+    const memoryDir = join(stateDir, "memory");
+    return {
+        ...MEMORY_CONFIG_DEFAULTS,
+        memoryDir,
+    };
+}
+function resolveStateDir(configured) {
+    if (configured)
+        return configured;
+    // Fall back to env / home ONLY as a read (never a write). Host controls
+    // the env; we respect it for legacy setups but don't mutate it.
+    const envHome = process.env.ABMIND_HOME;
+    if (envHome)
+        return envHome;
+    return join(homedir(), ".abmind");
+}
+export default {
+    id: "abmind",
+    name: "abmind Memory + Context Engine",
+    description: "Long-term memory, context compaction, sleep cycles, recall",
+    configSchema: {
+        parse(value) {
+            const raw = (value && typeof value === "object" && !Array.isArray(value)) ? value : {};
+            return {
+                abmlVersion: raw.abmlVersion ?? "plain",
+                compactionThreshold: raw.compactionThreshold ?? 0.5,
+                sleepEnabled: raw.sleepEnabled ?? true,
+                stateDir: raw.stateDir ?? undefined,
+                autoRecall: raw.autoRecall ?? false,
+                autoCapture: raw.autoCapture ?? false,
+                autoRecallMaxResults: Math.min(Math.max(raw.autoRecallMaxResults ?? 3, 1), 10),
+                autoRecallMinScore: Math.min(Math.max(raw.autoRecallMinScore ?? 0.3, 0), 1),
+            };
+        },
+    },
+    register(api) {
+        const pluginId = api.pluginId ?? "abmind";
+        const config = api.config?.plugins?.entries?.abmind?.config ?? {};
+        const parsed = this.configSchema.parse(config);
+        const stateDir = resolveStateDir(parsed.stateDir);
+        const memoryConfig = buildPluginMemoryConfig(stateDir);
+        const dbPath = join(memoryConfig.memoryDir, "memory.db");
+        const db = initializeDatabase(dbPath);
+        const contextEngine = new ContextEngine(db);
+        const memory = new MemoryManager(memoryConfig);
+        // LLM complete function — dynamic import so pi-ai stays optional.
+        const completeFn = async (system, user, maxTokens) => {
+            try {
+                const piAiModule = "@mariozechner/pi-ai";
+                const piAi = await import(piAiModule);
+                if (typeof piAi.completeSimple !== "function")
+                    return "";
+                const result = await piAi.completeSimple({
+                    messages: [{ role: "user", content: user }],
+                    system,
+                    maxTokens,
+                });
+                const content = result?.content;
+                if (Array.isArray(content)) {
+                    const text = content.find((b) => b.type === "text");
+                    return text?.text ?? "";
+                }
+                return "";
+            }
+            catch {
+                return "";
+            }
+        };
+        // Register runtime under pluginId so multi-instance deployments don't
+        // collide. If this pluginId is already registered (hot-reload, re-init),
+        // dispose the previous registration first.
+        if (hasRuntime(pluginId)) {
+            removeRuntime(pluginId);
+        }
+        const runtime = {
+            pluginId,
+            contextEngine,
+            memory,
+            db,
+            completeFn,
+            config: parsed,
+            memoryConfig,
+        };
+        registerRuntime(pluginId, runtime);
+        const engine = new AbmindOpenClawEngine(runtime);
+        api.registerContextEngine("abmind", () => engine);
+        // ── Memory-capability registration (#201) ──────────────────────────────
+        if (typeof api.registerMemoryCapability === "function") {
+            api.registerMemoryCapability({
+                promptBuilder: buildPromptSection,
+                flushPlanResolver: () => null, // abmind sleep runs independently; null = no-op
+                runtime: createMemoryPluginRuntime(pluginId),
+                publicArtifacts: { listArtifacts: buildListArtifacts(pluginId) },
+            });
+        }
+        // ── Agent tools (#347, #359) ──────────────────────────────────────────
+        if (typeof api.registerTool === "function") {
+            api.registerTool((ctx) => createAbmindRecallTool(pluginId, ctx.sessionKey));
+            api.registerTool((ctx) => createAbmindStoreTool(pluginId, ctx.sessionKey));
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.warn("[abmind] api.registerTool unavailable — tool registration skipped (ContextEngine still active)");
+        }
+        // ── Lifecycle hooks (autoRecall + autoCapture) ─────────────────────────
+        if (parsed.autoRecall && typeof api.on === "function") {
+            api.on("before_agent_start", buildAutoRecallHook({
+                pluginId,
+                maxResults: parsed.autoRecallMaxResults,
+                minScore: parsed.autoRecallMinScore,
+            }));
+        }
+        if (parsed.autoCapture && typeof api.on === "function") {
+            api.on("agent_end", buildAutoCaptureHook({ pluginId }));
+        }
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/openclaw-plugin/index.js.map

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

package/dist/src/openclaw-plugin/message-adapter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * message-adapter.ts — Translate between OpenClaw AgentMessage and abmind MessageRecord.
+ */
+import type { MessageRecord } from "../mem-types.js";
+/**
+ * Convert an OpenClaw AgentMessage to abmind MessageRecord.
+ */
+export declare function toMessage(agentMessage: any, chatId: string): MessageRecord;
+/**
+ * Map abmind role to OpenClaw AgentMessage role.
+ */
+export declare function toAssistantRole(role: string): "user" | "assistant" | "toolResult";
+//# sourceMappingURL=message-adapter.d.ts.map

package/dist/src/openclaw-plugin/message-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-adapter.d.ts","sourceRoot":"","sources":["../../../src/openclaw-plugin/message-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CA4B1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAIjF"}