bereach-openclaw 1.6.11 → 1.6.12

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach-openclaw",
   "name": "BeReach",
-  "version": "1.6.11",
+  "version": "1.6.12",
   "description": "LinkedIn outreach automation — 75+ tools, hook-based enforcement, dynamic context",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "1.6.11",
+  "version": "1.6.12",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "exports": {

package/src/hooks/bootstrap.ts

@@ -0,0 +1,32 @@
+/**
+ * agent:bootstrap internal hook — drops workspace bootstrap files (SOUL.md,
+ * AGENTS.md, IDENTITY.md, USER.md, TOOLS.md, BOOTSTRAP.md, HEARTBEAT.md,
+ * MEMORY.md) from every run.
+ *
+ * Why: the bereach plugin already injects its full soul template + live status
+ * via the before_prompt_build hook (appendSystemContext). Shipping the same
+ * 35K soul template again through workspace/SOUL.md doubles it in the system
+ * prompt and wastes ~5.2K cached tokens per turn (measured on Haiku 4.5).
+ *
+ * Mutating event.context.bootstrapFiles = [] drops every file without
+ * touching disk, so users' workspace directories stay intact.
+ *
+ * Proven on 2026-04-14 Docker test: restoring SOUL.md from template and
+ * enabling this hook gives 37,492 cached tokens/turn vs 42,690 without it.
+ */
+export function registerBootstrapHook(api: any) {
+  if (typeof api?.registerHook !== "function") return;
+  api.registerHook(
+    "agent:bootstrap",
+    async (event: any) => {
+      if (event && event.context) {
+        event.context.bootstrapFiles = [];
+      }
+    },
+    {
+      name: "bereach-blank-bootstrap",
+      description:
+        "Drop workspace bootstrap files — bereach context ships via before_prompt_build already.",
+    },
+  );
+}

package/src/index.ts

@@ -5,6 +5,7 @@ import { registerContextHook } from "./hooks/context";
 import { registerEnforcementHook } from "./hooks/enforcement";
 import { registerTrackingHook } from "./hooks/tracking";
 import { registerLifecycleHook } from "./hooks/lifecycle";
+import { registerBootstrapHook } from "./hooks/bootstrap";
 import { setTtl, isApiBaseConfigured } from "./hooks/cache";
 import { createSessionState, type PluginConfig } from "./hooks/types";
 import { errMsg, createLogger } from "./hooks/utils";
@@ -88,6 +89,7 @@ export default function register(api: any) {
     ["enforcement", () => registerEnforcementHook(api, apiKey, config, state)],
     ["tracking", () => registerTrackingHook(api, state)],
     ["lifecycle", () => registerLifecycleHook(api, apiKey, {}, state)],
+    ["bootstrap", () => registerBootstrapHook(api)],
   ];
 
   for (const [name, fn] of hooks) {

package/src/tools/index.ts

@@ -5,6 +5,28 @@ import { resolveApiKey } from "../index";
 
 const API_BASE = "https://api.bereach.ai";
 
+// Drops short/redundant property descriptions before registration to shrink the
+// cached tool-schema prefix (~3,400 tokens/turn on Haiku 4.5). Keeps any
+// description that contains quoted enum hints, cross-refs to other tools, or
+// format/range constraints — the agent still needs those to pick the right value.
+function isDescriptionLoadBearing(desc: string): boolean {
+  if (desc.length > 90) return true;
+  if (/["'].+["']/.test(desc)) return true;
+  if (/\bresolve\b|bereach_|\brequired\b|\boptional\b|\bmax\b|\bdefault\b|\bmin\b|\bformat\b|\bISO\b|\bURN\b|\burn:/i.test(desc)) return true;
+  return false;
+}
+
+function compactSchemaDescriptions(schema: any): any {
+  if (!schema || typeof schema !== "object") return schema;
+  if (Array.isArray(schema)) return schema.map(compactSchemaDescriptions);
+  const out: Record<string, any> = {};
+  for (const [k, v] of Object.entries(schema)) {
+    if (k === "description" && typeof v === "string" && !isDescriptionLoadBearing(v)) continue;
+    out[k] = compactSchemaDescriptions(v);
+  }
+  return out;
+}
+
 /**
  * Register all tools with OpenClaw.
  * Per-request filtering is handled via allowedTools in the before_prompt_build hook.
@@ -22,7 +44,7 @@ export function registerAllTools(api: any) {
     api.registerTool({
       name: def.name,
       description: def.description,
-      parameters: def.parameters,
+      parameters: compactSchemaDescriptions(def.parameters),
       async execute(_id: string, params: Record<string, unknown>) {
         if (def.handler === "__set_api_key__") {
           const key = String(params.apiKey ?? "").trim();