@alfe.ai/openclaw-memory-cloud 0.0.1

package/dist/memory-client.js

@@ -0,0 +1,108 @@
+/**
+ * HTTP client for services/memory.
+ * All memory operations go through the Lambda service — no direct Turbopuffer/DynamoDB access.
+ */
+export class MemoryClient {
+    baseUrl;
+    agentApiKey;
+    agentId;
+    constructor(baseUrl, agentApiKey, agentId) {
+        this.baseUrl = baseUrl;
+        this.agentApiKey = agentApiKey;
+        this.agentId = agentId;
+        if (!baseUrl)
+            throw new Error("MemoryClient: baseUrl is required");
+    }
+    async search(query, opts) {
+        const resp = await this.post("/memory/search", {
+            query,
+            limit: opts?.limit ?? 10,
+            topic: opts?.topic,
+            subtopic: opts?.subtopic,
+            tag: opts?.tag,
+            includeKnowledge: opts?.includeKnowledge ?? true,
+        });
+        return resp.data;
+    }
+    async store(text, opts) {
+        const resp = await this.post("/memory/store", {
+            text,
+            topic: opts?.topic ?? "general",
+            subtopic: opts?.subtopic ?? "general",
+            tag: opts?.tag ?? "fact",
+            importance: opts?.importance ?? 0.7,
+        });
+        return resp.data;
+    }
+    async ingest(sessionKey, messages, metadata) {
+        await this.post("/memory/ingest", {
+            agentId: this.agentId,
+            sessionKey,
+            lastProcessedIndex: messages.length > 0 ? messages[messages.length - 1].index : -1,
+            messages,
+            metadata,
+        });
+    }
+    async loadContext(tier, topicHint) {
+        const params = new URLSearchParams({ tier: String(tier) });
+        if (topicHint)
+            params.set("topicHint", topicHint);
+        const resp = await this.get(`/memory/context?${params.toString()}`);
+        return resp.data;
+    }
+    async lookupEntity(subject) {
+        const resp = await this.get(`/memory/knowledge/entities?subject=${encodeURIComponent(subject)}`);
+        return resp.data;
+    }
+    async navigate() {
+        const resp = await this.get("/memory/navigate");
+        return resp.data;
+    }
+    async deleteMemory(memoryId) {
+        await this.del(`/memory/${encodeURIComponent(memoryId)}`);
+    }
+    async stats() {
+        const resp = await this.get("/memory/stats");
+        return resp.data;
+    }
+    async post(path, body) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.agentApiKey}`,
+                "x-agent-id": this.agentId,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!resp.ok) {
+            throw new Error(`Memory API error: ${String(resp.status)} ${await resp.text()}`);
+        }
+        return resp.json();
+    }
+    async get(path) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            headers: {
+                Authorization: `Bearer ${this.agentApiKey}`,
+                "x-agent-id": this.agentId,
+            },
+        });
+        if (!resp.ok) {
+            throw new Error(`Memory API error: ${String(resp.status)} ${await resp.text()}`);
+        }
+        return resp.json();
+    }
+    async del(path) {
+        const resp = await fetch(`${this.baseUrl}${path}`, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${this.agentApiKey}`,
+                "x-agent-id": this.agentId,
+            },
+        });
+        if (!resp.ok) {
+            throw new Error(`Memory API error: ${String(resp.status)} ${await resp.text()}`);
+        }
+    }
+}
+//# sourceMappingURL=memory-client.js.map

package/dist/memory-client.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+export interface MemoryCloudConfig {
+    autoCapture: boolean;
+    autoRecall: boolean;
+    captureMaxChars: number;
+    idleFlushSeconds: number;
+}
+export interface MemoryMessage {
+    role: string;
+    content: string;
+    index: number;
+    timestamp?: string;
+}
+export interface SessionMetadata {
+    channelId?: string;
+    userId?: string;
+    userName?: string;
+}
+export interface MemorySearchResult {
+    facts: {
+        subject: string;
+        predicate: string;
+        object: string;
+        since: string;
+        confidence: number;
+    }[];
+    memories: {
+        id: string;
+        text: string;
+        topic: string;
+        subtopic: string;
+        tag: string;
+        importance: number;
+        timestamp: number;
+        score: number;
+    }[];
+}
+export interface MemoryContext {
+    tier: number;
+    facts: {
+        subject: string;
+        predicate: string;
+        object: string;
+        since: string;
+    }[];
+    memories: {
+        text: string;
+        topic: string;
+        subtopic: string;
+        score: number;
+    }[];
+    tokenEstimate: number;
+    formatted: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;IACJ,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;CACL;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7E,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

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

package/dist/types.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,50 @@
+{
+  "id": "memory-cloud",
+  "kind": "memory",
+  "displayName": "Cloud Memory",
+  "description": "Persistent agent memory backed by Turbopuffer vectors and DynamoDB knowledge graph. Replaces the builtin LanceDB memory extension.",
+  "version": "0.1.0",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "autoCapture": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically capture memories from conversations"
+      },
+      "autoRecall": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically inject relevant memories into context at session start"
+      },
+      "captureMaxChars": {
+        "type": "number",
+        "default": 500,
+        "minimum": 100,
+        "maximum": 10000,
+        "description": "Maximum message length for auto-capture"
+      },
+      "idleFlushSeconds": {
+        "type": "number",
+        "default": 60,
+        "minimum": 10,
+        "maximum": 600,
+        "description": "Flush memories after this many seconds of no messages"
+      }
+    }
+  },
+  "uiHints": {
+    "autoCapture": {
+      "label": "Auto-capture",
+      "description": "Automatically store memories from conversations"
+    },
+    "autoRecall": {
+      "label": "Auto-recall",
+      "description": "Inject relevant memories into context at session start"
+    },
+    "idleFlushSeconds": {
+      "label": "Idle flush interval",
+      "description": "Seconds of inactivity before flushing pending memories"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@alfe.ai/openclaw-memory-cloud",
+  "version": "0.0.1",
+  "description": "Cloud memory extension for OpenClaw — Turbopuffer vectors + DynamoDB knowledge graph",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}

package/src/auto-capture.ts

@@ -0,0 +1,96 @@
+import type { MemoryClient } from "./memory-client.js";
+import type { MemoryCloudConfig, MemoryMessage, 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 class AutoCapture {
+  private static readonly MAX_QUEUE_SIZE = 500;
+  private pendingMessages: MemoryMessage[] = [];
+  private messageIndex = 0;
+  private idleTimer: ReturnType<typeof setTimeout> | null = null;
+  private sessionKey: string | null = null;
+  private metadata: SessionMetadata = {};
+
+  constructor(
+    private readonly client: MemoryClient,
+    private readonly config: MemoryCloudConfig,
+    private readonly logger: { debug: (msg: string, ctx?: Record<string, unknown>) => void; warn: (msg: string, ctx?: Record<string, unknown>) => void },
+  ) {}
+
+  setSession(sessionKey: string, metadata?: SessionMetadata): void {
+    this.sessionKey = sessionKey;
+    if (metadata) this.metadata = metadata;
+  }
+
+  trackMessage(role: string, content: string): void {
+    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(): Promise<void> {
+    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(): Promise<void> {
+    this.clearIdleTimer();
+    await this.flush();
+  }
+
+  destroy(): void {
+    this.clearIdleTimer();
+  }
+
+  private resetIdleTimer(): void {
+    this.clearIdleTimer();
+    this.idleTimer = setTimeout(() => {
+      void this.flush();
+    }, this.config.idleFlushSeconds * 1000);
+  }
+
+  private clearIdleTimer(): void {
+    if (this.idleTimer) {
+      clearTimeout(this.idleTimer);
+      this.idleTimer = null;
+    }
+  }
+}

package/src/auto-recall.ts

@@ -0,0 +1,67 @@
+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 class AutoRecall {
+  constructor(
+    private readonly client: MemoryClient,
+    private readonly config: MemoryCloudConfig,
+    private readonly 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.
+   */
+  async loadForPrompt(userMessage: string): Promise<string | undefined> {
+    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: string): string | undefined {
+  // 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;
+}

package/src/formatter.ts

@@ -0,0 +1,30 @@
+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 function formatSearchResults(results: MemorySearchResult): string {
+  const parts: string[] = [];
+
+  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>`;
+}