codex-grok-mcp 0.2.0-beta.1

package/dist/bridge-runtime.js

@@ -0,0 +1,259 @@
+import { randomBytes } from "node:crypto";
+import { constants as fsConstants, readFileSync } from "node:fs";
+import { lstat, mkdir, open, unlink } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+const LEASE_VERSION = 1;
+const MAX_LEASE_BYTES = 1_024;
+export class BridgeRuntimeError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.name = "BridgeRuntimeError";
+        this.code = code;
+    }
+}
+function fail(code = "companion_lease_invalid") {
+    throw new BridgeRuntimeError(code);
+}
+function isNodeError(caught) {
+    return caught instanceof Error && "code" in caught;
+}
+function currentUid() {
+    if (typeof process.getuid !== "function")
+        fail();
+    return process.getuid();
+}
+function sameFile(left, right) {
+    return left.dev === right.dev && left.ino === right.ino;
+}
+function canonicalToken(value) {
+    return (/^[A-Za-z0-9_-]+$/.test(value) &&
+        Buffer.from(value, "base64url").length === 32 &&
+        Buffer.from(value, "base64url").toString("base64url") === value);
+}
+function parseLeaseRecord(contents) {
+    let value;
+    try {
+        value = JSON.parse(contents);
+    }
+    catch {
+        fail();
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        fail();
+    const record = value;
+    const keys = Object.keys(record).sort();
+    if (keys.length !== 4 ||
+        keys[0] !== "owner_token" ||
+        keys[1] !== "pid" ||
+        keys[2] !== "process_start_id" ||
+        keys[3] !== "version" ||
+        record.version !== LEASE_VERSION ||
+        !Number.isSafeInteger(record.pid) ||
+        record.pid <= 0 ||
+        record.pid > 2_147_483_647 ||
+        (record.process_start_id !== null &&
+            (typeof record.process_start_id !== "string" ||
+                !/^linux:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:[0-9]+$/.test(record.process_start_id))) ||
+        typeof record.owner_token !== "string" ||
+        !canonicalToken(record.owner_token)) {
+        fail();
+    }
+    return record;
+}
+function linuxProcessStartIdentity(pid) {
+    if (process.platform !== "linux")
+        return undefined;
+    try {
+        const bootId = readFileSync("/proc/sys/kernel/random/boot_id", "utf8")
+            .trim()
+            .toLowerCase();
+        if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(bootId)) {
+            return undefined;
+        }
+        const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+        const fields = stat.slice(stat.lastIndexOf(")") + 2).trim().split(/\s+/);
+        const startTicks = fields[19];
+        if (startTicks === undefined || !/^[0-9]+$/.test(startTicks))
+            return undefined;
+        return `linux:${bootId}:${startTicks}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+function processState(record) {
+    const actualStart = linuxProcessStartIdentity(record.pid);
+    if (record.process_start_id !== null && actualStart !== undefined) {
+        return record.process_start_id === actualStart ? "active" : "stale";
+    }
+    try {
+        process.kill(record.pid, 0);
+        return "active";
+    }
+    catch (caught) {
+        if (isNodeError(caught) && caught.code === "ESRCH")
+            return "stale";
+        if (isNodeError(caught) && caught.code === "EPERM")
+            return "active";
+        return "unknown";
+    }
+}
+async function ensurePrivateParent(path) {
+    const parent = dirname(path);
+    try {
+        await mkdir(parent, { recursive: true, mode: 0o700 });
+        const details = await lstat(parent);
+        if (details.isSymbolicLink() ||
+            !details.isDirectory() ||
+            (details.mode & 0o7777) !== 0o700 ||
+            details.uid !== currentUid()) {
+            fail();
+        }
+    }
+    catch (caught) {
+        if (caught instanceof BridgeRuntimeError)
+            throw caught;
+        fail();
+    }
+}
+async function readLease(path) {
+    let handle;
+    try {
+        const pathDetails = await lstat(path);
+        if (pathDetails.isSymbolicLink() ||
+            !pathDetails.isFile() ||
+            (pathDetails.mode & 0o7777) !== 0o600 ||
+            pathDetails.uid !== currentUid() ||
+            pathDetails.nlink !== 1 ||
+            pathDetails.size <= 0 ||
+            pathDetails.size > MAX_LEASE_BYTES) {
+            fail();
+        }
+        handle = await open(path, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW);
+        const details = await handle.stat();
+        if (!sameFile(pathDetails, details) ||
+            !details.isFile() ||
+            (details.mode & 0o7777) !== 0o600 ||
+            details.uid !== currentUid() ||
+            details.nlink !== 1 ||
+            details.size <= 0 ||
+            details.size > MAX_LEASE_BYTES) {
+            fail();
+        }
+        const buffer = Buffer.alloc(MAX_LEASE_BYTES + 1);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        if (bytesRead === 0 || bytesRead > MAX_LEASE_BYTES)
+            fail();
+        return {
+            device: details.dev,
+            inode: details.ino,
+            record: parseLeaseRecord(buffer.subarray(0, bytesRead).toString("utf8")),
+        };
+    }
+    catch (caught) {
+        if (caught instanceof BridgeRuntimeError)
+            throw caught;
+        throw caught;
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+export function companionLeasePath(configPath) {
+    return `${resolve(configPath)}.lock`;
+}
+export class CompanionLease {
+    #path;
+    #ownerToken;
+    constructor(path, ownerToken) {
+        this.#path = path;
+        this.#ownerToken = ownerToken;
+    }
+    static async acquire(configPath) {
+        const path = companionLeasePath(configPath);
+        await ensurePrivateParent(path);
+        for (let attempt = 0; attempt < 4; attempt += 1) {
+            const ownerToken = randomBytes(32).toString("base64url");
+            let handle;
+            try {
+                handle = await open(path, fsConstants.O_CREAT |
+                    fsConstants.O_EXCL |
+                    fsConstants.O_WRONLY |
+                    fsConstants.O_NOFOLLOW, 0o600);
+            }
+            catch (caught) {
+                if (!isNodeError(caught) || caught.code !== "EEXIST")
+                    fail();
+                let snapshot;
+                try {
+                    snapshot = await readLease(path);
+                }
+                catch (readError) {
+                    if (isNodeError(readError) && readError.code === "ENOENT")
+                        continue;
+                    fail();
+                }
+                const state = processState(snapshot.record);
+                if (state === "active")
+                    fail("companion_already_running");
+                if (state === "stale")
+                    fail("companion_lease_stale");
+                fail();
+            }
+            const record = {
+                version: LEASE_VERSION,
+                pid: process.pid,
+                process_start_id: linuxProcessStartIdentity(process.pid) ?? null,
+                owner_token: ownerToken,
+            };
+            try {
+                const details = await handle.stat();
+                if (!details.isFile() ||
+                    (details.mode & 0o7777) !== 0o600 ||
+                    details.uid !== currentUid() ||
+                    details.nlink !== 1) {
+                    fail();
+                }
+                await handle.writeFile(`${JSON.stringify(record)}\n`, "utf8");
+                await handle.sync();
+                return new CompanionLease(path, ownerToken);
+            }
+            catch (caught) {
+                await handle.close().catch(() => undefined);
+                await unlink(path).catch(() => undefined);
+                if (caught instanceof BridgeRuntimeError)
+                    throw caught;
+                fail();
+            }
+            finally {
+                await handle.close().catch(() => undefined);
+            }
+        }
+        fail();
+    }
+    async release() {
+        const snapshot = await readLease(this.#path).catch(() => fail());
+        if (snapshot.record.owner_token !== this.#ownerToken)
+            fail();
+        let current;
+        try {
+            current = await readLease(this.#path);
+        }
+        catch {
+            fail();
+        }
+        if (current.device !== snapshot.device ||
+            current.inode !== snapshot.inode ||
+            current.record.owner_token !== this.#ownerToken) {
+            fail();
+        }
+        try {
+            await unlink(this.#path);
+        }
+        catch {
+            fail();
+        }
+    }
+}
+//# sourceMappingURL=bridge-runtime.js.map

package/dist/bridge-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-runtime.js","sourceRoot":"","sources":["../src/bridge-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,eAAe,GAAG,KAAK,CAAC;AAe9B,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAGe;IAE5B,YACE,IAG2B;QAE3B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,SAAS,IAAI,CACX,IAAI,GAG0B,yBAAyB;IAEvD,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,MAAe;IAClC,OAAO,MAAM,YAAY,KAAK,IAAI,MAAM,IAAI,MAAM,CAAC;AACrD,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;QAAE,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CACf,IAAkC,EAClC,KAAmC;IAEnC,OAAO,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,CACL,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,MAAM,KAAK,EAAE;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,KAAK,CAChE,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IACE,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa;QACzB,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;QACjB,IAAI,CAAC,CAAC,CAAC,KAAK,kBAAkB;QAC9B,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;QACrB,MAAM,CAAC,OAAO,KAAK,aAAa;QAChC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC;QAChC,MAAM,CAAC,GAAc,IAAI,CAAC;QAC1B,MAAM,CAAC,GAAc,GAAG,aAAa;QACtC,CAAC,MAAM,CAAC,gBAAgB,KAAK,IAAI;YAC/B,CAAC,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ;gBAC1C,CAAC,6EAA6E,CAAC,IAAI,CACjF,MAAM,CAAC,gBAAgB,CACxB,CAAC,CAAC;QACP,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QACtC,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,EACnC,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC;IACD,OAAO,MAAqB,CAAC;AAC/B,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAW;IAC5C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,iCAAiC,EAAE,MAAM,CAAC;aACnE,IAAI,EAAE;aACN,WAAW,EAAE,CAAC;QACjB,IACE,CAAC,gEAAgE,CAAC,IAAI,CACpE,MAAM,CACP,EACD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/E,OAAO,SAAS,MAAM,IAAI,UAAU,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAmB;IACvC,MAAM,WAAW,GAAG,yBAAyB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,gBAAgB,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,gBAAgB,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QACnE,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,QAAQ,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAY;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,IACE,OAAO,CAAC,cAAc,EAAE;YACxB,CAAC,OAAO,CAAC,WAAW,EAAE;YACtB,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,KAAK;YACjC,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE,EAC5B,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,IAAI,MAAM,YAAY,kBAAkB;YAAE,MAAM,MAAM,CAAC;QACvD,IAAI,EAAE,CAAC;IACT,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IACE,WAAW,CAAC,cAAc,EAAE;YAC5B,CAAC,WAAW,CAAC,MAAM,EAAE;YACrB,CAAC,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,KAAK;YACrC,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE;YAChC,WAAW,CAAC,KAAK,KAAK,CAAC;YACvB,WAAW,CAAC,IAAI,IAAI,CAAC;YACrB,WAAW,CAAC,IAAI,GAAG,eAAe,EAClC,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QACD,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,IACE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;YAC/B,CAAC,OAAO,CAAC,MAAM,EAAE;YACjB,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,KAAK;YACjC,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE;YAC5B,OAAO,CAAC,KAAK,KAAK,CAAC;YACnB,OAAO,CAAC,IAAI,IAAI,CAAC;YACjB,OAAO,CAAC,IAAI,GAAG,eAAe,EAC9B,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QACjD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,GAAG,eAAe;YAAE,IAAI,EAAE,CAAC;QAC3D,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,GAAG;YACnB,KAAK,EAAE,OAAO,CAAC,GAAG;YAClB,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,IAAI,MAAM,YAAY,kBAAkB;YAAE,MAAM,MAAM,CAAC;QACvD,MAAM,MAAM,CAAC;IACf,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;AACvC,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,KAAK,CAAS;IACd,WAAW,CAAS;IAE7B,YAAoB,IAAY,EAAE,UAAkB;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAkB;QACrC,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAEhC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,IAAI,CACjB,IAAI,EACJ,WAAW,CAAC,OAAO;oBACjB,WAAW,CAAC,MAAM;oBAClB,WAAW,CAAC,QAAQ;oBACpB,WAAW,CAAC,UAAU,EACxB,KAAK,CACN,CAAC;YACJ,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;oBAAE,IAAI,EAAE,CAAC;gBAC7D,IAAI,QAAuB,CAAC;gBAC5B,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;gBAAC,OAAO,SAAS,EAAE,CAAC;oBACnB,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;wBAAE,SAAS;oBACpE,IAAI,EAAE,CAAC;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC5C,IAAI,KAAK,KAAK,QAAQ;oBAAE,IAAI,CAAC,2BAA2B,CAAC,CAAC;gBAC1D,IAAI,KAAK,KAAK,OAAO;oBAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;gBACrD,IAAI,EAAE,CAAC;YACT,CAAC;YAED,MAAM,MAAM,GAAgB;gBAC1B,OAAO,EAAE,aAAa;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,gBAAgB,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI;gBAChE,WAAW,EAAE,UAAU;aACxB,CAAC;YACF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpC,IACE,CAAC,OAAO,CAAC,MAAM,EAAE;oBACjB,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,KAAK;oBACjC,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE;oBAC5B,OAAO,CAAC,KAAK,KAAK,CAAC,EACnB,CAAC;oBACD,IAAI,EAAE,CAAC;gBACT,CAAC;gBACD,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC9D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC5C,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC1C,IAAI,MAAM,YAAY,kBAAkB;oBAAE,MAAM,MAAM,CAAC;gBACvD,IAAI,EAAE,CAAC;YACT,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACjE,IAAI,QAAQ,CAAC,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW;YAAE,IAAI,EAAE,CAAC;QAC7D,IAAI,OAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC;QACT,CAAC;QACD,IACE,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAClC,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;YAChC,OAAO,CAAC,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW,EAC/C,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;CACF"}

package/dist/direct-gateway-transport.d.ts

@@ -0,0 +1,7 @@
+import { type GrokBotTransport } from "./grok-bot-gateway.js";
+export type DirectGatewayConfig = {
+    baseUrl: string;
+    token: string;
+};
+export declare function loadDirectGatewayConfig(env?: NodeJS.ProcessEnv): DirectGatewayConfig | undefined;
+export declare function createDirectGatewayTransport(config: DirectGatewayConfig): GrokBotTransport;

package/dist/direct-gateway-transport.js

@@ -0,0 +1,241 @@
+import { Buffer } from "node:buffer";
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { GrokBotGatewayError, } from "./grok-bot-gateway.js";
+import { createBridgeReadSnapshot, MAX_READ_BOT_MESSAGES } from "./bridge-protocol.js";
+const GATEWAY_TIMEOUT_MS = 10_000;
+const MAX_GATEWAY_RESPONSE_BYTES = 1024 * 1024;
+const MAX_ROSTER_BOTS = 500;
+const rawBotSchema = z
+    .object({
+    id: z.string().trim().min(1).max(512),
+    name: z.string().trim().min(1).max(512),
+    isRunning: z.boolean().optional(),
+    isComposingMessage: z.boolean().optional(),
+    awaitingUserResponse: z.unknown().optional(),
+    isGroup: z.boolean().optional(),
+})
+    .passthrough();
+const rawRosterSchema = z.array(rawBotSchema).max(MAX_ROSTER_BOTS);
+const sendPromptResponseSchema = z.object({ accepted: z.literal(true) }).passthrough();
+const transcriptTailSchema = z
+    .object({
+    entries: z.array(z.unknown()).max(MAX_READ_BOT_MESSAGES),
+    nextBeforeSeq: z.number().int().nonnegative().safe().optional(),
+})
+    .passthrough();
+const asyncTasksSchema = z
+    .array(z.object({ status: z.literal("running") }).passthrough())
+    .max(MAX_ROSTER_BOTS);
+const subagentsSchema = z
+    .array(z.object({ status: z.string() }).passthrough())
+    .max(MAX_ROSTER_BOTS);
+function error(code, message, options = {}) {
+    return new GrokBotGatewayError(code, message, options);
+}
+export function loadDirectGatewayConfig(env = process.env) {
+    const urlText = env.GROKBOT_GATEWAY_URL?.trim();
+    const token = env.SAND_GATEWAY_TOKEN?.trim();
+    if (!urlText && !token)
+        return undefined;
+    if (!urlText || !token) {
+        throw error("CONFIG_INVALID", "Persistent Grok Bot tools require both GROKBOT_GATEWAY_URL and SAND_GATEWAY_TOKEN.");
+    }
+    if (token.length > 4096 || /[\0\r\n]/.test(token)) {
+        throw error("CONFIG_INVALID", "SAND_GATEWAY_TOKEN is invalid.");
+    }
+    let url;
+    try {
+        url = new URL(urlText);
+    }
+    catch {
+        throw error("CONFIG_INVALID", "GROKBOT_GATEWAY_URL must be an absolute HTTP(S) URL.");
+    }
+    if (!["http:", "https:"].includes(url.protocol)) {
+        throw error("CONFIG_INVALID", "GROKBOT_GATEWAY_URL must use HTTP or HTTPS.");
+    }
+    const hostname = url.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+    const isLoopback = hostname === "localhost" || hostname === "::1" || /^127(?:\.\d{1,3}){3}$/.test(hostname);
+    if (url.protocol === "http:" && !isLoopback) {
+        throw error("CONFIG_INVALID", "GROKBOT_GATEWAY_URL must use HTTPS unless it points to loopback. Use an SSH or VPN local forward for remote plaintext gateways.");
+    }
+    if (url.username || url.password || url.search || url.hash) {
+        throw error("CONFIG_INVALID", "GROKBOT_GATEWAY_URL must not contain credentials, a query string, or a fragment.");
+    }
+    return { baseUrl: url.toString().replace(/\/+$/, ""), token };
+}
+function endpoint(config, command) {
+    return `${config.baseUrl}/api/${command}`;
+}
+async function readResponse(response, requestId, deliveryMayHaveOccurred) {
+    const contentLength = response.headers.get("content-length");
+    if (contentLength !== null && Number(contentLength) > MAX_GATEWAY_RESPONSE_BYTES) {
+        await response.body?.cancel().catch(() => undefined);
+        throw error("OUTPUT_LIMIT", "Grok Bot gateway response exceeded the 1 MiB safety limit.", {
+            deliveryMayHaveOccurred,
+            requestId,
+        });
+    }
+    if (response.body === null)
+        return "";
+    const chunks = [];
+    const reader = response.body.getReader();
+    let bytes = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        bytes += value.byteLength;
+        if (bytes > MAX_GATEWAY_RESPONSE_BYTES) {
+            await reader.cancel().catch(() => undefined);
+            throw error("OUTPUT_LIMIT", "Grok Bot gateway response exceeded the 1 MiB safety limit.", {
+                deliveryMayHaveOccurred,
+                requestId,
+            });
+        }
+        chunks.push(Buffer.from(value));
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function httpError(status, requestId, command) {
+    const deliveryMayHaveOccurred = command === "sendPrompt";
+    if (status === 401 || status === 403) {
+        return error("AUTH_FAILED", "Grok Bot gateway authentication failed.", {
+            deliveryMayHaveOccurred,
+            requestId,
+        });
+    }
+    if (status === 429) {
+        return error("RATE_LIMITED", "Grok Bot gateway rate limit was reached.", {
+            deliveryMayHaveOccurred,
+            requestId,
+        });
+    }
+    return error("GATEWAY_REJECTED", `Grok Bot gateway rejected the request with HTTP ${status}.`, {
+        deliveryMayHaveOccurred,
+        requestId,
+    });
+}
+async function postGateway(config, command, body, schema, signal) {
+    if (signal?.aborted)
+        throw error("CANCELLED", "Grok Bot gateway request was cancelled.");
+    const requestId = randomUUID();
+    const timeoutSignal = AbortSignal.timeout(GATEWAY_TIMEOUT_MS);
+    const requestSignal = signal === undefined ? timeoutSignal : AbortSignal.any([signal, timeoutSignal]);
+    let response;
+    try {
+        response = await fetch(endpoint(config, command), {
+            method: "POST",
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${config.token}`,
+                "Content-Type": "application/json",
+                "x-sand-request-id": requestId,
+                "x-sand-slim-avatars": "1",
+            },
+            body: JSON.stringify(body),
+            redirect: "error",
+            signal: requestSignal,
+        });
+    }
+    catch {
+        if (signal?.aborted) {
+            throw error("CANCELLED", "Grok Bot gateway request was cancelled.", {
+                deliveryMayHaveOccurred: command === "sendPrompt",
+                requestId,
+            });
+        }
+        if (timeoutSignal.aborted) {
+            throw error("TIMEOUT", "Grok Bot gateway request timed out.", {
+                deliveryMayHaveOccurred: command === "sendPrompt",
+                requestId,
+            });
+        }
+        throw error("UNAVAILABLE", "Grok Bot gateway could not be reached.", {
+            deliveryMayHaveOccurred: command === "sendPrompt",
+            requestId,
+        });
+    }
+    if (!response.ok) {
+        await response.body?.cancel().catch(() => undefined);
+        throw httpError(response.status, requestId, command);
+    }
+    let text;
+    try {
+        text = await readResponse(response, requestId, command === "sendPrompt");
+    }
+    catch (caught) {
+        if (caught instanceof GrokBotGatewayError)
+            throw caught;
+        throw error("UNAVAILABLE", "Grok Bot gateway response ended unexpectedly.", {
+            deliveryMayHaveOccurred: command === "sendPrompt",
+            requestId,
+        });
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw error("INVALID_RESPONSE", "Grok Bot gateway returned malformed JSON.", {
+            deliveryMayHaveOccurred: command === "sendPrompt",
+            requestId,
+        });
+    }
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        throw error("INVALID_RESPONSE", "Grok Bot gateway returned an unexpected response.", {
+            deliveryMayHaveOccurred: command === "sendPrompt",
+            requestId,
+        });
+    }
+    return { data: parsed.data, requestId };
+}
+export function createDirectGatewayTransport(config) {
+    return {
+        async listBots(signal) {
+            const { data } = await postGateway(config, "listAgents", {}, rawRosterSchema, signal);
+            return data
+                .filter((bot) => bot.isGroup === false)
+                .map((bot) => ({ id: bot.id, name: bot.name, is_running: bot.isRunning ?? null }));
+        },
+        async readBot(botId, options, signal) {
+            const { data: agents } = await postGateway(config, "listAgents", {}, rawRosterSchema, signal);
+            const bot = agents.find((candidate) => candidate.id === botId);
+            if (bot === undefined || bot.isGroup !== false) {
+                throw error("BOT_NOT_FOUND", "Bot ID is not present in the current non-group roster.");
+            }
+            const [tail, tasks, subagents] = await Promise.all([
+                postGateway(config, "getAgentTranscriptTail", {
+                    id: botId,
+                    limit: options.limit,
+                    ...(options.beforeSequence === undefined
+                        ? {}
+                        : { beforeSeq: options.beforeSequence }),
+                }, transcriptTailSchema, signal),
+                postGateway(config, "getAsyncTasks", { id: botId }, asyncTasksSchema, signal),
+                postGateway(config, "getSubagents", { id: botId }, subagentsSchema, signal),
+            ]);
+            if (tail.data.entries.length > options.limit) {
+                throw error("INVALID_RESPONSE", "Grok Bot gateway returned too many transcript entries.");
+            }
+            return createBridgeReadSnapshot({
+                bot_id: botId,
+                is_running: bot.isRunning ?? null,
+                is_composing: bot.isComposingMessage ?? null,
+                awaiting_user: bot.awaitingUserResponse === undefined
+                    ? null
+                    : bot.awaitingUserResponse !== null && bot.awaitingUserResponse !== false,
+                async_task_count: tasks.data.length,
+                running_subagent_count: subagents.data.filter(({ status }) => status === "running").length,
+                entries: tail.data.entries,
+                next_before_sequence: tail.data.nextBeforeSeq ?? null,
+            });
+        },
+        async sendMessage(botId, message, signal) {
+            const { requestId } = await postGateway(config, "sendPrompt", { agentId: botId, prompt: message }, sendPromptResponseSchema, signal);
+            return { accepted: true, requestId };
+        },
+    };
+}
+//# sourceMappingURL=direct-gateway-transport.js.map

package/dist/direct-gateway-transport.js.map

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

package/dist/grok-bot-client.d.ts

@@ -0,0 +1,93 @@
+import { z } from "zod";
+declare const healthSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    isBusy: z.ZodBoolean;
+}, z.core.$loose>;
+declare const agentSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    isGroup: z.ZodBoolean;
+    isRunning: z.ZodOptional<z.ZodBoolean>;
+    isComposingMessage: z.ZodOptional<z.ZodBoolean>;
+    awaitingUserResponse: z.ZodOptional<z.ZodUnknown>;
+    lastMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    newestEntryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+declare const transcriptTailInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    limit: z.ZodNumber;
+    beforeSeq: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const transcriptTailSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodUnknown>;
+    nextBeforeSeq: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+declare const asyncTaskSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "cloud-agent": "cloud-agent";
+        shell: "shell";
+        subagent: "subagent";
+    }>;
+    id: z.ZodString;
+    label: z.ZodString;
+    status: z.ZodLiteral<"running">;
+    startedAtMs: z.ZodNumber;
+    detail: z.ZodOptional<z.ZodString>;
+    subagentType: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+declare const subagentSchema: z.ZodObject<{
+    subagentId: z.ZodString;
+    subagentType: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodString;
+    startedAtMs: z.ZodNumber;
+}, z.core.$loose>;
+export type LocalGatewayDiscovery = {
+    port: number;
+    pid: number;
+    hasToken: boolean;
+};
+export type LocalGatewayHealth = z.infer<typeof healthSchema>;
+export type LocalAgentSummary = z.infer<typeof agentSchema>;
+export type LocalTranscriptTailInput = z.infer<typeof transcriptTailInputSchema>;
+export type LocalTranscriptTail = z.infer<typeof transcriptTailSchema>;
+export type LocalAsyncTask = z.infer<typeof asyncTaskSchema>;
+export type LocalSubagent = z.infer<typeof subagentSchema>;
+export type LocalSendPromptInput = {
+    agentId: string;
+    prompt: string;
+    clientNonce: string;
+};
+export type LocalGatewayErrorCode = "AUTH_FAILED" | "CONFIG_INVALID" | "GATEWAY_REJECTED" | "INVALID_RESPONSE" | "OUTPUT_LIMIT" | "RATE_LIMITED" | "TIMEOUT" | "UNAVAILABLE";
+type ClientOptions = {
+    env?: NodeJS.ProcessEnv;
+    discoveryPath?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    verifyServer?: (pid: number, port: number, host: string, startedAt: number) => boolean;
+};
+export declare class LocalGatewayError extends Error {
+    readonly code: LocalGatewayErrorCode;
+    readonly status: number;
+    readonly requestId: string;
+    constructor(code: LocalGatewayErrorCode, status: number, requestId: string);
+}
+export declare class LocalGrokBotClient {
+    #private;
+    constructor(options?: ClientOptions);
+    discovery(): LocalGatewayDiscovery;
+    withGatewaySnapshot<T>(operation: () => Promise<T>): Promise<T>;
+    health(): Promise<LocalGatewayHealth>;
+    listAgents(): Promise<LocalAgentSummary[]>;
+    sendPrompt(input: LocalSendPromptInput): Promise<{
+        accepted: true;
+    }>;
+    getAgentTranscriptTail(input: LocalTranscriptTailInput): Promise<LocalTranscriptTail>;
+    getAsyncTasks(input: {
+        id: string;
+    }): Promise<LocalAsyncTask[]>;
+    getSubagents(input: {
+        id: string;
+    }): Promise<LocalSubagent[]>;
+}
+export {};