Sync docs from PR #633: add agent status monitoring function

Author: github-actions[bot]

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

@@ -133,6 +133,60 @@ export class CodeReviewAgent extends Agent<Env, AgentState> {
 }
 ```
 
+### Monitoring Agent status
+
+The Agents SDK provides a `getAgentStatus` function that allows you to check if an Agent is currently active and has active connections. This is useful for monitoring, debugging, and understanding the current state of your Agent instances.
+
+<TypeScriptExample>
+
+```ts
+import { Agent, AgentNamespace, getAgentByName, getAgentStatus } from 'agents';
+
+interface Env {
+	MyAgent: AgentNamespace<MyAgent>;
+}
+
+export default {
+	async fetch(request, env, ctx): Promise<Response> {
+		// Get a handle to an Agent instance
+		let agent = await getAgentByName<Env, MyAgent>(env.MyAgent, 'user-123');
+
+		// Check the agent's status
+		let status = getAgentStatus(agent);
+
+		// status contains:
+		// - connectionCount: number of active WebSocket connections
+		// - isActive: boolean indicating if the agent has any active connections
+		// - agentId: the unique identifier for this agent instance
+
+		return Response.json({
+			agentId: status.agentId,
+			isActive: status.isActive,
+			activeConnections: status.connectionCount
+		});
+	},
+} satisfies ExportedHandler<Env>;
+
+export class MyAgent extends Agent<Env> {
+	// Your Agent implementation
+}
+```
+
+</TypeScriptExample>
+
+The `getAgentStatus` function returns an object with three properties:
+
+* `connectionCount`: The number of active WebSocket connections to this Agent instance
+* `isActive`: A boolean indicating whether the Agent has any active connections (`true` if `connectionCount > 0`)
+* `agentId`: The unique identifier for this Agent instance (may be `undefined` for some Agent types)
+
+This is particularly useful for:
+
+* Building admin dashboards to monitor Agent activity
+* Debugging connection issues
+* Implementing logic that depends on whether an Agent is actively serving clients
+* Logging and analytics about Agent usage
+
 ### Naming your Agents
 
 When creating names for your Agents, think about what the Agent represents. A unique user? A team or company? A room or channel for collaboration?