@essentialai/cc-bridge-mcp-server 0.1.0

package/dist/logger.js

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+import path from "node:path";
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export class Logger {
+    threshold;
+    textStream = null;
+    jsonStream = null;
+    constructor(level, logDir) {
+        this.threshold = LEVELS[level];
+        if (logDir) {
+            fs.mkdirSync(logDir, { recursive: true });
+            const now = new Date()
+                .toISOString()
+                .replace(/:/g, "-")
+                .replace(/\.\d{3}Z$/, "");
+            const textFile = `bridge-${now}.log`;
+            const jsonFile = `bridge-${now}.json.log`;
+            this.textStream = fs.createWriteStream(path.join(logDir, textFile), {
+                flags: "a",
+            });
+            this.jsonStream = fs.createWriteStream(path.join(logDir, jsonFile), {
+                flags: "a",
+            });
+        }
+    }
+    log(level, message, data) {
+        if (LEVELS[level] < this.threshold)
+            return;
+        const timestamp = new Date().toISOString();
+        const humanLine = `${timestamp} [${level.toUpperCase()}] ${message}\n`;
+        process.stderr.write(humanLine);
+        this.textStream?.write(humanLine);
+        const entry = { timestamp, level, message };
+        if (data !== undefined) {
+            entry.data = data;
+        }
+        this.jsonStream?.write(JSON.stringify(entry) + "\n");
+    }
+    debug(message, data) {
+        this.log("debug", message, data);
+    }
+    info(message, data) {
+        this.log("info", message, data);
+    }
+    warn(message, data) {
+        this.log("warn", message, data);
+    }
+    error(message, data) {
+        this.log("error", message, data);
+    }
+    close() {
+        this.textStream?.end();
+        this.jsonStream?.end();
+    }
+}
+export function createLogger(level, logDir) {
+    return new Logger(level, logDir);
+}
+/** Pre-config logger: stderr-only at info level. Replaced after startup. */
+export let logger = new Logger("info");
+/**
+ * Initialize the fully-configured logger with file outputs.
+ * Replaces the module-level `logger` export.
+ */
+export function initLogger(level, logDir) {
+    logger.close();
+    logger = new Logger(level, logDir);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/services/cc-cli.d.ts

@@ -0,0 +1,3 @@
+import { CliExecResult } from "../types.js";
+export declare function execClaude(sessionId: string, message: string, cwd: string): Promise<CliExecResult>;
+//# sourceMappingURL=cc-cli.d.ts.map

package/dist/services/cc-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-cli.d.ts","sourceRoot":"","sources":["../../src/services/cc-cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,CAqExB"}

package/dist/services/cc-cli.js

@@ -0,0 +1,57 @@
+import { execFile } from "node:child_process";
+import { getConfig } from "../config.js";
+export function execClaude(sessionId, message, cwd) {
+    return new Promise((resolve) => {
+        const config = getConfig();
+        // Apply character limit: 0 means no truncation
+        const truncated = config.CC_BRIDGE_CHAR_LIMIT > 0 &&
+            message.length > config.CC_BRIDGE_CHAR_LIMIT
+            ? message.slice(0, config.CC_BRIDGE_CHAR_LIMIT) + "\n...[truncated]"
+            : message;
+        const args = ["--resume", sessionId, "-p", truncated];
+        execFile(config.CC_BRIDGE_CLAUDE_PATH, args, {
+            cwd,
+            timeout: config.CC_BRIDGE_TIMEOUT_MS,
+            maxBuffer: 10 * 1024 * 1024,
+            env: { ...process.env },
+        }, (error, stdout, stderr) => {
+            if (error) {
+                const execError = error;
+                // Detect timeout: process was killed by SIGTERM from timeout
+                if (execError.killed && execError.signal === "SIGTERM") {
+                    resolve({
+                        stdout: stdout || "",
+                        stderr: `CLI_TIMEOUT: CLI subprocess timed out after ${config.CC_BRIDGE_TIMEOUT_MS}ms. Increase CC_BRIDGE_TIMEOUT_MS if needed.`,
+                        exitCode: null,
+                    });
+                    return;
+                }
+                // Detect missing binary
+                if (execError.code === "ENOENT") {
+                    resolve({
+                        stdout: "",
+                        stderr: `CLI_NOT_FOUND: '${config.CC_BRIDGE_CLAUDE_PATH}' not found. Install Claude Code or set CC_BRIDGE_CLAUDE_PATH.`,
+                        exitCode: 127,
+                    });
+                    return;
+                }
+                // Other errors: include exit code and stderr
+                const exitCode = typeof execError.code === "number"
+                    ? Number(execError.code)
+                    : error.code ?? 1;
+                resolve({
+                    stdout: stdout || "",
+                    stderr: `CLI_EXEC_FAILED: claude exited with code ${exitCode}. stderr: ${stderr || error.message}`,
+                    exitCode,
+                });
+                return;
+            }
+            resolve({
+                stdout: stdout || "",
+                stderr: stderr || "",
+                exitCode: 0,
+            });
+        });
+    });
+}
+//# sourceMappingURL=cc-cli.js.map

package/dist/services/cc-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cc-cli.js","sourceRoot":"","sources":["../../src/services/cc-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,OAAe,EACf,GAAW;IAEX,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,+CAA+C;QAC/C,MAAM,SAAS,GACb,MAAM,CAAC,oBAAoB,GAAG,CAAC;YAC/B,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,oBAAoB;YAC1C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,GAAG,kBAAkB;YACpE,CAAC,CAAC,OAAO,CAAC;QAEd,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAEtD,QAAQ,CACN,MAAM,CAAC,qBAAqB,EAC5B,IAAI,EACJ;YACE,GAAG;YACH,OAAO,EAAE,MAAM,CAAC,oBAAoB;YACpC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;YAC3B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,SAAS,GAAG,KAGjB,CAAC;gBAEF,6DAA6D;gBAC7D,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvD,OAAO,CAAC;wBACN,MAAM,EAAE,MAAM,IAAI,EAAE;wBACpB,MAAM,EAAE,+CAA+C,MAAM,CAAC,oBAAoB,8CAA8C;wBAChI,QAAQ,EAAE,IAAI;qBACf,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,wBAAwB;gBACxB,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAChC,OAAO,CAAC;wBACN,MAAM,EAAE,EAAE;wBACV,MAAM,EAAE,mBAAmB,MAAM,CAAC,qBAAqB,gEAAgE;wBACvH,QAAQ,EAAE,GAAG;qBACd,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,6CAA6C;gBAC7C,MAAM,QAAQ,GACZ,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;oBAChC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;oBACxB,CAAC,CAAE,KAAsC,CAAC,IAAI,IAAI,CAAC,CAAC;gBACxD,OAAO,CAAC;oBACN,MAAM,EAAE,MAAM,IAAI,EAAE;oBACpB,MAAM,EAAE,4CAA4C,QAAQ,aAAa,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE;oBAClG,QAAQ;iBACT,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,OAAO,CAAC;gBACN,MAAM,EAAE,MAAM,IAAI,EAAE;gBACpB,MAAM,EAAE,MAAM,IAAI,EAAE;gBACpB,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/health-check.d.ts

@@ -0,0 +1,23 @@
+interface CheckResult {
+    ok: boolean;
+    message: string;
+}
+interface ClaudeCliCheckResult extends CheckResult {
+    version?: string;
+}
+export interface HealthCheckResult {
+    healthy: boolean;
+    serverVersion: string;
+    statePath: string;
+    claudePath: string;
+    checks: {
+        stateFile: CheckResult;
+        lockMechanism: CheckResult;
+        claudeCli: ClaudeCliCheckResult;
+    };
+    timestamp: string;
+}
+/** Run all health checks and return a comprehensive result. */
+export declare function checkHealth(): Promise<HealthCheckResult>;
+export {};
+//# sourceMappingURL=health-check.d.ts.map

package/dist/services/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/services/health-check.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,oBAAqB,SAAQ,WAAW;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,SAAS,EAAE,WAAW,CAAC;QACvB,aAAa,EAAE,WAAW,CAAC;QAC3B,SAAS,EAAE,oBAAoB,CAAC;KACjC,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AA+ED,+DAA+D;AAC/D,wBAAsB,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAqB9D"}

package/dist/services/health-check.js

@@ -0,0 +1,96 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { getConfig } from "../config.js";
+import { SERVER_VERSION } from "../constants.js";
+/* ------------------------------------------------------------------ */
+/*  Derive paths from config at call time (not module load time)      */
+/* ------------------------------------------------------------------ */
+function getStatePath() {
+    return path.join(getConfig().CC_BRIDGE_STATE_PATH, "cc-bridge-state.json");
+}
+/* ------------------------------------------------------------------ */
+/*  Sub-checks                                                        */
+/* ------------------------------------------------------------------ */
+/** HLTH-01: Check state file accessibility. */
+async function checkStateFile() {
+    const statePath = getStatePath();
+    const dir = path.dirname(statePath);
+    try {
+        await fs.access(dir, fs.constants.R_OK | fs.constants.W_OK);
+    }
+    catch {
+        return { ok: false, message: `State directory not accessible: ${dir}` };
+    }
+    try {
+        const raw = await fs.readFile(statePath, "utf-8");
+        JSON.parse(raw);
+        return { ok: true, message: "State file readable and valid JSON" };
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return { ok: true, message: "State directory writable (no state file yet)" };
+        }
+        if (err instanceof SyntaxError) {
+            return { ok: false, message: "State file exists but contains invalid JSON" };
+        }
+        return { ok: false, message: `State file error: ${err.message}` };
+    }
+}
+/** HLTH-02: Check lock mechanism with a separate health-check lock path. */
+async function checkLockMechanism() {
+    const healthLockPath = getStatePath() + ".health-lock";
+    try {
+        await fs.writeFile(healthLockPath, String(process.pid), { flag: "wx" });
+        try {
+            await fs.unlink(healthLockPath);
+        }
+        catch {
+            // Cleanup failure is non-fatal
+        }
+        return { ok: true, message: "Lock acquire/release cycle succeeded" };
+    }
+    catch (err) {
+        if (err.code === "EEXIST") {
+            return { ok: false, message: "Health check lock file exists unexpectedly" };
+        }
+        return { ok: false, message: `Lock mechanism error: ${err.message}` };
+    }
+}
+/** HLTH-03: Check Claude CLI availability. */
+function checkClaudeCli() {
+    const claudePath = getConfig().CC_BRIDGE_CLAUDE_PATH;
+    return new Promise((resolve) => {
+        execFile(claudePath, ["--version"], { timeout: 5000 }, (error, stdout) => {
+            if (error) {
+                resolve({ ok: false, message: `Claude CLI not found at '${claudePath}'` });
+                return;
+            }
+            resolve({ ok: true, message: "Claude CLI found", version: (stdout || "").trim() });
+        });
+    });
+}
+/* ------------------------------------------------------------------ */
+/*  Public API                                                        */
+/* ------------------------------------------------------------------ */
+/** Run all health checks and return a comprehensive result. */
+export async function checkHealth() {
+    const config = getConfig();
+    // Run all three checks (not short-circuiting)
+    const [stateFile, lockMechanism, claudeCli] = await Promise.all([
+        checkStateFile(),
+        checkLockMechanism(),
+        checkClaudeCli(),
+    ]);
+    const checks = { stateFile, lockMechanism, claudeCli };
+    const healthy = Object.values(checks).every((c) => c.ok);
+    return {
+        healthy,
+        serverVersion: SERVER_VERSION,
+        statePath: path.join(config.CC_BRIDGE_STATE_PATH, "cc-bridge-state.json"),
+        claudePath: config.CC_BRIDGE_CLAUDE_PATH,
+        checks,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=health-check.js.map

package/dist/services/health-check.js.map

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

package/dist/services/peer-registry.d.ts

@@ -0,0 +1,9 @@
+import { PeerInfo, MessageRecord } from "../types.js";
+export declare function registerPeer(peerId: string, sessionId: string, cwd: string, label: string): Promise<PeerInfo>;
+export declare function updateLastSeen(peerId: string): Promise<void>;
+export declare function deregisterPeer(peerId: string): Promise<boolean>;
+export declare function getPeer(peerId: string): Promise<PeerInfo | undefined>;
+export declare function listPeers(): Promise<PeerInfo[]>;
+export declare function recordMessage(record: Omit<MessageRecord, "id" | "timestamp">): Promise<MessageRecord>;
+export declare function getHistory(peerId?: string, limit?: number): Promise<MessageRecord[]>;
+//# sourceMappingURL=peer-registry.d.ts.map

package/dist/services/peer-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-registry.d.ts","sourceRoot":"","sources":["../../src/services/peer-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgKtD,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrE;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAG/B;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGrD;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,GAC9C,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,UAAU,CAC9B,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,aAAa,EAAE,CAAC,CAS1B"}

package/dist/services/peer-registry.js

@@ -0,0 +1,207 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getConfig } from "../config.js";
+import { logger } from "../logger.js";
+import { BridgeError, BridgeErrorCode } from "../errors.js";
+/* ------------------------------------------------------------------ */
+/*  File-based shared state                                           */
+/*  Two or more MCP server processes share a state JSON file          */
+/*  State path is config-driven via CC_BRIDGE_STATE_PATH              */
+/* ------------------------------------------------------------------ */
+const MAX_MESSAGES = 500;
+const LOCK_RETRY_MS = 50;
+const LOCK_MAX_WAIT_MS = 5_000;
+/** Derive state file path from config at call time (not module load time). */
+function getStatePath() {
+    return path.join(getConfig().CC_BRIDGE_STATE_PATH, "cc-bridge-state.json");
+}
+/** Derive lock file path from state path at call time. */
+function getLockPath() {
+    return getStatePath() + ".lock";
+}
+/* ---- low-level helpers ------------------------------------------- */
+function emptyState() {
+    return { peers: {}, messages: [] };
+}
+/** Migrate legacy state: ensure all peers have lastSeenAt field. */
+function migrateState(state) {
+    for (const peer of Object.values(state.peers)) {
+        if (!peer.lastSeenAt) {
+            peer.lastSeenAt = peer.registeredAt;
+        }
+    }
+    return state;
+}
+async function readState() {
+    const statePath = getStatePath();
+    try {
+        const raw = await fs.readFile(statePath, "utf-8");
+        return migrateState(JSON.parse(raw));
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return migrateState(emptyState());
+        }
+        if (err instanceof SyntaxError) {
+            // Corrupt JSON -- auto-recover with backup
+            const backupPath = statePath + ".corrupt." + Date.now();
+            try {
+                await fs.copyFile(statePath, backupPath);
+            }
+            catch {
+                // Backup failure is non-fatal
+            }
+            logger.warn(`STATE_CORRUPT: State file corrupt (invalid JSON), backed up to ${backupPath}. Starting with empty state.`);
+            return migrateState(emptyState());
+        }
+        throw new BridgeError(BridgeErrorCode.STATE_WRITE_FAILED, `Failed to read state file: ${err.message}`, `Check permissions on ${statePath}`);
+    }
+}
+async function writeState(state) {
+    const statePath = getStatePath();
+    const tmp = statePath + "." + process.pid + ".tmp";
+    try {
+        await fs.writeFile(tmp, JSON.stringify(state, null, 2), "utf-8");
+        await fs.rename(tmp, statePath); // atomic on same filesystem
+    }
+    catch (err) {
+        throw new BridgeError(BridgeErrorCode.STATE_WRITE_FAILED, `Failed to write state file: ${err.message}`, `Check permissions on ${statePath}`);
+    }
+}
+/* ---- file-lock (O_CREAT | O_EXCL) ------------------------------- */
+async function acquireLock() {
+    const lockPath = getLockPath();
+    const deadline = Date.now() + LOCK_MAX_WAIT_MS;
+    while (Date.now() < deadline) {
+        try {
+            // Atomic create-if-not-exists
+            await fs.writeFile(lockPath, String(process.pid), {
+                flag: "wx", // O_WRONLY | O_CREAT | O_EXCL
+            });
+            return; // lock acquired
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                // Check for stale lock (process died)
+                try {
+                    const content = await fs.readFile(lockPath, "utf-8");
+                    const lockPid = parseInt(content, 10);
+                    if (!isNaN(lockPid)) {
+                        try {
+                            process.kill(lockPid, 0); // just checks existence
+                        }
+                        catch {
+                            // Process doesn't exist -- stale lock
+                            logger.info(`Cleaned up stale lock from PID ${lockPid}`);
+                            await fs.unlink(lockPath).catch(() => { });
+                            continue; // retry immediately
+                        }
+                    }
+                }
+                catch { /* lock file disappeared, retry */
+                    continue;
+                }
+                await sleep(LOCK_RETRY_MS);
+                continue;
+            }
+            throw err;
+        }
+    }
+    // Timeout -- read lock to report holder PID
+    let lockPid = "unknown";
+    try {
+        const content = await fs.readFile(lockPath, "utf-8");
+        lockPid = content.trim();
+    }
+    catch { /* ignore read failure */ }
+    throw new BridgeError(BridgeErrorCode.LOCK_TIMEOUT, `Failed to acquire lock within ${LOCK_MAX_WAIT_MS}ms (held by PID ${lockPid})`, `Another cc-bridge process may be stuck. Delete ${lockPath} if no other instance is running.`);
+}
+async function releaseLock() {
+    await fs.unlink(getLockPath()).catch(() => { });
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/** Run a mutating operation under an exclusive file lock. */
+async function withLock(fn) {
+    await acquireLock();
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseLock();
+    }
+}
+/* ---- public API (all async) -------------------------------------- */
+export async function registerPeer(peerId, sessionId, cwd, label) {
+    return withLock(async () => {
+        const state = await readState();
+        const now = new Date().toISOString();
+        const peer = {
+            peerId,
+            sessionId,
+            cwd,
+            label,
+            registeredAt: now,
+            lastSeenAt: now,
+        };
+        state.peers[peerId] = peer;
+        await writeState(state);
+        return peer;
+    });
+}
+export async function updateLastSeen(peerId) {
+    return withLock(async () => {
+        const state = await readState();
+        const peer = state.peers[peerId];
+        if (peer) {
+            peer.lastSeenAt = new Date().toISOString();
+            await writeState(state);
+        }
+    });
+}
+export async function deregisterPeer(peerId) {
+    return withLock(async () => {
+        const state = await readState();
+        if (!(peerId in state.peers))
+            return false;
+        delete state.peers[peerId];
+        await writeState(state);
+        return true;
+    });
+}
+export async function getPeer(peerId) {
+    const state = await readState();
+    return state.peers[peerId];
+}
+export async function listPeers() {
+    const state = await readState();
+    return Object.values(state.peers);
+}
+export async function recordMessage(record) {
+    return withLock(async () => {
+        const state = await readState();
+        const full = {
+            ...record,
+            id: crypto.randomUUID(),
+            timestamp: new Date().toISOString(),
+        };
+        state.messages.push(full);
+        // Cap history to prevent unbounded growth
+        if (state.messages.length > MAX_MESSAGES) {
+            state.messages = state.messages.slice(-MAX_MESSAGES);
+        }
+        await writeState(state);
+        return full;
+    });
+}
+export async function getHistory(peerId, limit = 50) {
+    const state = await readState();
+    let filtered = state.messages;
+    if (peerId) {
+        filtered = state.messages.filter((m) => m.fromPeerId === peerId || m.toPeerId === peerId);
+    }
+    return filtered.slice(-limit);
+}
+//# sourceMappingURL=peer-registry.js.map

package/dist/services/peer-registry.js.map

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

package/dist/startup.d.ts

@@ -0,0 +1,2 @@
+export declare function runStartup(): Promise<void>;
+//# sourceMappingURL=startup.d.ts.map

package/dist/startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"AAqHA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAuChD"}

package/dist/startup.js

@@ -0,0 +1,119 @@
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+import readline from "node:readline";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { loadConfig, getConfig } from "./config.js";
+import { initLogger, logger } from "./logger.js";
+import { BridgeError, BridgeErrorCode } from "./errors.js";
+const execFileAsync = promisify(execFile);
+const PERSIST_PATH = path.join(os.homedir(), ".cc-bridge-config.json");
+async function loadPersistedConfig() {
+    try {
+        const raw = await fs.readFile(PERSIST_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function savePersistedConfig(config) {
+    try {
+        await fs.writeFile(PERSIST_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn(`Could not save config to ${PERSIST_PATH}: ${msg}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// First-run interactive prompt
+// ---------------------------------------------------------------------------
+async function firstRunPrompt(defaultPath) {
+    // Non-TTY (MCP host context): use defaults silently
+    if (!process.stdin.isTTY) {
+        return defaultPath;
+    }
+    // Check if persisted config already exists (not first run)
+    const persisted = await loadPersistedConfig();
+    if (persisted.statePath) {
+        return persisted.statePath;
+    }
+    // First run with TTY -- prompt the user
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stderr, // CRITICAL: output to stderr, not stdout
+    });
+    return new Promise((resolve) => {
+        rl.question(`\nFirst run detected. Where should cc-bridge store its data?\n` +
+            `  Default: ${defaultPath}\n` +
+            `  Press Enter to accept, or type a custom path: `, async (answer) => {
+            rl.close();
+            const chosen = answer.trim() || defaultPath;
+            await savePersistedConfig({ statePath: chosen });
+            resolve(chosen);
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+async function validateStateDir(statePath) {
+    await fs.mkdir(statePath, { recursive: true });
+    const testFile = path.join(statePath, ".write-test");
+    try {
+        await fs.writeFile(testFile, "test", "utf-8");
+        await fs.unlink(testFile);
+    }
+    catch {
+        throw new BridgeError(BridgeErrorCode.STARTUP_FAILED, `Cannot write to state directory: ${statePath}`, "Check permissions or set CC_BRIDGE_STATE_PATH to a writable directory");
+    }
+}
+async function checkClaudeCli(claudePath) {
+    try {
+        const { stdout } = await execFileAsync(claudePath, ["--version"], {
+            timeout: 5000,
+        });
+        logger.info(`Claude CLI detected: ${stdout.trim()}`);
+    }
+    catch {
+        logger.warn(`CLI_NOT_FOUND: '${claudePath}' not found on PATH. ` +
+            `cc_send_message will fail until Claude Code is installed. ` +
+            `Set CC_BRIDGE_CLAUDE_PATH if installed in a non-standard location.`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Main startup flow
+// ---------------------------------------------------------------------------
+export async function runStartup() {
+    // Determine state path: env var takes precedence, then first-run prompt
+    const envStatePath = process.env.CC_BRIDGE_STATE_PATH;
+    let statePath;
+    if (envStatePath) {
+        statePath = envStatePath;
+    }
+    else {
+        const defaultPath = path.join(os.homedir(), "cloud_code_bridge");
+        statePath = await firstRunPrompt(defaultPath);
+    }
+    // If the prompt chose a different path, set it in env for loadConfig
+    if (!envStatePath && statePath !== path.join(os.homedir(), "cloud_code_bridge")) {
+        process.env.CC_BRIDGE_STATE_PATH = statePath;
+    }
+    else if (!envStatePath) {
+        // Ensure the default or persisted path is available to loadConfig
+        process.env.CC_BRIDGE_STATE_PATH = statePath;
+    }
+    // Load and freeze config
+    loadConfig();
+    const config = getConfig();
+    // Initialize full logger with file outputs
+    initLogger(config.CC_BRIDGE_LOG_LEVEL, path.join(config.CC_BRIDGE_STATE_PATH, "logs"));
+    // Validate state directory writability
+    await validateStateDir(config.CC_BRIDGE_STATE_PATH);
+    // Check for claude CLI (warn-only)
+    await checkClaudeCli(config.CC_BRIDGE_CLAUDE_PATH);
+    logger.info(`Startup complete. State: ${config.CC_BRIDGE_STATE_PATH}, Log level: ${config.CC_BRIDGE_LOG_LEVEL}`);
+}
+//# sourceMappingURL=startup.js.map

package/dist/startup.js.map

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