@animalabs/membrane 0.5.50 → 0.5.52

package/dist/providers/utils.js

@@ -0,0 +1,100 @@
+/**
+ * Safely parse a JSON string, returning an empty object on failure.
+ * Used for tool call arguments which may be malformed from streaming.
+ */
+export function safeParseJson(str) {
+    try {
+        return JSON.parse(str || '{}');
+    }
+    catch (e) {
+        console.warn('[membrane] Failed to parse tool arguments JSON:', e);
+        return {};
+    }
+}
+/**
+ * Create a combined AbortSignal that fires on either the caller's signal
+ * or a timeout (whichever comes first).
+ *
+ * The returned `cleanup` function MUST be called in a `finally` block to
+ * clear the timeout and remove the event listener, preventing leaks.
+ *
+ * Timeout aborts with `DOMException('Request timed out', 'AbortError')`
+ * so it classifies identically to user-initiated aborts.
+ */
+export function createCombinedSignal(signal, timeoutMs) {
+    if (!signal && !timeoutMs)
+        return {};
+    if (signal && !timeoutMs)
+        return { signal };
+    const controller = new AbortController();
+    let timeoutId;
+    if (timeoutMs) {
+        timeoutId = setTimeout(() => controller.abort(new DOMException('Request timed out', 'AbortError')), timeoutMs);
+    }
+    const onAbort = () => controller.abort(signal.reason);
+    if (signal) {
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+        }
+        else {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (signal)
+                signal.removeEventListener('abort', onAbort);
+        },
+    };
+}
+/**
+ * SSE (Server-Sent Events) line parser that correctly handles events
+ * split across multiple TCP chunks.
+ *
+ * The naive approach of `chunk.split('\n').filter(l => l.startsWith('data: '))`
+ * silently drops events when an SSE line spans two chunks:
+ *   Chunk 1: `data: {"choices":[{"delta":{"content":"don'`  (no newline — incomplete)
+ *   Chunk 2: `t do that"}}]}\n`                              (doesn't start with `data: `)
+ * Result: the entire event is lost, causing "skipped words" in output.
+ *
+ * This parser buffers partial lines and only yields complete `data: ...` lines.
+ */
+export class SSELineParser {
+    buffer = '';
+    /**
+     * Feed a raw chunk from the stream reader and get back complete SSE data lines.
+     * Each returned string is the content after `data: ` (e.g. the JSON payload or `[DONE]`).
+     */
+    feed(chunk) {
+        this.buffer += chunk;
+        const results = [];
+        // Split on newlines, keeping the last (potentially incomplete) segment in the buffer
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() || '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('data: ')) {
+                results.push(trimmed.slice(6));
+            }
+            // Skip empty lines, comments (`:...`), and other SSE fields (event:, id:, retry:)
+        }
+        return results;
+    }
+    /**
+     * Flush any remaining buffered content (call when stream ends).
+     */
+    flush() {
+        if (!this.buffer.trim())
+            return [];
+        const trimmed = this.buffer.trim();
+        this.buffer = '';
+        if (trimmed.startsWith('data: ')) {
+            return [trimmed.slice(6)];
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/providers/utils.js.map

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

package/dist/registry/default-pricing.d.ts

@@ -0,0 +1,3 @@
+import type { ModelPricing } from '../types/provider.js';
+export declare function getDefaultPricing(modelId: string): ModelPricing | undefined;
+//# sourceMappingURL=default-pricing.d.ts.map

package/dist/registry/default-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-pricing.d.ts","sourceRoot":"","sources":["../../src/registry/default-pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAkEzD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAU3E"}

package/dist/registry/default-pricing.js

@@ -0,0 +1,75 @@
+/**
+ * Built-in pricing table for known models.
+ * Prices in USD per million tokens. Last updated: 2025-07.
+ *
+ * Used as fallback when no ModelRegistry is configured.
+ * Registry pricing (if available) takes precedence.
+ */
+const PRICING_TABLE = [
+    // Anthropic — Claude 4.6
+    {
+        prefix: 'claude-opus-4-6',
+        pricing: { inputPerMillion: 15, outputPerMillion: 75, cacheWritePerMillion: 18.75, cacheReadPerMillion: 1.50, currency: 'USD' },
+    },
+    {
+        prefix: 'claude-sonnet-4-6',
+        pricing: { inputPerMillion: 3, outputPerMillion: 15, cacheWritePerMillion: 3.75, cacheReadPerMillion: 0.30, currency: 'USD' },
+    },
+    // Anthropic — Claude 4.5
+    {
+        prefix: 'claude-haiku-4-5',
+        pricing: { inputPerMillion: 0.80, outputPerMillion: 4, cacheWritePerMillion: 1.00, cacheReadPerMillion: 0.08, currency: 'USD' },
+    },
+    // Anthropic — Claude 4
+    {
+        prefix: 'claude-opus-4',
+        pricing: { inputPerMillion: 15, outputPerMillion: 75, cacheWritePerMillion: 18.75, cacheReadPerMillion: 1.50, currency: 'USD' },
+    },
+    {
+        prefix: 'claude-sonnet-4',
+        pricing: { inputPerMillion: 3, outputPerMillion: 15, cacheWritePerMillion: 3.75, cacheReadPerMillion: 0.30, currency: 'USD' },
+    },
+    // Anthropic — Claude 3.5
+    {
+        prefix: 'claude-3-5-sonnet',
+        pricing: { inputPerMillion: 3, outputPerMillion: 15, cacheWritePerMillion: 3.75, cacheReadPerMillion: 0.30, currency: 'USD' },
+    },
+    {
+        prefix: 'claude-3-5-haiku',
+        pricing: { inputPerMillion: 0.80, outputPerMillion: 4, cacheWritePerMillion: 1.00, cacheReadPerMillion: 0.08, currency: 'USD' },
+    },
+    // OpenAI — GPT-4o
+    {
+        prefix: 'gpt-4o-2024',
+        pricing: { inputPerMillion: 2.50, outputPerMillion: 10, cacheReadPerMillion: 1.25, currency: 'USD' },
+    },
+    {
+        prefix: 'gpt-4o',
+        pricing: { inputPerMillion: 2.50, outputPerMillion: 10, cacheReadPerMillion: 1.25, currency: 'USD' },
+    },
+    {
+        prefix: 'gpt-4o-mini',
+        pricing: { inputPerMillion: 0.15, outputPerMillion: 0.60, cacheReadPerMillion: 0.075, currency: 'USD' },
+    },
+    // Google — Gemini 2.5
+    {
+        prefix: 'gemini-2.5-pro',
+        pricing: { inputPerMillion: 1.25, outputPerMillion: 10, currency: 'USD' },
+    },
+    {
+        prefix: 'gemini-2.5-flash',
+        pricing: { inputPerMillion: 0.15, outputPerMillion: 0.60, currency: 'USD' },
+    },
+];
+export function getDefaultPricing(modelId) {
+    let best;
+    let bestLen = 0;
+    for (const entry of PRICING_TABLE) {
+        if (modelId.startsWith(entry.prefix) && entry.prefix.length > bestLen) {
+            best = entry.pricing;
+            bestLen = entry.prefix.length;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=default-pricing.js.map

package/dist/registry/default-pricing.js.map

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

package/dist/transforms/chat.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Chat mode transforms
+ *
+ * Converts normalized messages to role-based alternating format
+ * for providers that don't support prefill mode.
+ */
+import type { NormalizedRequest } from '../types/index.js';
+export interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: ChatContent[];
+}
+export type ChatContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    source: {
+        type: 'base64';
+        data: string;
+        mediaType: string;
+    };
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+};
+export interface ChatTransformResult {
+    /** System prompt */
+    system: string;
+    /** Messages in role-based format */
+    messages: ChatMessage[];
+    /** Stop sequences to use */
+    stopSequences: string[];
+}
+export interface ChatTransformOptions {
+    /** Name of the assistant participant (default: 'Claude') */
+    assistantName?: string;
+    /** Names to treat as 'user' role */
+    userParticipants?: string[];
+    /** How to handle multiple consecutive same-role messages */
+    mergeStrategy?: 'concatenate' | 'separate';
+}
+/**
+ * Transform normalized request to chat format
+ */
+export declare function transformToChat(request: NormalizedRequest, options?: ChatTransformOptions): ChatTransformResult;
+//# sourceMappingURL=chat.d.ts.map

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,5 @@
+/**
+ * Transform exports
+ */
+export { transformToChat, type ChatTransformResult, type ChatTransformOptions, type ChatMessage, type ChatContent, } from './chat.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transforms/index.js

@@ -0,0 +1,7 @@
+/**
+ * Transform exports
+ */
+// Note: transformToPrefill was removed in v0.4.0
+// Use formatter.buildMessages() instead (see PrefillFormatter interface)
+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,iDAAiD;AACjD,yEAAyE;AAEzE,OAAO,EACL,eAAe,GAKhB,MAAM,WAAW,CAAC"}

package/dist/types/config.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Configuration types for membrane
+ */
+import type { ModelRegistry } from './provider.js';
+import type { ErrorInfo } from './errors.js';
+import type { NormalizedRequest } from './request.js';
+import type { NormalizedResponse } from './response.js';
+import type { PrefillFormatter } from '../formatters/types.js';
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries: number;
+    /** Initial retry delay in milliseconds (default: 1000) */
+    retryDelayMs: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier: number;
+    /** Maximum retry delay (default: 30000) */
+    maxRetryDelayMs: number;
+}
+export interface MediaConfig {
+    images: {
+        /** Maximum input image size in bytes */
+        maxSizeBytes: number;
+        /** Maximum dimensions */
+        maxDimensions?: {
+            width: number;
+            height: number;
+        };
+        /** Auto-resize if exceeds limits */
+        autoResize: boolean;
+        /** JPEG quality for resizing (0-100) */
+        resizeQuality?: number;
+        /** Relocate images to user turns in prefill mode */
+        relocateInPrefillMode: boolean;
+    };
+    documents?: {
+        /** Maximum document size */
+        maxSizeBytes: number;
+    };
+    audio?: {
+        /** Maximum duration in seconds */
+        maxDurationSec: number;
+    };
+    video?: {
+        /** Maximum duration in seconds */
+        maxDurationSec: number;
+    };
+}
+export interface MembraneHooks {
+    /**
+     * Called before sending request to provider
+     * Can modify the raw request
+     */
+    beforeRequest?: (request: NormalizedRequest, rawRequest: unknown) => unknown | Promise<unknown>;
+    /**
+     * Called after receiving response from provider
+     * Can modify the response
+     */
+    afterResponse?: (response: NormalizedResponse, rawResponse: unknown) => NormalizedResponse | Promise<NormalizedResponse>;
+    /**
+     * Called on error, before retry decision
+     * Return 'retry' to retry, 'abort' to stop
+     */
+    onError?: (error: ErrorInfo, attempt: number) => 'retry' | 'abort' | Promise<'retry' | 'abort'>;
+}
+export interface MembraneLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+export interface MembraneConfig {
+    /** Model registry for capability lookup */
+    registry?: ModelRegistry;
+    /** Default model to use */
+    defaultModel?: string;
+    /**
+     * Participant name to recognize as assistant in prefill mode.
+     * Messages with this participant will be formatted as assistant turns.
+     * Default: 'Claude'
+     */
+    assistantParticipant?: string;
+    /**
+     * Maximum number of participants to include in auto-generated stop sequences.
+     * In prefill mode, membrane generates stop sequences like "\nUsername:" to prevent
+     * the model from speaking as other participants.
+     *
+     * Set to 0 to disable participant-based stop sequences (allows frags/quotes).
+     * Default: 10
+     */
+    maxParticipantsForStop?: number;
+    /**
+     * Prefill formatter for message serialization and response parsing.
+     * Controls how messages are formatted for the API and how responses are parsed.
+     * Default: AnthropicXmlFormatter
+     */
+    formatter?: PrefillFormatter;
+    /** Retry configuration */
+    retry?: Partial<RetryConfig>;
+    /** Media processing configuration */
+    media?: Partial<MediaConfig>;
+    /** Lifecycle hooks */
+    hooks?: MembraneHooks;
+    /** Logger instance */
+    logger?: MembraneLogger;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export declare const DEFAULT_MEDIA_CONFIG: MediaConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.js

@@ -0,0 +1,21 @@
+/**
+ * Configuration types for membrane
+ */
+// ============================================================================
+// Default Config
+// ============================================================================
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 0,
+    retryDelayMs: 1000,
+    backoffMultiplier: 2,
+    maxRetryDelayMs: 30000,
+};
+export const DEFAULT_MEDIA_CONFIG = {
+    images: {
+        maxSizeBytes: 5 * 1024 * 1024, // 5MB (Anthropic limit)
+        autoResize: true,
+        resizeQuality: 85,
+        relocateInPrefillMode: true,
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+JH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,CAAC;IACpB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,MAAM,EAAE;QACN,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,wBAAwB;QACvD,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,EAAE;QACjB,qBAAqB,EAAE,IAAI;KAC5B;CACF,CAAC"}

package/dist/types/content.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Content block types for normalized messages
+ */
+export interface CacheControl {
+    type: 'ephemeral';
+    /** TTL for cache - '5m' (default) or '1h' for extended caching */
+    ttl?: '5m' | '1h';
+}
+export interface Base64Source {
+    type: 'base64';
+    data: string;
+    mediaType: string;
+}
+export interface UrlSource {
+    type: 'url';
+    url: string;
+}
+export type MediaSource = Base64Source | UrlSource;
+export interface TextContent {
+    type: 'text';
+    text: string;
+    /** Cache control for Anthropic prompt caching */
+    cache_control?: CacheControl;
+}
+export interface ImageContent {
+    type: 'image';
+    source: MediaSource;
+    tokenEstimate?: number;
+    /** Original URL of the image (e.g., Discord CDN). Used by providers that
+     *  can auto-fetch URLs from text (like Gemini 3.x) when inlineData is
+     *  not viable (e.g., missing thought_signature on model-role images). */
+    sourceUrl?: string;
+}
+export interface DocumentContent {
+    type: 'document';
+    source: Base64Source;
+    filename?: string;
+}
+export interface AudioContent {
+    type: 'audio';
+    source: Base64Source;
+    duration?: number;
+}
+export interface VideoContent {
+    type: 'video';
+    source: Base64Source;
+    duration?: number;
+}
+export interface GeneratedImageContent {
+    type: 'generated_image';
+    data: string;
+    mimeType: string;
+    isPreview?: boolean;
+}
+export interface ToolUseContent {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultContent {
+    type: 'tool_result';
+    toolUseId: string;
+    content: string | ContentBlock[];
+    isError?: boolean;
+}
+export interface ThinkingContent {
+    type: 'thinking';
+    thinking: string;
+    signature?: string;
+}
+export interface RedactedThinkingContent {
+    type: 'redacted_thinking';
+}
+export type ContentBlock = TextContent | ImageContent | DocumentContent | AudioContent | VideoContent | GeneratedImageContent | ToolUseContent | ToolResultContent | ThinkingContent | RedactedThinkingContent;
+export declare function isTextContent(block: ContentBlock): block is TextContent;
+export declare function isImageContent(block: ContentBlock): block is ImageContent;
+export declare function isDocumentContent(block: ContentBlock): block is DocumentContent;
+export declare function isAudioContent(block: ContentBlock): block is AudioContent;
+export declare function isVideoContent(block: ContentBlock): block is VideoContent;
+export declare function isGeneratedImageContent(block: ContentBlock): block is GeneratedImageContent;
+export declare function isToolUseContent(block: ContentBlock): block is ToolUseContent;
+export declare function isToolResultContent(block: ContentBlock): block is ToolResultContent;
+export declare function isThinkingContent(block: ContentBlock): block is ThinkingContent;
+export declare function isRedactedThinkingContent(block: ContentBlock): block is RedactedThinkingContent;
+export declare function isMediaContent(block: ContentBlock): block is ImageContent | DocumentContent | AudioContent | VideoContent;
+//# sourceMappingURL=content.d.ts.map

package/dist/types/content.d.ts.map

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