hermes-action-bridge 0.2.0

package/examples/codex/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: hermes-action-bridge
+description: Delegate external actions, Hermes skills, browser automation, messaging, cron jobs, and integrations to Hermes Agent through hermes-action. Use when a task needs capabilities outside the local coding session.
+---
+
+# Hermes Action Bridge
+
+Use this skill when a task needs capabilities outside the local coding session:
+Hermes skills or memory, messaging platforms, browser automation, scheduled or
+cron automation, external research, or any platform integration already
+configured in Hermes Agent.
+
+Do not reimplement those integrations here. Delegate them to Hermes through the
+`hermes-action` CLI.
+
+## When to use
+
+- The task requires a Hermes skill, tool, profile, or connected service.
+- The task needs a real-world action that is not local code editing.
+- The task needs research, messaging, browser, or scheduled automation Hermes owns.
+
+## Safe default
+
+Ask Hermes for a plan first; it has no side effects:
+
+```bash
+hermes-action run --mode plan "<describe what Hermes should do>"
+```
+
+## With context
+
+Write a concise handoff to a file and pass it explicitly:
+
+```bash
+hermes-action run --preset coding --context ./handoff.md "<request>"
+```
+
+## External side effects
+
+For public posts, outbound email or messages, deletes, payments, credential
+changes, or git pushes, require human approval:
+
+```bash
+hermes-action run --mode request-approval "<request requiring side effects>"
+```
+
+Never use `--yolo` unless the human explicitly asked for trusted local
+execution. It bypasses only the bridge policy, not Hermes' own safety rules.
+
+## Verify setup
+
+```bash
+hermes-action status
+hermes-action run --dry-run --json "Return BRIDGE_OK only."
+```

package/examples/configs/basic.yaml

@@ -0,0 +1,36 @@
+runtime:
+  adapter: hermes-cli
+  command: hermes
+
+defaults:
+  mode: plan
+  source: external-agent
+  max_turns: 30
+  preset: default
+
+presets:
+  default:
+    description: No extra skills or toolsets. Uses the active Hermes profile.
+    skills: []
+    toolsets: []
+
+  research:
+    description: General research and synthesis.
+    skills: []
+    toolsets: [web, terminal, file]
+
+  coding:
+    description: Repository inspection and runtime validation.
+    skills: [developer-assurance-and-validation, runtime-debugging]
+    toolsets: [terminal, file]
+
+policy:
+  yolo: false
+  require_approval_for:
+    - publish_external
+    - send_message
+    - send_email
+    - delete
+    - payment
+    - git_push
+    - credential_change

package/examples/configs/strict.yaml

@@ -0,0 +1,26 @@
+runtime:
+  adapter: hermes-cli
+  command: hermes
+
+defaults:
+  mode: request-approval
+  source: external-agent
+  max_turns: 20
+  preset: default
+
+presets:
+  default:
+    description: Safe default. Hermes can plan or prepare actions, but external effects require approval.
+    skills: []
+    toolsets: []
+
+policy:
+  yolo: false
+  require_approval_for:
+    - publish_external
+    - send_message
+    - send_email
+    - delete
+    - payment
+    - git_push
+    - credential_change

package/examples/configs/yolo.yaml

@@ -0,0 +1,19 @@
+runtime:
+  adapter: hermes-cli
+  command: hermes
+
+defaults:
+  mode: execute
+  source: trusted-local-agent
+  max_turns: 60
+  preset: default
+
+presets:
+  default:
+    description: Trusted local mode. Use only in isolated environments.
+    skills: []
+    toolsets: []
+
+policy:
+  yolo: true
+  require_approval_for: []

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "hermes-action-bridge",
+  "version": "0.2.0",
+  "description": "Configurable bridge for external agents to delegate actions to Hermes Agent via CLI or MCP.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheBlueHouse75/hermes-action-bridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TheBlueHouse75/hermes-action-bridge/issues"
+  },
+  "homepage": "https://github.com/TheBlueHouse75/hermes-action-bridge#readme",
+  "type": "module",
+  "bin": {
+    "hermes-action": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "docs/*.md",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "postbuild": "node -e \"require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "npm run build && npm run test",
+    "prepublishOnly": "npm run check"
+  },
+  "keywords": [
+    "hermes-agent",
+    "codex",
+    "claude-code",
+    "mcp",
+    "agent",
+    "automation"
+  ],
+  "author": "Cyril Guilleminot",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^15.0.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  }
+}