@dexto/agent-management 1.4.0 → 1.5.1

package/dist/AgentFactory.cjs

@@ -72,8 +72,7 @@ const AgentFactory = {
   /**
    * Install a custom agent from local path
    */
-  async installCustomAgent(agentId, sourcePath, metadata, injectPreferences) {
-    const options = typeof injectPreferences === "boolean" ? { injectPreferences } : injectPreferences || {};
+  async installCustomAgent(agentId, sourcePath, metadata, options) {
     return (0, import_installation.installCustomAgent)(agentId, sourcePath, metadata, options);
   },
   /**

package/dist/AgentFactory.d.ts

@@ -78,7 +78,7 @@ export declare const AgentFactory: {
     /**
      * Install a custom agent from local path
      */
-    installCustomAgent(agentId: string, sourcePath: string, metadata: Pick<AgentMetadata, "name" | "description" | "author" | "tags">, injectPreferences?: boolean | InstallOptions): Promise<string>;
+    installCustomAgent(agentId: string, sourcePath: string, metadata: Pick<AgentMetadata, "name" | "description" | "author" | "tags">, options?: InstallOptions): Promise<string>;
     /**
      * Uninstall an agent
      * @param agentId - Agent ID to uninstall

package/dist/AgentFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAK3D,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,sBACrD,OAAO,GAAG,cAAc,GAC7C,OAAO,CAAC,MAAM,CAAC;IAUlB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAwB5F,CAAC"}
+{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAK3D,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAwB5F,CAAC"}

package/dist/AgentFactory.js

@@ -53,8 +53,7 @@ const AgentFactory = {
   /**
    * Install a custom agent from local path
    */
-  async installCustomAgent(agentId, sourcePath, metadata, injectPreferences) {
-    const options = typeof injectPreferences === "boolean" ? { injectPreferences } : injectPreferences || {};
+  async installCustomAgent(agentId, sourcePath, metadata, options) {
     return installCustomAgent(agentId, sourcePath, metadata, options);
   },
   /**

package/dist/config/config-enrichment.cjs

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var config_enrichment_exports = {};
 __export(config_enrichment_exports, {
   deriveAgentId: () => deriveAgentId,
+  discoverAgentInstructionFile: () => import_discover_prompts2.discoverAgentInstructionFile,
   discoverCommandPrompts: () => import_discover_prompts2.discoverCommandPrompts,
   enrichAgentConfig: () => enrichAgentConfig
 });
@@ -38,6 +39,10 @@ var path = __toESM(require("path"), 1);
 var import_discover_prompts = require("./discover-prompts.js");
 var import_discover_prompts2 = require("./discover-prompts.js");
 function deriveAgentId(config, configPath) {
+  if (config.agentId) {
+    const sanitizedId = config.agentId.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    return sanitizedId || "coding-agent";
+  }
   if (config.agentCard?.name) {
     const sanitizedName = config.agentCard.name.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
     if (sanitizedName) {
@@ -50,7 +55,7 @@ function deriveAgentId(config, configPath) {
       return basename;
     }
   }
-  return "default-agent";
+  return "coding-agent";
 }
 function enrichAgentConfig(config, configPath, options = {}) {
   const opts = typeof options === "boolean" ? { isInteractiveCli: options } : options;
@@ -127,11 +132,55 @@ function enrichAgentConfig(config, configPath, options = {}) {
     );
     enriched.prompts = [...existingPrompts, ...filteredDiscovered];
   }
+  const instructionFile = (0, import_discover_prompts.discoverAgentInstructionFile)();
+  if (instructionFile) {
+    const fileContributor = {
+      id: "discovered-instructions",
+      type: "file",
+      priority: 5,
+      enabled: true,
+      files: [instructionFile],
+      options: {
+        includeFilenames: true,
+        errorHandling: "skip",
+        maxFileSize: 1e5
+      }
+    };
+    if (!config.systemPrompt) {
+      enriched.systemPrompt = {
+        contributors: [fileContributor]
+      };
+    } else if (typeof config.systemPrompt === "string") {
+      enriched.systemPrompt = {
+        contributors: [
+          {
+            id: "inline",
+            type: "static",
+            content: config.systemPrompt,
+            priority: 0,
+            enabled: true
+          },
+          fileContributor
+        ]
+      };
+    } else if ("contributors" in config.systemPrompt) {
+      const existingContributors = config.systemPrompt.contributors ?? [];
+      const hasDiscoveredInstructions = existingContributors.some(
+        (c) => c.id === "discovered-instructions"
+      );
+      if (!hasDiscoveredInstructions) {
+        enriched.systemPrompt = {
+          contributors: [...existingContributors, fileContributor]
+        };
+      }
+    }
+  }
   return enriched;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   deriveAgentId,
+  discoverAgentInstructionFile,
   discoverCommandPrompts,
   enrichAgentConfig
 });

package/dist/config/config-enrichment.d.ts

@@ -12,10 +12,10 @@
  * Core services now require explicit paths - this enrichment layer provides them.
  */
 import type { AgentConfig } from '@dexto/core';
-export { discoverCommandPrompts } from './discover-prompts.js';
+export { discoverCommandPrompts, discoverAgentInstructionFile } from './discover-prompts.js';
 /**
  * Derives an agent ID from config or file path for per-agent isolation.
- * Priority: agentCard.name > filename (without extension) > 'default-agent'
+ * Priority: explicit agentId > agentCard.name > filename (without extension) > 'coding-agent'
  */
 export declare function deriveAgentId(config: AgentConfig, configPath?: string): string;
 /**

package/dist/config/config-enrichment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CA+Gb"}
+{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAoKb"}

package/dist/config/config-enrichment.js

@@ -1,8 +1,12 @@
 import { getDextoPath } from "../utils/path.js";
 import * as path from "path";
-import { discoverCommandPrompts } from "./discover-prompts.js";
-import { discoverCommandPrompts as discoverCommandPrompts2 } from "./discover-prompts.js";
+import { discoverCommandPrompts, discoverAgentInstructionFile } from "./discover-prompts.js";
+import { discoverCommandPrompts as discoverCommandPrompts2, discoverAgentInstructionFile as discoverAgentInstructionFile2 } from "./discover-prompts.js";
 function deriveAgentId(config, configPath) {
+  if (config.agentId) {
+    const sanitizedId = config.agentId.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    return sanitizedId || "coding-agent";
+  }
   if (config.agentCard?.name) {
     const sanitizedName = config.agentCard.name.toLowerCase().replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
     if (sanitizedName) {
@@ -15,7 +19,7 @@ function deriveAgentId(config, configPath) {
       return basename;
     }
   }
-  return "default-agent";
+  return "coding-agent";
 }
 function enrichAgentConfig(config, configPath, options = {}) {
   const opts = typeof options === "boolean" ? { isInteractiveCli: options } : options;
@@ -92,10 +96,54 @@ function enrichAgentConfig(config, configPath, options = {}) {
     );
     enriched.prompts = [...existingPrompts, ...filteredDiscovered];
   }
+  const instructionFile = discoverAgentInstructionFile();
+  if (instructionFile) {
+    const fileContributor = {
+      id: "discovered-instructions",
+      type: "file",
+      priority: 5,
+      enabled: true,
+      files: [instructionFile],
+      options: {
+        includeFilenames: true,
+        errorHandling: "skip",
+        maxFileSize: 1e5
+      }
+    };
+    if (!config.systemPrompt) {
+      enriched.systemPrompt = {
+        contributors: [fileContributor]
+      };
+    } else if (typeof config.systemPrompt === "string") {
+      enriched.systemPrompt = {
+        contributors: [
+          {
+            id: "inline",
+            type: "static",
+            content: config.systemPrompt,
+            priority: 0,
+            enabled: true
+          },
+          fileContributor
+        ]
+      };
+    } else if ("contributors" in config.systemPrompt) {
+      const existingContributors = config.systemPrompt.contributors ?? [];
+      const hasDiscoveredInstructions = existingContributors.some(
+        (c) => c.id === "discovered-instructions"
+      );
+      if (!hasDiscoveredInstructions) {
+        enriched.systemPrompt = {
+          contributors: [...existingContributors, fileContributor]
+        };
+      }
+    }
+  }
   return enriched;
 }
 export {
   deriveAgentId,
+  discoverAgentInstructionFile2 as discoverAgentInstructionFile,
   discoverCommandPrompts2 as discoverCommandPrompts,
   enrichAgentConfig
 };

package/dist/config/discover-prompts.cjs

@@ -28,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var discover_prompts_exports = {};
 __export(discover_prompts_exports, {
+  discoverAgentInstructionFile: () => discoverAgentInstructionFile,
   discoverCommandPrompts: () => discoverCommandPrompts
 });
 module.exports = __toCommonJS(discover_prompts_exports);
@@ -97,7 +98,19 @@ function scanCommandsDirectory(dir) {
   }
   return files;
 }
+const AGENT_INSTRUCTION_FILES = ["agent.md", "claude.md", "gemini.md"];
+function discoverAgentInstructionFile() {
+  const cwd = process.cwd();
+  for (const filename of AGENT_INSTRUCTION_FILES) {
+    const filePath = path.join(cwd, filename);
+    if ((0, import_fs.existsSync)(filePath)) {
+      return filePath;
+    }
+  }
+  return null;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  discoverAgentInstructionFile,
   discoverCommandPrompts
 });

package/dist/config/discover-prompts.d.ts

@@ -25,4 +25,17 @@ export interface FilePromptEntry {
  * @returns Array of file prompt entries for discovered .md files
  */
 export declare function discoverCommandPrompts(): FilePromptEntry[];
+/**
+ * Discovers agent instruction files from the current working directory.
+ *
+ * Looks for files in this order of priority:
+ * 1. agent.md
+ * 2. claude.md
+ * 3. gemini.md
+ *
+ * Only the first found file is returned (we don't want multiple instruction files).
+ *
+ * @returns The absolute path to the first found instruction file, or null if none found
+ */
+export declare function discoverAgentInstructionFile(): string | null;
 //# sourceMappingURL=discover-prompts.d.ts.map

package/dist/config/discover-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D"}
+{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D;AA4BD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CAW5D"}

package/dist/config/discover-prompts.js

@@ -68,6 +68,18 @@ function scanCommandsDirectory(dir) {
   }
   return files;
 }
+const AGENT_INSTRUCTION_FILES = ["agent.md", "claude.md", "gemini.md"];
+function discoverAgentInstructionFile() {
+  const cwd = process.cwd();
+  for (const filename of AGENT_INSTRUCTION_FILES) {
+    const filePath = path.join(cwd, filename);
+    if (existsSync(filePath)) {
+      return filePath;
+    }
+  }
+  return null;
+}
 export {
+  discoverAgentInstructionFile,
   discoverCommandPrompts
 };

package/dist/config/errors.cjs

@@ -72,8 +72,8 @@ class ConfigError {
       import_error_codes.ConfigErrorCode.NO_PROJECT_DEFAULT,
       import_core.ErrorScope.CONFIG,
       import_core.ErrorType.USER,
-      `No project default-agent.yml found and no global preferences configured.
-Either create default-agent.yml in your project root (${projectPath}) or run \`dexto setup\` to configure preferences.`,
+      `No project coding-agent.yml found and no global preferences configured.
+Either create coding-agent.yml in your project root (${projectPath}) or run \`dexto setup\` to configure preferences.`,
       { projectPath },
       "Run `dexto setup` or create a project-specific agent config"
     );

package/dist/config/errors.js

@@ -49,8 +49,8 @@ class ConfigError {
       ConfigErrorCode.NO_PROJECT_DEFAULT,
       ErrorScope.CONFIG,
       ErrorType.USER,
-      `No project default-agent.yml found and no global preferences configured.
-Either create default-agent.yml in your project root (${projectPath}) or run \`dexto setup\` to configure preferences.`,
+      `No project coding-agent.yml found and no global preferences configured.
+Either create coding-agent.yml in your project root (${projectPath}) or run \`dexto setup\` to configure preferences.`,
       { projectPath },
       "Run `dexto setup` or create a project-specific agent config"
     );

package/dist/index.cjs

@@ -20,6 +20,7 @@ var index_exports = {};
 __export(index_exports, {
   AgentFactory: () => import_AgentFactory.AgentFactory,
   AgentManager: () => import_AgentManager.AgentManager,
+  CUSTOM_MODEL_PROVIDERS: () => import_custom_models.CUSTOM_MODEL_PROVIDERS,
   ConfigError: () => import_config.ConfigError,
   ConfigErrorCode: () => import_config.ConfigErrorCode,
   CustomModelSchema: () => import_custom_models.CustomModelSchema,
@@ -28,39 +29,68 @@ __export(index_exports, {
   PreferenceErrorCode: () => import_errors2.PreferenceErrorCode,
   RegistryError: () => import_errors.RegistryError,
   RegistryErrorCode: () => import_error_codes.RegistryErrorCode,
+  SHARED_API_KEY_PROVIDERS: () => import_api_key_store.SHARED_API_KEY_PROVIDERS,
+  addInstalledModel: () => import_models.addInstalledModel,
   addPromptToAgentConfig: () => import_config.addPromptToAgentConfig,
+  addToDownloadQueue: () => import_models.addToDownloadQueue,
   copyDirectory: () => import_path.copyDirectory,
   createInitialPreferences: () => import_loader.createInitialPreferences,
   deleteCustomModel: () => import_custom_models.deleteCustomModel,
+  deleteModelDirectory: () => import_models.deleteModelDirectory,
   deletePromptByMetadata: () => import_config.deletePromptByMetadata,
   deriveAgentId: () => import_config.deriveAgentId,
   deriveDisplayName: () => import_types.deriveDisplayName,
+  determineApiKeyStorage: () => import_api_key_store.determineApiKeyStorage,
   enrichAgentConfig: () => import_config.enrichAgentConfig,
   ensureDextoGlobalDirectory: () => import_path.ensureDextoGlobalDirectory,
+  ensureModelDirectory: () => import_models.ensureModelDirectory,
+  ensureModelsDirectory: () => import_models.ensureModelsDirectory,
   findDextoProjectRoot: () => import_execution_context.findDextoProjectRoot,
   findDextoSourceRoot: () => import_execution_context.findDextoSourceRoot,
   findPackageRoot: () => import_path.findPackageRoot,
+  formatSize: () => import_models.formatSize,
+  getActiveModel: () => import_models.getActiveModel,
+  getActiveModelId: () => import_models.getActiveModelId,
   getAgentRegistry: () => import_registry.getAgentRegistry,
+  getAllInstalledModels: () => import_models.getAllInstalledModels,
   getCustomModel: () => import_custom_models.getCustomModel,
   getCustomModelsPath: () => import_custom_models.getCustomModelsPath,
   getDextoEnvPath: () => import_path.getDextoEnvPath,
   getDextoGlobalPath: () => import_path.getDextoGlobalPath,
   getDextoPath: () => import_path.getDextoPath,
+  getDownloadQueue: () => import_models.getDownloadQueue,
   getExecutionContext: () => import_execution_context.getExecutionContext,
   getGlobalPreferencesPath: () => import_loader.getGlobalPreferencesPath,
+  getInstalledModel: () => import_models.getInstalledModel,
+  getInstalledModelCount: () => import_models.getInstalledModelCount,
+  getModelDirectory: () => import_models.getModelDirectory,
+  getModelFilePath: () => import_models.getModelFilePath,
+  getModelFileSize: () => import_models.getModelFileSize,
+  getModelStatePath: () => import_models.getModelStatePath,
+  getModelTempDirectory: () => import_models.getModelTempDirectory,
+  getModelsDirectory: () => import_models.getModelsDirectory,
+  getModelsDiskUsage: () => import_models.getModelsDiskUsage,
   getPrimaryApiKeyEnvVar: () => import_api_key_resolver.getPrimaryApiKeyEnvVar,
   getProviderKeyStatus: () => import_api_key_store.getProviderKeyStatus,
+  getTotalInstalledSize: () => import_models.getTotalInstalledSize,
   globalPreferencesExist: () => import_loader.globalPreferencesExist,
   installBundledAgent: () => import_installation.installBundledAgent,
   installCustomAgent: () => import_installation.installCustomAgent,
+  isModelInstalled: () => import_models.isModelInstalled,
   isPath: () => import_path.isPath,
   listInstalledAgents: () => import_installation.listInstalledAgents,
+  listModelDirectories: () => import_models.listModelDirectories,
   listProviderKeyStatus: () => import_api_key_store.listProviderKeyStatus,
   loadAgentConfig: () => import_config.loadAgentConfig,
   loadBundledRegistryAgents: () => import_registry.loadBundledRegistryAgents,
   loadCustomModels: () => import_custom_models.loadCustomModels,
   loadGlobalPreferences: () => import_loader.loadGlobalPreferences,
+  loadModelState: () => import_models.loadModelState,
+  modelFileExists: () => import_models.modelFileExists,
+  registerManualModel: () => import_models.registerManualModel,
   reloadAgentConfigFromFile: () => import_config.reloadAgentConfigFromFile,
+  removeFromDownloadQueue: () => import_models.removeFromDownloadQueue,
+  removeInstalledModel: () => import_models.removeInstalledModel,
   removeMcpServerFromConfig: () => import_config.removeMcpServerFromConfig,
   removePromptFromAgentConfig: () => import_config.removePromptFromAgentConfig,
   resolveAgentPath: () => import_resolver.resolveAgentPath,
@@ -68,13 +98,17 @@ __export(index_exports, {
   resolveBundledScript: () => import_path.resolveBundledScript,
   saveCustomModel: () => import_custom_models.saveCustomModel,
   saveGlobalPreferences: () => import_loader.saveGlobalPreferences,
+  saveModelState: () => import_models.saveModelState,
   saveProviderApiKey: () => import_api_key_store.saveProviderApiKey,
+  setActiveModel: () => import_models.setActiveModel,
+  syncStateWithFilesystem: () => import_models.syncStateWithFilesystem,
   uninstallAgent: () => import_installation.uninstallAgent,
   updateAgentConfigFile: () => import_config.updateAgentConfigFile,
   updateDefaultAgentPreference: () => import_resolver.updateDefaultAgentPreference,
   updateEnvFile: () => import_env_file.updateEnvFile,
   updateGlobalPreferences: () => import_loader.updateGlobalPreferences,
   updateMcpServerField: () => import_config.updateMcpServerField,
+  updateModelLastUsed: () => import_models.updateModelLastUsed,
   walkUpDirectories: () => import_fs_walk.walkUpDirectories,
   writeConfigFile: () => import_writer.writeConfigFile,
   writeLLMPreferences: () => import_writer.writeLLMPreferences,
@@ -100,10 +134,12 @@ var import_config = require("./config/index.js");
 var import_api_key_store = require("./utils/api-key-store.js");
 var import_api_key_resolver = require("./utils/api-key-resolver.js");
 var import_custom_models = require("./models/custom-models.js");
+var import_models = require("./models/index.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentFactory,
   AgentManager,
+  CUSTOM_MODEL_PROVIDERS,
   ConfigError,
   ConfigErrorCode,
   CustomModelSchema,
@@ -112,39 +148,68 @@ var import_custom_models = require("./models/custom-models.js");
   PreferenceErrorCode,
   RegistryError,
   RegistryErrorCode,
+  SHARED_API_KEY_PROVIDERS,
+  addInstalledModel,
   addPromptToAgentConfig,
+  addToDownloadQueue,
   copyDirectory,
   createInitialPreferences,
   deleteCustomModel,
+  deleteModelDirectory,
   deletePromptByMetadata,
   deriveAgentId,
   deriveDisplayName,
+  determineApiKeyStorage,
   enrichAgentConfig,
   ensureDextoGlobalDirectory,
+  ensureModelDirectory,
+  ensureModelsDirectory,
   findDextoProjectRoot,
   findDextoSourceRoot,
   findPackageRoot,
+  formatSize,
+  getActiveModel,
+  getActiveModelId,
   getAgentRegistry,
+  getAllInstalledModels,
   getCustomModel,
   getCustomModelsPath,
   getDextoEnvPath,
   getDextoGlobalPath,
   getDextoPath,
+  getDownloadQueue,
   getExecutionContext,
   getGlobalPreferencesPath,
+  getInstalledModel,
+  getInstalledModelCount,
+  getModelDirectory,
+  getModelFilePath,
+  getModelFileSize,
+  getModelStatePath,
+  getModelTempDirectory,
+  getModelsDirectory,
+  getModelsDiskUsage,
   getPrimaryApiKeyEnvVar,
   getProviderKeyStatus,
+  getTotalInstalledSize,
   globalPreferencesExist,
   installBundledAgent,
   installCustomAgent,
+  isModelInstalled,
   isPath,
   listInstalledAgents,
+  listModelDirectories,
   listProviderKeyStatus,
   loadAgentConfig,
   loadBundledRegistryAgents,
   loadCustomModels,
   loadGlobalPreferences,
+  loadModelState,
+  modelFileExists,
+  registerManualModel,
   reloadAgentConfigFromFile,
+  removeFromDownloadQueue,
+  removeInstalledModel,
   removeMcpServerFromConfig,
   removePromptFromAgentConfig,
   resolveAgentPath,
@@ -152,13 +217,17 @@ var import_custom_models = require("./models/custom-models.js");
   resolveBundledScript,
   saveCustomModel,
   saveGlobalPreferences,
+  saveModelState,
   saveProviderApiKey,
+  setActiveModel,
+  syncStateWithFilesystem,
   uninstallAgent,
   updateAgentConfigFile,
   updateDefaultAgentPreference,
   updateEnvFile,
   updateGlobalPreferences,
   updateMcpServerField,
+  updateModelLastUsed,
   walkUpDirectories,
   writeConfigFile,
   writeLLMPreferences,

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { AgentRegistry, AgentRegistryEntry, Registry } from './registry/typ
 export { deriveDisplayName } from './registry/types.js';
 export { RegistryError } from './registry/errors.js';
 export { RegistryErrorCode } from './registry/error-codes.js';
-export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, type GlobalPreferencesUpdates, } from './preferences/loader.js';
+export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, type GlobalPreferencesUpdates, type CreatePreferencesOptions, } from './preferences/loader.js';
 export type { GlobalPreferences } from './preferences/schemas.js';
 export { PreferenceError, PreferenceErrorCode } from './preferences/errors.js';
 export { resolveAgentPath, updateDefaultAgentPreference } from './resolver.js';
@@ -16,7 +16,8 @@ export { getExecutionContext, findDextoSourceRoot, findDextoProjectRoot, type Ex
 export { walkUpDirectories } from './utils/fs-walk.js';
 export { updateEnvFile } from './utils/env-file.js';
 export { updateAgentConfigFile, reloadAgentConfigFromFile, loadAgentConfig, enrichAgentConfig, deriveAgentId, addPromptToAgentConfig, removePromptFromAgentConfig, deletePromptByMetadata, updateMcpServerField, removeMcpServerFromConfig, ConfigError, ConfigErrorCode, type FilePromptInput, type InlinePromptInput, type PromptInput, type PromptMetadataForDeletion, type PromptDeletionResult, } from './config/index.js';
-export { saveProviderApiKey, getProviderKeyStatus, listProviderKeyStatus, } from './utils/api-key-store.js';
+export { saveProviderApiKey, getProviderKeyStatus, listProviderKeyStatus, determineApiKeyStorage, SHARED_API_KEY_PROVIDERS, type ApiKeyStorageStrategy, } from './utils/api-key-store.js';
 export { resolveApiKeyForProvider, getPrimaryApiKeyEnvVar, PROVIDER_API_KEY_MAP, } from './utils/api-key-resolver.js';
-export { loadCustomModels, saveCustomModel, deleteCustomModel, getCustomModel, getCustomModelsPath, CustomModelSchema, type CustomModel, } from './models/custom-models.js';
+export { loadCustomModels, saveCustomModel, deleteCustomModel, getCustomModel, getCustomModelsPath, CustomModelSchema, CUSTOM_MODEL_PROVIDERS, type CustomModel, type CustomModelProvider, } from './models/custom-models.js';
+export { getModelsDirectory, getModelFilePath, getModelDirectory, getModelStatePath, getModelTempDirectory, ensureModelsDirectory, ensureModelDirectory, modelFileExists, getModelFileSize, deleteModelDirectory, listModelDirectories, getModelsDiskUsage, formatSize, type ModelSource, type InstalledModel, type ModelState, loadModelState, saveModelState, addInstalledModel, removeInstalledModel, getInstalledModel, getAllInstalledModels, isModelInstalled, updateModelLastUsed, setActiveModel, getActiveModelId, getActiveModel, addToDownloadQueue, removeFromDownloadQueue, getDownloadQueue, syncStateWithFilesystem, getTotalInstalledSize, getInstalledModelCount, registerManualModel, } from './models/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,wBAAwB,GAChC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAG/E,OAAO,EACH,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,YAAY,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EACH,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,KAAK,cAAc,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EACH,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,0BAA0B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,gBAAgB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EACH,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,GACvB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,WAAW,GACnB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}