codex-grok-mcp 0.2.0-beta.1

package/dist/bridge-protocol.js

@@ -0,0 +1,360 @@
+import { Buffer } from "node:buffer";
+import { z } from "zod";
+import { MAX_PROMPT_BYTES } from "./schema.js";
+import { BRIDGE_STATUS_PROTOCOL_VERSION } from "./version.js";
+const MAX_ROSTER_BOTS = 500;
+export const MAX_READ_BOT_MESSAGES = 50;
+export const MAX_READ_SNAPSHOT_BYTES = 64 * 1024;
+const MAX_READ_TEXT_BYTES = 48 * 1024;
+const MAX_READ_MESSAGE_TEXT_BYTES = 16 * 1024;
+const rpcIdSchema = z.string().uuid();
+const botIdSchema = z.string().trim().min(1).max(512).refine((value) => !value.includes("\0"), "Bot ID must not contain NUL bytes");
+const messageSchema = z
+    .string()
+    .refine((value) => value.trim().length > 0, "Message must not be empty")
+    .refine((value) => !value.includes("\0"), "Message must not contain NUL bytes")
+    .refine((value) => Buffer.byteLength(value, "utf8") <= MAX_PROMPT_BYTES, `Message must not exceed ${MAX_PROMPT_BYTES} UTF-8 bytes`);
+export const bridgeBotSchema = z
+    .object({
+    id: botIdSchema,
+    name: z.string().trim().min(1).max(512),
+    is_running: z.boolean().nullable(),
+})
+    .strict();
+const bridgeReadTextSchema = z
+    .string()
+    .refine((value) => value.trim().length > 0, "Read message text must not be empty")
+    .refine((value) => sanitizeReadText(value) === value, "Read message text is not normalized")
+    .refine((value) => Buffer.byteLength(value, "utf8") <= MAX_READ_MESSAGE_TEXT_BYTES, `Read message text must not exceed ${MAX_READ_MESSAGE_TEXT_BYTES} UTF-8 bytes`);
+export const bridgeReadMessageSchema = z
+    .object({
+    speaker: z.enum(["user", "bot", "peer"]),
+    text: bridgeReadTextSchema,
+    timestamp_ms: z.number().int().nonnegative().safe().nullable(),
+})
+    .strict();
+export const bridgeReadSnapshotSchema = z
+    .object({
+    bot_id: botIdSchema,
+    is_running: z.boolean().nullable(),
+    is_composing: z.boolean().nullable(),
+    awaiting_user: z.boolean().nullable(),
+    async_task_count: z.number().int().nonnegative().nullable(),
+    running_subagent_count: z.number().int().nonnegative().nullable(),
+    messages: z.array(bridgeReadMessageSchema).max(MAX_READ_BOT_MESSAGES),
+    next_before_sequence: z.number().int().nonnegative().safe().nullable(),
+    truncated: z.boolean(),
+})
+    .strict()
+    .refine((value) => Buffer.byteLength(JSON.stringify(value), "utf8") <= MAX_READ_SNAPSHOT_BYTES, `Read snapshot must not exceed ${MAX_READ_SNAPSHOT_BYTES} UTF-8 bytes`);
+const bridgeCapabilitySchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z][a-z0-9_]*$/);
+export const bridgeStatusResultSchema = z
+    .object({
+    companion_version: z.string().min(1).max(64).regex(/^[0-9A-Za-z.+-]+$/),
+    supported_protocol_versions: z
+        .array(z.number().int().positive().max(32))
+        .min(1)
+        .max(16)
+        .refine((versions) => new Set(versions).size === versions.length, "Versions must be unique")
+        .refine((versions) => versions.every((version, index) => index === 0 || version > versions[index - 1]), "Versions must be sorted"),
+    capabilities: z
+        .array(bridgeCapabilitySchema)
+        .min(1)
+        .max(16)
+        .refine((capabilities) => new Set(capabilities).size === capabilities.length, "Capabilities must be unique"),
+    gateway_healthy: z.boolean(),
+    gateway_busy: z.boolean(),
+    non_group_bot_count: z.number().int().nonnegative().max(MAX_ROSTER_BOTS),
+})
+    .strict();
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function nonnegativeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0
+        ? value
+        : null;
+}
+function actorId(value) {
+    if (typeof value === "string" && value.length > 0 && value.length <= 512)
+        return value;
+    const source = record(value);
+    if (source === undefined)
+        return undefined;
+    return typeof source.id === "string" && source.id.length > 0 && source.id.length <= 512
+        ? source.id
+        : undefined;
+}
+function truncateUtf8(value, maxBytes) {
+    if (Buffer.byteLength(value, "utf8") <= maxBytes)
+        return { text: value, truncated: false };
+    const suffix = "…";
+    if (maxBytes < Buffer.byteLength(suffix, "utf8"))
+        return { text: "", truncated: true };
+    const budget = maxBytes - Buffer.byteLength(suffix, "utf8");
+    const characters = [];
+    let bytes = 0;
+    for (const character of value) {
+        const next = Buffer.byteLength(character, "utf8");
+        if (bytes + next > budget)
+            break;
+        characters.push(character);
+        bytes += next;
+    }
+    if (characters.length === 0)
+        return { text: "", truncated: true };
+    return { text: `${characters.join("")}${suffix}`, truncated: true };
+}
+function sanitizeReadText(value) {
+    return value
+        .replaceAll("\r\n", "\n")
+        .replaceAll("\r", "\n")
+        .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/gu, "");
+}
+function normalizeReadMessage(value, botId) {
+    const outer = record(value);
+    if (outer === undefined)
+        return undefined;
+    const nested = record(outer.entry);
+    const entry = nested ?? outer;
+    if (entry.streaming === true || outer.streaming === true)
+        return undefined;
+    const kind = typeof entry.kind === "string" ? entry.kind : undefined;
+    const role = entry.role === "user" || entry.role === "assistant" ? entry.role : undefined;
+    let text;
+    if ((kind === "message" || kind === undefined) && role !== undefined) {
+        if (typeof entry.content === "string" && entry.content.trim().length > 0) {
+            text = entry.content;
+        }
+    }
+    else if (kind === "send-message") {
+        const message = record(entry.message);
+        if (message?.type === "text" &&
+            typeof message.content === "string" &&
+            message.content.trim().length > 0) {
+            text = message.content;
+        }
+    }
+    if (text === undefined)
+        return undefined;
+    text = sanitizeReadText(text);
+    if (text.trim().length === 0)
+        return undefined;
+    const bounded = truncateUtf8(text, MAX_READ_MESSAGE_TEXT_BYTES);
+    const authorId = actorId(entry.author);
+    const fromAgentId = actorId(entry.fromAgent);
+    const fromUserId = actorId(entry.fromUser);
+    const sourceId = authorId ?? fromAgentId ?? fromUserId;
+    const hasPeerSource = record(entry.author) !== undefined ||
+        record(entry.fromAgent) !== undefined ||
+        typeof entry.author === "string" ||
+        typeof entry.fromAgent === "string";
+    const speaker = sourceId === botId
+        ? "bot"
+        : fromUserId !== undefined && !hasPeerSource
+            ? "user"
+            : hasPeerSource
+                ? "peer"
+                : role === "user"
+                    ? "user"
+                    : "bot";
+    return {
+        message: {
+            speaker,
+            text: bounded.text,
+            timestamp_ms: nonnegativeInteger(entry.timestampMs) ?? nonnegativeInteger(outer.timestampMs),
+        },
+        sequence: nonnegativeInteger(outer.seq) ?? nonnegativeInteger(entry.seq),
+        truncated: bounded.truncated,
+    };
+}
+export function createBridgeReadSnapshot(input) {
+    const normalized = input.entries
+        .map((entry) => normalizeReadMessage(entry, input.bot_id))
+        .filter((entry) => entry !== undefined);
+    const kept = [];
+    let remainingTextBytes = MAX_READ_TEXT_BYTES;
+    let truncated = normalized.some((entry) => entry.truncated);
+    for (let index = normalized.length - 1; index >= 0; index -= 1) {
+        const current = normalized[index];
+        if (current === undefined)
+            continue;
+        const bounded = truncateUtf8(current.message.text, remainingTextBytes);
+        if (bounded.text.length > 0) {
+            kept.push({
+                message: { ...current.message, text: bounded.text },
+                sequence: current.sequence,
+                truncated: current.truncated || bounded.truncated,
+            });
+            remainingTextBytes -= Buffer.byteLength(bounded.text, "utf8");
+        }
+        if (bounded.truncated || remainingTextBytes === 0) {
+            truncated = truncated || bounded.truncated || index > 0;
+            break;
+        }
+    }
+    kept.reverse();
+    let nextBeforeSequence = input.next_before_sequence;
+    const updatePaginationBoundary = (removedSequence) => {
+        const firstSequence = kept.find(({ sequence }) => sequence !== null)?.sequence;
+        if (firstSequence !== null && firstSequence !== undefined) {
+            nextBeforeSequence = firstSequence;
+        }
+        else if (removedSequence !== null &&
+            removedSequence !== undefined &&
+            Number.isSafeInteger(removedSequence + 1)) {
+            nextBeforeSequence = removedSequence + 1;
+        }
+    };
+    if (kept.length < normalized.length) {
+        truncated = true;
+        updatePaginationBoundary();
+    }
+    const snapshot = () => ({
+        bot_id: input.bot_id,
+        is_running: input.is_running,
+        is_composing: input.is_composing,
+        awaiting_user: input.awaiting_user,
+        async_task_count: input.async_task_count,
+        running_subagent_count: input.running_subagent_count,
+        messages: kept.map(({ message }) => message),
+        next_before_sequence: nextBeforeSequence,
+        truncated,
+    });
+    while (Buffer.byteLength(JSON.stringify(snapshot()), "utf8") > MAX_READ_SNAPSHOT_BYTES) {
+        const removed = kept.shift();
+        if (removed === undefined)
+            break;
+        truncated = true;
+        updatePaginationBoundary(removed.sequence);
+    }
+    return bridgeReadSnapshotSchema.parse(snapshot());
+}
+export const bridgeRequestSchema = z.discriminatedUnion("op", [
+    z
+        .object({
+        v: z.literal(BRIDGE_STATUS_PROTOCOL_VERSION),
+        id: rpcIdSchema,
+        issued_at_ms: z.number().int().nonnegative(),
+        op: z.literal("status"),
+        args: z.object({}).strict(),
+    })
+        .strict(),
+    z
+        .object({
+        v: z.literal(1),
+        id: rpcIdSchema,
+        issued_at_ms: z.number().int().nonnegative(),
+        op: z.literal("list_bots"),
+        args: z.object({}).strict(),
+    })
+        .strict(),
+    z
+        .object({
+        v: z.literal(2),
+        id: rpcIdSchema,
+        issued_at_ms: z.number().int().nonnegative(),
+        op: z.literal("read_bot"),
+        args: z
+            .object({
+            bot_id: botIdSchema,
+            limit: z.number().int().min(1).max(MAX_READ_BOT_MESSAGES),
+            before_sequence: z.number().int().nonnegative().safe().optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        v: z.literal(1),
+        id: rpcIdSchema,
+        issued_at_ms: z.number().int().nonnegative(),
+        op: z.literal("send_message"),
+        args: z
+            .object({
+            bot_id: botIdSchema,
+            message: messageSchema,
+        })
+            .strict(),
+    })
+        .strict(),
+]);
+export const bridgeErrorCodeSchema = z.enum([
+    "AUTH_FAILED",
+    "BOT_NOT_FOUND",
+    "CANCELLED",
+    "CONFIG_INVALID",
+    "GATEWAY_REJECTED",
+    "INVALID_RESPONSE",
+    "OUTPUT_LIMIT",
+    "RATE_LIMITED",
+    "ROSTER_CHANGED",
+    "TIMEOUT",
+    "UNAVAILABLE",
+    "UPGRADE_REQUIRED",
+]);
+const bridgeErrorSchema = z
+    .object({
+    code: bridgeErrorCodeSchema,
+    delivery_may_have_occurred: z.boolean(),
+    request_id: z.string().min(1).max(512).optional(),
+})
+    .strict();
+export const bridgeResponseSchema = z.union([
+    z
+        .object({
+        v: z.literal(BRIDGE_STATUS_PROTOCOL_VERSION),
+        id: rpcIdSchema,
+        op: z.literal("status"),
+        ok: z.literal(true),
+        result: bridgeStatusResultSchema,
+    })
+        .strict(),
+    z
+        .object({
+        v: z.literal(1),
+        id: rpcIdSchema,
+        op: z.literal("list_bots"),
+        ok: z.literal(true),
+        result: z.object({ bots: z.array(bridgeBotSchema).max(MAX_ROSTER_BOTS) }).strict(),
+    })
+        .strict(),
+    z
+        .object({
+        v: z.literal(2),
+        id: rpcIdSchema,
+        op: z.literal("read_bot"),
+        ok: z.literal(true),
+        result: bridgeReadSnapshotSchema,
+    })
+        .strict(),
+    z
+        .object({
+        v: z.literal(1),
+        id: rpcIdSchema,
+        op: z.literal("send_message"),
+        ok: z.literal(true),
+        result: z
+            .object({
+            accepted: z.literal(true),
+            request_id: z.string().min(1).max(512),
+        })
+            .strict(),
+    })
+        .strict(),
+    z
+        .object({
+        v: z.union([z.literal(1), z.literal(2), z.literal(BRIDGE_STATUS_PROTOCOL_VERSION)]),
+        id: rpcIdSchema,
+        ok: z.literal(false),
+        error: bridgeErrorSchema,
+    })
+        .strict(),
+]);
+//# sourceMappingURL=bridge-protocol.js.map

package/dist/bridge-protocol.js.map

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

package/dist/bridge-replay.d.ts

@@ -0,0 +1,10 @@
+export declare class BridgeReplayError extends Error {
+    constructor();
+}
+export declare function defaultReplayRoot(environment?: NodeJS.ProcessEnv, home?: string): string;
+export declare class PersistentReplayGuard {
+    #private;
+    private constructor();
+    static open(channel: string, retentionMs: number, root?: string): Promise<PersistentReplayGuard>;
+    claim(id: string, now: number): Promise<"claimed" | "replay">;
+}

package/dist/bridge-replay.js

@@ -0,0 +1,107 @@
+import { constants as fsConstants } from "node:fs";
+import { lstat, mkdir, open, readdir, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+const MAX_MARKERS = 1_024;
+export class BridgeReplayError extends Error {
+    constructor() {
+        super("replay_guard_failed");
+        this.name = "BridgeReplayError";
+    }
+}
+function isNodeError(caught) {
+    return caught instanceof Error && "code" in caught;
+}
+export function defaultReplayRoot(environment = process.env, home = homedir()) {
+    const xdgStateHome = environment.XDG_STATE_HOME;
+    const stateHome = xdgStateHome !== undefined && isAbsolute(xdgStateHome)
+        ? xdgStateHome
+        : join(home, ".local", "state");
+    if (!isAbsolute(stateHome))
+        throw new BridgeReplayError();
+    return join(stateHome, "codex-grok-mcp", "replay");
+}
+async function ensurePrivateDirectory(path) {
+    await mkdir(path, { recursive: true, mode: 0o700 });
+    const details = await lstat(path);
+    if (details.isSymbolicLink() || !details.isDirectory() || (details.mode & 0o777) !== 0o700) {
+        throw new BridgeReplayError();
+    }
+}
+export class PersistentReplayGuard {
+    #directory;
+    #retentionMs;
+    constructor(directory, retentionMs) {
+        this.#directory = directory;
+        this.#retentionMs = retentionMs;
+    }
+    static async open(channel, retentionMs, root = defaultReplayRoot()) {
+        await ensurePrivateDirectory(root);
+        const directory = join(root, `channel-${channel}`);
+        await ensurePrivateDirectory(directory);
+        const guard = new PersistentReplayGuard(directory, retentionMs);
+        await guard.#prune(Date.now());
+        return guard;
+    }
+    async claim(id, now) {
+        await this.#prune(now);
+        const marker = join(this.#directory, id);
+        const noFollow = typeof fsConstants.O_NOFOLLOW === "number" ? fsConstants.O_NOFOLLOW : 0;
+        let handle;
+        try {
+            handle = await open(marker, fsConstants.O_CREAT |
+                fsConstants.O_EXCL |
+                fsConstants.O_WRONLY |
+                noFollow, 0o600);
+        }
+        catch (caught) {
+            if (isNodeError(caught) && caught.code === "EEXIST")
+                return "replay";
+            throw new BridgeReplayError();
+        }
+        try {
+            await handle.writeFile(`${now}\n`, "utf8");
+            await handle.sync();
+        }
+        catch {
+            await handle.close().catch(() => undefined);
+            await unlink(marker).catch(() => undefined);
+            throw new BridgeReplayError();
+        }
+        await handle.close();
+        return "claimed";
+    }
+    async #prune(now) {
+        let entries;
+        try {
+            entries = await readdir(this.#directory);
+        }
+        catch {
+            throw new BridgeReplayError();
+        }
+        for (const entry of entries) {
+            const path = join(this.#directory, entry);
+            try {
+                const details = await lstat(path);
+                if (details.isSymbolicLink() ||
+                    !details.isFile() ||
+                    (details.mode & 0o777) !== 0o600) {
+                    throw new BridgeReplayError();
+                }
+                if (now - details.mtimeMs > this.#retentionMs)
+                    await unlink(path);
+            }
+            catch (caught) {
+                if (isNodeError(caught) && caught.code === "ENOENT")
+                    continue;
+                if (caught instanceof BridgeReplayError)
+                    throw caught;
+                throw new BridgeReplayError();
+            }
+        }
+        if ((await readdir(this.#directory)).length >= MAX_MARKERS) {
+            throw new BridgeReplayError();
+        }
+    }
+}
+//# sourceMappingURL=bridge-replay.js.map

package/dist/bridge-replay.js.map

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

package/dist/bridge-runtime.d.ts

@@ -0,0 +1,11 @@
+export declare class BridgeRuntimeError extends Error {
+    readonly code: "companion_already_running" | "companion_lease_invalid" | "companion_lease_stale";
+    constructor(code: "companion_already_running" | "companion_lease_invalid" | "companion_lease_stale");
+}
+export declare function companionLeasePath(configPath: string): string;
+export declare class CompanionLease {
+    #private;
+    private constructor();
+    static acquire(configPath: string): Promise<CompanionLease>;
+    release(): Promise<void>;
+}