agents 0.13.1 → 0.13.3

package/dist/{agent-tool-types-Dn9n-3SI.d.ts → agent-tool-types-l98LCbBl.d.ts}

@@ -1912,6 +1912,22 @@ type FiberRecoveryContext = {
   createdAt: number;
   [key: string]: unknown;
 };
+type InternalFiberOptions = {
+  signal?: AbortSignal;
+  managed?: boolean;
+  initialSnapshot?: unknown;
+  wrapStash?: (data: unknown) => unknown;
+  beforeRunCleanup?: (
+    outcome:
+      | {
+          ok: true;
+        }
+      | {
+          ok: false;
+          error: unknown;
+        }
+  ) => void;
+};
 /**
  * MCP Server state update message from server -> Client
  */
@@ -2071,6 +2087,13 @@ declare class Agent<
   private _protocolBroadcastExcludeIds;
   private _cf_currentSubAgentBridge?;
   private _cf_virtualSubAgentConnections;
+  /**
+   * User-facing facet name. For legacy facets this is the same as
+   * `ctx.id.name`; path-scoped facets use an internal routing id and
+   * keep the logical name here instead.
+   * @internal
+   */
+  private _facetName?;
   /**
    * Ancestor chain, root-first. Empty for top-level DOs; populated at
    * facet init time from the parent's own `selfPath`. Exposed publicly
@@ -2483,6 +2506,7 @@ declare class Agent<
   private _facetRunRowsForPrefix;
   private _deleteFacetRunRowsForPrefix;
   private _rootAlarmOwner;
+  private _cf_rootResolvesToSelf;
   private _validateScheduleCallback;
   /**
    * Insert (or, for idempotent calls, return the existing row for) a
@@ -2828,6 +2852,20 @@ declare class Agent<
    * @returns The return value of fn
    */
   runFiber<T>(name: string, fn: (ctx: FiberContext) => Promise<T>): Promise<T>;
+  /**
+   * Internal framework entry point for fibers that need to compose their own
+   * recovery metadata with user checkpoint data while preserving the public
+   * `this.stash()` behavior.
+   *
+   * This deliberately stays protected/internal rather than becoming a public
+   * `runFiber()` option until the durable execution API needs this generality.
+   * @internal
+   */
+  protected _runFiberWithStashWrapper<T>(
+    name: string,
+    fn: (ctx: FiberContext) => Promise<T>,
+    options: Pick<InternalFiberOptions, "initialSnapshot" | "wrapStash">
+  ): Promise<T>;
   startFiber(
     name: string,
     fn: (ctx: FiberContext) => Promise<void>,
@@ -3128,13 +3166,9 @@ declare class Agent<
    * broadcast to their own WebSocket clients reached via sub-agent
    * routing.
    *
-   * 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 named Durable Object id 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.
+   * The facet's logical name is persisted separately from its routing id.
+   * Legacy facets used the logical name directly as `ctx.id.name`; newer
+   * facets can use path-scoped routing ids while preserving `this.name`.
    *
    * @internal Called by {@link subAgent}.
    */
@@ -3143,8 +3177,10 @@ declare class Agent<
     parentPath?: ReadonlyArray<{
       className: string;
       name: string;
-    }>
+    }>,
+    identityName?: string
   ): Promise<void>;
+  get name(): string;
   /**
    * Ancestor chain for this agent, root-first. Empty for top-level
    * DOs. Populated at facet init time; survives hibernation.
@@ -3332,11 +3368,15 @@ declare class Agent<
   deleteSubAgent(cls: SubAgentClass, name: string): Promise<void>;
   /** @internal */
   private _subAgentRegistryReady;
+  private _addColumnIfNotExists;
   /** @internal */
   private _ensureSubAgentRegistry;
   /** @internal */
   private _recordSubAgent;
   /** @internal */
+  private _subAgentRegistryRow;
+  private _cf_subAgentIdentity;
+  /** @internal */
   private _forgetSubAgent;
   /**
    * Whether this agent has previously spawned (and not deleted) a
@@ -4237,4 +4277,4 @@ export {
   MCPServersState as z,
   SUB_PREFIX as zt
 };
-//# sourceMappingURL=agent-tool-types-Dn9n-3SI.d.ts.map
+//# sourceMappingURL=agent-tool-types-l98LCbBl.d.ts.map

package/dist/agent-tool-types.d.ts

@@ -14,7 +14,7 @@ import {
   s as AgentToolRunInfo,
   t as AgentToolChildAdapter,
   u as AgentToolRunStatus
-} from "./agent-tool-types-Dn9n-3SI.js";
+} from "./agent-tool-types-l98LCbBl.js";
 export {
   AgentToolChildAdapter,
   AgentToolDisplayMetadata,

package/dist/{agent-tools-B1ttU-pq.d.ts → agent-tools-Bg5ilERh.d.ts}

@@ -1,7 +1,7 @@
 import {
   a as AgentToolEventState,
   i as AgentToolEventMessage
-} from "./agent-tool-types-Dn9n-3SI.js";
+} from "./agent-tool-types-l98LCbBl.js";
 
 //#region src/chat/agent-tools.d.ts
 declare function createAgentToolEventState(): AgentToolEventState;
@@ -11,4 +11,4 @@ declare function applyAgentToolEvent(
 ): AgentToolEventState;
 //#endregion
 export { createAgentToolEventState as n, applyAgentToolEvent as t };
-//# sourceMappingURL=agent-tools-B1ttU-pq.d.ts.map
+//# sourceMappingURL=agent-tools-Bg5ilERh.d.ts.map

package/dist/agent-tools.d.ts

@@ -14,7 +14,7 @@ import {
   s as AgentToolRunInfo,
   t as AgentToolChildAdapter,
   u as AgentToolRunStatus
-} from "./agent-tool-types-Dn9n-3SI.js";
+} from "./agent-tool-types-l98LCbBl.js";
 import { Tool } from "ai";
 
 //#region src/agent-tools.d.ts

package/dist/chat/index.d.ts

@@ -3,11 +3,11 @@ import {
   i as AgentToolEventMessage,
   l as AgentToolRunState,
   r as AgentToolEvent
-} from "../agent-tool-types-Dn9n-3SI.js";
+} from "../agent-tool-types-l98LCbBl.js";
 import {
   n as createAgentToolEventState,
   t as applyAgentToolEvent
-} from "../agent-tools-B1ttU-pq.js";
+} from "../agent-tools-Bg5ilERh.js";
 import { JSONSchema7, Tool, ToolSet, UIMessage } from "ai";
 import { Connection } from "agents";
 
@@ -317,10 +317,17 @@ type SaveMessagesOptions = {
  *   completion, either by `MSG_CHAT_CANCEL` over the chat WebSocket or
  *   by an external `AbortSignal` passed via {@link SaveMessagesOptions}.
  *   Partial chunks streamed before the abort are still persisted.
+ * - `"error"` — the turn ran but ended with a stream error. Partial chunks
+ *   streamed before the error are still persisted.
  */
 type SaveMessagesResult = {
-  /** Server-generated request ID for the chat turn. */ requestId: string /** Whether the turn ran, was skipped, or was aborted. */;
-  status: "completed" | "skipped" | "aborted";
+  /** Server-generated request ID for the chat turn. */ requestId: string /** Whether the turn completed, errored, was skipped, or was aborted. */;
+  status:
+    | "completed"
+    | "error"
+    | "skipped"
+    | "aborted" /** Error message when `status` is `"error"`. */;
+  error?: string;
 };
 /**
  * Context passed to the `onChatRecovery` hook when an interrupted chat
@@ -933,6 +940,48 @@ declare function assistantContentKey(
   sanitize?: (message: UIMessage) => UIMessage
 ): string | undefined;
 //#endregion
+//#region src/chat/recovery.d.ts
+type ChatFiberSnapshot<Kind extends string = string> = {
+  kind: Kind;
+  version: 1;
+  requestId: string;
+  continuation: boolean;
+  latestMessageId?: string;
+  latestMessageRole?: string;
+  latestUserMessageId?: string;
+  startedAt: number;
+  lastBody?: Record<string, unknown>;
+  lastClientTools?: ClientToolSchema[];
+};
+declare function createChatFiberSnapshot<Kind extends string>({
+  kind,
+  requestId,
+  continuation,
+  messages,
+  lastBody,
+  lastClientTools
+}: {
+  kind: Kind;
+  requestId: string;
+  continuation: boolean;
+  messages: UIMessage[];
+  lastBody?: Record<string, unknown>;
+  lastClientTools?: ClientToolSchema[];
+}): ChatFiberSnapshot<Kind>;
+declare function wrapChatFiberSnapshot<Kind extends string>(
+  key: string,
+  snapshot: ChatFiberSnapshot<Kind>,
+  user: unknown | null
+): Record<string, unknown>;
+declare function unwrapChatFiberSnapshot<Kind extends string>(
+  key: string,
+  value: unknown,
+  expectedKind?: Kind
+): {
+  snapshot: ChatFiberSnapshot<Kind> | null;
+  user: unknown | null;
+};
+//#endregion
 export {
   AbortRegistry,
   type AgentToolEvent,
@@ -943,6 +992,7 @@ export {
   type BroadcastStreamState,
   type TransitionResult as BroadcastTransitionResult,
   CHAT_MESSAGE_TYPES,
+  type ChatFiberSnapshot,
   type ChatProtocolEvent,
   type ChatRecoveryContext,
   type ChatRecoveryOptions,
@@ -979,6 +1029,7 @@ export {
   transition as broadcastTransition,
   byteLength,
   createAgentToolEventState,
+  createChatFiberSnapshot,
   createToolsFromClientSchemas,
   enforceRowSizeLimit,
   isReplayChunk,
@@ -987,6 +1038,8 @@ export {
   resolveToolMergeId,
   sanitizeMessage,
   toolApprovalUpdate,
-  toolResultUpdate
+  toolResultUpdate,
+  unwrapChatFiberSnapshot,
+  wrapChatFiberSnapshot
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/chat/index.js

@@ -1378,6 +1378,55 @@ function findMessageByToolCallId(messages, toolCallId) {
 	}
 }
 //#endregion
-export { AbortRegistry, CHAT_MESSAGE_TYPES, ContinuationState, ROW_MAX_BYTES, ResumableStream, StreamAccumulator, SubmitConcurrencyController, TurnQueue, applyAgentToolEvent, applyChunkToParts, applyToolUpdate, assistantContentKey, transition as broadcastTransition, byteLength, createAgentToolEventState, createToolsFromClientSchemas, enforceRowSizeLimit, isReplayChunk, parseProtocolMessage, reconcileMessages, resolveToolMergeId, sanitizeMessage, toolApprovalUpdate, toolResultUpdate };
+//#region src/chat/recovery.ts
+function createChatFiberSnapshot({ kind, requestId, continuation, messages, lastBody, lastClientTools }) {
+	const latestMessage = messages.length > 0 ? messages[messages.length - 1] : void 0;
+	let latestUser;
+	for (let index = messages.length - 1; index >= 0; index--) if (messages[index].role === "user") {
+		latestUser = messages[index];
+		break;
+	}
+	return {
+		kind,
+		version: 1,
+		requestId,
+		continuation,
+		latestMessageId: latestMessage?.id,
+		latestMessageRole: latestMessage?.role,
+		latestUserMessageId: latestUser?.id,
+		startedAt: Date.now(),
+		lastBody,
+		lastClientTools
+	};
+}
+function wrapChatFiberSnapshot(key, snapshot, user) {
+	return {
+		[key]: snapshot,
+		user
+	};
+}
+function unwrapChatFiberSnapshot(key, value, expectedKind) {
+	if (typeof value !== "object" || value === null || !(key in value)) return {
+		snapshot: null,
+		user: value
+	};
+	const envelope = value;
+	const snapshot = envelope[key];
+	if (typeof snapshot !== "object" || snapshot === null) return {
+		snapshot: null,
+		user: value
+	};
+	const candidate = snapshot;
+	if (candidate.version !== 1 || expectedKind !== void 0 && candidate.kind !== expectedKind || typeof candidate.requestId !== "string" || typeof candidate.continuation !== "boolean") return {
+		snapshot: null,
+		user: value
+	};
+	return {
+		snapshot,
+		user: envelope.user ?? null
+	};
+}
+//#endregion
+export { AbortRegistry, CHAT_MESSAGE_TYPES, ContinuationState, ROW_MAX_BYTES, ResumableStream, StreamAccumulator, SubmitConcurrencyController, TurnQueue, applyAgentToolEvent, applyChunkToParts, applyToolUpdate, assistantContentKey, transition as broadcastTransition, byteLength, createAgentToolEventState, createChatFiberSnapshot, createToolsFromClientSchemas, enforceRowSizeLimit, isReplayChunk, parseProtocolMessage, reconcileMessages, resolveToolMergeId, sanitizeMessage, toolApprovalUpdate, toolResultUpdate, unwrapChatFiberSnapshot, wrapChatFiberSnapshot };
 
 //# sourceMappingURL=index.js.map