deepthonk 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/commands/export.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerExport(program: Command): void;

package/dist/commands/export.js

@@ -0,0 +1,24 @@
+import { exportRun } from "@deepthonk/core";
+import { resolveCliPath } from "../config.js";
+export function registerExport(program) {
+    program
+        .command("export")
+        .description("Export a DeepThonk run.")
+        .argument("<runDir>")
+        .option("--format <format>", "json|markdown|jsonl", "json")
+        .action(async (runDir, options) => {
+        if (!["json", "markdown", "jsonl"].includes(options.format))
+            throw new Error(`Unsupported export format: ${options.format}. Use json, markdown, or jsonl.`);
+        runDir = resolveCliPath(runDir);
+        const exported = await exportRun(runDir, options.format);
+        if (options.format === "jsonl") {
+            process.stdout.write(String(exported.jsonl ?? ""));
+            return;
+        }
+        if (options.format === "markdown")
+            console.log(exported.markdown);
+        else
+            console.log(JSON.stringify(exported, null, 2));
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,yBAAyB,CAAC;SACtC,QAAQ,CAAC,UAAU,CAAC;SACpB,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAAO,EAAE,EAAE;QACxC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,CAAC,MAAM,iCAAiC,CAAC,CAAC;QAC5J,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;;YAC7D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerInspect(program: Command): void;

package/dist/commands/inspect.js

@@ -0,0 +1,38 @@
+import { readRunArtifact, runArtifactFiles } from "@deepthonk/core";
+import { TraceStore } from "@deepthonk/core";
+import { resolveCliPath } from "../config.js";
+export function registerInspect(program) {
+    program
+        .command("inspect")
+        .description("Inspect a DeepThonk run directory.")
+        .argument("<runDir>")
+        .option("--generation <generation>")
+        .action(async (runDir, options) => {
+        runDir = resolveCliPath(runDir);
+        const trace = new TraceStore(runDir);
+        const summary = await trace.readSummary();
+        const scores = await trace.readJsonl(runArtifactFiles.scores);
+        const candidates = await trace.readJsonl(runArtifactFiles.candidates);
+        const comparisons = await trace.readJsonl(runArtifactFiles.comparisons);
+        const generation = options.generation ?? "final";
+        const topScores = scores
+            .filter((score) => String(score.generation) === String(generation))
+            .sort((left, right) => left.rank - right.rank)
+            .slice(0, 5);
+        const byId = new Map(candidates.map((candidate) => [candidate.id, candidate]));
+        const finalText = await readRunArtifact(runDir, "final").catch(() => "");
+        console.log(JSON.stringify({
+            summary,
+            call_counts: {
+                candidates: candidates.length,
+                comparisons: comparisons.length
+            },
+            top_candidates: topScores.map((score) => ({
+                ...score,
+                preview: byId.get(score.candidateId)?.content.slice(0, 160)
+            })),
+            final_preview: finalText.slice(0, 500)
+        }, null, 2));
+    });
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAiD,MAAM,iBAAiB,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,oCAAoC,CAAC;SACjD,QAAQ,CAAC,UAAU,CAAC;SACpB,MAAM,CAAC,2BAA2B,CAAC;SACnC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAAO,EAAE,EAAE;QACxC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAU,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,SAAS,CAAY,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACjF,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,SAAS,CAAa,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACpF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC;QACjD,MAAM,SAAS,GAAG,MAAM;aACrB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC;aAClE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;aAC7C,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACf,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,OAAO;YACP,WAAW,EAAE;gBACX,UAAU,EAAE,UAAU,CAAC,MAAM;gBAC7B,WAAW,EAAE,WAAW,CAAC,MAAM;aAChC;YACD,cAAc,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxC,GAAG,KAAK;gBACR,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aAC5D,CAAC,CAAC;YACH,aAAa,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACvC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/mutate.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerMutate(program: Command): void;

package/dist/commands/mutate.js

@@ -0,0 +1,41 @@
+import { mutateCandidate } from "@deepthonk/core";
+import { createDriver } from "@deepthonk/providers";
+import { readPathOrInline, resolveProviderOnlyConfig } from "../config.js";
+export function registerMutate(program) {
+    program
+        .command("mutate")
+        .description("Mutate one candidate with supplied critique.")
+        .requiredOption("--task <path-or-inline>")
+        .requiredOption("--candidate <path-or-inline>")
+        .requiredOption("--critique <path-or-inline>")
+        .option("--rubric <path-or-inline>")
+        .option("--config <yaml>")
+        .option("--provider <provider>", "fake|deepseek|openrouter|openai-compatible or any OpenAI-compatible alias")
+        .option("--base-url <url>")
+        .option("--api-key-env <name>")
+        .option("--mutator-model <model>")
+        .option("--json", "Print a structured JSON result.")
+        .action(async (options) => {
+        const [task, candidateText, critique, rubric] = await Promise.all([
+            readPathOrInline(options.task),
+            readPathOrInline(options.candidate),
+            readPathOrInline(options.critique),
+            options.rubric ? readPathOrInline(options.rubric) : undefined
+        ]);
+        const resolved = await resolveProviderOnlyConfig(options);
+        const result = await mutateCandidate({
+            task,
+            rubric,
+            candidate: { id: "user-candidate", content: candidateText },
+            driver: createDriver(resolved.providerConfig),
+            mutatorModel: resolved.models.mutator,
+            temperature: 1,
+            critique
+        });
+        if (options.json)
+            console.log(JSON.stringify(result, null, 2));
+        else
+            console.log(result.mutated);
+    });
+}
+//# sourceMappingURL=mutate.js.map

package/dist/commands/mutate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.js","sourceRoot":"","sources":["../../src/commands/mutate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,cAAc,CAAC,yBAAyB,CAAC;SACzC,cAAc,CAAC,8BAA8B,CAAC;SAC9C,cAAc,CAAC,6BAA6B,CAAC;SAC7C,MAAM,CAAC,2BAA2B,CAAC;SACnC,MAAM,CAAC,iBAAiB,CAAC;SACzB,MAAM,CAAC,uBAAuB,EAAE,2EAA2E,CAAC;SAC5G,MAAM,CAAC,kBAAkB,CAAC;SAC1B,MAAM,CAAC,sBAAsB,CAAC;SAC9B,MAAM,CAAC,yBAAyB,CAAC;SACjC,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACnD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChE,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;YAC9B,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC;YACnC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,IAAI;YACJ,MAAM;YACN,SAAS,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE;YAC3D,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC7C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;YACrC,WAAW,EAAE,CAAC;YACd,QAAQ;SACT,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;;YAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerPlan(program: Command): void;

package/dist/commands/plan.js

@@ -0,0 +1,25 @@
+import { readFile } from "node:fs/promises";
+import { planBudget } from "@deepthonk/core";
+import YAML from "yaml";
+import { profileFromOptions, resolveCliPath } from "../config.js";
+export function registerPlan(program) {
+    program
+        .command("plan")
+        .description("Print DeepThonk call budget for a profile.")
+        .option("--config <yaml>")
+        .option("--profile <profile>", "quick|balanced|paper", "quick")
+        .option("--n <number>")
+        .option("--k <number>")
+        .option("--t <number>")
+        .option("--m <number>")
+        .action(async (options) => {
+        if (options.config) {
+            const parsed = YAML.parse(await readFile(resolveCliPath(options.config), "utf8"));
+            console.log(JSON.stringify(planBudget(parsed.profile === "balanced" || parsed.profile === "paper" ? parsed.profile : "quick"), null, 2));
+            return;
+        }
+        const hasOverrides = Boolean(options.n || options.k || options.t || options.m);
+        console.log(JSON.stringify(planBudget(hasOverrides ? profileFromOptions(options) : options.profile), null, 2));
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,iBAAiB,CAAC;SACzB,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,OAAO,CAAC;SAC9D,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC;YAC1G,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,KAAK,UAAU,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACzI,OAAO;QACT,CAAC;QACD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/rank.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerRank(program: Command): void;

package/dist/commands/rank.js

@@ -0,0 +1,38 @@
+import { readFile } from "node:fs/promises";
+import { rankCandidates } from "@deepthonk/core";
+import { createDriver } from "@deepthonk/providers";
+import { readPathOrInline, resolveCliPath, resolveProviderOnlyConfig } from "../config.js";
+export function registerRank(program) {
+    program
+        .command("rank")
+        .description("Rank user-provided JSONL candidates with pairwise judging.")
+        .requiredOption("--task <path-or-inline>")
+        .requiredOption("--candidates <jsonl>")
+        .option("--rubric <path-or-inline>")
+        .option("--config <yaml>")
+        .option("--provider <provider>", "fake|deepseek|openrouter|openai-compatible or any OpenAI-compatible alias")
+        .option("--base-url <url>")
+        .option("--api-key-env <name>")
+        .option("--judge-model <model>")
+        .action(async (options) => {
+        const task = await readPathOrInline(options.task);
+        const rubric = options.rubric ? await readPathOrInline(options.rubric) : undefined;
+        const candidates = (await readFile(resolveCliPath(options.candidates), "utf8"))
+            .split("\n")
+            .filter(Boolean)
+            .map((line, index) => {
+            const parsed = JSON.parse(line);
+            return { id: parsed.id ?? `candidate-${index + 1}`, content: parsed.content };
+        });
+        const resolved = await resolveProviderOnlyConfig(options);
+        const result = await rankCandidates({
+            task,
+            rubric,
+            candidates,
+            driver: createDriver(resolved.providerConfig),
+            judgeModel: resolved.models.judge
+        });
+        console.log(JSON.stringify(result.scores, null, 2));
+    });
+}
+//# sourceMappingURL=rank.js.map

package/dist/commands/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../src/commands/rank.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAuB,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAE3F,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4DAA4D,CAAC;SACzE,cAAc,CAAC,yBAAyB,CAAC;SACzC,cAAc,CAAC,sBAAsB,CAAC;SACtC,MAAM,CAAC,2BAA2B,CAAC;SACnC,MAAM,CAAC,iBAAiB,CAAC;SACzB,MAAM,CAAC,uBAAuB,EAAE,2EAA2E,CAAC;SAC5G,MAAM,CAAC,kBAAkB,CAAC;SAC1B,MAAM,CAAC,sBAAsB,CAAC;SAC9B,MAAM,CAAC,uBAAuB,CAAC;SAC/B,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,MAAM,UAAU,GAAqB,CAAC,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;aAC9F,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqC,CAAC;YACpE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,aAAa,KAAK,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAChF,CAAC,CAAC,CAAC;QACL,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;YAClC,IAAI;YACJ,MAAM;YACN,UAAU;YACV,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC7C,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;SAClC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/resume.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerResume(program: Command): void;

package/dist/commands/resume.js

@@ -0,0 +1,16 @@
+import { detectResumeState } from "@deepthonk/core";
+import { resolveCliPath } from "../config.js";
+export function registerResume(program) {
+    program
+        .command("resume")
+        .description("Detect resumability for a run directory.")
+        .argument("<runDir>")
+        .action(async (runDir) => {
+        runDir = resolveCliPath(runDir);
+        const status = await detectResumeState(runDir);
+        console.log(JSON.stringify(status, null, 2));
+        if (status.status !== "completed" && status.safe_to_continue !== true)
+            process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=resume.js.map

package/dist/commands/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0CAA0C,CAAC;SACvD,QAAQ,CAAC,UAAU,CAAC;SACpB,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC/B,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,gBAAgB,KAAK,IAAI;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerRun(program: Command): void;

package/dist/commands/run.js

@@ -0,0 +1,74 @@
+import { runDeepThonk } from "@deepthonk/core";
+import { createDriver } from "@deepthonk/providers";
+import { resolveRunConfig } from "../config.js";
+export function registerRun(program) {
+    program
+        .command("run")
+        .description("Run DeepThonk search.")
+        .requiredOption("--task <path-or-inline>")
+        .option("--rubric <path-or-inline>")
+        .option("--config <yaml>")
+        .option("--profile <profile>", "quick|balanced|paper")
+        .option("--provider <provider>", "fake|deepseek|openrouter|openai-compatible or any OpenAI-compatible alias")
+        .option("--base-url <url>")
+        .option("--api-key-env <name>")
+        .option("--generator-model <model>")
+        .option("--mutator-model <model>")
+        .option("--judge-model <model>")
+        .option("--finalizer-model <model>")
+        .option("--seed <number>")
+        .option("--out <dir>")
+        .option("--max-concurrency <number>")
+        .option("--max-calls <number>")
+        .option("--max-input-tokens <number>")
+        .option("--max-output-tokens <number>")
+        .option("--max-usd <number>")
+        .option("--request-timeout-ms <number>")
+        .option("--n <number>", "Population size override (default: profile)")
+        .option("--k <number>", "Comparisons per candidate per generation override")
+        .option("--t <number>", "Number of mutation generations override")
+        .option("--m <number>", "Comparisons per candidate in the final dense ranking round")
+        .option("--lambda <number>", "Bradley-Terry L2 regularization override")
+        .option("--sample-temperature <number>", "Temperature for initial candidate generation")
+        .option("--mutate-temperature <number>", "Temperature for critique-guided mutation")
+        .option("--judge-temperature <number>", "Temperature for pairwise judging")
+        .option("--prompt-style <style>", "general|paper-programming")
+        .option("--prompts <yaml>", "YAML file with per-phase prompt overrides")
+        .option("--dry-run")
+        .action(async (options) => {
+        const resolved = await resolveRunConfig(options);
+        if (options.dryRun) {
+            console.log(JSON.stringify(redacted(withApiKeyPresence(resolved)), null, 2));
+            return;
+        }
+        const result = await runDeepThonk(resolved.runConfig, createDriver(resolved.providerConfig));
+        console.log(JSON.stringify({
+            run_id: result.runId,
+            run_dir: result.runDir,
+            winner_id: result.winner.id,
+            calls: result.calls,
+            final_answer: result.finalAnswer
+        }, null, 2));
+    });
+}
+// Match keys that hold a secret value. Exclude metadata pointers like apiKeyEnv/apiKeyFile/apiKeyStdin
+// which only name where the secret lives.
+const SECRET_KEY_RE = /^(api[_-]?key|token|secret|password|authorization|bearer|cookie|credential)$/i;
+function redacted(value) {
+    return JSON.parse(JSON.stringify(value, (key, inner) => {
+        if (SECRET_KEY_RE.test(key) && inner)
+            return "[redacted]";
+        return inner;
+    }));
+}
+function withApiKeyPresence(value) {
+    const apiKeyEnv = value.providerConfig.apiKeyEnv;
+    return {
+        ...value,
+        providerConfig: {
+            ...value.providerConfig,
+            apiKeyPresent: Boolean(value.providerConfig.apiKey || (apiKeyEnv && process.env[apiKeyEnv]))
+        }
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/serveMcp.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerServeMcp(program: Command): void;

package/dist/commands/serveMcp.js

@@ -0,0 +1,16 @@
+import { serveMcp } from "@deepthonk/mcp";
+export function registerServeMcp(program) {
+    program
+        .command("serve-mcp")
+        .description("Start the DeepThonk MCP server.")
+        .option("--transport <transport>", "stdio|http", "stdio")
+        .option("--port <number>", "Port for HTTP transport.", "3333")
+        .action(async (options) => {
+        const port = Number(options.port);
+        if (!Number.isFinite(port) || port <= 0) {
+            throw new Error(`Invalid --port value: ${options.port}`);
+        }
+        await serveMcp({ transport: options.transport, port });
+    });
+}
+//# sourceMappingURL=serveMcp.js.map

package/dist/commands/serveMcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveMcp.js","sourceRoot":"","sources":["../../src/commands/serveMcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,yBAAyB,EAAE,YAAY,EAAE,OAAO,CAAC;SACxD,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,CAAC;SAC7D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,QAAQ,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerSetup(program: Command): void;

package/dist/commands/setup.js

@@ -0,0 +1,104 @@
+import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import YAML from "yaml";
+import { defaultApiKeyEnv, resolveProviderConfig, resolveProviderModels } from "@deepthonk/providers";
+import { defaultConfigPath, defaultEnvPath, resolveCliPath } from "../config.js";
+export function registerSetup(program) {
+    program
+        .command("setup")
+        .description("Create a reusable DeepThonk provider config.")
+        .option("--config <yaml>", "Config path to write", defaultConfigPath)
+        .option("--key-file <path>", "DeepThonk env file path for --api-key", defaultEnvPath)
+        .option("--provider <provider>", "deepseek|openrouter|openai-compatible|fake or any OpenAI-compatible alias")
+        .option("--base-url <url>")
+        .option("--api-key-env <name>")
+        .option("--api-key <key>", "Store API key in the DeepThonk env file instead of the YAML config.")
+        .option("--api-key-file <path>", "Read the API key from a local file and store it in the DeepThonk env file.")
+        .option("--api-key-stdin", "Read the API key from stdin and store it in the DeepThonk env file.")
+        .option("--profile <profile>", "quick|balanced|paper", "balanced")
+        .option("--fast-model <model>", "Use one model for generator and mutator.")
+        .option("--generator-model <model>")
+        .option("--mutator-model <model>")
+        .option("--judge-model <model>")
+        .option("--finalizer-model <model>")
+        .option("--print", "Print config instead of writing files.")
+        .action(async (options) => {
+        const provider = options.provider ?? inferProvider();
+        const apiKeyEnv = options.apiKeyEnv ?? defaultApiKeyEnv(provider) ?? "DEEPTHONK_API_KEY";
+        const models = resolveProviderModels(provider, {
+            generator: options.generatorModel ?? options.fastModel,
+            mutator: options.mutatorModel ?? options.fastModel,
+            judge: options.judgeModel,
+            finalizer: options.finalizerModel
+        });
+        const providerConfig = resolveProviderConfig({ provider, baseUrl: options.baseUrl, apiKeyEnv, models });
+        const config = {
+            profile: options.profile,
+            provider,
+            base_url: providerConfig.baseUrl,
+            api_key_env: apiKeyEnv,
+            models
+        };
+        if (!config.base_url)
+            delete config.base_url;
+        if (!models.finalizer)
+            delete config.models.finalizer;
+        const yaml = YAML.stringify(config);
+        if (options.print) {
+            process.stdout.write(yaml);
+            return;
+        }
+        const configPath = resolveCliPath(options.config);
+        await mkdir(dirname(configPath), { recursive: true });
+        await writeFile(configPath, yaml, "utf8");
+        let envMessage = process.env[apiKeyEnv] ? `Detected ${apiKeyEnv} in the current environment.` : `Set ${apiKeyEnv} before paid runs.`;
+        if (options.apiKey && !options.apiKeyStdin && !options.apiKeyFile) {
+            process.stderr.write("warning: --api-key exposes the secret via process arguments and shell history. Prefer --api-key-stdin or --api-key-file.\n");
+        }
+        const apiKey = await resolveApiKey(options);
+        if (apiKey) {
+            const envPath = resolveCliPath(options.keyFile);
+            await mkdir(dirname(envPath), { recursive: true });
+            // writeFile mode is only honored at file *creation* on POSIX; the explicit chmod handles
+            // the case where the file pre-existed with looser permissions. Do not remove either.
+            await writeFile(envPath, `export ${apiKeyEnv}=${shellQuote(apiKey)}\n`, { encoding: "utf8", mode: 0o600 });
+            await chmod(envPath, 0o600);
+            envMessage = `Stored ${apiKeyEnv} in ${envPath}.`;
+        }
+        console.log(JSON.stringify({
+            config_path: configPath,
+            provider,
+            api_key_env: apiKeyEnv,
+            models,
+            env: envMessage,
+            usage: `deepthonk run --task task.md --config ${configPath}`
+        }, null, 2));
+    });
+}
+function inferProvider() {
+    if (process.env.DEEPSEEK_API_KEY)
+        return "deepseek";
+    if (process.env.OPENROUTER_API_KEY)
+        return "openrouter";
+    return "deepseek";
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+async function resolveApiKey(options) {
+    const sources = [options.apiKey, options.apiKeyFile, options.apiKeyStdin ? "stdin" : undefined].filter(Boolean);
+    if (sources.length > 1)
+        throw new Error("Use only one of --api-key, --api-key-file, or --api-key-stdin.");
+    if (options.apiKeyFile)
+        return (await readFile(resolveCliPath(options.apiKeyFile), "utf8")).trim();
+    if (options.apiKeyStdin)
+        return readStdin();
+    return options.apiKey;
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    return Buffer.concat(chunks).toString("utf8").trim();
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+import { planBudget, type Profile, type RunConfig } from "@deepthonk/core";
+import { type ProviderConfig } from "@deepthonk/providers";
+export interface ResolvedCliConfig {
+    runConfig: RunConfig;
+    providerConfig: ProviderConfig;
+    plan: ReturnType<typeof planBudget>;
+}
+export interface ResolvedProviderConfig {
+    providerConfig: ProviderConfig;
+    models: ProviderConfig["models"];
+}
+export declare const defaultConfigPath: string;
+export declare const defaultEnvPath: string;
+export declare function resolveRunConfig(options: Record<string, unknown>): Promise<ResolvedCliConfig>;
+export declare function resolveProviderOnlyConfig(options: Record<string, unknown>): Promise<ResolvedProviderConfig>;
+export declare function profileFromOptions(options: Record<string, unknown>): Profile;
+export declare function readPathOrInline(value: string): Promise<string>;
+export declare function resolveCliPath(value: string): string;
+export declare function loadDeepThonkEnv(path?: string): Promise<void>;

package/dist/config.js

@@ -0,0 +1,265 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import YAML from "yaml";
+import { ConfigError, getProfile, planBudget } from "@deepthonk/core";
+import { defaultPricesForProviderConfig, resolveProviderConfig, resolveProviderModels } from "@deepthonk/providers";
+export const defaultConfigPath = join(homedir(), ".config", "deepthonk", "config.yaml");
+export const defaultEnvPath = join(dirname(defaultConfigPath), "env");
+export async function resolveRunConfig(options) {
+    await loadDeepThonkEnv();
+    const configPath = resolveConfigPath(options);
+    const fileConfig = configPath ? await readConfig(configPath) : {};
+    const profileName = builtInProfileName(options.profile ?? fileConfig.profile ?? "quick");
+    const profile = mergeAlgorithmOverrides(getProfile(profileName), fileConfig.algorithm, options);
+    const task = await readPathOrInline(String(options.task ?? ""));
+    const rubric = options.rubric ? await readPathOrInline(String(options.rubric)) : undefined;
+    const provider = String(options.provider ?? fileConfig.provider ?? "fake");
+    const models = resolveProviderModels(provider, {
+        generator: stringOption(options.generatorModel) ?? fileConfig.models?.generator,
+        mutator: stringOption(options.mutatorModel) ?? fileConfig.models?.mutator,
+        judge: stringOption(options.judgeModel) ?? fileConfig.models?.judge,
+        finalizer: stringOption(options.finalizerModel) ?? fileConfig.models?.finalizer
+    });
+    const maxConcurrency = numberOption(options.maxConcurrency);
+    const retry = {
+        httpRetries: fileConfig.retry?.httpRetries ?? 2,
+        invalidJsonRetries: fileConfig.retry?.invalidJsonRetries ?? 1,
+        requestTimeoutMs: numberOption(options.requestTimeoutMs) ?? fileConfig.retry?.requestTimeoutMs
+    };
+    const providerConfig = resolveProviderConfig({
+        provider,
+        baseUrl: stringOption(options.baseUrl) ?? fileConfig.base_url,
+        apiKeyEnv: stringOption(options.apiKeyEnv) ?? fileConfig.api_key_env,
+        models,
+        roleProviders: normalizeRoleProviders(fileConfig.providers, models),
+        retry
+    });
+    const budget = mergeBudget(fileConfig.budget, {
+        maxCalls: numberOption(options.maxCalls),
+        maxInputTokens: numberOption(options.maxInputTokens),
+        maxOutputTokens: numberOption(options.maxOutputTokens),
+        maxUsd: numberOption(options.maxUsd)
+    }, defaultPricesForProviderConfig(providerConfig));
+    const promptOverrides = await loadPromptOverrides(options, fileConfig);
+    const runConfig = {
+        task,
+        rubric,
+        promptStyle: stringOption(options.promptStyle) ??
+            fileConfig.prompt_style ??
+            (profileName === "paper" ? "paper-programming" : "general"),
+        promptOverrides,
+        profile,
+        runDir: resolveCliPath(String(options.out ?? `runs/${new Date().toISOString().replace(/[:.]/g, "-")}`)),
+        seed: numberOption(options.seed) ?? 1,
+        provider,
+        generatorModel: models.generator,
+        mutatorModel: models.mutator,
+        judgeModel: models.judge,
+        finalizerModel: models.finalizer,
+        concurrency: {
+            generate: maxConcurrency ?? fileConfig.concurrency?.generate ?? profile.n,
+            judge: maxConcurrency ?? fileConfig.concurrency?.judge ?? Math.max(1, (profile.n * Math.max(profile.k, profile.m)) / 2),
+            mutate: maxConcurrency ?? fileConfig.concurrency?.mutate ?? profile.n - Math.floor(profile.n / 4)
+        },
+        retry,
+        budget,
+        output: {
+            includeRawModelOutputs: fileConfig.output?.includeRawModelOutputs ?? false,
+            includePrompts: fileConfig.output?.includePrompts ?? false
+        }
+    };
+    return {
+        runConfig,
+        providerConfig,
+        plan: planBudget(profile)
+    };
+}
+export async function resolveProviderOnlyConfig(options) {
+    await loadDeepThonkEnv();
+    const configPath = resolveConfigPath(options);
+    const fileConfig = configPath ? await readConfig(configPath) : {};
+    const provider = String(options.provider ?? fileConfig.provider ?? "fake");
+    const models = resolveProviderModels(provider, {
+        generator: stringOption(options.generatorModel) ?? fileConfig.models?.generator,
+        mutator: stringOption(options.mutatorModel) ?? fileConfig.models?.mutator,
+        judge: stringOption(options.judgeModel) ?? fileConfig.models?.judge,
+        finalizer: stringOption(options.finalizerModel) ?? fileConfig.models?.finalizer
+    });
+    return {
+        models,
+        providerConfig: resolveProviderConfig({
+            provider,
+            baseUrl: stringOption(options.baseUrl) ?? fileConfig.base_url,
+            apiKeyEnv: stringOption(options.apiKeyEnv) ?? fileConfig.api_key_env,
+            models,
+            roleProviders: normalizeRoleProviders(fileConfig.providers, models),
+            retry: {
+                httpRetries: fileConfig.retry?.httpRetries ?? 2,
+                requestTimeoutMs: numberOption(options.requestTimeoutMs) ?? fileConfig.retry?.requestTimeoutMs
+            }
+        })
+    };
+}
+export function profileFromOptions(options) {
+    const base = getProfile(builtInProfileName(options.profile ?? "quick"));
+    return mergeAlgorithmOverrides(base, undefined, options);
+}
+async function loadPromptOverrides(options, fileConfig) {
+    let fromFlag;
+    const path = stringOption(options.prompts);
+    if (path) {
+        const resolved = resolveCliPath(path);
+        if (!existsSync(resolved)) {
+            throw new ConfigError(`--prompts file does not exist: ${path}`, {
+                code: "config.prompts_file_missing",
+                retryable: false,
+                fix: "Pass a YAML file path. The file should map phase names to { system, user } templates."
+            });
+        }
+        fromFlag = YAML.parse(await readFile(resolved, "utf8"));
+    }
+    const merged = { ...(fileConfig.prompts ?? {}) };
+    if (fromFlag) {
+        for (const phase of ["generate", "compare", "mutate", "finalize"]) {
+            if (fromFlag[phase])
+                merged[phase] = { ...(merged[phase] ?? {}), ...fromFlag[phase] };
+        }
+    }
+    return Object.keys(merged).length ? merged : undefined;
+}
+function mergeAlgorithmOverrides(base, fileOverrides, cliOptions) {
+    return {
+        n: numberOption(cliOptions.n) ?? fileOverrides?.n ?? base.n,
+        k: numberOption(cliOptions.k) ?? fileOverrides?.k ?? base.k,
+        t: numberOption(cliOptions.t) ?? fileOverrides?.t ?? base.t,
+        m: numberOption(cliOptions.m) ?? fileOverrides?.m ?? base.m,
+        lambda: numberOption(cliOptions.lambda) ?? fileOverrides?.lambda ?? base.lambda,
+        sampleTemperature: numberOption(cliOptions.sampleTemperature) ?? fileOverrides?.sample_temperature ?? base.sampleTemperature,
+        mutateTemperature: numberOption(cliOptions.mutateTemperature) ?? fileOverrides?.mutate_temperature ?? base.mutateTemperature,
+        judgeTemperature: numberOption(cliOptions.judgeTemperature) ?? fileOverrides?.judge_temperature ?? base.judgeTemperature
+    };
+}
+export async function readPathOrInline(value) {
+    if (!value)
+        return "";
+    const candidates = candidatePaths(value);
+    const path = candidates.find((candidate) => existsSync(candidate));
+    if (path)
+        return readFile(path, "utf8");
+    if (looksPathLike(value))
+        throw new ConfigError(`Input path does not exist: ${value}. Use inline text without path separators, or fix the path.`);
+    return value;
+}
+export function resolveCliPath(value) {
+    return candidatePaths(value)[0];
+}
+function candidatePaths(value) {
+    if (value.startsWith("/"))
+        return [value];
+    return [
+        process.env.INIT_CWD ? resolve(process.env.INIT_CWD, value) : undefined,
+        resolve(value),
+        resolve(process.cwd(), "../..", value)
+    ].filter((path) => Boolean(path));
+}
+async function readConfig(path) {
+    return YAML.parse(await readFile(resolveCliPath(path), "utf8"));
+}
+function resolveConfigPath(options) {
+    return stringOption(options.config) ?? process.env.DEEPTHONK_CONFIG ?? (existsSync(defaultConfigPath) ? defaultConfigPath : undefined);
+}
+export async function loadDeepThonkEnv(path = process.env.DEEPTHONK_ENV ?? defaultEnvPath) {
+    if (!existsSync(path))
+        return;
+    const text = await readFile(path, "utf8");
+    for (const line of text.split("\n")) {
+        const parsed = parseEnvLine(line);
+        if (!parsed)
+            continue;
+        const [key, value] = parsed;
+        if (process.env[key] === undefined || process.env[key] === "")
+            process.env[key] = value;
+    }
+}
+function parseEnvLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+        return undefined;
+    const match = trimmed.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
+    if (!match)
+        return undefined;
+    return [match[1], unquoteEnvValue(match[2].trim())];
+}
+function unquoteEnvValue(value) {
+    if ((value.startsWith("'") && value.endsWith("'")) || (value.startsWith('"') && value.endsWith('"'))) {
+        const inner = value.slice(1, -1);
+        return value.startsWith("'") ? inner.replace(/'\\''/g, "'") : inner.replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+    }
+    return value;
+}
+function numberOption(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    return Number(value);
+}
+function mergeBudget(fileBudget, overrides, defaultPrices = []) {
+    const prices = mergePrices(defaultPrices, fileBudget?.prices);
+    const definedOverrides = Object.fromEntries(Object.entries(overrides).filter(([, value]) => value !== undefined));
+    if (!fileBudget && !Object.keys(definedOverrides).length && prices.length === 0)
+        return undefined;
+    const merged = {
+        ...(fileBudget ?? {}),
+        ...definedOverrides,
+        prices
+    };
+    return merged && Object.keys(merged).length ? merged : undefined;
+}
+function mergePrices(defaults, overrides) {
+    const byKey = new Map(defaults.map((price) => [`${price.provider}/${price.model}`, price]));
+    for (const price of overrides ?? [])
+        byKey.set(`${price.provider}/${price.model}`, price);
+    return [...byKey.values()];
+}
+function stringOption(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    return String(value);
+}
+function builtInProfileName(value) {
+    const profile = String(value);
+    if (profile === "quick" || profile === "balanced" || profile === "paper")
+        return profile;
+    throw new ConfigError(`Unknown profile: ${profile}. Use quick, balanced, or paper.`);
+}
+function looksPathLike(value) {
+    if (value.startsWith("/") || value.startsWith("./") || value.startsWith("../") || value.startsWith("~/"))
+        return true;
+    if (value.includes("/") || value.includes("\\"))
+        return true;
+    const extension = extname(basename(value)).toLowerCase();
+    return [".txt", ".md", ".json", ".jsonl", ".yaml", ".yml"].includes(extension);
+}
+function normalizeRoleProviders(providers, models) {
+    if (!providers)
+        return undefined;
+    const normalized = {};
+    for (const role of ["generator", "mutator", "judge", "finalizer"]) {
+        const provider = providers[role];
+        if (!provider)
+            continue;
+        const model = provider.model ?? models[role];
+        if (!model)
+            continue;
+        normalized[role] = {
+            provider: provider.provider,
+            baseUrl: provider.base_url,
+            apiKeyEnv: provider.api_key_env,
+            model,
+            supportsJsonMode: provider.supports_json_mode
+        };
+    }
+    return Object.keys(normalized).length ? normalized : undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAmB,WAAW,EAAE,UAAU,EAAE,UAAU,EAAyD,MAAM,iBAAiB,CAAC;AAC9I,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,qBAAqB,EAA0C,MAAM,sBAAsB,CAAC;AAa5J,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;AAiDtE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgC;IACrE,MAAM,gBAAgB,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE;QAC7C,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS;QAC/E,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,OAAO;QACzE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,KAAK;QACnE,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS;KAChF,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG;QACZ,WAAW,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;QAC/C,kBAAkB,EAAE,UAAU,CAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC;QAC7D,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,gBAAgB;KAC/F,CAAC;IACF,MAAM,cAAc,GAAmB,qBAAqB,CAAC;QAC3D,QAAQ;QACR,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ;QAC7D,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,WAAW;QACpE,MAAM;QACN,aAAa,EAAE,sBAAsB,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;QACnE,KAAK;KACN,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE;QAC5C,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC;QACxC,cAAc,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC;QACpD,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC;QACtD,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC;KACrC,EAAE,8BAA8B,CAAC,cAAc,CAAC,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACvE,MAAM,SAAS,GAAc;QAC3B,IAAI;QACJ,MAAM;QACN,WAAW,EACR,YAAY,CAAC,OAAO,CAAC,WAAW,CAA0C;YAC3E,UAAU,CAAC,YAAY;YACvB,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7D,eAAe;QACf,OAAO;QACP,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvG,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,QAAQ;QACR,cAAc,EAAE,MAAM,CAAC,SAAS;QAChC,YAAY,EAAE,MAAM,CAAC,OAAO;QAC5B,UAAU,EAAE,MAAM,CAAC,KAAK;QACxB,cAAc,EAAE,MAAM,CAAC,SAAS;QAChC,WAAW,EAAE;YACX,QAAQ,EAAE,cAAc,IAAI,UAAU,CAAC,WAAW,EAAE,QAAQ,IAAI,OAAO,CAAC,CAAC;YACzE,KAAK,EAAE,cAAc,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACvH,MAAM,EAAE,cAAc,IAAI,UAAU,CAAC,WAAW,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;SAClG;QACD,KAAK;QACL,MAAM;QACN,MAAM,EAAE;YACN,sBAAsB,EAAE,UAAU,CAAC,MAAM,EAAE,sBAAsB,IAAI,KAAK;YAC1E,cAAc,EAAE,UAAU,CAAC,MAAM,EAAE,cAAc,IAAI,KAAK;SAC3D;KACF,CAAC;IACF,OAAO;QACL,SAAS;QACT,cAAc;QACd,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,OAAgC;IAC9E,MAAM,gBAAgB,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE;QAC7C,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS;QAC/E,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,OAAO;QACzE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,KAAK;QACnE,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS;KAChF,CAAC,CAAC;IACH,OAAO;QACL,MAAM;QACN,cAAc,EAAE,qBAAqB,CAAC;YACpC,QAAQ;YACR,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ;YAC7D,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,WAAW;YACpE,MAAM;YACN,aAAa,EAAE,sBAAsB,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;YACnE,KAAK,EAAE;gBACL,WAAW,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;gBAC/C,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,gBAAgB;aAC/F;SACF,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,MAAM,IAAI,GAAG,UAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IACxE,OAAO,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,mBAAmB,CAChC,OAAgC,EAChC,UAAyB;IAEzB,IAAI,QAAyC,CAAC;IAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,WAAW,CAAC,kCAAkC,IAAI,EAAE,EAAE;gBAC9D,IAAI,EAAE,6BAA6B;gBACnC,SAAS,EAAE,KAAK;gBAChB,GAAG,EAAE,uFAAuF;aAC7F,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAwB,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAwB,EAAE,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IACtE,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAU,EAAE,CAAC;YAC3E,IAAI,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxF,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAuC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC;AAED,SAAS,uBAAuB,CAC9B,IAAa,EACb,aAA6C,EAC7C,UAAmC;IAEnC,OAAO;QACL,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3D,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3D,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3D,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3D,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM;QAC/E,iBAAiB,EACf,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,aAAa,EAAE,kBAAkB,IAAI,IAAI,CAAC,iBAAiB;QAC3G,iBAAiB,EACf,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,aAAa,EAAE,kBAAkB,IAAI,IAAI,CAAC,iBAAiB;QAC3G,gBAAgB,EACd,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,aAAa,EAAE,iBAAiB,IAAI,IAAI,CAAC,gBAAgB;KACzG,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACnE,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,8BAA8B,KAAK,6DAA6D,CAAC,CAAC;IAClJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACvE,OAAO,CAAC,KAAK,CAAC;QACd,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC;KACvC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAkB,CAAC;AACnF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgC;IACzD,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACzI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,cAAc;IACvF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC;QAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACrG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAClB,UAA+B,EAC/B,SAAoD,EACpD,gBAAyE,EAAE;IAE3E,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;IAClH,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClG,MAAM,MAAM,GAAG;QACb,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACrB,GAAG,gBAAgB;QACnB,MAAM;KACgB,CAAC;IACzB,OAAO,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,SAAS,WAAW,CAClB,QAAiE,EACjE,SAA8E;IAE9E,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5F,KAAK,MAAM,KAAK,IAAI,SAAS,IAAI,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACzF,MAAM,IAAI,WAAW,CAAC,oBAAoB,OAAO,kCAAkC,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtH,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAAqC,EACrC,MAAgC;IAEhC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,UAAU,GAAiE,EAAE,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAU,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,UAAU,CAAC,IAAI,CAAC,GAAG;YACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,SAAS,EAAE,QAAQ,CAAC,WAAW;YAC/B,KAAK;YACL,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB;SAC9C,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { DeepThonkError } from "@deepthonk/core";
+import { registerExport } from "./commands/export.js";
+import { registerInspect } from "./commands/inspect.js";
+import { registerMutate } from "./commands/mutate.js";
+import { registerPlan } from "./commands/plan.js";
+import { registerRank } from "./commands/rank.js";
+import { registerResume } from "./commands/resume.js";
+import { registerRun } from "./commands/run.js";
+import { registerServeMcp } from "./commands/serveMcp.js";
+import { registerSetup } from "./commands/setup.js";
+process.on("unhandledRejection", (reason) => {
+    process.stderr.write(`deepthonk unhandledRejection: ${reason instanceof Error ? reason.message : String(reason)}\n`);
+});
+const program = new Command();
+program.name("deepthonk").description("Thonk harder, not richer.").version("0.1.0").option("--json-errors", "Print machine-readable errors to stderr.");
+registerPlan(program);
+registerRun(program);
+registerInspect(program);
+registerResume(program);
+registerExport(program);
+registerRank(program);
+registerMutate(program);
+registerSetup(program);
+registerServeMcp(program);
+program.parseAsync(process.argv).catch((error) => {
+    const opts = program.opts();
+    if (opts.jsonErrors) {
+        console.error(JSON.stringify(serializeError(error), null, 2));
+    }
+    else {
+        console.error(error instanceof Error ? error.message : String(error));
+    }
+    process.exitCode = 1;
+});
+function serializeError(error) {
+    if (error instanceof DeepThonkError) {
+        return {
+            code: error.code,
+            message: error.message,
+            retryable: error.retryable,
+            fix: error.fix
+        };
+    }
+    return {
+        code: "unexpected_error",
+        message: error instanceof Error ? error.message : String(error),
+        retryable: false
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvH,CAAC,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAC9B,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC,CAAC;AAExJ,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAE1B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAA4B,CAAC;IACtD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "deepthonk",
+  "version": "0.1.0",
+  "description": "Provider-neutral OpenDeepThink CLI and MCP server. Population-based reasoning via pairwise judging and Bradley-Terry ranking.",
+  "license": "MIT",
+  "author": "Xule Lin",
+  "homepage": "https://github.com/linxule/deepthonk#readme",
+  "bugs": {
+    "url": "https://github.com/linxule/deepthonk/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "opendeepthink",
+    "reasoning",
+    "bradley-terry",
+    "test-time-compute",
+    "deepseek",
+    "cli",
+    "llm",
+    "agent"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "deepthonk": "dist/index.js",
+    "dt": "dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/linxule/deepthonk.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "yaml": "^2.7.1",
+    "zod": "^3.25.28",
+    "@deepthonk/core": "0.1.0",
+    "@deepthonk/providers": "0.1.0",
+    "@deepthonk/mcp": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "deepthonk": "tsx src/index.ts"
+  }
+}