hivemind-pipeline 0.1.0

package/dist/src/core/providers/cost-table.js

@@ -0,0 +1,136 @@
+/**
+ * Cost Table
+ *
+ * Token cost calculation with fallback pricing for known models.
+ * Supports local models (free), cache discounts, and pipeline cost estimation.
+ */
+/** Fallback pricing in USD per 1M tokens — used when provider doesn't report pricing */
+const FALLBACK_COSTS = {
+    'anthropic/claude-opus-4': { input: 15.00, output: 75.00, cacheRead: 1.50 },
+    'anthropic/claude-sonnet-4': { input: 3.00, output: 15.00, cacheRead: 0.30 },
+    'anthropic/claude-haiku-4-5': { input: 0.80, output: 4.00, cacheRead: 0.08 },
+    'openai/gpt-4o': { input: 2.50, output: 10.00 },
+    'openai/gpt-4o-mini': { input: 0.15, output: 0.60 },
+    'openai/o3': { input: 10.00, output: 40.00 },
+    'google/gemini-2.5-pro': { input: 1.25, output: 10.00 },
+    'google/gemini-2.5-flash': { input: 0.15, output: 0.60 },
+    'deepseek/deepseek-chat': { input: 0.14, output: 0.28 },
+    'deepseek/deepseek-reasoner': { input: 0.55, output: 2.19 },
+    'groq/llama-3.1-70b-versatile': { input: 0.59, output: 0.79 },
+    'together/meta-llama/Llama-3-70b': { input: 0.90, output: 0.90 },
+};
+/**
+ * Calculate the cost in USD for a given model and token usage.
+ *
+ * @param model - Full model ID (e.g. 'anthropic/claude-sonnet-4') or alias
+ * @param usage - Token usage from a request
+ * @returns Cost in USD
+ */
+export function calculateCost(model, usage) {
+    if (isLocalModel(model)) {
+        return 0;
+    }
+    const pricing = getCostPer1M(model);
+    if (!pricing) {
+        // Unknown model — return 0 rather than error; cost tracking is best-effort
+        return 0;
+    }
+    const inputCost = (usage.inputTokens / 1_000_000) * pricing.input;
+    const outputCost = (usage.outputTokens / 1_000_000) * pricing.output;
+    let cacheReadCost = 0;
+    if (usage.cacheReadTokens && pricing.cacheRead) {
+        cacheReadCost = (usage.cacheReadTokens / 1_000_000) * pricing.cacheRead;
+    }
+    // Cache write tokens are billed at standard input rate
+    let cacheWriteCost = 0;
+    if (usage.cacheWriteTokens) {
+        cacheWriteCost = (usage.cacheWriteTokens / 1_000_000) * pricing.input;
+    }
+    return inputCost + outputCost + cacheReadCost + cacheWriteCost;
+}
+/**
+ * Get the per-1M-token pricing for a model.
+ *
+ * @param model - Full model ID (e.g. 'anthropic/claude-sonnet-4')
+ * @returns Pricing object, or undefined if model is unknown
+ */
+export function getCostPer1M(model) {
+    // Direct lookup
+    if (FALLBACK_COSTS[model]) {
+        return FALLBACK_COSTS[model];
+    }
+    // Try without provider prefix for partial matches
+    for (const [key, value] of Object.entries(FALLBACK_COSTS)) {
+        const modelPart = key.split('/').slice(1).join('/');
+        if (model === modelPart || model.endsWith(`/${modelPart}`)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/** Estimated tokens per stage (low / high) for pipeline cost estimation */
+const STAGE_TOKEN_ESTIMATES = {
+    analyze: { inputLow: 2000, inputHigh: 8000, outputLow: 1000, outputHigh: 4000 },
+    architect: { inputLow: 4000, inputHigh: 15000, outputLow: 2000, outputHigh: 8000 },
+    plan: { inputLow: 5000, inputHigh: 20000, outputLow: 2000, outputHigh: 10000 },
+    build: { inputLow: 10000, inputHigh: 100000, outputLow: 5000, outputHigh: 50000 },
+    test: { inputLow: 5000, inputHigh: 30000, outputLow: 2000, outputHigh: 15000 },
+};
+/**
+ * Estimate the total cost of a pipeline run given per-stage model assignments.
+ *
+ * @param stageModels - Map of stage name → full model ID
+ * @returns Estimated low/high cost range and per-stage breakdown
+ */
+export function estimatePipelineCost(stageModels) {
+    let totalLow = 0;
+    let totalHigh = 0;
+    const breakdown = {};
+    for (const [stage, model] of Object.entries(stageModels)) {
+        const estimates = STAGE_TOKEN_ESTIMATES[stage];
+        if (!estimates)
+            continue;
+        if (isLocalModel(model)) {
+            breakdown[stage] = 0;
+            continue;
+        }
+        const pricing = getCostPer1M(model);
+        if (!pricing) {
+            breakdown[stage] = 0;
+            continue;
+        }
+        const lowCost = (estimates.inputLow / 1_000_000) * pricing.input +
+            (estimates.outputLow / 1_000_000) * pricing.output;
+        const highCost = (estimates.inputHigh / 1_000_000) * pricing.input +
+            (estimates.outputHigh / 1_000_000) * pricing.output;
+        totalLow += lowCost;
+        totalHigh += highCost;
+        // Midpoint for breakdown
+        breakdown[stage] = (lowCost + highCost) / 2;
+    }
+    return { low: totalLow, high: totalHigh, breakdown };
+}
+/**
+ * Check if a model is local (free, no API cost).
+ * Ollama models and localhost-based endpoints are considered local.
+ *
+ * @param model - Full model ID or provider name
+ * @returns true if the model is local/free
+ */
+export function isLocalModel(model) {
+    const lower = model.toLowerCase();
+    // Ollama provider
+    if (lower.startsWith('ollama/') || lower.startsWith('ollama:')) {
+        return true;
+    }
+    // Localhost-based URLs embedded in model string (rare but possible)
+    if (lower.includes('localhost') || lower.includes('127.0.0.1')) {
+        return true;
+    }
+    // LM Studio and other local runners
+    if (lower.startsWith('lmstudio/') || lower.startsWith('local/')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=cost-table.js.map

package/dist/src/core/providers/cost-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-table.js","sourceRoot":"","sources":["../../../../src/core/providers/cost-table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wFAAwF;AACxF,MAAM,cAAc,GAA0E;IAC5F,yBAAyB,EAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;IACtF,2BAA2B,EAAW,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;IACtF,4BAA4B,EAAU,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAG,SAAS,EAAE,IAAI,EAAE;IACtF,eAAe,EAAuB,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,KAAK,EAAE;IACrE,oBAAoB,EAAkB,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAE;IACpE,WAAW,EAA2B,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IACrE,uBAAuB,EAAe,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,KAAK,EAAE;IACrE,yBAAyB,EAAa,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAE;IACpE,wBAAwB,EAAc,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAE;IACpE,4BAA4B,EAAU,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAE;IACpE,8BAA8B,EAAQ,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAE;IACpE,iCAAiC,EAAK,EAAE,KAAK,EAAE,IAAI,EAAG,MAAM,EAAE,IAAI,EAAE;CACrE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAiB;IAC5D,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,2EAA2E;QAC3E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAClE,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAErE,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,KAAK,CAAC,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/C,aAAa,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAC1E,CAAC;IAED,uDAAuD;IACvD,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3B,cAAc,GAAG,CAAC,KAAK,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IACxE,CAAC;IAED,OAAO,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,gBAAgB;IAChB,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,qBAAqB,GAAmG;IAC5H,OAAO,EAAK,EAAE,QAAQ,EAAE,IAAI,EAAG,SAAS,EAAE,IAAI,EAAI,SAAS,EAAE,IAAI,EAAG,UAAU,EAAE,IAAI,EAAE;IACtF,SAAS,EAAG,EAAE,QAAQ,EAAE,IAAI,EAAG,SAAS,EAAE,KAAK,EAAG,SAAS,EAAE,IAAI,EAAG,UAAU,EAAE,IAAI,EAAE;IACtF,IAAI,EAAQ,EAAE,QAAQ,EAAE,IAAI,EAAG,SAAS,EAAE,KAAK,EAAG,SAAS,EAAE,IAAI,EAAG,UAAU,EAAE,KAAK,EAAE;IACvF,KAAK,EAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAG,UAAU,EAAE,KAAK,EAAE;IACvF,IAAI,EAAQ,EAAE,QAAQ,EAAE,IAAI,EAAG,SAAS,EAAE,KAAK,EAAG,SAAS,EAAE,IAAI,EAAG,UAAU,EAAE,KAAK,EAAE;CACxF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmC;IAKtE,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,SAAS,GAA2B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GACX,CAAC,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK;YAChD,CAAC,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QAErD,MAAM,QAAQ,GACZ,CAAC,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK;YACjD,CAAC,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QAEtD,QAAQ,IAAI,OAAO,CAAC;QACpB,SAAS,IAAI,QAAQ,CAAC;QAEtB,yBAAyB;QACzB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAElC,kBAAkB;IAClB,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oCAAoC;IACpC,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/core/providers/google.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Google Gemini Provider — Wave 8
+ *
+ * Uses Gemini's OpenAI-compatible endpoint for simplicity, delegating to
+ * OpenAICompatProvider internally. Overrides model listing with known
+ * Gemini models.
+ */
+import type { LLMProvider, ChatMessage, ChatOptions, ChatResponse, ToolDefinition, StreamChunk, ModelInfo, ProviderConfig } from './types.js';
+export declare class GeminiProvider implements LLMProvider {
+    readonly name = "google";
+    readonly type: "api";
+    private delegate;
+    private apiKey;
+    private timeout;
+    constructor(config: ProviderConfig);
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
+    stream(messages: ChatMessage[], options?: ChatOptions): AsyncIterable<StreamChunk>;
+    streamWithTools(messages: ChatMessage[], tools: ToolDefinition[], options?: ChatOptions): AsyncIterable<StreamChunk>;
+    listModels(): Promise<ModelInfo[]>;
+    testConnection(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=google.d.ts.map

package/dist/src/core/providers/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../../src/core/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,cAAc,EAEf,MAAM,YAAY,CAAC;AAkEpB,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAE/B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,cAAc;IAa5B,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC;IAOjB,MAAM,CACX,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAAC,WAAW,CAAC;IAOtB,eAAe,CACpB,QAAQ,EAAE,WAAW,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,aAAa,CAAC,WAAW,CAAC;IAOvB,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA0DlC,cAAc,IAAI,OAAO,CAAC;QAC9B,EAAE,EAAE,OAAO,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CAgBH"}

package/dist/src/core/providers/google.js

@@ -0,0 +1,165 @@
+/**
+ * Google Gemini Provider — Wave 8
+ *
+ * Uses Gemini's OpenAI-compatible endpoint for simplicity, delegating to
+ * OpenAICompatProvider internally. Overrides model listing with known
+ * Gemini models.
+ */
+import { OpenAICompatProvider } from './openai-compat.js';
+// ─── Known Gemini Models ─────────────────────────────────────────────────────
+const GEMINI_MODELS = [
+    {
+        id: 'gemini-2.5-pro',
+        provider: 'google',
+        fullId: 'google/gemini-2.5-pro',
+        name: 'Gemini 2.5 Pro',
+        contextWindow: 1_000_000,
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsThinking: true,
+        costPer1MInput: 1.25,
+        costPer1MOutput: 10,
+        tier: 2,
+        tags: ['flagship', 'reasoning', 'long-context'],
+    },
+    {
+        id: 'gemini-2.5-flash',
+        provider: 'google',
+        fullId: 'google/gemini-2.5-flash',
+        name: 'Gemini 2.5 Flash',
+        contextWindow: 1_000_000,
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsThinking: true,
+        costPer1MInput: 0.15,
+        costPer1MOutput: 0.6,
+        tier: 2,
+        tags: ['fast', 'cheap', 'reasoning'],
+    },
+    {
+        id: 'gemini-2.0-flash',
+        provider: 'google',
+        fullId: 'google/gemini-2.0-flash',
+        name: 'Gemini 2.0 Flash',
+        contextWindow: 1_000_000,
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsThinking: false,
+        costPer1MInput: 0.1,
+        costPer1MOutput: 0.4,
+        tier: 2,
+        tags: ['fast', 'cheap'],
+    },
+    {
+        id: 'gemini-2.0-flash-lite',
+        provider: 'google',
+        fullId: 'google/gemini-2.0-flash-lite',
+        name: 'Gemini 2.0 Flash Lite',
+        contextWindow: 1_000_000,
+        supportsTools: true,
+        supportsStreaming: true,
+        supportsThinking: false,
+        costPer1MInput: 0.075,
+        costPer1MOutput: 0.3,
+        tier: 2,
+        tags: ['fastest', 'cheapest'],
+    },
+];
+// ─── Provider ────────────────────────────────────────────────────────────────
+export class GeminiProvider {
+    name = 'google';
+    type = 'api';
+    delegate;
+    apiKey;
+    timeout;
+    constructor(config) {
+        this.apiKey = config.apiKey || '';
+        this.timeout = 120_000;
+        // Gemini provides an OpenAI-compatible endpoint
+        this.delegate = new OpenAICompatProvider('google', {
+            ...config,
+            baseUrl: config.baseUrl ||
+                'https://generativelanguage.googleapis.com/v1beta/openai',
+        });
+    }
+    async chat(messages, options) {
+        return this.delegate.chat(messages, {
+            ...options,
+            model: options?.model || 'gemini-2.5-flash',
+        });
+    }
+    async *stream(messages, options) {
+        yield* this.delegate.stream(messages, {
+            ...options,
+            model: options?.model || 'gemini-2.5-flash',
+        });
+    }
+    async *streamWithTools(messages, tools, options) {
+        yield* this.delegate.streamWithTools(messages, tools, {
+            ...options,
+            model: options?.model || 'gemini-2.5-flash',
+        });
+    }
+    async listModels() {
+        // Try Gemini's native model listing, fall back to static list
+        if (this.apiKey) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+                const resp = await fetch(`https://generativelanguage.googleapis.com/v1beta/models?key=${this.apiKey}`, { signal: controller.signal });
+                clearTimeout(timeoutId);
+                if (resp.ok) {
+                    const data = (await resp.json());
+                    const models = (data.models || []);
+                    const mapped = models
+                        .filter((m) => {
+                        const methods = (m.supportedGenerationMethods || []);
+                        return methods.includes('generateContent');
+                    })
+                        .map((m) => {
+                        const rawName = m.name || '';
+                        const id = rawName.replace('models/', '');
+                        const displayName = m.displayName || id;
+                        // Find matching static entry for cost info
+                        const staticMatch = GEMINI_MODELS.find((s) => s.id === id);
+                        return {
+                            id,
+                            provider: 'google',
+                            fullId: `google/${id}`,
+                            name: displayName,
+                            contextWindow: m.inputTokenLimit || 1_000_000,
+                            supportsTools: true,
+                            supportsStreaming: true,
+                            supportsThinking: staticMatch?.supportsThinking || false,
+                            costPer1MInput: staticMatch?.costPer1MInput || 0,
+                            costPer1MOutput: staticMatch?.costPer1MOutput || 0,
+                            tier: (staticMatch?.tier || 2),
+                            tags: staticMatch?.tags || [],
+                        };
+                    });
+                    if (mapped.length > 0)
+                        return mapped;
+                }
+            }
+            catch {
+                // Fall through to static list
+            }
+        }
+        return GEMINI_MODELS;
+    }
+    async testConnection() {
+        const start = Date.now();
+        try {
+            await this.chat([{ role: 'user', content: 'Hello' }], { maxTokens: 16, model: 'gemini-2.5-flash' });
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=google.js.map

package/dist/src/core/providers/google.js.map

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

package/dist/src/core/providers/model-catalog.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Model Catalog
+ *
+ * Dynamic model discovery and catalog management. Combines static knowledge
+ * of well-known models with runtime discovery from configured providers.
+ * Provides model resolution, tier suggestions, and CLI help text.
+ */
+import type { ModelInfo } from './types.js';
+export declare class ModelCatalog {
+    private cache;
+    private cacheTimestamp;
+    private static CACHE_TTL;
+    private defaultModel;
+    private aliases;
+    constructor(defaultModel?: string, aliases?: Record<string, string>);
+    /**
+     * Get all available models across all configured providers.
+     * Combines dynamic discovery with static known models.
+     */
+    listAll(): Promise<ModelInfo[]>;
+    /**
+     * Discover models from a specific provider.
+     * Tries provider.listModels() first, falls back to known models for that provider.
+     */
+    discoverFromProvider(providerName: string): Promise<ModelInfo[]>;
+    /**
+     * Get the user's configured default model in full format.
+     */
+    getDefaultModel(): string;
+    /**
+     * Resolve a model string to its full ID.
+     * Uses the registry's alias resolution.
+     *
+     * @param modelString - e.g. 'sonnet', 'openai/gpt-4o'
+     * @returns Full model ID, e.g. 'anthropic/claude-sonnet-4'
+     */
+    resolve(modelString: string): string;
+    /**
+     * Get the CLI --model option description with dynamic model info.
+     */
+    getCliModelDescription(): string;
+    /**
+     * Suggest model assignments for cost/quality tiers.
+     *
+     * @param tier - 'lean' (cheapest), 'smart' (best quality), or 'balanced'
+     * @returns Map of stage → full model ID
+     */
+    suggestForTier(tier: 'lean' | 'smart' | 'balanced'): Record<string, string>;
+    /**
+     * Get the static list of well-known models.
+     * Used as fallback when dynamic discovery fails.
+     */
+    getKnownModels(): ModelInfo[];
+    /**
+     * Invalidate the model cache, forcing re-discovery on next access.
+     */
+    invalidateCache(): void;
+}
+/**
+ * Get the global model catalog. Creates a default one if not initialized.
+ */
+export declare function getModelCatalog(): ModelCatalog;
+/**
+ * Initialize the global model catalog with config.
+ * Should be called once during startup after loading SwarmConfig.
+ *
+ * @param defaultModel - The user's configured default model
+ * @param aliases - Custom model aliases
+ * @returns The initialized catalog
+ */
+export declare function initModelCatalog(defaultModel?: string, aliases?: Record<string, string>): ModelCatalog;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/src/core/providers/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../../../../src/core/providers/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAiG5D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAiB;IACzC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUnE;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAuCrC;;;OAGG;IACG,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA0BtE;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAWpC;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAIhC;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAqC3E;;;OAGG;IACH,cAAc,IAAI,SAAS,EAAE;IAI7B;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB;AAMD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAGtG"}