@deepthonk/providers 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,293 @@
+# DeepThonk
+
+*thonk harder, not richer.*
+
+DeepThonk implements the OpenDeepThink algorithm (Zhou et al., 2026, [arXiv:2605.15177](https://arxiv.org/abs/2605.15177)) as a budget-friendly, provider-neutral "deep think / pro mode" wrapper, with first-class DeepSeek support. See [Acknowledgments](#acknowledgments).
+
+DeepThonk runs a population of candidate answers through pairwise judging, Bradley-Terry ranking, critique-guided mutation, elite preservation, and a final dense ranking pass. The CLI and MCP server both call the same TypeScript core engine.
+
+**Designed for agents.** Every algorithm dimension — population shape (`n`, `k`, `t`, `m`), regularization (`lambda`), per-phase temperatures, prompt style, and per-phase prompt templates — is reachable inline through MCP arguments and CLI flags. No filesystem detours required. Every intermediate artifact (candidates, comparisons, scores, per-call usage, status) is exposed as a streaming MCP resource so an agent can inspect any step. See [Customization](https://github.com/linxule/deepthonk/blob/main/docs/customization.md) for the full agent-composable surface.
+
+Use it for hard, verifiable reasoning, coding, planning, and synthesis where breadth plus judgment can beat one expensive single shot. Avoid it for highly subjective tasks where judge noise dominates.
+
+## Quickstart
+
+Run without installing:
+
+```bash
+npx -y deepthonk plan --profile paper
+npx -y deepthonk run --provider fake --profile quick \
+  --task "Find the smallest positive integer divisible by 3, 4, and 5." \
+  --out runs/test-quick
+npx -y deepthonk inspect runs/test-quick
+```
+
+Or install globally:
+
+```bash
+npm install -g deepthonk
+deepthonk plan --profile paper
+```
+
+The paper profile plans 285 model calls and 8 sequential rounds. Confirm budget and provider pricing before pointing it at paid models. The short alias `dt` is installed alongside `deepthonk`. Develop from source: see [Development](#development).
+
+> v0.1 scope: an independent TypeScript reimplementation of the OpenDeepThink algorithm as a CLI + MCP server. The published algorithm is the load-bearing part; this release is a practical integration layer with explicit limits documented below. Cost guarantees rely on provider pricing being present in config; resume only inspects trace state, it does not replay; the MCP HTTP transport is loopback-only. The included acceptance smoke uses the deterministic fake provider and a toy task — it is not a CF-73 / HLE reproduction; see `docs/` and [Acknowledgments](#acknowledgments) for the canonical paper and Python reference.
+
+## Setup
+
+Create a reusable local config:
+
+```bash
+deepthonk setup \
+  --provider deepseek \
+  --api-key-env DEEPSEEK_API_KEY \
+  --fast-model deepseek-v4-flash \
+  --judge-model deepseek-v4-pro
+```
+
+By default this writes `~/.config/deepthonk/config.yaml`. `deepthonk run` loads that file automatically when `--config` is not supplied. If you pass `--api-key`, setup stores it in `~/.config/deepthonk/env`; otherwise it uses the named environment variable from your shell.
+
+## DeepSeek
+
+```bash
+export DEEPSEEK_API_KEY=...
+deepthonk run \
+  --task task.md \
+  --profile paper \
+  --provider deepseek \
+  --generator-model deepseek-v4-flash \
+  --mutator-model deepseek-v4-flash \
+  --judge-model deepseek-v4-pro \
+  --out runs/task-paper
+```
+
+DeepSeek is implemented as an OpenAI-compatible profile using `https://api.deepseek.com/v1`. DeepThonk ships default USD pricing for `deepseek-v4-flash` and `deepseek-v4-pro` from the official DeepSeek pricing page, including cache-hit/cache-miss input rates. Model names and prices are still editable config because both can change.
+
+Before paid runs, inspect cost shape and resolved config:
+
+```bash
+deepthonk plan --config ~/.config/deepthonk/config.yaml
+deepthonk run --task task.md --config ~/.config/deepthonk/config.yaml --profile quick --dry-run
+```
+
+Start with `--profile quick` and consider `--max-concurrency`, `--max-input-tokens`, `--max-output-tokens`, `--max-usd`, and `--request-timeout-ms` before larger paid profiles. Runtime token/USD budgets are enforced after completed provider calls and can overshoot by at most the active concurrency window. Every completed run summary includes call/token usage, and includes `usage.usd` when matching model pricing is available.
+
+## OpenAI-Compatible Providers
+
+```bash
+export DEEPTHONK_API_KEY=...
+deepthonk run \
+  --task task.md \
+  --profile balanced \
+  --provider openai-compatible \
+  --base-url https://provider.example.com/v1 \
+  --api-key-env DEEPTHONK_API_KEY \
+  --generator-model cheap-model \
+  --judge-model strong-model
+```
+
+The driver calls `POST {base_url}/chat/completions` and requests JSON mode for comparisons when supported. If a provider returns a `400` with a body that mentions `response_format` or `json`, the driver retries without JSON mode and uses robust JSON extraction on the plain text response. Providers that reject JSON mode with a different status code (e.g. `422`) surface as a normal provider error — set `supportsJsonMode: false` in YAML to disable JSON mode up front.
+
+Provider names are flexible. For a custom OpenAI-compatible endpoint, use any provider label with `--base-url`, `--api-key-env`, and role-specific model flags. For OpenRouter:
+
+```bash
+export OPENROUTER_API_KEY=...
+deepthonk run \
+  --task task.md \
+  --profile balanced \
+  --provider openrouter \
+  --generator-model openrouter/auto \
+  --mutator-model openrouter/auto \
+  --judge-model openrouter/auto
+```
+
+For mixed-provider runs, use YAML config and override individual roles under `providers`, especially `judge`.
+
+Optional `finalizer_model` / `--finalizer-model` can post-process the ranked winner. Leave it unset when you want the raw ranked answer as the final artifact.
+
+## MCP
+
+The MCP server exposes the same engine the CLI runs. Once wired into an MCP host, the host can plan budgets, kick off background runs, poll status, fetch winners, and stream structured trace artifacts — all through MCP tools, resources, and prompts.
+
+Provider API keys come from the host process's environment, not from DeepThonk's config alone. Each host handles env passthrough slightly differently — see the concrete patterns below.
+
+### Claude Code
+
+```bash
+claude mcp add deepthonk \
+  -e DEEPSEEK_API_KEY=$DEEPSEEK_API_KEY \
+  -- npx -y deepthonk serve-mcp --transport stdio
+```
+
+Use `-s user` for cross-project scope or `-s project` to commit registration into `.claude/`. Verify with `claude mcp list`. See `claude mcp --help` for the authoritative flag set.
+
+### Claude Desktop
+
+Config path: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%\Claude\claude_desktop_config.json` (Windows), `~/.config/Claude/claude_desktop_config.json` (Linux). Add:
+
+```json
+{
+  "mcpServers": {
+    "deepthonk": {
+      "command": "npx",
+      "args": ["-y", "deepthonk", "serve-mcp", "--transport", "stdio"],
+      "env": {
+        "DEEPSEEK_API_KEY": "sk-..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after editing.
+
+### Cursor
+
+Project-scoped: `.cursor/mcp.json` in the workspace. User-global: `~/.cursor/mcp.json`. Same JSON shape as Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "deepthonk": {
+      "command": "npx",
+      "args": ["-y", "deepthonk", "serve-mcp", "--transport", "stdio"],
+      "env": { "DEEPSEEK_API_KEY": "sk-..." }
+    }
+  }
+}
+```
+
+### Other MCP hosts (stdio)
+
+Any host that speaks MCP stdio launches:
+
+```bash
+npx -y deepthonk serve-mcp --transport stdio
+```
+
+with the relevant provider env vars set on the process. If you'd rather install globally, `npm install -g deepthonk` then use `command: "deepthonk"` directly. Refer to the host's MCP registration docs for the configuration shape.
+
+### Streamable HTTP
+
+For local web hosts, or when stdio isn't available:
+
+```bash
+deepthonk serve-mcp --transport http --port 3333
+```
+
+The server binds `127.0.0.1:3333` only (loopback) and the endpoint is `POST http://127.0.0.1:3333/mcp`. DNS rebinding protection is on (CVE-2025-66414): requests with `Host` headers outside `127.0.0.1:3333` / `localhost:3333` are rejected. Do not expose this port through a reverse proxy without re-evaluating that trust boundary.
+
+### Tools
+
+| Tool | Purpose |
+|---|---|
+| `deepthonk.plan` | Estimate calls and sequential rounds for a profile (no model calls). Use before paid runs. |
+| `deepthonk.start` | Start a run in the background; returns `run_dir` + `job_id`. |
+| `deepthonk.status` | Poll job status from a `run_dir`. |
+| `deepthonk.result` | Return final summary + winner once a job is complete. |
+| `deepthonk.cancel` | Request cancellation by writing `cancel.json` into the run directory. |
+| `deepthonk.run` | Blocking convenience: start + await completion in one call. Prefer `start` + polling for long-running jobs. |
+| `deepthonk.rank` | Rank a user-supplied candidate set with pairwise judging + Bradley-Terry (skip generation). |
+| `deepthonk.mutate` | Mutate one supplied candidate with critique (one-shot). |
+| `deepthonk.resume` | Detect whether a run can be resumed. Reports state only; does not replay yet. |
+| `deepthonk.export` | Export run summary or full trace in JSON or markdown. |
+
+All tools accept inline provider/model fields, or `config_path` pointing at a DeepThonk YAML config.
+
+### Resources
+
+- `deepthonk://runs` — JSON index of all runs in `runs/`.
+- `deepthonk://runs/{run_id}/summary` — run summary (JSON).
+- `deepthonk://runs/{run_id}/{candidates|comparisons|scores|trace}` — per-phase NDJSON.
+- `deepthonk://runs/{run_id}/{winner|final}` — text artifacts.
+- `deepthonk://runs/{run_id}/status` — run state (JSON).
+- `deepthonk://jobs/{job_id}/{status|result}?run_dir=...` — job-scoped lookup; the `run_dir` query param is required.
+
+### Prompts
+
+Four templates mirror the core loop: `deepthonk/generate`, `deepthonk/compare`, `deepthonk/mutate`, `deepthonk/finalize`. Hosts can render them directly to drive the algorithm by hand without invoking the tool surface.
+
+### Limits
+
+MCP Sampling is deferred and not exposed as a provider mode — direct provider mode is the only option in v0.1. `deepthonk.resume` reports trace state and safe phase boundaries but does not replay interrupted runs. The HTTP transport is loopback-only by design.
+
+## Customization
+
+Every algorithm dimension is reachable through MCP arguments and CLI flags:
+
+- **Population shape**: `n`, `k`, `t`, `m` — override profile defaults inline.
+- **Algorithm constants**: `lambda`, `sample_temperature`, `mutate_temperature`, `judge_temperature`.
+- **Prompt style**: `general` or `paper-programming`.
+- **Per-phase prompt templates**: override `generate`, `compare`, `mutate`, or `finalize` with custom system/user templates and variable substitution (`{task}`, `{rubric}`, `{candidate}`, `{candidateA}`, `{candidateB}`, `{critique}`). Unknown variables throw a fail-fast error at run-start.
+- **Concurrency**: per-phase caps for `generate`, `judge`, `mutate`.
+
+Example agent call (MCP), no YAML file required:
+
+```json
+{
+  "task": "Draft a concise non-solicitation clause for a senior sales employee.",
+  "profile": "balanced",
+  "n": 6, "t": 1,
+  "provider": "deepseek",
+  "judge_model": "deepseek-v4-pro",
+  "prompts": {
+    "generate": { "system": "You are an experienced employment-law attorney." },
+    "compare":  { "system": "Prefer enforceable clauses under California law. Return strict JSON only." }
+  }
+}
+```
+
+CLI accepts the same surface, except prompt overrides are loaded from a YAML file via `--prompts <yaml>` (shell-quoting multi-line templates is hostile). MCP and CLI both merge over any `--config`/`config_path` YAML defaults.
+
+See the [Customization guide](https://github.com/linxule/deepthonk/blob/main/docs/customization.md) for the complete variable contract, the compare-phase JSON safety rule, and three worked examples. Per-role provider routing (`providers.judge.provider = openrouter`) and per-model pricing remain YAML-only — they're nested structured config, not inline ergonomics.
+
+## Trace Files
+
+A successful run writes:
+
+```txt
+runs/{run_id}/
+  config.json
+  events.jsonl
+  candidates.jsonl
+  comparisons.jsonl
+  scores.jsonl
+  usage.jsonl
+  summary.json
+  artifacts/winner.txt
+  artifacts/final.txt
+```
+
+`status.json` is written when the run is launched through MCP `deepthonk.start` (so async clients can poll). `cancel.json` is written only when cancellation is requested. A `run.lock` file is held for the duration of the run.
+
+JSONL writes are streamed as each candidate / comparison / call completes, and all appends go through a per-trace serialization queue. If a run is killed mid-tournament, completed pairs are durable on disk and the JSONL files remain readable.
+
+`usage.jsonl` carries one row per provider call (generator, judge, mutator, finalizer) with phase/role/provider/model/token/USD/latency/retry. It contains no prompt content. `jq` over `usage.jsonl` is the simplest way to break a run's cost down by role.
+
+Prompts and raw model outputs are off by default. API keys are never written. Candidate answers, critiques, scores, and final artifacts are trace data and are stored/exported by design, so do not use a shared run directory for sensitive tasks unless that is acceptable.
+
+## Development
+
+```bash
+pnpm install
+pnpm run build
+pnpm test
+pnpm run lint
+```
+
+This repository is source-only. Generated run traces, paper notes, build output, coverage, logs, and `node_modules` are intentionally ignored.
+
+Known limits for this release:
+
+- Conservative resume reports trace state and safe phase boundaries, but does not replay interrupted runs yet.
+- MCP Sampling is deferred until there is a real host-backed Sampling driver.
+- `maxUsd` requires known model pricing; add explicit prices in YAML for custom providers and model IDs. Optional fields `longContextThresholdTokens`, `inputUsdPerMillionLong`, and `outputUsdPerMillionLong` enable tiered pricing for models with a long-context surcharge (e.g., Gemini at 200K input tokens). Cache hit/miss rates remain flat.
+
+## Acknowledgments
+
+DeepThonk is an independent TypeScript reimplementation of the OpenDeepThink algorithm. It is not a fork; no source code from the reference implementation is vendored. Credit for the algorithm, the benchmark methodology, and the empirical results belongs to the paper authors.
+
+- **Paper**: Shang Zhou, Wenhao Chai, Kaiyuan Liu, Huanzhi Mao, Qiuyang Mang, Jingbo Shang. *OpenDeepThink: Parallel Reasoning via Bradley–Terry Aggregation*. arXiv:2605.15177, 2026. <https://arxiv.org/abs/2605.15177>
+- **Reference Python implementation**: <https://github.com/ZhouShang0817/open-deep-think> (MIT). This is the authors' code release and the canonical implementation for reproducing paper results (CF-73, HLE).
+
+DeepThonk's contribution is an integration layer: a provider-neutral TypeScript core, an MCP server, a CLI, structured trace artifacts, and budget enforcement. The algorithm itself is theirs.

package/dist/defaults.d.ts

@@ -0,0 +1,25 @@
+import type { ProviderConfig, ProviderRole, RoleProviderConfig } from "./types.js";
+export type DirectProviderName = "fake" | "openai-compatible" | "deepseek" | "openrouter";
+export interface ProviderModelOverrides {
+    generator?: string;
+    mutator?: string;
+    judge?: string;
+    finalizer?: string;
+}
+export interface ProviderConfigOptions {
+    provider: string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    apiKey?: string;
+    models?: ProviderModelOverrides;
+    retry?: ProviderConfig["retry"];
+    supportsJsonMode?: boolean;
+    roleProviders?: Partial<Record<ProviderRole, Partial<Omit<RoleProviderConfig, "model">> & {
+        model?: string;
+    }>>;
+}
+export declare function resolveProviderModels(provider: string, overrides?: ProviderModelOverrides): ProviderConfig["models"];
+export declare function resolveProviderConfig(options: ProviderConfigOptions): ProviderConfig;
+export declare function defaultModel(provider: string, role: ProviderRole): string;
+export declare function defaultBaseUrl(provider: string): string | undefined;
+export declare function defaultApiKeyEnv(provider: string): string | undefined;

package/dist/defaults.js

@@ -0,0 +1,71 @@
+export function resolveProviderModels(provider, overrides = {}) {
+    return {
+        generator: overrides.generator ?? defaultModel(provider, "generator"),
+        mutator: overrides.mutator ?? defaultModel(provider, "mutator"),
+        judge: overrides.judge ?? defaultModel(provider, "judge"),
+        finalizer: overrides.finalizer
+    };
+}
+export function resolveProviderConfig(options) {
+    const models = resolveProviderModels(options.provider, options.models);
+    return {
+        provider: options.provider,
+        baseUrl: options.baseUrl ?? defaultBaseUrl(options.provider),
+        apiKeyEnv: options.apiKeyEnv ?? defaultApiKeyEnv(options.provider),
+        apiKey: options.apiKey,
+        models,
+        retry: options.retry,
+        supportsJsonMode: options.supportsJsonMode,
+        roleProviders: resolveRoleProviders(options.provider, models, options.roleProviders, options.retry)
+    };
+}
+export function defaultModel(provider, role) {
+    if (role === "finalizer")
+        return defaultModel(provider, "judge");
+    if (provider === "deepseek")
+        return role === "judge" ? "deepseek-v4-pro" : "deepseek-v4-flash";
+    if (provider === "fake")
+        return "fake-model";
+    if (provider === "openrouter")
+        return "openrouter/auto";
+    return role === "judge" ? "provider/model-large" : "provider/model-small";
+}
+export function defaultBaseUrl(provider) {
+    if (provider === "deepseek")
+        return "https://api.deepseek.com/v1";
+    if (provider === "openrouter")
+        return "https://openrouter.ai/api/v1";
+    return undefined;
+}
+export function defaultApiKeyEnv(provider) {
+    if (provider === "deepseek")
+        return "DEEPSEEK_API_KEY";
+    if (provider === "openrouter")
+        return "OPENROUTER_API_KEY";
+    if (provider === "openai-compatible")
+        return "DEEPTHONK_API_KEY";
+    return undefined;
+}
+function resolveRoleProviders(baseProvider, models, roleProviders, baseRetry) {
+    if (!roleProviders)
+        return undefined;
+    const resolved = {};
+    for (const role of ["generator", "mutator", "judge", "finalizer"]) {
+        const input = roleProviders[role];
+        if (!input)
+            continue;
+        const provider = input.provider ?? baseProvider;
+        const model = input.model ?? models[role] ?? defaultModel(provider, role);
+        resolved[role] = {
+            provider,
+            baseUrl: input.baseUrl ?? defaultBaseUrl(provider),
+            apiKeyEnv: input.apiKeyEnv ?? defaultApiKeyEnv(provider),
+            apiKey: input.apiKey,
+            model,
+            retry: input.retry ?? baseRetry,
+            supportsJsonMode: input.supportsJsonMode
+        };
+    }
+    return Object.keys(resolved).length ? resolved : undefined;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

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

package/dist/fake.d.ts

@@ -0,0 +1,18 @@
+import type { CompareInput, FinalizeInput, GenerateInput, ModelDriver, ModelTextResult, MutateInput } from "@deepthonk/core";
+export interface FakeDriverOptions {
+    seed?: number;
+    failEvery?: number;
+    invalidJsonEvery?: number;
+}
+export declare class FakeDriver implements ModelDriver {
+    private readonly options;
+    private calls;
+    constructor(options?: FakeDriverOptions);
+    generate(input: GenerateInput): Promise<ModelTextResult>;
+    compare(input: CompareInput): Promise<ModelTextResult>;
+    mutate(input: MutateInput): Promise<ModelTextResult>;
+    finalize(input: FinalizeInput): Promise<ModelTextResult>;
+    private tick;
+    private result;
+}
+export declare function quality(text: string): number;

package/dist/fake.js

@@ -0,0 +1,63 @@
+export class FakeDriver {
+    options;
+    calls = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async generate(input) {
+        this.tick();
+        const index = input.candidateIndex ?? 0;
+        const quality = (index + 1) * 10;
+        return this.result(`FAKE_QUALITY:${quality}\nCandidate ${index + 1}: deterministic answer for ${input.task}`);
+    }
+    async compare(input) {
+        this.tick();
+        if (this.options.invalidJsonEvery && this.calls % this.options.invalidJsonEvery === 0) {
+            return this.result("not json");
+        }
+        const qa = quality(input.candidateA.content);
+        const qb = quality(input.candidateB.content);
+        const winner = qa === qb ? "tie" : qa > qb ? "A" : "B";
+        return this.result(JSON.stringify({
+            winner,
+            confidence: winner === "tie" ? 0.5 : 0.9,
+            critique_for_A: qa >= qb ? "A is comparatively strong." : "A is weaker on the synthetic quality signal.",
+            critique_for_B: qb >= qa ? "B is comparatively strong." : "B is weaker on the synthetic quality signal.",
+            selection_reason: `Synthetic quality ${qa} vs ${qb}.`
+        }));
+    }
+    async mutate(input) {
+        this.tick();
+        const nextQuality = quality(input.candidate.content) + 7;
+        return this.result(`FAKE_QUALITY:${nextQuality}\nImproved from ${input.candidate.id}. ${input.candidate.content}`);
+    }
+    async finalize(input) {
+        this.tick();
+        return this.result(input.candidate.content.replace(/^FAKE_QUALITY:\d+\n/, ""));
+    }
+    tick() {
+        this.calls += 1;
+        if (this.options.failEvery && this.calls % this.options.failEvery === 0) {
+            throw new Error(`Fake seeded failure at call ${this.calls}.`);
+        }
+    }
+    result(text) {
+        return {
+            text,
+            model: "fake-model",
+            provider: "fake",
+            usage: {
+                inputTokens: Math.ceil(text.length / 6),
+                outputTokens: Math.ceil(text.length / 5),
+                totalTokens: Math.ceil(text.length / 3)
+            },
+            latencyMs: 0,
+            retryCount: 0
+        };
+    }
+}
+export function quality(text) {
+    const match = text.match(/FAKE_QUALITY:(-?\d+(?:\.\d+)?)/);
+    return match ? Number(match[1]) : 0;
+}
+//# sourceMappingURL=fake.js.map

package/dist/fake.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./fake.js";
+export * from "./defaults.js";
+export * from "./openaiCompatible.js";
+export * from "./pricing.js";
+export * from "./registry.js";
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./fake.js";
+export * from "./defaults.js";
+export * from "./openaiCompatible.js";
+export * from "./pricing.js";
+export * from "./registry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/openaiCompatible.d.ts

@@ -0,0 +1,18 @@
+import { type CompareInput, type FinalizeInput, type GenerateInput, type ModelDriver, type ModelTextResult, type MutateInput } from "@deepthonk/core";
+import type { ProviderConfig } from "./types.js";
+export declare class OpenAiCompatibleDriver implements ModelDriver {
+    private readonly config;
+    readonly provider: string;
+    readonly baseUrl: string;
+    readonly apiKey?: string;
+    readonly httpRetries: number;
+    readonly requestTimeoutMs?: number;
+    readonly supportsJsonMode: boolean;
+    constructor(config: ProviderConfig);
+    generate(input: GenerateInput): Promise<ModelTextResult>;
+    compare(input: CompareInput): Promise<ModelTextResult>;
+    mutate(input: MutateInput): Promise<ModelTextResult>;
+    finalize(input: FinalizeInput): Promise<ModelTextResult>;
+    private chat;
+}
+export declare function createDeepSeekDriver(config?: Partial<ProviderConfig>): OpenAiCompatibleDriver;

package/dist/openaiCompatible.js

@@ -0,0 +1,203 @@
+import { ProviderError } from "@deepthonk/core";
+import { resolveProviderConfig } from "./defaults.js";
+export class OpenAiCompatibleDriver {
+    config;
+    provider;
+    baseUrl;
+    apiKey;
+    httpRetries;
+    requestTimeoutMs;
+    supportsJsonMode;
+    constructor(config) {
+        this.config = config;
+        this.provider = config.provider;
+        this.baseUrl = normalizeBaseUrl(config.baseUrl);
+        this.apiKey = config.apiKey ?? (config.apiKeyEnv ? process.env[config.apiKeyEnv] : undefined);
+        this.httpRetries = config.retry?.httpRetries ?? 12;
+        this.requestTimeoutMs = config.retry?.requestTimeoutMs ?? 120_000;
+        this.supportsJsonMode = config.supportsJsonMode ?? true;
+        if (!this.apiKey) {
+            throw new ProviderError(`Missing API key. Set ${config.apiKeyEnv ?? "apiKey"} for provider ${config.provider}.`, {
+                code: "provider.missing_api_key",
+                retryable: false,
+                fix: `Set ${config.apiKeyEnv ?? "apiKey"} or run deepthonk setup.`
+            });
+        }
+    }
+    async generate(input) {
+        return this.chat(input.model, input.temperature, messages(input), false);
+    }
+    async compare(input) {
+        return this.chat(input.model, input.temperature, messages(input), true);
+    }
+    async mutate(input) {
+        return this.chat(input.model, input.temperature, messages(input), false);
+    }
+    async finalize(input) {
+        return this.chat(input.model, 0.2, messages(input), false);
+    }
+    async chat(model, temperature, messagesValue, jsonMode) {
+        const started = Date.now();
+        let lastError;
+        let retryCount = 0;
+        for (let attempt = 0; attempt <= this.httpRetries; attempt += 1) {
+            let timeout;
+            try {
+                const body = {
+                    model,
+                    messages: messagesValue,
+                    temperature,
+                    max_tokens: 4096
+                };
+                if (jsonMode && this.supportsJsonMode)
+                    body.response_format = { type: "json_object" };
+                const controller = this.requestTimeoutMs ? new AbortController() : undefined;
+                timeout = controller ? setTimeout(() => controller.abort(), this.requestTimeoutMs) : undefined;
+                const response = await fetch(`${this.baseUrl}/chat/completions`, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        authorization: `Bearer ${this.apiKey}`
+                    },
+                    body: JSON.stringify(body),
+                    signal: controller?.signal
+                });
+                if (timeout)
+                    clearTimeout(timeout);
+                timeout = undefined;
+                if (!response.ok) {
+                    const text = await response.text();
+                    if ((response.status === 429 || response.status >= 500) && attempt < this.httpRetries) {
+                        retryCount += 1;
+                        await sleep(retryDelay(response, attempt));
+                        continue;
+                    }
+                    if (jsonMode && this.supportsJsonMode && rejectsJsonMode(response.status, text)) {
+                        return new OpenAiCompatibleDriver({ ...this.config, supportsJsonMode: false }).chat(model, temperature, messagesValue, false);
+                    }
+                    throw providerHttpError(this.provider, response.status);
+                }
+                const json = (await response.json());
+                const choice = json.choices?.[0];
+                if (choice?.finish_reason === "length") {
+                    throw new ProviderError("Provider response was truncated by max_tokens.", {
+                        code: "provider.output_truncated",
+                        retryable: false,
+                        fix: "Use a model/provider with shorter outputs or increase max output token support in provider config."
+                    });
+                }
+                const text = choice?.message?.content;
+                if (!text)
+                    throw new ProviderError("Provider response did not include choices[0].message.content.", { code: "provider.empty_response" });
+                return {
+                    text,
+                    model: json.model ?? model,
+                    provider: this.provider,
+                    usage: {
+                        inputTokens: json.usage?.prompt_tokens,
+                        inputCacheHitTokens: json.usage?.prompt_cache_hit_tokens,
+                        inputCacheMissTokens: json.usage?.prompt_cache_miss_tokens,
+                        outputTokens: json.usage?.completion_tokens,
+                        totalTokens: json.usage?.total_tokens
+                    },
+                    latencyMs: Date.now() - started,
+                    retryCount,
+                    raw: json
+                };
+            }
+            catch (error) {
+                if (timeout)
+                    clearTimeout(timeout);
+                lastError = error;
+                if (attempt < this.httpRetries && isRetryableError(error)) {
+                    retryCount += 1;
+                    await sleep(backoff(attempt));
+                    continue;
+                }
+                break;
+            }
+        }
+        if (lastError instanceof ProviderError)
+            throw lastError;
+        if (isAbortError(lastError)) {
+            throw new ProviderError(`Provider request timed out after ${this.requestTimeoutMs}ms.`, {
+                code: "provider.timeout",
+                retryable: true,
+                fix: "Raise requestTimeoutMs or use a faster model/provider."
+            });
+        }
+        throw new ProviderError(`Provider request failed: ${lastError.message}`, {
+            code: "provider.request_failed",
+            retryable: true,
+            fix: "Check provider availability, base URL, and network connectivity."
+        });
+    }
+}
+export function createDeepSeekDriver(config = {}) {
+    return new OpenAiCompatibleDriver(resolveProviderConfig({
+        provider: "deepseek",
+        ...config
+    }));
+}
+function messages(input) {
+    if (!input.prompt)
+        throw new ProviderError("Core did not provide prompt messages.");
+    const chatMessages = [
+        { role: "system", content: input.prompt.system },
+        { role: "user", content: input.prompt.user }
+    ];
+    return chatMessages.filter((message) => message.content.trim().length > 0);
+}
+function normalizeBaseUrl(baseUrl) {
+    if (!baseUrl) {
+        throw new ProviderError("OpenAI-compatible provider requires baseUrl.", {
+            code: "provider.missing_base_url",
+            retryable: false,
+            fix: "Set base_url in config or pass --base-url."
+        });
+    }
+    return baseUrl.replace(/\/+$/, "");
+}
+function rejectsJsonMode(status, body) {
+    return status === 400 && /response_format|json/i.test(body);
+}
+function isRetryableError(error) {
+    if (error instanceof ProviderError)
+        return error.retryable;
+    return true;
+}
+function providerHttpError(provider, status) {
+    const retryable = status === 429 || status >= 500;
+    return new ProviderError(`Provider HTTP ${status} from ${provider}.`, {
+        code: `provider.http_${status}`,
+        retryable,
+        fix: retryable ? "Retry later or lower concurrency." : "Check provider configuration, request shape, and model access."
+    });
+}
+function retryDelay(response, attempt) {
+    const retryAfter = response.headers.get("retry-after");
+    if (!retryAfter)
+        return backoff(attempt);
+    const seconds = Number(retryAfter);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const timestamp = Date.parse(retryAfter);
+    if (Number.isFinite(timestamp))
+        return Math.max(0, timestamp - Date.now());
+    return backoff(attempt);
+}
+function isAbortError(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
+function backoff(attempt) {
+    // Multiplicative jitter (±20% around the capped exponential base) matches the reference
+    // Python's burst dispersion. Additive jitter at the 60s cap was effectively ±0.4% and would
+    // align concurrent retries into the next provider rate-limit window.
+    const base = Math.min(60_000, 500 * 2 ** attempt);
+    const jitterFactor = 0.8 + Math.random() * 0.4;
+    return Math.floor(base * jitterFactor);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=openaiCompatible.js.map

package/dist/openaiCompatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiCompatible.js","sourceRoot":"","sources":["../src/openaiCompatible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuH,MAAM,iBAAiB,CAAC;AACrK,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAoBtD,MAAM,OAAO,sBAAsB;IAQJ;IAPpB,QAAQ,CAAS;IACjB,OAAO,CAAS;IAChB,MAAM,CAAU;IAChB,WAAW,CAAS;IACpB,gBAAgB,CAAU;IAC1B,gBAAgB,CAAU;IAEnC,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;QACjD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9F,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,KAAK,EAAE,gBAAgB,IAAI,OAAO,CAAC;QAClE,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,aAAa,CAAC,wBAAwB,MAAM,CAAC,SAAS,IAAI,QAAQ,iBAAiB,MAAM,CAAC,QAAQ,GAAG,EAAE;gBAC/G,IAAI,EAAE,0BAA0B;gBAChC,SAAS,EAAE,KAAK;gBAChB,GAAG,EAAE,OAAO,MAAM,CAAC,SAAS,IAAI,QAAQ,0BAA0B;aACnE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAoB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAmB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAoB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,WAAmB,EAAE,aAA4B,EAAE,QAAiB;QACpG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,SAAkB,CAAC;QACvB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAChE,IAAI,OAAmC,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,GAA4B;oBACpC,KAAK;oBACL,QAAQ,EAAE,aAAa;oBACvB,WAAW;oBACX,UAAU,EAAE,IAAI;iBACjB,CAAC;gBACF,IAAI,QAAQ,IAAI,IAAI,CAAC,gBAAgB;oBAAE,IAAI,CAAC,eAAe,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;gBACtF,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC7E,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC/F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,EAAE;oBAC/D,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;qBACvC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,UAAU,EAAE,MAAM;iBAC3B,CAAC,CAAC;gBACH,IAAI,OAAO;oBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,GAAG,SAAS,CAAC;gBACpB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACnC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;wBACtF,UAAU,IAAI,CAAC,CAAC;wBAChB,MAAM,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;wBAC3C,SAAS;oBACX,CAAC;oBACD,IAAI,QAAQ,IAAI,IAAI,CAAC,gBAAgB,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;wBAChF,OAAO,IAAI,sBAAsB,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;oBAChI,CAAC;oBACD,MAAM,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAC;gBAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBACjC,IAAI,MAAM,EAAE,aAAa,KAAK,QAAQ,EAAE,CAAC;oBACvC,MAAM,IAAI,aAAa,CAAC,gDAAgD,EAAE;wBACxE,IAAI,EAAE,2BAA2B;wBACjC,SAAS,EAAE,KAAK;wBAChB,GAAG,EAAE,oGAAoG;qBAC1G,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;gBACtC,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,aAAa,CAAC,+DAA+D,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;gBACzI,OAAO;oBACL,IAAI;oBACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;oBAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE;wBACL,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa;wBACtC,mBAAmB,EAAE,IAAI,CAAC,KAAK,EAAE,uBAAuB;wBACxD,oBAAoB,EAAE,IAAI,CAAC,KAAK,EAAE,wBAAwB;wBAC1D,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,iBAAiB;wBAC3C,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY;qBACtC;oBACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;oBAC/B,UAAU;oBACV,GAAG,EAAE,IAAI;iBACV,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO;oBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnC,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC1D,UAAU,IAAI,CAAC,CAAC;oBAChB,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC9B,SAAS;gBACX,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,SAAS,YAAY,aAAa;YAAE,MAAM,SAAS,CAAC;QACxD,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,aAAa,CAAC,oCAAoC,IAAI,CAAC,gBAAgB,KAAK,EAAE;gBACtF,IAAI,EAAE,kBAAkB;gBACxB,SAAS,EAAE,IAAI;gBACf,GAAG,EAAE,wDAAwD;aAC9D,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,aAAa,CAAC,4BAA6B,SAAmB,CAAC,OAAO,EAAE,EAAE;YAClF,IAAI,EAAE,yBAAyB;YAC/B,SAAS,EAAE,IAAI;YACf,GAAG,EAAE,kEAAkE;SACxE,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAkC,EAAE;IACvE,OAAO,IAAI,sBAAsB,CAAC,qBAAqB,CAAC;QACtD,QAAQ,EAAE,UAAU;QACpB,GAAG,MAAM;KACV,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiE;IACjF,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,aAAa,CAAC,uCAAuC,CAAC,CAAC;IACpF,MAAM,YAAY,GAAkB;QAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;QAChD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;KAC7C,CAAC;IACF,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CAAC,8CAA8C,EAAE;YACtE,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,KAAK;YAChB,GAAG,EAAE,4CAA4C;SAClD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,IAAY;IACnD,OAAO,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,aAAa;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,MAAc;IACzD,MAAM,SAAS,GAAG,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;IAClD,OAAO,IAAI,aAAa,CAAC,iBAAiB,MAAM,SAAS,QAAQ,GAAG,EAAE;QACpE,IAAI,EAAE,iBAAiB,MAAM,EAAE;QAC/B,SAAS;QACT,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,gEAAgE;KACxH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,QAAkB,EAAE,OAAe;IACrD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvD,IAAI,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3E,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AAC/D,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,wFAAwF;IACxF,4FAA4F;IAC5F,qEAAqE;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/pricing.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderConfig } from "./types.js";
+export interface ModelPrice {
+    provider: string;
+    model: string;
+    inputUsdPerMillion?: number;
+    inputCacheHitUsdPerMillion?: number;
+    inputCacheMissUsdPerMillion?: number;
+    outputUsdPerMillion?: number;
+    longContextThresholdTokens?: number;
+    inputUsdPerMillionLong?: number;
+    outputUsdPerMillionLong?: number;
+    source?: string;
+    note?: string;
+}
+export declare const defaultProviderPricing: ModelPrice[];
+export declare const editablePricing: ModelPrice[];
+export declare function defaultPricesForProviderConfig(config: ProviderConfig): ModelPrice[];

package/dist/pricing.js

@@ -0,0 +1,38 @@
+export const defaultProviderPricing = [
+    {
+        provider: "deepseek",
+        model: "deepseek-v4-flash",
+        inputUsdPerMillion: 0.14,
+        inputCacheHitUsdPerMillion: 0.0028,
+        inputCacheMissUsdPerMillion: 0.14,
+        outputUsdPerMillion: 0.28,
+        source: "https://api-docs.deepseek.com/quick_start/pricing/",
+        note: "Official DeepSeek pricing page, checked 2026-05-18. Input uses cache-hit/cache-miss fields when provider usage reports them."
+    },
+    {
+        provider: "deepseek",
+        model: "deepseek-v4-pro",
+        inputUsdPerMillion: 0.435,
+        inputCacheHitUsdPerMillion: 0.003625,
+        inputCacheMissUsdPerMillion: 0.435,
+        outputUsdPerMillion: 0.87,
+        source: "https://api-docs.deepseek.com/quick_start/pricing/",
+        note: "Official DeepSeek V4-Pro discounted pricing, checked 2026-05-18; DeepSeek says the 75% discount is extended until 2026-05-31 15:59 UTC."
+    }
+];
+export const editablePricing = defaultProviderPricing;
+export function defaultPricesForProviderConfig(config) {
+    const keys = new Set();
+    const add = (provider, model) => {
+        if (model)
+            keys.add(`${provider}/${model}`);
+    };
+    for (const role of ["generator", "mutator", "judge", "finalizer"]) {
+        add(config.provider, config.models[role]);
+        const route = config.roleProviders?.[role];
+        if (route)
+            add(route.provider, route.model);
+    }
+    return defaultProviderPricing.filter((price) => keys.has(`${price.provider}/${price.model}`));
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,sBAAsB,GAAiB;IAClD;QACE,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,mBAAmB;QAC1B,kBAAkB,EAAE,IAAI;QACxB,0BAA0B,EAAE,MAAM;QAClC,2BAA2B,EAAE,IAAI;QACjC,mBAAmB,EAAE,IAAI;QACzB,MAAM,EAAE,oDAAoD;QAC5D,IAAI,EAAE,8HAA8H;KACrI;IACD;QACE,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,iBAAiB;QACxB,kBAAkB,EAAE,KAAK;QACzB,0BAA0B,EAAE,QAAQ;QACpC,2BAA2B,EAAE,KAAK;QAClC,mBAAmB,EAAE,IAAI;QACzB,MAAM,EAAE,oDAAoD;QAC5D,IAAI,EAAE,yIAAyI;KAChJ;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAiB,sBAAsB,CAAC;AAEpE,MAAM,UAAU,8BAA8B,CAAC,MAAsB;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,QAAgB,EAAE,KAAyB,EAAE,EAAE;QAC1D,IAAI,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAmB,EAAE,CAAC;QACpF,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK;YAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,2 @@
+import type { ModelDriver, ProviderConfig } from "./types.js";
+export declare function createDriver(config: ProviderConfig): ModelDriver;

package/dist/registry.js

@@ -0,0 +1,71 @@
+import { FakeDriver } from "./fake.js";
+import { createDeepSeekDriver, OpenAiCompatibleDriver } from "./openaiCompatible.js";
+import { ProviderError } from "@deepthonk/core";
+export function createDriver(config) {
+    const baseDriver = createSingleDriver({ ...config, roleProviders: undefined });
+    if (config.roleProviders)
+        return new RoleRoutingDriver(baseDriver, config.roleProviders);
+    return baseDriver;
+}
+function createSingleDriver(config) {
+    if (config.provider === "fake")
+        return new FakeDriver();
+    if (config.provider === "deepseek")
+        return createDeepSeekDriver(config);
+    if (config.provider === "openai-compatible")
+        return new OpenAiCompatibleDriver(config);
+    if (config.baseUrl)
+        return new OpenAiCompatibleDriver(config);
+    throw new ProviderError(`Unknown provider: ${config.provider}. Use provider "openai-compatible" or provide baseUrl/apiKeyEnv for OpenAI-compatible providers.`, {
+        code: "provider.unknown_provider",
+        retryable: false,
+        fix: "Set provider to fake, deepseek, openrouter, openai-compatible, or provide baseUrl/apiKeyEnv for a custom OpenAI-compatible provider."
+    });
+}
+class RoleRoutingDriver {
+    baseDriver;
+    routes;
+    constructor(baseDriver, roleProviders) {
+        this.baseDriver = baseDriver;
+        this.routes = Object.fromEntries(Object.entries(roleProviders).map(([role, roleConfig]) => [role, { driver: createSingleDriver(roleProviderToConfig(roleConfig)), model: roleConfig.model }]));
+    }
+    generate(input) {
+        return this.route("generator").driver.generate(this.withRouteModel(input, "generator"));
+    }
+    compare(input) {
+        return this.route("judge").driver.compare(this.withRouteModel(input, "judge"));
+    }
+    mutate(input) {
+        return this.route("mutator").driver.mutate(this.withRouteModel(input, "mutator"));
+    }
+    finalize(input) {
+        const route = this.route("finalizer");
+        if (!route.driver.finalize)
+            return this.baseDriver.finalize?.(input) ?? Promise.resolve({ text: input.candidate.content });
+        return route.driver.finalize(this.withRouteModel(input, "finalizer"));
+    }
+    route(role) {
+        return this.routes[role] ?? { driver: this.baseDriver };
+    }
+    withRouteModel(input, role) {
+        const model = this.routes[role]?.model;
+        return model ? { ...input, model } : input;
+    }
+}
+function roleProviderToConfig(config) {
+    return {
+        provider: config.provider,
+        baseUrl: config.baseUrl,
+        apiKeyEnv: config.apiKeyEnv,
+        apiKey: config.apiKey,
+        models: {
+            generator: config.model,
+            mutator: config.model,
+            judge: config.model,
+            finalizer: config.model
+        },
+        retry: config.retry,
+        supportsJsonMode: config.supportsJsonMode
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export type { CompareInput, FinalizeInput, GenerateInput, ModelDriver, ModelTextResult, MutateInput } from "@deepthonk/core";
+export type ProviderRole = "generator" | "mutator" | "judge" | "finalizer";
+export interface RoleProviderConfig {
+    provider: string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    apiKey?: string;
+    model: string;
+    retry?: {
+        httpRetries?: number;
+        requestTimeoutMs?: number;
+    };
+    supportsJsonMode?: boolean;
+}
+export interface ProviderConfig {
+    provider: "fake" | "openai-compatible" | "deepseek" | string;
+    baseUrl?: string;
+    apiKeyEnv?: string;
+    apiKey?: string;
+    models: {
+        generator: string;
+        mutator: string;
+        judge: string;
+        finalizer?: string;
+    };
+    retry?: {
+        httpRetries?: number;
+        requestTimeoutMs?: number;
+    };
+    supportsJsonMode?: boolean;
+    roleProviders?: Partial<Record<ProviderRole, RoleProviderConfig>>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@deepthonk/providers",
+  "version": "0.1.0",
+  "description": "Provider drivers and routing for DeepThonk.",
+  "license": "MIT",
+  "author": "Xule Lin",
+  "homepage": "https://github.com/linxule/deepthonk#readme",
+  "bugs": {
+    "url": "https://github.com/linxule/deepthonk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/linxule/deepthonk.git",
+    "directory": "packages/providers"
+  },
+  "dependencies": {
+    "zod": "^3.25.28",
+    "@deepthonk/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}