@artil-ai/hermes 0.1.1 → 0.1.3

package/README.md

@@ -1,9 +1,10 @@
 # @artil-ai/hermes
 
 The Artil platform for the [Hermes](https://hermes-agent.nousresearch.com)
-gateway. New email and texts to the agent account, and wake-ups from its team,
-reach the gateway as notices that `artil internal hermes-channel` prints, from
-where it left off; the agent answers them with the `artil` CLI.
+gateway. New email, texts and Telegram messages to the agent account, and
+messages its team sends to its Message URL, reach the gateway as notices that
+`artil internal hermes-channel` prints, from where it left off; the agent
+answers them with the `artil` CLI.
 
 ## Usage
 
@@ -35,13 +36,9 @@ itself: the agent answers with `artil` commands.
 
 ## Development
 
-From the repository root, lint and format the plugin with
-[ruff](https://docs.astral.sh/ruff), then validate and test it inside the Hermes
-image:
+From the repository root, lint the plugin with [ruff](https://docs.astral.sh/ruff),
+then validate and test it inside the Hermes image; this needs `uv` and Docker:
 
 ```sh
-uvx ruff check && uvx ruff format --check
-docker run --rm -v "$PWD/plugins/hermes:/plugin" -w /plugin --entrypoint hermes nousresearch/hermes-agent:latest plugins validate .
-docker run --rm -v "$PWD/plugins/hermes:/plugin" -w /plugin --entrypoint sh nousresearch/hermes-agent:latest -c \
-  'uv pip install -q --python /opt/hermes/.venv/bin/python pytest && PYTHONPATH=/opt/hermes /opt/hermes/.venv/bin/python -m pytest -p no:cacheprovider tests'
+bun run check:hermes
 ```

package/__init__.py

@@ -1,4 +1,4 @@
-"""Artil for Hermes: notices about an agent account's new email and texts reach the gateway."""
+"""Artil for Hermes: notices about an agent account's new messages reach the gateway."""
 
 from __future__ import annotations
 
@@ -6,6 +6,7 @@ import asyncio
 import dataclasses
 import json
 import shutil
+import signal
 from pathlib import Path
 from typing import Any
 
@@ -16,10 +17,12 @@ from gateway.platforms.base import BasePlatformAdapter, MessageEvent, MessageTyp
 PLATFORM = "artil"
 
 HINT = (
-    "Notices about new email and texts to this Artil agent account, and wake-ups from its team, "
-    "arrive here. Read each message with the artil command its notice names, and answer it with "
-    "`artil email send --reply-to` or `artil sms send --reply-to`. "
-    "Nobody outside reads what you write in this conversation."
+    "Notices about new email, texts and Telegram messages to this Artil agent account, and "
+    "messages its team sends to its Message URL, arrive here. Read each email, text or Telegram "
+    "message with the artil command its notice names, and answer it with "
+    "`artil email send --reply-to`, `artil sms send --reply-to` or "
+    "`artil telegram send --reply-to`; a message from the Message URL comes whole, and its notice "
+    "says how to answer it. Nobody outside reads what you write in this conversation."
 )
 
 
@@ -68,7 +71,7 @@ class ArtilAdapter(BasePlatformAdapter):
 
         reason = (await problem).decode().strip()
         code = await process.wait()
-        asked_to_stop = code in (0, -2, -15)
+        asked_to_stop = code in (0, -signal.SIGINT, -signal.SIGTERM)
 
         if asked_to_stop:
             await asyncio.sleep(self.STOP_GRACE_SECONDS)
@@ -139,6 +142,7 @@ def _needs_nothing() -> bool:
 
 
 def _service_fields() -> dict[str, Any]:
+    """The entry fields Hermes after 0.21.5 knows, which 0.21.5 itself rejects."""
     known = {field.name for field in dataclasses.fields(PlatformEntry)}
     wanted = {"trusted_inbound": True, "display_tier": "minimal"}
     return {name: value for name, value in wanted.items() if name in known}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artil-ai/hermes",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Hear about your Artil agent's new messages in the Hermes gateway, and answer them with the artil CLI.",
   "keywords": [
     "artil",

package/plugin.yaml

@@ -1,11 +1,11 @@
 name: artil
 label: Artil
 kind: platform
-version: 0.1.1
+version: 0.1.3
 description: >
-  New email and texts to an Artil agent account, and wake-ups from its team,
-  reach the Hermes gateway through the artil CLI. The agent answers them with
-  the CLI.
+  New email and texts to an Artil agent account, and messages its team sends to
+  its Message URL, reach the Hermes gateway through the artil CLI. The agent
+  answers them with the CLI.
 author: Artil
 homepage: https://docs.artil.dev/hermes
 requires_hermes: ">=0.21.5"