@effect-agent/platform-cloudflare 0.1.0-beta.110 → 0.1.0-beta.112

package/dist/{InteractiveBrowser-CKp6pqmw.d.mts → InteractiveBrowser-BQo7QKaP.d.mts}

@@ -1,7 +1,7 @@
 import { Context, Effect, Layer, Redacted, Schema, Scope } from "effect";
 import { SandboxImplementation } from "effect-agent/sandbox";
 import { HttpClient } from "effect/unstable/http";
-import { BrowserHandle, BrowserSelectFileRequest, InteractiveBrowser, InteractiveBrowserError, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError } from "effect-agent/interactive-browser";
+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"]>;
@@ -22,6 +22,25 @@ declare class BrowserRunSessionLifecycle extends BrowserRunSessionLifecycle_base
 //#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;
@@ -74,6 +93,7 @@ interface BrowserRunInteractiveCdpSession {
 }
 /** 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>;
@@ -82,9 +102,9 @@ interface BrowserRunInteractivePage {
   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 selectFile: (request: BrowserSelectFileRequest, signal: AbortSignal, onDispatch: () => void) => 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>;
@@ -95,6 +115,11 @@ interface BrowserRunInteractiveContext {
   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;
@@ -115,13 +140,38 @@ declare class BrowserRunInteractiveBinding extends BrowserRunInteractiveBinding_
     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.
-   * A timeout or interruption leaves the session unusable; no resize is retried.
+   * 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>;
@@ -140,6 +190,13 @@ declare const BrowserRunInteractiveHost_base: Context.ServiceClass<BrowserRunInt
   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. */
@@ -167,5 +224,5 @@ declare const CloudflareInteractiveBrowser: {
   hostLayer: (options: CloudflareInteractiveBrowserOptions) => Layer.Layer<BrowserRunInteractiveHost, BrowserRunCleanupError | InteractiveBrowserPolicyDeniedError, import("effect/unstable/http/HttpClient").HttpClient>;
 };
 //#endregion
-export { isBrowserRunUndispatchedActionError as C, browserRunInteractiveLayer as S, BrowserRunSessionLifecycle as T, BrowserRunViewport as _, BrowserRunInteractiveAcquisition as a, browserRunInteractiveHostLayer as b, BrowserRunInteractiveCdpSession as c, BrowserRunInteractivePage as d, BrowserRunInteractiveRequest as f, BrowserRunLiveViewResult as g, BrowserRunLiveViewRequest as h, BrowserRunHandoffState as i, BrowserRunInteractiveContext as l, BrowserRunInteractiveSession as m, BrowserRunHandoffRequest as n, BrowserRunInteractiveBinding as o, BrowserRunInteractiveRequestListener as p, BrowserRunHandoffResult as r, BrowserRunInteractiveBrowser as s, BrowserRunCloudflareCommand as t, BrowserRunInteractiveHost as u, CloudflareInteractiveBrowser as v, BrowserRunCleanupError as w, browserRunInteractiveImplementation as x, CloudflareInteractiveBrowserOptions as y };
-//# sourceMappingURL=InteractiveBrowser-CKp6pqmw.d.mts.map
+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