agents 0.7.7 → 0.7.9

package/dist/experimental/forever.d.ts

@@ -1,4 +1,4 @@
-import { r as Agent } from "../index-DBW341gU.js";
+import { r as Agent } from "../index-B6xYRT3K.js";
 //#region src/experimental/forever.d.ts
 type FiberState = {
   id: string;

package/dist/{index-DBW341gU.d.ts → index-B6xYRT3K.d.ts}

@@ -5,7 +5,7 @@ import {
   n as Observability,
   r as ObservabilityEvent,
   s as MCPObservabilityEvent
-} from "./index-BS_jL8MI.js";
+} from "./index-D9AuAMOt.js";
 import { t as AgentMcpOAuthProvider } from "./do-oauth-client-provider-C2jurFjW.js";
 import {
   _ as WorkflowPage,
@@ -707,7 +707,7 @@ declare class MCPClientConnection {
    */
   getTransport(
     transportType: BaseTransportType
-  ): SSEClientTransport | StreamableHTTPClientTransport | RPCClientTransport;
+  ): RPCClientTransport | SSEClientTransport | StreamableHTTPClientTransport;
   private tryConnect;
   private _capabilityErrorHandler;
 }
@@ -1672,6 +1672,24 @@ declare class Agent<
    * Override to provide default state values
    */
   initialState: State;
+  /**
+   * Stable key for Workers AI session affinity (prefix-cache optimization).
+   *
+   * Uses the Durable Object ID, which is globally unique across all agent
+   * classes and stable for the lifetime of the instance. Pass this value as
+   * the `sessionAffinity` option when creating a Workers AI model so that
+   * requests from the same agent instance are routed to the same backend
+   * replica, improving KV-prefix-cache hit rates across conversation turns.
+   *
+   * @example
+   * ```typescript
+   * const workersai = createWorkersAI({ binding: this.env.AI });
+   * const model = workersai("@cf/meta/llama-3.3-70b-instruct-fp8-fast", {
+   *   sessionAffinity: this.sessionAffinity,
+   * });
+   * ```
+   */
+  get sessionAffinity(): string;
   /**
    * Current state of the Agent
    */
@@ -2837,4 +2855,4 @@ export {
   Schedule as y,
   MCPServerOptions as z
 };
-//# sourceMappingURL=index-DBW341gU.d.ts.map
+//# sourceMappingURL=index-B6xYRT3K.d.ts.map

package/dist/{index-BS_jL8MI.d.ts → index-D9AuAMOt.d.ts}

@@ -271,98 +271,11 @@ type AgentObservabilityEvent =
       }
     >;
 //#endregion
-//#region src/observability/workspace.d.ts
-/**
- * Workspace-specific observability events.
- * These track file operations, directory changes, and bash execution
- * within a Workspace instance.
- */
-type WorkspaceObservabilityEvent =
-  | BaseEvent<
-      "workspace:read",
-      {
-        namespace: string;
-        path: string;
-        storage: "inline" | "r2";
-      }
-    >
-  | BaseEvent<
-      "workspace:write",
-      {
-        namespace: string;
-        path: string;
-        size: number;
-        storage: "inline" | "r2";
-        update: boolean;
-      }
-    >
-  | BaseEvent<
-      "workspace:delete",
-      {
-        namespace: string;
-        path: string;
-      }
-    >
-  | BaseEvent<
-      "workspace:mkdir",
-      {
-        namespace: string;
-        path: string;
-        recursive: boolean;
-      }
-    >
-  | BaseEvent<
-      "workspace:rm",
-      {
-        namespace: string;
-        path: string;
-        recursive: boolean;
-      }
-    >
-  | BaseEvent<
-      "workspace:cp",
-      {
-        namespace: string;
-        src: string;
-        dest: string;
-        recursive: boolean;
-      }
-    >
-  | BaseEvent<
-      "workspace:mv",
-      {
-        namespace: string;
-        src: string;
-        dest: string;
-      }
-    >
-  | BaseEvent<
-      "workspace:bash",
-      {
-        namespace: string;
-        command: string;
-        exitCode: number;
-        durationMs: number;
-      }
-    >
-  | BaseEvent<
-      "workspace:error",
-      {
-        namespace: string;
-        operation: string;
-        path: string;
-        error: string;
-      }
-    >;
-//#endregion
 //#region src/observability/index.d.ts
 /**
  * Union of all observability event types from different domains
  */
-type ObservabilityEvent =
-  | AgentObservabilityEvent
-  | MCPObservabilityEvent
-  | WorkspaceObservabilityEvent;
+type ObservabilityEvent = AgentObservabilityEvent | MCPObservabilityEvent;
 interface Observability {
   /**
    * Emit an event for the Agent's observability implementation to handle.
@@ -394,7 +307,6 @@ declare const channels: {
   readonly workflow: Channel<unknown, unknown>;
   readonly mcp: Channel<unknown, unknown>;
   readonly email: Channel<unknown, unknown>;
-  readonly workspace: Channel<unknown, unknown>;
 };
 /**
  * The default observability implementation.
@@ -455,12 +367,6 @@ type ChannelEventMap = {
       type: `email:${string}`;
     }
   >;
-  workspace: Extract<
-    ObservabilityEvent,
-    {
-      type: `workspace:${string}`;
-    }
-  >;
 };
 /**
  * Subscribe to a typed observability channel.
@@ -489,4 +395,4 @@ export {
   MCPObservabilityEvent as s,
   ChannelEventMap as t
 };
-//# sourceMappingURL=index-BS_jL8MI.d.ts.map
+//# sourceMappingURL=index-D9AuAMOt.d.ts.map

package/dist/index.d.ts

@@ -34,7 +34,7 @@ import {
   w as SubAgentStub,
   x as StateUpdateMessage,
   y as Schedule
-} from "./index-DBW341gU.js";
+} from "./index-B6xYRT3K.js";
 import {
   n as AgentsOAuthProvider,
   r as DurableObjectOAuthClientProvider,

package/dist/index.js

@@ -212,6 +212,26 @@ function withAgentContext(method) {
 * @template State State type to store within the Agent
 */
 var Agent = class Agent extends Server {
+	/**
+	* Stable key for Workers AI session affinity (prefix-cache optimization).
+	*
+	* Uses the Durable Object ID, which is globally unique across all agent
+	* classes and stable for the lifetime of the instance. Pass this value as
+	* the `sessionAffinity` option when creating a Workers AI model so that
+	* requests from the same agent instance are routed to the same backend
+	* replica, improving KV-prefix-cache hit rates across conversation turns.
+	*
+	* @example
+	* ```typescript
+	* const workersai = createWorkersAI({ binding: this.env.AI });
+	* const model = workersai("@cf/meta/llama-3.3-70b-instruct-fp8-fast", {
+	*   sessionAffinity: this.sessionAffinity,
+	* });
+	* ```
+	*/
+	get sessionAffinity() {
+		return this.ctx.id.toString();
+	}
 	/**
 	* Current state of the Agent
 	*/