@dexto/core 1.1.4 → 1.1.6

package/dist/llm/formatters/openai.cjs

@@ -0,0 +1,167 @@
+"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_logger = require("../../logger/index.cjs");
+class OpenAIMessageFormatter {
+  /**
+   * 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);
+    } catch (error) {
+      import_logger.logger.warn(`Failed to apply capability filtering, using original history: ${error}`);
+      filteredHistory = [...history];
+    }
+    if (systemPrompt) {
+      formatted.push({
+        role: "system",
+        content: systemPrompt
+      });
+    }
+    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
+            });
+          } else {
+            formatted.push({
+              role: "assistant",
+              content: String(msg.content || "")
+            });
+          }
+          break;
+        case "tool":
+          formatted.push({
+            role: "tool",
+            content: (0, import_utils.toTextForToolMessage)(msg.content),
+            tool_call_id: msg.toolCallId || ""
+          });
+          break;
+      }
+    }
+    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);
+        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") {
+        return { type: "file", file: part };
+      }
+      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.cts

@@ -0,0 +1,38 @@
+import { ChatCompletionMessageParam } from 'openai/resources';
+import { IMessageFormatter } from './types.cjs';
+import { LLMContext } from '../types.cjs';
+import { InternalMessage } from '../../context/types.cjs';
+
+/**
+ * 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
+ */
+declare class OpenAIMessageFormatter implements IMessageFormatter {
+    /**
+     * 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;
+}
+
+export { OpenAIMessageFormatter };

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

@@ -0,0 +1,38 @@
+import { ChatCompletionMessageParam } from 'openai/resources';
+import { IMessageFormatter } from './types.js';
+import { LLMContext } from '../types.js';
+import { InternalMessage } from '../../context/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
+ */
+declare class OpenAIMessageFormatter implements IMessageFormatter {
+    /**
+     * 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;
+}
+
+export { OpenAIMessageFormatter };

package/dist/llm/formatters/openai.js

@@ -0,0 +1,147 @@
+import {
+  getImageData,
+  filterMessagesByLLMCapabilities,
+  toTextForToolMessage
+} from "../../context/utils.js";
+import { logger } from "../../logger/index.js";
+class OpenAIMessageFormatter {
+  /**
+   * 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);
+    } catch (error) {
+      logger.warn(`Failed to apply capability filtering, using original history: ${error}`);
+      filteredHistory = [...history];
+    }
+    if (systemPrompt) {
+      formatted.push({
+        role: "system",
+        content: systemPrompt
+      });
+    }
+    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
+            });
+          } else {
+            formatted.push({
+              role: "assistant",
+              content: String(msg.content || "")
+            });
+          }
+          break;
+        case "tool":
+          formatted.push({
+            role: "tool",
+            content: toTextForToolMessage(msg.content),
+            tool_call_id: msg.toolCallId || ""
+          });
+          break;
+      }
+    }
+    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);
+        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") {
+        return { type: "file", file: part };
+      }
+      return null;
+    }).filter((part) => part !== null);
+    return parts;
+  }
+}
+export {
+  OpenAIMessageFormatter
+};

package/dist/llm/formatters/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/formatters/types.d.cts

@@ -0,0 +1,43 @@
+import { InternalMessage } from '../../context/types.cjs';
+import { LLMContext } from '../types.cjs';
+
+/**
+ * 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.
+ */
+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[]>;
+}
+
+export type { IMessageFormatter };

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

@@ -0,0 +1,43 @@
+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.
+ */
+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[]>;
+}
+
+export type { IMessageFormatter };