@inline-chat/hermes-agent-adapter 0.0.1

package/plugin/inline/cli.py

@@ -0,0 +1,101 @@
+"""Minimal Inline setup hooks for Hermes.
+
+The external package installer (`inline-hermes install`) handles plugin
+installation. This module only provides Hermes-native setup/status hooks once
+the plugin has already been discovered by Hermes.
+"""
+from __future__ import annotations
+
+import argparse
+import os
+import re
+import shutil
+import subprocess
+
+from pathlib import Path
+
+_SIDECAR_ENTRY = Path(__file__).parent / "sidecar" / "index.mjs"
+_MIN_NODE_MAJOR = 20
+
+
+def gateway_setup() -> None:
+    if _env_token_configured():
+        print("Inline env token configured from INLINE_TOKEN/INLINE_BOT_TOKEN.")
+    else:
+        print("Set INLINE_TOKEN or INLINE_BOT_TOKEN in the Hermes gateway environment.")
+        print("Alternatively set platforms.inline.token or inline.token in ~/.hermes/config.yaml.")
+    print("Enable Inline in ~/.hermes/config.yaml:")
+    print("  platforms:")
+    print("    inline:")
+    print("      enabled: true")
+    print("Then run: inline-hermes doctor --json")
+
+
+def register_cli(parser: argparse.ArgumentParser) -> None:
+    subs = parser.add_subparsers(dest="inline_command", required=False)
+    subs.add_parser("setup", help="Show Inline setup instructions")
+    subs.add_parser("status", help="Show Inline adapter status")
+    parser.set_defaults(func=dispatch)
+
+
+def dispatch(args) -> int:
+    command = getattr(args, "inline_command", None)
+    if command is None:
+        command = "status"
+    if command == "setup":
+        gateway_setup()
+        return 0
+    if command == "status":
+        configured = _env_token_configured()
+        print(f"Inline env token configured: {'yes' if configured else 'no'}")
+        print("Hermes config token support: platforms.inline.token or inline.token")
+        print(f"Inline sidecar bundled: {'yes' if _SIDECAR_ENTRY.exists() else 'no'}")
+        print(f"Node available: {_node_status()}")
+        if not configured:
+            print("Hint: use INLINE_TOKEN/INLINE_BOT_TOKEN for env setup, or platforms.inline.token/inline.token in config.yaml.")
+        print("Install diagnostics: inline-hermes doctor --json")
+        return 0
+    raise SystemExit(f"unknown inline command: {command}")
+
+
+def _env_token_configured() -> bool:
+    return bool(os.getenv("INLINE_TOKEN") or os.getenv("INLINE_BOT_TOKEN"))
+
+
+def _find_node_bin() -> str | None:
+    configured = os.getenv("INLINE_NODE_BIN")
+    if configured:
+        return configured
+    try:
+        from hermes_constants import find_node_executable
+        found = find_node_executable("node")
+        if found:
+            return found
+    except Exception:
+        pass
+    return shutil.which("node")
+
+
+def _node_status() -> str:
+    node_bin = _find_node_bin()
+    if not node_bin:
+        return "no"
+    try:
+        result = subprocess.run(
+            [node_bin, "--version"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+            timeout=5,
+            check=False,
+        )
+    except Exception as exc:
+        return f"no ({exc})"
+    version = (result.stdout or result.stderr or "").strip()
+    if result.returncode != 0:
+        return f"no ({version or f'exited with status {result.returncode}'})"
+    match = re.search(r"\bv?(\d+)(?:\.\d+){0,2}\b", version)
+    major = int(match.group(1)) if match else 0
+    if major < _MIN_NODE_MAJOR:
+        return f"no ({version or 'unknown version'}, requires >=20)"
+    return f"yes ({version})"

package/plugin/inline/plugin.yaml

@@ -0,0 +1,132 @@
+name: inline-platform
+label: Inline
+kind: platform
+version: 0.0.1
+description: >
+  Inline platform adapter for Hermes Agent. The adapter runs as a native
+  Hermes Python platform plugin and supervises a local Node sidecar that uses
+  the official Inline realtime SDK for inbound updates, catch-up, outbound
+  sends, uploads, message actions, and presence.
+author: Inline
+requires_env:
+  - name: INLINE_TOKEN
+    description: "Inline bot or user token. Canonical env var; INLINE_BOT_TOKEN, platforms.inline.token, inline.token, and simple ${ENV_NAME} config references are also accepted."
+    prompt: "Inline token"
+    password: true
+optional_env:
+  - name: INLINE_BOT_TOKEN
+    description: "Compatibility alias for INLINE_TOKEN"
+    prompt: "Inline token"
+    password: true
+  - name: INLINE_BASE_URL
+    description: "Inline API base URL (default https://api.inline.chat)"
+    prompt: "Inline API base URL"
+    password: false
+  - name: INLINE_PARSE_MARKDOWN
+    description: "Parse outbound Hermes Markdown in Inline messages (true/false, default true)"
+    prompt: "Parse outbound Markdown?"
+    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?"
+    password: false
+  - name: INLINE_COMMAND_LIMIT
+    description: "Maximum Inline bot commands to register, 1-100 (default 100)"
+    prompt: "Native slash command limit"
+    password: false
+  - name: INLINE_MEDIA_MAX_MB
+    description: "Maximum inbound media download size in MB (default 25)"
+    prompt: "Inbound media max MB"
+    password: false
+  - name: INLINE_UPLOAD_MAX_MB
+    description: "Maximum outbound local upload size in MB (default 300)"
+    prompt: "Outbound upload max MB"
+    password: false
+  - name: INLINE_ALLOWED_USERS
+    description: "Comma-separated Inline user ids allowed to DM the bot"
+    prompt: "Allowed Inline user ids"
+    password: false
+  - name: INLINE_ALLOW_ALL_USERS
+    description: "Allow any sender to trigger the bot"
+    prompt: "Allow all users? (true/false)"
+    password: false
+  - name: INLINE_DM_POLICY
+    description: "DM policy: open, allowlist, or disabled"
+    prompt: "Inline DM policy"
+    password: false
+  - name: INLINE_GROUP_POLICY
+    description: "Group policy: open, allowlist, or disabled"
+    prompt: "Inline group policy"
+    password: false
+  - name: INLINE_GROUP_ALLOW_FROM
+    description: "Comma-separated Inline user ids allowed in groups"
+    prompt: "Allowed group sender ids"
+    password: false
+  - name: INLINE_REQUIRE_MENTION
+    description: "Require a mention/wake word in group chats (default true)"
+    prompt: "Require group mention? (true/false)"
+    password: false
+  - name: INLINE_STRICT_MENTION
+    description: "Require an explicit mention/wake word on every group-chat turn, including replies to the bot (true/false, default false)"
+    prompt: "Require every group turn to mention Hermes? (true/false)"
+    password: false
+  - name: INLINE_ALLOWED_CHATS
+    description: "Comma-separated Inline group/thread chat ids where the bot may respond. Empty means no chat restriction."
+    prompt: "Allowed Inline chat ids"
+    password: false
+  - name: INLINE_FREE_RESPONSE_CHATS
+    description: "Comma-separated Inline group/thread chat ids where no mention is required"
+    prompt: "Free-response Inline chat ids"
+    password: false
+  - name: INLINE_REPLY_THREADS
+    description: "Create/use Inline reply threads for top-level group replies by default (true/false, default true)"
+    prompt: "Reply in Inline threads by default? (true/false)"
+    password: false
+  - name: INLINE_SYSTEM_EVENTS
+    description: "Deliver Inline lifecycle events such as edits, deletes, and participant changes as synthetic messages (true/false, default false)"
+    prompt: "Deliver lifecycle events? (true/false)"
+    password: false
+  - name: INLINE_MENTION_PATTERNS
+    description: "Mention wake-word regexes, JSON list or comma/newline-separated"
+    prompt: "Mention patterns"
+    password: false
+  - name: INLINE_HOME_CHANNEL
+    description: "Default target for cron/standalone sends, for example chat:123"
+    prompt: "Home Inline target"
+    password: false
+  - name: INLINE_HOME_CHANNEL_NAME
+    description: "Human label for the home target"
+    prompt: "Home target display name"
+    password: false
+  - name: INLINE_SIDECAR_PORT
+    description: "Loopback port for the Node sidecar, 1-65535 (default 8794)"
+    prompt: "Sidecar port"
+    password: false
+  - name: INLINE_SIDECAR_BIND
+    description: "Loopback bind host for the Node sidecar (127.0.0.1, localhost, or ::1)"
+    prompt: "Sidecar bind host"
+    password: false
+  - name: INLINE_STATE_PATH
+    description: "Persistent Inline SDK state file path"
+    prompt: "Inline SDK state path"
+    password: false
+  - name: INLINE_SETTINGS_PATH
+    description: "Adapter settings file for per-chat slash-command overrides. Defaults next to INLINE_STATE_PATH."
+    prompt: "Inline adapter settings path"
+    password: false
+  - name: INLINE_RPC_TIMEOUT_MS
+    description: "Inline realtime RPC timeout in milliseconds"
+    prompt: "Inline RPC timeout"
+    password: false
+  - name: INLINE_CONNECT_TIMEOUT_MS
+    description: "Adapter sidecar readiness timeout in milliseconds (default 20000)"
+    prompt: "Sidecar readiness timeout"
+    password: false
+  - name: INLINE_SIDECAR_AUTOSTART
+    description: "Spawn the sidecar on connect (true/false, default true)"
+    prompt: "Auto-start sidecar?"
+    password: false
+  - name: INLINE_NODE_BIN
+    description: "Path to Node.js 20+ binary"
+    prompt: "Node executable path"
+    password: false