@7n/llm-lib 2.14.12 → 2.14.14

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [2.14.14] - 2026-08-03
+
+### Changed
+
+- feat(llm-lib): add turbofieldfare local provider (#374); chore(release): синк пінів платформних napi-пакетів @7n/llm-lib
+
+## [2.14.13] - 2026-08-03
+
+### Changed
+
+- chore(release): синк пінів платформних napi-пакетів @7n/llm-lib
+
 ## [2.14.12] - 2026-08-01
 
 ### Changed

package/lib/local-providers.mjs

@@ -1,35 +1,39 @@
 /**
  * Дефолтна мапа local-провайдерів для Rust-крейта `llm_lib::local_cloud`
  * (той самий `{ prefix: { baseUrl, apiKey } }` конфіг, що приймає
- * `oneShotLocalCloud`/`submitBatch`). Обидва зареєстровані провайдери
- * (`omlx`, `litellm`) завжди присутні в мапі одночасно — "активність"
- * визначається лише тим, чий provider-префікс реально стоїть у
- * model-spec (`N_LOCAL_MIN_MODEL` тощо): `LocalCloud::one_shot_with_spec`
- * б'є рівно в один клієнт за префіксом spec, тож другий запис у мапі
- * ніколи не отримує запиту, поки на нього не вказує жоден spec.
+ * `oneShotLocalCloud`/`submitBatch`). Один generic-слот `local-openai`
+ * покриває БУДЬ-ЯКИЙ кастомний OpenAI-сумісний сервер (omlx, litellm-проксі,
+ * TurboFieldfareServer, майбутні) — одним спільним `N_LOCAL_OPENAI_*`-env
+ * замість окремої env-пари на кожен сервер.
+ *
+ * **Свідома відмова від окремих `omlx`/`litellm`-записів (та їхньої
+ * можливості діяти одночасно через різні tier-env, напр.
+ * `N_LOCAL_MIN_MODEL=omlx/...` + `N_LOCAL_AVG_MODEL=litellm/...`)** —
+ * generic-слот залишає активним лише один `baseUrl` за раз, перемикання
+ * між серверами — переналаштуванням `N_LOCAL_OPENAI_BASE_URL`. Це свідомий
+ * breaking change: model-spec-префікс `"omlx/..."` більше не резолвиться —
+ * усі конфіги мають мігрувати на `"local-openai/..."` (nitra/7n-rules#374).
+ *
+ * **Навмисно не `openai`**: цей рядок — literal cloud-provider prefix, який
+ * `local_cloud.rs` (і genai) розпізнають як справжній хмарний OpenAI (напр.
+ * `N_CLOUD_MIN_MODEL=openai/gpt-5.4-mini`) — реєстрація `openai` в
+ * local-мапі тихо перехопила б такі cloud-виклики на локальний baseUrl.
  */
 import { env } from 'node:process'
 
 /**
  * @returns {{
- *   omlx: { baseUrl: string, apiKey: string|null },
- *   litellm: { baseUrl: string, apiKey: string|null }
- * }} дефолтна мапа локальних провайдерів (override окремих полів — через
- * `N_OMLX_BASE_URL`/`N_OMLX_API_KEY`/`N_LITELLM_BASE_URL`/`N_LITELLM_API_KEY`;
- * для API-ключів приймаються і без префікса `OMLX_API_KEY`/`LITELLM_API_KEY` —
- * це власна конвенція самих серверів (omlx-server читає `OMLX_API_KEY` для свого
- * auth), тож розробницьке оточення природно експортує саме її; `N_`-префіксовані
- * значення мають пріоритет)
+ *   'local-openai': { baseUrl: string, apiKey: string|null }
+ * }} дефолтна мапа локальних провайдерів (override — через
+ * `N_LOCAL_OPENAI_BASE_URL`/`N_LOCAL_OPENAI_API_KEY`; дефолтний `baseUrl` —
+ * локальний omlx-порт `http://127.0.0.1:8000/v1/`, найбезпечніший
+ * zero-config дефолт — без мережі, без зовнішньої залежності)
  */
 export function defaultLocalProviders() {
   return {
-    omlx: {
-      baseUrl: env.N_OMLX_BASE_URL ?? 'http://127.0.0.1:8000/v1/',
-      apiKey: env.N_OMLX_API_KEY ?? env.OMLX_API_KEY ?? null
-    },
-    litellm: {
-      baseUrl: env.N_LITELLM_BASE_URL ?? 'https://llm.7n.ai/v1/',
-      apiKey: env.N_LITELLM_API_KEY ?? env.LITELLM_API_KEY ?? null
+    'local-openai': {
+      baseUrl: env.N_LOCAL_OPENAI_BASE_URL ?? 'http://127.0.0.1:8000/v1/',
+      apiKey: env.N_LOCAL_OPENAI_API_KEY ?? null
     }
   }
 }

package/lib/model-tiers.mjs

@@ -118,7 +118,7 @@ export function formatModelSpec(model) {
 
 /** Провайдери, що вважаються локальними. Override: `N_LLM_LOCAL_PROVIDERS` (кома-список). */
 const LOCAL_PROVIDERS = new Set(
-  (env.N_LLM_LOCAL_PROVIDERS ?? 'omlx,litellm')
+  (env.N_LLM_LOCAL_PROVIDERS ?? 'local-openai')
     .split(',')
     .map(p => p.trim())
     .filter(Boolean)
@@ -126,8 +126,8 @@ const LOCAL_PROVIDERS = new Set(
 
 /**
  * Чи model-spec вказує на локальну модель: збіг з одним із LOCAL_* тирів
- * АБО провайдер з `N_LLM_LOCAL_PROVIDERS` (дефолт `omlx,litellm`). Обидва
- * провайдери можуть бути зареєстровані в `localProviders`-конфізі одночасно
+ * АБО провайдер з `N_LLM_LOCAL_PROVIDERS` (дефолт `local-openai`).
+ * Провайдер може бути зареєстрований в `localProviders`-конфізі одночасно
  * (див. `local-providers.mjs`) — "активний" завжди рівно один, бо
  * `LocalCloud` викликає клієнта за провайдер-префіксом фактичного
  * model-spec, не за наявністю запису в мапі. Використовується

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/llm-lib",
-  "version": "2.14.12",
+  "version": "2.14.14",
   "description": "Тонкий шар роботи з LLM (локальні omlx + хмарні провайдери) поверх pi: model tiers, one-shot, agentic-раннери, write-guard, trace, telemetry, prompt-budget",
   "keywords": [
     "nitra",
@@ -56,8 +56,8 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@7n/llm-lib-darwin-arm64": "2.14.12",
-    "@7n/llm-lib-linux-x64": "2.14.12"
+    "@7n/llm-lib-darwin-arm64": "2.14.14",
+    "@7n/llm-lib-linux-x64": "2.14.14"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "~0.80.10",