@sellable/mcp 0.1.446 → 0.1.448

package/README.md

@@ -16,7 +16,7 @@ Each message gets 5+ minutes of Claude attention with deep research - no other t
 
 ### Prompt Source Of Truth
 
-There are seven public Sellable entrypoints shared across hosts:
+There are eight public Sellable entrypoints shared across hosts:
 
 - `sellable:create-campaign`
 - `sellable:create-ab-test`
@@ -24,6 +24,7 @@ There are seven public Sellable entrypoints shared across hosts:
 - `sellable:foundation`
 - `sellable:content`
 - `sellable:create-post`
+- `sellable:refresh-sender-engagement`
 - `sellable:refill-sends`
 
 The create-campaign public wrapper at
@@ -64,6 +65,13 @@ reader value, validates proof/AI tells, and saves content artifacts under
 
 - `mcp/sellable/skills/create-post/SKILL.md`
 
+The refresh-sender-engagement public command wrapper finds active sender-owned
+Post Engagers / Signal Discovery campaigns, refreshes recent sender-authored
+posts, pulls latest engagers, filters to ICP, and adds net-new leads without
+sending from:
+
+- `mcp/sellable/skills/refresh-sender-engagement/SKILL.md`
+
 The refill-sends public command wrapper plans and executes approval-gated send
 refills. It supports `--yolo` and optional sender selectors such as
 `--sender "Christian Reyes"`, optional through-date selectors such as
@@ -195,10 +203,12 @@ The installer does the full local setup:
 After the installer passes, fully quit and reopen Codex Desktop. Start a new
 thread and select `Sellable Create Campaign`, `Sellable Create A/B Test`,
 `Sellable Create Evergreen Campaigns`, `Sellable Foundation`,
-`Sellable Content`, `Sellable Create Post`, or `Sellable Refill Sends`; or invoke
+`Sellable Content`, `Sellable Create Post`, `Sellable Refresh Sender Engagement`,
+or `Sellable Refill Sends`; or invoke
 `$sellable:create-campaign`, `$sellable:create-ab-test`,
 `$sellable:create-evergreen-campaigns`, `$sellable:foundation`,
-`$sellable:content`, `$sellable:create-post`, or `$sellable:refill-sends`. If the app still says
+`$sellable:content`, `$sellable:create-post`,
+`$sellable:refresh-sender-engagement`, or `$sellable:refill-sends`. If the app still says
 `mcp__sellable__*` tools are missing after the installer passes, check that
 `~/.codex/config.toml` contains both `[marketplaces.sellable]` and
 `[plugins."sellable@sellable"]`.
@@ -215,6 +225,7 @@ Use these names consistently:
 - Claude Code command: `/sellable:foundation`
 - Claude Code command: `/sellable:content`
 - Claude Code command: `/sellable:create-post`
+- Claude Code command: `/sellable:refresh-sender-engagement`
 - Claude Code command: `/sellable:refill-sends`
 - Codex command: `$sellable:create-campaign`
 - Codex command: `$sellable:create-ab-test`
@@ -222,6 +233,7 @@ Use these names consistently:
 - Codex command: `$sellable:foundation`
 - Codex command: `$sellable:content`
 - Codex command: `$sellable:create-post`
+- Codex command: `$sellable:refresh-sender-engagement`
 - Codex command: `$sellable:refill-sends`
 - Codex Desktop plugin: `sellable@sellable`
 - Codex visible skill: `Sellable Create Campaign`
@@ -230,6 +242,7 @@ Use these names consistently:
 - Codex visible skill: `Sellable Foundation`
 - Codex visible skill: `Sellable Content`
 - Codex visible skill: `Sellable Create Post`
+- Codex visible skill: `Sellable Refresh Sender Engagement`
 - Codex visible skill: `Sellable Refill Sends`
 - Codex skill frontmatter name: `create-campaign`
 - Codex skill frontmatter name: `create-ab-test`
@@ -237,6 +250,7 @@ Use these names consistently:
 - Codex skill frontmatter name: `foundation`
 - Codex skill frontmatter name: `content`
 - Codex skill frontmatter name: `create-post`
+- Codex skill frontmatter name: `refresh-sender-engagement`
 - Codex skill frontmatter name: `refill-sends`
 - MCP server name: `sellable`
 - Internal workflow prompt: `create-campaign-v2`
@@ -301,6 +315,13 @@ Use the refill command for sender send refills:
 /sellable:refill-sends --sender "Christian Reyes" --sender "Thomas Nobbs"
 ```
 
+Use the refresh command to top up sender-owned post-engager campaigns from the
+latest relevant sender-authored posts:
+
+```
+/sellable:refresh-sender-engagement --sender "Christian Reyes"
+```
+
 Then describe intent naturally, for example:
 
 - "Let's make a campaign with sellable"
@@ -329,6 +350,12 @@ $sellable:refill-sends --yolo --until 2026-06-30
 $sellable:refill-sends --sender "Christian Reyes" --sender "Thomas Nobbs"
 ```
 
+Use the Codex refresh command for latest post engagers:
+
+```
+$sellable:refresh-sender-engagement --sender "Christian Reyes"
+```
+
 Installed skill package path:
 
 - `~/.codex/plugins/cache/sellable/sellable/<version>/skills/sellable-create-campaign/SKILL.md`
@@ -494,9 +521,10 @@ compatibility and as the tested foundation-memory engine.
 
 - `list_workspaces` - List accessible workspaces
 - `get_active_workspace` - Show active workspace selection
+- `get_workspace` - Show workspace members and pending invites
 - `set_active_workspace` - Set active workspace by ID
-- `create_workspace` - Create a new workspace
-- `add_teammate` - Invite a teammate
+- `create_workspace` - Create a new workspace and make it active
+- `add_teammate` - Invite a teammate to the active workspace or a provided `workspaceId`
 
 ### Campaign Tools (Free)
 

package/dist/api.d.ts

@@ -8,6 +8,9 @@ export interface DownloadToFileResult {
     contentType: string | null;
     status: number;
 }
+export interface ApiRequestOptions {
+    workspaceId?: string | null;
+}
 export declare class SellableApiError extends Error {
     status: number;
     body: string;
@@ -19,10 +22,10 @@ export declare class SellableApi {
     private buildError;
     private requestResponse;
     private request;
-    get<T>(path: string): Promise<T>;
+    get<T>(path: string, options?: ApiRequestOptions): Promise<T>;
     getText(path: string): Promise<string>;
     downloadToFile(requestPath: string, destinationPath: string): Promise<DownloadToFileResult>;
-    post<T>(path: string, body?: object): Promise<T>;
+    post<T>(path: string, body?: object, options?: ApiRequestOptions): Promise<T>;
     put<T>(path: string, body?: object): Promise<T>;
     patch<T>(path: string, body?: object): Promise<T>;
     delete<T>(path: string): Promise<T>;

package/dist/api.js

@@ -35,11 +35,13 @@ export class SellableApi {
                 : undefined;
         return new SellableApiError(status, errorText, guidance);
     }
-    async requestResponse(method, path, body) {
+    async requestResponse(method, path, body, options) {
         // Re-read config on every request so workspace switches take effect immediately
         const config = getConfig();
         const url = `${config.apiUrl}${path}`;
-        const workspaceId = config.activeWorkspaceId || config.workspaceId || null;
+        const workspaceId = options && Object.prototype.hasOwnProperty.call(options, "workspaceId")
+            ? options.workspaceId
+            : config.activeWorkspaceId || config.workspaceId || null;
         const response = await fetch(url, {
             method,
             headers: {
@@ -55,12 +57,12 @@ export class SellableApi {
         }
         return response;
     }
-    async request(method, path, body) {
-        const response = await this.requestResponse(method, path, body);
+    async request(method, path, body, options) {
+        const response = await this.requestResponse(method, path, body, options);
         return response.json();
     }
-    async get(path) {
-        return this.request("GET", path);
+    async get(path, options) {
+        return this.request("GET", path, undefined, options);
     }
     async getText(path) {
         const response = await this.requestResponse("GET", path);
@@ -93,8 +95,8 @@ export class SellableApi {
             }
         }
     }
-    async post(path, body) {
-        return this.request("POST", path, body);
+    async post(path, body, options) {
+        return this.request("POST", path, body, options);
     }
     async put(path, body) {
         return this.request("PUT", path, body);

package/dist/server.js

@@ -50,7 +50,7 @@ import { handleVerifyTableRow } from "./tools/verify-row.js";
 import { sanitizeWatchUrlsForMcpResult } from "./tools/watch-url-security.js";
 import { getCampaignWaterfall, setCampaignWaterfallOrder, } from "./tools/waterfalls.js";
 import { exportWorkspaceCsv } from "./tools/workspace-export.js";
-import { addTeammate, createWorkspace, getActiveWorkspace, listWorkspaces, setActiveWorkspace, } from "./tools/workspaces.js";
+import { addTeammate, createWorkspace, getActiveWorkspace, getWorkspace, listWorkspaces, setActiveWorkspace, } from "./tools/workspaces.js";
 import { checkForUpdates, logUpdateNotice } from "./update-check.js";
 const server = new Server({
     name: "sellable-mcp",
@@ -179,6 +179,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_active_workspace":
                 result = getActiveWorkspace();
                 break;
+            case "get_workspace":
+                result = await getWorkspace(args?.workspaceId);
+                break;
             case "set_active_workspace":
                 result = await setActiveWorkspace(args?.workspaceId, args?.userConfirmed);
                 break;

package/dist/tools/registry.d.ts

@@ -7612,6 +7612,25 @@ export declare const allTools: ({
         readonly required: readonly ["waterfallKey", "orderedSlotKeys"];
         readonly additionalProperties: false;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+            };
+            userConfirmed?: undefined;
+            name?: undefined;
+            email?: undefined;
+            role?: undefined;
+            redirectTo?: undefined;
+            campaignId?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;
@@ -7659,6 +7678,9 @@ export declare const allTools: ({
     inputSchema: {
         type: string;
         properties: {
+            workspaceId: {
+                type: string;
+            };
             email: {
                 type: string;
             };
@@ -7672,7 +7694,6 @@ export declare const allTools: ({
             campaignId: {
                 type: string;
             };
-            workspaceId?: undefined;
             userConfirmed?: undefined;
             name?: undefined;
         };

package/dist/tools/workspaces.d.ts

@@ -6,6 +6,32 @@ type WorkspaceSummary = {
     isDefault: boolean;
     createdAt: string;
 };
+type WorkspaceDetails = {
+    id: string;
+    name: string;
+    slug: string;
+    credits: number;
+    role: string;
+    createdAt: string;
+    updatedAt: string;
+    archivedAt: string | null;
+    members: Array<{
+        id: string;
+        userId: string;
+        email: string;
+        role: string;
+        createdAt: string;
+    }>;
+    pendingInvites: Array<{
+        id: string;
+        email: string;
+        role: string;
+        invitedByEmail: string | null;
+        createdAt: string;
+        expiresAt: string;
+        redirectTo: string | null;
+    }>;
+};
 export declare const workspaceToolDefinitions: ({
     name: string;
     description: string;
@@ -23,6 +49,25 @@ export declare const workspaceToolDefinitions: ({
         required: never[];
         additionalProperties: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            workspaceId: {
+                type: string;
+            };
+            userConfirmed?: undefined;
+            name?: undefined;
+            email?: undefined;
+            role?: undefined;
+            redirectTo?: undefined;
+            campaignId?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
 } | {
     name: string;
     description: string;
@@ -70,6 +115,9 @@ export declare const workspaceToolDefinitions: ({
     inputSchema: {
         type: string;
         properties: {
+            workspaceId: {
+                type: string;
+            };
             email: {
                 type: string;
             };
@@ -83,7 +131,6 @@ export declare const workspaceToolDefinitions: ({
             campaignId: {
                 type: string;
             };
-            workspaceId?: undefined;
             userConfirmed?: undefined;
             name?: undefined;
         };
@@ -98,6 +145,9 @@ export declare function getActiveWorkspace(): {
     activeWorkspaceId: string | null;
     activeWorkspaceName: string | null;
 };
+export declare function getWorkspace(workspaceId: string): Promise<{
+    workspace: WorkspaceDetails;
+}>;
 export declare function setActiveWorkspace(workspaceId: string, userConfirmed?: boolean): Promise<{
     ok: boolean;
     error: string;
@@ -132,6 +182,7 @@ export declare function createWorkspace(name: string): Promise<{
     activeWorkspaceId: string;
 }>;
 export declare function addTeammate(input: {
+    workspaceId?: string;
     email: string;
     role?: "ADMIN" | "MEMBER";
     redirectTo?: string;

package/dist/tools/workspaces.js

@@ -21,6 +21,18 @@ export const workspaceToolDefinitions = [
             additionalProperties: false,
         },
     },
+    {
+        name: "get_workspace",
+        description: "Get details of an accessible workspace including members and pending invites.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workspaceId: { type: "string" },
+            },
+            required: ["workspaceId"],
+            additionalProperties: false,
+        },
+    },
     {
         name: "set_active_workspace",
         description: "Set active workspace by ID. Only call this when the user explicitly asks to switch workspace.",
@@ -39,7 +51,7 @@ export const workspaceToolDefinitions = [
     },
     {
         name: "create_workspace",
-        description: "Create a new workspace.",
+        description: "Create a new workspace. The authenticated user becomes OWNER and the new workspace becomes active for subsequent active-workspace tools.",
         inputSchema: {
             type: "object",
             properties: {
@@ -51,10 +63,11 @@ export const workspaceToolDefinitions = [
     },
     {
         name: "add_teammate",
-        description: "Invite a teammate to the active workspace.",
+        description: "Invite a teammate to a workspace. Defaults to the active workspace; pass workspaceId to invite to a specific accessible workspace without switching active workspace.",
         inputSchema: {
             type: "object",
             properties: {
+                workspaceId: { type: "string" },
                 email: { type: "string" },
                 role: { type: "string", enum: ["ADMIN", "MEMBER"] },
                 redirectTo: { type: "string" },
@@ -77,6 +90,11 @@ export function getActiveWorkspace() {
         activeWorkspaceName: config.activeWorkspaceName || null,
     };
 }
+export async function getWorkspace(workspaceId) {
+    const api = getApi();
+    const { workspace } = await api.get(`/api/v3/workspaces/${encodeURIComponent(workspaceId)}`);
+    return { workspace };
+}
 export async function setActiveWorkspace(workspaceId, userConfirmed) {
     const api = getApi();
     const { workspaces } = await api.get("/api/v3/workspaces");
@@ -126,8 +144,9 @@ export async function createWorkspace(name) {
     };
 }
 export async function addTeammate(input) {
+    const args = input || {};
     const config = getConfig();
-    const workspaceId = config.activeWorkspaceId || config.workspaceId;
+    const workspaceId = args.workspaceId || config.activeWorkspaceId || config.workspaceId;
     if (!workspaceId) {
         return {
             ok: false,
@@ -135,5 +154,6 @@ export async function addTeammate(input) {
         };
     }
     const api = getApi();
-    return api.post("/api/v3/workspaces/invites", input);
+    const { workspaceId: _workspaceId, ...inviteInput } = args;
+    return api.post("/api/v3/workspaces/invites", inviteInput, { workspaceId });
 }

package/package.json

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

package/skills/refresh-sender-engagement/SKILL.md

@@ -1,7 +1,28 @@
 ---
 name: refresh-sender-engagement
 description: Top up a sender's post-engager pipeline — fetch their recent LinkedIn posts, pull new engagers, filter by headline ICP criteria, and add net-new leads to their post-engagers campaign with dedupe. Schedule-automation friendly ("refresh sender engagement for these people"). Read-only on LinkedIn; never sends.
-visibility: internal
+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__search_subskill_prompts
+  - mcp__sellable__list_senders
+  - mcp__sellable__get_sender
+  - mcp__sellable__get_campaigns
+  - mcp__sellable__get_campaign
+  - mcp__sellable__get_campaign_context
+  - mcp__sellable__get_campaign_table_schema
+  - mcp__sellable__list_tables
+  - mcp__sellable__get_rows_minimal
+  - mcp__sellable__fetch_linkedin_posts
+  - mcp__sellable__select_promising_posts
+  - mcp__sellable__fetch_post_engagers
+  - mcp__sellable__add_on_demand_leads
 ---
 
 # Refresh Sender Engagement
@@ -11,27 +32,60 @@ You are a pipeline supply agent. People who engage with a sender's LinkedIn post
 </role>
 
 <inputs>
-The invoking prompt names the senders ("refresh sender engagement for csreyes92 and thomas"). Resolve each via `list_senders` (match name/handle/LinkedIn URL). With no names given, refresh every connected sender in the active workspace.
+The invoking prompt names the senders ("refresh sender engagement for csreyes92 and thomas"). Resolve each via `list_senders` (match name/handle/LinkedIn URL). With no names given, inspect the active workspace and refresh every connected sender that has an active/paused sender-owned Post Engagers campaign backed by Signal Discovery.
 
-Optional: lookback window (default: posts from the last 30 days), engagement sources (default `both` reactions+comments), and the target campaign name (default: the sender's existing "<Name> - Post Engagers" campaign found via `get_campaigns`/`list_tables`).
+Optional: lookback window (default: posts from the last 30 days), engagement sources (default `both` reactions+comments), target sender names/ids, maximum posts per sender (default 5, hard cap 5 unless the user explicitly asks for more), and target campaign ids/names when the user wants to force a specific campaign.
 </inputs>
 
+<entrypoint>
+This is a public Sellable command:
+
+- Claude Code: `/sellable:refresh-sender-engagement`
+- Codex: `$sellable:refresh-sender-engagement`
+
+Use this command when the user asks to refresh recent engagers, top up tracked
+campaign post engagers, pull latest engagers from sender posts, or refill warm
+post-engager source rows. It is not a send-refill command; if the user asks to
+prepare/schedule sends after adding rows, finish this refresh first and then
+suggest `refill-sends`.
+</entrypoint>
+
 <objective>
-For each sender:
-
-1. **Find the target campaign**: locate the sender's post-engagers campaign table (`get_campaigns` + `get_campaign`, or `list_tables`). If none exists, report "no post-engagers campaign — create one first" and skip; do not silently create campaigns on a schedule.
-2. **Fetch recent posts**: `fetch_linkedin_posts({ linkedinUrl: sender profile, limit: 25 })`. Keep original posts (not reposts) from the lookback window, ranked by engagement.
-3. **Pull engagers**: for the top posts (up to 5 per sender per run), `fetch_post_engagers({ postUrl, sources: "both" })`.
-4. **Filter to ICP** using the campaign's existing headline ICP criteria (from `get_campaign` brief/rubrics). Judge each engager's headline against those criteria; exclude obvious non-fits, the sender's own colleagues, and anyone with no headline. When the campaign has no criteria, keep decision-makers and operators, exclude students/job-seekers/competitors.
-5. **Add net-new leads only**: `add_on_demand_leads({ tableId, leads, skipDuplicates: true })` with name, headline-derived title, and profile URL. Dedupe is the default — never disable it on a scheduled run.
-6. **Report**: posts scanned, engagers found, ICP-passing, net-new added per sender. If a sender posted nothing in the window, say "no recent posts — nothing to refresh" (that is a truthful no-op, not a failure).
+For each target sender/campaign:
+
+1. **Find active Signal Discovery/Post Engagers campaigns first**:
+   - Call `get_auth_status` and confirm the active workspace.
+   - Call `get_campaigns` and, when needed, `list_tables`/`get_campaign` to find candidate campaigns.
+   - Keep only active or paused campaign-backed sender-owned Post Engagers campaigns. Strong signals include campaign/table names like `<Sender> - Post Engagers`, `sourceProvider:"signal-discovery"`, sender attachment to exactly one sender, and source/list/table readback indicating post engagers.
+   - Exclude shared Signal Discovery lanes, Shared Cold Fallback lanes, archived/completed campaigns, non-campaign tables, direct/on-demand-only campaigns, and any campaign attached to multiple senders unless the user explicitly selected it and the readback proves it is sender-owned.
+   - If no matching campaign exists for a sender, report "no active Post Engagers Signal Discovery campaign — create one first" and skip; do not silently create campaigns.
+2. **Resolve the sender and source boundary**:
+   - Match each candidate campaign to its sender from `list_senders`/`get_sender`.
+   - Use the sender's own LinkedIn profile URL/handle as the only source author boundary.
+   - Never scrape third-party authors into a sender-owned Post Engagers campaign.
+3. **Find relevant sender-authored posts to refresh**:
+   - Call `fetch_linkedin_posts({ linkedinUrl: sender profile, limit: 25 })`.
+   - Keep original posts authored by that exact sender, not reposts, from the lookback window.
+   - Rank posts by recency, engagement count, and fit to the campaign's buyer/problem/topic. Prefer posts likely to attract the target buyer over generic company updates.
+   - If the campaign has an existing Signal Discovery/source state that names tracked/selected posts, prefer refreshing those posts when they are still inside the lookback window and relevant; otherwise choose the strongest recent sender-authored posts.
+   - When the product flow expects selected posts to be visible, call `select_promising_posts` before scraping.
+4. **Pull latest engagers**:
+   - For the top posts (up to 5 per sender per run), call `fetch_post_engagers({ postUrl, sources })`.
+   - Default `sources` to `"both"` unless the user requested reactions-only or comments-only.
+5. **Filter to ICP** using the campaign's existing headline ICP criteria (from `get_campaign` brief/rubrics/table schema). Judge each engager's headline against those criteria; exclude obvious non-fits, the sender's own colleagues, existing employees, students/job-seekers, competitors, and anyone with no usable headline. When the campaign has no criteria, keep likely decision-makers/operators and exclude weak-fit profiles.
+6. **Add net-new leads only**:
+   - Use `add_on_demand_leads({ tableId, leads, skipDuplicates: true })` with name, headline-derived title, profile URL, and source/post context where the tool accepts it.
+   - Dedupe is mandatory. Never disable dedupe on a scheduled run.
+   - Do not generate, approve, schedule, or send messages.
+7. **Report**: campaigns inspected, target campaigns selected, posts scanned, engagers found, ICP-passing, net-new added per sender/campaign. If a sender posted nothing in the window, say "no recent posts — nothing to refresh" (that is a truthful no-op, not a failure).
 </objective>
 
 <safety>
 - LinkedIn operations here are read-only fetches plus adding rows to a campaign table. **No messages are generated, approved, or sent by this skill.**
 - Respect workspace boundaries: only add leads to campaigns in the active workspace, and only for senders that belong to it.
+- Respect campaign boundaries: only add engagers to the matched sender-owned Post Engagers campaign/table. Do not mix shared-lane engagers into sender-owned campaigns or sender-owned engagers into shared lanes.
 - Cap provider usage per run: at most 5 posts × `fetch_post_engagers` per sender. If the invoking automation wants more, it must say so explicitly.
-- Never call `start_campaign` or any send/approve tool.
+- Never call `start_campaign`, `attach_sequence`, `queue_campaign_cells`, `start_campaign_message_preparation`, approval tools, or any send/schedule tool.
 </safety>
 
 <output>