big-tools 0.0.1

package/dist/commands/selfish-explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfish-explorer.js","sourceRoot":"","sources":["../../src/commands/selfish-explorer.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAA4B;IAC9E,yFAAyF;IACzF,yEAAyE;IACzE,iEAAiE;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,kDAAkD,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/lib/big-template.js

@@ -0,0 +1,165 @@
+/**
+ * BIG Idea Explorer template.
+ *
+ * Encodes Carl Moore's 1987 methodology (NGT, Ideawriting, Delphi, ISM)
+ * as a PLM template for structured ideation. Originally designed for
+ * Brown Practicum students.
+ *
+ * Four phases: Generate → Develop → Select → Promote
+ *
+ * Source: DEVO packages/plm/src/templates/big-idea-explorer.ts
+ * Canonical faculty-endorsed phase names from the 2026-04-06 M/V/V rework
+ * (see DevLex memory/project_brown_practicum.md lines 73-95).
+ */
+export const bigIdeaExplorerTemplate = {
+    id: "big-idea-explorer",
+    name: "BIG Idea Explorer",
+    description: "Structured ideation using Carl Moore's BIG methodology (NGT, Ideawriting, Delphi, ISM). " +
+        "Four phases guide you from problem space mapping through idea development, evaluation, and presentation.",
+    category: "methodology",
+    seedMandate: {
+        description: "Explore and develop innovative ideas through structured ideation. " +
+            "Map the problem space, develop ideas with diverse perspectives, evaluate rigorously, and produce shareable artifacts.",
+        goals: [
+            "Map what I know, don't know, and am assuming about the problem space",
+            "Develop ideas through multi-perspective fireside chat exploration",
+            "Evaluate ideas by feasibility, novelty, and supporting evidence",
+            "Produce structured artifacts (hypothesis cards, evidence summaries) for sharing",
+        ],
+    },
+    interactionPatterns: [
+        {
+            id: "generate",
+            phase: "Generate",
+            name: "Problem Space Mapping",
+            description: "Silent generation + expansion, mirroring Nominal Group Technique (NGT). " +
+                "Systematically map what you know, don't know, and are assuming.",
+            prompts: [
+                "What do you already know about this problem space? List everything — facts, observations, prior experience.",
+                "What don't you know? What questions remain unanswered? What data is missing?",
+                "What are you assuming? Which of your 'knowns' might actually be assumptions?",
+                "Looking at your assumptions, which ones would change your approach most if they turned out to be wrong?",
+            ],
+            completionSignal: "Problem space mapped with knowns, unknowns, and assumptions identified",
+            activeAgents: ["corpus-search", "literature-review"],
+        },
+        {
+            id: "develop",
+            phase: "Develop",
+            name: "Fireside Chat",
+            description: "Multi-perspective idea development using a panel of personas. " +
+                "3 user-chosen + 2 AI-suggested domain experts explore the problem together.",
+            prompts: [
+                "Choose 3 perspectives you want at the table (e.g., 'skeptical engineer', 'end user', 'investor').",
+                "Based on your problem space, I suggest adding these 2 perspectives: [AI-generated based on domain].",
+                "Let's explore: each perspective shares their reaction to the problem space map.",
+                "What new connections emerged? What surprised you?",
+            ],
+            completionSignal: "Ideas developed through multi-perspective exploration",
+            activeAgents: ["multi-llm-consultation", "patent-search", "red-team"],
+        },
+        {
+            id: "select",
+            phase: "Select",
+            name: "Evaluate & Converge",
+            description: "Score ideas by feasibility, novelty, and evidence strength. " +
+                "Red-team promising ideas. Kill or promote.",
+            prompts: [
+                "Let's evaluate each idea. For each: how feasible? how novel? what evidence supports it?",
+                "Which ideas should we red-team? What's the strongest argument against each?",
+                "Based on evaluation, which ideas do we kill, which do we promote?",
+            ],
+            completionSignal: "Ideas evaluated and filtered — promoted ideas identified",
+            activeAgents: ["red-team", "corpus-search"],
+        },
+        {
+            id: "promote",
+            phase: "Promote",
+            name: "Share & Present",
+            description: "Generate structured artifacts for external presentation — " +
+                "hypothesis cards, evidence summaries, and presentation outlines.",
+            prompts: [
+                "For each promoted idea, let's create a hypothesis card: claim, evidence, confidence, next steps.",
+                "What's the narrative arc? How do these ideas connect into a compelling story?",
+                "Generate a shareable summary for your audience.",
+            ],
+            completionSignal: "Artifacts generated and ready for sharing",
+            activeAgents: ["corpus-search"],
+        },
+    ],
+    agentPresets: [
+        {
+            id: "patent-search",
+            name: "Patent Search",
+            role: "Prior art discovery",
+            description: "Searches patent databases for related innovations and prior art",
+            templateId: "patent-search-agent",
+        },
+        {
+            id: "multi-llm-consultation",
+            name: "Multi-LLM Consultation",
+            role: "Cross-model ideation",
+            description: "Consults multiple LLMs for diverse perspectives on the problem",
+            templateId: "multi-llm-agent",
+        },
+        {
+            id: "red-team",
+            name: "Red Team",
+            role: "Critical evaluation",
+            description: "Challenges ideas with counterarguments and identifies weaknesses",
+            templateId: "red-team-agent",
+        },
+        {
+            id: "corpus-search",
+            name: "Corpus Search",
+            role: "Knowledge retrieval",
+            description: "Searches the PLM's corpus for relevant prior knowledge and connections",
+            templateId: "corpus-search-agent",
+        },
+        {
+            id: "literature-review",
+            name: "Literature Review",
+            role: "Academic research",
+            description: "Searches academic databases for relevant research papers and findings",
+            templateId: "literature-review-agent",
+        },
+    ],
+    trailSeeds: [
+        "innovation methodology",
+        "problem framing techniques",
+        "idea evaluation criteria",
+        "structured ideation",
+        "design thinking",
+    ],
+    suggestedSources: [
+        {
+            name: "Google Scholar Alerts",
+            type: "rss",
+            config: { feedUrl: "" },
+            description: "Set up Google Scholar alerts for your research domain (configure after creation)",
+        },
+        {
+            name: "Industry Publications",
+            type: "rss",
+            config: { feedUrl: "" },
+            description: "Add RSS feeds from publications relevant to your problem domain",
+        },
+    ],
+    author: "Private Language",
+    version: "1.0.0",
+    tags: ["ideation", "big-methodology", "carl-moore", "ngt", "brown-practicum"],
+};
+/**
+ * Lookup helper — get one interaction pattern by phase id.
+ *
+ * Added for big-tools command layer: each CLI subcommand can fetch its
+ * phase-specific guided prompts without the caller iterating the array.
+ */
+export function getPhase(phaseId) {
+    const pattern = bigIdeaExplorerTemplate.interactionPatterns.find((p) => p.id === phaseId);
+    if (!pattern) {
+        throw new Error(`BIG template missing phase: ${phaseId}`);
+    }
+    return pattern;
+}
+//# sourceMappingURL=big-template.js.map

package/dist/lib/big-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-template.js","sourceRoot":"","sources":["../../src/lib/big-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAAgB;IAClD,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,0FAA0F;QAC1F,0GAA0G;IAC5G,QAAQ,EAAE,aAAa;IACvB,WAAW,EAAE;QACX,WAAW,EACT,oEAAoE;YACpE,uHAAuH;QACzH,KAAK,EAAE;YACL,sEAAsE;YACtE,mEAAmE;YACnE,iEAAiE;YACjE,iFAAiF;SAClF;KACF;IACD,mBAAmB,EAAE;QACnB;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,0EAA0E;gBAC1E,iEAAiE;YACnE,OAAO,EAAE;gBACP,6GAA6G;gBAC7G,8EAA8E;gBAC9E,8EAA8E;gBAC9E,yGAAyG;aAC1G;YACD,gBAAgB,EAAE,wEAAwE;YAC1F,YAAY,EAAE,CAAC,eAAe,EAAE,mBAAmB,CAAC;SACrD;QACD;YACE,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,gEAAgE;gBAChE,6EAA6E;YAC/E,OAAO,EAAE;gBACP,mGAAmG;gBACnG,qGAAqG;gBACrG,iFAAiF;gBACjF,mDAAmD;aACpD;YACD,gBAAgB,EAAE,uDAAuD;YACzE,YAAY,EAAE,CAAC,wBAAwB,EAAE,eAAe,EAAE,UAAU,CAAC;SACtE;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EACT,8DAA8D;gBAC9D,4CAA4C;YAC9C,OAAO,EAAE;gBACP,yFAAyF;gBACzF,6EAA6E;gBAC7E,mEAAmE;aACpE;YACD,gBAAgB,EAAE,0DAA0D;YAC5E,YAAY,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;SAC5C;QACD;YACE,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,4DAA4D;gBAC5D,kEAAkE;YACpE,OAAO,EAAE;gBACP,kGAAkG;gBAClG,+EAA+E;gBAC/E,iDAAiD;aAClD;YACD,gBAAgB,EAAE,2CAA2C;YAC7D,YAAY,EAAE,CAAC,eAAe,CAAC;SAChC;KACF;IACD,YAAY,EAAE;QACZ;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,iEAAiE;YAC9E,UAAU,EAAE,qBAAqB;SAClC;QACD;YACE,EAAE,EAAE,wBAAwB;YAC5B,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,gEAAgE;YAC7E,UAAU,EAAE,iBAAiB;SAC9B;QACD;YACE,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,kEAAkE;YAC/E,UAAU,EAAE,gBAAgB;SAC7B;QACD;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,wEAAwE;YACrF,UAAU,EAAE,qBAAqB;SAClC;QACD;YACE,EAAE,EAAE,mBAAmB;YACvB,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,uEAAuE;YACpF,UAAU,EAAE,yBAAyB;SACtC;KACF;IACD,UAAU,EAAE;QACV,wBAAwB;QACxB,4BAA4B;QAC5B,0BAA0B;QAC1B,qBAAqB;QACrB,iBAAiB;KAClB;IACD,gBAAgB,EAAE;QAChB;YACE,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACvB,WAAW,EAAE,kFAAkF;SAChG;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACvB,WAAW,EAAE,iEAAiE;SAC/E;KACF;IACD,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,CAAC;CAC9E,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAsD;IAEtD,MAAM,OAAO,GAAG,uBAAuB,CAAC,mBAAmB,CAAC,IAAI,CAC9D,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CACxB,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/config-store.js

@@ -0,0 +1,64 @@
+/**
+ * Config file I/O for big-tools.
+ *
+ * Owns ~/.config/big-tools/config.json (or XDG_CONFIG_HOME override).
+ * Atomic writes via tmp+rename. Mode 0o600 for API key safety.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Resolved directory for config files. Accepts override for testing. */
+export function configDir(override) {
+    if (override)
+        return override;
+    const base = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+    return join(base, "big-tools");
+}
+/** Full path to config.json. */
+export function configPath(dirOverride) {
+    return join(configDir(dirOverride), "config.json");
+}
+/** Read the entire config. Returns {} if file does not exist. */
+export function readConfig(dirOverride) {
+    const p = configPath(dirOverride);
+    if (!existsSync(p))
+        return {};
+    const raw = readFileSync(p, "utf-8");
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        throw new Error(`Config file is not valid JSON: ${p}\n` +
+            `Delete it and re-run: big-tools config set <key> <value>`);
+    }
+}
+/** Write a single key. Creates directory + file if absent. Atomic rename. */
+export function writeConfig(key, value, dirOverride) {
+    const dir = configDir(dirOverride);
+    const p = configPath(dirOverride);
+    const data = readConfig(dirOverride);
+    data[key] = value;
+    flush(p, dir, data);
+}
+/** Delete a key. No-op if key is absent. */
+export function deleteConfig(key, dirOverride) {
+    const dir = configDir(dirOverride);
+    const p = configPath(dirOverride);
+    const data = readConfig(dirOverride);
+    if (!(key in data))
+        return;
+    delete data[key];
+    flush(p, dir, data);
+}
+/** Atomic write: tmp file → rename. */
+function flush(filePath, dir, data) {
+    mkdirSync(dir, { recursive: true });
+    const tmp = filePath + ".tmp";
+    writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+    renameSync(tmp, filePath);
+}
+//# sourceMappingURL=config-store.js.map

package/dist/lib/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/lib/config-store.ts"],"names":[],"mappings":"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"}

package/dist/lib/corpus.js

@@ -0,0 +1,21 @@
+// Corpus loader — walks the shipped corpus/ directory and builds a searchable
+// in-memory index via minisearch. Falls back to plain-text grep if minisearch
+// unavailable.
+//
+// Each corpus file has YAML frontmatter with provenance metadata:
+//   author: string
+//   date_committed: YYYY-MM-DD
+//   license: string
+//   scope_tag: public | stephen-only | class-opt-in
+//
+// TODO (day 04-20): implement
+//   - walkCorpus(dir): CorpusEntry[]
+//   - buildIndex(entries): MiniSearch
+//   - search(query, opts): CorpusHit[]
+export async function loadCorpus(_dir) {
+    throw new Error("loadCorpus not yet implemented");
+}
+export async function searchCorpus(_query, _limit = 5) {
+    throw new Error("searchCorpus not yet implemented");
+}
+//# sourceMappingURL=corpus.js.map

package/dist/lib/corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.js","sourceRoot":"","sources":["../../src/lib/corpus.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,eAAe;AACf,EAAE;AACF,kEAAkE;AAClE,mBAAmB;AACnB,+BAA+B;AAC/B,oBAAoB;AACpB,oDAAoD;AACpD,EAAE;AACF,8BAA8B;AAC9B,qCAAqC;AACrC,sCAAsC;AACtC,uCAAuC;AAkBvC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,MAAM,GAAG,CAAC;IAC3D,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACtD,CAAC"}

package/dist/lib/format.js

@@ -0,0 +1,14 @@
+// Output formatting — human-readable text (default) or JSON (--json flag).
+//
+// Human mode uses Carl's vocabulary. JSON mode uses raw field names.
+//
+// TODO (day 04-17): implement
+export function print(result, asJson) {
+    if (asJson) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.log(result.output);
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,8BAA8B;AAI9B,MAAM,UAAU,KAAK,CAAC,MAAqB,EAAE,MAAe;IAC1D,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/lib/plm-types.js

@@ -0,0 +1,17 @@
+/**
+ * PLM Product Layer Types
+ *
+ * Core type definitions for Private Language Models.
+ *
+ * Source: DEVO packages/plm/src/types.ts (verbatim copy)
+ * DEVO refs: ADR-029 (PLM Product Layer), ADR-030 (Source Connectors), ADR-031 (Templates).
+ */
+/** Triage relevance thresholds. */
+export const TRIAGE_THRESHOLDS = {
+    /** >= this score → auto-ingest */
+    autoIngest: 0.6,
+    /** >= this score → queue for review */
+    review: 0.3,
+    /** below review → discard */
+};
+//# sourceMappingURL=plm-types.js.map

package/dist/lib/plm-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plm-types.js","sourceRoot":"","sources":["../../src/lib/plm-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkIH,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,kCAAkC;IAClC,UAAU,EAAE,GAAG;IACf,uCAAuC;IACvC,MAAM,EAAE,GAAG;IACX,6BAA6B;CACrB,CAAC"}

package/dist/lib/provider.js

@@ -0,0 +1,270 @@
+/**
+ * OpenRouter LLM Client
+ *
+ * Unified access to multiple LLM providers through OpenRouter.
+ * https://openrouter.ai/docs
+ *
+ * Includes exponential backoff retry for rate limits and transient errors.
+ *
+ * Source: DEVO packages/cortex/src/llm/openrouter.ts (adapted)
+ * Adaptations from DEVO:
+ *   - Removed circuit breaker (not portable — lives in DEVO's @devo/cortex/reliability)
+ *   - Removed rate limiter (same reason; big-tools handles parallel/serial in queue.ts)
+ *   - Removed executeProtected() wrapper (was the circuit breaker + rate limiter hook)
+ *   - Retry wrapping retained via local retry.ts (also copied from DEVO)
+ *
+ * Provider selection precedence (implemented at the selectProvider() level):
+ *   1. explicit model via --model flag
+ *   2. BIG_TOOLS_MODEL env var
+ *   3. ~/.config/big-tools/config.json model field
+ *   4. BYO detection: OPENROUTER_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY
+ *   5. OpenRouter free-tier default model (requires OPENROUTER_API_KEY)
+ */
+import { withRetryThrow } from "./retry.js";
+// =============================================================================
+// Popular Models
+// =============================================================================
+export const MODELS = {
+    // OpenAI
+    GPT_4O: "openai/gpt-4o",
+    GPT_4O_MINI: "openai/gpt-4o-mini",
+    GPT_4_TURBO: "openai/gpt-4-turbo",
+    // Anthropic
+    CLAUDE_3_5_SONNET: "anthropic/claude-3.5-sonnet",
+    CLAUDE_3_5_HAIKU: "anthropic/claude-3-5-haiku",
+    CLAUDE_3_OPUS: "anthropic/claude-3-opus",
+    // Google
+    GEMINI_2_FLASH: "google/gemini-2.0-flash-001",
+    GEMINI_PRO_1_5: "google/gemini-pro-1.5",
+    GEMINI_FLASH_1_5: "google/gemini-flash-1.5",
+    // Meta
+    LLAMA_3_3_70B: "meta-llama/llama-3.3-70b-instruct",
+    LLAMA_3_1_405B: "meta-llama/llama-3.1-405b-instruct",
+    // Mistral
+    MISTRAL_LARGE: "mistralai/mistral-large-latest",
+    MIXTRAL_8X22B: "mistralai/mixtral-8x22b-instruct",
+    // DeepSeek
+    DEEPSEEK_CHAT: "deepseek/deepseek-chat",
+    DEEPSEEK_R1: "deepseek/deepseek-r1",
+    // Qwen
+    QWEN_2_5_72B: "qwen/qwen-2.5-72b-instruct",
+};
+/**
+ * OpenRouter free-tier model roster. The default model is whichever of
+ * these is currently available; fall back in order on first failure.
+ *
+ * Students without a paid key can use any of these without charge.
+ * The list is a config constant — update it when OpenRouter's free
+ * menu changes.
+ */
+export const FREE_MODELS = [
+    "meta-llama/llama-3.1-8b-instruct:free",
+    "google/gemini-flash-1.5:free",
+    "mistralai/mistral-7b-instruct:free",
+];
+export const DEFAULT_FREE_MODEL = FREE_MODELS[0];
+// =============================================================================
+// Client
+// =============================================================================
+const OPENROUTER_API_URL = "https://openrouter.ai/api/v1";
+/** Default retry config for LLM calls. */
+const DEFAULT_LLM_RETRY = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 60000, // LLM calls can have longer backoff
+};
+/**
+ * Custom error that includes HTTP status for retry logic.
+ */
+class OpenRouterError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "OpenRouterError";
+    }
+}
+export class OpenRouterClient {
+    config;
+    retryConfig;
+    constructor(config) {
+        this.config = {
+            apiKey: config.apiKey,
+            defaultModel: config.defaultModel ?? DEFAULT_FREE_MODEL,
+            siteUrl: config.siteUrl,
+            siteName: config.siteName,
+        };
+        this.retryConfig = config.retry ?? DEFAULT_LLM_RETRY;
+    }
+    /** Get the default model */
+    get defaultModel() {
+        return this.config.defaultModel;
+    }
+    /**
+     * Create a chat completion.
+     */
+    async chat(request) {
+        const model = request.model ?? this.config.defaultModel;
+        const doChat = async () => {
+            const response = await fetch(`${OPENROUTER_API_URL}/chat/completions`, {
+                method: "POST",
+                headers: this.buildHeaders(),
+                body: JSON.stringify({
+                    model,
+                    messages: request.messages,
+                    temperature: request.temperature,
+                    max_tokens: request.maxTokens,
+                    top_p: request.topP,
+                    stream: false,
+                }),
+            });
+            if (!response.ok) {
+                const error = (await response.json().catch(() => ({})));
+                const nested = error.error;
+                throw new OpenRouterError(nested?.message ?? `OpenRouter API error: ${response.status}`, response.status);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = (await response.json());
+            const choice = data.choices[0];
+            return {
+                id: data.id,
+                model: data.model,
+                content: choice.message.content,
+                usage: {
+                    promptTokens: data.usage?.prompt_tokens ?? 0,
+                    completionTokens: data.usage?.completion_tokens ?? 0,
+                    totalTokens: data.usage?.total_tokens ?? 0,
+                },
+                finishReason: choice.finish_reason,
+            };
+        };
+        if (this.retryConfig === false) {
+            return doChat();
+        }
+        return withRetryThrow(doChat, this.retryConfig);
+    }
+    /**
+     * Create a streaming chat completion.
+     *
+     * Note: Retry only applies to initial connection establishment.
+     * Once streaming begins, errors are not retried.
+     */
+    async *chatStream(request) {
+        const model = request.model ?? this.config.defaultModel;
+        const getResponse = async () => {
+            const response = await fetch(`${OPENROUTER_API_URL}/chat/completions`, {
+                method: "POST",
+                headers: this.buildHeaders(),
+                body: JSON.stringify({
+                    model,
+                    messages: request.messages,
+                    temperature: request.temperature,
+                    max_tokens: request.maxTokens,
+                    top_p: request.topP,
+                    stream: true,
+                }),
+            });
+            if (!response.ok) {
+                const error = (await response.json().catch(() => ({})));
+                const nested = error.error;
+                throw new OpenRouterError(nested?.message ?? `OpenRouter API error: ${response.status}`, response.status);
+            }
+            return response;
+        };
+        const response = this.retryConfig === false
+            ? await getResponse()
+            : await withRetryThrow(getResponse, this.retryConfig);
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new Error("No response body");
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.startsWith("data: ")) {
+                    const data = line.slice(6);
+                    if (data === "[DONE]")
+                        return;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const delta = parsed.choices?.[0]?.delta;
+                        if (delta?.content) {
+                            yield {
+                                content: delta.content,
+                                finishReason: parsed.choices?.[0]?.finish_reason,
+                            };
+                        }
+                    }
+                    catch {
+                        // Skip invalid JSON
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Simple completion helper.
+     */
+    async complete(prompt, options) {
+        const messages = [];
+        if (options?.systemPrompt) {
+            messages.push({ role: "system", content: options.systemPrompt });
+        }
+        messages.push({ role: "user", content: prompt });
+        const response = await this.chat({
+            messages,
+            model: options?.model,
+            temperature: options?.temperature,
+            maxTokens: options?.maxTokens,
+        });
+        return response.content;
+    }
+    /**
+     * Get available models from OpenRouter.
+     */
+    async getModels() {
+        const doGetModels = async () => {
+            const response = await fetch(`${OPENROUTER_API_URL}/models`, {
+                headers: this.buildHeaders(),
+            });
+            if (!response.ok) {
+                throw new OpenRouterError(`Failed to fetch models: ${response.status}`, response.status);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = (await response.json());
+            return data.data;
+        };
+        if (this.retryConfig === false) {
+            return doGetModels();
+        }
+        return withRetryThrow(doGetModels, this.retryConfig);
+    }
+    buildHeaders() {
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`,
+        };
+        if (this.config.siteUrl) {
+            headers["HTTP-Referer"] = this.config.siteUrl;
+        }
+        if (this.config.siteName) {
+            headers["X-Title"] = this.config.siteName;
+        }
+        return headers;
+    }
+}
+/**
+ * Create an LLM client (OpenRouter implementation).
+ *
+ * Returns LLMProvider interface to allow swapping implementations.
+ */
+export function createLLMClient(config) {
+    return new OpenRouterClient(config);
+}
+//# sourceMappingURL=provider.js.map

package/dist/lib/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/lib/provider.ts"],"names":[],"mappings":"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"}

package/dist/lib/queue.js

@@ -0,0 +1,31 @@
+// Serial / parallel orchestrator for multi-call tools.
+//
+// OpenRouter retry is handled inside the provider (see ./provider.ts).
+// This queue only controls *concurrency* for tools like NGT and Delphi
+// that run N model calls against the same prompt and need to choose
+// between serial (safe for free-tier rate limits) and parallel (fast,
+// opt-in via --parallel flag).
+//
+// The goal is predictability under OpenRouter's free-tier limits:
+// serial mode spaces requests out enough that a 5-call NGT run
+// comfortably stays within per-minute limits; parallel mode is for
+// users who have verified their rate budget and want speed.
+export async function runQueue(tasks, opts) {
+    const total = tasks.length;
+    if (total === 0)
+        return [];
+    if (opts.parallel) {
+        return Promise.all(tasks.map((task, i) => {
+            opts.onProgress?.(i + 1, total);
+            return task();
+        }));
+    }
+    // Serial
+    const results = [];
+    for (let i = 0; i < tasks.length; i++) {
+        opts.onProgress?.(i + 1, total);
+        results.push(await tasks[i]());
+    }
+    return results;
+}
+//# sourceMappingURL=queue.js.map

package/dist/lib/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/lib/queue.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,+BAA+B;AAC/B,EAAE;AACF,kEAAkE;AAClE,+DAA+D;AAC/D,mEAAmE;AACnE,4DAA4D;AAQ5D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAA8B,EAC9B,IAAkB;IAElB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACpB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YAChC,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,SAAS;IACT,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}