agents 0.0.0-ac74811 → 0.0.0-b123357

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import {
   PartySocketOptions,
   PartyFetchOptions,
-  PartySocket,
+  PartySocket
 } from "partysocket";
 import { SerializableReturnValue, SerializableValue } from "./serializable.js";
 
@@ -94,5 +94,5 @@ export {
   type AgentClientOptions,
   type StreamOptions,
   agentFetch,
-  camelCaseToKebabCase,
+  camelCaseToKebabCase
 };

package/dist/client.js

@@ -2,7 +2,7 @@ import {
   AgentClient,
   agentFetch,
   camelCaseToKebabCase
-} from "./chunk-NKZZ66QY.js";
+} from "./chunk-KUH345EY.js";
 export {
   AgentClient,
   agentFetch,

package/dist/{index-CITGJflw.d.ts → index-BCJclX6q.d.ts}

@@ -1,17 +1,18 @@
+import { env } from "cloudflare:workers";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import {
   ServerCapabilities,
   Tool,
   Prompt,
-  Resource,
+  Resource
 } from "@modelcontextprotocol/sdk/types.js";
 import { Server, Connection, PartyServerOptions } from "partyserver";
-import { MCPClientManager } from "./mcp/client.js";
+import { M as MCPClientManager } from "./client-DgyzBU_8.js";
 import { Message } from "ai";
 
 type BaseEvent<
   T extends string,
-  Payload extends Record<string, unknown> = {},
+  Payload extends Record<string, unknown> = {}
 > = {
   type: T;
   /**
@@ -140,6 +141,12 @@ declare function unstable_callable(
   target: (this: This, ...args: Args) => Return,
   context: ClassMethodDecoratorContext
 ) => (this: This, ...args: Args) => Return;
+type QueueItem<T = string> = {
+  id: string;
+  payload: T;
+  callback: keyof Agent<unknown>;
+  created_at: number;
+};
 /**
  * Represents a scheduled task within an Agent
  * @template T Type of the payload data
@@ -199,18 +206,19 @@ type MCPServer = {
   capabilities: ServerCapabilities | null;
 };
 declare function getCurrentAgent<
-  T extends Agent<unknown, unknown> = Agent<unknown, unknown>,
+  T extends Agent<unknown, unknown> = Agent<unknown, unknown>
 >(): {
   agent: T | undefined;
   connection: Connection | undefined;
-  request: Request<unknown, CfProperties<unknown>> | undefined;
+  request: Request | undefined;
+  email: AgentEmail | undefined;
 };
 /**
  * Base class for creating Agent implementations
  * @template Env Environment type containing bindings
  * @template State State type to store within the Agent
  */
-declare class Agent<Env, State = unknown> extends Server<Env> {
+declare class Agent<Env = typeof env, State = unknown> extends Server<Env> {
   private _state;
   private _ParentClass;
   mcp: MCPClientManager;
@@ -259,17 +267,75 @@ declare class Agent<Env, State = unknown> extends Server<Env> {
    */
   onStateUpdate(state: State | undefined, source: Connection | "server"): void;
   /**
-   * Called when the Agent receives an email
+   * Called when the Agent receives an email via routeAgentEmail()
+   * Override this method to handle incoming emails
    * @param email Email message to process
    */
-  onEmail(email: ForwardableEmailMessage): Promise<void>;
+  _onEmail(email: AgentEmail): Promise<void>;
+  /**
+   * Reply to an email
+   * @param email The email to reply to
+   * @param options Options for the reply
+   * @returns void
+   */
+  replyToEmail(
+    email: AgentEmail,
+    options: {
+      fromName: string;
+      subject?: string | undefined;
+      body: string;
+      contentType?: string;
+      headers?: Record<string, string>;
+    }
+  ): Promise<void>;
   private _tryCatch;
+  /**
+   * Automatically wrap custom methods with agent context
+   * This ensures getCurrentAgent() works in all custom methods without decorators
+   */
+  private _autoWrapCustomMethods;
   onError(connection: Connection, error: unknown): void | Promise<void>;
   onError(error: unknown): void | Promise<void>;
   /**
    * Render content (not implemented in base class)
    */
   render(): void;
+  /**
+   * Queue a task to be executed in the future
+   * @param payload Payload to pass to the callback
+   * @param callback Name of the method to call
+   * @returns The ID of the queued task
+   */
+  queue<T = unknown>(callback: keyof this, payload: T): Promise<string>;
+  private _flushingQueue;
+  private _flushQueue;
+  /**
+   * Dequeue a task by ID
+   * @param id ID of the task to dequeue
+   */
+  dequeue(id: string): Promise<void>;
+  /**
+   * Dequeue all tasks
+   */
+  dequeueAll(): Promise<void>;
+  /**
+   * Dequeue all tasks by callback
+   * @param callback Name of the callback to dequeue
+   */
+  dequeueAllByCallback(callback: string): Promise<void>;
+  /**
+   * Get a queued task by ID
+   * @param id ID of the task to get
+   * @returns The task or undefined if not found
+   */
+  getQueue(id: string): Promise<QueueItem<string> | undefined>;
+  /**
+   * Get all queues by key and value
+   * @param key Key to filter by
+   * @param value Value to filter by
+   * @returns Array of matching QueueItem objects
+   */
+  getQueues(key: string, value: string): Promise<QueueItem<string>[]>;
   /**
    * Schedule a task to be executed in the future
    * @template T Type of the payload data
@@ -413,17 +479,72 @@ declare function routeAgentRequest<Env>(
   env: Env,
   options?: AgentOptions<Env>
 ): Promise<Response | null>;
+type EmailResolver<Env> = (
+  email: ForwardableEmailMessage,
+  env: Env
+) => Promise<{
+  agentName: string;
+  agentId: string;
+} | null>;
+/**
+ * Create a resolver that uses the message-id header to determine the agent to route the email to
+ * @returns A function that resolves the agent to route the email to
+ */
+declare function createHeaderBasedEmailResolver<Env>(): EmailResolver<Env>;
+/**
+ * Create a resolver that uses the email address to determine the agent to route the email to
+ * @param defaultAgentName The default agent name to use if the email address does not contain a sub-address
+ * @returns A function that resolves the agent to route the email to
+ */
+declare function createAddressBasedEmailResolver<Env>(
+  defaultAgentName: string
+): EmailResolver<Env>;
+/**
+ * Create a resolver that uses the agentName and agentId to determine the agent to route the email to
+ * @param agentName The name of the agent to route the email to
+ * @param agentId The id of the agent to route the email to
+ * @returns A function that resolves the agent to route the email to
+ */
+declare function createCatchAllEmailResolver<Env>(
+  agentName: string,
+  agentId: string
+): EmailResolver<Env>;
+type EmailRoutingOptions<Env> = AgentOptions<Env> & {
+  resolver: EmailResolver<Env>;
+};
 /**
  * Route an email to the appropriate Agent
- * @param email Email message to route
- * @param env Environment containing Agent bindings
- * @param options Routing options
+ * @param email The email to route
+ * @param env The environment containing the Agent bindings
+ * @param options The options for routing the email
+ * @returns A promise that resolves when the email has been routed
  */
 declare function routeAgentEmail<Env>(
-  _email: ForwardableEmailMessage,
-  _env: Env,
-  _options?: AgentOptions<Env>
+  email: ForwardableEmailMessage,
+  env: Env,
+  options: EmailRoutingOptions<Env>
 ): Promise<void>;
+type AgentEmail = {
+  from: string;
+  to: string;
+  getRaw: () => Promise<Uint8Array>;
+  headers: Headers;
+  rawSize: number;
+  setReject: (reason: string) => void;
+  forward: (rcptTo: string, headers?: Headers) => Promise<void>;
+  reply: (options: { from: string; to: string; raw: string }) => Promise<void>;
+};
+type EmailSendOptions = {
+  to: string;
+  subject: string;
+  body: string;
+  contentType?: string;
+  headers?: Record<string, string>;
+  includeRoutingHeaders?: boolean;
+  agentName?: string;
+  agentId?: string;
+  domain?: string;
+};
 /**
  * Get or create an Agent by name
  * @template Env Environment type containing bindings
@@ -464,8 +585,10 @@ declare class StreamingResponse {
 export {
   Agent as A,
   type CallableMetadata as C,
+  type EmailResolver as E,
   type MCPServersState as M,
   type ObservabilityEvent as O,
+  type QueueItem as Q,
   type RPCRequest as R,
   type StateUpdateMessage as S,
   type AgentContext as a,
@@ -478,9 +601,15 @@ export {
   getCurrentAgent as h,
   type AgentNamespace as i,
   type AgentOptions as j,
-  routeAgentEmail as k,
-  getAgentByName as l,
-  StreamingResponse as m,
+  createHeaderBasedEmailResolver as k,
+  createAddressBasedEmailResolver as l,
+  createCatchAllEmailResolver as m,
+  type EmailRoutingOptions as n,
+  routeAgentEmail as o,
+  type AgentEmail as p,
+  type EmailSendOptions as q,
   routeAgentRequest as r,
-  unstable_callable as u,
+  getAgentByName as s,
+  StreamingResponse as t,
+  unstable_callable as u
 };

package/dist/index.d.ts

@@ -1,31 +1,41 @@
+import "cloudflare:workers";
 import "@modelcontextprotocol/sdk/client/index.js";
 import "@modelcontextprotocol/sdk/types.js";
 export { Connection, ConnectionContext, WSMessage } from "partyserver";
-import "./mcp/client.js";
+import "./client-DgyzBU_8.js";
 export {
   A as Agent,
   a as AgentContext,
+  p as AgentEmail,
   i as AgentNamespace,
   j as AgentOptions,
   C as CallableMetadata,
+  E as EmailResolver,
+  n as EmailRoutingOptions,
+  q as EmailSendOptions,
   f as MCPServer,
   e as MCPServerMessage,
   M as MCPServersState,
+  Q as QueueItem,
   R as RPCRequest,
   c as RPCResponse,
   d as Schedule,
   S as StateUpdateMessage,
-  m as StreamingResponse,
-  l as getAgentByName,
+  t as StreamingResponse,
+  l as createAddressBasedEmailResolver,
+  m as createCatchAllEmailResolver,
+  k as createHeaderBasedEmailResolver,
+  s as getAgentByName,
   h as getCurrentAgent,
-  k as routeAgentEmail,
+  o as routeAgentEmail,
   r as routeAgentRequest,
-  u as unstable_callable,
-} from "./index-CITGJflw.js";
+  u as unstable_callable
+} from "./index-BCJclX6q.js";
 import "zod";
-import "@modelcontextprotocol/sdk/client/sse.js";
 import "@modelcontextprotocol/sdk/shared/protocol.js";
 import "ai";
+import "@modelcontextprotocol/sdk/client/sse.js";
+import "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import "./mcp/do-oauth-client-provider.js";
 import "@modelcontextprotocol/sdk/client/auth.js";
 import "@modelcontextprotocol/sdk/shared/auth.js";

package/dist/index.js

@@ -1,18 +1,24 @@
 import {
   Agent,
   StreamingResponse,
+  createAddressBasedEmailResolver,
+  createCatchAllEmailResolver,
+  createHeaderBasedEmailResolver,
   getAgentByName,
   getCurrentAgent,
   routeAgentEmail,
   routeAgentRequest,
   unstable_callable
-} from "./chunk-JFRK72K3.js";
-import "./chunk-E3LCYPCB.js";
-import "./chunk-767EASBA.js";
-import "./chunk-NKZZ66QY.js";
+} from "./chunk-OJFA7RKX.js";
+import "./chunk-HY7ZLHJB.js";
+import "./chunk-PVQZBKN7.js";
+import "./chunk-KUH345EY.js";
 export {
   Agent,
   StreamingResponse,
+  createAddressBasedEmailResolver,
+  createCatchAllEmailResolver,
+  createHeaderBasedEmailResolver,
   getAgentByName,
   getCurrentAgent,
   routeAgentEmail,