agenr 0.6.6 → 0.6.8

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.6.8] - 2026-02-19
+
+### Fixed
+- fix(openclaw-plugin): OpenClaw plugin now uses api.on("before_agent_start") instead of api.registerHook("agent:bootstrap"). The previous approach registered the handler in the gateway bundle's internal handlers map, which is a different module instance from the embedded agent runner. The typed hook system (api.on) uses the shared global plugin registry and works correctly across both bundles.
+
+## [0.6.7] - 2026-02-19
+
+### Fixed
+- fix(openclaw-plugin): add name and description to registerHook opts to resolve OpenClaw hook registration warning
+
 ## [0.6.6] - 2026-02-19
 
 ### Added

package/dist/cli-main.js

@@ -12451,7 +12451,22 @@ function resolveWatcherPidPath(configDir) {
 async function writeWatcherPid(configDir) {
   const pidPath = resolveWatcherPidPath(configDir);
   await fs26.mkdir(path25.dirname(pidPath), { recursive: true });
-  await fs26.writeFile(pidPath, String(process.pid), "utf8");
+  const tmpPath = `${pidPath}.${process.pid}.${Date.now()}.tmp`;
+  let handle = null;
+  try {
+    handle = await fs26.open(tmpPath, "w");
+    await handle.writeFile(String(process.pid), "utf8");
+    await handle.sync();
+    await handle.close();
+    handle = null;
+    await fs26.rename(tmpPath, pidPath);
+  } catch (error) {
+    if (handle) {
+      await handle.close().catch(() => void 0);
+    }
+    await fs26.unlink(tmpPath).catch(() => void 0);
+    throw error;
+  }
 }
 async function deleteWatcherPid(configDir) {
   try {
@@ -12778,6 +12793,8 @@ async function runIngestCommand(inputPaths, options, deps) {
     loadWatchStateFn: deps?.loadWatchStateFn ?? loadWatchState,
     saveWatchStateFn: deps?.saveWatchStateFn ?? saveWatchState,
     isWatcherRunningFn: deps?.isWatcherRunningFn ?? isWatcherRunning,
+    readWatcherPidFn: deps?.readWatcherPidFn ?? readWatcherPid,
+    resolveWatcherPidPathFn: deps?.resolveWatcherPidPathFn ?? resolveWatcherPidPath,
     nowFn: deps?.nowFn ?? (() => /* @__PURE__ */ new Date()),
     sleepFn: deps?.sleepFn ?? sleep,
     shouldShutdownFn: deps?.shouldShutdownFn ?? isShutdownRequested
@@ -12785,8 +12802,8 @@ async function runIngestCommand(inputPaths, options, deps) {
   const clackOutput = { output: process.stderr };
   clack4.intro(banner(), clackOutput);
   if (await resolvedDeps.isWatcherRunningFn()) {
-    const pid = await readWatcherPid();
-    const pidFile = resolveWatcherPidPath();
+    const pid = await resolvedDeps.readWatcherPidFn();
+    const pidFile = resolvedDeps.resolveWatcherPidPathFn();
     clack4.log.error(
       formatError(
         `agenr watcher is running (PID ${pid ?? "unknown"}). Stop the watcher before running ingest.
@@ -16259,6 +16276,7 @@ async function runWatchCommand(file, options, deps) {
   const clackOutput = { output: process.stderr };
   warnIfLocked();
   installSignalHandlers();
+  clack10.intro(banner(), clackOutput);
   try {
     await resolvedDeps.writeWatcherPidFn();
   } catch (error) {
@@ -16286,7 +16304,6 @@ async function runWatchCommand(file, options, deps) {
     const raw = options.raw === true;
     const contextEnabled = Boolean(options.context);
     const modeConfig = await resolveWatchMode(file, options, resolvedDeps.statFileFn);
-    clack10.intro(banner(), clackOutput);
     for (const warning of modeConfig.warnings) {
       process.stderr.write(`${warning}
 `);
@@ -16364,13 +16381,12 @@ async function runWatchCommand(file, options, deps) {
         },
         onCycle: (result, ctx) => {
           cycleCount += 1;
-          const timestamp = formatClock(resolvedDeps.nowFn());
+          const now = resolvedDeps.nowFn();
+          const timestamp = formatClock(now);
           const fileLabel = result.filePath ? ` | file=${result.filePath}` : "";
           if (json) {
-            process.stdout.write(
-              `${JSON.stringify({ cycle: cycleCount, at: resolvedDeps.nowFn().toISOString(), ...result })}
-`
-            );
+            process.stdout.write(`${JSON.stringify({ cycle: cycleCount, at: now.toISOString(), ...result })}
+`);
           }
           if (result.error) {
             clack10.log.warn(formatWarn(`[${timestamp}] Cycle ${cycleCount}: ${result.error}${fileLabel}`), clackOutput);

package/dist/openclaw-plugin/index.d.ts

@@ -1,10 +1,10 @@
-type HookEvent = {
-    type: string;
-    action: string;
-    sessionKey: string;
-    context: Record<string, unknown>;
-    timestamp: Date;
-    messages: string[];
+type BeforeAgentStartEvent = {
+    sessionKey?: string;
+    prompt?: string;
+    [key: string]: unknown;
+};
+type BeforeAgentStartResult = {
+    prependContext?: string;
 };
 type PluginLogger = {
     debug?: (message: string) => void;
@@ -18,7 +18,7 @@ type PluginApi = {
     version?: string;
     pluginConfig?: Record<string, unknown>;
     logger: PluginLogger;
-    registerHook: (events: string | string[], handler: (event: HookEvent) => Promise<void> | void) => void;
+    on: (hook: "before_agent_start", handler: (event: BeforeAgentStartEvent) => Promise<BeforeAgentStartResult | undefined> | BeforeAgentStartResult | undefined) => void;
 };
 
 declare const plugin: {

package/dist/openclaw-plugin/index.js

@@ -1,7 +1,3 @@
-// src/openclaw-plugin/index.ts
-import os from "os";
-import path2 from "path";
-
 // src/openclaw-plugin/recall.ts
 import { spawn } from "child_process";
 import path from "path";
@@ -114,7 +110,6 @@ function formatRecallAsMarkdown(result) {
 }
 
 // src/openclaw-plugin/index.ts
-var AGENR_CONTEXT_PATH = path2.join(os.homedir(), ".agenr", "AGENR.md");
 var SKIP_SESSION_PATTERNS = [":subagent:", ":cron:"];
 function shouldSkipSession(sessionKey) {
   return SKIP_SESSION_PATTERNS.some((pattern) => sessionKey.includes(pattern));
@@ -122,42 +117,39 @@ function shouldSkipSession(sessionKey) {
 var plugin = {
   id: "agenr",
   name: "agenr memory context",
-  description: "Injects agenr long-term memory into every agent session via agent:bootstrap",
+  description: "Injects agenr long-term memory into every agent session via before_agent_start",
   register(api) {
-    api.registerHook("agent:bootstrap", async (event) => {
-      try {
-        const ctx = event.context;
-        if (!Array.isArray(ctx.bootstrapFiles)) {
-          return;
-        }
-        const sessionKey = ctx.sessionKey ?? event.sessionKey ?? "";
-        if (shouldSkipSession(sessionKey)) {
-          return;
-        }
-        const config = api.pluginConfig;
-        if (config?.enabled === false) {
+    api.on(
+      "before_agent_start",
+      async (event) => {
+        try {
+          const sessionKey = event.sessionKey ?? "";
+          if (shouldSkipSession(sessionKey)) {
+            return;
+          }
+          const config = api.pluginConfig;
+          if (config?.enabled === false) {
+            return;
+          }
+          const agenrPath = resolveAgenrPath(config);
+          const budget = resolveBudget(config);
+          const result = await runRecall(agenrPath, budget);
+          if (!result) {
+            return;
+          }
+          const markdown = formatRecallAsMarkdown(result);
+          if (!markdown.trim()) {
+            return;
+          }
+          return { prependContext: markdown };
+        } catch (err) {
+          api.logger.warn(
+            `agenr plugin before_agent_start recall failed: ${err instanceof Error ? err.message : String(err)}`
+          );
           return;
         }
-        const agenrPath = resolveAgenrPath(config);
-        const budget = resolveBudget(config);
-        const result = await runRecall(agenrPath, budget);
-        if (!result) {
-          return;
-        }
-        const markdown = formatRecallAsMarkdown(result);
-        if (!markdown.trim()) {
-          return;
-        }
-        const file = {
-          name: "AGENR.md",
-          path: AGENR_CONTEXT_PATH,
-          content: markdown,
-          missing: false
-        };
-        ctx.bootstrapFiles.push(file);
-      } catch {
       }
-    });
+    );
   }
 };
 var openclaw_plugin_default = plugin;

package/package.json

@@ -1,16 +1,21 @@
 {
   "name": "agenr",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "openclaw": {
-    "extensions": [
-      "dist/openclaw-plugin/index.js"
-    ]
+    "extensions": ["dist/openclaw-plugin/index.js"]
   },
   "description": "AGENt memoRy -- Memory infrastructure for AI agents",
   "type": "module",
   "bin": {
     "agenr": "dist/cli.js"
   },
+  "scripts": {
+    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts",
+    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
     "@clack/prompts": "^1.0.1",
     "@libsql/client": "^0.17.0",
@@ -53,11 +58,9 @@
     "README.md"
   ],
   "author": "agenr-ai",
-  "scripts": {
-    "build": "tsup src/cli.ts src/cli-main.ts src/openclaw-plugin/index.ts --format esm --dts",
-    "dev": "tsup src/cli.ts src/cli-main.ts --format esm --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
+  "pnpm": {
+    "overrides": {
+      "fast-xml-parser": "^5.3.6"
+    }
   }
-}
+}