@sellable/mcp 0.1.512 → 0.1.514

package/dist/server.js

@@ -9,12 +9,8 @@ import { prepareCampaignAbTest } from "./tools/campaign-ab-test.js";
 import { resolveCampaignFillRoute } from "./tools/campaign-fill-routing.js";
 import { fillCampaignHorizon } from "./tools/campaign-horizon-fill.js";
 import { cancelPrepareCampaignMessages, getPrepareCampaignMessagesStatus, startPrepareCampaignMessages, } from "./tools/campaign-message-preparation.js";
-import { getCampaignRefillState } from "./tools/campaign-refill-state.js";
-import { getEvergreenRefillPlan } from "./tools/evergreen-refill-plan.js";
-import { getRefillTargetPlan } from "./tools/refill-target-plan.js";
-import { refillSendsEvergreenCommand } from "./tools/refill-sends-evergreen.js";
-import { getSchedulerFillCapacity } from "./tools/scheduler-fill-capacity.js";
 import { getCampaignTableSchema, queueCampaignCells, recordCampaignReviewBatch, reviseMessageTemplateAndRerun, selectCampaignCells, waitForCampaignProcessing, } from "./tools/campaign-processing.js";
+import { getCampaignRefillState } from "./tools/campaign-refill-state.js";
 import { archiveCampaign, createCampaign, duplicateCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
 import { queueCells, updateCell } from "./tools/cells.js";
 import { handleStartCliLogin, handleWaitForCliLogin, } from "./tools/cli-login.js";
@@ -31,6 +27,7 @@ import { searchEngagementPosts } from "./tools/engage-discovery.js";
 import { copySenderConfigTool, getEngageMemoryTool, migrateFlatConfigsTool, recordEngageProvenSearchTool, setEngageStyleGuideTool, upsertEngageTrackedPersonTool, } from "./tools/engage-memory.js";
 import { getEngageStateTool, setEngageStateTool, } from "./tools/engage-state.js";
 import { bulkEnrichWithProspeo, enrichWithProspeo, getProspeoCredits, } from "./tools/enrichment.js";
+import { getRefillPlanV2 } from "./tools/evergreen-refill-plan.js";
 import { getCampaignFramework } from "./tools/framework.js";
 import { confirmHarvestJobCompanies, searchHarvestJobs, } from "./tools/harvest-jobs.js";
 import { checkInboxReplyEligibility, getInboxThread, searchInboxThreads, sendInboxDraft, sendInboxManualReply, updateInboxDraft, } from "./tools/inbox.js";
@@ -41,10 +38,13 @@ import { addOnDemandLeads, createOnDemandCampaign, createOnDemandTable, initOnDe
 import { upsertRubric } from "./tools/processing.js";
 import { completeSenderResearch, getPostFindLeadsScoutRegistry, getSourceScoutRegistry, getSubskillAsset, getSubskillPrompt, listSubskillPrompts, searchSubskillPrompts, } from "./tools/prompts.js";
 import { waitForCampaignTableReady, waitForLeadListReady, } from "./tools/readiness.js";
+import { refillSendsV2Command } from "./tools/refill-sends-v2.js";
 import { executeRefillSendsCommand } from "./tools/refill-sends.js";
+import { getRefillTargetPlan } from "./tools/refill-target-plan.js";
 import { allTools } from "./tools/registry.js";
 import { getRows, getTableRows, getTableRowsMinimal } from "./tools/rows.js";
 import { addRubricItem, checkRubric, deleteRubricItem, draftRubrics, saveRubrics, selectNecessaryRubrics, updateRubricItem, waitForRubricResults, } from "./tools/rubrics.js";
+import { getSchedulerFillCapacity } from "./tools/scheduler-fill-capacity.js";
 import { getSenderRoutingTool, setSenderRoutingTool, } from "./tools/sender-routing.js";
 import { getSender, listSenders, refreshPaidInmailCredits, } from "./tools/senders.js";
 import { attachRecommendedSequence, attachSequence, createWorkflowTable, } from "./tools/sequencer.js";
@@ -225,8 +225,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_campaign_refill_state":
                 result = await getCampaignRefillState(args);
                 break;
+            case "get_refill_plan_v2":
             case "get_evergreen_refill_plan":
-                result = await getEvergreenRefillPlan(args);
+                result = await getRefillPlanV2(args);
                 break;
             case "get_refill_target_plan":
                 result = await getRefillTargetPlan(args);
@@ -237,8 +238,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "refill_sends":
                 result = await executeRefillSendsCommand(args);
                 break;
+            case "refill_sends_v2":
             case "refill_sends_evergreen":
-                result = refillSendsEvergreenCommand(args);
+                result = await refillSendsV2Command(args);
                 break;
             case "setup_evergreen_campaigns":
                 result = await setupEvergreenCampaigns(args);

package/dist/tools/campaign-processing.js

@@ -47,7 +47,7 @@ export const campaignProcessingToolDefinitions = [
     },
     {
         name: "select_campaign_cells",
-        description: "Dry-run semantic campaign-cell selection. Returns compact counts and a tiny sample, never bulky row data. For regular refill diagnostics, use rowSelector:{type:\"needsEnrichment\"} to find the earliest unenriched rows by table position, then rowSelector:{type:\"needsApproval\"} to inspect current generated messages that are not approved. needsGeneratedMessage only sees rows that already passed rubric and can skip earlier unenriched rows; use it for generated-message repair, not top-down refill.",
+        description: 'Dry-run semantic campaign-cell selection. Returns compact counts and a tiny sample, never bulky row data. For regular refill diagnostics, use rowSelector:{type:"needsEnrichment"} to find the earliest unenriched rows by table position, then rowSelector:{type:"needsApproval"} to inspect current generated messages that are not approved. needsGeneratedMessage only sees rows that already passed rubric and can skip earlier unenriched rows; use it for generated-message repair, not top-down refill.',
         inputSchema: {
             type: "object",
             properties: {
@@ -94,7 +94,7 @@ export const campaignProcessingToolDefinitions = [
     },
     {
         name: "queue_campaign_cells",
-        description: "Resolve and queue campaign cells by semantic role and row selector. Normal create-campaign tail should use this instead of fetching rows only to discover cell IDs. For regular refill enrichment, queue columnRole:\"enrich\" with rowSelector:{type:\"needsEnrichment\"} or use start_campaign_message_preparation for the full top-down prep loop. For approval, rowSelector:{type:\"needsApproval\"} selects current generated rows missing Approved=true, but mutating Approved cells still requires explicit bounded approval. Do not use needsGeneratedMessage as a refill cursor because it only selects already-passed rows. Use forceRerun:true for message-template revisions.",
+        description: 'Resolve and queue campaign cells by semantic role and row selector. Normal create-campaign tail should use this instead of fetching rows only to discover cell IDs. For regular refill enrichment, queue columnRole:"enrich" with rowSelector:{type:"needsEnrichment"} or use start_campaign_message_preparation for the full top-down prep loop. For approval, rowSelector:{type:"needsApproval"} selects current generated rows missing Approved=true, but mutating Approved cells still requires explicit bounded approval. Do not use needsGeneratedMessage as a refill cursor because it only selects already-passed rows. Use forceRerun:true for message-template revisions.',
         inputSchema: {
             type: "object",
             properties: {
@@ -103,7 +103,7 @@ export const campaignProcessingToolDefinitions = [
                 workspaceId: { type: "string" },
                 columnRole: {
                     type: "string",
-                    enum: ["enrich", "generateMessage", "approved"],
+                    enum: ["enrich", "icpScore", "generateMessage", "approved"],
                 },
                 rowSelector: {
                     type: "object",

package/dist/tools/evergreen-refill-plan.d.ts

@@ -1,12 +1,19 @@
-type GetEvergreenRefillPlanInput = {
+type GetRefillPlanV2Input = {
     workspaceId?: string;
+    intent?: "auto" | "evergreen" | "plain" | "active";
     senderIds?: string[];
     runState?: Record<string, unknown>;
     journal?: boolean;
     journalNote?: string;
 };
 export declare function sanitizeEvergreenRefillPlanResult(value: unknown): Record<string, unknown>;
-export declare const evergreenRefillPlanToolDefinitions: {
+export declare function buildRunStateFromLocalHints(workspaceId: string): {
+    version: number;
+    senderCursors: never[];
+    laneCooldowns: import("../refill-local-state.js").RefillLaneMemoryEntry[];
+    passRates: import("../refill-local-state.js").RefillPassRateObservation[];
+};
+export declare const refillPlanV2ToolDefinitions: {
     name: string;
     description: string;
     inputSchema: {
@@ -26,6 +33,11 @@ export declare const evergreenRefillPlanToolDefinitions: {
                 type: string;
                 description: string;
             };
+            intent: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             journal: {
                 type: string;
                 description: string;
@@ -39,11 +51,25 @@ export declare const evergreenRefillPlanToolDefinitions: {
         additionalProperties: boolean;
     };
 }[];
-export declare function getEvergreenRefillPlan(input: GetEvergreenRefillPlanInput): Promise<{
+export declare function getRefillPlanV2(input: GetRefillPlanV2Input): Promise<{
+    readOnly: boolean;
+    blocker: string;
+    workspaceId: string;
+    guidance: string;
+    warnings: string[];
+    journalPath: string | null;
+    text: string;
+    workspaceResolution: string;
+} | {
     warnings: any[];
     journalPath: string | null;
     text: string;
     workspaceId: string;
     workspaceResolution: string;
+    readOnly?: undefined;
+    blocker?: undefined;
+    guidance?: undefined;
 }>;
+/** @deprecated Use getRefillPlanV2. */
+export declare const getEvergreenRefillPlan: typeof getRefillPlanV2;
 export {};

package/dist/tools/evergreen-refill-plan.js

@@ -1,5 +1,5 @@
 import * as path from "node:path";
-import { getApi } from "../api.js";
+import { getApi, SellableApiError } from "../api.js";
 import { appendIndexLine, appendJournalEvent, createRunJournal, renderBootstrapSection, renderPlanSection, renderTerminalSection, } from "../refill-journal.js";
 import { readRefillWorkspaceState } from "../refill-local-state.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
@@ -36,7 +36,7 @@ export function sanitizeEvergreenRefillPlanResult(value) {
     }
     return sanitized;
 }
-function buildRunStateFromLocalHints(workspaceId) {
+export function buildRunStateFromLocalHints(workspaceId) {
     const state = readRefillWorkspaceState(workspaceId);
     return {
         version: 1,
@@ -45,7 +45,7 @@ function buildRunStateFromLocalHints(workspaceId) {
         passRates: state?.passRates ?? [],
     };
 }
-async function postEvergreenRefillPlan(body, workspaceId) {
+async function postRefillPlanV2(body, workspaceId) {
     const api = getApi();
     const requestOptions = workspaceRequestOptions(workspaceId);
     return requestOptions
@@ -75,7 +75,7 @@ function writeDryRunJournal(params) {
         ? params.result.bootstrap
         : {};
     appendJournalEvent(created.filePath, renderBootstrapSection({
-        summary: "Evergreen refill dry-run bootstrap",
+        summary: "Refill v2 dry-run bootstrap across managed waterfall, dashboard evergreen, and active campaign lanes",
         senderSummary: JSON.stringify(bootstrap.senders ?? []),
         laneSummary: JSON.stringify(bootstrap.laneOrder ?? []),
         targetSummary: JSON.stringify(bootstrap.target ?? []),
@@ -113,14 +113,48 @@ function writeDryRunJournal(params) {
         fileName: path.basename(created.filePath),
         workspaceId: params.workspaceId,
         dryRun: true,
-        summary: "evergreen refill dry-run",
+        summary: "refill v2 dry-run",
     });
     return created.filePath;
 }
-export const evergreenRefillPlanToolDefinitions = [
+function writeWorkspaceAccessJournal(params) {
+    const created = createRunJournal({
+        workspaceId: params.workspaceId,
+        dryRun: true,
+    });
+    appendJournalEvent(created.filePath, renderBootstrapSection({
+        summary: "Refill v2 dry-run bootstrap stopped at workspace access",
+        senderSummary: "[]",
+        laneSummary: "[]",
+        targetSummary: `workspaceId=${params.workspaceId}`,
+        creditSummary: "[]",
+    }));
+    appendJournalEvent(created.filePath, renderPlanSection({
+        chosenSummary: "workspace_access blocker",
+        itinerarySummaries: ["No workspace campaign state read"],
+        fallbackSummary: "terminal:workspace_access",
+    }));
+    appendJournalEvent(created.filePath, renderTerminalSection({
+        summary: `blocker=workspace_access workspaceId=${params.workspaceId} ${params.guidance}`,
+    }));
+    appendIndexLine({
+        runId: created.runId,
+        fileName: path.basename(created.filePath),
+        workspaceId: params.workspaceId,
+        dryRun: true,
+        summary: "refill v2 dry-run workspace_access blocker",
+    });
+    return created.filePath;
+}
+function isWorkspaceAccessError(error) {
+    return (error instanceof SellableApiError &&
+        error.status === 403 &&
+        error.body.includes("No access to workspace"));
+}
+export const refillPlanV2ToolDefinitions = [
     {
-        name: "get_evergreen_refill_plan",
-        description: "Read-only evergreen refill dry-run planner. It performs no mutations, does not schedule, send, approve, prepare, or refresh credits, and writes a local dry-run journal file unless journal:false is passed.",
+        name: "get_refill_plan_v2",
+        description: "Read-only refill sends v2 dry-run planner across managed waterfall, dashboard evergreen, and active campaign lanes. It performs no mutations, does not schedule, send, approve, prepare, or refresh credits, and writes a local dry-run journal file unless journal:false is passed.",
         inputSchema: {
             type: "object",
             properties: {
@@ -136,6 +170,11 @@ export const evergreenRefillPlanToolDefinitions = [
                     type: "object",
                     description: "Optional synthetic v1 run state. When provided, replaces local lane-memory hints.",
                 },
+                intent: {
+                    type: "string",
+                    enum: ["auto", "evergreen", "plain", "active"],
+                    description: 'Planner intent. Defaults to "auto" for refill-sends-v2.',
+                },
                 journal: {
                     type: "boolean",
                     description: "Set false to skip the local dry-run journal write.",
@@ -150,19 +189,55 @@ export const evergreenRefillPlanToolDefinitions = [
         },
     },
 ];
-export async function getEvergreenRefillPlan(input) {
+export async function getRefillPlanV2(input) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
     if (!workspaceId) {
-        throw new Error("workspaceId is required for get_evergreen_refill_plan.");
+        throw new Error("workspaceId is required for get_refill_plan_v2.");
     }
     const runState = input.runState !== undefined
         ? input.runState
         : buildRunStateFromLocalHints(workspaceId);
-    const raw = await postEvergreenRefillPlan({
-        workspaceId,
-        senderIds: input.senderIds,
-        runState,
-    }, workspaceId);
+    let raw;
+    try {
+        raw = await postRefillPlanV2({
+            workspaceId,
+            intent: input.intent ?? "auto",
+            senderIds: input.senderIds,
+            runState,
+        }, workspaceId);
+    }
+    catch (error) {
+        if (!isWorkspaceAccessError(error))
+            throw error;
+        const guidance = error instanceof SellableApiError && error.guidance
+            ? error.guidance
+            : "The authenticated user is not a member of this workspace. Confirm the workspaceId or ask a workspace admin to add the user; re-login will not help.";
+        const warnings = [];
+        let journalPath = null;
+        if (input.journal !== false) {
+            try {
+                journalPath = writeWorkspaceAccessJournal({ workspaceId, guidance });
+            }
+            catch {
+                warnings.push("journalWriteFailed");
+            }
+        }
+        return {
+            readOnly: true,
+            blocker: "workspace_access",
+            workspaceId,
+            guidance,
+            warnings,
+            journalPath,
+            text: [
+                "Refill sends v2 dry-run blocked: workspace_access",
+                `Workspace: ${workspaceId}`,
+                guidance,
+                journalPath ? `Journal: ${journalPath}` : "Journal: not written",
+            ].join("\n"),
+            workspaceResolution: "explicit",
+        };
+    }
     const sanitized = sanitizeEvergreenRefillPlanResult(raw);
     const warnings = Array.isArray(sanitized.warnings)
         ? [...sanitized.warnings]
@@ -181,7 +256,7 @@ export async function getEvergreenRefillPlan(input) {
         }
     }
     const summary = [
-        "Evergreen refill dry-run plan:",
+        "Refill sends v2 dry-run plan:",
         ...planSummaryLines(sanitized),
         journalPath ? `Journal: ${journalPath}` : "Journal: not written",
     ].join("\n");
@@ -194,3 +269,5 @@ export async function getEvergreenRefillPlan(input) {
         workspaceResolution: "explicit",
     };
 }
+/** @deprecated Use getRefillPlanV2. */
+export const getEvergreenRefillPlan = getRefillPlanV2;

package/dist/tools/prompts.d.ts

@@ -137,7 +137,8 @@ export interface PostFindLeadsScoutRegistryResponse {
 }
 export declare const DEFAULT_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
 export declare const MAX_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
-export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
+export declare const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS: Record<string, string>;
+export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
 export declare const promptToolDefinitions: ({
     name: string;
     description: string;
@@ -181,7 +182,7 @@ export declare const promptToolDefinitions: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -216,7 +217,7 @@ export declare const promptToolDefinitions: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
+                enum: readonly ["building-gtm-tables", "content", "create-ab-test", "create-campaign", "create-campaign-brief", "create-campaign-v2", "create-campaign-v2-tail", "create-campaign-v2-validation", "create-evergreen-campaigns", "create-post", "create-rubric", "engage", "enrich-prospects", "fill-send-horizon", "find-leads", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-evergreen", "refill-sends-evergreen-workflow", "refill-sends-v2", "refill-sends-v2-workflow", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             assetPath: {

package/dist/tools/prompts.js

@@ -13,8 +13,10 @@ import { markCreateCampaignPromptLoaded, markResearchPromptLoaded, markSenderRes
 // ~3s.
 export const DEFAULT_SUBSKILL_PROMPT_CHUNK_CHARS = 48_000;
 export const MAX_SUBSKILL_PROMPT_CHUNK_CHARS = 48_000;
-const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS = {
+export const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS = {
     "generate-messages-compact": "generate-messages",
+    "refill-sends-evergreen": "refill-sends-v2",
+    "refill-sends-evergreen-workflow": "refill-sends-v2-workflow",
 };
 export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "building-gtm-tables",
@@ -40,6 +42,8 @@ export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "refill-sends",
     "refill-sends-evergreen",
     "refill-sends-evergreen-workflow",
+    "refill-sends-v2",
+    "refill-sends-v2-workflow",
     "refill-sends-workflow",
     "research",
     "research-prospect",

package/dist/tools/refill-executors.d.ts

@@ -0,0 +1,178 @@
+import { searchSignals } from "./leads.js";
+export type RefillSendsApprovalMode = "approve" | "mark_ready";
+export type PaidInmailRefreshAction = {
+    senderId: string;
+    actionKey?: string | null;
+    action?: Record<string, unknown>;
+};
+export type YoloPrimitiveExecution = {
+    enabled: true;
+    status: "no_action" | "read_only_reread" | "executed_and_reread" | "refused" | "skipped_after_paid_refresh";
+    selectedAction: Record<string, unknown> | null;
+    result?: unknown;
+    targetPlanReread: boolean;
+    refusalReason?: string;
+    postActionFirstAction?: unknown;
+} | {
+    enabled: false;
+    status: "not_run_without_yolo";
+    selectedAction: null;
+    targetPlanReread: false;
+};
+export type YoloPrimitiveAttempt = {
+    status: "no_action" | "read_only_reread" | "executed_and_reread" | "refused";
+    result?: unknown;
+    refusalReason?: string;
+};
+export type UserAddedRowsLimitPayload = {
+    error?: string;
+    code: "USER_ADDED_ROWS_LIMIT_EXCEEDED";
+    maxRows?: number;
+    currentRows?: number;
+    requestedRows?: number;
+    attemptedRows?: number;
+    remainingRows?: number;
+};
+export type PrepareRowSelector = {
+    type: "needsEnrichment";
+    limit?: number;
+} | {
+    type: "needsApproval";
+    limit?: number;
+} | {
+    type: "needsGeneratedMessage";
+    limit?: number;
+} | {
+    type: "reviewBatch";
+    limit?: number;
+} | {
+    type: "staleGeneratedMessages";
+    limit?: number;
+};
+type SignalDiscoveryTab = {
+    keyword?: string | null;
+    posts?: Array<{
+        id?: string | null;
+        isSelected?: boolean | null;
+    }>;
+};
+export type ApproveBatchResult = {
+    approved: number;
+    failed: number;
+    partial?: boolean;
+    scope?: string;
+    message?: string;
+};
+export type StartCampaignAuthority = {
+    laneChainCampaignIds: string[];
+    pinnedCampaignId: string | null;
+    planRevision: string | null;
+};
+export type StartCampaignPrimitiveResult = {
+    executed: false;
+    refused: true;
+    reason: "action_type_not_start_paused_campaign" | "campaign_not_in_pinned_lane_chain";
+    campaignId: string | null;
+    laneChainCampaignIds: string[];
+} | {
+    executed: false;
+    blocked: true;
+    reason: "start_route_rejected";
+    status: number;
+    body: string;
+    campaignId: string;
+} | {
+    executed: true;
+    type: "start_paused_campaign";
+    campaignId: string;
+    authorizedBy: {
+        planRevision: string | null;
+        action: Record<string, unknown>;
+    };
+    result: unknown;
+};
+type RerunErroredCellsOperation = {
+    columnRole: "icpScore" | "generateMessage";
+    rowSelector: {
+        type: "rowIds";
+        rowIds: string[];
+    };
+    cellIds: string[];
+};
+export type RerunErroredCellsPrimitiveResult = {
+    executed: false;
+    refused: true;
+    reason: "action_type_not_rerun_errored_cells" | "missing_bounded_operations";
+} | {
+    executed: true;
+    type: "rerun_errored_cells";
+    operations: Array<RerunErroredCellsOperation & {
+        result: unknown;
+    }>;
+};
+export declare function normalizeStrings(values: unknown): string[];
+export declare function sleep(ms: number): Promise<unknown>;
+export declare function recordValue(value: unknown): Record<string, unknown> | null;
+export declare function stringValue(value: unknown): string | null;
+export declare function numberValue(value: unknown): number | null;
+export declare function stringArray(value: unknown): string[];
+export declare function prepareRowSelectorValue(value: unknown): PrepareRowSelector | undefined;
+export declare function uniqueStrings(values: Array<string | null | undefined>): string[];
+export declare function userAddedRowsLimitPayloadFromError(error: unknown): UserAddedRowsLimitPayload | null;
+export declare function paidRefreshActionFrom(value: unknown): PaidInmailRefreshAction | null;
+export declare function collectPaidInmailRefreshActions(plan: unknown): PaidInmailRefreshAction[];
+export declare function firstGlobalAction(plan: unknown): Record<string, unknown> | null;
+export declare function actionIds(action: Record<string, unknown>): Record<string, unknown>;
+export declare function actionToolInput(action: Record<string, unknown>): Record<string, unknown>;
+export declare function actionCampaignId(action: Record<string, unknown>): string | null;
+export declare function actionTableId(action: Record<string, unknown>): string | null;
+export declare function actionSourceLeadListId(action: Record<string, unknown>): string | null;
+export declare function actionSenderId(action: Record<string, unknown>): string | null;
+export declare function actionActionType(action: Record<string, unknown>): string | null;
+export declare function actionSourceFingerprint(action: Record<string, unknown>): string | null;
+export declare function actionLeadSourceProvider(action: Record<string, unknown>): string | null;
+export declare function normalizedSignalKeyword(value: unknown): string | null;
+export declare function keywordsFromSignalTabs(tabs: SignalDiscoveryTab[]): string[];
+export declare function selectedPostIdsFromSignalTabs(tabs: SignalDiscoveryTab[]): string[];
+export declare function postIdsFromSignalSearch(summary: Awaited<ReturnType<typeof searchSignals>>, maxPosts: number, options?: {
+    excludePostIds?: string[];
+}): string[];
+export declare function maxSignalDiscoveryPostsForSourceLimit(sourceRowLimit: number): number;
+export declare function refillPrepareRequestHash(params: {
+    action: Record<string, unknown>;
+    campaignId: string;
+    tableId?: string;
+    approvalMode: RefillSendsApprovalMode;
+    rowSelector?: PrepareRowSelector;
+}): string;
+export declare function boundedApprovalLimit(action: Record<string, unknown>): number | null;
+export declare function approveGeneratedMessagesBatch(action: Record<string, unknown>, workspaceId?: string): Promise<{
+    status: "refused";
+    refusalReason: string;
+    result?: undefined;
+} | {
+    status: "executed_and_reread";
+    result: ApproveBatchResult;
+    refusalReason?: undefined;
+}>;
+export declare function continueSignalDiscoverySource(action: Record<string, unknown>, workspaceId?: string): Promise<YoloPrimitiveAttempt>;
+export declare function refreshPaidInmailCreditsWithRetry(senderId: string, workspaceId: string): Promise<{
+    receipt: import("./senders.js").RefreshPaidInmailCreditsResponse;
+    attempts: number;
+    errors: string[];
+} | {
+    receipt: null;
+    attempts: number;
+    errors: string[];
+}>;
+export declare function executeStartCampaignPrimitive(params: {
+    action: Record<string, unknown>;
+    authority: StartCampaignAuthority;
+    workspaceId?: string | null;
+}): Promise<StartCampaignPrimitiveResult>;
+export declare function executeRerunErroredCellsPrimitive(params: {
+    action: Record<string, unknown>;
+    workspaceId?: string | null;
+}): Promise<RerunErroredCellsPrimitiveResult>;
+export declare function executeOneYoloPrimitive(action: Record<string, unknown> | null, workspaceId?: string): Promise<YoloPrimitiveAttempt>;
+export {};