agents sdk changelog (email, .queue and automatic context)

src/content/changelog/agents/2025-07-21-agents-queue-email-context-update.mdx

@@ -0,0 +1,85 @@
+---
+title: Agents SDK now supports task queues, email handling, and context-wrapped methods
+description: The latest release adds .queue(), email support, and automatic context for custom methods
+products:
+  - agents
+  - workers
+  - workflows
+date: 2025-07-21
+---
+
+The latest releases of [@cloudflare/agents] (https://github.com/cloudflare/agents) brings three powerful improvements that make building and scaling agents even easier. You now get:
+
+### Lightweight .queue for fast task deferral
+
+You can use .queue() to enqueue background work — ideal for tasks like processing user messages, sending notifications etc.
+
+```ts
+class MyAgent extends Agent {
+	doSomethingExpensive(payload) {
+		// a long running process that you want to run in the background
+	}
+
+	queueSomething() {
+		await this.queue("doSomethingExpensive", somePayload); // this will NOT block further execution, and runs in the background
+		await this.queue("doSomethingExpensive", someOtherPayload); // the callback will NOT run until the previous callback is complete
+		// ... call as many times as you want
+	}
+}
+```
+
+Want to try it yourself? Just define a method like processMessage in your agent, and you’re ready to scale.
+
+### New email adaptor
+
+Want to build an AI agent that can receive and respond to emails automatically? With the new email adaptor and onEmail lifecycle method, now you can.
+
+```ts
+export class EmailAgent extends Agent {
+	async onEmail(email: AgentEmail) {
+		const raw = await email.getRaw();
+		const parsed = await PostalMime.parse(raw);
+
+		// create a response based on the email contents
+		// and then send a reply
+
+		await this.replyToEmail(email, {
+			fromName: "Email Agent",
+			body: `Thanks for your email! You've sent us "${parsed.subject}". We'll process it shortly.`,
+		});
+	}
+}
+```
+
+You route incoming mail like this:
+
+```ts
+export default {
+	async email(email, env) {
+		await routeAgentEmail(email, env, {
+			resolver: createAddressBasedEmailResolver("EmailAgent"),
+		});
+	},
+};
+```
+
+You can find a full example [here](https://github.com/cloudflare/agents/tree/main/examples/email-agent).
+
+### Automatic context wrapping for custom methods
+
+Custom methods are now automatically wrapped with the agent's context, so calling `getCurrentAgent()` should work regardless of where in an agent's lifecycle it's called. Previously this would not work on RPC calls, but not just works out of the box.
+
+```ts
+export class MyAgent extends Agent {
+	async suggestReply(ctx, { message }) {
+		// getCurrentAgent() now correctly works, even when called inside an RPC method
+		const { agent } = getCurrentAgent()!;
+		return generateText({
+			prompt: `Suggest a reply to: "${message}" from "${agent.name}"`,
+			tools: [replyWithEmoji],
+		});
+	}
+}
+```
+
+Try it out and tell us what you build!