@trusty-squire/mcp 1.1.13 → 1.1.14-rc.10

package/dist/bot/broker/transport.js

@@ -0,0 +1,265 @@
+import { createServer, createConnection } from "node:net";
+import { chmod, lstat, unlink } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { BrokerRefusal } from "./scheduler.js";
+import { FORWARDER_HANDOFF_TIMEOUT_MS, } from "./authority.js";
+const MAX_FRAME = 8 * 1024 * 1024;
+const requestSchema = z
+    .object({
+    version: z.literal(1),
+    id: z.string().min(1).max(128),
+    method: z.string().min(1).max(64),
+    params: z.record(z.unknown()),
+})
+    .strict();
+/** A socket is the client-liveness lease. There is deliberately no idle TTL:
+ * a thinking agent with a live transport must not lose its browser session. */
+function frames(socket, receive) {
+    let buffered = Buffer.alloc(0);
+    socket.on("data", (chunk) => {
+        buffered = Buffer.concat([buffered, chunk]);
+        for (;;) {
+            const end = buffered.indexOf(10);
+            if (end < 0)
+                break;
+            if (end > MAX_FRAME) {
+                socket.destroy();
+                return;
+            }
+            const frame = buffered.subarray(0, end);
+            buffered = buffered.subarray(end + 1);
+            try {
+                receive(JSON.parse(frame.toString("utf8")));
+            }
+            catch {
+                socket.destroy();
+                return;
+            }
+        }
+        if (buffered.length > MAX_FRAME)
+            socket.destroy();
+    });
+}
+function send(socket, value) {
+    const frame = JSON.stringify(value) + "\n";
+    if (Buffer.byteLength(frame) > MAX_FRAME || socket.writableLength > MAX_FRAME * 2) {
+        socket.destroy(new Error("Broker transport capacity exceeded"));
+        return;
+    }
+    socket.write(frame);
+}
+/** Endpoint election is bind-exclusive. Never unlink an existing socket to win
+ * election: its incumbent may still own Chrome, even if it is unresponsive. */
+export async function listenBroker(path, port) {
+    const sockets = new Set();
+    const cleanup = new Set();
+    const server = createServer((socket) => {
+        sockets.add(socket);
+        socket.on("error", () => undefined);
+        let principal;
+        let authenticating = false;
+        let closed = false;
+        const replies = new Map();
+        let explicitClose = false;
+        const disconnect = (owner) => {
+            const task = port.disconnect(owner, explicitClose).catch(() => undefined);
+            cleanup.add(task);
+            void task.finally(() => cleanup.delete(task));
+        };
+        socket.once("close", () => {
+            closed = true;
+            sockets.delete(socket);
+            if (principal !== undefined)
+                disconnect(principal);
+        });
+        const dispatch = async (request) => {
+            if (principal === undefined) {
+                if (request.method !== "hello" ||
+                    authenticating ||
+                    typeof request.params.token !== "string") {
+                    throw new BrokerRefusal("unauthorized", "Authenticate before issuing commands");
+                }
+                authenticating = true;
+                const agentId = typeof request.params.agentId === "string" ? request.params.agentId : "local-agent";
+                const lineageCredential = typeof request.params.lineageCredential === "string"
+                    ? request.params.lineageCredential
+                    : undefined;
+                const supervisor = request.params.supervisor === true;
+                if (agentId.length === 0 || agentId.length > 128)
+                    throw new BrokerRefusal("unauthorized", "Invalid agent identity");
+                const identity = await port.authenticate(request.params.token, agentId, lineageCredential, supervisor);
+                if (identity === null)
+                    throw new BrokerRefusal("unauthorized", "Invalid broker credential");
+                const candidate = { ...identity, clientId: randomUUID() };
+                await port.connected?.(candidate);
+                if (closed) {
+                    await port.disconnect(candidate);
+                    throw new BrokerRefusal("cancelled", "Client disconnected");
+                }
+                principal = candidate;
+                return { version: 1, clientId: principal.clientId };
+            }
+            if (request.method === "hello")
+                throw new BrokerRefusal("unauthorized", "Connection already bound");
+            if (request.method === "client_close") {
+                explicitClose = true;
+                return {};
+            }
+            return await port.call(principal, request.method, request.params, request.id);
+        };
+        frames(socket, (value) => {
+            const parsed = requestSchema.safeParse(value);
+            if (!parsed.success) {
+                socket.destroy();
+                return;
+            }
+            const request = parsed.data;
+            const input = JSON.stringify([request.method, request.params]);
+            const previous = replies.get(request.id);
+            let result;
+            if (previous !== undefined) {
+                result =
+                    previous.input === input
+                        ? previous.result
+                        : Promise.reject(new BrokerRefusal("request_id_reused", "Request ID has different input"));
+            }
+            else if (replies.size >= 8192) {
+                result = Promise.reject(new BrokerRefusal("capacity", "Connection command budget exhausted"));
+            }
+            else {
+                result = dispatch(request);
+                replies.set(request.id, { input, result });
+            }
+            void result.then((data) => {
+                if (!closed)
+                    send(socket, { id: request.id, result: data });
+            }, (error) => {
+                if (!closed)
+                    send(socket, {
+                        id: request.id,
+                        error: {
+                            code: error instanceof BrokerRefusal ? error.code : "broker_execution_failed",
+                            message: error instanceof Error ? error.message : String(error),
+                        },
+                    });
+            });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(path, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    await chmod(path, 0o600);
+    const identity = await lstat(path);
+    return {
+        close: async () => {
+            const stopped = new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())));
+            for (const socket of sockets)
+                socket.destroy();
+            await stopped;
+            await Promise.all([...cleanup]);
+            const current = await lstat(path).catch(() => null);
+            if (current?.ino === identity.ino && current.dev === identity.dev)
+                await unlink(path);
+        },
+    };
+}
+export class BrokerClient {
+    socket;
+    pending = new Map();
+    ended = false;
+    constructor(socket) {
+        this.socket = socket;
+        socket.on("error", () => undefined);
+        socket.once("close", () => {
+            this.ended = true;
+            for (const request of this.pending.values())
+                request.reject(new BrokerRefusal("broker_lost", "Broker connection lost; dispatched outcome may be unknown. Do not replay mutations."));
+            this.pending.clear();
+        });
+        frames(socket, (value) => {
+            const reply = value;
+            if (typeof reply !== "object" || reply === null || typeof reply.id !== "string") {
+                socket.destroy();
+                return;
+            }
+            const pending = this.pending.get(reply.id);
+            if (pending === undefined)
+                return;
+            this.pending.delete(reply.id);
+            if (reply.error !== undefined)
+                pending.reject(new BrokerRefusal(reply.error.code, reply.error.message));
+            else {
+                pending.resolve(reply.result);
+            }
+        });
+    }
+    static async connect(path, token, lineageCredential, supervisor = false) {
+        const socket = createConnection(path);
+        const client = new BrokerClient(socket);
+        const deadline = setTimeout(() => socket.destroy(new Error("Broker authentication timed out")), lineageCredential === undefined ? 5_000 : FORWARDER_HANDOFF_TIMEOUT_MS + 5_000);
+        try {
+            await new Promise((resolve, reject) => {
+                socket.once("connect", resolve);
+                socket.once("error", reject);
+            });
+            await client.call("hello", {
+                token,
+                agentId: process.env.TRUSTY_SQUIRE_AGENT_IDENTITY ?? "local-agent",
+                ...(lineageCredential === undefined ? {} : { lineageCredential }),
+                ...(supervisor ? { supervisor: true } : {}),
+            });
+            return client;
+        }
+        catch (error) {
+            socket.destroy();
+            throw error;
+        }
+        finally {
+            clearTimeout(deadline);
+        }
+    }
+    static async connectSupervisor(path, token) {
+        return await BrokerClient.connect(path, token, undefined, true);
+    }
+    call(method, params, id = randomUUID()) {
+        if (this.ended || this.socket.destroyed)
+            return Promise.reject(new BrokerRefusal("broker_lost", "Broker connection is closed"));
+        if (this.pending.has(id))
+            return Promise.reject(new BrokerRefusal("duplicate_pending", "Request is already pending"));
+        if (this.pending.size >= 64)
+            return Promise.reject(new BrokerRefusal("capacity", "Too many pending broker calls"));
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { method, resolve, reject });
+            send(this.socket, { version: 1, id, method, params });
+        });
+    }
+    async acknowledge(requestId) {
+        await this.call("acknowledge", { requestId });
+    }
+    async confirmStartDelivery(capability) {
+        await this.call("confirm_start", { capability });
+    }
+    isConnected() {
+        return !this.ended && !this.socket.destroyed;
+    }
+    async close() {
+        if (this.ended)
+            return;
+        await new Promise((resolve) => {
+            this.socket.once("close", resolve);
+            this.socket.destroy();
+        });
+    }
+    async release() {
+        if (this.ended)
+            return;
+        await this.call("client_close", {});
+        await this.close();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/bot/broker/transport.js.map

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

package/dist/bot/browser-process-owner.d.ts

@@ -0,0 +1,75 @@
+import type { BrowserContext } from "playwright";
+import { type ProfileCloseState } from "./profile.js";
+import { type StealthProfile } from "./browser-process-runtime.js";
+import type { PageDriver } from "./page-driver.js";
+/** Exclusive Chrome custody. Page setup is awaited at the original startup boundary. */
+export declare class BrowserProcessOwner {
+    private readonly pages;
+    private readonly initializePages;
+    context: BrowserContext | null;
+    private childChrome;
+    private childChromeIdentity;
+    private childChromeProcessGroup;
+    private ownedDisplayRig;
+    private ownedChromeProcessTreeProof;
+    private operatorProcessMarker;
+    private ownerLaunchTracked;
+    private cdpBrowser;
+    private launchedContext;
+    private launchedProfileHolderIdentity;
+    private startPromise;
+    private closePromise;
+    private startCancellationRequested;
+    private startLaunchCommitted;
+    private startSettled;
+    private persistentFallbackLaunchInFlight;
+    private persistentFallbackOwnershipMonitor;
+    private persistentFallbackCancellationState;
+    private resolveStartCancellation;
+    private readonly startCancellation;
+    private cancelledStartReaper;
+    private launchedChannel;
+    private proxyServer;
+    private readonly profileDir;
+    private readonly proxyOverride;
+    launchedMode: "headed" | "headless" | "remote" | "unknown";
+    constructor(opts: {
+        profileDir?: string;
+        proxyUrl?: string;
+    }, pages: PageDriver, initializePages: (context: BrowserContext, hardened: boolean, remoteMode: boolean) => Promise<void>);
+    operatorBrowserMarker(): string;
+    private ownedHeadedBrowserEnvironment;
+    private teardownOwnedDisplay;
+    private adoptOwnedChromeProcessTree;
+    private signalCurrentSelfManagedChrome;
+    isConnected(): boolean;
+    get channel(): string | null;
+    get proxied(): string | null;
+    get stealthProfile(): StealthProfile;
+    get launchMode(): "headed" | "headless" | "remote" | "unknown";
+    private launchSelfManagedContext;
+    private cancelSpawnedSelfManagedChrome;
+    start(): Promise<void>;
+    private startOnce;
+    private throwIfStartCancelled;
+    private commitProfileLaunch;
+    private startBrowser;
+    private probeEgressGeo;
+    private resolveProxy;
+    close(options?: {
+        cancelStart?: boolean;
+    }): Promise<ProfileCloseState>;
+    waitForCancelledStartQuiescence(): Promise<void>;
+    forceCloseOwnedProcessTree(): Promise<ProfileCloseState>;
+    private closeCancelledStart;
+    private reapCancelledStartProcess;
+    private monitorCancelledStartProcess;
+    private currentOwnedProfileIdentity;
+    private waitForPersistentFallbackIdentity;
+    private requirePersistentFallbackOwnership;
+    private startPersistentFallbackOwnershipMonitor;
+    private waitForOwnedProfileExit;
+    private closeAfterStart;
+    private closeBrowser;
+}
+//# sourceMappingURL=browser-process-owner.d.ts.map

package/dist/bot/browser-process-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-process-owner.d.ts","sourceRoot":"","sources":["../../src/bot/browser-process-owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,YAAY,CAAC;AAI1D,OAAO,EAQL,KAAK,iBAAiB,EAEvB,MAAM,cAAc,CAAC;AAatB,OAAO,EAmCL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wFAAwF;AACxF,qBAAa,mBAAmB;IA4E5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe;IA3ElC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAQ;IAKtC,OAAO,CAAC,WAAW,CAA6B;IAEhD,OAAO,CAAC,mBAAmB,CAAuC;IAElE,OAAO,CAAC,uBAAuB,CAAS;IAExC,OAAO,CAAC,eAAe,CAA+B;IAEtD,OAAO,CAAC,2BAA2B,CAA4C;IAE/E,OAAO,CAAC,qBAAqB,CAAuB;IAEpD,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,UAAU,CAAwB;IAG1C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,6BAA6B,CAAuC;IAE5E,OAAO,CAAC,YAAY,CAA8B;IAElD,OAAO,CAAC,YAAY,CAA2C;IAE/D,OAAO,CAAC,0BAA0B,CAAS;IAE3C,OAAO,CAAC,oBAAoB,CAAS;IAErC,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,gCAAgC,CAAS;IAEjD,OAAO,CAAC,kCAAkC,CAA8B;IAExE,OAAO,CAAC,mCAAmC,CAAkC;IAE7E,OAAO,CAAC,wBAAwB,CAA6B;IAE7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAE/B;IAEH,OAAO,CAAC,oBAAoB,CAA8B;IAO1D,OAAO,CAAC,eAAe,CAAuB;IAM9C,OAAO,CAAC,WAAW,CAAuB;IAE1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAIpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAI9C,YAAY,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAa;gBAErE,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/B,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,KAChB,OAAO,CAAC,IAAI,CAAC;IAOpB,qBAAqB,IAAI,MAAM;YAKjB,6BAA6B;YAc7B,oBAAoB;IAQlC,OAAO,CAAC,2BAA2B;IAyBnC,OAAO,CAAC,8BAA8B;IAatC,WAAW,IAAI,OAAO;IAStB,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAK3B;IAKD,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAK3B;IAOD,IAAI,cAAc,IAAI,cAAc,CAKnC;IAED,IAAI,UAAU,IAAI,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAE7D;YAYa,wBAAwB;YA2IxB,8BAA8B;IAwBtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,SAAS;IAoBvB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,mBAAmB;YAKb,YAAY;YAyRZ,cAAc;YAkDd,YAAY;IAKpB,KAAK,CAAC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAU1E,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC;IAShD,0BAA0B,IAAI,OAAO,CAAC,iBAAiB,CAAC;YAkChD,mBAAmB;YAYnB,yBAAyB;YAKzB,4BAA4B;IAc1C,OAAO,CAAC,2BAA2B;YAgBrB,iCAAiC;YAgBjC,kCAAkC;IAgBhD,OAAO,CAAC,uCAAuC;YA0BjC,uBAAuB;YA8BvB,eAAe;YAQf,YAAY;CAsH3B"}