@dexto/core 1.5.7 → 1.5.8

package/dist/tools/tool-manager.js

@@ -11,11 +11,13 @@ import { DextoRuntimeError } from "../errors/index.js";
 import { DextoLogComponent } from "../logger/v2/types.js";
 import { ApprovalStatus, ApprovalType, DenialReason } from "../approval/types.js";
 import { InstrumentClass } from "../telemetry/decorators.js";
+import { extractToolCallMeta, wrapToolParametersSchema } from "./tool-call-metadata.js";
 import {
   generateBashPatternKey,
   generateBashPatternSuggestions,
   isDangerousCommand
 } from "./bash-pattern-utils.js";
+import { isBackgroundTasksEnabled } from "../utils/env.js";
 _ToolManager_decorators = [InstrumentClass({
   prefix: "tool",
   excludeMethods: [
@@ -49,6 +51,10 @@ let _ToolManager = class _ToolManager {
   // When a skill with allowedTools is invoked, those tools are auto-approved (skip confirmation)
   // This is ADDITIVE - other tools are NOT blocked, they just go through normal approval flow
   sessionAutoApproveTools = /* @__PURE__ */ new Map();
+  // Session-level auto-approve tools set by users (UI)
+  sessionUserAutoApproveTools = /* @__PURE__ */ new Map();
+  sessionDisabledTools = /* @__PURE__ */ new Map();
+  globalDisabledTools = [];
   constructor(mcpManager, approvalManager, allowedToolsProvider, approvalMode, agentEventBus, toolPolicies, options, logger) {
     this.mcpManager = mcpManager;
     this.approvalManager = approvalManager;
@@ -143,6 +149,30 @@ let _ToolManager = class _ToolManager {
     );
     this.logger.debug(`Auto-approve tools: ${autoApproveTools.join(", ")}`);
   }
+  /**
+   * Set session-level auto-approve tools chosen by the user.
+   */
+  setSessionUserAutoApproveTools(sessionId, autoApproveTools) {
+    if (autoApproveTools.length === 0) {
+      this.clearSessionUserAutoApproveTools(sessionId);
+      return;
+    }
+    this.sessionUserAutoApproveTools.set(sessionId, autoApproveTools);
+    this.logger.info(
+      `Session user auto-approve tools set for '${sessionId}': ${autoApproveTools.length} tools`
+    );
+    this.logger.debug(`User auto-approve tools: ${autoApproveTools.join(", ")}`);
+  }
+  /**
+   * Clear session-level auto-approve tools chosen by the user.
+   */
+  clearSessionUserAutoApproveTools(sessionId) {
+    const hadAutoApprove = this.sessionUserAutoApproveTools.has(sessionId);
+    this.sessionUserAutoApproveTools.delete(sessionId);
+    if (hadAutoApprove) {
+      this.logger.info(`Session user auto-approve tools cleared for '${sessionId}'`);
+    }
+  }
   /**
    * Clear session-level auto-approve tools.
    * Call this when the session ends or when the skill completes.
@@ -156,6 +186,76 @@ let _ToolManager = class _ToolManager {
       this.logger.info(`Session auto-approve tools cleared for '${sessionId}'`);
     }
   }
+  hasSessionUserAutoApproveTools(sessionId) {
+    return this.sessionUserAutoApproveTools.has(sessionId);
+  }
+  // ============= ENABLED/DISABLED TOOLS =============
+  /**
+   * Set global disabled tools (agent-level preferences).
+   */
+  setGlobalDisabledTools(toolNames) {
+    this.globalDisabledTools = [...toolNames];
+    this.logger.info("Global disabled tools updated", {
+      count: toolNames.length
+    });
+    this.agentEventBus.emit("tools:enabled-updated", {
+      scope: "global",
+      disabledTools: [...this.globalDisabledTools]
+    });
+  }
+  getGlobalDisabledTools() {
+    return [...this.globalDisabledTools];
+  }
+  /**
+   * Set session-level disabled tools (overrides global list).
+   */
+  setSessionDisabledTools(sessionId, toolNames) {
+    if (toolNames.length === 0) {
+      this.clearSessionDisabledTools(sessionId);
+      return;
+    }
+    this.sessionDisabledTools.set(sessionId, [...toolNames]);
+    this.logger.info("Session disabled tools updated", {
+      sessionId,
+      count: toolNames.length
+    });
+    this.agentEventBus.emit("tools:enabled-updated", {
+      scope: "session",
+      sessionId,
+      disabledTools: [...toolNames]
+    });
+  }
+  /**
+   * Clear session-level disabled tools.
+   */
+  clearSessionDisabledTools(sessionId) {
+    const hadOverrides = this.sessionDisabledTools.has(sessionId);
+    this.sessionDisabledTools.delete(sessionId);
+    if (hadOverrides) {
+      this.logger.info("Session disabled tools cleared", { sessionId });
+    }
+  }
+  /**
+   * Get disabled tools for a session (session override wins).
+   */
+  getDisabledTools(sessionId) {
+    if (sessionId && this.sessionDisabledTools.has(sessionId)) {
+      return this.sessionDisabledTools.get(sessionId) ?? [];
+    }
+    return this.globalDisabledTools;
+  }
+  /**
+   * Filter a tool set based on disabled tools for a session.
+   */
+  filterToolsForSession(toolSet, sessionId) {
+    const disabled = new Set(this.getDisabledTools(sessionId));
+    if (disabled.size === 0) {
+      return toolSet;
+    }
+    return Object.fromEntries(
+      Object.entries(toolSet).filter(([toolName]) => !disabled.has(toolName))
+    );
+  }
   /**
    * Check if a session has auto-approve tools set.
    *
@@ -166,7 +266,7 @@ let _ToolManager = class _ToolManager {
     return this.sessionAutoApproveTools.has(sessionId);
   }
   /**
-   * Get the auto-approve tools for a session.
+   * Get the auto-approve tools for a session (skill-provided list).
    *
    * @param sessionId The session ID to check
    * @returns Array of auto-approve tool names, or undefined if none set
@@ -174,6 +274,21 @@ let _ToolManager = class _ToolManager {
   getSessionAutoApproveTools(sessionId) {
     return this.sessionAutoApproveTools.get(sessionId);
   }
+  /**
+   * Get the user auto-approve tools for a session.
+   */
+  getSessionUserAutoApproveTools(sessionId) {
+    return this.sessionUserAutoApproveTools.get(sessionId);
+  }
+  /**
+   * Combined auto-approve list for a session.
+   */
+  getCombinedSessionAutoApproveTools(sessionId) {
+    return [
+      ...this.sessionAutoApproveTools.get(sessionId) ?? [],
+      ...this.sessionUserAutoApproveTools.get(sessionId) ?? []
+    ];
+  }
   /**
    * Check if a tool should be auto-approved for a session.
    * Returns true if the tool is in the session's auto-approve list.
@@ -183,8 +298,8 @@ let _ToolManager = class _ToolManager {
    * @returns true if the tool should be auto-approved
    */
   isToolAutoApprovedForSession(sessionId, toolName) {
-    const autoApproveTools = this.sessionAutoApproveTools.get(sessionId);
-    if (!autoApproveTools) {
+    const autoApproveTools = this.getCombinedSessionAutoApproveTools(sessionId);
+    if (autoApproveTools.length === 0) {
       return false;
     }
     return autoApproveTools.some((pattern) => this.matchesToolPolicy(toolName, pattern));
@@ -381,7 +496,8 @@ let _ToolManager = class _ToolManager {
       allTools[qualifiedName] = {
         ...toolDef,
         name: qualifiedName,
-        description: `${toolDef.description || "No description provided"} (internal tool)`
+        description: `${toolDef.description || "No description provided"} (internal tool)`,
+        parameters: wrapToolParametersSchema(toolDef.parameters)
       };
     }
     for (const [toolName, toolDef] of Object.entries(customTools)) {
@@ -389,7 +505,8 @@ let _ToolManager = class _ToolManager {
       allTools[qualifiedName] = {
         ...toolDef,
         name: qualifiedName,
-        description: `${toolDef.description || "No description provided"} (custom tool)`
+        description: `${toolDef.description || "No description provided"} (custom tool)`,
+        parameters: wrapToolParametersSchema(toolDef.parameters)
       };
     }
     for (const [toolName, toolDef] of Object.entries(mcpTools)) {
@@ -397,7 +514,8 @@ let _ToolManager = class _ToolManager {
       allTools[qualifiedName] = {
         ...toolDef,
         name: qualifiedName,
-        description: `${toolDef.description || "No description provided"} (via MCP servers)`
+        description: `${toolDef.description || "No description provided"} (via MCP servers)`,
+        parameters: wrapToolParametersSchema(toolDef.parameters)
       };
     }
     const totalTools = Object.keys(allTools).length;
@@ -433,21 +551,25 @@ let _ToolManager = class _ToolManager {
    * @param abortSignal Optional abort signal for cancellation support
    */
   async executeTool(toolName, args, toolCallId, sessionId, abortSignal) {
+    const { toolArgs: rawToolArgs, meta } = extractToolCallMeta(args);
+    let toolArgs = rawToolArgs;
+    const backgroundTasksEnabled = isBackgroundTasksEnabled();
     this.logger.debug(`\u{1F527} Tool execution requested: '${toolName}' (toolCallId: ${toolCallId})`);
-    this.logger.debug(`Tool args: ${JSON.stringify(args, null, 2)}`);
+    this.logger.debug(`Tool args: ${JSON.stringify(toolArgs, null, 2)}`);
     if (sessionId) {
       this.agentEventBus.emit("llm:tool-call", {
         toolName,
-        args,
+        args: toolArgs,
         callId: toolCallId,
         sessionId
       });
     }
     const { requireApproval, approvalStatus } = await this.handleToolApproval(
       toolName,
-      args,
+      toolArgs,
       toolCallId,
-      sessionId
+      sessionId,
+      meta.callDescription
     );
     this.logger.debug(`\u2705 Tool execution approved: ${toolName}`);
     this.logger.info(
@@ -464,7 +586,7 @@ let _ToolManager = class _ToolManager {
     if (this.pluginManager && this.sessionManager && this.stateManager) {
       const beforePayload = {
         toolName,
-        args,
+        args: toolArgs,
         ...sessionId !== void 0 && { sessionId }
       };
       const modifiedPayload = await this.pluginManager.executePlugins(
@@ -478,10 +600,21 @@ let _ToolManager = class _ToolManager {
           ...sessionId !== void 0 && { sessionId }
         }
       );
-      args = modifiedPayload.args;
+      toolArgs = modifiedPayload.args;
     }
     try {
       let result;
+      const registerBackgroundTask = (promise, description) => {
+        const fallbackId = `task-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        return {
+          result: {
+            taskId: toolCallId ?? fallbackId,
+            status: "running",
+            description
+          },
+          promise
+        };
+      };
       if (toolName.startsWith(_ToolManager.MCP_TOOL_PREFIX)) {
         this.logger.debug(`\u{1F527} Detected MCP tool: '${toolName}'`);
         const actualToolName = toolName.substring(_ToolManager.MCP_TOOL_PREFIX.length);
@@ -489,7 +622,34 @@ let _ToolManager = class _ToolManager {
           throw ToolError.invalidName(toolName, "tool name cannot be empty after prefix");
         }
         this.logger.debug(`\u{1F3AF} MCP routing: '${toolName}' -> '${actualToolName}'`);
-        result = await this.mcpManager.executeTool(actualToolName, args, sessionId);
+        const runInBackground = backgroundTasksEnabled && meta.runInBackground === true && sessionId !== void 0;
+        if (meta.runInBackground === true && !backgroundTasksEnabled) {
+          this.logger.debug(
+            "Background tool execution disabled; running synchronously instead.",
+            { toolName }
+          );
+        }
+        if (runInBackground) {
+          const backgroundSessionId = sessionId;
+          const { result: backgroundResult, promise } = registerBackgroundTask(
+            this.mcpManager.executeTool(actualToolName, toolArgs, backgroundSessionId),
+            `MCP tool ${actualToolName}`
+          );
+          this.agentEventBus.emit("tool:background", {
+            toolName,
+            toolCallId: backgroundResult.taskId,
+            sessionId: backgroundSessionId,
+            description: backgroundResult.description,
+            promise,
+            ...meta.timeoutMs !== void 0 && { timeoutMs: meta.timeoutMs },
+            ...meta.notifyOnComplete !== void 0 && {
+              notifyOnComplete: meta.notifyOnComplete
+            }
+          });
+          result = backgroundResult;
+        } else {
+          result = await this.mcpManager.executeTool(actualToolName, toolArgs, sessionId);
+        }
       } else if (toolName.startsWith(_ToolManager.INTERNAL_TOOL_PREFIX)) {
         this.logger.debug(`\u{1F527} Detected internal tool: '${toolName}'`);
         const actualToolName = toolName.substring(_ToolManager.INTERNAL_TOOL_PREFIX.length);
@@ -500,13 +660,46 @@ let _ToolManager = class _ToolManager {
           throw ToolError.internalToolsNotInitialized(toolName);
         }
         this.logger.debug(`\u{1F3AF} Internal routing: '${toolName}' -> '${actualToolName}'`);
-        result = await this.internalToolsProvider.executeTool(
-          actualToolName,
-          args,
-          sessionId,
-          abortSignal,
-          toolCallId
-        );
+        const runInBackground = backgroundTasksEnabled && meta.runInBackground === true && sessionId !== void 0;
+        if (meta.runInBackground === true && !backgroundTasksEnabled) {
+          this.logger.debug(
+            "Background tool execution disabled; running synchronously instead.",
+            { toolName }
+          );
+        }
+        if (runInBackground) {
+          const backgroundSessionId = sessionId;
+          const { result: backgroundResult, promise } = registerBackgroundTask(
+            this.internalToolsProvider.executeTool(
+              actualToolName,
+              toolArgs,
+              backgroundSessionId,
+              abortSignal,
+              toolCallId
+            ),
+            `Internal tool ${actualToolName}`
+          );
+          this.agentEventBus.emit("tool:background", {
+            toolName,
+            toolCallId: backgroundResult.taskId,
+            sessionId: backgroundSessionId,
+            description: backgroundResult.description,
+            promise,
+            ...meta.timeoutMs !== void 0 && { timeoutMs: meta.timeoutMs },
+            ...meta.notifyOnComplete !== void 0 && {
+              notifyOnComplete: meta.notifyOnComplete
+            }
+          });
+          result = backgroundResult;
+        } else {
+          result = await this.internalToolsProvider.executeTool(
+            actualToolName,
+            toolArgs,
+            sessionId,
+            abortSignal,
+            toolCallId
+          );
+        }
       } else if (toolName.startsWith(_ToolManager.CUSTOM_TOOL_PREFIX)) {
         this.logger.debug(`\u{1F527} Detected custom tool: '${toolName}'`);
         const actualToolName = toolName.substring(_ToolManager.CUSTOM_TOOL_PREFIX.length);
@@ -517,13 +710,46 @@ let _ToolManager = class _ToolManager {
           throw ToolError.internalToolsNotInitialized(toolName);
         }
         this.logger.debug(`\u{1F3AF} Custom routing: '${toolName}' -> '${actualToolName}'`);
-        result = await this.internalToolsProvider.executeTool(
-          actualToolName,
-          args,
-          sessionId,
-          abortSignal,
-          toolCallId
-        );
+        const runInBackground = backgroundTasksEnabled && meta.runInBackground === true && sessionId !== void 0;
+        if (meta.runInBackground === true && !backgroundTasksEnabled) {
+          this.logger.debug(
+            "Background tool execution disabled; running synchronously instead.",
+            { toolName }
+          );
+        }
+        if (runInBackground) {
+          const backgroundSessionId = sessionId;
+          const { result: backgroundResult, promise } = registerBackgroundTask(
+            this.internalToolsProvider.executeTool(
+              actualToolName,
+              toolArgs,
+              backgroundSessionId,
+              abortSignal,
+              toolCallId
+            ),
+            `Custom tool ${actualToolName}`
+          );
+          this.agentEventBus.emit("tool:background", {
+            toolName,
+            toolCallId: backgroundResult.taskId,
+            sessionId: backgroundSessionId,
+            description: backgroundResult.description,
+            promise,
+            ...meta.timeoutMs !== void 0 && { timeoutMs: meta.timeoutMs },
+            ...meta.notifyOnComplete !== void 0 && {
+              notifyOnComplete: meta.notifyOnComplete
+            }
+          });
+          result = backgroundResult;
+        } else {
+          result = await this.internalToolsProvider.executeTool(
+            actualToolName,
+            toolArgs,
+            sessionId,
+            abortSignal,
+            toolCallId
+          );
+        }
       } else {
         this.logger.debug(`\u{1F527} Detected tool without proper prefix: '${toolName}'`);
         const stats = await this.getToolStats();
@@ -776,12 +1002,12 @@ let _ToolManager = class _ToolManager {
    * Handle tool approval flow. Checks various precedence levels to determine
    * if a tool should be auto-approved, denied, or requires manual approval.
    */
-  async handleToolApproval(toolName, args, toolCallId, sessionId) {
+  async handleToolApproval(toolName, args, toolCallId, sessionId, callDescription) {
     const quickResult = await this.tryQuickApprovalResolution(toolName, args, sessionId);
     if (quickResult !== null) {
       return quickResult;
     }
-    return this.requestManualApproval(toolName, args, toolCallId, sessionId);
+    return this.requestManualApproval(toolName, args, toolCallId, sessionId, callDescription);
   }
   /**
    * Try to resolve tool approval quickly based on policies and cached permissions.
@@ -855,7 +1081,7 @@ let _ToolManager = class _ToolManager {
    * Request manual approval from the user for a tool execution.
    * Generates preview, sends approval request, and handles the response.
    */
-  async requestManualApproval(toolName, args, toolCallId, sessionId) {
+  async requestManualApproval(toolName, args, toolCallId, sessionId, callDescription) {
     this.logger.info(
       `Tool confirmation requested for ${toolName}, sessionId: ${sessionId ?? "global"}`
     );
@@ -871,6 +1097,7 @@ let _ToolManager = class _ToolManager {
         toolName,
         toolCallId,
         args,
+        ...callDescription !== void 0 && { description: callDescription },
         ...sessionId !== void 0 && { sessionId },
         ...displayPreview !== void 0 && { displayPreview },
         ...suggestedPatterns !== void 0 && { suggestedPatterns }

package/dist/utils/api-key-resolver.cjs

@@ -52,7 +52,7 @@ const PROVIDER_API_KEY_MAP = {
   ollama: [],
   // Ollama server (no authentication required)
   // Dexto gateway - requires key from `dexto login`
-  dexto: ["DEXTO_API_KEY"]
+  "dexto-nova": ["DEXTO_API_KEY"]
   // perplexity: ['PERPLEXITY_API_KEY'],
   // together: ['TOGETHER_API_KEY'],
   // fireworks: ['FIREWORKS_API_KEY'],

package/dist/utils/api-key-resolver.js

@@ -28,7 +28,7 @@ const PROVIDER_API_KEY_MAP = {
   ollama: [],
   // Ollama server (no authentication required)
   // Dexto gateway - requires key from `dexto login`
-  dexto: ["DEXTO_API_KEY"]
+  "dexto-nova": ["DEXTO_API_KEY"]
   // perplexity: ['PERPLEXITY_API_KEY'],
   // together: ['TOGETHER_API_KEY'],
   // fireworks: ['FIREWORKS_API_KEY'],

package/dist/utils/env.cjs

@@ -0,0 +1,49 @@
+"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 env_exports = {};
+__export(env_exports, {
+  isBackgroundTasksEnabled: () => isBackgroundTasksEnabled,
+  isTruthyEnv: () => isTruthyEnv,
+  readBooleanEnv: () => readBooleanEnv
+});
+module.exports = __toCommonJS(env_exports);
+const TRUE_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
+const FALSE_VALUES = /* @__PURE__ */ new Set(["0", "false", "no", "off"]);
+function isTruthyEnv(name) {
+  const value = process.env[name];
+  if (!value) return false;
+  return TRUE_VALUES.has(value.trim().toLowerCase());
+}
+function readBooleanEnv(name, defaultValue) {
+  const value = process.env[name];
+  if (value === void 0) return defaultValue;
+  const normalized = value.trim().toLowerCase();
+  if (TRUE_VALUES.has(normalized)) return true;
+  if (FALSE_VALUES.has(normalized)) return false;
+  return defaultValue;
+}
+function isBackgroundTasksEnabled() {
+  return readBooleanEnv("DEXTO_BACKGROUND_TASKS_ENABLED", false);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isBackgroundTasksEnabled,
+  isTruthyEnv,
+  readBooleanEnv
+});

package/dist/utils/env.d.ts

@@ -0,0 +1,4 @@
+export declare function isTruthyEnv(name: string): boolean;
+export declare function readBooleanEnv(name: string, defaultValue: boolean): boolean;
+export declare function isBackgroundTasksEnabled(): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAO3E;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD"}

package/dist/utils/env.js

@@ -0,0 +1,24 @@
+import "../chunk-PTJYTZNU.js";
+const TRUE_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
+const FALSE_VALUES = /* @__PURE__ */ new Set(["0", "false", "no", "off"]);
+function isTruthyEnv(name) {
+  const value = process.env[name];
+  if (!value) return false;
+  return TRUE_VALUES.has(value.trim().toLowerCase());
+}
+function readBooleanEnv(name, defaultValue) {
+  const value = process.env[name];
+  if (value === void 0) return defaultValue;
+  const normalized = value.trim().toLowerCase();
+  if (TRUE_VALUES.has(normalized)) return true;
+  if (FALSE_VALUES.has(normalized)) return false;
+  return defaultValue;
+}
+function isBackgroundTasksEnabled() {
+  return readBooleanEnv("DEXTO_BACKGROUND_TASKS_ENABLED", false);
+}
+export {
+  isBackgroundTasksEnabled,
+  isTruthyEnv,
+  readBooleanEnv
+};

package/dist/utils/index.cjs

@@ -28,6 +28,7 @@ __reExport(utils_exports, require("./safe-stringify.js"), module.exports);
 __reExport(utils_exports, require("./api-key-resolver.js"), module.exports);
 __reExport(utils_exports, require("./defer.js"), module.exports);
 __reExport(utils_exports, require("./async-context.js"), module.exports);
+__reExport(utils_exports, require("./env.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./path.js"),
@@ -42,5 +43,6 @@ __reExport(utils_exports, require("./async-context.js"), module.exports);
   ...require("./safe-stringify.js"),
   ...require("./api-key-resolver.js"),
   ...require("./defer.js"),
-  ...require("./async-context.js")
+  ...require("./async-context.js"),
+  ...require("./env.js")
 });

package/dist/utils/index.d.ts

@@ -11,4 +11,5 @@ export * from './safe-stringify.js';
 export * from './api-key-resolver.js';
 export * from './defer.js';
 export * from './async-context.js';
+export * from './env.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAKA,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAKA,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -11,3 +11,4 @@ export * from "./safe-stringify.js";
 export * from "./api-key-resolver.js";
 export * from "./defer.js";
 export * from "./async-context.js";
+export * from "./env.js";

package/dist/utils/service-initializer.cjs

@@ -116,7 +116,22 @@ async function createAgentServices(config, configPath, logger, agentEventBus, ov
     },
     logger
   );
-  const toolManager = new import_tool_manager.ToolManager(
+  const internalToolsServices = {
+    searchService,
+    resourceManager
+  };
+  const toolManager = overrides?.toolManager ?? overrides?.toolManagerFactory?.({
+    mcpManager,
+    approvalManager,
+    allowedToolsProvider,
+    approvalMode: config.toolConfirmation.mode,
+    agentEventBus,
+    toolPolicies: config.toolConfirmation.toolPolicies,
+    internalToolsConfig: config.internalTools,
+    customToolsConfig: config.customTools,
+    internalToolsServices,
+    logger
+  }) ?? new import_tool_manager.ToolManager(
     mcpManager,
     approvalManager,
     allowedToolsProvider,
@@ -124,10 +139,7 @@ async function createAgentServices(config, configPath, logger, agentEventBus, ov
     agentEventBus,
     config.toolConfirmation.toolPolicies,
     {
-      internalToolsServices: {
-        searchService,
-        resourceManager
-      },
+      internalToolsServices,
       internalToolsConfig: config.internalTools,
       customToolsConfig: config.customTools
     },

package/dist/utils/service-initializer.d.ts

@@ -1,5 +1,8 @@
 import { MCPManager } from '../mcp/manager.js';
 import { ToolManager } from '../tools/tool-manager.js';
+import type { InternalToolsServices } from '../tools/internal-tools/registry.js';
+import type { InternalToolsConfig, CustomToolsConfig, ToolPolicies } from '../tools/schemas.js';
+import type { IAllowedToolsProvider } from '../tools/confirmation/allowed-tools-provider/types.js';
 import { SystemPromptManager } from '../systemPrompt/manager.js';
 import { AgentStateManager } from '../agent/state-manager.js';
 import { SessionManager } from '../session/index.js';
@@ -29,6 +32,25 @@ export type AgentServices = {
     memoryManager: MemoryManager;
     pluginManager: PluginManager;
 };
+export type ToolManagerFactoryOptions = {
+    mcpManager: MCPManager;
+    approvalManager: ApprovalManager;
+    allowedToolsProvider: IAllowedToolsProvider;
+    approvalMode: 'manual' | 'auto-approve' | 'auto-deny';
+    agentEventBus: AgentEventBus;
+    toolPolicies: ToolPolicies;
+    internalToolsConfig: InternalToolsConfig;
+    customToolsConfig: CustomToolsConfig;
+    internalToolsServices: InternalToolsServices & Record<string, unknown>;
+    logger: IDextoLogger;
+};
+export type ToolManagerFactory = (options: ToolManagerFactoryOptions) => ToolManager;
+export type InitializeServicesOptions = {
+    sessionLoggerFactory?: import('../session/session-manager.js').SessionLoggerFactory;
+    mcpAuthProviderFactory?: import('../mcp/types.js').McpAuthProviderFactory | null;
+    toolManager?: ToolManager;
+    toolManagerFactory?: ToolManagerFactory;
+};
 /**
  * Initializes all agent services from a validated configuration.
  * @param config The validated agent configuration object
@@ -38,8 +60,5 @@ export type AgentServices = {
  * @param overrides Optional service overrides for customization (e.g., sessionLoggerFactory)
  * @returns All the initialized services required for a Dexto agent
  */
-export declare function createAgentServices(config: ValidatedAgentConfig, configPath: string | undefined, logger: IDextoLogger, agentEventBus: AgentEventBus, overrides?: {
-    sessionLoggerFactory?: import('../session/session-manager.js').SessionLoggerFactory;
-    mcpAuthProviderFactory?: import('../mcp/types.js').McpAuthProviderFactory | null;
-}): Promise<AgentServices>;
+export declare function createAgentServices(config: ValidatedAgentConfig, configPath: string | undefined, logger: IDextoLogger, agentEventBus: AgentEventBus, overrides?: InitializeServicesOptions): Promise<AgentServices>;
 //# sourceMappingURL=service-initializer.d.ts.map

package/dist/utils/service-initializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-initializer.d.ts","sourceRoot":"","sources":["../../src/utils/service-initializer.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAwB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,iBAAiB,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;CAChC,CAAC;AAGF;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE;IACR,oBAAoB,CAAC,EAAE,OAAO,+BAA+B,EAAE,oBAAoB,CAAC;IACpF,sBAAsB,CAAC,EAAE,OAAO,iBAAiB,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACpF,GACF,OAAO,CAAC,aAAa,CAAC,CAsMxB"}
+{"version":3,"file":"service-initializer.d.ts","sourceRoot":"","sources":["../../src/utils/service-initializer.ts"],"names":[],"mappings":"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"}