@geminixiang/mikan 1.0.0-beta.76 → 1.0.0-beta.78

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/tools/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, Model } from \"@earendil-works/pi-ai\";\nimport type { ConversationKind } from \"../../types.js\";\nimport { createAttachTool } from \"./attach.js\";\nimport type { Executor, SandboxConfig } from \"../../sandbox/index.js\";\nimport type { OfficeAddress, SandboxResourceController } from \"../../types.js\";\nimport type { EventStore } from \"../../events/index.js\";\nimport { createEventTool } from \"./event.js\";\nimport { createGenerateImageTool } from \"./generate-image.js\";\nimport { adaptAgentTool, createSandboxTools, type MikanHarnessTool } from \"./pi-tools.js\";\nimport { withSecretRedaction } from \"./secret-redaction.js\";\nimport { createTaskTools } from \"./task.js\";\nimport { createJevTool } from \"./jev.js\";\nimport { createJevBrowserTool } from \"./jev-browser.js\";\nimport { createReactTool } from \"./react.js\";\nimport { createSandboxTool } from \"./sandbox.js\";\nimport type { PlatformToolPackFactory, PlatformToolRunContext } from \"./types.js\";\n\nexport { createSubagentTool } from \"./subagent.js\";\n\nexport function createMikanTools(\n  executor: Executor,\n  eventStore: EventStore,\n  sandboxController?: {\n    sandbox: SandboxConfig;\n    resourceController?: Pick<SandboxResourceController, \"getLimitStatus\" | \"setLimits\">;\n  },\n  /** Platform capability pack factories (e.g. GitHub PR/CI); instantiated\n   *  here so each runner owns its packs' bind state. Not core tools. */\n  platformToolPackFactories: readonly PlatformToolPackFactory[] = [],\n  imageGeneration?: {\n    model: Model<Api>;\n    getApiKey: () => Promise<string | undefined>;\n    outputDir: string;\n  },\n): {\n  tools: MikanHarnessTool[];\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n  /** Upload for generate_image. Receives the file's HOST path — the tool\n   *  writes host-side, so this must not stage through the sandbox like the\n   *  attach upload does. No-op when image generation is not configured. */\n  setImageUploadFunction: (fn: (hostPath: string, title?: string) => Promise<void>) => void;\n  bindTasks: ReturnType<typeof createTaskTools>[\"bindTasks\"];\n  setReactFunction: (fn: ((emoji: string) => Promise<void>) | null) => void;\n  bindPlatformToolPacks: (ctx: PlatformToolRunContext) => void;\n  setEventContext: (context: {\n    platform: string;\n    conversationId: string;\n    conversationKind: ConversationKind;\n    userId: string;\n  }) => void;\n  setSandboxContext: (context: { address: OfficeAddress; userId: string }) => void;\n} {\n  const { tool: attachTool, setUploadFunction } = createAttachTool();\n  const imageTool = imageGeneration ? createGenerateImageTool(imageGeneration) : undefined;\n  const { tools: taskTools, bindTasks } = createTaskTools();\n  const { tool: reactTool, setReactFunction } = createReactTool();\n  const jevTool = createJevTool();\n  // Shells out to the operator-installed `agent-browser` CLI, which drives a\n  // real Chrome process on the host — not meaningful (and not safely\n  // reachable) from a container/image sandbox, so only host mode gets it.\n  const jevBrowserTool =\n    executor.getSandboxConfig().type === \"host\" ? createJevBrowserTool() : undefined;\n  const { tool: eventTool, setEventContext } = createEventTool(eventStore);\n  const { tool: sandboxTool, setSandboxContext } = createSandboxTool(\n    sandboxController ?? { sandbox: executor.getSandboxConfig() },\n  );\n  const platformToolPacks = platformToolPackFactories.map((createPack) => createPack());\n  const packTools = platformToolPacks.flatMap((pack) => pack.tools);\n  return {\n    tools: [\n      // pi-native read/write/edit/bash, addressed through the sandbox env.\n      ...createSandboxTools(),\n      adaptAgentTool(eventTool),\n      adaptAgentTool(sandboxTool),\n      adaptAgentTool(attachTool),\n      ...(imageTool ? [adaptAgentTool(imageTool.tool)] : []),\n      adaptAgentTool(reactTool),\n      adaptAgentTool(jevTool),\n      ...(jevBrowserTool ? [adaptAgentTool(jevBrowserTool)] : []),\n      ...taskTools.map(adaptAgentTool),\n      ...packTools.map(adaptAgentTool),\n      // Every tool above can return a configured secret's plain-text value —\n      // most directly bash/read in host sandbox mode, which is not OS-isolated\n      // from the mikan process's own env. Redact uniformly rather than only\n      // guarding bash.\n    ].map(withSecretRedaction),\n    setUploadFunction,\n    setImageUploadFunction: (fn) => {\n      imageTool?.setUploadFunction(fn);\n    },\n    setReactFunction,\n    bindTasks,\n    bindPlatformToolPacks: (ctx) => {\n      for (const pack of platformToolPacks) {\n        pack.bindRun(ctx);\n      }\n    },\n    setEventContext,\n    setSandboxContext,\n  };\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAyB,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,UAAU,gBAAgB,CAC9B,QAAkB,EAClB,UAAsB,EACtB,iBAGC,EACD,yBAAyB,GAAuC,EAAE,EAClE,eAIC;IAgBD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAAC;IAChE,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,cAAc,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAChE,iBAAiB,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAC9D,CAAC;IACF,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,OAAO;QACL,KAAK,EAAE;YACL,GAAG,kBAAkB,EAAE;YACvB,cAAc,CAAC,SAAS,CAAC;YACzB,cAAc,CAAC,WAAW,CAAC;YAC3B,cAAc,CAAC,UAAU,CAAC;YAC1B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,cAAc,CAAC,SAAS,CAAC;YACzB,cAAc,CAAC,OAAO,CAAC;YACvB,cAAc,CAAC,cAAc,CAAC;YAC9B,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;YAChC,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;SACjC,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAC1B,iBAAiB;QACjB,sBAAsB,EAAE,CAAC,EAAE,EAAE,EAAE;YAC7B,SAAS,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,gBAAgB;QAChB,SAAS;QACT,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE;YAC7B,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC","sourcesContent":["import type { Api, Model } from \"@earendil-works/pi-ai\";\nimport type { ConversationKind } from \"../../types.js\";\nimport { createAttachTool } from \"./attach.js\";\nimport type { Executor, SandboxConfig } from \"../../sandbox/index.js\";\nimport type { OfficeAddress, SandboxResourceController } from \"../../types.js\";\nimport type { EventStore } from \"../../events/index.js\";\nimport { createEventTool } from \"./event.js\";\nimport { createGenerateImageTool } from \"./generate-image.js\";\nimport { adaptAgentTool, createSandboxTools, type MikanHarnessTool } from \"./pi-tools.js\";\nimport { withSecretRedaction } from \"./secret-redaction.js\";\nimport { createTaskTools } from \"./task.js\";\nimport { createJevTool } from \"./jev.js\";\nimport { createJevBrowserTool } from \"./jev-browser.js\";\nimport { createReactTool } from \"./react.js\";\nimport { createSandboxTool } from \"./sandbox.js\";\nimport type { PlatformToolPackFactory, PlatformToolRunContext } from \"./types.js\";\n\nexport { createSubagentTool } from \"./subagent.js\";\n\nexport function createMikanTools(\n  executor: Executor,\n  eventStore: EventStore,\n  sandboxController?: {\n    sandbox: SandboxConfig;\n    resourceController?: Pick<SandboxResourceController, \"getLimitStatus\" | \"setLimits\">;\n  },\n  platformToolPackFactories: readonly PlatformToolPackFactory[] = [],\n  imageGeneration?: {\n    model: Model<Api>;\n    getApiKey: () => Promise<string | undefined>;\n    outputDir: string;\n  },\n): {\n  tools: MikanHarnessTool[];\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n  setImageUploadFunction: (fn: (hostPath: string, title?: string) => Promise<void>) => void;\n  bindTasks: ReturnType<typeof createTaskTools>[\"bindTasks\"];\n  setReactFunction: (fn: ((emoji: string) => Promise<void>) | null) => void;\n  bindPlatformToolPacks: (ctx: PlatformToolRunContext) => void;\n  setEventContext: (context: {\n    platform: string;\n    conversationId: string;\n    conversationKind: ConversationKind;\n    userId: string;\n  }) => void;\n  setSandboxContext: (context: { address: OfficeAddress; userId: string }) => void;\n} {\n  const { tool: attachTool, setUploadFunction } = createAttachTool();\n  const imageTool = imageGeneration ? createGenerateImageTool(imageGeneration) : undefined;\n  const { tools: taskTools, bindTasks } = createTaskTools();\n  const { tool: reactTool, setReactFunction } = createReactTool();\n  const jevTool = createJevTool();\n  const jevBrowserTool = createJevBrowserTool(executor);\n  const { tool: eventTool, setEventContext } = createEventTool(eventStore);\n  const { tool: sandboxTool, setSandboxContext } = createSandboxTool(\n    sandboxController ?? { sandbox: executor.getSandboxConfig() },\n  );\n  const platformToolPacks = platformToolPackFactories.map((createPack) => createPack());\n  const packTools = platformToolPacks.flatMap((pack) => pack.tools);\n  return {\n    tools: [\n      ...createSandboxTools(),\n      adaptAgentTool(eventTool),\n      adaptAgentTool(sandboxTool),\n      adaptAgentTool(attachTool),\n      ...(imageTool ? [adaptAgentTool(imageTool.tool)] : []),\n      adaptAgentTool(reactTool),\n      adaptAgentTool(jevTool),\n      adaptAgentTool(jevBrowserTool),\n      ...taskTools.map(adaptAgentTool),\n      ...packTools.map(adaptAgentTool),\n    ].map(withSecretRedaction),\n    setUploadFunction,\n    setImageUploadFunction: (fn) => {\n      imageTool?.setUploadFunction(fn);\n    },\n    setReactFunction,\n    bindTasks,\n    bindPlatformToolPacks: (ctx) => {\n      for (const pack of platformToolPacks) {\n        pack.bindRun(ctx);\n      }\n    },\n    setEventContext,\n    setSandboxContext,\n  };\n}\n"]}

package/dist/harness/tools/jev-browser.d.ts

@@ -1,84 +1,11 @@
-/**
- * `jev_browser`: a browser-automation tool that drives a real Chrome
- * instance toward a natural-language goal, deciding each step itself.
- *
- * Combines two existing pieces rather than reimplementing either:
- *  - `agent-browser` (Vercel Labs' CLI, https://github.com/vercel-labs/agent-browser)
- *    launches and controls Chrome over CDP and produces ref-indexed
- *    accessibility snapshots (`@e1`, `@e2`, ...) — the hard part of
- *    "what's on this page and how do I click it" is already solved there.
- *  - Jev (`evaluateWithJev`, `harness/jev.ts`) picks the next operation
- *    (CLICK/TYPE_TEXT/SELECT/scroll/WAIT/DONE/BLOCKED) and its target
- *    element from that snapshot with one calibrated-choice request per
- *    step, the way github.com/browser-use/jev-ultrafast drives a browser
- *    without a full chat model in the loop.
- *
- * `agent-browser` is treated as an operator-installed host tool, not a
- * mikan dependency: mikan's own `npm install --ignore-scripts` would skip
- * its postinstall step (which downloads the platform's native binary),
- * silently breaking it. The tool fails with an actionable error message
- * when the CLI isn't on PATH.
- *
- * The Jev-driven loop only exercises the handful of agent-browser commands
- * it needs to act on a page (open/snapshot/click/fill/select/scroll/wait).
- * Everything else agent-browser can do — screenshot, `record start/stop`,
- * `network har start/stop`, pdf, cookies, eval, `set viewport`, `find`,
- * `mouse`, and any future command — is reachable through `commands`, which
- * forwards raw argument arrays to the CLI verbatim rather than wrapping
- * each one, so the surface stays complete as agent-browser adds commands.
- * `session` lets a caller span such commands and a goal-driven run across
- * multiple tool calls against the same browser (e.g. start a recording,
- * run a goal, stop the recording, screenshot the result).
- *
- * v1 is intentionally minimal: no domain allowlisting, no action-policy
- * file, no persistent auth. Host sandbox only — `index.ts` wires this tool
- * up only when the conversation's executor reports `sandbox.type === "host"`.
- *
- * Session lifetime default was learned the hard way: an earlier version
- * closed every session unless the caller passed `keepOpen: true` on *every*
- * call, including calls that only ran `commands`. A caller reusing the same
- * `session` id across a `record start` / goal / `record stop` sequence
- * forgot that flag on most calls, so each call silently closed and
- * reopened a brand-new browser under the same session name — `record
- * start` ran, the browser closed before any frame was captured, the next
- * call's `record stop` had nothing to stop, and `network har
- * start`/`stop` bracketed zero continuous browsing time. The failure was
- * silent: every individual call still reported success. Now the default
- * follows the caller's stated intent instead of a flag that is easy to
- * forget under focus on harder problems (what to click, how long to wait
- * for an intermittent element): naming an existing `session` means "keep
- * this browser around," so the tool does not close it unless `close: true`
- * is explicit. Only a call with no `session` (a one-off, auto-generated
- * session) closes by default, preserving the original single-call
- * ergonomics. The downside — a one-off call that happens to pass an
- * explicit `session` name without ever reusing it leaves that session
- * lingering — is bounded by agent-browser's own 1-hour idle-daemon
- * timeout and is strictly safer than silently destroying in-progress
- * capture state.
- *
- * Every result also reports `browserContinuity`, a one-line readable
- * summary of whether the browser that just ran was actually the same one
- * as the prior call in this session (agent-browser's own `reused` /
- * `relaunchedBrowser` / `launched` lifecycle fields, otherwise buried a
- * few levels deep inside each raw `commandResults` entry) — so a caller
- * debugging a capture that came back empty sees "the browser was
- * relaunched, not continuous" directly, instead of only suspecting it
- * after reading raw JSON for several turns.
- *
- * The Jev-driven loop only decides actions; it does not summarize or
- * extract page content itself. Its result always carries
- * `lastPageSnapshot`, the accessibility-tree text of the last page
- * observed — including a run that reaches DONE on the very first
- * snapshot, whose `history` is empty. Without this, the caller has no way
- * to read what the browser actually saw, and reaches for an unrelated
- * tool (e.g. `curl`) to get an answer this tool already had.
- */
 import type { AgentTool } from "@earendil-works/pi-agent-core";
+import type { Executor } from "../../sandbox/index.js";
 import { type JevQuestions } from "../jev.js";
 declare const jevBrowserSchema: import("@sinclair/typebox").TObject<{
     label: import("@sinclair/typebox").TString;
     goal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    frame: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     commands: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>>;
     session: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     close: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
@@ -88,22 +15,13 @@ interface RefInfo {
     role: string;
     name: string;
 }
-/** Present on `data` in every agent-browser response, regardless of command. */
 interface BrowserLifecycle {
     reused?: boolean;
     relaunchedBrowser?: boolean;
     launched?: boolean;
 }
-/**
- * One-line, non-buried answer to "was this call's browser actually the
- * same one a prior call in this session left running?" — built from the
- * first agent-browser response in this invocation. Answers the question a
- * caller debugging an empty recording/HAR needs first, before it occurs to
- * them to go digging through commandResults' raw lifecycle fields.
- */
 declare function describeContinuity(hadSession: boolean, first: BrowserLifecycle | undefined): string;
 declare function truncate(text: string, max: number): string;
-/** Split refs into candidate buckets per operation. CLICK accepts any ref. */
 declare function categorizeRefs(refs: Record<string, RefInfo>): {
     click: [string, RefInfo][];
     type: [string, RefInfo][];
@@ -111,20 +29,12 @@ declare function categorizeRefs(refs: Record<string, RefInfo>): {
 };
 interface QuestionPlan {
     questions: JevQuestions;
-    /** Operations whose only candidate is resolved directly, with no target question. */
     singles: Record<string, string>;
 }
-/**
- * Build the per-step Jev request: one `operation` choice (always present)
- * plus a `*_target` choice for every operation with 2+ candidate refs.
- * An operation with exactly one candidate skips the target question —
- * Jev's `choice` questions require at least two options — and resolves to
- * that ref directly once selected.
- */
-declare function buildQuestionPlan(refs: Record<string, RefInfo>, canScrollUp: boolean, canScrollDown: boolean): QuestionPlan;
+declare function buildQuestionPlan(refs: Record<string, RefInfo>, canScrollUp: boolean, canScrollDown: boolean, snapshot?: string): QuestionPlan;
 declare function resolveTarget(operation: string, answers: Record<string, {
     choice?: unknown;
 } | undefined>, singles: Record<string, string>): string | undefined;
-export declare function createJevBrowserTool(): AgentTool<typeof jevBrowserSchema>;
+export declare function createJevBrowserTool(executor: Executor): AgentTool<typeof jevBrowserSchema>;
 export { buildQuestionPlan, resolveTarget, categorizeRefs, truncate, describeContinuity };
 //# sourceMappingURL=jev-browser.d.ts.map

package/dist/harness/tools/jev-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jev-browser.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/jev-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAM/D,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAc9E,QAAA,MAAM,gBAAgB;;;;;;;;EAuCpB,CAAC;AAIH,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAcD,gFAAgF;AAChF,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;GAMG;AACH,iBAAS,kBAAkB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,CAa5F;AAgCD,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAiCD,8EAA8E;AAC9E,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACtD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAC7B,CAOA;AASD,UAAU,YAAY;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,OAAO,EACpB,aAAa,EAAE,OAAO,GACrB,YAAY,CAgDd;AAsDD,iBAAS,aAAa,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAAC,EACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAuPzE;AAGD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"jev-browser.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/jev-browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAW9E,QAAA,MAAM,gBAAgB;;;;;;;;;EA6CpB,CAAC;AAIH,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAcD,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,iBAAS,kBAAkB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,CAe5F;AAyCD,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAuCD,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACtD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAC7B,CAOA;AAmBD,UAAU,YAAY;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,iBAAS,iBAAiB,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,OAAO,EACpB,aAAa,EAAE,OAAO,EACtB,QAAQ,SAAK,GACZ,YAAY,CAiDd;AAsDD,iBAAS,aAAa,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAAC,EACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,GAAG,SAAS,CAUpB;AAuWD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAqB3F;AAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC"}