agents 0.11.0 → 0.11.2

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-BBh8iKgk.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

@@ -4,7 +4,7 @@ import { createHeaderBasedEmailResolver, signAgentHeaders } from "./email.js";
 import { __DO_NOT_USE_WILL_BREAK__agentContext } from "./internal_context.js";
 import { i as _classPrivateFieldInitSpec, n as _classPrivateFieldSet2, t as _classPrivateFieldGet2 } from "./classPrivateFieldGet2-BVdP0e3Z.js";
 import { isErrorRetryable, tryN, validateRetryOptions } from "./retries.js";
-import { o as RPC_DO_PREFIX, r as MCPConnectionState, s as DisposableStore, t as MCPClientManager } from "./client-QBjFV5de.js";
+import { o as RPC_DO_PREFIX, r as MCPConnectionState, s as DisposableStore, t as MCPClientManager } from "./client-PEDsNnfY.js";
 import { DurableObjectOAuthClientProvider } from "./mcp/do-oauth-client-provider.js";
 import { genericObservability } from "./observability/index.js";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -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();