bereach-openclaw 0.2.0

package/src/tools/definitions.ts

@@ -0,0 +1,567 @@
+/**
+ * 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
+ *
+ * Each definition maps 1:1 to an OpenAPI endpoint and an SDK method.
+ * Deprecated fields (actionSlug) are excluded.
+ */
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>;
+  handler: string;
+}
+
+export const definitions: ToolDefinition[] = [
+  // ── LinkedIn Scrapers ──────────────────────────────────────────────
+
+  {
+    name: "bereach_collect_likes",
+    description: "Scrape LinkedIn post likes. Returns paginated list of profiles who liked a post.",
+    handler: "linkedinScrapers.collectLikes",
+    parameters: {
+      type: "object",
+      required: ["postUrl"],
+      properties: {
+        postUrl: { type: "string", description: "LinkedIn post URL to inspect for reactions." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (multiples of 200)." },
+        count: { type: "integer", minimum: 0, maximum: 200, description: "Number of likes to fetch per page (0-200, default 200). Use count=0 for a free total-only check." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_collect_comments",
+    description: "Scrape LinkedIn post comments. Returns paginated list of commenters with comment text and URNs.",
+    handler: "linkedinScrapers.collectComments",
+    parameters: {
+      type: "object",
+      required: ["postUrl"],
+      properties: {
+        postUrl: { type: "string", description: "LinkedIn post URL to inspect for comments." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (multiples of 100)." },
+        count: { type: "integer", minimum: 0, maximum: 100, description: "Number of comments to fetch per page (0-100, default 100). Use count=0 for a free total-only check." },
+        campaignSlug: { type: "string", description: "When provided, each profile includes actionsCompleted and knownDistance for campaign-aware scraping." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_collect_comment_replies",
+    description: "Scrape replies to a LinkedIn comment. Returns paginated replies for a specific comment URN.",
+    handler: "linkedinScrapers.collectCommentReplies",
+    parameters: {
+      type: "object",
+      required: ["commentUrn"],
+      properties: {
+        commentUrn: { type: "string", description: "Comment URN returned by the comments endpoint (e.g., 'urn:li:comment:(activity:123456,789)')." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 0, maximum: 100, description: "Number of replies to fetch per page (0-100, default 100). Use count=0 for a free total-only check." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_collect_posts",
+    description: "Scrape LinkedIn profile posts. Returns paginated list of posts from a profile.",
+    handler: "linkedinScrapers.collectPosts",
+    parameters: {
+      type: "object",
+      required: ["profileUrl"],
+      properties: {
+        profileUrl: { type: "string", description: "LinkedIn profile URL to fetch posts from." },
+        count: { type: "integer", minimum: 0, maximum: 100, description: "Number of posts to fetch (0-100, default 20). Use count=0 for a free total-only check." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        paginationToken: { type: "string", description: "Pagination token from a previous response to fetch the next page." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_visit_profile",
+    description: "Visit LinkedIn profile and extract contact data. Distance-1 profiles cached 24h. No dedup — always executes.",
+    handler: "linkedinScrapers.visitProfile",
+    parameters: {
+      type: "object",
+      required: ["profile"],
+      properties: {
+        profile: { type: "string", description: "LinkedIn profile URL or profile URN." },
+        campaignSlug: { type: "string", description: "Optional campaign identifier for tracking only. No dedup — visit always executes." },
+        includePosts: { type: "boolean", description: "When true, fetches the last 5 posts from the profile. Defaults to false." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_visit_company",
+    description: "Visit LinkedIn company page and extract profile data including description, industry, employee count, headquarters, and more.",
+    handler: "linkedinScrapers.visitCompany",
+    parameters: {
+      type: "object",
+      required: ["companyUrl"],
+      properties: {
+        companyUrl: { type: "string", description: "LinkedIn company URL (e.g., 'https://www.linkedin.com/company/openai') or universal name (e.g., 'openai')." },
+        includeWorkplacePolicy: { type: "boolean", description: "Include workplace policy data such as hybrid/remote status and benefits. Costs 1 extra credit." },
+      },
+    },
+  },
+
+  // ── LinkedIn Search ────────────────────────────────────────────────
+
+  {
+    name: "bereach_unified_search",
+    description: "Unified LinkedIn Search — search posts, people, companies, or jobs with a single endpoint. Supports all filter types via category selection.",
+    handler: "linkedinSearch.unifiedSearch",
+    parameters: {
+      type: "object",
+      properties: {
+        category: { type: "string", enum: ["posts", "people", "companies", "jobs"], description: "Type of search to perform (required unless url is provided)." },
+        url: { type: "string", description: "LinkedIn search URL — category and filters are extracted automatically." },
+        keywords: { type: "string", description: "Search keywords. Supports LinkedIn Boolean syntax." },
+        sortBy: { type: "string", enum: ["relevance", "date"], description: "Sort order (posts & jobs)." },
+        datePosted: { type: "string", enum: ["past-24h", "past-week", "past-month"], description: "Time filter (posts & jobs)." },
+        contentType: { type: "string", enum: ["images", "videos", "documents"], description: "Media type filter (posts only)." },
+        authorIndustry: { type: "array", items: { type: "string" }, description: "Author industry IDs (posts only, resolve via /search/parameters)." },
+        authorCompany: { type: "array", items: { type: "string" }, description: "Author company IDs (posts only, resolve via /search/parameters)." },
+        connectionDegree: { type: "array", items: { type: "string", enum: ["F", "S", "O"] }, description: "Connection degree: F=1st, S=2nd, O=3rd+ (people only)." },
+        firstName: { type: "string", description: "First name filter (people only)." },
+        lastName: { type: "string", description: "Last name filter (people only)." },
+        title: { type: "string", description: "Job title filter, supports OR syntax (people only)." },
+        connectionOf: { type: "string", description: "Profile URN to find connections of (people only)." },
+        profileLanguage: { type: "array", items: { type: "string" }, description: "Profile language codes e.g. ['en','fr'] (people only)." },
+        school: { type: "array", items: { type: "string" }, description: "School IDs (people only, resolve via /search/parameters)." },
+        location: { type: "array", items: { type: "string" }, description: "Geo IDs (people, companies, jobs — resolve via /search/parameters)." },
+        industry: { type: "array", items: { type: "string" }, description: "Industry IDs (people, companies — resolve via /search/parameters)." },
+        currentCompany: { type: "array", items: { type: "string" }, description: "Current company IDs (people only, resolve via /search/parameters)." },
+        pastCompany: { type: "array", items: { type: "string" }, description: "Past company IDs (people only, resolve via /search/parameters)." },
+        companySize: { type: "array", items: { type: "string", enum: ["A", "B", "C", "D", "E", "F", "G", "H", "I"] }, description: "Company size: A=1-10, B=11-50, C=51-200, D=201-500, E=501-1K, F=1K-5K, G=5K-10K, H=10K+, I=self (companies only)." },
+        jobType: { type: "array", items: { type: "string", enum: ["F", "P", "C", "T", "I", "V", "O"] }, description: "Job type: F=Full-time, P=Part-time, C=Contract, T=Temporary, I=Internship, V=Volunteer, O=Other (jobs only)." },
+        experienceLevel: { type: "array", items: { type: "string", enum: ["1", "2", "3", "4", "5", "6"] }, description: "Experience level: 1=Internship, 2=Entry, 3=Associate, 4=Mid-Senior, 5=Director, 6=Executive (jobs only)." },
+        workplaceType: { type: "array", items: { type: "string", enum: ["1", "2", "3"] }, description: "Workplace type: 1=On-site, 2=Remote, 3=Hybrid (jobs only)." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Results per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_search_posts",
+    description: "Search LinkedIn posts by keywords with optional filters for date, content type, author industry, and author company.",
+    handler: "linkedinSearch.searchPosts",
+    parameters: {
+      type: "object",
+      required: ["keywords"],
+      properties: {
+        keywords: { type: "string", description: "Search keywords (required). Supports LinkedIn Boolean syntax." },
+        url: { type: "string", description: "Optional LinkedIn search URL. Explicit params override URL-derived values." },
+        sortBy: { type: "string", enum: ["relevance", "date"], description: "Sort order." },
+        datePosted: { type: "string", enum: ["past-24h", "past-week", "past-month"], description: "Filter by publication date." },
+        contentType: { type: "string", enum: ["images", "videos", "documents"], description: "Filter by media type." },
+        authorIndustry: { type: "array", items: { type: "string" }, description: "Author industry IDs (resolve via bereach_resolve_parameters)." },
+        authorCompany: { type: "array", items: { type: "string" }, description: "Author company IDs (resolve via bereach_resolve_parameters)." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Results per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_search_people",
+    description: "Search LinkedIn people by keywords, connection degree, name, title, location, industry, company, and school.",
+    handler: "linkedinSearch.searchPeople",
+    parameters: {
+      type: "object",
+      properties: {
+        keywords: { type: "string", description: "Search keywords. Matches against name, headline, company, skills, and bio." },
+        url: { type: "string", description: "Optional LinkedIn search URL." },
+        connectionDegree: { type: "array", items: { type: "string", enum: ["F", "S", "O"] }, description: "Connection degree: F=1st, S=2nd, O=3rd+." },
+        firstName: { type: "string", description: "Filter by first name (case-insensitive)." },
+        lastName: { type: "string", description: "Filter by last name (case-insensitive)." },
+        title: { type: "string", description: "Filter by job title. Supports OR syntax with '|' separator." },
+        connectionOf: { type: "string", description: "Profile URN to find connections of." },
+        profileLanguage: { type: "array", items: { type: "string" }, description: "Profile language codes (ISO 639-1)." },
+        school: { type: "array", items: { type: "string" }, description: "School IDs (resolve via bereach_resolve_parameters)." },
+        location: { type: "array", items: { type: "string" }, description: "Geo IDs (resolve via bereach_resolve_parameters)." },
+        industry: { type: "array", items: { type: "string" }, description: "Industry IDs (resolve via bereach_resolve_parameters)." },
+        currentCompany: { type: "array", items: { type: "string" }, description: "Current company IDs (resolve via bereach_resolve_parameters)." },
+        pastCompany: { type: "array", items: { type: "string" }, description: "Past company IDs (resolve via bereach_resolve_parameters)." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Results per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_search_companies",
+    description: "Search LinkedIn companies by keywords, location, industry, and company size.",
+    handler: "linkedinSearch.searchCompanies",
+    parameters: {
+      type: "object",
+      properties: {
+        keywords: { type: "string", description: "Search keywords. Matches against company name, description, and specialties." },
+        url: { type: "string", description: "Optional LinkedIn search URL." },
+        location: { type: "array", items: { type: "string" }, description: "Geo IDs (resolve via bereach_resolve_parameters)." },
+        industry: { type: "array", items: { type: "string" }, description: "Industry IDs (resolve via bereach_resolve_parameters)." },
+        companySize: { type: "array", items: { type: "string", enum: ["A", "B", "C", "D", "E", "F", "G", "H", "I"] }, description: "Employee count: A=1-10, B=11-50, C=51-200, D=201-500, E=501-1K, F=1K-5K, G=5K-10K, H=10K+, I=self." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Results per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_search_jobs",
+    description: "Search LinkedIn jobs by keywords, location, job type, experience level, and workplace type.",
+    handler: "linkedinSearch.searchJobs",
+    parameters: {
+      type: "object",
+      properties: {
+        keywords: { type: "string", description: "Search keywords. Matches against job title, company name, and description." },
+        url: { type: "string", description: "Optional LinkedIn search URL." },
+        location: { type: "array", items: { type: "string" }, description: "Geo IDs (resolve via bereach_resolve_parameters)." },
+        datePosted: { type: "string", enum: ["past-24h", "past-week", "past-month"], description: "Filter by posting date." },
+        sortBy: { type: "string", enum: ["relevance", "date"], description: "Sort order." },
+        jobType: { type: "array", items: { type: "string", enum: ["F", "P", "C", "T", "I", "V", "O"] }, description: "Employment type: F=Full-time, P=Part-time, C=Contract, T=Temporary, I=Internship, V=Volunteer, O=Other." },
+        experienceLevel: { type: "array", items: { type: "string", enum: ["1", "2", "3", "4", "5", "6"] }, description: "Seniority: 1=Internship, 2=Entry, 3=Associate, 4=Mid-Senior, 5=Director, 6=Executive." },
+        workplaceType: { type: "array", items: { type: "string", enum: ["1", "2", "3"] }, description: "Workplace: 1=On-site, 2=Remote, 3=Hybrid." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Results per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_search_by_url",
+    description: "Search LinkedIn by URL. Automatically extracts category, keywords, and filters from a LinkedIn search URL.",
+    handler: "linkedinSearch.searchByUrl",
+    parameters: {
+      type: "object",
+      required: ["url"],
+      properties: {
+        url: { type: "string", description: "A LinkedIn search URL. Category and filters are extracted automatically." },
+        start: { type: "integer", minimum: 0, description: "Override pagination offset." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Override results per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_resolve_parameters",
+    description: "Resolve text to LinkedIn search parameter IDs (typeahead). Prerequisite for using location, industry, company, or school filters.",
+    handler: "linkedinSearch.resolveParameters",
+    parameters: {
+      type: "object",
+      required: ["type", "keywords"],
+      properties: {
+        type: { type: "string", enum: ["GEO", "COMPANY", "INDUSTRY", "SCHOOL", "CONNECTIONS", "PEOPLE"], description: "Parameter type to resolve." },
+        keywords: { type: "string", description: "Text to resolve into LinkedIn IDs." },
+        limit: { type: "integer", minimum: 1, maximum: 50, description: "Max results (default 10, max 50)." },
+      },
+    },
+  },
+
+  // ── LinkedIn Actions ───────────────────────────────────────────────
+
+  {
+    name: "bereach_connect_profile",
+    description: "Send LinkedIn connection request. Deduplicates by profile within a campaign.",
+    handler: "linkedinActions.connectProfile",
+    parameters: {
+      type: "object",
+      required: ["profile"],
+      properties: {
+        profile: { type: "string", description: "LinkedIn profile URL or profile URN." },
+        campaignSlug: { type: "string", description: "Campaign identifier for deduplication." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_list_invitations",
+    description: "List received LinkedIn connection invitations. Returns pending invitations with IDs needed to accept them.",
+    handler: "linkedinActions.listInvitations",
+    parameters: {
+      type: "object",
+      properties: {
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 100, description: "Number of invitations to return (default 10, max 100)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_accept_invitation",
+    description: "Accept a LinkedIn connection invitation. Requires invitationId and sharedSecret from the list invitations endpoint.",
+    handler: "linkedinActions.acceptInvitation",
+    parameters: {
+      type: "object",
+      required: ["invitationId", "sharedSecret"],
+      properties: {
+        invitationId: { type: "string", description: "Invitation ID (from the list invitations endpoint)." },
+        sharedSecret: { type: "string", description: "Shared secret / validation token (from the list invitations endpoint)." },
+        senderProfileId: { type: "string", description: "Sender's profile ID. Recommended for reliability." },
+        firstName: { type: "string", description: "Sender's first name. Recommended for reliability." },
+        lastName: { type: "string", description: "Sender's last name. Recommended for reliability." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_send_message",
+    description: "Send LinkedIn message. Rate limited to 80 messages per day.",
+    handler: "linkedinActions.sendMessage",
+    parameters: {
+      type: "object",
+      required: ["profile", "message"],
+      properties: {
+        profile: { type: "string", description: "LinkedIn profile URL or profile URN." },
+        message: { type: "string", description: "Message content to send." },
+        campaignSlug: { type: "string", description: "Campaign identifier for deduplication." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_reply_to_comment",
+    description: "Reply to a LinkedIn comment. Use the commentUrn from the comments endpoint directly.",
+    handler: "linkedinActions.replyToComment",
+    parameters: {
+      type: "object",
+      required: ["commentUrn", "message"],
+      properties: {
+        commentUrn: { type: "string", description: "LinkedIn comment URN (e.g., 'urn:li:comment:(activity:123,456)')." },
+        message: { type: "string", description: "Reply message text." },
+        campaignSlug: { type: "string", description: "Campaign identifier for deduplication." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_like_comment",
+    description: "Like (react to) a LinkedIn comment. Use the commentUrn from the comments endpoint directly.",
+    handler: "linkedinActions.likeComment",
+    parameters: {
+      type: "object",
+      required: ["commentUrn"],
+      properties: {
+        commentUrn: { type: "string", description: "LinkedIn comment URN." },
+        reactionType: { type: "string", enum: ["LIKE", "LOVE", "CELEBRATE", "SUPPORT", "FUNNY", "INSIGHTFUL"], description: "Reaction type (default: LIKE)." },
+        campaignSlug: { type: "string", description: "Campaign identifier for deduplication." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_publish_post",
+    description: "Publish or schedule a LinkedIn post. Supports text, images, mentions, and visibility control.",
+    handler: "linkedinActions.publishPost",
+    parameters: {
+      type: "object",
+      required: ["text", "mode"],
+      properties: {
+        text: { type: "string", description: "Post commentary text." },
+        mode: { type: "string", enum: ["scheduled", "instant"], description: "Publish mode: 'instant' publishes immediately, 'scheduled' schedules for later." },
+        scheduledAt: { type: "integer", description: "Timestamp in milliseconds for scheduled posts (required when mode='scheduled')." },
+        imageUrl: { type: "string", description: "URL of an image to attach to the post." },
+        visibility: { type: "string", enum: ["ANYONE", "CONNECTIONS"], description: "Post visibility (default: ANYONE)." },
+        mentions: {
+          type: "array",
+          items: {
+            type: "object",
+            required: ["profileUrn", "start", "length"],
+            properties: {
+              profileUrn: { type: "string", description: "LinkedIn profile URN of the mentioned person." },
+              start: { type: "integer", description: "Start character offset where the mention begins." },
+              length: { type: "integer", description: "Length of the mention text in characters." },
+            },
+          },
+          description: "Profile mentions with text positions.",
+        },
+        campaignSlug: { type: "string", description: "Campaign identifier for deduplication." },
+      },
+    },
+  },
+
+  // ── LinkedIn Chat ──────────────────────────────────────────────────
+
+  {
+    name: "bereach_list_conversations",
+    description: "List LinkedIn inbox conversations with participants, last message, and read status.",
+    handler: "linkedinChat.listConversations",
+    parameters: {
+      type: "object",
+      properties: {
+        nextCursor: { type: "string", description: "Pagination cursor from a previous response." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_search_conversations",
+    description: "Search LinkedIn inbox conversations by keyword. 0 credits.",
+    handler: "linkedinChat.searchConversations",
+    parameters: {
+      type: "object",
+      required: ["keywords"],
+      properties: {
+        keywords: { type: "string", description: "Search keywords." },
+        nextCursor: { type: "string", description: "Pagination cursor from a previous response." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_find_conversation",
+    description: "Find a conversation with a specific person. Direct O(1) lookup via LinkedIn's compose API. 0 credits.",
+    handler: "linkedinChat.findConversation",
+    parameters: {
+      type: "object",
+      required: ["profile"],
+      properties: {
+        profile: { type: "string", description: "Profile URL or URN for direct conversation lookup." },
+        includeMessages: { type: "boolean", description: "If true, also return the conversation's recent messages (0 extra credits). Default: false." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_get_messages",
+    description: "Read messages from a LinkedIn conversation. 0 credits.",
+    handler: "linkedinChat.getMessages",
+    parameters: {
+      type: "object",
+      required: ["conversationUrn"],
+      properties: {
+        conversationUrn: { type: "string", description: "Full conversation URN as returned by list/search conversations." },
+        deliveredAt: { type: "integer", description: "Timestamp (ms) of the oldest message from previous page — pass this to load older messages." },
+      },
+    },
+  },
+
+  // ── Profile ────────────────────────────────────────────────────────
+
+  {
+    name: "bereach_get_profile",
+    description: "Get authenticated user's LinkedIn profile from the database. No LinkedIn API call, 0 credits.",
+    handler: "profile.getLinkedInProfile",
+    parameters: { type: "object", properties: {} },
+  },
+
+  {
+    name: "bereach_refresh_profile",
+    description: "Refresh authenticated user's LinkedIn profile by fetching latest data from LinkedIn.",
+    handler: "profile.refresh",
+    parameters: { type: "object", properties: {} },
+  },
+
+  {
+    name: "bereach_get_own_posts",
+    description: "Get authenticated user's LinkedIn posts.",
+    handler: "profile.getPosts",
+    parameters: {
+      type: "object",
+      properties: {
+        count: { type: "integer", minimum: 1, maximum: 100, description: "Number of posts to fetch (default 20, max 100)." },
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        paginationToken: { type: "string", description: "Pagination token from a previous response." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_get_followers",
+    description: "Get authenticated user's LinkedIn followers.",
+    handler: "profile.getFollowers",
+    parameters: {
+      type: "object",
+      properties: {
+        start: { type: "integer", minimum: 0, description: "Pagination offset (default 0)." },
+        count: { type: "integer", minimum: 1, maximum: 50, description: "Number of followers to fetch per page (default 10, max 50)." },
+      },
+    },
+  },
+
+  {
+    name: "bereach_get_limits",
+    description: "Get current LinkedIn rate limit status for all action types. 0 credits.",
+    handler: "profile.getLimits",
+    parameters: { type: "object", properties: {} },
+  },
+
+  {
+    name: "bereach_get_credits",
+    description: "Get current BeReach credit balance including used, remaining, and percentage. 0 credits.",
+    handler: "profile.getCredits",
+    parameters: { type: "object", properties: {} },
+  },
+
+  // ── Campaigns ──────────────────────────────────────────────────────
+
+  {
+    name: "bereach_campaign_status",
+    description: "Query per-profile action status within a campaign. Returns which actions have been completed for each profile. 0 credits.",
+    handler: "campaigns.getStatus",
+    parameters: {
+      type: "object",
+      required: ["campaignSlug", "profiles"],
+      properties: {
+        campaignSlug: { type: "string", pattern: "^[a-zA-Z0-9_-]+$", description: "Campaign identifier." },
+        profiles: {
+          type: "array",
+          items: { type: "string" },
+          minItems: 1,
+          maxItems: 500,
+          description: "LinkedIn profile URLs or URNs to check status for.",
+        },
+      },
+    },
+  },
+
+  {
+    name: "bereach_campaign_sync",
+    description: "Mark actions as completed without performing them on LinkedIn. Use when actions were performed outside the API. 0 credits.",
+    handler: "campaigns.syncActions",
+    parameters: {
+      type: "object",
+      required: ["campaignSlug", "profiles"],
+      properties: {
+        campaignSlug: { type: "string", pattern: "^[a-zA-Z0-9_-]+$", description: "Campaign identifier." },
+        profiles: {
+          type: "array",
+          items: {
+            type: "object",
+            required: ["profile", "actions"],
+            properties: {
+              profile: { type: "string", description: "LinkedIn profile URL or URN." },
+              actions: {
+                type: "array",
+                items: { type: "string", enum: ["message", "reply", "like", "visit", "connect"] },
+                minItems: 1,
+                description: "Action types to mark as completed.",
+              },
+            },
+          },
+          minItems: 1,
+          maxItems: 500,
+          description: "Profiles and actions to mark as completed.",
+        },
+      },
+    },
+  },
+
+  {
+    name: "bereach_campaign_stats",
+    description: "Get aggregate campaign statistics: per-action counts, unique profiles, and total credits used. 0 credits.",
+    handler: "campaigns.getStats",
+    parameters: {
+      type: "object",
+      required: ["campaignSlug"],
+      properties: {
+        campaignSlug: { type: "string", pattern: "^[a-zA-Z0-9_-]+$", description: "Campaign identifier." },
+      },
+    },
+  },
+];

package/src/tools/index.ts

@@ -0,0 +1,23 @@
+import { definitions } from "./definitions";
+import type { Bereach } from "bereach";
+
+/**
+ * Registers all 33 BeReach tools with the OpenClaw agent.
+ * Each tool delegates to the corresponding SDK method via dot-path resolution.
+ */
+export function registerAllTools(api: any, client: Bereach) {
+  for (const def of definitions) {
+    api.registerTool(
+      def.name,
+      {
+        description: def.description,
+        parameters: def.parameters,
+      },
+      async (params: Record<string, unknown>) => {
+        const [resource, method] = def.handler.split(".");
+        const result = await (client as any)[resource][method](params);
+        return result;
+      },
+    );
+  }
+}

package/src/types/bereach.d.ts

@@ -0,0 +1,15 @@
+declare module "bereach" {
+  interface BereachOptions {
+    token: string;
+  }
+
+  export class Bereach {
+    constructor(options: BereachOptions);
+    linkedinScrapers: Record<string, (params: any) => Promise<any>>;
+    linkedinActions: Record<string, (params: any) => Promise<any>>;
+    linkedinChat: Record<string, (params: any) => Promise<any>>;
+    linkedinSearch: Record<string, (params: any) => Promise<any>>;
+    profile: Record<string, (params?: any) => Promise<any>>;
+    campaigns: Record<string, (params: any) => Promise<any>>;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["__tests__", "node_modules", "dist"]
+}