@effect-agent/platform-cloudflare 0.1.0-beta.87 → 0.1.0-beta.89

package/dist/InteractiveBrowser-DUE_m12-.d.mts

@@ -0,0 +1,161 @@
+import { Context, Effect, Layer, Redacted, Schema, Scope } from "effect";
+import { SandboxImplementation } from "effect-agent/sandbox";
+import { HttpClient } from "effect/unstable/http";
+import { BrowserHandle, InteractiveBrowser, InteractiveBrowserError, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError } from "effect-agent/interactive-browser";
+//#region src/internal/browser-session-lifecycle.d.ts
+declare const BrowserRunCleanupError_base: Schema.Class<BrowserRunCleanupError, Schema.TaggedStruct<"BrowserRunCleanupError", {
+  readonly reason: Schema.Literals<readonly ["configuration", "authorization", "rate-limited", "provider", "malformed", "timeout", "pending"]>;
+  readonly status: Schema.optionalKey<Schema.Int>;
+}>, import("effect/Cause").YieldableError>;
+declare class BrowserRunCleanupError extends BrowserRunCleanupError_base {}
+interface BrowserRunLifecycleOptions {
+  readonly accountId: string;
+  readonly apiToken: Redacted.Redacted<string>;
+}
+declare const BrowserRunSessionLifecycle_base: Context.ServiceClass<BrowserRunSessionLifecycle, "@effect-agent/platform-cloudflare/BrowserRunSessionLifecycle", {
+  readonly close: (sessionId: Redacted.Redacted<string>) => Effect.Effect<void, BrowserRunCleanupError>;
+}>;
+declare class BrowserRunSessionLifecycle extends BrowserRunSessionLifecycle_base {
+  static layer(options: BrowserRunLifecycleOptions): Layer.Layer<BrowserRunSessionLifecycle, BrowserRunCleanupError, HttpClient.HttpClient>;
+}
+//#endregion
+//#region src/InteractiveBrowser.d.ts
+declare const browserRunInteractiveImplementation: SandboxImplementation;
+declare const BrowserRunViewport_base: Schema.Class<BrowserRunViewport, Schema.Struct<{
+  readonly width: Schema.Int;
+  readonly height: Schema.Int;
+  readonly deviceScaleFactor: Schema.optionalKey<Schema.Finite>;
+}>, {}>;
+/**
+ * Host presentation state in CSS pixels. Dimensions are integers in 1..2048,
+ * density is finite in 1..2 (default 1), and neither scaled dimension may exceed
+ * 2048 pixels. Mobile, touch, and orientation emulation are not supported.
+ */
+declare class BrowserRunViewport extends BrowserRunViewport_base {}
+declare const BrowserRunLiveViewRequest_base: Schema.Class<BrowserRunLiveViewRequest, Schema.Struct<{
+  readonly mode: Schema.Literal<"tab">;
+  readonly expiresInMs: Schema.Int;
+}>, {}>;
+/** Host-only request for a redacted Cloudflare Live View URL. */
+declare class BrowserRunLiveViewRequest extends BrowserRunLiveViewRequest_base {}
+declare const BrowserRunLiveViewResult_base: Schema.Class<BrowserRunLiveViewResult, Schema.Struct<{
+  readonly devtoolsFrontendUrl: Schema.Redacted<Schema.String>;
+}>, {}>;
+declare class BrowserRunLiveViewResult extends BrowserRunLiveViewResult_base {}
+declare const BrowserRunHandoffRequest_base: Schema.Class<BrowserRunHandoffRequest, Schema.Struct<{
+  readonly instructions: Schema.String;
+  readonly timeout: Schema.Int;
+}>, {}>;
+/** Start one bounded handoff; controller ownership remains a consumer concern. */
+declare class BrowserRunHandoffRequest extends BrowserRunHandoffRequest_base {}
+declare const BrowserRunHandoffResult_base: Schema.Class<BrowserRunHandoffResult, Schema.Struct<{
+  readonly handoffId: Schema.Redacted<Schema.String>;
+}>, {}>;
+declare class BrowserRunHandoffResult extends BrowserRunHandoffResult_base {}
+declare const BrowserRunHandoffState_base: Schema.Class<BrowserRunHandoffState, Schema.Struct<{
+  readonly active: Schema.Boolean;
+  readonly handoffId: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+  readonly durationMs: Schema.optionalKey<Schema.Natural>;
+}>, {}>;
+declare class BrowserRunHandoffState extends BrowserRunHandoffState_base {}
+/** One intercepted Puppeteer request, narrowed to the policy-relevant surface. */
+interface BrowserRunInteractiveRequest {
+  readonly url: () => string;
+  readonly abort: () => Promise<void>;
+  readonly continue: () => Promise<void>;
+}
+type BrowserRunInteractiveRequestListener = (request: BrowserRunInteractiveRequest) => void;
+type BrowserRunCloudflareCommand = "Cloudflare.getLiveView" | "Cloudflare.handoff" | "Cloudflare.getHandoffState";
+/** Narrow CDP boundary for Cloudflare commands absent from the pinned protocol types. */
+interface BrowserRunInteractiveCdpSession {
+  readonly send: (command: BrowserRunCloudflareCommand, parameters: unknown) => Promise<unknown>;
+  readonly detach: () => Promise<void>;
+}
+/** Narrow page boundary used by deterministic tests; SDK values remain in this package. */
+interface BrowserRunInteractivePage {
+  readonly close: () => Promise<void>;
+  readonly setBypassServiceWorker: (enabled: boolean) => Promise<void>;
+  readonly setRequestInterception: (enabled: boolean) => Promise<void>;
+  readonly onRequest: (listener: BrowserRunInteractiveRequestListener) => void;
+  readonly offRequest: (listener: BrowserRunInteractiveRequestListener) => void;
+  readonly goto: (url: string) => Promise<void>;
+  readonly url: () => unknown;
+  readonly readText: (selector: string | undefined, maximumBytes: number) => Promise<unknown>;
+  readonly fill: (selector: string, value: string, signal: AbortSignal, onDispatch: () => void) => Promise<unknown>;
+  readonly click: (selector: string, signal: AbortSignal, onDispatch: () => void) => Promise<unknown>;
+  readonly screenshot: (fullPage: boolean) => Promise<unknown>;
+  readonly scroll: (deltaX: number, deltaY: number) => Promise<void>;
+  readonly setViewport: (viewport: BrowserRunViewport) => Promise<void>;
+  readonly createCdpSession: () => Promise<BrowserRunInteractiveCdpSession>;
+}
+interface BrowserRunInteractiveContext {
+  readonly newPage: () => Promise<BrowserRunInteractivePage>;
+  readonly close: () => Promise<void>;
+}
+interface BrowserRunInteractiveBrowser {
+  readonly createContext: () => Promise<BrowserRunInteractiveContext>;
+  readonly close: () => Promise<void>;
+  readonly sessionId: () => unknown;
+  readonly isConnected: () => boolean;
+  readonly onDisconnected: (listener: () => void) => void;
+  readonly offDisconnected: (listener: () => void) => void;
+}
+declare const BrowserRunInteractiveBinding_base: Context.ServiceClass<BrowserRunInteractiveBinding, "@effect-agent/platform-cloudflare/BrowserRunInteractiveBinding", {
+  readonly launch: (keepAliveMillis: number) => Promise<BrowserRunInteractiveBrowser>;
+  /** Success proves whole-browser termination or exact-session absence. */
+  readonly closeSession: (sessionId: Redacted.Redacted<string>) => Effect.Effect<void, InteractiveBrowserError>;
+}>;
+/** Host-supplied Browser Run binding projected into one fakeable launch operation. */
+declare class BrowserRunInteractiveBinding extends BrowserRunInteractiveBinding_base {
+  static layer(options: {
+    readonly browser: BrowserRun;
+    readonly viewport?: BrowserRunViewport;
+  }): Layer.Layer<BrowserRunInteractiveBinding, InteractiveBrowserPolicyDeniedError, BrowserRunSessionLifecycle>;
+}
+interface BrowserRunInteractiveSession {
+  readonly handle: BrowserHandle;
+  readonly sessionId: Redacted.Redacted<string>;
+  /**
+   * Resize without charging an agent action or changing emulation modes. Shares
+   * the handle's fail-fast lock, page-policy preflight, and elapsed deadline.
+   * A timeout or interruption leaves the session unusable; no resize is retried.
+   * The host must authorize callers. No viewer ownership or durable state is added.
+   */
+  readonly resizeViewport: (viewport: BrowserRunViewport) => Effect.Effect<void, InteractiveBrowserError>;
+  readonly getLiveView: (request: BrowserRunLiveViewRequest) => Effect.Effect<BrowserRunLiveViewResult, InteractiveBrowserError>;
+  readonly handoff: (request: BrowserRunHandoffRequest) => Effect.Effect<BrowserRunHandoffResult, InteractiveBrowserError>;
+  readonly getHandoffState: Effect.Effect<BrowserRunHandoffState, InteractiveBrowserError>;
+  readonly close: Effect.Effect<void, InteractiveBrowserError>;
+}
+declare const BrowserRunInteractiveHost_base: Context.ServiceClass<BrowserRunInteractiveHost, "@effect-agent/platform-cloudflare/BrowserRunInteractiveHost", {
+  readonly cleanupSemantics?: "confirmed-terminal";
+  readonly open: (policy: InteractiveBrowserPolicy) => Effect.Effect<BrowserRunInteractiveSession, InteractiveBrowserError, Scope.Scope>;
+  readonly closeSession: (sessionId: Redacted.Redacted<string>) => Effect.Effect<void, InteractiveBrowserError>;
+}>;
+/** Cloudflare host authority kept separate from the provider-neutral browser handle. */
+declare class BrowserRunInteractiveHost extends BrowserRunInteractiveHost_base {}
+/** Recognizes a local pre-dispatch refusal without exposing selector or page content. */
+declare const isBrowserRunUndispatchedActionError: (error: unknown) => boolean;
+/** Cloudflare host controls and private session identity for one scoped Browser Run pass. */
+declare const browserRunInteractiveHostLayer: () => Layer.Layer<BrowserRunInteractiveHost, never, BrowserRunInteractiveBinding>;
+/** Worker-only generic adapter; Cloudflare identity and controls remain host-only. */
+declare const browserRunInteractiveLayer: () => Layer.Layer<InteractiveBrowser, never, BrowserRunInteractiveBinding>;
+/** Resolved Worker binding, cleanup credentials, and optional initial viewport. */
+interface CloudflareInteractiveBrowserOptions extends BrowserRunLifecycleOptions {
+  readonly browser: BrowserRun;
+  readonly viewport?: BrowserRunViewport;
+}
+/** Worker-only assembly; importing ordinary capture never loads Puppeteer. */
+declare const CloudflareInteractiveBrowser: {
+  /**
+   * Assemble binding, confirmed-session cleanup, and the generic browser service.
+   * HttpClient and construction errors remain visible. Opening a pass still requires
+   * an explicit policy and Scope; no browser is launched during Layer construction.
+   */
+  layer: (options: CloudflareInteractiveBrowserOptions) => Layer.Layer<InteractiveBrowser, BrowserRunCleanupError | InteractiveBrowserPolicyDeniedError, import("effect/unstable/http/HttpClient").HttpClient>;
+  /** Opt into private host controls instead of exposing them through the generic service. */
+  hostLayer: (options: CloudflareInteractiveBrowserOptions) => Layer.Layer<BrowserRunInteractiveHost, BrowserRunCleanupError | InteractiveBrowserPolicyDeniedError, import("effect/unstable/http/HttpClient").HttpClient>;
+};
+//#endregion
+export { BrowserRunCleanupError as C, isBrowserRunUndispatchedActionError as S, CloudflareInteractiveBrowser as _, BrowserRunInteractiveBinding as a, browserRunInteractiveImplementation as b, BrowserRunInteractiveContext as c, BrowserRunInteractiveRequest as d, BrowserRunInteractiveRequestListener as f, BrowserRunViewport as g, BrowserRunLiveViewResult as h, BrowserRunHandoffState as i, BrowserRunInteractiveHost as l, BrowserRunLiveViewRequest as m, BrowserRunHandoffRequest as n, BrowserRunInteractiveBrowser as o, BrowserRunInteractiveSession as p, BrowserRunHandoffResult as r, BrowserRunInteractiveCdpSession as s, BrowserRunCloudflareCommand as t, BrowserRunInteractivePage as u, CloudflareInteractiveBrowserOptions as v, BrowserRunSessionLifecycle as w, browserRunInteractiveLayer as x, browserRunInteractiveHostLayer as y };
+//# sourceMappingURL=InteractiveBrowser-DUE_m12-.d.mts.map