hono-agents 0.0.0-ff0679f → 0.0.0-ff9329f

package/README.md

@@ -7,15 +7,15 @@ Add intelligent, stateful AI agents to your Hono app. Create persistent AI agent
 ## Installation
 
 ```bash
-npm install hono-agents hono agents-sdk
+npm install agents hono hono-agents
 ```
 
 ## Usage
 
 ```ts
 import { Hono } from "hono";
+import { Agent } from "agents";
 import { agentsMiddleware } from "hono-agents";
-import { Agent } from "agents-sdk";
 
 // Define your agent classes
 export class ChatAgent extends Agent {
@@ -43,8 +43,8 @@ app.use(
         const token = req.headers.get("authorization");
         // validate token
         if (!token) return new Response("Unauthorized", { status: 401 });
-      },
-    },
+      }
+    }
   })
 );
 
@@ -56,8 +56,8 @@ app.use(
   "*",
   agentsMiddleware({
     options: {
-      prefix: "/agents", // Handles /agents/* routes only
-    },
+      prefix: "agents" // Handles /agents/* routes only
+    }
   })
 );
 
@@ -66,18 +66,23 @@ export default app;
 
 ## Configuration
 
-To properly configure your Cloudflare Workers project to use agents, update your `wrangler.toml` file:
-
-```toml
-[durable_objects]
-bindings = [
-  { name = "ChatAgent", class_name = "ChatAgent" },
-  { name = "AssistantAgent", class_name = "AssistantAgent" }
-]
-
-[[migrations]]
-tag = "v1"
-new_sqlite_classes = ["ChatAgent", "AssistantAgent"]
+To properly configure your Cloudflare Workers project to use agents, add bindings to your `wrangler.jsonc` file:
+
+```json
+{
+  "durable_objects": {
+    "bindings": [
+      { "name": "ChatAgent", "class_name": "ChatAgent" },
+      { "name": "AssistantAgent", "class_name": "AssistantAgent" }
+    ]
+  },
+  "migrations": [
+    {
+      "tag": "v1",
+      "new_sqlite_classes": ["ChatAgent", "AssistantAgent"]
+    }
+  ]
+}
 ```
 
 ## How It Works
@@ -99,6 +104,6 @@ Agents can:
 
 ## License
 
-Learn more about Cloudflare Agents at https://www.npmjs.com/package/agents-sdk
+Learn more about Cloudflare Agents at https://www.npmjs.com/package/agents
 
 ISC

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as hono from "hono";
 import { Env } from "hono";
-import { AgentOptions } from "agents-sdk";
+import { AgentOptions } from "agents";
 
 /**
  * Configuration options for the Cloudflare Agents middleware
@@ -17,6 +17,6 @@ type AgentMiddlewareContext<E extends Env> = {
  */
 declare function agentsMiddleware<E extends Env = Env>(
   ctx?: AgentMiddlewareContext<E>
-): hono.MiddlewareHandler<any, string, {}>;
+): hono.MiddlewareHandler<Env, string, {}>;
 
 export { agentsMiddleware };

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
+import { routeAgentRequest } from "agents";
 import { env } from "hono/adapter";
 import { createMiddleware } from "hono/factory";
-import { routeAgentRequest } from "agents-sdk";
 function agentsMiddleware(ctx) {
   return createMiddleware(async (c, next) => {
     try {
@@ -20,16 +20,12 @@ function agentsMiddleware(ctx) {
 function isWebSocketUpgrade(c) {
   return c.req.header("upgrade")?.toLowerCase() === "websocket";
 }
-function createRequestFromContext(c) {
-  return new Request(c.req.url, {
-    method: c.req.method,
-    headers: c.req.header(),
-    body: c.req.raw.body
-  });
-}
 async function handleWebSocketUpgrade(c, options) {
-  const req = createRequestFromContext(c);
-  const response = await routeAgentRequest(req, env(c), options);
+  const response = await routeAgentRequest(
+    c.req.raw,
+    env(c),
+    options
+  );
   if (!response?.webSocket) {
     return null;
   }
@@ -39,8 +35,7 @@ async function handleWebSocketUpgrade(c, options) {
   });
 }
 async function handleHttpRequest(c, options) {
-  const req = createRequestFromContext(c);
-  return routeAgentRequest(req, env(c), options);
+  return routeAgentRequest(c.req.raw, env(c), options);
 }
 export {
   agentsMiddleware

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { env } from \"hono/adapter\";\nimport { createMiddleware } from \"hono/factory\";\nimport { routeAgentRequest } from \"agents-sdk\";\n\nimport type { Context, Env } from \"hono\";\nimport type { AgentOptions } from \"agents-sdk\";\n\n/**\n * Configuration options for the Cloudflare Agents middleware\n */\ntype AgentMiddlewareContext<E extends Env> = {\n  /** Cloudflare Agents-specific configuration options */\n  options?: AgentOptions<E>;\n  /** Optional error handler for caught errors */\n  onError?: (error: Error) => void;\n};\n\n/**\n * Creates a middleware for handling Cloudflare Agents WebSocket and HTTP requests\n * Processes both WebSocket upgrades and standard HTTP requests, delegating them to Cloudflare Agents\n */\nexport function agentsMiddleware<E extends Env = Env>(\n  ctx?: AgentMiddlewareContext<E>\n) {\n  return createMiddleware(async (c, next) => {\n    try {\n      const handler = isWebSocketUpgrade(c)\n        ? handleWebSocketUpgrade\n        : handleHttpRequest;\n      const response = await handler(c, ctx?.options);\n\n      return response === null ? await next() : response;\n    } catch (error) {\n      if (ctx?.onError) {\n        ctx.onError(error as Error);\n        return next();\n      }\n      throw error;\n    }\n  });\n}\n\n/**\n * Checks if the incoming request is a WebSocket upgrade request\n * Looks for the 'upgrade' header with a value of 'websocket' (case-insensitive)\n */\nfunction isWebSocketUpgrade(c: Context): boolean {\n  return c.req.header(\"upgrade\")?.toLowerCase() === \"websocket\";\n}\n\n/**\n * Creates a new Request object from the Hono context\n * Preserves the original request's URL, method, headers, and body\n */\nfunction createRequestFromContext(c: Context) {\n  return new Request(c.req.url, {\n    method: c.req.method,\n    headers: c.req.header(),\n    body: c.req.raw.body,\n  });\n}\n\n/**\n * Handles WebSocket upgrade requests\n * Returns a WebSocket upgrade response if successful, null otherwise\n */\nasync function handleWebSocketUpgrade<E extends Env>(\n  c: Context<E>,\n  options?: AgentOptions<E>\n) {\n  const req = createRequestFromContext(c);\n  const response = await routeAgentRequest(req, env(c), options);\n\n  if (!response?.webSocket) {\n    return null;\n  }\n\n  return new Response(null, {\n    status: 101,\n    webSocket: response.webSocket,\n  });\n}\n\n/**\n * Handles standard HTTP requests\n * Forwards the request to Cloudflare Agents and returns the response\n */\nasync function handleHttpRequest<E extends Env>(\n  c: Context<E>,\n  options?: AgentOptions<E>\n) {\n  const req = createRequestFromContext(c);\n  return routeAgentRequest(req, env(c), options);\n}\n"],"mappings":";AAAA,SAAS,WAAW;AACpB,SAAS,wBAAwB;AACjC,SAAS,yBAAyB;AAmB3B,SAAS,iBACd,KACA;AACA,SAAO,iBAAiB,OAAO,GAAG,SAAS;AACzC,QAAI;AACF,YAAM,UAAU,mBAAmB,CAAC,IAChC,yBACA;AACJ,YAAM,WAAW,MAAM,QAAQ,GAAG,KAAK,OAAO;AAE9C,aAAO,aAAa,OAAO,MAAM,KAAK,IAAI;AAAA,IAC5C,SAAS,OAAO;AACd,UAAI,KAAK,SAAS;AAChB,YAAI,QAAQ,KAAc;AAC1B,eAAO,KAAK;AAAA,MACd;AACA,YAAM;AAAA,IACR;AAAA,EACF,CAAC;AACH;AAMA,SAAS,mBAAmB,GAAqB;AAC/C,SAAO,EAAE,IAAI,OAAO,SAAS,GAAG,YAAY,MAAM;AACpD;AAMA,SAAS,yBAAyB,GAAY;AAC5C,SAAO,IAAI,QAAQ,EAAE,IAAI,KAAK;AAAA,IAC5B,QAAQ,EAAE,IAAI;AAAA,IACd,SAAS,EAAE,IAAI,OAAO;AAAA,IACtB,MAAM,EAAE,IAAI,IAAI;AAAA,EAClB,CAAC;AACH;AAMA,eAAe,uBACb,GACA,SACA;AACA,QAAM,MAAM,yBAAyB,CAAC;AACtC,QAAM,WAAW,MAAM,kBAAkB,KAAK,IAAI,CAAC,GAAG,OAAO;AAE7D,MAAI,CAAC,UAAU,WAAW;AACxB,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,SAAS,MAAM;AAAA,IACxB,QAAQ;AAAA,IACR,WAAW,SAAS;AAAA,EACtB,CAAC;AACH;AAMA,eAAe,kBACb,GACA,SACA;AACA,QAAM,MAAM,yBAAyB,CAAC;AACtC,SAAO,kBAAkB,KAAK,IAAI,CAAC,GAAG,OAAO;AAC/C;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { AgentOptions } from \"agents\";\nimport { routeAgentRequest } from \"agents\";\nimport type { Context, Env } from \"hono\";\nimport { env } from \"hono/adapter\";\nimport { createMiddleware } from \"hono/factory\";\n\n/**\n * Configuration options for the Cloudflare Agents middleware\n */\ntype AgentMiddlewareContext<E extends Env> = {\n  /** Cloudflare Agents-specific configuration options */\n  options?: AgentOptions<E>;\n  /** Optional error handler for caught errors */\n  onError?: (error: Error) => void;\n};\n\n/**\n * Creates a middleware for handling Cloudflare Agents WebSocket and HTTP requests\n * Processes both WebSocket upgrades and standard HTTP requests, delegating them to Cloudflare Agents\n */\nexport function agentsMiddleware<E extends Env = Env>(\n  ctx?: AgentMiddlewareContext<E>\n) {\n  return createMiddleware<Env>(async (c, next) => {\n    try {\n      const handler = isWebSocketUpgrade(c)\n        ? handleWebSocketUpgrade\n        : handleHttpRequest;\n\n      const response = await handler(c, ctx?.options);\n\n      return response === null ? await next() : response;\n    } catch (error) {\n      if (ctx?.onError) {\n        ctx.onError(error as Error);\n        return next();\n      }\n      throw error;\n    }\n  });\n}\n\n/**\n * Checks if the incoming request is a WebSocket upgrade request\n * Looks for the 'upgrade' header with a value of 'websocket' (case-insensitive)\n */\nfunction isWebSocketUpgrade(c: Context): boolean {\n  return c.req.header(\"upgrade\")?.toLowerCase() === \"websocket\";\n}\n\n/**\n * Handles WebSocket upgrade requests\n * Returns a WebSocket upgrade response if successful, null otherwise\n */\nasync function handleWebSocketUpgrade<E extends Env>(\n  c: Context<E>,\n  options?: AgentOptions<E>\n) {\n  const response = await routeAgentRequest(\n    c.req.raw,\n    env(c) satisfies Env,\n    options\n  );\n\n  if (!response?.webSocket) {\n    return null;\n  }\n\n  return new Response(null, {\n    status: 101,\n    webSocket: response.webSocket\n  });\n}\n\n/**\n * Handles standard HTTP requests\n * Forwards the request to Cloudflare Agents and returns the response\n */\nasync function handleHttpRequest<E extends Env>(\n  c: Context<E>,\n  options?: AgentOptions<E>\n) {\n  return routeAgentRequest(c.req.raw, env(c) satisfies Env, options);\n}\n"],"mappings":";AACA,SAAS,yBAAyB;AAElC,SAAS,WAAW;AACpB,SAAS,wBAAwB;AAgB1B,SAAS,iBACd,KACA;AACA,SAAO,iBAAsB,OAAO,GAAG,SAAS;AAC9C,QAAI;AACF,YAAM,UAAU,mBAAmB,CAAC,IAChC,yBACA;AAEJ,YAAM,WAAW,MAAM,QAAQ,GAAG,KAAK,OAAO;AAE9C,aAAO,aAAa,OAAO,MAAM,KAAK,IAAI;AAAA,IAC5C,SAAS,OAAO;AACd,UAAI,KAAK,SAAS;AAChB,YAAI,QAAQ,KAAc;AAC1B,eAAO,KAAK;AAAA,MACd;AACA,YAAM;AAAA,IACR;AAAA,EACF,CAAC;AACH;AAMA,SAAS,mBAAmB,GAAqB;AAC/C,SAAO,EAAE,IAAI,OAAO,SAAS,GAAG,YAAY,MAAM;AACpD;AAMA,eAAe,uBACb,GACA,SACA;AACA,QAAM,WAAW,MAAM;AAAA,IACrB,EAAE,IAAI;AAAA,IACN,IAAI,CAAC;AAAA,IACL;AAAA,EACF;AAEA,MAAI,CAAC,UAAU,WAAW;AACxB,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,SAAS,MAAM;AAAA,IACxB,QAAQ;AAAA,IACR,WAAW,SAAS;AAAA,EACtB,CAAC;AACH;AAMA,eAAe,kBACb,GACA,SACA;AACA,SAAO,kBAAkB,EAAE,IAAI,KAAK,IAAI,CAAC,GAAiB,OAAO;AACnE;","names":[]}

package/package.json

@@ -1,45 +1,49 @@
 {
-  "name": "hono-agents",
-  "version": "0.0.0-ff0679f",
-  "main": "src/index.ts",
-  "type": "module",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsx ./scripts/build.ts"
+  "author": "Cloudflare Inc.",
+  "bugs": {
+    "url": "https://github.com/cloudflare/agents/issues"
+  },
+  "description": "Add Cloudflare Agents to your Hono app",
+  "devDependencies": {
+    "agents": "0.0.0-ff9329f",
+    "hono": "^4.9.8"
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
     }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "keywords": [
     "cloudflare",
     "agents",
     "hono"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/cloudflare/agents.git",
-    "directory": "packages/hono-agents"
-  },
-  "bugs": {
-    "url": "https://github.com/cloudflare/agents/issues"
-  },
-  "author": "Cloudflare Inc.",
   "license": "MIT",
-  "description": "Add Cloudflare Agents to your Hono app",
+  "main": "src/index.ts",
+  "name": "hono-agents",
   "peerDependencies": {
-    "agents-sdk": "^0.0.20",
+    "agents": "0.0.0-ff9329f",
     "hono": "^4.6.17"
   },
-  "devDependencies": {
-    "agents-sdk": "^0.0.20",
-    "hono": "^4.6.17"
-  }
+  "repository": {
+    "directory": "packages/hono-agents",
+    "type": "git",
+    "url": "git+https://github.com/cloudflare/agents.git"
+  },
+  "scripts": {
+    "build": "tsx ./scripts/build.ts",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "version": "0.0.0-ff9329f"
 }

package/src/index.ts

@@ -1,9 +1,8 @@
+import type { AgentOptions } from "agents";
+import { routeAgentRequest } from "agents";
+import type { Context, Env } from "hono";
 import { env } from "hono/adapter";
 import { createMiddleware } from "hono/factory";
-import { routeAgentRequest } from "agents-sdk";
-
-import type { Context, Env } from "hono";
-import type { AgentOptions } from "agents-sdk";
 
 /**
  * Configuration options for the Cloudflare Agents middleware
@@ -22,11 +21,12 @@ type AgentMiddlewareContext<E extends Env> = {
 export function agentsMiddleware<E extends Env = Env>(
   ctx?: AgentMiddlewareContext<E>
 ) {
-  return createMiddleware(async (c, next) => {
+  return createMiddleware<Env>(async (c, next) => {
     try {
       const handler = isWebSocketUpgrade(c)
         ? handleWebSocketUpgrade
         : handleHttpRequest;
+
       const response = await handler(c, ctx?.options);
 
       return response === null ? await next() : response;
@@ -48,18 +48,6 @@ function isWebSocketUpgrade(c: Context): boolean {
   return c.req.header("upgrade")?.toLowerCase() === "websocket";
 }
 
-/**
- * Creates a new Request object from the Hono context
- * Preserves the original request's URL, method, headers, and body
- */
-function createRequestFromContext(c: Context) {
-  return new Request(c.req.url, {
-    method: c.req.method,
-    headers: c.req.header(),
-    body: c.req.raw.body,
-  });
-}
-
 /**
  * Handles WebSocket upgrade requests
  * Returns a WebSocket upgrade response if successful, null otherwise
@@ -68,8 +56,11 @@ async function handleWebSocketUpgrade<E extends Env>(
   c: Context<E>,
   options?: AgentOptions<E>
 ) {
-  const req = createRequestFromContext(c);
-  const response = await routeAgentRequest(req, env(c), options);
+  const response = await routeAgentRequest(
+    c.req.raw,
+    env(c) satisfies Env,
+    options
+  );
 
   if (!response?.webSocket) {
     return null;
@@ -77,7 +68,7 @@ async function handleWebSocketUpgrade<E extends Env>(
 
   return new Response(null, {
     status: 101,
-    webSocket: response.webSocket,
+    webSocket: response.webSocket
   });
 }
 
@@ -89,6 +80,5 @@ async function handleHttpRequest<E extends Env>(
   c: Context<E>,
   options?: AgentOptions<E>
 ) {
-  const req = createRequestFromContext(c);
-  return routeAgentRequest(req, env(c), options);
+  return routeAgentRequest(c.req.raw, env(c) satisfies Env, options);
 }