agents 0.20.1 → 0.22.0

package/docs/server-driven-messages.md

@@ -457,7 +457,7 @@ Pre-aborted signals short-circuit before any model work runs.
 ### Limitations
 
 - **Signals cannot cross Durable Object boundaries.** `AbortSignal` is not an RPC-serializable type. Construct the controller inside the DO that calls `saveMessages`. For Think child-agent orchestration, use [Agent Tools](./agent-tools.md); `runAgentTool()` bridges parent aborts into the child run. For lower-level custom RPC, return a `ReadableStream` from the child and let the parent cancel it — workerd propagates the cancel back to the source's `cancel` callback.
-- **Hibernation drops the listener.** The signal lives in memory. If the DO hibernates mid-turn and `chatRecovery` is enabled, the recovered turn usually calls `continueLastTurn()` internally without the original signal — an abort fired after restart has no effect on the recovered turn. For pre-stream interruptions, recovery can instead retry the latest unanswered user message automatically. This is true for top-level agents and sub-agents; sub-agent recovery still works, but the original caller's in-memory signal is gone. Override `onChatRecovery` (Think) or set `chatRecovery = false` for callers that need stronger guarantees.
+- **Hibernation drops the listener.** The signal lives in memory. After the DO restarts, durable recovery usually calls `continueLastTurn()` without the original signal, so an abort fired after restart has no effect. For pre-stream interruptions, recovery can instead retry the latest unanswered user message automatically. This is true for top-level agents and sub-agents. If cancellation must survive restart, persist the cancellation intent in agent state or SQL, check it in `onChatRecovery()`, and return `{ continue: false }`. Durable recovery cannot be disabled.
 
 This is the integration point for agent-tool orchestration where the parent's AI SDK abort signal needs to propagate into a child DO's `saveMessages` call. See [`cloudflare/agents#1406`](https://github.com/cloudflare/agents/issues/1406) for the original use case.
 

package/docs/sub-agents.md

@@ -273,7 +273,52 @@ const chat = useAgent({
 
 Every other `useAgent` feature works as usual: `state` sync, `stub.method()` calls, `@callable` RPCs, `useAgentChat` on top of the returned socket.
 
-### Direct HTTP / custom routing
+### Direct HTTP and WebSocket URLs
+
+Use `buildAgentPath()` to turn a root-first Agent identity into the canonical URL pathname used by both HTTP requests and WebSocket connections:
+
+```typescript
+import { buildAgentPath } from "agents";
+
+const path = buildAgentPath(
+  [
+    { className: "Inbox", name: userId },
+    { className: "Chat", name: chatId }
+  ],
+  { leafPath: "/callbacks/job" }
+);
+
+// /agents/inbox/{userId}/sub/chat/{chatId}/callbacks/job
+```
+
+Inside an Agent, pass `this.selfPath` directly. If the root Durable Object binding name differs from its class name, also pass `rootBinding` in the options. `buildAgentUrl()` adds a public origin, which is useful when registering callbacks, webhooks, approval URLs, or asynchronous job-completion URLs with an external system:
+
+```typescript
+import { buildAgentUrl } from "agents";
+
+export class Chat extends Agent<Env> {
+  callbackUrl() {
+    return buildAgentUrl(this.env.PUBLIC_ORIGIN, this.selfPath, {
+      leafPath: "/callbacks/job"
+    });
+  }
+
+  override async onRequest(request: Request) {
+    if (new URL(request.url).pathname === "/callbacks/job") {
+      return this.handleJobCallback(request);
+    }
+    return new Response("Not found", { status: 404 });
+  }
+}
+```
+
+The Worker must pass the incoming request to `routeAgentRequest()`. Each ancestor's `onBeforeSubAgent` hook runs before the destination receives the request. For a sub-agent destination, the nested `/sub/...` routing segments are removed during forwarding, so its pathname is the `leafPath` suffix.
+
+`buildAgentUrl()` accepts an HTTP(S) or WS(S) origin without a pathname, query, fragment, or credentials. Set callback query parameters through the returned URL's `searchParams`. If you use a custom routing prefix, pass the same value to both `buildAgentPath()` and `routeAgentRequest()`.
+
+Root Agent names follow `routeAgentRequest`'s raw pathname-segment behavior and must already be externally routable. The `sub` segment is reserved in routing prefixes, class and binding names, and root Agent names. Descendant names are URL-encoded by the helper, so names containing spaces, Unicode, `/`, or URL-reserved characters round-trip safely.
+
+### Custom routing
 
 For fetch handlers that do their own top-level URL parsing, use `routeSubAgentRequest` to dispatch a request into a sub-agent from an already-resolved parent stub:
 
@@ -293,7 +338,7 @@ export default {
 };
 ```
 
-`fromPath` takes the sub-agent tail (something like `/sub/chat/chat-abc/...`). The helper parses it, runs the parent's `onBeforeSubAgent` hook, and forwards into the facet.
+`fromPath` takes any pathname containing the sub-agent tail (something like `/sub/chat/chat-abc/...`). When the destination is already represented as a root-first Agent path, pass the result of `buildAgentPath()` directly. The helper parses the first child hop, runs the parent's `onBeforeSubAgent` hook, and forwards into the facet.
 
 ### External typed RPC
 

package/docs/webhooks.md

@@ -7,56 +7,54 @@ Receive webhook events from external services and route them to dedicated agent
 ```typescript
 import { Agent, getAgentByName, routeAgentRequest } from "agents";
 
-// Agent that handles webhooks for a specific entity
+type GitHubWebhookPayload = {
+  repository?: { full_name?: string };
+};
+
+async function verifyGitHubWebhook(
+  rawBody: string,
+  signature: string | null,
+  secret: string
+): Promise<boolean> {
+  if (!signature || !/^sha256=[0-9a-f]{64}$/i.test(signature)) return false;
+
+  const encoder = new TextEncoder();
+  const key = await crypto.subtle.importKey(
+    "raw",
+    encoder.encode(secret),
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["verify"]
+  );
+  const signatureBytes = Uint8Array.from(
+    signature.slice("sha256=".length).match(/.{2}/g) ?? [],
+    (byte) => Number.parseInt(byte, 16)
+  );
+
+  return crypto.subtle.verify(
+    "HMAC",
+    key,
+    signatureBytes,
+    encoder.encode(rawBody)
+  );
+}
+
 export class WebhookAgent extends Agent<Env> {
   async onRequest(request: Request): Promise<Response> {
     if (request.method !== "POST") {
       return new Response("Method not allowed", { status: 405 });
     }
 
-    // Verify the webhook signature
+    const rawBody = await request.text();
     const signature = request.headers.get("X-Hub-Signature-256");
-    const body = await request.text();
-
     if (
-      !(await this.verifySignature(body, signature, this.env.WEBHOOK_SECRET))
+      !(await verifyGitHubWebhook(rawBody, signature, this.env.WEBHOOK_SECRET))
     ) {
       return new Response("Invalid signature", { status: 401 });
     }
 
-    // Process the webhook payload
-    const payload = JSON.parse(body);
-    await this.processEvent(payload);
-
-    return new Response("OK", { status: 200 });
-  }
-
-  private async verifySignature(
-    payload: string,
-    signature: string | null,
-    secret: string
-  ): Promise<boolean> {
-    if (!signature) return false;
-
-    const encoder = new TextEncoder();
-    const key = await crypto.subtle.importKey(
-      "raw",
-      encoder.encode(secret),
-      { name: "HMAC", hash: "SHA-256" },
-      false,
-      ["sign"]
-    );
-
-    const signatureBytes = await crypto.subtle.sign(
-      "HMAC",
-      key,
-      encoder.encode(payload)
-    );
-    const expected = `sha256=${Array.from(new Uint8Array(signatureBytes))
-      .map((b) => b.toString(16).padStart(2, "0"))
-      .join("")}`;
-
-    return signature === expected;
+    await this.processEvent(JSON.parse(rawBody));
+    return new Response("OK");
   }
 
   private async processEvent(payload: unknown) {
@@ -64,19 +62,30 @@ export class WebhookAgent extends Agent<Env> {
   }
 }
 
-// Route webhooks to the right agent instance
 export default {
   async fetch(request: Request, env: Env): Promise<Response> {
     const url = new URL(request.url);
 
-    // Webhook endpoint: POST /webhooks/:entityId
-    if (url.pathname.startsWith("/webhooks/") && request.method === "POST") {
-      const entityId = url.pathname.split("/")[2];
-      const agent = await getAgentByName(env.WebhookAgent, entityId);
+    if (url.pathname === "/webhooks/github" && request.method === "POST") {
+      const rawBody = await request.clone().text();
+      const signature = request.headers.get("X-Hub-Signature-256");
+      if (
+        !(await verifyGitHubWebhook(rawBody, signature, env.WEBHOOK_SECRET))
+      ) {
+        return new Response("Invalid signature", { status: 401 });
+      }
+
+      const payload = JSON.parse(rawBody) as GitHubWebhookPayload;
+      const repository = payload.repository?.full_name;
+      if (!repository) {
+        return new Response("Missing repository", { status: 400 });
+      }
+
+      const agentName = repository.toLowerCase().replace(/\//g, "-");
+      const agent = await getAgentByName(env.WebhookAgent, agentName);
       return agent.fetch(request);
     }
 
-    // Default routing for WebSocket connections
     return (
       (await routeAgentRequest(request, env)) ||
       new Response("Not found", { status: 404 })
@@ -131,7 +140,7 @@ Webhooks combined with agents enable powerful patterns where each external entit
 
 ## Routing Webhooks to Agents
 
-The key pattern is extracting an entity identifier from the webhook and using `getAgentByName()` to route to a dedicated agent instance.
+The key pattern is verifying the raw request before parsing it, then deriving the Agent identity from authenticated payload data. A body signature does not authenticate an unrelated URL segment or arbitrary header.
 
 ### Extract Entity from Payload
 
@@ -140,19 +149,23 @@ Most webhooks include an identifier in the payload:
 ```typescript
 export default {
   async fetch(request: Request, env: Env): Promise<Response> {
+    const url = new URL(request.url);
     if (request.method === "POST" && url.pathname === "/webhooks/github") {
-      const payload = await request.clone().json();
+      const rawBody = await request.clone().text();
+      const signature = request.headers.get("X-Hub-Signature-256");
+      if (
+        !(await verifyGitHubWebhook(rawBody, signature, env.WEBHOOK_SECRET))
+      ) {
+        return new Response("Invalid signature", { status: 401 });
+      }
 
-      // Extract entity ID from payload
-      const repoFullName = payload.repository?.full_name;
-      if (!repoFullName) {
+      const payload = JSON.parse(rawBody) as GitHubWebhookPayload;
+      const repository = payload.repository?.full_name;
+      if (!repository) {
         return new Response("Missing repository", { status: 400 });
       }
 
-      // Sanitize for use as agent name
-      const agentName = repoFullName.toLowerCase().replace(/\//g, "-");
-
-      // Route to dedicated agent
+      const agentName = repository.toLowerCase().replace(/\//g, "-");
       const agent = await getAgentByName(env.RepoAgent, agentName);
       return agent.fetch(request);
     }
@@ -160,69 +173,21 @@ export default {
 };
 ```
 
-### Extract Entity from URL
-
-Alternatively, include the entity ID in the webhook URL:
-
-```typescript
-// Webhook URL: https://your-worker.dev/webhooks/stripe/cus_123456
-if (url.pathname.startsWith("/webhooks/stripe/")) {
-  const customerId = url.pathname.split("/")[3]; // "cus_123456"
-  const agent = await getAgentByName(env.StripeAgent, customerId);
-  return agent.fetch(request);
-}
-```
+### Validate Entity IDs in URLs
 
-### Extract Entity from Headers
+A provider's body signature does not authenticate the webhook URL. If the URL includes an entity ID, compare it with the corresponding identity from the verified provider payload and reject a mismatch before calling `getAgentByName()`.
 
-Some services include identifiers in headers:
+### Derive Slack Identity from the Verified Body
 
-```typescript
-// Slack sends workspace info in headers
-const teamId = request.headers.get("X-Slack-Team-Id");
-if (teamId) {
-  const agent = await getAgentByName(env.SlackAgent, teamId);
-  return agent.fetch(request);
-}
-```
+Slack does not send an authenticated `X-Slack-Team-Id` routing header. Validate Slack's timestamped signature and replay window against the raw body, then read `team_id` from the verified event or form body.
 
 ## Signature Verification
 
-Always verify webhook signatures to ensure requests are authentic. Most providers use HMAC-SHA256.
+Always verify webhook signatures before trusting or processing the payload.
 
-### HMAC-SHA256 Pattern
+### GitHub HMAC-SHA256 Pattern
 
-```typescript
-async function verifySignature(
-  payload: string,
-  signature: string | null,
-  secret: string
-): Promise<boolean> {
-  if (!signature) return false;
-
-  const encoder = new TextEncoder();
-  const key = await crypto.subtle.importKey(
-    "raw",
-    encoder.encode(secret),
-    { name: "HMAC", hash: "SHA-256" },
-    false,
-    ["sign"]
-  );
-
-  const signatureBytes = await crypto.subtle.sign(
-    "HMAC",
-    key,
-    encoder.encode(payload)
-  );
-
-  const expected = `sha256=${Array.from(new Uint8Array(signatureBytes))
-    .map((b) => b.toString(16).padStart(2, "0"))
-    .join("")}`;
-
-  // Use timing-safe comparison in production
-  return signature === expected;
-}
-```
+The Quick Start's `verifyGitHubWebhook()` helper verifies GitHub's `sha256=<hex>` signature over the raw body with `crypto.subtle.verify()`. This format is GitHub-specific. Other providers use different signature encodings, signed inputs, timestamp checks, and replay protections; follow the provider documentation linked under [Common Webhook Providers](#common-webhook-providers).
 
 ### Provider-Specific Headers
 
@@ -238,7 +203,7 @@ async function verifySignature(
 
 ### The onRequest Handler
 
-Use `onRequest()` to handle incoming webhooks in your agent:
+Use `onRequest()` to handle incoming webhooks in your agent. If the Worker has not already verified the request, verify it before parsing the body. This example reuses the Quick Start's `verifyGitHubWebhook()` helper:
 
 ```typescript
 export class WebhookAgent extends Agent<Env, MyState> {
@@ -248,14 +213,16 @@ export class WebhookAgent extends Agent<Env, MyState> {
       return new Response("Method not allowed", { status: 405 });
     }
 
-    // 2. Get event type from headers
-    const eventType = request.headers.get("X-Event-Type");
+    // 2. Get the GitHub event type
+    const eventType = request.headers.get("X-GitHub-Event") ?? "unknown";
 
-    // 3. Verify signature
-    const signature = request.headers.get("X-Signature");
+    // 3. Verify the GitHub signature
+    const signature = request.headers.get("X-Hub-Signature-256");
     const body = await request.text();
 
-    if (!(await this.verifySignature(body, signature))) {
+    if (
+      !(await verifyGitHubWebhook(body, signature, this.env.WEBHOOK_SECRET))
+    ) {
       return new Response("Invalid signature", { status: 401 });
     }
 
@@ -462,35 +429,41 @@ fibers retain status, dedupe provider retries, and let `onFiberRecovered()` or
 
 ### Multi-Provider Routing
 
-Handle webhooks from multiple services in one worker:
+Keep provider-specific verification and parsing behind one typed seam. Its implementation must validate the raw request according to the provider documentation linked under [Common Webhook Providers](#common-webhook-providers), then derive `agentName` only from the verified body.
 
 ```typescript
+type VerifiedWebhook =
+  | { provider: "github"; agentName: string }
+  | { provider: "stripe"; agentName: string }
+  | { provider: "slack"; agentName: string };
+
+declare function verifyAndParseWebhook(
+  request: Request,
+  env: Env
+): Promise<VerifiedWebhook | null>;
+
 export default {
   async fetch(request: Request, env: Env): Promise<Response> {
     const url = new URL(request.url);
-
-    if (request.method === "POST") {
-      // GitHub webhooks
-      if (url.pathname.startsWith("/webhooks/github/")) {
-        const payload = await request.clone().json();
-        const repoName = payload.repository?.full_name?.replace("/", "-");
-        const agent = await getAgentByName(env.GitHubAgent, repoName);
-        return agent.fetch(request);
-      }
-
-      // Stripe webhooks
-      if (url.pathname.startsWith("/webhooks/stripe/")) {
-        const payload = await request.clone().json();
-        const customerId = payload.data?.object?.customer;
-        const agent = await getAgentByName(env.StripeAgent, customerId);
-        return agent.fetch(request);
+    if (request.method === "POST" && url.pathname.startsWith("/webhooks/")) {
+      const verified = await verifyAndParseWebhook(request.clone(), env);
+      if (!verified) {
+        return new Response("Invalid signature", { status: 401 });
       }
 
-      // Slack webhooks
-      if (url.pathname === "/webhooks/slack") {
-        const teamId = request.headers.get("X-Slack-Team-Id");
-        const agent = await getAgentByName(env.SlackAgent, teamId);
-        return agent.fetch(request);
+      switch (verified.provider) {
+        case "github":
+          return (
+            await getAgentByName(env.GitHubAgent, verified.agentName)
+          ).fetch(request);
+        case "stripe":
+          return (
+            await getAgentByName(env.StripeAgent, verified.agentName)
+          ).fetch(request);
+        case "slack":
+          return (
+            await getAgentByName(env.SlackAgent, verified.agentName)
+          ).fetch(request);
       }
     }
 

package/docs/workflows.md

@@ -246,7 +246,11 @@ const instanceId = await this.runWorkflow(
   {
     id: "custom-id", // optional - auto-generated if not provided
     metadata: { userId: "user-456", priority: "high" }, // optional - for querying
-    agentBinding: "MyAgent" // optional - auto-detected from class name if not provided
+    agentBinding: "MyAgent", // optional - auto-detected from class name if not provided
+    retention: {
+      successRetention: "1 day",
+      errorRetention: "7 days"
+    }
   }
 );
 ```
@@ -258,6 +262,10 @@ const instanceId = await this.runWorkflow(
 - `options.id` - Custom workflow ID (auto-generated if not provided)
 - `options.metadata` - Optional metadata stored for querying (not passed to workflow)
 - `options.agentBinding` - Agent binding name (auto-detected from class name if not provided). When called from a sub-agent, this is the root Agent binding name.
+- [`options.retention`](https://developers.cloudflare.com/workflows/build/workers-api/#workflowinstancecreateoptions) - Workflow retention passed unchanged to
+  `Workflow.create()`.
+  Use `successRetention` for successful instances and `errorRetention` for
+  errored or terminated instances.
 
 **Returns:** Workflow instance ID
 

package/package.json

@@ -9,16 +9,13 @@
     "durable objects"
   ],
   "type": "module",
-  "version": "0.20.1",
+  "version": "0.22.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"
@@ -31,13 +28,12 @@
     "esbuild": "^0.28.1",
     "mimetext": "^3.0.28",
     "nanoid": "^5.1.16",
-    "partyserver": "^0.5.8",
     "partysocket": "1.3.0",
-    "yaml": "^2.9.0",
-    "yargs": "^18.0.0"
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@ai-sdk/react": "^4.0.0",
+    "@ai-sdk/valibot": "3.0.6",
     "@cloudflare/codemode": "^0.5.1",
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/conformance-v2": "npm:@modelcontextprotocol/conformance@0.2.0-alpha.10",
@@ -45,8 +41,7 @@
     "@modelcontextprotocol/server": "2.0.0",
     "@tanstack/ai": "0.38.0",
     "@types/react": "^19.2.17",
-    "@types/yargs": "^17.0.35",
-    "@vitest/browser-playwright": "^4.1.9",
+    "@valibot/to-json-schema": "1.3.0",
     "@x402/core": "^2.17.0",
     "@x402/evm": "^2.17.0",
     "ai": "^7.0.0",
@@ -54,7 +49,7 @@
     "glob": "^13.0.6",
     "just-bash": "^3.0.2",
     "react": "^19.2.7",
-    "vitest-browser-react": "^2.2.0",
+    "valibot": "1.4.1",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
@@ -98,6 +93,9 @@
     "just-bash": {
       "optional": true
     },
+    "react": {
+      "optional": true
+    },
     "vite": {
       "optional": true
     }
@@ -119,6 +117,11 @@
       "import": "./dist/client.js",
       "require": "./dist/client.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",
@@ -135,19 +138,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",
@@ -169,6 +172,16 @@
       "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",
@@ -190,15 +203,20 @@
       "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",
       "import": "./dist/chat/index.js",
       "require": "./dist/chat/index.js"
     },
+    "./chat/transport": {
+      "types": "./dist/chat/transport.d.ts",
+      "import": "./dist/chat/transport.js",
+      "require": "./dist/chat/transport.js"
+    },
     "./chat/react": {
       "types": "./dist/chat/react.d.ts",
       "import": "./dist/chat/react.js",
@@ -299,7 +317,7 @@
     "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:browser": "vitest run --config src/browser-tests/vitest.config.ts",
     "test:workers": "vitest --project workers",

package/dist/cli/index.d.ts

@@ -1 +0,0 @@
-export {};

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"}