@dexto/core 1.3.0 → 1.5.0

package/dist/llm/formatters/openai.cjs

@@ -1,203 +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 openai_exports = {};
-__export(openai_exports, {
-  OpenAIMessageFormatter: () => OpenAIMessageFormatter
-});
-module.exports = __toCommonJS(openai_exports);
-var import_utils = require("../../context/utils.cjs");
-var import_types4 = require("../../logger/v2/types.cjs");
-class OpenAIMessageFormatter {
-  logger;
-  constructor(logger) {
-    this.logger = logger.createChild(import_types4.DextoLogComponent.LLM);
-  }
-  /**
-   * Formats internal messages into OpenAI's Chat Completion API format
-   *
-   * @param history Array of internal messages to format
-   * @param systemPrompt System prompt to include at the beginning of messages
-   * @returns Array of messages formatted for OpenAI's API
-   */
-  format(history, context, systemPrompt) {
-    const formatted = [];
-    let filteredHistory;
-    try {
-      filteredHistory = (0, import_utils.filterMessagesByLLMCapabilities)([...history], context, this.logger);
-    } catch (error) {
-      this.logger.warn(
-        `Failed to apply capability filtering, using original history: ${error}`
-      );
-      filteredHistory = [...history];
-    }
-    if (systemPrompt) {
-      formatted.push({
-        role: "system",
-        content: systemPrompt
-      });
-    }
-    const pendingToolCallIds = /* @__PURE__ */ new Set();
-    for (const msg of filteredHistory) {
-      switch (msg.role) {
-        case "system":
-          formatted.push({
-            role: "system",
-            content: String(msg.content || "")
-          });
-          break;
-        case "user":
-          formatted.push({
-            role: "user",
-            content: this.formatUserContent(msg.content)
-          });
-          break;
-        case "assistant":
-          if (msg.toolCalls && msg.toolCalls.length > 0) {
-            formatted.push({
-              role: "assistant",
-              content: String(msg.content || ""),
-              tool_calls: msg.toolCalls
-            });
-            for (const toolCall of msg.toolCalls) {
-              pendingToolCallIds.add(toolCall.id);
-            }
-          } else {
-            formatted.push({
-              role: "assistant",
-              content: String(msg.content || "")
-            });
-          }
-          break;
-        case "tool":
-          if (msg.toolCallId && pendingToolCallIds.has(msg.toolCallId)) {
-            formatted.push({
-              role: "tool",
-              content: (0, import_utils.toTextForToolMessage)(msg.content),
-              tool_call_id: msg.toolCallId
-            });
-            pendingToolCallIds.delete(msg.toolCallId);
-          } else {
-            this.logger.warn(
-              `Skipping orphaned tool result ${msg.toolCallId} (no matching tool call found) - cannot send to OpenAI without corresponding tool_calls`
-            );
-          }
-          break;
-      }
-    }
-    if (pendingToolCallIds.size > 0) {
-      for (const toolCallId of pendingToolCallIds) {
-        formatted.push({
-          role: "tool",
-          content: "Error: Tool execution was interrupted (session crashed or cancelled before completion)",
-          tool_call_id: toolCallId
-        });
-        this.logger.warn(
-          `Tool call ${toolCallId} had no matching tool result - added synthetic error result to prevent API errors`
-        );
-      }
-    }
-    return formatted;
-  }
-  /**
-   * OpenAI handles system prompts in the messages array
-   * This method returns null since the system prompt is already
-   * included directly in the formatted messages.
-   *
-   * @returns null as OpenAI doesn't need a separate system prompt
-   */
-  formatSystemPrompt() {
-    return null;
-  }
-  /**
-   * Parses OpenAI API response into internal message objects.
-   */
-  parseResponse(response) {
-    const internal = [];
-    const typedResponse = response;
-    if (!typedResponse.choices || !Array.isArray(typedResponse.choices)) return internal;
-    for (const choice of typedResponse.choices) {
-      const msg = choice.message;
-      if (!msg || !msg.role) continue;
-      const role = msg.role;
-      if (role === "assistant") {
-        const content = msg.content ?? null;
-        if (msg.tool_calls && Array.isArray(msg.tool_calls) && msg.tool_calls.length > 0) {
-          const calls = msg.tool_calls.map((call) => {
-            const typedCall = call;
-            return {
-              id: typedCall.id,
-              type: "function",
-              function: {
-                name: typedCall.function.name,
-                arguments: typedCall.function.arguments
-              }
-            };
-          });
-          internal.push({ role: "assistant", content, toolCalls: calls });
-        } else {
-          internal.push({ role: "assistant", content });
-        }
-      } else if (role === "tool") {
-        internal.push({
-          role: "tool",
-          content: msg.content,
-          toolCallId: msg.tool_call_id,
-          name: msg.name
-        });
-      } else if (role === "user" || role === "system") {
-        if (msg.content) {
-          internal.push({ role, content: msg.content });
-        }
-      }
-    }
-    return internal;
-  }
-  // Helper to format user message parts (text + image + file) into chat API shape
-  formatUserContent(content) {
-    if (!Array.isArray(content)) {
-      return String(content || "");
-    }
-    const parts = content.map((part) => {
-      if (part.type === "text") {
-        return { type: "text", text: part.text };
-      }
-      if (part.type === "image") {
-        const raw = (0, import_utils.getImageData)(part, this.logger);
-        const url = raw.startsWith("http://") || raw.startsWith("https://") || raw.startsWith("data:") ? raw : `data:${part.mimeType || "application/octet-stream"};base64,${raw}`;
-        return { type: "image_url", image_url: { url } };
-      }
-      if (part.type === "file") {
-        const fileData = typeof part.data === "string" ? part.data : void 0;
-        return {
-          type: "file",
-          file: {
-            ...fileData && { file_data: fileData },
-            ...part.filename && { filename: part.filename }
-          }
-        };
-      }
-      return null;
-    }).filter((part) => part !== null);
-    return parts;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  OpenAIMessageFormatter
-});

package/dist/llm/formatters/openai.d.ts

@@ -1,39 +0,0 @@
-import { ChatCompletionMessageParam } from 'openai/resources';
-import { IMessageFormatter } from './types.js';
-import { LLMContext } from '../types.js';
-import { InternalMessage } from '../../context/types.js';
-import type { IDextoLogger } from '../../logger/v2/types.js';
-/**
- * Message formatter for OpenAI's Chat Completion API.
- *
- * Converts the internal message format to OpenAI's specific structure:
- * - System prompt is included in the messages array
- * - Tool calls use the tool_calls property with a structure matching OpenAI's API
- * - Tool results use the 'tool' role with tool_call_id and name
- */
-export declare class OpenAIMessageFormatter implements IMessageFormatter {
-    private logger;
-    constructor(logger: IDextoLogger);
-    /**
-     * Formats internal messages into OpenAI's Chat Completion API format
-     *
-     * @param history Array of internal messages to format
-     * @param systemPrompt System prompt to include at the beginning of messages
-     * @returns Array of messages formatted for OpenAI's API
-     */
-    format(history: Readonly<InternalMessage[]>, context: LLMContext, systemPrompt: string | null): ChatCompletionMessageParam[];
-    /**
-     * OpenAI handles system prompts in the messages array
-     * This method returns null since the system prompt is already
-     * included directly in the formatted messages.
-     *
-     * @returns null as OpenAI doesn't need a separate system prompt
-     */
-    formatSystemPrompt(): null;
-    /**
-     * Parses OpenAI API response into internal message objects.
-     */
-    parseResponse(response: unknown): InternalMessage[];
-    private formatUserContent;
-}
-//# sourceMappingURL=openai.d.ts.map

package/dist/llm/formatters/openai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/llm/formatters/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAA6B,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAMzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAC5D,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAGhC;;;;;;OAMG;IACH,MAAM,CACF,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,EACpC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,0BAA0B,EAAE;IAyG/B;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,EAAE;IAiDnD,OAAO,CAAC,iBAAiB;CAwC5B"}

package/dist/llm/formatters/openai.js

@@ -1,184 +0,0 @@
-import "../../chunk-C6A6W6XS.js";
-import {
-  getImageData,
-  filterMessagesByLLMCapabilities,
-  toTextForToolMessage
-} from "../../context/utils.js";
-import { DextoLogComponent } from "../../logger/v2/types.js";
-class OpenAIMessageFormatter {
-  logger;
-  constructor(logger) {
-    this.logger = logger.createChild(DextoLogComponent.LLM);
-  }
-  /**
-   * Formats internal messages into OpenAI's Chat Completion API format
-   *
-   * @param history Array of internal messages to format
-   * @param systemPrompt System prompt to include at the beginning of messages
-   * @returns Array of messages formatted for OpenAI's API
-   */
-  format(history, context, systemPrompt) {
-    const formatted = [];
-    let filteredHistory;
-    try {
-      filteredHistory = filterMessagesByLLMCapabilities([...history], context, this.logger);
-    } catch (error) {
-      this.logger.warn(
-        `Failed to apply capability filtering, using original history: ${error}`
-      );
-      filteredHistory = [...history];
-    }
-    if (systemPrompt) {
-      formatted.push({
-        role: "system",
-        content: systemPrompt
-      });
-    }
-    const pendingToolCallIds = /* @__PURE__ */ new Set();
-    for (const msg of filteredHistory) {
-      switch (msg.role) {
-        case "system":
-          formatted.push({
-            role: "system",
-            content: String(msg.content || "")
-          });
-          break;
-        case "user":
-          formatted.push({
-            role: "user",
-            content: this.formatUserContent(msg.content)
-          });
-          break;
-        case "assistant":
-          if (msg.toolCalls && msg.toolCalls.length > 0) {
-            formatted.push({
-              role: "assistant",
-              content: String(msg.content || ""),
-              tool_calls: msg.toolCalls
-            });
-            for (const toolCall of msg.toolCalls) {
-              pendingToolCallIds.add(toolCall.id);
-            }
-          } else {
-            formatted.push({
-              role: "assistant",
-              content: String(msg.content || "")
-            });
-          }
-          break;
-        case "tool":
-          if (msg.toolCallId && pendingToolCallIds.has(msg.toolCallId)) {
-            formatted.push({
-              role: "tool",
-              content: toTextForToolMessage(msg.content),
-              tool_call_id: msg.toolCallId
-            });
-            pendingToolCallIds.delete(msg.toolCallId);
-          } else {
-            this.logger.warn(
-              `Skipping orphaned tool result ${msg.toolCallId} (no matching tool call found) - cannot send to OpenAI without corresponding tool_calls`
-            );
-          }
-          break;
-      }
-    }
-    if (pendingToolCallIds.size > 0) {
-      for (const toolCallId of pendingToolCallIds) {
-        formatted.push({
-          role: "tool",
-          content: "Error: Tool execution was interrupted (session crashed or cancelled before completion)",
-          tool_call_id: toolCallId
-        });
-        this.logger.warn(
-          `Tool call ${toolCallId} had no matching tool result - added synthetic error result to prevent API errors`
-        );
-      }
-    }
-    return formatted;
-  }
-  /**
-   * OpenAI handles system prompts in the messages array
-   * This method returns null since the system prompt is already
-   * included directly in the formatted messages.
-   *
-   * @returns null as OpenAI doesn't need a separate system prompt
-   */
-  formatSystemPrompt() {
-    return null;
-  }
-  /**
-   * Parses OpenAI API response into internal message objects.
-   */
-  parseResponse(response) {
-    const internal = [];
-    const typedResponse = response;
-    if (!typedResponse.choices || !Array.isArray(typedResponse.choices)) return internal;
-    for (const choice of typedResponse.choices) {
-      const msg = choice.message;
-      if (!msg || !msg.role) continue;
-      const role = msg.role;
-      if (role === "assistant") {
-        const content = msg.content ?? null;
-        if (msg.tool_calls && Array.isArray(msg.tool_calls) && msg.tool_calls.length > 0) {
-          const calls = msg.tool_calls.map((call) => {
-            const typedCall = call;
-            return {
-              id: typedCall.id,
-              type: "function",
-              function: {
-                name: typedCall.function.name,
-                arguments: typedCall.function.arguments
-              }
-            };
-          });
-          internal.push({ role: "assistant", content, toolCalls: calls });
-        } else {
-          internal.push({ role: "assistant", content });
-        }
-      } else if (role === "tool") {
-        internal.push({
-          role: "tool",
-          content: msg.content,
-          toolCallId: msg.tool_call_id,
-          name: msg.name
-        });
-      } else if (role === "user" || role === "system") {
-        if (msg.content) {
-          internal.push({ role, content: msg.content });
-        }
-      }
-    }
-    return internal;
-  }
-  // Helper to format user message parts (text + image + file) into chat API shape
-  formatUserContent(content) {
-    if (!Array.isArray(content)) {
-      return String(content || "");
-    }
-    const parts = content.map((part) => {
-      if (part.type === "text") {
-        return { type: "text", text: part.text };
-      }
-      if (part.type === "image") {
-        const raw = getImageData(part, this.logger);
-        const url = raw.startsWith("http://") || raw.startsWith("https://") || raw.startsWith("data:") ? raw : `data:${part.mimeType || "application/octet-stream"};base64,${raw}`;
-        return { type: "image_url", image_url: { url } };
-      }
-      if (part.type === "file") {
-        const fileData = typeof part.data === "string" ? part.data : void 0;
-        return {
-          type: "file",
-          file: {
-            ...fileData && { file_data: fileData },
-            ...part.filename && { filename: part.filename }
-          }
-        };
-      }
-      return null;
-    }).filter((part) => part !== null);
-    return parts;
-  }
-}
-export {
-  OpenAIMessageFormatter
-};

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

@@ -1,41 +0,0 @@
-import { InternalMessage } from '../../context/types.js';
-import { LLMContext } from '../types.js';
-/**
- * Interface for converting internal message format to LLM provider-specific formats.
- * Each LLM provider requires a different message structure, and the formatter's job
- * is to handle these conversions while maintaining a consistent internal representation.
- */
-export interface IMessageFormatter {
-    /**
-     * Formats the internal message history for a specific LLM provider API.
-     * Transforms our standardized internal message format into the specific structure
-     * required by the target LLM API.
-     *
-     * @param history The raw internal message history (read-only to prevent modifications)
-     * @param systemPrompt The system prompt, if any
-     * @param context Optional context containing model information for capability-based filtering
-     * @returns The message history structured for the target API (provider-specific type)
-     */
-    format(history: Readonly<InternalMessage[]>, context: LLMContext, systemPrompt?: string | null): unknown[];
-    /**
-     * Parses raw LLM response into an array of InternalMessage objects.
-     */
-    parseResponse(response: unknown): InternalMessage[];
-    /**
-     * Optional method for handling system prompt separately.
-     * Some LLM providers (like Anthropic) don't include the system prompt in the
-     * messages array but pass it as a separate parameter.
-     *
-     * @param systemPrompt The system prompt to format
-     * @returns The formatted system prompt or null/undefined if not needed
-     */
-    formatSystemPrompt?(systemPrompt: string | null): string | null | undefined;
-    /**
-     * Optional method for parsing streaming LLM responses into InternalMessage objects.
-     *
-     * @param response The streaming response from the LLM provider
-     * @returns Promise that resolves to an array of InternalMessage objects
-     */
-    parseStreamResponse?(response: unknown): Promise<InternalMessage[]>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/llm/formatters/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/formatters/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;OASG;IACH,MAAM,CACF,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,EACpC,OAAO,EAAE,UAAU,EACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,EAAE,CAAC;IAEb;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,EAAE,CAAC;IAEpD;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE5E;;;;;OAKG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACvE"}