agents 0.11.2 → 0.11.3

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { r as Agent } from "./index-BBh8iKgk.js";
+import { r as Agent } from "./index-D49HdAiY.js";
 import {
   i as SerializableValue,
   n as RPCMethod,

package/dist/{index-BBh8iKgk.d.ts → index-D49HdAiY.d.ts}

@@ -1640,6 +1640,11 @@ type FiberRecoveryContext = {
   /** Fiber ID. */ id: string /** Name passed to `runFiber`. */;
   name: string /** Last checkpoint data from `stash()`, or null if never stashed. */;
   snapshot: unknown | null;
+  /**
+   * Epoch milliseconds when the fiber row was inserted (when `runFiber`
+   * started). Use `Date.now() - createdAt` to gate stale recoveries.
+   */
+  createdAt: number;
   [key: string]: unknown;
 };
 /**
@@ -1898,6 +1903,18 @@ declare class Agent<
    * @param excludeIds Additional connection IDs to exclude (e.g. the source)
    */
   private _broadcastProtocol;
+  /**
+   * When running as a facet, the parent DO owns the WebSocket registry
+   * (`ctx.getWebSockets()`). Iterating from the child isolate throws
+   * "Cannot perform I/O on behalf of a different Durable Object".
+   * Downstream callers (e.g. chat-streaming paths) invoke
+   * `this.broadcast()` directly, bypassing `_broadcastProtocol`'s
+   * guard, so override at the base to catch every path.
+   */
+  broadcast(
+    msg: string | ArrayBuffer | ArrayBufferView,
+    without?: string[]
+  ): void;
   private _setStateInternal;
   /**
    * Update the Agent's state
@@ -2369,12 +2386,23 @@ declare class Agent<
    */
   alarm(): Promise<void>;
   /**
-   * Marks this agent as running inside a facet (sub-agent). Once set,
-   * scheduling methods throw a clear error instead of crashing on
-   * `setAlarm()` (which is not supported in facets).
-   * @internal
+   * Initialize this agent as a facet in a single RPC.
+   *
+   * Runs entirely inside the child's isolate, so every storage write
+   * and `onStart()` I/O is owned by the child DO. This replaces the
+   * previous "construct a Request in the parent DO and `stub.fetch()`
+   * it on the child" handshake, whose native I/O was tied to the
+   * parent and triggered "Cannot perform I/O on behalf of a different
+   * Durable Object" on the child.
+   *
+   * Order matters: set `_isFacet` BEFORE triggering initialization, so
+   * the first `onStart()` run (which calls `broadcastMcpServers`) sees
+   * the flag and skips broadcasts that would touch the parent DO's
+   * WebSocket registry.
+   *
+   * @internal Called by {@link subAgent}.
    */
-  _cf_markAsFacet(): Promise<void>;
+  _cf_initAsFacet(name: string): Promise<void>;
   /**
    * Get or create a named sub-agent — a child Durable Object (facet)
    * with its own isolated SQLite storage running on the same machine.
@@ -2383,7 +2411,7 @@ declare class Agent<
    * entry point. The first call for a given name triggers the child's
    * `onStart()`. Subsequent calls return the existing instance.
    *
-   * @experimental Requires the `"experimental"` compatibility flag.
+   * @experimental The API surface may change before stabilizing.
    *
    * @param cls The Agent subclass (must be exported from the worker)
    * @param name Unique name for this child instance
@@ -2405,7 +2433,7 @@ declare class Agent<
    * Pending RPC calls receive the reason as an error.
    * Transitively aborts the child's own children.
    *
-   * @experimental Requires the `"experimental"` compatibility flag.
+   * @experimental The API surface may change before stabilizing.
    *
    * @param cls The Agent subclass used when creating the child
    * @param name Name of the child to abort
@@ -2416,7 +2444,7 @@ declare class Agent<
    * Delete a sub-agent: abort it if running, then permanently wipe its
    * storage. Transitively deletes the child's own children.
    *
-   * @experimental Requires the `"experimental"` compatibility flag.
+   * @experimental The API surface may change before stabilizing.
    *
    * @param cls The Agent subclass used when creating the child
    * @param name Name of the child to delete
@@ -3080,4 +3108,4 @@ export {
   QueueItem as y,
   MCPClientOAuthResult as z
 };
-//# sourceMappingURL=index-BBh8iKgk.d.ts.map
+//# sourceMappingURL=index-D49HdAiY.d.ts.map

package/dist/index.d.ts

@@ -37,7 +37,7 @@ import {
   w as SqlError,
   x as RPCResponse,
   y as QueueItem
-} from "./index-BBh8iKgk.js";
+} from "./index-D49HdAiY.js";
 import {
   n as AgentsOAuthProvider,
   r as DurableObjectOAuthClientProvider,

package/dist/index.js

@@ -718,10 +718,23 @@ var Agent = class Agent extends Server {
 	* @param excludeIds Additional connection IDs to exclude (e.g. the source)
 	*/
 	_broadcastProtocol(msg, excludeIds = []) {
+		if (this._isFacet) return;
 		const exclude = [...excludeIds];
 		for (const conn of this.getConnections()) if (!this.isConnectionProtocolEnabled(conn)) exclude.push(conn.id);
 		this.broadcast(msg, exclude);
 	}
+	/**
+	* When running as a facet, the parent DO owns the WebSocket registry
+	* (`ctx.getWebSockets()`). Iterating from the child isolate throws
+	* "Cannot perform I/O on behalf of a different Durable Object".
+	* Downstream callers (e.g. chat-streaming paths) invoke
+	* `this.broadcast()` directly, bypassing `_broadcastProtocol`'s
+	* guard, so override at the base to catch every path.
+	*/
+	broadcast(msg, without) {
+		if (this._isFacet) return;
+		super.broadcast(msg, without);
+	}
 	_setStateInternal(nextState, source = "server") {
 		this.validateStateChange(nextState, source);
 		this._state = nextState;
@@ -1801,7 +1814,7 @@ var Agent = class Agent extends Server {
 		if (this._runFiberRecoveryInProgress) return;
 		this._runFiberRecoveryInProgress = true;
 		try {
-			const rows = this.sql`SELECT id, name, snapshot FROM cf_agents_runs`;
+			const rows = this.sql`SELECT id, name, snapshot, created_at FROM cf_agents_runs`;
 			for (const row of rows) {
 				if (this._runFiberActiveFibers.has(row.id)) continue;
 				let snapshot = null;
@@ -1813,7 +1826,8 @@ var Agent = class Agent extends Server {
 				const ctx = {
 					id: row.id,
 					name: row.name,
-					snapshot
+					snapshot,
+					createdAt: row.created_at
 				};
 				try {
 					if (!await this._handleInternalFiberRecovery(ctx)) await this.onFiberRecovered(ctx);
@@ -1987,14 +2001,26 @@ var Agent = class Agent extends Server {
 		await this._scheduleNextAlarm();
 	}
 	/**
-	* Marks this agent as running inside a facet (sub-agent). Once set,
-	* scheduling methods throw a clear error instead of crashing on
-	* `setAlarm()` (which is not supported in facets).
-	* @internal
+	* Initialize this agent as a facet in a single RPC.
+	*
+	* Runs entirely inside the child's isolate, so every storage write
+	* and `onStart()` I/O is owned by the child DO. This replaces the
+	* previous "construct a Request in the parent DO and `stub.fetch()`
+	* it on the child" handshake, whose native I/O was tied to the
+	* parent and triggered "Cannot perform I/O on behalf of a different
+	* Durable Object" on the child.
+	*
+	* Order matters: set `_isFacet` BEFORE triggering initialization, so
+	* the first `onStart()` run (which calls `broadcastMcpServers`) sees
+	* the flag and skips broadcasts that would touch the parent DO's
+	* WebSocket registry.
+	*
+	* @internal Called by {@link subAgent}.
 	*/
-	async _cf_markAsFacet() {
+	async _cf_initAsFacet(name) {
 		this._isFacet = true;
-		await this.ctx.storage.put("cf_agents_is_facet", true);
+		await Promise.all([this.ctx.storage.put("cf_agents_is_facet", true), this.ctx.storage.put("__ps_name", name)]);
+		await this.__unsafe_ensureInitialized();
 	}
 	/**
 	* Get or create a named sub-agent — a child Durable Object (facet)
@@ -2004,7 +2030,7 @@ var Agent = class Agent extends Server {
 	* entry point. The first call for a given name triggers the child's
 	* `onStart()`. Subsequent calls return the existing instance.
 	*
-	* @experimental Requires the `"experimental"` compatibility flag.
+	* @experimental The API surface may change before stabilizing.
 	*
 	* @param cls The Agent subclass (must be exported from the worker)
 	* @param name Unique name for this child instance
@@ -2018,14 +2044,11 @@ var Agent = class Agent extends Server {
 	*/
 	async subAgent(cls, name) {
 		const ctx = this.ctx;
-		if (!ctx.facets || !ctx.exports) throw new Error("subAgent() requires the \"experimental\" compatibility flag. Add it to your wrangler.jsonc compatibility_flags.");
+		if (!ctx.facets || !ctx.exports) throw new Error("subAgent() is not supported in this runtime — `ctx.facets` / `ctx.exports` are unavailable. Update to the latest `compatibility_date` in your wrangler.jsonc.");
 		if (!ctx.exports[cls.name]) throw new Error(`Sub-agent class "${cls.name}" not found in worker exports. Make sure the class is exported from your worker entry point and that the export name matches the class name.`);
 		const facetKey = `${cls.name}\0${name}`;
 		const stub = ctx.facets.get(facetKey, () => ({ class: ctx.exports[cls.name] }));
-		const req = new Request("http://dummy-example.cloudflare.com/cdn-cgi/partyserver/set-name/");
-		req.headers.set("x-partykit-room", name);
-		await stub.fetch(req).then((res) => res.text());
-		await stub._cf_markAsFacet();
+		await stub._cf_initAsFacet(name);
 		return stub;
 	}
 	/**
@@ -2034,7 +2057,7 @@ var Agent = class Agent extends Server {
 	* Pending RPC calls receive the reason as an error.
 	* Transitively aborts the child's own children.
 	*
-	* @experimental Requires the `"experimental"` compatibility flag.
+	* @experimental The API surface may change before stabilizing.
 	*
 	* @param cls The Agent subclass used when creating the child
 	* @param name Name of the child to abort
@@ -2042,7 +2065,7 @@ var Agent = class Agent extends Server {
 	*/
 	abortSubAgent(cls, name, reason) {
 		const ctx = this.ctx;
-		if (!ctx.facets) throw new Error("abortSubAgent() requires the \"experimental\" compatibility flag.");
+		if (!ctx.facets) throw new Error("abortSubAgent() is not supported in this runtime — `ctx.facets` is unavailable. Update to the latest `compatibility_date` in your wrangler.jsonc.");
 		const facetKey = `${cls.name}\0${name}`;
 		ctx.facets.abort(facetKey, reason);
 	}
@@ -2050,14 +2073,14 @@ var Agent = class Agent extends Server {
 	* Delete a sub-agent: abort it if running, then permanently wipe its
 	* storage. Transitively deletes the child's own children.
 	*
-	* @experimental Requires the `"experimental"` compatibility flag.
+	* @experimental The API surface may change before stabilizing.
 	*
 	* @param cls The Agent subclass used when creating the child
 	* @param name Name of the child to delete
 	*/
 	deleteSubAgent(cls, name) {
 		const ctx = this.ctx;
-		if (!ctx.facets) throw new Error("deleteSubAgent() requires the \"experimental\" compatibility flag.");
+		if (!ctx.facets) throw new Error("deleteSubAgent() is not supported in this runtime — `ctx.facets` is unavailable. Update to the latest `compatibility_date` in your wrangler.jsonc.");
 		const facetKey = `${cls.name}\0${name}`;
 		ctx.facets.delete(facetKey);
 	}