@alfe.ai/openclaw-memory-cloud 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @alfe.ai/openclaw-memory-cloud@0.0.1 build /home/runner/work/alfe/alfe/packages/openclaw-memory-cloud
+> tsc
+

package/dist/auto-capture.d.ts

@@ -0,0 +1,34 @@
+import type { MemoryClient } from "./memory-client.js";
+import type { MemoryCloudConfig, SessionMetadata } from "./types.js";
+/**
+ * Auto-capture manages the idle debounce timer and flushes
+ * accumulated messages to the memory service.
+ *
+ * Flow:
+ * 1. on_message_received: track message, reset timer
+ * 2. Timer fires (60s idle): flush batch to /memory/ingest
+ * 3. agent_end: final flush of remaining messages
+ */
+export declare class AutoCapture {
+    private readonly client;
+    private readonly config;
+    private readonly logger;
+    private static readonly MAX_QUEUE_SIZE;
+    private pendingMessages;
+    private messageIndex;
+    private idleTimer;
+    private sessionKey;
+    private metadata;
+    constructor(client: MemoryClient, config: MemoryCloudConfig, logger: {
+        debug: (msg: string, ctx?: Record<string, unknown>) => void;
+        warn: (msg: string, ctx?: Record<string, unknown>) => void;
+    });
+    setSession(sessionKey: string, metadata?: SessionMetadata): void;
+    trackMessage(role: string, content: string): void;
+    flush(): Promise<void>;
+    onAgentEnd(): Promise<void>;
+    destroy(): void;
+    private resetIdleTimer;
+    private clearIdleTimer;
+}
+//# sourceMappingURL=auto-capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-capture.d.ts","sourceRoot":"","sources":["../src/auto-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpF;;;;;;;;GAQG;AACH,qBAAa,WAAW;IASpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAC7C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAuB;gBAGpB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE;IAGtJ,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI;IAKhE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAsB3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/auto-capture.js

@@ -0,0 +1,87 @@
+/**
+ * Auto-capture manages the idle debounce timer and flushes
+ * accumulated messages to the memory service.
+ *
+ * Flow:
+ * 1. on_message_received: track message, reset timer
+ * 2. Timer fires (60s idle): flush batch to /memory/ingest
+ * 3. agent_end: final flush of remaining messages
+ */
+export class AutoCapture {
+    client;
+    config;
+    logger;
+    static MAX_QUEUE_SIZE = 500;
+    pendingMessages = [];
+    messageIndex = 0;
+    idleTimer = null;
+    sessionKey = null;
+    metadata = {};
+    constructor(client, config, logger) {
+        this.client = client;
+        this.config = config;
+        this.logger = logger;
+    }
+    setSession(sessionKey, metadata) {
+        this.sessionKey = sessionKey;
+        if (metadata)
+            this.metadata = metadata;
+    }
+    trackMessage(role, content) {
+        if (!this.config.autoCapture)
+            return;
+        if (content.length > this.config.captureMaxChars) {
+            content = content.slice(0, this.config.captureMaxChars);
+        }
+        // Enforce max queue size — drop oldest if exceeded
+        if (this.pendingMessages.length >= AutoCapture.MAX_QUEUE_SIZE) {
+            this.logger.warn("Memory queue full — dropping oldest message", { queueSize: this.pendingMessages.length });
+            this.pendingMessages.shift();
+        }
+        this.pendingMessages.push({
+            role,
+            content,
+            index: this.messageIndex++,
+            timestamp: new Date().toISOString(),
+        });
+        this.resetIdleTimer();
+    }
+    async flush() {
+        if (this.pendingMessages.length === 0 || !this.sessionKey)
+            return;
+        const batch = [...this.pendingMessages];
+        this.pendingMessages = [];
+        this.logger.debug("Flushing memory batch", {
+            sessionKey: this.sessionKey,
+            messageCount: batch.length,
+        });
+        try {
+            await this.client.ingest(this.sessionKey, batch, this.metadata);
+        }
+        catch (err) {
+            this.logger.warn("Failed to flush memories", { error: String(err) });
+            // Re-add failed messages for next flush attempt
+            this.pendingMessages.unshift(...batch);
+        }
+    }
+    async onAgentEnd() {
+        this.clearIdleTimer();
+        await this.flush();
+    }
+    destroy() {
+        this.clearIdleTimer();
+    }
+    resetIdleTimer() {
+        this.clearIdleTimer();
+        this.idleTimer = setTimeout(() => {
+            void this.flush();
+        }, this.config.idleFlushSeconds * 1000);
+    }
+    clearIdleTimer() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=auto-capture.js.map

package/dist/auto-capture.js.map

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

package/dist/auto-recall.d.ts

@@ -0,0 +1,23 @@
+import type { MemoryClient } from "./memory-client.js";
+import type { MemoryCloudConfig } from "./types.js";
+/**
+ * Auto-recall loads tiered memory context at session start
+ * and formats it for injection into the agent's prompt.
+ *
+ * Called from the before_agent_start hook.
+ */
+export declare class AutoRecall {
+    private readonly client;
+    private readonly config;
+    private readonly logger;
+    constructor(client: MemoryClient, config: MemoryCloudConfig, logger: {
+        debug: (msg: string, ctx?: Record<string, unknown>) => void;
+        warn: (msg: string, ctx?: Record<string, unknown>) => void;
+    });
+    /**
+     * Load memory context and return formatted XML for prompt injection.
+     * Returns prependContext string for the before_agent_start hook result.
+     */
+    loadForPrompt(userMessage: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=auto-recall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-recall.d.ts","sourceRoot":"","sources":["../src/auto-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE;IAGtJ;;;OAGG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CA8BtE"}

package/dist/auto-recall.js

@@ -0,0 +1,63 @@
+/**
+ * Auto-recall loads tiered memory context at session start
+ * and formats it for injection into the agent's prompt.
+ *
+ * Called from the before_agent_start hook.
+ */
+export class AutoRecall {
+    client;
+    config;
+    logger;
+    constructor(client, config, logger) {
+        this.client = client;
+        this.config = config;
+        this.logger = logger;
+    }
+    /**
+     * Load memory context and return formatted XML for prompt injection.
+     * Returns prependContext string for the before_agent_start hook result.
+     */
+    async loadForPrompt(userMessage) {
+        if (!this.config.autoRecall)
+            return undefined;
+        try {
+            // Detect topic from user message (first significant word)
+            const topicHint = extractTopicHint(userMessage);
+            // Load L1 (facts) + L2 (topic context) in one call
+            const tier = topicHint ? 2 : 1;
+            const context = await this.client.loadContext(tier, topicHint);
+            if (!context.formatted || context.formatted.length === 0) {
+                this.logger.debug("No relevant memories found for prompt");
+                return undefined;
+            }
+            this.logger.debug("Loaded memory context for prompt", {
+                tier,
+                topicHint,
+                factCount: context.facts.length,
+                memoryCount: context.memories.length,
+                tokenEstimate: context.tokenEstimate,
+            });
+            return context.formatted;
+        }
+        catch (err) {
+            this.logger.warn("Failed to load memory context", { error: String(err) });
+            return undefined;
+        }
+    }
+}
+/**
+ * Simple topic hint extraction from user message.
+ * Returns the first capitalized word or proper noun as a potential topic.
+ */
+function extractTopicHint(message) {
+    // Look for proper nouns (capitalized words not at sentence start)
+    const words = message.split(/\s+/);
+    for (let i = 1; i < words.length; i++) {
+        const word = words[i];
+        if (word && word.length > 2 && /^[A-Z]/.test(word) && !/^(The|And|But|For|With|This|That|What|How|Why|When|Where)$/.test(word)) {
+            return word.toLowerCase();
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=auto-recall.js.map

package/dist/auto-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-recall.js","sourceRoot":"","sources":["../src/auto-recall.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IAEF;IACA;IACA;IAHnB,YACmB,MAAoB,EACpB,MAAyB,EACzB,MAAmI;QAFnI,WAAM,GAAN,MAAM,CAAc;QACpB,WAAM,GAAN,MAAM,CAAmB;QACzB,WAAM,GAAN,MAAM,CAA6H;IACnJ,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAE9C,IAAI,CAAC;YACH,0DAA0D;YAC1D,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAEhD,mDAAmD;YACnD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAE/D,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;gBACpD,IAAI;gBACJ,SAAS;gBACT,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;gBAC/B,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;gBACpC,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC,SAAS,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1E,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,kEAAkE;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/H,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/formatter.d.ts

@@ -0,0 +1,7 @@
+import type { MemorySearchResult } from "./types.js";
+/**
+ * Format memory search results into an XML block for agent context injection.
+ * KG facts appear first (precise), then vector results (supporting context).
+ */
+export declare function formatSearchResults(results: MemorySearchResult): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAuBvE"}

package/dist/formatter.js

@@ -0,0 +1,27 @@
+/**
+ * Format memory search results into an XML block for agent context injection.
+ * KG facts appear first (precise), then vector results (supporting context).
+ */
+export function formatSearchResults(results) {
+    const parts = [];
+    if (results.facts.length > 0) {
+        parts.push("Known facts:");
+        for (const fact of results.facts) {
+            const since = typeof fact.since === "string" ? fact.since.slice(0, 10) : "unknown";
+            parts.push(`- ${fact.subject} ${fact.predicate} ${fact.object} (since ${since}, confidence: ${String(fact.confidence)})`);
+        }
+    }
+    if (results.memories.length > 0) {
+        if (parts.length > 0)
+            parts.push("");
+        parts.push("Related conversations:");
+        for (const mem of results.memories) {
+            const truncated = mem.text.length > 200 ? `${mem.text.slice(0, 200)}...` : mem.text;
+            parts.push(`- [${mem.topic}/${mem.subtopic}] ${truncated}`);
+        }
+    }
+    if (parts.length === 0)
+        return "";
+    return `<relevant-memories>\n${parts.join("\n")}\n</relevant-memories>`;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,WAAW,KAAK,iBAAiB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5H,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YACpF,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,OAAO,wBAAwB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * memory-cloud — OpenClaw memory extension
+ *
+ * Replaces the builtin LanceDB memory extension with cloud-backed storage:
+ * - Turbopuffer for vector storage (via services/memory Lambda proxy)
+ * - DynamoDB for knowledge graph
+ * - Haiku for classification + entity extraction
+ *
+ * Registers:
+ * - Memory tools: memory_recall, memory_store, memory_forget, memory_navigate, memory_graph, memory_stats
+ * - Lifecycle hooks: before_agent_start (auto-recall), agent_end (auto-capture), message_received (idle debounce)
+ * - Memory runtime: replaces builtin SQLite backend with cloud backend
+ */
+interface PluginApi {
+    pluginConfig?: Record<string, unknown>;
+    config: Record<string, unknown>;
+    logger: {
+        info: (msg: string, ctx?: Record<string, unknown>) => void;
+        debug: (msg: string, ctx?: Record<string, unknown>) => void;
+        warn: (msg: string, ctx?: Record<string, unknown>) => void;
+        error: (msg: string, ctx?: Record<string, unknown>) => void;
+    };
+    registerTool: (factory: (ctx: ToolContext) => Tool, opts?: {
+        names?: string[];
+    }) => void;
+    registerHook: (events: string | string[], handler: (...args: unknown[]) => unknown, opts?: {
+        name?: string;
+        description?: string;
+    }) => void;
+    on: (hookName: string, handler: (...args: unknown[]) => unknown, opts?: {
+        priority?: number;
+    }) => void;
+    registerMemoryPromptSection: (builder: (params: {
+        availableTools: Set<string>;
+    }) => string[]) => void;
+    registerMemoryRuntime: (runtime: unknown) => void;
+}
+interface ToolContext {
+    agentId?: string;
+    sessionKey?: string;
+    sessionId?: string;
+    messageChannel?: string;
+}
+interface Tool {
+    name: string;
+    label: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (toolCallId: string, params: Record<string, unknown>) => Promise<unknown>;
+}
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    kind: "memory";
+    register(api: PluginApi): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,UAAU,SAAS;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC3D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC5D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC3D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC7D,CAAC;IACF,YAAY,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,CAAC;IACzF,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5I,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvG,2BAA2B,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;KAAE,KAAK,MAAM,EAAE,KAAK,IAAI,CAAC;IACtG,qBAAqB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;;;;;;;kBA2Be,SAAS,GAAG,IAAI;;AAPhC,wBAuNE"}

package/dist/index.js

@@ -0,0 +1,226 @@
+/**
+ * memory-cloud — OpenClaw memory extension
+ *
+ * Replaces the builtin LanceDB memory extension with cloud-backed storage:
+ * - Turbopuffer for vector storage (via services/memory Lambda proxy)
+ * - DynamoDB for knowledge graph
+ * - Haiku for classification + entity extraction
+ *
+ * Registers:
+ * - Memory tools: memory_recall, memory_store, memory_forget, memory_navigate, memory_graph, memory_stats
+ * - Lifecycle hooks: before_agent_start (auto-recall), agent_end (auto-capture), message_received (idle debounce)
+ * - Memory runtime: replaces builtin SQLite backend with cloud backend
+ */
+import { MemoryClient } from "./memory-client.js";
+import { AutoCapture } from "./auto-capture.js";
+import { AutoRecall } from "./auto-recall.js";
+import { formatSearchResults } from "./formatter.js";
+const DEFAULT_CONFIG = {
+    autoCapture: true,
+    autoRecall: true,
+    captureMaxChars: 500,
+    idleFlushSeconds: 60,
+};
+function resolveConfig(pluginConfig) {
+    return {
+        autoCapture: typeof pluginConfig?.autoCapture === "boolean" ? pluginConfig.autoCapture : DEFAULT_CONFIG.autoCapture,
+        autoRecall: typeof pluginConfig?.autoRecall === "boolean" ? pluginConfig.autoRecall : DEFAULT_CONFIG.autoRecall,
+        captureMaxChars: typeof pluginConfig?.captureMaxChars === "number" ? pluginConfig.captureMaxChars : DEFAULT_CONFIG.captureMaxChars,
+        idleFlushSeconds: typeof pluginConfig?.idleFlushSeconds === "number" ? pluginConfig.idleFlushSeconds : DEFAULT_CONFIG.idleFlushSeconds,
+    };
+}
+export default {
+    id: "memory-cloud",
+    name: "Cloud Memory",
+    description: "Persistent agent memory backed by Turbopuffer + DynamoDB knowledge graph",
+    version: "0.1.0",
+    kind: "memory",
+    register(api) {
+        const config = resolveConfig(api.pluginConfig);
+        const logger = api.logger;
+        // Memory service URL from integration DESIRED_STATE config
+        const cfgUrl = api.pluginConfig?.memoryServiceUrl;
+        const cfgKey = api.pluginConfig?.agentApiKey;
+        const cfgAgent = api.pluginConfig?.agentId;
+        const memoryServiceUrl = typeof cfgUrl === "string" ? cfgUrl : "";
+        const agentApiKey = typeof cfgKey === "string" ? cfgKey : "";
+        const agentId = typeof cfgAgent === "string" ? cfgAgent : "";
+        if (!memoryServiceUrl) {
+            throw new Error("memory-cloud: memoryServiceUrl not configured — cannot register memory extension");
+        }
+        const client = new MemoryClient(memoryServiceUrl, agentApiKey, agentId);
+        const autoCapture = new AutoCapture(client, config, logger);
+        const autoRecall = new AutoRecall(client, config, logger);
+        // ─── Memory prompt section ──────────────────────────────────
+        api.registerMemoryPromptSection(({ availableTools }) => {
+            const lines = ["## Memory"];
+            if (availableTools.has("memory_recall")) {
+                lines.push("Use memory_recall to search your conversation history and knowledge graph.");
+                lines.push("Results include structured facts (from knowledge graph) and relevant conversation excerpts.");
+            }
+            if (availableTools.has("memory_store")) {
+                lines.push("Use memory_store to explicitly save important information for future reference.");
+            }
+            if (availableTools.has("memory_graph")) {
+                lines.push("Use memory_graph to look up what you know about a specific entity.");
+            }
+            return lines;
+        });
+        // ─── Tools ──────────────────────────────────────────────────
+        api.registerTool(() => ({
+            name: "memory_recall",
+            label: "Memory Recall",
+            description: "Search conversation memory and knowledge graph. Returns structured facts and relevant conversation excerpts.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "What to search for" },
+                    limit: { type: "number", description: "Maximum results (default 10)" },
+                    topic: { type: "string", description: "Filter by topic" },
+                    tag: { type: "string", description: "Filter by tag (fact/decision/preference/event/discovery)" },
+                },
+                required: ["query"],
+            },
+            execute: async (_toolCallId, params) => {
+                const results = await client.search(params.query, {
+                    limit: params.limit,
+                    topic: params.topic,
+                    tag: params.tag,
+                });
+                return formatSearchResults(results);
+            },
+        }), { names: ["memory_recall", "memory_search"] });
+        api.registerTool(() => ({
+            name: "memory_store",
+            label: "Memory Store",
+            description: "Explicitly save a piece of information to long-term memory.",
+            parameters: {
+                type: "object",
+                properties: {
+                    text: { type: "string", description: "The information to remember" },
+                    topic: { type: "string", description: "Topic category (e.g., person name, project)" },
+                    tag: { type: "string", description: "Memory type: fact, decision, preference, event, discovery" },
+                    importance: { type: "number", description: "Importance 0-1 (default 0.7)" },
+                },
+                required: ["text"],
+            },
+            execute: async (_toolCallId, params) => {
+                const result = await client.store(params.text, {
+                    topic: params.topic,
+                    tag: params.tag,
+                    importance: params.importance,
+                });
+                return `Stored memory: ${result.memoryId}`;
+            },
+        }), { names: ["memory_store"] });
+        api.registerTool(() => ({
+            name: "memory_forget",
+            label: "Memory Forget",
+            description: "Search for and delete memories matching a query.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search for memories to delete" },
+                },
+                required: ["query"],
+            },
+            execute: async (_toolCallId, params) => {
+                const results = await client.search(params.query, { limit: 5 });
+                if (results.memories.length === 0)
+                    return "No matching memories found.";
+                const deleted = [];
+                for (const mem of results.memories) {
+                    try {
+                        await client.deleteMemory(mem.id);
+                        deleted.push(mem.id);
+                    }
+                    catch {
+                        logger.warn("Failed to delete memory", { memoryId: mem.id });
+                    }
+                }
+                return `Deleted ${String(deleted.length)} of ${String(results.memories.length)} matching memories.`;
+            },
+        }), { names: ["memory_forget"] });
+        api.registerTool(() => ({
+            name: "memory_graph",
+            label: "Knowledge Graph",
+            description: "Look up what you know about a specific entity from the knowledge graph.",
+            parameters: {
+                type: "object",
+                properties: {
+                    entity: { type: "string", description: "The entity to look up (person, concept, system)" },
+                },
+                required: ["entity"],
+            },
+            execute: async (_toolCallId, params) => {
+                const result = await client.lookupEntity(params.entity);
+                if (result.triples.length === 0)
+                    return `No knowledge found about "${params.entity}".`;
+                const facts = result.triples.map((t) => `- ${result.subject} ${t.predicate} ${t.object} (since ${t.validFrom.slice(0, 10)})`);
+                return `Known facts about ${result.subject}:\n${facts.join("\n")}`;
+            },
+        }), { names: ["memory_graph"] });
+        api.registerTool(() => ({
+            name: "memory_stats",
+            label: "Memory Stats",
+            description: "Get memory storage statistics.",
+            parameters: { type: "object", properties: {} },
+            execute: async () => {
+                const s = await client.stats();
+                return `Memories: ${String(s.vectorCount)}, Knowledge facts: ${String(s.tripleCount)}, Storage: ${String(Math.round(s.storageEstimateBytes / 1024))} KB`;
+            },
+        }), { names: ["memory_stats"] });
+        api.registerTool(() => ({
+            name: "memory_navigate",
+            label: "Memory Navigate",
+            description: "Browse your memory palace structure — list topics, subtopics, and memory counts.",
+            parameters: { type: "object", properties: {} },
+            execute: async () => {
+                const nav = await client.navigate();
+                const topics = nav?.topics ?? [];
+                if (topics.length === 0)
+                    return "No memories stored yet.";
+                const lines = topics.map((t) => `- ${t.name} (${String(t.tripleCount)} facts, subtopics: ${t.subtopics.join(", ") || "none"})`);
+                return `Memory topics:\n${lines.join("\n")}`;
+            },
+        }), { names: ["memory_navigate"] });
+        // ─── Lifecycle hooks ────────────────────────────────────────
+        // Auto-recall: inject relevant memories at session start
+        api.on("before_agent_start", async (event, ctx) => {
+            const startEvent = event;
+            const agentCtx = ctx;
+            const prompt = typeof startEvent.prompt === "string" ? startEvent.prompt : "";
+            const sessionKey = typeof agentCtx.sessionKey === "string" ? agentCtx.sessionKey : undefined;
+            const channelId = typeof agentCtx.channelId === "string" ? agentCtx.channelId : undefined;
+            if (sessionKey) {
+                autoCapture.setSession(sessionKey, { channelId });
+            }
+            const contextXml = await autoRecall.loadForPrompt(prompt);
+            if (contextXml) {
+                return { prependContext: contextXml };
+            }
+            return undefined;
+        }, { priority: 10 });
+        // Track incoming messages for idle debounce
+        api.on("message_received", (event) => {
+            const msgEvent = event;
+            const content = typeof msgEvent.content === "string" ? msgEvent.content : "";
+            autoCapture.trackMessage("user", content);
+        });
+        // Track outgoing messages
+        api.on("message_sending", (event) => {
+            const msgEvent = event;
+            const content = typeof msgEvent.content === "string" ? msgEvent.content : "";
+            autoCapture.trackMessage("assistant", content);
+        });
+        // Final flush on session end
+        api.on("agent_end", async (event) => {
+            const endEvent = event;
+            if (endEvent.success !== false) {
+                await autoCapture.onAgentEnd();
+            }
+        });
+        logger.info("memory-cloud extension registered", { autoCapture: config.autoCapture, autoRecall: config.autoRecall });
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/memory-client.d.ts

@@ -0,0 +1,50 @@
+import type { MemorySearchResult, MemoryContext, MemoryMessage, SessionMetadata } from "./types.js";
+/**
+ * HTTP client for services/memory.
+ * All memory operations go through the Lambda service — no direct Turbopuffer/DynamoDB access.
+ */
+export declare class MemoryClient {
+    private readonly baseUrl;
+    private readonly agentApiKey;
+    private readonly agentId;
+    constructor(baseUrl: string, agentApiKey: string, agentId: string);
+    search(query: string, opts?: {
+        limit?: number;
+        topic?: string;
+        subtopic?: string;
+        tag?: string;
+        includeKnowledge?: boolean;
+    }): Promise<MemorySearchResult>;
+    store(text: string, opts?: {
+        topic?: string;
+        subtopic?: string;
+        tag?: string;
+        importance?: number;
+    }): Promise<{
+        memoryId: string;
+    }>;
+    ingest(sessionKey: string, messages: MemoryMessage[], metadata?: SessionMetadata): Promise<void>;
+    loadContext(tier: number, topicHint?: string): Promise<MemoryContext>;
+    lookupEntity(subject: string): Promise<{
+        subject: string;
+        triples: {
+            tripleId: string;
+            predicate: string;
+            object: string;
+            validFrom: string;
+            validTo?: string;
+            confidence: number;
+        }[];
+    }>;
+    navigate(): Promise<unknown>;
+    deleteMemory(memoryId: string): Promise<void>;
+    stats(): Promise<{
+        vectorCount: number;
+        tripleCount: number;
+        storageEstimateBytes: number;
+    }>;
+    private post;
+    private get;
+    private del;
+}
+//# sourceMappingURL=memory-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-client.d.ts","sourceRoot":"","sources":["../src/memory-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpG;;;GAGG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM;IAK5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYzB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAW3B,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAOrE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3C,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC7H,CAAC;IAOI,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAK5B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC;YAKpF,IAAI;YAgBJ,GAAG;YAaH,GAAG;CAYlB"}