openclaw-clawmark 0.2.0 → 0.3.0

package/README.md

@@ -82,6 +82,9 @@ incomplete it stays inert and logs the missing variable — it never breaks the
 
 - `clawmark_set(key, value)` — remember a fact explicitly. User-set facts always win.
 - `clawmark_search(query, limit?)` — search facts + recall excerpts from past sessions.
+- `clawmark_reconcile(drain?)` — force the background jobs to run now (index new
+  messages, extract facts, prune) instead of waiting for the message-count or idle
+  triggers. Say "reconcile memory" to your agent and it should call this.
 - `clawmark_review(days?)` — list extracted facts that haven't been reinforced recently,
   so the agent can confirm them with you before they decay out.
 - `clawmark_forget(key)` — delete a fact.

package/dist/index.js

@@ -27,7 +27,7 @@ const entry = definePluginEntry({
         let jobsRunning = false;
         const runJobs = async (opts = {}) => {
             if (!runtime || jobsRunning)
-                return;
+                return null;
             jobsRunning = true;
             try {
                 const { db, source, embedder, config } = runtime;
@@ -35,12 +35,15 @@ const entry = definePluginEntry({
                 const extracted = await runExtractor(db, source, config, opts);
                 const pruned = pruneStaleFacts(db);
                 rotateEvents(db);
-                if (indexed.indexed > 0 || extracted.written > 0 || pruned > 0) {
-                    log.info(`jobs: indexed ${indexed.indexed} messages, wrote ${extracted.written} facts, pruned ${pruned} stale facts`);
+                const result = { indexed: indexed.indexed, written: extracted.written, pruned };
+                if (result.indexed > 0 || result.written > 0 || result.pruned > 0) {
+                    log.info(`jobs: indexed ${result.indexed} messages, wrote ${result.written} facts, pruned ${result.pruned} stale facts`);
                 }
+                return result;
             }
             catch (err) {
                 log.error(`background jobs failed: ${String(err)}`);
+                return null;
             }
             finally {
                 jobsRunning = false;
@@ -137,7 +140,7 @@ const entry = definePluginEntry({
                 /* never break the agent */
             }
         });
-        for (const tool of buildTools(() => runtime)) {
+        for (const tool of buildTools(() => runtime, (opts) => runJobs(opts))) {
             try {
                 // Cast: our minimal ToolResult structurally matches AgentToolResult.
                 api.registerTool(tool, { optional: true });

package/dist/tools.d.ts

@@ -15,12 +15,20 @@ export interface ClawmarkRuntime {
     embedder: EmbeddingClient;
     config: ClawmarkConfig;
 }
+export interface JobsResult {
+    indexed: number;
+    written: number;
+    pruned: number;
+}
+export type RunJobsFn = (opts?: {
+    drain?: boolean;
+}) => Promise<JobsResult | null>;
 /**
  * Tool definitions in the OpenClaw AgentTool shape. `clawmark_` prefix avoids
  * collisions with native memory tools and other memory plugins. Runtime is resolved
  * lazily so tools registered before gateway_start still work.
  */
-export declare function buildTools(getRuntime: () => ClawmarkRuntime | null): ({
+export declare function buildTools(getRuntime: () => ClawmarkRuntime | null, runJobs: RunJobsFn): ({
     name: string;
     label: string;
     description: string;
@@ -44,6 +52,16 @@ export declare function buildTools(getRuntime: () => ClawmarkRuntime | null): ({
         query: string;
         limit?: number;
     }): Promise<ToolResult>;
+} | {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        drain: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>;
+    execute(_id: string, params: {
+        drain?: boolean;
+    }): Promise<ToolResult>;
 } | {
     name: string;
     label: string;

package/dist/tools.js

@@ -12,7 +12,7 @@ function text(value) {
  * collisions with native memory tools and other memory plugins. Runtime is resolved
  * lazily so tools registered before gateway_start still work.
  */
-export function buildTools(getRuntime) {
+export function buildTools(getRuntime, runJobs) {
     const requireRuntime = () => {
         const rt = getRuntime();
         if (!rt)
@@ -62,6 +62,27 @@ export function buildTools(getRuntime) {
                 });
             },
         },
+        {
+            name: "clawmark_reconcile",
+            label: "Clawmark: reconcile memory now",
+            description: "Force the background memory jobs to run immediately instead of waiting for the " +
+                "message-count or idle triggers: index new messages into the recall store, " +
+                "extract durable facts from un-processed conversation, and prune stale facts. " +
+                "Use when the user asks to sync/reconcile/refresh memory or after an important " +
+                "conversation they want captured right away.",
+            parameters: Type.Object({
+                drain: Type.Optional(Type.Boolean({ description: "Process the entire backlog (default true); false = one incremental pass" })),
+            }),
+            async execute(_id, params) {
+                requireRuntime();
+                const result = await runJobs({ drain: params.drain ?? true });
+                if (result === null) {
+                    return text("Reconcile already in progress (or plugin not initialized) — try again shortly.");
+                }
+                return text(`Reconciled: indexed ${result.indexed} new messages, extracted ${result.written} facts, ` +
+                    `pruned ${result.pruned} stale facts.`);
+            },
+        },
         {
             name: "clawmark_review",
             label: "Clawmark: review stale facts",

package/openclaw.plugin.json

@@ -2,8 +2,8 @@
   "id": "clawmark",
   "name": "Clawmark",
   "description": "Durable facts and semantic recall for OpenClaw, derived from the message history you already keep. No duplicate message store; crash-safe by design.",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "contracts": {
-    "tools": ["clawmark_set", "clawmark_search", "clawmark_review", "clawmark_forget"]
+    "tools": ["clawmark_set", "clawmark_search", "clawmark_reconcile", "clawmark_review", "clawmark_forget"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-clawmark",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Clawmark — durable facts and semantic recall for OpenClaw, derived from the message history you already keep. No duplicate message store; crash-safe by design.",
   "type": "module",
   "license": "MIT",