agents 0.11.5 → 0.11.7

package/dist/index.js

@@ -2,10 +2,10 @@ import { MessageType } from "./types.js";
 import { camelCaseToKebabCase } from "./utils.js";
 import { createHeaderBasedEmailResolver, signAgentHeaders } from "./email.js";
 import { __DO_NOT_USE_WILL_BREAK__agentContext } from "./internal_context.js";
-import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, t as _classPrivateFieldGet2 } from "./classPrivateFieldGet2-DAZNVUKb.js";
+import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, t as _classPrivateFieldGet2 } from "./classPrivateFieldGet2-Bqby-AHD.js";
 import { SUB_PREFIX, getSubAgentByName, parseSubAgentPath, routeSubAgentRequest } from "./sub-routing.js";
 import { isErrorRetryable, tryN, validateRetryOptions } from "./retries.js";
-import { o as RPC_DO_PREFIX, r as MCPConnectionState, s as DisposableStore, t as MCPClientManager } from "./client-BYF13FDD.js";
+import { o as RPC_DO_PREFIX, r as MCPConnectionState, s as DisposableStore, t as MCPClientManager } from "./client-D1kFXo80.js";
 import { DurableObjectOAuthClientProvider } from "./mcp/do-oauth-client-provider.js";
 import { genericObservability } from "./observability/index.js";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -157,10 +157,22 @@ const _sendIdentityWarnedClasses = /* @__PURE__ */ new WeakSet();
 * Child classes can override specific options without spreading.
 */
 const DEFAULT_AGENT_STATIC_OPTIONS = {
+	/** Whether the Agent should hibernate when inactive */
 	hibernate: true,
+	/** Whether to send identity (name, agent) to clients on connect */
 	sendIdentityOnConnect: true,
+	/**
+	* Timeout in seconds before a running interval schedule is considered "hung"
+	* and force-reset. Increase this if you have callbacks that legitimately
+	* take longer than 30 seconds.
+	*/
 	hungScheduleTimeoutSeconds: 30,
+	/**
+	* Interval in milliseconds for keepAlive() alarm heartbeats.
+	* Lower values mean faster recovery after eviction but more frequent alarms.
+	*/
 	keepAliveIntervalMs: DEFAULT_KEEP_ALIVE_INTERVAL_MS,
+	/** Default retry options for schedule(), queue(), and this.retry() */
 	retry: {
 		maxAttempts: 3,
 		baseDelayMs: 100,
@@ -1894,7 +1906,10 @@ var Agent = class Agent extends Server {
 	* Executes any scheduled tasks that are due.
 	*
 	* Calls super.alarm() first to ensure PartyServer's #ensureInitialized()
-	* runs, which hydrates this.name from storage and calls onStart() if needed.
+	* runs, which resolves this.name from ctx.id.name (including for
+	* facets, which are spawned with an explicit id so they have their
+	* own ctx.id.name; pre-2026-03-15 alarms fall back to the legacy
+	* __ps_name storage record) and calls onStart() if needed.
 	*
 	* @remarks
 	* To schedule a task, please use the `this.schedule` method instead.
@@ -2118,23 +2133,29 @@ var Agent = class Agent extends Server {
 	* parent and triggered "Cannot perform I/O on behalf of a different
 	* Durable Object" on the child.
 	*
-	* We still set `_isFacet` eagerly (before `__unsafe_ensureInitialized`)
-	* so any code that legitimately branches on it — e.g. skipping
-	* parent-owned alarms in schedule guards — sees the flag during
-	* the first `onStart()` run. Broadcast paths no longer special-case
-	* facets, since facets can be directly addressed via sub-agent
-	* routing and have their own WebSocket connections.
+	* We set `_isFacet` eagerly (before `__unsafe_ensureInitialized`
+	* runs `onStart()`) so any code that legitimately branches on it
+	* — e.g. skipping parent-owned alarms in schedule guards — sees
+	* the flag during the first `onStart()` run. Broadcast paths no
+	* longer special-case facets, since facets can be directly
+	* addressed via sub-agent routing and have their own WebSocket
+	* connections.
+	*
+	* The facet's name (and `this.name` getter) is handled entirely by
+	* partyserver via `ctx.id.name`, which is populated because the
+	* parent passed an explicit `id: parentNs.idFromName(name)` to
+	* `ctx.facets.get()` — see {@link _cf_resolveSubAgent}. No
+	* `setName()` call or `__ps_name` storage write is needed; the
+	* facet's name survives cold wake automatically because the
+	* factory re-runs and `idFromName` is deterministic.
 	*
 	* @internal Called by {@link subAgent}.
 	*/
 	async _cf_initAsFacet(name, parentPath = []) {
+		if (this.name !== name) throw new Error(`Facet bootstrap mismatch: expected this.name === "${name}" but got "${this.name}". This usually means the parent passed the wrong (or no) id to ctx.facets.get(). See _cf_resolveSubAgent.`);
 		this._isFacet = true;
 		this._parentPath = parentPath;
-		await Promise.all([
-			this.ctx.storage.put("cf_agents_is_facet", true),
-			this.ctx.storage.put("__ps_name", name),
-			this.ctx.storage.put("cf_agents_parent_path", parentPath)
-		]);
+		await Promise.all([this.ctx.storage.put("cf_agents_is_facet", true), this.ctx.storage.put("cf_agents_parent_path", parentPath)]);
 		await this.__unsafe_ensureInitialized();
 	}
 	/**
@@ -2256,7 +2277,17 @@ var Agent = class Agent extends Server {
 		if (!Cls) throw new Error(`Sub-agent class "${className}" 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.`);
 		if (name.includes("\0")) throw new Error(`Sub-agent name contains null character (\\0), which is reserved.`);
 		const facetKey = `${className}\0${name}`;
-		const stub = ctx.facets.get(facetKey, () => ({ class: Cls }));
+		const parentClassName = this.constructor.name;
+		const parentNs = ctx.exports[parentClassName];
+		if (!parentNs?.idFromName) {
+			const minificationHint = /^_*[a-z][a-z0-9]{0,2}$/.test(parentClassName) ? ` The class name "${parentClassName}" looks minified — make sure your bundler preserves class names (e.g. esbuild's \`keepNames: true\`).` : "";
+			throw new Error(`Sub-agent bootstrap requires the parent class "${parentClassName}" to be bound as a Durable Object namespace, but ctx.exports["${parentClassName}"] is missing or doesn't expose idFromName.${minificationHint} Make sure the parent agent class is registered in your wrangler.jsonc durable_objects.bindings under its class name.`);
+		}
+		const facetId = parentNs.idFromName(name);
+		const stub = ctx.facets.get(facetKey, () => ({
+			class: Cls,
+			id: facetId
+		}));
 		const childParentPath = this.selfPath;
 		await stub._cf_initAsFacet(name, childParentPath);
 		this._recordSubAgent(className, name);