mcp-context-optimizer 0.1.7 → 0.1.9

package/README.md

@@ -1,7 +1,6 @@
 # mcp-context-optimizer
 
-Deterministic, **local-first context optimization** for AI coding agents — an SDK
-and an MCP server. No cloud services, no AI models, no API keys, no telemetry.
+Keep critical context within token limits for AI coding agents — without losing errors, decisions, or file references.
 
 `mcp-context-optimizer` takes the raw exhaust of a coding session (conversation
 messages, tool outputs, errors, stack traces, file snapshots, git diffs, test
@@ -66,6 +65,87 @@ console.log(result.stats);     // estimated input/output tokens + reduction rati
 
 Identical inputs and configuration always produce byte-identical outputs.
 
+## Quick start (CLI, no MCP client needed)
+
+```bash
+# Build a compact context from a records file
+npx mcp-context-optimizer build --task "Fix auth" --records session.json
+
+# Pipe records from stdin
+cat session.json | npx mcp-context-optimizer build --task "Fix auth" --stdin
+
+# Write the result to a file
+npx mcp-context-optimizer build --task "Fix auth" --records session.json --output context.txt
+```
+
+## Before / after
+
+A typical debugging session is full of repeated tool outputs, chit-chat, and
+stale context. Here is what happens with a realistic session:
+
+**Before** — raw session dump (4992 tokens, over budget):
+
+```
+# Task: Stop the duplicate-charge bug in src/billing/charge.ts
+
+message #1 (user): Customers get charged twice when retrying; the duplicate
+originates in src/billing/charge.ts
+message #2 (assistant): Chattering about hypothesis 0: maybe the cache, maybe
+the clock, maybe the moon phase. Let us look at more logs.
+... (40 lines of chattering)
+message #42 (assistant): Chattering about hypothesis 39: maybe the cache...
+tool_call #43: npm test -- billing
+RUN v2.1.0
+ ❯ src/billing/charge.test.ts (1 test)
+   × duplicate charge
+     → DuplicateKeyError: duplicate key value violates unique constraint
+ Test Files  1 failed (1)
+... (8 identical copies of the same test output)
+error #52: DuplicateKeyError: duplicate key value violates unique constraint
+    at chargeOnce (src/billing/charge.ts:88:11)
+decision #53: Idempotency keys must be generated per logical order, not per
+retry attempt
+file #54: src/billing/charge.ts
+export async function chargeOnce(order, retry) {
+  const key = `ord-${order.id}-retry-${retry.attempt}`;
+  return stripe.charges.create({ amount: order.total, idempotencyKey: key });
+}
+```
+
+**After** — optimized context (328 tokens, 93% reduction, all required facts retained):
+
+```
+# Task
+
+Stop the duplicate-charge bug in src/billing/charge.ts
+
+## Errors
+- [error] DuplicateKeyError: duplicate key value violates unique constraint
+  "charges_idempotency_key_key"
+  src/billing/charge.ts:88:11  [source: fr_a1b2c3 | record r52]
+
+## Decisions
+- [decision] Idempotency keys must be generated per logical order, not per retry
+  attempt  [source: fr_d4e5f6 | record r53]
+
+## Files
+- [file] src/billing/charge.ts
+  export async function chargeOnce(order, retry) {
+    const key = `ord-${order.id}-retry-${retry.attempt}`;
+    return stripe.charges.create({ amount: order.total, idempotencyKey: key });
+  }  [source: fr_g7h8i9 | record r54]
+```
+
+**What was dropped:** 40 lines of chattering, 7 duplicate test runs, noise notes.
+**What was kept:** the error, the accepted decision, the relevant file — all with
+source references so you can trace every line back to its origin.
+
+Run the benchmark yourself:
+
+```bash
+npm run bench
+```
+
 ## How it works: the pipeline
 
 Each stage is a separate, unit-tested, pure function:
@@ -140,9 +220,29 @@ MCP tool availability does **not** automatically intercept or rewrite model
 requests. A compatible client must explicitly call these tools (e.g. the agent
 decides to call `build_context` before answering a task). Automatic context
 replacement would require a native integration inside the coding agent
-(hooking its prompt assembly). This server also stores data **in memory per
-process lifetime** — restarting the server process starts from an empty store;
-re-ingest or implement your own `ContextStore` for persistence.
+(hooking its prompt assembly).
+
+### Persistence (opt-in)
+
+By default the store is **in-memory per process lifetime** — restarting the
+server starts from an empty store. To keep records across restarts, pass
+`--persist <path>` to the CLI or set `persistPath` in `McpAdapterOptions`:
+
+```bash
+mcp-ctx-optimizer --persist ~/.cache/mcp-context-optimizer/context.json
+```
+
+```ts
+import { createContextOptimizerServer } from 'mcp-context-optimizer/mcp';
+
+const server = createContextOptimizerServer({
+  persistPath: './context-store.json',
+});
+```
+
+Records are written to a local JSON file; no network access is used. The file
+stays on the local machine. Implement the `ContextStore` interface for custom
+backends (e.g. SQLite).
 
 ## Privacy & local operation
 
@@ -168,6 +268,30 @@ const optimizer = new ContextOptimizer({
 });
 ```
 
+### Built-in tokenizer presets
+
+For convenience, the SDK ships with presets tuned for popular model families:
+
+```ts
+import { ContextOptimizer, claudeEstimator, gpt4Estimator } from 'mcp-context-optimizer';
+
+const optimizer = new ContextOptimizer({
+  tokenBudget: 12_000,
+  tokenEstimator: claudeEstimator, // ~3 chars/token, tuned for Claude
+});
+
+// Or look up a preset by name:
+import { getPreset } from 'mcp-context-optimizer';
+const est = getPreset('claude-3');
+```
+
+| Preset       | Heuristic       | Best for                         |
+| ------------ | --------------- | -------------------------------- |
+| `default`    | `ceil(chars / 4)` | Default; good for prose-heavy   |
+| `claude-3`   | `ceil(chars / 3)` | Claude code/context; denser tokens |
+| `gpt-4`      | `ceil(chars / 4)` | GPT-4 family                     |
+| `mistral`    | `ceil(chars / 4)` | Mistral family                   |
+
 ## Benchmarks
 
 A reproducible benchmark suite compares three strategies across 9 coding-session
@@ -363,6 +487,37 @@ Add to `~/.continue/config.json`:
 }
 ```
 
+## MCP registries
+
+The package is listed in MCP registries for one-click installation:
+
+| Registry | How to add |
+|---|---|
+| **Smithery** | See [`smithery.yaml`](smithery.yaml). The server is configured with `--persist` so records survive restarts. |
+| **Glama** | Add server via Glama dashboard: command `npx mcp-ctx-optimizer`, transport `stdio`. |
+| **MCP.so** | Add server via MCP.so dashboard: command `npx mcp-ctx-optimizer`, transport `stdio`. |
+
+**Smithery example** — add to your Smithery client config:
+
+```json
+{
+  "mcpServers": {
+    "context-optimizer": {
+      "command": "npx",
+      "args": [
+        "mcp-ctx-optimizer",
+        "--persist",
+        "~/.cache/mcp-context-optimizer/context.json"
+      ]
+    }
+  }
+}
+```
+
+**Claude Code hooks** — see [`claude-code-hooks.json`](claude-code-hooks.json). Register it in Claude Code settings to automatically call `build_context` on every user prompt (reduces the explicit-invocation friction).
+
+**Claude Desktop** — see [`claude-desktop-config.json`](claude-desktop-config.json). Add to your Claude Desktop `claude_desktop_config.json`.
+
 **Important:** MCP tool availability does not automatically intercept model
 requests. The client/agent must explicitly call these tools (e.g. call
 `build_context` before answering). Automatic context replacement requires a
@@ -370,5 +525,7 @@ native integration inside the coding agent.
 
 The MCP server stores data **in memory per process lifetime** — restarting the
 server starts from an empty store. Re-ingest records or implement your own
-`ContextStore` (see `src/store.ts`) for persistence.
+`ContextStore` (see `src/store.ts`) for persistence. Use `--persist` for
+built-in file persistence.
+
 

package/dist/index.d.ts

@@ -6,6 +6,7 @@
  */
 export { ContextOptimizer, PIPELINE_VERSION } from './optimizer.js';
 export { defaultTokenEstimator, createTokenEstimator, sha256, shortHash, } from './tokens.js';
+export { claudeEstimator, gpt4Estimator, mistralEstimator, TOKENIZER_PRESETS, getPreset, } from './token-presets.js';
 export { DEFAULT_WEIGHTS, DECISION_RECENCY_FLOOR, tokenize, scoreStage } from './score.js';
 export { renderContext, sourceTag, type RenderOptions } from './render.js';
 export { selectStage, fragmentCost, truncateText } from './select.js';
@@ -13,7 +14,7 @@ export { compactStage, compactFragment, compactCode, compactStackTrace, compactT
 export { dedupeStage, containmentSimilarity } from './dedupe.js';
 export { extractStage, extractSignals, extractPaths, extractSymbols, extractStackFrames, extractRequirements, } from './extract.js';
 export { normalizeStage, collectRecords, recordToFragment, normalizeText, collapseRepeatedLines, stableStringify, validateRecord, } from './normalize.js';
-export { InMemoryContextStore, filterByFile, filterDecisions, filterErrors } from './store.js';
+export { InMemoryContextStore, FileContextStore, filterByFile, filterDecisions, filterErrors } from './store.js';
 export type { ContextStore } from './store.js';
 export type { BuildContextInput, BudgetConflict, BudgetSummary, DecisionRecord, DecisionStatus, DiffRecord, ErrorRecord, ExtractedError, ExtractedPath, ExtractedRequirement, ExtractedSignals, ExtractedSymbol, FileRecord, FileState, Fragment, FragmentMeta, InputRecord, MessageRecord, MessageRole, MergeReason, NoteRecord, OmittedFragment, OmissionReason, OptimizerOptions, OptimizedContext, OptimizationReport, OutcomeInfo, Provenance, RecordBase, RecordKind, RelevanceScore, ScoringWeights, ScoreComponent, SelectedFragment, SelectionReason, SourceRef, TestFailure, TestResultRecord, TokenEstimator, ToolCallRecord, Warning, WarningCode, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,EACN,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACtM,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,OAAO,EACP,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,EACN,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACtM,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACjH,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,OAAO,EACP,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@
  */
 export { ContextOptimizer, PIPELINE_VERSION } from './optimizer.js';
 export { defaultTokenEstimator, createTokenEstimator, sha256, shortHash, } from './tokens.js';
+export { claudeEstimator, gpt4Estimator, mistralEstimator, TOKENIZER_PRESETS, getPreset, } from './token-presets.js';
 export { DEFAULT_WEIGHTS, DECISION_RECENCY_FLOOR, tokenize, scoreStage } from './score.js';
 export { renderContext, sourceTag } from './render.js';
 export { selectStage, fragmentCost, truncateText } from './select.js';
@@ -13,5 +14,5 @@ export { compactStage, compactFragment, compactCode, compactStackTrace, compactT
 export { dedupeStage, containmentSimilarity } from './dedupe.js';
 export { extractStage, extractSignals, extractPaths, extractSymbols, extractStackFrames, extractRequirements, } from './extract.js';
 export { normalizeStage, collectRecords, recordToFragment, normalizeText, collapseRepeatedLines, stableStringify, validateRecord, } from './normalize.js';
-export { InMemoryContextStore, filterByFile, filterDecisions, filterErrors } from './store.js';
+export { InMemoryContextStore, FileContextStore, filterByFile, filterDecisions, filterErrors } from './store.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,EACN,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,uBAAuB,EAA2C,MAAM,cAAc,CAAC;AACtM,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,EACN,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAsB,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,uBAAuB,EAA2C,MAAM,cAAc,CAAC;AACtM,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/cli.d.ts

@@ -1,3 +1,13 @@
 #!/usr/bin/env node
+/**
+ * CLI entry for the mcp-context-optimizer.
+ *
+ * MCP server mode (default):
+ *   mcp-ctx-optimizer [--persist <path>]
+ *
+ * Standalone build mode:
+ *   mcp-ctx-optimizer build --task "Fix auth" --records session.json
+ *   cat session.json | mcp-ctx-optimizer build --task "Fix auth" --stdin
+ */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/mcp/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":""}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/mcp/cli.js

@@ -1,12 +1,147 @@
 #!/usr/bin/env node
 /**
- * CLI entry for the mcp-context-optimizer MCP server (stdio transport).
+ * CLI entry for the mcp-context-optimizer.
  *
- * Usage from an MCP client:
- *   { "command": "mcp-ctx-optimizer" }
- * or during development:
- *   npx tsx src/mcp/cli.ts
+ * MCP server mode (default):
+ *   mcp-ctx-optimizer [--persist <path>]
+ *
+ * Standalone build mode:
+ *   mcp-ctx-optimizer build --task "Fix auth" --records session.json
+ *   cat session.json | mcp-ctx-optimizer build --task "Fix auth" --stdin
  */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { startContextOptimizerStdio } from './server.js';
-startContextOptimizerStdio();
+import { ContextOptimizer } from '../optimizer.js';
+function printHelp() {
+    console.error(`mcp-context-optimizer CLI
+
+Usage:
+  mcp-ctx-optimizer [--persist <path>]     Start MCP server over stdio
+  mcp-ctx-optimizer build [options]         Build compact context for a task
+
+build options:
+  --task <text>          Task description (required)
+  --records <file>       JSON file with records array
+  --stdin                Read records JSON from stdin
+  --token-budget <n>     Token budget (default 12000)
+  --query <text>         Additional relevance query
+  --output <file>        Write context to file (default: stdout)
+
+Examples:
+  mcp-ctx-optimizer build --task "Fix auth" --records session.json
+  cat session.json | mcp-ctx-optimizer build --task "Fix auth" --stdin
+`);
+}
+function parseBuildArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--task')
+            args.task = argv[++i];
+        else if (arg === '--records')
+            args.records = argv[++i];
+        else if (arg === '--stdin')
+            args.stdin = true;
+        else if (arg === '--token-budget')
+            args.tokenBudget = argv[++i];
+        else if (arg === '--query')
+            args.query = argv[++i];
+        else if (arg === '--output')
+            args.output = argv[++i];
+        else if (arg === '--help' || arg === '-h')
+            args.task = 'help';
+    }
+    return args;
+}
+async function readRecordsFromStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    const raw = Buffer.concat(chunks).toString('utf8');
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed) ? parsed : parsed.records ?? [];
+}
+async function runBuild(args) {
+    if (args.task === 'help') {
+        printHelp();
+        return;
+    }
+    if (!args.task) {
+        console.error('Error: --task is required');
+        printHelp();
+        process.exitCode = 1;
+        return;
+    }
+    // Load records
+    let records = [];
+    if (args.records) {
+        if (!existsSync(args.records)) {
+            console.error(`Error: records file not found: ${args.records}`);
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const raw = JSON.parse(readFileSync(args.records, 'utf8'));
+            records = Array.isArray(raw) ? raw : raw.records ?? [];
+        }
+        catch (err) {
+            console.error(`Error: failed to parse records file: ${err.message}`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    else if (args.stdin) {
+        try {
+            records = await readRecordsFromStdin();
+        }
+        catch (err) {
+            console.error(`Error: failed to parse stdin: ${err.message}`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    const optimizer = new ContextOptimizer({
+        tokenBudget: args.tokenBudget ? Number(args.tokenBudget) : undefined,
+    });
+    const result = optimizer.buildContextSync({
+        task: args.task,
+        records,
+        ...(args.query ? { query: args.query } : {}),
+        ...(args.tokenBudget ? { tokenBudget: Number(args.tokenBudget) } : {}),
+    });
+    // Output
+    if (args.output) {
+        writeFileSync(args.output, result.context, 'utf8');
+        console.error(`Context written to ${args.output}`);
+    }
+    else {
+        process.stdout.write(result.context);
+    }
+    process.stderr.write(`[mcp-context-optimizer] ${result.stats.estimatedInputTokens} -> ${result.stats.estimatedOutputTokens} tokens (${(result.stats.reductionRatio * 100).toFixed(0)}% reduction)\n`);
+}
+function parseMcpArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--persist')
+            args.persist = argv[++i];
+    }
+    return args;
+}
+function main() {
+    const rawArgs = process.argv.slice(2);
+    if (rawArgs.length > 0 && rawArgs[0] === 'build') {
+        const buildArgs = parseBuildArgs(rawArgs.slice(1));
+        runBuild(buildArgs).catch((err) => {
+            console.error(err);
+            process.exitCode = 1;
+        });
+        return;
+    }
+    const mcpArgs = parseMcpArgs(rawArgs);
+    startContextOptimizerStdio({
+        ...(mcpArgs.persist ? { persistPath: mcpArgs.persist } : {}),
+    });
+}
+main();
 //# sourceMappingURL=cli.js.map

package/dist/mcp/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/mcp/cli.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -6,6 +6,11 @@ export declare const SERVER_INSTRUCTIONS = "Deterministic, local-first context o
 export interface McpAdapterOptions {
     /** Store backing the server. Defaults to a fresh in-memory store. */
     store?: ContextStore;
+    /**
+     * When set, records are persisted to this local JSON file and restored on
+     * restart. The file stays on the local machine; no network access is used.
+     */
+    persistPath?: string;
     /** Optimizer configuration (token budget, weights, ...). */
     optimizer?: OptimizerOptions;
     serverInfo?: {

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAA+B,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAyBjF,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,yOAEgE,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAOD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,iBAAsB,GAAG,SAAS,CA0LvF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAKhF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAOzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAA+B,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAyBjF,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,yOAEgE,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAOD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,iBAAsB,GAAG,SAAS,CAqQvF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAKhF"}

package/dist/mcp/server.js

@@ -3,7 +3,7 @@ import { serveStdio } from '@modelcontextprotocol/server/stdio';
 import { z } from 'zod';
 import { ContextOptimizer } from '../optimizer.js';
 import { validateRecord } from '../normalize.js';
-import { InMemoryContextStore, filterByFile, filterDecisions, filterErrors } from '../store.js';
+import { FileContextStore, InMemoryContextStore, filterByFile, filterDecisions, filterErrors } from '../store.js';
 /**
  * MCP adapter exposing the mcp-context-optimizer core over the Model Context
  * Protocol. Optional: the core SDK never imports this module; only clients
@@ -39,7 +39,7 @@ function jsonResult(data) {
  * wires one (use {@link startContextOptimizerStdio} for stdio).
  */
 export function createContextOptimizerServer(options = {}) {
-    const store = options.store ?? new InMemoryContextStore();
+    const store = options.store ?? (options.persistPath ? new FileContextStore(options.persistPath) : new InMemoryContextStore());
     const optimizer = new ContextOptimizer(options.optimizer ?? {});
     const server = new McpServer({
         name: options.serverInfo?.name ?? 'mcp-context-optimizer',
@@ -186,6 +186,69 @@ export function createContextOptimizerServer(options = {}) {
             report: result.report,
         });
     });
+    // MCP prompts: discoverable via prompts/list and invocable as slash commands.
+    server.registerPrompt('optimize-context', {
+        title: 'Optimize Context',
+        description: 'Build a compact, task-specific context from stored records. Use before answering a task to keep only relevant facts within the token budget.',
+        argsSchema: z.object({
+            task: z.string().min(1).describe('The current task description.'),
+            query: z.string().optional().describe('Additional relevance terms.'),
+            tokenBudget: z.number().int().min(1).optional().describe('Override the server token budget.'),
+        }),
+    }, async ({ task, query, tokenBudget }) => {
+        const all = store.all();
+        const result = optimizer.buildContextSync({
+            task,
+            ...(query ? { query } : {}),
+            records: all,
+            ...(tokenBudget ? { tokenBudget } : {}),
+        });
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${result.context}\n\n[Optimization report: ${result.stats.estimatedInputTokens} -> ${result.stats.estimatedOutputTokens} tokens, ${(result.stats.reductionRatio * 100).toFixed(0)}% reduction. ${result.sources.length} sources retained, ${result.omitted.length} omitted.]`,
+                    },
+                },
+            ],
+        };
+    });
+    server.registerPrompt('summarize-errors', {
+        title: 'Summarize Errors',
+        description: 'Retrieve recorded errors and failed attempts, optionally ranked by a query. Use when debugging to see what has failed so far.',
+        argsSchema: z.object({
+            query: z.string().optional().describe('Optional relevance query; omit for all errors.'),
+        }),
+    }, async ({ query }) => {
+        const errors = store.getErrors ? store.getErrors() : filterErrors(store.all());
+        if (!query || errors.length === 0) {
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `${errors.length} error(s) recorded.\n\n${errors.map((e) => `- [${e.kind}] ${'message' in e ? e.message : JSON.stringify(e).slice(0, 200)}`).join('\n')}`,
+                        },
+                    },
+                ],
+            };
+        }
+        const hits = optimizer.search({ query, records: errors });
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `${hits.length} relevant error(s) for "${query}":\n\n${hits.map((h) => `- ${h.fragment.text}`).join('\n\n')}`,
+                    },
+                },
+            ],
+        };
+    });
     return server;
 }
 /**

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -41,4 +41,26 @@ export declare class InMemoryContextStore implements ContextStore {
     /** Records associated with a file path (exact or suffix match). */
     getByFile(path: string): InputRecord[];
 }
+/**
+ * File-backed context store. Records are written to a local JSON file on
+ * every `add()` and read back on construction. No network access, no
+ * telemetry — the file stays on the local machine.
+ *
+ * This is an opt-in persistence layer for the MCP server: pass a `persistPath`
+ * to keep records across server restarts. The default store remains
+ * in-memory only (see {@link InMemoryContextStore}).
+ */
+export declare class FileContextStore implements ContextStore {
+    private readonly filePath;
+    private readonly records;
+    constructor(filePath: string);
+    private load;
+    private flush;
+    add(records: InputRecord[]): void;
+    all(): InputRecord[];
+    clear(): void;
+    getDecisions(): DecisionRecord[];
+    getErrors(): InputRecord[];
+    getByFile(path: string): InputRecord[];
+}
 //# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAClC,6CAA6C;IAC7C,GAAG,IAAI,WAAW,EAAE,CAAC;IACrB,0BAA0B;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,oEAAoE;IACpE,YAAY,CAAC,IAAI,cAAc,EAAE,CAAC;IAClC,oFAAoF;IACpF,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC;IAC5B,mFAAmF;IACnF,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACzC;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAExE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAOlE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAiBhF;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAKjC,GAAG,IAAI,WAAW,EAAE;IAIpB,KAAK,IAAI,IAAI;IAIb,yDAAyD;IACzD,YAAY,IAAI,cAAc,EAAE;IAIhC,yDAAyD;IACzD,SAAS,IAAI,WAAW,EAAE;IAI1B,mEAAmE;IACnE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;CAGvC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAClC,6CAA6C;IAC7C,GAAG,IAAI,WAAW,EAAE,CAAC;IACrB,0BAA0B;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,oEAAoE;IACpE,YAAY,CAAC,IAAI,cAAc,EAAE,CAAC;IAClC,oFAAoF;IACpF,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC;IAC5B,mFAAmF;IACnF,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACzC;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAExE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAOlE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAiBhF;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAKjC,GAAG,IAAI,WAAW,EAAE;IAIpB,KAAK,IAAI,IAAI;IAIb,yDAAyD;IACzD,YAAY,IAAI,cAAc,EAAE;IAIhC,yDAAyD;IACzD,SAAS,IAAI,WAAW,EAAE;IAI1B,mEAAmE;IACnE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;CAGvC;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,KAAK;IASb,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAMjC,GAAG,IAAI,WAAW,EAAE;IAIpB,KAAK,IAAI,IAAI;IAKb,YAAY,IAAI,cAAc,EAAE;IAIhC,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;CAGvC"}

package/dist/store.js

@@ -1,3 +1,5 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
 import { normalizeStage } from './normalize.js';
 /** Filter helpers used when a store does not implement the optional queries. */
 export function filterDecisions(records) {
@@ -56,4 +58,64 @@ export class InMemoryContextStore {
         return filterByFile(this.records, path);
     }
 }
+/**
+ * File-backed context store. Records are written to a local JSON file on
+ * every `add()` and read back on construction. No network access, no
+ * telemetry — the file stays on the local machine.
+ *
+ * This is an opt-in persistence layer for the MCP server: pass a `persistPath`
+ * to keep records across server restarts. The default store remains
+ * in-memory only (see {@link InMemoryContextStore}).
+ */
+export class FileContextStore {
+    filePath;
+    records;
+    constructor(filePath) {
+        this.filePath = resolve(filePath);
+        this.records = this.load();
+    }
+    load() {
+        try {
+            const raw = readFileSync(this.filePath, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed))
+                return [];
+            const { records } = normalizeStage(parsed);
+            return records;
+        }
+        catch {
+            return [];
+        }
+    }
+    flush() {
+        try {
+            mkdirSync(dirname(this.filePath), { recursive: true });
+            writeFileSync(this.filePath, JSON.stringify(this.records, null, 2), 'utf8');
+        }
+        catch {
+            // Persistence is best-effort; never throw from the store.
+        }
+    }
+    add(records) {
+        const { records: valid } = normalizeStage(records);
+        this.records.push(...valid);
+        this.flush();
+    }
+    all() {
+        return [...this.records];
+    }
+    clear() {
+        this.records.length = 0;
+        this.flush();
+    }
+    getDecisions() {
+        return filterDecisions(this.records);
+    }
+    getErrors() {
+        return filterErrors(this.records);
+    }
+    getByFile(path) {
+        return filterByFile(this.records, path);
+    }
+}
 //# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/dist/token-presets.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Optional tokenizer presets for popular model families.
+ *
+ * These are heuristics tuned for common model tokenizers. For exact counts,
+ * plug in a real tokenizer (e.g. tiktoken) via {@link createTokenEstimator}.
+ *
+ * | Preset     | Heuristic       | Best for                         |
+ * | ---------- | --------------- | -------------------------------- |
+ * | chars/4    | ceil(chars / 4) | Default; good for prose-heavy   |
+ * | claude-3   | ceil(chars / 3) | Claude code/context; denser tokens |
+ * | gpt-4      | ceil(chars / 4) | GPT-4; similar to default        |
+ * | mistral    | ceil(chars / 4) | Mistral; similar to default      |
+ */
+import type { TokenEstimator } from './types.js';
+/** Claude models produce denser tokens on code; ~3 chars/token. */
+export declare const claudeEstimator: TokenEstimator;
+/** GPT-4 family; ~4 chars/token, same as the built-in default. */
+export declare const gpt4Estimator: TokenEstimator;
+/** Mistral family; ~4 chars/token. */
+export declare const mistralEstimator: TokenEstimator;
+/** Registry of named presets. */
+export declare const TOKENIZER_PRESETS: Record<string, TokenEstimator>;
+/** Look up a preset by name; returns undefined if not found. */
+export declare function getPreset(name: string): TokenEstimator | undefined;
+//# sourceMappingURL=token-presets.d.ts.map

package/dist/token-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-presets.d.ts","sourceRoot":"","sources":["../src/token-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,mEAAmE;AACnE,eAAO,MAAM,eAAe,EAAE,cAG7B,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,aAAa,EAAE,cAG3B,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,EAAE,cAG9B,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAM5D,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAElE"}

package/dist/token-presets.js

@@ -0,0 +1,33 @@
+/**
+ * Optional tokenizer presets for popular model families.
+ *
+ * These are heuristics tuned for common model tokenizers. For exact counts,
+ * plug in a real tokenizer (e.g. tiktoken) via {@link createTokenEstimator}.
+ *
+ * | Preset     | Heuristic       | Best for                         |
+ * | ---------- | --------------- | -------------------------------- |
+ * | chars/4    | ceil(chars / 4) | Default; good for prose-heavy   |
+ * | claude-3   | ceil(chars / 3) | Claude code/context; denser tokens |
+ * | gpt-4      | ceil(chars / 4) | GPT-4; similar to default        |
+ * | mistral    | ceil(chars / 4) | Mistral; similar to default      |
+ */
+import { createTokenEstimator } from './tokens.js';
+/** Claude models produce denser tokens on code; ~3 chars/token. */
+export const claudeEstimator = createTokenEstimator('claude-3/chars-3', (text) => Math.ceil(text.length / 3));
+/** GPT-4 family; ~4 chars/token, same as the built-in default. */
+export const gpt4Estimator = createTokenEstimator('gpt-4/chars-4', (text) => Math.ceil(text.length / 4));
+/** Mistral family; ~4 chars/token. */
+export const mistralEstimator = createTokenEstimator('mistral/chars-4', (text) => Math.ceil(text.length / 4));
+/** Registry of named presets. */
+export const TOKENIZER_PRESETS = {
+    'claude-3': claudeEstimator,
+    'gpt-4': gpt4Estimator,
+    'gpt-4o': gpt4Estimator,
+    'mistral': mistralEstimator,
+    default: createTokenEstimator('chars/4', (text) => Math.ceil(text.length / 4)),
+};
+/** Look up a preset by name; returns undefined if not found. */
+export function getPreset(name) {
+    return TOKENIZER_PRESETS[name];
+}
+//# sourceMappingURL=token-presets.js.map

package/dist/token-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-presets.js","sourceRoot":"","sources":["../src/token-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAmB,oBAAoB,CACjE,kBAAkB,EAClB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACrC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAmB,oBAAoB,CAC/D,eAAe,EACf,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACrC,CAAC;AAEF,sCAAsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAmB,oBAAoB,CAClE,iBAAiB,EACjB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACrC,CAAC;AAEF,iCAAiC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,UAAU,EAAE,eAAe;IAC3B,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,gBAAgB;IAC3B,OAAO,EAAE,oBAAoB,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;CAC/E,CAAC;AAEF,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "mcp-context-optimizer",
-  "version": "0.1.7",
-  "description": "Deterministic, local-first context optimization SDK and MCP server for AI coding agents. No cloud, no AI models, no telemetry.",
+  "version": "0.1.9",
+  "description": "Keep critical context within token limits for AI coding agents. Deterministic, local-first context optimization SDK and MCP server.",
   "keywords": [
     "mcp",
     "model-context-protocol",
     "ai-agents",
     "context-management",
     "context-optimization",
+    "token-budget",
     "llm",
     "claude",
     "cursor",
@@ -72,7 +73,7 @@
     "bench": "tsx benchmarks/run.ts",
     "bench:write": "tsx benchmarks/run.ts --write",
     "mcp:start": "node dist/mcp/cli.js",
-    "prepublishOnly": "npm run typecheck && npm run build && npm run lint && npm test"
+    "prepublishOnly": "npm run typecheck && npm run build && npm run lint && npm run test"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",
@@ -88,4 +89,4 @@
     "@modelcontextprotocol/server": "^2.3.1",
     "zod": "^4.3.0"
   }
-}
+}