@fideliosai/adapter-hermes-local 0.0.4-canary.0

package/src/server/skills.js

@@ -0,0 +1,179 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { readFideliOSRuntimeSkillEntries, resolveFideliOSDesiredSkillNames, } from "@fideliosai/adapter-utils/server-utils";
+import { fileURLToPath } from "node:url";
+const __moduleDir = path.dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function asString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function resolveHermesHome(config) {
+    const env = typeof config.env === "object" && config.env !== null && !Array.isArray(config.env)
+        ? config.env
+        : {};
+    const configuredHome = asString(env.HOME);
+    return configuredHome ? path.resolve(configuredHome) : os.homedir();
+}
+function parseSkillFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const frontmatter = {};
+    for (const line of match[1].split("\n")) {
+        const idx = line.indexOf(":");
+        if (idx === -1)
+            continue;
+        const key = line.slice(0, idx).trim();
+        let val = line.slice(idx + 1).trim();
+        // Strip quotes
+        if (typeof val === "string" && ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'")))) {
+            val = val.slice(1, -1);
+        }
+        frontmatter[key] = val;
+    }
+    return frontmatter;
+}
+async function scanHermesSkills(skillsHome) {
+    const entries = [];
+    try {
+        const categories = await fs.readdir(skillsHome, { withFileTypes: true });
+        for (const cat of categories) {
+            if (!cat.isDirectory())
+                continue;
+            const catPath = path.join(skillsHome, cat.name);
+            // Check if the category directory itself has a SKILL.md (top-level skill)
+            const topLevelSkillMd = path.join(catPath, "SKILL.md");
+            if (await fs.stat(topLevelSkillMd).catch(() => null)) {
+                entries.push(await buildSkillEntry(cat.name, topLevelSkillMd, cat.name));
+            }
+            // Scan for sub-skills
+            const items = await fs.readdir(catPath, { withFileTypes: true }).catch(() => []);
+            for (const item of items) {
+                if (!item.isDirectory())
+                    continue;
+                const skillMd = path.join(catPath, item.name, "SKILL.md");
+                if (await fs.stat(skillMd).catch(() => null)) {
+                    const key = item.name;
+                    entries.push(await buildSkillEntry(key, skillMd, `${cat.name}/${item.name}`));
+                }
+            }
+        }
+    }
+    catch {
+        // ~/.hermes/skills/ doesn't exist — no skills available
+    }
+    return entries.sort((a, b) => a.key.localeCompare(b.key));
+}
+async function buildSkillEntry(key, skillMdPath, categoryPath) {
+    let description = null;
+    try {
+        const content = await fs.readFile(skillMdPath, "utf8");
+        const fm = parseSkillFrontmatter(content);
+        description = fm.description ?? null;
+    }
+    catch {
+        // ignore
+    }
+    return {
+        key,
+        runtimeName: key,
+        desired: true, // Hermes loads all available skills
+        managed: false,
+        state: "installed",
+        origin: "user_installed",
+        originLabel: "Hermes skill",
+        locationLabel: `~/.hermes/skills/${categoryPath}`,
+        readOnly: true, // Hermes manages its own skills — FideliOS can't toggle them
+        sourcePath: skillMdPath,
+        targetPath: null,
+        detail: description,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+async function buildHermesSkillSnapshot(config) {
+    const home = resolveHermesHome(config);
+    const hermesSkillsHome = path.join(home, ".hermes", "skills");
+    // 1. Scan FideliOS-managed skills (bundled with the adapter)
+    const fideliosEntries = await readFideliOSRuntimeSkillEntries(config, __moduleDir);
+    const desiredSkills = resolveFideliOSDesiredSkillNames(config, fideliosEntries);
+    const desiredSet = new Set(desiredSkills);
+    const availableByKey = new Map(fideliosEntries.map((e) => [e.key, e]));
+    // 2. Scan Hermes's own skills from ~/.hermes/skills/
+    const hermesSkillEntries = await scanHermesSkills(hermesSkillsHome);
+    const hermesKeys = new Set(hermesSkillEntries.map((e) => e.key));
+    // 3. Merge: FideliOS skills first (ephemeral), then Hermes skills
+    const entries = [];
+    const warnings = [];
+    // FideliOS-managed skills
+    for (const entry of fideliosEntries) {
+        const desired = desiredSet.has(entry.key);
+        entries.push({
+            key: entry.key,
+            runtimeName: entry.runtimeName,
+            desired,
+            managed: true,
+            state: desired ? "configured" : "available",
+            origin: entry.required ? "fidelios_required" : "company_managed",
+            originLabel: entry.required ? "Required by FideliOS" : "Managed by FideliOS",
+            readOnly: false,
+            sourcePath: entry.source,
+            targetPath: null,
+            detail: desired
+                ? "Will be available on the next run via Hermes skill loading."
+                : null,
+            required: Boolean(entry.required),
+            requiredReason: entry.requiredReason ?? null,
+        });
+    }
+    // Hermes-installed skills (read-only, always loaded)
+    for (const entry of hermesSkillEntries) {
+        // Skip if FideliOS already manages a skill with the same key
+        if (availableByKey.has(entry.key))
+            continue;
+        entries.push(entry);
+    }
+    // Check for desired skills that don't exist
+    for (const desiredSkill of desiredSkills) {
+        if (availableByKey.has(desiredSkill) || hermesKeys.has(desiredSkill))
+            continue;
+        warnings.push(`Desired skill "${desiredSkill}" is not available in FideliOS or Hermes skills.`);
+        entries.push({
+            key: desiredSkill,
+            runtimeName: null,
+            desired: true,
+            managed: true,
+            state: "missing",
+            origin: "external_unknown",
+            originLabel: "External or unavailable",
+            readOnly: false,
+            sourcePath: null,
+            targetPath: null,
+            detail: "Cannot find this skill in FideliOS or ~/.hermes/skills/.",
+        });
+    }
+    return {
+        adapterType: "hermes_local",
+        supported: true,
+        mode: "persistent",
+        desiredSkills,
+        entries,
+        warnings,
+    };
+}
+export async function listHermesSkills(ctx) {
+    return buildHermesSkillSnapshot(ctx.config);
+}
+export async function syncHermesSkills(ctx, _desiredSkills) {
+    // Hermes manages its own skill loading — sync is a no-op.
+    // Return the current snapshot so the UI stays in sync.
+    return buildHermesSkillSnapshot(ctx.config);
+}
+export function resolveHermesDesiredSkillNames(config, availableEntries) {
+    return resolveFideliOSDesiredSkillNames(config, availableEntries);
+}
+//# sourceMappingURL=skills.js.map

package/src/server/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/server/skills.ts"],"names":[],"mappings":"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"}

package/src/server/test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Environment test for the Hermes Agent adapter.
+ *
+ * Verifies that Hermes Agent is installed, accessible, and configured
+ * before allowing the adapter to be used.
+ */
+import type { AdapterEnvironmentTestContext, AdapterEnvironmentTestResult } from "@fideliosai/adapter-utils";
+export declare function testEnvironment(ctx: AdapterEnvironmentTestContext): Promise<AdapterEnvironmentTestResult>;
+//# sourceMappingURL=test.d.ts.map

package/src/server/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/server/test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAE7B,MAAM,4BAA4B,CAAC;AAsKpC,wBAAsB,eAAe,CACnC,GAAG,EAAE,6BAA6B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CA6CvC"}

package/src/server/test.js

@@ -0,0 +1,196 @@
+/**
+ * Environment test for the Hermes Agent adapter.
+ *
+ * Verifies that Hermes Agent is installed, accessible, and configured
+ * before allowing the adapter to be used.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { HERMES_CLI, ADAPTER_TYPE } from "../shared/constants.js";
+const execFileAsync = promisify(execFile);
+function asString(v) {
+    return typeof v === "string" ? v : undefined;
+}
+// ---------------------------------------------------------------------------
+// Checks
+// ---------------------------------------------------------------------------
+async function checkCliInstalled(command) {
+    try {
+        // Try to run the command to see if it exists
+        await execFileAsync(command, ["--version"], { timeout: 10_000 });
+        return null; // OK — it ran successfully
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            return {
+                level: "error",
+                message: `Hermes CLI "${command}" not found in PATH`,
+                hint: "Install Hermes Agent: pip install hermes-agent",
+                code: "hermes_cli_not_found",
+            };
+        }
+        // Command exists but --version might have failed for some reason
+        // Still consider it installed
+        return null;
+    }
+}
+async function checkCliVersion(command) {
+    try {
+        const { stdout } = await execFileAsync(command, ["--version"], {
+            timeout: 10_000,
+        });
+        const version = stdout.trim();
+        if (version) {
+            return {
+                level: "info",
+                message: `Hermes Agent version: ${version}`,
+                code: "hermes_version",
+            };
+        }
+        return {
+            level: "warn",
+            message: "Could not determine Hermes Agent version",
+            code: "hermes_version_unknown",
+        };
+    }
+    catch {
+        return {
+            level: "warn",
+            message: "Could not determine Hermes Agent version (hermes --version failed)",
+            hint: "Make sure the hermes CLI is properly installed and functional",
+            code: "hermes_version_failed",
+        };
+    }
+}
+async function checkPython() {
+    try {
+        const { stdout } = await execFileAsync("python3", ["--version"], {
+            timeout: 5_000,
+        });
+        const version = stdout.trim();
+        const match = version.match(/(\d+)\.(\d+)/);
+        if (match) {
+            const major = parseInt(match[1], 10);
+            const minor = parseInt(match[2], 10);
+            if (major < 3 || (major === 3 && minor < 10)) {
+                return {
+                    level: "error",
+                    message: `Python ${version} found — Hermes requires Python 3.10+`,
+                    hint: "Upgrade Python to 3.10 or later",
+                    code: "hermes_python_old",
+                };
+            }
+        }
+        return null; // OK
+    }
+    catch {
+        return {
+            level: "warn",
+            message: "python3 not found in PATH",
+            hint: "Hermes Agent requires Python 3.10+. Install it from python.org",
+            code: "hermes_python_missing",
+        };
+    }
+}
+function checkModel(config) {
+    const model = asString(config.model);
+    if (!model) {
+        return {
+            level: "info",
+            message: "No model specified — Hermes will use its configured default model",
+            hint: "Set a model explicitly in FideliOS only if you want to override your local Hermes configuration.",
+            code: "hermes_configured_default_model",
+        };
+    }
+    return {
+        level: "info",
+        message: `Model: ${model}`,
+        code: "hermes_model_configured",
+    };
+}
+function checkApiKeys(config) {
+    // The server resolves secret refs into config.env before calling testEnvironment,
+    // so we check config.env first (adapter-configured secrets), then fall back to
+    // process.env (server/host environment). This mirrors how the Claude adapter does it.
+    const envConfig = (config.env ?? {});
+    const resolvedEnv = {};
+    for (const [key, value] of Object.entries(envConfig)) {
+        if (typeof value === "string" && value.length > 0)
+            resolvedEnv[key] = value;
+    }
+    const has = (key) => !!(resolvedEnv[key] ?? process.env[key]);
+    const hasAnthropic = has("ANTHROPIC_API_KEY");
+    const hasOpenRouter = has("OPENROUTER_API_KEY");
+    const hasOpenAI = has("OPENAI_API_KEY");
+    const hasZai = has("ZAI_API_KEY");
+    if (!hasAnthropic && !hasOpenRouter && !hasOpenAI && !hasZai) {
+        return {
+            level: "warn",
+            message: "No LLM API keys found in environment",
+            hint: "Set ANTHROPIC_API_KEY, OPENROUTER_API_KEY, OPENAI_API_KEY, or ZAI_API_KEY in the agent's env secrets. Hermes may also have keys configured in ~/.hermes/.env",
+            code: "hermes_no_api_keys",
+        };
+    }
+    const providers = [];
+    if (hasAnthropic)
+        providers.push("Anthropic");
+    if (hasOpenRouter)
+        providers.push("OpenRouter");
+    if (hasOpenAI)
+        providers.push("OpenAI");
+    if (hasZai)
+        providers.push("Z.AI");
+    return {
+        level: "info",
+        message: `API keys found: ${providers.join(", ")}`,
+        code: "hermes_api_keys_found",
+    };
+}
+// ---------------------------------------------------------------------------
+// Main test
+// ---------------------------------------------------------------------------
+export async function testEnvironment(ctx) {
+    const config = (ctx.config ?? {});
+    const command = asString(config.hermesCommand) || HERMES_CLI;
+    const checks = [];
+    // 1. CLI installed?
+    const cliCheck = await checkCliInstalled(command);
+    if (cliCheck) {
+        checks.push(cliCheck);
+        if (cliCheck.level === "error") {
+            return {
+                adapterType: ADAPTER_TYPE,
+                status: "fail",
+                checks,
+                testedAt: new Date().toISOString(),
+            };
+        }
+    }
+    // 2. CLI version
+    const versionCheck = await checkCliVersion(command);
+    if (versionCheck)
+        checks.push(versionCheck);
+    // 3. Python available?
+    const pythonCheck = await checkPython();
+    if (pythonCheck)
+        checks.push(pythonCheck);
+    // 4. Model config
+    const modelCheck = checkModel(config);
+    if (modelCheck)
+        checks.push(modelCheck);
+    // 5. API keys (check config.env — server resolves secrets before calling us)
+    const apiKeyCheck = checkApiKeys(config);
+    if (apiKeyCheck)
+        checks.push(apiKeyCheck);
+    // Determine overall status
+    const hasErrors = checks.some((c) => c.level === "error");
+    const hasWarnings = checks.some((c) => c.level === "warn");
+    return {
+        adapterType: ADAPTER_TYPE,
+        status: hasErrors ? "fail" : hasWarnings ? "warn" : "pass",
+        checks,
+        testedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=test.js.map

package/src/server/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/server/test.ts"],"names":[],"mappings":"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"}

package/src/shared/constants.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared constants for the Hermes Agent adapter.
+ */
+/** Adapter type identifier registered with FideliOS. */
+export declare const ADAPTER_TYPE = "hermes_local";
+/** Human-readable label shown in the FideliOS UI. */
+export declare const ADAPTER_LABEL = "Hermes Agent";
+/** Default CLI binary name. */
+export declare const HERMES_CLI = "hermes";
+/** Default timeout for a single execution run (seconds). */
+export declare const DEFAULT_TIMEOUT_SEC = 300;
+/** Grace period after SIGTERM before SIGKILL (seconds). */
+export declare const DEFAULT_GRACE_SEC = 10;
+/** Default model to use if none specified. */
+export declare const DEFAULT_MODEL = "anthropic/claude-sonnet-4";
+/**
+ * Valid --provider choices for the hermes CLI.
+ * When not specified, Hermes auto-detects from model name.
+ */
+export declare const VALID_PROVIDERS: readonly ["auto", "openrouter", "nous", "openai-codex", "zai", "kimi-coding", "minimax", "minimax-cn"];
+/** Regex to extract session ID from Hermes CLI output. */
+export declare const SESSION_ID_REGEX: RegExp;
+/** Regex to extract token usage from Hermes output. */
+export declare const TOKEN_USAGE_REGEX: RegExp;
+/** Regex to extract cost from Hermes output. */
+export declare const COST_REGEX: RegExp;
+/** Prefix used by Hermes for tool output lines. */
+export declare const TOOL_OUTPUT_PREFIX = "\u250A";
+/** Prefix for Hermes thinking blocks. */
+export declare const THINKING_PREFIX = "\uD83D\uDCAD";
+//# sourceMappingURL=constants.d.ts.map

package/src/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,sDAAsD;AACtD,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAE5C,+BAA+B;AAC/B,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,8CAA8C;AAC9C,eAAO,MAAM,aAAa,8BAA8B,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,eAAe,wGASlB,CAAC;AAEX,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,QAAmD,CAAC;AAEjF,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,QACqC,CAAC;AAEpE,gDAAgD;AAChD,eAAO,MAAM,UAAU,QAAqC,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,WAAM,CAAC;AAEtC,yCAAyC;AACzC,eAAO,MAAM,eAAe,iBAAO,CAAC"}

package/src/shared/constants.js

@@ -0,0 +1,40 @@
+/**
+ * Shared constants for the Hermes Agent adapter.
+ */
+/** Adapter type identifier registered with FideliOS. */
+export const ADAPTER_TYPE = "hermes_local";
+/** Human-readable label shown in the FideliOS UI. */
+export const ADAPTER_LABEL = "Hermes Agent";
+/** Default CLI binary name. */
+export const HERMES_CLI = "hermes";
+/** Default timeout for a single execution run (seconds). */
+export const DEFAULT_TIMEOUT_SEC = 300;
+/** Grace period after SIGTERM before SIGKILL (seconds). */
+export const DEFAULT_GRACE_SEC = 10;
+/** Default model to use if none specified. */
+export const DEFAULT_MODEL = "anthropic/claude-sonnet-4";
+/**
+ * Valid --provider choices for the hermes CLI.
+ * When not specified, Hermes auto-detects from model name.
+ */
+export const VALID_PROVIDERS = [
+    "auto",
+    "openrouter",
+    "nous",
+    "openai-codex",
+    "zai",
+    "kimi-coding",
+    "minimax",
+    "minimax-cn",
+];
+/** Regex to extract session ID from Hermes CLI output. */
+export const SESSION_ID_REGEX = /session[_ ](?:id|saved)[:\s]+([a-zA-Z0-9_-]+)/i;
+/** Regex to extract token usage from Hermes output. */
+export const TOKEN_USAGE_REGEX = /tokens?[:\s]+(\d+)\s*(?:input|in)\b.*?(\d+)\s*(?:output|out)\b/i;
+/** Regex to extract cost from Hermes output. */
+export const COST_REGEX = /(?:cost|spent)[:\s]*\$?([\d.]+)/i;
+/** Prefix used by Hermes for tool output lines. */
+export const TOOL_OUTPUT_PREFIX = "┊";
+/** Prefix for Hermes thinking blocks. */
+export const THINKING_PREFIX = "💭";
+//# sourceMappingURL=constants.js.map

package/src/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,+BAA+B;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,YAAY;IACZ,MAAM;IACN,cAAc;IACd,KAAK;IACL,aAAa;IACb,SAAS;IACT,YAAY;CACJ,CAAC;AAEX,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,gDAAgD,CAAC;AAEjF,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAC5B,iEAAiE,CAAC;AAEpE,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAE7D,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC"}

package/src/ui/build-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build adapter configuration from UI form values.
+ *
+ * Translates FideliOS's CreateConfigValues into the adapterConfig
+ * object stored in the agent record.
+ */
+import type { CreateConfigValues } from "@fideliosai/adapter-utils";
+/**
+ * Build a Hermes Agent adapter config from the FideliOS UI form values.
+ */
+export declare function buildHermesConfig(v: CreateConfigValues): Record<string, unknown>;
+//# sourceMappingURL=build-config.d.ts.map

package/src/ui/build-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-config.d.ts","sourceRoot":"","sources":["../../src/ui/build-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAMrE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,kBAAkB,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB"}

package/src/ui/build-config.js

@@ -0,0 +1,47 @@
+/**
+ * Build adapter configuration from UI form values.
+ *
+ * Translates FideliOS's CreateConfigValues into the adapterConfig
+ * object stored in the agent record.
+ */
+import { DEFAULT_TIMEOUT_SEC, } from "../shared/constants.js";
+/**
+ * Build a Hermes Agent adapter config from the FideliOS UI form values.
+ */
+export function buildHermesConfig(v) {
+    const ac = {};
+    // Model
+    if (v.model.trim()) {
+        ac.model = v.model.trim();
+    }
+    // Execution limits
+    ac.timeoutSec = DEFAULT_TIMEOUT_SEC;
+    // maxTurnsPerRun maps to Hermes's max_turns (set via config, not CLI flag)
+    // Session persistence (default: on)
+    ac.persistSession = true;
+    // Working directory
+    if (v.cwd) {
+        ac.cwd = v.cwd;
+    }
+    // Custom hermes binary path
+    if (v.command) {
+        ac.hermesCommand = v.command;
+    }
+    // Extra CLI arguments
+    if (v.extraArgs) {
+        ac.extraArgs = v.extraArgs.split(/\s+/).filter(Boolean);
+    }
+    // Thinking/reasoning effort
+    if (v.thinkingEffort) {
+        const existing = ac.extraArgs || [];
+        existing.push("--reasoning-effort", String(v.thinkingEffort));
+        ac.extraArgs = existing;
+    }
+    // Prompt template
+    if (v.promptTemplate) {
+        ac.promptTemplate = v.promptTemplate;
+    }
+    // Heartbeat config is handled by FideliOS itself
+    return ac;
+}
+//# sourceMappingURL=build-config.js.map

package/src/ui/build-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-config.js","sourceRoot":"","sources":["../../src/ui/build-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,CAAqB;IAErB,MAAM,EAAE,GAA4B,EAAE,CAAC;IAEvC,QAAQ;IACR,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,EAAE,CAAC,UAAU,GAAG,mBAAmB,CAAC;IACpC,2EAA2E;IAE3E,oCAAoC;IACpC,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC;IAEzB,oBAAoB;IACpB,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACV,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IACjB,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,EAAE,CAAC,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAI,EAAE,CAAC,SAAsB,IAAI,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QAC9D,EAAE,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QACrB,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;IACvC,CAAC;IAED,kDAAkD;IAElD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/src/ui/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * UI module exports — used by FideliOS's dashboard for run viewing
+ * and agent configuration forms.
+ */
+export { parseHermesStdoutLine } from "./parse-stdout.js";
+export { buildHermesConfig } from "./build-config.js";
+//# sourceMappingURL=index.d.ts.map

package/src/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/src/ui/index.js

@@ -0,0 +1,7 @@
+/**
+ * UI module exports — used by FideliOS's dashboard for run viewing
+ * and agent configuration forms.
+ */
+export { parseHermesStdoutLine } from "./parse-stdout.js";
+export { buildHermesConfig } from "./build-config.js";
+//# sourceMappingURL=index.js.map

package/src/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/src/ui/parse-stdout.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parse Hermes Agent stdout into TranscriptEntry objects for the FideliOS UI.
+ *
+ * Hermes CLI quiet-mode output patterns:
+ *   Assistant:  "  ┊ 💬 {text}"
+ *   Tool (TTY): "  ┊ {emoji} {verb:9} {detail}  {duration}"
+ *   Tool (pipe): "  [done] ┊ {emoji} {verb:9} {detail}  {duration} ({total})"
+ *   System:     "[hermes] ..."
+ *
+ * We emit structured tool_call/tool_result pairs so FideliOS renders proper
+ * tool cards (with status icons, expand/collapse) instead of raw stdout blocks.
+ */
+import type { TranscriptEntry } from "@fideliosai/adapter-utils";
+/**
+ * Parse a single line of Hermes stdout into transcript entries.
+ *
+ * Emits structured tool_call/tool_result pairs (with synthetic IDs) so
+ * FideliOS renders proper tool cards with status icons and expand/collapse.
+ *
+ * @param line  Raw stdout line from Hermes CLI
+ * @param ts    ISO timestamp for the entry
+ * @returns     Array of TranscriptEntry objects (may be empty)
+ */
+export declare function parseHermesStdoutLine(line: string, ts: string): TranscriptEntry[];
+//# sourceMappingURL=parse-stdout.d.ts.map

package/src/ui/parse-stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stdout.d.ts","sourceRoot":"","sources":["../../src/ui/parse-stdout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AA8JlE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,eAAe,EAAE,CAiGnB"}