@dexto/core 1.1.10 → 1.2.0

package/dist/tools/confirmation/noop-confirmation-provider.cjs

@@ -1,49 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var noop_confirmation_provider_exports = {};
-__export(noop_confirmation_provider_exports, {
-  NoOpConfirmationProvider: () => NoOpConfirmationProvider
-});
-module.exports = __toCommonJS(noop_confirmation_provider_exports);
-var import_in_memory = require("./allowed-tools-provider/in-memory.js");
-var import_logger = require("../../logger/index.cjs");
-class NoOpConfirmationProvider {
-  allowedToolsProvider;
-  autoApprove;
-  constructor(allowedToolsProvider, autoApprove = true) {
-    this.allowedToolsProvider = allowedToolsProvider ?? new import_in_memory.InMemoryAllowedToolsProvider();
-    this.autoApprove = autoApprove;
-  }
-  async requestConfirmation(details) {
-    if (this.autoApprove) {
-      import_logger.logger.info(
-        `Tool confirmation auto-approved for ${details.toolName}, sessionId: ${details.sessionId ?? "global"} (auto-approve mode)`
-      );
-    } else {
-      import_logger.logger.info(
-        `Tool confirmation auto-denied for ${details.toolName}, sessionId: ${details.sessionId ?? "global"} (auto-deny mode)`
-      );
-    }
-    return this.autoApprove;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  NoOpConfirmationProvider
-});

package/dist/tools/confirmation/noop-confirmation-provider.d.cts

@@ -1,22 +0,0 @@
-import { ToolConfirmationProvider, ToolExecutionDetails } from './types.cjs';
-import { IAllowedToolsProvider } from './allowed-tools-provider/types.cjs';
-
-/**
- * NoOpConfirmationProvider
- *
- * A ToolConfirmationProvider implementation that always approves or denies tool execution.
- * Used as a fallback for environments where confirmation is not implemented or for
- * security scenarios where tools should be automatically denied.
- *
- * Uses InMemoryAllowedToolsProvider to satisfy the interface, but does not enforce any restrictions
- * when in auto-approve mode.
- */
-
-declare class NoOpConfirmationProvider implements ToolConfirmationProvider {
-    allowedToolsProvider: IAllowedToolsProvider;
-    private autoApprove;
-    constructor(allowedToolsProvider?: IAllowedToolsProvider, autoApprove?: boolean);
-    requestConfirmation(details: ToolExecutionDetails): Promise<boolean>;
-}
-
-export { NoOpConfirmationProvider };

package/dist/tools/confirmation/noop-confirmation-provider.d.ts

@@ -1,22 +0,0 @@
-import { ToolConfirmationProvider, ToolExecutionDetails } from './types.js';
-import { IAllowedToolsProvider } from './allowed-tools-provider/types.js';
-
-/**
- * NoOpConfirmationProvider
- *
- * A ToolConfirmationProvider implementation that always approves or denies tool execution.
- * Used as a fallback for environments where confirmation is not implemented or for
- * security scenarios where tools should be automatically denied.
- *
- * Uses InMemoryAllowedToolsProvider to satisfy the interface, but does not enforce any restrictions
- * when in auto-approve mode.
- */
-
-declare class NoOpConfirmationProvider implements ToolConfirmationProvider {
-    allowedToolsProvider: IAllowedToolsProvider;
-    private autoApprove;
-    constructor(allowedToolsProvider?: IAllowedToolsProvider, autoApprove?: boolean);
-    requestConfirmation(details: ToolExecutionDetails): Promise<boolean>;
-}
-
-export { NoOpConfirmationProvider };

package/dist/tools/confirmation/noop-confirmation-provider.js

@@ -1,25 +0,0 @@
-import { InMemoryAllowedToolsProvider } from "./allowed-tools-provider/in-memory.js";
-import { logger } from "../../logger/index.js";
-class NoOpConfirmationProvider {
-  allowedToolsProvider;
-  autoApprove;
-  constructor(allowedToolsProvider, autoApprove = true) {
-    this.allowedToolsProvider = allowedToolsProvider ?? new InMemoryAllowedToolsProvider();
-    this.autoApprove = autoApprove;
-  }
-  async requestConfirmation(details) {
-    if (this.autoApprove) {
-      logger.info(
-        `Tool confirmation auto-approved for ${details.toolName}, sessionId: ${details.sessionId ?? "global"} (auto-approve mode)`
-      );
-    } else {
-      logger.info(
-        `Tool confirmation auto-denied for ${details.toolName}, sessionId: ${details.sessionId ?? "global"} (auto-deny mode)`
-      );
-    }
-    return this.autoApprove;
-  }
-}
-export {
-  NoOpConfirmationProvider
-};

package/dist/tools/confirmation/types.d.cts

@@ -1,46 +0,0 @@
-import { IAllowedToolsProvider } from './allowed-tools-provider/types.cjs';
-
-/**
- * Event emitted when tool confirmation is requested
- */
-interface ToolConfirmationEvent {
-    toolName: string;
-    args: Record<string, unknown>;
-    description?: string | undefined;
-    executionId: string;
-    timestamp: Date;
-    sessionId?: string;
-}
-/**
- * Response to tool confirmation request
- */
-interface ToolConfirmationResponse {
-    executionId: string;
-    approved: boolean;
-    rememberChoice?: boolean;
-    /**
-     * Optional session identifier to scope the approval. When provided, a
-     * "remembered" approval is stored only for this session by the
-     * AllowedToolsProvider implementation.
-     */
-    sessionId?: string;
-}
-/**
- * Interface for current tool being executed
- */
-interface ToolExecutionDetails {
-    toolName: string;
-    args: Record<string, unknown>;
-    description?: string;
-    sessionId?: string;
-}
-/**
- * Interface to get tool confirmation and manage allowed tools
- */
-interface ToolConfirmationProvider {
-    allowedToolsProvider: IAllowedToolsProvider;
-    requestConfirmation(details: ToolExecutionDetails): Promise<boolean>;
-    handleConfirmationResponse?(response: ToolConfirmationResponse): Promise<void>;
-}
-
-export type { ToolConfirmationEvent, ToolConfirmationProvider, ToolConfirmationResponse, ToolExecutionDetails };

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

@@ -1,46 +0,0 @@
-import { IAllowedToolsProvider } from './allowed-tools-provider/types.js';
-
-/**
- * Event emitted when tool confirmation is requested
- */
-interface ToolConfirmationEvent {
-    toolName: string;
-    args: Record<string, unknown>;
-    description?: string | undefined;
-    executionId: string;
-    timestamp: Date;
-    sessionId?: string;
-}
-/**
- * Response to tool confirmation request
- */
-interface ToolConfirmationResponse {
-    executionId: string;
-    approved: boolean;
-    rememberChoice?: boolean;
-    /**
-     * Optional session identifier to scope the approval. When provided, a
-     * "remembered" approval is stored only for this session by the
-     * AllowedToolsProvider implementation.
-     */
-    sessionId?: string;
-}
-/**
- * Interface for current tool being executed
- */
-interface ToolExecutionDetails {
-    toolName: string;
-    args: Record<string, unknown>;
-    description?: string;
-    sessionId?: string;
-}
-/**
- * Interface to get tool confirmation and manage allowed tools
- */
-interface ToolConfirmationProvider {
-    allowedToolsProvider: IAllowedToolsProvider;
-    requestConfirmation(details: ToolExecutionDetails): Promise<boolean>;
-    handleConfirmationResponse?(response: ToolConfirmationResponse): Promise<void>;
-}
-
-export type { ToolConfirmationEvent, ToolConfirmationProvider, ToolConfirmationResponse, ToolExecutionDetails };

package/dist/tools/error-codes.d.cts

@@ -1,18 +0,0 @@
-/**
- * Tools-specific error codes
- * Includes tool execution, confirmation, and authorization errors
- */
-declare enum ToolErrorCode {
-    EXECUTION_DENIED = "tools_execution_denied",
-    EXECUTION_TIMEOUT = "tools_execution_timeout",
-    EXECUTION_FAILED = "tools_execution_failed",
-    CONFIRMATION_HANDLER_MISSING = "tools_confirmation_handler_missing",
-    CONFIRMATION_TIMEOUT = "tools_confirmation_timeout",
-    CONFIRMATION_CANCELLED = "tools_confirmation_cancelled",
-    TOOL_NOT_FOUND = "tools_tool_not_found",
-    TOOL_INVALID_ARGS = "tools_invalid_args",
-    TOOL_UNAUTHORIZED = "tools_unauthorized",
-    CONFIG_INVALID = "tools_config_invalid"
-}
-
-export { ToolErrorCode };

package/dist/tools/errors.d.cts

@@ -1,97 +0,0 @@
-import { DextoRuntimeError } from '../errors/DextoRuntimeError.cjs';
-import '../errors/DextoBaseError.cjs';
-import '../errors/types.cjs';
-import '../agent/error-codes.cjs';
-import '../config/error-codes.cjs';
-import '../context/error-codes.cjs';
-import '../llm/error-codes.cjs';
-import '../mcp/error-codes.cjs';
-import '../session/error-codes.cjs';
-import '../storage/error-codes.cjs';
-import '../systemPrompt/error-codes.cjs';
-import './error-codes.cjs';
-import '../preferences/error-codes.cjs';
-import '../agent/registry/error-codes.cjs';
-
-/**
- * Tool error factory with typed methods for creating tool-specific errors
- * Each method creates a properly typed DextoError with TOOLS scope
- */
-declare class ToolError {
-    /**
-     * Tool not found error
-     */
-    static notFound(toolName: string): DextoRuntimeError<{
-        toolName: string;
-    }>;
-    /**
-     * Tool execution failed
-     */
-    static executionFailed(toolName: string, reason: string, sessionId?: string): DextoRuntimeError<{
-        toolName: string;
-        reason: string;
-        sessionId: string | undefined;
-    }>;
-    /**
-     * Tool execution denied by user/policy
-     */
-    static executionDenied(toolName: string, sessionId?: string): DextoRuntimeError<{
-        toolName: string;
-        sessionId: string | undefined;
-    }>;
-    /**
-     * Tool execution timeout
-     */
-    static executionTimeout(toolName: string, timeoutMs: number, sessionId?: string): DextoRuntimeError<{
-        toolName: string;
-        timeoutMs: number;
-        sessionId: string | undefined;
-    }>;
-    /**
-     * Tool unauthorized access
-     */
-    static unauthorized(toolName: string, sessionId?: string): DextoRuntimeError<{
-        toolName: string;
-        sessionId: string | undefined;
-    }>;
-    /**
-     * Confirmation handler missing
-     */
-    static confirmationHandlerMissing(toolName: string): DextoRuntimeError<{
-        toolName: string;
-    }>;
-    /**
-     * Confirmation timeout
-     */
-    static confirmationTimeout(toolName: string, timeoutMs: number, sessionId?: string): DextoRuntimeError<{
-        toolName: string;
-        timeoutMs: number;
-        sessionId: string | undefined;
-    }>;
-    /**
-     * Invalid tool name (semantic validation - empty name after prefix, malformed, etc.)
-     */
-    static invalidName(toolName: string, reason: string): DextoRuntimeError<{
-        toolName: string;
-        reason: string;
-    }>;
-    /**
-     * Internal tools provider not initialized
-     */
-    static internalToolsNotInitialized(toolName: string): DextoRuntimeError<{
-        toolName: string;
-    }>;
-    /**
-     * Invalid tool configuration
-     */
-    static configInvalid(message: string): DextoRuntimeError<{}>;
-    /**
-     * Confirmation cancelled
-     */
-    static confirmationCancelled(toolName: string, reason: string): DextoRuntimeError<{
-        toolName: string;
-        reason: string;
-    }>;
-}
-
-export { ToolError };

package/dist/tools/index.d.cts

@@ -1,19 +0,0 @@
-export { InternalTool, ToolCall, ToolExecutionContext, ToolProvider, ToolResult, ToolSet } from './types.cjs';
-export { ToolConfirmationEvent, ToolConfirmationProvider, ToolConfirmationResponse, ToolExecutionDetails } from './confirmation/types.cjs';
-export { InternalToolsProvider } from './internal-tools/provider.cjs';
-export { INTERNAL_TOOL_NAMES, INTERNAL_TOOL_REGISTRY, InternalToolsServices, KnownInternalTool, getInternalToolInfo } from './internal-tools/registry.cjs';
-export { InternalToolsConfig, InternalToolsSchema, ToolConfirmationConfig, ToolConfirmationConfigSchema, ValidatedToolConfirmationConfig } from './schemas.cjs';
-export { InternalToolsOptions, ToolManager } from './tool-manager.cjs';
-import 'json-schema';
-import 'zod';
-import './confirmation/allowed-tools-provider/types.cjs';
-import '../search/search-service.cjs';
-import '../storage/backend/database-backend.cjs';
-import '../search/types.cjs';
-import '../context/types.cjs';
-import '../llm/types.cjs';
-import '../mcp/manager.cjs';
-import '../mcp/schemas.cjs';
-import '../mcp/types.cjs';
-import '@modelcontextprotocol/sdk/client/index.js';
-import '@modelcontextprotocol/sdk/types.js';

package/dist/tools/internal-tools/implementations/search-history-tool.d.cts

@@ -1,15 +0,0 @@
-import { InternalTool } from '../../types.cjs';
-import { SearchService } from '../../../search/search-service.cjs';
-import 'json-schema';
-import 'zod';
-import '../../../storage/backend/database-backend.cjs';
-import '../../../search/types.cjs';
-import '../../../context/types.cjs';
-import '../../../llm/types.cjs';
-
-/**
- * Internal tool for searching conversation history
- */
-declare function createSearchHistoryTool(searchService: SearchService): InternalTool;
-
-export { createSearchHistoryTool };

package/dist/tools/internal-tools/index.d.cts

@@ -1,13 +0,0 @@
-export { InternalToolsProvider } from './provider.cjs';
-export { INTERNAL_TOOL_NAMES, INTERNAL_TOOL_REGISTRY, InternalToolsServices, KnownInternalTool, getInternalToolInfo } from './registry.cjs';
-import '../types.cjs';
-import 'json-schema';
-import 'zod';
-import '../confirmation/types.cjs';
-import '../confirmation/allowed-tools-provider/types.cjs';
-import '../schemas.cjs';
-import '../../search/search-service.cjs';
-import '../../storage/backend/database-backend.cjs';
-import '../../search/types.cjs';
-import '../../context/types.cjs';
-import '../../llm/types.cjs';

package/dist/tools/internal-tools/provider.d.cts

@@ -1,66 +0,0 @@
-import { ToolSet } from '../types.cjs';
-import { ToolConfirmationProvider } from '../confirmation/types.cjs';
-import { InternalToolsServices } from './registry.cjs';
-import { InternalToolsConfig } from '../schemas.cjs';
-import 'json-schema';
-import 'zod';
-import '../confirmation/allowed-tools-provider/types.cjs';
-import '../../search/search-service.cjs';
-import '../../storage/backend/database-backend.cjs';
-import '../../search/types.cjs';
-import '../../context/types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Provider for built-in internal tools that are part of the core system
- *
- * This provider manages internal tools that are shipped with the core system
- * and need access to core services like SearchService, SessionManager, etc.
- *
- * Benefits:
- * - Clean separation: ToolManager doesn't need to know about specific services
- * - Easy to extend: Just add new tools and services as needed
- * - Lightweight: Direct tool management without complex infrastructure
- * - No unnecessary ProcessedInternalTool wrapper - uses InternalTool directly
- */
-declare class InternalToolsProvider {
-    private services;
-    private tools;
-    private confirmationProvider;
-    private config;
-    constructor(services: InternalToolsServices, confirmationProvider: ToolConfirmationProvider, config?: InternalToolsConfig);
-    /**
-     * Initialize the internal tools provider by registering all available internal tools
-     */
-    initialize(): Promise<void>;
-    /**
-     * Register all available internal tools based on available services and configuration
-     */
-    private registerInternalTools;
-    /**
-     * Check if a specific tool is enabled by configuration
-     */
-    private isToolEnabled;
-    /**
-     * Check if a tool exists
-     */
-    hasTool(toolName: string): boolean;
-    /**
-     * Execute an internal tool - confirmation is handled by ToolManager
-     */
-    executeTool(toolName: string, args: Record<string, unknown>, sessionId?: string): Promise<unknown>;
-    /**
-     * Get all tools in ToolSet format with on-demand JSON Schema conversion
-     */
-    getAllTools(): ToolSet;
-    /**
-     * Get tool names
-     */
-    getToolNames(): string[];
-    /**
-     * Get tool count
-     */
-    getToolCount(): number;
-}
-
-export { InternalToolsProvider };

package/dist/tools/internal-tools/registry.d.cts

@@ -1,45 +0,0 @@
-import { InternalTool } from '../types.cjs';
-import { SearchService } from '../../search/search-service.cjs';
-import 'json-schema';
-import 'zod';
-import '../../storage/backend/database-backend.cjs';
-import '../../search/types.cjs';
-import '../../context/types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Services available to internal tools
- * Add new services here as needed for internal tools
- */
-interface InternalToolsServices {
-    searchService?: SearchService;
-}
-/**
- * Internal tool factory function type
- */
-type InternalToolFactory = (services: InternalToolsServices) => InternalTool;
-/**
- * Internal tool names - Manual array preserves literal types for z.enum()
- * Add new tool names here first, then implement in registry below
- */
-declare const INTERNAL_TOOL_NAMES: readonly ["search_history"];
-/**
- * Derive type from names array - preserves literal union
- */
-type KnownInternalTool = (typeof INTERNAL_TOOL_NAMES)[number];
-/**
- * Internal tool registry - Must match names array exactly (TypeScript enforces this)
- */
-declare const INTERNAL_TOOL_REGISTRY: Record<KnownInternalTool, {
-    factory: InternalToolFactory;
-    requiredServices: readonly (keyof InternalToolsServices)[];
-}>;
-/**
- * Type-safe registry access
- */
-declare function getInternalToolInfo(toolName: KnownInternalTool): {
-    factory: InternalToolFactory;
-    requiredServices: readonly (keyof InternalToolsServices)[];
-};
-
-export { INTERNAL_TOOL_NAMES, INTERNAL_TOOL_REGISTRY, type InternalToolsServices, type KnownInternalTool, getInternalToolInfo };

package/dist/tools/schemas.d.cts

@@ -1,21 +0,0 @@
-import { z } from 'zod';
-
-declare const InternalToolsSchema: z.ZodDefault<z.ZodArray<z.ZodEnum<["search_history"]>, "many">>;
-type InternalToolsConfig = z.output<typeof InternalToolsSchema>;
-declare const ToolConfirmationConfigSchema: z.ZodObject<{
-    mode: z.ZodDefault<z.ZodEnum<["event-based", "auto-approve", "auto-deny"]>>;
-    timeout: z.ZodDefault<z.ZodNumber>;
-    allowedToolsStorage: z.ZodDefault<z.ZodEnum<["memory", "storage"]>>;
-}, "strict", z.ZodTypeAny, {
-    timeout: number;
-    mode: "event-based" | "auto-approve" | "auto-deny";
-    allowedToolsStorage: "storage" | "memory";
-}, {
-    timeout?: number | undefined;
-    mode?: "event-based" | "auto-approve" | "auto-deny" | undefined;
-    allowedToolsStorage?: "storage" | "memory" | undefined;
-}>;
-type ToolConfirmationConfig = z.input<typeof ToolConfirmationConfigSchema>;
-type ValidatedToolConfirmationConfig = z.output<typeof ToolConfirmationConfigSchema>;
-
-export { type InternalToolsConfig, InternalToolsSchema, type ToolConfirmationConfig, ToolConfirmationConfigSchema, type ValidatedToolConfirmationConfig };

package/dist/tools/tool-manager.d.cts

@@ -1,106 +0,0 @@
-import { MCPManager } from '../mcp/manager.cjs';
-import { InternalToolsServices } from './internal-tools/registry.cjs';
-import { InternalToolsConfig } from './schemas.cjs';
-import { ToolSet } from './types.cjs';
-import { ToolConfirmationProvider } from './confirmation/types.cjs';
-import '../mcp/schemas.cjs';
-import 'zod';
-import '../mcp/types.cjs';
-import '@modelcontextprotocol/sdk/client/index.js';
-import '@modelcontextprotocol/sdk/types.js';
-import '../search/search-service.cjs';
-import '../storage/backend/database-backend.cjs';
-import '../search/types.cjs';
-import '../context/types.cjs';
-import '../llm/types.cjs';
-import 'json-schema';
-import './confirmation/allowed-tools-provider/types.cjs';
-
-/**
- * Options for internal tools configuration in ToolManager
- */
-interface InternalToolsOptions {
-    internalToolsServices?: InternalToolsServices;
-    internalToolsConfig?: InternalToolsConfig;
-}
-/**
- * Unified Tool Manager - Single interface for all tool operations
- *
- * This class acts as the single point of contact between the LLM and all tool sources.
- * It aggregates tools from MCP servers and internal tools, providing a unified interface
- * for tool discovery, aggregation, and execution.
- *
- * Responsibilities:
- * - Aggregate tools from MCP servers and internal tools with conflict resolution
- * - Route tool execution to appropriate source (MCP vs Internal)
- * - Provide unified tool interface to LLM
- * - Manage tool confirmation and security
- * - Handle cross-source naming conflicts (internal tools have precedence)
- *
- * Architecture:
- * LLMService → ToolManager → [MCPManager, InternalToolsProvider]
- */
-declare class ToolManager {
-    private mcpManager;
-    private internalToolsProvider?;
-    private confirmationProvider;
-    private static readonly MCP_TOOL_PREFIX;
-    private static readonly INTERNAL_TOOL_PREFIX;
-    private toolsCache;
-    private cacheValid;
-    constructor(mcpManager: MCPManager, confirmationProvider: ToolConfirmationProvider, options?: InternalToolsOptions);
-    /**
-     * Initialize the ToolManager and its components
-     */
-    initialize(): Promise<void>;
-    /**
-     * Invalidate the tools cache when tool sources change
-     */
-    private invalidateCache;
-    getMcpManager(): MCPManager;
-    /**
-     * Get all MCP tools (delegates to mcpManager.getAllTools())
-     * This provides access to MCP tools while maintaining separation of concerns
-     */
-    getMcpTools(): Promise<ToolSet>;
-    /**
-     * Build all tools from sources with universal prefixing
-     * ALL tools get prefixed by their source - no exceptions
-     */
-    private buildAllTools;
-    /**
-     * Get all available tools from all sources with conflict resolution
-     * This is the single interface the LLM uses to discover tools
-     * Uses caching to avoid rebuilding on every call
-     */
-    getAllTools(): Promise<ToolSet>;
-    /**
-     * Execute a tool by routing based on universal prefix
-     * ALL tools must have source prefix - no exceptions
-     */
-    executeTool(toolName: string, args: Record<string, unknown>, sessionId?: string): Promise<unknown>;
-    /**
-     * Check if a tool exists (must have proper source prefix)
-     */
-    hasTool(toolName: string): Promise<boolean>;
-    /**
-     * Get tool statistics across all sources
-     */
-    getToolStats(): Promise<{
-        total: number;
-        mcp: number;
-        internal: number;
-    }>;
-    /**
-     * Get the source of a tool (mcp, internal, or unknown)
-     * @param toolName The name of the tool to check
-     * @returns The source of the tool
-     */
-    getToolSource(toolName: string): 'mcp' | 'internal' | 'unknown';
-    /**
-     * Refresh tool discovery (call when MCP servers change)
-     */
-    refresh(): Promise<void>;
-}
-
-export { type InternalToolsOptions, ToolManager };