@moxxy/plugin-browser 0.27.0

package/dist/browser-surface.js

@@ -0,0 +1,255 @@
+import { defineSurface } from '@moxxy/sdk';
+import { browserSidecarCall, closeBrowserSidecar, resolveBrowserInstallRoot, sidecarErrorKind, } from './browser-session.js';
+import { installPlaywrightPackage } from './sidecar/install.js';
+/**
+ * The `browser` surface: a live, in-window view of the SAME Playwright page the
+ * `browser_session` tool drives. We "stream" the page by polling a JPEG frame
+ * (`frame` sidecar method) a few times a second and forwarding it as a
+ * `surface.data` payload; the user's clicks/keys/scroll/navigate are proxied
+ * back onto the page via the sidecar's coordinate-based input methods. So the
+ * agent and the user operate ONE shared page — agent navigations show up in the
+ * pane, and the user can take over.
+ *
+ * Why polling and not a CDP `Page.startScreencast` push: the screencast only
+ * emits on visual change, so a freshly-opened (blank / static / headless) page
+ * produces no frames at all — the pane sat on "Loading…" forever with the
+ * underlying error swallowed. A screenshot poll always yields a frame (even a
+ * blank one), so the view comes up reliably and a real launch/install failure
+ * surfaces as a status line instead of an indefinite spinner. Polling rides the
+ * existing sidecar RPC surface and works on every Playwright browser, not just
+ * Chromium.
+ */
+const FRAME_INTERVAL_MS = 300;
+/** Consecutive `frame` failures (with no frame ever seen) before we stop
+ *  assuming "still launching" and show the error. ~6 × 300ms ≈ 1.8s grace. */
+const FAIL_GRACE = 6;
+/** Validate a sidecar `frame` reply before emitting it: a partial / altered
+ *  reply must be treated as a failed tick (so FAIL_GRACE eventually surfaces a
+ *  status) rather than streamed to subscribers as `{base64: undefined, …}`. */
+function isFrame(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const f = v;
+    return typeof f.base64 === 'string' && typeof f.mediaType === 'string' && typeof f.url === 'string';
+}
+export function buildBrowserSurface(deps) {
+    return defineSurface({
+        kind: 'browser',
+        description: "A live view of the agent's browser; click, type, and navigate.",
+        open: () => {
+            const dataSubs = new Set();
+            let last = null;
+            let timer = null;
+            let inFlight = false;
+            let fails = 0;
+            // Set once we detect the `playwright` npm package isn't installed. Polling
+            // pauses (no point retrying an import that will keep failing) and the pane
+            // shows an Install affordance; an `install` input clears it.
+            let needsInstall = false;
+            let installing = false;
+            const emit = (payload) => {
+                for (const cb of dataSubs)
+                    cb(payload);
+            };
+            const stopPolling = () => {
+                if (timer)
+                    clearInterval(timer);
+                timer = null;
+            };
+            const startPolling = () => {
+                if (timer)
+                    return;
+                void tick();
+                timer = setInterval(() => void tick(), FRAME_INTERVAL_MS);
+            };
+            const tick = async () => {
+                if (inFlight || needsInstall || installing)
+                    return; // don't pile up / retry a known-missing dep
+                inFlight = true;
+                try {
+                    const reply = await browserSidecarCall('frame', {}, deps);
+                    if (!isFrame(reply))
+                        throw new Error('malformed frame reply from sidecar');
+                    last = reply;
+                    fails = 0;
+                    emit({ type: 'frame', base64: reply.base64, mime: reply.mediaType, url: reply.url });
+                }
+                catch (err) {
+                    // The `playwright` npm package is simply absent — recoverable. Pause
+                    // polling and ask the user (the download is ~200MB) rather than spin on
+                    // a failing import or dump a raw "not installed" error.
+                    if (sidecarErrorKind(err) === 'needs-install') {
+                        needsInstall = true;
+                        stopPolling();
+                        emit({
+                            type: 'status',
+                            needsInstall: true,
+                            text: 'The browser engine (Playwright) is not installed. It is a one-time ~200MB download.',
+                        });
+                        return;
+                    }
+                    // The first failures are usually the browser still launching (or a
+                    // one-time binary install). Only surface a hard error once it's
+                    // clearly not transient, so the user isn't left on a silent spinner.
+                    // Fire EXACTLY on the FAIL_GRACE-th consecutive failure (a successful
+                    // frame resets `fails` to 0), so the status is emitted once per
+                    // failure streak rather than every tick. We surface it whether or not
+                    // a prior frame exists: with no frame yet the page never came up;
+                    // with a prior frame the page later died and the pane would otherwise
+                    // sit frozen on a stale screenshot with no hint the live view is dead.
+                    if (++fails === FAIL_GRACE) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        emit({
+                            type: 'status',
+                            text: last ? `Browser disconnected: ${message}` : `Browser unavailable: ${message}`,
+                        });
+                    }
+                }
+                finally {
+                    inFlight = false;
+                }
+            };
+            // After an interaction, grab a frame now and once more shortly after, so a
+            // click/keypress that kicks off async work (a navigation, a menu opening,
+            // an animation) shows up promptly instead of waiting for the next poll.
+            const bump = () => {
+                void tick();
+                setTimeout(() => void tick(), 140);
+            };
+            // Kick an immediate frame (launches the browser), then poll.
+            startPolling();
+            const runInstall = async () => {
+                if (installing)
+                    return;
+                installing = true;
+                stopPolling();
+                emit({ type: 'status', text: 'Installing browser engine… (one-time, ~200MB)' });
+                try {
+                    await installPlaywrightPackage({
+                        rootDir: resolveBrowserInstallRoot(deps),
+                        onProgress: (line) => emit({ type: 'status', text: line }),
+                    });
+                    // The sidecar cached its failed `import('playwright')`; drop it so the
+                    // next frame call respawns a fresh sidecar that imports the now-present
+                    // package.
+                    await closeBrowserSidecar();
+                    needsInstall = false;
+                    fails = 0;
+                    emit({ type: 'status', text: 'Installed. Starting browser…' });
+                    startPolling();
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    emit({ type: 'status', needsInstall: true, text: `Install failed: ${message}` });
+                }
+                finally {
+                    installing = false;
+                }
+            };
+            return {
+                id: 'browser',
+                kind: 'browser',
+                onData: (cb) => {
+                    dataSubs.add(cb);
+                    return () => dataSubs.delete(cb);
+                },
+                snapshot: () => needsInstall
+                    ? {
+                        type: 'status',
+                        needsInstall: true,
+                        text: 'The browser engine (Playwright) is not installed. It is a one-time ~200MB download.',
+                    }
+                    : last
+                        ? { type: 'frame', base64: last.base64, mime: last.mediaType, url: last.url }
+                        : { type: 'status', text: 'Starting browser…' },
+                resize: async (size) => {
+                    // Match the page viewport to the pane so the live view fills the
+                    // container (no letterboxing) and click coords map 1:1.
+                    if (!size.width || !size.height)
+                        return;
+                    await browserSidecarCall('setviewport', { width: size.width, height: size.height }, deps).catch(() => undefined);
+                    void tick();
+                },
+                input: async (msg) => {
+                    if (msg.type === 'install') {
+                        await runInstall();
+                        return;
+                    }
+                    const vw = last?.width ?? 1280;
+                    const vh = last?.height ?? 720;
+                    if (msg.type === 'navigate' && typeof msg.url === 'string') {
+                        // The sidecar's goto re-runs the SSRF guard (loopback/private/
+                        // metadata blocked), so a hostile URL never navigates. Unlike the
+                        // pointer/key proxies below, a navigate rejection is user-meaningful
+                        // (bad URL format, SSRF block) — surface it as a status line instead
+                        // of swallowing it, so the user knows why the address bar did nothing.
+                        try {
+                            await browserSidecarCall('goto', { url: msg.url }, deps);
+                        }
+                        catch (err) {
+                            const text = err instanceof Error ? err.message : String(err);
+                            emit({ type: 'status', text });
+                        }
+                        bump();
+                    }
+                    else if ((msg.type === 'click' || msg.type === 'dblclick') &&
+                        typeof msg.fx === 'number' &&
+                        typeof msg.fy === 'number') {
+                        const count = msg.type === 'dblclick' ? 2 : 1;
+                        await browserSidecarCall('mouse', { x: msg.fx * vw, y: msg.fy * vh, count }, deps).catch(() => undefined);
+                        bump();
+                    }
+                    else if (msg.type === 'move' && typeof msg.fx === 'number' && typeof msg.fy === 'number') {
+                        // Hover — drive the pointer so :hover styles/tooltips render. A single
+                        // follow-up frame (not a bump) keeps the cost down at move frequency.
+                        await browserSidecarCall('mousemove', { x: msg.fx * vw, y: msg.fy * vh }, deps).catch(() => undefined);
+                        void tick();
+                    }
+                    else if (msg.type === 'capture' &&
+                        typeof msg.fx === 'number' &&
+                        typeof msg.fy === 'number' &&
+                        typeof msg.fw === 'number' &&
+                        typeof msg.fh === 'number') {
+                        // Sharp PNG of the dragged region → handed back to the pane, which
+                        // attaches it to the chat composer (the user then describes the change).
+                        const shot = (await browserSidecarCall('capture', { x: msg.fx * vw, y: msg.fy * vh, width: msg.fw * vw, height: msg.fh * vh }, deps).catch(() => null));
+                        // Validate before emitting so a partial/altered reply doesn't hand
+                        // the composer a {base64: undefined} attachment.
+                        if (shot &&
+                            typeof shot === 'object' &&
+                            typeof shot.base64 === 'string' &&
+                            typeof shot.mediaType === 'string') {
+                            const s = shot;
+                            emit({ type: 'captured', base64: s.base64, mediaType: s.mediaType });
+                        }
+                    }
+                    else if (msg.type === 'zoom' && typeof msg.factor === 'number') {
+                        await browserSidecarCall('zoom', { factor: msg.factor }, deps).catch(() => undefined);
+                        bump();
+                    }
+                    else if (msg.type === 'key' && typeof msg.key === 'string') {
+                        await browserSidecarCall('key', { key: msg.key }, deps).catch(() => undefined);
+                        bump();
+                    }
+                    else if (msg.type === 'scroll' && typeof msg.dy === 'number') {
+                        await browserSidecarCall('scroll', { dy: msg.dy }, deps).catch(() => undefined);
+                        bump();
+                    }
+                    else if (msg.type === 'back' || msg.type === 'forward' || msg.type === 'reload') {
+                        await browserSidecarCall(msg.type, {}, deps).catch(() => undefined);
+                        bump();
+                    }
+                },
+                close: () => {
+                    if (timer)
+                        clearInterval(timer);
+                    timer = null;
+                    dataSubs.clear();
+                    // The underlying page stays alive for the agent's browser_session tool;
+                    // it's torn down on session shutdown (closeBrowserSidecar).
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=browser-surface.js.map

package/dist/browser-surface.js.map

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

package/dist/html-extract.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Minimal HTML → text / markdown extractors used by `web_fetch`. Not a
+ * full DOM parser: regex-based, intentionally limited. For stricter
+ * extraction use the markdown converter with a selector or upgrade to
+ * browser_session.
+ */
+export interface ExtractOptions {
+    selector?: string;
+}
+/**
+ * Minimal HTML → plain text. Strips <script>, <style>, comments, and tags.
+ * Collapses whitespace. Decodes the common HTML entities.
+ */
+export declare function htmlToPlainText(html: string, opts?: ExtractOptions): string;
+/**
+ * Minimal HTML → markdown. Maps headings, lists, links, code blocks, and
+ * paragraphs. Falls through to plain-text rules for unknown structure.
+ */
+export declare function htmlToMarkdown(html: string, opts?: ExtractOptions): string;
+//# sourceMappingURL=html-extract.d.ts.map

package/dist/html-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-extract.d.ts","sourceRoot":"","sources":["../src/html-extract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CAU/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CAwC9E"}

package/dist/html-extract.js

@@ -0,0 +1,122 @@
+/**
+ * Minimal HTML → text / markdown extractors used by `web_fetch`. Not a
+ * full DOM parser: regex-based, intentionally limited. For stricter
+ * extraction use the markdown converter with a selector or upgrade to
+ * browser_session.
+ */
+const COMMENT_RE = /<!--[\s\S]*?-->/g;
+const SCRIPT_RE = /<script\b[^>]*>[\s\S]*?<\/script>/gi;
+const STYLE_RE = /<style\b[^>]*>[\s\S]*?<\/style>/gi;
+/**
+ * Hard ceiling on the HTML fed to the regex extractors. web_fetch caps the raw
+ * body at up to 20MB (maxBytes), but the lazy `[\s\S]*?` passes here run
+ * SYNCHRONOUSLY on the runner event loop — a multi-MB adversarial page with
+ * many unmatched open tags could block it. Truncating to a generous 4MB bounds
+ * that worst case while still covering virtually every real article.
+ */
+const MAX_EXTRACT_INPUT = 4 * 1024 * 1024;
+/** Bound the regex-extractor input so a hostile, oversized page can't stall the
+ *  event loop. Cuts at a tag boundary when one is near the limit to avoid
+ *  splitting an entity/tag mid-token. */
+function capInput(html) {
+    if (html.length <= MAX_EXTRACT_INPUT)
+        return html;
+    const slice = html.slice(0, MAX_EXTRACT_INPUT);
+    const lastLt = slice.lastIndexOf('<');
+    return lastLt > MAX_EXTRACT_INPUT - 1024 ? slice.slice(0, lastLt) : slice;
+}
+/**
+ * Minimal HTML → plain text. Strips <script>, <style>, comments, and tags.
+ * Collapses whitespace. Decodes the common HTML entities.
+ */
+export function htmlToPlainText(html, opts = {}) {
+    let body = sliceBySelector(capInput(html), opts.selector);
+    body = body.replace(COMMENT_RE, '');
+    body = body.replace(SCRIPT_RE, '');
+    body = body.replace(STYLE_RE, '');
+    body = body.replace(/<br\b[^>]*>/gi, '\n');
+    body = body.replace(/<\/(p|div|li|tr|h[1-6])>/gi, '\n');
+    body = body.replace(/<[^>]+>/g, '');
+    body = decodeEntities(body);
+    return collapseWhitespace(body);
+}
+/**
+ * Minimal HTML → markdown. Maps headings, lists, links, code blocks, and
+ * paragraphs. Falls through to plain-text rules for unknown structure.
+ */
+export function htmlToMarkdown(html, opts = {}) {
+    let body = sliceBySelector(capInput(html), opts.selector);
+    body = body.replace(COMMENT_RE, '');
+    body = body.replace(SCRIPT_RE, '');
+    body = body.replace(STYLE_RE, '');
+    // headings
+    body = body.replace(/<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1>/gi, (_, lvl, inner) => `\n\n${'#'.repeat(Number(lvl))} ${stripTags(inner).trim()}\n\n`);
+    // links: keep text + url. Accept double-quoted, single-quoted, and unquoted
+    // hrefs — real-world HTML uses all three, and matching only "double" silently
+    // dropped the URL (the link text survived via the later tag-strip).
+    body = body.replace(/<a\b[^>]*\bhref=(?:"([^"]+)"|'([^']+)'|([^\s>]+))[^>]*>([\s\S]*?)<\/a>/gi, (_, dq, sq, uq, inner) => `[${stripTags(inner).trim()}](${dq ?? sq ?? uq})`);
+    // code
+    body = body.replace(/<pre\b[^>]*>([\s\S]*?)<\/pre>/gi, (_, inner) => `\n\n\`\`\`\n${stripTags(inner)}\n\`\`\`\n\n`);
+    body = body.replace(/<code\b[^>]*>([\s\S]*?)<\/code>/gi, (_, inner) => `\`${stripTags(inner)}\``);
+    // lists
+    body = body.replace(/<li\b[^>]*>([\s\S]*?)<\/li>/gi, (_, inner) => `\n- ${stripTags(inner).trim()}`);
+    body = body.replace(/<\/?(ul|ol)\b[^>]*>/gi, '\n');
+    // line breaks
+    body = body.replace(/<br\b[^>]*>/gi, '\n');
+    body = body.replace(/<\/?p\b[^>]*>/gi, '\n\n');
+    body = body.replace(/<[^>]+>/g, '');
+    body = decodeEntities(body);
+    return collapseWhitespace(body);
+}
+function sliceBySelector(html, selector) {
+    if (!selector)
+        return html;
+    const slice = extractFirstTagBlock(html, selector);
+    return slice ?? html;
+}
+function collapseWhitespace(s) {
+    return s.replace(/[ \t]+/g, ' ').replace(/\n[ \t]+/g, '\n').replace(/\n{3,}/g, '\n\n').trim();
+}
+function stripTags(s) {
+    return s.replace(/<[^>]+>/g, '');
+}
+function decodeEntities(s) {
+    const map = {
+        '&amp;': '&',
+        '&lt;': '<',
+        '&gt;': '>',
+        '&quot;': '"',
+        '&#39;': "'",
+        '&apos;': "'",
+        '&nbsp;': ' ',
+    };
+    return s.replace(/&[a-zA-Z]+;|&#\d+;/g, (m) => {
+        if (m in map)
+            return map[m];
+        const numMatch = /^&#(\d+);$/.exec(m);
+        if (numMatch)
+            return String.fromCharCode(Number(numMatch[1]));
+        return m;
+    });
+}
+/**
+ * Pull the first <tag>...</tag> block (or self-closing tag with id="x") whose
+ * tag name OR id matches `selector`. Very limited — supports `tagName` and
+ * `#id` only. For richer querying upgrade to browser_session.
+ */
+function extractFirstTagBlock(html, selector) {
+    if (selector.startsWith('#')) {
+        const id = selector.slice(1);
+        const re = new RegExp(`<([a-z][a-z0-9-]*)\\b[^>]*\\bid=["']${escapeReSelector(id)}["'][^>]*>([\\s\\S]*?)<\\/\\1>`, 'i');
+        const match = re.exec(html);
+        return match ? match[2] : null;
+    }
+    const tag = selector.toLowerCase();
+    const re = new RegExp(`<${tag}\\b[^>]*>([\\s\\S]*?)<\\/${tag}>`, 'i');
+    const match = re.exec(html);
+    return match ? match[1] : null;
+}
+function escapeReSelector(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=html-extract.js.map

package/dist/html-extract.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { type BrowserSessionDeps } from './browser-session.js';
+export { webFetchTool, htmlToPlainText, htmlToMarkdown } from './web-fetch.js';
+export { buildBrowserSessionTool, browserSidecarCall, closeBrowserSidecar, type BrowserSessionDeps, type SidecarStream, } from './browser-session.js';
+export { buildBrowserSurface } from './browser-surface.js';
+export interface BuildBrowserPluginOptions extends BrowserSessionDeps {
+}
+export declare function buildBrowserPlugin(opts?: BuildBrowserPluginOptions): import("@moxxy/sdk").Plugin;
+export declare const browserPlugin: import("@moxxy/sdk").Plugin;
+export default browserPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgD,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG7G,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;CAAG;AAExE,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,yBAA8B,+BAatE;AAED,eAAO,MAAM,aAAa,6BAAuB,CAAC;AAElD,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { definePlugin } from '@moxxy/sdk';
+import { webFetchTool } from './web-fetch.js';
+import { buildBrowserSessionTool, closeBrowserSidecar } from './browser-session.js';
+import { buildBrowserSurface } from './browser-surface.js';
+export { webFetchTool, htmlToPlainText, htmlToMarkdown } from './web-fetch.js';
+export { buildBrowserSessionTool, browserSidecarCall, closeBrowserSidecar, } from './browser-session.js';
+export { buildBrowserSurface } from './browser-surface.js';
+export function buildBrowserPlugin(opts = {}) {
+    return definePlugin({
+        name: '@moxxy/plugin-browser',
+        version: '0.0.0',
+        tools: [webFetchTool, buildBrowserSessionTool(opts)],
+        surfaces: [buildBrowserSurface(opts)],
+        hooks: {
+            onShutdown: async () => {
+                // Make sure the sidecar process exits with the session.
+                await closeBrowserSidecar();
+            },
+        },
+    });
+}
+export const browserPlugin = buildBrowserPlugin();
+export default browserPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAA2B,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,UAAU,kBAAkB,CAAC,OAAkC,EAAE;IACrE,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,CAAC,YAAY,EAAE,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACpD,QAAQ,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACrC,KAAK,EAAE;YACL,UAAU,EAAE,KAAK,IAAI,EAAE;gBACrB,wDAAwD;gBACxD,MAAM,mBAAmB,EAAE,CAAC;YAC9B,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,EAAE,CAAC;AAElD,eAAe,aAAa,CAAC"}

package/dist/sidecar/dispatch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON-RPC dispatch table for the sidecar. Each `method` here corresponds
+ * one-to-one with the wire-format methods documented in `sidecar.ts`.
+ */
+import { type PlaywrightHandle, type Reply, type Req } from './types.js';
+export interface SidecarState {
+    handle: PlaywrightHandle | null;
+    /**
+     * Set after a successful auto-install of browser binaries so the next
+     * tool result can carry a `notice` letting the user/model know the
+     * one-time download happened. Cleared once the notice has been
+     * delivered (handed to the reply once, then forgotten).
+     */
+    pendingInstallNotice: string | null;
+}
+export declare function teardown(state: SidecarState): Promise<void>;
+export declare function dispatch(state: SidecarState, req: Req): Promise<Reply>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/sidecar/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/sidecar/dispatch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,GAAG,EACT,MAAM,YAAY,CAAC;AAepB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAgBD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAU5E"}