conversationalist 0.0.1

package/dist/adapters/gemini/index.d.ts

@@ -0,0 +1,79 @@
+import type { Conversation } from '../../types';
+/**
+ * Gemini text part.
+ */
+export interface GeminiTextPart {
+    text: string;
+}
+/**
+ * Gemini inline data part (for images).
+ */
+export interface GeminiInlineDataPart {
+    inlineData: {
+        mimeType: string;
+        data: string;
+    };
+}
+/**
+ * Gemini file data part (for URLs).
+ */
+export interface GeminiFileDataPart {
+    fileData: {
+        mimeType?: string;
+        fileUri: string;
+    };
+}
+/**
+ * Gemini function call part.
+ */
+export interface GeminiFunctionCallPart {
+    functionCall: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+}
+/**
+ * Gemini function response part.
+ */
+export interface GeminiFunctionResponsePart {
+    functionResponse: {
+        name: string;
+        response: unknown;
+    };
+}
+/**
+ * Gemini content part union type.
+ */
+export type GeminiPart = GeminiTextPart | GeminiInlineDataPart | GeminiFileDataPart | GeminiFunctionCallPart | GeminiFunctionResponsePart;
+/**
+ * Gemini content (message) format.
+ */
+export interface GeminiContent {
+    role: 'user' | 'model';
+    parts: GeminiPart[];
+}
+/**
+ * Result of converting a conversation to Gemini format.
+ */
+export interface GeminiConversation {
+    systemInstruction?: GeminiContent;
+    contents: GeminiContent[];
+}
+/**
+ * Converts a conversation to Google Gemini API format.
+ * System messages are extracted to `systemInstruction`.
+ * Tool calls become functionCall parts, tool results become functionResponse parts.
+ *
+ * @example
+ * ```ts
+ * import { toGeminiMessages } from 'conversationalist/gemini';
+ *
+ * const { systemInstruction, contents } = toGeminiMessages(conversation);
+ * const response = await genAI.getGenerativeModel({ model: 'gemini-pro' }).generateContent({
+ *   systemInstruction,
+ *   contents,
+ * });
+ * ```
+ */
+export declare function toGeminiMessages(conversation: Conversation): GeminiConversation;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/gemini/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/gemini/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,oBAAoB,GACpB,kBAAkB,GAClB,sBAAsB,GACtB,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AA+GD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,kBAAkB,CAkF/E"}

package/dist/adapters/gemini/index.js

@@ -0,0 +1,148 @@
+// src/adapters/gemini/index.ts
+function toGeminiParts(content) {
+  if (typeof content === "string") {
+    return content ? [{ text: content }] : [];
+  }
+  const parts = [];
+  for (const part of content) {
+    if (part.type === "text") {
+      if (part.text) {
+        parts.push({ text: part.text });
+      }
+    } else if (part.type === "image") {
+      const url = part.url ?? "";
+      if (url.startsWith("data:")) {
+        const matches = url.match(/^data:([^;]+);base64,(.+)$/);
+        if (matches) {
+          parts.push({
+            inlineData: {
+              mimeType: matches[1],
+              data: matches[2]
+            }
+          });
+        }
+      } else {
+        const fileData = { fileUri: url };
+        if (part.mimeType !== undefined) {
+          fileData.mimeType = part.mimeType;
+        }
+        parts.push({ fileData });
+      }
+    }
+  }
+  return parts;
+}
+function toFunctionCallPart(toolCall) {
+  let args;
+  if (typeof toolCall.arguments === "string") {
+    try {
+      args = JSON.parse(toolCall.arguments);
+    } catch {
+      args = { _raw: toolCall.arguments };
+    }
+  } else {
+    args = toolCall.arguments;
+  }
+  return {
+    functionCall: {
+      name: toolCall.name,
+      args
+    }
+  };
+}
+function toFunctionResponsePart(toolResult, functionName) {
+  return {
+    functionResponse: {
+      name: functionName,
+      response: toolResult.content
+    }
+  };
+}
+function extractSystemInstruction(messages) {
+  const systemMessages = messages.filter((m) => (m.role === "system" || m.role === "developer") && !m.hidden);
+  if (systemMessages.length === 0) {
+    return;
+  }
+  const parts = [];
+  for (const msg of systemMessages) {
+    parts.push(...toGeminiParts(msg.content));
+  }
+  if (parts.length === 0) {
+    return;
+  }
+  return {
+    role: "user",
+    parts
+  };
+}
+function toGeminiMessages(conversation) {
+  const systemInstruction = extractSystemInstruction(conversation.messages);
+  const toolCallNames = new Map;
+  for (const message of conversation.messages) {
+    if (message.role === "tool-use" && message.toolCall) {
+      toolCallNames.set(message.toolCall.id, message.toolCall.name);
+    }
+  }
+  const contents = [];
+  let currentRole = null;
+  let currentParts = [];
+  const flushCurrent = () => {
+    if (currentRole && currentParts.length > 0) {
+      contents.push({
+        role: currentRole,
+        parts: currentParts
+      });
+      currentParts = [];
+    }
+    currentRole = null;
+  };
+  for (const message of conversation.messages) {
+    if (message.hidden)
+      continue;
+    if (message.role === "system" || message.role === "developer") {
+      continue;
+    }
+    if (message.role === "snapshot") {
+      continue;
+    }
+    let targetRole;
+    let parts = [];
+    if (message.role === "user") {
+      targetRole = "user";
+      parts = toGeminiParts(message.content);
+    } else if (message.role === "assistant") {
+      targetRole = "model";
+      parts = toGeminiParts(message.content);
+    } else if (message.role === "tool-use" && message.toolCall) {
+      targetRole = "model";
+      parts = [toFunctionCallPart(message.toolCall)];
+    } else if (message.role === "tool-result" && message.toolResult) {
+      targetRole = "user";
+      const functionName = toolCallNames.get(message.toolResult.callId) ?? "unknown";
+      parts = [toFunctionResponsePart(message.toolResult, functionName)];
+    } else {
+      continue;
+    }
+    if (parts.length === 0) {
+      continue;
+    }
+    if (currentRole === targetRole) {
+      currentParts.push(...parts);
+    } else {
+      flushCurrent();
+      currentRole = targetRole;
+      currentParts = parts;
+    }
+  }
+  flushCurrent();
+  const result = { contents };
+  if (systemInstruction !== undefined) {
+    result.systemInstruction = systemInstruction;
+  }
+  return result;
+}
+export {
+  toGeminiMessages
+};
+
+//# debugId=0C64ADAD8EC3A21464756E2164756E21

package/dist/adapters/gemini/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/gemini/index.ts"],
+  "sourcesContent": [
+    "import type { MultiModalContent } from '@lasercat/homogenaize';\n\nimport type { Conversation, Message, ToolCall, ToolResult } from '../../types';\n\n/**\n * Gemini text part.\n */\nexport interface GeminiTextPart {\n  text: string;\n}\n\n/**\n * Gemini inline data part (for images).\n */\nexport interface GeminiInlineDataPart {\n  inlineData: {\n    mimeType: string;\n    data: string;\n  };\n}\n\n/**\n * Gemini file data part (for URLs).\n */\nexport interface GeminiFileDataPart {\n  fileData: {\n    mimeType?: string;\n    fileUri: string;\n  };\n}\n\n/**\n * Gemini function call part.\n */\nexport interface GeminiFunctionCallPart {\n  functionCall: {\n    name: string;\n    args: Record<string, unknown>;\n  };\n}\n\n/**\n * Gemini function response part.\n */\nexport interface GeminiFunctionResponsePart {\n  functionResponse: {\n    name: string;\n    response: unknown;\n  };\n}\n\n/**\n * Gemini content part union type.\n */\nexport type GeminiPart =\n  | GeminiTextPart\n  | GeminiInlineDataPart\n  | GeminiFileDataPart\n  | GeminiFunctionCallPart\n  | GeminiFunctionResponsePart;\n\n/**\n * Gemini content (message) format.\n */\nexport interface GeminiContent {\n  role: 'user' | 'model';\n  parts: GeminiPart[];\n}\n\n/**\n * Result of converting a conversation to Gemini format.\n */\nexport interface GeminiConversation {\n  systemInstruction?: GeminiContent;\n  contents: GeminiContent[];\n}\n\n/**\n * Converts internal multi-modal content to Gemini parts.\n */\nfunction toGeminiParts(content: string | ReadonlyArray<MultiModalContent>): GeminiPart[] {\n  if (typeof content === 'string') {\n    return content ? [{ text: content }] : [];\n  }\n\n  const parts: GeminiPart[] = [];\n  for (const part of content) {\n    if (part.type === 'text') {\n      if (part.text) {\n        parts.push({ text: part.text });\n      }\n    } else if (part.type === 'image') {\n      const url = part.url ?? '';\n      if (url.startsWith('data:')) {\n        // Base64 data URL\n        const matches = url.match(/^data:([^;]+);base64,(.+)$/);\n        if (matches) {\n          parts.push({\n            inlineData: {\n              mimeType: matches[1]!,\n              data: matches[2]!,\n            },\n          });\n        }\n      } else {\n        // File URI\n        const fileData: GeminiFileDataPart['fileData'] = { fileUri: url };\n        if (part.mimeType !== undefined) {\n          fileData.mimeType = part.mimeType;\n        }\n        parts.push({ fileData });\n      }\n    }\n  }\n\n  return parts;\n}\n\n/**\n * Converts an internal ToolCall to Gemini functionCall part.\n */\nfunction toFunctionCallPart(toolCall: ToolCall): GeminiFunctionCallPart {\n  let args: Record<string, unknown>;\n  if (typeof toolCall.arguments === 'string') {\n    try {\n      args = JSON.parse(toolCall.arguments) as Record<string, unknown>;\n    } catch {\n      args = { _raw: toolCall.arguments };\n    }\n  } else {\n    args = toolCall.arguments as Record<string, unknown>;\n  }\n\n  return {\n    functionCall: {\n      name: toolCall.name,\n      args,\n    },\n  };\n}\n\n/**\n * Converts an internal ToolResult to Gemini functionResponse part.\n * Note: Gemini needs the function name, which we track via a map from the conversation.\n */\nfunction toFunctionResponsePart(\n  toolResult: ToolResult,\n  functionName: string,\n): GeminiFunctionResponsePart {\n  return {\n    functionResponse: {\n      name: functionName,\n      response: toolResult.content,\n    },\n  };\n}\n\n/**\n * Collects system message content from a conversation for Gemini's systemInstruction.\n */\nfunction extractSystemInstruction(\n  messages: ReadonlyArray<Message>,\n): GeminiContent | undefined {\n  const systemMessages = messages.filter(\n    (m) => (m.role === 'system' || m.role === 'developer') && !m.hidden,\n  );\n\n  if (systemMessages.length === 0) {\n    return undefined;\n  }\n\n  const parts: GeminiPart[] = [];\n  for (const msg of systemMessages) {\n    parts.push(...toGeminiParts(msg.content));\n  }\n\n  if (parts.length === 0) {\n    return undefined;\n  }\n\n  return {\n    role: 'user', // systemInstruction uses 'user' role in Gemini\n    parts,\n  };\n}\n\n/**\n * Converts a conversation to Google Gemini API format.\n * System messages are extracted to `systemInstruction`.\n * Tool calls become functionCall parts, tool results become functionResponse parts.\n *\n * @example\n * ```ts\n * import { toGeminiMessages } from 'conversationalist/gemini';\n *\n * const { systemInstruction, contents } = toGeminiMessages(conversation);\n * const response = await genAI.getGenerativeModel({ model: 'gemini-pro' }).generateContent({\n *   systemInstruction,\n *   contents,\n * });\n * ```\n */\nexport function toGeminiMessages(conversation: Conversation): GeminiConversation {\n  const systemInstruction = extractSystemInstruction(conversation.messages);\n\n  // Build a map of tool call IDs to function names for tool results\n  const toolCallNames = new Map<string, string>();\n  for (const message of conversation.messages) {\n    if (message.role === 'tool-use' && message.toolCall) {\n      toolCallNames.set(message.toolCall.id, message.toolCall.name);\n    }\n  }\n\n  const contents: GeminiContent[] = [];\n\n  // Track pending parts to merge consecutive same-role messages\n  let currentRole: 'user' | 'model' | null = null;\n  let currentParts: GeminiPart[] = [];\n\n  const flushCurrent = () => {\n    if (currentRole && currentParts.length > 0) {\n      contents.push({\n        role: currentRole,\n        parts: currentParts,\n      });\n      currentParts = [];\n    }\n    currentRole = null;\n  };\n\n  for (const message of conversation.messages) {\n    if (message.hidden) continue;\n\n    // Skip system messages (already extracted)\n    if (message.role === 'system' || message.role === 'developer') {\n      continue;\n    }\n\n    // Skip snapshots\n    if (message.role === 'snapshot') {\n      continue;\n    }\n\n    let targetRole: 'user' | 'model';\n    let parts: GeminiPart[] = [];\n\n    if (message.role === 'user') {\n      targetRole = 'user';\n      parts = toGeminiParts(message.content);\n    } else if (message.role === 'assistant') {\n      targetRole = 'model';\n      parts = toGeminiParts(message.content);\n    } else if (message.role === 'tool-use' && message.toolCall) {\n      targetRole = 'model';\n      parts = [toFunctionCallPart(message.toolCall)];\n    } else if (message.role === 'tool-result' && message.toolResult) {\n      targetRole = 'user';\n      const functionName = toolCallNames.get(message.toolResult.callId) ?? 'unknown';\n      parts = [toFunctionResponsePart(message.toolResult, functionName)];\n    } else {\n      continue;\n    }\n\n    if (parts.length === 0) {\n      continue;\n    }\n\n    // Merge with current or start new\n    if (currentRole === targetRole) {\n      currentParts.push(...parts);\n    } else {\n      flushCurrent();\n      currentRole = targetRole;\n      currentParts = parts;\n    }\n  }\n\n  flushCurrent();\n\n  const result: GeminiConversation = { contents };\n  if (systemInstruction !== undefined) {\n    result.systemInstruction = systemInstruction;\n  }\n  return result;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "0C64ADAD8EC3A21464756E2164756E21",
+  "names": []
+}

package/dist/adapters/openai/index.d.ts

@@ -0,0 +1,65 @@
+import type { Conversation } from '../../types';
+/**
+ * OpenAI text content part.
+ */
+export interface OpenAITextContentPart {
+    type: 'text';
+    text: string;
+}
+/**
+ * OpenAI image content part.
+ */
+export interface OpenAIImageContentPart {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+/**
+ * OpenAI content part union type.
+ */
+export type OpenAIContentPart = OpenAITextContentPart | OpenAIImageContentPart;
+/**
+ * OpenAI tool call format.
+ */
+export interface OpenAIToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * OpenAI message format for the Chat Completions API.
+ */
+export interface OpenAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | OpenAIContentPart[] | null;
+    name?: string;
+    tool_calls?: OpenAIToolCall[];
+    tool_call_id?: string;
+}
+/**
+ * Converts a conversation to OpenAI Chat Completions API message format.
+ * Handles role mapping, tool calls, and multi-modal content.
+ *
+ * @example
+ * ```ts
+ * import { toOpenAIMessages } from 'conversationalist/openai';
+ *
+ * const messages = toOpenAIMessages(conversation);
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4',
+ *   messages,
+ * });
+ * ```
+ */
+export declare function toOpenAIMessages(conversation: Conversation): OpenAIMessage[];
+/**
+ * Groups consecutive tool-use messages into a single assistant message with multiple tool_calls.
+ * This is useful when the model made multiple tool calls in sequence.
+ */
+export declare function toOpenAIMessagesGrouped(conversation: Conversation): OpenAIMessage[];
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/openai/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAiHD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa,EAAE,CAW5E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa,EAAE,CAsCnF"}

package/dist/adapters/openai/index.js

@@ -0,0 +1,127 @@
+// src/adapters/openai/index.ts
+function toOpenAIContent(content) {
+  if (typeof content === "string") {
+    return content;
+  }
+  const parts = [];
+  for (const part of content) {
+    if (part.type === "text") {
+      parts.push({ type: "text", text: part.text ?? "" });
+    } else if (part.type === "image") {
+      parts.push({
+        type: "image_url",
+        image_url: { url: part.url ?? "" }
+      });
+    }
+  }
+  return parts.length === 1 && parts[0]?.type === "text" ? parts[0].text : parts;
+}
+function toOpenAIToolCall(toolCall) {
+  return {
+    id: toolCall.id,
+    type: "function",
+    function: {
+      name: toolCall.name,
+      arguments: typeof toolCall.arguments === "string" ? toolCall.arguments : JSON.stringify(toolCall.arguments)
+    }
+  };
+}
+function convertMessage(message) {
+  if (message.hidden) {
+    return null;
+  }
+  switch (message.role) {
+    case "system":
+    case "developer":
+      return {
+        role: "system",
+        content: toOpenAIContent(message.content)
+      };
+    case "user":
+      return {
+        role: "user",
+        content: toOpenAIContent(message.content)
+      };
+    case "assistant":
+      return {
+        role: "assistant",
+        content: toOpenAIContent(message.content)
+      };
+    case "tool-use":
+      if (!message.toolCall) {
+        return null;
+      }
+      return {
+        role: "assistant",
+        content: null,
+        tool_calls: [toOpenAIToolCall(message.toolCall)]
+      };
+    case "tool-result":
+      if (!message.toolResult) {
+        return null;
+      }
+      return {
+        role: "tool",
+        content: stringifyToolResult(message.toolResult),
+        tool_call_id: message.toolResult.callId
+      };
+    case "snapshot":
+      return null;
+    default:
+      return null;
+  }
+}
+function stringifyToolResult(result) {
+  if (typeof result.content === "string") {
+    return result.content;
+  }
+  return JSON.stringify(result.content);
+}
+function toOpenAIMessages(conversation) {
+  const messages = [];
+  for (const message of conversation.messages) {
+    const converted = convertMessage(message);
+    if (converted) {
+      messages.push(converted);
+    }
+  }
+  return messages;
+}
+function toOpenAIMessagesGrouped(conversation) {
+  const messages = [];
+  let pendingToolCalls = [];
+  for (const message of conversation.messages) {
+    if (message.hidden)
+      continue;
+    if (message.role === "tool-use" && message.toolCall) {
+      pendingToolCalls.push(toOpenAIToolCall(message.toolCall));
+      continue;
+    }
+    if (pendingToolCalls.length > 0) {
+      messages.push({
+        role: "assistant",
+        content: null,
+        tool_calls: pendingToolCalls
+      });
+      pendingToolCalls = [];
+    }
+    const converted = convertMessage(message);
+    if (converted && message.role !== "tool-use") {
+      messages.push(converted);
+    }
+  }
+  if (pendingToolCalls.length > 0) {
+    messages.push({
+      role: "assistant",
+      content: null,
+      tool_calls: pendingToolCalls
+    });
+  }
+  return messages;
+}
+export {
+  toOpenAIMessagesGrouped,
+  toOpenAIMessages
+};
+
+//# debugId=45A34764E7499FFC64756E2164756E21

package/dist/adapters/openai/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../src/adapters/openai/index.ts"],
+  "sourcesContent": [
+    "import type { MultiModalContent } from '@lasercat/homogenaize';\n\nimport type { Conversation, Message, ToolCall, ToolResult } from '../../types';\n\n/**\n * OpenAI text content part.\n */\nexport interface OpenAITextContentPart {\n  type: 'text';\n  text: string;\n}\n\n/**\n * OpenAI image content part.\n */\nexport interface OpenAIImageContentPart {\n  type: 'image_url';\n  image_url: {\n    url: string;\n    detail?: 'auto' | 'low' | 'high';\n  };\n}\n\n/**\n * OpenAI content part union type.\n */\nexport type OpenAIContentPart = OpenAITextContentPart | OpenAIImageContentPart;\n\n/**\n * OpenAI tool call format.\n */\nexport interface OpenAIToolCall {\n  id: string;\n  type: 'function';\n  function: {\n    name: string;\n    arguments: string;\n  };\n}\n\n/**\n * OpenAI message format for the Chat Completions API.\n */\nexport interface OpenAIMessage {\n  role: 'system' | 'user' | 'assistant' | 'tool';\n  content: string | OpenAIContentPart[] | null;\n  name?: string;\n  tool_calls?: OpenAIToolCall[];\n  tool_call_id?: string;\n}\n\n/**\n * Converts internal multi-modal content to OpenAI content parts format.\n */\nfunction toOpenAIContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n): string | OpenAIContentPart[] {\n  if (typeof content === 'string') {\n    return content;\n  }\n\n  const parts: OpenAIContentPart[] = [];\n  for (const part of content) {\n    if (part.type === 'text') {\n      parts.push({ type: 'text', text: part.text ?? '' });\n    } else if (part.type === 'image') {\n      parts.push({\n        type: 'image_url',\n        image_url: { url: part.url ?? '' },\n      });\n    }\n  }\n\n  return parts.length === 1 && parts[0]?.type === 'text' ? parts[0].text : parts;\n}\n\n/**\n * Converts an internal ToolCall to OpenAI format.\n */\nfunction toOpenAIToolCall(toolCall: ToolCall): OpenAIToolCall {\n  return {\n    id: toolCall.id,\n    type: 'function',\n    function: {\n      name: toolCall.name,\n      arguments:\n        typeof toolCall.arguments === 'string'\n          ? toolCall.arguments\n          : JSON.stringify(toolCall.arguments),\n    },\n  };\n}\n\n/**\n * Converts a single message to OpenAI format.\n * Returns null for messages that should be skipped.\n */\nfunction convertMessage(message: Message): OpenAIMessage | null {\n  // Skip hidden messages\n  if (message.hidden) {\n    return null;\n  }\n\n  switch (message.role) {\n    case 'system':\n    case 'developer':\n      return {\n        role: 'system',\n        content: toOpenAIContent(message.content),\n      };\n\n    case 'user':\n      return {\n        role: 'user',\n        content: toOpenAIContent(message.content),\n      };\n\n    case 'assistant':\n      return {\n        role: 'assistant',\n        content: toOpenAIContent(message.content),\n      };\n\n    case 'tool-use':\n      if (!message.toolCall) {\n        return null;\n      }\n      return {\n        role: 'assistant',\n        content: null,\n        tool_calls: [toOpenAIToolCall(message.toolCall)],\n      };\n\n    case 'tool-result':\n      if (!message.toolResult) {\n        return null;\n      }\n      return {\n        role: 'tool',\n        content: stringifyToolResult(message.toolResult),\n        tool_call_id: message.toolResult.callId,\n      };\n\n    case 'snapshot':\n      // Snapshots are internal state, not sent to API\n      return null;\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Converts a tool result to a string for OpenAI.\n */\nfunction stringifyToolResult(result: ToolResult): string {\n  if (typeof result.content === 'string') {\n    return result.content;\n  }\n  return JSON.stringify(result.content);\n}\n\n/**\n * Converts a conversation to OpenAI Chat Completions API message format.\n * Handles role mapping, tool calls, and multi-modal content.\n *\n * @example\n * ```ts\n * import { toOpenAIMessages } from 'conversationalist/openai';\n *\n * const messages = toOpenAIMessages(conversation);\n * const response = await openai.chat.completions.create({\n *   model: 'gpt-4',\n *   messages,\n * });\n * ```\n */\nexport function toOpenAIMessages(conversation: Conversation): OpenAIMessage[] {\n  const messages: OpenAIMessage[] = [];\n\n  for (const message of conversation.messages) {\n    const converted = convertMessage(message);\n    if (converted) {\n      messages.push(converted);\n    }\n  }\n\n  return messages;\n}\n\n/**\n * Groups consecutive tool-use messages into a single assistant message with multiple tool_calls.\n * This is useful when the model made multiple tool calls in sequence.\n */\nexport function toOpenAIMessagesGrouped(conversation: Conversation): OpenAIMessage[] {\n  const messages: OpenAIMessage[] = [];\n  let pendingToolCalls: OpenAIToolCall[] = [];\n\n  for (const message of conversation.messages) {\n    if (message.hidden) continue;\n\n    if (message.role === 'tool-use' && message.toolCall) {\n      pendingToolCalls.push(toOpenAIToolCall(message.toolCall));\n      continue;\n    }\n\n    // Flush pending tool calls before adding a new message\n    if (pendingToolCalls.length > 0) {\n      messages.push({\n        role: 'assistant',\n        content: null,\n        tool_calls: pendingToolCalls,\n      });\n      pendingToolCalls = [];\n    }\n\n    const converted = convertMessage(message);\n    if (converted && message.role !== 'tool-use') {\n      messages.push(converted);\n    }\n  }\n\n  // Flush any remaining tool calls\n  if (pendingToolCalls.length > 0) {\n    messages.push({\n      role: 'assistant',\n      content: null,\n      tool_calls: pendingToolCalls,\n    });\n  }\n\n  return messages;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "45A34764E7499FFC64756E2164756E21",
+  "names": []
+}

package/dist/context.d.ts

@@ -0,0 +1,35 @@
+import { type ConversationEnvironment } from './environment';
+import type { Conversation, Message } from './types';
+/**
+ * Returns the last N messages from the conversation.
+ * By default excludes system messages and hidden messages.
+ */
+export declare function getRecentMessages(conversation: Conversation, count: number, options?: {
+    includeHidden?: boolean;
+    includeSystem?: boolean;
+}): ReadonlyArray<Message>;
+/**
+ * Truncates conversation to keep only messages from the specified position onwards.
+ * Optionally preserves system messages regardless of position.
+ */
+export declare function truncateFromPosition(conversation: Conversation, position: number, options?: {
+    preserveSystemMessages?: boolean;
+}, environment?: Partial<ConversationEnvironment>): Conversation;
+/**
+ * Estimates total tokens in a conversation using the provided estimator function.
+ */
+export declare function estimateConversationTokens(conversation: Conversation, estimateTokens: (message: Message) => number): number;
+/**
+ * Simple character-based token estimator.
+ * Approximates ~4 characters per token (rough average for English text).
+ */
+export declare function simpleTokenEstimator(message: Message): number;
+/**
+ * Truncates conversation to fit within an estimated token limit.
+ * Removes oldest messages first while preserving system messages and optionally the last N messages.
+ */
+export declare function truncateToTokenLimit(conversation: Conversation, maxTokens: number, estimateTokens: (message: Message) => number, options?: {
+    preserveSystemMessages?: boolean;
+    preserveLastN?: number;
+}, environment?: Partial<ConversationEnvironment>): Conversation;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGrD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACA,aAAa,CAAC,OAAO,CAAC,CAWxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,EACD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAqCd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAC3C,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,EAC5C,OAAO,CAAC,EAAE;IACR,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,EACD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CA6Gd"}

package/dist/conversation/append.d.ts

@@ -0,0 +1,25 @@
+import { type ConversationEnvironment } from '../environment';
+import type { Conversation, MessageInput } from '../types';
+/**
+ * Appends one or more messages to a conversation.
+ * Validates that tool results reference existing function calls.
+ * Returns a new immutable conversation with the messages added.
+ */
+export declare function appendMessages(conversation: Conversation, ...inputs: MessageInput[]): Conversation;
+export declare function appendMessages(conversation: Conversation, ...inputsAndEnvironment: [
+    ...MessageInput[],
+    Partial<ConversationEnvironment> | undefined
+]): Conversation;
+/**
+ * Appends a user message to the conversation.
+ */
+export declare function appendUserMessage(conversation: Conversation, content: MessageInput['content'], metadata?: Record<string, unknown>, environment?: Partial<ConversationEnvironment>): Conversation;
+/**
+ * Appends an assistant message to the conversation.
+ */
+export declare function appendAssistantMessage(conversation: Conversation, content: MessageInput['content'], metadata?: Record<string, unknown>, environment?: Partial<ConversationEnvironment>): Conversation;
+/**
+ * Appends a system message to the conversation.
+ */
+export declare function appendSystemMessage(conversation: Conversation, content: string, metadata?: Record<string, unknown>, environment?: Partial<ConversationEnvironment>): Conversation;
+//# sourceMappingURL=append.d.ts.map

package/dist/conversation/append.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append.d.ts","sourceRoot":"","sources":["../../src/conversation/append.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,uBAAuB,EAG7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAW,YAAY,EAAE,MAAM,UAAU,CAAC;AAmCpE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,EAC1B,GAAG,MAAM,EAAE,YAAY,EAAE,GACxB,YAAY,CAAC;AAChB,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,EAC1B,GAAG,oBAAoB,EAAE;IACvB,GAAG,YAAY,EAAE;IACjB,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS;CAC7C,GACA,YAAY,CAAC;AA2DhB;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAMd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAEd"}

package/dist/conversation/create.d.ts

@@ -0,0 +1,14 @@
+import { type ConversationEnvironment } from '../environment';
+import type { Conversation, ConversationStatus } from '../types';
+/**
+ * Creates a new empty conversation with the specified options.
+ * Returns an immutable conversation object with timestamps set to the current time.
+ */
+export declare function createConversation(options?: {
+    id?: string;
+    title?: string;
+    status?: ConversationStatus;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+}, environment?: Partial<ConversationEnvironment>): Conversation;
+//# sourceMappingURL=create.d.ts.map

package/dist/conversation/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/conversation/create.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGjE;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE;IACR,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,EACD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAcd"}

package/dist/conversation/index.d.ts

@@ -0,0 +1,9 @@
+export type { ConversationEnvironment } from '../environment';
+export { createConversation } from './create';
+export { appendAssistantMessage, appendMessages, appendSystemMessage, appendUserMessage, } from './append';
+export { computeConversationStatistics, getConversationMessages, getMessageAtPosition, getMessageByIdentifier, searchConversationMessages, } from './query';
+export { collapseSystemMessages, getFirstSystemMessage, getSystemMessages, hasSystemMessage, prependSystemMessage, replaceSystemMessage, } from './system-messages';
+export { redactMessageAtPosition } from './modify';
+export { deserializeConversation, serializeConversation } from './serialization';
+export { toChatMessages } from './transform';
+//# sourceMappingURL=index.d.ts.map

package/dist/conversation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/conversation/modify.d.ts

@@ -0,0 +1,9 @@
+import { type ConversationEnvironment } from '../environment';
+import type { Conversation } from '../types';
+/**
+ * Replaces the content of a message at the specified position with a placeholder.
+ * Preserves all other message properties except toolCall, toolResult, and tokenUsage.
+ * Throws if the position is out of bounds.
+ */
+export declare function redactMessageAtPosition(conversation: Conversation, position: number, placeholder?: string, environment?: Partial<ConversationEnvironment>): Conversation;
+//# sourceMappingURL=modify.d.ts.map

package/dist/conversation/modify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modify.d.ts","sourceRoot":"","sources":["../../src/conversation/modify.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,UAAU,CAAC;AAGtD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAqB,EAClC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CA2Bd"}

package/dist/conversation/query.d.ts

@@ -0,0 +1,34 @@
+import type { Conversation, Message } from '../types';
+/**
+ * Returns all messages from a conversation.
+ * By default excludes hidden messages unless includeHidden is true.
+ */
+export declare function getConversationMessages(conversation: Conversation, options?: {
+    includeHidden?: boolean;
+}): ReadonlyArray<Message>;
+/**
+ * Returns the message at the specified position index.
+ * Returns undefined if no message exists at that position.
+ */
+export declare function getMessageAtPosition(conversation: Conversation, position: number): Message | undefined;
+/**
+ * Finds a message by its unique identifier.
+ * Returns undefined if no message with that ID exists.
+ */
+export declare function getMessageByIdentifier(conversation: Conversation, id: string): Message | undefined;
+/**
+ * Filters messages using a custom predicate function.
+ * Returns all messages for which the predicate returns true.
+ */
+export declare function searchConversationMessages(conversation: Conversation, predicate: (m: Message) => boolean): Message[];
+/**
+ * Computes statistics about a conversation's messages.
+ * Returns totals, counts by role, hidden message count, and image count.
+ */
+export declare function computeConversationStatistics(conversation: Conversation): {
+    total: number;
+    byRole: Record<string, number>;
+    hidden: number;
+    withImages: number;
+};
+//# sourceMappingURL=query.d.ts.map

package/dist/conversation/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/conversation/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGtD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,aAAa,CAAC,OAAO,CAAC,CAKxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,GAAG,SAAS,CAErB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE,MAAM,GACT,OAAO,GAAG,SAAS,CAErB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GACjC,OAAO,EAAE,CAEX;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,YAAY,GAAG;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAiBA"}