@fideliosai/adapter-hermes-local 0.0.38 → 0.0.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fideliosai/adapter-hermes-local",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "license": "MIT",
   "description": "Hermes AI agent adapter for FideliOS",
   "homepage": "https://github.com/fideliosai/fidelios",
@@ -23,7 +23,7 @@
     "src"
   ],
   "dependencies": {
-    "@fideliosai/adapter-utils": "0.0.38",
+    "@fideliosai/adapter-utils": "0.0.40",
     "picocolors": "^1.1.0"
   }
 }

package/src/server/execute.js

@@ -298,13 +298,32 @@ export async function execute(ctx) {
     };
     if (ctx.runId)
         env.FIDELIOS_RUN_ID = ctx.runId;
-    const taskId = cfgString(ctx.config?.taskId);
+    const taskId = cfgString(ctx.context?.taskId) || cfgString(ctx.context?.issueId) || cfgString(ctx.config?.taskId);
     if (taskId)
         env.FIDELIOS_TASK_ID = taskId;
+    const wakeReason = cfgString(ctx.context?.wakeReason);
+    if (wakeReason)
+        env.FIDELIOS_WAKE_REASON = wakeReason;
+    const wakeCommentId = cfgString(ctx.context?.wakeCommentId) || cfgString(ctx.context?.commentId);
+    if (wakeCommentId)
+        env.FIDELIOS_WAKE_COMMENT_ID = wakeCommentId;
+    const approvalId = cfgString(ctx.context?.approvalId);
+    if (approvalId)
+        env.FIDELIOS_APPROVAL_ID = approvalId;
+    const approvalStatus = cfgString(ctx.context?.approvalStatus);
+    if (approvalStatus)
+        env.FIDELIOS_APPROVAL_STATUS = approvalStatus;
+    const linkedIssueIds = cfgString(ctx.context?.linkedIssueIds);
+    if (linkedIssueIds)
+        env.FIDELIOS_LINKED_ISSUE_IDS = linkedIssueIds;
     const userEnv = config.env;
+    const hasExplicitApiKey = typeof userEnv?.FIDELIOS_API_KEY === "string" && userEnv.FIDELIOS_API_KEY.trim().length > 0;
     if (userEnv && typeof userEnv === "object") {
         Object.assign(env, userEnv);
     }
+    if (!hasExplicitApiKey && ctx.authToken) {
+        env.FIDELIOS_API_KEY = ctx.authToken;
+    }
     // ── Resolve working directory ──────────────────────────────────────────
     const cwd = cfgString(config.cwd) || cfgString(ctx.config?.workspaceDir) || ".";
     try {

package/src/server/index.d.ts

@@ -2,7 +2,7 @@
  * Server-side adapter module exports.
  */
 export { execute } from "./execute.js";
-export { testEnvironment } from "./test.js";
+export { testEnvironment, isHermesAuthRequiredText } from "./test.js";
 export { detectModel } from "./detect-model.js";
 export { listHermesSkills as listSkills, syncHermesSkills as syncSkills, resolveHermesDesiredSkillNames as resolveDesiredSkillNames, } from "./skills.js";
 import type { AdapterSessionCodec } from "@fideliosai/adapter-utils";

package/src/server/index.js

@@ -2,7 +2,7 @@
  * Server-side adapter module exports.
  */
 export { execute } from "./execute.js";
-export { testEnvironment } from "./test.js";
+export { testEnvironment, isHermesAuthRequiredText } from "./test.js";
 export { detectModel } from "./detect-model.js";
 export { listHermesSkills as listSkills, syncHermesSkills as syncSkills, resolveHermesDesiredSkillNames as resolveDesiredSkillNames, } from "./skills.js";
 function readNonEmptyString(value) {

package/src/server/test.d.ts

@@ -6,4 +6,5 @@
  */
 import type { AdapterEnvironmentTestContext, AdapterEnvironmentTestResult } from "@fideliosai/adapter-utils";
 export declare function testEnvironment(ctx: AdapterEnvironmentTestContext): Promise<AdapterEnvironmentTestResult>;
+export declare function isHermesAuthRequiredText(text: unknown): boolean;
 //# sourceMappingURL=test.d.ts.map

package/src/server/test.js

@@ -4,6 +4,7 @@
  * Verifies that Hermes Agent is installed, accessible, and configured
  * before allowing the adapter to be used.
  */
+import path from "node:path";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { HERMES_CLI, ADAPTER_TYPE } from "../shared/constants.js";
@@ -11,6 +12,28 @@ const execFileAsync = promisify(execFile);
 function asString(v) {
     return typeof v === "string" ? v : undefined;
 }
+// Mirrors the patterns used by codex/opencode/pi adapters; matches the most
+// common auth-failure substrings emitted by upstream LLM providers when a key
+// is missing/invalid or Hermes itself isn't logged in.
+const HERMES_AUTH_REQUIRED_RE = /(?:auth(?:entication)?\s+required|invalid(?:\s+or\s+missing)?\s+api(?:[_\s-]?key)?|api[_\s-]?key.*required|not\s+logged\s+in|please\s+log\s+in|unauthorized|401\s+unauthorized|insufficient_quota|free\s+usage\s+exceeded|please\s+run\s+`?hermes\s+(?:login|auth)`?)/i;
+export function isHermesAuthRequiredText(text) {
+    return typeof text === "string" && HERMES_AUTH_REQUIRED_RE.test(text);
+}
+function commandLooksLikeHermes(command) {
+    const base = path.basename(command).toLowerCase();
+    return base === "hermes" || base === "hermes.cmd" || base === "hermes.exe";
+}
+function summarizeProbeDetail(stdout, stderr) {
+    const firstLine = (text) => text
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .find(Boolean) ?? "";
+    const raw = firstLine(stderr) || firstLine(stdout);
+    if (!raw)
+        return null;
+    const clean = raw.replace(/\s+/g, " ").trim();
+    return clean.length > 240 ? `${clean.slice(0, 239)}…` : clean;
+}
 // ---------------------------------------------------------------------------
 // Checks
 // ---------------------------------------------------------------------------
@@ -147,6 +170,96 @@ function checkApiKeys(config) {
         code: "hermes_api_keys_found",
     };
 }
+async function checkHelloProbe(command, config, hasAnyApiKey) {
+    if (!commandLooksLikeHermes(command)) {
+        return {
+            level: "info",
+            message: "Skipped hello probe because command is not `hermes`.",
+            hint: "Use the `hermes` CLI command to enable the automatic auth probe.",
+            code: "hermes_hello_probe_skipped_custom_command",
+        };
+    }
+    const model = asString(config.model);
+    if (!model && !hasAnyApiKey) {
+        return {
+            level: "info",
+            message: "Skipped hello probe — no model and no provider API key configured.",
+            hint: "Set a model and at least one provider key (e.g. ANTHROPIC_API_KEY, OPENROUTER_API_KEY) to enable the probe.",
+            code: "hermes_hello_probe_skipped_no_config",
+        };
+    }
+    const envConfig = (config.env ?? {});
+    const env = { ...process.env };
+    for (const [k, v] of Object.entries(envConfig)) {
+        if (typeof v === "string")
+            env[k] = v;
+    }
+    const args = ["chat", "-q", "Respond with hello.", "-Q", "--yolo", "--source", "tool"];
+    if (model)
+        args.push("-m", model);
+    const provider = asString(config.provider);
+    if (provider)
+        args.push("--provider", provider);
+    try {
+        const { stdout, stderr } = await execFileAsync(command, args, {
+            timeout: 30_000,
+            env,
+            maxBuffer: 1024 * 1024,
+        });
+        const combined = `${stdout}\n${stderr}`;
+        if (HERMES_AUTH_REQUIRED_RE.test(combined)) {
+            return {
+                level: "warn",
+                message: "Hermes hello probe reported an auth/credential failure.",
+                detail: summarizeProbeDetail(stdout, stderr) ?? undefined,
+                hint: "Run `hermes auth status` and verify upstream provider credentials (ANTHROPIC_API_KEY, OPENROUTER_API_KEY, etc.).",
+                code: "hermes_hello_probe_auth_required",
+            };
+        }
+        const replied = /\bhello\b/i.test(stdout);
+        return {
+            level: replied ? "info" : "warn",
+            message: replied
+                ? "Hermes hello probe succeeded."
+                : "Hermes probe ran but did not return `hello` as expected.",
+            detail: summarizeProbeDetail(stdout, stderr) ?? undefined,
+            ...(replied
+                ? {}
+                : {
+                    hint: "Try `hermes chat -q 'Respond with hello.' -Q` manually to debug provider/model behavior.",
+                }),
+            code: replied ? "hermes_hello_probe_passed" : "hermes_hello_probe_unexpected_output",
+        };
+    }
+    catch (err) {
+        const e = err;
+        const text = `${e.stdout ?? ""}\n${e.stderr ?? ""}\n${e.message ?? ""}`;
+        if (e.killed || /etimedout|timeout/i.test(e.message ?? "")) {
+            return {
+                level: "warn",
+                message: "Hermes hello probe timed out.",
+                hint: "Retry the probe. If this persists, run `hermes chat -q 'ping' -Q` manually to verify the upstream provider responds.",
+                code: "hermes_hello_probe_timed_out",
+            };
+        }
+        if (HERMES_AUTH_REQUIRED_RE.test(text)) {
+            return {
+                level: "warn",
+                message: "Hermes hello probe reported an auth/credential failure.",
+                detail: summarizeProbeDetail(e.stdout ?? "", e.stderr ?? "") ?? undefined,
+                hint: "Run `hermes auth status` and verify upstream provider credentials.",
+                code: "hermes_hello_probe_auth_required",
+            };
+        }
+        return {
+            level: "error",
+            message: "Hermes hello probe failed.",
+            detail: summarizeProbeDetail(e.stdout ?? "", e.stderr ?? "") ?? e.message,
+            hint: "Run `hermes chat -q 'Respond with hello.' -Q` manually in this directory to debug.",
+            code: "hermes_hello_probe_failed",
+        };
+    }
+}
 // ---------------------------------------------------------------------------
 // Main test
 // ---------------------------------------------------------------------------
@@ -183,6 +296,13 @@ export async function testEnvironment(ctx) {
     const apiKeyCheck = checkApiKeys(config);
     if (apiKeyCheck)
         checks.push(apiKeyCheck);
+    // 6. Hello probe — actually exercise the configured model/provider.
+    //    Skipped when command is custom or when there's no model AND no provider key
+    //    (so we never spam an LLM with no way to authenticate).
+    const hasAnyApiKey = apiKeyCheck.code === "hermes_api_keys_found";
+    const probeCheck = await checkHelloProbe(command, config, hasAnyApiKey);
+    if (probeCheck)
+        checks.push(probeCheck);
     // Determine overall status
     const hasErrors = checks.some((c) => c.level === "error");
     const hasWarnings = checks.some((c) => c.level === "warn");