bereach-openclaw 1.3.2 → 1.3.3

package/__tests__/helpers.test.ts

@@ -59,7 +59,7 @@ function commentsPage(
   opts: { total: number; start: number; hasMore: boolean },
 ) {
   return {
-    success: true,
+    success: true as const,
     profiles,
     count: profiles.length,
     total: opts.total,
@@ -68,7 +68,7 @@ function commentsPage(
     previousTotal: null,
     creditsUsed: 1,
     retryAfter: 0,
-  };
+  } as never;
 }
 
 function invitationsPage(
@@ -76,14 +76,14 @@ function invitationsPage(
   opts: { total: number; start: number },
 ) {
   return {
-    success: true,
+    success: true as const,
     invitations,
     total: opts.total,
     start: opts.start,
     count: invitations.length,
     creditsUsed: 1,
     retryAfter: 0,
-  };
+  } as never;
 }
 
 // ── withRetry ───────────────────────────────────────────────────────
@@ -445,8 +445,10 @@ describe("visitProfileIfNeeded", () => {
     expect(result.memberDistance).toBe(1);
     expect(result.visited).toBe(true);
     expect(result.pendingConnection).toBe("none");
-    expect(result.firstName).toBe("Alice");
-    expect(result.profileUrn).toBe("urn:li:fsd_profile:123");
+    if (result.visited) {
+      expect(result.firstName).toBe("Alice");
+      expect(result.profileUrn).toBe("urn:li:fsd_profile:123");
+    }
     expect(mock).toHaveBeenCalledWith({ profile: "u/alice", campaignSlug: "slug" });
   });
 

package/__tests__/soul-injection.test.ts

@@ -0,0 +1,285 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { injectSoulTemplate } from "../src/index";
+
+const MOCK_TEMPLATE = [
+  "<!-- bereach-workspace-v2 -->",
+  "",
+  "## Identity",
+  "",
+  "You are a BeReach-powered LinkedIn automation agent.",
+  "",
+  "<!-- /bereach-workspace -->",
+].join("\n");
+
+describe("injectSoulTemplate", () => {
+  it("returns template when SOUL.md is empty", () => {
+    const result = injectSoulTemplate("", MOCK_TEMPLATE);
+    expect(result).toBe(MOCK_TEMPLATE);
+  });
+
+  it("returns template when SOUL.md is whitespace-only", () => {
+    const result = injectSoulTemplate("   \n  ", MOCK_TEMPLATE);
+    expect(result).toBe(MOCK_TEMPLATE);
+  });
+
+  it("appends template when SOUL.md has no markers", () => {
+    const existing = "# My Custom SOUL\n\nI am a helpful assistant.";
+    const result = injectSoulTemplate(existing, MOCK_TEMPLATE);
+
+    expect(result).toBe(existing + "\n\n" + MOCK_TEMPLATE);
+    expect(result).toContain("# My Custom SOUL");
+    expect(result).toContain("bereach-workspace-v2");
+  });
+
+  it("replaces content between markers when they exist", () => {
+    const existing = [
+      "# My Custom SOUL",
+      "",
+      "Some user content.",
+      "",
+      "<!-- bereach-workspace-v1 -->",
+      "",
+      "## Old BeReach content",
+      "",
+      "This is outdated.",
+      "",
+      "<!-- /bereach-workspace -->",
+      "",
+      "## My Other Section",
+      "",
+      "More user content.",
+    ].join("\n");
+
+    const result = injectSoulTemplate(existing, MOCK_TEMPLATE);
+
+    expect(result).toContain("# My Custom SOUL");
+    expect(result).toContain("Some user content.");
+    expect(result).toContain("## My Other Section");
+    expect(result).toContain("More user content.");
+    expect(result).toContain("bereach-workspace-v2");
+    expect(result).not.toContain("bereach-workspace-v1");
+    expect(result).not.toContain("Old BeReach content");
+    expect(result).not.toContain("This is outdated.");
+  });
+
+  it("preserves content before and after markers exactly", () => {
+    const before = "# Before\n\n";
+    const after = "\n\n# After\n";
+    const oldBlock = "<!-- bereach-workspace-v1 -->\nold\n<!-- /bereach-workspace -->";
+    const existing = before + oldBlock + after;
+
+    const result = injectSoulTemplate(existing, MOCK_TEMPLATE);
+
+    expect(result.startsWith(before)).toBe(true);
+    expect(result.endsWith(after)).toBe(true);
+  });
+
+  it("handles same-version markers (idempotent replacement)", () => {
+    const existing = [
+      "# Header",
+      "",
+      MOCK_TEMPLATE,
+      "",
+      "# Footer",
+    ].join("\n");
+
+    const result = injectSoulTemplate(existing, MOCK_TEMPLATE);
+
+    expect(result).toContain("# Header");
+    expect(result).toContain("# Footer");
+    const markerCount = (result.match(/bereach-workspace-v2/g) || []).length;
+    expect(markerCount).toBe(1);
+  });
+});
+
+describe("real-world SOUL.md (Alexandre)", () => {
+  const ALEXANDRE_SOUL = `# SOUL.md
+
+## Core Principles
+
+- Be direct, no filler. Alexandre moves fast — match his pace.
+- Do first, ask later (unless it's destructive or public-facing).
+- You're an operator, not a teacher. Execute, don't explain how to execute.
+- Speak French when Alexandre speaks French. Default to English otherwise.
+- You know his stack inside out: OpenClaw, BeReach, PIMMS, LinkedIn growth.
+
+## How to Operate
+
+- Don't read extra files at session start. Use memory_search() for prior context.
+- Save incrementally after each action. Dedup via campaignSlug.
+- Before writing or editing any code: \`/model opus\`. IMMEDIATELY after Write/Edit: \`/model sonnet\`. Never stay on Opus for non-code work.
+- Update memory/YYYY-MM-DD.md at session end with work done and next steps.`;
+
+  it("appends BeReach template (no markers in current SOUL.md)", () => {
+    const result = injectSoulTemplate(ALEXANDRE_SOUL, MOCK_TEMPLATE);
+
+    // User content preserved
+    expect(result).toContain("## Core Principles");
+    expect(result).toContain("Alexandre moves fast");
+    expect(result).toContain("## How to Operate");
+    expect(result).toContain("memory_search()");
+    expect(result).toContain("/model opus");
+
+    // BeReach template appended
+    expect(result).toContain("bereach-workspace-v2");
+    expect(result).toContain("You are a BeReach-powered LinkedIn automation agent.");
+
+    // User content comes first, then template
+    const userIdx = result.indexOf("## Core Principles");
+    const templateIdx = result.indexOf("bereach-workspace-v2");
+    expect(userIdx).toBeLessThan(templateIdx);
+  });
+
+  it("replaces BeReach region after it was previously appended", () => {
+    // Simulate: first run appended, now upgrading
+    const afterFirstRun = injectSoulTemplate(ALEXANDRE_SOUL, MOCK_TEMPLATE);
+
+    const UPDATED_TEMPLATE = MOCK_TEMPLATE.replace(
+      "You are a BeReach-powered LinkedIn automation agent.",
+      "You are a BeReach v2 LinkedIn automation agent.",
+    );
+
+    const afterUpgrade = injectSoulTemplate(afterFirstRun, UPDATED_TEMPLATE);
+
+    // User content still preserved
+    expect(afterUpgrade).toContain("Alexandre moves fast");
+    expect(afterUpgrade).toContain("## How to Operate");
+
+    // Old template replaced, new one present
+    expect(afterUpgrade).not.toContain(
+      "You are a BeReach-powered LinkedIn automation agent.",
+    );
+    expect(afterUpgrade).toContain("You are a BeReach v2 LinkedIn automation agent.");
+
+    // Only one set of markers
+    const startMarkers = (afterUpgrade.match(/bereach-workspace-v/g) || []).length;
+    const endMarkers = (afterUpgrade.match(/\/bereach-workspace/g) || []).length;
+    expect(startMarkers).toBe(1);
+    expect(endMarkers).toBe(1);
+  });
+
+  it("full integration: appends real SOUL_TEMPLATE to Alexandre's SOUL.md", async () => {
+    const { SOUL_TEMPLATE } = await import("../src/soul-template-content");
+
+    const result = injectSoulTemplate(ALEXANDRE_SOUL, SOUL_TEMPLATE);
+
+    // All user sections preserved
+    expect(result).toContain("## Core Principles");
+    expect(result).toContain("Alexandre moves fast");
+    expect(result).toContain("/model opus");
+
+    // Full BeReach workspace injected
+    expect(result).toContain("bereach_search_people");
+    expect(result).toContain("bereach_visit_profile");
+    expect(result).toContain("bereach_send_message");
+    expect(result).toContain("## Sub-Skills — MANDATORY Loading Table");
+    expect(result).toContain("Lead Magnet");
+
+    // Verify structure: user content -> separator -> template
+    const lines = result.split("\n");
+    const soulLine = lines.findIndex((l) => l.includes("Core Principles"));
+    const templateLine = lines.findIndex((l) => l.includes("bereach-workspace-v2"));
+    expect(soulLine).toBeGreaterThan(0);
+    expect(templateLine).toBeGreaterThan(soulLine);
+  });
+});
+
+describe("fetchSoulTemplate (API-first with embedded fallback)", () => {
+  const originalFetch = globalThis.fetch;
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch;
+  });
+
+  it("uses API response when available", async () => {
+    const apiSoul = "<!-- bereach-workspace-v3 -->\nAPI version\n<!-- /bereach-workspace -->";
+    globalThis.fetch = vi.fn().mockResolvedValue({
+      ok: true,
+      json: () => Promise.resolve({ soul: apiSoul }),
+    });
+
+    // Simulate what the hook does with the API template
+    const result = injectSoulTemplate("# My Agent", apiSoul);
+    expect(result).toContain("bereach-workspace-v3");
+    expect(result).toContain("API version");
+  });
+
+  it("falls back to embedded template when API fails", async () => {
+    globalThis.fetch = vi.fn().mockRejectedValue(new Error("Network error"));
+
+    const { SOUL_TEMPLATE } = await import("../src/soul-template-content");
+    const result = injectSoulTemplate("# My Agent", SOUL_TEMPLATE);
+    expect(result).toContain("bereach-workspace-v2");
+  });
+
+  it("falls back to embedded template when API returns non-200", async () => {
+    globalThis.fetch = vi.fn().mockResolvedValue({ ok: false, status: 500 });
+
+    const { SOUL_TEMPLATE } = await import("../src/soul-template-content");
+    const result = injectSoulTemplate("# My Agent", SOUL_TEMPLATE);
+    expect(result).toContain("bereach-workspace-v2");
+  });
+});
+
+describe("before_agent_start hook behavior", () => {
+  it("sets SOUL.md on bootstrapFiles when empty", async () => {
+    const { SOUL_TEMPLATE } = await import("../src/soul-template-content");
+
+    const ctx = {
+      bootstrapFiles: {} as Record<string, string>,
+    };
+
+    const existing = ctx.bootstrapFiles["SOUL.md"] ?? "";
+    ctx.bootstrapFiles["SOUL.md"] = injectSoulTemplate(
+      typeof existing === "string" ? existing : "",
+      SOUL_TEMPLATE,
+    );
+
+    expect(ctx.bootstrapFiles["SOUL.md"]).toBe(SOUL_TEMPLATE);
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("bereach-workspace-v2");
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("bereach_search_people");
+  });
+
+  it("appends to existing SOUL.md without markers", async () => {
+    const { SOUL_TEMPLATE } = await import("../src/soul-template-content");
+
+    const ctx = {
+      bootstrapFiles: {
+        "SOUL.md": "# My Agent\n\nI help with things.",
+      },
+    };
+
+    const existing = ctx.bootstrapFiles["SOUL.md"];
+    ctx.bootstrapFiles["SOUL.md"] = injectSoulTemplate(existing, SOUL_TEMPLATE);
+
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("# My Agent");
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("bereach-workspace-v2");
+  });
+
+  it("replaces outdated markers in existing SOUL.md", async () => {
+    const { SOUL_TEMPLATE } = await import("../src/soul-template-content");
+
+    const ctx = {
+      bootstrapFiles: {
+        "SOUL.md": [
+          "# Custom Header",
+          "",
+          "<!-- bereach-workspace-v1 -->",
+          "old content here",
+          "<!-- /bereach-workspace -->",
+          "",
+          "# Custom Footer",
+        ].join("\n"),
+      },
+    };
+
+    const existing = ctx.bootstrapFiles["SOUL.md"];
+    ctx.bootstrapFiles["SOUL.md"] = injectSoulTemplate(existing, SOUL_TEMPLATE);
+
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("# Custom Header");
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("# Custom Footer");
+    expect(ctx.bootstrapFiles["SOUL.md"]).toContain("bereach-workspace-v2");
+    expect(ctx.bootstrapFiles["SOUL.md"]).not.toContain("old content here");
+    expect(ctx.bootstrapFiles["SOUL.md"]).not.toContain("bereach-workspace-v1");
+  });
+});

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach-openclaw",
   "name": "BeReach",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "LinkedIn outreach automation — 60+ tools, instant status commands",
   "configSchema": {
     "type": "object",

package/package.json

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

package/src/commands/setup.ts

@@ -1,37 +1,20 @@
-import { getClient } from "../client";
-
-const API_BASE = "https://api.berea.ch";
-
 export function registerSetupCommand(api: any) {
   if (!api?.registerCommand) return;
   api.registerCommand({
     name: "bereach-setup",
-    description: "Set up or re-initialize BeReach workspace (SOUL.md, crons). Run after first install or to force-refresh.",
+    description:
+      "Set up BeReach crons. SOUL.md is auto-injected at every session start — no manual setup needed.",
     handler: async () => {
-      try {
-        const res = await fetch(`${API_BASE}/api/onboarding/soul`);
-        if (!res.ok) {
-          return { text: `Failed to fetch SOUL template: ${res.status} ${res.statusText}` };
-        }
-        const { soul } = await res.json();
-
-        return {
-          text: [
-            "BeReach setup ready. To complete setup:",
-            "",
-            "1. Copy the SOUL.md template below into your workspace SOUL.md",
-            "   (between the <!-- bereach-workspace-v2 --> markers)",
-            "",
-            "2. Set up the pipeline cron (every 15min):",
-            '   openclaw cron add --name "BeReach Pipeline" --expr "*/15 * * * *"',
-            "",
-            "Template content has been loaded. Say 'apply bereach setup' to have me write it.",
-          ].join("\n"),
-          data: { soulTemplate: soul },
-        };
-      } catch (err) {
-        return { text: `BeReach setup failed: ${err instanceof Error ? err.message : String(err)}` };
-      }
+      return {
+        text: [
+          "BeReach setup:",
+          "",
+          "• SOUL.md: auto-injected at every session start (nothing to do).",
+          "",
+          "• Cron (optional — for automated pipeline runs):",
+          '  openclaw cron add --name "BeReach Pipeline" --expr "*/15 * * * *"',
+        ].join("\n"),
+      };
     },
   });
 }

package/src/index.ts

@@ -2,38 +2,204 @@ import { setApiKey } from "./client";
 import { registerAllTools } from "./tools";
 import { registerCommands } from "./commands";
 import { registerSetupCommand } from "./commands/setup";
+import { SOUL_TEMPLATE } from "./soul-template-content";
 
-const BEREACH_MARKER = "bereach-workspace-v";
+const API_BASE = "https://api.berea.ch";
+const MARKER_START = "<!-- bereach-workspace-v";
+const MARKER_END = "<!-- /bereach-workspace -->";
+
+function log(msg: string, data?: Record<string, unknown>) {
+  const suffix = data ? " " + JSON.stringify(data) : "";
+  console.log(`[bereach] ${msg}${suffix}`);
+}
+
+/**
+ * Fetch the latest soul template from the API (single source of truth).
+ * Falls back to the embedded copy only if the API is unreachable.
+ */
+async function fetchSoulTemplate(): Promise<{ template: string; source: "api" | "embedded" }> {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    log("fetchSoulTemplate: fetching from API...");
+    const res = await fetch(`${API_BASE}/api/onboarding/soul`, {
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
+
+    if (!res.ok) {
+      log("fetchSoulTemplate: API error, using embedded fallback", { status: res.status });
+      return { template: SOUL_TEMPLATE, source: "embedded" };
+    }
+
+    const { soul } = await res.json();
+    if (typeof soul === "string" && soul.includes(MARKER_START)) {
+      log("fetchSoulTemplate: got template from API", { chars: soul.length });
+      return { template: soul, source: "api" };
+    }
+
+    log("fetchSoulTemplate: API response invalid (no markers), using embedded fallback");
+    return { template: SOUL_TEMPLATE, source: "embedded" };
+  } catch (err) {
+    log("fetchSoulTemplate: network error, using embedded fallback", {
+      error: err instanceof Error ? err.message : String(err),
+    });
+    return { template: SOUL_TEMPLATE, source: "embedded" };
+  }
+}
+
+/**
+ * Merge BeReach template into existing SOUL.md content.
+ * - Empty → return template as-is.
+ * - Has markers → replace the region between them.
+ * - No markers → append.
+ */
+export function injectSoulTemplate(existing: string, template: string): string {
+  if (!existing || !existing.trim()) return template;
+
+  const startIdx = existing.indexOf(MARKER_START);
+  const endIdx = existing.indexOf(MARKER_END);
+
+  if (startIdx >= 0 && endIdx > startIdx) {
+    return (
+      existing.slice(0, startIdx) +
+      template.trim() +
+      existing.slice(endIdx + MARKER_END.length)
+    );
+  }
+
+  return existing + "\n\n" + template;
+}
 
 function getApiKey(api: any): string | undefined {
   const key =
-    api?.pluginConfig?.BEREACH_API_KEY ?? // 1. OpenClaw config (plugins.entries.bereach-openclaw.config)
-    api?.config?.BEREACH_API_KEY ?? // 2. Fallback config path
-    process.env.BEREACH_API_KEY; // 3. Env var (or ~/.bashrc export)
+    api?.pluginConfig?.BEREACH_API_KEY ??
+    api?.config?.BEREACH_API_KEY ??
+    process.env.BEREACH_API_KEY;
   return typeof key === "string" && key.trim().length > 0 ? key.trim() : undefined;
 }
 
+function dumpObject(label: string, obj: any, maxDepth = 1) {
+  if (!obj || typeof obj !== "object") {
+    log(`${label}: ${String(obj)}`);
+    return;
+  }
+  const keys = Object.keys(obj);
+  const types: Record<string, string> = {};
+  for (const k of keys) {
+    const v = obj[k];
+    types[k] = v === null ? "null" : Array.isArray(v) ? "array" : typeof v;
+    if (maxDepth > 0 && typeof v === "object" && v !== null && !Array.isArray(v)) {
+      types[k] = `object{${Object.keys(v).join(",")}}`;
+    }
+  }
+  log(`${label}: keys=[${keys.join(", ")}]`, types);
+}
+
 export default function register(api: any) {
+  log("=== register() called ===");
+
+  // Dump everything on the api object so we can see what's available
+  dumpObject("api", api);
+  dumpObject("api.pluginConfig", api?.pluginConfig);
+  if (api?.config) dumpObject("api.config", api.config, 0);
+  if (api?.runtime) dumpObject("api.runtime", api.runtime);
+  if (api?.logger) dumpObject("api.logger", api.logger);
+  log("api.on exists", { exists: typeof api?.on === "function" });
+  log("api.registerHook exists", { exists: typeof api?.registerHook === "function" });
+  log("api.registerTool exists", { exists: typeof api?.registerTool === "function" });
+  log("api.registerCommand exists", { exists: typeof api?.registerCommand === "function" });
+
   const apiKey = getApiKey(api);
   setApiKey(apiKey);
+  log("apiKey", { set: !!apiKey });
+
   registerAllTools(api);
+  log("tools registered");
+
   registerCommands(api);
   registerSetupCommand(api);
+  log("commands registered");
+
+  // --- Hook 1: before_prompt_build (recommended by OpenClaw docs) ---
+  // Injects BeReach SOUL template into the system prompt.
+  // This is the PROPER way — it goes into the system prompt directly,
+  // not a file on disk.
+  if (typeof api?.on === "function") {
+    log("registering before_prompt_build hook...");
 
-  if (api.on) {
+    api.on(
+      "before_prompt_build",
+      async () => {
+        log(">>> hook:before_prompt_build FIRED");
+        try {
+          const { template, source } = await fetchSoulTemplate();
+          log("hook:before_prompt_build: injecting via appendSystemContext", {
+            source,
+            chars: template.length,
+          });
+          return {
+            appendSystemContext: template,
+          };
+        } catch (err) {
+          log("hook:before_prompt_build: ERROR", {
+            error: err instanceof Error ? err.message : String(err),
+          });
+          return {
+            appendSystemContext: SOUL_TEMPLATE,
+          };
+        }
+      },
+      { priority: 5 },
+    );
+    log("before_prompt_build hook registered (priority 5)");
+
+    // --- Hook 2: before_agent_start (legacy, kept as backup) ---
+    // Also injects into bootstrapFiles for older OpenClaw versions
+    // that might not support before_prompt_build.
     api.on("before_agent_start", async (ctx: any) => {
+      log(">>> hook:before_agent_start FIRED");
+      dumpObject("ctx", ctx);
+      if (ctx?.bootstrapFiles) {
+        dumpObject("ctx.bootstrapFiles", ctx.bootstrapFiles);
+      }
+
       try {
-        const soulContent = ctx?.bootstrapFiles?.["SOUL.md"] ?? ctx?.soul ?? "";
-        if (typeof soulContent === "string" && !soulContent.includes(BEREACH_MARKER)) {
-          if (ctx.addSystemNote) {
-            ctx.addSystemNote(
-              "BeReach workspace not configured. Load the BeReach skill for initial setup, or run /bereach-setup."
-            );
-          }
+        if (ctx?.bootstrapFiles) {
+          const existing = ctx.bootstrapFiles["SOUL.md"] ?? "";
+          const hasExisting = typeof existing === "string" && existing.trim().length > 0;
+          const hasMarkers = hasExisting && existing.includes(MARKER_START);
+
+          log("hook:before_agent_start: SOUL.md state", {
+            hasExisting,
+            hasMarkers,
+            existingChars: typeof existing === "string" ? existing.length : 0,
+          });
+
+          const { template, source } = await fetchSoulTemplate();
+          ctx.bootstrapFiles["SOUL.md"] = injectSoulTemplate(
+            typeof existing === "string" ? existing : "",
+            template,
+          );
+
+          const action = !hasExisting ? "set" : hasMarkers ? "replaced" : "appended";
+          log(`hook:before_agent_start: SOUL.md ${action}`, {
+            source,
+            totalChars: ctx.bootstrapFiles["SOUL.md"].length,
+          });
+        } else {
+          log("hook:before_agent_start: no ctx.bootstrapFiles — skipped");
         }
-      } catch {
-        // Hook errors should never break agent startup
+      } catch (err) {
+        log("hook:before_agent_start: ERROR", {
+          error: err instanceof Error ? err.message : String(err),
+        });
       }
     });
+    log("before_agent_start hook registered (legacy backup)");
+  } else {
+    log("WARNING: api.on not available — no hooks registered");
   }
+
+  log("=== register() complete ===");
 }

package/src/soul-template-content.ts

@@ -0,0 +1,3 @@
+// AUTO-GENERATED by build-plugins.js — DO NOT EDIT
+export const SOUL_TEMPLATE = "<!--\n  AUTO-GENERATED FILE — DO NOT EDIT\n  Source of truth: skills/ directory\n  Edit the source file, then run: pnpm build:plugins\n  Any direct edit to this file WILL be overwritten.\n-->\n\n<!-- bereach-workspace-v2 -->\n\n## Identity\n\nYou are a BeReach-powered LinkedIn automation agent.\nFor ANY LinkedIn task, use bereach_* tools. Never use raw HTTP.\n\n## Session Startup [MANDATORY before greeting]\n\n1. bereach_state_list(keysOnly: true) — discover existing context\n2. If \"user-profile\" key exists: bereach_state_get(\"user-profile\")\n3. If any active campaign state found: check progress, resume if needed\n4. bereach_get_credits — check budget\n5. bereach_get_limits — check daily limits\n\n## Tools by Category\n\n### Search\n\n- bereach_search_people: LinkedIn people search (keywords, title, location, industry, company)\n- bereach_search_posts: post search (keywords, date, content type)\n- bereach_search_companies: company search (keywords, size, industry)\n- bereach_search_jobs: job search\n- bereach_search_by_url: parse and run search from a LinkedIn URL\n- bereach_resolve_parameters: resolve text to LinkedIn IDs (GEO, COMPANY, INDUSTRY, SCHOOL)\n\n### Scrape Engagement\n\n- bereach_collect_likes: profiles who liked a post. Auto-creates contacts.\n- bereach_collect_comments: post commenters with text. Auto-creates contacts.\n- bereach_collect_comment_replies: replies to a comment thread. Auto-creates contacts.\n- bereach_collect_posts: posts from a profile. Auto-creates contact.\n- bereach_collect_hashtag_posts: posts by hashtag. Auto-creates contacts.\n- bereach_collect_saved_posts: user's saved posts\n- bereach_visit_profile: visit profile, extract full data (1 credit, cached 24h for 1st degree). Auto-saves profileData to contact.\n- bereach_visit_company: visit company page\n\n### Outreach Actions\n\n- bereach_connect_profile: send connection request (30/day max, visit first)\n- bereach_send_message: send DM (supports conversationUrn fallback)\n- bereach_accept_invitation: accept received invitation\n- bereach_list_invitations: list received invitations\n- bereach_list_sent_invitations: list sent invitations\n- bereach_withdraw_invitation: withdraw sent invitation\n\n### Content Engagement\n\n- bereach_like_post: like/react to a post\n- bereach_comment_on_post: comment on a post\n- bereach_reply_to_comment: reply to a comment\n- bereach_like_comment: like a comment\n- bereach_follow_profile: follow a profile\n- bereach_publish_post: publish or schedule a post\n\n### Inbox\n\n- bereach_list_conversations: list inbox\n- bereach_search_conversations: search by keyword\n- bereach_find_conversation: find by participant (O(1) lookup). Auto-saves conversationData to contact.\n- bereach_get_messages: message history for a conversation\n- bereach_archive_conversation: archive\n\n### Contacts CRM\n\n- bereach_contacts_search: search contacts (stage, tag, score, follow-up date, draft DM)\n- bereach_contacts_stats: funnel metrics\n- bereach_contacts_get_by_url: look up by LinkedIn URL (full contact + activities)\n- bereach_contacts_get_full: get contact by internal ID (full context + activities)\n- bereach_contacts_get_activities: chronological activity log for a contact\n- bereach_contacts_upsert: create/update contacts — for manual imports only (scraping auto-creates contacts)\n- bereach_contacts_update: update stage, score, notes, tags, draft DM\n- bereach_contacts_log_activity: log activities (auto-syncs outreachStatus)\n- bereach_contacts_bulk_update: batch update up to 500\n- bereach_contacts_add: add contacts to a campaign (full upsert — creates if missing, links to campaign)\n- bereach_contacts_list: list contacts in a specific campaign\n\n### Campaigns\n\n- bereach_contacts_create_campaign: create campaign with context (markdown playbook)\n- bereach_contacts_list_campaigns: list campaigns with context\n- bereach_contacts_update_campaign: update campaign settings\n- bereach_campaign_status: per-profile action status (dedup check)\n- bereach_campaign_sync: mark actions completed without performing them\n- bereach_campaign_stats: aggregate campaign stats\n\n### Account\n\n- bereach_get_credits: credit balance (isUnlimited? skip budgeting)\n- bereach_get_limits: rate limit status\n- bereach_get_profile: your LinkedIn profile (0 credits)\n- bereach_get_followers: your followers\n- bereach_get_own_posts: your recent posts\n- bereach_get_profile_views: who viewed your profile\n- bereach_get_feed: LinkedIn feed\n- bereach_refresh_profile: force refresh from LinkedIn\n\n### Agent Memory\n\n- bereach_state_list: list all state keys (keysOnly=true for overview)\n- bereach_state_get: get state for a key\n- bereach_state_set: save/replace state\n- bereach_state_patch: merge fields into state\n- bereach_state_delete: delete state\n\n## Rules\n\n- Dedup: pass campaignSlug on every action. Duplicates return duplicate:true, cost nothing.\n- Visit before connecting: looks natural to LinkedIn.\n- Connection requests: 30/day. Check pendingConnection from visit response first.\n- Credits: when isUnlimited=true, skip credit budgeting.\n- Language: respond in user's language. DMs: match conversation language.\n- Formatting: tables for contacts (Name, Title, Company, Score). No raw IDs/URNs.\n- Auto-save: visitProfile, findConversation, collectComments, collectLikes, collectPosts, searchPeople and other scrape/search tools all auto-create/update contacts. Do NOT manually save profile or conversation data. Do NOT use contacts.upsertContacts for data that was just scraped/visited.\n- State saves: only save pipeline progress (phase, scraped sources) to agentState. Never store profile data in state.\n\n## Sub-Skills — MANDATORY Loading Table\n\nYou MUST load the corresponding sub-skill BEFORE attempting any task that matches\nthe triggers below. The tool listing above is for quick lookups only — workflows\nrequire the full sub-skill instructions.\n\n| Sub-skill     | LOAD WHEN user request matches ANY of these        | Path                 |\n| ------------- | -------------------------------------------------- | -------------------- |\n| Lead Gen      | find leads, search prospects, scrape engagement,   | sub/lead-gen.md      |\n|               | build pipeline, qualify contacts, enrich profiles, |                      |\n|               | ICP, funnel, grow database, hashtag, Sales Nav     |                      |\n| Lead Magnet   | comment-to-DM, resource delivery, post giveaway,   | sub/lead-magnet.md   |\n|               | auto-accept invitations, lead magnet campaign      |                      |\n| SDK Reference | write script, generate code, TypeScript, SDK,      | sdk-reference.md     |\n|               | automate, method signature, batch job              |                      |\n\nDetection: scan the user's message for these concepts regardless of language.\n\"Trouve-moi des leads\" = Lead Gen. \"Set up a comment giveaway\" = Lead Magnet.\nWhen in doubt, load the skill — false positives cost nothing, false negatives\nmean the agent operates without critical workflow knowledge.\n\nNEVER attempt a multi-step lead gen, lead magnet, or script generation workflow\nusing only the tool listing above. Always load the sub-skill first.\n\n<!-- /bereach-workspace -->\n";
+export const SOUL_TEMPLATE_TIMESTAMP = 1773665416;