@effect-agent/platform-cloudflare 0.1.0-beta.12 → 0.1.0-beta.120

package/dist/InteractiveBrowser-BQo7QKaP.d.mts

@@ -0,0 +1,228 @@
+import { Context, Effect, Layer, Redacted, Schema, Scope } from "effect";
+import { SandboxImplementation } from "effect-agent/sandbox";
+import { HttpClient } from "effect/unstable/http";
+import { BrowserExpectedTarget, BrowserHandle, BrowserSelectFileRequest, 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>;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, 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 BrowserRunPageObservation: Schema.fromJsonString<Schema.Struct<{
+  readonly documentId: Schema.NonEmptyString;
+  readonly pageText: Schema.String;
+  readonly selectorMatchCount: Schema.Natural;
+  readonly controlsTruncated: Schema.Boolean;
+  readonly controls: Schema.$Array<Schema.Struct<{
+    readonly kind: Schema.String;
+    readonly inputType: Schema.optionalKey<Schema.String>;
+    readonly label: Schema.optionalKey<Schema.String>;
+    readonly checked: Schema.optionalKey<Schema.Boolean>;
+    readonly selected: Schema.optionalKey<Schema.Boolean>;
+    readonly disabled: Schema.optionalKey<Schema.Boolean>;
+    readonly required: Schema.optionalKey<Schema.Boolean>;
+    readonly valid: Schema.optionalKey<Schema.Boolean>;
+    readonly formValid: Schema.optionalKey<Schema.Boolean>;
+    readonly nodeId: Schema.NonEmptyString;
+    readonly selector: Schema.String;
+  }>>;
+}>>;
+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 identity?: () => Promise<BrowserRunPageIdentity>;
+  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, onComplete?: () => void, expectedTarget?: BrowserExpectedTarget) => Promise<unknown>;
+  readonly click: (selector: string, signal: AbortSignal, onDispatch: () => void, onComplete?: () => void, expectedTarget?: BrowserExpectedTarget) => Promise<unknown>;
+  readonly selectFile: (request: BrowserSelectFileRequest, signal: AbortSignal, onDispatch: () => void, onComplete?: () => 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 detach?: () => Promise<void>;
+  readonly reattach?: (identity: BrowserRunPageIdentity) => Promise<{
+    readonly context: BrowserRunInteractiveContext;
+    readonly page: BrowserRunInteractivePage;
+  } | undefined>;
+  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 acquire: (keepAliveMillis: number) => Promise<unknown>;
+  readonly connect: (sessionId: string) => 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 allocation and connection transport. */
+declare class BrowserRunInteractiveBinding extends BrowserRunInteractiveBinding_base {
+  static layer(options: {
+    readonly browser: BrowserRun;
+    readonly viewport?: BrowserRunViewport;
+  }): Layer.Layer<BrowserRunInteractiveBinding, InteractiveBrowserPolicyDeniedError, BrowserRunSessionLifecycle>;
+}
+declare const BrowserRunPageIdentity_base: Schema.Class<BrowserRunPageIdentity, Schema.Struct<{
+  readonly contextId: Schema.String;
+  readonly targetId: Schema.String;
+}>, {}>;
+/** Private target identity; never include this checkpoint in model-visible records. */
+declare class BrowserRunPageIdentity extends BrowserRunPageIdentity_base {}
+declare const BrowserRunInteractiveCheckpoint_base: Schema.Class<BrowserRunInteractiveCheckpoint, Schema.Struct<{
+  readonly sessionId: Schema.RedactedFromValue<Schema.String>;
+  readonly page: typeof BrowserRunPageIdentity;
+  readonly policy: typeof InteractiveBrowserPolicy;
+  readonly startedAt: Schema.Natural;
+  readonly consumedActions: Schema.Natural;
+  readonly inputState: Schema.Literals<readonly ["idle", "running", "unknown"]>;
+}>, {}>;
+/** Host-owned recovery data. Persist with the application's input receipts and ownership fence. */
+declare class BrowserRunInteractiveCheckpoint extends BrowserRunInteractiveCheckpoint_base {}
+type BrowserRunInputState = "idle" | "running" | "unknown";
+interface BrowserRunInteractiveSession {
+  readonly handle: BrowserHandle;
+  readonly checkpoint: Effect.Effect<BrowserRunInteractiveCheckpoint, InteractiveBrowserError>;
+  /** Invalidate this owner and disconnect locally, retaining the exact remote page until its deadline.
+   * Checkpoint and durable input receipts must be persisted first. Never grants another owner authority.
+   */
+  readonly detach: Effect.Effect<void, InteractiveBrowserError>;
+  readonly inputState: Effect.Effect<BrowserRunInputState>;
+  /** Wait at most 500 ms for local SDK input. A restart/transport-unknown fence cannot be drained. */
+  readonly drainInput: Effect.Effect<BrowserRunInputState>;
+  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.
+   * An interrupted resize fences further input until the SDK settles; 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>;
+}
+/** Persist the private cleanup identity before connecting or creating a page. */
+interface BrowserRunInteractiveAcquisition {
+  readonly sessionId: Redacted.Redacted<string>;
+  /** Connect at most once, within the acquisition's original scope and elapsed deadline. */
+  readonly connect: Effect.Effect<BrowserRunInteractiveSession, InteractiveBrowserError>;
+}
+declare const BrowserRunInteractiveHost_base: Context.ServiceClass<BrowserRunInteractiveHost, "@effect-agent/platform-cloudflare/BrowserRunInteractiveHost", {
+  readonly cleanupSemantics?: "confirmed-terminal";
+  readonly acquire: (policy: InteractiveBrowserPolicy) => Effect.Effect<BrowserRunInteractiveAcquisition, InteractiveBrowserError, Scope.Scope>;
+  readonly open: (policy: InteractiveBrowserPolicy) => Effect.Effect<BrowserRunInteractiveSession, InteractiveBrowserError, Scope.Scope>;
+  /** Requires exclusive host ownership. Never allocates a replacement page or replays an action.
+   * pendingInput must include durable receipts written after the checkpoint. Unknown input keeps
+   * mutations and human control fenced; reads remain available. Only confirmed close ends that fence.
+   */
+  readonly resume: (checkpoint: BrowserRunInteractiveCheckpoint, options: {
+    readonly pendingInput: boolean;
+  }) => 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 { CloudflareInteractiveBrowserOptions as C, isBrowserRunUndispatchedActionError as D, browserRunInteractiveLayer as E, BrowserRunCleanupError as O, CloudflareInteractiveBrowser as S, browserRunInteractiveImplementation as T, BrowserRunLiveViewRequest as _, BrowserRunInputState as a, BrowserRunPageObservation as b, BrowserRunInteractiveBrowser as c, BrowserRunInteractiveContext as d, BrowserRunInteractiveHost as f, BrowserRunInteractiveSession as g, BrowserRunInteractiveRequestListener as h, BrowserRunHandoffState as i, BrowserRunSessionLifecycle as k, BrowserRunInteractiveCdpSession as l, BrowserRunInteractiveRequest as m, BrowserRunHandoffRequest as n, BrowserRunInteractiveAcquisition as o, BrowserRunInteractivePage as p, BrowserRunHandoffResult as r, BrowserRunInteractiveBinding as s, BrowserRunCloudflareCommand as t, BrowserRunInteractiveCheckpoint as u, BrowserRunLiveViewResult as v, browserRunInteractiveHostLayer as w, BrowserRunViewport as x, BrowserRunPageIdentity as y };
+//# sourceMappingURL=InteractiveBrowser-BQo7QKaP.d.mts.map