agents docs

Author: elithrar

src/content/docs/agents/api-reference/calling-agents.mdx

@@ -190,7 +190,7 @@ This ensures we only create Agents for authenticated users, and allows you to va
 
 ### Next steps
 
-* Review the [API documentation](/agents/api-reference/sdk/) for the Agents class to learn how to define
+* Review the [API documentation](/agents/api-reference/agents-api/) for the Agents class to learn how to define
 * [Build a chat Agent](/agents/getting-started/build-a-chat-agent/) using the `agents-sdk` and deploy it to Workers.
 * Learn more [using WebSockets](/agents/api-reference/websockets/) to build interactive Agents and stream data back from your Agent.
 * [Orchestrate asynchronous workflows](/agents/api-reference/run-workflows) from your Agent by combining the `agents-sdk` and [Workflows](/workflows).

src/content/docs/agents/api-reference/client-api.mdx

@@ -0,0 +1,73 @@
+---
+title: Client API
+pcx_content_type: concept
+sidebar:
+  order: 11
+---
+
+import { MetaInfo, Render, Type, TypeScriptExample, WranglerConfig } from "~/components";
+
+The Agents SDK provides a set of client APIs for interacting with Agents from client-side JavaScript code, including:
+
+* React hooks, including `useAgent` and `useAgentChat`, for connecting to Agents from client applications.
+* Client-side [state syncing](/agents/api-reference/store-and-sync-state/) that allows you to subscribe to state updates between the Agent and any connected client(s) when calling `this.setState` within your Agent's code.
+* The ability to call remote methods (Remote Procedure Calls; RPC) on the Agent from client-side JavaScript code using the `@callable` method decorator.
+
+## React hooks
+
+TODO
+
+#### `useAgent`
+
+TODO
+
+<TypeScriptExample>
+
+```ts
+import { useAgent } from "agents-sdk/react";
+
+// TODO
+```
+
+</TypeScriptExample>
+
+#### `useAgentChat`
+
+TODO
+
+<TypeScriptExample>
+
+```ts
+import { useAgent } from "agents-sdk/react";
+import { useAgentChat } from "agents-sdk/ai-react";
+
+// TODO
+```
+
+</TypeScriptExample>
+
+## State synchronization
+
+:::note
+
+Visit the [state management API documentation](/agents/api-reference/store-and-sync-state/) within the Agents SDK, including the native `state` APIs and the built-in `this.sql` API for storing and querying data within your Agents.
+
+:::
+
+TODO
+
+<TypeScriptExample>
+
+```ts
+import { useState } from "react";
+import { useAgent } from "agents-sdk/react";
+
+// TODO
+```
+
+</TypeScriptExample>
+
+
+## Call remote methods
+
+TODO

src/content/docs/agents/api-reference/using-ai-models.mdx

@@ -24,7 +24,7 @@ A user can disconnect during a long-running response from a modern reasoning mod
 
 ## Calling AI Models
 
-You can call models from any method within an Agent, including from HTTP requests using the [`onRequest`](/agents/api-reference/sdk/) handler, when a [scheduled task](/agents/api-reference/schedule-tasks/) runs, when handling a WebSocket message in the [`onMessage`](/agents/api-reference/websockets/) handler, or from any of your own methods.
+You can call models from any method within an Agent, including from HTTP requests using the [`onRequest`](/agents/api-reference/agents-api/) handler, when a [scheduled task](/agents/api-reference/schedule-tasks/) runs, when handling a WebSocket message in the [`onMessage`](/agents/api-reference/websockets/) handler, or from any of your own methods.
 
 Importantly, Agents can call AI models on their own — autonomously — and can handle long-running responses that can take minutes (or longer) to respond in full.
 

src/content/docs/agents/getting-started/quickstart.mdx

@@ -163,7 +163,7 @@ If you're looking to build a more complex Agent, you can use the Agents SDK to b
 
 Otherwise, you can:
 
-* Review the [Agents API reference](/agents/api-reference/creating-agents/) and the APIs exposed by the Agents SDK.
+* Review the [Agents API reference](/agents/api-reference/agents-api/) and the APIs exposed by the Agents SDK.
 * Learn more [using WebSockets](/agents/api-reference/websockets/) to build interactive Agents and stream data back from your Agent.
 * [Orchestrate asynchronous workflows](/agents/api-reference/run-workflows) from your Agent by combining the Agents SDK and [Workflows](/workflows).
 * How to [schedule tasks](/agents/api-reference/schedule-tasks) from within your Agent using the `this.schedule` API.

src/content/docs/agents/index.mdx

@@ -44,7 +44,7 @@ If you're already building on [Workers](/workers/), you can install the `agents-
 npm i agents-sdk
 ```
 
-Dive into the [Agent SDK reference](/agents/api-reference/sdk/) to learn more about how to use the `agents-sdk` package and defining an `Agent`.
+Dive into the [Agent SDK reference](/agents/api-reference/agents-api/) to learn more about how to use the `agents-sdk` package and defining an `Agent`.
 
 #### Why build agents on Cloudflare?