Files
united-workforce/packages/workflow-agent-hermes
xiaoju e9e4960714 refactor(workflow): migrate downstream packages to workflow-runtime (Phase 2+3)
- Verify createWorkflow in runtime has zero I/O imports
- Migrate agent-cursor, agent-hermes to pure workflow-runtime dependency
- Migrate agent-llm, util-agent, templates to dual dependency
  (runtime for types, engine for CAS/merkle/buildDescriptor)
- All 377 tests passing

Refs #121, relates #123 #124
2026-05-08 06:33:52 +00:00
..

@uncaged/workflow-agent-hermes

AgentFn adapter that runs the hermes CLI in non-interactive chat mode (Nerve-style flags: -q, --yolo, --quiet, bounded --max-turns).

The agent composes the same thread-aware prompt as other CLI-backed agents via buildAgentPrompt from @uncaged/workflow-util-agent, then spawns hermes and returns stdout on success.

Install

bun add @uncaged/workflow-agent-hermes @uncaged/workflow @uncaged/workflow-util-agent

In this monorepo: use workspace:* for all three @uncaged/* packages.

Usage

import { createHermesAgent } from "@uncaged/workflow-agent-hermes";

const agent = createHermesAgent({
  model: "your-model", // or null to omit --model
  timeout: 600_000, // ms, or null for no timeout
});

API overview

Export Description
createHermesAgent(config) Returns AgentFn wrapping hermes chat -q ...
HermesAgentConfig model, timeout
validateHermesAgentConfig Config validation result
buildAgentPrompt Re-exported from @uncaged/workflow-util-agent

Requires hermes on PATH at runtime.