conversationalist 0.0.7 → 0.0.9

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

@@ -1,10 +1,11 @@
 {
   "version": 3,
-  "sources": ["../../../src/adapters/anthropic/index.ts"],
+  "sources": ["../../../src/utilities/message-store.ts", "../../../src/adapters/anthropic/index.ts"],
   "sourcesContent": [
-    "import type { MultiModalContent } from '@lasercat/homogenaize';\n\nimport type { Conversation, Message, ToolCall, ToolResult } from '../../types';\n\n/**\n * Anthropic text content block.\n */\nexport interface AnthropicTextBlock {\n  type: 'text';\n  text: string;\n}\n\n/**\n * Anthropic image content block.\n */\nexport interface AnthropicImageBlock {\n  type: 'image';\n  source: {\n    type: 'base64' | 'url';\n    media_type?: string;\n    data?: string;\n    url?: string;\n  };\n}\n\n/**\n * Anthropic tool use content block.\n */\nexport interface AnthropicToolUseBlock {\n  type: 'tool_use';\n  id: string;\n  name: string;\n  input: unknown;\n}\n\n/**\n * Anthropic tool result content block.\n */\nexport interface AnthropicToolResultBlock {\n  type: 'tool_result';\n  tool_use_id: string;\n  content: string;\n  is_error?: boolean;\n}\n\n/**\n * Anthropic content block union type.\n */\nexport type AnthropicContentBlock =\n  | AnthropicTextBlock\n  | AnthropicImageBlock\n  | AnthropicToolUseBlock\n  | AnthropicToolResultBlock;\n\n/**\n * Anthropic message format for the Messages API.\n */\nexport interface AnthropicMessage {\n  role: 'user' | 'assistant';\n  content: string | AnthropicContentBlock[];\n}\n\n/**\n * Result of converting a conversation to Anthropic format.\n * System messages are extracted separately since Anthropic uses a top-level system parameter.\n */\nexport interface AnthropicConversation {\n  system?: string;\n  messages: AnthropicMessage[];\n}\n\n/**\n * Converts internal multi-modal content to Anthropic content blocks.\n */\nfunction toAnthropicContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n): string | AnthropicContentBlock[] {\n  if (typeof content === 'string') {\n    return content;\n  }\n\n  const blocks: AnthropicContentBlock[] = [];\n  for (const part of content) {\n    if (part.type === 'text') {\n      blocks.push({ type: 'text', text: part.text ?? '' });\n    } else if (part.type === 'image') {\n      // Anthropic supports both URL and base64\n      const url = part.url ?? '';\n      if (url.startsWith('data:')) {\n        // Base64 data URL\n        const matches = url.match(/^data:([^;]+);base64,(.+)$/);\n        if (matches && matches[1] && matches[2]) {\n          blocks.push({\n            type: 'image',\n            source: {\n              type: 'base64',\n              media_type: matches[1],\n              data: matches[2],\n            },\n          });\n        }\n      } else {\n        // Regular URL\n        blocks.push({\n          type: 'image',\n          source: {\n            type: 'url',\n            url,\n          },\n        });\n      }\n    }\n  }\n\n  return blocks.length === 1 && blocks[0]?.type === 'text' ? blocks[0].text : blocks;\n}\n\n/**\n * Converts an internal ToolCall to Anthropic tool_use block.\n */\nfunction toToolUseBlock(toolCall: ToolCall): AnthropicToolUseBlock {\n  return {\n    type: 'tool_use',\n    id: toolCall.id,\n    name: toolCall.name,\n    input:\n      typeof toolCall.arguments === 'string'\n        ? JSON.parse(toolCall.arguments)\n        : toolCall.arguments,\n  };\n}\n\n/**\n * Converts an internal ToolResult to Anthropic tool_result block.\n */\nfunction toToolResultBlock(toolResult: ToolResult): AnthropicToolResultBlock {\n  const result: AnthropicToolResultBlock = {\n    type: 'tool_result',\n    tool_use_id: toolResult.callId,\n    content:\n      typeof toolResult.content === 'string'\n        ? toolResult.content\n        : JSON.stringify(toolResult.content),\n  };\n\n  if (toolResult.outcome === 'error') {\n    result.is_error = true;\n  }\n\n  return result;\n}\n\n/**\n * Collects system message content from a conversation.\n */\nfunction extractSystemContent(messages: ReadonlyArray<Message>): string | 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: string[] = [];\n  for (const msg of systemMessages) {\n    if (typeof msg.content === 'string') {\n      parts.push(msg.content);\n    } else {\n      for (const part of msg.content) {\n        if (part.type === 'text') {\n          parts.push(part.text ?? '');\n        }\n      }\n    }\n  }\n\n  return parts.join('\\n\\n');\n}\n\n/**\n * Converts a conversation to Anthropic Messages API format.\n * System messages are extracted to the top-level `system` field.\n * Tool calls become tool_use blocks, tool results become tool_result blocks.\n *\n * @example\n * ```ts\n * import { toAnthropicMessages } from 'conversationalist/anthropic';\n *\n * const { system, messages } = toAnthropicMessages(conversation);\n * const response = await anthropic.messages.create({\n *   model: 'claude-3-opus-20240229',\n *   system,\n *   messages,\n * });\n * ```\n */\nexport function toAnthropicMessages(conversation: Conversation): AnthropicConversation {\n  const system = extractSystemContent(conversation.messages);\n  const messages: AnthropicMessage[] = [];\n\n  // Track pending content blocks to merge consecutive same-role messages\n  let currentRole: 'user' | 'assistant' | null = null;\n  let currentBlocks: AnthropicContentBlock[] = [];\n\n  const flushCurrent = () => {\n    if (currentRole && currentBlocks.length > 0) {\n      messages.push({\n        role: currentRole,\n        content:\n          currentBlocks.length === 1 && currentBlocks[0]?.type === 'text'\n            ? currentBlocks[0].text\n            : currentBlocks,\n      });\n      currentBlocks = [];\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' | 'assistant';\n    let blocks: AnthropicContentBlock[] = [];\n\n    if (message.role === 'user') {\n      targetRole = 'user';\n      const content = toAnthropicContent(message.content);\n      if (typeof content === 'string') {\n        blocks = [{ type: 'text', text: content }];\n      } else {\n        blocks = content;\n      }\n    } else if (message.role === 'assistant') {\n      targetRole = 'assistant';\n      const content = toAnthropicContent(message.content);\n      if (typeof content === 'string') {\n        blocks = [{ type: 'text', text: content }];\n      } else {\n        blocks = content;\n      }\n    } else if (message.role === 'tool-use' && message.toolCall) {\n      targetRole = 'assistant';\n      blocks = [toToolUseBlock(message.toolCall)];\n    } else if (message.role === 'tool-result' && message.toolResult) {\n      targetRole = 'user';\n      blocks = [toToolResultBlock(message.toolResult)];\n    } else {\n      continue;\n    }\n\n    // Merge with current or start new\n    if (currentRole === targetRole) {\n      currentBlocks.push(...blocks);\n    } else {\n      flushCurrent();\n      currentRole = targetRole;\n      currentBlocks = blocks;\n    }\n  }\n\n  flushCurrent();\n\n  const result: AnthropicConversation = { messages };\n  if (system !== undefined) {\n    result.system = system;\n  }\n  return result;\n}\n"
+    "import type { Conversation, Message } from '../types';\n\nexport function getOrderedMessages(conversation: Conversation): Message[] {\n  const ordered: Message[] = [];\n  for (const id of conversation.ids) {\n    const message = conversation.messages[id];\n    if (message) {\n      ordered.push(message);\n    }\n  }\n  return ordered;\n}\n\nexport function toIdRecord<T extends { id: string }>(\n  items: readonly T[],\n): Record<string, T> {\n  const record: Record<string, T> = {};\n  for (const item of items) {\n    record[item.id] = item;\n  }\n  return record;\n}\n",
+    "import type { MultiModalContent } from '@lasercat/homogenaize';\n\nimport type { Conversation, Message, ToolCall, ToolResult } from '../../types';\nimport { getOrderedMessages } from '../../utilities/message-store';\n\n/**\n * Anthropic text content block.\n */\nexport interface AnthropicTextBlock {\n  type: 'text';\n  text: string;\n}\n\n/**\n * Anthropic image content block.\n */\nexport interface AnthropicBase64ImageSource {\n  type: 'base64';\n  media_type: string;\n  data: string;\n}\n\nexport interface AnthropicUrlImageSource {\n  type: 'url';\n  url: string;\n}\n\nexport type AnthropicImageSource = AnthropicBase64ImageSource | AnthropicUrlImageSource;\n\nexport interface AnthropicImageBlock {\n  type: 'image';\n  source: AnthropicImageSource;\n}\n\n/**\n * Anthropic tool use content block.\n */\nexport interface AnthropicToolUseBlock {\n  type: 'tool_use';\n  id: string;\n  name: string;\n  input: unknown;\n}\n\n/**\n * Anthropic tool result content block.\n */\nexport interface AnthropicToolResultBlock {\n  type: 'tool_result';\n  tool_use_id: string;\n  content: string;\n  is_error?: boolean;\n}\n\n/**\n * Anthropic content block union type.\n */\nexport type AnthropicContentBlock =\n  | AnthropicTextBlock\n  | AnthropicImageBlock\n  | AnthropicToolUseBlock\n  | AnthropicToolResultBlock;\n\n/**\n * Anthropic message format for the Messages API.\n */\nexport interface AnthropicMessage {\n  role: 'user' | 'assistant';\n  content: string | AnthropicContentBlock[];\n}\n\n/**\n * Result of converting a conversation to Anthropic format.\n * System messages are extracted separately since Anthropic uses a top-level system parameter.\n */\nexport interface AnthropicConversation {\n  system?: string;\n  messages: AnthropicMessage[];\n}\n\n/**\n * Converts internal multi-modal content to Anthropic content blocks.\n */\nfunction toAnthropicContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n): string | AnthropicContentBlock[] {\n  if (typeof content === 'string') {\n    return content;\n  }\n\n  const blocks: AnthropicContentBlock[] = [];\n  for (const part of content) {\n    if (part.type === 'text') {\n      blocks.push({ type: 'text', text: part.text ?? '' });\n    } else if (part.type === 'image') {\n      // Anthropic supports both URL and base64\n      const url = part.url ?? '';\n      if (url.startsWith('data:')) {\n        // Base64 data URL\n        const matches = url.match(/^data:([^;]+);base64,(.+)$/);\n        if (matches && matches[1] && matches[2]) {\n          blocks.push({\n            type: 'image',\n            source: {\n              type: 'base64',\n              media_type: matches[1],\n              data: matches[2],\n            },\n          });\n        }\n      } else {\n        // Regular URL\n        blocks.push({\n          type: 'image',\n          source: {\n            type: 'url',\n            url,\n          },\n        });\n      }\n    }\n  }\n\n  return blocks.length === 1 && blocks[0]?.type === 'text' ? blocks[0].text : blocks;\n}\n\n/**\n * Converts an internal ToolCall to Anthropic tool_use block.\n */\nfunction toToolUseBlock(toolCall: ToolCall): AnthropicToolUseBlock {\n  return {\n    type: 'tool_use',\n    id: toolCall.id,\n    name: toolCall.name,\n    input:\n      typeof toolCall.arguments === 'string'\n        ? JSON.parse(toolCall.arguments)\n        : toolCall.arguments,\n  };\n}\n\n/**\n * Converts an internal ToolResult to Anthropic tool_result block.\n */\nfunction toToolResultBlock(toolResult: ToolResult): AnthropicToolResultBlock {\n  const result: AnthropicToolResultBlock = {\n    type: 'tool_result',\n    tool_use_id: toolResult.callId,\n    content:\n      typeof toolResult.content === 'string'\n        ? toolResult.content\n        : JSON.stringify(toolResult.content),\n  };\n\n  if (toolResult.outcome === 'error') {\n    result.is_error = true;\n  }\n\n  return result;\n}\n\n/**\n * Collects system message content from a conversation.\n */\nfunction extractSystemContent(messages: ReadonlyArray<Message>): string | 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: string[] = [];\n  for (const msg of systemMessages) {\n    if (typeof msg.content === 'string') {\n      parts.push(msg.content);\n    } else {\n      for (const part of msg.content) {\n        if (part.type === 'text') {\n          parts.push(part.text ?? '');\n        }\n      }\n    }\n  }\n\n  return parts.join('\\n\\n');\n}\n\n/**\n * Converts a conversation to Anthropic Messages API format.\n * System messages are extracted to the top-level `system` field.\n * Tool calls become tool_use blocks, tool results become tool_result blocks.\n *\n * @example\n * ```ts\n * import { toAnthropicMessages } from 'conversationalist/anthropic';\n *\n * const { system, messages } = toAnthropicMessages(conversation);\n * const response = await anthropic.messages.create({\n *   model: 'claude-3-opus-20240229',\n *   system,\n *   messages,\n * });\n * ```\n */\nexport function toAnthropicMessages(conversation: Conversation): AnthropicConversation {\n  const ordered = getOrderedMessages(conversation);\n  const system = extractSystemContent(ordered);\n  const messages: AnthropicMessage[] = [];\n\n  // Track pending content blocks to merge consecutive same-role messages\n  let currentRole: 'user' | 'assistant' | null = null;\n  let currentBlocks: AnthropicContentBlock[] = [];\n\n  const flushCurrent = () => {\n    if (currentRole && currentBlocks.length > 0) {\n      messages.push({\n        role: currentRole,\n        content:\n          currentBlocks.length === 1 && currentBlocks[0]?.type === 'text'\n            ? currentBlocks[0].text\n            : currentBlocks,\n      });\n      currentBlocks = [];\n    }\n    currentRole = null;\n  };\n\n  for (const message of ordered) {\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' | 'assistant';\n    let blocks: AnthropicContentBlock[] = [];\n\n    if (message.role === 'user') {\n      targetRole = 'user';\n      const content = toAnthropicContent(message.content);\n      if (typeof content === 'string') {\n        blocks = [{ type: 'text', text: content }];\n      } else {\n        blocks = content;\n      }\n    } else if (message.role === 'assistant') {\n      targetRole = 'assistant';\n      const content = toAnthropicContent(message.content);\n      if (typeof content === 'string') {\n        blocks = [{ type: 'text', text: content }];\n      } else {\n        blocks = content;\n      }\n    } else if (message.role === 'tool-use' && message.toolCall) {\n      targetRole = 'assistant';\n      blocks = [toToolUseBlock(message.toolCall)];\n    } else if (message.role === 'tool-result' && message.toolResult) {\n      targetRole = 'user';\n      blocks = [toToolResultBlock(message.toolResult)];\n    } else {\n      continue;\n    }\n\n    // Merge with current or start new\n    if (currentRole === targetRole) {\n      currentBlocks.push(...blocks);\n    } else {\n      flushCurrent();\n      currentRole = targetRole;\n      currentBlocks = blocks;\n    }\n  }\n\n  flushCurrent();\n\n  const result: AnthropicConversation = { messages };\n  if (system !== undefined) {\n    result.system = system;\n  }\n  return result;\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "46DDFFB8D921BA7364756E2164756E21",
+  "mappings": "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",
+  "debugId": "77199835081EDC2864756E2164756E21",
   "names": []
 }

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

@@ -19,7 +19,7 @@ export interface GeminiInlineDataPart {
  */
 export interface GeminiFileDataPart {
     fileData: {
-        mimeType?: string;
+        mimeType: string;
         fileUri: string;
     };
 }
@@ -38,7 +38,7 @@ export interface GeminiFunctionCallPart {
 export interface GeminiFunctionResponsePart {
     functionResponse: {
         name: string;
-        response: unknown;
+        response: Record<string, unknown>;
     };
 }
 /**

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/gemini/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAG/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,EAAE,MAAM,CAAC;QACjB,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,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,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;AAkJD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,kBAAkB,CAmF/E"}

package/dist/adapters/gemini/index.js

@@ -1,4 +1,46 @@
+// src/utilities/message-store.ts
+function getOrderedMessages(conversation) {
+  const ordered = [];
+  for (const id of conversation.ids) {
+    const message = conversation.messages[id];
+    if (message) {
+      ordered.push(message);
+    }
+  }
+  return ordered;
+}
+
 // src/adapters/gemini/index.ts
+var DEFAULT_FILE_MIME_TYPE = "application/octet-stream";
+var MIME_TYPE_BY_EXTENSION = {
+  bmp: "image/bmp",
+  gif: "image/gif",
+  heic: "image/heic",
+  heif: "image/heif",
+  jpeg: "image/jpeg",
+  jpg: "image/jpeg",
+  png: "image/png",
+  svg: "image/svg+xml",
+  webp: "image/webp"
+};
+function inferMimeType(url) {
+  const trimmed = url.split("#")[0]?.split("?")[0] ?? "";
+  const dotIndex = trimmed.lastIndexOf(".");
+  if (dotIndex === -1) {
+    return;
+  }
+  const extension = trimmed.slice(dotIndex + 1).toLowerCase();
+  return MIME_TYPE_BY_EXTENSION[extension];
+}
+function resolveMimeType(url, explicit) {
+  return explicit ?? inferMimeType(url) ?? DEFAULT_FILE_MIME_TYPE;
+}
+function normalizeGeminiResponse(content) {
+  if (content !== null && typeof content === "object") {
+    return content;
+  }
+  return { result: content };
+}
 function toGeminiParts(content) {
   if (typeof content === "string") {
     return content ? [{ text: content }] : [];
@@ -22,10 +64,10 @@ function toGeminiParts(content) {
           });
         }
       } else {
-        const fileData = { fileUri: url };
-        if (part.mimeType !== undefined) {
-          fileData.mimeType = part.mimeType;
-        }
+        const fileData = {
+          fileUri: url,
+          mimeType: resolveMimeType(url, part.mimeType)
+        };
         parts.push({ fileData });
       }
     }
@@ -54,7 +96,7 @@ function toFunctionResponsePart(toolResult, functionName) {
   return {
     functionResponse: {
       name: functionName,
-      response: toolResult.content
+      response: normalizeGeminiResponse(toolResult.content)
     }
   };
 }
@@ -76,9 +118,10 @@ function extractSystemInstruction(messages) {
   };
 }
 function toGeminiMessages(conversation) {
-  const systemInstruction = extractSystemInstruction(conversation.messages);
+  const ordered = getOrderedMessages(conversation);
+  const systemInstruction = extractSystemInstruction(ordered);
   const toolCallNames = new Map;
-  for (const message of conversation.messages) {
+  for (const message of ordered) {
     if (message.role === "tool-use" && message.toolCall) {
       toolCallNames.set(message.toolCall.id, message.toolCall.name);
     }
@@ -96,7 +139,7 @@ function toGeminiMessages(conversation) {
     }
     currentRole = null;
   };
-  for (const message of conversation.messages) {
+  for (const message of ordered) {
     if (message.hidden)
       continue;
     if (message.role === "system" || message.role === "developer") {
@@ -145,4 +188,4 @@ export {
   toGeminiMessages
 };
 
-//# debugId=0C64ADAD8EC3A21464756E2164756E21
+//# debugId=88465330F0A95D8664756E2164756E21

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

@@ -1,10 +1,11 @@
 {
   "version": 3,
-  "sources": ["../../../src/adapters/gemini/index.ts"],
+  "sources": ["../../../src/utilities/message-store.ts", "../../../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"
+    "import type { Conversation, Message } from '../types';\n\nexport function getOrderedMessages(conversation: Conversation): Message[] {\n  const ordered: Message[] = [];\n  for (const id of conversation.ids) {\n    const message = conversation.messages[id];\n    if (message) {\n      ordered.push(message);\n    }\n  }\n  return ordered;\n}\n\nexport function toIdRecord<T extends { id: string }>(\n  items: readonly T[],\n): Record<string, T> {\n  const record: Record<string, T> = {};\n  for (const item of items) {\n    record[item.id] = item;\n  }\n  return record;\n}\n",
+    "import type { MultiModalContent } from '@lasercat/homogenaize';\n\nimport type { Conversation, Message, ToolCall, ToolResult } from '../../types';\nimport { getOrderedMessages } from '../../utilities/message-store';\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: Record<string, 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\nconst DEFAULT_FILE_MIME_TYPE = 'application/octet-stream';\n\nconst MIME_TYPE_BY_EXTENSION: Record<string, string> = {\n  bmp: 'image/bmp',\n  gif: 'image/gif',\n  heic: 'image/heic',\n  heif: 'image/heif',\n  jpeg: 'image/jpeg',\n  jpg: 'image/jpeg',\n  png: 'image/png',\n  svg: 'image/svg+xml',\n  webp: 'image/webp',\n};\n\nfunction inferMimeType(url: string): string | undefined {\n  const trimmed = url.split('#')[0]?.split('?')[0] ?? '';\n  const dotIndex = trimmed.lastIndexOf('.');\n  if (dotIndex === -1) {\n    return undefined;\n  }\n  const extension = trimmed.slice(dotIndex + 1).toLowerCase();\n  return MIME_TYPE_BY_EXTENSION[extension];\n}\n\nfunction resolveMimeType(url: string, explicit?: string): string {\n  return explicit ?? inferMimeType(url) ?? DEFAULT_FILE_MIME_TYPE;\n}\n\nfunction normalizeGeminiResponse(content: unknown): Record<string, unknown> {\n  if (content !== null && typeof content === 'object') {\n    return content as Record<string, unknown>;\n  }\n  return { result: content };\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'] = {\n          fileUri: url,\n          mimeType: resolveMimeType(url, 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: normalizeGeminiResponse(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 ordered = getOrderedMessages(conversation);\n  const systemInstruction = extractSystemInstruction(ordered);\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 ordered) {\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 ordered) {\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": ";AAgFA,SAAS,aAAa,CAAC,SAAkE;AAAA,EACvF,IAAI,OAAO,YAAY,UAAU;AAAA,IAC/B,OAAO,UAAU,CAAC,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC;AAAA,EAC1C;AAAA,EAEA,MAAM,QAAsB,CAAC;AAAA,EAC7B,WAAW,QAAQ,SAAS;AAAA,IAC1B,IAAI,KAAK,SAAS,QAAQ;AAAA,MACxB,IAAI,KAAK,MAAM;AAAA,QACb,MAAM,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;AAAA,MAChC;AAAA,IACF,EAAO,SAAI,KAAK,SAAS,SAAS;AAAA,MAChC,MAAM,MAAM,KAAK,OAAO;AAAA,MACxB,IAAI,IAAI,WAAW,OAAO,GAAG;AAAA,QAE3B,MAAM,UAAU,IAAI,MAAM,4BAA4B;AAAA,QACtD,IAAI,SAAS;AAAA,UACX,MAAM,KAAK;AAAA,YACT,YAAY;AAAA,cACV,UAAU,QAAQ;AAAA,cAClB,MAAM,QAAQ;AAAA,YAChB;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF,EAAO;AAAA,QAEL,MAAM,WAA2C,EAAE,SAAS,IAAI;AAAA,QAChE,IAAI,KAAK,aAAa,WAAW;AAAA,UAC/B,SAAS,WAAW,KAAK;AAAA,QAC3B;AAAA,QACA,MAAM,KAAK,EAAE,SAAS,CAAC;AAAA;AAAA,IAE3B;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAMT,SAAS,kBAAkB,CAAC,UAA4C;AAAA,EACtE,IAAI;AAAA,EACJ,IAAI,OAAO,SAAS,cAAc,UAAU;AAAA,IAC1C,IAAI;AAAA,MACF,OAAO,KAAK,MAAM,SAAS,SAAS;AAAA,MACpC,MAAM;AAAA,MACN,OAAO,EAAE,MAAM,SAAS,UAAU;AAAA;AAAA,EAEtC,EAAO;AAAA,IACL,OAAO,SAAS;AAAA;AAAA,EAGlB,OAAO;AAAA,IACL,cAAc;AAAA,MACZ,MAAM,SAAS;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAAA;AAOF,SAAS,sBAAsB,CAC7B,YACA,cAC4B;AAAA,EAC5B,OAAO;AAAA,IACL,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,UAAU,WAAW;AAAA,IACvB;AAAA,EACF;AAAA;AAMF,SAAS,wBAAwB,CAC/B,UAC2B;AAAA,EAC3B,MAAM,iBAAiB,SAAS,OAC9B,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,SAAS,gBAAgB,CAAC,EAAE,MAC/D;AAAA,EAEA,IAAI,eAAe,WAAW,GAAG;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,QAAsB,CAAC;AAAA,EAC7B,WAAW,OAAO,gBAAgB;AAAA,IAChC,MAAM,KAAK,GAAG,cAAc,IAAI,OAAO,CAAC;AAAA,EAC1C;AAAA,EAEA,IAAI,MAAM,WAAW,GAAG;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AAAA;AAmBK,SAAS,gBAAgB,CAAC,cAAgD;AAAA,EAC/E,MAAM,oBAAoB,yBAAyB,aAAa,QAAQ;AAAA,EAGxE,MAAM,gBAAgB,IAAI;AAAA,EAC1B,WAAW,WAAW,aAAa,UAAU;AAAA,IAC3C,IAAI,QAAQ,SAAS,cAAc,QAAQ,UAAU;AAAA,MACnD,cAAc,IAAI,QAAQ,SAAS,IAAI,QAAQ,SAAS,IAAI;AAAA,IAC9D;AAAA,EACF;AAAA,EAEA,MAAM,WAA4B,CAAC;AAAA,EAGnC,IAAI,cAAuC;AAAA,EAC3C,IAAI,eAA6B,CAAC;AAAA,EAElC,MAAM,eAAe,MAAM;AAAA,IACzB,IAAI,eAAe,aAAa,SAAS,GAAG;AAAA,MAC1C,SAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,OAAO;AAAA,MACT,CAAC;AAAA,MACD,eAAe,CAAC;AAAA,IAClB;AAAA,IACA,cAAc;AAAA;AAAA,EAGhB,WAAW,WAAW,aAAa,UAAU;AAAA,IAC3C,IAAI,QAAQ;AAAA,MAAQ;AAAA,IAGpB,IAAI,QAAQ,SAAS,YAAY,QAAQ,SAAS,aAAa;AAAA,MAC7D;AAAA,IACF;AAAA,IAGA,IAAI,QAAQ,SAAS,YAAY;AAAA,MAC/B;AAAA,IACF;AAAA,IAEA,IAAI;AAAA,IACJ,IAAI,QAAsB,CAAC;AAAA,IAE3B,IAAI,QAAQ,SAAS,QAAQ;AAAA,MAC3B,aAAa;AAAA,MACb,QAAQ,cAAc,QAAQ,OAAO;AAAA,IACvC,EAAO,SAAI,QAAQ,SAAS,aAAa;AAAA,MACvC,aAAa;AAAA,MACb,QAAQ,cAAc,QAAQ,OAAO;AAAA,IACvC,EAAO,SAAI,QAAQ,SAAS,cAAc,QAAQ,UAAU;AAAA,MAC1D,aAAa;AAAA,MACb,QAAQ,CAAC,mBAAmB,QAAQ,QAAQ,CAAC;AAAA,IAC/C,EAAO,SAAI,QAAQ,SAAS,iBAAiB,QAAQ,YAAY;AAAA,MAC/D,aAAa;AAAA,MACb,MAAM,eAAe,cAAc,IAAI,QAAQ,WAAW,MAAM,KAAK;AAAA,MACrE,QAAQ,CAAC,uBAAuB,QAAQ,YAAY,YAAY,CAAC;AAAA,IACnE,EAAO;AAAA,MACL;AAAA;AAAA,IAGF,IAAI,MAAM,WAAW,GAAG;AAAA,MACtB;AAAA,IACF;AAAA,IAGA,IAAI,gBAAgB,YAAY;AAAA,MAC9B,aAAa,KAAK,GAAG,KAAK;AAAA,IAC5B,EAAO;AAAA,MACL,aAAa;AAAA,MACb,cAAc;AAAA,MACd,eAAe;AAAA;AAAA,EAEnB;AAAA,EAEA,aAAa;AAAA,EAEb,MAAM,SAA6B,EAAE,SAAS;AAAA,EAC9C,IAAI,sBAAsB,WAAW;AAAA,IACnC,OAAO,oBAAoB;AAAA,EAC7B;AAAA,EACA,OAAO;AAAA;",
-  "debugId": "0C64ADAD8EC3A21464756E2164756E21",
+  "mappings": "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",
+  "debugId": "88465330F0A95D8664756E2164756E21",
   "names": []
 }

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

@@ -32,15 +32,42 @@ export interface OpenAIToolCall {
     };
 }
 /**
- * OpenAI message format for the Chat Completions API.
+ * OpenAI system message format for the Chat Completions API.
+ */
+export interface OpenAISystemMessage {
+    role: 'system';
+    content: string | OpenAITextContentPart[];
+    name?: string;
+}
+/**
+ * OpenAI user message format for the Chat Completions API.
  */
-export interface OpenAIMessage {
-    role: 'system' | 'user' | 'assistant' | 'tool';
-    content: string | OpenAIContentPart[] | null;
+export interface OpenAIUserMessage {
+    role: 'user';
+    content: string | OpenAIContentPart[];
+    name?: string;
+}
+/**
+ * OpenAI assistant message format for the Chat Completions API.
+ */
+export interface OpenAIAssistantMessage {
+    role: 'assistant';
+    content: string | OpenAITextContentPart[] | null;
     name?: string;
     tool_calls?: OpenAIToolCall[];
-    tool_call_id?: string;
 }
+/**
+ * OpenAI tool message format for the Chat Completions API.
+ */
+export interface OpenAIToolMessage {
+    role: 'tool';
+    content: string | OpenAITextContentPart[];
+    tool_call_id: string;
+}
+/**
+ * OpenAI message format for the Chat Completions API.
+ */
+export type OpenAIMessage = OpenAISystemMessage | OpenAIUserMessage | OpenAIAssistantMessage | OpenAIToolMessage;
 /**
  * Converts a conversation to OpenAI Chat Completions API message format.
  * Handles role mapping, tool calls, and multi-modal content.

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/openai/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAG/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,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,iBAAiB,CAAC;AA4ItB;;;;;;;;;;;;;;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

@@ -1,20 +1,42 @@
+// src/utilities/message-store.ts
+function getOrderedMessages(conversation) {
+  const ordered = [];
+  for (const id of conversation.ids) {
+    const message = conversation.messages[id];
+    if (message) {
+      ordered.push(message);
+    }
+  }
+  return ordered;
+}
+
 // src/adapters/openai/index.ts
-function toOpenAIContent(content) {
+function toOpenAIContent(content, options = {}) {
   if (typeof content === "string") {
     return content;
   }
+  const allowImages = options.allowImages ?? true;
   const parts = [];
   for (const part of content) {
     if (part.type === "text") {
       parts.push({ type: "text", text: part.text ?? "" });
-    } else if (part.type === "image") {
+    } else if (part.type === "image" && allowImages) {
       parts.push({
         type: "image_url",
         image_url: { url: part.url ?? "" }
       });
     }
   }
-  return parts.length === 1 && parts[0]?.type === "text" ? parts[0].text : parts;
+  if (parts.length === 0) {
+    return "";
+  }
+  if (parts.length === 1 && parts[0]?.type === "text") {
+    return parts[0].text;
+  }
+  return allowImages ? parts : parts;
+}
+function toOpenAITextContent(content) {
+  return toOpenAIContent(content, { allowImages: false });
 }
 function toOpenAIToolCall(toolCall) {
   return {
@@ -35,7 +57,7 @@ function convertMessage(message) {
     case "developer":
       return {
         role: "system",
-        content: toOpenAIContent(message.content)
+        content: toOpenAITextContent(message.content)
       };
     case "user":
       return {
@@ -45,7 +67,7 @@ function convertMessage(message) {
     case "assistant":
       return {
         role: "assistant",
-        content: toOpenAIContent(message.content)
+        content: toOpenAITextContent(message.content)
       };
     case "tool-use":
       if (!message.toolCall) {
@@ -79,7 +101,7 @@ function stringifyToolResult(result) {
 }
 function toOpenAIMessages(conversation) {
   const messages = [];
-  for (const message of conversation.messages) {
+  for (const message of getOrderedMessages(conversation)) {
     const converted = convertMessage(message);
     if (converted) {
       messages.push(converted);
@@ -90,7 +112,7 @@ function toOpenAIMessages(conversation) {
 function toOpenAIMessagesGrouped(conversation) {
   const messages = [];
   let pendingToolCalls = [];
-  for (const message of conversation.messages) {
+  for (const message of getOrderedMessages(conversation)) {
     if (message.hidden)
       continue;
     if (message.role === "tool-use" && message.toolCall) {
@@ -124,4 +146,4 @@ export {
   toOpenAIMessages
 };
 
-//# debugId=45A34764E7499FFC64756E2164756E21
+//# debugId=76C027000C92020164756E2164756E21

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

@@ -1,10 +1,11 @@
 {
   "version": 3,
-  "sources": ["../../../src/adapters/openai/index.ts"],
+  "sources": ["../../../src/utilities/message-store.ts", "../../../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"
+    "import type { Conversation, Message } from '../types';\n\nexport function getOrderedMessages(conversation: Conversation): Message[] {\n  const ordered: Message[] = [];\n  for (const id of conversation.ids) {\n    const message = conversation.messages[id];\n    if (message) {\n      ordered.push(message);\n    }\n  }\n  return ordered;\n}\n\nexport function toIdRecord<T extends { id: string }>(\n  items: readonly T[],\n): Record<string, T> {\n  const record: Record<string, T> = {};\n  for (const item of items) {\n    record[item.id] = item;\n  }\n  return record;\n}\n",
+    "import type { MultiModalContent } from '@lasercat/homogenaize';\n\nimport type { Conversation, Message, ToolCall, ToolResult } from '../../types';\nimport { getOrderedMessages } from '../../utilities/message-store';\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 system message format for the Chat Completions API.\n */\nexport interface OpenAISystemMessage {\n  role: 'system';\n  content: string | OpenAITextContentPart[];\n  name?: string;\n}\n\n/**\n * OpenAI user message format for the Chat Completions API.\n */\nexport interface OpenAIUserMessage {\n  role: 'user';\n  content: string | OpenAIContentPart[];\n  name?: string;\n}\n\n/**\n * OpenAI assistant message format for the Chat Completions API.\n */\nexport interface OpenAIAssistantMessage {\n  role: 'assistant';\n  content: string | OpenAITextContentPart[] | null;\n  name?: string;\n  tool_calls?: OpenAIToolCall[];\n}\n\n/**\n * OpenAI tool message format for the Chat Completions API.\n */\nexport interface OpenAIToolMessage {\n  role: 'tool';\n  content: string | OpenAITextContentPart[];\n  tool_call_id: string;\n}\n\n/**\n * OpenAI message format for the Chat Completions API.\n */\nexport type OpenAIMessage =\n  | OpenAISystemMessage\n  | OpenAIUserMessage\n  | OpenAIAssistantMessage\n  | OpenAIToolMessage;\n\n/**\n * Converts internal multi-modal content to OpenAI content parts format.\n */\nfunction toOpenAIContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n  options: { allowImages: false },\n): string | OpenAITextContentPart[];\nfunction toOpenAIContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n  options?: { allowImages?: true },\n): string | OpenAIContentPart[];\nfunction toOpenAIContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n  options: { allowImages?: boolean } = {},\n): string | OpenAIContentPart[] | OpenAITextContentPart[] {\n  if (typeof content === 'string') {\n    return content;\n  }\n\n  const allowImages = options.allowImages ?? true;\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' && allowImages) {\n      parts.push({\n        type: 'image_url',\n        image_url: { url: part.url ?? '' },\n      });\n    }\n  }\n\n  if (parts.length === 0) {\n    return '';\n  }\n\n  if (parts.length === 1 && parts[0]?.type === 'text') {\n    return parts[0].text;\n  }\n\n  return allowImages ? parts : (parts as OpenAITextContentPart[]);\n}\n\n/**\n * Converts internal multi-modal content to OpenAI text-only format.\n */\nfunction toOpenAITextContent(\n  content: string | ReadonlyArray<MultiModalContent>,\n): string | OpenAITextContentPart[] {\n  return toOpenAIContent(content, { allowImages: false });\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: toOpenAITextContent(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: toOpenAITextContent(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 getOrderedMessages(conversation)) {\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 getOrderedMessages(conversation)) {\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",
+  "mappings": "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",
+  "debugId": "76C027000C92020164756E2164756E21",
   "names": []
 }

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAG5B,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,cAAc,EAC/B,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,MAAM,CAqBR;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,eAAe,GAAG,cAAc,EACrD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAwId;AAED;;;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,CAkCd"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,uBAAuB,EAG5B,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAoB,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIvF,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAgChC;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,cAAc,EAC/B,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,MAAM,CAqBR;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,eAAe,GAAG,cAAc,EACrD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAmHd;AAED;;;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,CAwBd"}

package/dist/conversation/append.d.ts

@@ -1,5 +1,5 @@
 import { type ConversationEnvironment } from '../environment';
-import type { Conversation, MessageInput } from '../types';
+import type { Conversation, JSONValue, MessageInput } from '../types';
 /**
  * Appends one or more messages to a conversation.
  * Validates that tool results reference existing function calls.
@@ -13,13 +13,13 @@ export declare function appendMessages(conversation: Conversation, ...inputsAndE
 /**
  * Appends a user message to the conversation.
  */
-export declare function appendUserMessage(conversation: Conversation, content: MessageInput['content'], metadata?: Record<string, unknown>, environment?: Partial<ConversationEnvironment>): Conversation;
+export declare function appendUserMessage(conversation: Conversation, content: MessageInput['content'], metadata?: Record<string, JSONValue>, 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;
+export declare function appendAssistantMessage(conversation: Conversation, content: MessageInput['content'], metadata?: Record<string, JSONValue>, 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;
+export declare function appendSystemMessage(conversation: Conversation, content: string, metadata?: Record<string, JSONValue>, environment?: Partial<ConversationEnvironment>): Conversation;
 //# sourceMappingURL=append.d.ts.map

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

@@ -1 +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"}
+{"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,EAEV,YAAY,EACZ,SAAS,EAET,YAAY,EACb,MAAM,UAAU,CAAC;AAoClB;;;;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;AAwEhB;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,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,SAAS,CAAC,EACpC,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,SAAS,CAAC,EACpC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAEd"}

package/dist/conversation/create.d.ts

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

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

@@ -1 +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"}
+{"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,SAAS,EAAE,MAAM,UAAU,CAAC;AAI5E;;;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,SAAS,CAAC,CAAC;CACtC,EACD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAed"}

package/dist/conversation/index.d.ts

@@ -1,9 +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 { getMessageAtPosition, getMessageById, getMessageIds, getMessages, getStatistics, searchConversationMessages, } from './query';
 export { collapseSystemMessages, getFirstSystemMessage, getSystemMessages, hasSystemMessage, prependSystemMessage, replaceSystemMessage, } from './system-messages';
 export { redactMessageAtPosition } from './modify';
-export { deserializeConversation, migrateConversationJSON, serializeConversation, } from './serialization';
+export { deserializeConversation, migrateConversation } from './serialization';
 export { toChatMessages } from './transform';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,EACL,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"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,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,EACb,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,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

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

@@ -1 +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"}
+{"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,CAgCd"}

package/dist/conversation/query.d.ts

@@ -1,21 +1,25 @@
 import type { Conversation, Message } from '../types';
 /**
- * Returns all messages from a conversation.
+ * Returns all messages from a conversation in order.
  * By default excludes hidden messages unless includeHidden is true.
  */
-export declare function getConversationMessages(conversation: Conversation, options?: {
+export declare function getMessages(conversation: Conversation, options?: {
     includeHidden?: boolean;
-}): ReadonlyArray<Message>;
+}): 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;
+/**
+ * Returns all message IDs for the conversation in order.
+ */
+export declare function getMessageIds(conversation: Conversation): string[];
 /**
  * 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;
+export declare function getMessageById(conversation: Conversation, id: string): Message | undefined;
 /**
  * Filters messages using a custom predicate function.
  * Returns all messages for which the predicate returns true.
@@ -25,7 +29,7 @@ export declare function searchConversationMessages(conversation: Conversation, p
  * Computes statistics about a conversation's messages.
  * Returns totals, counts by role, hidden message count, and image count.
  */
-export declare function computeConversationStatistics(conversation: Conversation): {
+export declare function getStatistics(conversation: Conversation): {
     total: number;
     byRole: Record<string, number>;
     hidden: number;

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

@@ -1 +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"}
+{"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;AAItD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,OAAO,EAAE,CAIX;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,GAAG,SAAS,CAGrB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,EAAE,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,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,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG;IACzD,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,CAkBA"}