agents 0.21.0 → 0.23.0

package/package.json

@@ -9,16 +9,13 @@
     "durable objects"
   ],
   "type": "module",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "license": "MIT",
   "repository": {
     "directory": "packages/agents",
     "type": "git",
     "url": "git+https://github.com/cloudflare/agents.git"
   },
-  "bin": {
-    "agents": "dist/cli/index.js"
-  },
   "author": "Cloudflare Inc.",
   "bugs": {
     "url": "https://github.com/cloudflare/agents/issues"
@@ -27,26 +24,25 @@
     "@babel/plugin-proposal-decorators": "^8.0.2",
     "@cfworker/json-schema": "^4.1.1",
     "@rolldown/plugin-babel": "^0.2.3",
+    "capnweb": "^0.12.0",
     "cron-schedule": "^6.0.0",
     "esbuild": "^0.28.1",
     "mimetext": "^3.0.28",
     "nanoid": "^5.1.16",
-    "partyserver": "^0.5.9",
     "partysocket": "1.3.0",
-    "yaml": "^2.9.0",
-    "yargs": "^18.0.0"
+    "postal-mime": "^2.7.5",
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@ai-sdk/react": "^4.0.0",
     "@ai-sdk/valibot": "3.0.6",
-    "@cloudflare/codemode": "^0.5.1",
+    "@cloudflare/codemode": "^0.5.2",
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/conformance-v2": "npm:@modelcontextprotocol/conformance@0.2.0-alpha.10",
     "@modelcontextprotocol/sdk": "1.30.0",
     "@modelcontextprotocol/server": "2.0.0",
     "@tanstack/ai": "0.38.0",
     "@types/react": "^19.2.17",
-    "@types/yargs": "^17.0.35",
     "@valibot/to-json-schema": "1.3.0",
     "@x402/core": "^2.17.0",
     "@x402/evm": "^2.17.0",
@@ -55,8 +51,9 @@
     "glob": "^13.0.6",
     "just-bash": "^3.0.2",
     "react": "^19.2.7",
+    "teleproto": "^1.228.5",
     "valibot": "1.4.1",
-    "zod": "^4.4.3"
+    "zod": "^4.5.4"
   },
   "peerDependencies": {
     "@ai-sdk/react": "^3.0.0 || ^4.0.0",
@@ -123,6 +120,36 @@
       "import": "./dist/client.js",
       "require": "./dist/client.js"
     },
+    "./routing": {
+      "types": "./dist/routing/index.d.ts",
+      "import": "./dist/routing/index.js",
+      "require": "./dist/routing/index.js"
+    },
+    "./streams": {
+      "types": "./dist/streams/index.d.ts",
+      "import": "./dist/streams/index.js",
+      "require": "./dist/streams/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.js",
+      "require": "./dist/context/index.js"
+    },
+    "./sessions": {
+      "types": "./dist/sessions/index.d.ts",
+      "import": "./dist/sessions/index.js",
+      "require": "./dist/sessions/index.js"
+    },
+    "./tasks": {
+      "types": "./dist/tasks/index.d.ts",
+      "import": "./dist/tasks/index.js",
+      "require": "./dist/tasks/index.js"
+    },
+    "./lifecycle": {
+      "types": "./dist/lifecycle/index.d.ts",
+      "import": "./dist/lifecycle/index.js",
+      "require": "./dist/lifecycle/index.js"
+    },
     "./agent-tools": {
       "types": "./dist/agent-tools.d.ts",
       "import": "./dist/agent-tools.js",
@@ -139,19 +166,19 @@
       "require": "./dist/mcp/index.js"
     },
     "./mcp/client": {
-      "types": "./dist/mcp/client.d.ts",
-      "import": "./dist/mcp/client.js",
-      "require": "./dist/mcp/client.js"
+      "types": "./dist/mcp/client/index.d.ts",
+      "import": "./dist/mcp/client/index.js",
+      "require": "./dist/mcp/client/index.js"
     },
     "./mcp/server": {
-      "types": "./dist/mcp/server.d.ts",
-      "import": "./dist/mcp/server.js",
-      "require": "./dist/mcp/server.js"
+      "types": "./dist/mcp/server/index.d.ts",
+      "import": "./dist/mcp/server/index.js",
+      "require": "./dist/mcp/server/index.js"
     },
     "./mcp/do-oauth-client-provider": {
-      "types": "./dist/mcp/do-oauth-client-provider.d.ts",
-      "import": "./dist/mcp/do-oauth-client-provider.js",
-      "require": "./dist/mcp/do-oauth-client-provider.js"
+      "types": "./dist/mcp/client/do-oauth-client-provider.d.ts",
+      "import": "./dist/mcp/client/do-oauth-client-provider.js",
+      "require": "./dist/mcp/client/do-oauth-client-provider.js"
     },
     "./observability": {
       "types": "./dist/observability/index.d.ts",
@@ -168,35 +195,40 @@
       "import": "./dist/react.js",
       "require": "./dist/react.js"
     },
+    "./websockets": {
+      "types": "./dist/websockets/index.d.ts",
+      "import": "./dist/websockets/index.js",
+      "require": "./dist/websockets/index.js"
+    },
     "./schedule": {
       "types": "./dist/schedule.d.ts",
       "import": "./dist/schedule.js",
       "require": "./dist/schedule.js"
     },
+    "./schedules": {
+      "types": "./dist/schedules/index.d.ts",
+      "import": "./dist/schedules/index.js",
+      "require": "./dist/schedules/index.js"
+    },
+    "./schedules/parser": {
+      "types": "./dist/schedules/parser.d.ts",
+      "import": "./dist/schedules/parser.js",
+      "require": "./dist/schedules/parser.js"
+    },
     "./workflows": {
       "types": "./dist/workflows.d.ts",
       "import": "./dist/workflows.js",
       "require": "./dist/workflows.js"
     },
-    "./experimental/memory/session": {
-      "types": "./dist/experimental/memory/session/index.d.ts",
-      "import": "./dist/experimental/memory/session/index.js",
-      "require": "./dist/experimental/memory/session/index.js"
-    },
-    "./experimental/memory/utils": {
-      "types": "./dist/experimental/memory/utils/index.d.ts",
-      "import": "./dist/experimental/memory/utils/index.js",
-      "require": "./dist/experimental/memory/utils/index.js"
-    },
     "./experimental/webmcp": {
       "types": "./dist/experimental/webmcp.d.ts",
       "import": "./dist/experimental/webmcp.js",
       "require": "./dist/experimental/webmcp.js"
     },
     "./x402": {
-      "types": "./dist/mcp/x402.d.ts",
-      "import": "./dist/mcp/x402.js",
-      "require": "./dist/mcp/x402.js"
+      "types": "./dist/mcp/client/x402.d.ts",
+      "import": "./dist/mcp/client/x402.js",
+      "require": "./dist/mcp/client/x402.js"
     },
     "./chat": {
       "types": "./dist/chat/index.d.ts",
@@ -258,6 +290,81 @@
       "import": "./dist/browser/tanstack-ai.js",
       "require": "./dist/browser/tanstack-ai.js"
     },
+    "./voice": {
+      "types": "./dist/voice/index.d.ts",
+      "import": "./dist/voice/index.js",
+      "require": "./dist/voice/index.js"
+    },
+    "./voice/types": {
+      "types": "./dist/voice/types.d.ts",
+      "import": "./dist/voice/types.js",
+      "require": "./dist/voice/types.js"
+    },
+    "./voice/client": {
+      "types": "./dist/voice/client.d.ts",
+      "import": "./dist/voice/client.js",
+      "require": "./dist/voice/client.js"
+    },
+    "./voice/react": {
+      "types": "./dist/voice/react.d.ts",
+      "import": "./dist/voice/react.js",
+      "require": "./dist/voice/react.js"
+    },
+    "./voice/errors": {
+      "types": "./dist/voice/errors.d.ts",
+      "import": "./dist/voice/errors.js",
+      "require": "./dist/voice/errors.js"
+    },
+    "./voice/workers-ai": {
+      "types": "./dist/voice/workers-ai.d.ts",
+      "import": "./dist/voice/workers-ai.js",
+      "require": "./dist/voice/workers-ai.js"
+    },
+    "./voice/sfu": {
+      "types": "./dist/voice/sfu.d.ts",
+      "import": "./dist/voice/sfu.js",
+      "require": "./dist/voice/sfu.js"
+    },
+    "./voice/text": {
+      "types": "./dist/voice/text.d.ts",
+      "import": "./dist/voice/text.js",
+      "require": "./dist/voice/text.js"
+    },
+    "./channels": {
+      "types": "./dist/channels/index.d.ts",
+      "import": "./dist/channels/index.js",
+      "require": "./dist/channels/index.js"
+    },
+    "./channels/email": {
+      "types": "./dist/channels/email.d.ts",
+      "import": "./dist/channels/email.js",
+      "require": "./dist/channels/email.js"
+    },
+    "./channels/slack": {
+      "types": "./dist/channels/slack.d.ts",
+      "import": "./dist/channels/slack.js",
+      "require": "./dist/channels/slack.js"
+    },
+    "./channels/telegram": {
+      "types": "./dist/channels/telegram.d.ts",
+      "import": "./dist/channels/telegram.js",
+      "require": "./dist/channels/telegram.js"
+    },
+    "./channels/voice": {
+      "types": "./dist/channels/voice.d.ts",
+      "import": "./dist/channels/voice.js",
+      "require": "./dist/channels/voice.js"
+    },
+    "./channels/ai-sdk": {
+      "types": "./dist/channels/ai-sdk.d.ts",
+      "import": "./dist/channels/ai-sdk.js",
+      "require": "./dist/channels/ai-sdk.js"
+    },
+    "./channels/tanstack-ai": {
+      "types": "./dist/channels/tanstack-ai.d.ts",
+      "import": "./dist/channels/tanstack-ai.js",
+      "require": "./dist/channels/tanstack-ai.js"
+    },
     "./tsconfig": "./agents.tsconfig.json",
     "./vite": {
       "types": "./dist/vite.d.ts",
@@ -308,8 +415,12 @@
     "build": "tsx ./scripts/build.ts",
     "evals": "(cd evals; evalite)",
     "test": "vitest --run",
-    "test:cli": "vitest --project cli",
+    "test:node": "vitest --project node",
     "test:react": "vitest --project react",
+    "test:voice:workers": "vitest --project voice-workers",
+    "test:voice:react": "vitest --project voice-react",
+    "test:channels": "vitest --project channels",
+    "test:channels:live": "vitest --run -c src/channels/vitest.live.config.ts",
     "test:browser": "vitest run --config src/browser-tests/vitest.config.ts",
     "test:workers": "vitest --project workers",
     "test:chat": "vitest --project chat",

package/dist/cli/index.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-//#region src/cli/create.ts
-function createCli(argv = process.argv) {
-	return yargs(hideBin(argv)).scriptName("agents").usage("$0 <command> [options]").command(["init", "create"], "Initialize an agents project", (cmd) => cmd, async () => {
-		console.log("agents init: not implemented yet");
-		process.exit(0);
-	}).command("dev", "Start development server", (cmd) => cmd, async () => {
-		console.log("agents dev: not implemented yet");
-		process.exit(0);
-	}).command("deploy", "Deploy agents to Cloudflare", (cmd) => cmd, async () => {
-		console.log("agents deploy: not implemented yet");
-		process.exit(0);
-	}).command("mcp", "The agents mcp server", (cmd) => cmd, async () => {
-		console.log("agents mcp: not implemented yet");
-		process.exit(0);
-	}).demandCommand(1, "Please provide a command").strict().help();
-}
-//#endregion
-//#region src/cli/index.ts
-createCli().parse();
-//#endregion
-export {};
-
-//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/cli/create.ts","../../src/cli/index.ts"],"sourcesContent":["import yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\n\nexport function createCli(argv = process.argv) {\n  return yargs(hideBin(argv))\n    .scriptName(\"agents\")\n    .usage(\"$0 <command> [options]\")\n    .command(\n      [\"init\", \"create\"],\n      \"Initialize an agents project\",\n      (cmd) => cmd,\n      async () => {\n        console.log(\"agents init: not implemented yet\");\n        process.exit(0);\n      }\n    )\n    .command(\n      \"dev\",\n      \"Start development server\",\n      (cmd) => cmd,\n      async () => {\n        console.log(\"agents dev: not implemented yet\");\n        process.exit(0);\n      }\n    )\n    .command(\n      \"deploy\",\n      \"Deploy agents to Cloudflare\",\n      (cmd) => cmd,\n      async () => {\n        console.log(\"agents deploy: not implemented yet\");\n        process.exit(0);\n      }\n    )\n    .command(\n      \"mcp\",\n      \"The agents mcp server\",\n      (cmd) => cmd,\n      async () => {\n        console.log(\"agents mcp: not implemented yet\");\n        process.exit(0);\n      }\n    )\n    .demandCommand(1, \"Please provide a command\")\n    .strict()\n    .help();\n}\n","#!/usr/bin/env node\n\nimport { createCli } from \"./create\";\n\nvoid createCli().parse();\n"],"mappings":";;;;AAGA,SAAgB,UAAU,OAAO,QAAQ,MAAM;CAC7C,OAAO,MAAM,QAAQ,IAAI,CAAC,CAAC,CACxB,WAAW,QAAQ,CAAC,CACpB,MAAM,wBAAwB,CAAC,CAC/B,QACC,CAAC,QAAQ,QAAQ,GACjB,iCACC,QAAQ,KACT,YAAY;EACV,QAAQ,IAAI,kCAAkC;EAC9C,QAAQ,KAAK,CAAC;CAChB,CACF,CAAC,CACA,QACC,OACA,6BACC,QAAQ,KACT,YAAY;EACV,QAAQ,IAAI,iCAAiC;EAC7C,QAAQ,KAAK,CAAC;CAChB,CACF,CAAC,CACA,QACC,UACA,gCACC,QAAQ,KACT,YAAY;EACV,QAAQ,IAAI,oCAAoC;EAChD,QAAQ,KAAK,CAAC;CAChB,CACF,CAAC,CACA,QACC,OACA,0BACC,QAAQ,KACT,YAAY;EACV,QAAQ,IAAI,iCAAiC;EAC7C,QAAQ,KAAK,CAAC;CAChB,CACF,CAAC,CACA,cAAc,GAAG,0BAA0B,CAAC,CAC5C,OAAO,CAAC,CACR,KAAK;AACV;;;AC1CK,UAAU,CAAC,CAAC,MAAM"}

package/dist/client-invoker-VNZ7X0nn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-invoker-VNZ7X0nn.js","names":[],"sources":["../src/mcp/client-invoker.ts"],"sourcesContent":["import type {\n  CallToolRequest,\n  CallToolRequestOptions,\n  CallToolResult,\n  Client,\n  ListToolsResult\n} from \"@modelcontextprotocol/client\";\nimport type { Client as LegacyClient } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport type {\n  CallToolResult as LegacyCallToolResult,\n  CallToolResultSchema,\n  CompatibilityCallToolResultSchema,\n  ListToolsRequest\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { RequestOptions as LegacyRequestOptions } from \"@modelcontextprotocol/sdk/shared/protocol.js\";\n\nexport type LegacyCallToolResultSchema =\n  | typeof CallToolResultSchema\n  | typeof CompatibilityCallToolResultSchema;\n\nexport type CallToolSchemaOrOptions =\n  | LegacyCallToolResultSchema\n  | CallToolRequestOptions;\n\nexport type CompatibleMcpClient = Client | LegacyClient;\n\nexport interface BoundMcpClientInvoker {\n  listTools(\n    params?: ListToolsRequest[\"params\"],\n    options?: CallToolRequestOptions\n  ): Promise<ListToolsResult>;\n  callTool(\n    params: CallToolRequest[\"params\"],\n    schemaOrOptions?: CallToolSchemaOrOptions,\n    options?: CallToolRequestOptions\n  ): Promise<LegacyCallToolResult>;\n}\n\nfunction isLegacyResultSchema(\n  value: CallToolSchemaOrOptions | undefined\n): value is LegacyCallToolResultSchema {\n  return (\n    typeof (value as { parse?: unknown } | undefined)?.parse === \"function\"\n  );\n}\n\nfunction normalizeCallToolArguments(\n  schemaOrOptions?: CallToolSchemaOrOptions,\n  options?: CallToolRequestOptions\n): {\n  schema?: LegacyCallToolResultSchema;\n  options?: CallToolRequestOptions;\n} {\n  return isLegacyResultSchema(schemaOrOptions)\n    ? { schema: schemaOrOptions, options }\n    : { options: schemaOrOptions ?? options };\n}\n\n/**\n * Invoke SDK v2 while preserving the deprecated v1 result-schema overload.\n * The v2 request funnel still owns decoding and automatic MRTR.\n */\nexport function callV2Tool(\n  client: Client,\n  params: CallToolRequest[\"params\"],\n  schemaOrOptions?: CallToolSchemaOrOptions,\n  options?: CallToolRequestOptions\n): Promise<CallToolResult> {\n  const normalized = normalizeCallToolArguments(schemaOrOptions, options);\n  if (normalized.schema) {\n    return client.request(\n      { method: \"tools/call\", params },\n      normalized.schema as never,\n      normalized.options\n    ) as Promise<CallToolResult>;\n  }\n  return client.callTool(params, normalized.options);\n}\n\n/**\n * Bind the original methods before decorators such as x402 replace them. All\n * generation-specific calling conventions stay behind this small interface.\n */\nexport function bindMcpClient(\n  client: CompatibleMcpClient\n): BoundMcpClientInvoker {\n  const isV2 =\n    \"getProtocolEra\" in client &&\n    typeof (client as { getProtocolEra?: unknown }).getProtocolEra ===\n      \"function\";\n\n  if (isV2) {\n    const v2Client = client as Client;\n    const listTools = v2Client.listTools.bind(v2Client);\n    const callTool = v2Client.callTool.bind(v2Client);\n    return {\n      listTools: (params, options) => listTools(params, options),\n      callTool: (params, schemaOrOptions, options) => {\n        const normalized = normalizeCallToolArguments(schemaOrOptions, options);\n        const pending = normalized.schema\n          ? v2Client.request(\n              { method: \"tools/call\", params },\n              normalized.schema as never,\n              normalized.options\n            )\n          : callTool(params, normalized.options);\n        return pending as Promise<LegacyCallToolResult>;\n      }\n    };\n  }\n\n  const legacy = client as LegacyClient;\n  const listTools = legacy.listTools.bind(legacy);\n  const callTool = legacy.callTool.bind(legacy);\n  return {\n    listTools: (params, options) =>\n      listTools(\n        params,\n        options as LegacyRequestOptions\n      ) as Promise<ListToolsResult>,\n    callTool: (params, schemaOrOptions, options) => {\n      const normalized = normalizeCallToolArguments(schemaOrOptions, options);\n      return callTool(\n        params as Parameters<LegacyClient[\"callTool\"]>[0],\n        normalized.schema,\n        normalized.options as LegacyRequestOptions\n      ) as Promise<LegacyCallToolResult>;\n    }\n  };\n}\n"],"mappings":";AAsCA,SAAS,qBACP,OACqC;CACrC,OACE,OAAQ,OAA2C,UAAU;AAEjE;AAEA,SAAS,2BACP,iBACA,SAIA;CACA,OAAO,qBAAqB,eAAe,IACvC;EAAE,QAAQ;EAAiB;CAAQ,IACnC,EAAE,SAAS,mBAAmB,QAAQ;AAC5C;;;;;AAMA,SAAgB,WACd,QACA,QACA,iBACA,SACyB;CACzB,MAAM,aAAa,2BAA2B,iBAAiB,OAAO;CACtE,IAAI,WAAW,QACb,OAAO,OAAO,QACZ;EAAE,QAAQ;EAAc;CAAO,GAC/B,WAAW,QACX,WAAW,OACb;CAEF,OAAO,OAAO,SAAS,QAAQ,WAAW,OAAO;AACnD;;;;;AAMA,SAAgB,cACd,QACuB;CAMvB,IAJE,oBAAoB,UACpB,OAAQ,OAAwC,mBAC9C,YAEM;EACR,MAAM,WAAW;EACjB,MAAM,YAAY,SAAS,UAAU,KAAK,QAAQ;EAClD,MAAM,WAAW,SAAS,SAAS,KAAK,QAAQ;EAChD,OAAO;GACL,YAAY,QAAQ,YAAY,UAAU,QAAQ,OAAO;GACzD,WAAW,QAAQ,iBAAiB,YAAY;IAC9C,MAAM,aAAa,2BAA2B,iBAAiB,OAAO;IAQtE,OAPgB,WAAW,SACvB,SAAS,QACP;KAAE,QAAQ;KAAc;IAAO,GAC/B,WAAW,QACX,WAAW,OACb,IACA,SAAS,QAAQ,WAAW,OAAO;GAEzC;EACF;CACF;CAEA,MAAM,SAAS;CACf,MAAM,YAAY,OAAO,UAAU,KAAK,MAAM;CAC9C,MAAM,WAAW,OAAO,SAAS,KAAK,MAAM;CAC5C,OAAO;EACL,YAAY,QAAQ,YAClB,UACE,QACA,OACF;EACF,WAAW,QAAQ,iBAAiB,YAAY;GAC9C,MAAM,aAAa,2BAA2B,iBAAiB,OAAO;GACtE,OAAO,SACL,QACA,WAAW,QACX,WAAW,OACb;EACF;CACF;AACF"}