@dexto/agent-management 1.3.0 → 1.4.0

package/dist/resolver.cjs

@@ -39,6 +39,9 @@ var import_execution_context = require("./utils/execution-context.js");
 var import_core = require("@dexto/core");
 var import_loader = require("./preferences/loader.js");
 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) {
   if (nameOrPath && (0, import_path2.isPath)(nameOrPath)) {
     const resolved = import_path.default.resolve(nameOrPath);
@@ -53,12 +56,47 @@ async function resolveAgentPath(nameOrPath, autoInstall = true, injectPreference
     }
   }
   if (nameOrPath) {
-    const { getAgentRegistry } = await import("./registry/registry.js");
-    const registry = getAgentRegistry();
-    return await registry.resolveAgent(nameOrPath, autoInstall, injectPreferences);
+    return await resolveAgentByName(nameOrPath, autoInstall, injectPreferences);
   }
   return await resolveDefaultAgentByContext(autoInstall, injectPreferences);
 }
+async function resolveAgentByName(agentId, autoInstall, injectPreferences) {
+  const agentsDir = (0, import_path2.getDextoGlobalPath)("agents");
+  const installedRegistryPath = import_path.default.join(agentsDir, "registry.json");
+  try {
+    const manager = new import_AgentManager.AgentManager(installedRegistryPath);
+    await manager.loadRegistry();
+    if (manager.hasAgent(agentId)) {
+      const agentPath = await getAgentConfigPath(agentId);
+      return agentPath;
+    }
+  } catch (error) {
+    import_core.logger.debug(`Agent '${agentId}' not found in installed registry: ${error}`);
+  }
+  if (autoInstall) {
+    try {
+      import_core.logger.info(`Auto-installing agent '${agentId}' from bundled registry`);
+      const configPath = await (0, import_installation.installBundledAgent)(agentId, { injectPreferences });
+      return configPath;
+    } catch (error) {
+      import_core.logger.debug(`Failed to auto-install agent '${agentId}': ${error}`);
+      throw import_errors.RegistryError.agentNotFound(agentId, []);
+    }
+  }
+  throw import_errors.RegistryError.agentNotInstalledAutoInstallDisabled(agentId, []);
+}
+async function getAgentConfigPath(agentId) {
+  const agentsDir = (0, import_path2.getDextoGlobalPath)("agents");
+  const installedRegistryPath = import_path.default.join(agentsDir, "registry.json");
+  const registryContent = await import_fs.promises.readFile(installedRegistryPath, "utf-8");
+  const registry = JSON.parse(registryContent);
+  const agentEntry = registry.agents.find((a) => a.id === agentId);
+  if (!agentEntry) {
+    const available = registry.agents.map((a) => a.id);
+    throw import_errors.RegistryError.agentNotFound(agentId, available);
+  }
+  return import_path.default.resolve(import_path.default.dirname(installedRegistryPath), agentEntry.configPath);
+}
 async function resolveDefaultAgentByContext(autoInstall = true, injectPreferences = true) {
   const executionContext = (0, import_execution_context.getExecutionContext)();
   switch (executionContext) {
@@ -95,13 +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;
-        const { getAgentRegistry } = await import("./registry/registry.js");
-        const registry = getAgentRegistry();
-        return await registry.resolveAgent(
-          preferredAgentName,
-          autoInstall,
-          injectPreferences
-        );
+        return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
       }
     } catch (error) {
       import_core.logger.warn(`Failed to load preferences, falling back to repo config: ${error}`);
@@ -142,9 +174,7 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPref
     throw import_config.ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  const { getAgentRegistry } = await import("./registry/registry.js");
-  const registry = getAgentRegistry();
-  return await registry.resolveAgent(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
 }
 async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPreferences = true) {
   import_core.logger.debug("Resolving default agent for global CLI context");
@@ -156,24 +186,33 @@ async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPrefere
     throw import_config.ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  const { getAgentRegistry } = await import("./registry/registry.js");
-  const registry = getAgentRegistry();
-  return await registry.resolveAgent(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
 }
 async function updateDefaultAgentPreference(agentName) {
-  const { getAgentRegistry } = await import("./registry/registry.js");
-  const { RegistryError } = await import("./registry/errors.js");
-  const { isPath: isPath2 } = await import("@dexto/core");
-  const registry = getAgentRegistry();
-  if (isPath2(agentName) || !registry.hasAgent(agentName)) {
-    const available = Object.keys(registry.getAvailableAgents());
-    throw RegistryError.agentNotFound(agentName, available);
-  }
-  const { updateGlobalPreferences } = await import("./preferences/loader.js");
-  await updateGlobalPreferences({
-    defaults: { defaultAgent: agentName }
-  });
-  import_core.logger.info(`Updated default agent preference to: ${agentName}`);
+  const agentsDir = (0, import_path2.getDextoGlobalPath)("agents");
+  const installedRegistryPath = import_path.default.join(agentsDir, "registry.json");
+  const bundledRegistryPath = (0, import_path2.resolveBundledScript)("agents/agent-registry.json");
+  const registriesToCheck = [
+    { path: installedRegistryPath, name: "installed" },
+    { path: bundledRegistryPath, name: "bundled" }
+  ];
+  for (const registry of registriesToCheck) {
+    try {
+      const manager = new import_AgentManager.AgentManager(registry.path);
+      await manager.loadRegistry();
+      if (manager.hasAgent(agentName)) {
+        const { updateGlobalPreferences } = await import("./preferences/loader.js");
+        await updateGlobalPreferences({
+          defaults: { defaultAgent: agentName }
+        });
+        import_core.logger.info(`Updated default agent preference to: ${agentName}`);
+        return;
+      }
+    } catch (error) {
+      import_core.logger.debug(`Agent '${agentName}' not found in ${registry.name} registry: ${error}`);
+    }
+  }
+  throw import_errors.RegistryError.agentNotFound(agentName, []);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/resolver.d.ts

@@ -1,14 +1,17 @@
 /**
- * Resolve agent path with preference integration
+ * 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 registry (default: true)
+ * @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 DextoRuntimeError for any resolution failures
+ * @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>;
 /**
  * Update default agent preference
+ * @param agentName The agent name to set as the new default
+ * @throws {RegistryError} If the agent is not found in installed or bundled registry
  */
 export declare function updateDefaultAgentPreference(agentName: string): Promise<void>;
 //# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAClC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAc,EAC3B,iBAAiB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAoKD;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnF"}
+{"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"}

package/dist/resolver.js

@@ -1,6 +1,6 @@
 import { promises as fs } from "fs";
 import path from "path";
-import { isPath } from "./utils/path.js";
+import { isPath, getDextoGlobalPath, resolveBundledScript } from "./utils/path.js";
 import {
   getExecutionContext,
   findDextoSourceRoot,
@@ -9,6 +9,9 @@ import {
 import { logger } from "@dexto/core";
 import { loadGlobalPreferences, globalPreferencesExist } from "./preferences/loader.js";
 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) {
   if (nameOrPath && isPath(nameOrPath)) {
     const resolved = path.resolve(nameOrPath);
@@ -23,12 +26,47 @@ async function resolveAgentPath(nameOrPath, autoInstall = true, injectPreference
     }
   }
   if (nameOrPath) {
-    const { getAgentRegistry } = await import("./registry/registry.js");
-    const registry = getAgentRegistry();
-    return await registry.resolveAgent(nameOrPath, autoInstall, injectPreferences);
+    return await resolveAgentByName(nameOrPath, autoInstall, injectPreferences);
   }
   return await resolveDefaultAgentByContext(autoInstall, injectPreferences);
 }
+async function resolveAgentByName(agentId, autoInstall, injectPreferences) {
+  const agentsDir = getDextoGlobalPath("agents");
+  const installedRegistryPath = path.join(agentsDir, "registry.json");
+  try {
+    const manager = new AgentManager(installedRegistryPath);
+    await manager.loadRegistry();
+    if (manager.hasAgent(agentId)) {
+      const agentPath = await getAgentConfigPath(agentId);
+      return agentPath;
+    }
+  } catch (error) {
+    logger.debug(`Agent '${agentId}' not found in installed registry: ${error}`);
+  }
+  if (autoInstall) {
+    try {
+      logger.info(`Auto-installing agent '${agentId}' from bundled registry`);
+      const configPath = await installBundledAgent(agentId, { injectPreferences });
+      return configPath;
+    } catch (error) {
+      logger.debug(`Failed to auto-install agent '${agentId}': ${error}`);
+      throw RegistryError.agentNotFound(agentId, []);
+    }
+  }
+  throw RegistryError.agentNotInstalledAutoInstallDisabled(agentId, []);
+}
+async function getAgentConfigPath(agentId) {
+  const agentsDir = getDextoGlobalPath("agents");
+  const installedRegistryPath = path.join(agentsDir, "registry.json");
+  const registryContent = await fs.readFile(installedRegistryPath, "utf-8");
+  const registry = JSON.parse(registryContent);
+  const agentEntry = registry.agents.find((a) => a.id === agentId);
+  if (!agentEntry) {
+    const available = registry.agents.map((a) => a.id);
+    throw RegistryError.agentNotFound(agentId, available);
+  }
+  return path.resolve(path.dirname(installedRegistryPath), agentEntry.configPath);
+}
 async function resolveDefaultAgentByContext(autoInstall = true, injectPreferences = true) {
   const executionContext = getExecutionContext();
   switch (executionContext) {
@@ -65,13 +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;
-        const { getAgentRegistry } = await import("./registry/registry.js");
-        const registry = getAgentRegistry();
-        return await registry.resolveAgent(
-          preferredAgentName,
-          autoInstall,
-          injectPreferences
-        );
+        return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
       }
     } catch (error) {
       logger.warn(`Failed to load preferences, falling back to repo config: ${error}`);
@@ -112,9 +144,7 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true, injectPref
     throw ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  const { getAgentRegistry } = await import("./registry/registry.js");
-  const registry = getAgentRegistry();
-  return await registry.resolveAgent(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
 }
 async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPreferences = true) {
   logger.debug("Resolving default agent for global CLI context");
@@ -126,24 +156,33 @@ async function resolveDefaultAgentForGlobalCLI(autoInstall = true, injectPrefere
     throw ConfigError.setupIncomplete();
   }
   const preferredAgentName = preferences.defaults.defaultAgent;
-  const { getAgentRegistry } = await import("./registry/registry.js");
-  const registry = getAgentRegistry();
-  return await registry.resolveAgent(preferredAgentName, autoInstall, injectPreferences);
+  return await resolveAgentByName(preferredAgentName, autoInstall, injectPreferences);
 }
 async function updateDefaultAgentPreference(agentName) {
-  const { getAgentRegistry } = await import("./registry/registry.js");
-  const { RegistryError } = await import("./registry/errors.js");
-  const { isPath: isPath2 } = await import("@dexto/core");
-  const registry = getAgentRegistry();
-  if (isPath2(agentName) || !registry.hasAgent(agentName)) {
-    const available = Object.keys(registry.getAvailableAgents());
-    throw RegistryError.agentNotFound(agentName, available);
-  }
-  const { updateGlobalPreferences } = await import("./preferences/loader.js");
-  await updateGlobalPreferences({
-    defaults: { defaultAgent: agentName }
-  });
-  logger.info(`Updated default agent preference to: ${agentName}`);
+  const agentsDir = getDextoGlobalPath("agents");
+  const installedRegistryPath = path.join(agentsDir, "registry.json");
+  const bundledRegistryPath = resolveBundledScript("agents/agent-registry.json");
+  const registriesToCheck = [
+    { path: installedRegistryPath, name: "installed" },
+    { path: bundledRegistryPath, name: "bundled" }
+  ];
+  for (const registry of registriesToCheck) {
+    try {
+      const manager = new AgentManager(registry.path);
+      await manager.loadRegistry();
+      if (manager.hasAgent(agentName)) {
+        const { updateGlobalPreferences } = await import("./preferences/loader.js");
+        await updateGlobalPreferences({
+          defaults: { defaultAgent: agentName }
+        });
+        logger.info(`Updated default agent preference to: ${agentName}`);
+        return;
+      }
+    } catch (error) {
+      logger.debug(`Agent '${agentName}' not found in ${registry.name} registry: ${error}`);
+    }
+  }
+  throw RegistryError.agentNotFound(agentName, []);
 }
 export {
   resolveAgentPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,7 @@
   "dependencies": {
     "yaml": "^2.7.1",
     "zod": "^3.25.0",
-    "@dexto/core": "1.3.0"
+    "@dexto/core": "1.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"

package/dist/AgentOrchestrator.cjs

@@ -1,263 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var AgentOrchestrator_exports = {};
-__export(AgentOrchestrator_exports, {
-  AgentOrchestrator: () => AgentOrchestrator
-});
-module.exports = __toCommonJS(AgentOrchestrator_exports);
-var import_core = require("@dexto/core");
-var import_config = require("./config/index.js");
-var import_registry = require("./registry/registry.js");
-var import_types = require("./registry/types.js");
-var import_zod = require("zod");
-var import_core2 = require("@dexto/core");
-class AgentOrchestrator {
-  /**
-   * Lists available and installed agents from the registry.
-   * Returns a structured object containing both installed and available agents,
-   * along with metadata like descriptions, authors, and tags.
-   *
-   * @returns Promise resolving to object with installed and available agent lists
-   *
-   * @example
-   * ```typescript
-   * const agents = await AgentOrchestrator.listAgents();
-   * console.log(agents.installed); // ['default', 'my-custom-agent']
-   * console.log(agents.available); // [{ name: 'productivity', description: '...', ... }]
-   * console.log(agents.current?.name); // 'default'
-   * ```
-   */
-  static async listAgents() {
-    const agentRegistry = (0, import_registry.getAgentRegistry)();
-    const availableMap = agentRegistry.getAvailableAgents();
-    const installedNames = await agentRegistry.getInstalledAgents();
-    const installed = await Promise.all(
-      installedNames.map(async (agentId) => {
-        const registryEntry = availableMap[agentId];
-        if (registryEntry) {
-          return {
-            id: agentId,
-            name: registryEntry.name,
-            description: registryEntry.description,
-            author: registryEntry.author,
-            tags: registryEntry.tags,
-            type: registryEntry.type
-          };
-        } else {
-          try {
-            const config = await (0, import_config.loadAgentConfig)(agentId);
-            const author = config.agentCard?.provider?.organization;
-            const result = {
-              id: agentId,
-              name: typeof config.agentCard?.name === "string" ? config.agentCard.name : (0, import_types.deriveDisplayName)(agentId),
-              description: config.agentCard?.description || "Local agent",
-              tags: [],
-              type: "custom"
-              // Assume custom if not in registry
-            };
-            if (author) {
-              result.author = author;
-            }
-            return result;
-          } catch {
-            const result = {
-              id: agentId,
-              name: (0, import_types.deriveDisplayName)(agentId),
-              description: "Local agent (config unavailable)",
-              tags: [],
-              type: "custom"
-              // Assume custom if not in registry
-            };
-            return result;
-          }
-        }
-      })
-    );
-    const available = Object.entries(availableMap).filter(([agentId]) => !installedNames.includes(agentId)).map(([agentId, entry]) => ({
-      id: agentId,
-      name: entry.name,
-      description: entry.description,
-      author: entry.author,
-      tags: entry.tags,
-      type: entry.type
-    }));
-    return {
-      installed,
-      available,
-      current: { id: null, name: null }
-      // TODO: Track current agent name
-    };
-  }
-  /**
-   * Installs an agent from the registry.
-   * Downloads and sets up the specified agent, making it available for use.
-   *
-   * @param agentName The name of the agent to install from the registry
-   * @returns Promise that resolves when installation is complete
-   *
-   * @throws {AgentError} When agent is not found in registry or installation fails
-   *
-   * @example
-   * ```typescript
-   * await AgentOrchestrator.installAgent('productivity');
-   * console.log('Productivity agent installed successfully');
-   * ```
-   */
-  static async installAgent(agentName) {
-    const agentRegistry = (0, import_registry.getAgentRegistry)();
-    if (!agentRegistry.hasAgent(agentName)) {
-      throw import_core.AgentError.apiValidationError(`Agent '${agentName}' not found in registry`);
-    }
-    try {
-      await agentRegistry.installAgent(agentName, true);
-      import_core.logger.info(`Successfully installed agent: ${agentName}`);
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      import_core.logger.error(`Failed to install agent ${agentName}: ${errorMessage}`);
-      throw import_core.AgentError.apiValidationError(
-        `Installation failed for agent '${agentName}'`,
-        error
-      );
-    }
-  }
-  /**
-   * Installs a custom agent from a local file or directory path.
-   * Creates a new custom agent entry in the user registry with provided metadata.
-   *
-   * @param agentName The name to use for the custom agent (must be unique)
-   * @param sourcePath Absolute path to the agent YAML file or directory
-   * @param metadata Agent metadata (description, author, tags, main config file)
-   * @param injectPreferences Whether to inject global preferences into agent config (default: true)
-   * @returns Promise resolving to the path of the installed main config file
-   *
-   * @throws {AgentError} When name conflicts with existing agent or installation fails
-   *
-   * @example
-   * ```typescript
-   * await AgentOrchestrator.installCustomAgent('my-coding-agent', '/path/to/agent.yml', {
-   *   description: 'Custom coding assistant',
-   *   author: 'John Doe',
-   *   tags: ['coding', 'custom']
-   * });
-   * console.log('Custom agent installed successfully');
-   * ```
-   */
-  static async installCustomAgent(agentName, sourcePath, metadata, injectPreferences = true) {
-    const agentRegistry = (0, import_registry.getAgentRegistry)();
-    try {
-      const mainConfigPath = await agentRegistry.installCustomAgentFromPath(
-        agentName,
-        sourcePath,
-        metadata,
-        injectPreferences
-      );
-      import_core.logger.info(`Successfully installed custom agent: ${agentName}`);
-      return mainConfigPath;
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      import_core.logger.error(`Failed to install custom agent ${agentName}: ${errorMessage}`);
-      throw import_core.AgentError.apiValidationError(
-        `Installation failed for custom agent '${agentName}'`,
-        error
-      );
-    }
-  }
-  /**
-   * Uninstalls an agent by removing its directory from disk.
-   * For custom agents: also removes from user registry.
-   * For builtin agents: only removes from disk (can be reinstalled).
-   *
-   * @param agentName The name of the agent to uninstall
-   * @param force Whether to force uninstall even if agent is protected (default: false)
-   * @returns Promise that resolves when uninstallation is complete
-   *
-   * @throws {AgentError} When agent is not installed or uninstallation fails
-   *
-   * @example
-   * ```typescript
-   * await AgentOrchestrator.uninstallAgent('my-custom-agent');
-   * console.log('Agent uninstalled successfully');
-   * ```
-   */
-  static async uninstallAgent(agentName, force = false) {
-    const agentRegistry = (0, import_registry.getAgentRegistry)();
-    try {
-      await agentRegistry.uninstallAgent(agentName, force);
-      import_core.logger.info(`Successfully uninstalled agent: ${agentName}`);
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : String(error);
-      import_core.logger.error(`Failed to uninstall agent ${agentName}: ${errorMessage}`);
-      throw import_core.AgentError.apiValidationError(
-        `Uninstallation failed for agent '${agentName}'`,
-        error
-      );
-    }
-  }
-  /**
-   * Creates a new agent instance for the specified agent name.
-   * This method resolves the agent (installing if needed), loads its configuration,
-   * and returns a new DextoAgent instance ready to be started.
-   *
-   * This is a factory method that doesn't affect any existing agent instances.
-   * The caller is responsible for managing the lifecycle of the returned agent.
-   *
-   * @param agentName The name of the agent to create
-   * @returns Promise resolving to a new DextoAgent instance (not started)
-   *
-   * @throws {AgentError} When agent is not found or creation fails
-   *
-   * @example
-   * ```typescript
-   * const newAgent = await AgentOrchestrator.createAgent('productivity');
-   * await newAgent.start();
-   * ```
-   */
-  static async createAgent(agentName) {
-    const agentRegistry = (0, import_registry.getAgentRegistry)();
-    try {
-      const agentPath = await agentRegistry.resolveAgent(agentName, true, true);
-      const config = await (0, import_config.loadAgentConfig)(agentPath);
-      const enrichedConfig = (0, import_config.enrichAgentConfig)(config, agentPath);
-      import_core.logger.info(`Creating agent: ${agentName}`);
-      const newAgent = new import_core.DextoAgent(enrichedConfig, agentPath);
-      import_core.logger.info(`Successfully created agent: ${agentName}`);
-      return newAgent;
-    } catch (error) {
-      if (error instanceof import_zod.ZodError) {
-        const issues = (0, import_core2.zodToIssues)(error, "error");
-        const formatted = issues.map((issue) => {
-          const path = Array.isArray(issue.path) ? issue.path.join(".") : String(issue.path);
-          return `${path}: ${issue.message}`;
-        });
-        const message = `Configuration validation failed for agent '${agentName}':
-${formatted.join("\n")}`;
-        import_core.logger.error(message);
-        throw new import_core.DextoValidationError(issues);
-      }
-      import_core.logger.error(
-        `Failed to create agent '${agentName}': ${error instanceof Error ? error.message : String(error)}`
-      );
-      throw import_core.AgentError.apiValidationError(`Failed to create agent '${agentName}'`, error);
-    }
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AgentOrchestrator
-});