@cjhyy/code-shell 0.1.0-alpha.3 → 0.1.6

package/CHANGELOG.md

@@ -8,6 +8,113 @@ breaking.
 
 ## [Unreleased]
 
+## [0.1.6] - 2026-05-13
+
+### Added
+- **Built-in skills bundled with the package.** The skill scanner now also
+  reads `skills-builtin/` shipped inside the installed npm package. First
+  built-in is `codeshell-help` — answers questions about code-shell itself
+  (slash commands, provider/model setup, settings keys, hooks, MCP,
+  debugging flags) so a fresh install can self-document without the user
+  having to write their own help skill.
+- **Headless mode in Engine.** New `headless: true` config flag (set by the
+  `run` command) puts InvestigationGuard into soft mode: the third re-read
+  of the same target turns into a stronger reminder instead of a hard
+  block, since unattended automations have no human to retry the task.
+
+### Fixed
+- `code-shell run` now resolves API keys / baseUrl / model from
+  `settings.providers[]` and `settings.models[]` in addition to the legacy
+  `settings.model.*` mirror — matches what Engine reconciles at startup,
+  fixes "no API key found" false negatives for users on the new shape.
+- Read-only filesystem (CI containers) no longer floods the log with
+  `tool_result.persist_failed` warnings — demoted to debug.
+- **Boot crash on machines with Claude Code installed.** Settings loader
+  previously merged `~/.claude/settings.json` into our own config for
+  "zero-migration from Claude Code", but CC's schema diverges (`model` is
+  a string there, an object here) and the merge crashed startup before
+  the onboarding wizard could even render. Dropped the cross-read in
+  `SettingsManager`, `hasApiKey()`, and the updater's autoUpdates probe.
+  File-level compat (CLAUDE.md scanning, `.claude/skills/` discovery) is
+  unaffected — only the settings.json cross-read is removed.
+
+## [0.1.5] - 2026-05-13
+
+### Added
+- **Auto-installing updater.** Background update check probes `npm config get
+  prefix` for write permission; if writable, registers a detached `npm i -g`
+  on process exit so the next launch picks up the new version. File lock at
+  `~/.code-shell/.update.lock` (5min stale-takeover) prevents concurrent
+  installs from corrupting each other. Disable with `DISABLE_AUTOUPDATER=1`,
+  `settings.autoUpdates: false`, or dev mode. New `UpdateBanner` UI
+  surfaces "will install on exit" or the manual `sudo` command.
+- **Provider/model two-layer redesign.** `providers[]` is now the source of
+  credentials/baseUrl; `models[]` references a provider by key. Legacy
+  flat `models[]` config auto-migrates on startup (with `.bak` snapshot).
+  New `ProviderModelFlow` unifies `/login` onboarding and the
+  ModelManager's add/refresh flows.
+- **Per-provider model fetcher + cache.** `model-fetcher.ts` queries each
+  provider's models endpoint with a 20s timeout; `model-cache.ts` persists
+  results with a 7-day TTL under `~/.code-shell/cache/`.
+- **/init redesign.** New per-scenario templates (create / improve /
+  migrate / empty / rules-scaffold) driven by a repo-state detector.
+- **Tool-result-storage.** Content-addressed store keeps large tool outputs
+  out of in-memory history while remaining retrievable.
+- **AskUser options.** The `__ask_user__` tool now supports header /
+  multi-choice options / multiSelect, rendered as an option picker.
+- **Investigation guard.** Runtime enforcement of the "investigation has a
+  budget" rule from `coding.md`: re-reading the same target prepends a
+  reminder; a third re-read is hard-blocked. Four+ consecutive read-only
+  calls (or three+ silent turns) inject a strategy-change reminder.
+- **Per-session verbose recorder.** Dev-only JSONL trace under `log/<date>/
+  session-<sid>.jsonl` capturing every LLM request/response, tool call, and
+  engine event. Gated on `CODE_SHELL_DEV=1` / `--debug` / running from src.
+  7-day retention, argv secrets redacted, per-record output clipped to 256 KB.
+- **Pasted-noise sanitizer.** Engine rejects tasks that are >70% ANSI/box
+  characters (typical pasted terminal output) instead of running on them.
+- **Slimmer `/export markdown`.** Reasoning blocks are collapsible, tool_use
+  shows tool name + formatted args, tool_result over 2 KB spills to a
+  sidecar file alongside the markdown.
+- **Live session heartbeat.** `state.json` is now flushed every turn with
+  current `turnCount` and token usage, so external observers see live
+  progress instead of a stale snapshot from the last completed run.
+
+### Changed (breaking)
+- `SessionStatus` is now `"active" | "paused" | TerminalReason` instead of
+  `"active" | "paused" | "completed" | "errored"`. `state.json` records the
+  raw terminal reason (e.g. `aborted_streaming`, `model_error`,
+  `prompt_too_long`) so callers can distinguish user cancellation from real
+  failures. Downstream code that narrows the old four-value union will
+  need to widen its match.
+
+### Changed
+- API key resolution centralized into `resolveApiKey()` (one canonical
+  fallback chain: option → settings → all provider env vars). Replaces five
+  drifting copies in `repl.ts`, `run.ts`, `runs.ts`, `main.ts`,
+  `core-commands.ts`. Side effect: `runs` and `/doctor` now also pick up
+  provider env vars they previously ignored (e.g. `OPENROUTER_API_KEY`).
+- Refreshed `openrouter-models.json` (367 → 365; dropped retired Claude 3.7
+  Sonnet variants; corrected Kimi K2.5 / Pareto Code / MiniMax M2.5 context
+  windows).
+
+## [0.1.4] - 2026-05-09
+
+### Fixed
+- **Multi-model `apiKey` ignored on startup.** When `settings.json` defined
+  a model in `models[]` (with its own `apiKey`/`baseUrl`) and the top-level
+  `model.apiKey` was empty, the runtime fell through to
+  `OPENROUTER_API_KEY` env, producing 401s against non-OpenRouter
+  endpoints (e.g. DeepSeek direct). Engine constructor now merges the
+  active pool entry's `apiKey`/`baseUrl` back into `config.llm` —
+  matching the existing `/model` switch path.
+- **Banner version hardcoded.** `Banner.tsx`, `printBanner`, and
+  `commander.version()` all displayed `v0.1.0` regardless of
+  `package.json`. Now read dynamically via `getCurrentVersion()`.
+- **`updater.ts` ESM crash.** `require("../../package.json")` is unavailable
+  in ESM builds. Replaced with a walk-up + `createRequire` fallback that
+  works in both ESM and CJS bundles. Also corrected the npm package name
+  used by the update check (`@cjhyy/code-shell`, not `code-shell`).
+
 ## [0.1.0-alpha.1] - 2026-04-30
 
 ### Changed (breaking)

package/dist/anthropic-IBTI4WL2.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkYIQBXAYUcjs = require('./chunk-YIQBXAYU.cjs');
+require('./chunk-7EG3V4JY.cjs');
+require('./chunk-2YW4FPFG.cjs');
+require('./chunk-IK4EWJBP.cjs');
+require('./chunk-KS3RYAYL.cjs');
+
+
+exports.AnthropicClient = _chunkYIQBXAYUcjs.AnthropicClient;

package/dist/anthropic-PRZZKHEZ.js

@@ -0,0 +1,10 @@
+import {
+  AnthropicClient
+} from "./chunk-ZBPSQCPU.js";
+import "./chunk-6S4BJ65N.js";
+import "./chunk-SFXHZSRF.js";
+import "./chunk-BXCY2FSE.js";
+import "./chunk-MD32R22I.js";
+export {
+  AnthropicClient
+};

package/dist/arena/index.cjs

@@ -5,7 +5,7 @@
 
 
 
-var _chunkX2DNIMPCcjs = require('../chunk-X2DNIMPC.cjs');
+var _chunkDDB6QOKJcjs = require('../chunk-DDB6QOKJ.cjs');
 
 
 
@@ -48,10 +48,11 @@ var _chunkX2DNIMPCcjs = require('../chunk-X2DNIMPC.cjs');
 
 
 
-var _chunkHOXQLX5Rcjs = require('../chunk-HOXQLX5R.cjs');
-require('../chunk-EL2RL5DG.cjs');
-require('../chunk-JHNCK7JP.cjs');
-require('../chunk-IJSHQGMP.cjs');
+var _chunkWZJV6DJCcjs = require('../chunk-WZJV6DJC.cjs');
+require('../chunk-YKIAELDZ.cjs');
+require('../chunk-2YW4FPFG.cjs');
+require('../chunk-IK4EWJBP.cjs');
+require('../chunk-KS3RYAYL.cjs');
 
 
 
@@ -100,4 +101,4 @@ require('../chunk-IJSHQGMP.cjs');
 
 
 
-exports.Arena = _chunkHOXQLX5Rcjs.Arena; exports.ArenaLedger = _chunkHOXQLX5Rcjs.ArenaLedger; exports.DiscussionStrategy = _chunkHOXQLX5Rcjs.DiscussionStrategy; exports.IterativeArena = _chunkX2DNIMPCcjs.IterativeArena; exports.LENS_NAMES = _chunkHOXQLX5Rcjs.LENS_NAMES; exports.MODEL_PRESETS = _chunkHOXQLX5Rcjs.MODEL_PRESETS; exports.PlanningStrategy = _chunkHOXQLX5Rcjs.PlanningStrategy; exports.ReviewStrategy = _chunkHOXQLX5Rcjs.ReviewStrategy; exports.applyReviewResult = _chunkHOXQLX5Rcjs.applyReviewResult; exports.buildConsensus = _chunkHOXQLX5Rcjs.buildConsensus; exports.buildDigest = _chunkHOXQLX5Rcjs.buildDigest; exports.buildLensPrompt = _chunkHOXQLX5Rcjs.buildLensPrompt; exports.collectEvidence = _chunkHOXQLX5Rcjs.collectEvidence; exports.createProgressRenderer = _chunkHOXQLX5Rcjs.createProgressRenderer; exports.defaultIterateConvergence = _chunkX2DNIMPCcjs.defaultConvergence; exports.formatArenaResult = _chunkHOXQLX5Rcjs.formatArenaResult; exports.formatArenaResultForSession = _chunkHOXQLX5Rcjs.formatArenaResultForSession; exports.formatDigest = _chunkHOXQLX5Rcjs.formatDigest; exports.getIterateFormat = _chunkX2DNIMPCcjs.getFormat; exports.getLens = _chunkHOXQLX5Rcjs.getLens; exports.getMaxOutputTokens = _chunkHOXQLX5Rcjs.getMaxOutputTokens; exports.getStrategy = _chunkHOXQLX5Rcjs.getStrategy; exports.getStrategyForPlan = _chunkHOXQLX5Rcjs.getStrategyForPlan; exports.hasTools = _chunkHOXQLX5Rcjs.hasTools; exports.isStrategyV2 = _chunkHOXQLX5Rcjs.isStrategyV2; exports.isTerminal = _chunkHOXQLX5Rcjs.isTerminal; exports.iterateCodeFormat = _chunkX2DNIMPCcjs.codeFormat; exports.iterateDiffRatio = _chunkX2DNIMPCcjs.diffRatio; exports.iterateDocumentFormat = _chunkX2DNIMPCcjs.documentFormat; exports.markUnderReview = _chunkHOXQLX5Rcjs.markUnderReview; exports.markUnresolved = _chunkHOXQLX5Rcjs.markUnresolved; exports.planArena = _chunkHOXQLX5Rcjs.planArena; exports.printArenaResult = _chunkHOXQLX5Rcjs.printArenaResult; exports.registerClaims = _chunkHOXQLX5Rcjs.registerClaims; exports.renderProgress = _chunkHOXQLX5Rcjs.renderProgress; exports.resolveClaimStatus = _chunkHOXQLX5Rcjs.resolveClaimStatus; exports.resolveLenses = _chunkHOXQLX5Rcjs.resolveLenses; exports.runAdjudication = _chunkHOXQLX5Rcjs.runAdjudication; exports.runCrossReview = _chunkHOXQLX5Rcjs.runCrossReview; exports.runDebateRounds = _chunkHOXQLX5Rcjs.runDebateRounds; exports.runParticipantResearch = _chunkHOXQLX5Rcjs.runParticipantResearch; exports.runParticipantResearchWithDossiers = _chunkHOXQLX5Rcjs.runParticipantResearchWithDossiers; exports.runVerificationReview = _chunkHOXQLX5Rcjs.runVerificationReview; exports.selectClaimsForReview = _chunkHOXQLX5Rcjs.selectClaimsForReview; exports.selectTools = _chunkHOXQLX5Rcjs.selectTools; exports.transitionClaim = _chunkHOXQLX5Rcjs.transitionClaim; exports.validTransitions = _chunkHOXQLX5Rcjs.validTransitions;
+exports.Arena = _chunkWZJV6DJCcjs.Arena; exports.ArenaLedger = _chunkWZJV6DJCcjs.ArenaLedger; exports.DiscussionStrategy = _chunkWZJV6DJCcjs.DiscussionStrategy; exports.IterativeArena = _chunkDDB6QOKJcjs.IterativeArena; exports.LENS_NAMES = _chunkWZJV6DJCcjs.LENS_NAMES; exports.MODEL_PRESETS = _chunkWZJV6DJCcjs.MODEL_PRESETS; exports.PlanningStrategy = _chunkWZJV6DJCcjs.PlanningStrategy; exports.ReviewStrategy = _chunkWZJV6DJCcjs.ReviewStrategy; exports.applyReviewResult = _chunkWZJV6DJCcjs.applyReviewResult; exports.buildConsensus = _chunkWZJV6DJCcjs.buildConsensus; exports.buildDigest = _chunkWZJV6DJCcjs.buildDigest; exports.buildLensPrompt = _chunkWZJV6DJCcjs.buildLensPrompt; exports.collectEvidence = _chunkWZJV6DJCcjs.collectEvidence; exports.createProgressRenderer = _chunkWZJV6DJCcjs.createProgressRenderer; exports.defaultIterateConvergence = _chunkDDB6QOKJcjs.defaultConvergence; exports.formatArenaResult = _chunkWZJV6DJCcjs.formatArenaResult; exports.formatArenaResultForSession = _chunkWZJV6DJCcjs.formatArenaResultForSession; exports.formatDigest = _chunkWZJV6DJCcjs.formatDigest; exports.getIterateFormat = _chunkDDB6QOKJcjs.getFormat; exports.getLens = _chunkWZJV6DJCcjs.getLens; exports.getMaxOutputTokens = _chunkWZJV6DJCcjs.getMaxOutputTokens; exports.getStrategy = _chunkWZJV6DJCcjs.getStrategy; exports.getStrategyForPlan = _chunkWZJV6DJCcjs.getStrategyForPlan; exports.hasTools = _chunkWZJV6DJCcjs.hasTools; exports.isStrategyV2 = _chunkWZJV6DJCcjs.isStrategyV2; exports.isTerminal = _chunkWZJV6DJCcjs.isTerminal; exports.iterateCodeFormat = _chunkDDB6QOKJcjs.codeFormat; exports.iterateDiffRatio = _chunkDDB6QOKJcjs.diffRatio; exports.iterateDocumentFormat = _chunkDDB6QOKJcjs.documentFormat; exports.markUnderReview = _chunkWZJV6DJCcjs.markUnderReview; exports.markUnresolved = _chunkWZJV6DJCcjs.markUnresolved; exports.planArena = _chunkWZJV6DJCcjs.planArena; exports.printArenaResult = _chunkWZJV6DJCcjs.printArenaResult; exports.registerClaims = _chunkWZJV6DJCcjs.registerClaims; exports.renderProgress = _chunkWZJV6DJCcjs.renderProgress; exports.resolveClaimStatus = _chunkWZJV6DJCcjs.resolveClaimStatus; exports.resolveLenses = _chunkWZJV6DJCcjs.resolveLenses; exports.runAdjudication = _chunkWZJV6DJCcjs.runAdjudication; exports.runCrossReview = _chunkWZJV6DJCcjs.runCrossReview; exports.runDebateRounds = _chunkWZJV6DJCcjs.runDebateRounds; exports.runParticipantResearch = _chunkWZJV6DJCcjs.runParticipantResearch; exports.runParticipantResearchWithDossiers = _chunkWZJV6DJCcjs.runParticipantResearchWithDossiers; exports.runVerificationReview = _chunkWZJV6DJCcjs.runVerificationReview; exports.selectClaimsForReview = _chunkWZJV6DJCcjs.selectClaimsForReview; exports.selectTools = _chunkWZJV6DJCcjs.selectTools; exports.transitionClaim = _chunkWZJV6DJCcjs.transitionClaim; exports.validTransitions = _chunkWZJV6DJCcjs.validTransitions;

package/dist/arena/index.js

@@ -5,7 +5,7 @@ import {
   diffRatio,
   documentFormat,
   getFormat
-} from "../chunk-OUC2DFA7.js";
+} from "../chunk-QARL3IDQ.js";
 import {
   Arena,
   ArenaLedger,
@@ -48,10 +48,11 @@ import {
   selectTools,
   transitionClaim,
   validTransitions
-} from "../chunk-Y7TSCDF6.js";
-import "../chunk-FUOKLKR2.js";
-import "../chunk-ZRVPCXI7.js";
-import "../chunk-DI7RDLOS.js";
+} from "../chunk-BZ5TNE7L.js";
+import "../chunk-3QO25N6E.js";
+import "../chunk-SFXHZSRF.js";
+import "../chunk-BXCY2FSE.js";
+import "../chunk-MD32R22I.js";
 export {
   Arena,
   ArenaLedger,

package/dist/arena/model-presets.d.ts

@@ -10,5 +10,14 @@ export interface ModelPreset {
     maxOutputTokens: number;
 }
 export declare const MODEL_PRESETS: Record<string, ModelPreset>;
-/** Look up max output tokens for a model string, falling back to a safe default. */
+/**
+ * Look up max output tokens for a model string, falling back to a safe default.
+ *
+ * Lookup order:
+ *   1. Arena preset key (e.g. "claude", "gpt") — short aliases used in arena UX
+ *   2. Arena preset model path (e.g. "anthropic/claude-opus-4.6")
+ *   3. resolveMaxOutput — the canonical table in onboarding.ts that also covers
+ *      direct-provider IDs (deepseek-v4-pro, …) and OpenRouter snapshot
+ *   4. 8192 — final safe fallback
+ */
 export declare function getMaxOutputTokens(model: string): number;

package/dist/{arena-ENHBHB2W.js → arena-2LTLIXOL.js}

@@ -1,9 +1,10 @@
 import {
   ModelPool
-} from "./chunk-F5BS3GUC.js";
+} from "./chunk-BSW22MPA.js";
+import "./chunk-3OA5G4TM.js";
 import {
   SettingsManager
-} from "./chunk-75E4BBFC.js";
+} from "./chunk-3SBSUOWZ.js";
 import {
   Arena,
   MODEL_PRESETS,
@@ -12,12 +13,13 @@ import {
   getMaxOutputTokens,
   printArenaResult,
   renderProgress
-} from "./chunk-Y7TSCDF6.js";
-import "./chunk-FUOKLKR2.js";
-import "./chunk-ZRVPCXI7.js";
+} from "./chunk-BZ5TNE7L.js";
+import "./chunk-3QO25N6E.js";
+import "./chunk-SFXHZSRF.js";
+import "./chunk-BXCY2FSE.js";
 import {
   init_esm_shims
-} from "./chunk-DI7RDLOS.js";
+} from "./chunk-MD32R22I.js";
 
 // src/cli/commands/arena.ts
 init_esm_shims();
@@ -72,7 +74,7 @@ function buildModelPool(engineConfig) {
         pool.register({
           key: m.key,
           label: m.label,
-          provider: m.provider,
+          provider: m.provider ?? "",
           model: m.model,
           baseUrl: m.baseUrl ?? engineConfig.llm.baseUrl,
           apiKey: m.apiKey ?? engineConfig.llm.apiKey,

package/dist/{arena-HHDYYVHJ.cjs → arena-ADB7DRFI.cjs}

@@ -1,9 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkKOGV6PDQcjs = require('./chunk-KOGV6PDQ.cjs');
+var _chunk55XGPMAPcjs = require('./chunk-55XGPMAP.cjs');
+require('./chunk-52LGZKT3.cjs');
 
 
-var _chunkFV2ARONZcjs = require('./chunk-FV2ARONZ.cjs');
+var _chunk7BI3V74Ycjs = require('./chunk-7BI3V74Y.cjs');
 
 
 
@@ -12,15 +13,16 @@ var _chunkFV2ARONZcjs = require('./chunk-FV2ARONZ.cjs');
 
 
 
-var _chunkHOXQLX5Rcjs = require('./chunk-HOXQLX5R.cjs');
-require('./chunk-EL2RL5DG.cjs');
-require('./chunk-JHNCK7JP.cjs');
+var _chunkWZJV6DJCcjs = require('./chunk-WZJV6DJC.cjs');
+require('./chunk-YKIAELDZ.cjs');
+require('./chunk-2YW4FPFG.cjs');
+require('./chunk-IK4EWJBP.cjs');
 
 
-var _chunkIJSHQGMPcjs = require('./chunk-IJSHQGMP.cjs');
+var _chunkKS3RYAYLcjs = require('./chunk-KS3RYAYL.cjs');
 
 // src/cli/commands/arena.ts
-_chunkIJSHQGMPcjs.init_cjs_shims.call(void 0, );
+_chunkKS3RYAYLcjs.init_cjs_shims.call(void 0, );
 var _chalk = require('chalk'); var _chalk2 = _interopRequireDefault(_chalk);
 async function runArenaReview(arg, engineConfig, opts) {
   const { models: modelsFlag, mode: explicitMode, base, head, topic } = parseFlags(arg);
@@ -38,8 +40,8 @@ async function runArenaReview(arg, engineConfig, opts) {
   out(_chalk2.default.bold(`\u2550\u2550\u2550 Arena ${modeLabel} \u2550\u2550\u2550`));
   out(_chalk2.default.dim(`Topic:  ${topic}`));
   out(_chalk2.default.dim(`Models: ${participants.map((p) => p.name).join(" vs ")}`));
-  const progressRenderer = _optionalChain([opts, 'optionalAccess', _2 => _2.output]) ? _chunkHOXQLX5Rcjs.createProgressRenderer.call(void 0, opts.output) : _chunkHOXQLX5Rcjs.renderProgress;
-  const arena = new (0, _chunkHOXQLX5Rcjs.Arena)({
+  const progressRenderer = _optionalChain([opts, 'optionalAccess', _2 => _2.output]) ? _chunkWZJV6DJCcjs.createProgressRenderer.call(void 0, opts.output) : _chunkWZJV6DJCcjs.renderProgress;
+  const arena = new (0, _chunkWZJV6DJCcjs.Arena)({
     participants,
     mode: explicitMode,
     enableContextTools: true,
@@ -53,9 +55,9 @@ async function runArenaReview(arg, engineConfig, opts) {
     });
     const resultSink = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _3 => _3.outputMessage]), () => ( _optionalChain([opts, 'optionalAccess', _4 => _4.output])));
     if (resultSink) {
-      resultSink(_chunkHOXQLX5Rcjs.formatArenaResultForSession.call(void 0, result));
+      resultSink(_chunkWZJV6DJCcjs.formatArenaResultForSession.call(void 0, result));
     } else {
-      _chunkHOXQLX5Rcjs.printArenaResult.call(void 0, result);
+      _chunkWZJV6DJCcjs.printArenaResult.call(void 0, result);
     }
     return result;
   } catch (err) {
@@ -64,15 +66,15 @@ async function runArenaReview(arg, engineConfig, opts) {
   }
 }
 function buildModelPool(engineConfig) {
-  const pool = new (0, _chunkKOGV6PDQcjs.ModelPool)();
+  const pool = new (0, _chunk55XGPMAPcjs.ModelPool)();
   try {
-    const settings = new (0, _chunkFV2ARONZcjs.SettingsManager)(process.cwd()).get();
+    const settings = new (0, _chunk7BI3V74Ycjs.SettingsManager)(process.cwd()).get();
     if (_optionalChain([settings, 'access', _5 => _5.models, 'optionalAccess', _6 => _6.length])) {
       for (const m of settings.models) {
         pool.register({
           key: m.key,
           label: m.label,
-          provider: m.provider,
+          provider: _nullishCoalesce(m.provider, () => ( "")),
           model: m.model,
           baseUrl: _nullishCoalesce(m.baseUrl, () => ( engineConfig.llm.baseUrl)),
           apiKey: _nullishCoalesce(m.apiKey, () => ( engineConfig.llm.apiKey)),
@@ -96,7 +98,7 @@ function resolveOneParticipant(entry, pool, engineConfig) {
         apiKey: _nullishCoalesce(m.apiKey, () => ( engineConfig.llm.apiKey)),
         baseUrl: _nullishCoalesce(m.baseUrl, () => ( engineConfig.llm.baseUrl)),
         temperature: 0.3,
-        maxTokens: _nullishCoalesce(m.maxOutputTokens, () => ( _chunkHOXQLX5Rcjs.getMaxOutputTokens.call(void 0, m.model))),
+        maxTokens: _nullishCoalesce(m.maxOutputTokens, () => ( _chunkWZJV6DJCcjs.getMaxOutputTokens.call(void 0, m.model))),
         enableStreaming: false
       }
     };
@@ -109,7 +111,7 @@ function resolveOneParticipant(entry, pool, engineConfig) {
       apiKey: _nullishCoalesce(entry.apiKey, () => ( engineConfig.llm.apiKey)),
       baseUrl: _nullishCoalesce(entry.baseUrl, () => ( engineConfig.llm.baseUrl)),
       temperature: 0.3,
-      maxTokens: _chunkHOXQLX5Rcjs.getMaxOutputTokens.call(void 0, entry.model),
+      maxTokens: _chunkWZJV6DJCcjs.getMaxOutputTokens.call(void 0, entry.model),
       enableStreaming: false
     }
   };
@@ -129,12 +131,12 @@ function resolveParticipants(engineConfig, modelsFlag) {
             apiKey: _nullishCoalesce(fromPool.apiKey, () => ( engineConfig.llm.apiKey)),
             baseUrl: _nullishCoalesce(fromPool.baseUrl, () => ( engineConfig.llm.baseUrl)),
             temperature: 0.3,
-            maxTokens: _nullishCoalesce(fromPool.maxOutputTokens, () => ( _chunkHOXQLX5Rcjs.getMaxOutputTokens.call(void 0, fromPool.model))),
+            maxTokens: _nullishCoalesce(fromPool.maxOutputTokens, () => ( _chunkWZJV6DJCcjs.getMaxOutputTokens.call(void 0, fromPool.model))),
             enableStreaming: false
           }
         };
       }
-      const preset = _chunkHOXQLX5Rcjs.MODEL_PRESETS[name];
+      const preset = _chunkWZJV6DJCcjs.MODEL_PRESETS[name];
       if (preset) {
         return {
           name: modelDisplayName(preset.model),
@@ -155,7 +157,7 @@ function resolveParticipants(engineConfig, modelsFlag) {
       };
     });
   }
-  const settings = new (0, _chunkFV2ARONZcjs.SettingsManager)(process.cwd()).get();
+  const settings = new (0, _chunk7BI3V74Ycjs.SettingsManager)(process.cwd()).get();
   if (_optionalChain([settings, 'access', _7 => _7.arena, 'optionalAccess', _8 => _8.participants, 'optionalAccess', _9 => _9.length]) >= 2) {
     const resolved = settings.arena.participants.map((p) => resolveOneParticipant(p, pool, engineConfig)).filter((p) => p !== void 0);
     if (resolved.length >= 2) return resolved;
@@ -165,7 +167,7 @@ function resolveParticipants(engineConfig, modelsFlag) {
       name: modelDisplayName(engineConfig.llm.model),
       llm: {
         ...engineConfig.llm,
-        maxTokens: _chunkHOXQLX5Rcjs.getMaxOutputTokens.call(void 0, engineConfig.llm.model),
+        maxTokens: _chunkWZJV6DJCcjs.getMaxOutputTokens.call(void 0, engineConfig.llm.model),
         enableStreaming: false
       }
     }
@@ -178,7 +180,7 @@ function resolveParticipants(engineConfig, modelsFlag) {
       llm: {
         ...engineConfig.llm,
         model: opponent,
-        maxTokens: _chunkHOXQLX5Rcjs.getMaxOutputTokens.call(void 0, opponent),
+        maxTokens: _chunkWZJV6DJCcjs.getMaxOutputTokens.call(void 0, opponent),
         enableStreaming: false
       }
     });
@@ -232,7 +234,7 @@ function formatUsage() {
     "  --base <ref>   Base branch/ref for comparison",
     "  --head <ref>   Head branch/ref (default: HEAD)",
     "",
-    `${_chalk2.default.dim("Available model presets:")} ${Object.keys(_chunkHOXQLX5Rcjs.MODEL_PRESETS).join(", ")}`
+    `${_chalk2.default.dim("Available model presets:")} ${Object.keys(_chunkWZJV6DJCcjs.MODEL_PRESETS).join(", ")}`
   ].join("\n");
 }
 function formatModelHelp(engineConfig) {
@@ -256,4 +258,4 @@ function modelDisplayName(model) {
 
 
 
-exports.formatArenaResultForSession = _chunkHOXQLX5Rcjs.formatArenaResultForSession; exports.runArenaReview = runArenaReview;
+exports.formatArenaResultForSession = _chunkWZJV6DJCcjs.formatArenaResultForSession; exports.runArenaReview = runArenaReview;

package/dist/{chunk-EL2RL5DG.cjs → chunk-2YW4FPFG.cjs}

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkIJSHQGMPcjs = require('./chunk-IJSHQGMP.cjs');
+var _chunkKS3RYAYLcjs = require('./chunk-KS3RYAYL.cjs');
 
 // src/exceptions.ts
-_chunkIJSHQGMPcjs.init_cjs_shims.call(void 0, );
+_chunkKS3RYAYLcjs.init_cjs_shims.call(void 0, );
 var FrameworkError = class extends Error {
   constructor(message, details) {
     super(message);

package/dist/chunk-3OA5G4TM.js

@@ -0,0 +1,47 @@
+import {
+  init_esm_shims
+} from "./chunk-MD32R22I.js";
+
+// src/llm/model-cache.ts
+init_esm_shims();
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var TTL_MS = 7 * 24 * 3600 * 1e3;
+function readCache(cacheDir, providerKey) {
+  const path = join(cacheDir, `${providerKey}.json`);
+  if (!existsSync(path)) return void 0;
+  try {
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.models)) return void 0;
+    return parsed;
+  } catch {
+    return void 0;
+  }
+}
+function writeCache(cacheDir, providerKey, models) {
+  if (!existsSync(cacheDir)) mkdirSync(cacheDir, { recursive: true });
+  const payload = {
+    fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    providerKey,
+    models
+  };
+  writeFileSync(join(cacheDir, `${providerKey}.json`), JSON.stringify(payload, null, 2), "utf-8");
+  return payload;
+}
+function isStale(file, now = Date.now()) {
+  const ts = Date.parse(file.fetchedAt);
+  if (!Number.isFinite(ts)) return true;
+  return now - ts > TTL_MS;
+}
+function defaultCacheDir() {
+  return join(homedir(), ".code-shell", "cache", "models");
+}
+
+export {
+  readCache,
+  writeCache,
+  isStale,
+  defaultCacheDir
+};