effect-browser 0.2.0-beta.6 → 0.2.0-beta.7

package/dist/{BrowserRuntime-BBAjpVFa.d.mts → BrowserRuntime-hxkTNlRa.d.mts}

@@ -1,5 +1,5 @@
 import { BrowserError, InitializationError } from "./Errors.mjs";
-import { O as Observation, a as BrowserPolicy, b as InlineFile, c as ClickRequest, et as Viewport, n as AutomationOptions, t as ActionResult } from "./BrowserData-DPh3Oaof.mjs";
+import { O as Observation, a as BrowserPolicy, b as InlineFile, c as ClickRequest, et as Viewport, n as AutomationOptions, t as ActionResult } from "./BrowserData-KHk4o__c.mjs";
 import { BrowserSession, OpenOptions } from "./Browser.mjs";
 import { Crypto, Effect, Option, Redacted, Schema, Scope } from "effect";
 //#region src/internal/browser/ConnectionCleanup.d.ts
@@ -140,4 +140,4 @@ declare const make: (options: RuntimeOptions) => Effect.Effect<Runtime, BrowserE
 //#endregion
 export { ConnectionCleanup as _, DownloadEvent as a, noConnection as b, Lifetime as c, Runtime as d, RuntimeOptions as f, CleanupStep as g, playwright as h, Connection as i, PlaywrightOptions as l, make as m, Acquisition as n, FileRequest as o, Source as p, BrowserBinding as r, Integration as s, AcquireOptions as t, ResolvedFileSelection as u, ConnectionState as v, reported as x, cleanupStep as y };
 export {};
-//# sourceMappingURL=BrowserRuntime-BBAjpVFa.d.mts.map
+//# sourceMappingURL=BrowserRuntime-hxkTNlRa.d.mts.map

package/dist/BrowserRuntime.d.mts

@@ -1,3 +1,3 @@
-import { _ as ConnectionCleanup, a as DownloadEvent, b as noConnection, c as Lifetime, d as Runtime, f as RuntimeOptions, g as CleanupStep, h as playwright, i as Connection, l as PlaywrightOptions, m as make, n as Acquisition, o as FileRequest, p as Source, r as BrowserBinding, s as Integration, t as AcquireOptions, u as ResolvedFileSelection, v as ConnectionState, x as reported, y as cleanupStep } from "./BrowserRuntime-BBAjpVFa.mjs";
+import { _ as ConnectionCleanup, a as DownloadEvent, b as noConnection, c as Lifetime, d as Runtime, f as RuntimeOptions, g as CleanupStep, h as playwright, i as Connection, l as PlaywrightOptions, m as make, n as Acquisition, o as FileRequest, p as Source, r as BrowserBinding, s as Integration, t as AcquireOptions, u as ResolvedFileSelection, v as ConnectionState, x as reported, y as cleanupStep } from "./BrowserRuntime-hxkTNlRa.mjs";
 export { AcquireOptions, Acquisition, BrowserBinding, type CleanupStep, Connection, type ConnectionCleanup, type ConnectionState, DownloadEvent, FileRequest, Integration, Lifetime, PlaywrightOptions, ResolvedFileSelection, Runtime, RuntimeOptions, Source, cleanupStep, make, noConnection, playwright, reported };
 export {};

package/dist/BrowserRuntime.mjs

@@ -1,2 +1,2 @@
-import { a as cleanupStep, n as make, o as noConnection, r as playwright, s as reported, t as DownloadEvent } from "./BrowserRuntime-DImn_Oe_.mjs";
+import { a as cleanupStep, n as make, o as noConnection, r as playwright, s as reported, t as DownloadEvent } from "./BrowserRuntime-Cr76CN4I.mjs";
 export { DownloadEvent, cleanupStep, make, noConnection, playwright, reported };

package/dist/Capture.mjs

@@ -1,6 +1,6 @@
 import { BrowserError, Reasons } from "./Errors.mjs";
 import { PageInfo } from "./BrowserData.mjs";
-import { n as captureParent, r as jpegGeometry } from "./Association-BsSfBYVx.mjs";
+import { n as captureParent, r as jpegGeometry } from "./Association-CH3kPHXE.mjs";
 import { a as CapturedFrame, c as CaptureMaxima, i as CaptureSummary, n as CaptureSize, o as CaptureDefaults, r as CaptureSnapshot, s as CaptureLimits, t as CaptureOptions } from "./CaptureData-Dys0Ko9d.mjs";
 import { Cause, Clock, Crypto, Deferred, Effect, Exit, Option, Queue, Schema, Stream } from "effect";
 //#region src/internal/capture/FrameBuffer.ts

package/dist/CaptureData.d.mts

@@ -1,5 +1,5 @@
 import { BrowserError } from "./Errors.mjs";
-import { N as PageInfo, X as Target } from "./BrowserData-DPh3Oaof.mjs";
+import { N as PageInfo, X as Target } from "./BrowserData-KHk4o__c.mjs";
 import { Schema } from "effect";
 //#region src/CaptureData.d.ts
 /**

package/dist/Chromium.d.mts

@@ -1,5 +1,5 @@
 import { BrowserError, InitializationError } from "./Errors.mjs";
-import { a as BrowserPolicy, et as Viewport, n as AutomationOptions } from "./BrowserData-DPh3Oaof.mjs";
+import { a as BrowserPolicy, et as Viewport, n as AutomationOptions } from "./BrowserData-KHk4o__c.mjs";
 import { BrowserSession, OpenOptions } from "./Browser.mjs";
 import { Context, Crypto, Effect, Layer, Option, Redacted, Schema, Scope } from "effect";
 //#region src/internal/chromium/Data.d.ts

package/dist/Chromium.mjs

@@ -1,6 +1,6 @@
 import { BrowserError, Reasons } from "./Errors.mjs";
 import { Identifier } from "./BrowserData.mjs";
-import { a as cleanupStep, c as checked, i as randomUuid, n as make, s as reported } from "./BrowserRuntime-DImn_Oe_.mjs";
+import { a as cleanupStep, c as checked, i as randomUuid, n as make, s as reported } from "./BrowserRuntime-Cr76CN4I.mjs";
 import { Clock, Context, Crypto, Duration, Effect, Exit, Layer, Option, Path, Redacted, Schema } from "effect";
 import { spawn } from "node:child_process";
 import { mkdtemp, readFile, rm } from "node:fs/promises";

package/dist/Errors.d.mts

@@ -5,7 +5,7 @@ import { Schema } from "effect";
  * when it admits an operation, so a native step's own name can never become API, and a new
  * spelling is a deliberate edit here rather than a string that merely compiles.
  */
-export declare const BrowserOperation: Schema.Literals<readonly ["configure", "launch", "connect", "reconnect", "detach", "disconnect", "close", "handoff", "resume", "live-view", "target", "handle", "list-pages", "list-frames", "select-page", "select-frame", "new-page", "close-page", "resize", "ready", "observe", "checkpoint", "control-facts", "revalidate", "read-text", "screenshot", "wait", "navigate", "navigate-stop", "click", "fill", "fill-form", "select-option", "scroll", "click-and-wait", "download-action", "select-files", "file-chooser", "action-result", "pointer-move", "hover", "wheel", "press", "type", "page-control", "page-state", "page-suspend", "page-resume", "capture", "capture-start", "capture-stop", "capture-consume"]>;
+export declare const BrowserOperation: Schema.Literals<readonly ["configure", "launch", "connect", "reconnect", "detach", "disconnect", "close", "handoff", "resume", "live-view", "target", "handle", "list-pages", "describe-page", "list-frames", "select-page", "select-frame", "new-page", "close-page", "resize", "ready", "observe", "checkpoint", "control-facts", "revalidate", "read-text", "screenshot", "wait", "navigate", "navigate-stop", "click", "fill", "fill-form", "select-option", "scroll", "click-and-wait", "download-action", "select-files", "file-chooser", "action-result", "pointer-move", "hover", "wheel", "press", "type", "page-control", "page-state", "page-suspend", "page-resume", "capture", "capture-start", "capture-stop", "capture-consume"]>;
 export type BrowserOperation = typeof BrowserOperation.Type;
 /** Dispatch evidence belongs to the operation, independently of its failure reason. */
 export declare const BrowserOutcome: Schema.Literals<readonly ["undispatched", "rejected", "unknown"]>;
@@ -38,6 +38,7 @@ export declare const Reasons: {
   }>;
   readonly Provider: Schema.TaggedStruct<"Provider", {
     readonly status: Schema.optionalKey<Schema.Int>;
+    readonly detail: Schema.optionalKey<Schema.String>;
   }>;
   readonly Authorization: Schema.TaggedStruct<"Authorization", {}>;
   readonly RateLimited: Schema.TaggedStruct<"RateLimited", {
@@ -69,6 +70,7 @@ export declare const BrowserReason: Schema.Union<(Schema.TaggedStruct<"Active",
   readonly path: Schema.optionalKey<Schema.String>;
 }> | Schema.TaggedStruct<"NotFocused", {}> | Schema.TaggedStruct<"NotFound", {}> | Schema.TaggedStruct<"NotVisible", {}> | Schema.TaggedStruct<"Provider", {
   readonly status: Schema.optionalKey<Schema.Int>;
+  readonly detail: Schema.optionalKey<Schema.String>;
 }> | Schema.TaggedStruct<"RateLimited", {
   readonly retryAfterMillis: Schema.optionalKey<Schema.Natural>;
 }> | Schema.TaggedStruct<"Resized", {}> | Schema.TaggedStruct<"Stale", {}> | Schema.TaggedStruct<"TargetChanged", {}> | Schema.TaggedStruct<"Timeout", {}> | Schema.TaggedStruct<"Timestamp", {}> | Schema.TaggedStruct<"Transport", {
@@ -76,7 +78,7 @@ export declare const BrowserReason: Schema.Union<(Schema.TaggedStruct<"Active",
 }> | Schema.TaggedStruct<"UnregisteredSession", {}> | Schema.TaggedStruct<"UnsafeUrl", {}> | Schema.TaggedStruct<"Unsupported", {}>)[]>;
 export type BrowserReason = typeof BrowserReason.Type;
 declare const BrowserError_base: Schema.Class<BrowserError, Schema.TaggedStruct<"BrowserError", {
-  readonly operation: Schema.Literals<readonly ["configure", "launch", "connect", "reconnect", "detach", "disconnect", "close", "handoff", "resume", "live-view", "target", "handle", "list-pages", "list-frames", "select-page", "select-frame", "new-page", "close-page", "resize", "ready", "observe", "checkpoint", "control-facts", "revalidate", "read-text", "screenshot", "wait", "navigate", "navigate-stop", "click", "fill", "fill-form", "select-option", "scroll", "click-and-wait", "download-action", "select-files", "file-chooser", "action-result", "pointer-move", "hover", "wheel", "press", "type", "page-control", "page-state", "page-suspend", "page-resume", "capture", "capture-start", "capture-stop", "capture-consume"]>;
+  readonly operation: Schema.Literals<readonly ["configure", "launch", "connect", "reconnect", "detach", "disconnect", "close", "handoff", "resume", "live-view", "target", "handle", "list-pages", "describe-page", "list-frames", "select-page", "select-frame", "new-page", "close-page", "resize", "ready", "observe", "checkpoint", "control-facts", "revalidate", "read-text", "screenshot", "wait", "navigate", "navigate-stop", "click", "fill", "fill-form", "select-option", "scroll", "click-and-wait", "download-action", "select-files", "file-chooser", "action-result", "pointer-move", "hover", "wheel", "press", "type", "page-control", "page-state", "page-suspend", "page-resume", "capture", "capture-start", "capture-stop", "capture-consume"]>;
   readonly reason: Schema.Union<(Schema.TaggedStruct<"Active", {}> | Schema.TaggedStruct<"Ambiguous", {}> | Schema.TaggedStruct<"Authorization", {}> | Schema.TaggedStruct<"Busy", {}> | Schema.TaggedStruct<"Closed", {}> | Schema.TaggedStruct<"Configuration", {
     readonly path: Schema.optionalKey<Schema.String>;
   }> | Schema.TaggedStruct<"ContentType", {}> | Schema.TaggedStruct<"ContextLease", {}> | Schema.TaggedStruct<"Denied", {}> | Schema.TaggedStruct<"Disabled", {}> | Schema.TaggedStruct<"Disconnected", {}> | Schema.TaggedStruct<"Expired", {}> | Schema.TaggedStruct<"Failed", {}> | Schema.TaggedStruct<"Interrupted", {}> | Schema.TaggedStruct<"Limit", {
@@ -87,6 +89,7 @@ declare const BrowserError_base: Schema.Class<BrowserError, Schema.TaggedStruct<
     readonly path: Schema.optionalKey<Schema.String>;
   }> | Schema.TaggedStruct<"NotFocused", {}> | Schema.TaggedStruct<"NotFound", {}> | Schema.TaggedStruct<"NotVisible", {}> | Schema.TaggedStruct<"Provider", {
     readonly status: Schema.optionalKey<Schema.Int>;
+    readonly detail: Schema.optionalKey<Schema.String>;
   }> | Schema.TaggedStruct<"RateLimited", {
     readonly retryAfterMillis: Schema.optionalKey<Schema.Natural>;
   }> | Schema.TaggedStruct<"Resized", {}> | Schema.TaggedStruct<"Stale", {}> | Schema.TaggedStruct<"TargetChanged", {}> | Schema.TaggedStruct<"Timeout", {}> | Schema.TaggedStruct<"Timestamp", {}> | Schema.TaggedStruct<"Transport", {

package/dist/Errors.mjs

@@ -19,6 +19,7 @@ const BrowserOperation = Schema.Literals([
 	"target",
 	"handle",
 	"list-pages",
+	"describe-page",
 	"list-frames",
 	"select-page",
 	"select-frame",
@@ -85,6 +86,11 @@ const LimitDimension = Schema.Literals([
 	"pixels"
 ]);
 const SchemaPath = Schema.String.check(Schema.isMaxLength(512));
+/**
+* What the native engine said about a failure it raised: its first line, without escape codes,
+* with every address cut to its origin. A host diagnostic, never part of the model projection.
+*/
+const NativeDetail = Schema.String.check(Schema.isMaxLength(512));
 /** Validated constructors for host reasons. The model receives a separate bounded projection. */
 const Reasons = {
 	Configuration: Schema.TaggedStruct("Configuration", { path: Schema.optionalKey(SchemaPath) }),
@@ -103,7 +109,10 @@ const Reasons = {
 	}),
 	Timeout: Schema.TaggedStruct("Timeout", {}),
 	Transport: Schema.TaggedStruct("Transport", { status: Schema.optionalKey(Schema.Int) }),
-	Provider: Schema.TaggedStruct("Provider", { status: Schema.optionalKey(Schema.Int) }),
+	Provider: Schema.TaggedStruct("Provider", {
+		status: Schema.optionalKey(Schema.Int),
+		detail: Schema.optionalKey(NativeDetail)
+	}),
 	Authorization: Schema.TaggedStruct("Authorization", {}),
 	RateLimited: Schema.TaggedStruct("RateLimited", { retryAfterMillis: Schema.optionalKey(Schema.Natural) }),
 	Disconnected: Schema.TaggedStruct("Disconnected", {}),

package/dist/Errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Errors.mjs","names":[],"sources":["../src/Errors.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\n/**\n * What a caller asked the owned browser to do. The vocabulary is closed: the owner stamps it\n * when it admits an operation, so a native step's own name can never become API, and a new\n * spelling is a deliberate edit here rather than a string that merely compiles.\n */\nexport const BrowserOperation = Schema.Literals([\n  // configuration and lifetime\n  \"configure\",\n  \"launch\",\n  \"connect\",\n  \"reconnect\",\n  \"detach\",\n  \"disconnect\",\n  \"close\",\n  \"handoff\",\n  \"resume\",\n  \"live-view\",\n  // targets\n  \"target\",\n  \"handle\",\n  \"list-pages\",\n  \"list-frames\",\n  \"select-page\",\n  \"select-frame\",\n  \"new-page\",\n  \"close-page\",\n  \"resize\",\n  // reading\n  \"ready\",\n  \"observe\",\n  \"checkpoint\",\n  \"control-facts\",\n  \"revalidate\",\n  \"read-text\",\n  \"screenshot\",\n  \"wait\",\n  // input\n  \"navigate\",\n  \"navigate-stop\",\n  \"click\",\n  \"fill\",\n  \"fill-form\",\n  \"select-option\",\n  \"scroll\",\n  \"click-and-wait\",\n  \"download-action\",\n  \"select-files\",\n  \"file-chooser\",\n  \"action-result\",\n  // native pointer input\n  \"pointer-move\",\n  \"hover\",\n  \"wheel\",\n  // native key input\n  \"press\",\n  \"type\",\n  // page control\n  \"page-control\",\n  \"page-state\",\n  \"page-suspend\",\n  \"page-resume\",\n  // capture\n  \"capture\",\n  \"capture-start\",\n  \"capture-stop\",\n  \"capture-consume\",\n]);\n\nexport type BrowserOperation = typeof BrowserOperation.Type;\n\n/** Dispatch evidence belongs to the operation, independently of its failure reason. */\nexport const BrowserOutcome = Schema.Literals([\"undispatched\", \"rejected\", \"unknown\"]);\n\nexport type BrowserOutcome = typeof BrowserOutcome.Type;\n\n/** Limits report measured producer facts; an unavailable measurement is never invented. */\nexport const LimitDimension = Schema.Literals([\n  \"actions\",\n  \"elapsed\",\n  \"returned-bytes\",\n  \"pages\",\n  \"frames\",\n  \"frame-depth\",\n  \"buffered-frames\",\n  \"buffered-bytes\",\n  \"host-reads\",\n  \"controls\",\n  \"text\",\n  \"captures\",\n  \"frame-bytes\",\n  \"width\",\n  \"height\",\n  \"pixels\",\n]);\n\nconst SchemaPath = Schema.String.check(Schema.isMaxLength(512));\n\n/** Validated constructors for host reasons. The model receives a separate bounded projection. */\nexport const Reasons = {\n  Configuration: Schema.TaggedStruct(\"Configuration\", { path: Schema.optionalKey(SchemaPath) }),\n  UnregisteredSession: Schema.TaggedStruct(\"UnregisteredSession\", {}),\n  Unsupported: Schema.TaggedStruct(\"Unsupported\", {}),\n  Busy: Schema.TaggedStruct(\"Busy\", {}),\n  Closed: Schema.TaggedStruct(\"Closed\", {}),\n  Stale: Schema.TaggedStruct(\"Stale\", {}),\n  NotFound: Schema.TaggedStruct(\"NotFound\", {}),\n  Ambiguous: Schema.TaggedStruct(\"Ambiguous\", {}),\n  Malformed: Schema.TaggedStruct(\"Malformed\", { path: Schema.optionalKey(SchemaPath) }),\n  Limit: Schema.TaggedStruct(\"Limit\", {\n    dimension: LimitDimension,\n    maximum: Schema.Natural,\n    observed: Schema.Natural,\n  }),\n  Timeout: Schema.TaggedStruct(\"Timeout\", {}),\n  Transport: Schema.TaggedStruct(\"Transport\", { status: Schema.optionalKey(Schema.Int) }),\n  Provider: Schema.TaggedStruct(\"Provider\", { status: Schema.optionalKey(Schema.Int) }),\n  Authorization: Schema.TaggedStruct(\"Authorization\", {}),\n  RateLimited: Schema.TaggedStruct(\"RateLimited\", {\n    retryAfterMillis: Schema.optionalKey(Schema.Natural),\n  }),\n  Disconnected: Schema.TaggedStruct(\"Disconnected\", {}),\n  Active: Schema.TaggedStruct(\"Active\", {}),\n  Disabled: Schema.TaggedStruct(\"Disabled\", {}),\n  Expired: Schema.TaggedStruct(\"Expired\", {}),\n  Failed: Schema.TaggedStruct(\"Failed\", {}),\n  UnsafeUrl: Schema.TaggedStruct(\"UnsafeUrl\", {}),\n  ContentType: Schema.TaggedStruct(\"ContentType\", {}),\n  Timestamp: Schema.TaggedStruct(\"Timestamp\", {}),\n  Resized: Schema.TaggedStruct(\"Resized\", {}),\n  TargetChanged: Schema.TaggedStruct(\"TargetChanged\", {}),\n  Interrupted: Schema.TaggedStruct(\"Interrupted\", {}),\n  ContextLease: Schema.TaggedStruct(\"ContextLease\", {}),\n  NotVisible: Schema.TaggedStruct(\"NotVisible\", {}),\n  Denied: Schema.TaggedStruct(\"Denied\", {}),\n  NotFocused: Schema.TaggedStruct(\"NotFocused\", {}),\n} as const;\n\nexport const BrowserReason = Schema.Union(Object.values(Reasons));\n\nexport type BrowserReason = typeof BrowserReason.Type;\n\nexport class BrowserError extends Schema.TaggedError<BrowserError>()(\"BrowserError\", {\n  operation: BrowserOperation,\n  reason: BrowserReason,\n  outcome: BrowserOutcome,\n}) {}\n\nexport class InitializationError extends Schema.TaggedError<InitializationError>()(\n  \"InitializationError\",\n  {\n    operation: Schema.Literals([\"configure\", \"register\", \"ready\", \"callback\", \"dispose\"]),\n    step: Schema.String.check(Schema.isMaxLength(128)),\n    reason: Schema.Literals([\n      \"configuration\",\n      \"unsupported\",\n      \"origin\",\n      \"stale\",\n      \"busy\",\n      \"closed\",\n      \"timeout\",\n      \"input\",\n      \"output\",\n      \"native\",\n    ]),\n  },\n) {}\n"],"mappings":";;;;;;;AAOA,MAAa,mBAAmB,OAAO,SAAS;CAE9C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;AACF,CAAC;;AAKD,MAAa,iBAAiB,OAAO,SAAS;CAAC;CAAgB;CAAY;AAAS,CAAC;;AAKrF,MAAa,iBAAiB,OAAO,SAAS;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAM,aAAa,OAAO,OAAO,MAAM,OAAO,YAAY,GAAG,CAAC;;AAG9D,MAAa,UAAU;CACrB,eAAe,OAAO,aAAa,iBAAiB,EAAE,MAAM,OAAO,YAAY,UAAU,EAAE,CAAC;CAC5F,qBAAqB,OAAO,aAAa,uBAAuB,CAAC,CAAC;CAClE,aAAa,OAAO,aAAa,eAAe,CAAC,CAAC;CAClD,MAAM,OAAO,aAAa,QAAQ,CAAC,CAAC;CACpC,QAAQ,OAAO,aAAa,UAAU,CAAC,CAAC;CACxC,OAAO,OAAO,aAAa,SAAS,CAAC,CAAC;CACtC,UAAU,OAAO,aAAa,YAAY,CAAC,CAAC;CAC5C,WAAW,OAAO,aAAa,aAAa,CAAC,CAAC;CAC9C,WAAW,OAAO,aAAa,aAAa,EAAE,MAAM,OAAO,YAAY,UAAU,EAAE,CAAC;CACpF,OAAO,OAAO,aAAa,SAAS;EAClC,WAAW;EACX,SAAS,OAAO;EAChB,UAAU,OAAO;CACnB,CAAC;CACD,SAAS,OAAO,aAAa,WAAW,CAAC,CAAC;CAC1C,WAAW,OAAO,aAAa,aAAa,EAAE,QAAQ,OAAO,YAAY,OAAO,GAAG,EAAE,CAAC;CACtF,UAAU,OAAO,aAAa,YAAY,EAAE,QAAQ,OAAO,YAAY,OAAO,GAAG,EAAE,CAAC;CACpF,eAAe,OAAO,aAAa,iBAAiB,CAAC,CAAC;CACtD,aAAa,OAAO,aAAa,eAAe,EAC9C,kBAAkB,OAAO,YAAY,OAAO,OAAO,EACrD,CAAC;CACD,cAAc,OAAO,aAAa,gBAAgB,CAAC,CAAC;CACpD,QAAQ,OAAO,aAAa,UAAU,CAAC,CAAC;CACxC,UAAU,OAAO,aAAa,YAAY,CAAC,CAAC;CAC5C,SAAS,OAAO,aAAa,WAAW,CAAC,CAAC;CAC1C,QAAQ,OAAO,aAAa,UAAU,CAAC,CAAC;CACxC,WAAW,OAAO,aAAa,aAAa,CAAC,CAAC;CAC9C,aAAa,OAAO,aAAa,eAAe,CAAC,CAAC;CAClD,WAAW,OAAO,aAAa,aAAa,CAAC,CAAC;CAC9C,SAAS,OAAO,aAAa,WAAW,CAAC,CAAC;CAC1C,eAAe,OAAO,aAAa,iBAAiB,CAAC,CAAC;CACtD,aAAa,OAAO,aAAa,eAAe,CAAC,CAAC;CAClD,cAAc,OAAO,aAAa,gBAAgB,CAAC,CAAC;CACpD,YAAY,OAAO,aAAa,cAAc,CAAC,CAAC;CAChD,QAAQ,OAAO,aAAa,UAAU,CAAC,CAAC;CACxC,YAAY,OAAO,aAAa,cAAc,CAAC,CAAC;AAClD;AAEA,MAAa,gBAAgB,OAAO,MAAM,OAAO,OAAO,OAAO,CAAC;AAIhE,IAAa,eAAb,cAAkC,OAAO,YAA0B,CAAC,CAAC,gBAAgB;CACnF,WAAW;CACX,QAAQ;CACR,SAAS;AACX,CAAC,CAAC,CAAC,CAAC;AAEJ,IAAa,sBAAb,cAAyC,OAAO,YAAiC,CAAC,CAChF,uBACA;CACE,WAAW,OAAO,SAAS;EAAC;EAAa;EAAY;EAAS;EAAY;CAAS,CAAC;CACpF,MAAM,OAAO,OAAO,MAAM,OAAO,YAAY,GAAG,CAAC;CACjD,QAAQ,OAAO,SAAS;EACtB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;AACH,CACF,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Errors.mjs","names":[],"sources":["../src/Errors.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\n/**\n * What a caller asked the owned browser to do. The vocabulary is closed: the owner stamps it\n * when it admits an operation, so a native step's own name can never become API, and a new\n * spelling is a deliberate edit here rather than a string that merely compiles.\n */\nexport const BrowserOperation = Schema.Literals([\n  // configuration and lifetime\n  \"configure\",\n  \"launch\",\n  \"connect\",\n  \"reconnect\",\n  \"detach\",\n  \"disconnect\",\n  \"close\",\n  \"handoff\",\n  \"resume\",\n  \"live-view\",\n  // targets\n  \"target\",\n  \"handle\",\n  \"list-pages\",\n  \"describe-page\",\n  \"list-frames\",\n  \"select-page\",\n  \"select-frame\",\n  \"new-page\",\n  \"close-page\",\n  \"resize\",\n  // reading\n  \"ready\",\n  \"observe\",\n  \"checkpoint\",\n  \"control-facts\",\n  \"revalidate\",\n  \"read-text\",\n  \"screenshot\",\n  \"wait\",\n  // input\n  \"navigate\",\n  \"navigate-stop\",\n  \"click\",\n  \"fill\",\n  \"fill-form\",\n  \"select-option\",\n  \"scroll\",\n  \"click-and-wait\",\n  \"download-action\",\n  \"select-files\",\n  \"file-chooser\",\n  \"action-result\",\n  // native pointer input\n  \"pointer-move\",\n  \"hover\",\n  \"wheel\",\n  // native key input\n  \"press\",\n  \"type\",\n  // page control\n  \"page-control\",\n  \"page-state\",\n  \"page-suspend\",\n  \"page-resume\",\n  // capture\n  \"capture\",\n  \"capture-start\",\n  \"capture-stop\",\n  \"capture-consume\",\n]);\n\nexport type BrowserOperation = typeof BrowserOperation.Type;\n\n/** Dispatch evidence belongs to the operation, independently of its failure reason. */\nexport const BrowserOutcome = Schema.Literals([\"undispatched\", \"rejected\", \"unknown\"]);\n\nexport type BrowserOutcome = typeof BrowserOutcome.Type;\n\n/** Limits report measured producer facts; an unavailable measurement is never invented. */\nexport const LimitDimension = Schema.Literals([\n  \"actions\",\n  \"elapsed\",\n  \"returned-bytes\",\n  \"pages\",\n  \"frames\",\n  \"frame-depth\",\n  \"buffered-frames\",\n  \"buffered-bytes\",\n  \"host-reads\",\n  \"controls\",\n  \"text\",\n  \"captures\",\n  \"frame-bytes\",\n  \"width\",\n  \"height\",\n  \"pixels\",\n]);\n\nconst SchemaPath = Schema.String.check(Schema.isMaxLength(512));\n\n/**\n * What the native engine said about a failure it raised: its first line, without escape codes,\n * with every address cut to its origin. A host diagnostic, never part of the model projection.\n */\nconst NativeDetail = Schema.String.check(Schema.isMaxLength(512));\n\n/** Validated constructors for host reasons. The model receives a separate bounded projection. */\nexport const Reasons = {\n  Configuration: Schema.TaggedStruct(\"Configuration\", { path: Schema.optionalKey(SchemaPath) }),\n  UnregisteredSession: Schema.TaggedStruct(\"UnregisteredSession\", {}),\n  Unsupported: Schema.TaggedStruct(\"Unsupported\", {}),\n  Busy: Schema.TaggedStruct(\"Busy\", {}),\n  Closed: Schema.TaggedStruct(\"Closed\", {}),\n  Stale: Schema.TaggedStruct(\"Stale\", {}),\n  NotFound: Schema.TaggedStruct(\"NotFound\", {}),\n  Ambiguous: Schema.TaggedStruct(\"Ambiguous\", {}),\n  Malformed: Schema.TaggedStruct(\"Malformed\", { path: Schema.optionalKey(SchemaPath) }),\n  Limit: Schema.TaggedStruct(\"Limit\", {\n    dimension: LimitDimension,\n    maximum: Schema.Natural,\n    observed: Schema.Natural,\n  }),\n  Timeout: Schema.TaggedStruct(\"Timeout\", {}),\n  Transport: Schema.TaggedStruct(\"Transport\", { status: Schema.optionalKey(Schema.Int) }),\n  Provider: Schema.TaggedStruct(\"Provider\", {\n    status: Schema.optionalKey(Schema.Int),\n    detail: Schema.optionalKey(NativeDetail),\n  }),\n  Authorization: Schema.TaggedStruct(\"Authorization\", {}),\n  RateLimited: Schema.TaggedStruct(\"RateLimited\", {\n    retryAfterMillis: Schema.optionalKey(Schema.Natural),\n  }),\n  Disconnected: Schema.TaggedStruct(\"Disconnected\", {}),\n  Active: Schema.TaggedStruct(\"Active\", {}),\n  Disabled: Schema.TaggedStruct(\"Disabled\", {}),\n  Expired: Schema.TaggedStruct(\"Expired\", {}),\n  Failed: Schema.TaggedStruct(\"Failed\", {}),\n  UnsafeUrl: Schema.TaggedStruct(\"UnsafeUrl\", {}),\n  ContentType: Schema.TaggedStruct(\"ContentType\", {}),\n  Timestamp: Schema.TaggedStruct(\"Timestamp\", {}),\n  Resized: Schema.TaggedStruct(\"Resized\", {}),\n  TargetChanged: Schema.TaggedStruct(\"TargetChanged\", {}),\n  Interrupted: Schema.TaggedStruct(\"Interrupted\", {}),\n  ContextLease: Schema.TaggedStruct(\"ContextLease\", {}),\n  NotVisible: Schema.TaggedStruct(\"NotVisible\", {}),\n  Denied: Schema.TaggedStruct(\"Denied\", {}),\n  NotFocused: Schema.TaggedStruct(\"NotFocused\", {}),\n} as const;\n\nexport const BrowserReason = Schema.Union(Object.values(Reasons));\n\nexport type BrowserReason = typeof BrowserReason.Type;\n\nexport class BrowserError extends Schema.TaggedError<BrowserError>()(\"BrowserError\", {\n  operation: BrowserOperation,\n  reason: BrowserReason,\n  outcome: BrowserOutcome,\n}) {}\n\nexport class InitializationError extends Schema.TaggedError<InitializationError>()(\n  \"InitializationError\",\n  {\n    operation: Schema.Literals([\"configure\", \"register\", \"ready\", \"callback\", \"dispose\"]),\n    step: Schema.String.check(Schema.isMaxLength(128)),\n    reason: Schema.Literals([\n      \"configuration\",\n      \"unsupported\",\n      \"origin\",\n      \"stale\",\n      \"busy\",\n      \"closed\",\n      \"timeout\",\n      \"input\",\n      \"output\",\n      \"native\",\n    ]),\n  },\n) {}\n"],"mappings":"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"}

package/dist/PageControl.d.mts

@@ -1,5 +1,5 @@
 import { BrowserError } from "./Errors.mjs";
-import { M as PageExecutionState, N as PageInfo, P as PageSuspension } from "./BrowserData-DPh3Oaof.mjs";
+import { M as PageExecutionState, N as PageInfo, P as PageSuspension } from "./BrowserData-KHk4o__c.mjs";
 import { BrowserSession } from "./Browser.mjs";
 import { Effect } from "effect";
 //#region src/PageControl.d.ts

package/dist/Testing.d.mts

@@ -1,7 +1,7 @@
 import { BrowserError, BrowserOperation, BrowserOutcome, BrowserReason, InitializationError } from "./Errors.mjs";
-import { a as BrowserPolicy, et as Viewport, n as AutomationOptions, nt as ViewportPoint } from "./BrowserData-DPh3Oaof.mjs";
+import { a as BrowserPolicy, et as Viewport, n as AutomationOptions, nt as ViewportPoint } from "./BrowserData-KHk4o__c.mjs";
 import { BrowserSession, OpenOptions } from "./Browser.mjs";
-import { r as BrowserBinding } from "./BrowserRuntime-BBAjpVFa.mjs";
+import { r as BrowserBinding } from "./BrowserRuntime-hxkTNlRa.mjs";
 import { Crypto, Effect, Layer, Option, Schema, Scope } from "effect";
 //#region src/internal/testing/Frame.d.ts
 /** A valid 64×48 baseline JPEG, the bytes a scripted capture frame carries by default. */
@@ -196,7 +196,7 @@ export declare class ScriptedCleanupResult extends ScriptedCleanupResult_base {}
  * The operations whose next call a test may script. `disconnect` is the owner's native teardown
  * of a connection: a `Fail` makes it fail and a `Hold` parks it, however long cleanup waits.
  */
-export declare const ScriptableOperation: Schema.Literals<("capture-stop" | "checkpoint" | "click" | "click-and-wait" | "close-page" | "control-facts" | "disconnect" | "download-action" | "file-chooser" | "fill" | "fill-form" | "hover" | "list-frames" | "list-pages" | "navigate" | "navigate-stop" | "new-page" | "observe" | "page-resume" | "page-suspend" | "pointer-move" | "press" | "read-text" | "resize" | "revalidate" | "screenshot" | "scroll" | "select-files" | "select-frame" | "select-option" | "select-page" | "type" | "wait" | "wheel")[]>;
+export declare const ScriptableOperation: Schema.Literals<("capture-stop" | "checkpoint" | "click" | "click-and-wait" | "close-page" | "control-facts" | "describe-page" | "disconnect" | "download-action" | "file-chooser" | "fill" | "fill-form" | "hover" | "list-frames" | "list-pages" | "navigate" | "navigate-stop" | "new-page" | "observe" | "page-resume" | "page-suspend" | "pointer-move" | "press" | "read-text" | "resize" | "revalidate" | "screenshot" | "scroll" | "select-files" | "select-frame" | "select-option" | "select-page" | "type" | "wait" | "wheel")[]>;
 export type ScriptableOperation = typeof ScriptableOperation.Type;
 /** A held native call: the test learns that it arrived, then decides when it may finish. */
 interface Gate {

package/dist/Testing.mjs

@@ -1,6 +1,6 @@
 import { BrowserError, InitializationError, Reasons } from "./Errors.mjs";
 import { BrowserPolicy, ControlFacts, FrameInfo, Identifier, ObservedControl, PageExecutionState, PageInfo, PageSuspension, SafeFilename, TargetUrl, ViewportEvidence, ViewportRect } from "./BrowserData.mjs";
-import { a as cleanupStep, c as checked, l as fromNativeAttempt, n as make, s as reported, u as issueBinding } from "./BrowserRuntime-DImn_Oe_.mjs";
+import { a as cleanupStep, c as checked, l as fromNativeAttempt, n as make, s as reported, u as issueBinding } from "./BrowserRuntime-Cr76CN4I.mjs";
 import { Crypto, Effect, Layer, Option, PlatformError, Redacted, Schema } from "effect";
 //#region src/internal/testing/Crypto.ts
 /**
@@ -170,6 +170,7 @@ const ScriptableOperation = Schema.Literals([
 	"press",
 	"type",
 	"list-pages",
+	"describe-page",
 	"list-frames",
 	"select-page",
 	"select-frame",
@@ -447,6 +448,22 @@ const makeScriptedBrowser = (script, timers) => {
 		const invalidateSnapshot = (scope = "all") => {
 			if (snapshot !== void 0 && scope !== "none" && (scope === "all" || scope.pageId === snapshot.pageId)) snapshot.validity = "invalid";
 		};
+		/** The page closes as a browser closes it: every connection learns, and nothing on it lasts. */
+		const close = (target) => {
+			target.closed = true;
+			target.navigation?.drop();
+			target.capture?.start.invalidate("target-changed");
+			target.capture = void 0;
+			notify(target);
+			if (selectedId === target.pageId) select(void 0);
+			invalidateSnapshot({ pageId: target.pageId });
+			events.invalidate("target-changed", { pageId: target.pageId });
+			for (const other of live) {
+				if (other === connection) continue;
+				other.retire(target.pageId);
+				other.announce(target.pageId);
+			}
+		};
 		/** This connection ends: what it held on the browser's pages ends with it. */
 		const dropConnection = (announce, ended = "dropped") => {
 			if (disconnected) return;
@@ -904,6 +921,7 @@ const makeScriptedBrowser = (script, timers) => {
 			},
 			selectedTargetId: async () => selectedPage().targetId,
 			listPages: (ticket) => attempt("list-pages", ticket, {}, async () => openPages().map(info)),
+			describePage: (page, ticket) => attempt("describe-page", ticket, { pageId: page.pageId }, async () => info(pageOf(page, "describe-page"))),
 			resolvePage: async (page, ticket) => {
 				ticket.check();
 				const target = pageOf(page, "target");
@@ -932,19 +950,15 @@ const makeScriptedBrowser = (script, timers) => {
 			closePage: (page, ticket) => attempt("close-page", ticket, { pageId: page.pageId }, async (record) => {
 				const target = pageOf(page, "close-page");
 				dispatch(ticket, record);
-				target.closed = true;
-				target.navigation?.drop();
-				target.capture?.start.invalidate("target-changed");
-				target.capture = void 0;
-				notify(target);
-				if (selectedId === target.pageId) select(void 0);
-				invalidateSnapshot({ pageId: target.pageId });
-				events.invalidate("target-changed", { pageId: target.pageId });
-				for (const other of live) {
-					if (other === connection) continue;
-					other.retire(target.pageId);
-					other.announce(target.pageId);
-				}
+				close(target);
+			}),
+			containPage: (pageId) => attempt("close-page", void 0, { pageId }, async (record) => {
+				const target = pages.get(pageId);
+				if (target === void 0 || target.closed) return;
+				const outcome = take("close-page");
+				record.dispatched = true;
+				if (outcome?._tag === "Fail") throw fail("close-page", outcome.reason, outcome.outcome);
+				close(target);
 			}),
 			listFrames: (ticket, page) => attempt("list-frames", ticket, {}, async () => [frameInfo(page === void 0 ? selectedPage("list-frames") : pageOf(page, "list-frames"))]),
 			resolveFrame: async (page, frame, ticket) => {