@dexto/agent-management 1.4.0 → 1.5.0

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

@@ -50,7 +50,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;

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

@@ -15,7 +15,7 @@ import type { AgentConfig } from '@dexto/core';
 export { discoverCommandPrompts } 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: agentCard.name > filename (without extension) > 'coding-agent'
  */
 export declare function deriveAgentId(config: AgentConfig, configPath?: string): string;
 /**

package/dist/config/config-enrichment.js

@@ -15,7 +15,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;

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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"}

package/dist/index.js

@@ -59,7 +59,9 @@ import {
 import {
   saveProviderApiKey,
   getProviderKeyStatus,
-  listProviderKeyStatus
+  listProviderKeyStatus,
+  determineApiKeyStorage,
+  SHARED_API_KEY_PROVIDERS
 } from "./utils/api-key-store.js";
 import {
   resolveApiKeyForProvider,
@@ -72,11 +74,46 @@ import {
   deleteCustomModel,
   getCustomModel,
   getCustomModelsPath,
-  CustomModelSchema
+  CustomModelSchema,
+  CUSTOM_MODEL_PROVIDERS
 } from "./models/custom-models.js";
+import {
+  getModelsDirectory,
+  getModelFilePath,
+  getModelDirectory,
+  getModelStatePath,
+  getModelTempDirectory,
+  ensureModelsDirectory,
+  ensureModelDirectory,
+  modelFileExists,
+  getModelFileSize,
+  deleteModelDirectory,
+  listModelDirectories,
+  getModelsDiskUsage,
+  formatSize,
+  loadModelState,
+  saveModelState,
+  addInstalledModel,
+  removeInstalledModel,
+  getInstalledModel,
+  getAllInstalledModels,
+  isModelInstalled,
+  updateModelLastUsed,
+  setActiveModel,
+  getActiveModelId,
+  getActiveModel,
+  addToDownloadQueue,
+  removeFromDownloadQueue,
+  getDownloadQueue,
+  syncStateWithFilesystem,
+  getTotalInstalledSize,
+  getInstalledModelCount,
+  registerManualModel
+} from "./models/index.js";
 export {
   AgentFactory,
   AgentManager,
+  CUSTOM_MODEL_PROVIDERS,
   ConfigError,
   ConfigErrorCode,
   CustomModelSchema,
@@ -85,39 +122,68 @@ export {
   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,
@@ -125,13 +191,17 @@ export {
   resolveBundledScript,
   saveCustomModel,
   saveGlobalPreferences,
+  saveModelState,
   saveProviderApiKey,
+  setActiveModel,
+  syncStateWithFilesystem,
   uninstallAgent,
   updateAgentConfigFile,
   updateDefaultAgentPreference,
   updateEnvFile,
   updateGlobalPreferences,
   updateMcpServerField,
+  updateModelLastUsed,
   walkUpDirectories,
   writeConfigFile,
   writeLLMPreferences,

package/dist/installation.cjs

@@ -38,8 +38,6 @@ var import_fs = 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_errors = require("./registry/errors.js");
 var import_errors2 = require("./config/errors.js");
 function getAgentsDir(options) {
@@ -103,17 +101,6 @@ async function installBundledAgent(agentId, options) {
     }
     await import_fs.promises.rename(tempDir, targetDir);
     import_core.logger.info(`\u2713 Installed agent '${agentId}' to ${targetDir}`);
-    if (options?.injectPreferences !== false) {
-      try {
-        const preferences = await (0, import_loader.loadGlobalPreferences)();
-        await (0, import_writer.writePreferencesToAgent)(targetDir, preferences);
-        import_core.logger.info(`\u2713 Applied global preferences to '${agentId}'`);
-      } catch (error) {
-        import_core.logger.warn(
-          `Failed to inject preferences: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
-    }
     const userRegistryPath = getUserRegistryPath(agentsDir);
     const userRegistry = await loadUserRegistry(userRegistryPath);
     if (!userRegistry.agents.some((a) => a.id === agentId)) {

package/dist/installation.d.ts

@@ -2,8 +2,6 @@ import type { AgentMetadata } from './AgentManager.js';
 export interface InstallOptions {
     /** Directory where agents are stored (default: ~/.dexto/agents) */
     agentsDir?: string;
-    /** Whether to inject global preferences into agent config (default: true) */
-    injectPreferences?: boolean;
 }
 /**
  * Install agent from bundled registry to local directory

package/dist/installation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../src/installation.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC3B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAuCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC,CA0GjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,EACzE,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC,CA2FjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrF"}
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../src/installation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC3B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAuCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC,CA6FjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,EACzE,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC,CA2FjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrF"}

package/dist/installation.js

@@ -2,8 +2,6 @@ import { promises as fs } from "fs";
 import path from "path";
 import { logger } from "@dexto/core";
 import { getDextoGlobalPath, resolveBundledScript, copyDirectory } from "./utils/path.js";
-import { loadGlobalPreferences } from "./preferences/loader.js";
-import { writePreferencesToAgent } from "./writer.js";
 import { RegistryError } from "./registry/errors.js";
 import { ConfigError } from "./config/errors.js";
 function getAgentsDir(options) {
@@ -67,17 +65,6 @@ async function installBundledAgent(agentId, options) {
     }
     await fs.rename(tempDir, targetDir);
     logger.info(`\u2713 Installed agent '${agentId}' to ${targetDir}`);
-    if (options?.injectPreferences !== false) {
-      try {
-        const preferences = await loadGlobalPreferences();
-        await writePreferencesToAgent(targetDir, preferences);
-        logger.info(`\u2713 Applied global preferences to '${agentId}'`);
-      } catch (error) {
-        logger.warn(
-          `Failed to inject preferences: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
-    }
     const userRegistryPath = getUserRegistryPath(agentsDir);
     const userRegistry = await loadUserRegistry(userRegistryPath);
     if (!userRegistry.agents.some((a) => a.id === agentId)) {

package/dist/models/custom-models.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 custom_models_exports = {};
 __export(custom_models_exports, {
+  CUSTOM_MODEL_PROVIDERS: () => CUSTOM_MODEL_PROVIDERS,
   CustomModelSchema: () => CustomModelSchema,
   deleteCustomModel: () => deleteCustomModel,
   getCustomModel: () => getCustomModel,
@@ -40,12 +41,51 @@ var import_zod = require("zod");
 var import_fs = require("fs");
 var path = __toESM(require("path"), 1);
 var import_path = require("../utils/path.js");
+const CUSTOM_MODEL_PROVIDERS = [
+  "openai-compatible",
+  "openrouter",
+  "litellm",
+  "glama",
+  "bedrock",
+  "ollama",
+  "local",
+  "vertex"
+];
 const CustomModelSchema = import_zod.z.object({
   name: import_zod.z.string().min(1),
-  baseURL: import_zod.z.string().url(),
+  provider: import_zod.z.enum(CUSTOM_MODEL_PROVIDERS).default("openai-compatible"),
+  baseURL: import_zod.z.string().url().optional(),
   displayName: import_zod.z.string().optional(),
   maxInputTokens: import_zod.z.number().int().positive().optional(),
-  maxOutputTokens: import_zod.z.number().int().positive().optional()
+  maxOutputTokens: import_zod.z.number().int().positive().optional(),
+  // Optional per-model API key. For openai-compatible this is the primary key source.
+  // For litellm/glama/openrouter this overrides the provider-level env var key.
+  apiKey: import_zod.z.string().optional(),
+  // File path for local GGUF models. Required when provider is 'local'.
+  // Stores the absolute path to the .gguf file on disk.
+  filePath: import_zod.z.string().optional()
+}).superRefine((data, ctx) => {
+  if ((data.provider === "openai-compatible" || data.provider === "litellm") && !data.baseURL) {
+    ctx.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      path: ["baseURL"],
+      message: `Base URL is required for ${data.provider} provider`
+    });
+  }
+  if (data.provider === "local" && !data.filePath) {
+    ctx.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      path: ["filePath"],
+      message: "File path is required for local provider"
+    });
+  }
+  if (data.provider === "local" && data.filePath && !data.filePath.endsWith(".gguf")) {
+    ctx.addIssue({
+      code: import_zod.z.ZodIssueCode.custom,
+      path: ["filePath"],
+      message: "File path must be a .gguf file"
+    });
+  }
 });
 const StorageSchema = import_zod.z.object({
   version: import_zod.z.literal(1),
@@ -107,6 +147,7 @@ async function writeCustomModels(models) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CUSTOM_MODEL_PROVIDERS,
   CustomModelSchema,
   deleteCustomModel,
   getCustomModel,