@pennyclaw/idle-prune 0.1.0

package/README.md

@@ -0,0 +1,24 @@
+# Idle Prune
+
+Prunes old `tool_result` payloads after idle time by replacing content with a placeholder.
+
+## Config
+
+```json5
+plugins: {
+  entries: {
+    "idle-prune": {
+      enabled: true,
+      config: {
+        idleMinutes: 15,
+        placeholder: "[pruned due to idle]"
+      }
+    }
+  }
+}
+```
+
+## Notes
+- Runs on `message_received` to avoid extra LLM calls.
+- Keeps tool call IDs and metadata intact.
+- Only rewrites the content of tool-result messages.

package/dist/index.js

@@ -0,0 +1,126 @@
+// index.ts
+import fs from "fs";
+import path from "path";
+function looksLikeGroupId(from) {
+  const lower = from.toLowerCase();
+  if (lower.includes(":group:")) return "group";
+  if (lower.includes(":channel:")) return "channel";
+  if (lower.endsWith("@g.us")) return "group";
+  return "dm";
+}
+function stripChannelPrefix(value, channelId) {
+  const prefix = `${channelId}:`;
+  return value.startsWith(prefix) ? value.slice(prefix.length) : value;
+}
+function pruneToolResultMessage(entry, placeholder) {
+  if (!entry || entry.type !== "message") return false;
+  const msg = entry.message;
+  if (!msg || msg.role !== "tool" && msg.role !== "toolResult") return false;
+  const content = msg.content;
+  if (typeof content === "string") {
+    if (content === placeholder) return false;
+    msg.content = placeholder;
+    return true;
+  }
+  if (Array.isArray(content)) {
+    if (content.length === 1 && content[0]?.type === "text" && content[0]?.text === placeholder) {
+      return false;
+    }
+    msg.content = [{ type: "text", text: placeholder }];
+    return true;
+  }
+  if (content && typeof content === "object" && "text" in content) {
+    if (content.text === placeholder) return false;
+    msg.content = { ...content, text: placeholder };
+    return true;
+  }
+  msg.content = [{ type: "text", text: placeholder }];
+  return true;
+}
+async function pruneTranscript(params) {
+  if (!fs.existsSync(params.sessionFile)) return;
+  const raw = await fs.promises.readFile(params.sessionFile, "utf-8");
+  const lines = raw.split("\n");
+  let changed = false;
+  const out = [];
+  for (const line of lines) {
+    if (!line.trim()) {
+      out.push(line);
+      continue;
+    }
+    try {
+      const entry = JSON.parse(line);
+      if (pruneToolResultMessage(entry, params.placeholder)) {
+        changed = true;
+      }
+      out.push(JSON.stringify(entry));
+    } catch {
+      out.push(line);
+    }
+  }
+  if (!changed) return;
+  const tmp = `${params.sessionFile}.idle-prune.tmp`;
+  await fs.promises.writeFile(tmp, out.join("\n"), "utf-8");
+  await fs.promises.rename(tmp, params.sessionFile);
+  params.logger.info(`idle-prune: pruned tool_result content in ${params.sessionFile}`);
+}
+function register(api) {
+  const pluginCfg = api.pluginConfig ?? {};
+  const idleMinutes = Number.isFinite(pluginCfg.idleMinutes) ? Number(pluginCfg.idleMinutes) : 15;
+  const placeholder = typeof pluginCfg.placeholder === "string" && pluginCfg.placeholder.trim() ? pluginCfg.placeholder : "[pruned due to idle]";
+  api.on("message_received", async (event, ctx) => {
+    if (!idleMinutes || idleMinutes <= 0) return;
+    const from = typeof event.from === "string" ? event.from.trim() : "";
+    if (!from) return;
+    const channelId = typeof ctx.channelId === "string" ? ctx.channelId : "";
+    const conversationId = typeof ctx.conversationId === "string" && ctx.conversationId.trim() ? ctx.conversationId.trim() : typeof event?.metadata?.to === "string" ? event.metadata.to : from;
+    const peerIdRaw = conversationId || from;
+    const peerId = channelId ? stripChannelPrefix(peerIdRaw, channelId) : peerIdRaw;
+    const peerKind = looksLikeGroupId(peerIdRaw);
+    const route = api.runtime.channel.routing.resolveAgentRoute({
+      cfg: api.config,
+      channel: channelId || "telegram",
+      accountId: ctx.accountId ?? void 0,
+      peer: { kind: peerKind, id: peerId }
+    });
+    const storePath = api.runtime.channel.session.resolveStorePath(
+      api.config.session?.store,
+      { agentId: route.agentId }
+    );
+    if (!fs.existsSync(storePath)) return;
+    let store = {};
+    try {
+      store = JSON.parse(await fs.promises.readFile(storePath, "utf-8"));
+    } catch {
+      return;
+    }
+    let sessionKey = route.sessionKey;
+    if (!store[sessionKey]) {
+      const keys = Object.keys(store);
+      const match = keys.find((key) => {
+        const e = store[key] || {};
+        const candidates = [
+          e.origin?.from,
+          e.origin?.to,
+          e.lastTo,
+          e.deliveryContext?.to
+        ].filter(Boolean);
+        return candidates.includes(conversationId) || candidates.includes(peerIdRaw) || candidates.includes(peerId);
+      });
+      if (match) sessionKey = match;
+    }
+    const entry = store[sessionKey];
+    if (!entry || typeof entry.updatedAt !== "number") return;
+    const now = Date.now();
+    if (now - entry.updatedAt < idleMinutes * 60 * 1e3) return;
+    const sessionFile = typeof entry.sessionFile === "string" && entry.sessionFile.trim() || path.join(path.dirname(storePath), `${entry.sessionId}.jsonl`);
+    await pruneTranscript({
+      sessionFile,
+      placeholder,
+      logger: api.logger
+    });
+  });
+}
+export {
+  register as default
+};

package/openclaw.plugin.json

@@ -0,0 +1,18 @@
+{
+  "id": "idle-prune",
+  "name": "Idle Prune",
+  "version": "0.1.0",
+  "description": "Prune tool_result content after idle periods without LLM summarization.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "idleMinutes": { "type": "number", "default": 15, "minimum": 1 },
+      "placeholder": { "type": "string", "default": "[pruned due to idle]" }
+    }
+  },
+  "uiHints": {
+    "idleMinutes": { "label": "Idle minutes" },
+    "placeholder": { "label": "Placeholder text" }
+  }
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@pennyclaw/idle-prune",
+  "version": "0.1.0",
+  "description": "OpenClaw plugin to prune tool_result content after idle",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist/index.js",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "idle",
+    "prune"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup index.ts --format esm --target node18 --out-dir dist"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}