bereach-openclaw 0.2.13 → 0.2.15

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "bereach",
   "name": "BeReach",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "LinkedIn outreach automation — 33 tools, auto-reply commands",
   "configSchema": {
     "type": "object",
@@ -10,6 +10,7 @@
       "BEREACH_API_KEY": {
         "type": "string",
         "minLength": 1,
+        "pattern": "^brc_",
         "description": "BeReach API token (starts with brc_)"
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "scripts": {

package/skills/bereach/SKILL.md

@@ -1,7 +1,8 @@
 ---
 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: 1772619338
+lastUpdatedAt: 1772673508
+metadata: { "openclaw": { "requires": { "env": ["BEREACH_API_KEY"] }, "primaryEnv": "BEREACH_API_KEY" } }
 ---
 
 # BeReach — LinkedIn Outreach Automation
@@ -16,9 +17,16 @@ 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, cron, recap, campaign stats, pause | sub/lead-magnet.md       | 1772619338    |
+| Lead Magnet           | lead magnet, comment to DM, resource delivery, post giveaway, auto-accept invitations, scheduled run, recap, campaign stats, pause | sub/lead-magnet.md       | 1772673508    |
 | 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         | 1772619338             |
+| SDK Reference         | sdk, method, parameter, signature, reference, api, script                                                                 | sdk-reference.md         | 1772672714             |
+
+### 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 SDK method signatures and parameters when writing scripts, see [SDK Reference](sdk-reference.md)
 
 ## Installation
 
@@ -28,7 +36,7 @@ Tools are already configured by the plugin — no manual setup needed.
 
 ### SDK (script generation)
 
-The TypeScript SDK provides typed methods for all BeReach operations. Use it when generating scripts (cron jobs, batch automations).
+The TypeScript SDK provides typed methods for all BeReach operations. Use it when generating scripts (scheduled automations, batch jobs).
 
 ```bash
 npm add bereach
@@ -47,6 +55,14 @@ const client = new Bereach({ token });
 
 The SDK auto-reads `BEREACH_API_KEY` from the environment. NEVER hardcode tokens in scripts.
 
+
+
+1. `GET SKILL.md` → compare frontmatter `lastUpdatedAt` with local copy
+2. If remote > local: re-download main skill, replace local copy
+3. Compare sub-skill `lastUpdatedAt` values — re-fetch any that changed
+4. Log: "BeReach skill updated" or "BeReach skill is up to date"
+5. Never skip this check
+
 ## Onboarding
 
 1. **Token** — read `BEREACH_API_KEY` from environment with no default/fallback value. If not set, stop immediately.
@@ -63,6 +79,7 @@ The SDK auto-reads `BEREACH_API_KEY` from the environment. NEVER hardcode tokens
 
 ### Script mode (SDK)
 
+- 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`). Run with `npx tsx script.ts`.
 - Run `npx tsc --noEmit` before executing to catch type errors.
@@ -114,24 +131,30 @@ 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). → Lead Magnet sub-skill
+- **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.
 
 ### Cron
 
-Crons are OpenClaw scheduled tasks. Create entries in `~/.openclaw/crons.json`:
+Crons are OpenClaw scheduled tasks. Create entries in `~/.openclaw/cron/jobs.json` (via `openclaw cron add`).
+
+**Lead Magnet** — 3 global crons. Config at `~/.openclaw/lead-magnet.json`. Each cron runs one script that loops over all enabled campaigns:
 
 ```json
-{
-  "id": "bereach-{workflow}",
-  "every": "30m",
-  "skill": "bereach",
-  "sessionTarget": "spawn",
-  "prompt": "Run {workflow} script and report results"
-}
+{ "id": "lm-comments", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-comments.ts and report recap" }
+{ "id": "lm-invitations", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-invitations.ts and report recap" }
+{ "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.
 
+**Update check** — detect-only, never auto-upgrade:
+
+```json
+{ "id": "bereach-update-check", "every": "1d", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Check if a new BeReach plugin version is available. Compare local version from package.json with `npm view bereach-openclaw version`. If newer: notify user once: 'BeReach vX.Y.Z is available (current: vA.B.C). Say upgrade bereach when ready.' Do NOT upgrade automatically." }
+```
+
+When the user says "upgrade bereach": follow the upgrade workflow in `upgrade-openclaw-bereach.md` — save user state, uninstall, reinstall, recreate scripts from new skill, wait for user confirmation before launching crons.
+
 Remove with `openclaw cron remove <id>`.

package/skills/bereach/sdk-reference.md

@@ -1,13 +1,13 @@
 ---
 name: bereach-sdk-reference
 description: "Complete SDK method reference — parameters, types, and descriptions for all BeReach operations."
-lastUpdatedAt: 1772619338
+lastUpdatedAt: 1772672714
 ---
 
 # BeReach SDK Reference
 
 > Auto-generated from OpenAPI spec. This is the single source of truth for SDK method signatures.
-> Use `client.<resource>.<method>(params)` — see [BeReach Skill](bereach-skill.md) for behavioral rules.
+> Use `client.<resource>.<method>(params)` — see [BeReach Skill](SKILL.md) for behavioral rules.
 
 ## linkedinScrapers
 
@@ -21,6 +21,17 @@ Scrape LinkedIn post likes. Returns paginated list of profiles who liked a post.
 - **start** (integer, min 0) — Pagination offset (multiples of 200).
 - **count** (integer, 0-200) — Number of likes to fetch per page (0-200, default 200). Use count=0 for a free total-only check.
 
+**Returns:**
+
+- **profiles** (array)
+- **count** (number)
+- **total** (number)
+- **start** (number)
+- **hasMore** (boolean)
+- **previousTotal** (number | null) — The total from your last call to this endpoint for the same post (null on first call). Compare with total to detect new likes without client-side tracking.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### collectComments
 
 Scrape LinkedIn post comments. Returns paginated list of commenters with comment text and URNs.
@@ -32,6 +43,19 @@ Scrape LinkedIn post comments. Returns paginated list of commenters with comment
 - **count** (integer, 0-100) — Number of comments to fetch per page (0-100, default 100). Use count=0 for a free total-only check.
 - **campaignSlug** (string) — When provided, each profile includes actionsCompleted and knownDistance for campaign-aware scraping.
 
+**Returns:**
+
+- **profiles** (array)
+- **count** (number)
+- **total** (number)
+- **start** (number)
+- **hasMore** (boolean)
+- **previousTotal** (number | null) — The total from your last call to this endpoint for the same post (null on first call). Compare with total to detect new comments without client-side tracking.
+- **processedCount** (number, optional) — Number of returned profiles that already have a completed 'message' action in this campaign. Only present when campaignSlug is provided.
+- **newCount** (number, optional) — Number of returned profiles that have NOT yet been messaged in this campaign. Only present when campaignSlug is provided.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### collectCommentReplies
 
 Scrape replies to a LinkedIn comment. Returns paginated replies for a specific comment URN.
@@ -42,6 +66,18 @@ Scrape replies to a LinkedIn comment. Returns paginated replies for a specific c
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 0-100) — Number of replies to fetch per page (0-100, default 100). Use count=0 for a free total-only check.
 
+**Returns:**
+
+- **replies** (array)
+- **count** (number)
+- **total** (number)
+- **start** (number)
+- **hasMore** (boolean)
+- **parentCommentUrn** (string)
+- **previousTotal** (number | null) — The total from your last call to this endpoint for the same comment (null on first call). Compare with total to detect new replies without client-side tracking.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### collectPosts
 
 Scrape LinkedIn profile posts. Returns paginated list of posts from a profile.
@@ -53,6 +89,18 @@ Scrape LinkedIn profile posts. Returns paginated list of posts from a profile.
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **paginationToken** (string) — Pagination token from a previous response to fetch the next page.
 
+**Returns:**
+
+- **posts** (array)
+- **count** (number)
+- **total** (number)
+- **start** (number)
+- **hasMore** (boolean)
+- **paginationToken** (string | null)
+- **previousTotal** (number | null) — The total from your last call to this endpoint for the same profile (null on first call). Compare with total to detect new posts without client-side tracking.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### visitProfile
 
 Visit LinkedIn profile and extract contact data. Distance-1 profiles cached 24h. No dedup — always executes.
@@ -63,6 +111,28 @@ Visit LinkedIn profile and extract contact data. Distance-1 profiles cached 24h.
 - **campaignSlug** (string) — Optional campaign identifier for tracking only. No dedup — visit always executes.
 - **includePosts** (boolean) — When true, fetches the last 5 posts from the profile. Defaults to false.
 
+**Returns:**
+
+- **firstName** (string)
+- **lastName** (string)
+- **headline** (string | null)
+- **publicIdentifier** (string)
+- **profileUrl** (string)
+- **profileUrn** (string, optional) — LinkedIn profile URN (e.g. 'urn:li:fsd_profile:ACoAAA...'). Use this for matching against inbox participants.
+- **imageUrl** (string | null)
+- **email** (string | null, optional)
+- **location** (string | null, optional)
+- **company** (string | null, optional) — Current company name (from most recent position)
+- **position** (string | null, optional) — Current job title (from most recent position)
+- **memberDistance** (number | null, optional)
+- **pendingConnection** (string)
+- **positions** (array, optional) — Work experience positions
+- **educations** (array, optional) — Education entries
+- **lastPosts** (array, optional) — Last 5 posts from the profile (only present when includePosts is true)
+- **cached** (boolean) — true if this result was served from cache (0 credits). Distance-1 profiles are cached for 24h.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### visitCompany
 
 Visit LinkedIn company page and extract profile data including description, industry, employee count, headquarters, and more.
@@ -72,6 +142,34 @@ Visit LinkedIn company page and extract profile data including description, indu
 - **companyUrl** (string, required) — LinkedIn company URL (e.g., 'https://www.linkedin.com/company/openai') or universal name (e.g., 'openai').
 - **includeWorkplacePolicy** (boolean) — Include workplace policy data such as hybrid/remote status and benefits. Costs 1 extra credit.
 
+**Returns:**
+
+- **id** (string) — LinkedIn numeric company ID
+- **universalName** (string) — Company URL slug
+- **name** (string)
+- **description** (string | null)
+- **url** (string) — LinkedIn company page URL
+- **websiteUrl** (string | null) — External website URL
+- **industry** (string | null)
+- **employeeCount** (number | null) — Exact employee count on LinkedIn
+- **employeeCountRange** (object)
+- **end** (number | null) — Employee count range
+- **logoUrl** (string | null)
+- **coverImageUrl** (string | null)
+- **followerCount** (number | null)
+- **specialities** (array)
+- **tagline** (string | null)
+- **isVerified** (boolean)
+- **foundedOn** (object | null)
+- **phone** (string | null)
+- **callToAction** (object)
+- **url** (string | null)
+- **hashtags** (array)
+- **affiliatedCompanies** (array) — Showcase / affiliated pages
+- **similarCompanies** (array) — Similar companies suggested by LinkedIn
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ## linkedinSearch
 
 ### unifiedSearch
@@ -106,6 +204,13 @@ Unified LinkedIn Search — search posts, people, companies, or jobs with a sing
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-50) — Results per page (default 10, max 50).
 
+**Returns:**
+
+- **items** (unknown)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### searchPosts
 
 Search LinkedIn posts by keywords with optional filters for date, content type, author industry, and author company.
@@ -122,6 +227,13 @@ Search LinkedIn posts by keywords with optional filters for date, content type,
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-50) — Results per page (default 10, max 50).
 
+**Returns:**
+
+- **items** (unknown)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### searchPeople
 
 Search LinkedIn people by keywords, connection degree, name, title, location, industry, company, and school.
@@ -144,6 +256,13 @@ Search LinkedIn people by keywords, connection degree, name, title, location, in
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-50) — Results per page (default 10, max 50).
 
+**Returns:**
+
+- **items** (unknown)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### searchCompanies
 
 Search LinkedIn companies by keywords, location, industry, and company size.
@@ -158,6 +277,13 @@ Search LinkedIn companies by keywords, location, industry, and company size.
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-50) — Results per page (default 10, max 50).
 
+**Returns:**
+
+- **items** (unknown)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### searchJobs
 
 Search LinkedIn jobs by keywords, location, job type, experience level, and workplace type.
@@ -175,6 +301,13 @@ Search LinkedIn jobs by keywords, location, job type, experience level, and work
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-50) — Results per page (default 10, max 50).
 
+**Returns:**
+
+- **items** (unknown)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### searchByUrl
 
 Search LinkedIn by URL. Automatically extracts category, keywords, and filters from a LinkedIn search URL.
@@ -185,6 +318,13 @@ Search LinkedIn by URL. Automatically extracts category, keywords, and filters f
 - **start** (integer, min 0) — Override pagination offset.
 - **count** (integer, 1-50) — Override results per page (default 10, max 50).
 
+**Returns:**
+
+- **items** (unknown)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### resolveParameters
 
 Resolve text to LinkedIn search parameter IDs (typeahead). Prerequisite for using location, industry, company, or school filters.
@@ -195,6 +335,13 @@ Resolve text to LinkedIn search parameter IDs (typeahead). Prerequisite for usin
 - **keywords** (string, required) — Text to resolve into LinkedIn IDs.
 - **limit** (integer, 1-50) — Max results (default 10, max 50).
 
+**Returns:**
+
+- **items** (array)
+- **count** (number)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ## linkedinActions
 
 ### connectProfile
@@ -206,6 +353,13 @@ Send LinkedIn connection request. Deduplicates by profile within a campaign.
 - **profile** (string, required) — LinkedIn profile URL or profile URN.
 - **campaignSlug** (string) — Campaign identifier for deduplication.
 
+**Returns:**
+
+- **message** (string)
+- **duplicate** (boolean, optional) — True if a connection request was already successfully sent to this profile this week
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### listInvitations
 
 List received LinkedIn connection invitations. Returns pending invitations with IDs needed to accept them.
@@ -215,6 +369,15 @@ List received LinkedIn connection invitations. Returns pending invitations with
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-100) — Number of invitations to return (default 10, max 100).
 
+**Returns:**
+
+- **invitations** (array)
+- **total** (number) — Total number of pending invitations
+- **start** (number)
+- **count** (number)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### acceptInvitation
 
 Accept a LinkedIn connection invitation. Requires invitationId and sharedSecret from the list invitations endpoint.
@@ -227,6 +390,12 @@ Accept a LinkedIn connection invitation. Requires invitationId and sharedSecret
 - **firstName** (string) — Sender's first name. Recommended for reliability.
 - **lastName** (string) — Sender's last name. Recommended for reliability.
 
+**Returns:**
+
+- **message** (string)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### sendMessage
 
 Send LinkedIn message. Rate limited to 80 messages per day.
@@ -237,6 +406,13 @@ Send LinkedIn message. Rate limited to 80 messages per day.
 - **message** (string, required) — Message content to send.
 - **campaignSlug** (string) — Campaign identifier for deduplication.
 
+**Returns:**
+
+- **messageId** (string)
+- **duplicate** (boolean, optional) — True if this action was already executed for the given campaignSlug + target.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### replyToComment
 
 Reply to a LinkedIn comment. Use the commentUrn from the comments endpoint directly.
@@ -247,6 +423,13 @@ Reply to a LinkedIn comment. Use the commentUrn from the comments endpoint direc
 - **message** (string, required) — Reply message text.
 - **campaignSlug** (string) — Campaign identifier for deduplication.
 
+**Returns:**
+
+- **replyUrn** (string, optional) — URN of the created reply comment
+- **duplicate** (boolean, optional) — True if this action was already executed for the given campaignSlug + target.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### likeComment
 
 Like (react to) a LinkedIn comment. Use the commentUrn from the comments endpoint directly.
@@ -257,6 +440,13 @@ Like (react to) a LinkedIn comment. Use the commentUrn from the comments endpoin
 - **reactionType** (string) — Reaction type (default: LIKE). Values: LIKE, LOVE, CELEBRATE, SUPPORT, FUNNY, INSIGHTFUL.
 - **campaignSlug** (string) — Campaign identifier for deduplication.
 
+**Returns:**
+
+- **resourceKey** (string, optional) — Resource key of the created reaction
+- **duplicate** (boolean, optional) — True if this action was already executed for the given campaignSlug + target.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### publishPost
 
 Publish or schedule a LinkedIn post. Supports text, images, mentions, and visibility control.
@@ -271,6 +461,14 @@ Publish or schedule a LinkedIn post. Supports text, images, mentions, and visibi
 - **mentions** (object[]) — Profile mentions with text positions.
 - **campaignSlug** (string) — Campaign identifier for deduplication.
 
+**Returns:**
+
+- **shareUrn** (string)
+- **activityUrn** (string | null) — Activity URN (only available for instant mode)
+- **duplicate** (boolean, optional) — True if this action was already executed for the given campaignSlug + target.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ## linkedinChat
 
 ### listConversations
@@ -281,6 +479,13 @@ List LinkedIn inbox conversations with participants, last message, and read stat
 
 - **nextCursor** (string) — Pagination cursor from a previous response.
 
+**Returns:**
+
+- **conversations** (array)
+- **nextCursor** (string | null) — Cursor for fetching next page
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### searchConversations
 
 Search LinkedIn inbox conversations by keyword. 0 credits.
@@ -290,6 +495,13 @@ Search LinkedIn inbox conversations by keyword. 0 credits.
 - **keywords** (string, required) — Search keywords.
 - **nextCursor** (string) — Pagination cursor from a previous response.
 
+**Returns:**
+
+- **conversations** (array)
+- **nextCursor** (string | null) — Cursor for fetching next page
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### findConversation
 
 Find a conversation with a specific person. Direct O(1) lookup via LinkedIn's compose API. 0 credits.
@@ -299,6 +511,13 @@ Find a conversation with a specific person. Direct O(1) lookup via LinkedIn's co
 - **profile** (string, required) — Profile URL or URN for direct conversation lookup.
 - **includeMessages** (boolean) — If true, also return the conversation's recent messages (0 extra credits). Default: false.
 
+**Returns:**
+
+- **found** (boolean)
+- **messages** (array | null)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### getMessages
 
 Read messages from a LinkedIn conversation. 0 credits.
@@ -308,6 +527,13 @@ Read messages from a LinkedIn conversation. 0 credits.
 - **conversationUrn** (string, required) — Full conversation URN as returned by list/search conversations.
 - **deliveredAt** (integer) — Timestamp (ms) of the oldest message from previous page — pass this to load older messages.
 
+**Returns:**
+
+- **messages** (array)
+- **prevCursor** (number | null) — deliveredAt timestamp (ms) of the oldest message — pass as 'deliveredAt' to load older messages. Null when no more messages.
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ## profile
 
 ### getLinkedInProfile
@@ -318,6 +544,11 @@ Get authenticated user's LinkedIn profile from the database. No LinkedIn API cal
 
 No parameters.
 
+**Returns:**
+
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### refresh
 
 Refresh authenticated user's LinkedIn profile by fetching latest data from LinkedIn.
@@ -326,6 +557,12 @@ Refresh authenticated user's LinkedIn profile by fetching latest data from Linke
 
 No parameters.
 
+**Returns:**
+
+- **refreshed** (true)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### getPosts
 
 Get authenticated user's LinkedIn posts.
@@ -336,6 +573,17 @@ Get authenticated user's LinkedIn posts.
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **paginationToken** (string) — Pagination token from a previous response.
 
+**Returns:**
+
+- **posts** (array)
+- **count** (number)
+- **total** (number)
+- **start** (number)
+- **hasMore** (boolean)
+- **paginationToken** (string | null)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### getFollowers
 
 Get authenticated user's LinkedIn followers.
@@ -345,6 +593,16 @@ Get authenticated user's LinkedIn followers.
 - **start** (integer, min 0) — Pagination offset (default 0).
 - **count** (integer, 1-50) — Number of followers to fetch per page (default 10, max 50).
 
+**Returns:**
+
+- **followers** (array)
+- **count** (number)
+- **totalFollowers** (number)
+- **start** (number)
+- **hasMore** (boolean)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### getLimits
 
 Get current LinkedIn rate limit status for all action types. 0 credits.
@@ -353,6 +611,13 @@ Get current LinkedIn rate limit status for all action types. 0 credits.
 
 No parameters.
 
+**Returns:**
+
+- **multiplier** (number) — Workspace limit multiplier applied to all base limits (default 1.0)
+- **limits** (object)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### getCredits
 
 Get current BeReach credit balance including used, remaining, and percentage. 0 credits.
@@ -361,6 +626,16 @@ Get current BeReach credit balance including used, remaining, and percentage. 0
 
 No parameters.
 
+**Returns:**
+
+- **credits** (object)
+- **current** (number) — Number of credits used in the current billing period
+- **limit** (number) — Maximum credits available for the workspace
+- **remaining** (number) — Credits remaining before hitting the limit
+- **percentage** (number)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ## campaigns
 
 ### getStatus
@@ -372,6 +647,12 @@ Query per-profile action status within a campaign. Returns which actions have be
 - **campaignSlug** (string, required) — Campaign identifier.
 - **profiles** (string[], required) — LinkedIn profile URLs or URNs to check status for.
 
+**Returns:**
+
+- **profiles** (array)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### syncActions
 
 Mark actions as completed without performing them on LinkedIn. Use when actions were performed outside the API. 0 credits.
@@ -381,6 +662,12 @@ Mark actions as completed without performing them on LinkedIn. Use when actions
 - **campaignSlug** (string, required) — Campaign identifier.
 - **profiles** (object[], required) — Profiles and actions to mark as completed. Values: message, reply, like, visit, connect.
 
+**Returns:**
+
+- **synced** (array)
+- **creditsUsed** (number) — Credits consumed by this call.
+- **retryAfter** (number) — Seconds to wait before next call.
+
 ### getStats
 
 Get aggregate campaign statistics: per-action counts, unique profiles, and total credits used. 0 credits.
@@ -388,3 +675,10 @@ Get aggregate campaign statistics: per-action counts, unique profiles, and total
 `client.campaigns.getStats(params)`
 
 - **campaignSlug** (string, required) — Campaign identifier.
+
+**Returns:**
+
+- **stats** (Record<string, …>)
+- **totalProfiles** (number) — Unique profiles processed in this campaign
+- **creditsUsed** (number) — Total credits consumed by this campaign (sum of action counts). Also serves as the per-call creditsUsed (always 0 for this endpoint).
+- **retryAfter** (number) — Seconds to wait before next call of the same type (always 0 for campaign queries).

package/skills/bereach/sub/lead-magnet.md

@@ -1,16 +1,16 @@
 ---
 name: bereach-lead-magnet
 description: "Lead magnet workflow — deliver a resource to everyone who engages with a LinkedIn post."
-lastUpdatedAt: 1772619338
+lastUpdatedAt: 1772673508
 ---
 
 # BeReach Lead Magnet Skill
 
-> Sub-skill of [BeReach](bereach-skill.md). Deliver a resource to everyone who engages with a LinkedIn post.
+> Sub-skill of [BeReach](SKILL.md). Deliver a resource to everyone who engages with a LinkedIn post.
 
 ## Prerequisites
 
-Requires [BeReach SKILL.md](bereach-skill.md) (constraints, SDK setup, anti-hallucination rules) and [SDK Reference](sdk-reference.md) for method signatures and parameters. Do NOT generate code without both loaded.
+Requires [BeReach SKILL.md](SKILL.md) (constraints, SDK setup, anti-hallucination rules) and [SDK Reference](sdk-reference.md) for method signatures and parameters. Do NOT generate code without both loaded.
 
 ## Script generation rules
 
@@ -22,28 +22,64 @@ All script output and chatbot messages are **for the end user**. Write like you'
 
 ## Objective
 
-**Every person who engages with the post must receive the resource via DM as soon as they are distance 1.** Comment, like, invitation — the channel doesn't matter. The person gets the resource the moment a DM is possible.
+**Every person who engages with the post must receive the resource via DM as soon as they are distance 1.** Comment, invitation — the channel doesn't matter. The person gets the resource the moment a DM is possible.
 
 ## Configuration
 
-Only ask for these on activation. If `POST_URL` is omitted, call `getPosts` and let the user pick.
+All campaigns are defined in a single JSON file: `~/.bereach/lead-magnet.json`. The agent creates or edits this file when adding campaigns. On first run: if the file is missing or empty, the agent asks the user for campaign data and writes the file.
 
+### Schema
+
+```json
+{
+  "campaigns": [
+    {
+      "campaignSlug": "lm-feb-2026",
+      "postUrl": "https://linkedin.com/feed/update/urn:li:activity:...",
+      "resourceLink": "https://example.com/resource",
+      "dmTemplate": "{firstName}, voici la ressource: {link}",
+      "dmExamples": ["Hey {firstName}, c'est ici: {link}", "..."],
+      "commentExamples": {
+        "distance1": ["C'est parti !", "Envoi en cours"],
+        "distance2": ["Connecte-toi pour l'avoir", "On se connecte ?"]
+      },
+      "language": "fr",
+      "timezone": "Europe/Paris",
+      "activeHours": { "start": "07:00", "end": "23:00" },
+      "enabled": true
+    }
+  ]
+}
 ```
-POST_URL=<LinkedIn post URL>
-CAMPAIGN_SLUG=<unique name, e.g. "lm-feb-2026">
-DM_TEMPLATE=<DM with {firstName} and {link} placeholders, e.g. "{firstName}, voici la ressource: {link}">
-RESOURCE_LINK=<URL to share, or empty if DM is plain text>
-```
 
-`DM_TEMPLATE` supports `{firstName}` (commenter's first name) and `{link}` (the `RESOURCE_LINK` value). For richer personalization (headline, company), use visit data from the profile response when available.
+### Per-campaign fields
+
+| Field | Required | Description |
+| --- | --- | --- |
+| campaignSlug | yes | Unique ID for dedup |
+| postUrl | yes | LinkedIn post URL |
+| resourceLink | yes/no | URL to share in DM; empty = plain text, disables DM guard |
+| dmTemplate | yes | Base pattern with `{firstName}`, `{link}` |
+| dmExamples | no | List of DM variations (random pick); if absent, generate from template |
+| commentExamples | no | `{ distance1: string[], distance2: string[] }`; if absent, use defaults |
+| language | no | Post language (default: detect from post) |
+| timezone | no | User timezone (default: from getLinkedInProfile) |
+| activeHours | no | `{ start, end }` (default: 07:00–23:00) |
+| enabled | no | `true` = run (default: true) |
+
+Ask the user if their DM includes a link to share. If yes, set `resourceLink` — this enables the DM guard (inbox dedup). If no link, set `resourceLink` to empty — the DM guard is disabled and only server-side `campaignSlug` dedup applies.
+
+**Validation**: if `resourceLink` is empty or missing, `dmTemplate` must NOT contain `{link}`. If it does, strip `{link}` from the template at runtime and warn the user.
 
-Ask the user if their DM includes a link to share. If yes, store it in `RESOURCE_LINK` — this enables the DM guard (inbox dedup). If no link, set `RESOURCE_LINK` to empty — the DM guard is disabled and only server-side `campaignSlug` dedup applies.
+## Config validation
+
+At script start, validate the config: reject invalid JSON, require all required fields per campaign, reject duplicate `campaignSlug` values. Skip campaigns with missing or malformed data — never silently ignore errors.
 
 ## Tracking
 
 BeReach is the source of truth for action tracking (`campaignSlug` dedup).
 
-For the incremental comment check (`previousTotal`), use a local state file **per campaign** as a fallback — this survives process restarts and avoids re-processing if the cache resets. Only store the comment total counter locally; all action tracking stays on BeReach.
+For the incremental comment check (`previousTotal`), use `~/.bereach/lead-magnet-state.json` with `{ [campaignSlug]: { previousTotal } }` — this survives process restarts and avoids re-processing if the cache resets. Only store the comment total counter locally; all action tracking stays on BeReach.
 
 - **Check status**: `getStatus` with `campaignSlug` and `profiles` → returns per-profile booleans (`message`, `reply`, `like`, `visit`, `connect`)
 - **Manual sync**: `syncActions` with `campaignSlug` and `profiles: [{ profile, actions }]` → mark actions as completed without performing them (e.g. manual DMs done outside the bot)
@@ -58,23 +94,36 @@ All 3 scripts must perform pre-flight at the start of each run:
 
 ## Architecture
 
-Split into 3 independent scripts. Each script:
+**3 scripts** (one per workflow): `lm-comments.ts`, `lm-invitations.ts`, `lm-connections.ts`. **3 scheduled runs** (global) — each runs one script that loops over all enabled campaigns.
+
+Each script:
 
-1. Acquires a file lock **scoped to the campaign slug + script** (e.g. using a lock file with `fs.open` exclusive flag). If locked, exit immediately — a previous run is still active.
-2. Runs its logic.
-3. Prints recap and releases lock on exit.
+1. Reads `~/.bereach/lead-magnet.json`
+2. Filters `campaigns` where `enabled !== false`
+3. For each campaign: acquire lock `lm-{slug}-{script}` (see "Lock mechanism" below). If locked, skip that campaign — a previous run is still active.
+4. Runs its logic for the campaign.
+5. Prints recap per campaign, releases lock, moves to next campaign.
+6. At end: aggregate recap for all campaigns.
 
-The 3 scripts share `CAMPAIGN_SLUG` — BeReach dedup ensures no action is performed twice across scripts.
+BeReach dedup ensures no action is performed twice across scripts (same `campaignSlug`).
 
 ### Multiple campaigns
 
-A user can run lead magnets on several posts simultaneously. Each campaign has its own set of 3 scripts and 3 crons. Lock files and state files must include the campaign slug to avoid collisions between campaigns.
+All campaigns run in the same 3 scheduled runs. The config file lists all campaigns; each script iterates over them. Lock IDs: `lm-{slug}-comments`, `lm-{slug}-invitations`, `lm-{slug}-connections` (per campaign). State: `~/.bereach/lead-magnet-state.json` with `{ [campaignSlug]: { previousTotal } }`.
 
 All campaigns share the same LinkedIn rate limits. If multiple campaigns run at the same time, they compete for the same quota. BeReach handles conflicts automatically.
 
+### Lock mechanism
+
+Before running a script for a campaign, acquire a lock to prevent concurrent runs. One lock per campaign per script.
+
+- If the lock is already held by an active process, skip that campaign.
+- If the lock is stale (older than 30 minutes) or the holding process is dead, force-acquire.
+- Always release the lock on exit (normal, error, or signal).
+
 ### Script 1 — Comments
 
-Scrape commenters and engage them.
+For each campaign (from config): scrape commenters and engage them.
 
 1. **Check first** (mandatory): `collectComments` with `count: 0` → store `total`. On subsequent rounds, compare with previous `total`. If unchanged, skip this round. This saves credits and rate limit slots.
 2. **Fetch**: `collectComments` with `campaignSlug` → response: `profiles[]` (NOT "comments"). Paginate: while `hasMore`, increment `start` by `count`.
@@ -92,17 +141,18 @@ Scrape commenters and engage them.
 
 ### Script 2 — Invitations
 
-Accept pending invitations and deliver the resource.
+Accept pending invitations and deliver the resource to campaign-related invitees.
 
 - `listInvitations` → response: `invitations[]`. Each has: `invitationId`, `sharedSecret`, `fromMember: { name, profileUrl }`. Paginate: while `total > start + count`.
+- **Campaign attribution**: `listInvitations` returns ALL pending invitations. Cross-reference each inviter against campaign commenter lists to find which campaign (if any) they belong to. Accept all invitations, but only DM if campaign-matched.
 - For each invitation:
-  1. `acceptInvitation` with `invitationId` and `sharedSecret` — only these 2 required params
-  2. `visitProfile` with `fromMember.profileUrl` and `campaignSlug`
-  3. If `memberDistance === 1`: **DM dedup** (see "DM dedup" section) → DM if not already sent.
+  1. `acceptInvitation` with `invitationId` and `sharedSecret`
+  2. If campaign matched: `visitProfile` with matched `campaignSlug`, then **DM dedup** → DM if not already sent.
+  3. If no campaign match (organic invitation): accept only, no DM.
 
 ### Script 3 — New connections
 
-Check if distance 2+ commenters have now connected.
+For each campaign (from config): check if distance 2+ commenters have now connected.
 
 - Re-fetch commenters: `collectComments` with `campaignSlug` — paginate all
 - Filter: `actionsCompleted.message === false` and `knownDistance > 1` (skip profiles where `knownDistance` is null — they haven't been visited yet and belong to Script 1)
@@ -122,9 +172,9 @@ Check in order. If either says "already sent", skip the DM.
 
 **Layer 1 — `actionsCompleted.message`** (free, within campaign). Already checked in the script loop — `true` → skip.
 
-**Layer 2 — `/find` inbox lookup** (0 credits, cross-campaign). Only when `RESOURCE_LINK` is set. Call `findConversation` with `includeMessages: true` → `{ found, messages }`. `messages` is at the **top level**, not nested. If any message text contains `RESOURCE_LINK`: skip DM, call `syncActions` to mark done. If found but no link in messages: pass `messages` as context for DM tone adaptation. The function must return both skip decision and messages.
+**Layer 2 — `/find` inbox lookup** (0 credits, cross-campaign). Only when `resourceLink` is set. Call `findConversation` with `includeMessages: true` → `{ found, messages }`. `messages` is at the **top level**, not nested. If any message text contains `resourceLink`: skip DM, call `syncActions` to mark done. If found but no link in messages: pass `messages` as context for DM tone adaptation. The function must return both skip decision and messages.
 
-**Fail-safe**: if `findConversation` errors or all retries fail, **skip this profile** — do NOT send the DM. A failed lookup treated as "not found" causes duplicates. The profile will be retried next cron run.
+**Fail-safe**: if `findConversation` errors or all retries fail, **skip this profile** — do NOT send the DM. A failed lookup treated as "not found" causes duplicates. The profile will be retried next run.
 
 ## Language
 
@@ -134,21 +184,21 @@ For lead magnet, the default language is the **post language** — everyone comm
 
 - Distance 1: acknowledge, tell them you're sending it / it's in their DMs
 - Distance 2+: tell them to connect with you to receive it. Never mention DMs.
-- Language = post language (see above). The `generateReply()` function should accept a `language` parameter and maintain separate pools per language (at minimum FR and EN).
+- Use `commentExamples.distance1` and `commentExamples.distance2` from config if present; else generate from language (at least 5 per distance per language).
 - Short, casual, 3-5 words.
-- Use random selection over a pool of varied templates (at least 5 per distance per language). Vary phrasing and tone to avoid LinkedIn spam detection.
+- Random selection over the pool. Vary phrasing and tone to avoid LinkedIn spam detection.
 
 ## DM content
 
-- Use `DM_TEMPLATE` as the **base pattern** — same meaning, same `{link}`, but **always randomize phrasing**. Generate at least 10 variations of the template at boot (different wording, different greeting, different emoji, different sentence structure). Pick a random variation for each DM. Never send the same literal text twice in a row.
-- Language = post language.
-- **When conversation history exists** (DM guard fetched messages, no `RESOURCE_LINK` found): adapt the tone — more casual, shorter. The conversation messages are context.
+- Use `dmExamples` from config if present (random pick); else generate at least 10 variations from `dmTemplate` at boot (different wording, greeting, emoji, sentence structure). Pick a random variation for each DM. Never send the same literal text twice in a row.
+- Language = post language (from config or detect from post).
+- **When conversation history exists** (DM guard fetched messages, no `resourceLink` found): adapt the tone — more casual, shorter. The conversation messages are context.
 
 ## Time window
 
-Scripts only run between **7:00 and 23:00** in the user's timezone (default). At the start of each run, check the current local time. If outside the window, exit immediately with a short log ("Outside active hours, skipping"). The user can override the window if they ask.
+Scripts only run between **7:00 and 23:00** in the user's timezone (default). Use `activeHours` from config if present; else default 07:00–23:00. At the start of each run (per campaign), check the current local time. If outside the window, skip that campaign with a short log ("Outside active hours, skipping").
 
-Detect timezone from `getLinkedInProfile` → `location` (e.g. "Paris, France" → Europe/Paris). If ambiguous, ask the user once and store it in the campaign state file.
+Use `timezone` from config if present; else detect from `getLinkedInProfile` → `location` (e.g. "Paris, France" → Europe/Paris). If ambiguous, ask the user once and store in the campaign config.
 
 ## Pacing
 
@@ -156,21 +206,21 @@ Follow pacing rules from the main skill (Constraints #2). No exceptions — slee
 
 ## Cron
 
-Three independent crons per campaign. All run every 1h by default. Cron IDs must include the campaign slug to avoid collisions when running multiple campaigns.
+Three global crons. Config at `~/.openclaw/lead-magnet.json`. Each cron runs one script that loops over all enabled campaigns.
 
 All crons MUST use `"sessionTarget": "spawn"` to avoid blocking the main session. Each spawned sub-agent runs the script independently and pushes the recap back to the user when done.
 
 ```json
-{ "id": "lm-{slug}-comments", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-{slug}-comments.ts and report recap" }
-{ "id": "lm-{slug}-invitations", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-{slug}-invitations.ts and report recap" }
-{ "id": "lm-{slug}-connections", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-{slug}-connections.ts and report recap" }
+{ "id": "lm-comments", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-comments.ts and report recap" }
+{ "id": "lm-invitations", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-invitations.ts and report recap" }
+{ "id": "lm-connections", "every": "1h", "skill": "bereach", "sessionTarget": "spawn", "prompt": "Run lm-connections.ts and report recap" }
 ```
 
-Each script acquires a file lock scoped to campaign + script before running. If the lock is held (previous run still active), exit immediately — do NOT queue or wait.
+Each script acquires a per-campaign lock (`lm-{slug}-comments`, etc.) before running that campaign. If the lock is held (previous run still active), skip that campaign — do NOT queue or wait.
 
 ### Pause / Resume
 
-The user can pause or resume any script independently. When multiple campaigns are active, each campaign's scripts are paused/resumed separately.
+The user can pause or resume any campaign by setting `enabled: false` in `~/.bereach/lead-magnet.json` for that campaign.
 
 ### Recap (print after each run)
 
@@ -196,5 +246,5 @@ All enabled by default. The user can ask to disable any of these to save credits
 - **Likes** on comments (saves 1 credit/comment)
 - **Connection re-checks** (saves visit + DM credits)
 - **Comment replies** (saves 1 credit/comment)
-- **DM guard** — conversation lookup before DMing (0 credits, auto-disabled when no `RESOURCE_LINK`)
+- **DM guard** — conversation lookup before DMing (0 credits, auto-disabled when no `resourceLink`)
 - **Reply guard** — hasReplyFromPostAuthor check (free, but can be skipped if user wants to re-reply)

package/src/tools/definitions.ts

@@ -1,8 +1,8 @@
 /**
  * Tool definitions generated from the BeReach OpenAPI spec.
  *
- * Source of truth: apps/web2/apps/web/src/lib/openapi/schemas/linkedin.ts
- *                  apps/web2/apps/web/src/lib/openapi/schemas/campaigns.ts
+ * Source of truth: apps/web/src/lib/openapi/schemas/linkedin.ts
+ *                  apps/web/src/lib/openapi/schemas/campaigns.ts
  *
  * Each definition maps 1:1 to an OpenAPI endpoint and an SDK method.
  * Deprecated fields (actionSlug) are excluded.

package/src/tools/index.ts

@@ -1,6 +1,11 @@
+import type { Bereach } from "bereach";
 import { getClient } from "./../client";
 import { definitions } from "./definitions";
 
+type ResourceMap = {
+  [K in keyof Bereach as Bereach[K] extends object ? K : never]: Bereach[K];
+};
+
 /**
  * Registers all 33 BeReach tools with the OpenClaw agent.
  * Format per https://docs.openclaw.ai/plugins/agent-tools
@@ -15,7 +20,9 @@ export function registerAllTools(api: any) {
       async execute(_id: string, params: Record<string, unknown>) {
         const client = getClient();
         const [resource, method] = def.handler.split(".");
-        const result = await (client as any)[resource][method](params);
+        const res = client[resource as keyof ResourceMap];
+        const fn = (res as Record<string, (...args: unknown[]) => Promise<unknown>>)[method];
+        const result = await fn(params);
         return {
           content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }],
         };

package/scripts/test-register.ts

@@ -1,38 +0,0 @@
-#!/usr/bin/env tsx
-/// <reference types="node" />
-/**
- * Simulates OpenClaw plugin registration to catch config/trim errors.
- * Run: pnpm exec tsx scripts/test-register.ts
- * Or: BEREACH_API_KEY=brc_your_key pnpm exec tsx scripts/test-register.ts
- */
-
-import register from "../src/index";
-
-const apiKey = process.env.BEREACH_API_KEY || "brc_test_placeholder";
-
-const mockApi = {
-  pluginConfig: { BEREACH_API_KEY: apiKey },
-  registerTool: () => {},
-  registerCommand: () => {},
-  registerCli: () => {},
-};
-
-console.log("Testing plugin register with config (simulates OpenClaw load)...");
-try {
-  register(mockApi);
-  console.log("✓ register() completed — no trim/undefined errors");
-} catch (err: any) {
-  console.error("✗ register() failed:", err?.message || err);
-  process.exit(1);
-}
-
-console.log("\nTesting plugin register WITHOUT config (should load, fail on first use)...");
-try {
-  register({ pluginConfig: undefined, registerTool: () => {}, registerCommand: () => {}, registerCli: () => {} });
-  console.log("✓ register() completed — plugin loads without config (lazy init)");
-} catch (err: any) {
-  console.error("✗ register() failed with missing config:", err?.message || err);
-  process.exit(1);
-}
-
-console.log("\n✓ All tests passed");