abmind 0.0.1 → 0.1.1

package/dist/src/mcp-server.js

@@ -0,0 +1,50 @@
+/**
+ * abmind MCP server — exposes memory as MCP tools over stdio.
+ * Usage: abmind mcp
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadMemoryConfig } from "./memory-config.js";
+import { MemoryManager } from "./memory-manager.js";
+import { createMemoryBackend } from "./backend-factory.js";
+import { loadMasterUserId } from "./user-utils.js";
+export async function startMcpServer() {
+    const config = loadMemoryConfig();
+    const memory = new MemoryManager(config);
+    await memory.initialize();
+    const backend = await createMemoryBackend(config);
+    const defaultUserId = loadMasterUserId();
+    const server = new McpServer({ name: "abmind", version: "0.5.0" });
+    server.tool("memory_recall", "Search persistent memory using full 4-layer recall (FTS5, trigram, semantic, consolidated)", { query: z.string(), userId: z.string().optional() }, async ({ query, userId }) => {
+        const uid = userId ?? defaultUserId;
+        const result = await backend.recall({ translated: [query], userId: uid, limit: 10 });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("memory_store", "Store a new memory — facts, preferences, decisions, or events", { text: z.string(), memoryType: z.enum(["fact", "preference", "decision", "event"]), userId: z.string().optional() }, async ({ text, memoryType, userId }) => {
+        const uid = userId ?? defaultUserId;
+        const result = await backend.instantStore({ userId: uid, contentEn: text, contentOriginal: text, memoryType, emotionScore: 0 });
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    });
+    server.tool("memory_edit", "Boost or demote a memory's importance (v1: boost/demote only)", { memoryId: z.number(), action: z.enum(["boost", "demote"]) }, async ({ memoryId, action }) => {
+        const delta = action === "boost" ? 10 : -10;
+        await backend.adjustRelevance(memoryId, delta);
+        return { content: [{ type: "text", text: JSON.stringify({ ok: true, memoryId, action }) }] };
+    });
+    server.tool("memory_status", "Get memory system statistics", { userId: z.string().optional() }, async ({ userId }) => {
+        const stats = memory.getStats();
+        return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
+    });
+    server.tool("memory_wakeup", "Get wake-up context for session start — recent memories, core knowledge, emotional state", { maxChars: z.number().optional() }, async ({ maxChars }) => {
+        const wakeup = memory.buildWakeUp(maxChars);
+        return { content: [{ type: "text", text: wakeup }] };
+    });
+    server.tool("memory_bundle", "Get session bundle — SOUL identity, user profile, agent notes, memory tool instructions", {}, async () => {
+        const b = memory.getSessionBundle();
+        const parts = [b.soul, b.memoryTools, b.profile, b.notes].filter(Boolean);
+        return { content: [{ type: "text", text: parts.join("\n\n---\n\n") }] };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/src/mcp-server.js.map

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

package/dist/src/media-sanitizer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Media sanitizer — strips binary/media payloads from message content
+ * before summarization. Prevents images/files from consuming token budget.
+ *
+ * Patterns from Lossless-claw's compaction.ts.
+ */
+/** Strip media payloads from message content. Returns clean text for summarization. */
+export declare function stripMediaPayloads(content: string): string;
+/** Annotate content: if media was stripped, add marker. */
+export declare function sanitizeForSummary(content: string): string;
+//# sourceMappingURL=media-sanitizer.d.ts.map

package/dist/src/media-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-sanitizer.d.ts","sourceRoot":"","sources":["../../src/media-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK1D"}

package/dist/src/media-sanitizer.js

@@ -0,0 +1,56 @@
+/**
+ * Media sanitizer — strips binary/media payloads from message content
+ * before summarization. Prevents images/files from consuming token budget.
+ *
+ * Patterns from Lossless-claw's compaction.ts.
+ */
+const BASE64_DATA_URL_RE = /data:[^;\s"'`]+;base64,[A-Za-z0-9+/=\s]+/gi;
+const MEDIA_PATH_RE = /^MEDIA:\/.+$/;
+/** Detect whether a string is mostly binary/base64 payload. */
+function looksLikeBinary(value) {
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length < 256)
+        return false;
+    if (/^data:[^;\s"'`]+;base64,/i.test(trimmed))
+        return true;
+    const compact = trimmed.replace(/\s+/g, "");
+    if (compact.length % 4 !== 0)
+        return false;
+    if (!/^[A-Za-z0-9+/=]+$/.test(compact))
+        return false;
+    return !/[ .,:;!?()[\]{}]/.test(trimmed);
+}
+/** Strip media payloads from message content. Returns clean text for summarization. */
+export function stripMediaPayloads(content) {
+    if (!content)
+        return "";
+    // Remove data URLs
+    let result = content.replace(BASE64_DATA_URL_RE, "[embedded media omitted]");
+    // Filter lines
+    result = result
+        .split("\n")
+        .filter(line => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return false;
+        if (MEDIA_PATH_RE.test(trimmed))
+            return false;
+        if (looksLikeBinary(trimmed))
+            return false;
+        return true;
+    })
+        .join("\n")
+        .trim();
+    // If nothing left, it was a media-only message
+    return result || "[Media attachment]";
+}
+/** Annotate content: if media was stripped, add marker. */
+export function sanitizeForSummary(content) {
+    const stripped = stripMediaPayloads(content);
+    if (stripped === "[Media attachment]")
+        return stripped;
+    if (stripped.length < content.length * 0.5)
+        return `${stripped} [with media attachment]`;
+    return stripped;
+}
+//# sourceMappingURL=media-sanitizer.js.map

package/dist/src/media-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-sanitizer.js","sourceRoot":"","sources":["../../src/media-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AACxE,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC,+DAA+D;AAC/D,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,mBAAmB;IACnB,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,0BAA0B,CAAC,CAAC;IAC7E,eAAe;IACf,MAAM,GAAG,MAAM;SACZ,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,IAAI,CAAC,EAAE;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,eAAe,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;IACV,+CAA+C;IAC/C,OAAO,MAAM,IAAI,oBAAoB,CAAC;AACxC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,oBAAoB;QAAE,OAAO,QAAQ,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,GAAG,QAAQ,0BAA0B,CAAC;IACzF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/mem-config-env.d.ts

@@ -0,0 +1,18 @@
+/**
+ * mem-config-env.ts — Load .env.memory into process.env before schema reads it.
+ * Must be called before initAbmindEnv() / getAbmindEnv().
+ */
+export type SearchMode = "hybrid" | "embedding" | "signature";
+export interface MemoryEnvConfig {
+    searchMode: SearchMode;
+    maxDbSizeMb: number;
+    originalTtlDays: number;
+    englishTtlDays: number;
+    agingEnabled: boolean;
+    signatureBits: number;
+}
+/** Load .env.memory from ~/.abmind/config/.env.memory into process.env. */
+export declare function loadMemoryEnvFile(): void;
+/** Get memory config from schema. Kept for backward compat with callers. */
+export declare function loadMemoryEnv(): MemoryEnvConfig;
+//# sourceMappingURL=mem-config-env.d.ts.map

package/dist/src/mem-config-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-config-env.d.ts","sourceRoot":"","sources":["../../src/mem-config-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,IAAI,IAAI,CAaxC;AAID,4EAA4E;AAC5E,wBAAgB,aAAa,IAAI,eAAe,CAa/C"}

package/dist/src/mem-config-env.js

@@ -0,0 +1,43 @@
+/**
+ * mem-config-env.ts — Load .env.memory into process.env before schema reads it.
+ * Must be called before initAbmindEnv() / getAbmindEnv().
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { abmindHome } from "./mem-paths.js";
+/** Load .env.memory from ~/.abmind/config/.env.memory into process.env. */
+export function loadMemoryEnvFile() {
+    const envPath = join(abmindHome(), "config", ".env.memory");
+    if (!existsSync(envPath))
+        return;
+    const lines = readFileSync(envPath, "utf-8").split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq < 0)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        const val = trimmed.slice(eq + 1).trim();
+        if (key && val)
+            process.env[key] = process.env[key] ?? val;
+    }
+}
+import { getAbmindEnv, _resetAbmindEnv } from "./env-schema.js";
+/** Get memory config from schema. Kept for backward compat with callers. */
+export function loadMemoryEnv() {
+    loadMemoryEnvFile();
+    _resetAbmindEnv(); // re-read after loading .env.memory
+    const env = getAbmindEnv();
+    const mode = env.memorySearchMode;
+    return {
+        searchMode: (mode === "hybrid" || mode === "embedding" || mode === "signature") ? mode : "hybrid",
+        maxDbSizeMb: env.memoryMaxDbSizeMb,
+        originalTtlDays: env.memoryOriginalTtlDays,
+        englishTtlDays: env.memoryEnglishTtlDays,
+        agingEnabled: env.memoryAgingEnabled,
+        signatureBits: env.signatureBits,
+    };
+}
+//# sourceMappingURL=mem-config-env.js.map

package/dist/src/mem-config-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-config-env.js","sourceRoot":"","sources":["../../src/mem-config-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAa5C,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACjC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,GAAG,IAAI,GAAG;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhE,4EAA4E;AAC5E,MAAM,UAAU,aAAa;IAC3B,iBAAiB,EAAE,CAAC;IACpB,eAAe,EAAE,CAAC,CAAC,oCAAoC;IACvD,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC;IAClC,OAAO;QACL,UAAU,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;QACjG,WAAW,EAAE,GAAG,CAAC,iBAAiB;QAClC,eAAe,EAAE,GAAG,CAAC,qBAAqB;QAC1C,cAAc,EAAE,GAAG,CAAC,oBAAoB;QACxC,YAAY,EAAE,GAAG,CAAC,kBAAkB;QACpC,aAAa,EAAE,GAAG,CAAC,aAAa;KACjC,CAAC;AACJ,CAAC"}

package/dist/src/mem-env.d.ts

@@ -0,0 +1,5 @@
+/** Standalone env/date utils for abmind. */
+export declare function parseBoolEnv(key: string, fallback: boolean): boolean;
+export declare function parseNumberEnv(key: string, fallback: number): number;
+export declare function localDate(): string;
+//# sourceMappingURL=mem-env.d.ts.map

package/dist/src/mem-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-env.d.ts","sourceRoot":"","sources":["../../src/mem-env.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAIpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC"}

package/dist/src/mem-env.js

@@ -0,0 +1,19 @@
+/** Standalone env/date utils for abmind. */
+export function parseBoolEnv(key, fallback) {
+    const raw = process.env[key];
+    if (raw === undefined || raw === "")
+        return fallback;
+    return raw === "true" || raw === "1";
+}
+export function parseNumberEnv(key, fallback) {
+    const raw = process.env[key];
+    if (raw === undefined || raw === "")
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : fallback;
+}
+export function localDate() {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+//# sourceMappingURL=mem-env.js.map

package/dist/src/mem-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-env.js","sourceRoot":"","sources":["../../src/mem-env.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAE5C,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,QAAiB;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrD,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,QAAgB;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnH,CAAC"}

package/dist/src/mem-logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Standalone logger for abmind.
+ * Re-exports bridge logger when running inside the bridge,
+ * falls back to minimal console logger when standalone.
+ */
+declare let _logInfo: (tag: string, msg: string) => void;
+declare let _logWarn: (tag: string, msg: string) => void;
+declare let _logError: (tag: string, msg: string, err?: unknown) => void;
+/** Allow the host (bridge) to inject its own logger. */
+export declare function setLogger(fns: {
+    logInfo: typeof _logInfo;
+    logWarn: typeof _logWarn;
+    logError: typeof _logError;
+}): void;
+export declare function logInfo(tag: string, msg: string): void;
+export declare function logWarn(tag: string, msg: string): void;
+export declare function logError(tag: string, msg: string, err?: unknown): void;
+export declare function logDebug(tag: string, msg: string): void;
+export {};
+//# sourceMappingURL=mem-logger.d.ts.map

package/dist/src/mem-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-logger.d.ts","sourceRoot":"","sources":["../../src/mem-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAA,IAAI,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAmD,CAAC;AAChG,QAAA,IAAI,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAoD,CAAC;AACjG,QAAA,IAAI,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAG3D,CAAC;AAEF,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,OAAO,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,QAAQ,CAAC;IAAC,QAAQ,EAAE,OAAO,SAAS,CAAA;CAAE,GAAG,IAAI,CAIvH;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAwB;AAC/E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAwB;AAC/E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAA8B;AACrG,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAwB"}

package/dist/src/mem-logger.js

@@ -0,0 +1,24 @@
+/**
+ * Standalone logger for abmind.
+ * Re-exports bridge logger when running inside the bridge,
+ * falls back to minimal console logger when standalone.
+ */
+let _logInfo = (tag, msg) => console.log(`[${tag}] ${msg}`);
+let _logWarn = (tag, msg) => console.warn(`[${tag}] ${msg}`);
+let _logError = (tag, msg, err) => {
+    if (err)
+        console.error(`[${tag}] ${msg}`, err);
+    else
+        console.error(`[${tag}] ${msg}`);
+};
+/** Allow the host (bridge) to inject its own logger. */
+export function setLogger(fns) {
+    _logInfo = fns.logInfo;
+    _logWarn = fns.logWarn;
+    _logError = fns.logError;
+}
+export function logInfo(tag, msg) { _logInfo(tag, msg); }
+export function logWarn(tag, msg) { _logWarn(tag, msg); }
+export function logError(tag, msg, err) { _logError(tag, msg, err); }
+export function logDebug(tag, msg) { _logInfo(tag, msg); }
+//# sourceMappingURL=mem-logger.js.map

package/dist/src/mem-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-logger.js","sourceRoot":"","sources":["../../src/mem-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,IAAI,QAAQ,GAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;AAChG,IAAI,QAAQ,GAAuC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;AACjG,IAAI,SAAS,GAAsD,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACnF,IAAI,GAAG;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;;QAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,wDAAwD;AACxD,MAAM,UAAU,SAAS,CAAC,GAAuF;IAC/G,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC;IACvB,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC;IACvB,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW,IAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/E,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW,IAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/E,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,GAAW,EAAE,GAAa,IAAU,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACrG,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,GAAW,IAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/dist/src/mem-paths.d.ts

@@ -0,0 +1,20 @@
+/** Standalone paths for abmind. */
+export declare function abmindHome(): string;
+/** Directory for Kiro hook sidecar files + error logs (#344). */
+export declare function abmindHooksDir(): string;
+/** Path for extraction pending marker (#366). */
+export declare function extractionPendingPath(): string;
+/** Path for extraction failure counter (#366). */
+export declare function extractionFailuresPath(): string;
+/** Path for the hook error log (errors from wakeup/recall/store hooks). */
+export declare function hookErrorLogPath(): string;
+/**
+ * Derive a stable sidecar key for the current Kiro session.
+ * Preferred: KIRO_SESSION_ID env var (set by Kiro CLI, stable across all hooks
+ * in one session). Fallback: hash of cwd+date (coarse; collides only on same
+ * directory + same day + missing env var). Last resort: constant string.
+ */
+export declare function hookSidecarKey(): string;
+/** Path to the sidecar file holding the most recent user prompt for this session. */
+export declare function hookSidecarPath(): string;
+//# sourceMappingURL=mem-paths.d.ts.map

package/dist/src/mem-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-paths.d.ts","sourceRoot":"","sources":["../../src/mem-paths.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAMnC,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,iEAAiE;AACjE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAED,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/src/mem-paths.js

@@ -0,0 +1,43 @@
+/** Standalone paths for abmind. */
+import { resolve } from "node:path";
+import { homedir } from "node:os";
+import { createHash } from "node:crypto";
+export function abmindHome() {
+    const raw = process.env.ABMIND_HOME ?? resolve(homedir(), ".abmind");
+    return raw.startsWith("~") ? resolve(homedir(), raw.slice(1).replace(/^[/\\]/, "")) : raw;
+}
+/** Directory for Kiro hook sidecar files + error logs (#344). */
+export function abmindHooksDir() {
+    return resolve(abmindHome(), "hooks");
+}
+/** Path for extraction pending marker (#366). */
+export function extractionPendingPath() {
+    return resolve(abmindHooksDir(), "extraction-pending.marker");
+}
+/** Path for extraction failure counter (#366). */
+export function extractionFailuresPath() {
+    return resolve(abmindHooksDir(), "extraction-failures.json");
+}
+/** Path for the hook error log (errors from wakeup/recall/store hooks). */
+export function hookErrorLogPath() {
+    return resolve(abmindHooksDir(), "errors.log");
+}
+/**
+ * Derive a stable sidecar key for the current Kiro session.
+ * Preferred: KIRO_SESSION_ID env var (set by Kiro CLI, stable across all hooks
+ * in one session). Fallback: hash of cwd+date (coarse; collides only on same
+ * directory + same day + missing env var). Last resort: constant string.
+ */
+export function hookSidecarKey() {
+    const kiroId = process.env.KIRO_SESSION_ID?.trim();
+    if (kiroId)
+        return kiroId;
+    const cwd = process.cwd();
+    const date = new Date().toISOString().slice(0, 10);
+    return "fallback-" + createHash("sha256").update(cwd + date).digest("hex").slice(0, 16);
+}
+/** Path to the sidecar file holding the most recent user prompt for this session. */
+export function hookSidecarPath() {
+    return resolve(abmindHooksDir(), `last-prompt-${hookSidecarKey()}.txt`);
+}
+//# sourceMappingURL=mem-paths.js.map

package/dist/src/mem-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-paths.js","sourceRoot":"","sources":["../../src/mem-paths.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5F,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,2BAA2B,CAAC,CAAC;AAChE,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,0BAA0B,CAAC,CAAC;AAC/D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,eAAe,cAAc,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/src/mem-types.d.ts

@@ -0,0 +1,157 @@
+/** A single conversation turn stored in a transcript and indexed for search. */
+export type MessageRecord = {
+    role: "user" | "assistant" | "compaction";
+    content: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    userId: string;
+    sessionId: string;
+    /** Platform-specific message ID (e.g. Telegram message_id) for reaction tracking */
+    platformMessageId?: number;
+};
+/** Hierarchical memory consolidation tier. Quarterly added for new 3-tier compaction; monthly/yearly kept for backward compat. */
+export type MemoryTier = "daily" | "weekly" | "quarterly" | "monthly" | "yearly";
+/** A search result from the FTS5 index. */
+export type SearchResult = {
+    record: MessageRecord;
+    /** BM25 relevance score */
+    score: number;
+};
+/** A search result from the vector index. */
+export type VectorSearchResult = {
+    messageId: number;
+    /** Cosine similarity score */
+    score: number;
+};
+/** Options for filtering search results. */
+export type SearchOptions = {
+    userId?: string;
+    startTime?: number;
+    endTime?: number;
+    limit?: number;
+    topic?: string;
+    tier?: "core" | "general";
+    includeExpired?: boolean;
+};
+/** Assembled LLM context with per-tier token usage breakdown. */
+/** Result of a forget/cascade-delete operation (Phase 2). */
+export type ForgetResult = {
+    messagesRemoved: number;
+    embeddingsRemoved: number;
+    transcriptEntriesRemoved: number;
+};
+/** A structured memory extracted from conversation transcripts by the MemoryExtractor. */
+export type ExtractedMemory = {
+    id?: number;
+    user_id: string;
+    content_original: string;
+    content_en: string;
+    memory_type: "fact" | "decision" | "preference" | "event" | "lesson" | "feedback" | "story" | "observation";
+    created_at: number;
+    preserve_original: boolean;
+    preserved_keyword?: string;
+    emotion_score: number;
+    entities?: string[];
+    topic?: string;
+    tier?: "core" | "general";
+    valid_from?: string;
+    valid_to?: string | null;
+};
+/** Parameters for the agent-initiated memory search tool. */
+export type MemorySearchParams = {
+    keywords: string[];
+    original_keyword?: string;
+    time_range?: {
+        start: number;
+        end: number;
+    };
+};
+/** A single result from the memory search tool. */
+export type MemorySearchResult = {
+    id?: number;
+    content: string;
+    content_original?: string;
+    memory_type?: string;
+    created_at: number;
+    source_message_ids?: string;
+    tier: "extracted" | "daily" | "weekly" | "quarterly";
+    score: number;
+    trust?: number;
+    integrity?: number;
+    credibility?: number;
+    classification?: number;
+};
+/** Heartbeat task definition. */
+export type HeartbeatTask = {
+    name: string;
+    heavy?: boolean;
+    execute: () => Promise<boolean | void>;
+};
+/** Parameters for the agent-initiated instant memory store tool. */
+export type InstantStoreParams = {
+    userId: string;
+    contentEn: string;
+    contentOriginal: string;
+    memoryType: "fact" | "decision" | "preference" | "event" | "lesson" | "feedback" | "story";
+    emotionScore: number;
+    emotionTags?: string;
+    emotionContext?: string;
+    keyword?: string;
+    confidence?: number;
+    sourceMessageIds?: string;
+    classification?: number;
+    trust?: number;
+    integrity?: number;
+    credibility?: number;
+    topic?: string;
+};
+/** Result of an instant memory store operation. */
+export type InstantStoreResult = {
+    stored: boolean;
+    memoriesCount: number;
+    error?: string;
+};
+/** Parameters for the memory edit tool. */
+export type EditMemoryParams = {
+    /** Lookup by memory ID (direct). */
+    memoryId?: number;
+    /** Lookup by platform message ID (finds linked memories). Requires userId. */
+    messageId?: number;
+    userId?: string;
+    /** Editable fields — only provided fields are updated. */
+    contentEn?: string;
+    contentOriginal?: string;
+    keyword?: string;
+    memoryType?: "fact" | "decision" | "preference" | "event";
+    emotionScore?: number;
+    emotionTags?: string;
+    emotionContext?: string;
+    confidence?: number;
+    trust?: number;
+    integrity?: number;
+    credibility?: number;
+    classification?: number;
+    /** Relevance: absolute number or string "+N"/"-N" for relative delta. */
+    relevanceScore?: number | string;
+    /** Caller for audit trail. */
+    caller?: string;
+    /** Declassify SECRET requires this. */
+    userOverride?: boolean;
+    /** Preview changes without committing. */
+    dryRun?: boolean;
+    /** ABM v1: topic assignment. */
+    topic?: string;
+    /** ABM v1: tier promotion/demotion. */
+    tier?: "core" | "general";
+    /** ABM v1: temporal invalidation (ISO date or empty string to clear). */
+    validTo?: string | null;
+};
+/** Result of a memory edit operation. */
+export type EditMemoryResult = {
+    ok: boolean;
+    memoriesUpdated?: number;
+    ids?: number[];
+    fieldsUpdated?: string[];
+    error?: string;
+};
+//# sourceMappingURL=mem-types.d.ts.map

package/dist/src/mem-types.d.ts.map

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

package/dist/src/mem-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mem-types.js.map

package/dist/src/mem-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem-types.js","sourceRoot":"","sources":["../../src/mem-types.ts"],"names":[],"mappings":""}

package/dist/src/memory-backend.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MemoryBackend — transport-agnostic memory API for CLI tools + tool-registry.
+ *
+ * ┌────────────────────────────────────────────────────────────────────────────┐
+ * │ When to use                                                                │
+ * ├────────────────────────────────────────────────────────────────────────────┤
+ * │ Consumers that may run in-process OR talk to a separate abmind process     │
+ * │ over an IPC socket. The interface hides the transport — the caller just    │
+ * │ awaits a Promise and doesn't care whether storage is local SQLite or       │
+ * │ remote-over-socket.                                                        │
+ * │                                                                            │
+ * │ Use when:                                                                  │
+ * │   - CLI tools (abmind store/edit/merge/recall — they use createMemoryBackend)  │
+ * │   - Direct-API tool-registry (abtars's memory_store / memory_recall / │
+ * │     memory_edit tools register a MemoryBackend once at boot)               │
+ * │   - MCP server adapter                                                     │
+ * │   - Ecosystem plugins (openclaw, future hosts) that don't own the process  │
+ * └────────────────────────────────────────────────────────────────────────────┘
+ *
+ * Implementations:
+ *   SqliteBackend   in-process (sqlite-backend.ts) — wraps MemoryManager
+ *   IpcBackend      over Unix socket (memory-ipc-client.ts) — talks to a
+ *                   long-running abmind process via memory-ipc-server.ts
+ *
+ * Factory: `createMemoryBackend(config)` in backend-factory.ts picks the
+ * right one (tries IPC socket first, falls back to SQLite).
+ *
+ * Relationship to IMemoryCore/IMemorySystem (see imemory-system.ts):
+ *   IMemoryCore/IMemorySystem  = in-process, direct object reference,
+ *                                includes read + context-building methods
+ *   MemoryBackend              = transport-agnostic, async-only, focused on
+ *                                the write + recall paths callers need from
+ *                                outside the host's process
+ *
+ * Rule of thumb:
+ *   - Running inside the host process? → IMemoryCore (read) or IMemorySystem (full)
+ *   - Shelled-out CLI / tool call / IPC boundary? → MemoryBackend
+ *
+ * All methods are async — even local SQLite calls return Promises — so swap
+ * of transport is source-compatible.
+ */
+import type { InstantStoreParams, InstantStoreResult, EditMemoryParams, EditMemoryResult, ForgetResult } from "./mem-types.js";
+import type { RecallParams, RecallResult } from "./recall-engine.js";
+/** Merge result from combining two memories. */
+export type MergeResult = {
+    merged: true;
+    keptId: number;
+    deletedId: number;
+} | {
+    merged: false;
+    error: string;
+};
+/** Abstract memory backend — all CLI tools go through this. */
+export interface MemoryBackend {
+    initialize(): Promise<void>;
+    close(): void;
+    instantStore(params: InstantStoreParams): Promise<InstantStoreResult>;
+    editMemory(params: EditMemoryParams): Promise<EditMemoryResult>;
+    reclassifyMemory(id: number, level: number, userOverride: boolean): Promise<void>;
+    adjustRelevance(id: number, delta: number): Promise<void>;
+    mergeMemories(idA: number, idB: number): Promise<MergeResult>;
+    cascadeDelete(messageIds: number[], userId: string): Promise<ForgetResult>;
+    recall(params: RecallParams): Promise<RecallResult>;
+}
+//# sourceMappingURL=memory-backend.d.ts.map

package/dist/src/memory-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-backend.d.ts","sourceRoot":"","sources":["../../src/memory-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjH,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;IAGd,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAGtE,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9D,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAG3E,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACrD"}