@sellable/mcp 0.1.910 → 0.1.912

package/dist/tools/direct-campaigns.js

@@ -35,7 +35,7 @@ function sanitizeForCampaign(text) {
 export const directCampaignToolDefinitions = [
     {
         name: "add_to_inmail_campaign",
-        description: "Add leads to a sender's InMail direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        description: "Add leads with caller-authored Subject and Message copy to a sender's direct InMail execution queue. This is the canonical one-off InMail path when recipients and exact copy are already known; it auto-creates the correctly typed table and dedupes by default. Do not create a normal campaign or a Generate Message column for this shape.",
         inputSchema: {
             type: "object",
             properties: {
@@ -63,7 +63,7 @@ export const directCampaignToolDefinitions = [
     },
     {
         name: "add_to_connection_campaign",
-        description: "Add leads to a sender's Connection direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        description: "Add leads with caller-authored Message copy to a sender's direct Connection execution queue. This is the canonical one-off connection-plus-DM path when recipients and exact copy are already known; it auto-creates the correctly typed table and dedupes by default.",
         inputSchema: {
             type: "object",
             properties: {
@@ -158,7 +158,7 @@ export const directCampaignToolDefinitions = [
     },
     {
         name: "start_direct_campaign",
-        description: "Start a direct campaign for a sender (sets status to ACTIVE).",
+        description: "Start the sender's canonical direct campaign after its rows/copy are reviewed and the user explicitly approves launch (sets status to ACTIVE). Use the same type passed to the add tool. Do not use start_campaign for a table created by add_to_inmail_campaign or add_to_connection_campaign.",
         inputSchema: {
             type: "object",
             properties: {
@@ -200,7 +200,7 @@ export const directCampaignToolDefinitions = [
     },
     {
         name: "get_or_create_direct_campaign_table",
-        description: "Get or create the direct campaign workflow table for a sender and type (comment_campaign, inmail_campaign, connection_campaign, post_campaign). Returns the tableId and whether it was created.",
+        description: "Inspect or explicitly create the canonical direct campaign workflow table for a sender and type (comment_campaign, inmail_campaign, connection_campaign, post_campaign). Usually call the matching add_to_* tool instead because it creates the table and rows together. Returns the tableId and whether it was created.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/one-off.js

@@ -73,7 +73,7 @@ export const onDemandToolDefinitions = [
     },
     {
         name: "create_on_demand_campaign",
-        description: "Create a lightweight CampaignOffer + workflow table, set senders, and initialize sequence columns. Auto-selects template by sender tiers unless provided.\n\n" +
+        description: "Create a lightweight general CampaignOffer + workflow table, set senders, and initialize sequence columns. This is not the caller-authored direct InMail path: when exact recipients, Subject, and Message are already supplied, use add_to_inmail_campaign and start_direct_campaign instead. Auto-selects template by sender tiers unless provided.\n\n" +
             "INPUTS: Pass EITHER clientProspectId (existing prospect ID) OR senderLinkedinUrl (sender's LinkedIn profile URL). One is required.",
         inputSchema: {
             type: "object",
@@ -149,7 +149,7 @@ export const onDemandToolDefinitions = [
     },
     {
         name: "start_on_demand_campaign",
-        description: "Start an on-demand campaign table (set campaignStatus ACTIVE).",
+        description: "Start a general on-demand campaign table (set campaignStatus ACTIVE). Do not use this for a typed direct InMail/Connection table; use start_direct_campaign with the matching type.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/tools/refill-v3-attention-packet-contract.d.ts

@@ -270,7 +270,7 @@ export declare const REFILL_V3_EXHAUSTION_PREDICATE_CONSUMERS: readonly ["mcp/se
  * this constant and GENERATES its prompt's allowed-action list from it; wave 8
  * consumes it. Neither may declare a second list (error law 1).
  */
-export declare const REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS: 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"];
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS: readonly ["copy_selected_source_rows", "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"];
 export type RefillV3CampaignAttentionAction = (typeof REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS)[number];
 /**
  * The genuinely judgment-bearing subset exposed to the model.
@@ -288,7 +288,7 @@ export type RefillV3ModelCampaignAttentionAction = (typeof REFILL_V3_MODEL_CAMPA
  * the AI records exhaustion through `record_source_frontier_exhausted`, and the
  * deterministic authority answers with the result.
  */
-export declare const REFILL_V3_CAMPAIGN_ATTENTION_RESULTS: readonly ["cells_rerun", "campaign_config_repaired", "bounded_sample_enriched", "stale_messages_regenerated", "filter_criteria_patched", "source_criteria_patched", "source_family_broadened", "rubric_trial_requested", "active_job_awaited", "source_frontier_exhausted", "health_recheck_required", "no_action_available"];
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_RESULTS: readonly ["selected_source_rows_copied", "cells_rerun", "campaign_config_repaired", "bounded_sample_enriched", "stale_messages_regenerated", "filter_criteria_patched", "source_criteria_patched", "source_family_broadened", "rubric_trial_requested", "active_job_awaited", "source_frontier_exhausted", "health_recheck_required", "no_action_available"];
 export type RefillV3CampaignAttentionResult = (typeof REFILL_V3_CAMPAIGN_ATTENTION_RESULTS)[number];
 /**
  * Prompt assets that must GENERATE their allowed outputs from the constants
@@ -359,6 +359,8 @@ export type RefillV3CampaignAttentionEvidence = {
     provider: string | null;
     /** Exact selected source table, when the campaign has one. */
     selectedLeadListId?: string | null;
+    /** Exact bounded source rows proven absent from the campaign table. */
+    netNewSourceRowIds?: string[];
     /**
      * Ownership-proven reusable saved-search authority for cold providers.
      * Loaded server-side through the existing target-plan resolver; callers and
@@ -513,6 +515,14 @@ export declare const REFILL_V3_CAMPAIGN_ATTENTION_PACKET_SCHEMA: Readonly<{
                 readonly selectedLeadListId: {
                     readonly type: readonly ["string", "null"];
                 };
+                readonly netNewSourceRowIds: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly uniqueItems: true;
+                };
                 readonly providerSearchReference: {
                     readonly type: readonly ["object", "null"];
                     readonly additionalProperties: false;
@@ -590,7 +600,7 @@ export declare const REFILL_V3_CAMPAIGN_ATTENTION_PACKET_SCHEMA: Readonly<{
                     readonly uniqueItems: true;
                     readonly items: {
                         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 enum: readonly ["copy_selected_source_rows", "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 sourceSearchReceipts: {

package/dist/tools/refill-v3-attention-packet-contract.js

@@ -344,6 +344,7 @@ export const REFILL_V3_EXHAUSTION_PREDICATE_CONSUMERS = [
  * consumes it. Neither may declare a second list (error law 1).
  */
 export const REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS = [
+    "copy_selected_source_rows",
     "rerun_errored_cells",
     "repair_campaign_config",
     "enrich_bounded_sample",
@@ -379,6 +380,7 @@ export const REFILL_V3_MODEL_CAMPAIGN_ATTENTION_ACTIONS = [
  * deterministic authority answers with the result.
  */
 export const REFILL_V3_CAMPAIGN_ATTENTION_RESULTS = [
+    "selected_source_rows_copied",
     "cells_rerun",
     "campaign_config_repaired",
     "bounded_sample_enriched",
@@ -589,6 +591,11 @@ export const REFILL_V3_CAMPAIGN_ATTENTION_PACKET_SCHEMA = Object.freeze({
                 },
                 provider: { type: ["string", "null"] },
                 selectedLeadListId: { type: ["string", "null"] },
+                netNewSourceRowIds: {
+                    type: "array",
+                    items: { type: "string", minLength: 1 },
+                    uniqueItems: true,
+                },
                 providerSearchReference: {
                     type: ["object", "null"],
                     additionalProperties: false,
@@ -1114,6 +1121,12 @@ function decodeEvidence(value) {
         !isNonEmptyString(selectedLeadListId)) {
         return null;
     }
+    const netNewSourceRowIds = "netNewSourceRowIds" in value ? value.netNewSourceRowIds : undefined;
+    if (netNewSourceRowIds !== undefined &&
+        (!isStringArray(netNewSourceRowIds) ||
+            new Set(netNewSourceRowIds).size !== netNewSourceRowIds.length)) {
+        return null;
+    }
     const providerSearchReference = "providerSearchReference" in value
         ? decodeProviderSearchReference(value.providerSearchReference)
         : undefined;
@@ -1142,6 +1155,9 @@ function decodeEvidence(value) {
         leadSourceFamily: value.leadSourceFamily,
         provider: value.provider,
         ...(selectedLeadListId === undefined ? {} : { selectedLeadListId }),
+        ...(netNewSourceRowIds === undefined
+            ? {}
+            : { netNewSourceRowIds: [...netNewSourceRowIds] }),
         ...(providerSearchReference === undefined
             ? {}
             : { providerSearchReference: providerSearchReference.value }),
@@ -1235,6 +1251,11 @@ export function encodeRefillV3CampaignAttentionPacket(packet) {
             ...(packet.evidence.selectedLeadListId === undefined
                 ? {}
                 : { selectedLeadListId: packet.evidence.selectedLeadListId }),
+            ...(packet.evidence.netNewSourceRowIds === undefined
+                ? {}
+                : {
+                    netNewSourceRowIds: [...packet.evidence.netNewSourceRowIds],
+                }),
             ...(packet.evidence.providerSearchReference === undefined
                 ? {}
                 : {

package/dist/tools/refill-v3-campaign-work-receipt-contract.d.ts

@@ -27,9 +27,10 @@
  * through the source-cycle route; config edits persist through the
  * edit-selected-campaign route.
  */
-export declare const REFILL_V3_CAMPAIGN_WORK_RECEIPT_ACTIONS: readonly ["enrich_bounded_sample", "await_active_job", "rerun_errored_cells", "regenerate_stale_messages", "broaden_source_family", "patch_filter_criteria", "patch_source_criteria"];
+export declare const REFILL_V3_CAMPAIGN_WORK_RECEIPT_ACTIONS: readonly ["enrich_bounded_sample", "await_active_job", "rerun_errored_cells", "regenerate_stale_messages", "broaden_source_family", "patch_filter_criteria", "patch_source_criteria", "copy_selected_source_rows"];
 export type RefillV3CampaignWorkReceiptAction = (typeof REFILL_V3_CAMPAIGN_WORK_RECEIPT_ACTIONS)[number];
 export declare const REFILL_V3_CAMPAIGN_WORK_ACTION_KINDS: Readonly<{
+    readonly copy_selected_source_rows: "campaign_work_copy_selected_source_rows";
     readonly enrich_bounded_sample: "campaign_work_enrich_bounded_sample";
     readonly await_active_job: "campaign_work_await_active_job";
     readonly rerun_errored_cells: "campaign_work_rerun_errored_cells";

package/dist/tools/refill-v3-campaign-work-receipt-contract.js

@@ -35,8 +35,10 @@ export const REFILL_V3_CAMPAIGN_WORK_RECEIPT_ACTIONS = [
     "broaden_source_family",
     "patch_filter_criteria",
     "patch_source_criteria",
+    "copy_selected_source_rows",
 ];
 export const REFILL_V3_CAMPAIGN_WORK_ACTION_KINDS = Object.freeze({
+    copy_selected_source_rows: "campaign_work_copy_selected_source_rows",
     enrich_bounded_sample: "campaign_work_enrich_bounded_sample",
     await_active_job: "campaign_work_await_active_job",
     rerun_errored_cells: "campaign_work_rerun_errored_cells",

package/dist/tools/refill-v3-campaign-work.d.ts

@@ -68,6 +68,7 @@ export declare const REFILL_V3_FORBIDDEN_COMMAND_KEYS: readonly ["batchSize", "c
 export declare const REFILL_V3_PREPARATION_REUSE_POINTS: readonly ["frontier", "remainingGapPassEvidence", "serialBatchCap", "totalRowBudget", "replayKey", "lowPassGuard", "reclaimBehavior"];
 export type RefillV3PreparationReusePoint = (typeof REFILL_V3_PREPARATION_REUSE_POINTS)[number];
 declare const ACTION: {
+    copySelectedSourceRows: "copy_selected_source_rows";
     rerunErroredCells: "rerun_errored_cells";
     repairCampaignConfig: "repair_campaign_config";
     enrichBoundedSample: "enrich_bounded_sample";
@@ -82,7 +83,7 @@ declare const ACTION: {
 /** Actions that may only be chosen once the bounded sample is ENRICHED. */
 export declare const REFILL_V3_ENRICHMENT_GATED_ACTIONS: readonly ["request_rubric_trial", "broaden_source_family", "record_source_frontier_exhausted"];
 /** Actions that OUTRANK rubric relaxation and source broadening. */
-export declare const REFILL_V3_REPAIR_FIRST_ACTIONS: readonly ["rerun_errored_cells", "repair_campaign_config", "enrich_bounded_sample", "regenerate_stale_messages", "patch_filter_criteria", "patch_source_criteria"];
+export declare const REFILL_V3_REPAIR_FIRST_ACTIONS: readonly ["copy_selected_source_rows", "rerun_errored_cells", "repair_campaign_config", "enrich_bounded_sample", "regenerate_stale_messages", "patch_filter_criteria", "patch_source_criteria"];
 /** Row-scoped actions whose exact cohort is owned by the diagnostic authority. */
 export declare const REFILL_V3_ROW_SCOPED_ACTIONS: readonly ["rerun_errored_cells", "enrich_bounded_sample", "regenerate_stale_messages"];
 /** Actions that carry a bounded source command. */

package/dist/tools/refill-v3-campaign-work.js

@@ -140,6 +140,7 @@ export const REFILL_V3_ENRICHMENT_GATED_ACTIONS = [
 ];
 /** Actions that OUTRANK rubric relaxation and source broadening. */
 export const REFILL_V3_REPAIR_FIRST_ACTIONS = [
+    ACTION.copySelectedSourceRows,
     ACTION.rerunErroredCells,
     ACTION.repairCampaignConfig,
     ACTION.enrichBoundedSample,
@@ -160,6 +161,7 @@ export const REFILL_V3_SOURCE_ACTIONS = [
 ];
 /** One deterministic result per chosen action. */
 export const REFILL_V3_ACTION_RESULTS = Object.freeze({
+    [ACTION.copySelectedSourceRows]: RESULT.selectedSourceRowsCopied,
     [ACTION.rerunErroredCells]: RESULT.cellsRerun,
     [ACTION.repairCampaignConfig]: RESULT.campaignConfigRepaired,
     [ACTION.enrichBoundedSample]: RESULT.boundedSampleEnriched,

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

@@ -1,6 +1,7 @@
 import { handleAddColumn } from "./blueprint-commit.js";
 import { getCampaignTableSchema } from "./campaign-processing.js";
 import { handleUpdateColumn } from "./column-update.js";
+import { executeOneYoloPrimitive } from "./refill-executors.js";
 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";
@@ -509,6 +510,7 @@ type RefillV3ContinueProductionOwners = {
     startPrepareCampaignMessages: typeof startPrepareCampaignMessages;
     getProviderPrompt: typeof getProviderPrompt;
     executeRerunErroredCellsPrimitive: typeof executeRerunErroredCellsPrimitive;
+    executeOneYoloPrimitive: typeof executeOneYoloPrimitive;
     refillV3SourceFamilyOwners: typeof refillV3SourceFamilyOwners;
     dispatchRefillV3SourceFamily: typeof dispatchRefillV3SourceFamily;
     broadenRubrics: typeof broadenRubrics;

package/dist/tools/refill-v3-continue.js

@@ -3,6 +3,7 @@ import { SellableApiError, getApi } from "../api.js";
 import { handleAddColumn } from "./blueprint-commit.js";
 import { getCampaignTableSchema, waitForCampaignProcessing, } from "./campaign-processing.js";
 import { handleUpdateColumn } from "./column-update.js";
+import { executeOneYoloPrimitive } from "./refill-executors.js";
 import { advanceRefillV3Tool, } from "./refill-v3-advance.js";
 import { REFILL_V3_EXHAUSTION_PREDICATE, REFILL_V3_POSTS_SEARCH_SPENT_AVENUE, } from "./refill-v3-attention-packet-contract.js";
 import { isRefillV3CampaignWorkReceiptAction, } from "./refill-v3-campaign-work-receipt-contract.js";
@@ -17,7 +18,7 @@ export const REFILL_V3_CONTINUE_TOOL_NAME = "refill_v3_continue";
 export const refillV3ContinueToolDefinitions = [
     {
         name: REFILL_V3_CONTINUE_TOOL_NAME,
-        description: "Continue exactly one server-issued Refill V3 campaign-attention packet. Call first without decision: after a fresh revalidation, the tool deterministically owns live-job waiting, exact actionable enrichment, and same-template message generation. It returns model_decision_required only when the accurate packet needs a genuine repair, criteria, rubric, waterfall, or source-expansion judgment; then call again with that one closed decision. Only an exact fresh packet can dispatch one existing campaign-work authority, which re-observes the exact sender/date and settles before a sibling campaign may advance. The caller cannot supply batch sizes, readiness digests, retry counters, fill inputs, scheduler inputs, or idempotency keys.",
+        description: "Continue exactly one server-issued Refill V3 campaign-attention packet. Call first without decision: after a fresh revalidation, the tool deterministically owns live-job waiting, selected-source row copying, exact actionable enrichment, and same-template message generation. It returns model_decision_required only when the accurate packet needs a genuine repair, criteria, rubric, waterfall, or source-expansion judgment; then call again with that one closed decision. Only an exact fresh packet can dispatch one existing campaign-work authority, which re-observes the exact sender/date and settles before a sibling campaign may advance. The caller cannot supply batch sizes, readiness digests, retry counters, fill inputs, scheduler inputs, or idempotency keys.",
         inputSchema: REFILL_V3_CONTINUE_INPUT_SCHEMA,
         outputSchema: REFILL_V3_CONTINUE_OUTPUT_SCHEMA,
         annotations: {
@@ -171,6 +172,7 @@ const DEFAULT_PRODUCTION_OWNERS = {
     startPrepareCampaignMessages,
     getProviderPrompt,
     executeRerunErroredCellsPrimitive,
+    executeOneYoloPrimitive,
     refillV3SourceFamilyOwners,
     dispatchRefillV3SourceFamily,
     broadenRubrics,
@@ -370,6 +372,64 @@ export async function runRefillV3CampaignWorkWithProductionOwners(input, owners
         },
         async dispatchAuthority(request) {
             const result = REFILL_V3_ACTION_RESULTS[request.action];
+            if (request.action === "copy_selected_source_rows") {
+                const sourceLeadListId = input.packet.evidence.selectedLeadListId;
+                const sourceFingerprint = input.packet.evidence.sourceLineage.at(-1) ?? null;
+                const sourceRowIds = [
+                    ...new Set(input.packet.evidence.netNewSourceRowIds ?? []),
+                ];
+                if (!sourceLeadListId ||
+                    !sourceFingerprint ||
+                    sourceRowIds.length === 0) {
+                    return receipt({
+                        outcome: "refused",
+                        result,
+                        idempotencyKey: request.idempotencyKey,
+                        refusalReason: "selected_source_copy_requires_exact_list_fingerprint_and_rows",
+                    });
+                }
+                const attempt = await owners.executeOneYoloPrimitive({
+                    type: "copy_selected_source_rows",
+                    yoloEligible: true,
+                    leadSourceProvider: input.packet.evidence.provider,
+                    ids: {
+                        campaignId: request.scope.campaignId,
+                        sourceLeadListId,
+                        sourceFingerprint,
+                    },
+                    toolInput: {
+                        campaignOfferId: request.scope.campaignId,
+                        sourceLeadListId,
+                        sourceFingerprint,
+                        leadSourceProvider: input.packet.evidence.provider,
+                        sourceRowIds,
+                        sourceRowLimit: sourceRowIds.length,
+                    },
+                }, request.scope.workspaceId);
+                if (attempt.status === "executed_and_reread") {
+                    return receipt({
+                        outcome: "applied",
+                        result,
+                        idempotencyKey: request.idempotencyKey,
+                        changedFields: ["campaignSourceRows"],
+                        after: attempt.result,
+                    });
+                }
+                if (attempt.status === "read_only_reread") {
+                    return receipt({
+                        outcome: "no_effect",
+                        result,
+                        idempotencyKey: request.idempotencyKey,
+                        after: attempt.result,
+                    });
+                }
+                return receipt({
+                    outcome: "refused",
+                    result,
+                    idempotencyKey: request.idempotencyKey,
+                    refusalReason: attempt.refusalReason ?? "selected_source_copy_not_executed",
+                });
+            }
             if (request.action === "enrich_bounded_sample") {
                 // V3.1 · V31-BATCH-001: the deterministic batch ladder. An exact
                 // diagnostic frontier is the first calibration cohort. After that
@@ -1223,9 +1283,16 @@ function deterministicCampaignDecision(packet) {
         const cellRepairIsUnspent = !settledNoProgressActions.has("rerun_errored_cells");
         const needsModelRepair = evidence.configurationDefect != null ||
             (cellRepairIsUnspent && evidence.failedJobRef !== null);
-        if (needsModelRepair)
+        if (!settledNoProgressActions.has("copy_selected_source_rows") &&
+            evidence.selectedLeadListId &&
+            evidence.sourceLineage.length > 0 &&
+            (evidence.netNewSourceRowIds?.length ?? 0) > 0) {
+            action = "copy_selected_source_rows";
+        }
+        else if (needsModelRepair) {
             return null;
-        if (!settledNoProgressActions.has("enrich_bounded_sample") &&
+        }
+        else if (!settledNoProgressActions.has("enrich_bounded_sample") &&
             evidence.diagnosticRowRef?.selectorRef ===
                 "needsEnrichment:actionable:v1" &&
             evidence.diagnosticRowRef.count > 0) {

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -77,6 +77,10 @@ allowed-tools:
   - mcp__sellable__attach_sequence
   - mcp__sellable__attach_recommended_sequence
   - mcp__sellable__start_campaign
+  - mcp__sellable__add_to_inmail_campaign
+  - mcp__sellable__add_to_connection_campaign
+  - mcp__sellable__get_or_create_direct_campaign_table
+  - mcp__sellable__start_direct_campaign
 ---
 
 # Sellable Create Campaign
@@ -86,6 +90,30 @@ It bootstraps auth and host capabilities, then loads the internal
 the internal campaign workflow prompt and `core/flow.v2.json` through MCP. Keep
 this wrapper thin; the packaged workflow is the operational source of truth.
 
+## Direct Manual-Copy Campaign Routing
+
+Route a bounded one-off request to the direct campaign tools when the user
+already supplies the recipients and exact message copy. For InMail, require a
+LinkedIn URL, Subject, and Message per row, select the intended sender, then use
+`add_to_inmail_campaign`. For a connection-plus-DM request, use
+`add_to_connection_campaign`. These tools create or reuse the canonical typed
+execution-queue table; do not call `create_campaign`,
+`create_on_demand_campaign`, or a connection helper first.
+
+Do not create a normal Campaign Builder Generate Message column, rewrite the
+approved manual copy, or repair the typed direct table merely because its
+message is stored in a plain `Message` text column. That is the owned schema for
+`inmail_campaign` and `connection_campaign` tables.
+
+Show the bounded recipients and exact copy for review before adding rows. Never
+call `start_direct_campaign` until the user explicitly approves launch. When
+approved, start the same direct type used by the add tool; do not call
+`start_campaign` for that table.
+
+Billing diagnostics are not launch authority. Honor a billing error returned by
+the actual add/start mutation, but never interpret `billing_required`
+diagnostics as an enforced block when the billing rollout gate is disabled.
+
 ## Inbox Reply Tool Boundary
 
 Inbox reply tools are outside campaign creation. If a user asks to search,
@@ -291,6 +319,7 @@ only from a source that can describe this turn:
   context. Do not infer an ID from the friendly name, do not infer effort from
   `alwaysThinkingEnabled`, and do not show this self-report to the user during
   normal campaign setup.
+
 - Do not run a nested `claude -p`, inspect `~/.claude/settings.json`, or read
   Claude CLI defaults as proof of the user's active Claude Code session. Those
   checks can validate a new child session or saved defaults, but not this