@dev-sergeev/datalab-kit 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.5
+
+- GigaChat загружается через штатную точку входа расширения с интерактивным мастером `/gigachat`; пользовательские подключения и настройки сохраняются. Lockfile обновлён до `pi-gigachat` 0.6.1 без изменения upstream-кода; зависимость остаётся `latest`. Прежние утверждения для 0.5.1 о встроенных моделях и автоматическом default больше не применяются.
+- Добавлен отдельный провайдер `DataLab` с моделями `glm-5.2 [DataLab]` и `Qwen3.5-397b [DataLab]`, только когда `GIGACHAT_API_URL` и `JPY_API_TOKEN` обе непусты после trim. Адрес задаёт корень API, токен передаётся как Bearer без сохранения в `auth.json`; `.env` автоматически не загружается, изменения окружения требуют перезапуска Pi.
+- DataLab не меняет текущую модель или сохранённые defaults, не запрашивает каталог моделей и не проверяет сервер при запуске. Ошибки сервера возвращаются при обычном запросе к модели. Решение и границы ответственности описаны в ADR 0003.
+
 ## 0.1.4 — 2026-10-14
 
 - GigaChat загружается через штатную точку входа расширения: доступны `/login`, мастер `/gigachat`, встроенные модели и собственная политика выбора default-модели. Lockfile обновлён до `pi-gigachat` 0.5.1; зависимость остаётся `latest`.

package/README.md

@@ -41,7 +41,28 @@ pi install ./dev-sergeev-datalab-kit-0.1.4.tgz
 
 Одиннадцать фиксированных компонентов включены в архив npm вместе с их зависимостями. GigaChat устанавливается отдельно без закрепления версии.
 
-Datalab Kit загружает штатное расширение GigaChat, не заменяя его регистрацию только провайдером. Сохраняются встроенные модели и собственная политика выбора модели пакета. Для авторизации используйте `/login` → GigaChat; `/gigachat` открывает мастер подключений, авторизации и выбора моделей из каталогов серверов. Основную модель выбирают через `/model`.
+Datalab Kit загружает штатное расширение GigaChat 0.6.1 без изменения его кода. `/gigachat` открывает интерактивный мастер подключений, авторизации и выбора моделей из каталогов серверов; это не интерфейс настройки через аргументы. Сохранённые подключения и пользовательские настройки остаются под управлением upstream. Основную модель выбирают через `/model`.
+
+## DataLab из окружения
+
+Дополнительно Datalab Kit регистрирует отдельный провайдер с идентификатором и именем `DataLab`, только если **обе** переменные окружения процесса Pi — `GIGACHAT_API_URL` и `JPY_API_TOKEN` — непусты после удаления пробелов по краям. Если хотя бы одна отсутствует, пуста или содержит только пробелы, провайдер и его модели не появляются в `/model`.
+
+Задайте окружение до запуска Pi, например:
+
+```bash
+export GIGACHAT_API_URL="https://your-server.example/v1"
+export JPY_API_TOKEN="your-token"
+pi
+```
+
+`GIGACHAT_API_URL` — корень API с необходимым серверу префиксом пути (например, `/v1`), но без `/chat/completions`: этот суффикс добавляет адаптер. `JPY_API_TOKEN` передаётся как Bearer-токен и не сохраняется в `auth.json`. Datalab Kit не загружает `.env` автоматически; после изменения окружения перезапустите Pi.
+
+| Модель в `/model` | Model ID на сервере | Контекст | Максимальный вывод |
+| --- | --- | --- | --- |
+| `glm-5.2 [DataLab]` | `glm-5.2` | 200000 токенов | 64000 токенов |
+| `Qwen3.5-397b [DataLab]` | `Qwen3.5-397b` | 262144 токенов | 32768 токенов |
+
+Этот фиксированный список не запрашивается у сервера. Регистрация не выбирает текущую модель и не меняет сохранённые defaults пользователя. При запуске нет HTTP-проверки сервера или пробной генерации; обычный запрос выполняется после обращения к модели, а ошибки сервера возвращаются пользователю. Штатный мастер `/gigachat` остаётся независимым от DataLab. Архитектурное решение — [ADR 0003](docs/adr/0003-datalab-environment-provider.md).
 
 ## Значения по умолчанию
 
@@ -55,7 +76,7 @@ Datalab Kit загружает штатное расширение GigaChat, н
 - Подтверждения показывает штатный диалог `@gotgenes/pi-permission-system`: разрешение одного запуска или на сессию, отказ и отказ с причиной. Настройки клавиш и повторного нажатия управляются самим расширением; собственного диалога Datalab Kit нет.
 - Одновременно работает один субагент. Инструмент `subagent` принимает одну задачу за вызов.
 
-Уже заданные пользователем настройки имеют приоритет над значениями Datalab Kit, включая разрешения, настройки штатного диалога и число субагентов. Собственная политика установки и выбора модели GigaChat остаётся штатной; подробнее ниже. Значения разрешений и числа субагентов действуют в памяти. Настройки разрешений остаются в штатных `extensions/pi-permission-system/config.json` внутри каталога агента и `.pi/extensions/pi-permission-system/config.json` внутри проекта. Субагенты используют `<agentDir>/subagents.json` и `<project>/.pi/subagents.json`.
+Уже заданные пользователем настройки имеют приоритет над значениями Datalab Kit, включая разрешения, настройки штатного диалога и число субагентов. Штатные подключения GigaChat управляются upstream; дополнительный DataLab не меняет выбор модели и defaults. Значения разрешений и числа субагентов действуют в памяти. Настройки разрешений остаются в штатных `extensions/pi-permission-system/config.json` внутри каталога агента и `.pi/extensions/pi-permission-system/config.json` внутри проекта. Субагенты используют `<agentDir>/subagents.json` и `<project>/.pi/subagents.json`.
 
 В **Plan mode** допустимые инструменты и команды проверяет pi-plan-mode без дополнительных подтверждений по правилам набора. Явные пользовательские `ask` и `deny` продолжают действовать; некорректная конфигурация разрешений также не обходится. После выхода из Plan mode или перехода к реализации правила набора снова действуют. Это поведение сохраняется при восстановлении сессии и смене ветки. Plan mode допускает некоторые тесты и проверки, которые могут создавать артефакты.
 
@@ -91,7 +112,7 @@ GigaChat обновляется независимо от версии набо
 
 Явно закреплённый пользователем источник GigaChat сохраняется. При удалении набора отдельная запись GigaChat остаётся; её можно удалить стандартным `pi remove npm:@dev-sergeev/pi-gigachat`. Установка с `-l` пока не проверена.
 
-GigaChat загружается со своей политикой как внутри набора, так и через отдельную запись пакета. В проверенной версии 0.5.1 встроены GLM и Qwen; собственная инициализация пакета назначает основной default `gigachat/Qwen3.5-397b`, с его штатными исключениями для сохранённых частных подключений и выбора сессии. Это может изменить ранее сохранённые `defaultProvider` и `defaultModel`; Datalab Kit не блокирует такое поведение и не переписывает исходники GigaChat. Авторизация и ранее сохранённые подключения не очищаются. Модель recap настраивается независимо.
+GigaChat загружается через штатную точку входа как внутри набора, так и через отдельную запись пакета. Для 0.6.1 настройка подключений и моделей выполняется интерактивным `/gigachat`; прежние утверждения о встроенных GLM/Qwen и автоматическом default `gigachat/Qwen3.5-397b` относились к 0.5.1 и к этой версии неприменимы. Datalab Kit не переписывает исходники GigaChat, не очищает авторизацию или сохранённые подключения. Дополнительный провайдер DataLab не меняет текущую модель или defaults. Модель recap настраивается независимо.
 
 ## Разработка
 

package/dist/datalab-provider.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function registerDataLab(pi: ExtensionAPI, extensionPath: string): Promise<void>;

package/dist/datalab-provider.js

@@ -0,0 +1,45 @@
+import { createProvider } from '@earendil-works/pi-ai';
+import { pathToFileURL } from 'node:url';
+export default async function registerDataLab(pi, extensionPath) {
+    const baseUrl = process.env.GIGACHAT_API_URL?.trim();
+    const apiKey = process.env.JPY_API_TOKEN?.trim();
+    if (!baseUrl || !apiKey)
+        return;
+    // Pi may load an independently updated managed installation, not our dependency.
+    const { streamSimpleGigaChat } = await import(pathToFileURL(extensionPath).href);
+    const models = [
+        { id: 'glm-5.2', name: 'GLM 5.2', contextWindow: 200000, maxTokens: 64000 },
+        { id: 'Qwen3.5-397b', name: 'Qwen 3.5 397B', contextWindow: 262144, maxTokens: 32768 },
+    ].map(model => ({
+        ...model,
+        provider: 'DataLab',
+        api: 'gigachat-extension-api',
+        baseUrl,
+        input: ['text'],
+        reasoning: true,
+        thinkingLevelMap: { off: 'off', minimal: null, low: 'low', medium: 'medium', high: 'high', xhigh: null, max: null },
+        // Unknown USD prices; zero is not a free-tier claim.
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    }));
+    const stream = (model, context, options = {}) => streamSimpleGigaChat(model, context, {
+        ...options,
+        apiKey,
+        // A saved credential or legacy GigaChat env must not redirect DataLab.
+        env: { ...options.env, GIGACHAT_BASE_URL: baseUrl },
+    });
+    pi.registerProvider(createProvider({
+        id: 'DataLab',
+        name: 'DataLab',
+        models,
+        auth: {
+            apiKey: {
+                name: 'JPY_API_TOKEN',
+                async resolve({ signal }) {
+                    signal.throwIfAborted();
+                    return { auth: { apiKey, baseUrl }, source: 'JPY_API_TOKEN' };
+                },
+            },
+        },
+        api: { stream, streamSimple: stream },
+    }));
+}

package/dist/extension.js

@@ -2,10 +2,12 @@ import { getAgentDir } from '@earendil-works/pi-coding-agent';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { resolve } from 'node:path';
 import { gigaChatExtensionPath, hasConfiguredGigaChat, managedAgentDir, registerGigaChat } from './install.js';
+import registerDataLab from './datalab-provider.js';
 export default async function datalabKit(pi) {
     const packageRoot = fileURLToPath(new URL('../', import.meta.url));
     const agentDir = getAgentDir();
     const configured = await hasConfiguredGigaChat(agentDir);
+    await registerDataLab(pi, gigaChatExtensionPath(packageRoot));
     // On the first load, provide GigaChat immediately. Later Pi discovers the
     // standalone source itself, so the provider must not be registered twice.
     if (!configured) {

package/docs/adr/0003-datalab-environment-provider.md

@@ -0,0 +1,11 @@
+# ADR 0003: Отдельный провайдер DataLab из окружения
+
+Status: accepted for implementation
+
+В `pi-gigachat` 0.6.1 `/gigachat` — интерактивный мастер, а не программный интерфейс настройки через аргументы. Для подключения из окружения Datalab Kit владеет отдельным нативным провайдером с идентификатором и именем `DataLab`, повторно используя публичный stream/adapter upstream. Штатная точка входа GigaChat, мастер, сохранённые подключения и настройки пользователя остаются без изменений; код upstream не патчится и мастер не автоматизируется.
+
+Провайдер регистрируется только при непустых после trim `GIGACHAT_API_URL` и `JPY_API_TOKEN` в окружении процесса Pi. URL задаёт корень API, включая нужный префикс вроде `/v1`, без `/chat/completions`; токен передаётся как Bearer и не сохраняется в `auth.json` или настройках. Окружение задаётся до запуска Pi, `.env` автоматически не загружается, новые значения требуют перезапуска. Регистрация не проверяет сервер и не выполняет пробных генераций: ошибки возвращаются при обычном запросе пользователя.
+
+Datalab Kit задаёт только дополнительный фиксированный каталог: `glm-5.2 [DataLab]` (ID `glm-5.2`, контекст 200000, вывод 64000) и `Qwen3.5-397b [DataLab]` (ID `Qwen3.5-397b`, контекст 262144, вывод 32768), с reasoning maps соответствующих моделей upstream 0.5.1. Регистрация не выбирает текущую модель и не меняет сохранённые defaults.
+
+Компромисс: набор отвечает за этот фиксированный каталог и совместимость с публичным адаптером, зато не зависит от автоматизации интерактивного мастера, не хранит секреты и не вводит собственный транспорт. Это ограниченно пересматривает запрет собственной политики моделей из [ADR 0002](0002-package-delivery.md) только для дополнительного DataLab; штатное поведение upstream и независимые настройки recap остаются вне этого пересмотра.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev-sergeev/datalab-kit",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A ready-to-use collection of Pi coding agent extensions",
   "type": "module",
   "license": "MIT",