@dexto/core 1.1.4 → 1.1.6

package/dist/session/history/database.cjs

@@ -0,0 +1,95 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var database_exports = {};
+__export(database_exports, {
+  DatabaseHistoryProvider: () => DatabaseHistoryProvider
+});
+module.exports = __toCommonJS(database_exports);
+var import_logger = require("../../logger/index.cjs");
+var import_errors = require("../errors.js");
+class DatabaseHistoryProvider {
+  constructor(sessionId, database) {
+    this.sessionId = sessionId;
+    this.database = database;
+  }
+  async getHistory() {
+    const key = this.getMessagesKey();
+    try {
+      const messages = await this.database.getRange(key, 0, 1e3);
+      import_logger.logger.debug(
+        `DatabaseHistoryProvider: Retrieved ${messages.length} messages for session ${this.sessionId}`
+      );
+      return messages;
+    } catch (error) {
+      import_logger.logger.error(
+        `DatabaseHistoryProvider: Error retrieving messages for session ${this.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return [];
+    }
+  }
+  async saveMessage(message) {
+    const key = this.getMessagesKey();
+    try {
+      await this.database.append(key, message);
+      let contentPreview = "[no content]";
+      if (message.content) {
+        if (typeof message.content === "string") {
+          contentPreview = message.content.length > 100 ? `${message.content.substring(0, 100)}...` : message.content;
+        } else if (Array.isArray(message.content)) {
+          contentPreview = `[${message.content.length} parts]`;
+        }
+      }
+      import_logger.logger.debug(`DatabaseHistoryProvider: Saved message for session ${this.sessionId}`, {
+        role: message.role,
+        content: contentPreview
+      });
+    } catch (error) {
+      import_logger.logger.error(
+        `DatabaseHistoryProvider: Error saving message for session ${this.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw import_errors.SessionError.storageFailed(
+        this.sessionId,
+        "save message",
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
+  async clearHistory() {
+    const key = this.getMessagesKey();
+    try {
+      await this.database.delete(key);
+      import_logger.logger.debug(`DatabaseHistoryProvider: Cleared history for session ${this.sessionId}`);
+    } catch (error) {
+      import_logger.logger.error(
+        `DatabaseHistoryProvider: Error clearing session ${this.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw import_errors.SessionError.resetFailed(
+        this.sessionId,
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
+  getMessagesKey() {
+    return `messages:${this.sessionId}`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DatabaseHistoryProvider
+});

package/dist/session/history/database.d.cts

@@ -0,0 +1,28 @@
+import { DatabaseBackend } from '../../storage/backend/database-backend.cjs';
+import { InternalMessage } from '../../context/types.cjs';
+import { IConversationHistoryProvider } from './types.cjs';
+import '../../llm/types.cjs';
+
+/**
+ * History provider that works directly with DatabaseBackend.
+ * Handles message-specific operations and key formatting internally.
+ *
+ * TODO: Add in-memory caching to reduce database queries.
+ * Cache should be invalidated on writes and persist across LLM switches.
+ * Consider caching strategy:
+ * - Load cache on first getHistory() call
+ * - Update cache optimistically on saveMessage()
+ * - Clear cache on clearHistory()
+ * This will significantly improve performance for sessions with many messages.
+ */
+declare class DatabaseHistoryProvider implements IConversationHistoryProvider {
+    private sessionId;
+    private database;
+    constructor(sessionId: string, database: DatabaseBackend);
+    getHistory(): Promise<InternalMessage[]>;
+    saveMessage(message: InternalMessage): Promise<void>;
+    clearHistory(): Promise<void>;
+    private getMessagesKey;
+}
+
+export { DatabaseHistoryProvider };

package/dist/session/history/database.d.ts

@@ -0,0 +1,28 @@
+import { DatabaseBackend } from '../../storage/backend/database-backend.js';
+import { InternalMessage } from '../../context/types.js';
+import { IConversationHistoryProvider } from './types.js';
+import '../../llm/types.js';
+
+/**
+ * History provider that works directly with DatabaseBackend.
+ * Handles message-specific operations and key formatting internally.
+ *
+ * TODO: Add in-memory caching to reduce database queries.
+ * Cache should be invalidated on writes and persist across LLM switches.
+ * Consider caching strategy:
+ * - Load cache on first getHistory() call
+ * - Update cache optimistically on saveMessage()
+ * - Clear cache on clearHistory()
+ * This will significantly improve performance for sessions with many messages.
+ */
+declare class DatabaseHistoryProvider implements IConversationHistoryProvider {
+    private sessionId;
+    private database;
+    constructor(sessionId: string, database: DatabaseBackend);
+    getHistory(): Promise<InternalMessage[]>;
+    saveMessage(message: InternalMessage): Promise<void>;
+    clearHistory(): Promise<void>;
+    private getMessagesKey;
+}
+
+export { DatabaseHistoryProvider };

package/dist/session/history/database.js

@@ -0,0 +1,71 @@
+import { logger } from "../../logger/index.js";
+import { SessionError } from "../errors.js";
+class DatabaseHistoryProvider {
+  constructor(sessionId, database) {
+    this.sessionId = sessionId;
+    this.database = database;
+  }
+  async getHistory() {
+    const key = this.getMessagesKey();
+    try {
+      const messages = await this.database.getRange(key, 0, 1e3);
+      logger.debug(
+        `DatabaseHistoryProvider: Retrieved ${messages.length} messages for session ${this.sessionId}`
+      );
+      return messages;
+    } catch (error) {
+      logger.error(
+        `DatabaseHistoryProvider: Error retrieving messages for session ${this.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return [];
+    }
+  }
+  async saveMessage(message) {
+    const key = this.getMessagesKey();
+    try {
+      await this.database.append(key, message);
+      let contentPreview = "[no content]";
+      if (message.content) {
+        if (typeof message.content === "string") {
+          contentPreview = message.content.length > 100 ? `${message.content.substring(0, 100)}...` : message.content;
+        } else if (Array.isArray(message.content)) {
+          contentPreview = `[${message.content.length} parts]`;
+        }
+      }
+      logger.debug(`DatabaseHistoryProvider: Saved message for session ${this.sessionId}`, {
+        role: message.role,
+        content: contentPreview
+      });
+    } catch (error) {
+      logger.error(
+        `DatabaseHistoryProvider: Error saving message for session ${this.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw SessionError.storageFailed(
+        this.sessionId,
+        "save message",
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
+  async clearHistory() {
+    const key = this.getMessagesKey();
+    try {
+      await this.database.delete(key);
+      logger.debug(`DatabaseHistoryProvider: Cleared history for session ${this.sessionId}`);
+    } catch (error) {
+      logger.error(
+        `DatabaseHistoryProvider: Error clearing session ${this.sessionId}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw SessionError.resetFailed(
+        this.sessionId,
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
+  getMessagesKey() {
+    return `messages:${this.sessionId}`;
+  }
+}
+export {
+  DatabaseHistoryProvider
+};

package/dist/session/history/factory.cjs

@@ -0,0 +1,31 @@
+"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 factory_exports = {};
+__export(factory_exports, {
+  createDatabaseHistoryProvider: () => createDatabaseHistoryProvider
+});
+module.exports = __toCommonJS(factory_exports);
+var import_database = require("./database.js");
+function createDatabaseHistoryProvider(database, sessionId) {
+  return new import_database.DatabaseHistoryProvider(sessionId, database);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDatabaseHistoryProvider
+});

package/dist/session/history/factory.d.cts

@@ -0,0 +1,11 @@
+import { IConversationHistoryProvider } from './types.cjs';
+import { DatabaseBackend } from '../../storage/backend/database-backend.cjs';
+import '../../context/types.cjs';
+import '../../llm/types.cjs';
+
+/**
+ * Create a history provider directly with database backend
+ */
+declare function createDatabaseHistoryProvider(database: DatabaseBackend, sessionId: string): IConversationHistoryProvider;
+
+export { createDatabaseHistoryProvider };

package/dist/session/history/factory.d.ts

@@ -0,0 +1,11 @@
+import { IConversationHistoryProvider } from './types.js';
+import { DatabaseBackend } from '../../storage/backend/database-backend.js';
+import '../../context/types.js';
+import '../../llm/types.js';
+
+/**
+ * Create a history provider directly with database backend
+ */
+declare function createDatabaseHistoryProvider(database: DatabaseBackend, sessionId: string): IConversationHistoryProvider;
+
+export { createDatabaseHistoryProvider };

package/dist/session/history/factory.js

@@ -0,0 +1,7 @@
+import { DatabaseHistoryProvider } from "./database.js";
+function createDatabaseHistoryProvider(database, sessionId) {
+  return new DatabaseHistoryProvider(sessionId, database);
+}
+export {
+  createDatabaseHistoryProvider
+};

package/dist/session/history/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/session/history/types.d.cts

@@ -0,0 +1,17 @@
+import { InternalMessage } from '../../context/types.cjs';
+import '../../llm/types.cjs';
+
+/**
+ * Session-scoped conversation history provider.
+ * Each instance is tied to a specific session and manages only that session's messages.
+ */
+interface IConversationHistoryProvider {
+    /** Load the full message history for this session */
+    getHistory(): Promise<InternalMessage[]>;
+    /** Append a message to this session's history */
+    saveMessage(message: InternalMessage): Promise<void>;
+    /** Clear all messages for this session */
+    clearHistory(): Promise<void>;
+}
+
+export type { IConversationHistoryProvider };

package/dist/session/history/types.d.ts

@@ -0,0 +1,17 @@
+import { InternalMessage } from '../../context/types.js';
+import '../../llm/types.js';
+
+/**
+ * Session-scoped conversation history provider.
+ * Each instance is tied to a specific session and manages only that session's messages.
+ */
+interface IConversationHistoryProvider {
+    /** Load the full message history for this session */
+    getHistory(): Promise<InternalMessage[]>;
+    /** Append a message to this session's history */
+    saveMessage(message: InternalMessage): Promise<void>;
+    /** Clear all messages for this session */
+    clearHistory(): Promise<void>;
+}
+
+export type { IConversationHistoryProvider };

package/dist/session/index.cjs

@@ -0,0 +1,37 @@
+"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 session_exports = {};
+__export(session_exports, {
+  ChatSession: () => import_chat_session.ChatSession,
+  SessionError: () => import_errors.SessionError,
+  SessionErrorCode: () => import_error_codes.SessionErrorCode,
+  SessionManager: () => import_session_manager.SessionManager
+});
+module.exports = __toCommonJS(session_exports);
+var import_chat_session = require("./chat-session.js");
+var import_session_manager = require("./session-manager.js");
+var import_error_codes = require("./error-codes.js");
+var import_errors = require("./errors.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ChatSession,
+  SessionError,
+  SessionErrorCode,
+  SessionManager
+});

package/dist/session/index.d.cts

@@ -0,0 +1,53 @@
+export { ChatSession } from './chat-session.cjs';
+export { SessionManager, SessionMetadata } from './session-manager.cjs';
+export { SessionErrorCode } from './error-codes.cjs';
+export { SessionError } from './errors.cjs';
+import '../context/manager.cjs';
+import '../llm/formatters/types.cjs';
+import '../context/types.cjs';
+import '../llm/types.cjs';
+import '../llm/tokenizer/types.cjs';
+import '../context/compression/types.cjs';
+import '../systemPrompt/types.cjs';
+import '../mcp/manager.cjs';
+import '../mcp/schemas.cjs';
+import 'zod';
+import '../mcp/types.cjs';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '../tools/types.cjs';
+import 'json-schema';
+import '@modelcontextprotocol/sdk/types.js';
+import '../systemPrompt/manager.cjs';
+import '../systemPrompt/schemas.cjs';
+import './history/types.cjs';
+import '../llm/schemas.cjs';
+import '../llm/services/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 '../search/types.cjs';
+import '../tools/schemas.cjs';
+import '../tools/confirmation/types.cjs';
+import '../tools/confirmation/allowed-tools-provider/types.cjs';
+import '../agent/state-manager.cjs';
+import '../agent/schemas.cjs';
+import '../events/index.cjs';
+import 'events';
+import '../storage/backend/types.cjs';
+import '../storage/backend/cache-backend.cjs';
+import '../storage/schemas.cjs';
+import '../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 '../storage/error-codes.cjs';
+import '../systemPrompt/error-codes.cjs';
+import '../tools/error-codes.cjs';
+import '../preferences/error-codes.cjs';
+import '../agent/registry/error-codes.cjs';

package/dist/session/index.d.ts

@@ -0,0 +1,53 @@
+export { ChatSession } from './chat-session.js';
+export { SessionManager, SessionMetadata } from './session-manager.js';
+export { SessionErrorCode } from './error-codes.js';
+export { SessionError } from './errors.js';
+import '../context/manager.js';
+import '../llm/formatters/types.js';
+import '../context/types.js';
+import '../llm/types.js';
+import '../llm/tokenizer/types.js';
+import '../context/compression/types.js';
+import '../systemPrompt/types.js';
+import '../mcp/manager.js';
+import '../mcp/schemas.js';
+import 'zod';
+import '../mcp/types.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '../tools/types.js';
+import 'json-schema';
+import '@modelcontextprotocol/sdk/types.js';
+import '../systemPrompt/manager.js';
+import '../systemPrompt/schemas.js';
+import './history/types.js';
+import '../llm/schemas.js';
+import '../llm/services/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 '../search/types.js';
+import '../tools/schemas.js';
+import '../tools/confirmation/types.js';
+import '../tools/confirmation/allowed-tools-provider/types.js';
+import '../agent/state-manager.js';
+import '../agent/schemas.js';
+import '../events/index.js';
+import 'events';
+import '../storage/backend/types.js';
+import '../storage/backend/cache-backend.js';
+import '../storage/schemas.js';
+import '../errors/DextoRuntimeError.js';
+import '../errors/DextoBaseError.js';
+import '../errors/types.js';
+import '../agent/error-codes.js';
+import '../config/error-codes.js';
+import '../context/error-codes.js';
+import '../llm/error-codes.js';
+import '../mcp/error-codes.js';
+import '../storage/error-codes.js';
+import '../systemPrompt/error-codes.js';
+import '../tools/error-codes.js';
+import '../preferences/error-codes.js';
+import '../agent/registry/error-codes.js';

package/dist/session/index.js

@@ -0,0 +1,10 @@
+import { ChatSession } from "./chat-session.js";
+import { SessionManager } from "./session-manager.js";
+import { SessionErrorCode } from "./error-codes.js";
+import { SessionError } from "./errors.js";
+export {
+  ChatSession,
+  SessionError,
+  SessionErrorCode,
+  SessionManager
+};

package/dist/session/schemas.cjs

@@ -0,0 +1,32 @@
+"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 schemas_exports = {};
+__export(schemas_exports, {
+  SessionConfigSchema: () => SessionConfigSchema
+});
+module.exports = __toCommonJS(schemas_exports);
+var import_zod = require("zod");
+const SessionConfigSchema = import_zod.z.object({
+  maxSessions: import_zod.z.number().int().positive().default(100).describe("Maximum number of concurrent sessions allowed, defaults to 100"),
+  sessionTTL: import_zod.z.number().int().positive().default(36e5).describe("Session time-to-live in milliseconds, defaults to 3600000ms (1 hour)")
+}).strict().describe("Session management configuration");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionConfigSchema
+});

package/dist/session/schemas.d.cts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+
+declare const SessionConfigSchema: z.ZodObject<{
+    maxSessions: z.ZodDefault<z.ZodNumber>;
+    sessionTTL: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    maxSessions: number;
+    sessionTTL: number;
+}, {
+    maxSessions?: number | undefined;
+    sessionTTL?: number | undefined;
+}>;
+type SessionConfig = z.input<typeof SessionConfigSchema>;
+type ValidatedSessionConfig = z.output<typeof SessionConfigSchema>;
+
+export { type SessionConfig, SessionConfigSchema, type ValidatedSessionConfig };

package/dist/session/schemas.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+
+declare const SessionConfigSchema: z.ZodObject<{
+    maxSessions: z.ZodDefault<z.ZodNumber>;
+    sessionTTL: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    maxSessions: number;
+    sessionTTL: number;
+}, {
+    maxSessions?: number | undefined;
+    sessionTTL?: number | undefined;
+}>;
+type SessionConfig = z.input<typeof SessionConfigSchema>;
+type ValidatedSessionConfig = z.output<typeof SessionConfigSchema>;
+
+export { type SessionConfig, SessionConfigSchema, type ValidatedSessionConfig };

package/dist/session/schemas.js

@@ -0,0 +1,8 @@
+import { z } from "zod";
+const SessionConfigSchema = z.object({
+  maxSessions: z.number().int().positive().default(100).describe("Maximum number of concurrent sessions allowed, defaults to 100"),
+  sessionTTL: z.number().int().positive().default(36e5).describe("Session time-to-live in milliseconds, defaults to 3600000ms (1 hour)")
+}).strict().describe("Session management configuration");
+export {
+  SessionConfigSchema
+};