@dexto/agent-management 1.2.5

package/dist/writer.js

@@ -0,0 +1,146 @@
+import { promises as fs } from "fs";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import * as path from "path";
+import { logger } from "@dexto/core";
+import { ConfigError } from "./config/index.js";
+async function writeConfigFile(configPath, config) {
+  const absolutePath = path.resolve(configPath);
+  try {
+    const yamlContent = stringifyYaml(config, { indent: 2 });
+    await fs.writeFile(absolutePath, yamlContent, "utf-8");
+    logger.debug(`Wrote dexto config to: ${absolutePath}`);
+  } catch (error) {
+    throw ConfigError.fileWriteError(
+      absolutePath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+async function writeLLMPreferences(configPath, preferences, overrides) {
+  logger.debug(`Writing LLM preferences to: ${configPath}`, {
+    provider: overrides?.provider ?? preferences.llm.provider,
+    model: overrides?.model ?? preferences.llm.model,
+    hasApiKeyOverride: Boolean(overrides?.apiKey),
+    hasPreferenceApiKey: Boolean(preferences.llm.apiKey)
+  });
+  logger.debug(`Reading config file: ${configPath}`);
+  let fileContent;
+  try {
+    fileContent = await fs.readFile(configPath, "utf-8");
+    logger.debug(`Successfully read config file (${fileContent.length} chars)`);
+  } catch (error) {
+    logger.error(`Failed to read config file: ${configPath}`, { error });
+    throw ConfigError.fileReadError(
+      configPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  let config;
+  try {
+    config = parseYaml(fileContent);
+    logger.debug(`Successfully parsed YAML config`, {
+      hasLlmSection: Boolean(config.llm),
+      existingProvider: config.llm?.provider,
+      existingModel: config.llm?.model
+    });
+  } catch (error) {
+    logger.error(`Failed to parse YAML config: ${configPath}`, { error });
+    throw ConfigError.parseError(
+      configPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  const provider = overrides?.provider ?? preferences.llm.provider;
+  const model = overrides?.model ?? preferences.llm.model;
+  const apiKey = overrides?.apiKey ?? preferences.llm.apiKey;
+  logger.debug(`Applying LLM preferences`, {
+    finalProvider: provider,
+    finalModel: model,
+    hasApiKey: Boolean(apiKey),
+    source: overrides ? "CLI overrides + preferences" : "preferences only"
+  });
+  config.llm = {
+    ...config.llm,
+    // Preserve temperature, router, maxTokens, etc.
+    provider,
+    // Write user preference
+    model,
+    // Write user preference
+    apiKey
+    // Write user preference
+  };
+  await writeConfigFile(configPath, config);
+  logger.info(`\u2713 Applied preferences to: ${path.basename(configPath)} (${provider}/${model})`);
+}
+async function writePreferencesToAgent(installedPath, preferences, overrides) {
+  let stat;
+  try {
+    stat = await fs.stat(installedPath);
+  } catch (error) {
+    throw ConfigError.fileReadError(
+      installedPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  if (stat.isFile()) {
+    if (installedPath.endsWith(".yml") || installedPath.endsWith(".yaml")) {
+      await writeLLMPreferences(installedPath, preferences, overrides);
+      logger.info(`\u2713 Applied preferences to: ${path.basename(installedPath)}`, null, "green");
+    } else {
+      logger.warn(`Skipping non-YAML file: ${installedPath}`, null, "yellow");
+    }
+  } else if (stat.isDirectory()) {
+    await writePreferencesToDirectory(installedPath, preferences, overrides);
+  } else {
+    throw ConfigError.fileReadError(installedPath, "Path is neither a file nor directory");
+  }
+}
+async function writePreferencesToDirectory(installedDir, preferences, overrides) {
+  const configFiles = await findAgentConfigFiles(installedDir);
+  if (configFiles.length === 0) {
+    logger.warn(`No YAML config files found in: ${installedDir}`);
+    return;
+  }
+  let successCount = 0;
+  const oldProvider = preferences.llm.provider;
+  const oldModel = preferences.llm.model;
+  const newProvider = overrides?.provider ?? preferences.llm.provider;
+  const newModel = overrides?.model ?? preferences.llm.model;
+  for (const configPath of configFiles) {
+    try {
+      await writeLLMPreferences(configPath, preferences, overrides);
+      logger.debug(`Applied preferences to: ${path.relative(installedDir, configPath)}`);
+      successCount++;
+    } catch (error) {
+      logger.warn(
+        `Failed to write preferences to ${configPath}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  logger.info(
+    `\u2713 Applied preferences to ${successCount}/${configFiles.length} config files (${oldProvider}\u2192${newProvider}, ${oldModel}\u2192${newModel})`
+  );
+}
+async function findAgentConfigFiles(dir) {
+  const configFiles = [];
+  async function walkDir(currentDir) {
+    const entries = await fs.readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        if (!["docs", "data"].includes(entry.name)) {
+          await walkDir(fullPath);
+        }
+      } else if (entry.name.endsWith(".yml") || entry.name.endsWith(".yaml")) {
+        configFiles.push(fullPath);
+      }
+    }
+  }
+  await walkDir(dir);
+  return configFiles;
+}
+export {
+  writeConfigFile,
+  writeLLMPreferences,
+  writePreferencesToAgent
+};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@dexto/agent-management",
+  "version": "1.2.5",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "yaml": "^2.7.1",
+    "zod": "^3.25.0",
+    "@dexto/core": "1.2.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.5"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "cross-env NODE_OPTIONS='--max-old-space-size=4096' tsup && cross-env NODE_OPTIONS='--max-old-space-size=4096' tsc -p tsconfig.json --emitDeclarationOnly && node scripts/fix-dist-aliases.mjs",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "lint": "eslint . --ext .ts"
+  }
+}