@sellable/mcp 0.1.948 → 0.1.949

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

@@ -113,115 +113,157 @@ export declare const refillV3WorldStateToolDefinitions: {
     outputSchema: Readonly<{
         readonly type: "object";
         readonly additionalProperties: false;
-        readonly required: readonly ["rows", "durationMs", "observationSideEffects"];
+        readonly required: readonly ["campaigns", "rows", "durationMs", "observationSideEffects"];
         readonly properties: {
-            readonly rows: {
+            readonly campaigns: {
                 readonly type: "array";
                 readonly items: {
                     readonly type: "object";
                     readonly additionalProperties: false;
-                    readonly required: readonly ["date", "sender", "lane", "targetSlots", "takenSlots", "remainingTargetGap", "fillableSlotsNow", "blockedGap", "availableSlots", "reason", "activeCampaigns", "inactiveCampaigns"];
+                    readonly required: ("name" | "status" | "id" | "evidence" | "activeJob" | "supply" | "leadSourceFamily" | "lanes" | "startEligible")[];
                     readonly properties: {
-                        readonly date: {
+                        id: {
                             readonly type: "string";
-                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                            readonly minLength: 1;
                         };
-                        readonly sender: {
-                            readonly type: "object";
+                        name: {
+                            readonly type: "string";
+                        };
+                        status: {
+                            readonly type: "string";
+                            readonly enum: readonly ["ACTIVE", "PAUSED"];
+                        };
+                        lanes: {
+                            readonly type: "array";
+                            readonly minItems: 1;
+                            readonly items: {
+                                readonly type: "string";
+                                readonly enum: readonly ["connection_invite", "paid_inmail"];
+                            };
+                        };
+                        startEligible: {
+                            readonly type: "boolean";
+                        };
+                        activeJob: {
+                            readonly type: readonly ["object", "null"];
                             readonly additionalProperties: false;
-                            readonly required: readonly ["id", "name", "timezone"];
+                            readonly required: readonly ["id", "kind", "status"];
                             readonly properties: {
                                 readonly id: {
                                     readonly type: "string";
                                     readonly minLength: 1;
                                 };
-                                readonly name: {
+                                readonly kind: {
                                     readonly type: "string";
+                                    readonly enum: readonly ["enrichment", "message_generation", "source_expansion", "scheduling"];
                                 };
-                                readonly timezone: {
+                                readonly status: {
                                     readonly type: "string";
-                                    readonly minLength: 1;
+                                    readonly enum: readonly ["queued", "running"];
                                 };
                             };
                         };
-                        readonly lane: {
-                            readonly type: "string";
-                            readonly enum: readonly ["connection_invite", "paid_inmail"];
-                        };
-                        readonly targetSlots: {
-                            readonly type: "integer";
-                            readonly minimum: 0;
-                        };
-                        readonly takenSlots: {
-                            readonly type: "integer";
-                            readonly minimum: 0;
-                        };
-                        readonly remainingTargetGap: {
-                            readonly type: "integer";
-                            readonly minimum: 0;
-                        };
-                        readonly fillableSlotsNow: {
-                            readonly type: "integer";
-                            readonly minimum: 0;
-                        };
-                        readonly blockedGap: {
-                            readonly type: "integer";
-                            readonly minimum: 0;
+                        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 availableSlots: {
-                            readonly type: "integer";
-                            readonly minimum: 0;
+                        leadSourceFamily: {
+                            readonly type: "string";
+                            readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
                         };
-                        readonly reason: {
-                            readonly type: readonly ["object", "null"];
+                        evidence: {
+                            readonly type: "object";
                             readonly additionalProperties: false;
-                            readonly required: readonly ["kind", "codes", "message"];
+                            readonly required: readonly ["evergreen", "lastActualUseAt", "lastScheduledUseAt", "effectiveness", "supplyHealth"];
                             readonly properties: {
-                                readonly kind: {
-                                    readonly type: "string";
-                                    readonly enum: readonly ["unavailable", "retry_required", "invalid_campaign_configuration"];
+                                readonly evergreen: {
+                                    readonly type: "boolean";
                                 };
-                                readonly codes: {
-                                    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"];
-                                    };
+                                readonly createdAt: {
+                                    readonly type: readonly ["string", "null"];
                                 };
-                                readonly message: {
+                                readonly lastActualUseAt: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly lastScheduledUseAt: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly effectiveness: {
                                     readonly type: "string";
+                                    readonly enum: readonly ["unknown", "low", "medium", "high"];
                                 };
-                                readonly resumeAt: {
+                                readonly supplyHealth: {
                                     readonly type: "string";
+                                    readonly enum: readonly ["unknown", "healthy", "thin", "dry"];
+                                };
+                                readonly engagement: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["sends", "accepted", "replied", "acceptRate", "replyRate"];
+                                    readonly properties: {
+                                        readonly sends: {
+                                            readonly type: "number";
+                                            readonly minimum: 0;
+                                        };
+                                        readonly accepted: {
+                                            readonly type: "number";
+                                            readonly minimum: 0;
+                                        };
+                                        readonly replied: {
+                                            readonly type: "number";
+                                            readonly minimum: 0;
+                                        };
+                                        readonly acceptRate: {
+                                            readonly type: "number";
+                                            readonly minimum: 0;
+                                            readonly maximum: 100;
+                                        };
+                                        readonly replyRate: {
+                                            readonly type: "number";
+                                            readonly minimum: 0;
+                                            readonly maximum: 100;
+                                        };
+                                    };
                                 };
                             };
                         };
+                    };
+                };
+            };
+            readonly rows: {
+                readonly type: "array";
+                readonly items: {
+                    readonly properties: {
                         readonly activeCampaigns: {
                             readonly type: "array";
                             readonly items: {
                                 readonly type: "object";
                                 readonly additionalProperties: false;
-                                readonly required: readonly ["id", "name", "status", "lanes", "eligible", "reason", "startEligible", "activeJob", "supply", "leadSourceFamily", "evidence"];
+                                readonly required: readonly ["id", "eligible", "reason"];
                                 readonly properties: {
                                     readonly id: {
                                         readonly type: "string";
                                         readonly minLength: 1;
                                     };
-                                    readonly name: {
-                                        readonly type: "string";
-                                    };
-                                    readonly status: {
-                                        readonly type: "string";
-                                        readonly enum: readonly ["ACTIVE", "PAUSED"];
-                                    };
-                                    readonly lanes: {
-                                        readonly type: "array";
-                                        readonly minItems: 1;
-                                        readonly items: {
-                                            readonly type: "string";
-                                            readonly enum: readonly ["connection_invite", "paid_inmail"];
-                                        };
-                                    };
                                     readonly eligible: {
                                         readonly type: "boolean";
                                     };
@@ -249,111 +291,6 @@ export declare const refillV3WorldStateToolDefinitions: {
                                             };
                                         };
                                     };
-                                    readonly startEligible: {
-                                        readonly type: "boolean";
-                                    };
-                                    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 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 leadSourceFamily: {
-                                        readonly type: "string";
-                                        readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
-                                    };
-                                    readonly evidence: {
-                                        readonly type: "object";
-                                        readonly additionalProperties: false;
-                                        readonly required: readonly ["evergreen", "lastActualUseAt", "lastScheduledUseAt", "effectiveness", "supplyHealth"];
-                                        readonly properties: {
-                                            readonly evergreen: {
-                                                readonly type: "boolean";
-                                            };
-                                            readonly createdAt: {
-                                                readonly type: readonly ["string", "null"];
-                                            };
-                                            readonly lastActualUseAt: {
-                                                readonly type: readonly ["string", "null"];
-                                            };
-                                            readonly lastScheduledUseAt: {
-                                                readonly type: readonly ["string", "null"];
-                                            };
-                                            readonly effectiveness: {
-                                                readonly type: "string";
-                                                readonly enum: readonly ["unknown", "low", "medium", "high"];
-                                            };
-                                            readonly supplyHealth: {
-                                                readonly type: "string";
-                                                readonly enum: readonly ["unknown", "healthy", "thin", "dry"];
-                                            };
-                                            readonly engagement: {
-                                                readonly type: "object";
-                                                readonly additionalProperties: false;
-                                                readonly required: readonly ["sends", "accepted", "replied", "acceptRate", "replyRate"];
-                                                readonly properties: {
-                                                    readonly sends: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                    };
-                                                    readonly accepted: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                    };
-                                                    readonly replied: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                    };
-                                                    readonly acceptRate: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                        readonly maximum: 100;
-                                                    };
-                                                    readonly replyRate: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                        readonly maximum: 100;
-                                                    };
-                                                };
-                                            };
-                                        };
-                                    };
                                 };
                             };
                         };
@@ -362,27 +299,12 @@ export declare const refillV3WorldStateToolDefinitions: {
                             readonly items: {
                                 readonly type: "object";
                                 readonly additionalProperties: false;
-                                readonly required: readonly ["id", "name", "status", "lanes", "eligible", "reason", "startEligible", "activeJob", "supply", "leadSourceFamily", "evidence"];
+                                readonly required: readonly ["id", "eligible", "reason"];
                                 readonly properties: {
                                     readonly id: {
                                         readonly type: "string";
                                         readonly minLength: 1;
                                     };
-                                    readonly name: {
-                                        readonly type: "string";
-                                    };
-                                    readonly status: {
-                                        readonly type: "string";
-                                        readonly enum: readonly ["ACTIVE", "PAUSED"];
-                                    };
-                                    readonly lanes: {
-                                        readonly type: "array";
-                                        readonly minItems: 1;
-                                        readonly items: {
-                                            readonly type: "string";
-                                            readonly enum: readonly ["connection_invite", "paid_inmail"];
-                                        };
-                                    };
                                     readonly eligible: {
                                         readonly type: "boolean";
                                     };
@@ -410,112 +332,81 @@ export declare const refillV3WorldStateToolDefinitions: {
                                             };
                                         };
                                     };
-                                    readonly startEligible: {
-                                        readonly type: "boolean";
-                                    };
-                                    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 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 leadSourceFamily: {
+                                };
+                            };
+                        };
+                        readonly date: {
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                        };
+                        readonly sender: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["id", "name", "timezone"];
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                };
+                                readonly timezone: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                            };
+                        };
+                        readonly lane: {
+                            readonly type: "string";
+                            readonly enum: readonly ["connection_invite", "paid_inmail"];
+                        };
+                        readonly targetSlots: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly takenSlots: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly remainingTargetGap: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly fillableSlotsNow: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly blockedGap: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly availableSlots: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly reason: {
+                            readonly type: readonly ["object", "null"];
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["kind", "codes", "message"];
+                            readonly properties: {
+                                readonly kind: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["unavailable", "retry_required", "invalid_campaign_configuration"];
+                                };
+                                readonly codes: {
+                                    readonly type: "array";
+                                    readonly items: {
                                         readonly type: "string";
-                                        readonly enum: readonly ["post_engager", "signal_discovery", "cold"];
-                                    };
-                                    readonly evidence: {
-                                        readonly type: "object";
-                                        readonly additionalProperties: false;
-                                        readonly required: readonly ["evergreen", "lastActualUseAt", "lastScheduledUseAt", "effectiveness", "supplyHealth"];
-                                        readonly properties: {
-                                            readonly evergreen: {
-                                                readonly type: "boolean";
-                                            };
-                                            readonly createdAt: {
-                                                readonly type: readonly ["string", "null"];
-                                            };
-                                            readonly lastActualUseAt: {
-                                                readonly type: readonly ["string", "null"];
-                                            };
-                                            readonly lastScheduledUseAt: {
-                                                readonly type: readonly ["string", "null"];
-                                            };
-                                            readonly effectiveness: {
-                                                readonly type: "string";
-                                                readonly enum: readonly ["unknown", "low", "medium", "high"];
-                                            };
-                                            readonly supplyHealth: {
-                                                readonly type: "string";
-                                                readonly enum: readonly ["unknown", "healthy", "thin", "dry"];
-                                            };
-                                            readonly engagement: {
-                                                readonly type: "object";
-                                                readonly additionalProperties: false;
-                                                readonly required: readonly ["sends", "accepted", "replied", "acceptRate", "replyRate"];
-                                                readonly properties: {
-                                                    readonly sends: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                    };
-                                                    readonly accepted: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                    };
-                                                    readonly replied: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                    };
-                                                    readonly acceptRate: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                        readonly maximum: 100;
-                                                    };
-                                                    readonly replyRate: {
-                                                        readonly type: "number";
-                                                        readonly minimum: 0;
-                                                        readonly maximum: 100;
-                                                    };
-                                                };
-                                            };
-                                        };
+                                        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"];
                                     };
                                 };
+                                readonly message: {
+                                    readonly type: "string";
+                                };
+                                readonly resumeAt: {
+                                    readonly type: "string";
+                                };
                             };
                         };
                         readonly paidCreditEvidence: {
@@ -564,6 +455,9 @@ export declare const refillV3WorldStateToolDefinitions: {
                             };
                         };
                     };
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["date", "sender", "lane", "targetSlots", "takenSlots", "remainingTargetGap", "fillableSlotsNow", "blockedGap", "availableSlots", "reason", "activeCampaigns", "inactiveCampaigns"];
                 };
             };
             readonly durationMs: {

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

@@ -28,7 +28,7 @@
  */
 import { getApi } from "../api.js";
 import { REFILL_V3_SCHEMA_VERSION_UNSUPPORTED } from "./refill-v3-attention-packet-contract.js";
-import { decodeRefillWorldStateResult, REFILL_V3_WORLD_STATE_OUTPUT_SCHEMA, } from "./refill-v3-world-state-contract.js";
+import { decodeRefillWorldStateResult, REFILL_V3_WORLD_STATE_AGENT_OUTPUT_SCHEMA, } from "./refill-v3-world-state-contract.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
 /** The one authenticated backend boundary this projection may reach. */
 export const REFILL_V3_WORLD_STATE_ROUTE = "/api/v3/mcp/refill-v3/world-state";
@@ -98,9 +98,9 @@ const REFILL_V3_WORLD_STATE_TOOL_INPUT_SCHEMA = {
 export const refillV3WorldStateToolDefinitions = [
     {
         name: REFILL_V3_WORLD_STATE_TOOL_NAME,
-        description: "One factual observation of Refill V3 send capacity. It returns one row per scoped sender, per scoped local date, per lane, where the two lanes connection_invite and paid_inmail are independent: each carries its own slots, its own typed blocker, and its own eligible and ineligible campaign options. A scoped sender/date request refreshes both lanes of that sender and date atomically, so the two lanes are never read from different instants. It states facts and never chooses: it schedules nothing, places nothing, sends nothing, approves nothing, enriches nothing, generates nothing, and mutates no campaign, and it reports each of those explicitly as false. The one bookkeeping effect it may perform is a paid-InMail credit cache read or refresh, reported as its own outcome.",
+        description: "One factual observation of Refill V3 send capacity. It returns one row per scoped sender, per scoped local date, per lane, where the two lanes connection_invite and paid_inmail are independent: each carries its own slots, its own typed blocker, and its own eligible and ineligible campaign options. Each campaign's facts (name, status, supply, evidence) appear once in top-level `campaigns`; a row's `activeCampaigns` and `inactiveCampaigns` name those campaigns by id with that row's own eligibility and reason. A scoped sender/date request refreshes both lanes of that sender and date atomically, so the two lanes are never read from different instants. It states facts and never chooses: it schedules nothing, places nothing, sends nothing, approves nothing, enriches nothing, generates nothing, and mutates no campaign, and it reports each of those explicitly as false. The one bookkeeping effect it may perform is a paid-InMail credit cache read or refresh, reported as its own outcome.",
         inputSchema: REFILL_V3_WORLD_STATE_TOOL_INPUT_SCHEMA,
-        outputSchema: REFILL_V3_WORLD_STATE_OUTPUT_SCHEMA,
+        outputSchema: REFILL_V3_WORLD_STATE_AGENT_OUTPUT_SCHEMA,
         annotations: {
             title: "Refill V3 World State",
             // NOT literal read-only: the observation is allowed to perform paid-credit