context-doctor 0.30.0 → 0.30.1

package/dist/desktopusage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * How Claude Desktop's chat actually uses the MCP server, from Desktop's own
+ * log. Desktop gives an MCP server no hook and no transcript, so its
+ * per-server log (mcp-server-context-doctor.log: initialize, tools/list,
+ * tools/call) is the only evidence that the tools are offered and called.
+ * Desktop does not log which pages are opened, so chat activity itself cannot
+ * be measured locally; Code-tab sessions can (Claude Code transcripts record
+ * the desktop app as their entrypoint), and those reach context-doctor
+ * through Claude Code's hook and MCP config, not through this server.
+ */
+export interface DesktopUsage {
+    launches: number;
+    toolLists: number;
+    toolCalls: number;
+    lastCall?: string;
+}
+export declare function desktopLogDir(home?: string): string;
+export declare function desktopUsage(dir?: string): DesktopUsage | undefined;
+/** One line for `doctor`: the numbers, and what to do with them. `codeTabSessions`: this week's Claude Code sessions run in Desktop's Code tab. */
+export declare function describeDesktopUsage(u: DesktopUsage, codeTabSessions?: number): string;

package/dist/desktopusage.js

@@ -0,0 +1,35 @@
+/**
+ * How Claude Desktop's chat actually uses the MCP server, from Desktop's own
+ * log. Desktop gives an MCP server no hook and no transcript, so its
+ * per-server log (mcp-server-context-doctor.log: initialize, tools/list,
+ * tools/call) is the only evidence that the tools are offered and called.
+ * Desktop does not log which pages are opened, so chat activity itself cannot
+ * be measured locally; Code-tab sessions can (Claude Code transcripts record
+ * the desktop app as their entrypoint), and those reach context-doctor
+ * through Claude Code's hook and MCP config, not through this server.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+export function desktopLogDir(home = homedir()) {
+    switch (platform()) {
+        case "darwin": return join(home, "Library", "Logs", "Claude");
+        case "win32": return join(process.env.APPDATA ?? join(home, "AppData", "Roaming"), "Claude", "logs");
+        default: return join(home, ".config", "Claude", "logs");
+    }
+}
+export function desktopUsage(dir = desktopLogDir()) {
+    const server = join(dir, "mcp-server-context-doctor.log");
+    if (!existsSync(server))
+        return undefined;
+    const text = readFileSync(server, "utf8");
+    const count = (m) => text.split(`method="${m}"`).length - 1;
+    const calls = [...text.matchAll(/^(\d{4}-\d\d-\d\d)T[^\n]*method="tools\/call"/gm)];
+    return { launches: count("initialize"), toolLists: count("tools/list"), toolCalls: count("tools/call"), lastCall: calls.at(-1)?.[1] };
+}
+/** One line for `doctor`: the numbers, and what to do with them. `codeTabSessions`: this week's Claude Code sessions run in Desktop's Code tab. */
+export function describeDesktopUsage(u, codeTabSessions = 0) {
+    const base = `tools offered in ${u.toolLists} of ${u.launches} launches, called ${u.toolCalls} time(s)${u.lastCall ? ` (last ${u.lastCall})` : ""}`;
+    const code = codeTabSessions > 0 ? `; your ${codeTabSessions} Code-tab sessions this week use the hook instead` : "";
+    return `${base}${code}. In a chat the model decides when to call them: the + menu's context_checkup prompt runs one on demand`;
+}

package/dist/doctor.js

@@ -14,6 +14,7 @@ import { fileURLToPath } from "node:url";
 import { ledgerPath } from "./ledger.js";
 import { loadConfig } from "./config.js";
 import { geminiCliPresent, geminiSettingsPath } from "./install.js";
+import { describeDesktopUsage, desktopUsage } from "./desktopusage.js";
 function claudeDesktopConfigPath() {
     switch (platform()) {
         case "darwin": return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
@@ -108,6 +109,10 @@ function checkMcpHandshake() {
 export async function runDoctor() {
     const checks = [];
     checks.push(checkMcpEntry("Claude Desktop", claudeDesktopConfigPath()));
+    // Desktop chat has no hook or transcript; its own logs are the only evidence the tools are used.
+    const desktop = desktopUsage();
+    if (desktop)
+        checks.push({ label: "Desktop chat tool use", status: "ok", detail: describeDesktopUsage(desktop, recentSurfaces(7).get("claude-desktop") ?? 0) });
     checks.push(checkMcpEntry("Claude Code", join(homedir(), ".claude.json")));
     checks.push(checkMcpEntry("Cursor", join(homedir(), ".cursor", "mcp.json")));
     // Hook registration

package/dist/mcp.js

@@ -52,7 +52,7 @@ const STRATEGY_IDS = ["dedupe", "trim-tool-results", "trim-tool-calls", "strip-b
  * recommended pattern.
  */
 function createServer({ fileAccess = true } = {}) {
-    const server = new McpServer({ name: "context-doctor", version: "0.30.0" }, { instructions: SERVER_INSTRUCTIONS });
+    const server = new McpServer({ name: "context-doctor", version: "0.30.1" }, { instructions: SERVER_INSTRUCTIONS });
     server.tool("profile_context", "Profile an LLM conversation or prompt: token breakdown, largest blocks, and actionable findings about wasted context (duplicates, oversized pastes or tool results, base64 blobs, long history). Two inputs, pass ONE: `conversation` (full OpenAI/Anthropic JSON or raw text, for agents, files and proxies) or `sketch` (for chat apps such as Claude Desktop or ChatGPT where you cannot export the conversation: the turn count plus the few blocks that matter, ~120 tokens to write). Call it whenever the user asks about token usage, context size, cost, speed or limits, and on your own once the conversation passes ~30 turns or holds 3+ large pastes. Act on the top finding in your reply.", {
         conversation: z.string().optional().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array) or raw prompt text. Omit in chat apps and pass `sketch`."),
         sketch: z.object({

package/dist/proxy.d.ts

@@ -48,7 +48,7 @@ export interface ProxyOptions extends OptimizeOptions {
     googleUpstream?: string;
 }
 /** Reported by /health so `autopilot status` can tell an outdated service from a current one. */
-export declare const PROXY_VERSION = "0.30.0";
+export declare const PROXY_VERSION = "0.30.1";
 /**
  * Remove a leading `/t/<token>` from a request path, or return undefined when
  * the prefix is absent or the token differs. The comparison is constant time

package/dist/proxy.js

@@ -20,7 +20,7 @@ import { formatTokens, CHARS_PER_TOKEN, providerFor } from "./tokens.js";
 import { formatUsd, inputCostUsd, pricingFor } from "./pricing.js";
 import { recordLedger } from "./ledger.js";
 /** Reported by /health so `autopilot status` can tell an outdated service from a current one. */
-export const PROXY_VERSION = "0.30.0";
+export const PROXY_VERSION = "0.30.1";
 /** Connection-level headers that must not be forwarded. */
 const SKIP_REQUEST_HEADERS = new Set(["host", "content-length", "connection", "transfer-encoding", "accept-encoding", "expect"]);
 const SKIP_RESPONSE_HEADERS = new Set(["content-length", "content-encoding", "transfer-encoding", "connection"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-doctor",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "description": "Cut your Claude Code bill, measured on your own sessions: `npx context-doctor savings` shows what each lever saves, then the hook, autopilot and an earlier auto-compact window do it. Also Cursor, Codex, Claude Desktop and any Anthropic or OpenAI API app. MCP server and Claude Code plugin.",
   "keywords": [
     "agent",