@sellable/install 0.1.3 → 0.1.5

package/README.md

@@ -31,6 +31,7 @@ Auth is stored once at:
 Claude Code and Codex are configured to launch the same packaged MCP server.
 
 For Codex Desktop, the installer also writes a local Sellable plugin bundle into
-`~/.sellable/codex-marketplace` and enables it in `~/.codex/config.toml`.
+`~/.sellable/codex-marketplace`, includes the Sellable skill entrypoints, and
+enables it in `~/.codex/config.toml`.
 
 If only one host is installed, `--host all` installs the available host and tells you how to add the other one later.

package/bin/sellable-install.mjs

@@ -9,7 +9,8 @@ import { createInterface } from "node:readline/promises";
 const DEFAULT_API_URL = "https://app.sellable.dev";
 const DEFAULT_SERVER_PACKAGE =
   process.env.SELLABLE_MCP_PACKAGE || "@sellable/mcp";
-const CODEX_PLUGIN_VERSION = "0.1.3";
+const CODEX_PLUGIN_VERSION = "0.1.5";
+const INSTALL_PACKAGE_SPEC = `@sellable/install@${CODEX_PLUGIN_VERSION}`;
 
 function usage() {
   return `Sellable agent installer
@@ -177,7 +178,7 @@ async function promptForMissingAuth(opts) {
       [
         "Missing Sellable token/workspace id.",
         `Create a token at ${opts.apiUrl}/settings, then rerun:`,
-        "  npx -y @sellable/install --host all --token <token> --workspace-id <workspace_id>",
+        `  npx -y ${INSTALL_PACKAGE_SPEC} --host all --token <token> --workspace-id <workspace_id>`,
         "",
         "You can also use SELLABLE_TOKEN and SELLABLE_WORKSPACE_ID.",
       ].join("\n")
@@ -331,6 +332,227 @@ function codexPluginMcp(opts) {
   };
 }
 
+const CREATE_CAMPAIGN_ALLOWED_TOOLS = [
+  "mcp__sellable__get_auth_status",
+  "mcp__sellable__bootstrap_create_campaign",
+  "mcp__sellable__get_subskill_prompt",
+  "mcp__sellable__search_subskill_prompts",
+  "mcp__sellable__get_provider_prompt",
+  "mcp__sellable__get_message_prompt",
+  "mcp__sellable__get_active_workspace",
+  "mcp__sellable__list_senders",
+  "mcp__sellable__get_sender",
+  "mcp__sellable__enrich_sender",
+  "mcp__sellable__complete_sender_research",
+  "mcp__sellable__fetch_linkedin_profile",
+  "mcp__sellable__fetch_linkedin_posts",
+  "mcp__sellable__get_linkedin_profile",
+  "mcp__sellable__fetch_company",
+  "mcp__sellable__fetch_company_posts",
+  "mcp__sellable__lookup_sales_nav_filter",
+  "mcp__sellable__search_sales_nav",
+  "mcp__sellable__search_prospeo",
+  "mcp__sellable__search_signals",
+  "mcp__sellable__fetch_post_engagers",
+  "mcp__sellable__enrich_with_prospeo",
+  "mcp__sellable__bulk_enrich_with_prospeo",
+  "mcp__sellable__save_domain_filters",
+  "mcp__sellable__add_rubric_item",
+  "mcp__sellable__upsert_rubric",
+  "mcp__sellable__set_headline_icp_criteria",
+  "mcp__sellable__check_rubric",
+  "mcp__sellable__create_campaign",
+  "mcp__sellable__save_rubrics",
+  "mcp__sellable__wait_for_rubric_results",
+  "mcp__sellable__update_campaign_brief",
+  "mcp__sellable__update_campaign",
+  "mcp__sellable__get_campaign",
+  "mcp__sellable__get_campaign_context",
+  "mcp__sellable__get_campaign_framework",
+  "mcp__sellable__get_campaign_navigation_state",
+  "mcp__sellable__confirm_lead_list",
+  "mcp__sellable__import_leads",
+  "mcp__sellable__wait_for_lead_list_ready",
+  "mcp__sellable__wait_for_campaign_table_ready",
+  "mcp__sellable__get_rows",
+  "mcp__sellable__get_rows_minimal",
+  "mcp__sellable__get_table_rows",
+  "mcp__sellable__load_csv_linkedin_leads",
+  "mcp__sellable__load_csv_domains",
+  "mcp__sellable__queue_cells",
+  "mcp__sellable__generate_messages",
+  "mcp__sellable__get_campaign_messages_preview",
+  "mcp__sellable__attach_sequence",
+  "mcp__sellable__attach_recommended_sequence",
+  "mcp__sellable__start_campaign",
+];
+
+function allowedToolsYaml(tools) {
+  return tools.map((tool) => `  - ${tool}`).join("\n");
+}
+
+function codexSkillOpenAiYaml(displayName, description) {
+  return `interface:
+  display_name: "${displayName.replaceAll('"', '\\"')}"
+  short_description: "${description.replaceAll('"', '\\"')}"
+`;
+}
+
+function createCampaignSkillMd() {
+  return `---
+name: sellable:create-campaign
+description: Create a Sellable campaign through the approval-gated workflow.
+allowed-tools:
+${allowedToolsYaml(CREATE_CAMPAIGN_ALLOWED_TOOLS)}
+---
+
+# Sellable Create Campaign
+
+Use this as the customer-facing entrypoint for Sellable campaign creation.
+
+## Bootstrap
+
+MCP tool access is required. First call \`mcp__sellable__get_auth_status({})\`
+directly. If that tool is unavailable, stop and say this is a Codex
+install/reload problem, not a campaign problem. Tell the user to
+run \`npx -y ${INSTALL_PACKAGE_SPEC} --host all\` so the packaged MCP server,
+Codex Desktop plugin, and Sellable skill bundle are installed. If they want a
+CLI verification, tell them to run \`sellable --verify-only --host all\`. After
+that, they must fully quit and reopen Codex Desktop before starting a new
+thread. Do not use \`scripts/mcp/sellable-tool-call.mjs\`, \`npm run\`,
+\`node\`, or any local harness as a fallback for this interactive skill.
+
+1. Call \`mcp__sellable__get_auth_status({})\`.
+2. If auth is not OK, stop and show the returned guidance.
+3. Detect optional campaign id in the user request (\`cmp_...\`).
+4. If no campaign id is provided, stay in fresh-create mode and do not call campaign discovery/resume helpers to find one.
+   - Do not call \`mcp__sellable__get_campaigns\`.
+   - Do not call \`mcp__sellable__get_campaign\` to hunt for IDs.
+   - Do not call \`mcp__sellable__create_campaign({ campaignId: ... })\` unless the user supplied that id.
+5. Call \`mcp__sellable__bootstrap_create_campaign({ flowVersion: "v2", campaignId? })\`.
+6. If \`safeToProceed !== true\`, stop and show \`blockingErrors\` + \`nextStep\`.
+
+## Execute Workflow
+
+1. Load canonical prompt via
+   \`mcp__sellable__get_subskill_prompt({ subskillName: "create-campaign-v2" })\`.
+2. Follow that prompt exactly.
+3. For message generation, load the full \`generate-messages\` prompt in the
+   same run with chunked
+   \`mcp__sellable__get_subskill_prompt({ subskillName: "generate-messages", offset, limit })\`
+   calls until \`hasMore\` is false. Do not synthesize
+   \`message-validation.md\` from the brief, lead review, or general knowledge.
+4. Treat message quality as the gate before minting. Do not create a campaign,
+   show a commit gate, or mint anything until \`message-validation.md\` proves
+   the full generate-messages workflow ran and \`message-review.md\` recommends
+   \`approve-message\` against the gold-standard rules.
+5. Do not create or mutate the live campaign until the approval gate returns
+   \`approve\`.
+6. Do not ask the user to run another command.
+
+## Fallback
+
+If subskill lookup fails, use
+\`mcp__sellable__search_subskill_prompts({ query: "create-campaign-v2" })\`,
+then retry \`get_subskill_prompt\`.
+`;
+}
+
+function genericSellableSkillMd({ name, title, description }) {
+  return `---
+name: sellable:${name}
+description: ${description}
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_subskill_prompt
+  - mcp__sellable__search_subskill_prompts
+---
+
+# ${title}
+
+Use this as the customer-facing entrypoint for the Sellable \`${name}\` workflow.
+
+## Bootstrap
+
+MCP tool access is required. First call \`mcp__sellable__get_auth_status({})\`
+directly. Do not inspect repo files, run shell commands, use \`npm\`, \`node\`,
+local harness scripts, or read local prompt files to emulate this workflow.
+
+If the Sellable MCP tool is unavailable, stop and say this is a Codex
+install/reload problem. Tell the user to run
+\`npx -y ${INSTALL_PACKAGE_SPEC} --host all\`, fully quit and reopen Codex
+Desktop, then start a new thread.
+
+1. Call \`mcp__sellable__get_auth_status({})\`.
+2. If auth is not OK, stop and show the returned guidance.
+
+## Execute Workflow
+
+1. Load canonical prompt via \`mcp__sellable__get_subskill_prompt({ subskillName: "${name}" })\`.
+2. Follow that prompt exactly.
+
+## MCP Prompt Fallback
+
+If subskill lookup fails, use \`mcp__sellable__search_subskill_prompts({ query: "${name}" })\`, then retry \`get_subskill_prompt\`.
+`;
+}
+
+function codexPluginSkills() {
+  return [
+    {
+      dir: "sellable-create-campaign",
+      displayName: "Sellable Create Campaign",
+      description: "Create a Sellable campaign with approval gates",
+      skillMd: createCampaignSkillMd(),
+    },
+    {
+      dir: "sellable-engage",
+      displayName: "Sellable Engage",
+      description: "Discover posts and draft comments for a comment campaign",
+      skillMd: genericSellableSkillMd({
+        name: "engage",
+        title: "Sellable Engage",
+        description:
+          "Find high-signal LinkedIn posts and draft thoughtful engagement comments, then load approved comments into the sender's comment campaign.",
+      }),
+    },
+    {
+      dir: "sellable-interview",
+      displayName: "Sellable Interview",
+      description: "Build a commenting style guide and ICP profile",
+      skillMd: genericSellableSkillMd({
+        name: "interview",
+        title: "Sellable Interview",
+        description:
+          "Voice-first interview to build your commenting style guide and ICP profile.",
+      }),
+    },
+    {
+      dir: "sellable-workflow-sequences",
+      displayName: "Sellable Workflow Sequences",
+      description: "Create workflow tables and attach outbound sequences",
+      skillMd: genericSellableSkillMd({
+        name: "workflow-sequences",
+        title: "Sellable Workflow Sequences",
+        description:
+          "Create workflow tables via Sellable MCP, attach outbound sequence templates, and avoid manual sequence-column runCondition mistakes.",
+      }),
+    },
+  ];
+}
+
+function writeCodexPluginSkills(pluginRoot, opts) {
+  for (const skill of codexPluginSkills()) {
+    const skillRoot = join(pluginRoot, "skills", skill.dir);
+    writeFile(join(skillRoot, "SKILL.md"), skill.skillMd, opts);
+    writeFile(
+      join(skillRoot, "agents", "openai.yaml"),
+      codexSkillOpenAiYaml(skill.displayName, skill.description),
+      opts
+    );
+  }
+}
+
 function installCodexDesktopPlugin(opts) {
   const home = codexHome();
   const configPath = join(home, "config.toml");
@@ -371,6 +593,7 @@ function installCodexDesktopPlugin(opts) {
     opts
   );
   writeFile(join(pluginRoot, ".mcp.json"), `${JSON.stringify(mcp, null, 2)}\n`, opts);
+  writeCodexPluginSkills(pluginRoot, opts);
 
   if (!opts.dryRun) {
     rmSync(cacheRoot, { recursive: true, force: true });
@@ -381,6 +604,7 @@ function installCodexDesktopPlugin(opts) {
     opts
   );
   writeFile(join(pluginCache, ".mcp.json"), `${JSON.stringify(mcp, null, 2)}\n`, opts);
+  writeCodexPluginSkills(pluginCache, opts);
 
   if (!opts.dryRun) {
     mkdirSync(home, { recursive: true, mode: 0o700 });
@@ -527,7 +751,19 @@ function verify(opts) {
       ".codex-plugin",
       "plugin.json"
     );
+    const skillPath = join(
+      codexHome(),
+      "plugins",
+      "cache",
+      "sellable",
+      "sellable",
+      CODEX_PLUGIN_VERSION,
+      "skills",
+      "sellable-create-campaign",
+      "SKILL.md"
+    );
     console.log(existsSync(pluginPath) ? "Codex Desktop plugin present" : "Codex Desktop plugin missing");
+    console.log(existsSync(skillPath) ? "Codex skill bundle present" : "Codex skill bundle missing");
   }
 }
 

package/package.json

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