fix changelog

Author: elithrar

src/content/changelog/agents/2025-03-18-npm-i-agents.mdx

@@ -41,39 +41,59 @@ Future updates will be pushed to the new `agents` package, and the older package
 
 We've added a number of big new features to the Agents SDK over the past few weeks, including:
 
-- TODO
-- TODO: you can now set `cors: true` when using `routeAgentRequest` to return permissive default CORS headers to Agent responses.
-- TODO: the regular client now syncs state on the agent (just like the react version)
-- TODO: useAgentChat bug fixes for passing headers/credentials, properly clearing cache on unmount, etc
-- TODO: experiemental /schedule module with a prompt/schema for adding scheduling to your app (with evals!)
+- You can now set `cors: true` when using `routeAgentRequest` to return permissive default CORS headers to Agent responses.
+- Te regular client now syncs state on the agent (just like the React version)
+- `useAgentChat` bug fixes for passing headers/credentials, includng properly clearing cache on unmount.
+- Experimental `/schedule` module with a prompt/schema for adding scheduling to your app (with evals!)
+- Changed the internal `zod` schema to be compatible with the limitations of Google's Gemini models by removing the discriminated union, allowing you to use Gemini models with the scheduling API.
 
 We've also fixed a number of bugs with state synchronization and the React hooks.
 
+<TypeScriptExample>
+
+```ts
+// via https://github.com/cloudflare/agents/tree/main/examples/cross-domain
+export default {
+  async fetch(request: Request, env: Env) {
+    return (
+      // Set { cors: true } to enable CORS headers.
+      (await routeAgentRequest(request, env, { cors: true })) ||
+      new Response("Not found", { status: 404 })
+    );
+  },
+} satisfies ExportedHandler<Env>;
+```
+
+</TypeScriptExample>
+
 #### Call Agent methods from your client code <Badge text="New" variant="tip" size="small" />
 
-We've added a new [`@callable()`](/agents/api-reference/agents-api/) decorator for defining methods that can be called directly from clients. This allows you call methods from within your client code: you can call methods (with arguments) and get native JavaScript objects back.
+We've added a new [`@unstable_callable()`](/agents/api-reference/agents-api/) decorator for defining methods that can be called directly from clients. This allows you call methods from within your client code: you can call methods (with arguments) and get native JavaScript objects back.
 
 <TypeScriptExample>
 
 ```ts
 // server.ts
-import { Agent, callable } from 'agents';
-
-class MyAgent extends Agent {
-	@callable()
-  async getHistory(limit: number = 10): Promise<string[]> {
-  	// Allow a client to directly fetch chat history
-   	return this.state.chatHistory.slice(-limit)
-  }
-}
-
+import { unstable_callable, Agent, type StreamingResponse } from "agents";
+import type { Env } from "../server";
+
+ export class Rpc extends Agent<Env> {
+   // Use the decorator to define a callable method
+   @unstable_callable({
+     description: "rpc test",
+   })
+   async getHistory() {
+     return this.sql`SELECT * FROM history ORDER BY created_at DESC LIMIT 10`;
+   }
+```
+```tsx
 // client.tsx
 const { call } = useAgent({ agent: "rpc" });
 
 const fetchUserHistory = async () => {
     try {
         setLoading(true);
-        // Call methods directly on the Agent
+        // Call methods directly on the Agent!
         const result = await call("getHistory");
         addToast(`RPC result: ${result}`, "success");
     } catch (error) {
@@ -82,18 +102,16 @@ const fetchUserHistory = async () => {
         setLoading(false);
     }
 };
-
 ```
+
 </TypeScriptExample>
 
 #### agents-starter <Badge text="Updated" variant="tip" size="small" />
 
 The [`agents-starter`](https://github.com/cloudflare/agents-starter) project — a real-time, chat-based example application with tool-calling & human-in-the-loop built using the Agents SDK — has seen the following updates:
 
-- TODO
 - Upgraded to use the latest [wrangler v4](/changelog/2025-03-13-wrangler-v4/) release.
 - [Workers AI](/workers-ai/) is now the default AI provider in the [`agents-starter`](https://github.com/cloudflare/agents-starter) project: this uses the new [structured outputs](/changelog/2025-02-25-json-mode/) (or "JSON mode") support now in Workers AI and the [`workers-ai-provider`](https://sdk.vercel.ai/providers/community-providers/cloudflare-workers-ai#generateobject).
-- Changed the internal `zod` schema to be compatible with the limitations of Google's Gemini models, allowing you to use Gemini models with the starter.
 
 If you're new to Agents, you can install and run the `agents-starter` project in two commands:
 
@@ -109,7 +127,7 @@ $ npm run start
 We've heard your feedback on the Agents SDK documentation, and we're shipping more API reference material and usage examples, including:
 
 - Expanded [API reference documentation](/agents/api-reference/), covering the methods and properties exposed by the Agents SDK, as well as more usage examples.
-- More [Client API](/agents/api-reference/agents-api/#client-api) documentation that documents `useAgent`, `useAgentChat` and the new `@callable` RPC decorator exposed by the SDK.
+- More [Client API](/agents/api-reference/agents-api/#client-api) documentation that documents `useAgent`, `useAgentChat` and the new `@unstable_callable` RPC decorator exposed by the SDK.
 - New documentation on how to [call agents](/agents/api-reference/calling-agents/) and (optionally) authenticate clients before they connect to your Agents.
 
 Note that the Agents SDK is continually growing: the type definitions included in the SDK will always include the latest APIs exposed by the `agents` package.