auth

Author: elithrar

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

@@ -115,7 +115,7 @@ The `routeAgentRequest` helper documented earlier in this guide exposes two usef
 <TypeScriptExample>
 
 ```ts
-import { Agent, AgentNamespace, getAgentByName, routeAgentRequest } from 'agents-sdk';
+import { Agent, AgentNamespace, routeAgentRequest } from 'agents-sdk';
 
 interface Env {
 	MyAgent: AgentNamespace<MyAgent>;
@@ -152,6 +152,39 @@ export default {
 
 If you are using `getAgentByName` or the underlying Durable Objects routing API, you should authenticate incoming requests or WebSocket connections before calling `getAgentByName`.
 
+For example, if you are using [Hono](https://hono.dev/), you can authenticate in the middleware before calling an Agent and passing a request (or a WebSocket connection) to it:
+
+<TypeScriptExample>
+
+```ts
+import { Agent, AgentNamespace, getAgentByName } from 'agents-sdk';
+import { Hono } from 'hono';
+
+const app = new Hono<{ Bindings: Env }>();
+
+app.use('/code-review/*', async (c, next) => {
+	// Perform auth here
+	// e.g. validate a Bearer token, a JWT, use your preferred auth library
+	// return Response.json({ msg: 'unauthorized' }, { status: 401 });
+	await next(); // continue on if valid
+});
+
+app.get('/code-review/:id', async (c) => {
+	const id = c.req.param('teamId');
+	if (!id) return Response.json({ msg: 'missing id' }, { status: 400 });
+
+	// Call the Agent, creating it with the name/identifier from the ":id" segment
+	// of our URL
+	const agent = await getAgentByName<Env, MyAgent>(c.env.MyAgent, id);
+
+	// Pass the request to our Agent instance
+	return await agent.fetch(c.req.raw);
+});
+```
+
+</TypeScriptExample>
+
+
 ### Next steps
 
 * Review the [API documentation](/agents/api-reference/sdk/) for the Agents class to learn how to define