@animalabs/membrane 0.1.0

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * 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';
+// 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,qBAAqB;AACrB,cAAc,oBAAoB,CAAC"}

package/dist/membrane.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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';
+export declare class Membrane {
+    private adapter;
+    private registry?;
+    private retryConfig;
+    private config;
+    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;
+    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 calculateRetryDelay;
+    private sleep;
+    /**
+     * Check if an error is an abort error
+     */
+    private isAbortError;
+    /**
+     * Build an AbortedResponse from current execution state
+     */
+    private buildAbortedResponse;
+}
+//# sourceMappingURL=membrane.d.ts.map

package/dist/membrane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membrane.d.ts","sourceRoot":"","sources":["../src/membrane.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAEf,eAAe,EAEf,cAAc,EACd,aAAa,EACb,eAAe,EAYhB,MAAM,kBAAkB,CAAC;AA2B1B,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAiB;gBAG7B,OAAO,EAAE,eAAe,EACxB,MAAM,GAAE,cAAmB;IAY7B;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IA4D9B;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CACV,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,kBAAkB,GAAG,eAAe,CAAC;IAWhD;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;;;;OAMG;YACW,kBAAkB;IAgRhC;;OAEG;YACW,qBAAqB;IAyMnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsD9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,gBAAgB;YA2CV,UAAU;IAQxB,OAAO,CAAC,wBAAwB;IAuChC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,kCAAkC;IAuD1C,OAAO,CAAC,iBAAiB;IA8FzB,OAAO,CAAC,kBAAkB;IAyE1B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAoB7B"}