@dexto/agent-management 1.5.8 → 1.6.1

package/dist/AgentFactory.cjs

@@ -22,12 +22,11 @@ __export(AgentFactory_exports, {
 });
 module.exports = __toCommonJS(AgentFactory_exports);
 var import_fs = require("fs");
-var import_core = require("@dexto/core");
 var import_path = require("./utils/path.js");
 var import_types = require("./registry/types.js");
 var import_registry = require("./registry/registry.js");
-var import_config = require("./config/index.js");
 var import_installation = require("./installation.js");
+var import_agent_creation = require("./agent-creation.js");
 const AgentFactory = {
   /**
    * List all agents (installed and available from bundled registry)
@@ -125,13 +124,10 @@ const AgentFactory = {
         }
       };
     }
-    const enrichedConfig = (0, import_config.enrichAgentConfig)(
-      configToEnrich,
-      void 0,
-      // No config path for inline configs
-      options?.isInteractiveCli ?? false
-    );
-    return new import_core.DextoAgent(enrichedConfig);
+    return await (0, import_agent_creation.createDextoAgentFromConfig)({
+      config: configToEnrich,
+      enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false }
+    });
   }
 };
 async function listInstalledAgents() {

package/dist/AgentFactory.d.ts

@@ -23,7 +23,8 @@
  * @see AgentManager for registry-based agent management
  * @see https://docs.dexto.ai/api/sdk/agent-factory for full documentation
  */
-import { DextoAgent, type AgentConfig } from '@dexto/core';
+import type { AgentConfig } from '@dexto/agent-config';
+import type { DextoAgent } from '@dexto/core';
 import { type InstallOptions } from './installation.js';
 import type { AgentMetadata } from './AgentManager.js';
 /**
@@ -64,10 +65,10 @@ export declare const AgentFactory: {
         }[];
         available: {
             id: string;
-            name: any;
-            description: any;
-            author: any;
-            tags: any;
+            name: string;
+            description: string;
+            author: string;
+            tags: string[];
             type: "builtin";
         }[];
     }>;

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,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"}
+{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;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;CAmB5F,CAAC"}

package/dist/AgentFactory.js

@@ -1,14 +1,13 @@
 import { promises as fs } from "fs";
-import { DextoAgent } from "@dexto/core";
 import { getDextoGlobalPath } from "./utils/path.js";
 import { deriveDisplayName } from "./registry/types.js";
 import { loadBundledRegistryAgents } from "./registry/registry.js";
-import { enrichAgentConfig } from "./config/index.js";
 import {
   installBundledAgent,
   installCustomAgent,
   uninstallAgent
 } from "./installation.js";
+import { createDextoAgentFromConfig } from "./agent-creation.js";
 const AgentFactory = {
   /**
    * List all agents (installed and available from bundled registry)
@@ -106,13 +105,10 @@ const AgentFactory = {
         }
       };
     }
-    const enrichedConfig = enrichAgentConfig(
-      configToEnrich,
-      void 0,
-      // No config path for inline configs
-      options?.isInteractiveCli ?? false
-    );
-    return new DextoAgent(enrichedConfig);
+    return await createDextoAgentFromConfig({
+      config: configToEnrich,
+      enrichOptions: { isInteractiveCli: options?.isInteractiveCli ?? false }
+    });
   }
 };
 async function listInstalledAgents() {

package/dist/AgentManager.cjs

@@ -37,6 +37,7 @@ var import_core = require("@dexto/core");
 var import_config = require("./config/index.js");
 var import_errors = require("./registry/errors.js");
 var import_zod = require("zod");
+var import_agent_creation = require("./agent-creation.js");
 const RegistrySchema = import_zod.z.object({
   agents: import_zod.z.array(
     import_zod.z.object({
@@ -177,9 +178,8 @@ class AgentManager {
     const configPath = import_path.default.resolve(this.basePath, entry.configPath);
     try {
       const config = await (0, import_config.loadAgentConfig)(configPath);
-      const enrichedConfig = (0, import_config.enrichAgentConfig)(config, configPath);
       import_core.logger.debug(`Loading agent: ${id} from ${configPath}`);
-      return new import_core.DextoAgent(enrichedConfig, configPath);
+      return await (0, import_agent_creation.createDextoAgentFromConfig)({ config, configPath });
     } catch (error) {
       if (error instanceof import_zod.ZodError) {
         const issues = (0, import_core.zodToIssues)(error, "error");

package/dist/AgentManager.d.ts

@@ -15,7 +15,7 @@
  * @see AgentFactory.createAgent() for inline config creation
  * @see https://docs.dexto.ai/api/sdk/agent-manager for full documentation
  */
-import { DextoAgent } from '@dexto/core';
+import type { DextoAgent } from '@dexto/core';
 import { z } from 'zod';
 /**
  * Agent metadata - describes an agent in the registry

package/dist/AgentManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../src/AgentManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAU,UAAU,EAAqC,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeP,CAAC;AAEd,KAAK,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;;;;;;;OAaG;gBACS,YAAY,EAAE,MAAM;IAKhC;;;;;;;;;;;;;;;;OAgBG;IACG,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IA8BvC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,IAAI,aAAa,EAAE;IAiB7B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuChD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAUhC"}
+{"version":3,"file":"AgentManager.d.ts","sourceRoot":"","sources":["../src/AgentManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeP,CAAC;AAEd,KAAK,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;;;;;;;OAaG;gBACS,YAAY,EAAE,MAAM;IAKhC;;;;;;;;;;;;;;;;OAgBG;IACG,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC;IA8BvC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,IAAI,aAAa,EAAE;IAiB7B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAqChD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAUhC"}

package/dist/AgentManager.js

@@ -1,9 +1,10 @@
 import { promises as fs } from "fs";
 import path from "path";
-import { logger, DextoAgent, DextoValidationError, zodToIssues } from "@dexto/core";
-import { loadAgentConfig, enrichAgentConfig } from "./config/index.js";
+import { logger, DextoValidationError, zodToIssues } from "@dexto/core";
+import { loadAgentConfig } from "./config/index.js";
 import { RegistryError } from "./registry/errors.js";
 import { z, ZodError } from "zod";
+import { createDextoAgentFromConfig } from "./agent-creation.js";
 const RegistrySchema = z.object({
   agents: z.array(
     z.object({
@@ -144,9 +145,8 @@ class AgentManager {
     const configPath = path.resolve(this.basePath, entry.configPath);
     try {
       const config = await loadAgentConfig(configPath);
-      const enrichedConfig = enrichAgentConfig(config, configPath);
       logger.debug(`Loading agent: ${id} from ${configPath}`);
-      return new DextoAgent(enrichedConfig, configPath);
+      return await createDextoAgentFromConfig({ config, configPath });
     } catch (error) {
       if (error instanceof ZodError) {
         const issues = zodToIssues(error, "error");

package/dist/agent-creation.cjs

@@ -0,0 +1,95 @@
+"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 agent_creation_exports = {};
+__export(agent_creation_exports, {
+  createDextoAgentFromConfig: () => createDextoAgentFromConfig
+});
+module.exports = __toCommonJS(agent_creation_exports);
+var import_agent_config = require("@dexto/agent-config");
+var import_core = require("@dexto/core");
+var import_config = require("./config/index.js");
+var import_tools_builtins = require("@dexto/tools-builtins");
+async function loadImageForConfig(options) {
+  const { config, imageNameOverride } = options;
+  const imageName = imageNameOverride ?? config.image ?? process.env.DEXTO_IMAGE ?? "@dexto/image-local";
+  try {
+    const image = await (0, import_agent_config.loadImage)(imageName);
+    import_core.logger.debug(`Loaded image: ${imageName}`);
+    return { imageName, image };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`Failed to load image '${imageName}': ${message}`);
+  }
+}
+function applySubAgentToolConstraints(config) {
+  const tools = config.tools;
+  if (!Array.isArray(tools)) {
+    return config;
+  }
+  const disabledBuiltinTools = /* @__PURE__ */ new Set(["ask_user", "invoke_skill"]);
+  const constrainedTools = tools.filter((entry) => entry.type !== "agent-spawner").map((entry) => {
+    if (entry.type !== "builtin-tools" || entry.enabled === false) {
+      return entry;
+    }
+    const maybeEnabledTools = entry.enabledTools;
+    const enabledTools = Array.isArray(maybeEnabledTools) ? maybeEnabledTools : [...import_tools_builtins.BUILTIN_TOOL_NAMES];
+    const filteredEnabledTools = enabledTools.filter((t) => !disabledBuiltinTools.has(t));
+    return { ...entry, enabledTools: filteredEnabledTools };
+  }).filter((entry) => {
+    if (entry.type !== "builtin-tools") {
+      return true;
+    }
+    const maybeEnabledTools = entry.enabledTools;
+    return !Array.isArray(maybeEnabledTools) || maybeEnabledTools.length > 0;
+  });
+  return { ...config, tools: constrainedTools };
+}
+async function createDextoAgentFromConfig(options) {
+  const { configPath, enrichOptions, agentIdOverride, overrides } = options;
+  const cleanedConfig = (0, import_agent_config.cleanNullValues)(options.config);
+  const { image } = await loadImageForConfig({
+    config: cleanedConfig,
+    imageNameOverride: options.imageNameOverride
+  });
+  let configWithImageDefaults = (0, import_agent_config.applyImageDefaults)(cleanedConfig, image.defaults);
+  if (options.agentContext === "subagent") {
+    configWithImageDefaults = applySubAgentToolConstraints(configWithImageDefaults);
+  }
+  const enrichedConfig = (0, import_config.enrichAgentConfig)(
+    configWithImageDefaults,
+    configPath,
+    enrichOptions ?? {}
+  );
+  if (agentIdOverride !== void 0) {
+    enrichedConfig.agentId = agentIdOverride;
+  }
+  const validatedConfig = import_agent_config.AgentConfigSchema.parse(enrichedConfig);
+  const services = await (0, import_agent_config.resolveServicesFromConfig)(validatedConfig, image);
+  return new import_core.DextoAgent(
+    (0, import_agent_config.toDextoAgentOptions)({
+      config: validatedConfig,
+      services,
+      overrides
+    })
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDextoAgentFromConfig
+});

package/dist/agent-creation.d.ts

@@ -0,0 +1,15 @@
+import type { AgentConfig } from '@dexto/agent-config';
+import { DextoAgent, type InitializeServicesOptions } from '@dexto/core';
+import { type EnrichAgentConfigOptions } from './config/index.js';
+type CreateDextoAgentFromConfigOptions = {
+    config: AgentConfig;
+    configPath?: string | undefined;
+    enrichOptions?: EnrichAgentConfigOptions | undefined;
+    agentIdOverride?: string | undefined;
+    imageNameOverride?: string | undefined;
+    agentContext?: 'subagent' | undefined;
+    overrides?: InitializeServicesOptions | undefined;
+};
+export declare function createDextoAgentFromConfig(options: CreateDextoAgentFromConfigOptions): Promise<DextoAgent>;
+export {};
+//# sourceMappingURL=agent-creation.d.ts.map

package/dist/agent-creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AASnE,OAAO,EAAE,UAAU,EAAU,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACrD,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAmCrB"}

package/dist/agent-creation.js

@@ -0,0 +1,78 @@
+import {
+  AgentConfigSchema,
+  applyImageDefaults,
+  cleanNullValues,
+  loadImage,
+  resolveServicesFromConfig,
+  toDextoAgentOptions
+} from "@dexto/agent-config";
+import { DextoAgent, logger } from "@dexto/core";
+import { enrichAgentConfig } from "./config/index.js";
+import { BUILTIN_TOOL_NAMES } from "@dexto/tools-builtins";
+async function loadImageForConfig(options) {
+  const { config, imageNameOverride } = options;
+  const imageName = imageNameOverride ?? config.image ?? process.env.DEXTO_IMAGE ?? "@dexto/image-local";
+  try {
+    const image = await loadImage(imageName);
+    logger.debug(`Loaded image: ${imageName}`);
+    return { imageName, image };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`Failed to load image '${imageName}': ${message}`);
+  }
+}
+function applySubAgentToolConstraints(config) {
+  const tools = config.tools;
+  if (!Array.isArray(tools)) {
+    return config;
+  }
+  const disabledBuiltinTools = /* @__PURE__ */ new Set(["ask_user", "invoke_skill"]);
+  const constrainedTools = tools.filter((entry) => entry.type !== "agent-spawner").map((entry) => {
+    if (entry.type !== "builtin-tools" || entry.enabled === false) {
+      return entry;
+    }
+    const maybeEnabledTools = entry.enabledTools;
+    const enabledTools = Array.isArray(maybeEnabledTools) ? maybeEnabledTools : [...BUILTIN_TOOL_NAMES];
+    const filteredEnabledTools = enabledTools.filter((t) => !disabledBuiltinTools.has(t));
+    return { ...entry, enabledTools: filteredEnabledTools };
+  }).filter((entry) => {
+    if (entry.type !== "builtin-tools") {
+      return true;
+    }
+    const maybeEnabledTools = entry.enabledTools;
+    return !Array.isArray(maybeEnabledTools) || maybeEnabledTools.length > 0;
+  });
+  return { ...config, tools: constrainedTools };
+}
+async function createDextoAgentFromConfig(options) {
+  const { configPath, enrichOptions, agentIdOverride, overrides } = options;
+  const cleanedConfig = cleanNullValues(options.config);
+  const { image } = await loadImageForConfig({
+    config: cleanedConfig,
+    imageNameOverride: options.imageNameOverride
+  });
+  let configWithImageDefaults = applyImageDefaults(cleanedConfig, image.defaults);
+  if (options.agentContext === "subagent") {
+    configWithImageDefaults = applySubAgentToolConstraints(configWithImageDefaults);
+  }
+  const enrichedConfig = enrichAgentConfig(
+    configWithImageDefaults,
+    configPath,
+    enrichOptions ?? {}
+  );
+  if (agentIdOverride !== void 0) {
+    enrichedConfig.agentId = agentIdOverride;
+  }
+  const validatedConfig = AgentConfigSchema.parse(enrichedConfig);
+  const services = await resolveServicesFromConfig(validatedConfig, image);
+  return new DextoAgent(
+    toDextoAgentOptions({
+      config: validatedConfig,
+      services,
+      overrides
+    })
+  );
+}
+export {
+  createDextoAgentFromConfig
+};

package/dist/config/config-enrichment.cjs

@@ -64,7 +64,8 @@ function enrichAgentConfig(config, configPath, options = {}) {
     isInteractiveCli = false,
     logLevel = "error",
     skipPluginDiscovery = false,
-    bundledPlugins = []
+    bundledPlugins = [],
+    forceStoragePaths = false
   } = opts;
   const agentId = deriveAgentId(config, configPath);
   const dbPath = (0, import_path.getDextoPath)("database", `${agentId}.db`);
@@ -94,15 +95,19 @@ function enrichAgentConfig(config, configPath, options = {}) {
       ...config.storage
     };
     if (config.storage.database?.type === "sqlite") {
+      const databasePath = typeof config.storage.database.path === "string" ? config.storage.database.path : void 0;
+      const shouldOverride = !databasePath || forceStoragePaths && !path.isAbsolute(databasePath);
       enriched.storage.database = {
         ...config.storage.database,
-        path: config.storage.database.path || dbPath
+        path: shouldOverride ? dbPath : databasePath
       };
     }
     if (config.storage.blob?.type === "local") {
+      const blobStorePath = typeof config.storage.blob.storePath === "string" ? config.storage.blob.storePath : void 0;
+      const shouldOverride = !blobStorePath || forceStoragePaths && !path.isAbsolute(blobStorePath);
       enriched.storage.blob = {
         ...config.storage.blob,
-        storePath: config.storage.blob.storePath || blobPath
+        storePath: shouldOverride ? blobPath : blobStorePath
       };
     }
   }
@@ -153,17 +158,6 @@ function enrichAgentConfig(config, configPath, options = {}) {
           ...loaded.mcpConfig.mcpServers
         };
       }
-      if (loaded.customToolProviders.length > 0) {
-        for (const providerType of loaded.customToolProviders) {
-          const alreadyConfigured = enriched.customTools?.some(
-            (tool) => typeof tool === "object" && tool !== null && tool.type === providerType
-          );
-          if (!alreadyConfigured) {
-            enriched.customTools = enriched.customTools ?? [];
-            enriched.customTools.push({ type: providerType });
-          }
-        }
-      }
     }
     const standaloneSkills = (0, import_plugins.discoverStandaloneSkills)();
     for (const skill of standaloneSkills) {

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

@@ -12,7 +12,7 @@
  *
  * Core services now require explicit paths - this enrichment layer provides them.
  */
-import type { AgentConfig } from '@dexto/core';
+import type { AgentConfig } from '@dexto/agent-config';
 export { discoverCommandPrompts, discoverAgentInstructionFile } from './discover-prompts.js';
 /**
  * Derives an agent ID from config or file path for per-agent isolation.
@@ -35,6 +35,12 @@ export interface EnrichAgentConfigOptions {
      * user/project plugins.
      */
     bundledPlugins?: string[];
+    /**
+     * When true, normalize relative storage paths (database/blob) to per-agent
+     * locations.
+     * Useful when configs may be loaded from varying working directories.
+     */
+    forceStoragePaths?: boolean;
 }
 /**
  * Enriches agent configuration with per-agent file paths and discovered commands.

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

@@ -1 +1 @@
-{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAgQb"}
+{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAUvD,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAwPb"}

package/dist/config/config-enrichment.js

@@ -32,7 +32,8 @@ function enrichAgentConfig(config, configPath, options = {}) {
     isInteractiveCli = false,
     logLevel = "error",
     skipPluginDiscovery = false,
-    bundledPlugins = []
+    bundledPlugins = [],
+    forceStoragePaths = false
   } = opts;
   const agentId = deriveAgentId(config, configPath);
   const dbPath = getDextoPath("database", `${agentId}.db`);
@@ -62,15 +63,19 @@ function enrichAgentConfig(config, configPath, options = {}) {
       ...config.storage
     };
     if (config.storage.database?.type === "sqlite") {
+      const databasePath = typeof config.storage.database.path === "string" ? config.storage.database.path : void 0;
+      const shouldOverride = !databasePath || forceStoragePaths && !path.isAbsolute(databasePath);
       enriched.storage.database = {
         ...config.storage.database,
-        path: config.storage.database.path || dbPath
+        path: shouldOverride ? dbPath : databasePath
       };
     }
     if (config.storage.blob?.type === "local") {
+      const blobStorePath = typeof config.storage.blob.storePath === "string" ? config.storage.blob.storePath : void 0;
+      const shouldOverride = !blobStorePath || forceStoragePaths && !path.isAbsolute(blobStorePath);
       enriched.storage.blob = {
         ...config.storage.blob,
-        storePath: config.storage.blob.storePath || blobPath
+        storePath: shouldOverride ? blobPath : blobStorePath
       };
     }
   }
@@ -121,17 +126,6 @@ function enrichAgentConfig(config, configPath, options = {}) {
           ...loaded.mcpConfig.mcpServers
         };
       }
-      if (loaded.customToolProviders.length > 0) {
-        for (const providerType of loaded.customToolProviders) {
-          const alreadyConfigured = enriched.customTools?.some(
-            (tool) => typeof tool === "object" && tool !== null && tool.type === providerType
-          );
-          if (!alreadyConfigured) {
-            enriched.customTools = enriched.customTools ?? [];
-            enriched.customTools.push({ type: providerType });
-          }
-        }
-      }
     }
     const standaloneSkills = discoverStandaloneSkills();
     for (const skill of standaloneSkills) {

package/dist/config/config-manager.cjs

@@ -42,19 +42,19 @@ var path = __toESM(require("path"), 1);
 var import_yaml = require("yaml");
 var import_loader = require("./loader.js");
 var import_config_enrichment = require("./config-enrichment.js");
+var import_agent_config = require("@dexto/agent-config");
 var import_core = require("@dexto/core");
 var import_core2 = require("@dexto/core");
-var import_core3 = require("@dexto/core");
 async function updateAgentConfigFile(configPath, updates) {
   const rawYaml = await import_fs.promises.readFile(configPath, "utf-8");
   const doc = (0, import_yaml.parseDocument)(rawYaml);
   const rawConfig = doc.toJSON();
   const updatedRawConfig = { ...rawConfig, ...updates };
   const enrichedConfig = (0, import_config_enrichment.enrichAgentConfig)(updatedRawConfig, configPath);
-  const parsed = import_core.AgentConfigSchema.safeParse(enrichedConfig);
+  const parsed = import_agent_config.AgentConfigSchema.safeParse(enrichedConfig);
   if (!parsed.success) {
-    const result = (0, import_core3.fail)((0, import_core3.zodToIssues)(parsed.error, "error"));
-    throw new import_core2.DextoValidationError(result.issues);
+    const result = (0, import_core2.fail)((0, import_core2.zodToIssues)(parsed.error, "error"));
+    throw new import_core.DextoValidationError(result.issues);
   }
   for (const [key, value] of Object.entries(updates)) {
     doc.set(key, value);

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

@@ -1,4 +1,4 @@
-import type { AgentConfig, ValidatedAgentConfig } from '@dexto/core';
+import { type AgentConfig, type ValidatedAgentConfig } from '@dexto/agent-config';
 /**
  * Input type for adding a file-based prompt
  */

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

@@ -1 +1 @@
-{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/config/config-manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAKrE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAuC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAExF;AAyHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAclB;AAwDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAmHD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,2BAA2B,CAC7C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,yBAAyB,EACjC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAyB,GACzD,OAAO,CAAC,oBAAoB,CAAC,CAsD/B"}
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/config/config-manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAC5B,MAAM,qBAAqB,CAAC;AAI7B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,qBAAqB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAuC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAExF;AAyHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAclB;AAwDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAmHD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,2BAA2B,CAC7C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,yBAAyB,EACjC,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAyB,GACzD,OAAO,CAAC,oBAAoB,CAAC,CAsD/B"}

package/dist/config/config-manager.js

@@ -3,7 +3,9 @@ import * as path from "path";
 import { parseDocument, stringify } from "yaml";
 import { loadAgentConfig } from "./loader.js";
 import { enrichAgentConfig } from "./config-enrichment.js";
-import { AgentConfigSchema } from "@dexto/core";
+import {
+  AgentConfigSchema
+} from "@dexto/agent-config";
 import { DextoValidationError } from "@dexto/core";
 import { fail, zodToIssues } from "@dexto/core";
 async function updateAgentConfigFile(configPath, updates) {

package/dist/config/loader.d.ts

@@ -1,5 +1,5 @@
-import type { AgentConfig } from '@dexto/core';
-import type { IDextoLogger } from '@dexto/core';
+import type { AgentConfig } from '@dexto/agent-config';
+import type { Logger } from '@dexto/core';
 /**
  * Asynchronously loads and processes an agent configuration file.
  * This function handles file reading, YAML parsing, and template variable expansion.
@@ -14,5 +14,5 @@ import type { IDextoLogger } from '@dexto/core';
  * @throws {ConfigError} with FILE_READ_ERROR if file read fails (e.g., permissions issues)
  * @throws {ConfigError} with PARSE_ERROR if the content is not valid YAML or template expansion fails
  */
-export declare function loadAgentConfig(configPath: string, logger?: IDextoLogger): Promise<AgentConfig>;
+export declare function loadAgentConfig(configPath: string, logger?: Logger): Promise<AgentConfig>;
 //# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsGhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,WAAW,CAAC,CA6DtB"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAsG1C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6D/F"}