agents 0.20.1 → 0.22.0

package/dist/chat/index.d.ts

@@ -1,10 +1,10 @@
 import {
-  U as FiberRecoveryContext,
-  _ as AgentToolRunState,
-  a as AgentToolEvent,
-  o as AgentToolEventMessage,
-  s as AgentToolEventState
-} from "../agent-tool-types-BC-WFlsz.js";
+  H as AgentToolEvent,
+  U as AgentToolEventMessage,
+  W as AgentToolEventState,
+  et as AgentToolRunState,
+  v as FiberRecoveryContext
+} from "../agent-routing-CnkaHb-v.js";
 import {
   n as ClientToolSchema,
   r as createToolsFromClientSchemas,
@@ -18,7 +18,7 @@ import {
   r as AgentToolProgressEmitResult,
   s as interceptAgentToolBroadcast,
   t as AgentToolBroadcastHooks
-} from "../agent-tools-DeHe9Xov.js";
+} from "../agent-tools-C0XJqWzB.js";
 import { JSONSchema7, UIMessage } from "ai";
 import { Connection } from "agents";
 
@@ -192,7 +192,9 @@ declare function enforceRowSizeLimit(
 //#region src/chat/stream-accumulator.d.ts
 interface StreamAccumulatorOptions {
   messageId: string;
+  /** Whether chunks continue the current assistant message when merged. */
   continuation?: boolean;
+  /** Eager seed; omitted continuations seed from the messages passed to `mergeInto`. */
   existingParts?: UIMessage["parts"];
   existingMetadata?: Record<string, unknown>;
 }
@@ -236,6 +238,7 @@ declare class StreamAccumulator {
   readonly parts: UIMessage["parts"];
   metadata?: Record<string, unknown>;
   private _isContinuation;
+  private _pendingContinuationChunks;
   constructor(options: StreamAccumulatorOptions);
   applyChunk(chunk: StreamChunkData): ChunkResult;
   /** Snapshot the current state as a UIMessage. */
@@ -243,7 +246,8 @@ declare class StreamAccumulator {
   /**
    * Merge this accumulator's message into an existing message array.
    * Handles continuation (walk backward for last assistant), replacement
-   * (update existing by messageId), or append (new message).
+   * (update existing by messageId), or append (new message). An unseeded
+   * continuation adopts current parts here before applying its queued chunks.
    */
   mergeInto(messages: UIMessage[]): UIMessage[];
 }
@@ -307,6 +311,32 @@ declare class TurnQueue {
   private _decrementCount;
 }
 //#endregion
+//#region src/chat/text-segment-joiner.d.ts
+/** @internal A parsed structured-stream chunk accepted by the joiner. */
+interface TextSegmentChunk {
+  delta?: unknown;
+  text?: unknown;
+  type?: unknown;
+}
+/** @internal A text or semantic boundary emitted by the joiner. */
+type TextSegmentEvent =
+  | {
+      type: "text";
+      text: string;
+    }
+  | {
+      type: "boundary";
+    };
+/**
+ * @internal Converts structured stream chunks into text and boundary events
+ * without gluing words across non-text chunks. Sibling-package support for
+ * `@cloudflare/voice` and `@cloudflare/think`, not a public API.
+ */
+declare class TextSegmentJoiner {
+  #private;
+  pushChunk(chunk: TextSegmentChunk): TextSegmentEvent[];
+}
+//#endregion
 //#region src/chat/lifecycle.d.ts
 /**
  * An advisory, open-ended hint that an action records during a turn to
@@ -495,9 +525,11 @@ type ChatRecoveryProgressContext = {
   ageMs: number;
 };
 /**
- * Configuration for durable chat recovery. `true` uses these defaults:
- * `maxAttempts: 10`, `stableTimeoutMs: 10_000`, `noProgressTimeoutMs: 300_000`
- * (5 min), `maxRecoveryWork: 1000`, and a generic terminal message.
+ * Configuration for durable chat recovery, which is always enabled for chat
+ * turns. `true` uses these defaults: `maxAttempts: 10`,
+ * `stableTimeoutMs: 10_000`, `noProgressTimeoutMs: 300_000` (5 min),
+ * `maxRecoveryWork: 1000`, and a generic terminal message. Assign an object to
+ * tune recovery without disabling its durable bookkeeping.
  *
  * **Apply this as a class field or in the constructor — never assign it in
  * `onStart()`.** On every wake the SDK evaluates recovery budgets (and may seal
@@ -509,7 +541,7 @@ type ChatRecoveryProgressContext = {
  * `onStart()`.
  */
 type ChatRecoveryConfig =
-  | boolean
+  | true
   | {
       maxAttempts?: number;
       stableTimeoutMs?: number;
@@ -570,8 +602,8 @@ type ChatRecoveryConfig =
       ): boolean | Promise<boolean>;
       onExhausted?(ctx: ChatRecoveryExhaustedContext): void | Promise<void>;
     };
+/** Fully-defaulted configuration for always-on durable chat recovery. */
 type ResolvedChatRecoveryConfig = {
-  enabled: boolean;
   maxAttempts: number;
   stableTimeoutMs: number;
   terminalMessage: string;
@@ -682,7 +714,7 @@ type BroadcastStreamEvent =
       error?: boolean;
       replay?: boolean;
       replayComplete?: boolean;
-      continuation?: boolean /** Required when continuation=true so the accumulator can pick up existing parts. */;
+      continuation?: boolean /** @deprecated Continuations now seed from current messages in `messagesUpdate`. */;
       currentMessages?: UIMessage[];
     }
   | {
@@ -2246,7 +2278,8 @@ declare const CHAT_RECOVERY_ALARM_DEBOUNCE_MS: number;
 declare const CHAT_RECOVERING_FLAG_TTL_MS: number;
 /**
  * Resolve a raw `chatRecovery` config field into the fully-defaulted form the
- * engine reasons about. Identical defaulting in both packages today.
+ * engine reasons about. Durable recovery is always enabled; a legacy runtime
+ * `false` value from previously compiled JavaScript safely receives defaults.
  */
 declare function resolveChatRecoveryConfig(
   raw: ChatRecoveryConfig | undefined
@@ -3355,6 +3388,9 @@ export {
   SubmitConcurrencyController,
   type SubmitConcurrencyDecision,
   TIMED_OUT,
+  type TextSegmentChunk,
+  type TextSegmentEvent,
+  TextSegmentJoiner,
   type ToolPartUpdate,
   TurnQueue,
   type TurnResult,

package/dist/chat/index.js

@@ -1,7 +1,10 @@
+import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../classPrivateFieldGet2-DZBYAB34.js";
+import { t as _classPrivateMethodInitSpec } from "../classPrivateMethodInitSpec-qMjJ6sHQ.js";
 import { i as normalizeToolInput, n as getPartialStreamText, r as isReplayChunk, t as applyChunkToParts } from "../message-builder-BymO4N_D.js";
 import { i as interceptAgentToolBroadcast, n as applyAgentToolEvent, r as createAgentToolEventState, t as AgentToolProgressEmitter } from "../agent-tools-y7zLfw4Q.js";
 import { t as truncateToolOutput } from "../tool-output-truncation-CNnnGZQ3.js";
-import { a as StreamAccumulator, i as transition, n as CHAT_MESSAGE_TYPES, r as STREAM_RESUME_NONE_REASONS, t as MessageType } from "../wire-types-CU9rLoeS.js";
+import { i as StreamAccumulator, n as STREAM_RESUME_NONE_REASONS, r as transition, t as CHAT_MESSAGE_TYPES } from "../protocol-B0nh6KNf.js";
+import { t as MessageType } from "../wire-types-CnMt6_HR.js";
 import { jsonSchema, tool } from "ai";
 import { nanoid } from "nanoid";
 //#region src/chat/sanitize.ts
@@ -215,6 +218,58 @@ var TurnQueue = class {
 	}
 };
 //#endregion
+//#region src/chat/text-segment-joiner.ts
+var _hasText = /* @__PURE__ */ new WeakMap();
+var _lastTextEndedWithWhitespace = /* @__PURE__ */ new WeakMap();
+var _needsBoundarySpace = /* @__PURE__ */ new WeakMap();
+var _TextSegmentJoiner_brand = /* @__PURE__ */ new WeakSet();
+/**
+* @internal Converts structured stream chunks into text and boundary events
+* without gluing words across non-text chunks. Sibling-package support for
+* `@cloudflare/voice` and `@cloudflare/think`, not a public API.
+*/
+var TextSegmentJoiner = class {
+	constructor() {
+		_classPrivateMethodInitSpec(this, _TextSegmentJoiner_brand);
+		_classPrivateFieldInitSpec(this, _hasText, false);
+		_classPrivateFieldInitSpec(this, _lastTextEndedWithWhitespace, false);
+		_classPrivateFieldInitSpec(this, _needsBoundarySpace, false);
+	}
+	pushChunk(chunk) {
+		if (chunk.type === "text-delta") {
+			const text = textFromChunk(chunk);
+			return text ? _assertClassBrand(_TextSegmentJoiner_brand, this, _pushText).call(this, text) : [];
+		}
+		if (typeof chunk.type !== "string" || !_assertClassBrand(_TextSegmentJoiner_brand, this, _markBoundary).call(this)) return [];
+		return [{ type: "boundary" }];
+	}
+};
+function _markBoundary() {
+	if (!_classPrivateFieldGet2(_hasText, this) || _classPrivateFieldGet2(_needsBoundarySpace, this)) return false;
+	_classPrivateFieldSet2(_needsBoundarySpace, this, true);
+	return true;
+}
+function _pushText(text) {
+	const events = [];
+	if (_classPrivateFieldGet2(_needsBoundarySpace, this) && !_classPrivateFieldGet2(_lastTextEndedWithWhitespace, this) && !/^\s/.test(text)) events.push({
+		type: "text",
+		text: " "
+	});
+	events.push({
+		type: "text",
+		text
+	});
+	_classPrivateFieldSet2(_hasText, this, true);
+	_classPrivateFieldSet2(_lastTextEndedWithWhitespace, this, /\s$/.test(text));
+	_classPrivateFieldSet2(_needsBoundarySpace, this, false);
+	return events;
+}
+function textFromChunk(chunk) {
+	if (typeof chunk.text === "string") return chunk.text;
+	if (typeof chunk.delta === "string") return chunk.delta;
+	return null;
+}
+//#endregion
 //#region src/chat/submit-concurrency.ts
 var SubmitConcurrencyController = class {
 	constructor(options) {
@@ -2506,12 +2561,12 @@ const CHAT_RECOVERY_ALARM_DEBOUNCE_MS = 30 * 1e3;
 const CHAT_RECOVERING_FLAG_TTL_MS = 900 * 1e3;
 /**
 * Resolve a raw `chatRecovery` config field into the fully-defaulted form the
-* engine reasons about. Identical defaulting in both packages today.
+* engine reasons about. Durable recovery is always enabled; a legacy runtime
+* `false` value from previously compiled JavaScript safely receives defaults.
 */
 function resolveChatRecoveryConfig(raw) {
 	const custom = typeof raw === "object" && raw !== null ? raw : void 0;
 	return {
-		enabled: raw !== false,
 		maxAttempts: Math.max(1, Math.floor(custom?.maxAttempts ?? 10)),
 		stableTimeoutMs: Math.max(0, Math.floor(custom?.stableTimeoutMs ?? 1e4)),
 		terminalMessage: custom?.terminalMessage ?? "The assistant was interrupted and could not recover. Please try again.",
@@ -3393,6 +3448,6 @@ async function* iterateWithStallWatchdog(source, timeoutMs, onStall) {
 	}
 }
 //#endregion
-export { AGENT_TOOL_STREAM_PROGRESS_BUMP_THROTTLE_MS, AbortRegistry, AgentToolProgressEmitter, AgentToolStreamProgressThrottle, AutoContinuationController, CHAT_LAST_TERMINAL_KEY, CHAT_MESSAGE_TYPES, CHAT_RECOVERING_FLAG_TTL_MS, CHAT_RECOVERING_KEY, CHAT_RECOVERY_ALARM_DEBOUNCE_MS, CHAT_RECOVERY_INCIDENT_KEY_PREFIX, CHAT_RECOVERY_INCIDENT_TTL_MS, CHAT_RECOVERY_PROGRESS_KEY, CHAT_RECOVERY_STABLE_RETRY_DELAY_SECONDS, CHAT_STREAM_PROGRESS_CREDIT_THROTTLE_MS, ChatRecoveryEngine, ChatStreamStalledError, ContinuationState, DEFAULT_CHAT_RECOVERY_MAX_ATTEMPTS, DEFAULT_CHAT_RECOVERY_MAX_OOM_RETRIES, DEFAULT_CHAT_RECOVERY_MAX_WORK, DEFAULT_CHAT_RECOVERY_NO_PROGRESS_TIMEOUT_MS, DEFAULT_CHAT_RECOVERY_STABLE_TIMEOUT_MS, DEFAULT_CHAT_RECOVERY_TERMINAL_MESSAGE, KV_DELETE_MAX_KEYS, MAX_BOUND_PARAMS, MessageType, PreStreamTurns, ROW_MAX_BYTES, ResumableStream, ResumeHandshake, STREAM_CLEANUP_DELAY_SECONDS, STREAM_RESUME_NONE_REASONS, StreamAccumulator, StreamProgressCreditThrottle, SubmitConcurrencyController, TIMED_OUT, TurnQueue, aiSdkRecoveryCodec, applyAgentToolEvent, applyChunkToParts, applyToolUpdate, awaitWithDeadline, transition as broadcastTransition, buildChatRecoveringFrame, buildInClauseStrings, bumpChatRecoveryProgress, byteLength, chatRecoverySchedulePolicy, classifyAgentToolChildRecovery, cleanupStreamBuffers, clearChatTerminal, clientResolvableToolNames, createAgentToolEventState, createChatFiberSnapshot, createToolsFromClientSchemas, crossMessageToolResultUpdate, drainInteractionApplies, enforceRowSizeLimit, hasIncompleteToolBatch, interceptAgentToolBroadcast, isReplayChunk, iterateWithStallWatchdog, listActiveChatRecoveryIncidents, normalizeToolInput, parseProtocolMessage, partAwaitsClientInteraction, pausedExecutionUpdate, pendingChatTerminal, persistReconstructedOrphan, readChatRecoveryProgress, reconcileMessages, reconcileOrphanPartial, recordChatTerminal, repairInterruptedToolParts, resolveChatRecoveryConfig, resolveToolMergeId, runChatRecoveryExhaustion, sanitizeMessage, sendIfOpen, setChatRecovering, shouldCreditStreamProgress, sweepStaleChatRecoveryIncidents, toolApprovalUpdate, toolPartHasSettledResult, toolResultUpdate, unwrapChatFiberSnapshot, wrapChatFiberSnapshot };
+export { AGENT_TOOL_STREAM_PROGRESS_BUMP_THROTTLE_MS, AbortRegistry, AgentToolProgressEmitter, AgentToolStreamProgressThrottle, AutoContinuationController, CHAT_LAST_TERMINAL_KEY, CHAT_MESSAGE_TYPES, CHAT_RECOVERING_FLAG_TTL_MS, CHAT_RECOVERING_KEY, CHAT_RECOVERY_ALARM_DEBOUNCE_MS, CHAT_RECOVERY_INCIDENT_KEY_PREFIX, CHAT_RECOVERY_INCIDENT_TTL_MS, CHAT_RECOVERY_PROGRESS_KEY, CHAT_RECOVERY_STABLE_RETRY_DELAY_SECONDS, CHAT_STREAM_PROGRESS_CREDIT_THROTTLE_MS, ChatRecoveryEngine, ChatStreamStalledError, ContinuationState, DEFAULT_CHAT_RECOVERY_MAX_ATTEMPTS, DEFAULT_CHAT_RECOVERY_MAX_OOM_RETRIES, DEFAULT_CHAT_RECOVERY_MAX_WORK, DEFAULT_CHAT_RECOVERY_NO_PROGRESS_TIMEOUT_MS, DEFAULT_CHAT_RECOVERY_STABLE_TIMEOUT_MS, DEFAULT_CHAT_RECOVERY_TERMINAL_MESSAGE, KV_DELETE_MAX_KEYS, MAX_BOUND_PARAMS, MessageType, PreStreamTurns, ROW_MAX_BYTES, ResumableStream, ResumeHandshake, STREAM_CLEANUP_DELAY_SECONDS, STREAM_RESUME_NONE_REASONS, StreamAccumulator, StreamProgressCreditThrottle, SubmitConcurrencyController, TIMED_OUT, TextSegmentJoiner, TurnQueue, aiSdkRecoveryCodec, applyAgentToolEvent, applyChunkToParts, applyToolUpdate, awaitWithDeadline, transition as broadcastTransition, buildChatRecoveringFrame, buildInClauseStrings, bumpChatRecoveryProgress, byteLength, chatRecoverySchedulePolicy, classifyAgentToolChildRecovery, cleanupStreamBuffers, clearChatTerminal, clientResolvableToolNames, createAgentToolEventState, createChatFiberSnapshot, createToolsFromClientSchemas, crossMessageToolResultUpdate, drainInteractionApplies, enforceRowSizeLimit, hasIncompleteToolBatch, interceptAgentToolBroadcast, isReplayChunk, iterateWithStallWatchdog, listActiveChatRecoveryIncidents, normalizeToolInput, parseProtocolMessage, partAwaitsClientInteraction, pausedExecutionUpdate, pendingChatTerminal, persistReconstructedOrphan, readChatRecoveryProgress, reconcileMessages, reconcileOrphanPartial, recordChatTerminal, repairInterruptedToolParts, resolveChatRecoveryConfig, resolveToolMergeId, runChatRecoveryExhaustion, sanitizeMessage, sendIfOpen, setChatRecovering, shouldCreditStreamProgress, sweepStaleChatRecoveryIncidents, toolApprovalUpdate, toolPartHasSettledResult, toolResultUpdate, unwrapChatFiberSnapshot, wrapChatFiberSnapshot };
 
 //# sourceMappingURL=index.js.map