agents 0.11.0 → 0.11.1

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { r as Agent } from "./index-CrOzHA2T.js";
+import { r as Agent } from "./index-C_XD19E3.js";
 import {
   i as SerializableValue,
   n as RPCMethod,

package/dist/{index-Cubsi2Qv.d.ts → index-Biv6K70p.d.ts}

@@ -232,6 +232,14 @@ type AgentObservabilityEvent =
         subject?: string;
       }
     >
+  | BaseEvent<
+      "email:send",
+      {
+        from: string;
+        to: string | string[];
+        subject: string;
+      }
+    >
   | BaseEvent<
       "workflow:start",
       {
@@ -413,4 +421,4 @@ export {
   MCPObservabilityEvent as s,
   ChannelEventMap as t
 };
-//# sourceMappingURL=index-Cubsi2Qv.d.ts.map
+//# sourceMappingURL=index-Biv6K70p.d.ts.map

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

@@ -4,7 +4,7 @@ import {
   n as Observability,
   r as ObservabilityEvent,
   s as MCPObservabilityEvent
-} from "./index-Cubsi2Qv.js";
+} from "./index-Biv6K70p.js";
 import { t as AgentMcpOAuthProvider } from "./do-oauth-client-provider-C38aWbFV.js";
 import {
   _ as WorkflowPage,
@@ -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-CrOzHA2T.d.ts.map
+//# sourceMappingURL=index-C_XD19E3.d.ts.map

package/dist/index.d.ts

@@ -1,41 +1,43 @@
 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-CrOzHA2T.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,
@@ -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,

package/dist/index.js

@@ -1075,6 +1075,63 @@ var Agent = class Agent extends Server {
 			});
 		});
 	}
+	/**
+	* 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
+	*/
+	async sendEmail(options) {
+		return this._tryCatch(async () => {
+			if (!options.binding) throw new Error("binding is required. Pass your send_email binding, e.g. this.sendEmail({ binding: this.env.EMAIL, ... }).");
+			const agentName = camelCaseToKebabCase(this._ParentClass.name);
+			const agentId = this.name;
+			const headers = {
+				...options.headers,
+				"X-Agent-Name": agentName,
+				"X-Agent-ID": agentId
+			};
+			if (options.inReplyTo) headers["In-Reply-To"] = options.inReplyTo;
+			if (typeof options.secret === "string") {
+				const signedHeaders = await signAgentHeaders(options.secret, agentName, agentId);
+				headers["X-Agent-Sig"] = signedHeaders["X-Agent-Sig"];
+				headers["X-Agent-Sig-Ts"] = signedHeaders["X-Agent-Sig-Ts"];
+			}
+			const result = await options.binding.send({
+				from: options.from,
+				to: options.to,
+				subject: options.subject,
+				text: options.text,
+				html: options.html,
+				replyTo: options.replyTo,
+				cc: options.cc,
+				bcc: options.bcc,
+				headers
+			});
+			const fromAddr = typeof options.from === "string" ? options.from : options.from.email;
+			this._emit("email:send", {
+				from: fromAddr,
+				to: options.to,
+				subject: options.subject
+			});
+			return result;
+		});
+	}
 	async _tryCatch(fn) {
 		try {
 			return await fn();