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

package/dist/arena/iterate/phases/argue.d.ts

@@ -1,22 +0,0 @@
-/**
- * Argue phase — critics read a draft and produce critiques in parallel.
- *
- * If `enableWebSearch` is on, each critic runs a tool-use loop and may call
- * web_search / web_fetch up to `maxArgueToolRounds` times before producing
- * the final critiques JSON. This is the deep-research path that catches
- * fabricated claims.
- */
-import type { ArenaParticipant } from "../../types.js";
-import type { FormatPack } from "../formats/index.js";
-import type { Critique, Draft, IterateProgressEvent, IterateSubject } from "../types.js";
-export declare function runArgueRound(args: {
-    subject: IterateSubject;
-    format: FormatPack;
-    draft: Draft;
-    critics: ArenaParticipant[];
-    round: number;
-    enableWebSearch?: boolean;
-    maxToolRounds?: number;
-    signal?: AbortSignal;
-    onProgress?: (e: IterateProgressEvent) => void;
-}): Promise<Critique[]>;

package/dist/arena/iterate/phases/revise.d.ts

@@ -1,16 +0,0 @@
-/**
- * Revise phase — author rewrites the draft addressing critiques.
- */
-import type { ArenaParticipant } from "../../types.js";
-import type { FormatPack } from "../formats/index.js";
-import type { Critique, Draft, IterateProgressEvent, IterateSubject } from "../types.js";
-export declare function runRevise(args: {
-    subject: IterateSubject;
-    format: FormatPack;
-    previous: Draft;
-    critiques: Critique[];
-    author: ArenaParticipant;
-    minDraftLength: number;
-    signal?: AbortSignal;
-    onProgress?: (e: IterateProgressEvent) => void;
-}): Promise<Draft>;

package/dist/arena/iterate/phases/tournament.d.ts

@@ -1,34 +0,0 @@
-/**
- * Tournament v1 phase — every participant writes a candidate, then the
- * author merges anonymized candidates into v1.
- */
-import type { ArenaParticipant } from "../../types.js";
-import type { FormatPack } from "../formats/index.js";
-import type { Draft, DraftCandidate, IterateProgressEvent, IterateSubject } from "../types.js";
-/** Run the v1 tournament: parallel candidate generation. */
-export declare function runTournamentCandidates(args: {
-    subject: IterateSubject;
-    format: FormatPack;
-    participants: ArenaParticipant[];
-    minDraftLength: number;
-    signal?: AbortSignal;
-    onProgress?: (e: IterateProgressEvent) => void;
-}): Promise<DraftCandidate[]>;
-/** Merge candidates into v1 using the author. */
-export declare function mergeCandidatesToV1(args: {
-    subject: IterateSubject;
-    format: FormatPack;
-    author: ArenaParticipant;
-    candidates: DraftCandidate[];
-    minDraftLength: number;
-    signal?: AbortSignal;
-    onProgress?: (e: IterateProgressEvent) => void;
-}): Promise<Draft>;
-/** Single-author v1 (tournament disabled) — author writes alone. */
-export declare function singleAuthorV1(args: {
-    subject: IterateSubject;
-    format: FormatPack;
-    author: ArenaParticipant;
-    minDraftLength: number;
-    signal?: AbortSignal;
-}): Promise<Draft>;

package/dist/arena/iterate/tools/web-tools.d.ts

@@ -1,13 +0,0 @@
-/**
- * Web tools for arena iterate critics — fabrication detection support.
- *
- * Wraps the existing builtin webSearchTool / webFetchTool so critics can
- * verify factual claims during the argue phase.
- */
-import type { ToolDefinition } from "../../../types.js";
-export declare const webSearchToolDef: ToolDefinition;
-export declare const webFetchToolDef: ToolDefinition;
-export declare const ITERATE_WEB_TOOLS: ToolDefinition[];
-export declare function executeIterateWebTool(toolName: string, args: Record<string, unknown>): Promise<string>;
-/** Probe env to determine if any web-search provider is configured. */
-export declare function hasWebSearchProvider(): boolean;

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

@@ -1,152 +0,0 @@
-/**
- * Iterate mode — multi-model authoring loop.
- *
- * Author writes → critics argue → author revises → ... → final draft.
- * v1 uses a tournament: every participant writes a candidate, then the
- * author merges (anonymized inputs) into a single v1.
- */
-import type { ArenaParticipant } from "../types.js";
-export type IterateFormat = "code" | "document";
-export interface IterateSubject {
-    /** What the author is producing — short descriptive label. */
-    label: string;
-    /** Full instruction to the author / critics. */
-    description: string;
-    /** Optional source artifacts (file paths, urls) to ground the work. */
-    sources?: string[];
-}
-/** A v1 candidate produced by one participant during the tournament. */
-export interface DraftCandidate {
-    author: string;
-    anonymousLabel: string;
-    content: string;
-}
-export interface Draft {
-    version: number;
-    author: string;
-    format: IterateFormat;
-    content: string;
-    /**
-     * For v1 with tournament strategy: the candidates that were merged.
-     * For v2+: undefined.
-     */
-    draftCandidates?: DraftCandidate[];
-    /** Author's explanation of how candidates were merged into v1. */
-    mergeRationale?: string;
-    /**
-     * For v2+: which critique IDs were addressed and how.
-     */
-    acceptedCritiques?: string[];
-    rejectedCritiques?: Array<{
-        id: string;
-        reason: string;
-    }>;
-    /** Free-form note from author: what changed and why. */
-    changelog?: string;
-}
-export type CritiqueSeverity = "blocker" | "major" | "minor" | "nit" | "praise";
-export type CritiqueCategory = "correctness" | "completeness" | "clarity" | "evidence" | "structure" | "style" | "fabrication" | "other";
-export interface CritiqueEvidence {
-    url: string;
-    snippet?: string;
-}
-export interface Critique {
-    id: string;
-    critic: string;
-    /** 5-15 word quote from the draft for precise location. */
-    anchor: string;
-    severity: CritiqueSeverity;
-    category: CritiqueCategory;
-    comment: string;
-    /** Optional concrete suggestion. */
-    suggestion?: string;
-    /** Optional URLs the critic consulted to back up the critique. */
-    evidence?: CritiqueEvidence[];
-}
-export interface ConvergenceSignal {
-    blockerCount: number;
-    majorCount: number;
-    totalCritiques: number;
-    /** Levenshtein-ratio-like 0..1, where 0 = identical, 1 = totally different. */
-    diffFromPrevious: number;
-    shouldStop: boolean;
-    reason: "blockers_zero_and_stable" | "all_minor_or_praise" | "max_rounds" | "user_stop" | "user_force_continue" | "diff_below_threshold" | "running";
-}
-export interface Round {
-    round: number;
-    draft: Draft;
-    critiques: Critique[];
-    convergence: ConvergenceSignal;
-}
-export type AuthorRotation = "fixed" | "round-robin" | "best-critic";
-export interface CheckpointContext {
-    round: number;
-    draft: Draft;
-    critiques: Critique[];
-    convergence: ConvergenceSignal;
-}
-export type CheckpointAction = "continue" | "stop" | "force-continue";
-export type CheckpointFn = (ctx: CheckpointContext) => Promise<CheckpointAction>;
-export interface IterateProgressEvent {
-    type: "v1_tournament_start" | "v1_candidate_done" | "v1_merge_start" | "v1_merge_done" | "round_start" | "argue_start" | "argue_done" | "revise_start" | "revise_done" | "round_done" | "checkpoint_pause" | "iterate_complete";
-    round?: number;
-    participant?: string;
-    data?: Record<string, unknown>;
-}
-export interface IterateConfig {
-    subject: IterateSubject;
-    format: IterateFormat;
-    /** The participant who merges v1 and main-authors v2+. Required. */
-    author: ArenaParticipant;
-    /** Critic participants. Each must have unique `name`. */
-    critics: ArenaParticipant[];
-    /** Default 5. */
-    maxRounds?: number;
-    /**
-     * v1 strategy.
-     * - "tournament" (default): author + all critics each write a candidate,
-     *    author merges anonymized candidates into v1.
-     * - "single": author writes v1 alone (no tournament).
-     */
-    v1Strategy?: "tournament" | "single";
-    /** Default "fixed". */
-    authorRotation?: AuthorRotation;
-    /**
-     * If provided, called after each round; arena pauses for the response.
-     * Default: undefined (no checkpoints).
-     */
-    humanCheckpoint?: CheckpointFn;
-    /**
-     * Convergence rules. "default" applies built-in heuristics.
-     * Custom function returns true → stop after this round.
-     */
-    convergenceStrategy?: "default" | ((ctx: {
-        round: number;
-        critiques: Critique[];
-        draft: Draft;
-        previousDraft?: Draft;
-    }) => boolean);
-    /** Minimum content length per draft (chars). Used both as length budget hint and to retry-on-shrinkage. Default 800 for document, 200 for code. */
-    minDraftLength?: number;
-    /**
-     * Whether critics get web_search/web_fetch tools during the argue phase.
-     * Requires SERPER_API_KEY / TAVILY_API_KEY / SEARXNG_URL in env. Default false.
-     * When true, each argue call becomes a tool-use loop (critics may search
-     * before producing critiques) — significantly more tokens and time, but
-     * dramatically reduces fabrication.
-     */
-    enableWebSearch?: boolean;
-    /** Cap tool-use rounds per critic per argue phase. Default 8. */
-    maxArgueToolRounds?: number;
-    signal?: AbortSignal;
-    onProgress?: (event: IterateProgressEvent) => void;
-}
-export type StoppedReason = "converged" | "max_rounds" | "user_stop" | "errored" | "aborted";
-export interface IterateResult {
-    subject: IterateSubject;
-    format: IterateFormat;
-    rounds: Round[];
-    finalDraft: Draft;
-    stoppedAt: StoppedReason;
-    durationMs: number;
-}

package/dist/arena/ledger.d.ts

@@ -1,47 +0,0 @@
-/**
- * SharedResearchLedger — append-only shared state across all arena rounds.
- *
- * Design constraints (from architecture doc):
- * - All objects have stable IDs
- * - Append-only: history preserved, never overwritten
- * - Query layer supports latest-view aggregation
- * - Supports by-id, by-claim, by-participant, by-round filtering
- */
-import type { SharedResearchLedger, ResearchDossier, EvidencePacket, ClaimRecord, ClaimChallenge, RequestedCheck, ClaimAdjudication } from "./types.js";
-/**
- * Manages the shared research ledger — the single source of truth
- * for all evidence, claims, challenges, and adjudications in an arena session.
- */
-export declare class ArenaLedger {
-    private ledger;
-    private index;
-    constructor();
-    /** Check if ledger is approaching memory limits and log warnings */
-    private checkGrowth;
-    appendDossier(dossier: ResearchDossier): void;
-    appendEvidencePacket(packet: EvidencePacket): void;
-    appendClaim(claim: ClaimRecord): void;
-    appendChallenge(challenge: ClaimChallenge): void;
-    appendRequestedCheck(check: RequestedCheck): void;
-    appendAdjudication(adjudication: ClaimAdjudication): void;
-    /**
-     * Return a read-only reference to the full ledger.
-     *
-     * Note: `Readonly<>` is shallow — inner arrays are still mutable at the
-     * type level. Callers MUST NOT mutate the returned object; use the
-     * append* methods instead. A deep-freeze or structural clone can be
-     * added later if external consumers need a truly immutable snapshot.
-     */
-    getSnapshot(): Readonly<SharedResearchLedger>;
-    getClaimById(claimId: string): ClaimRecord | undefined;
-    getPacketById(packetId: string): EvidencePacket | undefined;
-    getAllClaims(): ClaimRecord[];
-    getClaimsByStatus(...statuses: ClaimRecord["status"][]): ClaimRecord[];
-    getClaimsByOwner(owner: string): ClaimRecord[];
-    getChallengesForClaim(claimId: string): ClaimChallenge[];
-    getPendingChecks(): RequestedCheck[];
-    getPendingChecksForClaim(claimId: string): RequestedCheck[];
-    getPacketsForClaim(claimId: string): EvidencePacket[];
-    getDossiers(): ResearchDossier[];
-    getDossierByParticipant(participant: string): ResearchDossier | undefined;
-}

package/dist/arena/lenses/architecture.d.ts

@@ -1,5 +0,0 @@
-/**
- * Architecture lens — system boundaries, modularity, evolution path.
- */
-import type { ArenaLens } from "../types.js";
-export declare const architectureLens: ArenaLens;

package/dist/arena/lenses/engineering.d.ts

@@ -1,5 +0,0 @@
-/**
- * Engineering lens — code quality, correctness, performance, maintainability.
- */
-import type { ArenaLens } from "../types.js";
-export declare const engineeringLens: ArenaLens;

package/dist/arena/lenses/general.d.ts

@@ -1,5 +0,0 @@
-/**
- * General lens — broad analysis without a specific domain focus.
- */
-import type { ArenaLens } from "../types.js";
-export declare const generalLens: ArenaLens;

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

@@ -1,16 +0,0 @@
-/**
- * Lens registry — analysis perspectives for Arena sessions.
- */
-import type { ArenaLens, ArenaLensName, ArenaLensRef } from "../types.js";
-export { engineeringLens } from "./engineering.js";
-export { productLens } from "./product.js";
-export { architectureLens } from "./architecture.js";
-export { generalLens } from "./general.js";
-/** Get a lens by name. */
-export declare function getLens(name: ArenaLensName): ArenaLens;
-/** Resolve lens refs into full ArenaLens objects. */
-export declare function resolveLenses(refs: ArenaLensRef[]): ArenaLens[];
-/** Build a combined lens prompt fragment for participant system prompts. */
-export declare function buildLensPrompt(lenses: ArenaLens[], phase: "participant" | "reviewer" | "moderator"): string;
-/** All available lens names */
-export declare const LENS_NAMES: ArenaLensName[];

package/dist/arena/lenses/product.d.ts

@@ -1,5 +0,0 @@
-/**
- * Product lens — user value, completeness, edge cases, acceptance criteria.
- */
-import type { ArenaLens } from "../types.js";
-export declare const productLens: ArenaLens;

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

@@ -1,23 +0,0 @@
-/**
- * Arena model presets — known models with their max output token limits.
- *
- * Used by arena participant resolution to set appropriate maxTokens
- * so that LLM output is not prematurely truncated.
- */
-export interface ModelPreset {
-    provider: string;
-    model: string;
-    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.
- *
- * 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/phases/adjudication.d.ts

@@ -1,24 +0,0 @@
-/**
- * Adjudication — the moderator makes evidence-based rulings on contested claims.
- *
- * For each contested/debated claim, the moderator sees the full claim context
- * (evidence, challenges, debate rounds) and produces a ClaimAdjudication.
- *
- * Claims that were verified without contest get synthetic adjudication records.
- */
-import type { ArenaParticipant, ArenaStrategy, ClaimAdjudication, ArenaProgressEvent } from "../types.js";
-import type { ArenaLedger } from "../ledger.js";
-interface AdjudicationOptions {
-    concluder: ArenaParticipant;
-    strategy: ArenaStrategy;
-    topic: string;
-    ledger: ArenaLedger;
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Run adjudication phase. The moderator rules on contested claims.
- * Verified claims get synthetic adjudications.
- */
-export declare function runAdjudication(options: AdjudicationOptions): Promise<ClaimAdjudication[]>;
-export {};

package/dist/arena/phases/build-consensus.d.ts

@@ -1,29 +0,0 @@
-/**
- * ConsensusBuilder — aggregates findings + peer reviews into structured consensus.
- *
- * V1: Program aggregates finding + review data, moderator LLM organizes.
- * V2: When claim data is available, uses claim-aware prompts that distinguish
- *     verified/unresolved/rejected claims.
- *
- * In both paths, the moderator must faithfully reflect aggregated results
- * (no new unsourced conclusions).
- */
-import type { ArenaParticipant, ArenaStrategy, ParticipantReport, FindingReview, ArenaConsensus, ClaimStatusSummary, ArenaProgressEvent } from "../types.js";
-interface ConsensusOptions {
-    /** The participant that acts as moderator/concluder */
-    concluder: ArenaParticipant;
-    strategy: ArenaStrategy;
-    topic: string;
-    reports: ParticipantReport[];
-    reviews: FindingReview[];
-    /** Claim status summary — when provided, enables claim-aware consensus (V2) */
-    claimSummary?: ClaimStatusSummary;
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Build structured consensus from participant reports, cross-reviews,
- * and optionally adjudicated claim data.
- */
-export declare function buildConsensus(options: ConsensusOptions): Promise<ArenaConsensus>;
-export {};

package/dist/arena/phases/claim-registry.d.ts

@@ -1,26 +0,0 @@
-/**
- * ClaimRegistry — converts ResearchDossier findings into ClaimRecords.
- *
- * Each finding is elevated to a claim with:
- * - Stable global ID (owner + finding.id)
- * - Evidence packet references from findingEvidenceLinks
- * - Initial status: "proposed"
- */
-import type { ResearchDossier, ClaimRecord, ArenaProgressEvent } from "../types.js";
-import type { ArenaLedger } from "../ledger.js";
-interface ClaimRegistryOptions {
-    dossiers: ResearchDossier[];
-    ledger: ArenaLedger;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Register all findings from research dossiers as claims.
- * Returns the newly created ClaimRecord array.
- */
-export declare function registerClaims(options: ClaimRegistryOptions): ClaimRecord[];
-/**
- * Select claims for review, prioritized by severity and confidence.
- * Respects the maxClaimsForReview limit.
- */
-export declare function selectClaimsForReview(claims: ClaimRecord[], maxClaims: number): ClaimRecord[];
-export {};

package/dist/arena/phases/cross-review.d.ts

@@ -1,45 +0,0 @@
-/**
- * CrossReview / VerificationReview — participants review each other's findings.
- *
- * V1 (CrossReview): Each participant sees the other participants' structured findings
- * and provides per-finding verdicts: agree, refine, disagree, needs_evidence.
- *
- * V2 (VerificationReview): Reviewers get claim + evidence packet + digest data,
- * and produce ClaimChallenge records that feed into the claim state machine.
- */
-import type { ArenaParticipant, ArenaStrategy, ParticipantReport, FindingReview, ClaimChallenge, ArenaProgressEvent, ArenaExecutionLimits } from "../types.js";
-import type { ArenaLedger } from "../ledger.js";
-interface CrossReviewOptions {
-    participants: ArenaParticipant[];
-    strategy: ArenaStrategy;
-    topic: string;
-    reports: ParticipantReport[];
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Run cross-review phase (V1). Each participant reviews the others' findings.
- */
-export declare function runCrossReview(options: CrossReviewOptions): Promise<FindingReview[]>;
-interface VerificationReviewOptions {
-    participants: ArenaParticipant[];
-    strategy: ArenaStrategy;
-    topic: string;
-    reports: ParticipantReport[];
-    ledger: ArenaLedger;
-    limits: ArenaExecutionLimits;
-    /** Arena mode — planning routes to merge-oriented review */
-    mode?: "review" | "discussion" | "planning";
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-interface VerificationReviewResult {
-    reviews: FindingReview[];
-    challenges: ClaimChallenge[];
-}
-/**
- * Run verification-review phase. Reviewers get claim + evidence + digest data.
- * Falls back to V1 cross-review if strategy doesn't implement V2.
- */
-export declare function runVerificationReview(options: VerificationReviewOptions): Promise<VerificationReviewResult>;
-export {};

package/dist/arena/phases/debate-rounds.d.ts

@@ -1,27 +0,0 @@
-/**
- * DebateRounds — contested claims enter structured debate between
- * the claim owner and the primary challenger.
- *
- * Each debate round:
- *   1. Both debaters produce a DebateTurn (stance + argument)
- *   2. Convergence check: all stances are "support" or "narrow" → resolved
- *   3. If max rounds exhausted → stays contested for adjudication
- */
-import type { ArenaParticipant, ArenaStrategy, DebateRound, ArenaExecutionLimits, ArenaProgressEvent } from "../types.js";
-import type { ArenaLedger } from "../ledger.js";
-interface DebateOptions {
-    participants: ArenaParticipant[];
-    strategy: ArenaStrategy;
-    topic: string;
-    ledger: ArenaLedger;
-    limits: ArenaExecutionLimits;
-    maxRounds: number;
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Run debate rounds for all contested claims.
- * Returns empty array if no contested claims exist.
- */
-export declare function runDebateRounds(options: DebateOptions): Promise<DebateRound[]>;
-export {};

package/dist/arena/phases/participant-research.d.ts

@@ -1,38 +0,0 @@
-/**
- * ParticipantResearch — each participant independently investigates
- * the shared base context and produces structured findings.
- *
- * Phase 3 upgrade: now captures ToolTrace and builds EvidencePackets,
- * outputting a full ResearchDossier alongside the ParticipantReport.
- */
-import type { ArenaBaseContext, ArenaParticipant, ArenaStrategy, ParticipantReport, ResearchDossier, ArenaProgressEvent } from "../types.js";
-import type { ToolDefinition } from "../../types.js";
-/** Result of a single participant's research — includes both report and dossier */
-export interface ResearchResult {
-    report: ParticipantReport;
-    dossier: ResearchDossier;
-}
-interface ResearchOptions {
-    participants: ArenaParticipant[];
-    strategy: ArenaStrategy;
-    topic: string;
-    baseContext: ArenaBaseContext;
-    enableContextTools?: boolean;
-    /** Plan-selected tools override. When provided, these are used instead of all CONTEXT_TOOLS. */
-    contextTools?: ToolDefinition[];
-    /** AbortSignal — cancels in-flight LLM calls */
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Run participant research phase in parallel.
- * Each participant reads the shared context, optionally requests more,
- * then produces structured findings with evidence trails.
- */
-export declare function runParticipantResearch(options: ResearchOptions): Promise<ParticipantReport[]>;
-/**
- * Run participant research phase with full dossier output.
- * Returns both reports (backward compat) and dossiers (evidence trail).
- */
-export declare function runParticipantResearchWithDossiers(options: ResearchOptions): Promise<ResearchResult[]>;
-export {};

package/dist/arena/phases/planning-detail-expansion.d.ts

@@ -1,38 +0,0 @@
-/**
- * PlanningDetailExpansion — expands high-level roadmap phases into
- * repo-level implementation plans.
- *
- * This phase is planning-mode specific. It takes the roadmap produced
- * by consensus and, for each phase, calls the LLM to produce concrete
- * implementation details: target files, code changes, interfaces,
- * migration steps, validation, effort, and blockers.
- *
- * Tool access is available so the LLM can verify file paths and interfaces.
- */
-import type { ArenaParticipant, ArenaRoadmapPhase, ArenaRoadmapPhaseDetail, ArenaProgressEvent, ArenaExecutionLimits, ArenaStrategyPlanning } from "../types.js";
-import type { ToolDefinition } from "../../types.js";
-import type { ArenaLedger } from "../ledger.js";
-interface DetailExpansionOptions {
-    /** The participant that performs the expansion (typically the concluder) */
-    concluder: ArenaParticipant;
-    strategy: ArenaStrategyPlanning;
-    topic: string;
-    /** Roadmap phases to expand */
-    phases: ArenaRoadmapPhase[];
-    ledger: ArenaLedger;
-    limits: ArenaExecutionLimits;
-    /** Enable read-only context tools for file path verification */
-    enableContextTools?: boolean;
-    /** Plan-selected tools override */
-    contextTools?: ToolDefinition[];
-    signal?: AbortSignal;
-    onProgress?: (event: ArenaProgressEvent) => void;
-}
-/**
- * Expand each roadmap phase into a repo-level implementation plan.
- *
- * Phases are expanded sequentially to avoid token explosion.
- * The number of phases expanded is capped by limits.maxExpandedPhasesPerRun.
- */
-export declare function runDetailExpansion(options: DetailExpansionOptions): Promise<ArenaRoadmapPhaseDetail[]>;
-export {};

package/dist/arena/planner.d.ts

@@ -1,27 +0,0 @@
-/**
- * Planner — the brain of Evidence-Driven Arena.
- *
- * Takes a natural language user request and produces a complete ArenaPlan:
- * - mode (how to collaborate)
- * - lenses (from what perspectives)
- * - sources (where to gather evidence)
- * - subject (what is being analyzed)
- * - outputShape (how to structure the result)
- *
- * Replaces the old IntentResolver + ScopeResolver pipeline with a single
- * LLM call that outputs a holistic execution plan.
- */
-import type { LLMConfig } from "../types.js";
-import type { ArenaPlan, ArenaMode } from "./types.js";
-/** Explicit flags the user may pass via CLI or tool args */
-export interface PlannerFlags {
-    mode?: ArenaMode;
-    base?: string;
-    head?: string;
-}
-/**
- * Run the planner to produce an ArenaPlan from natural language.
- *
- * Priority: explicit flags > LLM plan > safe defaults.
- */
-export declare function planArena(topic: string, llmConfig: LLMConfig, flags?: PlannerFlags, signal?: AbortSignal): Promise<ArenaPlan>;

package/dist/arena/providers/docs.d.ts

@@ -1,6 +0,0 @@
-/**
- * DocsProvider — collects evidence from documentation files:
- * markdown, text, PRDs, design docs.
- */
-import type { ArenaContextProvider } from "../types.js";
-export declare const docsProvider: ArenaContextProvider;

package/dist/arena/providers/git.d.ts

@@ -1,8 +0,0 @@
-/**
- * GitProvider — collects evidence from git: diffs, commit logs, changed files.
- *
- * Security: All git commands use execFileSync with argument arrays
- * to prevent shell injection. Git refs are sanitized before use.
- */
-import type { ArenaContextProvider } from "../types.js";
-export declare const gitProvider: ArenaContextProvider;