@gkorepanov/ccodex 0.3.0

package/dist/management/lifecycle.js.map

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

package/dist/management/setup.d.ts

@@ -0,0 +1,22 @@
+import { compatibilityManifest } from "../compatibility/probe.js";
+import { type InstallLayout } from "./layout.js";
+export interface InstallManifest {
+    readonly schemaVersion: 1;
+    readonly method: "npm" | "curl" | "migrated-local";
+    readonly package: "@gkorepanov/ccodex";
+    readonly activeVersion: string;
+    readonly previousVersion: string | null;
+    readonly managedShellFiles: string[];
+    readonly shimHashes: Readonly<Record<string, string>>;
+    readonly platformPackage: string;
+    readonly compatibility: ReturnType<typeof compatibilityManifest>;
+    readonly doctor: {
+        readonly ok: true;
+        readonly checkedAt: string;
+    };
+    readonly installedAt: string;
+}
+export declare function readInstallManifest(layout?: InstallLayout): InstallManifest | undefined;
+export declare function activeVersion(layout: InstallLayout): string | null;
+export declare function activate(layout: InstallLayout, version: string): string | null;
+export declare function setup(args: readonly string[]): Promise<number>;

package/dist/management/setup.js

@@ -0,0 +1,320 @@
+import { execFile, spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { chmodSync, cpSync, existsSync, lstatSync, readFileSync, readlinkSync, renameSync, rmSync, statSync, } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join, relative, resolve } from "node:path";
+import { promisify } from "node:util";
+import { compatibilityManifest } from "../compatibility/probe.js";
+import { runtimePlatformKey } from "../runtime/dependencies.js";
+import { probeAppServer } from "../daemon/probe.js";
+import { reconcileManagedProcess } from "../daemon/supervisor.js";
+import { atomicSymlink, atomicWrite, ensureLayout, installLayout } from "./layout.js";
+const execute = promisify(execFile);
+const BEGIN = "# >>> ccodex >>>";
+const END = "# <<< ccodex <<<";
+function packageVersion() {
+    return compatibilityManifest().productVersion;
+}
+async function npmStage(destination, version = packageVersion()) {
+    const main = process.env.CCODEX_PACKAGE_SPEC ?? `@gkorepanov/ccodex@${version}`;
+    const specs = [main, ...(process.env.CCODEX_RELAY_PACKAGE_SPEC ? [process.env.CCODEX_RELAY_PACKAGE_SPEC] : [])];
+    await execute("npm", ["install", "--prefix", destination, "--include=optional", "--ignore-scripts", "--save=false", ...specs], {
+        timeout: 20 * 60_000,
+        maxBuffer: 2 * 1024 * 1024,
+    });
+}
+async function stagedDoctor(staged, layout) {
+    const command = join(staged, "node_modules", ".bin", "ccodex");
+    if (!existsSync(command))
+        throw new Error(`Staged CCodex executable is missing: ${command}`);
+    try {
+        const { stdout } = await execute(command, ["doctor", "--json"], {
+            env: { ...process.env, CCODEX_HOME: layout.home, CCODEX_DATA_DIR: layout.state },
+            timeout: 30_000,
+            maxBuffer: 512 * 1024,
+        });
+        const result = JSON.parse(stdout);
+        if (!result.ok)
+            throw new Error(stdout);
+    }
+    catch (error) {
+        const stdout = error.stdout;
+        let detail = String(error);
+        if (stdout) {
+            try {
+                detail = JSON.stringify(JSON.parse(stdout), null, 2);
+            }
+            catch {
+                detail = stdout;
+            }
+        }
+        throw new Error(`Staged CCodex doctor failed. Nothing was activated.\n${detail}`);
+    }
+}
+async function startupSmoke(staged, layout) {
+    if (process.env.CCODEX_SKIP_STARTUP_SMOKE === "1")
+        return;
+    const command = join(staged, "node_modules", ".bin", "ccodex");
+    const socket = join(layout.staging, `smoke-${process.pid}.sock`);
+    rmSync(socket, { force: true });
+    const child = spawn(command, ["app-server", "--listen", `unix://${socket}`], {
+        env: { ...process.env, CCODEX_HOME: layout.home, CCODEX_DATA_DIR: layout.state },
+        stdio: ["ignore", "ignore", "pipe"],
+    });
+    let stderr = "";
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (chunk) => { stderr = `${stderr}${chunk}`.slice(-16_384); });
+    try {
+        const deadline = Date.now() + 20_000;
+        let failure;
+        while (Date.now() < deadline) {
+            if (child.exitCode !== null)
+                throw new Error(`gateway exited ${child.exitCode}: ${stderr}`);
+            try {
+                await probeAppServer(socket);
+                return;
+            }
+            catch (error) {
+                failure = error;
+                await new Promise((resolve) => setTimeout(resolve, 100));
+            }
+        }
+        throw new Error(`gateway did not become ready: ${String(failure)}\n${stderr}`);
+    }
+    finally {
+        if (child.exitCode === null)
+            child.kill("SIGTERM");
+        await new Promise((resolve) => {
+            if (child.exitCode !== null)
+                resolve();
+            else {
+                const timer = setTimeout(() => { child.kill("SIGKILL"); resolve(); }, 5_000);
+                child.once("exit", () => { clearTimeout(timer); resolve(); });
+            }
+        });
+        rmSync(socket, { force: true });
+    }
+}
+function stagedCompatibility(staged) {
+    const path = join(staged, "node_modules", "@gkorepanov", "ccodex", "compatibility.json");
+    const value = JSON.parse(readFileSync(path, "utf8"));
+    return value;
+}
+function migrateLegacyState(layout) {
+    const legacy = join(homedir(), ".codex-hybrid");
+    if (!existsSync(legacy) || existsSync(join(layout.state, "state.sqlite")))
+        return;
+    for (const name of [
+        "state.sqlite", "state.sqlite-wal", "state.sqlite-shm", "state.sqlite.bak",
+        "handoffs.sqlite", "handoffs.sqlite-wal", "handoffs.sqlite-shm", "cursor.key",
+        "rpc.jsonl", "rpc.jsonl.1", "debug.jsonl",
+    ]) {
+        const source = join(legacy, name);
+        if (existsSync(source))
+            cpSync(source, join(layout.state, name), { preserveTimestamps: true });
+    }
+}
+function hashFile(path) {
+    return createHash("sha256").update(readFileSync(path)).digest("hex");
+}
+function installShims(layout) {
+    const script = `#!/bin/sh\nset -eu\nCCODEX_HOME=\${CCODEX_HOME:-"$HOME/.ccodex"}\nexport CCODEX_HOME\nexec "$CCODEX_HOME/current/node_modules/.bin/ccodex" "$@"\n`;
+    for (const name of ["ccodex", "codex"]) {
+        atomicWrite(join(layout.bin, name), script, 0o755);
+        chmodSync(join(layout.bin, name), 0o755);
+    }
+    return Object.fromEntries(["ccodex", "codex"].map((name) => [name, hashFile(join(layout.bin, name))]));
+}
+function appendManagedBlock(path, block) {
+    const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
+    if (existing.includes(BEGIN)) {
+        if (!existing.includes(block.trim()))
+            throw new Error(`Refusing to overwrite a modified CCodex block in ${path}`);
+        return;
+    }
+    const mode = existsSync(path) ? statSync(path).mode & 0o777 : 0o600;
+    atomicWrite(path, `${existing}${existing && !existing.endsWith("\n") ? "\n" : ""}${block}`, mode);
+}
+function installShellPaths(layout) {
+    const home = homedir();
+    const posixBlock = `${BEGIN}\nexport PATH="${layout.bin}:$PATH"\n${END}\n`;
+    const bashLogin = existsSync(join(home, ".bash_profile")) ? join(home, ".bash_profile") : join(home, ".profile");
+    const files = [bashLogin, join(home, ".bashrc"), join(home, ".zprofile"), join(home, ".zshrc")];
+    for (const path of files) {
+        const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
+        if (existing.includes(BEGIN) && !existing.includes(posixBlock.trim())) {
+            throw new Error(`Refusing to overwrite a modified CCodex block in ${path}`);
+        }
+    }
+    const fish = join(home, ".config", "fish", "conf.d", "ccodex.fish");
+    const fishBlock = `# Managed by CCodex.\nfish_add_path --prepend "${layout.bin}"\n`;
+    if (existsSync(fish) && readFileSync(fish, "utf8") !== fishBlock)
+        throw new Error(`Refusing to overwrite ${fish}`);
+    const added = [];
+    try {
+        for (const path of files) {
+            if (!existsSync(path) || !readFileSync(path, "utf8").includes(BEGIN)) {
+                appendManagedBlock(path, posixBlock);
+                added.push(path);
+            }
+        }
+        if (!existsSync(fish)) {
+            atomicWrite(fish, fishBlock, 0o600);
+            added.push(fish);
+        }
+        return [...files, fish];
+    }
+    catch (error) {
+        removeFirstInstallRouting(layout, added, {});
+        throw error;
+    }
+}
+function removeFirstInstallRouting(layout, files, hashes) {
+    const block = `${BEGIN}\nexport PATH="${layout.bin}:$PATH"\n${END}\n`;
+    for (const path of files) {
+        if (!existsSync(path))
+            continue;
+        const content = readFileSync(path, "utf8");
+        if (path.endsWith("ccodex.fish")) {
+            if (content === `# Managed by CCodex.\nfish_add_path --prepend "${layout.bin}"\n`)
+                rmSync(path);
+        }
+        else if (content.includes(block)) {
+            atomicWrite(path, content.replace(block, ""), statSync(path).mode & 0o777);
+        }
+    }
+    for (const [name, hash] of Object.entries(hashes)) {
+        const path = join(layout.bin, name);
+        if (existsSync(path) && hashFile(path) === hash)
+            rmSync(path);
+    }
+}
+async function verifyShellPaths(layout) {
+    const shells = ["/bin/bash", "/bin/zsh", "fish"];
+    for (const shell of shells) {
+        try {
+            const { stdout } = await execute(shell, ["-lc", "command -v codex"], { timeout: 10_000, maxBuffer: 64 * 1024 });
+            if (stdout.trim() !== join(layout.bin, "codex")) {
+                throw new Error(`${shell} resolves codex to '${stdout.trim()}', expected '${join(layout.bin, "codex")}'`);
+            }
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                continue;
+            throw error;
+        }
+    }
+}
+export function readInstallManifest(layout = installLayout()) {
+    return existsSync(layout.manifest) ? JSON.parse(readFileSync(layout.manifest, "utf8")) : undefined;
+}
+export function activeVersion(layout) {
+    if (!existsSync(layout.current) || !lstatSync(layout.current).isSymbolicLink())
+        return null;
+    return basename(readlinkSync(layout.current));
+}
+export function activate(layout, version) {
+    const previous = activeVersion(layout);
+    if (previous && previous !== version)
+        atomicSymlink(join("versions", previous), layout.previous);
+    atomicSymlink(join("versions", version), layout.current);
+    return previous;
+}
+function daemonPidFile() {
+    return join(process.env.CODEX_HOME ?? join(homedir(), ".codex"), "app-server-daemon", "app-server.pid");
+}
+async function replaceRunningDaemon(layout, version) {
+    const command = join(layout.versions, version, "node_modules", ".bin", "ccodex");
+    await execute(command, ["app-server", "daemon", "restart"], { timeout: 90_000, maxBuffer: 512 * 1024 });
+}
+export async function setup(args) {
+    if (process.getuid?.() === 0)
+        throw new Error("Do not run CCodex setup as root or with sudo.");
+    const stagedIndex = args.indexOf("--staged");
+    const supplied = stagedIndex >= 0 ? args[stagedIndex + 1] : undefined;
+    const versionIndex = args.indexOf("--version");
+    const requestedVersion = versionIndex >= 0 ? args[versionIndex + 1] : packageVersion();
+    const valued = new Set([stagedIndex + 1, versionIndex + 1]);
+    const unexpected = args.filter((arg, index) => !valued.has(index) && !["--repair", "--staged", "--version"].includes(arg));
+    if (unexpected.length > 0 || (stagedIndex >= 0 && !supplied) || !requestedVersion) {
+        throw new Error("Usage: ccodex setup [--repair] [--staged PATH] [--version VERSION]");
+    }
+    const layout = installLayout();
+    ensureLayout(layout);
+    migrateLegacyState(layout);
+    const versionPath = join(layout.versions, requestedVersion);
+    const repairExisting = args.includes("--repair") && existsSync(versionPath);
+    let staged = repairExisting ? versionPath : supplied ? resolve(supplied) : join(layout.staging, `${requestedVersion}-${process.pid}`);
+    if (!repairExisting && !supplied) {
+        rmSync(staged, { recursive: true, force: true });
+        await npmStage(staged, requestedVersion);
+    }
+    await stagedDoctor(staged, layout);
+    await startupSmoke(staged, layout);
+    const compatibility = stagedCompatibility(staged);
+    if (compatibility.productVersion !== requestedVersion) {
+        throw new Error(`Staged package is ${compatibility.productVersion}, expected ${requestedVersion}. Nothing was activated.`);
+    }
+    if (!existsSync(versionPath)) {
+        renameSync(staged, versionPath);
+        staged = versionPath;
+    }
+    else if (relative(versionPath, staged) !== "" && !relative(layout.staging, staged).startsWith("..")) {
+        rmSync(staged, { recursive: true, force: true });
+    }
+    const before = activeVersion(layout);
+    const beforePrevious = existsSync(layout.previous) && lstatSync(layout.previous).isSymbolicLink()
+        ? readlinkSync(layout.previous)
+        : undefined;
+    const beforeManifest = existsSync(layout.manifest) ? readFileSync(layout.manifest, "utf8") : undefined;
+    const daemonWasRunning = Boolean(reconcileManagedProcess(daemonPidFile()));
+    let installedShellFiles = [];
+    let installedShimHashes = {};
+    try {
+        const previous = activate(layout, requestedVersion);
+        const shimHashes = installShims(layout);
+        installedShimHashes = shimHashes;
+        const managedShellFiles = installShellPaths(layout);
+        installedShellFiles = managedShellFiles;
+        await verifyShellPaths(layout);
+        const manifest = {
+            schemaVersion: 1,
+            method: supplied ? "curl" : "npm",
+            package: "@gkorepanov/ccodex",
+            activeVersion: requestedVersion,
+            previousVersion: previous,
+            managedShellFiles,
+            shimHashes,
+            platformPackage: compatibility.relayPackages[runtimePlatformKey()] ?? "unsupported",
+            compatibility,
+            doctor: { ok: true, checkedAt: new Date().toISOString() },
+            installedAt: new Date().toISOString(),
+        };
+        atomicWrite(layout.manifest, `${JSON.stringify(manifest, null, 2)}\n`, 0o600);
+        if (daemonWasRunning)
+            await replaceRunningDaemon(layout, requestedVersion);
+    }
+    catch (error) {
+        if (before) {
+            atomicSymlink(join("versions", before), layout.current);
+            if (daemonWasRunning)
+                await replaceRunningDaemon(layout, before).catch(() => undefined);
+        }
+        else {
+            rmSync(layout.current, { force: true });
+            removeFirstInstallRouting(layout, installedShellFiles, installedShimHashes);
+        }
+        if (beforePrevious)
+            atomicSymlink(beforePrevious, layout.previous);
+        else
+            rmSync(layout.previous, { force: true });
+        if (beforeManifest !== undefined)
+            atomicWrite(layout.manifest, beforeManifest, 0o600);
+        else
+            rmSync(layout.manifest, { force: true });
+        throw error;
+    }
+    process.stdout.write(`CCodex ${requestedVersion} activated. Open a new shell or run: export PATH="${layout.bin}:$PATH"\n`);
+    return 0;
+}
+//# sourceMappingURL=setup.js.map

package/dist/management/setup.js.map

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

package/dist/observability/logger.d.ts

@@ -0,0 +1,19 @@
+import type { HybridConfig } from "../config/config.js";
+type Level = HybridConfig["logLevel"];
+export interface LoggerOptions {
+    readonly includeContent?: boolean;
+    readonly capturePath?: string;
+    readonly maxBytes?: number;
+}
+export declare class Logger {
+    private readonly minimum;
+    private readonly options;
+    constructor(minimum: Level, options?: LoggerOptions);
+    debug(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    error(message: string, fields?: Record<string, unknown>): void;
+    private write;
+    private capture;
+}
+export {};

package/dist/observability/logger.js

@@ -0,0 +1,62 @@
+import { appendFileSync, chmodSync, existsSync, renameSync, statSync, unlinkSync, } from "node:fs";
+const order = { debug: 10, info: 20, warn: 30, error: 40 };
+const secretKey = /authorization|api.?key|secret|password|cookie|^token$|access.?token|refresh.?token|id.?token/i;
+const contentKey = /^(output|stdout|stderr|prompt|input|content|toolOutput|fileContent|env)$/i;
+function sanitize(value, includeContent, key = "") {
+    if (secretKey.test(key))
+        return value == null ? value : "<REDACTED>";
+    if (!includeContent && contentKey.test(key))
+        return value == null ? value : "<CONTENT_REDACTED>";
+    if (typeof value === "string")
+        return value.length > 2_048 ? `${value.slice(0, 2_048)}<TRUNCATED>` : value;
+    if (Array.isArray(value))
+        return value.map((item) => sanitize(item, includeContent, key));
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([childKey, item]) => [childKey, sanitize(item, includeContent, childKey)]));
+    }
+    return value;
+}
+export class Logger {
+    minimum;
+    options;
+    constructor(minimum, options = {}) {
+        this.minimum = minimum;
+        this.options = options;
+        if (options.capturePath) {
+            process.stderr.write(`codex-hybrid: bounded debug capture enabled at ${options.capturePath}; content remains redacted unless log_prompts=true.\n`);
+        }
+    }
+    debug(message, fields = {}) {
+        this.write("debug", message, fields);
+    }
+    info(message, fields = {}) {
+        this.write("info", message, fields);
+    }
+    warn(message, fields = {}) {
+        this.write("warn", message, fields);
+    }
+    error(message, fields = {}) {
+        this.write("error", message, fields);
+    }
+    write(level, message, fields) {
+        if (order[level] < order[this.minimum])
+            return;
+        const line = `${JSON.stringify(sanitize({ ts: new Date().toISOString(), level, message, ...fields }, this.options.includeContent === true))}\n`;
+        process.stderr.write(line);
+        if (this.options.capturePath)
+            this.capture(line);
+    }
+    capture(line) {
+        const path = this.options.capturePath;
+        const maxBytes = this.options.maxBytes ?? 1_048_576;
+        if (existsSync(path) && statSync(path).size + Buffer.byteLength(line) > maxBytes) {
+            const previous = `${path}.1`;
+            if (existsSync(previous))
+                unlinkSync(previous);
+            renameSync(path, previous);
+        }
+        appendFileSync(path, line, { mode: 0o600 });
+        chmodSync(path, 0o600);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/observability/logger.js.map

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

package/dist/observability/metrics.d.ts

@@ -0,0 +1,25 @@
+type Provider = "stock" | "claude";
+type TerminalStatus = "completed" | "failed" | "interrupted";
+export declare class MetricsRegistry {
+    private activeConnections;
+    private loadedClaudeRuntimes;
+    private readonly pending;
+    private readonly turns;
+    private claudeRuntimeStarts;
+    private sdkCliRestarts;
+    private modelProbeFailures;
+    private eventDeduplications;
+    private readonly latency;
+    connectionOpened(): void;
+    connectionClosed(): void;
+    runtimeLoaded(resume: boolean): void;
+    runtimeUnloaded(): void;
+    turnCompleted(status: TerminalStatus): void;
+    modelProbeFailed(): void;
+    eventDeduplicated(): void;
+    pendingOpened(id: string, createdAt: number): void;
+    pendingClosed(id: string): void;
+    observeLatency(provider: Provider, durationMs: number): void;
+    snapshot(now?: number): Record<string, unknown>;
+}
+export {};

package/dist/observability/metrics.js

@@ -0,0 +1,59 @@
+export class MetricsRegistry {
+    activeConnections = 0;
+    loadedClaudeRuntimes = 0;
+    pending = new Map();
+    turns = { completed: 0, failed: 0, interrupted: 0 };
+    claudeRuntimeStarts = 0;
+    sdkCliRestarts = 0;
+    modelProbeFailures = 0;
+    eventDeduplications = 0;
+    latency = {
+        stock: { count: 0, totalMs: 0, maxMs: 0 },
+        claude: { count: 0, totalMs: 0, maxMs: 0 },
+    };
+    connectionOpened() { this.activeConnections += 1; }
+    connectionClosed() { this.activeConnections = Math.max(0, this.activeConnections - 1); }
+    runtimeLoaded(resume) {
+        this.loadedClaudeRuntimes += 1;
+        this.claudeRuntimeStarts += 1;
+        if (resume)
+            this.sdkCliRestarts += 1;
+    }
+    runtimeUnloaded() { this.loadedClaudeRuntimes = Math.max(0, this.loadedClaudeRuntimes - 1); }
+    turnCompleted(status) { this.turns[status] += 1; }
+    modelProbeFailed() { this.modelProbeFailures += 1; }
+    eventDeduplicated() { this.eventDeduplications += 1; }
+    pendingOpened(id, createdAt) { this.pending.set(id, createdAt); }
+    pendingClosed(id) { this.pending.delete(id); }
+    observeLatency(provider, durationMs) {
+        const latency = this.latency[provider];
+        latency.count += 1;
+        latency.totalMs += durationMs;
+        latency.maxMs = Math.max(latency.maxMs, durationMs);
+    }
+    snapshot(now = Date.now()) {
+        const oldest = this.pending.size > 0 ? Math.min(...this.pending.values()) : undefined;
+        const latency = (provider) => ({
+            count: this.latency[provider].count,
+            averageMs: this.latency[provider].count === 0 ? 0 : this.latency[provider].totalMs / this.latency[provider].count,
+            maxMs: this.latency[provider].maxMs,
+        });
+        return {
+            gauges: {
+                activeAppConnections: this.activeConnections,
+                loadedClaudeRuntimes: this.loadedClaudeRuntimes,
+                pendingApprovals: this.pending.size,
+                oldestPendingApprovalAgeMs: oldest === undefined ? 0 : Math.max(0, now - oldest),
+            },
+            counters: {
+                turnsByTerminalStatus: { ...this.turns },
+                claudeRuntimeStarts: this.claudeRuntimeStarts,
+                sdkCliRestarts: this.sdkCliRestarts,
+                modelProbeFailures: this.modelProbeFailures,
+                eventDeduplications: this.eventDeduplications,
+            },
+            requestLatency: { stock: latency("stock"), claude: latency("claude") },
+        };
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/observability/rpcRecorder.d.ts

@@ -0,0 +1,17 @@
+import type WebSocket from "ws";
+import type { HybridConfig } from "../config/config.js";
+export type RpcDirection = "client_to_gateway" | "gateway_to_client";
+export declare class RpcRecorder {
+    private readonly enabled;
+    private readonly includeContent;
+    private readonly totalMaxBytes;
+    private readonly segmentMaxBytes;
+    private readonly path;
+    private sequence;
+    private failed;
+    constructor(config: HybridConfig);
+    lifecycle(event: string, fields?: Record<string, unknown>): void;
+    connection(event: "opened" | "closed", connectionId: string, fields?: Record<string, unknown>): void;
+    frame(connectionId: string, direction: RpcDirection, data: WebSocket.RawData | string, isBinary: boolean): void;
+    private write;
+}