context-doctor 0.3.6 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # context-doctor 🩺
2
2
 
3
+ [![CI](https://github.com/KushalP1/context-doctor/actions/workflows/ci.yml/badge.svg)](https://github.com/KushalP1/context-doctor/actions) [![npm](https://img.shields.io/npm/v/context-doctor)](https://www.npmjs.com/package/context-doctor)
4
+
3
5
  **See what's eating your LLM context window — and fix it.**
4
6
 
5
7
  Every long-running LLM conversation slowly fills up with junk: duplicated documents, 10k-token tool outputs nobody reads again, base64 blobs, stale history. You pay for those tokens on **every single call**, and model quality drops as the window fills.
@@ -93,7 +95,8 @@ Practical upshot: a developer who only wants cheaper, faster API calls never tou
93
95
  | `context-doctor session [file]` | Profile a Claude Code session transcript (defaults to your most recent; `--list` to browse) |
94
96
  | `context-doctor report` | Machine-wide impact report: exact proxy savings, hook activity, recoverable waste in recent sessions |
95
97
  | `context-doctor proxy` | Always-on local proxy that optimizes every Anthropic/OpenAI API request in flight (`/stats` for cumulative savings) |
96
- | `context-doctor hook` | The every-prompt Claude Code hook (registered by `install`; you never run this yourself) |
98
+ | `context-doctor hook` | The every-prompt Claude Code hook (registered by `install`; you never run this yourself). Warning threshold tunable via `CONTEXT_DOCTOR_WARN_TOKENS` (default 80000) |
99
+ | `context-doctor-mcp` | The MCP server itself — stdio by default (what the installer wires); `--http [--port 8808] [--host H]` serves streamable HTTP at `/mcp` for URL-based clients like ChatGPT developer-mode connectors |
97
100
 
98
101
  ## What "always-on" means, per surface
99
102
 
@@ -175,7 +178,7 @@ Because prompt caching matches byte-identical prefixes, deterministic strategies
175
178
  | Claude Desktop | `npx context-doctor install` writes the config — just restart the app |
176
179
  | Claude Code | Same command — MCP + skill + every-prompt hook, all automatic |
177
180
  | Cursor | Same command — writes `~/.cursor/mcp.json` |
178
- | ChatGPT desktop | **Manual, one time** (ChatGPT's connectors live inside its own settings): Settings Connectors Developer mode add local server, command `npx`, args `-y context-doctor-mcp` |
181
+ | ChatGPT (developer mode) | **Manual + a reachable URL** ChatGPT connects to servers over the internet, never local commands. Run `context-doctor-mcp --http` on a host/tunnel, then add the URL as a connector. Normal ChatGPT (no dev mode) has no MCP — use the CLI |
179
182
 
180
183
  For any other MCP client, the server entry is:
181
184
 
@@ -197,14 +200,15 @@ For any other MCP client, the server entry is:
197
200
  3. Chat normally. When a conversation grows heavy, Claude proactively offers: *"this chat is getting large — want me to profile it?"* — or you ask *"what's eating my context?"* and it calls `profile_context` and shows the token/cost breakdown.
198
201
  4. Say *"optimize it"* and Claude applies the safe fixes; if you agree to pruning old history, **Claude itself writes the replacement summary** (that's the no-API-key summarization).
199
202
 
200
- ### How it works in ChatGPT, step by step
203
+ ### How it works in ChatGPT, step by step (honest version)
204
+
205
+ ChatGPT's MCP support differs fundamentally from Claude Desktop's: **it never spawns local processes**. Its custom connectors (developer mode) have OpenAI's servers connect to a **URL** — so the MCP server must be reachable from the internet.
201
206
 
202
- 1. ChatGPT's desktop app supports MCP in **developer mode**: Settings Connectors Advanced Developer mode, then add a local MCP server with command `npx` and args `-y context-doctor-mcp`.
203
- 2. Enable the connector in a chat. GPT sees the same three tools with the same trigger guidance baked into their descriptions.
204
- 3. Ask *"profile this conversation"* or paste an exported chat and ask *"what's eating my context?"* GPT calls `profile_context` and reports the breakdown; *"optimize it"* works the same, including GPT writing the pruning summary itself.
205
- 4. Caveat: how prominently standing server instructions surface varies by ChatGPT version — the tool descriptions carry the trigger rules regardless, so profiling still fires on the right questions.
207
+ 1. **Normal ChatGPT (no developer mode): no MCP at all.** context-doctor still helps via the CLI: export the conversation and run `npx context-doctor analyze chat.json --model gpt-5` / `optimize` no account settings required.
208
+ 2. **ChatGPT developer mode**: run our HTTP transport somewhere reachable — `context-doctor-mcp --http --port 8808` on a small host (bind `--host 0.0.0.0` there), or expose your machine temporarily with a tunnel (`ngrok http 8808`). Then Settings → Connectors → Advanced → Developer mode → add connector with URL `https://<your-host>/mcp`.
209
+ 3. Once connected, GPT gets the same three tools with the same trigger guidance: ask *"what's eating my context?"* it calls `profile_context`; *"optimize it"* works the same, including GPT writing the pruning summary itself.
206
210
 
207
- For ChatGPT on the web (no MCP): export the conversation and use the CLI `npx context-doctor analyze chat.json --model gpt-5`.
211
+ Security note for step 2: the HTTP endpoint is unauthenticated put it behind your tunnel's auth or a reverse proxy if it stays up long-term.
208
212
 
209
213
  ### claude.ai on the web
210
214
 
package/dist/hook.js CHANGED
@@ -17,8 +17,8 @@ import { profileConversation } from "./profile.js";
17
17
  import { parseSessionFile } from "./session.js";
18
18
  import { formatTokens } from "./tokens.js";
19
19
  import { formatUsd } from "./pricing.js";
20
- /** Start nudging at 80k tokens of context. */
21
- const WARN_TOKENS = 80_000;
20
+ /** Start nudging at 80k tokens of context (override: CONTEXT_DOCTOR_WARN_TOKENS). */
21
+ const WARN_TOKENS = Number(process.env.CONTEXT_DOCTOR_WARN_TOKENS) > 0 ? Number(process.env.CONTEXT_DOCTOR_WARN_TOKENS) : 80_000;
22
22
  /** Re-nudge only after the context grows another 40% — one reminder, not a nag. */
23
23
  const REGROWTH_FACTOR = 1.4;
24
24
  /**
package/dist/install.js CHANGED
@@ -167,5 +167,13 @@ export function runUninstall() {
167
167
  console.log("✓ Agent Skill removed");
168
168
  }
169
169
  uninstallHook();
170
+ // Remove our bookkeeping files too — uninstall means gone.
171
+ for (const file of [".context-doctor-hook-state.json", ".context-doctor-ledger.jsonl"]) {
172
+ const p = join(homedir(), ".claude", file);
173
+ if (existsSync(p)) {
174
+ rmSync(p);
175
+ console.log(`✓ Removed ${file}`);
176
+ }
177
+ }
170
178
  console.log("Done.");
171
179
  }
package/dist/ledger.js CHANGED
@@ -8,7 +8,7 @@
8
8
  * (pre-0.3.6 hook entries have no `ev` field; treated as checks)
9
9
  * optimize — an optimization was applied {ev: "optimize", src: "cli"|"mcp", saved, model?}
10
10
  */
11
- import { appendFileSync, existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
11
+ import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
12
12
  import { homedir } from "node:os";
13
13
  import { dirname, join } from "node:path";
14
14
  export function statePath() {
@@ -20,6 +20,9 @@ export function ledgerPath() {
20
20
  export function recordLedger(entry) {
21
21
  const path = ledgerPath();
22
22
  try {
23
+ // Claude-Desktop-only machines have no ~/.claude — create it so their
24
+ // optimize events count in `context-doctor report` too.
25
+ mkdirSync(dirname(path), { recursive: true });
23
26
  // Cap growth: past ~256KB keep the most recent 500 entries.
24
27
  if (existsSync(path) && statSync(path).size > 256 * 1024) {
25
28
  const lines = readFileSync(path, "utf8").trimEnd().split("\n");
package/dist/mcp.js CHANGED
@@ -30,63 +30,77 @@ import { recordLedger } from "./ledger.js";
30
30
  // Kept deliberately terse: these ride in EVERY conversation's context, and a
31
31
  // context-saving tool must not itself be context overhead (~110 tokens).
32
32
  const SERVER_INSTRUCTIONS = `Context hygiene, always: summarize large pastes/tool results instead of carrying them verbatim; reference earlier content, don't re-quote; never inline base64. Past ~30 turns or several large pastes, proactively offer to run profile_context. Any question about tokens, cost, or latency: call profile_context, don't estimate. If optimize_context returns a pruned-turns digest, you write the ≤150-token replacement summary.`;
33
- const server = new McpServer({ name: "context-doctor", version: "0.3.6" }, { instructions: SERVER_INSTRUCTIONS });
34
33
  const STRATEGY_IDS = ["dedupe", "trim-tool-results", "strip-base64", "prune-history"];
35
- server.tool("profile_context", "Profile an LLM conversation or prompt: token breakdown by category, largest messages, and actionable findings about wasted context (duplicates, oversized tool results, base64 blobs, cache-unfriendly ordering). Accepts OpenAI/Anthropic conversation JSON or raw text. Call this immediately whenever the user asks about token usage, context size, LLM cost, or latency — and proactively offer it once a conversation grows long or accumulates large pasted content.", {
36
- conversation: z.string().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array) or raw prompt text"),
37
- model: z.string().optional().describe("Target model name for context-window math, e.g. claude-sonnet-5 or gpt-4o"),
38
- }, async ({ conversation, model }) => {
39
- const profile = profileConversation(parseConversation(conversation), model);
40
- return { content: [{ type: "text", text: renderProfile(profile) }] };
41
- });
42
- server.tool("optimize_context", "Rewrite a conversation to reclaim tokens using deterministic strategies: dedupe repeated content, trim stale tool results, strip base64 blobs, optionally prune old history. Returns the slimmed conversation JSON plus a savings summary. No LLM calls — safe and inspectable. Call this after profile_context finds recoverable waste and the user wants it fixed; add the prune-history strategy only with the user's consent, then write the replacement summary yourself as the result instructs.", {
43
- conversation: z.string().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array)"),
44
- strategies: z.array(z.enum(STRATEGY_IDS)).optional()
45
- .describe("Strategies to apply. Default: dedupe, trim-tool-results, strip-base64. Add prune-history for lossy compaction of old turns."),
46
- keep_recent: z.number().int().positive().optional().describe("Messages at the tail to leave untouched (default 6)"),
47
- max_tool_result_tokens: z.number().int().positive().optional().describe("Token budget for trimmed tool results (default 300)"),
48
- }, async ({ conversation, strategies, keep_recent, max_tool_result_tokens }) => {
49
- const result = optimizeConversation(conversation, {
50
- strategies: strategies,
51
- keepRecent: keep_recent,
52
- maxToolResultTokens: max_tool_result_tokens,
34
+ /**
35
+ * Build a fully-configured server instance. A factory (not a singleton) so the
36
+ * stateless HTTP mode can hand every request its own server, per the MCP SDK's
37
+ * recommended pattern.
38
+ */
39
+ function createServer() {
40
+ const server = new McpServer({ name: "context-doctor", version: "0.4.0" }, { instructions: SERVER_INSTRUCTIONS });
41
+ server.tool("profile_context", "Profile an LLM conversation or prompt: token breakdown by category, largest messages, and actionable findings about wasted context (duplicates, oversized tool results, base64 blobs, cache-unfriendly ordering). Accepts OpenAI/Anthropic conversation JSON or raw text. Call this immediately whenever the user asks about token usage, context size, LLM cost, or latency and proactively offer it once a conversation grows long or accumulates large pasted content.", {
42
+ conversation: z.string().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array) or raw prompt text"),
43
+ model: z.string().optional().describe("Target model name for context-window math, e.g. claude-sonnet-5 or gpt-4o"),
44
+ }, async ({ conversation, model }) => {
45
+ const profile = profileConversation(parseConversation(conversation), model);
46
+ return { content: [{ type: "text", text: renderProfile(profile) }] };
53
47
  });
54
- const saved = result.tokensBefore - result.tokensAfter;
55
- if (saved > 0) {
56
- recordLedger({ ev: "optimize", src: "mcp", saved, model: result.conversation?.model });
57
- }
58
- const summary = `Saved ~${formatTokens(saved)} tokens (${formatTokens(result.tokensBefore)} ${formatTokens(result.tokensAfter)}) ` +
59
- `via ${result.applied.length} change(s):\n` +
60
- result.applied.map((c) => `- [${c.strategy}] message #${c.messageIndex}: ${c.note} (~${formatTokens(c.tokensSaved)})`).join("\n");
61
- // Echoing a huge optimized conversation back inline would flood the very
62
- // context this tool exists to save. Above the cap, return the summary and
63
- // point at the CLI (compact JSON keeps mid-size results affordable).
64
- const ECHO_CAP_CHARS = 100_000;
65
- const conversationJson = JSON.stringify(result.conversation);
66
- const content = [
67
- { type: "text", text: summary },
68
- conversationJson.length <= ECHO_CAP_CHARS
69
- ? { type: "text", text: conversationJson }
70
- : {
71
- type: "text",
72
- text: `[optimized conversation is ${conversationJson.length} chars — too large to echo into this context. ` +
73
- `Tell the user the savings above and that \`npx context-doctor optimize <file> --out slim.json\` produces the file directly.]`,
74
- },
75
- ];
76
- // Host-model summarization: instead of calling an LLM ourselves (which would
77
- // need an API key), hand the pruned material to the model that invoked this
78
- // tool and ask IT to write the summary.
79
- if (result.prunedDigest) {
80
- content.push({
81
- type: "text",
82
- text: "ACTION REQUIRED (you, the assistant calling this tool): the pruned turns are digested below. " +
83
- "Write a dense factual summary of them (≤150 tokens: decisions, current state, open items, key identifiers) " +
84
- "and replace the '[context-doctor: ... pruned]' stub message in the conversation above with your summary " +
85
- "before presenting the result.\n\nPRUNED TURNS DIGEST:\n" + result.prunedDigest,
48
+ server.tool("optimize_context", "Rewrite a conversation to reclaim tokens using deterministic strategies: dedupe repeated content, trim stale tool results, strip base64 blobs, optionally prune old history. Returns the slimmed conversation JSON plus a savings summary. No LLM calls — safe and inspectable. Call this after profile_context finds recoverable waste and the user wants it fixed; add the prune-history strategy only with the user's consent, then write the replacement summary yourself as the result instructs.", {
49
+ conversation: z.string().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array)"),
50
+ strategies: z.array(z.enum(STRATEGY_IDS)).optional()
51
+ .describe("Strategies to apply. Default: dedupe, trim-tool-results, strip-base64. Add prune-history for lossy compaction of old turns."),
52
+ keep_recent: z.number().int().positive().optional().describe("Messages at the tail to leave untouched (default 6)"),
53
+ max_tool_result_tokens: z.number().int().positive().optional().describe("Token budget for trimmed tool results (default 300)"),
54
+ }, async ({ conversation, strategies, keep_recent, max_tool_result_tokens }) => {
55
+ const result = optimizeConversation(conversation, {
56
+ strategies: strategies,
57
+ keepRecent: keep_recent,
58
+ maxToolResultTokens: max_tool_result_tokens,
86
59
  });
87
- }
88
- return { content };
89
- });
60
+ const saved = result.tokensBefore - result.tokensAfter;
61
+ if (saved > 0) {
62
+ recordLedger({ ev: "optimize", src: "mcp", saved, model: result.conversation?.model });
63
+ }
64
+ const summary = `Saved ~${formatTokens(saved)} tokens (${formatTokens(result.tokensBefore)} → ${formatTokens(result.tokensAfter)}) ` +
65
+ `via ${result.applied.length} change(s):\n` +
66
+ result.applied.map((c) => `- [${c.strategy}] message #${c.messageIndex}: ${c.note} (~${formatTokens(c.tokensSaved)})`).join("\n");
67
+ // Echoing a huge optimized conversation back inline would flood the very
68
+ // context this tool exists to save. Above the cap, return the summary and
69
+ // point at the CLI (compact JSON keeps mid-size results affordable).
70
+ const ECHO_CAP_CHARS = 100_000;
71
+ const conversationJson = JSON.stringify(result.conversation);
72
+ const content = [
73
+ { type: "text", text: summary },
74
+ conversationJson.length <= ECHO_CAP_CHARS
75
+ ? { type: "text", text: conversationJson }
76
+ : {
77
+ type: "text",
78
+ text: `[optimized conversation is ${conversationJson.length} chars — too large to echo into this context. ` +
79
+ `Tell the user the savings above and that \`npx context-doctor optimize <file> --out slim.json\` produces the file directly.]`,
80
+ },
81
+ ];
82
+ // Host-model summarization: instead of calling an LLM ourselves (which would
83
+ // need an API key), hand the pruned material to the model that invoked this
84
+ // tool and ask IT to write the summary.
85
+ if (result.prunedDigest) {
86
+ content.push({
87
+ type: "text",
88
+ text: "ACTION REQUIRED (you, the assistant calling this tool): the pruned turns are digested below. " +
89
+ "Write a dense factual summary of them (≤150 tokens: decisions, current state, open items, key identifiers) " +
90
+ "and replace the '[context-doctor: ... pruned]' stub message in the conversation above with your summary " +
91
+ "before presenting the result.\n\nPRUNED TURNS DIGEST:\n" + result.prunedDigest,
92
+ });
93
+ }
94
+ return { content };
95
+ });
96
+ server.tool("context_best_practices", "Get a curated checklist of context-management best practices, optionally specialized for a provider (anthropic, openai).", {
97
+ provider: z.enum(["general", "anthropic", "openai"]).optional().describe("Provider to specialize tips for (default: general)"),
98
+ }, async ({ provider }) => {
99
+ const tips = [...BEST_PRACTICES.general, ...(provider && provider !== "general" ? BEST_PRACTICES[provider] : [])];
100
+ return { content: [{ type: "text", text: tips.map((t, i) => `${i + 1}. ${t}`).join("\n") }] };
101
+ });
102
+ return server;
103
+ }
90
104
  const BEST_PRACTICES = {
91
105
  general: [
92
106
  "Put stable content first (system prompt, tool definitions, reference docs) and volatile content last — prompt caches match byte-identical prefixes only.",
@@ -106,11 +120,61 @@ const BEST_PRACTICES = {
106
120
  "Use max_completion_tokens headroom math: input + output must fit the window together.",
107
121
  ],
108
122
  };
109
- server.tool("context_best_practices", "Get a curated checklist of context-management best practices, optionally specialized for a provider (anthropic, openai).", {
110
- provider: z.enum(["general", "anthropic", "openai"]).optional().describe("Provider to specialize tips for (default: general)"),
111
- }, async ({ provider }) => {
112
- const tips = [...BEST_PRACTICES.general, ...(provider && provider !== "general" ? BEST_PRACTICES[provider] : [])];
113
- return { content: [{ type: "text", text: tips.map((t, i) => `${i + 1}. ${t}`).join("\n") }] };
114
- });
115
- const transport = new StdioServerTransport();
116
- await server.connect(transport);
123
+ // -- Transport dispatch --------------------------------------------------------
124
+ // Default: stdio (Claude Desktop, Claude Code, Cursor spawn us as a child).
125
+ // --http [--port N] [--host H]: streamable-HTTP endpoint at /mcp for clients
126
+ // that connect to a URL instead of spawning a process ChatGPT developer-mode
127
+ // connectors (which require a reachable URL), web MCP clients, remote setups.
128
+ const argv = process.argv.slice(2);
129
+ if (argv.includes("--http")) {
130
+ const argAfter = (flag) => {
131
+ const i = argv.indexOf(flag);
132
+ return i >= 0 ? argv[i + 1] : undefined;
133
+ };
134
+ const port = Number(argAfter("--port")) > 0 ? Number(argAfter("--port")) : 8808;
135
+ const host = argAfter("--host") ?? "127.0.0.1";
136
+ const { createServer: createHttpServer } = await import("node:http");
137
+ const { StreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/streamableHttp.js");
138
+ createHttpServer(async (req, res) => {
139
+ try {
140
+ if (req.url === "/health") {
141
+ res.setHeader("content-type", "application/json");
142
+ res.end(JSON.stringify({ ok: true, service: "context-doctor-mcp" }));
143
+ return;
144
+ }
145
+ if (!(req.url ?? "").startsWith("/mcp")) {
146
+ res.statusCode = 404;
147
+ res.end(JSON.stringify({ error: "MCP endpoint is /mcp" }));
148
+ return;
149
+ }
150
+ if (req.method !== "POST") {
151
+ // Stateless mode: no standalone SSE stream, no sessions to delete.
152
+ res.statusCode = 405;
153
+ res.setHeader("allow", "POST");
154
+ res.end(JSON.stringify({ error: "Stateless server: POST /mcp only" }));
155
+ return;
156
+ }
157
+ // Fresh server + transport per request (stateless — nothing shared).
158
+ const server = createServer();
159
+ const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
160
+ res.on("close", () => {
161
+ void transport.close();
162
+ void server.close();
163
+ });
164
+ await server.connect(transport);
165
+ await transport.handleRequest(req, res);
166
+ }
167
+ catch (e) {
168
+ if (!res.headersSent)
169
+ res.statusCode = 500;
170
+ res.end(JSON.stringify({ error: e.message }));
171
+ }
172
+ }).listen(port, host, () => {
173
+ console.error(`context-doctor MCP (streamable HTTP) on http://${host}:${port}/mcp`);
174
+ console.error(`ChatGPT developer-mode connectors need a URL their servers can reach — expose this via your host or a tunnel.`);
175
+ });
176
+ }
177
+ else {
178
+ const transport = new StdioServerTransport();
179
+ await createServer().connect(transport);
180
+ }
@@ -0,0 +1,6 @@
1
+ /**
2
+ * MCP streamable-HTTP transport: spawn `mcp.js --http`, run the initialize
3
+ * handshake and a tool call over plain HTTP, exactly as a URL-based client
4
+ * (e.g. a ChatGPT developer-mode connector) would.
5
+ */
6
+ export {};
@@ -0,0 +1,63 @@
1
+ /**
2
+ * MCP streamable-HTTP transport: spawn `mcp.js --http`, run the initialize
3
+ * handshake and a tool call over plain HTTP, exactly as a URL-based client
4
+ * (e.g. a ChatGPT developer-mode connector) would.
5
+ */
6
+ import { test, after } from "node:test";
7
+ import assert from "node:assert/strict";
8
+ import { spawn } from "node:child_process";
9
+ import { join, dirname } from "node:path";
10
+ import { fileURLToPath } from "node:url";
11
+ const mcpPath = join(dirname(fileURLToPath(import.meta.url)), "..", "mcp.js");
12
+ const PORT = 8898;
13
+ const child = spawn(process.execPath, [mcpPath, "--http", "--port", String(PORT)], { stdio: ["ignore", "ignore", "pipe"] });
14
+ await new Promise((resolve, reject) => {
15
+ const timer = setTimeout(() => reject(new Error("HTTP MCP server did not start")), 8000);
16
+ child.stderr.on("data", (d) => {
17
+ if (d.toString().includes("streamable HTTP")) {
18
+ clearTimeout(timer);
19
+ resolve();
20
+ }
21
+ });
22
+ });
23
+ after(() => child.kill());
24
+ async function rpc(body) {
25
+ const res = await fetch(`http://127.0.0.1:${PORT}/mcp`, {
26
+ method: "POST",
27
+ headers: { "content-type": "application/json", accept: "application/json, text/event-stream" },
28
+ body: JSON.stringify(body),
29
+ });
30
+ const text = await res.text();
31
+ // Streamable HTTP may answer as SSE ("data: {...}") or plain JSON.
32
+ const dataLine = text.split("\n").find((l) => l.startsWith("data: "));
33
+ return { status: res.status, json: JSON.parse(dataLine ? dataLine.slice(6) : text) };
34
+ }
35
+ test("initialize over HTTP returns server info + instructions", async () => {
36
+ const { status, json } = await rpc({
37
+ jsonrpc: "2.0",
38
+ id: 1,
39
+ method: "initialize",
40
+ params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "t", version: "1" } },
41
+ });
42
+ assert.equal(status, 200);
43
+ assert.equal(json.result.serverInfo.name, "context-doctor");
44
+ assert.ok(json.result.instructions.includes("Context hygiene"));
45
+ });
46
+ test("tools/call works statelessly over HTTP", async () => {
47
+ const { json } = await rpc({
48
+ jsonrpc: "2.0",
49
+ id: 2,
50
+ method: "tools/call",
51
+ params: {
52
+ name: "profile_context",
53
+ arguments: { conversation: JSON.stringify({ messages: [{ role: "user", content: "hello world" }] }) },
54
+ },
55
+ });
56
+ assert.ok(json.result.content[0].text.includes("CONTEXT DOCTOR"));
57
+ });
58
+ test("health endpoint responds; non-POST is rejected", async () => {
59
+ const health = (await (await fetch(`http://127.0.0.1:${PORT}/health`)).json());
60
+ assert.equal(health.ok, true);
61
+ const get = await fetch(`http://127.0.0.1:${PORT}/mcp`);
62
+ assert.equal(get.status, 405);
63
+ });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "context-doctor",
3
- "version": "0.3.6",
3
+ "version": "0.4.0",
4
4
  "description": "Profile and optimize LLM context windows. See what's eating your tokens and fix it — works with Claude, GPT, Gemini, and any MCP-capable AI app.",
5
5
  "keywords": [
6
6
  "llm",
@@ -41,7 +41,7 @@
41
41
  "build": "tsc && node -e \"const fs=require('fs');['dist/cli.js','dist/mcp.js'].forEach(f=>fs.chmodSync(f,0o755))\"",
42
42
  "prepublishOnly": "npm run build",
43
43
  "dev": "tsc --watch",
44
- "test": "npm run build && node --test dist/test/smoke.test.js dist/test/proxy.test.js dist/test/hook.test.js"
44
+ "test": "npm run build && node --test dist/test/smoke.test.js dist/test/proxy.test.js dist/test/hook.test.js dist/test/mcp-http.test.js"
45
45
  },
46
46
  "dependencies": {
47
47
  "@modelcontextprotocol/sdk": "^1.0.0",