agents 0.10.2 → 0.11.1

package/dist/{index-D2lfljd3.d.ts → index-C_XD19E3.d.ts}

@@ -1,11 +1,11 @@
-import { n as AgentEmail } from "./internal_context-DuQZFvWI.js";
-import { t as RetryOptions } from "./retries-B_CN5KM9.js";
+import { n as AgentEmail } from "./internal_context-BvuGZieY.js";
+import { t as RetryOptions } from "./retries-JlwH9mnV.js";
 import {
   n as Observability,
   r as ObservabilityEvent,
   s as MCPObservabilityEvent
-} from "./index-DDSX-g7W.js";
-import { t as AgentMcpOAuthProvider } from "./do-oauth-client-provider-31gqR33H.js";
+} from "./index-Biv6K70p.js";
+import { t as AgentMcpOAuthProvider } from "./do-oauth-client-provider-C38aWbFV.js";
 import {
   _ as WorkflowPage,
   g as WorkflowInfo,
@@ -13,9 +13,9 @@ import {
   l as WorkflowCallback,
   s as RunWorkflowOptions,
   y as WorkflowQueryCriteria
-} from "./workflow-types-XmOkuI7A.js";
-import { t as MessageType } from "./types-B9A8AU7B.js";
-import { r as EmailResolver } from "./email-Cql45SKP.js";
+} from "./workflow-types-DHs0L0KP.js";
+import { t as MessageType } from "./types-DAHCZC_W.js";
+import { r as EmailResolver } from "./email-X72-zjuq.js";
 import { RpcTarget } from "cloudflare:workers";
 import {
   Connection,
@@ -729,7 +729,7 @@ declare class MCPClientConnection {
    */
   getTransport(
     transportType: BaseTransportType
-  ): StreamableHTTPClientTransport | SSEClientTransport | RPCClientTransport;
+  ): RPCClientTransport | SSEClientTransport | StreamableHTTPClientTransport;
   private tryConnect;
   private _capabilityErrorHandler;
 }
@@ -1420,6 +1420,64 @@ declare function getNamespacedData<T extends keyof NamespacedData>(
 ): NamespacedData[T];
 //#endregion
 //#region src/index.d.ts
+/**
+ * Structural type for Cloudflare's `send_email` binding.
+ * Accepts both raw MIME messages and structured builder objects.
+ */
+type EmailSendBinding = {
+  send(
+    message:
+      | EmailMessage
+      | {
+          from:
+            | string
+            | {
+                email: string;
+                name?: string;
+              };
+          to: string | string[];
+          subject: string;
+          replyTo?:
+            | string
+            | {
+                email: string;
+                name?: string;
+              };
+          cc?: string | string[];
+          bcc?: string | string[];
+          headers?: Record<string, string>;
+          text?: string;
+          html?: string;
+        }
+  ): Promise<EmailSendResult>;
+};
+/**
+ * Options for Agent.sendEmail()
+ */
+type SendEmailOptions = {
+  binding: EmailSendBinding;
+  to: string | string[];
+  from:
+    | string
+    | {
+        email: string;
+        name?: string;
+      };
+  subject: string;
+  text?: string;
+  html?: string;
+  replyTo?:
+    | string
+    | {
+        email: string;
+        name?: string;
+      };
+  cc?: string | string[];
+  bcc?: string | string[];
+  inReplyTo?: string;
+  headers?: Record<string, string>;
+  secret?: string;
+};
 /**
  * RPC request message from client
  */
@@ -2015,6 +2073,28 @@ declare class Agent<
       secret?: string | null;
     }
   ): Promise<void>;
+  /**
+   * Send an outbound email via an Email Service binding.
+   *
+   * Automatically injects agent routing headers (X-Agent-Name, X-Agent-ID).
+   * When `secret` is provided, signs headers with HMAC-SHA256 so that replies
+   * can be routed back to this agent instance via createSecureReplyEmailResolver.
+   *
+   * @param options.binding The send_email binding (e.g. this.env.EMAIL)
+   * @param options.to Recipient address(es)
+   * @param options.from Sender address or {email, name} object
+   * @param options.subject Email subject line
+   * @param options.text Plain text body (at least one of text/html required)
+   * @param options.html HTML body (at least one of text/html required)
+   * @param options.replyTo Reply-to address
+   * @param options.cc CC recipient(s)
+   * @param options.bcc BCC recipient(s)
+   * @param options.inReplyTo Message-ID of the email this is replying to (for threading)
+   * @param options.headers Additional custom headers
+   * @param options.secret Secret for signing agent routing headers
+   * @returns The messageId from Email Service
+   */
+  sendEmail(options: SendEmailOptions): Promise<EmailSendResult>;
   private _tryCatch;
   /**
    * Automatically wrap custom methods with agent context
@@ -2932,70 +3012,72 @@ declare class StreamingResponse {
 }
 //#endregion
 export {
-  McpAgent as $,
-  getCurrentAgent as A,
-  MCPOAuthCallbackResult as B,
-  StateUpdateMessage as C,
-  WSMessage as D,
-  SubAgentStub as E,
-  MCPClientManagerOptions as F,
-  RPCClientTransport as G,
-  MCPServerOptions as H,
-  MCPClientOAuthCallbackConfig as I,
-  RPCServerTransportOptions as J,
-  RPCClientTransportOptions as K,
-  MCPClientOAuthResult as L,
-  routeAgentRequest as M,
-  unstable_callable as N,
-  callable as O,
-  MCPClientManager as P,
-  ElicitResult$1 as Q,
-  MCPConnectionResult as R,
-  SqlError as S,
-  SubAgentClass as T,
-  RegisterServerOptions as U,
-  MCPServerFilter as V,
-  getNamespacedData as W,
-  ElicitRequest$1 as X,
-  RPC_DO_PREFIX as Y,
-  ElicitRequestSchema$1 as Z,
-  MCPServersState as _,
+  ElicitRequestSchema$1 as $,
+  callable as A,
+  MCPConnectionResult as B,
+  SendEmailOptions as C,
+  SubAgentClass as D,
+  StreamingResponse as E,
+  unstable_callable as F,
+  RegisterServerOptions as G,
+  MCPOAuthCallbackResult as H,
+  MCPClientManager as I,
+  RPCClientTransportOptions as J,
+  getNamespacedData as K,
+  MCPClientManagerOptions as L,
+  getCurrentAgent as M,
+  routeAgentEmail as N,
+  SubAgentStub as O,
+  routeAgentRequest as P,
+  ElicitRequest$1 as Q,
+  MCPClientOAuthCallbackConfig as R,
+  Schedule as S,
+  StateUpdateMessage as T,
+  MCPServerFilter as U,
+  MCPDiscoverResult as V,
+  MCPServerOptions as W,
+  RPCServerTransportOptions as X,
+  RPCServerTransport as Y,
+  RPC_DO_PREFIX as Z,
+  MCPServerMessage as _,
   AgentNamespace as a,
-  TransportState as at,
-  RPCResponse as b,
+  McpAuthContext as at,
+  RPCRequest as b,
   CallableMetadata as c,
-  SSEEdgeClientTransport as ct,
+  WorkerTransport as ct,
   DEFAULT_AGENT_STATIC_OPTIONS as d,
-  TransportType as dt,
-  CreateMcpHandlerOptions as et,
+  StreamableHTTPEdgeClientTransport as dt,
+  ElicitResult$1 as et,
   EmailRoutingOptions as f,
-  MCPServerMessage as g,
-  MCPServer as h,
+  McpClientOptions as ft,
+  MCPServer as g,
+  FiberRecoveryContext as h,
   AgentContext as i,
-  getMcpAuthContext as it,
-  routeAgentEmail as j,
-  getAgentByName as k,
+  experimental_createMcpHandler as it,
+  getAgentByName as j,
+  WSMessage as k,
   Connection$1 as l,
-  StreamableHTTPEdgeClientTransport as lt,
-  FiberRecoveryContext as m,
+  WorkerTransportOptions as lt,
+  FiberContext as m,
   AddRpcMcpServerOptions as n,
-  experimental_createMcpHandler as nt,
+  CreateMcpHandlerOptions as nt,
   AgentOptions as o,
-  WorkerTransport as ot,
-  FiberContext as p,
-  RPCServerTransport as q,
+  getMcpAuthContext as ot,
+  EmailSendBinding as p,
+  TransportType as pt,
+  RPCClientTransport as q,
   Agent as r,
-  McpAuthContext as rt,
+  createMcpHandler as rt,
   AgentStaticOptions as s,
-  WorkerTransportOptions as st,
+  TransportState as st,
   AddMcpServerOptions as t,
-  createMcpHandler as tt,
+  McpAgent as tt,
   ConnectionContext$1 as u,
-  McpClientOptions as ut,
-  QueueItem as v,
-  StreamingResponse as w,
-  Schedule as x,
-  RPCRequest as y,
-  MCPDiscoverResult as z
+  SSEEdgeClientTransport as ut,
+  MCPServersState as v,
+  SqlError as w,
+  RPCResponse as x,
+  QueueItem as y,
+  MCPClientOAuthResult as z
 };
-//# sourceMappingURL=index-D2lfljd3.d.ts.map
+//# sourceMappingURL=index-C_XD19E3.d.ts.map

package/dist/index.d.ts

@@ -1,48 +1,50 @@
-import { r as __DO_NOT_USE_WILL_BREAK__agentContext } from "./internal_context-DuQZFvWI.js";
-import { t as RetryOptions } from "./retries-B_CN5KM9.js";
+import { r as __DO_NOT_USE_WILL_BREAK__agentContext } from "./internal_context-BvuGZieY.js";
+import { t as RetryOptions } from "./retries-JlwH9mnV.js";
 import {
-  A as getCurrentAgent,
-  C as StateUpdateMessage,
-  D as WSMessage,
-  E as SubAgentStub,
-  M as routeAgentRequest,
-  N as unstable_callable,
-  O as callable,
-  S as SqlError,
-  T as SubAgentClass,
-  _ as MCPServersState,
+  A as callable,
+  C as SendEmailOptions,
+  D as SubAgentClass,
+  E as StreamingResponse,
+  F as unstable_callable,
+  M as getCurrentAgent,
+  N as routeAgentEmail,
+  O as SubAgentStub,
+  P as routeAgentRequest,
+  S as Schedule,
+  T as StateUpdateMessage,
+  _ as MCPServerMessage,
   a as AgentNamespace,
-  b as RPCResponse,
+  b as RPCRequest,
   c as CallableMetadata,
   d as DEFAULT_AGENT_STATIC_OPTIONS,
-  dt as TransportType,
   f as EmailRoutingOptions,
-  g as MCPServerMessage,
-  h as MCPServer,
+  g as MCPServer,
+  h as FiberRecoveryContext,
   i as AgentContext,
-  j as routeAgentEmail,
-  k as getAgentByName,
+  j as getAgentByName,
+  k as WSMessage,
   l as Connection,
-  m as FiberRecoveryContext,
+  m as FiberContext,
   n as AddRpcMcpServerOptions,
   o as AgentOptions,
-  p as FiberContext,
+  p as EmailSendBinding,
+  pt as TransportType,
   r as Agent,
   s as AgentStaticOptions,
   t as AddMcpServerOptions,
   u as ConnectionContext,
-  v as QueueItem,
-  w as StreamingResponse,
-  x as Schedule,
-  y as RPCRequest
-} from "./index-D2lfljd3.js";
+  v as MCPServersState,
+  w as SqlError,
+  x as RPCResponse,
+  y as QueueItem
+} from "./index-C_XD19E3.js";
 import {
   n as AgentsOAuthProvider,
   r as DurableObjectOAuthClientProvider,
   t as AgentMcpOAuthProvider
-} from "./do-oauth-client-provider-31gqR33H.js";
-import { t as MessageType } from "./types-B9A8AU7B.js";
-import { l as createHeaderBasedEmailResolver } from "./email-Cql45SKP.js";
+} from "./do-oauth-client-provider-C38aWbFV.js";
+import { t as MessageType } from "./types-DAHCZC_W.js";
+import { l as createHeaderBasedEmailResolver } from "./email-X72-zjuq.js";
 export {
   AddMcpServerOptions,
   AddRpcMcpServerOptions,
@@ -59,6 +61,7 @@ export {
   DEFAULT_AGENT_STATIC_OPTIONS,
   DurableObjectOAuthClientProvider,
   EmailRoutingOptions,
+  EmailSendBinding,
   FiberContext,
   FiberRecoveryContext,
   MCPServer,
@@ -70,6 +73,7 @@ export {
   RPCResponse,
   RetryOptions,
   Schedule,
+  SendEmailOptions,
   SqlError,
   StateUpdateMessage,
   StreamingResponse,