distill-mcp 0.6.0-beta → 0.6.1-beta

package/README.md

@@ -0,0 +1,227 @@
+# Distill
+
+> Extract the essence. Compress the context. Save tokens.
+
+**Distill** is an open-source MCP server that optimizes LLM token usage through intelligent context compression. Works with Claude Code, Cursor, and Windsurf.
+
+[![npm version](https://img.shields.io/npm/v/distill-mcp.svg)](https://www.npmjs.com/package/distill-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Why Distill?
+
+| Problem | Distill Solution | Savings |
+|---------|------------------|---------|
+| Large build outputs | Auto-compress errors | 80-95% |
+| Reading entire files | AST-based extraction | 50-70% |
+| Multiple tool calls | TypeScript SDK execution | **98%** |
+| Verbose logs | Smart summarization | 80-90% |
+
+## Quick Start
+
+```bash
+# Run directly with npx
+npx distill-mcp
+
+# Or install globally
+npm install -g distill-mcp
+
+# Configure your IDE
+distill-mcp setup
+```
+
+### Add to Claude Code
+
+```bash
+claude mcp add distill -- npx distill-mcp
+```
+
+## Features
+
+- **Smart File Reading** - Extract functions, classes, or signatures without loading entire files
+- **Auto Compression** - Detects content type and applies optimal compression
+- **Code Execution SDK** - Write TypeScript instead of chaining tool calls
+- **Lazy Loading** - Only loads tools when needed (85% token overhead reduction)
+- **7 Languages** - TypeScript, JavaScript, Python, Go, Rust, PHP, Swift
+
+## MCP Tools
+
+### Core Tools (Always Loaded)
+
+| Tool | Purpose | Savings |
+|------|---------|---------|
+| `auto_optimize` | Auto-detect and compress content | 40-95% |
+| `smart_file_read` | Read code with AST extraction | 50-70% |
+| `code_execute` | Execute TypeScript with SDK | **98%** |
+| `discover_tools` | Browse/load additional tools | - |
+
+### On-Demand Tools
+
+| Tool | Purpose | Savings |
+|------|---------|---------|
+| `semantic_compress` | TF-IDF based compression | 40-60% |
+| `summarize_logs` | Summarize server/test/build logs | 80-90% |
+| `analyze_build_output` | Parse build errors | 95%+ |
+| `deduplicate_errors` | Group repeated errors | 80-95% |
+| `diff_compress` | Compress git diffs | 50-80% |
+| `context_budget` | Pre-flight token estimation | - |
+| `session_stats` | Usage analytics | - |
+
+## Usage Examples
+
+### Smart File Reading
+
+```bash
+# Get file structure overview
+mcp__distill__smart_file_read filePath="src/server.ts"
+
+# Extract specific function
+mcp__distill__smart_file_read filePath="src/server.ts" target={"type":"function","name":"createServer"}
+
+# Get skeleton (signatures only)
+mcp__distill__smart_file_read filePath="src/server.ts" skeleton=true
+```
+
+### Compress Build Output
+
+```bash
+# After a failed build, compress the output
+mcp__distill__auto_optimize content="<paste npm/tsc/webpack output>"
+```
+
+### Code Execution SDK
+
+The `code_execute` tool provides **98% token savings** by letting LLMs write TypeScript:
+
+```bash
+mcp__distill__code_execute code="return ctx.compress.auto(ctx.files.read('logs.txt'))"
+```
+
+**SDK API:**
+
+```typescript
+// File operations
+ctx.files.read(path)
+ctx.files.glob(pattern)
+ctx.files.exists(path)
+
+// Code analysis
+ctx.code.skeleton(content, lang)
+ctx.code.extract(content, lang, {type, name})
+ctx.code.parse(content, lang)
+
+// Compression
+ctx.compress.auto(content, hint?)
+ctx.compress.logs(logs)
+ctx.compress.diff(diff)
+ctx.compress.semantic(content, ratio?)
+
+// Git operations
+ctx.git.diff(ref?)
+ctx.git.log(limit?)
+ctx.git.blame(file, line?)
+
+// Search
+ctx.search.grep(pattern, glob?)
+ctx.search.symbols(query)
+
+// Analysis
+ctx.analyze.dependencies(file)
+ctx.analyze.callGraph(fn)
+```
+
+### Discover Tools
+
+```bash
+# Browse available tools (metadata only)
+mcp__distill__discover_tools category="compress"
+
+# Load tools when needed
+mcp__distill__discover_tools category="compress" load=true
+
+# TOON format for compact output
+mcp__distill__discover_tools format="toon"
+```
+
+## CLI Commands
+
+```bash
+distill-mcp setup          # Auto-configure detected IDEs
+distill-mcp setup --claude # Configure Claude Code only
+distill-mcp setup --cursor # Configure Cursor only
+distill-mcp doctor         # Verify installation
+distill-mcp serve          # Start MCP server
+distill-mcp analyze        # Analyze codebase token usage
+distill-mcp --help         # Show help
+```
+
+## IDE Configuration
+
+### Claude Code
+
+After running `distill-mcp setup`, your config will include:
+
+```json
+{
+  "mcpServers": {
+    "distill": {
+      "command": "npx",
+      "args": ["distill-mcp", "serve"]
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+
+Configuration is automatically added to the appropriate settings file.
+
+## Token Overhead
+
+Distill uses **lazy loading** to minimize overhead:
+
+| Mode | Tokens | Description |
+|------|--------|-------------|
+| Core only | 264 | Default (4 tools) |
+| All tools | 1,108 | Full suite (21 tools) |
+| **Savings** | **76%** | Lazy vs eager loading |
+
+## Security
+
+Code execution runs in a sandboxed environment:
+- Blocked: `eval`, `require`, `import()`, `process`, `global`
+- File access restricted to working directory
+- Sensitive files blocked (`.env`, credentials, keys)
+- Memory limit: 128MB, Timeout: 30s
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run tests
+bun run test
+
+# Build
+bun run build
+
+# Start dev server
+bun run dev
+```
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](https://github.com/ArthurDEV44/distill/blob/main/CONTRIBUTING.md) for guidelines.
+
+**Priority areas:**
+- New language parsers (Java, C#, Kotlin)
+- SDK extensions
+- Documentation
+
+## License
+
+MIT
+
+---
+
+**[npm](https://www.npmjs.com/package/distill-mcp)** · **[GitHub](https://github.com/ArthurDEV44/distill)** · **[Documentation](https://github.com/ArthurDEV44/distill/tree/main/docs)**

package/bin/cli.js

@@ -12,15 +12,15 @@ const command = args[0];
 function showHelp() {
   const version = getPackageVersion();
   console.log(`
-${COLORS.bright}${COLORS.cyan}CtxOpt MCP Server${COLORS.reset} v${version}
-Context Engineering Optimizer for Claude Code, Cursor, and Windsurf
+${COLORS.bright}${COLORS.cyan}Distill MCP Server${COLORS.reset} v${version}
+Extract the essence. Compress the context. Save tokens.
 
 ${COLORS.bright}Usage:${COLORS.reset}
-  ctxopt-mcp <command> [options]
+  distill-mcp <command> [options]
 
 ${COLORS.bright}Commands:${COLORS.reset}
   serve             Start the MCP server (stdio mode)
-  setup             Configure IDEs to use CtxOpt
+  setup             Configure IDEs to use Distill
   doctor            Check installation and configuration
   analyze           Analyze files for token usage
 
@@ -47,20 +47,20 @@ ${COLORS.bright}Other Options:${COLORS.reset}
   --help, -h        Show this help message
 
 ${COLORS.bright}Examples:${COLORS.reset}
-  ctxopt-mcp setup                    Auto-detect and configure all IDEs
-  ctxopt-mcp setup --claude           Configure Claude Code only
-  ctxopt-mcp setup --claude --hooks   Configure Claude Code + install hooks
-  ctxopt-mcp setup --hooks            Install hooks only (current project)
-  ctxopt-mcp setup --force            Overwrite existing configurations
-  ctxopt-mcp doctor                   Verify installation
-  ctxopt-mcp serve                    Start MCP server (used by IDE)
-  ctxopt-mcp serve --lazy             Start with lazy mode (95% savings)
-  ctxopt-mcp serve --verbose          Start with verbose logging
-  ctxopt-mcp analyze                  Analyze token usage in codebase
-  ctxopt-mcp analyze -t 5000 --json   Custom threshold, JSON output
+  distill-mcp setup                    Auto-detect and configure all IDEs
+  distill-mcp setup --claude           Configure Claude Code only
+  distill-mcp setup --claude --hooks   Configure Claude Code + install hooks
+  distill-mcp setup --hooks            Install hooks only (current project)
+  distill-mcp setup --force            Overwrite existing configurations
+  distill-mcp doctor                   Verify installation
+  distill-mcp serve                    Start MCP server (used by IDE)
+  distill-mcp serve --lazy             Start with lazy mode (95% savings)
+  distill-mcp serve --verbose          Start with verbose logging
+  distill-mcp analyze                  Analyze token usage in codebase
+  distill-mcp analyze -t 5000 --json   Custom threshold, JSON output
 
 ${COLORS.bright}Documentation:${COLORS.reset}
-  https://ctxopt.dev/docs
+  https://distill.dev/docs
 `);
 }
 
@@ -121,7 +121,7 @@ async function main() {
 
     default: {
       console.error(`Unknown command: ${command}`);
-      console.error('Run "ctxopt-mcp --help" for usage information.');
+      console.error('Run "distill-mcp --help" for usage information.');
       process.exit(1);
     }
   }

package/dist/cli/doctor.js

@@ -1,6 +1,6 @@
 import { execSync } from "child_process";
 import { existsSync } from "fs";
-import { detectInstalledIDEs, readJSONFile, isCtxOptConfigured, success, warn, error, log, COLORS, getPackageVersion, } from "./utils.js";
+import { detectInstalledIDEs, readJSONFile, isDistillConfigured, success, warn, error, log, COLORS, getPackageVersion, } from "./utils.js";
 function checkNodeVersion() {
     try {
         const version = process.version;
@@ -30,20 +30,20 @@ function checkNodeVersion() {
 }
 function checkPackageInstallation() {
     try {
-        // Check if ctxopt-mcp is in PATH
+        // Check if distill-mcp is in PATH
         const which = process.platform === "win32" ? "where" : "which";
-        execSync(`${which} ctxopt-mcp`, { stdio: "pipe" });
+        execSync(`${which} distill-mcp`, { stdio: "pipe" });
         return {
             name: "Package installation",
             status: "pass",
-            message: `@ctxopt/mcp-server v${getPackageVersion()} installed globally`,
+            message: `distill-mcp v${getPackageVersion()} installed globally`,
         };
     }
     catch {
         return {
             name: "Package installation",
             status: "warn",
-            message: "ctxopt-mcp not found in PATH (may be running via npx)",
+            message: "distill-mcp not found in PATH (may be running via npx)",
         };
     }
 }
@@ -68,25 +68,25 @@ function checkIDEConfigurations() {
             });
             continue;
         }
-        if (isCtxOptConfigured(configFile)) {
+        if (isDistillConfigured(configFile)) {
             results.push({
                 name: `${config.name} configuration`,
                 status: "pass",
-                message: `CtxOpt configured in ${config.configPath}`,
+                message: `Distill configured in ${config.configPath}`,
             });
         }
         else {
             results.push({
                 name: `${config.name} configuration`,
                 status: "fail",
-                message: `CtxOpt not configured. Run 'ctxopt-mcp setup --${ide}'`,
+                message: `Distill not configured. Run 'distill-mcp setup --${ide}'`,
             });
         }
     }
     return results;
 }
 export async function doctor() {
-    log(`\n${COLORS.bright}${COLORS.cyan}CtxOpt MCP Server Doctor${COLORS.reset}\n`);
+    log(`\n${COLORS.bright}${COLORS.cyan}Distill MCP Server Doctor${COLORS.reset}\n`);
     log(`Running diagnostic checks...\n`);
     const checks = [
         checkNodeVersion(),
@@ -114,14 +114,14 @@ export async function doctor() {
     }
     log("\n" + "─".repeat(50));
     if (failCount === 0 && warnCount === 0) {
-        success(`All ${passCount} checks passed! CtxOpt is ready to use.`);
+        success(`All ${passCount} checks passed! Distill is ready to use.`);
     }
     else if (failCount === 0) {
-        warn(`${passCount} passed, ${warnCount} warnings. CtxOpt should work but may have limited functionality.`);
+        warn(`${passCount} passed, ${warnCount} warnings. Distill should work but may have limited functionality.`);
     }
     else {
         error(`${passCount} passed, ${warnCount} warnings, ${failCount} failed.`);
-        log(`\nRun ${COLORS.cyan}ctxopt-mcp setup${COLORS.reset} to fix configuration issues.`);
+        log(`\nRun ${COLORS.cyan}distill-mcp setup${COLORS.reset} to fix configuration issues.`);
     }
     log("");
 }

package/dist/cli/hooks.d.ts

@@ -1,5 +1,5 @@
 /**
- * CtxOpt Hooks Installation Module
+ * Distill Hooks Installation Module
  *
  * Installs Claude Code hooks that suggest MCP tool usage:
  * - PreToolUse: Suggests smart_file_read for code files (non-blocking for Edit compatibility)

package/dist/cli/hooks.js

@@ -1,5 +1,5 @@
 /**
- * CtxOpt Hooks Installation Module
+ * Distill Hooks Installation Module
  *
  * Installs Claude Code hooks that suggest MCP tool usage:
  * - PreToolUse: Suggests smart_file_read for code files (non-blocking for Edit compatibility)
@@ -13,7 +13,7 @@ import { success, warn, info, error, log, COLORS, readJSONFile, writeJSONFile }
 // Hook Script Templates
 // ============================================================================
 const PRE_READ_CHECK_SCRIPT = `#!/bin/bash
-# CtxOpt - PreToolUse Hook for Read
+# Distill - PreToolUse Hook for Read
 # Suggests smart_file_read for code files (non-blocking to allow Edit to work)
 
 INPUT=$(cat)
@@ -35,7 +35,7 @@ fi
 if echo "$FILE_PATH" | grep -qE "\\.(ts|tsx|js|jsx|py|go|rs|java|cpp|c|h|hpp)$"; then
   # Use systemMessage to suggest without blocking (allows Edit to work)
   cat << EOF
-{"systemMessage": "TIP: Consider using mcp__ctxopt__smart_file_read for '\$BASENAME' to save 50-70% tokens. Example: mcp__ctxopt__smart_file_read filePath=\\"\$FILE_PATH\\" target={\\"type\\":\\"function\\",\\"name\\":\\"myFunc\\"}"}
+{"systemMessage": "TIP: Consider using mcp__distill__smart_file_read for '\$BASENAME' to save 50-70% tokens. Example: mcp__distill__smart_file_read filePath=\\"\$FILE_PATH\\" target={\\"type\\":\\"function\\",\\"name\\":\\"myFunc\\"}"}
 EOF
   exit 0
 fi
@@ -44,7 +44,7 @@ fi
 exit 0
 `;
 const POST_BASH_REMIND_SCRIPT = `#!/bin/bash
-# CtxOpt - PostToolUse Hook for Bash
+# Distill - PostToolUse Hook for Bash
 # Reminds to use MCP tools for large outputs
 
 INPUT=$(cat)
@@ -61,29 +61,29 @@ fi
 
 # Detect content type and suggest appropriate tool
 if echo "$TOOL_RESPONSE" | grep -qiE "(error TS|warning TS|error\\[E|npm ERR|ERROR in|failed|FAILED)"; then
-  echo '{"systemMessage": "TIP: Large build output detected. Use mcp__ctxopt__auto_optimize to compress errors (95%+ reduction)."}'
+  echo '{"systemMessage": "TIP: Large build output detected. Use mcp__distill__auto_optimize to compress errors (95%+ reduction)."}'
   exit 0
 fi
 
 if echo "$TOOL_RESPONSE" | grep -qiE "(\\[INFO\\]|\\[ERROR\\]|\\[WARN\\]|\\[DEBUG\\]|[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2})"; then
-  echo '{"systemMessage": "TIP: Large log output detected. Use mcp__ctxopt__summarize_logs to compress (80-90% reduction)."}'
+  echo '{"systemMessage": "TIP: Large log output detected. Use mcp__distill__summarize_logs to compress (80-90% reduction)."}'
   exit 0
 fi
 
 # Generic large output
-echo '{"systemMessage": "TIP: Large output ('$RESPONSE_SIZE' chars). Consider using mcp__ctxopt__auto_optimize for compression (40-60% reduction)."}'
+echo '{"systemMessage": "TIP: Large output ('$RESPONSE_SIZE' chars). Consider using mcp__distill__auto_optimize for compression (40-60% reduction)."}'
 exit 0
 `;
 const PROMPT_INJECT_SCRIPT = `#!/bin/bash
-# CtxOpt - UserPromptSubmit Hook
+# Distill - UserPromptSubmit Hook
 # Injects MCP tool reminders at the start of each prompt
 
 cat << 'EOF'
 <user-prompt-submit-hook>
-CTXOPT REMINDER: Use MCP tools for token optimization:
-- Code files: mcp__ctxopt__smart_file_read (50-70% savings vs Read)
-- Build/test output: mcp__ctxopt__auto_optimize
-- Session stats: mcp__ctxopt__session_stats
+DISTILL REMINDER: Use MCP tools for token optimization:
+- Code files: mcp__distill__smart_file_read (50-70% savings vs Read)
+- Build/test output: mcp__distill__auto_optimize
+- Session stats: mcp__distill__session_stats
 </user-prompt-submit-hook>
 EOF
 exit 0
@@ -133,7 +133,7 @@ function createHooksConfig() {
 export async function installHooks(options = {}) {
     const projectDir = options.projectDir || process.cwd();
     const force = options.force || false;
-    log(`\n${COLORS.bright}Installing CtxOpt hooks...${COLORS.reset}\n`);
+    log(`\n${COLORS.bright}Installing Distill hooks...${COLORS.reset}\n`);
     // Check for jq dependency
     info("Checking dependencies...");
     const jqCheck = checkJqInstalled();

package/dist/cli/setup.js

@@ -1,14 +1,14 @@
-import { detectInstalledIDEs, readJSONFile, writeJSONFile, getMCPServerConfig, isCtxOptConfigured, success, warn, error, info, log, COLORS, } from "./utils.js";
+import { detectInstalledIDEs, readJSONFile, writeJSONFile, getMCPServerConfig, isDistillConfigured, success, warn, error, info, log, COLORS, } from "./utils.js";
 import { installHooks } from "./hooks.js";
 function configureIDE(ide, config, force) {
     log(`\nConfiguring ${COLORS.bright}${config.name}${COLORS.reset}...`);
     const existingConfig = readJSONFile(config.configPath) || {};
-    if (isCtxOptConfigured(existingConfig) && !force) {
-        warn(`CtxOpt already configured in ${config.name}. Use --force to overwrite.`);
+    if (isDistillConfigured(existingConfig) && !force) {
+        warn(`Distill already configured in ${config.name}. Use --force to overwrite.`);
         return true;
     }
     const mcpServers = existingConfig.mcpServers || {};
-    mcpServers.ctxopt = getMCPServerConfig();
+    mcpServers.distill = getMCPServerConfig();
     existingConfig.mcpServers = mcpServers;
     if (writeJSONFile(config.configPath, existingConfig)) {
         success(`Configured ${config.name} at ${config.configPath}`);
@@ -20,7 +20,7 @@ function configureIDE(ide, config, force) {
     }
 }
 export async function setup(options = {}) {
-    log(`\n${COLORS.bright}${COLORS.cyan}CtxOpt MCP Server Setup${COLORS.reset}\n`);
+    log(`\n${COLORS.bright}${COLORS.cyan}Distill MCP Server Setup${COLORS.reset}\n`);
     const ideConfigs = detectInstalledIDEs();
     const specificIDEs = options.claude || options.cursor || options.windsurf;
     const hooksOnly = options.hooks && !specificIDEs;
@@ -53,9 +53,9 @@ export async function setup(options = {}) {
         log("  • Cursor");
         log("  • Windsurf");
         log("\nYou can manually configure by running:");
-        log("  ctxopt-mcp setup --claude");
-        log("  ctxopt-mcp setup --cursor");
-        log("  ctxopt-mcp setup --windsurf");
+        log("  distill-mcp setup --claude");
+        log("  distill-mcp setup --cursor");
+        log("  distill-mcp setup --windsurf");
         return;
     }
     if (idesToConfigure.length > 0) {
@@ -88,8 +88,8 @@ export async function setup(options = {}) {
     }
     log(`\n${COLORS.dim}Next steps:${COLORS.reset}`);
     log("  1. Restart your IDE to load the MCP server");
-    log("  2. Run 'ctxopt-mcp doctor' to verify the installation");
-    log(`  3. Visit ${COLORS.cyan}https://ctxopt.dev/docs${COLORS.reset} for documentation\n`);
+    log("  2. Run 'distill-mcp doctor' to verify the installation");
+    log(`  3. Visit ${COLORS.cyan}https://distill.dev/docs${COLORS.reset} for documentation\n`);
 }
 export function parseSetupArgs(args) {
     const options = {};

package/dist/cli/utils.d.ts

@@ -25,6 +25,6 @@ export declare function detectInstalledIDEs(): Record<IDE, IDEConfig>;
 export declare function readJSONFile(path: string): Record<string, unknown> | null;
 export declare function writeJSONFile(path: string, data: Record<string, unknown>): boolean;
 export declare function getMCPServerConfig(): Record<string, unknown>;
-export declare function isCtxOptConfigured(config: Record<string, unknown> | null): boolean;
+export declare function isDistillConfigured(config: Record<string, unknown> | null): boolean;
 export declare function getPackageVersion(): string;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,MAAM;;;;;;;;;CASlB,CAAC;AAEF,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAgC1D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAS5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUzE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAWlF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAIlF;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,GAAG,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,MAAM;;;;;;;;;CASlB,CAAC;AAEF,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAgC1D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAS5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUzE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAWlF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAInF;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C"}

package/dist/cli/utils.js

@@ -93,16 +93,16 @@ export function writeJSONFile(path, data) {
 }
 export function getMCPServerConfig() {
     return {
-        command: "ctxopt-mcp",
+        command: "distill-mcp",
         args: ["serve"],
         env: {},
     };
 }
-export function isCtxOptConfigured(config) {
+export function isDistillConfigured(config) {
     if (!config)
         return false;
     const mcpServers = config.mcpServers;
-    return mcpServers?.ctxopt !== undefined;
+    return mcpServers?.distill !== undefined;
 }
 export function getPackageVersion() {
     try {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * @ctxopt/mcp-server
+ * distill-mcp
  *
- * MCP Server for CtxOpt - Context Engineering Optimizer
+ * MCP Server for Distill - LLM Token Optimization
  *
  * Provides tools for analyzing and optimizing LLM context usage.
  */

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
- * @ctxopt/mcp-server
+ * distill-mcp
  *
- * MCP Server for CtxOpt - Context Engineering Optimizer
+ * MCP Server for Distill - LLM Token Optimization
  *
  * Provides tools for analyzing and optimizing LLM context usage.
  */

package/dist/middleware/chain.js

@@ -44,7 +44,7 @@ export class MiddlewareChain {
             timestamp: Date.now(),
         });
         // Also log for debugging
-        console.error(`[ctxopt] Middleware ${middlewareName} ${phase} error:`, err.message);
+        console.error(`[distill] Middleware ${middlewareName} ${phase} error:`, err.message);
     }
     /**
      * Execute beforeTool hooks for all middlewares

package/dist/sandbox/executor.d.ts

@@ -1,7 +1,7 @@
 /**
  * Sandbox Executor
  *
- * Executes user code in a sandboxed environment with ctxopt SDK.
+ * Executes user code in a sandboxed environment with Distill SDK.
  * Uses Function constructor with restricted scope for isolation.
  */
 import type { ExecutionContext, ExecutionResult } from "./types.js";

package/dist/sandbox/executor.js

@@ -1,7 +1,7 @@
 /**
  * Sandbox Executor
  *
- * Executes user code in a sandboxed environment with ctxopt SDK.
+ * Executes user code in a sandboxed environment with Distill SDK.
  * Uses Function constructor with restricted scope for isolation.
  */
 import * as fs from "fs";

package/dist/sandbox/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Sandbox Module
  *
- * Provides safe code execution with ctxopt SDK.
+ * Provides safe code execution with Distill SDK.
  */
 export { executeSandbox } from "./executor.js";
 export { analyzeCode, sanitizeError } from "./security/index.js";

package/dist/sandbox/index.js

@@ -1,7 +1,7 @@
 /**
  * Sandbox Module
  *
- * Provides safe code execution with ctxopt SDK.
+ * Provides safe code execution with Distill SDK.
  */
 export { executeSandbox } from "./executor.js";
 export { analyzeCode, sanitizeError } from "./security/index.js";

package/dist/server.js

@@ -45,7 +45,7 @@ export async function createServer(config = {}) {
         });
         if (config.verbose) {
             const savings = calculateLazySavings();
-            console.error(`[ctxopt] Lazy mode: ${savings.savingsPercent}% token savings`);
+            console.error(`[distill] Lazy mode: ${savings.savingsPercent}% token savings`);
         }
     }
     else if (mode === "all") {
@@ -75,7 +75,7 @@ export async function createServer(config = {}) {
     });
     // Create MCP server
     const server = new Server({
-        name: "@ctxopt/mcp-server",
+        name: "distill-mcp",
         version: "0.1.0",
     }, {
         capabilities: {
@@ -124,10 +124,10 @@ export async function runServer(config = {}) {
     // Handle server close event
     server.onclose = async () => {
         if (config.verbose) {
-            console.error("[ctxopt] Server connection closed");
+            console.error("[distill] Server connection closed");
         }
         process.exit(0);
     };
     await server.connect(transport);
-    console.error("CtxOpt MCP Server running on stdio");
+    console.error("Distill MCP Server running on stdio");
 }

package/dist/tools/analyze-context.js

@@ -1,6 +1,6 @@
 import { encodingForModel } from "js-tiktoken";
 import { z } from "zod";
-import { ANTHROPIC_MODELS, calculateCost, formatCost, calculateContextUsage, } from "@ctxopt/shared";
+import { ANTHROPIC_MODELS, calculateCost, formatCost, calculateContextUsage, } from "@distill/shared";
 export const analyzeContextSchema = {
     type: "object",
     properties: {

package/dist/tools/code-execute.d.ts

@@ -1,7 +1,7 @@
 /**
  * Code Execute Tool
  *
- * Executes TypeScript code with ctxopt SDK in a sandboxed environment.
+ * Executes TypeScript code with Distill SDK in a sandboxed environment.
  * Reduces MCP token overhead by ~98% compared to individual tool calls.
  */
 import type { ToolDefinition } from "./registry.js";

package/dist/tools/code-execute.js

@@ -1,7 +1,7 @@
 /**
  * Code Execute Tool
  *
- * Executes TypeScript code with ctxopt SDK in a sandboxed environment.
+ * Executes TypeScript code with Distill SDK in a sandboxed environment.
  * Reduces MCP token overhead by ~98% compared to individual tool calls.
  */
 import { executeSandbox, DEFAULT_LIMITS } from "../sandbox/index.js";
@@ -67,7 +67,7 @@ async function executeCodeExecute(args) {
 /**
  * Tool description with SDK reference
  */
-const DESCRIPTION = `Execute TypeScript with ctxopt SDK. 98% fewer tokens than tool calls.
+const DESCRIPTION = `Execute TypeScript with Distill SDK. 98% fewer tokens than tool calls.
 
 SDK (ctx):
   compress: auto(content,hint?) logs(logs) diff(diff) semantic(content,ratio?)

package/dist/tools/context-budget.js

@@ -8,7 +8,7 @@ import { z } from "zod";
 import { countTokens } from "../utils/token-counter.js";
 import { detectContentType } from "../utils/content-detector.js";
 import { estimateOutputTokens } from "../utils/output-estimator.js";
-import { ANTHROPIC_MODELS, DEFAULT_MODEL, calculateCost, formatCost, calculateContextUsage, } from "@ctxopt/shared";
+import { ANTHROPIC_MODELS, DEFAULT_MODEL, calculateCost, formatCost, calculateContextUsage, } from "@distill/shared";
 /**
  * JSON Schema for MCP tool registration
  */

package/dist/tools/dynamic-loader.js

@@ -30,7 +30,7 @@ export const TOOL_CATALOG = [
         name: "code_execute",
         category: "core",
         keywords: ["execute", "code", "sdk", "typescript", "script", "sandbox"],
-        description: "Execute TypeScript with ctxopt SDK (98% token savings)",
+        description: "Execute TypeScript with Distill SDK (98% token savings)",
         loader: async () => (await import("./code-execute.js")).codeExecuteTool,
     },
     // Compress category

package/dist/tools/lazy-mcp.js

@@ -33,7 +33,7 @@ async function executeBrowseTools(args) {
                 categories.set(tool.category, (categories.get(tool.category) || 0) + 1);
             }
         }
-        const lines = ["ctxopt/", ""];
+        const lines = ["distill/", ""];
         for (const [cat, count] of categories) {
             lines.push(`  ${cat}/ (${count} tools)`);
         }
@@ -48,7 +48,7 @@ async function executeBrowseTools(args) {
             content: [{ type: "text", text: `No tools in category: ${category}` }],
         };
     }
-    const lines = [`ctxopt/${category}/`, ""];
+    const lines = [`distill/${category}/`, ""];
     for (const tool of tools) {
         lines.push(`  ${tool.name}: ${tool.description}`);
     }

package/dist/tools/lazy-mcp.test.js

@@ -18,7 +18,7 @@ describe("Lazy MCP Pattern", () => {
         it("should list categories when no category specified", async () => {
             const result = await browseToolsTool.execute({});
             const text = result.content[0]?.text ?? "";
-            expect(text).toContain("ctxopt/");
+            expect(text).toContain("distill/");
             expect(text).toContain("compress/");
             expect(text).toContain("analyze/");
             expect(text).toContain("logs/");
@@ -28,7 +28,7 @@ describe("Lazy MCP Pattern", () => {
         it("should list tools in a specific category", async () => {
             const result = await browseToolsTool.execute({ category: "compress" });
             const text = result.content[0]?.text ?? "";
-            expect(text).toContain("ctxopt/compress/");
+            expect(text).toContain("distill/compress/");
             expect(text).toContain("compress_context");
             expect(text).toContain("semantic_compress");
         });

package/dist/tools/optimization-tips.js

@@ -125,8 +125,8 @@ export async function optimizationTips(args, _config) {
     const result = `${tips}
 
 ---
-*Tips from CtxOpt - Context Engineering Optimizer*
-*Learn more at https://ctxopt.dev*`;
+*Tips from Distill - LLM Token Optimization*
+*Learn more at https://distill.dev*`;
     return {
         content: [{ type: "text", text: result }],
     };

package/dist/utils/token-counter.js

@@ -16,7 +16,7 @@ function getEncoder() {
             encoder = encodingForModel("gpt-4");
         }
         catch (error) {
-            console.error("[ctxopt] Failed to initialize tiktoken encoder:", error);
+            console.error("[distill] Failed to initialize tiktoken encoder:", error);
             return null;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "distill-mcp",
-  "version": "0.6.0-beta",
+  "version": "0.6.1-beta",
   "description": "Distill - MCP Server for LLM token optimization and context compression",
   "type": "module",
   "bin": {
@@ -29,7 +29,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@ctxopt/shared": "workspace:*",
+    "@distill/shared": "workspace:*",
     "@huggingface/transformers": "^3.8.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "js-tiktoken": "^1.0.15",
@@ -56,7 +56,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/ArthurDEV44/ctxopt.git",
+    "url": "https://github.com/ArthurDEV44/distill.git",
     "directory": "packages/mcp-server"
   },
   "license": "MIT"

package/scripts/install.ps1

@@ -1,12 +1,12 @@
-# CtxOpt MCP Server Installation Script for Windows
-# https://ctxopt.dev
+# Distill MCP Server Installation Script for Windows
+# https://distill.dev
 #
 # Usage:
-#   irm https://ctxopt.dev/install.ps1 | iex
+#   irm https://distill.dev/install.ps1 | iex
 #
 # This script will:
 #   1. Detect your package manager
-#   2. Install @ctxopt/mcp-server globally
+#   2. Install distill-mcp globally
 #   3. Auto-configure detected IDEs (Claude Code, Cursor, Windsurf)
 #   4. Verify the installation
 
@@ -50,13 +50,13 @@ function Test-NodeVersion {
 function Install-Package {
     param([string]$PackageManager)
 
-    Write-Info "Installing @ctxopt/mcp-server using $PackageManager..."
+    Write-Info "Installing distill-mcp using $PackageManager..."
 
     switch ($PackageManager) {
-        "bun" { bun install -g @ctxopt/mcp-server }
-        "npm" { npm install -g @ctxopt/mcp-server }
-        "yarn" { yarn global add @ctxopt/mcp-server }
-        "pnpm" { pnpm add -g @ctxopt/mcp-server }
+        "bun" { bun install -g distill-mcp }
+        "npm" { npm install -g distill-mcp }
+        "yarn" { yarn global add distill-mcp }
+        "pnpm" { pnpm add -g distill-mcp }
         default {
             Write-Error "No supported package manager found."
             Write-Host ""
@@ -74,7 +74,7 @@ function Install-Package {
 function Main {
     Write-Host ""
     Write-Host "================================================" -ForegroundColor Cyan
-    Write-Host "     CtxOpt MCP Server Installation" -ForegroundColor Cyan
+    Write-Host "     Distill MCP Server Installation" -ForegroundColor Cyan
     Write-Host "================================================" -ForegroundColor Cyan
     Write-Host ""
 
@@ -96,12 +96,12 @@ function Main {
 
     # Verify installation
     Write-Host ""
-    if (Get-Command ctxopt-mcp -ErrorAction SilentlyContinue) {
-        $version = ctxopt-mcp --version 2>$null
+    if (Get-Command distill-mcp -ErrorAction SilentlyContinue) {
+        $version = distill-mcp --version 2>$null
         if (-not $version) { $version = "unknown" }
-        Write-Success "ctxopt-mcp v$version is now available"
+        Write-Success "distill-mcp v$version is now available"
     } else {
-        Write-Warning "ctxopt-mcp not found in PATH. You may need to restart your terminal."
+        Write-Warning "distill-mcp not found in PATH. You may need to restart your terminal."
     }
 
     # Run setup
@@ -109,11 +109,11 @@ function Main {
     Write-Info "Configuring IDEs..."
     Write-Host ""
 
-    if (Get-Command ctxopt-mcp -ErrorAction SilentlyContinue) {
-        ctxopt-mcp setup
+    if (Get-Command distill-mcp -ErrorAction SilentlyContinue) {
+        distill-mcp setup
     } else {
         # Fallback to npx if global install didn't add to PATH yet
-        npx @ctxopt/mcp-server setup
+        npx distill-mcp setup
     }
 
     # Final message
@@ -122,10 +122,10 @@ function Main {
     Write-Host ""
     Write-Host "Next steps:"
     Write-Host "  1. Restart your IDE to load the MCP server"
-    Write-Host "  2. Run 'ctxopt-mcp doctor' to verify everything is working"
+    Write-Host "  2. Run 'distill-mcp doctor' to verify everything is working"
     Write-Host ""
     Write-Host "Documentation: " -NoNewline
-    Write-Host "https://ctxopt.dev/docs" -ForegroundColor Cyan
+    Write-Host "https://distill.dev/docs" -ForegroundColor Cyan
     Write-Host ""
 }
 

package/scripts/install.sh

@@ -1,14 +1,14 @@
 #!/bin/bash
 
-# CtxOpt MCP Server Installation Script
-# https://ctxopt.dev
+# Distill MCP Server Installation Script
+# https://distill.dev
 #
 # Usage:
-#   curl -fsSL https://ctxopt.dev/install.sh | bash
+#   curl -fsSL https://distill.dev/install.sh | bash
 #
 # This script will:
 #   1. Detect your OS and package manager
-#   2. Install @ctxopt/mcp-server globally
+#   2. Install distill-mcp globally
 #   3. Auto-configure detected IDEs (Claude Code, Cursor, Windsurf)
 #   4. Verify the installation
 
@@ -92,20 +92,20 @@ check_node() {
 install_package() {
     local pm=$1
 
-    log "Installing @ctxopt/mcp-server using $pm..."
+    log "Installing distill-mcp using $pm..."
 
     case "$pm" in
         bun)
-            bun install -g @ctxopt/mcp-server
+            bun install -g distill-mcp
             ;;
         npm)
-            npm install -g @ctxopt/mcp-server
+            npm install -g distill-mcp
             ;;
         yarn)
-            yarn global add @ctxopt/mcp-server
+            yarn global add distill-mcp
             ;;
         pnpm)
-            pnpm add -g @ctxopt/mcp-server
+            pnpm add -g distill-mcp
             ;;
         *)
             error "No supported package manager found."
@@ -125,7 +125,7 @@ install_package() {
 main() {
     echo ""
     echo -e "${BOLD}${CYAN}╔══════════════════════════════════════════╗${NC}"
-    echo -e "${BOLD}${CYAN}║     CtxOpt MCP Server Installation       ║${NC}"
+    echo -e "${BOLD}${CYAN}║     Distill MCP Server Installation       ║${NC}"
     echo -e "${BOLD}${CYAN}╚══════════════════════════════════════════╝${NC}"
     echo ""
 
@@ -148,11 +148,11 @@ main() {
 
     # Verify installation
     echo ""
-    if command -v ctxopt-mcp &> /dev/null; then
-        VERSION=$(ctxopt-mcp --version 2>/dev/null || echo "unknown")
-        success "ctxopt-mcp v$VERSION is now available"
+    if command -v distill-mcp &> /dev/null; then
+        VERSION=$(distill-mcp --version 2>/dev/null || echo "unknown")
+        success "distill-mcp v$VERSION is now available"
     else
-        warn "ctxopt-mcp not found in PATH. You may need to restart your terminal."
+        warn "distill-mcp not found in PATH. You may need to restart your terminal."
     fi
 
     # Run setup
@@ -160,11 +160,11 @@ main() {
     log "Configuring IDEs..."
     echo ""
 
-    if command -v ctxopt-mcp &> /dev/null; then
-        ctxopt-mcp setup
+    if command -v distill-mcp &> /dev/null; then
+        distill-mcp setup
     else
         # Fallback to npx if global install didn't add to PATH yet
-        npx @ctxopt/mcp-server setup
+        npx distill-mcp setup
     fi
 
     # Final message
@@ -173,9 +173,9 @@ main() {
     echo ""
     echo "Next steps:"
     echo "  1. Restart your IDE to load the MCP server"
-    echo "  2. Run 'ctxopt-mcp doctor' to verify everything is working"
+    echo "  2. Run 'distill-mcp doctor' to verify everything is working"
     echo ""
-    echo -e "Documentation: ${CYAN}https://ctxopt.dev/docs${NC}"
+    echo -e "Documentation: ${CYAN}https://distill.dev/docs${NC}"
     echo ""
 }
 

package/scripts/pre-commit-hook.sh

@@ -1,12 +1,12 @@
 #!/bin/bash
 #
-# CtxOpt Pre-commit Hook
+# Distill Pre-commit Hook
 #
 # Warns about files with high token counts that may cause issues
 # with AI coding assistants.
 #
 # Installation:
-#   ctxopt-mcp setup --hooks
+#   distill-mcp setup --hooks
 #   OR
 #   cp scripts/pre-commit-hook.sh .git/hooks/pre-commit
 #   chmod +x .git/hooks/pre-commit
@@ -24,17 +24,17 @@ GREEN='\033[0;32m'
 CYAN='\033[0;36m'
 NC='\033[0m' # No Color
 
-# Check if ctxopt-mcp is installed
-if ! command -v ctxopt-mcp &> /dev/null; then
+# Check if distill-mcp is installed
+if ! command -v distill-mcp &> /dev/null; then
     # Try npx as fallback
     if command -v npx &> /dev/null; then
-        CTXOPT_CMD="npx @anthropic-ai/ctxopt-mcp"
+        CTXOPT_CMD="npx @anthropic-ai/distill-mcp"
     else
-        echo -e "${YELLOW}Warning: ctxopt-mcp not found. Skipping token analysis.${NC}"
+        echo -e "${YELLOW}Warning: distill-mcp not found. Skipping token analysis.${NC}"
         exit 0
     fi
 else
-    CTXOPT_CMD="ctxopt-mcp"
+    CTXOPT_CMD="distill-mcp"
 fi
 
 # Get staged files (only source code files)
@@ -54,7 +54,7 @@ for file in $STAGED_FILES; do
     fi
 
     # Get token count using a simple wc-based estimate
-    # More accurate counting requires the full ctxopt-mcp analyze
+    # More accurate counting requires the full distill-mcp analyze
     LINES=$(wc -l < "$file" 2>/dev/null || echo "0")
     WORDS=$(wc -w < "$file" 2>/dev/null || echo "0")
 
@@ -72,7 +72,7 @@ done
 if [ "$WARNINGS" -gt 0 ]; then
     echo ""
     echo -e "${YELLOW}$WARNINGS file(s) may have high token counts.${NC}"
-    echo -e "Consider using CtxOpt tools when working with these files:"
+    echo -e "Consider using Distill tools when working with these files:"
     echo -e "  - ${CYAN}smart_file_read${NC}: Extract specific functions/classes"
     echo -e "  - ${CYAN}code_skeleton${NC}: Get signatures only"
     echo ""