@artil-ai/hermes 0.1.0 → 0.1.1

package/README.md

@@ -7,25 +7,31 @@ 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
 
@@ -35,7 +41,7 @@ image:
 
 ```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 \
+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'
 ```

package/{artil/__init__.py → __init__.py}

@@ -5,6 +5,8 @@ from __future__ import annotations
 import asyncio
 import dataclasses
 import json
+import shutil
+from pathlib import Path
 from typing import Any
 
 from gateway.config import Platform, PlatformConfig
@@ -16,7 +18,7 @@ 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. "
+    "`artil email send --reply-to` or `artil sms send --reply-to`. "
     "Nobody outside reads what you write in this conversation."
 )
 
@@ -29,7 +31,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
 

package/package.json

@@ -1,24 +1,25 @@
 {
   "name": "@artil-ai/hermes",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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/{artil/plugin.yaml → plugin.yaml}

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