konsul-ai 0.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yigit Yargili
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+<div align="center">
+  <br/>
+  <img src="assets/logo.png" alt="Konsul" width="600"/>
+  <br/><br/>
+  <p><strong>Ask multiple AI models, have them blind-review each other, get one synthesized answer.</strong></p>
+
+  ![Build](https://img.shields.io/badge/build-passing-brightgreen)
+  ![Release](https://img.shields.io/badge/release-v0.2.4-blue)
+  ![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)
+  ![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6)
+  ![Dependencies](https://img.shields.io/badge/runtime_deps-0-brightgreen)
+  ![License](https://img.shields.io/badge/license-MIT-blue)
+</div>
+
+---
+
+## How It Works
+
+Your question goes through a three-stage pipeline:
+
+1. **Gather** — all council members answer your question in parallel
+2. **Review** — each model blind-reviews the others (anonymized as A, B, C...) and ranks them
+3. **Synthesize** — the chair model reads all opinions + scores and streams a final answer
+
+Models can't see who wrote what, preventing brand-name bias.
+
+## Quick Start
+
+```bash
+npx konsul-ai "What causes inflation?"       # run directly, no install
+# or install globally
+npm install -g konsul-ai
+```
+
+Set your API key ([openrouter.ai](https://openrouter.ai) — $5 in credits is plenty):
+
+```bash
+export OPENROUTER_API_KEY=sk-or-v1-...
+# or create a .env file in the working directory
+echo "OPENROUTER_API_KEY=sk-or-v1-..." > .env
+```
+
+<details><summary>Install from source</summary>
+
+```bash
+git clone https://github.com/yigityargili991/konsul.git
+cd konsul
+npm install && npm run build && npm link
+```
+
+</details>
+
+## Usage
+
+```bash
+konsul "What causes inflation?"              # balanced preset (default)
+konsul --budget "Explain quantum entanglement"
+konsul --premium "Compare Rust vs Go"
+konsul --serve                               # web UI at localhost:3000
+konsul                                       # interactive REPL
+```
+
+### Presets
+
+| Flag | Members | Chair | ~Cost |
+|------|---------|-------|-------|
+| `--free` | Hermes 405B, GPT-OSS 120B, Nemotron 120B, Llama 3.3 70B | Trinity Large | $0 |
+| `--budget` | DeepSeek V3.2, Gemini Flash Lite, Llama 4 Scout, Mistral Small 4 | DeepSeek V3.2 | $0.002 |
+| `--balanced` | DeepSeek V3.2, Gemini Flash, Llama 4 Maverick, GPT-5.4 Mini | Gemini 2.5 Pro | $0.05 |
+| `--premium` | Sonnet 4.6, GPT-5.4, Gemini Pro, DeepSeek R1 | Claude Opus 4.6 | $0.30+ |
+
+### Custom Councils
+
+```bash
+konsul --chair opus "Best neuroscience books?"
+konsul --members deepseekV3,sonnet,gpt4o --chair opus "Compare React vs Svelte"
+konsul --chair xiaomi/mimo-v2-pro "Hello"    # any OpenRouter model ID works
+konsul --premium --rounds 3 "Is consciousness computable?"
+```
+
+### Interactive Mode
+
+Start with `konsul` (no arguments). Commands: `/tier <name>`, `/new-team`, `/web`, `/verbose`, `/clear`, `/quit`.
+
+### Other Flags
+
+```bash
+konsul --output result.json "question"       # save full results as JSON
+konsul --verbose "question"                  # show individual opinions
+konsul --models                              # list available models
+```
+
+## Development
+
+```bash
+npm run dev      # run with tsx (no build step)
+npm test         # build + run tests
+npm run build    # compile TypeScript → dist/
+```

package/dist/abort.d.ts

@@ -0,0 +1,3 @@
+export declare function isAbortError(reason: unknown): reason is Error;
+export declare function normalizeAbortReason(reason: unknown, fallbackMessage?: string): DOMException;
+export declare function combineSignals(...signals: (AbortSignal | undefined)[]): AbortSignal | undefined;

package/dist/abort.js

@@ -0,0 +1,20 @@
+export function isAbortError(reason) {
+    return reason instanceof Error && reason.name === "AbortError";
+}
+export function normalizeAbortReason(reason, fallbackMessage = "Aborted") {
+    if (reason instanceof DOMException && reason.name === "AbortError") {
+        return reason;
+    }
+    const message = reason instanceof Error ? (reason.message || fallbackMessage) :
+        reason == null ? fallbackMessage :
+            String(reason) || fallbackMessage;
+    return new DOMException(message, "AbortError");
+}
+export function combineSignals(...signals) {
+    const active = signals.filter((signal) => !!signal);
+    if (active.length === 0)
+        return undefined;
+    if (active.length === 1)
+        return active[0];
+    return AbortSignal.any(active);
+}

package/dist/config.d.ts

@@ -0,0 +1,182 @@
+import type { CouncilConfig } from "./types.js";
+export declare const MODELS: {
+    deepseekV3: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    geminiFlash: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    qwen35_27b: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    llamaScout: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    mistralSmall: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    gpt54Nano: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    geminiFlashLite: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    deepseekR1: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    gpt54Mini: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    qwen3Max: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    llamaMaverick: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    gpt4o: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    sonnet4: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    sonnet46: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    geminiPro: {
+        id: string;
+        label: string;
+        role: "chair";
+    };
+    gpt54: {
+        id: string;
+        label: string;
+        role: "chair";
+    };
+    gemini31Pro: {
+        id: string;
+        label: string;
+        role: "chair";
+    };
+    opus: {
+        id: string;
+        label: string;
+        role: "chair";
+    };
+    gpt52: {
+        id: string;
+        label: string;
+        role: "chair";
+    };
+    hermes405b: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    gptOss120b: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    nemotron120b: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    llama70b: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    trinityLarge: {
+        id: string;
+        label: string;
+        role: "chair";
+    };
+    gemma27b: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    mistralSmall31: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+    stepFlash: {
+        id: string;
+        label: string;
+        role: "member";
+    };
+};
+export declare const FALLBACKS: Record<string, string>;
+/** Look up a human-readable label for a model ID. */
+export declare function labelFor(modelId: string): string;
+/**
+ * ~$0.002 per council run. All ultra-cheap models.
+ * Members: DeepSeek V3.2, Gemini 2.5 Flash Lite, Llama 4 Scout, Mistral Small 4
+ * Chair: DeepSeek V3.2 (best reasoning at this price point)
+ *
+ * Academic strengths: DeepSeek V3.2 has IMO gold-medal reasoning; Llama 4 Scout
+ * provides massive context for long papers; diversity across 4 different providers.
+ */
+export declare const PRESET_BUDGET: CouncilConfig;
+/**
+ * ~$0.05 per run. Cheap members with a strong frontier chair.
+ * Members: DeepSeek V3.2, Gemini 2.5 Flash, Llama 4 Maverick, GPT-5.4 Mini
+ * Chair: Gemini 2.5 Pro (#1 LMArena, $1.25/$10)
+ *
+ * Academic strengths: Four diverse reasoning engines feed into Gemini 2.5 Pro,
+ * which excels at scientific reasoning and synthesis. Best bang for buck.
+ */
+export declare const PRESET_BALANCED: CouncilConfig;
+/**
+ * ~$0.30+ per run. Frontier models everywhere.
+ * Members: Claude Sonnet 4.6, GPT-5.4, Gemini 2.5 Pro, DeepSeek R1
+ * Chair: Claude Opus 4.6 (#1 Chatbot Arena Elo 1505, best synthesis)
+ *
+ * Academic strengths: Every member is a top-10 reasoning model. DeepSeek R1
+ * provides explicit chain-of-thought reasoning. Claude Opus 4.6 as chair
+ * produces the most polished, well-structured academic prose. 2 review rounds
+ * for maximum quality.
+ */
+export declare const PRESET_PREMIUM: CouncilConfig;
+/**
+ * $0 per run. All free OpenRouter models.
+ * Members: Hermes 405B, GPT-OSS 120B, Nemotron 120B, Llama 3.3 70B
+ * Chair: Trinity Large (400B MoE)
+ *
+ * Academic strengths: Hermes 405B is the largest free model; GPT-OSS 120B
+ * and Nemotron 120B provide diversity; Trinity Large chairs with frontier-scale
+ * MoE reasoning. Rate-limited but zero cost.
+ */
+export declare const PRESET_FREE: CouncilConfig;
+export declare const PRESETS: Record<string, CouncilConfig>;
+export declare const DEFAULT_PRESET = "balanced";

package/dist/config.js

@@ -0,0 +1,218 @@
+// ── Model catalog ──────────────────────────────────────────────
+// Verified against OpenRouter API — March 2026.
+// Prices are per million tokens (input/output).
+// The `id` is the exact OpenRouter model string.
+//
+// Selection criteria for academic research:
+//   - Reasoning benchmarks (GPQA, AIME, MATH-500, MMLU-Pro)
+//   - Factual accuracy & citation awareness
+//   - Clear, structured academic writing
+//   - LMSYS Chatbot Arena rankings (March 2026)
+export const MODELS = {
+    // ── Budget tier ──────────────────────────────────────────────
+    // Ultra-cheap models that still score well on reasoning benchmarks.
+    // DeepSeek V3.2 — $0.26/$0.38 — 164K ctx — IMO/IOI gold medal reasoning,
+    // GPT-5-class benchmarks. Best value reasoning model available.
+    deepseekV3: { id: "deepseek/deepseek-v3.2", label: "DeepSeek V3.2", role: "member" },
+    // Gemini 2.5 Flash — $0.30/$2.50 — 1M ctx — Google's fast reasoning model
+    // with thinking capabilities. Strong on GPQA and MATH-500.
+    geminiFlash: { id: "google/gemini-2.5-flash", label: "Gemini 2.5 Flash", role: "member" },
+    // Qwen3.5 27B — $0.195/$1.56 — 262K ctx — Dense vision-language model
+    // with reasoning support. Strong multilingual academic coverage.
+    qwen35_27b: { id: "qwen/qwen3.5-27b", label: "Qwen3.5 27B", role: "member" },
+    // Llama 4 Scout — $0.08/$0.30 — 328K ctx — Meta's MoE model (17B active /
+    // 109B total). Strong general knowledge, massive context window.
+    llamaScout: { id: "meta-llama/llama-4-scout", label: "Llama 4 Scout", role: "member" },
+    // Mistral Small 4 — $0.15/$0.60 — 262K ctx — Combines Magistral reasoning
+    // + Pixtral multimodal. Great cheap all-rounder (March 2026 release).
+    mistralSmall: { id: "mistralai/mistral-small-2603", label: "Mistral Small 4", role: "member" },
+    // GPT-5.4 Nano — $0.20/$1.25 — 400K ctx — OpenAI's cheapest 5-series model.
+    // Configurable reasoning effort. Good for high-volume member role.
+    gpt54Nano: { id: "openai/gpt-5.4-nano", label: "GPT-5.4 Nano", role: "member" },
+    // Gemini 2.5 Flash Lite — $0.10/$0.40 — 1M ctx — Cheapest Google model
+    // with optional reasoning. Ultra-fast, decent quality.
+    geminiFlashLite: { id: "google/gemini-2.5-flash-lite", label: "Gemini 2.5 Flash Lite", role: "member" },
+    // ── Mid tier ─────────────────────────────────────────────────
+    // Strong models at moderate cost — good as members or budget chairs.
+    // DeepSeek R1 0528 — $0.45/$2.15 — 164K ctx — Dedicated reasoning model
+    // with open chain-of-thought. On par with OpenAI o1 on math/science.
+    deepseekR1: { id: "deepseek/deepseek-r1-0528", label: "DeepSeek R1", role: "member" },
+    // GPT-5.4 Mini — $0.75/$4.50 — 400K ctx — Core GPT-5.4 capabilities at
+    // half the price. Strong reasoning with configurable effort levels.
+    gpt54Mini: { id: "openai/gpt-5.4-mini", label: "GPT-5.4 Mini", role: "member" },
+    // Qwen3 Max Thinking — $0.78/$3.90 — 262K ctx — Flagship Qwen reasoning
+    // model. Deep multi-step reasoning via reinforcement learning.
+    qwen3Max: { id: "qwen/qwen3-max-thinking", label: "Qwen3 Max", role: "member" },
+    // Llama 4 Maverick — $0.15/$0.60 — 1M ctx — Meta's large MoE (17B active /
+    // 400B total, 128 experts). Excellent multilingual + multimodal.
+    llamaMaverick: { id: "meta-llama/llama-4-maverick", label: "Llama 4 Maverick", role: "member" },
+    // ── Strong tier ──────────────────────────────────────────────
+    // Frontier models — best as chair or premium members.
+    // GPT-4o — $2.50/$10 — 128K ctx — Still a solid frontier model, now
+    // cheaper than newer GPT-5 variants. Good mid-price chair.
+    gpt4o: { id: "openai/gpt-4o", label: "GPT-4o", role: "member" },
+    // Claude Sonnet 4 — $3/$15 — 200K ctx — Anthropic's workhorse.
+    // Top-tier instruction following and structured academic writing.
+    sonnet4: { id: "anthropic/claude-sonnet-4", label: "Claude Sonnet 4", role: "member" },
+    // Claude Sonnet 4.6 — $3/$15 — 1M ctx — Latest Sonnet with 1M context.
+    // Frontier coding + reasoning. Excellent for academic synthesis.
+    sonnet46: { id: "anthropic/claude-sonnet-4.6", label: "Claude Sonnet 4.6", role: "member" },
+    // Gemini 2.5 Pro — $1.25/$10 — 1M ctx — #1 on LMArena leaderboard.
+    // Top-tier reasoning across math, science, and coding benchmarks.
+    geminiPro: { id: "google/gemini-2.5-pro", label: "Gemini 2.5 Pro", role: "chair" },
+    // GPT-5.4 — $2.50/$15 — 400K ctx — OpenAI's latest unified frontier model
+    // (March 2026). Strong across all academic reasoning benchmarks.
+    gpt54: { id: "openai/gpt-5.4", label: "GPT-5.4", role: "chair" },
+    // Gemini 3.1 Pro — $2/$12 — 1M ctx — Google's frontier reasoning model
+    // (March 2026). #1 high-Elo on Chatbot Arena. Enhanced agentic reliability.
+    gemini31Pro: { id: "google/gemini-3.1-pro-preview", label: "Gemini 3.1 Pro", role: "chair" },
+    // Claude Opus 4.6 — $5/$25 — 200K ctx — Anthropic's most capable model.
+    // #1 on Chatbot Arena (Elo 1505). Best for complex academic synthesis.
+    opus: { id: "anthropic/claude-opus-4.6", label: "Claude Opus 4.6", role: "chair" },
+    // GPT-5.2 — $1.75/$14 — 400K ctx — Strong frontier model, statistical
+    // dead heat with Claude 4.6 for #1 on general Arena rankings.
+    gpt52: { id: "openai/gpt-5.2", label: "GPT-5.2", role: "chair" },
+    // ── Free tier ───────────────────────────────────────────────
+    // OpenRouter free models ($0/$0). Rate-limited but zero cost.
+    // Best picks for academic research from the free pool.
+    // Hermes 3 Llama 3.1 405B — 405B params, 131K ctx — Largest free model.
+    // Strong general knowledge and reasoning via enhanced agentic tuning.
+    hermes405b: { id: "nousresearch/hermes-3-llama-3.1-405b:free", label: "Hermes 405B", role: "member" },
+    // GPT-OSS 120B — 117B MoE, 131K ctx — OpenAI open-weight model.
+    // High reasoning benchmarks, good structured output.
+    gptOss120b: { id: "openai/gpt-oss-120b:free", label: "GPT-OSS 120B", role: "member" },
+    // Nemotron 120B — 120B MoE (12B active), 262K ctx — Large context,
+    // compute-efficient. Strong accuracy on academic benchmarks.
+    nemotron120b: { id: "nvidia/nemotron-3-super-120b-a12b:free", label: "Nemotron 120B", role: "member" },
+    // Llama 3.3 70B — 70B params, 65K ctx — Solid reasoning,
+    // well-tested, strong multilingual coverage.
+    llama70b: { id: "meta-llama/llama-3.3-70b-instruct:free", label: "Llama 3.3 70B", role: "member" },
+    // Trinity Large — 400B MoE, 131K ctx — Frontier-scale sparse MoE.
+    // Strong general reasoning, good as a free chair.
+    trinityLarge: { id: "arcee-ai/trinity-large-preview:free", label: "Trinity Large", role: "chair" },
+    // ── Free fallback-only models ──────────────────────────────
+    // Not in presets, but available as fallback targets from different providers.
+    // Gemma 3 27B — Google, 27B params, 131K ctx — Best Google free model.
+    gemma27b: { id: "google/gemma-3-27b-it:free", label: "Gemma 3 27B", role: "member" },
+    // Mistral Small 3.1 — Mistral, 24B params, 128K ctx — Solid all-rounder.
+    mistralSmall31: { id: "mistralai/mistral-small-3.1-24b-instruct:free", label: "Mistral Small 3.1", role: "member" },
+    // Step 3.5 Flash — StepFun, MoE, 256K ctx — Large context, strong reasoning.
+    stepFlash: { id: "stepfun/step-3.5-flash:free", label: "Step 3.5 Flash", role: "member" },
+};
+// ── Fallback models ───────────────────────────────────────────────
+// When a model fails or times out, retry with a different-provider alternative.
+// Each mapping targets a model at a similar tier from another provider.
+export const FALLBACKS = {
+    // Budget → cross-provider fallbacks
+    "deepseek/deepseek-v3.2": "meta-llama/llama-4-maverick",
+    "google/gemini-2.5-flash": "openai/gpt-5.4-nano",
+    "qwen/qwen3.5-27b": "mistralai/mistral-small-2603",
+    "meta-llama/llama-4-scout": "mistralai/mistral-small-2603",
+    "mistralai/mistral-small-2603": "meta-llama/llama-4-scout",
+    "openai/gpt-5.4-nano": "google/gemini-2.5-flash",
+    "google/gemini-2.5-flash-lite": "meta-llama/llama-4-scout",
+    // Mid → cross-provider fallbacks
+    "deepseek/deepseek-r1-0528": "qwen/qwen3-max-thinking",
+    "openai/gpt-5.4-mini": "google/gemini-2.5-flash",
+    "qwen/qwen3-max-thinking": "deepseek/deepseek-r1-0528",
+    "meta-llama/llama-4-maverick": "deepseek/deepseek-v3.2",
+    // Strong → cross-provider fallbacks
+    "openai/gpt-4o": "openai/gpt-5.4-mini",
+    "anthropic/claude-sonnet-4": "openai/gpt-5.4",
+    "anthropic/claude-sonnet-4.6": "openai/gpt-5.4",
+    "google/gemini-2.5-pro": "google/gemini-3.1-pro-preview",
+    "openai/gpt-5.4": "google/gemini-2.5-pro",
+    "google/gemini-3.1-pro-preview": "google/gemini-2.5-pro",
+    "anthropic/claude-opus-4.6": "openai/gpt-5.4",
+    "openai/gpt-5.2": "google/gemini-2.5-pro",
+    // Free → free fallbacks (no circular chains, always cross-provider)
+    // Venice-hosted models (Hermes, Llama 3.3) fall back to Google/Mistral/Qwen
+    "nousresearch/hermes-3-llama-3.1-405b:free": "google/gemma-3-27b-it:free",
+    "meta-llama/llama-3.3-70b-instruct:free": "mistralai/mistral-small-3.1-24b-instruct:free",
+    // NVIDIA/OpenAI free models fall back to Qwen/Google
+    "openai/gpt-oss-120b:free": "stepfun/step-3.5-flash:free",
+    "nvidia/nemotron-3-super-120b-a12b:free": "google/gemma-3-27b-it:free",
+    // Chair & fallback-only models → different providers
+    "arcee-ai/trinity-large-preview:free": "stepfun/step-3.5-flash:free",
+    "google/gemma-3-27b-it:free": "mistralai/mistral-small-3.1-24b-instruct:free",
+    "mistralai/mistral-small-3.1-24b-instruct:free": "stepfun/step-3.5-flash:free",
+    "stepfun/step-3.5-flash:free": "nvidia/nemotron-3-super-120b-a12b:free",
+};
+/** Look up a human-readable label for a model ID. */
+export function labelFor(modelId) {
+    const entry = Object.values(MODELS).find((m) => m.id === modelId);
+    if (entry)
+        return entry.label;
+    const name = modelId.split("/").pop() ?? modelId;
+    return name.replace(/:free$/, "").replace(/-/g, " ").replace(/\b\w/g, (ch) => ch.toUpperCase());
+}
+// ── Presets ─────────────────────────────────────────────────────
+// Cost estimates assume ~1500 input + ~800 output tokens per member call,
+// ~3000 input + ~500 output per review call, and ~5000 input + ~2000 output
+// for the chair synthesis. Total ≈ 4 member + 4 review + 1 synthesis calls.
+/**
+ * ~$0.002 per council run. All ultra-cheap models.
+ * Members: DeepSeek V3.2, Gemini 2.5 Flash Lite, Llama 4 Scout, Mistral Small 4
+ * Chair: DeepSeek V3.2 (best reasoning at this price point)
+ *
+ * Academic strengths: DeepSeek V3.2 has IMO gold-medal reasoning; Llama 4 Scout
+ * provides massive context for long papers; diversity across 4 different providers.
+ */
+export const PRESET_BUDGET = {
+    members: [MODELS.deepseekV3, MODELS.geminiFlashLite, MODELS.llamaScout, MODELS.mistralSmall],
+    chair: MODELS.deepseekV3,
+    rounds: 1,
+    temperature: 0.7,
+};
+/**
+ * ~$0.05 per run. Cheap members with a strong frontier chair.
+ * Members: DeepSeek V3.2, Gemini 2.5 Flash, Llama 4 Maverick, GPT-5.4 Mini
+ * Chair: Gemini 2.5 Pro (#1 LMArena, $1.25/$10)
+ *
+ * Academic strengths: Four diverse reasoning engines feed into Gemini 2.5 Pro,
+ * which excels at scientific reasoning and synthesis. Best bang for buck.
+ */
+export const PRESET_BALANCED = {
+    members: [MODELS.deepseekV3, MODELS.geminiFlash, MODELS.llamaMaverick, MODELS.gpt54Mini],
+    chair: MODELS.geminiPro,
+    rounds: 1,
+    temperature: 0.7,
+};
+/**
+ * ~$0.30+ per run. Frontier models everywhere.
+ * Members: Claude Sonnet 4.6, GPT-5.4, Gemini 2.5 Pro, DeepSeek R1
+ * Chair: Claude Opus 4.6 (#1 Chatbot Arena Elo 1505, best synthesis)
+ *
+ * Academic strengths: Every member is a top-10 reasoning model. DeepSeek R1
+ * provides explicit chain-of-thought reasoning. Claude Opus 4.6 as chair
+ * produces the most polished, well-structured academic prose. 2 review rounds
+ * for maximum quality.
+ */
+export const PRESET_PREMIUM = {
+    members: [MODELS.sonnet46, MODELS.gpt54, MODELS.geminiPro, MODELS.deepseekR1],
+    chair: MODELS.opus,
+    rounds: 2,
+    temperature: 0.5,
+};
+/**
+ * $0 per run. All free OpenRouter models.
+ * Members: Hermes 405B, GPT-OSS 120B, Nemotron 120B, Llama 3.3 70B
+ * Chair: Trinity Large (400B MoE)
+ *
+ * Academic strengths: Hermes 405B is the largest free model; GPT-OSS 120B
+ * and Nemotron 120B provide diversity; Trinity Large chairs with frontier-scale
+ * MoE reasoning. Rate-limited but zero cost.
+ */
+export const PRESET_FREE = {
+    members: [MODELS.hermes405b, MODELS.gptOss120b, MODELS.nemotron120b, MODELS.llama70b],
+    chair: MODELS.trinityLarge,
+    rounds: 1,
+    temperature: 0.7,
+};
+export const PRESETS = {
+    free: PRESET_FREE,
+    budget: PRESET_BUDGET,
+    balanced: PRESET_BALANCED,
+    premium: PRESET_PREMIUM,
+};
+export const DEFAULT_PRESET = "balanced";

package/dist/council.d.ts

@@ -0,0 +1,31 @@
+import type { CouncilConfig, CouncilResult, Opinion, Review, RouterMessage } from "./types.js";
+import { Router } from "./router.js";
+export declare class Council {
+    private router;
+    private config;
+    private log;
+    private onStream?;
+    private history;
+    constructor(router: Router, config: CouncilConfig, log?: (msg: string) => void, onStream?: (chunk: string) => void);
+    get streaming(): boolean;
+    private get webPlugins();
+    /** Auto-stagger free models to avoid rate-limit storms. */
+    private get staggerMs();
+    toggleWeb(): boolean;
+    clearHistory(): void;
+    getHistory(): RouterMessage[];
+    setHistory(history: RouterMessage[]): void;
+    /** Drop oldest user/assistant pairs until history fits within the token budget. */
+    private trimHistory;
+    /** Try fn with model; on failure, retry once with the configured fallback. */
+    private withFallback;
+    run(query: string, signal?: AbortSignal): Promise<CouncilResult>;
+    private gatherOpinions;
+    private peerReview;
+    private synthesize;
+}
+export declare function aggregateScores(opinions: Opinion[], reviews: Review[]): {
+    modelId: string;
+    label: string;
+    avgRank: number;
+}[];