better-gemini-mcp 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,160 @@
+/**
+ * Structured logging utility for Better Gemini MCP Server
+ * Implements logging with levels: error, warn, info, debug
+ * NEVER logs sensitive credentials like GEMINI_API_KEY
+ */
+import { LOG_PREFIX } from "../constants.js";
+/**
+ * List of sensitive patterns that should be filtered from logs
+ */
+const SENSITIVE_PATTERNS = [
+    /GEMINI_API_KEY[=:]\s*["']?[^"'\s]+["']?/gi,
+    /api[_-]?key[=:]\s*["']?[^"'\s]+["']?/gi,
+    /authorization[=:]\s*["']?[^"'\s]+["']?/gi,
+    /bearer\s+[a-zA-Z0-9_-]+/gi,
+    /token[=:]\s*["']?[^"'\s]+["']?/gi,
+];
+/**
+ * Check if debug logging is enabled via DEBUG env var
+ */
+function isDebugEnabled() {
+    return process.env.DEBUG === "true" || process.env.DEBUG === "1";
+}
+/**
+ * Get ISO timestamp for log entries
+ */
+function getTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Sanitize a message by removing sensitive credential patterns
+ */
+function sanitize(message) {
+    let sanitized = message;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        sanitized = sanitized.replace(pattern, "[REDACTED]");
+    }
+    return sanitized;
+}
+/**
+ * Format a log message with timestamp, level, and prefix
+ */
+function formatMessage(level, message) {
+    const sanitizedMessage = sanitize(message);
+    return `[${getTimestamp()}] [${level.toUpperCase()}] ${LOG_PREFIX} ${sanitizedMessage}`;
+}
+/**
+ * Safely stringify any value for logging, handling circular references
+ */
+function safeStringify(value) {
+    if (value === undefined)
+        return "undefined";
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return value;
+    if (value instanceof Error) {
+        return `${value.name}: ${value.message}${value.stack ? `\n${value.stack}` : ""}`;
+    }
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Logger class for structured logging
+ */
+export class Logger {
+    /**
+     * Log an error message (always logged)
+     */
+    static error(message, ...args) {
+        const formatted = formatMessage("error", message);
+        if (args.length > 0) {
+            const argsStr = args.map((arg) => sanitize(safeStringify(arg))).join(" ");
+            console.error(formatted, argsStr);
+        }
+        else {
+            console.error(formatted);
+        }
+    }
+    /**
+     * Log a warning message (always logged)
+     */
+    static warn(message, ...args) {
+        const formatted = formatMessage("warn", message);
+        if (args.length > 0) {
+            const argsStr = args.map((arg) => sanitize(safeStringify(arg))).join(" ");
+            console.error(formatted, argsStr);
+        }
+        else {
+            console.error(formatted);
+        }
+    }
+    /**
+     * Log an info message (always logged)
+     */
+    static info(message, ...args) {
+        const formatted = formatMessage("info", message);
+        if (args.length > 0) {
+            const argsStr = args.map((arg) => sanitize(safeStringify(arg))).join(" ");
+            console.error(formatted, argsStr);
+        }
+        else {
+            console.error(formatted);
+        }
+    }
+    /**
+     * Log a debug message (only when DEBUG env var is set)
+     */
+    static debug(message, ...args) {
+        if (!isDebugEnabled())
+            return;
+        const formatted = formatMessage("debug", message);
+        if (args.length > 0) {
+            const argsStr = args.map((arg) => sanitize(safeStringify(arg))).join(" ");
+            console.error(formatted, argsStr);
+        }
+        else {
+            console.error(formatted);
+        }
+    }
+    /**
+     * Log a tool invocation (sanitized parameters, excludes full prompts)
+     */
+    static toolInvocation(toolName, args) {
+        // Create a copy with truncated prompt for logging
+        const sanitizedArgs = { ...args };
+        if (typeof sanitizedArgs.prompt === "string" && sanitizedArgs.prompt.length > 100) {
+            sanitizedArgs.prompt = sanitizedArgs.prompt.substring(0, 100) + "...[truncated]";
+        }
+        this.info(`Tool invocation: ${toolName}`, sanitizedArgs);
+    }
+    /**
+     * Log command execution (command args, not output)
+     */
+    static commandExecution(command, args, startTime) {
+        // Filter out the actual prompt content from args (it's the last argument after -p)
+        const safeArgs = args.map((arg, index) => {
+            // If previous arg was -p or --prompt, truncate this arg
+            if (index > 0 && (args[index - 1] === "-p" || args[index - 1] === "--prompt")) {
+                return arg.length > 100 ? arg.substring(0, 100) + "...[truncated]" : arg;
+            }
+            return arg;
+        });
+        this.debug(`[${startTime}] Executing: ${command} ${safeArgs.join(" ")}`);
+    }
+    /**
+     * Log command completion with timing
+     */
+    static commandComplete(startTime, exitCode, outputLength) {
+        const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+        this.debug(`[${elapsed}s] Process finished with exit code: ${exitCode}`);
+        if (outputLength !== undefined) {
+            this.debug(`Response length: ${outputLength} chars`);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/pathValidator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Path validation utility for security enforcement
+ * Ensures all paths are within project root (PRD §6.1, §6.2)
+ */
+import type { PathValidationResult } from "../types.js";
+/**
+ * Validate a path for security and existence
+ *
+ * @param inputPath - The path to validate (relative or absolute)
+ * @param projectRoot - The project root directory (absolute path)
+ * @returns PathValidationResult with validation details
+ */
+export declare function validatePath(inputPath: string, projectRoot: string): PathValidationResult;
+/**
+ * Check if an absolute path is within the project root
+ *
+ * @param absolutePath - The absolute path to check
+ * @param projectRoot - The project root directory (absolute path)
+ * @returns true if the path is within project root
+ */
+export declare function isWithinProjectRoot(absolutePath: string, projectRoot: string): boolean;
+/**
+ * Extract @path references from a prompt string
+ *
+ * @param prompt - The prompt string to scan
+ * @returns Array of path strings found in the prompt
+ */
+export declare function extractAtPathReferences(prompt: string): string[];
+/**
+ * Validate all @path references in a prompt
+ *
+ * @param prompt - The prompt string to validate
+ * @param projectRoot - The project root directory
+ * @returns Array of validation results for each @path reference
+ */
+export declare function validatePromptPaths(prompt: string, projectRoot: string): PathValidationResult[];
+/**
+ * Check if a prompt contains any invalid @path references
+ *
+ * @param prompt - The prompt string to check
+ * @param projectRoot - The project root directory
+ * @returns Object with isValid flag and array of invalid paths
+ */
+export declare function checkPromptPathsValid(prompt: string, projectRoot: string): {
+    isValid: boolean;
+    invalidPaths: PathValidationResult[];
+};
+/**
+ * Get the project root directory
+ * Uses PROJECT_ROOT env var if set, otherwise process.cwd()
+ *
+ * @returns The project root directory (absolute path)
+ */
+export declare function getProjectRoot(): string;
+//# sourceMappingURL=pathValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathValidator.d.ts","sourceRoot":"","sources":["../../src/utils/pathValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQxD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAiDzF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CActF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYhE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,oBAAoB,EAAE,CAGxB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/utils/pathValidator.js

@@ -0,0 +1,137 @@
+/**
+ * Path validation utility for security enforcement
+ * Ensures all paths are within project root (PRD §6.1, §6.2)
+ */
+import * as path from "path";
+import * as fs from "fs";
+/**
+ * Regex pattern to extract @path references from prompts
+ * Matches @<path> patterns (e.g., @src/auth.ts, @./config.json)
+ */
+const AT_PATH_PATTERN = /@([\w./-]+)/g;
+/**
+ * Validate a path for security and existence
+ *
+ * @param inputPath - The path to validate (relative or absolute)
+ * @param projectRoot - The project root directory (absolute path)
+ * @returns PathValidationResult with validation details
+ */
+export function validatePath(inputPath, projectRoot) {
+    // Normalize the project root
+    const normalizedRoot = path.resolve(projectRoot);
+    // Resolve the input path relative to project root
+    let resolved;
+    if (path.isAbsolute(inputPath)) {
+        resolved = path.resolve(inputPath);
+    }
+    else {
+        resolved = path.resolve(normalizedRoot, inputPath);
+    }
+    // Normalize to handle any .. or . in the path
+    resolved = path.normalize(resolved);
+    // Check if path is within project root
+    const allowed = isWithinProjectRoot(resolved, normalizedRoot);
+    // Check if path exists
+    let exists = false;
+    if (allowed) {
+        try {
+            fs.accessSync(resolved);
+            exists = true;
+        }
+        catch {
+            exists = false;
+        }
+    }
+    // Build result
+    const result = {
+        input: inputPath,
+        resolved,
+        exists,
+        allowed,
+    };
+    // Add reason for disallowed paths
+    if (!allowed) {
+        if (inputPath.includes("..")) {
+            result.reason = "Path contains parent directory traversal (..)";
+        }
+        else {
+            result.reason = "Path is outside project root";
+        }
+    }
+    else if (!exists) {
+        result.reason = "Path does not exist";
+    }
+    return result;
+}
+/**
+ * Check if an absolute path is within the project root
+ *
+ * @param absolutePath - The absolute path to check
+ * @param projectRoot - The project root directory (absolute path)
+ * @returns true if the path is within project root
+ */
+export function isWithinProjectRoot(absolutePath, projectRoot) {
+    // Normalize both paths
+    const normalizedPath = path.normalize(absolutePath);
+    const normalizedRoot = path.normalize(projectRoot);
+    // Check if the path starts with the project root
+    // Add trailing separator to avoid matching partial directory names
+    // e.g., /home/user/project-test should not match /home/user/project
+    const rootWithSep = normalizedRoot.endsWith(path.sep)
+        ? normalizedRoot
+        : normalizedRoot + path.sep;
+    // Path is within root if it equals root or starts with root + separator
+    return normalizedPath === normalizedRoot || normalizedPath.startsWith(rootWithSep);
+}
+/**
+ * Extract @path references from a prompt string
+ *
+ * @param prompt - The prompt string to scan
+ * @returns Array of path strings found in the prompt
+ */
+export function extractAtPathReferences(prompt) {
+    const matches = [];
+    let match;
+    // Reset regex state
+    AT_PATH_PATTERN.lastIndex = 0;
+    while ((match = AT_PATH_PATTERN.exec(prompt)) !== null) {
+        matches.push(match[1]);
+    }
+    return matches;
+}
+/**
+ * Validate all @path references in a prompt
+ *
+ * @param prompt - The prompt string to validate
+ * @param projectRoot - The project root directory
+ * @returns Array of validation results for each @path reference
+ */
+export function validatePromptPaths(prompt, projectRoot) {
+    const paths = extractAtPathReferences(prompt);
+    return paths.map((p) => validatePath(p, projectRoot));
+}
+/**
+ * Check if a prompt contains any invalid @path references
+ *
+ * @param prompt - The prompt string to check
+ * @param projectRoot - The project root directory
+ * @returns Object with isValid flag and array of invalid paths
+ */
+export function checkPromptPathsValid(prompt, projectRoot) {
+    const results = validatePromptPaths(prompt, projectRoot);
+    const invalidPaths = results.filter((r) => !r.allowed);
+    return {
+        isValid: invalidPaths.length === 0,
+        invalidPaths,
+    };
+}
+/**
+ * Get the project root directory
+ * Uses PROJECT_ROOT env var if set, otherwise process.cwd()
+ *
+ * @returns The project root directory (absolute path)
+ */
+export function getProjectRoot() {
+    return process.env.PROJECT_ROOT || process.cwd();
+}
+//# sourceMappingURL=pathValidator.js.map

package/dist/utils/pathValidator.js.map

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

package/dist/utils/responseCache.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Response cache utility for chunked responses
+ * Implements in-memory cache with 1-hour TTL (PRD §5.7)
+ */
+import type { CacheEntry, CachedChunk } from "../types.js";
+/**
+ * Generate a unique cache key
+ *
+ * @returns Cache key in format "cache_<random>"
+ */
+export declare function generateCacheKey(): string;
+/**
+ * Store chunked response in cache
+ *
+ * @param chunks - Array of cached chunks to store
+ * @param ttlMs - Time-to-live in milliseconds (default: 1 hour)
+ * @returns The generated cache key
+ */
+export declare function cacheResponse(chunks: CachedChunk[], ttlMs?: number): string;
+/**
+ * Retrieve cached response by key
+ *
+ * @param key - The cache key
+ * @returns CacheEntry if found and not expired, null otherwise
+ */
+export declare function getResponse(key: string): CacheEntry | null;
+/**
+ * Get a specific chunk from cached response
+ *
+ * @param key - The cache key
+ * @param chunkIndex - 1-based chunk index
+ * @returns The chunk if found, null otherwise
+ */
+export declare function getChunk(key: string, chunkIndex: number): CachedChunk | null;
+/**
+ * Check if a cache key exists and is valid
+ *
+ * @param key - The cache key
+ * @returns true if key exists and not expired
+ */
+export declare function hasValidCache(key: string): boolean;
+/**
+ * Get cache entry metadata without full content
+ *
+ * @param key - The cache key
+ * @returns Metadata object or null if not found
+ */
+export declare function getCacheMetadata(key: string): {
+    totalChunks: number;
+    expiresAt: Date;
+    createdAt: Date;
+} | null;
+/**
+ * Delete a cache entry
+ *
+ * @param key - The cache key to delete
+ * @returns true if entry was deleted
+ */
+export declare function deleteCache(key: string): boolean;
+/**
+ * Clear all expired cache entries
+ *
+ * @returns Number of entries removed
+ */
+export declare function clearExpired(): number;
+/**
+ * Clear the entire cache
+ */
+export declare function clearAll(): void;
+/**
+ * Get current cache statistics
+ *
+ * @returns Object with cache stats
+ */
+export declare function getCacheStats(): {
+    size: number;
+    oldestEntry: Date | null;
+    newestEntry: Date | null;
+};
+//# sourceMappingURL=responseCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responseCache.d.ts","sourceRoot":"","sources":["../../src/utils/responseCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ3D;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,GAAE,MAA8B,GACpC,MAAM,CAgBR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAc1D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAa5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GACV;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAYlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAYrC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B,CAkBA"}

package/dist/utils/responseCache.js

@@ -0,0 +1,179 @@
+/**
+ * Response cache utility for chunked responses
+ * Implements in-memory cache with 1-hour TTL (PRD §5.7)
+ */
+import { DEFAULTS } from "../constants.js";
+/**
+ * In-memory cache storage
+ */
+const cache = new Map();
+/**
+ * Generate a unique cache key
+ *
+ * @returns Cache key in format "cache_<random>"
+ */
+export function generateCacheKey() {
+    const random = Math.random().toString(36).substring(2, 10);
+    const timestamp = Date.now().toString(36);
+    return `cache_${timestamp}${random}`;
+}
+/**
+ * Store chunked response in cache
+ *
+ * @param chunks - Array of cached chunks to store
+ * @param ttlMs - Time-to-live in milliseconds (default: 1 hour)
+ * @returns The generated cache key
+ */
+export function cacheResponse(chunks, ttlMs = DEFAULTS.CACHE_TTL_MS) {
+    const key = generateCacheKey();
+    const now = Date.now();
+    const entry = {
+        chunks,
+        createdAt: now,
+        expiresAt: now + ttlMs,
+    };
+    cache.set(key, entry);
+    // Schedule cleanup of expired entries
+    scheduleCleanup();
+    return key;
+}
+/**
+ * Retrieve cached response by key
+ *
+ * @param key - The cache key
+ * @returns CacheEntry if found and not expired, null otherwise
+ */
+export function getResponse(key) {
+    const entry = cache.get(key);
+    if (!entry) {
+        return null;
+    }
+    // Check if expired
+    if (Date.now() > entry.expiresAt) {
+        cache.delete(key);
+        return null;
+    }
+    return entry;
+}
+/**
+ * Get a specific chunk from cached response
+ *
+ * @param key - The cache key
+ * @param chunkIndex - 1-based chunk index
+ * @returns The chunk if found, null otherwise
+ */
+export function getChunk(key, chunkIndex) {
+    const entry = getResponse(key);
+    if (!entry) {
+        return null;
+    }
+    // Validate chunk index (1-based)
+    if (chunkIndex < 1 || chunkIndex > entry.chunks.length) {
+        return null;
+    }
+    return entry.chunks[chunkIndex - 1];
+}
+/**
+ * Check if a cache key exists and is valid
+ *
+ * @param key - The cache key
+ * @returns true if key exists and not expired
+ */
+export function hasValidCache(key) {
+    return getResponse(key) !== null;
+}
+/**
+ * Get cache entry metadata without full content
+ *
+ * @param key - The cache key
+ * @returns Metadata object or null if not found
+ */
+export function getCacheMetadata(key) {
+    const entry = getResponse(key);
+    if (!entry) {
+        return null;
+    }
+    return {
+        totalChunks: entry.chunks.length,
+        expiresAt: new Date(entry.expiresAt),
+        createdAt: new Date(entry.createdAt),
+    };
+}
+/**
+ * Delete a cache entry
+ *
+ * @param key - The cache key to delete
+ * @returns true if entry was deleted
+ */
+export function deleteCache(key) {
+    return cache.delete(key);
+}
+/**
+ * Clear all expired cache entries
+ *
+ * @returns Number of entries removed
+ */
+export function clearExpired() {
+    const now = Date.now();
+    let removed = 0;
+    for (const [key, entry] of cache.entries()) {
+        if (now > entry.expiresAt) {
+            cache.delete(key);
+            removed++;
+        }
+    }
+    return removed;
+}
+/**
+ * Clear the entire cache
+ */
+export function clearAll() {
+    cache.clear();
+}
+/**
+ * Get current cache statistics
+ *
+ * @returns Object with cache stats
+ */
+export function getCacheStats() {
+    let oldest = null;
+    let newest = null;
+    for (const entry of cache.values()) {
+        if (oldest === null || entry.createdAt < oldest) {
+            oldest = entry.createdAt;
+        }
+        if (newest === null || entry.createdAt > newest) {
+            newest = entry.createdAt;
+        }
+    }
+    return {
+        size: cache.size,
+        oldestEntry: oldest ? new Date(oldest) : null,
+        newestEntry: newest ? new Date(newest) : null,
+    };
+}
+// ============================================================================
+// Cleanup scheduling
+// ============================================================================
+let cleanupScheduled = false;
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Schedule periodic cleanup of expired entries
+ */
+function scheduleCleanup() {
+    if (cleanupScheduled) {
+        return;
+    }
+    cleanupScheduled = true;
+    // Use unref() so the timer doesn't keep the process alive
+    const timer = setInterval(() => {
+        clearExpired();
+        // Stop cleanup if cache is empty
+        if (cache.size === 0) {
+            clearInterval(timer);
+            cleanupScheduled = false;
+        }
+    }, CLEANUP_INTERVAL_MS);
+    timer.unref();
+}
+//# sourceMappingURL=responseCache.js.map

package/dist/utils/responseCache.js.map

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

package/dist/utils/responseChunker.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Response chunker utility for splitting large responses
+ * Implements chunking with configurable size (PRD §5.2)
+ */
+import type { CachedChunk } from "../types.js";
+/**
+ * Chunk a response string into smaller pieces
+ *
+ * @param response - The full response string to chunk
+ * @param chunkSizeKB - Size of each chunk in kilobytes (default: 10KB)
+ * @returns Array of CachedChunk objects with metadata
+ */
+export declare function chunkResponse(response: string, chunkSizeKB?: number): CachedChunk[];
+/**
+ * Check if a response needs chunking
+ *
+ * @param response - The response string to check
+ * @param chunkSizeKB - Chunk size threshold in KB
+ * @returns true if the response exceeds the chunk size
+ */
+export declare function needsChunking(response: string, chunkSizeKB?: number): boolean;
+/**
+ * Get the number of chunks that would be created for a response
+ *
+ * @param response - The response string
+ * @param chunkSizeKB - Chunk size in KB
+ * @returns Estimated number of chunks
+ */
+export declare function estimateChunkCount(response: string, chunkSizeKB?: number): number;
+/**
+ * Get the chunk size configuration from environment or default
+ *
+ * @returns Chunk size in KB
+ */
+export declare function getChunkSizeKB(): number;
+//# sourceMappingURL=responseChunker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"responseChunker.d.ts","sourceRoot":"","sources":["../../src/utils/responseChunker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAwC,GACpD,WAAW,EAAE,CAuDf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAwC,GACpD,OAAO,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAwC,GACpD,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CASvC"}