agents 0.21.0 → 0.23.0

package/dist/routing/index.js

@@ -0,0 +1,244 @@
+import { getAgentByName, routeAgentRequest } from "../agent-routing.js";
+import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../classPrivateFieldGet2-DZBYAB34.js";
+import { t as LifecycleCapability } from "../capability-BjSKYpzg.js";
+import { t as _classPrivateMethodInitSpec } from "../classPrivateMethodInitSpec-qMjJ6sHQ.js";
+//#region src/routing/routed-agents.ts
+/**
+* Catalog of the entries an owning Durable Object has created, keyed by
+* route so several namespaces can share one owner. `WITHOUT ROWID` keeps
+* an insert at one billed row; `agent_name` is a random UUID, so it needs
+* no unique index of its own.
+*/
+const TABLE = "cf_agents_routed_agents";
+/**
+* Derives the next per-route sequence number from a `MAX(seq)` read
+* instead of a maintained counter row. Breaks ties between equal
+* `Date.now()` values deterministically by write order, which a random
+* entry `id` cannot: DO SQLite millisecond timestamps collide easily
+* under rapid same-route writes.
+*
+* This scans every row for the route on each create()/setMetadata() —
+* intentionally, not a missed index. DO SQLite bills roughly 1000
+* writes for the cost of 1000 reads, so a maintained counter row (an
+* extra write on every call) only wins at deep four-figure entries per
+* route; a `(route, seq)` index would cost an extra write on every call
+* too, since `seq` changes on every write it would index. `RoutedAgents`
+* targets one owner's own catalog (chats, documents, sessions) — for a
+* route expected to hold thousands of entries, benchmark before relying
+* on this ordering; it is not built for that scale.
+*/
+const NEXT_SEQ = `(SELECT COALESCE(MAX(seq), 0) + 1 FROM ${TABLE} WHERE route = ?)`;
+function encodeMetadata(value) {
+	const encoded = JSON.stringify(value ?? null);
+	if (encoded === void 0) throw new TypeError("RoutedAgents metadata must be JSON-serializable");
+	return encoded;
+}
+var _namespace = /* @__PURE__ */ new WeakMap();
+var _route = /* @__PURE__ */ new WeakMap();
+var _RoutedAgents_brand = /* @__PURE__ */ new WeakSet();
+/**
+* A durable, routed collection of independent top-level Agents.
+*
+* Install this on the owning Durable Object, typically a per-user hub. It
+* maps public entry IDs to opaque physical Agent names, handles catalog
+* CRUD without waking any target, and forwards matching HTTP requests and
+* WebSocket upgrades to the selected Agent. After an upgrade the target
+* owns the socket, so ordinary frames never wake the owner. The target
+* Agent needs no matching capability. Destroying the owner condemns every
+* remaining entry with a few retries so targets don't casually outlive
+* their catalog — this is best-effort, not a durability guarantee; see
+* {@link RoutedAgents.dispose}.
+*
+* Pick a `route` that cannot appear as a literal path segment elsewhere
+* under the owner (its own name, another route, or a path the owner's own
+* `onRequest` handles) — forwarding matches every occurrence of the route
+* segment in the path, so a coincidental match with no active entry
+* behind it is answered `404` instead of reaching the owner.
+*
+* A forwarded suffix is not searched for a `/sub/{class}/{name}` dynamic
+* agents marker: `Agent.fetch()` resolves that marker against the OWNER's
+* exported classes before this capability's `onRequest` ever runs, so a
+* matching marker is served as a facet of the owner, not forwarded to the
+* target. Address a target's own dynamic agents through a direct
+* connection to that target, not through the owner's route.
+*
+* @experimental The API surface may change before stabilizing.
+*/
+var RoutedAgents = class extends LifecycleCapability {
+	/**
+	* @param options - Target binding and the route segment this capability
+	* claims. Install with `this.lifecycle.use()` before startup.
+	*/
+	constructor(options) {
+		const route = options.route.replace(/^\/+|\/+$/g, "");
+		if (!/^[A-Za-z0-9_-]+$/.test(route)) throw new Error("RoutedAgents route must be one non-empty URL-safe path segment");
+		super(`routed-agents:${route}`);
+		_classPrivateMethodInitSpec(this, _RoutedAgents_brand);
+		_classPrivateFieldInitSpec(this, _namespace, void 0);
+		_classPrivateFieldInitSpec(this, _route, void 0);
+		_classPrivateFieldSet2(_namespace, this, options.namespace);
+		_classPrivateFieldSet2(_route, this, route);
+	}
+	/** Create an entry without waking the target Agent. */
+	async create(options) {
+		await this.lifecycle.ready();
+		const id = crypto.randomUUID();
+		const encoded = encodeMetadata(options?.metadata ?? null);
+		const now = Date.now();
+		_assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `INSERT INTO ${TABLE} (route, id, agent_name, status, metadata, created_at, updated_at, seq)
+       VALUES (?, ?, ?, 'active', ?, ?, ?, ${NEXT_SEQ})`, _classPrivateFieldGet2(_route, this), id, crypto.randomUUID(), encoded, now, now, _classPrivateFieldGet2(_route, this));
+		return {
+			id,
+			metadata: JSON.parse(encoded),
+			createdAt: now,
+			updatedAt: now
+		};
+	}
+	/** Resolve an active entry to an initialized, typed Agent stub. */
+	async get(id) {
+		await this.lifecycle.ready();
+		const agentName = _assertClassBrand(_RoutedAgents_brand, this, _agentName).call(this, id, "active");
+		return agentName ? _assertClassBrand(_RoutedAgents_brand, this, _stub).call(this, agentName) : null;
+	}
+	/**
+	* List active entries, most recently updated first. Entries whose
+	* `updatedAt` ties are ordered by actual write order, not by the
+	* random entry `id`.
+	*/
+	async list() {
+		await this.lifecycle.ready();
+		return _assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `SELECT id, metadata, created_at AS createdAt, updated_at AS updatedAt
+       FROM ${TABLE} WHERE route = ? AND status = 'active'
+       ORDER BY updated_at DESC, seq DESC, id ASC`, _classPrivateFieldGet2(_route, this)).map((row) => ({
+			...row,
+			metadata: JSON.parse(row.metadata)
+		}));
+	}
+	/** Replace an active entry's metadata. Returns false for unknown IDs. */
+	async setMetadata(id, metadata) {
+		await this.lifecycle.ready();
+		return _assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `UPDATE ${TABLE} SET metadata = ?, updated_at = ?, seq = ${NEXT_SEQ}
+         WHERE route = ? AND id = ? AND status = 'active' RETURNING id`, encodeMetadata(metadata), Date.now(), _classPrivateFieldGet2(_route, this), _classPrivateFieldGet2(_route, this), id).length > 0;
+	}
+	/**
+	* Make an entry unreachable, condemn its Agent, then remove the row.
+	* Returns false for unknown IDs.
+	*
+	* The target is condemned through Agent's deferred teardown, which
+	* durably marks it and returns without aborting the isolate; its storage
+	* is wiped on its own next wake, moments later, and the marker survives
+	* interruption. A failed RPC leaves a hidden `deleting` row so a
+	* repeated call retries.
+	*/
+	async delete(id) {
+		await this.lifecycle.ready();
+		const agentName = _assertClassBrand(_RoutedAgents_brand, this, _agentName).call(this, id);
+		if (!agentName) return false;
+		_assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `UPDATE ${TABLE} SET status = 'deleting', updated_at = ?
+       WHERE route = ? AND id = ?`, Date.now(), _classPrivateFieldGet2(_route, this), id);
+		await _classPrivateFieldGet2(_namespace, this).get(_classPrivateFieldGet2(_namespace, this).idFromName(agentName))._cf_scheduleDestroy();
+		_assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `DELETE FROM ${TABLE} WHERE route = ? AND id = ?`, _classPrivateFieldGet2(_route, this), id);
+		return true;
+	}
+	onStart() {
+		_assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `CREATE TABLE IF NOT EXISTS ${TABLE} (
+      route TEXT NOT NULL,
+      id TEXT NOT NULL,
+      agent_name TEXT NOT NULL,
+      status TEXT NOT NULL CHECK (status IN ('active', 'deleting')),
+      metadata TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      seq INTEGER NOT NULL DEFAULT 0,
+      PRIMARY KEY (route, id)
+    ) WITHOUT ROWID`);
+	}
+	/**
+	* Condemn every remaining entry (including one already `deleting`, in
+	* case its own condemnation RPC never landed) when the owner itself is
+	* destroyed.
+	*
+	* `Agent.destroy()` disposes capabilities before it wipes its own
+	* storage, so the catalog is still readable here — without this, the
+	* catalog would vanish with the owner while every target it named kept
+	* running and billing storage, unreachable forever.
+	*
+	* This is best-effort, not a durability guarantee: `Agent.destroy()`
+	* wipes the owner's storage immediately after disposal regardless of
+	* whether any capability's `dispose()` reports failure, so a target
+	* that is still unreachable after retries here is orphaned for good —
+	* there is no later "repeated call retries" for a catalog row that no
+	* longer exists. Retrying briefly here converts the common transient
+	* failure into a condemned target instead of an orphan; it cannot
+	* convert a target that is durably unreachable.
+	*/
+	async dispose() {
+		const entries = _assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `SELECT agent_name AS agentName FROM ${TABLE}
+       WHERE route = ? AND status IN ('active', 'deleting')`, _classPrivateFieldGet2(_route, this));
+		await Promise.all(entries.map(({ agentName }) => _assertClassBrand(_RoutedAgents_brand, this, _condemnWithRetry).call(this, agentName)));
+	}
+	/** Forward a matching HTTP request to the selected Agent. */
+	onRequest({ request }) {
+		return _assertClassBrand(_RoutedAgents_brand, this, _forward).call(this, request);
+	}
+	/** Forward a matching upgrade so the selected Agent owns the WebSocket. */
+	onWebSocketUpgrade({ request }) {
+		return _assertClassBrand(_RoutedAgents_brand, this, _forward).call(this, request);
+	}
+};
+async function _condemnWithRetry(agentName, attempts = 3) {
+	for (let attempt = 1; attempt <= attempts; attempt++) try {
+		await _classPrivateFieldGet2(_namespace, this).get(_classPrivateFieldGet2(_namespace, this).idFromName(agentName))._cf_scheduleDestroy();
+		return;
+	} catch (error) {
+		if (attempt === attempts) {
+			console.error(`RoutedAgents "${_classPrivateFieldGet2(_route, this)}" could not condemn ${agentName} on owner disposal after ${attempts} attempts; its storage will leak, since the owner's catalog — the only record of it — is wiped immediately after disposal`, error);
+			return;
+		}
+		await new Promise((resolve) => setTimeout(resolve, attempt * 50));
+	}
+}
+/**
+* The route segment may also appear as the owner's own name or inside
+* the forwarded suffix, so every `/{route}/{id}` occurrence is tried
+* against the catalog and the first active entry wins. A route match
+* with no active entry is a 404; no match at all lets the request
+* continue to the owner's other capabilities.
+*/
+async function _forward(request) {
+	const url = new URL(request.url);
+	const segments = url.pathname.split("/");
+	let matched = false;
+	for (let i = 1; i < segments.length - 1; i++) {
+		if (segments[i] !== _classPrivateFieldGet2(_route, this) || segments[i + 1] === "") continue;
+		matched = true;
+		const agentName = _assertClassBrand(_RoutedAgents_brand, this, _agentName).call(this, decode(segments[i + 1]), "active");
+		if (!agentName) continue;
+		url.pathname = `/${segments.slice(i + 2).join("/")}`;
+		return _classPrivateFieldGet2(_namespace, this).get(_classPrivateFieldGet2(_namespace, this).idFromName(agentName)).fetch(new Request(url, request));
+	}
+	return matched ? new Response("Agent not found", { status: 404 }) : void 0;
+}
+/** Initialized stub; the explicit generics keep inference shallow. */
+function _stub(agentName) {
+	return getAgentByName(_classPrivateFieldGet2(_namespace, this), agentName);
+}
+function _agentName(id, status) {
+	const [row] = _assertClassBrand(_RoutedAgents_brand, this, _sql).call(this, `SELECT agent_name AS agentName FROM ${TABLE}
+       WHERE route = ? AND id = ? AND status = COALESCE(?, status)`, _classPrivateFieldGet2(_route, this), id, status ?? null);
+	return row?.agentName;
+}
+function _sql(query, ...values) {
+	return this.lifecycle.storage.sql.exec(query, ...values).toArray();
+}
+function decode(segment) {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return segment;
+	}
+}
+//#endregion
+export { RoutedAgents, getAgentByName, routeAgentRequest };
+
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/routing/routed-agents.ts"],"sourcesContent":["import { getAgentByName } from \"../agent-routing\";\nimport type { Agent } from \"../index\";\nimport { LifecycleCapability } from \"../lifecycle/capability\";\nimport type {\n  CapabilityRequestContext,\n  CapabilityWebSocketUpgradeContext\n} from \"../lifecycle/capability-runner\";\n\n/**\n * Catalog of the entries an owning Durable Object has created, keyed by\n * route so several namespaces can share one owner. `WITHOUT ROWID` keeps\n * an insert at one billed row; `agent_name` is a random UUID, so it needs\n * no unique index of its own.\n */\nconst TABLE = \"cf_agents_routed_agents\";\n\n/**\n * Derives the next per-route sequence number from a `MAX(seq)` read\n * instead of a maintained counter row. Breaks ties between equal\n * `Date.now()` values deterministically by write order, which a random\n * entry `id` cannot: DO SQLite millisecond timestamps collide easily\n * under rapid same-route writes.\n *\n * This scans every row for the route on each create()/setMetadata() —\n * intentionally, not a missed index. DO SQLite bills roughly 1000\n * writes for the cost of 1000 reads, so a maintained counter row (an\n * extra write on every call) only wins at deep four-figure entries per\n * route; a `(route, seq)` index would cost an extra write on every call\n * too, since `seq` changes on every write it would index. `RoutedAgents`\n * targets one owner's own catalog (chats, documents, sessions) — for a\n * route expected to hold thousands of entries, benchmark before relying\n * on this ordering; it is not built for that scale.\n */\nconst NEXT_SEQ = `(SELECT COALESCE(MAX(seq), 0) + 1 FROM ${TABLE} WHERE route = ?)`;\n\n/** A public entry in an {@link RoutedAgents}. */\nexport type RoutedAgentEntry<Metadata = unknown> = {\n  /** Stable application-facing identifier used in routes. */\n  readonly id: string;\n  /** Application-owned metadata stored with the entry. */\n  readonly metadata: Metadata | null;\n  /** Creation time, as Unix milliseconds. */\n  readonly createdAt: number;\n  /** Time the entry or its metadata last changed, as Unix milliseconds. */\n  readonly updatedAt: number;\n};\n\n/** Options for creating an entry in an {@link RoutedAgents}. */\nexport type RoutedAgentCreateOptions<Metadata = unknown> = {\n  /** Initial application-owned metadata. */\n  readonly metadata?: Metadata;\n};\n\n/** Configuration for an {@link RoutedAgents}. */\nexport type RoutedAgentsOptions<TAgent extends Agent> = {\n  /** Top-level Durable Object namespace the entries are created in. */\n  readonly namespace: DurableObjectNamespace<TAgent>;\n  /** One URL-safe path segment under the owning Durable Object. */\n  readonly route: string;\n};\n\ntype EntryRow = {\n  id: string;\n  metadata: string;\n  createdAt: number;\n  updatedAt: number;\n};\n\nfunction encodeMetadata(value: unknown): string {\n  const encoded = JSON.stringify(value ?? null);\n  if (encoded === undefined) {\n    throw new TypeError(\"RoutedAgents metadata must be JSON-serializable\");\n  }\n  return encoded;\n}\n\n/**\n * A durable, routed collection of independent top-level Agents.\n *\n * Install this on the owning Durable Object, typically a per-user hub. It\n * maps public entry IDs to opaque physical Agent names, handles catalog\n * CRUD without waking any target, and forwards matching HTTP requests and\n * WebSocket upgrades to the selected Agent. After an upgrade the target\n * owns the socket, so ordinary frames never wake the owner. The target\n * Agent needs no matching capability. Destroying the owner condemns every\n * remaining entry with a few retries so targets don't casually outlive\n * their catalog — this is best-effort, not a durability guarantee; see\n * {@link RoutedAgents.dispose}.\n *\n * Pick a `route` that cannot appear as a literal path segment elsewhere\n * under the owner (its own name, another route, or a path the owner's own\n * `onRequest` handles) — forwarding matches every occurrence of the route\n * segment in the path, so a coincidental match with no active entry\n * behind it is answered `404` instead of reaching the owner.\n *\n * A forwarded suffix is not searched for a `/sub/{class}/{name}` dynamic\n * agents marker: `Agent.fetch()` resolves that marker against the OWNER's\n * exported classes before this capability's `onRequest` ever runs, so a\n * matching marker is served as a facet of the owner, not forwarded to the\n * target. Address a target's own dynamic agents through a direct\n * connection to that target, not through the owner's route.\n *\n * @experimental The API surface may change before stabilizing.\n */\nexport class RoutedAgents<\n  TAgent extends Agent = Agent,\n  Metadata = unknown\n> extends LifecycleCapability {\n  readonly #namespace: DurableObjectNamespace<TAgent>;\n  readonly #route: string;\n\n  /**\n   * @param options - Target binding and the route segment this capability\n   * claims. Install with `this.lifecycle.use()` before startup.\n   */\n  constructor(options: RoutedAgentsOptions<TAgent>) {\n    const route = options.route.replace(/^\\/+|\\/+$/g, \"\");\n    if (!/^[A-Za-z0-9_-]+$/.test(route)) {\n      throw new Error(\n        \"RoutedAgents route must be one non-empty URL-safe path segment\"\n      );\n    }\n    super(`routed-agents:${route}`);\n    this.#namespace = options.namespace;\n    this.#route = route;\n  }\n\n  /** Create an entry without waking the target Agent. */\n  async create(\n    options?: RoutedAgentCreateOptions<Metadata>\n  ): Promise<RoutedAgentEntry<Metadata>> {\n    await this.lifecycle.ready();\n    const id = crypto.randomUUID();\n    const encoded = encodeMetadata(options?.metadata ?? null);\n    const now = Date.now();\n    this.#sql(\n      `INSERT INTO ${TABLE} (route, id, agent_name, status, metadata, created_at, updated_at, seq)\n       VALUES (?, ?, ?, 'active', ?, ?, ?, ${NEXT_SEQ})`,\n      this.#route,\n      id,\n      crypto.randomUUID(),\n      encoded,\n      now,\n      now,\n      this.#route\n    );\n    // Round-trip through JSON so this agrees with list()'s decoded copy —\n    // returning the caller's object verbatim would diverge for values JSON\n    // can't represent exactly (undefined fields, NaN, non-plain objects).\n    return {\n      id,\n      metadata: JSON.parse(encoded) as Metadata | null,\n      createdAt: now,\n      updatedAt: now\n    };\n  }\n\n  /** Resolve an active entry to an initialized, typed Agent stub. */\n  async get(id: string): Promise<DurableObjectStub<TAgent> | null> {\n    await this.lifecycle.ready();\n    const agentName = this.#agentName(id, \"active\");\n    return agentName ? this.#stub(agentName) : null;\n  }\n\n  /**\n   * List active entries, most recently updated first. Entries whose\n   * `updatedAt` ties are ordered by actual write order, not by the\n   * random entry `id`.\n   */\n  async list(): Promise<ReadonlyArray<RoutedAgentEntry<Metadata>>> {\n    await this.lifecycle.ready();\n    return this.#sql<EntryRow>(\n      `SELECT id, metadata, created_at AS createdAt, updated_at AS updatedAt\n       FROM ${TABLE} WHERE route = ? AND status = 'active'\n       ORDER BY updated_at DESC, seq DESC, id ASC`,\n      this.#route\n    ).map((row) => ({\n      ...row,\n      // SAFETY: written by create() or setMetadata() from a Metadata value.\n      // Changing Metadata for an existing namespace needs an application\n      // migration; JSON carries no type to recover.\n      metadata: JSON.parse(row.metadata) as Metadata | null\n    }));\n  }\n\n  /** Replace an active entry's metadata. Returns false for unknown IDs. */\n  async setMetadata(id: string, metadata: Metadata | null): Promise<boolean> {\n    await this.lifecycle.ready();\n    return (\n      this.#sql(\n        `UPDATE ${TABLE} SET metadata = ?, updated_at = ?, seq = ${NEXT_SEQ}\n         WHERE route = ? AND id = ? AND status = 'active' RETURNING id`,\n        encodeMetadata(metadata),\n        Date.now(),\n        this.#route,\n        this.#route,\n        id\n      ).length > 0\n    );\n  }\n\n  /**\n   * Make an entry unreachable, condemn its Agent, then remove the row.\n   * Returns false for unknown IDs.\n   *\n   * The target is condemned through Agent's deferred teardown, which\n   * durably marks it and returns without aborting the isolate; its storage\n   * is wiped on its own next wake, moments later, and the marker survives\n   * interruption. A failed RPC leaves a hidden `deleting` row so a\n   * repeated call retries.\n   */\n  async delete(id: string): Promise<boolean> {\n    await this.lifecycle.ready();\n    const agentName = this.#agentName(id);\n    if (!agentName) return false;\n    this.#sql(\n      `UPDATE ${TABLE} SET status = 'deleting', updated_at = ?\n       WHERE route = ? AND id = ?`,\n      Date.now(),\n      this.#route,\n      id\n    );\n    await this.#namespace\n      .get(this.#namespace.idFromName(agentName))\n      ._cf_scheduleDestroy();\n    this.#sql(\n      `DELETE FROM ${TABLE} WHERE route = ? AND id = ?`,\n      this.#route,\n      id\n    );\n    return true;\n  }\n\n  override onStart(): void {\n    this.#sql(`CREATE TABLE IF NOT EXISTS ${TABLE} (\n      route TEXT NOT NULL,\n      id TEXT NOT NULL,\n      agent_name TEXT NOT NULL,\n      status TEXT NOT NULL CHECK (status IN ('active', 'deleting')),\n      metadata TEXT NOT NULL,\n      created_at INTEGER NOT NULL,\n      updated_at INTEGER NOT NULL,\n      seq INTEGER NOT NULL DEFAULT 0,\n      PRIMARY KEY (route, id)\n    ) WITHOUT ROWID`);\n  }\n\n  /**\n   * Condemn every remaining entry (including one already `deleting`, in\n   * case its own condemnation RPC never landed) when the owner itself is\n   * destroyed.\n   *\n   * `Agent.destroy()` disposes capabilities before it wipes its own\n   * storage, so the catalog is still readable here — without this, the\n   * catalog would vanish with the owner while every target it named kept\n   * running and billing storage, unreachable forever.\n   *\n   * This is best-effort, not a durability guarantee: `Agent.destroy()`\n   * wipes the owner's storage immediately after disposal regardless of\n   * whether any capability's `dispose()` reports failure, so a target\n   * that is still unreachable after retries here is orphaned for good —\n   * there is no later \"repeated call retries\" for a catalog row that no\n   * longer exists. Retrying briefly here converts the common transient\n   * failure into a condemned target instead of an orphan; it cannot\n   * convert a target that is durably unreachable.\n   */\n  async dispose(): Promise<void> {\n    const entries = this.#sql<{ agentName: string }>(\n      `SELECT agent_name AS agentName FROM ${TABLE}\n       WHERE route = ? AND status IN ('active', 'deleting')`,\n      this.#route\n    );\n    await Promise.all(\n      entries.map(({ agentName }) => this.#condemnWithRetry(agentName))\n    );\n  }\n\n  async #condemnWithRetry(agentName: string, attempts = 3): Promise<void> {\n    for (let attempt = 1; attempt <= attempts; attempt++) {\n      try {\n        await this.#namespace\n          .get(this.#namespace.idFromName(agentName))\n          ._cf_scheduleDestroy();\n        return;\n      } catch (error) {\n        if (attempt === attempts) {\n          console.error(\n            `RoutedAgents \"${this.#route}\" could not condemn ${agentName} on owner disposal after ${attempts} attempts; its storage will leak, since the owner's catalog — the only record of it — is wiped immediately after disposal`,\n            error\n          );\n          return;\n        }\n        await new Promise((resolve) => setTimeout(resolve, attempt * 50));\n      }\n    }\n  }\n\n  /** Forward a matching HTTP request to the selected Agent. */\n  onRequest({\n    request\n  }: CapabilityRequestContext): Promise<Response | undefined> {\n    return this.#forward(request);\n  }\n\n  /** Forward a matching upgrade so the selected Agent owns the WebSocket. */\n  onWebSocketUpgrade({\n    request\n  }: CapabilityWebSocketUpgradeContext): Promise<Response | undefined> {\n    return this.#forward(request);\n  }\n\n  /**\n   * The route segment may also appear as the owner's own name or inside\n   * the forwarded suffix, so every `/{route}/{id}` occurrence is tried\n   * against the catalog and the first active entry wins. A route match\n   * with no active entry is a 404; no match at all lets the request\n   * continue to the owner's other capabilities.\n   */\n  async #forward(request: Request): Promise<Response | undefined> {\n    const url = new URL(request.url);\n    const segments = url.pathname.split(\"/\");\n    let matched = false;\n    for (let i = 1; i < segments.length - 1; i++) {\n      if (segments[i] !== this.#route || segments[i + 1] === \"\") continue;\n      matched = true;\n      const agentName = this.#agentName(decode(segments[i + 1]), \"active\");\n      if (!agentName) continue;\n      url.pathname = `/${segments.slice(i + 2).join(\"/\")}`;\n      return this.#namespace\n        .get(this.#namespace.idFromName(agentName))\n        .fetch(new Request(url, request));\n    }\n    return matched\n      ? new Response(\"Agent not found\", { status: 404 })\n      : undefined;\n  }\n\n  /** Initialized stub; the explicit generics keep inference shallow. */\n  #stub(agentName: string): Promise<DurableObjectStub<TAgent>> {\n    return getAgentByName<Cloudflare.Env, TAgent>(this.#namespace, agentName);\n  }\n\n  #agentName(id: string, status?: \"active\"): string | undefined {\n    const [row] = this.#sql<{ agentName: string }>(\n      `SELECT agent_name AS agentName FROM ${TABLE}\n       WHERE route = ? AND id = ? AND status = COALESCE(?, status)`,\n      this.#route,\n      id,\n      status ?? null\n    );\n    return row?.agentName;\n  }\n\n  #sql<Row extends Record<string, SqlStorageValue>>(\n    query: string,\n    ...values: SqlStorageValue[]\n  ): Row[] {\n    return this.lifecycle.storage.sql.exec<Row>(query, ...values).toArray();\n  }\n}\n\nfunction decode(segment: string): string {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n}\n"],"mappings":"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"}

package/dist/sanitize-D9TujEK8.js

@@ -0,0 +1,79 @@
+//#region src/sessions/sanitize.ts
+/**
+* Message hygiene shared by every Sessions write: UTF-8 measurement without a
+* full encoded copy, and removal of ephemeral provider metadata that must not
+* be stored or replayed.
+*/
+const textEncoder = new TextEncoder();
+const BYTE_LENGTH_BUFFER_BYTES = 16 * 1024;
+const BYTE_LENGTH_WINDOW_CHARS = 16 * 1024;
+/**
+* Measure UTF-8 byte length without allocating a complete encoded copy.
+* Memory stays bounded by a 16 KiB buffer even for near-row-limit strings.
+*/
+function byteLength(s) {
+	const buffer = new Uint8Array(BYTE_LENGTH_BUFFER_BYTES);
+	let offset = 0;
+	let bytes = 0;
+	while (offset < s.length) {
+		let end = Math.min(s.length, offset + BYTE_LENGTH_WINDOW_CHARS);
+		if (end < s.length && end > offset && isHighSurrogate(s.charCodeAt(end - 1))) end--;
+		const { read, written } = textEncoder.encodeInto(s.slice(offset, end), buffer);
+		if (read === 0) break;
+		offset += read;
+		bytes += written;
+	}
+	return bytes;
+}
+function isHighSurrogate(code) {
+	return code >= 55296 && code <= 56319;
+}
+/**
+* Sanitize a message for persistence by removing ephemeral provider-specific
+* data that should not be stored or sent back in subsequent requests.
+*
+* 1. Strips OpenAI ephemeral fields (itemId, reasoningEncryptedContent)
+* 2. Filters truly empty reasoning parts (no text, no remaining providerMetadata)
+*/
+function sanitizeMessage(message) {
+	const parts = message.parts.flatMap((part) => {
+		let sanitized = part;
+		for (const key of ["providerMetadata", "callProviderMetadata"]) {
+			const metadata = sanitized[key];
+			if (metadata && typeof metadata === "object" && "openai" in metadata) sanitized = stripOpenAIMetadata(sanitized, key);
+		}
+		if (sanitized.type === "reasoning") {
+			const text = sanitized.text;
+			if (typeof text !== "string" || text.trim() === "") {
+				const metadata = sanitized.providerMetadata;
+				if (!(metadata && typeof metadata === "object" && Object.keys(metadata).length > 0)) return [];
+			}
+		}
+		return [sanitized];
+	});
+	return {
+		...message,
+		parts
+	};
+}
+function stripOpenAIMetadata(part, metadataKey) {
+	const metadata = part[metadataKey];
+	if (!metadata?.openai) return part;
+	const { itemId: _itemId, reasoningEncryptedContent: _rec, ...restOpenai } = metadata.openai;
+	const { openai: _openai, ...restMetadata } = metadata;
+	let next;
+	if (Object.keys(restOpenai).length > 0) next = {
+		...restMetadata,
+		openai: restOpenai
+	};
+	else if (Object.keys(restMetadata).length > 0) next = restMetadata;
+	const { [metadataKey]: _old, ...rest } = part;
+	return next ? {
+		...rest,
+		[metadataKey]: next
+	} : rest;
+}
+//#endregion
+export { sanitizeMessage as n, byteLength as t };
+
+//# sourceMappingURL=sanitize-D9TujEK8.js.map

package/dist/sanitize-D9TujEK8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-D9TujEK8.js","names":[],"sources":["../src/sessions/sanitize.ts"],"sourcesContent":["/**\n * Message hygiene shared by every Sessions write: UTF-8 measurement without a\n * full encoded copy, and removal of ephemeral provider metadata that must not\n * be stored or replayed.\n */\n\nconst textEncoder = new TextEncoder();\nconst BYTE_LENGTH_BUFFER_BYTES = 16 * 1024;\nconst BYTE_LENGTH_WINDOW_CHARS = 16 * 1024;\n\n/**\n * Measure UTF-8 byte length without allocating a complete encoded copy.\n * Memory stays bounded by a 16 KiB buffer even for near-row-limit strings.\n */\nexport function byteLength(s: string): number {\n  const buffer = new Uint8Array(BYTE_LENGTH_BUFFER_BYTES);\n  let offset = 0;\n  let bytes = 0;\n  while (offset < s.length) {\n    let end = Math.min(s.length, offset + BYTE_LENGTH_WINDOW_CHARS);\n    if (\n      end < s.length &&\n      end > offset &&\n      isHighSurrogate(s.charCodeAt(end - 1))\n    ) {\n      end--;\n    }\n    const { read, written } = textEncoder.encodeInto(\n      s.slice(offset, end),\n      buffer\n    );\n    if (read === 0) break;\n    offset += read;\n    bytes += written;\n  }\n  return bytes;\n}\n\nfunction isHighSurrogate(code: number): boolean {\n  return code >= 0xd800 && code <= 0xdbff;\n}\n\ntype PartRecord = Record<string, unknown> & { type: string };\n\n/**\n * Sanitize a message for persistence by removing ephemeral provider-specific\n * data that should not be stored or sent back in subsequent requests.\n *\n * 1. Strips OpenAI ephemeral fields (itemId, reasoningEncryptedContent)\n * 2. Filters truly empty reasoning parts (no text, no remaining providerMetadata)\n */\nexport function sanitizeMessage<M extends { parts: readonly object[] }>(\n  message: M\n): M {\n  const parts = (message.parts as readonly PartRecord[]).flatMap((part) => {\n    let sanitized = part;\n    for (const key of [\"providerMetadata\", \"callProviderMetadata\"] as const) {\n      const metadata = sanitized[key];\n      if (\n        metadata &&\n        typeof metadata === \"object\" &&\n        \"openai\" in (metadata as Record<string, unknown>)\n      ) {\n        sanitized = stripOpenAIMetadata(sanitized, key);\n      }\n    }\n    if (sanitized.type === \"reasoning\") {\n      const text = sanitized.text;\n      if (typeof text !== \"string\" || text.trim() === \"\") {\n        const metadata = sanitized.providerMetadata;\n        const keep =\n          metadata &&\n          typeof metadata === \"object\" &&\n          Object.keys(metadata as object).length > 0;\n        if (!keep) return [];\n      }\n    }\n    return [sanitized];\n  });\n  return { ...message, parts };\n}\n\nfunction stripOpenAIMetadata(\n  part: PartRecord,\n  metadataKey: \"providerMetadata\" | \"callProviderMetadata\"\n): PartRecord {\n  const metadata = part[metadataKey] as {\n    openai?: Record<string, unknown>;\n    [key: string]: unknown;\n  };\n  if (!metadata?.openai) return part;\n\n  const {\n    itemId: _itemId,\n    reasoningEncryptedContent: _rec,\n    ...restOpenai\n  } = metadata.openai;\n  const { openai: _openai, ...restMetadata } = metadata;\n\n  let next: Record<string, unknown> | undefined;\n  if (Object.keys(restOpenai).length > 0) {\n    next = { ...restMetadata, openai: restOpenai };\n  } else if (Object.keys(restMetadata).length > 0) {\n    next = restMetadata;\n  }\n\n  const { [metadataKey]: _old, ...rest } = part;\n  return next\n    ? ({ ...rest, [metadataKey]: next } as PartRecord)\n    : (rest as PartRecord);\n}\n"],"mappings":";;;;;;AAMA,MAAM,cAAc,IAAI,YAAY;AACpC,MAAM,2BAA2B,KAAK;AACtC,MAAM,2BAA2B,KAAK;;;;;AAMtC,SAAgB,WAAW,GAAmB;CAC5C,MAAM,SAAS,IAAI,WAAW,wBAAwB;CACtD,IAAI,SAAS;CACb,IAAI,QAAQ;CACZ,OAAO,SAAS,EAAE,QAAQ;EACxB,IAAI,MAAM,KAAK,IAAI,EAAE,QAAQ,SAAS,wBAAwB;EAC9D,IACE,MAAM,EAAE,UACR,MAAM,UACN,gBAAgB,EAAE,WAAW,MAAM,CAAC,CAAC,GAErC;EAEF,MAAM,EAAE,MAAM,YAAY,YAAY,WACpC,EAAE,MAAM,QAAQ,GAAG,GACnB,MACF;EACA,IAAI,SAAS,GAAG;EAChB,UAAU;EACV,SAAS;CACX;CACA,OAAO;AACT;AAEA,SAAS,gBAAgB,MAAuB;CAC9C,OAAO,QAAQ,SAAU,QAAQ;AACnC;;;;;;;;AAWA,SAAgB,gBACd,SACG;CACH,MAAM,QAAS,QAAQ,MAAgC,SAAS,SAAS;EACvE,IAAI,YAAY;EAChB,KAAK,MAAM,OAAO,CAAC,oBAAoB,sBAAsB,GAAY;GACvE,MAAM,WAAW,UAAU;GAC3B,IACE,YACA,OAAO,aAAa,YACpB,YAAa,UAEb,YAAY,oBAAoB,WAAW,GAAG;EAElD;EACA,IAAI,UAAU,SAAS,aAAa;GAClC,MAAM,OAAO,UAAU;GACvB,IAAI,OAAO,SAAS,YAAY,KAAK,KAAK,MAAM,IAAI;IAClD,MAAM,WAAW,UAAU;IAK3B,IAAI,EAHF,YACA,OAAO,aAAa,YACpB,OAAO,KAAK,QAAkB,CAAC,CAAC,SAAS,IAChC,OAAO,CAAC;GACrB;EACF;EACA,OAAO,CAAC,SAAS;CACnB,CAAC;CACD,OAAO;EAAE,GAAG;EAAS;CAAM;AAC7B;AAEA,SAAS,oBACP,MACA,aACY;CACZ,MAAM,WAAW,KAAK;CAItB,IAAI,CAAC,UAAU,QAAQ,OAAO;CAE9B,MAAM,EACJ,QAAQ,SACR,2BAA2B,MAC3B,GAAG,eACD,SAAS;CACb,MAAM,EAAE,QAAQ,SAAS,GAAG,iBAAiB;CAE7C,IAAI;CACJ,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,GACnC,OAAO;EAAE,GAAG;EAAc,QAAQ;CAAW;MACxC,IAAI,OAAO,KAAK,YAAY,CAAC,CAAC,SAAS,GAC5C,OAAO;CAGT,MAAM,GAAG,cAAc,MAAM,GAAG,SAAS;CACzC,OAAO,OACF;EAAE,GAAG;GAAO,cAAc;CAAK,IAC/B;AACP"}

package/dist/schedule.d.ts

@@ -1,130 +1,61 @@
-import { z } from "zod";
+import {
+  ParsedSchedule,
+  getSchedulePrompt,
+  scheduleSchema
+} from "./schedules/parser.js";
 
 //#region src/schedule.d.ts
-/**
- * Get the schedule prompt for a given event
- * @param event - The event to get the schedule prompt for
- * @returns The schedule prompt
- */
-declare function getSchedulePrompt(event: { date: Date }): string;
 /**
  * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version
  * @param event - The event to get the schedule prompt for
  * @returns The schedule prompt
  */
 declare function unstable_getSchedulePrompt(event: { date: Date }): string;
-/**
- * The schema for parsing natural language scheduling requests.
- *
- * @example
- * ```typescript
- * import { generateObject } from "ai";
- * import { scheduleSchema, getSchedulePrompt } from "agents/schedule";
- *
- * const result = await generateObject({
- *   model,
- *   prompt: `${getSchedulePrompt({ date: new Date() })} Input: "${userInput}"`,
- *   schema: scheduleSchema,
- *   // Required for OpenAI to avoid strict JSON schema validation errors
- *   providerOptions: {
- *     openai: { strictJsonSchema: false }
- *   }
- * });
- * ```
- *
- * @remarks
- * When using this schema with OpenAI models via the AI SDK, you must pass
- * `providerOptions: { openai: { strictJsonSchema: false } }` to `generateObject`.
- * This is because the schema uses a discriminated union which is not compatible
- * with OpenAI's strict structured outputs mode.
- */
-declare const scheduleSchema: z.ZodObject<
-  {
-    description: z.ZodString;
-    when: z.ZodDiscriminatedUnion<
-      [
-        z.ZodObject<
-          {
-            type: z.ZodLiteral<"scheduled">;
-            date: z.ZodString;
-          },
-          z.core.$strip
-        >,
-        z.ZodObject<
-          {
-            type: z.ZodLiteral<"delayed">;
-            delayInSeconds: z.ZodNumber;
-          },
-          z.core.$strip
-        >,
-        z.ZodObject<
-          {
-            type: z.ZodLiteral<"cron">;
-            cron: z.ZodString;
-          },
-          z.core.$strip
-        >,
-        z.ZodObject<
-          {
-            type: z.ZodLiteral<"no-schedule">;
-          },
-          z.core.$strip
-        >
-      ],
-      "type"
-    >;
-  },
-  z.core.$strip
->;
-/**
- * The type for the schedule prompt
- */
-type Schedule = z.infer<typeof scheduleSchema>;
 /**
  * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version
  * @returns The schedule schema
  */
-declare const unstable_scheduleSchema: z.ZodObject<
+declare const unstable_scheduleSchema: import("zod").ZodObject<
   {
-    description: z.ZodString;
-    when: z.ZodDiscriminatedUnion<
+    description: import("zod").ZodString;
+    when: import("zod").ZodDiscriminatedUnion<
       [
-        z.ZodObject<
+        import("zod").ZodObject<
           {
-            type: z.ZodLiteral<"scheduled">;
-            date: z.ZodString;
+            type: import("zod").ZodLiteral<"scheduled">;
+            date: import("zod").ZodString;
           },
-          z.core.$strip
+          import("zod/v4/core").$strip
         >,
-        z.ZodObject<
+        import("zod").ZodObject<
           {
-            type: z.ZodLiteral<"delayed">;
-            delayInSeconds: z.ZodNumber;
+            type: import("zod").ZodLiteral<"delayed">;
+            delayInSeconds: import("zod").ZodNumber;
           },
-          z.core.$strip
+          import("zod/v4/core").$strip
         >,
-        z.ZodObject<
+        import("zod").ZodObject<
           {
-            type: z.ZodLiteral<"cron">;
-            cron: z.ZodString;
+            type: import("zod").ZodLiteral<"cron">;
+            cron: import("zod").ZodString;
           },
-          z.core.$strip
+          import("zod/v4/core").$strip
         >,
-        z.ZodObject<
+        import("zod").ZodObject<
           {
-            type: z.ZodLiteral<"no-schedule">;
+            type: import("zod").ZodLiteral<"no-schedule">;
           },
-          z.core.$strip
+          import("zod/v4/core").$strip
         >
       ],
       "type"
     >;
   },
-  z.core.$strip
+  import("zod/v4/core").$strip
 >;
 //#endregion
 export {
-  Schedule,
+  type ParsedSchedule as Schedule,
   getSchedulePrompt,
   scheduleSchema,
   unstable_getSchedulePrompt,

package/dist/schedule.js

@@ -1,59 +1,5 @@
-import { z } from "zod";
+import { getSchedulePrompt, scheduleSchema } from "./schedules/parser.js";
 //#region src/schedule.ts
-/**
-* Get the schedule prompt for a given event
-* @param event - The event to get the schedule prompt for
-* @returns The schedule prompt
-*/
-function getSchedulePrompt(event) {
-	return `
-[Schedule Parser Component]
-
-Current time: ${event.date.toUTCString()}
-
-This component parses natural language scheduling requests into a structured format. It extracts:
-1. A clean task description (without timing information)
-2. Scheduling details in one of these formats:
-   - scheduled: Specific date/time events
-   - delayed: Relative time delays (in seconds)
-   - cron: Recurring patterns
-   - no-schedule: Tasks without timing
-
-Rules:
-- Task descriptions should be clean and focused on the action
-- Use numbers (0-6) for days in cron patterns (0=Sunday)
-- For recurring tasks, use standard cron syntax
-- For relative times, convert to seconds
-- For specific dates, use the current time as reference
-
-Example outputs:
-{
-  "description": "meeting with team",
-  "when": {
-    "type": "scheduled",
-    "date": "tomorrow at 14:00"
-  }
-}
-
-{
-  "description": "backup database",
-  "when": {
-    "type": "cron",
-    "cron": "0 0 * * *"
-  }
-}
-
-{
-  "description": "send report",
-  "when": {
-    "type": "delayed",
-    "delayInSeconds": 1800
-  }
-}
-
-[End Schedule Parser Component]
-`;
-}
 let didWarnAboutUnstableGetSchedulePrompt = false;
 /**
 * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version
@@ -68,49 +14,6 @@ function unstable_getSchedulePrompt(event) {
 	return getSchedulePrompt(event);
 }
 /**
-* The schema for parsing natural language scheduling requests.
-*
-* @example
-* ```typescript
-* import { generateObject } from "ai";
-* import { scheduleSchema, getSchedulePrompt } from "agents/schedule";
-*
-* const result = await generateObject({
-*   model,
-*   prompt: `${getSchedulePrompt({ date: new Date() })} Input: "${userInput}"`,
-*   schema: scheduleSchema,
-*   // Required for OpenAI to avoid strict JSON schema validation errors
-*   providerOptions: {
-*     openai: { strictJsonSchema: false }
-*   }
-* });
-* ```
-*
-* @remarks
-* When using this schema with OpenAI models via the AI SDK, you must pass
-* `providerOptions: { openai: { strictJsonSchema: false } }` to `generateObject`.
-* This is because the schema uses a discriminated union which is not compatible
-* with OpenAI's strict structured outputs mode.
-*/
-const scheduleSchema = z.object({
-	description: z.string().describe("A description of the task"),
-	when: z.discriminatedUnion("type", [
-		z.object({
-			type: z.literal("scheduled"),
-			date: z.string().describe("Execute task at the specified date and time in ISO 8601 format")
-		}),
-		z.object({
-			type: z.literal("delayed"),
-			delayInSeconds: z.number().describe("Execute task after a delay in seconds")
-		}),
-		z.object({
-			type: z.literal("cron"),
-			cron: z.string().describe("Execute task on a recurring interval specified as cron syntax")
-		}),
-		z.object({ type: z.literal("no-schedule") })
-	])
-});
-/**
 * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version
 * @returns The schedule schema
 */

package/dist/schedule.js.map

@@ -1 +1 @@
-{"version":3,"file":"schedule.js","names":[],"sources":["../src/schedule.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Get the schedule prompt for a given event\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function getSchedulePrompt(event: { date: Date }) {\n  return `\n[Schedule Parser Component]\n\nCurrent time: ${event.date.toUTCString()}\n\nThis component parses natural language scheduling requests into a structured format. It extracts:\n1. A clean task description (without timing information)\n2. Scheduling details in one of these formats:\n   - scheduled: Specific date/time events\n   - delayed: Relative time delays (in seconds)\n   - cron: Recurring patterns\n   - no-schedule: Tasks without timing\n\nRules:\n- Task descriptions should be clean and focused on the action\n- Use numbers (0-6) for days in cron patterns (0=Sunday)\n- For recurring tasks, use standard cron syntax\n- For relative times, convert to seconds\n- For specific dates, use the current time as reference\n\nExample outputs:\n{\n  \"description\": \"meeting with team\",\n  \"when\": {\n    \"type\": \"scheduled\",\n    \"date\": \"tomorrow at 14:00\"\n  }\n}\n\n{\n  \"description\": \"backup database\",\n  \"when\": {\n    \"type\": \"cron\",\n    \"cron\": \"0 0 * * *\"\n  }\n}\n\n{\n  \"description\": \"send report\",\n  \"when\": {\n    \"type\": \"delayed\",\n    \"delayInSeconds\": 1800\n  }\n}\n\n[End Schedule Parser Component]\n`;\n}\n\nlet didWarnAboutUnstableGetSchedulePrompt = false;\n\n/**\n * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function unstable_getSchedulePrompt(event: { date: Date }) {\n  if (!didWarnAboutUnstableGetSchedulePrompt) {\n    didWarnAboutUnstableGetSchedulePrompt = true;\n    console.warn(\n      \"unstable_getSchedulePrompt is deprecated, use getSchedulePrompt instead. unstable_getSchedulePrompt will be removed in the next major version.\"\n    );\n  }\n  return getSchedulePrompt(event);\n}\n\n/**\n * The schema for parsing natural language scheduling requests.\n *\n * @example\n * ```typescript\n * import { generateObject } from \"ai\";\n * import { scheduleSchema, getSchedulePrompt } from \"agents/schedule\";\n *\n * const result = await generateObject({\n *   model,\n *   prompt: `${getSchedulePrompt({ date: new Date() })} Input: \"${userInput}\"`,\n *   schema: scheduleSchema,\n *   // Required for OpenAI to avoid strict JSON schema validation errors\n *   providerOptions: {\n *     openai: { strictJsonSchema: false }\n *   }\n * });\n * ```\n *\n * @remarks\n * When using this schema with OpenAI models via the AI SDK, you must pass\n * `providerOptions: { openai: { strictJsonSchema: false } }` to `generateObject`.\n * This is because the schema uses a discriminated union which is not compatible\n * with OpenAI's strict structured outputs mode.\n */\nexport const scheduleSchema = z.object({\n  description: z.string().describe(\"A description of the task\"),\n  when: z.discriminatedUnion(\"type\", [\n    z.object({\n      type: z.literal(\"scheduled\"),\n      date: z\n        .string()\n        .describe(\n          \"Execute task at the specified date and time in ISO 8601 format\"\n        )\n    }),\n    z.object({\n      type: z.literal(\"delayed\"),\n      delayInSeconds: z\n        .number()\n        .describe(\"Execute task after a delay in seconds\")\n    }),\n    z.object({\n      type: z.literal(\"cron\"),\n      cron: z\n        .string()\n        .describe(\n          \"Execute task on a recurring interval specified as cron syntax\"\n        )\n    }),\n    z.object({\n      type: z.literal(\"no-schedule\")\n    })\n  ])\n});\n\n/**\n * The type for the schedule prompt\n */\nexport type Schedule = z.infer<typeof scheduleSchema>;\n\n/**\n * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version\n * @returns The schedule schema\n */\nexport const unstable_scheduleSchema = scheduleSchema;\n"],"mappings":";;;;;;;AAOA,SAAgB,kBAAkB,OAAuB;CACvD,OAAO;;;gBAGO,MAAM,KAAK,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CzC;AAEA,IAAI,wCAAwC;;;;;;AAO5C,SAAgB,2BAA2B,OAAuB;CAChE,IAAI,CAAC,uCAAuC;EAC1C,wCAAwC;EACxC,QAAQ,KACN,gJACF;CACF;CACA,OAAO,kBAAkB,KAAK;AAChC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,iBAAiB,EAAE,OAAO;CACrC,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,2BAA2B;CAC5D,MAAM,EAAE,mBAAmB,QAAQ;EACjC,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,WAAW;GAC3B,MAAM,EACH,OAAO,CAAC,CACR,SACC,gEACF;EACJ,CAAC;EACD,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,SAAS;GACzB,gBAAgB,EACb,OAAO,CAAC,CACR,SAAS,uCAAuC;EACrD,CAAC;EACD,EAAE,OAAO;GACP,MAAM,EAAE,QAAQ,MAAM;GACtB,MAAM,EACH,OAAO,CAAC,CACR,SACC,+DACF;EACJ,CAAC;EACD,EAAE,OAAO,EACP,MAAM,EAAE,QAAQ,aAAa,EAC/B,CAAC;CACH,CAAC;AACH,CAAC;;;;;AAWD,MAAa,0BAA0B"}
+{"version":3,"file":"schedule.js","names":[],"sources":["../src/schedule.ts"],"sourcesContent":["/**\n * @deprecated Import schedule parsing helpers from `agents/schedules/parser`.\n * This compatibility entry point will be removed in a future major release.\n */\nexport { getSchedulePrompt, scheduleSchema } from \"./schedules/parser\";\n/**\n * @deprecated Import `ParsedSchedule` from `agents/schedules/parser`.\n */\nexport type { ParsedSchedule as Schedule } from \"./schedules/parser\";\n\nimport { getSchedulePrompt, scheduleSchema } from \"./schedules/parser\";\n\nlet didWarnAboutUnstableGetSchedulePrompt = false;\n\n/**\n * @deprecated this has been renamed to getSchedulePrompt, and unstable_getSchedulePrompt will be removed in the next major version\n * @param event - The event to get the schedule prompt for\n * @returns The schedule prompt\n */\nexport function unstable_getSchedulePrompt(event: { date: Date }) {\n  if (!didWarnAboutUnstableGetSchedulePrompt) {\n    didWarnAboutUnstableGetSchedulePrompt = true;\n    console.warn(\n      \"unstable_getSchedulePrompt is deprecated, use getSchedulePrompt instead. unstable_getSchedulePrompt will be removed in the next major version.\"\n    );\n  }\n  return getSchedulePrompt(event);\n}\n\n/**\n * @deprecated this has been renamed to scheduleSchema, and unstable_scheduleSchema will be removed in the next major version\n * @returns The schedule schema\n */\nexport const unstable_scheduleSchema = scheduleSchema;\n"],"mappings":";;AAYA,IAAI,wCAAwC;;;;;;AAO5C,SAAgB,2BAA2B,OAAuB;CAChE,IAAI,CAAC,uCAAuC;EAC1C,wCAAwC;EACxC,QAAQ,KACN,gJACF;CACF;CACA,OAAO,kBAAkB,KAAK;AAChC;;;;;AAMA,MAAa,0BAA0B"}