@joingonka/setup 0.1.0

package/dist/adapters/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Контракт адаптера инструмента.
+ *
+ * Каждый поддерживаемый инструмент (Claude Code, OpenClaw, Cline) реализует
+ * Adapter. Общий core (fs-ops, merge, validate) не знает о конкретных
+ * инструментах — он работает через этот интерфейс. Добавление нового
+ * инструмента = новый адаптер + запись в registry, без правок оркестратора.
+ */
+/**
+ * Куда устанавливаем конфигурацию:
+ * - 'user'  — глобально (домашний каталог пользователя)
+ * - 'local' — в текущем проекте (cwd)
+ */
+export type Scope = 'user' | 'local';
+/** Вход для apply(): что именно прописать в конфиг инструмента. */
+export interface ApplyInput {
+    apiKey: string;
+    model: string;
+    scope: Scope;
+}
+/** Результат apply(): что произошло, для вывода пользователю. */
+export interface ApplyResult {
+    /** Путь к записанному конфигу, либо null для instructions-only инструментов. */
+    configPath: string | null;
+    /** Путь к созданному бэкапу, либо null если бэкапить было нечего. */
+    backupPath: string | null;
+    /** Был ли реально записан файл (false для instructions-only). */
+    wrote: boolean;
+    /** Сообщения пользователю (инструкции, подтверждения, заметки). */
+    messages: string[];
+}
+/** Адаптер одного инструмента. */
+export interface Adapter {
+    /** Машинный идентификатор: 'claude-code' | 'openclaw' | 'cline'. */
+    readonly id: string;
+    /** Человекочитаемое имя для меню выбора. */
+    readonly label: string;
+    /** Формат конфига — определяет ветку записи. */
+    readonly format: 'json' | 'yaml' | 'instructions';
+    /**
+     * Абсолютный путь к целевому файлу конфига для заданного scope,
+     * либо null для instructions-only инструментов (ничего не пишем).
+     *
+     * ВАЖНО: homedir()/cwd() читаются В МОМЕНТ ВЫЗОВА, а не на импорте
+     * модуля — иначе тесты не смогут подменять HOME/cwd.
+     */
+    resolvePath(scope: Scope): string | null;
+    /** Применить конфигурацию (записать файл либо вернуть инструкции). */
+    apply(input: ApplyInput): Promise<ApplyResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAErC,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qEAAqE;IACrE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iEAAiE;IACjE,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,kCAAkC;AAClC,MAAM,WAAW,OAAO;IACtB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;IAElD;;;;;;OAMG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAEzC,sEAAsE;IACtE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChD"}

package/dist/adapters/types.js

@@ -0,0 +1,10 @@
+/**
+ * Контракт адаптера инструмента.
+ *
+ * Каждый поддерживаемый инструмент (Claude Code, OpenClaw, Cline) реализует
+ * Adapter. Общий core (fs-ops, merge, validate) не знает о конкретных
+ * инструментах — он работает через этот интерфейс. Добавление нового
+ * инструмента = новый адаптер + запись в registry, без правок оркестратора.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point для @joingonka/setup.
+ *
+ * Тонкая обёртка над run() из run.ts: парсинг аргументов, подключение
+ * реальных промптов (core/prompt.ts) и обработка ошибок. Вся логика
+ * установки — внутри run().
+ *
+ * Безопасность: ключ НИКОГДА не принимается CLI-аргументом. В интерактиве
+ * он вводится password-промптом, в non-interactive — берётся из env
+ * JOINGONKA_API_KEY. Аргумент командной строки попал бы в историю shell
+ * и в список процессов — это утечка секрета.
+ */
+import { Command } from 'commander';
+import { run } from './run.js';
+import { askApiKey, askTool } from './core/prompt.js';
+const program = new Command();
+program
+    .name('joingonka-setup')
+    .description('Point an agentic AI tool (Claude Code, OpenClaw, Cline) at JoinGonka Gateway')
+    .version('0.1.0')
+    .option('--tool <tool>', 'Tool to configure: claude-code | openclaw | cline')
+    .option('--scope <scope>', 'Installation scope: user or local', 'user')
+    .option('--model <model>', 'Model id, or "kimi" for Kimi K2.6 (default: Qwen3-235B)')
+    .option('--non-interactive', 'Do not prompt; read the API key from JOINGONKA_API_KEY env var')
+    .action(async (opts) => {
+    try {
+        const { result } = await run({
+            tool: opts.tool,
+            scope: opts.scope,
+            model: opts.model,
+            nonInteractive: opts.nonInteractive,
+        }, { askTool, askApiKey });
+        // Печатаем сообщения адаптера (пути/инструкции/подтверждения)
+        console.log('');
+        for (const line of result.messages) {
+            console.log(line);
+        }
+        if (result.backupPath) {
+            console.log(`Backup saved: ${result.backupPath}`);
+        }
+        process.exit(0);
+    }
+    catch (e) {
+        // ExitPromptError выбрасывается @inquirer/prompts при Ctrl+C
+        if (e instanceof Error && e.name === 'ExitPromptError') {
+            console.error('\nAborted.');
+            process.exit(130);
+        }
+        console.error('Setup failed:', e.message);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAUtD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO;KACJ,IAAI,CAAC,iBAAiB,CAAC;KACvB,WAAW,CACV,8EAA8E,CAC/E;KACA,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,eAAe,EAAE,mDAAmD,CAAC;KAC5E,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,MAAM,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;KACpF,MAAM,CACL,mBAAmB,EACnB,gEAAgE,CACjE;KACA,MAAM,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAC1B;YACE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,CACvB,CAAC;QAEF,8DAA8D;QAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,6DAA6D;QAC7D,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,eAAe,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AACL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Общие константы установщика @joingonka/setup.
+ *
+ * Базовые URL и модели захардкожены и НЕ конфигурируются через CLI:
+ * всё ценностное предложение пакета — одна команда, перенаправляющая
+ * агентный инструмент на наш managed-gateway. Флаг перезаписи URL
+ * обесценил бы пакет и увеличил риск ошибок.
+ */
+/**
+ * Base URL для Anthropic-совместимых инструментов (Claude Code и т.п.).
+ * БЕЗ суффикса /v1 — Claude Code сам добавляет /v1/messages.
+ */
+export declare const BASE_URL = "https://gate.joingonka.ai";
+/**
+ * Base URL для OpenAI-совместимых инструментов (OpenClaw, Cline и т.п.).
+ * С суффиксом /v1 — клиенты дописывают /chat/completions к нему.
+ *
+ * ВАЖНО: отличие /v1 vs без /v1 между двумя семействами инструментов —
+ * частый источник ошибок конфигурации, поэтому константы разделены явно.
+ */
+export declare const BASE_URL_OPENAI = "https://gate.joingonka.ai/v1";
+/**
+ * Модель по умолчанию — Qwen3-235B. Сильная для всего агентного пайплайна,
+ * нативный tool calling. Совпадает с примерами в knowledge-статьях.
+ */
+export declare const DEFAULT_MODEL = "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8";
+/**
+ * Альтернативная модель Kimi K2.6 — длинный контекст.
+ * Выбирается через CLI `--model kimi`.
+ */
+export declare const KIMI_MODEL = "moonshotai/Kimi-K2.6";
+/**
+ * Идентификатор нашего провайдера внутри `models.providers` OpenClaw-конфига.
+ * Под этим ключом адаптер upsert-ит блок провайдера, не трогая чужие
+ * (`openai`, `anthropic` и т.п.).
+ */
+export declare const OPENCLAW_PROVIDER_ID = "gonka";
+/**
+ * Имя env-переменной, ИЗ которой OpenClaw читает наш ключ во время работы.
+ * В JSON-конфиг пишется именно ЭТА СТРОКА (`"apiKey": "GONKA_API_KEY"`), а НЕ
+ * сам секрет jg-... — ключ не должен попадать в файл на диске. Пользователю
+ * выдаётся инструкция `export GONKA_API_KEY=jg-...`.
+ */
+export declare const OPENCLAW_API_KEY_ENV = "GONKA_API_KEY";
+/**
+ * Транспорт провайдера для OpenClaw. Подключаемся в OpenAI-режиме через наш
+ * зрелый роут /v1/chat/completions (как GonkaGate), поэтому
+ * `openai-completions`. baseUrl при этом — С суффиксом /v1 (BASE_URL_OPENAI).
+ *
+ * Поле `auth` НЕ пишем: GonkaGate в OpenAI-режиме его не указывает (клиент
+ * по умолчанию шлёт Bearer-ключ из apiKey-переменной).
+ */
+export declare const OPENCLAW_PROVIDER_API = "openai-completions";
+/**
+ * Запись одной модели для каталога провайдера OpenClaw.
+ *
+ * id        — каноничный id модели (casing как в SSOT model-specs.ts,
+ *             например `moonshotai/Kimi-K2.6` — НЕ lowercase).
+ * name      — человекочитаемое имя в UI выбора модели OpenClaw.
+ * maxTokens — потолок выдачи (совпадает с max_output из SSOT).
+ * online    — true для `:online`-варианта (веб-поиск через наш плагин).
+ * aliasFor  — для базовых моделей: короткий alias в agents.defaults.models.
+ *             undefined у `:online`-вариантов (для них alias не заводим).
+ */
+export interface OpenClawModelSpec {
+    id: string;
+    name: string;
+    maxTokens: number;
+    online: boolean;
+    /** Короткий alias (только для базовых вариантов); undefined для :online. */
+    aliasFor?: string;
+}
+/**
+ * Каталог моделей, которые адаптер прописывает в OpenClaw-провайдер `gonka`.
+ *
+ * Три базовых модели (с alias) + три `:online`-варианта (веб-поиск). Порядок
+ * совпадает с рабочим конфигом оператора: Kimi — первой (она же primary).
+ * SSOT по id/maxTokens — gateway/src/modules/network-status/model-specs.ts.
+ */
+export declare const OPENCLAW_MODELS: readonly OpenClawModelSpec[];
+/**
+ * Модель по умолчанию (primary) для OpenClaw в формате провайдер-ref
+ * `<provider>/<modelId>`. Ставится в agents.defaults.model.primary ТОЛЬКО
+ * если пользователь ещё не задал свой primary.
+ */
+export declare const OPENCLAW_DEFAULT_PRIMARY = "gonka/moonshotai/Kimi-K2.6";
+/**
+ * Сборка JSON-записи модели для каталога провайдера OpenClaw.
+ * Вынесено сюда, чтобы форма записи (cost/input/contextWindow) была SSOT
+ * и не дублировалась в адаптере/тестах.
+ */
+export declare function openclawModelEntry(spec: OpenClawModelSpec): Record<string, unknown>;
+/**
+ * Provider-ref модели (`<provider>/<modelId>`) для agents.defaults.models
+ * и primary. Применяется к базовому id (без суффикса `:online`).
+ */
+export declare function openclawModelRef(modelId: string): string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,QAAQ,8BAA8B,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,iCAAiC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,aAAa,2CAA2C,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,UAAU,yBAAyB,CAAC;AAMjD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqBD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,iBAAiB,EAOvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,+BAAiD,CAAC;AAEvF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/constants.js

@@ -0,0 +1,117 @@
+/**
+ * Общие константы установщика @joingonka/setup.
+ *
+ * Базовые URL и модели захардкожены и НЕ конфигурируются через CLI:
+ * всё ценностное предложение пакета — одна команда, перенаправляющая
+ * агентный инструмент на наш managed-gateway. Флаг перезаписи URL
+ * обесценил бы пакет и увеличил риск ошибок.
+ */
+/**
+ * Base URL для Anthropic-совместимых инструментов (Claude Code и т.п.).
+ * БЕЗ суффикса /v1 — Claude Code сам добавляет /v1/messages.
+ */
+export const BASE_URL = 'https://gate.joingonka.ai';
+/**
+ * Base URL для OpenAI-совместимых инструментов (OpenClaw, Cline и т.п.).
+ * С суффиксом /v1 — клиенты дописывают /chat/completions к нему.
+ *
+ * ВАЖНО: отличие /v1 vs без /v1 между двумя семействами инструментов —
+ * частый источник ошибок конфигурации, поэтому константы разделены явно.
+ */
+export const BASE_URL_OPENAI = 'https://gate.joingonka.ai/v1';
+/**
+ * Модель по умолчанию — Qwen3-235B. Сильная для всего агентного пайплайна,
+ * нативный tool calling. Совпадает с примерами в knowledge-статьях.
+ */
+export const DEFAULT_MODEL = 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8';
+/**
+ * Альтернативная модель Kimi K2.6 — длинный контекст.
+ * Выбирается через CLI `--model kimi`.
+ */
+export const KIMI_MODEL = 'moonshotai/Kimi-K2.6';
+// ────────────────────────────────────────────────────────────────────────────
+// OpenClaw-специфичные константы (JSON-конфиг ~/.openclaw/openclaw.json)
+// ────────────────────────────────────────────────────────────────────────────
+/**
+ * Идентификатор нашего провайдера внутри `models.providers` OpenClaw-конфига.
+ * Под этим ключом адаптер upsert-ит блок провайдера, не трогая чужие
+ * (`openai`, `anthropic` и т.п.).
+ */
+export const OPENCLAW_PROVIDER_ID = 'gonka';
+/**
+ * Имя env-переменной, ИЗ которой OpenClaw читает наш ключ во время работы.
+ * В JSON-конфиг пишется именно ЭТА СТРОКА (`"apiKey": "GONKA_API_KEY"`), а НЕ
+ * сам секрет jg-... — ключ не должен попадать в файл на диске. Пользователю
+ * выдаётся инструкция `export GONKA_API_KEY=jg-...`.
+ */
+export const OPENCLAW_API_KEY_ENV = 'GONKA_API_KEY';
+/**
+ * Транспорт провайдера для OpenClaw. Подключаемся в OpenAI-режиме через наш
+ * зрелый роут /v1/chat/completions (как GonkaGate), поэтому
+ * `openai-completions`. baseUrl при этом — С суффиксом /v1 (BASE_URL_OPENAI).
+ *
+ * Поле `auth` НЕ пишем: GonkaGate в OpenAI-режиме его не указывает (клиент
+ * по умолчанию шлёт Bearer-ключ из apiKey-переменной).
+ */
+export const OPENCLAW_PROVIDER_API = 'openai-completions';
+/**
+ * Общий context window всех текущих MoE-моделей сети (совпадает с SSOT).
+ */
+const OPENCLAW_CONTEXT_WINDOW = 131072;
+/**
+ * Единая тарификация для каталога OpenClaw ($/1M токенов).
+ *
+ * Значения справочные — реальная тарификация считается на нашей стороне
+ * (gateway), здесь они нужны лишь чтобы OpenClaw показывал примерную
+ * стоимость в UI. cacheRead/cacheWrite приравнены к input.
+ */
+const OPENCLAW_COST = {
+    input: 0.07,
+    output: 0.1,
+    cacheRead: 0.07,
+    cacheWrite: 0.07,
+};
+/**
+ * Каталог моделей, которые адаптер прописывает в OpenClaw-провайдер `gonka`.
+ *
+ * Три базовых модели (с alias) + три `:online`-варианта (веб-поиск). Порядок
+ * совпадает с рабочим конфигом оператора: Kimi — первой (она же primary).
+ * SSOT по id/maxTokens — gateway/src/modules/network-status/model-specs.ts.
+ */
+export const OPENCLAW_MODELS = [
+    { id: 'moonshotai/Kimi-K2.6', name: 'Kimi K2.6 (Gonka)', maxTokens: 3072, online: false, aliasFor: 'kimi-k2.6' },
+    { id: 'moonshotai/Kimi-K2.6:online', name: 'Kimi K2.6 + web (Gonka)', maxTokens: 3072, online: true },
+    { id: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8', name: 'Qwen3-235B-A22B (Gonka)', maxTokens: 8192, online: false, aliasFor: 'qwen3-235b' },
+    { id: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8:online', name: 'Qwen3-235B-A22B + web (Gonka)', maxTokens: 8192, online: true },
+    { id: 'MiniMaxAI/MiniMax-M2.7', name: 'MiniMax M2.7 (Gonka)', maxTokens: 4096, online: false, aliasFor: 'minimax-m2.7' },
+    { id: 'MiniMaxAI/MiniMax-M2.7:online', name: 'MiniMax M2.7 + web (Gonka)', maxTokens: 4096, online: true },
+];
+/**
+ * Модель по умолчанию (primary) для OpenClaw в формате провайдер-ref
+ * `<provider>/<modelId>`. Ставится в agents.defaults.model.primary ТОЛЬКО
+ * если пользователь ещё не задал свой primary.
+ */
+export const OPENCLAW_DEFAULT_PRIMARY = `${OPENCLAW_PROVIDER_ID}/moonshotai/Kimi-K2.6`;
+/**
+ * Сборка JSON-записи модели для каталога провайдера OpenClaw.
+ * Вынесено сюда, чтобы форма записи (cost/input/contextWindow) была SSOT
+ * и не дублировалась в адаптере/тестах.
+ */
+export function openclawModelEntry(spec) {
+    return {
+        id: spec.id,
+        name: spec.name,
+        input: ['text'],
+        contextWindow: OPENCLAW_CONTEXT_WINDOW,
+        maxTokens: spec.maxTokens,
+        cost: { ...OPENCLAW_COST },
+    };
+}
+/**
+ * Provider-ref модели (`<provider>/<modelId>`) для agents.defaults.models
+ * и primary. Применяется к базовому id (без суффикса `:online`).
+ */
+export function openclawModelRef(modelId) {
+    return `${OPENCLAW_PROVIDER_ID}/${modelId}`;
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,8BAA8B,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,wCAAwC,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAEjD,+EAA+E;AAC/E,yEAAyE;AACzE,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAsB1D;;GAEG;AACH,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,GAAG;IACX,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;CACR,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,EAAE,EAAE,EAAE,sBAAsB,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE;IAChH,EAAE,EAAE,EAAE,6BAA6B,EAAE,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrG,EAAE,EAAE,EAAE,wCAAwC,EAAE,IAAI,EAAE,yBAAyB,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE;IACzI,EAAE,EAAE,EAAE,+CAA+C,EAAE,IAAI,EAAE,+BAA+B,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAC7H,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE;IACxH,EAAE,EAAE,EAAE,+BAA+B,EAAE,IAAI,EAAE,4BAA4B,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;CAC3G,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,oBAAoB,uBAAuB,CAAC;AAEvF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,uBAAuB;QACtC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,EAAE,GAAG,aAAa,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,GAAG,oBAAoB,IAAI,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/core/fs-ops.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Читает файл как строку. Возвращает null, если файла нет.
+ * Бросает только на реальных ошибках ввода-вывода (права и т.п.).
+ */
+export declare function readRaw(filePath: string): string | null;
+/**
+ * Создаёт бэкап файла с таймстемпом, безопасным для файловых систем.
+ *
+ * Имя: `<path>.bak.<ISO-с-замещёнными-:.>`. Двоеточия и точки в ISO-метке
+ * заменяются на `-`, иначе имя ломается на Windows/некоторых FS.
+ *
+ * Возвращает путь к бэкапу, либо null если исходного файла нет
+ * (бэкапить нечего — это не ошибка).
+ */
+export declare function backup(filePath: string): string | null;
+/**
+ * Атомарная запись: гарантирует существование родительского каталога,
+ * затем пишет через write-file-atomic (tmp + rename), чтобы файл никогда
+ * не оставался в полу-записанном состоянии.
+ *
+ * Опциональный `mode` задаёт права создаваемого файла. Мы НЕ полагаемся
+ * только на mode из write-file-atomic (его временный файл создаётся с учётом
+ * umask, итоговые биты могут отличаться) — после записи права принудительно
+ * выставляются через chmod, чтобы гарантировать ровно заданное значение
+ * (например 0o600 для файлов с секретами/конфигами инструментов).
+ */
+export declare function atomicWrite(filePath: string, contents: string, mode?: number): Promise<void>;
+//# sourceMappingURL=fs-ops.d.ts.map

package/dist/core/fs-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-ops.d.ts","sourceRoot":"","sources":["../../src/core/fs-ops.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQtD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/core/fs-ops.js

@@ -0,0 +1,63 @@
+/**
+ * Формат-агностичные файловые операции: чтение, бэкап, атомарная запись.
+ *
+ * Адаптеры (JSON/YAML) работают через эти примитивы, чтобы логика
+ * «прочитать существующее → забэкапить → атомарно записать» была единой
+ * и не дублировалась в каждом адаптере.
+ */
+import writeFileAtomic from 'write-file-atomic';
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Читает файл как строку. Возвращает null, если файла нет.
+ * Бросает только на реальных ошибках ввода-вывода (права и т.п.).
+ */
+export function readRaw(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    return fs.readFileSync(filePath, 'utf8');
+}
+/**
+ * Создаёт бэкап файла с таймстемпом, безопасным для файловых систем.
+ *
+ * Имя: `<path>.bak.<ISO-с-замещёнными-:.>`. Двоеточия и точки в ISO-метке
+ * заменяются на `-`, иначе имя ломается на Windows/некоторых FS.
+ *
+ * Возвращает путь к бэкапу, либо null если исходного файла нет
+ * (бэкапить нечего — это не ошибка).
+ */
+export function backup(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${filePath}.bak.${ts}`;
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+/**
+ * Атомарная запись: гарантирует существование родительского каталога,
+ * затем пишет через write-file-atomic (tmp + rename), чтобы файл никогда
+ * не оставался в полу-записанном состоянии.
+ *
+ * Опциональный `mode` задаёт права создаваемого файла. Мы НЕ полагаемся
+ * только на mode из write-file-atomic (его временный файл создаётся с учётом
+ * umask, итоговые биты могут отличаться) — после записи права принудительно
+ * выставляются через chmod, чтобы гарантировать ровно заданное значение
+ * (например 0o600 для файлов с секретами/конфигами инструментов).
+ */
+export async function atomicWrite(filePath, contents, mode) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    if (mode === undefined) {
+        await writeFileAtomic(filePath, contents);
+        return;
+    }
+    await writeFileAtomic(filePath, contents, { mode });
+    // Гарантируем точные биты независимо от umask на этапе создания tmp-файла.
+    fs.chmodSync(filePath, mode);
+}
+//# sourceMappingURL=fs-ops.js.map

package/dist/core/fs-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-ops.js","sourceRoot":"","sources":["../../src/core/fs-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,GAAG,QAAQ,QAAQ,EAAE,EAAE,CAAC;IAC3C,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,QAAgB,EAChB,IAAa;IAEb,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,MAAM,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,2EAA2E;IAC3E,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/merge.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Слияния JSON-конфигов.
+ *
+ * Общий принцип всех merge: НЕ разрушать чужие поля. Пользователь мог
+ * настроить инструмент под себя (хуки, лимиты, другие провайдеры) — мы
+ * трогаем только те ключи, которые относятся к переключению на JoinGonka
+ * Gateway.
+ */
+/** Произвольный JSON-объект конфига (частичная форма — чужие поля сохраняются). */
+export type JsonObject = Record<string, unknown>;
+/**
+ * Слияние JSON-конфигов на ОДИН уровень вложенности по `env`.
+ *
+ * - Все top-level поля existing сохраняются.
+ * - patch перезаписывает совпадающие top-level ключи ЦЕЛИКОМ, КРОМЕ `env`:
+ *   блок `env` сливается по ключам (deep-merge на один уровень), чтобы
+ *   не потерять чужие переменные окружения (CUSTOM_VAR, EDITOR и т.п.).
+ *
+ * Глубокий merge ограничен `env` намеренно: для Claude Code это единственный
+ * вложенный объект, куда мы дописываем свои ключи рядом с пользовательскими.
+ * Для произвольно-вложенных схем (OpenClaw) используется deepMergeJson.
+ *
+ * @param existing текущий объект конфига (null/массив/примитив → пустой)
+ * @param patch    наши поля для записи
+ */
+export declare function mergeJson(existing: unknown, patch: JsonObject): JsonObject;
+/**
+ * Рекурсивный merge двух JSON-объектов (immutable: base не мутируется).
+ *
+ * Правила:
+ * - оба значения по ключу — plain-объекты → сливаем рекурсивно;
+ * - значение из patch === undefined → НЕ затирает существующее (пропускаем);
+ * - иначе значение из patch заменяет значение base целиком (массивы и
+ *   примитивы НЕ сливаются — для конфигов «заменить список» предсказуемее,
+ *   чем конкатенация дублей; точечный upsert элементов делает upsertById).
+ *
+ * Применяется к глубоко-вложенным схемам (OpenClaw: models.providers.*,
+ * agents.defaults.*), где чужие ветки (другой провайдер, чужие алиасы)
+ * должны пережить наш upsert.
+ *
+ * @param base  текущий объект (null/массив/примитив → пустой объект)
+ * @param patch объект с нашими полями
+ */
+export declare function deepMergeJson(base: unknown, patch: JsonObject): JsonObject;
+/**
+ * Upsert элемента в массив по полю `id` (immutable: исходный массив не
+ * мутируется, возвращается новая копия).
+ *
+ * - запись с таким `id` есть → обновляется (поля item накладываются поверх,
+ *   чужие поля существующей записи сохраняются — shallow-merge);
+ * - записи нет → item добавляется в конец.
+ *
+ * Идемпотентность: повторный upsert той же записи не плодит дубликаты.
+ * Не-объектные элементы исходного массива пропускаются нетронутыми.
+ *
+ * @param array исходный массив записей (произвольных)
+ * @param item  запись с обязательным полем id
+ */
+export declare function upsertById(array: unknown[], item: JsonObject & {
+    id: string;
+}): unknown[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/core/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/core/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAOjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAa1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAiB1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,EAAE,CAUzF"}

package/dist/core/merge.js

@@ -0,0 +1,98 @@
+/**
+ * Слияния JSON-конфигов.
+ *
+ * Общий принцип всех merge: НЕ разрушать чужие поля. Пользователь мог
+ * настроить инструмент под себя (хуки, лимиты, другие провайдеры) — мы
+ * трогаем только те ключи, которые относятся к переключению на JoinGonka
+ * Gateway.
+ */
+/** true для plain-объекта (не null, не массив). */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Слияние JSON-конфигов на ОДИН уровень вложенности по `env`.
+ *
+ * - Все top-level поля existing сохраняются.
+ * - patch перезаписывает совпадающие top-level ключи ЦЕЛИКОМ, КРОМЕ `env`:
+ *   блок `env` сливается по ключам (deep-merge на один уровень), чтобы
+ *   не потерять чужие переменные окружения (CUSTOM_VAR, EDITOR и т.п.).
+ *
+ * Глубокий merge ограничен `env` намеренно: для Claude Code это единственный
+ * вложенный объект, куда мы дописываем свои ключи рядом с пользовательскими.
+ * Для произвольно-вложенных схем (OpenClaw) используется deepMergeJson.
+ *
+ * @param existing текущий объект конфига (null/массив/примитив → пустой)
+ * @param patch    наши поля для записи
+ */
+export function mergeJson(existing, patch) {
+    // Защита от null / массивов / примитивов — конфиг должен быть объектом
+    const base = isPlainObject(existing) ? existing : {};
+    const merged = { ...base, ...patch };
+    // env сливаем по ключам, а не заменяем целиком
+    if (isPlainObject(patch.env)) {
+        const existingEnv = isPlainObject(base.env) ? base.env : {};
+        merged.env = { ...existingEnv, ...patch.env };
+    }
+    return merged;
+}
+/**
+ * Рекурсивный merge двух JSON-объектов (immutable: base не мутируется).
+ *
+ * Правила:
+ * - оба значения по ключу — plain-объекты → сливаем рекурсивно;
+ * - значение из patch === undefined → НЕ затирает существующее (пропускаем);
+ * - иначе значение из patch заменяет значение base целиком (массивы и
+ *   примитивы НЕ сливаются — для конфигов «заменить список» предсказуемее,
+ *   чем конкатенация дублей; точечный upsert элементов делает upsertById).
+ *
+ * Применяется к глубоко-вложенным схемам (OpenClaw: models.providers.*,
+ * agents.defaults.*), где чужие ветки (другой провайдер, чужие алиасы)
+ * должны пережить наш upsert.
+ *
+ * @param base  текущий объект (null/массив/примитив → пустой объект)
+ * @param patch объект с нашими полями
+ */
+export function deepMergeJson(base, patch) {
+    const out = isPlainObject(base) ? { ...base } : {};
+    for (const [key, patchValue] of Object.entries(patch)) {
+        if (patchValue === undefined) {
+            // Явный undefined в patch не должен затирать существующее значение
+            continue;
+        }
+        const baseValue = out[key];
+        if (isPlainObject(baseValue) && isPlainObject(patchValue)) {
+            out[key] = deepMergeJson(baseValue, patchValue);
+        }
+        else {
+            out[key] = patchValue;
+        }
+    }
+    return out;
+}
+/**
+ * Upsert элемента в массив по полю `id` (immutable: исходный массив не
+ * мутируется, возвращается новая копия).
+ *
+ * - запись с таким `id` есть → обновляется (поля item накладываются поверх,
+ *   чужие поля существующей записи сохраняются — shallow-merge);
+ * - записи нет → item добавляется в конец.
+ *
+ * Идемпотентность: повторный upsert той же записи не плодит дубликаты.
+ * Не-объектные элементы исходного массива пропускаются нетронутыми.
+ *
+ * @param array исходный массив записей (произвольных)
+ * @param item  запись с обязательным полем id
+ */
+export function upsertById(array, item) {
+    const out = [...array];
+    const idx = out.findIndex((entry) => isPlainObject(entry) && entry.id === item.id);
+    if (idx === -1) {
+        out.push({ ...item });
+        return out;
+    }
+    const existing = out[idx];
+    out[idx] = { ...existing, ...item };
+    return out;
+}
+//# sourceMappingURL=merge.js.map