omnius 1.0.609 → 1.0.610

package/docs/DISCOVERY.json

@@ -189,6 +189,143 @@
         "skill.omnius-rest-docs"
       ]
     },
+    {
+      "id": "api.",
+      "kind": "api",
+      "title": "/",
+      "summary": "HATEOAS API root when the client does not request HTML",
+      "aliases": [
+        "/"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "Discovery"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "Discovery"
+      ],
+      "operations": {
+        "get": {
+          "summary": "HATEOAS API root when the client does not request HTML",
+          "tags": [
+            "Discovery"
+          ],
+          "security": [],
+          "responses": {
+            "200": {
+              "description": "Versioned link map for docs, discovery, inference, tools, memory, voice, projects, and observability"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.asyncapi",
+      "kind": "api",
+      "title": "/asyncapi",
+      "summary": "Compatibility alias for the AsyncAPI contract",
+      "aliases": [
+        "/asyncapi"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "Discovery",
+        "asyncapi"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /asyncapi"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "Discovery"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Compatibility alias for the AsyncAPI contract",
+          "tags": [
+            "Discovery"
+          ],
+          "security": [],
+          "responses": {
+            "200": {
+              "description": "AsyncAPI document"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
     {
       "id": "api.discovery",
       "kind": "api",
@@ -460,6 +597,75 @@
         "packages/cli/src/api/openapi.ts"
       ]
     },
+    {
+      "id": "api.help",
+      "kind": "api",
+      "title": "/help",
+      "summary": "Compact daemon help and integration entrypoints",
+      "aliases": [
+        "/help"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "Discovery",
+        "help"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /help"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "Discovery"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Compact daemon help and integration entrypoints",
+          "tags": [
+            "Discovery"
+          ],
+          "security": [],
+          "responses": {
+            "200": {
+              "description": "Text or JSON integration help"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
     {
       "id": "api.metrics",
       "kind": "api",
@@ -569,99 +775,131 @@
       ]
     },
     {
-      "id": "api.skills",
+      "id": "api.realtime",
       "kind": "api",
-      "title": "Skills API",
-      "summary": "List and load Omnius and project skills incrementally.",
+      "title": "/realtime",
+      "summary": "Generate one short text reply for a voice-adapter transcript",
       "aliases": [
-        "skills endpoint",
-        "skill discovery"
+        "/realtime"
       ],
       "keywords": [
-        "skills",
-        "incremental context"
+        "rest",
+        "openapi",
+        "POST",
+        "Chat",
+        "realtime"
       ],
       "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
       "interfaces": [
         {
-          "type": "http",
-          "target": "GET /v1/skills"
+          "type": "rest",
+          "target": "POST /realtime"
         },
         {
-          "type": "http",
-          "target": "GET /v1/skills/{name}"
+          "type": "openapi",
+          "target": "/openapi.json"
         }
       ],
       "references": [
         {
-          "type": "api",
-          "target": "docs/rest/endpoints/skills.md",
-          "relation": "wire-contract"
-        }
-      ],
-      "related": [
-        "skill.omnius-docs",
-        "skill.omnius-rest-docs"
-      ]
-    },
-    {
-      "id": "api.tools",
-      "kind": "api",
-      "title": "Tools API",
-      "summary": "Inspect live tool schemas and invocation metadata, register external tools, and call only tools marked direct-callable.",
-      "aliases": [
-        "tools endpoint",
-        "direct tool api"
-      ],
-      "keywords": [
-        "tool metadata",
-        "direct_callable",
-        "MCP",
-        "external tools"
-      ],
-      "maturity": "stable",
-      "interfaces": [
-        {
-          "type": "http",
-          "target": "GET /v1/tools"
-        },
-        {
-          "type": "http",
-          "target": "GET /v1/tools/{name}"
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
         },
         {
-          "type": "http",
-          "target": "POST /v1/tools/{name}/call"
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
         }
       ],
-      "references": [
-        {
-          "type": "api",
-          "target": "docs/rest/endpoints/tools.md",
-          "relation": "wire-contract"
-        }
+      "methods": [
+        "POST"
       ],
-      "related": [
-        "tool.web-search",
-        "tool.tool-search",
-        "operation.version-compatibility"
+      "tags": [
+        "Chat"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Generate one short text reply for a voice-adapter transcript",
+          "description": "Text-only conversational brain for ASR/TTS adapters. Accepts message, text, recent_turn, asr_text, or callerText and returns JSON by default or plain text when requested. This route does not perform ASR or TTS.",
+          "tags": [
+            "Chat"
+          ],
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "recent_turn": {
+                      "type": "string"
+                    },
+                    "asr_text": {
+                      "type": "string"
+                    },
+                    "callerText": {
+                      "type": "string"
+                    },
+                    "soul_md": {
+                      "type": "string"
+                    },
+                    "format": {
+                      "type": "string",
+                      "enum": [
+                        "json",
+                        "text"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "responses": {
+            "200": {
+              "description": "Short conversational reply"
+            },
+            "400": {
+              "description": "No transcript text supplied"
+            },
+            "500": {
+              "description": "Realtime backend request failed"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
       ]
     },
     {
-      "id": "api.v1-agents",
+      "id": "api.routes",
       "kind": "api",
-      "title": "/v1/agents",
-      "summary": "List agent types",
+      "title": "/routes",
+      "summary": "Compatibility alias for the daemon route summary",
       "aliases": [
-        "/v1/agents"
+        "/routes"
       ],
       "keywords": [
         "rest",
         "openapi",
         "GET",
-        "Tools",
-        "v1",
-        "agents"
+        "Discovery",
+        "routes"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -673,7 +911,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/agents"
+          "target": "GET /routes"
         },
         {
           "type": "openapi",
@@ -696,17 +934,18 @@
         "GET"
       ],
       "tags": [
-        "Tools"
+        "Discovery"
       ],
       "operations": {
         "get": {
-          "summary": "List agent types",
+          "summary": "Compatibility alias for the daemon route summary",
           "tags": [
-            "Tools"
+            "Discovery"
           ],
+          "security": [],
           "responses": {
             "200": {
-              "description": "Agent type registry"
+              "description": "Human- and agent-readable route map"
             }
           }
         }
@@ -717,20 +956,101 @@
       ]
     },
     {
-      "id": "api.v1-aims",
+      "id": "api.skills",
       "kind": "api",
-      "title": "/v1/aims",
-      "summary": "AIMS root — control map and endpoint index",
+      "title": "Skills API",
+      "summary": "List and load Omnius and project skills incrementally.",
       "aliases": [
-        "/v1/aims"
+        "skills endpoint",
+        "skill discovery"
+      ],
+      "keywords": [
+        "skills",
+        "incremental context"
+      ],
+      "maturity": "stable",
+      "interfaces": [
+        {
+          "type": "http",
+          "target": "GET /v1/skills"
+        },
+        {
+          "type": "http",
+          "target": "GET /v1/skills/{name}"
+        }
+      ],
+      "references": [
+        {
+          "type": "api",
+          "target": "docs/rest/endpoints/skills.md",
+          "relation": "wire-contract"
+        }
+      ],
+      "related": [
+        "skill.omnius-docs",
+        "skill.omnius-rest-docs"
+      ]
+    },
+    {
+      "id": "api.tools",
+      "kind": "api",
+      "title": "Tools API",
+      "summary": "Inspect live tool schemas and invocation metadata, register external tools, and call only tools marked direct-callable.",
+      "aliases": [
+        "tools endpoint",
+        "direct tool api"
+      ],
+      "keywords": [
+        "tool metadata",
+        "direct_callable",
+        "MCP",
+        "external tools"
+      ],
+      "maturity": "stable",
+      "interfaces": [
+        {
+          "type": "http",
+          "target": "GET /v1/tools"
+        },
+        {
+          "type": "http",
+          "target": "GET /v1/tools/{name}"
+        },
+        {
+          "type": "http",
+          "target": "POST /v1/tools/{name}/call"
+        }
+      ],
+      "references": [
+        {
+          "type": "api",
+          "target": "docs/rest/endpoints/tools.md",
+          "relation": "wire-contract"
+        }
+      ],
+      "related": [
+        "tool.web-search",
+        "tool.tool-search",
+        "operation.version-compatibility"
+      ]
+    },
+    {
+      "id": "api.v1-admin-access",
+      "kind": "api",
+      "title": "/v1/admin/access",
+      "summary": "Read the daemon network access mode; Change and persist the daemon network access mode from loopback",
+      "aliases": [
+        "/v1/admin/access"
       ],
       "keywords": [
         "rest",
         "openapi",
         "GET",
-        "AIMS",
+        "POST",
+        "Config",
         "v1",
-        "aims"
+        "admin",
+        "access"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -742,7 +1062,11 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/aims"
+          "target": "GET /v1/admin/access"
+        },
+        {
+          "type": "rest",
+          "target": "POST /v1/admin/access"
         },
         {
           "type": "openapi",
@@ -762,20 +1086,62 @@
         }
       ],
       "methods": [
-        "GET"
+        "GET",
+        "POST"
       ],
       "tags": [
-        "AIMS"
+        "Config"
       ],
       "operations": {
         "get": {
-          "summary": "AIMS root — control map and endpoint index",
+          "summary": "Read the daemon network access mode",
           "tags": [
-            "AIMS"
+            "Config"
           ],
           "responses": {
             "200": {
-              "description": "AIMS overview"
+              "description": "Current access mode and host"
+            }
+          }
+        },
+        "post": {
+          "summary": "Change and persist the daemon network access mode from loopback",
+          "tags": [
+            "Config"
+          ],
+          "description": "Loopback-only even when the current access mode is any.",
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "mode"
+                  ],
+                  "properties": {
+                    "mode": {
+                      "type": "string",
+                      "enum": [
+                        "loopback",
+                        "lan",
+                        "any"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "responses": {
+            "200": {
+              "description": "Access mode changed"
+            },
+            "400": {
+              "description": "Invalid mode"
+            },
+            "403": {
+              "description": "Loopback origin required"
             }
           }
         }
@@ -786,21 +1152,20 @@
       ]
     },
     {
-      "id": "api.v1-aims-config-history",
+      "id": "api.v1-agents",
       "kind": "api",
-      "title": "/v1/aims/config-history",
-      "summary": "Configuration change history (A.6.2.8)",
+      "title": "/v1/agents",
+      "summary": "List agent types",
       "aliases": [
-        "/v1/aims/config-history"
+        "/v1/agents"
       ],
       "keywords": [
         "rest",
         "openapi",
         "GET",
-        "AIMS",
+        "Tools",
         "v1",
-        "aims",
-        "config-history"
+        "agents"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -812,7 +1177,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/aims/config-history"
+          "target": "GET /v1/agents"
         },
         {
           "type": "openapi",
@@ -835,17 +1200,17 @@
         "GET"
       ],
       "tags": [
-        "AIMS"
+        "Tools"
       ],
       "operations": {
         "get": {
-          "summary": "Configuration change history (A.6.2.8)",
+          "summary": "List agent types",
           "tags": [
-            "AIMS"
+            "Tools"
           ],
           "responses": {
             "200": {
-              "description": "Config change records from audit log"
+              "description": "Agent type registry"
             }
           }
         }
@@ -856,12 +1221,12 @@
       ]
     },
     {
-      "id": "api.v1-aims-data-quality",
+      "id": "api.v1-aims",
       "kind": "api",
-      "title": "/v1/aims/data-quality",
-      "summary": "Data quality controls (A.7.2)",
+      "title": "/v1/aims",
+      "summary": "AIMS root — control map and endpoint index",
       "aliases": [
-        "/v1/aims/data-quality"
+        "/v1/aims"
       ],
       "keywords": [
         "rest",
@@ -869,8 +1234,7 @@
         "GET",
         "AIMS",
         "v1",
-        "aims",
-        "data-quality"
+        "aims"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -882,7 +1246,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/aims/data-quality"
+          "target": "GET /v1/aims"
         },
         {
           "type": "openapi",
@@ -909,13 +1273,13 @@
       ],
       "operations": {
         "get": {
-          "summary": "Data quality controls (A.7.2)",
+          "summary": "AIMS root — control map and endpoint index",
           "tags": [
             "AIMS"
           ],
           "responses": {
             "200": {
-              "description": "Data quality register"
+              "description": "AIMS overview"
             }
           }
         }
@@ -926,12 +1290,152 @@
       ]
     },
     {
-      "id": "api.v1-aims-decisions",
+      "id": "api.v1-aims-config-history",
       "kind": "api",
-      "title": "/v1/aims/decisions",
-      "summary": "Consequential decision log (A.9)",
+      "title": "/v1/aims/config-history",
+      "summary": "Configuration change history (A.6.2.8)",
       "aliases": [
-        "/v1/aims/decisions"
+        "/v1/aims/config-history"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "AIMS",
+        "v1",
+        "aims",
+        "config-history"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/aims/config-history"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "AIMS"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Configuration change history (A.6.2.8)",
+          "tags": [
+            "AIMS"
+          ],
+          "responses": {
+            "200": {
+              "description": "Config change records from audit log"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-aims-data-quality",
+      "kind": "api",
+      "title": "/v1/aims/data-quality",
+      "summary": "Data quality controls (A.7.2)",
+      "aliases": [
+        "/v1/aims/data-quality"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "AIMS",
+        "v1",
+        "aims",
+        "data-quality"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/aims/data-quality"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "AIMS"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Data quality controls (A.7.2)",
+          "tags": [
+            "AIMS"
+          ],
+          "responses": {
+            "200": {
+              "description": "Data quality register"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-aims-decisions",
+      "kind": "api",
+      "title": "/v1/aims/decisions",
+      "summary": "Consequential decision log (A.9)",
+      "aliases": [
+        "/v1/aims/decisions"
       ],
       "keywords": [
         "rest",
@@ -3154,6 +3658,79 @@
         "packages/cli/src/api/openapi.ts"
       ]
     },
+    {
+      "id": "api.v1-audio-embed",
+      "kind": "api",
+      "title": "/v1/audio/embed",
+      "summary": "Create an audio embedding for uploaded or referenced audio",
+      "aliases": [
+        "/v1/audio/embed"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Voice",
+        "v1",
+        "audio",
+        "embed"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/audio/embed"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Voice"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Create an audio embedding for uploaded or referenced audio",
+          "tags": [
+            "Voice"
+          ],
+          "responses": {
+            "200": {
+              "description": "Audio embedding result"
+            },
+            "400": {
+              "description": "Invalid audio input"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
     {
       "id": "api.v1-audio-speech",
       "kind": "api",
@@ -3559,12 +4136,12 @@
       ]
     },
     {
-      "id": "api.v1-chat-check-in",
+      "id": "api.v1-chat-attachments",
       "kind": "api",
-      "title": "/v1/chat/check-in",
-      "summary": "Send a steering check-in to the active chat session — returns model inference + queued steering_packet",
+      "title": "/v1/chat/attachments",
+      "summary": "Upload an attachment for a stateful chat",
       "aliases": [
-        "/v1/chat/check-in"
+        "/v1/chat/attachments"
       ],
       "keywords": [
         "rest",
@@ -3573,7 +4150,7 @@
         "Chat",
         "v1",
         "chat",
-        "check-in"
+        "attachments"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -3585,7 +4162,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/chat/check-in"
+          "target": "POST /v1/chat/attachments"
         },
         {
           "type": "openapi",
@@ -3612,13 +4189,16 @@
       ],
       "operations": {
         "post": {
-          "summary": "Send a steering check-in to the active chat session — returns model inference + queued steering_packet",
+          "summary": "Upload an attachment for a stateful chat",
           "tags": [
             "Chat"
           ],
           "responses": {
             "200": {
-              "description": "Check-in queued"
+              "description": "Stored attachment metadata"
+            },
+            "400": {
+              "description": "Invalid attachment"
             }
           }
         }
@@ -3629,21 +4209,21 @@
       ]
     },
     {
-      "id": "api.v1-chat-completions",
+      "id": "api.v1-chat-check-in",
       "kind": "api",
-      "title": "/v1/chat/completions",
-      "summary": "OpenAI-compatible chat completion (with optional server-side agent loop)",
+      "title": "/v1/chat/check-in",
+      "summary": "Send a steering check-in to the active chat session — returns model inference + queued steering_packet",
       "aliases": [
-        "/v1/chat/completions"
+        "/v1/chat/check-in"
       ],
       "keywords": [
         "rest",
         "openapi",
         "POST",
-        "Inference",
+        "Chat",
         "v1",
         "chat",
-        "completions"
+        "check-in"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -3655,7 +4235,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/chat/completions"
+          "target": "POST /v1/chat/check-in"
         },
         {
           "type": "openapi",
@@ -3678,33 +4258,103 @@
         "POST"
       ],
       "tags": [
-        "Inference"
+        "Chat"
       ],
       "operations": {
         "post": {
-          "summary": "OpenAI-compatible chat completion (with optional server-side agent loop)",
+          "summary": "Send a steering check-in to the active chat session — returns model inference + queued steering_packet",
           "tags": [
-            "Inference"
+            "Chat"
           ],
-          "parameters": [
-            {
-              "$ref": "#/components/parameters/MinimumOmniusVersion"
+          "responses": {
+            "200": {
+              "description": "Check-in queued"
             }
-          ],
-          "description": "Standard OpenAI chat-completion proxy by default. Set agent_loop=true to enter a synchronous server-side loop that auto-executes daemon tools (web_search, web_fetch, file_read, ocr, etc.) and re-prompts the model — collapsing N round-trips into 1. include_daemon_tools=['read','run'] auto-merges daemon tools matching those scopes into the offered tools[]. timeout_s overrides OMNIUS_BACKEND_TIMEOUT_S (default 120s, max 1h). prompt_template='factual-first' prepends a web_search-first policy. SSE streaming honors tool_calls in delta as standard OpenAI shape: delta.tool_calls=[{id,type:'function',index,function:{name,arguments:<JSON-string>}}]. parallel_tool_calls is forwarded to the backend.",
-          "requestBody": {
-            "required": true,
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "model",
-                    "messages"
-                  ],
-                  "properties": {
-                    "model": {
-                      "type": "string"
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-chat-completions",
+      "kind": "api",
+      "title": "/v1/chat/completions",
+      "summary": "OpenAI-compatible chat completion (with optional server-side agent loop)",
+      "aliases": [
+        "/v1/chat/completions"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Inference",
+        "v1",
+        "chat",
+        "completions"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/chat/completions"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Inference"
+      ],
+      "operations": {
+        "post": {
+          "summary": "OpenAI-compatible chat completion (with optional server-side agent loop)",
+          "tags": [
+            "Inference"
+          ],
+          "parameters": [
+            {
+              "$ref": "#/components/parameters/MinimumOmniusVersion"
+            }
+          ],
+          "description": "Standard OpenAI chat-completion proxy by default. Set agent_loop=true to enter a synchronous server-side loop that auto-executes daemon tools (web_search, web_fetch, file_read, ocr, etc.) and re-prompts the model — collapsing N round-trips into 1. include_daemon_tools=['read','run'] auto-merges daemon tools matching those scopes into the offered tools[]. timeout_s overrides OMNIUS_BACKEND_TIMEOUT_S (default 120s, max 1h). prompt_template='factual-first' prepends a web_search-first policy. SSE streaming honors tool_calls in delta as standard OpenAI shape: delta.tool_calls=[{id,type:'function',index,function:{name,arguments:<JSON-string>}}]. parallel_tool_calls is forwarded to the backend.",
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "model",
+                    "messages"
+                  ],
+                  "properties": {
+                    "model": {
+                      "type": "string"
                     },
                     "messages": {
                       "type": "array"
@@ -3865,7 +4515,7 @@
       "id": "api.v1-chat-sessions",
       "kind": "api",
       "title": "/v1/chat/sessions",
-      "summary": "List active chat sessions",
+      "summary": "List persisted browser chats and importable TUI sessions for a workspace",
       "aliases": [
         "/v1/chat/sessions"
       ],
@@ -3915,13 +4565,163 @@
       ],
       "operations": {
         "get": {
-          "summary": "List active chat sessions",
+          "summary": "List persisted browser chats and importable TUI sessions for a workspace",
+          "description": "Returns the canonical structured chat store plus quality-filtered TUI visual sessions. Exit commands such as /quit, manual-save noise, empty transcripts, and duplicate session fingerprints are excluded from the TUI history projection.",
+          "tags": [
+            "Chat"
+          ],
+          "parameters": [
+            {
+              "name": "root",
+              "in": "query",
+              "schema": {
+                "type": "string"
+              },
+              "description": "Workspace root. Defaults to the daemon's current project or process cwd."
+            },
+            {
+              "name": "include_tui",
+              "in": "query",
+              "schema": {
+                "type": "boolean",
+                "default": true
+              },
+              "description": "Set to 0/false to return only canonical browser chat sessions."
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Workspace-scoped canonical and importable session list"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-chat-sessions-id",
+      "kind": "api",
+      "title": "/v1/chat/sessions/{id}",
+      "summary": "Hydrate one chat or imported TUI session with full history and live-run state; Permanently delete a canonical chat or TUI history session",
+      "aliases": [
+        "/v1/chat/sessions/{id}"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "DELETE",
+        "Chat",
+        "v1",
+        "chat",
+        "sessions",
+        "{id}"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/chat/sessions/{id}"
+        },
+        {
+          "type": "rest",
+          "target": "DELETE /v1/chat/sessions/{id}"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET",
+        "DELETE"
+      ],
+      "tags": [
+        "Chat"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Hydrate one chat or imported TUI session with full history and live-run state",
+          "tags": [
+            "Chat"
+          ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "root",
+              "in": "query",
+              "schema": {
+                "type": "string"
+              },
+              "description": "Workspace root used to resolve tui: session ids."
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Session metadata, full non-system message history, transcript, token counts, and in-flight run state"
+            },
+            "404": {
+              "description": "Session not found"
+            }
+          }
+        },
+        "delete": {
+          "summary": "Permanently delete a canonical chat or TUI history session",
           "tags": [
             "Chat"
           ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "root",
+              "in": "query",
+              "schema": {
+                "type": "string"
+              },
+              "description": "Workspace root used to resolve tui: session ids."
+            }
+          ],
           "responses": {
             "200": {
-              "description": "Session list"
+              "description": "Session deleted"
+            },
+            "404": {
+              "description": "Session not found"
             }
           }
         }
@@ -6419,21 +7219,22 @@
       ]
     },
     {
-      "id": "api.v1-files-read",
+      "id": "api.v1-files-raw",
       "kind": "api",
-      "title": "/v1/files/read",
-      "summary": "Read file content (PT-05)",
+      "title": "/v1/files/raw",
+      "summary": "Stream raw workspace file bytes for browser previews; Inspect raw workspace file response metadata",
       "aliases": [
-        "/v1/files/read"
+        "/v1/files/raw"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "POST",
+        "GET",
+        "HEAD",
         "Files",
         "v1",
         "files",
-        "read"
+        "raw"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -6445,7 +7246,11 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/files/read"
+          "target": "GET /v1/files/raw"
+        },
+        {
+          "type": "rest",
+          "target": "HEAD /v1/files/raw"
         },
         {
           "type": "openapi",
@@ -6465,41 +7270,155 @@
         }
       ],
       "methods": [
-        "POST"
+        "GET",
+        "HEAD"
       ],
       "tags": [
         "Files"
       ],
       "operations": {
-        "post": {
-          "summary": "Read file content (PT-05)",
+        "get": {
+          "summary": "Stream raw workspace file bytes for browser previews",
           "tags": [
             "Files"
           ],
-          "requestBody": {
-            "required": true,
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "path"
-                  ],
-                  "properties": {
-                    "path": {
-                      "type": "string"
-                    },
-                    "offset": {
-                      "type": "integer"
-                    },
-                    "limit": {
-                      "type": "integer"
-                    },
-                    "allow_outside_cwd": {
-                      "type": "boolean"
-                    }
-                  }
-                }
+          "parameters": [
+            {
+              "name": "path",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "File bytes with detected content type and range support"
+            },
+            "400": {
+              "description": "Missing or invalid path"
+            },
+            "404": {
+              "description": "File not found"
+            }
+          }
+        },
+        "head": {
+          "summary": "Inspect raw workspace file response metadata",
+          "tags": [
+            "Files"
+          ],
+          "parameters": [
+            {
+              "name": "path",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "File metadata headers"
+            },
+            "400": {
+              "description": "Missing or invalid path"
+            },
+            "404": {
+              "description": "File not found"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-files-read",
+      "kind": "api",
+      "title": "/v1/files/read",
+      "summary": "Read file content (PT-05)",
+      "aliases": [
+        "/v1/files/read"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Files",
+        "v1",
+        "files",
+        "read"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/files/read"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Files"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Read file content (PT-05)",
+          "tags": [
+            "Files"
+          ],
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "path"
+                  ],
+                  "properties": {
+                    "path": {
+                      "type": "string"
+                    },
+                    "offset": {
+                      "type": "integer"
+                    },
+                    "limit": {
+                      "type": "integer"
+                    },
+                    "allow_outside_cwd": {
+                      "type": "boolean"
+                    }
+                  }
+                }
               }
             }
           },
@@ -6831,11 +7750,349 @@
       "keywords": [
         "rest",
         "openapi",
-        "DELETE",
-        "Tools",
+        "DELETE",
+        "Tools",
+        "v1",
+        "keys",
+        "{prefix}"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "DELETE /v1/keys/{prefix}"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "DELETE"
+      ],
+      "tags": [
+        "Tools"
+      ],
+      "operations": {
+        "delete": {
+          "summary": "Revoke a runtime key by prefix (admin scope)",
+          "tags": [
+            "Tools"
+          ],
+          "parameters": [
+            {
+              "name": "prefix",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string",
+                "minLength": 8
+              },
+              "description": "First 8+ characters of the key"
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Number of keys revoked"
+            },
+            "400": {
+              "description": "Prefix too short"
+            },
+            "403": {
+              "description": "Admin scope required"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-mcps",
+      "kind": "api",
+      "title": "/v1/mcps",
+      "summary": "List MCP servers (PT-03)",
+      "aliases": [
+        "/v1/mcps"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "MCP",
+        "v1",
+        "mcps"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/mcps"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "MCP"
+      ],
+      "operations": {
+        "get": {
+          "summary": "List MCP servers (PT-03)",
+          "tags": [
+            "MCP"
+          ],
+          "responses": {
+            "200": {
+              "description": "Paginated MCP server list"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-mcps-name",
+      "kind": "api",
+      "title": "/v1/mcps/{name}",
+      "summary": "Get MCP server details (PT-03)",
+      "aliases": [
+        "/v1/mcps/{name}"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "MCP",
+        "v1",
+        "mcps",
+        "{name}"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/mcps/{name}"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "MCP"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Get MCP server details (PT-03)",
+          "tags": [
+            "MCP"
+          ],
+          "parameters": [
+            {
+              "name": "name",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Server details"
+            },
+            "404": {
+              "description": "Not found"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-mcps-name-call",
+      "kind": "api",
+      "title": "/v1/mcps/{name}/call",
+      "summary": "Invoke a tool on an MCP server (PT-03)",
+      "aliases": [
+        "/v1/mcps/{name}/call"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "MCP",
+        "v1",
+        "mcps",
+        "{name}",
+        "call"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/mcps/{name}/call"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "MCP"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Invoke a tool on an MCP server (PT-03)",
+          "tags": [
+            "MCP"
+          ],
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "tool"
+                  ],
+                  "properties": {
+                    "tool": {
+                      "type": "string"
+                    },
+                    "args": {
+                      "type": "object"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "responses": {
+            "200": {
+              "description": "Tool result"
+            },
+            "404": {
+              "description": "Server or tool not found"
+            },
+            "502": {
+              "description": "Upstream MCP failure"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-media-audio",
+      "kind": "api",
+      "title": "/v1/media/audio",
+      "summary": "Generate a sound effect — body {prompt, model?, backend?, duration?, seed?}",
+      "aliases": [
+        "/v1/media/audio"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Media",
         "v1",
-        "keys",
-        "{prefix}"
+        "media",
+        "audio"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -6847,7 +8104,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "DELETE /v1/keys/{prefix}"
+          "target": "POST /v1/media/audio"
         },
         {
           "type": "openapi",
@@ -6867,38 +8124,29 @@
         }
       ],
       "methods": [
-        "DELETE"
+        "POST"
       ],
       "tags": [
-        "Tools"
+        "Media"
       ],
       "operations": {
-        "delete": {
-          "summary": "Revoke a runtime key by prefix (admin scope)",
+        "post": {
+          "summary": "Generate a sound effect — body {prompt, model?, backend?, duration?, seed?}",
           "tags": [
-            "Tools"
-          ],
-          "parameters": [
-            {
-              "name": "prefix",
-              "in": "path",
-              "required": true,
-              "schema": {
-                "type": "string",
-                "minLength": 8
-              },
-              "description": "First 8+ characters of the key"
-            }
+            "Media"
           ],
           "responses": {
             "200": {
-              "description": "Number of keys revoked"
+              "description": "Generated audio path + gallery URL"
             },
             "400": {
-              "description": "Prefix too short"
+              "description": "Missing prompt"
             },
             "403": {
-              "description": "Admin scope required"
+              "description": "Insufficient scope"
+            },
+            "502": {
+              "description": "Generation failed"
             }
           }
         }
@@ -6909,20 +8157,22 @@
       ]
     },
     {
-      "id": "api.v1-mcps",
+      "id": "api.v1-media-av-analyze",
       "kind": "api",
-      "title": "/v1/mcps",
-      "summary": "List MCP servers (PT-03)",
+      "title": "/v1/media/av/analyze",
+      "summary": "Analyze a media file into a grounded entity/event/evidence answer (AV entity-comprehension) — body {path|mediaUri, question?}; reports per-role live-vs-mock adapter status",
       "aliases": [
-        "/v1/mcps"
+        "/v1/media/av/analyze"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "GET",
-        "MCP",
+        "POST",
+        "Media",
         "v1",
-        "mcps"
+        "media",
+        "av",
+        "analyze"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -6934,7 +8184,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/mcps"
+          "target": "POST /v1/media/av/analyze"
         },
         {
           "type": "openapi",
@@ -6954,20 +8204,26 @@
         }
       ],
       "methods": [
-        "GET"
+        "POST"
       ],
       "tags": [
-        "MCP"
+        "Media"
       ],
       "operations": {
-        "get": {
-          "summary": "List MCP servers (PT-03)",
+        "post": {
+          "summary": "Analyze a media file into a grounded entity/event/evidence answer (AV entity-comprehension) — body {path|mediaUri, question?}; reports per-role live-vs-mock adapter status",
           "tags": [
-            "MCP"
+            "Media"
           ],
           "responses": {
             "200": {
-              "description": "Paginated MCP server list"
+              "description": "Grounded answer + entity/event graph"
+            },
+            "400": {
+              "description": "Missing media path"
+            },
+            "404": {
+              "description": "Media not found"
             }
           }
         }
@@ -6978,21 +8234,21 @@
       ]
     },
     {
-      "id": "api.v1-mcps-name",
+      "id": "api.v1-media-file",
       "kind": "api",
-      "title": "/v1/mcps/{name}",
-      "summary": "Get MCP server details (PT-03)",
+      "title": "/v1/media/file",
+      "summary": "Stream one generated media file — query {kind, name}",
       "aliases": [
-        "/v1/mcps/{name}"
+        "/v1/media/file"
       ],
       "keywords": [
         "rest",
         "openapi",
         "GET",
-        "MCP",
+        "Media",
         "v1",
-        "mcps",
-        "{name}"
+        "media",
+        "file"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7004,7 +8260,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/mcps/{name}"
+          "target": "GET /v1/media/file"
         },
         {
           "type": "openapi",
@@ -7027,18 +8283,26 @@
         "GET"
       ],
       "tags": [
-        "MCP"
+        "Media"
       ],
       "operations": {
         "get": {
-          "summary": "Get MCP server details (PT-03)",
+          "summary": "Stream one generated media file — query {kind, name}",
           "tags": [
-            "MCP"
+            "Media"
           ],
           "parameters": [
+            {
+              "name": "kind",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            },
             {
               "name": "name",
-              "in": "path",
+              "in": "query",
               "required": true,
               "schema": {
                 "type": "string"
@@ -7047,7 +8311,7 @@
           ],
           "responses": {
             "200": {
-              "description": "Server details"
+              "description": "Media bytes"
             },
             "404": {
               "description": "Not found"
@@ -7061,22 +8325,21 @@
       ]
     },
     {
-      "id": "api.v1-mcps-name-call",
+      "id": "api.v1-media-gallery",
       "kind": "api",
-      "title": "/v1/mcps/{name}/call",
-      "summary": "Invoke a tool on an MCP server (PT-03)",
+      "title": "/v1/media/gallery",
+      "summary": "List previously generated media from the global store, newest first",
       "aliases": [
-        "/v1/mcps/{name}/call"
+        "/v1/media/gallery"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "POST",
-        "MCP",
+        "GET",
+        "Media",
         "v1",
-        "mcps",
-        "{name}",
-        "call"
+        "media",
+        "gallery"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7088,7 +8351,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/mcps/{name}/call"
+          "target": "GET /v1/media/gallery"
         },
         {
           "type": "openapi",
@@ -7108,47 +8371,36 @@
         }
       ],
       "methods": [
-        "POST"
+        "GET"
       ],
       "tags": [
-        "MCP"
+        "Media"
       ],
       "operations": {
-        "post": {
-          "summary": "Invoke a tool on an MCP server (PT-03)",
+        "get": {
+          "summary": "List previously generated media from the global store, newest first",
           "tags": [
-            "MCP"
+            "Media"
           ],
-          "requestBody": {
-            "required": true,
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "tool"
-                  ],
-                  "properties": {
-                    "tool": {
-                      "type": "string"
-                    },
-                    "args": {
-                      "type": "object"
-                    }
-                  }
-                }
+          "parameters": [
+            {
+              "name": "kind",
+              "in": "query",
+              "schema": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "limit",
+              "in": "query",
+              "schema": {
+                "type": "integer"
               }
             }
-          },
+          ],
           "responses": {
             "200": {
-              "description": "Tool result"
-            },
-            "404": {
-              "description": "Server or tool not found"
-            },
-            "502": {
-              "description": "Upstream MCP failure"
+              "description": "Gallery items with browsable URLs"
             }
           }
         }
@@ -7159,12 +8411,12 @@
       ]
     },
     {
-      "id": "api.v1-media-audio",
+      "id": "api.v1-media-image",
       "kind": "api",
-      "title": "/v1/media/audio",
-      "summary": "Generate a sound effect — body {prompt, model?, backend?, duration?, seed?}",
+      "title": "/v1/media/image",
+      "summary": "Generate an image — body {prompt, model?, backend?, width?, height?, steps?, guidance?, seed?, aspect_ratio?}",
       "aliases": [
-        "/v1/media/audio"
+        "/v1/media/image"
       ],
       "keywords": [
         "rest",
@@ -7173,7 +8425,7 @@
         "Media",
         "v1",
         "media",
-        "audio"
+        "image"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7185,7 +8437,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/audio"
+          "target": "POST /v1/media/image"
         },
         {
           "type": "openapi",
@@ -7212,13 +8464,13 @@
       ],
       "operations": {
         "post": {
-          "summary": "Generate a sound effect — body {prompt, model?, backend?, duration?, seed?}",
+          "summary": "Generate an image — body {prompt, model?, backend?, width?, height?, steps?, guidance?, seed?, aspect_ratio?}",
           "tags": [
             "Media"
           ],
           "responses": {
             "200": {
-              "description": "Generated audio path + gallery URL"
+              "description": "Generated image path + gallery URL"
             },
             "400": {
               "description": "Missing prompt"
@@ -7238,12 +8490,12 @@
       ]
     },
     {
-      "id": "api.v1-media-av-analyze",
+      "id": "api.v1-media-migrate",
       "kind": "api",
-      "title": "/v1/media/av/analyze",
-      "summary": "Analyze a media file into a grounded entity/event/evidence answer (AV entity-comprehension) — body {path|mediaUri, question?}; reports per-role live-vs-mock adapter status",
+      "title": "/v1/media/migrate",
+      "summary": "Dedup + migrate legacy per-group media caches into the unified store — body {dryRun?, roots?, maxDepth?}",
       "aliases": [
-        "/v1/media/av/analyze"
+        "/v1/media/migrate"
       ],
       "keywords": [
         "rest",
@@ -7252,8 +8504,7 @@
         "Media",
         "v1",
         "media",
-        "av",
-        "analyze"
+        "migrate"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7265,7 +8516,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/av/analyze"
+          "target": "POST /v1/media/migrate"
         },
         {
           "type": "openapi",
@@ -7292,19 +8543,16 @@
       ],
       "operations": {
         "post": {
-          "summary": "Analyze a media file into a grounded entity/event/evidence answer (AV entity-comprehension) — body {path|mediaUri, question?}; reports per-role live-vs-mock adapter status",
+          "summary": "Dedup + migrate legacy per-group media caches into the unified store — body {dryRun?, roots?, maxDepth?}",
           "tags": [
             "Media"
           ],
           "responses": {
             "200": {
-              "description": "Grounded answer + entity/event graph"
-            },
-            "400": {
-              "description": "Missing media path"
+              "description": "Migration report (bytes reclaimed/migrated)"
             },
-            "404": {
-              "description": "Media not found"
+            "403": {
+              "description": "Insufficient scope"
             }
           }
         }
@@ -7315,12 +8563,12 @@
       ]
     },
     {
-      "id": "api.v1-media-file",
+      "id": "api.v1-media-models",
       "kind": "api",
-      "title": "/v1/media/file",
-      "summary": "Stream one generated media file — query {kind, name}",
+      "title": "/v1/media/models",
+      "summary": "List available generative media models per kind (image/video/audio/music)",
       "aliases": [
-        "/v1/media/file"
+        "/v1/media/models"
       ],
       "keywords": [
         "rest",
@@ -7329,7 +8577,7 @@
         "Media",
         "v1",
         "media",
-        "file"
+        "models"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7341,7 +8589,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/media/file"
+          "target": "GET /v1/media/models"
         },
         {
           "type": "openapi",
@@ -7368,7 +8616,7 @@
       ],
       "operations": {
         "get": {
-          "summary": "Stream one generated media file — query {kind, name}",
+          "summary": "List available generative media models per kind (image/video/audio/music)",
           "tags": [
             "Media"
           ],
@@ -7376,26 +8624,20 @@
             {
               "name": "kind",
               "in": "query",
-              "required": true,
-              "schema": {
-                "type": "string"
-              }
-            },
-            {
-              "name": "name",
-              "in": "query",
-              "required": true,
               "schema": {
-                "type": "string"
+                "type": "string",
+                "enum": [
+                  "image",
+                  "video",
+                  "audio",
+                  "music"
+                ]
               }
             }
           ],
           "responses": {
             "200": {
-              "description": "Media bytes"
-            },
-            "404": {
-              "description": "Not found"
+              "description": "Model catalogue grouped by kind"
             }
           }
         }
@@ -7406,21 +8648,21 @@
       ]
     },
     {
-      "id": "api.v1-media-gallery",
+      "id": "api.v1-media-music",
       "kind": "api",
-      "title": "/v1/media/gallery",
-      "summary": "List previously generated media from the global store, newest first",
+      "title": "/v1/media/music",
+      "summary": "Generate music — body {prompt, model?, backend?, duration?, seed?}",
       "aliases": [
-        "/v1/media/gallery"
+        "/v1/media/music"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "GET",
+        "POST",
         "Media",
         "v1",
         "media",
-        "gallery"
+        "music"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7432,7 +8674,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/media/gallery"
+          "target": "POST /v1/media/music"
         },
         {
           "type": "openapi",
@@ -7452,36 +8694,29 @@
         }
       ],
       "methods": [
-        "GET"
+        "POST"
       ],
       "tags": [
         "Media"
       ],
       "operations": {
-        "get": {
-          "summary": "List previously generated media from the global store, newest first",
+        "post": {
+          "summary": "Generate music — body {prompt, model?, backend?, duration?, seed?}",
           "tags": [
             "Media"
           ],
-          "parameters": [
-            {
-              "name": "kind",
-              "in": "query",
-              "schema": {
-                "type": "string"
-              }
-            },
-            {
-              "name": "limit",
-              "in": "query",
-              "schema": {
-                "type": "integer"
-              }
-            }
-          ],
           "responses": {
             "200": {
-              "description": "Gallery items with browsable URLs"
+              "description": "Generated music path + gallery URL"
+            },
+            "400": {
+              "description": "Missing prompt"
+            },
+            "403": {
+              "description": "Insufficient scope"
+            },
+            "502": {
+              "description": "Generation failed"
             }
           }
         }
@@ -7492,12 +8727,12 @@
       ]
     },
     {
-      "id": "api.v1-media-image",
+      "id": "api.v1-media-relocate",
       "kind": "api",
-      "title": "/v1/media/image",
-      "summary": "Generate an image — body {prompt, model?, backend?, width?, height?, steps?, guidance?, seed?, aspect_ratio?}",
+      "title": "/v1/media/relocate",
+      "summary": "Relocate the whole media store (weights/venvs/gallery) to a chosen folder — body {newRoot, dryRun?}; streams media.relocate_progress and returns 202 + job_id",
       "aliases": [
-        "/v1/media/image"
+        "/v1/media/relocate"
       ],
       "keywords": [
         "rest",
@@ -7506,7 +8741,7 @@
         "Media",
         "v1",
         "media",
-        "image"
+        "relocate"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7518,7 +8753,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/image"
+          "target": "POST /v1/media/relocate"
         },
         {
           "type": "openapi",
@@ -7545,22 +8780,22 @@
       ],
       "operations": {
         "post": {
-          "summary": "Generate an image — body {prompt, model?, backend?, width?, height?, steps?, guidance?, seed?, aspect_ratio?}",
+          "summary": "Relocate the whole media store (weights/venvs/gallery) to a chosen folder — body {newRoot, dryRun?}; streams media.relocate_progress and returns 202 + job_id",
           "tags": [
             "Media"
           ],
           "responses": {
             "200": {
-              "description": "Generated image path + gallery URL"
+              "description": "Dry-run plan"
             },
-            "400": {
-              "description": "Missing prompt"
+            "202": {
+              "description": "Relocation started"
             },
-            "403": {
-              "description": "Insufficient scope"
+            "400": {
+              "description": "Missing newRoot"
             },
-            "502": {
-              "description": "Generation failed"
+            "409": {
+              "description": "Relocation already running"
             }
           }
         }
@@ -7571,21 +8806,22 @@
       ]
     },
     {
-      "id": "api.v1-media-migrate",
+      "id": "api.v1-media-relocate-status",
       "kind": "api",
-      "title": "/v1/media/migrate",
-      "summary": "Dedup + migrate legacy per-group media caches into the unified store — body {dryRun?, roots?, maxDepth?}",
+      "title": "/v1/media/relocate/status",
+      "summary": "Status of the in-flight (or last) media-store relocation job",
       "aliases": [
-        "/v1/media/migrate"
+        "/v1/media/relocate/status"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "POST",
+        "GET",
         "Media",
         "v1",
         "media",
-        "migrate"
+        "relocate",
+        "status"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7597,7 +8833,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/migrate"
+          "target": "GET /v1/media/relocate/status"
         },
         {
           "type": "openapi",
@@ -7617,23 +8853,20 @@
         }
       ],
       "methods": [
-        "POST"
+        "GET"
       ],
       "tags": [
         "Media"
       ],
       "operations": {
-        "post": {
-          "summary": "Dedup + migrate legacy per-group media caches into the unified store — body {dryRun?, roots?, maxDepth?}",
+        "get": {
+          "summary": "Status of the in-flight (or last) media-store relocation job",
           "tags": [
             "Media"
           ],
           "responses": {
             "200": {
-              "description": "Migration report (bytes reclaimed/migrated)"
-            },
-            "403": {
-              "description": "Insufficient scope"
+              "description": "Relocation job status + progress"
             }
           }
         }
@@ -7644,12 +8877,12 @@
       ]
     },
     {
-      "id": "api.v1-media-models",
+      "id": "api.v1-media-store",
       "kind": "api",
-      "title": "/v1/media/models",
-      "summary": "List available generative media models per kind (image/video/audio/music)",
+      "title": "/v1/media/store",
+      "summary": "Media-store root + disk usage plus any legacy per-group caches still reclaimable",
       "aliases": [
-        "/v1/media/models"
+        "/v1/media/store"
       ],
       "keywords": [
         "rest",
@@ -7658,7 +8891,7 @@
         "Media",
         "v1",
         "media",
-        "models"
+        "store"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7670,7 +8903,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/media/models"
+          "target": "GET /v1/media/store"
         },
         {
           "type": "openapi",
@@ -7697,28 +8930,13 @@
       ],
       "operations": {
         "get": {
-          "summary": "List available generative media models per kind (image/video/audio/music)",
+          "summary": "Media-store root + disk usage plus any legacy per-group caches still reclaimable",
           "tags": [
             "Media"
           ],
-          "parameters": [
-            {
-              "name": "kind",
-              "in": "query",
-              "schema": {
-                "type": "string",
-                "enum": [
-                  "image",
-                  "video",
-                  "audio",
-                  "music"
-                ]
-              }
-            }
-          ],
           "responses": {
             "200": {
-              "description": "Model catalogue grouped by kind"
+              "description": "Store + disk + legacy-cache report"
             }
           }
         }
@@ -7729,12 +8947,12 @@
       ]
     },
     {
-      "id": "api.v1-media-music",
+      "id": "api.v1-media-video",
       "kind": "api",
-      "title": "/v1/media/music",
-      "summary": "Generate music — body {prompt, model?, backend?, duration?, seed?}",
+      "title": "/v1/media/video",
+      "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
       "aliases": [
-        "/v1/media/music"
+        "/v1/media/video"
       ],
       "keywords": [
         "rest",
@@ -7743,7 +8961,7 @@
         "Media",
         "v1",
         "media",
-        "music"
+        "video"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7755,7 +8973,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/music"
+          "target": "POST /v1/media/video"
         },
         {
           "type": "openapi",
@@ -7782,13 +9000,13 @@
       ],
       "operations": {
         "post": {
-          "summary": "Generate music — body {prompt, model?, backend?, duration?, seed?}",
+          "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
           "tags": [
             "Media"
           ],
           "responses": {
             "200": {
-              "description": "Generated music path + gallery URL"
+              "description": "Generated video path + gallery URL"
             },
             "400": {
               "description": "Missing prompt"
@@ -7808,21 +9026,20 @@
       ]
     },
     {
-      "id": "api.v1-media-relocate",
+      "id": "api.v1-memory",
       "kind": "api",
-      "title": "/v1/media/relocate",
-      "summary": "Relocate the whole media store (weights/venvs/gallery) to a chosen folder — body {newRoot, dryRun?}; streams media.relocate_progress and returns 202 + job_id",
+      "title": "/v1/memory",
+      "summary": "Memory backends summary (PT-04)",
       "aliases": [
-        "/v1/media/relocate"
+        "/v1/memory"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "POST",
-        "Media",
+        "GET",
+        "Memory",
         "v1",
-        "media",
-        "relocate"
+        "memory"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7834,7 +9051,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/relocate"
+          "target": "GET /v1/memory"
         },
         {
           "type": "openapi",
@@ -7854,29 +9071,20 @@
         }
       ],
       "methods": [
-        "POST"
+        "GET"
       ],
       "tags": [
-        "Media"
+        "Memory"
       ],
       "operations": {
-        "post": {
-          "summary": "Relocate the whole media store (weights/venvs/gallery) to a chosen folder — body {newRoot, dryRun?}; streams media.relocate_progress and returns 202 + job_id",
+        "get": {
+          "summary": "Memory backends summary (PT-04)",
           "tags": [
-            "Media"
+            "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Dry-run plan"
-            },
-            "202": {
-              "description": "Relocation started"
-            },
-            "400": {
-              "description": "Missing newRoot"
-            },
-            "409": {
-              "description": "Relocation already running"
+              "description": "Backend availability + sample counts"
             }
           }
         }
@@ -7887,22 +9095,21 @@
       ]
     },
     {
-      "id": "api.v1-media-relocate-status",
+      "id": "api.v1-memory-entities",
       "kind": "api",
-      "title": "/v1/media/relocate/status",
-      "summary": "Status of the in-flight (or last) media-store relocation job",
+      "title": "/v1/memory/entities",
+      "summary": "List extracted memory entities",
       "aliases": [
-        "/v1/media/relocate/status"
+        "/v1/memory/entities"
       ],
       "keywords": [
         "rest",
         "openapi",
         "GET",
-        "Media",
+        "Memory",
         "v1",
-        "media",
-        "relocate",
-        "status"
+        "memory",
+        "entities"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7914,7 +9121,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/media/relocate/status"
+          "target": "GET /v1/memory/entities"
         },
         {
           "type": "openapi",
@@ -7937,17 +9144,17 @@
         "GET"
       ],
       "tags": [
-        "Media"
+        "Memory"
       ],
       "operations": {
         "get": {
-          "summary": "Status of the in-flight (or last) media-store relocation job",
+          "summary": "List extracted memory entities",
           "tags": [
-            "Media"
+            "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Relocation job status + progress"
+              "description": "Entity list"
             }
           }
         }
@@ -7958,21 +9165,21 @@
       ]
     },
     {
-      "id": "api.v1-media-store",
+      "id": "api.v1-memory-episodes",
       "kind": "api",
-      "title": "/v1/media/store",
-      "summary": "Media-store root + disk usage plus any legacy per-group caches still reclaimable",
+      "title": "/v1/memory/episodes",
+      "summary": "List episodes",
       "aliases": [
-        "/v1/media/store"
+        "/v1/memory/episodes"
       ],
       "keywords": [
         "rest",
         "openapi",
         "GET",
-        "Media",
+        "Memory",
         "v1",
-        "media",
-        "store"
+        "memory",
+        "episodes"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -7984,7 +9191,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/media/store"
+          "target": "GET /v1/memory/episodes"
         },
         {
           "type": "openapi",
@@ -8007,17 +9214,17 @@
         "GET"
       ],
       "tags": [
-        "Media"
+        "Memory"
       ],
       "operations": {
         "get": {
-          "summary": "Media-store root + disk usage plus any legacy per-group caches still reclaimable",
+          "summary": "List episodes",
           "tags": [
-            "Media"
+            "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Store + disk + legacy-cache report"
+              "description": "Paginated episodes"
             }
           }
         }
@@ -8028,21 +9235,21 @@
       ]
     },
     {
-      "id": "api.v1-media-video",
+      "id": "api.v1-memory-failures",
       "kind": "api",
-      "title": "/v1/media/video",
-      "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
+      "title": "/v1/memory/failures",
+      "summary": "List failures",
       "aliases": [
-        "/v1/media/video"
+        "/v1/memory/failures"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "POST",
-        "Media",
+        "GET",
+        "Memory",
         "v1",
-        "media",
-        "video"
+        "memory",
+        "failures"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -8054,7 +9261,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/video"
+          "target": "GET /v1/memory/failures"
         },
         {
           "type": "openapi",
@@ -8074,29 +9281,20 @@
         }
       ],
       "methods": [
-        "POST"
+        "GET"
       ],
       "tags": [
-        "Media"
+        "Memory"
       ],
       "operations": {
-        "post": {
-          "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
+        "get": {
+          "summary": "List failures",
           "tags": [
-            "Media"
+            "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Generated video path + gallery URL"
-            },
-            "400": {
-              "description": "Missing prompt"
-            },
-            "403": {
-              "description": "Insufficient scope"
-            },
-            "502": {
-              "description": "Generation failed"
+              "description": "Paginated failures"
             }
           }
         }
@@ -8107,20 +9305,21 @@
       ]
     },
     {
-      "id": "api.v1-memory",
+      "id": "api.v1-memory-feedback",
       "kind": "api",
-      "title": "/v1/memory",
-      "summary": "Memory backends summary (PT-04)",
+      "title": "/v1/memory/feedback",
+      "summary": "Record relevance or quality feedback for a memory item",
       "aliases": [
-        "/v1/memory"
+        "/v1/memory/feedback"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "GET",
+        "POST",
         "Memory",
         "v1",
-        "memory"
+        "memory",
+        "feedback"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -8132,7 +9331,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/memory"
+          "target": "POST /v1/memory/feedback"
         },
         {
           "type": "openapi",
@@ -8152,20 +9351,23 @@
         }
       ],
       "methods": [
-        "GET"
+        "POST"
       ],
       "tags": [
         "Memory"
       ],
       "operations": {
-        "get": {
-          "summary": "Memory backends summary (PT-04)",
+        "post": {
+          "summary": "Record relevance or quality feedback for a memory item",
           "tags": [
             "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Backend availability + sample counts"
+              "description": "Feedback recorded"
+            },
+            "400": {
+              "description": "Invalid feedback"
             }
           }
         }
@@ -8176,21 +9378,21 @@
       ]
     },
     {
-      "id": "api.v1-memory-episodes",
+      "id": "api.v1-memory-ingest",
       "kind": "api",
-      "title": "/v1/memory/episodes",
-      "summary": "List episodes",
+      "title": "/v1/memory/ingest",
+      "summary": "Ingest content or files into Omnius memory",
       "aliases": [
-        "/v1/memory/episodes"
+        "/v1/memory/ingest"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "GET",
+        "POST",
         "Memory",
         "v1",
         "memory",
-        "episodes"
+        "ingest"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -8202,7 +9404,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/memory/episodes"
+          "target": "POST /v1/memory/ingest"
         },
         {
           "type": "openapi",
@@ -8222,20 +9424,23 @@
         }
       ],
       "methods": [
-        "GET"
+        "POST"
       ],
       "tags": [
         "Memory"
       ],
       "operations": {
-        "get": {
-          "summary": "List episodes",
+        "post": {
+          "summary": "Ingest content or files into Omnius memory",
           "tags": [
             "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Paginated episodes"
+              "description": "Ingestion result"
+            },
+            "400": {
+              "description": "Invalid ingestion request"
             }
           }
         }
@@ -8246,21 +9451,22 @@
       ]
     },
     {
-      "id": "api.v1-memory-failures",
+      "id": "api.v1-memory-jobs-run",
       "kind": "api",
-      "title": "/v1/memory/failures",
-      "summary": "List failures",
+      "title": "/v1/memory/jobs/run",
+      "summary": "Run a named memory maintenance job",
       "aliases": [
-        "/v1/memory/failures"
+        "/v1/memory/jobs/run"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "GET",
+        "POST",
         "Memory",
         "v1",
         "memory",
-        "failures"
+        "jobs",
+        "run"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -8272,7 +9478,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/memory/failures"
+          "target": "POST /v1/memory/jobs/run"
         },
         {
           "type": "openapi",
@@ -8292,20 +9498,23 @@
         }
       ],
       "methods": [
-        "GET"
+        "POST"
       ],
       "tags": [
         "Memory"
       ],
       "operations": {
-        "get": {
-          "summary": "List failures",
+        "post": {
+          "summary": "Run a named memory maintenance job",
           "tags": [
             "Memory"
           ],
           "responses": {
             "200": {
-              "description": "Paginated failures"
+              "description": "Maintenance job result"
+            },
+            "400": {
+              "description": "Invalid job request"
             }
           }
         }
@@ -9432,14 +10641,227 @@
             }
           }
         },
-        "delete": {
-          "summary": "Reset preferences to default",
+        "delete": {
+          "summary": "Reset preferences to default",
+          "tags": [
+            "Projects"
+          ],
+          "responses": {
+            "200": {
+              "description": "Removed"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-projects-register",
+      "kind": "api",
+      "title": "/v1/projects/register",
+      "summary": "Register a project root — body {root, pid?}",
+      "aliases": [
+        "/v1/projects/register"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Projects",
+        "v1",
+        "projects",
+        "register"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/projects/register"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Projects"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Register a project root — body {root, pid?}",
+          "tags": [
+            "Projects"
+          ],
+          "responses": {
+            "200": {
+              "description": "Registered"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-projects-rename",
+      "kind": "api",
+      "title": "/v1/projects/rename",
+      "summary": "Rename a project — body {root, name}",
+      "aliases": [
+        "/v1/projects/rename"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Projects",
+        "v1",
+        "projects",
+        "rename"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/projects/rename"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Projects"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Rename a project — body {root, name}",
+          "tags": [
+            "Projects"
+          ],
+          "responses": {
+            "200": {
+              "description": "Renamed"
+            },
+            "404": {
+              "description": "Unknown project"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-projects-scan",
+      "kind": "api",
+      "title": "/v1/projects/scan",
+      "summary": "Scan configured roots for discoverable project workspaces",
+      "aliases": [
+        "/v1/projects/scan"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "Projects",
+        "v1",
+        "projects",
+        "scan"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/projects/scan"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "Projects"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Scan configured roots for discoverable project workspaces",
           "tags": [
             "Projects"
           ],
           "responses": {
             "200": {
-              "description": "Removed"
+              "description": "Discovered project roots"
             }
           }
         }
@@ -9450,12 +10872,12 @@
       ]
     },
     {
-      "id": "api.v1-projects-register",
+      "id": "api.v1-projects-switch",
       "kind": "api",
-      "title": "/v1/projects/register",
-      "summary": "Register a project root — body {root, pid?}",
+      "title": "/v1/projects/switch",
+      "summary": "Set the active project — body {root, registerIfMissing?}",
       "aliases": [
-        "/v1/projects/register"
+        "/v1/projects/switch"
       ],
       "keywords": [
         "rest",
@@ -9464,7 +10886,7 @@
         "Projects",
         "v1",
         "projects",
-        "register"
+        "switch"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -9476,7 +10898,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/projects/register"
+          "target": "POST /v1/projects/switch"
         },
         {
           "type": "openapi",
@@ -9503,13 +10925,16 @@
       ],
       "operations": {
         "post": {
-          "summary": "Register a project root — body {root, pid?}",
+          "summary": "Set the active project — body {root, registerIfMissing?}",
           "tags": [
             "Projects"
           ],
           "responses": {
             "200": {
-              "description": "Registered"
+              "description": "Switched"
+            },
+            "404": {
+              "description": "Unknown project"
             }
           }
         }
@@ -9520,21 +10945,20 @@
       ]
     },
     {
-      "id": "api.v1-projects-rename",
+      "id": "api.v1-realtime",
       "kind": "api",
-      "title": "/v1/projects/rename",
-      "summary": "Rename a project — body {root, name}",
+      "title": "/v1/realtime",
+      "summary": "Auth-scoped alias for the text-only realtime voice adapter",
       "aliases": [
-        "/v1/projects/rename"
+        "/v1/realtime"
       ],
       "keywords": [
         "rest",
         "openapi",
         "POST",
-        "Projects",
+        "Chat",
         "v1",
-        "projects",
-        "rename"
+        "realtime"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -9546,7 +10970,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/projects/rename"
+          "target": "POST /v1/realtime"
         },
         {
           "type": "openapi",
@@ -9569,20 +10993,61 @@
         "POST"
       ],
       "tags": [
-        "Projects"
+        "Chat"
       ],
       "operations": {
         "post": {
-          "summary": "Rename a project — body {root, name}",
+          "summary": "Auth-scoped alias for the text-only realtime voice adapter",
+          "description": "Equivalent to POST /realtime and protected by the daemon's /v1 auth policy.",
           "tags": [
-            "Projects"
+            "Chat"
           ],
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    },
+                    "recent_turn": {
+                      "type": "string"
+                    },
+                    "asr_text": {
+                      "type": "string"
+                    },
+                    "callerText": {
+                      "type": "string"
+                    },
+                    "soul_md": {
+                      "type": "string"
+                    },
+                    "format": {
+                      "type": "string",
+                      "enum": [
+                        "json",
+                        "text"
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
           "responses": {
             "200": {
-              "description": "Renamed"
+              "description": "Short conversational reply"
             },
-            "404": {
-              "description": "Unknown project"
+            "400": {
+              "description": "No transcript text supplied"
+            },
+            "500": {
+              "description": "Realtime backend request failed"
             }
           }
         }
@@ -9593,21 +11058,20 @@
       ]
     },
     {
-      "id": "api.v1-projects-switch",
+      "id": "api.v1-routes",
       "kind": "api",
-      "title": "/v1/projects/switch",
-      "summary": "Set the active project — body {root, registerIfMissing?}",
+      "title": "/v1/routes",
+      "summary": "Flat grep-friendly daemon route summary",
       "aliases": [
-        "/v1/projects/switch"
+        "/v1/routes"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "POST",
-        "Projects",
+        "GET",
+        "Discovery",
         "v1",
-        "projects",
-        "switch"
+        "routes"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -9619,7 +11083,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/projects/switch"
+          "target": "GET /v1/routes"
         },
         {
           "type": "openapi",
@@ -9639,23 +11103,21 @@
         }
       ],
       "methods": [
-        "POST"
+        "GET"
       ],
       "tags": [
-        "Projects"
+        "Discovery"
       ],
       "operations": {
-        "post": {
-          "summary": "Set the active project — body {root, registerIfMissing?}",
+        "get": {
+          "summary": "Flat grep-friendly daemon route summary",
           "tags": [
-            "Projects"
+            "Discovery"
           ],
+          "security": [],
           "responses": {
             "200": {
-              "description": "Switched"
-            },
-            "404": {
-              "description": "Unknown project"
+              "description": "Human- and agent-readable route map"
             }
           }
         }
@@ -9999,6 +11461,90 @@
         "packages/cli/src/api/openapi.ts"
       ]
     },
+    {
+      "id": "api.v1-runs-id-output",
+      "kind": "api",
+      "title": "/v1/runs/{id}/output",
+      "summary": "Read the captured output for one agentic run",
+      "aliases": [
+        "/v1/runs/{id}/output"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "Agentic",
+        "v1",
+        "runs",
+        "{id}",
+        "output"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/runs/{id}/output"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "Agentic"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Read the captured output for one agentic run",
+          "tags": [
+            "Agentic"
+          ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Run output and status"
+            },
+            "404": {
+              "description": "Run not found"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
     {
       "id": "api.v1-scheduled",
       "kind": "api",
@@ -10072,18 +11618,88 @@
       "id": "api.v1-scheduled-all",
       "kind": "api",
       "title": "/v1/scheduled/all",
-      "summary": "List all scheduled jobs (all queues)",
+      "summary": "Delete all scheduled tasks, timers, cron entries, and persisted sources",
       "aliases": [
         "/v1/scheduled/all"
       ],
       "keywords": [
         "rest",
         "openapi",
-        "GET",
+        "DELETE",
+        "Engines",
+        "v1",
+        "scheduled",
+        "all"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "DELETE /v1/scheduled/all"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "DELETE"
+      ],
+      "tags": [
+        "Engines"
+      ],
+      "operations": {
+        "delete": {
+          "summary": "Delete all scheduled tasks, timers, cron entries, and persisted sources",
+          "tags": [
+            "Engines"
+          ],
+          "responses": {
+            "200": {
+              "description": "Deletion and cleanup report"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-scheduled-fixup",
+      "kind": "api",
+      "title": "/v1/scheduled/fixup",
+      "summary": "Reconcile scheduled job state",
+      "aliases": [
+        "/v1/scheduled/fixup"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
         "Engines",
         "v1",
         "scheduled",
-        "all"
+        "fixup"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -10095,7 +11711,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/scheduled/all"
+          "target": "POST /v1/scheduled/fixup"
         },
         {
           "type": "openapi",
@@ -10115,20 +11731,20 @@
         }
       ],
       "methods": [
-        "GET"
+        "POST"
       ],
       "tags": [
         "Engines"
       ],
       "operations": {
-        "get": {
-          "summary": "List all scheduled jobs (all queues)",
+        "post": {
+          "summary": "Reconcile scheduled job state",
           "tags": [
             "Engines"
           ],
           "responses": {
             "200": {
-              "description": "Scheduled jobs (full)"
+              "description": "Reconciled"
             }
           }
         }
@@ -10139,21 +11755,22 @@
       ]
     },
     {
-      "id": "api.v1-scheduled-fixup",
+      "id": "api.v1-scheduled-id",
       "kind": "api",
-      "title": "/v1/scheduled/fixup",
-      "summary": "Reconcile scheduled job state",
+      "title": "/v1/scheduled/{id}",
+      "summary": "Enable or disable one scheduled task or user timer; Delete one scheduled task or user timer",
       "aliases": [
-        "/v1/scheduled/fixup"
+        "/v1/scheduled/{id}"
       ],
       "keywords": [
         "rest",
         "openapi",
         "POST",
+        "DELETE",
         "Engines",
         "v1",
         "scheduled",
-        "fixup"
+        "{id}"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -10165,7 +11782,11 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/scheduled/fixup"
+          "target": "POST /v1/scheduled/{id}"
+        },
+        {
+          "type": "rest",
+          "target": "DELETE /v1/scheduled/{id}"
         },
         {
           "type": "openapi",
@@ -10185,20 +11806,76 @@
         }
       ],
       "methods": [
-        "POST"
+        "POST",
+        "DELETE"
       ],
       "tags": [
         "Engines"
       ],
       "operations": {
         "post": {
-          "summary": "Reconcile scheduled job state",
+          "summary": "Enable or disable one scheduled task or user timer",
           "tags": [
             "Engines"
           ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "requestBody": {
+            "required": true,
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "enabled"
+                  ],
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "responses": {
             "200": {
-              "description": "Reconciled"
+              "description": "Scheduled item updated"
+            },
+            "404": {
+              "description": "Scheduled item not found"
+            }
+          }
+        },
+        "delete": {
+          "summary": "Delete one scheduled task or user timer",
+          "tags": [
+            "Engines"
+          ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Scheduled item deleted"
+            },
+            "404": {
+              "description": "Scheduled item not found"
             }
           }
         }
@@ -10282,13 +11959,14 @@
       "id": "api.v1-scheduled-reconcile",
       "kind": "api",
       "title": "/v1/scheduled/reconcile",
-      "summary": "Force-reconcile scheduled jobs against persisted state",
+      "summary": "Preview reconciliation of persisted and legacy scheduled jobs; Preview or apply scheduled-job reconciliation",
       "aliases": [
         "/v1/scheduled/reconcile"
       ],
       "keywords": [
         "rest",
         "openapi",
+        "GET",
         "POST",
         "Engines",
         "v1",
@@ -10303,6 +11981,10 @@
         "coding-agent"
       ],
       "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/scheduled/reconcile"
+        },
         {
           "type": "rest",
           "target": "POST /v1/scheduled/reconcile"
@@ -10325,20 +12007,32 @@
         }
       ],
       "methods": [
+        "GET",
         "POST"
       ],
       "tags": [
         "Engines"
       ],
       "operations": {
+        "get": {
+          "summary": "Preview reconciliation of persisted and legacy scheduled jobs",
+          "tags": [
+            "Engines"
+          ],
+          "responses": {
+            "200": {
+              "description": "Reconciliation preview"
+            }
+          }
+        },
         "post": {
-          "summary": "Force-reconcile scheduled jobs against persisted state",
+          "summary": "Preview or apply scheduled-job reconciliation",
           "tags": [
             "Engines"
           ],
           "responses": {
             "200": {
-              "description": "Reconciled"
+              "description": "Reconciliation result"
             }
           }
         }
@@ -10488,6 +12182,93 @@
         "packages/cli/src/api/openapi.ts"
       ]
     },
+    {
+      "id": "api.v1-services-systemd-unit",
+      "kind": "api",
+      "title": "/v1/services/systemd/{unit}",
+      "summary": "Perform an action on one user-level systemd unit",
+      "aliases": [
+        "/v1/services/systemd/{unit}"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Engines",
+        "v1",
+        "services",
+        "systemd",
+        "{unit}"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/services/systemd/{unit}"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Engines"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Perform an action on one user-level systemd unit",
+          "tags": [
+            "Engines"
+          ],
+          "parameters": [
+            {
+              "name": "unit",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Service action completed"
+            },
+            "400": {
+              "description": "Missing action"
+            },
+            "500": {
+              "description": "Service action failed"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
     {
       "id": "api.v1-sessions",
       "kind": "api",
@@ -12261,6 +14042,79 @@
         "packages/cli/src/api/openapi.ts"
       ]
     },
+    {
+      "id": "api.v1-vision-embed",
+      "kind": "api",
+      "title": "/v1/vision/embed",
+      "summary": "Create a vision embedding for uploaded or referenced media",
+      "aliases": [
+        "/v1/vision/embed"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Vision",
+        "v1",
+        "vision",
+        "embed"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/vision/embed"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Vision"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Create a vision embedding for uploaded or referenced media",
+          "tags": [
+            "Vision"
+          ],
+          "responses": {
+            "200": {
+              "description": "Vision embedding result"
+            },
+            "400": {
+              "description": "Invalid media input"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
     {
       "id": "api.v1-voice-asr",
       "kind": "api",
@@ -23869,6 +25723,37 @@
         }
       ]
     },
+    {
+      "id": "guide.guides-dashboard",
+      "kind": "guide",
+      "title": "Web Dashboard",
+      "summary": "The Omnius daemon serves a zero-build, self-contained dashboard from the same origin as the REST API. Start it with omnius serve, then open http://127.0.0.1:11435/. The interface uses Omnius's compact NOCLIP-derived style kit and shared responsive observability-card grids; the route registry in packages/cli/src/api/web-ui.ts is the source of truth for pages ",
+      "keywords": [
+        "guides",
+        "dashboard",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/guides/dashboard.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/guides/dashboard.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.guides-media-generation",
       "kind": "guide",
@@ -24812,7 +26697,7 @@
       "id": "guide.reference-rest-api",
       "kind": "guide",
       "title": "REST API Reference",
-      "summary": "This is the maintained human endpoint inventory for the Omnius daemon. The machine contract is generated by packages/cli/src/api/openapi.ts and served at /openapi.json.",
+      "summary": "This is the maintained human inventory for the supported Omnius daemon API. The machine contract is generated by packages/cli/src/api/openapi.ts and served at /openapi.json; every operation in that contract must appear here, and the generated REST block in the root README must match this file byte-for-byte after heading normalization. Browser HTML routes and",
       "keywords": [
         "reference",
         "rest",