@sellable/mcp 0.1.511 → 0.1.513

package/dist/tools/leads.js

@@ -1970,6 +1970,10 @@ export const leadToolDefinitions = [
                     type: "string",
                     description: "Campaign offer ID to associate search",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.",
+                },
                 searchName: {
                     type: "string",
                     description: "Optional name for the search. Use descriptive names that encode ICP intent (e.g., 'Fintech Compliance Directors 201-1000 US').",
@@ -2077,6 +2081,10 @@ export const leadToolDefinitions = [
                     type: "string",
                     description: "Campaign offer ID",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.",
+                },
                 provider: {
                     type: "string",
                     enum: ["apollo", "sales-nav", "prospeo", "signal-discovery"],
@@ -2151,6 +2159,10 @@ export const leadToolDefinitions = [
                     type: "string",
                     description: "Campaign offer ID. Required for audit context; not used to resolve provider or tableId.",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.",
+                },
                 tableId: {
                     type: "string",
                     description: "Lead list (workflow table) ID to cancel. Required; callers have this from campaign context.",
@@ -2174,6 +2186,10 @@ export const leadToolDefinitions = [
                     type: "string",
                     description: "Campaign offer ID",
                 },
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.",
+                },
                 sourceLeadListId: {
                     type: "string",
                     description: "Lead list ID to import into campaign. If omitted, uses campaign.selectedLeadListId.",
@@ -3118,6 +3134,8 @@ export async function searchProspeo(input) {
         campaignOfferId: input?.campaignOfferId,
     });
     const api = getApi();
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    const requestOptions = workspaceRequestOptions(workspaceId);
     const rawInput = input;
     if ("domains" in rawInput) {
         throw new Error("search_prospeo does not accept raw domains. Use load_csv_domains or save_domain_filters for known domain lists. For generated company/account lookalikes, use search_prospeo_companies, then confirm_prospeo_company_accounts, then pass the returned domainFilterId.");
@@ -3128,9 +3146,11 @@ export async function searchProspeo(input) {
         nestedCompany?.names !== undefined) {
         throw new Error("search_prospeo does not accept filters.company.websites or filters.company.names. For known accounts, resolve names/domains into a domainFilterId with load_csv_domains or save_domain_filters. For company/account lookalikes, use search_prospeo_companies first, then confirm_prospeo_company_accounts.");
     }
-    const safeInput = normalizeProspeoSearchInputForMcp(input);
+    const { workspaceId: _workspaceId, ...safeInput } = normalizeProspeoSearchInputForMcp(input);
     try {
-        const response = await api.post(`/api/v3/prospeo/search`, safeInput);
+        const response = requestOptions
+            ? await api.post(`/api/v3/prospeo/search`, safeInput, requestOptions)
+            : await api.post(`/api/v3/prospeo/search`, safeInput);
         return compactProspeoSearchResponse(response);
     }
     catch (error) {
@@ -3138,7 +3158,9 @@ export async function searchProspeo(input) {
         if (!fallbackInput) {
             throw error;
         }
-        const fallbackResponse = await api.post(`/api/v3/prospeo/search`, fallbackInput);
+        const fallbackResponse = requestOptions
+            ? await api.post(`/api/v3/prospeo/search`, fallbackInput, requestOptions)
+            : await api.post(`/api/v3/prospeo/search`, fallbackInput);
         const keyword = String(fallbackInput.filters.person_name_or_job_title ?? "title keyword");
         return compactProspeoSearchResponse(fallbackResponse, {
             warnings: [
@@ -3673,6 +3695,15 @@ export async function searchSignals(input) {
 }
 export async function importLeads(input) {
     const api = getApi();
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    const requestOptions = workspaceRequestOptions(workspaceId);
+    const apiGet = (path) => requestOptions ? api.get(path, requestOptions) : api.get(path);
+    const apiPost = (path, body) => requestOptions
+        ? api.post(path, body, requestOptions)
+        : api.post(path, body);
+    const apiPut = (path, body) => requestOptions
+        ? api.put(path, body, requestOptions)
+        : api.put(path, body);
     const { campaignOfferId, currentStep, sourceLeadListId: inputSourceLeadListId, searchId, targetLeadCount, mode, searchName, leadListName, headlineICPCriteria, targetEngagerCount, maxPostsToScrape, allowInvalidSignalPosts, rubricGuidelines, confirmed, } = input;
     assertInteractionApproval({
         campaignId: campaignOfferId,
@@ -3685,9 +3716,12 @@ export async function importLeads(input) {
     let provider = input.provider;
     let campaignCurrentStep;
     let campaignSelectedLeadListId;
-    if (!provider || currentStep === undefined || mode === undefined) {
+    if (!provider ||
+        currentStep === undefined ||
+        mode === undefined ||
+        Boolean(inputSourceLeadListId)) {
         // Pull campaign once when we need provider or to determine default step behavior.
-        const campaign = await api.get(`/api/v2/campaign-offers/${campaignOfferId}`);
+        const campaign = await apiGet(`/api/v2/campaign-offers/${campaignOfferId}`);
         if (!provider) {
             provider = normalizeImportProvider(campaign.leadSourceProvider);
         }
@@ -3809,7 +3843,7 @@ export async function importLeads(input) {
         const effectiveTargetEngagerCount = normalizePositiveInteger(targetEngagerCount) ?? null;
         // Get selected posts from the campaign's signal search tabs
         // Note: API returns flat fields (postUrl, postContent, authorName, etc.)
-        const tabsResponse = await api.get(`/api/v3/campaigns/${campaignOfferId}/signal-discovery/tabs`);
+        const tabsResponse = await apiGet(`/api/v3/campaigns/${campaignOfferId}/signal-discovery/tabs`);
         // Collect all selected posts, mapping from API format to signal-leads/create format
         const selectedPosts = [];
         for (const tab of tabsResponse.tabs || []) {
@@ -3935,7 +3969,7 @@ export async function importLeads(input) {
             ? headlineICPCriteria
             : rubricGuidelines;
         // Start the scrape job
-        const result = await api.post(`/api/v3/campaigns/${campaignOfferId}/signal-leads/create`, {
+        const result = await apiPost(`/api/v3/campaigns/${campaignOfferId}/signal-leads/create`, {
             posts: postsToScrape,
             targetEngagerCount: importSelection.targetEngagerCount ?? undefined,
             ...(effectiveHeadlineICPCriteria &&
@@ -3948,7 +3982,7 @@ export async function importLeads(input) {
         });
         // CRITICAL: Update selectedLeadListId so UI subscribes to correct table
         // This enables realtime updates in LeadListCanvas
-        await api.put(`/api/v2/campaign-offers/${campaignOfferId}`, {
+        await apiPut(`/api/v2/campaign-offers/${campaignOfferId}`, {
             selectedLeadListId: result.tableId,
             ...(shouldSetCurrentStep ? { currentStep: postImportCurrentStep } : {}),
             ...(shouldSetCurrentStep
@@ -3992,7 +4026,7 @@ export async function importLeads(input) {
         const fallbackName = leadListName ||
             (searchName ? `${providerLabel} - ${searchName}` : undefined) ||
             `${providerLabel} Import ${new Date().toISOString().slice(0, 10)}`;
-        const createResult = await api.post(`/api/v3/lead-lists`, {
+        const createResult = await apiPost(`/api/v3/lead-lists`, {
             name: fallbackName,
             templateType: "lead_list",
         });
@@ -4009,7 +4043,7 @@ export async function importLeads(input) {
         const startImport = async () => {
             if (provider === "sales-nav") {
                 // Sales Nav export flow
-                return api.post(`/api/v3/sales-nav/export`, {
+                return apiPost(`/api/v3/sales-nav/export`, {
                     searchId,
                     workflowTableId: leadListId,
                     campaignOfferId,
@@ -4018,7 +4052,7 @@ export async function importLeads(input) {
                 });
             }
             if (provider === "prospeo") {
-                return api.post(`/api/v3/lead-lists/${leadListId}/prospeo-import/start`, {
+                return apiPost(`/api/v3/lead-lists/${leadListId}/prospeo-import/start`, {
                     searchId,
                     campaignOfferId,
                     targetLeadCount: cappedTargetLeadCount ?? defaultProviderSourceListTarget,
@@ -4069,24 +4103,30 @@ export async function importLeads(input) {
             throw error;
         }
     }
-    // Update selectedLeadListId so UI subscribes to the source lead list
-    // This enables realtime updates while the import job runs.
-    await api.put(`/api/v2/campaign-offers/${campaignOfferId}`, {
-        selectedLeadListId: leadListId,
-        ...(shouldSetCurrentStep ? { currentStep: effectiveCurrentStep } : {}),
-        ...(shouldSetCurrentStep
-            ? {
-                watchNarration: buildSourceImportWatchNarration({
-                    provider,
-                    targetLeadCount: cappedTargetLeadCount ?? null,
-                }),
-            }
-            : {}),
-    });
+    const selectedLeadListAlreadyCurrent = campaignSelectedLeadListId === leadListId;
+    const shouldUpdateSelectedLeadList = !selectedLeadListAlreadyCurrent || shouldSetCurrentStep;
+    if (shouldUpdateSelectedLeadList) {
+        // Update selectedLeadListId so UI subscribes to the source lead list.
+        // For refill same-source continuations with currentStep:null this is often
+        // already true, so avoid a redundant campaign write.
+        await apiPut(`/api/v2/campaign-offers/${campaignOfferId}`, {
+            selectedLeadListId: leadListId,
+            ...(shouldSetCurrentStep ? { currentStep: effectiveCurrentStep } : {}),
+            ...(shouldSetCurrentStep
+                ? {
+                    watchNarration: buildSourceImportWatchNarration({
+                        provider,
+                        targetLeadCount: cappedTargetLeadCount ?? null,
+                    }),
+                }
+                : {}),
+        });
+    }
     return {
         provider,
         leadListId,
         createdLeadList,
+        selectedLeadListIdUpdated: shouldUpdateSelectedLeadList,
         jobResult,
         jobId,
         targetLeadCount: cappedTargetLeadCount ?? null,
@@ -4106,13 +4146,17 @@ export async function cancelLeadImport(input) {
         throw new Error(`cancel_lead_import: provider must be 'apollo', 'prospeo', or 'sales-nav' (got '${input.provider}'). Signal Discovery is not supported.`);
     }
     const api = getApi();
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    const requestOptions = workspaceRequestOptions(workspaceId);
     const path = input.provider === "apollo"
         ? `/api/v3/lead-lists/${input.tableId}/apollo-import/cancel`
         : input.provider === "sales-nav"
             ? `/api/v3/lead-lists/${input.tableId}/sales-nav-import/cancel`
             : `/api/v3/lead-lists/${input.tableId}/prospeo-import/cancel`;
     try {
-        const result = await api.post(path, {});
+        const result = await (requestOptions
+            ? api.post(path, {}, requestOptions)
+            : api.post(path, {}));
         return {
             cancelled: true,
             provider: input.provider,
@@ -4147,7 +4191,7 @@ export async function confirmLeadList(input) {
     });
     let resolvedLeadListId = sourceLeadListId;
     let resolvedProvider;
-    if (!resolvedLeadListId || currentStep === undefined || !resolvedProvider) {
+    if (!resolvedLeadListId || currentStep === undefined) {
         const campaign = requestOptions
             ? await api.get(`/api/v2/campaign-offers/${campaignOfferId}`, requestOptions)
             : await api.get(`/api/v2/campaign-offers/${campaignOfferId}`);
@@ -4202,6 +4246,9 @@ export async function confirmLeadList(input) {
         ? await api.get(`/api/v3/workflow-tables/${resolvedLeadListId}?mode=meta`, requestOptions)
         : await api.get(`/api/v3/workflow-tables/${resolvedLeadListId}?mode=meta`);
     const leadListConfig = leadListMeta.table?.config ?? null;
+    if (!resolvedProvider) {
+        resolvedProvider = normalizeImportProvider(leadListConfig?.importProvider);
+    }
     const leadListRowCount = leadListMeta.rowCount ?? 0;
     const importProgress = leadListConfig?.importProgress ?? null;
     const signalSourceTargetLeadCount = resolvedProvider === "signal-discovery" &&
@@ -4431,12 +4478,16 @@ export async function confirmLeadList(input) {
         .filter((cellId) => typeof cellId === "string");
     let recordedReviewBatch = null;
     if (campaignTableId && reviewBatchRowIds.length > 0) {
-        const recordResult = await api.post("/api/v3/mcp/campaign-processing", {
+        const recordBody = {
             action: "recordReviewBatch",
             tableId: campaignTableId,
             rowIds: reviewBatchRowIds,
             enrichCellIds: reviewBatchEnrichCellIds,
-        });
+            ...(workspaceId ? { workspaceId } : {}),
+        };
+        const recordResult = await (requestOptions
+            ? api.post("/api/v3/mcp/campaign-processing", recordBody, requestOptions)
+            : api.post("/api/v3/mcp/campaign-processing", recordBody));
         recordedReviewBatch = recordResult.reviewBatch ?? null;
     }
     const compactReviewBatch = {
@@ -4474,7 +4525,7 @@ export async function confirmLeadList(input) {
     // campaign table id makes that endpoint 404 with "Lead list not found"
     // and silently breaks the Leads → Filter Continue button.
     if (shouldSetCurrentStep) {
-        await api.put(`/api/v2/campaign-offers/${campaignOfferId}`, {
+        const updateBody = {
             currentStep: effectiveCurrentStep,
             ...(effectiveCurrentStep === "filter-choice"
                 ? {
@@ -4485,7 +4536,11 @@ export async function confirmLeadList(input) {
                     }),
                 }
                 : {}),
-        });
+            ...(workspaceId ? { workspaceId } : {}),
+        };
+        await (requestOptions
+            ? api.put(`/api/v2/campaign-offers/${campaignOfferId}`, updateBody, requestOptions)
+            : api.put(`/api/v2/campaign-offers/${campaignOfferId}`, updateBody));
     }
     return {
         sourceLeadListId: resolvedLeadListId,

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-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-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-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",
@@ -38,6 +40,10 @@ export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "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",

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

@@ -0,0 +1,28 @@
+type RefillSendsEvergreenInput = {
+    workspaceId?: string;
+};
+export declare const refillSendsEvergreenToolDefinitions: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+}[];
+export declare function refillSendsEvergreenCommand(input: RefillSendsEvergreenInput): {
+    readOnly: boolean;
+    workspaceId: string | null;
+    firstOperationalSteps: string[];
+    approvalContract: string;
+    forbiddenActions: string[];
+    fillWindow: string;
+    hostExamples: string[];
+};
+export {};

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

@@ -0,0 +1,47 @@
+export const refillSendsEvergreenToolDefinitions = [
+    {
+        name: "refill_sends_evergreen",
+        description: "Read-only Phase 85 evergreen refill command contract. It performs no mutations and only tells the operator to call get_evergreen_refill_plan for a dry-run packet and journal.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id.",
+                },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
+];
+export function refillSendsEvergreenCommand(input) {
+    return {
+        readOnly: true,
+        workspaceId: input.workspaceId ?? null,
+        firstOperationalSteps: [
+            "Call get_evergreen_refill_plan with the explicit workspaceId.",
+            "Read the returned packet, globalActionQueue, per-sender plans, and itinerary before taking any action.",
+            "Review the dry-run journal file path returned by get_evergreen_refill_plan.",
+            "Phase 85 is PLAN-ONLY; execution arrives in Phase 86.",
+        ],
+        approvalContract: "Nothing is approved or executable in Phase 85. The evergreen command is read-only; Phase 86 introduces execution approval.",
+        forbiddenActions: [
+            "Do not schedule sends.",
+            "Do not send messages.",
+            "Do not approve messages.",
+            "Do not prepare messages.",
+            "Do not start or launch campaigns.",
+            "Do not create campaigns.",
+            "Do not switch providers or source families.",
+            "Do not lower paid InMail thresholds.",
+            "Do not refresh paid InMail credits.",
+            "Do not write scheduler fields.",
+        ],
+        fillWindow: "Use only the target window and caps returned by get_evergreen_refill_plan.",
+        hostExamples: [
+            "refill_sends_evergreen({ workspaceId })",
+            "get_evergreen_refill_plan({ workspaceId })",
+        ],
+    };
+}

package/dist/tools/refill-sends-v2.d.ts

@@ -0,0 +1,28 @@
+type RefillSendsV2Input = {
+    workspaceId?: string;
+};
+export declare const refillSendsV2ToolDefinitions: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+}[];
+export declare function refillSendsV2Command(input: RefillSendsV2Input): {
+    readOnly: boolean;
+    workspaceId: string | null;
+    firstOperationalSteps: string[];
+    approvalContract: string;
+    forbiddenActions: string[];
+    fillWindow: string;
+    hostExamples: string[];
+};
+export {};

package/dist/tools/refill-sends-v2.js

@@ -0,0 +1,49 @@
+export const refillSendsV2ToolDefinitions = [
+    {
+        name: "refill_sends_v2",
+        description: "Read-only refill sends v2 command contract. It performs no mutations and tells the operator to call get_refill_plan_v2 for a dry-run packet and journal across managed waterfall, dashboard evergreen, and active campaign lanes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id.",
+                },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
+];
+export function refillSendsV2Command(input) {
+    return {
+        readOnly: true,
+        workspaceId: input.workspaceId ?? null,
+        firstOperationalSteps: [
+            "Call get_refill_plan_v2 first with the explicit workspaceId.",
+            "Read the returned packet, globalActionQueue, per-sender plans, laneOrder source labels, laneChain values, and itinerary before taking any action.",
+            "Confirm which lane source was selected for each sender: managed_waterfall, dashboard_evergreen, or active_campaign.",
+            "Review the refill v2 dry-run journal file path returned by get_refill_plan_v2.",
+            "If the packet reports no_refillable_campaigns or workspace_access, stop and report that blocker instead of mutating.",
+            "This command is PLAN-ONLY; execution arrives in Phase 86.",
+        ],
+        approvalContract: "Nothing is approved or executable in Phase 87. The refill_sends_v2 command is read-only; Phase 86 introduces execution approval.",
+        forbiddenActions: [
+            "Do not schedule sends.",
+            "Do not send messages.",
+            "Do not approve messages.",
+            "Do not prepare messages.",
+            "Do not start or launch campaigns.",
+            "Do not create campaigns.",
+            "Do not switch providers or source families.",
+            "Do not lower paid InMail thresholds.",
+            "Do not refresh paid InMail credits.",
+            "Do not write scheduler fields.",
+        ],
+        fillWindow: "Use only the target window and caps returned by get_refill_plan_v2.",
+        hostExamples: [
+            "refill_sends_v2({ workspaceId })",
+            "get_refill_plan_v2({ workspaceId })",
+        ],
+    };
+}