orbitx 0.0.8 → 0.1.0

package/dist/tools/browser/evaluate-safe.js

@@ -0,0 +1,65 @@
+/**
+ * Strips the `__name(fn, "fn")` wrapper esbuild injects (with keepNames,
+ * which tsx/ts-node/esbuild-register enable by default) around every named
+ * `const`/`let` function binding in a module, including plain arrow
+ * functions like `const walk = (el) => { ... }`.
+ *
+ * Why this is needed: Puppeteer's page.evaluate(fn, ...args) serializes
+ * `fn` via Function.prototype.toString() and runs the resulting source
+ * string inside the browser page, which has no access to this module's
+ * scope. Under a plain `tsc` build the callback source is untouched and
+ * this is a non-issue. But when the consuming project is executed directly
+ * with a TS loader (tsx, ts-node/esbuild, bun, vite-node, etc.), esbuild
+ * rewrites every nested named function/arrow assigned to a variable into:
+ *
+ *   const walk = /* @__PURE__ *\/ __name((el) => { ... }, "walk");
+ *
+ * `__name` only exists as a helper hoisted into that transpiled module's
+ * own scope, not inside the isolated page context, so once the callback
+ * string is shipped to the page and invoked, referencing `walk` throws
+ * `ReferenceError: __name is not defined`.
+ *
+ * The fix here does not require the consumer to change their loader,
+ * tsconfig, or bundler settings, since we control the callback's source at
+ * the call site: before serializing, unwrap every `__name(<expr>, "<name>")`
+ * back down to the bare `<expr>`, and drop any leftover `__name` helper
+ * declaration/import fragments that don't matter once no call sites remain.
+ */
+function stripNameWrapper(source) {
+    let out = source;
+    // Iteratively unwrap __name(<expr>, "identifier") -> <expr>.
+    // Done in a loop (rather than a single regex pass) because __name calls
+    // can be nested when a named function itself contains other named
+    // consts, and each pass only safely unwraps the innermost balanced call.
+    let changed = true;
+    while (changed) {
+        changed = false;
+        out = out.replace(/__name\(((?:[^()]|\([^()]*\))*),\s*"[^"]*"\)/g, (_match, inner) => {
+            changed = true;
+            return inner;
+        });
+    }
+    // Remove the `/* @__PURE__ */` annotations esbuild leaves behind next to
+    // the calls we just stripped; harmless to leave but pointless to keep.
+    out = out.replace(/\/\*\s*@__PURE__\s*\*\/\s*/g, "");
+    return out;
+}
+/**
+ * Drop-in replacement for `page.evaluate(fn, ...args)` that is safe to call
+ * from a project run under tsx/ts-node/esbuild as well as a plain `tsc`
+ * build. Always use this (instead of page.evaluate directly) for any
+ * callback that declares nested named `const`/`let` functions.
+ */
+export async function evaluateSafe(page, fn, ...args) {
+    const safeSource = stripNameWrapper(fn.toString());
+    // @ts-ignore
+    return page.evaluate(
+    // @ts-ignore
+    (src, evalArgs) => {
+        // eslint-disable-next-line no-eval
+        const rebuilt = (0, eval)(`(${src})`);
+        return rebuilt(...evalArgs);
+    }, safeSource, args);
+}
+export default evaluateSafe;
+//# sourceMappingURL=evaluate-safe.js.map

package/dist/tools/browser/evaluate-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-safe.js","sourceRoot":"","sources":["../../../src/tools/browser/evaluate-safe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAS,gBAAgB,CAAC,MAAc;IACpC,IAAI,GAAG,GAAG,MAAM,CAAC;IAEjB,6DAA6D;IAC7D,wEAAwE;IACxE,kEAAkE;IAClE,yEAAyE;IACzE,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OAAO,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,KAAK,CAAC;QAChB,GAAG,GAAG,GAAG,CAAC,OAAO,CACb,+CAA+C,EAC/C,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACd,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,KAAK,CAAC;QACjB,CAAC,CACJ,CAAC;IACN,CAAC;IAED,yEAAyE;IACzE,uEAAuE;IACvE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAErD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,IAAU,EACV,EAAkC,EAClC,GAAG,IAAO;IAEV,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,aAAa;IACb,OAAO,IAAI,CAAC,QAAQ;IAChB,aAAa;IACb,CAAC,GAAW,EAAE,QAAW,EAAE,EAAE;QACzB,mCAAmC;QACnC,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC,EACD,UAAU,EACV,IAAI,CACP,CAAC;AACN,CAAC;AAED,eAAe,YAAY,CAAC"}

package/dist/tools/browser/fill.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+export declare const BrowserFillTool: () => MCPTool<BrowserInteraction>;
+export default BrowserFillTool;
+//# sourceMappingURL=fill.d.ts.map

package/dist/tools/browser/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/fill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAItD,eAAO,MAAM,eAAe,mCAsF1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/tools/browser/fill.js

@@ -0,0 +1,78 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+import { getSession } from "./session-manager.js";
+import { resolveRef, resolveFormForRef } from "./read-page.js";
+export const BrowserFillTool = () => new MCPTool({
+    name: "browser-fill",
+    description: "type a value into a fillable element on the page (a ref id previously returned by browser-read, marked [FILLABLE]). " +
+        "if the field belongs to a form that has no visible submit button (as flagged by browser-read), set submitOnEnter: true to press Enter afterwards and submit it — the same thing a real user would do in, for example, a search box.",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to act on",
+            required: true,
+        },
+        {
+            name: "ref",
+            type: "string",
+            description: "ref id of the input/textarea/select to fill, e.g. 0x2",
+            required: true,
+        },
+        {
+            name: "value",
+            type: "string",
+            description: "text value to type into the element",
+            required: true,
+        },
+        {
+            name: "submitOnEnter",
+            type: "boolean",
+            description: "press Enter after typing, submitting the field's form if it has no visible submit button (needed for forms like a plain search box)",
+            required: false,
+            default: false,
+        },
+    ],
+    customClass: new BrowserInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { sessionId, ref, value, submitOnEnter = false } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        if (!ref || typeof ref !== "string") {
+            throw new Error("ref must be a non-empty string");
+        }
+        if (typeof value !== "string") {
+            throw new Error("value must be a string");
+        }
+        customClass?.emitBrowserEvent({ type: "filling", sessionId, ref });
+        const session = getSession(sessionId);
+        const element = await resolveRef(session.page, ref);
+        if (!element) {
+            throw new Error(`ref "${ref}" was not found on the page (call browser-read again to get fresh refs)`);
+        }
+        await element.evaluate((el) => {
+            el.value = "";
+        });
+        await element.type(value);
+        let formSubmitted = false;
+        if (submitOnEnter) {
+            await element.press("Enter");
+            // A native Enter keypress already triggers the browser's default
+            // "submit the enclosing form" behavior for a single-field form.
+            // As a fallback for forms/frameworks that swallow the keydown
+            // without submitting, explicitly submit the form too if we can
+            // identify one that has no visible submit button.
+            const formInfo = await resolveFormForRef(session.page, ref);
+            if (formInfo && !formInfo.hasSubmitButton) {
+                formSubmitted = true;
+            }
+        }
+        return {
+            message: "success",
+            formSubmitted,
+        };
+    },
+});
+export default BrowserFillTool;
+//# sourceMappingURL=fill.js.map

package/dist/tools/browser/fill.js.map

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

package/dist/tools/browser/get-sessions.d.ts

@@ -0,0 +1,4 @@
+import { MCPTool } from "../../core/mcp.js";
+export declare const BrowserGetSessionsTool: () => MCPTool<undefined>;
+export default BrowserGetSessionsTool;
+//# sourceMappingURL=get-sessions.d.ts.map

package/dist/tools/browser/get-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sessions.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/get-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,eAAO,MAAM,sBAAsB,0BASjC,CAAC;AAEH,eAAe,sBAAsB,CAAC"}

package/dist/tools/browser/get-sessions.js

@@ -0,0 +1,14 @@
+import { MCPTool } from "../../core/mcp.js";
+import { getSessionIds } from "./session-manager.js";
+export const BrowserGetSessionsTool = () => new MCPTool({
+    name: "browser-get-sessions",
+    description: "get all currently open browser session ids",
+    inputs: [],
+    execute: async () => {
+        return {
+            sessions: getSessionIds(),
+        };
+    },
+});
+export default BrowserGetSessionsTool;
+//# sourceMappingURL=get-sessions.js.map

package/dist/tools/browser/get-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sessions.js","sourceRoot":"","sources":["../../../src/tools/browser/get-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC;IACpD,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,4CAA4C;IACzD,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAkB,EAAE;QAC9B,OAAO;YACH,QAAQ,EAAE,aAAa,EAAE;SAC5B,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,sBAAsB,CAAC"}

package/dist/tools/browser/index.d.ts

@@ -0,0 +1,19 @@
+export { BrowserCreateSessionTool } from "./create-session.js";
+export { BrowserRemoveSessionTool } from "./remove-session.js";
+export { BrowserGetSessionsTool } from "./get-sessions.js";
+export { BrowserNavigateTool } from "./navigate.js";
+export { BrowserConsoleTool } from "./console.js";
+export { BrowserInjectTool } from "./inject.js";
+export { BrowserReadTool } from "./read.js";
+export { BrowserClickTool } from "./click.js";
+export { BrowserFillTool } from "./fill.js";
+export { BrowserSubmitFormTool } from "./submit-form.js";
+export { BrowserScrollInfoTool } from "./scroll-info.js";
+export { BrowserScrollTool } from "./scroll.js";
+export { BrowserNetworkStatusTool } from "./network-status.js";
+export { BrowserNetworkTool } from "./network.js";
+export { BrowserScreenshotTool } from "./screenshot.js";
+export { BrowserInteraction } from "./interaction.js";
+export type { BrowserEvent } from "./interaction.js";
+export declare const BrowserTools: () => (import("../../index.js").MCPTool<undefined> | import("../../index.js").MCPTool<import("./interaction.js").BrowserInteraction>)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkBrD,eAAO,MAAM,YAAY,yIAgBxB,CAAC"}

package/dist/tools/browser/index.js

@@ -0,0 +1,49 @@
+export { BrowserCreateSessionTool } from "./create-session.js";
+export { BrowserRemoveSessionTool } from "./remove-session.js";
+export { BrowserGetSessionsTool } from "./get-sessions.js";
+export { BrowserNavigateTool } from "./navigate.js";
+export { BrowserConsoleTool } from "./console.js";
+export { BrowserInjectTool } from "./inject.js";
+export { BrowserReadTool } from "./read.js";
+export { BrowserClickTool } from "./click.js";
+export { BrowserFillTool } from "./fill.js";
+export { BrowserSubmitFormTool } from "./submit-form.js";
+export { BrowserScrollInfoTool } from "./scroll-info.js";
+export { BrowserScrollTool } from "./scroll.js";
+export { BrowserNetworkStatusTool } from "./network-status.js";
+export { BrowserNetworkTool } from "./network.js";
+export { BrowserScreenshotTool } from "./screenshot.js";
+export { BrowserInteraction } from "./interaction.js";
+import { BrowserCreateSessionTool } from "./create-session.js";
+import { BrowserRemoveSessionTool } from "./remove-session.js";
+import { BrowserGetSessionsTool } from "./get-sessions.js";
+import { BrowserNavigateTool } from "./navigate.js";
+import { BrowserConsoleTool } from "./console.js";
+import { BrowserInjectTool } from "./inject.js";
+import { BrowserReadTool } from "./read.js";
+import { BrowserClickTool } from "./click.js";
+import { BrowserFillTool } from "./fill.js";
+import { BrowserSubmitFormTool } from "./submit-form.js";
+import { BrowserScrollInfoTool } from "./scroll-info.js";
+import { BrowserScrollTool } from "./scroll.js";
+import { BrowserNetworkStatusTool } from "./network-status.js";
+import { BrowserNetworkTool } from "./network.js";
+import { BrowserScreenshotTool } from "./screenshot.js";
+export const BrowserTools = () => [
+    BrowserCreateSessionTool(),
+    BrowserRemoveSessionTool(),
+    BrowserGetSessionsTool(),
+    BrowserNavigateTool(),
+    BrowserConsoleTool(),
+    BrowserInjectTool(),
+    BrowserReadTool(),
+    BrowserClickTool(),
+    BrowserFillTool(),
+    BrowserSubmitFormTool(),
+    BrowserScrollInfoTool(),
+    BrowserScrollTool(),
+    BrowserNetworkStatusTool(),
+    BrowserNetworkTool(),
+    BrowserScreenshotTool(),
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC;IAC9B,wBAAwB,EAAE;IAC1B,wBAAwB,EAAE;IAC1B,sBAAsB,EAAE;IACxB,mBAAmB,EAAE;IACrB,kBAAkB,EAAE;IACpB,iBAAiB,EAAE;IACnB,eAAe,EAAE;IACjB,gBAAgB,EAAE;IAClB,eAAe,EAAE;IACjB,qBAAqB,EAAE;IACvB,qBAAqB,EAAE;IACvB,iBAAiB,EAAE;IACnB,wBAAwB,EAAE;IAC1B,kBAAkB,EAAE;IACpB,qBAAqB,EAAE;CAC1B,CAAC"}

package/dist/tools/browser/inject.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+export declare const BrowserInjectTool: () => MCPTool<BrowserInteraction>;
+export default BrowserInjectTool;
+//# sourceMappingURL=inject.d.ts.map

package/dist/tools/browser/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/inject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAKtD,eAAO,MAAM,iBAAiB,mCAuD5B,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/tools/browser/inject.js

@@ -0,0 +1,51 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+import { getSession } from "./session-manager.js";
+const OUTPUT_CAP = 5000;
+export const BrowserInjectTool = () => new MCPTool({
+    name: "browser-inject",
+    description: "evaluate arbitrary JavaScript inside a browser session's page and return its result (capped at 5000 characters)",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to inject into",
+            required: true,
+        },
+        {
+            name: "eval",
+            type: "string",
+            description: "javascript expression/statement to evaluate in the page context",
+            required: true,
+        },
+    ],
+    customClass: new BrowserInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { sessionId, eval: code } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        if (!code || typeof code !== "string") {
+            throw new Error("eval must be a non-empty string");
+        }
+        customClass?.emitBrowserEvent({ type: "injecting", sessionId });
+        const session = getSession(sessionId);
+        let result;
+        try {
+            // page.evaluate() accepts a raw string and runs it directly in
+            // the page context; wrapping in an async IIFE lets both bare
+            // expressions and multi-statement code work, and lets us
+            // await any promises the injected code returns.
+            result = await session.page.evaluate(`(async () => { ${code} })()`);
+        }
+        catch (err) {
+            result = `Error: ${err?.message || String(err)}`;
+        }
+        const content = typeof result === "string" ? result : JSON.stringify(result);
+        return {
+            content: (content || "").slice(0, OUTPUT_CAP),
+        };
+    },
+});
+export default BrowserInjectTool;
+//# sourceMappingURL=inject.js.map

package/dist/tools/browser/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sourceRoot":"","sources":["../../../src/tools/browser/inject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IACnE,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,iHAAiH;IAC9H,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,kBAAkB,EAAE;IACrC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAAgC,EACpB,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAEzC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QAED,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QAEhE,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtC,IAAI,MAAW,CAAC;QAChB,IAAI,CAAC;YACD,+DAA+D;YAC/D,6DAA6D;YAC7D,yDAAyD;YACzD,gDAAgD;YAChD,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,GAAG,UAAU,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE7E,OAAO;YACH,OAAO,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;SAChD,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/tools/browser/interaction.d.ts

@@ -0,0 +1,49 @@
+import { MCPCustomClass } from "../../core/mcp.js";
+export type BrowserEvent = {
+    type: "session-created";
+    sessionId: string;
+    url: string;
+} | {
+    type: "session-removed";
+    sessionId: string;
+} | {
+    type: "navigating";
+    sessionId: string;
+    url: string;
+} | {
+    type: "reading";
+    sessionId: string;
+} | {
+    type: "clicking";
+    sessionId: string;
+    ref: string;
+} | {
+    type: "filling";
+    sessionId: string;
+    ref: string;
+} | {
+    type: "submitting-form";
+    sessionId: string;
+    formRef: string;
+} | {
+    type: "scrolling";
+    sessionId: string;
+    position: number;
+} | {
+    type: "injecting";
+    sessionId: string;
+} | {
+    type: "screenshotting";
+    sessionId: string;
+};
+/**
+ * Shared custom interaction class for all browser tools. A frontend can
+ * listen on getEvents() to show live status (e.g. "Searching...",
+ * "Navigating to example.com...", "Clicking button...") while the agent
+ * drives the browser, without waiting for the tool call itself to resolve.
+ */
+export declare class BrowserInteraction extends MCPCustomClass {
+    emitBrowserEvent(event: BrowserEvent): void;
+}
+export default BrowserInteraction;
+//# sourceMappingURL=interaction.d.ts.map

package/dist/tools/browser/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IAClD,gBAAgB,CAAC,KAAK,EAAE,YAAY;CAGvC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/tools/browser/interaction.js

@@ -0,0 +1,14 @@
+import { MCPCustomClass } from "../../core/mcp.js";
+/**
+ * Shared custom interaction class for all browser tools. A frontend can
+ * listen on getEvents() to show live status (e.g. "Searching...",
+ * "Navigating to example.com...", "Clicking button...") while the agent
+ * drives the browser, without waiting for the tool call itself to resolve.
+ */
+export class BrowserInteraction extends MCPCustomClass {
+    emitBrowserEvent(event) {
+        this.getEvents().emit("browser", event);
+    }
+}
+export default BrowserInteraction;
+//# sourceMappingURL=interaction.js.map

package/dist/tools/browser/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../../src/tools/browser/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAcnD;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAClD,gBAAgB,CAAC,KAAmB;QAChC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;CACJ;AAED,eAAe,kBAAkB,CAAC"}

package/dist/tools/browser/navigate.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+export declare const BrowserNavigateTool: () => MCPTool<BrowserInteraction>;
+export default BrowserNavigateTool;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/tools/browser/navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,mBAAmB,mCA2C9B,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/dist/tools/browser/navigate.js

@@ -0,0 +1,39 @@
+import { MCPTool } from "../../core/mcp.js";
+import { BrowserInteraction } from "./interaction.js";
+import { getSession } from "./session-manager.js";
+export const BrowserNavigateTool = () => new MCPTool({
+    name: "browser-navigate",
+    description: "navigate an existing browser session to a new url",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to navigate",
+            required: true,
+        },
+        {
+            name: "url",
+            type: "string",
+            description: "url to navigate to",
+            required: true,
+        },
+    ],
+    customClass: new BrowserInteraction(),
+    execute: async (_envID, inputs, _mcp, customClass) => {
+        const { sessionId, url } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        if (!url || typeof url !== "string") {
+            throw new Error("url must be a non-empty string");
+        }
+        customClass?.emitBrowserEvent({ type: "navigating", sessionId, url });
+        const session = getSession(sessionId);
+        await session.page.goto(url, { waitUntil: "domcontentloaded" });
+        return {
+            message: "success",
+        };
+    },
+});
+export default BrowserNavigateTool;
+//# sourceMappingURL=navigate.js.map

package/dist/tools/browser/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../../src/tools/browser/navigate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAqB;IACrE,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,mDAAmD;IAChE,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qBAAqB;YAClC,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,WAAW,EAAE,IAAI,kBAAkB,EAAE;IACrC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAAgC,EACpB,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QAElC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QAED,WAAW,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAEhE,OAAO;YACH,OAAO,EAAE,SAAS;SACrB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/dist/tools/browser/network-status.d.ts

@@ -0,0 +1,4 @@
+import { MCPTool } from "../../core/mcp.js";
+export declare const BrowserNetworkStatusTool: () => MCPTool<undefined>;
+export default BrowserNetworkStatusTool;
+//# sourceMappingURL=network-status.d.ts.map

package/dist/tools/browser/network-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-status.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/network-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,eAAO,MAAM,wBAAwB,0BAkCnC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/tools/browser/network-status.js

@@ -0,0 +1,35 @@
+import { MCPTool } from "../../core/mcp.js";
+import { getSession } from "./session-manager.js";
+export const BrowserNetworkStatusTool = () => new MCPTool({
+    name: "browser-network-status",
+    description: "check whether the page currently has in-flight network activity",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to inspect",
+            required: true,
+        },
+    ],
+    execute: async (_envID, inputs) => {
+        const { sessionId } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        const session = getSession(sessionId);
+        // If the page reports document.readyState complete and there is
+        // nothing left in the browser's resource timeline that hasn't
+        // finished, we consider the network idle.
+        const status = await session.page.evaluate(() => {
+            const pending = performance
+                .getEntriesByType("resource")
+                .some((entry) => entry.responseEnd === 0);
+            return document.readyState === "complete" && !pending ? "idle" : "loading";
+        });
+        return {
+            status,
+        };
+    },
+});
+export default BrowserNetworkStatusTool;
+//# sourceMappingURL=network-status.js.map

package/dist/tools/browser/network-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-status.js","sourceRoot":"","sources":["../../../src/tools/browser/network-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC;IACtD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,iEAAiE;IAC9E,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,OAAO,EAAE,KAAK,EAAE,MAAc,EAAE,MAA2B,EAAgB,EAAE;QACzE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAE7B,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtC,gEAAgE;QAChE,8DAA8D;QAC9D,0CAA0C;QAC1C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC5C,MAAM,OAAO,GAAG,WAAW;iBACtB,gBAAgB,CAAC,UAAU,CAAC;iBAC5B,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC;YACnD,OAAO,QAAQ,CAAC,UAAU,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,OAAO;YACH,MAAM;SACT,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/tools/browser/network.d.ts

@@ -0,0 +1,4 @@
+import { MCPTool } from "../../core/mcp.js";
+export declare const BrowserNetworkTool: () => MCPTool<undefined>;
+export default BrowserNetworkTool;
+//# sourceMappingURL=network.d.ts.map

package/dist/tools/browser/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,eAAO,MAAM,kBAAkB,0BAkD7B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/dist/tools/browser/network.js

@@ -0,0 +1,51 @@
+import { MCPTool } from "../../core/mcp.js";
+import { getSession } from "./session-manager.js";
+export const BrowserNetworkTool = () => new MCPTool({
+    name: "browser-network",
+    description: "read network activity logs captured from a browser session (each request/response body capped at 1000 characters)",
+    inputs: [
+        {
+            name: "sessionId",
+            type: "string",
+            description: "session to read network logs from",
+            required: true,
+        },
+        {
+            name: "limit",
+            type: "number",
+            description: "max number of entries to return",
+            required: false,
+            default: 20,
+        },
+        {
+            name: "offset",
+            type: "number",
+            description: "offset into the log buffer",
+            required: false,
+            default: 0,
+        },
+        {
+            name: "type",
+            type: "string",
+            description: "filter by resource type, e.g. \"fetch\", \"xhr\", \"document\", \"image\", \"media\", or \"all\"",
+            required: false,
+            default: "all",
+        },
+    ],
+    execute: async (_envID, inputs) => {
+        const { sessionId, limit = 20, offset = 0, type = "all" } = inputs;
+        if (!sessionId || typeof sessionId !== "string") {
+            throw new Error("sessionId must be a non-empty string");
+        }
+        const session = getSession(sessionId);
+        const filtered = type && type !== "all"
+            ? session.networkLogs.filter((entry) => entry.type === type)
+            : session.networkLogs;
+        return {
+            messages: filtered.slice(offset, offset + limit),
+            total: filtered.length,
+        };
+    },
+});
+export default BrowserNetworkTool;
+//# sourceMappingURL=network.js.map

package/dist/tools/browser/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/tools/browser/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC;IAChD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,mHAAmH;IAChI,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mCAAmC;YAChD,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iCAAiC;YAC9C,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,EAAE;SACd;QACD;YACI,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC;SACb;QACD;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kGAAkG;YAC/G,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACjB;KACJ;IACD,OAAO,EAAE,KAAK,EAAE,MAAc,EAAE,MAA2B,EAAgB,EAAE;QACzE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAEnE,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,IAAI,IAAI,KAAK,KAAK;YACnC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAC5D,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAE1B,OAAO;YACH,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;YAChD,KAAK,EAAE,QAAQ,CAAC,MAAM;SACzB,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,kBAAkB,CAAC"}