@inline-chat/hermes-agent-adapter 0.0.21 → 0.0.22-alpha.0

package/README.md

@@ -51,6 +51,18 @@ Unsupported or intentionally limited:
 - Live voice sessions or calls. Voice file messages are supported, but realtime audio is not.
 - Media without a usable Inline CDN/local URL. Those messages still produce text summaries, but Hermes may not receive a local file path.
 
+## Alpha 0.0.22-alpha.0
+
+This prerelease includes typed service-notice filtering before agent admission,
+current shared-session setup guidance, and the pinned realtime SDK `0.0.18`.
+Hermes keeps its supported agent activity surface; unsupported experimental tool
+timelines remain disabled.
+
+```sh
+npm install -g @inline-chat/hermes-agent-adapter@0.0.22-alpha.0
+inline-hermes install --force
+```
+
 ## Install
 
 ```sh
@@ -254,26 +266,14 @@ platforms:
     enabled: true
 ```
 
-Inline follows Hermes' native work-chat defaults: show typing/presence while a
-turn is running, keep tool-call progress out of the room by default, and keep
-edit-based token streaming opt-in. If an older Hermes config has global
-`display.tool_progress: all`, add the per-platform override below so terminal
-and tool progress bubbles are not left in Inline chats:
+Experimental tool timelines are unavailable in this adapter. The old
+`INLINE_EXPERIMENTAL_AGENT_ACTIVITY` setting is ignored and logs a warning when
+enabled. Hermes uses ordinary typing, optional processing reactions, and replies.
 
-```yaml
-display:
-  platforms:
-    inline:
-      tool_progress: off
-      cleanup_progress: true
-      streaming: false
-      interim_assistant_messages: false
-```
-
-To temporarily show live tool progress, set `tool_progress: new` or
-`tool_progress: all` and leave `cleanup_progress: true` so Hermes deletes the
-progress message after a successful final reply. Token streaming requires both
-top-level `streaming.enabled: true` and
+Inline keeps tool progress and interim assistant messages quiet by default.
+Explicit Hermes display settings still take precedence; if you enable native
+tool progress, Hermes uses its ordinary progress messages. Token streaming remains
+opt-in through both `streaming.enabled: true` and
 `display.platforms.inline.streaming: true`.
 
 Hermes-native sends and scheduled deliveries accept Inline's explicit target
@@ -436,6 +436,30 @@ the normal reply.
 The plugin id is `inline`, which is intentionally the same id an eventual
 bundled Hermes adapter should use.
 
+## Shared transcripts in groups and threads
+
+To share one conversation transcript among admitted participants in a group
+or thread, add these keys at the root of the `config.yaml` used by the Hermes
+gateway process, outside `platforms.inline.extra`:
+
+```yaml
+group_sessions_per_user: false
+thread_sessions_per_user: false
+```
+
+Hermes defaults `group_sessions_per_user` to `true` (groups split by sender)
+and `thread_sessions_per_user` to `false` (threads shared). These settings
+affect every messaging platform governed by that gateway configuration.
+For separate profile gateways, configure each gateway's profile separately.
+With a multiplexed gateway, do not assume a secondary profile's values control
+its sessions; this adapter does not qualify per-profile session-policy overrides.
+
+Distinct Hermes profile/gateway namespaces keep separate conversation sessions.
+Swapping a bot token within one profile does not create a new transcript namespace.
+These flags select shared sessions; they do not merge existing histories, import
+all Inline history, grant permissions, or change access, mention, or bot wake rules.
+Restart the gateway through its existing process manager after editing.
+
 ## Error Reporting And Privacy
 
 The Inline adapter and its supervised sidecar keep error reporting disabled

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inline-chat/hermes-agent-adapter",
-  "version": "0.0.21",
+  "version": "0.0.22-alpha.0",
   "description": "Hermes Agent platform adapter for Inline, with a native Python plugin and bundled Inline realtime sidecar.",
   "license": "Apache-2.0",
   "type": "module",

package/plugin/inline/adapter.py

@@ -230,11 +230,12 @@ def _install_inline_display_defaults() -> None:
         defaults = getattr(_display_config, "_PLATFORM_DEFAULTS", None)
         if not isinstance(defaults, dict):
             return
+        inline_defaults = dict(_INLINE_DISPLAY_DEFAULTS)
         current = defaults.get("inline")
         if isinstance(current, dict):
-            defaults["inline"] = {**_INLINE_DISPLAY_DEFAULTS, **current}
+            defaults["inline"] = {**inline_defaults, **current}
         else:
-            defaults["inline"] = dict(_INLINE_DISPLAY_DEFAULTS)
+            defaults["inline"] = inline_defaults
     except Exception:
         logger.debug("[inline] failed to install display defaults", exc_info=True)
 
@@ -812,6 +813,8 @@ class InlineAdapter(BasePlatformAdapter):
         super().__init__(config, Platform("inline"))
         extra = config.extra or {}
 
+        if _truthy(os.getenv("INLINE_EXPERIMENTAL_AGENT_ACTIVITY")):
+            logger.warning("[inline] experimental tool timelines are unavailable; ignoring INLINE_EXPERIMENTAL_AGENT_ACTIVITY and using ordinary typing")
         self._token = _config_token(config)
         self._base_url = os.getenv("INLINE_BASE_URL") or extra.get("base_url") or "https://api.inline.chat"
         self._sidecar_bind = _normalize_sidecar_bind(extra.get("sidecar_bind") or os.getenv("INLINE_SIDECAR_BIND"))
@@ -2444,7 +2447,14 @@ class InlineAdapter(BasePlatformAdapter):
 
     async def _dispatch_message(self, event: Dict[str, Any], *, edit: bool = False) -> None:
         agent_action = event.get("_inlineAgentAction") if isinstance(event.get("_inlineAgentAction"), dict) else None
-        msg = event.get("message") or {}
+        msg = event.get("message")
+        if not isinstance(msg, dict):
+            return
+        # History/join recovery and older sidecars can reach this entry directly.
+        # Service fallback text and mentions are never conversational direction.
+        raw = msg.get("raw") if isinstance(msg.get("raw"), dict) else {}
+        if isinstance(msg.get("serviceMessage"), dict) or isinstance(raw.get("serviceMessage"), dict):
+            return
         msg_id = str(msg.get("id") or "")
         chat_id = str(event.get("chatId") or msg.get("chatId") or "")
         if not msg_id or not chat_id:

package/plugin/inline/cli.py

@@ -27,7 +27,7 @@ _CLI_INSTALL_URL = "https://inline.chat/cli/install.sh"
 _MAX_TOKEN_BYTES = 16 * 1024
 _MAX_PROBE_RESPONSE_BYTES = 64 * 1024
 _MACHINE_SETUP_PROTOCOL_VERSION = 1
-_PROBE_USER_AGENT = "inline-hermes-agent-adapter/0.0.21"
+_PROBE_USER_AGENT = "inline-hermes-agent-adapter/0.0.22-alpha.0"
 _ENV_REFERENCE_RE = re.compile(r"^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$")
 
 

package/plugin/inline/plugin.yaml

@@ -3,7 +3,7 @@ label: Inline
 kind: platform
 provides_tools:
   - inline
-version: 0.0.21
+version: 0.0.22-alpha.0
 requires_hermes: ">=0.21.3"
 description: >
   Inline platform adapter for Hermes Agent. The adapter runs as a native

package/plugin/inline/sidecar/index.mjs

@@ -5702,6 +5702,13 @@ var botSettingsEventKinds = new Set([
 function inboundEventNeedsSenderResolution(event) {
   return !botSettingsEventKinds.has(event.kind ?? "");
 }
+function inboundEventIsServiceMessage(event) {
+  if (event.kind !== "message.new" && event.kind !== "message.edit")
+    return false;
+  const message = asOptionalRecord(event.message);
+  const raw = asOptionalRecord(message?.raw);
+  return Boolean(asOptionalRecord(message?.serviceMessage) || asOptionalRecord(raw?.serviceMessage));
+}
 
 class SidecarError extends Error {
   errorKind;
@@ -5823,6 +5830,7 @@ function normalizeMessage(message) {
     replies: message.replies ?? null,
     actions: message.actions ?? null,
     rev: message.rev ?? null,
+    ...asOptionalRecord(message.serviceMessage) ? { serviceMessage: message.serviceMessage } : {},
     raw: message
   };
 }
@@ -6021,6 +6029,8 @@ function explicitlyMentionsSelf(event, meId) {
   return message?.entities?.entities?.some((e) => e.entity?.oneofKind === "mention" && e.entity.mention?.userId?.toString() === meId) ?? false;
 }
 async function deliverInboundEvent(event, owner) {
+  if (inboundEventIsServiceMessage(event))
+    return;
   const explicitMention = explicitlyMentionsSelf(event, owner.meId);
   while (!owner.signal.aborted) {
     const resolution = explicitMention ? { provenanceVerified: false } : inboundEventNeedsSenderResolution(event) ? await owner.resolveSender(event) : { provenanceVerified: true };