@sellable/mcp 0.1.793 → 0.1.794

package/dist/tools/refill-v3-continue.d.ts

@@ -0,0 +1,501 @@
+import type { RefillV3AdvanceResult } from "./refill-v3-advance-contract.js";
+import { type RefillV3AdvanceToolInput } from "./refill-v3-advance.js";
+import type { RefillV3CampaignAttentionPacket } from "./refill-v3-attention-packet-contract.js";
+import { type RefillV3CampaignWorkOutcome } from "./refill-v3-campaign-work.js";
+import { dispatchRefillV3SourceFamily } from "./refill-v3-source-family-dispatch.js";
+import { getRefillV3WorldStateTool } from "./refill-v3-world-state.js";
+export declare const REFILL_V3_CONTINUE_TOOL_NAME: "refill_v3_continue";
+export declare const refillV3ContinueToolDefinitions: {
+    name: "refill_v3_continue";
+    description: string;
+    inputSchema: Readonly<{
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["workspaceId", "scope", "packet", "decision"];
+        readonly properties: {
+            readonly workspaceId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.";
+            };
+            readonly scope: {
+                readonly description: "Either a 1-3 day sender-local horizon or an exact sender/date set. There is no lane input, no row input, and no mode input.";
+                readonly oneOf: readonly [{
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind", "days"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                            readonly const: "sender_local_horizon";
+                        };
+                        readonly days: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 3;
+                        };
+                        readonly senderIds: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly minItems: 1;
+                        };
+                    };
+                }, {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["kind", "senderDates"];
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                            readonly const: "exact_sender_dates";
+                        };
+                        readonly senderDates: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly items: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["senderId", "dates"];
+                                readonly properties: {
+                                    readonly senderId: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                    };
+                                    readonly dates: {
+                                        readonly type: "array";
+                                        readonly minItems: 1;
+                                        readonly items: {
+                                            readonly type: "string";
+                                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                }];
+            };
+            readonly yolo: {
+                readonly type: "boolean";
+                readonly description: "The operator's AUTONOMY GRANT, true only when the operator actually asked for --yolo. It is not a mode and selects nothing: WHICH campaign may start is derived from the workspace's own campaigns. It authorizes exactly one thing this call could not otherwise do — starting one already-eligible PAUSED derived-evergreen campaign once every active campaign for a row is exhausted. Omit it, or pass false, for a conservative run that reports that exhaustion instead of acting on it.";
+            };
+            readonly packet: Readonly<{
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["scope", "evidence"];
+                readonly properties: {
+                    readonly scope: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["workspaceId", "campaignId", "tableId", "campaignVersion", "evidenceFingerprint", "senderId", "date", "lane", "actionType"];
+                        readonly properties: {
+                            readonly workspaceId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly campaignId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly tableId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly campaignVersion: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly evidenceFingerprint: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly senderId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly date: {
+                                readonly type: "string";
+                                readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                            };
+                            readonly lane: {
+                                readonly type: "string";
+                                readonly enum: string[];
+                            };
+                            readonly actionType: {
+                                readonly type: "string";
+                                readonly enum: ("send_invite" | "send_inmail_closed")[];
+                            };
+                        };
+                    };
+                    readonly evidence: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["campaignType", "campaignObjective", "protectedFitDigest", "leadSourceFamily", "provider", "sourceLineage", "priorYieldReceipt", "searchedNegativeSetFingerprints", "remainingGap", "supply", "activeJob", "failedJobRef", "diagnosticRowRef"];
+                        readonly properties: {
+                            readonly campaignType: {
+                                readonly type: "string";
+                            };
+                            readonly campaignObjective: {
+                                readonly type: "string";
+                            };
+                            readonly protectedFitDigest: {
+                                readonly type: "string";
+                            };
+                            readonly leadSourceFamily: {
+                                readonly type: "string";
+                                readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
+                            };
+                            readonly provider: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                            readonly selectedLeadListId: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                            readonly providerSearchReference: {
+                                readonly type: readonly ["object", "null"];
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["workspaceId", "provider", "sourceTableId", "searchId", "resolutionOrigin", "owner", "basisFingerprint"];
+                                readonly properties: {
+                                    readonly workspaceId: {
+                                        readonly type: "string";
+                                    };
+                                    readonly provider: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["sales-nav", "prospeo"];
+                                    };
+                                    readonly sourceTableId: {
+                                        readonly type: "string";
+                                    };
+                                    readonly searchId: {
+                                        readonly type: "string";
+                                    };
+                                    readonly resolutionOrigin: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["config_import_job", "exact_table_job", "find_leads_run"];
+                                    };
+                                    readonly owner: {
+                                        readonly type: "object";
+                                        readonly additionalProperties: false;
+                                        readonly required: readonly ["kind", "id"];
+                                        readonly properties: {
+                                            readonly kind: {
+                                                readonly type: "string";
+                                                readonly enum: readonly ["campaign", "find_leads_run"];
+                                            };
+                                            readonly id: {
+                                                readonly type: "string";
+                                            };
+                                        };
+                                    };
+                                    readonly basisFingerprint: {
+                                        readonly type: "string";
+                                    };
+                                };
+                            };
+                            readonly sourceLineage: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly priorYieldReceipt: {
+                                readonly type: readonly ["object", "null"];
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["family", "evaluated", "passes"];
+                                readonly properties: {
+                                    readonly family: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
+                                    };
+                                    readonly evaluated: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    };
+                                    readonly passes: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    };
+                                };
+                            };
+                            readonly searchedNegativeSetFingerprints: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly remainingGap: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly supply: {
+                                readonly type: "object";
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["readyToSchedule", "readyForApproval", "readyForMessageGeneration", "needsEnrichment"];
+                                readonly properties: {
+                                    readonly readyToSchedule: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    };
+                                    readonly readyForApproval: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    };
+                                    readonly readyForMessageGeneration: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    };
+                                    readonly needsEnrichment: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                    };
+                                };
+                            };
+                            readonly activeJob: {
+                                readonly type: readonly ["object", "null"];
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["id", "kind", "status"];
+                                readonly properties: {
+                                    readonly id: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                    };
+                                    readonly kind: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["enrichment", "message_generation", "source_expansion", "scheduling"];
+                                    };
+                                    readonly status: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["queued", "running"];
+                                    };
+                                };
+                            };
+                            readonly failedJobRef: {
+                                readonly type: readonly ["string", "null"];
+                            };
+                            readonly diagnosticRowRef: {
+                                readonly type: readonly ["object", "null"];
+                                readonly additionalProperties: false;
+                                readonly required: readonly ["count", "selectorRef"];
+                                readonly properties: {
+                                    readonly count: {
+                                        readonly type: "integer";
+                                        readonly minimum: 0;
+                                        readonly maximum: 10;
+                                    };
+                                    readonly selectorRef: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                    };
+                                };
+                            };
+                            readonly repairableExistingRows: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly retryExhaustedRows: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly laneSchedulable: {
+                                readonly type: readonly ["integer", "null"];
+                                readonly minimum: 0;
+                            };
+                        };
+                    };
+                };
+            }>;
+            readonly decision: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["scopeEcho", "actions", "consumedDiagnosticRowIds"];
+                readonly properties: {
+                    readonly scopeEcho: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["campaignId", "tableId", "campaignVersion", "evidenceFingerprint"];
+                        readonly properties: {
+                            readonly campaignId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly tableId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly campaignVersion: {
+                                readonly type: "integer";
+                            };
+                            readonly evidenceFingerprint: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                    };
+                    readonly actions: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 1;
+                        readonly items: Readonly<{
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["action", "rationale"];
+                            readonly properties: {
+                                readonly action: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["rerun_errored_cells", "repair_campaign_config", "enrich_bounded_sample", "regenerate_stale_messages", "patch_filter_criteria", "patch_source_criteria", "broaden_source_family", "request_rubric_trial", "await_active_job", "record_source_frontier_exhausted"];
+                                };
+                                readonly rationale: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly rowIds: {
+                                    readonly type: readonly ["array", "null"];
+                                    readonly items: {
+                                        readonly type: "string";
+                                        readonly minLength: 1;
+                                    };
+                                };
+                                readonly sourceCommand: {
+                                    readonly type: readonly ["object", "null"];
+                                };
+                                readonly candidateVerdicts: {
+                                    readonly type: readonly ["array", "null"];
+                                    readonly items: {
+                                        readonly type: "object";
+                                        readonly additionalProperties: false;
+                                        readonly required: readonly ["candidateId", "verdict", "rubricBasis"];
+                                        readonly properties: {
+                                            readonly candidateId: {
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            };
+                                            readonly verdict: {
+                                                readonly type: "string";
+                                                readonly enum: readonly ["pass", "fail"];
+                                            };
+                                            readonly rubricBasis: {
+                                                readonly type: "string";
+                                                readonly minLength: 1;
+                                            };
+                                        };
+                                    };
+                                };
+                                readonly templateFingerprint: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly templateMeaningChanged: {
+                                    readonly type: "boolean";
+                                };
+                                readonly exhaustionEvidence: {
+                                    readonly type: readonly ["object", "null"];
+                                };
+                                readonly providerPromptRef: {
+                                    readonly type: readonly ["object", "null"];
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["provider", "campaignOfferId"];
+                                    readonly properties: {
+                                        readonly provider: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly campaignOfferId: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                    };
+                                };
+                            };
+                        }>;
+                    };
+                    readonly consumedDiagnosticRowIds: {
+                        readonly type: readonly ["array", "null"];
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                };
+            };
+        };
+    }>;
+    outputSchema: Readonly<{
+        readonly type: "object";
+        readonly required: readonly ["kind"];
+        readonly properties: {
+            readonly kind: {
+                readonly type: "string";
+                readonly enum: readonly ["world_advanced", "attention_refresh_required", "campaign_work_completed"];
+            };
+            readonly advanceResult: {
+                readonly type: "object";
+            };
+            readonly outcome: {
+                readonly type: "object";
+            };
+        };
+        readonly additionalProperties: false;
+    }>;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+}[];
+export type RefillV3ContinueInput = {
+    workspaceId: string;
+    scope: unknown;
+    yolo?: boolean;
+    packet: RefillV3CampaignAttentionPacket;
+    decision: unknown;
+};
+export type RefillV3ContinueResult = {
+    kind: "world_advanced";
+    advanceResult: RefillV3AdvanceResult;
+} | {
+    kind: "attention_refresh_required";
+    advanceResult: RefillV3AdvanceResult;
+} | {
+    kind: "campaign_work_completed";
+    outcome: RefillV3CampaignWorkOutcome;
+};
+export type RefillV3ContinueDependencies = {
+    advance(input: RefillV3AdvanceToolInput): Promise<RefillV3AdvanceResult>;
+    runCampaignWork(input: {
+        packet: RefillV3CampaignAttentionPacket;
+        output: unknown;
+    }): Promise<RefillV3CampaignWorkOutcome>;
+};
+type RefillV3ContinueProductionOwners = {
+    selectCampaignCells: typeof selectCampaignCells;
+    selectRepairableCampaignCells: typeof selectRepairableCampaignCells;
+    getPrepareCampaignMessagesStatus: typeof getPrepareCampaignMessagesStatus;
+    startPrepareCampaignMessages: typeof startPrepareCampaignMessages;
+    getProviderPrompt: typeof getProviderPrompt;
+    executeRerunErroredCellsPrimitive: typeof executeRerunErroredCellsPrimitive;
+    refillV3SourceFamilyOwners: typeof refillV3SourceFamilyOwners;
+    dispatchRefillV3SourceFamily: typeof dispatchRefillV3SourceFamily;
+    broadenRubrics: typeof broadenRubrics;
+    getRefillV3WorldStateTool: typeof getRefillV3WorldStateTool;
+};
+export declare function runRefillV3CampaignWorkWithProductionOwners(input: {
+    packet: RefillV3CampaignAttentionPacket;
+    output: unknown;
+}, owners?: RefillV3ContinueProductionOwners): Promise<RefillV3CampaignWorkOutcome>;
+export declare function continueRefillV3(input: RefillV3ContinueInput, dependencies?: RefillV3ContinueDependencies): Promise<RefillV3ContinueResult>;
+export declare function continueRefillV3Tool(input: {
+    workspaceId?: string;
+    scope?: unknown;
+    yolo?: boolean;
+    packet?: unknown;
+    decision?: unknown;
+}): Promise<RefillV3ContinueResult>;
+import { getPrepareCampaignMessagesStatus, startPrepareCampaignMessages } from "./campaign-message-preparation.js";
+import { selectCampaignCells, selectRepairableCampaignCells } from "./campaign-processing.js";
+import { getProviderPrompt } from "./leads.js";
+import { broadenRubrics, executeRerunErroredCellsPrimitive, refillV3SourceFamilyOwners } from "./refill-executors.js";
+export {};