@rubytech/create-siteoffice-code 0.1.256

package/payload/platform/plugins/browser/mcp/dist/lib/cdp-session.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Shared Chrome DevTools Protocol primitives for the browser plugin.
+ *
+ * The brand's VNC Chromium is launched by platform/scripts/vnc.sh with
+ * `--remote-debugging-port=${CDP_PORT}`, so CDP listens on 127.0.0.1:<port>.
+ * Everything here attaches to that running browser — it never launches its own.
+ *
+ * Two consumers share these primitives:
+ *   - cdp-render.ts  → stateless one-shot render (create target, read DOM, close).
+ *   - cdp-actions.ts → interactive automation driven through a persistent
+ *                      BrowserSession that keeps one target + websocket alive
+ *                      across tool calls.
+ *
+ * `fetch` and `WebSocket` are injected (CdpDeps) so unit tests drive every
+ * branch without a real browser; production passes the Node 22 globals.
+ */
+/** Minimal structural shape of the browser-style WebSocket this module uses.
+ *  Both the Node 22 global and the test fake satisfy it. */
+export interface MinimalWebSocket {
+    send(data: string): void;
+    close(): void;
+    addEventListener(type: "open", listener: () => void): void;
+    addEventListener(type: "message", listener: (ev: {
+        data: unknown;
+    }) => void): void;
+    addEventListener(type: "error", listener: (ev: unknown) => void): void;
+    addEventListener(type: "close", listener: () => void): void;
+}
+export type WebSocketCtor = new (url: string) => MinimalWebSocket;
+export interface CdpDeps {
+    fetchImpl: typeof fetch;
+    /** The Node 22 global `WebSocket`, or undefined on a runtime that lacks it. */
+    WebSocketImpl: WebSocketCtor | undefined;
+    cdpHost: string;
+    cdpPort: number;
+    log: (line: string) => void;
+}
+export declare const DEFAULT_LOAD_TIMEOUT_MS = 30000;
+export declare const DEFAULT_COMMAND_TIMEOUT_MS = 15000;
+/** Transport-level outcomes shared by every CDP operation. The action layer
+ *  adds its own operation-specific outcomes (selector-not-found, etc.). */
+export type CdpOutcome = "ok" | "cdp-unreachable" | "websocket-unavailable" | "navigate-failed" | "load-timeout" | "evaluate-failed" | "command-timeout" | "session-lost" | "error";
+export interface CdpTarget {
+    id: string;
+    webSocketDebuggerUrl: string;
+}
+/** Create a blank target via the CDP HTTP surface. Maps every transport
+ *  failure to a structured outcome rather than throwing. */
+export declare function createTarget(deps: CdpDeps, timeoutMs: number): Promise<{
+    target: CdpTarget;
+} | {
+    outcome: CdpOutcome;
+    detail: string;
+}>;
+/** Best-effort target close. Failure is logged, never surfaced as an outcome. */
+export declare function closeTarget(deps: CdpDeps, targetId: string): Promise<void>;
+/** List the open page targets via the CDP HTTP surface. */
+export declare function listTargets(deps: CdpDeps, timeoutMs: number): Promise<{
+    targets: Array<CdpTarget & {
+        url?: string;
+        title?: string;
+        type?: string;
+    }>;
+} | {
+    outcome: CdpOutcome;
+    detail: string;
+}>;
+/**
+ * Drives one CDP WebSocket session: correlates command ids to results, resolves
+ * one-shot events (waitForEvent), and fans persistent events out to subscribers
+ * (subscribe) — the latter is what console buffering and dialog handling need.
+ *
+ *   ws message ──▶ has id? ──yes──▶ resolve/reject pending command
+ *                    │no
+ *                    ▼
+ *               has method? ──▶ one-shot waiter (consume) + every subscriber
+ */
+export declare class CdpSession {
+    private readonly ws;
+    private nextId;
+    private readonly pending;
+    private readonly eventWaiters;
+    private readonly subscribers;
+    private closed;
+    constructor(ws: MinimalWebSocket);
+    isClosed(): boolean;
+    private onMessage;
+    command(method: string, params: Record<string, unknown>, timeoutMs: number): Promise<unknown>;
+    waitForEvent(method: string, timeoutMs: number): Promise<void>;
+    /** Persistent subscription to a CDP event. Returns an unsubscribe function. */
+    subscribe(method: string, handler: (params: unknown) => void): () => void;
+}
+export declare function openSocket(WebSocketImpl: WebSocketCtor, url: string, timeoutMs: number): Promise<{
+    ws: MinimalWebSocket;
+} | {
+    error: string;
+}>;
+/** What the dialog listener should do with the next javascript dialog. */
+export interface DialogPolicy {
+    accept: boolean;
+    promptText?: string;
+}
+/**
+ * A single live page driven across many tool calls.
+ *
+ * Lifecycle:
+ *   attach()  → create target, open ws, Page.enable + Runtime.enable, wire the
+ *               console ring buffer and the dialog auto-responder.
+ *   ensure()  → return the live session, or null if the page died (ws closed:
+ *               operator closed the tab, page crashed, browser restarted).
+ *   close()   → close the target and drop all state.
+ *
+ * The action layer treats a null ensure() as "session-lost" and tells the agent
+ * to navigate again — only navigate() re-attaches, so a dead page is never
+ * silently replaced by a blank one mid-action.
+ */
+export declare class BrowserSession {
+    private readonly deps;
+    private target;
+    private ws;
+    private session;
+    private readonly consoleRing;
+    private dialogPolicy;
+    private lastDialogUnhandled;
+    constructor(deps: CdpDeps);
+    /** The live session if the page is still alive, else null. */
+    ensure(): CdpSession | null;
+    /** Drop our handle on the current page (close the websocket) without closing
+     *  the target itself — used when switching the active page to another tab so
+     *  the previous tab stays open. */
+    private detachWs;
+    currentTargetId(): string | null;
+    setDialogPolicy(policy: DialogPolicy | null): void;
+    /** Drain the console ring buffer (returns and clears). */
+    drainConsole(): string[];
+    /** True (and resets) if a dialog fired with no policy armed. */
+    takeUnhandledDialogFlag(): boolean;
+    /**
+     * Attach a fresh target and wire console + dialog handling.
+     * Pass an existing target (from the tabs tool) to adopt it instead of creating one.
+     */
+    attach(commandTimeoutMs: number, existing?: CdpTarget): Promise<{
+        session: CdpSession;
+    } | {
+        outcome: CdpOutcome;
+        detail: string;
+    }>;
+    close(commandTimeoutMs: number): Promise<void>;
+    private recordConsole;
+    private recordException;
+    private push;
+}
+//# sourceMappingURL=cdp-session.d.ts.map

package/payload/platform/plugins/browser/mcp/dist/lib/cdp-session.d.ts.map

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

package/payload/platform/plugins/browser/mcp/dist/lib/cdp-session.js

@@ -0,0 +1,401 @@
+/**
+ * Shared Chrome DevTools Protocol primitives for the browser plugin.
+ *
+ * The brand's VNC Chromium is launched by platform/scripts/vnc.sh with
+ * `--remote-debugging-port=${CDP_PORT}`, so CDP listens on 127.0.0.1:<port>.
+ * Everything here attaches to that running browser — it never launches its own.
+ *
+ * Two consumers share these primitives:
+ *   - cdp-render.ts  → stateless one-shot render (create target, read DOM, close).
+ *   - cdp-actions.ts → interactive automation driven through a persistent
+ *                      BrowserSession that keeps one target + websocket alive
+ *                      across tool calls.
+ *
+ * `fetch` and `WebSocket` are injected (CdpDeps) so unit tests drive every
+ * branch without a real browser; production passes the Node 22 globals.
+ */
+export const DEFAULT_LOAD_TIMEOUT_MS = 30_000;
+export const DEFAULT_COMMAND_TIMEOUT_MS = 15_000;
+/** Create a blank target via the CDP HTTP surface. Maps every transport
+ *  failure to a structured outcome rather than throwing. */
+export async function createTarget(deps, timeoutMs) {
+    const endpoint = `http://${deps.cdpHost}:${deps.cdpPort}/json/new`;
+    let res;
+    try {
+        res = await deps.fetchImpl(endpoint, { method: "PUT", signal: AbortSignal.timeout(timeoutMs) });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("ENOTFOUND")) {
+            return { outcome: "cdp-unreachable", detail: msg };
+        }
+        return { outcome: "error", detail: msg };
+    }
+    if (!res.ok) {
+        const body = await res.text().catch(() => "<unreadable>");
+        return { outcome: "error", detail: `CDP /json/new returned ${res.status}: ${body.slice(0, 200)}` };
+    }
+    let parsed;
+    try {
+        parsed = (await res.json());
+    }
+    catch (err) {
+        return { outcome: "error", detail: `CDP /json/new response not JSON: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (!parsed.id || !parsed.webSocketDebuggerUrl) {
+        return { outcome: "error", detail: `CDP /json/new missing id/webSocketDebuggerUrl: ${JSON.stringify(parsed).slice(0, 200)}` };
+    }
+    return { target: { id: parsed.id, webSocketDebuggerUrl: parsed.webSocketDebuggerUrl } };
+}
+/** Best-effort target close. Failure is logged, never surfaced as an outcome. */
+export async function closeTarget(deps, targetId) {
+    const endpoint = `http://${deps.cdpHost}:${deps.cdpPort}/json/close/${encodeURIComponent(targetId)}`;
+    try {
+        await deps.fetchImpl(endpoint, { method: "PUT", signal: AbortSignal.timeout(5_000) });
+    }
+    catch (err) {
+        deps.log(`[browser] target-close-failed id=${targetId} err=${JSON.stringify(err instanceof Error ? err.message : String(err))}`);
+    }
+}
+/** List the open page targets via the CDP HTTP surface. */
+export async function listTargets(deps, timeoutMs) {
+    const endpoint = `http://${deps.cdpHost}:${deps.cdpPort}/json/list`;
+    let res;
+    try {
+        res = await deps.fetchImpl(endpoint, { method: "GET", signal: AbortSignal.timeout(timeoutMs) });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("ENOTFOUND")) {
+            return { outcome: "cdp-unreachable", detail: msg };
+        }
+        return { outcome: "error", detail: msg };
+    }
+    if (!res.ok) {
+        const body = await res.text().catch(() => "<unreadable>");
+        return { outcome: "error", detail: `CDP /json/list returned ${res.status}: ${body.slice(0, 200)}` };
+    }
+    let parsed;
+    try {
+        parsed = await res.json();
+    }
+    catch (err) {
+        return { outcome: "error", detail: `CDP /json/list response not JSON: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (!Array.isArray(parsed)) {
+        return { outcome: "error", detail: `CDP /json/list not an array: ${JSON.stringify(parsed).slice(0, 200)}` };
+    }
+    const targets = parsed
+        .filter((t) => typeof t.id === "string" && typeof t.webSocketDebuggerUrl === "string")
+        .map((t) => ({
+        id: t.id,
+        webSocketDebuggerUrl: t.webSocketDebuggerUrl,
+        url: typeof t.url === "string" ? t.url : undefined,
+        title: typeof t.title === "string" ? t.title : undefined,
+        type: typeof t.type === "string" ? t.type : undefined,
+    }));
+    return { targets };
+}
+/**
+ * Drives one CDP WebSocket session: correlates command ids to results, resolves
+ * one-shot events (waitForEvent), and fans persistent events out to subscribers
+ * (subscribe) — the latter is what console buffering and dialog handling need.
+ *
+ *   ws message ──▶ has id? ──yes──▶ resolve/reject pending command
+ *                    │no
+ *                    ▼
+ *               has method? ──▶ one-shot waiter (consume) + every subscriber
+ */
+export class CdpSession {
+    ws;
+    nextId = 1;
+    pending = new Map();
+    eventWaiters = new Map();
+    subscribers = new Map();
+    closed = false;
+    constructor(ws) {
+        this.ws = ws;
+        ws.addEventListener("message", (ev) => this.onMessage(ev.data));
+        ws.addEventListener("close", () => {
+            this.closed = true;
+            for (const { reject } of this.pending.values())
+                reject(new Error("websocket closed"));
+            this.pending.clear();
+        });
+    }
+    isClosed() {
+        return this.closed;
+    }
+    onMessage(data) {
+        if (typeof data !== "string")
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (typeof msg.id === "number") {
+            const waiter = this.pending.get(msg.id);
+            if (!waiter)
+                return;
+            this.pending.delete(msg.id);
+            if (msg.error)
+                waiter.reject(new Error(msg.error.message ?? "CDP command error"));
+            else
+                waiter.resolve(msg.result);
+            return;
+        }
+        if (msg.method) {
+            const oneShot = this.eventWaiters.get(msg.method);
+            if (oneShot) {
+                this.eventWaiters.delete(msg.method);
+                oneShot(msg.params);
+            }
+            const subs = this.subscribers.get(msg.method);
+            if (subs)
+                for (const handler of subs)
+                    handler(msg.params);
+        }
+    }
+    command(method, params, timeoutMs) {
+        if (this.closed)
+            return Promise.reject(new Error("websocket closed"));
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`CDP ${method} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, {
+                resolve: (v) => { clearTimeout(timer); resolve(v); },
+                reject: (e) => { clearTimeout(timer); reject(e); },
+            });
+            this.ws.send(JSON.stringify({ id, method, params }));
+        });
+    }
+    waitForEvent(method, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.eventWaiters.delete(method);
+                reject(new Error(`event ${method} not received within ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.eventWaiters.set(method, () => { clearTimeout(timer); resolve(); });
+        });
+    }
+    /** Persistent subscription to a CDP event. Returns an unsubscribe function. */
+    subscribe(method, handler) {
+        let set = this.subscribers.get(method);
+        if (!set) {
+            set = new Set();
+            this.subscribers.set(method, set);
+        }
+        set.add(handler);
+        return () => {
+            const s = this.subscribers.get(method);
+            if (s)
+                s.delete(handler);
+        };
+    }
+}
+export function openSocket(WebSocketImpl, url, timeoutMs) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let ws;
+        try {
+            ws = new WebSocketImpl(url);
+        }
+        catch (err) {
+            resolve({ error: err instanceof Error ? err.message : String(err) });
+            return;
+        }
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                ws.close();
+            }
+            catch { /* ignore */ }
+            resolve({ error: `websocket open timed out after ${timeoutMs}ms` });
+        }, timeoutMs);
+        ws.addEventListener("open", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({ ws });
+        });
+        ws.addEventListener("error", (ev) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            const detail = ev && typeof ev === "object" && "message" in ev ? String(ev.message) : "websocket error";
+            resolve({ error: detail });
+        });
+    });
+}
+const CONSOLE_RING_CAP = 200;
+/**
+ * A single live page driven across many tool calls.
+ *
+ * Lifecycle:
+ *   attach()  → create target, open ws, Page.enable + Runtime.enable, wire the
+ *               console ring buffer and the dialog auto-responder.
+ *   ensure()  → return the live session, or null if the page died (ws closed:
+ *               operator closed the tab, page crashed, browser restarted).
+ *   close()   → close the target and drop all state.
+ *
+ * The action layer treats a null ensure() as "session-lost" and tells the agent
+ * to navigate again — only navigate() re-attaches, so a dead page is never
+ * silently replaced by a blank one mid-action.
+ */
+export class BrowserSession {
+    deps;
+    target = null;
+    ws = null;
+    session = null;
+    consoleRing = [];
+    dialogPolicy = null;
+    lastDialogUnhandled = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** The live session if the page is still alive, else null. */
+    ensure() {
+        if (this.session && !this.session.isClosed())
+            return this.session;
+        // Page died — drop references so the next attach starts clean.
+        this.session = null;
+        this.ws = null;
+        this.target = null;
+        return this.session;
+    }
+    /** Drop our handle on the current page (close the websocket) without closing
+     *  the target itself — used when switching the active page to another tab so
+     *  the previous tab stays open. */
+    detachWs() {
+        const ws = this.ws;
+        this.ws = null;
+        this.session = null;
+        this.target = null;
+        if (ws) {
+            try {
+                ws.close();
+            }
+            catch { /* ignore */ }
+        }
+    }
+    currentTargetId() {
+        return this.target?.id ?? null;
+    }
+    setDialogPolicy(policy) {
+        this.dialogPolicy = policy;
+    }
+    /** Drain the console ring buffer (returns and clears). */
+    drainConsole() {
+        const out = this.consoleRing.slice();
+        this.consoleRing.length = 0;
+        return out;
+    }
+    /** True (and resets) if a dialog fired with no policy armed. */
+    takeUnhandledDialogFlag() {
+        const v = this.lastDialogUnhandled;
+        this.lastDialogUnhandled = false;
+        return v;
+    }
+    /**
+     * Attach a fresh target and wire console + dialog handling.
+     * Pass an existing target (from the tabs tool) to adopt it instead of creating one.
+     */
+    async attach(commandTimeoutMs, existing) {
+        if (!this.deps.WebSocketImpl) {
+            return { outcome: "websocket-unavailable", detail: "global WebSocket is not available on this runtime (Node < 22.4)" };
+        }
+        if (!this.deps.cdpPort || Number.isNaN(this.deps.cdpPort)) {
+            return { outcome: "cdp-unreachable", detail: `CDP_PORT not set or invalid (got ${JSON.stringify(this.deps.cdpPort)})` };
+        }
+        // Release our handle on any current page, but leave its tab open — opening
+        // or switching to another tab must not destroy the one we were on.
+        this.detachWs();
+        let target = existing;
+        if (!target) {
+            const created = await createTarget(this.deps, commandTimeoutMs);
+            if ("outcome" in created)
+                return { outcome: created.outcome, detail: created.detail };
+            target = created.target;
+        }
+        const opened = await openSocket(this.deps.WebSocketImpl, target.webSocketDebuggerUrl, commandTimeoutMs);
+        if ("error" in opened) {
+            if (!existing)
+                await closeTarget(this.deps, target.id);
+            return { outcome: "cdp-unreachable", detail: `websocket connect failed: ${opened.error}` };
+        }
+        const session = new CdpSession(opened.ws);
+        try {
+            await session.command("Page.enable", {}, commandTimeoutMs);
+            await session.command("Runtime.enable", {}, commandTimeoutMs);
+        }
+        catch (err) {
+            try {
+                opened.ws.close();
+            }
+            catch { /* ignore */ }
+            if (!existing)
+                await closeTarget(this.deps, target.id);
+            return { outcome: "error", detail: `enable failed: ${err instanceof Error ? err.message : String(err)}` };
+        }
+        // Console + uncaught-error buffering, from attach onward.
+        session.subscribe("Runtime.consoleAPICalled", (params) => this.recordConsole(params));
+        session.subscribe("Runtime.exceptionThrown", (params) => this.recordException(params));
+        // Dialog auto-responder: apply the armed policy, or dismiss + flag.
+        session.subscribe("Page.javascriptDialogOpening", () => {
+            const policy = this.dialogPolicy ?? { accept: false };
+            if (!this.dialogPolicy)
+                this.lastDialogUnhandled = true;
+            session.command("Page.handleJavaScriptDialog", policy.promptText !== undefined
+                ? { accept: policy.accept, promptText: policy.promptText }
+                : { accept: policy.accept }, commandTimeoutMs).catch((err) => this.deps.log(`[browser] dialog-handle-failed err=${JSON.stringify(err instanceof Error ? err.message : String(err))}`));
+        });
+        this.target = target;
+        this.ws = opened.ws;
+        this.session = session;
+        return { session };
+    }
+    async close(commandTimeoutMs) {
+        const ws = this.ws;
+        const target = this.target;
+        this.ws = null;
+        this.session = null;
+        this.target = null;
+        if (ws) {
+            try {
+                ws.close();
+            }
+            catch { /* ignore */ }
+        }
+        if (target)
+            await closeTarget(this.deps, target.id);
+        void commandTimeoutMs;
+    }
+    recordConsole(params) {
+        const p = params;
+        const text = (p.args ?? [])
+            .map((a) => (a.value !== undefined ? String(a.value) : a.description ?? ""))
+            .join(" ");
+        this.push(`[${p.type ?? "log"}] ${text}`);
+    }
+    recordException(params) {
+        const p = params;
+        const text = p.exceptionDetails?.exception?.description ?? p.exceptionDetails?.text ?? "uncaught exception";
+        this.push(`[error] ${text}`);
+    }
+    push(line) {
+        this.consoleRing.push(line);
+        if (this.consoleRing.length > CONSOLE_RING_CAP)
+            this.consoleRing.shift();
+    }
+}
+//# sourceMappingURL=cdp-session.js.map

package/payload/platform/plugins/browser/mcp/dist/lib/cdp-session.js.map

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

package/payload/platform/plugins/browser/mcp/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@maxy/browser",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/payload/platform/plugins/business-assistant/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "business-assistant",
+  "description": "Business assistant for small businesses. Handles customer enquiries, appointment booking, quote formatting, invoice generation, and daily briefings. Responds instantly, triages by urgency, and never lets a message fall through the cracks.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  }
+}