ai.matey.frontend 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# ai.matey.frontend
+
+## 0.3.0
+
+### Minor Changes
+
+- 58ebc03: Streaming tool-call support end-to-end. OpenAI and Anthropic backends now emit `tool_use` IR chunks
+  for streamed tool-call deltas (previously dropped with a console warning) and assemble complete
+  `ToolUseContent` blocks on the final `done` chunk. The Anthropic backend reports the real
+  provider stop reason (previously fabricated, e.g. `max_tokens` streams reported `stop`) and
+  captures usage from every `message_delta`. The OpenAI backend folds the trailing
+  `stream_options.include_usage` chunk into the done chunk. Frontend adapters re-emit tool deltas in
+  native formats (OpenAI index-based `tool_calls` deltas; Anthropic `content_block_start`/
+  `input_json_delta` events — the leading text block is now opened lazily so tool-only streams do not
+  fabricate an empty text block). `StreamAccumulator` assembles streamed tool calls.
+
+  Note: when tools are streamed, the done chunk's `message.content` is now a structured
+  `MessageContent[]` (text + tool_use blocks) rather than a plain string, and finish reasons are now
+  truthful (`tool_calls`/`length` where `stop` was previously reported).
+
+- c7693ac: Complete non-streaming tool-calling support. The OpenAI backend now sends `tools`/`tool_choice`,
+  converts assistant `tool_use` blocks to `tool_calls`, expands `tool_result` blocks into
+  `role: 'tool'` messages, and parses `tool_calls` from responses (malformed arguments degrade to
+  `{}`). The Anthropic backend now sends `tools`/`tool_choice`. Frontend adapters accept
+  `tools`/`tool_choice` in their native formats and round-trip tool calls and tool results through
+  the IR. OpenAI streaming requests now request usage accounting via `stream_options.include_usage`.
+
+### Patch Changes
+
+- e7df1d0: Remove vestigial `ai.matey.backend` runtime dependency from `ai.matey.frontend` (frontend adapters
+  never imported it). Document `StreamToolUseChunk` delta semantics and add an optional `index` field
+  identifying the tool call's position within the assistant message.
+- Updated dependencies [dae4d01]
+- Updated dependencies [e7df1d0]
+- Updated dependencies [2912b7d]
+- Updated dependencies [78731bb]
+- Updated dependencies [b7e2312]
+- Updated dependencies [58ebc03]
+  - ai.matey.types@0.3.0
+  - ai.matey.utils@0.3.0

package/dist/cjs/adapters/anthropic.js

@@ -35,7 +35,27 @@ class AnthropicFrontendAdapter {
         },
     };
     /**
-     * Convert Anthropic request to Universal IR.
+     * Convert Anthropic Messages API request to Universal IR format.
+     *
+     * This method transforms an Anthropic-formatted request into the standardized
+     * Intermediate Representation (IR) format. It handles Anthropic's unique system
+     * message format (separate from messages array) by converting it to IR's
+     * in-messages format, and maps Anthropic-specific parameters like top_k.
+     *
+     * @param request - Anthropic Messages API request
+     * @returns Promise resolving to IR chat request
+     * @throws {AdapterConversionError} If conversion fails
+     *
+     * @example
+     * ```typescript
+     * const adapter = new AnthropicFrontendAdapter();
+     * const irRequest = await adapter.toIR({
+     *   model: 'claude-3-5-sonnet-20241022',
+     *   max_tokens: 1024,
+     *   messages: [{ role: 'user', content: 'Hello!' }],
+     *   system: 'You are a helpful assistant'
+     * });
+     * ```
      */
     toIR(request) {
         try {
@@ -60,6 +80,12 @@ class AnthropicFrontendAdapter {
                     topK: request.top_k,
                     stopSequences: request.stop_sequences,
                 },
+                tools: request.tools?.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description ?? '',
+                    parameters: tool.input_schema,
+                })),
+                toolChoice: this.convertToolChoiceToIR(request.tool_choice),
                 stream: request.stream ?? false,
                 metadata: {
                     requestId: crypto.randomUUID(),
@@ -86,7 +112,23 @@ class AnthropicFrontendAdapter {
         }
     }
     /**
-     * Convert Universal IR response to Anthropic format.
+     * Convert Universal IR response back to Anthropic Messages API format.
+     *
+     * This method transforms the standardized IR response into the format
+     * expected by Anthropic's Messages API. It handles message conversion,
+     * stop reason mapping, and usage statistics formatting specific to
+     * Anthropic's response structure.
+     *
+     * @param response - Universal IR chat response
+     * @returns Promise resolving to Anthropic Messages API response
+     * @throws {AdapterConversionError} If conversion fails
+     *
+     * @example
+     * ```typescript
+     * const adapter = new AnthropicFrontendAdapter();
+     * const anthropicResponse = await adapter.fromIR(irResponse);
+     * console.log(anthropicResponse.content[0].text);
+     * ```
      */
     fromIR(response) {
         try {
@@ -121,12 +163,39 @@ class AnthropicFrontendAdapter {
         }
     }
     /**
-     * Convert Universal IR stream to Anthropic SSE format.
+     * Convert Universal IR stream to Anthropic Server-Sent Events (SSE) format.
+     *
+     * This async generator method transforms a stream of IR chunks into
+     * Anthropic-formatted streaming events. It handles stream mode conversion,
+     * tracks message metadata, and emits properly formatted SSE events
+     * compatible with Anthropic's streaming API including message_start,
+     * content_block_delta, and message_stop events.
+     *
+     * @param stream - Universal IR chat stream
+     * @param options - Optional stream conversion options (stream mode, etc.)
+     * @yields Anthropic-formatted streaming events
+     * @throws {AdapterConversionError} If stream conversion fails
+     *
+     * @example
+     * ```typescript
+     * const adapter = new AnthropicFrontendAdapter();
+     * for await (const event of adapter.fromIRStream(irStream)) {
+     *   if (event.type === 'content_block_delta') {
+     *     console.log(event.delta.text);
+     *   }
+     * }
+     * ```
      */
     async *fromIRStream(stream, options) {
         try {
             // Apply stream mode conversion if options provided
             const processedStream = options ? (0, ai_matey_utils_1.convertStreamMode)(stream, options) : stream;
+            // Content blocks are opened lazily (a tool-only stream must not emit
+            // an empty text block) and closed when a different block starts.
+            let nextBlockIndex = 0;
+            let openBlockIndex = null;
+            let openTextBlockIndex = null;
+            const toolBlockIndexById = new Map();
             for await (const chunk of processedStream) {
                 switch (chunk.type) {
                     case 'start':
@@ -140,27 +209,62 @@ class AnthropicFrontendAdapter {
                                 model: chunk.metadata.provenance?.backend || 'unknown',
                             },
                         };
-                        // Emit content_block_start
-                        yield {
-                            type: 'content_block_start',
-                            index: 0,
-                            content_block: { type: 'text', text: '' },
-                        };
                         break;
                     case 'content':
-                        // Emit content delta
+                        // Open a text block on first text delta (or after a tool block)
+                        if (openTextBlockIndex === null) {
+                            if (openBlockIndex !== null) {
+                                yield { type: 'content_block_stop', index: openBlockIndex };
+                            }
+                            openTextBlockIndex = nextBlockIndex++;
+                            openBlockIndex = openTextBlockIndex;
+                            yield {
+                                type: 'content_block_start',
+                                index: openTextBlockIndex,
+                                content_block: { type: 'text', text: '' },
+                            };
+                        }
                         yield {
                             type: 'content_block_delta',
-                            index: 0,
+                            index: openTextBlockIndex,
                             delta: { type: 'text_delta', text: chunk.delta },
                         };
                         break;
+                    case 'tool_use': {
+                        let blockIndex = toolBlockIndexById.get(chunk.id);
+                        // First chunk for this tool call: open its content block
+                        if (blockIndex === undefined) {
+                            if (openBlockIndex !== null) {
+                                yield { type: 'content_block_stop', index: openBlockIndex };
+                                if (openBlockIndex === openTextBlockIndex) {
+                                    openTextBlockIndex = null;
+                                }
+                            }
+                            blockIndex = nextBlockIndex++;
+                            toolBlockIndexById.set(chunk.id, blockIndex);
+                            openBlockIndex = blockIndex;
+                            yield {
+                                type: 'content_block_start',
+                                index: blockIndex,
+                                content_block: { type: 'tool_use', id: chunk.id, name: chunk.name, input: {} },
+                            };
+                        }
+                        if (chunk.inputDelta) {
+                            yield {
+                                type: 'content_block_delta',
+                                index: blockIndex,
+                                delta: { type: 'input_json_delta', partial_json: chunk.inputDelta },
+                            };
+                        }
+                        break;
+                    }
                     case 'done': {
-                        // Emit content_block_stop
-                        yield {
-                            type: 'content_block_stop',
-                            index: 0,
-                        };
+                        // Close the open content block (if any)
+                        if (openBlockIndex !== null) {
+                            yield { type: 'content_block_stop', index: openBlockIndex };
+                            openBlockIndex = null;
+                            openTextBlockIndex = null;
+                        }
                         // Emit message_delta with stop reason
                         const stopReason = this.mapFinishReason(chunk.finishReason);
                         yield {
@@ -205,6 +309,24 @@ class AnthropicFrontendAdapter {
     // ==========================================================================
     // Private Helper Methods
     // ==========================================================================
+    /**
+     * Convert Anthropic tool_choice to IR toolChoice.
+     */
+    convertToolChoiceToIR(toolChoice) {
+        if (toolChoice === undefined) {
+            return undefined;
+        }
+        switch (toolChoice.type) {
+            case 'auto':
+                return 'auto';
+            case 'any':
+                return 'required';
+            case 'none':
+                return 'none';
+            case 'tool':
+                return { name: toolChoice.name };
+        }
+    }
     /**
      * Convert Anthropic message to IR message.
      */
@@ -259,6 +381,15 @@ class AnthropicFrontendAdapter {
                     name: block.name,
                     input: block.input,
                 };
+            case 'tool_result':
+                return {
+                    type: 'tool_result',
+                    toolUseId: block.tool_use_id,
+                    content: typeof block.content === 'string'
+                        ? block.content
+                        : block.content.map((text) => ({ type: 'text', text: text.text })),
+                    isError: block.is_error,
+                };
             default:
                 // Unknown block type, convert to text
                 return {
@@ -302,6 +433,15 @@ class AnthropicFrontendAdapter {
                         name: block.name,
                         input: block.input,
                     };
+                case 'tool_result':
+                    return {
+                        type: 'tool_result',
+                        tool_use_id: block.toolUseId,
+                        content: typeof block.content === 'string'
+                            ? block.content
+                            : block.content.map((text) => ({ type: 'text', text: text.text })),
+                        is_error: block.isError,
+                    };
                 default:
                     // Fallback to text
                     return { type: 'text', text: JSON.stringify(block) };

package/dist/cjs/adapters/anthropic.js.map

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

package/dist/cjs/adapters/chrome-ai.js

@@ -22,6 +22,27 @@ class ChromeAIFrontendAdapter {
             supportsMultipleSystemMessages: false,
         },
     };
+    /**
+     * Convert Chrome AI request to Universal IR format.
+     *
+     * This method transforms a Chrome AI-formatted request into the standardized
+     * Intermediate Representation (IR) format. Chrome AI uses a simple prompt-based
+     * format, so this converts the single prompt string into a user message within
+     * the IR message array structure.
+     *
+     * @param request - Chrome AI request with prompt and optional parameters
+     * @returns Promise resolving to IR chat request
+     *
+     * @example
+     * ```typescript
+     * const adapter = new ChromeAIFrontendAdapter();
+     * const irRequest = await adapter.toIR({
+     *   prompt: 'What is the capital of France?',
+     *   temperature: 0.7,
+     *   topK: 40
+     * });
+     * ```
+     */
     toIR(request) {
         return Promise.resolve({
             messages: [{ role: 'user', content: request.prompt }],
@@ -36,11 +57,48 @@ class ChromeAIFrontendAdapter {
             },
         });
     }
+    /**
+     * Convert Universal IR response back to Chrome AI format.
+     *
+     * This method transforms the standardized IR response into the format
+     * expected by Chrome AI's interface. It extracts the text content from
+     * the IR message and returns it in Chrome AI's simple `{ text }` format.
+     *
+     * @param response - Universal IR chat response
+     * @returns Promise resolving to Chrome AI response
+     *
+     * @example
+     * ```typescript
+     * const adapter = new ChromeAIFrontendAdapter();
+     * const chromeResponse = await adapter.fromIR(irResponse);
+     * console.log(chromeResponse.text);
+     * ```
+     */
     fromIR(response) {
         return Promise.resolve({
             text: typeof response.message.content === 'string' ? response.message.content : '',
         });
     }
+    /**
+     * Convert Universal IR stream to Chrome AI streaming format.
+     *
+     * This async generator method transforms a stream of IR chunks into
+     * Chrome AI's simple text streaming format. It yields raw text strings
+     * (no JSON wrapping, no SSE format) and supports stream mode conversion
+     * through options (delta, full, or text-only modes).
+     *
+     * @param stream - Universal IR chat stream
+     * @param options - Optional stream conversion options (stream mode, etc.)
+     * @yields Raw text strings
+     *
+     * @example
+     * ```typescript
+     * const adapter = new ChromeAIFrontendAdapter();
+     * for await (const textChunk of adapter.fromIRStream(irStream)) {
+     *   console.log(textChunk); // Raw text like "Hello" or " world"
+     * }
+     * ```
+     */
     async *fromIRStream(stream, options) {
         // Apply stream mode conversion if options provided
         const processedStream = options ? (0, ai_matey_utils_1.convertStreamMode)(stream, options) : stream;

package/dist/cjs/adapters/chrome-ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"chrome-ai.js","sourceRoot":"","sources":["../../../src/adapters/chrome-ai.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAKH,mDAAmD;AAYnD,MAAa,uBAAuB;IACzB,QAAQ,GAAoB;QACnC,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE;YACZ,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK;YACZ,qBAAqB,EAAE,cAAc;YACrC,8BAA8B,EAAE,KAAK;SACtC;KACF,CAAC;IAEF,IAAI,CAAC,OAAwB;QAC3B,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YACrD,UAAU,EAAE;gBACV,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,SAAS,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,EAAE;gBACpC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;aAC7C;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,QAAwB;QAC7B,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;SACnF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,CAAC,YAAY,CACjB,MAAqC,EACrC,OAAiC;QAEjC,mDAAmD;QACnD,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,IAAA,kCAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAE9E,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAhDD,0DAgDC"}
+{"version":3,"file":"chrome-ai.js","sourceRoot":"","sources":["../../../src/adapters/chrome-ai.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAKH,mDAAmD;AAmDnD,MAAa,uBAAuB;IACzB,QAAQ,GAAoB;QACnC,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE;YACZ,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,KAAK;YACZ,qBAAqB,EAAE,cAAc;YACrC,8BAA8B,EAAE,KAAK;SACtC;KACF,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YACrD,UAAU,EAAE;gBACV,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,SAAS,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,EAAE;gBACpC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;aAC7C;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,QAAwB;QAC7B,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;SACnF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,CAAC,YAAY,CACjB,MAAqC,EACrC,OAAiC;QAEjC,mDAAmD;QACnD,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,IAAA,kCAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAE9E,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA1GD,0DA0GC"}

package/dist/cjs/adapters/gemini.js

@@ -22,6 +22,26 @@ class GeminiFrontendAdapter {
             supportsMultipleSystemMessages: false,
         },
     };
+    /**
+     * Convert Google Gemini API request to Universal IR format.
+     *
+     * This method transforms a Gemini-formatted request into the standardized
+     * Intermediate Representation (IR) format. It handles Gemini's unique
+     * content structure (parts array), converts 'model' role to 'assistant',
+     * and adjusts temperature values (Gemini uses 0-1, IR uses 0-2).
+     *
+     * @param request - Google Gemini API request
+     * @returns Promise resolving to IR chat request
+     *
+     * @example
+     * ```typescript
+     * const adapter = new GeminiFrontendAdapter();
+     * const irRequest = await adapter.toIR({
+     *   contents: [{ role: 'user', parts: [{ text: 'Hello!' }] }],
+     *   generationConfig: { temperature: 0.7 }
+     * });
+     * ```
+     */
     toIR(request) {
         const messages = request.contents.map((c) => ({
             role: c.role === 'model' ? 'assistant' : 'user',
@@ -53,6 +73,24 @@ class GeminiFrontendAdapter {
             },
         });
     }
+    /**
+     * Convert Universal IR response back to Google Gemini API format.
+     *
+     * This method transforms the standardized IR response into the format
+     * expected by Gemini's API. It converts 'assistant' role back to 'model',
+     * structures content as parts array, and maps finish reasons to Gemini's
+     * specific format (STOP, MAX_TOKENS, OTHER).
+     *
+     * @param response - Universal IR chat response
+     * @returns Promise resolving to Gemini API response
+     *
+     * @example
+     * ```typescript
+     * const adapter = new GeminiFrontendAdapter();
+     * const geminiResponse = await adapter.fromIR(irResponse);
+     * console.log(geminiResponse.candidates[0].content.parts[0].text);
+     * ```
+     */
     fromIR(response) {
         return Promise.resolve({
             candidates: [
@@ -81,6 +119,25 @@ class GeminiFrontendAdapter {
                 : undefined,
         });
     }
+    /**
+     * Convert Universal IR stream to Google Gemini Server-Sent Events format.
+     *
+     * This async generator method transforms a stream of IR chunks into
+     * Gemini-formatted SSE responses. It yields Server-Sent Event strings
+     * with the "data: " prefix containing JSON candidates with parts array.
+     *
+     * @param stream - Universal IR chat stream
+     * @param _options - Optional stream conversion options (currently unused)
+     * @yields Server-Sent Event formatted strings
+     *
+     * @example
+     * ```typescript
+     * const adapter = new GeminiFrontendAdapter();
+     * for await (const sseData of adapter.fromIRStream(irStream)) {
+     *   console.log(sseData); // "data: {...}\n\n"
+     * }
+     * ```
+     */
     async *fromIRStream(stream, _options) {
         for await (const chunk of stream) {
             if (chunk.type === 'content') {

package/dist/cjs/adapters/gemini.js.map

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

package/dist/cjs/adapters/generic.js

@@ -81,9 +81,26 @@ class GenericFrontendAdapter {
         };
     }
     /**
-     * Pass through IR request (no conversion needed).
+     * Pass through Universal IR request without conversion.
      *
-     * Optionally adds provenance tracking if enabled.
+     * This method accepts an IR request and returns it directly, as this is
+     * a passthrough adapter. When provenance tracking is enabled (default),
+     * it adds the frontend adapter name to the provenance metadata for
+     * tracking purposes, but otherwise performs no transformations.
+     *
+     * @param request - Universal IR chat request
+     * @returns Promise resolving to the same IR request (with optional provenance)
+     *
+     * @example
+     * ```typescript
+     * const adapter = new GenericFrontendAdapter();
+     * const irRequest = await adapter.toIR({
+     *   messages: [{ role: 'user', content: 'Hello!' }],
+     *   parameters: { model: 'gpt-4', temperature: 0.7 },
+     *   metadata: { requestId: 'req_123', timestamp: Date.now(), provenance: {} }
+     * });
+     * // Returns the same request with provenance.frontend = 'generic-frontend'
+     * ```
      */
     toIR(request) {
         // Optionally add provenance
@@ -102,13 +119,48 @@ class GenericFrontendAdapter {
         return Promise.resolve(request);
     }
     /**
-     * Pass through IR response (no conversion needed).
+     * Pass through Universal IR response without conversion.
+     *
+     * This method accepts an IR response and returns it directly without
+     * any transformation. Since this is a passthrough adapter, the response
+     * remains in IR format, allowing applications to work directly with
+     * the universal format.
+     *
+     * @param response - Universal IR chat response
+     * @returns Promise resolving to the same IR response
+     *
+     * @example
+     * ```typescript
+     * const adapter = new GenericFrontendAdapter();
+     * const irResponse = await adapter.fromIR(irResponse);
+     * // Returns the exact same response unchanged
+     * console.log(irResponse.message.content);
+     * ```
      */
     fromIR(response) {
         return Promise.resolve(response);
     }
     /**
-     * Pass through IR stream chunks (no conversion needed).
+     * Pass through Universal IR stream chunks without conversion.
+     *
+     * This async generator method accepts an IR stream and yields each chunk
+     * directly without any transformation. Unlike other frontend adapters that
+     * convert to provider-specific formats (SSE, JSON, etc.), this maintains
+     * the raw IR chunk structure for direct consumption.
+     *
+     * @param stream - Universal IR chat stream
+     * @param _options - Optional stream conversion options (currently unused)
+     * @yields IR stream chunks unchanged
+     *
+     * @example
+     * ```typescript
+     * const adapter = new GenericFrontendAdapter();
+     * for await (const chunk of adapter.fromIRStream(irStream)) {
+     *   if (chunk.type === 'content') {
+     *     console.log(chunk.delta); // Access IR structure directly
+     *   }
+     * }
+     * ```
      */
     async *fromIRStream(stream, _options) {
         for await (const chunk of stream) {

package/dist/cjs/adapters/generic.js.map

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