agents 0.20.0 → 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 (87) hide show
  1. package/README.md +50 -12
  2. package/dist/{agent-tool-types-Btk9ETS-.d.ts → agent-tool-types-CzGGB-20.d.ts} +403 -115
  3. package/dist/agent-tool-types.d.ts +1 -1
  4. package/dist/{agent-tools-UuScsJg3.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/cloudflare-BduZwmYK.js +204 -0
  26. package/dist/cloudflare-BduZwmYK.js.map +1 -0
  27. package/dist/{connector-v2M1zlZp.d.ts → connector-CkQD4MK3.d.ts} +20 -3
  28. package/dist/{connector-KEJnl6e5.js → connector-CptFKzRh.js} +158 -40
  29. package/dist/connector-CptFKzRh.js.map +1 -0
  30. package/dist/{handler-stateless-8hQN_kC3.js → handler-stateless-CIkKPETH.js} +20 -69
  31. package/dist/handler-stateless-CIkKPETH.js.map +1 -0
  32. package/dist/index.d.ts +21 -11
  33. package/dist/index.js +31 -21
  34. package/dist/index.js.map +1 -1
  35. package/dist/mcp/client.d.ts +20 -20
  36. package/dist/mcp/index.d.ts +35 -35
  37. package/dist/mcp/index.js +32 -98
  38. package/dist/mcp/index.js.map +1 -1
  39. package/dist/mcp/server.js +1 -1
  40. package/dist/observability/ai/index.d.ts +10 -131
  41. package/dist/observability/ai/index.js +209 -444
  42. package/dist/observability/ai/index.js.map +1 -1
  43. package/dist/{wire-types-CU9rLoeS.js → protocol-Dqc2MQxo.js} +2 -46
  44. package/dist/protocol-Dqc2MQxo.js.map +1 -0
  45. package/dist/react.d.ts +1 -1
  46. package/dist/react.js +5 -8
  47. package/dist/react.js.map +1 -1
  48. package/dist/serializable.d.ts +1 -1
  49. package/dist/sub-routing.d.ts +18 -6
  50. package/dist/sub-routing.js +92 -2
  51. package/dist/sub-routing.js.map +1 -1
  52. package/dist/wire-types-CnMt6_HR.js +47 -0
  53. package/dist/wire-types-CnMt6_HR.js.map +1 -0
  54. package/dist/workflow-types.d.ts +25 -25
  55. package/dist/workflow-types.js.map +1 -1
  56. package/dist/workflows.d.ts +22 -22
  57. package/dist/ws-chat-transport-CIoOBbO7.js +561 -0
  58. package/dist/ws-chat-transport-CIoOBbO7.js.map +1 -0
  59. package/dist/ws-chat-transport-UNRIS2xl.d.ts +184 -0
  60. package/docs/adding-to-existing-project.md +4 -2
  61. package/docs/agent-class.md +1 -1
  62. package/docs/agent-tools.md +29 -0
  63. package/docs/browse-the-web.md +16 -1
  64. package/docs/chat-agents.md +3 -1
  65. package/docs/client-sdk.md +12 -8
  66. package/docs/configuration.md +7 -1
  67. package/docs/cross-domain-authentication.md +7 -35
  68. package/docs/email.md +2 -13
  69. package/docs/human-in-the-loop.md +15 -12
  70. package/docs/long-running-agents.md +11 -11
  71. package/docs/mcp-client.md +1 -1
  72. package/docs/mcp-servers.md +7 -1
  73. package/docs/mcp-transports.md +18 -12
  74. package/docs/migration-to-ai-sdk-v5.md +2 -2
  75. package/docs/migration-to-ai-sdk-v6.md +5 -1
  76. package/docs/observability.md +24 -67
  77. package/docs/routing.md +27 -0
  78. package/docs/sub-agents.md +47 -2
  79. package/docs/webhooks.md +109 -136
  80. package/docs/workflows.md +9 -1
  81. package/package.json +19 -10
  82. package/dist/cloudflare-BldFV0Pa.js +0 -117
  83. package/dist/cloudflare-BldFV0Pa.js.map +0 -1
  84. package/dist/connector-KEJnl6e5.js.map +0 -1
  85. package/dist/handler-stateless-8hQN_kC3.js.map +0 -1
  86. package/dist/wire-types-CU9rLoeS.js.map +0 -1
  87. package/dist/workflow-types-Baz_PO5v.d.ts +0 -280
@@ -18,17 +18,14 @@ import {
18
18
  u as McpClientOptions
19
19
  } from "./handler-stateless-C_bo-Ytq.js";
20
20
  import { n as LegacyCallToolResultSchema } from "./client-invoker-BNSZxAkv.js";
21
- import {
22
- _ as WorkflowEventPayload,
23
- d as WorkflowCallback,
24
- l as RunWorkflowOptions,
25
- v as WorkflowInfo,
26
- x as WorkflowQueryCriteria,
27
- y as WorkflowPage
28
- } from "./workflow-types-Baz_PO5v.js";
29
21
  import { t as MessageType } from "./types-6Zo2zfoO.js";
30
22
  import { r as EmailResolver } from "./email-CL27preh.js";
31
- import { RpcTarget } from "cloudflare:workers";
23
+ import {
24
+ RpcTarget,
25
+ WorkflowEvent,
26
+ WorkflowSleepDuration,
27
+ WorkflowStep
28
+ } from "cloudflare:workers";
32
29
  import {
33
30
  Connection,
34
31
  Connection as Connection$1,
@@ -100,6 +97,33 @@ import {
100
97
  } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
101
98
  import { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
102
99
 
100
+ //#region src/observability/tracing/tracer.d.ts
101
+ type InvocationScopeOptions = {
102
+ /**
103
+ * Open a scope even inside a live one, for work deliberately detached from
104
+ * the handler that started it — `ctx.waitUntil` bodies, queue drains — which
105
+ * runs on past that handler and must not be cut off with it.
106
+ */
107
+ readonly detached?: boolean;
108
+ };
109
+ /**
110
+ * Runs `body` as one traced invocation.
111
+ *
112
+ * Work that escapes its native invocation cannot be traced from the context it
113
+ * started in: the still-open span is force-closed against the invocation that
114
+ * owned that context, which reports a negative duration or `span_not_ended`.
115
+ * Spans opened with {@link SpanLifetime.boundToInvocation} inside this scope
116
+ * are therefore closed before `body` settles — but not one moment earlier, so
117
+ * everything that completes during the invocation (the normal case: a chat
118
+ * turn is awaited by the handler that received it) still records its finish
119
+ * attributes. A span truncated this way is marked
120
+ * `cloudflare.agents.span.truncated` rather than passing as complete.
121
+ */
122
+ declare function withInvocationScope<T>(
123
+ body: () => T,
124
+ options?: InvocationScopeOptions
125
+ ): T;
126
+ //#endregion
103
127
  //#region src/sub-routing.d.ts
104
128
  /**
105
129
  * URL segment marking a parent↔child boundary.
@@ -109,6 +133,47 @@ import { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
109
133
  * token everywhere (parent fetch, client, helpers).
110
134
  */
111
135
  declare const SUB_PREFIX = "sub";
136
+ /** One agent identity in a root-first address chain. */
137
+ interface AgentPathStep {
138
+ /** Agent class name as exported by the Worker. */
139
+ className: string;
140
+ /** Logical Agent instance name. */
141
+ name: string;
142
+ }
143
+ interface BuildAgentPathOptions {
144
+ /** Top-level route prefix. Must match `routeAgentRequest`; defaults to `agents`. */
145
+ prefix?: string;
146
+ /** Pathname suffix appended after the destination Agent identity. */
147
+ leafPath?: string;
148
+ /** Root Durable Object binding name, when it differs from the root class name. */
149
+ rootBinding?: string;
150
+ }
151
+ /** @internal Build the strictly validated path tail for sub-agent routing. */
152
+ declare function buildSubAgentPath(
153
+ path: ReadonlyArray<AgentPathStep>,
154
+ leafPath?: string
155
+ ): string;
156
+ /** @internal Preserve React's tolerant path composition for disabled placeholders. */
157
+ declare function buildSubAgentPathUnchecked(
158
+ path: ReadonlyArray<AgentPathStep>,
159
+ leafPath?: string
160
+ ): string;
161
+ /**
162
+ * Build the canonical pathname for a root Agent or nested sub-agent.
163
+ *
164
+ * The address is root-first and accepts `Agent#selfPath`. Pass
165
+ * `rootBinding` when the root Durable Object binding and class names differ.
166
+ */
167
+ declare function buildAgentPath(
168
+ path: ReadonlyArray<AgentPathStep>,
169
+ options?: BuildAgentPathOptions
170
+ ): string;
171
+ /** Build an absolute URL for a root Agent or nested sub-agent. */
172
+ declare function buildAgentUrl(
173
+ origin: string | URL,
174
+ path: ReadonlyArray<AgentPathStep>,
175
+ options?: BuildAgentPathOptions
176
+ ): URL;
112
177
  interface SubAgentPathMatch {
113
178
  /** CamelCase class name of the child, as it appears in `ctx.exports`. */
114
179
  childClass: string;
@@ -281,19 +346,6 @@ declare class WorkerTransport extends WebStandardStreamableHTTPServerTransport$1
281
346
  private _capturedInitializeParams?;
282
347
  private _userOnSessionInitialized?;
283
348
  private _bridgeInstalled;
284
- /**
285
- * Tracks keepalive interval cleanups so we can fire them eagerly when the
286
- * SDK closes the underlying SSE stream via `closeSSEStream(requestId)` or
287
- * `closeStandaloneSSEStream()`. Keyed by the JSON-RPC request id that
288
- * triggered the stream, or the sentinel for the standalone GET stream.
289
- */
290
- private readonly _keepaliveCleanups;
291
- /**
292
- * Most recent JSON-RPC request id seen on an incoming POST. Used to key
293
- * keepalive cleanups when the response is an SSE stream tied to that
294
- * request (so `closeSSEStream(id)` can find and clear the interval).
295
- */
296
- private _pendingRequestId?;
297
349
  /**
298
350
  * Request ids whose SSE stream was deliberately torn down via
299
351
  * `closeSSEStream`. The SDK's `send()` throws "No connection established"
@@ -314,8 +366,7 @@ declare class WorkerTransport extends WebStandardStreamableHTTPServerTransport$1
314
366
  /**
315
367
  * Top-level request entry point. Handles CORS preflight, restores any
316
368
  * persisted state on first invocation, then delegates to the SDK transport
317
- * and finally appends CORS headers + keepalive to whatever response comes
318
- * back.
369
+ * and finally appends CORS headers to whatever response comes back.
319
370
  */
320
371
  handleRequest(
321
372
  request: Request,
@@ -331,7 +382,6 @@ declare class WorkerTransport extends WebStandardStreamableHTTPServerTransport$1
331
382
  */
332
383
  private normalizeAllowHeader;
333
384
  closeSSEStream(requestId: RequestId): void;
334
- closeStandaloneSSEStream(): void;
335
385
  close(): Promise<void>;
336
386
  /**
337
387
  * Swallow two classes of message that would otherwise surface as
@@ -356,34 +406,6 @@ declare class WorkerTransport extends WebStandardStreamableHTTPServerTransport$1
356
406
  message: JSONRPCMessage$1,
357
407
  options?: TransportSendOptions$1
358
408
  ): Promise<void>;
359
- /**
360
- * If the response is an SSE stream, tee the body through a TransformStream
361
- * that injects a `: keepalive\n\n` comment frame every 25s. The interval
362
- * is cleared when the wrapped stream closes — which happens both when the
363
- * SDK ends the underlying stream naturally and when `closeSSEStream` is
364
- * called.
365
- *
366
- * Keepalive policy:
367
- * - POST response streams (`key` is a request id): always keepalive.
368
- * In-progress tool calls have no recovery path — if the stream drops
369
- * mid-execution the result is lost — so we keep it under the
370
- * Cloudflare edge ~5min idle watchdog.
371
- * - Standalone GET stream (`key === "_standalone"`): keepalive only
372
- * when no `eventStore` is configured. When resumability is enabled,
373
- * clients reconnect with `Last-Event-ID` after an idle drop, so we
374
- * skip the keepalive and let the DO hibernate.
375
- *
376
- * Uses the shared `sse-keepalive` constants so both this wrapper and
377
- * `McpAgent.serve()` write identical frames at the same cadence.
378
- * See cloudflare/agents#1583.
379
- */
380
- private withKeepalive;
381
- /**
382
- * Does the SDK transport have an `eventStore`? Reaches into the SDK's
383
- * private field because the option isn't surfaced on the public API —
384
- * we only need a yes/no for keepalive policy.
385
- */
386
- private eventStoreConfigured;
387
409
  private getCorsHeaders;
388
410
  private withCorsHeaders;
389
411
  private installOnSessionInitializedBridge;
@@ -2588,6 +2610,251 @@ declare function getNamespacedData<T extends keyof NamespacedData>(
2588
2610
  type: T
2589
2611
  ): NamespacedData[T];
2590
2612
  //#endregion
2613
+ //#region src/workflow-types.d.ts
2614
+ type AgentWorkflowPathStep = AgentPathStep;
2615
+ type AgentWorkflowOrigin =
2616
+ | {
2617
+ kind: "agent";
2618
+ version: 1 /** Environment binding name for the top-level Agent namespace */;
2619
+ binding: string /** Name/ID of the top-level Agent */;
2620
+ name: string;
2621
+ }
2622
+ | {
2623
+ kind: "facet";
2624
+ version: 1 /** Environment binding name for the root Agent namespace */;
2625
+ rootBinding: string /** Root-first path to the originating facet, including itself */;
2626
+ path: AgentWorkflowPathStep[];
2627
+ };
2628
+ /**
2629
+ * Type alias for WorkflowEvent in AgentWorkflow context.
2630
+ * Identical to WorkflowEvent - provided for naming consistency with AgentWorkflowStep.
2631
+ */
2632
+ type AgentWorkflowEvent<Params = unknown> = WorkflowEvent<Params>;
2633
+ /**
2634
+ * Extended WorkflowStep with durable Agent communication methods.
2635
+ * All added methods on this interface are durable - they're idempotent and won't
2636
+ * repeat on workflow retry.
2637
+ */
2638
+ interface AgentWorkflowStep extends WorkflowStep {
2639
+ /**
2640
+ * Report successful completion to the Agent (durable).
2641
+ * Triggers onWorkflowComplete() on the Agent.
2642
+ * @param result - Optional result data
2643
+ */
2644
+ reportComplete<T = unknown>(result?: T): Promise<void>;
2645
+ /**
2646
+ * Report an error to the Agent (durable).
2647
+ * Triggers onWorkflowError() on the Agent.
2648
+ * @param error - Error or error message
2649
+ */
2650
+ reportError(error: Error | string): Promise<void>;
2651
+ /**
2652
+ * Send a custom event to the Agent (durable).
2653
+ * Triggers onWorkflowEvent() on the Agent.
2654
+ * @param event - Custom event payload
2655
+ */
2656
+ sendEvent<T = unknown>(event: T): Promise<void>;
2657
+ /**
2658
+ * Update the Agent's state entirely (durable).
2659
+ * This will replace the Agent's state and broadcast to all connected clients.
2660
+ * @param state - New state to set
2661
+ */
2662
+ updateAgentState(state: unknown): Promise<void>;
2663
+ /**
2664
+ * Merge partial state into the Agent's existing state (durable).
2665
+ * Performs a shallow merge and broadcasts to all connected clients.
2666
+ * @param partialState - Partial state to merge
2667
+ */
2668
+ mergeAgentState(partialState: Record<string, unknown>): Promise<void>;
2669
+ /**
2670
+ * Reset the Agent's state to its initialState (durable).
2671
+ * Broadcasts the reset state to all connected clients.
2672
+ */
2673
+ resetAgentState(): Promise<void>;
2674
+ }
2675
+ /**
2676
+ * Internal parameters injected by runWorkflow() to identify the originating Agent
2677
+ */
2678
+ type AgentWorkflowInternalParams = {
2679
+ /** Name/ID of the Agent that started this workflow */ __agentName: string /** Environment binding name for the Agent's namespace */;
2680
+ __agentBinding: string /** Workflow binding name (for callbacks) */;
2681
+ __workflowName: string /** Versioned origin identity for top-level Agents and sub-agent facets */;
2682
+ __agentOrigin?: AgentWorkflowOrigin;
2683
+ };
2684
+ /**
2685
+ * Combined workflow params: user params + internal agent params
2686
+ */
2687
+ type AgentWorkflowParams<T = unknown> = T & AgentWorkflowInternalParams;
2688
+ /**
2689
+ * Workflow callback types for Agent-Workflow communication
2690
+ */
2691
+ type WorkflowCallbackType = "progress" | "complete" | "error" | "event";
2692
+ /**
2693
+ * Base callback structure sent from Workflow to Agent
2694
+ */
2695
+ type WorkflowCallbackBase = {
2696
+ /** Workflow binding name */ workflowName: string /** ID of the workflow instance */;
2697
+ workflowId: string /** Type of callback */;
2698
+ type: WorkflowCallbackType /** Timestamp when callback was sent */;
2699
+ timestamp: number;
2700
+ };
2701
+ /**
2702
+ * Default progress type - covers common use cases.
2703
+ * Developers can define their own progress type for domain-specific needs.
2704
+ */
2705
+ type DefaultProgress = {
2706
+ /** Current step name */ step?: string /** Step/overall status */;
2707
+ status?:
2708
+ | "pending"
2709
+ | "running"
2710
+ | "complete"
2711
+ | "error" /** Human-readable message */;
2712
+ message?: string /** Progress percentage (0-1) */;
2713
+ percent?: number /** Allow additional custom fields */;
2714
+ [key: string]: unknown;
2715
+ };
2716
+ /**
2717
+ * Progress callback - reports workflow progress with typed payload
2718
+ */
2719
+ type WorkflowProgressCallback<P = DefaultProgress> = WorkflowCallbackBase & {
2720
+ type: "progress" /** Typed progress data */;
2721
+ progress: P;
2722
+ };
2723
+ /**
2724
+ * Complete callback - workflow finished successfully
2725
+ */
2726
+ type WorkflowCompleteCallback = WorkflowCallbackBase & {
2727
+ type: "complete" /** Result of the workflow */;
2728
+ result?: unknown;
2729
+ };
2730
+ /**
2731
+ * Error callback - workflow encountered an error
2732
+ */
2733
+ type WorkflowErrorCallback = WorkflowCallbackBase & {
2734
+ type: "error" /** Error message */;
2735
+ error: string;
2736
+ };
2737
+ /**
2738
+ * Event callback - custom event from workflow
2739
+ */
2740
+ type WorkflowEventCallback = WorkflowCallbackBase & {
2741
+ type: "event" /** Custom event payload */;
2742
+ event: unknown;
2743
+ };
2744
+ /**
2745
+ * Union of all callback types
2746
+ */
2747
+ type WorkflowCallback<P = DefaultProgress> =
2748
+ | WorkflowProgressCallback<P>
2749
+ | WorkflowCompleteCallback
2750
+ | WorkflowErrorCallback
2751
+ | WorkflowEventCallback;
2752
+ /**
2753
+ * Workflow status values - derived from Cloudflare's InstanceStatus
2754
+ */
2755
+ type WorkflowStatus = InstanceStatus["status"];
2756
+ /**
2757
+ * Row structure for cf_agents_workflows tracking table
2758
+ */
2759
+ type WorkflowTrackingRow = {
2760
+ /** Internal row ID (UUID) */ id: string /** Cloudflare Workflow instance ID */;
2761
+ workflow_id: string /** Workflow binding name */;
2762
+ workflow_name: string /** Current workflow status */;
2763
+ status: WorkflowStatus /** JSON-serialized metadata for querying */;
2764
+ metadata: string | null /** Error name if workflow failed */;
2765
+ error_name: string | null /** Error message if workflow failed */;
2766
+ error_message: string | null /** Unix timestamp when workflow was created */;
2767
+ created_at: number /** Unix timestamp when workflow was last updated */;
2768
+ updated_at: number /** Unix timestamp when workflow completed (null if not complete) */;
2769
+ completed_at: number | null;
2770
+ };
2771
+ /**
2772
+ * Options for runWorkflow()
2773
+ */
2774
+ type RunWorkflowOptions = {
2775
+ /** Custom workflow instance ID (auto-generated if not provided) */ id?: string /** Optional metadata for querying (stored as JSON) */;
2776
+ metadata?: Record<
2777
+ string,
2778
+ unknown
2779
+ > /** Agent binding name (auto-detected from class name if not provided) */;
2780
+ agentBinding?: string /** Retention policy for the underlying Workflow instance */;
2781
+ retention?: WorkflowInstanceCreateOptions["retention"];
2782
+ };
2783
+ /**
2784
+ * Event payload for sendWorkflowEvent()
2785
+ */
2786
+ type WorkflowEventPayload = {
2787
+ /** Event type name */ type: string /** Event payload data */;
2788
+ payload: unknown;
2789
+ };
2790
+ /**
2791
+ * Parsed workflow tracking info returned by getWorkflow()
2792
+ */
2793
+ type WorkflowInfo = {
2794
+ /** Internal row ID */ id: string /** Cloudflare Workflow instance ID */;
2795
+ workflowId: string /** Workflow binding name */;
2796
+ workflowName: string /** Current workflow status */;
2797
+ status: WorkflowStatus /** Metadata (parsed from JSON) */;
2798
+ metadata: Record<string, unknown> | null /** Error info if workflow failed */;
2799
+ error: {
2800
+ name: string;
2801
+ message: string;
2802
+ } | null /** When workflow was created */;
2803
+ createdAt: Date /** When workflow was last updated */;
2804
+ updatedAt: Date /** When workflow completed (null if not complete) */;
2805
+ completedAt: Date | null;
2806
+ };
2807
+ /**
2808
+ * Criteria for querying tracked workflows
2809
+ */
2810
+ type WorkflowQueryCriteria = {
2811
+ /** Filter by status */ status?:
2812
+ | WorkflowStatus
2813
+ | WorkflowStatus[] /** Filter by workflow binding name */;
2814
+ workflowName?: string /** Filter by metadata key-value pairs (exact match) */;
2815
+ metadata?: Record<
2816
+ string,
2817
+ string | number | boolean
2818
+ > /** Limit number of results (default 50, max 100) */;
2819
+ limit?: number /** Order by created_at */;
2820
+ orderBy?:
2821
+ | "asc"
2822
+ | "desc" /** Cursor for pagination (from previous WorkflowPage.nextCursor) */;
2823
+ cursor?: string;
2824
+ };
2825
+ /**
2826
+ * Paginated result from getWorkflows()
2827
+ */
2828
+ type WorkflowPage = {
2829
+ /** Workflows for this page */ workflows: WorkflowInfo[] /** Total count of workflows matching the criteria (ignoring pagination) */;
2830
+ total: number /** Cursor for next page, or null if no more pages */;
2831
+ nextCursor: string | null;
2832
+ };
2833
+ /**
2834
+ * Standard approval event payload used by approveWorkflow/rejectWorkflow
2835
+ */
2836
+ type ApprovalEventPayload = {
2837
+ /** Whether the workflow was approved */ approved: boolean /** Optional reason for approval/rejection */;
2838
+ reason?: string /** Optional additional metadata */;
2839
+ metadata?: Record<string, unknown>;
2840
+ };
2841
+ /**
2842
+ * Options for waitForApproval()
2843
+ */
2844
+ type WaitForApprovalOptions = {
2845
+ /** Step name for waitForEvent (default: "wait-for-approval") */ stepName?: string /** Timeout duration (e.g., "7 days") */;
2846
+ timeout?: WorkflowSleepDuration /** Event type to wait for (default: "approval") */;
2847
+ eventType?: string;
2848
+ };
2849
+ /**
2850
+ * Error thrown when a workflow is rejected via rejectWorkflow()
2851
+ */
2852
+ declare class WorkflowRejectedError extends Error {
2853
+ readonly reason?: string | undefined;
2854
+ readonly workflowId?: string | undefined;
2855
+ constructor(reason?: string | undefined, workflowId?: string | undefined);
2856
+ }
2857
+ //#endregion
2591
2858
  //#region src/index.d.ts
2592
2859
  /**
2593
2860
  * Structural type for Cloudflare's `send_email` binding.
@@ -2838,10 +3105,6 @@ type Schedule<T = string> = {
2838
3105
  intervalSeconds: number;
2839
3106
  }
2840
3107
  );
2841
- type AgentPathStep = {
2842
- className: string;
2843
- name: string;
2844
- };
2845
3108
  type ScheduleStorageRow = {
2846
3109
  id: string;
2847
3110
  callback: string;
@@ -4492,19 +4755,13 @@ declare class Agent<
4492
4755
  *
4493
4756
  * @experimental The API surface may change before stabilizing.
4494
4757
  */
4495
- get parentPath(): ReadonlyArray<{
4496
- className: string;
4497
- name: string;
4498
- }>;
4758
+ get parentPath(): ReadonlyArray<AgentPathStep>;
4499
4759
  /**
4500
4760
  * Ancestor chain + self, root-first. Convenient for logging.
4501
4761
  *
4502
4762
  * @experimental The API surface may change before stabilizing.
4503
4763
  */
4504
- get selfPath(): ReadonlyArray<{
4505
- className: string;
4506
- name: string;
4507
- }>;
4764
+ get selfPath(): ReadonlyArray<AgentPathStep>;
4508
4765
  /**
4509
4766
  * Resolve a typed parent stub for this facet's **immediate** parent
4510
4767
  * agent.
@@ -6040,123 +6297,154 @@ type AgentToolEventState<Part extends AgentToolRunPart = AgentToolRunPart> = {
6040
6297
  //#endregion
6041
6298
  export {
6042
6299
  RoutingRetryOptions as $,
6043
- LegacyMcpHandler as $t,
6300
+ MCPOAuthCallbackResult as $t,
6044
6301
  AgentGetOptions as A,
6045
- MCPServerFilter as At,
6302
+ StreamableHTTPEdgeClientTransport as An,
6303
+ WorkflowCompleteCallback as At,
6046
6304
  EmailSendBinding as B,
6047
- RPCServerTransport as Bt,
6305
+ parseSubAgentPath as Bn,
6306
+ WorkflowTrackingRow as Bt,
6048
6307
  DetachedRunAgentToolResult as C,
6049
- MCPClientManager as Ct,
6308
+ LegacyMcpHandler as Cn,
6309
+ ApprovalEventPayload as Ct,
6050
6310
  AddRpcMcpServerOptions as D,
6051
- MCPConnectionResult as Dt,
6311
+ WorkerTransport as Dn,
6312
+ WorkflowCallback as Dt,
6052
6313
  AddMcpServerOptions as E,
6053
- MCPClientOAuthResult as Et,
6314
+ TransportState as En,
6315
+ WaitForApprovalOptions as Et,
6054
6316
  Connection$1 as F,
6055
- normalizeServerId as Ft,
6317
+ buildAgentPath as Fn,
6318
+ WorkflowPage as Ft,
6056
6319
  FiberStatus as G,
6057
- ElicitResult$3 as Gt,
6320
+ MCPClientElicitationHandler as Gt,
6058
6321
  FiberInspection as H,
6059
- RPC_DO_PREFIX as Ht,
6322
+ withInvocationScope as Hn,
6323
+ ElicitResult$2 as Ht,
6060
6324
  ConnectionContext$1 as I,
6061
- MCPElicitationHandler as It,
6325
+ buildAgentUrl as In,
6326
+ WorkflowProgressCallback as It,
6062
6327
  MCPServerMessage as J,
6063
- DurableObjectEventStore as Jt,
6328
+ MCPClientManagerOptions as Jt,
6064
6329
  ListFibersOptions as K,
6065
- McpAgent as Kt,
6330
+ MCPClientElicitationHandlers as Kt,
6066
6331
  DEFAULT_AGENT_STATIC_OPTIONS as L,
6067
- MCPElicitationHandlers as Lt,
6332
+ buildSubAgentPath as Ln,
6333
+ WorkflowQueryCriteria as Lt,
6068
6334
  AgentOptions as M,
6069
- MCP_SERVER_ID_MAX_LENGTH as Mt,
6335
+ BuildAgentPathOptions as Mn,
6336
+ WorkflowEventCallback as Mt,
6070
6337
  AgentStaticOptions as N,
6071
- RegisterServerOptions as Nt,
6338
+ SUB_PREFIX as Nn,
6339
+ WorkflowEventPayload as Nt,
6072
6340
  Agent as O,
6073
- MCPDiscoverResult as Ot,
6341
+ WorkerTransportOptions as On,
6342
+ WorkflowCallbackBase as Ot,
6074
6343
  CallableMetadata as P,
6075
- getNamespacedData as Pt,
6344
+ SubAgentPathMatch as Pn,
6345
+ WorkflowInfo as Pt,
6076
6346
  RPCResponse as Q,
6077
- CreateMcpHandlerOptions$1 as Qt,
6347
+ MCPDiscoverResult as Qt,
6078
6348
  DeleteFibersOptions as R,
6079
- RPCClientTransport as Rt,
6349
+ buildSubAgentPathUnchecked as Rn,
6350
+ WorkflowRejectedError as Rt,
6080
6351
  DetachedAgentToolConfig as S,
6081
- MCPClientElicitationHandlers as St,
6352
+ CreateMcpHandlerOptions$1 as Sn,
6353
+ AgentWorkflowStep as St,
6082
6354
  RunAgentToolResult as T,
6083
- MCPClientOAuthCallbackConfig as Tt,
6355
+ MCPStorageApi as Tn,
6356
+ RunWorkflowOptions as Tt,
6084
6357
  FiberRecoveryContext as U,
6085
- ElicitRequest$2 as Ut,
6358
+ MCPAITool as Ut,
6086
6359
  FiberContext as V,
6087
- RPCServerTransportOptions as Vt,
6360
+ routeSubAgentRequest as Vn,
6361
+ ElicitRequest$1 as Vt,
6088
6362
  FiberRecoveryResult as W,
6089
- ElicitRequestSchema as Wt,
6363
+ MCPAIToolSet as Wt,
6090
6364
  QueueItem as X,
6091
- experimental_createMcpHandler as Xt,
6365
+ MCPClientOAuthResult as Xt,
6092
6366
  MCPServersState as Y,
6093
- createMcpHandler$1 as Yt,
6367
+ MCPClientOAuthCallbackConfig as Yt,
6094
6368
  RPCRequest as Z,
6095
- CreateLegacyMcpHandlerOptions as Zt,
6369
+ MCPConnectionResult as Zt,
6096
6370
  AgentToolRunState as _,
6097
- ElicitRequest$1 as _t,
6371
+ ClearableEventStore as _n,
6372
+ AgentWorkflowEvent as _t,
6098
6373
  AgentToolEvent as a,
6099
- SSEEdgeClientTransport as an,
6374
+ normalizeServerId as an,
6100
6375
  StartFiberResult as at,
6101
6376
  AgentToolTerminalStatus as b,
6102
- MCPAIToolSet as bt,
6377
+ experimental_createMcpHandler as bn,
6378
+ AgentWorkflowParams as bt,
6103
6379
  AgentToolFailure as c,
6104
- SubAgentPathMatch as cn,
6380
+ RPCClientTransport as cn,
6105
6381
  SubAgentClass as ct,
6106
6382
  AgentToolMilestone as d,
6107
- routeSubAgentRequest as dn,
6383
+ RPCServerTransportOptions as dn,
6108
6384
  callable as dt,
6109
- createLegacyMcpHandler as en,
6385
+ MCPServerFilter as en,
6110
6386
  Schedule as et,
6111
6387
  AgentToolProgress as f,
6388
+ RPC_DO_PREFIX as fn,
6112
6389
  getAgentByName as ft,
6113
6390
  AgentToolRunPart as g,
6391
+ McpAgent as gn,
6114
6392
  unstable_callable as gt,
6115
6393
  AgentToolRunInspection as h,
6394
+ ElicitResult$3 as hn,
6116
6395
  routeAgentRequest as ht,
6117
6396
  AgentToolDisplayMetadata as i,
6118
- WorkerTransportOptions as in,
6397
+ getNamespacedData as in,
6119
6398
  StartFiberOptions as it,
6120
6399
  AgentNamespace as j,
6121
- MCPServerOptions as jt,
6400
+ AgentPathStep as jn,
6401
+ WorkflowErrorCallback as jt,
6122
6402
  AgentContext as k,
6123
- MCPOAuthCallbackResult as kt,
6403
+ SSEEdgeClientTransport as kn,
6404
+ WorkflowCallbackType as kt,
6124
6405
  AgentToolInterruptedReason as l,
6125
- getSubAgentByName as ln,
6406
+ RPCClientTransportOptions as ln,
6126
6407
  SubAgentStub as lt,
6127
6408
  AgentToolRunInfo as m,
6409
+ ElicitRequestSchema as mn,
6128
6410
  routeAgentEmail as mt,
6129
6411
  AGENT_TOOL_PROGRESS_PART as n,
6130
- TransportState as nn,
6412
+ MCP_SERVER_ID_MAX_LENGTH as nn,
6131
6413
  SendEmailOptions as nt,
6132
6414
  AgentToolEventMessage as o,
6133
- StreamableHTTPEdgeClientTransport as on,
6415
+ MCPElicitationHandler as on,
6134
6416
  StateUpdateMessage as ot,
6135
6417
  AgentToolProgressSnapshot as p,
6418
+ ElicitRequest$2 as pn,
6136
6419
  getCurrentAgent as pt,
6137
6420
  MCPServer as q,
6138
- ClearableEventStore as qt,
6421
+ MCPClientManager as qt,
6139
6422
  AgentToolChildAdapter as r,
6140
- WorkerTransport as rn,
6423
+ RegisterServerOptions as rn,
6141
6424
  SqlError as rt,
6142
6425
  AgentToolEventState as s,
6143
- SUB_PREFIX as sn,
6426
+ MCPElicitationHandlers as sn,
6144
6427
  StreamingResponse as st,
6145
6428
  AGENT_TOOL_MILESTONE_PART as t,
6146
- MCPStorageApi as tn,
6429
+ MCPServerOptions as tn,
6147
6430
  ScheduleCriteria as tt,
6148
6431
  AgentToolLifecycleResult as u,
6149
- parseSubAgentPath as un,
6432
+ RPCServerTransport as un,
6150
6433
  WSMessage$1 as ut,
6151
6434
  AgentToolRunStatus as v,
6152
- ElicitResult$2 as vt,
6435
+ DurableObjectEventStore as vn,
6436
+ AgentWorkflowInternalParams as vt,
6153
6437
  RunAgentToolOptions as w,
6154
- MCPClientManagerOptions as wt,
6438
+ createLegacyMcpHandler as wn,
6439
+ DefaultProgress as wt,
6155
6440
  ChatCapableAgentClass as x,
6156
- MCPClientElicitationHandler as xt,
6441
+ CreateLegacyMcpHandlerOptions as xn,
6442
+ AgentWorkflowPathStep as xt,
6157
6443
  AgentToolStoredChunk as y,
6158
- MCPAITool as yt,
6444
+ createMcpHandler$1 as yn,
6445
+ AgentWorkflowOrigin as yt,
6159
6446
  EmailRoutingOptions as z,
6160
- RPCClientTransportOptions as zt
6447
+ getSubAgentByName as zn,
6448
+ WorkflowStatus as zt
6161
6449
  };
6162
- //# sourceMappingURL=agent-tool-types-Btk9ETS-.d.ts.map
6450
+ //# sourceMappingURL=agent-tool-types-CzGGB-20.d.ts.map
@@ -24,7 +24,7 @@ import {
24
24
  w as RunAgentToolOptions,
25
25
  x as ChatCapableAgentClass,
26
26
  y as AgentToolStoredChunk
27
- } from "./agent-tool-types-Btk9ETS-.js";
27
+ } from "./agent-tool-types-CzGGB-20.js";
28
28
  export {
29
29
  AGENT_TOOL_MILESTONE_PART,
30
30
  AGENT_TOOL_PROGRESS_PART,
@@ -4,7 +4,7 @@ import {
4
4
  o as AgentToolEventMessage,
5
5
  s as AgentToolEventState,
6
6
  y as AgentToolStoredChunk
7
- } from "./agent-tool-types-Btk9ETS-.js";
7
+ } from "./agent-tool-types-CzGGB-20.js";
8
8
 
9
9
  //#region src/chat/agent-tools.d.ts
10
10
  type AgentToolProgressEmitResult = "emitted" | "coalesced" | "inactive";
@@ -130,4 +130,4 @@ export {
130
130
  interceptAgentToolBroadcast as s,
131
131
  AgentToolBroadcastHooks as t
132
132
  };
133
- //# sourceMappingURL=agent-tools-UuScsJg3.d.ts.map
133
+ //# sourceMappingURL=agent-tools-zR2d5uij.d.ts.map