@litfamily/lithermes 1.0.13 → 1.0.15

package/assets/lithermes-plugin/core.py

@@ -76,6 +76,11 @@ try:
 except (ImportError, ModuleNotFoundError):
     import auto_update as _auto_update
 
+try:
+    from . import auto_handoff as _auto_handoff
+except (ImportError, ModuleNotFoundError):
+    import auto_handoff as _auto_handoff
+
 try:
     from . import output_styles as _output_styles
 except (ImportError, ModuleNotFoundError):
@@ -155,6 +160,10 @@ def post_api_request(**kwargs: Any) -> None:
     fields, but the measurement module intentionally ignores them.  Returning
     ``None`` preserves the observer-only hook contract.
     """
+    try:
+        _auto_handoff.post_api_request(**kwargs)
+    except Exception:  # noqa: BLE001 - the optional handoff reading never costs a model call
+        pass
     return _provider_metrics.post_api_request(**kwargs)
 
 
@@ -191,6 +200,7 @@ def on_session_start(**kwargs: Any) -> None:
     release_browser_drive_state(kwargs.get("session_id"))
     _deliverable_hedges.release_session(kwargs.get("session_id"))
     _rules.begin_session(str(kwargs.get("session_id") or ""))
+    _auto_handoff.begin_session(kwargs.get("session_id"))
     _print_agents_nudge(str(kwargs.get("platform") or ""))
     return None
 

package/assets/lithermes-plugin/diagnostics.py

@@ -26,6 +26,11 @@ try:
 except (ImportError, ModuleNotFoundError):
     import jev_hint as _jev_hint  # type: ignore
 
+try:
+    from . import auto_handoff as _auto_handoff
+except (ImportError, ModuleNotFoundError):
+    import auto_handoff as _auto_handoff  # type: ignore
+
 try:
     from .core_contract import KOREAN_PROSE_ALIASES, KOREAN_PROSE_COMMANDS
 except (ImportError, ModuleNotFoundError):
@@ -74,7 +79,8 @@ _RUNTIME_STEM = "".join(("co", "dex"))
 _OPENAI_PROVIDER = f"openai-{_RUNTIME_STEM}"
 _RESPONSES_MODE = f"{_RUNTIME_STEM}_responses"
 _ASTRA_MODEL = "gpt-6-astra"
-_SOL_MODEL = "gpt-6-sol"
+_SOL_MODEL = "gpt-6.1-sol"
+_PREVIOUS_SOL_MODEL = "gpt-6-sol"
 _LUNA_MODEL = "gpt-6-luna"
 _LEGACY_SOL_MODEL = "gpt-5.6-sol"
 _TERRA_MODEL = "gpt-5.6-terra"
@@ -89,6 +95,7 @@ _ASTRA_EFFORTS = _GPT6_LEAD_EFFORTS
 _OPENAI_CATALOG_EFFORTS = {
     _ASTRA_MODEL: _ASTRA_EFFORTS,
     _SOL_MODEL: _GPT6_LEAD_EFFORTS,
+    _PREVIOUS_SOL_MODEL: _GPT6_LEAD_EFFORTS,
     _LUNA_MODEL: _GPT6_LUNA_EFFORTS,
     _LEGACY_SOL_MODEL: _LEGACY_SOL_EFFORTS,
     _TERRA_MODEL: _TERRA_EFFORTS,
@@ -352,7 +359,7 @@ def _parse_capabilities(host_version: str) -> CapabilityResult:
     astra = (astra_parent or astra_child) and cataloged_parent and cataloged_child
     sol_lead = (
         provider == _OPENAI_PROVIDER
-        and model in (_SOL_MODEL, _LEGACY_SOL_MODEL)
+        and model in (_SOL_MODEL, _PREVIOUS_SOL_MODEL, _LEGACY_SOL_MODEL)
         and _cataloged_route(model, effort)
         and child_model in _LUNA_MODELS
         and _cataloged_route(child_model, child_effort)
@@ -483,6 +490,7 @@ def status_report(host_version: str | None = None) -> str:
         _knowledge.status_line(Path.cwd()),
         _provider_metrics.capability_line(),
         _jev_hint.status_line(),
+        _auto_handoff.status_line(),
         f"litgoal evidence kinds: {', '.join(_evidence_kinds())}",
         f"scientific visualization: {_science.dependency_summary()}",
         *_motion_runtime_lines(),
@@ -571,6 +579,8 @@ def doctor_report(host_version: str | None = None) -> tuple[list[str], int]:
     jev_state = _jev_hint.status()
     jev_tag = {"on": "OK", "off": "NOTE"}.get(jev_state, "WARN")
     lines.append(f"[{jev_tag}] {_jev_hint.status_line()}")
+    handoff_tag, handoff_text = _auto_handoff.doctor_line()
+    lines.append(f"[{handoff_tag}] {handoff_text}")
     if version != "unknown":
         lines.append(f"[OK] Hermes host detected (v{version})")
     else:

package/assets/lithermes-plugin/handoff.py

@@ -1,11 +1,13 @@
 from __future__ import annotations
 
 import html
+import os
 import re
 from pathlib import Path
 from typing import Any
 
 try:
+    from . import auto_handoff
     from .core_contract import (
         reader_facing_contract_block,
         reader_facing_mode_from_user_request,
@@ -14,6 +16,7 @@ try:
     from .redaction import redact_text
     from .session_context import is_delegate_child_platform
 except (ImportError, ModuleNotFoundError):
+    import auto_handoff  # type: ignore
     from core_contract import (  # type: ignore
         reader_facing_contract_block,
         reader_facing_mode_from_user_request,
@@ -65,8 +68,16 @@ def _agent_message(raw_args: str) -> str:
     )
 
 
-def command_lit_handoff(raw_args: str) -> dict[str, str]:
-    """Build side-effect-free model context for the native slash command."""
+def command_lit_handoff(raw_args: str) -> dict[str, str] | str:
+    """Build model context for the native slash command.
+
+    ``auto on <percent> | off | status`` is the user's switch for the automatic
+    handoff; it answers in plain text and sends nothing to the model. Every
+    other argument is a focus for a normal handoff and stays side-effect-free.
+    """
+    switch = auto_handoff.parse_route(raw_args)
+    if switch is not None:
+        return auto_handoff.run_command(switch, session_id=os.environ.get(auto_handoff.SESSION_ENV, "").strip())
     return {
         "display": f"{acknowledgement('lit-handoff', color=True)}\nHandoff source loaded; inspect live state before writing.",
         "agent_message": _agent_message(raw_args),

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

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-09-29T15:21:29.113Z",
+  "syncedAt": "2026-09-30T13:06:01.009Z",
   "source": "bundled-payload",
-  "sourceHash": "552f6dd7aa356b13feb1509ca0cc045eab8be46c83d86d484e1c5a63da94e7ca",
+  "sourceHash": "92b298c9a38364d94b56fb497641d44835bb3bda3230338eb6a769647a5f61b5",
   "files": [
     {
       "path": "NOTICE.md",
@@ -9,11 +9,15 @@
     },
     {
       "path": "README.md",
-      "sha256": "1802ff4904f841e7da8db7ce0dbb4e8fd867ef1d94493e96dfb40091f7c74df8"
+      "sha256": "234ed5a80d74dec9953f5168b85f666de656b3511c23a74e26194748a4f3b766"
     },
     {
       "path": "__init__.py",
-      "sha256": "f5dc1b38aa13977312c8c773dcd8b31f9df878826f9210737d76f9d19dc9dcb1"
+      "sha256": "76cf72655600b82544e9047fab1f5f4030927803c0cfbc08fca311204f37d32c"
+    },
+    {
+      "path": "auto_handoff.py",
+      "sha256": "7c0e5385373cc83b202669a9ab500d46e04d79c5a188ed2ffdea93f863ec7dab"
     },
     {
       "path": "auto_update.py",
@@ -29,7 +33,7 @@
     },
     {
       "path": "core.py",
-      "sha256": "80a2b6706ddd8381c82a3748c9b25ff958af1023d182ed3a641ad0b734217aee"
+      "sha256": "32b7ef2c93e3f208e39e26a6eca4a03f48804b7ddf6b7a16eaf4cf038fbf4e21"
     },
     {
       "path": "core_commands.py",
@@ -85,11 +89,11 @@
     },
     {
       "path": "diagnostics.py",
-      "sha256": "07d7b9b2399475481a6c593761e0e34a8a94a3a17c86ebc55a2afbd4d51cfc9d"
+      "sha256": "bd797eadf291ec9cd6c02926595305532e235e21794e4467e157c03b0311fe54"
     },
     {
       "path": "handoff.py",
-      "sha256": "0e364d64981b84e50b437326c34965121928ef826e231d3822fbbfdb4009f6aa"
+      "sha256": "f34788ee4b56b6156e6503b546ea416fd886856df2c8f9e60006eb2b0289a027"
     },
     {
       "path": "humanizer_detector.py",
@@ -177,7 +181,7 @@
     },
     {
       "path": "plugin.yaml",
-      "sha256": "38db753fc650eadebd74928c31e39bc90ab4226bc417617ae133556a2ef4e3b8"
+      "sha256": "b086300c1f74bf85aca8be93bf6fdf9112e35536f050ff109456584952c1ec78"
     },
     {
       "path": "provider_metrics.py",
@@ -1281,7 +1285,7 @@
     },
     {
       "path": "skills/frontend-ui-ux/references/complete-contract.md",
-      "sha256": "1959f22c99c35ae6496f6609fb5a2bc0b8d872878fed0345f110e928292b7fe4"
+      "sha256": "a42439ee181e68b729f969e5b8243205566a64e6f212894f2284735f2737809c"
     },
     {
       "path": "skills/frontend-ui-ux/references/composition.md",
@@ -3157,7 +3161,7 @@
     },
     {
       "path": "skills/lit-handoff/SKILL.md",
-      "sha256": "c50767e13d4d062d2677d1d8b43891b2dfdb704b6ba557b427ffd6ddecfa8edd"
+      "sha256": "d49141a84537cfa5dc36be0adb72fc57fb6ab4af97c1a75e82b84b4fa5983dd6"
     },
     {
       "path": "skills/lit-humanizer/NOTICE",
@@ -4149,7 +4153,7 @@
     },
     {
       "path": "skills/visual-qa/references/complete-contract.md",
-      "sha256": "f51865082a9b60ee743c8e0844d23dcec7890d631ed2982d8142fc66f84a2749"
+      "sha256": "65b9754533bf3a07fc32d2e6a4b479d885e4bc7bcd25030c1dd36418db748eeb"
     },
     {
       "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.13
+version: 1.0.15
 description: "Hermes-native workflow toolkit: litgoal durable runtime, 5-lane review orchestrator, Litwork commands, skills, and prompt steering."
 author: "LitHermes contributors"
 kind: standalone

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

@@ -445,7 +445,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.13
+Installed LitHermes 1.0.15
 plugin: $ISOLATED/plugins/lithermes
 model config: updated
 
@@ -462,7 +462,7 @@ installed payload: PASS
 enabled config: PASS
 
 $ hermes lithermes doctor
-[OK] plugin.yaml readable (version 1.0.13)
+[OK] plugin.yaml readable (version 1.0.15)
 [OK] skills bundled: 36
 [OK] litgoal durable runtime importable
 ```

package/assets/lithermes-plugin/skills/lit-handoff/SKILL.md

@@ -62,6 +62,7 @@ on its own, before any other reply content:
 | direct skill | explicit `lithermes:lit-handoff` | Read this adapter and then the original source in full. | Do not invent state that was not inspected. |
 | slash command | `/lit-handoff [focus]` | Inject the exact source plus a redacted focus as inert data. | The command handler itself must not write workspace files. |
 | exact natural route | the complete user message is `handoff` | Use the same source and named banner exactly once for that turn. | Near-misses, code spans, paths, and child-agent messages must not activate. |
+| automatic handoff | the user switched it on with `/lit-handoff auto on <percent>` or `LITHERMES_AUTO_HANDOFF=1` plus `LITHERMES_AUTO_HANDOFF_PERCENT`, and a model call passed that percent | `auto_handoff.py` adds one `<lithermes-auto-handoff>` block to the next turn. Follow the original source, put the `auto-handoff-id:` line from the block near the top of the file, and tell the user the one plain line the block names. | Off by default, no built-in percent, one directive per crossing, delegate children never receive it. After a compaction the next turn gets a bounded digest, and only a file that carries this session's id and was written after the block is loaded. |
 
 ## #contract.procedure
 
@@ -138,6 +139,12 @@ limitations_channel: inline
 
 # Hermes Adapter Notes
 
+`auto_handoff.py` owns the switch and the automatic path: `/lit-handoff auto on
+<percent>`, `auto off` and `auto status` answer in plain text without a model
+call, and `status` and `doctor` print an `Automatic handoff` line. A plugin
+cannot start compaction on Hermes, so the user runs the compact command, or
+Hermes compacts on its own threshold.
+
 `handoff.py` resolves the installed source root at runtime, reads the source
 without rewriting it, and injects it as authoritative bundled guidance. The
 slash command and exact natural route are side-effect-free until the model has

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.13
+Installed LitHermes 1.0.15
 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.13)
+[OK] plugin.yaml readable (version 1.0.15)
 [OK] skills bundled: 36
 [OK] litgoal durable runtime importable
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/lithermes",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "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.13"><title>release: 1.0.13</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.13</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.15"><title>release: 1.0.15</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.15</text></g></svg>

package/src/lib/modelRoutePolicy.js

@@ -3,7 +3,8 @@ const GPT6_LEAD_EFFORTS = new Set(["low", "medium", "high", "xhigh", "max", "ult
 const ASTRA_EFFORTS = GPT6_LEAD_EFFORTS;
 const PARENT_MODEL = ASTRA_MODEL;
 const PARENT_EFFORT = "xhigh";
-const SOL_MODEL = "gpt-6-sol";
+const SOL_MODEL = "gpt-6.1-sol";
+const PREVIOUS_SOL_MODEL = "gpt-6-sol";
 const CHILD_MODEL = "gpt-6-luna";
 const LEGACY_SOL_MODEL = "gpt-5.6-sol";
 const LEGACY_CHILD_MODEL = "gpt-5.6-luna";
@@ -18,6 +19,7 @@ const LEGACY_SOL_EFFORTS = new Set(["high", "xhigh"]);
 const MODEL_EFFORTS = new Map([
   [ASTRA_MODEL, GPT6_LEAD_EFFORTS],
   [SOL_MODEL, GPT6_LEAD_EFFORTS],
+  [PREVIOUS_SOL_MODEL, GPT6_LEAD_EFFORTS],
   [CHILD_MODEL, GPT6_LUNA_EFFORTS],
   [LEGACY_SOL_MODEL, LEGACY_SOL_EFFORTS],
   [LEGACY_CHILD_MODEL, LEGACY_LUNA_EFFORTS],
@@ -51,6 +53,11 @@ const ROUTE_CATALOG = {
         model: SOL_MODEL,
         note: effort === PARENT_EFFORT ? "coding lead alternative" : "Sol Responses effort",
       })),
+      ...["low", "medium", "high", "xhigh", "max", "ultra"].map((effort) => ({
+        effort,
+        model: PREVIOUS_SOL_MODEL,
+        note: "previous-generation Sol lead route",
+      })),
       ...["low", "medium", "high", "xhigh", "max"].map((effort) => ({
         effort,
         model: CHILD_MODEL,
@@ -403,6 +410,7 @@ module.exports = {
   MANAGED_PROVIDER_MODELS,
   MODEL_IDS,
   OPENAI_PROVIDER_ID,
+  PREVIOUS_SOL_MODEL,
   SOL_MODEL,
   PROVIDER_IDS,
   ROUTE_CATALOG,