@sellable/mcp 0.1.511 → 0.1.512

package/dist/tools/registry.d.ts

@@ -236,7 +236,7 @@ export declare const allTools: ({
         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-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -271,7 +271,7 @@ export declare const allTools: ({
         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-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             assetPath: {
@@ -474,39 +474,6 @@ export declare const allTools: ({
         required: string[];
         additionalProperties: boolean;
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            intent: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            campaignId: {
-                type: string;
-                description: string;
-            };
-            tableId: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;
@@ -624,45 +591,6 @@ export declare const allTools: ({
     inputSchema: {
         type: string;
         properties: {
-            capacityRequests: {
-                type: string;
-                minItems: number;
-                items: {
-                    type: string;
-                    properties: {
-                        senderId: {
-                            type: string;
-                            description: string;
-                        };
-                        actionType: {
-                            type: string;
-                            enum: string[];
-                            description: string;
-                        };
-                        cellId: {
-                            type: string;
-                            description: string;
-                        };
-                        columnId: {
-                            type: string;
-                            description: string;
-                        };
-                    };
-                    required: string[];
-                    additionalProperties: boolean;
-                };
-                description: string;
-            };
-            targetDate: {
-                type: string;
-                pattern: string;
-                description: string;
-            };
-            mode: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
             workspaceId: {
                 type: string;
                 description: string;
@@ -2381,24 +2309,6 @@ export declare const allTools: ({
         };
         required: string[];
     };
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            senderId: {
-                type: string;
-                description: string;
-            };
-            workspaceId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-        additionalProperties: boolean;
-    };
 } | {
     name: string;
     description: string;
@@ -3031,6 +2941,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3227,6 +3138,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3322,6 +3234,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3489,6 +3402,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3598,6 +3512,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3716,6 +3631,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3823,6 +3739,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -3935,6 +3852,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4035,6 +3953,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -4927,6 +4846,7 @@ export declare const allTools: ({
             exclude?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -5036,6 +4956,7 @@ export declare const allTools: ({
             seedDomains?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -6022,6 +5943,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             searchName: {
                 type: string;
                 description: string;
@@ -6246,6 +6171,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             sourceLeadListId?: undefined;
             targetLeadCount?: undefined;
@@ -6278,6 +6204,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             provider: {
                 type: string;
                 enum: string[];
@@ -6421,6 +6351,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             tableId: {
                 type: string;
                 description: string;
@@ -6519,6 +6453,10 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            workspaceId: {
+                type: string;
+                description: string;
+            };
             sourceLeadListId: {
                 type: string;
                 description: string;
@@ -6751,6 +6689,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;
@@ -6848,6 +6787,7 @@ export declare const allTools: ({
             previewOnly?: undefined;
             companySearchToken?: undefined;
             selectedCompanyIds?: undefined;
+            workspaceId?: undefined;
             domainFilterId?: undefined;
             type?: undefined;
             profileUrl?: undefined;

package/dist/tools/registry.js

@@ -33,6 +33,8 @@ import { onDemandToolDefinitions } from "./one-off.js";
 import { processingToolDefinitions } from "./processing.js";
 import { promptToolDefinitions } from "./prompts.js";
 import { readinessToolDefinitions } from "./readiness.js";
+import { evergreenRefillPlanToolDefinitions } from "./evergreen-refill-plan.js";
+import { refillSendsEvergreenToolDefinitions } from "./refill-sends-evergreen.js";
 import { refillTargetPlanToolDefinitions } from "./refill-target-plan.js";
 import { refillSendsToolDefinitions } from "./refill-sends.js";
 import { rowToolDefinitions } from "./rows.js";
@@ -52,9 +54,11 @@ export const allTools = [
     ...campaignAbTestToolDefinitions,
     ...campaignFillRoutingToolDefinitions,
     ...campaignRefillStateToolDefinitions,
+    ...evergreenRefillPlanToolDefinitions,
     ...refillTargetPlanToolDefinitions,
     ...schedulerFillCapacityToolDefinitions,
     ...refillSendsToolDefinitions,
+    ...refillSendsEvergreenToolDefinitions,
     ...setupEvergreenCampaignsToolDefinitions,
     ...campaignHorizonFillToolDefinitions,
     ...campaignMessagePreparationToolDefinitions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.511",
+  "version": "0.1.512",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/refill-sends-evergreen/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: refill-sends-evergreen
+description: Plan evergreen waterfall send refill work through the Phase 85 dry-run workflow.
+visibility: public
+allowed-tools:
+  - mcp__sellable__refill_sends_evergreen
+  - mcp__sellable__get_evergreen_refill_plan
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__get_subskill_asset
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__list_workspaces
+  - mcp__sellable__get_workspace
+---
+
+# Refill Sends Evergreen
+
+Use this public command wrapper for evergreen waterfall refill requests such as
+"refill evergreen", "fill evergreen senders", "load evergreen lanes", or
+"plan evergreen refill".
+
+Host command names:
+
+- Claude Code: `/sellable:refill-sends-evergreen`
+- Codex: `$sellable:refill-sends-evergreen`
+
+Phase 85 is read-only, dry-run, zero mutations. It plans the deterministic
+waterfall-ladder refill packet and writes a local dry-run journal, but it does
+not prepare messages, approve messages, start campaigns, schedule sends, send
+messages, refresh paid InMail credit facts, create campaigns, or change source
+configuration. Execution ships in the follow-up phase.
+
+## Entry
+
+Resolve the explicit `workspaceId` from the request, automation config, or
+active workspace readback. Scheduled or autonomous usage must carry
+`workspaceId` on every tool call. If the workspace is missing or ambiguous, stop
+with `WORKSPACE_REQUIRED`; do not switch the shared active workspace.
+
+Start with the command contract:
+
+```text
+refill_sends_evergreen({ workspaceId })
+```
+
+Then load the internal workflow prompt and flow asset:
+
+```text
+get_subskill_prompt({ subskillName: "refill-sends-evergreen-workflow" })
+get_subskill_asset({ subskillName: "refill-sends-evergreen-workflow", assetPath: "core/flow.v1.json" })
+```
+
+Continue both loads until `hasMore:false`; parse the flow JSON and verify
+`workflow:"refill-sends-evergreen-workflow"` with a `v1` version before the
+planner call.
+
+Call the dry-run planner with the explicit workspace id:
+
+```text
+get_evergreen_refill_plan({ workspaceId, senderIds?, runState?, journal?, journalNote? })
+```
+
+Use `senderIds` only when the user scoped the request to exact senders. Use
+`runState` only for an explicit what-if dry run; otherwise let the MCP read
+local lane memory hints. Leave `journal` enabled unless the user specifically
+asked for no local journal.
+
+## Report
+
+Review the returned packet before giving a recommendation:
+
+- `planRevision` starts with `pr1:`.
+- `stateRevision` identifies the current readback.
+- `packet` is the operator-facing facts receipt.
+- `plans[]` contains per-sender lane decisions and itinerary details.
+- `globalActionQueue[]` is a dry-run sequence only in Phase 85.
+- `evergreen.enumeratedRungs` and each action's `evergreenRung` map to the
+  locked ladder from the workflow asset.
+- `journalPath` points to the dry-run markdown journal written by the MCP.
+- `sideEffects` must be all false.
+
+Report campaign names and sender names first, ids second. Include the chosen
+rung, the itinerary, the plan revision, the journal path, and any blockers or
+warnings. Stop after the report; do not execute the action queue in Phase 85.

package/skills/refill-sends-evergreen-workflow/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: refill-sends-evergreen-workflow
+description: Internal read-only workflow for evergreen waterfall refill dry-run planning.
+visibility: internal
+allowed-tools:
+  - mcp__sellable__refill_sends_evergreen
+  - mcp__sellable__get_evergreen_refill_plan
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__get_subskill_asset
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__list_workspaces
+  - mcp__sellable__get_workspace
+---
+
+# Refill Sends Evergreen Workflow
+
+This internal workflow is the Phase 85 plan surface for evergreen waterfall
+refill. It is read-only, dry-run, zero mutations. The workflow has three gates:
+bootstrap, plan, and report.
+
+Runtime flow asset: after loading this prompt, load
+`get_subskill_asset({ subskillName: "refill-sends-evergreen-workflow", assetPath: "core/flow.v1.json" })`
+through MCP, continue chunks until `hasMore:false`, parse the JSON, and verify
+`workflow:"refill-sends-evergreen-workflow"` with a `v1` version before any
+planner call. If the asset cannot load or parse, stop with
+`blocked:evergreen_refill_workflow_asset_unavailable`; do not emulate it from
+local files or memory.
+
+## G0 Bootstrap Facts
+
+Resolve the request-scoped `workspaceId` using read-only auth and workspace
+tools. Scheduled or autonomous runs must not rely on implicit workspace state.
+Call `refill_sends_evergreen({ workspaceId })` first to receive the command
+contract, then call `get_evergreen_refill_plan({ workspaceId })` for the dry-run
+packet.
+
+Optional inputs:
+
+- `senderIds`: exact sender scope when the user named senders.
+- `runState`: synthetic v1 lane memory for what-if dry runs. Use it only when
+  the user intentionally wants a hypothetical cursor, pin, or cooldown state.
+- `journal:false`: skip the local journal only when explicitly requested.
+- `journalNote`: append operator context to the dry-run terminal section.
+
+## G1 Evergreen Ladder
+
+The planner chooses from this locked rung order:
+
+1. `start_campaign`: a paused selected lane has scheduler-ready supply but must
+   be live before the scheduler can pick it up.
+2. `approve_messages`: generated rows are ready for a bounded approval step.
+3. `wait_for_active_work`: enrichment, generation, import, or preparation is
+   already active, so the next honest action is to wait for that work to finish.
+4. `enrich_more`: exact-set enrichment can close the current ready gap.
+5. `reconcile_source_copy`: same-source rows exist and can be copied without
+   changing source family or source fingerprint.
+6. `add_leads_same_source`: the same source path can add bounded new supply.
+7. `paid_lane_fallback`: paid InMail is blocked or below threshold, so the same
+   waterfall can fall back to an existing supported lane.
+8. `next_campaign`: the current lane is exhausted, cooling down, pinned away, or
+   unsafe, and the next surviving campaign lane should be inspected.
+9. `wait_for_scheduler`: ready or projected supply covers the target, and only
+   scheduler pickup remains.
+10. `done`: the sender or lane is complete for the selected target window, or a
+    scheduler cap makes additional preparation unnecessary.
+
+Forward-only lane rule: a lane can move to a later rung or a later surviving
+campaign, but the dry-run packet must not jump backward to invent work that the
+facts do not support. Pinned-campaign rule: a pinned campaign stays selected
+until the planner proves a blocker, cooldown, exhaustion, or safer next lane.
+Capped-is-complete rule: when scheduler capacity is lower than the requested
+target and ready/projected coverage satisfies that cap, report `done` with the
+cap reason. Honest-itinerary rule: show what was checked, what was skipped, and
+why; never hide uncertainty behind a confident source recommendation.
+
+Guardrails inherited from the Phase 83 evergreen workflow: no campaign creation,
+no provider-family switch, no threshold lowering, no scheduler writes, no
+launch/send/archive/delete, no brief/filter/message/sequence/sender mutation,
+no message preparation, no message approval, no paid InMail credit refresh, no
+source mutation, no row queueing, and no campaign status change.
+
+## Journal
+
+`get_evergreen_refill_plan` writes a local dry-run journal unless
+`journal:false` is passed. Read the returned `journalPath` from the tool result
+and include it in the report. The journal contains bootstrap, plan, and terminal
+sections plus an index line under the run journal directory. If the tool returns
+`journalPath:null` with a `journalWriteFailed` warning, report the warning and
+continue with the dry-run packet; do not retry by writing local files yourself.
+
+## Report Contract
+
+Completion for Phase 85 means packet reviewed and journal written. Merely
+calling `get_evergreen_refill_plan` is not completion proof.
+
+Report these facts:
+
+- workspace id and selected sender scope;
+- plan revision and state revision;
+- selected campaign and lane per sender;
+- chosen rung and dry-run action queue;
+- itinerary, skipped lanes, blockers, cooldowns, and warnings;
+- journal path;
+- side effects proof, which must show all false values.
+
+Stop after the report. The Phase 85 workflow never executes the action queue.