conversationalist 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Steve Kinney
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,369 @@
+# Conversationalist
+
+A TypeScript library for managing LLM conversation state with immutable data structures and type-safe APIs.
+
+## Installation
+
+```bash
+bun add conversationalist
+npm add conversationalist
+```
+
+## Core Concepts
+
+### Conversation
+
+A conversation is an immutable data structure containing messages, metadata, and timestamps:
+
+```typescript
+import {
+  createConversation,
+  appendUserMessage,
+  appendAssistantMessage,
+} from 'conversationalist';
+
+let conversation = createConversation({ title: 'My Chat' });
+
+conversation = appendUserMessage(conversation, 'Hello!');
+conversation = appendAssistantMessage(conversation, 'Hi there!');
+```
+
+### Messages
+
+Messages have roles (`user`, `assistant`, `system`, `tool-use`, `tool-result`, `developer`, `snapshot`) and can contain text or multi-modal content:
+
+```typescript
+import { appendMessages } from 'conversationalist';
+
+// Text message
+conversation = appendMessages(conversation, {
+  role: 'user',
+  content: 'What is in this image?',
+});
+
+// Multi-modal message with image
+conversation = appendMessages(conversation, {
+  role: 'user',
+  content: [
+    { type: 'text', text: 'Describe this:' },
+    { type: 'image', url: 'https://example.com/image.png' },
+  ],
+});
+```
+
+### Tool Calls
+
+Tool use is supported with linked tool calls and results:
+
+```typescript
+conversation = appendMessages(
+  conversation,
+  {
+    role: 'tool-use',
+    content: '',
+    toolCall: { id: 'call_123', name: 'get_weather', arguments: '{"city":"NYC"}' },
+  },
+  {
+    role: 'tool-result',
+    content: '',
+    toolResult: { callId: 'call_123', outcome: 'success', content: '72°F, sunny' },
+  },
+);
+```
+
+## API Reference
+
+### Creating Conversations
+
+```typescript
+createConversation(options?: {
+  id?: string;
+  title?: string;
+  status?: 'active' | 'archived' | 'deleted';
+  metadata?: Record<string, unknown>;
+  tags?: string[];
+}): Conversation
+```
+
+### Appending Messages
+
+```typescript
+appendMessages(conversation: Conversation, ...inputs: MessageInput[]): Conversation
+appendUserMessage(conversation: Conversation, content: string | MultiModalContent[]): Conversation
+appendAssistantMessage(conversation: Conversation, content: string | MultiModalContent[]): Conversation
+appendSystemMessage(conversation: Conversation, content: string): Conversation
+prependSystemMessage(conversation: Conversation, content: string): Conversation
+replaceSystemMessage(conversation: Conversation, content: string): Conversation
+```
+
+### Querying Messages
+
+```typescript
+getConversationMessages(conversation: Conversation, options?: { includeHidden?: boolean }): Message[]
+getMessageAtPosition(conversation: Conversation, position: number): Message | undefined
+getMessageByIdentifier(conversation: Conversation, id: string): Message | undefined
+searchConversationMessages(conversation: Conversation, predicate: (m: Message) => boolean): Message[]
+```
+
+### System Messages
+
+```typescript
+hasSystemMessage(conversation: Conversation): boolean
+getFirstSystemMessage(conversation: Conversation): Message | undefined
+getSystemMessages(conversation: Conversation): Message[]
+collapseSystemMessages(conversation: Conversation): Conversation
+```
+
+### Utilities
+
+```typescript
+computeConversationStatistics(conversation: Conversation): {
+  total: number;
+  byRole: Record<string, number>;
+  hidden: number;
+  withImages: number;
+}
+
+redactMessageAtPosition(conversation: Conversation, position: number, placeholder?: string): Conversation
+```
+
+### Serialization
+
+```typescript
+serializeConversation(conversation: Conversation): ConversationJSON
+deserializeConversation(json: ConversationJSON): Conversation
+toChatMessages(conversation: Conversation): ExternalMessage[]
+```
+
+### Builder Pattern
+
+For fluent API style:
+
+```typescript
+import { createConversation } from 'conversationalist';
+import { withConversation, pipeConversation } from 'conversationalist';
+import { simpleTokenEstimator } from 'conversationalist';
+
+// Draft pattern with callback
+const conversation = withConversation(createConversation(), (draft) => {
+  draft
+    .appendSystemMessage('You are a helpful assistant.')
+    .appendUserMessage('Hello!')
+    .appendAssistantMessage('Hi there!');
+});
+
+// Streaming with the draft pattern
+const streamedConversation = withConversation(createConversation(), (draft) => {
+  const { draft: d, messageId } = draft.appendStreamingMessage('assistant');
+  d.updateStreamingMessage(messageId, 'Partial response...').finalizeStreamingMessage(
+    messageId,
+    { tokenUsage: { prompt: 10, completion: 5, total: 15 } },
+  );
+});
+
+// Context window management with the draft pattern
+const truncatedConversation = withConversation(conversation, (draft) => {
+  draft.truncateToTokenLimit(4000, simpleTokenEstimator, { preserveLastN: 2 });
+});
+
+// Pipe pattern
+const conversation = pipeConversation(
+  createConversation(),
+  (c) => appendSystemMessage(c, 'You are helpful.'),
+  (c) => appendUserMessage(c, 'Hello!'),
+);
+```
+
+The `ConversationDraft` provides all conversation manipulation methods:
+
+- **Message appending**: `appendMessages`, `appendUserMessage`, `appendAssistantMessage`, `appendSystemMessage`
+- **System messages**: `prependSystemMessage`, `replaceSystemMessage`, `collapseSystemMessages`
+- **Modification**: `redactMessageAtPosition`
+- **Streaming**: `appendStreamingMessage`, `updateStreamingMessage`, `finalizeStreamingMessage`, `cancelStreamingMessage`
+- **Context window**: `truncateFromPosition`, `truncateToTokenLimit`
+
+### Tool Call Pairing
+
+```typescript
+import { pairToolCallsWithResults } from 'conversationalist';
+
+const pairs = pairToolCallsWithResults(conversation.messages);
+// Returns: [{ call: ToolCall, result?: ToolResult }, ...]
+```
+
+## Provider Adapters
+
+Convert conversations to provider-specific formats using subpath exports:
+
+### OpenAI
+
+```typescript
+import { toOpenAIMessages } from 'conversationalist/openai';
+
+const messages = toOpenAIMessages(conversation);
+const response = await openai.chat.completions.create({
+  model: 'gpt-4',
+  messages,
+});
+```
+
+### Anthropic
+
+```typescript
+import { toAnthropicMessages } from 'conversationalist/anthropic';
+
+const { system, messages } = toAnthropicMessages(conversation);
+const response = await anthropic.messages.create({
+  model: 'claude-3-opus-20240229',
+  system,
+  messages,
+});
+```
+
+### Google Gemini
+
+```typescript
+import { toGeminiMessages } from 'conversationalist/gemini';
+
+const { systemInstruction, contents } = toGeminiMessages(conversation);
+const response = await model.generateContent({
+  systemInstruction,
+  contents,
+});
+```
+
+## Streaming Support
+
+Handle streaming responses with pending message utilities:
+
+```typescript
+import {
+  appendStreamingMessage,
+  updateStreamingMessage,
+  finalizeStreamingMessage,
+  cancelStreamingMessage,
+  isStreamingMessage,
+  getStreamingMessage,
+} from 'conversationalist';
+
+// Start a streaming message
+let { conversation, messageId } = appendStreamingMessage(conversation, 'assistant');
+
+// Update content as chunks arrive
+for await (const chunk of stream) {
+  accumulatedContent += chunk;
+  conversation = updateStreamingMessage(conversation, messageId, accumulatedContent);
+}
+
+// Finalize when complete
+conversation = finalizeStreamingMessage(conversation, messageId, {
+  tokenUsage: { prompt: 100, completion: 50, total: 150 },
+});
+
+// Or cancel if needed
+conversation = cancelStreamingMessage(conversation, messageId);
+```
+
+## Context Window Utilities
+
+Manage token limits and message truncation:
+
+```typescript
+import {
+  getRecentMessages,
+  truncateFromPosition,
+  truncateToTokenLimit,
+  estimateConversationTokens,
+  simpleTokenEstimator,
+} from 'conversationalist';
+
+// Get last N messages (excluding system by default)
+const recent = getRecentMessages(conversation, 10);
+
+// Truncate to messages from position onwards
+const truncated = truncateFromPosition(conversation, 5);
+
+// Truncate to fit token limit
+const fitted = truncateToTokenLimit(conversation, 4000, simpleTokenEstimator, {
+  preserveSystemMessages: true,
+  preserveLastN: 2,
+});
+
+// Estimate total tokens
+const tokens = estimateConversationTokens(conversation, simpleTokenEstimator);
+```
+
+## Types
+
+```typescript
+import type {
+  Conversation,
+  ConversationJSON,
+  ConversationStatus,
+  Message,
+  MessageInput,
+  MessageJSON,
+  MessageRole,
+  TokenUsage,
+  ToolCall,
+  ToolResult,
+  MultiModalContent,
+  TextContent,
+  ImageContent,
+} from 'conversationalist';
+```
+
+## Validation Schemas
+
+Zod schemas are exported for runtime validation:
+
+```typescript
+import {
+  conversationSchema,
+  messageInputSchema,
+  messageJSONSchema,
+  messageRoleSchema,
+  multiModalContentSchema,
+  tokenUsageSchema,
+  toolCallSchema,
+  toolResultSchema,
+} from 'conversationalist';
+
+const result = messageInputSchema.safeParse(data);
+```
+
+## Error Handling
+
+Custom error types with codes:
+
+```typescript
+import {
+  ConversationalistError,
+  createInvalidInputError,
+  createInvalidPositionError,
+  createNotFoundError,
+  createValidationError,
+} from 'conversationalist';
+
+try {
+  // ...
+} catch (error) {
+  if (error instanceof ConversationalistError) {
+    console.log(error.code); // e.g., 'INVALID_POSITION'
+  }
+}
+```
+
+## Development
+
+```bash
+bun install
+bun test
+bun run typecheck
+bun run lint
+bun run build
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,76 @@
+import type { Conversation } from '../../types';
+/**
+ * Anthropic text content block.
+ */
+export interface AnthropicTextBlock {
+    type: 'text';
+    text: string;
+}
+/**
+ * Anthropic image content block.
+ */
+export interface AnthropicImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64' | 'url';
+        media_type?: string;
+        data?: string;
+        url?: string;
+    };
+}
+/**
+ * Anthropic tool use content block.
+ */
+export interface AnthropicToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: unknown;
+}
+/**
+ * Anthropic tool result content block.
+ */
+export interface AnthropicToolResultBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+/**
+ * Anthropic content block union type.
+ */
+export type AnthropicContentBlock = AnthropicTextBlock | AnthropicImageBlock | AnthropicToolUseBlock | AnthropicToolResultBlock;
+/**
+ * Anthropic message format for the Messages API.
+ */
+export interface AnthropicMessage {
+    role: 'user' | 'assistant';
+    content: string | AnthropicContentBlock[];
+}
+/**
+ * Result of converting a conversation to Anthropic format.
+ * System messages are extracted separately since Anthropic uses a top-level system parameter.
+ */
+export interface AnthropicConversation {
+    system?: string;
+    messages: AnthropicMessage[];
+}
+/**
+ * Converts a conversation to Anthropic Messages API format.
+ * System messages are extracted to the top-level `system` field.
+ * Tool calls become tool_use blocks, tool results become tool_result blocks.
+ *
+ * @example
+ * ```ts
+ * import { toAnthropicMessages } from 'conversationalist/anthropic';
+ *
+ * const { system, messages } = toAnthropicMessages(conversation);
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-3-opus-20240229',
+ *   system,
+ *   messages,
+ * });
+ * ```
+ */
+export declare function toAnthropicMessages(conversation: Conversation): AnthropicConversation;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/anthropic/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AA+GD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,CAiFrF"}

package/dist/adapters/anthropic/index.js

@@ -0,0 +1,147 @@
+// src/adapters/anthropic/index.ts
+function toAnthropicContent(content) {
+  if (typeof content === "string") {
+    return content;
+  }
+  const blocks = [];
+  for (const part of content) {
+    if (part.type === "text") {
+      blocks.push({ type: "text", text: part.text ?? "" });
+    } else if (part.type === "image") {
+      const url = part.url ?? "";
+      if (url.startsWith("data:")) {
+        const matches = url.match(/^data:([^;]+);base64,(.+)$/);
+        if (matches && matches[1] && matches[2]) {
+          blocks.push({
+            type: "image",
+            source: {
+              type: "base64",
+              media_type: matches[1],
+              data: matches[2]
+            }
+          });
+        }
+      } else {
+        blocks.push({
+          type: "image",
+          source: {
+            type: "url",
+            url
+          }
+        });
+      }
+    }
+  }
+  return blocks.length === 1 && blocks[0]?.type === "text" ? blocks[0].text : blocks;
+}
+function toToolUseBlock(toolCall) {
+  return {
+    type: "tool_use",
+    id: toolCall.id,
+    name: toolCall.name,
+    input: typeof toolCall.arguments === "string" ? JSON.parse(toolCall.arguments) : toolCall.arguments
+  };
+}
+function toToolResultBlock(toolResult) {
+  const result = {
+    type: "tool_result",
+    tool_use_id: toolResult.callId,
+    content: typeof toolResult.content === "string" ? toolResult.content : JSON.stringify(toolResult.content)
+  };
+  if (toolResult.outcome === "error") {
+    result.is_error = true;
+  }
+  return result;
+}
+function extractSystemContent(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) {
+    if (typeof msg.content === "string") {
+      parts.push(msg.content);
+    } else {
+      for (const part of msg.content) {
+        if (part.type === "text") {
+          parts.push(part.text ?? "");
+        }
+      }
+    }
+  }
+  return parts.join(`
+
+`);
+}
+function toAnthropicMessages(conversation) {
+  const system = extractSystemContent(conversation.messages);
+  const messages = [];
+  let currentRole = null;
+  let currentBlocks = [];
+  const flushCurrent = () => {
+    if (currentRole && currentBlocks.length > 0) {
+      messages.push({
+        role: currentRole,
+        content: currentBlocks.length === 1 && currentBlocks[0]?.type === "text" ? currentBlocks[0].text : currentBlocks
+      });
+      currentBlocks = [];
+    }
+    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 blocks = [];
+    if (message.role === "user") {
+      targetRole = "user";
+      const content = toAnthropicContent(message.content);
+      if (typeof content === "string") {
+        blocks = [{ type: "text", text: content }];
+      } else {
+        blocks = content;
+      }
+    } else if (message.role === "assistant") {
+      targetRole = "assistant";
+      const content = toAnthropicContent(message.content);
+      if (typeof content === "string") {
+        blocks = [{ type: "text", text: content }];
+      } else {
+        blocks = content;
+      }
+    } else if (message.role === "tool-use" && message.toolCall) {
+      targetRole = "assistant";
+      blocks = [toToolUseBlock(message.toolCall)];
+    } else if (message.role === "tool-result" && message.toolResult) {
+      targetRole = "user";
+      blocks = [toToolResultBlock(message.toolResult)];
+    } else {
+      continue;
+    }
+    if (currentRole === targetRole) {
+      currentBlocks.push(...blocks);
+    } else {
+      flushCurrent();
+      currentRole = targetRole;
+      currentBlocks = blocks;
+    }
+  }
+  flushCurrent();
+  const result = { messages };
+  if (system !== undefined) {
+    result.system = system;
+  }
+  return result;
+}
+export {
+  toAnthropicMessages
+};
+
+//# debugId=46DDFFB8D921BA7364756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../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"
+  ],
+  "mappings": "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",
+  "debugId": "46DDFFB8D921BA7364756E2164756E21",
+  "names": []
+}