@dexto/agent-management 1.4.0 → 1.5.1

package/dist/preferences/schemas.js

@@ -1,5 +1,11 @@
 import { z } from "zod";
-import { isValidProviderModel, getSupportedModels } from "@dexto/core";
+import {
+  isValidProviderModel,
+  getSupportedModels,
+  acceptsAnyModel,
+  supportsCustomModels,
+  supportsBaseURL
+} from "@dexto/core";
 import { LLM_PROVIDERS } from "@dexto/core";
 import { NonEmptyTrimmed } from "@dexto/core";
 import { PreferenceErrorCode } from "./error-codes.js";
@@ -10,9 +16,16 @@ const PreferenceLLMSchema = z.object({
   apiKey: z.string().regex(
     /^\$[A-Z_][A-Z0-9_]*$/,
     "Must be environment variable reference (e.g., $OPENAI_API_KEY)"
-  ).describe("Environment variable reference for API key")
+  ).optional().describe(
+    "Environment variable reference for API key (optional for local providers like Ollama)"
+  ),
+  baseURL: z.string().url("Must be a valid URL (e.g., http://localhost:11434/v1)").optional().describe("Custom base URL for providers that support it (openai-compatible, litellm)"),
+  reasoningEffort: z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional().describe(
+    "Reasoning effort level for OpenAI reasoning models (o1, o3, codex, gpt-5.x). Auto-detected if not set."
+  )
 }).strict().superRefine((data, ctx) => {
-  if (!isValidProviderModel(data.provider, data.model)) {
+  const skipModelValidation = acceptsAnyModel(data.provider) || supportsCustomModels(data.provider);
+  if (!skipModelValidation && !isValidProviderModel(data.provider, data.model)) {
     const supportedModels = getSupportedModels(data.provider);
     ctx.addIssue({
       code: z.ZodIssueCode.custom,
@@ -25,13 +38,27 @@ const PreferenceLLMSchema = z.object({
       }
     });
   }
+  if (data.baseURL && !supportsBaseURL(data.provider)) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ["baseURL"],
+      message: `Provider '${data.provider}' does not support custom baseURL. Use 'openai-compatible' for custom endpoints.`,
+      params: {
+        code: PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+        scope: "preference",
+        type: ErrorType.USER
+      }
+    });
+  }
 });
 const PreferenceDefaultsSchema = z.object({
   defaultAgent: z.string().min(1).describe("Default agent name for global CLI usage (required)"),
   defaultMode: z.enum(["cli", "web", "server", "discord", "telegram", "mcp"]).default("web").describe("Default run mode when --mode flag is not specified (default: web)")
 }).strict();
 const PreferenceSetupSchema = z.object({
-  completed: z.boolean().default(false).describe("Whether initial setup has been completed")
+  completed: z.boolean().default(false).describe("Whether initial setup has been completed"),
+  apiKeyPending: z.boolean().default(false).describe("Whether API key setup was skipped and needs to be configured later"),
+  baseURLPending: z.boolean().default(false).describe("Whether baseURL setup was skipped and needs to be configured later")
 }).strict();
 const GlobalPreferencesSchema = z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),

package/dist/registry/registry.cjs

@@ -38,11 +38,10 @@ var import_fs2 = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_core = require("@dexto/core");
 var import_path2 = require("../utils/path.js");
-var import_loader = require("../preferences/loader.js");
-var import_writer = require("../writer.js");
 var import_types = require("./types.js");
 var import_errors = require("./errors.js");
 var import_user_registry = require("./user-registry.js");
+var import_loader = require("../preferences/loader.js");
 let cachedRegistry = null;
 class LocalAgentRegistry {
   _registry = null;
@@ -175,9 +174,8 @@ class LocalAgentRegistry {
   /**
    * Install agent atomically using temp + rename pattern
    * @param agentId ID of the agent to install
-   * @param injectPreferences Whether to inject global preferences into installed agent (default: true)
    */
-  async installAgent(agentId, injectPreferences = true) {
+  async installAgent(agentId) {
     import_core.logger.info(`Installing agent: ${agentId}`);
     const registry = this.getRegistry();
     const agentData = registry.agents[agentId];
@@ -215,24 +213,6 @@ class LocalAgentRegistry {
       }
       await import_fs2.promises.rename(tempDir, targetDir);
       import_core.logger.info(`\u2713 Installed agent '${agentId}' to ${targetDir}`);
-      if (injectPreferences) {
-        try {
-          const preferences = await (0, import_loader.loadGlobalPreferences)();
-          await (0, import_writer.writePreferencesToAgent)(targetDir, preferences);
-          import_core.logger.info(`\u2713 Applied global preferences to installed agent '${agentId}'`);
-        } catch (error) {
-          import_core.logger.warn(
-            `Failed to inject preferences to '${agentId}': ${error instanceof Error ? error.message : String(error)}`
-          );
-          console.log(
-            `\u26A0\uFE0F  Warning: Could not apply preferences to '${agentId}' - agent will use bundled settings`
-          );
-        }
-      } else {
-        import_core.logger.info(
-          `Skipped preference injection for '${agentId}' (injectPreferences=false)`
-        );
-      }
       return this.resolveMainConfig(targetDir, agentId);
     } catch (error) {
       try {
@@ -255,10 +235,9 @@ class LocalAgentRegistry {
    * @param agentId Unique identifier for the custom agent
    * @param sourcePath Absolute path to agent YAML file or directory
    * @param metadata Agent metadata (name for display, description, author, tags, main)
-   * @param injectPreferences Whether to inject global preferences (default: true)
    * @returns Path to the installed agent's main config file
    */
-  async installCustomAgentFromPath(agentId, sourcePath, metadata, injectPreferences = true) {
+  async installCustomAgentFromPath(agentId, sourcePath, metadata) {
     import_core.logger.info(`Installing custom agent '${agentId}' from ${sourcePath}`);
     this.validateCustomAgentId(agentId);
     if (!(0, import_fs.existsSync)(sourcePath)) {
@@ -332,20 +311,6 @@ class LocalAgentRegistry {
         }
         throw registryError;
       }
-      if (injectPreferences) {
-        try {
-          const preferences = await (0, import_loader.loadGlobalPreferences)();
-          await (0, import_writer.writePreferencesToAgent)(targetDir, preferences);
-          import_core.logger.info(`\u2713 Applied global preferences to custom agent '${agentId}'`);
-        } catch (error) {
-          import_core.logger.warn(
-            `Failed to inject preferences to '${agentId}': ${error instanceof Error ? error.message : String(error)}`
-          );
-          console.log(
-            `\u26A0\uFE0F  Warning: Could not apply preferences to '${agentId}' - agent will use default settings`
-          );
-        }
-      }
       return mainConfigPath;
     } catch (error) {
       try {
@@ -369,9 +334,8 @@ class LocalAgentRegistry {
    * Handles installing agent if needed
    * @param agentId ID of the agent to resolve
    * @param autoInstall Whether to automatically install missing agents from registry (default: true)
-   * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
    */
-  async resolveAgent(agentId, autoInstall = true, injectPreferences = true) {
+  async resolveAgent(agentId, autoInstall = true) {
     import_core.logger.debug(`Resolving registry agent: ${agentId}`);
     const globalAgentsDir = (0, import_path2.getDextoGlobalPath)("agents");
     const installedPath = import_path.default.resolve(globalAgentsDir, agentId);
@@ -388,7 +352,7 @@ class LocalAgentRegistry {
     if (this.hasAgent(agentId)) {
       if (autoInstall) {
         import_core.logger.info(`Installing agent '${agentId}' from registry...`);
-        return await this.installAgent(agentId, injectPreferences);
+        return await this.installAgent(agentId);
       } else {
         const registry2 = this.getRegistry();
         const available2 = Object.keys(registry2.agents);
@@ -424,8 +388,8 @@ class LocalAgentRegistry {
       const defaultAgent = preferences.defaults.defaultAgent;
       return agentId !== defaultAgent;
     } catch {
-      import_core.logger.warn("Could not load preferences, using fallback protection for default-agent");
-      return agentId !== "default-agent";
+      import_core.logger.warn("Could not load preferences, using fallback protection for coding-agent");
+      return agentId !== "coding-agent";
     }
   }
   /**

package/dist/registry/registry.d.ts

@@ -79,15 +79,13 @@ export declare class LocalAgentRegistry implements AgentRegistry {
     /**
      * Install agent atomically using temp + rename pattern
      * @param agentId ID of the agent to install
-     * @param injectPreferences Whether to inject global preferences into installed agent (default: true)
      */
-    installAgent(agentId: string, injectPreferences?: boolean): Promise<string>;
+    installAgent(agentId: string): Promise<string>;
     /**
      * Install a custom agent from a local file path
      * @param agentId Unique identifier for the custom agent
      * @param sourcePath Absolute path to agent YAML file or directory
      * @param metadata Agent metadata (name for display, description, author, tags, main)
-     * @param injectPreferences Whether to inject global preferences (default: true)
      * @returns Path to the installed agent's main config file
      */
     installCustomAgentFromPath(agentId: string, sourcePath: string, metadata: {
@@ -96,16 +94,15 @@ export declare class LocalAgentRegistry implements AgentRegistry {
         author: string;
         tags: string[];
         main?: string;
-    }, injectPreferences?: boolean): Promise<string>;
+    }): Promise<string>;
     /**
      * Resolve a registry agent ID to a config path
      * NOTE: Only handles registry IDs, not file paths (routing done in loadAgentConfig)
      * Handles installing agent if needed
      * @param agentId ID of the agent to resolve
      * @param autoInstall Whether to automatically install missing agents from registry (default: true)
-     * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
      */
-    resolveAgent(agentId: string, autoInstall?: boolean, injectPreferences?: boolean): Promise<string>;
+    resolveAgent(agentId: string, autoInstall?: boolean): Promise<string>;
     /**
      * Get list of currently installed agents
      */

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,QAAQ,EAER,aAAa,EACb,kBAAkB,EAErB,MAAM,YAAY,CAAC;AAYpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAOvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKlC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAKxD;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IA0C5D;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAqGvF;;;;;;;OAOG;IACG,0BAA0B,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,EACD,iBAAiB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC;IAqKlB;;;;;;;OAOG;IACG,YAAY,CACd,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,OAAc,EAC3B,iBAAiB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC;IAsClB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB7C;;OAEG;YACW,sBAAsB;IAYpC;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAKrD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAY9E"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,QAAQ,EAER,aAAa,EACb,kBAAkB,EAErB,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAOvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKlC;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAKxD;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IA0C5D;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgFpD;;;;;;OAMG;IACG,0BAA0B,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,GACF,OAAO,CAAC,MAAM,CAAC;IAqJlB;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAsCjF;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB7C;;OAEG;YACW,sBAAsB;IAYpC;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAKrD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAY9E"}

package/dist/registry/registry.js

@@ -3,8 +3,6 @@ import { promises as fs } from "fs";
 import path from "path";
 import { logger } from "@dexto/core";
 import { resolveBundledScript, getDextoGlobalPath, copyDirectory } from "../utils/path.js";
-import { loadGlobalPreferences } from "../preferences/loader.js";
-import { writePreferencesToAgent } from "../writer.js";
 import {
   RegistrySchema,
   normalizeRegistryJson
@@ -16,6 +14,7 @@ import {
   removeAgentFromUserRegistry,
   addAgentToUserRegistry
 } from "./user-registry.js";
+import { loadGlobalPreferences } from "../preferences/loader.js";
 let cachedRegistry = null;
 class LocalAgentRegistry {
   _registry = null;
@@ -148,9 +147,8 @@ class LocalAgentRegistry {
   /**
    * Install agent atomically using temp + rename pattern
    * @param agentId ID of the agent to install
-   * @param injectPreferences Whether to inject global preferences into installed agent (default: true)
    */
-  async installAgent(agentId, injectPreferences = true) {
+  async installAgent(agentId) {
     logger.info(`Installing agent: ${agentId}`);
     const registry = this.getRegistry();
     const agentData = registry.agents[agentId];
@@ -188,24 +186,6 @@ class LocalAgentRegistry {
       }
       await fs.rename(tempDir, targetDir);
       logger.info(`\u2713 Installed agent '${agentId}' to ${targetDir}`);
-      if (injectPreferences) {
-        try {
-          const preferences = await loadGlobalPreferences();
-          await writePreferencesToAgent(targetDir, preferences);
-          logger.info(`\u2713 Applied global preferences to installed agent '${agentId}'`);
-        } catch (error) {
-          logger.warn(
-            `Failed to inject preferences to '${agentId}': ${error instanceof Error ? error.message : String(error)}`
-          );
-          console.log(
-            `\u26A0\uFE0F  Warning: Could not apply preferences to '${agentId}' - agent will use bundled settings`
-          );
-        }
-      } else {
-        logger.info(
-          `Skipped preference injection for '${agentId}' (injectPreferences=false)`
-        );
-      }
       return this.resolveMainConfig(targetDir, agentId);
     } catch (error) {
       try {
@@ -228,10 +208,9 @@ class LocalAgentRegistry {
    * @param agentId Unique identifier for the custom agent
    * @param sourcePath Absolute path to agent YAML file or directory
    * @param metadata Agent metadata (name for display, description, author, tags, main)
-   * @param injectPreferences Whether to inject global preferences (default: true)
    * @returns Path to the installed agent's main config file
    */
-  async installCustomAgentFromPath(agentId, sourcePath, metadata, injectPreferences = true) {
+  async installCustomAgentFromPath(agentId, sourcePath, metadata) {
     logger.info(`Installing custom agent '${agentId}' from ${sourcePath}`);
     this.validateCustomAgentId(agentId);
     if (!existsSync(sourcePath)) {
@@ -305,20 +284,6 @@ class LocalAgentRegistry {
         }
         throw registryError;
       }
-      if (injectPreferences) {
-        try {
-          const preferences = await loadGlobalPreferences();
-          await writePreferencesToAgent(targetDir, preferences);
-          logger.info(`\u2713 Applied global preferences to custom agent '${agentId}'`);
-        } catch (error) {
-          logger.warn(
-            `Failed to inject preferences to '${agentId}': ${error instanceof Error ? error.message : String(error)}`
-          );
-          console.log(
-            `\u26A0\uFE0F  Warning: Could not apply preferences to '${agentId}' - agent will use default settings`
-          );
-        }
-      }
       return mainConfigPath;
     } catch (error) {
       try {
@@ -342,9 +307,8 @@ class LocalAgentRegistry {
    * Handles installing agent if needed
    * @param agentId ID of the agent to resolve
    * @param autoInstall Whether to automatically install missing agents from registry (default: true)
-   * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
    */
-  async resolveAgent(agentId, autoInstall = true, injectPreferences = true) {
+  async resolveAgent(agentId, autoInstall = true) {
     logger.debug(`Resolving registry agent: ${agentId}`);
     const globalAgentsDir = getDextoGlobalPath("agents");
     const installedPath = path.resolve(globalAgentsDir, agentId);
@@ -361,7 +325,7 @@ class LocalAgentRegistry {
     if (this.hasAgent(agentId)) {
       if (autoInstall) {
         logger.info(`Installing agent '${agentId}' from registry...`);
-        return await this.installAgent(agentId, injectPreferences);
+        return await this.installAgent(agentId);
       } else {
         const registry2 = this.getRegistry();
         const available2 = Object.keys(registry2.agents);
@@ -397,8 +361,8 @@ class LocalAgentRegistry {
       const defaultAgent = preferences.defaults.defaultAgent;
       return agentId !== defaultAgent;
     } catch {
-      logger.warn("Could not load preferences, using fallback protection for default-agent");
-      return agentId !== "default-agent";
+      logger.warn("Could not load preferences, using fallback protection for coding-agent");
+      return agentId !== "coding-agent";
     }
   }
   /**

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");