@litfamily/lithermes 1.0.0 → 1.0.2

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") {
@@ -459,6 +460,7 @@ function installLitHermes(flags = {}) {
     checkState();
     const manifest = {
       version: packageVersion,
+      distribution: "npm",
       installedAt: new Date().toISOString(),
       pluginPath: dest,
       configPath: path.join(hermesHome, "config.yaml"),
@@ -499,7 +501,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,