hermes-baiduapp 0.1.0__tar.gz

hermes_baiduapp-0.1.0/.gitignore

@@ -0,0 +1,121 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and *not* Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# mac
+.DS_Store
+
+log/
+
+.env
+
+node_modules.zip
+
+output
+
+# ReCode local database
+.recode
+
+CLAUDE.md
+.sisyphus

hermes_baiduapp-0.1.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: hermes-baiduapp
+Version: 0.1.0
+Summary: Baidu App platform plugin for Hermes Agent (polling mode, no webhook)
+License: MIT
+Keywords: baidu,chatbot,gateway,hermes,hermes-agent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# hermes-baiduapp
+
+Baidu App platform plugin for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
+
+Uses polling mode (`/channel/msg/poll`) to receive messages. No webhook required.
+
+## Install
+
+```bash
+pip install hermes-baiduapp
+```
+
+## Configure
+
+Add to `~/.hermes/.env`:
+
+```
+BAIDU_APP_KEY=your-app-key
+BAIDU_APP_SECRET=your-app-secret
+# Optional:
+BAIDU_API_BASE=https://claw.baidu.com
+GATEWAY_ALLOW_ALL_USERS=true
+```
+
+Then restart the gateway:
+
+```bash
+hermes gateway run
+```
+
+No changes to `config.yaml` needed — the plugin is auto-discovered via entry_points.

hermes_baiduapp-0.1.0/README.md

@@ -0,0 +1,31 @@
+# hermes-baiduapp
+
+Baidu App platform plugin for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
+
+Uses polling mode (`/channel/msg/poll`) to receive messages. No webhook required.
+
+## Install
+
+```bash
+pip install hermes-baiduapp
+```
+
+## Configure
+
+Add to `~/.hermes/.env`:
+
+```
+BAIDU_APP_KEY=your-app-key
+BAIDU_APP_SECRET=your-app-secret
+# Optional:
+BAIDU_API_BASE=https://claw.baidu.com
+GATEWAY_ALLOW_ALL_USERS=true
+```
+
+Then restart the gateway:
+
+```bash
+hermes gateway run
+```
+
+No changes to `config.yaml` needed — the plugin is auto-discovered via entry_points.

hermes_baiduapp-0.1.0/hermes_baiduapp/__init__.py

@@ -0,0 +1,3 @@
+from .adapter import register
+
+__all__ = ["register"]

hermes_baiduapp-0.1.0/hermes_baiduapp/adapter.py

@@ -0,0 +1,297 @@
+import asyncio
+import binascii
+import hashlib
+import json
+import logging
+import os
+import time
+from typing import Any, Dict, Optional
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+try:
+    import secrets
+except ImportError:
+    secrets = None
+
+from gateway.config import Platform
+from gateway.platforms.base import BasePlatformAdapter, MessageEvent, MessageType, SendResult
+
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_API_BASE = "https://claw.baidu.com"
+DEFAULT_SESSION_ID = "agent:main:main"
+DEFAULT_POLL_INTERVAL = 3.0  # seconds
+DEFAULT_POLL_TIMEOUT = 10.0  # seconds
+PLUGIN_VERSION = "hermes-baiduapp/1.0.0"
+
+
+def _generate_nonce():
+    if secrets is not None:
+        return secrets.token_hex(8)
+    return binascii.hexlify(os.urandom(8)).decode("ascii")
+
+
+def _compute_aksk_token(ak, sk, timestamp, nonce):
+    return hashlib.sha1((ak + sk + timestamp + nonce).encode()).hexdigest()
+
+
+def build_authorization_header(ak, sk, timestamp, nonce):
+    token = _compute_aksk_token(ak, sk, timestamp, nonce)
+    return "Bearer {token}".format(token=token)
+
+
+def _coerce_float(value, default):
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return default
+
+
+def _coerce_poll_interval(extra):
+    env_ms = os.getenv("BAIDU_POLL_INTERVAL_MS")
+    if env_ms:
+        interval_ms = _coerce_float(env_ms, DEFAULT_POLL_INTERVAL * 1000)
+        return max(interval_ms / 1000.0, 0.1)
+
+    if "poll_interval" in extra:
+        return max(_coerce_float(extra.get("poll_interval"), DEFAULT_POLL_INTERVAL), 0.1)
+
+    if "poll_interval_ms" in extra:
+        interval_ms = _coerce_float(extra.get("poll_interval_ms"), DEFAULT_POLL_INTERVAL * 1000)
+        return max(interval_ms / 1000.0, 0.1)
+
+    return DEFAULT_POLL_INTERVAL
+
+
+def _extract_text_from_list(items):
+    texts = []
+    if not isinstance(items, list):
+        return ""
+
+    for item in items:
+        if not isinstance(item, dict) or item.get("type") != "text":
+            continue
+        raw_data = item.get("data")
+        data = raw_data if isinstance(raw_data, dict) else {}
+        raw_text = data.get("text")
+        text_data = raw_text if isinstance(raw_text, dict) else {}
+        content = text_data.get("content")
+        if isinstance(content, str) and content:
+            texts.append(content)
+
+    return "\n".join(texts).strip()
+
+
+class BaiduAppAdapter(BasePlatformAdapter):
+    """Polling adapter for the Baidu App V2 channel API."""
+
+    def __init__(self, config, **kwargs):
+        super().__init__(config=config, platform=Platform("baiduapp"))
+
+        extra = getattr(config, "extra", {}) or {}
+        self.app_key = os.getenv("BAIDU_APP_KEY") or extra.get("app_key") or extra.get("appKey") or ""
+        self.app_secret = os.getenv("BAIDU_APP_SECRET") or extra.get("app_secret") or extra.get("appSecret") or ""
+        self.api_base = (os.getenv("BAIDU_API_BASE") or extra.get("api_base") or extra.get("apiBase") or DEFAULT_API_BASE).rstrip("/")
+        self.poll_interval = _coerce_poll_interval(extra)
+        self.request_timeout = _coerce_float(extra.get("request_timeout"), DEFAULT_POLL_TIMEOUT)
+        self.session_id = extra.get("session_id") or extra.get("sessionId") or DEFAULT_SESSION_ID
+        self._poll_task: Optional[asyncio.Task] = None
+
+    @property
+    def name(self) -> str:
+        return "Baidu App"
+
+    async def connect(self) -> bool:
+        if not self.app_key or not self.app_secret:
+            logger.error("Baidu App: BAIDU_APP_KEY and BAIDU_APP_SECRET must be configured")
+            self._set_fatal_error(
+                "config_missing",
+                "BAIDU_APP_KEY and BAIDU_APP_SECRET must be configured",
+                retryable=False,
+            )
+            return False
+
+        if self._poll_task is None or self._poll_task.done():
+            self._poll_task = asyncio.create_task(self._poll_loop())
+        self._mark_connected()
+        logger.info("Baidu App: connected using polling interval %.1fs", self.poll_interval)
+        return True
+
+    async def disconnect(self) -> None:
+        self._mark_disconnected()
+        if self._poll_task and not self._poll_task.done():
+            self._poll_task.cancel()
+            try:
+                await self._poll_task
+            except asyncio.CancelledError:
+                pass
+        self._poll_task = None
+
+    async def send(
+        self,
+        chat_id: str,
+        content: str,
+        reply_to: Optional[str] = None,
+        metadata: Optional[Dict[str, Any]] = None,
+    ):
+        body = {
+            "sessionId": self.session_id,
+            "list": [{"type": "text", "data": {"text": {"content": content}}}],
+            "version": PLUGIN_VERSION,
+            "isActive": True,
+        }
+        try:
+            response = await self._post_json("/channel/msg/callback", body)
+        except asyncio.CancelledError:
+            raise
+        except Exception as exc:
+            logger.warning("Baidu App: send failed: %s", exc)
+            return SendResult(success=False, error=str(exc), retryable=True)
+
+        if response.get("code") != 0:
+            error = response.get("msg") or response.get("message") or "channel callback failed"
+            return SendResult(success=False, error=str(error), raw_response=response)
+
+        raw_data = response.get("data")
+        data = raw_data if isinstance(raw_data, dict) else {}
+        message_id = data.get("msgId") or data.get("messageId") or str(int(time.time() * 1000))
+        return SendResult(success=True, message_id=str(message_id), raw_response=response)
+
+    async def send_typing(self, chat_id: str, metadata=None) -> None:
+        pass
+
+    async def get_chat_info(self, chat_id: str) -> Dict[str, Any]:
+        return {"name": chat_id, "type": "dm", "chat_id": chat_id}
+
+    async def _poll_loop(self):
+        try:
+            while True:
+                try:
+                    await self._poll_once()
+                except asyncio.CancelledError:
+                    raise
+                except Exception as exc:
+                    logger.warning("Baidu App: poll cycle failed: %s", exc)
+                await asyncio.sleep(self.poll_interval)
+        except asyncio.CancelledError:
+            raise
+
+    async def _poll_once(self):
+        body = {"sessionId": self.session_id, "num": 5, "version": PLUGIN_VERSION}
+        response = await self._post_json("/channel/msg/poll", body)
+        if response.get("code") != 0:
+            logger.debug(
+                "Baidu App: poll returned non-zero code=%s message=%s",
+                response.get("code"),
+                response.get("message") or response.get("msg"),
+            )
+
+        raw_data = response.get("data")
+        data = raw_data if isinstance(raw_data, dict) else {}
+        raw_msg_list = data.get("msgList")
+        msg_list = raw_msg_list if isinstance(raw_msg_list, list) else []
+        for msg in msg_list:
+            if isinstance(msg, dict):
+                await self._dispatch_poll_message(msg)
+
+    async def _dispatch_poll_message(self, msg):
+        text = _extract_text_from_list(msg.get("list"))
+        if not text:
+            return
+
+        message_id = msg.get("msgId") or str(int(time.time() * 1000))
+        raw_from = msg.get("from")
+        from_info = raw_from if isinstance(raw_from, dict) else {}
+        user_id = from_info.get("uid") or "baiduapp-user"
+        user_name = from_info.get("name") or str(user_id)
+        chat_id = msg.get("sessionId") or self.session_id
+
+        source = self.build_source(
+            chat_id=chat_id,
+            chat_name=chat_id,
+            chat_type="dm",
+            user_id=str(user_id),
+            user_name=user_name,
+            message_id=str(message_id),
+        )
+        event = MessageEvent(
+            text=text,
+            message_type=MessageType.TEXT,
+            source=source,
+            raw_message=msg,
+            message_id=str(message_id),
+        )
+        await self.handle_message(event)
+
+    async def _post_json(self, path, body):
+        timestamp = str(int(time.time()))
+        nonce = _generate_nonce()
+        query = urlencode({"ak": self.app_key, "timestamp": timestamp, "nonce": nonce})
+        url = "%s%s?%s" % (self.api_base, path, query)
+        headers = {
+            "Authorization": build_authorization_header(self.app_key, self.app_secret, timestamp, nonce),
+            "Content-Type": "application/json",
+        }
+        payload = json.dumps(body).encode("utf-8")
+        loop = asyncio.get_running_loop()
+        return await loop.run_in_executor(None, self._post_json_sync, url, headers, payload)
+
+    def _post_json_sync(self, url, headers, payload):
+        request = Request(url, data=payload, headers=headers, method="POST")
+        with urlopen(request, timeout=self.request_timeout) as response:
+            response_text = response.read().decode("utf-8")
+        if not response_text:
+            raise ValueError("empty response from Baidu App API")
+        try:
+            return json.loads(response_text)
+        except ValueError as exc:
+            raise ValueError("invalid JSON response from Baidu App API") from exc
+
+
+def check_requirements():
+    return bool(os.getenv("BAIDU_APP_KEY") and os.getenv("BAIDU_APP_SECRET"))
+
+
+def validate_config(config) -> bool:
+    extra = getattr(config, "extra", {}) or {}
+    app_key = os.getenv("BAIDU_APP_KEY") or extra.get("app_key") or extra.get("appKey")
+    app_secret = os.getenv("BAIDU_APP_SECRET") or extra.get("app_secret") or extra.get("appSecret")
+    return bool(app_key and app_secret)
+
+
+def is_connected(config) -> bool:
+    return validate_config(config)
+
+
+def _env_enablement():
+    app_key = os.getenv("BAIDU_APP_KEY", "").strip()
+    app_secret = os.getenv("BAIDU_APP_SECRET", "").strip()
+    if not (app_key and app_secret):
+        return None
+    return {
+        "app_key": app_key,
+        "api_base": os.getenv("BAIDU_API_BASE", DEFAULT_API_BASE).strip(),
+    }
+
+
+def register(ctx):
+    ctx.register_platform(
+        name="baiduapp",
+        label="Baidu App",
+        adapter_factory=lambda cfg: BaiduAppAdapter(cfg),
+        check_fn=check_requirements,
+        validate_config=validate_config,
+        is_connected=is_connected,
+        required_env=["BAIDU_APP_KEY", "BAIDU_APP_SECRET"],
+        install_hint="Configure BAIDU_APP_KEY and BAIDU_APP_SECRET in ~/.hermes/.env",
+        env_enablement_fn=_env_enablement,
+        allowed_users_env="BAIDU_ALLOWED_USERS",
+        allow_all_env="BAIDU_ALLOW_ALL_USERS",
+        platform_hint=(
+            "You are chatting via Baidu App. "
+            "Use plain text or markdown. "
+            "Keep responses concise."
+        ),
+    )

hermes_baiduapp-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hermes-baiduapp"
+version = "0.1.0"
+description = "Baidu App platform plugin for Hermes Agent (polling mode, no webhook)"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+keywords = ["hermes", "hermes-agent", "baidu", "chatbot", "gateway"]
+
+[project.entry-points."hermes.plugins"]
+baiduapp = "hermes_baiduapp"