agentsw 0.9.2 → 0.10.0

package/dist/targets/hermes.js

@@ -1,20 +1,14 @@
 import fs from "node:fs";
-import path from "node:path";
 import YAML from "yaml";
-import { backupFile, home, localAppDataDir, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { backupFile, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { hermesConfigFile, hermesDir, hermesEnvFile } from "../app-paths.js";
 import { envAssignments, removeEnvAssignments, upsertEnvAssignment } from "../envfile.js";
 import { isManagedCredentialRef, legacyManagedCredentialRef, managedCredentialRef } from "../provider-identity.js";
 import { transactionalTarget } from "../target-transaction.js";
 import { parseYamlMapping, serializeYamlMapping } from "../yaml.js";
 import { sdkBaseUrl } from "./wire.js";
 function hermesHome() {
-    const env = process.env.HERMES_HOME?.trim();
-    if (env)
-        return env;
-    if (process.platform === "win32") {
-        return localAppDataDir("hermes");
-    }
-    return path.join(home, ".hermes");
+    return hermesDir();
 }
 function parseConfig(file, text) {
     const doc = parseYamlMapping(file, text);
@@ -58,12 +52,11 @@ export const hermes = transactionalTarget({
     id: "hermes",
     name: "Hermes",
     protocols: ["openai", "anthropic"],
-    configPaths: [path.join(hermesHome(), "config.yaml"), path.join(hermesHome(), ".env")],
+    configPaths: [hermesConfigFile(), hermesEnvFile()],
     detect: () => fs.existsSync(hermesHome()),
     async apply(provider) {
-        const home = hermesHome();
-        const configFile = path.join(home, "config.yaml");
-        const envFile = path.join(home, ".env");
+        const configFile = hermesConfigFile();
+        const envFile = hermesEnvFile();
         const notes = [];
         const text = readTextIfExists(configFile);
         const doc = parseConfig(configFile, text);
@@ -133,9 +126,8 @@ export const hermes = transactionalTarget({
         return { app: this.id, changed: [configFile, envFile], notes };
     },
     async prune(provider) {
-        const home = hermesHome();
-        const configFile = path.join(home, "config.yaml");
-        const envFile = path.join(home, ".env");
+        const configFile = hermesConfigFile();
+        const envFile = hermesEnvFile();
         const doc = parseConfig(configFile, readTextIfExists(configFile));
         const at = ["providers", provider.id];
         const hasProvider = doc.hasIn(at);
@@ -176,7 +168,7 @@ export const hermes = transactionalTarget({
         return changed.length ? { app: this.id, changed, notes } : { app: this.id, changed, notes, skipped: `no providers.${provider.id} entry or managed credential` };
     },
     current() {
-        const text = readTextIfExists(path.join(hermesHome(), "config.yaml"));
+        const text = readTextIfExists(hermesConfigFile());
         if (!text)
             return undefined;
         try {
@@ -190,8 +182,7 @@ export const hermes = transactionalTarget({
         }
     },
     candidates() {
-        const hh = hermesHome();
-        const text = readTextIfExists(path.join(hh, "config.yaml"));
+        const text = readTextIfExists(hermesConfigFile());
         if (!text)
             return [];
         let parsed;
@@ -203,7 +194,7 @@ export const hermes = transactionalTarget({
         }
         if (!parsed?.providers)
             return [];
-        const envFile = path.join(hh, ".env");
+        const envFile = hermesEnvFile();
         const envText = readTextIfExists(envFile) ?? "";
         const values = new Map(envAssignments(envFile, envText).map((assignment) => [assignment.name, assignment.value]));
         const readEnv = (key) => process.env[key] ?? values.get(key);

package/dist/targets/omp.js

@@ -1,16 +1,18 @@
 import fs from "node:fs";
-import path from "node:path";
 import YAML from "yaml";
-import { backupFile, home, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { backupFile, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { ompAgentDir, ompModelsFiles } from "../app-paths.js";
 import { looksLikeEnvName } from "../slug.js";
 import { transactionalTarget } from "../target-transaction.js";
 import { parseYamlMapping, serializeYamlMapping } from "../yaml.js";
 import { apiValue, classifyApi, entryApi, mergeModels, sdkBaseUrl, stripConflictingOverrides } from "./wire.js";
 /** Per-model keys this adapter writes; one that stops being emitted is cleared, not inherited. */
 const OWNED_MODEL_KEYS = ["id", "name", "reasoning", "input", "contextWindow", "maxTokens", "cost"];
-const agentDir = path.join(home, ".omp", "agent");
-const modelsYml = path.join(agentDir, "models.yml");
-const modelsYaml = path.join(agentDir, "models.yaml");
+/** omp has no directory override; the file set is shared with remove/rename. */
+function modelFiles() {
+    const [yml, yaml] = ompModelsFiles();
+    return [yml, yaml];
+}
 function parseModelsDocument(file, text) {
     const doc = parseYamlMapping(file, text);
     if (doc.hasIn(["providers"]) && !YAML.isMap(doc.getIn(["providers"]))) {
@@ -26,11 +28,14 @@ export const omp = transactionalTarget({
     id: "omp",
     name: "Oh My Pi",
     protocols: ["openai", "anthropic"],
-    configPaths: [modelsYml],
-    detect: () => fs.existsSync(path.join(home, ".omp")),
+    get configPaths() {
+        return [modelFiles()[0]];
+    },
+    detect: () => fs.existsSync(ompAgentDir()),
     async apply(provider) {
         const notes = [];
         // Respect an existing models.yaml if models.yml is absent (omp precedence: yml then yaml).
+        const [modelsYml, modelsYaml] = modelFiles();
         const file = !fs.existsSync(modelsYml) && fs.existsSync(modelsYaml) ? modelsYaml : modelsYml;
         const text = readTextIfExists(file);
         const doc = parseModelsDocument(file, text);
@@ -92,6 +97,7 @@ export const omp = transactionalTarget({
         return { app: this.id, changed: [file], notes };
     },
     async prune(provider) {
+        const [modelsYml, modelsYaml] = modelFiles();
         const file = fs.existsSync(modelsYml) ? modelsYml : fs.existsSync(modelsYaml) ? modelsYaml : undefined;
         if (!file)
             return { app: this.id, changed: [], notes: [], skipped: "no models.yml" };
@@ -109,6 +115,7 @@ export const omp = transactionalTarget({
         return { app: this.id, changed: [file], notes };
     },
     current() {
+        const [modelsYml, modelsYaml] = modelFiles();
         const file = fs.existsSync(modelsYml) ? modelsYml : fs.existsSync(modelsYaml) ? modelsYaml : undefined;
         if (!file)
             return undefined;
@@ -122,6 +129,7 @@ export const omp = transactionalTarget({
         }
     },
     candidates() {
+        const [modelsYml, modelsYaml] = modelFiles();
         const file = fs.existsSync(modelsYml) ? modelsYml : fs.existsSync(modelsYaml) ? modelsYaml : undefined;
         if (!file)
             return [];

package/dist/targets/opencode.js

@@ -1,27 +1,34 @@
 import fs from "node:fs";
-import path from "node:path";
-import { appDataDir, backupFile, expandHome, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
-import { isJsonObject } from "../jsonc.js";
+import { backupFile, readTextIfExists, writeFileAtomic } from "../fsutil.js";
+import { isJsonObject, readJsoncObject, editJsoncObject } from "../jsonc.js";
+import { opencodeConfigDirs, opencodeConfigFiles, opencodePrimaryConfigFile } from "../app-paths.js";
 import { transactionalTarget } from "../target-transaction.js";
-const customDir = process.env.OPENCODE_CONFIG_DIR?.trim();
-const configFile = customDir
-    ? path.join(expandHome(customDir), "opencode.json")
-    : path.join(appDataDir("opencode"), "opencode.json");
 /**
- * opencode: custom providers in ~/.config/opencode/opencode.json "provider" map,
- * backed by @ai-sdk/openai-compatible or @ai-sdk/anthropic npm loaders.
+ * opencode: custom providers in the "provider" map of its config document
+ * (opencode.json / opencode.jsonc / config.json under $OPENCODE_CONFIG_DIR or the
+ * default directory; $OPENCODE_CONFIG names one file explicitly), backed by
+ * @ai-sdk/openai-compatible or @ai-sdk/anthropic npm loaders. A JSONC round-trip
+ * keeps comments and every key agentsw does not own.
  */
 export const opencode = transactionalTarget({
     id: "opencode",
     name: "opencode",
     protocols: ["openai", "anthropic"],
-    configPaths: [configFile],
-    detect: () => fs.existsSync(path.dirname(configFile)),
+    get configPaths() {
+        return [opencodePrimaryConfigFile()];
+    },
+    detect: () => opencodeConfigFiles().some((file) => fs.existsSync(file)) ||
+        opencodeConfigDirs().some((dir) => fs.existsSync(dir)),
     async apply(provider) {
+        const configFile = opencodePrimaryConfigFile();
         const notes = [];
-        const configValue = readJsonIfExists(configFile);
-        const config = configValue === undefined ? { $schema: "https://opencode.ai/config.json" } : configValue;
-        if (!isJsonObject(config) || (config.provider !== undefined && !isJsonObject(config.provider))) {
+        const existed = readTextIfExists(configFile) !== undefined;
+        const document = readJsoncObject(configFile);
+        // Only a missing file is initialized with the schema hint; an existing {} stays as-is.
+        const config = existed
+            ? { ...document.value }
+            : { $schema: "https://opencode.ai/config.json" };
+        if (config.provider !== undefined && !isJsonObject(config.provider)) {
             throw new Error(`${configFile}: expected config and provider to be JSON objects`);
         }
         const anthropic = provider.protocol === "anthropic";
@@ -88,26 +95,36 @@ export const opencode = transactionalTarget({
         };
         config.provider = providerMap;
         config.model = `${provider.id}/${provider.defaultModel}`;
-        if (provider.smallModel)
+        if (provider.smallModel) {
             config.small_model = `${provider.id}/${provider.smallModel}`;
+        }
+        else if (typeof config.small_model === "string" && config.small_model.startsWith(`${provider.id}/`)) {
+            // This provider's own previous small model is obsolete; another provider's
+            // entry stays untouched, exactly as prune scopes its cleanup.
+            delete config.small_model;
+        }
         const backup = backupFile(configFile);
         if (backup)
             notes.push(`backup: ${backup}`);
-        writeFileAtomic(configFile, JSON.stringify(config, null, 2) + "\n");
+        writeFileAtomic(configFile, editJsoncObject(document, config));
         return { app: this.id, changed: [configFile], notes };
     },
     async prune(provider) {
-        const config = readJsonIfExists(configFile);
-        if (config !== undefined && (!isJsonObject(config) || (config.provider !== undefined && !isJsonObject(config.provider)))) {
+        const configFile = opencodePrimaryConfigFile();
+        const document = readJsoncObject(configFile);
+        const config = { ...document.value };
+        if (config.provider !== undefined && !isJsonObject(config.provider)) {
             throw new Error(`${configFile}: expected config and provider to be JSON objects`);
         }
-        const providerMap = config?.provider;
-        if (!config || !providerMap?.[provider.id]) {
+        const providerMap = { ...config.provider };
+        if (!providerMap[provider.id]) {
             return { app: this.id, changed: [], notes: [], skipped: `no provider.${provider.id} entry` };
         }
         delete providerMap[provider.id];
         if (Object.keys(providerMap).length === 0)
             delete config.provider;
+        else
+            config.provider = providerMap;
         const notes = [];
         if (typeof config.model === "string" && config.model.startsWith(`${provider.id}/`)) {
             delete config.model;
@@ -119,16 +136,16 @@ export const opencode = transactionalTarget({
         const backup = backupFile(configFile);
         if (backup)
             notes.push(`backup: ${backup}`);
-        writeFileAtomic(configFile, JSON.stringify(config, null, 2) + "\n");
+        writeFileAtomic(configFile, editJsoncObject(document, config));
         return { app: this.id, changed: [configFile], notes };
     },
     current() {
-        const config = readJsonIfExists(configFile);
-        return config?.model;
+        const config = readJsoncObject(opencodePrimaryConfigFile()).value;
+        return typeof config.model === "string" ? config.model : undefined;
     },
     candidates() {
-        const config = readJsonIfExists(configFile);
-        if (!config?.provider)
+        const config = readJsoncObject(opencodePrimaryConfigFile()).value;
+        if (!config.provider)
             return [];
         const activeProvider = config.model?.includes("/") ? config.model.split("/")[0] : undefined;
         const activeModel = activeProvider && config.model && config.model.includes("/") ? config.model.split("/").slice(1).join("/") : undefined;

package/dist/targets/pistyle.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
-import { backupFile, home, writeFileAtomic } from "../fsutil.js";
+import { backupFile, writeFileAtomic } from "../fsutil.js";
+import { piDir, piModelsFile, piSettingsFile } from "../app-paths.js";
 import { editJsoncObject, isJsonObject, readJsoncObject } from "../jsonc.js";
 import { looksLikeEnvName } from "../slug.js";
 import { transactionalTarget } from "../target-transaction.js";
@@ -57,17 +58,15 @@ function thinkingLevelMap(efforts) {
     return map;
 }
 export function piStyleTarget(opts) {
-    const resolveDir = () => {
-        const env = process.env[opts.dirEnvVar];
-        if (env)
-            return env.startsWith("~") ? path.join(home, env.slice(1)) : env;
-        return path.join(home, opts.configDirName);
-    };
+    const id = opts.id;
+    const resolveDir = () => piDir(id);
     return transactionalTarget({
         id: opts.id,
         name: opts.name,
         protocols: ["openai", "anthropic"],
-        configPaths: [path.join(resolveDir(), "models.json"), path.join(resolveDir(), "settings.json")],
+        get configPaths() {
+            return [piModelsFile(id), piSettingsFile(id)];
+        },
         detect: () => fs.existsSync(path.dirname(resolveDir())),
         async apply(provider) {
             const dir = resolveDir();
@@ -232,15 +231,5 @@ export function piStyleTarget(opts) {
         },
     });
 }
-export const pi = piStyleTarget({
-    id: "pi",
-    name: "pi",
-    configDirName: ".pi/agent",
-    dirEnvVar: "PI_CODING_AGENT_DIR",
-});
-export const prime = piStyleTarget({
-    id: "prime",
-    name: "prime-agent",
-    configDirName: ".prime/agent",
-    dirEnvVar: "PRIME_AGENT_CODING_AGENT_DIR",
-});
+export const pi = piStyleTarget({ id: "pi", name: "pi" });
+export const prime = piStyleTarget({ id: "prime", name: "prime-agent" });

package/dist/targets/workbuddy.js

@@ -1,13 +1,13 @@
 import fs from "node:fs";
 import path from "node:path";
-import { appDataDir, backupFile, home, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
+import { backupFile, readJsonIfExists, writeFileAtomic } from "../fsutil.js";
 import { isJsonObject } from "../jsonc.js";
+import { workbuddyDir } from "../app-paths.js";
 import { localProviderId } from "../provider-identity.js";
 import { providerIdFromBaseUrl, providerNameFromBaseUrl } from "../slug.js";
 import { transactionalTarget } from "../target-transaction.js";
 function configDir() {
-    return process.env.WORKBUDDY_CONFIG_DIR?.trim() || process.env.CODEBUDDY_CONFIG_DIR?.trim() ||
-        (process.platform === "win32" ? appDataDir("workbuddy") : path.join(home, ".workbuddy"));
+    return workbuddyDir();
 }
 function isModel(row) {
     return isJsonObject(row) && typeof row.id === "string";
@@ -74,7 +74,9 @@ export const workbuddy = transactionalTarget({
     id: "workbuddy",
     name: "WorkBuddy",
     protocols: ["openai"],
-    configPaths: [path.join(configDir(), "models.json"), path.join(configDir(), "settings.json")],
+    get configPaths() {
+        return [path.join(configDir(), "models.json"), path.join(configDir(), "settings.json")];
+    },
     detect: () => fs.existsSync(configDir()),
     async apply(provider) {
         const dir = configDir();

package/dist/ui.js

@@ -0,0 +1,157 @@
+import pc from "picocolors";
+import { t } from "./i18n.js";
+/** Thrown by cancelInteractive() inside the menu so a Ctrl-C returns to the menu instead of exiting. */
+export class ActionCancelled extends Error {
+    constructor() {
+        super("cancelled");
+        this.name = "ActionCancelled";
+    }
+}
+let json = false;
+let quiet = false;
+let version = "";
+let command = "";
+let inMenu = false;
+export function configureOutput(config) {
+    if (config.json !== undefined)
+        json = config.json;
+    if (config.quiet !== undefined)
+        quiet = config.quiet;
+    if (config.version !== undefined)
+        version = config.version;
+}
+export function setCommandName(name) {
+    command = name;
+}
+export function setInMenu(value) {
+    inMenu = value;
+}
+export function isJson() {
+    return json;
+}
+export function isQuiet() {
+    return quiet;
+}
+/** Primary result channel. Machine mode suppresses it so stdout carries exactly one JSON document. */
+export function out(line = "") {
+    if (json)
+        return;
+    console.log(line);
+}
+/** Dimmed guidance ("next: ...", "run agentsw sync"). Dropped by --quiet and --json. */
+export function note(message) {
+    if (json || quiet)
+        return;
+    process.stderr.write(pc.dim(message) + "\n");
+}
+/** Non-fatal problem. Keeps the literal "warning: " prefix callers and tests rely on. */
+export function warn(message) {
+    if (json || quiet)
+        return;
+    process.stderr.write(pc.yellow(`warning: ${message}`) + "\n");
+}
+function emitJsonError(message) {
+    process.stdout.write(JSON.stringify({ ok: false, command, version, error: { message } }) + "\n");
+}
+export function emitJson(data) {
+    process.stdout.write(JSON.stringify({ ok: true, command, version, data }) + "\n");
+}
+/** Fatal error. In machine mode the failure becomes the single stdout document, so pipes stay parseable. */
+export function error(message) {
+    if (json)
+        emitJsonError(message);
+    else
+        process.stderr.write(pc.red(`error: ${message}`) + "\n");
+    process.exit(1);
+}
+/**
+ * Ctrl-C / Esc at an interactive prompt. Inside the menu this unwinds to the dispatch loop, which keeps the
+ * session alive; standalone it exits 130 (the SIGINT convention), so a cancelled run is never mistaken for
+ * a successful one. Prompts awaits onCancel inside a catch, so throwing here reliably rejects the prompt.
+ */
+export function cancelInteractive() {
+    if (inMenu)
+        throw new ActionCancelled();
+    process.stderr.write(pc.dim(t("common.cancelled")) + "\n");
+    process.exit(130);
+}
+/** 0 means "no known width" (pipe, file, test runner), which disables truncation entirely. */
+export function terminalWidth() {
+    const columns = process.stdout.columns;
+    return typeof columns === "number" && Number.isFinite(columns) && columns > 0 ? columns : 0;
+}
+const SGR = /\u001b\[[0-9;]*m/g;
+export function visibleWidth(text) {
+    return text.replace(SGR, "").length;
+}
+/** Clip to a visible width without ever cutting inside an SGR sequence; closes color that was left open. */
+export function truncateVisible(text, max) {
+    if (max <= 0)
+        return "";
+    if (visibleWidth(text) <= max)
+        return text;
+    const target = Math.max(0, max - 1);
+    let out = "";
+    let visible = 0;
+    let colored = false;
+    for (let i = 0; i < text.length && visible < target;) {
+        if (text.charAt(i) === "\u001b") {
+            const match = /^\u001b\[[0-9;]*m/.exec(text.slice(i));
+            if (match) {
+                out += match[0];
+                colored = true;
+                i += match[0].length;
+                continue;
+            }
+        }
+        out += text.charAt(i);
+        visible++;
+        i++;
+    }
+    return `${out}…${colored ? "\u001b[0m" : ""}`;
+}
+export function padCell(text, width, align = "left") {
+    const padding = " ".repeat(Math.max(0, width - visibleWidth(text)));
+    return align === "right" ? padding + text : text + padding;
+}
+export function table(rows, header, options = {}) {
+    const all = header ? [header, ...rows] : rows;
+    if (all.length === 0)
+        return "";
+    const widths = [];
+    for (const row of all) {
+        row.forEach((cell, i) => {
+            widths[i] = Math.max(widths[i] ?? 0, visibleWidth(cell));
+        });
+    }
+    const minWidth = options.minWidth ?? 8;
+    const width = options.width ?? terminalWidth();
+    const eligible = (options.truncate ?? []).filter((i) => i < widths.length);
+    if (width > 0 && eligible.length > 0) {
+        const total = () => widths.reduce((sum, w, i) => sum + w + (i > 0 ? 2 : 0), 0);
+        while (total() > width) {
+            let widest = -1;
+            for (const i of eligible) {
+                if ((widths[i] ?? 0) <= minWidth)
+                    continue;
+                if (widest === -1 || (widths[i] ?? 0) > (widths[widest] ?? 0))
+                    widest = i;
+            }
+            if (widest === -1)
+                break;
+            widths[widest] = (widths[widest] ?? 0) - 1;
+        }
+    }
+    const render = (row) => row
+        .map((cell, i) => {
+        const column = widths[i] ?? 0;
+        const clipped = visibleWidth(cell) > column ? truncateVisible(cell, column) : cell;
+        return padCell(clipped, column, options.align?.[i] ?? "left");
+    })
+        .join("  ")
+        .trimEnd();
+    const lines = all.map(render);
+    if (header)
+        lines.splice(1, 0, widths.map((w) => "-".repeat(w)).join("  "));
+    return lines.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsw",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "CLI provider switcher for coding agents: manage OpenAI/Anthropic-protocol providers in one place and sync them, with models.dev metadata, into Claude Code, Codex, omp, pi, prime-agent, opencode, Hermes, WorkBuddy and DeepSeek Harness",
   "type": "module",
   "repository": {
@@ -37,7 +37,7 @@
     "prepublishOnly": "npm run build",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx --test test/*.test.ts"
+    "test": "tsx --import ./test/setup.ts --test test/*.test.ts"
   },
   "dependencies": {
     "commander": "^15.0.0",