@askthew/mcp-plugin 0.4.7 → 0.4.9

package/dist/index.js

@@ -1,6 +1,8 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { spawn } from "node:child_process";
 import fs from "node:fs";
+import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { z } from "zod";
@@ -9,9 +11,18 @@ import { resolveMcpMode } from "./lib/free-tier-policy.js";
 import { LocalStore } from "./lib/local-store.js";
 import { buildTelemetryPayload, flushTelemetryOutbox } from "./lib/telemetry.js";
 import { ensureLocalIdentity } from "./lib/local-identity.js";
-import { buildLocalTimeline, buildTimelineInsights as buildLocalTimelineInsights, renderTimelineMarkdown as renderLocalTimelineMarkdown } from "./lib/timeline-insights.js";
 import { paidDescription, paidFeatureNudge, toolJson } from "./lib/upgrade-nudge.js";
 import { configPath, readJsonFile } from "./lib/paths.js";
+const requirePackageJson = createRequire(import.meta.url);
+function packageVersion() {
+    try {
+        const manifest = requirePackageJson("../package.json");
+        return typeof manifest.version === "string" ? manifest.version : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
 const evidenceRoleSchema = z.enum(["user", "assistant", "system"]);
 const evidenceEntrySchema = z.object({
     role: evidenceRoleSchema,
@@ -569,7 +580,7 @@ export function createAskTheWMcpServer(options = {}) {
     }
     const server = new McpServer({
         name: "Ask The W Coding Agent Connector",
-        version: "0.4.7",
+        version: packageVersion(),
     });
     if (options.sendStartupHeartbeat !== false && mode.mode === "paid") {
         void sendStartupSignals(options);
@@ -655,6 +666,89 @@ export function createAskTheWMcpServer(options = {}) {
         }
         return null;
     };
+    const localSessionAnalysisResponse = (payload) => {
+        if (!localStore) {
+            return localToolError({
+                code: "local_store_unavailable",
+                message: "The local Ask The W store is unavailable.",
+                retryable: true,
+                hint: "Retry after restarting the plugin host.",
+            });
+        }
+        const loginRequired = requireFreeIdentity();
+        if (loginRequired)
+            return loginRequired;
+        const scopeKey = currentScopeKey();
+        const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
+        const allSessionIds = localStore.listSessionIds({ limit: 100000, scopeKey });
+        const allowedSessionIds = new Set(allSessionIds.slice(0, 3));
+        if (sessionId && allSessionIds.length > 3 && !allowedSessionIds.has(sessionId)) {
+            return localToolError({
+                code: "free_tier_limit",
+                message: "The free plugin can analyze the latest three local sessions.",
+                retryable: false,
+                hint: "Upgrade to review more than three sessions in the workspace dashboard.",
+                extra: {
+                    tool: "analyze_session",
+                    limit: 3,
+                    upgradeUrl: "https://askthew.com/plugin?utm_source=mcp-plugin&utm_medium=tool-nudge&utm_campaign=mcp-free&tool=analyze_session",
+                    cta: "Upgrade to analyze more than three sessions in the workspace dashboard.",
+                },
+            });
+        }
+        const limit = Math.min(50, payload.limit ?? 50);
+        const signals = sessionId
+            ? localStore.listSignals({ sessionId, scopeKey, cursor: payload.cursor, limit })
+            : [];
+        const allSignals = sessionId ? localStore.listSignals({ sessionId, scopeKey, limit: 100000 }) : [];
+        const decisions = sessionId
+            ? localStore.listDecisions({ sessionId, scopeKey, limit: 100000 })
+            : [];
+        const decisionCandidates = listDecisionCandidates({ store: localStore, sessionId, scopeKey, limit: 25 }).candidates;
+        const counts = signals.reduce((accumulator, signal) => {
+            accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
+            return accumulator;
+        }, {});
+        const allCounts = allSignals.reduce((accumulator, signal) => {
+            accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
+            return accumulator;
+        }, {});
+        const nextCursor = signals.length >= limit ? signals.at(-1)?.capturedAt ?? null : null;
+        if ((payload.format ?? "markdown") === "json") {
+            return budgetedLocalResponse({
+                ok: true,
+                tier: "free",
+                sessionId,
+                format: "json",
+                signals: payload.compact
+                    ? signals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id)))
+                    : signals.map((signal) => signalWithDecision(localStore, signal)),
+                decisions: payload.compact
+                    ? decisions.map((decision) => ({ id: decision.id, headline: decision.headline, status: decision.status, signalIds: decision.sourceSignalIds }))
+                    : decisions.map((decision) => decisionWithSignals(localStore, decision)),
+                decisionCandidates,
+                nextCursor,
+                counts: {
+                    totalSignals: allSignals.length,
+                    byKind: allCounts,
+                },
+            }, payload.max_chars);
+        }
+        return budgetedLocalResponse({
+            ok: true,
+            tier: "free",
+            sessionId,
+            format: "markdown",
+            rendered: renderSessionMarkdown({ sessionId, signals: allSignals, decisions, decisionCandidates }),
+            ...(payload.compact
+                ? { signals: allSignals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id))) }
+                : {}),
+            counts: {
+                totalSignals: allSignals.length,
+                byKind: Object.keys(allCounts).length ? allCounts : counts,
+            },
+        }, payload.max_chars);
+    };
     server.tool("capture_session_signal", {
         sessionId: z.string().min(1),
         sequence: z.number().int().nonnegative(),
@@ -973,18 +1067,7 @@ export function createAskTheWMcpServer(options = {}) {
         idempotencyKey: idempotencyKeySchema,
     }, async (payload) => {
         if (mode.mode !== "paid" && localStore) {
-            const loginRequired = requireFreeIdentity();
-            if (loginRequired)
-                return loginRequired;
-            if (payload.confirmText !== payload.id) {
-                return localToolError({
-                    code: "confirmation_required",
-                    message: "confirmText must match the decision id.",
-                    retryable: false,
-                    hint: "Pass the exact decision id as confirmText.",
-                });
-            }
-            return localResponse({ ok: localStore.deleteDecision(payload.id), tier: "free" });
+            return localResponse(paidFeatureNudge("delete_decision"));
         }
         return apiToolResponse(`/api/decisions/${encodeURIComponent(payload.id)}`, {
             confirmText: payload.confirmText,
@@ -1138,31 +1221,7 @@ export function createAskTheWMcpServer(options = {}) {
         max_chars: maxCharsSchema,
     }, async (payload) => {
         if (mode.mode !== "paid" && localStore) {
-            const loginRequired = requireFreeIdentity();
-            if (loginRequired)
-                return loginRequired;
-            const normalizedQuery = payload.query.toLowerCase();
-            const signals = localStore
-                .listSignals({
-                limit: 100000,
-                sessionId: payload.sessionId,
-                scopeKey: currentScopeKey(),
-            })
-                .filter((signal) => [
-                signal.summary,
-                signal.kind,
-                ...signal.filesTouched,
-                ...signal.commandsRun,
-            ].join("\n").toLowerCase().includes(normalizedQuery))
-                .slice(0, payload.limit);
-            return budgetedLocalResponse({
-                ok: true,
-                tier: "free",
-                query: payload.query,
-                signals: payload.compact === false
-                    ? signals.map((signal) => signalWithDecision(localStore, signal))
-                    : signals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id))),
-            }, payload.max_chars ?? 8000);
+            return localResponse(paidFeatureNudge("find_signal_by_summary"));
         }
         return apiToolResponse(routeWithQuery("/api/signals", {
             query: payload.query,
@@ -1201,6 +1260,8 @@ export function createAskTheWMcpServer(options = {}) {
         compact: z.boolean().optional(),
         max_chars: maxCharsSchema,
     }, async (payload) => {
+        if (mode.mode !== "paid")
+            return localResponse(paidFeatureNudge("review_decisions"));
         if (mode.mode === "paid") {
             return apiToolResponse(routeWithQuery("/api/decisions", {
                 since: payload.since,
@@ -1212,42 +1273,7 @@ export function createAskTheWMcpServer(options = {}) {
                 max_chars: payload.max_chars,
             }));
         }
-        if (!localStore) {
-            return localToolError({
-                code: "local_store_unavailable",
-                message: "The local Ask The W store is unavailable.",
-                retryable: true,
-                hint: "Retry after restarting the plugin host.",
-            });
-        }
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const decisions = localStore.listDecisions({
-            since: payload.since,
-            status: payload.status,
-            limit: payload.limit,
-            cursor: payload.cursor,
-            sessionId: payload.sessionId,
-            scopeKey: currentScopeKey(),
-        });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            format: payload.format,
-            rendered: renderDecisionDigest(decisions),
-            decisions: payload.compact
-                ? decisions.map((decision) => ({
-                    id: decision.id,
-                    headline: decision.headline,
-                    status: decision.status,
-                    signalIds: decision.sourceSignalIds,
-                }))
-                : decisions.map((decision) => decisionWithSignals(localStore, decision)),
-            count: decisions.length,
-            nextCursor: decisions.length >= payload.limit ? decisions.at(-1)?.createdAt ?? null : null,
-            copyHint: "Copy this output to back up your decisions - `export_decisions` is a paid feature.",
-        }, payload.max_chars);
+        return localResponse(paidFeatureNudge("review_decisions"));
     });
     server.tool("review_session", "Review the current session trail. Use for natural prompts like: Show me my session trail.", {
         sessionId: z.string().optional(),
@@ -1257,6 +1283,8 @@ export function createAskTheWMcpServer(options = {}) {
         compact: z.boolean().optional(),
         max_chars: maxCharsSchema,
     }, async (payload) => {
+        if (mode.mode !== "paid")
+            return localResponse(paidFeatureNudge("review_session"));
         if (!localStore || mode.mode === "paid") {
             return apiToolResponse(routeWithQuery("/api/signals", {
                 sessionId: payload.sessionId,
@@ -1266,79 +1294,26 @@ export function createAskTheWMcpServer(options = {}) {
                 max_chars: payload.max_chars,
             }));
         }
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const scopeKey = currentScopeKey();
-        const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
-        const allSessionIds = localStore.listSessionIds({ limit: 100000, scopeKey });
-        const allowedSessionIds = new Set(allSessionIds.slice(0, 3));
-        if (sessionId && allSessionIds.length > 3 && !allowedSessionIds.has(sessionId)) {
-            return localToolError({
-                code: "free_tier_limit",
-                message: "The free plugin can review the latest three local sessions.",
-                retryable: false,
-                hint: "Upgrade to review more than three sessions in the workspace dashboard.",
-                extra: {
-                    tool: "review_session",
-                    limit: 3,
-                    upgradeUrl: "https://askthew.com/plugin?utm_source=mcp-plugin&utm_medium=tool-nudge&utm_campaign=mcp-free&tool=review_session",
-                    cta: "Upgrade to review more than three sessions in the workspace dashboard.",
-                },
-            });
-        }
-        const limit = Math.min(50, payload.limit ?? 50);
-        const signals = sessionId
-            ? localStore.listSignals({ sessionId, scopeKey, cursor: payload.cursor, limit })
-            : [];
-        const allSignals = sessionId ? localStore.listSignals({ sessionId, scopeKey, limit: 100000 }) : [];
-        const decisions = sessionId
-            ? localStore.listDecisions({ sessionId, scopeKey, limit: 100000 })
-            : [];
-        const decisionCandidates = listDecisionCandidates({ store: localStore, sessionId, scopeKey, limit: 25 }).candidates;
-        const counts = signals.reduce((accumulator, signal) => {
-            accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
-            return accumulator;
-        }, {});
-        const allCounts = allSignals.reduce((accumulator, signal) => {
-            accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
-            return accumulator;
-        }, {});
-        const nextCursor = signals.length >= limit ? signals.at(-1)?.capturedAt ?? null : null;
-        if (payload.format === "json") {
-            return budgetedLocalResponse({
-                ok: true,
-                tier: "free",
-                sessionId,
-                format: "json",
-                signals: payload.compact
-                    ? signals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id)))
-                    : signals.map((signal) => signalWithDecision(localStore, signal)),
-                decisions: payload.compact
-                    ? decisions.map((decision) => ({ id: decision.id, headline: decision.headline, status: decision.status, signalIds: decision.sourceSignalIds }))
-                    : decisions.map((decision) => decisionWithSignals(localStore, decision)),
-                decisionCandidates,
-                nextCursor,
-                counts: {
-                    totalSignals: allSignals.length,
-                    byKind: allCounts,
-                },
-            }, payload.max_chars);
+        return localResponse(paidFeatureNudge("review_session"));
+    });
+    server.tool("analyze_session", "Analyze the latest local coding-agent session.", {
+        sessionId: z.string().optional(),
+        format: z.enum(["markdown", "json"]).default("markdown"),
+        cursor: cursorSchema,
+        limit: z.number().int().positive().max(50).default(50),
+        compact: z.boolean().optional(),
+        max_chars: maxCharsSchema,
+    }, async (payload) => {
+        if (!localStore || mode.mode === "paid") {
+            return apiToolResponse(routeWithQuery("/api/signals", {
+                sessionId: payload.sessionId,
+                cursor: payload.cursor,
+                limit: payload.limit,
+                compact: payload.compact,
+                max_chars: payload.max_chars,
+            }));
         }
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            sessionId,
-            format: "markdown",
-            rendered: renderSessionMarkdown({ sessionId, signals: allSignals, decisions, decisionCandidates }),
-            ...(payload.compact
-                ? { signals: allSignals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id))) }
-                : {}),
-            counts: {
-                totalSignals: allSignals.length,
-                byKind: Object.keys(allCounts).length ? allCounts : counts,
-            },
-        }, payload.max_chars);
+        return localSessionAnalysisResponse(payload);
     });
     server.tool("recap", "Summarize the latest local coding-agent session as a digest, standup, or share-ready recap.", {
         format: z.enum(["digest", "standup", "share"]).default("digest"),
@@ -1474,27 +1449,14 @@ export function createAskTheWMcpServer(options = {}) {
         cursor: cursorSchema,
         max_chars: maxCharsSchema,
     }, async (payload) => {
-        if (!localStore || mode.mode === "paid")
+        if (mode.mode !== "paid")
             return localResponse(paidFeatureNudge("list_decision_candidates"));
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const scopeKey = currentScopeKey();
-        const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
-        const result = listDecisionCandidates({
-            store: localStore,
-            sessionId,
-            scopeKey,
+        return apiToolResponse(routeWithQuery("/api/signals/decision-candidates", {
+            sessionId: payload.sessionId,
             limit: payload.limit,
             cursor: payload.cursor,
-        });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            sessionId,
-            decisionCandidates: result.candidates,
-            nextCursor: result.nextCursor,
-        }, payload.max_chars);
+            max_chars: payload.max_chars,
+        }));
     });
     server.tool("search_trail", "Search local signals and decisions together.", {
         query: z.string().min(1),
@@ -1504,27 +1466,16 @@ export function createAskTheWMcpServer(options = {}) {
         compact: z.boolean().optional(),
         max_chars: maxCharsSchema,
     }, async (payload) => {
-        if (!localStore || mode.mode === "paid")
+        if (mode.mode !== "paid")
             return localResponse(paidFeatureNudge("search_trail"));
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const result = searchTrail({
-            store: localStore,
+        return apiToolResponse(routeWithQuery("/api/search/trail", {
             query: payload.query,
-            scopeKey: currentScopeKey(),
             sessionId: payload.sessionId,
             limit: payload.limit,
             cursor: payload.cursor,
             compact: payload.compact,
-        });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            query: payload.query,
-            matches: result.matches,
-            nextCursor: result.nextCursor,
-        }, payload.max_chars);
+            max_chars: payload.max_chars,
+        }));
     });
     server.tool("export_decisions", paidDescription("Export decisions from your workspace.", mode.mode), {
         format: z.enum(["json", "markdown", "jsonl"]).default("json"),
@@ -1562,44 +1513,7 @@ export function createAskTheWMcpServer(options = {}) {
                 signalSource: payload.signalSource,
             }));
         }
-        if (!localStore) {
-            return localToolError({
-                code: "local_store_unavailable",
-                message: "The local Ask The W store is unavailable.",
-                retryable: true,
-                hint: "Retry after restarting the plugin host.",
-            });
-        }
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const scopeKey = currentScopeKey();
-        const points = buildLocalTimeline({
-            scope: payload.scope,
-            signals: localStore.listSignals({ scopeKey, limit: 100000 }),
-            decisions: localStore.listDecisions({ scopeKey, limit: 100000 }),
-            limit: payload.limit,
-        });
-        const totals = points.reduce((accumulator, point) => ({
-            signals: accumulator.signals + point.signalCount,
-            decisions: accumulator.decisions + point.decisionCount,
-        }), { signals: 0, decisions: 0 });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            scope: payload.scope,
-            period: {
-                start: points[0]?.startedAt ?? points[0]?.x ?? "",
-                end: points.at(-1)?.endedAt ?? points.at(-1)?.x ?? "",
-                label: "Local timeline",
-                tz: "UTC",
-            },
-            points,
-            totals,
-            insights: buildLocalTimelineInsights(points),
-            narrative: `Local timeline: ${totals.signals} signals, ${totals.decisions} decisions.`,
-            markdownTable: renderLocalTimelineMarkdown(points, payload.scope),
-        }, payload.max_chars);
+        return localResponse(paidFeatureNudge("view_timeline"));
     });
     return server;
 }
@@ -1914,16 +1828,96 @@ const isDirectIndexExecution = Boolean(process.argv[1]) &&
             return invokedPath === modulePath;
         }
     })();
-if (isDirectIndexExecution) {
-    const server = createAskTheWMcpServer();
-    const transport = new StdioServerTransport();
-    server.connect(transport).catch((error) => {
-        if (error instanceof Error) {
-            console.error(error.message);
-        }
-        else {
-            console.error("Ask The W MCP server failed to start.", error);
-        }
-        process.exit(1);
+export async function runInitializeHandshake(input = {}) {
+    const modulePath = input.entrypoint ?? fileURLToPath(import.meta.url);
+    const child = spawn(process.execPath, [modulePath], {
+        cwd: process.cwd(),
+        env: input.env ?? process.env,
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8");
+    child.stderr.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+        stdout += chunk;
     });
+    child.stderr.on("data", (chunk) => {
+        stderr += chunk;
+    });
+    const initialize = {
+        jsonrpc: "2.0",
+        id: 1,
+        method: "initialize",
+        params: {
+            protocolVersion: "2024-11-05",
+            capabilities: {},
+            clientInfo: { name: "askthew-initialize-handshake", version: "1.0.0" },
+        },
+    };
+    child.stdin.write(`${JSON.stringify(initialize)}\n`);
+    try {
+        return await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error(`Timed out waiting for initialize response. stdout=${stdout} stderr=${stderr}`));
+            }, input.timeoutMs ?? 3000);
+            const failOnExit = (code) => {
+                clearTimeout(timeout);
+                reject(new Error(`MCP stdio server exited before initialize. code=${code} stdout=${stdout} stderr=${stderr}`));
+            };
+            const check = () => {
+                const lineEnd = stdout.indexOf("\n");
+                if (lineEnd === -1)
+                    return;
+                clearTimeout(timeout);
+                child.off("exit", failOnExit);
+                const response = JSON.parse(stdout.slice(0, lineEnd));
+                if (response.id !== 1 || response.jsonrpc !== "2.0" || !response.result) {
+                    reject(new Error(`Unexpected initialize response: ${JSON.stringify(response)}`));
+                    return;
+                }
+                resolve({
+                    serverInfoVersion: typeof response.result?.serverInfo?.version === "string"
+                        ? response.result.serverInfo.version
+                        : undefined,
+                });
+            };
+            child.stdout.on("data", check);
+            child.once("exit", failOnExit);
+            check();
+        });
+    }
+    finally {
+        child.kill();
+    }
+}
+if (isDirectIndexExecution) {
+    if (process.argv[2] === "initialize-handshake") {
+        runInitializeHandshake()
+            .then(() => {
+            console.log("Ask The W MCP initialize handshake succeeded.");
+        })
+            .catch((error) => {
+            if (error instanceof Error) {
+                console.error(error.message);
+            }
+            else {
+                console.error("Ask The W MCP initialize handshake failed.", error);
+            }
+            process.exit(1);
+        });
+    }
+    else {
+        const server = createAskTheWMcpServer();
+        const transport = new StdioServerTransport();
+        server.connect(transport).catch((error) => {
+            if (error instanceof Error) {
+                console.error(error.message);
+            }
+            else {
+                console.error("Ask The W MCP server failed to start.", error);
+            }
+            process.exit(1);
+        });
+    }
 }

package/dist/install.d.ts

@@ -9,6 +9,7 @@ interface HostConfigInput {
     free?: boolean;
     email?: string;
     cwd?: string;
+    serverEntrypoint?: string;
 }
 interface InstallHostConfigInput extends HostConfigInput {
     dryRun?: boolean;
@@ -18,10 +19,26 @@ interface InstallHostConfigInput extends HostConfigInput {
 interface UninstallHostConfigInput {
     hostType: SupportedHostType;
     serverName?: string;
+    cwds?: string[];
     dryRun?: boolean;
     homeDirectory?: string;
     cwd?: string;
 }
+export declare const DEFAULT_FREE_SERVER_NAME = "askthew-free";
+export declare const DEFAULT_WORKSPACE_SERVER_NAME = "askthew-workspace";
+export interface InstallReceipt {
+    hostType: SupportedHostType;
+    serverName: string;
+    settingsPath: string;
+    cwd: string;
+    instructionPaths: string[];
+    dataDir: string;
+    serverEntrypoint?: string;
+    installedAt: string;
+    packageVersion?: string;
+}
+export declare function packageVersion(): string;
+export declare function defaultServerNameForTier(free?: boolean): "askthew-free" | "askthew-workspace";
 export declare function resolveSettingsPath(input: {
     hostType: SupportedHostType;
     homeDirectory?: string;
@@ -107,14 +124,46 @@ export declare function installHostConfig(input: InstallHostConfigInput): {
     wroteFile: boolean;
     nextStep: string;
 };
+export declare function readInstallReceipts(env?: NodeJS.ProcessEnv): InstallReceipt[];
+export declare function writeInstallReceipt(receipt: Omit<InstallReceipt, "dataDir" | "installedAt"> & {
+    dataDir?: string;
+    installedAt?: string;
+}, env?: NodeJS.ProcessEnv): InstallReceipt;
+export declare function findInstallReceipts(input: {
+    hostType: SupportedHostType;
+    serverName?: string;
+}, env?: NodeJS.ProcessEnv): InstallReceipt[];
+export declare function removeInstallReceipts(input: {
+    hostType: SupportedHostType;
+    serverName?: string;
+    cwd?: string;
+}, env?: NodeJS.ProcessEnv): number;
 export declare function uninstallHostConfig(input: UninstallHostConfigInput): {
     settingsPath: string;
     json: string;
     removedServerName: string;
+    removedServerNames: string[];
     foundConfigFile: boolean;
     removedServer: boolean;
     wroteFile: boolean;
 };
+export declare function upgradePinnedHostConfig(input: {
+    hostType: SupportedHostType;
+    serverName?: string;
+    packageSpec?: string;
+    dryRun?: boolean;
+    homeDirectory?: string;
+    cwd?: string;
+    cwds?: string[];
+}): {
+    settingsPath: string;
+    json: string;
+    packageSpec: string;
+    foundConfigFile: boolean;
+    upgradedServer: boolean;
+    upgradedServerNames: string[];
+    wroteFile: boolean;
+};
 export declare function sendInstallHeartbeat(input: HostConfigInput & {
     cwd?: string;
     fetchImpl?: typeof fetch;