@sellable/mcp 0.1.793 → 0.1.794

package/dist/server.js

@@ -53,6 +53,12 @@ import { preflightFindLeadsProvider } from "./tools/provider-preflight.js";
 import { waitForCampaignTableReady, waitForLeadListReady, } from "./tools/readiness.js";
 import { executeRefillSendsCommand } from "./tools/refill-sends.js";
 import { getRefillTargetPlan } from "./tools/refill-target-plan.js";
+import { refillV3RetiredToolRefusal } from "./tools/refill-v3-advance-contract.js";
+import { advanceRefillV3Tool } from "./tools/refill-v3-advance.js";
+import { continueRefillV3Tool } from "./tools/refill-v3-continue.js";
+import { editRefillV3SelectedCampaignTool } from "./tools/refill-v3-edit-selected-campaign.js";
+import { fillRefillV3ReadyTool } from "./tools/refill-v3-fill-ready.js";
+import { getRefillV3WorldStateTool } from "./tools/refill-v3-world-state.js";
 import { refreshSenderEngagementCommand } from "./tools/refresh-sender-engagement.js";
 import { allTools } from "./tools/registry.js";
 import { getRows, getTableRows, getTableRowsMinimal } from "./tools/rows.js";
@@ -392,6 +398,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "run_scheduler_sweep":
                 result = await runSchedulerSweep(args);
                 break;
+            case "refill_v3_world_state":
+                result = await getRefillV3WorldStateTool(args);
+                break;
+            case "refill_v3_fill_ready":
+                result = await fillRefillV3ReadyTool(args);
+                break;
+            case "refill_v3_edit_selected_campaign":
+                result = await editRefillV3SelectedCampaignTool(args);
+                break;
+            case "refill_v3_advance":
+                result = await advanceRefillV3Tool(args);
+                break;
+            case "refill_v3_continue":
+                result = await continueRefillV3Tool(args);
+                break;
             case "refresh_sender_engagement":
                 result = await refreshSenderEngagementCommand(args);
                 break;
@@ -924,8 +945,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_prospeo_credits":
                 result = await getProspeoCredits();
                 break;
-            default:
-                throw new Error(`Unknown tool: ${name}`);
+            default: {
+                // An already-installed skill or a cached flow asset can still invoke a
+                // RETIRED Refill V3 name. Naming the replacement turns an opaque dead end
+                // into an actionable refusal, with zero partial dispatch either way.
+                const retired = refillV3RetiredToolRefusal(name);
+                throw new Error(retired ?? `Unknown tool: ${name}`);
+            }
         }
         // A tool that DECLARES an `outputSchema` must answer with `structuredContent`,
         // or the client discards the whole response. `toMcpToolResult` owns that,

package/dist/tools/campaign-message-preparation.d.ts

@@ -210,6 +210,14 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             runCondition: {
                 type: string[];
             };
+            intrinsicRequirements: {
+                type: string;
+                description: string;
+            };
+            approvalPolicy: {
+                type: string;
+                description: string;
+            };
             requestId: {
                 type: string;
             };
@@ -404,6 +412,17 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             jobId?: undefined;
         };
         required: string[];
+        oneOf: ({
+            not: {
+                anyOf: {
+                    required: ("effectId" | "runCondition" | "requestId" | "profileSchemaVersion" | "compilerVersion" | "sequenceVersion" | "campaignDigest" | "actionColumnId" | "pathDigest" | "targetNodeId" | "entryNodeId" | "pathNodeIds" | "dependsOnColumnIds" | "intrinsicRequirements" | "approvalPolicy" | "targetColumnType" | "targetAction")[];
+                }[];
+            };
+            required?: undefined;
+        } | {
+            required: ("effectId" | "runCondition" | "requestId" | "profileSchemaVersion" | "compilerVersion" | "sequenceVersion" | "campaignDigest" | "actionColumnId" | "pathDigest" | "targetNodeId" | "entryNodeId" | "pathNodeIds" | "dependsOnColumnIds" | "intrinsicRequirements" | "approvalPolicy" | "targetColumnType" | "targetAction")[];
+            not?: undefined;
+        })[];
         additionalProperties: boolean;
     };
 } | {
@@ -626,12 +645,15 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             pathNodeIds?: undefined;
             dependsOnColumnIds?: undefined;
             runCondition?: undefined;
+            intrinsicRequirements?: undefined;
+            approvalPolicy?: undefined;
             requestId?: undefined;
             effectId?: undefined;
             disableLowPassRateStop?: undefined;
         };
         additionalProperties: boolean;
         required?: undefined;
+        oneOf?: undefined;
     };
 } | {
     name: string;
@@ -676,6 +698,8 @@ export declare const campaignMessagePreparationToolDefinitions: ({
             pathNodeIds?: undefined;
             dependsOnColumnIds?: undefined;
             runCondition?: undefined;
+            intrinsicRequirements?: undefined;
+            approvalPolicy?: undefined;
             requestId?: undefined;
             effectId?: undefined;
             disableLowPassRateStop?: undefined;
@@ -684,6 +708,7 @@ export declare const campaignMessagePreparationToolDefinitions: ({
         };
         additionalProperties: boolean;
         required?: undefined;
+        oneOf?: undefined;
     };
 })[];
 export declare function startPrepareCampaignMessages(input: StartPrepareMessagesInput): Promise<unknown>;

package/dist/tools/campaign-message-preparation.js

@@ -2,6 +2,25 @@ import { getApi } from "../api.js";
 import { REFILL_REPORTING_CONTEXT_INPUT_SCHEMA, } from "./campaign-processing.js";
 import { sanitizeRefillReportingContextProjection, sanitizeRefillReportingProjection, } from "./refill-target-plan.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
+const READINESS_EXPECTATION_KEYS = [
+    "profileSchemaVersion",
+    "compilerVersion",
+    "sequenceVersion",
+    "campaignDigest",
+    "actionColumnId",
+    "targetColumnType",
+    "pathDigest",
+    "targetAction",
+    "targetNodeId",
+    "entryNodeId",
+    "pathNodeIds",
+    "dependsOnColumnIds",
+    "runCondition",
+    "intrinsicRequirements",
+    "approvalPolicy",
+    "requestId",
+    "effectId",
+];
 async function postPrepareMessages(body, workspaceId) {
     const api = getApi();
     const requestOptions = workspaceRequestOptions(workspaceId);
@@ -133,6 +152,14 @@ export const campaignMessagePreparationToolDefinitions = [
                 pathNodeIds: { type: "array", items: { type: "string" } },
                 dependsOnColumnIds: { type: "array", items: { type: "string" } },
                 runCondition: { type: ["string", "null"] },
+                intrinsicRequirements: {
+                    type: "object",
+                    description: "Backend-issued sequence intrinsic requirements. Supply only as part of the complete readiness envelope.",
+                },
+                approvalPolicy: {
+                    type: "object",
+                    description: "Backend-issued approval policy. Supply only as part of the complete readiness envelope.",
+                },
                 requestId: { type: "string" },
                 effectId: { type: "string" },
                 disableLowPassRateStop: {
@@ -154,6 +181,16 @@ export const campaignMessagePreparationToolDefinitions = [
                 },
             },
             required: ["campaignId"],
+            oneOf: [
+                {
+                    not: {
+                        anyOf: READINESS_EXPECTATION_KEYS.map((key) => ({
+                            required: [key],
+                        })),
+                    },
+                },
+                { required: [...READINESS_EXPECTATION_KEYS] },
+            ],
             additionalProperties: false,
         },
     },

package/dist/tools/campaign-processing.d.ts

@@ -29,13 +29,54 @@ type SchemaInput = {
     tableId?: string;
     workspaceId?: string;
 };
+/**
+ * Bounded diagnostic read mode for `select_campaign_cells`. The ONLY new input
+ * is `{ limit }`, an integer in [1,10]. It never widens the compact default
+ * response and never reaches `queue_campaign_cells`.
+ */
+export type CampaignDiagnosticInput = {
+    limit: number;
+};
+export type CampaignRepairSelection = {
+    success: true;
+    campaignId: string | null;
+    tableId: string;
+    rows: Array<{
+        rowId: string;
+        cells: Array<{
+            columnRole: "enrich" | "icpScore" | "generateMessage";
+            status: string;
+            error: string;
+        }>;
+    }>;
+    termination: {
+        reason: "frontier_exhausted" | "limit_reached";
+        rowsChecked: number;
+        rowsRemaining: number;
+        hasMore: boolean;
+    };
+};
+export declare const CAMPAIGN_DIAGNOSTIC_LIMIT_MAX = 10;
+export declare const CAMPAIGN_DIAGNOSTIC_INPUT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 10;
+        };
+    };
+    readonly required: readonly ["limit"];
+    readonly additionalProperties: false;
+};
 type SelectInput = SchemaInput & {
     columnRole: ColumnRole;
     rowSelector: RowSelector;
     limit?: number;
     includeGeneratedMessageReview?: boolean;
+    diagnostic?: CampaignDiagnosticInput;
 };
-type QueueInput = SelectInput & {
+type QueueInput = Omit<SelectInput, "diagnostic"> & {
     forceRerun?: boolean;
     reason?: string;
 };
@@ -503,6 +544,14 @@ type WorkflowTableStats = {
 export declare function normalizeRefillRunHandle(value: unknown): RefillRunHandleV1;
 export declare function normalizeRefillTargetConfig(value: unknown): RefillTargetConfigV1;
 export declare function normalizeMessageTemplateRevision(value: unknown): MessageTemplateRevisionV1 | undefined;
+/**
+ * Internal Refill V3 owner for the exact transient pre-approval repair
+ * frontier. It is intentionally not a public MCP tool: the model chooses the
+ * action, while the server owns the bounded current rows and semantic roles.
+ */
+export declare function selectRepairableCampaignCells(input: SchemaInput & {
+    limit: number;
+}): Promise<CampaignRepairSelection>;
 export declare const campaignProcessingToolDefinitions: ({
     name: string;
     description: string;
@@ -522,6 +571,7 @@ export declare const campaignProcessingToolDefinitions: ({
             rowSelector?: undefined;
             limit?: undefined;
             includeGeneratedMessageReview?: undefined;
+            diagnostic?: undefined;
             forceRerun?: undefined;
             reason?: undefined;
             minPassedCount?: undefined;
@@ -587,6 +637,18 @@ export declare const campaignProcessingToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            diagnostic: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly limit: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 10;
+                    };
+                };
+                readonly required: readonly ["limit"];
+                readonly additionalProperties: false;
+            };
             forceRerun?: undefined;
             reason?: undefined;
             minPassedCount?: undefined;
@@ -655,6 +717,7 @@ export declare const campaignProcessingToolDefinitions: ({
                 type: string;
             };
             includeGeneratedMessageReview?: undefined;
+            diagnostic?: undefined;
             minPassedCount?: undefined;
             minGeneratedMessages?: undefined;
             templateRevision?: undefined;
@@ -704,6 +767,7 @@ export declare const campaignProcessingToolDefinitions: ({
             rowSelector?: undefined;
             limit?: undefined;
             includeGeneratedMessageReview?: undefined;
+            diagnostic?: undefined;
             forceRerun?: undefined;
             reason?: undefined;
             rowIds?: undefined;
@@ -744,6 +808,7 @@ export declare const campaignProcessingToolDefinitions: ({
             rowSelector?: undefined;
             limit?: undefined;
             includeGeneratedMessageReview?: undefined;
+            diagnostic?: undefined;
             forceRerun?: undefined;
             reason?: undefined;
             minPassedCount?: undefined;
@@ -964,6 +1029,7 @@ export declare const campaignProcessingToolDefinitions: ({
             rowSelector?: undefined;
             limit?: undefined;
             includeGeneratedMessageReview?: undefined;
+            diagnostic?: undefined;
             forceRerun?: undefined;
             reason?: undefined;
             minPassedCount?: undefined;
@@ -979,6 +1045,13 @@ export declare const campaignProcessingToolDefinitions: ({
     };
 })[];
 export declare function getCampaignTableSchema(input: SchemaInput): Promise<CampaignProcessingSchemaResponse>;
+/**
+ * Validate the bounded diagnostic packet locally, BEFORE the outbound POST. The
+ * host's JSON-schema validation is not a substitute: a permissive packet that
+ * reached the product would authorize an unbounded or foreign diagnostic read.
+ * An absent `diagnostic` returns null and leaves the compact default untouched.
+ */
+export declare function normalizeCampaignDiagnosticInput(input: SelectInput): CampaignDiagnosticInput | null;
 export declare function selectCampaignCells(input: SelectInput): Promise<unknown>;
 export declare function queueCampaignCells(input: QueueInput): Promise<unknown>;
 export declare function recordCampaignReviewBatch(input: RecordReviewBatchInput): Promise<unknown>;

package/dist/tools/campaign-processing.js

@@ -1,6 +1,15 @@
 import { getApi } from "../api.js";
 import { resolveWaitTimeout } from "./readiness.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
+export const CAMPAIGN_DIAGNOSTIC_LIMIT_MAX = 10;
+export const CAMPAIGN_DIAGNOSTIC_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        limit: { type: "integer", minimum: 1, maximum: 10 },
+    },
+    required: ["limit"],
+    additionalProperties: false,
+};
 export const REFILL_RUN_HANDLE_INPUT_SCHEMA = {
     type: "object",
     properties: {
@@ -297,6 +306,21 @@ async function resolveSchema(input) {
         ...(workspaceId ? { workspaceId } : {}),
     }, workspaceId ?? undefined);
 }
+/**
+ * Internal Refill V3 owner for the exact transient pre-approval repair
+ * frontier. It is intentionally not a public MCP tool: the model chooses the
+ * action, while the server owns the bounded current rows and semantic roles.
+ */
+export async function selectRepairableCampaignCells(input) {
+    const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    return postCampaignProcessing({
+        action: "selectRepairable",
+        campaignId: input.campaignId,
+        tableId: input.tableId,
+        limit: input.limit,
+        ...(workspaceId ? { workspaceId } : {}),
+    }, workspaceId ?? undefined);
+}
 export const campaignProcessingToolDefinitions = [
     {
         name: "get_campaign_table_schema",
@@ -313,7 +337,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 a bounded exact copy audit before approval, call columnRole:"generateMessage", rowSelector:{type:"rowIds",rowIds:[...]}, includeGeneratedMessageReview:true with 1-20 exact rows. authoritativeGeneratedMessageReview is the WorkflowTableCell.result source of truth for subject, body, and template authority; never substitute formula Message/Subject columns, campaign previews, or CSV exports. 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 a bounded exact copy audit before approval, call columnRole:"generateMessage", rowSelector:{type:"rowIds",rowIds:[...]}, includeGeneratedMessageReview:true with 1-20 exact rows. authoritativeGeneratedMessageReview is the WorkflowTableCell.result source of truth for subject, body, and template authority; never substitute formula Message/Subject columns, campaign previews, or CSV exports. 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. Pass diagnostic:{limit:N} with 1<=N<=10 and exact workspaceId, campaignId, and tableId to additionally load decision-relevant workflow evidence for that bounded sample in one set query; inert display/formula cells are omitted. Omit diagnostic for the compact default response.',
         inputSchema: {
             type: "object",
             properties: {
@@ -358,6 +382,7 @@ export const campaignProcessingToolDefinitions = [
                     type: "boolean",
                     description: "Return the authoritative generated subject/body and template-authority projection. Allowed only for columnRole generateMessage with 1-20 exact rowIds.",
                 },
+                diagnostic: CAMPAIGN_DIAGNOSTIC_INPUT_SCHEMA,
             },
             required: ["columnRole", "rowSelector"],
             additionalProperties: false,
@@ -470,11 +495,42 @@ export const campaignProcessingToolDefinitions = [
 export async function getCampaignTableSchema(input) {
     return resolveSchema(input);
 }
+/**
+ * Validate the bounded diagnostic packet locally, BEFORE the outbound POST. The
+ * host's JSON-schema validation is not a substitute: a permissive packet that
+ * reached the product would authorize an unbounded or foreign diagnostic read.
+ * An absent `diagnostic` returns null and leaves the compact default untouched.
+ */
+export function normalizeCampaignDiagnosticInput(input) {
+    const raw = input.diagnostic;
+    if (raw === undefined)
+        return null;
+    if (!isRecord(raw)) {
+        throw new Error("diagnostic must be an object with exactly one integer limit between 1 and 10.");
+    }
+    const keys = Object.keys(raw);
+    if (keys.length !== 1 || keys[0] !== "limit") {
+        throw new Error("diagnostic accepts only the limit property.");
+    }
+    const limit = raw.limit;
+    if (typeof limit !== "number" ||
+        !Number.isInteger(limit) ||
+        limit < 1 ||
+        limit > CAMPAIGN_DIAGNOSTIC_LIMIT_MAX) {
+        throw new Error(`diagnostic.limit must be an integer between 1 and ${CAMPAIGN_DIAGNOSTIC_LIMIT_MAX}.`);
+    }
+    requiredString(input.workspaceId, "workspaceId for diagnostic mode");
+    requiredString(input.campaignId, "campaignId for diagnostic mode");
+    requiredString(input.tableId, "tableId for diagnostic mode");
+    return { limit };
+}
 export async function selectCampaignCells(input) {
     const workspaceId = normalizeExplicitWorkspaceId(input.workspaceId);
+    const diagnostic = normalizeCampaignDiagnosticInput(input);
     return postCampaignProcessing({
         action: "select",
         ...input,
+        ...(diagnostic ? { diagnostic } : {}),
         ...(workspaceId ? { workspaceId } : {}),
     }, workspaceId ?? undefined);
 }

package/dist/tools/prompts.d.ts

@@ -146,7 +146,7 @@ export interface PostFindLeadsScoutRegistryResponse {
 export declare const DEFAULT_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
 export declare const MAX_SUBSKILL_PROMPT_CHUNK_CHARS = 48000;
 export declare const DEPRECATED_SUBSKILL_PROMPT_REPLACEMENTS: Record<string, string>;
-export declare const ALLOWED_SUBSKILL_PROMPT_NAMES: readonly ["avoid-ai-writing", "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", "find-leads-v2", "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 ALLOWED_SUBSKILL_PROMPT_NAMES: readonly ["avoid-ai-writing", "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", "find-leads-v2", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-waterfall-order", "refill-sends-work-campaign", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
 export declare const REFILL_PROJECTION_PROMPT_INVENTORY: readonly [{
     readonly name: "refill-sends";
     readonly assetPath: "SKILL.md";
@@ -155,6 +155,18 @@ export declare const REFILL_PROJECTION_PROMPT_INVENTORY: readonly [{
     readonly name: "refill-sends-workflow";
     readonly assetPath: "core/flow.v1.json";
     readonly visibility: "internal";
+}, {
+    readonly name: "refill-sends-workflow";
+    readonly assetPath: "core/flow.v3.json";
+    readonly visibility: "internal";
+}, {
+    readonly name: "refill-sends-work-campaign";
+    readonly assetPath: "SKILL.md";
+    readonly visibility: "internal";
+}, {
+    readonly name: "refill-sends-waterfall-order";
+    readonly assetPath: "SKILL.md";
+    readonly visibility: "internal";
 }];
 export declare const promptToolDefinitions: ({
     name: string;
@@ -199,7 +211,7 @@ export declare const promptToolDefinitions: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["avoid-ai-writing", "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", "find-leads-v2", "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 ["avoid-ai-writing", "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", "find-leads-v2", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-waterfall-order", "refill-sends-work-campaign", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             offset: {
@@ -234,7 +246,7 @@ export declare const promptToolDefinitions: ({
         properties: {
             subskillName: {
                 type: string;
-                enum: readonly ["avoid-ai-writing", "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", "find-leads-v2", "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 ["avoid-ai-writing", "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", "find-leads-v2", "foundation", "generate-messages", "interview", "load-voice", "refresh-sender-engagement", "refill-sends", "refill-sends-waterfall-order", "refill-sends-work-campaign", "refill-sends-workflow", "research", "research-prospect", "research-sender", "weekly-campaign-summary", "workflow-sequences"];
                 description: string;
             };
             assetPath: {

package/dist/tools/prompts.js

@@ -40,6 +40,12 @@ export const ALLOWED_SUBSKILL_PROMPT_NAMES = [
     "load-voice",
     "refresh-sender-engagement",
     "refill-sends",
+    // Phase 146.5 Plan 09: the two INTERNAL wave-7 AI seams. Both are lazily
+    // loaded through `get_subskill_prompt`; neither gets a slash command, a command
+    // directory, a menu entry, or any installer edit, matching the
+    // `refill-sends-workflow` internal-subskill precedent.
+    "refill-sends-waterfall-order",
+    "refill-sends-work-campaign",
     "refill-sends-workflow",
     "research",
     "research-prospect",
@@ -54,6 +60,25 @@ export const REFILL_PROJECTION_PROMPT_INVENTORY = [
         assetPath: "core/flow.v1.json",
         visibility: "internal",
     },
+    // Phase 146.5 Plan 12 (Plan 10 deferred item 6): the V3 flow asset is a
+    // FIRST-CLASS member of the refill projection surface, not an undeclared
+    // sibling of the V1 asset. `refill-sends-workflow` therefore appears twice —
+    // once per route asset — which is exactly what a two-route workflow projects.
+    {
+        name: "refill-sends-workflow",
+        assetPath: "core/flow.v3.json",
+        visibility: "internal",
+    },
+    {
+        name: "refill-sends-work-campaign",
+        assetPath: "SKILL.md",
+        visibility: "internal",
+    },
+    {
+        name: "refill-sends-waterfall-order",
+        assetPath: "SKILL.md",
+        visibility: "internal",
+    },
 ];
 export const promptToolDefinitions = [
     {

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

@@ -1,5 +1,6 @@
+import { hasTerminalSchedulerReceipt, normalizeSchedulerChangedCounts, normalizeSchedulerPrimitiveResult, numberValue, recordValue, schedulerEnvelopeIsTerminal, stringArray, stringValue, type SchedulerChangedCount, type SchedulerChangedCounts } from "../scheduler-envelope.js";
 import { searchSignals } from "./leads.js";
-import { type SchedulerExpectedTargetInput } from "./scheduler-run.js";
+import type { RefillV3SourceFamilyOwners, RefillV3SourceOwnerKey, RefillV3SourceOwnerOutcome } from "./refill-v3-source-family-dispatch.js";
 export type RefillSendsApprovalMode = "approve" | "mark_ready";
 export type PaidInmailRefreshAction = {
     senderId: string;
@@ -44,6 +45,30 @@ export type YoloPrimitiveAttempt = {
     refusalReason?: string;
     providerOutcome?: ProviderSavedSearchOutcome;
 };
+/**
+ * Normalize ONE existing family owner's `YoloPrimitiveAttempt` into the closed
+ * dispatch outcome. Missing or uncertain effect evidence is NEVER success:
+ * `no_action` is a bounded zero-yield success only when its receipt carries
+ * before/after evidence, and a refusal or an absent receipt is a typed failure.
+ */
+/**
+ * The V3 source path is SINGLE-PASS by construction.
+ *
+ * V1 keeps its two-attempt signal helper and its depth-scaled provider target;
+ * V3 removes both. `searchSignalsWithProviderRetry` hides TWO transport attempts
+ * inside one "bounded" owner call, and `priorSearchDepth` is retry/expansion
+ * MEMORY that multiplies the target the AI never asked for. Under V3 a provider
+ * outcome is a typed no-effect receipt followed by a reread, and only a later
+ * fresh attention iteration may choose another action.
+ */
+export declare const REFILL_V3_SIGNAL_SEARCH_ATTEMPTS = 1;
+export declare function isRefillV3SinglePassAction(action: Record<string, unknown>): boolean;
+export declare function normalizeRefillV3SourceOwnerReceipt(params: {
+    ownerKey: RefillV3SourceOwnerKey;
+    attempt: YoloPrimitiveAttempt;
+    requestFingerprint: string;
+    idempotencyKey: string;
+}): RefillV3SourceOwnerOutcome;
 export type RefillTemplateRevisionPrimitiveResult = {
     executed: true;
     type: "revise_message_template_and_rerun";
@@ -177,7 +202,7 @@ export type StartCampaignPrimitiveResult = {
     result: unknown;
 };
 type RerunErroredCellsOperation = {
-    columnRole: "icpScore" | "generateMessage";
+    columnRole: "enrich" | "icpScore" | "generateMessage";
     rowSelector: {
         type: "rowIds";
         rowIds: string[];
@@ -197,75 +222,10 @@ export type RerunErroredCellsPrimitiveResult = {
 };
 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 type SchedulerChangedCount = {
-    campaignId: string;
-    tableId: string;
-    actionType: string;
-    count: number;
-};
-export type SchedulerChangedCounts = {
-    complete: true;
-    truncated: false;
-    total: number;
-    byCampaignTableActionType: SchedulerChangedCount[];
-    byCampaignTableActionTypeSender: Array<SchedulerChangedCount & {
-        senderId: string;
-    }>;
-};
-export declare function normalizeSchedulerChangedCounts(value: unknown): SchedulerChangedCounts | null;
 export declare function setSweepSettlePollDelayMsForTests(ms: number): void;
 export declare function resetSweepSettlePollDelayMsForTests(): void;
-export declare function schedulerEnvelopeIsTerminal(schedulerStatus: string, receipt?: Record<string, unknown> | null): boolean;
-export declare function normalizeSchedulerPrimitiveResult(value: unknown, expected?: {
-    expectedTargets: SchedulerExpectedTargetInput[];
-    expectedTargetsHash: string;
-    maxPlacements: number;
-}): {
-    retryAfterMs: number;
-    changedCounts: null;
-    auditComplete: false;
-    unsettledReceipt?: Record<string, unknown> | undefined;
-    status: "matching_scheduler_active";
-    schedulerStatus: string;
-    terminal: false;
-    disposition: "bounded_reread_wait";
-    receipt: null;
-    blocker?: undefined;
-} | {
-    status: string;
-    schedulerStatus: string;
-    disposition: "bounded_backoff_wait" | "diagnostic_stop";
-    receipt: {} | null;
-    retryAfterMs: number | null;
-    changedCounts: null;
-    auditComplete: false;
-    blocker: string;
-    terminal?: undefined;
-} | {
-    status: "scheduler_receipt_incomplete";
-    schedulerStatus: string;
-    receipt: {} | null;
-    retryAfterMs: number | null;
-    changedCounts: null;
-    auditComplete: false;
-    blocker: "scheduler_receipt_incomplete";
-    disposition?: undefined;
-    terminal?: undefined;
-} | {
-    status: string;
-    terminal: boolean;
-    receipt: {} | null;
-    retryAfterMs: number | null;
-    changedCounts: SchedulerChangedCounts;
-    auditComplete: true;
-    schedulerStatus?: undefined;
-    disposition?: undefined;
-    blocker?: undefined;
-};
-export declare function stringArray(value: unknown): string[];
+export { hasTerminalSchedulerReceipt, normalizeSchedulerChangedCounts, normalizeSchedulerPrimitiveResult, numberValue, recordValue, schedulerEnvelopeIsTerminal, stringArray, stringValue, };
+export type { SchedulerChangedCount, SchedulerChangedCounts };
 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;
@@ -389,6 +349,20 @@ export declare function buildBoundedProviderSearchClone(provider: "sales-nav" |
 export declare function executeProviderSavedSearch(action: Record<string, unknown>, workspaceId: string | undefined, mode: ProviderSavedSearchMode): Promise<YoloPrimitiveAttempt>;
 export declare function continueProviderSource(action: Record<string, unknown>, workspaceId?: string): Promise<YoloPrimitiveAttempt>;
 export declare function broadenProviderSearch(action: Record<string, unknown>, workspaceId?: string): Promise<YoloPrimitiveAttempt>;
+/**
+ * The V3 owner binding (Phase 146.5 Plan 09 T4/T5).
+ *
+ * It maps the dispatcher's five closed owner keys onto the EXISTING family
+ * owners and marks every action single-pass, so the V3 path can never take a
+ * hidden second transport attempt or scale its target by prior search depth.
+ * Every receipt crosses the ONE normalization path.
+ *
+ * It never chooses a family, a provider, a query, a filter, a keyword, or a
+ * post: those arrive already bounded on the AI command.
+ */
+export type RefillV3SourceOwnerRequest = Parameters<RefillV3SourceFamilyOwners[RefillV3SourceOwnerKey]>[0];
+export declare function buildRefillV3SourceOwnerAction(request: RefillV3SourceOwnerRequest): Record<string, unknown>;
+export declare function refillV3SourceFamilyOwners(workspaceId: string): RefillV3SourceFamilyOwners;
 export declare function refreshSenderPostEngagers(action: Record<string, unknown>, workspaceId?: string): Promise<YoloPrimitiveAttempt>;
 /**
  * Rung 4 is a product-owned rubric quality trial, not a blind toggle. The backend
@@ -422,4 +396,3 @@ export declare function executeRefillTemplateRevisionPrimitive(params: {
     workspaceId?: string | null;
 }): Promise<RefillTemplateRevisionPrimitiveResult>;
 export declare function executeOneYoloPrimitive(action: Record<string, unknown> | null, workspaceId?: string): Promise<YoloPrimitiveAttempt>;
-export {};