agents 0.20.1 → 0.22.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 (169) hide show
  1. package/README.md +51 -12
  2. package/dist/{agent-tool-types-BC-WFlsz.d.ts → agent-routing-CnkaHb-v.d.ts} +3305 -3138
  3. package/dist/agent-routing.d.ts +14 -0
  4. package/dist/agent-routing.js +187 -0
  5. package/dist/agent-routing.js.map +1 -0
  6. package/dist/agent-tool-types.d.ts +26 -26
  7. package/dist/{agent-tools-DeHe9Xov.d.ts → agent-tools-C0XJqWzB.d.ts} +7 -7
  8. package/dist/agent-tools.d.ts +44 -28
  9. package/dist/agent-tools.js +16 -7
  10. package/dist/agent-tools.js.map +1 -1
  11. package/dist/browser/ai.d.ts +5 -3
  12. package/dist/browser/ai.js +88 -8
  13. package/dist/browser/ai.js.map +1 -1
  14. package/dist/browser/index.d.ts +1 -1
  15. package/dist/browser/index.js +1 -1
  16. package/dist/browser/tanstack-ai.js +13 -1
  17. package/dist/browser/tanstack-ai.js.map +1 -1
  18. package/dist/capability-BjSKYpzg.js +42 -0
  19. package/dist/capability-BjSKYpzg.js.map +1 -0
  20. package/dist/capability-runner-CvHGZqUu.d.ts +150 -0
  21. package/dist/chat/index.d.ts +51 -15
  22. package/dist/chat/index.js +59 -4
  23. package/dist/chat/index.js.map +1 -1
  24. package/dist/chat/react.d.ts +19 -180
  25. package/dist/chat/react.js +93 -600
  26. package/dist/chat/react.js.map +1 -1
  27. package/dist/chat/transport.d.ts +10 -0
  28. package/dist/chat/transport.js +2 -0
  29. package/dist/chat-sdk/index.d.ts +4 -4
  30. package/dist/chat-sdk/index.js +1 -1
  31. package/dist/{client-zqKcsyFa.js → client-jagG8a9_.js} +129 -37
  32. package/dist/client-jagG8a9_.js.map +1 -0
  33. package/dist/client.d.ts +1 -1
  34. package/dist/client.js +1 -1
  35. package/dist/{cloudflare-BduZwmYK.js → cloudflare-Dzvc7V2N.js} +10 -3
  36. package/dist/{cloudflare-BduZwmYK.js.map → cloudflare-Dzvc7V2N.js.map} +1 -1
  37. package/dist/{connector-v2M1zlZp.d.ts → connector-CkQD4MK3.d.ts} +20 -3
  38. package/dist/{connector-KEJnl6e5.js → connector-CptFKzRh.js} +158 -40
  39. package/dist/connector-CptFKzRh.js.map +1 -0
  40. package/dist/current-agent-CuMErtly.d.ts +283 -0
  41. package/dist/current-agent-DhoDkSnH.js +51 -0
  42. package/dist/current-agent-DhoDkSnH.js.map +1 -0
  43. package/dist/diagnostics-CaBjfz4J.js +41 -0
  44. package/dist/diagnostics-CaBjfz4J.js.map +1 -0
  45. package/dist/{do-oauth-client-provider-VTZj2VtM.d.ts → do-oauth-client-provider-Tmf1vgKz.d.ts} +2 -2
  46. package/dist/durable-object-lifecycle-D6nNQJJd.js +862 -0
  47. package/dist/durable-object-lifecycle-D6nNQJJd.js.map +1 -0
  48. package/dist/{email-CL27preh.d.ts → email-7TatiTnl.d.ts} +38 -9
  49. package/dist/email-send.d.ts +15 -0
  50. package/dist/email-send.js +32 -0
  51. package/dist/email-send.js.map +1 -0
  52. package/dist/email.d.ts +14 -10
  53. package/dist/email.js.map +1 -1
  54. package/dist/experimental/memory/session/index.d.ts +3 -2
  55. package/dist/experimental/memory/session/index.js +15 -10
  56. package/dist/experimental/memory/session/index.js.map +1 -1
  57. package/dist/{handler-stateless-C_bo-Ytq.d.ts → handler-stateless-DxYpJ_XF.d.ts} +3 -3
  58. package/dist/{handler-stateless-CIkKPETH.js → handler-stateless-VvrWSAVA.js} +5 -5
  59. package/dist/handler-stateless-VvrWSAVA.js.map +1 -0
  60. package/dist/{index-BRnybD6X.d.ts → index-DcSAZKsB.d.ts} +19 -31
  61. package/dist/index.d.ts +102 -91
  62. package/dist/index.js +12 -7235
  63. package/dist/internal_context-BlxFEWfn.d.ts +19 -0
  64. package/dist/internal_context.d.ts +10 -4
  65. package/dist/internal_context.js +1 -10
  66. package/dist/{client-invoker-BNSZxAkv.d.ts → invoker-CG0_p_Wq.d.ts} +2 -2
  67. package/dist/{client-invoker-VNZ7X0nn.js → invoker-CHMnoxIA.js} +2 -2
  68. package/dist/invoker-CHMnoxIA.js.map +1 -0
  69. package/dist/lifecycle/index.d.ts +48 -0
  70. package/dist/lifecycle/index.js +4 -0
  71. package/dist/mcp/{do-oauth-client-provider.d.ts → client/do-oauth-client-provider.d.ts} +1 -1
  72. package/dist/mcp/{do-oauth-client-provider.js → client/do-oauth-client-provider.js} +1 -1
  73. package/dist/mcp/client/do-oauth-client-provider.js.map +1 -0
  74. package/dist/mcp/client/index.d.ts +42 -0
  75. package/dist/mcp/{client.js → client/index.js} +1 -1
  76. package/dist/mcp/{x402.d.ts → client/x402.d.ts} +2 -2
  77. package/dist/mcp/{x402.js → client/x402.js} +2 -2
  78. package/dist/mcp/client/x402.js.map +1 -0
  79. package/dist/mcp/index.d.ts +36 -36
  80. package/dist/mcp/index.js +14 -16
  81. package/dist/mcp/index.js.map +1 -1
  82. package/dist/mcp/{server.d.ts → server/index.d.ts} +1 -1
  83. package/dist/mcp/{server.js → server/index.js} +1 -1
  84. package/dist/observability/ai/index.d.ts +1 -130
  85. package/dist/observability/ai/index.js +88 -433
  86. package/dist/observability/ai/index.js.map +1 -1
  87. package/dist/observability/index.d.ts +4 -4
  88. package/dist/observability/index.js +3 -50
  89. package/dist/observability/index.js.map +1 -1
  90. package/dist/{wire-types-CU9rLoeS.js → protocol-B0nh6KNf.js} +20 -66
  91. package/dist/protocol-B0nh6KNf.js.map +1 -0
  92. package/dist/react.d.ts +4 -4
  93. package/dist/react.js +6 -9
  94. package/dist/react.js.map +1 -1
  95. package/dist/schedule.d.ts +25 -94
  96. package/dist/schedule.js +1 -98
  97. package/dist/schedule.js.map +1 -1
  98. package/dist/scheduler-CR9RHGos.js +857 -0
  99. package/dist/scheduler-CR9RHGos.js.map +1 -0
  100. package/dist/scheduler-DQoTGoAW.d.ts +224 -0
  101. package/dist/schedules/index.d.ts +22 -0
  102. package/dist/schedules/index.js +2 -0
  103. package/dist/schedules/parser.d.ts +79 -0
  104. package/dist/schedules/parser.js +103 -0
  105. package/dist/schedules/parser.js.map +1 -0
  106. package/dist/serializable.d.ts +1 -1
  107. package/dist/sql-error-CPY-GXyI.d.ts +12 -0
  108. package/dist/sql-error.d.ts +2 -0
  109. package/dist/sql-error.js +16 -0
  110. package/dist/sql-error.js.map +1 -0
  111. package/dist/src-5W6JNKVb.js +6613 -0
  112. package/dist/src-5W6JNKVb.js.map +1 -0
  113. package/dist/sub-routing.d.ts +18 -6
  114. package/dist/sub-routing.js +92 -2
  115. package/dist/sub-routing.js.map +1 -1
  116. package/dist/wire-types-CnMt6_HR.js +47 -0
  117. package/dist/wire-types-CnMt6_HR.js.map +1 -0
  118. package/dist/workflow-types.d.ts +25 -25
  119. package/dist/workflow-types.js.map +1 -1
  120. package/dist/workflows.d.ts +22 -22
  121. package/dist/workflows.js +2 -1
  122. package/dist/workflows.js.map +1 -1
  123. package/dist/ws-chat-transport-UNRIS2xl.d.ts +184 -0
  124. package/dist/ws-chat-transport-rWwta645.js +698 -0
  125. package/dist/ws-chat-transport-rWwta645.js.map +1 -0
  126. package/docs/adding-to-existing-project.md +4 -2
  127. package/docs/agent-class.md +29 -87
  128. package/docs/agent-tools.md +29 -0
  129. package/docs/browse-the-web.md +16 -1
  130. package/docs/chat-agents.md +16 -13
  131. package/docs/client-sdk.md +12 -8
  132. package/docs/configuration.md +7 -1
  133. package/docs/cross-domain-authentication.md +7 -35
  134. package/docs/durable-execution.md +1 -1
  135. package/docs/email.md +2 -13
  136. package/docs/http-websockets.md +1 -11
  137. package/docs/human-in-the-loop.md +16 -13
  138. package/docs/index.md +1 -0
  139. package/docs/lifecycle.md +323 -0
  140. package/docs/long-running-agents.md +13 -15
  141. package/docs/mcp-client.md +55 -0
  142. package/docs/mcp-servers.md +6 -0
  143. package/docs/mcp-transports.md +18 -12
  144. package/docs/migration-to-ai-sdk-v5.md +2 -2
  145. package/docs/migration-to-ai-sdk-v6.md +5 -1
  146. package/docs/observability.md +33 -77
  147. package/docs/resumable-streaming.md +1 -1
  148. package/docs/routing.md +27 -0
  149. package/docs/scheduling.md +175 -15
  150. package/docs/server-driven-messages.md +1 -1
  151. package/docs/sub-agents.md +47 -2
  152. package/docs/webhooks.md +109 -136
  153. package/docs/workflows.md +9 -1
  154. package/package.json +41 -23
  155. package/dist/cli/index.d.ts +0 -1
  156. package/dist/cli/index.js +0 -26
  157. package/dist/cli/index.js.map +0 -1
  158. package/dist/client-invoker-VNZ7X0nn.js.map +0 -1
  159. package/dist/client-zqKcsyFa.js.map +0 -1
  160. package/dist/connector-KEJnl6e5.js.map +0 -1
  161. package/dist/handler-stateless-CIkKPETH.js.map +0 -1
  162. package/dist/index.js.map +0 -1
  163. package/dist/internal_context-Dg4Cgjcu.d.ts +0 -37
  164. package/dist/internal_context.js.map +0 -1
  165. package/dist/mcp/client.d.ts +0 -42
  166. package/dist/mcp/do-oauth-client-provider.js.map +0 -1
  167. package/dist/mcp/x402.js.map +0 -1
  168. package/dist/wire-types-CU9rLoeS.js.map +0 -1
  169. package/dist/workflow-types-Baz_PO5v.d.ts +0 -280
@@ -5,7 +5,7 @@ import {
5
5
  o as getMcpAuthContext,
6
6
  r as StatelessMcpServerInput,
7
7
  t as CreateStatelessMcpHandlerOptions
8
- } from "../handler-stateless-C_bo-Ytq.js";
8
+ } from "../../handler-stateless-DxYpJ_XF.js";
9
9
  export {
10
10
  type CreateStatelessMcpHandlerOptions as CreateMcpHandlerOptions,
11
11
  type CreateStatelessMcpHandlerOptions,
@@ -1,2 +1,2 @@
1
- import { n as getMcpAuthContext, t as createStatelessMcpHandler } from "../handler-stateless-CIkKPETH.js";
1
+ import { n as getMcpAuthContext, t as createStatelessMcpHandler } from "../../handler-stateless-VvrWSAVA.js";
2
2
  export { createStatelessMcpHandler as createMcpHandler, getMcpAuthContext };
@@ -4,7 +4,7 @@ type AISDKStorageOptions = {
4
4
  readonly storeMessages?: boolean;
5
5
  readonly storeTools?: boolean;
6
6
  };
7
- /** Instrumentation options for the AI SDK v6 adapter. */
7
+ /** Instrumentation options for the AI SDK v6 and v7 wrapper. */
8
8
  type AISDKInstrumentationOptions = AISDKStorageOptions & {
9
9
  /**
10
10
  * Context keys to emit as `cloudflare.agents.runtime_context.{key}`, set
@@ -17,127 +17,6 @@ type AISDKInstrumentationOptions = AISDKStorageOptions & {
17
17
  readonly includeRuntimeContext?: readonly string[];
18
18
  };
19
19
  //#endregion
20
- //#region src/observability/ai/v7/types.d.ts
21
- /** Common AI SDK v7 telemetry callback options this adapter reads. */
22
- type AISDKV7TelemetryOptions = {
23
- readonly functionId?: string | undefined;
24
- };
25
- /** AI SDK v7 operation lifecycle event shape consumed by this adapter. */
26
- type AISDKV7OperationEvent = AISDKV7TelemetryOptions & {
27
- readonly callId: string;
28
- readonly finishReason?: unknown;
29
- readonly frequencyPenalty?: unknown;
30
- readonly maxOutputTokens?: unknown;
31
- readonly maxTokens?: unknown;
32
- readonly messages?: unknown;
33
- readonly modelId?: string | undefined;
34
- readonly object?: unknown;
35
- readonly operationId?: string | undefined;
36
- readonly presencePenalty?: unknown;
37
- readonly prompt?: unknown;
38
- readonly provider?: string | undefined;
39
- readonly response?: unknown;
40
- readonly responseId?: unknown;
41
- readonly responseModel?: unknown;
42
- readonly runtimeContext?: unknown;
43
- readonly seed?: unknown;
44
- readonly temperature?: unknown;
45
- readonly text?: unknown;
46
- readonly toolCalls?: unknown;
47
- readonly toolsContext?: unknown;
48
- readonly topK?: unknown;
49
- readonly topP?: unknown;
50
- readonly totalUsage?: unknown;
51
- readonly usage?: unknown;
52
- };
53
- /** AI SDK v7 language-model lifecycle event shape consumed by this adapter. */
54
- type AISDKV7LanguageModelCallEvent = AISDKV7TelemetryOptions & {
55
- readonly callId: string;
56
- readonly content?: unknown;
57
- readonly finishReason?: unknown;
58
- readonly frequencyPenalty?: unknown;
59
- readonly headers?: unknown;
60
- readonly maxOutputTokens?: unknown;
61
- readonly maxTokens?: unknown;
62
- readonly messages?: unknown;
63
- readonly modelId?: string | undefined;
64
- readonly performance?: unknown;
65
- readonly presencePenalty?: unknown;
66
- readonly prompt?: unknown;
67
- readonly provider?: string | undefined;
68
- readonly providerMetadata?: unknown;
69
- readonly response?: unknown;
70
- readonly responseHeaders?: unknown;
71
- readonly responseId?: unknown;
72
- readonly responseModel?: unknown;
73
- readonly seed?: unknown;
74
- readonly temperature?: unknown;
75
- readonly topK?: unknown;
76
- readonly topP?: unknown;
77
- readonly totalUsage?: unknown;
78
- readonly usage?: unknown;
79
- };
80
- /** AI SDK v7 tool-call identity shape consumed by this adapter. */
81
- type AISDKV7ToolCall = {
82
- readonly input?: unknown;
83
- readonly toolCallId?: string | undefined;
84
- readonly toolName?: string | undefined;
85
- };
86
- /** AI SDK v7 tool-output event shape consumed by this adapter. */
87
- type AISDKV7ToolOutput = {
88
- readonly error?: unknown;
89
- readonly output?: unknown;
90
- readonly type?: string | undefined;
91
- };
92
- /** AI SDK v7 tool lifecycle event shape consumed by this adapter. */
93
- type AISDKV7ToolExecutionEvent = AISDKV7TelemetryOptions & {
94
- readonly callId: string;
95
- readonly toolCall: AISDKV7ToolCall;
96
- readonly toolContext?: unknown;
97
- readonly toolOutput?: AISDKV7ToolOutput | undefined;
98
- };
99
- /** AI SDK v7 abort event shape consumed by this adapter. */
100
- type AISDKV7AbortEvent = {
101
- readonly callId: string;
102
- readonly reason?: unknown;
103
- };
104
- /** AI SDK v7 model-call execution hook shape consumed by this adapter. */
105
- type AISDKV7ExecuteLanguageModelOptions<T> = {
106
- readonly callId: string;
107
- readonly execute: () => PromiseLike<T>;
108
- };
109
- /** AI SDK v7 tool execution hook shape consumed by this adapter. */
110
- type AISDKV7ExecuteToolOptions<T> = {
111
- readonly callId: string;
112
- readonly execute: () => PromiseLike<T>;
113
- readonly toolCallId: string;
114
- };
115
- /** Structural AI SDK v7 telemetry object returned by this package. */
116
- type AISDKV7Telemetry = {
117
- readonly executeLanguageModelCall?: <T>(
118
- options: AISDKV7ExecuteLanguageModelOptions<T>
119
- ) => PromiseLike<T>;
120
- readonly executeTool?: <T>(
121
- options: AISDKV7ExecuteToolOptions<T>
122
- ) => PromiseLike<T>;
123
- readonly onAbort?: (event: AISDKV7AbortEvent) => void | PromiseLike<void>;
124
- readonly onEnd?: (event: AISDKV7OperationEvent) => void | PromiseLike<void>;
125
- readonly onError?: (event: unknown) => void | PromiseLike<void>;
126
- readonly onLanguageModelCallEnd?: (
127
- event: AISDKV7LanguageModelCallEvent
128
- ) => void | PromiseLike<void>;
129
- readonly onLanguageModelCallStart?: (
130
- event: AISDKV7LanguageModelCallEvent
131
- ) => void | PromiseLike<void>;
132
- readonly onStart?: (event: AISDKV7OperationEvent) => void | PromiseLike<void>;
133
- readonly onToolExecutionEnd?: (
134
- event: AISDKV7ToolExecutionEvent
135
- ) => void | PromiseLike<void>;
136
- readonly onToolExecutionStart?: (
137
- event: AISDKV7ToolExecutionEvent
138
- ) => void | PromiseLike<void>;
139
- };
140
- //#endregion
141
20
  //#region src/observability/ai/index.d.ts
142
21
  /**
143
22
  * Wraps an AI SDK namespace with tracing.
@@ -146,18 +25,10 @@ declare function wrapAISDK<T extends Record<string, unknown>>(
146
25
  ai: T,
147
26
  options?: AISDKInstrumentationOptions
148
27
  ): T;
149
- /**
150
- * Creates an AI SDK v7 telemetry adapter for use with `registerTelemetry` or
151
- * per-call telemetry configuration.
152
- */
153
- declare function createAISDKTelemetry(
154
- options?: AISDKStorageOptions
155
- ): AISDKV7Telemetry;
156
28
  //#endregion
157
29
  export {
158
30
  type AISDKInstrumentationOptions,
159
31
  type AISDKStorageOptions,
160
- createAISDKTelemetry,
161
32
  wrapAISDK
162
33
  };
163
34
  //# sourceMappingURL=index.d.ts.map