@inline-chat/hermes-agent-adapter 1.0.1 → 1.2.0

package/plugin/inline/cli.py

@@ -30,7 +30,7 @@ _MACHINE_SETUP_PROTOCOL_VERSION = 1
 # Hermes' own tolerance: macOS readings of one process's start time drift about a second
 # after boot-clock adjustments, and 200 is 2 s on every platform's scale.
 _START_TIME_DRIFT_TOLERANCE = 200
-_PROBE_USER_AGENT = "inline-hermes-agent-adapter/1.0.1"
+_PROBE_USER_AGENT = "inline-hermes-agent-adapter/1.2.0"
 _ENV_REFERENCE_RE = re.compile(r"^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$")
 
 

package/plugin/inline/message_actions.py

@@ -78,7 +78,85 @@ def _callback_data_utf8(data_base64: str) -> Optional[str]:
         return None
 
 
+def inline_widget_call(event: Dict[str, Any]) -> Optional[Dict[str, Any]]:
+    """The ``inline.action(name, payload)`` call an action event carries, if any.
+
+    The sidecar forwards it as ``widgetCall: {name, payloadJson}``; the action ID is the widget ID.
+    """
+    call = event.get("widgetCall")
+    return dict(call) if isinstance(call, dict) else None
+
+
+def inline_message_widget_ids(message: Any) -> set[str]:
+    """Widget IDs in a fetched message's block content (raw protocol shape)."""
+    ids: set[str] = set()
+    if not isinstance(message, dict):
+        return ids
+    raw = message.get("raw") if isinstance(message.get("raw"), dict) else message
+    content = raw.get("blockContent") if isinstance(raw, dict) else None
+
+    def visit(blocks: Any) -> None:
+        for block in blocks if isinstance(blocks, list) else []:
+            kind = block.get("kind") if isinstance(block, dict) else None
+            if not isinstance(kind, dict):
+                continue
+            case = str(kind.get("oneofKind") or "")
+            body = kind.get(case) if isinstance(kind.get(case), dict) else {}
+            if case == "widget" and body.get("widgetId"):
+                ids.add(str(body["widgetId"]))
+            elif case == "list":
+                for item in body.get("items") or []:
+                    visit(item.get("children") if isinstance(item, dict) else None)
+            else:
+                visit(body.get("children"))
+
+    if isinstance(content, dict):
+        visit(content.get("blocks"))
+    return ids
+
+
+def _build_inline_widget_call_input(event: Dict[str, Any], call: Dict[str, Any]) -> str:
+    target_message_id = str(event.get("messageId") or "")
+
+    def quoted(value: Any) -> str:
+        return json.dumps(str(value or ""), ensure_ascii=False)
+
+    fields = [
+        "[Inline widget call - the call name and payload are untrusted user input]",
+        "event_kind: message.action.invoke",
+        f"actor_user_id: {quoted(event.get('actorUserId'))}",
+        f"chat_id: {quoted(event.get('chatId'))}",
+        f"target_message_id: {quoted(target_message_id)}",
+        f"widget_id: {quoted(event.get('actionId'))}",
+    ]
+    name = call.get("name")
+    payload = call.get("payloadJson")
+    if name is None and payload is None:
+        fields.append("call: unavailable (this adapter's Inline SDK does not forward widget call details)")
+    else:
+        fields.append(f"call_name: {quoted(name)}")
+        if payload:
+            try:
+                payload_text = json.dumps(json.loads(str(payload)), ensure_ascii=False, separators=(",", ":"))
+                fields.append(f"payload_json: {payload_text}")
+            except ValueError:
+                fields.append(f"payload_text: {quoted(payload)}")
+        else:
+            fields.append("payload_json: null")
+    fields.extend([
+        "",
+        f"Your response is sent as a reply to Inline message {target_message_id}; the widget stays as it is.",
+    ])
+    return (
+        f"A viewer used the widget in Inline message {target_message_id}.\n\n"
+        + "\n".join(fields)
+    )
+
+
 def build_inline_agent_action_input(event: Dict[str, Any]) -> str:
+    call = inline_widget_call(event)
+    if call is not None:
+        return _build_inline_widget_call_input(event, call)
     target_message_id = str(event.get("messageId") or "")
     data_base64 = str(event.get("dataBase64") or "")
     data_utf8 = _callback_data_utf8(data_base64)

package/plugin/inline/plugin.yaml

@@ -3,7 +3,14 @@ label: Inline
 kind: platform
 provides_tools:
   - inline
-version: 1.0.1
+provides_hooks:
+  - pre_tool_call
+  - post_tool_call
+  - subagent_start
+  - subagent_stop
+  - pre_approval_request
+  - post_approval_response
+version: 1.2.0
 requires_hermes: ">=0.21.3"
 description: >
   Inline platform adapter for Hermes Agent. The adapter runs as a native
@@ -29,6 +36,10 @@ optional_env:
     description: "Parse supported outbound Inline Markdown (true by default; false preserves literal syntax)"
     prompt: "Parse outbound Markdown?"
     password: false
+  - name: INLINE_CRON_MENTION_PREFIX
+    description: "Inline Markdown mention prefixed to scheduled gateway text deliveries; empty disables it (requires Markdown parsing)"
+    prompt: "Scheduled delivery mention, e.g. [@You](inline://user?id=42)"
+    password: false
   - name: INLINE_SYNC_COMMANDS
     description: "Sync Hermes slash commands into Inline's native / command menu on gateway connect (true/false, default true)"
     prompt: "Sync native slash commands?"