agents 0.30.0 → 0.31.0

package/dist/sub-routing.d.ts

@@ -1,16 +1,16 @@
 import {
-  An as getSubAgentByName,
-  Cn as BuildAgentPathOptions,
-  Dn as buildAgentUrl,
-  En as buildAgentPath,
-  Mn as routeSubAgentRequest,
-  On as buildSubAgentPath,
-  Sn as AgentPathStep,
-  Tn as SubAgentPathMatch,
-  jn as parseSubAgentPath,
-  kn as buildSubAgentPathUnchecked,
-  wn as SUB_PREFIX
-} from "./agent-routing-CDbpVjYq.js";
+  an as SUB_PREFIX,
+  cn as buildAgentUrl,
+  dn as getSubAgentByName,
+  fn as parseSubAgentPath,
+  in as BuildAgentPathOptions,
+  ln as buildSubAgentPath,
+  on as SubAgentPathMatch,
+  pn as routeSubAgentRequest,
+  rn as AgentPathStep,
+  sn as buildAgentPath,
+  un as buildSubAgentPathUnchecked
+} from "./agent-routing-wS1TimZ_.js";
 export {
   AgentPathStep,
   BuildAgentPathOptions,

package/dist/tool-CTp72Jb_.d.ts

@@ -168,16 +168,16 @@ declare function createHTTPWebSearch(
  * HTTP status, so every error has a code to branch on.
  */
 type WebSearchErrorCode =
-  /** No AI Gateway credits and no provider key for the search. */ | "web_search_payment_required" /** `byokAlias` names a key the gateway does not have. */
-    | "web_search_byok_not_configured" /** The query, limit, or provider was rejected. */
-    | "invalid_web_search_input" /** The gateway does not exist or is not set up. */
-    | "web_search_gateway_not_configured" /** The API token or binding is not allowed to search. */
-    | "web_search_unauthorized" /** Too many searches; retry later. */
-    | "web_search_rate_limited" /** The search took longer than the tool's `timeoutMs`. */
-    | "web_search_timeout" /** The API or the provider failed. */
-    | "web_search_unavailable" /** The Workers runtime has no `env.AI.websearch()`. */
-    | "web_search_unsupported_runtime" /** A code the API added after this release. */
-    | (string & {});
+  | /** No AI Gateway credits and no provider key for the search. */ "web_search_payment_required" /** `byokAlias` names a key the gateway does not have. */
+  | "web_search_byok_not_configured" /** The query, limit, or provider was rejected. */
+  | "invalid_web_search_input" /** The gateway does not exist or is not set up. */
+  | "web_search_gateway_not_configured" /** The API token or binding is not allowed to search. */
+  | "web_search_unauthorized" /** Too many searches; retry later. */
+  | "web_search_rate_limited" /** The search took longer than the tool's `timeoutMs`. */
+  | "web_search_timeout" /** The API or the provider failed. */
+  | "web_search_unavailable" /** The Workers runtime has no `env.AI.websearch()`. */
+  | "web_search_unsupported_runtime" /** A code the API added after this release. */
+  | (string & {});
 /** Why a search failed, with what the API said. */
 declare class WebSearchError extends Error {
   readonly name = "WebSearchError";

package/dist/tool-DoVberpN.d.ts

@@ -36,17 +36,17 @@ type WebFetchToolInput = {
 };
 /** How the content of a {@link WebFetchPage} was produced. */
 type WebFetchVia =
-  /** The server answered `text/markdown` (Markdown for Agents). */ | "markdown-negotiated" /** Converted to Markdown by Workers AI (`env.AI.toMarkdown`). */
-    | "converted" /** JSON, pretty-printed. */
-    | "json" /** Text passed through as served. */
-    | "text" /** `format: "raw"`: the body as served. */
-    | "raw"
-    /**
-     * Rendered in a browser first (Browser Run). Reserved: nothing produces
-     * it yet. It is in the union now so adding a browser source later doesn't
-     * break hosts' exhaustive switches.
-     */
-    | "rendered";
+  | /** The server answered `text/markdown` (Markdown for Agents). */ "markdown-negotiated" /** Converted to Markdown by Workers AI (`env.AI.toMarkdown`). */
+  | "converted" /** JSON, pretty-printed. */
+  | "json" /** Text passed through as served. */
+  | "text" /** `format: "raw"`: the body as served. */
+  | "raw"
+  /**
+   * Rendered in a browser first (Browser Run). Reserved: nothing produces
+   * it yet. It is in the union now so adding a browser source later doesn't
+   * break hosts' exhaustive switches.
+   */
+  | "rendered";
 /**
  * One fetched page, whole: what a `WebFetchSource` and `fetchWeb()`
  * return. The model never sees this directly; the tool stores one window of
@@ -184,17 +184,17 @@ declare function createDirectWebFetch(
  * to branch on.
  */
 type WebFetchErrorCode =
-  /** The URL or format was malformed or too long. */ | "invalid_web_fetch_input" /** The URL's scheme, credentials, or host isn't allowed here. */
-    | "web_fetch_disallowed_url" /** A redirect pointed at a URL that isn't allowed here, or from https to http. */
-    | "web_fetch_disallowed_redirect" /** More redirects than allowed, or a redirect loop. */
-    | "web_fetch_too_many_redirects" /** The fetch took longer than the tool's `timeoutMs` (on the error as `timeoutMs`). */
-    | "web_fetch_timeout" /** The body is larger than `maxBytes`. */
-    | "web_fetch_too_large" /** The body is binary, or a document requested with `format: "raw"`. */
-    | "web_fetch_unsupported_content_type" /** A 4xx/5xx response with an empty or non-textual body. */
-    | "web_fetch_http_error" /** The site answered with a bot challenge instead of the page. */
-    | "web_fetch_blocked" /** Workers AI could not convert the body to Markdown. */
-    | "web_fetch_conversion_failed" /** The network failed: before a response (DNS, TLS, connection) or while reading the body. */
-    | "web_fetch_unavailable";
+  | /** The URL or format was malformed or too long. */ "invalid_web_fetch_input" /** The URL's scheme, credentials, or host isn't allowed here. */
+  | "web_fetch_disallowed_url" /** A redirect pointed at a URL that isn't allowed here, or from https to http. */
+  | "web_fetch_disallowed_redirect" /** More redirects than allowed, or a redirect loop. */
+  | "web_fetch_too_many_redirects" /** The fetch took longer than the tool's `timeoutMs` (on the error as `timeoutMs`). */
+  | "web_fetch_timeout" /** The body is larger than `maxBytes`. */
+  | "web_fetch_too_large" /** The body is binary, or a document requested with `format: "raw"`. */
+  | "web_fetch_unsupported_content_type" /** A 4xx/5xx response with an empty or non-textual body. */
+  | "web_fetch_http_error" /** The site answered with a bot challenge instead of the page. */
+  | "web_fetch_blocked" /** Workers AI could not convert the body to Markdown. */
+  | "web_fetch_conversion_failed" /** The network failed: before a response (DNS, TLS, connection) or while reading the body. */
+  | "web_fetch_unavailable";
 /** Why a fetch failed. */
 declare class WebFetchError extends Error {
   readonly name = "WebFetchError";

package/dist/tool-helpers-BodWi4gd.js

@@ -0,0 +1,256 @@
+import { t as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-DhoDkSnH.js";
+import "./internal_context.js";
+import "./session-7CDgVE0z.js";
+import { t as redactBase64Payloads } from "./base64-redaction-C1Uu29t5.js";
+//#region src/browser/truncate.ts
+/**
+* Result truncation for the browser tools, copied from
+* `@cloudflare/codemode`'s `truncateResult` so `agents/browser` doesn't need
+* codemode. Internal — not an entry point.
+*
+* Structured values are truncated structurally: the output is always valid
+* JSON of the same shape, with the largest values cut first. A truncated
+* string ends with a marker, a truncated array ends with a marker element
+* counting the dropped items, and an object that had to lose entries carries a
+* marker entry naming the omitted keys. Every marker contains
+* `--- TRUNCATED ---` so callers and models can find them.
+*/
+/** ~4 characters per token is a reasonable cross-model estimate. */
+const CHARS_PER_TOKEN = 4;
+const DEFAULT_MAX_TOKENS = 6e3;
+const TRUNCATION_MARKER = "--- TRUNCATED ---";
+/**
+* The least a string or container is worth keeping at (see `floorSize`). A
+* value that would get fewer serialized characters than this is dropped in
+* favour of its siblings rather than reduced to a bare marker.
+*/
+const MIN_SLOT = 128;
+function budget(options) {
+	const maxTokens = options?.maxTokens ?? DEFAULT_MAX_TOKENS;
+	return {
+		maxChars: options?.maxChars ?? maxTokens * CHARS_PER_TOKEN,
+		maxTokens
+	};
+}
+/**
+* Truncate a text response to a character budget, appending a marker that notes
+* the original size so the model knows the output was clipped. Returns the
+* input unchanged when it is within budget.
+*/
+function truncateResponse(text, options) {
+	const { maxChars, maxTokens } = budget(options);
+	if (text.length <= maxChars) return text;
+	const estimatedTokens = Math.ceil(text.length / CHARS_PER_TOKEN);
+	return text.slice(0, maxChars) + `\n\n${TRUNCATION_MARKER}\nResponse was ~${estimatedTokens.toLocaleString()} tokens (limit: ${maxTokens.toLocaleString()}). Narrow the request to reduce response size.`;
+}
+/**
+* Truncate a structured result. Strings are truncated directly. Other values
+* pass through unchanged (same reference) when their JSON serialization is
+* within budget. When oversized, the value is shrunk structurally — largest
+* values first, deepest last — so the model gets a bounded value that is still
+* valid JSON of the original shape, with markers where content was cut.
+*
+* Values that can't be serialized (cycles, bigint, `undefined`) are returned
+* unchanged.
+*/
+function truncateResult(value, options) {
+	if (typeof value === "string") return truncateResponse(value, options);
+	let serialized;
+	try {
+		serialized = JSON.stringify(value);
+	} catch {
+		return value;
+	}
+	if (serialized === void 0) return value;
+	const { maxChars } = budget(options);
+	if (serialized.length <= maxChars) return value;
+	const shrunk = shrink(JSON.parse(serialized), maxChars);
+	return size(shrunk) <= maxChars ? shrunk : truncateResponse(serialized, options);
+}
+/** Serialized size in characters (compact JSON). */
+function size(value) {
+	return JSON.stringify(value).length;
+}
+/** Only strings and containers can give up characters; scalars are atomic. */
+function shrinkable(value) {
+	return typeof value === "string" || typeof value === "object" && !!value;
+}
+/**
+* The least budget a value is kept at; a scalar must fit whole. The floor
+* never exceeds half the container's own budget, so tiny budgets still keep
+* something rather than nothing.
+*/
+function floorSize(value, maxChars) {
+	const full = size(value);
+	return shrinkable(value) ? Math.min(full, MIN_SLOT, Math.max(2, Math.floor(maxChars / 2))) : full;
+}
+function shrink(value, maxChars) {
+	if (size(value) <= maxChars) return value;
+	if (typeof value === "string") return shrinkString(value, maxChars);
+	if (Array.isArray(value)) return shrinkArray(value, maxChars);
+	if (typeof value === "object" && value !== null) return shrinkObject(value, maxChars);
+	return value;
+}
+function shrinkString(value, maxChars) {
+	const suffix = ` ${TRUNCATION_MARKER} ${value.length.toLocaleString()} chars`;
+	let keep = Math.max(0, maxChars - suffix.length - 2);
+	let out = value.slice(0, keep) + suffix;
+	while (keep > 0 && size(out) > maxChars) {
+		keep = Math.max(0, keep - (size(out) - maxChars));
+		out = value.slice(0, keep) + suffix;
+	}
+	return size(out) <= maxChars ? out : TRUNCATION_MARKER.slice(0, Math.max(0, maxChars - 2));
+}
+/**
+* Share `available` characters across values by water-filling: values are
+* admitted smallest first, each taking the lesser of its full size and an
+* equal share of what is left. Requires `available >= Σ floorSize(values)`;
+* then every value receives at least its floor.
+*/
+function allocate(values, available) {
+	const sizes = values.map(size);
+	const order = sizes.map((_, i) => i).sort((a, b) => sizes[a] - sizes[b]);
+	const allocation = new Array(values.length);
+	let remaining = available;
+	let count = values.length;
+	for (const i of order) {
+		const alloc = Math.min(sizes[i], Math.floor(remaining / count));
+		allocation[i] = alloc;
+		remaining -= alloc;
+		count--;
+	}
+	return allocation;
+}
+function shrinkArray(items, maxChars) {
+	const marker = (dropped) => `${TRUNCATION_MARKER} ${dropped.toLocaleString()} more items`;
+	const floors = items.map((item) => floorSize(item, maxChars));
+	const skeleton = (count) => 2 + Math.max(0, count - 1);
+	let keep = items.length;
+	if (floors.reduce((n, f) => n + f, 0) + skeleton(keep) > maxChars) {
+		const tail = size(marker(items.length)) + 1;
+		let used = skeleton(0) + tail;
+		keep = 0;
+		while (keep < items.length && used + floors[keep] + 1 <= maxChars) {
+			used += floors[keep] + 1;
+			keep++;
+		}
+	}
+	const kept = items.slice(0, keep);
+	const dropped = items.length - keep;
+	const tail = dropped > 0 ? size(marker(dropped)) + (keep > 0 ? 1 : 0) : 0;
+	const allocation = allocate(kept, maxChars - skeleton(keep) - tail);
+	const out = kept.map((item, i) => shrink(item, allocation[i]));
+	if (dropped > 0 && size([...out, marker(dropped)]) <= maxChars) out.push(marker(dropped));
+	return out;
+}
+function shrinkObject(value, maxChars) {
+	const entries = Object.entries(value);
+	let markerKey = TRUNCATION_MARKER;
+	while (markerKey in value) markerKey += " ";
+	const keyCost = (key) => size(key) + 1;
+	const floors = entries.map(([k, v]) => keyCost(k) + floorSize(v, maxChars));
+	const floorOf = (chars) => Math.min(chars, MIN_SLOT, Math.max(2, Math.floor(maxChars / 2)));
+	const byValueSize = entries.map((_, i) => i).sort((a, b) => size(entries[b][1]) - size(entries[a][1]));
+	const dropped = /* @__PURE__ */ new Set();
+	let present = entries.length;
+	let floorsSum = floors.reduce((n, f) => n + f, 0);
+	let namesLength = 0;
+	const noteLength = () => `${dropped.size.toLocaleString()} keys omitted: `.length + namesLength + 2 * (dropped.size - 1);
+	const cost = () => {
+		const marker = dropped.size > 0 ? keyCost(markerKey) + floorOf(noteLength() + 2) : 0;
+		const count = present + (dropped.size > 0 ? 1 : 0);
+		return 2 + Math.max(0, count - 1) + floorsSum + marker;
+	};
+	for (const i of byValueSize) {
+		if (cost() <= maxChars) break;
+		dropped.add(i);
+		present--;
+		floorsSum -= floors[i];
+		namesLength += size(entries[i][0]) - 2;
+	}
+	const kept = entries.filter((_, i) => !dropped.has(i));
+	const omitted = [...dropped].sort((a, b) => a - b).map((i) => entries[i][0]);
+	const note = `${omitted.length.toLocaleString()} keys omitted: ${omitted.join(", ")}`;
+	if (cost() > maxChars) {
+		const room = maxChars - 2 - keyCost(markerKey);
+		return room >= 2 ? { [markerKey]: shrink(note, room) } : {};
+	}
+	const all = [...kept];
+	if (omitted.length > 0) all.push([markerKey, note]);
+	const fixed = 2 + Math.max(0, all.length - 1) + all.reduce((n, [k]) => n + keyCost(k), 0);
+	const allocation = allocate(all.map(([, v]) => v), maxChars - fixed);
+	const out = {};
+	all.forEach(([k, v], i) => {
+		out[k] = shrink(v, allocation[i]);
+	});
+	return out;
+}
+//#endregion
+//#region src/browser/tool-helpers.ts
+/** What `Page.captureScreenshot` can produce. */
+const SCREENSHOT_MEDIA_TYPES = /* @__PURE__ */ new Set([
+	"image/png",
+	"image/jpeg",
+	"image/webp"
+]);
+const BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
+/**
+* The screenshot the model's code returned, or `null` if it didn't return
+* one. The model writes this shape itself, so only an image type, base64
+* data, and the session's size limit count: anything else is treated as a
+* plain result and cut down like one, rather than kept whole or sent to the
+* model as an image.
+*/
+function browserScreenshotOutput(value) {
+	const outer = typeof value === "object" && value !== null ? value : null;
+	const result = outer && typeof outer.result === "object" && outer.result !== null ? outer.result : outer;
+	if (result?.type !== "browser_screenshot" || typeof result.mediaType !== "string" || typeof result.data !== "string" || !SCREENSHOT_MEDIA_TYPES.has(result.mediaType) || result.data.length > 1e6 || !BASE64.test(result.data)) return null;
+	return result;
+}
+function transformBrowserResult(value) {
+	return browserScreenshotOutput(value) ? value : truncateResult(redactBase64Payloads(value));
+}
+/**
+* @param notes Sentences appended when a screenshot collapses the output to
+* text, so notices on the output aren't lost with it.
+*/
+function browserExecuteModelOutput(output, notes = []) {
+	const screenshot = browserScreenshotOutput(output);
+	if (screenshot) {
+		const approximateBytes = Math.floor(screenshot.data.length * 3 / 4);
+		return {
+			type: "text",
+			value: [`Screenshot captured successfully (${screenshot.mediaType}, approximately ${approximateBytes.toLocaleString()} bytes); the image is kept for the UI and omitted here.`, ...notes].join(" ")
+		};
+	}
+	const redacted = redactBase64Payloads(typeof output === "object" && output !== null && !Array.isArray(output) ? (({ calls: _calls, ...rest }) => ({
+		...rest,
+		...Array.isArray(rest.logs) ? { logs: truncateResult(rest.logs) } : {}
+	}))(output) : output);
+	try {
+		const serialized = JSON.stringify(redacted);
+		return {
+			type: "json",
+			value: serialized === void 0 ? null : JSON.parse(serialized)
+		};
+	} catch {
+		return {
+			type: "text",
+			value: "Browser execution completed, but its result could not be serialized for model context."
+		};
+	}
+}
+/**
+* The Durable Object state to build the runtime in: the explicit `ctx` if
+* given, otherwise the current Agent's `ctx` (via `getCurrentAgent()`), so
+* `createBrowserRuntime` can be called from an Agent method without threading
+* `this.ctx` through.
+*/
+function resolveCtx(options) {
+	if (options.ctx) return options.ctx;
+	return (__DO_NOT_USE_WILL_BREAK__agentContext.getStore()?.agent)?.ctx;
+}
+//#endregion
+export { truncateResult as a, transformBrowserResult as i, browserScreenshotOutput as n, resolveCtx as r, browserExecuteModelOutput as t };
+
+//# sourceMappingURL=tool-helpers-BodWi4gd.js.map

package/dist/tool-helpers-BodWi4gd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers-BodWi4gd.js","names":["agentContext"],"sources":["../src/browser/truncate.ts","../src/browser/tool-helpers.ts"],"sourcesContent":["/**\n * Result truncation for the browser tools, copied from\n * `@cloudflare/codemode`'s `truncateResult` so `agents/browser` doesn't need\n * codemode. Internal — not an entry point.\n *\n * Structured values are truncated structurally: the output is always valid\n * JSON of the same shape, with the largest values cut first. A truncated\n * string ends with a marker, a truncated array ends with a marker element\n * counting the dropped items, and an object that had to lose entries carries a\n * marker entry naming the omitted keys. Every marker contains\n * `--- TRUNCATED ---` so callers and models can find them.\n */\n\n/** ~4 characters per token is a reasonable cross-model estimate. */\nconst CHARS_PER_TOKEN = 4;\nconst DEFAULT_MAX_TOKENS = 6000;\nconst TRUNCATION_MARKER = \"--- TRUNCATED ---\";\n/**\n * The least a string or container is worth keeping at (see `floorSize`). A\n * value that would get fewer serialized characters than this is dropped in\n * favour of its siblings rather than reduced to a bare marker.\n */\nconst MIN_SLOT = 128;\n\ntype TruncateOptions = {\n  /**\n   * Maximum characters in the (serialized) output before truncation kicks in.\n   * Defaults to `maxTokens * 4`.\n   */\n  maxChars?: number;\n  /** Token budget used to derive the default `maxChars`. Defaults to 6000. */\n  maxTokens?: number;\n};\n\nfunction budget(options?: TruncateOptions): {\n  maxChars: number;\n  maxTokens: number;\n} {\n  const maxTokens = options?.maxTokens ?? DEFAULT_MAX_TOKENS;\n  const maxChars = options?.maxChars ?? maxTokens * CHARS_PER_TOKEN;\n  return { maxChars, maxTokens };\n}\n\n/**\n * Truncate a text response to a character budget, appending a marker that notes\n * the original size so the model knows the output was clipped. Returns the\n * input unchanged when it is within budget.\n */\nfunction truncateResponse(text: string, options?: TruncateOptions): string {\n  const { maxChars, maxTokens } = budget(options);\n  if (text.length <= maxChars) return text;\n\n  const estimatedTokens = Math.ceil(text.length / CHARS_PER_TOKEN);\n  return (\n    text.slice(0, maxChars) +\n    `\\n\\n${TRUNCATION_MARKER}\\nResponse was ~${estimatedTokens.toLocaleString()} tokens ` +\n    `(limit: ${maxTokens.toLocaleString()}). Narrow the request to reduce response size.`\n  );\n}\n\n/**\n * Truncate a structured result. Strings are truncated directly. Other values\n * pass through unchanged (same reference) when their JSON serialization is\n * within budget. When oversized, the value is shrunk structurally — largest\n * values first, deepest last — so the model gets a bounded value that is still\n * valid JSON of the original shape, with markers where content was cut.\n *\n * Values that can't be serialized (cycles, bigint, `undefined`) are returned\n * unchanged.\n */\nexport function truncateResult(\n  value: unknown,\n  options?: TruncateOptions\n): unknown {\n  if (typeof value === \"string\") return truncateResponse(value, options);\n\n  let serialized: string | undefined;\n  try {\n    serialized = JSON.stringify(value);\n  } catch {\n    return value;\n  }\n  if (serialized === undefined) return value;\n\n  const { maxChars } = budget(options);\n  if (serialized.length <= maxChars) return value;\n\n  // Re-parse so `toJSON`, class instances and `undefined` members are seen in\n  // their serialized form — the shape the model would receive anyway.\n  const shrunk = shrink(JSON.parse(serialized) as Json, maxChars);\n  // `shrink` honours its budget for anything a container can hold; only a\n  // scalar (a number too long for the budget) can still miss it.\n  return size(shrunk) <= maxChars\n    ? shrunk\n    : truncateResponse(serialized, options);\n}\n\n// ---------------------------------------------------------------------------\n// Structural shrinking\n// ---------------------------------------------------------------------------\n//\n// Every `shrink*` below returns a value whose compact serialization fits the\n// budget it was given, provided the budget can hold an empty container (2\n// chars). Containers share their budget by water-filling: each child is owed\n// at least its floor (`floorSize`), small children keep their full size, and\n// the largest children absorb the cut. A container only drops children when\n// even their floors cannot fit — arrays drop from the tail (order carries\n// meaning), objects drop their largest values first (keys are all meaningful).\n\ntype Json = string | number | boolean | null | Json[] | { [key: string]: Json };\n\n/** Serialized size in characters (compact JSON). */\nfunction size(value: Json): number {\n  return JSON.stringify(value).length;\n}\n\n/** Only strings and containers can give up characters; scalars are atomic. */\nfunction shrinkable(value: Json): boolean {\n  return typeof value === \"string\" || (typeof value === \"object\" && !!value);\n}\n\n/**\n * The least budget a value is kept at; a scalar must fit whole. The floor\n * never exceeds half the container's own budget, so tiny budgets still keep\n * something rather than nothing.\n */\nfunction floorSize(value: Json, maxChars: number): number {\n  const full = size(value);\n  return shrinkable(value)\n    ? Math.min(full, MIN_SLOT, Math.max(2, Math.floor(maxChars / 2)))\n    : full;\n}\n\nfunction shrink(value: Json, maxChars: number): Json {\n  if (size(value) <= maxChars) return value;\n  if (typeof value === \"string\") return shrinkString(value, maxChars);\n  if (Array.isArray(value)) return shrinkArray(value, maxChars);\n  if (typeof value === \"object\" && value !== null) {\n    return shrinkObject(value, maxChars);\n  }\n  return value;\n}\n\nfunction shrinkString(value: string, maxChars: number): string {\n  const suffix = ` ${TRUNCATION_MARKER} ${value.length.toLocaleString()} chars`;\n  let keep = Math.max(0, maxChars - suffix.length - 2);\n  let out = value.slice(0, keep) + suffix;\n  // Escapes inflate the serialized form; back off until it fits.\n  while (keep > 0 && size(out) > maxChars) {\n    keep = Math.max(0, keep - (size(out) - maxChars));\n    out = value.slice(0, keep) + suffix;\n  }\n  // No room for a prefix and the size note: keep as much of the marker as fits.\n  return size(out) <= maxChars\n    ? out\n    : TRUNCATION_MARKER.slice(0, Math.max(0, maxChars - 2));\n}\n\n/**\n * Share `available` characters across values by water-filling: values are\n * admitted smallest first, each taking the lesser of its full size and an\n * equal share of what is left. Requires `available >= Σ floorSize(values)`;\n * then every value receives at least its floor.\n */\nfunction allocate(values: Json[], available: number): number[] {\n  const sizes = values.map(size);\n  const order = sizes.map((_, i) => i).sort((a, b) => sizes[a] - sizes[b]);\n  const allocation = new Array<number>(values.length);\n  let remaining = available;\n  let count = values.length;\n  for (const i of order) {\n    const alloc = Math.min(sizes[i], Math.floor(remaining / count));\n    allocation[i] = alloc;\n    remaining -= alloc;\n    count--;\n  }\n  return allocation;\n}\n\nfunction shrinkArray(items: Json[], maxChars: number): Json[] {\n  const marker = (dropped: number) =>\n    `${TRUNCATION_MARKER} ${dropped.toLocaleString()} more items`;\n  const floors = items.map((item) => floorSize(item, maxChars));\n  const skeleton = (count: number) => 2 + Math.max(0, count - 1);\n\n  // Keep everything when every floor fits.\n  let keep = items.length;\n  if (floors.reduce((n, f) => n + f, 0) + skeleton(keep) > maxChars) {\n    // Otherwise keep the longest prefix whose floors fit beside a tail marker\n    // (sized for the largest possible count, so the real one always fits).\n    const tail = size(marker(items.length)) + 1;\n    let used = skeleton(0) + tail;\n    keep = 0;\n    while (keep < items.length && used + floors[keep] + 1 <= maxChars) {\n      used += floors[keep] + 1;\n      keep++;\n    }\n  }\n\n  const kept = items.slice(0, keep);\n  const dropped = items.length - keep;\n  const tail = dropped > 0 ? size(marker(dropped)) + (keep > 0 ? 1 : 0) : 0;\n  const allocation = allocate(kept, maxChars - skeleton(keep) - tail);\n  const out = kept.map((item, i) => shrink(item, allocation[i]));\n  if (dropped > 0 && size([...out, marker(dropped)]) <= maxChars) {\n    out.push(marker(dropped));\n  }\n  return out;\n}\n\nfunction shrinkObject(\n  value: { [key: string]: Json },\n  maxChars: number\n): { [key: string]: Json } {\n  const entries = Object.entries(value);\n  // The marker entry must not shadow a real key.\n  let markerKey = TRUNCATION_MARKER;\n  while (markerKey in value) markerKey += \" \";\n  const keyCost = (key: string) => size(key) + 1;\n  const floors = entries.map(([k, v]) => keyCost(k) + floorSize(v, maxChars));\n  const floorOf = (chars: number) =>\n    Math.min(chars, MIN_SLOT, Math.max(2, Math.floor(maxChars / 2)));\n\n  // Drop the largest values first, only until the remaining floors fit. Costs\n  // are tracked incrementally so a wide object stays linear in its key count;\n  // the marker note's cost is derived arithmetically from the omitted names.\n  const byValueSize = entries\n    .map((_, i) => i)\n    .sort((a, b) => size(entries[b][1]) - size(entries[a][1]));\n  const dropped = new Set<number>();\n  let present = entries.length;\n  let floorsSum = floors.reduce((n, f) => n + f, 0);\n  let namesLength = 0;\n  const noteLength = () =>\n    `${dropped.size.toLocaleString()} keys omitted: `.length +\n    namesLength +\n    2 * (dropped.size - 1);\n  const cost = () => {\n    const marker =\n      dropped.size > 0 ? keyCost(markerKey) + floorOf(noteLength() + 2) : 0;\n    const count = present + (dropped.size > 0 ? 1 : 0);\n    return 2 + Math.max(0, count - 1) + floorsSum + marker;\n  };\n  for (const i of byValueSize) {\n    if (cost() <= maxChars) break;\n    dropped.add(i);\n    present--;\n    floorsSum -= floors[i];\n    namesLength += size(entries[i][0]) - 2;\n  }\n\n  const kept = entries.filter((_, i) => !dropped.has(i));\n  const omitted = [...dropped].sort((a, b) => a - b).map((i) => entries[i][0]);\n  const note = `${omitted.length.toLocaleString()} keys omitted: ${omitted.join(\", \")}`;\n  if (cost() > maxChars) {\n    // Not even the marker fits at its floor: keep as much of it as there is\n    // room for, or nothing.\n    const room = maxChars - 2 - keyCost(markerKey);\n    return room >= 2 ? { [markerKey]: shrink(note, room) } : {};\n  }\n  const all: [string, Json][] = [...kept];\n  if (omitted.length > 0) all.push([markerKey, note]);\n  const fixed =\n    2 + Math.max(0, all.length - 1) + all.reduce((n, [k]) => n + keyCost(k), 0);\n  // The note is shrunk like any other value, so it can never overshoot.\n  const allocation = allocate(\n    all.map(([, v]) => v),\n    maxChars - fixed\n  );\n  const out: { [key: string]: Json } = {};\n  all.forEach(([k, v], i) => {\n    out[k] = shrink(v, allocation[i]);\n  });\n  return out;\n}\n","/**\n * Helpers shared by the browser tools: `createBrowserTools` in `ai.ts`, and\n * the `browserTool` adapters in `tools/`. Internal — not an entry point.\n */\nimport type { JSONValue } from \"ai\";\nimport { DEFAULT_MAX_RESULT_BYTES } from \"./session\";\nimport { truncateResult } from \"./truncate\";\nimport { redactBase64Payloads } from \"../core/base64-redaction\";\nimport { __DO_NOT_USE_WILL_BREAK__agentContext as agentContext } from \"../internal_context\";\n\ninterface BrowserScreenshotOutput {\n  type: \"browser_screenshot\";\n  mediaType: string;\n  data: string;\n}\n\n/** What `Page.captureScreenshot` can produce. */\nconst SCREENSHOT_MEDIA_TYPES = new Set([\n  \"image/png\",\n  \"image/jpeg\",\n  \"image/webp\"\n]);\nconst BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;\n\n/**\n * The screenshot the model's code returned, or `null` if it didn't return\n * one. The model writes this shape itself, so only an image type, base64\n * data, and the session's size limit count: anything else is treated as a\n * plain result and cut down like one, rather than kept whole or sent to the\n * model as an image.\n */\nexport function browserScreenshotOutput(\n  value: unknown\n): BrowserScreenshotOutput | null {\n  const outer =\n    typeof value === \"object\" && value !== null\n      ? (value as Record<string, unknown>)\n      : null;\n  const result =\n    outer && typeof outer.result === \"object\" && outer.result !== null\n      ? (outer.result as Record<string, unknown>)\n      : outer;\n  if (\n    result?.type !== \"browser_screenshot\" ||\n    typeof result.mediaType !== \"string\" ||\n    typeof result.data !== \"string\" ||\n    !SCREENSHOT_MEDIA_TYPES.has(result.mediaType) ||\n    result.data.length > DEFAULT_MAX_RESULT_BYTES ||\n    !BASE64.test(result.data)\n  ) {\n    return null;\n  }\n  return result as unknown as BrowserScreenshotOutput;\n}\n\nexport function transformBrowserResult(value: unknown): unknown {\n  // Keep canonical screenshot output intact for UIMessage persistence and the\n  // chat renderer. Other results are redacted before truncation so a nested\n  // binary payload cannot become a large serialized preview.\n  return browserScreenshotOutput(value)\n    ? value\n    : truncateResult(redactBase64Payloads(value));\n}\n\n/** What the model sees in place of a browser tool's output. */\nexport type BrowserModelOutput =\n  | { type: \"text\"; value: string }\n  | { type: \"json\"; value: JSONValue };\n\n/**\n * @param notes Sentences appended when a screenshot collapses the output to\n * text, so notices on the output aren't lost with it.\n */\nexport function browserExecuteModelOutput(\n  output: unknown,\n  notes: string[] = []\n): BrowserModelOutput {\n  const screenshot = browserScreenshotOutput(output);\n  if (screenshot) {\n    const approximateBytes = Math.floor((screenshot.data.length * 3) / 4);\n    return {\n      type: \"text\",\n      value: [\n        `Screenshot captured successfully (${screenshot.mediaType}, approximately ${approximateBytes.toLocaleString()} bytes); the image is kept for the UI and omitted here.`,\n        ...notes\n      ].join(\" \")\n    };\n  }\n\n  // `calls`, the durable audit log `createBrowserTools` adds, stays on the\n  // persisted part and never enters the model's context, and the sandbox\n  // `logs` are bounded like a result.\n  const modelFacing =\n    typeof output === \"object\" && output !== null && !Array.isArray(output)\n      ? (({ calls: _calls, ...rest }: { calls?: unknown; logs?: unknown }) => ({\n          ...rest,\n          ...(Array.isArray(rest.logs)\n            ? { logs: truncateResult(rest.logs) }\n            : {})\n        }))(output)\n      : output;\n  const redacted = redactBase64Payloads(modelFacing);\n  try {\n    const serialized = JSON.stringify(redacted);\n    return {\n      type: \"json\",\n      value:\n        serialized === undefined ? null : (JSON.parse(serialized) as JSONValue)\n    };\n  } catch {\n    return {\n      type: \"text\",\n      value:\n        \"Browser execution completed, but its result could not be serialized for model context.\"\n    };\n  }\n}\n\n/**\n * The Durable Object state to build the runtime in: the explicit `ctx` if\n * given, otherwise the current Agent's `ctx` (via `getCurrentAgent()`), so\n * `createBrowserRuntime` can be called from an Agent method without threading\n * `this.ctx` through.\n */\nexport function resolveCtx(options: {\n  ctx?: DurableObjectState;\n}): DurableObjectState | undefined {\n  if (options.ctx) return options.ctx;\n  const agent = agentContext.getStore()?.agent as\n    | { ctx?: DurableObjectState }\n    | undefined;\n  return agent?.ctx;\n}\n"],"mappings":"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"}

package/dist/{transport-CPh7YGiw.d.ts → transport-5moD2pW5.d.ts}

@@ -96,8 +96,6 @@ type RerankingCatalogId = {
  *
  * Third-party models are not ids here — they are model objects built by their
  * own provider package and routed through AI Gateway.
- *
- * @experimental This surface is experimental and may change.
  */
 type WorkersAIModelId =
   | Extract<
@@ -116,8 +114,6 @@ type WorkersAIModelId =
  * which order, with what rate limits or budgets — and called through the
  * Workers AI run path like a model. It answers in the OpenAI chat-completions
  * shape whatever model served it, so it is a language model only.
- *
- * @experimental This surface is experimental and may change.
  */
 type DynamicRouteId = `dynamic/${string}`;
 /**
@@ -130,8 +126,6 @@ type DynamicRouteId = `dynamic/${string}`;
  * `env.AI.run`, where AI Gateway's `/run` engine picks the provider, converts
  * the request, and bills through Unified Billing or a key stored on the
  * gateway.
- *
- * @experimental This surface is experimental and may change.
  */
 type CatalogModelId = `${string}/${string}`;
 /**
@@ -139,8 +133,6 @@ type CatalogModelId = `${string}/${string}`;
  *
  * The modality methods are Workers AI only — there is no vendor route for them
  * — so, like {@link WorkersAIModelId}, they take `@cf/` ids and nothing else.
- *
- * @experimental This surface is experimental and may change.
  */
 type CloudflareEmbeddingModelId =
   | Extract<
@@ -161,8 +153,6 @@ type CloudflareEmbeddingModelId =
  * `prompt`, which the JSON run path cannot carry — live, the run path answers
  * `400 Bad input: required properties at "/" are 'multipart'`. Suggesting an
  * id that always 400s is worse than not suggesting it.
- *
- * @experimental This surface is experimental and may change.
  */
 type KnownImageModelId =
   | "@cf/black-forest-labs/flux-1-schnell"
@@ -170,8 +160,6 @@ type KnownImageModelId =
   | "@cf/leonardo/phoenix-1.0";
 /**
  * An image model id accepted by `ai.image()`.
- *
- * @experimental This surface is experimental and may change.
  */
 type CloudflareImageModelId =
   | Extract<
@@ -182,8 +170,6 @@ type CloudflareImageModelId =
 /**
  * Workers AI text-to-speech ids without a {@link BaseAiTextToSpeech} entry.
  * Curated for autocomplete only.
- *
- * @experimental This surface is experimental and may change.
  */
 type KnownSpeechModelId =
   | "@cf/deepgram/aura-1"
@@ -191,8 +177,6 @@ type KnownSpeechModelId =
   | "@cf/deepgram/aura-2-es";
 /**
  * A text-to-speech model id accepted by `ai.speech()`.
- *
- * @experimental This surface is experimental and may change.
  */
 type CloudflareSpeechModelId =
   | Extract<
@@ -211,8 +195,6 @@ type UnsupportedTranscriptionId = "@cf/deepgram/flux";
  * Deepgram's Flux (`@cf/deepgram/flux`) is deliberately not suggested: it
  * takes websocket connections only, so this provider answers a clear error
  * for it rather than a 400.
- *
- * @experimental This surface is experimental and may change.
  */
 type CloudflareTranscriptionModelId =
   | Extract<
@@ -226,8 +208,6 @@ type CloudflareTranscriptionModelId =
   | (`@cf/${string}` & {});
 /**
  * A reranking model id accepted by `ai.reranking()`.
- *
- * @experimental This surface is experimental and may change.
  */
 type CloudflareRerankingModelId =
   | Extract<RerankingCatalogId, `@cf/${string}`>
@@ -238,8 +218,6 @@ type CloudflareRerankingModelId =
  * AI Gateway settings for a request. The gateway is an option, not a separate
  * product: every call goes through one, and `id` defaults to `"default"`,
  * which Cloudflare creates on first use.
- *
- * @experimental This surface is experimental and may change.
  */
 interface GatewayOptions {
   /** Gateway id. Defaults to `"default"` (auto-created on first use). */
@@ -283,15 +261,11 @@ interface GatewayOptions {
  * API token. Both take the same routes — a model id to the run path, a
  * vendor's model object to the provider-native path — and the same gateway
  * options.
- *
- * @experimental This surface is experimental and may change.
  */
 type AISettings = (BindingAccess | AccountAccess) & ProviderGatewaySettings;
 /**
  * Reach Cloudflare through the `AI` binding: no account id or token to hold,
  * and the gateway is the Worker's own account's.
- *
- * @experimental This surface is experimental and may change.
  */
 interface BindingAccess {
   /** The `AI` binding from a Worker's env. */
@@ -306,8 +280,6 @@ interface BindingAccess {
  * a model object to the provider-native path
  * (`gateway.ai.cloudflare.com/v1/{accountId}/{gateway}/...`). The token is
  * only ever sent to those two hosts.
- *
- * @experimental This surface is experimental and may change.
  */
 interface AccountAccess {
   /** The account the gateway belongs to. */
@@ -323,8 +295,6 @@ interface AccountAccess {
 /**
  * Provider-wide gateway defaults, in either spelling: nested under `gateway`,
  * or flat (`{ id: "prod", cacheTtl: 60 }`). Both merge, the flat key winning.
- *
- * @experimental This surface is experimental and may change.
  */
 interface ProviderGatewaySettings extends GatewayOptions {
   /** Gateway id or full gateway options. */
@@ -343,8 +313,6 @@ interface ProviderGatewaySettings extends GatewayOptions {
  * default; a module whose legs may also be model objects says so
  * (`ModelOptions<WorkersAIModelId | LanguageModelV4>`) rather than rebuilding
  * the type.
- *
- * @experimental This surface is experimental and may change.
  */
 interface ModelOptions<Leg = WorkersAIModelId> extends ProviderGatewaySettings {
   /**
@@ -382,8 +350,6 @@ interface ResolvedGateway extends GatewayOptions {
 //#region src/models/core/errors.d.ts
 /**
  * Coarse classification of a failed Cloudflare AI call.
- *
- * @experimental This surface is experimental and may change.
  */
 type CloudflareAIErrorCode =
   | "auth"
@@ -395,8 +361,6 @@ type CloudflareAIErrorCode =
   | "unknown";
 /**
  * One leg of a {@link CloudflareAIError} fallback chain.
- *
- * @experimental This surface is experimental and may change.
  */
 interface CloudflareAIAttempt {
   /** The model id that was tried. */
@@ -410,8 +374,6 @@ interface CloudflareAIAttempt {
  * modules wrap it into their own error type at their boundary (the AI SDK
  * module into an `APICallError`, so `ai`'s retry loop honours
  * {@link CloudflareAIError.isRetryable}).
- *
- * @experimental This surface is experimental and may change.
  */
 declare class CloudflareAIError extends Error {
   /** HTTP status, when the failure carried one. */
@@ -473,8 +435,6 @@ declare class CloudflareAIError extends Error {
 /**
  * The gateway provider slugs this table maps onto. A subset of the ambient
  * `AIGatewayProviders` union; {@link GatewayProviderNameCheck} keeps it one.
- *
- * @experimental This surface is experimental and may change.
  */
 declare const GATEWAY_PROVIDER_NAMES: readonly [
   "workers-ai",
@@ -499,8 +459,6 @@ declare const GATEWAY_PROVIDER_NAMES: readonly [
 ];
 /**
  * A gateway provider slug.
- *
- * @experimental This surface is experimental and may change.
  */
 type GatewayProviderName = (typeof GATEWAY_PROVIDER_NAMES)[number];
 //#endregion
@@ -620,4 +578,4 @@ export {
   KnownImageModelId as v,
   KnownSpeechModelId as y
 };
-//# sourceMappingURL=transport-CPh7YGiw.d.ts.map
+//# sourceMappingURL=transport-5moD2pW5.d.ts.map

package/dist/types-D2naO3rA.d.ts

@@ -0,0 +1,49 @@
+import { ClientOptions } from "@modelcontextprotocol/client";
+
+//#region src/mcp/types.d.ts
+type MaybePromise<T> = T | Promise<T>;
+type HttpTransportType = "sse" | "streamable-http";
+type BaseTransportType = HttpTransportType | "rpc";
+type TransportType = BaseTransportType | "auto";
+/**
+ * Agents-owned MCP client configuration. Only these SDK behaviours are part of
+ * the supported interface; new beta SDK fields are not persisted or exposed
+ * accidentally.
+ */
+interface McpClientOptions {
+  capabilities?: ClientOptions["capabilities"];
+  jsonSchemaValidator?: ClientOptions["jsonSchemaValidator"];
+  versionNegotiation?: ClientOptions["versionNegotiation"];
+  inputRequired?: ClientOptions["inputRequired"];
+  listChanged?: ClientOptions["listChanged"];
+  supportedProtocolVersions?: ClientOptions["supportedProtocolVersions"];
+  enforceStrictCapabilities?: ClientOptions["enforceStrictCapabilities"];
+  debouncedNotificationMethods?: ClientOptions["debouncedNotificationMethods"];
+  listMaxPages?: ClientOptions["listMaxPages"];
+  responseCacheStore?: ClientOptions["responseCacheStore"];
+  cachePartition?: ClientOptions["cachePartition"];
+  defaultCacheTtlMs?: ClientOptions["defaultCacheTtlMs"];
+}
+interface CORSOptions {
+  origin?: string;
+  methods?: string;
+  headers?: string;
+  maxAge?: number;
+  exposeHeaders?: string;
+}
+interface ServeOptions {
+  binding?: string;
+  corsOptions?: CORSOptions;
+  transport?: TransportType;
+  jurisdiction?: DurableObjectJurisdiction;
+}
+//#endregion
+export {
+  ServeOptions as a,
+  McpClientOptions as i,
+  CORSOptions as n,
+  TransportType as o,
+  MaybePromise as r,
+  BaseTransportType as t
+};
+//# sourceMappingURL=types-D2naO3rA.d.ts.map