@effect-agent/platform-cloudflare 0.1.0-beta.42 → 0.1.0-beta.45

package/src/boundary.ts

@@ -9,6 +9,7 @@ const boundForeignDiagnostic = (message: string): string =>
 export const safeCauseMessage = (cause: unknown, fallback: string): string => {
   try {
     const message = cause instanceof Error ? cause.message : cause;
+
     return boundForeignDiagnostic(typeof message === "string" ? message : String(message));
   } catch {
     return boundForeignDiagnostic(fallback);
@@ -38,9 +39,12 @@ export const cloudflareFailureSignals = (cause: unknown): CloudflareFailureSigna
     const retryableValue = Reflect.get(cause, "retryable");
     const overloadedValue = Reflect.get(cause, "overloaded");
     const resetValue = Reflect.get(cause, "durableObjectReset");
+
     const retryable =
       typeof retryableValue === "boolean" ? retryableValue : resetValue === true ? true : undefined;
+
     const overloaded = typeof overloadedValue === "boolean" ? overloadedValue : undefined;
+
     return {
       ...(retryable === undefined ? {} : { retryable }),
       ...(overloaded === undefined ? {} : { overloaded }),

package/src/browser-quick-action.ts

@@ -97,6 +97,7 @@ export class BrowserQuickActionBrowserBinding extends Context.Service<
     options: BrowserQuickActionCaptureOptions,
   ): Layer.Layer<BrowserQuickActionBrowserBinding> {
     const browser = options.browser;
+
     const invoke = Effect.fn("BrowserQuickActionBrowserBinding.invoke")(function* (
       action: "screenshot" | "content" | "markdown" | "links" | "scrape" | "json",
       evaluate: () => Promise<Response>,
@@ -106,6 +107,7 @@ export class BrowserQuickActionBrowserBinding extends Context.Service<
         catch: (cause) => BrowserQuickActionRpcError.make({ action, cause }),
       });
     });
+
     return Layer.succeed(BrowserQuickActionBrowserBinding)({
       screenshot: (request) =>
         invoke("screenshot", () => browser.quickAction("screenshot", request)),
@@ -175,8 +177,10 @@ const decodeEnvelope = Schema.decodeUnknownOption(Schema.fromJsonString(QuickAct
 const quickActionCommonOptions = (request: PageCaptureRequest): BrowserRunCommonOptions => {
   const options: BrowserRunBaseOptions = {};
   const navigation = request.navigation;
+
   if (navigation !== undefined) {
     const goto: NonNullable<BrowserRunBaseOptions["gotoOptions"]> = {};
+
     if (navigation.waitUntil !== undefined) goto.waitUntil = navigation.waitUntil;
     if (navigation.timeoutMillis !== undefined) goto.timeout = navigation.timeoutMillis;
     if (Object.keys(goto).length > 0) options.gotoOptions = goto;
@@ -200,6 +204,7 @@ const quickActionCommonOptions = (request: PageCaptureRequest): BrowserRunCommon
       options.allowRequestPattern = [...request.resourcePolicy.allowRequestPatterns];
     }
   }
+
   return request.target._tag === "PageUrlTarget"
     ? { ...options, url: request.target.url }
     : { ...options, html: request.target.html };
@@ -211,6 +216,7 @@ const executeQuickAction = (
   request: PageCaptureRequest,
 ): Effect.Effect<Response, BrowserQuickActionRpcError> => {
   const options = quickActionCommonOptions(request);
+
   switch (request.action._tag) {
     case "CapturePageContent": {
       return browser.content(options);
@@ -284,6 +290,7 @@ const readBoundedResponse = Effect.fn("BrowserQuickActionCapture.readResponse")(
   request: PageCaptureRequest,
 ) {
   const body = response.body;
+
   if (body === null) return "";
 
   const reader = yield* Effect.acquireRelease(
@@ -293,6 +300,7 @@ const readBoundedResponse = Effect.fn("BrowserQuickActionCapture.readResponse")(
     }),
     releaseResponseReader,
   );
+
   const decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: false });
   let observedBytes = 0;
   let bodyText = "";
@@ -302,6 +310,7 @@ const readBoundedResponse = Effect.fn("BrowserQuickActionCapture.readResponse")(
       try: () => reader.read(),
       catch: (cause) => protocolError("Reading the Quick Action response failed", cause),
     });
+
     if (chunk.done) break;
 
     observedBytes += chunk.value.byteLength;
@@ -334,25 +343,32 @@ const readBoundedResponse = Effect.fn("BrowserQuickActionCapture.readResponse")(
  */
 const retryAfterMillis = (response: Response): number | undefined => {
   const header = response.headers.get("Retry-After");
+
   if (header === null) return undefined;
   const seconds = Number(header);
+
   if (!Number.isSafeInteger(seconds) || seconds < 0) return undefined;
   const millis = seconds * 1_000;
+
   return Number.isSafeInteger(millis) ? millis : undefined;
 };
 
 const browserMillis = (response: Response): number | undefined => {
   const header = response.headers.get("X-Browser-Ms-Used");
+
   if (header === null) return undefined;
   const millis = Number(header);
+
   return Number.isSafeInteger(millis) && millis >= 0 ? millis : undefined;
 };
 
 /** Only trusted response metadata chooses transport framing; page text never does. */
 const isJsonResponse = (response: Response): boolean => {
   const contentType = response.headers.get("Content-Type");
+
   if (contentType === null) return false;
   const mediaType = contentType.split(";", 1)[0]?.trim().toLowerCase();
+
   return mediaType === "application/json" || mediaType?.endsWith("+json") === true;
 };
 
@@ -368,6 +384,7 @@ const parseOutput = (
     );
   }
   const envelope = decodeEnvelope(bodyText);
+
   if (Option.isNone(envelope)) {
     return protocolError(
       "The JSON Quick Action response did not carry a valid response envelope",
@@ -386,6 +403,7 @@ const parseOutput = (
       if (typeof envelope.value.result !== "string") {
         return protocolError("The Quick Action envelope carried a non-text result");
       }
+
       return action._tag === "CapturePageContent"
         ? PageContentCaptured.make({ html: envelope.value.result })
         : PageMarkdownCaptured.make({ markdown: envelope.value.result });
@@ -395,9 +413,11 @@ const parseOutput = (
         _tag: "PageLinksCaptured",
         links: envelope.value.result,
       });
+
       if (Option.isNone(decoded)) {
         return protocolError("The links Quick Action did not return a bounded array of valid URLs");
       }
+
       return decoded.value;
     }
     case "CapturePageScrape": {
@@ -405,11 +425,13 @@ const parseOutput = (
         _tag: "PageScrapeCaptured",
         groups: envelope.value.result,
       });
+
       if (Option.isNone(decoded)) {
         return protocolError(
           "The scrape Quick Action did not return bounded grouped element records",
         );
       }
+
       return decoded.value;
     }
     case "CapturePageStructured": {
@@ -437,6 +459,7 @@ const makeCapture = (
     }
 
     const usesWorkersAi = request.action._tag === "CapturePageStructured";
+
     if (usesWorkersAi) {
       if (workersAi === undefined) {
         return yield* PageCaptureUnsupportedError.make({
@@ -467,11 +490,14 @@ const makeCapture = (
         protocolError("The browser binding rejected the Quick Action", error.cause),
       ),
     );
+
     const bodyText = yield* readBoundedResponse(response, request);
+
     if (response.status === 429) {
       const retryAfter = retryAfterMillis(response);
       const reason = isQuotaMessage(bodyText) ? "quota" : "rate";
       const cause = privateResponseCause(bodyText);
+
       return yield* PageCaptureRateLimitedError.make({
         implementation: browserQuickActionImplementation,
         reason,
@@ -486,12 +512,15 @@ const makeCapture = (
     if (!response.ok) {
       const message = `The Quick Action answered HTTP ${response.status}`;
       const cause = privateResponseCause(bodyText);
+
       if (response.status >= 500) {
         return yield* protocolError(message, cause);
       }
+
       return yield* navigationError(message, cause);
     }
     const output = parseOutput(request.action, bodyText, response);
+
     if (
       output._tag === "PageCaptureNavigationError" ||
       output._tag === "PageCaptureProtocolError"
@@ -499,6 +528,7 @@ const makeCapture = (
       return yield* output;
     }
     const millis = browserMillis(response);
+
     return PageCaptureResult.make({
       implementation: browserQuickActionImplementation,
       output,
@@ -543,6 +573,7 @@ export const browserQuickActionWorkersAiCaptureLayer = (): Layer.Layer<
     Effect.gen(function* () {
       const browser = yield* BrowserQuickActionBrowserBinding;
       const workersAi = yield* BrowserQuickActionWorkersAi;
+
       return PageCapture.of({ capture: makeCapture(browser, workersAi) });
     }),
   );
@@ -580,6 +611,7 @@ export const CloudflareBrowser = {
 
 const screenshotOptions = (request: PageScreenshotRequest): BrowserRunScreenshotOptions => {
   const options: BrowserRunBaseOptions = {};
+
   if (
     request.navigation?.waitUntil !== undefined ||
     request.navigation?.timeoutMillis !== undefined
@@ -610,6 +642,7 @@ const screenshotOptions = (request: PageScreenshotRequest): BrowserRunScreenshot
   if (request.resourcePolicy?.allowRequestPatterns !== undefined) {
     options.allowRequestPattern = [...request.resourcePolicy.allowRequestPatterns];
   }
+
   return {
     ...options,
     ...(request.target._tag === "PageUrlTarget"
@@ -643,8 +676,10 @@ const pngResponse = (response: Response): boolean =>
 
 const declaredLength = (response: Response): number | undefined => {
   const raw = response.headers.get("Content-Length");
+
   if (raw === null || !/^(0|[1-9][0-9]*)$/.test(raw)) return undefined;
   const length = Number(raw);
+
   return Number.isSafeInteger(length) ? length : undefined;
 };
 
@@ -653,22 +688,27 @@ const readScreenshot = Effect.fn("BrowserQuickActionScreenshot.read")(function*
   request: PageScreenshotRequest,
 ) {
   const body = response.body;
+
   if (body === null) {
     return yield* protocolError("The screenshot response had no body");
   }
   if (!pngResponse(response)) {
     yield* cancelBody(body);
+
     return yield* protocolError("The screenshot response was not image/png");
   }
   const length = declaredLength(response);
+
   if (length !== undefined && length > request.limits.maxOutputBytes) {
     yield* cancelBody(body);
+
     return yield* PageScreenshotOutputLimitError.make({
       implementation: browserQuickActionImplementation,
       limit: request.limits.maxOutputBytes,
       observed: length,
     });
   }
+
   const reader = yield* Effect.acquireRelease(
     Effect.try({
       try: () => body.getReader(),
@@ -676,13 +716,16 @@ const readScreenshot = Effect.fn("BrowserQuickActionScreenshot.read")(function*
     }),
     releaseScreenshotReader,
   );
+
   const chunks: Array<Uint8Array> = [];
   let observed = 0;
+
   while (true) {
     const next = yield* Effect.tryPromise({
       try: () => reader.read(),
       catch: (cause) => protocolError("Reading the screenshot response failed", cause),
     });
+
     if (next.done) break;
     observed += next.value.byteLength;
     if (observed > request.limits.maxOutputBytes) {
@@ -696,10 +739,12 @@ const readScreenshot = Effect.fn("BrowserQuickActionScreenshot.read")(function*
   }
   const bytes = new Uint8Array(observed);
   let offset = 0;
+
   for (const chunk of chunks) {
     bytes.set(chunk, offset);
     offset += chunk.byteLength;
   }
+
   return bytes;
 }, Effect.scoped);
 
@@ -714,6 +759,7 @@ const makeScreenshot = (browser: BrowserQuickActionClient): PageScreenshotCaptur
         message: "The browser binding's screenshot action exposes no engine selector",
       });
     }
+
     const response = yield* browser
       .screenshot(screenshotOptions(request))
       .pipe(
@@ -721,9 +767,12 @@ const makeScreenshot = (browser: BrowserQuickActionClient): PageScreenshotCaptur
           protocolError("The browser binding rejected the screenshot", error.cause),
         ),
       );
+
     if (response.status === 429) {
       const body = response.body;
+
       if (body !== null) yield* cancelBody(body);
+
       return yield* PageCaptureRateLimitedError.make({
         implementation: browserQuickActionImplementation,
         reason: "rate",
@@ -735,11 +784,14 @@ const makeScreenshot = (browser: BrowserQuickActionClient): PageScreenshotCaptur
     }
     if (!response.ok) {
       const body = response.body;
+
       if (body !== null) yield* cancelBody(body);
       const message = `The screenshot Quick Action answered HTTP ${response.status}`;
+
       return yield* response.status >= 500 ? protocolError(message) : navigationError(message);
     }
     const bytes = yield* readScreenshot(response, request);
+
     return PageScreenshotResult.make({
       implementation: browserQuickActionImplementation,
       mediaType: "image/png",

package/src/browser-rest-capture.ts

@@ -51,6 +51,7 @@ const RestSuccessEnvelope = Schema.Struct({
   errors: Schema.optionalKey(Schema.Array(Schema.Unknown)),
   meta: Schema.optionalKey(Schema.Unknown),
 });
+
 const RestErrorEnvelope = Schema.Struct({
   success: Schema.Literal(false),
   errors: Schema.Array(
@@ -62,6 +63,7 @@ const RestErrorEnvelope = Schema.Struct({
   result: Schema.optionalKey(Schema.Json),
   meta: Schema.optionalKey(Schema.Unknown),
 });
+
 const RestEnvelope = Schema.Union([RestSuccessEnvelope, RestErrorEnvelope]);
 const decodeEnvelope = Schema.decodeUnknownOption(Schema.fromJsonString(RestEnvelope));
 
@@ -86,6 +88,7 @@ const privateResponseCause = (
   if (bodyText.length === 0) return undefined;
   const token = Redacted.value(apiToken);
   const diagnostic = boundedDiagnostic(bodyText);
+
   return new Error(token.length === 0 ? diagnostic : diagnostic.replaceAll(token, "[REDACTED]"));
 };
 
@@ -94,8 +97,10 @@ const requestBody = (request: PageCaptureRequest): Record<string, unknown> => {
     request.target._tag === "PageUrlTarget"
       ? { url: request.target.url }
       : { html: request.target.html };
+
   if (request.navigation !== undefined) {
     const goto: Record<string, unknown> = {};
+
     if (request.navigation.waitUntil !== undefined) goto.waitUntil = request.navigation.waitUntil;
     if (request.navigation.timeoutMillis !== undefined)
       goto.timeout = request.navigation.timeoutMillis;
@@ -116,6 +121,7 @@ const requestBody = (request: PageCaptureRequest): Record<string, unknown> => {
   if (request.resourcePolicy?.allowRequestPatterns !== undefined) {
     body.allowRequestPattern = [...request.resourcePolicy.allowRequestPatterns];
   }
+
   return body;
 };
 
@@ -138,6 +144,7 @@ const actionName = (
 
 const actionBody = (request: PageCaptureRequest): Record<string, unknown> => {
   const body = requestBody(request);
+
   switch (request.action._tag) {
     case "CapturePageContent":
     case "CapturePageMarkdown":
@@ -167,8 +174,10 @@ const retryAfterMillis = (
   headers: Readonly<Record<string, string | undefined>>,
 ): number | undefined => {
   const seconds = Number(headers["retry-after"]);
+
   if (!Number.isSafeInteger(seconds) || seconds < 0) return undefined;
   const millis = seconds * 1_000;
+
   return Number.isSafeInteger(millis) ? millis : undefined;
 };
 
@@ -176,14 +185,17 @@ const browserMillis = (
   headers: Readonly<Record<string, string | undefined>>,
 ): number | undefined => {
   const millis = Number(headers["x-browser-ms-used"]);
+
   return Number.isSafeInteger(millis) && millis >= 0 ? millis : undefined;
 };
 
 /** Response framing is provider metadata, never content controlled by the rendered page. */
 const isJsonResponse = (headers: Readonly<Record<string, string | undefined>>): boolean => {
   const contentType = headers["content-type"];
+
   if (contentType === undefined) return false;
   const mediaType = contentType.split(";", 1)[0]?.trim().toLowerCase();
+
   return mediaType === "application/json" || mediaType?.endsWith("+json") === true;
 };
 
@@ -192,6 +204,7 @@ const readBoundedResponse = Effect.fn("BrowserRestCapture.readResponse")(functio
   request: PageCaptureRequest,
 ): Effect.fn.Return<string, PageCaptureError> {
   const decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: false });
+
   const chunks = yield* Stream.runFoldEffect<
     Uint8Array,
     HttpClientError.HttpClientError,
@@ -204,6 +217,7 @@ const readBoundedResponse = Effect.fn("BrowserRestCapture.readResponse")(functio
     () => ({ observed: 0, text: "" }),
     (state, chunk) => {
       const observed = state.observed + chunk.byteLength;
+
       if (observed > request.limits.maxOutputBytes) {
         return Effect.fail(
           PageCaptureOutputLimitError.make({
@@ -213,6 +227,7 @@ const readBoundedResponse = Effect.fn("BrowserRestCapture.readResponse")(functio
           }),
         );
       }
+
       return Effect.try({
         try: () => ({ observed, text: state.text + decoder.decode(chunk, { stream: true }) }),
         catch: (cause) => protocolError("Decoding the Browser Run response failed", cause),
@@ -225,6 +240,7 @@ const readBoundedResponse = Effect.fn("BrowserRestCapture.readResponse")(functio
         : protocolError("Reading the Browser Run response failed", error),
     ),
   );
+
   return yield* Effect.try({
     try: () => chunks.text + decoder.decode(),
     catch: (cause) => protocolError("Decoding the Browser Run response failed", cause),
@@ -237,6 +253,7 @@ const parseOutput = (
   apiToken: Redacted.Redacted<string>,
 ): PageCaptureOutput | PageCaptureNavigationError | PageCaptureProtocolError => {
   const envelope = decodeEnvelope(bodyText);
+
   if (Option.isNone(envelope)) {
     return protocolError(
       "The Browser Run response did not carry a valid response envelope",
@@ -255,6 +272,7 @@ const parseOutput = (
       if (typeof envelope.value.result !== "string") {
         return protocolError("The Browser Run response envelope carried a non-text result");
       }
+
       return action._tag === "CapturePageContent"
         ? PageContentCaptured.make({ html: envelope.value.result })
         : PageMarkdownCaptured.make({ markdown: envelope.value.result });
@@ -263,6 +281,7 @@ const parseOutput = (
         _tag: "PageLinksCaptured",
         links: envelope.value.result,
       });
+
       return Option.isSome(decoded)
         ? decoded.value
         : protocolError("Browser Run links did not return a bounded array of valid URLs");
@@ -272,6 +291,7 @@ const parseOutput = (
         _tag: "PageScrapeCaptured",
         groups: envelope.value.result,
       });
+
       return Option.isSome(decoded)
         ? decoded.value
         : protocolError("Browser Run scrape did not return bounded grouped element records");
@@ -292,6 +312,7 @@ const makeCapture = (
     request: PageCaptureRequest,
   ): Effect.fn.Return<PageCaptureResult, PageCaptureError> {
     const usesWorkersAi = request.action._tag === "CapturePageStructured";
+
     if (usesWorkersAi) {
       if (workersAi === undefined) {
         return yield* PageCaptureUnsupportedError.make({
@@ -318,6 +339,7 @@ const makeCapture = (
     }
     const action = actionName(request.action);
     const path = `${API_ORIGIN}/client/v4/accounts/${encodeURIComponent(options.accountId)}/browser-rendering/${action}`;
+
     const requestWithBody = yield* HttpClientRequest.post(path).pipe(
       request.engine === "kitesurf"
         ? HttpClientRequest.setUrlParam("browser", "kitesurf")
@@ -327,14 +349,18 @@ const makeCapture = (
       HttpClientRequest.bodyJson(actionBody(request)),
       Effect.mapError((cause) => protocolError("Encoding the Browser Run request failed", cause)),
     );
+
     const response = yield* client
       .execute(requestWithBody)
       .pipe(
         Effect.mapError((cause) => protocolError("Calling the Browser Run REST API failed", cause)),
       );
+
     const bodyText = yield* readBoundedResponse(response, request);
+
     if (response.status === 429) {
       const reason = isQuotaMessage(bodyText) ? "quota" : "rate";
+
       return yield* PageCaptureRateLimitedError.make({
         implementation: browserRestCaptureImplementation,
         reason,
@@ -361,6 +387,7 @@ const makeCapture = (
               `Browser Run answered HTTP ${String(response.status)}`,
               privateResponseCause(bodyText, options.apiToken),
             );
+
       return yield* error;
     }
     if (!isJsonResponse(response.headers)) {
@@ -370,12 +397,14 @@ const makeCapture = (
       );
     }
     const output = parseOutput(request.action, bodyText, options.apiToken);
+
     if (
       output._tag === "PageCaptureNavigationError" ||
       output._tag === "PageCaptureProtocolError"
     ) {
       return yield* output;
     }
+
     return PageCaptureResult.make({
       implementation: browserRestCaptureImplementation,
       output,
@@ -415,6 +444,7 @@ export const browserRestWorkersAiCaptureLayer = (
     Effect.gen(function* () {
       const client = yield* HttpClient.HttpClient;
       const workersAi = yield* BrowserQuickActionWorkersAi;
+
       return PageCapture.of({ capture: makeCapture(client, options, workersAi) });
     }),
   );