@dexto/core 1.1.4 → 1.1.6

package/dist/llm/services/test-utils.integration.cjs

@@ -0,0 +1,169 @@
+"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 test_utils_integration_exports = {};
+__export(test_utils_integration_exports, {
+  TestConfigs: () => TestConfigs,
+  cleanupTestEnvironment: () => cleanupTestEnvironment,
+  createTestEnvironment: () => createTestEnvironment,
+  requiresApiKey: () => requiresApiKey
+});
+module.exports = __toCommonJS(test_utils_integration_exports);
+var import_DextoAgent = require("../../agent/DextoAgent.js");
+var import_api_key_resolver = require("../../utils/api-key-resolver.js");
+async function createTestEnvironment(config, sessionId = "test-session") {
+  const agent = new import_DextoAgent.DextoAgent(config);
+  await agent.start();
+  return {
+    agent,
+    sessionId,
+    cleanup: async () => {
+      if (agent.isStarted()) {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        await agent.stop();
+      }
+    }
+  };
+}
+const TestConfigs = {
+  /**
+   * Creates OpenAI test config
+   */
+  createOpenAIConfig() {
+    const provider = "openai";
+    const apiKey = (0, import_api_key_resolver.resolveApiKeyForProvider)(provider);
+    if (!apiKey) {
+      throw new Error(
+        `${(0, import_api_key_resolver.getPrimaryApiKeyEnvVar)(provider)} environment variable is required for OpenAI integration tests`
+      );
+    }
+    return {
+      systemPrompt: "You are a helpful assistant for testing purposes.",
+      llm: {
+        provider,
+        model: "gpt-5-nano",
+        // Use cheapest model for testing
+        apiKey,
+        maxOutputTokens: 100,
+        // Keep costs low
+        temperature: 0,
+        // Deterministic responses
+        maxIterations: 1
+        // Minimal tool iterations
+      },
+      mcpServers: {},
+      storage: {
+        cache: { type: "in-memory" },
+        database: { type: "in-memory" }
+      },
+      sessions: {
+        maxSessions: 10,
+        sessionTTL: 100
+        // 100ms for fast testing
+      }
+    };
+  },
+  /**
+   * Creates Anthropic test config
+   */
+  createAnthropicConfig() {
+    const provider = "anthropic";
+    const apiKey = (0, import_api_key_resolver.resolveApiKeyForProvider)(provider);
+    if (!apiKey) {
+      throw new Error(
+        `${(0, import_api_key_resolver.getPrimaryApiKeyEnvVar)(provider)} environment variable is required for Anthropic integration tests`
+      );
+    }
+    return {
+      systemPrompt: "You are a helpful assistant for testing purposes.",
+      llm: {
+        provider,
+        model: "claude-3-5-haiku-20241022",
+        // Use cheapest model for testing
+        apiKey,
+        maxOutputTokens: 100,
+        temperature: 0,
+        maxIterations: 1
+      },
+      mcpServers: {},
+      storage: {
+        cache: { type: "in-memory" },
+        database: { type: "in-memory" }
+      },
+      sessions: {
+        maxSessions: 10,
+        sessionTTL: 100
+      }
+    };
+  },
+  /**
+   * Creates Vercel test config - parametric for different providers/models
+   */
+  createVercelConfig(provider = "openai", model) {
+    const apiKey = (0, import_api_key_resolver.resolveApiKeyForProvider)(provider);
+    if (!apiKey) {
+      throw new Error(
+        `${(0, import_api_key_resolver.getPrimaryApiKeyEnvVar)(provider)} environment variable is required for Vercel integration tests with ${provider}`
+      );
+    }
+    const defaultModels = {
+      openai: "gpt-5-nano",
+      anthropic: "claude-3-5-haiku-20241022",
+      google: "gemini-2.0-flash",
+      groq: "llama-3.1-8b-instant",
+      xai: "grok-beta",
+      cohere: "command-r",
+      "openai-compatible": "gpt-4o-mini"
+    };
+    return {
+      systemPrompt: "You are a helpful assistant for testing purposes.",
+      llm: {
+        router: "vercel",
+        // This is the key difference - uses Vercel router
+        provider,
+        model: model || defaultModels[provider],
+        apiKey,
+        maxOutputTokens: 100,
+        temperature: 0,
+        maxIterations: 1
+      },
+      mcpServers: {},
+      storage: {
+        cache: { type: "in-memory" },
+        database: { type: "in-memory" }
+      },
+      sessions: {
+        maxSessions: 10,
+        sessionTTL: 100
+      }
+    };
+  }
+};
+function requiresApiKey(provider) {
+  return !!(0, import_api_key_resolver.resolveApiKeyForProvider)(provider);
+}
+async function cleanupTestEnvironment(_env) {
+  await _env.cleanup();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TestConfigs,
+  cleanupTestEnvironment,
+  createTestEnvironment,
+  requiresApiKey
+});

package/dist/llm/services/test-utils.integration.d.cts

@@ -0,0 +1,83 @@
+import { DextoAgent } from '../../agent/DextoAgent.cjs';
+import { LLMProvider } from '../types.cjs';
+import { AgentConfig } from '../../agent/schemas.cjs';
+import '../../events/index.cjs';
+import 'events';
+import 'zod';
+import '../registry.cjs';
+import '../schemas.cjs';
+import '../../context/types.cjs';
+import '../../tools/types.cjs';
+import 'json-schema';
+import '../../mcp/manager.cjs';
+import '../../mcp/schemas.cjs';
+import '../../mcp/types.cjs';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/types.js';
+import '../../systemPrompt/manager.cjs';
+import '../../systemPrompt/schemas.cjs';
+import '../../systemPrompt/types.cjs';
+import '../../search/types.cjs';
+import '../../session/chat-session.cjs';
+import '../../context/manager.cjs';
+import '../formatters/types.cjs';
+import '../tokenizer/types.cjs';
+import '../../context/compression/types.cjs';
+import '../../session/history/types.cjs';
+import './types.cjs';
+import 'ai';
+import '../../tools/tool-manager.cjs';
+import '../../tools/internal-tools/registry.cjs';
+import '../../search/search-service.cjs';
+import '../../storage/backend/database-backend.cjs';
+import '../../tools/schemas.cjs';
+import '../../tools/confirmation/types.cjs';
+import '../../tools/confirmation/allowed-tools-provider/types.cjs';
+import '../../agent/state-manager.cjs';
+import '../../storage/backend/types.cjs';
+import '../../storage/backend/cache-backend.cjs';
+import '../../storage/schemas.cjs';
+import '../../session/session-manager.cjs';
+import '../../utils/service-initializer.cjs';
+import '../../storage/storage-manager.cjs';
+
+/**
+ * Shared utilities for LLM service integration tests
+ */
+interface TestEnvironment {
+    agent: DextoAgent;
+    sessionId: string;
+    cleanup: () => Promise<void>;
+}
+/**
+ * Creates a test environment with real dependencies (no mocks)
+ * Uses DextoAgent to handle complex initialization properly
+ */
+declare function createTestEnvironment(config: AgentConfig, sessionId?: string): Promise<TestEnvironment>;
+/**
+ * Test configuration helpers that create full AgentConfig objects
+ */
+declare const TestConfigs: {
+    /**
+     * Creates OpenAI test config
+     */
+    readonly createOpenAIConfig: () => AgentConfig;
+    /**
+     * Creates Anthropic test config
+     */
+    readonly createAnthropicConfig: () => AgentConfig;
+    /**
+     * Creates Vercel test config - parametric for different providers/models
+     */
+    readonly createVercelConfig: (provider?: LLMProvider, model?: string) => AgentConfig;
+};
+/**
+ * Helper to skip tests if API keys are not available
+ */
+declare function requiresApiKey(provider: LLMProvider): boolean;
+/**
+ * Cleanup helper
+ */
+declare function cleanupTestEnvironment(_env: TestEnvironment): Promise<void>;
+
+export { TestConfigs, type TestEnvironment, cleanupTestEnvironment, createTestEnvironment, requiresApiKey };

package/dist/llm/services/test-utils.integration.d.ts

@@ -0,0 +1,83 @@
+import { DextoAgent } from '../../agent/DextoAgent.js';
+import { LLMProvider } from '../types.js';
+import { AgentConfig } from '../../agent/schemas.js';
+import '../../events/index.js';
+import 'events';
+import 'zod';
+import '../registry.js';
+import '../schemas.js';
+import '../../context/types.js';
+import '../../tools/types.js';
+import 'json-schema';
+import '../../mcp/manager.js';
+import '../../mcp/schemas.js';
+import '../../mcp/types.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/types.js';
+import '../../systemPrompt/manager.js';
+import '../../systemPrompt/schemas.js';
+import '../../systemPrompt/types.js';
+import '../../search/types.js';
+import '../../session/chat-session.js';
+import '../../context/manager.js';
+import '../formatters/types.js';
+import '../tokenizer/types.js';
+import '../../context/compression/types.js';
+import '../../session/history/types.js';
+import './types.js';
+import 'ai';
+import '../../tools/tool-manager.js';
+import '../../tools/internal-tools/registry.js';
+import '../../search/search-service.js';
+import '../../storage/backend/database-backend.js';
+import '../../tools/schemas.js';
+import '../../tools/confirmation/types.js';
+import '../../tools/confirmation/allowed-tools-provider/types.js';
+import '../../agent/state-manager.js';
+import '../../storage/backend/types.js';
+import '../../storage/backend/cache-backend.js';
+import '../../storage/schemas.js';
+import '../../session/session-manager.js';
+import '../../utils/service-initializer.js';
+import '../../storage/storage-manager.js';
+
+/**
+ * Shared utilities for LLM service integration tests
+ */
+interface TestEnvironment {
+    agent: DextoAgent;
+    sessionId: string;
+    cleanup: () => Promise<void>;
+}
+/**
+ * Creates a test environment with real dependencies (no mocks)
+ * Uses DextoAgent to handle complex initialization properly
+ */
+declare function createTestEnvironment(config: AgentConfig, sessionId?: string): Promise<TestEnvironment>;
+/**
+ * Test configuration helpers that create full AgentConfig objects
+ */
+declare const TestConfigs: {
+    /**
+     * Creates OpenAI test config
+     */
+    readonly createOpenAIConfig: () => AgentConfig;
+    /**
+     * Creates Anthropic test config
+     */
+    readonly createAnthropicConfig: () => AgentConfig;
+    /**
+     * Creates Vercel test config - parametric for different providers/models
+     */
+    readonly createVercelConfig: (provider?: LLMProvider, model?: string) => AgentConfig;
+};
+/**
+ * Helper to skip tests if API keys are not available
+ */
+declare function requiresApiKey(provider: LLMProvider): boolean;
+/**
+ * Cleanup helper
+ */
+declare function cleanupTestEnvironment(_env: TestEnvironment): Promise<void>;
+
+export { TestConfigs, type TestEnvironment, cleanupTestEnvironment, createTestEnvironment, requiresApiKey };

package/dist/llm/services/test-utils.integration.js

@@ -0,0 +1,142 @@
+import { DextoAgent } from "../../agent/DextoAgent.js";
+import { resolveApiKeyForProvider, getPrimaryApiKeyEnvVar } from "../../utils/api-key-resolver.js";
+async function createTestEnvironment(config, sessionId = "test-session") {
+  const agent = new DextoAgent(config);
+  await agent.start();
+  return {
+    agent,
+    sessionId,
+    cleanup: async () => {
+      if (agent.isStarted()) {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        await agent.stop();
+      }
+    }
+  };
+}
+const TestConfigs = {
+  /**
+   * Creates OpenAI test config
+   */
+  createOpenAIConfig() {
+    const provider = "openai";
+    const apiKey = resolveApiKeyForProvider(provider);
+    if (!apiKey) {
+      throw new Error(
+        `${getPrimaryApiKeyEnvVar(provider)} environment variable is required for OpenAI integration tests`
+      );
+    }
+    return {
+      systemPrompt: "You are a helpful assistant for testing purposes.",
+      llm: {
+        provider,
+        model: "gpt-5-nano",
+        // Use cheapest model for testing
+        apiKey,
+        maxOutputTokens: 100,
+        // Keep costs low
+        temperature: 0,
+        // Deterministic responses
+        maxIterations: 1
+        // Minimal tool iterations
+      },
+      mcpServers: {},
+      storage: {
+        cache: { type: "in-memory" },
+        database: { type: "in-memory" }
+      },
+      sessions: {
+        maxSessions: 10,
+        sessionTTL: 100
+        // 100ms for fast testing
+      }
+    };
+  },
+  /**
+   * Creates Anthropic test config
+   */
+  createAnthropicConfig() {
+    const provider = "anthropic";
+    const apiKey = resolveApiKeyForProvider(provider);
+    if (!apiKey) {
+      throw new Error(
+        `${getPrimaryApiKeyEnvVar(provider)} environment variable is required for Anthropic integration tests`
+      );
+    }
+    return {
+      systemPrompt: "You are a helpful assistant for testing purposes.",
+      llm: {
+        provider,
+        model: "claude-3-5-haiku-20241022",
+        // Use cheapest model for testing
+        apiKey,
+        maxOutputTokens: 100,
+        temperature: 0,
+        maxIterations: 1
+      },
+      mcpServers: {},
+      storage: {
+        cache: { type: "in-memory" },
+        database: { type: "in-memory" }
+      },
+      sessions: {
+        maxSessions: 10,
+        sessionTTL: 100
+      }
+    };
+  },
+  /**
+   * Creates Vercel test config - parametric for different providers/models
+   */
+  createVercelConfig(provider = "openai", model) {
+    const apiKey = resolveApiKeyForProvider(provider);
+    if (!apiKey) {
+      throw new Error(
+        `${getPrimaryApiKeyEnvVar(provider)} environment variable is required for Vercel integration tests with ${provider}`
+      );
+    }
+    const defaultModels = {
+      openai: "gpt-5-nano",
+      anthropic: "claude-3-5-haiku-20241022",
+      google: "gemini-2.0-flash",
+      groq: "llama-3.1-8b-instant",
+      xai: "grok-beta",
+      cohere: "command-r",
+      "openai-compatible": "gpt-4o-mini"
+    };
+    return {
+      systemPrompt: "You are a helpful assistant for testing purposes.",
+      llm: {
+        router: "vercel",
+        // This is the key difference - uses Vercel router
+        provider,
+        model: model || defaultModels[provider],
+        apiKey,
+        maxOutputTokens: 100,
+        temperature: 0,
+        maxIterations: 1
+      },
+      mcpServers: {},
+      storage: {
+        cache: { type: "in-memory" },
+        database: { type: "in-memory" }
+      },
+      sessions: {
+        maxSessions: 10,
+        sessionTTL: 100
+      }
+    };
+  }
+};
+function requiresApiKey(provider) {
+  return !!resolveApiKeyForProvider(provider);
+}
+async function cleanupTestEnvironment(_env) {
+  await _env.cleanup();
+}
+export {
+  TestConfigs,
+  cleanupTestEnvironment,
+  createTestEnvironment,
+  requiresApiKey
+};

package/dist/llm/services/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/llm/services/types.d.cts

@@ -0,0 +1,56 @@
+import { LanguageModel } from 'ai';
+import { ToolSet } from '../../tools/types.cjs';
+import { ImageData, FileData } from '../../context/types.cjs';
+import { LLMRouter, LLMProvider } from '../types.cjs';
+import { ContextManager } from '../../context/manager.cjs';
+import 'json-schema';
+import 'zod';
+import '../formatters/types.cjs';
+import '../tokenizer/types.cjs';
+import '../../context/compression/types.cjs';
+import '../../systemPrompt/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';
+import '../../systemPrompt/manager.cjs';
+import '../../systemPrompt/schemas.cjs';
+import '../../session/history/types.cjs';
+import '../schemas.cjs';
+
+/**
+ * Core interface for LLM service implementations
+ */
+interface ILLMService {
+    /**
+     * Process a user's task (e.g., text input, potentially with image or file data)
+     * and return the final AI response.
+     * Handles potential tool calls and conversation management internally.
+     *
+     * @param textInput The primary text input from the user.
+     * @param options Options object with signal for cancellation. Always passed from chat session.
+     * @param imageData Optional image data associated with the user input.
+     * @param fileData Optional file data associated with the user input.
+     * @param stream Optional flag to enable streaming response.
+     * @returns A promise that resolves with the final text response from the AI.
+     */
+    completeTask(textInput: string, options: {
+        signal?: AbortSignal;
+    }, imageData?: ImageData, fileData?: FileData, stream?: boolean): Promise<string>;
+    getAllTools(): Promise<ToolSet>;
+    getConfig(): LLMServiceConfig;
+    getContextManager(): ContextManager<unknown>;
+}
+/**
+ * Configuration object returned by LLMService.getConfig()
+ */
+type LLMServiceConfig = {
+    router: LLMRouter;
+    provider: LLMProvider;
+    model: LanguageModel;
+    configuredMaxInputTokens?: number | null;
+    modelMaxInputTokens?: number | null;
+};
+
+export type { ILLMService, LLMServiceConfig };

package/dist/llm/services/types.d.ts

@@ -0,0 +1,56 @@
+import { LanguageModel } from 'ai';
+import { ToolSet } from '../../tools/types.js';
+import { ImageData, FileData } from '../../context/types.js';
+import { LLMRouter, LLMProvider } from '../types.js';
+import { ContextManager } from '../../context/manager.js';
+import 'json-schema';
+import 'zod';
+import '../formatters/types.js';
+import '../tokenizer/types.js';
+import '../../context/compression/types.js';
+import '../../systemPrompt/types.js';
+import '../../mcp/manager.js';
+import '../../mcp/schemas.js';
+import '../../mcp/types.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/types.js';
+import '../../systemPrompt/manager.js';
+import '../../systemPrompt/schemas.js';
+import '../../session/history/types.js';
+import '../schemas.js';
+
+/**
+ * Core interface for LLM service implementations
+ */
+interface ILLMService {
+    /**
+     * Process a user's task (e.g., text input, potentially with image or file data)
+     * and return the final AI response.
+     * Handles potential tool calls and conversation management internally.
+     *
+     * @param textInput The primary text input from the user.
+     * @param options Options object with signal for cancellation. Always passed from chat session.
+     * @param imageData Optional image data associated with the user input.
+     * @param fileData Optional file data associated with the user input.
+     * @param stream Optional flag to enable streaming response.
+     * @returns A promise that resolves with the final text response from the AI.
+     */
+    completeTask(textInput: string, options: {
+        signal?: AbortSignal;
+    }, imageData?: ImageData, fileData?: FileData, stream?: boolean): Promise<string>;
+    getAllTools(): Promise<ToolSet>;
+    getConfig(): LLMServiceConfig;
+    getContextManager(): ContextManager<unknown>;
+}
+/**
+ * Configuration object returned by LLMService.getConfig()
+ */
+type LLMServiceConfig = {
+    router: LLMRouter;
+    provider: LLMProvider;
+    model: LanguageModel;
+    configuredMaxInputTokens?: number | null;
+    modelMaxInputTokens?: number | null;
+};
+
+export type { ILLMService, LLMServiceConfig };