@signetai/connector-hermes-agent 0.182.9 → 0.183.0

package/dist/index.js

@@ -10451,6 +10451,55 @@ function up114(db) {
 			ON entity_attributes(memory_id, agent_id, status, importance);
 	`);
 }
+function up115(db) {
+  db.exec(`
+		CREATE TABLE IF NOT EXISTS cross_agent_messages (
+			id TEXT PRIMARY KEY,
+			from_agent_id TEXT NOT NULL,
+			from_session_key TEXT,
+			to_agent_id TEXT,
+			to_session_key TEXT,
+			to_session_agent_id TEXT,
+			broadcast INTEGER NOT NULL DEFAULT 0 CHECK(broadcast IN (0, 1)),
+			message_type TEXT NOT NULL CHECK(message_type IN ('assist_request', 'decision_update', 'info', 'question')),
+			content TEXT NOT NULL,
+			delivery_path TEXT NOT NULL CHECK(delivery_path IN ('local', 'acp')),
+			delivery_status TEXT NOT NULL CHECK(delivery_status IN ('queued', 'delivered', 'failed')),
+			delivery_error TEXT,
+			delivery_receipt_json TEXT,
+			created_at TEXT NOT NULL,
+			expires_at TEXT NOT NULL,
+			CHECK(
+				delivery_path = 'acp'
+				OR (
+					CAST(to_agent_id IS NOT NULL AS INTEGER)
+					+ CAST(to_session_key IS NOT NULL AS INTEGER)
+					+ broadcast = 1
+				)
+			)
+		);
+
+		CREATE TABLE IF NOT EXISTS cross_agent_message_receipts (
+			message_id TEXT NOT NULL REFERENCES cross_agent_messages(id) ON DELETE CASCADE,
+			agent_id TEXT NOT NULL,
+			acknowledged_at TEXT NOT NULL,
+			PRIMARY KEY (message_id, agent_id)
+		);
+
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_agent
+			ON cross_agent_messages(to_agent_id, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_session
+			ON cross_agent_messages(to_session_key, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_session_agent
+			ON cross_agent_messages(to_session_agent_id, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_broadcast
+			ON cross_agent_messages(broadcast, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_sender
+			ON cross_agent_messages(from_agent_id, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_receipts_agent
+			ON cross_agent_message_receipts(agent_id, acknowledged_at, message_id);
+	`);
+}
 var MIGRATIONS = [
   {
     version: 1,
@@ -11368,6 +11417,14 @@ var MIGRATIONS = [
     version: 114,
     name: "memory-traversal-hydration-index",
     up: up114
+  },
+  {
+    version: 115,
+    name: "cross-agent-message-notifications",
+    up: up115,
+    artifacts: {
+      tables: ["cross_agent_messages", "cross_agent_message_receipts"]
+    }
   }
 ];
 var LATEST_SCHEMA_VERSION = MIGRATIONS[MIGRATIONS.length - 1]?.version ?? 0;
@@ -18635,7 +18692,7 @@ function memoriesFtsNeedsTokenizerRepair2(sql) {
     return true;
   return !normalized.includes(`tokenize='${MEMORIES_FTS_TOKENIZER2}'`);
 }
-function up115(db) {
+function up116(db) {
   db.exec(`
 		CREATE TABLE IF NOT EXISTS schema_migrations (
 			version INTEGER PRIMARY KEY,
@@ -19058,7 +19115,7 @@ function up1010(db) {
 		)
 	`);
 }
-function up116(db) {
+function up117(db) {
   db.exec(`
 		CREATE TABLE IF NOT EXISTS session_scores (
 			id TEXT PRIMARY KEY,
@@ -22118,11 +22175,60 @@ function up1142(db) {
 			ON entity_attributes(memory_id, agent_id, status, importance);
 	`);
 }
+function up1152(db) {
+  db.exec(`
+		CREATE TABLE IF NOT EXISTS cross_agent_messages (
+			id TEXT PRIMARY KEY,
+			from_agent_id TEXT NOT NULL,
+			from_session_key TEXT,
+			to_agent_id TEXT,
+			to_session_key TEXT,
+			to_session_agent_id TEXT,
+			broadcast INTEGER NOT NULL DEFAULT 0 CHECK(broadcast IN (0, 1)),
+			message_type TEXT NOT NULL CHECK(message_type IN ('assist_request', 'decision_update', 'info', 'question')),
+			content TEXT NOT NULL,
+			delivery_path TEXT NOT NULL CHECK(delivery_path IN ('local', 'acp')),
+			delivery_status TEXT NOT NULL CHECK(delivery_status IN ('queued', 'delivered', 'failed')),
+			delivery_error TEXT,
+			delivery_receipt_json TEXT,
+			created_at TEXT NOT NULL,
+			expires_at TEXT NOT NULL,
+			CHECK(
+				delivery_path = 'acp'
+				OR (
+					CAST(to_agent_id IS NOT NULL AS INTEGER)
+					+ CAST(to_session_key IS NOT NULL AS INTEGER)
+					+ broadcast = 1
+				)
+			)
+		);
+
+		CREATE TABLE IF NOT EXISTS cross_agent_message_receipts (
+			message_id TEXT NOT NULL REFERENCES cross_agent_messages(id) ON DELETE CASCADE,
+			agent_id TEXT NOT NULL,
+			acknowledged_at TEXT NOT NULL,
+			PRIMARY KEY (message_id, agent_id)
+		);
+
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_agent
+			ON cross_agent_messages(to_agent_id, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_session
+			ON cross_agent_messages(to_session_key, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_session_agent
+			ON cross_agent_messages(to_session_agent_id, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_broadcast
+			ON cross_agent_messages(broadcast, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_messages_sender
+			ON cross_agent_messages(from_agent_id, expires_at, created_at, id);
+		CREATE INDEX IF NOT EXISTS idx_cross_agent_receipts_agent
+			ON cross_agent_message_receipts(agent_id, acknowledged_at, message_id);
+	`);
+}
 var MIGRATIONS2 = [
   {
     version: 1,
     name: "baseline",
-    up: up115,
+    up: up116,
     artifacts: { tables: ["memories", "conversations", "embeddings"] }
   },
   {
@@ -22188,7 +22294,7 @@ var MIGRATIONS2 = [
   {
     version: 11,
     name: "session-scores",
-    up: up116,
+    up: up117,
     artifacts: { tables: ["session_scores"] }
   },
   {
@@ -23035,6 +23141,14 @@ var MIGRATIONS2 = [
     version: 114,
     name: "memory-traversal-hydration-index",
     up: up1142
+  },
+  {
+    version: 115,
+    name: "cross-agent-message-notifications",
+    up: up1152,
+    artifacts: {
+      tables: ["cross_agent_messages", "cross_agent_message_receipts"]
+    }
   }
 ];
 var LATEST_SCHEMA_VERSION2 = MIGRATIONS2[MIGRATIONS2.length - 1]?.version ?? 0;

package/hermes-plugin/__init__.py

@@ -327,6 +327,7 @@ class SignetMemoryProvider(MemoryProvider):
         self._inject_cache = ""
         self._inject_lock = threading.Lock()
         self._prefetch_result = ""
+        self._notification_result = ""
         self._prefetch_lock = threading.Lock()
         self._prefetch_thread: Optional[threading.Thread] = None
         self._prefetch_generation = 0
@@ -485,11 +486,27 @@ class SignetMemoryProvider(MemoryProvider):
         if self._prefetch_thread and self._prefetch_thread.is_alive():
             self._prefetch_thread.join(timeout=3.0)
 
+        client = self._client
+        if client:
+            try:
+                notification = client.notifications(
+                    self._session_key,
+                    "prefetch",
+                    project=self._project,
+                )
+                if notification is not None:
+                    notification_inject = notification.get("inject", "")
+                    with self._prefetch_lock:
+                        self._notification_result = notification_inject if isinstance(notification_inject, str) else ""
+            except Exception as e:
+                logger.debug("Signet notification prefetch failed: %s", e)
+
         with self._prefetch_lock:
-            result = self._prefetch_result
+            parts = [self._prefetch_result, self._notification_result]
             self._prefetch_result = ""
+            self._notification_result = ""
 
-        return result
+        return "\n".join(part for part in parts if part and part.strip())
 
     def queue_prefetch(self, query: str, *, session_id: str = "") -> None:
         """Fire a background recall via user-prompt-submit hook.
@@ -513,6 +530,7 @@ class SignetMemoryProvider(MemoryProvider):
         with self._prefetch_lock:
             self._prefetch_generation += 1
             self._prefetch_result = ""
+            self._notification_result = ""
             session_key = self._session_key
             project = self._project
             prefetch_generation = self._prefetch_generation
@@ -542,10 +560,16 @@ class SignetMemoryProvider(MemoryProvider):
                             )
                         return
                     inject = result.get("inject", "")
-                    if inject and inject.strip():
+                    notification = result.get("notifications")
+                    notification_inject = notification.get("inject", "") if isinstance(notification, dict) else ""
+                    recall_inject = inject
+                    if notification_inject and inject.rstrip().endswith(notification_inject.strip()):
+                        recall_inject = inject.rstrip()[: -len(notification_inject.strip())].rstrip()
+                    if (recall_inject and recall_inject.strip()) or (notification_inject and notification_inject.strip()):
                         with self._prefetch_lock:
                             if prefetch_generation == self._prefetch_generation and session_key == self._session_key:
-                                self._prefetch_result = inject
+                                self._prefetch_result = recall_inject
+                                self._notification_result = notification_inject
             except Exception as e:
                 logger.debug("Signet prefetch failed: %s", e)
 
@@ -584,6 +608,29 @@ class SignetMemoryProvider(MemoryProvider):
         if assistant_content:
             with self._transcript_lock:
                 self._transcript_lines.append(f"assistant: {assistant_content}")
+        self._queue_notification_refresh("sync_turn")
+
+    def _queue_notification_refresh(self, hook: str) -> None:
+        """Fetch peer notifications without blocking the current Hermes callback."""
+        client = self._client
+        if not client:
+            return
+        session_key = self._session_key
+        project = self._project
+        with self._prefetch_lock:
+            generation = self._prefetch_generation
+
+        def _run():
+            try:
+                result = client.notifications(session_key, hook, project=project)
+                inject = (result or {}).get("inject", "")
+                with self._prefetch_lock:
+                    if generation == self._prefetch_generation and session_key == self._session_key:
+                        self._notification_result = inject if isinstance(inject, str) else ""
+            except Exception as e:
+                logger.debug("Signet %s notification refresh failed: %s", hook, e)
+
+        threading.Thread(target=_run, daemon=True, name=f"signet-notify-{hook}").start()
 
     def on_session_switch(
         self,
@@ -615,6 +662,7 @@ class SignetMemoryProvider(MemoryProvider):
         with self._prefetch_lock:
             self._prefetch_generation += 1
             self._prefetch_result = ""
+            self._notification_result = ""
 
         agent_id = os.environ.get("SIGNET_AGENT_ID", "").strip() or "hermes-agent"
         self._project = _resolve_agent_workspace(agent_id, kwargs)
@@ -818,6 +866,7 @@ class SignetMemoryProvider(MemoryProvider):
 
         t = threading.Thread(target=_run, daemon=True, name="signet-delegation")
         t.start()
+        self._queue_notification_refresh("on_delegation")
 
     def _fire_checkpoint(self) -> None:
         """Fire a checkpoint-extract for long-running sessions."""

package/hermes-plugin/client.py

@@ -319,6 +319,26 @@ class SignetClient:
             timeout=_RECALL_TIMEOUT_SECS,
         )
 
+    def notifications(
+        self,
+        session_key: str,
+        hook: str,
+        *,
+        project: str = "",
+    ) -> Optional[Dict[str, Any]]:
+        """Fetch pending peer notifications for a compatible Hermes hook."""
+        return self._post(
+            "/api/hooks/notifications",
+            {
+                "harness": self._harness,
+                "hook": hook,
+                "sessionKey": session_key,
+                "agentId": self._agent_id,
+                "project": project,
+            },
+            timeout=_RECALL_TIMEOUT_SECS,
+        )
+
     def session_end(
         self,
         session_key: str,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signetai/connector-hermes-agent",
-  "version": "0.182.9",
+  "version": "0.183.0",
   "description": "Signet connector for Hermes Agent — installs Signet as a pluggable memory provider",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@signetai/connector-base": "0.182.9",
-    "@signetai/core": "0.182.9"
+    "@signetai/connector-base": "0.183.0",
+    "@signetai/core": "0.183.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",