@litfamily/lithermes 1.0.0 → 1.0.1

package/README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.0/readme-assets/cover.webp" width="100%" alt="LitHermes v5 armory cover" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.1/readme-assets/cover.webp" width="100%" alt="LitHermes v5 armory cover" /></p>
 
 ```
                              ▄▄▄▄
@@ -41,7 +41,7 @@ LitHermes connects planning, execution, review, and handoff inside **Hermes Agen
 
 [한국어](./README_Ko-KR.md) · [npm](https://www.npmjs.com/package/@litfamily/lithermes) · [GitHub](https://github.com/wjgoarxiv/lithermes)
 
-Source version: `@litfamily/lithermes@1.0.0`. Install the scoped package from npm with the command in Quick start. A reviewed local archive remains available as an optional isolated trial.
+Source version: `@litfamily/lithermes@1.0.1`. Install the scoped package from npm with the command in Quick start. A reviewed local archive remains available as an optional isolated trial.
 
 Landing images load from the published package so they render on npmjs. Guide links still point at the source repository.
 

package/README_Ko-KR.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.0/readme-assets/cover.webp" width="100%" alt="LitHermes v5 armory cover" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.1/readme-assets/cover.webp" width="100%" alt="LitHermes v5 armory cover" /></p>
 
 ```
                              ▄▄▄▄
@@ -44,7 +44,7 @@ LitHermes는 **Hermes Agent**에서 계획, 실행, 검토, 인계를 이어갑
 
 [English](./README.md) · [npm](https://www.npmjs.com/package/@litfamily/lithermes) · [GitHub](https://github.com/wjgoarxiv/lithermes)
 
-소스 기준 버전은 `@litfamily/lithermes@1.0.0`입니다. 빠른 시작의 명령으로 scoped package를 설치합니다. 별도 체험이 필요하면 검토된 로컬 압축 파일을 선택할 수 있습니다.
+소스 기준 버전은 `@litfamily/lithermes@1.0.1`입니다. 빠른 시작의 명령으로 scoped package를 설치합니다. 별도 체험이 필요하면 검토된 로컬 압축 파일을 선택할 수 있습니다.
 
 랜딩 이미지는 게시된 패키지에서 불러와 npmjs에서도 보입니다. 안내 문서 링크는 소스 저장소를 가리킵니다.
 

package/assets/lithermes-plugin/__init__.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import argparse
+from contextvars import ContextVar
 import functools
 import re
 from pathlib import Path
@@ -21,6 +22,35 @@ from .litgoal import hook as litgoal_hook
 from .litgoal import tools as litgoal_tools
 
 
+_NATIVE_COMMAND_CONTEXT: ContextVar[dict[str, str] | None] = ContextVar(
+    "lithermes_native_command_context", default=None
+)
+_NATIVE_COMMANDS = frozenset(
+    {
+        "lit-plan",
+        "litwork-plan",
+        "lit",
+        "lit-loop",
+        "litwork-loop",
+        "litgoal",
+        "review-work",
+        "start-work",
+        "deep-interview",
+        "lit-recap",
+        "lit-handoff",
+        "lit-scientific-visualization",
+        "korean-ai-slop-remover",
+        *core.KOREAN_PROSE_COMMANDS,
+    }
+)
+_NATIVE_GATEWAY_NOTICE = (
+    "LitHermes could not start an agent turn on the Hermes gateway: native gateway "
+    "injection requires an existing session key and "
+    "`plugins.entries.lithermes.allow_gateway_injection: true`; LitHermes does not "
+    "enable that setting."
+)
+
+
 PORTED_SKILLS = [
     (
         "lit-burnoff-file",
@@ -358,7 +388,7 @@ def _setup_lithermes_cli(parser) -> None:
         f"skills: {len(PORTED_SKILLS)} lithermes:* skills — `hermes lithermes status` lists them\n"
         "contract schema: lithermes_llm_contract/v1 headings include #contract.activation, "
         "#contract.inputs, #contract.outputs, #contract.evidence, and #contract.hard_stops\n"
-        "hooks: on_session_start, pre_llm_call, pre_tool_call, post_tool_call, "
+        "hooks: on_session_start, pre_llm_call, pre_tool_call, pre_command, post_tool_call, "
         "post_api_request, subagent_stop, transform_llm_output, on_session_finalize, on_session_reset\n"
         "bounded work: schema 3 via /lit-loop init|status|resume|cancel|complete and lithermes_work_progress\n"
         "wikify knowledge: hermes lithermes knowledge status|query|capture|save|review\n"
@@ -403,6 +433,91 @@ def _ignited(handler, route):
     return wrapped
 
 
+def _capture_pre_command(**kwargs: Any) -> None:
+    """Remember the host route immediately before Hermes invokes a command.
+
+    Hermes 0.21 fires ``pre_command`` for both the CLI and gateway surfaces. The
+    command handler itself only receives raw arguments, so this small
+    context-local bridge carries the surface/session pair into the native
+    ``PluginContext.inject_message`` adapter below. Older Hermes releases do not
+    expose ``inject_message`` and never register this hook.
+    """
+    surface = str(kwargs.get("surface") or "").strip().lower()
+    if surface not in {"cli", "gateway"}:
+        return None
+    command = str(
+        kwargs.get("command")
+        or kwargs.get("alias_used")
+        or ""
+    ).strip().lstrip("/").lower()
+    if command not in _NATIVE_COMMANDS:
+        return None
+    session_key = str(kwargs.get("session_key") or "").strip()
+    _NATIVE_COMMAND_CONTEXT.set(
+        {"surface": surface, "session_key": session_key}
+    )
+    return None
+
+
+def _native_command_dispatch(ctx, handler):
+    """Adapt structured LitHermes results to Hermes 0.21's native API.
+
+    Hermes 0.17/0.19 have no ``inject_message`` method, so registration keeps
+    returning the legacy structured payload for the installer source patch. On
+    0.21 the plugin API owns the queueing/turn lifecycle; returning the dict to
+    the host would otherwise print its Python representation to users.
+    """
+    inject_message = getattr(ctx, "inject_message", None)
+    if not callable(inject_message):
+        return handler
+
+    @functools.wraps(handler)
+    def wrapped(user_args):
+        context = _NATIVE_COMMAND_CONTEXT.get() or {}
+        try:
+            result = handler(user_args)
+            if not isinstance(result, dict):
+                return result
+
+            display = result.get("display") or result.get("message")
+            agent_message = result.get("agent_message")
+            injected = False
+            if agent_message:
+                try:
+                    injected = bool(
+                        inject_message(
+                            str(agent_message),
+                            role="user",
+                            session_key=context.get("session_key") or None,
+                        )
+                    )
+                except Exception:
+                    # A host-side refusal must remain a visible, actionable
+                    # result rather than leaking the structured dict repr.
+                    injected = False
+
+            if context.get("surface") == "gateway" and not injected:
+                display_text = str(display) if display else ""
+                return (
+                    f"{display_text}\n\n{_NATIVE_GATEWAY_NOTICE}"
+                    if display_text
+                    else _NATIVE_GATEWAY_NOTICE
+                )
+            if display is not None:
+                return str(display)
+            return ""
+        finally:
+            _NATIVE_COMMAND_CONTEXT.set(None)
+
+    return wrapped
+
+
+def _command_handler(ctx, handler, route=None):
+    """Build a command handler that works on both legacy and native Hermes."""
+    ignited = _ignited(handler, route) if route else handler
+    return _native_command_dispatch(ctx, ignited)
+
+
 def _transform_llm_output(**kwargs: Any) -> str | None:
     named = handoff.transform_llm_output(**kwargs)
     if named is not None:
@@ -458,6 +573,11 @@ def register(ctx) -> None:
     # The host-supplied session id authorizes progress before the model-facing
     # tool handler runs. The tool itself has no resume/grant lifecycle bypass.
     ctx.register_hook("pre_tool_call", _pre_tool_call)
+    # Hermes 0.21 gives native plugin commands a host-owned turn injection API.
+    # Register the route bridge only when that API exists; older Hermes releases
+    # continue through the installer-managed source patch below.
+    if callable(getattr(ctx, "inject_message", None)):
+        ctx.register_hook("pre_command", _capture_pre_command)
     # Observer over completed mutations. Hermes ignores this hook's return value, so
     # it only buffers the mutated paths; pre_llm_call renders them into the
     # event-shaped skill route on the next turn.
@@ -489,80 +609,80 @@ def register(ctx) -> None:
 
     ctx.register_command(
         "lit-plan",
-        _ignited(core.command_lit_plan, "lit-plan"),
+        _command_handler(ctx, core.command_lit_plan, "lit-plan"),
         description="Create a durable Litwork implementation plan",
         args_hint='"what to build"',
     )
     ctx.register_command(
         "litwork-plan",
-        _ignited(core.command_lit_plan, "lit-plan"),
+        _command_handler(ctx, core.command_lit_plan, "lit-plan"),
         description="Alias for /lit-plan",
         args_hint='"what to build"',
     )
     ctx.register_command(
         "lit",
-        _ignited(core.command_lit, "litwork"),
+        _command_handler(ctx, core.command_lit, "litwork"),
         description="Start a Litwork run and execute the task immediately",
         args_hint='"task"',
     )
     ctx.register_command(
         "lit-loop",
-        _ignited(core.command_lit_loop, "lit-loop"),
+        _command_handler(ctx, core.command_lit_loop, "lit-loop"),
         description="Start a Litwork run or operate its bounded lifecycle",
         args_hint='"task" [--completion-promise TEXT] [--strategy reset|continue] | init <plan> --grant ACTION@ROOT[,ACTION@ROOT] [--worktree PATH] | status <work-id> [--worktree PATH] | resume <work-id> --revision N --boundary ID --grant ACTION@ROOT [--worktree PATH] | cancel|complete <work-id> --revision N [--worktree PATH]',
     )
     ctx.register_command(
         "litwork-loop",
-        _ignited(core.command_lit_loop, "lit-loop"),
+        _command_handler(ctx, core.command_lit_loop, "lit-loop"),
         description="Alias for /lit-loop",
         args_hint='"task"',
     )
     ctx.register_command(
         "litgoal",
-        _ignited(core.command_litgoal, "litgoal"),
+        _command_handler(ctx, core.command_litgoal, "litgoal"),
         description="Open or inspect the LitHermes litgoal durable runtime",
         args_hint='["objective"] [--worktree PATH]',
     )
     ctx.register_command(
         "review-work",
-        _ignited(core.command_review_work, "review-work"),
+        _command_handler(ctx, core.command_review_work, "review-work"),
         description="Run the LitHermes 5-lane review orchestrator on the current diff",
         args_hint="[--base REF]",
     )
     ctx.register_command(
         "start-work",
-        _ignited(core.command_start_work, "start-work"),
+        _command_handler(ctx, core.command_start_work, "start-work"),
         description="Open or dry-run a LitHermes plan against a workspace",
         args_hint="[plan-name] [--worktree PATH] [--dry-run]",
     )
     ctx.register_command(
         "deep-interview",
-        _ignited(core.command_deep_interview, "deep-interview"),
+        _command_handler(ctx, core.command_deep_interview, "deep-interview"),
         description="Run the LitHermes Socratic clarity gate before planning/execution",
         args_hint="[--quick|--standard|--deep] <idea>",
     )
     ctx.register_command(
         "lit-recap",
-        _ignited(core.command_lit_recap, "lit-recap"),
+        _command_handler(ctx, core.command_lit_recap, "lit-recap"),
         description="Read-only Korean recap of finalized work (side-effect-free)",
         args_hint="[--brief] [--en] [--worktree PATH]",
     )
     ctx.register_command(
         "lit-handoff",
-        handoff.command_lit_handoff,
+        _command_handler(ctx, handoff.command_lit_handoff),
         description="Create or update a verified LitHermes continuation handoff",
         args_hint="[focus]",
     )
     ctx.register_command(
         "lit-scientific-visualization",
-        scientific_visualization.command_lit_scientific_visualization,
+        _command_handler(ctx, scientific_visualization.command_lit_scientific_visualization),
         description="Create a publication-quality scientific figure with the bundled source",
         args_hint="[figure request or dataset paths]",
     )
     for name in core.KOREAN_PROSE_COMMANDS:
         ctx.register_command(
             name,
-            _ignited(core.command_korean_prose_cleanup, "lit-korean"),
+            _command_handler(ctx, core.command_korean_prose_cleanup, "lit-korean"),
             description="Side-effect-free Korean prose cleanup and naturalization",
             args_hint="[Korean text]",
         )
@@ -576,7 +696,7 @@ def register(ctx) -> None:
 
     ctx.register_command(
         "korean-ai-slop-remover",
-        _ignited(korean_rename_redirect, "lit-korean"),
+        _command_handler(ctx, korean_rename_redirect, "lit-korean"),
         description="Redirect to /lit-korean for this release; removed in the next minor",
         args_hint="[Korean text]",
     )

package/assets/lithermes-plugin/diagnostics.py

@@ -26,6 +26,7 @@ HOOKS = (
     "on_session_start",
     "pre_llm_call",
     "pre_tool_call",
+    "pre_command",
     "post_tool_call",
     "post_api_request",
     "subagent_stop",

package/assets/lithermes-plugin/payload-version.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-09-13T22:21:44.664Z",
+  "syncedAt": "2026-09-17T12:28:42.389Z",
   "source": "bundled-payload",
-  "sourceHash": "98a99fa2936eba6e66e1a4c8eb1b8b02fe4b1668bc084179c756f10a8a253431",
+  "sourceHash": "20ca6086bec7f31f2f1bda43b4f99ec34d95fbc81fcdec9d98815897a69099bc",
   "files": [
     {
       "path": "NOTICE.md",
@@ -13,7 +13,7 @@
     },
     {
       "path": "__init__.py",
-      "sha256": "8bf962b44c8ccc19f5edc203eb9c91ad68565edeef2911e27c25c68d810e78fb"
+      "sha256": "1cd11adf3eb20516e4891840db188324c3065e634b06007f36a9137485403c7a"
     },
     {
       "path": "auto_update.py",
@@ -85,7 +85,7 @@
     },
     {
       "path": "diagnostics.py",
-      "sha256": "ff9ca32366be865f8f50724776016d5de855e31826b838fbddd0adf3d59bd13a"
+      "sha256": "5ee1242f357dc164a6ab663baf3d658a13d53f437240e33b8bb1c5cffa4d9ed2"
     },
     {
       "path": "handoff.py",
@@ -157,7 +157,7 @@
     },
     {
       "path": "plugin.yaml",
-      "sha256": "5183a4cf5c0e41727dbb369b9ae522e7603d4076e907a319bdfa5b17d679b083"
+      "sha256": "4af3d8b0f4ca8c613bba087fbf5d70400097f7bae73b0bc7936f077c88bb66ec"
     },
     {
       "path": "provider_metrics.py",
@@ -1253,7 +1253,7 @@
     },
     {
       "path": "skills/frontend-ui-ux/references/complete-contract.md",
-      "sha256": "4284c4a1b45ea8e38fe63570f83312816fb0c105d15128db214413add32eab4b"
+      "sha256": "2728e0114c749ef101018ee217adf338e7a01030b2865fdec33946b0155b9e2d"
     },
     {
       "path": "skills/frontend-ui-ux/references/composition.md",
@@ -1893,7 +1893,7 @@
     },
     {
       "path": "skills/visual-qa/references/complete-contract.md",
-      "sha256": "9ae56774c7e1d291fe4df46277b87b8ac0a2cba610284856da050dd807fd7f17"
+      "sha256": "7858afb13f0e877e82e94039d290d8afd3bf938337cb3260364a12a6e1028924"
     },
     {
       "path": "skills/visual-qa/schemas/evidence-manifest-v1alpha1.schema.json",

package/assets/lithermes-plugin/plugin.yaml

@@ -1,5 +1,5 @@
 name: lithermes
-version: 1.0.0
+version: 1.0.1
 description: "Hermes-native workflow toolkit: litgoal durable runtime, 5-lane review orchestrator, Litwork commands, skills, and prompt steering."
 author: "Hermes Agent"
 kind: standalone
@@ -8,6 +8,7 @@ hooks:
   - on_session_start
   - pre_llm_call
   - pre_tool_call
+  - pre_command
   - post_tool_call
   - post_api_request
   - subagent_stop

package/assets/lithermes-plugin/skills/frontend-ui-ux/references/complete-contract.md

@@ -420,7 +420,7 @@ isolated Hermes home. Use `--hermes-home`; never `--home`.
 
 ```text
 $ node packages/lithermes-installer/bin/lithermes.js install --yes --offline --no-hud --hermes-home "$ISOLATED"
-Installed LitHermes 1.0.0
+Installed LitHermes 1.0.1
 plugin: $ISOLATED/plugins/lithermes
 model config: updated
 
@@ -437,7 +437,7 @@ installed payload: PASS
 enabled config: PASS
 
 $ hermes lithermes doctor
-[OK] plugin.yaml readable (version 1.0.0)
+[OK] plugin.yaml readable (version 1.0.1)
 [OK] skills bundled: 32
 [OK] litgoal durable runtime importable
 ```

package/assets/lithermes-plugin/skills/visual-qa/references/complete-contract.md

@@ -485,7 +485,7 @@ isolated Hermes home. Use `--hermes-home`; never `--home`.
 
 ```text
 $ node packages/lithermes-installer/bin/lithermes.js install --yes --offline --no-hud --hermes-home "$ISOLATED"
-Installed LitHermes 1.0.0
+Installed LitHermes 1.0.1
 plugin: $ISOLATED/plugins/lithermes
 model config: updated
 
@@ -502,7 +502,7 @@ installed payload: PASS
 enabled config: PASS
 
 $ hermes lithermes doctor
-[OK] plugin.yaml readable (version 1.0.0)
+[OK] plugin.yaml readable (version 1.0.1)
 [OK] skills bundled: 32
 [OK] litgoal durable runtime importable
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/lithermes",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "npx/bunx installer for the LitHermes Hermes plugin",
   "license": "MIT",
   "repository": {

package/readme-assets/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.0"><title>release: 1.0.0</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.0</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.1"><title>release: 1.0.1</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.1</text></g></svg>

package/src/lib/check.js

@@ -27,8 +27,25 @@ function scanPluginCommands(pluginPath) {
   return requiredCommands.filter((cmd) => source.includes(`"${cmd}"`) || source.includes(`'${cmd}'`));
 }
 
+function nativePluginInjectionAvailable(repo) {
+  if (!repo) return false;
+  const file = path.join(repo, "hermes_cli", "plugins.py");
+  if (!fs.existsSync(file)) return false;
+  const source = fs.readFileSync(file, "utf8");
+  return source.includes("def inject_message(")
+    && source.includes("session_key")
+    && source.includes("allow_gateway_injection");
+}
+
 function checkGatewaySource(repo) {
   if (!repo) return { ok: true, skipped: true };
+  if (nativePluginInjectionAvailable(repo)) {
+    return {
+      ok: true,
+      native: true,
+      reason: "Hermes PluginContext.inject_message handles native gateway dispatch",
+    };
+  }
   const file = path.join(repo, "gateway", "run.py");
   if (!fs.existsSync(file)) return { ok: false, reason: "gateway/run.py missing" };
   const source = fs.readFileSync(file, "utf8");
@@ -40,6 +57,13 @@ function checkGatewaySource(repo) {
 
 function checkCliSource(repo) {
   if (!repo) return { ok: true, skipped: true };
+  if (nativePluginInjectionAvailable(repo)) {
+    return {
+      ok: true,
+      native: true,
+      reason: "Hermes PluginContext.inject_message handles native CLI turns",
+    };
+  }
   const file = path.join(repo, "cli.py");
   if (!fs.existsSync(file)) return { ok: false, reason: "cli.py missing" };
   const source = fs.readFileSync(file, "utf8");
@@ -60,6 +84,12 @@ function checkTuiSource(repo) {
   };
 }
 
+function formatDispatchStatus(result) {
+  if (result.skipped) return "SKIPPED";
+  if (result.native) return "PASS (native PluginContext.inject_message)";
+  return "PASS";
+}
+
 function enabledUserJsonIncludesPlugin(output, pluginName) {
   try {
     const entries = JSON.parse(String(output));
@@ -95,7 +125,9 @@ function checkLitHermes(flags = {}) {
   if (flags["gateway-offline"]) {
     const gateway = checkGatewaySource(hermesRepo);
     if (!gateway.ok && !gateway.skipped) throw new LitHermesError(`gateway check FAIL: ${gateway.reason}`, 7);
-    const status = gateway.skipped ? "SKIPPED (no Hermes repo provided)" : "PASS";
+    const status = gateway.skipped
+      ? "SKIPPED (no Hermes repo provided)"
+      : formatDispatchStatus(gateway);
     lines.push(`gateway /lit_loop ${status}`);
     lines.push(`gateway /lit_plan ${status}`);
   }
@@ -172,9 +204,9 @@ function doctorLitHermes(flags = {}) {
     `model route safety: ${modelSafety.status}${modelSafety.code ? ` (${modelSafety.code}; ${modelSafety.reason})` : ` (${modelSafety.reason})`}`,
     `runtime: ${runtime.status}${runtime.status === "hard" ? ` (${runtime.provider} ${runtime.apiMode})` : ` (${runtime.reason})`}`,
     `global child route: ${formatManagedRoute(delegationRoute)}`,
-    `cli payload dispatch: ${cli.ok ? (cli.skipped ? "SKIPPED" : "PASS") : "PATCH_AVAILABLE"}`,
-    `tui payload dispatch: ${tui.ok ? (tui.skipped ? "SKIPPED" : "PASS") : "PATCH_AVAILABLE"}`,
-    `gateway underscore dispatch: ${gateway.ok ? (gateway.skipped ? "SKIPPED" : "PASS") : "PATCH_AVAILABLE"}`,
+    `cli payload dispatch: ${cli.ok ? formatDispatchStatus(cli) : "PATCH_AVAILABLE"}`,
+    `tui payload dispatch: ${tui.ok ? formatDispatchStatus(tui) : "PATCH_AVAILABLE"}`,
+    `gateway underscore dispatch: ${gateway.ok ? formatDispatchStatus(gateway) : "PATCH_AVAILABLE"}`,
   ];
 	return {
 		message: lines.join("\n"),
@@ -195,6 +227,7 @@ module.exports = {
   loadedStatusMatchesOrigin,
   requiredCommands,
   requiredSkills,
+  nativePluginInjectionAvailable,
   scanPluginCommands,
   scanPluginSkills,
 };

package/src/lib/hermesDiscovery.js

@@ -65,22 +65,43 @@ function detectHermesRuntimeRepo() {
   }
 }
 
+function readIfExists(filePath) {
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+// Hermes 0.21.0 split tools/delegate_tool.py: the concurrency knob and delegation-route
+// helpers moved into tools/delegate_tool_config.py, and hermes_cli/runtime_provider.py
+// moved from an if/elif chain to a _POOL_ENTRY_SIMPLE_MODES data table. Both layouts are
+// checked so a 0.21.0 host is not misreported as lacking capabilities it genuinely has.
 function inspectHermesHostCapabilities(hermesRepo) {
   const unavailable = { concurrencyHard: false, delegationRouteHard: false, runtimeHard: false };
   if (!hermesRepo) return unavailable;
   try {
-    const delegation = fs.readFileSync(path.join(hermesRepo, "tools", "delegate_tool.py"), "utf8");
+    const legacyDelegation = readIfExists(path.join(hermesRepo, "tools", "delegate_tool.py"));
+    const configDelegation = readIfExists(path.join(hermesRepo, "tools", "delegate_tool_config.py"));
+    if (!legacyDelegation && !configDelegation) return unavailable;
+    const delegation = `${legacyDelegation}\n${configDelegation}`;
     const runtime = fs.readFileSync(path.join(hermesRepo, "hermes_cli", "runtime_provider.py"), "utf8");
     const runtimeStem = ["co", "dex"].join("");
     return {
       concurrencyHard: delegation.includes("_get_max_concurrent_children")
-        && delegation.includes('cfg.get("max_concurrent_children")')
-        && delegation.includes("max(1, int(val))"),
-      delegationRouteHard: delegation.includes('configured_model = str(cfg.get("model")')
-        && delegation.includes('delegation_cfg.get("reasoning_effort")')
-        && delegation.includes("effective_model = model or parent_agent.model"),
-      runtimeHard: runtime.includes(`provider == "openai-${runtimeStem}"`)
-        && runtime.includes(`api_mode = "${runtimeStem}_responses"`),
+        && ((delegation.includes('cfg.get("max_concurrent_children")') && delegation.includes("max(1, int(val))"))
+          || (delegation.includes('"max_concurrent_children", "DELEGATION_MAX_CONCURRENT_CHILDREN"')
+            && delegation.includes("max(1, int(v))"))),
+      // The config-level model override moved from a single `configured_model` line
+      // (0.17/0.19) into a per-key dict comprehension in _resolve_delegation_credentials
+      // (0.21.0); both read the same cfg.get("model") value.
+      delegationRouteHard: delegation.includes('delegation_cfg.get("reasoning_effort")')
+        && delegation.includes("effective_model = model or parent_agent.model")
+        && (delegation.includes('configured_model = str(cfg.get("model")')
+          || delegation.includes('str(cfg.get(k) or "").strip() or None for k in ("model"')),
+      runtimeHard: (runtime.includes(`provider == "openai-${runtimeStem}"`)
+          && runtime.includes(`api_mode = "${runtimeStem}_responses"`))
+        || runtime.includes(`"openai-${runtimeStem}": ("${runtimeStem}_responses"`),
     };
   } catch {
     return unavailable;

package/src/lib/install.js

@@ -14,6 +14,7 @@ const {
 } = require("./config");
 const { copyTree, removeEmptyDirs, sha256, writeFileAtomic } = require("./files");
 const { assertStateParent, assertPluginParent, defaultHermesHome, defaultHermesRepo, detectHermesRuntimeRepo, detectHermesVersion, ensureHermesHome, inspectHermesHostCapabilities, LitHermesError } = require("./hermesDiscovery");
+const { NOT_PROBED_HOST_VERSION } = require("./modelConfigBoundary");
 const { patchInstalledHermes, rollbackPatches } = require("./patch");
 const {
   formatManagedRoute,
@@ -333,7 +334,7 @@ function installLitHermes(flags = {}) {
   const modelPlan = planModelConfig(beforeConfig, {
     ...routeOptions(flags),
     hostCapabilities: inspectHermesHostCapabilities(capabilityRepo),
-    hostVersion: dryRun ? "" : detectHermesVersion(),
+    hostVersion: dryRun ? NOT_PROBED_HOST_VERSION : detectHermesVersion(),
     reconfigure: Boolean(flags["reconfigure-model"]),
   });
   if (modelPlan.action === "stop") {
@@ -499,7 +500,13 @@ function installLitHermes(flags = {}) {
       ] : []),
       ...capabilityLines({ capabilities: effectiveCapabilities }),
     ];
-    if (patchResult) lines.push(`patches: ${patchResult.changed.length ? patchResult.changed.join(", ") : "none needed"}`);
+    if (patchResult) {
+      lines.push(
+        patchResult.native
+          ? "patches: native PluginContext.inject_message dispatch (no source patch)"
+          : `patches: ${patchResult.changed.length ? patchResult.changed.join(", ") : "none needed"}`,
+      );
+    }
     if (patchWarning) lines.push(`patches: skipped (${patchWarning})`);
     const credentialWarning = modelPlan.request && effectiveModelAction === "write"
       ? missingCredentialWarning(modelPlan.request, process.env)

package/src/lib/modelConfigBoundary.js

@@ -12,6 +12,10 @@ const VERIFIED_HOST_VERSION_TEXT = [...VERIFIED_HOST_VERSIONS].join(", ");
 // Below this the managed schema did not exist, so forward compatibility must not become
 // backward acceptance.
 const MINIMUM_HOST_VERSION = "0.17.0";
+// Sentinel `hostVersion` for a dry-run, which deliberately never executes the Hermes
+// binary. Distinguishes "never probed" from a real host whose banner came back empty or
+// malformed, which must still be reported as unsupported.
+const NOT_PROBED_HOST_VERSION = "__lithermes_dry_run_not_probed__";
 const CONFIG_VERSION = 30;
 const CREDENTIAL_KEY = /(^|[_-])(api[_-]?key|client[_-]?secret|auth[_-]?token|(?:aws[_-]?)?access[_-]?key(?:[_-]?id)?|(?:ssh[_-]?)?private[_-]?key|token|password|passphrase|secret|credential|authorization)([_-]|$)/i;
 const MAP_PATHS = ["model", "agent", "delegation", "compression"];
@@ -111,6 +115,7 @@ function compareVersions(left, right) {
  * this matrix has seen it.
  */
 function classifyHostVersion(raw) {
+  if (raw === NOT_PROBED_HOST_VERSION) return { version: "", status: "not-probed" };
   const version = exactHostVersion(raw);
   // A release is exactly major.minor.patch. Four-part builds such as 0.19.0.1 are not a
   // published release line and were rejected before this gate accepted unseen versions.
@@ -121,6 +126,9 @@ function classifyHostVersion(raw) {
 }
 
 function hostVersionError(classified) {
+  if (classified.status === "not-probed") {
+    return "Hermes host version not probed (dry-run); re-run without --dry-run to detect the host and its capabilities";
+  }
   if (classified.status === "malformed") {
     return `unsupported Hermes host version; expected a release banner at or above ${MINIMUM_HOST_VERSION} (verified: ${VERIFIED_HOST_VERSION_TEXT})`;
   }
@@ -197,6 +205,7 @@ function parseBoundary(text, options = {}) {
 
 module.exports = {
   MINIMUM_HOST_VERSION,
+  NOT_PROBED_HOST_VERSION,
   OPENAI_PROVIDER,
   RESPONSES_MODE,
   classifyHostVersion,

package/src/lib/patch.js

@@ -7,6 +7,15 @@ function patchManifestPath(hermesHome) {
   return path.join(hermesHome, "lithermes", "patch-manifest.json");
 }
 
+function nativePluginInjectionAvailable(repo) {
+  const file = path.join(repo, "hermes_cli", "plugins.py");
+  if (!fs.existsSync(file)) return false;
+  const source = fs.readFileSync(file, "utf8");
+  return source.includes("def inject_message(")
+    && source.includes("session_key")
+    && source.includes("allow_gateway_injection");
+}
+
 function patchTarget(repo, relative, marker, additions) {
   const file = path.join(repo, relative);
   if (!fs.existsSync(file)) {
@@ -95,6 +104,28 @@ function patchInstalledHermes({ hermesHome, hermesRepo }) {
   if (!hermesRepo || !fs.existsSync(hermesRepo)) {
     throw new LitHermesError("Cannot patch Hermes because --hermes-repo was not found. Pass --hermes-repo PATH or run doctor first.", 8);
   }
+  if (nativePluginInjectionAvailable(hermesRepo)) {
+    fs.mkdirSync(path.dirname(patchManifestPath(hermesHome)), { recursive: true });
+    writeFileAtomic(
+      patchManifestPath(hermesHome),
+      JSON.stringify({
+        patchedAt: new Date().toISOString(),
+        nativeDispatch: {
+          cli: true,
+          gateway: true,
+          reason: "Hermes PluginContext.inject_message is available",
+        },
+        records: [],
+      }, null, 2),
+      "utf8",
+    );
+    return {
+      changed: [],
+      records: [],
+      native: true,
+      reason: "Hermes PluginContext.inject_message is available",
+    };
+  }
   const changed = [];
   const records = [];
   const cli = patchCliPayloadDispatch(hermesRepo);
@@ -146,6 +177,7 @@ function rollbackPatches({ hermesHome }) {
 }
 
 module.exports = {
+  nativePluginInjectionAvailable,
   patchCliPayloadDispatch,
   patchInstalledHermes,
   patchManifestPath,