omnius 1.0.595 → 1.0.597

package/dist/memory-maintenance-worker.js

@@ -1417,9 +1417,8 @@ var EpisodeStore = class {
     });
     scored.sort((a, b) => b.score - a.score);
     const topK = scored.slice(0, limit);
-    const updateStmt = this.db.prepare("UPDATE episodes SET strength = strength + 1, last_retrieved = ? WHERE id = ?");
-    for (const { episode } of topK) {
-      updateStmt.run(now, episode.id);
+    if (opts.recordRetrieval !== false) {
+      this.recordRetrieved(topK.map((item) => item.episode), now);
     }
     return topK.map((s) => s.episode);
   }
@@ -1427,30 +1426,105 @@ var EpisodeStore = class {
    *  Falls back to standard search if graph is unavailable or no entities found.
    */
   searchWithPPR(query, opts = {}) {
-    const standardResults = this.search(query, opts);
     if (!this.graph || !query.query) {
-      return standardResults;
+      return this.search(query, opts);
     }
+    const standardResults = this.search(query, { ...opts, recordRetrieval: false });
     try {
       const pprResult = retrieveByPPR(query.query, this.graph, this, {
         damping: 0.5,
         maxIterations: 50,
         convergenceThreshold: 1e-6,
-        topK: query.limit ?? 20
+        topK: query.limit ?? 20,
+        currentEmotionalState: opts.currentEmotionalState,
+        influenceFor: opts.influenceFor ? (episodeId) => {
+          const episode = this.get(episodeId);
+          return episode ? opts.influenceFor(episode) : null;
+        } : void 0,
+        engagementWeight: opts.engagementWeight
       });
-      const merged = [...standardResults];
-      const seenIds = new Set(merged.map((e) => e.id));
-      for (const { episode } of pprResult.episodes) {
-        if (!seenIds.has(episode.id)) {
-          merged.push(episode);
-          seenIds.add(episode.id);
+      const candidates = /* @__PURE__ */ new Map();
+      const addCandidate = (episode, rank, pprScore = 0) => {
+        if (!this.matchesQueryFilters(episode, query))
+          return;
+        const contribution = 1 / (60 + rank + 1);
+        const existing = candidates.get(episode.id);
+        if (existing) {
+          existing.score += contribution;
+          existing.sourceCount += 1;
+          existing.bestPprScore = Math.max(existing.bestPprScore, pprScore);
+        } else {
+          candidates.set(episode.id, {
+            episode,
+            score: contribution,
+            sourceCount: 1,
+            bestPprScore: pprScore
+          });
         }
-      }
-      return merged.slice(0, query.limit ?? 20);
+      };
+      standardResults.forEach((episode, rank) => addCandidate(episode, rank));
+      pprResult.episodes.forEach(({ episode, pprScore }, rank) => {
+        addCandidate(episode, rank, pprScore);
+      });
+      const limit = query.limit ?? 20;
+      const merged = [...candidates.values()].sort((a, b) => b.score - a.score || b.sourceCount - a.sourceCount || b.bestPprScore - a.bestPprScore || b.episode.timestamp - a.episode.timestamp || a.episode.id.localeCompare(b.episode.id)).slice(0, limit).map((candidate) => candidate.episode);
+      if (opts.recordRetrieval !== false)
+        this.recordRetrieved(merged, Date.now());
+      return merged;
     } catch {
+      if (opts.recordRetrieval !== false)
+        this.recordRetrieved(standardResults, Date.now());
       return standardResults;
     }
   }
+  /** Apply every non-text relevance constraint to a graph candidate. */
+  matchesQueryFilters(episode, query) {
+    if (query.sessionId && episode.sessionId !== query.sessionId)
+      return false;
+    if (query.taskId && episode.taskId !== query.taskId)
+      return false;
+    if (query.toolName && episode.toolName !== query.toolName)
+      return false;
+    if (query.modality && episode.modality !== query.modality)
+      return false;
+    if (query.since !== void 0 && episode.timestamp < query.since)
+      return false;
+    if (query.until !== void 0 && episode.timestamp > query.until)
+      return false;
+    if (query.minImportance !== void 0 && episode.importance < query.minImportance)
+      return false;
+    const metadata = episode.metadata;
+    if (query.metadataFilter) {
+      if (!metadata)
+        return false;
+      for (const [key, value] of Object.entries(query.metadataFilter)) {
+        if (metadata[key] !== value)
+          return false;
+      }
+    }
+    if (query.soundClass && metadata?.["sound_class"] !== query.soundClass)
+      return false;
+    if (query.rmsRange) {
+      const rms = metadata?.["rms_db"] ?? metadata?.["rmsDb"];
+      if (typeof rms !== "number")
+        return false;
+      if (query.rmsRange.min !== void 0 && rms < query.rmsRange.min)
+        return false;
+      if (query.rmsRange.max !== void 0 && rms > query.rmsRange.max)
+        return false;
+    }
+    return true;
+  }
+  recordRetrieved(episodes, timestamp) {
+    if (episodes.length === 0)
+      return;
+    const updateStmt = this.db.prepare("UPDATE episodes SET strength = strength + 1, last_retrieved = ? WHERE id = ?");
+    const updateAll = this.db.transaction(() => {
+      for (const episode of episodes)
+        updateStmt.run(timestamp, episode.id);
+    });
+    updateAll();
+  }
   /** Get a single episode by ID. */
   get(id) {
     const row = this.db.prepare("SELECT * FROM episodes WHERE id = ?").get(id);

package/dist/postinstall-daemon.cjs

@@ -930,6 +930,11 @@ function main() {
   progress(4, INSTALL_STEPS, "Ensuring local REST key");
   ensureBootstrapApiKeyForUser(effectiveUser());
 
+  if (process.env.OMNIUS_UPDATE_COORDINATED === "1") {
+    log("Coordinated update owns daemon restart and exact-version verification.");
+    return safeExit(0);
+  }
+
   if (process.env.OMNIUS_SKIP_DAEMON_INSTALL === "1") {
     log("OMNIUS_SKIP_DAEMON_INSTALL=1 — skipping daemon service install.");
     return safeExit(0);

package/dist/preinstall.cjs

@@ -13,6 +13,14 @@
 
 "use strict";
 
+// A coordinated self-update owns the exact PID/service lifecycle and verifies
+// the replacement runtime afterward.  The generic install hook must not race
+// it by sweeping the configured port or killing an unattested process.
+if (process.env.OMNIUS_UPDATE_COORDINATED === "1") {
+  process.stdout.write("  [preinstall] coordinated update owns daemon handoff\n");
+  process.exit(0);
+}
+
 if (process.env.OMNIUS_SKIP_DAEMON_INSTALL === "1") {
   process.exit(0);
 }

package/docs/.vitepress/config.mts

@@ -60,6 +60,7 @@ export default defineConfig({
           { text: "Realtime Conversation", link: "/guides/realtime" },
           { text: "Telegram", link: "/guides/telegram" },
           { text: "Media Generation", link: "/guides/media-generation" },
+          { text: "System Tray Indicator", link: "/guides/system-tray" },
         ],
       },
       {

package/docs/DISCOVERY.json

@@ -11003,6 +11003,32 @@
         }
       ]
     },
+    {
+      "id": "guide.guides-system-tray",
+      "kind": "guide",
+      "title": "System Tray Indicator",
+      "summary": "Bundled Omnius documentation artifact: docs/guides/system-tray.md.",
+      "keywords": [
+        "guides",
+        "system",
+        "tray",
+        "md"
+      ],
+      "maturity": "stable",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/guides/system-tray.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/guides/system-tray.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.guides-telegram",
       "kind": "guide",

package/docs/DISCOVERY.md

@@ -361,6 +361,7 @@ Daemon equivalents are `GET /v1/discovery?q=<intent>` and `GET /v1/discovery/{id
 | `guide.guides-osint-research` | Categorized OSINT research | Bundled Omnius documentation artifact: docs/guides/osint-research.md. |
 | `guide.guides-realtime` | Realtime Conversations | Bundled Omnius documentation artifact: docs/guides/realtime.md. |
 | `guide.guides-sponsor-and-cohere` | Sponsor And COHERE Mesh | Bundled Omnius documentation artifact: docs/guides/sponsor-and-cohere.md. |
+| `guide.guides-system-tray` | System Tray Indicator | Bundled Omnius documentation artifact: docs/guides/system-tray.md. |
 | `guide.guides-telegram` | Telegram Bridge | Bundled Omnius documentation artifact: docs/guides/telegram.md. |
 | `guide.guides-tools-and-web-search` | Tools And Web Search | Bundled Omnius documentation artifact: docs/guides/tools-and-web-search.md. |
 | `guide.guides-tui-workflows` | TUI Workflows | Bundled Omnius documentation artifact: docs/guides/tui-workflows.md. |

package/docs/guides/system-tray.md

@@ -0,0 +1,85 @@
+# System Tray Indicator
+
+Omnius ships a native per-login tray indicator for Linux, macOS, and Windows
+on x64 hosts. It is separate from the REST daemon: closing the indicator never
+stops the daemon, and the daemon remains usable in headless sessions.
+
+## Install And Control
+
+```bash
+omnius tray install                 # register login startup and start now
+omnius tray status                  # indicator, health, endpoint, registration
+omnius tray restart
+omnius tray stop                    # stop only the indicator
+omnius tray uninstall               # stop it and remove login startup
+```
+
+The indicator polls the daemon's loopback-only `GET /health` route. It does not
+load a model or contact the configured inference backend. If the daemon uses a
+non-default port, Omnius discovers `OMNIUS_HOST`/`OMNIUS_PORT` from the current
+environment and, on Linux, from the installed user service. Override it
+explicitly when needed:
+
+```bash
+omnius tray install --endpoint http://127.0.0.1:11535
+```
+
+Non-loopback endpoints are rejected. The menu provides the current health and
+version, dashboard and log shortcuts, service-manager-aware daemon controls,
+login-startup control, and **Quit indicator**. Daemon stop is a separate,
+explicit menu action.
+
+## Linux / Ubuntu
+
+GNOME needs a StatusNotifier/AppIndicator host. Ubuntu Desktop normally ships
+the `gnome-shell-extension-appindicator` extension; the native helper uses
+Ayatana AppIndicator when available. On a minimal installation:
+
+```bash
+sudo apt install gnome-shell-extension-appindicator libayatana-appindicator3-1
+```
+
+Verify the desktop host without touching the daemon:
+
+```bash
+gdbus call --session \
+  --dest org.kde.StatusNotifierWatcher \
+  --object-path /StatusNotifierWatcher \
+  --method org.freedesktop.DBus.Properties.Get \
+  org.kde.StatusNotifierWatcher IsStatusNotifierHostRegistered
+```
+
+Login registration is written to
+`~/.config/autostart/omnius-tray.desktop`. Runtime PID/state stays under
+`$XDG_RUNTIME_DIR/omnius`; logs are under
+`$XDG_STATE_HOME/omnius` (usually `~/.local/state/omnius`). This avoids tying a
+desktop process to the daemon's persistent `~/.omnius` data directory.
+
+## Platform Registration
+
+| Platform | Login registration |
+| --- | --- |
+| Linux | XDG autostart desktop entry |
+| macOS | `~/Library/LaunchAgents/ai.omnius.tray.plist` |
+| Windows | per-user Startup-folder command |
+
+The optional native helper is exact-pinned and its platform executable is
+checked against a release SHA-256 before execution. Omnius remains usable when
+optional dependencies are disabled; only the tray command reports the missing
+helper. The current helper release targets x64. Other architectures fail with
+an explicit diagnostic instead of falling back to a headless or emulated tray.
+
+## Troubleshooting
+
+```bash
+omnius tray status --json
+tail -f ~/.local/state/omnius/tray.err.log   # Linux default
+```
+
+- **No icon on GNOME:** confirm the AppIndicator extension is active and the
+  session watcher reports a registered host.
+- **Offline despite a running daemon:** pass the daemon's loopback endpoint
+  with `--endpoint`; avoid `0.0.0.0` in client URLs.
+- **No graphical session:** run `omnius tray start` from the logged-in desktop
+  session so `DISPLAY`/`WAYLAND_DISPLAY` and the session D-Bus address exist.
+

package/docs/index.md

@@ -27,6 +27,7 @@ current task.
 - [Realtime Conversation](./guides/realtime.md)
 - [Telegram](./guides/telegram.md)
 - [Media Generation](./guides/media-generation.md)
+- [System Tray Indicator](./guides/system-tray.md)
 - [Tools And Web Search](./guides/tools-and-web-search.md)
 - [Categorized OSINT Research](./guides/osint-research.md)