@artil-ai/hermes 0.1.0 → 0.1.2

package/README.md

@@ -1,41 +1,44 @@
 # @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 and texts 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
 
-The `artil` CLI carries the plugin from this package. `artil plugin install
-hermes` writes it to `$HERMES_HOME/plugins/artil` and turns it on in Hermes'
-`config.yaml`, with the absolute path of `artil`, since the gateway's service
-does not see your shell's PATH:
-
-```yaml
-plugins:
-  enabled: [artil]
-platforms:
-  artil:
-    enabled: true
-    extra:
-      command: /Users/you/.local/bin/artil
+Install the [Artil CLI](https://artil.dev/INSTALL.md), sign in as the agent with
+`artil auth login`, and let it set up the plugin and the `artil` skill:
+
+```sh
+artil plugin install hermes
+```
+
+Or install the plugin with Hermes:
+
+```sh
+hermes plugins install artilai/plugins/plugins/hermes --enable
 ```
 
-| Entry point         | What it is                                              |
-| ------------------- | ------------------------------------------------------- |
-| `artil/plugin.yaml` | The plugin manifest; Hermes 0.21.5 or later loads it    |
-| `artil/__init__.py` | The `artil` gateway platform and its system-prompt hint |
+The gateway runs the `artil` that `platforms.artil.extra.command` names in
+Hermes' `config.yaml`, else the one on its PATH, else `~/.local/bin/artil`. See
+[Hermes](https://docs.artil.dev/hermes) in the docs.
+
+While the gateway runs, the plugin keeps `artil internal hermes-channel`
+running, which reaches Artil with the CLI's login. The plugin sends nothing
+itself: the agent answers with `artil` commands.
+
+| Entry point   | What it is                                              |
+| ------------- | ------------------------------------------------------- |
+| `plugin.yaml` | The plugin manifest; Hermes 0.21.5 or later loads it    |
+| `__init__.py` | The `artil` gateway platform and its system-prompt hint |
 
 ## 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/hermes:/plugin" -w /plugin --entrypoint hermes nousresearch/hermes-agent:latest plugins validate artil
-docker run --rm -v "$PWD/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/{artil/__init__.py → __init__.py}

@@ -5,6 +5,9 @@ from __future__ import annotations
 import asyncio
 import dataclasses
 import json
+import shutil
+import signal
+from pathlib import Path
 from typing import Any
 
 from gateway.config import Platform, PlatformConfig
@@ -14,9 +17,10 @@ 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`, as the artil skill describes. "
+    "Notices about new email and texts to this Artil agent account, and messages its team sends "
+    "to its Message URL, arrive here. Read each email or text with the artil command its notice "
+    "names, and answer it with `artil email send --reply-to` or `artil sms 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."
 )
 
@@ -29,7 +33,10 @@ class ArtilAdapter(BasePlatformAdapter):
     def __init__(self, config: PlatformConfig) -> None:
         config.extra = {**(config.extra or {}), "allow_from": [PLATFORM]}
         super().__init__(config, Platform(PLATFORM))
-        self._command = str(config.extra.get("command") or "artil")
+        # A gateway service may not have the PATH that finds artil where its installer put it.
+        self._command = str(
+            config.extra.get("command") or shutil.which("artil") or Path.home() / ".local/bin/artil"
+        )
         self._process: asyncio.subprocess.Process | None = None
         self._listening: asyncio.Task | None = None
 
@@ -63,7 +70,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)
@@ -134,6 +141,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,24 +1,25 @@
 {
   "name": "@artil-ai/hermes",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Hear about your Artil agent's new messages in the Hermes gateway, and answer them with the artil CLI.",
   "keywords": [
     "artil",
     "hermes-agent"
   ],
-  "homepage": "https://docs.artil.dev/automatic-messages",
+  "homepage": "https://docs.artil.dev/hermes",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/artilai/plugins.git",
-    "directory": "hermes"
+    "directory": "plugins/hermes"
   },
   "files": [
-    "artil"
+    "plugin.yaml",
+    "__init__.py"
   ],
   "exports": {
-    "./plugin.yaml": "./artil/plugin.yaml",
-    "./__init__.py": "./artil/__init__.py"
+    "./plugin.yaml": "./plugin.yaml",
+    "./__init__.py": "./__init__.py"
   },
   "publishConfig": {
     "access": "public"

package/plugin.yaml

@@ -0,0 +1,11 @@
+name: artil
+label: Artil
+kind: platform
+version: 0.1.2
+description: >
+  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"

package/artil/plugin.yaml

@@ -1,11 +0,0 @@
-name: artil
-label: Artil
-kind: platform
-version: 0.1.0
-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, as the artil skill describes.
-author: Artil
-homepage: https://docs.artil.dev/automatic-messages
-requires_hermes: ">=0.21.5"