@animalabs/membrane 0.1.0

package/dist/transforms/chat.js

@@ -0,0 +1,136 @@
+/**
+ * Chat mode transforms
+ *
+ * Converts normalized messages to role-based alternating format
+ * for providers that don't support prefill mode.
+ */
+import { isTextContent, isToolUseContent, isToolResultContent } from '../types/index.js';
+// ============================================================================
+// Main Transform Function
+// ============================================================================
+/**
+ * Transform normalized request to chat format
+ */
+export function transformToChat(request, options = {}) {
+    const { assistantName = 'Claude', userParticipants = [], mergeStrategy = 'concatenate', } = options;
+    const userSet = new Set(userParticipants);
+    const messages = [];
+    for (const message of request.messages) {
+        const role = determineRole(message.participant, assistantName, userSet);
+        const content = transformContent(message.content);
+        if (mergeStrategy === 'concatenate' && messages.length > 0) {
+            const lastMessage = messages[messages.length - 1];
+            if (lastMessage && lastMessage.role === role) {
+                // Merge with previous message
+                lastMessage.content.push(...content);
+                continue;
+            }
+        }
+        messages.push({ role, content });
+    }
+    // Ensure alternating roles (required by most providers)
+    const normalizedMessages = ensureAlternatingRoles(messages);
+    // Build stop sequences
+    const stopSequences = buildChatStopSequences(request);
+    return {
+        system: request.system ?? '',
+        messages: normalizedMessages,
+        stopSequences,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function determineRole(participant, assistantName, userSet) {
+    if (participant === assistantName) {
+        return 'assistant';
+    }
+    if (userSet.has(participant)) {
+        return 'user';
+    }
+    // Default: non-assistant is user
+    return 'user';
+}
+function transformContent(blocks) {
+    const result = [];
+    for (const block of blocks) {
+        if (isTextContent(block)) {
+            result.push({ type: 'text', text: block.text });
+        }
+        else if (block.type === 'image' && block.source.type === 'base64') {
+            result.push({
+                type: 'image',
+                source: {
+                    type: 'base64',
+                    data: block.source.data,
+                    mediaType: block.source.mediaType,
+                },
+            });
+        }
+        else if (isToolUseContent(block)) {
+            result.push({
+                type: 'tool_use',
+                id: block.id,
+                name: block.name,
+                input: block.input,
+            });
+        }
+        else if (isToolResultContent(block)) {
+            const content = typeof block.content === 'string'
+                ? block.content
+                : JSON.stringify(block.content);
+            result.push({
+                type: 'tool_result',
+                tool_use_id: block.toolUseId,
+                content,
+            });
+        }
+        // Other block types are skipped or could be handled here
+    }
+    return result;
+}
+function ensureAlternatingRoles(messages) {
+    if (messages.length === 0)
+        return messages;
+    const result = [];
+    let lastRole = null;
+    for (const message of messages) {
+        if (lastRole === message.role) {
+            // Insert empty message of opposite role
+            const fillerRole = message.role === 'user' ? 'assistant' : 'user';
+            result.push({
+                role: fillerRole,
+                content: [{ type: 'text', text: '...' }],
+            });
+        }
+        result.push(message);
+        lastRole = message.role;
+    }
+    // Ensure starts with user
+    const first = result[0];
+    if (result.length > 0 && first && first.role === 'assistant') {
+        result.unshift({
+            role: 'user',
+            content: [{ type: 'text', text: '...' }],
+        });
+    }
+    return result;
+}
+function buildChatStopSequences(request) {
+    const sequences = [];
+    // Add tool-related stop if tools are defined
+    if (request.tools && request.tools.length > 0) {
+        sequences.push('</function_calls>');
+    }
+    // Add any explicit stop sequences from request
+    if (request.stopSequences) {
+        if (Array.isArray(request.stopSequences)) {
+            sequences.push(...request.stopSequences);
+        }
+        else {
+            sequences.push(...request.stopSequences.sequences);
+        }
+    }
+    return sequences;
+}
+//# sourceMappingURL=chat.js.map

package/dist/transforms/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/transforms/chat.ts"],"names":[],"mappings":"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"}

package/dist/transforms/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Transform exports
+ */
+export { transformToPrefill, buildContinuationPrefill, type PrefillTransformResult, type PrefillTransformOptions, type ProviderTextBlock, type ProviderImageBlock, type ProviderContentBlock, type ProviderMessage, } from './prefill.js';
+export { transformToChat, type ChatTransformResult, type ChatTransformOptions, type ChatMessage, type ChatContent, } from './chat.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC"}

package/dist/transforms/index.js

@@ -0,0 +1,6 @@
+/**
+ * Transform exports
+ */
+export { transformToPrefill, buildContinuationPrefill, } from './prefill.js';
+export { transformToChat, } from './chat.js';
+//# sourceMappingURL=index.js.map

package/dist/transforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAOzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,GAKhB,MAAM,WAAW,CAAC"}

package/dist/transforms/prefill.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Prefill mode transforms
+ *
+ * Converts normalized messages to participant-based conversation log format:
+ *
+ * Alice: Hello there!
+ *
+ * Bob: Hi Alice!
+ *
+ * Claude: [assistant continuation starts here...]
+ *
+ * Key features:
+ * - Cache control markers for Anthropic prompt caching
+ * - Image flushing (images cause conversation flush to user turn)
+ * - Tool injection into conversation
+ */
+import type { NormalizedRequest, CacheControl } from '../types/index.js';
+/**
+ * Content block in provider format (Anthropic-style)
+ * Can include cache_control for prompt caching
+ */
+export interface ProviderTextBlock {
+    type: 'text';
+    text: string;
+    cache_control?: CacheControl;
+}
+export interface ProviderImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+export type ProviderContentBlock = ProviderTextBlock | ProviderImageBlock;
+export interface ProviderMessage {
+    role: 'user' | 'assistant';
+    content: string | ProviderContentBlock[];
+}
+export interface PrefillTransformResult {
+    /** System prompt content blocks (may have cache_control) */
+    systemContent: ProviderContentBlock[];
+    /** Messages in provider format (ready for API) */
+    messages: ProviderMessage[];
+    /** For legacy compatibility: system as string */
+    system: string;
+    /** For legacy compatibility: user content as string */
+    userContent: string;
+    /** For legacy compatibility: assistant prefill as string */
+    assistantPrefill: string;
+    /** Stop sequences to use */
+    stopSequences: string[];
+    /** Number of cache markers applied */
+    cacheMarkersApplied: number;
+}
+export interface PrefillTransformOptions {
+    /** Name of the assistant participant (default: 'Claude') */
+    assistantName?: string;
+    /** Maximum participants to include in stop sequences */
+    maxParticipantsForStop?: number;
+    /** Custom stop sequences to add */
+    additionalStopSequences?: string[];
+    /**
+     * Where to inject tool definitions:
+     * - 'conversation': Inject into assistant content ~N messages from end (default)
+     * - 'system': Inject into system prompt
+     * - 'none': No injection (use getToolInstructions() for manual placement)
+     */
+    toolInjectionMode?: 'conversation' | 'system' | 'none';
+    /** Position to inject tools when mode is 'conversation' (from end of messages) */
+    toolInjectionPosition?: number;
+    /** Enable prompt caching (default: true) */
+    promptCaching?: boolean;
+    /** Message delimiter for base models (e.g., '</s>') */
+    messageDelimiter?: string;
+    /** Context prefix for simulacrum seeding */
+    contextPrefix?: string;
+    /** Start assistant response with <thinking> tag */
+    prefillThinking?: boolean;
+}
+/**
+ * Transform normalized request to prefill format with cache control support
+ */
+export declare function transformToPrefill(request: NormalizedRequest, options?: PrefillTransformOptions): PrefillTransformResult;
+/**
+ * Build a continuation request from accumulated output
+ */
+export declare function buildContinuationPrefill(originalResult: PrefillTransformResult, accumulated: string): PrefillTransformResult;
+//# sourceMappingURL=prefill.d.ts.map

package/dist/transforms/prefill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefill.d.ts","sourceRoot":"","sources":["../../src/transforms/prefill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EAGjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAQ3B;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAM1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;CAC1C;AAMD,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,aAAa,EAAE,oBAAoB,EAAE,CAAC;IAEtC,kDAAkD;IAClD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAE5B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,sCAAsC;IACtC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,wDAAwD;IACxD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,mCAAmC;IACnC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEvD,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAuOxB;AA4LD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,sBAAsB,EACtC,WAAW,EAAE,MAAM,GAClB,sBAAsB,CAuBxB"}

package/dist/transforms/prefill.js

@@ -0,0 +1,401 @@
+/**
+ * Prefill mode transforms
+ *
+ * Converts normalized messages to participant-based conversation log format:
+ *
+ * Alice: Hello there!
+ *
+ * Bob: Hi Alice!
+ *
+ * Claude: [assistant continuation starts here...]
+ *
+ * Key features:
+ * - Cache control markers for Anthropic prompt caching
+ * - Image flushing (images cause conversation flush to user turn)
+ * - Tool injection into conversation
+ */
+import { formatToolDefinitions } from '../utils/tool-parser.js';
+// ============================================================================
+// Main Transform Function
+// ============================================================================
+/**
+ * Transform normalized request to prefill format with cache control support
+ */
+export function transformToPrefill(request, options = {}) {
+    const { assistantName = 'Claude', maxParticipantsForStop = 10, additionalStopSequences = [], toolInjectionMode = 'conversation', toolInjectionPosition = 10, promptCaching = true, messageDelimiter = '', contextPrefix, prefillThinking = false, } = options;
+    const messages = request.messages;
+    const providerMessages = [];
+    // Track cache marker GLOBALLY across all flushes
+    // Everything BEFORE we see the marker gets cache_control
+    // Everything AFTER does NOT
+    let passedCacheMarker = false;
+    let cacheMarkersApplied = 0;
+    // Joiner between messages (if delimiter, no newlines needed)
+    const joiner = messageDelimiter ? '' : '\n';
+    // Track conversation lines for current section
+    let currentConversation = [];
+    let lastNonEmptyParticipant = null;
+    // Build system prompt
+    let systemText = request.system ?? '';
+    // Inject tool definitions into system prompt if mode is 'system'
+    if (toolInjectionMode === 'system' && request.tools && request.tools.length > 0) {
+        const toolsXml = formatToolsForPrefill(request.tools);
+        systemText = injectToolsIntoSystem(systemText, toolsXml);
+    }
+    // System prompt content (with cache_control if enabled)
+    const systemContent = [];
+    if (systemText) {
+        const systemBlock = { type: 'text', text: systemText };
+        if (promptCaching) {
+            systemBlock.cache_control = { type: 'ephemeral' };
+            cacheMarkersApplied++;
+        }
+        systemContent.push(systemBlock);
+        // Note: system content goes in systemContent, not providerMessages
+        // Anthropic's API requires system as a top-level parameter
+    }
+    // Add context prefix as first cached assistant message (for simulacrum seeding)
+    if (contextPrefix) {
+        const prefixBlock = { type: 'text', text: contextPrefix };
+        if (promptCaching) {
+            prefixBlock.cache_control = { type: 'ephemeral' };
+            cacheMarkersApplied++;
+        }
+        providerMessages.push({
+            role: 'assistant',
+            content: [prefixBlock],
+        });
+    }
+    // Process messages
+    for (let i = 0; i < messages.length; i++) {
+        const message = messages[i];
+        if (!message)
+            continue;
+        const isLastMessage = i === messages.length - 1;
+        const isAssistant = message.participant === assistantName;
+        const hasCacheMarker = !!message.metadata?.cacheControl;
+        // Extract text and images
+        const { text, images } = formatContentForPrefill(message.content, message.participant);
+        const hasImages = images.length > 0;
+        const isEmpty = !text.trim() && !hasImages;
+        // Check for tool results
+        const hasToolResult = message.content.some(c => c.type === 'tool_result');
+        // If message has images, flush current conversation and add as user message
+        if (hasImages && !isEmpty) {
+            // Flush current assistant conversation
+            if (currentConversation.length > 0) {
+                const content = currentConversation.join(joiner);
+                providerMessages.push({
+                    role: 'assistant',
+                    content: content,
+                });
+                currentConversation = [];
+            }
+            // Add message with image as user turn
+            const userContent = [];
+            if (text) {
+                userContent.push({ type: 'text', text: `${message.participant}: ${text}` });
+            }
+            userContent.push(...images);
+            providerMessages.push({
+                role: 'user',
+                content: userContent,
+            });
+            lastNonEmptyParticipant = message.participant;
+            continue;
+        }
+        // Skip empty messages (except last)
+        if (isEmpty && !isLastMessage) {
+            continue;
+        }
+        // Check if this message has the cache marker - switch to uncached mode AFTER this
+        if (hasCacheMarker && !passedCacheMarker) {
+            // Flush everything before this message WITH cache_control (if caching enabled)
+            if (currentConversation.length > 0) {
+                const content = currentConversation.join(joiner);
+                const contentBlock = { type: 'text', text: content };
+                if (promptCaching) {
+                    contentBlock.cache_control = { type: 'ephemeral' };
+                    cacheMarkersApplied++;
+                }
+                providerMessages.push({
+                    role: 'assistant',
+                    content: [contentBlock],
+                });
+                currentConversation = [];
+            }
+            passedCacheMarker = true;
+        }
+        // Check bot continuation logic
+        const isBotMessage = message.participant === assistantName;
+        const isContinuation = isBotMessage && lastNonEmptyParticipant === assistantName && !hasToolResult;
+        if (isContinuation && isLastMessage) {
+            // Bot continuation - don't add prefix, just complete from where we are
+            continue;
+        }
+        else if (isLastMessage && isEmpty) {
+            // Completion target - optionally start with thinking tag
+            if (prefillThinking) {
+                currentConversation.push(`${message.participant}: <thinking>`);
+            }
+            else {
+                currentConversation.push(`${message.participant}:`);
+            }
+        }
+        else if (text) {
+            // Regular message - append delimiter if configured
+            currentConversation.push(`${message.participant}: ${text}${messageDelimiter}`);
+            if (!hasToolResult) {
+                lastNonEmptyParticipant = message.participant;
+            }
+        }
+    }
+    // If conversation doesn't end with assistant turn, append one
+    // This ensures the model knows to respond as the assistant
+    if (lastNonEmptyParticipant !== assistantName) {
+        if (prefillThinking) {
+            currentConversation.push(`${assistantName}: <thinking>`);
+        }
+        else {
+            currentConversation.push(`${assistantName}:`);
+        }
+    }
+    // Flush any remaining conversation, inject tools if mode is 'conversation'
+    if (currentConversation.length > 0) {
+        const hasToolsForConversation = toolInjectionMode === 'conversation' &&
+            request.tools &&
+            request.tools.length > 0;
+        if (hasToolsForConversation) {
+            // Inject tools into assistant content
+            const toolsText = formatToolsForInjection(request.tools);
+            if (currentConversation.length > toolInjectionPosition) {
+                // Long conversation: insert tools ~N messages from the end
+                const splitPoint = currentConversation.length - toolInjectionPosition;
+                const beforeTools = currentConversation.slice(0, splitPoint);
+                const afterTools = currentConversation.slice(splitPoint);
+                const combined = [
+                    ...beforeTools,
+                    toolsText,
+                    ...afterTools,
+                ].join(joiner);
+                providerMessages.push({
+                    role: 'assistant',
+                    content: combined,
+                });
+            }
+            else {
+                // Short conversation: inject tools at the end (right before completion point)
+                const combined = [...currentConversation, toolsText].join(joiner);
+                providerMessages.push({
+                    role: 'assistant',
+                    content: combined,
+                });
+            }
+        }
+        else {
+            // No tool injection needed
+            providerMessages.push({
+                role: 'assistant',
+                content: currentConversation.join(joiner),
+            });
+        }
+    }
+    // Build stop sequences from participants
+    const stopSequences = buildStopSequences(messages, assistantName, maxParticipantsForStop, additionalStopSequences);
+    // Build legacy string versions for backwards compatibility
+    const legacyStrings = buildLegacyStrings(providerMessages, systemText);
+    return {
+        systemContent,
+        messages: providerMessages,
+        system: systemText,
+        userContent: legacyStrings.userContent,
+        assistantPrefill: legacyStrings.assistantPrefill,
+        stopSequences,
+        cacheMarkersApplied,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function formatContentForPrefill(content, participant) {
+    const parts = [];
+    const images = [];
+    for (const block of content) {
+        if (block.type === 'text') {
+            parts.push(block.text);
+        }
+        else if (block.type === 'image') {
+            // Convert to provider format
+            if (block.source.type === 'base64') {
+                images.push({
+                    type: 'image',
+                    source: {
+                        type: 'base64',
+                        media_type: block.source.mediaType,
+                        data: block.source.data,
+                    },
+                });
+            }
+        }
+        else if (block.type === 'tool_use') {
+            // Format as: Name>[toolname]: {json}
+            parts.push(`${participant}>[${block.name}]: ${JSON.stringify(block.input)}`);
+        }
+        else if (block.type === 'tool_result') {
+            // Format as: Name<[tool_result]: result
+            const resultText = typeof block.content === 'string'
+                ? block.content
+                : JSON.stringify(block.content);
+            parts.push(`${participant}<[tool_result]: ${resultText}`);
+        }
+    }
+    return { text: parts.join('\n'), images };
+}
+function formatToolsForPrefill(tools) {
+    const toolsForPrompt = tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        parameters: Object.fromEntries(Object.entries(tool.inputSchema.properties).map(([name, schema]) => [
+            name,
+            {
+                type: schema.type,
+                description: schema.description,
+                required: tool.inputSchema.required?.includes(name),
+                enum: schema.enum,
+            },
+        ])),
+    }));
+    return formatToolDefinitions(toolsForPrompt);
+}
+function injectToolsIntoSystem(system, toolsXml) {
+    const toolsSection = `
+<available_tools>
+${toolsXml}
+</available_tools>
+
+When you want to use a tool, output:
+<function_calls>
+<invoke name="tool_name">
+<parameter name="param_name">value</parameter>
+</invoke>
+</function_calls>
+`;
+    return system + '\n\n' + toolsSection;
+}
+// Tool format constants (assembled to avoid triggering stop sequences)
+const FUNCTIONS_OPEN = '<' + 'functions>';
+const FUNCTIONS_CLOSE = '</' + 'functions>';
+const FUNCTION_OPEN = '<' + 'function>';
+const FUNCTION_CLOSE = '</' + 'function>';
+const FUNC_CALLS_OPEN = '<' + 'function_calls>';
+const FUNC_CALLS_CLOSE = '</' + 'function_calls>';
+const INVOKE_OPEN = '<' + 'invoke name="';
+const INVOKE_CLOSE = '</' + 'invoke>';
+const PARAM_OPEN = '<' + 'parameter name="';
+const PARAM_CLOSE = '</' + 'parameter>';
+function formatToolsForInjection(tools) {
+    // Use the same XML format as system mode for consistency
+    const toolsXml = formatToolsForPrefill(tools);
+    return `
+<available_tools>
+${toolsXml}
+</available_tools>
+
+When you want to use a tool, output:
+${FUNC_CALLS_OPEN}
+${INVOKE_OPEN}tool_name">
+${PARAM_OPEN}param_name">value${PARAM_CLOSE}
+${INVOKE_CLOSE}
+${FUNC_CALLS_CLOSE}`;
+}
+function buildStopSequences(messages, assistantName, maxParticipants, additionalSequences) {
+    // Collect unique participants (excluding assistant)
+    const participants = new Set();
+    // Scan from end of messages
+    for (let i = messages.length - 1; i >= 0 && participants.size < maxParticipants; i--) {
+        const message = messages[i];
+        if (!message)
+            continue;
+        const participant = message.participant;
+        if (participant !== assistantName) {
+            participants.add(participant);
+        }
+    }
+    // Build stop sequences
+    const sequences = [];
+    // Participant-based stops
+    for (const participant of participants) {
+        sequences.push(`\n${participant}:`);
+    }
+    // Tool-related stop
+    sequences.push('</function_calls>');
+    // Additional sequences
+    sequences.push(...additionalSequences);
+    return sequences;
+}
+function buildLegacyStrings(messages, systemText) {
+    // Extract user content (first user message after system)
+    let userContent = '';
+    let assistantPrefill = '';
+    for (const msg of messages) {
+        if (msg.role === 'user') {
+            if (typeof msg.content === 'string') {
+                userContent += msg.content + '\n\n';
+            }
+            else {
+                // Extract text from blocks
+                for (const block of msg.content) {
+                    if (block.type === 'text') {
+                        userContent += block.text + '\n\n';
+                    }
+                }
+            }
+        }
+        else if (msg.role === 'assistant') {
+            if (typeof msg.content === 'string') {
+                assistantPrefill += msg.content;
+            }
+            else {
+                for (const block of msg.content) {
+                    if (block.type === 'text') {
+                        assistantPrefill += block.text;
+                    }
+                }
+            }
+        }
+    }
+    return {
+        userContent: userContent.trim(),
+        assistantPrefill: assistantPrefill,
+    };
+}
+// ============================================================================
+// Prefill Continuation
+// ============================================================================
+/**
+ * Build a continuation request from accumulated output
+ */
+export function buildContinuationPrefill(originalResult, accumulated) {
+    // Update the last assistant message with accumulated content
+    const newMessages = [...originalResult.messages];
+    // Find the last assistant message or add one
+    const lastIdx = newMessages.length - 1;
+    if (lastIdx >= 0 && newMessages[lastIdx]?.role === 'assistant') {
+        newMessages[lastIdx] = {
+            role: 'assistant',
+            content: accumulated,
+        };
+    }
+    else {
+        newMessages.push({
+            role: 'assistant',
+            content: accumulated,
+        });
+    }
+    return {
+        ...originalResult,
+        messages: newMessages,
+        assistantPrefill: accumulated,
+    };
+}
+//# sourceMappingURL=prefill.js.map