@sellable/mcp 0.1.864 → 0.1.865

package/dist/tools/refill-v3-advance-contract.d.ts

@@ -51,14 +51,14 @@ export declare function resolveRefillV3AdvanceSchemaVersion(value: unknown): Ref
  * The MCP transport retains exact backend-issued bytes for the current command;
  * callers neither author nor copy credentials.
  */
-export declare const REFILL_V3_ADVANCE_INPUT_KEYS: readonly ["workspaceId", "scope", "yolo"];
+export declare const REFILL_V3_ADVANCE_INPUT_KEYS: readonly ["workspaceId", "scope", "campaignId", "yolo"];
 export type RefillV3AdvanceInputKey = (typeof REFILL_V3_ADVANCE_INPUT_KEYS)[number];
 /**
  * The private MCP-to-backend request adds exactly one credential. The public
  * tool schema below intentionally stays on `REFILL_V3_ADVANCE_INPUT_KEYS`, so
  * a model cannot supply this field even though the backend must decode it.
  */
-export declare const REFILL_V3_ADVANCE_TRANSPORT_INPUT_KEYS: readonly ["workspaceId", "scope", "yolo", "runToken"];
+export declare const REFILL_V3_ADVANCE_TRANSPORT_INPUT_KEYS: readonly ["workspaceId", "scope", "campaignId", "yolo", "runToken"];
 /** The keys a caller MUST supply. `yolo` is optional and defaults to false. */
 export declare const REFILL_V3_ADVANCE_REQUIRED_INPUT_KEYS: readonly ["workspaceId", "scope"];
 /**
@@ -77,6 +77,12 @@ export declare const REFILL_V3_ADVANCE_INPUT_SCHEMA: Readonly<{
             readonly minLength: 1;
             readonly description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.";
         };
+        readonly campaignId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly pattern: "\\S";
+            readonly description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.";
+        };
         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 [{
@@ -175,9 +181,9 @@ export type RefillV3AdvanceTerminalCode = (typeof REFILL_V3_ADVANCE_TERMINAL_COD
  * which already extends the world-state vocabulary, so retryability stays a
  * property of the code rather than of a call site.
  */
-export declare const REFILL_V3_ADVANCE_ONLY_REASON_CODES: readonly ["account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+export declare const REFILL_V3_ADVANCE_ONLY_REASON_CODES: readonly ["account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
 export type RefillV3AdvanceOnlyReasonCode = (typeof REFILL_V3_ADVANCE_ONLY_REASON_CODES)[number];
-export declare const REFILL_V3_ADVANCE_REASON_CODES: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+export declare const REFILL_V3_ADVANCE_REASON_CODES: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
 export type RefillV3AdvanceReasonCode = (typeof REFILL_V3_ADVANCE_REASON_CODES)[number];
 export declare const REFILL_V3_ADVANCE_RECEIPT_STATUSES: readonly ["executed", "attached", "failed", "indeterminate"];
 export type RefillV3AdvanceReceiptStatus = (typeof REFILL_V3_ADVANCE_RECEIPT_STATUSES)[number];
@@ -195,6 +201,7 @@ export declare const REFILL_V3_ADVANCE_FORBIDDEN_RESULT_KEYS: readonly ["rows",
 export type RefillV3AdvanceScopeEcho = {
     workspaceId: string;
     scopeKind: "sender_local_horizon" | "exact_sender_dates";
+    campaignId?: string;
     /** Stable identity of the requested scope. Never a clock or a nonce. */
     scopeFingerprint: string;
 };
@@ -408,6 +415,10 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                     readonly type: "string";
                     readonly minLength: 1;
                 };
+                readonly campaignId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
                 readonly scopeKind: {
                     readonly type: "string";
                     readonly enum: readonly ["sender_local_horizon", "exact_sender_dates"];
@@ -486,7 +497,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                 };
                 readonly reasonCode: {
                     readonly type: readonly ["string", "null"];
-                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch", null];
+                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch", null];
                 };
                 readonly approvedCount: {
                     readonly type: "integer";
@@ -537,7 +548,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                             readonly type: "array";
                             readonly items: {
                                 readonly type: "string";
-                                readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                             };
                         };
                     };
@@ -561,7 +572,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
             readonly properties: {
                 readonly code: {
                     readonly type: "string";
-                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                 };
                 readonly message: {
                     readonly type: "string";
@@ -596,7 +607,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
             readonly properties: {
                 readonly code: {
                     readonly type: "string";
-                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                 };
                 readonly message: {
                     readonly type: "string";
@@ -755,7 +766,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                                 readonly type: "array";
                                 readonly items: {
                                     readonly type: "string";
-                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                 };
                             };
                         };
@@ -885,7 +896,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                                 readonly type: "array";
                                 readonly items: {
                                     readonly type: "string";
-                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                 };
                             };
                         };
@@ -1015,7 +1026,7 @@ export declare const REFILL_V3_ADVANCE_OUTPUT_SCHEMA: Readonly<{
                                 readonly type: "array";
                                 readonly items: {
                                     readonly type: "string";
-                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                 };
                             };
                         };

package/dist/tools/refill-v3-advance-contract.js

@@ -62,6 +62,7 @@ export function resolveRefillV3AdvanceSchemaVersion(value) {
 export const REFILL_V3_ADVANCE_INPUT_KEYS = [
     "workspaceId",
     "scope",
+    "campaignId",
     "yolo",
 ];
 /**
@@ -156,6 +157,12 @@ export const REFILL_V3_ADVANCE_INPUT_SCHEMA = Object.freeze({
             minLength: 1,
             description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.",
         },
+        campaignId: {
+            type: "string",
+            minLength: 1,
+            pattern: "\\S",
+            description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.",
+        },
         scope: {
             ...ADVANCE_SCOPE_SCHEMA,
             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.",
@@ -264,6 +271,24 @@ export const REFILL_V3_ADVANCE_ONLY_REASON_CODES = [
      * is a refusal rather than an executed mutation.
      */
     "workspace_membership_revoked",
+    /** The stable target no longer exists in the authorized workspace. */
+    "campaign_target_missing",
+    /** The stable target changed between two authority-bound observations. */
+    "campaign_target_stale",
+    /** The target exists but is not currently active. */
+    "campaign_target_inactive",
+    /** The target is outside the request's authorized workspace. */
+    "campaign_target_unauthorized",
+    /** The target does not belong to the requested sender scope. */
+    "campaign_target_sender_incompatible",
+    /** The target cannot serve the selected lane. */
+    "target_lane_incompatible",
+    /** The target has no compatible schedulable action. */
+    "campaign_target_action_incompatible",
+    /** The exact target has no remaining supply for this request. */
+    "campaign_target_exhausted",
+    /** An explicit continuation target differs from its retained run target. */
+    "campaign_target_identity_mismatch",
     // ── V32-CONT-001 · the presented RUN CREDENTIAL.
     //
     // Each is a statement the caller made about CONTINUITY that this server could
@@ -435,6 +460,7 @@ const SCOPE_ECHO_SCHEMA = {
     required: ["workspaceId", "scopeKind", "scopeFingerprint"],
     properties: {
         workspaceId: { type: "string", minLength: 1 },
+        campaignId: { type: "string", minLength: 1 },
         scopeKind: {
             type: "string",
             enum: ["sender_local_horizon", "exact_sender_dates"],
@@ -884,11 +910,13 @@ function decodeTerminalEvidence(value) {
 function decodeScopeEcho(value) {
     if (!isRecord(value))
         return null;
-    const keys = ["workspaceId", "scopeKind", "scopeFingerprint"];
-    if (!onlyKeys(value, keys) || keys.some((key) => !(key in value)))
+    const requiredKeys = ["workspaceId", "scopeKind", "scopeFingerprint"];
+    const keys = [...requiredKeys, "campaignId"];
+    if (!onlyKeys(value, keys) || requiredKeys.some((key) => !(key in value)))
         return null;
     if (!nonEmptyString(value.workspaceId) ||
         !nonEmptyString(value.scopeFingerprint) ||
+        (value.campaignId !== undefined && !nonEmptyString(value.campaignId)) ||
         !isOneOfAdvance(value.scopeKind, [
             "sender_local_horizon",
             "exact_sender_dates",
@@ -899,6 +927,9 @@ function decodeScopeEcho(value) {
         workspaceId: value.workspaceId,
         scopeKind: value.scopeKind,
         scopeFingerprint: value.scopeFingerprint,
+        ...(value.campaignId === undefined
+            ? {}
+            : { campaignId: value.campaignId }),
     };
 }
 function decodeRowScope(value) {

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

@@ -42,6 +42,12 @@ export declare const refillV3AdvanceToolDefinitions: {
                 readonly minLength: 1;
                 readonly description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.";
             };
+            readonly campaignId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly pattern: "\\S";
+                readonly description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.";
+            };
             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 [{
@@ -128,6 +134,10 @@ export declare const refillV3AdvanceToolDefinitions: {
                         readonly type: "string";
                         readonly minLength: 1;
                     };
+                    readonly campaignId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
                     readonly scopeKind: {
                         readonly type: "string";
                         readonly enum: readonly ["sender_local_horizon", "exact_sender_dates"];
@@ -206,7 +216,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                     };
                     readonly reasonCode: {
                         readonly type: readonly ["string", "null"];
-                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch", null];
+                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch", null];
                     };
                     readonly approvedCount: {
                         readonly type: "integer";
@@ -257,7 +267,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                                 readonly type: "array";
                                 readonly items: {
                                     readonly type: "string";
-                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                 };
                             };
                         };
@@ -281,7 +291,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                 readonly properties: {
                     readonly code: {
                         readonly type: "string";
-                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                     };
                     readonly message: {
                         readonly type: "string";
@@ -316,7 +326,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                 readonly properties: {
                     readonly code: {
                         readonly type: "string";
-                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                     };
                     readonly message: {
                         readonly type: "string";
@@ -475,7 +485,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                     };
                                 };
                             };
@@ -605,7 +615,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                     };
                                 };
                             };
@@ -735,7 +745,7 @@ export declare const refillV3AdvanceToolDefinitions: {
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                     };
                                 };
                             };
@@ -864,6 +874,7 @@ export declare const refillV3AdvanceToolDefinitions: {
 export type RefillV3AdvanceToolInput = {
     workspaceId?: string;
     scope?: unknown;
+    campaignId?: string;
     /**
      * The operator's autonomy grant, forwarded verbatim. It is NOT defaulted here
      * — an omitted grant stays omitted so the backend parser, which is the single

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

@@ -66,12 +66,18 @@ export async function advanceRefillV3Tool(input) {
     const transportScope = {
         workspaceId,
         scope: input.scope,
+        ...(input.campaignId === undefined
+            ? {}
+            : { campaignId: input.campaignId }),
         ...(input.yolo === undefined ? {} : { yolo: input.yolo }),
     };
     const runToken = resolveRefillV3RunToken(transportScope, input.runToken);
     const raw = await getApi().post(REFILL_V3_ADVANCE_ROUTE, {
         workspaceId,
         scope: input.scope,
+        ...(input.campaignId === undefined
+            ? {}
+            : { campaignId: input.campaignId }),
         // Forwarded only when the caller actually supplied it, so an absent grant
         // is absent on the wire rather than an explicit `false` this layer made up.
         ...(input.yolo === undefined ? {} : { yolo: input.yolo }),

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

@@ -69,6 +69,12 @@ export declare const REFILL_V3_CONTINUE_INPUT_SCHEMA: Readonly<{
                 };
             }];
         };
+        readonly campaignId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly pattern: "\\S";
+            readonly description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.";
+        };
         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.";

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

@@ -58,6 +58,7 @@ export const REFILL_V3_CONTINUE_INPUT_SCHEMA = Object.freeze({
     properties: {
         workspaceId: REFILL_V3_ADVANCE_INPUT_SCHEMA.properties.workspaceId,
         scope: REFILL_V3_ADVANCE_INPUT_SCHEMA.properties.scope,
+        campaignId: REFILL_V3_ADVANCE_INPUT_SCHEMA.properties.campaignId,
         yolo: REFILL_V3_ADVANCE_INPUT_SCHEMA.properties.yolo,
         decision: {
             type: "object",

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

@@ -83,6 +83,12 @@ export declare const refillV3ContinueToolDefinitions: {
                     };
                 }];
             };
+            readonly campaignId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly pattern: "\\S";
+                readonly description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.";
+            };
             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.";
@@ -348,6 +354,7 @@ export declare const refillV3ContinueToolDefinitions: {
 export type RefillV3ContinueInput = {
     workspaceId: string;
     scope: unknown;
+    campaignId?: string;
     yolo?: boolean;
     /**
      * MCP-internal server credential assembled by the public tool wrapper from
@@ -438,6 +445,13 @@ export type RefillV3ContinueDependencies = {
         requireIdle: true;
         requirePreparationTerminal?: true;
     }): Promise<unknown>;
+    /** Stable-id re-attestation after an external wait and before receipt use. */
+    attestCampaignTargetAfterWait?(input: {
+        workspaceId: string;
+        campaignId: string;
+        senderId: string;
+        date: string;
+    }): Promise<boolean>;
     /** Read the cumulative campaign message total at one exact observation. */
     readCampaignMessageCount?: (input: {
         workspaceId: string;
@@ -542,6 +556,7 @@ export declare function continueRefillV3(input: RefillV3ContinueInput, dependenc
 export declare function continueRefillV3Tool(input: {
     workspaceId?: string;
     scope?: unknown;
+    campaignId?: string;
     yolo?: boolean;
     decision?: unknown;
 }): Promise<RefillV3ContinueResult>;

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

@@ -1172,6 +1172,22 @@ const DEFAULT_DEPENDENCIES = {
     advance: advanceRefillV3Tool,
     runCampaignWork: runRefillV3CampaignWorkWithProductionOwners,
     waitForCampaignProcessing,
+    async attestCampaignTargetAfterWait(input) {
+        const observation = await getRefillV3WorldStateTool({
+            workspaceId: input.workspaceId,
+            campaignId: input.campaignId,
+            scope: {
+                kind: "exact_sender_dates",
+                senderDates: [{ senderId: input.senderId, dates: [input.date] }],
+            },
+        });
+        const campaigns = observation.rows.flatMap((row) => [
+            ...row.activeCampaigns,
+            ...row.inactiveCampaigns,
+        ]);
+        return (campaigns.length > 0 &&
+            campaigns.every((campaign) => campaign.id === input.campaignId && campaign.status === "ACTIVE"));
+    },
     persistCampaignWorkReceipt: (input) => getApi().post("/api/v3/mcp/refill-v3/campaign-work-receipt", input, {
         workspaceId: input.workspaceId,
     }),
@@ -1272,6 +1288,9 @@ async function executeRefillV3Continuation(input, dependencies) {
     const advanceResult = await dependencies.advance({
         workspaceId,
         scope: input.scope,
+        ...(input.campaignId === undefined
+            ? {}
+            : { campaignId: input.campaignId }),
         ...(input.yolo === undefined ? {} : { yolo: input.yolo }),
         runToken: presentedRunToken,
     });
@@ -1437,6 +1456,19 @@ async function executeRefillV3Continuation(input, dependencies) {
                 campaignWideIdleRequired: false,
             }
             : null;
+    if (input.campaignId &&
+        (preparationOwnsSettlement || directlyQueuedRowsOwnSettlement) &&
+        dependencies.attestCampaignTargetAfterWait) {
+        const stillAttested = await dependencies.attestCampaignTargetAfterWait({
+            workspaceId,
+            campaignId: input.campaignId,
+            senderId: advanceResult.packet.scope.senderId,
+            date: advanceResult.packet.scope.date,
+        });
+        if (!stillAttested) {
+            throw new Error("campaign_target_stale: the exact campaign changed while continuation waited; no post-wait receipt authority was consumed");
+        }
+    }
     let messageCountAfter = generatedMessageCountFrom(settlement);
     if (messageCountAfter === null && dependencies.readCampaignMessageCount) {
         messageCountAfter = await reconnectPostAdvanceStage({
@@ -1527,6 +1559,9 @@ function refillV3ContinueReplayKey(input) {
         .update(canonical({
         workspaceId: input.workspaceId,
         scope: input.scope,
+        ...(input.campaignId === undefined
+            ? {}
+            : { campaignId: input.campaignId }),
         yolo: input.yolo,
         runToken: input.runToken,
         packet: input.packet,
@@ -1572,6 +1607,9 @@ export async function continueRefillV3Tool(input) {
         ? {
             workspaceId,
             scope: input.scope,
+            ...(input.campaignId === undefined
+                ? {}
+                : { campaignId: input.campaignId }),
             ...(input.yolo === undefined ? {} : { yolo: input.yolo }),
         }
         : null;
@@ -1581,9 +1619,17 @@ export async function continueRefillV3Tool(input) {
     if (!workspaceId || !retained) {
         throw new Error("refill_v3_continue requires an exact workspaceId and current server-issued attention state. Call refill_v3_advance first.");
     }
+    if (input.campaignId !== undefined &&
+        retained.campaignId !== undefined &&
+        input.campaignId !== retained.campaignId) {
+        throw new Error("campaign_target_identity_mismatch: the explicit continuation campaignId differs from the retained server-issued run target");
+    }
     return continueRefillV3({
         workspaceId,
         scope: input.scope,
+        ...((input.campaignId ?? retained.campaignId) === undefined
+            ? {}
+            : { campaignId: input.campaignId ?? retained.campaignId }),
         ...(input.yolo === undefined ? {} : { yolo: input.yolo }),
         runToken: retained.runToken,
         packet: retained.packet,

package/dist/tools/refill-v3-run-token-transport.d.ts

@@ -17,6 +17,7 @@ import type { RefillV3CampaignAttentionPacket } from "./refill-v3-attention-pack
 export type RefillV3RunTransportScope = {
     workspaceId: string;
     scope: unknown;
+    campaignId?: string;
     yolo?: boolean;
 };
 /** Prefer exact MCP-held continuity; use caller bytes only after a restart. */
@@ -27,6 +28,7 @@ export declare function recordRefillV3RunTransition(input: RefillV3RunTransportS
 export declare function retainedRefillV3Attention(input: RefillV3RunTransportScope): {
     runToken: string;
     packet: RefillV3CampaignAttentionPacket;
+    campaignId?: string;
 } | null;
 /** Test-only isolation owner; production code never clears live continuity. */
 export declare function resetRefillV3RunTokenTransportForTests(): void;

package/dist/tools/refill-v3-run-token-transport.js

@@ -28,6 +28,16 @@ function canonical(value) {
     return JSON.stringify(normalize(value));
 }
 function runKey(input) {
+    return canonical({
+        workspaceId: input.workspaceId,
+        scope: input.scope,
+        ...(input.campaignId === undefined
+            ? {}
+            : { campaignId: input.campaignId }),
+        yolo: input.yolo === true,
+    });
+}
+function baseRunKey(input) {
     return canonical({
         workspaceId: input.workspaceId,
         scope: input.scope,
@@ -56,6 +66,7 @@ export function recordRefillV3RunTransition(input, result) {
         result.kind === "run_step_pending") {
         retain(key, {
             runToken: result.runToken,
+            transportScope: { ...input },
             attentionPacket: result.kind === "campaign_attention_required" ? result.packet : null,
         });
         return;
@@ -64,9 +75,21 @@ export function recordRefillV3RunTransition(input, result) {
 }
 /** Exact current attention state for the public continuation wrapper. */
 export function retainedRefillV3Attention(input) {
-    const retained = retainedRuns.get(runKey(input));
+    let retained = retainedRuns.get(runKey(input));
+    if (!retained) {
+        const matching = [...retainedRuns.values()].filter((candidate) => baseRunKey(candidate.transportScope) === baseRunKey(input) &&
+            candidate.attentionPacket !== null);
+        if (matching.length === 1)
+            retained = matching[0];
+    }
     return retained?.attentionPacket
-        ? { runToken: retained.runToken, packet: retained.attentionPacket }
+        ? {
+            runToken: retained.runToken,
+            packet: retained.attentionPacket,
+            ...(retained.transportScope.campaignId === undefined
+                ? {}
+                : { campaignId: retained.transportScope.campaignId }),
+        }
         : null;
 }
 /** Test-only isolation owner; production code never clears live continuity. */

package/dist/tools/refill-v3-world-state.d.ts

@@ -42,6 +42,11 @@ export declare const refillV3WorldStateToolDefinitions: {
                 readonly type: "string";
                 readonly minLength: 1;
             };
+            readonly campaignId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly pattern: "\\S";
+            };
             readonly scope: {
                 readonly oneOf: readonly [{
                     readonly type: "object";
@@ -615,6 +620,7 @@ export declare const refillV3WorldStateToolDefinitions: {
 export type RefillV3WorldStateToolInput = {
     workspaceId?: string;
     scope?: unknown;
+    campaignId?: string;
 };
 /**
  * Observe the canonical world state for ONE explicit workspace.

package/dist/tools/refill-v3-world-state.js

@@ -40,6 +40,7 @@ const REFILL_V3_WORLD_STATE_TOOL_INPUT_SCHEMA = {
     required: ["workspaceId", "scope"],
     properties: {
         workspaceId: { type: "string", minLength: 1 },
+        campaignId: { type: "string", minLength: 1, pattern: "\\S" },
         scope: {
             oneOf: [
                 {
@@ -125,7 +126,13 @@ export async function getRefillV3WorldStateTool(input) {
     if (!workspaceId) {
         throw new Error("Explicit workspaceId is required for refill_v3_world_state. Pass workspaceId on the tool call instead of switching the shared active workspace.");
     }
-    const raw = await getApi().post(REFILL_V3_WORLD_STATE_ROUTE, { workspaceId, scope: input.scope }, workspaceRequestOptions(workspaceId));
+    const raw = await getApi().post(REFILL_V3_WORLD_STATE_ROUTE, {
+        workspaceId,
+        scope: input.scope,
+        ...(input.campaignId === undefined
+            ? {}
+            : { campaignId: input.campaignId }),
+    }, workspaceRequestOptions(workspaceId));
     const decoded = decodeRefillWorldStateResult(raw);
     if (decoded === null) {
         throw new Error("The Refill V3 world-state response failed the published result contract.");

package/dist/tools/registry.d.ts

@@ -10198,6 +10198,12 @@ export declare const allTools: ({
                 readonly minLength: 1;
                 readonly description: "Explicit request-scoped workspace id. Pass this instead of switching the shared active workspace.";
             };
+            readonly campaignId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly pattern: "\\S";
+                readonly description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.";
+            };
             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 [{
@@ -10284,6 +10290,10 @@ export declare const allTools: ({
                         readonly type: "string";
                         readonly minLength: 1;
                     };
+                    readonly campaignId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
                     readonly scopeKind: {
                         readonly type: "string";
                         readonly enum: readonly ["sender_local_horizon", "exact_sender_dates"];
@@ -10362,7 +10372,7 @@ export declare const allTools: ({
                     };
                     readonly reasonCode: {
                         readonly type: readonly ["string", "null"];
-                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch", null];
+                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch", null];
                     };
                     readonly approvedCount: {
                         readonly type: "integer";
@@ -10413,7 +10423,7 @@ export declare const allTools: ({
                                 readonly type: "array";
                                 readonly items: {
                                     readonly type: "string";
-                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                    readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                 };
                             };
                         };
@@ -10437,7 +10447,7 @@ export declare const allTools: ({
                 readonly properties: {
                     readonly code: {
                         readonly type: "string";
-                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                     };
                     readonly message: {
                         readonly type: "string";
@@ -10472,7 +10482,7 @@ export declare const allTools: ({
                 readonly properties: {
                     readonly code: {
                         readonly type: "string";
-                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                     };
                     readonly message: {
                         readonly type: "string";
@@ -10631,7 +10641,7 @@ export declare const allTools: ({
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                     };
                                 };
                             };
@@ -10761,7 +10771,7 @@ export declare const allTools: ({
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                     };
                                 };
                             };
@@ -10891,7 +10901,7 @@ export declare const allTools: ({
                                     readonly type: "array";
                                     readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
+                                        readonly enum: readonly ["global_cooldown", "connection_cooldown", "paid_inmail_cooldown", "endpoint_temporarily_unavailable", "date_in_past", "no_sending_hours", "sender_disconnected", "sender_limit_reached", "daily_target_met", "no_eligible_campaign", "no_ready_supply", "sales_nav_disconnected", "insufficient_paid_credits", "paid_inmail_connection_health_recheck_required", "paid_inmail_credit_refresh_failed", "invalid_paid_configuration", "campaign_table_missing", "campaign_sequence_invalid", "source_family_unresolved", "campaign_work_in_flight", "zero_requested_count", "idempotency_scope_mismatch", "uncertain_outcome", "placed_under_other_sender", "placed_off_target_date", "paid_inmail_credit_receipt_invalid", "awaiting_external_change", "approval_authority_invalid", "approval_authority_in_flight", "approval_dispatch_incomplete", "ready_cells_unavailable", "sender_affinity_conflict", "scheduler_target_omitted", "scheduler_failed", "receipt_readback_mismatch", "account_identity_missing", "no_progress_refused", "retryable_paid_attempts_exhausted", "unknown_transport_vocabulary", "forged_authority_receipt_facts", "authority_failure_uncertain", "sender_scope_unresolved", "campaign_supply_unclaimed", "lane_campaigns_exhausted", "missing_balance", "blocked", "workspace_membership_revoked", "campaign_target_missing", "campaign_target_stale", "campaign_target_inactive", "campaign_target_unauthorized", "campaign_target_sender_incompatible", "target_lane_incompatible", "campaign_target_action_incompatible", "campaign_target_exhausted", "campaign_target_identity_mismatch", "invalid_run_token", "expired_run_token", "run_token_scope_mismatch", "run_token_replayed", "unknown_run", "run_closed", "run_grant_mismatch"];
                                     };
                                 };
                             };
@@ -11028,6 +11038,11 @@ export declare const allTools: ({
                 readonly type: "string";
                 readonly minLength: 1;
             };
+            readonly campaignId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly pattern: "\\S";
+            };
             readonly scope: {
                 readonly oneOf: readonly [{
                     readonly type: "object";
@@ -11670,6 +11685,12 @@ export declare const allTools: ({
                     };
                 }];
             };
+            readonly campaignId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly pattern: "\\S";
+                readonly description: "Optional stable campaign id for exact-campaign execution. Display names are never execution identity.";
+            };
             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.";

package/package.json

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

package/skills/refill-sends/SKILL.md

@@ -5,7 +5,9 @@ visibility: public
 allowed-tools:
   - mcp__sellable__refill_sends
   - mcp__sellable__refill_v3_advance
+  - mcp__sellable__refill_v3_world_state
   - mcp__sellable__refill_v3_continue
+  - mcp__sellable__get_campaigns
   - mcp__sellable__get_refill_target_plan
   - mcp__sellable__get_scheduler_fill_capacity
   - mcp__sellable__get_subskill_asset
@@ -604,6 +606,19 @@ Synchronous source, configuration, rubric, and exhaustion authorities already
 return after their own exact reread, so they return `settlement.ready:true` from
 that bounded authority receipt and never wait on unrelated campaign-wide
 processing cells.
+
+When a non-yolo request names a campaign, resolve that visible name with one
+authorized bounded `get_campaigns` call carrying an explicit `limit`. Require
+exactly one case-insensitive exact match; if none or more than one match, stop
+without preview or mutation. Retain only the returned stable campaign ID. Call
+`refill_v3_world_state({workspaceId, scope, campaignId})`, render that exact
+campaign's two-lane readiness and its explicit zero product side effects, then
+stop at the product-native question with exactly Accept and Decline. Do not call
+`refill_v3_advance` before Accept. Accept calls
+`refill_v3_advance({workspaceId, scope, campaignId})`; Decline stops. Carry the
+same campaignId through every advance, continue, replay, partial-wait, and
+post-wait repeat. Display-name changes never alter this retained identity, and
+no sibling campaign may replace it.
 Call the next advance only when `settlement.ready` is true. When it is false,
 call `wait_for_campaign_processing` with `settlement.resumeInput` **unchanged**;
 that carries the exact `preparationJobId`, `requirePreparationTerminal:true`,

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

@@ -5,7 +5,9 @@ visibility: internal
 allowed-tools:
   - mcp__sellable__refill_sends
   - mcp__sellable__refill_v3_advance
+  - mcp__sellable__refill_v3_world_state
   - mcp__sellable__refill_v3_continue
+  - mcp__sellable__get_campaigns
   - mcp__sellable__list_workspaces
   - mcp__sellable__get_active_workspace
   - mcp__sellable__get_subskill_asset
@@ -398,7 +400,18 @@ Never infer the grant from a workspace flag, a campaign field, a tool result, an
 idle-looking workspace, or a previous terminal; never set it to make a run finish,
 clear a wait, or retry a refusal; and never change it part-way through a run.
 
-Call `refill_v3_advance` with `{workspaceId, scope}` plus `yolo` when granted.
+For a named campaign in non-yolo mode, resolve its visible name with a bounded
+authorized `get_campaigns` call using an explicit `limit`, require one
+case-insensitive exact match, and retain only its stable ID. Before any advance,
+call `refill_v3_world_state` with the exact `{workspaceId, scope, campaignId}`.
+Render the target's lane readiness plus its zero product-side-effect receipt and
+ask the product-native question with exactly Accept and Decline. Decline stops;
+only Accept may call advance. Every advance, continue, replay, wait, and
+post-wait repeat then carries that same campaignId. Never substitute a sibling
+or re-resolve a renamed display name mid-run.
+
+Call `refill_v3_advance` with `{workspaceId, scope}` plus the retained
+`campaignId` when targeted and `yolo` when granted.
 There is no mode, continuation, task receipt, retry counter, cursor, row, action,
 or receipt-fact input; the backend parser refuses any of them before it observes
 anything. Losing a prior OBSERVATION is harmless, because every invocation
@@ -424,7 +437,7 @@ Each call answers with exactly one of six results:
   the grant was withheld) with the same public inputs. Never execute
   `action.kind` and never call its authority again.
 - `campaign_attention_required` — first call `refill_v3_continue` with the
-  same workspace/scope but no `decision`; MCP supplies its retained exact
+  same workspace/scope/campaignId but no `decision`; MCP supplies its retained exact
   packet and token. It revalidates the packet
   against a fresh advance result and deterministically owns live-job waiting,
   exact actionable enrichment, and same-template message generation. Only a
@@ -467,7 +480,7 @@ Each call answers with exactly one of six results:
   `campaign_work_in_flight`, call
   `wait_for_campaign_processing({ workspaceId, campaignId, requireIdle:true })`
   for that exact selected campaign, then call `refill_v3_advance` again with
-  the identical scope. This result is a terminal, so the server already closed
+  the identical scope and campaignId. This result is a terminal, so the server already closed
   the run; the advance after the wait opens a new run. A partial timeout is
   followed by that fresh advance;
   if the same campaign is still live, repeat the bounded wait. This is the

package/skills/refill-sends-workflow/core/flow.v3.json

@@ -49,10 +49,39 @@
   },
   "tools": {
     "advance": "refill_v3_advance",
+    "preview": "refill_v3_world_state",
+    "campaignResolution": "get_campaigns",
     "campaignAttentionSubskill": "refill-sends-work-campaign",
     "campaignAttentionAuthority": "refill_v3_continue",
     "campaignProcessingWait": "wait_for_campaign_processing"
   },
+  "namedCampaignPreview": {
+    "appliesWhen": "the operator names a campaign and yolo is withheld",
+    "resolve": {
+      "tool": "get_campaigns",
+      "bounded": true,
+      "requiredInputKeys": ["workspaceId", "limit"],
+      "match": "exactly one case-insensitive exact visible-name match",
+      "retain": "campaignId only",
+      "onMissingOrAmbiguous": "stop without preview, run, receipt, credit refresh, or product mutation"
+    },
+    "preview": {
+      "tool": "refill_v3_world_state",
+      "inputKeys": ["workspaceId", "scope", "campaignId"],
+      "requires": "the stable id returned by the bounded authorized resolution",
+      "render": "exact target and per-lane readiness plus observationSideEffects",
+      "paidCreditCache": "not_checked",
+      "productEffects": "all false"
+    },
+    "decision": {
+      "kind": "product_native",
+      "choices": ["Accept", "Decline"],
+      "accept": "call refill_v3_advance with the same workspaceId, scope, and campaignId",
+      "decline": "stop",
+      "forbiddenBeforeAccept": ["refill_v3_advance", "refill_v3_continue", "any product mutation"]
+    },
+    "continuity": "carry the same stable campaignId through every advance, continue, replay, partial wait, and post-wait repeat; never use display name or a sibling fallback"
+  },
   "workspaceResolution": {
     "appliesWhen": "always, BEFORE the first advance call",
     "allowedTools": ["list_workspaces", "get_active_workspace"],
@@ -109,8 +138,8 @@
   "loop": {
     "call": {
       "tool": "refill_v3_advance",
-      "inputKeys": ["workspaceId", "scope", "yolo"],
-      "note": "Pass workspaceId and scope with the values the host resolved once, plus yolo:true only when the autonomy step granted it. workspaceId is the EXACT id workspaceResolution produced, never a name and never an implicit config default when the operator named a workspace. The MCP transport owns run continuity. There is no token, mode, continuation, task receipt, retry counter, cursor, row, action, or receipt-fact input for the caller.",
+      "inputKeys": ["workspaceId", "scope", "campaignId", "yolo"],
+      "note": "Pass workspaceId and scope with the values the host resolved once, the stable campaignId on a targeted run, plus yolo:true only when the autonomy step granted it. workspaceId is the EXACT id workspaceResolution produced, never a name and never an implicit config default when the operator named a workspace. The MCP transport owns run continuity. There is no token, display-name selector, mode, continuation, task receipt, retry counter, cursor, row, action, or receipt-fact input for the caller.",
       "requiredInputKeys": ["workspaceId", "scope"]
     },
     "repeatWhile": [
@@ -120,7 +149,7 @@
       "awaiting_external_change:campaign_work_in_flight_after_wait"
     ],
     "stopOn": ["awaiting_external_change:other", "complete", "blocked"],
-    "note": "Call advance again with the same workspaceId, scope, and autonomy grant. The MCP transport carries exact run continuity internally; every invocation still reconstructs from fresh world state plus server-loaded authority receipts.",
+    "note": "Call advance again with the same workspaceId, scope, optional stable campaignId, and autonomy grant. The MCP transport carries exact run continuity internally; every invocation still reconstructs from fresh world state plus server-loaded authority receipts.",
     "repeatPolicy": {
       "granted": "Call advance again immediately, without checking back.",
       "withheld": "Surface the result, then ASK before the next call. The repeatWhile set is unchanged \u2014 only who decides to take the next step changes."
@@ -145,14 +174,14 @@
     "campaign_attention_required": {
       "alreadyExecuted": false,
       "surface": ["packet.scope", "packet.evidence"],
-      "carryForward": "call refill_v3_continue with workspaceId, scope, and yolo only; MCP carries the exact token and packet internally",
+      "carryForward": "call refill_v3_continue with workspaceId, scope, campaignId when targeted, and yolo only; MCP carries the exact token and packet internally",
       "route": {
         "first": "call refill_v3_continue with no decision; it owns live-job waiting, exact actionable enrichment, and same-template generation from the fresh packet",
         "modelBoundary": "only model_decision_required loads refill-sends-work-campaign",
         "subskill": "refill-sends-work-campaign",
         "pass": ["packet.scope", "packet.evidence"],
         "returnThrough": "refill_v3_continue",
-        "returnInput": ["workspaceId", "scope", "decision", "yolo"]
+        "returnInput": ["workspaceId", "scope", "campaignId", "decision", "yolo"]
       },
       "settlement": {
         "ownedBy": "refill_v3_continue",