Update README.md

Author: andyjessop

apps/agent-scheduler/README.md

@@ -10,6 +10,52 @@ Agent Scheduler is a sophisticated application designed to manage scheduling ope
 ## Overview
 The Agent Scheduler is built to facilitate dynamic scheduling tasks by interpreting natural language inputs. It uses AI models to determine the type of scheduling action required, such as adding, cancelling, or listing tasks. The application is structured around a central `SchedulerAgent` class that manages the state and operations of scheduling tasks.
 
+## Architecture
+The Agent Scheduler is an application that uses a combination of AI models and a durable object pattern to manage scheduling tasks. The core component is the `SchedulerAgent`, which handles the state and logic for scheduling operations.
+
+### System Diagram
+```mermaid
+graph TD;
+    A[User Query] -->|POST /query| B{SchedulerAgent}
+    B -->|Determine Action| C[AI Model]
+    C -->|Extract Action Type| D[Schedule Management]
+    D -->|Add/Cancel/List| E[Confirmation]
+    E -->|POST /confirmations/:confirmationId| F[User Confirmation]
+```
+
+### Agentic Patterns
+The project employs several agentic patterns:
+
+#### Tool Use Pattern
+The SchedulerAgent dynamically interacts with external AI models to interpret user queries and determine scheduling actions.
+
+```mermaid
+graph TD;
+    A[User Query] --> B{SchedulerAgent}
+    B -->|Invoke AI Model| C[AI Model]
+    C -->|Return Action Type| D[SchedulerAgent]
+```
+
+#### Planning Pattern
+The SchedulerAgent formulates and executes plans based on user queries, aligning with real-time goals.
+
+```mermaid
+graph TD;
+    A[User Query] --> B{SchedulerAgent}
+    B -->|Define Goal| C[Plan Execution]
+    C -->|Execute Plan| D[Schedule Management]
+```
+
+#### Autonomous Agent
+The SchedulerAgent operates autonomously, managing tasks dynamically and seeking feedback from the environment.
+
+```mermaid
+graph TD;
+    A[User Query] --> B{SchedulerAgent}
+    B -->|Autonomous Operation| C[Task Management]
+    C -->|Feedback Loop| D[User Interaction]
+```
+
 ## Usage
 To start the project locally, use the following command:
 ```
@@ -18,31 +64,31 @@ npx nx dev agent-scheduler
 
 ### NPM Scripts
 - **deploy**: Deploys the application using Wrangler.
-  ```
+```
 npx nx deploy agent-scheduler
 ```
 - **dev**: Starts the development server.
-  ```
+```
 npx nx dev agent-scheduler
 ```
 - **lint**: Lints the codebase and throws errors on warnings.
-  ```
+```
 npx nx lint agent-scheduler
 ```
 - **start**: Starts the development server.
-  ```
+```
 npx nx start agent-scheduler
 ```
 - **test**: Runs the test suite.
-  ```
+```
 npx nx test agent-scheduler
 ```
 - **test:ci**: Runs the test suite in CI mode.
-  ```
+```
 npx nx test:ci agent-scheduler
 ```
 - **type-check**: Checks TypeScript types without emitting files.
-  ```
+```
 npx nx type-check agent-scheduler
 ```
 
@@ -107,50 +153,4 @@ The application exposes the following API endpoints:
     http://localhost:8787/confirmations/your-confirmation-id
   ```
 
-## Architecture
-The Agent Scheduler is an application that uses a combination of AI models and a durable object pattern to manage scheduling tasks. The core component is the `SchedulerAgent`, which handles the state and logic for scheduling operations.
-
-### System Diagram
-```mermaid
-graph TD;
-    A[User Query] -->|POST /query| B{SchedulerAgent}
-    B -->|Determine Action| C[AI Model]
-    C -->|Extract Action Type| D[Schedule Management]
-    D -->|Add/Cancel/List| E[Confirmation]
-    E -->|POST /confirmations/:confirmationId| F[User Confirmation]
-```
-
-### Agentic Patterns
-The project employs several agentic patterns:
-
-#### Tool Use Pattern
-The SchedulerAgent dynamically interacts with external AI models to interpret user queries and determine scheduling actions.
-
-```mermaid
-graph TD;
-    A[User Query] --> B{SchedulerAgent}
-    B -->|Invoke AI Model| C[AI Model]
-    C -->|Return Action Type| D[SchedulerAgent]
-```
-
-#### Planning Pattern
-The SchedulerAgent formulates and executes plans based on user queries, aligning with real-time goals.
-
-```mermaid
-graph TD;
-    A[User Query] --> B{SchedulerAgent}
-    B -->|Define Goal| C[Plan Execution]
-    C -->|Execute Plan| D[Schedule Management]
-```
-
-#### Autonomous Agent
-The SchedulerAgent operates autonomously, managing tasks dynamically and seeking feedback from the environment.
-
-```mermaid
-graph TD;
-    A[User Query] --> B{SchedulerAgent}
-    B -->|Autonomous Operation| C[Task Management]
-    C -->|Feedback Loop| D[User Interaction]
-```
-
-<!-- Last updated: 7464b99c788378d693a45c25b97b3bbd024699c6 -->
+<!-- Last updated: 7464b99c788378d693a45c25b97b3bbd024699c6 -->