@cjhyy/code-shell 0.1.0-alpha.0

package/CHANGELOG.md

@@ -0,0 +1,109 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and while the project is pre-1.0 we treat any 0.x → 0.(x+1) bump as potentially
+breaking.
+
+## [Unreleased]
+
+### Added
+- **`IterativeArena` — multi-model authoring loop.** Pipeline: tournament v1
+  (every participant writes a draft, the author merges anonymized drafts into
+  v1) → critique-revise rounds (parallel critics produce anchored critiques
+  with severity/category, author rewrites). Two formats out of the box: `code`
+  and `document`. Configurable convergence (default: stop when no blockers
+  remain and either all critiques are minor/praise or the draft barely moved),
+  optional `humanCheckpoint` for interactive use, and `authorRotation` of
+  `fixed` / `round-robin` / `best-critic`. Public API exported from
+  `src/index.ts`. New types: `IterateConfig`, `IterateResult`, `Draft`,
+  `Critique`, `ConvergenceSignal`, `Round`, etc.
+  - Use `IterativeArena` to **produce** a draft from scratch (PRD, design doc,
+    code module). Use the existing `Arena` to **review** an existing artifact.
+- `eslint.config.js` (ESLint v9 flat config) with typescript-eslint preset.
+- `LICENSE` (MIT) and `CHANGELOG.md` at the repository root.
+- `prepublishOnly` script to run typecheck + tests + build before publish.
+- `node >= 20` engine constraint alongside the existing `bun >= 1.3` hint.
+
+### Fixed
+- TypeScript compilation is now clean (was 50+ errors).
+  - Removed zombie `cli/transports/`, `cli/handlers/`, `cli/remoteIO.ts`,
+    `cli/structuredIO.ts`, `cli/ndjsonSafeStringify.ts` — these were copied
+    from the Claude Code source tree but depended on modules that were never
+    ported and had no active callers.
+  - `engine/model-facade.ts`: aligned field names with the real `TokenUsage`
+    interface (`promptTokens`/`completionTokens`/`cacheCreationTokens`) and
+    used `LLMClientBase.model` instead of the non-existent `modelName`.
+  - `utils/env.ts`, `ink/termio/osc.ts`, `utils/fullscreen.ts`: small type
+    drift fixes.
+- Test suite is green (was 3 failing):
+  - Plan-mode tests were asserting an old `plan_file` parameter shape.
+  - `estimateTokens` test hard-coded an outdated char→token ratio.
+- `SavePRD` and `LoadTemplate` custom tools in `examples/prd-agent` now reject
+  filenames that resolve outside the intended directory (path-traversal fix).
+- `WebFetch` rejects non-HTTP(S) URLs and URLs whose literal hostname matches
+  loopback / link-local / RFC1918 / cloud-metadata (`169.254.169.254`) ranges,
+  and strips client-supplied `Authorization` / `Cookie` / `Host` headers.
+  Note: this does not defeat DNS rebinding or IPv4-decimal (e.g.
+  `http://2130706433/`) encoding — a defense-in-depth proxy is still
+  recommended for untrusted LLM input.
+- Bash read-only classifier no longer auto-approves commands that contain
+  `;`, `&&`, `||`, backticks, `$(...)`, or redirections. Removed `node -e`,
+  `python -c`, and `sed -n` from the read-only prefix list — those can execute
+  arbitrary code.
+- LSP client (`lsp/client.ts`) now `unref()`s the spawned process, clears its
+  per-request 30s timeout on resolve/reject, and fully removes listeners +
+  drains pending requests on `shutdown()`.
+- `SessionManager.saveState` performs an atomic `.tmp` → rename instead of a
+  bare `writeFileSync`, so two processes writing the same session no longer
+  corrupt each other.
+- MCP connect now times out after 15 s so a misbehaving server can't hang the
+  whole startup sequence.
+- OpenAI/OpenRouter 401 "Provider returned error" now surfaces a clearer
+  message hinting the model may not support function calling on the current
+  provider, instead of the opaque SDK message.
+- Context manager `recordActualUsage` is now actually invoked from the turn
+  loop after each model response, so the hybrid estimator has real API data
+  instead of always falling back to character-count heuristics.
+- `examples/prd-agent/src/chat.ts` picks `openai/gpt-4.1-mini` as the default
+  model when using OpenRouter, because `openai/gpt-4o-mini` gets routed to an
+  Azure backend that rejects tool calls with 401.
+
+### Removed
+- `TodoWrite` tool. It was a 6-line wrapper around `TaskCreate` and its
+  presence confused models into using two equivalent interfaces. Use the
+  `Task*` family (`TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`, etc.).
+
+### Changed
+- Arena research-phase prompts no longer hard-cap output at "exactly 3 to 6
+  findings". The new instruction asks for "as many findings as the topic
+  warrants — typically 5-15", with each `summary` field expected to be 80+
+  words with concrete evidence. Debate-turn prompts likewise replaced
+  "Be concise" with a 150-300 word target. This addresses persistent reports
+  that Arena output was too thin for non-trivial topics.
+- IterativeArena critics can now use web search via the `enableWebSearch`
+  config flag. When enabled (and a SERPER_API_KEY / TAVILY_API_KEY /
+  SEARXNG_URL is configured), each critic runs a tool-use loop and may call
+  `web_search` / `web_fetch` up to `maxArgueToolRounds` times before
+  emitting critiques. New `Critique.evidence` field carries the URLs they
+  consulted. New `fabrication` value in `CritiqueCategory`. Format prompts
+  (draft / merge / revise / argue, both `code` and `document`) now ban
+  invented numbers, citations, and URLs; unknowable specifics must be
+  marked `[需调研]` / `[TBD: ...]`.
+
+### Fixed
+- IterativeArena: `extractTag` now tolerates LLM responses where the
+  closing `</v1_content>` / `</v_next_content>` marker is missing (e.g. due
+  to max_tokens truncation). Previously the parser fell back to "use the
+  whole response as content", which left literal `<v1_content>` text at the
+  start of v1.md.
+- IterativeArena: tournament draft / merge / single-author v1 / revise all
+  now request `maxTokens: 32000`. The previous 8k default truncated
+  long-form drafts mid-sentence and broke downstream parsing.
+- IterativeArena: convergence no longer treats "zero critiques" as
+  "all_minor_or_praise". Zero is almost always a parsing or timeout
+  failure on the critic side, not a sign the draft is done. The loop now
+  continues to the next round (and naturally stops at `maxRounds`).
+  Convergence also requires at least 3 critiques before declaring success
+  on the "no blockers / no majors" branch.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 maki maki
+
+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,177 @@
+# CodeShell
+
+CodeShell is a general-purpose AI agent orchestration framework for terminal and headless workflows.
+
+It now ships with built-in presets:
+
+- `general`: a domain-agnostic orchestrator for research, automation, operations, and long-running tasks
+- `terminal-coding`: a coding-focused terminal assistant built on top of the same core engine
+
+The important part is that the core is no longer tied to software engineering. The turn loop, context management, permissions, MCP integration, hooks, tasks, cron, and sub-agents stay generic; coding behavior is expressed as a preset.
+
+## Features
+
+### Core engine
+
+- Turn-based agent loop with streaming output
+- Context compaction and session persistence
+- Permission-gated tool execution
+- Hook pipeline and MCP integration
+- Task tracking, sub-agents, sleep, and cron tools for long-running workflows
+
+### Presets
+
+- `general` for orchestration-heavy work
+- `terminal-coding` for terminal-native code editing and code navigation
+- Configurable prompt and built-in tool selection through settings or the programmatic API
+
+### Terminal UX
+
+- Interactive REPL built with Ink
+- Headless `run` mode for one-shot execution
+- Session resume and cost tracking
+
+## Quick start
+
+```bash
+# Default CLI preset: terminal coding assistant
+npx @cjhyy/code-shell
+
+# Run the same framework as a general orchestrator
+npx @cjhyy/code-shell --preset general
+
+# One-shot execution with the general preset
+npx @cjhyy/code-shell run --preset general "Create a long-running research plan and track it with tasks"
+```
+
+## Programmatic API
+
+```ts
+import { Engine } from "@cjhyy/code-shell";
+
+const generalEngine = new Engine({
+  llm: {
+    provider: "openai",
+    model: "gpt-4.1",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  preset: "general",
+});
+
+const codingEngine = new Engine({
+  llm: {
+    provider: "openai",
+    model: "gpt-4.1",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  preset: "terminal-coding",
+});
+```
+
+### Subpath imports
+
+Pull only what you need:
+
+```ts
+import { RunManager, FileRunStore } from "@cjhyy/code-shell/run";
+import { Arena, IterativeArena }     from "@cjhyy/code-shell/arena";
+import { defineProduct }             from "@cjhyy/code-shell/product";
+```
+
+## Configuration
+
+CLI preset selection:
+
+```bash
+npx @cjhyy/code-shell --preset general
+npx @cjhyy/code-shell --preset terminal-coding
+```
+
+Settings-based configuration:
+
+```json
+{
+  "agent": {
+    "preset": "general",
+    "enabledBuiltinTools": ["LSP"],
+    "disabledBuiltinTools": ["WebSearch"],
+    "appendSystemPrompt": "Prefer long-horizon planning and keep task state updated."
+  }
+}
+```
+
+Supported `agent` settings:
+
+- `preset`
+- `enabledBuiltinTools`
+- `disabledBuiltinTools`
+- `customSystemPrompt`
+- `appendSystemPrompt`
+
+## Built-in presets
+
+| Preset | Purpose | Extra tools |
+|------|------|------|
+| `general` | General orchestration, research, automation, long-running work | Core orchestration tools only |
+| `terminal-coding` | Terminal coding assistant | `EnterWorktree`, `ExitWorktree`, `NotebookEdit`, `LSP`, `Brief` |
+
+## Built-in tools
+
+The framework keeps a broad orchestration toolbox available, including:
+
+- File tools: `Read`, `Write`, `Edit`, `Glob`, `Grep`
+- Execution tools: `Bash`, `PowerShell`, `REPL`
+- Coordination tools: `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`, `TaskOutput`, `Agent`, `SendMessage`, `Sleep`
+- Planning/runtime tools: `EnterPlanMode`, `ExitPlanMode`, `CronCreate`, `CronDelete`, `CronList`
+- Discovery/integration tools: `ToolSearch`, `Skill`, `MCPTool`, `ListMcpResources`, `ReadMcpResource`
+- Coding-only preset extras: `EnterWorktree`, `ExitWorktree`, `NotebookEdit`, `LSP`
+
+## Architecture
+
+```text
+User / CLI / SDK
+  -> Engine
+    -> Preset resolution (prompt + default tools + default permission shortcuts)
+    -> TurnLoop
+      -> ModelFacade
+      -> ToolExecutor
+      -> ContextManager
+      -> Hooks / MCP / Tasks / Sessions
+```
+
+Design principles:
+
+- Core first: orchestration engine stays domain-agnostic
+- Presets over hardcoding: coding behavior lives in configuration
+- Secure by default: permission-gated actions and explicit approval flow
+- Long-running ready: tasks, cron, sleep, and sub-agents are first-class
+
+## Further Reading
+
+- [CodeShell 当前架构与定位说明](docs/codeshell-repo-architecture.md)
+
+## Project structure
+
+```text
+src/
+├── cli/              # CLI entrypoints and terminal UI
+├── context/          # Context compaction and window management
+├── engine/           # Turn loop orchestration
+├── hooks/            # Hook chain
+├── llm/              # Model providers
+├── preset/           # Built-in agent presets
+├── prompt/           # Prompt composition
+├── session/          # Session persistence and memory
+├── tool/             # Tool registry, execution, permissions, MCP
+└── index.ts          # Public API exports
+```
+
+## Development
+
+```bash
+bun install
+bun run build
+bun run tsc --noEmit
+```
+
+`bun run tsc --noEmit` currently reports many pre-existing repo-wide issues outside the preset/framework changes, so treat typecheck as a global health signal rather than a clean gate for just this slice.

package/dist/agent/coordinator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent coordinator — agent registry + message bus for multi-agent communication.
+ */
+/** A registered named agent. */
+export interface AgentInfo {
+    id: string;
+    name: string;
+    status: "running" | "completed" | "failed";
+    description: string;
+    startedAt: number;
+    completedAt?: number;
+    result?: string;
+}
+/** A message between agents. */
+export interface AgentMessage {
+    from: string;
+    to: string;
+    content: string;
+    timestamp: number;
+}
+/**
+ * Singleton agent registry and message bus.
+ */
+declare class AgentCoordinator {
+    private agents;
+    private inbox;
+    /** Register a named agent. */
+    register(id: string, name: string, description: string): void;
+    /** Mark an agent as completed. */
+    complete(name: string, result?: string): void;
+    /** Mark an agent as failed. */
+    fail(name: string): void;
+    /** Get agent info by name. */
+    get(name: string): AgentInfo | undefined;
+    /** List all agents. */
+    list(): AgentInfo[];
+    /** List active (running) agents. */
+    listActive(): AgentInfo[];
+    /** Send a message to a named agent. */
+    send(from: string, to: string, content: string): boolean;
+    /** Read messages for a named agent (drains the inbox). */
+    receive(name: string): AgentMessage[];
+    /** Peek at messages without draining. */
+    peek(name: string): AgentMessage[];
+    /** Reset all state. */
+    reset(): void;
+}
+export declare const agentCoordinator: AgentCoordinator;
+export {};

package/dist/anthropic-NENYS535.js

@@ -0,0 +1,9 @@
+import {
+  AnthropicClient
+} from "./chunk-YZ25SSWJ.js";
+import "./chunk-O6F2EF2Z.js";
+import "./chunk-FUOKLKR2.js";
+import "./chunk-DI7RDLOS.js";
+export {
+  AnthropicClient
+};

package/dist/anthropic-XMTTVNSH.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkZJV3YSY3cjs = require('./chunk-ZJV3YSY3.cjs');
+require('./chunk-DICG4AB7.cjs');
+require('./chunk-EL2RL5DG.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+exports.AnthropicClient = _chunkZJV3YSY3cjs.AnthropicClient;

package/dist/arena/arena.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Arena — multi-model collaborative analysis engine.
+ *
+ * Evidence-Driven Pipeline:
+ *   0. Planner            → understand what the user wants (mode, lenses, sources)
+ *   1. EvidenceProviders   → collect artifacts from selected sources
+ *   2. Strategy + Lens     → compose prompts (mode flow + perspective)
+ *   3. ToolSelector        → determine which tools participants can use
+ *   4. ParticipantResearch  → each model investigates independently (parallel)
+ *   4b. ClaimRegistry      → register findings as claims, populate ledger
+ *   5. VerificationReview   → claim-aware cross-review with evidence digests
+ *   7. DebateRounds         → contested claims enter structured debate
+ *   8. Adjudication         → moderator rules on contested claims
+ *   6. ConsensusBuilder     → claim-aware structured consensus
+ */
+import type { ArenaConfig, ArenaResultV2 } from "./types.js";
+import type { PlannerFlags } from "./planner.js";
+export declare class Arena {
+    private config;
+    private strategy;
+    private limits;
+    constructor(config: ArenaConfig);
+    /**
+     * Run a full arena session.
+     *
+     * @param topic  - User's topic/request (natural language)
+     * @param flags  - Optional explicit overrides (mode, base, head)
+     */
+    run(topic: string, flags?: PlannerFlags): Promise<ArenaResultV2>;
+    /**
+     * Planning path: merge-oriented review → roadmap consensus → detail expansion.
+     *
+     * Planning mode does NOT enter heavy debate/adjudication. Contested findings
+     * are converted to open questions or dependency risks in the roadmap.
+     */
+    private runPlanningPath;
+    /**
+     * Review/Discussion path: verification review → debate → adjudication → consensus.
+     *
+     * This is the heavy trust loop for claim verification.
+     */
+    private runReviewDiscussionPath;
+}

package/dist/arena/context/context-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Context tools — read-only tools that arena participants can use
+ * to fetch additional source context during research.
+ *
+ * Security: All shell commands use execFileSync with argument arrays
+ * to prevent command injection. File paths are validated against the
+ * repository boundary to prevent path traversal.
+ */
+import type { ToolDefinition, ToolCall } from "../../types.js";
+export declare const MAX_TOOL_RESULT = 15000;
+export declare const MAX_TOOL_ROUNDS = 5;
+export declare const CONTEXT_TOOLS: ToolDefinition[];
+/**
+ * Execute a context tool call and return the result string.
+ */
+export declare function executeContextTool(tc: ToolCall): string;

package/dist/arena/detect-mode.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Arena mode auto-detection — infer review/discussion/planning from topic text.
+ *
+ * Heuristic-based: uses keyword matching with weighted scoring.
+ * Falls back to "review" (safest default) when confidence is low.
+ */
+import type { ArenaMode } from "./types.js";
+/** Result of heuristic mode detection */
+export interface ArenaModeDetection {
+    mode: ArenaMode;
+    confidence: "high" | "low";
+    reason: string;
+}
+/**
+ * Auto-detect arena mode from the topic string.
+ *
+ * Returns the detected mode, confidence level, and a human-readable reason.
+ * When confidence is low, falls back to "review" (the safest default).
+ */
+export declare function detectArenaMode(topic: string): ArenaModeDetection;

package/dist/arena/digest-builder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * DigestBuilder — constructs RoundResearchDigest from the shared ledger.
+ *
+ * The digest is a filtered view injected into prompts to avoid
+ * token explosion from the full ledger. Program-built, not model-built.
+ */
+import type { ArenaLedger } from "./ledger.js";
+import type { RoundResearchDigest } from "./types.js";
+interface DigestOptions {
+    /** Current round number */
+    round: number;
+    /** Claim IDs relevant to this round (e.g. contested claims in debate) */
+    relevantClaimIds: string[];
+}
+/**
+ * Build a digest from the shared ledger for a specific round.
+ * Only includes data relevant to the specified claims.
+ */
+export declare function buildDigest(ledger: ArenaLedger, options: DigestOptions): RoundResearchDigest;
+/**
+ * Format a digest into a text block suitable for prompt injection.
+ * All LLM-originated text is sanitized before inclusion.
+ */
+export declare function formatDigest(digest: RoundResearchDigest): string;
+export {};

package/dist/arena/index.cjs

@@ -0,0 +1,103 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+var _chunk3EUDE77Ecjs = require('../chunk-3EUDE77E.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkFVP7XJGScjs = require('../chunk-FVP7XJGS.cjs');
+require('../chunk-IMMTBZ33.cjs');
+require('../chunk-EL2RL5DG.cjs');
+require('../chunk-IJSHQGMP.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.Arena = _chunkFVP7XJGScjs.Arena; exports.ArenaLedger = _chunkFVP7XJGScjs.ArenaLedger; exports.DiscussionStrategy = _chunkFVP7XJGScjs.DiscussionStrategy; exports.IterativeArena = _chunk3EUDE77Ecjs.IterativeArena; exports.LENS_NAMES = _chunkFVP7XJGScjs.LENS_NAMES; exports.MODEL_PRESETS = _chunkFVP7XJGScjs.MODEL_PRESETS; exports.PlanningStrategy = _chunkFVP7XJGScjs.PlanningStrategy; exports.ReviewStrategy = _chunkFVP7XJGScjs.ReviewStrategy; exports.applyReviewResult = _chunkFVP7XJGScjs.applyReviewResult; exports.buildConsensus = _chunkFVP7XJGScjs.buildConsensus; exports.buildDigest = _chunkFVP7XJGScjs.buildDigest; exports.buildLensPrompt = _chunkFVP7XJGScjs.buildLensPrompt; exports.collectEvidence = _chunkFVP7XJGScjs.collectEvidence; exports.createProgressRenderer = _chunkFVP7XJGScjs.createProgressRenderer; exports.defaultIterateConvergence = _chunk3EUDE77Ecjs.defaultConvergence; exports.formatArenaResult = _chunkFVP7XJGScjs.formatArenaResult; exports.formatArenaResultForSession = _chunkFVP7XJGScjs.formatArenaResultForSession; exports.formatDigest = _chunkFVP7XJGScjs.formatDigest; exports.getIterateFormat = _chunk3EUDE77Ecjs.getFormat; exports.getLens = _chunkFVP7XJGScjs.getLens; exports.getMaxOutputTokens = _chunkFVP7XJGScjs.getMaxOutputTokens; exports.getStrategy = _chunkFVP7XJGScjs.getStrategy; exports.getStrategyForPlan = _chunkFVP7XJGScjs.getStrategyForPlan; exports.hasTools = _chunkFVP7XJGScjs.hasTools; exports.isStrategyV2 = _chunkFVP7XJGScjs.isStrategyV2; exports.isTerminal = _chunkFVP7XJGScjs.isTerminal; exports.iterateCodeFormat = _chunk3EUDE77Ecjs.codeFormat; exports.iterateDiffRatio = _chunk3EUDE77Ecjs.diffRatio; exports.iterateDocumentFormat = _chunk3EUDE77Ecjs.documentFormat; exports.markUnderReview = _chunkFVP7XJGScjs.markUnderReview; exports.markUnresolved = _chunkFVP7XJGScjs.markUnresolved; exports.planArena = _chunkFVP7XJGScjs.planArena; exports.printArenaResult = _chunkFVP7XJGScjs.printArenaResult; exports.registerClaims = _chunkFVP7XJGScjs.registerClaims; exports.renderProgress = _chunkFVP7XJGScjs.renderProgress; exports.resolveClaimStatus = _chunkFVP7XJGScjs.resolveClaimStatus; exports.resolveLenses = _chunkFVP7XJGScjs.resolveLenses; exports.runAdjudication = _chunkFVP7XJGScjs.runAdjudication; exports.runCrossReview = _chunkFVP7XJGScjs.runCrossReview; exports.runDebateRounds = _chunkFVP7XJGScjs.runDebateRounds; exports.runParticipantResearch = _chunkFVP7XJGScjs.runParticipantResearch; exports.runParticipantResearchWithDossiers = _chunkFVP7XJGScjs.runParticipantResearchWithDossiers; exports.runVerificationReview = _chunkFVP7XJGScjs.runVerificationReview; exports.selectClaimsForReview = _chunkFVP7XJGScjs.selectClaimsForReview; exports.selectTools = _chunkFVP7XJGScjs.selectTools; exports.transitionClaim = _chunkFVP7XJGScjs.transitionClaim; exports.validTransitions = _chunkFVP7XJGScjs.validTransitions;

package/dist/arena/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Arena — multi-model collaborative analysis (Evidence-Driven).
+ */
+export { Arena } from "./arena.js";
+export { MODEL_PRESETS, getMaxOutputTokens } from "./model-presets.js";
+export type { ModelPreset } from "./model-presets.js";
+export { getStrategy, getStrategyForPlan, ReviewStrategy, DiscussionStrategy, PlanningStrategy } from "./strategies/index.js";
+export { planArena } from "./planner.js";
+export { collectEvidence } from "./providers/index.js";
+export { selectTools, hasTools } from "./tools/selector.js";
+export { getLens, resolveLenses, buildLensPrompt, LENS_NAMES } from "./lenses/index.js";
+export { runParticipantResearch, runParticipantResearchWithDossiers } from "./phases/participant-research.js";
+export type { ResearchResult } from "./phases/participant-research.js";
+export { runCrossReview, runVerificationReview } from "./phases/cross-review.js";
+export { runDebateRounds } from "./phases/debate-rounds.js";
+export { runAdjudication } from "./phases/adjudication.js";
+export { buildConsensus } from "./phases/build-consensus.js";
+export { registerClaims, selectClaimsForReview } from "./phases/claim-registry.js";
+export { ArenaLedger } from "./ledger.js";
+export { buildDigest, formatDigest } from "./digest-builder.js";
+export { transitionClaim, resolveClaimStatus, markUnderReview, applyReviewResult, markUnresolved, isTerminal, validTransitions, } from "./transitions.js";
+export { formatArenaResult, printArenaResult, renderProgress, createProgressRenderer } from "./render/terminal.js";
+export type { OutputSink } from "./render/terminal.js";
+export { formatArenaResultForSession } from "./render/session.js";
+export type { ArenaConfig, ArenaResultV2, ArenaStrategy, ArenaStrategyV2, ClaimStatusSummary, ArenaParticipant, ArenaBaseContext, ArenaFinding, FindingReview, ParticipantReport, ArenaConsensus, ArenaConsensusItem, ArenaRoadmapPhase, ArenaProgressEvent, ArenaMode, FindingKind, PeerVerdict, ArenaPlan, ArenaLens, ArenaLensName, ArenaLensRef, ArenaSourceKind, ArenaSourceSpec, ArenaSubject, ArenaOutputShape, ArenaArtifact, ArenaToolPack, ArenaContextProvider, ArenaQuickFact, ToolTrace, EvidencePacket, FindingEvidenceLink, ResearchDossier, ClaimStatus, ClaimRecord, ClaimChallenge, ClaimAdjudication, RequestedCheck, DebateRound, DebateTurn, TargetedCheckTask, SharedResearchLedger, RoundResearchDigest, ArenaExecutionLimits, } from "./types.js";
+export { isStrategyV2 } from "./types.js";
+export { IterativeArena } from "./iterate/index.js";
+export { defaultConvergence as defaultIterateConvergence, diffRatio as iterateDiffRatio, codeFormat as iterateCodeFormat, documentFormat as iterateDocumentFormat, getFormat as getIterateFormat, } from "./iterate/index.js";
+export type { AuthorRotation, CheckpointAction, CheckpointContext, CheckpointFn, ConvergenceSignal, Critique, CritiqueCategory, CritiqueEvidence, CritiqueSeverity, Draft, DraftCandidate, IterateConfig, IterateFormat, IterateProgressEvent, IterateResult, IterateSubject, Round, StoppedReason, FormatPack as IterateFormatPack, } from "./iterate/index.js";