agents 0.23.0 → 0.24.0

package/dist/{current-agent-Da_C9a3b.d.ts → durable-object-lifecycle-ei7M7lqB.d.ts}

@@ -1,14 +1,9 @@
 import {
-  _ as LifecycleJobOutcome,
-  b as Connection,
-  g as LifecycleJobContext,
+  T as WSMessage,
+  b as LifecycleJobs,
   i as DurableObjectCapability,
-  o as MemoryLimitContext,
-  u as LifecycleRouteAddress,
-  w as WSMessage,
-  y as LifecycleJobs
-} from "./capability-runner-Be_-PLR1.js";
-import { AsyncLocalStorage } from "node:async_hooks";
+  u as LifecycleRouteAddress
+} from "./capability-runner-BUBa6Ake.js";
 import { DurableObject } from "cloudflare:workers";
 
 //#region src/lifecycle/durable-object-lifecycle.d.ts
@@ -27,25 +22,6 @@ type LifecycleOptions = {
    */
   readonly maxAlarmMemoryLimitStrikes?: number;
 };
-/** Placement of a capability in the dispatch order. */
-type LifecycleUseOptions = {
-  /**
-   * Dispatch after every non-fallback capability, whenever it was
-   * installed. For a host's catch-all, such as a WebSockets capability
-   * that claims every upgrade, so middleware installed later still runs
-   * first.
-   */
-  readonly fallback?: boolean;
-};
-/**
- * Installs and coordinates the runtime lifecycle for a Durable Object.
- *
- * Construct this as an instance field on a class that directly extends
- * `DurableObject`, then call {@link Lifecycle.installHandlers}
- * from that class's constructor.
- *
- * @experimental The API surface may change before stabilizing.
- */
 declare class Lifecycle<
   Env extends object = Cloudflare.Env,
   Props extends Record<string, unknown> = Record<string, unknown>
@@ -82,17 +58,17 @@ declare class Lifecycle<
   /**
    * Add a reusable capability before this lifecycle starts.
    *
-   * Capabilities dispatch in registration order, except that fallbacks
-   * always come after non-fallbacks.
+   * Capabilities dispatch in registration order, except that a capability
+   * declaring `claims: "catch-all"` always comes last, whenever it was
+   * installed. Catch-alls are unique per dispatch hook: two may coexist
+   * when they claim disjoint traffic (one `onRequest`, one
+   * `onWebSocketUpgrade`), but a second catch-all for the same hook could
+   * never be reached and is refused.
    *
    * @param capability - The capability to add.
-   * @param options - Dispatch placement.
    * @returns This lifecycle.
    */
-  use(
-    capability: DurableObjectCapability<Props>,
-    options?: LifecycleUseOptions
-  ): this;
+  use(capability: DurableObjectCapability<Props>): this;
   /** @internal Deliver a generic capability envelope to this Lifecycle. */
   route(envelope: LifecycleRouteEnvelope): Promise<unknown>;
   /**
@@ -177,90 +153,5 @@ declare class Lifecycle<
   alarm(): Promise<void>;
 }
 //#endregion
-//#region src/lifecycle/current-agent.d.ts
-/**
- * A Durable Object that has installed the Agents SDK Lifecycle.
- *
- * Pass a more specific Lifecycle Object type to {@link getCurrentAgent} when
- * shared host code needs APIs implemented by a particular object.
- *
- * @experimental The API surface may change before stabilizing.
- */
-interface LifecycleObject<
-  Env extends object = Cloudflare.Env,
-  Props extends Record<string, unknown> = Record<string, unknown>
-> extends DurableObject<Env> {
-  readonly lifecycle: Lifecycle<Env, Props>;
-  onStart?(props?: Props): void | Promise<void>;
-  onRequest?(request: Request): Response | Promise<Response>;
-  onAlarm?(): void | Promise<void>;
-  onJob?(
-    context: LifecycleJobContext
-  ): LifecycleJobOutcome | void | Promise<LifecycleJobOutcome | void>;
-  /**
-   * Host domain policy applied when the alarm memory-limit circuit breaker
-   * records a strike (#1825), after every capability's `onMemoryLimit` hook.
-   *
-   * Lifecycle dispatches host hooks structurally through its internal host
-   * cast, so TS visibility is the host's to choose: a framework host whose
-   * implementation is internal machinery declares the hook `protected` (the
-   * pattern — see `AIChatAgent`/`Think`) and keeps the real work in a
-   * `private _cf_`-prefixed method, without falling out of this contract at
-   * runtime.
-   */
-  onAlarmMemoryLimit?(context: MemoryLimitContext): void | Promise<void>;
-}
-/** Values associated with the currently executing Lifecycle host. */
-type AgentContextStore = {
-  /** Lifecycle host selected for this invocation. */ agent: unknown /** WebSocket connection selected for this invocation, when applicable. */;
-  connection:
-    | Connection
-    | undefined /** HTTP request selected for this invocation, when applicable. */;
-  request:
-    | Request
-    | undefined /** Extension-owned value selected for this invocation, when applicable. */;
-  email: unknown;
-};
-/** Values returned by {@link getCurrentAgent}. */
-type CurrentAgentContext<
-  Host extends DurableObject = LifecycleObject,
-  Email = unknown
-> = {
-  agent: Host | undefined;
-  connection: Connection | undefined;
-  request: Request | undefined;
-  email: Email | undefined;
-};
-/**
- * Shared invocation context for Lifecycle, Agent, AIChatAgent, and Think.
- *
- * @internal Importing or relying on this symbol will break your code in a
- * future release. Use {@link getCurrentAgent} to read the public context.
- */
-declare const __DO_NOT_USE_WILL_BREAK__agentContext: AsyncLocalStorage<AgentContextStore>;
-/**
- * Return the current Agent or Lifecycle Object and invocation-specific values.
- *
- * Lifecycle host startup and alarm hooks receive the current object with no
- * request. Request hooks additionally receive the request being handled.
- * Lifecycle-managed WebSocket hooks receive their connection and, during
- * connect, its upgrade request. Agent extensions may also establish context
- * for email, chat turns, callable methods, and detached work. Capability hooks
- * do not run in this ambient context.
- */
-declare function getCurrentAgent<
-  Host extends DurableObject = LifecycleObject
->(): CurrentAgentContext<Host>;
-//#endregion
-export {
-  getCurrentAgent as a,
-  LifecycleRouteEnvelope as c,
-  __DO_NOT_USE_WILL_BREAK__agentContext as i,
-  LifecycleUseOptions as l,
-  CurrentAgentContext as n,
-  Lifecycle as o,
-  LifecycleObject as r,
-  LifecycleOptions as s,
-  AgentContextStore as t
-};
-//# sourceMappingURL=current-agent-Da_C9a3b.d.ts.map
+export { LifecycleOptions as n, LifecycleRouteEnvelope as r, Lifecycle as t };
+//# sourceMappingURL=durable-object-lifecycle-ei7M7lqB.d.ts.map

package/dist/index-Dlgtd3Mj.d.ts

@@ -0,0 +1,78 @@
+import {
+  s as LifecycleCapability,
+  x as Connection
+} from "./capability-runner-BUBa6Ake.js";
+//#region src/state/index.d.ts
+/**
+ * Source of a state change: `"server"` for host code (e.g. `setState()`), or
+ * the {@link Connection} the change arrived from. Hosts use it to exclude the
+ * originating connection from a broadcast.
+ */
+type StateChangeSource = Connection | "server";
+/**
+ * Options for a {@link State} capability. Validation and the post-change hook
+ * stay on the host, which passes them in; the capability owns storage and
+ * change ordering.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+interface StateOptions<T = unknown> {
+  /** Seeded on first access when nothing is stored. `undefined` seeds nothing. */
+  readonly initialState?: T;
+  /** Called after a change is validated and persisted. May be async. */
+  readonly onChanged?: (
+    state: T,
+    source: StateChangeSource
+  ) => void | Promise<void>;
+  /**
+   * Synchronous gating hook run before a change is persisted. Throw to reject
+   * the change; the throw propagates to the caller of {@link State.set}.
+   */
+  readonly validateStateChange?: (
+    nextState: T,
+    source: StateChangeSource
+  ) => void;
+}
+/**
+ * Durable state storage for a Lifecycle Object.
+ *
+ * Owns the `cf_agents_state` state row, lazy load with an in-memory cache, and
+ * validated persistence. Install the instance with `Lifecycle.use()`. State
+ * validation and the post-change notification hook stay on the host, which
+ * injects both callbacks. This capability never touches connections.
+ *
+ * @experimental The API surface may change before stabilizing.
+ */
+declare class State<T = unknown> extends LifecycleCapability {
+  #private;
+  /**
+   * Create a durable state capability.
+   *
+   * @param options - Optional initial state and a synchronous validation hook
+   * injected by the host.
+   */
+  constructor(options?: StateOptions<T>);
+  /** Initialize state storage during Lifecycle startup. */
+  onStart(): Promise<void>;
+  /**
+   * Current state.
+   *
+   * Loads lazily from storage on first access and caches in memory. Row
+   * existence in `cf_agents_state` is the signal that state was previously
+   * set, so falsy values persist correctly. On a corrupt row, falls back to
+   * the initial state (re-persisting it) or clears the row.
+   */
+  get(): T | undefined;
+  /**
+   * Validate and persist a state change, then call the change hook.
+   *
+   * @param nextState - The new state to persist.
+   * @param source - `"server"` for host-originated changes, or the originating
+   * connection for client-originated changes.
+   * @throws Whatever the injected `validateStateChange` throws.
+   */
+  set(nextState: T, source?: StateChangeSource): void;
+}
+//#endregion
+export { StateChangeSource as n, StateOptions as r, State as t };
+//# sourceMappingURL=index-Dlgtd3Mj.d.ts.map

package/dist/index.d.ts

@@ -1,92 +1,91 @@
 /// <reference path="../skills-module.d.ts" />
 import {
-  b as Connection,
-  w as WSMessage,
-  x as ConnectionContext
-} from "./capability-runner-Be_-PLR1.js";
+  S as ConnectionContext,
+  T as WSMessage,
+  x as Connection
+} from "./capability-runner-BUBa6Ake.js";
 import {
   i as isDurableObjectStorageReset,
   n as isDurableObjectCodeUpdateReset,
   r as isDurableObjectMemoryLimitReset,
   s as isPlatformTransientError,
   t as RetryOptions
-} from "./retries-D9Ds-1lz.js";
-import { i as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-Da_C9a3b.js";
+} from "./retries-D9B2UCq3.js";
+import { i as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-C4w86kcN.js";
 import {
-  $ as ChatCapableAgentClass,
-  A as StreamingResponse,
-  An as routeSubAgentRequest,
-  At as MCPAITool,
-  B as AgentToolFailure,
+  $ as DetachedAgentToolConfig,
+  A as getCurrentAgent,
+  An as withInvocationScope,
+  At as MCPAIToolSet,
+  B as AgentToolInterruptedReason,
   C as MCPServersState,
-  Cn as SubAgentPathMatch,
-  D as StartFiberOptions,
-  E as RPCResponse,
-  F as AgentToolChildAdapter,
-  G as AgentToolProgressSnapshot,
-  H as AgentToolLifecycleResult,
-  I as AgentToolDisplayMetadata,
-  J as AgentToolRunPart,
-  K as AgentToolRunInfo,
-  Kt as normalizeServerId,
-  L as AgentToolEvent,
-  M as routeAgentEmail,
-  N as AGENT_TOOL_MILESTONE_PART,
-  O as StartFiberResult,
-  On as getSubAgentByName,
-  P as AGENT_TOOL_PROGRESS_PART,
-  Q as AgentToolTerminalStatus,
-  R as AgentToolEventMessage,
+  Cn as buildAgentPath,
+  D as StartFiberResult,
+  Dn as getSubAgentByName,
+  E as StartFiberOptions,
+  F as AgentToolDisplayMetadata,
+  G as AgentToolRunInfo,
+  Gt as normalizeServerId,
+  H as AgentToolMilestone,
+  Ht as MCP_SERVER_ID_MAX_LENGTH,
+  I as AgentToolEvent,
+  J as AgentToolRunState,
+  K as AgentToolRunInspection,
+  L as AgentToolEventMessage,
+  M as AGENT_TOOL_MILESTONE_PART,
+  N as AGENT_TOOL_PROGRESS_PART,
+  O as StateUpdateMessage,
+  On as parseSubAgentPath,
+  P as AgentToolChildAdapter,
+  Q as ChatCapableAgentClass,
+  R as AgentToolEventState,
   S as MCPServerMessage,
-  Sn as SUB_PREFIX,
-  T as RPCRequest,
-  Tn as buildAgentUrl,
-  U as AgentToolMilestone,
-  Ut as MCP_SERVER_ID_MAX_LENGTH,
-  V as AgentToolInterruptedReason,
-  W as AgentToolProgress,
-  X as AgentToolRunStatus,
-  Y as AgentToolRunState,
-  Z as AgentToolStoredChunk,
+  Sn as SubAgentPathMatch,
+  T as RPCResponse,
+  U as AgentToolProgress,
+  V as AgentToolLifecycleResult,
+  W as AgentToolProgressSnapshot,
+  X as AgentToolStoredChunk,
+  Y as AgentToolRunStatus,
+  Z as AgentToolTerminalStatus,
   _ as FiberRecoveryContext,
+  _n as DynamicAgentClass,
   a as routeAgentRequest,
   b as ListFibersOptions,
-  bn as AgentPathStep,
+  bn as BuildAgentPathOptions,
   c as Agent,
   d as AgentStaticOptions,
-  et as DetachedAgentToolConfig,
+  et as DetachedRunAgentToolResult,
   f as DEFAULT_AGENT_STATIC_OPTIONS,
   g as FiberInspection,
   h as FiberContext,
   i as getAgentByName,
-  j as getCurrentAgent,
-  jn as withInvocationScope,
-  jt as MCPAIToolSet,
-  k as StateUpdateMessage,
-  kn as parseSubAgentPath,
+  j as routeAgentEmail,
+  k as StreamingResponse,
+  kn as routeSubAgentRequest,
+  kt as MCPAITool,
   l as AgentContext,
   m as EmailRoutingOptions,
   n as AgentOptions,
-  nt as RunAgentToolOptions,
+  nt as RunAgentToolResult,
   o as AddMcpServerOptions,
   p as DeleteFibersOptions,
-  q as AgentToolRunInspection,
+  q as AgentToolRunPart,
   r as RoutingRetryOptions,
-  rt as RunAgentToolResult,
   s as AddRpcMcpServerOptions,
   t as AgentGetOptions,
-  tt as DetachedRunAgentToolResult,
+  tt as RunAgentToolOptions,
   u as AgentNamespace,
   v as FiberRecoveryResult,
-  vn as DynamicAgentClass,
-  w as QueueItem,
-  wn as buildAgentPath,
+  vn as DynamicAgentStub,
+  w as RPCRequest,
+  wn as buildAgentUrl,
   x as MCPServer,
-  xn as BuildAgentPathOptions,
+  xn as SUB_PREFIX,
   y as FiberStatus,
-  yn as DynamicAgentStub,
-  z as AgentToolEventState
-} from "./agent-routing-DE5zmCQ8.js";
+  yn as AgentPathStep,
+  z as AgentToolFailure
+} from "./agent-routing-B2XLNMxq.js";
 import {
   a as EmailSendBinding,
   d as createHeaderBasedEmailResolver,
@@ -104,7 +103,8 @@ import {
   a as ScheduleCriteria,
   i as Schedule,
   o as ScheduleOptions
-} from "./scheduler-Dwh85ZGl.js";
+} from "./scheduler-BGq6M5Kd.js";
+import { i as QueueItem } from "./types-DCD6BNZH.js";
 import {
   n as callable,
   s as unstable_callable,
@@ -172,7 +172,7 @@ export {
   MCPServersState,
   MCP_SERVER_ID_MAX_LENGTH,
   MessageType,
-  QueueItem,
+  type QueueItem,
   RPCRequest,
   RPCResponse,
   type RetryOptions,

package/dist/index.js

@@ -7,9 +7,9 @@ import { MessageType } from "./types.js";
 import { createHeaderBasedEmailResolver } from "./email.js";
 import { n as withInvocationScope } from "./cloudflare-Dzvc7V2N.js";
 import { SUB_PREFIX, buildAgentPath, buildAgentUrl, getSubAgentByName, parseSubAgentPath, routeSubAgentRequest } from "./sub-routing.js";
-import { a as routeAgentEmail, i as getCurrentAgent, n as DEFAULT_AGENT_STATIC_OPTIONS, r as StreamingResponse, t as Agent } from "./src-DlSHshb2.js";
+import { a as routeAgentEmail, i as getCurrentAgent, n as DEFAULT_AGENT_STATIC_OPTIONS, r as StreamingResponse, t as Agent } from "./src-BNU3ZiJM.js";
 import { isDurableObjectCodeUpdateReset, isDurableObjectMemoryLimitReset, isDurableObjectStorageReset, isPlatformTransientError } from "./retries.js";
 import { SqlError } from "./sql-error.js";
-import { i as normalizeServerId, n as MCP_SERVER_ID_MAX_LENGTH } from "./client-jagG8a9_.js";
+import { i as normalizeServerId, n as MCP_SERVER_ID_MAX_LENGTH } from "./client-fyQrLGkD.js";
 import { DurableObjectOAuthClientProvider } from "./mcp/client/do-oauth-client-provider.js";
 export { AGENT_TOOL_MILESTONE_PART, AGENT_TOOL_PROGRESS_PART, Agent, DEFAULT_AGENT_STATIC_OPTIONS, DurableObjectOAuthClientProvider, MCP_SERVER_ID_MAX_LENGTH, MessageType, SUB_PREFIX, SqlError, StreamingResponse, __DO_NOT_USE_WILL_BREAK__agentContext, withInvocationScope as __DO_NOT_USE_WILL_BREAK__withInvocationScope, buildAgentPath, buildAgentUrl, callable, camelCaseToKebabCase, createHeaderBasedEmailResolver, getAgentByName, getCurrentAgent, getSubAgentByName, isDurableObjectCodeUpdateReset, isDurableObjectMemoryLimitReset, isDurableObjectStorageReset, isPlatformTransientError, normalizeServerId, parseSubAgentPath, routeAgentEmail, routeAgentRequest, routeSubAgentRequest, unstable_callable };

package/dist/internal_context.d.ts

@@ -2,7 +2,7 @@ import {
   i as __DO_NOT_USE_WILL_BREAK__agentContext,
   n as CurrentAgentContext,
   t as AgentContextStore
-} from "./current-agent-Da_C9a3b.js";
+} from "./current-agent-C4w86kcN.js";
 import { t as AgentEmail } from "./internal_context-BlxFEWfn.js";
 export {
   type AgentContextStore,

package/dist/lifecycle/index.d.ts

@@ -1,14 +1,15 @@
 import {
-  C as ConnectionState,
-  S as ConnectionSetStateFn,
-  _ as LifecycleJobOutcome,
+  C as ConnectionSetStateFn,
+  S as ConnectionContext,
+  T as WSMessage,
+  _ as LifecycleJobContext,
   a as LifecycleEvent,
-  b as Connection,
+  b as LifecycleJobs,
   c as LifecycleEvents,
   d as LifecycleRouteContext,
   f as LifecycleRoutes,
-  g as LifecycleJobContext,
-  h as LifecycleJob,
+  g as LifecycleJob,
+  h as LifecycleStatus,
   i as DurableObjectCapability,
   l as LifecycleHostContextScope,
   m as LifecycleSockets,
@@ -19,19 +20,20 @@ import {
   s as LifecycleCapability,
   t as CapabilityRequestContext,
   u as LifecycleRouteAddress,
-  v as LifecycleJobPushOptions,
-  w as WSMessage,
-  x as ConnectionContext,
-  y as LifecycleJobs
-} from "../capability-runner-Be_-PLR1.js";
+  v as LifecycleJobOutcome,
+  w as ConnectionState,
+  x as Connection,
+  y as LifecycleJobPushOptions
+} from "../capability-runner-BUBa6Ake.js";
+import {
+  n as LifecycleOptions,
+  t as Lifecycle
+} from "../durable-object-lifecycle-ei7M7lqB.js";
 import {
   a as getCurrentAgent,
-  l as LifecycleUseOptions,
   n as CurrentAgentContext,
-  o as Lifecycle,
-  r as LifecycleObject,
-  s as LifecycleOptions
-} from "../current-agent-Da_C9a3b.js";
+  r as LifecycleObject
+} from "../current-agent-C4w86kcN.js";
 export {
   type CapabilityRequestContext,
   type CapabilityStartContext,
@@ -59,7 +61,7 @@ export {
   type LifecycleRoutes,
   type LifecycleServices,
   type LifecycleSockets,
-  type LifecycleUseOptions,
+  type LifecycleStatus,
   type MemoryLimitContext,
   type WSMessage,
   getCurrentAgent

package/dist/lifecycle/index.js

@@ -1,4 +1,4 @@
 import { n as getCurrentAgent } from "../current-agent-DhoDkSnH.js";
-import { t as LifecycleCapability } from "../capability-BjSKYpzg.js";
-import { t as Lifecycle } from "../lifecycle-CMRGjZdw.js";
+import { t as LifecycleCapability } from "../capability-B4WbF81e.js";
+import { t as Lifecycle } from "../lifecycle-Mm_jQh7r.js";
 export { Lifecycle, LifecycleCapability, getCurrentAgent };

package/dist/{lifecycle-CMRGjZdw.js → lifecycle-Mm_jQh7r.js}

@@ -1,6 +1,6 @@
 import { i as runWithoutCurrentAgent, r as runInLifecycleHostContext } from "./current-agent-DhoDkSnH.js";
 import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "./classPrivateFieldGet2-DZBYAB34.js";
-import { n as bindLifecycleCapability, r as lifecycleCapabilityId, t as LifecycleCapability } from "./capability-BjSKYpzg.js";
+import { n as bindLifecycleCapability, r as lifecycleCapabilityId, t as LifecycleCapability } from "./capability-B4WbF81e.js";
 import { t as _classPrivateMethodInitSpec } from "./classPrivateMethodInitSpec-qMjJ6sHQ.js";
 import { n as publishDiagnosticsEvent } from "./diagnostics-BzvaX2UT.js";
 import { isDurableObjectCodeUpdateReset, isDurableObjectMemoryLimitReset, isPlatformFailure, tryN } from "./retries.js";
@@ -818,6 +818,17 @@ function setLifecycleRouteTransport(lifecycle, transport) {
 function setLifecycleEventSink(lifecycle, sink) {
 	lifecycleEventSinks.set(lifecycle, sink);
 }
+/**
+* Installs and coordinates the runtime lifecycle for a Durable Object.
+*
+* Construct this as an instance field on a class that directly extends
+* `DurableObject`, then call {@link Lifecycle.installHandlers}
+* from that class's constructor.
+*
+* @experimental The API surface may change before stabilizing.
+*/
+/** The dispatch hooks a catch-all can monopolize; uniqueness is per hook. */
+const CATCH_ALL_HOOKS = ["onRequest", "onWebSocketUpgrade"];
 var _host = /* @__PURE__ */ new WeakMap();
 var _ctx = /* @__PURE__ */ new WeakMap();
 var _parentClassName = /* @__PURE__ */ new WeakMap();
@@ -831,20 +842,10 @@ var _rearmRequestedDuringStart = /* @__PURE__ */ new WeakMap();
 var _pendingEvents = /* @__PURE__ */ new WeakMap();
 var _alarmsDisabled = /* @__PURE__ */ new WeakMap();
 var _capabilitiesLocked = /* @__PURE__ */ new WeakMap();
-var _fallbacks = /* @__PURE__ */ new WeakMap();
 var _handlersInstalled = /* @__PURE__ */ new WeakMap();
 var _Lifecycle_brand = /* @__PURE__ */ new WeakSet();
 var _legacyName = /* @__PURE__ */ new WeakMap();
 var _props = /* @__PURE__ */ new WeakMap();
-/**
-* Installs and coordinates the runtime lifecycle for a Durable Object.
-*
-* Construct this as an instance field on a class that directly extends
-* `DurableObject`, then call {@link Lifecycle.installHandlers}
-* from that class's constructor.
-*
-* @experimental The API surface may change before stabilizing.
-*/
 var Lifecycle = class Lifecycle {
 	/**
 	* Construct and install a lifecycle in one explicit operation.
@@ -878,7 +879,6 @@ var Lifecycle = class Lifecycle {
 		_classPrivateFieldInitSpec(this, _pendingEvents, []);
 		_classPrivateFieldInitSpec(this, _alarmsDisabled, false);
 		_classPrivateFieldInitSpec(this, _capabilitiesLocked, false);
-		_classPrivateFieldInitSpec(this, _fallbacks, /* @__PURE__ */ new Set());
 		_classPrivateFieldInitSpec(this, _handlersInstalled, false);
 		_classPrivateFieldInitSpec(this, _legacyName, void 0);
 		_classPrivateFieldInitSpec(this, _props, void 0);
@@ -935,20 +935,31 @@ var Lifecycle = class Lifecycle {
 	/**
 	* Add a reusable capability before this lifecycle starts.
 	*
-	* Capabilities dispatch in registration order, except that fallbacks
-	* always come after non-fallbacks.
+	* Capabilities dispatch in registration order, except that a capability
+	* declaring `claims: "catch-all"` always comes last, whenever it was
+	* installed. Catch-alls are unique per dispatch hook: two may coexist
+	* when they claim disjoint traffic (one `onRequest`, one
+	* `onWebSocketUpgrade`), but a second catch-all for the same hook could
+	* never be reached and is refused.
 	*
 	* @param capability - The capability to add.
-	* @param options - Dispatch placement.
 	* @returns This lifecycle.
 	*/
-	use(capability, options) {
+	use(capability) {
 		if (_classPrivateFieldGet2(_capabilitiesLocked, this)) throw new Error("Lifecycle capabilities must be added before startup");
 		const capabilityId = lifecycleCapabilityId(capability);
 		if (capabilityId && _classPrivateFieldGet2(_capabilities, this).some((candidate) => lifecycleCapabilityId(candidate) === capabilityId)) throw new Error(`Lifecycle capability ${JSON.stringify(capabilityId)} is already installed`);
-		const firstFallback = _classPrivateFieldGet2(_capabilities, this).findIndex((candidate) => _classPrivateFieldGet2(_fallbacks, this).has(candidate));
-		if (options?.fallback) _classPrivateFieldGet2(_fallbacks, this).add(capability);
-		_classPrivateFieldGet2(_capabilities, this).splice(options?.fallback || firstFallback === -1 ? _classPrivateFieldGet2(_capabilities, this).length : firstFallback, 0, capability);
+		const catchAllIndex = _classPrivateFieldGet2(_capabilities, this).findIndex((candidate) => candidate.claims === "catch-all");
+		if (capability.claims === "catch-all") {
+			for (const hook of CATCH_ALL_HOOKS) {
+				if (!capability[hook]) continue;
+				const rival = _classPrivateFieldGet2(_capabilities, this).find((candidate) => candidate.claims === "catch-all" && candidate[hook]);
+				if (!rival) continue;
+				const installed = lifecycleCapabilityId(rival);
+				throw new Error(`Lifecycle already has a catch-all for ${hook}${installed ? ` (${JSON.stringify(installed)})` : ""}; a second one could never be reached`);
+			}
+			_classPrivateFieldGet2(_capabilities, this).push(capability);
+		} else _classPrivateFieldGet2(_capabilities, this).splice(catchAllIndex === -1 ? _classPrivateFieldGet2(_capabilities, this).length : catchAllIndex, 0, capability);
 		if (capability instanceof LifecycleCapability) bindLifecycleCapability(capability, _assertClassBrand(_Lifecycle_brand, this, _servicesForCapability).call(this, capability.capabilityId));
 		return this;
 	}
@@ -1139,13 +1150,17 @@ function _servicesForCapability(capabilityId) {
 		payload
 	});
 	return Object.freeze({
+		get name() {
+			return lifecycle.name;
+		},
+		className: _classPrivateFieldGet2(_parentClassName, this),
 		storage: _classPrivateFieldGet2(_ctx, this).storage,
 		sockets: Object.freeze({
 			accept: (ws, tags) => _classPrivateFieldGet2(_ctx, this).acceptWebSocket(ws, tags),
 			get: (tag) => _classPrivateFieldGet2(_ctx, this).getWebSockets(tag)
 		}),
 		ready: () => _assertClassBrand(_Lifecycle_brand, this, _readyForCapabilityOperation).call(this),
-		starting: () => _classPrivateFieldGet2(_status, this) === "starting",
+		status: () => _classPrivateFieldGet2(_status, this),
 		jobs: _assertClassBrand(_Lifecycle_brand, this, _jobsForOwner).call(this, capabilityId),
 		trackAlarmWork: (work) => _classPrivateFieldGet2(_jobDriver, this).trackAlarmWork(work),
 		runInHostContext: async (fn, scope) => _assertClassBrand(_Lifecycle_brand, this, _runInHostBoundary).call(this, fn, scope),
@@ -1296,4 +1311,4 @@ async function _resolveJobDispatch(owner) {
 //#endregion
 export { abortWithoutAlarmRetry as a, setLifecycleRouteTransport as i, setLifecycleEventSink as n, setLifecycleHostInvoker as r, Lifecycle as t };
 
-//# sourceMappingURL=lifecycle-CMRGjZdw.js.map
+//# sourceMappingURL=lifecycle-Mm_jQh7r.js.map