@cjhyy/code-shell 0.3.0 → 0.5.0-rc.1

package/CHANGELOG.md

@@ -8,6 +8,81 @@ breaking.
 
 ## [Unreleased]
 
+### Added
+
+#### Reusable sub-agent roles (`.code-shell/agents`)
+
+- The `Agent` tool now accepts an optional `agent_type` parameter. When set, it
+  loads a reusable role definition from `<cwd>/.code-shell/agents/<name>.md`
+  (YAML frontmatter + body), supplying the sub-agent's model, tool allowlist,
+  turn cap, and system prompt. Omitting `agent_type` preserves the existing
+  ephemeral behavior — fully backward compatible.
+- Per-role **model routing** via `ModelPool` keys (unknown key → soft fallback
+  to the parent model), per-role **tool allowlists**, and per-role **turn caps**.
+- Background sub-agents are now capped at `MAX_BACKGROUND_AGENTS` (default 6);
+  synchronous sub-agents have a wall-clock timeout (default 5 minutes).
+- Sub-agent spawns emit `subagent_start` / `subagent_finish` / `subagent_error`
+  lifecycle events through the existing `notification` hook.
+- Ships sample roles under `examples/agents/`: `researcher` and `explorer`
+  (read-only), `planner` (read-only planning), and `general-purpose` (full
+  tools). Their `model` is left unset so they reuse the parent model — set
+  `model:` in the frontmatter to route a role to a specific pool key.
+
+## [0.5.0-rc.0] - 2026-05-23
+
+> ⚠️ Breaking. The repo is now a monorepo with three published packages.
+> The single-package install path still works (`@cjhyy/code-shell` re-exports
+> everything from core), but direct deep imports into `src/...` are gone.
+> Migrate to the public package APIs before upgrading.
+
+### Changed
+
+#### Monorepo split — three packages
+
+The codebase was split into a Bun workspace with three publishable packages
+plus one private Electron POC:
+
+- **`@cjhyy/code-shell-core`** — the engine. Engine, AgentServer, hooks,
+  tool system, LLM clients, session, protocol types, presets. Zero UI
+  dependencies. Headless and embeddable in any host (TUI, Electron main,
+  server). No React, no Ink, no chalk.
+- **`@cjhyy/code-shell-tui`** — the terminal client. Owns the React/Ink
+  render layer, the `code-shell` CLI bin, themes, key bindings, all
+  terminal-only utilities. Imports core; nothing else imports it.
+- **`@cjhyy/code-shell`** (meta) — thin re-export shim. `import { Engine }
+  from "@cjhyy/code-shell"` still works for SDK users; the `code-shell`
+  bin loads the TUI CLI. Ships three files total: `index.js`, `index.d.ts`,
+  `cli.js`.
+- **`@cjhyy/code-shell-desktop`** (private) — Electron POC. Currently a
+  build-pipeline skeleton (main + preload + renderer + esbuild/vite
+  orchestration). Not published.
+
+Existing users on `@cjhyy/code-shell` see no API change; deep-import users
+(`@cjhyy/code-shell/src/...`) must migrate to the public surface.
+
+#### Core decoupled from chalk
+
+`@cjhyy/code-shell-core` no longer depends on `chalk`. ~70 chalk call sites
+across cost-tracker, arena render, theme, and CLI-shared modules were
+replaced with an injected `Colorizer` interface. Hosts pass a colorizer
+implementation (TUI uses chalk; Electron / headless use `NOOP_COLORIZER`).
+This removes core's last terminal-formatting dependency and lets non-TTY
+hosts render the same data structures with their own styling.
+
+### Added
+
+- ESLint architectural guards: renderer cannot import core directly;
+  no-engine-bypass check enforced.
+- `scripts/build-meta.ts` — produces the meta package's three-file dist.
+- `packages/desktop/scripts/{dev,build}.ts` — three-process orchestrator
+  (vite renderer + esbuild main + esbuild preload).
+
+### Removed
+
+- `chalk` dependency from `@cjhyy/code-shell-core`.
+- All deep-import paths under `src/...`. Use `@cjhyy/code-shell-core`'s
+  public surface (`@cjhyy/code-shell` for SDK users).
+
 ## [0.3.0] - 2026-05-20
 
 ### Added

package/dist/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "@cjhyy/code-shell-tui/cli";

package/dist/index.d.ts

@@ -1,68 +1 @@
-/**
- * code-shell — general-purpose agent orchestration framework
- *
- * Public API exports.
- */
-export declare const VERSION = "0.2.0";
-export type { Message, ContentBlock, ToolDefinition, ToolCall, ToolResult, RegisteredTool, TranscriptEvent, TranscriptEventType, SessionState, TokenUsage, CompiledInput, PermissionDecision, PermissionMode, PermissionRule, TurnPhase, TurnResult, TerminalReason, StreamEvent, StreamCallback, LLMConfig, LLMResponse, Settings, MCPServerConfig, } from "./types.js";
-export { FrameworkError, LLMError, LLMRateLimitError, ContextLimitError, ToolError, ToolNotFoundError, ToolExecutionError, ToolTimeoutError, PermissionDeniedError, SessionError, TranscriptError, ConfigError, } from "./exceptions.js";
-export { Engine } from "./engine/engine.js";
-export type { EngineConfig, EngineHookConfig, EngineResult } from "./engine/engine.js";
-export type { CostStateStore, CostStateSnapshot } from "./engine/cost-store.js";
-export { LLMClientBase } from "./llm/client-base.js";
-export { createLLMClient, registerProvider } from "./llm/client-factory.js";
-export { AnthropicClient } from "./llm/providers/anthropic.js";
-export { OpenAIClient } from "./llm/providers/openai.js";
-export { ModelPool, type ModelEntry } from "./llm/model-pool.js";
-export { ToolRegistry } from "./tool-system/registry.js";
-export { ToolExecutor } from "./tool-system/executor.js";
-export { PermissionClassifier, HeadlessApprovalBackend, AutoApprovalBackend } from "./tool-system/permission.js";
-export type { ApprovalBackend } from "./tool-system/permission.js";
-export { BUILTIN_TOOLS } from "./tool-system/builtin/index.js";
-export { MCPManager } from "./tool-system/mcp-manager.js";
-export type { AskUserFn } from "./tool-system/builtin/ask-user.js";
-export { taskManager } from "./tool-system/builtin/task.js";
-export type { Task, TaskStatus } from "./tool-system/builtin/task.js";
-export { HookRegistry } from "./hooks/registry.js";
-export type { HookEventName, HookContext, HookResult } from "./hooks/events.js";
-export { wrapHookMessages } from "./hooks/inject.js";
-export { Transcript } from "./session/transcript.js";
-export { SessionManager } from "./session/session-manager.js";
-export { FileHistory } from "./session/file-history.js";
-export { MemoryManager } from "./session/memory.js";
-export type { MemoryEntry } from "./session/memory.js";
-export type { FileSnapshot } from "./session/file-history.js";
-export { PromptComposer } from "./prompt/composer.js";
-export { SectionCache } from "./prompt/section-cache.js";
-export { scanInstructions, combineInstructions } from "./prompt/instruction-scanner.js";
-export { BUILTIN_AGENT_PRESETS, DEFAULT_AGENT_PRESET, DEFAULT_CLI_PRESET, resolveAgentPreset, resolveBuiltinToolNames, buildPresetSystemPrompt, registerPreset, listPresetNames, } from "./preset/index.js";
-export type { AgentPreset, AgentPresetName } from "./preset/index.js";
-export { loadSection, loadSections, availableSections, registerSection } from "./prompt/section-loader.js";
-export { ContextManager } from "./context/manager.js";
-export { estimateTokens, microcompact, windowCompact, truncateToolResult, buildSummarizationPrompt, applySummaryCompaction, COMPACTABLE_TOOL_NAMES, } from "./context/compaction.js";
-export type { MicrocompactOptions } from "./context/compaction.js";
-export type { SummarizeFn, CompactStrategy, OnCompactFn, ContextManagerConfig, } from "./context/manager.js";
-export { applyToolResultPersistence, createContentReplacementState, reconstructContentReplacementState, resolveToolResultsDir, isPersistedReplacement, DEFAULT_PERSIST_THRESHOLD, PER_MESSAGE_AGGREGATE_CAP, PREVIEW_SIZE, } from "./context/tool-result-storage.js";
-export type { ContentReplacementState } from "./context/tool-result-storage.js";
-export { scanSkills, invalidateSkillCache } from "./skills/index.js";
-export type { SkillDefinition } from "./skills/index.js";
-export { Arena } from "./arena/arena.js";
-export { MODEL_PRESETS, getMaxOutputTokens } from "./arena/model-presets.js";
-export type { ModelPreset } from "./arena/model-presets.js";
-export { detectArenaMode } from "./arena/detect-mode.js";
-export { getStrategy, getStrategyForPlan, ReviewStrategy, DiscussionStrategy, PlanningStrategy } from "./arena/strategies/index.js";
-export { planArena } from "./arena/planner.js";
-export { collectEvidence } from "./arena/providers/index.js";
-export { selectTools, hasTools } from "./arena/tools/selector.js";
-export { ArenaLedger } from "./arena/ledger.js";
-export { registerClaims, selectClaimsForReview } from "./arena/phases/claim-registry.js";
-export { buildDigest, formatDigest } from "./arena/digest-builder.js";
-export { transitionClaim, resolveClaimStatus, markUnderReview, applyReviewResult, markUnresolved, isTerminal, validTransitions } from "./arena/transitions.js";
-export type { ArenaConfig, ArenaMode, ArenaResultV2, ArenaStrategy, ArenaParticipant, ArenaBaseContext, ArenaFinding, FindingReview, ParticipantReport, ArenaConsensus, ArenaConsensusItem, ArenaRoadmapPhase, ArenaProgressEvent, ArenaPlan, ArenaLens, ArenaLensName, ArenaSourceKind, ArenaArtifact, ArenaQuickFact, FindingKind, PeerVerdict, ToolTrace, EvidencePacket, FindingEvidenceLink, ResearchDossier, ClaimStatus, ClaimRecord, ClaimChallenge, ClaimAdjudication, RequestedCheck, DebateRound, DebateTurn, TargetedCheckTask, SharedResearchLedger, RoundResearchDigest, ArenaExecutionLimits, } from "./arena/types.js";
-export { IterativeArena, defaultIterateConvergence, iterateDiffRatio, iterateCodeFormat, iterateDocumentFormat, getIterateFormat, } from "./arena/index.js";
-export type { IterateConfig, IterateResult, IterateSubject, IterateFormat, IterateProgressEvent, IterateFormatPack, Draft, DraftCandidate, Critique, CritiqueCategory, CritiqueEvidence, CritiqueSeverity, ConvergenceSignal, Round, AuthorRotation, StoppedReason, CheckpointFn, CheckpointContext, CheckpointAction, } from "./arena/index.js";
-export { RunManager, type RunManagerConfig, type RunStore, FileRunStore, RunQueue, EngineRunner, type EngineRunnerConfig, type RunExecutionHandle, type RunExecutor, type CustomToolEntry, RunApprovalBackend, createRunAskUserFn, type RunLifecycleHooks, CheckpointWriter, ArtifactTracker, RunLock, Heartbeat, NoopEvaluator, CompositeEvaluator, type Evaluator, type EvaluatorResult, type EvaluatorContext, type RunStatus, type RunSnapshot, type RunEvent, type RunCheckpoint, type RunApproval, type RunArtifactRef, type SubmitRunInput, type ResumeRunInput, type ListRunsQuery, type RunStreamEvent, type RunStreamCallback, type DetachFn, VALID_TRANSITIONS, createRunManager, type CreateRunManagerOptions, } from "./run/index.js";
-export { defineProduct, type ProductDefinition, type ProductPreset, type ProductAdapter, type ProductContract, type CustomTool, type ProductRuntimeOptions, type ProductInstance, } from "./product/index.js";
-export { logger } from "./logging/logger.js";
-export { SettingsManager } from "./settings/manager.js";
-export { SettingsSchema, validateSettings } from "./settings/schema.js";
+export * from "@cjhyy/code-shell-core";

package/dist/index.js

@@ -1 +1 @@
-export{a as defineProduct}from'./chunk-GGVAOPI7.js';export{a as createRunManager}from'./chunk-5QIVXFCT.js';export{Y as ArtifactTracker,k as AutoApprovalBackend,F as BUILTIN_AGENT_PRESETS,f as BUILTIN_TOOLS,X as CheckpointWriter,aa as CompositeEvaluator,x as ContextManager,G as DEFAULT_AGENT_PRESET,H as DEFAULT_CLI_PRESET,p as DEFAULT_PERSIST_THRESHOLD,R as Engine,fa as EngineRunner,T as FileRunStore,j as HeadlessApprovalBackend,_ as Heartbeat,n as HookRegistry,$ as NoopEvaluator,q as PER_MESSAGE_AGGREGATE_CAP,r as PREVIEW_SIZE,m as PermissionClassifier,N as PromptComposer,V as RunApprovalBackend,Z as RunLock,ga as RunManager,U as RunQueue,y as SectionCache,i as ToolExecutor,g as ToolRegistry,S as VALID_TRANSITIONS,v as applyToolResultPersistence,E as availableSections,L as buildPresetSystemPrompt,A as combineInstructions,s as createContentReplacementState,W as createRunAskUserFn,w as isPersistedReplacement,J as listPresetNames,C as loadSection,D as loadSections,t as reconstructContentReplacementState,I as registerPreset,B as registerSection,K as resolveAgentPreset,M as resolveBuiltinToolNames,u as resolveToolResultsDir,z as scanInstructions,e as taskManager,o as wrapHookMessages}from'./chunk-Z5HKHAO7.js';export{i as invalidateSkillCache,h as scanSkills}from'./chunk-SKIX2M5Z.js';export{a as ModelPool}from'./chunk-MLCTC53I.js';export{a as FileHistory}from'./chunk-WI6FSWGU.js';import'./chunk-P6JSTIFM.js';import'./chunk-SNFAPSLA.js';export{a as MCPManager}from'./chunk-D3TVASD2.js';export{c as SettingsManager,a as SettingsSchema,b as validateSettings}from'./chunk-FZXY554D.js';import {p}from'./chunk-M7VU4YVY.js';export{e as COMPACTABLE_TOOL_NAMES,k as applySummaryCompaction,i as buildSummarizationPrompt,a as estimateTokens,f as microcompact,h as truncateToolResult,d as windowCompact}from'./chunk-M7VU4YVY.js';export{b as MemoryManager}from'./chunk-T222K6IV.js';export{b as SessionManager,a as Transcript}from'./chunk-QTWU7UNA.js';export{j as IterativeArena,f as defaultIterateConvergence,i as getIterateFormat,g as iterateCodeFormat,e as iterateDiffRatio,h as iterateDocumentFormat}from'./chunk-K4HILJ6G.js';export{J as Arena,I as ArenaLedger,e as DiscussionStrategy,S as MODEL_PRESETS,f as PlanningStrategy,d as ReviewStrategy,z as applyReviewResult,u as buildDigest,n as collectEvidence,b as createLLMClient,v as formatDigest,T as getMaxOutputTokens,k as getStrategy,l as getStrategyForPlan,p as hasTools,B as isTerminal,y as markUnderReview,A as markUnresolved,m as planArena,s as registerClaims,a as registerProvider,x as resolveClaimStatus,t as selectClaimsForReview,o as selectTools,w as transitionClaim,C as validTransitions}from'./chunk-WONQHE4P.js';import'./chunk-GKAQH2DG.js';export{a as AnthropicClient}from'./chunk-X2S7ASQ2.js';export{b as OpenAIClient}from'./chunk-SV7H4FKT.js';import'./chunk-O5HFCH2U.js';export{a as LLMClientBase}from'./chunk-OWBYLMDD.js';export{l as ConfigError,d as ContextLimitError,a as FrameworkError,b as LLMError,c as LLMRateLimitError,i as PermissionDeniedError,j as SessionError,e as ToolError,g as ToolExecutionError,f as ToolNotFoundError,h as ToolTimeoutError,k as TranscriptError}from'./chunk-FU7AHZNN.js';export{d as logger}from'./chunk-DI26OUIU.js';import {h,a}from'./chunk-3QP5BQ3L.js';h();p();h();var vt={review:[{patterns:[/\breview\b/i,/\baudit\b/i,/\binspect\b/i,/\bcheck\b/i],weight:2},{patterns:[/\bcode\s*quality\b/i,/\bbug\b/i,/\bvulnerab/i,/\bsecur/i]},{patterns:[/\bpr\b/i,/\bpull\s*request\b/i,/\bdiff\b/i,/\bchanges?\b/i]},{patterns:[/\brefactor/i,/\bclean\s*up\b/i,/\bimprove\b/i]}],discussion:[{patterns:[/\bdiscuss\b/i,/\bdebate\b/i,/\bcompare\b/i],weight:2},{patterns:[/\bpros?\s*(and|&|\/)\s*cons?\b/i,/\btrade\s*-?\s*offs?\b/i]},{patterns:[/\bshould\s+we\b/i,/\bwhich\s+(is|approach|way)\b/i,/\bvs\.?\b/i]},{patterns:[/\bopinion\b/i,/\bthoughts?\b/i,/\badvice\b/i]}],planning:[{patterns:[/\bplan\b/i,/\bplanning\b/i,/\broadmap\b/i,/\bstrategy\b/i],weight:2},{patterns:[/\barchitect/i,/\bdesign\b/i,/\bproposal\b/i]},{patterns:[/\bimplement(ation)?\s+(plan|strategy|approach)\b/i],weight:2},{patterns:[/\bphase\b/i,/\bmilestone\b/i,/\btimeline\b/i,/\bprioritiz/i]},{patterns:[/\bbuild\b/i,/\bcreate\b/i,/\bsetup\b/i,/\bbootstrap\b/i]}]},ht=3,Mt=2;function Pt(m){let a={review:0,discussion:0,planning:0};for(let[n,i]of Object.entries(vt))for(let p of i){let u=p.weight??1;for(let d of p.patterns)d.test(m)&&(a[n]+=u);}let s=Object.entries(a).sort((n,i)=>i[1]-n[1]),[t,e]=s[0],[,l]=s[1],r=e-l;return e>=ht&&r>=Mt?{mode:t,confidence:"high",reason:`Topic strongly matches "${t}" (score: ${e}, lead: +${r})`}:e>0&&r>0?{mode:t,confidence:"low",reason:`Topic weakly matches "${t}" (score: ${e}, lead: +${r})`}:{mode:"review",confidence:"low",reason:"No strong mode signal detected, defaulting to review"}}a(Pt,"detectArenaMode");var Dt="0.2.0";export{Dt as VERSION,Pt as detectArenaMode};
+export * from "@cjhyy/code-shell-core";

package/package.json

@@ -1,33 +1,39 @@
 {
   "name": "@cjhyy/code-shell",
-  "version": "0.3.0",
-  "description": "Code Shell — general-purpose agent orchestration framework with a terminal coding preset",
+  "version": "0.5.0-rc.1",
+  "description": "Code Shell — meta package. Installs @cjhyy/code-shell-core and @cjhyy/code-shell-tui.",
   "type": "module",
   "main": "./dist/index.js",
-  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./run": {
-      "types": "./dist/run/index.d.ts",
-      "import": "./dist/run/index.js"
-    },
-    "./arena": {
-      "types": "./dist/arena/index.d.ts",
-      "import": "./dist/arena/index.js"
-    },
-    "./product": {
-      "types": "./dist/product/index.d.ts",
-      "import": "./dist/product/index.js"
-    },
-    "./package.json": "./package.json"
+    }
   },
   "bin": {
-    "code-shell": "dist/cli/main.js"
+    "code-shell": "./dist/cli.js"
   },
+  "scripts": {
+    "preinstall": "node scripts/check-node.cjs",
+    "build": "bun run --filter '@cjhyy/code-shell-core' build && bun run --filter '@cjhyy/code-shell-tui' build && bun run scripts/build-meta.ts",
+    "dev": "CODE_SHELL_DEV=1 CODESHELL_UI_PERF=1 bun run packages/tui/src/cli/main.ts",
+    "dev:bigtranscript": "bun run scripts/render-bigtranscript-dev.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "bench:render": "bun run bench/render-tail.bench.ts && bun run bench/render-streaming.bench.ts && bun run bench/render-spinner.bench.ts && bun run bench/render-wheel.bench.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint packages/",
+    "lint:engine-bypass": "bash scripts/check-no-engine-bypass.sh",
+    "format": "prettier --write 'packages/**/*.ts'"
+  },
+  "dependencies": {
+    "@cjhyy/code-shell-core": "0.5.0-rc.1",
+    "@cjhyy/code-shell-tui": "0.5.0-rc.1"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cjhyy/codeshell.git"
@@ -39,22 +45,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "preinstall": "node scripts/check-node.cjs",
-    "build": "bun run sync-models && bun run tsup && bun run build:dts",
-    "build:dts": "tsc --emitDeclarationOnly --declaration --outDir dist || true",
-    "sync-models": "bun run scripts/sync-models.ts",
-    "dev": "CODE_SHELL_DEV=1 CODESHELL_UI_PERF=1 bun run src/cli/main.ts",
-    "dev:bigtranscript": "bun run scripts/render-bigtranscript-dev.ts",
-    "test": "bun test",
-    "bench:render": "bun run bench/render-tail.bench.ts && bun run bench/render-streaming.bench.ts && bun run bench/render-spinner.bench.ts && bun run bench/render-wheel.bench.ts",
-    "test:watch": "bun test --watch",
-    "lint": "eslint src/",
-    "lint:engine-bypass": "bash scripts/check-no-engine-bypass.sh",
-    "format": "prettier --write 'src/**/*.ts'",
-    "typecheck": "bun run tsc --noEmit",
-    "prepublishOnly": "bun run build"
-  },
   "engines": {
     "node": ">=20.10"
   },
@@ -77,45 +67,6 @@
   ],
   "author": "maki maki",
   "license": "MIT",
-  "dependencies": {
-    "@alcalzone/ansi-tokenize": "^0.3.0",
-    "@anthropic-ai/sdk": "^0.39.0",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "asciichart": "^1.5.25",
-    "auto-bind": "^5.0.1",
-    "bidi-js": "^1.0.3",
-    "chalk": "^5.4.1",
-    "cli-boxes": "^4.0.1",
-    "cli-highlight": "^2.1.11",
-    "code-excerpt": "^4.0.0",
-    "commander": "^13.1.0",
-    "diff": "^8.0.4",
-    "emoji-regex": "^10.6.0",
-    "get-east-asian-width": "^1.5.0",
-    "glob": "^11.0.0",
-    "gpt-tokenizer": "^3.4.0",
-    "indent-string": "^5.0.0",
-    "lodash-es": "^4.17.23",
-    "marked": "^17.0.5",
-    "marked-terminal": "^7.3.0",
-    "nanoid": "^5.1.2",
-    "openai": "^4.82.0",
-    "ora": "^9.3.0",
-    "proper-lockfile": "^4.1.2",
-    "react": "^19.2.4",
-    "react-reconciler": "^0.33.0",
-    "semver": "^7.7.4",
-    "signal-exit": "^4.1.0",
-    "stack-utils": "^2.0.6",
-    "strip-ansi": "^7.2.0",
-    "supports-hyperlinks": "^4.4.0",
-    "type-fest": "^5.5.0",
-    "usehooks-ts": "^3.1.1",
-    "wrap-ansi": "^10.0.0",
-    "yaml": "^2.7.0",
-    "yoga-layout": "^3.2.1",
-    "zod": "^3.24.2"
-  },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/lodash": "^4.17.24",
@@ -123,6 +74,7 @@
     "@types/node": "^22.12.0",
     "@types/react": "^19.2.14",
     "@types/semver": "^7.7.1",
+    "bun-types": "^1.3.14",
     "eslint": "^9.19.0",
     "prettier": "^3.4.2",
     "tsup": "^8.3.6",

package/dist/agent/coordinator.d.ts

@@ -1,49 +0,0 @@
-/**
- * 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-DJXVKFMJ.js

@@ -1 +0,0 @@
-export{a as AnthropicClient}from'./chunk-X2S7ASQ2.js';import'./chunk-O5HFCH2U.js';import'./chunk-OWBYLMDD.js';import'./chunk-FU7AHZNN.js';import'./chunk-DI26OUIU.js';import'./chunk-3QP5BQ3L.js';

package/dist/arena/arena.d.ts

@@ -1,43 +0,0 @@
-/**
- * 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

@@ -1,16 +0,0 @@
-/**
- * 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 = 3;
-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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1,25 +0,0 @@
-/**
- * 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.d.ts

@@ -1,29 +0,0 @@
-/**
- * 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";

package/dist/arena/index.js

@@ -1 +0,0 @@
-export{j as IterativeArena,f as defaultIterateConvergence,i as getIterateFormat,g as iterateCodeFormat,e as iterateDiffRatio,h as iterateDocumentFormat}from'../chunk-K4HILJ6G.js';export{J as Arena,I as ArenaLedger,e as DiscussionStrategy,j as LENS_NAMES,S as MODEL_PRESETS,f as PlanningStrategy,d as ReviewStrategy,z as applyReviewResult,H as buildConsensus,u as buildDigest,i as buildLensPrompt,n as collectEvidence,W as createProgressRenderer,U as formatArenaResult,Y as formatArenaResultForSession,v as formatDigest,g as getLens,T as getMaxOutputTokens,k as getStrategy,l as getStrategyForPlan,p as hasTools,c as isStrategyV2,B as isTerminal,y as markUnderReview,A as markUnresolved,m as planArena,V as printArenaResult,s as registerClaims,X as renderProgress,x as resolveClaimStatus,h as resolveLenses,G as runAdjudication,D as runCrossReview,F as runDebateRounds,q as runParticipantResearch,r as runParticipantResearchWithDossiers,E as runVerificationReview,t as selectClaimsForReview,o as selectTools,w as transitionClaim,C as validTransitions}from'../chunk-WONQHE4P.js';import'../chunk-GKAQH2DG.js';import'../chunk-FU7AHZNN.js';import'../chunk-DI26OUIU.js';import'../chunk-3QP5BQ3L.js';

package/dist/arena/iterate/convergence.d.ts

@@ -1,25 +0,0 @@
-/**
- * Convergence detection — when has the draft stabilized enough to stop?
- */
-import type { ConvergenceSignal, Critique, Draft } from "./types.js";
-/**
- * Cheap O(n) approximation of "how different is new vs old".
- * Returns 0..1 where 0 = identical, 1 = completely different.
- *
- * Uses character-trigram Jaccard distance — fast, good enough for "is the
- * author actually changing anything substantial?".
- */
-export declare function diffRatio(a: string, b: string): number;
-/**
- * Default convergence rule:
- *   stop if blockers == 0 AND
- *     (all critiques are minor/nit/praise OR diff < 5% from last version)
- *
- * Round 1 never converges (need at least one revision pass).
- */
-export declare function defaultConvergence(args: {
-    round: number;
-    critiques: Critique[];
-    draft: Draft;
-    previousDraft?: Draft;
-}): ConvergenceSignal;

package/dist/arena/iterate/formats/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * Format packs — prompt templates for code vs document iteration.
- *
- * Each format provides four prompt builders:
- *   - draftPrompt:    used in tournament v1 (every participant writes a candidate)
- *   - mergePrompt:    used in v1 merge (author reads anonymized candidates → v1)
- *   - argueSystem:    system prompt for critics
- *   - argueUser:      user prompt that wraps the current draft for critique
- *   - revisePrompt:   used to produce v(N+1) given v(N) + critiques
- */
-import type { Critique, Draft, DraftCandidate, IterateFormat, IterateSubject } from "../types.js";
-export interface FormatPack {
-    format: IterateFormat;
-    draftPrompt(subject: IterateSubject, minLength: number): string;
-    mergePrompt(subject: IterateSubject, candidates: DraftCandidate[], minLength: number): string;
-    argueSystem(format: IterateFormat): string;
-    argueUser(subject: IterateSubject, draft: Draft, lens?: string): string;
-    revisePrompt(subject: IterateSubject, previous: Draft, critiques: Critique[], minLength: number): string;
-}
-export declare const codeFormat: FormatPack;
-export declare const documentFormat: FormatPack;
-export declare function getFormat(format: IterateFormat): FormatPack;

package/dist/arena/iterate/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Arena Iterate — multi-model authoring loop.
- *
- * Public API for the iterate mode.
- */
-export { IterativeArena } from "./iterative-arena.js";
-export { defaultConvergence, diffRatio } from "./convergence.js";
-export { codeFormat, documentFormat, getFormat } from "./formats/index.js";
-export type { FormatPack } from "./formats/index.js";
-export type { AuthorRotation, CheckpointAction, CheckpointContext, CheckpointFn, ConvergenceSignal, Critique, CritiqueCategory, CritiqueEvidence, CritiqueSeverity, Draft, DraftCandidate, IterateConfig, IterateFormat, IterateProgressEvent, IterateResult, IterateSubject, Round, StoppedReason, } from "./types.js";
-export { ITERATE_WEB_TOOLS, hasWebSearchProvider } from "./tools/web-tools.js";

package/dist/arena/iterate/iterative-arena.d.ts

@@ -1,23 +0,0 @@
-/**
- * IterativeArena — multi-model authoring loop.
- *
- * Pipeline:
- *   1. v1: tournament (default) or single-author
- *   2. for each round 2..maxRounds:
- *        a. argue (parallel critics)
- *        b. checkpoint (optional human pause)
- *        c. convergence check
- *        d. if not converged: revise → next round
- *   3. final draft = last round's draft
- */
-import type { IterateConfig, IterateResult } from "./types.js";
-export declare class IterativeArena {
-    private readonly config;
-    constructor(config: IterateConfig);
-    run(): Promise<IterateResult>;
-    /** Critics for a given round = pool minus current author (so author isn't critiquing self). */
-    private criticsForRound;
-    private checkConvergence;
-    private pickNextAuthor;
-    private finalize;
-}

package/dist/arena/iterate/parse.d.ts

@@ -1,42 +0,0 @@
-/**
- * Parsing helpers for LLM responses in iterate mode.
- *
- * We use literal XML-ish markers (<v1_content>…</v1_content>) instead of
- * pure JSON because LLMs are far more reliable at "write 5000 chars of
- * markdown then a small JSON block at the end" than at producing one
- * giant well-formed JSON document with a 5000-char string field.
- */
-import type { Critique } from "./types.js";
-/**
- * Extract content between `<tag>` and `</tag>`.
- *
- * Forgiving in two ways:
- *  - Case-insensitive on the tag name.
- *  - If the closing tag is missing (LLM hit max_tokens mid-output), we still
- *    return everything after the opening tag, stopping at the next sibling
- *    tag (e.g. the `<merge_rationale>` block) if present, otherwise EOF.
- */
-export declare function extractTag(text: string, tag: string): string | null;
-/** Parse merge response: extract v1 content + rationale. Falls back to whole text if markers are missing. */
-export declare function parseMergeResponse(text: string): {
-    content: string;
-    rationale?: string;
-};
-export interface ReviseMeta {
-    acceptedCritiques?: string[];
-    rejectedCritiques?: Array<{
-        id: string;
-        reason: string;
-    }>;
-    changelog?: string;
-}
-/** Parse revise response: extract content + meta JSON. */
-export declare function parseReviseResponse(text: string): {
-    content: string;
-    meta: ReviseMeta;
-};
-/**
- * Parse critique JSON from an argue-phase response.
- * Tolerant: handles bare objects, fenced JSON, leading prose, trailing prose.
- */
-export declare function parseCritiquesResponse(text: string, criticName: string, idPrefix: string): Critique[];