@sellable/mcp 0.1.726 → 0.1.727

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

@@ -3143,419 +3143,6 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
     workspaceResolution: string;
     intent: RefillSendsIntent;
 } | {
-    status: "blocked";
-    blocker: string;
-    guidance: string;
-    conflicts: string[];
-    runId: string | undefined;
-    readOnly: boolean;
-    forbiddenActions: string[];
-    boundedAuthority: string;
-    ok: boolean;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-    fillWindow: {
-        mode: string;
-        targetDate: string;
-        description: string;
-        untilDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        untilDate: string;
-        description: string;
-        targetDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        horizonSendDays: number | null;
-        horizonHours: number | null;
-        description: string;
-        targetDate?: undefined;
-        untilDate?: undefined;
-    };
-    approvalMode: RefillSendsApprovalMode;
-    campaignId: string | null;
-    tableId: string | null;
-    targetConfig: RefillTargetConfigV1 | null;
-    runHandle: RefillRunHandleV1 | null;
-    reportingContext: RefillReportingContextV2 | null;
-    messageTemplateRevision: MessageTemplateRevisionV1 | null;
-    senderScope: string;
-    senderSelectors: {
-        senders: string[];
-        senderIds: string[];
-        senderNames: string[];
-    };
-    firstOperationalSteps: string[];
-    approvalContract: string;
-    hostExamples: {
-        claude: string[];
-        codex: string[];
-        mcpTool: {
-            name: string;
-            arguments: {
-                workspaceRunState?: Record<string, unknown> | undefined;
-                workspaceCoordinator?: boolean | undefined;
-                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
-                reportingContext?: RefillReportingContextV2 | undefined;
-                targetConfig?: RefillTargetConfigV1 | undefined;
-                runHandle?: RefillRunHandleV1 | undefined;
-                fence?: number | undefined;
-                runId?: string | undefined;
-                expectedActionKey?: string | undefined;
-                expectedTargetShapeRevision?: string | undefined;
-                targetDate: string | null;
-                untilDate: string | null;
-                horizonSendDays: number | null;
-                campaignId: string | undefined;
-                tableId: string | undefined;
-                intent: RefillSendsIntent;
-                approvalMode: RefillSendsApprovalMode;
-                workspaceId: string | null;
-                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-                yolo: boolean;
-                senders: string[];
-                senderIds: string[];
-                senderNames: string[];
-            };
-        };
-    };
-    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-    command: string;
-    tool: string;
-    promptName: string;
-    workflowPromptName: string;
-    workflowAsset: {
-        subskillName: string;
-        assetPath: string;
-        expectedVersion: string;
-    };
-    yolo: boolean;
-    executionMode: RefillSendsExecutionMode;
-    workspaceId: string | null;
-    workspaceResolution: string;
-    intent: RefillSendsIntent;
-} | {
-    readOnly: boolean;
-    mode: string;
-    forbiddenActions: string[];
-    boundedAuthority: string;
-    blocker: string;
-    workspaceId: string;
-    guidance: string;
-    warnings: string[];
-    journalPath: string | null;
-    text: string;
-    workspaceResolution: string;
-    status?: undefined;
-    conflicts?: undefined;
-    runId?: undefined;
-    ok: boolean;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-    fillWindow: {
-        mode: string;
-        targetDate: string;
-        description: string;
-        untilDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        untilDate: string;
-        description: string;
-        targetDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        horizonSendDays: number | null;
-        horizonHours: number | null;
-        description: string;
-        targetDate?: undefined;
-        untilDate?: undefined;
-    };
-    approvalMode: RefillSendsApprovalMode;
-    campaignId: string | null;
-    tableId: string | null;
-    targetConfig: RefillTargetConfigV1 | null;
-    runHandle: RefillRunHandleV1 | null;
-    reportingContext: RefillReportingContextV2 | null;
-    messageTemplateRevision: MessageTemplateRevisionV1 | null;
-    senderScope: string;
-    senderSelectors: {
-        senders: string[];
-        senderIds: string[];
-        senderNames: string[];
-    };
-    firstOperationalSteps: string[];
-    approvalContract: string;
-    hostExamples: {
-        claude: string[];
-        codex: string[];
-        mcpTool: {
-            name: string;
-            arguments: {
-                workspaceRunState?: Record<string, unknown> | undefined;
-                workspaceCoordinator?: boolean | undefined;
-                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
-                reportingContext?: RefillReportingContextV2 | undefined;
-                targetConfig?: RefillTargetConfigV1 | undefined;
-                runHandle?: RefillRunHandleV1 | undefined;
-                fence?: number | undefined;
-                runId?: string | undefined;
-                expectedActionKey?: string | undefined;
-                expectedTargetShapeRevision?: string | undefined;
-                targetDate: string | null;
-                untilDate: string | null;
-                horizonSendDays: number | null;
-                campaignId: string | undefined;
-                tableId: string | undefined;
-                intent: RefillSendsIntent;
-                approvalMode: RefillSendsApprovalMode;
-                workspaceId: string | null;
-                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-                yolo: boolean;
-                senders: string[];
-                senderIds: string[];
-                senderNames: string[];
-            };
-        };
-    };
-    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-    command: string;
-    tool: string;
-    promptName: string;
-    workflowPromptName: string;
-    workflowAsset: {
-        subskillName: string;
-        assetPath: string;
-        expectedVersion: string;
-    };
-    yolo: boolean;
-    executionMode: RefillSendsExecutionMode;
-    intent: RefillSendsIntent;
-} | {
-    readOnly: boolean;
-    mode: string;
-    forbiddenActions: string[];
-    boundedAuthority: string;
-    warnings: any[];
-    journalPath: string | null;
-    text: string;
-    workspaceId: string;
-    workspaceResolution: string;
-    blocker?: undefined;
-    guidance?: undefined;
-    status?: undefined;
-    conflicts?: undefined;
-    runId?: undefined;
-    ok: boolean;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-    fillWindow: {
-        mode: string;
-        targetDate: string;
-        description: string;
-        untilDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        untilDate: string;
-        description: string;
-        targetDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        horizonSendDays: number | null;
-        horizonHours: number | null;
-        description: string;
-        targetDate?: undefined;
-        untilDate?: undefined;
-    };
-    approvalMode: RefillSendsApprovalMode;
-    campaignId: string | null;
-    tableId: string | null;
-    targetConfig: RefillTargetConfigV1 | null;
-    runHandle: RefillRunHandleV1 | null;
-    reportingContext: RefillReportingContextV2 | null;
-    messageTemplateRevision: MessageTemplateRevisionV1 | null;
-    senderScope: string;
-    senderSelectors: {
-        senders: string[];
-        senderIds: string[];
-        senderNames: string[];
-    };
-    firstOperationalSteps: string[];
-    approvalContract: string;
-    hostExamples: {
-        claude: string[];
-        codex: string[];
-        mcpTool: {
-            name: string;
-            arguments: {
-                workspaceRunState?: Record<string, unknown> | undefined;
-                workspaceCoordinator?: boolean | undefined;
-                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
-                reportingContext?: RefillReportingContextV2 | undefined;
-                targetConfig?: RefillTargetConfigV1 | undefined;
-                runHandle?: RefillRunHandleV1 | undefined;
-                fence?: number | undefined;
-                runId?: string | undefined;
-                expectedActionKey?: string | undefined;
-                expectedTargetShapeRevision?: string | undefined;
-                targetDate: string | null;
-                untilDate: string | null;
-                horizonSendDays: number | null;
-                campaignId: string | undefined;
-                tableId: string | undefined;
-                intent: RefillSendsIntent;
-                approvalMode: RefillSendsApprovalMode;
-                workspaceId: string | null;
-                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-                yolo: boolean;
-                senders: string[];
-                senderIds: string[];
-                senderNames: string[];
-            };
-        };
-    };
-    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-    command: string;
-    tool: string;
-    promptName: string;
-    workflowPromptName: string;
-    workflowAsset: {
-        subskillName: string;
-        assetPath: string;
-        expectedVersion: string;
-    };
-    yolo: boolean;
-    executionMode: RefillSendsExecutionMode;
-    intent: RefillSendsIntent;
-} | {
-    runSnapshot: unknown;
-    readOnly: boolean;
-    forbiddenActions: string[];
-    boundedAuthority: string;
-    status: "dry_run";
-    plan: Record<string, unknown>;
-    blocker?: undefined;
-    guidance?: undefined;
-    conflicts?: undefined;
-    runId?: undefined;
-    ok: boolean;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-    fillWindow: {
-        mode: string;
-        targetDate: string;
-        description: string;
-        untilDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        untilDate: string;
-        description: string;
-        targetDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        horizonSendDays: number | null;
-        horizonHours: number | null;
-        description: string;
-        targetDate?: undefined;
-        untilDate?: undefined;
-    };
-    approvalMode: RefillSendsApprovalMode;
-    campaignId: string | null;
-    tableId: string | null;
-    targetConfig: RefillTargetConfigV1 | null;
-    runHandle: RefillRunHandleV1 | null;
-    reportingContext: RefillReportingContextV2 | null;
-    messageTemplateRevision: MessageTemplateRevisionV1 | null;
-    senderScope: string;
-    senderSelectors: {
-        senders: string[];
-        senderIds: string[];
-        senderNames: string[];
-    };
-    firstOperationalSteps: string[];
-    approvalContract: string;
-    hostExamples: {
-        claude: string[];
-        codex: string[];
-        mcpTool: {
-            name: string;
-            arguments: {
-                workspaceRunState?: Record<string, unknown> | undefined;
-                workspaceCoordinator?: boolean | undefined;
-                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
-                reportingContext?: RefillReportingContextV2 | undefined;
-                targetConfig?: RefillTargetConfigV1 | undefined;
-                runHandle?: RefillRunHandleV1 | undefined;
-                fence?: number | undefined;
-                runId?: string | undefined;
-                expectedActionKey?: string | undefined;
-                expectedTargetShapeRevision?: string | undefined;
-                targetDate: string | null;
-                untilDate: string | null;
-                horizonSendDays: number | null;
-                campaignId: string | undefined;
-                tableId: string | undefined;
-                intent: RefillSendsIntent;
-                approvalMode: RefillSendsApprovalMode;
-                workspaceId: string | null;
-                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-                yolo: boolean;
-                senders: string[];
-                senderIds: string[];
-                senderNames: string[];
-            };
-        };
-    };
-    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-    command: string;
-    tool: string;
-    promptName: string;
-    workflowPromptName: string;
-    workflowAsset: {
-        subskillName: string;
-        assetPath: string;
-        expectedVersion: string;
-    };
-    yolo: boolean;
-    executionMode: RefillSendsExecutionMode;
-    workspaceId: string | null;
-    workspaceResolution: string;
-    intent: RefillSendsIntent;
-} | {
-    runSnapshot: unknown;
-    readOnly: boolean;
-    forbiddenActions: string[];
-    boundedAuthority: string;
-    status: "in_progress";
-    runId: string;
-    fence: number;
-    gate: import("../refill-run-loop.js").RefillLoopGate;
-    guidance: string;
-    journalPath?: string | null;
-    targetConfig: RefillTargetConfigV1 | null;
-    runHandle: RefillRunHandleV1 | null;
-    refillReporting?: Record<string, unknown>;
-    blocker?: undefined;
-    conflicts?: undefined;
     ok: boolean;
     targetDate: string | null;
     untilDate: string | null;
@@ -3585,110 +3172,8 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
     approvalMode: RefillSendsApprovalMode;
     campaignId: string | null;
     tableId: string | null;
-    reportingContext: RefillReportingContextV2 | null;
-    messageTemplateRevision: MessageTemplateRevisionV1 | null;
-    senderScope: string;
-    senderSelectors: {
-        senders: string[];
-        senderIds: string[];
-        senderNames: string[];
-    };
-    firstOperationalSteps: string[];
-    approvalContract: string;
-    hostExamples: {
-        claude: string[];
-        codex: string[];
-        mcpTool: {
-            name: string;
-            arguments: {
-                workspaceRunState?: Record<string, unknown> | undefined;
-                workspaceCoordinator?: boolean | undefined;
-                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
-                reportingContext?: RefillReportingContextV2 | undefined;
-                targetConfig?: RefillTargetConfigV1 | undefined;
-                runHandle?: RefillRunHandleV1 | undefined;
-                fence?: number | undefined;
-                runId?: string | undefined;
-                expectedActionKey?: string | undefined;
-                expectedTargetShapeRevision?: string | undefined;
-                targetDate: string | null;
-                untilDate: string | null;
-                horizonSendDays: number | null;
-                campaignId: string | undefined;
-                tableId: string | undefined;
-                intent: RefillSendsIntent;
-                approvalMode: RefillSendsApprovalMode;
-                workspaceId: string | null;
-                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-                yolo: boolean;
-                senders: string[];
-                senderIds: string[];
-                senderNames: string[];
-            };
-        };
-    };
-    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-    command: string;
-    tool: string;
-    promptName: string;
-    workflowPromptName: string;
-    workflowAsset: {
-        subskillName: string;
-        assetPath: string;
-        expectedVersion: string;
-    };
-    yolo: boolean;
-    executionMode: RefillSendsExecutionMode;
-    workspaceId: string | null;
-    workspaceResolution: string;
-    intent: RefillSendsIntent;
-} | {
-    runSnapshot: unknown;
-    readOnly: boolean;
-    forbiddenActions: string[];
-    boundedAuthority: string;
-    status: "blocked";
-    blocker: string;
-    runId?: string;
-    fence?: number;
-    gate?: import("../refill-run-loop.js").RefillLoopGate;
-    guidance: string;
-    holderRunId?: string;
-    report?: Record<string, unknown>;
-    journalPath?: string | null;
     targetConfig: RefillTargetConfigV1 | null;
     runHandle: RefillRunHandleV1 | null;
-    refillReporting?: Record<string, unknown>;
-    conflicts?: undefined;
-    ok: boolean;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-    fillWindow: {
-        mode: string;
-        targetDate: string;
-        description: string;
-        untilDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        untilDate: string;
-        description: string;
-        targetDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        horizonSendDays: number | null;
-        horizonHours: number | null;
-        description: string;
-        targetDate?: undefined;
-        untilDate?: undefined;
-    };
-    approvalMode: RefillSendsApprovalMode;
-    campaignId: string | null;
-    tableId: string | null;
     reportingContext: RefillReportingContextV2 | null;
     messageTemplateRevision: MessageTemplateRevisionV1 | null;
     senderScope: string;
@@ -3699,109 +3184,7 @@ export declare function executeRefillSendsCommand(input?: RefillSendsCommandInpu
     };
     firstOperationalSteps: string[];
     approvalContract: string;
-    hostExamples: {
-        claude: string[];
-        codex: string[];
-        mcpTool: {
-            name: string;
-            arguments: {
-                workspaceRunState?: Record<string, unknown> | undefined;
-                workspaceCoordinator?: boolean | undefined;
-                messageTemplateRevision?: MessageTemplateRevisionV1 | undefined;
-                reportingContext?: RefillReportingContextV2 | undefined;
-                targetConfig?: RefillTargetConfigV1 | undefined;
-                runHandle?: RefillRunHandleV1 | undefined;
-                fence?: number | undefined;
-                runId?: string | undefined;
-                expectedActionKey?: string | undefined;
-                expectedTargetShapeRevision?: string | undefined;
-                targetDate: string | null;
-                untilDate: string | null;
-                horizonSendDays: number | null;
-                campaignId: string | undefined;
-                tableId: string | undefined;
-                intent: RefillSendsIntent;
-                approvalMode: RefillSendsApprovalMode;
-                workspaceId: string | null;
-                actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-                yolo: boolean;
-                senders: string[];
-                senderIds: string[];
-                senderNames: string[];
-            };
-        };
-    };
-    actionTypes?: ("send_invite" | "send_inmail_closed")[] | undefined;
-    command: string;
-    tool: string;
-    promptName: string;
-    workflowPromptName: string;
-    workflowAsset: {
-        subskillName: string;
-        assetPath: string;
-        expectedVersion: string;
-    };
-    yolo: boolean;
-    executionMode: RefillSendsExecutionMode;
-    workspaceId: string | null;
-    workspaceResolution: string;
-    intent: RefillSendsIntent;
-} | {
-    runSnapshot: unknown;
-    readOnly: boolean;
     forbiddenActions: string[];
-    boundedAuthority: string;
-    status: "terminal";
-    doneReason: string;
-    report: Record<string, unknown>;
-    runId: string;
-    guidance?: string;
-    journalPath?: string | null;
-    targetConfig: RefillTargetConfigV1 | null;
-    runHandle: RefillRunHandleV1 | null;
-    refillReporting?: Record<string, unknown>;
-    runState?: Record<string, unknown>;
-    blocker?: undefined;
-    conflicts?: undefined;
-    ok: boolean;
-    targetDate: string | null;
-    untilDate: string | null;
-    horizonSendDays: number | null;
-    fillWindow: {
-        mode: string;
-        targetDate: string;
-        description: string;
-        untilDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        untilDate: string;
-        description: string;
-        targetDate?: undefined;
-        horizonSendDays?: undefined;
-        horizonHours?: undefined;
-    } | {
-        mode: string;
-        horizonSendDays: number | null;
-        horizonHours: number | null;
-        description: string;
-        targetDate?: undefined;
-        untilDate?: undefined;
-    };
-    approvalMode: RefillSendsApprovalMode;
-    campaignId: string | null;
-    tableId: string | null;
-    reportingContext: RefillReportingContextV2 | null;
-    messageTemplateRevision: MessageTemplateRevisionV1 | null;
-    senderScope: string;
-    senderSelectors: {
-        senders: string[];
-        senderIds: string[];
-        senderNames: string[];
-    };
-    firstOperationalSteps: string[];
-    approvalContract: string;
     hostExamples: {
         claude: string[];
         codex: string[];

package/dist/tools/refill-sends.js

@@ -736,6 +736,60 @@ function workspaceCoordinatorInput(input) {
     delete coordinatorInput.backgroundWait;
     return coordinatorInput;
 }
+// fix(112ad): the agent-keywords broaden handoff template must carry the COMPLETE
+// original invocation surface, not just the fence handle + campaign/table that
+// 0b680f407 added. The run loop renders a minimal argumentsTemplate (workspaceId,
+// runId, fence, campaignId, tableId, agentKeywords); without the window
+// (targetDate/untilDate/horizonSendDays), the lane (actionTypes/approvalMode/
+// intent), and the coordinator envelope (executionMode/workspaceCoordinator/
+// workspaceRunState), the agent's filled re-invocation defaults targetDate=null ->
+// fillWindow scheduler_forward_48h -> the re-rendered authority mismatches the
+// fenced targetConfig -> approval_scope_changed with no safe continuation (Clover
+// 7-29, calls 10-11). Merge the coordinator envelope UNDER the base template so the
+// fence handle + exact target win and the missing scope fields are filled — the
+// identical continuation contract every other coordinator handoff carries.
+function withKeywordsHandoffScope(result, scopedInput) {
+    const report = recordValue(result.report);
+    const continuation = report ? recordValue(report.continuation) : null;
+    const template = continuation
+        ? recordValue(continuation.argumentsTemplate)
+        : null;
+    if (!report || !continuation || !template)
+        return result;
+    const scopeAdditions = {
+        ...(scopedInput.targetDate ? { targetDate: scopedInput.targetDate } : {}),
+        ...(scopedInput.untilDate ? { untilDate: scopedInput.untilDate } : {}),
+        ...(typeof scopedInput.horizonSendDays === "number"
+            ? { horizonSendDays: scopedInput.horizonSendDays }
+            : {}),
+        ...(scopedInput.actionTypes
+            ? { actionTypes: scopedInput.actionTypes }
+            : {}),
+        ...(scopedInput.approvalMode
+            ? { approvalMode: scopedInput.approvalMode }
+            : {}),
+        ...(scopedInput.intent ? { intent: scopedInput.intent } : {}),
+        ...(scopedInput.executionMode
+            ? { executionMode: scopedInput.executionMode }
+            : {}),
+        ...(scopedInput.workspaceCoordinator === true
+            ? { workspaceCoordinator: true }
+            : {}),
+        ...(scopedInput.workspaceRunState
+            ? { workspaceRunState: scopedInput.workspaceRunState }
+            : {}),
+    };
+    return {
+        ...result,
+        report: {
+            ...report,
+            continuation: {
+                ...continuation,
+                argumentsTemplate: { ...scopeAdditions, ...template },
+            },
+        },
+    };
+}
 const BACKGROUND_WAIT_FAST_PATH_TTL_MS = 10 * 60 * 1000;
 const BACKGROUND_WAIT_MIN_RETRY_MS = 5_000;
 // Action families whose successful exact terminal means NEW ROWS landed on
@@ -3198,7 +3252,11 @@ export async function executeRefillSendsCommand(input = {}) {
         if ("blocker" in result &&
             stringValue(result.blocker) ===
                 "agent_supplied_signal_keywords_required") {
-            return { ...command, ok: false, ...result };
+            // fix(112ad): complete the handoff template with the original window + lane
+            // + coordinator envelope so the agent's filled re-invocation re-renders the
+            // SAME fenced target instead of defaulting to the scheduler-forward window.
+            const scopedResult = withKeywordsHandoffScope(result, scopedInput);
+            return { ...command, ok: false, ...scopedResult };
         }
         const continuationHandle = "status" in result &&
             result.status === "in_progress" &&

package/package.json

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