better-gemini-mcp 1.0.0

package/dist/utils/responseChunker.js

@@ -0,0 +1,96 @@
+/**
+ * Response chunker utility for splitting large responses
+ * Implements chunking with configurable size (PRD §5.2)
+ */
+import { DEFAULTS } from "../constants.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 function chunkResponse(response, chunkSizeKB = DEFAULTS.RESPONSE_CHUNK_SIZE_KB) {
+    const chunkSizeBytes = chunkSizeKB * 1024;
+    // If response fits in one chunk, return single chunk
+    if (response.length <= chunkSizeBytes) {
+        return [
+            {
+                content: response,
+                index: 1,
+                total: 1,
+            },
+        ];
+    }
+    const chunks = [];
+    // Split at natural boundaries (newlines) when possible
+    let currentPosition = 0;
+    let chunkIndex = 1;
+    while (currentPosition < response.length) {
+        let endPosition = currentPosition + chunkSizeBytes;
+        // If we're not at the end, try to find a natural break point
+        if (endPosition < response.length) {
+            // Look for the last newline within the chunk size
+            const searchStart = Math.max(currentPosition, endPosition - 500); // Search within last 500 chars
+            const lastNewline = response.lastIndexOf("\n", endPosition);
+            if (lastNewline > searchStart) {
+                endPosition = lastNewline + 1; // Include the newline
+            }
+        }
+        else {
+            endPosition = response.length;
+        }
+        const chunkContent = response.slice(currentPosition, endPosition);
+        chunks.push({
+            content: chunkContent,
+            index: chunkIndex,
+            total: 0, // Will be updated after all chunks are created
+        });
+        currentPosition = endPosition;
+        chunkIndex++;
+    }
+    // Update total count for all chunks
+    const totalChunks = chunks.length;
+    for (const chunk of chunks) {
+        chunk.total = totalChunks;
+    }
+    return chunks;
+}
+/**
+ * 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 function needsChunking(response, chunkSizeKB = DEFAULTS.RESPONSE_CHUNK_SIZE_KB) {
+    const chunkSizeBytes = chunkSizeKB * 1024;
+    return response.length > chunkSizeBytes;
+}
+/**
+ * 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 function estimateChunkCount(response, chunkSizeKB = DEFAULTS.RESPONSE_CHUNK_SIZE_KB) {
+    const chunkSizeBytes = chunkSizeKB * 1024;
+    return Math.ceil(response.length / chunkSizeBytes);
+}
+/**
+ * Get the chunk size configuration from environment or default
+ *
+ * @returns Chunk size in KB
+ */
+export function getChunkSizeKB() {
+    const envValue = process.env.RESPONSE_CHUNK_SIZE_KB;
+    if (envValue) {
+        const parsed = parseInt(envValue, 10);
+        if (!isNaN(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return DEFAULTS.RESPONSE_CHUNK_SIZE_KB;
+}
+//# sourceMappingURL=responseChunker.js.map

package/dist/utils/responseChunker.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "better-gemini-mcp",
+  "version": "1.0.0",
+  "description": "Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "better-gemini-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "tsc --noEmit",
+    "test": "node --test --experimental-strip-types tests/**/*.test.ts",
+    "test:unit": "node --test --experimental-strip-types tests/unit/**/*.test.ts",
+    "test:integration": "node --test --experimental-strip-types tests/integration/**/*.test.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "gemini",
+    "gemini-cli",
+    "ai",
+    "llm",
+    "research",
+    "proxy",
+    "agent",
+    "copilot",
+    "claude"
+  ],
+  "author": "capyBearista",
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capyBearista/better-gemini-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/capyBearista/better-gemini-mcp/issues"
+  },
+  "homepage": "https://github.com/capyBearista/better-gemini-mcp#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE.md",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "ignore": "^5.3.0",
+    "zod": "^3.22.0",
+    "zod-to-json-schema": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}