agentfootprint 1.22.0 → 2.0.1

package/dist/esm/adapters/llm/BrowserAnthropicProvider.js

@@ -0,0 +1,329 @@
+/**
+ * BrowserAnthropicProvider — fetch-based Anthropic adapter for browsers.
+ *
+ * Pattern: Adapter (GoF). Zero peer dependencies — uses global `fetch`.
+ * Role:    Outer ring. Same `LLMProvider` contract as `AnthropicProvider`,
+ *          but skips `@anthropic-ai/sdk` (which doesn't bundle cleanly
+ *          for browser). Aimed at playgrounds / prototypes where the
+ *          user supplies their own key.
+ * Emits:   N/A.
+ *
+ * Anthropic requires the `anthropic-dangerous-direct-browser-access: true`
+ * header for direct browser-to-API calls. This is intentional — production
+ * apps should proxy through a backend.
+ *
+ * ─── 7-panel design review (2026-04-28) ─────────────────────────────
+ *
+ *   LLM-AI system design   ✓ Same message + tool conversion as the
+ *                            Node `AnthropicProvider`. Native tool_use
+ *                            blocks; `LLMMessage.toolCalls` round-trip.
+ *   Performance            ✓ One fetch() per `complete()`. Stream
+ *                            uses native `ReadableStream` via SSE
+ *                            parsing — no buffering past one chunk.
+ *   Scalability            ✓ Stateless. Multiple agents share one
+ *                            provider; browser fetch handles
+ *                            concurrent requests fine.
+ *   Research alignment     ✓ Mirrors v1 BrowserAnthropicAdapter
+ *                            (origin/main `c6e11d0`). Same headers,
+ *                            same SSE event shape.
+ *   Flexibility            ✓ `apiUrl` override for proxy/edge
+ *                            deployments. Custom `fetch` injection
+ *                            for tests + workers.
+ *   Abstraction-modular    ✓ Re-uses `toAnthropicMessages` /
+ *                            `fromAnthropicResponse` semantics from
+ *                            the Node adapter (small duplication kept
+ *                            local — both files stay readable).
+ *   Software engineering   ✓ Zero peer deps (browser fetch is
+ *                            ambient). Errors wrapped with status
+ *                            for `withRetry` policy hooks. SSE parser
+ *                            handles partial chunks.
+ *
+ * ─── Limitations ────────────────────────────────────────────────────
+ *
+ * • Multi-modal NOT .
+ * • Browser CORS — works because Anthropic explicitly allows the
+ *   dangerous-direct header. Future API changes could require a proxy.
+ *
+ * ─── 7-pattern test coverage ────────────────────────────────────────
+ *
+ *   See `test/adapters/unit/BrowserAnthropicProvider.test.ts`.
+ */
+const ANTHROPIC_API_URL = 'https://api.anthropic.com/v1/messages';
+const ANTHROPIC_API_VERSION = '2023-06-01';
+export function browserAnthropic(options) {
+    const apiKey = options.apiKey;
+    if (!apiKey) {
+        throw new Error('BrowserAnthropicProvider requires `apiKey`. Browser providers do not read environment variables.');
+    }
+    const apiUrl = options.apiUrl ?? ANTHROPIC_API_URL;
+    const defaultModel = options.defaultModel ?? 'claude-sonnet-4-5-20250929';
+    const defaultMaxTokens = options.defaultMaxTokens ?? 4096;
+    const fetchImpl = options._fetch ?? fetch;
+    const headers = {
+        'content-type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': ANTHROPIC_API_VERSION,
+        'anthropic-dangerous-direct-browser-access': 'true',
+    };
+    const provider = {
+        name: 'browser-anthropic',
+        async complete(req) {
+            const body = {
+                ...buildBody(req, defaultModel, defaultMaxTokens),
+            };
+            let response;
+            try {
+                response = await fetchImpl(apiUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    ...(req.signal && { signal: req.signal }),
+                });
+            }
+            catch (err) {
+                throw wrapError(err);
+            }
+            if (!response.ok)
+                throw await wrapStatus(response);
+            const json = (await response.json());
+            return fromAnthropicResponse(json);
+        },
+        async *stream(req) {
+            const body = {
+                ...buildBody(req, defaultModel, defaultMaxTokens),
+                stream: true,
+            };
+            let response;
+            try {
+                response = await fetchImpl(apiUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    ...(req.signal && { signal: req.signal }),
+                });
+            }
+            catch (err) {
+                throw wrapError(err);
+            }
+            if (!response.ok)
+                throw await wrapStatus(response);
+            if (!response.body)
+                throw new Error('[browser-anthropic] response has no body');
+            let tokenIndex = 0;
+            let final;
+            const accumulatedText = [];
+            const toolUses = [];
+            for await (const event of parseSSE(response.body)) {
+                if (event.event === 'content_block_delta') {
+                    const delta = event.data.delta;
+                    if (delta?.type === 'text_delta' && delta.text) {
+                        accumulatedText.push(delta.text);
+                        yield { tokenIndex, content: delta.text, done: false };
+                        tokenIndex++;
+                    }
+                }
+                else if (event.event === 'message_start') {
+                    // Initial message metadata; ignore.
+                }
+                else if (event.event === 'message_delta') {
+                    // Stop-reason updates; ignore — final message_stop carries it.
+                }
+                else if (event.event === 'message_stop') {
+                    // The terminal event; SSE stream ends naturally.
+                }
+                else if (event.event === 'content_block_start') {
+                    const block = event.data.content_block;
+                    if (block?.type === 'tool_use') {
+                        toolUses.push({ id: block.id, name: block.name, input: { ...block.input } });
+                    }
+                }
+            }
+            // Build the authoritative response from the streamed pieces. The
+            // Anthropic SSE protocol doesn't ship a final JSON message; we
+            // reconstruct from accumulated deltas.
+            const response2 = {
+                content: accumulatedText.join(''),
+                toolCalls: toolUses.map((t) => ({ id: t.id, name: t.name, args: t.input })),
+                usage: {
+                    input: final?.usage.input_tokens ?? 0,
+                    output: final?.usage.output_tokens ?? 0,
+                },
+                stopReason: normalizeStopReason(final?.stop_reason ?? 'stop'),
+                ...(final?.id && { providerRef: final.id }),
+            };
+            yield { tokenIndex, content: '', done: true, response: response2 };
+        },
+    };
+    return provider;
+}
+export class BrowserAnthropicProvider {
+    name = 'browser-anthropic';
+    inner;
+    constructor(options) {
+        this.inner = browserAnthropic(options);
+    }
+    complete(req) {
+        return this.inner.complete(req);
+    }
+    stream(req) {
+        if (!this.inner.stream)
+            throw new Error('stream() unavailable');
+        return this.inner.stream(req);
+    }
+}
+// ─── Internals ──────────────────────────────────────────────────────
+function buildBody(req, defaultModel, defaultMaxTokens) {
+    const body = {
+        model: req.model === 'anthropic' || req.model === 'browser-anthropic' ? defaultModel : req.model,
+        max_tokens: req.maxTokens ?? defaultMaxTokens,
+        messages: toAnthropicMessages(req.messages),
+    };
+    if (req.systemPrompt)
+        body.system = req.systemPrompt;
+    if (req.tools && req.tools.length > 0)
+        body.tools = req.tools.map(toAnthropicTool);
+    if (req.temperature !== undefined)
+        body.temperature = req.temperature;
+    if (req.stop && req.stop.length > 0)
+        body.stop_sequences = [...req.stop];
+    return body;
+}
+function toAnthropicMessages(messages) {
+    const result = [];
+    for (const m of messages) {
+        if (m.role === 'system')
+            continue;
+        if (m.role === 'user') {
+            result.push({ role: 'user', content: m.content });
+            continue;
+        }
+        if (m.role === 'assistant') {
+            const blocks = [];
+            if (m.content)
+                blocks.push({ type: 'text', text: m.content });
+            if (m.toolCalls) {
+                for (const tc of m.toolCalls) {
+                    blocks.push({ type: 'tool_use', id: tc.id, name: tc.name, input: { ...tc.args } });
+                }
+            }
+            result.push({
+                role: 'assistant',
+                content: blocks.length > 0 ? blocks : m.content || '',
+            });
+            continue;
+        }
+        if (m.role === 'tool') {
+            const block = {
+                type: 'tool_result',
+                tool_use_id: m.toolCallId ?? '',
+                content: m.content,
+            };
+            const last = result[result.length - 1];
+            if (last && last.role === 'user' && Array.isArray(last.content)) {
+                last.content.push(block);
+            }
+            else {
+                result.push({ role: 'user', content: [block] });
+            }
+            continue;
+        }
+    }
+    return result;
+}
+function toAnthropicTool(schema) {
+    return {
+        name: schema.name,
+        description: schema.description,
+        input_schema: { ...schema.inputSchema },
+    };
+}
+function fromAnthropicResponse(message) {
+    const textParts = [];
+    const toolCalls = [];
+    for (const block of message.content) {
+        if (block.type === 'text')
+            textParts.push(block.text);
+        else if (block.type === 'tool_use') {
+            toolCalls.push({ id: block.id, name: block.name, args: block.input });
+        }
+    }
+    return {
+        content: textParts.join(''),
+        toolCalls,
+        usage: {
+            input: message.usage.input_tokens,
+            output: message.usage.output_tokens,
+        },
+        stopReason: normalizeStopReason(message.stop_reason),
+        providerRef: message.id,
+    };
+}
+function normalizeStopReason(raw) {
+    switch (raw) {
+        case 'end_turn':
+            return 'stop';
+        case 'tool_use':
+            return 'tool_use';
+        case 'max_tokens':
+            return 'max_tokens';
+        default:
+            return raw;
+    }
+}
+/** Parse Anthropic's SSE event stream from a fetch ReadableStream. */
+async function* parseSSE(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = '';
+    try {
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let idx;
+            // Events are separated by \n\n.
+            while ((idx = buf.indexOf('\n\n')) >= 0) {
+                const raw = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                let event = 'message';
+                const dataLines = [];
+                for (const line of raw.split('\n')) {
+                    if (line.startsWith('event:'))
+                        event = line.slice(6).trim();
+                    else if (line.startsWith('data:'))
+                        dataLines.push(line.slice(5).trim());
+                }
+                const data = dataLines.length > 0 ? JSON.parse(dataLines.join('\n')) : {};
+                yield { event, data };
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+async function wrapStatus(response) {
+    let bodyText = '';
+    try {
+        bodyText = await response.text();
+    }
+    catch {
+        /* ignore */
+    }
+    return Object.assign(new Error(`[browser-anthropic] ${response.status} ${response.statusText} — ${bodyText.slice(0, 200)}`), {
+        name: 'BrowserAnthropicProviderError',
+        status: response.status,
+    });
+}
+function wrapError(err) {
+    if (err instanceof Error) {
+        return Object.assign(new Error(`[browser-anthropic] ${err.message}`), {
+            name: 'BrowserAnthropicProviderError',
+            cause: err,
+        });
+    }
+    return new Error(`[browser-anthropic] ${String(err)}`);
+}
+//# sourceMappingURL=BrowserAnthropicProvider.js.map

package/dist/esm/adapters/llm/BrowserAnthropicProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserAnthropicProvider.js","sourceRoot":"","sources":["../../../../src/adapters/llm/BrowserAnthropicProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAWH,MAAM,iBAAiB,GAAG,uCAAuC,CAAC;AAClE,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAuD3C,MAAM,UAAU,gBAAgB,CAAC,OAAwC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,4BAA4B,CAAC;IAC1E,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IAE1C,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,WAAW,EAAE,MAAM;QACnB,mBAAmB,EAAE,qBAAqB;QAC1C,2CAA2C,EAAE,MAAM;KACpD,CAAC;IAEF,MAAM,QAAQ,GAAgB;QAC5B,IAAI,EAAE,mBAAmB;QACzB,KAAK,CAAC,QAAQ,CAAC,GAAe;YAC5B,MAAM,IAAI,GAAyB;gBACjC,GAAG,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,gBAAgB,CAAC;aAClD,CAAC;YACF,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE;oBACjC,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAC;YACzD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,CAAC,MAAM,CAAC,GAAe;YAC3B,MAAM,IAAI,GAAyB;gBACjC,GAAG,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,gBAAgB,CAAC;gBACjD,MAAM,EAAE,IAAI;aACb,CAAC;YACF,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE;oBACjC,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAEhF,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,KAAmC,CAAC;YACxC,MAAM,eAAe,GAAa,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAwE,EAAE,CAAC;YAEzF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,CAAC,KAAK,KAAK,qBAAqB,EAAE,CAAC;oBAC1C,MAAM,KAAK,GAAI,KAAK,CAAC,IAAqD,CAAC,KAAK,CAAC;oBACjF,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBAC/C,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBACjC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;wBACvD,UAAU,EAAE,CAAC;oBACf,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;oBAC3C,oCAAoC;gBACtC,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;oBAC3C,+DAA+D;gBACjE,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;oBAC1C,iDAAiD;gBACnD,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,qBAAqB,EAAE,CAAC;oBACjD,MAAM,KAAK,GAAI,KAAK,CAAC,IAAkD,CAAC,aAAa,CAAC;oBACtF,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;wBAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC/E,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,+DAA+D;YAC/D,uCAAuC;YACvC,MAAM,SAAS,GAAgB;gBAC7B,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC3E,KAAK,EAAE;oBACL,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;oBACrC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;iBACxC;gBACD,UAAU,EAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,IAAI,MAAM,CAAC;gBAC7D,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;aAC5C,CAAC;YACF,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;KACF,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,wBAAwB;IAC1B,IAAI,GAAG,mBAAmB,CAAC;IACnB,KAAK,CAAc;IAEpC,YAAY,OAAwC;QAClD,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CAAC,GAAe;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,GAAe;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACF;AAED,uEAAuE;AAEvE,SAAS,SAAS,CAChB,GAAe,EACf,YAAoB,EACpB,gBAAwB;IAExB,MAAM,IAAI,GAAyB;QACjC,KAAK,EACH,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,GAAG,CAAC,KAAK,KAAK,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK;QAC3F,UAAU,EAAE,GAAG,CAAC,SAAS,IAAI,gBAAgB;QAC7C,QAAQ,EAAE,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC;KAC5C,CAAC;IACF,IAAI,GAAG,CAAC,YAAY;QAAE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC;IACrD,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACnF,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACtE,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,cAAc,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,QAA+B;IAC1D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QAClC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,IAAI,CAAC,CAAC,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAChB,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;oBAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE;aACtD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,KAAK,GAA0B;gBACnC,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;gBAC/B,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACvC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,MAAqB;IAC5C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAyB;IACtD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAkE,EAAE,CAAC;IACpF,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aACjD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,SAAS;QACT,KAAK,EAAE;YACL,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY;YACjC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa;SACpC;QACD,UAAU,EAAE,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC;QACpD,WAAW,EAAE,OAAO,CAAC,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,KAAK,SAAS,CAAC,CAAC,QAAQ,CACtB,IAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,iDAAiD;QACjD,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,IAAI,GAAG,CAAC;YACR,gCAAgC;YAChC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC9B,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,KAAK,GAAG,SAAS,CAAC;gBACtB,MAAM,SAAS,GAAa,EAAE,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;wBAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBACvD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;wBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1E,CAAC;gBACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAkB;IAC1C,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CACP,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC5F,EACD;QACE,IAAI,EAAE,+BAA+B;QACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE;YACpE,IAAI,EAAE,+BAA+B;YACrC,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/esm/adapters/llm/BrowserOpenAIProvider.js

@@ -0,0 +1,327 @@
+/**
+ * BrowserOpenAIProvider — fetch-based OpenAI adapter for browsers.
+ *
+ * Pattern: Adapter (GoF). Zero peer dependencies — uses global `fetch`.
+ * Role:    Outer ring. Same `LLMProvider` contract as `OpenAIProvider`
+ *          but skips the `openai` SDK. For prototypes / playgrounds.
+ *          Production apps should proxy through a backend.
+ * Emits:   N/A.
+ *
+ * Also works with OpenAI-compatible endpoints (Ollama, Together, vLLM)
+ * via `apiUrl`.
+ *
+ * ─── 7-panel review ─────────────────────────────────────────────────
+ *
+ *   Same posture as `BrowserAnthropicProvider`: native fetch, SSE
+ *   parser, stateless, error-wrapped, message-conversion mirrors the
+ *   Node `OpenAIProvider`. See that adapter's review for full rubric.
+ *
+ * ─── Limitations ────────────────────────────────────────────────────
+ *
+ * • Multi-modal NOT .
+ * • CORS depends on the endpoint — OpenAI requires the user-supplied
+ *   key in the Authorization header, which they'll do explicitly.
+ *
+ * ─── 7-pattern test coverage ────────────────────────────────────────
+ *
+ *   See `test/adapters/unit/BrowserOpenAIProvider.test.ts`.
+ */
+const OPENAI_API_URL = 'https://api.openai.com/v1/chat/completions';
+export function browserOpenai(options) {
+    if (!options.apiKey) {
+        throw new Error('BrowserOpenAIProvider requires `apiKey`. Browser providers do not read environment variables.');
+    }
+    const apiUrl = options.apiUrl ?? OPENAI_API_URL;
+    const defaultModel = options.defaultModel ?? 'gpt-4o-mini';
+    const defaultMaxTokens = options.defaultMaxTokens;
+    const fetchImpl = options._fetch ?? fetch;
+    const headers = {
+        'content-type': 'application/json',
+        authorization: `Bearer ${options.apiKey}`,
+    };
+    if (options.organization)
+        headers['openai-organization'] = options.organization;
+    const provider = {
+        name: 'browser-openai',
+        async complete(req) {
+            const body = buildBody(req, defaultModel, defaultMaxTokens, false);
+            let response;
+            try {
+                response = await fetchImpl(apiUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    ...(req.signal && { signal: req.signal }),
+                });
+            }
+            catch (err) {
+                throw wrapError(err);
+            }
+            if (!response.ok)
+                throw await wrapStatus(response);
+            const json = (await response.json());
+            return fromOpenAIResponse(json);
+        },
+        async *stream(req) {
+            const body = buildBody(req, defaultModel, defaultMaxTokens, true);
+            let response;
+            try {
+                response = await fetchImpl(apiUrl, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    ...(req.signal && { signal: req.signal }),
+                });
+            }
+            catch (err) {
+                throw wrapError(err);
+            }
+            if (!response.ok)
+                throw await wrapStatus(response);
+            if (!response.body)
+                throw new Error('[browser-openai] response has no body');
+            const textParts = [];
+            const toolCallsByIndex = new Map();
+            let lastFinishReason = 'stop';
+            let lastUsage;
+            let lastId = '';
+            let tokenIndex = 0;
+            for await (const data of parseSSE(response.body)) {
+                if (data === '[DONE]')
+                    break;
+                const chunk = data;
+                const choice = chunk.choices[0];
+                if (!choice)
+                    continue;
+                if (chunk.id)
+                    lastId = chunk.id;
+                if (chunk.usage)
+                    lastUsage = chunk.usage;
+                if (choice.finish_reason)
+                    lastFinishReason = choice.finish_reason;
+                const delta = choice.delta;
+                if (delta.content) {
+                    textParts.push(delta.content);
+                    yield { tokenIndex, content: delta.content, done: false };
+                    tokenIndex++;
+                }
+                if (delta.tool_calls) {
+                    for (const tcDelta of delta.tool_calls) {
+                        const idx = tcDelta.index;
+                        const existing = toolCallsByIndex.get(idx) ?? { id: '', name: '', argsJson: '' };
+                        if (tcDelta.id)
+                            existing.id = tcDelta.id;
+                        if (tcDelta.function?.name)
+                            existing.name = tcDelta.function.name;
+                        if (tcDelta.function?.arguments)
+                            existing.argsJson += tcDelta.function.arguments;
+                        toolCallsByIndex.set(idx, existing);
+                    }
+                }
+            }
+            const toolCalls = Array.from(toolCallsByIndex.values()).map((tc) => ({
+                id: tc.id,
+                name: tc.name,
+                args: parseArgs(tc.argsJson),
+            }));
+            const finalResponse = {
+                content: textParts.join(''),
+                toolCalls,
+                usage: {
+                    input: lastUsage?.prompt_tokens ?? 0,
+                    output: lastUsage?.completion_tokens ?? 0,
+                },
+                stopReason: normalizeStopReason(lastFinishReason),
+                providerRef: lastId,
+            };
+            yield { tokenIndex, content: '', done: true, response: finalResponse };
+        },
+    };
+    return provider;
+}
+export class BrowserOpenAIProvider {
+    name = 'browser-openai';
+    inner;
+    constructor(options) {
+        this.inner = browserOpenai(options);
+    }
+    complete(req) {
+        return this.inner.complete(req);
+    }
+    stream(req) {
+        if (!this.inner.stream)
+            throw new Error('stream() unavailable');
+        return this.inner.stream(req);
+    }
+}
+// ─── Internals ──────────────────────────────────────────────────────
+function buildBody(req, defaultModel, defaultMaxTokens, stream) {
+    const body = {
+        model: req.model === 'openai' || req.model === 'browser-openai' ? defaultModel : req.model,
+        messages: toOpenAIMessages(req.messages, req.systemPrompt),
+    };
+    if (stream)
+        body.stream = true;
+    if (req.tools && req.tools.length > 0)
+        body.tools = req.tools.map(toOpenAITool);
+    const max = req.maxTokens ?? defaultMaxTokens;
+    if (max !== undefined)
+        body.max_tokens = max;
+    if (req.temperature !== undefined)
+        body.temperature = req.temperature;
+    if (req.stop && req.stop.length > 0)
+        body.stop = [...req.stop];
+    return body;
+}
+function toOpenAIMessages(messages, systemPrompt) {
+    const result = [];
+    if (systemPrompt)
+        result.push({ role: 'system', content: systemPrompt });
+    for (const m of messages) {
+        if (m.role === 'system') {
+            result.push({ role: 'system', content: m.content });
+            continue;
+        }
+        if (m.role === 'user') {
+            result.push({ role: 'user', content: m.content });
+            continue;
+        }
+        if (m.role === 'assistant') {
+            const msg = { role: 'assistant', content: m.content || null };
+            if (m.toolCalls && m.toolCalls.length > 0) {
+                msg.tool_calls = m.toolCalls.map((tc) => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: { name: tc.name, arguments: JSON.stringify(tc.args) },
+                }));
+            }
+            result.push(msg);
+            continue;
+        }
+        if (m.role === 'tool') {
+            result.push({
+                role: 'tool',
+                content: m.content,
+                tool_call_id: m.toolCallId ?? '',
+            });
+            continue;
+        }
+    }
+    return result;
+}
+function toOpenAITool(schema) {
+    return {
+        type: 'function',
+        function: {
+            name: schema.name,
+            description: schema.description,
+            parameters: { ...schema.inputSchema },
+        },
+    };
+}
+function fromOpenAIResponse(response) {
+    const choice = response.choices[0];
+    if (!choice)
+        throw new Error('[browser-openai] response missing choices[0]');
+    const message = choice.message;
+    const toolCalls = (message.tool_calls ?? []).map((tc) => ({
+        id: tc.id,
+        name: tc.function.name,
+        args: parseArgs(tc.function.arguments),
+    }));
+    return {
+        content: message.content ?? '',
+        toolCalls,
+        usage: {
+            input: response.usage?.prompt_tokens ?? 0,
+            output: response.usage?.completion_tokens ?? 0,
+        },
+        stopReason: normalizeStopReason(choice.finish_reason),
+        providerRef: response.id,
+    };
+}
+function parseArgs(json) {
+    if (!json)
+        return {};
+    try {
+        const parsed = JSON.parse(json);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function normalizeStopReason(raw) {
+    switch (raw) {
+        case 'stop':
+            return 'stop';
+        case 'tool_calls':
+            return 'tool_use';
+        case 'length':
+            return 'max_tokens';
+        case 'content_filter':
+            return 'content_filter';
+        default:
+            return raw;
+    }
+}
+/** Parse OpenAI's SSE stream — `data: ...\n\n` lines, `[DONE]` terminator. */
+async function* parseSSE(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = '';
+    try {
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let idx;
+            while ((idx = buf.indexOf('\n\n')) >= 0) {
+                const raw = buf.slice(0, idx);
+                buf = buf.slice(idx + 2);
+                for (const line of raw.split('\n')) {
+                    if (!line.startsWith('data:'))
+                        continue;
+                    const data = line.slice(5).trim();
+                    if (data === '[DONE]') {
+                        yield '[DONE]';
+                        return;
+                    }
+                    if (data) {
+                        try {
+                            yield JSON.parse(data);
+                        }
+                        catch {
+                            /* skip malformed */
+                        }
+                    }
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+async function wrapStatus(response) {
+    let bodyText = '';
+    try {
+        bodyText = await response.text();
+    }
+    catch {
+        /* ignore */
+    }
+    return Object.assign(new Error(`[browser-openai] ${response.status} ${response.statusText} — ${bodyText.slice(0, 200)}`), { name: 'BrowserOpenAIProviderError', status: response.status });
+}
+function wrapError(err) {
+    if (err instanceof Error) {
+        return Object.assign(new Error(`[browser-openai] ${err.message}`), {
+            name: 'BrowserOpenAIProviderError',
+            cause: err,
+        });
+    }
+    return new Error(`[browser-openai] ${String(err)}`);
+}
+//# sourceMappingURL=BrowserOpenAIProvider.js.map