@mayurajs/cloudflare-quick-action 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,8 @@
+Mayura
+Copyright 2026 The Mayura Authors
+
+This product includes software developed by the Mayura contributors.
+
+Third-party dependencies retain their own copyright and license terms. Exact
+resolved versions are recorded in pnpm-lock.yaml and reviewed by the release
+artifact and dependency qualification procedures.

package/README.md

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# @mayurajs/cloudflare-quick-action
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Cloudflare Browser Run](https://developers.cloudflare.com/browser-run/quick-actions/)'s quick actions for Mayura —
+one call renders a page in Cloudflare's browser and gives back what was asked for — as a client and as tools, from
+any runtime with no dependency.
+
+```bash
+npm install mayura @mayurajs/cloudflare-quick-action
+```
+
+```ts
+import { cloudflareQuickActions, quickActionTools } from '@mayurajs/cloudflare-quick-action';
+
+const actions = cloudflareQuickActions({ accountId, apiToken });
+const markdown = await actions.markdown({ url: 'https://example.com/' });
+
+const tools = quickActionTools(actions, { origins: ['https://docs.example.com'], screenshot: true });
+// cloudflare.markdown, cloudflare.links, cloudflare.scrape and cloudflare.screenshot, permission web:cloudflare:read.
+```
+
+`apiToken` needs the **Browser Rendering - Edit** permission.
+
+## The client
+
+`cloudflareQuickActions({ accountId, apiToken })` has `markdown`, `content` (the rendered HTML), `links`, `scrape`
+(elements by CSS selector), `screenshot` (PNG), `pdf`, `json` (structured data by Cloudflare's model, billed as Workers
+AI), and `crawl.start`, `crawl.status` and `crawl.cancel`. Each takes the page's `url`, and optionally
+`allowRequestPattern`: regular expressions, outside which the page loads nothing. A failure names only its HTTP
+status, never what Cloudflare wrote.
+
+## Tools
+
+| Tool | Permission | Option |
+| --- | --- | --- |
+| `<name>.markdown`, `<name>.links`, `<name>.scrape` | `web:<name>:read` | always |
+| `<name>.screenshot`: the page as an image | `web:<name>:read` | `screenshot: true` |
+| `<name>.json`: structured data, by prompt and optional JSON Schema | `web:<name>:extract` | `json: true` |
+| `<name>.crawl`: up to `maxCrawlPages` pages of a site, as markdown | `web:<name>:crawl` | `crawl: true` |
+
+- **`origins` is required**: the sites the tools may read, as `createBrowsers` takes them, or `'all'`. A URL outside
+  them is refused, and comes back as the tool's result so the model can choose another. The page Cloudflare renders
+  is also kept to them: it loads no scripts, images or frames from elsewhere (`allowRequestPattern`).
+- A crawl stays on its site, polls until done, keeps only pages read within `origins`, and is cancelled when its call
+  is or after `crawlTimeoutMs` (5 minutes), so it stops spending.
+- Content is cut at `maxPageBytes` (64 KiB). `costMicros` charges each tool's calls to the run's budget; Cloudflare
+  bills browser time on its side (its free plan allows 10 browser-minutes a day, and REST calls slowly).
+- Page content is the tools' result for the model to read: treat it as untrusted text.
+- Options: `name` (`cloudflare`), `origins`, `screenshot`, `json`, `crawl`, `maxPageBytes`, `maxCrawlPages` (10, at most
+  100), `crawlTimeoutMs`, `costMicros`.
+
+For a browser to drive, see `@mayurajs/browser-cloudflare`. Apache-2.0.

package/dist/client.d.ts

@@ -0,0 +1,93 @@
+export interface QuickActionsOptions {
+    /** Your Cloudflare account id (32 hex characters). */
+    readonly accountId: string;
+    /** A Cloudflare API token with the "Browser Rendering - Edit" permission. Nothing is read from the environment. */
+    readonly apiToken: string;
+    /** For tests and proxies: the fetch to use. */
+    readonly fetch?: typeof fetch;
+    /** The API's address; `https://api.cloudflare.com` by default. */
+    readonly baseUrl?: string;
+}
+/** What every action renders: a page, and optionally only the requests it may make. */
+export interface PageRequest {
+    readonly url: string;
+    /** Regular expressions: the page loads only what matches one. */
+    readonly allowRequestPattern?: readonly string[];
+}
+export interface CallOptions {
+    readonly signal?: AbortSignal;
+}
+export interface ScrapedElement {
+    readonly text: string;
+    readonly html: string;
+    readonly attributes: readonly {
+        readonly name: string;
+        readonly value: string;
+    }[];
+}
+export interface CrawlStart {
+    readonly url: string;
+    /** Pages to read; 10 by default. */
+    readonly limit?: number;
+    readonly depth?: number;
+    readonly formats?: readonly ('markdown' | 'html')[];
+    readonly includePatterns?: readonly string[];
+    readonly excludePatterns?: readonly string[];
+    readonly allowRequestPattern?: readonly string[];
+}
+export type CrawlStatus = 'running' | 'completed' | 'errored' | 'cancelled_due_to_timeout' | 'cancelled_due_to_limits' | 'cancelled_by_user';
+export interface CrawlRecord {
+    readonly url: string;
+    readonly status: string;
+    readonly markdown?: string;
+    readonly html?: string;
+    readonly title?: string;
+    readonly httpStatus?: number;
+}
+export interface CrawlResult {
+    readonly id: string;
+    readonly status: CrawlStatus;
+    readonly total: number;
+    readonly finished: number;
+    readonly records: readonly CrawlRecord[];
+    readonly cursor?: string | number;
+}
+/** Cloudflare Browser Run's quick actions: one call renders a page and gives back what was asked for. */
+export interface QuickActions {
+    markdown(request: PageRequest, options?: CallOptions): Promise<string>;
+    /** The page's HTML once rendered. */
+    content(request: PageRequest, options?: CallOptions): Promise<string>;
+    links(request: PageRequest & {
+        readonly visibleLinksOnly?: boolean;
+        readonly excludeExternalLinks?: boolean;
+    }, options?: CallOptions): Promise<readonly string[]>;
+    scrape(request: PageRequest & {
+        readonly selectors: readonly string[];
+    }, options?: CallOptions): Promise<readonly {
+        readonly selector: string;
+        readonly results: readonly ScrapedElement[];
+    }[]>;
+    screenshot(request: PageRequest & {
+        readonly fullPage?: boolean;
+    }, options?: CallOptions): Promise<Uint8Array>;
+    pdf(request: PageRequest, options?: CallOptions): Promise<Uint8Array>;
+    /** Structured data from the page by Cloudflare's model (Workers AI, billed as such): a prompt, a JSON Schema, or both. */
+    json(request: PageRequest & {
+        readonly prompt?: string;
+        readonly schema?: Record<string, unknown>;
+    }, options?: CallOptions): Promise<unknown>;
+    readonly crawl: {
+        start(request: CrawlStart, options?: CallOptions): Promise<string>;
+        status(id: string, options?: CallOptions & {
+            readonly cursor?: string | number;
+            readonly limit?: number;
+        }): Promise<CrawlResult>;
+        cancel(id: string, options?: CallOptions): Promise<void>;
+    };
+}
+/**
+ * A client for Cloudflare Browser Run's REST quick actions, from any runtime with no dependency. Nothing it reads of
+ * Cloudflare's errors reaches its own: a failure names only its HTTP status.
+ */
+export declare function cloudflareQuickActions(options: QuickActionsOptions): QuickActions;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,134 @@
+import { MayuraError } from 'mayura';
+const statuses = ['running', 'completed', 'errored', 'cancelled_due_to_timeout', 'cancelled_due_to_limits', 'cancelled_by_user'];
+const failure = (status) => new MayuraError('TOOL_FAILED', status === 429 ? 'Cloudflare is rate limiting Browser Run requests (HTTP 429).' : `Cloudflare refused the request (HTTP ${status}).`);
+const invalid = () => new MayuraError('TOOL_FAILED', 'Cloudflare returned a response that is not valid.');
+/**
+ * A client for Cloudflare Browser Run's REST quick actions, from any runtime with no dependency. Nothing it reads of
+ * Cloudflare's errors reaches its own: a failure names only its HTTP status.
+ */
+export function cloudflareQuickActions(options) {
+    if (!options || typeof options.accountId !== 'string' || !/^[0-9a-f]{32}$/u.test(options.accountId))
+        throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): accountId must be a Cloudflare account id.');
+    if (typeof options.apiToken !== 'string' || !/^[A-Za-z0-9_-]{20,512}$/u.test(options.apiToken))
+        throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): apiToken must be a Cloudflare API token.');
+    if (options.fetch !== undefined && typeof options.fetch !== 'function')
+        throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): fetch must be a function.');
+    const base = (() => {
+        try {
+            const url = new URL(options.baseUrl ?? 'https://api.cloudflare.com');
+            if (url.protocol !== 'https:' && url.hostname !== '127.0.0.1' && url.hostname !== 'localhost')
+                throw new Error();
+            return url.origin;
+        }
+        catch {
+            throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): baseUrl must be an https URL.');
+        }
+    })();
+    const root = `${base}/client/v4/accounts/${options.accountId}/browser-run`;
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const headers = { authorization: `Bearer ${options.apiToken}`, 'content-type': 'application/json' };
+    const page = (request) => {
+        if (!request || typeof request.url !== 'string' || !/^https?:\/\//u.test(request.url))
+            throw new MayuraError('INVALID_INPUT', 'url must be an http(s) URL.');
+        return { url: request.url, ...(request.allowRequestPattern ? { allowRequestPattern: [...request.allowRequestPattern] } : {}) };
+    };
+    const send = async (method, path, body, signal) => {
+        const reply = await fetcher(`${root}${path}`, { method, headers, ...(signal ? { signal } : {}), ...(body === undefined ? {} : { body: JSON.stringify(body) }) });
+        if (!reply.ok) {
+            void reply.body?.cancel().catch(() => undefined);
+            throw failure(reply.status);
+        }
+        return reply;
+    };
+    /** The `result` of Cloudflare's JSON envelope. */
+    const result = async (reply) => {
+        const data = await reply.json().catch(() => undefined);
+        if (!data || data.success !== true)
+            throw invalid();
+        return data.result;
+    };
+    const bytes = async (reply) => {
+        if (/json/u.test(reply.headers.get('content-type') ?? '')) {
+            void reply.body?.cancel().catch(() => undefined);
+            throw invalid();
+        }
+        return new Uint8Array(await reply.arrayBuffer());
+    };
+    const text = (value) => { if (typeof value !== 'string')
+        throw invalid(); return value; };
+    const actions = {
+        markdown: async (request, call = {}) => text(await result(await send('POST', '/markdown', page(request), call.signal))),
+        content: async (request, call = {}) => {
+            const reply = await send('POST', '/content', page(request), call.signal);
+            // Cloudflare does not document whether HTML comes in its envelope or as itself: either is taken.
+            return /json/u.test(reply.headers.get('content-type') ?? '') ? text(await result(reply)) : reply.text();
+        },
+        links: async (request, call = {}) => {
+            const value = await result(await send('POST', '/links', { ...page(request), ...(request.visibleLinksOnly ? { visibleLinksOnly: true } : {}), ...(request.excludeExternalLinks ? { excludeExternalLinks: true } : {}) }, call.signal));
+            if (!Array.isArray(value))
+                throw invalid();
+            return value.filter((link) => typeof link === 'string');
+        },
+        scrape: async (request, call = {}) => {
+            if (!Array.isArray(request.selectors) || request.selectors.length === 0 || request.selectors.length > 20 || request.selectors.some(item => typeof item !== 'string' || item === '' || item.length > 500)) {
+                throw new MayuraError('INVALID_INPUT', 'selectors are 1 to 20 CSS selectors.');
+            }
+            const value = await result(await send('POST', '/scrape', { ...page(request), elements: request.selectors.map(selector => ({ selector })) }, call.signal));
+            if (!Array.isArray(value))
+                throw invalid();
+            return value.map(item => {
+                const entry = item;
+                return { selector: typeof entry?.selector === 'string' ? entry.selector : '', results: (Array.isArray(entry?.results) ? entry.results : []).map(found => {
+                        const element = found;
+                        return { text: typeof element?.text === 'string' ? element.text : '', html: typeof element?.html === 'string' ? element.html : '',
+                            attributes: (Array.isArray(element?.attributes) ? element.attributes : []).filter((attribute) => typeof attribute?.name === 'string' && typeof attribute?.value === 'string').map(({ name, value }) => ({ name, value })) };
+                    }) };
+            });
+        },
+        screenshot: async (request, call = {}) => bytes(await send('POST', '/screenshot', { ...page(request), screenshotOptions: { type: 'png', fullPage: request.fullPage === true } }, call.signal)),
+        pdf: async (request, call = {}) => bytes(await send('POST', '/pdf', page(request), call.signal)),
+        json: async (request, call = {}) => {
+            if (request.prompt === undefined && request.schema === undefined)
+                throw new MayuraError('INVALID_INPUT', 'json needs a prompt, a schema, or both.');
+            return result(await send('POST', '/json', { ...page(request), ...(request.prompt ? { prompt: request.prompt } : {}),
+                ...(request.schema ? { response_format: { type: 'json_schema', json_schema: request.schema } } : {}) }, call.signal));
+        },
+        crawl: Object.freeze({
+            start: async (request, call = {}) => {
+                const id = await result(await send('POST', '/crawl', { ...page(request), limit: request.limit ?? 10, ...(request.depth ? { depth: request.depth } : {}),
+                    formats: [...(request.formats ?? ['markdown'])],
+                    options: { includeSubdomains: false, includeExternalLinks: false,
+                        ...(request.includePatterns ? { includePatterns: [...request.includePatterns] } : {}), ...(request.excludePatterns ? { excludePatterns: [...request.excludePatterns] } : {}) } }, call.signal));
+                if (typeof id !== 'string' || !/^[A-Za-z0-9-]{1,128}$/u.test(id))
+                    throw invalid();
+                return id;
+            },
+            status: async (id, call = {}) => {
+                if (typeof id !== 'string' || !/^[A-Za-z0-9-]{1,128}$/u.test(id))
+                    throw new MayuraError('INVALID_INPUT', 'id must be a crawl job id.');
+                const query = new URLSearchParams({ limit: String(call.limit ?? 100), ...(call.cursor !== undefined ? { cursor: String(call.cursor) } : {}) });
+                const value = await result(await send('GET', `/crawl/${id}?${query}`, undefined, call.signal));
+                if (!value || !statuses.includes(value.status))
+                    throw invalid();
+                const records = (Array.isArray(value.records) ? value.records : []).flatMap(item => {
+                    const record = item;
+                    if (typeof record?.url !== 'string')
+                        return [];
+                    return [{ url: record.url, status: typeof record.status === 'string' ? record.status : '', ...(typeof record.markdown === 'string' ? { markdown: record.markdown } : {}),
+                            ...(typeof record.html === 'string' ? { html: record.html } : {}), ...(typeof record.metadata?.title === 'string' ? { title: record.metadata.title } : {}),
+                            ...(typeof record.metadata?.status === 'number' ? { httpStatus: record.metadata.status } : {}) }];
+                });
+                return { id, status: value.status, total: Number(value.total) || 0, finished: Number(value.finished) || 0, records,
+                    ...(typeof value.cursor === 'string' || typeof value.cursor === 'number' ? { cursor: value.cursor } : {}) };
+            },
+            cancel: async (id, call = {}) => {
+                if (typeof id !== 'string' || !/^[A-Za-z0-9-]{1,128}$/u.test(id))
+                    throw new MayuraError('INVALID_INPUT', 'id must be a crawl job id.');
+                const reply = await send('DELETE', `/crawl/${id}`, undefined, call.signal);
+                void reply.body?.cancel().catch(() => undefined);
+            },
+        }),
+    };
+    return Object.freeze(actions);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { MayuraError } from 'mayura';\n\nexport interface QuickActionsOptions {\n  /** Your Cloudflare account id (32 hex characters). */\n  readonly accountId: string;\n  /** A Cloudflare API token with the \"Browser Rendering - Edit\" permission. Nothing is read from the environment. */\n  readonly apiToken: string;\n  /** For tests and proxies: the fetch to use. */\n  readonly fetch?: typeof fetch;\n  /** The API's address; `https://api.cloudflare.com` by default. */\n  readonly baseUrl?: string;\n}\n\n/** What every action renders: a page, and optionally only the requests it may make. */\nexport interface PageRequest {\n  readonly url: string;\n  /** Regular expressions: the page loads only what matches one. */\n  readonly allowRequestPattern?: readonly string[];\n}\nexport interface CallOptions { readonly signal?: AbortSignal }\nexport interface ScrapedElement { readonly text: string; readonly html: string; readonly attributes: readonly { readonly name: string; readonly value: string }[] }\nexport interface CrawlStart {\n  readonly url: string;\n  /** Pages to read; 10 by default. */\n  readonly limit?: number;\n  readonly depth?: number;\n  readonly formats?: readonly ('markdown' | 'html')[];\n  readonly includePatterns?: readonly string[];\n  readonly excludePatterns?: readonly string[];\n  readonly allowRequestPattern?: readonly string[];\n}\nexport type CrawlStatus = 'running' | 'completed' | 'errored' | 'cancelled_due_to_timeout' | 'cancelled_due_to_limits' | 'cancelled_by_user';\nexport interface CrawlRecord { readonly url: string; readonly status: string; readonly markdown?: string; readonly html?: string; readonly title?: string; readonly httpStatus?: number }\nexport interface CrawlResult { readonly id: string; readonly status: CrawlStatus; readonly total: number; readonly finished: number; readonly records: readonly CrawlRecord[]; readonly cursor?: string | number }\n\n/** Cloudflare Browser Run's quick actions: one call renders a page and gives back what was asked for. */\nexport interface QuickActions {\n  markdown(request: PageRequest, options?: CallOptions): Promise<string>;\n  /** The page's HTML once rendered. */\n  content(request: PageRequest, options?: CallOptions): Promise<string>;\n  links(request: PageRequest & { readonly visibleLinksOnly?: boolean; readonly excludeExternalLinks?: boolean }, options?: CallOptions): Promise<readonly string[]>;\n  scrape(request: PageRequest & { readonly selectors: readonly string[] }, options?: CallOptions): Promise<readonly { readonly selector: string; readonly results: readonly ScrapedElement[] }[]>;\n  screenshot(request: PageRequest & { readonly fullPage?: boolean }, options?: CallOptions): Promise<Uint8Array>;\n  pdf(request: PageRequest, options?: CallOptions): Promise<Uint8Array>;\n  /** Structured data from the page by Cloudflare's model (Workers AI, billed as such): a prompt, a JSON Schema, or both. */\n  json(request: PageRequest & { readonly prompt?: string; readonly schema?: Record<string, unknown> }, options?: CallOptions): Promise<unknown>;\n  readonly crawl: {\n    start(request: CrawlStart, options?: CallOptions): Promise<string>;\n    status(id: string, options?: CallOptions & { readonly cursor?: string | number; readonly limit?: number }): Promise<CrawlResult>;\n    cancel(id: string, options?: CallOptions): Promise<void>;\n  };\n}\n\nconst statuses: readonly CrawlStatus[] = ['running', 'completed', 'errored', 'cancelled_due_to_timeout', 'cancelled_due_to_limits', 'cancelled_by_user'];\nconst failure = (status: number) => new MayuraError('TOOL_FAILED',\n  status === 429 ? 'Cloudflare is rate limiting Browser Run requests (HTTP 429).' : `Cloudflare refused the request (HTTP ${status}).`);\nconst invalid = () => new MayuraError('TOOL_FAILED', 'Cloudflare returned a response that is not valid.');\n\n/**\n * A client for Cloudflare Browser Run's REST quick actions, from any runtime with no dependency. Nothing it reads of\n * Cloudflare's errors reaches its own: a failure names only its HTTP status.\n */\nexport function cloudflareQuickActions(options: QuickActionsOptions): QuickActions {\n  if (!options || typeof options.accountId !== 'string' || !/^[0-9a-f]{32}$/u.test(options.accountId)) throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): accountId must be a Cloudflare account id.');\n  if (typeof options.apiToken !== 'string' || !/^[A-Za-z0-9_-]{20,512}$/u.test(options.apiToken)) throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): apiToken must be a Cloudflare API token.');\n  if (options.fetch !== undefined && typeof options.fetch !== 'function') throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): fetch must be a function.');\n  const base = (() => {\n    try { const url = new URL(options.baseUrl ?? 'https://api.cloudflare.com'); if (url.protocol !== 'https:' && url.hostname !== '127.0.0.1' && url.hostname !== 'localhost') throw new Error(); return url.origin; }\n    catch { throw new MayuraError('INVALID_CONFIG', 'cloudflareQuickActions(): baseUrl must be an https URL.'); }\n  })();\n  const root = `${base}/client/v4/accounts/${options.accountId}/browser-run`;\n  const fetcher = options.fetch ?? globalThis.fetch;\n  const headers = { authorization: `Bearer ${options.apiToken}`, 'content-type': 'application/json' };\n  const page = (request: PageRequest) => {\n    if (!request || typeof request.url !== 'string' || !/^https?:\\/\\//u.test(request.url)) throw new MayuraError('INVALID_INPUT', 'url must be an http(s) URL.');\n    return { url: request.url, ...(request.allowRequestPattern ? { allowRequestPattern: [...request.allowRequestPattern] } : {}) };\n  };\n  const send = async (method: 'GET' | 'POST' | 'DELETE', path: string, body: unknown, signal: AbortSignal | undefined) => {\n    const reply = await fetcher(`${root}${path}`, { method, headers, ...(signal ? { signal } : {}), ...(body === undefined ? {} : { body: JSON.stringify(body) }) });\n    if (!reply.ok) { void reply.body?.cancel().catch(() => undefined); throw failure(reply.status); }\n    return reply;\n  };\n  /** The `result` of Cloudflare's JSON envelope. */\n  const result = async (reply: Response): Promise<unknown> => {\n    const data = await reply.json().catch(() => undefined) as { success?: unknown; result?: unknown } | undefined;\n    if (!data || data.success !== true) throw invalid();\n    return data.result;\n  };\n  const bytes = async (reply: Response): Promise<Uint8Array> => {\n    if (/json/u.test(reply.headers.get('content-type') ?? '')) { void reply.body?.cancel().catch(() => undefined); throw invalid(); }\n    return new Uint8Array(await reply.arrayBuffer());\n  };\n  const text = (value: unknown) => { if (typeof value !== 'string') throw invalid(); return value; };\n\n  const actions: QuickActions = {\n    markdown: async (request, call = {}) => text(await result(await send('POST', '/markdown', page(request), call.signal))),\n    content: async (request, call = {}) => {\n      const reply = await send('POST', '/content', page(request), call.signal);\n      // Cloudflare does not document whether HTML comes in its envelope or as itself: either is taken.\n      return /json/u.test(reply.headers.get('content-type') ?? '') ? text(await result(reply)) : reply.text();\n    },\n    links: async (request, call = {}) => {\n      const value = await result(await send('POST', '/links', { ...page(request), ...(request.visibleLinksOnly ? { visibleLinksOnly: true } : {}), ...(request.excludeExternalLinks ? { excludeExternalLinks: true } : {}) }, call.signal));\n      if (!Array.isArray(value)) throw invalid();\n      return value.filter((link): link is string => typeof link === 'string');\n    },\n    scrape: async (request, call = {}) => {\n      if (!Array.isArray(request.selectors) || request.selectors.length === 0 || request.selectors.length > 20 || request.selectors.some(item => typeof item !== 'string' || item === '' || item.length > 500)) {\n        throw new MayuraError('INVALID_INPUT', 'selectors are 1 to 20 CSS selectors.');\n      }\n      const value = await result(await send('POST', '/scrape', { ...page(request), elements: request.selectors.map(selector => ({ selector })) }, call.signal));\n      if (!Array.isArray(value)) throw invalid();\n      return value.map(item => {\n        const entry = item as { selector?: unknown; results?: unknown };\n        return { selector: typeof entry?.selector === 'string' ? entry.selector : '', results: (Array.isArray(entry?.results) ? entry.results : []).map(found => {\n          const element = found as { text?: unknown; html?: unknown; attributes?: unknown };\n          return { text: typeof element?.text === 'string' ? element.text : '', html: typeof element?.html === 'string' ? element.html : '',\n            attributes: (Array.isArray(element?.attributes) ? element.attributes : []).filter((attribute): attribute is { name: string; value: string } =>\n              typeof (attribute as { name?: unknown })?.name === 'string' && typeof (attribute as { value?: unknown })?.value === 'string').map(({ name, value }) => ({ name, value })) };\n        }) };\n      });\n    },\n    screenshot: async (request, call = {}) => bytes(await send('POST', '/screenshot', { ...page(request), screenshotOptions: { type: 'png', fullPage: request.fullPage === true } }, call.signal)),\n    pdf: async (request, call = {}) => bytes(await send('POST', '/pdf', page(request), call.signal)),\n    json: async (request, call = {}) => {\n      if (request.prompt === undefined && request.schema === undefined) throw new MayuraError('INVALID_INPUT', 'json needs a prompt, a schema, or both.');\n      return result(await send('POST', '/json', { ...page(request), ...(request.prompt ? { prompt: request.prompt } : {}),\n        ...(request.schema ? { response_format: { type: 'json_schema', json_schema: request.schema } } : {}) }, call.signal));\n    },\n    crawl: Object.freeze({\n      start: async (request: CrawlStart, call: CallOptions = {}) => {\n        const id = await result(await send('POST', '/crawl', { ...page(request), limit: request.limit ?? 10, ...(request.depth ? { depth: request.depth } : {}),\n          formats: [...(request.formats ?? ['markdown'])],\n          options: { includeSubdomains: false, includeExternalLinks: false,\n            ...(request.includePatterns ? { includePatterns: [...request.includePatterns] } : {}), ...(request.excludePatterns ? { excludePatterns: [...request.excludePatterns] } : {}) } }, call.signal));\n        if (typeof id !== 'string' || !/^[A-Za-z0-9-]{1,128}$/u.test(id)) throw invalid();\n        return id;\n      },\n      status: async (id: string, call: CallOptions & { readonly cursor?: string | number; readonly limit?: number } = {}) => {\n        if (typeof id !== 'string' || !/^[A-Za-z0-9-]{1,128}$/u.test(id)) throw new MayuraError('INVALID_INPUT', 'id must be a crawl job id.');\n        const query = new URLSearchParams({ limit: String(call.limit ?? 100), ...(call.cursor !== undefined ? { cursor: String(call.cursor) } : {}) });\n        const value = await result(await send('GET', `/crawl/${id}?${query}`, undefined, call.signal)) as { id?: unknown; status?: unknown; total?: unknown; finished?: unknown; records?: unknown; cursor?: unknown } | undefined;\n        if (!value || !statuses.includes(value.status as CrawlStatus)) throw invalid();\n        const records = (Array.isArray(value.records) ? value.records : []).flatMap(item => {\n          const record = item as { url?: unknown; status?: unknown; markdown?: unknown; html?: unknown; metadata?: { title?: unknown; status?: unknown } };\n          if (typeof record?.url !== 'string') return [];\n          return [{ url: record.url, status: typeof record.status === 'string' ? record.status : '', ...(typeof record.markdown === 'string' ? { markdown: record.markdown } : {}),\n            ...(typeof record.html === 'string' ? { html: record.html } : {}), ...(typeof record.metadata?.title === 'string' ? { title: record.metadata.title } : {}),\n            ...(typeof record.metadata?.status === 'number' ? { httpStatus: record.metadata.status } : {}) }];\n        });\n        return { id, status: value.status as CrawlStatus, total: Number(value.total) || 0, finished: Number(value.finished) || 0, records,\n          ...(typeof value.cursor === 'string' || typeof value.cursor === 'number' ? { cursor: value.cursor } : {}) };\n      },\n      cancel: async (id: string, call: CallOptions = {}) => {\n        if (typeof id !== 'string' || !/^[A-Za-z0-9-]{1,128}$/u.test(id)) throw new MayuraError('INVALID_INPUT', 'id must be a crawl job id.');\n        const reply = await send('DELETE', `/crawl/${id}`, undefined, call.signal);\n        void reply.body?.cancel().catch(() => undefined);\n      },\n    }),\n  };\n  return Object.freeze(actions);\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { cloudflareQuickActions } from './client.js';
+export type { CallOptions, CrawlRecord, CrawlResult, CrawlStart, CrawlStatus, PageRequest, QuickActions, QuickActionsOptions, ScrapedElement } from './client.js';
+export { originPatterns, quickActionTools } from './tools.js';
+export type { QuickActionToolsOptions } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClK,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { cloudflareQuickActions } from './client.js';
+export { originPatterns, quickActionTools } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { cloudflareQuickActions } from './client.js';\nexport type { CallOptions, CrawlRecord, CrawlResult, CrawlStart, CrawlStatus, PageRequest, QuickActions, QuickActionsOptions, ScrapedElement } from './client.js';\nexport { originPatterns, quickActionTools } from './tools.js';\nexport type { QuickActionToolsOptions } from './tools.js';\n"]}

package/dist/tools.d.ts

@@ -0,0 +1,42 @@
+import { type AnyTool } from 'mayura';
+import type { QuickActions } from './client.js';
+export interface QuickActionToolsOptions {
+    /** Names the tools (`<name>.markdown`, ...) and their permissions (`web:<name>:read`, ...); `cloudflare` by default. */
+    readonly name?: string;
+    /**
+     * The sites the tools may read, as `createBrowsers` takes them: `['https://example.com', 'https://*.example.com']`,
+     * or `'all'`. Required: nothing is allowed by default. The page Cloudflare renders loads nothing from other sites.
+     */
+    readonly origins: 'all' | readonly string[];
+    /** Make `<name>.screenshot`, an image of a page; permission `web:<name>:read`. Off by default. */
+    readonly screenshot?: boolean;
+    /** Make `<name>.json`, structured data from a page by Cloudflare's model (Workers AI); permission `web:<name>:extract`. Off by default. */
+    readonly json?: boolean;
+    /** Make `<name>.crawl`, which reads many pages of a site; permission `web:<name>:crawl`. Off by default. */
+    readonly crawl?: boolean;
+    /** The most bytes of a page's content returned to the model; 64 KiB by default. */
+    readonly maxPageBytes?: number;
+    /** The most pages one crawl reads; 10 by default (at most 100). */
+    readonly maxCrawlPages?: number;
+    /** The longest one crawl runs before it is cancelled; 5 minutes by default. */
+    readonly crawlTimeoutMs?: number;
+    /** What each call costs at most, in micro-units of your budget currency, by tool; 0 by default. */
+    readonly costMicros?: {
+        readonly markdown?: number;
+        readonly links?: number;
+        readonly scrape?: number;
+        readonly screenshot?: number;
+        readonly json?: number;
+        readonly crawl?: number;
+    };
+}
+/** Request patterns that let a page load only from the origins (already checked by originPolicy). */
+export declare function originPatterns(origins: readonly string[]): string[];
+/**
+ * Cloudflare Browser Run's quick actions as tools: `<name>.markdown`, `<name>.links` and `<name>.scrape` read pages
+ * (`web:<name>:read`); screenshots, JSON extraction and crawls are each off until enabled. Every URL must be within
+ * `origins`, and the page Cloudflare renders loads nothing from elsewhere. Page content comes back as the tools'
+ * results, for the model to read: treat it as untrusted text.
+ */
+export declare function quickActionTools(actions: QuickActions, options: QuickActionToolsOptions): AnyTool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,OAAO,EAAgC,MAAM,QAAQ,CAAC;AAE/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACtC,wHAAwH;IACxH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,SAAS,MAAM,EAAE,CAAC;IAC5C,kGAAkG;IAClG,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,2IAA2I;IAC3I,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,mGAAmG;IACnG,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxL;AA+BD,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,EAAE,CAgInG"}