scrapeloop-mcp 0.33.0 → 0.35.0

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "description": "Scrapeloop MCP server  -  set up and run Scrapeloop end-to-end (integrations, scraping, lead database, verification, cleaners, enrichment, strategies, Instantly campaigns) from any MCP client (Claude Desktop, Cursor, ChatGPT, …).",
   "type": "module",
   "scripts": {
-    "test": "node --check src/index.js && node test/mcp_table_tools.mjs && node test/mcp_playbook_plans.mjs && node test/mcp_community_intent.mjs && node test/mcp_api_key_preflight.mjs && node test/mutation_retry_contract.mjs && node test/release_readiness.mjs && node test/mcp_server_version.mjs",
+    "test": "node --check src/index.js && node test/mcp_table_tools.mjs && node test/mcp_playbook_plans.mjs && node test/mcp_campaign_setup.mjs && node test/mcp_community_intent.mjs && node test/mcp_api_key_preflight.mjs && node test/mutation_retry_contract.mjs && node test/release_readiness.mjs && node test/mcp_server_version.mjs",
     "release:preflight": "node scripts/release-preflight.mjs",
     "release:verify": "node scripts/release-installed-verify.mjs"
   },

package/src/index.js

@@ -30,6 +30,8 @@ const API_KEY = process.env.SCRAPELOOP_API_KEY;
 const BASE = (process.env.SCRAPELOOP_API_URL || 'https://api.scrapeloop.com').replace(/\/$/, '');
 const TIMEOUT_MS = Number(process.env.SCRAPELOOP_TIMEOUT_MS) || 30000;
 const MAX_RETRIES = 3;
+// The API sits behind a proxy that ends a request after 100 seconds.
+const DEEP_READ = { timeoutMs: Math.max(TIMEOUT_MS, 90000), maxRetries: 1 };
 const MAX_TABLE_CELL_WRITES = 500;
 const MAX_TABLE_CELL_REQUEST_BYTES = 256 * 1024;
 // Native Smart Table tool keys, mirroring apps/api/lib/native_tool_columns.json.
@@ -48,6 +50,7 @@ const NATIVE_TABLE_TOOLS = Object.freeze([
   'business_email_finder',
   'linkedin_finder',
   'linkedin_activity',
+  'google_profile',
 ]);
 const TRACE_HEADER = 'X-Scrapeloop-Trace-Id';
 const SAFE_TRACE_ID = /^[A-Za-z0-9_-]{8,80}$/;
@@ -133,6 +136,9 @@ async function api(method, path, body, options = {}) {
     || policy?.retry === 'idempotent'
     || policy?.retry === 'idempotency_key';
   const maxRetries = canRetry ? (options.maxRetries ?? MAX_RETRIES) : 0;
+  // A few deep reads ask the sender and walk a whole campaign. They may take
+  // longer than an ordinary call, and are not worth sending three more times.
+  const timeoutMs = options.timeoutMs ?? TIMEOUT_MS;
   const headers = {
     Authorization: `Bearer ${API_KEY}`,
     'Content-Type': 'application/json',
@@ -149,7 +155,7 @@ async function api(method, path, body, options = {}) {
         method: verb,
         headers,
         body: body === undefined ? undefined : JSON.stringify(body),
-        signal: AbortSignal.timeout(TIMEOUT_MS),
+        signal: AbortSignal.timeout(timeoutMs),
       });
     } catch (e) {
       lastErr = e;
@@ -164,7 +170,7 @@ async function api(method, path, body, options = {}) {
       return {
         ok: false,
         status: 0,
-        error: { detail: `Could not reach Scrapeloop (${timedOut ? `timeout after ${TIMEOUT_MS}ms` : String(e)}).` },
+        error: { detail: `Could not reach Scrapeloop (${timedOut ? `timeout after ${timeoutMs}ms` : String(e)}).` },
         ...(options.captureTrace
           ? { trace_id: traceId, network_error: timedOut ? 'timeout' : 'transport' }
           : {}),
@@ -575,14 +581,15 @@ const TOOLS = {
     run: (a) => api('GET', `/plans/${enc(a.plan_id)}/yield`),
   },
   set_scrape_plan_ready_goal: {
-    def: { description: 'Save a verified-email goal on a native Maps draft with optional whole-scope repeat searches after the saved delay. Choose the ready Table and its email campaign, monthly goal/minimum, optional hard-maximum mode, unused-stock ceiling and evidence rules. Pass the reviewed expected_updated_at from get_scrape_plan. Counts require current input-bound verification, qualification, campaign fields and sender-history checks. This does not start scraping, verification or campaigns. Complete-search pacing must be available before Start.', inputSchema: obj({
+    def: { description: 'Save a verified-email goal on a native Maps draft with optional whole-scope repeat searches after the saved delay. Choose the ready Table and its email campaign, monthly goal/minimum, optional hard-maximum mode, unused-stock ceiling and evidence rules. supply_mode on_demand searches only while the linked campaign has room (plus buffer_days of its daily intake); only then may monthly_goal be null, with limit_mode target and monthly_minimum 0. allow_role counts an exact Role result (info@, office@) as ready and allow_resolved_catchall counts a catch-all that passed the second check: both must match the Table rules and the campaign, which check_campaign_setup verifies. Always send monthly_minimum and timezone: their defaults suit one business only. Pass the reviewed expected_updated_at from get_scrape_plan. Counts require current input-bound verification, qualification, campaign fields and sender-history checks. This does not start scraping, verification or campaigns. Complete-search pacing must be available before Start.', inputSchema: obj({
       plan_id: { ...S, format: 'uuid' }, expected_updated_at: { ...S, format: 'date-time' },
       goal: obj({ kind: { ...S, enum: ['verified_email'] }, ready_list_id: { ...S, format: 'uuid' },
-        campaign_id: { ...S, format: 'uuid' }, monthly_goal: { type: 'integer', minimum: 1, maximum: 1000000 },
+        campaign_id: { ...S, format: 'uuid' }, monthly_goal: { type: ['integer', 'null'], minimum: 1, maximum: 1000000 },
         limit_mode: { ...S, enum: ['target', 'maximum'] },
+        supply_mode: { ...S, enum: ['monthly', 'on_demand'] }, buffer_days: { type: 'integer', minimum: 0, maximum: 30 },
         monthly_minimum: { type: 'integer', minimum: 0, maximum: 1000000 },
         stock_ceiling: { type: 'integer', minimum: 1, maximum: 1000000 }, timezone: S,
-        evidence_max_age_days: { type: 'integer', minimum: 1, maximum: 90 }, allow_resolved_catchall: B,
+        evidence_max_age_days: { type: 'integer', minimum: 1, maximum: 90 }, allow_resolved_catchall: B, allow_role: B,
         required_fields: ARR({ ...S, enum: ['name', 'organization_name', 'first_name', 'last_name', 'industry', 'city', 'state', 'postal_code', 'domain', 'language'] }),
         languages: ARR({ ...S, pattern: '^[a-z]{2}$' }),
       }, ['ready_list_id', 'campaign_id', 'monthly_goal', 'monthly_minimum', 'stock_ceiling', 'timezone']),
@@ -594,10 +601,10 @@ const TOOLS = {
     run: (a) => api('GET', `/plans/${enc(a.plan_id)}/budget`),
   },
   set_scrape_plan_budget: {
-    def: { description: 'Save reviewed credit limits and Table ownership for a paused complete-search plan with a ready-email goal. Monthly lead credits always need a numeric cap. Explicit null removes only the extra lifetime lead or monthly/lifetime verify cap; omission is rejected. Zero blocks spending. No-cap checks still require allowed tools, bounded jobs and available workspace credits. Never infer no cap without approval. Include Raw, Email ready and every check Table. One Table belongs to one budget. Preserve expected_revision from the current budget; omit it only for the first save. A lost reply requires readback before retry. This starts no work and does not enable checks. website_language permits the free bounded Website languages preset with a saved attempt. owner_website explicitly permits the free bounded system Owner name finder; it still needs a saved job and attempt. review_history permits only the system Google review stats preset with source explicitly outscraper and a separate review_budget in USD, default zero. Select an existing connection from get_scrape_plan_budget.review_connections. Omitted review_budget preserves saved settings. Each row reserves 0.147 USD; recorded units use the published ceiling, not a confirmed account invoice. Unknown requests stay held and never retry. Google-first, custom recipes and other paid vendors remain blocked. Use review_complete_scrape_plan to check readiness before requesting exact launch approval.', inputSchema: obj({
+    def: { description: 'Save reviewed credit limits and Table ownership for a paused complete-search plan with a ready-email goal. All four credit answers are required. A number is a limit; explicit null means no plan limit for that one (then only the workspace balance stops the plan), and omission is rejected. Zero blocks spending. No-cap checks still require allowed tools, bounded jobs and available workspace credits. Never infer no cap without approval. Include Raw, Email ready and every check Table. One Table belongs to one budget. Preserve expected_revision from the current budget; omit it only for the first save. A lost reply requires readback before retry. This starts no work and does not enable checks. website_language permits the free bounded Website languages preset with a saved attempt. owner_website explicitly permits the free bounded system Owner name finder; it still needs a saved job and attempt. review_history permits only the system Google review stats preset with source explicitly outscraper and a separate review_budget in USD, default zero. Select an existing connection from get_scrape_plan_budget.review_connections. Omitted review_budget preserves saved settings. Each row reserves 0.147 USD; recorded units use the published ceiling, not a confirmed account invoice. Unknown requests stay held and never retry. Google-first, custom recipes and other paid vendors remain blocked. Use review_complete_scrape_plan to check readiness before requesting exact launch approval.', inputSchema: obj({
       plan_id: { ...S, format: 'uuid' }, expected_revision: { ...S, format: 'uuid' },
       limits: obj({
-        monthly_lead_credits: { type: 'integer', minimum: 0, maximum: 1000000000 },
+        monthly_lead_credits: { type: ['integer', 'null'], minimum: 0, maximum: 1000000000 },
         lifetime_lead_credits: { type: ['integer', 'null'], minimum: 0, maximum: 1000000000 },
         monthly_verify_credits: { type: ['integer', 'null'], minimum: 0, maximum: 1000000000 },
         lifetime_verify_credits: { type: ['integer', 'null'], minimum: 0, maximum: 1000000000 },
@@ -608,6 +615,40 @@ const TOOLS = {
     }, ['plan_id', 'limits', 'list_ids']) },
     run: ({ plan_id, ...body }) => api('PUT', `/plans/${enc(plan_id)}/budget`, body),
   },
+  set_scrape_plan_supply: {
+    def: { description: 'Change when a paused complete plan searches, and whether it counts role addresses. supply_mode monthly works toward monthly_goal; on_demand searches only while the linked campaign has room plus buffer_days of its daily intake. monthly_goal null (no monthly ready-lead limit) is allowed only with on_demand, limit_mode target and monthly_minimum 0. allow_role true counts an exact Role result (info@, office@) as ready; omit it to keep the saved choice. Always send buffer_days and monthly_minimum: left out, they are reset to 3 and 0. The scope, ready count, campaign and credit limits stay. Pass expected_updated_at from get_scrape_plan read after the pause. The plan then needs review_complete_scrape_plan and launch_complete_scrape_plan again. This starts no search.', inputSchema: obj({
+      plan_id: { ...S, format: 'uuid' }, expected_updated_at: { ...S, format: 'date-time' },
+      supply_mode: { ...S, enum: ['monthly', 'on_demand'] }, buffer_days: { type: 'integer', minimum: 0, maximum: 30 },
+      monthly_goal: { type: ['integer', 'null'], minimum: 1, maximum: 1000000 },
+      limit_mode: { ...S, enum: ['target', 'maximum'] },
+      monthly_minimum: { type: 'integer', minimum: 0, maximum: 1000000 }, allow_role: B,
+    }, ['plan_id', 'expected_updated_at', 'supply_mode', 'buffer_days', 'monthly_goal', 'limit_mode', 'monthly_minimum']) },
+    run: ({ plan_id, ...body }) => api('PUT', `/plans/${enc(plan_id)}/ready/supply`, body),
+  },
+  switch_scrape_plan_campaign: {
+    def: { description: 'Point a paused complete plan at another email campaign that reads the same ready Table. The plan must be paused by a person, both campaigns must have filling off, the new campaign must be an open Instantly campaign, and no check or Table move may be running (otherwise 409: wait and try again). The ready count, the searches done and the credit limits stay. Afterwards switch filling on for the new campaign, then review and launch the plan again. This uploads nothing and starts no search.', inputSchema: obj({
+      plan_id: { ...S, format: 'uuid' }, expected_updated_at: { ...S, format: 'date-time' }, campaign_id: { ...S, format: 'uuid' },
+    }, ['plan_id', 'expected_updated_at', 'campaign_id']) },
+    run: ({ plan_id, ...body }) => api('PUT', `/plans/${enc(plan_id)}/ready/campaign`, body),
+  },
+  update_scrape_plan: {
+    def: { description: 'Switch Google review counting on or off for the next searches of a Scrapeloop Maps plan. Needed when a Table rule asks for the review count. The plan must be paused, and a complete plan must have no place half searched. A complete plan then needs review_complete_scrape_plan and launch_complete_scrape_plan again. Limits and search area are not changed by this tool.', inputSchema: obj({
+      plan_id: { ...S, format: 'uuid' }, count_reviews: B,
+    }, ['plan_id', 'count_reviews']) },
+    run: ({ plan_id, ...body }) => api('PATCH', `/plans/${enc(plan_id)}`, body),
+  },
+  check_campaign_setup: {
+    def: { description: 'One free read that walks a whole self-filling campaign and says whether its parts fit each other: the search plan, the Tables and rules on the way, the checks, the email answer (Table rule, plan goal and campaign must agree), the campaign, the credit limits and the approval. Pass plan_id for a search plan, or campaign_id to start from a campaign (works with no plan too). Returns fits (true only when nothing is fail and nothing is unknown), counts, and checks in the order a lead travels; each has step, key, status (ok, warn, fail or unknown), a plain title and detail, and often fixes: the exact tool and args that end it. Run it after every build step and before asking for a start. Apply a fix only as its note says, ask the person before any fix that changes who gets an email or what may be spent, and run this again afterwards. It changes nothing, starts nothing and approves nothing. deep=false skips the sender read.', inputSchema: obj({
+      plan_id: { ...S, format: 'uuid' }, campaign_id: { ...S, format: 'uuid' }, deep: B,
+    }) },
+    run: (a) => {
+      if (!!a.plan_id === !!a.campaign_id) {
+        return { ok: false, status: 400, error: { detail: 'Pass plan_id or campaign_id, one of the two.' } };
+      }
+      const path = a.plan_id ? `/plans/${enc(a.plan_id)}/setup-check` : `/campaigns/${enc(a.campaign_id)}/setup-check`;
+      return api('GET', a.deep === false ? `${path}?deep=false` : path, undefined, a.deep === false ? {} : DEEP_READ);
+    },
+  },
   review_complete_scrape_plan: {
     def: { description: 'Read the exact complete-search scope, ready-output goal, Table rules, shared limits, repeat delay and current launch blockers. Free read. This does not start source work, checks or campaigns.', inputSchema: obj({ plan_id: { ...S, format: 'uuid' } }, ['plan_id']) },
     run: (a) => api('GET', `/plans/${enc(a.plan_id)}/launch-review`),
@@ -1070,7 +1111,7 @@ const TOOLS = {
   },
   get_campaign_handoff_status: {
     def: {
-      description: 'Read waiting, completed and held review Table handoffs for a campaign. No provider call, retry or write. Held copies may already have happened; inspect before moving again.',
+      description: 'Read waiting, completed and held review Table handoffs for a campaign. No provider call, retry or write. Held copies may already have happened; inspect before moving again. business_replied counts leads that were not moved because another address of the same business already replied or asked to stop; those need no review.',
       inputSchema: obj({ campaign_id: S }, ['campaign_id']),
     },
     run: (a) => a.campaign_id ? api('GET', `/campaigns/${enc(a.campaign_id)}/handoffs`)
@@ -1080,6 +1121,10 @@ const TOOLS = {
     def: { description: 'Read dated verified ready stock, count shared businesses and emails once, and compare planning shares with estimated remaining-month demand. Includes linked goals, coverage and shared credit allowance. This is a read-only planning view, not a reservation or sender approval. Unknown proof remains unknown. The remaining-month estimate accounts for saved follow-ups and deducts the current sender queue before allocating local stock.', inputSchema: obj({}) },
     run: () => api('GET', '/campaigns/supply'),
   },
+  get_campaign_supply_status: {
+    def: { description: 'Read the one supply status for every campaign with a linked complete plan, or for one campaign_id. Each answer has exactly one state: Running by itself, Waiting, it carries on by itself (with what it waits for), or Stopped, needs you (with the one next action, and anything else that is wrong listed after it). It also gives leads in the campaign now, leads added in the last 24 hours, searches done of the total, lead and verify credits used of their limits, measured credits per lead, and where the limits run out. Read-only: stored values and small counts, no sender call and no credit use. A number that could not be read is null, never zero. Use this first when the user asks if a campaign is running, done or stuck right now, and say the summary to them as written. To see whether the setup itself fits together, use check_campaign_setup.', inputSchema: obj({ campaign_id: S }) },
+    run: (a) => api('GET', a.campaign_id ? `/campaigns/${enc(a.campaign_id)}/supply-status` : '/campaigns/supply-status'),
+  },
   get_campaign_setup_options: {
     def: { description: 'Read this workspace\'s channel choices and defaults for new campaign drafts. Explicit create choices win. Reading options changes nothing and starts no campaign.', inputSchema: obj({}) },
     run: () => api('GET', '/campaigns/options'),
@@ -1162,7 +1207,7 @@ const TOOLS = {
     run: (a) => api('GET', `/campaigns/${enc(a.campaign_id)}/qualification`),
   },
   update_campaign: {
-    def: { description: 'Patch a campaign (feed_mode, target_active_count, cooldown_days, external_list_id, …). Switching feed_mode on for an already active campaign runs the same check as campaign_readiness_check: any fail answers 422 with the report under detail.readiness.', inputSchema: obj({ campaign_id: S, patch: { ...O, description: "Campaign settings to change. eligibility_rule uses {source_list_id, filter, optional excluded_campaign_ids} for Current qualification, or null to turn it off. The optional campaign IDs hold businesses already in those campaigns by Google place ID. qualification: {} disables the Belgium website language gate; {rule: be_dutch, evidence_column_id: UUID, max_age_days: 90} enables it. Read back after saving. These settings do not start checks or remove sender leads.", properties: { eligibility_rule: { type: ["object", "null"], additionalProperties: false, required: ["source_list_id", "filter"], properties: { source_list_id: S, filter: O, excluded_campaign_ids: { type: 'array', items: S, maxItems: 20 } } }, qualification: { ...O, description: "Belgium website language rule, or {} to disable." }, sender_options: { ...O, description: "GoHighLevel SMS settings. Only supplied keys change." }, icon: { type: ["string", "null"], description: "One or two emoji, or null to clear." } }, additionalProperties: true } }, ['campaign_id', 'patch']) },
+    def: { description: 'Patch a campaign (feed_mode, target_active_count, cooldown_days, external_list_id, …). Switching feed_mode on for an already active campaign runs the same check as campaign_readiness_check: any fail answers 422 with the report under detail.readiness.', inputSchema: obj({ campaign_id: S, patch: { ...O, description: "Campaign settings to change. eligibility_rule uses {source_list_id, filter, optional excluded_campaign_ids} for Current qualification, or null to turn it off. The optional campaign IDs hold businesses already in those campaigns by Google place ID. An edit that leaves excluded_campaign_ids out keeps the saved campaigns; send [] to clear them. qualification: {} disables the Belgium website language gate; {rule: be_dutch, evidence_column_id: UUID, max_age_days: 90} enables it. Read back after saving. These settings do not start checks or remove sender leads.", properties: { eligibility_rule: { type: ["object", "null"], additionalProperties: false, required: ["source_list_id", "filter"], properties: { source_list_id: S, filter: O, excluded_campaign_ids: { type: 'array', items: S, maxItems: 20 } } }, qualification: { ...O, description: "Belgium website language rule, or {} to disable." }, sender_options: { ...O, description: "GoHighLevel SMS settings. Only supplied keys change." }, icon: { type: ["string", "null"], description: "One or two emoji, or null to clear." } }, additionalProperties: true } }, ['campaign_id', 'patch']) },
     run: (a) => api('PATCH', `/campaigns/${enc(a.campaign_id)}`, a.patch || {}),
   },
   duplicate_campaign: {
@@ -1234,7 +1279,7 @@ const TOOLS = {
         'Is this campaign ready to start? Run it before activate_campaign. Returns ready, sender_known, sampled and a list of checks, each with a stable key, a level (pass, warn, fail or info), one plain sentence and a fix. Any fail means activate_campaign will refuse with 422 and the same report under detail.readiness. A warn does not block: read it out to the user before they confirm. It judges the leads the feed sends next (not the ones already in the campaign). With feed_mode off nothing is uploaded, so the lead and mailbox checks only warn until the feed is switched on.',
       inputSchema: obj({ campaign_id: S }, ['campaign_id']),
     },
-    run: (a) => api('GET', `/campaigns/${enc(a.campaign_id)}/readiness`),
+    run: (a) => api('GET', `/campaigns/${enc(a.campaign_id)}/readiness`, undefined, DEEP_READ),
   },
   get_sender_config: {
     def: { description: "Get an Instantly credential's sender config (daily cap, send accounts, …).", inputSchema: obj({ credential_id: S }, ['credential_id']) },
@@ -1685,7 +1730,7 @@ const TOOLS = {
   create_table_native_column: {
     def: {
       description:
-        `Attach one native Scrapeloop tool as a real Smart Table column: ${NATIVE_TABLE_TOOLS.join(', ')}. These are Scrapeloop's first-party tools, several of which superseded legacy presets, so they are addressed by tool key here rather than by preset slug through create_table_preset_column (which refuses a superseded slug for a new column). Each bills MANAGED VERIFICATION CREDITS per row, never dollars and never the customer's own vendor keys: verify_email reserves 1 credit per selected row, verify_phone reserves 5, each email finder reserves 3, linkedin_finder reserves 5, and linkedin_activity reserves 3. Settlement charges only fresh vendor checks and returns the unused reservation; missing inputs, cached rows, and skipped rows are free. linkedin_finder charges its 5 credits only for a row where it found the owner's LinkedIn profile; a row with no owner found is free. linkedin_activity reads each row's personal LinkedIn profile and newest post and labels it Active, Maybe or Weak (cell text), so LinkedIn invites go to people likely to answer; it charges 3 credits only for a profile it read, and rows with no personal profile, cached rows and profiles that no longer exist are free. Creating a column is always free. auto_run defaults false and queues nothing; when auto_run would backfill existing rows the API returns a 409 estimate whose cost.total_credits is the real charge, and you confirm it with confirm_auto_run plus confirmed_credits (CREDITS, not dollars - estimated_cost_usd is our vendor cost and is far smaller than what the workspace is billed). An auto_run that exceeds the workspace verify-credit balance returns 402 with {credit_kind, required, available} before anything is created. The Table master auto-run switch and workspace budget caps stay fail-closed. options are per tool and only the documented names are accepted - call get_table_native_tools for the current list. Owner email finder needs an owner first name plus the company website; point options.owner_name_column at an Owner name finder column to source the name, which auto_run requires. Business email finder is a SEPARATE column - create it with its own call and set options.owner_email_column to run it behind an owner finder. The Catch-all verifier is NOT creatable here: it needs a Verify email column that has already RUN and returned Catch All or Unknown, so use verify_catchall per address, or add the column from the Table's add-column menu.`,
+        `Attach one native Scrapeloop tool as a real Smart Table column: ${NATIVE_TABLE_TOOLS.join(', ')}. These are Scrapeloop's first-party tools, several of which superseded legacy presets, so they are addressed by tool key here rather than by preset slug through create_table_preset_column (which refuses a superseded slug for a new column). Each bills MANAGED VERIFICATION CREDITS per row, never dollars and never the customer's own vendor keys: verify_email reserves 1 credit per selected row, verify_phone reserves 5, each email finder reserves 3, linkedin_finder reserves 5, linkedin_activity reserves 3, and google_profile reserves 1. Settlement charges only fresh vendor checks and returns the unused reservation; missing inputs, cached rows, and skipped rows are free. linkedin_finder charges its 5 credits only for a row where it found the owner's LinkedIn profile; a row with no owner found is free. linkedin_activity reads each row's personal LinkedIn profile and newest post and labels it Active, Maybe or Weak (cell text), so LinkedIn invites go to people likely to answer; it charges 3 credits only for a profile it read, and rows with no personal profile, cached rows and profiles that no longer exist are free. google_profile finds a business on Google Maps for a lead that did not come from Google Maps (a Yelp lead, an imported list): it searches the business name in its town, accepts a result only when the phone, the website or the exact name in the same town matches, and saves place_id, gbp_url, rating and reviews_count on the cell (status found, not_found or unclear) and the place ID on a lead that had none; it charges 1 credit only for a profile found, and a business not on Google, more than one matching profile and cached rows are free. Filter on col.<key>.reviews_count to keep small businesses; a business with no reviews yet is saved as 0, and an unknown count has no number and never passes a numeric rule. Creating a column is always free. auto_run defaults false and queues nothing; when auto_run would backfill existing rows the API returns a 409 estimate whose cost.total_credits is the real charge, and you confirm it with confirm_auto_run plus confirmed_credits (CREDITS, not dollars - estimated_cost_usd is our vendor cost and is far smaller than what the workspace is billed). An auto_run that exceeds the workspace verify-credit balance returns 402 with {credit_kind, required, available} before anything is created. The Table master auto-run switch and workspace budget caps stay fail-closed. options are per tool and only the documented names are accepted - call get_table_native_tools for the current list. Owner email finder needs an owner first name plus the company website; point options.owner_name_column at an Owner name finder column to source the name, which auto_run requires. Business email finder is a SEPARATE column - create it with its own call and set options.owner_email_column to run it behind an owner finder. The Catch-all verifier is NOT creatable here: it needs a Verify email column that has already RUN and returned Catch All or Unknown, so use verify_catchall per address, or add the column from the Table's add-column menu.`,
       inputSchema: obj(
         {
           table_id: S,
@@ -1702,7 +1747,7 @@ const TOOLS = {
           options: {
             ...O,
             description:
-              'Tool-specific options. verify_phone: phone_col, default_region. email_finder: owner_name_column. business_email_finder: owner_email_column. linkedin_finder: business_col. linkedin_activity: linkedin_col, business_col. An undocumented name is rejected, never ignored.',
+              'Tool-specific options. verify_phone: phone_col, default_region. email_finder: owner_name_column. business_email_finder: owner_email_column. linkedin_finder: business_col. linkedin_activity: linkedin_col, business_col. google_profile: business_col. An undocumented name is rejected, never ignored.',
           },
           operation_id: {
             ...S,
@@ -2231,6 +2276,21 @@ const TOOLS = {
           })
         : { ok: false, status: 400, error: { detail: 'list_id and rule_id are required.' } },
   },
+  update_table_flow_rule: {
+    def: {
+      description:
+        'Change one saved Table rule in place: its condition, name, action settings, daily limit or delay. Send only what changes. A condition replaces the whole saved condition, so start from the one list_table_flow_rules returns (or from a fix that check_campaign_setup names) and keep every "not in that Table" guard. The rule keeps its id, history and counters. On a Table that belongs to a running complete plan, pause the plan first: a changed rule needs a fresh review and launch. Use toggle_table_flow_rule to switch a rule on or off.',
+      inputSchema: obj({
+        list_id: S, rule_id: S, name: S, condition: { type: 'object' }, action_config: { type: 'object' },
+        daily_fire_cap: { type: 'integer', minimum: 1, maximum: 100000 },
+        delay_seconds: { type: 'integer', minimum: 0, maximum: 2592000 },
+      }, ['list_id', 'rule_id']),
+    },
+    run: ({ list_id, rule_id, ...body }) =>
+      Object.keys(body).length
+        ? api('PATCH', `/lists/${enc(list_id)}/flow-rules/${enc(rule_id)}`, body)
+        : { ok: false, status: 400, error: { detail: 'Send at least one thing to change.' } },
+  },
   list_campaign_flow_rules: {
     def: {
       description:
@@ -2493,7 +2553,7 @@ const TOOLS = {
           limit: N,
           sort: S,
           q: S,
-          filter: { ...O, description: 'FilterExpr JSON (object): server-side row filter; adds total_filtered. lead.email_domain derives the exact lowercase domain from the current email, separate from website lead.domain. lead.gcid reads an exact Google category ID from current source data; it does not prove business fit. Use eq/any_of/none_of for exact lists; add not_empty to hold missing or malformed values. No DNS or provider lookup.' },
+          filter: { ...O, description: 'FilterExpr JSON (object): server-side row filter; adds total_filtered. lead.email_domain derives the exact lowercase domain from the current email, separate from website lead.domain. lead.gcid reads an exact Google category ID from current source data; it does not prove business fit. Use eq/any_of/none_of for exact lists; add not_empty to hold missing or malformed values. No DNS or provider lookup. lead.email_check is the exact saved email check result for the current address (safe, role, catch_all, disposable, inbox_full, disabled, invalid, unknown), empty when never checked; lead.email_status risky holds both role and inbox_full, so use lead.email_check any_of ["safe","role"] for an exact rule.' },
           view_id: { ...S, description: 'A saved custom view uuid or a system key (errored_rows/fully_enriched/data_only) from list_table_views. An ad-hoc filter/sort replaces the view\'s.' },
         },
         ['list_id'],

package/src/mutation-policies.js

@@ -53,6 +53,9 @@ export const MUTATION_POLICIES = Object.freeze({
   start_scrape_plan: never('POST', ['get_scrape_plan'], ['plan_id']),
   set_scrape_plan_ready_goal: reconcile('PUT', ['get_scrape_plan_ready_goal'], ['plan_id', 'goal']),
   set_scrape_plan_budget: reconcile('PUT', ['get_scrape_plan_budget'], ['plan_id', 'limits', 'list_ids']),
+  set_scrape_plan_supply: reconcile('PUT', ['get_scrape_plan_ready_goal'], ['plan_id', 'supply_mode', 'monthly_goal', 'limit_mode']),
+  switch_scrape_plan_campaign: reconcile('PUT', ['get_scrape_plan_ready_goal'], ['plan_id', 'campaign_id']),
+  update_scrape_plan: idempotent('PATCH', ['get_scrape_plan'], ['plan_id', 'count_reviews']),
   estimate_scrape: read(),
   submit_scrape: keyed('POST', ['list_jobs'], ['kind', 'integration_id', 'credential_id', 'table_id']),
   cancel_job: never('POST', ['get_job'], ['job_id', 'status']),
@@ -184,6 +187,7 @@ export const MUTATION_POLICIES = Object.freeze({
   save_flow_layout: idempotent('PUT', ['get_flow_graph'], ['scope_key']),
   create_table_flow_rule: reconcile('POST', ['list_table_flow_rules'], ['list_id', 'name']),
   toggle_table_flow_rule: idempotent('PATCH', ['list_table_flow_rules'], ['list_id', 'rule_id', 'enabled']),
+  update_table_flow_rule: idempotent('PATCH', ['list_table_flow_rules'], ['list_id', 'rule_id']),
   create_campaign_flow_rule: reconcile(
     'POST',
     ['list_campaign_flow_rules'],