@animalabs/membrane 0.5.50 → 0.5.52

package/dist/formatters/native.js.map

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

package/dist/formatters/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Prefill Formatter Types
+ *
+ * Interfaces for pluggable prefill formatting and parsing.
+ */
+import type { NormalizedMessage, ContentBlock, ToolDefinition, ToolCall, ToolResult, BlockEvent } from '../types/index.js';
+import type { ChunkMeta, MembraneBlockType } from '../types/streaming.js';
+import type { StreamEmission, ProcessChunkResult } from '../utils/stream-parser.js';
+export type { BlockEvent, ChunkMeta, MembraneBlockType, StreamEmission };
+/** Block type alias for formatter contexts */
+export type BlockType = MembraneBlockType;
+export interface FormatterConfig {
+    /** How to handle unsupported media (images, etc.). Default: 'error' */
+    unsupportedMedia?: 'error' | 'strip';
+    /** Warn when stripping content. Default: true */
+    warnOnStrip?: boolean;
+}
+export interface BuildOptions {
+    /** How to handle multiple participants */
+    participantMode: 'simple' | 'multiuser';
+    /** Name of the assistant participant */
+    assistantParticipant: string;
+    /** Name of the human participant (for simple mode) */
+    humanParticipant?: string;
+    /** Tool definitions to include */
+    tools?: ToolDefinition[];
+    /** Whether thinking is enabled */
+    thinking?: {
+        enabled: boolean;
+        budgetTokens?: number;
+    };
+    /** System prompt content */
+    systemPrompt?: string | ContentBlock[];
+    /** Enable prompt caching (Anthropic-specific) */
+    promptCaching?: boolean;
+    /** Cache TTL for Anthropic prompt caching - '5m' (default) or '1h' for extended */
+    cacheTtl?: '5m' | '1h';
+    /** Additional stop sequences to include */
+    additionalStopSequences?: string[];
+    /** Maximum participants to include in stop sequences */
+    maxParticipantsForStop?: number;
+    /** Context prefix for simulacrum seeding (injected as first cached assistant message) */
+    contextPrefix?: string;
+    /** Custom content for the synthetic user message when first message is assistant role.
+     *  In prefill formatters: defaults to '<cmd>cat untitled.txt</cmd>' with a CLI simulation
+     *  system prompt when no system prompt is configured, or '[Start]' when a system prompt is set. */
+    prefillUserMessage?: string;
+    /**
+     * Function to check if a message has a cache marker.
+     * When provided, content before the marked message gets cache_control.
+     * This enables per-message cache boundaries in the conversation.
+     */
+    hasCacheMarker?: (message: NormalizedMessage, index: number) => boolean;
+}
+export interface BuildResult {
+    /** Messages in provider format */
+    messages: ProviderMessage[];
+    /** System content (if separate from messages) */
+    systemContent?: unknown;
+    /** Assistant prefill content (appended to last assistant message) */
+    assistantPrefill?: string;
+    /** Stop sequences for this format */
+    stopSequences: string[];
+    /** Tool definitions for API (if using native tools) */
+    nativeTools?: unknown[];
+    /** Number of cache control markers applied (for Anthropic prompt caching) */
+    cacheMarkersApplied?: number;
+}
+export interface ProviderMessage {
+    role: 'user' | 'assistant';
+    content: unknown;
+}
+/** Parse result from processing a chunk */
+export type ParseResult = ProcessChunkResult;
+export interface StreamParser {
+    /**
+     * Process a chunk of streamed content.
+     * Returns parsed events (text, blocks, etc.)
+     */
+    processChunk(chunk: string): ParseResult;
+    /**
+     * Flush any buffered content at end of stream.
+     */
+    flush(): ParseResult;
+    /**
+     * Get full accumulated content.
+     */
+    getAccumulated(): string;
+    /**
+     * Reset parser state completely.
+     */
+    reset(): void;
+    /**
+     * Push content without emitting (for prefill initialization).
+     */
+    push(content: string): void;
+    /**
+     * Get current block type being parsed.
+     */
+    getCurrentBlockType(): BlockType;
+    /**
+     * Get current block index.
+     */
+    getBlockIndex(): number;
+    /**
+     * Increment block index (for external block tracking).
+     */
+    incrementBlockIndex(): void;
+    /**
+     * Check if parser is inside a block (e.g., unclosed XML tag).
+     * Used for false-positive stop sequence detection.
+     */
+    isInsideBlock(): boolean;
+    /**
+     * Get current nesting depths for each block type.
+     * Used to compare against prefill baseline for false-positive detection.
+     */
+    getDepths(): {
+        functionCalls: number;
+        functionResults: number;
+        thinking: number;
+    };
+    /**
+     * Reset streaming state for a new API iteration.
+     * Keeps accumulated text and block depth state, but resets
+     * per-stream tracking so processChunk works correctly.
+     */
+    resetForNewIteration(): void;
+}
+export interface PrefillFormatter {
+    /** Formatter name for identification */
+    readonly name: string;
+    /** Whether this formatter uses prefill (vs native pass-through) */
+    readonly usesPrefill: boolean;
+    /**
+     * Transform normalized messages into provider-ready format.
+     */
+    buildMessages(messages: NormalizedMessage[], options: BuildOptions): BuildResult;
+    /**
+     * Format tool results for continuation request.
+     * Called when injecting tool results back into the conversation.
+     */
+    formatToolResults(results: ToolResult[], options?: {
+        thinking?: boolean;
+    }): string;
+    /**
+     * Create a stream parser for this format.
+     * Parser tracks state across chunks (e.g., XML depth, token boundaries).
+     */
+    createStreamParser(): StreamParser;
+    /**
+     * Parse tool calls from accumulated content.
+     * Returns empty array if no tool calls detected.
+     */
+    parseToolCalls(content: string): ToolCall[];
+    /**
+     * Check if content indicates tool use.
+     * Used to determine stop reason.
+     */
+    hasToolUse(content: string): boolean;
+    /**
+     * Parse content blocks from accumulated response.
+     * Extracts text, thinking, tool_use blocks, etc.
+     */
+    parseContentBlocks(content: string): ContentBlock[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/formatters/types.js

@@ -0,0 +1,7 @@
+/**
+ * Prefill Formatter Types
+ *
+ * Interfaces for pluggable prefill formatting and parsing.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/formatters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/formatters/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Membrane - LLM middleware
+ *
+ * A selective boundary that transforms what passes through.
+ */
+export { Membrane } from './membrane.js';
+export * from './types/index.js';
+export * from './transforms/index.js';
+export * from './providers/index.js';
+export * from './utils/index.js';
+export * from './formatters/index.js';
+export * from './context/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Membrane - LLM middleware
+ *
+ * A selective boundary that transforms what passes through.
+ */
+// Core class
+export { Membrane } from './membrane.js';
+// Types
+export * from './types/index.js';
+// Transforms
+export * from './transforms/index.js';
+// Providers
+export * from './providers/index.js';
+// Utilities
+export * from './utils/index.js';
+// Formatters
+export * from './formatters/index.js';
+// Context management
+export * from './context/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,YAAY;AACZ,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,qBAAqB;AACrB,cAAc,oBAAoB,CAAC"}

package/dist/membrane.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Membrane - LLM middleware core class
+ *
+ * A selective boundary that transforms what passes through.
+ */
+import type { NormalizedRequest, NormalizedResponse, AbortedResponse, ProviderAdapter, MembraneConfig, StreamOptions, CompleteOptions } from './types/index.js';
+import type { YieldingStream, YieldingStreamOptions } from './types/yielding-stream.js';
+export declare class Membrane {
+    private adapter;
+    private registry?;
+    private retryConfig;
+    private config;
+    private formatter;
+    constructor(adapter: ProviderAdapter, config?: MembraneConfig);
+    /**
+     * Complete a request (non-streaming)
+     */
+    complete(request: NormalizedRequest, options?: CompleteOptions): Promise<NormalizedResponse>;
+    /**
+     * Stream a request with inline tool execution.
+     *
+     * Returns either a complete NormalizedResponse or an AbortedResponse
+     * if the request was cancelled via the abort signal. Use `isAbortedResponse()`
+     * to check which type was returned.
+     *
+     * @example
+     * ```typescript
+     * const result = await membrane.stream(request, { signal: controller.signal });
+     * if (isAbortedResponse(result)) {
+     *   console.log('Aborted:', result.rawAssistantText);
+     *   // Use rawAssistantText as prefill to continue, or toolCalls/toolResults to rebuild state
+     * } else {
+     *   console.log('Complete:', result.content);
+     * }
+     * ```
+     */
+    stream(request: NormalizedRequest, options?: StreamOptions): Promise<NormalizedResponse | AbortedResponse>;
+    /**
+     * Determine the effective tool mode
+     */
+    private resolveToolMode;
+    /**
+     * Stream with XML-based tool execution (prefill mode)
+     *
+     * Uses IncrementalXmlParser to track XML nesting depth for:
+     * - False-positive stop sequence detection (e.g., "\nUser:" inside tool results)
+     * - Structured block events for UI
+     */
+    private streamWithXmlTools;
+    /**
+     * Stream with native API tool execution
+     */
+    private streamWithNativeTools;
+    /**
+     * Build a provider request with native tool support
+     */
+    private buildNativeToolRequest;
+    /**
+     * Parse provider response content into normalized blocks
+     */
+    private parseProviderContent;
+    /**
+     * Apply the configured `beforeRequest` hook to a provider-format request.
+     * Returns the (possibly modified) request, or the original if no hook is
+     * configured. This is the single point that all request-build sites should
+     * route through before invoking the adapter, so observers / mutators
+     * (logging, redaction, model rewriting) see every API call regardless of
+     * whether it came from `complete()`, `stream()`, or `streamYielding()`.
+     */
+    private applyBeforeRequestHook;
+    /**
+     * Extract base provider params from config, with thinking temperature enforcement.
+     * Used by transformRequest, buildContinuationRequest, and buildContinuationRequestWithImages.
+     */
+    private getBaseProviderParams;
+    /**
+     * Transform a normalized request into provider format using the formatter
+     */
+    private transformRequest;
+    private streamOnce;
+    private buildContinuationRequest;
+    /**
+     * Build continuation request with split-turn image injection.
+     *
+     * When tool results contain images in prefill mode, we must:
+     * 1. End assistant turn mid-XML (after text content, inside <function_results>)
+     * 2. Insert user turn with only image content
+     * 3. Continue with assistant prefill containing closing XML tags
+     *
+     * This is required because Anthropic API only allows images in user turns.
+     *
+     * Structure:
+     * ```
+     * Assistant: "...response..." + <function_results><result>text content
+     * User: [image blocks]
+     * Assistant (prefill): </result></function_results>
+     * ```
+     */
+    private buildContinuationRequestWithImages;
+    private transformResponse;
+    private buildFinalResponse;
+    private mapStopReason;
+    private calculateCacheHitRatio;
+    private resolvePricing;
+    /** Resolve pricing + calculate cost in one call (for one-shot use outside loops). */
+    private estimateCost;
+    private calculateRetryDelay;
+    private attachRawRequest;
+    private sleep;
+    /**
+     * Check if an error is an abort error
+     */
+    private isAbortError;
+    /**
+     * Build an AbortedResponse from current execution state
+     */
+    private buildAbortedResponse;
+    /**
+     * Stream inference with yielding control for tool execution.
+     *
+     * Unlike `stream()` which uses callbacks for tool execution, this method
+     * returns an async iterator that yields control back to the caller when
+     * tool calls are detected. The caller provides results via `provideToolResults()`.
+     *
+     * @example
+     * ```typescript
+     * const stream = membrane.streamYielding(request, options);
+     *
+     * for await (const event of stream) {
+     *   switch (event.type) {
+     *     case 'tokens':
+     *       process.stdout.write(event.content);
+     *       break;
+     *     case 'tool-calls':
+     *       const results = await executeTools(event.calls);
+     *       stream.provideToolResults(results);
+     *       break;
+     *     case 'complete':
+     *       console.log('Done:', event.response);
+     *       break;
+     *   }
+     * }
+     * ```
+     */
+    streamYielding(request: NormalizedRequest, options?: YieldingStreamOptions): YieldingStream;
+    /**
+     * Run XML-based tool execution with yielding stream.
+     */
+    private runXmlToolsYielding;
+    /**
+     * Run native tool execution with yielding stream.
+     */
+    private runNativeToolsYielding;
+}
+//# sourceMappingURL=membrane.d.ts.map

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Anthropic provider adapter
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import type { ProviderAdapter, ProviderRequest, ProviderRequestOptions, ProviderResponse, StreamCallbacks, ContentBlock } from '../types/index.js';
+export interface AnthropicAdapterConfig {
+    /** API key (defaults to ANTHROPIC_API_KEY env var) */
+    apiKey?: string;
+    /** Base URL override */
+    baseURL?: string;
+    /** Default max tokens */
+    defaultMaxTokens?: number;
+}
+export declare class AnthropicAdapter implements ProviderAdapter {
+    readonly name = "anthropic";
+    private client;
+    private defaultMaxTokens;
+    constructor(config?: AnthropicAdapterConfig);
+    supportsModel(modelId: string): boolean;
+    complete(request: ProviderRequest, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    stream(request: ProviderRequest, callbacks: StreamCallbacks, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    private buildRequest;
+    private parseResponse;
+    private handleError;
+    private parseRetryAfter;
+}
+/**
+ * Convert normalized content blocks to Anthropic format
+ * Preserves cache_control for prompt caching
+ */
+export declare function toAnthropicContent(blocks: ContentBlock[]): Anthropic.ContentBlockParam[];
+/**
+ * Convert Anthropic response content to normalized format
+ */
+export declare function fromAnthropicContent(blocks: Anthropic.ContentBlock[]): ContentBlock[];
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/bedrock.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AWS Bedrock provider adapter for Anthropic Claude models
+ *
+ * Uses the Anthropic Messages API format through AWS Bedrock.
+ */
+import type { ProviderAdapter, ProviderRequest, ProviderRequestOptions, ProviderResponse, StreamCallbacks } from '../types/index.js';
+export interface BedrockAdapterConfig {
+    /** AWS access key ID */
+    accessKeyId?: string;
+    /** AWS secret access key */
+    secretAccessKey?: string;
+    /** AWS region (defaults to us-west-2) */
+    region?: string;
+    /** AWS session token (for temporary credentials) */
+    sessionToken?: string;
+    /** Default max tokens */
+    defaultMaxTokens?: number;
+    /** Anthropic API version header (defaults to 2023-06-01) */
+    anthropicVersion?: string;
+}
+export declare class BedrockAdapter implements ProviderAdapter {
+    readonly name = "bedrock";
+    private accessKeyId;
+    private secretAccessKey;
+    private sessionToken?;
+    private region;
+    private defaultMaxTokens;
+    private anthropicVersion;
+    constructor(config?: BedrockAdapterConfig);
+    supportsModel(modelId: string): boolean;
+    /**
+     * Convert a standard Claude model ID to Bedrock format if needed
+     */
+    private toBedrockModelId;
+    complete(request: ProviderRequest, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    stream(request: ProviderRequest, callbacks: StreamCallbacks, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    private buildRequest;
+    private invokeModel;
+    private invokeModelWithStream;
+    private parseResponse;
+    private handleError;
+}
+//# sourceMappingURL=bedrock.d.ts.map

package/dist/providers/gemini.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Google Gemini provider adapter
+ *
+ * Direct adapter for Google's Generative AI REST API.
+ * Supports Gemini 2.x, 2.5, 3.x models with:
+ * - Text and image input
+ * - Tool/function calling
+ * - Streaming via SSE
+ *
+ * Auth: API key passed as query parameter (?key=...)
+ * Endpoint: generativelanguage.googleapis.com/v1beta
+ */
+import type { ProviderAdapter, ProviderRequest, ProviderRequestOptions, ProviderResponse, StreamCallbacks, ContentBlock } from '../types/index.js';
+interface GeminiPart {
+    text?: string;
+    inlineData?: {
+        mimeType: string;
+        data: string;
+    };
+    functionCall?: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    functionResponse?: {
+        name: string;
+        response: Record<string, unknown>;
+    };
+}
+export interface GeminiAdapterConfig {
+    /** Google AI API key */
+    apiKey?: string;
+    /** Base URL (default: https://generativelanguage.googleapis.com/v1beta) */
+    baseURL?: string;
+    /** Default max output tokens */
+    defaultMaxTokens?: number;
+}
+export declare class GeminiAdapter implements ProviderAdapter {
+    readonly name = "gemini";
+    private apiKey;
+    private baseURL;
+    private defaultMaxTokens;
+    constructor(config?: GeminiAdapterConfig);
+    supportsModel(modelId: string): boolean;
+    complete(request: ProviderRequest, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    stream(request: ProviderRequest, callbacks: StreamCallbacks, options?: ProviderRequestOptions): Promise<ProviderResponse>;
+    private buildRequest;
+    private convertMessages;
+    /**
+     * Gemini requires strictly alternating user/model messages.
+     * Merge consecutive messages with the same role into one.
+     */
+    private mergeConsecutiveRoles;
+    private convertTools;
+    private parseResponse;
+    private buildContentBlocks;
+    private mapFinishReason;
+    private handleError;
+}
+/**
+ * Convert normalized content blocks to Gemini parts
+ */
+export declare function toGeminiParts(blocks: ContentBlock[]): GeminiPart[];
+/**
+ * Convert Gemini parts to normalized content blocks
+ */
+export declare function fromGeminiParts(parts: GeminiPart[]): ContentBlock[];
+export {};
+//# sourceMappingURL=gemini.d.ts.map