omnius 1.0.609 → 1.0.610

package/dist/index.js

@@ -808130,6 +808130,12 @@ function getOpenApiSpec() {
       "/health/startup": { get: { summary: "Startup complete", tags: ["Health"], security: [], responses: { 200: { description: "Started" } } } },
       "/version": { get: { summary: "Package, API, and discovery contract versions", tags: ["Health"], security: [], responses: { 200: { description: "Package/boot/API/discovery versions, package hash, Node.js, and platform" } } } },
       "/metrics": { get: { summary: "Prometheus metrics", tags: ["Health"], security: [], responses: { 200: { description: "Prometheus text format" } } } },
+      "/": { 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" } } } },
+      "/help": { get: { summary: "Compact daemon help and integration entrypoints", tags: ["Discovery"], security: [], responses: { 200: { description: "Text or JSON integration help" } } } },
+      "/v1/routes": { get: { summary: "Flat grep-friendly daemon route summary", tags: ["Discovery"], security: [], responses: { 200: { description: "Human- and agent-readable route map" } } } },
+      "/routes": { get: { summary: "Compatibility alias for the daemon route summary", tags: ["Discovery"], security: [], responses: { 200: { description: "Human- and agent-readable route map" } } } },
+      "/asyncapi.json": { get: { summary: "AsyncAPI 2.6 contract for the voicechat WebSocket", tags: ["Discovery"], security: [], responses: { 200: { description: "AsyncAPI document" } } } },
+      "/asyncapi": { get: { summary: "Compatibility alias for the AsyncAPI contract", tags: ["Discovery"], security: [], responses: { 200: { description: "AsyncAPI document" } } } },
       "/v1/discovery": {
         get: {
           summary: "Discover Omnius layers, workflows, runtimes, modules, stores, capabilities, tools, APIs, commands, skills, and docs",
@@ -808211,7 +808217,56 @@ function getOpenApiSpec() {
           }
         }
       },
-      "/v1/chat/sessions": { get: { summary: "List active chat sessions", tags: ["Chat"], responses: { 200: { description: "Session list" } } } },
+      "/realtime": {
+        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" } }
+        }
+      },
+      "/v1/realtime": {
+        post: {
+          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: ["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" } }
+        }
+      },
+      "/v1/chat/sessions": {
+        get: {
+          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" } }
+        }
+      },
+      "/v1/chat/sessions/{id}": {
+        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 deleted" }, 404: { description: "Session not found" } }
+        }
+      },
       "/v1/chat/sessions/{id}/summarize": { post: { summary: "Generate + cache an inference-based title/summary for a session — body {force?, root?}", tags: ["Chat"], responses: { 200: { description: "Title + summary" }, 500: { description: "Generation failed" } } } },
       "/v1/chat/suggest-followup": { post: { summary: "Suggest one short next-message follow-up for a session (ghost-text input) — body {session_id}", tags: ["Chat"], responses: { 200: { description: "{ suggestion }" } } } },
       "/v1/chat/sessions/{id}/status": { get: { summary: "Reactive recall: is this session running right now + unseen deltas since ?since=<seq> (running, phase, seq, partial, deltas[])", tags: ["Chat"], responses: { 200: { description: "Live run status + catch-up deltas" } } } },
@@ -808255,6 +808310,7 @@ function getOpenApiSpec() {
         get: { summary: "Get run details", tags: ["Agentic"], parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }], responses: { 200: { description: "Run record" }, 404: { description: "Not found" } } },
         delete: { summary: "Abort run", tags: ["Agentic"], responses: { 200: { description: "Aborted" }, 404: { description: "Not found" } } }
       },
+      "/v1/runs/{id}/output": { 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" } } } },
       // ───── Todos (WO-TASK-02 — agent-emitted checklist) ─────
       "/v1/todos": {
         get: {
@@ -808332,6 +808388,10 @@ function getOpenApiSpec() {
       "/v1/profiles": { get: { summary: "List tool profiles", tags: ["Profiles"], responses: { 200: { description: "Profile list" } } }, post: { summary: "Create tool profile", tags: ["Profiles"], responses: { 201: { description: "Created" } } } },
       "/v1/profiles/{name}": { get: { summary: "Get profile", tags: ["Profiles"], responses: { 200: { description: "Profile details" } } }, delete: { summary: "Delete profile", tags: ["Profiles"], responses: { 200: { description: "Deleted" } } } },
       "/v1/files": { get: { summary: "List workspace directory", tags: ["Files"], parameters: [{ name: "path", in: "query", schema: { type: "string" } }], responses: { 200: { description: "Directory entries" } } } },
+      "/v1/files/raw": {
+        get: { summary: "Stream raw workspace file bytes for browser previews", tags: ["Files"], 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" } } }
+      },
       // ───── Media generation (image/video/audio/music) ─────
       "/v1/media/models": { get: { summary: "List available generative media models per kind (image/video/audio/music)", tags: ["Media"], parameters: [{ name: "kind", in: "query", schema: { type: "string", enum: ["image", "video", "audio", "music"] } }], responses: { 200: { description: "Model catalogue grouped by kind" } } } },
       "/v1/media/store": { get: { summary: "Media-store root + disk usage plus any legacy per-group caches still reclaimable", tags: ["Media"], responses: { 200: { description: "Store + disk + legacy-cache report" } } } },
@@ -808407,6 +808467,10 @@ function getOpenApiSpec() {
       "/v1/memory/write": { post: { summary: "Write a memory entry (PT-04)", tags: ["Memory"], responses: { 201: { description: "Written" }, 403: { description: "Requires run/admin scope" } } } },
       "/v1/memory/episodes": { get: { summary: "List episodes", tags: ["Memory"], responses: { 200: { description: "Paginated episodes" } } } },
       "/v1/memory/failures": { get: { summary: "List failures", tags: ["Memory"], responses: { 200: { description: "Paginated failures" } } } },
+      "/v1/memory/ingest": { post: { summary: "Ingest content or files into Omnius memory", tags: ["Memory"], responses: { 200: { description: "Ingestion result" }, 400: { description: "Invalid ingestion request" } } } },
+      "/v1/memory/entities": { get: { summary: "List extracted memory entities", tags: ["Memory"], responses: { 200: { description: "Entity list" } } } },
+      "/v1/memory/jobs/run": { post: { summary: "Run a named memory maintenance job", tags: ["Memory"], responses: { 200: { description: "Maintenance job result" }, 400: { description: "Invalid job request" } } } },
+      "/v1/memory/feedback": { post: { summary: "Record relevance or quality feedback for a memory item", tags: ["Memory"], responses: { 200: { description: "Feedback recorded" }, 400: { description: "Invalid feedback" } } } },
       // ───── PT-06: Events ─────
       "/v1/events": {
         get: {
@@ -808710,6 +808774,13 @@ function getOpenApiSpec() {
         }
       },
       "/v1/vision/describe": { post: { summary: "Vision describe (deferred to PT-07)", tags: ["Vision"], responses: { 501: { description: "Not yet daemon-resident" } } } },
+      "/v1/vision/embed": { post: { summary: "Create a vision embedding for uploaded or referenced media", tags: ["Vision"], responses: { 200: { description: "Vision embedding result" }, 400: { description: "Invalid media input" } } } },
+      "/v1/audio/embed": { post: { summary: "Create an audio embedding for uploaded or referenced audio", tags: ["Voice"], responses: { 200: { description: "Audio embedding result" }, 400: { description: "Invalid audio input" } } } },
+      "/v1/chat/attachments": { post: { summary: "Upload an attachment for a stateful chat", tags: ["Chat"], responses: { 200: { description: "Stored attachment metadata" }, 400: { description: "Invalid attachment" } } } },
+      "/v1/admin/access": {
+        get: { summary: "Read the daemon network access mode", tags: ["Config"], responses: { 200: { 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" } } }
+      },
       // ───── Projects (workspace registry) ─────
       "/v1/projects": {
         get: { summary: "List registered project workspaces + current selection", tags: ["Projects"], responses: { 200: { description: "{projects[], current}" } } },
@@ -808719,6 +808790,7 @@ function getOpenApiSpec() {
       "/v1/projects/switch": { post: { summary: "Set the active project — body {root, registerIfMissing?}", tags: ["Projects"], responses: { 200: { description: "Switched" }, 404: { description: "Unknown project" } } } },
       "/v1/projects/register": { post: { summary: "Register a project root — body {root, pid?}", tags: ["Projects"], responses: { 200: { description: "Registered" } } } },
       "/v1/projects/rename": { post: { summary: "Rename a project — body {root, name}", tags: ["Projects"], responses: { 200: { description: "Renamed" }, 404: { description: "Unknown project" } } } },
+      "/v1/projects/scan": { get: { summary: "Scan configured roots for discoverable project workspaces", tags: ["Projects"], responses: { 200: { description: "Discovered project roots" } } } },
       "/v1/projects/preferences": {
         get: { summary: "Get per-project UI preferences (model, theme, current chat session id, current agent run id, recent indexes)", tags: ["Projects"], parameters: [{ name: "root", in: "query", schema: { type: "string" } }], responses: { 200: { description: "Preferences" }, 404: { description: "No current project AND no ?root supplied" } } },
         put: { summary: "Patch preferences (server-managed v + updatedAt are stripped from client patches)", tags: ["Projects"], responses: { 200: { description: "Merged" }, 400: { description: "Bad body" }, 404: { description: "No current project AND no ?root" } } },
@@ -808728,12 +808800,17 @@ function getOpenApiSpec() {
       "/v1/codegraph/snapshot": { get: { summary: "Code graph stats + last N events", tags: ["Tools"], responses: { 200: { description: "Snapshot" } } } },
       "/v1/codegraph/events": { get: { summary: "Code graph live events (SSE)", tags: ["Tools"], responses: { 200: { description: "SSE stream" } } } },
       "/v1/scheduled": { get: { summary: "List scheduled jobs", tags: ["Engines"], responses: { 200: { description: "Scheduled jobs" } } } },
-      "/v1/scheduled/all": { get: { summary: "List all scheduled jobs (all queues)", tags: ["Engines"], responses: { 200: { description: "Scheduled jobs (full)" } } } },
+      "/v1/scheduled/all": { delete: { summary: "Delete all scheduled tasks, timers, cron entries, and persisted sources", tags: ["Engines"], responses: { 200: { description: "Deletion and cleanup report" } } } },
       "/v1/scheduled/status": { get: { summary: "Status of scheduled job runner", tags: ["Engines"], responses: { 200: { description: "Status" } } } },
+      "/v1/scheduled/{id}": {
+        post: { 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: "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" } } }
+      },
       "/v1/scheduled/kill": { post: { summary: "Kill a running scheduled job", tags: ["Engines"], responses: { 200: { description: "Killed" } } } },
       "/v1/scheduled/fixup": { post: { summary: "Reconcile scheduled job state", tags: ["Engines"], responses: { 200: { description: "Reconciled" } } } },
-      "/v1/scheduled/reconcile": { post: { summary: "Force-reconcile scheduled jobs against persisted state", tags: ["Engines"], responses: { 200: { description: "Reconciled" } } } },
+      "/v1/scheduled/reconcile": { get: { summary: "Preview reconciliation of persisted and legacy scheduled jobs", tags: ["Engines"], responses: { 200: { description: "Reconciliation preview" } } }, post: { summary: "Preview or apply scheduled-job reconciliation", tags: ["Engines"], responses: { 200: { description: "Reconciliation result" } } } },
       "/v1/services/systemd": { get: { summary: "Systemd service status (where supported)", tags: ["Engines"], responses: { 200: { description: "Service snapshot" } } } },
+      "/v1/services/systemd/{unit}": { 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" } } } },
       "/v1/update": {
         get: {
           summary: "Global Omnius update transaction status",
@@ -816787,7 +816864,7 @@ data: ${JSON.stringify(data)}
       jsonResponse(res, 200, { tasks: enriched });
       return;
     }
-    if (pathname?.startsWith("/v1/scheduled/") && method === "POST") {
+    if (pathname?.startsWith("/v1/scheduled/") && method === "POST" && !(/* @__PURE__ */ new Set(["kill", "fixup", "reconcile"])).has(pathname.split("/")[3] ?? "")) {
       const parts = pathname.split("/");
       const id2 = parts[3] ?? "";
       const body = await parseJsonBody(req3);

package/docs/.vitepress/config.mts

@@ -57,6 +57,7 @@ export default defineConfig({
           { text: "Categorized OSINT Research", link: "/guides/osint-research" },
           { text: "Agent Integration", link: "/guides/agent-integration" },
           { text: "TUI Workflows", link: "/guides/tui-workflows" },
+          { text: "Web Dashboard", link: "/guides/dashboard" },
           { text: "Sponsor And COHERE", link: "/guides/sponsor-and-cohere" },
           { text: "Realtime Conversation", link: "/guides/realtime" },
           { text: "Telegram", link: "/guides/telegram" },