@adia-ai/llm 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 _No pending changes._
 
+## [0.6.2] - 2026-05-18
+
+### v0.6.2 — Lockstep ride-along
+
+TS Phase 4: retrieval (§356) + mcp (§357) `.ts` sources + TS-MIG-001 closed.
+No source changes in this package. Internal dep ranges stay at `^0.6.0`.
+
+
+
+## [0.6.1] - 2026-05-18
+
+### v0.6.1 §353 — TypeScript-first Phase 2: `@adia-ai/llm` source → `.ts`
+
+Converts all npm-published source files to TypeScript in `packages/llm/src/`. Emits
+`.js + .d.ts` via `tsconfig.build.json`. Replaces Phase 1 hotfix stubs with generated
+declarations. Adds `dist-check.test.js` (25 tests) + `scripts/dev/llm-smoke.mjs`.
+Published import paths unchanged. No runtime behaviour change.
+
+**No BREAKING changes.** Internal dep ranges stay at `^0.6.0`.
+
+
+
 ## [0.6.0] - 2026-05-18
 
 _Lockstep ride-along (no source change in this package; companion to web-components v0.6.0 — see root CHANGELOG)._

package/adapters/anthropic.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Anthropic Messages API adapter.
+ * Endpoint: https://api.anthropic.com/v1/messages
+ */
+export interface AdapterRequest {
+    url: string;
+    headers: Record<string, string>;
+    body: Record<string, unknown>;
+}
+export interface AdapterUsage {
+    input: number;
+    output: number;
+    cacheCreation?: number;
+    cacheRead?: number;
+}
+export interface AdapterResponse {
+    text: string;
+    usage: AdapterUsage;
+    stopReason: string;
+}
+export type StreamChunk = {
+    type: 'text';
+    text: string;
+    snapshot: string;
+} | {
+    type: 'thinking';
+    text: string;
+} | {
+    type: 'done';
+    text: string;
+    usage: AdapterUsage;
+    stopReason: string;
+} | {
+    type: 'error';
+    error: Error;
+};
+export interface BuildRequestOpts {
+    model: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    apiKey: string;
+    system?: string | Array<{
+        type: string;
+        text: string;
+        cache_control?: {
+            type: string;
+        };
+    }>;
+    maxTokens?: number;
+    temperature?: number;
+    stream?: boolean;
+    cache?: boolean;
+    thinking?: boolean;
+    thinkingBudget?: number;
+    signal?: AbortSignal | null;
+    proxyUrl?: string;
+    provider?: string;
+}
+interface AnthropicUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+interface AnthropicResponseBody {
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    usage?: AnthropicUsage;
+    stop_reason?: string;
+}
+export declare const anthropic: {
+    name: "anthropic";
+    buildRequest(opts: BuildRequestOpts): AdapterRequest;
+    parseResponse(data: AnthropicResponseBody): AdapterResponse;
+    parseStream(response: Response): AsyncGenerator<StreamChunk>;
+};
+export {};
+//# sourceMappingURL=anthropic.d.ts.map

package/adapters/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../src/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,UAAU,cAAc;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,eAAO,MAAM,SAAS;;uBAGD,gBAAgB,GAAG,cAAc;wBA4BhC,qBAAqB,GAAG,eAAe;0BAc9B,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC;CA2CpE,CAAC"}

package/adapters/anthropic.js

@@ -2,105 +2,103 @@
  * Anthropic Messages API adapter.
  * Endpoint: https://api.anthropic.com/v1/messages
  */
-
 import { readSSE } from './sse.js';
-
 const API_URL = 'https://api.anthropic.com/v1/messages';
 const API_VERSION = '2023-06-01';
-const DEFAULT_MAX_TOKENS = 4096;
-
+const DEFAULT_MAX_TOKENS = 32768;
+// ── Adapter ───────────────────────────────────────────────────────────────
 export const anthropic = {
-  name: 'anthropic',
-
-  buildRequest(opts) {
-    const body = {
-      model: opts.model,
-      max_tokens: opts.maxTokens || DEFAULT_MAX_TOKENS,
-      messages: opts.messages,
-      stream: !!opts.stream,
-    };
-    if (opts.system) {
-      // Prompt caching: the AdiaUI system prompt is ~23KB and constant across
-      // a session. Emitting it as a cached block marks it as a cache breakpoint
-      // (ephemeral, ~5 min TTL). First call = cache write (+25% cost), every
-      // subsequent call in the window = cache read (−90% cost). No-op below
-      // the model's minimum cacheable size (1024 tok Sonnet/Opus, 2048 Haiku).
-      body.system = opts.cache
-        ? [{ type: 'text', text: opts.system, cache_control: { type: 'ephemeral' } }]
-        : opts.system;
-    }
-    if (opts.temperature != null) body.temperature = opts.temperature;
-    if (opts.thinking) {
-      body.thinking = { type: 'enabled', budget_tokens: opts.thinkingBudget || 10000 };
-    }
-
-    return {
-      url: API_URL,
-      headers: {
-        'content-type': 'application/json',
-        'x-api-key': opts.apiKey,
-        'anthropic-version': API_VERSION,
-      },
-      body,
-    };
-  },
-
-  parseResponse(data) {
-    const text = data.content?.find(b => b.type === 'text')?.text ?? '';
-    return {
-      text,
-      usage: {
-        input: data.usage?.input_tokens ?? 0,
-        output: data.usage?.output_tokens ?? 0,
-        // Cache telemetry: non-zero cacheRead on turn 2+ is the signal that
-        // caching is actually kicking in. Recorded per-turn for hit-rate analysis.
-        cacheCreation: data.usage?.cache_creation_input_tokens ?? 0,
-        cacheRead: data.usage?.cache_read_input_tokens ?? 0,
-      },
-      stopReason: data.stop_reason ?? 'end',
-    };
-  },
-
-  async *parseStream(response) {
-    let snapshot = '';
-    let usage = { input: 0, output: 0, cacheCreation: 0, cacheRead: 0 };
-    let stopReason = 'end';
-
-    for await (const event of readSSE(response.body)) {
-      if (event.done) break;
-      let data;
-      try { data = JSON.parse(event.data); } catch { continue; }
-      const eventType = event.event ?? data.type;
-
-      switch (eventType) {
-        case 'message_start':
-          if (data.message?.usage) {
-            usage.input = data.message.usage.input_tokens ?? 0;
-            usage.cacheCreation = data.message.usage.cache_creation_input_tokens ?? 0;
-            usage.cacheRead = data.message.usage.cache_read_input_tokens ?? 0;
-          }
-          break;
-        case 'content_block_delta': {
-          const delta = data.delta;
-          if (delta?.type === 'text_delta') {
-            snapshot += delta.text;
-            yield { type: 'text', text: delta.text, snapshot };
-          } else if (delta?.type === 'thinking_delta') {
-            yield { type: 'thinking', text: delta.thinking };
-          }
-          break;
+    name: 'anthropic',
+    buildRequest(opts) {
+        const body = {
+            model: opts.model,
+            max_tokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,
+            messages: opts.messages,
+            stream: !!opts.stream,
+        };
+        if (opts.system != null) {
+            body['system'] = opts.cache
+                ? [{ type: 'text', text: opts.system, cache_control: { type: 'ephemeral' } }]
+                : opts.system;
         }
-        case 'message_delta':
-          if (data.delta?.stop_reason) stopReason = data.delta.stop_reason;
-          if (data.usage) usage.output = data.usage.output_tokens ?? 0;
-          break;
-        case 'message_stop':
-          yield { type: 'done', text: snapshot, usage, stopReason };
-          break;
-        case 'error':
-          yield { type: 'error', error: new Error(data.error?.message ?? 'Stream error') };
-          break;
-      }
-    }
-  },
+        if (opts.temperature != null)
+            body['temperature'] = opts.temperature;
+        if (opts.thinking) {
+            body['thinking'] = { type: 'enabled', budget_tokens: opts.thinkingBudget ?? 10000 };
+        }
+        return {
+            url: API_URL,
+            headers: {
+                'content-type': 'application/json',
+                'x-api-key': opts.apiKey,
+                'anthropic-version': API_VERSION,
+            },
+            body,
+        };
+    },
+    parseResponse(data) {
+        const text = data.content?.find(b => b.type === 'text')?.text ?? '';
+        return {
+            text,
+            usage: {
+                input: data.usage?.input_tokens ?? 0,
+                output: data.usage?.output_tokens ?? 0,
+                cacheCreation: data.usage?.cache_creation_input_tokens ?? 0,
+                cacheRead: data.usage?.cache_read_input_tokens ?? 0,
+            },
+            stopReason: data.stop_reason ?? 'end',
+        };
+    },
+    async *parseStream(response) {
+        if (!response.body)
+            throw new Error('Response body is null');
+        let snapshot = '';
+        let usage = { input: 0, output: 0, cacheCreation: 0, cacheRead: 0 };
+        let stopReason = 'end';
+        for await (const event of readSSE(response.body)) {
+            if (event.done)
+                break;
+            let data;
+            try {
+                data = JSON.parse(event.data);
+            }
+            catch {
+                continue;
+            }
+            const eventType = event.event ?? data.type;
+            switch (eventType) {
+                case 'message_start':
+                    if (data.message?.usage) {
+                        usage.input = data.message.usage.input_tokens ?? 0;
+                        usage.cacheCreation = data.message.usage.cache_creation_input_tokens ?? 0;
+                        usage.cacheRead = data.message.usage.cache_read_input_tokens ?? 0;
+                    }
+                    break;
+                case 'content_block_delta': {
+                    const delta = data.delta;
+                    if (delta?.type === 'text_delta' && delta.text != null) {
+                        snapshot += delta.text;
+                        yield { type: 'text', text: delta.text, snapshot };
+                    }
+                    else if (delta?.type === 'thinking_delta' && delta.thinking != null) {
+                        yield { type: 'thinking', text: delta.thinking };
+                    }
+                    break;
+                }
+                case 'message_delta':
+                    if (data.delta?.stop_reason)
+                        stopReason = data.delta.stop_reason;
+                    if (data.usage)
+                        usage.output = data.usage.output_tokens ?? 0;
+                    break;
+                case 'message_stop':
+                    yield { type: 'done', text: snapshot, usage, stopReason };
+                    break;
+                case 'error':
+                    yield { type: 'error', error: new Error(data.error?.message ?? 'Stream error') };
+                    break;
+            }
+        }
+    },
 };
+//# sourceMappingURL=anthropic.js.map

package/adapters/anthropic.js.map

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

package/adapters/gemini.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Google Gemini generateContent API adapter.
+ * Endpoint: https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent
+ * Streaming: .../{model}:streamGenerateContent?alt=sse
+ */
+import type { AdapterRequest, AdapterResponse, StreamChunk, BuildRequestOpts } from './anthropic.js';
+interface GeminiUsageMetadata {
+    promptTokenCount?: number;
+    candidatesTokenCount?: number;
+}
+interface GeminiPart {
+    text?: string;
+}
+interface GeminiContent {
+    parts?: GeminiPart[];
+}
+interface GeminiCandidate {
+    content?: GeminiContent;
+    finishReason?: string;
+}
+interface GeminiResponseBody {
+    candidates?: GeminiCandidate[];
+    usageMetadata?: GeminiUsageMetadata;
+}
+export declare const gemini: {
+    name: "gemini";
+    buildRequest(opts: BuildRequestOpts): AdapterRequest;
+    parseResponse(data: GeminiResponseBody): AdapterResponse;
+    parseStream(response: Response): AsyncGenerator<StreamChunk>;
+};
+export {};
+//# sourceMappingURL=gemini.d.ts.map

package/adapters/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../src/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAgB,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOnH,UAAU,mBAAmB;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,UAAU;IAAG,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACtC,UAAU,aAAa;IAAG,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE;AAChD,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAID,eAAO,MAAM,MAAM;;uBAGE,gBAAgB,GAAG,cAAc;wBA+BhC,kBAAkB,GAAG,eAAe;0BAa3B,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC;CAgCpE,CAAC"}

package/adapters/gemini.js

@@ -3,97 +3,84 @@
  * Endpoint: https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent
  * Streaming: .../{model}:streamGenerateContent?alt=sse
  */
-
 import { readSSE } from './sse.js';
-
 const API_URL = 'https://generativelanguage.googleapis.com/v1beta/models';
-const DEFAULT_MAX_TOKENS = 4096;
-
+const DEFAULT_MAX_TOKENS = 32768;
+// ── Adapter ────────────────────────────────────────────────────────────────
 export const gemini = {
-  name: 'gemini',
-
-  buildRequest(opts) {
-    const model = opts.model;
-    const contents = [];
-    for (const msg of opts.messages) {
-      contents.push({
-        role: msg.role === 'assistant' ? 'model' : 'user',
-        parts: [{ text: msg.content }],
-      });
-    }
-
-    const body = { contents };
-
-    if (opts.system) {
-      body.systemInstruction = { parts: [{ text: opts.system }] };
-    }
-
-    const generationConfig = {
-      maxOutputTokens: opts.maxTokens || DEFAULT_MAX_TOKENS,
-    };
-    if (opts.temperature != null) generationConfig.temperature = opts.temperature;
-    body.generationConfig = generationConfig;
-
-    const action = opts.stream
-      ? `streamGenerateContent?alt=sse`
-      : 'generateContent';
-
-    return {
-      url: `${API_URL}/${model}:${action}`,
-      headers: {
-        'content-type': 'application/json',
-        'x-goog-api-key': opts.apiKey,
-      },
-      body,
-    };
-  },
-
-  parseResponse(data) {
-    const parts = data.candidates?.[0]?.content?.parts ?? [];
-    const text = parts.map(p => p.text ?? '').join('');
-    return {
-      text,
-      usage: {
-        input: data.usageMetadata?.promptTokenCount ?? 0,
-        output: data.usageMetadata?.candidatesTokenCount ?? 0,
-      },
-      stopReason: data.candidates?.[0]?.finishReason === 'STOP' ? 'end' : 'end',
-    };
-  },
-
-  async *parseStream(response) {
-    let snapshot = '';
-    let usage = { input: 0, output: 0 };
-    let stopReason = 'end';
-
-    for await (const event of readSSE(response.body)) {
-      if (event.done) break;
-      let data;
-      try { data = JSON.parse(event.data); } catch { continue; }
-
-      if (data.usageMetadata) {
-        usage.input = data.usageMetadata.promptTokenCount ?? 0;
-        usage.output = data.usageMetadata.candidatesTokenCount ?? 0;
-      }
-
-      const candidate = data.candidates?.[0];
-      if (!candidate) continue;
-
-      if (candidate.finishReason && candidate.finishReason !== 'STOP') {
-        stopReason = candidate.finishReason;
-      }
-
-      const parts = candidate.content?.parts;
-      if (!parts?.length) continue;
-
-      for (const part of parts) {
-        if (part.text != null) {
-          snapshot += part.text;
-          yield { type: 'text', text: part.text, snapshot };
+    name: 'gemini',
+    buildRequest(opts) {
+        const model = opts.model;
+        const contents = opts.messages.map(msg => ({
+            role: msg.role === 'assistant' ? 'model' : 'user',
+            parts: [{ text: msg.content }],
+        }));
+        const body = { contents };
+        if (opts.system != null) {
+            body['systemInstruction'] = { parts: [{ text: opts.system }] };
         }
-      }
-    }
-
-    yield { type: 'done', text: snapshot, usage, stopReason };
-  },
+        const generationConfig = {
+            maxOutputTokens: opts.maxTokens ?? DEFAULT_MAX_TOKENS,
+        };
+        if (opts.temperature != null)
+            generationConfig['temperature'] = opts.temperature;
+        body['generationConfig'] = generationConfig;
+        const action = opts.stream ? 'streamGenerateContent?alt=sse' : 'generateContent';
+        return {
+            url: `${API_URL}/${model}:${action}`,
+            headers: {
+                'content-type': 'application/json',
+                'x-goog-api-key': opts.apiKey,
+            },
+            body,
+        };
+    },
+    parseResponse(data) {
+        const parts = data.candidates?.[0]?.content?.parts ?? [];
+        const text = parts.map(p => p.text ?? '').join('');
+        return {
+            text,
+            usage: {
+                input: data.usageMetadata?.promptTokenCount ?? 0,
+                output: data.usageMetadata?.candidatesTokenCount ?? 0,
+            },
+            stopReason: 'end',
+        };
+    },
+    async *parseStream(response) {
+        if (!response.body)
+            throw new Error('Response body is null');
+        let snapshot = '';
+        let usage = { input: 0, output: 0 };
+        const stopReason = 'end';
+        for await (const event of readSSE(response.body)) {
+            if (event.done)
+                break;
+            let data;
+            try {
+                data = JSON.parse(event.data);
+            }
+            catch {
+                continue;
+            }
+            if (data.usageMetadata) {
+                usage.input = data.usageMetadata.promptTokenCount ?? 0;
+                usage.output = data.usageMetadata.candidatesTokenCount ?? 0;
+            }
+            const candidate = data.candidates?.[0];
+            if (!candidate)
+                continue;
+            const parts = candidate.content?.parts;
+            if (!parts?.length)
+                continue;
+            for (const part of parts) {
+                if (part.text != null) {
+                    snapshot += part.text;
+                    yield { type: 'text', text: part.text, snapshot };
+                }
+            }
+        }
+        yield { type: 'done', text: snapshot, usage, stopReason };
+    },
 };
+//# sourceMappingURL=gemini.js.map

package/adapters/gemini.js.map

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

package/adapters/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * LLM Client — Provider-agnostic chat interface.
+ *
+ * Usage:
+ *   import { createClient, chat, streamChat } from './llm/index.js';
+ *
+ *   // Quick use (provider auto-detected from model name)
+ *   const reply = await chat({
+ *     apiKey: 'sk-ant-...',
+ *     model: 'claude-sonnet-4-20250514',
+ *     messages: [{ role: 'user', content: 'Hello' }],
+ *   });
+ *
+ *   for await (const chunk of streamChat({
+ *     apiKey: 'sk-...',
+ *     model: 'gpt-4o',
+ *     messages: [{ role: 'user', content: 'Hello' }],
+ *   })) {
+ *     if (chunk.type === 'text') process.stdout.write(chunk.text);
+ *   }
+ *
+ *   // Explicit provider
+ *   const reply = await chat({ provider: 'gemini', apiKey: '...', model: 'gemini-2.5-flash', ... });
+ *
+ *   // Reusable client instance
+ *   const client = createClient({ provider: 'anthropic', apiKey: '...' });
+ *   const reply = await client.chat({ model: 'claude-sonnet-4-20250514', messages: [...] });
+ *   for await (const chunk of client.stream({ model: '...', messages: [...] })) { ... }
+ *
+ * Chunk types (streaming):
+ *   { type: 'text',     text: 'delta', snapshot: 'full text so far' }
+ *   { type: 'thinking', text: 'thinking delta' }
+ *   { type: 'done',     text: 'full response', usage: { input, output }, stopReason }
+ *   { type: 'error',    error: Error }
+ */
+import { anthropic } from './anthropic.js';
+import { openai } from './openai.js';
+import { gemini } from './gemini.js';
+import type { AdapterResponse, AdapterUsage, StreamChunk, BuildRequestOpts } from './anthropic.js';
+export type { StreamChunk, AdapterUsage, AdapterResponse, BuildRequestOpts };
+export interface ChatOpts {
+    model: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    apiKey: string;
+    provider?: string;
+    system?: string | Array<{
+        type: string;
+        text: string;
+        cache_control?: {
+            type: string;
+        };
+    }>;
+    maxTokens?: number;
+    temperature?: number;
+    stream?: boolean;
+    thinking?: boolean;
+    thinkingBudget?: number;
+    signal?: AbortSignal | null;
+    proxyUrl?: string;
+    cache?: boolean;
+}
+export interface ChatResult {
+    text: string;
+    usage: AdapterUsage;
+    stopReason: string;
+}
+export interface LLMClient {
+    chat(opts: Partial<ChatOpts>): Promise<ChatResult>;
+    stream(opts: Partial<ChatOpts>): AsyncGenerator<StreamChunk>;
+}
+/**
+ * Non-streaming chat completion.
+ */
+export declare function chat(opts: ChatOpts): Promise<ChatResult>;
+/**
+ * Streaming chat — yields chunks as they arrive.
+ */
+export declare function streamChat(opts: ChatOpts): AsyncGenerator<StreamChunk>;
+/**
+ * Create a reusable client instance with defaults baked in.
+ *
+ * @param defaults
+ * @param defaults.provider — 'anthropic' | 'openai' | 'gemini'
+ * @param defaults.apiKey
+ * @param defaults.model — default model
+ * @param defaults.proxyUrl — proxy URL (for CORS)
+ * @param defaults.system — default system prompt
+ */
+export declare function createClient(defaults?: Partial<ChatOpts>): LLMClient;
+export { anthropic, openai, gemini };
+//# sourceMappingURL=index.d.ts.map

package/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnG,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAI7E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;CAC9D;AAqFD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAmB9D;AAED;;GAEG;AACH,wBAAuB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CA0B7E;AAID;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,SAAS,CAKxE;AAGD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}