Skip to content

feat: narrow install surface to adapted agents + Hermes support - #6

Merged
DumoeDss merged 5 commits into
dev/0.1.4from
worktree-agent-adapters
Jul 16, 2026
Merged

feat: narrow install surface to adapted agents + Hermes support#6
DumoeDss merged 5 commits into
dev/0.1.4from
worktree-agent-adapters

Conversation

@DumoeDss

Copy link
Copy Markdown
Owner

Why

Rasen's orchestration (subagent dispatch/resume, worker lifecycle) requires per-agent adaptation. Upstream OpenSpec shipped installers for ~27 code agents, but Rasen has only adapted Claude Code (first-class) and Codex — advertising the other installers is misleading. This PR narrows the install surface to adapted agents only, then adds Hermes as the third adapted agent.

What

agent-adapters-visible-tools (a2a52ce)

  • adapted?: boolean flag on AIToolOption; selection surface (getToolsWithSkillsDir()) narrows to adapted tools — interactive multi-select, --tools all, help text
  • --tools <hidden> rejects with a distinct "recognized but not yet adapted" message (isKnownUnadaptedTool()); unknown tokens keep the old error
  • init detected-fallback and update new-tool nudges filter to adapted; tolerant-read surfaces stay full-list so pre-existing installs (e.g. .cursor/) keep refreshing via rasen update
  • Adapter code for the other 25 agents is HIDDEN, not deleted — re-adopting = flip one flag

agent-adapters-hermes (73b321e)

  • Hermes (Nous Research hermes-agent) as third adapted agent: adapted: true, skillsHome: 'global'
  • New src/core/hermes/hermes-home.ts (HERMES_HOME env or ~/.hermes, mirrors codex-home)
  • Per-tool skills-root resolver resolveToolSkillsRoot() threaded through 7 call sites (init/update/tool-detection/migration/profile-sync-drift) — project-local default byte-identical for existing tools; hermes resolves to ~/.hermes/skills
  • NO command adapter — hermes uses the existing no-adapter "commands skipped" path (its quick_commands are shell shortcuts, not prompts); this change's tests also close the previously-untested adapted-but-adapterless path
  • Runtime bridging (exec/resume via hermes -z, --resume) intentionally out of scope; documented for a future change

Specs

+1 new capability (hermes-integration), deltas synced into adapted-agent-visibility (new), ai-tool-paths, cli-init, cli-update. rasen validate --specs --strict: 134 passed, 0 failed.

Tests

Full suite 2720/2720 (was 2714; +6 hermes tests). Review: 2 rounds across children — round-1 Major (CODEX_HOME env leak in tests) fixed and re-verified; accepted-known minors recorded in change archives.

🤖 Generated with Claude Code

DumoeDss and others added 5 commits July 16, 2026 02:41
Restrict visible/installable tool adapters to agents with real Rasen
support instead of listing every detected AI tool, so init/update no
longer offer installs for tools that have no working adapter.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…a2a52ce)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Wire Hermes into the adapter surface alongside Claude and Codex, with
its own global skills-home resolution, config, migration, and
profile-sync-drift handling.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…egated to children, both children shipped+archived)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@DumoeDss
DumoeDss merged commit 0bd56fb into dev/0.1.4 Jul 16, 2026
DumoeDss added a commit that referenced this pull request Jul 16, 2026
Resolves both conflicts:
- test/core/init.test.ts: take dev/0.1.4's adapted-tools semantics for --tools all (agent-adapters PR #6)
- test/core/templates/skill-templates-parity.test.ts: recompute both SHA256 snapshot maps from the merged templates (12 entries — the union of both sides' template ripple sets), via the test's own hashing method

Full suite on merged tree: 2799 passed / 0 failed (after dist rebuild).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K6AuE3xd23DEeikmwXQtYx
@DumoeDss
DumoeDss deleted the worktree-agent-adapters branch July 20, 2026 09:22
DumoeDss added a commit that referenced this pull request Jul 28, 2026
… wrapping, test fixes

Resolves the 6 remaining CI failures on PR #88 head (e3532d0):
- #2 audits-api socket hang: rejectImport uses socket.end() (FIN) + destroy fallback, not req.destroy() (RST)
- #4 B3 race loser: snapshot fs.existsSync before probe; absent-at-start + later-refused = obtain-failed (lost race)
- #5 token-audit: read() wraps all errors as AuditServiceError (was ELOOP on Linux symlinks)
- #1 pin RASEN_AGENT_RUNTIME per-test (dispatchMode assertion)
- #3 bootstrap-obtain registry cleanup via updateStoreRegistryState (was regex corrupting the entry)
- #6 board-page waitForState polling helper (fresh act() per poll)
M1: lost-race diagnostic split (retry, not relocate). T2: theoretical TOCTOU accepted-known.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant