@sellable/mcp 0.1.510 → 0.1.512

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

@@ -0,0 +1,196 @@
+import * as path from "node:path";
+import { getApi } 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 postEvergreenRefillPlan(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: "Evergreen refill dry-run bootstrap",
+        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: "evergreen refill dry-run",
+    });
+    return created.filePath;
+}
+export const evergreenRefillPlanToolDefinitions = [
+    {
+        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.",
+        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.",
+                },
+                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 getEvergreenRefillPlan(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    if (!workspaceId) {
+        throw new Error("workspaceId is required for get_evergreen_refill_plan.");
+    }
+    const runState = input.runState !== undefined
+        ? input.runState
+        : buildRunStateFromLocalHints(workspaceId);
+    const raw = await postEvergreenRefillPlan({
+        workspaceId,
+        senderIds: input.senderIds,
+        runState,
+    }, workspaceId);
+    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 = [
+        "Evergreen refill dry-run plan:",
+        ...planSummaryLines(sanitized),
+        journalPath ? `Journal: ${journalPath}` : "Journal: not written",
+    ].join("\n");
+    return {
+        ...sanitized,
+        warnings,
+        journalPath,
+        text: summary,
+        workspaceId,
+        workspaceResolution: "explicit",
+    };
+}

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;
@@ -127,7 +128,6 @@ export type LookupSalesNavFilterInput = {
 };
 export type SignalSearchInput = {
     type?: "keywords" | "profile" | "post" | "company";
-    workspaceId?: string;
     keywords?: Array<{
         keyword: string;
         id?: string;
@@ -167,6 +167,7 @@ export type ImportLeadsInput = {
 };
 export type CancelLeadImportInput = {
     campaignOfferId: string;
+    workspaceId?: string;
     tableId: string;
     provider: "apollo" | "prospeo" | "sales-nav";
 };
@@ -193,7 +194,6 @@ export type ConfirmLeadListInput = {
 };
 export type SelectPromisingPostsInput = {
     campaignOfferId: string;
-    workspaceId?: string;
     selections: Array<{
         postId: string;
         reason: string;
@@ -280,6 +280,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -476,6 +477,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -571,6 +573,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -738,6 +741,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -847,6 +851,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -965,6 +970,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -1072,6 +1078,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -1184,6 +1191,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -1284,6 +1292,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -2176,6 +2185,7 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -2285,6 +2295,7 @@ export declare const leadToolDefinitions: ({
             seedDomains?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3271,6 +3282,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             searchName: {
                 type: string;
                 description: string;
@@ -3495,6 +3510,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             sourceLeadListId?: undefined;
             targetLeadCount?: undefined;
@@ -3527,6 +3543,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             provider: {
                 type: string;
                 enum: string[];
@@ -3670,6 +3690,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             tableId: {
                 type: string;
                 description: string;
@@ -3768,6 +3792,10 @@ export declare const leadToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             sourceLeadListId: {
                 type: string;
                 description: string;
@@ -4000,6 +4028,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4097,6 +4126,7 @@ export declare const leadToolDefinitions: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4556,6 +4586,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     error: string;
@@ -4605,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";
@@ -4654,6 +4686,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: string;
@@ -4689,6 +4722,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: string;
@@ -4744,6 +4778,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     targetLeadCount?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: string;
@@ -4773,6 +4808,7 @@ export declare function importLeads(input: ImportLeadsInput): Promise<{
     needsInvalidPostConfirmation?: undefined;
     existingCount?: undefined;
     createdLeadList?: undefined;
+    selectedLeadListIdUpdated?: undefined;
     jobResult?: undefined;
 } | {
     provider: "sales-nav" | "prospeo";
@@ -4822,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;