bereach-openclaw 1.6.11 → 1.6.13

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach-openclaw",
   "name": "BeReach",
-  "version": "1.6.11",
+  "version": "1.6.13",
   "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.13",
   "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,63 @@ import { resolveApiKey } from "../index";
 
 const API_BASE = "https://api.bereach.ai";
 
+// 42 bereach tools that are never used by automation tasks AND have low chat
+// value. Skipping at registration saves ~5,200 prompt tokens/turn (−15%).
+// Proven via Haiku 4.5 probe 2026-04-15: pt 34,121 → 28,912.
+const SKIP_TOOLS = new Set([
+  "bereach_typing_indicator", "bereach_react_message", "bereach_unreact_message",
+  "bereach_mark_all_read", "bereach_unarchive_conversation", "bereach_unstar_conversation",
+  "bereach_list_starred_conversations", "bereach_list_archived_conversations",
+  "bereach_edit_profile", "bereach_edit_post", "bereach_edit_comment",
+  "bereach_repost_post", "bereach_unlike_post", "bereach_like_comment",
+  "bereach_unlike_comment", "bereach_reply_to_comment", "bereach_save_post",
+  "bereach_unsave_post", "bereach_follow_profile", "bereach_unfollow_profile",
+  "bereach_follow_company", "bereach_unfollow_company", "bereach_get_profile_views",
+  "bereach_search_appearances", "bereach_follower_analytics",
+  "bereach_company_page_analytics", "bereach_company_page_posts",
+  "bereach_company_page_permissions", "bereach_list_company_pages",
+  "bereach_get_own_posts", "bereach_get_followers", "bereach_get_connections",
+  "bereach_search_conversations", "bereach_decline_invitation",
+  "bereach_list_sent_invitations", "bereach_withdraw_invitation",
+  "bereach_switch_account", "bereach_list_account", "bereach_update_account",
+  "bereach_collect_comment_replies", "bereach_collect_saved_posts",
+  "bereach_refresh_profile",
+]);
+
+// Essential chat tools keep full descriptions; non-essential tools get "" to
+// save ~3,800 prompt tokens/turn. Agent infers purpose from tool names.
+// Proven via Haiku 4.5 probe 2026-04-15: pt 29,430 → 25,624.
+const KEEP_DESCRIPTION = new Set([
+  "bereach_list_campaigns", "bereach_create_campaign", "bereach_context_get",
+  "bereach_context_set", "bereach_review_drafts", "bereach_list_tasks",
+  "bereach_events_feed", "bereach_campaign_health", "bereach_unified_search",
+  "bereach_save_conversation", "bereach_get_dm_history",
+  "bereach_scheduled_message_create", "bereach_scheduled_message_update",
+  "bereach_contacts_add", "bereach_get_credits", "bereach_set_api_key",
+]);
+
+// 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.
@@ -17,12 +74,13 @@ export function registerAllTools(api: any) {
       console.warn(`[bereach:tools] SKIP ${def.name}: no apiPath defined`);
       continue;
     }
+    if (SKIP_TOOLS.has(def.name)) continue;
 
     registered++;
     api.registerTool({
       name: def.name,
-      description: def.description,
-      parameters: def.parameters,
+      description: KEEP_DESCRIPTION.has(def.name) ? def.description : "",
+      parameters: compactSchemaDescriptions(def.parameters),
       async execute(_id: string, params: Record<string, unknown>) {
         if (def.handler === "__set_api_key__") {
           const key = String(params.apiKey ?? "").trim();