agents 0.7.0 → 0.7.1

package/dist/{agent-DnmmRjyv.d.ts → agent-eZnMHidZ.d.ts}

@@ -7,6 +7,17 @@ type BaseEvent<
   Payload extends Record<string, unknown> = Record<string, never>
 > = {
   type: T;
+  /**
+   * The class name of the agent that emitted this event
+   * (e.g. "MyChatAgent").
+   * Always present on events emitted by an Agent instance.
+   */
+  agent?: string;
+  /**
+   * The instance name (Durable Object ID name) of the agent.
+   * Always present on events emitted by an Agent instance.
+   */
+  name?: string;
   /**
    * The payload of the event
    */
@@ -145,6 +156,13 @@ type AgentObservabilityEvent =
         attempts: number;
       }
     >
+  | BaseEvent<
+      "queue:create",
+      {
+        callback: string;
+        id: string;
+      }
+    >
   | BaseEvent<
       "queue:retry",
       {
@@ -170,6 +188,30 @@ type AgentObservabilityEvent =
         connectionId: string;
       }
     >
+  | BaseEvent<
+      "disconnect",
+      {
+        connectionId: string;
+        code: number;
+        reason: string;
+      }
+    >
+  | BaseEvent<
+      "email:receive",
+      {
+        from: string;
+        to: string;
+        subject?: string;
+      }
+    >
+  | BaseEvent<
+      "email:reply",
+      {
+        from: string;
+        to: string;
+        subject?: string;
+      }
+    >
   | BaseEvent<
       "workflow:start",
       {
@@ -228,4 +270,4 @@ type AgentObservabilityEvent =
     >;
 //#endregion
 export { MCPObservabilityEvent as n, AgentObservabilityEvent as t };
-//# sourceMappingURL=agent-DnmmRjyv.d.ts.map
+//# sourceMappingURL=agent-eZnMHidZ.d.ts.map

package/dist/{client-storage-tusTuoSF.d.ts → client-storage-yDVwzgfF.d.ts}

@@ -1,4 +1,4 @@
-import { n as MCPObservabilityEvent } from "./agent-DnmmRjyv.js";
+import { n as MCPObservabilityEvent } from "./agent-eZnMHidZ.js";
 import { AgentMcpOAuthProvider } from "./mcp/do-oauth-client-provider.js";
 import { McpAgent } from "./mcp/index.js";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
@@ -554,7 +554,7 @@ declare class MCPClientConnection {
    */
   getTransport(
     transportType: BaseTransportType
-  ): StreamableHTTPClientTransport | SSEClientTransport | RPCClientTransport;
+  ): RPCClientTransport | SSEClientTransport | StreamableHTTPClientTransport;
   private tryConnect;
   private _capabilityErrorHandler;
 }
@@ -601,4 +601,4 @@ export {
   MaybePromise as x,
   StreamableHTTPEdgeClientTransport as y
 };
-//# sourceMappingURL=client-storage-tusTuoSF.d.ts.map
+//# sourceMappingURL=client-storage-yDVwzgfF.d.ts.map

package/dist/experimental/forever.d.ts

@@ -1,5 +1,5 @@
 import { RetryOptions } from "../retries.js";
-import "../client-storage-tusTuoSF.js";
+import "../client-storage-yDVwzgfF.js";
 import { Agent, Schedule } from "../index.js";
 
 //#region src/experimental/forever.d.ts

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import { RetryOptions } from "./retries.js";
 import {
   r as MCPConnectionState,
   w as TransportType
-} from "./client-storage-tusTuoSF.js";
+} from "./client-storage-yDVwzgfF.js";
 import {
   AgentMcpOAuthProvider,
   AgentsOAuthProvider,
@@ -23,7 +23,7 @@ import {
   WorkflowPage,
   WorkflowQueryCriteria
 } from "./workflow-types.js";
-import { Observability } from "./observability/index.js";
+import { Observability, ObservabilityEvent } from "./observability/index.js";
 import { MessageType } from "./types.js";
 import {
   Connection,
@@ -325,7 +325,10 @@ declare class Agent<
    * Emit an observability event with auto-generated timestamp.
    * @internal
    */
-  private _emit;
+  protected _emit(
+    type: ObservabilityEvent["type"],
+    payload?: Record<string, unknown>
+  ): void;
   /**
    * Execute SQL queries against the Agent's database
    * @template T Type of the returned rows

package/dist/index.js

@@ -260,6 +260,8 @@ var Agent = class Agent extends Server {
 	_emit(type, payload = {}) {
 		this.observability?.emit({
 			type,
+			agent: this._ParentClass.name,
+			name: this.name,
 			payload,
 			timestamp: Date.now()
 		});
@@ -457,7 +459,11 @@ var Agent = class Agent extends Server {
 			this.broadcastMcpServers();
 		}));
 		this._disposables.add(this.mcp.onObservabilityEvent((event) => {
-			this.observability?.emit(event);
+			this.observability?.emit({
+				...event,
+				agent: this._ParentClass.name,
+				name: this.name
+			});
 		}));
 		{
 			const proto = Object.getPrototypeOf(this);
@@ -620,6 +626,22 @@ var Agent = class Agent extends Server {
 				return this._tryCatch(() => _onConnect(connection, ctx));
 			});
 		};
+		const _onClose = this.onClose.bind(this);
+		this.onClose = (connection, code, reason, wasClean) => {
+			return __DO_NOT_USE_WILL_BREAK__agentContext.run({
+				agent: this,
+				connection,
+				request: void 0,
+				email: void 0
+			}, () => {
+				this._emit("disconnect", {
+					connectionId: connection.id,
+					code,
+					reason
+				});
+				return _onClose(connection, code, reason, wasClean);
+			});
+		};
 		const _onStart = this.onStart.bind(this);
 		this.onStart = async (props) => {
 			return __DO_NOT_USE_WILL_BREAK__agentContext.run({
@@ -917,6 +939,11 @@ var Agent = class Agent extends Server {
 			request: void 0,
 			email
 		}, async () => {
+			this._emit("email:receive", {
+				from: email.from,
+				to: email.to,
+				subject: email.headers.get("subject") ?? void 0
+			});
 			if ("onEmail" in this && typeof this.onEmail === "function") return this._tryCatch(() => this.onEmail(email));
 			else {
 				console.log("Received email from:", email.from, "to:", email.to);
@@ -967,6 +994,12 @@ var Agent = class Agent extends Server {
 				raw: msg.asRaw(),
 				to: email.from
 			});
+			const rawSubject = email.headers.get("subject");
+			this._emit("email:reply", {
+				from: email.to,
+				to: email.from,
+				subject: options.subject ?? (rawSubject ? `Re: ${rawSubject}` : void 0)
+			});
 		});
 	}
 	async _tryCatch(fn) {
@@ -1065,6 +1098,10 @@ var Agent = class Agent extends Server {
       INSERT OR REPLACE INTO cf_agents_queues (id, payload, callback, retry_options)
       VALUES (${id}, ${JSON.stringify(payload)}, ${callback}, ${retryJson})
     `;
+		this._emit("queue:create", {
+			callback,
+			id
+		});
 		this._flushQueue().catch((e) => {
 			console.error("Error flushing queue:", e);
 		});