@dexto/core 1.5.7 → 1.6.0

package/dist/tools/types.d.ts

@@ -1,17 +1,84 @@
 import type { JSONSchema7 } from 'json-schema';
-import type { ZodSchema } from 'zod';
+import type { z, ZodTypeAny } from 'zod';
 import type { ToolDisplayData } from './display-types.js';
+import type { WorkspaceContext } from '../workspace/types.js';
 import type { ApprovalRequestDetails, ApprovalResponse } from '../approval/types.js';
+import type { ApprovalManager } from '../approval/manager.js';
+import type { DextoAgent } from '../agent/DextoAgent.js';
+import type { Cache } from '../storage/cache/types.js';
+import type { BlobStore } from '../storage/blob/types.js';
+import type { Database } from '../storage/database/types.js';
+import type { MCPManager } from '../mcp/manager.js';
+import type { PromptManager } from '../prompts/prompt-manager.js';
+import type { ResourceManager } from '../resources/manager.js';
+import type { SearchService } from '../search/search-service.js';
+import type { Logger } from '../logger/v2/types.js';
+/**
+ * Interface for forking execution to an isolated sub-agent context.
+ *
+ * Implemented by AgentSpawnerRuntime in `@dexto/agent-management` and surfaced to tools
+ * via {@link ToolExecutionContext.services}.
+ */
+export interface TaskForker {
+    fork(options: {
+        task: string;
+        instructions: string;
+        agentId?: string;
+        autoApprove?: boolean;
+        toolCallId?: string;
+        sessionId?: string;
+    }): Promise<{
+        success: boolean;
+        response?: string;
+        error?: string;
+    }>;
+}
+export type TaskForkOptions = Parameters<TaskForker['fork']>[0];
+export interface ToolServices {
+    approval: ApprovalManager;
+    search: SearchService;
+    resources: ResourceManager;
+    prompts: PromptManager;
+    mcp: MCPManager;
+    taskForker: TaskForker | null;
+}
 /**
  * Context passed to tool execution
  */
-export interface ToolExecutionContext {
+export interface ToolExecutionContextBase {
     /** Session ID if available */
     sessionId?: string | undefined;
+    /** Workspace ID if available */
+    workspaceId?: string | undefined;
+    /** Workspace context if available */
+    workspace?: WorkspaceContext | undefined;
     /** Abort signal for cancellation support */
     abortSignal?: AbortSignal | undefined;
     /** Unique tool call ID for tracking parallel tool calls */
     toolCallId?: string | undefined;
+    /**
+     * Logger scoped to the tool execution.
+     */
+    logger: Logger;
+}
+export interface ToolExecutionContext extends ToolExecutionContextBase {
+    /**
+     * Runtime agent reference (DI refactor: provided by ToolManager on each execute()).
+     */
+    agent?: DextoAgent | undefined;
+    /**
+     * Concrete storage backends (DI-first).
+     */
+    storage?: {
+        blob: BlobStore;
+        database: Database;
+        cache: Cache;
+    } | undefined;
+    /**
+     * Runtime services available to tools. These are injected at execution time (not factory time)
+     * to avoid init ordering cycles.
+     */
+    services?: ToolServices | undefined;
 }
 /**
  * Result of tool execution, including approval metadata
@@ -19,43 +86,74 @@ export interface ToolExecutionContext {
 export interface ToolExecutionResult {
     /** The actual result data from tool execution */
     result: unknown;
+    /** Optional display name for the tool (UI convenience) */
+    toolDisplayName?: string;
     /** Whether this tool required user approval before execution */
     requireApproval?: boolean;
     /** The approval status (only present if requireApproval is true) */
     approvalStatus?: 'approved' | 'rejected';
 }
 /**
- * Internal tool interface - for tools implemented within Dexto
+ * Tool interface - for tools implemented within Dexto
  */
-export interface InternalTool {
+export interface Tool<TSchema extends ZodTypeAny = ZodTypeAny> {
     /** Unique identifier for the tool */
     id: string;
+    /**
+     * Short, user-facing name for this tool (UI convenience).
+     * Defaults to a title-cased version of {@link id} when omitted.
+     */
+    displayName?: string | undefined;
     /** Human-readable description of what the tool does */
     description: string;
     /** Zod schema defining the input parameters */
-    inputSchema: ZodSchema;
+    inputSchema: TSchema;
     /** The actual function that executes the tool - input is validated by Zod before execution */
-    execute: (input: unknown, context?: ToolExecutionContext) => Promise<unknown> | unknown;
+    execute(input: z.output<TSchema>, context: ToolExecutionContext): Promise<unknown> | unknown;
     /**
      * Optional preview generator for approval UI.
      * Called before requesting user approval to generate display data (e.g., diff preview).
      * Returns null if no preview is available.
      */
-    generatePreview?: (input: unknown, context?: ToolExecutionContext) => Promise<ToolDisplayData | null>;
+    generatePreview?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolDisplayData | null>;
+    /**
+     * Optional aliases for this tool id.
+     *
+     * Used to support external prompt/skill ecosystems that refer to tools by short names
+     * (e.g. Claude Code "bash", "read", "grep" in allowed-tools). Aliases are resolved
+     * by {@link ToolManager} when applying session auto-approve lists.
+     */
+    aliases?: string[] | undefined;
+    /**
+     * Optional pattern key generator for approval memory.
+     *
+     * If provided, ToolManager will:
+     * - Skip confirmation when the pattern key is covered by previously approved patterns.
+     * - Offer suggested patterns (if {@link suggestApprovalPatterns} is provided) in the approval UI.
+     *
+     * Return null to disable pattern approvals for the given input (e.g. dangerous commands).
+     */
+    getApprovalPatternKey?(input: z.output<TSchema>): string | null;
+    /**
+     * Optional pattern suggestions for the approval UI.
+     *
+     * Returned patterns are shown as quick "remember pattern" options.
+     */
+    suggestApprovalPatterns?(input: z.output<TSchema>): string[];
     /**
      * Optional custom approval override.
      * If present and returns non-null, this approval request is used instead of
      * the default tool confirmation. Allows tools to request specialized approval
      * flows (e.g., directory access approval for file tools).
      *
-     * @param args The validated input arguments for the tool
+     * @param input The validated input arguments for the tool
      * @returns ApprovalRequestDetails for custom approval, or null to use default tool confirmation
      *
      * @example
      * ```typescript
      * // File tool requesting directory access approval for external paths
-     * getApprovalOverride: async (args) => {
-     *   const filePath = (args as {file_path: string}).file_path;
+     * getApprovalOverride: async (input) => {
+     *   const filePath = (input as {file_path: string}).file_path;
      *   if (!await isPathWithinAllowed(filePath)) {
      *     return {
      *       type: ApprovalType.DIRECTORY_ACCESS,
@@ -66,7 +164,7 @@ export interface InternalTool {
      * }
      * ```
      */
-    getApprovalOverride?: (args: unknown) => Promise<ApprovalRequestDetails | null> | ApprovalRequestDetails | null;
+    getApprovalOverride?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ApprovalRequestDetails | null> | ApprovalRequestDetails | null;
     /**
      * Optional callback invoked when custom approval is granted.
      * Allows tools to handle approval responses (e.g., remember approved directories).
@@ -83,7 +181,7 @@ export interface InternalTool {
      * }
      * ```
      */
-    onApprovalGranted?: (response: ApprovalResponse) => void;
+    onApprovalGranted?(response: ApprovalResponse, context: ToolExecutionContext, approvalRequest: ApprovalRequestDetails): void;
 }
 /**
  * Standard tool set interface - used by AI/LLM services
@@ -94,6 +192,7 @@ export interface ToolSet {
         name?: string;
         description?: string;
         parameters: JSONSchema7;
+        _meta?: Record<string, unknown>;
     };
 }
 /**
@@ -101,7 +200,7 @@ export interface ToolSet {
  */
 export interface ToolResult {
     success: boolean;
-    data?: any;
+    data?: unknown;
     error?: string;
 }
 /**

package/dist/tools/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC5C;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,+CAA+C;IAC/C,WAAW,EAAE,SAAS,CAAC;IAEvB,8FAA8F;IAC9F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAExF;;;;OAIG;IACH,eAAe,CAAC,EAAE,CACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,oBAAoB,KAC7B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,mBAAmB,CAAC,EAAE,CAClB,IAAI,EAAE,OAAO,KACZ,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,GAAG,sBAAsB,GAAG,IAAI,CAAC;IAE5E;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,WAAW,CAAC;KAC3B,CAAC;CACL;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"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"}

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/error-conversion.d.ts

@@ -2,12 +2,12 @@
  * Utility functions for converting various error types to proper Error instances
  * with meaningful messages instead of "[object Object]"
  */
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Converts any error value to an Error instance with a meaningful message
  *
  * @param error - The error value to convert (can be Error, object, string, etc.)
  * @returns Error instance with extracted or serialized message
  */
-export declare function toError(error: unknown, logger: IDextoLogger): Error;
+export declare function toError(error: unknown, logger: Logger): Error;
 //# sourceMappingURL=error-conversion.d.ts.map

package/dist/utils/error-conversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-conversion.d.ts","sourceRoot":"","sources":["../../src/utils/error-conversion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,KAAK,CAkEnE"}
+{"version":3,"file":"error-conversion.d.ts","sourceRoot":"","sources":["../../src/utils/error-conversion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAkE7D"}

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/path.d.ts

@@ -1,4 +1,4 @@
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Standard path resolver for logs/db/config/anything in dexto projects
  * Context-aware with dev mode support:
@@ -50,5 +50,5 @@ export declare function ensureDextoGlobalDirectory(): Promise<void>;
  * @param logger Optional logger instance for logging
  * @returns Absolute path to .env file for saving
  */
-export declare function getDextoEnvPath(startPath?: string, logger?: IDextoLogger): string;
+export declare function getDextoEnvPath(startPath?: string, logger?: Logger): string;
 //# sourceMappingURL=path.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAKhF;AAMD;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAkChG"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAKhF;AAMD;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkC1F"}

package/dist/utils/result.cjs

@@ -31,7 +31,7 @@ __export(result_exports, {
 });
 module.exports = __toCommonJS(result_exports);
 var import_zod = require("zod");
-var import_types = require("../errors/types.cjs");
+var import_types = require("../errors/types.js");
 const NonEmptyTrimmed = import_zod.z.string().transform((s) => s.trim()).refine((s) => s.length > 0, { message: "Required" });
 function isValidUrl(s) {
   try {

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

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAkB,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnE,4CAA4C;AAC5C,eAAO,MAAM,eAAe,yEAG6B,CAAC;AAa1D,eAAO,MAAM,WAAW,kIAKT,CAAC;AAGhB,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,8CAUpE,CAAC;AAGP,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAG5E,CAAC;AAGP,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAWlE,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,SAAQ,KAAK,CAAC,CAAC,CAAC,EAAO,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAI/E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAG3E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAE9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE;;;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACnC,GAAG,EAAE,QAAQ,EACb,QAAQ,GAAE,OAAO,GAAG,SAAmB,GACxC,KAAK,CAAC,CAAC,CAAC,EAAE,CA8CZ"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAkB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhE,4CAA4C;AAC5C,eAAO,MAAM,eAAe,yEAG6B,CAAC;AAa1D,eAAO,MAAM,WAAW,kIAKT,CAAC;AAGhB,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,8CAUpE,CAAC;AAGP,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAG5E,CAAC;AAGP,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAWlE,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,SAAQ,KAAK,CAAC,CAAC,CAAC,EAAO,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAI/E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAG3E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAE9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE;;;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACnC,GAAG,EAAE,QAAQ,EACb,QAAQ,GAAE,OAAO,GAAG,SAAmB,GACxC,KAAK,CAAC,CAAC,CAAC,EAAE,CA8CZ"}

package/dist/utils/schema.cjs

@@ -24,16 +24,20 @@ module.exports = __toCommonJS(schema_exports);
 var import_zod_to_json_schema = require("zod-to-json-schema");
 function convertZodSchemaToJsonSchema(zodSchema, logger) {
   try {
-    return (0, import_zod_to_json_schema.zodToJsonSchema)(zodSchema);
+    const converted = (0, import_zod_to_json_schema.zodToJsonSchema)(zodSchema);
+    if (converted && typeof converted === "object") {
+      return converted;
+    }
+    logger.warn("Failed to convert Zod schema to JSON Schema: conversion returned non-object");
   } catch (error) {
     logger.warn(
       `Failed to convert Zod schema to JSON Schema: ${error instanceof Error ? error.message : String(error)}`
     );
-    return {
-      type: "object",
-      properties: {}
-    };
   }
+  return {
+    type: "object",
+    properties: {}
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/utils/schema.d.ts

@@ -1,4 +1,6 @@
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { JSONSchema7 } from 'json-schema';
+import type { ZodSchema } from 'zod';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Convert Zod schema to JSON Schema format for tool parameters
  *
@@ -8,5 +10,5 @@ import type { IDextoLogger } from '../logger/v2/types.js';
  * Zod v4 has native toJsonSchema() support - migrate when upgrading to Zod v4.
  * See: https://github.com/StefanTerdell/zod-to-json-schema
  */
-export declare function convertZodSchemaToJsonSchema(zodSchema: any, logger: IDextoLogger): any;
+export declare function convertZodSchemaToJsonSchema(zodSchema: ZodSchema, logger: Logger): JSONSchema7;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CActF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAoB9F"}

package/dist/utils/schema.js

@@ -2,16 +2,20 @@ import "../chunk-PTJYTZNU.js";
 import { zodToJsonSchema } from "zod-to-json-schema";
 function convertZodSchemaToJsonSchema(zodSchema, logger) {
   try {
-    return zodToJsonSchema(zodSchema);
+    const converted = zodToJsonSchema(zodSchema);
+    if (converted && typeof converted === "object") {
+      return converted;
+    }
+    logger.warn("Failed to convert Zod schema to JSON Schema: conversion returned non-object");
   } catch (error) {
     logger.warn(
       `Failed to convert Zod schema to JSON Schema: ${error instanceof Error ? error.message : String(error)}`
     );
-    return {
-      type: "object",
-      properties: {}
-    };
   }
+  return {
+    type: "object",
+    properties: {}
+  };
 }
 export {
   convertZodSchemaToJsonSchema