Files
fusion/plugins/fusion-plugin-hermes-runtime
Fusion b918ba5ee6 feat(FN-2620): add plugin test-time engine resolution stubs
- Add engine-guard-stub test modules for hermes, openclaw, and paperclip runtime plugins to fail fast on unmocked @fusion/engine imports
- Update each plugin Vitest config to alias @fusion/engine to the local guard stub during test runs
- Keep setup-engine-guard behavior while removing dependency on built engine dist artifacts for plugin-local tests
2026-04-26 21:49:47 -07:00
..
2026-04-26 21:27:49 -07:00
2026-04-26 21:27:49 -07:00

Hermes Runtime Plugin

Provides an executable Hermes runtime plugin for Fusion. This package enables runtime registration, discovery, and session execution so agents configured with runtimeConfig.runtimeHint: "hermes" can run through the standard runtime adapter contract.

Overview

This plugin follows the runtime adapter pattern used by other executable plugin runtimes:

  • Registers Hermes runtime metadata for resolver discovery
  • Creates executable runtime sessions via createFnAgent
  • Delegates prompt execution through promptWithFallback
  • Exposes model descriptions through describeModel
  • Supports best-effort session disposal via dispose()

Installation

Option 1: Copy to plugins directory

cp -r fusion-plugin-hermes-runtime ~/.fusion/plugins/

Option 2: Install via CLI

fn plugin install ./plugins/fusion-plugin-hermes-runtime

Runtime Metadata

  • Plugin ID: fusion-plugin-hermes-runtime
  • Package name: @fusion-plugin-examples/hermes-runtime
  • Runtime ID: hermes
  • Runtime name: Hermes Runtime
  • Version: 0.1.0
  • Description: Hermes-backed AI session using the user's configured pi provider and model

Agent Configuration

Configure an agent to target Hermes via runtimeConfig.runtimeHint:

{
  "name": "Hermes Executor",
  "role": "executor",
  "runtimeConfig": {
    "runtimeHint": "hermes"
  }
}

Local Development

# Run plugin tests
pnpm --filter @fusion-plugin-examples/hermes-runtime test

# Build plugin output to dist/
pnpm --filter @fusion-plugin-examples/hermes-runtime build