@jonnyhoo/ccs 1.0.0

package/dist/cliproxy/tool-name-mapper.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Tool Name Mapper
+ *
+ * Bidirectional mapping class to track original ↔ sanitized tool names.
+ * Used to restore original names in API responses after sanitization.
+ *
+ * Flow:
+ * 1. Request: registerTools() sanitizes names and stores mapping
+ * 2. Response: restoreToolUse() restores original names using mapping
+ */
+/** MCP tool definition from Claude API */
+export interface Tool {
+    name: string;
+    description?: string;
+    input_schema?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** Tool use content block from Claude API response */
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** Content block from Claude API response (union type) */
+export interface ContentBlock {
+    type: string;
+    [key: string]: unknown;
+}
+/** Record of a sanitization change */
+export interface SanitizationChange {
+    original: string;
+    sanitized: string;
+}
+/** Record of a hash collision */
+export interface HashCollision {
+    sanitized: string;
+    originals: string[];
+}
+/**
+ * Bidirectional mapper for tool name sanitization.
+ *
+ * Maintains a per-request mapping between sanitized and original tool names.
+ * Must be cleared between requests to avoid memory leaks.
+ */
+export declare class ToolNameMapper {
+    /** Map from sanitized name → original name */
+    private mapping;
+    /** List of all changes made during registration */
+    private changes;
+    /** List of detected hash collisions */
+    private collisions;
+    /**
+     * Register tools and sanitize their names.
+     * Stores mapping for later restoration.
+     *
+     * @param tools Array of tool definitions
+     * @returns Array of tools with sanitized names
+     */
+    registerTools(tools: Tool[]): Tool[];
+    /**
+     * Restore original tool names in content blocks.
+     * Looks for tool_use blocks and restores their names.
+     *
+     * @param content Array of content blocks from API response
+     * @returns Array with restored tool names
+     */
+    restoreToolUse(content: ContentBlock[]): ContentBlock[];
+    /**
+     * Restore tool name in a single tool_use block.
+     * Useful for streaming responses.
+     *
+     * @param name The sanitized tool name
+     * @returns Original name if mapped, otherwise the input name
+     */
+    restoreName(name: string): string;
+    /**
+     * Check if any sanitization occurred during registration.
+     */
+    hasChanges(): boolean;
+    /**
+     * Get all sanitization changes for logging.
+     */
+    getChanges(): SanitizationChange[];
+    /**
+     * Get the number of tools that were sanitized.
+     */
+    getChangeCount(): number;
+    /**
+     * Check if any hash collisions were detected.
+     * Collisions occur when multiple original names map to the same sanitized name.
+     */
+    hasCollisions(): boolean;
+    /**
+     * Get all detected hash collisions for logging/warning.
+     */
+    getCollisions(): HashCollision[];
+    /**
+     * Clear all mappings. Call between requests.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=tool-name-mapper.d.ts.map

package/dist/cliproxy/tool-name-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-mapper.d.ts","sourceRoot":"","sources":["../../src/cliproxy/tool-name-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,0CAA0C;AAC1C,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAkC;IAEjD,mDAAmD;IACnD,OAAO,CAAC,OAAO,CAA4B;IAE3C,uCAAuC;IACvC,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE;IAqCpC;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE;IAyBvD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,UAAU,IAAI,kBAAkB,EAAE;IAIlC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/cliproxy/tool-name-mapper.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Tool Name Mapper
+ *
+ * Bidirectional mapping class to track original ↔ sanitized tool names.
+ * Used to restore original names in API responses after sanitization.
+ *
+ * Flow:
+ * 1. Request: registerTools() sanitizes names and stores mapping
+ * 2. Response: restoreToolUse() restores original names using mapping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolNameMapper = void 0;
+const tool_name_sanitizer_1 = require("./tool-name-sanitizer");
+/**
+ * Bidirectional mapper for tool name sanitization.
+ *
+ * Maintains a per-request mapping between sanitized and original tool names.
+ * Must be cleared between requests to avoid memory leaks.
+ */
+class ToolNameMapper {
+    constructor() {
+        /** Map from sanitized name → original name */
+        this.mapping = new Map();
+        /** List of all changes made during registration */
+        this.changes = [];
+        /** List of detected hash collisions */
+        this.collisions = [];
+    }
+    /**
+     * Register tools and sanitize their names.
+     * Stores mapping for later restoration.
+     *
+     * @param tools Array of tool definitions
+     * @returns Array of tools with sanitized names
+     */
+    registerTools(tools) {
+        return tools.map((tool) => {
+            const result = (0, tool_name_sanitizer_1.sanitizeToolName)(tool.name);
+            if (result.changed) {
+                // Check for collision: sanitized name already maps to different original
+                const existingOriginal = this.mapping.get(result.sanitized);
+                if (existingOriginal && existingOriginal !== tool.name) {
+                    // Record collision
+                    const existing = this.collisions.find((c) => c.sanitized === result.sanitized);
+                    if (existing) {
+                        if (!existing.originals.includes(tool.name)) {
+                            existing.originals.push(tool.name);
+                        }
+                    }
+                    else {
+                        this.collisions.push({
+                            sanitized: result.sanitized,
+                            originals: [existingOriginal, tool.name],
+                        });
+                    }
+                }
+                // Store mapping: sanitized → original
+                this.mapping.set(result.sanitized, tool.name);
+                this.changes.push({
+                    original: tool.name,
+                    sanitized: result.sanitized,
+                });
+            }
+            return {
+                ...tool,
+                name: result.sanitized,
+            };
+        });
+    }
+    /**
+     * Restore original tool names in content blocks.
+     * Looks for tool_use blocks and restores their names.
+     *
+     * @param content Array of content blocks from API response
+     * @returns Array with restored tool names
+     */
+    restoreToolUse(content) {
+        return content.map((block) => {
+            if (block.type !== 'tool_use') {
+                return block;
+            }
+            // Type guard: we know this is a tool_use block
+            const toolUseName = block.name;
+            if (!toolUseName) {
+                return block;
+            }
+            const originalName = this.mapping.get(toolUseName);
+            if (originalName) {
+                return {
+                    ...block,
+                    name: originalName,
+                };
+            }
+            return block;
+        });
+    }
+    /**
+     * Restore tool name in a single tool_use block.
+     * Useful for streaming responses.
+     *
+     * @param name The sanitized tool name
+     * @returns Original name if mapped, otherwise the input name
+     */
+    restoreName(name) {
+        return this.mapping.get(name) ?? name;
+    }
+    /**
+     * Check if any sanitization occurred during registration.
+     */
+    hasChanges() {
+        return this.changes.length > 0;
+    }
+    /**
+     * Get all sanitization changes for logging.
+     */
+    getChanges() {
+        return [...this.changes];
+    }
+    /**
+     * Get the number of tools that were sanitized.
+     */
+    getChangeCount() {
+        return this.changes.length;
+    }
+    /**
+     * Check if any hash collisions were detected.
+     * Collisions occur when multiple original names map to the same sanitized name.
+     */
+    hasCollisions() {
+        return this.collisions.length > 0;
+    }
+    /**
+     * Get all detected hash collisions for logging/warning.
+     */
+    getCollisions() {
+        return [...this.collisions];
+    }
+    /**
+     * Clear all mappings. Call between requests.
+     */
+    clear() {
+        this.mapping.clear();
+        this.changes = [];
+        this.collisions = [];
+    }
+}
+exports.ToolNameMapper = ToolNameMapper;
+//# sourceMappingURL=tool-name-mapper.js.map

package/dist/cliproxy/tool-name-mapper.js.map

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

package/dist/cliproxy/tool-name-sanitizer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Tool Name Sanitizer
+ *
+ * Sanitizes MCP tool names to comply with Gemini API constraints:
+ * - Max 64 characters
+ * - Must start with letter or underscore
+ * - Only a-z A-Z 0-9 _ . : - / allowed
+ *
+ * Strategies:
+ * 1. Remove duplicate segments (e.g., gitmcp__foo__foo → gitmcp__foo)
+ * 2. Smart truncate with hash suffix if still >64 chars
+ *
+ * Note: Hash collision risk is ~1 in 16M with 6-char MD5 prefix.
+ * Acceptable for typical MCP tool counts (<1000 tools).
+ */
+/** Maximum tool name length allowed by Gemini API */
+export declare const GEMINI_MAX_TOOL_NAME_LENGTH = 64;
+/** Result of sanitization operation */
+export interface SanitizeResult {
+    /** The sanitized tool name */
+    sanitized: string;
+    /** Whether the name was changed */
+    changed: boolean;
+}
+/**
+ * Check if a tool name is valid for Gemini API.
+ *
+ * Requirements:
+ * - Length <= 64 characters
+ * - Starts with letter or underscore
+ * - Contains only valid characters: a-z A-Z 0-9 _ . : -
+ */
+export declare function isValidToolName(name: string): boolean;
+/**
+ * Remove consecutive duplicate segments separated by '__'.
+ *
+ * Examples:
+ * - 'gitmcp__foo__foo' → 'gitmcp__foo'
+ * - 'a__b__c__b__c' → 'a__b__c'
+ * - 'no_dupes' → 'no_dupes'
+ */
+export declare function removeDuplicateSegments(name: string): string;
+/**
+ * Smart truncate a name to fit within maxLen.
+ * Preserves start of name and appends hash suffix for uniqueness.
+ *
+ * Format: <prefix>_<6-char-hash>
+ *
+ * @param name The name to truncate
+ * @param maxLen Maximum allowed length (default: 64)
+ */
+export declare function smartTruncate(name: string, maxLen?: number): string;
+/**
+ * Sanitize a tool name to comply with Gemini API constraints.
+ *
+ * Process:
+ * 1. Remove duplicate segments (always, as duplicates are likely unintentional)
+ * 2. Truncate with hash if >64 chars
+ * 3. Return result with changed flag
+ *
+ * @param name The original tool name
+ * @returns Sanitization result with sanitized name and changed flag
+ */
+export declare function sanitizeToolName(name: string): SanitizeResult;
+//# sourceMappingURL=tool-name-sanitizer.d.ts.map

package/dist/cliproxy/tool-name-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-sanitizer.d.ts","sourceRoot":"","sources":["../../src/cliproxy/tool-name-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAK9C,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAUD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAoC,GAAG,MAAM,CAWhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmB7D"}

package/dist/cliproxy/tool-name-sanitizer.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Tool Name Sanitizer
+ *
+ * Sanitizes MCP tool names to comply with Gemini API constraints:
+ * - Max 64 characters
+ * - Must start with letter or underscore
+ * - Only a-z A-Z 0-9 _ . : - / allowed
+ *
+ * Strategies:
+ * 1. Remove duplicate segments (e.g., gitmcp__foo__foo → gitmcp__foo)
+ * 2. Smart truncate with hash suffix if still >64 chars
+ *
+ * Note: Hash collision risk is ~1 in 16M with 6-char MD5 prefix.
+ * Acceptable for typical MCP tool counts (<1000 tools).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeToolName = exports.smartTruncate = exports.removeDuplicateSegments = exports.isValidToolName = exports.GEMINI_MAX_TOOL_NAME_LENGTH = void 0;
+const crypto_1 = require("crypto");
+/** Maximum tool name length allowed by Gemini API */
+exports.GEMINI_MAX_TOOL_NAME_LENGTH = 64;
+/** Valid characters pattern for Gemini tool names */
+const VALID_CHARS_REGEX = /^[a-zA-Z_][a-zA-Z0-9_.:/-]*$/;
+/**
+ * Check if a tool name is valid for Gemini API.
+ *
+ * Requirements:
+ * - Length <= 64 characters
+ * - Starts with letter or underscore
+ * - Contains only valid characters: a-z A-Z 0-9 _ . : -
+ */
+function isValidToolName(name) {
+    if (!name || name.length === 0) {
+        return false;
+    }
+    if (name.length > exports.GEMINI_MAX_TOOL_NAME_LENGTH) {
+        return false;
+    }
+    return VALID_CHARS_REGEX.test(name);
+}
+exports.isValidToolName = isValidToolName;
+/**
+ * Remove consecutive duplicate segments separated by '__'.
+ *
+ * Examples:
+ * - 'gitmcp__foo__foo' → 'gitmcp__foo'
+ * - 'a__b__c__b__c' → 'a__b__c'
+ * - 'no_dupes' → 'no_dupes'
+ */
+function removeDuplicateSegments(name) {
+    const segments = name.split('__');
+    const deduped = [];
+    for (const segment of segments) {
+        // Only add if different from previous segment
+        if (deduped.length === 0 || deduped[deduped.length - 1] !== segment) {
+            deduped.push(segment);
+        }
+    }
+    return deduped.join('__');
+}
+exports.removeDuplicateSegments = removeDuplicateSegments;
+/**
+ * Generate a short hash from a string for truncation suffix.
+ * Uses first 6 characters of MD5 hash (16M combinations).
+ */
+function generateShortHash(input) {
+    return (0, crypto_1.createHash)('md5').update(input).digest('hex').slice(0, 6);
+}
+/**
+ * Smart truncate a name to fit within maxLen.
+ * Preserves start of name and appends hash suffix for uniqueness.
+ *
+ * Format: <prefix>_<6-char-hash>
+ *
+ * @param name The name to truncate
+ * @param maxLen Maximum allowed length (default: 64)
+ */
+function smartTruncate(name, maxLen = exports.GEMINI_MAX_TOOL_NAME_LENGTH) {
+    if (name.length <= maxLen) {
+        return name;
+    }
+    // Format: prefix + '_' + 6-char hash = 7 chars for suffix
+    const hash = generateShortHash(name);
+    const prefixLen = maxLen - 7; // 7 = '_' (1) + hash (6)
+    const prefix = name.slice(0, prefixLen);
+    return `${prefix}_${hash}`;
+}
+exports.smartTruncate = smartTruncate;
+/**
+ * Sanitize a tool name to comply with Gemini API constraints.
+ *
+ * Process:
+ * 1. Remove duplicate segments (always, as duplicates are likely unintentional)
+ * 2. Truncate with hash if >64 chars
+ * 3. Return result with changed flag
+ *
+ * @param name The original tool name
+ * @returns Sanitization result with sanitized name and changed flag
+ */
+function sanitizeToolName(name) {
+    // Step 1: Always try to remove duplicate segments
+    // Duplicates like gitmcp__foo__foo are likely unintentional from MCP naming
+    let sanitized = removeDuplicateSegments(name);
+    // Step 2: Truncate if still too long
+    if (sanitized.length > exports.GEMINI_MAX_TOOL_NAME_LENGTH) {
+        sanitized = smartTruncate(sanitized);
+    }
+    // Step 3: If still invalid after sanitization, apply truncation to original
+    if (!isValidToolName(sanitized)) {
+        sanitized = smartTruncate(name);
+    }
+    return {
+        sanitized,
+        changed: sanitized !== name,
+    };
+}
+exports.sanitizeToolName = sanitizeToolName;
+//# sourceMappingURL=tool-name-sanitizer.js.map

package/dist/cliproxy/tool-name-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-sanitizer.js","sourceRoot":"","sources":["../../src/cliproxy/tool-name-sanitizer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,mCAAoC;AAEpC,qDAAqD;AACxC,QAAA,2BAA2B,GAAG,EAAE,CAAC;AAE9C,qDAAqD;AACrD,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAUzD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,mCAA2B,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AARD,0CAQC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,8CAA8C;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAZD,0DAYC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,IAAA,mBAAU,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,IAAY,EAAE,SAAiB,mCAA2B;IACtF,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,yBAAyB;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAExC,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAXD,sCAWC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,kDAAkD;IAClD,4EAA4E;IAC5E,IAAI,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAE9C,qCAAqC;IACrC,IAAI,SAAS,CAAC,MAAM,GAAG,mCAA2B,EAAE,CAAC;QACnD,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,4EAA4E;IAC5E,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,SAAS;QACT,OAAO,EAAE,SAAS,KAAK,IAAI;KAC5B,CAAC;AACJ,CAAC;AAnBD,4CAmBC"}

package/dist/cliproxy/tool-sanitization-proxy.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tool Sanitization Proxy
+ *
+ * HTTP proxy that intercepts Claude CLI → CLIProxy requests to:
+ * 1. Sanitize MCP tool names exceeding Gemini's 64-char limit
+ * 2. Forward sanitized requests to upstream
+ * 3. Restore original names in responses
+ *
+ * Follows CodexReasoningProxy pattern for consistency.
+ */
+export interface ToolSanitizationProxyConfig {
+    /** Upstream CLIProxy URL */
+    upstreamBaseUrl: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Log warnings when sanitization occurs */
+    warnOnSanitize?: boolean;
+    /** Request timeout in milliseconds */
+    timeoutMs?: number;
+}
+export declare class ToolSanitizationProxy {
+    private server;
+    private port;
+    private readonly config;
+    private readonly logFilePath;
+    private readonly debugMode;
+    constructor(config: ToolSanitizationProxyConfig);
+    /**
+     * Initialize log file path and ensure directory exists.
+     */
+    private initLogFile;
+    /**
+     * Write log entry to file (always) and console (if CCS_DEBUG=1).
+     */
+    private writeLog;
+    private log;
+    private warn;
+    /**
+     * Start the proxy server on an ephemeral port.
+     * @returns The assigned port number
+     */
+    start(): Promise<number>;
+    /**
+     * Stop the proxy server.
+     */
+    stop(): void;
+    /**
+     * Get the port the proxy is listening on.
+     */
+    getPort(): number | null;
+    private readBody;
+    private handleRequest;
+    private buildForwardHeaders;
+    private getRequestFn;
+    private forwardRaw;
+    /**
+     * Forward JSON request and buffer response for tool name restoration.
+     */
+    private forwardJsonBuffered;
+    /**
+     * Forward JSON request and stream response with tool name restoration.
+     * Handles SSE (Server-Sent Events) format.
+     */
+    private forwardJsonStreaming;
+    /**
+     * Process a single SSE event, restoring tool names if present.
+     */
+    private processSSEEvent;
+}
+//# sourceMappingURL=tool-sanitization-proxy.d.ts.map

package/dist/cliproxy/tool-sanitization-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-sanitization-proxy.d.ts","sourceRoot":"","sources":["../../src/cliproxy/tool-sanitization-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,MAAM,WAAW,2BAA2B;IAC1C,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,MAAM,EAAE,2BAA2B;IAW/C;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,IAAI;IAMZ;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAmB9B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB,OAAO,CAAC,QAAQ;YAqBF,aAAa;IA6E3B,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;IA+BlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsE3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAsE5B;;OAEG;IACH,OAAO,CAAC,eAAe;CAqDxB"}