agenticros 0.3.0 → 0.3.3

package/dist/util/codex-config.js

@@ -0,0 +1,326 @@
+/**
+ * Read/write helpers for OpenAI Codex CLI MCP config (`config.toml`).
+ *
+ * Codex stores MCP servers under `[mcp_servers.<name>]` in either
+ * `~/.codex/config.toml` (global) or `<project>/.codex/config.toml` (project).
+ * We only manage the `agenticros` entry — other servers are preserved.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+const AGENTICROS_BLOCK_START = "[mcp_servers.agenticros]";
+const AGENTICROS_ENV_BLOCK = "[mcp_servers.agenticros.env]";
+/** Global Codex config: `~/.codex/config.toml`. */
+export function globalCodexConfigPath() {
+    return join(homedir(), ".codex", "config.toml");
+}
+/** Project-scoped Codex config: `<cwd>/.codex/config.toml`. */
+export function projectCodexConfigPath(cwd = process.cwd()) {
+    return join(cwd, ".codex", "config.toml");
+}
+export function resolveCodexConfigPath(scope, cwd = process.cwd()) {
+    return scope === "global" ? globalCodexConfigPath() : projectCodexConfigPath(cwd);
+}
+/**
+ * Build the TOML block for the AgenticROS MCP server. Uses an absolute path
+ * to index.js (required by Codex) and leaves namespace empty so
+ * `~/.agenticros/config.json` / `agenticros mode` drives the active robot.
+ */
+export function buildAgenticrosMcpTomlBlock(mcpEntryAbs, namespace = "") {
+    const escaped = mcpEntryAbs.replace(/\\/g, "\\\\");
+    const shellCmd = `node ${escaped} 2>>/tmp/agenticros-mcp.log`;
+    const nsValue = namespace.replace(/"/g, '\\"');
+    return `${AGENTICROS_BLOCK_START}
+command = "sh"
+args = ["-c", "${shellCmd.replace(/"/g, '\\"')}"]
+enabled = true
+startup_timeout_sec = 30
+
+${AGENTICROS_ENV_BLOCK}
+AGENTICROS_ROBOT_NAMESPACE = "${nsValue}"
+`;
+}
+/** Insert or replace the agenticros MCP block, preserving other TOML content. */
+export function upsertAgenticrosBlock(existingContent, block) {
+    const trimmedBlock = block.trimEnd() + "\n";
+    if (!existingContent?.trim()) {
+        return trimmedBlock;
+    }
+    const lines = existingContent.split("\n");
+    const out = [];
+    let i = 0;
+    let replaced = false;
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        if (line.trim() === AGENTICROS_BLOCK_START) {
+            if (!replaced) {
+                out.push(trimmedBlock.trimEnd());
+                replaced = true;
+            }
+            i++;
+            while (i < lines.length) {
+                const next = lines[i] ?? "";
+                const trimmed = next.trim();
+                if (/^\[mcp_servers\./.test(trimmed)) {
+                    if (trimmed !== AGENTICROS_BLOCK_START && trimmed !== AGENTICROS_ENV_BLOCK) {
+                        break;
+                    }
+                }
+                i++;
+            }
+            continue;
+        }
+        out.push(line);
+        i++;
+    }
+    if (!replaced) {
+        const sep = out.length > 0 && out[out.length - 1]?.trim() !== "" ? "\n" : "";
+        return out.join("\n") + sep + trimmedBlock;
+    }
+    return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+}
+/** Parse the agenticros MCP section from a Codex config.toml file. */
+export function readCodexAgenticrosConfig(configPath) {
+    const base = { configPath, exists: existsSync(configPath) };
+    if (!base.exists)
+        return base;
+    let content;
+    try {
+        content = readFileSync(configPath, "utf8");
+    }
+    catch {
+        return base;
+    }
+    const serverSection = extractSection(content, AGENTICROS_BLOCK_START, AGENTICROS_ENV_BLOCK);
+    const envSection = extractSection(content, AGENTICROS_ENV_BLOCK, /^\[/);
+    base.command = parseTomlString(serverSection, "command");
+    base.args = parseTomlStringArray(serverSection, "args");
+    base.enabled = parseTomlBoolean(serverSection, "enabled");
+    base.env = parseTomlEnvBlock(envSection);
+    return base;
+}
+export function writeCodexAgenticrosConfig(configPath, mcpEntryAbs, options) {
+    const abs = resolve(mcpEntryAbs);
+    const block = buildAgenticrosMcpTomlBlock(abs, options?.namespace ?? "");
+    const existing = existsSync(configPath) ? readFileSync(configPath, "utf8") : null;
+    const merged = upsertAgenticrosBlock(existing, block);
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, merged, "utf8");
+}
+/** Validate Codex agenticros MCP config against expected MCP binary path. */
+export function validateCodexAgenticrosConfig(cfg, mcpEntryExpected) {
+    const issues = [];
+    if (!cfg.exists) {
+        issues.push({
+            severity: "yellow",
+            message: `Codex config missing (${cfg.configPath})`,
+            hint: "Run `agenticros codex setup` to register the AgenticROS MCP server.",
+        });
+        return { ok: false, issues };
+    }
+    if (!cfg.command && (!cfg.args || cfg.args.length === 0)) {
+        issues.push({
+            severity: "red",
+            message: "Codex [mcp_servers.agenticros] has no command or args",
+            hint: "Run `agenticros codex setup` to repair the entry.",
+        });
+    }
+    const mcpPathInArgs = extractMcpPathFromArgs(cfg.args ?? []);
+    if (mcpPathInArgs && !isAbsolute(mcpPathInArgs.split(/\s/)[0] ?? "")) {
+        issues.push({
+            severity: "red",
+            message: "Codex MCP path is relative — Codex cwd is not the repo root",
+            hint: "Run `agenticros codex setup` to rewrite with an absolute path.",
+        });
+    }
+    if (mcpEntryExpected && mcpPathInArgs) {
+        const expected = resolve(mcpEntryExpected);
+        const actual = resolve(mcpPathInArgs.split(/\s/)[0] ?? mcpPathInArgs);
+        if (actual !== expected && !existsSync(actual)) {
+            issues.push({
+                severity: "red",
+                message: "Codex MCP path does not point to a built server",
+                hint: `Expected ${expected}. Run \`agenticros codex setup\`.`,
+            });
+        }
+        else if (actual !== expected) {
+            issues.push({
+                severity: "yellow",
+                message: "Codex MCP path differs from the CLI-resolved MCP entry",
+                hint: `CLI expects ${expected}. Run \`agenticros codex setup\` to sync.`,
+            });
+        }
+    }
+    else if (mcpEntryExpected && !mcpPathInArgs) {
+        issues.push({
+            severity: "yellow",
+            message: "Could not parse MCP server path from Codex config",
+            hint: "Run `agenticros codex setup` to rewrite the entry.",
+        });
+    }
+    const ns = (cfg.env?.["AGENTICROS_ROBOT_NAMESPACE"] ?? "").trim();
+    if (ns.length > 0) {
+        issues.push({
+            severity: "yellow",
+            message: `Codex AGENTICROS_ROBOT_NAMESPACE is hardcoded ('${ns}')`,
+            hint: 'Leave it empty in ~/.codex/config.toml so `agenticros mode real|sim` drives the namespace (same as .mcp.json).',
+        });
+    }
+    if (cfg.enabled === false) {
+        issues.push({
+            severity: "yellow",
+            message: "Codex agenticros MCP server is disabled (enabled = false)",
+            hint: "Set enabled = true or re-run `agenticros codex setup`.",
+        });
+    }
+    const hasRed = issues.some((i) => i.severity === "red");
+    return { ok: !hasRed && issues.length === 0, issues };
+}
+/** Collect Codex config paths to inspect (global + project when in a workspace). */
+export function listCodexConfigCandidates(repoRoot) {
+    const paths = [globalCodexConfigPath()];
+    if (repoRoot) {
+        paths.push(projectCodexConfigPath(repoRoot));
+    }
+    const cwdProject = projectCodexConfigPath(process.cwd());
+    if (!paths.includes(cwdProject)) {
+        paths.push(cwdProject);
+    }
+    return paths;
+}
+function extractSection(content, startMarker, endPattern) {
+    const lines = content.split("\n");
+    const out = [];
+    let inSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === startMarker) {
+            inSection = true;
+            continue;
+        }
+        if (inSection) {
+            if (typeof endPattern === "string") {
+                if (trimmed === endPattern)
+                    break;
+            }
+            else if (endPattern.test(trimmed) && trimmed !== startMarker) {
+                break;
+            }
+            out.push(line);
+        }
+    }
+    return out.join("\n");
+}
+function parseTomlString(section, key) {
+    const re = new RegExp(`^${key}\\s*=\\s*"([^"]*)"`, "m");
+    const m = section.match(re);
+    return m?.[1];
+}
+function parseTomlBoolean(section, key) {
+    const re = new RegExp(`^${key}\\s*=\\s*(true|false)`, "m");
+    const m = section.match(re);
+    if (!m)
+        return undefined;
+    return m[1] === "true";
+}
+function parseTomlStringArray(section, key) {
+    const inline = section.match(new RegExp(`^${key}\\s*=\\s*\\[([^\\]]*)\\]`, "m"));
+    if (inline?.[1]) {
+        return [...inline[1].matchAll(/"((?:\\.|[^"\\])*)"/g)].map((m) => m[1].replace(/\\"/g, '"').replace(/\\\\/g, "\\"));
+    }
+    const start = section.match(new RegExp(`^${key}\\s*=\\s*\\[`, "m"));
+    if (!start)
+        return undefined;
+    const after = section.slice(start.index ?? 0);
+    const values = [];
+    for (const m of after.matchAll(/"((?:\\.|[^"\\])*)"/g)) {
+        values.push(m[1].replace(/\\"/g, '"').replace(/\\\\/g, "\\"));
+    }
+    return values.length > 0 ? values : undefined;
+}
+function parseTomlEnvBlock(section) {
+    const env = {};
+    for (const line of section.split("\n")) {
+        const m = line.match(/^([A-Z0-9_]+)\s*=\s*"([^"]*)"/);
+        if (m)
+            env[m[1]] = m[2];
+    }
+    return env;
+}
+/** Doctor check entries for Codex MCP config (used by `agenticros doctor`). */
+export function buildCodexDoctorChecks(mcpEntryExpected, repoRoot) {
+    const checks = [];
+    const globalPath = globalCodexConfigPath();
+    const globalCfg = readCodexAgenticrosConfig(globalPath);
+    if (!globalCfg.exists) {
+        checks.push({
+            id: "codex-config-global",
+            label: "Codex global MCP config missing (~/.codex/config.toml)",
+            severity: "yellow",
+            hint: "Run `agenticros codex setup` to register the AgenticROS MCP server.",
+        });
+    }
+    else {
+        const v = validateCodexAgenticrosConfig(globalCfg, mcpEntryExpected);
+        if (v.ok) {
+            checks.push({
+                id: "codex-config-global",
+                label: "Codex global MCP config OK",
+                severity: "green",
+                detail: globalPath,
+            });
+        }
+        else {
+            const worst = v.issues.some((i) => i.severity === "red") ? "red" : "yellow";
+            const first = v.issues[0];
+            checks.push({
+                id: "codex-config-global",
+                label: `Codex global MCP: ${first.message}`,
+                severity: worst,
+                hint: first.hint ?? "Run `agenticros codex setup`.",
+            });
+        }
+    }
+    if (repoRoot) {
+        const projectPath = projectCodexConfigPath(repoRoot);
+        const projectCfg = readCodexAgenticrosConfig(projectPath);
+        if (projectCfg.exists) {
+            const v = validateCodexAgenticrosConfig(projectCfg, mcpEntryExpected);
+            if (v.ok) {
+                checks.push({
+                    id: "codex-config-project",
+                    label: "Codex project MCP config OK",
+                    severity: "green",
+                    detail: projectPath,
+                });
+            }
+            else {
+                const worst = v.issues.some((i) => i.severity === "red") ? "red" : "yellow";
+                const first = v.issues[0];
+                checks.push({
+                    id: "codex-config-project",
+                    label: `Codex project MCP: ${first.message}`,
+                    severity: worst,
+                    hint: first.hint ?? "Run `agenticros codex setup --project`.",
+                });
+            }
+        }
+    }
+    return checks;
+}
+function extractMcpPathFromArgs(args) {
+    if (args.length === 0)
+        return undefined;
+    if (args[0] === "-c" && args[1]) {
+        const cmd = args[1];
+        const nodeMatch = cmd.match(/node\s+(\S+)/);
+        return nodeMatch?.[1];
+    }
+    if (args[0] === "node" || args[0]?.endsWith("/node")) {
+        return args[1];
+    }
+    const joined = args.join(" ");
+    const nodeMatch = joined.match(/node\s+(\S+)/);
+    return nodeMatch?.[1];
+}
+//# sourceMappingURL=codex-config.js.map

package/dist/util/codex-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-config.js","sourceRoot":"","sources":["../../src/util/codex-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwB/D,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAC1D,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAE5D,mDAAmD;AACnD,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAClD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,sBAAsB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACxD,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAuB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACjF,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB,EAAE,SAAS,GAAG,EAAE;IAC7E,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,QAAQ,OAAO,6BAA6B,CAAC;IAC9D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,GAAG,sBAAsB;;iBAEjB,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;;;;EAI5C,oBAAoB;gCACU,OAAO;CACtC,CAAC;AACF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,eAA8B,EAAE,KAAa;IACjF,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,sBAAsB,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjC,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YACD,CAAC,EAAE,CAAC;YACJ,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrC,IAAI,OAAO,KAAK,sBAAsB,IAAI,OAAO,KAAK,oBAAoB,EAAE,CAAC;wBAC3E,MAAM;oBACR,CAAC;gBACH,CAAC;gBACD,CAAC,EAAE,CAAC;YACN,CAAC;YACD,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,EAAE,CAAC;IACN,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,YAAY,CAAC;IAC7C,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;AACpE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,MAAM,IAAI,GAA0B,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;IACnF,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;IAC5F,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;IAExE,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAkB,EAClB,WAAmB,EACnB,OAAgC;IAEhC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtD,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,6BAA6B,CAC3C,GAA0B,EAC1B,gBAAyB;IAEzB,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,yBAAyB,GAAG,CAAC,UAAU,GAAG;YACnD,IAAI,EAAE,qEAAqE;SAC5E,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,uDAAuD;YAChE,IAAI,EAAE,mDAAmD;SAC1D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,GAAG,sBAAsB,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7D,IAAI,aAAa,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,6DAA6D;YACtE,IAAI,EAAE,gEAAgE;SACvE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,gBAAgB,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC;QACtE,IAAI,MAAM,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,iDAAiD;gBAC1D,IAAI,EAAE,YAAY,QAAQ,mCAAmC;aAC9D,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE,wDAAwD;gBACjE,IAAI,EAAE,eAAe,QAAQ,2CAA2C;aACzE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,IAAI,gBAAgB,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,mDAAmD;YAC5D,IAAI,EAAE,oDAAoD;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,mDAAmD,EAAE,IAAI;YAClE,IAAI,EACF,gHAAgH;SACnH,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,2DAA2D;YACpE,IAAI,EAAE,wDAAwD;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC;IACxD,OAAO,EAAE,EAAE,EAAE,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,yBAAyB,CAAC,QAAiB;IACzD,MAAM,KAAK,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,WAAmB,EAAE,UAA2B;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YAC5B,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,IAAI,OAAO,KAAK,UAAU;oBAAE,MAAM;YACpC,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;gBAC/D,MAAM;YACR,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,GAAW;IACnD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,oBAAoB,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,GAAW;IACpD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;AACzB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe,EAAE,GAAW;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,0BAA0B,EAAE,GAAG,CAAC,CAAC,CAAC;IACjF,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/D,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACtD,IAAI,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CACpC,gBAAoC,EACpC,QAAiB;IAEjB,MAAM,MAAM,GAMP,EAAE,CAAC;IAER,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,qBAAqB;YACzB,KAAK,EAAE,wDAAwD;YAC/D,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,qEAAqE;SAC5E,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,6BAA6B,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACrE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,qBAAqB;gBACzB,KAAK,EAAE,4BAA4B;gBACnC,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC5E,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,qBAAqB;gBACzB,KAAK,EAAE,qBAAqB,KAAK,CAAC,OAAO,EAAE;gBAC3C,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,+BAA+B;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,6BAA6B,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;YACtE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,sBAAsB;oBAC1B,KAAK,EAAE,6BAA6B;oBACpC,QAAQ,EAAE,OAAO;oBACjB,MAAM,EAAE,WAAW;iBACpB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC5E,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC;oBACV,EAAE,EAAE,sBAAsB;oBAC1B,KAAK,EAAE,sBAAsB,KAAK,CAAC,OAAO,EAAE;oBAC5C,QAAQ,EAAE,KAAK;oBACf,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,yCAAyC;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAc;IAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC/C,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/util/hermes-config.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Read/write helpers for Hermes Agent MCP config (`~/.hermes/config.yaml`).
+ *
+ * Hermes stores MCP servers under `mcp_servers.<name>` in YAML. We only
+ * manage the `agenticros` entry — other servers are preserved.
+ */
+export interface HermesAgenticrosConfig {
+    configPath: string;
+    exists: boolean;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    connectTimeout?: number;
+    timeout?: number;
+    enabled?: boolean;
+}
+export interface HermesConfigIssue {
+    severity: "red" | "yellow";
+    message: string;
+    hint?: string;
+}
+export interface HermesConfigValidation {
+    ok: boolean;
+    issues: HermesConfigIssue[];
+}
+/** Global Hermes config: `~/.hermes/config.yaml`. */
+export declare function globalHermesConfigPath(): string;
+/**
+ * Build the YAML block for the AgenticROS MCP server. Uses an absolute path
+ * to index.js (required by Hermes stdio transport) and leaves namespace empty
+ * so `~/.agenticros/config.json` / `agenticros mode` drives the active robot.
+ */
+export declare function buildAgenticrosMcpYamlBlock(mcpEntryAbs: string, namespace?: string): string;
+/** Insert or replace the agenticros MCP block, preserving other YAML content. */
+export declare function upsertAgenticrosBlock(existingContent: string | null, block: string): string;
+/** Parse the agenticros MCP section from a Hermes config.yaml file. */
+export declare function readHermesAgenticrosConfig(configPath: string): HermesAgenticrosConfig;
+export declare function writeHermesAgenticrosConfig(configPath: string, mcpEntryAbs: string, options?: {
+    namespace?: string;
+}): void;
+/** Validate Hermes agenticros MCP config against expected MCP binary path. */
+export declare function validateHermesAgenticrosConfig(cfg: HermesAgenticrosConfig, mcpEntryExpected?: string): HermesConfigValidation;
+/** Doctor check entries for Hermes MCP config (used by `agenticros doctor`). */
+export declare function buildHermesDoctorChecks(mcpEntryExpected: string | undefined): Array<{
+    id: string;
+    label: string;
+    severity: "green" | "yellow" | "red";
+    hint?: string;
+    detail?: string;
+}>;
+//# sourceMappingURL=hermes-config.d.ts.map

package/dist/util/hermes-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-config.d.ts","sourceRoot":"","sources":["../../src/util/hermes-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAKD,qDAAqD;AACrD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAYvF;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA+B3F;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CA4BrF;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,IAAI,CAON;AAED,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,sBAAsB,EAC3B,gBAAgB,CAAC,EAAE,MAAM,GACxB,sBAAsB,CAyExB;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC5G"}

package/dist/util/hermes-config.js

@@ -0,0 +1,277 @@
+/**
+ * Read/write helpers for Hermes Agent MCP config (`~/.hermes/config.yaml`).
+ *
+ * Hermes stores MCP servers under `mcp_servers.<name>` in YAML. We only
+ * manage the `agenticros` entry — other servers are preserved.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+const MCP_SERVERS_KEY = "mcp_servers:";
+const AGENTICROS_KEY = "agenticros:";
+/** Global Hermes config: `~/.hermes/config.yaml`. */
+export function globalHermesConfigPath() {
+    return join(homedir(), ".hermes", "config.yaml");
+}
+/**
+ * Build the YAML block for the AgenticROS MCP server. Uses an absolute path
+ * to index.js (required by Hermes stdio transport) and leaves namespace empty
+ * so `~/.agenticros/config.json` / `agenticros mode` drives the active robot.
+ */
+export function buildAgenticrosMcpYamlBlock(mcpEntryAbs, namespace = "") {
+    const escaped = mcpEntryAbs.replace(/\\/g, "\\\\");
+    const nsYaml = namespace.replace(/"/g, '\\"');
+    return `${MCP_SERVERS_KEY}
+  ${AGENTICROS_KEY}
+    command: "node"
+    args: ["${escaped}"]
+    env:
+      AGENTICROS_ROBOT_NAMESPACE: "${nsYaml}"
+    connect_timeout: 60
+    timeout: 120
+`;
+}
+/** Insert or replace the agenticros MCP block, preserving other YAML content. */
+export function upsertAgenticrosBlock(existingContent, block) {
+    const trimmedBlock = block.trimEnd() + "\n";
+    if (!existingContent?.trim()) {
+        return trimmedBlock;
+    }
+    const lines = existingContent.split("\n");
+    const mcpIdx = lines.findIndex((l) => l.trim() === MCP_SERVERS_KEY);
+    if (mcpIdx < 0) {
+        const sep = lines.length > 0 && lines[lines.length - 1]?.trim() !== "" ? "\n" : "";
+        return lines.join("\n") + sep + trimmedBlock;
+    }
+    const agentIdx = findAgenticrosLineIndex(lines, mcpIdx);
+    if (agentIdx < 0) {
+        const insertAt = findMcpServersInsertPoint(lines, mcpIdx);
+        const agentLines = trimmedBlock
+            .split("\n")
+            .slice(1)
+            .filter((l) => l.trim().length > 0);
+        const out = [...lines.slice(0, insertAt), ...agentLines, ...lines.slice(insertAt)];
+        return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+    }
+    const endIdx = findAgenticrosEndIndex(lines, agentIdx);
+    const agentLines = trimmedBlock
+        .split("\n")
+        .slice(1)
+        .filter((l) => l.startsWith("  "));
+    const out = [...lines.slice(0, agentIdx), ...agentLines, ...lines.slice(endIdx)];
+    return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+}
+/** Parse the agenticros MCP section from a Hermes config.yaml file. */
+export function readHermesAgenticrosConfig(configPath) {
+    const base = { configPath, exists: existsSync(configPath) };
+    if (!base.exists)
+        return base;
+    let content;
+    try {
+        content = readFileSync(configPath, "utf8");
+    }
+    catch {
+        return base;
+    }
+    const lines = content.split("\n");
+    const mcpIdx = lines.findIndex((l) => l.trim() === MCP_SERVERS_KEY);
+    if (mcpIdx < 0)
+        return base;
+    const agentIdx = findAgenticrosLineIndex(lines, mcpIdx);
+    if (agentIdx < 0)
+        return base;
+    const endIdx = findAgenticrosEndIndex(lines, agentIdx);
+    const section = lines.slice(agentIdx, endIdx).join("\n");
+    base.command = parseYamlString(section, "command");
+    base.args = parseYamlStringArray(section, "args");
+    base.env = parseYamlEnvBlock(section);
+    base.connectTimeout = parseYamlNumber(section, "connect_timeout");
+    base.timeout = parseYamlNumber(section, "timeout");
+    base.enabled = parseYamlBoolean(section, "enabled");
+    return base;
+}
+export function writeHermesAgenticrosConfig(configPath, mcpEntryAbs, options) {
+    const abs = resolve(mcpEntryAbs);
+    const block = buildAgenticrosMcpYamlBlock(abs, options?.namespace ?? "");
+    const existing = existsSync(configPath) ? readFileSync(configPath, "utf8") : null;
+    const merged = upsertAgenticrosBlock(existing, block);
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, merged, "utf8");
+}
+/** Validate Hermes agenticros MCP config against expected MCP binary path. */
+export function validateHermesAgenticrosConfig(cfg, mcpEntryExpected) {
+    const issues = [];
+    if (!cfg.exists) {
+        issues.push({
+            severity: "yellow",
+            message: `Hermes config missing (${cfg.configPath})`,
+            hint: "Run `agenticros hermes setup` to register the AgenticROS MCP server.",
+        });
+        return { ok: false, issues };
+    }
+    if (!cfg.command && (!cfg.args || cfg.args.length === 0)) {
+        issues.push({
+            severity: "red",
+            message: "Hermes mcp_servers.agenticros has no command or args",
+            hint: "Run `agenticros hermes setup` to repair the entry.",
+        });
+    }
+    const mcpPath = cfg.args?.[0];
+    if (mcpPath && !isAbsolute(mcpPath)) {
+        issues.push({
+            severity: "red",
+            message: "Hermes MCP path is relative — Hermes cwd is not the repo root",
+            hint: "Run `agenticros hermes setup` to rewrite with an absolute path.",
+        });
+    }
+    if (mcpEntryExpected && mcpPath) {
+        const expected = resolve(mcpEntryExpected);
+        const actual = resolve(mcpPath);
+        if (actual !== expected && !existsSync(actual)) {
+            issues.push({
+                severity: "red",
+                message: "Hermes MCP path does not point to a built server",
+                hint: `Expected ${expected}. Run \`agenticros hermes setup\`.`,
+            });
+        }
+        else if (actual !== expected) {
+            issues.push({
+                severity: "yellow",
+                message: "Hermes MCP path differs from the CLI-resolved MCP entry",
+                hint: `CLI expects ${expected}. Run \`agenticros hermes setup\` to sync.`,
+            });
+        }
+    }
+    else if (mcpEntryExpected && !mcpPath) {
+        issues.push({
+            severity: "yellow",
+            message: "Could not parse MCP server path from Hermes config",
+            hint: "Run `agenticros hermes setup` to rewrite the entry.",
+        });
+    }
+    const ns = (cfg.env?.["AGENTICROS_ROBOT_NAMESPACE"] ?? "").trim();
+    if (ns.length > 0) {
+        issues.push({
+            severity: "yellow",
+            message: `Hermes AGENTICROS_ROBOT_NAMESPACE is hardcoded ('${ns}')`,
+            hint: 'Leave it empty in ~/.hermes/config.yaml so `agenticros mode real|sim` drives the namespace (same as Codex).',
+        });
+    }
+    if (cfg.enabled === false) {
+        issues.push({
+            severity: "yellow",
+            message: "Hermes agenticros MCP server is disabled (enabled: false)",
+            hint: "Remove enabled: false or re-run `agenticros hermes setup`.",
+        });
+    }
+    const hasRed = issues.some((i) => i.severity === "red");
+    return { ok: !hasRed && issues.length === 0, issues };
+}
+/** Doctor check entries for Hermes MCP config (used by `agenticros doctor`). */
+export function buildHermesDoctorChecks(mcpEntryExpected) {
+    const checks = [];
+    const configPath = globalHermesConfigPath();
+    const cfg = readHermesAgenticrosConfig(configPath);
+    if (!cfg.exists) {
+        checks.push({
+            id: "hermes-config",
+            label: "Hermes MCP config missing (~/.hermes/config.yaml)",
+            severity: "yellow",
+            hint: "Run `agenticros hermes setup` to register the AgenticROS MCP server.",
+        });
+        return checks;
+    }
+    const v = validateHermesAgenticrosConfig(cfg, mcpEntryExpected);
+    if (v.ok) {
+        checks.push({
+            id: "hermes-config",
+            label: "Hermes MCP config OK",
+            severity: "green",
+            detail: configPath,
+        });
+    }
+    else {
+        const worst = v.issues.some((i) => i.severity === "red") ? "red" : "yellow";
+        const first = v.issues[0];
+        checks.push({
+            id: "hermes-config",
+            label: `Hermes MCP: ${first.message}`,
+            severity: worst,
+            hint: first.hint ?? "Run `agenticros hermes setup`.",
+        });
+    }
+    return checks;
+}
+function findAgenticrosLineIndex(lines, mcpIdx) {
+    for (let i = mcpIdx + 1; i < lines.length; i++) {
+        const trimmed = lines[i]?.trim() ?? "";
+        if (/^\S/.test(lines[i] ?? "") && trimmed !== MCP_SERVERS_KEY)
+            break;
+        if (trimmed === AGENTICROS_KEY)
+            return i;
+    }
+    return -1;
+}
+function findMcpServersInsertPoint(lines, mcpIdx) {
+    let insertAt = mcpIdx + 1;
+    for (let i = mcpIdx + 1; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        if (/^\S/.test(line) && line.trim() !== MCP_SERVERS_KEY)
+            break;
+        if (/^  \S/.test(line))
+            insertAt = i + 1;
+    }
+    return insertAt;
+}
+function findAgenticrosEndIndex(lines, agentIdx) {
+    for (let i = agentIdx + 1; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        if (/^  \S/.test(line) && !line.startsWith("    ") && line.trim() !== AGENTICROS_KEY) {
+            return i;
+        }
+        if (/^\S/.test(line))
+            return i;
+    }
+    return lines.length;
+}
+function parseYamlString(section, key) {
+    const re = new RegExp(`^\\s*${key}:\\s*"([^"]*)"`, "m");
+    const m = section.match(re);
+    return m?.[1];
+}
+function parseYamlBoolean(section, key) {
+    const re = new RegExp(`^\\s*${key}:\\s*(true|false)`, "m");
+    const m = section.match(re);
+    if (!m)
+        return undefined;
+    return m[1] === "true";
+}
+function parseYamlNumber(section, key) {
+    const re = new RegExp(`^\\s*${key}:\\s*(\\d+)`, "m");
+    const m = section.match(re);
+    if (!m)
+        return undefined;
+    return Number(m[1]);
+}
+function parseYamlStringArray(section, key) {
+    const inline = section.match(new RegExp(`^\\s*${key}:\\s*\\[([^\\]]*)\\]`, "m"));
+    if (inline?.[1]) {
+        return [...inline[1].matchAll(/"((?:\\.|[^"\\])*)"/g)].map((m) => m[1].replace(/\\"/g, '"').replace(/\\\\/g, "\\"));
+    }
+    return undefined;
+}
+function parseYamlEnvBlock(section) {
+    const env = {};
+    const envMatch = section.match(/^(\s*)env:\s*$/m);
+    if (!envMatch)
+        return env;
+    const baseIndent = envMatch[1]?.length ?? 0;
+    const envKeyIndent = baseIndent + 2;
+    for (const line of section.split("\n")) {
+        const m = line.match(new RegExp(`^\\s{${envKeyIndent}}([A-Z0-9_]+):\\s*"([^"]*)"`));
+        if (m)
+            env[m[1]] = m[2];
+    }
+    return env;
+}
+//# sourceMappingURL=hermes-config.js.map