*

Author: danstarns

modus/agents.mdx

@@ -102,8 +102,16 @@ When you call this function through GraphQL, it returns a unique agent ID:
 mutation {
   deployAnalyst
 }
+```
+
+Response:
 
-# Returns: "agent_abc123xyz"
+```json
+{
+  "data": {
+    "deployAnalyst": "agent_abc123xyz"
+  }
+}
 ```
 
 You can think of an Agent as a persistent server process with durable memory.
@@ -161,12 +169,40 @@ mutation {
     data: "Suspicious network activity detected"
   )
 }
+```
+
+Response:
 
+```json
+{
+  "data": {
+    "submitIntelligence": "Analysis complete.
+      Threat pattern matches previous incident #7823.
+      Confidence: 0.85 based on 3 briefings.
+      Recommend immediate investigation."
+  }
+}
+```
+
+```graphql
 query {
   getThreatAssessment(agentId: "agent_abc123xyz")
 }
 ```
 
+Response:
+
+```json
+{
+  "data": {
+    "getThreatAssessment": "Current threat assessment:
+      3 briefings analyzed.
+      Confidence level: 0.85.
+      Agent operational."
+  }
+}
+```
+
 The agent receives the message, processes it using its internal state and AI
 reasoning, updates its intelligence database, and returns a response—all while
 maintaining persistent memory of every interaction.
@@ -436,6 +472,22 @@ query MonitorAnalysis($agentId: String!) {
 }
 ```
 
+Response:
+
+```json
+{
+  "data": {
+    "checkAnalysisProgress": {
+      "phase": "Deep Intelligence Analysis",
+      "progress": 0.75,
+      "currentTask": "[15:42:33] Phase 2: Generating threat assessment...",
+      "estimatedTimeRemaining": 45,
+      "isComplete": false
+    }
+  }
+}
+```
+
 This polling approach enables:
 
 - **Progress tracking**: Monitor completion percentage and current phase