effect-agent 0.1.0-beta.85 → 0.1.0-beta.87

package/dist/sandbox/InteractiveBrowser.d.mts

@@ -0,0 +1,142 @@
+import { p as SandboxImplementation } from "../Sandbox-CEsDWBLq.mjs";
+import { s as PageScreenshotResult } from "../PageScreenshot-BpgZKAxl.mjs";
+import { Context, Effect, Schema, Scope } from "effect";
+declare namespace InteractiveBrowser_d_exports {
+  export { BrowserActionResult, BrowserClickRequest, BrowserFillRequest, BrowserHandle, BrowserNavigateRequest, BrowserNavigationResult, BrowserReadTextRequest, BrowserScreenshotRequest, BrowserScrollRequest, BrowserTextResult, InteractiveBrowser, InteractiveBrowserActionError, InteractiveBrowserBusyError, InteractiveBrowserCapacityError, InteractiveBrowserError, InteractiveBrowserExpiredError, InteractiveBrowserHost, InteractiveBrowserLimitError, InteractiveBrowserNetworkPolicy, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError, InteractiveBrowserProtocolError, InteractiveBrowserTargetUrl, InteractiveBrowserUnsupportedError };
+}
+/** Absolute, bounded HTTP(S) navigation URL without embedded credentials. */
+declare const InteractiveBrowserTargetUrl: Schema.NonEmptyString;
+type InteractiveBrowserTargetUrl = typeof InteractiveBrowserTargetUrl.Type;
+/** Canonical HTTPS host authority, optionally carrying a non-default port. */
+declare const InteractiveBrowserHost: Schema.NonEmptyString;
+type InteractiveBrowserHost = typeof InteractiveBrowserHost.Type;
+/**
+ * ExactHosts retains the page-request URL allowlist, not a public-network boundary.
+ * PublicWeb requires connection-time public-address enforcement for all session
+ * traffic, including human navigation. Adapters that cannot enforce it must fail
+ * with InteractiveBrowserUnsupportedError before acquiring a browser.
+ * Unrestricted explicitly opts out of URL/host and private-network containment.
+ */
+declare const InteractiveBrowserNetworkPolicy: Schema.Union<readonly [Schema.TaggedStruct<"ExactHosts", {
+  readonly allowedHosts: Schema.$Array<Schema.NonEmptyString>;
+}>, Schema.TaggedStruct<"PublicWeb", {}>, Schema.TaggedStruct<"Unrestricted", {}>]>;
+type InteractiveBrowserNetworkPolicy = typeof InteractiveBrowserNetworkPolicy.Type;
+declare const InteractiveBrowserPolicy_base: Schema.Class<InteractiveBrowserPolicy, Schema.Struct<{
+  readonly network: Schema.Union<readonly [Schema.TaggedStruct<"ExactHosts", {
+    readonly allowedHosts: Schema.$Array<Schema.NonEmptyString>;
+  }>, Schema.TaggedStruct<"PublicWeb", {}>, Schema.TaggedStruct<"Unrestricted", {}>]>;
+  readonly maxActions: Schema.Int;
+  readonly maxElapsedMillis: Schema.Int;
+  readonly maxReturnedBytes: Schema.Int;
+}>, {}>;
+/** Finite per-pass budgets. The elapsed ceiling is one hour; provider idle limits may be shorter. */
+declare class InteractiveBrowserPolicy extends InteractiveBrowserPolicy_base {}
+declare const BrowserNavigateRequest_base: Schema.Class<BrowserNavigateRequest, Schema.Struct<{
+  readonly url: Schema.NonEmptyString;
+}>, {}>;
+declare class BrowserNavigateRequest extends BrowserNavigateRequest_base {}
+declare const BrowserReadTextRequest_base: Schema.Class<BrowserReadTextRequest, Schema.Struct<{
+  readonly selector: Schema.optionalKey<Schema.NonEmptyString>;
+}>, {}>;
+declare class BrowserReadTextRequest extends BrowserReadTextRequest_base {}
+declare const BrowserFillRequest_base: Schema.Class<BrowserFillRequest, Schema.Struct<{
+  readonly selector: Schema.NonEmptyString;
+  readonly value: Schema.String;
+}>, {}>;
+declare class BrowserFillRequest extends BrowserFillRequest_base {}
+declare const BrowserClickRequest_base: Schema.Class<BrowserClickRequest, Schema.Struct<{
+  readonly selector: Schema.NonEmptyString;
+}>, {}>;
+declare class BrowserClickRequest extends BrowserClickRequest_base {}
+declare const BrowserScreenshotRequest_base: Schema.Class<BrowserScreenshotRequest, Schema.Struct<{
+  readonly fullPage: Schema.Boolean;
+}>, {}>;
+/** Capture the current page without navigating or opening another browser. */
+declare class BrowserScreenshotRequest extends BrowserScreenshotRequest_base {}
+declare const BrowserScrollRequest_base: Schema.Class<BrowserScrollRequest, Schema.Struct<{
+  readonly deltaX: Schema.Int;
+  readonly deltaY: Schema.Int;
+}>, {}>;
+/** Scroll the current viewport by signed CSS pixel deltas. */
+declare class BrowserScrollRequest extends BrowserScrollRequest_base {}
+declare const BrowserNavigationResult_base: Schema.Class<BrowserNavigationResult, Schema.Struct<{
+  readonly url: Schema.NonEmptyString;
+}>, {}>;
+declare class BrowserNavigationResult extends BrowserNavigationResult_base {}
+declare const BrowserTextResult_base: Schema.Class<BrowserTextResult, Schema.Struct<{
+  readonly text: Schema.String;
+}>, {}>;
+declare class BrowserTextResult extends BrowserTextResult_base {}
+declare const BrowserActionResult_base: Schema.Class<BrowserActionResult, Schema.Struct<{
+  readonly url: Schema.NonEmptyString;
+}>, {}>;
+/** Post-action URL observation; no provider session state crosses this boundary. */
+declare class BrowserActionResult extends BrowserActionResult_base {}
+declare const InteractiveBrowserPolicyDeniedError_base: Schema.Class<InteractiveBrowserPolicyDeniedError, Schema.TaggedStruct<"InteractiveBrowserPolicyDeniedError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserPolicyDeniedError extends InteractiveBrowserPolicyDeniedError_base {}
+declare const InteractiveBrowserBusyError_base: Schema.Class<InteractiveBrowserBusyError, Schema.TaggedStruct<"InteractiveBrowserBusyError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserBusyError extends InteractiveBrowserBusyError_base {}
+declare const InteractiveBrowserCapacityError_base: Schema.Class<InteractiveBrowserCapacityError, Schema.TaggedStruct<"InteractiveBrowserCapacityError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserCapacityError extends InteractiveBrowserCapacityError_base {}
+declare const InteractiveBrowserExpiredError_base: Schema.Class<InteractiveBrowserExpiredError, Schema.TaggedStruct<"InteractiveBrowserExpiredError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserExpiredError extends InteractiveBrowserExpiredError_base {}
+declare const InteractiveBrowserActionError_base: Schema.Class<InteractiveBrowserActionError, Schema.TaggedStruct<"InteractiveBrowserActionError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly operation: Schema.Literals<readonly ["navigate", "read-text", "fill", "click", "screenshot", "scroll", "close"]>;
+  readonly message: Schema.String;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserActionError extends InteractiveBrowserActionError_base {}
+declare const InteractiveBrowserProtocolError_base: Schema.Class<InteractiveBrowserProtocolError, Schema.TaggedStruct<"InteractiveBrowserProtocolError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly message: Schema.String;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserProtocolError extends InteractiveBrowserProtocolError_base {}
+declare const InteractiveBrowserLimitError_base: Schema.Class<InteractiveBrowserLimitError, Schema.TaggedStruct<"InteractiveBrowserLimitError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly limit: Schema.Literals<readonly ["actions", "elapsed", "returned-bytes"]>;
+  readonly maximum: Schema.Int;
+  readonly observed: Schema.Natural;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserLimitError extends InteractiveBrowserLimitError_base {}
+declare const InteractiveBrowserUnsupportedError_base: Schema.Class<InteractiveBrowserUnsupportedError, Schema.TaggedStruct<"InteractiveBrowserUnsupportedError", {
+  readonly implementation: typeof SandboxImplementation;
+  readonly feature: Schema.Literals<readonly ["navigation", "read-text", "fill", "click", "screenshot", "scroll", "policy"]>;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class InteractiveBrowserUnsupportedError extends InteractiveBrowserUnsupportedError_base {}
+declare const InteractiveBrowserError: Schema.Union<readonly [typeof InteractiveBrowserPolicyDeniedError, typeof InteractiveBrowserBusyError, typeof InteractiveBrowserCapacityError, typeof InteractiveBrowserExpiredError, typeof InteractiveBrowserActionError, typeof InteractiveBrowserProtocolError, typeof InteractiveBrowserLimitError, typeof InteractiveBrowserUnsupportedError]>;
+type InteractiveBrowserError = typeof InteractiveBrowserError.Type;
+/** A live handle is intentionally not a Schema value and cannot cross persistence/transport boundaries. */
+interface BrowserHandle {
+  readonly navigate: (request: BrowserNavigateRequest) => Effect.Effect<BrowserNavigationResult, InteractiveBrowserError>;
+  readonly readText: (request: BrowserReadTextRequest) => Effect.Effect<BrowserTextResult, InteractiveBrowserError>;
+  readonly fill: (request: BrowserFillRequest) => Effect.Effect<BrowserActionResult, InteractiveBrowserError>;
+  readonly click: (request: BrowserClickRequest) => Effect.Effect<BrowserActionResult, InteractiveBrowserError>;
+  /** PNG bytes are caller-owned and bounded by the pass's per-result byte limit. */
+  readonly screenshot: (request: BrowserScreenshotRequest) => Effect.Effect<PageScreenshotResult, InteractiveBrowserError>;
+  readonly scroll: (request: BrowserScrollRequest) => Effect.Effect<BrowserActionResult, InteractiveBrowserError>;
+  /** Invalidate the handle and close its resources early, including after an interrupted action. */
+  readonly close: Effect.Effect<void, InteractiveBrowserError>;
+}
+declare const InteractiveBrowser_base: Context.ServiceClass<InteractiveBrowser, "@effect-agent/sandbox/InteractiveBrowser", {
+  readonly open: (policy: InteractiveBrowserPolicy) => Effect.Effect<BrowserHandle, InteractiveBrowserError, Scope.Scope>;
+}>;
+declare class InteractiveBrowser extends InteractiveBrowser_base {}
+//#endregion
+export { BrowserActionResult, BrowserClickRequest, BrowserFillRequest, BrowserHandle, BrowserNavigateRequest, BrowserNavigationResult, BrowserReadTextRequest, BrowserScreenshotRequest, BrowserScrollRequest, BrowserTextResult, InteractiveBrowser, InteractiveBrowserActionError, InteractiveBrowserBusyError, InteractiveBrowserCapacityError, InteractiveBrowserError, InteractiveBrowserExpiredError, InteractiveBrowserHost, InteractiveBrowserLimitError, InteractiveBrowserNetworkPolicy, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError, InteractiveBrowserProtocolError, InteractiveBrowserTargetUrl, InteractiveBrowserUnsupportedError, InteractiveBrowser_d_exports as t };
+//# sourceMappingURL=InteractiveBrowser.d.mts.map

package/dist/sandbox/InteractiveBrowser.mjs

@@ -0,0 +1,165 @@
+import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
+import { SandboxImplementation } from "./Sandbox.mjs";
+import { Context, Option, Schema } from "effect";
+//#region src/sandbox/InteractiveBrowser.ts
+var InteractiveBrowser_exports = /* @__PURE__ */ __exportAll({
+	BrowserActionResult: () => BrowserActionResult,
+	BrowserClickRequest: () => BrowserClickRequest,
+	BrowserFillRequest: () => BrowserFillRequest,
+	BrowserNavigateRequest: () => BrowserNavigateRequest,
+	BrowserNavigationResult: () => BrowserNavigationResult,
+	BrowserReadTextRequest: () => BrowserReadTextRequest,
+	BrowserScreenshotRequest: () => BrowserScreenshotRequest,
+	BrowserScrollRequest: () => BrowserScrollRequest,
+	BrowserTextResult: () => BrowserTextResult,
+	InteractiveBrowser: () => InteractiveBrowser,
+	InteractiveBrowserActionError: () => InteractiveBrowserActionError,
+	InteractiveBrowserBusyError: () => InteractiveBrowserBusyError,
+	InteractiveBrowserCapacityError: () => InteractiveBrowserCapacityError,
+	InteractiveBrowserError: () => InteractiveBrowserError,
+	InteractiveBrowserExpiredError: () => InteractiveBrowserExpiredError,
+	InteractiveBrowserHost: () => InteractiveBrowserHost,
+	InteractiveBrowserLimitError: () => InteractiveBrowserLimitError,
+	InteractiveBrowserNetworkPolicy: () => InteractiveBrowserNetworkPolicy,
+	InteractiveBrowserPolicy: () => InteractiveBrowserPolicy,
+	InteractiveBrowserPolicyDeniedError: () => InteractiveBrowserPolicyDeniedError,
+	InteractiveBrowserProtocolError: () => InteractiveBrowserProtocolError,
+	InteractiveBrowserTargetUrl: () => InteractiveBrowserTargetUrl,
+	InteractiveBrowserUnsupportedError: () => InteractiveBrowserUnsupportedError
+});
+const PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));
+const BoundedText = Schema.String.check(Schema.isMaxLength(8388608));
+const BoundedMessage = Schema.String.check(Schema.isMaxLength(8192));
+const Selector = Schema.NonEmptyString.check(Schema.isMaxLength(1024));
+const FieldValue = Schema.String.check(Schema.isMaxLength(65536));
+const ScrollDelta = Schema.Int.check(Schema.isBetween({
+	minimum: -1e5,
+	maximum: 1e5
+}));
+const decodeUrl = Schema.decodeUnknownOption(Schema.URLFromString);
+/** Absolute, bounded HTTP(S) navigation URL without embedded credentials. */
+const InteractiveBrowserTargetUrl = Schema.NonEmptyString.check(Schema.isMaxLength(8192), Schema.makeFilter((value) => {
+	const parsed = decodeUrl(value);
+	if (Option.isNone(parsed)) return false;
+	const url = parsed.value;
+	return (url.protocol === "http:" || url.protocol === "https:") && url.hostname !== "" && url.username === "" && url.password === "";
+}, { title: "an absolute HTTP or HTTPS URL without embedded credentials" }));
+/** Canonical HTTPS host authority, optionally carrying a non-default port. */
+const InteractiveBrowserHost = Schema.NonEmptyString.check(Schema.isMaxLength(255), Schema.makeFilter((value) => {
+	if (value.includes("*")) return false;
+	const parsed = decodeUrl(`https://${value}/`);
+	if (Option.isNone(parsed)) return false;
+	const url = parsed.value;
+	return url.protocol === "https:" && url.username === "" && url.password === "" && url.host === value;
+}, { title: "a canonical credential-free HTTPS host authority" }));
+/**
+* ExactHosts retains the page-request URL allowlist, not a public-network boundary.
+* PublicWeb requires connection-time public-address enforcement for all session
+* traffic, including human navigation. Adapters that cannot enforce it must fail
+* with InteractiveBrowserUnsupportedError before acquiring a browser.
+* Unrestricted explicitly opts out of URL/host and private-network containment.
+*/
+const InteractiveBrowserNetworkPolicy = Schema.Union([
+	Schema.TaggedStruct("ExactHosts", { allowedHosts: Schema.Array(InteractiveBrowserHost).check(Schema.isMinLength(1), Schema.isMaxLength(64), Schema.isUnique()) }),
+	Schema.TaggedStruct("PublicWeb", {}),
+	Schema.TaggedStruct("Unrestricted", {})
+]).pipe(Schema.annotate({ parseOptions: { onExcessProperty: "error" } }));
+/** Finite per-pass budgets. The elapsed ceiling is one hour; provider idle limits may be shorter. */
+var InteractiveBrowserPolicy = class extends Schema.Class("InteractiveBrowserPolicy")(Schema.Struct({
+	network: InteractiveBrowserNetworkPolicy,
+	maxActions: PositiveInt.check(Schema.isLessThanOrEqualTo(1e3)),
+	maxElapsedMillis: PositiveInt.check(Schema.isLessThanOrEqualTo(36e5)),
+	maxReturnedBytes: PositiveInt.check(Schema.isLessThanOrEqualTo(8388608))
+}).pipe(Schema.annotate({ parseOptions: { onExcessProperty: "error" } }))) {};
+var BrowserNavigateRequest = class extends Schema.Class("BrowserNavigateRequest")({ url: InteractiveBrowserTargetUrl }) {};
+var BrowserReadTextRequest = class extends Schema.Class("BrowserReadTextRequest")({ selector: Schema.optionalKey(Selector) }) {};
+var BrowserFillRequest = class extends Schema.Class("BrowserFillRequest")({
+	selector: Selector,
+	value: FieldValue
+}) {};
+var BrowserClickRequest = class extends Schema.Class("BrowserClickRequest")({ selector: Selector }) {};
+/** Capture the current page without navigating or opening another browser. */
+var BrowserScreenshotRequest = class extends Schema.Class("BrowserScreenshotRequest")({ fullPage: Schema.Boolean }) {};
+/** Scroll the current viewport by signed CSS pixel deltas. */
+var BrowserScrollRequest = class extends Schema.Class("BrowserScrollRequest")({
+	deltaX: ScrollDelta,
+	deltaY: ScrollDelta
+}) {};
+var BrowserNavigationResult = class extends Schema.Class("BrowserNavigationResult")({ url: InteractiveBrowserTargetUrl }) {};
+var BrowserTextResult = class extends Schema.Class("BrowserTextResult")({ text: BoundedText }) {};
+/** Post-action URL observation; no provider session state crosses this boundary. */
+var BrowserActionResult = class extends Schema.Class("BrowserActionResult")({ url: InteractiveBrowserTargetUrl }) {};
+var InteractiveBrowserPolicyDeniedError = class extends Schema.TaggedError()("InteractiveBrowserPolicyDeniedError", {
+	implementation: SandboxImplementation,
+	message: BoundedMessage
+}) {};
+var InteractiveBrowserBusyError = class extends Schema.TaggedError()("InteractiveBrowserBusyError", {
+	implementation: SandboxImplementation,
+	message: BoundedMessage
+}) {};
+var InteractiveBrowserCapacityError = class extends Schema.TaggedError()("InteractiveBrowserCapacityError", {
+	implementation: SandboxImplementation,
+	message: BoundedMessage
+}) {};
+var InteractiveBrowserExpiredError = class extends Schema.TaggedError()("InteractiveBrowserExpiredError", {
+	implementation: SandboxImplementation,
+	message: BoundedMessage
+}) {};
+var InteractiveBrowserActionError = class extends Schema.TaggedError()("InteractiveBrowserActionError", {
+	implementation: SandboxImplementation,
+	operation: Schema.Literals([
+		"navigate",
+		"read-text",
+		"fill",
+		"click",
+		"screenshot",
+		"scroll",
+		"close"
+	]),
+	message: BoundedMessage,
+	cause: Schema.optionalKey(Schema.Defect())
+}) {};
+var InteractiveBrowserProtocolError = class extends Schema.TaggedError()("InteractiveBrowserProtocolError", {
+	implementation: SandboxImplementation,
+	message: BoundedMessage,
+	cause: Schema.optionalKey(Schema.Defect())
+}) {};
+var InteractiveBrowserLimitError = class extends Schema.TaggedError()("InteractiveBrowserLimitError", {
+	implementation: SandboxImplementation,
+	limit: Schema.Literals([
+		"actions",
+		"elapsed",
+		"returned-bytes"
+	]),
+	maximum: PositiveInt,
+	observed: Schema.Natural,
+	message: BoundedMessage
+}) {};
+var InteractiveBrowserUnsupportedError = class extends Schema.TaggedError()("InteractiveBrowserUnsupportedError", {
+	implementation: SandboxImplementation,
+	feature: Schema.Literals([
+		"navigation",
+		"read-text",
+		"fill",
+		"click",
+		"screenshot",
+		"scroll",
+		"policy"
+	]),
+	message: BoundedMessage
+}) {};
+const InteractiveBrowserError = Schema.Union([
+	InteractiveBrowserPolicyDeniedError,
+	InteractiveBrowserBusyError,
+	InteractiveBrowserCapacityError,
+	InteractiveBrowserExpiredError,
+	InteractiveBrowserActionError,
+	InteractiveBrowserProtocolError,
+	InteractiveBrowserLimitError,
+	InteractiveBrowserUnsupportedError
+]);
+var InteractiveBrowser = class extends Context.Service()("@effect-agent/sandbox/InteractiveBrowser") {};
+//#endregion
+export { BrowserActionResult, BrowserClickRequest, BrowserFillRequest, BrowserNavigateRequest, BrowserNavigationResult, BrowserReadTextRequest, BrowserScreenshotRequest, BrowserScrollRequest, BrowserTextResult, InteractiveBrowser, InteractiveBrowserActionError, InteractiveBrowserBusyError, InteractiveBrowserCapacityError, InteractiveBrowserError, InteractiveBrowserExpiredError, InteractiveBrowserHost, InteractiveBrowserLimitError, InteractiveBrowserNetworkPolicy, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError, InteractiveBrowserProtocolError, InteractiveBrowserTargetUrl, InteractiveBrowserUnsupportedError, InteractiveBrowser_exports as t };
+
+//# sourceMappingURL=InteractiveBrowser.mjs.map

package/dist/sandbox/InteractiveBrowser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractiveBrowser.mjs","names":[],"sources":["../../src/sandbox/InteractiveBrowser.ts"],"sourcesContent":["import { Context, Option, Schema, type Effect, type Scope } from \"effect\";\n\nimport type { PageScreenshotResult } from \"./PageScreenshot.ts\";\nimport { SandboxImplementation } from \"./Sandbox.ts\";\n\nconst PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));\nconst BoundedText = Schema.String.check(Schema.isMaxLength(8 * 1024 * 1024));\nconst BoundedMessage = Schema.String.check(Schema.isMaxLength(8 * 1024));\nconst Selector = Schema.NonEmptyString.check(Schema.isMaxLength(1_024));\nconst FieldValue = Schema.String.check(Schema.isMaxLength(64 * 1024));\nconst ScrollDelta = Schema.Int.check(Schema.isBetween({ minimum: -100_000, maximum: 100_000 }));\nconst decodeUrl = Schema.decodeUnknownOption(Schema.URLFromString);\n\n/** Absolute, bounded HTTP(S) navigation URL without embedded credentials. */\nexport const InteractiveBrowserTargetUrl = Schema.NonEmptyString.check(\n  Schema.isMaxLength(8 * 1024),\n  Schema.makeFilter(\n    (value) => {\n      const parsed = decodeUrl(value);\n\n      if (Option.isNone(parsed)) return false;\n      const url = parsed.value;\n\n      return (\n        (url.protocol === \"http:\" || url.protocol === \"https:\") &&\n        url.hostname !== \"\" &&\n        url.username === \"\" &&\n        url.password === \"\"\n      );\n    },\n    { title: \"an absolute HTTP or HTTPS URL without embedded credentials\" },\n  ),\n);\n\nexport type InteractiveBrowserTargetUrl = typeof InteractiveBrowserTargetUrl.Type;\n\n/** Canonical HTTPS host authority, optionally carrying a non-default port. */\nexport const InteractiveBrowserHost = Schema.NonEmptyString.check(\n  Schema.isMaxLength(255),\n  Schema.makeFilter(\n    (value) => {\n      if (value.includes(\"*\")) return false;\n      const parsed = decodeUrl(`https://${value}/`);\n\n      if (Option.isNone(parsed)) return false;\n      const url = parsed.value;\n\n      return (\n        url.protocol === \"https:\" &&\n        url.username === \"\" &&\n        url.password === \"\" &&\n        url.host === value\n      );\n    },\n    { title: \"a canonical credential-free HTTPS host authority\" },\n  ),\n);\n\nexport type InteractiveBrowserHost = typeof InteractiveBrowserHost.Type;\n\n/**\n * ExactHosts retains the page-request URL allowlist, not a public-network boundary.\n * PublicWeb requires connection-time public-address enforcement for all session\n * traffic, including human navigation. Adapters that cannot enforce it must fail\n * with InteractiveBrowserUnsupportedError before acquiring a browser.\n * Unrestricted explicitly opts out of URL/host and private-network containment.\n */\nexport const InteractiveBrowserNetworkPolicy = Schema.Union([\n  Schema.TaggedStruct(\"ExactHosts\", {\n    allowedHosts: Schema.Array(InteractiveBrowserHost).check(\n      Schema.isMinLength(1),\n      Schema.isMaxLength(64),\n      Schema.isUnique(),\n    ),\n  }),\n  Schema.TaggedStruct(\"PublicWeb\", {}),\n  Schema.TaggedStruct(\"Unrestricted\", {}),\n]).pipe(Schema.annotate({ parseOptions: { onExcessProperty: \"error\" } }));\n\nexport type InteractiveBrowserNetworkPolicy = typeof InteractiveBrowserNetworkPolicy.Type;\n\n/** Finite per-pass budgets. The elapsed ceiling is one hour; provider idle limits may be shorter. */\nexport class InteractiveBrowserPolicy extends Schema.Class<InteractiveBrowserPolicy>(\n  \"InteractiveBrowserPolicy\",\n)(\n  Schema.Struct({\n    network: InteractiveBrowserNetworkPolicy,\n    maxActions: PositiveInt.check(Schema.isLessThanOrEqualTo(1_000)),\n    maxElapsedMillis: PositiveInt.check(Schema.isLessThanOrEqualTo(60 * 60_000)),\n    maxReturnedBytes: PositiveInt.check(Schema.isLessThanOrEqualTo(8 * 1024 * 1024)),\n  }).pipe(Schema.annotate({ parseOptions: { onExcessProperty: \"error\" } })),\n) {}\n\nexport class BrowserNavigateRequest extends Schema.Class<BrowserNavigateRequest>(\n  \"BrowserNavigateRequest\",\n)({ url: InteractiveBrowserTargetUrl }) {}\n\nexport class BrowserReadTextRequest extends Schema.Class<BrowserReadTextRequest>(\n  \"BrowserReadTextRequest\",\n)({ selector: Schema.optionalKey(Selector) }) {}\n\nexport class BrowserFillRequest extends Schema.Class<BrowserFillRequest>(\"BrowserFillRequest\")({\n  selector: Selector,\n  value: FieldValue,\n}) {}\n\nexport class BrowserClickRequest extends Schema.Class<BrowserClickRequest>(\"BrowserClickRequest\")({\n  selector: Selector,\n}) {}\n\n/** Capture the current page without navigating or opening another browser. */\nexport class BrowserScreenshotRequest extends Schema.Class<BrowserScreenshotRequest>(\n  \"BrowserScreenshotRequest\",\n)({ fullPage: Schema.Boolean }) {}\n\n/** Scroll the current viewport by signed CSS pixel deltas. */\nexport class BrowserScrollRequest extends Schema.Class<BrowserScrollRequest>(\n  \"BrowserScrollRequest\",\n)({\n  deltaX: ScrollDelta,\n  deltaY: ScrollDelta,\n}) {}\n\nexport class BrowserNavigationResult extends Schema.Class<BrowserNavigationResult>(\n  \"BrowserNavigationResult\",\n)({ url: InteractiveBrowserTargetUrl }) {}\n\nexport class BrowserTextResult extends Schema.Class<BrowserTextResult>(\"BrowserTextResult\")({\n  text: BoundedText,\n}) {}\n\n/** Post-action URL observation; no provider session state crosses this boundary. */\nexport class BrowserActionResult extends Schema.Class<BrowserActionResult>(\"BrowserActionResult\")({\n  url: InteractiveBrowserTargetUrl,\n}) {}\n\nexport class InteractiveBrowserPolicyDeniedError extends Schema.TaggedError<InteractiveBrowserPolicyDeniedError>()(\n  \"InteractiveBrowserPolicyDeniedError\",\n  { implementation: SandboxImplementation, message: BoundedMessage },\n) {}\n\nexport class InteractiveBrowserBusyError extends Schema.TaggedError<InteractiveBrowserBusyError>()(\n  \"InteractiveBrowserBusyError\",\n  { implementation: SandboxImplementation, message: BoundedMessage },\n) {}\n\nexport class InteractiveBrowserCapacityError extends Schema.TaggedError<InteractiveBrowserCapacityError>()(\n  \"InteractiveBrowserCapacityError\",\n  { implementation: SandboxImplementation, message: BoundedMessage },\n) {}\n\nexport class InteractiveBrowserExpiredError extends Schema.TaggedError<InteractiveBrowserExpiredError>()(\n  \"InteractiveBrowserExpiredError\",\n  { implementation: SandboxImplementation, message: BoundedMessage },\n) {}\n\nexport class InteractiveBrowserActionError extends Schema.TaggedError<InteractiveBrowserActionError>()(\n  \"InteractiveBrowserActionError\",\n  {\n    implementation: SandboxImplementation,\n    operation: Schema.Literals([\n      \"navigate\",\n      \"read-text\",\n      \"fill\",\n      \"click\",\n      \"screenshot\",\n      \"scroll\",\n      \"close\",\n    ]),\n    message: BoundedMessage,\n    cause: Schema.optionalKey(Schema.Defect()),\n  },\n) {}\n\nexport class InteractiveBrowserProtocolError extends Schema.TaggedError<InteractiveBrowserProtocolError>()(\n  \"InteractiveBrowserProtocolError\",\n  {\n    implementation: SandboxImplementation,\n    message: BoundedMessage,\n    cause: Schema.optionalKey(Schema.Defect()),\n  },\n) {}\n\nexport class InteractiveBrowserLimitError extends Schema.TaggedError<InteractiveBrowserLimitError>()(\n  \"InteractiveBrowserLimitError\",\n  {\n    implementation: SandboxImplementation,\n    limit: Schema.Literals([\"actions\", \"elapsed\", \"returned-bytes\"]),\n    maximum: PositiveInt,\n    observed: Schema.Natural,\n    message: BoundedMessage,\n  },\n) {}\n\nexport class InteractiveBrowserUnsupportedError extends Schema.TaggedError<InteractiveBrowserUnsupportedError>()(\n  \"InteractiveBrowserUnsupportedError\",\n  {\n    implementation: SandboxImplementation,\n    feature: Schema.Literals([\n      \"navigation\",\n      \"read-text\",\n      \"fill\",\n      \"click\",\n      \"screenshot\",\n      \"scroll\",\n      \"policy\",\n    ]),\n    message: BoundedMessage,\n  },\n) {}\n\nexport const InteractiveBrowserError = Schema.Union([\n  InteractiveBrowserPolicyDeniedError,\n  InteractiveBrowserBusyError,\n  InteractiveBrowserCapacityError,\n  InteractiveBrowserExpiredError,\n  InteractiveBrowserActionError,\n  InteractiveBrowserProtocolError,\n  InteractiveBrowserLimitError,\n  InteractiveBrowserUnsupportedError,\n]);\n\nexport type InteractiveBrowserError = typeof InteractiveBrowserError.Type;\n\n/** A live handle is intentionally not a Schema value and cannot cross persistence/transport boundaries. */\nexport interface BrowserHandle {\n  readonly navigate: (\n    request: BrowserNavigateRequest,\n  ) => Effect.Effect<BrowserNavigationResult, InteractiveBrowserError>;\n  readonly readText: (\n    request: BrowserReadTextRequest,\n  ) => Effect.Effect<BrowserTextResult, InteractiveBrowserError>;\n  readonly fill: (\n    request: BrowserFillRequest,\n  ) => Effect.Effect<BrowserActionResult, InteractiveBrowserError>;\n  readonly click: (\n    request: BrowserClickRequest,\n  ) => Effect.Effect<BrowserActionResult, InteractiveBrowserError>;\n  /** PNG bytes are caller-owned and bounded by the pass's per-result byte limit. */\n  readonly screenshot: (\n    request: BrowserScreenshotRequest,\n  ) => Effect.Effect<PageScreenshotResult, InteractiveBrowserError>;\n  readonly scroll: (\n    request: BrowserScrollRequest,\n  ) => Effect.Effect<BrowserActionResult, InteractiveBrowserError>;\n  /** Invalidate the handle and close its resources early, including after an interrupted action. */\n  readonly close: Effect.Effect<void, InteractiveBrowserError>;\n}\n\nexport class InteractiveBrowser extends Context.Service<\n  InteractiveBrowser,\n  {\n    readonly open: (\n      policy: InteractiveBrowserPolicy,\n    ) => Effect.Effect<BrowserHandle, InteractiveBrowserError, Scope.Scope>;\n  }\n>()(\"@effect-agent/sandbox/InteractiveBrowser\") {}\n"],"mappings":"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"}

package/dist/sandbox/PageCapture.d.mts

@@ -0,0 +1,2 @@
+import { A as PageLinksCaptured, B as PageUrlTarget, C as PageCaptureResult, E as PageCaptureUnsupportedError, F as PageScrapeCaptured, I as PageScrapeElement, L as PageScrapeGroup, M as PageNavigationOptions, N as PageResourcePolicy, O as PageContentCaptured, P as PageScrapeAttribute, R as PageSelectorWait, S as PageCaptureResponseFormat, T as PageCaptureTargetUrl, V as PageViewport, _ as PageCaptureOutputLimitError, a as CapturePageStructured, b as PageCaptureRequest, c as PageCaptureCapture, d as PageCaptureInferencePolicyError, f as PageCaptureInferenceUse, g as PageCaptureOutput, h as PageCaptureNavigationError, i as CapturePageScrape, j as PageMarkdownCaptured, k as PageHtmlTarget, l as PageCaptureEngine, m as PageCaptureLinkUrl, n as CapturePageLinks, o as PageCapture, p as PageCaptureLimits, r as CapturePageMarkdown, s as PageCaptureAction, t as CapturePageContent, u as PageCaptureError, v as PageCaptureProtocolError, w as PageCaptureTarget, x as PageCaptureResourceUse, y as PageCaptureRateLimitedError, z as PageStructuredCaptured } from "../PageCapture-Df8Xwskw.mjs";
+export { CapturePageContent, CapturePageLinks, CapturePageMarkdown, CapturePageScrape, CapturePageStructured, PageCapture, PageCaptureAction, PageCaptureCapture, PageCaptureEngine, PageCaptureError, PageCaptureInferencePolicyError, PageCaptureInferenceUse, PageCaptureLimits, PageCaptureLinkUrl, PageCaptureNavigationError, PageCaptureOutput, PageCaptureOutputLimitError, PageCaptureProtocolError, PageCaptureRateLimitedError, PageCaptureRequest, PageCaptureResourceUse, PageCaptureResponseFormat, PageCaptureResult, PageCaptureTarget, PageCaptureTargetUrl, PageCaptureUnsupportedError, PageContentCaptured, PageHtmlTarget, PageLinksCaptured, PageMarkdownCaptured, PageNavigationOptions, PageResourcePolicy, PageScrapeAttribute, PageScrapeCaptured, PageScrapeElement, PageScrapeGroup, PageSelectorWait, PageStructuredCaptured, PageUrlTarget, PageViewport };