@sellable/mcp 0.1.30 → 0.1.32

package/dist/auth.d.ts

@@ -44,6 +44,31 @@ export declare function updateActiveWorkspace(params: {
     workspaceId: string;
     workspaceName?: string | null;
 }): void;
+/**
+ * Write a fresh Sellable config to disk in the canonical flat shape.
+ *
+ * Used by the FTUX `wait_for_cli_login` MCP tool after a successful magic-link
+ * sign-in. Composes `getConfigPath()` + `writeRawConfigFile()` and writes the
+ * same on-disk shape that `packages/sellable-install/bin/sellable-install.mjs`
+ * `writeAuth(opts)` produces, and that the auth resolution chain in
+ * `getConfig()` reads.
+ *
+ * Field set is intentionally minimal — `{ token, activeWorkspaceId,
+ * activeWorkspaceName?, apiUrl }` — matching the legacy flat format. Do NOT
+ * introduce new fields here; that's a config-shape migration, not this helper's
+ * job.
+ *
+ * Because `DISABLE_CONFIG_CACHE = true`, the next `getConfig()` call sees the
+ * new config without an MCP server restart.
+ */
+export declare function writeNewConfig(opts: {
+    token: string;
+    activeWorkspaceId: string;
+    activeWorkspaceName?: string;
+    apiUrl: string;
+}): {
+    configPath: string;
+};
 export declare function getEngageState(): {
     activeWorkspaceId: string | null;
     state: EngageWorkspaceState | null;

package/dist/auth.js

@@ -178,6 +178,36 @@ function writeRawConfigFile(configPath, raw) {
     fs.writeFileSync(configPath, JSON.stringify(raw, null, 2) + "\n");
     cachedConfig = null;
 }
+/**
+ * Write a fresh Sellable config to disk in the canonical flat shape.
+ *
+ * Used by the FTUX `wait_for_cli_login` MCP tool after a successful magic-link
+ * sign-in. Composes `getConfigPath()` + `writeRawConfigFile()` and writes the
+ * same on-disk shape that `packages/sellable-install/bin/sellable-install.mjs`
+ * `writeAuth(opts)` produces, and that the auth resolution chain in
+ * `getConfig()` reads.
+ *
+ * Field set is intentionally minimal — `{ token, activeWorkspaceId,
+ * activeWorkspaceName?, apiUrl }` — matching the legacy flat format. Do NOT
+ * introduce new fields here; that's a config-shape migration, not this helper's
+ * job.
+ *
+ * Because `DISABLE_CONFIG_CACHE = true`, the next `getConfig()` call sees the
+ * new config without an MCP server restart.
+ */
+export function writeNewConfig(opts) {
+    const configPath = getConfigPath();
+    const raw = {
+        token: opts.token,
+        activeWorkspaceId: opts.activeWorkspaceId,
+        apiUrl: opts.apiUrl,
+    };
+    if (opts.activeWorkspaceName) {
+        raw.activeWorkspaceName = opts.activeWorkspaceName;
+    }
+    writeRawConfigFile(configPath, raw);
+    return { configPath };
+}
 function getActiveEnvConfigRef(raw) {
     if (raw?.activeEnv && raw?.environments) {
         const envName = raw.activeEnv;

package/dist/server.js

@@ -5,8 +5,9 @@ import { getSkillByName, listSkills } from "./skills.js";
 import { authToolDefinitions, getAuthStatus } from "./tools/auth.js";
 import { blueprintCommitToolDefinitions, handleAddColumn, handleCommitBlueprint, } from "./tools/blueprint-commit.js";
 import { bootstrapCreateCampaign, bootstrapToolDefinitions, } from "./tools/bootstrap.js";
-import { campaignToolDefinitions, createCampaign, enrichSender, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
+import { campaignToolDefinitions, createCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
 import { cellToolDefinitions, queueCells, updateCell } from "./tools/cells.js";
+import { handleStartCliLogin, handleWaitForCliLogin, startCliLoginToolDef, waitForCliLoginToolDef, } from "./tools/cli-login.js";
 import { contextToolDefinitions, getCampaignContext, hydrateCampaignContextFromCampaign, markCampaignContextDirty, } from "./tools/context.js";
 import { addToCommentCampaign, addToConnectionCampaign, addToInmailCampaign, directCampaignToolDefinitions, getEngagedPosts, getOrCreateDirectCampaignTable, pauseDirectCampaign, startDirectCampaign, } from "./tools/direct-campaigns.js";
 import { bootstrapEngage, bootstrapEngageMulti, engageBootstrapToolDefinitions, } from "./tools/engage-bootstrap.js";
@@ -42,6 +43,8 @@ const server = new Server({
 const allTools = [
     ...campaignToolDefinitions,
     ...authToolDefinitions,
+    startCliLoginToolDef,
+    waitForCliLoginToolDef,
     ...bootstrapToolDefinitions,
     ...engageBootstrapToolDefinitions,
     ...engageDiscoveryToolDefinitions,
@@ -108,6 +111,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_auth_status":
                 result = await getAuthStatus();
                 break;
+            case "start_cli_login":
+                result = await handleStartCliLogin(args);
+                break;
+            case "wait_for_cli_login":
+                result = await handleWaitForCliLogin(args);
+                break;
             case "bootstrap_engage":
                 result = await bootstrapEngage(args);
                 break;
@@ -168,9 +177,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "add_teammate":
                 result = await addTeammate(args);
                 break;
-            case "enrich_sender":
-                result = await enrichSender(args?.linkedinUrl, args?.companyDomain, args?.forceRefresh);
-                break;
             case "get_campaigns":
                 result = await getCampaigns(args?.limit);
                 break;

package/dist/tools/campaigns.d.ts

@@ -117,6 +117,7 @@ export interface CreateCampaignInput {
     campaignId?: string;
     name?: string;
     clientProspectId?: string;
+    senderLinkedinUrl?: string;
     offerPositioning?: unknown;
     campaignBrief?: string;
     messageGenerationMode?: "template" | "ai-generated";
@@ -140,48 +141,6 @@ export interface UpdateCampaignInput {
     rubric?: unknown[];
 }
 export declare const campaignToolDefinitions: ({
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            linkedinUrl: {
-                type: string;
-                description: string;
-            };
-            companyDomain: {
-                type: string;
-                description: string;
-            };
-            forceRefresh: {
-                type: string;
-                description: string;
-            };
-            limit?: undefined;
-            campaignId?: undefined;
-            tableId?: undefined;
-            leadLimit?: undefined;
-            page?: undefined;
-            filters?: undefined;
-            name?: undefined;
-            clientProspectId?: undefined;
-            offerPositioning?: undefined;
-            campaignBrief?: undefined;
-            messageGenerationMode?: undefined;
-            currentStep?: undefined;
-            leadSourceType?: undefined;
-            leadSourceProvider?: undefined;
-            selectedLeadListId?: undefined;
-            senderIds?: undefined;
-            interactionMode?: undefined;
-            enableICPFilters?: undefined;
-            useMessagingTemplate?: undefined;
-            rubric?: undefined;
-        };
-        required: string[];
-        additionalProperties?: undefined;
-    };
-} | {
     name: string;
     description: string;
     inputSchema: {
@@ -191,9 +150,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             campaignId?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -201,6 +157,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             campaignBrief?: undefined;
             messageGenerationMode?: undefined;
@@ -227,9 +184,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -237,6 +191,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             campaignBrief?: undefined;
             messageGenerationMode?: undefined;
@@ -310,12 +265,10 @@ export declare const campaignToolDefinitions: ({
                     additionalProperties: boolean;
                 };
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             campaignBrief?: undefined;
             messageGenerationMode?: undefined;
@@ -350,6 +303,10 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            senderLinkedinUrl: {
+                type: string;
+                description: string;
+            };
             offerPositioning: {
                 type: string;
                 description: string;
@@ -387,9 +344,6 @@ export declare const campaignToolDefinitions: ({
                 };
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -462,9 +416,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -472,6 +423,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             messageGenerationMode?: undefined;
         };
         required: string[];
@@ -491,9 +443,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -501,6 +450,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             messageGenerationMode?: undefined;
             currentStep?: undefined;
@@ -549,41 +499,4 @@ export declare function updateCampaignBrief(campaignId: string, campaignBrief: s
     success: boolean;
     campaignBrief: string;
 }>;
-export interface EnrichSenderResult {
-    clientProspectId: string;
-    sender: {
-        fullName: string;
-        headline?: string;
-        title?: string;
-        company?: string;
-    };
-    companyDomain: string;
-    enrichmentStatus: "partial" | "complete";
-    companySnapshot?: {
-        name: string;
-        domain: string;
-        industry?: string;
-        employeeRange?: string;
-        description?: string;
-        linkedinUrl?: string;
-    } | null;
-    senderBackground?: {
-        experience: {
-            title: string;
-            company: string;
-            duration?: string;
-        }[];
-        education?: string;
-        followerCount?: number;
-        connectionCount?: number;
-    } | null;
-    proofDigest?: {
-        caseStudyCount: number;
-        caseStudySummary: string | null;
-        reviewHighlight: string | null;
-        positioningOneLiner: string | null;
-        keyDifferentiators: string[];
-    } | null;
-}
-export declare function enrichSender(linkedinUrl: string, companyDomain?: string, forceRefresh?: boolean): Promise<EnrichSenderResult>;
 export {};

package/dist/tools/campaigns.js

@@ -1,6 +1,6 @@
 import { getApi } from "../api.js";
 import { getConfig } from "../auth.js";
-import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchReady, markSenderEnrichmentObserved, } from "./flow-preflight.js";
+import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchReady, } from "./flow-preflight.js";
 import { setCampaignInteractionMode, } from "./interaction-mode.js";
 import { fetchCampaignRubrics } from "./processing.js";
 const LEAD_SOURCE_PROVIDERS = {
@@ -27,28 +27,6 @@ function buildWatchUrl(config, redirect) {
     return `${config.apiUrl}/auth/continue?token=${config.token}&redirect=${redirect}${workspaceParam}`;
 }
 export const campaignToolDefinitions = [
-    {
-        name: "enrich_sender",
-        description: "Enrich a LinkedIn profile to get the clientProspectId needed for create_campaign. Fast return (~5-8s) with background enrichment. Call this first with the sender's LinkedIn URL before creating a campaign.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                linkedinUrl: {
-                    type: "string",
-                    description: "Full LinkedIn profile URL (e.g., https://linkedin.com/in/username)",
-                },
-                companyDomain: {
-                    type: "string",
-                    description: "Optional company domain to use instead of resolving from profile",
-                },
-                forceRefresh: {
-                    type: "boolean",
-                    description: "Skip cache and fetch fresh LinkedIn data. Use when you need the latest profile info.",
-                },
-            },
-            required: ["linkedinUrl"],
-        },
-    },
     {
         name: "get_campaigns",
         description: "List campaigns for the authenticated user. Returns id, name, createdAt. Ordered by most recent first.",
@@ -145,7 +123,7 @@ export const campaignToolDefinitions = [
     },
     {
         name: "create_campaign",
-        description: 'Create a new campaign offer OR resume an existing one. Low-level write tool: load create-campaign workflow instructions first via get_subskill_prompt({ subskillName: "create-campaign" }) (or bootstrap_create_campaign + nextStep). If campaignId is provided, this tool returns the watchUrl + state for that campaign instead of creating a new campaign.',
+        description: 'Create a new campaign offer OR resume an existing one. Low-level write tool: load create-campaign workflow instructions first via get_subskill_prompt({ subskillName: "create-campaign" }) (or bootstrap_create_campaign + nextStep). If campaignId is provided, this tool returns the watchUrl + state for that campaign instead of creating a new campaign.\n\nINPUTS:\n- Pass EITHER `clientProspectId` (if you already have a prospect ID from a prior workflow) OR `senderLinkedinUrl` (the sender\'s LinkedIn profile URL — preferred for net-new campaigns).\n- Passing both is fine; `clientProspectId` wins.\n- Passing neither returns a preflight error.\n\nPREREQUISITES:\n- The /research-sender skill must have been run for this sender (sets the campaign brief).',
         inputSchema: {
             type: "object",
             properties: {
@@ -159,7 +137,13 @@ export const campaignToolDefinitions = [
                 },
                 clientProspectId: {
                     type: "string",
-                    description: "Enriched client prospect ID",
+                    description: "Optional. Existing EnrichedProspect row ID. Pass this OR senderLinkedinUrl. If both supplied, this wins.",
+                },
+                // Phase 114: named `senderLinkedinUrl` (not `linkedinUrl`) to disambiguate from
+                // prospect-side `linkedinUrl` fields used in other tools (research-prospect etc.).
+                senderLinkedinUrl: {
+                    type: "string",
+                    description: "Optional. Sender's LinkedIn profile URL (e.g. https://www.linkedin.com/in/jane-doe/). Preferred for net-new campaigns. Mutually compatible with clientProspectId (the latter wins if both supplied).",
                 },
                 offerPositioning: {
                     type: "object",
@@ -611,21 +595,31 @@ export async function createCampaign(input) {
     const missing = [];
     if (!input.name)
         missing.push("name");
-    if (!input.clientProspectId)
-        missing.push("clientProspectId");
     if (!input.campaignBrief)
         missing.push("campaignBrief");
+    if (!input.clientProspectId && !input.senderLinkedinUrl) {
+        missing.push("clientProspectId-or-senderLinkedinUrl");
+    }
+    // Phase 114 edge-case fix: cheap URL sanity check on senderLinkedinUrl.
+    // Don't deep-validate; just reject obvious garbage so the downstream
+    // flow doesn't try to fetch a non-LinkedIn URL.
+    if (input.senderLinkedinUrl &&
+        typeof input.senderLinkedinUrl === "string" &&
+        !input.senderLinkedinUrl.includes("linkedin.com")) {
+        throw new Error("VALIDATION_ERROR: senderLinkedinUrl must be a LinkedIn URL (must contain 'linkedin.com'). Got: " +
+            input.senderLinkedinUrl);
+    }
     if (missing.length > 0) {
         throw new Error("VALIDATION_ERROR: create_campaign requires either campaignId (resume) " +
             `or all create fields. Missing: ${missing.join(", ")}.\n\n` +
             "Remediation:\n" +
             '- For full workflow, call get_subskill_prompt({ subskillName: "create-campaign" }) and follow it.\n' +
-            '- For net-new campaign creation, call enrich_sender first, then call get_subskill_prompt({ subskillName: "research-sender" }), run sender research, call complete_sender_research(...), and only then call create_campaign.\n' +
+            '- For net-new campaign creation, call get_subskill_prompt({ subskillName: "research-sender" }), run sender research (parallel batch — no enrich_sender required), call complete_sender_research(...), then call create_campaign with EITHER clientProspectId OR senderLinkedinUrl (the sender\'s LinkedIn profile URL).\n' +
             "- For resume, call create_campaign with campaignId only.");
     }
     assertNetNewCreateCampaignResearchReady();
     const name = input.name;
-    const clientProspectId = input.clientProspectId;
+    const clientProspectId = input.clientProspectId ?? null;
     const campaignBrief = input.campaignBrief;
     // Validate required campaignBrief - must be non-empty markdown
     // Normalize escaped newlines - MCP tool calls pass literal "\n" text (backslash + n)
@@ -680,6 +674,9 @@ export async function createCampaign(input) {
         ...apiInput,
         name,
         clientProspectId,
+        // Forward senderLinkedinUrl alongside clientProspectId. Downstream API may
+        // ignore it for now; future phase wires it.
+        senderLinkedinUrl: input.senderLinkedinUrl ?? null,
         offerPositioning,
         ...(input.leadSourceProvider !== undefined
             ? { leadSourceProvider: normalizedLeadSourceProvider }
@@ -769,124 +766,3 @@ export async function updateCampaignBrief(campaignId, campaignBrief) {
     const api = getApi();
     return api.patch(`/api/v3/mcp/campaigns/${campaignId}`, { campaignBrief });
 }
-export async function enrichSender(linkedinUrl, companyDomain, forceRefresh) {
-    const api = getApi();
-    const result = await api.post(`/api/v4/enrich-prospect`, {
-        linkedinUrl,
-        companyDomain,
-        force: forceRefresh,
-    });
-    markSenderEnrichmentObserved({
-        enrichmentStatus: result.enrichmentStatus,
-        caseStudies: result.caseStudies,
-        proof: result.reviews,
-    });
-    // Serialize to compact digests — strip raw blobs to save context tokens
-    const personData = (result.personData || {});
-    const companyData = (result.companyData || {});
-    const positioning = (result.positioning || {});
-    const caseStudies = result.caseStudies;
-    const reviews = result.reviews;
-    const base = {
-        clientProspectId: result.id,
-        sender: {
-            fullName: personData.fullName || "",
-            headline: personData.headline,
-            title: personData.currentPosition?.title,
-            company: personData.currentPosition?.company?.name,
-        },
-        companyDomain: result.companyDomain,
-        enrichmentStatus: result.enrichmentStatus,
-    };
-    if (result.enrichmentStatus !== "complete")
-        return base;
-    // Build compact companySnapshot
-    base.companySnapshot = {
-        name: companyData.name || "",
-        domain: companyData.domain || result.companyDomain,
-        industry: companyData.industry,
-        employeeRange: companyData.employeeRange,
-        description: companyData.description,
-        linkedinUrl: companyData.linkedinUrl,
-    };
-    // Build compact senderBackground
-    const experience = personData.experience || [];
-    base.senderBackground = {
-        experience: experience.slice(0, 4).map((exp) => ({
-            title: exp.title || "",
-            company: exp.companyName || exp.company || "",
-            duration: exp.duration,
-        })),
-        education: personData.education?.[0]?.schoolName,
-        followerCount: personData.followerCount,
-        connectionCount: personData.connectionCount,
-    };
-    // Build compact proofDigest from caseStudies + reviews + positioning
-    let caseStudyCount = 0;
-    let caseStudySummary = null;
-    if (caseStudies) {
-        try {
-            const parsed = JSON.parse(caseStudies);
-            const studies = parsed.caseStudies || [];
-            caseStudyCount = studies.length;
-            caseStudySummary = parsed.summary || null;
-        }
-        catch {
-            // ignore parse errors
-        }
-    }
-    let reviewHighlight = null;
-    if (reviews) {
-        try {
-            const parsed = JSON.parse(reviews);
-            // Cross-check review sites against confirmed company domain
-            const sites = (parsed.reviewSites || []);
-            const relevantSites = sites.filter((s) => {
-                const url = s.url || "";
-                const domain = result.companyDomain.replace(/^www\./, "");
-                const companyName = (companyData.name || "").toLowerCase();
-                return (url.includes(domain) ||
-                    url.includes(companyName.replace(/\s+/g, "-")) ||
-                    url.includes(companyName.replace(/\s+/g, "")));
-            });
-            if (relevantSites.length > 0) {
-                reviewHighlight = relevantSites
-                    .map((s) => `${s.platform}: ${s.reviewCount || "reviews found"} (${s.url})`)
-                    .join("; ");
-            }
-            // Fall back to summary if no site-level match but summary exists
-            if (!reviewHighlight && parsed.summary) {
-                reviewHighlight = parsed.summary;
-            }
-        }
-        catch {
-            // ignore parse errors
-        }
-    }
-    let positioningOneLiner = null;
-    let keyDifferentiators = [];
-    if (positioning) {
-        try {
-            const desc = typeof positioning === "string" ? JSON.parse(positioning) : positioning;
-            const descObj = typeof desc.description === "string"
-                ? JSON.parse(desc.description)
-                : desc.description || {};
-            positioningOneLiner =
-                descObj.UniqueValueProposition ||
-                    descObj.ExamplePositioningStatement ||
-                    null;
-            keyDifferentiators = descObj.keyDifferentiators || [];
-        }
-        catch {
-            // ignore parse errors
-        }
-    }
-    base.proofDigest = {
-        caseStudyCount,
-        caseStudySummary,
-        reviewHighlight,
-        positioningOneLiner,
-        keyDifferentiators,
-    };
-    return base;
-}

package/dist/tools/cli-login.d.ts

@@ -0,0 +1,80 @@
+export declare const __TEST_INTERNALS__: {
+    POLL_INTERVAL_MS: number;
+    DEFAULT_TIMEOUT_MS: number;
+    TOOL_CALL_TIMEOUT_GUARD_MS: number;
+    MAX_NETWORK_RETRIES: number;
+};
+export type StartCliLoginInput = {
+    email: string;
+};
+export type WaitForCliLoginInput = {
+    sessionId: string;
+    /** Override outer session budget (ms). Default 5 minutes. Clamped to DEFAULT_TIMEOUT_MS. */
+    timeoutMs?: number;
+    /** Test-only: override the 55s tool-call host-cap guard. Not exposed in inputSchema. */
+    toolGuardMs?: number;
+    /** Test-only: override poll interval. Not exposed in inputSchema. */
+    pollIntervalMs?: number;
+};
+type CliLoginErrorType = "rate_limited" | "send_failed" | "expired" | "already_consumed" | "timeout" | "tool_timeout_guard" | "network_error" | "not_implemented";
+type CliLoginErrorPayload = {
+    ok: false;
+    error: {
+        type: CliLoginErrorType;
+        message: string;
+        guidance: string;
+    };
+};
+type StartCliLoginSuccess = {
+    ok: true;
+    sessionId: string;
+    confirmUrl: string;
+    expiresInSec: number;
+    /** Locked verbatim string the agent shows the user. */
+    humanMessage: string;
+};
+type WaitForCliLoginSuccess = {
+    ok: true;
+    activeWorkspaceId: string;
+    activeWorkspaceName?: string;
+    configPath: string;
+    /** Locked verbatim string the agent shows the user. */
+    humanMessage: string;
+};
+export declare const startCliLoginToolDef: {
+    readonly name: "start_cli_login";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly email: {
+                readonly type: "string";
+                readonly description: "User's email — magic link is sent here.";
+            };
+        };
+        readonly required: readonly ["email"];
+        readonly additionalProperties: false;
+    };
+};
+export declare const waitForCliLoginToolDef: {
+    readonly name: "wait_for_cli_login";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sessionId: {
+                readonly type: "string";
+                readonly description: "Session ID from start_cli_login.";
+            };
+            readonly timeoutMs: {
+                readonly type: "number";
+                readonly description: "Outer session budget (ms). Default 300000 (5min). Clamped at 5min.";
+            };
+        };
+        readonly required: readonly ["sessionId"];
+        readonly additionalProperties: false;
+    };
+};
+export declare function handleStartCliLogin(args: StartCliLoginInput): Promise<StartCliLoginSuccess | CliLoginErrorPayload>;
+export declare function handleWaitForCliLogin(args: WaitForCliLoginInput): Promise<WaitForCliLoginSuccess | CliLoginErrorPayload>;
+export {};