herm-tui 1.8.2-dev.8 → 1.9.0-dev.2

package/README.md

@@ -91,6 +91,22 @@ See [`.env.example`](./.env.example) for rarely-needed overrides.
 - Open board and task detail views, inspect diagnostics, and dispatch work from
   the same shell you use for chat.
 
+### Share and install eikons
+
+- Press `M` from Gallery to enter the native Eikon Marketplace.
+- Search shared catalog entries, preview the selected eikon, install without
+  activating, then use it when ready.
+- Use `eikon.liftaris.dev` as a discovery mirror only; it previews catalog
+  entries and points back to Herm for native install/use.
+- Submit local non-bundled eikons for review with `u`; Herm shows the exact
+  preflight bundle before submission and blocks published marketplace installs
+  from duplicate review submission.
+
+Herm owns native Marketplace behavior. The eikon repo owns the registry,
+browser mirror, shared catalog/player exports, install resolver, and publish
+preflight. Herm imports public eikon package exports rather than browser mirror
+internals or unexported source paths.
+
 ### Customize the shell
 
 - Press `Ctrl+K` for the command palette.

package/assets/plugins/eikon/__init__.py

@@ -0,0 +1,17 @@
+"""Eikon install plugin."""
+
+from __future__ import annotations
+
+from .schemas import EIKON_INSTALL_SCHEMA
+from .tools import _handle_eikon_install, check_herm_available
+
+
+def register(ctx) -> None:
+    ctx.register_tool(
+        name="eikon_install",
+        toolset="eikon",
+        schema=EIKON_INSTALL_SCHEMA,
+        handler=_handle_eikon_install,
+        check_fn=check_herm_available,
+        emoji="⬡",
+    )

package/assets/plugins/eikon/plugin.yaml

@@ -0,0 +1,7 @@
+name: eikon
+version: 1.0.0
+description: "Herm eikon installer tool. Lets Hermes chat install terminal avatars through the existing `herm eikon install` CLI path."
+author: Liftaris
+kind: standalone
+provides_tools:
+  - eikon_install

package/assets/plugins/eikon/schemas.py

@@ -0,0 +1,41 @@
+"""Tool schemas for the eikon plugin."""
+
+from __future__ import annotations
+
+EIKON_INSTALL_SCHEMA = {
+    "name": "eikon_install",
+    "description": (
+        "Install a Herm eikon/avatar from the public catalog, a manifest URL, "
+        "a git repository, or a local directory. Uses `herm eikon install`; "
+        "no separate eikon executable is required."
+    ),
+    "parameters": {
+        "type": "object",
+        "properties": {
+            "source": {
+                "type": "string",
+                "description": "Catalog name, HTTPS manifest/base URL, git URL, or local directory.",
+            },
+            "name": {
+                "type": "string",
+                "description": "Optional installed name override.",
+            },
+            "media": {
+                "type": "boolean",
+                "description": "Whether to fetch source media into the profile. Default true.",
+                "default": True,
+            },
+            "no_source": {
+                "type": "boolean",
+                "description": "Alias for media=false.",
+                "default": False,
+            },
+            "set_active": {
+                "type": "boolean",
+                "description": "Set the installed eikon as the active Herm avatar. Default true.",
+                "default": True,
+            },
+        },
+        "required": ["source"],
+    },
+}

package/assets/plugins/eikon/tools.py

@@ -0,0 +1,69 @@
+"""Handlers for the eikon plugin."""
+
+from __future__ import annotations
+
+import json
+import os
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Any
+
+
+def _json(data: dict[str, Any]) -> str:
+    return json.dumps(data)
+
+
+def _herm_bin() -> str | None:
+    override = os.getenv("HERM_EIKON_HERM_BIN", "").strip()
+    if override:
+        return override
+    return shutil.which("herm")
+
+
+def check_herm_available() -> bool:
+    binary = _herm_bin()
+    if not binary:
+        return False
+    if os.path.sep in binary:
+        return Path(binary).is_file() and os.access(binary, os.X_OK)
+    return shutil.which(binary) is not None
+
+
+def _handle_eikon_install(args: dict[str, Any], **_: Any) -> str:
+    source = str(args.get("source") or "").strip()
+    if not source:
+        return _json({"ok": False, "error": "source is required"})
+
+    binary = _herm_bin()
+    if not binary:
+        return _json({"ok": False, "error": "herm executable not found on PATH"})
+
+    cmd = [binary, "eikon", "install", source, "--json"]
+    name = str(args.get("name") or "").strip()
+    if name:
+        cmd.extend(["--name", name])
+    if args.get("media") is False or args.get("no_source") is True:
+        cmd.append("--no-source")
+    if args.get("set_active") is False:
+        cmd.append("--no-use")
+
+    try:
+        proc = subprocess.run(cmd, capture_output=True, text=True, timeout=120, check=False)
+    except FileNotFoundError:
+        return _json({"ok": False, "error": f"herm executable not found: {binary}"})
+    except subprocess.TimeoutExpired:
+        return _json({"ok": False, "error": "herm eikon install timed out"})
+
+    stdout = (proc.stdout or "").strip()
+    stderr = (proc.stderr or "").strip()
+    if proc.returncode != 0:
+        detail = stderr or stdout or f"exit {proc.returncode}"
+        return _json({"ok": False, "error": f"herm eikon install failed: {detail}"})
+
+    line = next((ln for ln in reversed(stdout.splitlines()) if ln.strip()), "")
+    try:
+        payload = json.loads(line)
+    except json.JSONDecodeError:
+        return _json({"ok": False, "error": "herm eikon install returned non-JSON output", "output": stdout})
+    return _json(payload)