trimprompt 1.0.2 → 1.0.3

package/aicg-spec/ui-spec.md

@@ -0,0 +1,135 @@
+# PromptShave.ai - User Interface Specification
+
+This document defines the Design System, color palette, page layouts, and interactive components for the **PromptShave.ai Dashboards**.
+
+---
+
+## 1. Design System & Theme (Premium Dark Mode)
+
+To provide a modern, high-tech, and satisfying user experience, both dashboards use a **glassmorphic dark theme** with vibrant accents. 
+
+Below is the design mockup representing the visual guidelines of PromptShave.ai:
+
+![PromptShave.ai Developer Dashboard UI Mockup](/C:/Users/97252/.gemini/antigravity/brain/7f14739d-502a-4438-b012-11a3701c97f3/promptshave_dashboard_mockup_1781605791503.png)
+
+* **Theme Background:** Deep Obsidian Black (`#0B0C10`) with radial gradient glow effects of Indigo (`#4F46E5` at 8% opacity) in the top-left and Emerald (`#10B981` at 8% opacity) in the bottom-right.
+* **Component Cards:** Semi-transparent dark slate (`rgba(26, 28, 35, 0.6)`) with a 1px border of `#2D313F` and a backdrop blur of `12px`.
+* **Typography:** System Sans-Serif (preferring Google Fonts: *Outfit* for headers, *Inter* for body text).
+* **Color Accents:**
+  * **Emerald Green (`#10B981`):** Represents token savings, cost savings, and positive ROI.
+  * **Indigo Purple (`#6366F1`):** Primary action buttons, selection indicators, and chart line highlights.
+  * **Coral Blue (`#3B82F6`):** Represents raw/uncompressed token volume.
+  * **Slate Gray (`#94A3B8`):** Subtext, labels, and secondary indicators.
+
+---
+
+## 2. Local Developer Dashboard Layout (`pshave ui`)
+
+The local UI runs on `http://localhost:4000` and displays personal stats read from the local SQLite database.
+
+```
++---------------------------------------------------------------------------------------------------+
+|  PromptShave.ai  [Developer Dashboard]                           Model: [ Claude 3.5 Sonnet v ]   |
++---------------------------------------------------------------------------------------------------+
+|  [ SAVINGS (USD) ]                [ REDUCTION RATE ]             [ TOKENS SHAVED ]                |
+|  $142.50                          84.2%                          47,500,000                       |
+|  saved in June                    avg. token compression         raw: 56.4M -> compressed: 8.9M   |
++---------------------------------------------------------------------------------------------------+
+|  TOKEN SAVINGS OVER TIME (Interactive Area Chart)                                                 |
+|  [ Chart: Coral Area (Raw Tokens) vs. Emerald Area (Compressed Tokens) over last 30 days ]        |
++---------------------------------------------------------------------------------------------------+
+|  RECENT COMMAND LOGS                                                                              |
+|  Timestamp | Command         | Raw Tokens | Compressed | Savings % | Action                       |
+|  11:32 AM  | git diff        | 7,200      | 320        | 95.5%     | [ Inspect Diff ]             |
+|  11:20 AM  | npm test        | 12,400     | 450        | 96.3%     | [ Inspect Diff ]             |
+|  11:05 AM  | kubectl get pods| 1,800      | 150        | 91.6%     | [ Inspect Diff ]             |
++---------------------------------------------------------------------------------------------------+
+```
+
+### Key Components:
+1. **Interactive Model Dropdown:** Allows the developer to select which LLM model they use (e.g. Claude 3.5 Sonnet, GPT-4o). When changed, the **Savings (USD)** card instantly recalculates based on the pricing data defined in `schema.md`.
+2. **Side-by-Side Diff Inspector:** Clicking `Inspect Diff` opens a modal showing a split view:
+   * **Left side (Raw output):** The full raw terminal log (collapsible, scrollable).
+   * **Right side (PromptShave output):** The highly compressed, redacted output that was actually sent to the LLM.
+   * This provides absolute transparency, letting the developer verify what code or data was filtered out.
+
+---
+
+## 3. Enterprise Manager Dashboard Layout (Hub Server)
+
+The enterprise dashboard aggregates logs across all developer laptops inside the organization to calculate total ROI.
+
+```
++---------------------------------------------------------------------------------------------------+
+|  PromptShave.ai  [Enterprise Hub Manager]                        Active Clients: [ 142 Devs ]     |
++---------------------------------------------------------------------------------------------------+
+|  [ TOTAL COMPANY SAVED (USD) ]    [ AVG REDUCTION ]   [ TOTAL TOKENS SAVED ]   [ DLP REDACTIONS ] |
+|  $12,450.00                       81.5%               4.15 Billion             1,842 Secrets      |
+|  cumulative ROI                   across all CLI tools  raw: 5.1B -> comp: 0.95B  prevented leaks |
++---------------------------------------------------------------------------------------------------+
+|  SAVINGS BY CLI TOOL (Horizontal Bar Chart)        | ADOPTION LEADERBOARD (SHA-256 Hashes)        |
+|  git diff    =========================== (45%)     | Dev_1a2b3c...: $340 saved (91% reduction)    |
+|  pytest      ================= (30%)               | Dev_4f5g6h...: $290 saved (85% reduction)    |
+|  npm install ========= (15%)                       | Dev_7x8y9z...: $210 saved (88% reduction)    |
+|  kubectl     ===== (10%)                           | Dev_2w3e4r...: $195 saved (82% reduction)    |
++---------------------------------------------------------------------------------------------------+
+|  CENTRAL POLICY MANAGER                                                                           |
+|  - Enable Global DLP secret scanning [On/Off]                                                     |
+|  - Telemetry Upload Interval: [ 5 minutes v ]                                                     |
+|  - Add Central DLP Regex Pattern: [_______________________] [ Add Rule ]                          |
++---------------------------------------------------------------------------------------------------+
+```
+
+### Key Components:
+1. **Total Company Saved (USD):** Calculates savings using aggregated telemetry records and active pricing rules.
+2. **Savings by CLI Tool Chart:** Highlights token savings per tool, helping managers spot where LLM usage is most inefficient.
+3. **Adoption Leaderboard:** Shows anonymous client IDs and their savings. This helps identify high-adoption teams without revealing developers' identities.
+4. **DLP Redactions Counter:** Displays the number of secrets (passwords, IP addresses, database strings) blocked and redacted by PromptShave client runtimes, showing security value in addition to financial savings.
+5. **Central Policy Manager:** Form allowing the admin to update configuration rules and push them dynamically to all developer machines in the next sync batch.
+
+---
+
+## 4. Local UI and SQLite DB Execution Flow
+
+This details how the local client application reads and presents data to the developer locally without any external dependencies.
+
+```
+[Developer runs: pshave ui]
+         |
+         v
+  Spawns Local Node Web Server (on localhost:4000)
+         |
+         v
+  Opens default web browser to http://localhost:4000
+         |
+         +--------> [Browser renders Local Dashboard SPA]
+                            |
+                            | (HTTP GET /api/stats)
+                            v
+                    [Local API Router]
+                            |
+                            | (Runs SQL query)
+                            v
+                    [SQLite Database (~/.promptshave/stats.db)]
+```
+
+### 1. The Local Database (`stats.db`):
+* Stored in the user's home directory: `~/.promptshave/stats.db`.
+* Handled via a standard, zero-dependency SQLite driver inside the client binary.
+* Every command run through `pshave` appends a row containing the timestamp, command metadata, raw character count, compressed character count, and the selected LLM model.
+
+### 2. The Local Web Server:
+* Built directly into the `pshave` npm package using a lightweight, fast web router (e.g. Express or Fastify).
+* When `pshave ui` is executed:
+  1. The CLI queries a free port (defaults to `4000`, falls back to `4001`, `4002` if bound).
+  2. Spawns the web server.
+  3. Uses the `open` package to automatically launch the default OS browser.
+  4. Keeps the process running in the foreground; pressing `Ctrl+C` in the terminal terminates the server.
+
+### 3. Personal Dashboard Frontend (SPA):
+* A pre-compiled single-page React/Vanilla JS application bundled with the global npm package, served statically from `localhost:4000`.
+* Reads SQLite tables via local JSON endpoints:
+  * `GET /api/stats/summary`: Returns aggregate tokens, percentages, and costs saved.
+  * `GET /api/stats/history`: Returns the list of recent command runs.
+  * `GET /api/stats/inspect/:id`: Returns the exact raw and compressed outputs of a specific run from the database for side-by-side diffing.
+* **100% Offline Capability:** Since the server, database, and assets are fully local, the dashboard is fully functional offline.

package/client/dist/cli.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const executor_1 = require("./executor");
+const filters_1 = require("./filters");
+const tracker_1 = require("./tracker");
+const shims_1 = require("./shims");
+const dashboard_1 = require("./dashboard");
+const program = new commander_1.Command();
+function isDisabled() {
+    return process.env.TRIMPROMPT_DISABLED === '1';
+}
+function adjustCommandArgs(cmd, args) {
+    const cmdLower = cmd.toLowerCase();
+    if (cmdLower === 'git' || cmdLower === 'yadm') {
+        const sub = args[0];
+        if (sub === 'status') {
+            const statusArgs = args.slice(1);
+            const isCompatible = statusArgs.length === 0 || statusArgs.every(arg => {
+                return arg === '-b' || arg === '--branch' || arg === '-sb' || arg === '-bs' || arg === '-s' || arg === '--short';
+            });
+            if (isCompatible) {
+                return { cmd, args: ['status', '--porcelain', '-b'] };
+            }
+        }
+        else if (sub === 'log') {
+            const logArgs = args.slice(1);
+            const hasFormat = logArgs.some(arg => arg.startsWith('--oneline') || arg.startsWith('--pretty') || arg.startsWith('--format'));
+            const hasLimit = logArgs.some(arg => (arg.startsWith('-') && /^\d+$/.test(arg.slice(1))) || arg === '-n' || arg.startsWith('--max-count'));
+            const newArgs = [...args];
+            if (!hasFormat) {
+                const formatStr = '--pretty=format:%h %s (%ar) (%an)%n%b%n---END---';
+                newArgs.push(process.platform === 'win32' ? `"${formatStr}"` : formatStr);
+            }
+            if (!hasLimit) {
+                if (hasFormat) {
+                    newArgs.push('-50');
+                }
+                else {
+                    newArgs.push('-10');
+                }
+            }
+            const hasMergeFlag = logArgs.some(arg => arg === '--merges' || arg === '--no-merges' || arg.startsWith('--min-parents'));
+            if (!hasMergeFlag && !hasLimit) {
+                newArgs.push('--no-merges');
+            }
+            return { cmd, args: newArgs };
+        }
+    }
+    return { cmd, args };
+}
+function isMcpServerExecution(cmd, args) {
+    const cmdLower = cmd.toLowerCase();
+    const argsString = args.join(' ').toLowerCase();
+    if (cmdLower.includes('mcp') && (cmdLower.includes('server') || cmdLower.includes('proxy'))) {
+        return true;
+    }
+    if (cmdLower === 'npx' || cmdLower === 'node' || cmdLower === 'bun' || cmdLower === 'npm' || cmdLower === 'pnpm' || cmdLower === 'yarn') {
+        if (argsString.includes('@modelcontextprotocol/') || argsString.includes('modelcontextprotocol') || argsString.includes('mcp-server') || argsString.includes('server-mcp')) {
+            return true;
+        }
+    }
+    if (args.some(arg => {
+        const l = arg.toLowerCase();
+        return l.includes('mcp-server') || l.includes('server-mcp') || l.includes('@modelcontextprotocol/') || l === 'mcp-proxy' || l === 'mcp';
+    })) {
+        return true;
+    }
+    return false;
+}
+async function runProxy(args) {
+    if (args.length === 0) {
+        program.help();
+        return;
+    }
+    const rawCmd = args[0];
+    const rawArgs = args.slice(1);
+    const commandLine = args.join(' ');
+    if (isDisabled()) {
+        const result = await (0, executor_1.executeCommand)(rawCmd, rawArgs);
+        process.stdout.write(result.stdout);
+        process.stderr.write(result.stderr);
+        process.exit(result.exitCode);
+    }
+    if (isMcpServerExecution(rawCmd, rawArgs)) {
+        console.error('[TrimPrompt] Autodetected MCP server execution. Activating real-time JSON-RPC proxy...');
+        const { runMcpProxy } = await Promise.resolve().then(() => __importStar(require('./mcp')));
+        runMcpProxy(rawCmd, rawArgs);
+        return;
+    }
+    const adjusted = adjustCommandArgs(rawCmd, rawArgs);
+    const result = await (0, executor_1.executeCommand)(adjusted.cmd, adjusted.args);
+    const compressed = (0, filters_1.compressOutput)(commandLine, result.stdout, result.stderr, tracker_1.tracker.getConfig().redaction_enabled);
+    const combinedRaw = result.stdout + (result.stderr.trim().length > 0 ? '\n' + result.stderr : '');
+    tracker_1.tracker.logExecution(commandLine, combinedRaw, compressed, result.exitCode);
+    if (result.exitCode === 0) {
+        process.stdout.write(compressed + '\n');
+    }
+    else {
+        process.stdout.write(compressed + '\n');
+        if (result.stderr.trim().length > 0 && !compressed.includes(result.stderr.trim())) {
+            process.stderr.write(result.stderr + '\n');
+        }
+    }
+    process.exit(result.exitCode);
+}
+program
+    .name('trim')
+    .description('TrimPrompt.ai - Reduce LLM token consumption by 60-90%')
+    .version('1.0.0');
+program
+    .command('ui')
+    .alias('dashboard')
+    .description('Start the local developer dashboard')
+    .option('-p, --port <number>', 'Port to run the dashboard on', '4000')
+    .action((options) => {
+    const port = parseInt(options.port, 10);
+    (0, dashboard_1.startDashboard)(port);
+});
+program
+    .command('stats')
+    .description('Show token and cost savings summary')
+    .option('-m, --model <string>', 'Select pricing model (e.g. claude-3-5-sonnet, gpt-4o)', 'claude-3-5-sonnet')
+    .action((options) => {
+    const summary = tracker_1.tracker.getStatsSummary(options.model);
+    console.log('\n=============================================');
+    console.log('       TRIMPROMPT.AI SAVINGS SUMMARY        ');
+    console.log('=============================================');
+    console.log(`Model Context:     ${summary.model_name}`);
+    console.log(`Raw Tokens:        ${summary.total_raw_tokens.toLocaleString()}`);
+    console.log(`Compressed:        ${summary.total_compressed_tokens.toLocaleString()}`);
+    console.log(`Tokens Saved:      ${summary.total_tokens_saved.toLocaleString()}`);
+    console.log(`Reduction Rate:    ${summary.savings_percentage}%`);
+    console.log(`Estimated Cost:    $${summary.raw_cost_usd.toFixed(4)} (before Shave)`);
+    console.log(`Actual Cost:       $${summary.compressed_cost_usd.toFixed(4)} (after Shave)`);
+    console.log(`---------------------------------------------`);
+    console.log(`Money Saved:       $${summary.money_saved_usd.toFixed(4)} USD`);
+    console.log('=============================================\n');
+});
+program
+    .command('config')
+    .description('Manage local configuration parameters')
+    .argument('<action>', 'get or set')
+    .argument('<key>', 'config parameter name')
+    .argument('[value]', 'value to set')
+    .action((action, key, value) => {
+    if (action === 'get') {
+        const config = tracker_1.tracker.getConfig();
+        console.log(`${key}: ${config[key]}`);
+    }
+    else if (action === 'set') {
+        if (value === undefined) {
+            console.error('Error: Value required for set action');
+            process.exit(1);
+        }
+        let parsedValue = value;
+        if (value === 'true')
+            parsedValue = true;
+        if (value === 'false')
+            parsedValue = false;
+        if (/^\d+$/.test(value))
+            parsedValue = parseInt(value, 10);
+        tracker_1.tracker.setConfig(key, parsedValue);
+        console.log(`Config set ${key} = ${value}`);
+    }
+    else {
+        console.error('Error: Action must be get or set');
+        process.exit(1);
+    }
+});
+program
+    .command('shims')
+    .description('Install or uninstall system command shims')
+    .argument('<action>', 'install or uninstall')
+    .action((action) => {
+    if (action === 'install') {
+        const result = (0, shims_1.installShims)();
+        console.log(result.message);
+    }
+    else if (action === 'uninstall') {
+        const result = (0, shims_1.uninstallShims)();
+        console.log(result.message);
+    }
+    else {
+        console.error('Error: Action must be install or uninstall');
+        process.exit(1);
+    }
+});
+program
+    .command('rewrite')
+    .description('Check a command line and return the optimized command line')
+    .argument('<commandLine>', 'Command line to evaluate')
+    .action((commandLine) => {
+    if (isDisabled()) {
+        console.log(commandLine);
+        return;
+    }
+    const rewritten = (0, filters_1.rewriteCommand)(commandLine);
+    console.log(rewritten);
+});
+program
+    .command('mcp-proxy')
+    .alias('mcp')
+    .description('Proxy wrapper for Model Context Protocol (MCP) servers to compact tool outputs')
+    .argument('<server-command>', 'Command to launch the target MCP server')
+    .argument('[server-args...]', 'Arguments for the target MCP server')
+    .action(async (serverCmd, serverArgs) => {
+    const { runMcpProxy } = await Promise.resolve().then(() => __importStar(require('./mcp')));
+    runMcpProxy(serverCmd, serverArgs);
+});
+const args = process.argv.slice(2);
+const firstArg = args[0];
+const subcommands = ['ui', 'dashboard', 'stats', 'config', 'shims', 'rewrite', 'mcp-proxy', 'mcp', 'help', '--help', '-h', 'version', '--version', '-v'];
+if (firstArg && !subcommands.includes(firstArg)) {
+    runProxy(args).catch(err => {
+        console.error(`[TrimPrompt] Fatal Proxy Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+else {
+    program.parse(process.argv);
+}

package/client/dist/dashboard.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDashboard = startDashboard;
+const express_1 = __importDefault(require("express"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const open_1 = __importDefault(require("open"));
+const tracker_1 = require("./tracker");
+const app = (0, express_1.default)();
+const baseDir = path.join(os.homedir(), '.trimprompt');
+const logsDir = path.join(baseDir, 'logs');
+app.get('/', (req, res) => {
+    const htmlPath = path.join(__dirname, 'index.html');
+    if (fs.existsSync(htmlPath)) {
+        res.sendFile(htmlPath);
+    }
+    else {
+        res.sendFile(path.join(__dirname, '../src/index.html'));
+    }
+});
+app.get('/api/stats/summary', (req, res) => {
+    const model = req.query.model || 'auto';
+    const summary = tracker_1.tracker.getStatsSummary(model);
+    res.json(summary);
+});
+app.get('/api/stats/history', (req, res) => {
+    const logs = tracker_1.tracker.getLogs();
+    res.json(logs);
+});
+app.get('/api/stats/inspect/:id', (req, res) => {
+    const logId = req.params.id;
+    const rawPath = path.join(logsDir, `${logId}.raw.txt`);
+    const compPath = path.join(logsDir, `${logId}.comp.txt`);
+    let raw = 'Raw output log file not found.';
+    let compressed = 'Compressed output log file not found.';
+    try {
+        if (fs.existsSync(rawPath)) {
+            raw = fs.readFileSync(rawPath, 'utf8');
+        }
+        if (fs.existsSync(compPath)) {
+            compressed = fs.readFileSync(compPath, 'utf8');
+        }
+    }
+    catch (err) {
+    }
+    res.json({ id: logId, raw, compressed });
+});
+function startDashboard(startPort = 4000) {
+    let port = startPort;
+    const server = app.listen(port, () => {
+        const url = `http://localhost:${port}`;
+        console.log(`\n[TrimPrompt] Dashboard server started at: ${url}`);
+        console.log(`Press Ctrl+C in this terminal to shut down.`);
+        (0, open_1.default)(url).catch(() => {
+        });
+    });
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            startDashboard(port + 1);
+        }
+        else {
+            console.error(`[TrimPrompt] Dashboard error: ${err.message}`);
+        }
+    });
+}

package/client/dist/executor.js

@@ -0,0 +1,80 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeCommand = executeCommand;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+function executeCommand(cmdName, args) {
+    return new Promise((resolve) => {
+        const shimsDir = path.join(os.homedir(), '.trimprompt', 'shims');
+        const cleanPath = (process.env.PATH || '')
+            .split(path.delimiter)
+            .filter((p) => p.trim().toLowerCase() !== shimsDir.toLowerCase())
+            .join(path.delimiter);
+        const childEnv = {
+            ...process.env,
+            PATH: cleanPath,
+            TRIMPROMPT_DISABLED: '1'
+        };
+        const child = (0, child_process_1.spawn)(cmdName, args, {
+            stdio: ['inherit', 'pipe', 'pipe'],
+            shell: true,
+            env: childEnv
+        });
+        let stdoutData = '';
+        let stderrData = '';
+        child.stdout?.on('data', (data) => {
+            stdoutData += data.toString();
+        });
+        child.stderr?.on('data', (data) => {
+            stderrData += data.toString();
+        });
+        child.on('error', (err) => {
+            resolve({
+                exitCode: 1,
+                stdout: '',
+                stderr: `Failed to spawn command "${cmdName}": ${err.message}`
+            });
+        });
+        child.on('close', (code) => {
+            resolve({
+                exitCode: code ?? 0,
+                stdout: stdoutData,
+                stderr: stderrData
+            });
+        });
+    });
+}

package/client/dist/filters/generic.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripAnsi = stripAnsi;
+exports.collapseDuplicates = collapseDuplicates;
+exports.softTruncate = softTruncate;
+function stripAnsi(text) {
+    const ansiRegex = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+    return text.replace(ansiRegex, '');
+}
+function collapseDuplicates(text) {
+    const lines = text.split('\n');
+    if (lines.length <= 1)
+        return text;
+    const result = [];
+    let currentLine = lines[0];
+    let repeatCount = 1;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === currentLine && line.trim().length > 0) {
+            repeatCount++;
+        }
+        else {
+            if (repeatCount > 1) {
+                result.push(`${currentLine} [x${repeatCount}]`);
+            }
+            else {
+                result.push(currentLine);
+            }
+            currentLine = line;
+            repeatCount = 1;
+        }
+    }
+    if (repeatCount > 1) {
+        result.push(`${currentLine} [x${repeatCount}]`);
+    }
+    else {
+        result.push(currentLine);
+    }
+    return result.join('\n');
+}
+function softTruncate(text, maxChars = 20000) {
+    if (text.length <= maxChars)
+        return text;
+    const lines = text.split('\n');
+    if (lines.length <= 200) {
+        return text;
+    }
+    const firstCount = 50;
+    const lastCount = 150;
+    const firstLines = lines.slice(0, firstCount);
+    const lastLines = lines.slice(lines.length - lastCount);
+    const truncatedCount = text.length - (firstLines.join('\n').length + lastLines.join('\n').length);
+    return [
+        ...firstLines,
+        `\n... [TrimPrompt: Truncated ${truncatedCount} characters of output] ...\n`,
+        ...lastLines
+    ].join('\n');
+}