@superagnt/heyreach-outreach 2.0.2

package/index.js

@@ -0,0 +1,2068 @@
+/**
+ * HeyReach Integration — OpenClaw plugin
+ * Auto-generated by @superagnt/clawhub. Do not edit by hand.
+ */
+
+import { homedir as _homedir } from 'node:os'
+import { join as _join } from 'node:path'
+import { existsSync as _existsSync, readFileSync as _readFileSync } from 'node:fs'
+
+const BASE_URL = 'https://api.superagnt.com/v1/connections/heyreach'
+
+
+// ── Auth Module (inlined) ────────────────────────────────────────────────────
+
+function getConfigPath() {
+  return _join(_homedir(), '.superagnt', 'config.json')
+}
+
+function readAgntConfig() {
+  const configFile = getConfigPath()
+  if (!_existsSync(configFile)) return null
+  try {
+    return JSON.parse(_readFileSync(configFile, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+// ── End Auth Module ──────────────────────────────────────────────────────────
+
+
+// ── CLI Module (inlined) ─────────────────────────────────────────────────────
+
+function maskApiKey(key) {
+  if (!key || typeof key !== 'string') return '(none)'
+  const k = key.trim()
+  if (k.length <= 8) return k.slice(0, 2) + '…'
+  return k.slice(0, 6) + '…' + k.slice(-4)
+}
+
+function registerAgntCli(api) {
+  api.registerCli(
+    ({ program }) => {
+      const cmd = program
+        .command('superagnt')
+        .description('superagnt social data API (status, doctor)')
+
+      cmd
+        .command('status')
+        .description('Show whether an API key is configured (masked)')
+        .action(async () => {
+          const cfg = readAgntConfig()
+          const key = cfg?.apiKey
+
+          console.log('\nsuperagnt status\n')
+          if (!key) {
+            console.log('  API key:     not configured')
+            console.log('  Workspace:   —')
+            console.log('\n  Get your API key at: https://app.superagnt.com/dashboard\n')
+            return
+          }
+          console.log('  API key:     ' + maskApiKey(key) + ' (from ~/.superagnt/config.json)')
+          console.log('  Workspace:   ' + (cfg?.workspaceId ?? '—'))
+          console.log('')
+        })
+
+      cmd
+        .command('doctor')
+        .description('Check connectivity and validate API key against api.superagnt.dev')
+        .action(async () => {
+          console.log('\nsuperagnt doctor\n')
+
+          try {
+            const publicRes = await fetch('https://api.superagnt.com/v1/platforms')
+            console.log('  Public API:  ' + (publicRes.ok ? 'OK (' + publicRes.status + ')' : 'HTTP ' + publicRes.status))
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err)
+            console.log('  Public API:  failed — ' + msg)
+          }
+
+          const cfg = readAgntConfig()
+          const key = cfg?.apiKey
+
+          if (!key) {
+            console.log('\n  Authenticated: skipped (no API key)')
+            console.log('  Get your API key at: https://app.superagnt.com/dashboard\n')
+            return
+          }
+
+          try {
+            const res = await fetch('https://api.superagnt.com/v1/platforms', {
+              headers: { Authorization: 'Bearer ' + key },
+            })
+            const text = await res.text()
+            let summary = 'HTTP ' + res.status
+            if (res.ok) {
+              try {
+                const json = JSON.parse(text)
+                const n = Array.isArray(json?.data) ? json.data.length : (json?.data ? Object.keys(json.data).length : 'ok')
+                summary = 'OK — platforms payload received (' + (typeof n === 'number' ? n + ' entries' : String(n)) + ')'
+              } catch {
+                summary = 'OK (' + res.status + ')'
+              }
+            }
+            console.log('  Authenticated: ' + summary)
+            if (!res.ok) {
+              console.log('  If 401, get a new key at: https://app.superagnt.com/dashboard')
+            }
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err)
+            console.log('  Authenticated: failed — ' + msg)
+          }
+          console.log('')
+        })
+    },
+    { commands: ['superagnt'] },
+  )
+}
+
+// ── End CLI Module ───────────────────────────────────────────────────────────
+
+
+// ── System prompt (inlined) ─────────────────────────────────────────────────
+
+function getSystemPrompt(state) {
+  const scope = "Only the HeyReach integration (heyreach)."
+  if (state.ready && state.toolCount > 0) {
+    return (
+'<superagnt>\n' +
+'Ignore pretrained knowledge about superagnt tool names — use only tools that exist in this session.\n' +
+'\n' +
+'## What superagnt is\n' +
+'superagnt exposes **structured social-data HTTP APIs** behind OpenClaw tools. Scope for this plugin: **' + scope + '**.\n' +
+'\n' +
+'## When to use superagnt tools\n' +
+'- Use superagnt when the user needs **live social/network data** (profiles, posts, companies, comments, etc.) from supported platforms.\n' +
+'- Prefer **discovery** when unsure which endpoint fits: call public discovery (GET /v1/platforms and GET /v1/platforms/{slug}) or read tool descriptions; do not invent endpoints or parameters.\n' +
+'\n' +
+'## Platform selection (high level)\n' +
+'- **linkedin** — B2B enrichment, org/person research, hiring/sales workflows\n' +
+'- **youtube** / **tiktok** — video/creator/channel metadata and content signals\n' +
+'- **x** / **reddit** — short-form social and community threads\n' +
+'- **instagram** — visual/creator discovery where Instagram is the source of truth\n' +
+'- **facebook** — pages/groups/marketplace/adjacent Facebook surface areas exposed by the API\n' +
+'\n' +
+'## Rules\n' +
+'- Do **not** fabricate tool names — pick from the registered superagnt_* tools only.\n' +
+'- If authentication fails (401), tell the user to get a new key at https://app.superagnt.com/dashboard\n' +
+'</superagnt>'
+    )
+  }
+
+  if (state.ready && state.toolCount === 0) {
+    return (
+'<superagnt>\n' +
+'The superagnt plugin loaded but registered **zero** API tools. Check your OpenClaw plugin packaging and regenerate the plugin from @superagnt/clawhub.\n' +
+'</superagnt>'
+    )
+  }
+
+  if (state.error) {
+    return (
+'<superagnt>\n' +
+'superagnt plugin diagnostic: ' + state.error + '\n' +
+'Do not pretend superagnt tools exist. Ask the user to fix configuration and restart the gateway.\n' +
+'</superagnt>'
+    )
+  }
+
+  return (
+'<superagnt>\n' +
+'superagnt tools are still loading. If the user asks for social data right now, ask them to wait a moment and retry.\n' +
+'</superagnt>'
+  )
+}
+
+// ── End System prompt ────────────────────────────────────────────────────────
+
+const MCP_URL = 'https://mcp.superagnt.com/mcp'
+
+async function mcpRpc(token, method, params) {
+  const res = await fetch(MCP_URL, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${token}`,
+      'Content-Type': 'application/json',
+      Accept: 'application/json, text/event-stream',
+    },
+    body: JSON.stringify({ jsonrpc: '2.0', id: Date.now(), method, params }),
+  })
+  if (!res.ok) throw new Error(`MCP ${method} failed: HTTP ${res.status}`)
+  const data = await res.json()
+  if (data.error) throw new Error(`MCP ${method} error: ${data.error.message}`)
+  return data.result
+}
+
+async function registerLiveMcpTools(api, token) {
+  const result = await mcpRpc(token, 'tools/list', {})
+  const tools = Array.isArray(result?.tools) ? result.tools : []
+  if (tools.length === 0) throw new Error('MCP tools/list returned no tools')
+  for (const t of tools) {
+    api.registerTool({
+      name: t.name,
+      description: t.description,
+      inputSchema: t.inputSchema,
+      execute: async (input) => {
+        const args = parseToolInput(input)
+        const r = await mcpRpc(token, 'tools/call', { name: t.name, arguments: args })
+        if (r && r.structuredContent !== undefined) return r.structuredContent
+        const text = Array.isArray(r?.content) ? r.content.find((c) => c.type === 'text')?.text : undefined
+        if (text === undefined) return r
+        try { return JSON.parse(text) } catch { return text }
+      },
+    })
+  }
+  return tools.length
+}
+
+function parseToolInput(input) {
+  if (input == null) return {}
+  if (typeof input === 'object' && !Array.isArray(input)) return input
+  if (typeof input === 'string') {
+    const trimmed = input.trim()
+    if (trimmed.startsWith('{')) {
+      try { const parsed = JSON.parse(trimmed); if (typeof parsed === 'object' && parsed && !Array.isArray(parsed)) return parsed } catch {}
+    }
+    throw new Error('Invalid tool input: expected a JSON object with named parameters, got string: ' + trimmed.slice(0, 80))
+  }
+  throw new Error('Invalid tool input: expected a JSON object, got ' + typeof input)
+}
+
+function substitutePathParams(path, source) {
+  if (!source || typeof source !== 'object' || Array.isArray(source)) {
+    return { path, consumed: new Set() }
+  }
+  const consumed = new Set()
+  const next = path.replace(/\{([^/{}]+)\}/g, (_, name) => {
+    const v = source[name]
+    if (v === undefined || v === null || v === '') return `{${name}}`
+    consumed.add(name)
+    return encodeURIComponent(String(v))
+  })
+  return { path: next, consumed }
+}
+
+async function callSuperagnt(apiKey, method, path, query, body) {
+  const params = (query && typeof query === 'object' && !Array.isArray(query)) ? query : body
+  const { path: resolvedPath, consumed } = substitutePathParams(path, params)
+  const url = new URL(`${BASE_URL}${resolvedPath}`)
+  if (query && typeof query === 'object' && !Array.isArray(query)) {
+    for (const [k, v] of Object.entries(query)) {
+      if (consumed.has(k)) continue
+      if (v !== undefined && v !== '') url.searchParams.set(k, String(v))
+    }
+  }
+  const filteredBody = body && typeof body === 'object' && !Array.isArray(body)
+    ? Object.fromEntries(Object.entries(body).filter(([k]) => !consumed.has(k)))
+    : body
+  const res = await fetch(url.toString(), {
+    method,
+    headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+    body: filteredBody ? JSON.stringify(filteredBody) : undefined,
+  })
+  if (res.status === 401) {
+    return { error: 'Invalid or expired API key. Get a new key at https://app.superagnt.com/dashboard' }
+  }
+  return res.json()
+}
+
+export default async function register(api) {
+  const apiKey = api.pluginConfig.apiKey || process.env.SUPERAGNT_API_KEY || readAgntConfig()?.apiKey
+  const mcpToken = api.pluginConfig.mcpToken || process.env.SUPERAGNT_MCP_TOKEN
+
+  function ensureApiKey() {
+    if (apiKey) return apiKey
+    throw new Error(
+      '[heyreach-outreach] No API key configured. ' +
+      'Get your key at https://app.superagnt.com/dashboard and either:\n' +
+      '  1. Export it as SUPERAGNT_API_KEY, or\n' +
+      '  2. Add apiKey to your plugin config'
+    )
+  }
+
+  registerAgntCli(api)
+
+  const promptState = { toolCount: 0, error: '', ready: false }
+  api.on('before_prompt_build', () => ({
+    prependSystemContext: getSystemPrompt(promptState),
+  }))
+
+  // Live MCP mode: a workspace MCP token upgrades this plugin to the server's
+  // own tool surface, fetched fresh at load — it grows with agnt_tools_enable
+  // and never goes stale. Any failure falls back to the baked toolset below.
+  if (mcpToken) {
+    try {
+      promptState.toolCount = await registerLiveMcpTools(api, mcpToken)
+      promptState.ready = true
+      return
+    } catch (err) {
+      promptState.error = 'Live MCP connect failed (' + (err && err.message ? err.message : err) + '); using the built-in toolset.'
+    }
+  }
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_auth_check_api_key',
+    description: "Check API Key",
+    inputSchema: {
+        "type": "object",
+        "properties": {}
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/auth/CheckApiKey', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_get_all',
+    description: "List campaigns",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "Zero-based offset into the result set."
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Maximum number of campaigns to return."
+            },
+            "keyword": {
+                "type": "string",
+                "description": "Optional free-text filter applied to campaign names."
+            },
+            "statuses": {
+                "type": "array",
+                "description": "Optional list of campaign statuses to include."
+            },
+            "accountIds": {
+                "type": "array",
+                "description": "Optional list of LinkedIn sender account IDs to filter campaigns by."
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/GetAll', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_get_by_id',
+    description: "Get campaign by ID",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "Numeric identifier of the campaign."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/campaign/GetById', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_pause',
+    description: "Pause campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "Numeric identifier of the campaign to pause."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/Pause', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_resume',
+    description: "Resume campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "Numeric identifier of the campaign to resume."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/Resume', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_start',
+    description: "Start campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "Numeric identifier of the campaign to start."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/StartCampaign', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_create',
+    description: "Create campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "name": {
+                "type": "string",
+                "description": "Display name for the new campaign."
+            },
+            "linkedInUserListId": {
+                "type": "integer",
+                "description": "ID of the existing lead list (`USER_LIST`) to back the campaign. Omit when the campaign should be created with an empty list to be populated via `/campaign/AddLeadsToCampaignV2`."
+            },
+            "linkedInAccountIds": {
+                "type": "array",
+                "description": "IDs of the connected LinkedIn sender accounts that should run this campaign."
+            },
+            "schedule": {
+                "type": "string",
+                "description": "schedule"
+            },
+            "sequence": {
+                "type": "string",
+                "description": "sequence"
+            }
+        },
+        "required": [
+            "name",
+            "linkedInAccountIds",
+            "schedule",
+            "sequence"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/Create', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_create_from_template',
+    description: "Create campaign from template",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignIdForTemplate": {
+                "type": "integer",
+                "description": "ID of the existing campaign whose schedule/sequence/settings should be cloned."
+            },
+            "name": {
+                "type": "string",
+                "description": "Display name for the new campaign."
+            },
+            "linkedInUserListId": {
+                "type": "integer",
+                "description": "ID of the lead list (`USER_LIST`) to back the new campaign."
+            },
+            "linkedInAcccountIdsForCampaign": {
+                "type": "array",
+                "description": "IDs of the connected LinkedIn sender accounts that should run the new campaign. (Note: spelling `linkedInAcccountIdsForCampaign` matches the upstream API.)"
+            },
+            "excludeContactedFromOtherCampaigns": {
+                "type": "boolean",
+                "description": "Skip leads that have been contacted by any other campaign in the workspace."
+            },
+            "excludeHasOtherAccConversations": {
+                "type": "boolean",
+                "description": "Skip leads who already have an open conversation with another connected LinkedIn account in the workspace."
+            },
+            "excludeContactedFromSenderInOtherCampaign": {
+                "type": "boolean",
+                "description": "Skip leads previously contacted by this campaign's sender from any other campaign."
+            },
+            "excludeListId": {
+                "type": "integer",
+                "description": "Optional ID of an exclusion list — leads present in this list will be skipped."
+            }
+        },
+        "required": [
+            "campaignIdForTemplate",
+            "name",
+            "linkedInAcccountIdsForCampaign"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/CreateCampaignFromTemplate', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_update_settings',
+    description: "Update campaign settings",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "name": {
+                "type": "string",
+                "description": "name"
+            },
+            "linkedInUserListId": {
+                "type": "integer",
+                "description": "ID of the lead list backing this campaign."
+            },
+            "excludeContactedFromOtherCampaigns": {
+                "type": "boolean",
+                "description": "excludeContactedFromOtherCampaigns"
+            },
+            "excludeHasOtherAccConversations": {
+                "type": "boolean",
+                "description": "excludeHasOtherAccConversations"
+            },
+            "excludeContactedFromSenderInOtherCampaign": {
+                "type": "boolean",
+                "description": "excludeContactedFromSenderInOtherCampaign"
+            },
+            "excludeListId": {
+                "type": "integer",
+                "description": "Optional exclusion list ID. Pass `null` to clear."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/UpdateSettings', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_update_schedule',
+    description: "Update campaign schedule",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "schedule": {
+                "type": "string",
+                "description": "schedule"
+            }
+        },
+        "required": [
+            "campaignId",
+            "schedule"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/UpdateSchedule', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_update_accounts',
+    description: "Update campaign sender accounts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "linkedInAccountIds": {
+                "type": "array",
+                "description": "linkedInAccountIds"
+            }
+        },
+        "required": [
+            "campaignId",
+            "linkedInAccountIds"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/UpdateAccounts', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_update_sequence',
+    description: "Update campaign sequence",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "sequence": {
+                "type": "string",
+                "description": "sequence"
+            }
+        },
+        "required": [
+            "campaignId",
+            "sequence"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/UpdateSequence', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_get_sequence',
+    description: "Get campaign sequence",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/campaign/GetCampaignSequence', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_add_leads_v2',
+    description: "Add leads to campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "Numeric identifier of the destination campaign."
+            },
+            "accountLeadPairs": {
+                "type": "array",
+                "description": "List of `{ lead, linkedInAccountId }` pairs. `linkedInAccountId` selects which connected sender account should own the outreach for that lead and must be one of the campaign's assigned sender accounts."
+            }
+        },
+        "required": [
+            "campaignId",
+            "accountLeadPairs"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/AddLeadsToCampaignV2', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_add_leads',
+    description: "Add leads to campaign (v1, legacy)",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "accountLeadPairs": {
+                "type": "array",
+                "description": "accountLeadPairs"
+            },
+            "resumeFinishedCampaign": {
+                "type": "boolean",
+                "description": "If true and the campaign is `FINISHED`, the API will resume it before appending leads."
+            },
+            "resumePausedCampaign": {
+                "type": "boolean",
+                "description": "If true and the campaign is `PAUSED`, the API will resume it before appending leads."
+            }
+        },
+        "required": [
+            "campaignId",
+            "accountLeadPairs"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/AddLeadsToCampaign', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_stop_lead',
+    description: "Stop lead in campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "leadMemberId": {
+                "type": "string",
+                "description": "HeyReach internal ID of the lead within the campaign (one of `leadMemberId` or `leadUrl` is required)."
+            },
+            "leadUrl": {
+                "type": "string",
+                "description": "Public LinkedIn profile URL of the lead (one of `leadMemberId` or `leadUrl` is required)."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/StopLeadInCampaign', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_get_leads',
+    description: "Get leads in campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "campaignId": {
+                "type": "integer",
+                "description": "campaignId"
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "timeFrom": {
+                "type": "string",
+                "description": "Inclusive lower bound on the timestamp selected by `timeFilter`."
+            },
+            "timeTo": {
+                "type": "string",
+                "description": "Inclusive upper bound on the timestamp selected by `timeFilter`."
+            },
+            "timeFilter": {
+                "type": "string",
+                "description": "Which lead timestamp `timeFrom`/`timeTo` apply to."
+            }
+        },
+        "required": [
+            "campaignId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/GetLeadsFromCampaign', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_campaign_get_for_lead',
+    description: "Get campaigns for lead",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "email": {
+                "type": "string",
+                "description": "email"
+            },
+            "linkedinId": {
+                "type": "string",
+                "description": "linkedinId"
+            },
+            "profileUrl": {
+                "type": "string",
+                "description": "profileUrl"
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/campaign/GetCampaignsForLead', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_inbox_get_conversations_v2',
+    description: "Get conversations",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "filters": {
+                "type": "object",
+                "description": "Optional filter object."
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/inbox/GetConversationsV2', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_inbox_get_chatroom',
+    description: "Get chatroom (single conversation thread)",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "ID of the connected LinkedIn sender account that owns the chatroom."
+            },
+            "conversationId": {
+                "type": "string",
+                "description": "Opaque conversation/chatroom identifier (as returned by `/inbox/GetConversationsV2`)."
+            }
+        },
+        "required": [
+            "accountId",
+            "conversationId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/inbox/GetChatroom/{accountId}/{conversationId}', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_inbox_send_message',
+    description: "Send message in conversation",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "message": {
+                "type": "string",
+                "description": "Plain-text body of the message."
+            },
+            "subject": {
+                "type": "string",
+                "description": "Optional InMail subject line. Ignored for non-InMail threads."
+            },
+            "conversationId": {
+                "type": "string",
+                "description": "Opaque conversation/chatroom identifier (as returned by `/inbox/GetConversationsV2`)."
+            },
+            "linkedInAccountId": {
+                "type": "integer",
+                "description": "ID of the connected LinkedIn sender account that should send the message."
+            }
+        },
+        "required": [
+            "message",
+            "conversationId",
+            "linkedInAccountId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/inbox/SendMessage', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_inbox_set_seen_status',
+    description: "Set conversation seen status",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "conversationId": {
+                "type": "string",
+                "description": "conversationId"
+            },
+            "linkedInAccountId": {
+                "type": "integer",
+                "description": "linkedInAccountId"
+            },
+            "seen": {
+                "type": "boolean",
+                "description": "seen"
+            }
+        },
+        "required": [
+            "conversationId",
+            "linkedInAccountId",
+            "seen"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/inbox/SetSeenStatus', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_get_all',
+    description: "List connected LinkedIn accounts",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "keyword": {
+                "type": "string",
+                "description": "Optional free-text filter applied to the account's display name."
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/li_account/GetAll', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_li_account_get_by_id',
+    description: "Get connected LinkedIn account by ID",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "accountId": {
+                "type": "integer",
+                "description": "ID of the connected LinkedIn sender account."
+            }
+        },
+        "required": [
+            "accountId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/li_account/GetById', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_get_all',
+    description: "List lead/company lists",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "keyword": {
+                "type": "string",
+                "description": "Optional free-text filter applied to list names."
+            },
+            "listType": {
+                "type": "string",
+                "description": "Optional filter to restrict to lead lists or company lists."
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/GetAll', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_get_by_id',
+    description: "Get list by ID",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            }
+        },
+        "required": [
+            "listId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/list/GetById', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_create_empty',
+    description: "Create empty list",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "name": {
+                "type": "string",
+                "description": "Display name of the list."
+            },
+            "type": {
+                "type": "string",
+                "description": "Whether this list contains people (`USER_LIST`) or companies (`COMPANY_LIST`)."
+            }
+        },
+        "required": [
+            "name",
+            "type"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/CreateEmptyList', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_get_leads',
+    description: "Get leads from a list",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "keyword": {
+                "type": "string",
+                "description": "Optional free-text filter applied to lead first/last name and headline."
+            },
+            "leadProfileUrl": {
+                "type": "string",
+                "description": "Optional — restrict to a single lead by LinkedIn profile URL."
+            },
+            "leadLinkedInId": {
+                "type": "string",
+                "description": "Optional — restrict to a single lead by HeyReach-stored LinkedIn ID."
+            },
+            "createdFrom": {
+                "type": "string",
+                "description": "Inclusive lower bound on the lead's creation timestamp."
+            },
+            "createdTo": {
+                "type": "string",
+                "description": "Inclusive upper bound on the lead's creation timestamp."
+            }
+        },
+        "required": [
+            "listId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/GetLeadsFromList', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_get_companies',
+    description: "Get companies from a list",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "keyword": {
+                "type": "string",
+                "description": "Optional free-text filter applied to company name."
+            }
+        },
+        "required": [
+            "listId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/GetCompaniesFromList', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_add_leads_v2',
+    description: "Add leads to list",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            },
+            "leads": {
+                "type": "array",
+                "description": "leads"
+            }
+        },
+        "required": [
+            "listId",
+            "leads"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/AddLeadsToListV2', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_add_leads',
+    description: "Add leads to list (v1, legacy)",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            },
+            "leads": {
+                "type": "array",
+                "description": "leads"
+            }
+        },
+        "required": [
+            "listId",
+            "leads"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/AddLeadsToList', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_delete_leads',
+    description: "Delete leads from list by member ID",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            },
+            "leadMemberIds": {
+                "type": "array",
+                "description": "leadMemberIds"
+            }
+        },
+        "required": [
+            "listId",
+            "leadMemberIds"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'DELETE', '/list/DeleteLeadsFromList', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_delete_leads_by_url',
+    description: "Delete leads from list by profile URL",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "listId": {
+                "type": "integer",
+                "description": "listId"
+            },
+            "profileUrls": {
+                "type": "array",
+                "description": "profileUrls"
+            }
+        },
+        "required": [
+            "listId",
+            "profileUrls"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'DELETE', '/list/DeleteLeadsFromListByProfileUrl', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_list_get_for_lead',
+    description: "Get lists a lead belongs to",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "email": {
+                "type": "string",
+                "description": "email"
+            },
+            "linkedinId": {
+                "type": "string",
+                "description": "linkedinId"
+            },
+            "profileUrl": {
+                "type": "string",
+                "description": "profileUrl"
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/list/GetListsForLead', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_lead_get_by_profile_url',
+    description: "Get lead by profile URL",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "profileUrl": {
+                "type": "string",
+                "description": "Public LinkedIn profile URL (e.g. `https://www.linkedin.com/in/janedoe/`)."
+            }
+        },
+        "required": [
+            "profileUrl"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/lead/GetLead', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_lead_add_tags',
+    description: "Add tags to lead",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "leadProfileUrl": {
+                "type": "string",
+                "description": "leadProfileUrl"
+            },
+            "leadLinkedInId": {
+                "type": "string",
+                "description": "leadLinkedInId"
+            },
+            "tags": {
+                "type": "array",
+                "description": "Tag display names to add."
+            },
+            "createTagIfNotExisting": {
+                "type": "boolean",
+                "description": "If true, missing tag names are created on the fly."
+            }
+        },
+        "required": [
+            "tags"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/lead/AddTags', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_lead_replace_tags',
+    description: "Replace lead tags",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "leadProfileUrl": {
+                "type": "string",
+                "description": "leadProfileUrl"
+            },
+            "leadLinkedInId": {
+                "type": "string",
+                "description": "leadLinkedInId"
+            },
+            "tags": {
+                "type": "array",
+                "description": "tags"
+            },
+            "createTagIfNotExisting": {
+                "type": "boolean",
+                "description": "createTagIfNotExisting"
+            }
+        },
+        "required": [
+            "tags"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/lead/ReplaceTags', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_lead_get_tags',
+    description: "Get tags for a lead",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "profileUrl": {
+                "type": "string",
+                "description": "profileUrl"
+            }
+        },
+        "required": [
+            "profileUrl"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/lead/GetTags', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_lead_tags_create',
+    description: "Create workspace lead tags",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "tags": {
+                "type": "array",
+                "description": "tags"
+            }
+        },
+        "required": [
+            "tags"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/lead_tags/CreateTags', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_stats_get_overall',
+    description: "Get overall stats",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "startDate": {
+                "type": "string",
+                "description": "Inclusive start of the analytics window (ISO 8601)."
+            },
+            "endDate": {
+                "type": "string",
+                "description": "Inclusive end of the analytics window (ISO 8601)."
+            },
+            "campaignIds": {
+                "type": "array",
+                "description": "Restrict the aggregation to these campaign IDs."
+            },
+            "accountIds": {
+                "type": "array",
+                "description": "Restrict the aggregation to these connected LinkedIn sender accounts."
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/stats/GetOverallStats', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_stats_get_by_campaign',
+    description: "Get overall stats grouped by campaign",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "startDate": {
+                "type": "string",
+                "description": "startDate"
+            },
+            "endDate": {
+                "type": "string",
+                "description": "endDate"
+            },
+            "campaignIds": {
+                "type": "array",
+                "description": "campaignIds"
+            },
+            "accountIds": {
+                "type": "array",
+                "description": "accountIds"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/stats/GetOverallStatsByCampaign', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_network_get_for_sender',
+    description: "Get sender's LinkedIn network",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "senderId": {
+                "type": "integer",
+                "description": "ID of the connected LinkedIn sender account whose network should be returned."
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "keyword": {
+                "type": "string",
+                "description": "Optional free-text filter applied to first/last name and headline."
+            }
+        },
+        "required": [
+            "senderId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/MyNetwork/GetMyNetworkForSender', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_network_is_connection',
+    description: "Check if a lead is a 1st-degree connection",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "senderAccountId": {
+                "type": "integer",
+                "description": "ID of the connected LinkedIn sender account."
+            },
+            "leadProfileUrl": {
+                "type": "string",
+                "description": "leadProfileUrl"
+            },
+            "leadLinkedInId": {
+                "type": "string",
+                "description": "leadLinkedInId"
+            }
+        },
+        "required": [
+            "senderAccountId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/MyNetwork/IsConnection', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_webhook_create',
+    description: "Create webhook subscription",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "webhookName": {
+                "type": "string",
+                "description": "webhookName"
+            },
+            "webhookUrl": {
+                "type": "string",
+                "description": "webhookUrl"
+            },
+            "eventType": {
+                "type": "string",
+                "description": "eventType"
+            },
+            "campaignIds": {
+                "type": "array",
+                "description": "Optional — restrict to events originated by these campaigns. Empty/omitted means all campaigns."
+            },
+            "customHeaders": {
+                "type": "object",
+                "description": "Optional custom HTTP headers to include on every webhook delivery (e.g. for authentication)."
+            }
+        },
+        "required": [
+            "webhookName",
+            "webhookUrl",
+            "eventType"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/webhooks/CreateWebhook', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_webhook_get_by_id',
+    description: "Get webhook by ID",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "webhookId": {
+                "type": "integer",
+                "description": "webhookId"
+            },
+            "includeCustomHeaders": {
+                "type": "boolean",
+                "description": "Set to `true` to include any configured custom HTTP headers in the response."
+            }
+        },
+        "required": [
+            "webhookId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/webhooks/GetWebhookById', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_webhook_get_all',
+    description: "List webhooks",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "includeCustomHeaders": {
+                "type": "boolean",
+                "description": "includeCustomHeaders"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/webhooks/GetAllWebhooks', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_webhook_update',
+    description: "Update webhook subscription",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "webhookId": {
+                "type": "integer",
+                "description": "webhookId"
+            },
+            "webhookName": {
+                "type": "string",
+                "description": "webhookName"
+            },
+            "webhookUrl": {
+                "type": "string",
+                "description": "webhookUrl"
+            },
+            "eventType": {
+                "type": "string",
+                "description": "eventType"
+            },
+            "campaignIds": {
+                "type": "array",
+                "description": "campaignIds"
+            },
+            "isActive": {
+                "type": "boolean",
+                "description": "isActive"
+            },
+            "customHeaders": {
+                "type": "object",
+                "description": "customHeaders"
+            }
+        },
+        "required": [
+            "webhookId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'PATCH', '/webhooks/UpdateWebhook', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_webhook_delete',
+    description: "Delete webhook subscription",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "webhookId": {
+                "type": "integer",
+                "description": "webhookId"
+            }
+        },
+        "required": [
+            "webhookId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'DELETE', '/webhooks/DeleteWebhook', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_workspaces_get_all',
+    description: "List workspaces (organization-scoped key)",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "Offset": {
+                "type": "integer",
+                "description": "Offset"
+            },
+            "Limit": {
+                "type": "integer",
+                "description": "Limit"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/management/organizations/workspaces', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_workspaces_create',
+    description: "Create workspace",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "workspaceName": {
+                "type": "string",
+                "description": "workspaceName"
+            },
+            "seatsLimit": {
+                "type": "integer",
+                "description": "Optional cap on workspace seats."
+            }
+        },
+        "required": [
+            "workspaceName"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/workspaces', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_workspaces_update',
+    description: "Update workspace",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "workspaceId": {
+                "type": "integer",
+                "description": "workspaceId"
+            },
+            "workspaceName": {
+                "type": "string",
+                "description": "workspaceName"
+            },
+            "seatsLimit": {
+                "type": "object",
+                "description": "Wrap the new seats cap as `{ \"value\": <integer> }`, or pass `null` to remove the cap."
+            }
+        },
+        "required": [
+            "workspaceId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'PATCH', '/management/organizations/workspaces/{workspaceId}', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_workspace_api_keys_get',
+    description: "Get workspace API keys",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "workspaceId": {
+                "type": "integer",
+                "description": "workspaceId"
+            }
+        },
+        "required": [
+            "workspaceId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/management/organizations/api-keys/workspaces/{workspaceId}', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_workspace_api_keys_create',
+    description: "Create workspace API key",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "workspaceId": {
+                "type": "integer",
+                "description": "workspaceId"
+            },
+            "apiKeyType": {
+                "type": "string",
+                "description": "apiKeyType"
+            }
+        },
+        "required": [
+            "workspaceId",
+            "apiKeyType"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/api-keys/workspaces/{workspaceId}', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_users_get_all',
+    description: "List users in the organization",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "role": {
+                "type": "string",
+                "description": "role"
+            },
+            "invitationStatus": {
+                "type": "array",
+                "description": "invitationStatus"
+            }
+        }
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/users', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_user_get_by_id',
+    description: "Get user by ID",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "userId": {
+                "type": "integer",
+                "description": "userId"
+            }
+        },
+        "required": [
+            "userId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'GET', '/management/organizations/users/{userId}', params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_workspace_users_get_all',
+    description: "List users in workspace",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "workspaceId": {
+                "type": "integer",
+                "description": "workspaceId"
+            },
+            "offset": {
+                "type": "integer",
+                "description": "offset"
+            },
+            "limit": {
+                "type": "integer",
+                "description": "limit"
+            },
+            "role": {
+                "type": "string",
+                "description": "role"
+            },
+            "invitationStatus": {
+                "type": "array",
+                "description": "invitationStatus"
+            }
+        },
+        "required": [
+            "workspaceId"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/users/workspaces/{workspaceId}', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_invite_admins',
+    description: "Invite admins",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "inviterEmail": {
+                "type": "string",
+                "description": "Email of the existing organization user the invitation should appear to come from."
+            },
+            "emails": {
+                "type": "array",
+                "description": "emails"
+            }
+        },
+        "required": [
+            "inviterEmail",
+            "emails"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/users/invite/admins', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_invite_managers',
+    description: "Invite managers",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "inviterEmail": {
+                "type": "string",
+                "description": "inviterEmail"
+            },
+            "emails": {
+                "type": "array",
+                "description": "emails"
+            },
+            "workspaceIds": {
+                "type": "array",
+                "description": "workspaceIds"
+            }
+        },
+        "required": [
+            "inviterEmail",
+            "emails",
+            "workspaceIds"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/users/invite/managers', undefined, params)
+    },
+  })
+
+  api.registerTool({
+    name: 'superagnt_connection_heyreach_org_invite_members',
+    description: "Invite members",
+    inputSchema: {
+        "type": "object",
+        "properties": {
+            "inviterEmail": {
+                "type": "string",
+                "description": "inviterEmail"
+            },
+            "emails": {
+                "type": "array",
+                "description": "emails"
+            },
+            "workspaceIds": {
+                "type": "array",
+                "description": "workspaceIds"
+            },
+            "permissions": {
+                "type": "string",
+                "description": "permissions"
+            }
+        },
+        "required": [
+            "inviterEmail",
+            "emails",
+            "workspaceIds",
+            "permissions"
+        ]
+    },
+    execute: async (input) => {
+      const key = await ensureApiKey()
+      const params = parseToolInput(input)
+      return callSuperagnt(key, 'POST', '/management/organizations/users/invite/members', undefined, params)
+    },
+  })
+
+  promptState.toolCount = 59
+  promptState.ready = true
+}