@ubundi/openclaw-cortex 0.2.0

package/dist/utils/format.js

@@ -0,0 +1,7 @@
+export function formatMemories(results) {
+    if (!results.length)
+        return "";
+    const lines = results.map((r) => `- [${r.score.toFixed(2)}] ${r.content}`);
+    return `<cortex_memories>\n${lines.join("\n")}\n</cortex_memories>`;
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAChD,CAAC;IAEF,OAAO,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC;AACtE,CAAC"}

package/dist/utils/metrics.d.ts

@@ -0,0 +1,19 @@
+export declare class LatencyMetrics {
+    private samples;
+    private windowSize;
+    constructor(windowSize?: number);
+    record(durationMs: number): void;
+    get count(): number;
+    percentile(p: number): number | null;
+    get p50(): number | null;
+    get p95(): number | null;
+    get p99(): number | null;
+    summary(): {
+        count: number;
+        p50: number | null;
+        p95: number | null;
+        p99: number | null;
+    };
+    reset(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,SAAsB;IAI5C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOhC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQpC,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IASxF,KAAK,IAAI,IAAI;CAGd"}

package/dist/utils/metrics.js

@@ -0,0 +1,45 @@
+const DEFAULT_WINDOW_SIZE = 100;
+export class LatencyMetrics {
+    samples = [];
+    windowSize;
+    constructor(windowSize = DEFAULT_WINDOW_SIZE) {
+        this.windowSize = windowSize;
+    }
+    record(durationMs) {
+        this.samples.push(durationMs);
+        if (this.samples.length > this.windowSize) {
+            this.samples.shift();
+        }
+    }
+    get count() {
+        return this.samples.length;
+    }
+    percentile(p) {
+        if (this.samples.length === 0)
+            return null;
+        const sorted = [...this.samples].sort((a, b) => a - b);
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        return sorted[Math.max(0, index)];
+    }
+    get p50() {
+        return this.percentile(50);
+    }
+    get p95() {
+        return this.percentile(95);
+    }
+    get p99() {
+        return this.percentile(99);
+    }
+    summary() {
+        return {
+            count: this.count,
+            p50: this.p50,
+            p95: this.p95,
+            p99: this.p99,
+        };
+    }
+    reset() {
+        this.samples = [];
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,OAAO,cAAc;IACjB,OAAO,GAAa,EAAE,CAAC;IACvB,UAAU,CAAS;IAE3B,YAAY,UAAU,GAAG,mBAAmB;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,UAAkB;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,CAAS;QAClB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE3C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/utils/retry-queue.d.ts

@@ -0,0 +1,27 @@
+type Logger = {
+    debug?(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+};
+export interface RetryTask {
+    id: string;
+    execute: () => Promise<void>;
+    retries: number;
+    nextAttemptAt: number;
+}
+export declare class RetryQueue {
+    private logger;
+    private maxRetries;
+    private queue;
+    private timer;
+    private taskCounter;
+    constructor(logger: Logger, maxRetries?: number);
+    start(): void;
+    stop(): void;
+    enqueue(execute: () => Promise<void>, label?: string): void;
+    get pending(): number;
+    private flush;
+}
+export {};
+//# sourceMappingURL=retry-queue.d.ts.map

package/dist/utils/retry-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-queue.d.ts","sourceRoot":"","sources":["../../src/utils/retry-queue.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG;IACZ,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,qBAAa,UAAU;IAMnB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IANpB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,WAAW,CAAK;gBAGd,MAAM,EAAE,MAAM,EACd,UAAU,SAAc;IAGlC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAW3D,IAAI,OAAO,IAAI,MAAM,CAEpB;YAEa,KAAK;CA8BpB"}

package/dist/utils/retry-queue.js

@@ -0,0 +1,67 @@
+const BASE_DELAY_MS = 1000;
+const MAX_DELAY_MS = 60_000;
+const MAX_RETRIES = 5;
+const FLUSH_INTERVAL_MS = 5000;
+export class RetryQueue {
+    logger;
+    maxRetries;
+    queue = [];
+    timer = null;
+    taskCounter = 0;
+    constructor(logger, maxRetries = MAX_RETRIES) {
+        this.logger = logger;
+        this.maxRetries = maxRetries;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (this.queue.length > 0) {
+            this.logger.warn(`Retry queue stopped with ${this.queue.length} pending tasks`);
+        }
+        this.queue = [];
+    }
+    enqueue(execute, label) {
+        const id = label ?? `task-${++this.taskCounter}`;
+        this.queue.push({
+            id,
+            execute,
+            retries: 0,
+            nextAttemptAt: Date.now(),
+        });
+        this.logger.debug?.(`Retry queue: enqueued ${id}`);
+    }
+    get pending() {
+        return this.queue.length;
+    }
+    async flush() {
+        const now = Date.now();
+        const ready = this.queue.filter((t) => t.nextAttemptAt <= now);
+        for (const task of ready) {
+            try {
+                await task.execute();
+                this.queue = this.queue.filter((t) => t.id !== task.id);
+                this.logger.debug?.(`Retry queue: ${task.id} succeeded`);
+            }
+            catch (err) {
+                task.retries++;
+                if (task.retries >= this.maxRetries) {
+                    this.queue = this.queue.filter((t) => t.id !== task.id);
+                    this.logger.warn(`Retry queue: ${task.id} failed after ${this.maxRetries} retries, dropping`, err);
+                }
+                else {
+                    const delay = Math.min(BASE_DELAY_MS * Math.pow(2, task.retries), MAX_DELAY_MS);
+                    task.nextAttemptAt = now + delay;
+                    this.logger.debug?.(`Retry queue: ${task.id} retry ${task.retries}/${this.maxRetries} in ${delay}ms`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=retry-queue.js.map

package/dist/utils/retry-queue.js.map

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

package/dist/utils/transcript-cleaner.d.ts

@@ -0,0 +1,24 @@
+import type { ConversationMessage } from "../client.js";
+/**
+ * Clean a raw JSONL transcript into a conversation suitable for Cortex ingestion.
+ *
+ * Strips:
+ * - System prompt messages (role: "system" / "developer")
+ * - Tool call/result events (tool_calls, tool role messages)
+ * - Base64 encoded images
+ * - Empty messages
+ *
+ * Preserves:
+ * - User messages with speaker attribution
+ * - Assistant messages with content
+ */
+export declare function cleanTranscript(jsonlText: string): ConversationMessage[];
+/**
+ * Clean only new JSONL lines (from an offset-based append).
+ * Returns cleaned messages and whether they're worth ingesting.
+ */
+export declare function cleanTranscriptChunk(newLines: string): {
+    messages: ConversationMessage[];
+    worthIngesting: boolean;
+};
+//# sourceMappingURL=transcript-cleaner.d.ts.map

package/dist/utils/transcript-cleaner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-cleaner.d.ts","sourceRoot":"","sources":["../../src/utils/transcript-cleaner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAkExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CA2BxE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACtD,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;CACzB,CAQA"}

package/dist/utils/transcript-cleaner.js

@@ -0,0 +1,96 @@
+const BASE64_PATTERN = /data:[^;]+;base64,[A-Za-z0-9+/=]{100,}/g;
+const SYSTEM_ROLES = new Set(["system", "developer"]);
+/**
+ * Parse JSONL text into individual events, skipping malformed lines.
+ */
+function parseJsonl(text) {
+    const events = [];
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            events.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip malformed lines
+        }
+    }
+    return events;
+}
+/**
+ * Extract text content from OpenClaw's content field.
+ * Content can be a string, an array of content blocks, or nested structures.
+ */
+function extractText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((block) => typeof block === "object" &&
+            block !== null &&
+            "type" in block &&
+            "text" in block &&
+            block.type === "text")
+            .map((block) => block.text)
+            .join("\n");
+    }
+    return "";
+}
+/**
+ * Strip base64 image data, replacing with a placeholder.
+ */
+function stripBase64(text) {
+    return text.replace(BASE64_PATTERN, "[base64 image]");
+}
+/**
+ * Clean a raw JSONL transcript into a conversation suitable for Cortex ingestion.
+ *
+ * Strips:
+ * - System prompt messages (role: "system" / "developer")
+ * - Tool call/result events (tool_calls, tool role messages)
+ * - Base64 encoded images
+ * - Empty messages
+ *
+ * Preserves:
+ * - User messages with speaker attribution
+ * - Assistant messages with content
+ */
+export function cleanTranscript(jsonlText) {
+    const events = parseJsonl(jsonlText);
+    const messages = [];
+    for (const event of events) {
+        const role = event.role;
+        if (!role)
+            continue;
+        // Skip system prompts
+        if (SYSTEM_ROLES.has(role))
+            continue;
+        // Skip tool call results
+        if (role === "tool" || event.tool_call_id)
+            continue;
+        // Skip messages that are purely tool calls with no text content
+        if (event.tool_calls && !event.content)
+            continue;
+        const text = extractText(event.content);
+        if (!text.trim())
+            continue;
+        const cleaned = stripBase64(text).trim();
+        if (!cleaned || cleaned === "[base64 image]")
+            continue;
+        messages.push({ role, content: cleaned });
+    }
+    return messages;
+}
+/**
+ * Clean only new JSONL lines (from an offset-based append).
+ * Returns cleaned messages and whether they're worth ingesting.
+ */
+export function cleanTranscriptChunk(newLines) {
+    const messages = cleanTranscript(newLines);
+    // Worth ingesting if there's at least one user + one assistant message
+    const hasUser = messages.some((m) => m.role === "user" && m.content.length > 20);
+    const hasAssistant = messages.some((m) => m.role === "assistant" && m.content.length > 20);
+    return { messages, worthIngesting: hasUser && hasAssistant };
+}
+//# sourceMappingURL=transcript-cleaner.js.map

package/dist/utils/transcript-cleaner.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,95 @@
+{
+  "id": "cortex-memory",
+  "name": "Cortex Memory",
+  "description": "Long-term memory powered by Cortex — Auto-Recall, Auto-Capture, transcript ingestion, periodic consolidation, and background file sync",
+  "version": "0.2.0",
+  "kind": "memory",
+  "configSchema": {
+    "type": "object",
+    "required": ["apiKey"],
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "Cortex API key"
+      },
+      "baseUrl": {
+        "type": "string",
+        "description": "Cortex API base URL",
+        "default": "https://q5p64iw9c9.execute-api.us-east-1.amazonaws.com/prod"
+      },
+      "autoRecall": {
+        "type": "boolean",
+        "description": "Inject relevant memories before each agent turn",
+        "default": true
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "description": "Extract facts from conversations after agent turns",
+        "default": true
+      },
+      "recallTopK": {
+        "type": "number",
+        "description": "Number of memories to retrieve per turn",
+        "default": 5
+      },
+      "recallTimeoutMs": {
+        "type": "number",
+        "description": "Maximum time to wait for memory recall (ms)",
+        "default": 500
+      },
+      "recallMode": {
+        "type": "string",
+        "enum": ["fast", "balanced", "full"],
+        "description": "Retrieval depth — fast (BM25 + semantic), balanced (+ light reranking), full (+ graph traversal + reranker)",
+        "default": "fast"
+      },
+      "fileSync": {
+        "type": "boolean",
+        "description": "Watch MEMORY.md and daily logs for background ingestion",
+        "default": true
+      },
+      "transcriptSync": {
+        "type": "boolean",
+        "description": "Watch sessions/*.jsonl and ingest cleaned transcripts",
+        "default": true
+      },
+      "reflectIntervalMs": {
+        "type": "number",
+        "description": "Interval for periodic memory consolidation (ms). Set to 0 to disable.",
+        "default": 3600000
+      }
+    }
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "sensitive": true,
+      "placeholder": "sk-cortex-..."
+    },
+    "baseUrl": {
+      "label": "Base URL",
+      "advanced": true
+    },
+    "recallTopK": {
+      "label": "Recall Top-K",
+      "advanced": true
+    },
+    "recallTimeoutMs": {
+      "label": "Recall Timeout (ms)",
+      "advanced": true
+    },
+    "recallMode": {
+      "label": "Recall Mode",
+      "helpText": "Fast is best for low-latency auto-recall. Full enables graph traversal for deeper retrieval at higher latency."
+    },
+    "transcriptSync": {
+      "label": "Transcript Sync",
+      "helpText": "Automatically ingest session transcripts (sessions/*.jsonl) after stripping system prompts and tool JSON."
+    },
+    "reflectIntervalMs": {
+      "label": "Reflect Interval (ms)",
+      "advanced": true,
+      "helpText": "How often to consolidate memories (SUPERSEDES chains, contradiction detection). Set to 0 to disable."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@ubundi/openclaw-cortex",
+  "version": "0.2.0",
+  "description": "OpenClaw plugin for Cortex memory — Auto-Recall, Auto-Capture, and file sync",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --exclude test/integration/**",
+    "test:watch": "vitest --exclude test/integration/**",
+    "test:integration": "vitest run -c vitest.integration.config.ts",
+    "clean": "rm -rf dist"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "cortex",
+    "memory",
+    "long-term-memory"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "openclaw": ">=0.1.0"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@types/node": "^20.0.0"
+  }
+}