@dexto/agent-management 1.4.0 → 1.5.0

package/dist/registry/types.d.ts

@@ -115,10 +115,9 @@ export interface AgentRegistry {
     /**
      * Installs an agent from the registry by ID
      * @param agentId - Unique agent identifier
-     * @param injectPreferences - Whether to inject global preferences (default: true)
      * @returns Path to the installed agent config
      */
-    installAgent(agentId: string, injectPreferences?: boolean): Promise<string>;
+    installAgent(agentId: string): Promise<string>;
     /**
      * Uninstalls an agent by ID
      * @param agentId - Unique agent identifier
@@ -133,10 +132,9 @@ export interface AgentRegistry {
      * Resolves an agent ID or path and optionally auto-installs if needed
      * @param idOrPath - Agent ID from registry or filesystem path
      * @param autoInstall - Whether to auto-install from registry (default: true)
-     * @param injectPreferences - Whether to inject preferences during install (default: true)
      * @returns Path to the agent config file
      */
-    resolveAgent(idOrPath: string, autoInstall?: boolean, injectPreferences?: boolean): Promise<string>;
+    resolveAgent(idOrPath: string, autoInstall?: boolean): Promise<string>;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWxB,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKd,CAAC;AAEd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEvD,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAsC/D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACzD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC;;;;;;OAMG;IACH,YAAY,CACR,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,EACrB,iBAAiB,CAAC,EAAE,OAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWxB,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKd,CAAC;AAEd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEvD,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAsC/D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACzD;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1E"}

package/dist/resolver.cjs

@@ -42,7 +42,7 @@ var import_config = require("./config/index.js");
 var import_errors = require("./registry/errors.js");
 var import_AgentManager = require("./AgentManager.js");
 var import_installation = require("./installation.js");
-async function resolveAgentPath(nameOrPath, autoInstall = true, injectPreferences = true) {
+async function resolveAgentPath(nameOrPath, autoInstall = true) {
   if (nameOrPath && (0, import_path2.isPath)(nameOrPath)) {
     const resolved = import_path.default.resolve(nameOrPath);
     try {
@@ -56,11 +56,11 @@ async function resolveAgentPath(nameOrPath, autoInstall = true, injectPreference
     }
   }
   if (nameOrPath) {
-    return await resolveAgentByName(nameOrPath, autoInstall, injectPreferences);
+    return await resolveAgentByName(nameOrPath, autoInstall);
   }
-  return await resolveDefaultAgentByContext(autoInstall, injectPreferences);
+  return await resolveDefaultAgentByContext(autoInstall);
 }
-async function resolveAgentByName(agentId, autoInstall, injectPreferences) {
+async function resolveAgentByName(agentId, autoInstall) {
   const agentsDir = (0, import_path2.getDextoGlobalPath)("agents");
   const installedRegistryPath = import_path.default.join(agentsDir, "registry.json");
   try {
@@ -76,7 +76,7 @@ async function resolveAgentByName(agentId, autoInstall, injectPreferences) {
   if (autoInstall) {
     try {
       import_core.logger.info(`Auto-installing agent '${agentId}' from bundled registry`);
-      const configPath = await (0, import_installation.installBundledAgent)(agentId, { injectPreferences });
+      const configPath = await (0, import_installation.installBundledAgent)(agentId);
       return configPath;
     } catch (error) {
       import_core.logger.debug(`Failed to auto-install agent '${agentId}': ${error}`);
@@ -97,26 +97,26 @@ async function getAgentConfigPath(agentId) {
   }
   return import_path.default.resolve(import_path.default.dirname(installedRegistryPath), agentEntry.configPath);
 }
-async function resolveDefaultAgentByContext(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentByContext(autoInstall = true) {
   const executionContext = (0, import_execution_context.getExecutionContext)();
   switch (executionContext) {
     case "dexto-source":
-      return await resolveDefaultAgentForDextoSource(autoInstall, injectPreferences);
+      return await resolveDefaultAgentForDextoSource(autoInstall);
     case "dexto-project":
-      return await resolveDefaultAgentForDextoProject(autoInstall, injectPreferences);
+      return await resolveDefaultAgentForDextoProject(autoInstall);
     case "global-cli":
-      return await resolveDefaultAgentForGlobalCLI(autoInstall, injectPreferences);
+      return await resolveDefaultAgentForGlobalCLI(autoInstall);
     default:
       throw import_config.ConfigError.unknownContext(executionContext);
   }
 }
-async function resolveDefaultAgentForDextoSource(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentForDextoSource(autoInstall = true) {
   import_core.logger.debug("Resolving default agent for dexto source context");
   const sourceRoot = (0, import_execution_context.findDextoSourceRoot)();
   if (!sourceRoot) {
     throw import_config.ConfigError.bundledNotFound("dexto source directory not found");
   }
-  const repoConfigPath = import_path.default.join(sourceRoot, "agents", "default-agent.yml");
+  const repoConfigPath = import_path.default.join(sourceRoot, "agents", "coding-agent", "coding-agent.yml");
   const isDevMode = process.env.DEXTO_DEV_MODE === "true";
   if (isDevMode) {
     import_core.logger.debug("Dev mode: using repository config file");
@@ -133,7 +133,7 @@ async function resolveDefaultAgentForDextoSource(autoInstall = true, injectPrefe
       if (preferences.setup.completed) {
         import_core.logger.debug("Using user preferences in dexto-source context");
         const preferredAgentName = preferences.defaults.defaultAgent;
-        return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
+        return await resolveAgentByName(preferredAgentName, autoInstall);
       }
     } catch (error) {
       import_core.logger.warn(`Failed to load preferences, falling back to repo config: ${error}`);
@@ -147,16 +147,16 @@ async function resolveDefaultAgentForDextoSource(autoInstall = true, injectPrefe
     throw import_config.ConfigError.bundledNotFound(repoConfigPath);
   }
 }
-async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentForDextoProject(autoInstall = true) {
   import_core.logger.debug("Resolving default agent for dexto project context");
   const projectRoot = (0, import_execution_context.findDextoProjectRoot)();
   if (!projectRoot) {
     throw import_config.ConfigError.unknownContext("dexto-project: project root not found");
   }
   const candidatePaths = [
-    import_path.default.join(projectRoot, "default-agent.yml"),
-    import_path.default.join(projectRoot, "agents", "default-agent.yml"),
-    import_path.default.join(projectRoot, "src", "dexto", "agents", "default-agent.yml")
+    import_path.default.join(projectRoot, "coding-agent.yml"),
+    import_path.default.join(projectRoot, "agents", "coding-agent.yml"),
+    import_path.default.join(projectRoot, "src", "dexto", "agents", "coding-agent.yml")
   ];
   for (const p of candidatePaths) {
     try {
@@ -165,7 +165,7 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPref
     } catch {
     }
   }
-  import_core.logger.debug(`No project-local default-agent.yml found in ${projectRoot}`);
+  import_core.logger.debug(`No project-local coding-agent.yml found in ${projectRoot}`);
   if (!(0, import_loader.globalPreferencesExist)()) {
     throw import_config.ConfigError.noProjectDefault(projectRoot);
   }
@@ -174,9 +174,9 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPref
     throw import_config.ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall);
 }
-async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentForGlobalCLI(autoInstall = true) {
   import_core.logger.debug("Resolving default agent for global CLI context");
   if (!(0, import_loader.globalPreferencesExist)()) {
     throw import_config.ConfigError.noGlobalPreferences();
@@ -186,7 +186,7 @@ async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPrefere
     throw import_config.ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall);
 }
 async function updateDefaultAgentPreference(agentName) {
   const agentsDir = (0, import_path2.getDextoGlobalPath)("agents");

package/dist/resolver.d.ts

@@ -2,12 +2,11 @@
  * Resolve agent path with automatic installation if needed
  * @param nameOrPath Optional agent name or explicit path
  * @param autoInstall Whether to automatically install missing agents from bundled registry (default: true)
- * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
  * @returns Resolved absolute path to agent config
  * @throws {ConfigError} For path/config issues (file not found, unknown context, setup incomplete)
  * @throws {RegistryError} For agent lookup failures (agent not found, not installed)
  */
-export declare function resolveAgentPath(nameOrPath?: string, autoInstall?: boolean, injectPreferences?: boolean): Promise<string>;
+export declare function resolveAgentPath(nameOrPath?: string, autoInstall?: boolean): Promise<string>;
 /**
  * Update default agent preference
  * @param agentName The agent name to set as the new default

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAoCA;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAClC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAc,EAC3B,iBAAiB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAiND;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnF"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAoCA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAClC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAc,GAC5B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAiMD;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnF"}

package/dist/resolver.js

@@ -12,7 +12,7 @@ import { ConfigError } from "./config/index.js";
 import { RegistryError } from "./registry/errors.js";
 import { AgentManager } from "./AgentManager.js";
 import { installBundledAgent } from "./installation.js";
-async function resolveAgentPath(nameOrPath, autoInstall = true, injectPreferences = true) {
+async function resolveAgentPath(nameOrPath, autoInstall = true) {
   if (nameOrPath && isPath(nameOrPath)) {
     const resolved = path.resolve(nameOrPath);
     try {
@@ -26,11 +26,11 @@ async function resolveAgentPath(nameOrPath, autoInstall = true, injectPreference
     }
   }
   if (nameOrPath) {
-    return await resolveAgentByName(nameOrPath, autoInstall, injectPreferences);
+    return await resolveAgentByName(nameOrPath, autoInstall);
   }
-  return await resolveDefaultAgentByContext(autoInstall, injectPreferences);
+  return await resolveDefaultAgentByContext(autoInstall);
 }
-async function resolveAgentByName(agentId, autoInstall, injectPreferences) {
+async function resolveAgentByName(agentId, autoInstall) {
   const agentsDir = getDextoGlobalPath("agents");
   const installedRegistryPath = path.join(agentsDir, "registry.json");
   try {
@@ -46,7 +46,7 @@ async function resolveAgentByName(agentId, autoInstall, injectPreferences) {
   if (autoInstall) {
     try {
       logger.info(`Auto-installing agent '${agentId}' from bundled registry`);
-      const configPath = await installBundledAgent(agentId, { injectPreferences });
+      const configPath = await installBundledAgent(agentId);
       return configPath;
     } catch (error) {
       logger.debug(`Failed to auto-install agent '${agentId}': ${error}`);
@@ -67,26 +67,26 @@ async function getAgentConfigPath(agentId) {
   }
   return path.resolve(path.dirname(installedRegistryPath), agentEntry.configPath);
 }
-async function resolveDefaultAgentByContext(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentByContext(autoInstall = true) {
   const executionContext = getExecutionContext();
   switch (executionContext) {
     case "dexto-source":
-      return await resolveDefaultAgentForDextoSource(autoInstall, injectPreferences);
+      return await resolveDefaultAgentForDextoSource(autoInstall);
     case "dexto-project":
-      return await resolveDefaultAgentForDextoProject(autoInstall, injectPreferences);
+      return await resolveDefaultAgentForDextoProject(autoInstall);
     case "global-cli":
-      return await resolveDefaultAgentForGlobalCLI(autoInstall, injectPreferences);
+      return await resolveDefaultAgentForGlobalCLI(autoInstall);
     default:
       throw ConfigError.unknownContext(executionContext);
   }
 }
-async function resolveDefaultAgentForDextoSource(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentForDextoSource(autoInstall = true) {
   logger.debug("Resolving default agent for dexto source context");
   const sourceRoot = findDextoSourceRoot();
   if (!sourceRoot) {
     throw ConfigError.bundledNotFound("dexto source directory not found");
   }
-  const repoConfigPath = path.join(sourceRoot, "agents", "default-agent.yml");
+  const repoConfigPath = path.join(sourceRoot, "agents", "coding-agent", "coding-agent.yml");
   const isDevMode = process.env.DEXTO_DEV_MODE === "true";
   if (isDevMode) {
     logger.debug("Dev mode: using repository config file");
@@ -103,7 +103,7 @@ async function resolveDefaultAgentForDextoSource(autoInstall = true, injectPrefe
       if (preferences.setup.completed) {
         logger.debug("Using user preferences in dexto-source context");
         const preferredAgentName = preferences.defaults.defaultAgent;
-        return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
+        return await resolveAgentByName(preferredAgentName, autoInstall);
       }
     } catch (error) {
       logger.warn(`Failed to load preferences, falling back to repo config: ${error}`);
@@ -117,16 +117,16 @@ async function resolveDefaultAgentForDextoSource(autoInstall = true, injectPrefe
     throw ConfigError.bundledNotFound(repoConfigPath);
   }
 }
-async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentForDextoProject(autoInstall = true) {
   logger.debug("Resolving default agent for dexto project context");
   const projectRoot = findDextoProjectRoot();
   if (!projectRoot) {
     throw ConfigError.unknownContext("dexto-project: project root not found");
   }
   const candidatePaths = [
-    path.join(projectRoot, "default-agent.yml"),
-    path.join(projectRoot, "agents", "default-agent.yml"),
-    path.join(projectRoot, "src", "dexto", "agents", "default-agent.yml")
+    path.join(projectRoot, "coding-agent.yml"),
+    path.join(projectRoot, "agents", "coding-agent.yml"),
+    path.join(projectRoot, "src", "dexto", "agents", "coding-agent.yml")
   ];
   for (const p of candidatePaths) {
     try {
@@ -135,7 +135,7 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPref
     } catch {
     }
   }
-  logger.debug(`No project-local default-agent.yml found in ${projectRoot}`);
+  logger.debug(`No project-local coding-agent.yml found in ${projectRoot}`);
   if (!globalPreferencesExist()) {
     throw ConfigError.noProjectDefault(projectRoot);
   }
@@ -144,9 +144,9 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPref
     throw ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall);
 }
-async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPreferences = true) {
+async function resolveDefaultAgentForGlobalCLI(autoInstall = true) {
   logger.debug("Resolving default agent for global CLI context");
   if (!globalPreferencesExist()) {
     throw ConfigError.noGlobalPreferences();
@@ -156,7 +156,7 @@ async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPrefere
     throw ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall);
 }
 async function updateDefaultAgentPreference(agentName) {
   const agentsDir = getDextoGlobalPath("agents");

package/dist/utils/api-key-resolver.cjs

@@ -31,7 +31,25 @@ const PROVIDER_API_KEY_MAP = {
   google: ["GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_API_KEY", "GEMINI_API_KEY"],
   groq: ["GROQ_API_KEY"],
   cohere: ["COHERE_API_KEY"],
-  xai: ["XAI_API_KEY", "X_AI_API_KEY"]
+  xai: ["XAI_API_KEY", "X_AI_API_KEY"],
+  openrouter: ["OPENROUTER_API_KEY"],
+  litellm: ["LITELLM_API_KEY", "LITELLM_KEY"],
+  glama: ["GLAMA_API_KEY"],
+  // Vertex uses ADC (Application Default Credentials), not API keys
+  // GOOGLE_APPLICATION_CREDENTIALS points to service account JSON (optional)
+  // Primary config is GOOGLE_VERTEX_PROJECT (required) + GOOGLE_VERTEX_LOCATION (optional)
+  vertex: [],
+  // Bedrock supports two auth methods:
+  // 1. AWS_BEARER_TOKEN_BEDROCK - Bedrock API key (simplest)
+  // 2. AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY + AWS_REGION (IAM credentials)
+  // AWS_SESSION_TOKEN (optional, for temporary credentials)
+  bedrock: ["AWS_BEARER_TOKEN_BEDROCK"],
+  // Local providers don't require API keys
+  local: [],
+  // Native node-llama-cpp execution
+  ollama: []
+  // Ollama server (may optionally use OLLAMA_API_KEY for remote servers)
+  // TODO: dexto: ['DEXTO_API_KEY'],
   // perplexity: ['PERPLEXITY_API_KEY'],
   // together: ['TOGETHER_API_KEY'],
   // fireworks: ['FIREWORKS_API_KEY'],

package/dist/utils/api-key-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-key-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/api-key-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AAGH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAY9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAelF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAGpE"}
+{"version":3,"file":"api-key-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/api-key-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AAGH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CA4B9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAelF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAGpE"}

package/dist/utils/api-key-resolver.js

@@ -6,7 +6,25 @@ const PROVIDER_API_KEY_MAP = {
   google: ["GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_API_KEY", "GEMINI_API_KEY"],
   groq: ["GROQ_API_KEY"],
   cohere: ["COHERE_API_KEY"],
-  xai: ["XAI_API_KEY", "X_AI_API_KEY"]
+  xai: ["XAI_API_KEY", "X_AI_API_KEY"],
+  openrouter: ["OPENROUTER_API_KEY"],
+  litellm: ["LITELLM_API_KEY", "LITELLM_KEY"],
+  glama: ["GLAMA_API_KEY"],
+  // Vertex uses ADC (Application Default Credentials), not API keys
+  // GOOGLE_APPLICATION_CREDENTIALS points to service account JSON (optional)
+  // Primary config is GOOGLE_VERTEX_PROJECT (required) + GOOGLE_VERTEX_LOCATION (optional)
+  vertex: [],
+  // Bedrock supports two auth methods:
+  // 1. AWS_BEARER_TOKEN_BEDROCK - Bedrock API key (simplest)
+  // 2. AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY + AWS_REGION (IAM credentials)
+  // AWS_SESSION_TOKEN (optional, for temporary credentials)
+  bedrock: ["AWS_BEARER_TOKEN_BEDROCK"],
+  // Local providers don't require API keys
+  local: [],
+  // Native node-llama-cpp execution
+  ollama: []
+  // Ollama server (may optionally use OLLAMA_API_KEY for remote servers)
+  // TODO: dexto: ['DEXTO_API_KEY'],
   // perplexity: ['PERPLEXITY_API_KEY'],
   // together: ['TOGETHER_API_KEY'],
   // fireworks: ['FIREWORKS_API_KEY'],

package/dist/utils/api-key-store.cjs

@@ -18,6 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var api_key_store_exports = {};
 __export(api_key_store_exports, {
+  SHARED_API_KEY_PROVIDERS: () => SHARED_API_KEY_PROVIDERS,
+  determineApiKeyStorage: () => determineApiKeyStorage,
   getProviderKeyStatus: () => getProviderKeyStatus,
   listProviderKeyStatus: () => listProviderKeyStatus,
   saveProviderApiKey: () => saveProviderApiKey
@@ -37,6 +39,27 @@ async function saveProviderApiKey(provider, apiKey, startPath) {
   return { envVar, targetEnvPath };
 }
 function getProviderKeyStatus(provider) {
+  if (provider === "vertex") {
+    const projectId = process.env.GOOGLE_VERTEX_PROJECT;
+    return {
+      hasApiKey: Boolean(projectId && projectId.trim()),
+      envVar: "GOOGLE_VERTEX_PROJECT"
+    };
+  }
+  if (provider === "bedrock") {
+    const apiKey = process.env.AWS_BEARER_TOKEN_BEDROCK;
+    if (apiKey && apiKey.trim()) {
+      return {
+        hasApiKey: true,
+        envVar: "AWS_BEARER_TOKEN_BEDROCK"
+      };
+    }
+    const region = process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION;
+    return {
+      hasApiKey: Boolean(region && region.trim()),
+      envVar: "AWS_REGION"
+    };
+  }
   const envVar = (0, import_api_key_resolver.getPrimaryApiKeyEnvVar)(provider);
   const key = (0, import_api_key_resolver.resolveApiKeyForProvider)(provider);
   return { hasApiKey: Boolean(key && key.trim()), envVar };
@@ -48,8 +71,31 @@ function listProviderKeyStatus() {
   }
   return result;
 }
+const SHARED_API_KEY_PROVIDERS = ["glama", "openrouter", "litellm"];
+function determineApiKeyStorage(provider, userEnteredKey, providerHasKey, existingProviderKey) {
+  const result = {
+    saveToProviderEnvVar: false,
+    saveAsPerModel: false
+  };
+  if (!userEnteredKey) {
+    return result;
+  }
+  const hasSharedEnvVarKey = SHARED_API_KEY_PROVIDERS.includes(provider);
+  if (hasSharedEnvVarKey) {
+    if (!providerHasKey) {
+      result.saveToProviderEnvVar = true;
+    } else if (existingProviderKey && userEnteredKey !== existingProviderKey) {
+      result.saveAsPerModel = true;
+    }
+  } else {
+    result.saveAsPerModel = true;
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  SHARED_API_KEY_PROVIDERS,
+  determineApiKeyStorage,
   getProviderKeyStatus,
   listProviderKeyStatus,
   saveProviderApiKey

package/dist/utils/api-key-store.d.ts

@@ -15,4 +15,31 @@ export declare function listProviderKeyStatus(): Record<string, {
     hasApiKey: boolean;
     envVar: string;
 }>;
+/**
+ * Providers that use a shared env var for API keys (vs per-endpoint like openai-compatible).
+ * For these providers, we save to the env var if none exists, otherwise per-model override.
+ */
+export declare const SHARED_API_KEY_PROVIDERS: readonly ["glama", "openrouter", "litellm"];
+export type ApiKeyStorageStrategy = {
+    /** Save the key to provider env var (e.g., GLAMA_API_KEY) */
+    saveToProviderEnvVar: boolean;
+    /** Save the key as per-model override in custom model config */
+    saveAsPerModel: boolean;
+};
+/**
+ * Determine where to store an API key for a custom model.
+ *
+ * Logic:
+ * - For glama/openrouter/litellm (shared env var providers):
+ *   - If NO provider key exists → save to provider env var for reuse
+ *   - If provider key EXISTS and user entered SAME key → don't save (uses fallback)
+ *   - If provider key EXISTS and user entered DIFFERENT key → save as per-model override
+ * - For openai-compatible: always save as per-model (each endpoint needs own key)
+ *
+ * @param provider - The custom model provider
+ * @param userEnteredKey - The API key entered by user (trimmed, may be empty)
+ * @param providerHasKey - Whether the provider already has a key configured
+ * @param existingProviderKey - The existing provider key value (for comparison)
+ */
+export declare function determineApiKeyStorage(provider: string, userEnteredKey: string | undefined, providerHasKey: boolean, existingProviderKey: string | undefined): ApiKeyStorageStrategy;
 //# sourceMappingURL=api-key-store.d.ts.map

package/dist/utils/api-key-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-key-store.d.ts","sourceRoot":"","sources":["../../src/utils/api-key-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C;;;GAGG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAYpD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB,CAIA;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9F"}
+{"version":3,"file":"api-key-store.d.ts","sourceRoot":"","sources":["../../src/utils/api-key-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C;;;GAGG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAYpD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB,CA4CA;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9F;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,6CAA8C,CAAC;AAEpF,MAAM,MAAM,qBAAqB,GAAG;IAChC,6DAA6D;IAC7D,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,cAAc,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,cAAc,EAAE,OAAO,EACvB,mBAAmB,EAAE,MAAM,GAAG,SAAS,GACxC,qBAAqB,CA2BvB"}

package/dist/utils/api-key-store.js

@@ -12,6 +12,27 @@ async function saveProviderApiKey(provider, apiKey, startPath) {
   return { envVar, targetEnvPath };
 }
 function getProviderKeyStatus(provider) {
+  if (provider === "vertex") {
+    const projectId = process.env.GOOGLE_VERTEX_PROJECT;
+    return {
+      hasApiKey: Boolean(projectId && projectId.trim()),
+      envVar: "GOOGLE_VERTEX_PROJECT"
+    };
+  }
+  if (provider === "bedrock") {
+    const apiKey = process.env.AWS_BEARER_TOKEN_BEDROCK;
+    if (apiKey && apiKey.trim()) {
+      return {
+        hasApiKey: true,
+        envVar: "AWS_BEARER_TOKEN_BEDROCK"
+      };
+    }
+    const region = process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION;
+    return {
+      hasApiKey: Boolean(region && region.trim()),
+      envVar: "AWS_REGION"
+    };
+  }
   const envVar = getPrimaryApiKeyEnvVar(provider);
   const key = resolveApiKeyForProvider(provider);
   return { hasApiKey: Boolean(key && key.trim()), envVar };
@@ -23,7 +44,30 @@ function listProviderKeyStatus() {
   }
   return result;
 }
+const SHARED_API_KEY_PROVIDERS = ["glama", "openrouter", "litellm"];
+function determineApiKeyStorage(provider, userEnteredKey, providerHasKey, existingProviderKey) {
+  const result = {
+    saveToProviderEnvVar: false,
+    saveAsPerModel: false
+  };
+  if (!userEnteredKey) {
+    return result;
+  }
+  const hasSharedEnvVarKey = SHARED_API_KEY_PROVIDERS.includes(provider);
+  if (hasSharedEnvVarKey) {
+    if (!providerHasKey) {
+      result.saveToProviderEnvVar = true;
+    } else if (existingProviderKey && userEnteredKey !== existingProviderKey) {
+      result.saveAsPerModel = true;
+    }
+  } else {
+    result.saveAsPerModel = true;
+  }
+  return result;
+}
 export {
+  SHARED_API_KEY_PROVIDERS,
+  determineApiKeyStorage,
   getProviderKeyStatus,
   listProviderKeyStatus,
   saveProviderApiKey

package/dist/utils/env-file.cjs

@@ -33,84 +33,36 @@ __export(env_file_exports, {
 module.exports = __toCommonJS(env_file_exports);
 var path = __toESM(require("node:path"), 1);
 var import_node_fs = require("node:fs");
-const DEXTO_ENV_KEYS = [
-  "OPENAI_API_KEY",
-  "ANTHROPIC_API_KEY",
-  "GOOGLE_GENERATIVE_AI_API_KEY",
-  "GROQ_API_KEY",
-  "COHERE_API_KEY",
-  "XAI_API_KEY",
-  "DEXTO_LOG_LEVEL"
-];
-function isDextoEnvKey(value) {
-  return DEXTO_ENV_KEYS.includes(value);
-}
 async function updateEnvFile(envFilePath, updates) {
   await import_node_fs.promises.mkdir(path.dirname(envFilePath), { recursive: true });
-  let envLines = [];
+  let content = "";
   try {
-    const existingEnv = await import_node_fs.promises.readFile(envFilePath, "utf8");
-    envLines = existingEnv.split("\n");
+    content = await import_node_fs.promises.readFile(envFilePath, "utf8");
   } catch {
   }
-  const currentValues = {};
-  envLines.forEach((line) => {
-    const match = line.match(/^([A-Z0-9_]+)=(.*)$/);
-    if (match && match[1] && isDextoEnvKey(match[1])) {
-      const value = match[2] ?? "";
-      currentValues[match[1]] = value;
+  const lines = content.split("\n");
+  const updatedKeys = /* @__PURE__ */ new Set();
+  const updatedLines = lines.map((line) => {
+    const match = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
+    if (match && match[1] && match[1] in updates) {
+      const key = match[1];
+      updatedKeys.add(key);
+      return `${key}=${updates[key]}`;
     }
+    return line;
   });
-  const updatedValues = Object.fromEntries(
-    DEXTO_ENV_KEYS.map((key) => {
-      const update = updates[key];
-      const current = currentValues[key];
-      const fallback = key === "DEXTO_LOG_LEVEL" ? "info" : "";
-      const value = update !== void 0 ? update : current ?? fallback;
-      return [key, value];
-    })
-  );
-  const sectionHeader = "## Dexto env variables";
-  const headerIndex = envLines.findIndex((line) => line.trim() === sectionHeader);
-  let contentLines;
-  if (headerIndex !== -1) {
-    const beforeSection = envLines.slice(0, headerIndex);
-    let sectionEnd = headerIndex + 1;
-    while (sectionEnd < envLines.length && envLines[sectionEnd]?.trim() !== "") {
-      sectionEnd++;
-    }
-    if (sectionEnd < envLines.length && envLines[sectionEnd]?.trim() === "") {
-      sectionEnd++;
+  for (const [key, value] of Object.entries(updates)) {
+    if (!updatedKeys.has(key)) {
+      if (updatedLines.length > 0 && updatedLines[updatedLines.length - 1] !== "") {
+        updatedLines.push("");
+      }
+      updatedLines.push(`${key}=${value}`);
     }
-    const afterSection = envLines.slice(sectionEnd);
-    contentLines = [...beforeSection, ...afterSection];
-  } else {
-    contentLines = envLines;
   }
-  const existingEnvVars = {};
-  contentLines.forEach((line) => {
-    const match = line.match(/^([A-Z0-9_]+)=(.*)$/);
-    if (match && match[1] && isDextoEnvKey(match[1])) {
-      const value = match[2] ?? "";
-      existingEnvVars[match[1]] = value;
-    }
-  });
-  if (contentLines.length > 0) {
-    if (contentLines[contentLines.length - 1]?.trim() !== "") {
-      contentLines.push("");
-    }
-  } else {
-    contentLines.push("");
-  }
-  contentLines.push(sectionHeader);
-  for (const key of DEXTO_ENV_KEYS) {
-    if (key in existingEnvVars && !(key in updates)) {
-      continue;
-    }
-    contentLines.push(`${key}=${updatedValues[key]}`);
+  if (updatedLines[updatedLines.length - 1] !== "") {
+    updatedLines.push("");
   }
-  contentLines.push("");
-  await import_node_fs.promises.writeFile(envFilePath, contentLines.join("\n"), "utf8");
+  await import_node_fs.promises.writeFile(envFilePath, updatedLines.join("\n"), "utf8");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/utils/env-file.d.ts

@@ -1,5 +1,6 @@
 /**
- * Update a .env file with Dexto environment variables, ensuring our section stays consistent.
+ * Update a .env file with the provided key-value pairs.
+ * Existing keys are updated in place, new keys are appended.
  */
 export declare function updateEnvFile(envFilePath: string, updates: Record<string, string>): Promise<void>;
 //# sourceMappingURL=env-file.d.ts.map

package/dist/utils/env-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/utils/env-file.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,wBAAsB,aAAa,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAgFf"}
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/utils/env-file.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,aAAa,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAyCf"}