changelog headers / order

Author: elithrar

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

@@ -9,7 +9,7 @@ date: 2025-03-17T14:00:00Z
 
 ![npm i agents](~/assets/images/agents/npm-i-agents.apng)
 
-#### Multi-Agent applications and RPC
+#### Multi-Agent applications and RPC <Badge text="New" variant="tip" size="small" />
 
 We've added a number of big new features to the Agents SDK over the past few weeks, including:
 
@@ -21,7 +21,7 @@ We've added a number of big new features to the Agents SDK over the past few wee
 
 We've also fixed a nubmer of bugs with state synchronization and the React hooks.
 
-### Call Agent methods from your client code
+#### Call Agent methods from your client code <Badge text="New" variant="tip" size="small" />
 
 We've added a new [`@callable` decorator](/agents/api-reference/client-api/) 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.
 
@@ -33,23 +33,7 @@ We've added a new [`@callable` decorator](/agents/api-reference/client-api/) for
 
 </TypeScriptExample>
 
-#### agents-starter
-
-TODO
-
-- 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).
-
-#### More documentation
-
-We've contined to build out the Agents SDK documentation, including:
-
-- Expanded [API reference documentation](/agents/api-reference/), covering the methods and properties exposed by the Agents SDK, as well as more usage examples.
-- A new [Client API](/agents/api-reference/client-api/) reference that documents `useAgent`, `useAgentChat` and the new `@callable` decorator exposed by the SDK.
-- New documentation on how to [call agents](/agents/api-refererence/calling-agents/) and authenticate clients, using [Server-Sent Events (SSE)](/agents/api-refererence/http-sse/).
-
-#### `agents-sdk` -> `agents`
+#### `agents-sdk` -> `agents` <Badge text="Updated" variant="tip" size="small" />
 
 We've also renamed the Agents package to just `agents` (it's cleaner). If you've already been building with the Agents SDK, you can update your dependencies to use the new package name:
 
@@ -67,4 +51,20 @@ grep -r 'agents-sdk' .
 sed -i 's/agents-sdk/agents/g' $(grep -rl 'agents-sdk' .)
 ```
 
+#### agents-starter
+
+TODO
+
+- 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).
+
+#### More documentation
+
+We've contined to build out the Agents SDK documentation, including:
+
+- Expanded [API reference documentation](/agents/api-reference/), covering the methods and properties exposed by the Agents SDK, as well as more usage examples.
+- A new [Client API](/agents/api-reference/client-api/) reference that documents `useAgent`, `useAgentChat` and the new `@callable` decorator exposed by the SDK.
+- New documentation on how to [call agents](/agents/api-refererence/calling-agents/) and authenticate clients, using [Server-Sent Events (SSE)](/agents/api-refererence/http-sse/).
+
 If you're still wondering what Agents are, [read our blog on building AI Agents on Cloudflare](https://blog.cloudflare.com/build-ai-agents-on-cloudflare/) and/or visit the [Agents documentation](/agents/) to learn more.