@adia-ai/llm 0.6.0 → 0.6.1

package/index.js

@@ -1,23 +1,14 @@
 /**
- * @adia-ai/llm — provider-agnostic LLM client.
+ * @adia-ai/llm — provider-agnostic LLM client for AdiaUI.
  *
- * Re-exports the adapters facade so `@adia-ai/llm` is the single entry
- * point for chat-shell, the a2ui generation pipeline, and any other
- * consumer that needs to talk to anthropic / openai / gemini.
- *
- *   import { chat, streamChat, createClient } from '@adia-ai/llm';
- *   import { MODELS, DEFAULT_MODEL } from '@adia-ai/llm/models';
- *   import { createAdapter } from '@adia-ai/llm/bridge';
- *   import { StubLLMAdapter } from '@adia-ai/llm/stub';
+ * Re-exports the public API surface:
+ *   - chat, streamChat, createClient  — standalone functions + factory
+ *   - MODELS, DEFAULT_MODEL           — model catalog
+ *   - StubLLMAdapter                  — deterministic test stub
+ *   - createAdapter                   — AdiaUI pipeline bridge
  */
-
-export {
-  chat,
-  streamChat,
-  createClient,
-} from './adapters/index.js';
-
-export {
-  MODELS,
-  DEFAULT_MODEL,
-} from './models.js';
+export { chat, streamChat, createClient } from './adapters/index.js';
+export { MODELS, DEFAULT_MODEL } from './models.js';
+export { StubLLMAdapter } from './llm-stub.js';
+export { createAdapter } from './llm-bridge.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/llm-bridge.d.ts

@@ -0,0 +1,102 @@
+/**
+ * LLM Bridge — Wraps AdiaUI's llm module into the AdiaUI createAdapter() API.
+ *
+ * This is the single integration point between the AdiaUI pipeline and the
+ * LLM module. It handles:
+ *   - Env var reading (VITE_* in browser, process.env in Node)
+ *   - CORS proxy routing in browser (Vite dev server at /api/llm/*)
+ *   - API translation (AdiaUI's simple { messages, systemPrompt } → llm module's interface)
+ *
+ * Consumers call createAdapter() and get an object with .complete() and .stream()
+ * matching the AdiaUI pipeline interface.
+ */
+import { StubLLMAdapter } from './llm-stub.js';
+import type { LLMClient } from './adapters/index.js';
+/**
+ * Create an LLM adapter for the AdiaUI pipeline.
+ *
+ * Auto-detects provider from env vars. Returns an object with .complete()
+ * and .stream() that match the AdiaUI interface (simple messages + systemPrompt).
+ *
+ * @param opts
+ * @param opts.provider — 'anthropic' | 'openai' | 'google' | 'stub'
+ * @param opts.apiKey — explicit API key (overrides env)
+ * @param opts.model — model override
+ * @returns {StubLLMAdapter | AdiaUILLMBridge}
+ */
+export declare function createAdapter(opts?: {
+    provider?: string;
+    apiKey?: string;
+    model?: string;
+}): Promise<StubLLMAdapter | AdiaUILLMBridge>;
+/**
+ * Wraps the AdiaUI llm client to match the AdiaUI pipeline's simpler interface.
+ *
+ * AdiaUI calls: adapter.complete({ messages, systemPrompt })
+ * LLM module expects: client.chat({ model, messages, system, ... })
+ */
+declare class AdiaUILLMBridge {
+    #private;
+    constructor(client: LLMClient, model: string, provider: string);
+    /**
+     * Non-streaming completion. Matches AdiaUI interface.
+     *
+     * 32k max_tokens: A2UI JSON for moderately complex UIs (kanban, dashboard,
+     * pricing table) routinely exceeds 8k. Truncation produced silent fallbacks
+     * that the validator rubber-stamped at ~89/100 — see diagnosis report
+     * 2026-04-19. Modern Claude/GPT/Gemini all support ≥32k output cleanly.
+     *
+     * @param opts
+     * @param opts.messages
+     * @param opts.systemPrompt
+     */
+    complete({ messages, systemPrompt }: {
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        systemPrompt?: string;
+    }): Promise<{
+        content: string;
+        stopReason: string;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheCreationTokens: number;
+            cacheReadTokens: number;
+        };
+    }>;
+    /**
+     * Streaming completion. Matches AdiaUI interface.
+     *
+     * @param opts
+     * @param opts.messages
+     * @param opts.systemPrompt
+     * @yields {{ type: 'text', content: string } | { type: 'done', stopReason: string, usage: { inputTokens: number, outputTokens: number, cacheCreationTokens: number, cacheReadTokens: number } }}
+     */
+    stream({ messages, systemPrompt }: {
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+        systemPrompt?: string;
+    }): AsyncGenerator<{
+        type: 'text';
+        content: string;
+    } | {
+        type: 'done';
+        stopReason: string;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheCreationTokens: number;
+            cacheReadTokens: number;
+        };
+    }>;
+    /** Expose the underlying client for advanced use. */
+    get adapter(): LLMClient;
+    /** Expose provider name for detection. */
+    get provider(): string;
+}
+export {};
+//# sourceMappingURL=llm-bridge.d.ts.map

package/llm-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-bridge.d.ts","sourceRoot":"","sources":["src/llm-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA2F/D;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,GAAG,eAAe,CAAC,CA+DhJ;AAkBD;;;;;GAKG;AACH,cAAM,eAAe;;gBAKP,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAM9D;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,mBAAmB,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAsBvR;;;;;;;OAOG;IACI,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CACpI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACjC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,mBAAmB,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CACnJ;IA8BD,qDAAqD;IACrD,IAAI,OAAO,cAA2B;IAEtC,0CAA0C;IAC1C,IAAI,QAAQ,WAA6B;CAC1C"}

package/llm-bridge.js

@@ -10,51 +10,48 @@
  * Consumers call createAdapter() and get an object with .complete() and .stream()
  * matching the AdiaUI pipeline interface.
  */
-
 import { StubLLMAdapter } from './llm-stub.js';
-
 // Lazy-loaded — ../llm/index.js uses Vite aliases that don't resolve in Node
 let _createClient = null;
 async function getCreateClient() {
-  if (!_createClient) {
-    try {
-      const mod = await import('./adapters/index.js');
-      _createClient = mod.createClient;
-    } catch {
-      _createClient = null;
+    if (!_createClient) {
+        try {
+            const mod = await import('./adapters/index.js');
+            _createClient = mod.createClient;
+        }
+        catch {
+            _createClient = null;
+        }
     }
-  }
-  return _createClient;
+    return _createClient;
 }
-
 // ── Environment ──────────────────────────────────────────────────────────
-
 function getEnv(key) {
-  try {
-    const env = import.meta.env;
-    if (env) {
-      const val = env[`VITE_${key}`] || env[key];
-      if (val) return val;
+    try {
+        const env = import.meta.env;
+        if (env) {
+            const val = env[`VITE_${key}`] || env[key];
+            if (val)
+                return val;
+        }
     }
-  } catch {}
-  if (typeof process !== 'undefined' && process.env) {
-    return process.env[key] || '';
-  }
-  return '';
+    catch { }
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[key] || '';
+    }
+    return '';
 }
-
 const IS_BROWSER = typeof window !== 'undefined';
-
 function resolveBaseUrl(provider) {
-  if (!IS_BROWSER) return undefined; // Let the module use its defaults
-  const proxyMap = {
-    anthropic: '/api/llm/anthropic/v1/messages',
-    openai: '/api/llm/openai/v1/chat/completions',
-    google: '/api/llm/google',
-  };
-  return proxyMap[provider];
+    if (!IS_BROWSER)
+        return undefined; // Let the module use its defaults
+    const proxyMap = {
+        anthropic: '/api/llm/anthropic/v1/messages',
+        openai: '/api/llm/openai/v1/chat/completions',
+        google: '/api/llm/google',
+    };
+    return proxyMap[provider];
 }
-
 /**
  * §181 (v0.5.5) — Is the browser running on a production host (not a
  * local Vite dev server)? Used by createAdapter() to decide whether
@@ -62,17 +59,23 @@ function resolveBaseUrl(provider) {
  * even when no API key is visible to the browser.
  */
 function isProductionHost() {
-  if (!IS_BROWSER) return false;
-  const host = window.location?.hostname || '';
-  if (!host) return false;
-  if (host === 'localhost' || host === '127.0.0.1' || host === '0.0.0.0') return false;
-  if (host.endsWith('.local')) return false;
-  if (/^10\./.test(host)) return false;
-  if (/^192\.168\./.test(host)) return false;
-  if (/^172\.(1[6-9]|2\d|3[01])\./.test(host)) return false;
-  return true;
+    if (!IS_BROWSER)
+        return false;
+    const host = window.location?.hostname || '';
+    if (!host)
+        return false;
+    if (host === 'localhost' || host === '127.0.0.1' || host === '0.0.0.0')
+        return false;
+    if (host.endsWith('.local'))
+        return false;
+    if (/^10\./.test(host))
+        return false;
+    if (/^192\.168\./.test(host))
+        return false;
+    if (/^172\.(1[6-9]|2\d|3[01])\./.test(host))
+        return false;
+    return true;
 }
-
 /**
  * §181 (v0.5.5) — Build a bridge for the production-browser case
  * where there's no client-side API key but the page can reach a
@@ -84,117 +87,102 @@ function isProductionHost() {
  * reaches the upstream provider — the proxy discards it.
  */
 async function createBrowserProxyBridge(provider, modelOpt) {
-  const createClient = await getCreateClient();
-  if (!createClient) {
-    console.warn('LLM Bridge: LLM module not available. Using stub adapter.');
-    return new StubLLMAdapter();
-  }
-  const model = modelOpt || DEFAULT_MODELS[provider] || 'claude-haiku-4-5-20251001';
-  const proxyUrl = resolveBaseUrl(provider);
-  const client = createClient({
-    provider,
-    apiKey: 'browser-uses-server-side-proxy-key',  // sentinel; proxy ignores it
-    model,
-    ...(proxyUrl ? { proxyUrl } : {}),
-  });
-  return new AdiaUILLMBridge(client, model, provider);
+    const createClient = await getCreateClient();
+    if (!createClient) {
+        console.warn('LLM Bridge: LLM module not available. Using stub adapter.');
+        return new StubLLMAdapter();
+    }
+    const model = modelOpt || DEFAULT_MODELS[provider] || 'claude-haiku-4-5-20251001';
+    const proxyUrl = resolveBaseUrl(provider);
+    const client = createClient({
+        provider,
+        apiKey: 'browser-uses-server-side-proxy-key', // sentinel; proxy ignores it
+        model,
+        ...(proxyUrl ? { proxyUrl } : {}),
+    });
+    return new AdiaUILLMBridge(client, model, provider);
 }
-
 // ── Factory ──────────────────────────────────────────────────────────────
-
 /**
  * Create an LLM adapter for the AdiaUI pipeline.
  *
  * Auto-detects provider from env vars. Returns an object with .complete()
  * and .stream() that match the AdiaUI interface (simple messages + systemPrompt).
  *
- * @param {object} [opts]
- * @param {string} [opts.provider] — 'anthropic' | 'openai' | 'google' | 'stub'
- * @param {string} [opts.apiKey] — explicit API key (overrides env)
- * @param {string} [opts.model] — model override
+ * @param opts
+ * @param opts.provider — 'anthropic' | 'openai' | 'google' | 'stub'
+ * @param opts.apiKey — explicit API key (overrides env)
+ * @param opts.model — model override
  * @returns {StubLLMAdapter | AdiaUILLMBridge}
  */
 export async function createAdapter(opts = {}) {
-  const provider = opts.provider || getEnv('LLM_PROVIDER') || detectProvider();
-  const model = opts.model || getEnv('LLM_MODEL') || undefined;
-
-  if (provider === 'stub') {
-    // §181 (v0.5.5) — browser on a production host: even though
-    // detectProvider() returned 'stub' (no env vars in the browser),
-    // the page can still make real LLM calls via the same-origin
-    // proxy at /api/llm/<provider>/<rest>. The proxy strips the
-    // incoming x-api-key / Authorization header and re-injects its
-    // own server-side key. The sentinel below is a non-empty
-    // placeholder so the bridge passes the !apiKey gate; it never
-    // reaches the upstream provider.
-    if (IS_BROWSER && isProductionHost()) {
-      return createBrowserProxyBridge('anthropic', opts.model);
+    const provider = opts.provider || getEnv('LLM_PROVIDER') || detectProvider();
+    const model = opts.model || getEnv('LLM_MODEL') || undefined;
+    if (provider === 'stub') {
+        // §181 (v0.5.5) — browser on a production host: even though
+        // detectProvider() returned 'stub' (no env vars in the browser),
+        // the page can still make real LLM calls via the same-origin
+        // proxy at /api/llm/<provider>/<rest>. The proxy strips the
+        // incoming x-api-key / Authorization header and re-injects its
+        // own server-side key. The sentinel below is a non-empty
+        // placeholder so the bridge passes the !apiKey gate; it never
+        // reaches the upstream provider.
+        if (IS_BROWSER && isProductionHost()) {
+            return createBrowserProxyBridge('anthropic', opts.model);
+        }
+        return new StubLLMAdapter();
+    }
+    // Resolve API key for the detected provider
+    const apiKey = opts.apiKey || getEnv(`${provider.toUpperCase()}_API_KEY`) || getEnv('ANTHROPIC_API_KEY') || getEnv('OPENAI_API_KEY') || getEnv('GOOGLE_API_KEY');
+    // Browser-only safety reminder: when running through the dev-server's
+    // passthrough proxy, the API key is sent verbatim in `x-api-key` /
+    // `Authorization` headers from the browser. Anyone with DevTools open
+    // can read it from the Network panel — fine for local dev, **never**
+    // deploy this shape. We log once per session (deduplicated via a
+    // window-scoped flag) when a key is present and we're in the browser.
+    // Journal entry 2026-05-11 §22 documents the root cause.
+    if (IS_BROWSER && apiKey && typeof window !== 'undefined' && !window.__adia_llm_key_warning_shown) {
+        window.__adia_llm_key_warning_shown = true;
+        const masked = apiKey.length > 12 ? `${apiKey.slice(0, 8)}…${apiKey.slice(-4)}` : '••••';
+        console.warn(`%c[@adia-ai/llm] %cAPI key in browser:%c ${provider} key (${masked}) will be sent in request headers via the Vite passthrough proxy. ` +
+            `Anyone with DevTools access on this dev server can read it. Local-dev only — never deploy this shape. ` +
+            `Rotate at the provider console if this transcript leaves your machine.`, 'color: #a78bfa; font-weight: bold;', 'color: #f59e0b; font-weight: bold;', 'color: inherit;');
     }
-    return new StubLLMAdapter();
-  }
-
-  // Resolve API key for the detected provider
-  const apiKey = opts.apiKey || getEnv(`${provider.toUpperCase()}_API_KEY`) || getEnv('ANTHROPIC_API_KEY') || getEnv('OPENAI_API_KEY') || getEnv('GOOGLE_API_KEY');
-
-  // Browser-only safety reminder: when running through the dev-server's
-  // passthrough proxy, the API key is sent verbatim in `x-api-key` /
-  // `Authorization` headers from the browser. Anyone with DevTools open
-  // can read it from the Network panel — fine for local dev, **never**
-  // deploy this shape. We log once per session (deduplicated via a
-  // window-scoped flag) when a key is present and we're in the browser.
-  // Journal entry 2026-05-11 §22 documents the root cause.
-  if (IS_BROWSER && apiKey && typeof window !== 'undefined' && !window.__adia_llm_key_warning_shown) {
-    window.__adia_llm_key_warning_shown = true;
-    const masked = apiKey.length > 12 ? `${apiKey.slice(0, 8)}…${apiKey.slice(-4)}` : '••••';
-    console.warn(
-      `%c[@adia-ai/llm] %cAPI key in browser:%c ${provider} key (${masked}) will be sent in request headers via the Vite passthrough proxy. ` +
-      `Anyone with DevTools access on this dev server can read it. Local-dev only — never deploy this shape. ` +
-      `Rotate at the provider console if this transcript leaves your machine.`,
-      'color: #a78bfa; font-weight: bold;',
-      'color: #f59e0b; font-weight: bold;',
-      'color: inherit;'
-    );
-  }
-
-  // No key found → fall back to stub
-  if (!apiKey) {
-    console.warn('LLM Bridge: No API keys found. Using stub adapter.');
-    return new StubLLMAdapter();
-  }
-
-  const createClient = await getCreateClient();
-  if (!createClient) {
-    console.warn('LLM Bridge: LLM module not available. Using stub adapter.');
-    return new StubLLMAdapter();
-  }
-
-  const proxyUrl = resolveBaseUrl(provider);
-  const client = createClient({
-    provider,
-    apiKey,
-    model: model || DEFAULT_MODELS[provider] || 'claude-sonnet-4-20250514',
-    ...(proxyUrl ? { proxyUrl } : {}),
-  });
-
-  return new AdiaUILLMBridge(client, model || DEFAULT_MODELS[provider] || 'claude-sonnet-4-20250514', provider);
+    // No key found → fall back to stub
+    if (!apiKey) {
+        console.warn('LLM Bridge: No API keys found. Using stub adapter.');
+        return new StubLLMAdapter();
+    }
+    const createClient = await getCreateClient();
+    if (!createClient) {
+        console.warn('LLM Bridge: LLM module not available. Using stub adapter.');
+        return new StubLLMAdapter();
+    }
+    const proxyUrl = resolveBaseUrl(provider);
+    const client = createClient({
+        provider,
+        apiKey,
+        model: model || DEFAULT_MODELS[provider] || 'claude-sonnet-4-20250514',
+        ...(proxyUrl ? { proxyUrl } : {}),
+    });
+    return new AdiaUILLMBridge(client, model || DEFAULT_MODELS[provider] || 'claude-sonnet-4-20250514', provider);
 }
-
 function detectProvider() {
-  if (getEnv('ANTHROPIC_API_KEY')) return 'anthropic';
-  if (getEnv('OPENAI_API_KEY')) return 'openai';
-  if (getEnv('GOOGLE_API_KEY')) return 'google';
-  return 'stub';
+    if (getEnv('ANTHROPIC_API_KEY'))
+        return 'anthropic';
+    if (getEnv('OPENAI_API_KEY'))
+        return 'openai';
+    if (getEnv('GOOGLE_API_KEY'))
+        return 'google';
+    return 'stub';
 }
-
 // ── Bridge class ─────────────────────────────────────────────────────────
-
 /** Default models per provider */
 const DEFAULT_MODELS = {
-  anthropic: 'claude-sonnet-4-20250514',
-  openai: 'gpt-4o',
-  google: 'gemini-2.0-flash',
+    anthropic: 'claude-sonnet-4-20250514',
+    openai: 'gpt-4o',
+    google: 'gemini-2.0-flash',
 };
-
 /**
  * Wraps the AdiaUI llm client to match the AdiaUI pipeline's simpler interface.
  *
@@ -202,91 +190,88 @@ const DEFAULT_MODELS = {
  * LLM module expects: client.chat({ model, messages, system, ... })
  */
 class AdiaUILLMBridge {
-  #client;
-  #model;
-  #provider;
-
-  constructor(client, model, provider) {
-    this.#client = client;
-    this.#model = model;
-    this.#provider = provider;
-  }
-
-  /**
-   * Non-streaming completion. Matches AdiaUI interface.
-   *
-   * 32k max_tokens: A2UI JSON for moderately complex UIs (kanban, dashboard,
-   * pricing table) routinely exceeds 8k. Truncation produced silent fallbacks
-   * that the validator rubber-stamped at ~89/100 — see diagnosis report
-   * 2026-04-19. Modern Claude/GPT/Gemini all support ≥32k output cleanly.
-   *
-   * @param {{ messages: { role: string, content: string }[], systemPrompt?: string }} opts
-   * @returns {Promise<{ content: string, stopReason: string, usage: { inputTokens: number, outputTokens: number } }>}
-   */
-  async complete({ messages, systemPrompt }) {
-    const response = await this.#client.chat({
-      model: this.#model,
-      messages,
-      system: systemPrompt,
-      maxTokens: 32768,
-      // Anthropic-only: mark the system prompt as a cache breakpoint. No-op
-      // on other providers (unknown opt silently ignored) and no-op below the
-      // model's minimum cacheable size.
-      cache: this.#provider === 'anthropic',
-    });
-    return {
-      content: response.text,
-      // 'max_tokens' / 'length' / 'MAX_TOKENS' (Gemini) signal truncation;
-      // downstream parser uses this to refuse silent fallback rendering.
-      stopReason: response.stopReason ?? 'end',
-      usage: {
-        inputTokens: response.usage?.input ?? 0,
-        outputTokens: response.usage?.output ?? 0,
-        cacheCreationTokens: response.usage?.cacheCreation ?? 0,
-        cacheReadTokens: response.usage?.cacheRead ?? 0,
-      },
-    };
-  }
-
-  /**
-   * Streaming completion. Matches AdiaUI interface.
-   *
-   * @param {{ messages: { role: string, content: string }[], systemPrompt?: string }} opts
-   * @yields {{ type: 'text', content: string } | { type: 'done', stopReason: string, usage: { inputTokens: number, outputTokens: number, cacheCreationTokens: number, cacheReadTokens: number } }}
-   */
-  async *stream({ messages, systemPrompt }) {
-    for await (const chunk of this.#client.stream({
-      model: this.#model,
-      messages,
-      system: systemPrompt,
-      maxTokens: 32768,
-      cache: this.#provider === 'anthropic',
-    })) {
-      if (chunk.type === 'text') {
-        yield { type: 'text', content: chunk.text };
-      } else if (chunk.type === 'done') {
-        // Surface the terminal stopReason + cache telemetry so the consumer
-        // can detect max_tokens truncation and the dialog recorder can log
-        // cache hit-rate per turn.
-        yield {
-          type: 'done',
-          stopReason: chunk.stopReason ?? 'end',
-          usage: {
-            inputTokens: chunk.usage?.input ?? 0,
-            outputTokens: chunk.usage?.output ?? 0,
-            cacheCreationTokens: chunk.usage?.cacheCreation ?? 0,
-            cacheReadTokens: chunk.usage?.cacheRead ?? 0,
-          },
+    #client;
+    #model;
+    #provider;
+    constructor(client, model, provider) {
+        this.#client = client;
+        this.#model = model;
+        this.#provider = provider;
+    }
+    /**
+     * Non-streaming completion. Matches AdiaUI interface.
+     *
+     * 32k max_tokens: A2UI JSON for moderately complex UIs (kanban, dashboard,
+     * pricing table) routinely exceeds 8k. Truncation produced silent fallbacks
+     * that the validator rubber-stamped at ~89/100 — see diagnosis report
+     * 2026-04-19. Modern Claude/GPT/Gemini all support ≥32k output cleanly.
+     *
+     * @param opts
+     * @param opts.messages
+     * @param opts.systemPrompt
+     */
+    async complete({ messages, systemPrompt }) {
+        const response = await this.#client.chat({
+            model: this.#model,
+            messages,
+            ...(systemPrompt != null ? { system: systemPrompt } : {}),
+            maxTokens: 32768,
+            cache: this.#provider === 'anthropic',
+        });
+        return {
+            content: response.text,
+            // 'max_tokens' / 'length' / 'MAX_TOKENS' (Gemini) signal truncation;
+            // downstream parser uses this to refuse silent fallback rendering.
+            stopReason: response.stopReason ?? 'end',
+            usage: {
+                inputTokens: response.usage?.input ?? 0,
+                outputTokens: response.usage?.output ?? 0,
+                cacheCreationTokens: response.usage?.cacheCreation ?? 0,
+                cacheReadTokens: response.usage?.cacheRead ?? 0,
+            },
         };
-      }
-      // Other chunk types (thinking, error) are still available on the
-      // underlying adapter but the AdiaUI pipeline doesn't consume them yet.
     }
-  }
-
-  /** Expose the underlying client for advanced use. */
-  get adapter() { return this.#client; }
-
-  /** Expose provider name for detection. */
-  get provider() { return this.#provider; }
+    /**
+     * Streaming completion. Matches AdiaUI interface.
+     *
+     * @param opts
+     * @param opts.messages
+     * @param opts.systemPrompt
+     * @yields {{ type: 'text', content: string } | { type: 'done', stopReason: string, usage: { inputTokens: number, outputTokens: number, cacheCreationTokens: number, cacheReadTokens: number } }}
+     */
+    async *stream({ messages, systemPrompt }) {
+        for await (const chunk of this.#client.stream({
+            model: this.#model,
+            messages,
+            ...(systemPrompt != null ? { system: systemPrompt } : {}),
+            maxTokens: 32768,
+            cache: this.#provider === 'anthropic',
+        })) {
+            if (chunk.type === 'text') {
+                yield { type: 'text', content: chunk.text };
+            }
+            else if (chunk.type === 'done') {
+                // Surface the terminal stopReason + cache telemetry so the consumer
+                // can detect max_tokens truncation and the dialog recorder can log
+                // cache hit-rate per turn.
+                yield {
+                    type: 'done',
+                    stopReason: chunk.stopReason ?? 'end',
+                    usage: {
+                        inputTokens: chunk.usage?.input ?? 0,
+                        outputTokens: chunk.usage?.output ?? 0,
+                        cacheCreationTokens: chunk.usage?.cacheCreation ?? 0,
+                        cacheReadTokens: chunk.usage?.cacheRead ?? 0,
+                    },
+                };
+            }
+            // Other chunk types (thinking, error) are still available on the
+            // underlying adapter but the AdiaUI pipeline doesn't consume them yet.
+        }
+    }
+    /** Expose the underlying client for advanced use. */
+    get adapter() { return this.#client; }
+    /** Expose provider name for detection. */
+    get provider() { return this.#provider; }
 }
+//# sourceMappingURL=llm-bridge.js.map

package/llm-bridge.js.map

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