@animalabs/membrane 0.5.69 → 0.5.71

package/dist/types/content.d.ts

@@ -21,6 +21,14 @@ export interface TextContent {
     text: string;
     /** Cache control for Anthropic prompt caching */
     cache_control?: CacheControl;
+    /**
+     * Opaque provider-native item this block was derived from (e.g. an OpenAI
+     * Responses output item). Provider-native formatters replay it verbatim;
+     * other providers must ignore it. A zero-width carrier (`text: ''` plus
+     * `rawItem`) has no normalized equivalent and must be filtered out of
+     * requests for providers that reject empty text blocks (Anthropic).
+     */
+    rawItem?: unknown;
 }
 export interface ImageContent {
     type: 'image';
@@ -30,44 +38,60 @@ export interface ImageContent {
      *  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;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface DocumentContent {
     type: 'document';
     source: Base64Source;
     filename?: string;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface AudioContent {
     type: 'audio';
     source: Base64Source;
     duration?: number;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface VideoContent {
     type: 'video';
     source: Base64Source;
     duration?: number;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface GeneratedImageContent {
     type: 'generated_image';
     data: string;
     mimeType: string;
     isPreview?: boolean;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface ToolUseContent {
     type: 'tool_use';
     id: string;
     name: string;
     input: Record<string, unknown>;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface ToolResultContent {
     type: 'tool_result';
     toolUseId: string;
     content: string | ContentBlock[];
     isError?: boolean;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface ThinkingContent {
     type: 'thinking';
     thinking: string;
     signature?: string;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export interface RedactedThinkingContent {
     type: 'redacted_thinking';
@@ -77,6 +101,8 @@ export interface RedactedThinkingContent {
      * (the API decrypts it to reconstruct prior reasoning).
      */
     data: string;
+    /** See {@link TextContent.rawItem}. */
+    rawItem?: unknown;
 }
 export type ContentBlock = TextContent | ImageContent | DocumentContent | AudioContent | VideoContent | GeneratedImageContent | ToolUseContent | ToolResultContent | ThinkingContent | RedactedThinkingContent;
 export declare function isTextContent(block: ContentBlock): block is TextContent;

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

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

package/dist/types/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8IH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,OAAO,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAmB;IAC3D,OAAO,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAmB;IAEnB,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwKH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,UAAU,aAAa,CAAC,KAAmB;IAC/C,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,OAAO,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,OAAO,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAmB;IAC3D,OAAO,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAmB;IAEnB,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animalabs/membrane",
-  "version": "0.5.69",
+  "version": "0.5.71",
   "description": "LLM middleware - a selective boundary that transforms what passes through",
   "repository": {
     "type": "git",

package/src/formatters/index.ts

@@ -16,6 +16,10 @@ export type {
 
 export { AnthropicXmlFormatter, type AnthropicXmlFormatterConfig } from './anthropic-xml.js';
 export { NativeFormatter, type NativeFormatterConfig } from './native.js';
+export {
+  OpenAIResponsesFormatter,
+  OPENAI_RESPONSES_ITEMS_METADATA_KEY,
+} from './openai-responses.js';
 export { CompletionsFormatter, type CompletionsFormatterConfig } from './completions.js';
 
 export {

package/src/formatters/native.ts

@@ -395,6 +395,11 @@ export class NativeFormatter implements PrefillFormatter {
 
     for (const block of content) {
       if (block.type === 'text') {
+        // Empty text blocks are rejected by the Anthropic API. In particular,
+        // zero-width rawItem carriers (opaque provider-native items smuggled
+        // through normalized history) must not leak here. Filter BEFORE the
+        // name prefix below would make them non-empty.
+        if (block.text === '') continue;
         let text = block.text;
         if (options.includeNames) {
           const prefix = this.config.nameFormat.replace('{name}', participant);

package/src/formatters/openai-responses.ts

@@ -0,0 +1,220 @@
+/**
+ * Formatter for stateless, provider-native OpenAI Responses histories.
+ *
+ * Imported/native items are carried either in message metadata under
+ * `openaiResponsesItems` or on content blocks as `rawItem`. Those items are
+ * emitted verbatim and in order. Normalized messages created after import are
+ * converted to Responses input items without rewriting the native prefix.
+ */
+
+import type {
+  ContentBlock,
+  NormalizedMessage,
+  ToolCall,
+  ToolResult,
+} from '../types/index.js';
+import type {
+  BuildOptions,
+  BuildResult,
+  BlockEvent,
+  ParseResult,
+  PrefillFormatter,
+  StreamEmission,
+  StreamParser,
+} from './types.js';
+
+export const OPENAI_RESPONSES_ITEMS_METADATA_KEY = 'openaiResponsesItems';
+
+class ResponsesPassthroughParser implements StreamParser {
+  private accumulated = '';
+  private blockIndex = 0;
+  private blockStarted = false;
+
+  push(chunk: string): void { this.accumulated += chunk; }
+  processChunk(chunk: string): ParseResult {
+    this.accumulated += chunk;
+    const meta = { type: 'text' as const, visible: true, blockIndex: this.blockIndex };
+    const emissions: StreamEmission[] = [];
+    const blockEvents: BlockEvent[] = [];
+    if (!this.blockStarted) {
+      const event: BlockEvent = { event: 'block_start', index: this.blockIndex, block: { type: 'text' } };
+      emissions.push({ kind: 'blockEvent', event });
+      blockEvents.push(event);
+      this.blockStarted = true;
+    }
+    emissions.push({ kind: 'content', text: chunk, meta });
+    return { emissions, content: [{ text: chunk, meta }], blockEvents };
+  }
+  flush(): ParseResult {
+    const emissions: StreamEmission[] = [];
+    const blockEvents: BlockEvent[] = [];
+    if (this.blockStarted) {
+      const event: BlockEvent = {
+        event: 'block_complete', index: this.blockIndex,
+        block: { type: 'text', content: this.accumulated },
+      };
+      emissions.push({ kind: 'blockEvent', event });
+      blockEvents.push(event);
+      this.blockStarted = false;
+    }
+    return { emissions, content: [], blockEvents };
+  }
+  getAccumulated(): string { return this.accumulated; }
+  reset(): void { this.accumulated = ''; this.blockIndex = 0; this.blockStarted = false; }
+  isInsideBlock(): boolean { return false; }
+  getCurrentBlockType() { return 'text' as const; }
+  getBlockIndex(): number { return this.blockIndex; }
+  incrementBlockIndex(): void { this.blockIndex++; }
+  getDepths() { return { functionCalls: 0, functionResults: 0, thinking: 0 }; }
+  resetForNewIteration(): void {}
+}
+
+type NativeItem = { type?: string; id?: string; [key: string]: unknown };
+
+export class OpenAIResponsesFormatter implements PrefillFormatter {
+  readonly name = 'openai-responses';
+  readonly usesPrefill = false;
+
+  buildMessages(messages: NormalizedMessage[], options: BuildOptions): BuildResult {
+    const items: NativeItem[] = [];
+    let hasImportedItems = false;
+
+    for (const message of messages) {
+      const nativeItems = message.metadata?.[OPENAI_RESPONSES_ITEMS_METADATA_KEY];
+      if (Array.isArray(nativeItems)) {
+        items.push(...nativeItems as NativeItem[]);
+        hasImportedItems = true;
+        continue;
+      }
+
+      const seenRawItems = new Set<string>();
+      let pendingParts: ContentBlock[] = [];
+      const flushPending = () => {
+        if (pendingParts.length === 0) return;
+        items.push(...this.convertBlocks(message, pendingParts, options.assistantParticipant));
+        pendingParts = [];
+      };
+
+      for (const block of message.content) {
+        const rawItem = block.rawItem as NativeItem | undefined;
+        if (!rawItem || typeof rawItem !== 'object') {
+          pendingParts.push(block);
+          continue;
+        }
+
+        flushPending();
+        const key = typeof rawItem.id === 'string'
+          ? `${rawItem.type ?? ''}:${rawItem.id}`
+          : JSON.stringify(rawItem);
+        if (!seenRawItems.has(key)) {
+          items.push(rawItem);
+          seenRawItems.add(key);
+        }
+      }
+      flushPending();
+    }
+
+    // An imported rollout already carries its own developer/system items, and
+    // re-injecting the recipe prompt over them would double the instructions.
+    // Suppress the system prompt ONLY for imported histories — signalled by
+    // the import metadata key or by a developer/system item in the native
+    // prefix. Blocks with `rawItem` do NOT count: every response from this
+    // provider attaches rawItem (see parseProviderContent), so keying on it
+    // would silently drop a fresh session's system prompt from turn 2 onward
+    // (turn 1 sends it as the top-level `instructions` request field, never
+    // as an input item, and the adapter is stateless — nothing else retains
+    // it). `instructions` is a separate request field, so re-sending it does
+    // not perturb the input-item prefix or its caching.
+    const hasImportedSystemItem = hasImportedItems ||
+      items.some(item =>
+        (item.type === 'message' || item.type === undefined) &&
+        ((item as { role?: unknown }).role === 'developer' ||
+          (item as { role?: unknown }).role === 'system'));
+
+    return {
+      // BuildResult's historical type says chat envelopes, but Membrane's
+      // provider boundary deliberately accepts unknown provider-native items.
+      messages: items as unknown as BuildResult['messages'],
+      systemContent: hasImportedSystemItem ? undefined : options.systemPrompt,
+      stopSequences: options.additionalStopSequences ?? [],
+      nativeTools: options.tools?.map(tool => ({
+        type: 'function',
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.inputSchema,
+      })),
+      ready: true,
+    };
+  }
+
+  private convertBlocks(
+    message: NormalizedMessage,
+    blocks: ContentBlock[],
+    assistantParticipant: string,
+  ): NativeItem[] {
+    const isAssistant = message.participant === assistantParticipant;
+    const out: NativeItem[] = [];
+    let messageParts: unknown[] = [];
+
+    const flushMessage = () => {
+      if (messageParts.length === 0) return;
+      out.push({
+        type: 'message',
+        role: isAssistant ? 'assistant' : 'user',
+        content: messageParts,
+      });
+      messageParts = [];
+    };
+
+    for (const block of blocks) {
+      if (block.type === 'text') {
+        messageParts.push({
+          type: isAssistant ? 'output_text' : 'input_text',
+          text: block.text,
+        });
+      } else if (block.type === 'image' && !isAssistant) {
+        const source = block.source;
+        messageParts.push(source.type === 'url'
+          ? { type: 'input_image', image_url: source.url }
+          : { type: 'input_image', image_url: `data:${source.mediaType};base64,${source.data}` });
+      } else if (block.type === 'tool_use') {
+        flushMessage();
+        out.push({
+          type: 'function_call',
+          call_id: block.id,
+          name: block.name,
+          arguments: JSON.stringify(block.input ?? {}),
+        });
+      } else if (block.type === 'tool_result') {
+        flushMessage();
+        out.push({
+          type: 'function_call_output',
+          call_id: block.toolUseId,
+          output: typeof block.content === 'string'
+            ? block.content
+            : JSON.stringify(block.content),
+        });
+      } else if (block.type === 'redacted_thinking') {
+        flushMessage();
+        out.push({ type: 'reasoning', encrypted_content: block.data });
+      }
+    }
+    flushMessage();
+    return out;
+  }
+
+  formatToolResults(results: ToolResult[]): string {
+    return JSON.stringify(results.map(result => ({
+      type: 'function_call_output',
+      call_id: result.toolUseId,
+      output: result.content,
+    })));
+  }
+
+  createStreamParser(): StreamParser { return new ResponsesPassthroughParser(); }
+  parseToolCalls(_content: string): ToolCall[] { return []; }
+  hasToolUse(_content: string): boolean { return false; }
+  parseContentBlocks(content: string): ContentBlock[] {
+    return content ? [{ type: 'text', text: content }] : [];
+  }
+}

package/src/membrane.ts

@@ -236,7 +236,7 @@ export class Membrane {
     // Auto mode: choose based on formatter
     // NativeFormatter → native tools via API
     // AnthropicXmlFormatter (default) → XML tools in prefill
-    if (this.formatter.name === 'native') {
+    if (this.formatter.name === 'native' || this.formatter.name === 'openai-responses') {
       return 'native';
     }
 
@@ -986,6 +986,14 @@ export class Membrane {
     request: NormalizedRequest,
     messages: typeof request.messages
   ): any {
+    // Provider-native formatters own their complete input-item shape. The
+    // legacy implementation below is intentionally Anthropic-specific; using
+    // it for Responses would normalize away item IDs, encrypted reasoning,
+    // assistant phases, and compaction items.
+    if (this.formatter.name === 'openai-responses') {
+      return this.transformRequest({ ...request, messages }, this.formatter).providerRequest;
+    }
+
     // Convert messages to provider format
     const providerMessages: any[] = [];
     
@@ -1012,6 +1020,11 @@ export class Membrane {
       const includeNamePrefix = !isAssistant;
       for (const block of msg.content) {
         if (block.type === 'text') {
+          // Empty text blocks are rejected by the Anthropic API. In
+          // particular, zero-width rawItem carriers (opaque Responses items,
+          // see parseProviderContent) must not leak here. Filter BEFORE the
+          // name prefix below would make them non-empty.
+          if (block.text === '') continue;
           let text = block.text;
           if (includeNamePrefix && msg.participant) {
             text = `${msg.participant}: ${text}`;
@@ -1174,19 +1187,24 @@ export class Membrane {
       const blocks: ContentBlock[] = [];
       for (const item of content) {
         if (item.type === 'text') {
-          blocks.push({ type: 'text', text: item.text });
+          blocks.push({
+            type: 'text', text: item.text,
+            ...(item.rawItem ? { rawItem: item.rawItem } : {}),
+          });
         } else if (item.type === 'tool_use') {
           blocks.push({
             type: 'tool_use',
             id: item.id,
             name: unsanitizeToolName(item.name),
             input: item.input,
+            ...(item.rawItem ? { rawItem: item.rawItem } : {}),
           });
         } else if (item.type === 'thinking') {
           blocks.push({
             type: 'thinking',
             thinking: item.thinking ?? '',
             ...(item.signature ? { signature: item.signature } : {}),
+            ...(item.rawItem ? { rawItem: item.rawItem } : {}),
           });
         } else if (item.type === 'redacted_thinking') {
           // Pass through verbatim — carries the encrypted `data` payload
@@ -1197,6 +1215,14 @@ export class Membrane {
             data: item.data,
             mimeType: item.mimeType,
           });
+        } else if (item.rawItem) {
+          // Opaque Responses items such as encrypted compaction or custom
+          // tool records have no normalized ContentBlock equivalent. Retain a
+          // zero-width carrier so Chronicle and the Responses formatter can
+          // replay the raw item without surfacing synthetic prompt text.
+          // Anthropic-bound conversion paths filter these out (empty text
+          // blocks are a 400 there); the Responses formatter replays rawItem.
+          blocks.push({ type: 'text', text: '', rawItem: item.rawItem });
         }
       }
       return blocks;

package/src/providers/anthropic.ts

@@ -186,6 +186,11 @@ export class AnthropicAdapter implements ProviderAdapter {
       let outputTokens = 0;
       let cacheCreationTokens: number | undefined;
       let cacheReadTokens: number | undefined;
+      let cacheCreation5mTokens: number | undefined;
+      let cacheCreation1hTokens: number | undefined;
+      let hasCacheCreationBreakdown = false;
+      let inferenceGeo: string | undefined;
+      let serviceTier: string | undefined;
       let stopReason: string = 'end_turn';
       let stopSequence: string | undefined;
       let stopDetails: unknown;
@@ -207,10 +212,22 @@ export class AnthropicAdapter implements ProviderAdapter {
         resetIdleTimer();
         if (event.type === 'message_start') {
           model = event.message.model;
-          const usage = event.message.usage as unknown as Record<string, number>;
-          inputTokens = usage.input_tokens ?? 0;
-          cacheCreationTokens = usage.cache_creation_input_tokens;
-          cacheReadTokens = usage.cache_read_input_tokens;
+          const usage = event.message.usage as unknown as Record<string, unknown>;
+          inputTokens = typeof usage.input_tokens === 'number' ? usage.input_tokens : 0;
+          cacheCreationTokens = typeof usage.cache_creation_input_tokens === 'number'
+            ? usage.cache_creation_input_tokens : undefined;
+          cacheReadTokens = typeof usage.cache_read_input_tokens === 'number'
+            ? usage.cache_read_input_tokens : undefined;
+          const cacheCreation = usage.cache_creation as Record<string, unknown> | undefined;
+          if (cacheCreation) {
+            hasCacheCreationBreakdown = true;
+            cacheCreation5mTokens = typeof cacheCreation.ephemeral_5m_input_tokens === 'number'
+              ? cacheCreation.ephemeral_5m_input_tokens : 0;
+            cacheCreation1hTokens = typeof cacheCreation.ephemeral_1h_input_tokens === 'number'
+              ? cacheCreation.ephemeral_1h_input_tokens : 0;
+          }
+          inferenceGeo = typeof usage.inference_geo === 'string' ? usage.inference_geo : undefined;
+          serviceTier = typeof usage.service_tier === 'string' ? usage.service_tier : undefined;
 
         } else if (event.type === 'content_block_start') {
           currentBlockIndex = event.index;
@@ -324,6 +341,14 @@ export class AnthropicAdapter implements ProviderAdapter {
             output_tokens: outputTokens,
             cache_creation_input_tokens: cacheCreationTokens,
             cache_read_input_tokens: cacheReadTokens,
+            ...(hasCacheCreationBreakdown ? {
+              cache_creation: {
+                ephemeral_5m_input_tokens: cacheCreation5mTokens ?? 0,
+                ephemeral_1h_input_tokens: cacheCreation1hTokens ?? 0,
+              },
+            } : {}),
+            ...(inferenceGeo ? { inference_geo: inferenceGeo } : {}),
+            ...(serviceTier ? { service_tier: serviceTier } : {}),
           },
         },
       };
@@ -661,6 +686,9 @@ export function toAnthropicContent(blocks: ContentBlock[]): Anthropic.ContentBlo
   for (const block of blocks) {
     switch (block.type) {
       case 'text': {
+        // Empty text blocks (including zero-width rawItem carriers for opaque
+        // provider-native items) are rejected by the Anthropic API — drop them.
+        if (block.text === '') break;
         const textBlock: any = { type: 'text', text: block.text };
         // Preserve cache_control if present
         if (block.cache_control) {

package/src/providers/index.ts

@@ -60,3 +60,14 @@ export {
   OpenAIResponsesAdapter,
   type OpenAIResponsesAdapterConfig,
 } from './openai-responses.js';
+
+export {
+  OpenAIResponsesAPIAdapter,
+  type OpenAIResponsesAPIAdapterConfig,
+  type OpenAIResponsesAPIContentBlock,
+  type OpenAIResponsesAPIProviderResponse,
+  type OpenAIResponsesAPIRequest,
+  type OpenAIResponsesAPIResponse,
+  type OpenAIResponsesInputItem,
+  type OpenAIResponsesOutputItem,
+} from './openai-responses-api.js';