@sellable/mcp 0.1.511 → 0.1.513

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

@@ -0,0 +1,273 @@
+import * as path from "node:path";
+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";
+const KNOWN_TOP_LEVEL_FIELDS = [
+    "readOnly",
+    "generatedAt",
+    "bootstrap",
+    "plans",
+    "globalActionQueue",
+    "evergreen",
+    "planRevision",
+    "stateRevision",
+    "packet",
+    "sideEffects",
+    "warnings",
+];
+// MCP mirror maintenance note:
+// Evergreen rung vocabulary restatements track canonical EVERGREEN_RUNG_ORDER in
+// src/lib/workflow-tables/refill-target-plan.ts. pr1 token checks track
+// PR1_TOKEN_REGEX in src/lib/workflow-tables/plan-revision.ts.
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function deepClone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function sanitizeEvergreenRefillPlanResult(value) {
+    if (!isRecord(value))
+        return {};
+    const sanitized = {};
+    for (const key of KNOWN_TOP_LEVEL_FIELDS) {
+        if (value[key] !== undefined)
+            sanitized[key] = deepClone(value[key]);
+    }
+    return sanitized;
+}
+function buildRunStateFromLocalHints(workspaceId) {
+    const state = readRefillWorkspaceState(workspaceId);
+    return {
+        version: 1,
+        senderCursors: [],
+        laneCooldowns: state?.laneMemory ?? [],
+        passRates: state?.passRates ?? [],
+    };
+}
+async function postRefillPlanV2(body, workspaceId) {
+    const api = getApi();
+    const requestOptions = workspaceRequestOptions(workspaceId);
+    return requestOptions
+        ? api.post("/api/v3/mcp/evergreen-refill-plan", body, requestOptions)
+        : api.post("/api/v3/mcp/evergreen-refill-plan", body);
+}
+function planSummaryLines(result) {
+    const plans = Array.isArray(result.plans) ? result.plans : [];
+    return plans.flatMap((plan) => {
+        if (!isRecord(plan))
+            return [];
+        const itinerary = isRecord(plan.itinerary) ? plan.itinerary : null;
+        const chosen = isRecord(itinerary?.chosen) ? itinerary?.chosen : null;
+        const fallback = isRecord(itinerary?.fallback) ? itinerary?.fallback : null;
+        return [
+            `${String(plan.senderId ?? "unknown")}: ${String(chosen?.summary ?? "no chosen rung")}`,
+            fallback ? `fallback: ${String(fallback.trigger ?? "")}` : null,
+        ].filter((line) => Boolean(line));
+    });
+}
+function writeDryRunJournal(params) {
+    const created = createRunJournal({
+        workspaceId: params.workspaceId,
+        dryRun: true,
+    });
+    const bootstrap = isRecord(params.result.bootstrap)
+        ? params.result.bootstrap
+        : {};
+    appendJournalEvent(created.filePath, renderBootstrapSection({
+        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 ?? []),
+        creditSummary: JSON.stringify(bootstrap.paidCredit ?? []),
+    }));
+    const plans = Array.isArray(params.result.plans) ? params.result.plans : [];
+    for (const plan of plans) {
+        if (!isRecord(plan))
+            continue;
+        const itinerary = isRecord(plan.itinerary) ? plan.itinerary : {};
+        const chosen = isRecord(itinerary.chosen) ? itinerary.chosen : {};
+        const projected = Array.isArray(itinerary.projected)
+            ? itinerary.projected
+            : [];
+        const fallback = isRecord(itinerary.fallback) ? itinerary.fallback : {};
+        appendJournalEvent(created.filePath, renderPlanSection({
+            chosenSummary: String(chosen.summary ?? "No chosen rung"),
+            itinerarySummaries: projected
+                .filter(isRecord)
+                .map((entry) => String(entry.summary ?? "")),
+            fallbackSummary: String(fallback.trigger ?? ""),
+        }));
+    }
+    appendJournalEvent(created.filePath, renderTerminalSection({
+        summary: [
+            `planRevision=${String(params.result.planRevision ?? "")}`,
+            `stateRevision=${String(params.result.stateRevision ?? "")}`,
+            params.journalNote ?? null,
+        ]
+            .filter(Boolean)
+            .join(" "),
+    }));
+    appendIndexLine({
+        runId: created.runId,
+        fileName: path.basename(created.filePath),
+        workspaceId: params.workspaceId,
+        dryRun: true,
+        summary: "refill v2 dry-run",
+    });
+    return created.filePath;
+}
+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_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: {
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id.",
+                },
+                senderIds: {
+                    type: "array",
+                    items: { type: "string" },
+                },
+                runState: {
+                    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.",
+                },
+                journalNote: {
+                    type: "string",
+                    description: "Optional note appended to the terminal journal section.",
+                },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
+];
+export async function getRefillPlanV2(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    if (!workspaceId) {
+        throw new Error("workspaceId is required for get_refill_plan_v2.");
+    }
+    const runState = input.runState !== undefined
+        ? input.runState
+        : buildRunStateFromLocalHints(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]
+        : [];
+    let journalPath = null;
+    if (input.journal !== false) {
+        try {
+            journalPath = writeDryRunJournal({
+                workspaceId,
+                result: sanitized,
+                journalNote: input.journalNote,
+            });
+        }
+        catch {
+            warnings.push("journalWriteFailed");
+        }
+    }
+    const summary = [
+        "Refill sends v2 dry-run plan:",
+        ...planSummaryLines(sanitized),
+        journalPath ? `Journal: ${journalPath}` : "Journal: not written",
+    ].join("\n");
+    return {
+        ...sanitized,
+        warnings,
+        journalPath,
+        text: summary,
+        workspaceId,
+        workspaceResolution: "explicit",
+    };
+}
+/** @deprecated Use getRefillPlanV2. */
+export const getEvergreenRefillPlan = getRefillPlanV2;

package/dist/tools/leads.d.ts

@@ -70,6 +70,7 @@ export type SalesNavSearchInput = {
 };
 export type ProspeoSearchInput = {
     filters: Record<string, unknown>;
+    workspaceId?: string;
     page?: number;
     searchId?: string;
     campaignOfferId?: string;
@@ -166,6 +167,7 @@ export type ImportLeadsInput = {
 };
 export type CancelLeadImportInput = {
     campaignOfferId: string;
+    workspaceId?: string;
     tableId: string;
     provider: "apollo" | "prospeo" | "sales-nav";
 };
@@ -278,6 +280,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -474,6 +477,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -569,6 +573,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -736,6 +741,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -845,6 +851,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -963,6 +970,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -1070,6 +1078,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -1182,6 +1191,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -1282,6 +1292,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -2174,6 +2185,7 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -2283,6 +2295,7 @@ export declare const leadToolDefinitions: ({
             seedDomains?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3269,6 +3282,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             searchName: {
                 type: string;
                 description: string;
@@ -3493,6 +3510,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             sourceLeadListId?: undefined;
             targetLeadCount?: undefined;
@@ -3525,6 +3543,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             provider: {
                 type: string;
                 enum: string[];
@@ -3668,6 +3690,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             tableId: {
                 type: string;
                 description: string;
@@ -3766,6 +3792,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             sourceLeadListId: {
                 type: string;
                 description: string;
@@ -3998,6 +4028,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4095,6 +4126,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4554,6 +4586,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     error: string;
@@ -4603,6 +4636,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: "signal-discovery" | "sales-nav" | "prospeo";
@@ -4652,6 +4686,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: string;
@@ -4687,6 +4722,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: string;
@@ -4742,6 +4778,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: string;
@@ -4771,6 +4808,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     needsInvalidPostConfirmation?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: "sales-nav" | "prospeo";
@@ -4820,11 +4858,13 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     warnings?: undefined;
     targetLeadCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: "sales-nav" | "prospeo";
     leadListId: string;
     createdLeadList: any;
+    selectedLeadListIdUpdated: boolean;
     jobResult: any;
     jobId: string | undefined;
     targetLeadCount: number | null;