@sellable/mcp 0.1.950 → 0.1.951-wip.sendercontext.20261001.1

package/dist/agent-tool-names.d.ts

@@ -3,14 +3,14 @@
  * manifests. Keep this free of tool implementation imports so Next can bundle
  * it; registry parity is enforced in sellable-agent-tool-policy.test.ts.
  */
-export declare const SELLABLE_MCP_TOOL_NAMES: readonly ["add_column", "add_on_demand_leads", "add_rubric_item", "add_teammate", "add_to_comment_campaign", "add_to_connection_campaign", "add_to_inmail_campaign", "add_to_post_campaign", "archive_campaign", "attach_recommended_sequence", "attach_sequence", "bootstrap_create_campaign", "bootstrap_engage", "bootstrap_engage_multi", "bootstrap_find_leads", "bulk_enrich_with_prospeo", "calculate_linkedin_hook_preview", "cancel_campaign_message_preparation", "cancel_find_leads", "cancel_lead_import", "capture_post_idea", "check_inbox_reply_eligibility", "check_rubric", "commit_blueprint", "complete_sender_research", "confirm_harvest_job_companies", "confirm_lead_list", "confirm_prospeo_company_accounts", "copy_sender_config", "create_campaign", "create_on_demand_campaign", "create_on_demand_table", "create_table", "create_workflow_table", "create_workspace", "customer_program", "decide_agent_endpoint_proposal", "delete_column", "delete_rubric_item", "draft_rubrics", "duplicate_campaign", "enrich_with_prospeo", "export_table_csv", "export_workspace_csv", "fetch_company", "fetch_company_posts", "fetch_linkedin_posts", "fetch_linkedin_profile", "fetch_post_engagers", "fill_campaign_horizon", "get_active_workspace", "get_agent_endpoint_run", "get_agent_generation_routing", "get_agent_soul", "get_auth_status", "get_campaign", "get_campaign_context", "get_campaign_framework", "get_campaign_message_preparation_status", "get_campaign_messages_preview", "get_campaign_navigation_state", "get_campaign_refill_state", "get_campaign_table_schema", "get_campaign_waterfall", "get_campaigns", "get_column_schema", "get_company_info", "get_engage_memory", "get_engage_state", "get_engaged_posts", "get_find_leads_run", "get_inbox_thread", "get_integration_connection_status", "get_linkedin_profile", "get_or_create_direct_campaign_table", "get_post_draft", "get_post_find_leads_scout_registry", "get_post_idea", "get_prospeo_credits", "get_provider_prompt", "get_published_post", "get_refill_target_plan", "get_rows", "get_rows_minimal", "get_runtime_identity", "get_scheduler_fill_capacity", "get_sender", "get_sender_routing", "get_source_scout_registry", "get_subskill_asset", "get_subskill_prompt", "get_table_rows", "get_user_posts", "get_workspace", "import_leads", "init_on_demand_sequence", "integrations_call_tool", "integrations_describe_tool", "integrations_list_tools", "list_agent_endpoint_runs", "list_agent_endpoints", "list_column_types", "list_dnc_entries", "list_post_draft_iterations", "list_post_drafts", "list_post_ideas", "list_published_posts", "list_senders", "list_subskill_prompts", "list_tables", "list_workspaces", "load_csv_dnc_entries", "load_csv_domains", "load_csv_linkedin_leads", "lookup_sales_nav_filter", "mark_post_published", "migrate_flat_configs", "opportunity_sequence_enroll", "opportunity_sequence_next_page", "opportunity_sequence_record", "pause_campaign", "pause_direct_campaign", "pause_on_demand_campaign", "preflight_find_leads_provider", "prepare_campaign_ab_test", "publish_agent_endpoint", "queue_campaign_cells", "queue_cells", "record_campaign_review_batch", "record_engage_proven_search", "refill_sends", "refill_v3_advance", "refill_v3_continue", "refill_v3_edit_selected_campaign", "refill_v3_fill_ready", "refill_v3_world_state", "refresh_paid_inmail_credits", "refresh_sender_engagement", "reissue_find_leads_watch_link", "render_linkedin_post_preview", "reorder_columns", "resolve_campaign_fill_route", "revise_message_template_and_rerun", "rotate_agent_endpoint_key", "run_scheduler_sweep", "save_domain_filters", "save_hook_research", "save_post_draft", "save_rubrics", "search_apollo", "search_available_integrations", "search_engagement_posts", "search_harvest_jobs", "search_inbox_threads", "search_prospeo", "search_prospeo_companies", "search_sales_nav", "search_signals", "search_subskill_prompts", "select_campaign_cells", "select_necessary_rubrics", "select_promising_posts", "send_inbox_draft", "send_inbox_manual_reply", "set_active_workspace", "set_agent_generation_flags", "set_campaign_waterfall_order", "set_company_info", "set_engage_state", "set_engage_style_guide", "set_headline_icp_criteria", "set_sender_calendar_link", "set_sender_routing", "setup_evergreen_campaigns", "start_campaign", "start_campaign_message_preparation", "start_cli_login", "start_direct_campaign", "start_integration_connection", "start_on_demand_campaign", "stop_agent_endpoint_run", "update_agent_soul", "update_campaign", "update_campaign_brief", "update_cell", "update_column", "update_find_leads_run", "update_inbox_draft", "update_post_draft", "update_published_post_metrics", "update_rubric_item", "upsert_engage_tracked_person", "upsert_rubric", "validate_campaign1_kickoff_handoff", "verify_table_row", "wait_for_campaign_processing", "wait_for_campaign_table_ready", "wait_for_cli_login", "wait_for_find_leads_run", "wait_for_lead_list_ready", "wait_for_rubric_results"];
+export declare const SELLABLE_MCP_TOOL_NAMES: readonly ["add_column", "add_on_demand_leads", "add_rubric_item", "add_teammate", "add_to_comment_campaign", "add_to_connection_campaign", "add_to_inmail_campaign", "add_to_post_campaign", "archive_campaign", "attach_recommended_sequence", "attach_sequence", "bootstrap_create_campaign", "bootstrap_engage", "bootstrap_engage_multi", "bootstrap_find_leads", "bulk_enrich_with_prospeo", "calculate_linkedin_hook_preview", "cancel_campaign_message_preparation", "cancel_find_leads", "cancel_lead_import", "capture_post_idea", "check_inbox_reply_eligibility", "check_rubric", "commit_blueprint", "complete_sender_research", "confirm_harvest_job_companies", "confirm_lead_list", "confirm_prospeo_company_accounts", "copy_sender_config", "create_campaign", "create_on_demand_campaign", "create_on_demand_table", "create_table", "create_workflow_table", "create_workspace", "customer_program", "decide_agent_endpoint_proposal", "delete_column", "delete_rubric_item", "draft_rubrics", "duplicate_campaign", "enrich_with_prospeo", "export_table_csv", "export_workspace_csv", "fetch_company", "fetch_company_posts", "fetch_linkedin_posts", "fetch_linkedin_profile", "fetch_post_engagers", "fill_campaign_horizon", "get_active_workspace", "get_agent_endpoint_run", "get_agent_generation_routing", "get_agent_soul", "get_auth_status", "get_campaign", "get_campaign_context", "get_campaign_framework", "get_campaign_message_preparation_status", "get_campaign_messages_preview", "get_campaign_navigation_state", "get_campaign_refill_state", "get_campaign_table_schema", "get_campaign_waterfall", "get_campaigns", "get_column_schema", "get_company_info", "get_engage_memory", "get_engage_state", "get_engaged_posts", "get_find_leads_run", "get_inbox_thread", "get_integration_connection_status", "get_linkedin_profile", "get_or_create_direct_campaign_table", "get_post_draft", "get_post_find_leads_scout_registry", "get_post_idea", "get_prospeo_credits", "get_provider_prompt", "get_published_post", "get_refill_target_plan", "get_rows", "get_rows_minimal", "get_runtime_identity", "get_scheduler_fill_capacity", "get_sender", "get_sender_routing", "get_source_scout_registry", "get_subskill_asset", "get_subskill_prompt", "get_table_rows", "get_user_posts", "get_workspace", "import_leads", "init_on_demand_sequence", "integrations_call_tool", "integrations_describe_tool", "integrations_list_tools", "list_agent_endpoint_runs", "list_agent_endpoints", "list_column_types", "list_dnc_entries", "list_post_draft_iterations", "list_post_drafts", "list_post_ideas", "list_published_posts", "list_senders", "list_subskill_prompts", "list_tables", "list_workspaces", "load_csv_dnc_entries", "load_csv_domains", "load_csv_linkedin_leads", "lookup_sales_nav_filter", "mark_post_published", "migrate_flat_configs", "opportunity_sequence_enroll", "opportunity_sequence_next_page", "opportunity_sequence_record", "pause_campaign", "pause_direct_campaign", "pause_on_demand_campaign", "preflight_find_leads_provider", "prepare_campaign_ab_test", "publish_agent_endpoint", "queue_campaign_cells", "queue_cells", "record_campaign_review_batch", "record_engage_proven_search", "refill_sends", "refill_v3_advance", "refill_v3_continue", "refill_v3_edit_selected_campaign", "refill_v3_fill_ready", "refill_v3_world_state", "refresh_paid_inmail_credits", "refresh_sender_engagement", "reissue_find_leads_watch_link", "render_linkedin_post_preview", "reorder_columns", "resolve_campaign_fill_route", "revise_message_template_and_rerun", "rotate_agent_endpoint_key", "run_scheduler_sweep", "save_domain_filters", "save_hook_research", "save_post_draft", "save_rubrics", "search_apollo", "search_available_integrations", "search_engagement_posts", "search_harvest_jobs", "search_inbox_threads", "search_prospeo", "search_prospeo_companies", "search_sales_nav", "search_signals", "search_subskill_prompts", "select_campaign_cells", "select_necessary_rubrics", "select_promising_posts", "send_inbox_draft", "send_inbox_manual_reply", "set_active_workspace", "set_agent_generation_flags", "set_campaign_waterfall_order", "set_company_info", "set_engage_state", "set_engage_style_guide", "set_headline_icp_criteria", "set_sender_calendar_link", "set_sender_context", "set_sender_routing", "setup_evergreen_campaigns", "start_campaign", "start_campaign_message_preparation", "start_cli_login", "start_direct_campaign", "start_integration_connection", "start_on_demand_campaign", "stop_agent_endpoint_run", "update_agent_soul", "update_campaign", "update_campaign_brief", "update_cell", "update_column", "update_find_leads_run", "update_inbox_draft", "update_post_draft", "update_published_post_metrics", "update_rubric_item", "upsert_engage_tracked_person", "upsert_rubric", "validate_campaign1_kickoff_handoff", "verify_table_row", "wait_for_campaign_processing", "wait_for_campaign_table_ready", "wait_for_cli_login", "wait_for_find_leads_run", "wait_for_lead_list_ready", "wait_for_rubric_results"];
 /**
  * Explicit mutation classification lives beside (but outside) the flat tool
  * registry. Neither this list nor `isMutatingTool` is an input to
  * `compileAgentToolPolicy`, so editing it cannot move the fleet-pinned
  * `policyHash`.
  */
-export declare const MUTATING_TOOL_NAMES: readonly ["create_table", "publish_agent_endpoint", "rotate_agent_endpoint_key", "decide_agent_endpoint_proposal", "stop_agent_endpoint_run", "pause_campaign", "archive_campaign", "update_campaign", "fill_campaign_horizon", "set_campaign_waterfall_order", "set_sender_routing", "set_agent_generation_flags", "send_inbox_draft", "send_inbox_manual_reply", "load_csv_dnc_entries", "update_cell", "queue_cells", "check_rubric", "queue_campaign_cells", "start_campaign_message_preparation", "opportunity_sequence_enroll", "opportunity_sequence_record", "refill_v3_fill_ready", "refill_v3_edit_selected_campaign", "refill_v3_advance", "refill_v3_continue"];
+export declare const MUTATING_TOOL_NAMES: readonly ["create_table", "publish_agent_endpoint", "rotate_agent_endpoint_key", "decide_agent_endpoint_proposal", "stop_agent_endpoint_run", "pause_campaign", "archive_campaign", "update_campaign", "fill_campaign_horizon", "set_campaign_waterfall_order", "set_sender_routing", "set_sender_context", "set_agent_generation_flags", "send_inbox_draft", "send_inbox_manual_reply", "load_csv_dnc_entries", "update_cell", "queue_cells", "check_rubric", "queue_campaign_cells", "start_campaign_message_preparation", "opportunity_sequence_enroll", "opportunity_sequence_record", "refill_v3_fill_ready", "refill_v3_edit_selected_campaign", "refill_v3_advance", "refill_v3_continue"];
 export declare function isMutatingTool(name: string): boolean;
 export declare const CROSS_WORKSPACE_EXPLICIT_WORKSPACE_REQUIRED: {
     readonly code: "cross_workspace_explicit_workspace_required";

package/dist/agent-tool-names.js

@@ -176,6 +176,7 @@ export const SELLABLE_MCP_TOOL_NAMES = [
     "set_engage_style_guide",
     "set_headline_icp_criteria",
     "set_sender_calendar_link",
+    "set_sender_context",
     "set_sender_routing",
     "setup_evergreen_campaigns",
     "start_campaign",
@@ -227,6 +228,9 @@ export const MUTATING_TOOL_NAMES = [
     "fill_campaign_horizon",
     "set_campaign_waterfall_order",
     "set_sender_routing",
+    // A sender's personal context is what the message writer says about a real
+    // person, so a cross-workspace caller must name the workspace it means.
+    "set_sender_context",
     "set_agent_generation_flags",
     "send_inbox_draft",
     "send_inbox_manual_reply",

package/dist/server.js

@@ -34,9 +34,9 @@ import { handleReorderColumns } from "./tools/column-reorder.js";
 import { handleGetColumnSchema, handleListColumnTypes, } from "./tools/column-schema.js";
 import { handleUpdateColumn } from "./tools/column-update.js";
 import { getCompanyInfoTool, setCompanyInfoTool, } from "./tools/company-info.js";
-import { customerProgramTool } from "./tools/customer-program.js";
 import { calculateLinkedInHookPreviewTool, capturePostIdeaTool, getPostDraftTool, getPostIdeaTool, getPublishedPostTool, listPostDraftIterationsTool, listPostDraftsTool, listPostIdeasTool, listPublishedPostsTool, markPostPublishedTool, renderLinkedInPostPreviewTool, saveHookResearchTool, savePostDraftTool, updatePostDraftTool, updatePublishedPostMetricsTool, } from "./tools/content-posts.js";
 import { getCampaignContext, hydrateCampaignContextFromCampaign, markCampaignContextDirty, } from "./tools/context.js";
+import { customerProgramTool } from "./tools/customer-program.js";
 import { addToCommentCampaign, addToConnectionCampaign, addToInmailCampaign, addToPostCampaign, getEngagedPosts, getOrCreateDirectCampaignTable, pauseDirectCampaign, startDirectCampaign, } from "./tools/direct-campaigns.js";
 import { bootstrapEngage, bootstrapEngageMulti, } from "./tools/engage-bootstrap.js";
 import { searchEngagementPosts } from "./tools/engage-discovery.js";
@@ -75,7 +75,7 @@ import { getRuntimeIdentityTool } from "./tools/runtime-identity.js";
 import { getSchedulerFillCapacity } from "./tools/scheduler-fill-capacity.js";
 import { runSchedulerSweep } from "./tools/scheduler-run.js";
 import { getSenderRoutingTool, setSenderRoutingTool, } from "./tools/sender-routing.js";
-import { getSender, listSenders, refreshPaidInmailCredits, setSenderCalendarLink, } from "./tools/senders.js";
+import { getSender, listSenders, refreshPaidInmailCredits, setSenderCalendarLink, setSenderContext, } from "./tools/senders.js";
 import { attachRecommendedSequence, attachSequence, createWorkflowTable, } from "./tools/sequencer.js";
 import { setupEvergreenCampaigns } from "./tools/setup-evergreen-campaigns.js";
 import { createTable, exportTableCsv, listTables } from "./tools/tables.js";
@@ -201,8 +201,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             ok: false,
                             error: boundary.authorization.code,
                             decision: "DENY",
-                            ...(boundary.authorization.code === "managed_agent_auth_unavailable"
-                                ? { message: "Managed authentication is unavailable. The runtime supervisor must restore it; do not copy personal credentials, start browser login, or retry a Calendar mutation automatically." }
+                            ...(boundary.authorization.code ===
+                                "managed_agent_auth_unavailable"
+                                ? {
+                                    message: "Managed authentication is unavailable. The runtime supervisor must restore it; do not copy personal credentials, start browser login, or retry a Calendar mutation automatically.",
+                                }
                                 : {}),
                         }),
                     },
@@ -862,6 +865,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "set_sender_calendar_link":
                 result = await setSenderCalendarLink(args);
                 break;
+            case "set_sender_context":
+                result = await setSenderContext(args);
+                break;
             case "refresh_paid_inmail_credits":
                 result = await refreshPaidInmailCredits(args);
                 break;

package/dist/tools/registry.d.ts

@@ -7486,6 +7486,8 @@ export declare const allTools: ({
             expectedCalendarLink?: undefined;
             expectedCalendarLinkRevision?: undefined;
             force?: undefined;
+            senderContext?: undefined;
+            expectedUpdatedAt?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -7527,6 +7529,8 @@ export declare const allTools: ({
             threshold?: undefined;
             maxStalenessSeconds?: undefined;
             paidInmailCreditsMaxStalenessSeconds?: undefined;
+            senderContext?: undefined;
+            expectedUpdatedAt?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -7610,6 +7614,89 @@ export declare const allTools: ({
         idempotentHint: boolean;
         openWorldHint: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                minLength: number;
+                description?: undefined;
+            };
+            workspaceId: {
+                type: string;
+                minLength: number;
+                description?: undefined;
+            };
+            senderContext: {
+                type: string[];
+                properties: {
+                    workStories: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                    personalNotes: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                    voiceExamples: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                    sourcesAndLimits: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            expectedUpdatedAt: {
+                readonly type: readonly ["string", "null"];
+            };
+            actionType?: undefined;
+            campaignId?: undefined;
+            tableId?: undefined;
+            columnId?: undefined;
+            threshold?: undefined;
+            maxStalenessSeconds?: undefined;
+            paidInmailCreditsMaxStalenessSeconds?: undefined;
+            calendarLink?: undefined;
+            expectedCalendarLink?: undefined;
+            expectedCalendarLinkRevision?: undefined;
+            force?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    outputSchema?: undefined;
 } | {
     name: string;
     description: string;

package/dist/tools/senders.d.ts

@@ -180,6 +180,8 @@ export declare const senderToolDefinitions: ({
             expectedCalendarLink?: undefined;
             expectedCalendarLinkRevision?: undefined;
             force?: undefined;
+            senderContext?: undefined;
+            expectedUpdatedAt?: undefined;
         };
         required: never[];
         additionalProperties: boolean;
@@ -213,6 +215,8 @@ export declare const senderToolDefinitions: ({
             expectedCalendarLink?: undefined;
             expectedCalendarLinkRevision?: undefined;
             force?: undefined;
+            senderContext?: undefined;
+            expectedUpdatedAt?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -267,6 +271,8 @@ export declare const senderToolDefinitions: ({
             expectedCalendarLink?: undefined;
             expectedCalendarLinkRevision?: undefined;
             force?: undefined;
+            senderContext?: undefined;
+            expectedUpdatedAt?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -308,6 +314,8 @@ export declare const senderToolDefinitions: ({
             threshold?: undefined;
             maxStalenessSeconds?: undefined;
             paidInmailCreditsMaxStalenessSeconds?: undefined;
+            senderContext?: undefined;
+            expectedUpdatedAt?: undefined;
         };
         required: string[];
         additionalProperties: boolean;
@@ -391,9 +399,108 @@ export declare const senderToolDefinitions: ({
         idempotentHint: boolean;
         openWorldHint: boolean;
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                minLength: number;
+                description?: undefined;
+            };
+            workspaceId: {
+                type: string;
+                minLength: number;
+                description?: undefined;
+            };
+            senderContext: {
+                type: string[];
+                properties: {
+                    workStories: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                    personalNotes: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                    voiceExamples: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                    sourcesAndLimits: {
+                        readonly type: "array";
+                        readonly maxItems: 10;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 3000;
+                        };
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            expectedUpdatedAt: {
+                readonly type: readonly ["string", "null"];
+            };
+            actionType?: undefined;
+            campaignId?: undefined;
+            tableId?: undefined;
+            columnId?: undefined;
+            threshold?: undefined;
+            maxStalenessSeconds?: undefined;
+            paidInmailCreditsMaxStalenessSeconds?: undefined;
+            calendarLink?: undefined;
+            expectedCalendarLink?: undefined;
+            expectedCalendarLinkRevision?: undefined;
+            force?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    outputSchema?: undefined;
 })[];
 export declare function listSenders(input?: ListSendersInput): Promise<ListSendersResponse>;
 export declare function setSenderCalendarLink(input: SetSenderCalendarLinkInput): Promise<SenderCalendarLinkToolResult>;
+declare const SENDER_CONTEXT_LISTS: readonly ["workStories", "personalNotes", "voiceExamples", "sourcesAndLimits"];
+export type SetSenderContextInput = {
+    senderId: string;
+    workspaceId: string;
+    senderContext: Partial<Record<(typeof SENDER_CONTEXT_LISTS)[number], string[]>> | null;
+    expectedUpdatedAt: string | null;
+};
+/** Save one sender's personal context through the compare-before-write route. */
+export declare function setSenderContext(input: SetSenderContextInput): Promise<{
+    isError?: true | undefined;
+    structuredContent: Record<string, unknown>;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
 export declare function getSender(input: GetSenderInput): Promise<SenderDetailResponse>;
 export declare function refreshPaidInmailCredits(input: RefreshPaidInmailCreditsInput): Promise<RefreshPaidInmailCreditsResponse>;
 export {};

package/dist/tools/senders.js

@@ -2,6 +2,11 @@ import { getApi, SellableApiError } from "../api.js";
 import { isLinkedInProfileInput, normalizeLinkedInProfileInput, } from "./linkedin-url.js";
 import { normalizeExplicitWorkspaceId, workspaceRequestOptions, } from "./workspace-context.js";
 const nullableStringSchema = { type: ["string", "null"] };
+const senderContextEntriesInputSchema = {
+    type: "array",
+    maxItems: 10,
+    items: { type: "string", minLength: 1, maxLength: 3000 },
+};
 const setSenderCalendarLinkOutputSchema = {
     type: "object",
     oneOf: [
@@ -346,6 +351,41 @@ export const senderToolDefinitions = [
             openWorldHint: false,
         },
     },
+    {
+        name: "set_sender_context",
+        description: "Save one exact outbound sender's personal context: the four lists the message writer uses as that sender's fact bank and voice (workStories, personalNotes, voiceExamples, sourcesAndLimits). This is what a sender interview produces. It replaces the sender's whole saved context; it cannot touch another sender, the calendar link, writing style, dos/donts or Company Info. Read get_sender first and pass generationContext.updatedAt as expectedUpdatedAt (null when nothing is saved yet). Limits: at most 10 entries per list, 3000 characters per entry, 15000 UTF-8 bytes in all. Only write what the sender said or confirmed; never copy one sender's facts into another's. Pass senderContext: null to clear it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string", minLength: 1 },
+                workspaceId: { type: "string", minLength: 1 },
+                senderContext: {
+                    type: ["object", "null"],
+                    properties: {
+                        workStories: senderContextEntriesInputSchema,
+                        personalNotes: senderContextEntriesInputSchema,
+                        voiceExamples: senderContextEntriesInputSchema,
+                        sourcesAndLimits: senderContextEntriesInputSchema,
+                    },
+                    additionalProperties: false,
+                },
+                expectedUpdatedAt: nullableStringSchema,
+            },
+            required: [
+                "senderId",
+                "workspaceId",
+                "senderContext",
+                "expectedUpdatedAt",
+            ],
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
 ];
 export async function listSenders(input = {}) {
     const api = getApi();
@@ -497,6 +537,134 @@ export async function setSenderCalendarLink(input) {
         });
     }
 }
+const SENDER_CONTEXT_LISTS = [
+    "workStories",
+    "personalNotes",
+    "voiceExamples",
+    "sourcesAndLimits",
+];
+function senderContextResult(value) {
+    return {
+        structuredContent: value,
+        content: [{ type: "text", text: JSON.stringify(value) }],
+        ...(value.ok === true ? {} : { isError: true }),
+    };
+}
+function isSenderContextInput(value) {
+    if (value === null)
+        return true;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    return Object.entries(value).every(([key, entries]) => SENDER_CONTEXT_LISTS.includes(key) &&
+        Array.isArray(entries) &&
+        entries.every((entry) => typeof entry === "string"));
+}
+/** Save one sender's personal context through the compare-before-write route. */
+export async function setSenderContext(input) {
+    const candidate = input;
+    const record = candidate && typeof candidate === "object" && !Array.isArray(candidate)
+        ? candidate
+        : null;
+    const senderId = record && typeof record.senderId === "string" ? record.senderId.trim() : "";
+    const workspaceId = record && typeof record.workspaceId === "string"
+        ? record.workspaceId.trim()
+        : "";
+    const hasOwn = (key) => record !== null && Object.prototype.hasOwnProperty.call(record, key);
+    if (!record ||
+        !senderId ||
+        !workspaceId ||
+        !hasOwn("senderContext") ||
+        !isSenderContextInput(record.senderContext) ||
+        !hasOwn("expectedUpdatedAt") ||
+        !isNullableString(record.expectedUpdatedAt)) {
+        return senderContextResult({
+            ok: false,
+            code: "invalid_arguments",
+            message: "senderId, workspaceId, senderContext and expectedUpdatedAt are required with the documented types.",
+            status: null,
+            uncertain: false,
+            currentUpdatedAt: null,
+            guidance: "Read get_sender and retry with generationContext.updatedAt as expectedUpdatedAt (null when nothing is saved).",
+        });
+    }
+    const api = getApi();
+    try {
+        const receipt = await api.put(`/api/v3/mcp/senders/${encodeURIComponent(senderId)}/sender-context`, {
+            workspaceId,
+            senderContext: record.senderContext,
+            expectedUpdatedAt: record.expectedUpdatedAt,
+        }, workspaceRequestOptions(workspaceId));
+        if (!receipt ||
+            typeof receipt !== "object" ||
+            typeof receipt.updatedAt !== "string") {
+            return senderContextResult({
+                ok: false,
+                code: "malformed_sender_context_response",
+                message: "The sender-context save returned an incomplete receipt, so the final state is uncertain.",
+                status: null,
+                uncertain: true,
+                currentUpdatedAt: null,
+                guidance: "Reread get_sender and reconcile before retrying.",
+            });
+        }
+        return senderContextResult({
+            ok: true,
+            senderId,
+            workspaceId,
+            senderContext: receipt.senderContext ?? null,
+            previousUpdatedAt: record.expectedUpdatedAt,
+            updatedAt: receipt.updatedAt,
+            cleared: receipt.cleared === true,
+        });
+    }
+    catch (error) {
+        if (error instanceof SellableApiError) {
+            const body = parseErrorBody(error.body);
+            const code = safeErrorCode(body?.code, `http_${error.status}`);
+            const isConflict = error.status === 409 && code === "sender_context_conflict";
+            const uncertain = error.status >= 500;
+            return senderContextResult({
+                ok: false,
+                code,
+                message: isConflict
+                    ? "The sender's saved context changed after it was read."
+                    : uncertain
+                        ? "The sender-context save did not complete with a confirmed result."
+                        : error.isAuthError
+                            ? "Sellable authentication or authorization failed."
+                            : error.status === 404
+                                ? "The sender was not found in the explicit workspace."
+                                : "The sender context was not saved.",
+                status: error.status,
+                uncertain,
+                currentUpdatedAt: isConflict && isNullableString(body?.currentUpdatedAt)
+                    ? body.currentUpdatedAt
+                    : null,
+                guidance: isConflict
+                    ? "Reread get_sender, merge with the newer context, and retry with its updatedAt."
+                    : uncertain
+                        ? "Reread get_sender and reconcile before retrying."
+                        : error.isAuthError
+                            ? error.guidance ||
+                                "Authenticate again and retry the same scoped request."
+                            : error.status === 400
+                                ? "Keep each list to 10 entries of at most 3000 characters and 15000 UTF-8 bytes in all, then retry."
+                                : error.status === 404
+                                    ? "Reread list_senders in the explicit workspace and select an existing sender."
+                                    : null,
+            });
+        }
+        return senderContextResult({
+            ok: false,
+            code: "sender_context_uncertain",
+            message: "The sender-context request ended without a confirmed response, so the final state is uncertain.",
+            status: null,
+            uncertain: true,
+            currentUpdatedAt: null,
+            guidance: "Reread get_sender and reconcile before retrying.",
+        });
+    }
+}
 export async function getSender(input) {
     const api = getApi();
     const requestOptions = workspaceRequestOptions(input.workspaceId);

package/package.json

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