@inline-chat/hermes-agent-adapter 0.0.21 → 0.0.22

package/README.md

@@ -51,6 +51,20 @@ 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.
 
+## Release 0.0.22
+
+This release includes typed service-notice filtering before agent admission,
+current shared-session setup guidance, and the pinned realtime SDK `0.0.18`.
+Private thread creation with omitted participants includes the connected account.
+Clarification choices use two-column rows within Inline's button limit.
+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
+inline-hermes install --force
+```
+
 ## Install
 
 ```sh
@@ -156,7 +170,7 @@ uv run ./hermes plugins list --plain --no-bundled
 Expected local output includes:
 
 ```text
-enabled      user     0.0.21   inline-platform
+enabled      user     0.0.22   inline-platform
 ```
 
 ## Update Or Reinstall
@@ -254,26 +268,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
@@ -431,11 +433,37 @@ chat, while `create_chat` creates a new top-level destination. `create_chat`
 requires a title, defaults to private, accepts optional participant user IDs or
 a parent space ID, and requires both `space_id` and explicit `is_public: true`
 for space-wide visibility. It returns the new chat ID so Hermes can link it in
-the normal reply.
+the normal reply. Omitted or empty private participants create a conversation
+accessible only to the connected account. Include intended human participants
+explicitly; owning the bot does not grant membership in its private conversations.
 
 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",
   "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:
@@ -5014,7 +5024,7 @@ class InlineAdapter(BasePlatformAdapter):
             "target": self._target_for(chat_id, metadata),
             "text": "\n".join(lines),
             "parseMarkdown": self._parse_markdown,
-            "actions": {"rows": [{"actions": actions}]},
+            "actions": {"rows": self._action_rows(actions)},
         })
 
     async def send_exec_approval(

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"
 _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
 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 };
@@ -47555,6 +47565,9 @@ async function endpointCreateChat(res, body) {
   if (isPublic && participantUserIds.length > 0) {
     throw new SidecarError("public create-chat cannot include participantUserIds", "bad_format");
   }
+  if (!isPublic && participantUserIds.length === 0) {
+    participantUserIds.push(readRequiredInlineId({ meId }, "meId"));
+  }
   const result = await client.invokeUncheckedRaw(Method.CREATE_CHAT, {
     oneofKind: "createChat",
     createChat: {

package/plugin/inline/tools.py

@@ -226,7 +226,7 @@ INLINE_TOOL_SCHEMA = {
                 "type": "array",
                 "items": {"type": "string"},
                 "maxItems": 50,
-                "description": "User IDs for a private create_chat destination. Omit for a private bot-only thread.",
+                "description": "User IDs for a private create_chat destination. Omit or pass [] for a connected-account-only thread. Include intended human participants explicitly; bot ownership does not grant access.",
             },
             "is_public": {
                 "type": "boolean",