Files
united-workforce/packages/workflow-agent-hermes
xiaoju 5bbac3e4f7 chore: internalize unused exports across all packages
Audit public API surfaces using reachability analysis from application
entry points (Worker, CLI, Dashboard). Symbols not reachable from any
application's customization tree are removed from package index.ts files.

Source files and internal usage are untouched — only the public export
surface is narrowed.

Changes by package:
- workflow-util: -7 exports (base32 internals, logger config types)
- workflow-cas: -12 exports (merkle internals, serialization details)
- workflow-execute: -24 exports (engine internals, LLM extract details)
- workflow-reactor: -4 exports (reactor config/invocation internals)
- workflow-register: -8 exports (redundant protocol re-exports, internal YAML fns)
- workflow-runtime: curated re-export subset (stop full protocol re-export)
- workflow-util-agent: -5 exports (internal agent helpers)
- workflow-agent-cursor: -1 export (validateCursorAgentConfig)
- workflow-agent-hermes: -1 export (validateHermesAgentConfig)

Note: workflow-protocol index.ts unchanged — downstream packages still
import removed symbols via internal paths. Protocol cleanup requires
updating workflow-runtime/src/types.ts first (separate PR).

Refs #273, #274, #275, #276, #277, #278, #279, #280, #281, #282
2026-05-16 09:58:56 +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-runtime @uncaged/workflow-util-agent

In this monorepo: use workspace:* for @uncaged/workflow-agent-hermes, @uncaged/workflow-runtime, and @uncaged/workflow-util-agent.

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

Requires hermes on PATH at runtime.