@dexto/core 1.1.10 → 1.2.0

package/dist/agent/agentCard.d.ts

@@ -1,11 +1,9 @@
-import { AgentCard } from './schemas.js';
-import 'zod';
-
+import type { AgentCard } from './schemas.js';
 /**
  * Minimal runtime context needed to establish defaults
  * if not provided in AgentCardOverride or by AgentCardSchema.
  */
-interface MinimalAgentCardContext {
+export interface MinimalAgentCardContext {
     defaultName: string;
     defaultVersion: string;
     defaultBaseUrl: string;
@@ -15,6 +13,5 @@ interface MinimalAgentCardContext {
  * Creates the final AgentCard by merging context-defined values with user-provided overrides,
  * then uses AgentCardSchema.parse() to apply schema-defined static defaults and perform validation.
  */
-declare function createAgentCard(context: MinimalAgentCardContext, overrides?: Partial<AgentCard>): AgentCard;
-
-export { type MinimalAgentCardContext, createAgentCard };
+export declare function createAgentCard(context: MinimalAgentCardContext, overrides?: Partial<AgentCard>): AgentCard;
+//# sourceMappingURL=agentCard.d.ts.map

package/dist/agent/agentCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCard.d.ts","sourceRoot":"","sources":["../../src/agent/agentCard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,OAAO,EAAE,uBAAuB,EAChC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAC/B,SAAS,CAwBX"}

package/dist/agent/agentCard.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { AgentCardSchema } from "./schemas.js";
 function createAgentCard(context, overrides) {
   const { defaultName, defaultVersion, defaultBaseUrl, webSubscriber } = context;

package/dist/agent/error-codes.cjs

@@ -26,6 +26,9 @@ var AgentErrorCode = /* @__PURE__ */ ((AgentErrorCode2) => {
   AgentErrorCode2["ALREADY_STARTED"] = "agent_already_started";
   AgentErrorCode2["STOPPED"] = "agent_stopped";
   AgentErrorCode2["INITIALIZATION_FAILED"] = "agent_initialization_failed";
+  AgentErrorCode2["SWITCH_IN_PROGRESS"] = "agent_switch_in_progress";
+  AgentErrorCode2["NO_CONFIG_PATH"] = "agent_no_config_path";
+  AgentErrorCode2["INVALID_CONFIG"] = "agent_invalid_config";
   AgentErrorCode2["API_VALIDATION_ERROR"] = "agent_api_validation_error";
   return AgentErrorCode2;
 })(AgentErrorCode || {});

package/dist/agent/error-codes.d.ts

@@ -3,12 +3,14 @@
  * Includes agent configuration and lifecycle errors only
  * Domain-specific errors (LLM, Session, MCP, etc.) belong in their respective modules
  */
-declare enum AgentErrorCode {
+export declare enum AgentErrorCode {
     NOT_STARTED = "agent_not_started",
     ALREADY_STARTED = "agent_already_started",
     STOPPED = "agent_stopped",
     INITIALIZATION_FAILED = "agent_initialization_failed",
+    SWITCH_IN_PROGRESS = "agent_switch_in_progress",
+    NO_CONFIG_PATH = "agent_no_config_path",
+    INVALID_CONFIG = "agent_invalid_config",
     API_VALIDATION_ERROR = "agent_api_validation_error"
 }
-
-export { AgentErrorCode };
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/agent/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/agent/error-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,cAAc;IAEtB,WAAW,sBAAsB;IACjC,eAAe,0BAA0B;IACzC,OAAO,kBAAkB;IACzB,qBAAqB,gCAAgC;IACrD,kBAAkB,6BAA6B;IAG/C,cAAc,yBAAyB;IACvC,cAAc,yBAAyB;IAGvC,oBAAoB,+BAA+B;CACtD"}

package/dist/agent/error-codes.js

@@ -1,8 +1,12 @@
+import "../chunk-C6A6W6XS.js";
 var AgentErrorCode = /* @__PURE__ */ ((AgentErrorCode2) => {
   AgentErrorCode2["NOT_STARTED"] = "agent_not_started";
   AgentErrorCode2["ALREADY_STARTED"] = "agent_already_started";
   AgentErrorCode2["STOPPED"] = "agent_stopped";
   AgentErrorCode2["INITIALIZATION_FAILED"] = "agent_initialization_failed";
+  AgentErrorCode2["SWITCH_IN_PROGRESS"] = "agent_switch_in_progress";
+  AgentErrorCode2["NO_CONFIG_PATH"] = "agent_no_config_path";
+  AgentErrorCode2["INVALID_CONFIG"] = "agent_invalid_config";
   AgentErrorCode2["API_VALIDATION_ERROR"] = "agent_api_validation_error";
   return AgentErrorCode2;
 })(AgentErrorCode || {});

package/dist/agent/errors.cjs

@@ -64,6 +64,19 @@ class AgentError {
       "Create a new agent instance or restart this one"
     );
   }
+  /**
+   * Agent switch in progress
+   */
+  static switchInProgress() {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.AgentErrorCode.SWITCH_IN_PROGRESS,
+      import_types.ErrorScope.AGENT,
+      import_types.ErrorType.CONFLICT,
+      "Agent switch already in progress",
+      void 0,
+      "Wait for the current switch operation to complete before starting a new one"
+    );
+  }
   /**
    * Agent initialization failed
    */
@@ -77,6 +90,19 @@ class AgentError {
       "Check logs for initialization errors"
     );
   }
+  /**
+   * No config path available
+   */
+  static noConfigPath() {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.AgentErrorCode.NO_CONFIG_PATH,
+      import_types.ErrorScope.AGENT,
+      import_types.ErrorType.SYSTEM,
+      "No configuration file path is available",
+      void 0,
+      "Agent was created without a config file path, cannot perform file operations"
+    );
+  }
   /**
    * API validation error
    */

package/dist/agent/errors.d.ts

@@ -1,24 +1,10 @@
 import { DextoRuntimeError } from '../errors/DextoRuntimeError.js';
-import '../errors/DextoBaseError.js';
-import '../errors/types.js';
-import './error-codes.js';
-import '../config/error-codes.js';
-import '../context/error-codes.js';
-import '../llm/error-codes.js';
-import '../mcp/error-codes.js';
-import '../session/error-codes.js';
-import '../storage/error-codes.js';
-import '../systemPrompt/error-codes.js';
-import '../tools/error-codes.js';
-import '../preferences/error-codes.js';
-import './registry/error-codes.js';
-
 /**
  * Agent-specific error factory
  * Creates properly typed errors for Agent operations
  * Note: Domain-specific errors (LLM, Session, MCP) have been moved to their respective modules
  */
-declare class AgentError {
+export declare class AgentError {
     /**
      * Agent not started
      */
@@ -31,14 +17,21 @@ declare class AgentError {
      * Agent stopped
      */
     static stopped(): DextoRuntimeError<undefined>;
+    /**
+     * Agent switch in progress
+     */
+    static switchInProgress(): DextoRuntimeError<undefined>;
     /**
      * Agent initialization failed
      */
     static initializationFailed(reason: string, details?: unknown): DextoRuntimeError<unknown>;
+    /**
+     * No config path available
+     */
+    static noConfigPath(): DextoRuntimeError<undefined>;
     /**
      * API validation error
      */
     static apiValidationError(message: string, details?: unknown): DextoRuntimeError<unknown>;
 }
-
-export { AgentError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/agent/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;;GAIG;AACH,qBAAa,UAAU;IACnB;;OAEG;IACH,MAAM,CAAC,UAAU;IAWjB;;OAEG;IACH,MAAM,CAAC,cAAc;IAWrB;;OAEG;IACH,MAAM,CAAC,OAAO;IAWd;;OAEG;IACH,MAAM,CAAC,gBAAgB;IAWvB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAW7D;;OAEG;IACH,MAAM,CAAC,YAAY;IAWnB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAU/D"}

package/dist/agent/errors.js

@@ -1,3 +1,4 @@
+import "../chunk-C6A6W6XS.js";
 import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
 import { ErrorScope, ErrorType } from "../errors/types.js";
 import { AgentErrorCode } from "./error-codes.js";
@@ -41,6 +42,19 @@ class AgentError {
       "Create a new agent instance or restart this one"
     );
   }
+  /**
+   * Agent switch in progress
+   */
+  static switchInProgress() {
+    return new DextoRuntimeError(
+      AgentErrorCode.SWITCH_IN_PROGRESS,
+      ErrorScope.AGENT,
+      ErrorType.CONFLICT,
+      "Agent switch already in progress",
+      void 0,
+      "Wait for the current switch operation to complete before starting a new one"
+    );
+  }
   /**
    * Agent initialization failed
    */
@@ -54,6 +68,19 @@ class AgentError {
       "Check logs for initialization errors"
     );
   }
+  /**
+   * No config path available
+   */
+  static noConfigPath() {
+    return new DextoRuntimeError(
+      AgentErrorCode.NO_CONFIG_PATH,
+      ErrorScope.AGENT,
+      ErrorType.SYSTEM,
+      "No configuration file path is available",
+      void 0,
+      "Agent was created without a config file path, cannot perform file operations"
+    );
+  }
   /**
    * API validation error
    */

package/dist/agent/index.cjs

@@ -23,6 +23,7 @@ __export(agent_exports, {
   AgentConfigSchema: () => import_schemas.AgentConfigSchema,
   DextoAgent: () => import_DextoAgent.DextoAgent,
   createAgentCard: () => import_agentCard.createAgentCard,
+  deriveDisplayName: () => import_types.deriveDisplayName,
   getAgentRegistry: () => import_registry.getAgentRegistry
 });
 module.exports = __toCommonJS(agent_exports);
@@ -30,6 +31,7 @@ var import_DextoAgent = require("./DextoAgent.js");
 var import_schemas = require("./schemas.js");
 var import_agentCard = require("./agentCard.js");
 var import_registry = require("./registry/registry.js");
+var import_types = require("./registry/types.js");
 __reExport(agent_exports, require("./errors.js"), module.exports);
 __reExport(agent_exports, require("./error-codes.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -38,6 +40,7 @@ __reExport(agent_exports, require("./error-codes.js"), module.exports);
   AgentConfigSchema,
   DextoAgent,
   createAgentCard,
+  deriveDisplayName,
   getAgentRegistry,
   ...require("./errors.js"),
   ...require("./error-codes.js")

package/dist/agent/index.d.ts

@@ -1,60 +1,9 @@
 export { DextoAgent } from './DextoAgent.js';
-export { AgentCard, AgentCardSchema, AgentConfig, AgentConfigSchema, ValidatedAgentConfig } from './schemas.js';
+export { AgentConfigSchema, AgentCardSchema, type AgentCard } from './schemas.js';
+export { type ValidatedAgentConfig, type AgentConfig } from './schemas.js';
 export { createAgentCard } from './agentCard.js';
 export { getAgentRegistry } from './registry/registry.js';
-export { AgentError } from './errors.js';
-export { AgentErrorCode } from './error-codes.js';
-import '../llm/types.js';
-import '../events/index.js';
-import 'events';
-import '../llm/registry.js';
-import '../llm/schemas.js';
-import 'zod';
-import '../context/types.js';
-import '../tools/types.js';
-import 'json-schema';
-import '../mcp/manager.js';
-import '../mcp/schemas.js';
-import '../mcp/types.js';
-import '@modelcontextprotocol/sdk/client/index.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '../systemPrompt/manager.js';
-import '../systemPrompt/schemas.js';
-import '../systemPrompt/types.js';
-import '../search/types.js';
-import '../session/chat-session.js';
-import '../context/manager.js';
-import '../llm/formatters/types.js';
-import '../llm/tokenizer/types.js';
-import '../context/compression/types.js';
-import '../session/history/types.js';
-import '../llm/services/types.js';
-import 'ai';
-import '../tools/tool-manager.js';
-import '../tools/internal-tools/registry.js';
-import '../search/search-service.js';
-import '../storage/backend/database-backend.js';
-import '../tools/schemas.js';
-import '../tools/confirmation/types.js';
-import '../tools/confirmation/allowed-tools-provider/types.js';
-import './state-manager.js';
-import '../storage/backend/types.js';
-import '../storage/backend/cache-backend.js';
-import '../storage/schemas.js';
-import '../session/session-manager.js';
-import '../utils/service-initializer.js';
-import '../storage/storage-manager.js';
-import './registry/types.js';
-import '../errors/DextoRuntimeError.js';
-import '../errors/DextoBaseError.js';
-import '../errors/types.js';
-import '../config/error-codes.js';
-import '../context/error-codes.js';
-import '../llm/error-codes.js';
-import '../mcp/error-codes.js';
-import '../session/error-codes.js';
-import '../storage/error-codes.js';
-import '../systemPrompt/error-codes.js';
-import '../tools/error-codes.js';
-import '../preferences/error-codes.js';
-import './registry/error-codes.js';
+export { deriveDisplayName } from './registry/types.js';
+export * from './errors.js';
+export * from './error-codes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/agent/index.js

@@ -1,7 +1,9 @@
+import "../chunk-C6A6W6XS.js";
 import { DextoAgent } from "./DextoAgent.js";
 import { AgentConfigSchema, AgentCardSchema } from "./schemas.js";
 import { createAgentCard } from "./agentCard.js";
 import { getAgentRegistry } from "./registry/registry.js";
+import { deriveDisplayName } from "./registry/types.js";
 export * from "./errors.js";
 export * from "./error-codes.js";
 export {
@@ -9,5 +11,6 @@ export {
   AgentConfigSchema,
   DextoAgent,
   createAgentCard,
+  deriveDisplayName,
   getAgentRegistry
 };

package/dist/agent/registry/error-codes.cjs

@@ -24,10 +24,12 @@ module.exports = __toCommonJS(error_codes_exports);
 var RegistryErrorCode = /* @__PURE__ */ ((RegistryErrorCode2) => {
   RegistryErrorCode2["AGENT_NOT_FOUND"] = "registry_agent_not_found";
   RegistryErrorCode2["AGENT_INVALID_ENTRY"] = "registry_agent_invalid_entry";
+  RegistryErrorCode2["AGENT_ALREADY_EXISTS"] = "registry_agent_already_exists";
   RegistryErrorCode2["INSTALLATION_FAILED"] = "registry_installation_failed";
   RegistryErrorCode2["INSTALLATION_VALIDATION_FAILED"] = "registry_installation_validation_failed";
   RegistryErrorCode2["REGISTRY_NOT_FOUND"] = "registry_file_not_found";
   RegistryErrorCode2["REGISTRY_PARSE_ERROR"] = "registry_parse_error";
+  RegistryErrorCode2["REGISTRY_WRITE_ERROR"] = "registry_write_error";
   RegistryErrorCode2["CONFIG_NOT_FOUND"] = "registry_config_not_found";
   RegistryErrorCode2["MAIN_CONFIG_MISSING"] = "registry_main_config_missing";
   RegistryErrorCode2["AGENT_NOT_INSTALLED"] = "registry_agent_not_installed";

package/dist/agent/registry/error-codes.d.ts

@@ -2,13 +2,15 @@
  * Registry-specific error codes
  * Includes agent resolution, installation, and registry management errors
  */
-declare enum RegistryErrorCode {
+export declare enum RegistryErrorCode {
     AGENT_NOT_FOUND = "registry_agent_not_found",
     AGENT_INVALID_ENTRY = "registry_agent_invalid_entry",
+    AGENT_ALREADY_EXISTS = "registry_agent_already_exists",
     INSTALLATION_FAILED = "registry_installation_failed",
     INSTALLATION_VALIDATION_FAILED = "registry_installation_validation_failed",
     REGISTRY_NOT_FOUND = "registry_file_not_found",
     REGISTRY_PARSE_ERROR = "registry_parse_error",
+    REGISTRY_WRITE_ERROR = "registry_write_error",
     CONFIG_NOT_FOUND = "registry_config_not_found",
     MAIN_CONFIG_MISSING = "registry_main_config_missing",
     AGENT_NOT_INSTALLED = "registry_agent_not_installed",
@@ -16,5 +18,4 @@ declare enum RegistryErrorCode {
     UNINSTALLATION_FAILED = "registry_uninstallation_failed",
     AGENT_NOT_INSTALLED_AUTO_INSTALL_DISABLED = "registry_agent_not_installed_auto_install_disabled"
 }
-
-export { RegistryErrorCode };
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/agent/registry/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/agent/registry/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,iBAAiB;IAEzB,eAAe,6BAA6B;IAC5C,mBAAmB,iCAAiC;IACpD,oBAAoB,kCAAkC;IAGtD,mBAAmB,iCAAiC;IACpD,8BAA8B,4CAA4C;IAG1E,kBAAkB,4BAA4B;IAC9C,oBAAoB,yBAAyB;IAC7C,oBAAoB,yBAAyB;IAG7C,gBAAgB,8BAA8B;IAC9C,mBAAmB,iCAAiC;IAGpD,mBAAmB,iCAAiC;IACpD,eAAe,6BAA6B;IAC5C,qBAAqB,mCAAmC;IAGxD,yCAAyC,uDAAuD;CACnG"}

package/dist/agent/registry/error-codes.js

@@ -1,10 +1,13 @@
+import "../../chunk-C6A6W6XS.js";
 var RegistryErrorCode = /* @__PURE__ */ ((RegistryErrorCode2) => {
   RegistryErrorCode2["AGENT_NOT_FOUND"] = "registry_agent_not_found";
   RegistryErrorCode2["AGENT_INVALID_ENTRY"] = "registry_agent_invalid_entry";
+  RegistryErrorCode2["AGENT_ALREADY_EXISTS"] = "registry_agent_already_exists";
   RegistryErrorCode2["INSTALLATION_FAILED"] = "registry_installation_failed";
   RegistryErrorCode2["INSTALLATION_VALIDATION_FAILED"] = "registry_installation_validation_failed";
   RegistryErrorCode2["REGISTRY_NOT_FOUND"] = "registry_file_not_found";
   RegistryErrorCode2["REGISTRY_PARSE_ERROR"] = "registry_parse_error";
+  RegistryErrorCode2["REGISTRY_WRITE_ERROR"] = "registry_write_error";
   RegistryErrorCode2["CONFIG_NOT_FOUND"] = "registry_config_not_found";
   RegistryErrorCode2["MAIN_CONFIG_MISSING"] = "registry_main_config_missing";
   RegistryErrorCode2["AGENT_NOT_INSTALLED"] = "registry_agent_not_installed";

package/dist/agent/registry/errors.cjs

@@ -26,44 +26,64 @@ var import_types = require("../../errors/types.cjs");
 var import_error_codes = require("./error-codes.js");
 class RegistryError {
   // Agent lookup errors
-  static agentNotFound(agentName, availableAgents) {
+  static agentNotFound(agentId, availableAgents) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.AGENT_NOT_FOUND,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.USER,
-      `Agent '${agentName}' not found in registry`,
-      { agentName, availableAgents },
+      `Agent '${agentId}' not found in registry`,
+      { agentId, availableAgents },
       `Available agents: ${availableAgents.join(", ")}. Use a file path for custom agents.`
     );
   }
-  static agentInvalidEntry(agentName, reason) {
+  static agentInvalidEntry(agentId, reason) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.AGENT_INVALID_ENTRY,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.SYSTEM,
-      `Registry entry for '${agentName}' is invalid: ${reason}`,
-      { agentName, reason },
+      `Registry entry for '${agentId}' is invalid: ${reason}`,
+      { agentId, reason },
       "This indicates a problem with the agent registry - please report this issue"
     );
   }
+  static agentAlreadyExists(agentId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.RegistryErrorCode.AGENT_ALREADY_EXISTS,
+      import_types.ErrorScope.AGENT_REGISTRY,
+      import_types.ErrorType.USER,
+      `Agent '${agentId}' already exists in user registry`,
+      { agentId },
+      "Choose a different name or uninstall the existing agent first"
+    );
+  }
+  static customAgentNameConflict(agentId) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.RegistryErrorCode.AGENT_ALREADY_EXISTS,
+      import_types.ErrorScope.AGENT_REGISTRY,
+      import_types.ErrorType.USER,
+      `Cannot create custom agent '${agentId}': name conflicts with builtin agent`,
+      { agentId, conflictType: "builtin" },
+      "Choose a different name for your custom agent"
+    );
+  }
   // Installation errors
-  static installationFailed(agentName, cause) {
+  static installationFailed(agentId, cause) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.INSTALLATION_FAILED,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.SYSTEM,
-      `Failed to install agent '${agentName}': ${cause}`,
-      { agentName, cause },
+      `Failed to install agent '${agentId}': ${cause}`,
+      { agentId, cause },
       "Check network connection and available disk space"
     );
   }
-  static installationValidationFailed(agentName, missingPath) {
+  static installationValidationFailed(agentId, missingPath) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.INSTALLATION_VALIDATION_FAILED,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.SYSTEM,
-      `Installation validation failed for '${agentName}': missing main config`,
-      { agentName, missingPath },
+      `Installation validation failed for '${agentId}': missing main config`,
+      { agentId, missingPath },
       "This indicates a problem with the agent bundle - please report this issue"
     );
   }
@@ -78,44 +98,44 @@ class RegistryError {
       "This indicates a problem with the agent installation"
     );
   }
-  static mainConfigMissing(agentName, expectedPath) {
+  static mainConfigMissing(agentId, expectedPath) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.MAIN_CONFIG_MISSING,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.SYSTEM,
-      `Main config file not found for agent '${agentName}': ${expectedPath}`,
-      { agentName, expectedPath },
+      `Main config file not found for agent '${agentId}': ${expectedPath}`,
+      { agentId, expectedPath },
       "This indicates a problem with the agent bundle structure"
     );
   }
   // Uninstallation errors
-  static agentNotInstalled(agentName) {
+  static agentNotInstalled(agentId) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.AGENT_NOT_INSTALLED,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.USER,
-      `Agent '${agentName}' is not installed`,
-      { agentName },
+      `Agent '${agentId}' is not installed`,
+      { agentId },
       'Use "dexto list-agents --installed" to see installed agents'
     );
   }
-  static agentProtected(agentName) {
+  static agentProtected(agentId) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.AGENT_PROTECTED,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.USER,
-      `Agent '${agentName}' is protected and cannot be uninstalled. Use --force to override (not recommended for critical agents)`,
-      { agentName },
+      `Agent '${agentId}' is protected and cannot be uninstalled. Use --force to override (not recommended for critical agents)`,
+      { agentId },
       "Use --force to override (not recommended for critical agents)"
     );
   }
-  static uninstallationFailed(agentName, cause) {
+  static uninstallationFailed(agentId, cause) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.UNINSTALLATION_FAILED,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.SYSTEM,
-      `Failed to uninstall agent '${agentName}': ${cause}`,
-      { agentName, cause },
+      `Failed to uninstall agent '${agentId}': ${cause}`,
+      { agentId, cause },
       "Check file permissions and ensure no processes are using the agent"
     );
   }
@@ -140,15 +160,25 @@ class RegistryError {
       "This indicates a corrupted registry file - please reinstall Dexto"
     );
   }
+  static registryWriteError(registryPath, cause) {
+    return new import_errors.DextoRuntimeError(
+      import_error_codes.RegistryErrorCode.REGISTRY_WRITE_ERROR,
+      import_types.ErrorScope.AGENT_REGISTRY,
+      import_types.ErrorType.SYSTEM,
+      `Failed to save agent registry to ${registryPath}: ${cause}`,
+      { registryPath, cause },
+      "Check file permissions and available disk space"
+    );
+  }
   // Auto-install control errors
-  static agentNotInstalledAutoInstallDisabled(agentName, availableAgents) {
+  static agentNotInstalledAutoInstallDisabled(agentId, availableAgents) {
     return new import_errors.DextoRuntimeError(
       import_error_codes.RegistryErrorCode.AGENT_NOT_INSTALLED_AUTO_INSTALL_DISABLED,
       import_types.ErrorScope.AGENT_REGISTRY,
       import_types.ErrorType.USER,
-      `Agent '${agentName}' is not installed locally and auto-install is disabled`,
-      { agentName, availableAgents },
-      `Use 'dexto install ${agentName}' to install it manually, or use a file path for custom agents`
+      `Agent '${agentId}' is not installed locally and auto-install is disabled`,
+      { agentId, availableAgents },
+      `Use 'dexto install ${agentId}' to install it manually, or use a file path for custom agents`
     );
   }
 }

package/dist/agent/registry/errors.d.ts

@@ -1,54 +1,47 @@
-import { DextoRuntimeError } from '../../errors/DextoRuntimeError.js';
-import '../../errors/DextoBaseError.js';
-import '../../errors/types.js';
-import '../error-codes.js';
-import '../../config/error-codes.js';
-import '../../context/error-codes.js';
-import '../../llm/error-codes.js';
-import '../../mcp/error-codes.js';
-import '../../session/error-codes.js';
-import '../../storage/error-codes.js';
-import '../../systemPrompt/error-codes.js';
-import '../../tools/error-codes.js';
-import '../../preferences/error-codes.js';
-import './error-codes.js';
-
+import { DextoRuntimeError } from '../../errors/index.js';
 /**
  * Registry runtime error factory methods
  * Creates properly typed errors for registry operations
  */
-declare class RegistryError {
-    static agentNotFound(agentName: string, availableAgents: string[]): DextoRuntimeError<{
-        agentName: string;
+export declare class RegistryError {
+    static agentNotFound(agentId: string, availableAgents: string[]): DextoRuntimeError<{
+        agentId: string;
         availableAgents: string[];
     }>;
-    static agentInvalidEntry(agentName: string, reason: string): DextoRuntimeError<{
-        agentName: string;
+    static agentInvalidEntry(agentId: string, reason: string): DextoRuntimeError<{
+        agentId: string;
         reason: string;
     }>;
-    static installationFailed(agentName: string, cause: string): DextoRuntimeError<{
-        agentName: string;
+    static agentAlreadyExists(agentId: string): DextoRuntimeError<{
+        agentId: string;
+    }>;
+    static customAgentNameConflict(agentId: string): DextoRuntimeError<{
+        agentId: string;
+        conflictType: string;
+    }>;
+    static installationFailed(agentId: string, cause: string): DextoRuntimeError<{
+        agentId: string;
         cause: string;
     }>;
-    static installationValidationFailed(agentName: string, missingPath: string): DextoRuntimeError<{
-        agentName: string;
+    static installationValidationFailed(agentId: string, missingPath: string): DextoRuntimeError<{
+        agentId: string;
         missingPath: string;
     }>;
     static configNotFound(configPath: string): DextoRuntimeError<{
         configPath: string;
     }>;
-    static mainConfigMissing(agentName: string, expectedPath: string): DextoRuntimeError<{
-        agentName: string;
+    static mainConfigMissing(agentId: string, expectedPath: string): DextoRuntimeError<{
+        agentId: string;
         expectedPath: string;
     }>;
-    static agentNotInstalled(agentName: string): DextoRuntimeError<{
-        agentName: string;
+    static agentNotInstalled(agentId: string): DextoRuntimeError<{
+        agentId: string;
     }>;
-    static agentProtected(agentName: string): DextoRuntimeError<{
-        agentName: string;
+    static agentProtected(agentId: string): DextoRuntimeError<{
+        agentId: string;
     }>;
-    static uninstallationFailed(agentName: string, cause: string): DextoRuntimeError<{
-        agentName: string;
+    static uninstallationFailed(agentId: string, cause: string): DextoRuntimeError<{
+        agentId: string;
         cause: string;
     }>;
     static registryNotFound(registryPath: string, cause: string): DextoRuntimeError<{
@@ -58,10 +51,13 @@ declare class RegistryError {
         registryPath: string;
         cause: string;
     }>;
-    static agentNotInstalledAutoInstallDisabled(agentName: string, availableAgents: string[]): DextoRuntimeError<{
-        agentName: string;
+    static registryWriteError(registryPath: string, cause: string): DextoRuntimeError<{
+        registryPath: string;
+        cause: string;
+    }>;
+    static agentNotInstalledAutoInstallDisabled(agentId: string, availableAgents: string[]): DextoRuntimeError<{
+        agentId: string;
         availableAgents: string[];
     }>;
 }
-
-export { RegistryError };
+//# sourceMappingURL=errors.d.ts.map