fix sidebar ordering

Author: elithrar

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

@@ -2,10 +2,9 @@
 title: Agents API Reference
 pcx_content_type: navigation
 sidebar:
-  order: 3
+  order: 5
   group:
     hideIndex: true
-
 ---
 
 import { DirectoryListing } from "~/components"

src/content/docs/agents/building-with-ai/index.mdx

@@ -2,7 +2,7 @@
 title: Building with AI
 pcx_content_type: navigation
 sidebar:
-  order: 5
+  order: 4
   group:
     hideIndex: true
 

src/content/docs/agents/concepts/index.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: reference
 title: Concepts
 sidebar:
-  order: 1
+  order: 2
   group:
     hideIndex: true
 ---

src/content/docs/agents/examples/index.mdx

@@ -1,8 +1,8 @@
 ---
 pcx_content_type: reference
-title: Build
+title: Examples
 sidebar:
-  order: 4
+  order: 3
 ---
 
 import { DirectoryListing, PackageManagers } from "~/components";

src/content/docs/agents/examples/manage-and-sync-state.mdx

@@ -144,14 +144,15 @@ export class MyAgent extends Agent<Env> {
 	async onRequest(request: Request) {
 		let userId = new URL(request.url).searchParams.get('userId');
 		// Supply the type paramter to the query when calling this.sql
-		// This assumes the results return a single User row with "id", "name", and "email" columns
-		// You can also pass an array as the type argument to the query - e.g. User[]
+		// This assumes the results returns one or more User rows with "id", "name", and "email" columns
 		const user = await this.sql<User>`SELECT * FROM users WHERE id = ${userId}`;
 		return Response.json(user)
 	}
 }
 ```
 
+You do not need to specify an array type (`User[]` or `Array<User>`) as `this.sql` will always return an array of the specified type.
+
 Providing a type parameter does not validate that the result matches your type definition. In TypeScript, properties (fields) that do not exist or conform to the type you provided will be dropped. If you need to validate incoming events, we recommend a library such as [zod](https://zod.dev/) or your own validator logic.
 
 :::note
@@ -160,4 +161,4 @@ Learn more about the zero-latency SQL storage that powers both Agents and Durabl
 
 :::
 
-The SQL API exposed to an Agent is similar to the one [within Durable Objects](/durable-objects/api/sql-storage/). This means that you can use the same SQL queries with the Agent's database, create tables, and query data.
+The SQL API exposed to an Agent is similar to the one [within Durable Objects](/durable-objects/api/sql-storage/): Durable Object SQL methods available on `this.ctx.storage.sql`. You can use the same SQL queries with the Agent's database, create tables, and query data, as you would with Durable Objects or D1, as the dialect is the same.

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

@@ -2,7 +2,7 @@
 title: Getting started
 pcx_content_type: navigation
 sidebar:
-  order: 2
+  order: 1
   group:
     hideIndex: true