@open-mercato/ai-assistant 0.4.11-develop.2226.2963a4b52d → 0.4.11-develop.2231.cfcd603204

package/dist/modules/ai_assistant/lib/llm-adapters/openai.js

@@ -0,0 +1,65 @@
+import { createOpenAI } from "@ai-sdk/openai";
+function readFirstNonEmpty(env, keys) {
+  for (const key of keys) {
+    const value = env[key];
+    if (typeof value === "string") {
+      const trimmed = value.trim();
+      if (trimmed.length > 0) return trimmed;
+    }
+  }
+  return null;
+}
+function createOpenAICompatibleProvider(preset) {
+  if (!preset.id || preset.id.length === 0) {
+    throw new Error("[OpenAIAdapter] Preset must have a non-empty id");
+  }
+  if (!preset.envKeys || preset.envKeys.length === 0) {
+    throw new Error(
+      `[OpenAIAdapter] Preset "${preset.id}" must declare at least one env key`
+    );
+  }
+  function resolveApiKey(env) {
+    return readFirstNonEmpty(env ?? process.env, preset.envKeys);
+  }
+  function resolveBaseURL(env) {
+    const lookup = env ?? process.env;
+    if (preset.baseURLEnvKeys && preset.baseURLEnvKeys.length > 0) {
+      const override = readFirstNonEmpty(lookup, preset.baseURLEnvKeys);
+      if (override) return override;
+    }
+    return preset.baseURL;
+  }
+  return {
+    id: preset.id,
+    name: preset.name,
+    envKeys: preset.envKeys,
+    defaultModel: preset.defaultModel,
+    defaultModels: preset.defaultModels,
+    isConfigured(env) {
+      return resolveApiKey(env) !== null;
+    },
+    resolveApiKey,
+    getConfiguredEnvKey(env) {
+      const lookup = env ?? process.env;
+      for (const key of preset.envKeys) {
+        const value = lookup[key];
+        if (typeof value === "string" && value.trim().length > 0) {
+          return key;
+        }
+      }
+      return preset.envKeys[0];
+    },
+    createModel(options) {
+      const baseURL = options.baseURL ?? resolveBaseURL();
+      const openai = createOpenAI({
+        apiKey: options.apiKey,
+        ...baseURL ? { baseURL } : {}
+      });
+      return openai(options.modelId);
+    }
+  };
+}
+export {
+  createOpenAICompatibleProvider
+};
+//# sourceMappingURL=openai.js.map

package/dist/modules/ai_assistant/lib/llm-adapters/openai.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/ai_assistant/lib/llm-adapters/openai.ts"],
+  "sourcesContent": ["/**\n * OpenAIAdapter \u2014 implements the LlmProvider port for the OpenAI\n * chat-completions protocol.\n *\n * This single adapter serves OpenAI itself and every OpenAI-compatible\n * backend (DeepInfra, Groq, Together, Fireworks, Azure OpenAI, LiteLLM,\n * Ollama, LocalAI, vLLM, \u2026). Vendor-specific configuration \u2014 endpoint\n * URL, available models, env var conventions \u2014 lives in\n * `./openai-compatible-presets.ts` as plain data, not code.\n *\n * The factory {@link createOpenAICompatibleProvider} takes a preset and\n * returns a fully-configured `LlmProvider` that internally calls\n * `createOpenAI({ apiKey, baseURL })` from `@ai-sdk/openai`.\n *\n * @see packages/shared/src/lib/ai/llm-provider.ts\n * @see ./openai-compatible-presets.ts\n * @see .ai/specs/2026-04-14-llm-provider-ports-and-adapters.md\n */\n\nimport { createOpenAI } from '@ai-sdk/openai'\nimport type {\n  EnvLookup,\n  LlmCreateModelOptions,\n  LlmModelInfo,\n  LlmProvider,\n} from '@open-mercato/shared/lib/ai/llm-provider'\n\n/**\n * Configuration for a single OpenAI-compatible provider instance.\n *\n * Built-in presets live in {@link ./openai-compatible-presets.ts}.\n * Downstream applications may construct custom presets at bootstrap time\n * and register them with `llmProviderRegistry.register(\n *   createOpenAICompatibleProvider(customPreset),\n * )`.\n */\nexport interface OpenAICompatiblePreset {\n  /** Stable id (e.g. `openai`, `deepinfra`, `groq`, `together`). */\n  id: string\n  /** Human-readable display name. */\n  name: string\n  /**\n   * Upstream base URL. Leave `undefined` to use the AI SDK default\n   * (`https://api.openai.com/v1`). Required for DeepInfra, Groq, etc.\n   */\n  baseURL?: string\n  /**\n   * Env var names where the adapter looks for the API key, in priority\n   * order. Each preset declares its own keys so unrelated presets never\n   * accidentally share credentials (e.g. DeepInfra uses\n   * `DEEPINFRA_API_KEY`, not `OPENAI_API_KEY`).\n   */\n  envKeys: readonly string[]\n  /** Default model id used when the caller does not specify one. */\n  defaultModel: string\n  /** Curated model catalog shown in the UI dropdown. */\n  defaultModels: readonly LlmModelInfo[]\n  /**\n   * Optional env var names for overriding the base URL at runtime.\n   * Primarily used by presets that rely on a user-supplied URL\n   * (Azure deployment, self-hosted LiteLLM, Ollama on a custom port).\n   * The first non-empty value wins and overrides {@link baseURL}.\n   */\n  baseURLEnvKeys?: readonly string[]\n}\n\nfunction readFirstNonEmpty(\n  env: EnvLookup,\n  keys: readonly string[],\n): string | null {\n  for (const key of keys) {\n    const value = env[key]\n    if (typeof value === 'string') {\n      const trimmed = value.trim()\n      if (trimmed.length > 0) return trimmed\n    }\n  }\n  return null\n}\n\n/**\n * Builds a `LlmProvider` instance bound to a specific OpenAI-compatible\n * preset. The returned object is stateless and can be registered directly\n * with `llmProviderRegistry.register(...)`.\n */\nexport function createOpenAICompatibleProvider(\n  preset: OpenAICompatiblePreset,\n): LlmProvider {\n  if (!preset.id || preset.id.length === 0) {\n    throw new Error('[OpenAIAdapter] Preset must have a non-empty id')\n  }\n  if (!preset.envKeys || preset.envKeys.length === 0) {\n    throw new Error(\n      `[OpenAIAdapter] Preset \"${preset.id}\" must declare at least one env key`,\n    )\n  }\n\n  function resolveApiKey(env?: EnvLookup): string | null {\n    return readFirstNonEmpty(env ?? process.env, preset.envKeys)\n  }\n\n  function resolveBaseURL(env?: EnvLookup): string | undefined {\n    const lookup = env ?? process.env\n    if (preset.baseURLEnvKeys && preset.baseURLEnvKeys.length > 0) {\n      const override = readFirstNonEmpty(lookup, preset.baseURLEnvKeys)\n      if (override) return override\n    }\n    return preset.baseURL\n  }\n\n  return {\n    id: preset.id,\n    name: preset.name,\n    envKeys: preset.envKeys,\n    defaultModel: preset.defaultModel,\n    defaultModels: preset.defaultModels,\n\n    isConfigured(env?: EnvLookup): boolean {\n      return resolveApiKey(env) !== null\n    },\n\n    resolveApiKey,\n\n    getConfiguredEnvKey(env?: EnvLookup): string {\n      const lookup = env ?? process.env\n      for (const key of preset.envKeys) {\n        const value = lookup[key]\n        if (typeof value === 'string' && value.trim().length > 0) {\n          return key\n        }\n      }\n      return preset.envKeys[0]\n    },\n\n    createModel(options: LlmCreateModelOptions): unknown {\n      // Per-request baseURL override wins over preset/env defaults.\n      const baseURL = options.baseURL ?? resolveBaseURL()\n      const openai = createOpenAI({\n        apiKey: options.apiKey,\n        ...(baseURL ? { baseURL } : {}),\n      })\n      return openai(options.modelId)\n    },\n  }\n}\n"],
+  "mappings": "AAmBA,SAAS,oBAAoB;AA+C7B,SAAS,kBACP,KACA,MACe;AACf,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,IAAI,GAAG;AACrB,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAM,UAAU,MAAM,KAAK;AAC3B,UAAI,QAAQ,SAAS,EAAG,QAAO;AAAA,IACjC;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,+BACd,QACa;AACb,MAAI,CAAC,OAAO,MAAM,OAAO,GAAG,WAAW,GAAG;AACxC,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AACA,MAAI,CAAC,OAAO,WAAW,OAAO,QAAQ,WAAW,GAAG;AAClD,UAAM,IAAI;AAAA,MACR,2BAA2B,OAAO,EAAE;AAAA,IACtC;AAAA,EACF;AAEA,WAAS,cAAc,KAAgC;AACrD,WAAO,kBAAkB,OAAO,QAAQ,KAAK,OAAO,OAAO;AAAA,EAC7D;AAEA,WAAS,eAAe,KAAqC;AAC3D,UAAM,SAAS,OAAO,QAAQ;AAC9B,QAAI,OAAO,kBAAkB,OAAO,eAAe,SAAS,GAAG;AAC7D,YAAM,WAAW,kBAAkB,QAAQ,OAAO,cAAc;AAChE,UAAI,SAAU,QAAO;AAAA,IACvB;AACA,WAAO,OAAO;AAAA,EAChB;AAEA,SAAO;AAAA,IACL,IAAI,OAAO;AAAA,IACX,MAAM,OAAO;AAAA,IACb,SAAS,OAAO;AAAA,IAChB,cAAc,OAAO;AAAA,IACrB,eAAe,OAAO;AAAA,IAEtB,aAAa,KAA0B;AACrC,aAAO,cAAc,GAAG,MAAM;AAAA,IAChC;AAAA,IAEA;AAAA,IAEA,oBAAoB,KAAyB;AAC3C,YAAM,SAAS,OAAO,QAAQ;AAC9B,iBAAW,OAAO,OAAO,SAAS;AAChC,cAAM,QAAQ,OAAO,GAAG;AACxB,YAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS,GAAG;AACxD,iBAAO;AAAA,QACT;AAAA,MACF;AACA,aAAO,OAAO,QAAQ,CAAC;AAAA,IACzB;AAAA,IAEA,YAAY,SAAyC;AAEnD,YAAM,UAAU,QAAQ,WAAW,eAAe;AAClD,YAAM,SAAS,aAAa;AAAA,QAC1B,QAAQ,QAAQ;AAAA,QAChB,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC/B,CAAC;AACD,aAAO,OAAO,QAAQ,OAAO;AAAA,IAC/B;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/ai_assistant/lib/llm-bootstrap.js

@@ -0,0 +1,47 @@
+import { llmProviderRegistry } from "@open-mercato/shared/lib/ai/llm-provider-registry";
+import { createAnthropicAdapter } from "./llm-adapters/anthropic.js";
+import { createGoogleAdapter } from "./llm-adapters/google.js";
+import { createOpenAICompatibleProvider } from "./llm-adapters/openai.js";
+import { OPENAI_COMPATIBLE_PRESETS } from "./openai-compatible-presets.js";
+let bootstrapped = false;
+function registerBuiltInLlmProviders() {
+  if (bootstrapped && llmProviderRegistry.list().length > 0) {
+    return;
+  }
+  try {
+    llmProviderRegistry.register(createAnthropicAdapter());
+  } catch (error) {
+    console.warn(
+      "[LlmBootstrap] Failed to register Anthropic adapter:",
+      error instanceof Error ? error.message : error
+    );
+  }
+  try {
+    llmProviderRegistry.register(createGoogleAdapter());
+  } catch (error) {
+    console.warn(
+      "[LlmBootstrap] Failed to register Google adapter:",
+      error instanceof Error ? error.message : error
+    );
+  }
+  for (const preset of OPENAI_COMPATIBLE_PRESETS) {
+    try {
+      llmProviderRegistry.register(createOpenAICompatibleProvider(preset));
+    } catch (error) {
+      console.warn(
+        `[LlmBootstrap] Failed to register OpenAI-compatible preset "${preset.id}":`,
+        error instanceof Error ? error.message : error
+      );
+    }
+  }
+  bootstrapped = true;
+}
+function resetLlmBootstrapState() {
+  bootstrapped = false;
+}
+registerBuiltInLlmProviders();
+export {
+  registerBuiltInLlmProviders,
+  resetLlmBootstrapState
+};
+//# sourceMappingURL=llm-bootstrap.js.map

package/dist/modules/ai_assistant/lib/llm-bootstrap.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/lib/llm-bootstrap.ts"],
+  "sourcesContent": ["/**\n * LLM provider bootstrap \u2014 registers built-in adapters and OpenAI-compatible\n * presets with the shared `llmProviderRegistry` singleton.\n *\n * This runs at module load via the side-effect import in `./ai-sdk.ts`.\n * Safe to call multiple times \u2014 each registration is idempotent (replaces\n * existing by id), so Next.js hot-reload does not duplicate providers.\n *\n * Adapter registration is wrapped in individual try/catch blocks. A\n * failing import (e.g. missing peer dependency) skips that adapter with a\n * `console.warn` but leaves the rest of the registry working.\n *\n * @see packages/shared/src/lib/ai/llm-provider-registry.ts\n * @see .ai/specs/2026-04-14-llm-provider-ports-and-adapters.md\n */\n\nimport { llmProviderRegistry } from '@open-mercato/shared/lib/ai/llm-provider-registry'\nimport { createAnthropicAdapter } from './llm-adapters/anthropic'\nimport { createGoogleAdapter } from './llm-adapters/google'\nimport { createOpenAICompatibleProvider } from './llm-adapters/openai'\nimport { OPENAI_COMPATIBLE_PRESETS } from './openai-compatible-presets'\n\nlet bootstrapped = false\n\n/**\n * Registers all built-in LLM providers with the shared singleton.\n * Idempotent \u2014 the second and subsequent calls are no-ops (unless the\n * registry was reset by a test, in which case registration runs again).\n */\nexport function registerBuiltInLlmProviders(): void {\n  if (bootstrapped && llmProviderRegistry.list().length > 0) {\n    return\n  }\n\n  // Native protocol adapters.\n  try {\n    llmProviderRegistry.register(createAnthropicAdapter())\n  } catch (error) {\n    console.warn(\n      '[LlmBootstrap] Failed to register Anthropic adapter:',\n      error instanceof Error ? error.message : error,\n    )\n  }\n\n  try {\n    llmProviderRegistry.register(createGoogleAdapter())\n  } catch (error) {\n    console.warn(\n      '[LlmBootstrap] Failed to register Google adapter:',\n      error instanceof Error ? error.message : error,\n    )\n  }\n\n  // OpenAI-compatible presets \u2014 all share one protocol adapter under the\n  // hood but appear as separate providers in the registry.\n  for (const preset of OPENAI_COMPATIBLE_PRESETS) {\n    try {\n      llmProviderRegistry.register(createOpenAICompatibleProvider(preset))\n    } catch (error) {\n      console.warn(\n        `[LlmBootstrap] Failed to register OpenAI-compatible preset \"${preset.id}\":`,\n        error instanceof Error ? error.message : error,\n      )\n    }\n  }\n\n  bootstrapped = true\n}\n\n/**\n * Resets the bootstrap state. Intended for tests that call\n * `llmProviderRegistry.reset()` and then want a fresh bootstrap run.\n */\nexport function resetLlmBootstrapState(): void {\n  bootstrapped = false\n}\n\n// Auto-bootstrap on module load so any consumer importing from\n// `@open-mercato/ai-assistant/lib/llm-bootstrap` triggers registration.\nregisterBuiltInLlmProviders()\n"],
+  "mappings": "AAgBA,SAAS,2BAA2B;AACpC,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,sCAAsC;AAC/C,SAAS,iCAAiC;AAE1C,IAAI,eAAe;AAOZ,SAAS,8BAAoC;AAClD,MAAI,gBAAgB,oBAAoB,KAAK,EAAE,SAAS,GAAG;AACzD;AAAA,EACF;AAGA,MAAI;AACF,wBAAoB,SAAS,uBAAuB,CAAC;AAAA,EACvD,SAAS,OAAO;AACd,YAAQ;AAAA,MACN;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AAEA,MAAI;AACF,wBAAoB,SAAS,oBAAoB,CAAC;AAAA,EACpD,SAAS,OAAO;AACd,YAAQ;AAAA,MACN;AAAA,MACA,iBAAiB,QAAQ,MAAM,UAAU;AAAA,IAC3C;AAAA,EACF;AAIA,aAAW,UAAU,2BAA2B;AAC9C,QAAI;AACF,0BAAoB,SAAS,+BAA+B,MAAM,CAAC;AAAA,IACrE,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,+DAA+D,OAAO,EAAE;AAAA,QACxE,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAEA,iBAAe;AACjB;AAMO,SAAS,yBAA+B;AAC7C,iBAAe;AACjB;AAIA,4BAA4B;",
+  "names": []
+}

package/dist/modules/ai_assistant/lib/openai-compatible-presets.js

@@ -0,0 +1,203 @@
+const OPENAI_PRESET = {
+  id: "openai",
+  name: "OpenAI",
+  baseURL: void 0,
+  envKeys: ["OPENAI_API_KEY", "OPENCODE_OPENAI_API_KEY"],
+  defaultModel: "gpt-5-mini",
+  defaultModels: [
+    {
+      id: "gpt-5-mini",
+      name: "GPT-5 Mini",
+      contextWindow: 128e3,
+      tags: ["budget"]
+    },
+    {
+      id: "gpt-5",
+      name: "GPT-5",
+      contextWindow: 128e3,
+      tags: ["flagship"]
+    },
+    {
+      id: "gpt-4o-mini",
+      name: "GPT-4o Mini",
+      contextWindow: 128e3,
+      tags: ["budget"]
+    },
+    {
+      id: "gpt-4o",
+      name: "GPT-4o",
+      contextWindow: 128e3
+    }
+  ]
+};
+const DEEPINFRA_PRESET = {
+  id: "deepinfra",
+  name: "DeepInfra",
+  baseURL: "https://api.deepinfra.com/v1/openai",
+  envKeys: ["DEEPINFRA_API_KEY"],
+  defaultModel: "zai-org/GLM-5.1",
+  defaultModels: [
+    {
+      id: "zai-org/GLM-5.1",
+      name: "GLM-5.1 (Zhipu)",
+      contextWindow: 202752,
+      tags: ["flagship"]
+    },
+    {
+      id: "zai-org/GLM-4.7-Flash",
+      name: "GLM-4.7 Flash",
+      contextWindow: 202752,
+      tags: ["budget"]
+    },
+    {
+      id: "Qwen/Qwen3-235B-A22B-Instruct-2507",
+      name: "Qwen3 235B (MoE)",
+      contextWindow: 262144,
+      tags: ["flagship"]
+    },
+    {
+      id: "meta-llama/Llama-4-Scout-17B-16E-Instruct",
+      name: "Llama 4 Scout",
+      contextWindow: 327680
+    },
+    {
+      id: "deepseek-ai/DeepSeek-V3.2-Exp",
+      name: "DeepSeek V3.2",
+      contextWindow: 163840,
+      tags: ["reasoning"]
+    },
+    {
+      id: "Qwen/Qwen3-Coder-30B-A3B-Instruct",
+      name: "Qwen3 Coder 30B",
+      contextWindow: 262144,
+      tags: ["coding"]
+    }
+  ]
+};
+const GROQ_PRESET = {
+  id: "groq",
+  name: "Groq",
+  baseURL: "https://api.groq.com/openai/v1",
+  envKeys: ["GROQ_API_KEY"],
+  defaultModel: "llama-3.3-70b-versatile",
+  defaultModels: [
+    {
+      id: "llama-3.3-70b-versatile",
+      name: "Llama 3.3 70B Versatile",
+      contextWindow: 131072
+    },
+    {
+      id: "llama-4-scout-17b",
+      name: "Llama 4 Scout 17B",
+      contextWindow: 131072
+    },
+    {
+      id: "mixtral-8x22b-32768",
+      name: "Mixtral 8x22B",
+      contextWindow: 32768
+    }
+  ]
+};
+const TOGETHER_PRESET = {
+  id: "together",
+  name: "Together AI",
+  baseURL: "https://api.together.xyz/v1",
+  envKeys: ["TOGETHER_API_KEY"],
+  defaultModel: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+  defaultModels: [
+    {
+      id: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+      name: "Llama 3.3 70B Turbo",
+      contextWindow: 131072
+    },
+    {
+      id: "Qwen/Qwen2.5-72B-Instruct-Turbo",
+      name: "Qwen 2.5 72B Turbo",
+      contextWindow: 32768
+    }
+  ]
+};
+const FIREWORKS_PRESET = {
+  id: "fireworks",
+  name: "Fireworks AI",
+  baseURL: "https://api.fireworks.ai/inference/v1",
+  envKeys: ["FIREWORKS_API_KEY"],
+  defaultModel: "accounts/fireworks/models/llama-v3p3-70b-instruct",
+  defaultModels: [
+    {
+      id: "accounts/fireworks/models/llama-v3p3-70b-instruct",
+      name: "Llama 3.3 70B",
+      contextWindow: 131072
+    }
+  ]
+};
+const AZURE_PRESET = {
+  id: "azure",
+  name: "Azure OpenAI",
+  baseURL: void 0,
+  baseURLEnvKeys: ["AZURE_OPENAI_BASE_URL"],
+  envKeys: ["AZURE_OPENAI_API_KEY"],
+  defaultModel: "gpt-5-mini",
+  defaultModels: [
+    {
+      id: "gpt-5-mini",
+      name: "GPT-5 Mini",
+      contextWindow: 128e3
+    },
+    {
+      id: "gpt-5",
+      name: "GPT-5",
+      contextWindow: 128e3
+    }
+  ]
+};
+const LITELLM_PRESET = {
+  id: "litellm",
+  name: "LiteLLM",
+  baseURL: "http://localhost:4000/v1",
+  baseURLEnvKeys: ["LITELLM_BASE_URL"],
+  envKeys: ["LITELLM_API_KEY"],
+  defaultModel: "gpt-4o-mini",
+  defaultModels: [
+    {
+      id: "gpt-4o-mini",
+      name: "GPT-4o Mini (via LiteLLM)",
+      contextWindow: 128e3
+    }
+  ]
+};
+const OLLAMA_PRESET = {
+  id: "ollama",
+  name: "Ollama (local)",
+  baseURL: "http://localhost:11434/v1",
+  baseURLEnvKeys: ["OLLAMA_BASE_URL"],
+  envKeys: ["OLLAMA_API_KEY"],
+  defaultModel: "llama3.3",
+  defaultModels: [
+    {
+      id: "llama3.3",
+      name: "Llama 3.3 (local)",
+      contextWindow: 131072
+    },
+    {
+      id: "qwen2.5-coder",
+      name: "Qwen 2.5 Coder (local)",
+      contextWindow: 131072,
+      tags: ["coding"]
+    }
+  ]
+};
+const OPENAI_COMPATIBLE_PRESETS = [
+  OPENAI_PRESET,
+  DEEPINFRA_PRESET,
+  GROQ_PRESET,
+  TOGETHER_PRESET,
+  FIREWORKS_PRESET,
+  AZURE_PRESET,
+  LITELLM_PRESET,
+  OLLAMA_PRESET
+];
+export {
+  OPENAI_COMPATIBLE_PRESETS
+};
+//# sourceMappingURL=openai-compatible-presets.js.map

package/dist/modules/ai_assistant/lib/openai-compatible-presets.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/ai_assistant/lib/openai-compatible-presets.ts"],
+  "sourcesContent": ["/**\n * Curated registry of OpenAI-compatible LLM backends.\n *\n * Each preset is plain data \u2014 adding a new backend takes one entry in\n * this array, zero new adapter files, and zero changes to route handlers.\n * The {@link createOpenAICompatibleProvider} factory in `./llm-adapters/openai.ts`\n * turns each preset into a concrete `LlmProvider` at bootstrap time.\n *\n * Preset model catalogs are curated snapshots as of 2026-04-14 and should\n * be updated as upstream catalogs evolve. Users can always override the\n * selected model via the `OPENCODE_MODEL` env var without editing this\n * file.\n *\n * @see ./llm-adapters/openai.ts\n * @see .ai/specs/2026-04-14-llm-provider-ports-and-adapters.md\n */\n\nimport type { OpenAICompatiblePreset } from './llm-adapters/openai'\n\n/**\n * Standard OpenAI \u2014 default OpenAI API at api.openai.com.\n */\nconst OPENAI_PRESET: OpenAICompatiblePreset = {\n  id: 'openai',\n  name: 'OpenAI',\n  baseURL: undefined,\n  envKeys: ['OPENAI_API_KEY', 'OPENCODE_OPENAI_API_KEY'],\n  defaultModel: 'gpt-5-mini',\n  defaultModels: [\n    {\n      id: 'gpt-5-mini',\n      name: 'GPT-5 Mini',\n      contextWindow: 128000,\n      tags: ['budget'],\n    },\n    {\n      id: 'gpt-5',\n      name: 'GPT-5',\n      contextWindow: 128000,\n      tags: ['flagship'],\n    },\n    {\n      id: 'gpt-4o-mini',\n      name: 'GPT-4o Mini',\n      contextWindow: 128000,\n      tags: ['budget'],\n    },\n    {\n      id: 'gpt-4o',\n      name: 'GPT-4o',\n      contextWindow: 128000,\n    },\n  ],\n}\n\n/**\n * DeepInfra \u2014 hosts open-weight flagship models at 3-12\u00D7 lower cost than\n * the native APIs. The curated catalog targets the AI Assistant use case\n * (routing + tool use + conversational chat).\n */\nconst DEEPINFRA_PRESET: OpenAICompatiblePreset = {\n  id: 'deepinfra',\n  name: 'DeepInfra',\n  baseURL: 'https://api.deepinfra.com/v1/openai',\n  envKeys: ['DEEPINFRA_API_KEY'],\n  defaultModel: 'zai-org/GLM-5.1',\n  defaultModels: [\n    {\n      id: 'zai-org/GLM-5.1',\n      name: 'GLM-5.1 (Zhipu)',\n      contextWindow: 202752,\n      tags: ['flagship'],\n    },\n    {\n      id: 'zai-org/GLM-4.7-Flash',\n      name: 'GLM-4.7 Flash',\n      contextWindow: 202752,\n      tags: ['budget'],\n    },\n    {\n      id: 'Qwen/Qwen3-235B-A22B-Instruct-2507',\n      name: 'Qwen3 235B (MoE)',\n      contextWindow: 262144,\n      tags: ['flagship'],\n    },\n    {\n      id: 'meta-llama/Llama-4-Scout-17B-16E-Instruct',\n      name: 'Llama 4 Scout',\n      contextWindow: 327680,\n    },\n    {\n      id: 'deepseek-ai/DeepSeek-V3.2-Exp',\n      name: 'DeepSeek V3.2',\n      contextWindow: 163840,\n      tags: ['reasoning'],\n    },\n    {\n      id: 'Qwen/Qwen3-Coder-30B-A3B-Instruct',\n      name: 'Qwen3 Coder 30B',\n      contextWindow: 262144,\n      tags: ['coding'],\n    },\n  ],\n}\n\n/**\n * Groq \u2014 specializes in low-latency inference on LPU hardware.\n * Best suited for snappy tool-use and routing, less so for long reasoning.\n */\nconst GROQ_PRESET: OpenAICompatiblePreset = {\n  id: 'groq',\n  name: 'Groq',\n  baseURL: 'https://api.groq.com/openai/v1',\n  envKeys: ['GROQ_API_KEY'],\n  defaultModel: 'llama-3.3-70b-versatile',\n  defaultModels: [\n    {\n      id: 'llama-3.3-70b-versatile',\n      name: 'Llama 3.3 70B Versatile',\n      contextWindow: 131072,\n    },\n    {\n      id: 'llama-4-scout-17b',\n      name: 'Llama 4 Scout 17B',\n      contextWindow: 131072,\n    },\n    {\n      id: 'mixtral-8x22b-32768',\n      name: 'Mixtral 8x22B',\n      contextWindow: 32768,\n    },\n  ],\n}\n\n/**\n * Together AI \u2014 broad catalog of open-weight models with per-model pricing.\n */\nconst TOGETHER_PRESET: OpenAICompatiblePreset = {\n  id: 'together',\n  name: 'Together AI',\n  baseURL: 'https://api.together.xyz/v1',\n  envKeys: ['TOGETHER_API_KEY'],\n  defaultModel: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',\n  defaultModels: [\n    {\n      id: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',\n      name: 'Llama 3.3 70B Turbo',\n      contextWindow: 131072,\n    },\n    {\n      id: 'Qwen/Qwen2.5-72B-Instruct-Turbo',\n      name: 'Qwen 2.5 72B Turbo',\n      contextWindow: 32768,\n    },\n  ],\n}\n\n/**\n * Fireworks AI \u2014 fast inference with a curated catalog.\n */\nconst FIREWORKS_PRESET: OpenAICompatiblePreset = {\n  id: 'fireworks',\n  name: 'Fireworks AI',\n  baseURL: 'https://api.fireworks.ai/inference/v1',\n  envKeys: ['FIREWORKS_API_KEY'],\n  defaultModel: 'accounts/fireworks/models/llama-v3p3-70b-instruct',\n  defaultModels: [\n    {\n      id: 'accounts/fireworks/models/llama-v3p3-70b-instruct',\n      name: 'Llama 3.3 70B',\n      contextWindow: 131072,\n    },\n  ],\n}\n\n/**\n * Azure OpenAI \u2014 enterprise Azure deployments. Base URL is deployment-\n * specific and must be provided via `AZURE_OPENAI_BASE_URL`.\n */\nconst AZURE_PRESET: OpenAICompatiblePreset = {\n  id: 'azure',\n  name: 'Azure OpenAI',\n  baseURL: undefined,\n  baseURLEnvKeys: ['AZURE_OPENAI_BASE_URL'],\n  envKeys: ['AZURE_OPENAI_API_KEY'],\n  defaultModel: 'gpt-5-mini',\n  defaultModels: [\n    {\n      id: 'gpt-5-mini',\n      name: 'GPT-5 Mini',\n      contextWindow: 128000,\n    },\n    {\n      id: 'gpt-5',\n      name: 'GPT-5',\n      contextWindow: 128000,\n    },\n  ],\n}\n\n/**\n * LiteLLM proxy \u2014 self-hosted router for arbitrary upstream providers.\n * Base URL must be supplied via `LITELLM_BASE_URL`.\n */\nconst LITELLM_PRESET: OpenAICompatiblePreset = {\n  id: 'litellm',\n  name: 'LiteLLM',\n  baseURL: 'http://localhost:4000/v1',\n  baseURLEnvKeys: ['LITELLM_BASE_URL'],\n  envKeys: ['LITELLM_API_KEY'],\n  defaultModel: 'gpt-4o-mini',\n  defaultModels: [\n    {\n      id: 'gpt-4o-mini',\n      name: 'GPT-4o Mini (via LiteLLM)',\n      contextWindow: 128000,\n    },\n  ],\n}\n\n/**\n * Ollama \u2014 local model runner for development and offline use.\n * Default port 11434 can be overridden via `OLLAMA_BASE_URL`.\n */\nconst OLLAMA_PRESET: OpenAICompatiblePreset = {\n  id: 'ollama',\n  name: 'Ollama (local)',\n  baseURL: 'http://localhost:11434/v1',\n  baseURLEnvKeys: ['OLLAMA_BASE_URL'],\n  envKeys: ['OLLAMA_API_KEY'],\n  defaultModel: 'llama3.3',\n  defaultModels: [\n    {\n      id: 'llama3.3',\n      name: 'Llama 3.3 (local)',\n      contextWindow: 131072,\n    },\n    {\n      id: 'qwen2.5-coder',\n      name: 'Qwen 2.5 Coder (local)',\n      contextWindow: 131072,\n      tags: ['coding'],\n    },\n  ],\n}\n\n/**\n * Built-in presets registered at bootstrap time. Order matters \u2014 it\n * determines the default iteration order of\n * `llmProviderRegistry.resolveFirstConfigured()` when no explicit order\n * is supplied.\n */\nexport const OPENAI_COMPATIBLE_PRESETS: readonly OpenAICompatiblePreset[] = [\n  OPENAI_PRESET,\n  DEEPINFRA_PRESET,\n  GROQ_PRESET,\n  TOGETHER_PRESET,\n  FIREWORKS_PRESET,\n  AZURE_PRESET,\n  LITELLM_PRESET,\n  OLLAMA_PRESET,\n]\n"],
+  "mappings": "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",
+  "names": []
+}

package/jest.config.cjs

@@ -7,6 +7,7 @@ module.exports = {
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
   moduleNameMapper: {
     '^@open-mercato/ai-assistant/(.*)$': '<rootDir>/src/$1',
+    '^@open-mercato/shared/(.*)$': '<rootDir>/../shared/src/$1',
   },
   transform: {
     '^.+\\.tsx?$': [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/ai-assistant",
-  "version": "0.4.11-develop.2226.2963a4b52d",
+  "version": "0.4.11-develop.2231.cfcd603204",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -98,12 +98,12 @@
     "zod-to-json-schema": "^3.25.1"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.4.11-develop.2226.2963a4b52d",
-    "@open-mercato/ui": "0.4.11-develop.2226.2963a4b52d",
+    "@open-mercato/shared": "0.4.11-develop.2231.cfcd603204",
+    "@open-mercato/ui": "0.4.11-develop.2231.cfcd603204",
     "zod": ">=3.23.0"
   },
   "devDependencies": {
-    "@open-mercato/cli": "0.4.11-develop.2226.2963a4b52d",
+    "@open-mercato/cli": "0.4.11-develop.2231.cfcd603204",
     "tsx": "^4.21.0"
   },
   "publishConfig": {

package/src/modules/ai_assistant/api/route/route.ts

@@ -1,19 +1,11 @@
 import { NextResponse, type NextRequest } from 'next/server'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { generateObject } from '../../lib/ai-sdk'
-import {
-  createOpenAI,
-  createAnthropic,
-  createGoogleGenerativeAI,
-} from '../../lib/ai-sdk'
 import { z } from 'zod'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
-import {
-  resolveFirstConfiguredOpenCodeProvider,
-  resolveOpenCodeModel,
-  resolveOpenCodeProviderApiKey,
-} from '@open-mercato/shared/lib/ai/opencode-provider'
+import { llmProviderRegistry } from '@open-mercato/shared/lib/ai/llm-provider-registry'
+import { resolveOpenCodeModel } from '@open-mercato/shared/lib/ai/opencode-provider'
 import {
   resolveChatConfig,
   isProviderConfigured,
@@ -40,39 +32,43 @@ const RouteResultSchema = z.object({
 })
 
 function createRoutingModel(providerId: ChatProviderId, configuredModel?: string) {
-  const { modelId, modelWithProvider } = resolveOpenCodeModel(providerId, {
-    overrideModel: configuredModel,
-  })
-  const apiKey = resolveOpenCodeProviderApiKey(providerId)
-  if (!apiKey) {
-    throw new Error(`${providerId.toUpperCase()} API key not configured`)
+  const provider = llmProviderRegistry.get(providerId)
+  if (!provider) {
+    throw new Error(`Unknown provider: ${providerId}`)
   }
 
-  switch (providerId) {
-    case 'openai': {
-      const openai = createOpenAI({ apiKey })
-      return {
-        model: openai(modelId) as unknown as Parameters<typeof generateObject>[0]['model'],
-        modelWithProvider,
-      }
-    }
-    case 'anthropic': {
-      const anthropic = createAnthropic({ apiKey })
-      return {
-        model: anthropic(modelId) as unknown as Parameters<typeof generateObject>[0]['model'],
-        modelWithProvider,
-      }
-    }
-    case 'google': {
-      const google = createGoogleGenerativeAI({ apiKey })
-      return {
-        model: google(modelId) as unknown as Parameters<typeof generateObject>[0]['model'],
-        modelWithProvider,
-      }
-    }
-    default:
-      throw new Error(`Unknown provider: ${providerId}`)
+  // resolveOpenCodeModel is still used for token parsing and provider-prefix
+  // validation (`openai/gpt-5-mini` vs `anthropic/claude-…`). It falls back
+  // to the provider's defaultModel via the opencode-provider facade, which
+  // is only populated for the three native providers — if the registry
+  // returns a preset-based provider whose id is unknown to opencode-provider,
+  // we short-circuit and use the provider's own defaultModel.
+  let modelId: string
+  let modelWithProvider: string
+  try {
+    const resolved = resolveOpenCodeModel(providerId as 'anthropic' | 'openai' | 'google', {
+      overrideModel: configuredModel,
+    })
+    modelId = resolved.modelId
+    modelWithProvider = resolved.modelWithProvider
+  } catch {
+    // Preset-based provider or unknown id — fall back to the provider's own
+    // model list. The explicit override (if any) wins.
+    const requested = (configuredModel ?? '').trim()
+    modelId = requested.length > 0 ? requested : provider.defaultModel
+    modelWithProvider = `${providerId}/${modelId}`
   }
+
+  const apiKey = provider.resolveApiKey()
+  if (!apiKey) {
+    const envKey = provider.getConfiguredEnvKey()
+    throw new Error(`${envKey} not configured for provider "${providerId}"`)
+  }
+
+  const model = provider.createModel({ modelId, apiKey }) as unknown as Parameters<
+    typeof generateObject
+  >[0]['model']
+  return { model, modelWithProvider }
 }
 
 export async function POST(req: NextRequest) {
@@ -104,16 +100,23 @@ export async function POST(req: NextRequest) {
     const container = await createRequestContainer()
     let config = await resolveChatConfig(container)
 
-    // Fallback to first configured provider
+    // Fallback to first configured provider from the LLM provider registry.
+    // Default walk order prioritizes the native adapters (backward compatible)
+    // before OpenAI-compatible presets.
     if (!config) {
-      const configuredProvider = resolveFirstConfiguredOpenCodeProvider()
-      if (!configuredProvider) {
+      const picked = llmProviderRegistry.resolveFirstConfigured({
+        order: ['anthropic', 'openai', 'google'],
+      })
+      if (!picked) {
         return NextResponse.json(
-          { error: 'No AI provider configured. Please set an API key for OpenAI, Anthropic, or Google.' },
-          { status: 503 }
+          {
+            error:
+              'No AI provider configured. Please set an API key for one of the registered providers (Anthropic, OpenAI, Google, DeepInfra, Groq, …).',
+          },
+          { status: 503 },
         )
       }
-      config = { providerId: configuredProvider, model: '', updatedAt: '' }
+      config = { providerId: picked.id, model: '', updatedAt: '' }
     }
 
     console.log('[AI Route] Using provider:', config.providerId)

package/src/modules/ai_assistant/lib/__tests__/llm-adapters-anthropic.test.ts

@@ -0,0 +1,72 @@
+import { createAnthropicAdapter } from '../llm-adapters/anthropic'
+
+describe('AnthropicAdapter', () => {
+  const adapter = createAnthropicAdapter()
+
+  it('has expected id, name, envKeys and defaultModel', () => {
+    expect(adapter.id).toBe('anthropic')
+    expect(adapter.name).toBe('Anthropic')
+    expect(adapter.envKeys).toEqual(['ANTHROPIC_API_KEY', 'OPENCODE_ANTHROPIC_API_KEY'])
+    expect(adapter.defaultModel).toBe('claude-haiku-4-5-20251001')
+    expect(adapter.defaultModels.length).toBeGreaterThan(0)
+    expect(adapter.defaultModels[0].id).toBe('claude-haiku-4-5-20251001')
+  })
+
+  it('detects configuration from env', () => {
+    expect(
+      adapter.isConfigured({ ANTHROPIC_API_KEY: 'sk-ant-key' }),
+    ).toBe(true)
+    expect(adapter.isConfigured({ ANTHROPIC_API_KEY: '' })).toBe(false)
+    expect(adapter.isConfigured({ ANTHROPIC_API_KEY: '   ' })).toBe(false)
+    expect(adapter.isConfigured({})).toBe(false)
+  })
+
+  it('detects configuration from OPENCODE_* fallback env', () => {
+    expect(
+      adapter.isConfigured({ OPENCODE_ANTHROPIC_API_KEY: 'sk-ant-key' }),
+    ).toBe(true)
+    expect(
+      adapter.isConfigured({ OPENCODE_ANTHROPIC_API_KEY: '' }),
+    ).toBe(false)
+  })
+
+  it('resolves API key from env', () => {
+    expect(
+      adapter.resolveApiKey({ ANTHROPIC_API_KEY: 'sk-ant-key' }),
+    ).toBe('sk-ant-key')
+    expect(
+      adapter.resolveApiKey({ ANTHROPIC_API_KEY: '  sk-ant-key  ' }),
+    ).toBe('sk-ant-key')
+    expect(adapter.resolveApiKey({ ANTHROPIC_API_KEY: '' })).toBeNull()
+    expect(adapter.resolveApiKey({})).toBeNull()
+  })
+
+  it('resolves API key from OPENCODE_* fallback env', () => {
+    expect(
+      adapter.resolveApiKey({ OPENCODE_ANTHROPIC_API_KEY: 'opencode-key' }),
+    ).toBe('opencode-key')
+    expect(
+      adapter.resolveApiKey({
+        ANTHROPIC_API_KEY: 'primary',
+        OPENCODE_ANTHROPIC_API_KEY: 'fallback',
+      }),
+    ).toBe('primary')
+  })
+
+  it('returns the configured env key name for diagnostics', () => {
+    expect(
+      adapter.getConfiguredEnvKey({ ANTHROPIC_API_KEY: 'sk-ant' }),
+    ).toBe('ANTHROPIC_API_KEY')
+    // Falls back to first declared key when none configured.
+    expect(adapter.getConfiguredEnvKey({})).toBe('ANTHROPIC_API_KEY')
+  })
+
+  it('createModel returns a non-null AI SDK model instance', () => {
+    const model = adapter.createModel({
+      apiKey: 'sk-ant-test',
+      modelId: 'claude-haiku-4-5-20251001',
+    })
+    expect(model).toBeDefined()
+    expect(model).not.toBeNull()
+  })
+})