@sellable/install 0.1.331 → 0.1.333-phase981.202607110535

package/HERMES-SLACK-PROFILE-SCOPING.md

@@ -15,9 +15,6 @@ customer's profile-local Sellable MCP config. Customer profiles must not store
 or read Sellable Admin MCP credentials, admin Slack app tokens, or sibling
 profile config.
 
-The shared dispatcher remains a fallback/research path only. Use it only when
-Sellable Admin explicitly owns one shared listener and route registry.
-
 The 2026-07-06 Hostinger POC proved the native Hermes listener for the
 `sellable-admin` profile with the existing `Sellable Reply Bot` app in
 `#team-chat`: a human mention produced a new Hermes session and a threaded bot
@@ -34,8 +31,7 @@ hermes --profile acme send --to slack:C0BFERDV3N0 --subject '[Hermes acme smoke]
 
 That succeeded and is useful as an internal smoke test. It does not change the
 inbound listener rule: each active customer profile needs its own native Slack
-app token pair unless Sellable Admin deliberately chooses the dispatcher
-fallback.
+app token pair.
 
 ## Which Slack Values Are Enough
 
@@ -128,27 +124,14 @@ closed before making Sellable API calls instead of falling back to shared or
 admin config state. Only the `sellable-admin` profile should provision,
 inspect, or repair other profiles.
 
-For the shared dispatcher model, do not copy the shared `SLACK_BOT_TOKEN` or
-`SLACK_APP_TOKEN` into customer profile `.env` files. The dispatcher owns those
-tokens and route metadata decides the customer profile.
-
-## Shared Dispatcher Ownership
-
-The shared Slack dispatcher and its route registry are fallback Sellable Admin
-surfaces. This customer-facing installer must not create shared route bundles or
-write shared listener tokens. Sellable Admin owns Slack app creation and profile
-provisioning, then calls this installer for profile-local Sellable runtime
-bootstrap inside the already-provisioned Hermes profile.
-
 ## Verification
 
-Run the installer and dispatcher UAT before publishing installer changes:
+Run the installer and native profile UAT before publishing installer changes:
 
 ```bash
 npm run test:unit -- tests/install-package/agent-preferences.test.ts
 scripts/run-phase92-hermes-profile-bootstrap-uat.sh --mode local-temp
 scripts/run-phase92-hermes-profile-bootstrap-uat.sh --mode linux-shaped
-scripts/run-phase031-hermes-slack-dispatcher-uat.sh --mode local-fixture
 ```
 
 Expected proof:

package/README.md

@@ -212,6 +212,7 @@ source-scout agents.
 Use the same public entrypoints across supported hosts:
 
 - Claude Code: `/sellable:create-campaign`
+- Claude Code: `/sellable:find-leads`
 - Claude Code: `/sellable:create-ab-test`
 - Claude Code: `/sellable:create-evergreen-campaigns`
 - Claude Code: `/sellable:foundation`
@@ -220,6 +221,7 @@ Use the same public entrypoints across supported hosts:
 - Claude Code: `/sellable:refresh-sender-engagement`
 - Claude Code: `/sellable:refill-sends`
 - Codex: `$sellable:create-campaign`
+- Codex: `$sellable:find-leads`
 - Codex: `$sellable:create-ab-test`
 - Codex: `$sellable:create-evergreen-campaigns`
 - Codex: `$sellable:foundation`
@@ -228,6 +230,7 @@ Use the same public entrypoints across supported hosts:
 - Codex: `$sellable:refresh-sender-engagement`
 - Codex: `$sellable:refill-sends`
 - Hermes: `/sellable-create-campaign`
+- Hermes: `/sellable-find-leads`
 - Hermes: `/sellable-create-ab-test`
 - Hermes: `/sellable-create-evergreen-campaigns`
 - Hermes: `/sellable-foundation`
@@ -237,6 +240,7 @@ Use the same public entrypoints across supported hosts:
 - Hermes: `/sellable-refill-sends`
 - Codex Desktop plugin: `sellable@sellable`
 - Codex visible skill: `Sellable Create Campaign`
+- Codex visible skill: `Sellable Find Leads`
 - Codex visible skill: `Sellable Create A/B Test`
 - Codex visible skill: `Sellable Create Evergreen Campaigns`
 - Codex visible skill: `Sellable Foundation`
@@ -245,6 +249,7 @@ Use the same public entrypoints across supported hosts:
 - Codex visible skill: `Sellable Refresh Sender Engagement`
 - Codex visible skill: `Sellable Refill Sends`
 - Internal MCP workflow prompt: `create-campaign-v2`
+- Internal MCP workflow prompt: `find-leads-v2`
 - Internal MCP workflow prompt: `refill-sends-workflow`
 - Internal/backward-compatible memory prompt: `interview`
 

package/bin/sellable-install.mjs

@@ -48,7 +48,7 @@ function getInstallVersion() {
   }
 }
 
-const CODEX_PLUGIN_VERSION = "0.1.61";
+const CODEX_PLUGIN_VERSION = "0.1.63-phase981.202607110535";
 const CODEX_PLUGIN_COMPAT_VERSIONS = [
   "0.1.8",
   "0.1.9",
@@ -213,6 +213,7 @@ Options:
 Auth:
   Install is auth-free by default. Sign in happens on the first run of
   /sellable:create-campaign, /sellable:create-evergreen-campaigns,
+  /sellable:find-leads,
   /sellable:foundation, /sellable:content, /sellable:create-post,
   /sellable:refresh-sender-engagement, or /sellable:refill-sends in Claude Code,
   Codex, or Hermes,
@@ -240,11 +241,9 @@ Hermes profile bootstrap:
   workspace id is supplied, so a customer profile fails closed if the workspace
   lock is later removed or not yet provisioned.
 
-Hermes shared Slack dispatcher:
-  Shared listener setup and route-registry validation are internal Sellable
-  Admin responsibilities. This customer-facing installer only bootstraps a
-  profile-local Sellable runtime after Sellable Admin provisions the profile
-  and dispatcher route.
+Hermes customer Slack runtime:
+  Each customer profile uses its own dedicated native Slack app and gateway.
+  Sellable Admin owns the single resumable customer bootstrap interface.
 `;
 }
 
@@ -1124,6 +1123,35 @@ const CREATE_CAMPAIGN_ALLOWED_TOOLS = [
   "mcp__sellable__start_campaign",
 ];
 
+const FIND_LEADS_ALLOWED_TOOLS = [
+  "mcp__sellable__get_auth_status",
+  "mcp__sellable__start_cli_login",
+  "mcp__sellable__wait_for_cli_login",
+  "mcp__sellable__get_active_workspace",
+  "mcp__sellable__list_workspaces",
+  "mcp__sellable__set_active_workspace",
+  "mcp__sellable__get_subskill_prompt",
+  "mcp__sellable__get_subskill_asset",
+  "mcp__sellable__search_subskill_prompts",
+  "mcp__sellable__get_provider_prompt",
+  "mcp__sellable__bootstrap_find_leads",
+  "mcp__sellable__get_find_leads_run",
+  "mcp__sellable__update_find_leads_run",
+  "mcp__sellable__wait_for_find_leads_run",
+  "mcp__sellable__cancel_find_leads",
+  "mcp__sellable__reissue_find_leads_watch_link",
+  "mcp__sellable__preflight_find_leads_provider",
+  "mcp__sellable__lookup_sales_nav_filter",
+  "mcp__sellable__search_sales_nav",
+  "mcp__sellable__search_prospeo",
+  "mcp__sellable__search_signals",
+  "mcp__sellable__select_promising_posts",
+  "mcp__sellable__import_leads",
+  "mcp__sellable__wait_for_lead_list_ready",
+  "mcp__sellable__get_rows_minimal",
+  "mcp__sellable__export_table_csv",
+];
+
 const CREATE_EVERGREEN_CAMPAIGNS_ALLOWED_TOOLS = [
   ...CREATE_CAMPAIGN_ALLOWED_TOOLS,
   "mcp__sellable__setup_evergreen_campaigns",
@@ -1939,6 +1967,17 @@ then retry \`get_subskill_prompt\`.
 `, host, "create-campaign");
 }
 
+function findLeadsSkillMd(host = "shared") {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const templatePath = join(here, "..", "skill-templates", "find-leads.md");
+  if (!existsSync(templatePath)) {
+    throw new Error(
+      "Find Leads skill template is missing or stale. Reinstall @sellable/install and retry."
+    );
+  }
+  return stampInstalledHost(readFileSync(templatePath, "utf8"), host, "find-leads");
+}
+
 function createAbTestSkillMd(host = "shared") {
   try {
     const here = dirname(fileURLToPath(import.meta.url));
@@ -2713,6 +2752,12 @@ will change or after they approve the settings update.
 
 function codexPluginSkills(opts = {}) {
   return [
+    {
+      dir: "sellable-find-leads",
+      displayName: "Sellable Find Leads",
+      description: "Find prospects and build a live exportable lead list",
+      skillMd: findLeadsSkillMd("codex"),
+    },
     {
       dir: "sellable-create-campaign",
       displayName: "Sellable Create Campaign",
@@ -2953,6 +2998,14 @@ then retry \`get_subskill_prompt\`.
 
 function hermesSkillDefinitions(opts = {}) {
   return [
+    {
+      commandName: "find-leads",
+      dir: hermesCommandName("find-leads"),
+      skillMd: normalizeHermesSkillMarkdown(
+        findLeadsSkillMd("hermes"),
+        "find-leads"
+      ),
+    },
     {
       commandName: "create-campaign",
       dir: hermesCommandName("create-campaign"),
@@ -3203,6 +3256,15 @@ ${stripFrontmatter(command.skillMd)}
 
 function claudeCommands(opts = {}) {
   return [
+    {
+      name: "find-leads",
+      title: "Find Leads",
+      filename: join("sellable", "find-leads.md"),
+      description: "Find prospects and build a live exportable Sellable lead list.",
+      argumentHint: "[target audience, provider, or lead-list goal]",
+      skillMd: findLeadsSkillMd("claude"),
+      allowedTools: ["AskUserQuestion", ...FIND_LEADS_ALLOWED_TOOLS],
+    },
     {
       name: "create-campaign",
       title: "Create Campaign",
@@ -5437,7 +5499,8 @@ function printNextSteps(installedHosts, authReused, opts = {}) {
   console.log("");
 
   if (hasClaude) {
-    printAgentBox("Using Claude Code?", "claude", [
+  printAgentBox("Using Claude Code?", "claude", [
+    { label: "Find Leads", command: "/sellable:find-leads" },
       { label: "Campaign", command: "/sellable:create-campaign" },
       { label: "Evergreen", command: "/sellable:create-evergreen-campaigns" },
       { label: "Foundation", command: "/sellable:foundation" },
@@ -5450,7 +5513,8 @@ function printNextSteps(installedHosts, authReused, opts = {}) {
     console.log("");
   }
   if (hasCodex) {
-    printAgentBox("Using Codex?", "codex", [
+  printAgentBox("Using Codex?", "codex", [
+    { label: "Find Leads", command: "$sellable:find-leads" },
       { label: "Campaign", command: "$sellable:create-campaign" },
       { label: "Evergreen", command: "$sellable:create-evergreen-campaigns" },
       { label: "Foundation", command: "$sellable:foundation" },
@@ -5462,7 +5526,8 @@ function printNextSteps(installedHosts, authReused, opts = {}) {
     console.log("");
   }
   if (hasHermes) {
-    printAgentBox("Using Hermes?", "hermes", [
+  printAgentBox("Using Hermes?", "hermes", [
+    { label: "Find Leads", command: "/sellable-find-leads" },
       { label: "Campaign", command: "/sellable-create-campaign" },
       { label: "A/B Test", command: "/sellable-create-ab-test" },
       { label: "Evergreen", command: "/sellable-create-evergreen-campaigns" },
@@ -5832,22 +5897,25 @@ async function main() {
       if (workspaceId) {
         console.log(`  activeWorkspaceId: ${workspaceId}`);
       }
-      console.log(`  Continue in your agent:`);
-      console.log(`    Claude Code: /sellable:create-campaign`);
+       console.log(`  Continue in your agent:`);
+       console.log(`    Claude Code: /sellable:find-leads`);
+       console.log(`    Claude Code: /sellable:create-campaign`);
       console.log(`    Claude Code: /sellable:create-evergreen-campaigns`);
       console.log(`    Claude Code: /sellable:foundation`);
       console.log(`    Claude Code: /sellable:content`);
       console.log(`    Claude Code: /sellable:create-post`);
       console.log(`    Claude Code: /sellable:refresh-sender-engagement`);
       console.log(`    Claude Code: /sellable:refill-sends`);
-      console.log(`    Codex: $sellable:create-campaign`);
+       console.log(`    Codex: $sellable:find-leads`);
+       console.log(`    Codex: $sellable:create-campaign`);
       console.log(`    Codex: $sellable:create-evergreen-campaigns`);
       console.log(`    Codex: $sellable:foundation`);
       console.log(`    Codex: $sellable:content`);
       console.log(`    Codex: $sellable:create-post`);
       console.log(`    Codex: $sellable:refresh-sender-engagement`);
       console.log(`    Codex: $sellable:refill-sends`);
-      console.log(`    Hermes: /sellable-create-campaign`);
+       console.log(`    Hermes: /sellable-find-leads`);
+       console.log(`    Hermes: /sellable-create-campaign`);
       console.log(`    Hermes: /sellable-create-evergreen-campaigns`);
       console.log(`    Hermes: /sellable-foundation`);
       console.log(`    Hermes: /sellable-content`);

package/lib/runtime-verify.mjs

@@ -11,13 +11,25 @@ export const REQUIRED_SELLABLE_MCP_TOOLS = [
   "start_cli_login",
   "wait_for_cli_login",
   "bootstrap_create_campaign",
+  "bootstrap_find_leads",
+  "get_find_leads_run",
+  "update_find_leads_run",
+  "wait_for_find_leads_run",
+  "cancel_find_leads",
+  "reissue_find_leads_watch_link",
+  "preflight_find_leads_provider",
   "get_subskill_prompt",
   "get_subskill_asset",
   "search_subskill_prompts",
   "create_campaign",
   "import_leads",
+  "search_sales_nav",
+  "search_prospeo",
+  "search_signals",
+  "select_promising_posts",
   "confirm_lead_list",
   "wait_for_lead_list_ready",
+  "export_table_csv",
   "wait_for_campaign_table_ready",
   "update_campaign",
   "update_campaign_brief",
@@ -76,6 +88,14 @@ export const CREATE_CAMPAIGN_SMOKE_CALLS = [
       limit: 1200,
     },
   },
+  {
+    name: "get_subskill_prompt",
+    arguments: {
+      subskillName: "find-leads-v2",
+      offset: 0,
+      limit: 1200,
+    },
+  },
   {
     name: "get_subskill_prompt",
     arguments: {
@@ -117,6 +137,15 @@ export const CREATE_CAMPAIGN_SMOKE_CALLS = [
       limit: 1200,
     },
   },
+  {
+    name: "get_subskill_asset",
+    arguments: {
+      subskillName: "find-leads-v2",
+      assetPath: "core/flow.v1.json",
+      offset: 0,
+      limit: 1200,
+    },
+  },
 ];
 
 function collectStderrLines(stream) {
@@ -343,7 +372,7 @@ async function verifyCreateCampaignSmoke({
       ok: false,
       missingTools,
       calls,
-      error: `Missing smoke tool(s): ${missingTools.join(", ")}`,
+      error: `Missing or stale Sellable MCP tool(s): ${missingTools.join(", ")}. Reinstall @sellable/install and @sellable/mcp, restart or reload the host, then retry Find Leads.`,
       startedAt,
       completedAt: new Date().toISOString(),
     };
@@ -662,7 +691,7 @@ async function verifySellableMcpRuntimeOnce({
         ),
         calls: [],
         error:
-          "Skipping create-campaign smoke because required MCP tools are missing.",
+          "Sellable MCP is missing required tools. Reinstall @sellable/install and @sellable/mcp, restart or reload the host, then retry Find Leads.",
         startedAt: new Date().toISOString(),
         completedAt: new Date().toISOString(),
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.331",
+  "version": "0.1.333-phase981.202607110535",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {

package/skill-templates/find-leads.md

@@ -0,0 +1,57 @@
+---
+name: find-leads
+description: Find or source prospects, build and watch a live Sellable lead list, and export the finished list without creating a campaign.
+visibility: public
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__start_cli_login
+  - mcp__sellable__wait_for_cli_login
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__list_workspaces
+  - mcp__sellable__set_active_workspace
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__get_subskill_asset
+  - mcp__sellable__search_subskill_prompts
+  - mcp__sellable__get_provider_prompt
+  - mcp__sellable__bootstrap_find_leads
+  - mcp__sellable__get_find_leads_run
+  - mcp__sellable__update_find_leads_run
+  - mcp__sellable__wait_for_find_leads_run
+  - mcp__sellable__cancel_find_leads
+  - mcp__sellable__reissue_find_leads_watch_link
+  - mcp__sellable__preflight_find_leads_provider
+  - mcp__sellable__lookup_sales_nav_filter
+  - mcp__sellable__search_sales_nav
+  - mcp__sellable__search_prospeo
+  - mcp__sellable__search_signals
+  - mcp__sellable__select_promising_posts
+  - mcp__sellable__import_leads
+  - mcp__sellable__wait_for_lead_list_ready
+  - mcp__sellable__get_rows_minimal
+  - mcp__sellable__export_table_csv
+---
+
+# Sellable Find Leads
+
+Use this public command when the user asks to find or source prospects, build a lead list,
+watch the list fill in real time, review leads, or export the list.
+It works without an existing campaign.
+
+## Load the canonical workflow
+
+1. Call `mcp__sellable__get_auth_status({})` and complete login/workspace setup
+   if required.
+2. Load `mcp__sellable__get_subskill_prompt({ subskillName: "find-leads-v2" })`.
+   Continue chunks until `hasMore` is false.
+3. Load `mcp__sellable__get_subskill_asset({ subskillName: "find-leads-v2",
+   assetPath: "core/flow.v1.json" })`.
+4. Execute that prompt and flow as the operational source of truth.
+
+Do not emulate the workflow from memory or local files. If prompt or asset
+loading fails, use `search_subskill_prompts({ query: "find-leads-v2",
+includePublic: true, includeInternal: true })`, retry once, then give the
+workflow's reinstall/reload guidance.
+
+Keep approval questions in the current chat. A source-plan approval allows only
+the bounded provider search. A later import approval is required before rows
+are materialized. Export uses the source list directly.