feat: add Hermes Agent provider

[Mokson]

Summary

Ports the Hermes Agent provider from joeynyc/t3code fork.

• Adds full Hermes provider support (driver, adapter, ACP runtime, text generation)
• Adds Hermes settings schema and configuration UI
• Adds themed chat surface for Hermes (golden/amber color scheme)
• Adds isSelectableProviderInstance helper to consolidate filtering logic
• Adds provider documentation

Sources

• Fork: joeynyc/t3code (13 commits ahead)
• Reference quality verdict: good (port the design as-is)
• Port strategy: adapt (same design, mechanical conflicts)

Changes

Server

• HermesDriver.ts: Provider driver following CursorDriver pattern
• HermesAdapter.ts: ACP adapter for session management (952 lines)
• HermesProvider.ts: Status checking and snapshot building
• HermesAcpSupport.ts: ACP runtime factory
• HermesTextGeneration.ts: Text generation via ACP
• Tests for provider and ACP support

Web

• providerDriverMeta.ts: Hermes client definition
• ProviderInstanceCard.tsx: Hermes setup section with binary path detection
• providerStatus.ts: Hermes-specific status copy
• providerInstances.ts: isSelectableProviderInstance helper
• ChatView.tsx: Hermes surface detection
• index.css: Hermes themed chat surface CSS

Contracts

• settings.ts: HermesSettings schema
• model.ts: HERMES_DRIVER_KIND and defaults
• server.ts: suggestedBinaryPath field

Test plan

• All 1058 tests pass
• Typecheck passes
• Lint passes (only pre-existing warnings)
• Manual: Enable Hermes in settings
• Manual: Verify provider card expands with setup instructions
• Manual: Verify themed chat surface when Hermes selected

Validation evidence

Provider appears in settings with "Early Access" badge and expandable configuration.

Scope exclusions

The following changes from the reference fork were excluded (separate PRs):

• dev-watch.mjs utility (orthogonal DX improvement)
• VITE_HTTP_URL handling (orthogonal DX improvement)

Note

Add Hermes as a built-in AI agent provider

• Adds a full Hermes provider driver (HermesDriver.ts) with binary auto-detection, CLI health checks, auth status parsing, and snapshot enrichment via version advisory.
• Adds a Hermes adapter (HermesAdapter.ts) that manages ACP sessions, turn prompting with image attachments, permission mediation, cancellation, and rollback.
• Adds Hermes-backed text generation (HermesTextGeneration.ts) for commit messages, PR content, branch names, and thread titles via structured JSON output over ACP.
• Adds settings schema for binaryPath and customModels, and registers Hermes in the contracts layer with default model slugs and display name.
• Adds a Hermes-specific chat surface theme and setup UI in ProviderInstanceCard.tsx, including a suggested binary path control and CLI command copy rows.
• resolveSelectableProviderInstance now requires status === 'ready' and models.length > 0 in addition to enabled/available; provider selection in ChatComposer and ModelPickerContent is updated accordingly.
• Risk: the new isSelectableProviderInstance requirement may cause previously selectable provider instances (ready but with no models) to silently fall through to the next candidate.

📊 Macroscope summarized a1b1604. 21 files reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted

🗂️ Filtered Issues

No issues evaluated.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 38159db6-84b4-4307-a209-5caa685adf6a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[macroscopeapp]

🟡 Medium Layers/HermesProvider.ts:79

Full-line comments starting with # at column 0 are not stripped by the regex /\s+#.*$/ on line 79, which requires leading whitespace before #. When a comment appears between model: and default: at indent 0, the block exit check on line 92 fires prematurely, setting inModelBlock = false and causing default: to be missed. The parser returns { defaultModel: null, malformed: true } instead of finding the default value.

-    const withoutComment = line.replace(/\s+#.*$/, "");
+    const withoutComment = line.replace(/\s+#.*$/, "").replace(/^#.*$/, "");

🤖 Copy this AI Prompt to have your agent fix this:

In file @apps/server/src/provider/Layers/HermesProvider.ts around line 79:

Full-line comments starting with `#` at column 0 are not stripped by the regex `/\s+#.*$/` on line 79, which requires leading whitespace before `#`. When a comment appears between `model:` and `default:` at indent 0, the block exit check on line 92 fires prematurely, setting `inModelBlock = false` and causing `default:` to be missed. The parser returns `{ defaultModel: null, malformed: true }` instead of finding the default value.

Evidence trail:
apps/server/src/provider/Layers/HermesProvider.ts lines 72-104 (REVIEWED_COMMIT): line 79 regex `/\s+#.*$/` requires leading whitespace before `#`; line 80 skips only empty lines; line 88 sets `modelIndent = 0`; line 92 checks `indent <= modelIndent` which triggers for indent-0 comment lines that survived the regex.