@sellable/mcp 0.1.793 → 0.1.794

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

@@ -0,0 +1,608 @@
+/**
+ * Refill V3 `campaign_attention_required` PACKAGE seam.
+ *
+ * This module is declared inside `@sellable/mcp` so the packet contract ships
+ * with the published package and both later waves import ONE declaration:
+ * the wave-7 AI seams validate their output against it, and the wave-8
+ * deterministic coordinator produces packets against it. Copying the packet
+ * shape, the action list, the exhaustion table, or the yield floor into either
+ * consumer is forbidden.
+ *
+ * It is also the phase's shared PACKAGE VOCABULARY owner. The campaign supply
+ * buckets, live-job vocabulary, lead-source families, schema-version gate, and
+ * the emitted-module registry are declared exactly once here and imported by
+ * the sibling world-state and waterfall contracts, because a vocabulary
+ * mirrored across two modules is a defect by construction (error law 2).
+ *
+ * Constraints:
+ *  - zero imports: no app `src/**`, no validation library, no runtime dependency
+ *    beyond what `@sellable/mcp` already publishes (assumption A02-NO-ZOD);
+ *  - hand-rolled type guards plus as-const JSON-Schema literals;
+ *  - strict-in, tolerant-out, lossless decoding; and
+ *  - a compatible-RANGE schema version gate, never an exact-string pin.
+ */
+export type RefillV3PackagedContractModule = {
+    source: string;
+    js: string;
+    types: string;
+    ownerPlan: string;
+    ownerTask: string;
+};
+/**
+ * Every package contract module pair this phase emits under `dist/tools/`.
+ * Earlier plans append their own module; Plan 10's single packed-asset
+ * assertion consumes this list instead of four escalating set-completeness
+ * assertions.
+ */
+export declare const REFILL_V3_PACKAGED_CONTRACT_MODULES: readonly [{
+    readonly source: "mcp/sellable/src/tools/refill-v3-world-state-contract.ts";
+    readonly js: "dist/tools/refill-v3-world-state-contract.js";
+    readonly types: "dist/tools/refill-v3-world-state-contract.d.ts";
+    readonly ownerPlan: "146.5-02";
+    readonly ownerTask: "146.5-02-T1";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-attention-packet-contract.ts";
+    readonly js: "dist/tools/refill-v3-attention-packet-contract.js";
+    readonly types: "dist/tools/refill-v3-attention-packet-contract.d.ts";
+    readonly ownerPlan: "146.5-02";
+    readonly ownerTask: "146.5-02-T3";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-waterfall-contract.ts";
+    readonly js: "dist/tools/refill-v3-waterfall-contract.js";
+    readonly types: "dist/tools/refill-v3-waterfall-contract.d.ts";
+    readonly ownerPlan: "146.5-02";
+    readonly ownerTask: "146.5-02-T3";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-fill-ready-contract.ts";
+    readonly js: "dist/tools/refill-v3-fill-ready-contract.js";
+    readonly types: "dist/tools/refill-v3-fill-ready-contract.d.ts";
+    readonly ownerPlan: "146.5-07";
+    readonly ownerTask: "146.5-07-T3";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-world-state.ts";
+    readonly js: "dist/tools/refill-v3-world-state.js";
+    readonly types: "dist/tools/refill-v3-world-state.d.ts";
+    readonly ownerPlan: "146.5-08";
+    readonly ownerTask: "146.5-08-T1";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-fill-ready.ts";
+    readonly js: "dist/tools/refill-v3-fill-ready.js";
+    readonly types: "dist/tools/refill-v3-fill-ready.d.ts";
+    readonly ownerPlan: "146.5-08";
+    readonly ownerTask: "146.5-08-T2";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-edit-selected-campaign-contract.ts";
+    readonly js: "dist/tools/refill-v3-edit-selected-campaign-contract.js";
+    readonly types: "dist/tools/refill-v3-edit-selected-campaign-contract.d.ts";
+    readonly ownerPlan: "146.5-09";
+    readonly ownerTask: "146.5-09-T2";
+}, {
+    /**
+     * Plan 09's WRAPPER. Its contract pair was already registered; the wrapper
+     * itself was missing, which left the four-tool package parity claim
+     * unsatisfiable. Plan 10 T2 appended it because it owns set completeness
+     * across every emitted Refill V3 module.
+     */
+    readonly source: "mcp/sellable/src/tools/refill-v3-edit-selected-campaign.ts";
+    readonly js: "dist/tools/refill-v3-edit-selected-campaign.js";
+    readonly types: "dist/tools/refill-v3-edit-selected-campaign.d.ts";
+    readonly ownerPlan: "146.5-09";
+    readonly ownerTask: "146.5-09-T2";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-advance-contract.ts";
+    readonly js: "dist/tools/refill-v3-advance-contract.js";
+    readonly types: "dist/tools/refill-v3-advance-contract.d.ts";
+    readonly ownerPlan: "146.5-10";
+    readonly ownerTask: "146.5-10-T1a";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-advance.ts";
+    readonly js: "dist/tools/refill-v3-advance.js";
+    readonly types: "dist/tools/refill-v3-advance.d.ts";
+    readonly ownerPlan: "146.5-10";
+    readonly ownerTask: "146.5-10-T1a";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-continue-contract.ts";
+    readonly js: "dist/tools/refill-v3-continue-contract.js";
+    readonly types: "dist/tools/refill-v3-continue-contract.d.ts";
+    readonly ownerPlan: "146.5-13";
+    readonly ownerTask: "146.5-13-T2";
+}, {
+    readonly source: "mcp/sellable/src/tools/refill-v3-continue.ts";
+    readonly js: "dist/tools/refill-v3-continue.js";
+    readonly types: "dist/tools/refill-v3-continue.d.ts";
+    readonly ownerPlan: "146.5-13";
+    readonly ownerTask: "146.5-13-T2";
+}];
+/**
+ * The typed VALUE an unsupported MAJOR returns. It is deliberately not `null`
+ * and never a throw: the backend deploys before the package is installed, so an
+ * already-installed client that fails closed on one new field would take every
+ * installed customer down (112-EMH-06).
+ */
+export declare const REFILL_V3_SCHEMA_VERSION_UNSUPPORTED: "schema_version_unsupported";
+export type RefillV3SchemaVersionUnsupported = typeof REFILL_V3_SCHEMA_VERSION_UNSUPPORTED;
+export type RefillV3SchemaVersionSupport = {
+    supported: true;
+    major: number;
+    minor: number;
+} | {
+    supported: false;
+    reason: "malformed";
+} | {
+    supported: false;
+    reason: RefillV3SchemaVersionUnsupported;
+};
+/**
+ * Compatible-RANGE gate. Any minor of the supported major decodes, including a
+ * newer one; a different major returns the typed unsupported value; anything
+ * that is not `<namespace>.v<major>.<minor>` is malformed transport.
+ */
+export declare function resolveRefillV3SchemaVersion(value: unknown, namespace: string, supportedMajor: number): RefillV3SchemaVersionSupport;
+export declare const REFILL_V3_LEAD_SOURCE_FAMILIES: readonly ["post_engager", "signal_discovery", "cold"];
+export type RefillV3LeadSourceFamily = (typeof REFILL_V3_LEAD_SOURCE_FAMILIES)[number];
+export declare const REFILL_V3_ACTIVE_JOB_KINDS: readonly ["enrichment", "message_generation", "source_expansion", "scheduling"];
+export type RefillV3ActiveJobKind = (typeof REFILL_V3_ACTIVE_JOB_KINDS)[number];
+export declare const REFILL_V3_ACTIVE_JOB_STATUSES: readonly ["queued", "running"];
+export type RefillV3ActiveJobStatus = (typeof REFILL_V3_ACTIVE_JOB_STATUSES)[number];
+export type RefillV3ActiveJob = {
+    id: string;
+    kind: RefillV3ActiveJobKind;
+    status: RefillV3ActiveJobStatus;
+};
+export declare const REFILL_V3_SUPPLY_BUCKETS: readonly ["readyToSchedule", "readyForApproval", "readyForMessageGeneration", "needsEnrichment"];
+export type RefillV3SupplyBucket = (typeof REFILL_V3_SUPPLY_BUCKETS)[number];
+export type RefillV3SupplyCounts = {
+    readyToSchedule: number;
+    readyForApproval: number;
+    readyForMessageGeneration: number;
+    needsEnrichment: number;
+};
+/** The at-most-10 bounded diagnostic sample. A REFERENCE, never row payload. */
+export declare const REFILL_V3_DIAGNOSTIC_SAMPLE_CAP = 10;
+/**
+ * The measured ACCEPTANCE FLOOR for a new source search: 8% of an evaluated
+ * sample must pass.
+ *
+ * This is NOT `SIGNAL_YIELD_DEFAULT_PASS_RATE` in `refill-executors.ts`, which
+ * is the no-evidence PROJECTION default used to size a request. Quality and
+ * volume stay separate on purpose: coupling a quality floor to gap-fill
+ * projection arithmetic is exactly what made the predecessor brittle.
+ */
+export declare const REFILL_V3_MIN_SOURCE_YIELD = 0.08;
+/** The acceptance sample is a fixed number of EVALUATED candidates. */
+export declare const REFILL_V3_MIN_SOURCE_YIELD_SAMPLE = 20;
+/** `post_engager` is excluded: it keeps posts-refresh preconditions, not a rate. */
+export declare const REFILL_V3_YIELD_FLOOR_FAMILIES: readonly ["signal_discovery", "cold"];
+export type RefillV3YieldFloorFamily = (typeof REFILL_V3_YIELD_FLOOR_FAMILIES)[number];
+export type RefillV3SourceYieldEvidence = {
+    family: RefillV3LeadSourceFamily;
+    evaluated: number;
+    passes: number;
+};
+export type RefillV3SourceYieldVerdict = {
+    decision: "floor_not_applicable";
+    family: RefillV3LeadSourceFamily;
+} | {
+    decision: "invalid_evidence";
+    detail: string;
+} | {
+    decision: "sample_incomplete";
+    evaluated: number;
+    required: number;
+} | {
+    decision: "meets_floor";
+    ratio: number;
+    floor: number;
+} | {
+    decision: "below_floor";
+    ratio: number;
+    floor: number;
+};
+/**
+ * The DETERMINISTIC half of the yield floor. The AI judges WHICH sampled
+ * candidates pass; this owns sample-size enforcement, the arithmetic, the
+ * comparison, and the routing decision. There is deliberately no deterministic
+ * candidate judge here.
+ *
+ */
+export declare function evaluateRefillV3SourceYield(evidence: RefillV3SourceYieldEvidence): RefillV3SourceYieldVerdict;
+export declare const REFILL_V3_EXHAUSTION_CONJUNCTS: readonly ["existing_supply_drained", "no_live_active_job", "no_repairable_existing_rows", "no_undispatched_approved_work", "source_frontier_scan_terminated"];
+export type RefillV3ExhaustionConjunct = (typeof REFILL_V3_EXHAUSTION_CONJUNCTS)[number];
+export declare const REFILL_V3_SCAN_TERMINATIONS: readonly ["not_started", "in_progress", "frontier_scanned", "provider_unavailable"];
+export type RefillV3ScanTermination = (typeof REFILL_V3_SCAN_TERMINATIONS)[number];
+export type RefillV3ExhaustionInput = {
+    supply: RefillV3SupplyCounts;
+    activeJob: RefillV3ActiveJob | null;
+    repairableExistingRows: number;
+    approvedUndispatchedWork: number;
+    structurallyUnactionableRows: number;
+    retryExhaustedRows: number;
+    scanTermination: RefillV3ScanTermination;
+    searchedNegativeSet: {
+        fingerprints: readonly string[];
+        untriedBroadenings: number;
+    };
+    yieldEvidence: RefillV3SourceYieldEvidence | null;
+};
+export type RefillV3ExhaustionVerdict = {
+    exhausted: true;
+} | {
+    exhausted: false;
+    falsifyingClause: RefillV3ExhaustionConjunct;
+};
+/**
+ * The ONE five-conjunct exhaustion predicate. Wave 7's AI falsification check
+ * and wave 8's coordinator both route through this symbol; declaring it in
+ * wave 8 would make a wave-7 behavior assert through an artifact that does not
+ * yet exist and would duplicate the same table twice.
+ *
+ * `structurallyUnactionableRows` and `retryExhaustedRows` are recorded evidence
+ * that SUPPORTS exhaustion; they can never falsify it, which is why they are
+ * inputs and not conjuncts.
+ */
+export declare const REFILL_V3_EXHAUSTION_PREDICATE: {
+    readonly conjuncts: readonly ["existing_supply_drained", "no_live_active_job", "no_repairable_existing_rows", "no_undispatched_approved_work", "source_frontier_scan_terminated"];
+    readonly evaluate: (input: RefillV3ExhaustionInput) => RefillV3ExhaustionVerdict;
+};
+/** Future modules that must IMPORT the predicate rather than restate it. */
+export declare const REFILL_V3_EXHAUSTION_PREDICATE_CONSUMERS: readonly ["mcp/sellable/src/tools/refill-v3-advance-contract.ts", "mcp/sellable/src/tools/refill-v3-edit-selected-campaign-contract.ts"];
+/**
+ * The ONE closed AI action vocabulary. Wave 7 validates model output against
+ * this constant and GENERATES its prompt's allowed-action list from it; wave 8
+ * consumes it. Neither may declare a second list (error law 1).
+ */
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS: readonly ["rerun_errored_cells", "repair_campaign_config", "enrich_bounded_sample", "regenerate_stale_messages", "patch_filter_criteria", "patch_source_criteria", "broaden_source_family", "request_rubric_trial", "await_active_job", "record_source_frontier_exhausted"];
+export type RefillV3CampaignAttentionAction = (typeof REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS)[number];
+/**
+ * Typed traversal RESULTS. `source_frontier_exhausted` and
+ * `health_recheck_required` live here and are never unreceipted AI actions:
+ * the AI records exhaustion through `record_source_frontier_exhausted`, and the
+ * deterministic authority answers with the result.
+ */
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_RESULTS: readonly ["cells_rerun", "campaign_config_repaired", "bounded_sample_enriched", "stale_messages_regenerated", "filter_criteria_patched", "source_criteria_patched", "source_family_broadened", "rubric_trial_requested", "active_job_awaited", "source_frontier_exhausted", "health_recheck_required", "no_action_available"];
+export type RefillV3CampaignAttentionResult = (typeof REFILL_V3_CAMPAIGN_ATTENTION_RESULTS)[number];
+/**
+ * Prompt assets that must GENERATE their allowed outputs from the constants
+ * above rather than hand-maintain a second list. Every named asset that exists
+ * is bound by the shared-vocabulary assertion; the assets themselves are
+ * authored by their owning wave-7 plan.
+ */
+export declare const REFILL_V3_ATTENTION_ASSET_CONTRACT: readonly [{
+    readonly asset: "mcp/sellable/skills/refill-sends-work-campaign/SKILL.md";
+    readonly generatedFrom: "REFILL_V3_CAMPAIGN_ATTENTION_ACTIONS";
+    readonly ownerPlan: "146.5-09";
+}, {
+    readonly asset: "mcp/sellable/skills/refill-sends-waterfall/SKILL.md";
+    readonly generatedFrom: "REFILL_V3_WATERFALL_PROPOSAL_SCHEMA";
+    readonly ownerPlan: "146.5-09";
+}];
+/**
+ * Prose that must never survive in a generated asset. Deterministic ladder
+ * step 3 owns the hand-off to `refill_v3_fill_ready`; an AI action token for it
+ * would put a deterministic transition inside the model's vocabulary.
+ */
+export declare const REFILL_V3_ATTENTION_FORBIDDEN_ASSET_INSTRUCTIONS: readonly ["refill_v3_fill_ready", "approve_and_hand_off", "hand off to refill_v3_fill_ready"];
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_SCHEMA_NAMESPACE: "refill_v3_campaign_attention";
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_SCHEMA_MAJOR = 1;
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_SCHEMA_VERSION: "refill_v3_campaign_attention.v1.0";
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_LANE_ACTION_TYPES: Readonly<{
+    readonly connection_invite: "send_invite";
+    readonly paid_inmail: "send_inmail_closed";
+}>;
+export type RefillV3CampaignAttentionLane = keyof typeof REFILL_V3_CAMPAIGN_ATTENTION_LANE_ACTION_TYPES;
+export type RefillV3CampaignAttentionActionType = (typeof REFILL_V3_CAMPAIGN_ATTENTION_LANE_ACTION_TYPES)[RefillV3CampaignAttentionLane];
+export type RefillV3CampaignAttentionScope = {
+    workspaceId: string;
+    campaignId: string;
+    tableId: string;
+    campaignVersion: number;
+    evidenceFingerprint: string;
+    senderId: string;
+    date: string;
+    lane: RefillV3CampaignAttentionLane;
+    actionType: RefillV3CampaignAttentionActionType;
+};
+export type RefillV3CampaignAttentionEvidence = {
+    campaignType: string;
+    campaignObjective: string;
+    protectedFitDigest: string;
+    leadSourceFamily: RefillV3LeadSourceFamily;
+    provider: string | null;
+    /** Exact selected source table, when the campaign has one. */
+    selectedLeadListId?: string | null;
+    /**
+     * Ownership-proven reusable saved-search authority for cold providers.
+     * Loaded server-side through the existing target-plan resolver; callers and
+     * the model may neither invent nor loosen it.
+     */
+    providerSearchReference?: RefillV3ProviderSearchReference | null;
+    sourceLineage: string[];
+    priorYieldReceipt: RefillV3SourceYieldEvidence | null;
+    searchedNegativeSetFingerprints: string[];
+    remainingGap: number;
+    supply: RefillV3SupplyCounts;
+    activeJob: RefillV3ActiveJob | null;
+    failedJobRef: string | null;
+    diagnosticRowRef: {
+        count: number;
+        selectorRef: string;
+    } | null;
+    /**
+     * ADDITIVE evidence enrichment (146.5-12 §84 queue; coordinator ruling:
+     * additive only). The error-nature split reuses THIS contract's own
+     * exhaustion-input vocabulary (`repairableExistingRows` = transient
+     * error|timeout rows, `retryExhaustedRows` = retry-terminal ones), and
+     * `laneSchedulable` transports the census's lane-scoped schedulable fact for
+     * the packet's own lane (null when the observation predates the fact).
+     * Absent on packets from older backends — never fabricated zeros. The
+     * campaign's recency/effectiveness evidence deliberately STAYS on the
+     * world-state surface (its owner); the packet references the campaign the
+     * session already observed.
+     */
+    repairableExistingRows?: number;
+    retryExhaustedRows?: number;
+    laneSchedulable?: number | null;
+};
+export type RefillV3ProviderSearchReference = {
+    workspaceId: string;
+    provider: "sales-nav" | "prospeo";
+    sourceTableId: string;
+    searchId: string;
+    resolutionOrigin: "config_import_job" | "exact_table_job" | "find_leads_run";
+    owner: {
+        kind: "campaign" | "find_leads_run";
+        id: string;
+    };
+    basisFingerprint: string;
+};
+export type RefillV3CampaignAttentionPacket = {
+    scope: RefillV3CampaignAttentionScope;
+    evidence: RefillV3CampaignAttentionEvidence;
+};
+/**
+ * Identity, payload, policy, and bookkeeping classes the packet must never
+ * carry. A raw row/cell/provider payload would move the table into the model;
+ * a rank/selection field would move backend authority into the model; a retry
+ * counter or cursor would recreate the durable state machine this phase deletes.
+ */
+export declare const REFILL_V3_ATTENTION_FORBIDDEN_KEYS: readonly ["rows", "cells", "rowIds", "cellIds", "rowPayload", "cellPayload", "providerResponse", "providerPayload", "rank", "ranking", "graph", "selectedCampaign", "waterfall", "retryCount", "attempts", "cursor", "continuation", "prompt", "instructions", "systemPrompt"];
+export declare const REFILL_V3_CAMPAIGN_ATTENTION_PACKET_SCHEMA: Readonly<{
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["scope", "evidence"];
+    readonly properties: {
+        readonly scope: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["workspaceId", "campaignId", "tableId", "campaignVersion", "evidenceFingerprint", "senderId", "date", "lane", "actionType"];
+            readonly properties: {
+                readonly workspaceId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly campaignId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly tableId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly campaignVersion: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly evidenceFingerprint: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly senderId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly date: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                };
+                readonly lane: {
+                    readonly type: "string";
+                    readonly enum: string[];
+                };
+                readonly actionType: {
+                    readonly type: "string";
+                    readonly enum: ("send_invite" | "send_inmail_closed")[];
+                };
+            };
+        };
+        readonly evidence: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["campaignType", "campaignObjective", "protectedFitDigest", "leadSourceFamily", "provider", "sourceLineage", "priorYieldReceipt", "searchedNegativeSetFingerprints", "remainingGap", "supply", "activeJob", "failedJobRef", "diagnosticRowRef"];
+            readonly properties: {
+                readonly campaignType: {
+                    readonly type: "string";
+                };
+                readonly campaignObjective: {
+                    readonly type: "string";
+                };
+                readonly protectedFitDigest: {
+                    readonly type: "string";
+                };
+                readonly leadSourceFamily: {
+                    readonly type: "string";
+                    readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
+                };
+                readonly provider: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly selectedLeadListId: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly providerSearchReference: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["workspaceId", "provider", "sourceTableId", "searchId", "resolutionOrigin", "owner", "basisFingerprint"];
+                    readonly properties: {
+                        readonly workspaceId: {
+                            readonly type: "string";
+                        };
+                        readonly provider: {
+                            readonly type: "string";
+                            readonly enum: readonly ["sales-nav", "prospeo"];
+                        };
+                        readonly sourceTableId: {
+                            readonly type: "string";
+                        };
+                        readonly searchId: {
+                            readonly type: "string";
+                        };
+                        readonly resolutionOrigin: {
+                            readonly type: "string";
+                            readonly enum: readonly ["config_import_job", "exact_table_job", "find_leads_run"];
+                        };
+                        readonly owner: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["kind", "id"];
+                            readonly properties: {
+                                readonly kind: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["campaign", "find_leads_run"];
+                                };
+                                readonly id: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                        readonly basisFingerprint: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly sourceLineage: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly priorYieldReceipt: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["family", "evaluated", "passes"];
+                    readonly properties: {
+                        readonly family: {
+                            readonly type: "string";
+                            readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
+                        };
+                        readonly evaluated: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly passes: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
+                readonly searchedNegativeSetFingerprints: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly remainingGap: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly supply: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["readyToSchedule", "readyForApproval", "readyForMessageGeneration", "needsEnrichment"];
+                    readonly properties: {
+                        readonly readyToSchedule: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly readyForApproval: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly readyForMessageGeneration: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly needsEnrichment: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
+                readonly activeJob: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["id", "kind", "status"];
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly kind: {
+                            readonly type: "string";
+                            readonly enum: readonly ["enrichment", "message_generation", "source_expansion", "scheduling"];
+                        };
+                        readonly status: {
+                            readonly type: "string";
+                            readonly enum: readonly ["queued", "running"];
+                        };
+                    };
+                };
+                readonly failedJobRef: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly diagnosticRowRef: {
+                    readonly type: readonly ["object", "null"];
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["count", "selectorRef"];
+                    readonly properties: {
+                        readonly count: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly maximum: 10;
+                        };
+                        readonly selectorRef: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                };
+                readonly repairableExistingRows: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly retryExhaustedRows: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly laneSchedulable: {
+                    readonly type: readonly ["integer", "null"];
+                    readonly minimum: 0;
+                };
+            };
+        };
+    };
+}>;
+/**
+ * Sole unknown-value decoder for the packet.
+ *
+ * Strict-in, tolerant-out, lossless. `null` means "not this contract"; the
+ * typed unsupported VALUE means "a major this build cannot speak", which is a
+ * different fact and must never be collapsed into `null` or business zero.
+ */
+export declare function decodeRefillV3CampaignAttentionPacket(value: unknown): RefillV3CampaignAttentionPacket | RefillV3SchemaVersionUnsupported | null;
+/**
+ * Wire form of a decoded packet. `schemaVersion` is TRANSPORT, not business, so
+ * it is gated and stripped on decode and re-attached here. Every locked field
+ * is projected explicitly, because a silently dropped property is exactly the
+ * defect that turns a round trip into a confident wrong success.
+ */
+export declare function encodeRefillV3CampaignAttentionPacket(packet: RefillV3CampaignAttentionPacket): Record<string, unknown>;