@effect-uai/core 0.11.0 → 0.12.1

package/dist/browser/Browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Browser.mjs","names":[],"sources":["../../src/browser/Browser.ts"],"sourcesContent":["import { Brand, Context, type Duration, Effect, Scope } from \"effect\"\nimport type * as BrowserError from \"./BrowserError.js\"\n\n// ---------------------------------------------------------------------------\n// Identity\n// ---------------------------------------------------------------------------\n\n/**\n * Session identifier. Branded `string` so providers don't accidentally\n * accept a raw user-supplied id, and so a session id can't be passed where\n * another service's id is expected. Each provider mints these per its own\n * scheme; core code treats them opaquely. Mint via `BrowserSessionId(...)`.\n */\nexport type BrowserSessionId = Brand.Branded<string, \"BrowserSessionId\">\nexport const BrowserSessionId = Brand.nominal<BrowserSessionId>()\n\n/** Reference returned by `list`; enough to `attach`. */\nexport type BrowserSessionRef = {\n  readonly id: BrowserSessionId\n  /** Current top-level URL, when the provider reports it. */\n  readonly url?: string\n}\n\n/**\n * Output representation for {@link BrowserSession.content}. `markdown` is\n * the default.\n */\nexport type PageFormat = \"markdown\" | \"html\"\n\n// ---------------------------------------------------------------------------\n// Create request\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider session-create request. Provider-specific knobs (proxy,\n * stealth, persistent profile, ...) live on each provider's narrowed\n * request type which extends this.\n */\nexport type CommonSessionRequest = {\n  /**\n   * Hard max lifetime of the session. Enforced locally (the handle is\n   * disposed and further calls fail with `BrowserSessionExpired`) and,\n   * where the provider supports it, passed through as a server-side cap so\n   * a crashed client still gets the session reclaimed. The provider cap\n   * must be >= the local reaper. Accepts millis, a string like\n   * `\"5 minutes\"`, or a `Duration`.\n   */\n  readonly timeout?: Duration.Input\n  /**\n   * Idle teardown: dispose the session after this much inactivity, the\n   * timer resetting on each operation. Opt-in; omit for no idle limit.\n   */\n  readonly idleTimeout?: Duration.Input\n  /** Initial viewport size. Providers default differently. */\n  readonly viewport?: { readonly width: number; readonly height: number }\n}\n\n// ---------------------------------------------------------------------------\n// Observation shapes\n// ---------------------------------------------------------------------------\n\nexport type BoundingBox = {\n  readonly x: number\n  readonly y: number\n  readonly width: number\n  readonly height: number\n}\n\n/**\n * One element returned by {@link BrowserSession.query}. Serializable data,\n * not a live handle (handles go stale across navigation and do not cross a\n * provider boundary cleanly).\n */\nexport type ElementInfo = {\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref: string\n  readonly tag: string\n  readonly text?: string\n  readonly attributes: Readonly<Record<string, string>>\n  readonly box?: BoundingBox\n}\n\n/** Accessibility-tree node returned by {@link BrowserSession.snapshot}. */\nexport type AxNode = {\n  readonly role: string\n  readonly name?: string\n  readonly value?: string\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref?: string\n  readonly children: ReadonlyArray<AxNode>\n}\n\n// ---------------------------------------------------------------------------\n// Interaction shapes\n// ---------------------------------------------------------------------------\n\nexport type ScrollDirection = \"up\" | \"down\" | \"left\" | \"right\"\n\nexport type ScrollOptions = {\n  readonly direction: ScrollDirection\n  /** Distance in CSS pixels. Provider default applies when omitted. */\n  readonly pixels?: number\n}\n\nexport type ScreenshotOptions = {\n  /** Clip to the first element matching this selector. */\n  readonly selector?: string\n  /** Capture the full scrollable page rather than the viewport. */\n  readonly fullPage?: boolean\n}\n\nexport type Cookie = {\n  readonly name: string\n  readonly value: string\n  readonly domain?: string\n  readonly path?: string\n  readonly expires?: number\n  readonly httpOnly?: boolean\n  readonly secure?: boolean\n  readonly sameSite?: \"Strict\" | \"Lax\" | \"None\"\n}\n\n/** Read / write the session's cookie jar. Needed for authenticated flows. */\nexport type CookieApi = {\n  readonly get: Effect.Effect<ReadonlyArray<Cookie>, BrowserError.BrowserError>\n  readonly set: (cookies: ReadonlyArray<Cookie>) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Live session handle\n// ---------------------------------------------------------------------------\n\n/**\n * Live session handle. Actions take a CSS selector string (so `#id` is\n * just `#id`). Methods are plain `Effect` values; disposal is the scope\n * finalizer, not a method here (see {@link BrowserService}). Anything not\n * covered by a verb is reachable via `evaluate`. Per-operation time budgets\n * are the provider's default; wrap any call in `Effect.timeout` for a\n * tighter bound.\n */\nexport type BrowserSession = {\n  readonly id: BrowserSessionId\n\n  // Navigation and waiting\n  readonly goto: (url: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly waitFor: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Interaction\n  readonly click: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly dblclick: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly fill: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly type: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly press: (key: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly hover: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly focus: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly select: (\n    selector: string,\n    value: string,\n  ) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly check: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly uncheck: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scroll: (options: ScrollOptions) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scrollIntoView: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Observation\n  readonly content: (format?: PageFormat) => Effect.Effect<string, BrowserError.BrowserError>\n  readonly screenshot: (\n    options?: ScreenshotOptions,\n  ) => Effect.Effect<Uint8Array, BrowserError.BrowserError>\n  readonly snapshot: Effect.Effect<AxNode, BrowserError.BrowserError>\n  readonly query: (\n    selector: string,\n  ) => Effect.Effect<ReadonlyArray<ElementInfo>, BrowserError.BrowserError>\n\n  // State and escape hatch\n  readonly cookies: CookieApi\n  readonly evaluate: (script: string) => Effect.Effect<unknown, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Service definition\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider browser service.\n *\n * Lifetime: `create` and `attach` return a handle in `Scope.Scope`. The\n * scope finalizer disposes the session (close the transport, destroy or\n * detach the remote session, kill the local engine). Bind with\n * `Effect.scoped` for a single call, or hold a wider scope to keep a\n * session warm across many calls. This is why there is no `dispose()` on\n * {@link BrowserSession}; the scope is the lifecycle handle.\n */\nexport type BrowserService = {\n  /**\n   * Provision a new session, bound to the caller's scope. Disposed on\n   * scope close.\n   */\n  readonly create: (\n    request: CommonSessionRequest,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /**\n   * Re-acquire an existing session by id. Scope-bound, but the finalizer\n   * detaches rather than destroying, for sessions kept warm beyond a\n   * single run.\n   */\n  readonly attach: (\n    id: BrowserSessionId,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /** Enumerate sessions visible to the configured account / project. */\n  readonly list: Effect.Effect<ReadonlyArray<BrowserSessionRef>, BrowserError.BrowserError>\n\n  /**\n   * Destroy a session from outside its owning scope. Most callers should\n   * let the scope finalizer handle this.\n   */\n  readonly destroy: (id: BrowserSessionId) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\nexport class Browser extends Context.Service<Browser, BrowserService>()(\n  \"@betalyra/effect-uai/Browser\",\n) {}\n\n// ---------------------------------------------------------------------------\n// Free helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Provision a session bound to the caller's scope. Drop the `Scope.Scope`\n * requirement with `Effect.scoped`.\n */\nexport const create = (\n  request: CommonSessionRequest,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser, (s) => s.create(request))\n\n/**\n * Re-acquire an existing session by id. Same scope semantics as `create`,\n * but the finalizer detaches rather than destroying.\n */\nexport const attach = (\n  id: BrowserSessionId,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser, (s) => s.attach(id))\n\n/** Enumerate sessions for the configured account / project. */\nexport const list: Effect.Effect<\n  ReadonlyArray<BrowserSessionRef>,\n  BrowserError.BrowserError,\n  Browser\n> = Effect.flatMap(Browser, (s) => s.list)\n\n/**\n * Destroy a session from outside its owning scope. Most callers should let\n * the scope finalizer handle this automatically.\n */\nexport const destroy = (\n  id: BrowserSessionId,\n): Effect.Effect<void, BrowserError.BrowserError, Browser> =>\n  Effect.flatMap(Browser, (s) => s.destroy(id))\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,mBAAmB,MAAM,SAA2B;AAqNjE,IAAa,UAAb,cAA6B,QAAQ,SAAkC,CACrE,+BACD,CAAC;;;;;AAUF,MAAa,UACX,YAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,OAAO,QAAQ,CAAC;;;;;AAMnD,MAAa,UACX,OAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,OAAO,GAAG,CAAC;;AAG9C,MAAa,OAIT,OAAO,QAAQ,UAAU,MAAM,EAAE,KAAK;;;;;AAM1C,MAAa,WACX,OAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,QAAQ,GAAG,CAAC"}
+{"version":3,"file":"Browser.mjs","names":[],"sources":["../../src/browser/Browser.ts"],"sourcesContent":["import { Brand, Context, type Duration, Effect, Scope } from \"effect\"\nimport type * as BrowserError from \"./BrowserError.js\"\n\n// ---------------------------------------------------------------------------\n// Identity\n// ---------------------------------------------------------------------------\n\n/**\n * Session identifier. Branded `string` so providers don't accidentally\n * accept a raw user-supplied id, and so a session id can't be passed where\n * another service's id is expected. Each provider mints these per its own\n * scheme; core code treats them opaquely. Mint via `BrowserSessionId(...)`.\n */\nexport type BrowserSessionId = Brand.Branded<string, \"BrowserSessionId\">\nexport const BrowserSessionId = Brand.nominal<BrowserSessionId>()\n\n/** Reference returned by `list`; enough to `attach`. */\nexport type BrowserSessionRef = {\n  readonly id: BrowserSessionId\n  /** Current top-level URL, when the provider reports it. */\n  readonly url?: string\n}\n\n/**\n * Output representation for {@link BrowserSession.content}. `markdown` is\n * the default.\n */\nexport type PageFormat = \"markdown\" | \"html\"\n\n// ---------------------------------------------------------------------------\n// Create request\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider session-create request. Provider-specific knobs (proxy,\n * stealth, persistent profile, ...) live on each provider's narrowed\n * request type which extends this.\n */\nexport type CommonSessionRequest = {\n  /**\n   * Hard max lifetime of the session. Enforced locally (the handle is\n   * disposed and further calls fail with `BrowserSessionExpired`) and,\n   * where the provider supports it, passed through as a server-side cap so\n   * a crashed client still gets the session reclaimed. The provider cap\n   * must be >= the local reaper. Accepts millis, a string like\n   * `\"5 minutes\"`, or a `Duration`.\n   */\n  readonly timeout?: Duration.Input\n  /**\n   * Idle teardown: dispose the session after this much inactivity, the\n   * timer resetting on each operation. Opt-in; omit for no idle limit.\n   */\n  readonly idleTimeout?: Duration.Input\n  /** Initial viewport size. Providers default differently. */\n  readonly viewport?: { readonly width: number; readonly height: number }\n}\n\n// ---------------------------------------------------------------------------\n// Observation shapes\n// ---------------------------------------------------------------------------\n\nexport type BoundingBox = {\n  readonly x: number\n  readonly y: number\n  readonly width: number\n  readonly height: number\n}\n\n/**\n * One element returned by {@link BrowserSession.query}. Serializable data,\n * not a live handle (handles go stale across navigation and do not cross a\n * provider boundary cleanly).\n */\nexport type ElementInfo = {\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref: string\n  readonly tag: string\n  readonly text?: string\n  readonly attributes: Readonly<Record<string, string>>\n  readonly box?: BoundingBox\n}\n\n/** Accessibility-tree node returned by {@link BrowserSession.snapshot}. */\nexport type AxNode = {\n  readonly role: string\n  readonly name?: string\n  readonly value?: string\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref?: string\n  readonly children: ReadonlyArray<AxNode>\n}\n\n// ---------------------------------------------------------------------------\n// Interaction shapes\n// ---------------------------------------------------------------------------\n\nexport type ScrollDirection = \"up\" | \"down\" | \"left\" | \"right\"\n\nexport type ScrollOptions = {\n  readonly direction: ScrollDirection\n  /** Distance in CSS pixels. Provider default applies when omitted. */\n  readonly pixels?: number\n}\n\nexport type ScreenshotOptions = {\n  /** Clip to the first element matching this selector. */\n  readonly selector?: string\n  /** Capture the full scrollable page rather than the viewport. */\n  readonly fullPage?: boolean\n}\n\nexport type Cookie = {\n  readonly name: string\n  readonly value: string\n  readonly domain?: string\n  readonly path?: string\n  readonly expires?: number\n  readonly httpOnly?: boolean\n  readonly secure?: boolean\n  readonly sameSite?: \"Strict\" | \"Lax\" | \"None\"\n}\n\n/** Read / write the session's cookie jar. Needed for authenticated flows. */\nexport type CookieApi = {\n  readonly get: Effect.Effect<ReadonlyArray<Cookie>, BrowserError.BrowserError>\n  readonly set: (cookies: ReadonlyArray<Cookie>) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Live session handle\n// ---------------------------------------------------------------------------\n\n/**\n * Live session handle. Actions take a CSS selector string (so `#id` is\n * just `#id`). Methods are plain `Effect` values; disposal is the scope\n * finalizer, not a method here (see {@link BrowserService}). Anything not\n * covered by a verb is reachable via `evaluate`. Per-operation time budgets\n * are the provider's default; wrap any call in `Effect.timeout` for a\n * tighter bound.\n */\nexport type BrowserSession = {\n  readonly id: BrowserSessionId\n\n  // Navigation and waiting\n  readonly goto: (url: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly waitFor: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Interaction\n  readonly click: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly dblclick: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly fill: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly type: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly press: (key: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly hover: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly focus: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly select: (\n    selector: string,\n    value: string,\n  ) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly check: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly uncheck: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scroll: (options: ScrollOptions) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scrollIntoView: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Observation\n  readonly content: (format?: PageFormat) => Effect.Effect<string, BrowserError.BrowserError>\n  readonly screenshot: (\n    options?: ScreenshotOptions,\n  ) => Effect.Effect<Uint8Array, BrowserError.BrowserError>\n  readonly snapshot: Effect.Effect<AxNode, BrowserError.BrowserError>\n  readonly query: (\n    selector: string,\n  ) => Effect.Effect<ReadonlyArray<ElementInfo>, BrowserError.BrowserError>\n\n  // State and escape hatch\n  readonly cookies: CookieApi\n  readonly evaluate: (script: string) => Effect.Effect<unknown, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Service definition\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider browser service.\n *\n * Lifetime: `create` and `attach` return a handle in `Scope.Scope`. The\n * scope finalizer disposes the session (close the transport, destroy or\n * detach the remote session, kill the local engine). Bind with\n * `Effect.scoped` for a single call, or hold a wider scope to keep a\n * session warm across many calls. This is why there is no `dispose()` on\n * {@link BrowserSession}; the scope is the lifecycle handle.\n */\nexport type BrowserService = {\n  /**\n   * Provision a new session, bound to the caller's scope. Disposed on\n   * scope close.\n   */\n  readonly create: (\n    request: CommonSessionRequest,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /**\n   * Re-acquire an existing session by id. Scope-bound, but the finalizer\n   * detaches rather than destroying, for sessions kept warm beyond a\n   * single run.\n   */\n  readonly attach: (\n    id: BrowserSessionId,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /** Enumerate sessions visible to the configured account / project. */\n  readonly list: Effect.Effect<ReadonlyArray<BrowserSessionRef>, BrowserError.BrowserError>\n\n  /**\n   * Destroy a session from outside its owning scope. Most callers should\n   * let the scope finalizer handle this.\n   */\n  readonly destroy: (id: BrowserSessionId) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\nexport class Browser extends Context.Service<Browser, BrowserService>()(\n  \"@betalyra/effect-uai/Browser\",\n) {}\n\n// ---------------------------------------------------------------------------\n// Free helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Provision a session bound to the caller's scope. Drop the `Scope.Scope`\n * requirement with `Effect.scoped`.\n */\nexport const create = (\n  request: CommonSessionRequest,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser, (s) => s.create(request))\n\n/**\n * Re-acquire an existing session by id. Same scope semantics as `create`,\n * but the finalizer detaches rather than destroying.\n */\nexport const attach = (\n  id: BrowserSessionId,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser, (s) => s.attach(id))\n\n/** Enumerate sessions for the configured account / project. */\nexport const list: Effect.Effect<\n  ReadonlyArray<BrowserSessionRef>,\n  BrowserError.BrowserError,\n  Browser\n> = Effect.flatMap(Browser, (s) => s.list)\n\n/**\n * Destroy a session from outside its owning scope. Most callers should let\n * the scope finalizer handle this automatically.\n */\nexport const destroy = (\n  id: BrowserSessionId,\n): Effect.Effect<void, BrowserError.BrowserError, Browser> =>\n  Effect.flatMap(Browser, (s) => s.destroy(id))\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,mBAAmB,MAAM,QAA0B;AAqNhE,IAAa,UAAb,cAA6B,QAAQ,QAAiC,CAAC,CACrE,8BACF,CAAC,CAAC,CAAC;;;;;AAUH,MAAa,UACX,YAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,OAAO,OAAO,CAAC;;;;;AAMlD,MAAa,UACX,OAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,OAAO,EAAE,CAAC;;AAG7C,MAAa,OAIT,OAAO,QAAQ,UAAU,MAAM,EAAE,IAAI;;;;;AAMzC,MAAa,WACX,OAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,QAAQ,EAAE,CAAC"}

package/dist/browser/BrowserError.d.mts

@@ -1,12 +1,8 @@
 import { Duration } from "effect";
-import * as _$effect_Cause0 from "effect/Cause";
-import * as _$effect_Types0 from "effect/Types";
-
-//#region src/browser/BrowserError.d.ts
 declare namespace BrowserError_d_exports {
   export { BrowserActionFailed, BrowserAuthFailed, BrowserAuthSubtype, BrowserCreateFailed, BrowserError, BrowserInvalidRequest, BrowserQuotaExceeded, BrowserSessionExpired, BrowserSessionNotFound, BrowserTimeout, BrowserUnsupported, describe };
 }
-declare const BrowserCreateFailed_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserCreateFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserCreateFailed";
 } & Readonly<A>;
 /**
@@ -20,7 +16,7 @@ declare class BrowserCreateFailed extends BrowserCreateFailed_base<{
   reason?: string;
   raw: unknown;
 }> {}
-declare const BrowserSessionNotFound_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserSessionNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserSessionNotFound";
 } & Readonly<A>;
 /**
@@ -33,7 +29,7 @@ declare class BrowserSessionNotFound extends BrowserSessionNotFound_base<{
   provider: string;
   id: string;
 }> {}
-declare const BrowserSessionExpired_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserSessionExpired_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserSessionExpired";
 } & Readonly<A>;
 /**
@@ -47,7 +43,7 @@ declare class BrowserSessionExpired extends BrowserSessionExpired_base<{
   provider: string;
   id: string;
 }> {}
-declare const BrowserTimeout_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserTimeout_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserTimeout";
 } & Readonly<A>;
 /**
@@ -61,7 +57,7 @@ declare class BrowserTimeout extends BrowserTimeout_base<{
   budget?: Duration.Duration;
   raw?: unknown;
 }> {}
-declare const BrowserActionFailed_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserActionFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserActionFailed";
 } & Readonly<A>;
 /**
@@ -77,7 +73,7 @@ declare class BrowserActionFailed extends BrowserActionFailed_base<{
   reason?: string;
   raw: unknown;
 }> {}
-declare const BrowserQuotaExceeded_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserQuotaExceeded_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserQuotaExceeded";
 } & Readonly<A>;
 /**
@@ -90,7 +86,7 @@ declare class BrowserQuotaExceeded extends BrowserQuotaExceeded_base<{
   reason?: string;
   raw: unknown;
 }> {}
-declare const BrowserInvalidRequest_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserInvalidRequest_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserInvalidRequest";
 } & Readonly<A>;
 /**
@@ -109,7 +105,7 @@ declare class BrowserInvalidRequest extends BrowserInvalidRequest_base<{
  * the model-side `AiError.AuthFailed` shape for consistency.
  */
 type BrowserAuthSubtype = "auth" | "permission" | "billing" | "quota";
-declare const BrowserAuthFailed_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserAuthFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserAuthFailed";
 } & Readonly<A>;
 declare class BrowserAuthFailed extends BrowserAuthFailed_base<{
@@ -117,7 +113,7 @@ declare class BrowserAuthFailed extends BrowserAuthFailed_base<{
   subtype: BrowserAuthSubtype;
   raw: unknown;
 }> {}
-declare const BrowserUnsupported_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+declare const BrowserUnsupported_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "BrowserUnsupported";
 } & Readonly<A>;
 /**

package/dist/browser/BrowserError.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserError.d.mts","names":[],"sources":["../../src/browser/BrowserError.ts"],"mappings":";;;;;;;;cAA8C,wBAAA;;;;;;;;;cAQjC,mBAAA,SAA4B,wBAAA;EACvC,QAAA;EACA,MAAA;EACA,GAAA;AAAA;AAAA,cACG,2BAAA;;;;AAZyC;;;;;cAoBjC,sBAAA,SAA+B,2BAAA;EAC1C,QAAA;EACA,EAAA;AAAA;AAAA,cACG,0BAAA;;;;;;;;;;cASQ,qBAAA,SAA8B,0BAAA;EACzC,QAAA;EACA,EAAA;AAAA;AAAA,cACG,mBAAA;;;;;;AA3BL;;cAkCa,cAAA,SAAuB,mBAAA;EAClC,QAAA;EACA,SAAA;EACA,MAAA,GAAS,QAAA,CAAS,QAAA;EAClB,GAAA;AAAA;AAAA,cACG,wBAAA;;;;;;;;;cAQQ,mBAAA,SAA4B,wBAAA;EACvC,QAAA;EACA,SAAA;EACA,QAAA;EACA,MAAA;EACA,GAAA;AAAA;AAAA,cACG,yBAAA;;;;;;;;cAOQ,oBAAA,SAA6B,yBAAA;EACxC,QAAA;EACA,MAAA;EACA,GAAA;AAAA;AAAA,cACG,0BAAA;;;;;;;;cAOQ,qBAAA,SAA8B,0BAAA;EACzC,QAAA;EACA,KAAA;EACA,MAAA;EACA,GAAA;AAAA;;;;;KAOU,kBAAA;AAAA,cAAgE,sBAAA;;;cAE/D,iBAAA,SAA0B,sBAAA;EACrC,QAAA;EACA,OAAA,EAAS,kBAAA;EACT,GAAA;AAAA;AAAA,cACG,uBAAA;;;;;;;;cAOQ,kBAAA,SAA2B,uBAAA;EACtC,QAAA;EACA,UAAA;EACA,MAAA;AAAA;AAAA,KAGU,YAAA,GACR,mBAAA,GACA,sBAAA,GACA,qBAAA,GACA,cAAA,GACA,mBAAA,GACA,oBAAA,GACA,qBAAA,GACA,iBAAA,GACA,kBAAA;;;;;cASS,QAAA,GAAW,CAAA,EAAG,YAAA"}
+{"version":3,"file":"BrowserError.d.mts","names":[],"sources":["../../src/browser/BrowserError.ts"],"mappings":";;;;;;;;;;;;;cAQa,4BAA4B;EACvC;EACA;EACA;;;;;;;;;;;cASW,+BAA+B;EAC1C;EACA;;;;;;;;;;;;cAUW,8BAA8B;EACzC;EACA;;;;;;;;;;cAQW,uBAAuB;EAClC;EACA;EACA,SAAS,SAAS;EAClB;;;;;;;;;;;cASW,4BAA4B;EACvC;EACA;EACA;EACA;EACA;;;;;;;;;;cAQW,6BAA6B;EACxC;EACA;EACA;;;;;;;;;;cAQW,8BAA8B;EACzC;EACA;EACA;EACA;;;;;;KAOU;;;;cAEC,0BAA0B;EACrC;EACA,SAAS;EACT;;;;;;;;;;cAQW,2BAA2B;EACtC;EACA;EACA;;KAGU,eACR,sBACA,yBACA,wBACA,iBACA,sBACA,uBACA,wBACA,oBACA;;;;;cASS,WAAW,GAAG"}

package/dist/browser/BrowserError.mjs

@@ -1,4 +1,4 @@
-import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
 import { Data, Match } from "effect";
 //#region src/browser/BrowserError.ts
 var BrowserError_exports = /* @__PURE__ */ __exportAll({

package/dist/browser/BrowserError.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserError.mjs","names":[],"sources":["../../src/browser/BrowserError.ts"],"sourcesContent":["import { Data, Duration, Match } from \"effect\"\n\n/**\n * Failed to provision a browser session: the transport could not connect,\n * a launched engine did not come up, or the provider refused to mint a\n * session. Provider's structured reason on `reason`; the raw transport /\n * SDK error on `raw`.\n */\nexport class BrowserCreateFailed extends Data.TaggedError(\"BrowserCreateFailed\")<{\n  provider: string\n  reason?: string\n  raw: unknown\n}> {}\n\n/**\n * The requested session id does not exist. Raised by `attach` / `destroy`\n * against a stale or never-known id. Distinct from\n * {@link BrowserSessionExpired}, which is a session that existed and has\n * since ended.\n */\nexport class BrowserSessionNotFound extends Data.TaggedError(\"BrowserSessionNotFound\")<{\n  provider: string\n  id: string\n}> {}\n\n/**\n * An operation was issued against a session that has ended: it reached its\n * max lifetime (the create-time `timeout`), was destroyed, or the provider\n * reaped it. The handle is dead; `create` or `attach` a live session.\n * Distinct from {@link BrowserTimeout} (a single live operation was too\n * slow).\n */\nexport class BrowserSessionExpired extends Data.TaggedError(\"BrowserSessionExpired\")<{\n  provider: string\n  id: string\n}> {}\n\n/**\n * A single operation exceeded its own time budget while the session was\n * still alive (a navigation that never settled, a `waitFor` selector that\n * never appeared). Carries the breached budget for observability.\n */\nexport class BrowserTimeout extends Data.TaggedError(\"BrowserTimeout\")<{\n  provider: string\n  operation: \"create\" | \"attach\" | \"navigate\" | \"action\" | \"query\"\n  budget?: Duration.Duration\n  raw?: unknown\n}> {}\n\n/**\n * An interaction or observation failed at the transport / protocol layer:\n * a selector resolved to nothing, an element was not actionable, an\n * `evaluate` script threw, a navigation errored. `selector` and `reason`\n * carry what is known.\n */\nexport class BrowserActionFailed extends Data.TaggedError(\"BrowserActionFailed\")<{\n  provider: string\n  operation: \"navigate\" | \"interact\" | \"observe\" | \"evaluate\" | \"cookies\"\n  selector?: string\n  reason?: string\n  raw: unknown\n}> {}\n\n/**\n * Provider rejected the request because an account / project quota or\n * concurrency limit was exceeded. Separate from {@link BrowserCreateFailed}\n * so callers can back off and retry.\n */\nexport class BrowserQuotaExceeded extends Data.TaggedError(\"BrowserQuotaExceeded\")<{\n  provider: string\n  reason?: string\n  raw: unknown\n}> {}\n\n/**\n * Caller's request shape is malformed for the wired provider. Adapters\n * should reject at the request-schema layer where possible; this is the\n * runtime fallback.\n */\nexport class BrowserInvalidRequest extends Data.TaggedError(\"BrowserInvalidRequest\")<{\n  provider: string\n  param?: string\n  reason?: string\n  raw?: unknown\n}> {}\n\n/**\n * Transport could not authenticate against the provider. Subtype mirrors\n * the model-side `AiError.AuthFailed` shape for consistency.\n */\nexport type BrowserAuthSubtype = \"auth\" | \"permission\" | \"billing\" | \"quota\"\n\nexport class BrowserAuthFailed extends Data.TaggedError(\"BrowserAuthFailed\")<{\n  provider: string\n  subtype: BrowserAuthSubtype\n  raw: unknown\n}> {}\n\n/**\n * The wired provider does not implement the requested operation for these\n * inputs. Distinct from {@link BrowserInvalidRequest} (malformed request)\n * and from compile-time capability markers gating blanket provider gaps.\n */\nexport class BrowserUnsupported extends Data.TaggedError(\"BrowserUnsupported\")<{\n  provider: string\n  capability: string\n  reason?: string\n}> {}\n\nexport type BrowserError =\n  | BrowserCreateFailed\n  | BrowserSessionNotFound\n  | BrowserSessionExpired\n  | BrowserTimeout\n  | BrowserActionFailed\n  | BrowserQuotaExceeded\n  | BrowserInvalidRequest\n  | BrowserAuthFailed\n  | BrowserUnsupported\n\nconst withReason = (base: string, reason: string | undefined): string =>\n  reason === undefined ? base : `${base}: ${reason}`\n\n/**\n * Short human-readable description of an error, for logs and model-facing\n * failure messages. Prose, not a contract; branch on `_tag` instead.\n */\nexport const describe: (e: BrowserError) => string = Match.type<BrowserError>().pipe(\n  Match.discriminatorsExhaustive(\"_tag\")({\n    BrowserCreateFailed: (e) => withReason(\"the browser session could not be created\", e.reason),\n    BrowserSessionNotFound: () => \"the browser session does not exist\",\n    BrowserSessionExpired: () => \"the browser session has expired\",\n    BrowserTimeout: (e) => `the ${e.operation} operation timed out`,\n    BrowserActionFailed: (e) =>\n      withReason(\n        `the ${e.operation} failed${e.selector === undefined ? \"\" : ` on ${e.selector}`}`,\n        e.reason,\n      ),\n    BrowserQuotaExceeded: (e) => withReason(\"the browser quota is exceeded\", e.reason),\n    BrowserInvalidRequest: (e) => withReason(\"the request was invalid\", e.reason),\n    BrowserAuthFailed: (e) => `browser authentication failed (${e.subtype})`,\n    BrowserUnsupported: (e) =>\n      withReason(`this browser does not support ${e.capability}`, e.reason),\n  }),\n)\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAQA,IAAa,sBAAb,cAAyC,KAAK,YAAY,sBAAsB,CAI7E;;;;;;;AAQH,IAAa,yBAAb,cAA4C,KAAK,YAAY,yBAAyB,CAGnF;;;;;;;;AASH,IAAa,wBAAb,cAA2C,KAAK,YAAY,wBAAwB,CAGjF;;;;;;AAOH,IAAa,iBAAb,cAAoC,KAAK,YAAY,iBAAiB,CAKnE;;;;;;;AAQH,IAAa,sBAAb,cAAyC,KAAK,YAAY,sBAAsB,CAM7E;;;;;;AAOH,IAAa,uBAAb,cAA0C,KAAK,YAAY,uBAAuB,CAI/E;;;;;;AAOH,IAAa,wBAAb,cAA2C,KAAK,YAAY,wBAAwB,CAKjF;AAQH,IAAa,oBAAb,cAAuC,KAAK,YAAY,oBAAoB,CAIzE;;;;;;AAOH,IAAa,qBAAb,cAAwC,KAAK,YAAY,qBAAqB,CAI3E;AAaH,MAAM,cAAc,MAAc,WAChC,WAAW,KAAA,IAAY,OAAO,GAAG,KAAK,IAAI;;;;;AAM5C,MAAa,WAAwC,MAAM,MAAoB,CAAC,KAC9E,MAAM,yBAAyB,OAAO,CAAC;CACrC,sBAAsB,MAAM,WAAW,4CAA4C,EAAE,OAAO;CAC5F,8BAA8B;CAC9B,6BAA6B;CAC7B,iBAAiB,MAAM,OAAO,EAAE,UAAU;CAC1C,sBAAsB,MACpB,WACE,OAAO,EAAE,UAAU,SAAS,EAAE,aAAa,KAAA,IAAY,KAAK,OAAO,EAAE,cACrE,EAAE,OACH;CACH,uBAAuB,MAAM,WAAW,iCAAiC,EAAE,OAAO;CAClF,wBAAwB,MAAM,WAAW,2BAA2B,EAAE,OAAO;CAC7E,oBAAoB,MAAM,kCAAkC,EAAE,QAAQ;CACtE,qBAAqB,MACnB,WAAW,iCAAiC,EAAE,cAAc,EAAE,OAAO;CACxE,CAAC,CACH"}
+{"version":3,"file":"BrowserError.mjs","names":[],"sources":["../../src/browser/BrowserError.ts"],"sourcesContent":["import { Data, Duration, Match } from \"effect\"\n\n/**\n * Failed to provision a browser session: the transport could not connect,\n * a launched engine did not come up, or the provider refused to mint a\n * session. Provider's structured reason on `reason`; the raw transport /\n * SDK error on `raw`.\n */\nexport class BrowserCreateFailed extends Data.TaggedError(\"BrowserCreateFailed\")<{\n  provider: string\n  reason?: string\n  raw: unknown\n}> {}\n\n/**\n * The requested session id does not exist. Raised by `attach` / `destroy`\n * against a stale or never-known id. Distinct from\n * {@link BrowserSessionExpired}, which is a session that existed and has\n * since ended.\n */\nexport class BrowserSessionNotFound extends Data.TaggedError(\"BrowserSessionNotFound\")<{\n  provider: string\n  id: string\n}> {}\n\n/**\n * An operation was issued against a session that has ended: it reached its\n * max lifetime (the create-time `timeout`), was destroyed, or the provider\n * reaped it. The handle is dead; `create` or `attach` a live session.\n * Distinct from {@link BrowserTimeout} (a single live operation was too\n * slow).\n */\nexport class BrowserSessionExpired extends Data.TaggedError(\"BrowserSessionExpired\")<{\n  provider: string\n  id: string\n}> {}\n\n/**\n * A single operation exceeded its own time budget while the session was\n * still alive (a navigation that never settled, a `waitFor` selector that\n * never appeared). Carries the breached budget for observability.\n */\nexport class BrowserTimeout extends Data.TaggedError(\"BrowserTimeout\")<{\n  provider: string\n  operation: \"create\" | \"attach\" | \"navigate\" | \"action\" | \"query\"\n  budget?: Duration.Duration\n  raw?: unknown\n}> {}\n\n/**\n * An interaction or observation failed at the transport / protocol layer:\n * a selector resolved to nothing, an element was not actionable, an\n * `evaluate` script threw, a navigation errored. `selector` and `reason`\n * carry what is known.\n */\nexport class BrowserActionFailed extends Data.TaggedError(\"BrowserActionFailed\")<{\n  provider: string\n  operation: \"navigate\" | \"interact\" | \"observe\" | \"evaluate\" | \"cookies\"\n  selector?: string\n  reason?: string\n  raw: unknown\n}> {}\n\n/**\n * Provider rejected the request because an account / project quota or\n * concurrency limit was exceeded. Separate from {@link BrowserCreateFailed}\n * so callers can back off and retry.\n */\nexport class BrowserQuotaExceeded extends Data.TaggedError(\"BrowserQuotaExceeded\")<{\n  provider: string\n  reason?: string\n  raw: unknown\n}> {}\n\n/**\n * Caller's request shape is malformed for the wired provider. Adapters\n * should reject at the request-schema layer where possible; this is the\n * runtime fallback.\n */\nexport class BrowserInvalidRequest extends Data.TaggedError(\"BrowserInvalidRequest\")<{\n  provider: string\n  param?: string\n  reason?: string\n  raw?: unknown\n}> {}\n\n/**\n * Transport could not authenticate against the provider. Subtype mirrors\n * the model-side `AiError.AuthFailed` shape for consistency.\n */\nexport type BrowserAuthSubtype = \"auth\" | \"permission\" | \"billing\" | \"quota\"\n\nexport class BrowserAuthFailed extends Data.TaggedError(\"BrowserAuthFailed\")<{\n  provider: string\n  subtype: BrowserAuthSubtype\n  raw: unknown\n}> {}\n\n/**\n * The wired provider does not implement the requested operation for these\n * inputs. Distinct from {@link BrowserInvalidRequest} (malformed request)\n * and from compile-time capability markers gating blanket provider gaps.\n */\nexport class BrowserUnsupported extends Data.TaggedError(\"BrowserUnsupported\")<{\n  provider: string\n  capability: string\n  reason?: string\n}> {}\n\nexport type BrowserError =\n  | BrowserCreateFailed\n  | BrowserSessionNotFound\n  | BrowserSessionExpired\n  | BrowserTimeout\n  | BrowserActionFailed\n  | BrowserQuotaExceeded\n  | BrowserInvalidRequest\n  | BrowserAuthFailed\n  | BrowserUnsupported\n\nconst withReason = (base: string, reason: string | undefined): string =>\n  reason === undefined ? base : `${base}: ${reason}`\n\n/**\n * Short human-readable description of an error, for logs and model-facing\n * failure messages. Prose, not a contract; branch on `_tag` instead.\n */\nexport const describe: (e: BrowserError) => string = Match.type<BrowserError>().pipe(\n  Match.discriminatorsExhaustive(\"_tag\")({\n    BrowserCreateFailed: (e) => withReason(\"the browser session could not be created\", e.reason),\n    BrowserSessionNotFound: () => \"the browser session does not exist\",\n    BrowserSessionExpired: () => \"the browser session has expired\",\n    BrowserTimeout: (e) => `the ${e.operation} operation timed out`,\n    BrowserActionFailed: (e) =>\n      withReason(\n        `the ${e.operation} failed${e.selector === undefined ? \"\" : ` on ${e.selector}`}`,\n        e.reason,\n      ),\n    BrowserQuotaExceeded: (e) => withReason(\"the browser quota is exceeded\", e.reason),\n    BrowserInvalidRequest: (e) => withReason(\"the request was invalid\", e.reason),\n    BrowserAuthFailed: (e) => `browser authentication failed (${e.subtype})`,\n    BrowserUnsupported: (e) =>\n      withReason(`this browser does not support ${e.capability}`, e.reason),\n  }),\n)\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAQA,IAAa,sBAAb,cAAyC,KAAK,YAAY,qBAAqB,CAAC,CAI7E,CAAC;;;;;;;AAQJ,IAAa,yBAAb,cAA4C,KAAK,YAAY,wBAAwB,CAAC,CAGnF,CAAC;;;;;;;;AASJ,IAAa,wBAAb,cAA2C,KAAK,YAAY,uBAAuB,CAAC,CAGjF,CAAC;;;;;;AAOJ,IAAa,iBAAb,cAAoC,KAAK,YAAY,gBAAgB,CAAC,CAKnE,CAAC;;;;;;;AAQJ,IAAa,sBAAb,cAAyC,KAAK,YAAY,qBAAqB,CAAC,CAM7E,CAAC;;;;;;AAOJ,IAAa,uBAAb,cAA0C,KAAK,YAAY,sBAAsB,CAAC,CAI/E,CAAC;;;;;;AAOJ,IAAa,wBAAb,cAA2C,KAAK,YAAY,uBAAuB,CAAC,CAKjF,CAAC;AAQJ,IAAa,oBAAb,cAAuC,KAAK,YAAY,mBAAmB,CAAC,CAIzE,CAAC;;;;;;AAOJ,IAAa,qBAAb,cAAwC,KAAK,YAAY,oBAAoB,CAAC,CAI3E,CAAC;AAaJ,MAAM,cAAc,MAAc,WAChC,WAAW,KAAA,IAAY,OAAO,GAAG,KAAK,IAAI;;;;;AAM5C,MAAa,WAAwC,MAAM,KAAmB,CAAC,CAAC,KAC9E,MAAM,yBAAyB,MAAM,CAAC,CAAC;CACrC,sBAAsB,MAAM,WAAW,4CAA4C,EAAE,MAAM;CAC3F,8BAA8B;CAC9B,6BAA6B;CAC7B,iBAAiB,MAAM,OAAO,EAAE,UAAU;CAC1C,sBAAsB,MACpB,WACE,OAAO,EAAE,UAAU,SAAS,EAAE,aAAa,KAAA,IAAY,KAAK,OAAO,EAAE,cACrE,EAAE,MACJ;CACF,uBAAuB,MAAM,WAAW,iCAAiC,EAAE,MAAM;CACjF,wBAAwB,MAAM,WAAW,2BAA2B,EAAE,MAAM;CAC5E,oBAAoB,MAAM,kCAAkC,EAAE,QAAQ;CACtE,qBAAqB,MACnB,WAAW,iCAAiC,EAAE,cAAc,EAAE,MAAM;AACxE,CAAC,CACH"}

package/dist/browser/BrowserTool.d.mts

@@ -1,28 +1,25 @@
 import { BrowserError } from "./BrowserError.mjs";
 import { BrowserSession } from "./Browser.mjs";
-import { l as Tool } from "../Tool-CXFHCQrT.mjs";
-import { Schema } from "effect";
-
-//#region src/browser/BrowserTool.d.ts
+import { l as Tool } from "../Tool-DE-rnvkw.mjs";
 declare namespace BrowserTool_d_exports {
   export { browserToolkit, clickTool, fillTool, gotoTool, pressTool, scrollTool };
 }
-declare const gotoTool: (session: BrowserSession) => Tool<"browser_goto", Schema.Struct.ReadonlySide<{
-  readonly url: Schema.String;
-}, "Type">, unknown, string, BrowserError, never>;
-declare const clickTool: (session: BrowserSession) => Tool<"browser_click", Schema.Struct.ReadonlySide<{
-  readonly ref: Schema.String;
-}, "Type">, unknown, string, BrowserError, never>;
-declare const fillTool: (session: BrowserSession) => Tool<"browser_fill", Schema.Struct.ReadonlySide<{
-  readonly ref: Schema.String;
-  readonly text: Schema.String;
-}, "Type">, unknown, string, BrowserError, never>;
-declare const pressTool: (session: BrowserSession) => Tool<"browser_press", Schema.Struct.ReadonlySide<{
-  readonly key: Schema.String;
-}, "Type">, unknown, string, BrowserError, never>;
-declare const scrollTool: (session: BrowserSession) => Tool<"browser_scroll", Schema.Struct.ReadonlySide<{
-  readonly direction: Schema.Literals<readonly ["up", "down"]>;
-}, "Type">, unknown, string, BrowserError, never>;
+declare const gotoTool: (session: BrowserSession) => Tool<"browser_goto", {
+  readonly url: string;
+}, unknown, string, BrowserError, never>;
+declare const clickTool: (session: BrowserSession) => Tool<"browser_click", {
+  readonly ref: string;
+}, unknown, string, BrowserError, never>;
+declare const fillTool: (session: BrowserSession) => Tool<"browser_fill", {
+  readonly ref: string;
+  readonly text: string;
+}, unknown, string, BrowserError, never>;
+declare const pressTool: (session: BrowserSession) => Tool<"browser_press", {
+  readonly key: string;
+}, unknown, string, BrowserError, never>;
+declare const scrollTool: (session: BrowserSession) => Tool<"browser_scroll", {
+  readonly direction: "down" | "up";
+}, unknown, string, BrowserError, never>;
 /**
  * The canonical browser action verbs bundled as a `Toolkit`, closed over a
  * live `BrowserSession`. Compose it with a recipe-local page-reading tool and
@@ -37,22 +34,22 @@ declare const scrollTool: (session: BrowserSession) => Tool<"browser_scroll", Sc
  * constructors directly. Run a turn's calls with `{ concurrency: 1 }`.
  */
 declare const browserToolkit: (session: BrowserSession) => {
-  browser_goto: Tool<"browser_goto", Schema.Struct.ReadonlySide<{
-    readonly url: Schema.String;
-  }, "Type">, unknown, string, BrowserError, never>;
-  browser_click: Tool<"browser_click", Schema.Struct.ReadonlySide<{
-    readonly ref: Schema.String;
-  }, "Type">, unknown, string, BrowserError, never>;
-  browser_fill: Tool<"browser_fill", Schema.Struct.ReadonlySide<{
-    readonly ref: Schema.String;
-    readonly text: Schema.String;
-  }, "Type">, unknown, string, BrowserError, never>;
-  browser_press: Tool<"browser_press", Schema.Struct.ReadonlySide<{
-    readonly key: Schema.String;
-  }, "Type">, unknown, string, BrowserError, never>;
-  browser_scroll: Tool<"browser_scroll", Schema.Struct.ReadonlySide<{
-    readonly direction: Schema.Literals<readonly ["up", "down"]>;
-  }, "Type">, unknown, string, BrowserError, never>;
+  browser_click: Tool<"browser_click", {
+    readonly ref: string;
+  }, unknown, string, BrowserError, never>;
+  browser_fill: Tool<"browser_fill", {
+    readonly ref: string;
+    readonly text: string;
+  }, unknown, string, BrowserError, never>;
+  browser_goto: Tool<"browser_goto", {
+    readonly url: string;
+  }, unknown, string, BrowserError, never>;
+  browser_press: Tool<"browser_press", {
+    readonly key: string;
+  }, unknown, string, BrowserError, never>;
+  browser_scroll: Tool<"browser_scroll", {
+    readonly direction: "down" | "up";
+  }, unknown, string, BrowserError, never>;
 };
 //#endregion
 export { browserToolkit, clickTool, fillTool, gotoTool, pressTool, scrollTool, BrowserTool_d_exports as t };

package/dist/browser/BrowserTool.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserTool.d.mts","names":[],"sources":["../../src/browser/BrowserTool.ts"],"mappings":";;;;;;;;;cAoEa,QAAA,GAAY,OAAA,EAAS,cAAA,KAAc,IAAA,iBAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA;6BAAA,YAAA;AAAA,cAcnC,SAAA,GAAa,OAAA,EAAS,cAAA,KAAc,IAAA,kBAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA;6BAAA,YAAA;AAAA,cAcpC,QAAA,GAAY,OAAA,EAAS,cAAA,KAAc,IAAA,iBAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA;;6BAAA,YAAA;AAAA,cAenC,SAAA,GAAa,OAAA,EAAS,cAAA,KAAc,IAAA,kBAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA;6BAAA,YAAA;AAAA,cAcpC,UAAA,GAAc,OAAA,EAAS,cAAA,KAAc,IAAA,mBAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA;6BAAA,YAAA;;;;;;;;;;;;;;cA4BrC,cAAA,GAAkB,OAAA,EAAS,cAAA"}
+{"version":3,"file":"BrowserTool.d.mts","names":[],"sources":["../../src/browser/BrowserTool.ts"],"mappings":";;;;;;cAoEa,WAAQ,SAAa,mBAAc;;oBAAd;cAcrB,YAAS,SAAa,mBAAc;;oBAAd;cActB,WAAQ,SAAa,mBAAc;;;oBAAd;cAerB,YAAS,SAAa,mBAAc;;oBAAd;cActB,aAAU,SAAa,mBAAc;;oBAAd;;;;;;;;;;;;;;cA4BvB,iBAAc,SAAa;;;sBAAA"}

package/dist/browser/BrowserTool.mjs

@@ -1,4 +1,4 @@
-import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
 import { fromEffectSchema, make } from "../tool/Tool.mjs";
 import { make as make$1 } from "../tool/Toolkit.mjs";
 import { Effect, Schema } from "effect";

package/dist/browser/BrowserTool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserTool.mjs","names":["Tool.make","Tool.fromEffectSchema","Toolkit.make"],"sources":["../../src/browser/BrowserTool.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\"\nimport * as Tool from \"../tool/Tool.js\"\nimport * as Toolkit from \"../tool/Toolkit.js\"\nimport type { BrowserSession } from \"./Browser.js\"\n\n// ---------------------------------------------------------------------------\n// Model-facing argument schemas. Annotated so the descriptions reach the\n// model through the rendered JSON Schema (JSDoc does not).\n// ---------------------------------------------------------------------------\n\nconst GotoArgs = Schema.Struct({\n  url: Schema.String.annotate({ description: \"Absolute URL to navigate to.\" }),\n})\n\nconst ClickArgs = Schema.Struct({\n  ref: Schema.String.annotate({\n    description: \"A CSS selector, or an element @ref if a page-reading tool provides one.\",\n  }),\n})\n\nconst FillArgs = Schema.Struct({\n  ref: Schema.String.annotate({\n    description: \"A CSS selector (or element @ref) of the input to fill.\",\n  }),\n  text: Schema.String.annotate({ description: \"The text to put in the input.\" }),\n})\n\nconst PressArgs = Schema.Struct({\n  key: Schema.String.annotate({\n    description: 'Key to press, e.g. \"Enter\" to submit the focused input, \"Tab\", \"Escape\".',\n  }),\n})\n\nconst ScrollArgs = Schema.Struct({\n  direction: Schema.Literals([\"up\", \"down\"]).annotate({\n    description: \"Scroll the viewport up or down.\",\n  }),\n})\n\n// ---------------------------------------------------------------------------\n// Uniform action outcome: the model always learns where the action left it.\n// ---------------------------------------------------------------------------\n\nconst currentUrl = (session: BrowserSession): Effect.Effect<string> =>\n  session.evaluate(\"location.href\").pipe(\n    Effect.flatMap(Schema.decodeUnknownEffect(Schema.String)),\n    Effect.orElseSucceed(() => \"(unknown)\"),\n  )\n\nconst okAt = (session: BrowserSession): Effect.Effect<string> =>\n  Effect.map(currentUrl(session), (url) => `ok (now at ${url})`)\n\n// ---------------------------------------------------------------------------\n// The canonical browser action tools, each closed over a live `BrowserSession`\n// and failing with the full `BrowserError`. `Output` is a compact outcome\n// (`ok (now at <url>)`), not a page dump - a page-reading tool is the recipe's\n// to define, so history does not accumulate a full page per action.\n//\n// A failed action (stale ref, dead control, timeout) fails typed on the error\n// channel. Whether the model gets to recover from it is the loop's decision:\n// wrap the toolkit in `Toolkit.describeFailures(BrowserError.describe)` to\n// surface failures to the model, or map selectively to keep session/infra\n// errors (e.g. `BrowserSessionExpired`) fatal.\n//\n// Browser actions are order-dependent (fill, then press Enter): run a turn's\n// calls with `{ concurrency: 1 }`.\n// ---------------------------------------------------------------------------\n\nexport const gotoTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_goto\",\n    description: \"Navigate the browser to an absolute URL.\",\n    inputSchema: Tool.fromEffectSchema(GotoArgs),\n    run: (args) =>\n      Effect.andThen(session.goto(args.url), okAt(session)).pipe(\n        Effect.withSpan(\"browser_goto\", {\n          kind: \"client\",\n          attributes: { \"browser.url\": args.url },\n        }),\n      ),\n  })\n\nexport const clickTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_click\",\n    description: \"Click the element named by ref. A click may navigate to a new page.\",\n    inputSchema: Tool.fromEffectSchema(ClickArgs),\n    run: (args) =>\n      Effect.andThen(session.click(args.ref), okAt(session)).pipe(\n        Effect.withSpan(\"browser_click\", {\n          kind: \"client\",\n          attributes: { \"browser.ref\": args.ref },\n        }),\n      ),\n  })\n\nexport const fillTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_fill\",\n    description:\n      \"Put text into the input named by ref. Filling alone does not submit; press Enter to submit the input.\",\n    inputSchema: Tool.fromEffectSchema(FillArgs),\n    run: (args) =>\n      Effect.andThen(session.fill(args.ref, args.text), okAt(session)).pipe(\n        Effect.withSpan(\"browser_fill\", {\n          kind: \"client\",\n          attributes: { \"browser.ref\": args.ref },\n        }),\n      ),\n  })\n\nexport const pressTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_press\",\n    description: \"Press a keyboard key against the focused element.\",\n    inputSchema: Tool.fromEffectSchema(PressArgs),\n    run: (args) =>\n      Effect.andThen(session.press(args.key), okAt(session)).pipe(\n        Effect.withSpan(\"browser_press\", {\n          kind: \"client\",\n          attributes: { \"browser.key\": args.key },\n        }),\n      ),\n  })\n\nexport const scrollTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_scroll\",\n    description:\n      \"Scroll the viewport. Only useful to bring an element into view - a page-reading tool's text is already scroll-independent.\",\n    inputSchema: Tool.fromEffectSchema(ScrollArgs),\n    run: (args) =>\n      Effect.andThen(session.scroll({ direction: args.direction }), okAt(session)).pipe(\n        Effect.withSpan(\"browser_scroll\", {\n          kind: \"client\",\n          attributes: { \"browser.direction\": args.direction },\n        }),\n      ),\n  })\n\n/**\n * The canonical browser action verbs bundled as a `Toolkit`, closed over a\n * live `BrowserSession`. Compose it with a recipe-local page-reading tool and\n * whatever finish/signal tools the agent needs:\n *\n *   const toolkit = yield* Toolkit.compose(\n *     browserToolkit(session),\n *     Toolkit.make(readPageTool(session), finishTool),\n *   )\n *\n * For an à-la-carte subset, use the individual `gotoTool` / `clickTool` / …\n * constructors directly. Run a turn's calls with `{ concurrency: 1 }`.\n */\nexport const browserToolkit = (session: BrowserSession) =>\n  Toolkit.make(\n    gotoTool(session),\n    clickTool(session),\n    fillTool(session),\n    pressTool(session),\n    scrollTool(session),\n  )\n"],"mappings":";;;;;;;;;;;;;AAUA,MAAM,WAAW,OAAO,OAAO,EAC7B,KAAK,OAAO,OAAO,SAAS,EAAE,aAAa,gCAAgC,CAAC,EAC7E,CAAC;AAEF,MAAM,YAAY,OAAO,OAAO,EAC9B,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,2EACd,CAAC,EACH,CAAC;AAEF,MAAM,WAAW,OAAO,OAAO;CAC7B,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,0DACd,CAAC;CACF,MAAM,OAAO,OAAO,SAAS,EAAE,aAAa,iCAAiC,CAAC;CAC/E,CAAC;AAEF,MAAM,YAAY,OAAO,OAAO,EAC9B,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,kFACd,CAAC,EACH,CAAC;AAEF,MAAM,aAAa,OAAO,OAAO,EAC/B,WAAW,OAAO,SAAS,CAAC,MAAM,OAAO,CAAC,CAAC,SAAS,EAClD,aAAa,mCACd,CAAC,EACH,CAAC;AAMF,MAAM,cAAc,YAClB,QAAQ,SAAS,gBAAgB,CAAC,KAChC,OAAO,QAAQ,OAAO,oBAAoB,OAAO,OAAO,CAAC,EACzD,OAAO,oBAAoB,YAAY,CACxC;AAEH,MAAM,QAAQ,YACZ,OAAO,IAAI,WAAW,QAAQ,GAAG,QAAQ,cAAc,IAAI,GAAG;AAkBhE,MAAa,YAAY,YACvBA,KAAU;CACR,MAAM;CACN,aAAa;CACb,aAAaC,iBAAsB,SAAS;CAC5C,MAAM,SACJ,OAAO,QAAQ,QAAQ,KAAK,KAAK,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,KACpD,OAAO,SAAS,gBAAgB;EAC9B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,KAAK;EACxC,CAAC,CACH;CACJ,CAAC;AAEJ,MAAa,aAAa,YACxBD,KAAU;CACR,MAAM;CACN,aAAa;CACb,aAAaC,iBAAsB,UAAU;CAC7C,MAAM,SACJ,OAAO,QAAQ,QAAQ,MAAM,KAAK,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,KACrD,OAAO,SAAS,iBAAiB;EAC/B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,KAAK;EACxC,CAAC,CACH;CACJ,CAAC;AAEJ,MAAa,YAAY,YACvBD,KAAU;CACR,MAAM;CACN,aACE;CACF,aAAaC,iBAAsB,SAAS;CAC5C,MAAM,SACJ,OAAO,QAAQ,QAAQ,KAAK,KAAK,KAAK,KAAK,KAAK,EAAE,KAAK,QAAQ,CAAC,CAAC,KAC/D,OAAO,SAAS,gBAAgB;EAC9B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,KAAK;EACxC,CAAC,CACH;CACJ,CAAC;AAEJ,MAAa,aAAa,YACxBD,KAAU;CACR,MAAM;CACN,aAAa;CACb,aAAaC,iBAAsB,UAAU;CAC7C,MAAM,SACJ,OAAO,QAAQ,QAAQ,MAAM,KAAK,IAAI,EAAE,KAAK,QAAQ,CAAC,CAAC,KACrD,OAAO,SAAS,iBAAiB;EAC/B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,KAAK;EACxC,CAAC,CACH;CACJ,CAAC;AAEJ,MAAa,cAAc,YACzBD,KAAU;CACR,MAAM;CACN,aACE;CACF,aAAaC,iBAAsB,WAAW;CAC9C,MAAM,SACJ,OAAO,QAAQ,QAAQ,OAAO,EAAE,WAAW,KAAK,WAAW,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,KAC3E,OAAO,SAAS,kBAAkB;EAChC,MAAM;EACN,YAAY,EAAE,qBAAqB,KAAK,WAAW;EACpD,CAAC,CACH;CACJ,CAAC;;;;;;;;;;;;;;AAeJ,MAAa,kBAAkB,YAC7BC,OACE,SAAS,QAAQ,EACjB,UAAU,QAAQ,EAClB,SAAS,QAAQ,EACjB,UAAU,QAAQ,EAClB,WAAW,QAAQ,CACpB"}
+{"version":3,"file":"BrowserTool.mjs","names":["Tool.make","Tool.fromEffectSchema","Toolkit.make"],"sources":["../../src/browser/BrowserTool.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\"\nimport * as Tool from \"../tool/Tool.js\"\nimport * as Toolkit from \"../tool/Toolkit.js\"\nimport type { BrowserSession } from \"./Browser.js\"\n\n// ---------------------------------------------------------------------------\n// Model-facing argument schemas. Annotated so the descriptions reach the\n// model through the rendered JSON Schema (JSDoc does not).\n// ---------------------------------------------------------------------------\n\nconst GotoArgs = Schema.Struct({\n  url: Schema.String.annotate({ description: \"Absolute URL to navigate to.\" }),\n})\n\nconst ClickArgs = Schema.Struct({\n  ref: Schema.String.annotate({\n    description: \"A CSS selector, or an element @ref if a page-reading tool provides one.\",\n  }),\n})\n\nconst FillArgs = Schema.Struct({\n  ref: Schema.String.annotate({\n    description: \"A CSS selector (or element @ref) of the input to fill.\",\n  }),\n  text: Schema.String.annotate({ description: \"The text to put in the input.\" }),\n})\n\nconst PressArgs = Schema.Struct({\n  key: Schema.String.annotate({\n    description: 'Key to press, e.g. \"Enter\" to submit the focused input, \"Tab\", \"Escape\".',\n  }),\n})\n\nconst ScrollArgs = Schema.Struct({\n  direction: Schema.Literals([\"up\", \"down\"]).annotate({\n    description: \"Scroll the viewport up or down.\",\n  }),\n})\n\n// ---------------------------------------------------------------------------\n// Uniform action outcome: the model always learns where the action left it.\n// ---------------------------------------------------------------------------\n\nconst currentUrl = (session: BrowserSession): Effect.Effect<string> =>\n  session.evaluate(\"location.href\").pipe(\n    Effect.flatMap(Schema.decodeUnknownEffect(Schema.String)),\n    Effect.orElseSucceed(() => \"(unknown)\"),\n  )\n\nconst okAt = (session: BrowserSession): Effect.Effect<string> =>\n  Effect.map(currentUrl(session), (url) => `ok (now at ${url})`)\n\n// ---------------------------------------------------------------------------\n// The canonical browser action tools, each closed over a live `BrowserSession`\n// and failing with the full `BrowserError`. `Output` is a compact outcome\n// (`ok (now at <url>)`), not a page dump - a page-reading tool is the recipe's\n// to define, so history does not accumulate a full page per action.\n//\n// A failed action (stale ref, dead control, timeout) fails typed on the error\n// channel. Whether the model gets to recover from it is the loop's decision:\n// wrap the toolkit in `Toolkit.describeFailures(BrowserError.describe)` to\n// surface failures to the model, or map selectively to keep session/infra\n// errors (e.g. `BrowserSessionExpired`) fatal.\n//\n// Browser actions are order-dependent (fill, then press Enter): run a turn's\n// calls with `{ concurrency: 1 }`.\n// ---------------------------------------------------------------------------\n\nexport const gotoTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_goto\",\n    description: \"Navigate the browser to an absolute URL.\",\n    inputSchema: Tool.fromEffectSchema(GotoArgs),\n    run: (args) =>\n      Effect.andThen(session.goto(args.url), okAt(session)).pipe(\n        Effect.withSpan(\"browser_goto\", {\n          kind: \"client\",\n          attributes: { \"browser.url\": args.url },\n        }),\n      ),\n  })\n\nexport const clickTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_click\",\n    description: \"Click the element named by ref. A click may navigate to a new page.\",\n    inputSchema: Tool.fromEffectSchema(ClickArgs),\n    run: (args) =>\n      Effect.andThen(session.click(args.ref), okAt(session)).pipe(\n        Effect.withSpan(\"browser_click\", {\n          kind: \"client\",\n          attributes: { \"browser.ref\": args.ref },\n        }),\n      ),\n  })\n\nexport const fillTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_fill\",\n    description:\n      \"Put text into the input named by ref. Filling alone does not submit; press Enter to submit the input.\",\n    inputSchema: Tool.fromEffectSchema(FillArgs),\n    run: (args) =>\n      Effect.andThen(session.fill(args.ref, args.text), okAt(session)).pipe(\n        Effect.withSpan(\"browser_fill\", {\n          kind: \"client\",\n          attributes: { \"browser.ref\": args.ref },\n        }),\n      ),\n  })\n\nexport const pressTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_press\",\n    description: \"Press a keyboard key against the focused element.\",\n    inputSchema: Tool.fromEffectSchema(PressArgs),\n    run: (args) =>\n      Effect.andThen(session.press(args.key), okAt(session)).pipe(\n        Effect.withSpan(\"browser_press\", {\n          kind: \"client\",\n          attributes: { \"browser.key\": args.key },\n        }),\n      ),\n  })\n\nexport const scrollTool = (session: BrowserSession) =>\n  Tool.make({\n    name: \"browser_scroll\",\n    description:\n      \"Scroll the viewport. Only useful to bring an element into view - a page-reading tool's text is already scroll-independent.\",\n    inputSchema: Tool.fromEffectSchema(ScrollArgs),\n    run: (args) =>\n      Effect.andThen(session.scroll({ direction: args.direction }), okAt(session)).pipe(\n        Effect.withSpan(\"browser_scroll\", {\n          kind: \"client\",\n          attributes: { \"browser.direction\": args.direction },\n        }),\n      ),\n  })\n\n/**\n * The canonical browser action verbs bundled as a `Toolkit`, closed over a\n * live `BrowserSession`. Compose it with a recipe-local page-reading tool and\n * whatever finish/signal tools the agent needs:\n *\n *   const toolkit = yield* Toolkit.compose(\n *     browserToolkit(session),\n *     Toolkit.make(readPageTool(session), finishTool),\n *   )\n *\n * For an à-la-carte subset, use the individual `gotoTool` / `clickTool` / …\n * constructors directly. Run a turn's calls with `{ concurrency: 1 }`.\n */\nexport const browserToolkit = (session: BrowserSession) =>\n  Toolkit.make(\n    gotoTool(session),\n    clickTool(session),\n    fillTool(session),\n    pressTool(session),\n    scrollTool(session),\n  )\n"],"mappings":";;;;;;;;;;;;;AAUA,MAAM,WAAW,OAAO,OAAO,EAC7B,KAAK,OAAO,OAAO,SAAS,EAAE,aAAa,+BAA+B,CAAC,EAC7E,CAAC;AAED,MAAM,YAAY,OAAO,OAAO,EAC9B,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,0EACf,CAAC,EACH,CAAC;AAED,MAAM,WAAW,OAAO,OAAO;CAC7B,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,yDACf,CAAC;CACD,MAAM,OAAO,OAAO,SAAS,EAAE,aAAa,gCAAgC,CAAC;AAC/E,CAAC;AAED,MAAM,YAAY,OAAO,OAAO,EAC9B,KAAK,OAAO,OAAO,SAAS,EAC1B,aAAa,iFACf,CAAC,EACH,CAAC;AAED,MAAM,aAAa,OAAO,OAAO,EAC/B,WAAW,OAAO,SAAS,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,SAAS,EAClD,aAAa,kCACf,CAAC,EACH,CAAC;AAMD,MAAM,cAAc,YAClB,QAAQ,SAAS,eAAe,CAAC,CAAC,KAChC,OAAO,QAAQ,OAAO,oBAAoB,OAAO,MAAM,CAAC,GACxD,OAAO,oBAAoB,WAAW,CACxC;AAEF,MAAM,QAAQ,YACZ,OAAO,IAAI,WAAW,OAAO,IAAI,QAAQ,cAAc,IAAI,EAAE;AAkB/D,MAAa,YAAY,YACvBA,KAAU;CACR,MAAM;CACN,aAAa;CACb,aAAaC,iBAAsB,QAAQ;CAC3C,MAAM,SACJ,OAAO,QAAQ,QAAQ,KAAK,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KACpD,OAAO,SAAS,gBAAgB;EAC9B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,IAAI;CACxC,CAAC,CACH;AACJ,CAAC;AAEH,MAAa,aAAa,YACxBD,KAAU;CACR,MAAM;CACN,aAAa;CACb,aAAaC,iBAAsB,SAAS;CAC5C,MAAM,SACJ,OAAO,QAAQ,QAAQ,MAAM,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KACrD,OAAO,SAAS,iBAAiB;EAC/B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,IAAI;CACxC,CAAC,CACH;AACJ,CAAC;AAEH,MAAa,YAAY,YACvBD,KAAU;CACR,MAAM;CACN,aACE;CACF,aAAaC,iBAAsB,QAAQ;CAC3C,MAAM,SACJ,OAAO,QAAQ,QAAQ,KAAK,KAAK,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAC/D,OAAO,SAAS,gBAAgB;EAC9B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,IAAI;CACxC,CAAC,CACH;AACJ,CAAC;AAEH,MAAa,aAAa,YACxBD,KAAU;CACR,MAAM;CACN,aAAa;CACb,aAAaC,iBAAsB,SAAS;CAC5C,MAAM,SACJ,OAAO,QAAQ,QAAQ,MAAM,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KACrD,OAAO,SAAS,iBAAiB;EAC/B,MAAM;EACN,YAAY,EAAE,eAAe,KAAK,IAAI;CACxC,CAAC,CACH;AACJ,CAAC;AAEH,MAAa,cAAc,YACzBD,KAAU;CACR,MAAM;CACN,aACE;CACF,aAAaC,iBAAsB,UAAU;CAC7C,MAAM,SACJ,OAAO,QAAQ,QAAQ,OAAO,EAAE,WAAW,KAAK,UAAU,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAC3E,OAAO,SAAS,kBAAkB;EAChC,MAAM;EACN,YAAY,EAAE,qBAAqB,KAAK,UAAU;CACpD,CAAC,CACH;AACJ,CAAC;;;;;;;;;;;;;;AAeH,MAAa,kBAAkB,YAC7BC,OACE,SAAS,OAAO,GAChB,UAAU,OAAO,GACjB,SAAS,OAAO,GAChB,UAAU,OAAO,GACjB,WAAW,OAAO,CACpB"}

package/dist/capabilities/Capabilities.d.mts

@@ -1,6 +1,4 @@
 import { Effect } from "effect";
-
-//#region src/capabilities/Capabilities.d.ts
 declare namespace Capabilities_d_exports {
   export { CapabilityWarning, warnDropped, warnDroppedWhen };
 }
@@ -19,10 +17,14 @@ declare namespace Capabilities_d_exports {
  */
 type CapabilityWarning = {
   readonly _tag: "CapabilityWarning";
-  readonly provider: string; /** The capability name as it appears in docs (`"lyrics"`, `"bpm"`). */
-  readonly capability: string; /** The Common-request field name that was dropped. */
-  readonly field: string; /** The value the caller passed; included when useful for debugging. */
-  readonly value?: unknown; /** Human-readable explanation; should suggest a workaround. */
+  readonly provider: string;
+  /** The capability name as it appears in docs (`"lyrics"`, `"bpm"`). */
+  readonly capability: string;
+  /** The Common-request field name that was dropped. */
+  readonly field: string;
+  /** The value the caller passed; included when useful for debugging. */
+  readonly value?: unknown;
+  /** Human-readable explanation; should suggest a workaround. */
   readonly reason: string;
 };
 /**

package/dist/capabilities/Capabilities.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Capabilities.d.mts","names":[],"sources":["../../src/capabilities/Capabilities.ts"],"mappings":";;;;;;;;;;;;;;AAeA;;;;;KAAY,iBAAA;EAAA,SACD,IAAA;EAAA,SACA,QAAA,UAMA;EAAA,SAJA,UAAA,UAMM;EAAA,SAJN,KAAA,UA8BE;EAAA,SA5BF,KAAA;WAEA,MAAA;AAAA;;;;;;;;;;;AAoDX;;;;;;;;;;;;;cA1Ba,WAAA,GAAe,OAAA,EAAS,IAAA,CAAK,iBAAA,cAA6B,MAAA,CAAO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;cA0BjE,eAAA,MACX,KAAA,EAAO,CAAA,cACP,OAAA,EAAS,IAAA,CAAK,iBAAA,wBACb,MAAA,CAAO,MAAA"}
+{"version":3,"file":"Capabilities.d.mts","names":[],"sources":["../../src/capabilities/Capabilities.ts"],"mappings":";;;;;;;;;;;;;;;;;KAeY;WACD;WACA;;WAEA;;WAEA;;WAEA;;WAEA;;;;;;;;;;;;;;;;;;;;;;;;;cA0BE,cAAW,SAAa,KAAK,+BAA6B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;cA0BjE,kBAAmB,GAAC,OACxB,eAAa,SACX,KAAK,yCACb,OAAO"}

package/dist/capabilities/Capabilities.mjs

@@ -1,4 +1,4 @@
-import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
 import { Effect } from "effect";
 //#region src/capabilities/Capabilities.ts
 var Capabilities_exports = /* @__PURE__ */ __exportAll({

package/dist/capabilities/Capabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Capabilities.mjs","names":[],"sources":["../../src/capabilities/Capabilities.ts"],"sourcesContent":["import { Effect } from \"effect\"\n\n/**\n * Structured event emitted when a provider adapter drops a Common\n * request field because its wire API has no place to put it (bucket 2\n * per the capabilities policy: the provider has no structured\n * interpretation; the output is still valid, just less aligned with\n * the caller's hint).\n *\n * Carried on `Effect.logWarning` today for visibility; may be\n * promoted to a typed `AiError` variant in the future if callers need\n * to react programmatically. The shape itself is stable.\n *\n * @category capabilities\n */\nexport type CapabilityWarning = {\n  readonly _tag: \"CapabilityWarning\"\n  readonly provider: string\n  /** The capability name as it appears in docs (`\"lyrics\"`, `\"bpm\"`). */\n  readonly capability: string\n  /** The Common-request field name that was dropped. */\n  readonly field: string\n  /** The value the caller passed; included when useful for debugging. */\n  readonly value?: unknown\n  /** Human-readable explanation; should suggest a workaround. */\n  readonly reason: string\n}\n\n/**\n * Emit a structured `CapabilityWarning` via `Effect.logWarning`. Use\n * when a provider adapter receives a Common-request field it has no\n * structured wire field for, and would otherwise drop silently.\n *\n * Bucket-2 cases only (per the capabilities policy): the provider has\n * no interpretation; the output is still valid, just less aligned\n * with the caller's hint. For bucket-1 cases (structurally broken\n * output if dropped, like wrong audio format), fail\n * `AiError.Unsupported` instead.\n *\n * @example\n * ```ts\n * if (request.lyrics !== undefined) {\n *   yield* warnDropped({\n *     provider: \"lyria\",\n *     capability: \"lyrics\",\n *     field: \"lyrics\",\n *     reason: \"Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.\",\n *   })\n * }\n * ```\n */\nexport const warnDropped = (warning: Omit<CapabilityWarning, \"_tag\">): Effect.Effect<void> =>\n  Effect.logWarning(\"Capability dropped\", { ...warning, _tag: \"CapabilityWarning\" })\n\n/**\n * Shorthand for the most common shape: warn-and-drop when a specific\n * field on the Common request is set. The field's value is included\n * automatically.\n *\n * @example\n * ```ts\n * yield* Effect.all([\n *   warnDroppedWhen(request.lyrics, {\n *     provider: \"lyria\",\n *     capability: \"lyrics\",\n *     field: \"lyrics\",\n *     reason: \"Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.\",\n *   }),\n *   warnDroppedWhen(request.duration, {\n *     provider: \"lyria\",\n *     capability: \"duration\",\n *     field: \"duration\",\n *     reason: \"Lyria 3 clip is fixed at 30 s.\",\n *   }),\n * ], { discard: true })\n * ```\n */\nexport const warnDroppedWhen = <T>(\n  value: T | undefined,\n  warning: Omit<CapabilityWarning, \"_tag\" | \"value\">,\n): Effect.Effect<void> => (value === undefined ? Effect.void : warnDropped({ ...warning, value }))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,eAAe,YAC1B,OAAO,WAAW,sBAAsB;CAAE,GAAG;CAAS,MAAM;CAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyBpF,MAAa,mBACX,OACA,YACyB,UAAU,KAAA,IAAY,OAAO,OAAO,YAAY;CAAE,GAAG;CAAS;CAAO,CAAC"}
+{"version":3,"file":"Capabilities.mjs","names":[],"sources":["../../src/capabilities/Capabilities.ts"],"sourcesContent":["import { Effect } from \"effect\"\n\n/**\n * Structured event emitted when a provider adapter drops a Common\n * request field because its wire API has no place to put it (bucket 2\n * per the capabilities policy: the provider has no structured\n * interpretation; the output is still valid, just less aligned with\n * the caller's hint).\n *\n * Carried on `Effect.logWarning` today for visibility; may be\n * promoted to a typed `AiError` variant in the future if callers need\n * to react programmatically. The shape itself is stable.\n *\n * @category capabilities\n */\nexport type CapabilityWarning = {\n  readonly _tag: \"CapabilityWarning\"\n  readonly provider: string\n  /** The capability name as it appears in docs (`\"lyrics\"`, `\"bpm\"`). */\n  readonly capability: string\n  /** The Common-request field name that was dropped. */\n  readonly field: string\n  /** The value the caller passed; included when useful for debugging. */\n  readonly value?: unknown\n  /** Human-readable explanation; should suggest a workaround. */\n  readonly reason: string\n}\n\n/**\n * Emit a structured `CapabilityWarning` via `Effect.logWarning`. Use\n * when a provider adapter receives a Common-request field it has no\n * structured wire field for, and would otherwise drop silently.\n *\n * Bucket-2 cases only (per the capabilities policy): the provider has\n * no interpretation; the output is still valid, just less aligned\n * with the caller's hint. For bucket-1 cases (structurally broken\n * output if dropped, like wrong audio format), fail\n * `AiError.Unsupported` instead.\n *\n * @example\n * ```ts\n * if (request.lyrics !== undefined) {\n *   yield* warnDropped({\n *     provider: \"lyria\",\n *     capability: \"lyrics\",\n *     field: \"lyrics\",\n *     reason: \"Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.\",\n *   })\n * }\n * ```\n */\nexport const warnDropped = (warning: Omit<CapabilityWarning, \"_tag\">): Effect.Effect<void> =>\n  Effect.logWarning(\"Capability dropped\", { ...warning, _tag: \"CapabilityWarning\" })\n\n/**\n * Shorthand for the most common shape: warn-and-drop when a specific\n * field on the Common request is set. The field's value is included\n * automatically.\n *\n * @example\n * ```ts\n * yield* Effect.all([\n *   warnDroppedWhen(request.lyrics, {\n *     provider: \"lyria\",\n *     capability: \"lyrics\",\n *     field: \"lyrics\",\n *     reason: \"Lyria 3 sync has no `lyrics` wire field. Embed in your prompt instead.\",\n *   }),\n *   warnDroppedWhen(request.duration, {\n *     provider: \"lyria\",\n *     capability: \"duration\",\n *     field: \"duration\",\n *     reason: \"Lyria 3 clip is fixed at 30 s.\",\n *   }),\n * ], { discard: true })\n * ```\n */\nexport const warnDroppedWhen = <T>(\n  value: T | undefined,\n  warning: Omit<CapabilityWarning, \"_tag\" | \"value\">,\n): Effect.Effect<void> => (value === undefined ? Effect.void : warnDropped({ ...warning, value }))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,eAAe,YAC1B,OAAO,WAAW,sBAAsB;CAAE,GAAG;CAAS,MAAM;AAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AAyBnF,MAAa,mBACX,OACA,YACyB,UAAU,KAAA,IAAY,OAAO,OAAO,YAAY;CAAE,GAAG;CAAS;AAAM,CAAC"}

package/dist/dist-BaenoU1A.mjs

@@ -0,0 +1,145 @@
+import { t as __commonJSMin } from "./rolldown-runtime-EAsCxrDo.mjs";
+import "./utils-CiH_DjFW.mjs";
+//#region ../../node_modules/.pnpm/vite@7.3.2_@types+node@26.2.0_jiti@2.6.1_lightningcss@1.32.0_tsx@4.23.12_yaml@2.9.0/node_modules/vite/dist/node/module-runner.js
+let SOURCEMAPPING_URL = "sourceMa";
+SOURCEMAPPING_URL += "ppingURL";
+typeof process < "u" && process.platform;
+(async function() {}).constructor;
+var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var intToChar = /* @__PURE__ */ new Uint8Array(64);
+var charToInt = /* @__PURE__ */ new Uint8Array(128);
+for (let i = 0; i < chars.length; i++) {
+	let c = chars.charCodeAt(i);
+	intToChar[i] = c, charToInt[c] = i;
+}
+`${SOURCEMAPPING_URL}`;
+Error.prepareStackTrace;
+const customizationHookNamespace = "vite-module-runner:import-meta-resolve/v1/";
+`${JSON.stringify(customizationHookNamespace)}${JSON.stringify(customizationHookNamespace)}`;
+new Proxy({}, { get(_, p) {
+	throw Error(`[module runner] Dynamic access of "import.meta.env" is not supported. Please, use "import.meta.env.${String(p)}" instead.`);
+} });
+//#endregion
+//#region ../../node_modules/.pnpm/expect-type@1.3.0/node_modules/expect-type/dist/branding.js
+var require_branding = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+}));
+//#endregion
+//#region ../../node_modules/.pnpm/expect-type@1.3.0/node_modules/expect-type/dist/messages.js
+var require_messages = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+}));
+//#endregion
+//#region ../../node_modules/.pnpm/expect-type@1.3.0/node_modules/expect-type/dist/overloads.js
+var require_overloads = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+}));
+//#endregion
+//#region ../../node_modules/.pnpm/expect-type@1.3.0/node_modules/expect-type/dist/utils.js
+var require_utils = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+}));
+//#endregion
+//#region ../../node_modules/.pnpm/vitest@4.1.11_@types+node@26.2.0_vite@7.3.2_@types+node@26.2.0_jiti@2.6.1_lightningcss@1.32.0_tsx@4.23.12_yaml@2.9.0_/node_modules/vitest/dist/index.js
+var import_dist = (/* @__PURE__ */ __commonJSMin(((exports) => {
+	var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+		if (k2 === void 0) k2 = k;
+		var desc = Object.getOwnPropertyDescriptor(m, k);
+		if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) desc = {
+			enumerable: true,
+			get: function() {
+				return m[k];
+			}
+		};
+		Object.defineProperty(o, k2, desc);
+	}) : (function(o, m, k, k2) {
+		if (k2 === void 0) k2 = k;
+		o[k2] = m[k];
+	}));
+	var __exportStar = exports && exports.__exportStar || function(m, exports$1) {
+		for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$1, p)) __createBinding(exports$1, m, p);
+	};
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.expectTypeOf = void 0;
+	__exportStar(require_branding(), exports);
+	__exportStar(require_messages(), exports);
+	__exportStar(require_overloads(), exports);
+	__exportStar(require_utils(), exports);
+	const fn = () => true;
+	/**
+	* Similar to Jest's `expect`, but with type-awareness.
+	* Gives you access to a number of type-matchers that let you make assertions about the
+	* form of a reference or generic type parameter.
+	*
+	* @example
+	* ```ts
+	* import { foo, bar } from '../foo'
+	* import { expectTypeOf } from 'expect-type'
+	*
+	* test('foo types', () => {
+	*   // make sure `foo` has type { a: number }
+	*   expectTypeOf(foo).toMatchTypeOf({ a: 1 })
+	*   expectTypeOf(foo).toHaveProperty('a').toBeNumber()
+	*
+	*   // make sure `bar` is a function taking a string:
+	*   expectTypeOf(bar).parameter(0).toBeString()
+	*   expectTypeOf(bar).returns.not.toBeAny()
+	* })
+	* ```
+	*
+	* @description
+	* See the [full docs](https://npmjs.com/package/expect-type#documentation) for lots more examples.
+	*/
+	const expectTypeOf = (_actual) => {
+		const nonFunctionProperties = [
+			"parameters",
+			"returns",
+			"resolves",
+			"not",
+			"items",
+			"constructorParameters",
+			"thisParameter",
+			"instance",
+			"guards",
+			"asserts",
+			"branded"
+		];
+		const obj = {
+			toBeAny: fn,
+			toBeUnknown: fn,
+			toBeNever: fn,
+			toBeFunction: fn,
+			toBeObject: fn,
+			toBeArray: fn,
+			toBeString: fn,
+			toBeNumber: fn,
+			toBeBoolean: fn,
+			toBeVoid: fn,
+			toBeSymbol: fn,
+			toBeNull: fn,
+			toBeUndefined: fn,
+			toBeNullable: fn,
+			toBeBigInt: fn,
+			toMatchTypeOf: fn,
+			toEqualTypeOf: fn,
+			toBeConstructibleWith: fn,
+			toMatchObjectType: fn,
+			toExtend: fn,
+			map: exports.expectTypeOf,
+			toBeCallableWith: exports.expectTypeOf,
+			extract: exports.expectTypeOf,
+			exclude: exports.expectTypeOf,
+			pick: exports.expectTypeOf,
+			omit: exports.expectTypeOf,
+			toHaveProperty: exports.expectTypeOf,
+			parameter: exports.expectTypeOf
+		};
+		nonFunctionProperties.forEach((prop) => Object.defineProperty(obj, prop, { get: () => (0, exports.expectTypeOf)({}) }));
+		return obj;
+	};
+	exports.expectTypeOf = expectTypeOf;
+})))();
+//#endregion
+export { import_dist as t };
+
+//# sourceMappingURL=dist-BaenoU1A.mjs.map