@flaid/devmap 0.2.0

package/dist/ai/groq.d.ts

@@ -0,0 +1,36 @@
+import type { AiClient, AiCompletionRequest, AiCompletionResult, AiDeltaHandler } from "./types.js";
+export declare const DEFAULT_AI_MODELS: {
+    readonly analyze: "openai/gpt-oss-20b";
+    readonly flowNarration: "openai/gpt-oss-20b";
+    readonly explain: "openai/gpt-oss-20b";
+    readonly fallback: "openai/gpt-oss-20b";
+};
+export declare const DEFAULT_AI_FALLBACKS: {
+    readonly analyze: readonly ["qwen/qwen3.6-27b", "openai/gpt-oss-120b"];
+    readonly flowNarration: readonly ["openai/gpt-oss-120b"];
+    readonly explain: readonly ["qwen/qwen3.6-27b", "openai/gpt-oss-120b"];
+};
+export type GroqClientDependencies = {
+    fetch?: typeof fetch;
+    sleep?: (milliseconds: number) => Promise<void>;
+};
+export type GroqProviderInspection = {
+    reachable: true;
+    modelAvailable: boolean;
+};
+export declare class GroqClient implements AiClient {
+    private readonly apiKey;
+    private readonly fetchImplementation;
+    private readonly sleep;
+    constructor(apiKey: string, dependencies?: GroqClientDependencies);
+    complete(request: AiCompletionRequest): Promise<AiCompletionResult>;
+    stream(request: AiCompletionRequest, onDelta: AiDeltaHandler): Promise<AiCompletionResult>;
+    private requestModel;
+    private requestModelStream;
+    private sendWithRateLimitRetries;
+    private sendRequest;
+}
+export declare function validateGroqApiKey(apiKey: string): Promise<void>;
+export declare function listGroqModels(apiKey: string, dependencies?: Pick<GroqClientDependencies, "fetch">): Promise<string[]>;
+export declare function inspectGroqProvider(apiKey: string, model?: string, dependencies?: Pick<GroqClientDependencies, "fetch">): Promise<GroqProviderInspection>;
+//# sourceMappingURL=groq.d.ts.map

package/dist/ai/groq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groq.d.ts","sourceRoot":"","sources":["../../src/ai/groq.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EAEf,MAAM,YAAY,CAAC;AAQpB,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;CAYvB,CAAC;AAqBX,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,qBAAa,UAAW,YAAW,QAAQ;IAKvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;gBAG7C,MAAM,EAAE,MAAM,EAC/B,YAAY,GAAE,sBAA2B;IAMrC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBnE,MAAM,CACV,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,kBAAkB,CAAC;YAkBhB,YAAY;YA2BZ,kBAAkB;YA0BlB,wBAAwB;YAuBxB,WAAW;CA8B1B;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAM,GACvD,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,GAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAM,GACvD,OAAO,CAAC,sBAAsB,CAAC,CAsBjC"}

package/dist/ai/groq.js

@@ -0,0 +1,368 @@
+import { DevmapError } from "../utils/errors.js";
+const GROQ_MODELS_URL = "https://api.groq.com/openai/v1/models";
+const GROQ_CHAT_COMPLETIONS_URL = "https://api.groq.com/openai/v1/chat/completions";
+const DEFAULT_RATE_LIMIT_DELAY_MS = 1000;
+const MAX_RATE_LIMIT_DELAY_MS = 10_000;
+const MAX_RATE_LIMIT_RETRIES = 3;
+export const DEFAULT_AI_MODELS = {
+    analyze: "openai/gpt-oss-20b",
+    flowNarration: "openai/gpt-oss-20b",
+    explain: "openai/gpt-oss-20b",
+    fallback: "openai/gpt-oss-20b"
+};
+export const DEFAULT_AI_FALLBACKS = {
+    analyze: [
+        "qwen/qwen3.6-27b",
+        "openai/gpt-oss-120b"
+    ],
+    flowNarration: [
+        "openai/gpt-oss-120b"
+    ],
+    explain: [
+        "qwen/qwen3.6-27b",
+        "openai/gpt-oss-120b"
+    ]
+};
+const EXCLUDED_MODEL_PATTERNS = [
+    /whisper/i, // speech-to-text models (whisper-large-v3, distil-whisper-*)
+    /prompt-guard/i, // content moderation (llama-prompt-guard-*)
+    /\bguard\b/i, // safety classifier models (llama-guard-3-8b, etc.)
+    /compound/i, // compound-beta orchestration models — not plain chat completions
+    /\btts\b/i, // text-to-speech (playai-tts, playai-tts-arabic)
+    /\bvision\b/i, // vision-only models
+    /llava/i, // LLaVA multimodal vision family
+    /\bembed\b/i, // embedding models — no chat completions API
+    /\bspeculative\b/i, // speculative decoding variants
+    /\brerank\b/i, // reranking models
+];
+const PREFERRED_MODELS = [
+    "openai/gpt-oss-120b",
+    "openai/gpt-oss-20b",
+    "qwen/qwen3.6-27b",
+];
+export class GroqClient {
+    apiKey;
+    fetchImplementation;
+    sleep;
+    constructor(apiKey, dependencies = {}) {
+        this.apiKey = apiKey;
+        this.fetchImplementation = dependencies.fetch ?? fetch;
+        this.sleep = dependencies.sleep ?? wait;
+    }
+    async complete(request) {
+        let lastError;
+        for (const model of resolveModelChain(request)) {
+            const result = await this.requestModel(request, model);
+            if (result.ok) {
+                return result.result;
+            }
+            lastError = result.error;
+            if (!result.canFallback) {
+                throw result.error;
+            }
+        }
+        throw lastError ?? new DevmapError("No Groq model was configured.");
+    }
+    async stream(request, onDelta) {
+        let lastError;
+        for (const model of resolveModelChain(request)) {
+            const result = await this.requestModelStream(request, model, onDelta);
+            if (result.ok) {
+                return result.result;
+            }
+            lastError = result.error;
+            if (!result.canFallback) {
+                throw result.error;
+            }
+        }
+        throw lastError ?? new DevmapError("No Groq model was configured.");
+    }
+    async requestModel(request, model) {
+        const response = await this.sendWithRateLimitRetries(request, model, false);
+        if (!response.ok) {
+            return readFailedRequest(response);
+        }
+        const payload = await readCompletionPayload(response);
+        const content = payload.choices[0]?.message?.content?.trim();
+        if (!content) {
+            return emptyResponseResult();
+        }
+        return {
+            ok: true,
+            result: {
+                content,
+                model: payload.model || model,
+                ...(payload.usage ? { usage: normalizeUsage(payload.usage) } : {})
+            }
+        };
+    }
+    async requestModelStream(request, model, onDelta) {
+        const response = await this.sendWithRateLimitRetries(request, model, true);
+        if (!response.ok) {
+            return readFailedRequest(response);
+        }
+        const payload = await readCompletionStream(response, model, onDelta);
+        if (!payload.content.trim()) {
+            return emptyResponseResult();
+        }
+        return {
+            ok: true,
+            result: {
+                content: payload.content.trim(),
+                model: payload.model,
+                ...(payload.usage ? { usage: payload.usage } : {})
+            }
+        };
+    }
+    async sendWithRateLimitRetries(request, model, stream) {
+        let response = await this.sendRequest(request, model, stream);
+        for (let retryAttempt = 0; response.status === 429 && retryAttempt < MAX_RATE_LIMIT_RETRIES; retryAttempt += 1) {
+            const delay = Math.min(readRetryDelay(response) * (2 ** retryAttempt), MAX_RATE_LIMIT_DELAY_MS);
+            await this.sleep(delay);
+            response = await this.sendRequest(request, model, stream);
+        }
+        return response;
+    }
+    async sendRequest(request, model, stream = false) {
+        try {
+            return await this.fetchImplementation(GROQ_CHAT_COMPLETIONS_URL, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json"
+                },
+                body: JSON.stringify({
+                    model,
+                    messages: request.messages,
+                    max_completion_tokens: request.maxCompletionTokens ?? 1200,
+                    temperature: request.temperature ?? 0.2,
+                    ...(stream ? {
+                        stream: true,
+                        stream_options: { include_usage: true }
+                    } : {})
+                })
+            });
+        }
+        catch {
+            throw new DevmapError("Could not connect to Groq.", "Check your internet connection and run devmap doctor.");
+        }
+    }
+}
+export async function validateGroqApiKey(apiKey) {
+    await inspectGroqProvider(apiKey);
+}
+export async function listGroqModels(apiKey, dependencies = {}) {
+    const response = await fetchGroqModels(apiKey, dependencies);
+    if (response.status === 401 || response.status === 403) {
+        throw new DevmapError("The Groq API key is invalid.", "Create or copy a valid key from https://console.groq.com/keys.");
+    }
+    if (!response.ok) {
+        throw new DevmapError(`Groq model lookup failed with HTTP ${response.status}.`, "Try again shortly or check https://status.groq.com.");
+    }
+    return readModelIds(response);
+}
+export async function inspectGroqProvider(apiKey, model, dependencies = {}) {
+    const response = await fetchGroqModels(apiKey, dependencies);
+    if (response.status === 401 || response.status === 403) {
+        throw new DevmapError("The Groq API key is invalid.", "Create or copy a valid key from https://console.groq.com/keys.");
+    }
+    if (!response.ok) {
+        throw new DevmapError(`Groq validation failed with HTTP ${response.status}.`, "Try again shortly or check https://status.groq.com.");
+    }
+    const modelIds = await readModelIds(response);
+    return {
+        reachable: true,
+        modelAvailable: !model || modelIds.includes(model)
+    };
+}
+async function fetchGroqModels(apiKey, dependencies = {}) {
+    const fetchImplementation = dependencies.fetch ?? fetch;
+    try {
+        return await fetchImplementation(GROQ_MODELS_URL, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`
+            }
+        });
+    }
+    catch {
+        throw new DevmapError("Could not connect to Groq.", "Check your internet connection and run devmap init again.");
+    }
+}
+async function readFailedRequest(response) {
+    const providerMessage = await readProviderError(response);
+    return {
+        ok: false,
+        canFallback: shouldTryFallback(response.status, providerMessage),
+        error: mapGroqError(response.status, providerMessage)
+    };
+}
+function emptyResponseResult() {
+    return {
+        ok: false,
+        canFallback: false,
+        error: new DevmapError("Groq returned an empty response.", "Try the question again or run devmap doctor.")
+    };
+}
+async function readCompletionPayload(response) {
+    try {
+        const payload = await response.json();
+        return {
+            model: payload.model,
+            choices: Array.isArray(payload.choices) ? payload.choices : [],
+            usage: payload.usage
+        };
+    }
+    catch {
+        throw new DevmapError("Groq returned an unreadable response.", "Try again shortly or check https://status.groq.com.");
+    }
+}
+async function readProviderError(response) {
+    try {
+        const payload = await response.json();
+        return typeof payload.error?.message === "string"
+            ? payload.error.message
+            : `HTTP ${response.status}`;
+    }
+    catch {
+        return `HTTP ${response.status}`;
+    }
+}
+async function readCompletionStream(response, requestedModel, onDelta) {
+    if (!response.body) {
+        throw new DevmapError("Groq returned an unreadable streaming response.", "Try again shortly or run devmap doctor.");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let content = "";
+    let model = requestedModel;
+    let usage;
+    const consumeEvent = (event) => {
+        const data = event
+            .split(/\r?\n/)
+            .filter((line) => line.startsWith("data:"))
+            .map((line) => line.slice(5).trimStart())
+            .join("\n");
+        if (!data)
+            return false;
+        if (data.trim() === "[DONE]")
+            return true;
+        let payload;
+        try {
+            payload = JSON.parse(data);
+        }
+        catch {
+            throw new DevmapError("Groq returned an unreadable streaming response.", "Try again shortly or check https://status.groq.com.");
+        }
+        model = payload.model || model;
+        const delta = payload.choices?.[0]?.delta?.content;
+        if (delta) {
+            content += delta;
+            onDelta(delta);
+        }
+        const rawUsage = payload.usage ?? payload.x_groq?.usage;
+        if (rawUsage) {
+            usage = normalizeUsage(rawUsage);
+        }
+        return false;
+    };
+    try {
+        let done = false;
+        while (!done) {
+            const readResult = await reader.read();
+            buffer += decoder.decode(readResult.value, { stream: !readResult.done });
+            const events = buffer.split(/\r?\n\r?\n/);
+            buffer = events.pop() ?? "";
+            for (const event of events) {
+                if (consumeEvent(event)) {
+                    done = true;
+                    break;
+                }
+            }
+            if (readResult.done) {
+                if (!done && buffer.trim()) {
+                    consumeEvent(buffer);
+                }
+                break;
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof DevmapError) {
+            throw error;
+        }
+        throw new DevmapError("The Groq response stream ended unexpectedly.", "Try again or run devmap doctor if the problem continues.");
+    }
+    return {
+        content,
+        model,
+        ...(usage ? { usage } : {})
+    };
+}
+function mapGroqError(status, providerMessage) {
+    if (status === 401 || status === 403) {
+        return new DevmapError("The Groq API key is invalid or no longer authorized.", "Run devmap init again with a valid Groq API key.");
+    }
+    if (status === 429) {
+        return new DevmapError("Groq rate limit reached after retrying.", "Wait briefly, ask a narrower question, or try again later.");
+    }
+    if (status >= 500) {
+        return new DevmapError("Groq is temporarily unavailable.", "Try again shortly or check https://status.groq.com.");
+    }
+    return new DevmapError(`Groq could not complete the request (${providerMessage}).`, "Run devmap doctor and verify the selected model.");
+}
+function shouldTryFallback(status, message) {
+    return status === 429
+        || status >= 500
+        || (status === 404
+            || (status === 400
+                && /model|decommissioned|not available|not found|permission/i.test(message)));
+}
+function resolveModelChain(request) {
+    return Array.from(new Set([
+        request.model,
+        ...(request.fallbackModels ?? []),
+        ...(request.fallbackModel ? [request.fallbackModel] : [])
+    ].filter((model) => model.trim().length > 0)));
+}
+function readRetryDelay(response) {
+    const seconds = Number(response.headers.get("retry-after"));
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        return DEFAULT_RATE_LIMIT_DELAY_MS;
+    }
+    return Math.min(seconds * 1000, MAX_RATE_LIMIT_DELAY_MS);
+}
+function normalizeUsage(usage) {
+    return {
+        promptTokens: usage.prompt_tokens ?? 0,
+        completionTokens: usage.completion_tokens ?? 0,
+        totalTokens: usage.total_tokens ?? 0
+    };
+}
+function wait(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+async function readModelIds(response) {
+    try {
+        const payload = await response.json();
+        return (payload.data ?? [])
+            .map((model) => model.id)
+            .filter((id) => typeof id === "string")
+            .filter((id) => !EXCLUDED_MODEL_PATTERNS.some((pattern) => pattern.test(id)))
+            .sort((a, b) => {
+            const aIndex = PREFERRED_MODELS.indexOf(a);
+            const bIndex = PREFERRED_MODELS.indexOf(b);
+            if (aIndex !== -1 && bIndex !== -1)
+                return aIndex - bIndex;
+            if (aIndex !== -1)
+                return -1;
+            if (bIndex !== -1)
+                return 1;
+            return a.localeCompare(b);
+        });
+    }
+    catch {
+        throw new DevmapError("Groq returned an unreadable model list.", "Try again shortly or check https://status.groq.com.");
+    }
+}
+//# sourceMappingURL=groq.js.map

package/dist/ai/groq.js.map

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

package/dist/ai/openrouter.d.ts

@@ -0,0 +1,20 @@
+import type { AiClient, AiCompletionRequest, AiCompletionResult, AiDeltaHandler } from "./types.js";
+export declare const OPENROUTER_FREE_MODEL = "openrouter/free";
+export type OpenRouterClientDependencies = {
+    fetch?: typeof fetch;
+};
+export type OpenRouterProviderInspection = {
+    reachable: true;
+    modelAvailable: boolean;
+};
+export declare class OpenRouterClient implements AiClient {
+    private readonly apiKey;
+    private readonly fetchImplementation;
+    constructor(apiKey: string, dependencies?: OpenRouterClientDependencies);
+    complete(request: AiCompletionRequest): Promise<AiCompletionResult>;
+    stream(request: AiCompletionRequest, onDelta: AiDeltaHandler): Promise<AiCompletionResult>;
+    private sendRequest;
+}
+export declare function validateOpenRouterApiKey(apiKey: string, dependencies?: OpenRouterClientDependencies): Promise<void>;
+export declare function inspectOpenRouterProvider(apiKey: string, _model?: string, dependencies?: OpenRouterClientDependencies): Promise<OpenRouterProviderInspection>;
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/ai/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../src/ai/openrouter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EAEf,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,qBAAa,gBAAiB,YAAW,QAAQ;IAI7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAe;gBAGhC,MAAM,EAAE,MAAM,EAC/B,YAAY,GAAE,4BAAiC;IAK3C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoBnE,MAAM,CACV,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,kBAAkB,CAAC;YAMhB,WAAW;CA6B1B;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,4BAA4B,CAAC,CA4BvC"}

package/dist/ai/openrouter.js

@@ -0,0 +1,187 @@
+import { DevmapError } from "../utils/errors.js";
+const OPENROUTER_CHAT_URL = "https://openrouter.ai/api/v1/chat/completions";
+const OPENROUTER_KEY_URL = "https://openrouter.ai/api/v1/auth/key";
+export const OPENROUTER_FREE_MODEL = "openrouter/free";
+export class OpenRouterClient {
+    apiKey;
+    fetchImplementation;
+    constructor(apiKey, dependencies = {}) {
+        this.apiKey = apiKey;
+        this.fetchImplementation = dependencies.fetch ?? fetch;
+    }
+    async complete(request) {
+        const response = await this.sendRequest(request, false);
+        if (!response.ok)
+            throw await mapOpenRouterResponseError(response);
+        const payload = await readCompletionPayload(response);
+        const content = payload.choices[0]?.message?.content?.trim();
+        if (!content) {
+            throw new DevmapError("OpenRouter returned an empty response.", "Try again or choose another model.");
+        }
+        return {
+            content,
+            model: payload.model || request.model,
+            ...(payload.usage ? { usage: normalizeUsage(payload.usage) } : {})
+        };
+    }
+    async stream(request, onDelta) {
+        const response = await this.sendRequest(request, true);
+        if (!response.ok)
+            throw await mapOpenRouterResponseError(response);
+        return readCompletionStream(response, request.model, onDelta);
+    }
+    async sendRequest(request, stream) {
+        const models = resolveModels(request);
+        try {
+            return await this.fetchImplementation(OPENROUTER_CHAT_URL, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                    "HTTP-Referer": "https://github.com/itsflaid/devmap",
+                    "X-OpenRouter-Title": "DevMap"
+                },
+                body: JSON.stringify({
+                    ...(models.length > 1 ? { models } : { model: models[0] }),
+                    messages: request.messages,
+                    max_tokens: request.maxCompletionTokens ?? 1200,
+                    temperature: request.temperature ?? 0.2,
+                    ...(stream ? { stream: true } : {})
+                })
+            });
+        }
+        catch {
+            throw new DevmapError("Could not connect to OpenRouter.", "Check your internet connection and run devmap doctor.");
+        }
+    }
+}
+export async function validateOpenRouterApiKey(apiKey, dependencies = {}) {
+    await inspectOpenRouterProvider(apiKey, undefined, dependencies);
+}
+export async function inspectOpenRouterProvider(apiKey, _model, dependencies = {}) {
+    const fetchImplementation = dependencies.fetch ?? fetch;
+    let response;
+    try {
+        response = await fetchImplementation(OPENROUTER_KEY_URL, {
+            headers: { Authorization: `Bearer ${apiKey}` }
+        });
+    }
+    catch {
+        throw new DevmapError("Could not connect to OpenRouter.", "Check your internet connection and run devmap init again.");
+    }
+    if (response.status === 401 || response.status === 403) {
+        throw new DevmapError("The OpenRouter API key is invalid.", "Create or copy a valid key from https://openrouter.ai/keys.");
+    }
+    if (!response.ok) {
+        throw new DevmapError(`OpenRouter validation failed with HTTP ${response.status}.`, "Try again shortly or check https://openrouter.ai/status.");
+    }
+    return { reachable: true, modelAvailable: true };
+}
+function resolveModels(request) {
+    return Array.from(new Set([
+        request.model,
+        ...(request.fallbackModels ?? []),
+        ...(request.fallbackModel ? [request.fallbackModel] : [])
+    ].filter((model) => model.trim().length > 0)));
+}
+async function readCompletionPayload(response) {
+    try {
+        const payload = await response.json();
+        return {
+            model: payload.model,
+            choices: Array.isArray(payload.choices) ? payload.choices : [],
+            usage: payload.usage
+        };
+    }
+    catch {
+        throw unreadableResponseError();
+    }
+}
+async function readCompletionStream(response, requestedModel, onDelta) {
+    if (!response.body)
+        throw unreadableResponseError();
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let content = "";
+    let model = requestedModel;
+    let usage;
+    const consume = (event) => {
+        const data = event
+            .split(/\r?\n/)
+            .filter((line) => line.startsWith("data:"))
+            .map((line) => line.slice(5).trimStart())
+            .join("\n");
+        if (!data)
+            return false;
+        if (data.trim() === "[DONE]")
+            return true;
+        try {
+            const payload = JSON.parse(data);
+            model = payload.model || model;
+            const delta = payload.choices?.[0]?.delta?.content;
+            if (delta) {
+                content += delta;
+                onDelta(delta);
+            }
+            if (payload.usage)
+                usage = normalizeUsage(payload.usage);
+            return false;
+        }
+        catch {
+            throw unreadableResponseError();
+        }
+    };
+    try {
+        let done = false;
+        while (!done) {
+            const chunk = await reader.read();
+            buffer += decoder.decode(chunk.value, { stream: !chunk.done });
+            const events = buffer.split(/\r?\n\r?\n/);
+            buffer = events.pop() ?? "";
+            for (const event of events) {
+                if (consume(event)) {
+                    done = true;
+                    break;
+                }
+            }
+            if (chunk.done) {
+                if (!done && buffer.trim())
+                    consume(buffer);
+                break;
+            }
+        }
+    }
+    catch (error) {
+        if (error instanceof DevmapError)
+            throw error;
+        throw unreadableResponseError();
+    }
+    if (!content.trim()) {
+        throw new DevmapError("OpenRouter returned an empty response.", "Try again or choose another model.");
+    }
+    return { content: content.trim(), model, ...(usage ? { usage } : {}) };
+}
+async function mapOpenRouterResponseError(response) {
+    if (response.status === 401 || response.status === 403) {
+        return new DevmapError("The OpenRouter API key is invalid or no longer authorized.", "Run devmap init again with a valid OpenRouter API key.");
+    }
+    if (response.status === 429) {
+        return new DevmapError("OpenRouter rate limit reached.", "Wait briefly or choose another model.");
+    }
+    if (response.status >= 500) {
+        return new DevmapError("OpenRouter is temporarily unavailable.", "Try again shortly or check https://openrouter.ai/status.");
+    }
+    return new DevmapError(`OpenRouter could not complete the request (HTTP ${response.status}).`, "Run devmap doctor and verify the selected model.");
+}
+function unreadableResponseError() {
+    return new DevmapError("OpenRouter returned an unreadable response.", "Try again shortly or choose another model.");
+}
+function normalizeUsage(usage) {
+    return {
+        promptTokens: usage.prompt_tokens ?? 0,
+        completionTokens: usage.completion_tokens ?? 0,
+        totalTokens: usage.total_tokens ?? 0
+    };
+}
+//# sourceMappingURL=openrouter.js.map

package/dist/ai/openrouter.js.map

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

package/dist/ai/prompts.d.ts

@@ -0,0 +1,7 @@
+import type { FlowInfo, ProjectMap } from "../analyzers/pipeline/index.js";
+import type { QuestionContext } from "./contextBuilder.js";
+import type { AiMessage } from "./types.js";
+export declare function buildAnalyzeMessages(snapshot: ProjectMap): AiMessage[];
+export declare function buildFlowNarrationMessages(flow: FlowInfo): AiMessage[];
+export declare function buildExplainMessages(targetLabel: string, context: QuestionContext): AiMessage[];
+//# sourceMappingURL=prompts.d.ts.map