@effect-agent/platform-cloudflare 0.1.0-beta.13 → 0.1.0-beta.131

package/dist/CloudflareBrowser-Doe1M7R5.d.mts

@@ -0,0 +1,80 @@
+import { Context, Effect, Layer, Schema } from "effect";
+import { PageCapture, PageCaptureRequest } from "effect-agent/page-capture";
+import { PageScreenshot } from "effect-agent/page-screenshot";
+import { SandboxImplementation } from "effect-agent/sandbox";
+//#region src/internal/browser-quick-action.d.ts
+/**
+ * Effect-native client captured by the binding service. Its option types come
+ * directly from the pinned Workers declarations rather than a local copy.
+ */
+interface BrowserQuickActionClient {
+  readonly screenshot: (options: BrowserRunScreenshotOptions) => Effect.Effect<Response, BrowserQuickActionRpcError>;
+  readonly content: (options: BrowserRunContentOptions) => Effect.Effect<Response, BrowserQuickActionRpcError>;
+  readonly markdown: (options: BrowserRunMarkdownOptions) => Effect.Effect<Response, BrowserQuickActionRpcError>;
+  readonly links: (options: BrowserRunLinksOptions) => Effect.Effect<Response, BrowserQuickActionRpcError>;
+  readonly scrape: (options: BrowserRunScrapeOptions) => Effect.Effect<Response, BrowserQuickActionRpcError>;
+  readonly json: (options: BrowserRunJsonOptions) => Effect.Effect<Response, BrowserQuickActionRpcError>;
+}
+declare const BrowserQuickActionRpcError_base: Schema.Class<BrowserQuickActionRpcError, Schema.TaggedStruct<"BrowserQuickActionRpcError", {
+  readonly action: Schema.Literals<readonly ["screenshot", "content", "markdown", "links", "scrape", "json"]>;
+  readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** A native binding RPC rejected before it returned an HTTP response. */
+declare class BrowserQuickActionRpcError extends BrowserQuickActionRpcError_base {}
+interface BrowserQuickActionCaptureOptions {
+  /** The resolved Wrangler `browser` binding (DEPLOY-014: supplied, never ambient). */
+  readonly browser: BrowserRun;
+}
+declare const BrowserQuickActionBrowserBinding_base: Context.ServiceClass<BrowserQuickActionBrowserBinding, "@effect-agent/platform-cloudflare/BrowserQuickActionBrowserBinding", BrowserQuickActionClient>;
+/** Host-owned browser binding authority, supplied explicitly at the composition root. */
+declare class BrowserQuickActionBrowserBinding extends BrowserQuickActionBrowserBinding_base {
+  static layer(options: BrowserQuickActionCaptureOptions): Layer.Layer<BrowserQuickActionBrowserBinding>;
+}
+/** Host-owned authorization and accounting for one Workers AI extraction. */
+interface BrowserQuickActionWorkersAiPolicy {
+  readonly authorizeAndAccount: (request: PageCaptureRequest) => Effect.Effect<void, BrowserQuickActionWorkersAiPolicyError>;
+}
+declare const BrowserQuickActionWorkersAiPolicyError_base: Schema.Class<BrowserQuickActionWorkersAiPolicyError, Schema.TaggedStruct<"BrowserQuickActionWorkersAiPolicyError", {
+  readonly reason: Schema.Literals<readonly ["authorization", "accounting"]>;
+  readonly message: Schema.String;
+  readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+/** Host-only diagnostic for a denied or unaccounted Workers AI extraction. */
+declare class BrowserQuickActionWorkersAiPolicyError extends BrowserQuickActionWorkersAiPolicyError_base {}
+declare const BrowserQuickActionWorkersAi_base: Context.ServiceClass<BrowserQuickActionWorkersAi, "@effect-agent/platform-cloudflare/BrowserQuickActionWorkersAi", BrowserQuickActionWorkersAiPolicy>;
+/** Explicit host-owned authority and accounting for separately billed Workers AI extraction. */
+declare class BrowserQuickActionWorkersAi extends BrowserQuickActionWorkersAi_base {
+  static layer(policy: BrowserQuickActionWorkersAiPolicy): Layer.Layer<BrowserQuickActionWorkersAi>;
+}
+/**
+ * Ordinary Quick Actions require host-owned browser binding authority. Workers
+ * AI stays unavailable unless the host deliberately selects its separate Layer.
+ */
+declare const browserQuickActionCaptureLayer: () => Layer.Layer<PageCapture, never, BrowserQuickActionBrowserBinding>;
+/** Structured Quick Actions require host-owned browser and Workers AI authority. */
+declare const browserQuickActionWorkersAiCaptureLayer: () => Layer.Layer<PageCapture, never, BrowserQuickActionBrowserBinding | BrowserQuickActionWorkersAi>;
+/** Host-owned Quick Action binding and optional, separately billed extraction authority. */
+interface CloudflareBrowserOptions extends BrowserQuickActionCaptureOptions {
+  readonly workersAi?: BrowserQuickActionWorkersAiPolicy;
+}
+/** Compose WebCapture handlers with the Cloudflare Quick Action adapter. */
+declare const CloudflareBrowser: {
+  /**
+   * Supply a WebCapture definition and the resolved Worker browser binding.
+   * Supports capture, scrape, and extraction definitions without importing capabilities.
+   * Only PageCapture is provided; other handler requirements and errors stay visible.
+   * Extraction fails closed unless workersAi explicitly authorizes and accounts for it.
+   * Capture limits, typed failures, tracing, and scoped response cleanup are unchanged.
+   */
+  layer: <A, E, R>(definition: {
+    readonly handlers: Layer.Layer<A, E, R>;
+  }, options: CloudflareBrowserOptions) => Layer.Layer<A, E, Exclude<R, PageCapture>>;
+};
+/** Native Browser Run screenshot adapter. It retains PNG bytes only for the caller's result. */
+declare const browserQuickActionScreenshotLayer: () => Layer.Layer<PageScreenshot, never, BrowserQuickActionBrowserBinding>;
+declare namespace CloudflareBrowser_d_exports {
+  export { BrowserQuickActionBrowserBinding, BrowserQuickActionCaptureOptions, BrowserQuickActionClient, BrowserQuickActionRpcError, BrowserQuickActionWorkersAi, BrowserQuickActionWorkersAiPolicy, BrowserQuickActionWorkersAiPolicyError, CloudflareBrowser, CloudflareBrowserOptions, browserQuickActionCaptureLayer, browserQuickActionScreenshotLayer, browserQuickActionWorkersAiCaptureLayer };
+}
+//#endregion
+export { BrowserQuickActionRpcError as a, BrowserQuickActionWorkersAiPolicyError as c, browserQuickActionCaptureLayer as d, browserQuickActionScreenshotLayer as f, BrowserQuickActionClient as i, CloudflareBrowser as l, BrowserQuickActionBrowserBinding as n, BrowserQuickActionWorkersAi as o, browserQuickActionWorkersAiCaptureLayer as p, BrowserQuickActionCaptureOptions as r, BrowserQuickActionWorkersAiPolicy as s, CloudflareBrowser_d_exports as t, CloudflareBrowserOptions as u };
+//# sourceMappingURL=CloudflareBrowser-Doe1M7R5.d.mts.map

package/dist/CloudflareBrowser.d.mts

@@ -0,0 +1,2 @@
+import { a as BrowserQuickActionRpcError, c as BrowserQuickActionWorkersAiPolicyError, d as browserQuickActionCaptureLayer, f as browserQuickActionScreenshotLayer, i as BrowserQuickActionClient, l as CloudflareBrowser, n as BrowserQuickActionBrowserBinding, o as BrowserQuickActionWorkersAi, p as browserQuickActionWorkersAiCaptureLayer, r as BrowserQuickActionCaptureOptions, s as BrowserQuickActionWorkersAiPolicy, u as CloudflareBrowserOptions } from "./CloudflareBrowser-Doe1M7R5.mjs";
+export { BrowserQuickActionBrowserBinding, type BrowserQuickActionCaptureOptions, type BrowserQuickActionClient, BrowserQuickActionRpcError, BrowserQuickActionWorkersAi, type BrowserQuickActionWorkersAiPolicy, BrowserQuickActionWorkersAiPolicyError, CloudflareBrowser, type CloudflareBrowserOptions, browserQuickActionCaptureLayer, browserQuickActionScreenshotLayer, browserQuickActionWorkersAiCaptureLayer };

package/dist/CloudflareBrowser.mjs

@@ -0,0 +1,2 @@
+import { a as BrowserQuickActionWorkersAiPolicyError, c as browserQuickActionScreenshotLayer, i as BrowserQuickActionWorkersAi, l as browserQuickActionWorkersAiCaptureLayer, n as BrowserQuickActionBrowserBinding, o as CloudflareBrowser, r as BrowserQuickActionRpcError, s as browserQuickActionCaptureLayer } from "./CloudflareBrowser-DV6kya1H.mjs";
+export { BrowserQuickActionBrowserBinding, BrowserQuickActionRpcError, BrowserQuickActionWorkersAi, BrowserQuickActionWorkersAiPolicyError, CloudflareBrowser, browserQuickActionCaptureLayer, browserQuickActionScreenshotLayer, browserQuickActionWorkersAiCaptureLayer };

package/dist/CloudflareCodeMode.d.mts

@@ -0,0 +1,44 @@
+import { Effect, Layer } from "effect";
+import { SandboxImplementation } from "effect-agent/sandbox";
+import { CodeExecutor } from "effect-agent/code-executor";
+declare namespace CloudflareCodeMode_d_exports {
+  export { CloudflareCodeMode, DynamicWorkerCodeExecutorOptions, disposeRpcHandle, dynamicWorkerCodeExecutorLayer, dynamicWorkerImplementation };
+}
+/**
+ * The Cloudflare Dynamic Worker `CodeExecutor` adapter (C4 of ADR-0017;
+ * DEPLOY-011). Each pass loads one fresh Worker through the Worker Loader
+ * with `globalOutbound: null`, so generated code has no ambient network,
+ * bindings, or secrets; its only authority is the pass-scoped RPC target that
+ * routes back into the owning event's `CodeExecutionHost` service. Platform
+ * CPU limits stop synchronous runaway programs; the executor-owned wall-clock
+ * deadline interrupts asynchronously suspended passes. Deployment class `E`
+ * only: the adapter records no persistent state and a later pass may run in a
+ * completely different isolate.
+ */
+export declare const dynamicWorkerImplementation: SandboxImplementation;
+/** Dispose a Cloudflare RPC handle when the runtime supplies its untyped disposal hook. @internal */
+export declare const disposeRpcHandle: (handle: unknown) => Effect.Effect<void>;
+export interface DynamicWorkerCodeExecutorOptions {
+  /** The `worker_loader` binding. */
+  readonly loader: WorkerLoader;
+  /** Compatibility date for dynamic workers; defaults to `2025-05-01`. */
+  readonly compatibilityDate?: string | undefined;
+}
+/** Layer building the Dynamic Worker `CodeExecutor` from resolved bindings. */
+export declare const dynamicWorkerCodeExecutorLayer: (options: DynamicWorkerCodeExecutorOptions) => Layer.Layer<CodeExecutor>;
+/** Assemble Code Mode handlers with the isolated Dynamic Worker executor. */
+export declare const CloudflareCodeMode: {
+  /**
+   * Provide the selected tool handlers at construction, where Code Mode captures them.
+   * Their errors and remaining dependencies stay visible. The definition still owns the
+   * allowlist and limits; the runtime supplies the live Tool broker for each scoped pass.
+   */
+  layer: <A, E, R, Handlers, HandlerError, HandlerRequirements>(definition: {
+    readonly handlers: Layer.Layer<A, E, R>;
+  }, options: DynamicWorkerCodeExecutorOptions & {
+    readonly handlers: Layer.Layer<Handlers, HandlerError, HandlerRequirements>;
+  }) => Layer.Layer<A, E | HandlerError, Exclude<HandlerRequirements, CodeExecutor> | Exclude<Exclude<R, Handlers>, CodeExecutor>>;
+};
+//#endregion
+export { CloudflareCodeMode_d_exports as t };
+//# sourceMappingURL=CloudflareCodeMode.d.mts.map