theclawbay 0.3.75 → 0.3.77

package/README.md

@@ -1,6 +1,6 @@
 # theclawbay
 
-CLI for connecting Codex, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, experimental Trae, and experimental Zo to The Claw Bay.
+CLI for connecting Codex, Hermes Agent, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, experimental Trae, and experimental Zo to The Claw Bay.
 
 ## Install
 
@@ -16,7 +16,7 @@ Get your API key from `https://theclawbay.com/dashboard`.
 theclawbay setup --api-key <apiKey>
 ```
 
-In an interactive terminal, setup shows one picker for Codex, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, Windows Trae, and Zo.
+In an interactive terminal, setup shows one picker for Codex, Hermes Agent, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, Windows Trae, and Zo.
 Each row includes a terminal-friendly icon plus the tool's official site, and you can toggle items with arrow keys plus `Enter` or by pressing `1-9` and `0`.
 Re-running setup also migrates legacy OpenCode and Kilo patches to the current reasoning-capable provider path and refreshes OpenClaw model metadata.
 

package/dist/commands/logout.js

@@ -71,6 +71,8 @@ const THECLAWBAY_CANONICAL_API_HOST = "api.theclawbay.com";
 const THECLAWBAY_WEBSITE_HOSTS = new Set(["theclawbay.com", "www.theclawbay.com"]);
 const SUPPORTED_MODEL_IDS = new Set((0, supported_models_1.getSupportedModelIds)());
 const CONTINUE_MODEL_NAME = "The Claw Bay";
+const HERMES_PROVIDER_NAME = "The Claw Bay";
+const HERMES_KEY_ENV_NAME = "HERMES_THECLAWBAY_API_KEY";
 const TRAE_PATCH_MARKER = "theclawbay-trae-patch";
 const TRAE_BUNDLE_BACKUP_SUFFIX = ".theclawbay-managed-backup";
 const MANAGED_EDITOR_TERMINAL_ENV_NAMES = [
@@ -272,6 +274,36 @@ async function readFileIfExists(filePath) {
         throw error;
     }
 }
+function hermesHomeDir() {
+    const raw = process.env.HERMES_HOME?.trim();
+    if (raw)
+        return raw;
+    return node_path_1.default.join(node_os_1.default.homedir(), ".hermes");
+}
+function hermesConfigPath() {
+    return node_path_1.default.join(hermesHomeDir(), "config.yaml");
+}
+function hermesEnvPath() {
+    return node_path_1.default.join(hermesHomeDir(), ".env");
+}
+async function removeDotEnvValue(filePath, key) {
+    const existing = await readFileIfExists(filePath);
+    if (existing === null)
+        return false;
+    const nextLines = existing
+        .split(/\r?\n/)
+        .filter((line) => !new RegExp(`^\\s*${key}\\s*=`).test(line));
+    const next = `${nextLines.join("\n").trimEnd()}\n`;
+    const normalizedExisting = `${existing.trimEnd()}\n`;
+    if (next === normalizedExisting)
+        return false;
+    if (!next.trim()) {
+        return removeFileIfExists(filePath);
+    }
+    await promises_1.default.mkdir(node_path_1.default.dirname(filePath), { recursive: true });
+    await promises_1.default.writeFile(filePath, next, "utf8");
+    return true;
+}
 function localAppDataDir() {
     if (process.env.LOCALAPPDATA?.trim())
         return process.env.LOCALAPPDATA;
@@ -1308,6 +1340,85 @@ async function cleanupKiloConfig() {
         restoreStatePath: KILO_RESTORE_STATE_PATH,
     });
 }
+async function cleanupHermesConfig() {
+    const configPath = hermesConfigPath();
+    const envPath = hermesEnvPath();
+    const existingRaw = await readFileIfExists(configPath);
+    let configChanged = false;
+    let removedManagedProvider = false;
+    const removedProviderBaseUrls = new Set();
+    if (existingRaw !== null && existingRaw.trim()) {
+        try {
+            const existingConfig = objectRecordOr((0, yaml_1.parseDocument)(existingRaw).toJS(), {});
+            const nextConfig = { ...existingConfig };
+            const rawCustomProviders = Array.isArray(existingConfig.custom_providers)
+                ? existingConfig.custom_providers
+                : [];
+            const nextCustomProviders = rawCustomProviders.filter((entry) => {
+                if (typeof entry !== "object" || entry === null || Array.isArray(entry))
+                    return true;
+                const record = entry;
+                const name = typeof record.name === "string" ? record.name.trim() : "";
+                const providerBaseUrl = typeof record.base_url === "string" ? record.base_url.trim().replace(/\/+$/g, "") : "";
+                const keyEnv = typeof record.key_env === "string" ? record.key_env.trim() : "";
+                if (keyEnv === HERMES_KEY_ENV_NAME) {
+                    removedManagedProvider = true;
+                    if (providerBaseUrl)
+                        removedProviderBaseUrls.add(providerBaseUrl);
+                    return false;
+                }
+                if (name === HERMES_PROVIDER_NAME && isTheClawBayOpenAiCompatibleBaseUrl(providerBaseUrl)) {
+                    removedManagedProvider = true;
+                    if (providerBaseUrl)
+                        removedProviderBaseUrls.add(providerBaseUrl);
+                    return false;
+                }
+                return true;
+            });
+            if (nextCustomProviders.length !== rawCustomProviders.length) {
+                configChanged = true;
+            }
+            if (nextCustomProviders.length > 0) {
+                nextConfig.custom_providers = nextCustomProviders;
+            }
+            else if ("custom_providers" in nextConfig) {
+                delete nextConfig.custom_providers;
+                configChanged = true;
+            }
+            const modelConfig = objectRecordOr(existingConfig.model, {});
+            const provider = typeof modelConfig.provider === "string" ? modelConfig.provider.trim() : "";
+            const baseUrl = typeof modelConfig.base_url === "string" ? modelConfig.base_url.trim().replace(/\/+$/g, "") : "";
+            const apiMode = typeof modelConfig.api_mode === "string" ? modelConfig.api_mode.trim() : "";
+            const shouldRemoveManagedModel = provider === "custom" &&
+                (isTheClawBayOpenAiCompatibleBaseUrl(baseUrl) ||
+                    (removedManagedProvider && apiMode === "codex_responses" && removedProviderBaseUrls.has(baseUrl)));
+            if (shouldRemoveManagedModel) {
+                for (const key of ["provider", "default", "base_url", "api_mode", "api_key", "context_length"]) {
+                    if (key in modelConfig) {
+                        delete modelConfig[key];
+                        configChanged = true;
+                    }
+                }
+                if (Object.keys(modelConfig).length > 0) {
+                    nextConfig.model = modelConfig;
+                }
+                else if ("model" in nextConfig) {
+                    delete nextConfig.model;
+                    configChanged = true;
+                }
+            }
+            if (configChanged) {
+                await promises_1.default.mkdir(node_path_1.default.dirname(configPath), { recursive: true });
+                await promises_1.default.writeFile(configPath, (0, yaml_1.stringify)(nextConfig), "utf8");
+            }
+        }
+        catch {
+            // Leave invalid user config untouched; still remove our dedicated env key below.
+        }
+    }
+    const envChanged = await removeDotEnvValue(envPath, HERMES_KEY_ENV_NAME);
+    return configChanged || envChanged;
+}
 async function cleanupTraeBundle() {
     const bundlePath = traeBundlePath();
     if (!bundlePath)
@@ -1359,6 +1470,7 @@ class LogoutCommand extends base_command_1.BaseCommand {
             let updatedOpenCodeConfig = false;
             let updatedKiloConfig = false;
             let updatedRooConfig = false;
+            let updatedHermesConfig = false;
             let updatedTraeBundle = false;
             let updatedAiderConfig = false;
             let sessionMigration;
@@ -1436,6 +1548,8 @@ class LogoutCommand extends base_command_1.BaseCommand {
                 updatedKiloConfig = await cleanupKiloConfig();
                 progress.update("Reverting Roo Code");
                 updatedRooConfig = await cleanupRooConfig();
+                progress.update("Reverting Hermes");
+                updatedHermesConfig = await cleanupHermesConfig();
                 progress.update("Reverting Trae");
                 updatedTraeBundle = await cleanupTraeBundle();
                 progress.update("Reverting Aider");
@@ -1491,6 +1605,8 @@ class LogoutCommand extends base_command_1.BaseCommand {
                 revertedTargets.push("Kilo Code");
             if (updatedRooConfig)
                 revertedTargets.push("Roo Code");
+            if (updatedHermesConfig)
+                revertedTargets.push("Hermes");
             if (updatedTraeBundle)
                 revertedTargets.push("Trae");
             if (updatedAiderConfig)
@@ -1595,6 +1711,7 @@ class LogoutCommand extends base_command_1.BaseCommand {
             this.log(`- OpenCode config cleaned: ${updatedOpenCodeConfig ? "yes" : "no"}`);
             this.log(`- Kilo config cleaned: ${updatedKiloConfig ? "yes" : "no"}`);
             this.log(`- Roo Code setup hook cleaned: ${updatedRooConfig ? "yes" : "no"}`);
+            this.log(`- Hermes config cleaned: ${updatedHermesConfig ? "yes" : "no"}`);
             this.log(`- Trae experimental patch cleaned: ${updatedTraeBundle ? "yes" : "no"}`);
             this.log(`- Aider config cleaned: ${updatedAiderConfig ? "yes" : "no"}`);
             this.log("Note: restart terminals/VS Code windows to clear already-loaded shell environment.");

package/dist/commands/setup.js

@@ -36,6 +36,7 @@ const DEFAULT_ROO_MODEL = DEFAULT_CODEX_MODEL;
 const DEFAULT_TRAE_MODEL = DEFAULT_CODEX_MODEL;
 const DEFAULT_AIDER_MODEL = DEFAULT_CODEX_MODEL;
 const DEFAULT_ZO_MODEL = DEFAULT_CODEX_MODEL;
+const DEFAULT_HERMES_MODEL = DEFAULT_CODEX_MODEL;
 const DEFAULT_MODELS = [...SUPPORTED_MODEL_IDS];
 const PREFERRED_MODELS = [...SUPPORTED_MODEL_IDS];
 const ENV_KEY_NAME = "THECLAWBAY_API_KEY";
@@ -92,7 +93,7 @@ const SHELL_END = "# theclawbay-shell-managed:end";
 const OPENCLAW_PROVIDER_ID = DEFAULT_PROVIDER_ID;
 const HISTORY_PROVIDER_NEUTRALIZE_SOURCES = new Set(["openai", "theclawbay-wan", DEFAULT_PROVIDER_ID]);
 const HISTORY_PROVIDER_DB_MIGRATE_SOURCES = ["openai", DEFAULT_PROVIDER_ID, "theclawbay-wan"];
-const SETUP_CLIENT_IDS = ["codex", "claude", "continue", "cline", "gsd", "openclaw", "opencode", "kilo", "roo", "trae", "aider", "zo"];
+const SETUP_CLIENT_IDS = ["codex", "claude", "continue", "cline", "gsd", "openclaw", "opencode", "kilo", "roo", "trae", "aider", "zo", "hermes"];
 const LEGACY_THECLAWBAY_OPENAI_PROXY_SUFFIX = "/api/codex-auth/v1/proxy/v1";
 const CANONICAL_THECLAWBAY_OPENAI_PROXY_SUFFIX = "/v1";
 const CANONICAL_CODEX_NATIVE_PROXY_SUFFIX = "/backend-api/codex";
@@ -113,6 +114,8 @@ const ZO_CONFIG_NAME_PREFIX = "The Claw Bay";
 const ZO_COOKIE_HOST = ".zo.computer";
 const ZO_ACCESS_TOKEN_COOKIE = "access_token";
 const ZO_API_BASE_URL = "https://api.zo.computer";
+const HERMES_PROVIDER_NAME = "The Claw Bay";
+const HERMES_KEY_ENV_NAME = "HERMES_THECLAWBAY_API_KEY";
 function trimTrailingSlash(value) {
     return value.replace(/\/+$/g, "");
 }
@@ -1511,6 +1514,111 @@ async function detectZoClient() {
     }
     return false;
 }
+function hermesHomeDir() {
+    const raw = process.env.HERMES_HOME?.trim();
+    if (raw)
+        return raw;
+    return node_path_1.default.join(node_os_1.default.homedir(), ".hermes");
+}
+function hermesConfigPath() {
+    return node_path_1.default.join(hermesHomeDir(), "config.yaml");
+}
+function hermesEnvPath() {
+    return node_path_1.default.join(hermesHomeDir(), ".env");
+}
+async function detectHermesClient() {
+    if (hasCommand("hermes"))
+        return true;
+    const candidates = [
+        hermesHomeDir(),
+        hermesConfigPath(),
+        hermesEnvPath(),
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate))
+            return true;
+    }
+    return false;
+}
+function formatDotEnvValue(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+async function upsertDotEnvValue(filePath, key, value) {
+    const existing = (await readFileIfExists(filePath)) ?? "";
+    const lines = existing ? existing.split(/\r?\n/) : [];
+    const assignment = `${key}=${formatDotEnvValue(value)}`;
+    let changed = false;
+    let replaced = false;
+    const nextLines = lines.map((line) => {
+        if (new RegExp(`^\\s*${key}\\s*=`).test(line)) {
+            replaced = true;
+            if (line === assignment)
+                return line;
+            changed = true;
+            return assignment;
+        }
+        return line;
+    });
+    if (!replaced) {
+        if (nextLines.length > 0 && nextLines[nextLines.length - 1]?.trim()) {
+            nextLines.push("");
+        }
+        nextLines.push(assignment);
+        changed = true;
+    }
+    if (!changed)
+        return false;
+    await promises_1.default.mkdir(node_path_1.default.dirname(filePath), { recursive: true });
+    await promises_1.default.writeFile(filePath, `${nextLines.join("\n").trimEnd()}\n`, "utf8");
+    return true;
+}
+async function writeHermesConfig(params) {
+    const configPath = hermesConfigPath();
+    const envPath = hermesEnvPath();
+    const baseUrl = openAiCompatibleProxyUrl(params.backendUrl);
+    const selectedModel = params.model.trim() || DEFAULT_HERMES_MODEL;
+    const existingRaw = await readFileIfExists(configPath);
+    const existingConfig = existingRaw?.trim()
+        ? objectRecordOr((0, yaml_1.parseDocument)(existingRaw).toJS(), {})
+        : {};
+    const nextConfig = { ...existingConfig };
+    const modelConfig = objectRecordOr(existingConfig.model, {});
+    modelConfig.provider = "custom";
+    modelConfig.default = selectedModel;
+    modelConfig.base_url = baseUrl;
+    modelConfig.api_mode = "codex_responses";
+    delete modelConfig.api_key;
+    delete modelConfig.context_length;
+    nextConfig.model = modelConfig;
+    const rawCustomProviders = Array.isArray(existingConfig.custom_providers)
+        ? existingConfig.custom_providers
+        : [];
+    const nextCustomProviders = rawCustomProviders.filter((entry) => {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry))
+            return true;
+        const record = entry;
+        const name = typeof record.name === "string" ? record.name.trim() : "";
+        const providerBaseUrl = typeof record.base_url === "string" ? record.base_url.trim() : "";
+        const keyEnv = typeof record.key_env === "string" ? record.key_env.trim() : "";
+        if (keyEnv === HERMES_KEY_ENV_NAME)
+            return false;
+        if (name === HERMES_PROVIDER_NAME && providerBaseUrl === baseUrl)
+            return false;
+        return true;
+    });
+    nextCustomProviders.push({
+        name: HERMES_PROVIDER_NAME,
+        base_url: baseUrl,
+        key_env: HERMES_KEY_ENV_NAME,
+        model: selectedModel,
+        api_mode: "codex_responses",
+    });
+    nextConfig.custom_providers = nextCustomProviders;
+    await promises_1.default.mkdir(node_path_1.default.dirname(configPath), { recursive: true });
+    await promises_1.default.writeFile(configPath, (0, yaml_1.stringify)(nextConfig), "utf8");
+    await upsertDotEnvValue(envPath, HERMES_KEY_ENV_NAME, params.apiKey);
+    return [configPath, envPath];
+}
 async function resolveModels(backendUrl, apiKey) {
     const { ids, failure } = await fetchBackendModelIds(backendUrl, apiKey);
     const available = new Set(ids ?? []);
@@ -1594,9 +1702,6 @@ async function writeCodexConfig(params) {
     next = removeTopLevelKeyLineIf(next, "chatgpt_base_url", isTheClawBayChatgptBaseUrl);
     const managedBlock = appendManagedBlock("", [
         MANAGED_START,
-        `[plugins."computer-use@openai-bundled"]`,
-        "enabled = true",
-        "",
         `[model_providers.${DEFAULT_PROVIDER_ID}]`,
         'name = "The Claw Bay (OpenAI compatible)"',
         `base_url = "${nativeCodexBaseUrl}"`,
@@ -2895,7 +3000,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 managed?.backendUrl ??
                 DEFAULT_BACKEND_URL;
             const backendUrl = normalizeUrl(backendRaw, "--backend");
-            const [codexDetected, claudeDetected, continueDetected, clineDetected, gsdDetected, openCodeDetected, kiloDetected, rooDetected, traeDetected, aiderDetected, zoDetected] = await Promise.all([
+            const [codexDetected, claudeDetected, continueDetected, clineDetected, gsdDetected, openCodeDetected, kiloDetected, rooDetected, traeDetected, aiderDetected, zoDetected, hermesDetected] = await Promise.all([
                 detectCodexClient(),
                 detectClaudeClient(),
                 detectContinueClient(),
@@ -2907,6 +3012,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 detectTraeClient(),
                 detectAiderClient(),
                 detectZoClient(),
+                detectHermesClient(),
             ]);
             const setupClients = [
                 {
@@ -3017,6 +3123,15 @@ class SetupCommand extends base_command_1.BaseCommand {
                     icon: "◉",
                     siteUrl: "https://www.zo.computer",
                 },
+                {
+                    id: "hermes",
+                    label: "Hermes Agent",
+                    summaryLabel: "Hermes",
+                    detected: hermesDetected,
+                    recommended: true,
+                    icon: "☿",
+                    siteUrl: "https://hermes-agent.nousresearch.com/docs/",
+                },
             ];
             const selectedSetupClients = await resolveSetupClientSelection({
                 setupClients,
@@ -3085,6 +3200,7 @@ class SetupCommand extends base_command_1.BaseCommand {
             let traeBundlePathPatched = null;
             let aiderConfigPath = null;
             let zoConfigName = null;
+            let hermesConfigPaths = [];
             try {
                 if (selectedSetupClients.size > 0) {
                     progress.update("Resolving supported models");
@@ -3275,6 +3391,14 @@ class SetupCommand extends base_command_1.BaseCommand {
                         apiKey: authCredential,
                     });
                 }
+                if (selectedSetupClients.has("hermes")) {
+                    progress.update("Configuring Hermes Agent");
+                    hermesConfigPaths = await writeHermesConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_HERMES_MODEL,
+                        apiKey: authCredential,
+                    });
+                }
             }
             catch (error) {
                 progress.fail("Setup failed");
@@ -3305,6 +3429,9 @@ class SetupCommand extends base_command_1.BaseCommand {
             if (selectedSetupClients.has("zo")) {
                 summaryNotes.add("Zo uses an experimental account-level BYOK API integration. Keep Zo signed in while running setup.");
             }
+            if (selectedSetupClients.has("hermes")) {
+                summaryNotes.add("Hermes Agent: added a named custom provider that uses HERMES_THECLAWBAY_API_KEY, so Hermes can keep its custom-endpoint routing without depending on OPENAI_BASE_URL.");
+            }
             if (openClawCliWarning)
                 summaryNotes.add(openClawCliWarning);
             if ((stateDbMigration?.failed.length ?? 0) > 0) {
@@ -3554,6 +3681,16 @@ class SetupCommand extends base_command_1.BaseCommand {
             else {
                 this.log("- Zo: not detected (skipped)");
             }
+            if (selectedSetupClients.has("hermes")) {
+                this.log(`- Hermes Agent: configured (${hermesConfigPaths.join(", ")})`);
+                this.log("- Hermes Agent note: saved a named custom provider plus HERMES_THECLAWBAY_API_KEY so Hermes can reuse its custom-provider credential-pool path without relying on OPENAI_BASE_URL.");
+            }
+            else if (hermesDetected) {
+                this.log("- Hermes Agent: detected but skipped");
+            }
+            else {
+                this.log("- Hermes Agent: not detected (skipped)");
+            }
             if (selectedSetupClients.has("claude")) {
                 this.log(`- Claude Code: ${claudeAccess?.enabled ? "configured via shared env" : "selected, but no Claude access was detected for this credential"}`);
             }
@@ -3585,7 +3722,7 @@ SetupCommand.flags = {
     }),
     clients: core_1.Flags.string({
         required: false,
-        description: "Detected local clients to configure: codex, claude, continue, cline, gsd, openclaw, opencode, kilo, roo, trae, aider, zo",
+        description: "Detected local clients to configure: codex, claude, continue, cline, gsd, openclaw, opencode, kilo, roo, trae, aider, zo, hermes",
     }),
     yes: core_1.Flags.boolean({
         required: false,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "theclawbay",
-  "version": "0.3.75",
-  "description": "CLI for connecting Codex, Gemini-compatible apps, Continue, Cline, GSD, OpenClaw, OpenCode, Kilo, Roo Code, Aider, experimental Trae, and experimental Zo to The Claw Bay.",
+  "version": "0.3.77",
+  "description": "CLI for connecting Codex, Hermes Agent, Gemini-compatible apps, Continue, Cline, GSD, OpenClaw, OpenCode, Kilo, Roo Code, Aider, experimental Trae, and experimental Zo to The Claw Bay.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/RCRTCBHAL900/TheClawBay.git"
+    "url": "https://github.com/RCRTCBHAL900/TheClawBay"
   },
   "bin": {
     "theclawbay": "dist/index.js"
@@ -40,6 +40,7 @@
     "api-key",
     "continue",
     "cline",
+    "hermes",
     "gsd",
     "openclaw",
     "opencode",