@sellable/mcp 0.1.70 → 0.1.72

package/agents/registry.json

@@ -24,7 +24,8 @@
       },
       "codex": {
         "description": "Sellable lead-source scout for LinkedIn post engagement and active conversation signals.",
-        "modelReasoningEffort": "medium",
+        "model": "gpt-5.5",
+        "modelReasoningEffort": "high",
         "sandboxMode": "read-only",
         "nicknameCandidates": [
           "LinkedIn Engagement Scout",
@@ -71,7 +72,8 @@
       },
       "codex": {
         "description": "Sellable lead-source scout for Sales Navigator role, company, and activity filters.",
-        "modelReasoningEffort": "medium",
+        "model": "gpt-5.5",
+        "modelReasoningEffort": "high",
         "sandboxMode": "read-only",
         "nicknameCandidates": [
           "Sales Nav Scout",
@@ -118,7 +120,8 @@
       },
       "codex": {
         "description": "Sellable lead-source scout for Prospeo account/domain and broad contact expansion.",
-        "modelReasoningEffort": "medium",
+        "model": "gpt-5.5",
+        "modelReasoningEffort": "high",
         "sandboxMode": "read-only",
         "nicknameCandidates": [
           "Prospeo Contact Scout",

package/dist/tools/campaigns.js

@@ -1,6 +1,6 @@
 import { getApi } from "../api.js";
 import { getConfig } from "../auth.js";
-import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchReady, } from "./flow-preflight.js";
+import { assertCreateCampaignPromptLoaded } from "./flow-preflight.js";
 import { setCampaignInteractionMode, } from "./interaction-mode.js";
 import { fetchCampaignRubrics } from "./processing.js";
 const LEAD_SOURCE_PROVIDERS = {
@@ -123,7 +123,9 @@ export const campaignToolDefinitions = [
     },
     {
         name: "create_campaign",
-        description: 'Create a new campaign offer OR resume an existing one. Low-level write tool: load create-campaign workflow instructions first via get_subskill_prompt({ subskillName: "create-campaign" }) (or bootstrap_create_campaign + nextStep). If campaignId is provided, this tool returns the watchUrl + state for that campaign instead of creating a new campaign.\n\nINPUTS:\n- `clientProspectId` is REQUIRED for net-new campaigns. It is the EnrichedProspect row ID for the campaign sender (used by ICP scoring, message generation, brief rendering — every downstream consumer reads sender context from `campaign.clientProspect`).\n- To obtain a `clientProspectId`, run the sender-enrichment flow first: this materializes an EnrichedProspect row from the sender\'s LinkedIn profile URL and returns its ID.\n- `senderLinkedinUrl` may be passed as informational metadata but is NOT a substitute for `clientProspectId` — the API will reject the create if `clientProspectId` is missing.\n\nPREREQUISITES:\n- The /research-sender skill must have been run for this sender (produces enrichment data and the EnrichedProspect row whose ID is `clientProspectId`).',
+        description: 'Create a new campaign offer OR resume an existing one. Low-level write tool: load create-campaign workflow instructions first via get_subskill_prompt({ subskillName: "create-campaign" }) (or bootstrap_create_campaign + nextStep). If campaignId is provided, this tool returns the watchUrl + state for that campaign instead of creating a new campaign.\n\n' +
+            "INPUTS:\n- Pass either `clientProspectId` (preferred) or `senderLinkedinUrl` for net-new campaigns.\n- `clientProspectId` is the EnrichedProspect row ID for the campaign sender, used by ICP scoring, message generation, and brief rendering.\n- `senderLinkedinUrl` may be passed when `clientProspectId` is not yet materialized; the backend will attempt to resolve a sender prospect from it.\n\n" +
+            "PREREQUISITES:\n- If you provide `senderLinkedinUrl`, it is used as a sender bootstrap signal.\n- `clientProspectId` is optional when sender URL is available and allows a direct materialized sender context.\n- `clientProspectId` is preferred for deterministic sender resolution.",
         inputSchema: {
             type: "object",
             properties: {
@@ -137,13 +139,13 @@ export const campaignToolDefinitions = [
                 },
                 clientProspectId: {
                     type: "string",
-                    description: "REQUIRED for net-new campaigns. EnrichedProspect row ID for the campaign sender. Produced by the sender-enrichment flow (research-sender). The API will reject the create with a 400 if this is missing.",
+                    description: "Use this for existing sender prospects. For brand-new senders, pass `senderLinkedinUrl` and the backend will attempt sender lookup/creation during campaign mint.",
                 },
                 // `senderLinkedinUrl` (not `linkedinUrl`) to disambiguate from
                 // prospect-side `linkedinUrl` fields used in other tools (research-prospect etc.).
                 senderLinkedinUrl: {
                     type: "string",
-                    description: "Optional informational metadata: the sender's LinkedIn profile URL. NOT a substitute for clientProspectId — to materialize a prospect from a URL, run the sender-enrichment flow first.",
+                    description: "Optional sender LinkedIn profile URL. Use when sender prospect ID is not yet materialized and backend bootstrap should be used.",
                 },
                 offerPositioning: {
                     type: "object",
@@ -597,32 +599,32 @@ export async function createCampaign(input) {
         missing.push("name");
     if (!input.campaignBrief)
         missing.push("campaignBrief");
-    // clientProspectId is required for net-new campaigns. Every downstream
-    // consumer (ICP scoring, message generation, brief rendering) reads sender
-    // context from `campaign.clientProspect`. senderLinkedinUrl is informational
-    // metadata only — it is NOT a substitute and the API will reject the create
-    // if clientProspectId is missing.
-    if (!input.clientProspectId) {
-        missing.push("clientProspectId");
+    const hasClientProspectId = typeof input.clientProspectId === "string" &&
+        input.clientProspectId.trim().length > 0;
+    const senderLinkedinUrl = typeof input.senderLinkedinUrl === "string"
+        ? input.senderLinkedinUrl.trim()
+        : "";
+    // For net-new campaigns, require at least one sender identity signal.
+    if (!hasClientProspectId && !senderLinkedinUrl) {
+        missing.push("clientProspectId or senderLinkedinUrl");
     }
     // Cheap URL sanity check on senderLinkedinUrl when supplied.
-    if (input.senderLinkedinUrl &&
-        typeof input.senderLinkedinUrl === "string" &&
-        !input.senderLinkedinUrl.includes("linkedin.com")) {
+    if (senderLinkedinUrl && !senderLinkedinUrl.includes("linkedin.com")) {
         throw new Error("VALIDATION_ERROR: senderLinkedinUrl must be a LinkedIn URL (must contain 'linkedin.com'). Got: " +
-            input.senderLinkedinUrl);
+            senderLinkedinUrl);
     }
     if (missing.length > 0) {
         throw new Error("VALIDATION_ERROR: create_campaign requires either campaignId (resume) " +
             `or all create fields. Missing: ${missing.join(", ")}.\n\n` +
             "Remediation:\n" +
             '- For full workflow, call get_subskill_prompt({ subskillName: "create-campaign" }) and follow it.\n' +
-            "- For net-new campaign creation: run the `research-sender` flow first to materialize an EnrichedProspect for the sender from their LinkedIn profile URL, then pass the resulting prospect ID as `clientProspectId`. The campaign sender context (used by ICP scoring, message generation, brief rendering) is read from `campaign.clientProspect`, so this row must exist before the campaign is minted.\n" +
+            "- For net-new campaign creation: pass either `clientProspectId` (preferred) or `senderLinkedinUrl` and let the backend resolve sender context at mint time.\n" +
             "- For resume, call create_campaign with campaignId only.");
     }
-    assertNetNewCreateCampaignResearchReady();
     const name = input.name;
-    const clientProspectId = input.clientProspectId ?? null;
+    const clientProspectId = hasClientProspectId
+        ? input.clientProspectId?.trim()
+        : null;
     const campaignBrief = input.campaignBrief;
     // Validate required campaignBrief - must be non-empty markdown
     // Normalize escaped newlines - MCP tool calls pass literal "\n" text (backslash + n)
@@ -677,15 +679,13 @@ export async function createCampaign(input) {
         ...apiInput,
         name,
         clientProspectId,
-        // Forward senderLinkedinUrl alongside clientProspectId. Downstream API may
-        // ignore it for now; future phase wires it.
-        senderLinkedinUrl: input.senderLinkedinUrl ?? null,
         offerPositioning,
         ...(input.leadSourceProvider !== undefined
             ? { leadSourceProvider: normalizedLeadSourceProvider }
             : {}),
         currentStep: currentStep ?? "create-offer",
         leadSourceType: input.leadSourceType ?? "new",
+        senderLinkedinUrl,
         campaignBrief: {
             name, // Use campaign name as brief name
             content: briefContent, // The markdown content

package/dist/tools/one-off.d.ts

@@ -29,7 +29,7 @@ export type CreateOnDemandCampaignInput = {
     name: string;
     clientProspectId?: string;
     senderLinkedinUrl?: string;
-    senderIds: string[];
+    senderIds?: string[];
     campaignBrief?: unknown;
     offerPositioning?: Record<string, unknown>;
     sequenceTemplate?: Record<string, unknown>;

package/dist/tools/one-off.js

@@ -111,7 +111,7 @@ export const onDemandToolDefinitions = [
                     description: "Set true to overwrite existing sequence columns",
                 },
             },
-            required: ["name", "senderIds"],
+            required: ["name"],
         },
     },
     {
@@ -194,7 +194,15 @@ export async function createOnDemandTable(input) {
         throw new Error("VALIDATION_ERROR: create_on_demand_table requires either clientProspectId (existing prospect ID) or senderLinkedinUrl (sender's LinkedIn profile URL). Pass one.");
     }
     const api = getApi();
-    return api.post("/api/v3/on-demand-campaigns", input);
+    const payload = { ...input };
+    const senderIds = Array.isArray(input.senderIds) ? input.senderIds : [];
+    if (senderIds.length > 0) {
+        payload.senderIds = senderIds;
+    }
+    else {
+        delete payload.senderIds;
+    }
+    return api.post("/api/v3/on-demand-campaigns", payload);
 }
 export async function addOnDemandLeads(input) {
     const api = getApi();
@@ -237,9 +245,6 @@ export async function createOnDemandCampaign(input) {
     if (!input.clientProspectId && !input.senderLinkedinUrl) {
         throw new Error("VALIDATION_ERROR: create_on_demand_campaign requires either clientProspectId (existing prospect ID) or senderLinkedinUrl (sender's LinkedIn profile URL). Pass one.");
     }
-    if (!Array.isArray(input.senderIds) || input.senderIds.length === 0) {
-        throw new Error("senderIds must be a non-empty array");
-    }
     const campaign = await createOnDemandTable({
         name: input.name,
         senderIds: input.senderIds,
@@ -284,7 +289,7 @@ export async function createOnDemandCampaign(input) {
     return {
         tableId,
         campaignOfferId,
-        senderIds: input.senderIds,
+        senderIds: input.senderIds ?? [],
         sequenceInitialized: true,
     };
 }

package/dist/tools/prompts.d.ts

@@ -71,6 +71,8 @@ export interface SourceScoutRegistryResponse {
         codex: {
             filename: string;
             description: string;
+            model: string;
+            modelReasoningEffort: string;
         };
         claude: {
             filename: string;

package/dist/tools/prompts.js

@@ -211,6 +211,8 @@ export function getSourceScoutRegistry() {
             codex: {
                 filename: String(agent.codex?.filename || `${agent.name}.toml`),
                 description: String(agent.codex?.description || ""),
+                model: String(agent.codex?.model || "gpt-5.5"),
+                modelReasoningEffort: String(agent.codex?.modelReasoningEffort || "high"),
             },
             claude: {
                 filename: String(agent.claude?.filename || `${agent.name}.md`),

package/package.json

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