duocode 0.1.0

package/dist/providers/grading_rubric.js

@@ -0,0 +1,238 @@
+import { extractLogicalProvider } from "./router.js";
+import { GRADING_DIMENSIONS, DIMENSION_WEIGHTS, } from "../duo/duo_types.js";
+const GRADING_SYSTEM_PROMPT = `You are a senior code quality evaluator. Grade the provided code output using the ISO/IEC 25010 software quality model.
+
+Score each dimension from 1 (poor) to 5 (excellent) with brief reasoning.
+
+Dimensions:
+1. **Correctness** (weight: 0.30) — Functional accuracy, passes implied tests, meets the spec
+2. **Security** (weight: 0.15) — No vulnerabilities, no deprecated APIs, proper input validation
+3. **Efficiency** (weight: 0.15) — Runtime/memory optimization, algorithmic complexity
+4. **Robustness** (weight: 0.15) — Error handling, edge cases, graceful degradation
+5. **Maintainability** (weight: 0.15) — Code clarity, modularity, follows conventions
+6. **Usability** (weight: 0.10) — API clarity, interface design, documentation
+
+Output ONLY valid JSON matching this schema (no markdown, no explanation):
+{
+  "scores": [
+    { "dimension": "correctness", "score": 4, "reasoning": "..." },
+    { "dimension": "security", "score": 3, "reasoning": "..." },
+    { "dimension": "efficiency", "score": 4, "reasoning": "..." },
+    { "dimension": "robustness", "score": 3, "reasoning": "..." },
+    { "dimension": "maintainability", "score": 4, "reasoning": "..." },
+    { "dimension": "usability", "score": 3, "reasoning": "..." }
+  ]
+}`;
+const ARCHITECT_GRADING_SYSTEM_PROMPT = `You are a senior software architect evaluator. Grade the provided architectural plan using the ISO/IEC 25010 software quality model, reinterpreted for plan quality.
+
+Score each dimension from 1 (poor) to 5 (excellent) with brief reasoning.
+
+Dimensions:
+1. **Correctness** (weight: 0.30) — Plan addresses the task correctly and completely
+2. **Security** (weight: 0.15) — Plan accounts for security concerns and threat vectors
+3. **Efficiency** (weight: 0.15) — Approach is algorithmically sound and resource-conscious
+4. **Robustness** (weight: 0.15) — Edge cases, failure modes, and error recovery are covered
+5. **Maintainability** (weight: 0.15) — Plan is clear, structured, and actionable
+6. **Usability** (weight: 0.10) — Plan is implementable by an executor without ambiguity
+
+Output ONLY valid JSON matching this schema (no markdown, no explanation):
+{
+  "scores": [
+    { "dimension": "correctness", "score": 4, "reasoning": "..." },
+    { "dimension": "security", "score": 3, "reasoning": "..." },
+    { "dimension": "efficiency", "score": 4, "reasoning": "..." },
+    { "dimension": "robustness", "score": 3, "reasoning": "..." },
+    { "dimension": "maintainability", "score": 4, "reasoning": "..." },
+    { "dimension": "usability", "score": 3, "reasoning": "..." }
+  ]
+}`;
+function stripFences(text) {
+    let cleaned = text.trim();
+    if (cleaned.startsWith("```json")) {
+        cleaned = cleaned.slice(7);
+    }
+    else if (cleaned.startsWith("```")) {
+        cleaned = cleaned.slice(3);
+    }
+    if (cleaned.endsWith("```")) {
+        cleaned = cleaned.slice(0, -3);
+    }
+    return cleaned.trim();
+}
+function parseGradingResponse(text) {
+    const cleaned = stripFences(text);
+    const parsed = JSON.parse(cleaned);
+    if (!parsed || !Array.isArray(parsed.scores)) {
+        throw new Error("Grading response missing 'scores' array");
+    }
+    const validDims = new Set(GRADING_DIMENSIONS);
+    return parsed.scores
+        .filter((s) => typeof s === "object" &&
+        s !== null &&
+        "dimension" in s &&
+        "score" in s &&
+        "reasoning" in s)
+        .filter((s) => validDims.has(s.dimension))
+        .map((s) => ({
+        dimension: s.dimension,
+        score: Math.max(1, Math.min(5, Math.round(Number(s.score)))),
+        reasoning: String(s.reasoning),
+    }));
+}
+function computeComposite(dimensions) {
+    let weighted = 0;
+    let totalWeight = 0;
+    for (const dim of dimensions) {
+        const weight = DIMENSION_WEIGHTS[dim.dimension] ?? 0;
+        weighted += dim.score * weight;
+        totalWeight += weight;
+    }
+    return totalWeight > 0 ? weighted / totalWeight : 0;
+}
+export class GradingRubric {
+    router;
+    constructor(router) {
+        this.router = router;
+    }
+    async grade(opts) {
+        const subjectLabel = opts.role === "architect" ? "Architectural Plan" : "Code Output";
+        const gradeLabel = opts.role === "architect"
+            ? "Grade this architectural plan on all 6 ISO/IEC 25010 dimensions."
+            : "Grade this code output on all 6 ISO/IEC 25010 dimensions.";
+        const userPrompt = `## Task
+${opts.taskDescription}
+
+## ${subjectLabel} (by ${opts.model}, role: ${opts.role})
+\`\`\`
+${opts.code}
+\`\`\`
+
+${gradeLabel}`;
+        const prompt = opts.systemPrompt ?? GRADING_SYSTEM_PROMPT;
+        const messages = [
+            { role: "system", content: prompt },
+            { role: "user", content: userPrompt },
+        ];
+        let judgeRationale;
+        let result;
+        if (opts.judgeModel) {
+            // Tier 1: Explicit judge override — use it directly
+            result = await this.router.generate({
+                model: opts.judgeModel,
+                messages,
+                temperature: 0.1,
+            });
+            judgeRationale = `explicit override: ${opts.judgeModel}`;
+        }
+        else {
+            // Tier 2: Cross-provider — exclude the graded model's logical provider
+            const logicalProvider = extractLogicalProvider(opts.model);
+            try {
+                result = await this.router.generate({
+                    messages,
+                    route: {
+                        requiredCapabilities: ["deep_reasoning"],
+                        requireStreaming: false,
+                        excludedProviders: [logicalProvider],
+                        excludedModels: [opts.model],
+                    },
+                    temperature: 0.1,
+                });
+                judgeRationale = `cross-provider: excluded provider "${logicalProvider}" and model "${opts.model}"`;
+            }
+            catch {
+                // Tier 3: Fallback — single provider, just exclude the exact model
+                try {
+                    result = await this.router.generate({
+                        messages,
+                        route: {
+                            requiredCapabilities: ["deep_reasoning"],
+                            requireStreaming: false,
+                            excludedModels: [opts.model],
+                        },
+                        temperature: 0.1,
+                    });
+                    judgeRationale = `same-provider fallback: excluded model "${opts.model}" (cross-provider unavailable)`;
+                }
+                catch {
+                    // Last resort: no exclusions
+                    result = await this.router.generate({
+                        messages,
+                        route: {
+                            requiredCapabilities: ["deep_reasoning"],
+                            requireStreaming: false,
+                        },
+                        temperature: 0.1,
+                    });
+                    judgeRationale = `no exclusion available: single model environment`;
+                }
+            }
+        }
+        const dimensions = parseGradingResponse(result.response.text);
+        // Fill in any missing dimensions with score 3
+        const foundDims = new Set(dimensions.map((d) => d.dimension));
+        for (const dim of GRADING_DIMENSIONS) {
+            if (!foundDims.has(dim)) {
+                dimensions.push({
+                    dimension: dim,
+                    score: 3,
+                    reasoning: "Not evaluated — defaulted to neutral score.",
+                });
+            }
+        }
+        const compositeScore = computeComposite(dimensions);
+        return {
+            model: opts.model,
+            role: opts.role,
+            dimensions,
+            compositeScore,
+            gradedBy: result.response.model,
+            judgeRationale,
+            taskId: opts.taskId,
+        };
+    }
+    async gradeArchitectPlan(opts) {
+        return this.grade({
+            code: opts.plan,
+            taskDescription: opts.taskDescription,
+            model: opts.model,
+            role: "architect",
+            taskId: opts.taskId,
+            judgeModel: opts.judgeModel,
+            systemPrompt: ARCHITECT_GRADING_SYSTEM_PROMPT,
+        });
+    }
+    async compareOutputs(opts) {
+        const [gradeA, gradeB] = await Promise.all([
+            this.grade({
+                code: opts.codeA,
+                taskDescription: opts.taskDescription,
+                model: opts.modelA,
+                role: opts.role,
+                taskId: opts.taskId,
+            }),
+            this.grade({
+                code: opts.codeB,
+                taskDescription: opts.taskDescription,
+                model: opts.modelB,
+                role: opts.role,
+                taskId: opts.taskId,
+            }),
+        ]);
+        const delta = gradeA.compositeScore - gradeB.compositeScore;
+        const isDraw = Math.abs(delta) < 0.15;
+        const winner = isDraw
+            ? opts.modelA
+            : delta > 0
+                ? opts.modelA
+                : opts.modelB;
+        return {
+            gradeA,
+            gradeB,
+            winner,
+            isDraw,
+            scoreDelta: Math.abs(delta),
+        };
+    }
+}
+//# sourceMappingURL=grading_rubric.js.map

package/dist/providers/grading_rubric.js.map

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,12 @@
+import type { GenerateRequest, ModelProvider, ProviderResponse, ProviderStreamEvent } from "./base.js";
+export declare class OpenAIProvider implements ModelProvider {
+    readonly name: "openai";
+    private readonly client;
+    constructor(params?: {
+        apiKey?: string;
+        baseURL?: string;
+    });
+    supportsModel(model: string): boolean;
+    generate(request: GenerateRequest): Promise<ProviderResponse>;
+    stream(request: GenerateRequest): AsyncIterable<ProviderStreamEvent>;
+}

package/dist/providers/openai.js

@@ -0,0 +1,229 @@
+import OpenAI from "openai";
+function toOpenAiMessages(messages) {
+    return messages.map((message) => {
+        if (message.role === "tool") {
+            return {
+                role: "tool",
+                content: message.content,
+                tool_call_id: message.toolCallId ?? "",
+            };
+        }
+        // Assistant message carrying tool calls
+        if (message.role === "assistant" &&
+            message.toolCalls &&
+            message.toolCalls.length > 0) {
+            return {
+                role: "assistant",
+                content: message.content || null,
+                tool_calls: message.toolCalls.map((tc) => ({
+                    id: tc.id,
+                    type: "function",
+                    function: {
+                        name: tc.name,
+                        arguments: JSON.stringify(tc.input),
+                    },
+                })),
+            };
+        }
+        if (message.role === "system") {
+            return {
+                role: "system",
+                content: message.content,
+                name: message.name,
+            };
+        }
+        if (message.role === "assistant") {
+            return {
+                role: "assistant",
+                content: message.content,
+                name: message.name,
+            };
+        }
+        return {
+            role: "user",
+            content: message.content,
+            name: message.name,
+        };
+    });
+}
+function toOpenAiTools(tools) {
+    if (!tools || tools.length === 0) {
+        return undefined;
+    }
+    return tools.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema,
+        },
+    }));
+}
+function toOpenAiToolChoice(choice) {
+    if (choice === "auto")
+        return "auto";
+    if (choice === "required")
+        return "required";
+    if (choice === "none")
+        return "none";
+    return undefined;
+}
+function parseToolCalls(rawToolCalls) {
+    if (!rawToolCalls) {
+        return [];
+    }
+    const calls = [];
+    for (const call of rawToolCalls) {
+        if (call.type !== "function")
+            continue;
+        const rawArguments = call.function?.arguments;
+        let input = {};
+        if (typeof rawArguments === "string" && rawArguments.length > 0) {
+            try {
+                input = JSON.parse(rawArguments);
+            }
+            catch {
+                input = { __raw: rawArguments };
+            }
+        }
+        calls.push({
+            id: String(call.id ?? ""),
+            name: String(call.function?.name ?? ""),
+            input,
+        });
+    }
+    return calls;
+}
+export class OpenAIProvider {
+    name = "openai";
+    client;
+    constructor(params) {
+        this.client = new OpenAI({
+            apiKey: params?.apiKey ?? process.env.OPENAI_API_KEY,
+            baseURL: params?.baseURL,
+        });
+    }
+    supportsModel(model) {
+        // Accept any model when using OpenRouter (base URL override)
+        if (this.client.baseURL && !this.client.baseURL.includes("api.openai.com")) {
+            return true;
+        }
+        // Reject Anthropic models on the native OpenAI endpoint
+        if (model.startsWith("claude"))
+            return false;
+        return true;
+    }
+    async generate(request) {
+        const params = {
+            model: request.model,
+            messages: toOpenAiMessages(request.messages),
+            tools: toOpenAiTools(request.tools),
+            tool_choice: toOpenAiToolChoice(request.toolChoice),
+            temperature: request.temperature,
+            max_tokens: request.maxOutputTokens,
+        };
+        const completion = await this.client.chat.completions.create(params);
+        const choice = completion.choices?.[0];
+        const message = choice?.message;
+        const toolCalls = parseToolCalls(message?.tool_calls);
+        return {
+            provider: this.name,
+            model: completion.model,
+            text: typeof message?.content === "string" ? message.content : "",
+            toolCalls,
+            stopReason: choice?.finish_reason ?? null,
+            usage: {
+                inputTokens: completion.usage?.prompt_tokens ?? 0,
+                outputTokens: completion.usage?.completion_tokens ?? 0,
+            },
+            raw: completion,
+        };
+    }
+    async *stream(request) {
+        const params = {
+            model: request.model,
+            messages: toOpenAiMessages(request.messages),
+            tools: toOpenAiTools(request.tools),
+            tool_choice: toOpenAiToolChoice(request.toolChoice),
+            temperature: request.temperature,
+            max_tokens: request.maxOutputTokens,
+            stream: true,
+            stream_options: { include_usage: true },
+        };
+        const stream = await this.client.chat.completions.create(params);
+        const textParts = [];
+        const toolCallBuffers = new Map();
+        let finalUsage = { inputTokens: 0, outputTokens: 0 };
+        let model = request.model;
+        let stopReason = null;
+        try {
+            for await (const chunk of stream) {
+                model = chunk.model ?? model;
+                if (chunk.usage) {
+                    finalUsage = {
+                        inputTokens: chunk.usage.prompt_tokens ?? finalUsage.inputTokens,
+                        outputTokens: chunk.usage.completion_tokens ?? finalUsage.outputTokens,
+                    };
+                    yield { type: "usage", usage: finalUsage };
+                }
+                const delta = chunk.choices?.[0]?.delta;
+                const finishReason = chunk.choices?.[0]?.finish_reason;
+                if (finishReason) {
+                    stopReason = finishReason;
+                }
+                if (typeof delta?.content === "string" && delta.content.length > 0) {
+                    textParts.push(delta.content);
+                    yield { type: "text-delta", delta: delta.content };
+                }
+                const chunkToolCalls = delta?.tool_calls;
+                if (chunkToolCalls && chunkToolCalls.length > 0) {
+                    for (const toolCall of chunkToolCalls) {
+                        const key = String(toolCall.id ?? toolCall.index ?? "0");
+                        const existing = toolCallBuffers.get(key) ?? { name: "", args: "" };
+                        if (typeof toolCall?.function?.name === "string") {
+                            existing.name = toolCall.function.name;
+                        }
+                        if (typeof toolCall?.function?.arguments === "string") {
+                            existing.args += toolCall.function.arguments;
+                        }
+                        toolCallBuffers.set(key, existing);
+                    }
+                }
+            }
+            const parsedCalls = [...toolCallBuffers.entries()].map(([id, raw]) => {
+                let input = {};
+                if (raw.args.length > 0) {
+                    try {
+                        input = JSON.parse(raw.args);
+                    }
+                    catch {
+                        input = { __raw: raw.args };
+                    }
+                }
+                return {
+                    id,
+                    name: raw.name,
+                    input,
+                };
+            });
+            for (const call of parsedCalls) {
+                yield { type: "tool-call", call };
+            }
+            const response = {
+                provider: this.name,
+                model,
+                text: textParts.join(""),
+                toolCalls: parsedCalls,
+                stopReason,
+                usage: finalUsage,
+            };
+            yield { type: "done", response };
+        }
+        catch (error) {
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            yield { type: "error", error: normalized };
+            throw normalized;
+        }
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAU5B,SAAS,gBAAgB,CAAC,QAAuB;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAA0C,EAAE;QACtE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,YAAY,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;aACvC,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,IACE,OAAO,CAAC,IAAI,KAAK,WAAW;YAC5B,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAC5B,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;gBAChC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAA6C,EAAE,CAAC,CAAC;oBACpF,EAAE,EAAE,EAAE,CAAC,EAAE;oBACT,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE;wBACR,IAAI,EAAE,EAAE,CAAC,IAAI;wBACb,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC;qBACpC;iBACF,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAA+B;IACpD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAkC,EAAE,CAAC,CAAC;QAC1D,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,WAAwC;SAC1D;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAqC;IAC/D,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACrC,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC7C,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACrC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,YAA4E;IAClG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC9C,IAAI,KAAK,GAA4B,EAAE,CAAC;QAExC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAA4B,CAAC;YAC9D,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;YACvC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,QAAiB,CAAC;IAEjB,MAAM,CAAS;IAEhC,YAAY,MAA8C;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;YACpD,OAAO,EAAE,MAAM,EAAE,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,6DAA6D;QAC7D,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wDAAwD;QACxD,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,MAAM,MAAM,GAAuD;YACjE,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC5C,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;YACnC,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC;YACnD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,eAAe;SACpC,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAErE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC;QAChC,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEtD,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,IAAI,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACjE,SAAS;YACT,UAAU,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;YACzC,KAAK,EAAE;gBACL,WAAW,EAAE,UAAU,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;gBACjD,YAAY,EAAE,UAAU,CAAC,KAAK,EAAE,iBAAiB,IAAI,CAAC;aACvD;YACD,GAAG,EAAE,UAAU;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,OAAwB;QACpC,MAAM,MAAM,GAAoD;YAC9D,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC5C,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC;YACnC,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC;YACnD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,eAAe;YACnC,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;SACxC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEjE,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0C,CAAC;QAC1E,IAAI,UAAU,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1B,IAAI,UAAU,GAAkB,IAAI,CAAC;QAErC,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACjC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;gBAE7B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAChB,UAAU,GAAG;wBACX,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,IAAI,UAAU,CAAC,WAAW;wBAChE,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,IAAI,UAAU,CAAC,YAAY;qBACvE,CAAC;oBACF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;gBAC7C,CAAC;gBAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;gBACxC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;gBACvD,IAAI,YAAY,EAAE,CAAC;oBACjB,UAAU,GAAG,YAAY,CAAC;gBAC5B,CAAC;gBAED,IAAI,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC9B,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;gBACrD,CAAC;gBAED,MAAM,cAAc,GAAG,KAAK,EAAE,UAAU,CAAC;gBACzC,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;wBACtC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;wBACzD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;wBAEpE,IAAI,OAAO,QAAQ,EAAE,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;4BACjD,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;wBACzC,CAAC;wBACD,IAAI,OAAO,QAAQ,EAAE,QAAQ,EAAE,SAAS,KAAK,QAAQ,EAAE,CAAC;4BACtD,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;wBAC/C,CAAC;wBAED,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAe,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE;gBAC/E,IAAI,KAAK,GAA4B,EAAE,CAAC;gBACxC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC;wBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAA4B,CAAC;oBAC1D,CAAC;oBAAC,MAAM,CAAC;wBACP,KAAK,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBAED,OAAO;oBACL,EAAE;oBACF,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,KAAK;iBACN,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YACpC,CAAC;YAED,MAAM,QAAQ,GAAqB;gBACjC,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,KAAK;gBACL,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,SAAS,EAAE,WAAW;gBACtB,UAAU;gBACV,KAAK,EAAE,UAAU;aAClB,CAAC;YAEF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YAC3C,MAAM,UAAU,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/providers/openrouter.d.ts

@@ -0,0 +1,14 @@
+import type { GenerateRequest, ModelProvider, ProviderResponse, ProviderStreamEvent } from "./base.js";
+export declare class OpenRouterProvider implements ModelProvider {
+    readonly name: "openrouter";
+    private readonly client;
+    constructor(params?: {
+        apiKey?: string;
+        baseURL?: string;
+        appName?: string;
+        siteUrl?: string;
+    });
+    supportsModel(_model: string): boolean;
+    generate(request: GenerateRequest): Promise<ProviderResponse>;
+    stream(request: GenerateRequest): AsyncIterable<ProviderStreamEvent>;
+}