@dexto/agent-management 1.2.6 → 1.4.0

package/dist/index.cjs

@@ -18,17 +18,21 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
-  AgentOrchestrator: () => import_AgentOrchestrator.AgentOrchestrator,
+  AgentFactory: () => import_AgentFactory.AgentFactory,
+  AgentManager: () => import_AgentManager.AgentManager,
   ConfigError: () => import_config.ConfigError,
   ConfigErrorCode: () => import_config.ConfigErrorCode,
-  Dexto: () => import_AgentOrchestrator2.AgentOrchestrator,
+  CustomModelSchema: () => import_custom_models.CustomModelSchema,
   PROVIDER_API_KEY_MAP: () => import_api_key_resolver.PROVIDER_API_KEY_MAP,
   PreferenceError: () => import_errors2.PreferenceError,
   PreferenceErrorCode: () => import_errors2.PreferenceErrorCode,
   RegistryError: () => import_errors.RegistryError,
   RegistryErrorCode: () => import_error_codes.RegistryErrorCode,
+  addPromptToAgentConfig: () => import_config.addPromptToAgentConfig,
   copyDirectory: () => import_path.copyDirectory,
   createInitialPreferences: () => import_loader.createInitialPreferences,
+  deleteCustomModel: () => import_custom_models.deleteCustomModel,
+  deletePromptByMetadata: () => import_config.deletePromptByMetadata,
   deriveAgentId: () => import_config.deriveAgentId,
   deriveDisplayName: () => import_types.deriveDisplayName,
   enrichAgentConfig: () => import_config.enrichAgentConfig,
@@ -37,6 +41,8 @@ __export(index_exports, {
   findDextoSourceRoot: () => import_execution_context.findDextoSourceRoot,
   findPackageRoot: () => import_path.findPackageRoot,
   getAgentRegistry: () => import_registry.getAgentRegistry,
+  getCustomModel: () => import_custom_models.getCustomModel,
+  getCustomModelsPath: () => import_custom_models.getCustomModelsPath,
   getDextoEnvPath: () => import_path.getDextoEnvPath,
   getDextoGlobalPath: () => import_path.getDextoGlobalPath,
   getDextoPath: () => import_path.getDextoPath,
@@ -45,20 +51,30 @@ __export(index_exports, {
   getPrimaryApiKeyEnvVar: () => import_api_key_resolver.getPrimaryApiKeyEnvVar,
   getProviderKeyStatus: () => import_api_key_store.getProviderKeyStatus,
   globalPreferencesExist: () => import_loader.globalPreferencesExist,
+  installBundledAgent: () => import_installation.installBundledAgent,
+  installCustomAgent: () => import_installation.installCustomAgent,
   isPath: () => import_path.isPath,
+  listInstalledAgents: () => import_installation.listInstalledAgents,
   listProviderKeyStatus: () => import_api_key_store.listProviderKeyStatus,
   loadAgentConfig: () => import_config.loadAgentConfig,
+  loadBundledRegistryAgents: () => import_registry.loadBundledRegistryAgents,
+  loadCustomModels: () => import_custom_models.loadCustomModels,
   loadGlobalPreferences: () => import_loader.loadGlobalPreferences,
   reloadAgentConfigFromFile: () => import_config.reloadAgentConfigFromFile,
+  removeMcpServerFromConfig: () => import_config.removeMcpServerFromConfig,
+  removePromptFromAgentConfig: () => import_config.removePromptFromAgentConfig,
   resolveAgentPath: () => import_resolver.resolveAgentPath,
   resolveApiKeyForProvider: () => import_api_key_resolver.resolveApiKeyForProvider,
   resolveBundledScript: () => import_path.resolveBundledScript,
+  saveCustomModel: () => import_custom_models.saveCustomModel,
   saveGlobalPreferences: () => import_loader.saveGlobalPreferences,
   saveProviderApiKey: () => import_api_key_store.saveProviderApiKey,
+  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,
   walkUpDirectories: () => import_fs_walk.walkUpDirectories,
   writeConfigFile: () => import_writer.writeConfigFile,
   writeLLMPreferences: () => import_writer.writeLLMPreferences,
@@ -73,8 +89,9 @@ var import_loader = require("./preferences/loader.js");
 var import_errors2 = require("./preferences/errors.js");
 var import_resolver = require("./resolver.js");
 var import_writer = require("./writer.js");
-var import_AgentOrchestrator = require("./AgentOrchestrator.js");
-var import_AgentOrchestrator2 = require("./AgentOrchestrator.js");
+var import_AgentManager = require("./AgentManager.js");
+var import_installation = require("./installation.js");
+var import_AgentFactory = require("./AgentFactory.js");
 var import_path = require("./utils/path.js");
 var import_execution_context = require("./utils/execution-context.js");
 var import_fs_walk = require("./utils/fs-walk.js");
@@ -82,19 +99,24 @@ var import_env_file = require("./utils/env-file.js");
 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");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AgentOrchestrator,
+  AgentFactory,
+  AgentManager,
   ConfigError,
   ConfigErrorCode,
-  Dexto,
+  CustomModelSchema,
   PROVIDER_API_KEY_MAP,
   PreferenceError,
   PreferenceErrorCode,
   RegistryError,
   RegistryErrorCode,
+  addPromptToAgentConfig,
   copyDirectory,
   createInitialPreferences,
+  deleteCustomModel,
+  deletePromptByMetadata,
   deriveAgentId,
   deriveDisplayName,
   enrichAgentConfig,
@@ -103,6 +125,8 @@ var import_api_key_resolver = require("./utils/api-key-resolver.js");
   findDextoSourceRoot,
   findPackageRoot,
   getAgentRegistry,
+  getCustomModel,
+  getCustomModelsPath,
   getDextoEnvPath,
   getDextoGlobalPath,
   getDextoPath,
@@ -111,20 +135,30 @@ var import_api_key_resolver = require("./utils/api-key-resolver.js");
   getPrimaryApiKeyEnvVar,
   getProviderKeyStatus,
   globalPreferencesExist,
+  installBundledAgent,
+  installCustomAgent,
   isPath,
+  listInstalledAgents,
   listProviderKeyStatus,
   loadAgentConfig,
+  loadBundledRegistryAgents,
+  loadCustomModels,
   loadGlobalPreferences,
   reloadAgentConfigFromFile,
+  removeMcpServerFromConfig,
+  removePromptFromAgentConfig,
   resolveAgentPath,
   resolveApiKeyForProvider,
   resolveBundledScript,
+  saveCustomModel,
   saveGlobalPreferences,
   saveProviderApiKey,
+  uninstallAgent,
   updateAgentConfigFile,
   updateDefaultAgentPreference,
   updateEnvFile,
   updateGlobalPreferences,
+  updateMcpServerField,
   walkUpDirectories,
   writeConfigFile,
   writeLLMPreferences,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { getAgentRegistry } from './registry/registry.js';
+export { getAgentRegistry, loadBundledRegistryAgents } from './registry/registry.js';
 export type { AgentRegistry, AgentRegistryEntry, Registry } from './registry/types.js';
 export { deriveDisplayName } from './registry/types.js';
 export { RegistryError } from './registry/errors.js';
@@ -8,13 +8,15 @@ export type { GlobalPreferences } from './preferences/schemas.js';
 export { PreferenceError, PreferenceErrorCode } from './preferences/errors.js';
 export { resolveAgentPath, updateDefaultAgentPreference } from './resolver.js';
 export { writeConfigFile, writeLLMPreferences, writePreferencesToAgent, type LLMOverrides, } from './writer.js';
-export { AgentOrchestrator } from './AgentOrchestrator.js';
-export { AgentOrchestrator as Dexto } from './AgentOrchestrator.js';
+export { AgentManager, type AgentMetadata } from './AgentManager.js';
+export { installBundledAgent, installCustomAgent, uninstallAgent, listInstalledAgents, type InstallOptions, } from './installation.js';
+export { AgentFactory, type CreateAgentOptions } from './AgentFactory.js';
 export { getDextoPath, getDextoGlobalPath, getDextoEnvPath, copyDirectory, isPath, findPackageRoot, resolveBundledScript, ensureDextoGlobalDirectory, } from './utils/path.js';
 export { getExecutionContext, findDextoSourceRoot, findDextoProjectRoot, type ExecutionContext, } from './utils/execution-context.js';
 export { walkUpDirectories } from './utils/fs-walk.js';
 export { updateEnvFile } from './utils/env-file.js';
-export { updateAgentConfigFile, reloadAgentConfigFromFile, loadAgentConfig, enrichAgentConfig, deriveAgentId, ConfigError, ConfigErrorCode, } from './config/index.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 { 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';
 //# 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,MAAM,wBAAwB,CAAC;AAC1D,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,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,iBAAiB,IAAI,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAGpE,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,WAAW,EACX,eAAe,GAClB,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"}
+{"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"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { getAgentRegistry } from "./registry/registry.js";
+import { getAgentRegistry, loadBundledRegistryAgents } from "./registry/registry.js";
 import { deriveDisplayName } from "./registry/types.js";
 import { RegistryError } from "./registry/errors.js";
 import { RegistryErrorCode } from "./registry/error-codes.js";
@@ -17,8 +17,14 @@ import {
   writeLLMPreferences,
   writePreferencesToAgent
 } from "./writer.js";
-import { AgentOrchestrator } from "./AgentOrchestrator.js";
-import { AgentOrchestrator as AgentOrchestrator2 } from "./AgentOrchestrator.js";
+import { AgentManager } from "./AgentManager.js";
+import {
+  installBundledAgent,
+  installCustomAgent,
+  uninstallAgent,
+  listInstalledAgents
+} from "./installation.js";
+import { AgentFactory } from "./AgentFactory.js";
 import {
   getDextoPath,
   getDextoGlobalPath,
@@ -42,6 +48,11 @@ import {
   loadAgentConfig,
   enrichAgentConfig,
   deriveAgentId,
+  addPromptToAgentConfig,
+  removePromptFromAgentConfig,
+  deletePromptByMetadata,
+  updateMcpServerField,
+  removeMcpServerFromConfig,
   ConfigError,
   ConfigErrorCode
 } from "./config/index.js";
@@ -55,18 +66,30 @@ import {
   getPrimaryApiKeyEnvVar,
   PROVIDER_API_KEY_MAP
 } from "./utils/api-key-resolver.js";
+import {
+  loadCustomModels,
+  saveCustomModel,
+  deleteCustomModel,
+  getCustomModel,
+  getCustomModelsPath,
+  CustomModelSchema
+} from "./models/custom-models.js";
 export {
-  AgentOrchestrator,
+  AgentFactory,
+  AgentManager,
   ConfigError,
   ConfigErrorCode,
-  AgentOrchestrator2 as Dexto,
+  CustomModelSchema,
   PROVIDER_API_KEY_MAP,
   PreferenceError,
   PreferenceErrorCode,
   RegistryError,
   RegistryErrorCode,
+  addPromptToAgentConfig,
   copyDirectory,
   createInitialPreferences,
+  deleteCustomModel,
+  deletePromptByMetadata,
   deriveAgentId,
   deriveDisplayName,
   enrichAgentConfig,
@@ -75,6 +98,8 @@ export {
   findDextoSourceRoot,
   findPackageRoot,
   getAgentRegistry,
+  getCustomModel,
+  getCustomModelsPath,
   getDextoEnvPath,
   getDextoGlobalPath,
   getDextoPath,
@@ -83,20 +108,30 @@ export {
   getPrimaryApiKeyEnvVar,
   getProviderKeyStatus,
   globalPreferencesExist,
+  installBundledAgent,
+  installCustomAgent,
   isPath,
+  listInstalledAgents,
   listProviderKeyStatus,
   loadAgentConfig,
+  loadBundledRegistryAgents,
+  loadCustomModels,
   loadGlobalPreferences,
   reloadAgentConfigFromFile,
+  removeMcpServerFromConfig,
+  removePromptFromAgentConfig,
   resolveAgentPath,
   resolveApiKeyForProvider,
   resolveBundledScript,
+  saveCustomModel,
   saveGlobalPreferences,
   saveProviderApiKey,
+  uninstallAgent,
   updateAgentConfigFile,
   updateDefaultAgentPreference,
   updateEnvFile,
   updateGlobalPreferences,
+  updateMcpServerField,
   walkUpDirectories,
   writeConfigFile,
   writeLLMPreferences,

package/dist/installation.cjs

@@ -0,0 +1,252 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var installation_exports = {};
+__export(installation_exports, {
+  installBundledAgent: () => installBundledAgent,
+  installCustomAgent: () => installCustomAgent,
+  listInstalledAgents: () => listInstalledAgents,
+  uninstallAgent: () => uninstallAgent
+});
+module.exports = __toCommonJS(installation_exports);
+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) {
+  return options?.agentsDir ?? (0, import_path2.getDextoGlobalPath)("agents");
+}
+function getUserRegistryPath(agentsDir) {
+  return import_path.default.join(agentsDir, "registry.json");
+}
+async function loadUserRegistry(registryPath) {
+  try {
+    const content = await import_fs.promises.readFile(registryPath, "utf-8");
+    return JSON.parse(content);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return { agents: [] };
+    }
+    throw error;
+  }
+}
+async function saveUserRegistry(registryPath, registry) {
+  await import_fs.promises.mkdir(import_path.default.dirname(registryPath), { recursive: true });
+  await import_fs.promises.writeFile(registryPath, JSON.stringify(registry, null, 2));
+}
+async function installBundledAgent(agentId, options) {
+  const agentsDir = getAgentsDir(options);
+  const bundledRegistryPath = (0, import_path2.resolveBundledScript)("agents/agent-registry.json");
+  import_core.logger.info(`Installing agent: ${agentId}`);
+  let bundledRegistry;
+  try {
+    const content = await import_fs.promises.readFile(bundledRegistryPath, "utf-8");
+    bundledRegistry = JSON.parse(content);
+  } catch (error) {
+    throw import_errors.RegistryError.registryParseError(
+      bundledRegistryPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  const agentEntry = bundledRegistry.agents[agentId];
+  if (!agentEntry) {
+    const available = Object.keys(bundledRegistry.agents);
+    throw import_errors.RegistryError.agentNotFound(agentId, available);
+  }
+  const targetDir = import_path.default.join(agentsDir, agentId);
+  try {
+    await import_fs.promises.access(targetDir);
+    import_core.logger.info(`Agent '${agentId}' already installed`);
+    const mainFile = agentEntry.main || import_path.default.basename(agentEntry.source);
+    return import_path.default.join(targetDir, mainFile);
+  } catch {
+  }
+  await import_fs.promises.mkdir(agentsDir, { recursive: true });
+  const sourcePath = (0, import_path2.resolveBundledScript)(`agents/${agentEntry.source}`);
+  const tempDir = `${targetDir}.tmp.${Date.now()}`;
+  try {
+    if (agentEntry.source.endsWith("/")) {
+      await (0, import_path2.copyDirectory)(sourcePath, tempDir);
+    } else {
+      await import_fs.promises.mkdir(tempDir, { recursive: true });
+      const targetFile = import_path.default.join(tempDir, import_path.default.basename(sourcePath));
+      await import_fs.promises.copyFile(sourcePath, targetFile);
+    }
+    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)) {
+      const mainFile = agentEntry.main || import_path.default.basename(agentEntry.source);
+      userRegistry.agents.push({
+        id: agentId,
+        name: agentEntry.name,
+        description: agentEntry.description,
+        configPath: `./${agentId}/${mainFile}`,
+        author: agentEntry.author,
+        tags: agentEntry.tags
+      });
+      await saveUserRegistry(userRegistryPath, userRegistry);
+    }
+    return import_path.default.join(targetDir, agentEntry.main || import_path.default.basename(agentEntry.source));
+  } catch (error) {
+    try {
+      await import_fs.promises.rm(tempDir, { recursive: true, force: true });
+    } catch {
+    }
+    throw import_errors.RegistryError.installationFailed(
+      agentId,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+async function installCustomAgent(agentId, sourcePath, metadata, options) {
+  const agentsDir = getAgentsDir(options);
+  const targetDir = import_path.default.join(agentsDir, agentId);
+  import_core.logger.info(`Installing custom agent: ${agentId}`);
+  try {
+    const bundledRegistryPath = (0, import_path2.resolveBundledScript)("agents/agent-registry.json");
+    const bundledContent = await import_fs.promises.readFile(bundledRegistryPath, "utf-8");
+    const bundledRegistry = JSON.parse(bundledContent);
+    if (agentId in bundledRegistry.agents) {
+      throw import_errors.RegistryError.customAgentNameConflict(agentId);
+    }
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("conflicts with builtin")) {
+      throw error;
+    }
+    import_core.logger.debug(
+      `Could not validate against bundled registry: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  try {
+    await import_fs.promises.access(targetDir);
+    throw import_errors.RegistryError.agentAlreadyExists(agentId);
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
+  }
+  const resolvedSource = import_path.default.resolve(sourcePath);
+  let stat;
+  try {
+    stat = await import_fs.promises.stat(resolvedSource);
+  } catch (_error) {
+    throw import_errors2.ConfigError.fileNotFound(resolvedSource);
+  }
+  await import_fs.promises.mkdir(agentsDir, { recursive: true });
+  try {
+    if (stat.isDirectory()) {
+      await (0, import_path2.copyDirectory)(resolvedSource, targetDir);
+    } else {
+      await import_fs.promises.mkdir(targetDir, { recursive: true });
+      const filename = import_path.default.basename(resolvedSource);
+      await import_fs.promises.copyFile(resolvedSource, import_path.default.join(targetDir, filename));
+    }
+    import_core.logger.info(`\u2713 Installed custom agent '${agentId}' to ${targetDir}`);
+    const userRegistryPath = getUserRegistryPath(agentsDir);
+    const userRegistry = await loadUserRegistry(userRegistryPath);
+    const configFile = stat.isDirectory() ? "agent.yml" : import_path.default.basename(resolvedSource);
+    userRegistry.agents.push({
+      id: agentId,
+      name: metadata.name || agentId,
+      description: metadata.description,
+      configPath: `./${agentId}/${configFile}`,
+      author: metadata.author,
+      tags: metadata.tags || []
+    });
+    await saveUserRegistry(userRegistryPath, userRegistry);
+    return import_path.default.join(targetDir, configFile);
+  } catch (error) {
+    try {
+      await import_fs.promises.rm(targetDir, { recursive: true, force: true });
+    } catch {
+    }
+    throw import_errors.RegistryError.installationFailed(
+      agentId,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+async function uninstallAgent(agentId, options) {
+  const agentsDir = getAgentsDir(options);
+  const targetDir = import_path.default.join(agentsDir, agentId);
+  import_core.logger.info(`Uninstalling agent: ${agentId}`);
+  try {
+    await import_fs.promises.access(targetDir);
+  } catch (_error) {
+    throw import_errors.RegistryError.agentNotInstalled(agentId);
+  }
+  await import_fs.promises.rm(targetDir, { recursive: true, force: true });
+  import_core.logger.info(`\u2713 Removed agent directory: ${targetDir}`);
+  const userRegistryPath = getUserRegistryPath(agentsDir);
+  try {
+    const userRegistry = await loadUserRegistry(userRegistryPath);
+    userRegistry.agents = userRegistry.agents.filter((a) => a.id !== agentId);
+    await saveUserRegistry(userRegistryPath, userRegistry);
+    import_core.logger.info(`\u2713 Removed '${agentId}' from user registry`);
+  } catch (error) {
+    import_core.logger.warn(
+      `Failed to update user registry: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+async function listInstalledAgents(options) {
+  const agentsDir = getAgentsDir(options);
+  try {
+    const entries = await import_fs.promises.readdir(agentsDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return [];
+    }
+    throw error;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  installBundledAgent,
+  installCustomAgent,
+  listInstalledAgents,
+  uninstallAgent
+});

package/dist/installation.d.ts

@@ -0,0 +1,74 @@
+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
+ *
+ * @param agentId ID of the agent to install from bundled registry
+ * @param options Installation options
+ * @returns Path to the installed agent's main config file
+ *
+ * @throws {DextoRuntimeError} If agent not found in bundled registry or installation fails
+ *
+ * @example
+ * ```typescript
+ * await installBundledAgent('coding-agent');
+ * console.log('Agent installed to ~/.dexto/agents/coding-agent');
+ * ```
+ */
+export declare function installBundledAgent(agentId: string, options?: InstallOptions): Promise<string>;
+/**
+ * Install custom agent from local path
+ *
+ * @param agentId Unique ID for the custom agent
+ * @param sourcePath Absolute path to agent YAML file or directory
+ * @param metadata Agent metadata (name, description, author, tags)
+ * @param options Installation options
+ * @returns Path to the installed agent's main config file
+ *
+ * @throws {DextoRuntimeError} If agent ID already exists or installation fails
+ *
+ * @example
+ * ```typescript
+ * await installCustomAgent('my-agent', '/path/to/agent.yml', {
+ *   name: 'My Agent',
+ *   description: 'Custom agent for my use case',
+ *   author: 'John Doe',
+ *   tags: ['custom']
+ * });
+ * ```
+ */
+export declare function installCustomAgent(agentId: string, sourcePath: string, metadata: Pick<AgentMetadata, 'name' | 'description' | 'author' | 'tags'>, options?: InstallOptions): Promise<string>;
+/**
+ * Uninstall agent by removing it from disk and user registry
+ *
+ * @param agentId ID of the agent to uninstall
+ * @param options Installation options
+ *
+ * @throws {DextoRuntimeError} If agent not installed
+ *
+ * @example
+ * ```typescript
+ * await uninstallAgent('my-custom-agent');
+ * console.log('Agent uninstalled');
+ * ```
+ */
+export declare function uninstallAgent(agentId: string, options?: InstallOptions): Promise<void>;
+/**
+ * List installed agents
+ *
+ * @param options Installation options
+ * @returns Array of installed agent IDs
+ *
+ * @example
+ * ```typescript
+ * const installed = await listInstalledAgents();
+ * console.log(installed); // ['coding-agent', 'my-custom-agent']
+ * ```
+ */
+export declare function listInstalledAgents(options?: InstallOptions): Promise<string[]>;
+//# sourceMappingURL=installation.d.ts.map

package/dist/installation.d.ts.map

@@ -0,0 +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"}