@sellable/install 0.1.70 → 0.1.71

package/README.md

@@ -35,9 +35,11 @@ Auth is stored once at:
 
 Claude Code and Codex are configured to launch the same packaged MCP server. The
 installer also writes Sellable source-scout agents for both hosts from the
-packaged `agents/` registry: Claude Code gets `lead-explorer-*` subagents, and
-Codex gets `linkedin_engagement_scout`, `sales_nav_scout`, and
-`prospeo_contact_scout`.
+packaged `agents/` registry: Claude Code gets `source-scout-*` subagents, and
+Codex gets `source-scout-linkedin-engagement`, `source-scout-sales-nav`, and
+`source-scout-prospeo-contact`. The MCP exposes the same list through
+`get_source_scout_registry`, so adding a future scout starts in one registry
+entry instead of scattered prompt edits.
 
 ## Names
 

package/agents/registry.json

@@ -2,12 +2,27 @@
   "version": 1,
   "agents": [
     {
-      "id": "linkedin-engagement-scout",
-      "promptFile": "linkedin-engagement-scout.md",
+      "id": "linkedin-engagement",
+      "name": "source-scout-linkedin-engagement",
+      "promptFile": "source-scout-linkedin-engagement.md",
       "displayName": "LinkedIn Engagement Scout",
+      "provider": "signal-discovery",
+      "lane": "linkedin-engagement",
+      "legacy": {
+        "codex": [
+          {
+            "name": "linkedin_engagement_scout",
+            "filename": "linkedin-engagement-scout.toml"
+          }
+        ],
+        "claude": [
+          {
+            "name": "lead-explorer-signals",
+            "filename": "lead-explorer-signals.md"
+          }
+        ]
+      },
       "codex": {
-        "name": "linkedin_engagement_scout",
-        "filename": "linkedin-engagement-scout.toml",
         "description": "Sellable lead-source scout for LinkedIn post engagement and active conversation signals.",
         "modelReasoningEffort": "medium",
         "sandboxMode": "read-only",
@@ -18,8 +33,6 @@
         ]
       },
       "claude": {
-        "name": "lead-explorer-signals",
-        "filename": "lead-explorer-signals.md",
         "description": "Use proactively as a background Sellable source scout when find-leads or create-campaign needs LinkedIn post engagement, Signals, or active conversation evidence.",
         "model": "inherit",
         "background": true,
@@ -36,12 +49,27 @@
       }
     },
     {
-      "id": "sales-nav-scout",
-      "promptFile": "sales-nav-scout.md",
+      "id": "sales-nav",
+      "name": "source-scout-sales-nav",
+      "promptFile": "source-scout-sales-nav.md",
       "displayName": "Sales Nav Scout",
+      "provider": "sales-nav",
+      "lane": "sales-nav",
+      "legacy": {
+        "codex": [
+          {
+            "name": "sales_nav_scout",
+            "filename": "sales-nav-scout.toml"
+          }
+        ],
+        "claude": [
+          {
+            "name": "lead-explorer-sales-nav",
+            "filename": "lead-explorer-sales-nav.md"
+          }
+        ]
+      },
       "codex": {
-        "name": "sales_nav_scout",
-        "filename": "sales-nav-scout.toml",
         "description": "Sellable lead-source scout for Sales Navigator role, company, and activity filters.",
         "modelReasoningEffort": "medium",
         "sandboxMode": "read-only",
@@ -52,8 +80,6 @@
         ]
       },
       "claude": {
-        "name": "lead-explorer-sales-nav",
-        "filename": "lead-explorer-sales-nav.md",
         "description": "Use proactively as a background Sellable source scout when find-leads or create-campaign needs Sales Navigator title, company, geography, or activity-filter evidence.",
         "model": "inherit",
         "background": true,
@@ -70,12 +96,27 @@
       }
     },
     {
-      "id": "prospeo-contact-scout",
-      "promptFile": "prospeo-contact-scout.md",
+      "id": "prospeo-contact",
+      "name": "source-scout-prospeo-contact",
+      "promptFile": "source-scout-prospeo-contact.md",
       "displayName": "Prospeo Contact Scout",
+      "provider": "prospeo",
+      "lane": "prospeo-contact",
+      "legacy": {
+        "codex": [
+          {
+            "name": "prospeo_contact_scout",
+            "filename": "prospeo-contact-scout.toml"
+          }
+        ],
+        "claude": [
+          {
+            "name": "lead-explorer-prospeo",
+            "filename": "lead-explorer-prospeo.md"
+          }
+        ]
+      },
       "codex": {
-        "name": "prospeo_contact_scout",
-        "filename": "prospeo-contact-scout.toml",
         "description": "Sellable lead-source scout for Prospeo account/domain and broad contact expansion.",
         "modelReasoningEffort": "medium",
         "sandboxMode": "read-only",
@@ -86,8 +127,6 @@
         ]
       },
       "claude": {
-        "name": "lead-explorer-prospeo",
-        "filename": "lead-explorer-prospeo.md",
         "description": "Use proactively as a background Sellable source scout when find-leads or create-campaign needs Prospeo account, domain-list, CSV-domain, or verified-contact evidence.",
         "model": "inherit",
         "background": true,

package/bin/sellable-install.mjs

@@ -465,6 +465,7 @@ const CREATE_CAMPAIGN_ALLOWED_TOOLS = [
   "mcp__sellable__get_subskill_asset",
   "mcp__sellable__search_subskill_prompts",
   "mcp__sellable__get_provider_prompt",
+  "mcp__sellable__get_source_scout_registry",
   "mcp__sellable__get_message_prompt",
   "mcp__sellable__get_active_workspace",
   "mcp__sellable__list_senders",
@@ -1124,14 +1125,18 @@ function loadCanonicalAgents() {
 
   return registry.agents.map((agent) => {
     const promptPath = join(root, agent.promptFile || "");
-    if (!agent.id || !agent.promptFile || !existsSync(promptPath)) {
+    if (!agent.id || !agent.name || !agent.promptFile || !existsSync(promptPath)) {
       throw new Error(`Invalid Sellable agent registry entry: ${agent.id || "unknown"}`);
     }
-    if (!agent.codex?.name || !agent.codex?.filename) {
-      throw new Error(`Sellable agent ${agent.id} is missing Codex metadata.`);
+    if (agent.codex?.name && agent.codex.name !== agent.name) {
+      throw new Error(
+        `Sellable agent ${agent.id} has divergent Codex name ${agent.codex.name}; use canonical name ${agent.name}.`
+      );
     }
-    if (!agent.claude?.name || !agent.claude?.filename) {
-      throw new Error(`Sellable agent ${agent.id} is missing Claude metadata.`);
+    if (agent.claude?.name && agent.claude.name !== agent.name) {
+      throw new Error(
+        `Sellable agent ${agent.id} has divergent Claude name ${agent.claude.name}; use canonical name ${agent.name}.`
+      );
     }
 
     return {
@@ -1141,6 +1146,22 @@ function loadCanonicalAgents() {
   });
 }
 
+function codexAgentFilename(agent) {
+  return agent.codex?.filename || `${agent.name}.toml`;
+}
+
+function claudeAgentFilename(agent) {
+  return agent.claude?.filename || `${agent.name}.md`;
+}
+
+function legacyCodexCustomAgents() {
+  return loadCanonicalAgents().flatMap((agent) => agent.legacy?.codex || []);
+}
+
+function legacyClaudeCustomAgents() {
+  return loadCanonicalAgents().flatMap((agent) => agent.legacy?.claude || []);
+}
+
 function tomlArray(values) {
   return `[${values.map((value) => quoteToml(value)).join(", ")}]`;
 }
@@ -1152,7 +1173,7 @@ function tomlMultilineString(value) {
 
 function generateCodexAgentToml(agent) {
   const codex = agent.codex;
-  return `name = ${quoteToml(codex.name)}
+  return `name = ${quoteToml(agent.name)}
 description = ${quoteToml(codex.description)}
 model_reasoning_effort = ${quoteToml(codex.modelReasoningEffort || "medium")}
 sandbox_mode = ${quoteToml(codex.sandboxMode || "read-only")}
@@ -1163,8 +1184,8 @@ developer_instructions = ${tomlMultilineString(agent.prompt)}
 
 function codexCustomAgents() {
   return loadCanonicalAgents().map((agent) => ({
-    name: agent.codex.name,
-    filename: agent.codex.filename,
+    name: agent.name,
+    filename: codexAgentFilename(agent),
     content: generateCodexAgentToml(agent),
   }));
 }
@@ -1172,7 +1193,7 @@ function codexCustomAgents() {
 function generateClaudeAgentMd(agent) {
   const claude = agent.claude;
   return `---
-name: ${claude.name}
+name: ${agent.name}
 description: ${JSON.stringify(claude.description)}
 tools: ${(claude.tools || []).join(", ")}
 model: ${claude.model || "inherit"}
@@ -1187,8 +1208,8 @@ ${agent.prompt}
 
 function claudeCustomAgents() {
   return loadCanonicalAgents().map((agent) => ({
-    name: agent.claude.name,
-    filename: agent.claude.filename,
+    name: agent.name,
+    filename: claudeAgentFilename(agent),
     tools: agent.claude.tools || [],
     content: generateClaudeAgentMd(agent),
   }));
@@ -1213,6 +1234,11 @@ function writeCodexCustomAgents(home, opts) {
   for (const agent of codexCustomAgents()) {
     writeFile(join(home, "agents", agent.filename), agent.content, opts);
   }
+  for (const agent of legacyCodexCustomAgents()) {
+    const legacyPath = join(home, "agents", agent.filename);
+    logVerbose(`${C.grey}Removing legacy Codex scout agent ${legacyPath}${C.reset}`);
+    if (!opts.dryRun) rmSync(legacyPath, { force: true });
+  }
 }
 
 function claudeHome() {
@@ -1224,6 +1250,11 @@ function writeClaudeCustomAgents(opts) {
   for (const agent of claudeCustomAgents()) {
     writeFile(join(home, "agents", agent.filename), agent.content, opts);
   }
+  for (const agent of legacyClaudeCustomAgents()) {
+    const legacyPath = join(home, "agents", agent.filename);
+    logVerbose(`${C.grey}Removing legacy Claude scout agent ${legacyPath}${C.reset}`);
+    if (!opts.dryRun) rmSync(legacyPath, { force: true });
+  }
 }
 
 function installCodexDesktopPlugin(opts) {
@@ -1339,6 +1370,9 @@ enabled = false`
 max_threads = 6
 max_depth = 1`
     );
+    for (const agent of legacyCodexCustomAgents()) {
+      content = removeTomlSection(content, `agents.${agent.name}`);
+    }
     for (const agent of codexCustomAgents()) {
       content = upsertTomlTable(
         content,
@@ -1861,7 +1895,7 @@ function runUninstall() {
       after = removeTomlSection(after, "marketplaces.sellable");
       after = removeTomlSection(after, 'plugins."sellable@sellable"');
       after = removeTomlSection(after, 'plugins."sellable@sellable-local"');
-      for (const agent of codexCustomAgents()) {
+      for (const agent of [...codexCustomAgents(), ...legacyCodexCustomAgents()]) {
         after = removeTomlSection(after, `agents.${agent.name}`);
       }
       // Collapse 3+ blank lines that the removals may leave behind.
@@ -1884,7 +1918,7 @@ function runUninstall() {
     skipped.push(`Codex config not found at ${codexConfigPath}`);
   }
 
-  for (const agent of codexCustomAgents()) {
+  for (const agent of [...codexCustomAgents(), ...legacyCodexCustomAgents()]) {
     const agentPath = join(codexHome(), "agents", agent.filename);
     if (!existsSync(agentPath)) continue;
     try {
@@ -1911,7 +1945,7 @@ function runUninstall() {
     skipped.push(`Claude Code CLI not found`);
   }
 
-  for (const agent of claudeCustomAgents()) {
+  for (const agent of [...claudeCustomAgents(), ...legacyClaudeCustomAgents()]) {
     const agentPath = join(claudeHome(), "agents", agent.filename);
     if (!existsSync(agentPath)) continue;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.70",
+  "version": "0.1.71",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code and Codex",
   "bin": {

package/skill-templates/create-campaign.md

@@ -11,6 +11,7 @@ allowed-tools:
   - mcp__sellable__get_subskill_asset
   - mcp__sellable__search_subskill_prompts
   - mcp__sellable__get_provider_prompt
+  - mcp__sellable__get_source_scout_registry
   - mcp__sellable__get_message_prompt
   - mcp__sellable__get_active_workspace
   - mcp__sellable__list_senders
@@ -102,12 +103,14 @@ scout those angles as independent branches when the host can actually do it:
 LinkedIn Engagement / active post engagers (internal `signal-discovery`
 provider prompt), Sales Nav / title + company filters, and Prospeo Contact /
 domains only when relevant. In Codex, explicitly spawn the named custom scouts
-`linkedin_engagement_scout`, `sales_nav_scout`, and `prospeo_contact_scout` for
+`source-scout-linkedin-engagement`, `source-scout-sales-nav`, and `source-scout-prospeo-contact` for
 the credible lanes; Codex does not infer subagent fan-out from generic source
-comparison wording. In Claude Code, invoke the generated `lead-explorer-*`
+comparison wording. In Claude Code, invoke the generated `source-scout-*`
 Task/Agent subagents for all credible lanes in one assistant message; the
 installer writes them from the same canonical Sellable agent registry with
-explicit Sellable MCP tool allowlists. If the host runs them sequentially, do not
+explicit Sellable MCP tool allowlists. The create-campaign-v2 subskill calls
+`get_source_scout_registry` before dispatch so the current registry, not this
+copy, is the runtime source of truth. If the host runs them sequentially, do not
 claim they ran in parallel. In chat, call the downstream copy stage `message generation`;
 `message-validation.md` is only an internal proof artifact.