@sellable/mcp 0.1.531 → 0.1.532

package/dist/auth.d.ts

@@ -38,6 +38,7 @@ export type SkillState = {
  * - "sellable-dev.json" - local development
  */
 export declare function setConfigFile(fileName: string): void;
+export declare function getResolvedConfigsDir(): string | null;
 export declare function getConfigPath(): string;
 export declare function getConfig(): SellableConfig;
 export declare function updateActiveWorkspace(params: {

package/dist/auth.js

@@ -19,9 +19,9 @@ export function setConfigFile(fileName) {
 }
 function getConfigPathCandidates() {
     const candidates = [];
-    const explicitConfigPath = process.env.SELLABLE_CONFIG_PATH?.trim();
+    const explicitConfigPath = getExplicitConfigPath();
     if (explicitConfigPath) {
-        candidates.push(path.resolve(explicitConfigPath));
+        candidates.push(explicitConfigPath);
     }
     if (configFileName === "sellable.json") {
         candidates.push(path.join(os.homedir(), ".sellable", "config.json"));
@@ -34,12 +34,31 @@ function getConfigPathCandidates() {
     candidates.push(path.join(os.homedir(), ".claude", configFileName));
     return Array.from(new Set(candidates));
 }
+function getExplicitConfigPath() {
+    const explicitConfigPath = process.env.SELLABLE_CONFIG_PATH?.trim();
+    return explicitConfigPath ? path.resolve(explicitConfigPath) : null;
+}
+export function getResolvedConfigsDir() {
+    const explicitConfigsDir = process.env.SELLABLE_CONFIGS_DIR?.trim();
+    if (explicitConfigsDir) {
+        return path.resolve(explicitConfigsDir);
+    }
+    const explicitConfigPath = getExplicitConfigPath();
+    if (explicitConfigPath) {
+        return path.join(path.dirname(explicitConfigPath), "configs");
+    }
+    return null;
+}
 function renderConfigPathOrder(candidates) {
     return candidates
         .map((candidate, idx) => `${idx + 1}. ${candidate}`)
         .join("\n");
 }
 export function getConfigPath() {
+    const explicitConfigPath = getExplicitConfigPath();
+    if (explicitConfigPath) {
+        return explicitConfigPath;
+    }
     const candidates = getConfigPathCandidates();
     for (const candidate of candidates) {
         if (fs.existsSync(candidate)) {
@@ -49,9 +68,9 @@ export function getConfigPath() {
     return candidates[0];
 }
 function getConfigWritePath() {
-    const explicitConfigPath = process.env.SELLABLE_CONFIG_PATH?.trim();
+    const explicitConfigPath = getExplicitConfigPath();
     if (explicitConfigPath) {
-        return path.resolve(explicitConfigPath);
+        return explicitConfigPath;
     }
     if (configFileName === "sellable.json") {
         return path.join(os.homedir(), ".sellable", "config.json");

package/dist/tools/auth.d.ts

@@ -2,10 +2,13 @@ import { type SellableUpdateStatus } from "../update-check.js";
 export type AuthStatus = {
     ok: boolean;
     configPath: string;
+    configExists: boolean;
+    configsDir: string | null;
     activeEnvName: string | null;
     apiUrl: string | null;
     activeWorkspaceId: string | null;
     activeWorkspaceName: string | null;
+    tokenPresent: boolean;
     tokenPrefix: string | null;
     workspacesCount: number | null;
     checkedAt: string;

package/dist/tools/auth.js

@@ -1,5 +1,6 @@
+import * as fs from "fs";
 import { getApi, SellableApiError } from "../api.js";
-import { getConfig, getConfigPath } from "../auth.js";
+import { getConfig, getConfigPath, getResolvedConfigsDir } from "../auth.js";
 import { checkForUpdates } from "../update-check.js";
 function maskToken(token) {
     if (token.length <= 10)
@@ -33,15 +34,20 @@ export const authToolDefinitions = [
 ];
 export async function getAuthStatus() {
     const configPath = getConfigPath();
+    const configsDir = getResolvedConfigsDir();
     const checkedAt = new Date().toISOString();
     const update = await getUpdateStatus();
+    let tokenPresent = false;
     const base = {
         ok: false,
         configPath,
+        configExists: fs.existsSync(configPath),
+        configsDir,
         activeEnvName: null,
         apiUrl: null,
         activeWorkspaceId: null,
         activeWorkspaceName: null,
+        tokenPresent: false,
         tokenPrefix: null,
         workspacesCount: null,
         _userNotice: appendUpdateNotice(null, update),
@@ -50,6 +56,7 @@ export async function getAuthStatus() {
     };
     try {
         const config = getConfig();
+        tokenPresent = Boolean(config.token);
         base.activeEnvName = config.activeEnvName || null;
         const api = getApi();
         const { workspaces } = await api.get("/api/v3/workspaces");
@@ -61,6 +68,7 @@ export async function getAuthStatus() {
             return {
                 ...base,
                 apiUrl: config.apiUrl || null,
+                tokenPresent,
                 tokenPrefix: maskToken(config.token),
                 workspacesCount: workspaces.length,
                 error: {
@@ -77,6 +85,7 @@ export async function getAuthStatus() {
             return {
                 ...base,
                 apiUrl: config.apiUrl || null,
+                tokenPresent,
                 tokenPrefix: maskToken(config.token),
                 workspacesCount: workspaces.length,
                 error: {
@@ -97,10 +106,13 @@ export async function getAuthStatus() {
         return {
             ok: true,
             configPath,
+            configExists: fs.existsSync(configPath),
+            configsDir,
             activeEnvName: envLabel,
             apiUrl: config.apiUrl || null,
             activeWorkspaceId,
             activeWorkspaceName: workspaceName,
+            tokenPresent,
             tokenPrefix: maskToken(config.token),
             workspacesCount: workspaces.length,
             _userNotice: appendUpdateNotice(notice, update),
@@ -124,7 +136,7 @@ export async function getAuthStatus() {
             "  3. Click it, come back here, and we'll keep going\\n\\n" +
             "What email should I use?` " +
             "2) Wait for the user to type their email in normal chat (do NOT use AskUserQuestion / request_user_input). " +
-            "3) Call `mcp__sellable__start_cli_login({ email })` with that email. " +
+            "3) Call `mcp__sellable__start_cli_login({ email })` with that email in Claude Code/Codex, or `mcp_sellable_start_cli_login({ email })` in Hermes. " +
             "4) On `ok: true`, say verbatim (substituting the email exactly as typed):\\n" +
             "`Magic link sent to {email}.\\n\\n" +
             "─────────────────────────────────────────────\\n" +
@@ -135,14 +147,15 @@ export async function getAuthStatus() {
             "  3. Come back here when you're done\\n\\n" +
             "I'll be waiting right here.\\n\\n" +
             "  (If your team already uses Sellable, ask an admin to invite you into their shared workspace instead — that gets you straight in.)` " +
-            "5) Call `mcp__sellable__wait_for_cli_login({ sessionId })` using the sessionId returned by start_cli_login. " +
-            "6) If the result is `error.type === 'tool_timeout_guard'`, IMMEDIATELY re-call wait_for_cli_login with the SAME sessionId — do not narrate, do not call start_cli_login again. Loop until you get a different result. " +
-            "7) On `ok: true`, the user is signed in and `~/.sellable/config.json` has been written. Branch on `isReturningUser` and use `activeWorkspaceName` when present, otherwise `activeWorkspaceId`, as `{workspaceLabel}`: " +
+            "5) Call `mcp__sellable__wait_for_cli_login({ sessionId })` in Claude Code/Codex, or `mcp_sellable_wait_for_cli_login({ sessionId })` in Hermes, using the sessionId returned by start_cli_login. " +
+            "6) If the result is `error.type === 'tool_timeout_guard'`, IMMEDIATELY re-call wait_for_cli_login with the SAME sessionId — do not narrate, do not call start_cli_login again. In Hermes, re-call `mcp_sellable_wait_for_cli_login({ sessionId })`. Loop until you get a different result. " +
+            `7) On \`ok: true\`, the user is signed in and the resolved Sellable config file has been written at ${configPath}. Branch on \`isReturningUser\` and use \`activeWorkspaceName\` when present, otherwise \`activeWorkspaceId\`, as \`{workspaceLabel}\`: ` +
             "if true, say `You're in {workspaceLabel}.\\n\\nExcited to help you launch your LinkedIn outbound campaign. We're at setup: first I'll use your LinkedIn profile to understand the company, then I'll draft the campaign brief, help choose where to find buyers, review messages, and wait for final launch approval.\\n\\nWhat's your LinkedIn profile URL or handle?`; " +
             "if false, say `You're set up in {workspaceLabel}.\\n\\nExcited to help you launch your LinkedIn outbound campaign. We're at setup: first I'll use your LinkedIn profile to understand the company, then I'll draft the campaign brief, help choose where to find buyers, review messages, and wait for final launch approval.\\n\\nWhat's your LinkedIn profile URL or handle?`";
         if (error instanceof SellableApiError && error.isAuthError) {
             return {
                 ...base,
+                tokenPresent,
                 error: {
                     type: "auth",
                     status: error.status,
@@ -162,6 +175,7 @@ export async function getAuthStatus() {
             : `Fix the configuration in ${configPath}, then retry get_auth_status.`;
         return {
             ...base,
+            tokenPresent,
             error: {
                 type: isConfigError ? "config" : "api",
                 message,

package/dist/tools/bootstrap.js

@@ -307,7 +307,7 @@ export async function bootstrapCreateCampaign(input = {}) {
         ? resumeDetected
             ? `Bootstrap complete.${workspaceNotice}${modelNotice} Resume from campaign state and navigation diagnostics first; treat local draft artifacts as debug-only evidence. Then load ${createCampaignSubskill?.name ?? "create-campaign"} instructions with get_subskill_prompt({ subskillName: "${createCampaignSubskill?.name ?? "create-campaign"}" }); if the response has hasMore=true, continue with nextOffset until hasMore=false.`
             : flowVersion === "v2"
-                ? `Bootstrap complete.${workspaceNotice}${modelNotice} Load the compact create-campaign-v2 entry prompt once with get_subskill_prompt({ subskillName: "create-campaign-v2" }); load flow/reference assets lazily only when that stage needs them. Preserve the pre-intake sequence: confirm auth/workspace status, ask only for the LinkedIn profile URL or handle, normalize handles to a full profile URL, require that profile identity before continuing, run lightweight profile/company lookup, then ask the target, offer, credibility, and prospect-source setup questions. Do not call list_senders or sender discovery during setup; sender availability belongs only to Settings after message approval. Then write the campaign brief, call create_campaign once to mint the watchable shell, surface the returned watch link once before brief approval, and hand off to lead finding without repeating the link.`
+                ? `Bootstrap complete.${workspaceNotice}${modelNotice} Load the compact create-campaign-v2 entry prompt once with get_subskill_prompt({ subskillName: "create-campaign-v2" }); Hermes users should start this flow with /sellable-create-campaign. Load flow/reference assets lazily only when that stage needs them. Preserve the pre-intake sequence: confirm auth/workspace status, ask only for the LinkedIn profile URL or handle, normalize handles to a full profile URL, require that profile identity before continuing, run lightweight profile/company lookup, then ask the target, offer, credibility, and prospect-source setup questions. Do not call list_senders or sender discovery during setup; sender availability belongs only to Settings after message approval. Then write the campaign brief, call create_campaign once to mint the watchable shell, surface the returned watch link once before brief approval, and hand off to lead finding without repeating the link.`
                 : `Bootstrap complete.${workspaceNotice}${modelNotice} Load ${createCampaignSubskill?.name ?? "create-campaign"} instructions with get_subskill_prompt({ subskillName: "${createCampaignSubskill?.name ?? "create-campaign"}" }); if the response has hasMore=true, continue with nextOffset until hasMore=false. Follow that flow before calling create_campaign.`
         : "Bootstrap incomplete. Resolve blockingErrors and rerun bootstrap_create_campaign before provider/search/import tools.";
     // Strip prompt body from createCampaignSubskill — it's loaded via the host

package/dist/tools/campaigns.d.ts

@@ -9,9 +9,9 @@ declare const LEAD_SOURCE_PROVIDERS: {
 };
 type LeadSourceProvider = (typeof LEAD_SOURCE_PROVIDERS)[keyof typeof LEAD_SOURCE_PROVIDERS];
 export declare function buildWatchUrl(config: Pick<ReturnType<typeof getConfig>, "apiUrl" | "token" | "activeWorkspaceId" | "workspaceId">, path: string): string;
-export type CampaignBuilderWatchMode = "claude" | "codex";
+export type CampaignBuilderWatchMode = "claude" | "codex" | "hermes";
 export declare function getCampaignBuilderWatchModeParam(): CampaignBuilderWatchMode;
-export declare function getCampaignBuilderWatchModeDriverLabel(mode?: CampaignBuilderWatchMode): "Claude Code" | "Codex";
+export declare function getCampaignBuilderWatchModeDriverLabel(mode?: CampaignBuilderWatchMode): "Claude Code" | "Codex" | "Hermes";
 export declare function buildCampaignWatchHandoffMarkdown(watchUrl: string, mode?: CampaignBuilderWatchMode): string;
 export interface Campaign {
     id: string;

package/dist/tools/campaigns.js

@@ -124,23 +124,35 @@ export function buildWatchUrl(config, path) {
     }
     return url.toString();
 }
+const CAMPAIGN_BUILDER_AGENT_WATCH_MODES = new Set([
+    "claude",
+    "codex",
+    "hermes",
+]);
 export function getCampaignBuilderWatchModeParam() {
     const explicit = process.env.SELLABLE_WATCH_MODE_DRIVER?.trim().toLowerCase();
-    if (explicit === "claude" || explicit === "codex")
+    if (CAMPAIGN_BUILDER_AGENT_WATCH_MODES.has(explicit)) {
         return explicit;
+    }
     return process.env.CODEX_HOME ? "codex" : "claude";
 }
 function getCampaignBuilderWatchModeFromUrl(watchUrl) {
     try {
         const mode = new URL(watchUrl).searchParams.get("mode");
-        return mode === "claude" || mode === "codex" ? mode : null;
+        return CAMPAIGN_BUILDER_AGENT_WATCH_MODES.has(mode)
+            ? mode
+            : null;
     }
     catch {
         return null;
     }
 }
 export function getCampaignBuilderWatchModeDriverLabel(mode = getCampaignBuilderWatchModeParam()) {
-    return mode === "codex" ? "Codex" : "Claude Code";
+    if (mode === "codex")
+        return "Codex";
+    if (mode === "hermes")
+        return "Hermes";
+    return "Claude Code";
 }
 export function buildCampaignWatchHandoffMarkdown(watchUrl, mode = getCampaignBuilderWatchModeFromUrl(watchUrl) ?? getCampaignBuilderWatchModeParam()) {
     const driverLabel = getCampaignBuilderWatchModeDriverLabel(mode);
@@ -161,7 +173,7 @@ function isValidBriefHandoffWatchUrl(watchUrl, campaignId) {
         const url = new URL(watchUrl);
         const mode = url.searchParams.get("mode");
         return (url.pathname === `/campaign-builder/${campaignId}` &&
-            (mode === "claude" || mode === "codex") &&
+            CAMPAIGN_BUILDER_AGENT_WATCH_MODES.has(mode) &&
             Boolean(url.searchParams.get("workspaceId")) &&
             Boolean(url.searchParams.get("token")));
     }
@@ -173,7 +185,7 @@ function assertBriefHandoffWatchUrl(watchUrl, campaignId) {
     if (isValidBriefHandoffWatchUrl(watchUrl, campaignId))
         return;
     throw new Error("create_campaign produced an invalid watchUrl for the brief approval handoff. " +
-        "Recover a fresh direct /campaign-builder/{campaignId}?mode={claude|codex}&workspaceId=...&token=... URL " +
+        "Recover a fresh direct /campaign-builder/{campaignId}?mode={claude|codex|hermes}&workspaceId=...&token=... URL " +
         "with create_campaign({ campaignId }) or get_campaign before asking for approval.");
 }
 export const campaignToolDefinitions = [

package/dist/tools/model-quality.d.ts

@@ -1,4 +1,4 @@
-export type CampaignModelHost = "claude" | "codex" | "unknown";
+export type CampaignModelHost = "claude" | "codex" | "hermes" | "unknown";
 export type CampaignModelQualityInput = {
     host?: string | null;
     model?: string | null;
@@ -33,6 +33,7 @@ export type CampaignModelQualityConfig = {
     hosts: {
         claude: CampaignModelQualityHostConfig;
         codex: CampaignModelQualityHostConfig;
+        hermes: CampaignModelQualityHostConfig;
     };
     warningCopy: {
         ok: string;

package/dist/tools/model-quality.js

@@ -30,6 +30,20 @@ const DEFAULT_MODEL_QUALITY_CONFIG = {
             ],
             recommendedReasoningEffort: "xhigh",
         },
+        hermes: {
+            label: "Hermes",
+            minimumModel: "GPT 5.5",
+            familyKeywords: ["gpt"],
+            minimumVersion: "5.5",
+            minimumReasoningEffort: "xhigh",
+            acceptedReasoningEfforts: [
+                "extra high",
+                "extra-high",
+                "xhigh",
+                "extra_high",
+            ],
+            recommendedReasoningEffort: "xhigh",
+        },
     },
     warningCopy: {
         ok: "Active host model metadata meets the configured campaign floor: {currentSettings}.",
@@ -41,6 +55,8 @@ const TRUSTED_METADATA_SOURCE_KEYWORDS = [
     "codex_turn_metadata",
     "claude_runtime_metadata",
     "claude_session_context",
+    "hermes_runtime_metadata",
+    "hermes_session_context",
     "active_turn_metadata",
     "user_confirmed",
 ];
@@ -49,6 +65,9 @@ const normalize = (value) => String(value ?? "")
     .toLowerCase();
 const normalizeHost = (host) => {
     const normalized = normalize(host);
+    if (normalized.includes("hermes")) {
+        return "hermes";
+    }
     if (normalized.includes("claude") ||
         normalized.includes("opus") ||
         normalized.includes("sonnet") ||
@@ -114,6 +133,7 @@ function findHostConfig(host, model, config) {
         ? [
             ["claude", config.hosts.claude],
             ["codex", config.hosts.codex],
+            ["hermes", config.hosts.hermes],
         ]
         : [[host, config.hosts[host]]];
     return candidates.find(([, hostConfig]) => modelMeetsMinimum(model, hostConfig, {
@@ -130,7 +150,7 @@ export function evaluateCampaignModelQuality(input = {}) {
     const model = input.model?.trim() || null;
     const reasoningEffort = input.reasoningEffort?.trim() || null;
     const metadataSource = input.metadataSource?.trim() || null;
-    const recommendationHost = host === "claude" ? "claude" : "codex";
+    const recommendationHost = host === "claude" || host === "hermes" ? host : "codex";
     const recommendedHostConfig = config.hosts[recommendationHost];
     const minimumSummary = getCampaignModelMinimumSummary(config);
     const currentSettings = [

package/dist/tools/refill-sends-evergreen.d.ts

@@ -0,0 +1,28 @@
+type RefillSendsEvergreenInput = {
+    workspaceId?: string;
+};
+export declare const refillSendsEvergreenToolDefinitions: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+}[];
+export declare function refillSendsEvergreenCommand(input: RefillSendsEvergreenInput): {
+    readOnly: boolean;
+    workspaceId: string | null;
+    firstOperationalSteps: string[];
+    approvalContract: string;
+    forbiddenActions: string[];
+    fillWindow: string;
+    hostExamples: string[];
+};
+export {};

package/dist/tools/refill-sends-evergreen.js

@@ -0,0 +1,47 @@
+export const refillSendsEvergreenToolDefinitions = [
+    {
+        name: "refill_sends_evergreen",
+        description: "Read-only Phase 85 evergreen refill command contract. It performs no mutations and only tells the operator to call get_evergreen_refill_plan for a dry-run packet and journal.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workspaceId: {
+                    type: "string",
+                    description: "Explicit request-scoped workspace id.",
+                },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
+];
+export function refillSendsEvergreenCommand(input) {
+    return {
+        readOnly: true,
+        workspaceId: input.workspaceId ?? null,
+        firstOperationalSteps: [
+            "Call get_evergreen_refill_plan with the explicit workspaceId.",
+            "Read the returned packet, globalActionQueue, per-sender plans, and itinerary before taking any action.",
+            "Review the dry-run journal file path returned by get_evergreen_refill_plan.",
+            "Phase 85 is PLAN-ONLY; execution arrives in Phase 86.",
+        ],
+        approvalContract: "Nothing is approved or executable in Phase 85. The evergreen command is read-only; Phase 86 introduces execution approval.",
+        forbiddenActions: [
+            "Do not schedule sends.",
+            "Do not send messages.",
+            "Do not approve messages.",
+            "Do not prepare messages.",
+            "Do not start or launch campaigns.",
+            "Do not create campaigns.",
+            "Do not switch providers or source families.",
+            "Do not lower paid InMail thresholds.",
+            "Do not refresh paid InMail credits.",
+            "Do not write scheduler fields.",
+        ],
+        fillWindow: "Use only the target window and caps returned by get_evergreen_refill_plan.",
+        hostExamples: [
+            "refill_sends_evergreen({ workspaceId })",
+            "get_evergreen_refill_plan({ workspaceId })",
+        ],
+    };
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.531",
+  "version": "0.1.532",
   "type": "module",
-  "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
+  "description": "Sellable MCP server for Claude Code, Codex, and Hermes campaign workflows",
   "main": "dist/index.js",
   "bin": {
     "mcp": "dist/index.js",
@@ -20,6 +20,7 @@
     "mcp",
     "claude-code",
     "codex",
+    "hermes",
     "sellable",
     "linkedin",
     "outreach"

package/skills/research/config.json

@@ -0,0 +1,9 @@
+{
+  "parallelMode": "wide",
+  "agentCount": 6,
+  "maxToolCallsPerAgent": 2,
+  "senderMaxAgents": 2,
+  "senderMaxToolCallsPerAgent": 3,
+  "progressMode": true,
+  "debugMode": true
+}