@antonbabenko/deliberation-mcp 0.1.0 → 3.0.0

package/dist/setup.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+"use strict";
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// ../../core/paths.js
+var require_paths = __commonJS({
+  "../../core/paths.js"(exports2, module2) {
+    "use strict";
+    var os = require("node:os");
+    var path2 = require("node:path");
+    function resolveInjection(opts) {
+      return {
+        home: opts && opts.home || os.homedir(),
+        env: opts && opts.env || process.env,
+        platform: opts && opts.platform || process.platform
+      };
+    }
+    function isUsableBase(value, platform) {
+      if (typeof value !== "string" || value.length === 0) return false;
+      const impl = platform === "win32" ? path2.win32 : path2.posix;
+      return impl.isAbsolute(value);
+    }
+    function canonicalConfigDir(home, env, platform) {
+      if (platform === "win32") {
+        const appData = env.APPDATA;
+        const base2 = isUsableBase(appData, platform) ? appData : path2.join(home, "AppData", "Roaming");
+        return path2.join(base2, "deliberation");
+      }
+      const xdg = env.XDG_CONFIG_HOME;
+      const base = isUsableBase(xdg, platform) ? xdg : path2.join(home, ".config");
+      return path2.join(base, "deliberation");
+    }
+    function resolveConfigPath2(opts) {
+      const { home, env, platform } = resolveInjection(opts);
+      const override = env.DELIBERATION_CONFIG;
+      if (typeof override === "string" && override.length > 0) {
+        return override;
+      }
+      return path2.join(canonicalConfigDir(home, env, platform), "config.json");
+    }
+    function canonicalCacheDir(home, env, platform) {
+      if (platform === "win32") {
+        const localAppData = env.LOCALAPPDATA;
+        const base2 = isUsableBase(localAppData, platform) ? localAppData : path2.join(home, "AppData", "Local");
+        return path2.join(base2, "deliberation");
+      }
+      const xdg = env.XDG_CACHE_HOME;
+      const base = isUsableBase(xdg, platform) ? xdg : path2.join(home, ".cache");
+      return path2.join(base, "deliberation");
+    }
+    function resolveGrokCachePath(opts) {
+      const { home, env, platform } = resolveInjection(opts);
+      const override = env.DELIBERATION_CACHE;
+      if (typeof override === "string" && override.length > 0) {
+        return override;
+      }
+      return path2.join(canonicalCacheDir(home, env, platform), "grok-files.json");
+    }
+    function resolveSessionsDir(opts) {
+      const { home, env, platform } = resolveInjection(opts);
+      const override = env.DELIBERATION_SESSIONS;
+      if (typeof override === "string" && override.length > 0) {
+        return override;
+      }
+      return path2.join(canonicalCacheDir(home, env, platform), "sessions");
+    }
+    module2.exports = {
+      resolveConfigPath: resolveConfigPath2,
+      resolveGrokCachePath,
+      resolveSessionsDir
+    };
+  }
+});
+
+// setup.js
+var fs = require("node:fs");
+var path = require("node:path");
+var { resolveConfigPath } = require_paths();
+var SCHEMA_URL = "https://raw.githubusercontent.com/antonbabenko/deliberation/master/config/config.schema.json";
+var STARTER_CONFIG = {
+  $schema: SCHEMA_URL,
+  version: 1,
+  providers: {
+    codex: { enabled: true },
+    gemini: { enabled: true },
+    grok: { enabled: true, apiKeyEnv: "XAI_API_KEY" },
+    openrouter: {
+      enabled: false,
+      apiKeyEnv: "OPENROUTER_API_KEY",
+      apiBase: "https://openrouter.ai/api/v1",
+      allowRawModel: false,
+      defaultModel: "openai/gpt-4.1-mini",
+      defaults: { reasoningEffort: "high", temperature: 0.2, timeout: 12e4 }
+    }
+  },
+  models: {},
+  routing: { maxFanout: 3 },
+  consensus: { arbiter: "auto" }
+};
+function starterConfigText() {
+  return JSON.stringify(STARTER_CONFIG, null, 2) + "\n";
+}
+function openrouterExampleLines() {
+  return [
+    "Example model record (add under models, then set providers.openrouter.enabled: true):",
+    '  "claude-arb": { "provider": "openrouter", "model": "anthropic/claude-3.7-sonnet", "askAll": true, "consensus": true }',
+    'Then reference it as the arbiter with consensus.arbiter = { "model": "claude-arb" }.'
+  ];
+}
+function providerGuidanceLines() {
+  return [
+    "Provider setup:",
+    "  GPT (Codex)   - install the Codex CLI and run `codex login` (no env key).",
+    "  Gemini        - install Antigravity and run `agy` once to sign in (no env key).",
+    "  Grok (xAI)    - set XAI_API_KEY in the server env.",
+    "  OpenRouter    - set OPENROUTER_API_KEY and declare models in the config.",
+    "",
+    "Recommended cross-host arbiter: a dedicated Claude model record (an out-of-panel",
+    "model), so consensus is adjudicated by a model that is not one of the voting",
+    'providers. Set it with consensus.arbiter = { "model": "<your-record-id>" }.'
+  ];
+}
+function consensusBlockLines() {
+  return [
+    "Suggested consensus block (merge into your existing config):",
+    '  "consensus": { "arbiter": "auto" }'
+  ];
+}
+function runSetup(deps) {
+  const fsImpl = deps && deps.fsImpl || fs;
+  const env = deps && deps.env || process.env;
+  const out = deps && deps.out || ((line) => console.log(line));
+  const home = deps && deps.home;
+  const configPath = resolveConfigPath({ home, env });
+  const print = (lines) => {
+    for (const line of lines) out(line);
+  };
+  out("deliberation setup");
+  out("");
+  const fileExists = (p) => {
+    if (typeof fsImpl.existsSync === "function") {
+      try {
+        return fsImpl.existsSync(p);
+      } catch (_) {
+        return false;
+      }
+    }
+    try {
+      return fsImpl.statSync(p).isFile();
+    } catch (_) {
+      return false;
+    }
+  };
+  const leaveUnchanged = () => {
+    out(`Config already exists at ${configPath} - leaving it unchanged.`);
+    out("");
+    print(consensusBlockLines());
+    out("");
+    print(openrouterExampleLines());
+    out("");
+    print(providerGuidanceLines());
+    return 0;
+  };
+  let stat = null;
+  try {
+    stat = fsImpl.statSync(configPath);
+  } catch (_) {
+    stat = null;
+  }
+  if (stat) {
+    if (stat.isFile()) return leaveUnchanged();
+    out(`Config path ${configPath} is not a regular file - refusing to write.`);
+    return 1;
+  }
+  try {
+    fsImpl.mkdirSync(path.dirname(configPath), { recursive: true });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    out(`Could not create config directory ${path.dirname(configPath)}: ${message}`);
+    return 1;
+  }
+  try {
+    fsImpl.writeFileSync(configPath, starterConfigText(), { flag: "wx" });
+  } catch (err) {
+    const code = err && typeof err === "object" && "code" in err ? err.code : null;
+    if (code === "EEXIST") return leaveUnchanged();
+    const message = err instanceof Error ? err.message : String(err);
+    if (fileExists(configPath) && typeof fsImpl.unlinkSync === "function") {
+      try {
+        fsImpl.unlinkSync(configPath);
+      } catch (_) {
+      }
+    }
+    out(`Could not write config at ${configPath}: ${message}`);
+    return 1;
+  }
+  out(`Wrote starter config at ${configPath}.`);
+  out("");
+  print(openrouterExampleLines());
+  out("");
+  print(providerGuidanceLines());
+  out("");
+  out("Next: set the env keys for the providers you use, then point your MCP");
+  out("host at the deliberation server (npx -y @antonbabenko/deliberation-mcp).");
+  return 0;
+}
+module.exports = { runSetup, starterConfigText, STARTER_CONFIG };
+if (require.main === module) {
+  process.exit(runSetup());
+}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@antonbabenko/deliberation-mcp",
-  "version": "0.1.0",
+  "version": "3.0.0",
   "description": "Deliberation for Claude Code and any MCP host - GPT, Gemini, Grok, and OpenRouter expert subagents.",
   "mcpName": "io.github.antonbabenko/deliberation",
-  "bin": { "deliberation-mcp": "./dist/index.js" },
+  "bin": { "deliberation-mcp": "./dist/index.js", "deliberation-setup": "./dist/setup.js" },
   "main": "./dist/index.js",
   "files": ["dist/"],
   "engines": { "node": ">=18" },
   "scripts": {
-    "prepack": "esbuild index.js --bundle --platform=node --target=node18 --format=cjs --outfile=dist/index.js"
+    "prepack": "esbuild index.js setup.js --bundle --platform=node --target=node18 --format=cjs --outdir=dist"
   },
   "devDependencies": { "esbuild": "^0.28.0" },
   "license": "MIT"