agents 0.20.1 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +50 -12
  2. package/dist/{agent-tool-types-BC-WFlsz.d.ts → agent-tool-types-CzGGB-20.d.ts} +375 -72
  3. package/dist/agent-tool-types.d.ts +1 -1
  4. package/dist/{agent-tools-DeHe9Xov.d.ts → agent-tools-zR2d5uij.d.ts} +2 -2
  5. package/dist/agent-tools.d.ts +24 -8
  6. package/dist/agent-tools.js +14 -6
  7. package/dist/agent-tools.js.map +1 -1
  8. package/dist/browser/ai.d.ts +5 -3
  9. package/dist/browser/ai.js +86 -7
  10. package/dist/browser/ai.js.map +1 -1
  11. package/dist/browser/index.d.ts +1 -1
  12. package/dist/browser/index.js +1 -1
  13. package/dist/browser/tanstack-ai.js +13 -1
  14. package/dist/browser/tanstack-ai.js.map +1 -1
  15. package/dist/chat/index.d.ts +31 -2
  16. package/dist/chat/index.js +57 -2
  17. package/dist/chat/index.js.map +1 -1
  18. package/dist/chat/react.d.ts +5 -179
  19. package/dist/chat/react.js +18 -555
  20. package/dist/chat/react.js.map +1 -1
  21. package/dist/chat/transport.d.ts +10 -0
  22. package/dist/chat/transport.js +2 -0
  23. package/dist/chat-sdk/index.d.ts +1 -1
  24. package/dist/client.d.ts +1 -1
  25. package/dist/{connector-v2M1zlZp.d.ts → connector-CkQD4MK3.d.ts} +20 -3
  26. package/dist/{connector-KEJnl6e5.js → connector-CptFKzRh.js} +158 -40
  27. package/dist/connector-CptFKzRh.js.map +1 -0
  28. package/dist/index.d.ts +20 -12
  29. package/dist/index.js +5 -4
  30. package/dist/index.js.map +1 -1
  31. package/dist/mcp/client.d.ts +20 -20
  32. package/dist/mcp/index.d.ts +35 -35
  33. package/dist/observability/ai/index.d.ts +1 -130
  34. package/dist/observability/ai/index.js +39 -399
  35. package/dist/observability/ai/index.js.map +1 -1
  36. package/dist/{wire-types-CU9rLoeS.js → protocol-Dqc2MQxo.js} +2 -46
  37. package/dist/protocol-Dqc2MQxo.js.map +1 -0
  38. package/dist/react.d.ts +1 -1
  39. package/dist/react.js +5 -8
  40. package/dist/react.js.map +1 -1
  41. package/dist/serializable.d.ts +1 -1
  42. package/dist/sub-routing.d.ts +18 -6
  43. package/dist/sub-routing.js +92 -2
  44. package/dist/sub-routing.js.map +1 -1
  45. package/dist/wire-types-CnMt6_HR.js +47 -0
  46. package/dist/wire-types-CnMt6_HR.js.map +1 -0
  47. package/dist/workflow-types.d.ts +25 -25
  48. package/dist/workflow-types.js.map +1 -1
  49. package/dist/workflows.d.ts +22 -22
  50. package/dist/ws-chat-transport-CIoOBbO7.js +561 -0
  51. package/dist/ws-chat-transport-CIoOBbO7.js.map +1 -0
  52. package/dist/ws-chat-transport-UNRIS2xl.d.ts +184 -0
  53. package/docs/adding-to-existing-project.md +4 -2
  54. package/docs/agent-class.md +1 -1
  55. package/docs/agent-tools.md +29 -0
  56. package/docs/browse-the-web.md +16 -1
  57. package/docs/chat-agents.md +3 -1
  58. package/docs/client-sdk.md +12 -8
  59. package/docs/configuration.md +7 -1
  60. package/docs/cross-domain-authentication.md +7 -35
  61. package/docs/email.md +2 -13
  62. package/docs/human-in-the-loop.md +15 -12
  63. package/docs/long-running-agents.md +11 -11
  64. package/docs/mcp-servers.md +6 -0
  65. package/docs/mcp-transports.md +18 -12
  66. package/docs/migration-to-ai-sdk-v5.md +2 -2
  67. package/docs/migration-to-ai-sdk-v6.md +5 -1
  68. package/docs/observability.md +22 -66
  69. package/docs/routing.md +27 -0
  70. package/docs/sub-agents.md +47 -2
  71. package/docs/webhooks.md +109 -136
  72. package/docs/workflows.md +9 -1
  73. package/package.json +13 -4
  74. package/dist/connector-KEJnl6e5.js.map +0 -1
  75. package/dist/wire-types-CU9rLoeS.js.map +0 -1
  76. package/dist/workflow-types-Baz_PO5v.d.ts +0 -280
@@ -1,7 +1,10 @@
1
+ import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, r as _assertClassBrand, t as _classPrivateFieldGet2 } from "../classPrivateFieldGet2-DZBYAB34.js";
1
2
  import { i as normalizeToolInput, n as getPartialStreamText, r as isReplayChunk, t as applyChunkToParts } from "../message-builder-BymO4N_D.js";
2
3
  import { i as interceptAgentToolBroadcast, n as applyAgentToolEvent, r as createAgentToolEventState, t as AgentToolProgressEmitter } from "../agent-tools-y7zLfw4Q.js";
4
+ import { t as _classPrivateMethodInitSpec } from "../classPrivateMethodInitSpec-qMjJ6sHQ.js";
3
5
  import { t as truncateToolOutput } from "../tool-output-truncation-CNnnGZQ3.js";
4
- 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";
6
+ import { i as StreamAccumulator, n as STREAM_RESUME_NONE_REASONS, r as transition, t as CHAT_MESSAGE_TYPES } from "../protocol-Dqc2MQxo.js";
7
+ import { t as MessageType } from "../wire-types-CnMt6_HR.js";
5
8
  import { jsonSchema, tool } from "ai";
6
9
  import { nanoid } from "nanoid";
7
10
  //#region src/chat/sanitize.ts
@@ -215,6 +218,58 @@ var TurnQueue = class {
215
218
  }
216
219
  };
217
220
  //#endregion
221
+ //#region src/chat/text-segment-joiner.ts
222
+ var _hasText = /* @__PURE__ */ new WeakMap();
223
+ var _lastTextEndedWithWhitespace = /* @__PURE__ */ new WeakMap();
224
+ var _needsBoundarySpace = /* @__PURE__ */ new WeakMap();
225
+ var _TextSegmentJoiner_brand = /* @__PURE__ */ new WeakSet();
226
+ /**
227
+ * @internal Converts structured stream chunks into text and boundary events
228
+ * without gluing words across non-text chunks. Sibling-package support for
229
+ * `@cloudflare/voice` and `@cloudflare/think`, not a public API.
230
+ */
231
+ var TextSegmentJoiner = class {
232
+ constructor() {
233
+ _classPrivateMethodInitSpec(this, _TextSegmentJoiner_brand);
234
+ _classPrivateFieldInitSpec(this, _hasText, false);
235
+ _classPrivateFieldInitSpec(this, _lastTextEndedWithWhitespace, false);
236
+ _classPrivateFieldInitSpec(this, _needsBoundarySpace, false);
237
+ }
238
+ pushChunk(chunk) {
239
+ if (chunk.type === "text-delta") {
240
+ const text = textFromChunk(chunk);
241
+ return text ? _assertClassBrand(_TextSegmentJoiner_brand, this, _pushText).call(this, text) : [];
242
+ }
243
+ if (typeof chunk.type !== "string" || !_assertClassBrand(_TextSegmentJoiner_brand, this, _markBoundary).call(this)) return [];
244
+ return [{ type: "boundary" }];
245
+ }
246
+ };
247
+ function _markBoundary() {
248
+ if (!_classPrivateFieldGet2(_hasText, this) || _classPrivateFieldGet2(_needsBoundarySpace, this)) return false;
249
+ _classPrivateFieldSet2(_needsBoundarySpace, this, true);
250
+ return true;
251
+ }
252
+ function _pushText(text) {
253
+ const events = [];
254
+ if (_classPrivateFieldGet2(_needsBoundarySpace, this) && !_classPrivateFieldGet2(_lastTextEndedWithWhitespace, this) && !/^\s/.test(text)) events.push({
255
+ type: "text",
256
+ text: " "
257
+ });
258
+ events.push({
259
+ type: "text",
260
+ text
261
+ });
262
+ _classPrivateFieldSet2(_hasText, this, true);
263
+ _classPrivateFieldSet2(_lastTextEndedWithWhitespace, this, /\s$/.test(text));
264
+ _classPrivateFieldSet2(_needsBoundarySpace, this, false);
265
+ return events;
266
+ }
267
+ function textFromChunk(chunk) {
268
+ if (typeof chunk.text === "string") return chunk.text;
269
+ if (typeof chunk.delta === "string") return chunk.delta;
270
+ return null;
271
+ }
272
+ //#endregion
218
273
  //#region src/chat/submit-concurrency.ts
219
274
  var SubmitConcurrencyController = class {
220
275
  constructor(options) {
@@ -3393,6 +3448,6 @@ async function* iterateWithStallWatchdog(source, timeoutMs, onStall) {
3393
3448
  }
3394
3449
  }
3395
3450
  //#endregion
3396
- 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 };
3451
+ 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 };
3397
3452
 
3398
3453
  //# sourceMappingURL=index.js.map