@bbclaw/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @bbclaw/core
+ *
+ * Reusable agent runtime + provider abstraction. Imported by the CLI, the
+ * desktop app, and (eventually) the backend proxy.
+ */
+export * from './providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @bbclaw/core
+ *
+ * Reusable agent runtime + provider abstraction. Imported by the CLI, the
+ * desktop app, and (eventually) the backend proxy.
+ */
+export * from './providers/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;;;;;GAKG;AAEH,cAAc,sBAAsB,CAAA"}

package/dist/providers/anthropic/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * AnthropicProvider — thin transparent wrapper around the official SDK.
+ *
+ * This is the simplest possible Provider: forward params verbatim, stream
+ * events back verbatim. It exists as:
+ *   1. A reference implementation showing the "happy path" with zero translation.
+ *   2. The baseline anyone with an ANTHROPIC_API_KEY can fall back to.
+ *   3. A correctness oracle for the other providers — if openai-compat or
+ *      web-bridge ever diverge in behavior, this is what they should match.
+ */
+import type { Message, MessageCreateParamsStreaming, MessageStreamParams, RawMessageStreamEvent } from '@anthropic-ai/sdk/resources/messages/messages.js';
+import type { Logger } from '@bbclaw/shared';
+import { BaseProvider, type HealthCheckResult, type ProviderCapabilities } from '../types.js';
+export interface AnthropicProviderOptions {
+    apiKey?: string;
+    /** Override the API endpoint, e.g. for a local proxy or self-hosted gateway. */
+    baseURL?: string;
+    /** Defaults to 2. */
+    maxRetries?: number;
+    /** Custom fetch (for tests / electron net). */
+    fetch?: typeof fetch;
+    /** Stable instance id. Defaults to 'anthropic'. */
+    id?: string;
+    displayName?: string;
+    /** Probe model — kept small/cheap to make healthCheck() fast. */
+    probeModel?: string;
+    /** Default model used when a caller doesn't specify one (e.g. `bbclaw ask`). */
+    defaultModel?: string;
+    logger?: Logger;
+}
+export declare class AnthropicProvider extends BaseProvider {
+    readonly kind: "anthropic";
+    readonly id: string;
+    readonly displayName: string;
+    readonly defaultModel: string;
+    readonly capabilities: ProviderCapabilities;
+    private readonly client;
+    private readonly probeModel;
+    constructor(opts?: AnthropicProviderOptions);
+    streamMessage(params: MessageStreamParams | MessageCreateParamsStreaming): Promise<AsyncIterable<RawMessageStreamEvent>>;
+    createMessage(params: MessageStreamParams): Promise<Message>;
+    healthCheck(): Promise<HealthCheckResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/anthropic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/anthropic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,SAAkB,YAAY,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAQ1C;IAED,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,IAAI,GAAE,wBAA6B;IAczC,aAAa,CACjB,MAAM,EAAE,mBAAmB,GAAG,4BAA4B,GACzD,OAAO,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IASjC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAmBhD"}

package/dist/providers/anthropic/index.js

@@ -0,0 +1,75 @@
+/**
+ * AnthropicProvider — thin transparent wrapper around the official SDK.
+ *
+ * This is the simplest possible Provider: forward params verbatim, stream
+ * events back verbatim. It exists as:
+ *   1. A reference implementation showing the "happy path" with zero translation.
+ *   2. The baseline anyone with an ANTHROPIC_API_KEY can fall back to.
+ *   3. A correctness oracle for the other providers — if openai-compat or
+ *      web-bridge ever diverge in behavior, this is what they should match.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { BaseProvider, } from '../types.js';
+const DEFAULT_PROBE_MODEL = 'claude-3-5-haiku-latest';
+export class AnthropicProvider extends BaseProvider {
+    kind = 'anthropic';
+    id;
+    displayName;
+    defaultModel;
+    capabilities = {
+        nativeTools: true,
+        promptCaching: true,
+        extendedThinking: true,
+        vision: true,
+        contextWindow: 200_000,
+        maxOutputTokens: 16_384,
+        streaming: true,
+    };
+    client;
+    probeModel;
+    constructor(opts = {}) {
+        super(opts.logger ?? { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } });
+        this.id = opts.id ?? 'anthropic';
+        this.displayName = opts.displayName ?? 'Anthropic';
+        this.probeModel = opts.probeModel ?? DEFAULT_PROBE_MODEL;
+        this.defaultModel = opts.defaultModel ?? 'claude-3-5-sonnet-latest';
+        this.client = new Anthropic({
+            apiKey: opts.apiKey,
+            baseURL: opts.baseURL,
+            maxRetries: opts.maxRetries ?? 2,
+            fetch: opts.fetch,
+        });
+    }
+    async streamMessage(params) {
+        // The SDK's `create` with stream:true returns Stream<RawMessageStreamEvent>,
+        // which already satisfies AsyncIterable.
+        return this.client.messages.create({
+            ...params,
+            stream: true,
+        });
+    }
+    async createMessage(params) {
+        return this.client.messages.create({ ...params, stream: false });
+    }
+    async healthCheck() {
+        const start = Date.now();
+        try {
+            // 1-token probe. Cheaper than countTokens since some endpoints don't
+            // implement countTokens at all.
+            await this.client.messages.create({
+                model: this.probeModel,
+                max_tokens: 1,
+                messages: [{ role: 'user', content: 'ping' }],
+            });
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                reason: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/anthropic/index.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,8 @@
+/** Public surface of the providers subsystem. */
+export * from './types.js';
+export { ProviderRegistry } from './selector.js';
+export { AnthropicProvider, type AnthropicProviderOptions } from './anthropic/index.js';
+export { OpenAICompatProvider, type OpenAICompatProviderOptions, } from './openai-compat/index.js';
+export { OPENAI_COMPAT_PRESETS, getPreset, type ProviderPreset, } from './openai-compat/presets.js';
+export * from './web-bridge/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,4BAA4B,CAAA;AACnC,cAAc,uBAAuB,CAAA"}

package/dist/providers/index.js

@@ -0,0 +1,8 @@
+/** Public surface of the providers subsystem. */
+export * from './types.js';
+export { ProviderRegistry } from './selector.js';
+export { AnthropicProvider } from './anthropic/index.js';
+export { OpenAICompatProvider, } from './openai-compat/index.js';
+export { OPENAI_COMPAT_PRESETS, getPreset, } from './openai-compat/presets.js';
+export * from './web-bridge/index.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAiC,MAAM,sBAAsB,CAAA;AACvF,OAAO,EACL,oBAAoB,GAErB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,qBAAqB,EACrB,SAAS,GAEV,MAAM,4BAA4B,CAAA;AACnC,cAAc,uBAAuB,CAAA"}

package/dist/providers/openai-compat/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * OpenAICompatProvider — speaks the OpenAI chat/completions wire format.
+ *
+ * Compatible with: OpenAI, DeepSeek (official API), Groq, OpenRouter,
+ * Together, Mistral, Ollama, LM Studio, and any other server that implements
+ * the same schema.
+ *
+ * Translation responsibilities:
+ *   - Anthropic-shaped request → OpenAI request: see requestTranslate.ts
+ *   - OpenAI SSE response → Anthropic stream events: see streamAdapter.ts
+ *   - Capability advertisement based on the preset (overridable per instance).
+ */
+import type { Message, MessageCreateParamsStreaming, MessageStreamParams, RawMessageStreamEvent } from '@anthropic-ai/sdk/resources/messages/messages.js';
+import type { Logger } from '@bbclaw/shared';
+import { BaseProvider, type HealthCheckResult, type ProviderCapabilities } from '../types.js';
+export interface OpenAICompatProviderOptions {
+    id: string;
+    displayName?: string;
+    /** Either pass a preset id (resolved internally) or supply baseURL directly. */
+    preset?: string;
+    baseURL?: string;
+    /** API key. Some local backends (Ollama, LM Studio) don't require one. */
+    apiKey?: string;
+    /** Default model used when params.model is empty / unrecognized. */
+    defaultModel?: string;
+    /** Probe model used by healthCheck. Should be cheapest available. */
+    probeModel?: string;
+    /** Map an Anthropic model id to a provider-specific one. */
+    modelMap?: (anthropicModel: string) => string;
+    /** Provider-specific extra body fields. */
+    extraBody?: Record<string, unknown>;
+    /** Custom fetch (useful for testing or proxying). */
+    fetch?: typeof fetch;
+    /** Capability overrides — pass partial to override the preset defaults. */
+    capabilities?: Partial<ProviderCapabilities>;
+    /** Request timeout in ms (whole stream). Default 600s. */
+    timeoutMs?: number;
+    logger?: Logger;
+}
+export declare class OpenAICompatProvider extends BaseProvider {
+    readonly kind: "openai-compat";
+    readonly id: string;
+    readonly displayName: string;
+    readonly capabilities: ProviderCapabilities;
+    readonly defaultModel: string | undefined;
+    private readonly baseURL;
+    private readonly apiKey;
+    private readonly probeModel;
+    private readonly modelMap;
+    private readonly extraBody;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(opts: OpenAICompatProviderOptions);
+    streamMessage(params: MessageStreamParams | MessageCreateParamsStreaming): Promise<AsyncIterable<RawMessageStreamEvent>>;
+    createMessage(params: MessageStreamParams): Promise<Message>;
+    healthCheck(): Promise<HealthCheckResult>;
+    private buildHeaders;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/openai-compat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EACL,YAAY,EAEZ,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AAMpB,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7C,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC5C,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAeD,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAS;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,SAAkB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAElD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,EAAE,2BAA2B;IA+BvC,aAAa,CACjB,MAAM,EAAE,mBAAmB,GAAG,4BAA4B,GACzD,OAAO,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IA4CjC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrE,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA0B/C,OAAO,CAAC,YAAY;CAQrB"}

package/dist/providers/openai-compat/index.js

@@ -0,0 +1,175 @@
+/**
+ * OpenAICompatProvider — speaks the OpenAI chat/completions wire format.
+ *
+ * Compatible with: OpenAI, DeepSeek (official API), Groq, OpenRouter,
+ * Together, Mistral, Ollama, LM Studio, and any other server that implements
+ * the same schema.
+ *
+ * Translation responsibilities:
+ *   - Anthropic-shaped request → OpenAI request: see requestTranslate.ts
+ *   - OpenAI SSE response → Anthropic stream events: see streamAdapter.ts
+ *   - Capability advertisement based on the preset (overridable per instance).
+ */
+import { BaseProvider, collectStreamToMessage, } from '../types.js';
+import { getPreset } from './presets.js';
+import { translateRequest } from './requestTranslate.js';
+import { parseSSEStream, SSEParseError } from './sseParser.js';
+import { adaptOpenAIStream } from './streamAdapter.js';
+const DEFAULT_TIMEOUT_MS = 600_000;
+/** Sensible defaults for the "modern OpenAI-compatible" baseline. */
+const DEFAULT_OPENAI_COMPAT_CAPABILITIES = {
+    nativeTools: true,
+    promptCaching: false, // most providers don't honor cache_control on the wire
+    extendedThinking: false,
+    vision: true,
+    contextWindow: 128_000,
+    maxOutputTokens: 8_192,
+    streaming: true,
+};
+export class OpenAICompatProvider extends BaseProvider {
+    kind = 'openai-compat';
+    id;
+    displayName;
+    capabilities;
+    defaultModel;
+    baseURL;
+    apiKey;
+    probeModel;
+    modelMap;
+    extraBody;
+    fetchImpl;
+    timeoutMs;
+    constructor(opts) {
+        super(opts.logger ?? { debug: () => { }, info: () => { }, warn: () => { }, error: () => { } });
+        let preset;
+        if (opts.preset) {
+            preset = getPreset(opts.preset);
+            if (!preset)
+                throw new Error(`Unknown openai-compat preset: ${opts.preset}`);
+        }
+        const baseURL = (opts.baseURL ?? preset?.baseURL ?? '').replace(/\/+$/, '');
+        if (!baseURL) {
+            throw new Error('OpenAICompatProvider: baseURL is required (either directly or via preset).');
+        }
+        this.id = opts.id;
+        this.displayName = opts.displayName ?? preset?.label ?? opts.id;
+        this.baseURL = baseURL;
+        this.apiKey = opts.apiKey;
+        this.defaultModel = opts.defaultModel ?? preset?.defaultModel;
+        this.probeModel = opts.probeModel ?? preset?.defaultProbeModel ?? this.defaultModel;
+        this.modelMap = opts.modelMap;
+        this.extraBody = { ...preset?.extraBody, ...opts.extraBody };
+        this.fetchImpl = opts.fetch ?? globalThis.fetch;
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.capabilities = {
+            ...DEFAULT_OPENAI_COMPAT_CAPABILITIES,
+            ...opts.capabilities,
+        };
+    }
+    async streamMessage(params) {
+        const translateOpts = {
+            modelMap: this.modelMap ?? (this.defaultModel ? () => this.defaultModel : undefined),
+            includeUsage: true,
+            extraBody: this.extraBody,
+        };
+        const body = translateRequest(params, translateOpts);
+        const url = `${this.baseURL}/chat/completions`;
+        const ac = new AbortController();
+        const timeoutHandle = setTimeout(() => ac.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await this.fetchImpl(url, {
+                method: 'POST',
+                headers: this.buildHeaders(),
+                body: JSON.stringify(body),
+                signal: ac.signal,
+            });
+        }
+        catch (e) {
+            clearTimeout(timeoutHandle);
+            throw new Error(`OpenAICompatProvider: fetch failed (${e instanceof Error ? e.message : String(e)})`);
+        }
+        if (!response.ok) {
+            clearTimeout(timeoutHandle);
+            const detail = await response.text().catch(() => '');
+            throw new Error(`OpenAICompatProvider: HTTP ${response.status} — ${detail || response.statusText}`);
+        }
+        if (!response.body) {
+            clearTimeout(timeoutHandle);
+            throw new Error('OpenAICompatProvider: empty response body');
+        }
+        // Wrap the SSE → Anthropic adapter to clear the timeout when the stream ends.
+        const upstream = parseSSEStreamSafely(response.body, this.logger.warn.bind(this.logger));
+        const adapted = adaptOpenAIStream(upstream, { model: body.model });
+        return cleanupOnFinish(adapted, () => clearTimeout(timeoutHandle));
+    }
+    async createMessage(params) {
+        const stream = await this.streamMessage(params);
+        return collectStreamToMessage(stream);
+    }
+    async healthCheck() {
+        if (!this.probeModel) {
+            return { ok: false, reason: 'no probe model configured' };
+        }
+        const start = Date.now();
+        try {
+            const stream = await this.streamMessage({
+                model: this.probeModel,
+                max_tokens: 1,
+                messages: [{ role: 'user', content: 'ping' }],
+            });
+            // Drain at least one event to confirm the stream is alive.
+            for await (const _ev of stream) {
+                // first event is enough
+                break;
+            }
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch (e) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                reason: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'text/event-stream',
+        };
+        if (this.apiKey)
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        return headers;
+    }
+}
+/**
+ * Wrap parseSSEStream so that SSE-level parse errors don't abort the entire
+ * stream — we log and skip individual malformed events. (Hard errors like
+ * network drops still propagate.)
+ */
+async function* parseSSEStreamSafely(body, warn) {
+    try {
+        for await (const chunk of parseSSEStream(body)) {
+            yield chunk;
+        }
+    }
+    catch (e) {
+        if (e instanceof SSEParseError) {
+            warn('[openai-compat] dropped malformed SSE event:', e.message, e.raw.slice(0, 200));
+            return;
+        }
+        throw e;
+    }
+}
+/** Run a cleanup callback once the wrapped iterable is exhausted or aborted. */
+async function* cleanupOnFinish(iter, cleanup) {
+    try {
+        for await (const item of iter)
+            yield item;
+    }
+    finally {
+        cleanup();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/openai-compat/index.js.map

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

package/dist/providers/openai-compat/presets.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Curated presets for known OpenAI-compatible providers. Users select by
+ * preset name in the UI; preset values just pre-fill defaults that the user
+ * can still override (apiKey is never preset).
+ */
+export interface ProviderPreset {
+    /** Stable identifier, used in config files and CLI flags. */
+    id: string;
+    /** UI label. */
+    label: string;
+    baseURL: string;
+    defaultModel?: string;
+    /** A "Haiku-class" small/cheap model used by healthCheck. */
+    defaultProbeModel?: string;
+    /** Free-form note shown next to the preset in UI. */
+    notes?: string;
+    /** Some providers wedge extra fields into the request body. */
+    extraBody?: Record<string, unknown>;
+}
+export declare const OPENAI_COMPAT_PRESETS: ProviderPreset[];
+export declare function getPreset(id: string): ProviderPreset | undefined;
+//# sourceMappingURL=presets.d.ts.map

package/dist/providers/openai-compat/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,EA+DjD,CAAA;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEhE"}

package/dist/providers/openai-compat/presets.js

@@ -0,0 +1,73 @@
+/**
+ * Curated presets for known OpenAI-compatible providers. Users select by
+ * preset name in the UI; preset values just pre-fill defaults that the user
+ * can still override (apiKey is never preset).
+ */
+export const OPENAI_COMPAT_PRESETS = [
+    {
+        id: 'openai',
+        label: 'OpenAI',
+        baseURL: 'https://api.openai.com/v1',
+        defaultModel: 'gpt-4o',
+        defaultProbeModel: 'gpt-4o-mini',
+    },
+    {
+        id: 'deepseek-api',
+        label: 'DeepSeek (official API)',
+        baseURL: 'https://api.deepseek.com/v1',
+        defaultModel: 'deepseek-chat',
+        defaultProbeModel: 'deepseek-chat',
+        notes: 'Cheap, compliant, pay-as-you-go.',
+    },
+    {
+        id: 'groq',
+        label: 'Groq',
+        baseURL: 'https://api.groq.com/openai/v1',
+        defaultModel: 'llama-3.3-70b-versatile',
+        defaultProbeModel: 'llama-3.1-8b-instant',
+        notes: 'Very fast inference.',
+    },
+    {
+        id: 'openrouter',
+        label: 'OpenRouter',
+        baseURL: 'https://openrouter.ai/api/v1',
+        defaultModel: 'anthropic/claude-3.5-sonnet',
+        notes: 'One key, many models.',
+    },
+    {
+        id: 'together',
+        label: 'Together AI',
+        baseURL: 'https://api.together.xyz/v1',
+        defaultModel: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',
+    },
+    {
+        id: 'mistral',
+        label: 'Mistral',
+        baseURL: 'https://api.mistral.ai/v1',
+        defaultModel: 'mistral-large-latest',
+    },
+    {
+        id: 'ollama',
+        label: 'Ollama (local)',
+        baseURL: 'http://localhost:11434/v1',
+        defaultModel: 'qwen2.5:7b',
+        defaultProbeModel: 'qwen2.5:7b',
+        notes: 'Fully offline. No API key required.',
+    },
+    {
+        id: 'lm-studio',
+        label: 'LM Studio (local)',
+        baseURL: 'http://localhost:1234/v1',
+        notes: 'Fully offline.',
+    },
+    {
+        id: 'custom',
+        label: 'Custom (OpenAI-compatible)',
+        baseURL: '',
+        notes: 'Bring your own base URL.',
+    },
+];
+export function getPreset(id) {
+    return OPENAI_COMPAT_PRESETS.find((p) => p.id === id);
+}
+//# sourceMappingURL=presets.js.map

package/dist/providers/openai-compat/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/providers/openai-compat/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,QAAQ;QACtB,iBAAiB,EAAE,aAAa;KACjC;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,6BAA6B;QACtC,YAAY,EAAE,eAAe;QAC7B,iBAAiB,EAAE,eAAe;QAClC,KAAK,EAAE,kCAAkC;KAC1C;IACD;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,gCAAgC;QACzC,YAAY,EAAE,yBAAyB;QACvC,iBAAiB,EAAE,sBAAsB;QACzC,KAAK,EAAE,sBAAsB;KAC9B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,8BAA8B;QACvC,YAAY,EAAE,6BAA6B;QAC3C,KAAK,EAAE,uBAAuB;KAC/B;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,6BAA6B;QACtC,YAAY,EAAE,yCAAyC;KACxD;IACD;QACE,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,sBAAsB;KACrC;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,2BAA2B;QACpC,YAAY,EAAE,YAAY;QAC1B,iBAAiB,EAAE,YAAY;QAC/B,KAAK,EAAE,qCAAqC;KAC7C;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,0BAA0B;QACnC,KAAK,EAAE,gBAAgB;KACxB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,4BAA4B;QACnC,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,0BAA0B;KAClC;CACF,CAAA;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AACvD,CAAC"}

package/dist/providers/openai-compat/requestTranslate.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Translate an Anthropic-style request to OpenAI chat/completions wire format.
+ *
+ * Mapping decisions documented inline. The big ones:
+ *
+ * - Anthropic `system` is a TextBlockParam[] (each block can carry cache_control
+ *   hints). OpenAI has no equivalent; we concatenate the blocks with \n\n and
+ *   drop cache hints. The caller can strip them upstream if it wants stronger
+ *   guarantees (e.g. removing redundant boundary markers).
+ *
+ * - Anthropic tool_use/tool_result are content blocks inside a message.
+ *   OpenAI splits them: assistant messages carry `tool_calls`, and tool
+ *   results live in a separate `role: tool` message keyed by tool_call_id.
+ *   We expand one Anthropic message into 1+N OpenAI messages as needed.
+ *
+ * - Anthropic input is structured JSON (already an object). OpenAI sends it
+ *   serialized as a string in `function.arguments`. We JSON.stringify on the
+ *   way out and JSON.parse on the way back (in streamAdapter).
+ *
+ * - Thinking blocks are model-private CoT — they have no business in the
+ *   request side, so we drop them silently. (Some providers like DeepSeek-R1
+ *   echo reasoning back via `reasoning_content`; we'd render that on the
+ *   response side, not the request side.)
+ *
+ * - Images: Anthropic accepts base64 `source` or URL; OpenAI accepts URL or
+ *   base64 data URI. We convert base64 sources into `data:` URIs.
+ */
+import type { MessageCreateParamsBase } from '@anthropic-ai/sdk/resources/messages/messages.js';
+import type { OpenAIRequest } from './types.js';
+export interface TranslateRequestOptions {
+    /** Override or map the Anthropic model name to the provider's model name. */
+    modelMap?: (anthropicModel: string) => string;
+    /** Inject `stream_options: { include_usage: true }`. Default true. */
+    includeUsage?: boolean;
+    /** Extra fields to merge into the final request (provider-specific). */
+    extraBody?: Record<string, unknown>;
+}
+export declare function translateRequest(params: MessageCreateParamsBase, opts?: TranslateRequestOptions): OpenAIRequest;
+//# sourceMappingURL=requestTranslate.d.ts.map

package/dist/providers/openai-compat/requestTranslate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestTranslate.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-compat/requestTranslate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAGV,uBAAuB,EAOxB,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAIV,aAAa,EAGd,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7C,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,uBAAuB,EAC/B,IAAI,GAAE,uBAA4B,GACjC,aAAa,CAyCf"}