claude-mcp-bridge 0.1.0

package/dist/utils/prompts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Load a prompt template from prompts/ and replace placeholders.
+ * Placeholders use the format {{KEY}}. Only keys present in `vars`
+ * are replaced; unknown placeholders pass through unchanged.
+ */
+export declare function loadPrompt(filename: string, vars: Record<string, string>): string;
+/**
+ * Build a length limit instruction string from a word count.
+ * Returns empty string when no limit is set, suitable for use
+ * as a {{LENGTH_LIMIT}} template variable.
+ */
+export declare function buildLengthLimit(maxWords?: number): string;
+/**
+ * Append a length limit instruction to a prompt string.
+ * No-op when maxWords is not set. Use this for tools that don't
+ * have a prompt template with a {{LENGTH_LIMIT}} placeholder.
+ */
+export declare function appendLengthLimit(prompt: string, maxWords?: number): string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMjF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3E"}

package/dist/utils/prompts.js

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { basename, dirname, resolve } from "node:path";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROMPTS_DIR = resolve(__dirname, "../../prompts");
+/**
+ * Load a prompt template from prompts/ and replace placeholders.
+ * Placeholders use the format {{KEY}}. Only keys present in `vars`
+ * are replaced; unknown placeholders pass through unchanged.
+ */
+export function loadPrompt(filename, vars) {
+    let result = readFileSync(resolve(PROMPTS_DIR, basename(filename)), "utf8");
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(`{{${key}}}`, value);
+    }
+    return result;
+}
+/**
+ * Build a length limit instruction string from a word count.
+ * Returns empty string when no limit is set, suitable for use
+ * as a {{LENGTH_LIMIT}} template variable.
+ */
+export function buildLengthLimit(maxWords) {
+    if (!maxWords || maxWords <= 0)
+        return "";
+    return `Keep your response under ${maxWords} words.`;
+}
+/**
+ * Append a length limit instruction to a prompt string.
+ * No-op when maxWords is not set. Use this for tools that don't
+ * have a prompt template with a {{LENGTH_LIMIT}} placeholder.
+ */
+export function appendLengthLimit(prompt, maxWords) {
+    const limit = buildLengthLimit(maxWords);
+    return limit ? `${prompt}\n\n${limit}` : prompt;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/utils/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAA4B;IACvE,IAAI,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,OAAO,4BAA4B,QAAQ,SAAS,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAiB;IACjE,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,9 @@
+import type { SpawnResult } from "./spawn.js";
+export declare const HARD_TIMEOUT_CAP = 600000;
+export interface FallbackResult {
+    result: SpawnResult;
+    fallbackUsed: boolean;
+    fallbackModel?: string;
+}
+export declare function withModelFallback(model: string | undefined, spawnFn: (model: string | undefined, timeout: number) => Promise<SpawnResult>, totalTimeout: number): Promise<FallbackResult>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,EAC7E,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,CAAC,CA4BzB"}

package/dist/utils/retry.js

@@ -0,0 +1,29 @@
+import { isRetryableError } from "./errors.js";
+import { getFallbackModel } from "./model.js";
+const MIN_RETRY_BUDGET = 10_000;
+export const HARD_TIMEOUT_CAP = 600_000;
+export async function withModelFallback(model, spawnFn, totalTimeout) {
+    const capped = Math.min(totalTimeout, HARD_TIMEOUT_CAP);
+    const deadline = Date.now() + capped;
+    const result = await spawnFn(model, capped);
+    if (result.timedOut) {
+        return { result, fallbackUsed: false };
+    }
+    if (!isRetryableError(result.exitCode, result.stdout, result.stderr)) {
+        return { result, fallbackUsed: false };
+    }
+    const fallback = getFallbackModel();
+    if (!fallback || fallback === model) {
+        return { result, fallbackUsed: false };
+    }
+    const remaining = deadline - Date.now();
+    if (remaining < MIN_RETRY_BUDGET) {
+        return { result, fallbackUsed: false };
+    }
+    return {
+        result: await spawnFn(fallback, remaining),
+        fallbackUsed: true,
+        fallbackModel: fallback,
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAQxC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAyB,EACzB,OAA6E,EAC7E,YAAoB;IAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IAErC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxC,IAAI,SAAS,GAAG,gBAAgB,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC1C,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,QAAQ;KACxB,CAAC;AACJ,CAAC"}

package/dist/utils/security.d.ts

@@ -0,0 +1,18 @@
+/** Maximum file size in bytes (1MB). */
+export declare const MAX_FILE_SIZE = 1000000;
+/** Maximum number of files that can be attached to a query. */
+export declare const MAX_FILES = 20;
+/**
+ * Resolve a path and verify it's within the allowed root directory.
+ * Prevents path traversal attacks via symlinks, `..`, etc.
+ */
+export declare function resolveAndVerify(filePath: string, rootDir: string): Promise<string>;
+/**
+ * Verify a directory exists and is actually a directory.
+ */
+export declare function verifyDirectory(dir: string): Promise<string>;
+/**
+ * Check if a file is within size limits.
+ */
+export declare function checkFileSize(filePath: string): Promise<number>;
+//# sourceMappingURL=security.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAGA,wCAAwC;AACxC,eAAO,MAAM,aAAa,UAAY,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrE"}

package/dist/utils/security.js

@@ -0,0 +1,37 @@
+import { realpath, stat } from "node:fs/promises";
+import path from "node:path";
+/** Maximum file size in bytes (1MB). */
+export const MAX_FILE_SIZE = 1_000_000;
+/** Maximum number of files that can be attached to a query. */
+export const MAX_FILES = 20;
+/**
+ * Resolve a path and verify it's within the allowed root directory.
+ * Prevents path traversal attacks via symlinks, `..`, etc.
+ */
+export async function resolveAndVerify(filePath, rootDir) {
+    const resolved = await realpath(path.resolve(rootDir, filePath));
+    const resolvedRoot = await realpath(rootDir);
+    if (!resolved.startsWith(resolvedRoot + path.sep) && resolved !== resolvedRoot) {
+        throw new Error(`Path traversal blocked: "${filePath}" resolves outside allowed root "${rootDir}"`);
+    }
+    return resolved;
+}
+/**
+ * Verify a directory exists and is actually a directory.
+ */
+export async function verifyDirectory(dir) {
+    const resolved = await realpath(dir);
+    const s = await stat(resolved);
+    if (!s.isDirectory()) {
+        throw new Error(`Not a directory: ${dir}`);
+    }
+    return resolved;
+}
+/**
+ * Check if a file is within size limits.
+ */
+export async function checkFileSize(filePath) {
+    const s = await stat(filePath);
+    return s.size;
+}
+//# sourceMappingURL=security.js.map

package/dist/utils/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAE5B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,OAAe;IAEf,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,oCAAoC,OAAO,GAAG,CACnF,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC"}

package/dist/utils/spawn.d.ts

@@ -0,0 +1,30 @@
+/** Hard maximum timeout — no request can exceed this. */
+export declare const HARD_TIMEOUT_CAP = 600000;
+export interface SpawnOptions {
+    args: string[];
+    cwd: string;
+    stdin?: string;
+    timeout?: number;
+}
+export interface SpawnResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    timedOut: boolean;
+}
+export declare function findClaudeBinary(): string;
+export declare function spawnClaude(options: SpawnOptions): Promise<SpawnResult>;
+export declare function resetConcurrency(): void;
+export interface ClaudeArgsOptions {
+    model?: string;
+    fallbackModel?: string;
+    maxBudgetUsd?: number;
+    effort?: string;
+    sessionId?: string;
+    noSessionPersistence?: boolean;
+    allowedTools?: string[];
+    jsonSchema?: string;
+    prompt?: string;
+}
+export declare function buildClaudeArgs(options: ClaudeArgsOptions): string[];
+//# sourceMappingURL=spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/utils/spawn.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAKxC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AA6CD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAS7E;AAgGD,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAcpE"}

package/dist/utils/spawn.js

@@ -0,0 +1,170 @@
+import { spawn } from "node:child_process";
+import { buildSubprocessEnv } from "./env.js";
+/** Hard maximum timeout — no request can exceed this. */
+export const HARD_TIMEOUT_CAP = 600_000;
+const DEFAULT_MAX_CONCURRENT = 3;
+const QUEUE_TIMEOUT = 30_000;
+let activeCount = 0;
+const parsedConcurrent = parseInt(process.env["CLAUDE_MAX_CONCURRENT"] ?? String(DEFAULT_MAX_CONCURRENT), 10);
+const maxConcurrent = Number.isNaN(parsedConcurrent) || parsedConcurrent <= 0
+    ? DEFAULT_MAX_CONCURRENT
+    : parsedConcurrent;
+const waitQueue = [];
+function acquireSlot() {
+    if (activeCount < maxConcurrent) {
+        activeCount++;
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            const idx = waitQueue.findIndex((w) => w.resolve === resolve);
+            if (idx !== -1)
+                waitQueue.splice(idx, 1);
+            reject(new Error(`Concurrency queue timeout after ${QUEUE_TIMEOUT}ms — ${activeCount} processes active`));
+        }, QUEUE_TIMEOUT);
+        waitQueue.push({
+            resolve: () => {
+                clearTimeout(timer);
+                activeCount++;
+                resolve();
+            },
+            reject,
+        });
+    });
+}
+function releaseSlot() {
+    activeCount--;
+    const next = waitQueue.shift();
+    if (next)
+        next.resolve();
+}
+export function findClaudeBinary() {
+    return process.env["CLAUDE_CLI_PATH"] ?? "claude";
+}
+export async function spawnClaude(options) {
+    const timeout = Math.min(options.timeout ?? 60_000, HARD_TIMEOUT_CAP);
+    await acquireSlot();
+    try {
+        return await doSpawn(options, timeout);
+    }
+    finally {
+        releaseSlot();
+    }
+}
+async function doSpawn(options, timeout) {
+    const binary = findClaudeBinary();
+    const env = buildSubprocessEnv();
+    return new Promise((resolve, reject) => {
+        let child;
+        const detached = process.platform !== "win32";
+        try {
+            child = spawn(binary, options.args, {
+                cwd: options.cwd,
+                env,
+                shell: false,
+                stdio: ["pipe", "pipe", "pipe"],
+                detached,
+            });
+        }
+        catch (e) {
+            reject(new Error(`Failed to spawn Claude CLI: ${e}`));
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        let settled = false;
+        let killTimer;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killTimer = killProcessGroup(child);
+        }, timeout);
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            if (!settled) {
+                settled = true;
+                if (err.code === "ENOENT") {
+                    reject(new Error("claude CLI not found. Install Claude Code and ensure `claude` is on PATH."));
+                }
+                else {
+                    reject(new Error(`Failed to run Claude CLI: ${err.message}`));
+                }
+            }
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            if (!settled) {
+                settled = true;
+                resolve({ stdout, stderr, exitCode: code, timedOut });
+            }
+        });
+        if (options.stdin) {
+            child.stdin?.write(options.stdin);
+        }
+        child.stdin?.end();
+    });
+}
+function killProcessGroup(child) {
+    const pid = child.pid;
+    if (!pid)
+        return undefined;
+    const useGroupKill = process.platform !== "win32";
+    const kill = (signal) => {
+        try {
+            if (useGroupKill) {
+                process.kill(-pid, signal);
+            }
+            else {
+                child.kill(signal);
+            }
+        }
+        catch {
+            try {
+                child.kill(signal);
+            }
+            catch {
+                // Already dead.
+            }
+        }
+    };
+    kill("SIGTERM");
+    return setTimeout(() => kill("SIGKILL"), 5000);
+}
+export function resetConcurrency() {
+    activeCount = 0;
+    waitQueue.length = 0;
+}
+export function buildClaudeArgs(options) {
+    const args = ["-p", "--bare", "--disable-slash-commands", "--output-format", "json"];
+    if (options.model)
+        args.push("--model", options.model);
+    if (options.fallbackModel)
+        args.push("--fallback-model", options.fallbackModel);
+    if (options.maxBudgetUsd && options.maxBudgetUsd > 0)
+        args.push("--max-budget-usd", String(options.maxBudgetUsd));
+    if (options.effort)
+        args.push("--effort", options.effort);
+    if (options.sessionId)
+        args.push("--resume", options.sessionId);
+    if (options.noSessionPersistence)
+        args.push("--no-session-persistence");
+    if (options.allowedTools && options.allowedTools.length > 0) {
+        args.push("--allowed-tools", options.allowedTools.join(" "));
+    }
+    if (options.jsonSchema)
+        args.push("--json-schema", options.jsonSchema);
+    if (options.prompt)
+        args.push(options.prompt);
+    return args;
+}
+//# sourceMappingURL=spawn.js.map

package/dist/utils/spawn.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "claude-mcp-bridge",
+  "version": "0.1.0",
+  "description": "MCP server that wraps Claude Code CLI for query, structured output, and health checks",
+  "author": "Tim Birrell",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "claude-mcp-bridge": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "prompts"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint src/ tests/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "CLAUDE_INTEGRATION=1 vitest run tests/integration/",
+    "smoke": "node scripts/smoke-test.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "code-review",
+    "ai-tools",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hampsterx/claude-mcp-bridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hampsterx/claude-mcp-bridge/issues"
+  },
+  "homepage": "https://github.com/hampsterx/claude-mcp-bridge#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "strip-ansi": "^7.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.0.0"
+  }
+}

package/prompts/review-agentic.md

@@ -0,0 +1,23 @@
+You are an expert code reviewer operating inside a git repository.
+
+Review the changes by using this diff command as your starting point:
+
+{{DIFF_SPEC}}
+
+Instructions:
+1. Run the diff command.
+2. Read the changed files and any directly relevant surrounding code.
+3. Focus on real bugs, regressions, security issues, incorrect assumptions, and missing tests.
+4. Prefer findings over summaries.
+5. If there are no meaningful issues, say so briefly and mention any residual risk.
+
+For each issue found, provide:
+- **Severity**: critical / warning / suggestion
+- **File**: the file path
+- **Line**: approximate line number
+- **Issue**: clear description
+- **Suggestion**: how to fix it
+
+{{FOCUS_SECTION}}
+
+{{LENGTH_LIMIT}}

package/prompts/review-quick.md

@@ -0,0 +1,25 @@
+You are an expert code reviewer. Review the following git diff carefully.
+
+For each issue found, provide:
+- **Severity**: critical / warning / suggestion
+- **File**: the file path
+- **Line**: approximate line number from the diff
+- **Issue**: clear description
+- **Suggestion**: how to fix it
+
+Focus on:
+- Bugs and logic errors
+- Security vulnerabilities
+- Performance issues
+- Missing error handling
+- Significant maintainability risks
+
+{{FOCUS_SECTION}}
+
+Keep the review concise. Findings first. If the diff looks good, say so briefly. Do not invent issues.
+
+{{LENGTH_LIMIT}}
+
+---
+
+{{DIFF}}

package/prompts/search.md

@@ -0,0 +1,13 @@
+Search the web for the following query, then synthesize a clear answer with source URLs.
+
+## Query
+
+{{QUERY}}
+
+## Instructions
+
+1. Search for relevant, current information.
+2. Synthesize findings into a direct answer.
+3. Include source URLs for key claims.
+4. If the search results are insufficient, say so rather than guessing.
+5. {{LENGTH_LIMIT}}