@joingonka/setup 0.1.0

package/dist/core/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/core/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,mDAAmD;AACnD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,QAAiB,EAAE,KAAiB;IAC5D,uEAAuE;IACvE,MAAM,IAAI,GAAe,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,MAAM,MAAM,GAAe,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;IAEjD,+CAA+C;IAC/C,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,KAAiB;IAC5D,MAAM,GAAG,GAAe,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,mEAAmE;YACnE,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,IAAiC;IAC5E,MAAM,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACvB,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;IACnF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAe,CAAC;IACxC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/prompt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Запрос API-ключа через password-промпт (маскируется, не попадает
+ * в историю stdin). Валидация — тот же validateApiKey, что и для env-ключа.
+ */
+export declare function askApiKey(): Promise<string>;
+/** Выбор инструмента из меню (список берётся из реестра адаптеров). */
+export declare function askTool(): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAMjD;AAED,uEAAuE;AACvE,wBAAsB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAK/C"}

package/dist/core/prompt.js

@@ -0,0 +1,29 @@
+/**
+ * Интерактивные промпты поверх @inquirer/prompts.
+ *
+ * Вынесены в отдельный модуль, чтобы оркестратор (run.ts) принимал их как
+ * зависимости и тесты могли подменять промпты spy-функциями без реального
+ * stdin. В проде CLI передаёт именно эти реализации.
+ */
+import { password, select } from '@inquirer/prompts';
+import { validateApiKey } from './validate.js';
+import { listTools } from '../adapters/registry.js';
+/**
+ * Запрос API-ключа через password-промпт (маскируется, не попадает
+ * в историю stdin). Валидация — тот же validateApiKey, что и для env-ключа.
+ */
+export async function askApiKey() {
+    return password({
+        message: 'Enter your JoinGonka API key (jg-...):',
+        mask: '*',
+        validate: validateApiKey,
+    });
+}
+/** Выбор инструмента из меню (список берётся из реестра адаптеров). */
+export async function askTool() {
+    return select({
+        message: 'Which tool do you want to configure?',
+        choices: listTools(),
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/core/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/core/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,QAAQ,CAAC;QACd,OAAO,EAAE,wCAAwC;QACjD,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,cAAc;KACzB,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,OAAO,MAAM,CAAC;QACZ,OAAO,EAAE,sCAAsC;QAC/C,OAAO,EAAE,SAAS,EAAE;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/core/validate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Валидация JoinGonka API-ключа.
+ *
+ * Все ключи JoinGonka имеют префикс `jg-`. Проверяем именно префикс,
+ * а не просто наличие подстроки, чтобы отсеять чужие форматы ключей
+ * (sk-..., и т.п.) до записи их в конфиг.
+ *
+ * Сигнатура `true | string` совместима с опцией `validate`
+ * из @inquirer/prompts — то же значение используется и в password-промпте.
+ */
+export declare function validateApiKey(value: string): true | string;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAU3D"}

package/dist/core/validate.js

@@ -0,0 +1,22 @@
+/**
+ * Валидация JoinGonka API-ключа.
+ *
+ * Все ключи JoinGonka имеют префикс `jg-`. Проверяем именно префикс,
+ * а не просто наличие подстроки, чтобы отсеять чужие форматы ключей
+ * (sk-..., и т.п.) до записи их в конфиг.
+ *
+ * Сигнатура `true | string` совместима с опцией `validate`
+ * из @inquirer/prompts — то же значение используется и в password-промпте.
+ */
+export function validateApiKey(value) {
+    // Обрезаем пробелы: ввод вида "   " не должен считаться валидным
+    const v = (value ?? '').trim();
+    if (!v) {
+        return 'API key is required';
+    }
+    if (!v.startsWith('jg-')) {
+        return 'API key must start with jg-';
+    }
+    return true;
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/core/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,iEAAiE;IACjE,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,6BAA6B,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,24 @@
+import type { ApplyResult, Scope } from './adapters/types.js';
+/** Опции запуска (из CLI-аргументов). */
+export interface RunOptions {
+    /** Идентификатор инструмента; если не задан — спросим интерактивно. */
+    tool?: string;
+    /** 'user' (глобально) или 'local' (в проекте). По умолчанию 'user'. */
+    scope?: Scope;
+    /** Модель: undefined → default; 'kimi' → Kimi; иначе трактуется как явный id. */
+    model?: string;
+    /** Неинтерактивный режим: ключ берётся из env, промпты запрещены. */
+    nonInteractive?: boolean;
+}
+/** Инъектируемые промпты (в проде — реализации из core/prompt.ts). */
+export interface RunDeps {
+    askTool: () => Promise<string>;
+    askApiKey: () => Promise<string>;
+}
+/** Что вернул запуск — для вывода в CLI. */
+export interface RunOutcome {
+    toolId: string;
+    result: ApplyResult;
+}
+export declare function run(options: RunOptions, deps: RunDeps): Promise<RunOutcome>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE9D,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;CACrB;AAiBD,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAuCjF"}

package/dist/run.js

@@ -0,0 +1,65 @@
+/**
+ * Оркестратор установки.
+ *
+ * Склеивает шаги, не зная деталей конкретных инструментов:
+ *   1. выбрать инструмент (явный --tool или интерактивный select);
+ *   2. получить API-ключ (из env в non-interactive, иначе password-промпт);
+ *   3. определить модель (default / kimi / явный id);
+ *   4. вызвать adapter.apply().
+ *
+ * Промпты инъектируются через deps — это делает оркестратор полностью
+ * тестируемым (spy-функции) и отвязывает его от @inquirer/prompts.
+ */
+import { DEFAULT_MODEL, KIMI_MODEL } from './constants.js';
+import { validateApiKey } from './core/validate.js';
+import { getAdapter, listTools } from './adapters/registry.js';
+/**
+ * Разрешает значение модели:
+ * - undefined / пусто → DEFAULT_MODEL;
+ * - 'kimi' (регистронезависимо) → KIMI_MODEL;
+ * - любое другое → используется как явный id модели.
+ */
+function resolveModel(model) {
+    if (!model)
+        return DEFAULT_MODEL;
+    if (model.toLowerCase() === 'kimi')
+        return KIMI_MODEL;
+    return model;
+}
+/** Имя env-переменной с ключом для non-interactive режима. */
+const API_KEY_ENV = 'JOINGONKA_API_KEY';
+export async function run(options, deps) {
+    const scope = options.scope ?? 'user';
+    // 1. Выбор инструмента: явный --tool либо интерактивный select.
+    const toolId = options.tool ?? (await deps.askTool());
+    const adapter = getAdapter(toolId);
+    if (!adapter) {
+        const valid = listTools()
+            .map((t) => t.value)
+            .join(', ');
+        throw new Error(`Unknown tool: ${toolId}. Valid tools: ${valid}.`);
+    }
+    // 2. API-ключ. В non-interactive — ТОЛЬКО из env (никогда из CLI-аргумента:
+    //    аргумент попал бы в историю shell/процессов — это утечка секрета).
+    let apiKey;
+    if (options.nonInteractive) {
+        const fromEnv = process.env[API_KEY_ENV];
+        if (!fromEnv) {
+            throw new Error(`Non-interactive mode requires the ${API_KEY_ENV} environment variable (jg-...).`);
+        }
+        const valid = validateApiKey(fromEnv);
+        if (valid !== true) {
+            throw new Error(`Invalid ${API_KEY_ENV}: ${valid}`);
+        }
+        apiKey = fromEnv;
+    }
+    else {
+        apiKey = await deps.askApiKey();
+    }
+    // 3. Модель.
+    const model = resolveModel(options.model);
+    // 4. Применяем.
+    const result = await adapter.apply({ apiKey, model, scope });
+    return { toolId: adapter.id, result };
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA2B/D;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,aAAa,CAAC;IACjC,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8DAA8D;AAC9D,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAmB,EAAE,IAAa;IAC1D,MAAM,KAAK,GAAU,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;IAE7C,gEAAgE;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,SAAS,EAAE;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;aACnB,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,kBAAkB,KAAK,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,IAAI,MAAc,CAAC;IACnB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,qCAAqC,WAAW,iCAAiC,CAClF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,KAAK,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC;IAED,aAAa;IACb,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE1C,gBAAgB;IAChB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7D,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@joingonka/setup",
+  "version": "0.1.0",
+  "description": "One-command installer that points agentic AI tools (Claude Code, OpenClaw, Cline) at JoinGonka Gateway (decentralized AI inference)",
+  "type": "module",
+  "bin": {
+    "joingonka-setup": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "@inquirer/prompts": "^5.0.0",
+    "write-file-atomic": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/write-file-atomic": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "claude-code",
+    "openclaw",
+    "cline",
+    "anthropic",
+    "openai-compatible",
+    "ai",
+    "gonka",
+    "joingonka",
+    "cli",
+    "installer"
+  ],
+  "author": "JoinGonka <support@joingonka.ai>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unameisfine/joingonka-setup"
+  }
+}