llm-cli-gateway 1.0.0

package/dist/stream-json-parser.js

@@ -0,0 +1,94 @@
+/**
+ * NDJSON parser for Claude `--output-format stream-json --include-partial-messages`.
+ *
+ * Each line of stdout is a complete JSON object. This parser extracts the
+ * final result text, cost, usage, and metadata from the stream.
+ */
+/**
+ * Parse completed NDJSON stdout from `claude --output-format stream-json --include-partial-messages`.
+ *
+ * Parsing strategy:
+ * 1. Split by newlines, filter empty lines
+ * 2. JSON.parse each line, skip malformed lines
+ * 3. Find the `type=result` event — contains final text, cost, usage
+ * 4. Fall back to the last `type=assistant` event if no result event
+ * 5. Extract `model` from `type=system` (init) event
+ *
+ * No rawEvents stored — the stdout buffer is already in memory.
+ */
+export function parseStreamJson(stdout) {
+    const lines = stdout.split("\n").filter(line => line.trim().length > 0);
+    let resultEvent = null;
+    let assistantEvent = null;
+    let systemEvent = null;
+    for (const line of lines) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            // Skip malformed lines
+            continue;
+        }
+        if (parsed.type === "result") {
+            resultEvent = parsed;
+        }
+        else if (parsed.type === "assistant") {
+            assistantEvent = parsed;
+        }
+        else if (parsed.type === "system" && parsed.subtype === "init") {
+            systemEvent = parsed;
+        }
+    }
+    // Extract from result event (preferred)
+    if (resultEvent) {
+        const usage = resultEvent.usage ? {
+            inputTokens: resultEvent.usage.input_tokens ?? 0,
+            outputTokens: resultEvent.usage.output_tokens ?? 0,
+            cacheReadInputTokens: resultEvent.usage.cache_read_input_tokens ?? 0,
+            cacheCreationInputTokens: resultEvent.usage.cache_creation_input_tokens ?? 0,
+        } : null;
+        return {
+            text: resultEvent.result ?? "",
+            costUsd: resultEvent.total_cost_usd ?? null,
+            usage,
+            sessionId: resultEvent.session_id ?? systemEvent?.session_id ?? null,
+            model: systemEvent?.model ?? resultEvent.model ?? null,
+            durationApiMs: resultEvent.duration_api_ms ?? null,
+            isError: resultEvent.is_error === true,
+            numTurns: resultEvent.num_turns ?? null,
+        };
+    }
+    // Fallback: extract text from assistant event
+    if (assistantEvent) {
+        const message = assistantEvent.message;
+        let text = "";
+        if (message?.content && Array.isArray(message.content)) {
+            text = message.content
+                .filter((block) => block.type === "text")
+                .map((block) => block.text)
+                .join("");
+        }
+        return {
+            text,
+            costUsd: null,
+            usage: null,
+            sessionId: systemEvent?.session_id ?? null,
+            model: systemEvent?.model ?? message?.model ?? null,
+            durationApiMs: null,
+            isError: false,
+            numTurns: null,
+        };
+    }
+    // No result or assistant event found — return empty
+    return {
+        text: "",
+        costUsd: null,
+        usage: null,
+        sessionId: systemEvent?.session_id ?? null,
+        model: systemEvent?.model ?? null,
+        durationApiMs: null,
+        isError: false,
+        numTurns: null,
+    };
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "llm-cli-gateway",
+  "version": "1.0.0",
+  "description": "MCP server providing unified access to Claude Code, Codex, and Gemini CLIs with session management, retry logic, and async job orchestration.",
+  "license": "MIT",
+  "author": {
+    "name": "VerivusAI Labs",
+    "url": "https://github.com/verivus-oss"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/verivus-oss/llm-cli-gateway.git"
+  },
+  "homepage": "https://github.com/verivus-oss/llm-cli-gateway#readme",
+  "bugs": {
+    "url": "https://github.com/verivus-oss/llm-cli-gateway/issues"
+  },
+  "keywords": [
+    "mcp",
+    "llm",
+    "claude",
+    "codex",
+    "gemini",
+    "orchestration",
+    "model-context-protocol",
+    "ai",
+    "cli-gateway"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "llm-cli-gateway": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "!dist/__tests__/**",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:all": "tsc",
+    "prepublishOnly": "npm run build && npm test",
+    "start": "node dist/index.js",
+    "migrate": "node dist/migrate.js",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:unit": "vitest run src/__tests__/executor.test.ts",
+    "test:session": "vitest run src/__tests__/session-manager.test.ts",
+    "test:session-pg": "bash ./scripts/test-pg.sh src/__tests__/session-manager-pg.test.ts",
+    "test:integration": "vitest run src/__tests__/integration.test.ts",
+    "test:pg": "bash ./scripts/test-pg.sh",
+    "test:all": "npm run test && npm run test:pg",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts'",
+    "check": "npm run build && npm run lint && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "ioredis": "^5.4.1",
+    "pg": "^8.12.0",
+    "toml": "^3.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.30",
+    "@types/pg": "^8.11.10",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "eslint-config-prettier": "^9.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  }
+}