bereach-openclaw 0.3.4 → 1.2.0

package/README.md

@@ -16,13 +16,13 @@ openclaw plugins install bereach-openclaw
 
 ## Upgrade
 
-`openclaw plugins update bereach` can leave `node_modules` and `extensions/` out of sync (version mismatch → trim/crash errors). **Use uninstall + reinstall** instead.
+`openclaw plugins update bereach-openclaw` can leave `node_modules` and `extensions/` out of sync (version mismatch → trim/crash errors). **Use uninstall + reinstall** instead.
 
-**Before upgrading:** note your `BEREACH_API_KEY` — uninstall may remove `plugins.entries.bereach`.
+**Before upgrading:** note your `BEREACH_API_KEY` — uninstall may remove `plugins.entries.bereach-openclaw`.
 
 ```bash
 # 1. Uninstall
-openclaw plugins uninstall bereach
+openclaw plugins uninstall bereach-openclaw
 
 # 2. Reinstall latest
 openclaw plugins install bereach-openclaw
@@ -35,7 +35,7 @@ openclaw plugins install bereach-openclaw
 Verify versions match:
 ```bash
 cat /data/.openclaw/node_modules/bereach-openclaw/package.json | grep version
-cat /data/.openclaw/extensions/bereach/package.json | grep version
+cat /data/.openclaw/extensions/bereach-openclaw/package.json | grep version
 ```
 
 ## Setup
@@ -47,9 +47,9 @@ The API key can be set in 3 ways (in order of precedence):
 ```json
 {
   "plugins": {
-    "allow": ["bereach"],
+    "allow": ["bereach-openclaw"],
     "entries": {
-      "bereach": {
+      "bereach-openclaw": {
         "enabled": true,
         "config": {
           "BEREACH_API_KEY": "brc_your_token_here"
@@ -104,13 +104,13 @@ If that doesn't work:
 
 OpenClaw loads plugins from **two locations**:
 - `node_modules/bereach-openclaw/` — the npm package (source)
-- `extensions/bereach/` — the active copy OpenClaw uses at runtime
+- `extensions/bereach-openclaw/` — the active copy OpenClaw uses at runtime
 
-If `extensions/bereach/` is corrupt or incomplete, you get trim/undefined errors. Fix:
+If `extensions/bereach-openclaw/` is corrupt or incomplete, you get trim/undefined errors. Fix:
 
 **1. Backup and remove the active extension:**
 ```bash
-mv /data/.openclaw/extensions/bereach /data/.openclaw/extensions/bereach.bak.$(date +%s)
+mv /data/.openclaw/extensions/bereach-openclaw /data/.openclaw/extensions/bereach-openclaw.bak.$(date +%s)
 ```
 
 **2. Reinstall from npm (inside the container):**
@@ -119,18 +119,18 @@ cd /data/.openclaw
 npm i bereach-openclaw@latest
 ```
 
-**3. Restart OpenClaw** so it rebuilds `extensions/bereach/` from the package.
+**3. Restart OpenClaw** so it rebuilds `extensions/bereach-openclaw/` from the package.
 
-**4. If `extensions/bereach/` is still incomplete after restart**, force a symlink:
+**4. If `extensions/bereach-openclaw/` is still incomplete after restart**, force a symlink:
 ```bash
-rm -rf /data/.openclaw/extensions/bereach
-ln -s /data/.openclaw/node_modules/bereach-openclaw /data/.openclaw/extensions/bereach
+rm -rf /data/.openclaw/extensions/bereach-openclaw
+ln -s /data/.openclaw/node_modules/bereach-openclaw /data/.openclaw/extensions/bereach-openclaw
 # then restart the container
 ```
 
 **5. Verify** — compare the two manifests:
 ```bash
-wc -l /data/.openclaw/extensions/bereach/openclaw.plugin.json
+wc -l /data/.openclaw/extensions/bereach-openclaw/openclaw.plugin.json
 wc -l /data/.openclaw/node_modules/bereach-openclaw/openclaw.plugin.json
 ```
 They should match. Per [OpenClaw Plugin Manifest](https://docs.openclaw.ai/plugins/manifest), tools are registered at runtime via `api.registerTool()`.

package/__tests__/helpers.test.ts

@@ -28,19 +28,22 @@ function createMockClient(overrides: Partial<Record<string, Record<string, unkno
   return {
     linkedinScrapers: {
       collectComments: vi.fn(),
-      visitProfile: vi.fn(),
       ...overrides.linkedinScrapers,
     },
+    scrapers: {
+      visitProfile: vi.fn(),
+      ...overrides.scrapers,
+    },
     linkedinActions: {
       listInvitations: vi.fn(),
       ...overrides.linkedinActions,
     },
-    linkedinChat: {
+    chat: {
       findConversation: vi.fn(),
-      ...overrides.linkedinChat,
+      ...overrides.chat,
     },
     campaigns: {
-      syncActions: vi.fn(),
+      sync: vi.fn(),
       getStats: vi.fn(),
       ...overrides.campaigns,
     },
@@ -230,20 +233,62 @@ describe("collectAllComments", () => {
     expect(mock).toHaveBeenCalledWith({ postUrl: "https://post", count: 0 });
   });
 
-  it("fetches when previousTotal differs from current total", async () => {
+  it("fetches from previousTotal offset when total differs", async () => {
     const client = createMockClient();
     const mock = vi.mocked(client.linkedinScrapers.collectComments);
 
     mock
       .mockResolvedValueOnce(commentsPage([], { total: 55, start: 0, hasMore: false }))
       .mockResolvedValueOnce(
-        commentsPage([{ name: "new" }], { total: 55, start: 0, hasMore: false }),
+        commentsPage([{ name: "new1" }, { name: "new2" }], { total: 55, start: 50, hasMore: false }),
       );
 
     const result = await collectAllComments(client, "https://post", "slug", { previousTotal: 50 });
 
     expect(result.skipped).toBe(false);
+    expect(result.profiles).toHaveLength(2);
     expect(mock).toHaveBeenCalledTimes(2);
+    expect(mock).toHaveBeenNthCalledWith(1, { postUrl: "https://post", count: 0 });
+    expect(mock).toHaveBeenNthCalledWith(2, { postUrl: "https://post", start: 50, count: 100, campaignSlug: "slug" });
+  });
+
+  it("fetches only new comments (previousTotal=500, total=513)", async () => {
+    const client = createMockClient();
+    const mock = vi.mocked(client.linkedinScrapers.collectComments);
+
+    const newProfiles = Array.from({ length: 13 }, (_, i) => ({ name: `new${i}` }));
+
+    mock
+      .mockResolvedValueOnce(commentsPage([], { total: 513, start: 0, hasMore: false }))
+      .mockResolvedValueOnce(commentsPage(newProfiles, { total: 513, start: 500, hasMore: false }));
+
+    const result = await collectAllComments(client, "https://post", "slug", { previousTotal: 500 });
+
+    expect(result.profiles).toHaveLength(13);
+    expect(result.total).toBe(513);
+    expect(mock).toHaveBeenCalledTimes(2);
+    expect(mock).toHaveBeenNthCalledWith(2, { postUrl: "https://post", start: 500, count: 100, campaignSlug: "slug" });
+  });
+
+  it("paginates from previousTotal across multiple pages (200→350)", async () => {
+    const client = createMockClient();
+    const mock = vi.mocked(client.linkedinScrapers.collectComments);
+
+    const page1 = Array.from({ length: 100 }, (_, i) => ({ name: `p${200 + i}` }));
+    const page2 = Array.from({ length: 50 }, (_, i) => ({ name: `p${300 + i}` }));
+
+    mock
+      .mockResolvedValueOnce(commentsPage([], { total: 350, start: 0, hasMore: false }))
+      .mockResolvedValueOnce(commentsPage(page1, { total: 350, start: 200, hasMore: true }))
+      .mockResolvedValueOnce(commentsPage(page2, { total: 350, start: 300, hasMore: false }));
+
+    const result = await collectAllComments(client, "https://post", "slug", { previousTotal: 200 });
+
+    expect(result.profiles).toHaveLength(150);
+    expect(result.total).toBe(350);
+    expect(mock).toHaveBeenCalledTimes(3);
+    expect(mock).toHaveBeenNthCalledWith(2, { postUrl: "https://post", start: 200, count: 100, campaignSlug: "slug" });
+    expect(mock).toHaveBeenNthCalledWith(3, { postUrl: "https://post", start: 300, count: 100, campaignSlug: "slug" });
   });
 
   it("handles empty post (0 comments)", async () => {
@@ -344,7 +389,7 @@ describe("listAllInvitations", () => {
 describe("visitProfileIfNeeded", () => {
   it("returns knownDistance without visiting when set", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
 
     const result = await visitProfileIfNeeded(client, "u/alice", "slug", 1);
 
@@ -356,7 +401,7 @@ describe("visitProfileIfNeeded", () => {
 
   it("returns knownDistance=0 without visiting (0 is valid)", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
 
     const result = await visitProfileIfNeeded(client, "u/alice", "slug", 0);
 
@@ -367,7 +412,7 @@ describe("visitProfileIfNeeded", () => {
 
   it("returns knownDistance=2 without visiting", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
 
     const result = await visitProfileIfNeeded(client, "u/alice", "slug", 2);
 
@@ -376,9 +421,9 @@ describe("visitProfileIfNeeded", () => {
     expect(mock).not.toHaveBeenCalled();
   });
 
-  it("calls linkedinScrapers.visitProfile when knownDistance is null", async () => {
+  it("calls scrapers.visitProfile when knownDistance is null", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
     mock.mockResolvedValueOnce({
       success: true,
       firstName: "Alice",
@@ -407,7 +452,7 @@ describe("visitProfileIfNeeded", () => {
 
   it("calls visitProfile when knownDistance is undefined", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
     mock.mockResolvedValueOnce({
       success: true,
       firstName: "Bob",
@@ -432,7 +477,7 @@ describe("visitProfileIfNeeded", () => {
 
   it("handles null memberDistance from visit response", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
     mock.mockResolvedValueOnce({
       success: true,
       firstName: "X",
@@ -456,7 +501,7 @@ describe("visitProfileIfNeeded", () => {
 
   it("propagates FatalError from visitProfile", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinScrapers.visitProfile);
+    const mock = vi.mocked(client.scrapers.visitProfile);
     mock.mockRejectedValueOnce(Object.assign(new Error("unauthorized"), { statusCode: 401 }));
 
     await expect(
@@ -470,7 +515,7 @@ describe("visitProfileIfNeeded", () => {
 describe("findConversationForDmGuard", () => {
   it("returns skip=false when no conversation found", async () => {
     const client = createMockClient();
-    const mock = vi.mocked(client.linkedinChat.findConversation);
+    const mock = vi.mocked(client.chat.findConversation);
     mock.mockResolvedValueOnce({
       success: true,
       found: false,
@@ -488,8 +533,8 @@ describe("findConversationForDmGuard", () => {
 
   it("returns skip=true when resourceLink found in messages", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
-    const syncMock = vi.mocked(client.campaigns.syncActions);
+    const findMock = vi.mocked(client.chat.findConversation);
+    const syncMock = vi.mocked(client.campaigns.sync);
 
     findMock.mockResolvedValueOnce({
       success: true,
@@ -519,7 +564,7 @@ describe("findConversationForDmGuard", () => {
 
   it("returns skip=false when conversation exists but link not in messages", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
+    const findMock = vi.mocked(client.chat.findConversation);
 
     findMock.mockResolvedValueOnce({
       success: true,
@@ -547,7 +592,7 @@ describe("findConversationForDmGuard", () => {
 
   it("returns messages for tone adaptation when no link found", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
+    const findMock = vi.mocked(client.chat.findConversation);
 
     findMock.mockResolvedValueOnce({
       success: true,
@@ -584,7 +629,7 @@ describe("findConversationForDmGuard", () => {
 
   it("returns skip=true (fail-safe) when findConversation throws", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
+    const findMock = vi.mocked(client.chat.findConversation);
     findMock.mockRejectedValueOnce(Object.assign(new Error("network"), { statusCode: 500 }));
 
     const result = await findConversationForDmGuard(client, "u/alice", "https://link", "slug");
@@ -593,10 +638,10 @@ describe("findConversationForDmGuard", () => {
     expect(result.messages).toHaveLength(0);
   });
 
-  it("still returns skip=true when syncActions fails after finding link", async () => {
+  it("still returns skip=true when sync fails after finding link", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
-    const syncMock = vi.mocked(client.campaigns.syncActions);
+    const findMock = vi.mocked(client.chat.findConversation);
+    const syncMock = vi.mocked(client.campaigns.sync);
 
     findMock.mockResolvedValueOnce({
       success: true,
@@ -624,7 +669,7 @@ describe("findConversationForDmGuard", () => {
 
   it("handles conversation found but messages array is null", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
+    const findMock = vi.mocked(client.chat.findConversation);
 
     findMock.mockResolvedValueOnce({
       success: true,
@@ -643,7 +688,7 @@ describe("findConversationForDmGuard", () => {
 
   it("handles conversation found but messages array is empty", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
+    const findMock = vi.mocked(client.chat.findConversation);
 
     findMock.mockResolvedValueOnce({
       success: true,
@@ -662,8 +707,8 @@ describe("findConversationForDmGuard", () => {
 
   it("matches resourceLink as substring in message text", async () => {
     const client = createMockClient();
-    const findMock = vi.mocked(client.linkedinChat.findConversation);
-    const syncMock = vi.mocked(client.campaigns.syncActions);
+    const findMock = vi.mocked(client.chat.findConversation);
+    const syncMock = vi.mocked(client.campaigns.sync);
 
     findMock.mockResolvedValueOnce({
       success: true,

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
-  "id": "bereach",
+  "id": "bereach-openclaw",
   "name": "BeReach",
-  "version": "0.3.4",
+  "version": "1.2.0",
   "description": "LinkedIn outreach automation — 33 tools, auto-reply commands",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "0.3.4",
+  "version": "1.2.0",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "exports": {
@@ -15,7 +15,7 @@
     ]
   },
   "dependencies": {
-    "bereach": "^0.1.4"
+    "bereach": "^1.2.3"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/skills/bereach/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: bereach
-description: "Automate LinkedIn outreach via BeReach (berea.ch). Use when: prospecting, engaging posts, scraping engagement, searching LinkedIn, managing inbox, running campaigns, managing invitations. Requires BEREACH_API_KEY."
-lastUpdatedAt: 1772724697
+description: "Automate LinkedIn outreach via BeReach (berea.ch). Use when: prospecting, engaging posts, scraping engagement, searching LinkedIn, managing inbox, running campaigns, managing invitations, analytics, company pages, Sales Navigator, content engagement, feed monitoring. Requires BEREACH_API_KEY."
+lastUpdatedAt: 1773274027
 metadata: { "openclaw": { "requires": { "env": ["BEREACH_API_KEY"] }, "primaryEnv": "BEREACH_API_KEY" } }
 ---
 
@@ -17,15 +17,19 @@ Automate LinkedIn prospection and engagement via BeReach.
 
 | Sub-skill             | Keywords                                                                                                                  | URL                                                     | lastUpdatedAt |
 | --------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------- |
-| Lead Magnet           | lead magnet, comment to DM, resource delivery, post giveaway, auto-accept invitations, scheduled run, recap, campaign stats, pause | sub/lead-magnet.md       | 1772724697    |
-| OpenClaw Optimization | openclaw, model, opus, sonnet, haiku, config, SOUL.md, heartbeat, prompt caching, AI cost reduction, /model               | openclaw-optimization.md | 1772619338    |
-| SDK Reference         | sdk, method, parameter, signature, reference, api, script                                                                 | sdk-reference.md         | 1772672714             |
+| Lead Magnet           | lead magnet, comment to DM, resource delivery, post giveaway, auto-accept invitations, scheduled run, recap, campaign stats, pause | sub/lead-magnet.md       | 1773267546    |
+| Lead Gen              | lead gen, find leads, search, qualify, ICP, pipeline, build list, scrape engagement, competitor, grow database, prospecting, hashtag, Sales Navigator         | sub/lead-gen.md          | 1773269560    |
+| Outreach              | outreach, connect, DM, message, follow up, sequence, connection request, reply, personalized outreach, campaign outreach, warming, follow, like post           | sub/outreach.md          | 1773269560    |
+| OpenClaw Optimization | openclaw, model, opus, sonnet, haiku, config, SOUL.md, heartbeat, prompt caching, AI cost reduction, /model               | openclaw-optimization.md | 1773274027    |
+| SDK Reference         | sdk, method, parameter, signature, reference, api, script                                                                 | sdk-reference.md         | 1773269560    |
 
 ### Supporting files
 
 Load these when the user's request matches the keywords above:
 
 - For lead magnet campaigns (comment-to-DM, resource delivery, scheduled runs), see [Lead Magnet](sub/lead-magnet.md)
+- For autonomous lead generation (find leads, qualify, grow database), see [Lead Gen](sub/lead-gen.md)
+- For personalized outreach (connect, DM, follow up, adapt), see [Outreach](sub/outreach.md)
 - For SDK method signatures and parameters when writing scripts, see [SDK Reference](sdk-reference.md)
 
 ## Installation
@@ -67,8 +71,18 @@ The SDK auto-reads `BEREACH_API_KEY` from the environment. NEVER hardcode tokens
 
 1. **Token** — read `BEREACH_API_KEY` from environment with no default/fallback value. If not set, stop immediately.
 2. **Read all sub-skills** — fetch every sub-skill listed above.
-3. **Profile + language** — call `getLinkedInProfile` (tool or `client.profile.getLinkedInProfile()`). Profile inputs: URL (e.g. `https://linkedin.com/in/username`) or URN (`urn:li:fsd_profile:ACoAA...`). Detect user's language from profile (location, headline, posts). This becomes the default language for all generated content. Per prospect, adapt if their profile clearly indicates a different language.
-4. **Welcome** — personalized welcome using profile data. Suggest a first action based on their profile.
+3. **Context acquisition** — build a rich picture of the user before any workflow. This context feeds all sub-skills and makes the agent smarter from the start.
+   - **Profile + language** — `getLinkedInProfile` (0 credits). Detect language from location, headline, posts. This becomes the default for all generated content.
+   - **Recent posts** — `getPosts({ count: 10 })` (0 credits). What topics resonate, tone, offer, engagement patterns.
+   - **Followers** — `getFollowers({ count: 50 })` (1 credit/page). Reveals audience type; followers are warm leads already.
+   - **Website** — if the profile contains a website URL, fetch and extract: what they sell, who they target, positioning.
+   - **Documents/data** — if the user has provided files (ICP docs, prospect lists, CRM exports, target account lists), read them. No format requirement.
+   - **Existing campaigns** — `getStats` per known campaign (0 credits). What's running, what worked, conversions.
+   - **Lead-gen state** — `contacts.listCampaigns({ type: "lead_gen" })` (0 credits) to see existing lead-gen campaigns. `agentState.get("lead-gen")` (0 credits) to load previous state (angles, watchlist, learning data). If state exists, the agent resumes where it left off.
+   - **Analytics** — `linkedinAnalytics.getFollowerAnalytics()` (1 credit). Follower demographics and growth trends. `linkedinAnalytics.getProfileViews()` (1 credit). Who's viewing the profile — warm leads.
+   - **Company pages** — `companyPages.list()` (1 credit). If the user administers company pages, discover them for company-level posting and analytics.
+   - **Competitors** — infer from industry, profile, and posts. Note competitor names and profile URLs for the engagement watchlist.
+4. **Welcome** — personalized welcome using profile data and context. Suggest a first action based on their profile, posts, and industry.
 
 ## Rules
 
@@ -81,11 +95,13 @@ The SDK auto-reads `BEREACH_API_KEY` from the environment. NEVER hardcode tokens
 
 - Lead magnet scripts use the SDK. Tools are for interactive agent use only.
 - Import from the `bereach` SDK exclusively. If a method doesn't exist, the operation doesn't exist.
-- Scripts MUST be TypeScript (`.ts`). Load the [SDK Reference](sdk-reference.md) sub-skill for method signatures.
+- Scripts MUST be TypeScript (`.ts`). Load the [SDK Reference](sdk-reference.md) sub-skill for method signatures and type imports.
+- NEVER use `any` or untyped variables. Import types from `bereach/models/operations` (see SDK Reference "Types" section). Using `any` defeats TypeScript — bugs like `msg.body` vs `msg.text` become invisible to the compiler.
+- tsconfig.json must include `"strict": true` and `"skipLibCheck": true`. `strict` enables `noImplicitAny` so TypeScript rejects untyped code. `skipLibCheck` ignores type errors inside `node_modules` (expected for published packages).
 
 **Mandatory validation loop** — after generating or editing any script:
 
-1. **Step 1 (blocking)** — Run `npx tsc --noEmit` in the script directory. It MUST exit 0. If type errors: fix them using the SDK Reference, then repeat. Do NOT run tsx until tsc passes.
+1. **Step 1 (blocking)** — Run `npx tsc --noEmit` in the script directory. It MUST exit 0. If type errors: fix them using the SDK Reference, then repeat. Do NOT run tsx until tsc passes. This check is only meaningful when real types are used — with `any` everywhere, `tsc` validates nothing.
 2. **Step 2** — Run `npx tsx <script-name>.ts`. Fix runtime errors (e.g. "visitProfile is not a function"). If config missing, run with minimal env to reach first SDK call.
 3. **Both must succeed** — tsx passing alone is NOT sufficient. Do not consider the script ready until BOTH tsc and tsx succeed.
 
@@ -99,12 +115,19 @@ The SDK auto-reads `BEREACH_API_KEY` from the environment. NEVER hardcode tokens
 
 | Resource | Methods |
 | --- | --- |
-| `client.linkedinScrapers` | `collectLikes`, `collectComments`, `collectCommentReplies`, `collectPosts`, `visitProfile`, `visitCompany` |
-| `client.linkedinActions` | `connectProfile`, `listInvitations`, `acceptInvitation`, `sendMessage`, `replyToComment`, `likeComment`, `publishPost` |
-| `client.linkedinChat` | `listConversations`, `searchConversations`, `findConversation`, `getMessages` |
+| `client.linkedinScrapers` | `collectLikes`, `collectComments`, `collectCommentReplies`, `collectPosts`, `visitProfile`, `visitCompany`, `collectHashtagPosts`, `collectSavedPosts` |
+| `client.linkedinActions` | `connectProfile`, `listInvitations`, `acceptInvitation`, `sendMessage`, `replyToComment`, `likeComment`, `publishPost`, `commentOnPost`, `likePost`, `unlikePost`, `unlikeComment`, `editComment`, `editPost`, `repostPost`, `savePost`, `unsavePost`, `followProfile`, `unfollowProfile`, `followCompany`, `unfollowCompany`, `declineInvitation`, `withdrawInvitation`, `listSentInvitations` |
+| `client.linkedinChat` | `listConversations`, `searchConversations`, `findConversation`, `getMessages`, `archiveConversation`, `unarchiveConversation`, `starConversation`, `unstarConversation`, `listArchivedConversations`, `listStarredConversations`, `markAllRead`, `markSeen`, `reactToMessage`, `unreactToMessage`, `getUnreadCount`, `sendTypingIndicator` |
 | `client.linkedinSearch` | `unifiedSearch`, `searchPosts`, `searchPeople`, `searchCompanies`, `searchJobs`, `searchByUrl`, `resolveParameters` |
-| `client.profile` | `getLinkedInProfile`, `refresh`, `getPosts`, `getFollowers`, `getLimits`, `getCredits` |
+| `client.profile` | `getLinkedInProfile`, `refresh`, `getPosts`, `getFollowers`, `getLimits`, `getCredits`, `listAccounts`, `updateAccount`, `getActivity`, `revalidate` |
 | `client.campaigns` | `getStatus`, `syncActions`, `getStats` |
+| `client.contacts` | `createCampaign`, `listCampaigns`, `addContacts`, `listContacts`, `updateContact`, `searchContacts`, `getStats`, `logActivity`, `getActivities` |
+| `client.linkedinAnalytics` | `getFollowerAnalytics`, `getPostAnalytics`, `getProfileViews`, `getSearchAppearances` |
+| `client.linkedinFeed` | `getFeed` |
+| `client.salesNavigator` | `search`, `searchPeople`, `searchCompanies` |
+| `client.companyPages` | `list`, `getAnalytics`, `getPermissions`, `getPosts` |
+| `client.settings` | `getDmPolling`, `updateDmPolling` |
+| `client.agentState` | `get`, `set` |
 
 ## Tone
 
@@ -115,7 +138,7 @@ Adapt to user's tone from their posts and messages. Comment replies: 3-5 words,
 These are technical constraints BeReach requires. Everything else, adapt as needed.
 
 1. **Dedup** — pass `campaignSlug` on every action. BeReach deduplicates by target automatically. Duplicates return `duplicate: true` and cost nothing. Pre-check: use `client.campaigns.getStatus()` or the `getStatus` tool.
-2. **Pacing** — after every SDK/tool call, sleep a random delay. Write actions (DM, reply, like, connect, accept, sync): `random delay 8-12s`. Read actions (visit, scrape, find, count-0 checks): `random delay 2-6s`. On 429: wait the number of seconds from the error response, retry (max 3). If daily/weekly cap hit, switch action type.
+2. **Pacing** — after every SDK/tool call, sleep a random delay. Write actions (DM, reply, like, comment, connect, accept, follow, repost, edit, sync): `random delay 8-12s`. Read actions (visit, scrape, search, find, feed, analytics, count-0 checks): `random delay 2-6s`. Inbox management (archive, star, mark-read, react, typing): `random delay 1-3s`. On 429: wait the number of seconds from the error response, retry (max 3). If daily/weekly cap hit, switch action type.
 3. **Save incrementally** — persist tracking after each action, not at the end.
 4. **Limits check** — call `getLimits` once per day at session start.
 5. **Visit before connecting** — looks natural to LinkedIn.
@@ -136,8 +159,8 @@ These are technical constraints BeReach requires. Everything else, adapt as need
 Each workflow is detailed in its sub-skill. Load the relevant sub-skill when needed.
 
 - **Lead Magnet** — deliver a resource to everyone who engages with a post (comments, likes, invitations). Multi-campaign config at `~/.bereach/lead-magnet.json`. → Lead Magnet sub-skill
-
-More workflows coming soon. You can build your own using the SDK methods and tools listed above.
+- **Lead Gen** — autonomous lead generation. Find and qualify leads daily through multi-angle search, engagement scraping, and a learning loop. BeReach campaigns as the contacts DB. State at `~/.bereach/lead-gen-state.json`. → Lead Gen sub-skill
+- **Outreach** — personalized LinkedIn outreach. Connect, message, follow up, adapt. Uses emergent planning (no DAG workflows). State via `agentState.get("outreach")`. → Outreach sub-skill
 
 ### Cron
 
@@ -151,7 +174,19 @@ Crons are OpenClaw scheduled tasks. Create entries in `~/.openclaw/cron/jobs.jso
 { "id": "lm-connections", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-connections.ts and report recap" }
 ```
 
-Always use `"sessionTarget": "spawn"` for crons that execute scripts. This spawns a sub-agent in an isolated session — the script runs independently and pushes results back to the user when done, without blocking the main session. Never use `exec()` directly from a cron prompt; it blocks until the script finishes.
+**Lead Gen** — 1 daily cron. The spawned agent uses tools directly (no pre-generated script):
+
+```json
+{ "id": "lead-gen", "every": "1d", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run daily lead gen using sub/lead-gen.md playbook. Load state via agentState.get('lead-gen'), run priority channels, qualify, store, report recap." }
+```
+
+**Outreach** — 1 daily cron. Uses emergent planning (no workflows):
+
+```json
+{ "id": "outreach", "every": "1d", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run daily outreach using sub/outreach.md playbook. Load state via agentState.get('outreach'). Process replies first, then accepted connections, then follow-ups, then new connections. Respect daily limits. Update state and recap." }
+```
+
+Always use `"sessionTarget": "spawn"` for crons that execute scripts or tool-based workflows. This spawns a sub-agent in an isolated session — it runs independently and pushes results back to the user when done, without blocking the main session. Never use `exec()` directly from a cron prompt; it blocks until the script finishes.
 
 **Update check** — detect-only, never auto-upgrade:
 

package/skills/bereach/openclaw-optimization.md

@@ -1,7 +1,7 @@
 ---
 name: openclaw-optimization
 description: "Optimize OpenClaw for cost efficiency with Anthropic Claude. Use when: reducing AI costs, configuring model routing, configuring heartbeat, optimizing workspace files."
-lastUpdatedAt: 1772619338
+lastUpdatedAt: 1773274027
 ---
 
 # OpenClaw Optimization
@@ -48,17 +48,6 @@ If you forget step 3, every subsequent message costs 5x more for no benefit. The
 
 Create these in `~/.openclaw/workspace/`. Keep them lean — every token is sent on every request.
 
-### HEARTBEAT.md
-
-OpenClaw reads this file on every heartbeat. If nothing needs attention, the agent replies `HEARTBEAT_OK` and the message is suppressed.
-
-```markdown
-# Heartbeat checklist
-
-- Check BeReach campaigns: new comments to process, pending connections to accept, messages to send.
-- Only report if there's something actionable.
-```
-
 ### SOUL.md
 
 ```markdown