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

package/dist/cli/commands/arena.d.ts

@@ -1,29 +0,0 @@
-/**
- * Arena CLI — multi-model collaborative analysis.
- *
- * V2 pipeline: Intent → Scope → Facts → Research → CrossReview → Consensus.
- *
- * Usage:
- *   code-shell arena "review the authentication module"
- *   /arena review my latest changes
- *   /arena --models claude,gpt4o is the error handling correct?
- *   /arena --mode planning how should we redesign the arena
- */
-import type { OutputSink } from "../../arena/render/terminal.js";
-import type { ArenaResultV2 } from "../../arena/types.js";
-import type { EngineConfig } from "../../engine/engine.js";
-export { formatArenaResultForSession } from "../../arena/render/session.js";
-/** Options for controlling arena output destination. */
-export interface ArenaRunOptions {
-    /** Output sink for progress/status messages (dim text in REPL). */
-    output?: OutputSink;
-    /** Output sink for final result (full markdown rendering in REPL). */
-    outputMessage?: OutputSink;
-}
-/**
- * Run arena from CLI `code-shell arena "topic"` or REPL `/arena topic`.
- *
- * When `opts.output` is provided, all output goes through that sink
- * (for REPL integration via ctx.addStatus). Otherwise prints to stdout.
- */
-export declare function runArenaReview(arg: string, engineConfig: EngineConfig, opts?: ArenaRunOptions): Promise<ArenaResultV2 | undefined>;

package/dist/cli/commands/builtin/advanced-commands.d.ts

@@ -1,5 +0,0 @@
-/**
- * Advanced / reserved slash commands
- */
-import type { SlashCommand } from "../registry.js";
-export declare const advancedCommands: SlashCommand[];

package/dist/cli/commands/builtin/core-commands.d.ts

@@ -1,5 +0,0 @@
-/**
- * Core slash commands — migrated from App.tsx switch-case + new essentials.
- */
-import type { SlashCommand } from "../registry.js";
-export declare const coreCommands: SlashCommand[];

package/dist/cli/commands/builtin/export-md.d.ts

@@ -1,19 +0,0 @@
-/**
- * Markdown renderer for `/export markdown`.
- *
- * Goals (versus the legacy one-JSON-line-per-turn dump):
- *   • Every turn is numbered and role-tagged
- *   • Reasoning blocks are collapsible (<details>) — present but not noisy
- *   • tool_use shows tool name + truncated args inline
- *   • tool_result over a threshold spills to a sidecar file alongside the md
- *   • Long lines never exceed ~2 KB inline so editors stay responsive
- */
-export interface Sidecar {
-    path: string;
-    content: string;
-}
-export interface RenderedSession {
-    md: string;
-    sidecars: Sidecar[];
-}
-export declare function renderSessionMarkdown(sessionId: string, events: unknown[], cwd: string): RenderedSession;

package/dist/cli/commands/builtin/extra-commands.d.ts

@@ -1,6 +0,0 @@
-/**
- * Extra slash commands — /login, /logout, /mcp (config & auth);
- * /skills, /log (read-only inspection); /models (interactive panel).
- */
-import type { SlashCommand } from "../registry.js";
-export declare const extraCommands: SlashCommand[];

package/dist/cli/commands/builtin/git-commands.d.ts

@@ -1,5 +0,0 @@
-/**
- * Git workflow slash commands — /commit, /diff, /branch, /review, /pr-comments
- */
-import type { SlashCommand } from "../registry.js";
-export declare const gitCommands: SlashCommand[];

package/dist/cli/commands/builtin/init/detect.d.ts

@@ -1,25 +0,0 @@
-/**
- * Detection — what does the cwd already contain?
- *
- * Drives the four-way intent decision in pickIntent. Synchronous and bounded
- * (≤ a handful of stat calls + one capped directory walk) so /init can pick a
- * mode without spawning an LLM turn just for classification.
- */
-export interface Detection {
-    hasCodeshell: boolean;
-    hasClaude: boolean;
-    hasAgents: boolean;
-    hasCursorRules: boolean;
-    hasCursorRulesDir: boolean;
-    hasWindsurfRules: boolean;
-    hasClinerules: boolean;
-    hasCopilotInstructions: boolean;
-    hasCodeshellRulesDir: boolean;
-    hasManifest: boolean;
-    hasSourceFiles: boolean;
-    hasReadme: boolean;
-}
-export type Intent = "improve" | "migrate" | "create" | "empty";
-export declare function detect(cwd: string): Detection;
-export declare function pickIntent(d: Detection): Intent;
-export declare function summarize(d: Detection): string;

package/dist/cli/commands/builtin/init/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * `/init` — bootstrap CODESHELL.md for the current repo.
- *
- * Scope: documentation only. This command never writes to settings.json or
- * settings.local.json — those belong to Code Shell's own onboarding/permission
- * flows and must stay decoupled from arbitrary target repos.
- *
- * Four intents, picked from cwd state:
- *   improve  — CODESHELL.md already exists; LLM edits in place with diffs.
- *   migrate  — other AI configs (CLAUDE.md, .cursorrules, ...) exist; LLM
- *              treats them as investigation sources and synthesizes.
- *   create   — code present (manifest/source/README) but no AI config; LLM
- *              surveys the repo and writes from scratch.
- *   empty    — truly empty repo; LLM asks the user a few questions via the
- *              AskUserQuestion tool, then writes (with TODO placeholders as
- *              needed). Hard limit: ≤4 AskUserQuestion calls per prompt.
- */
-import type { SlashCommand } from "../../registry.js";
-export declare const initCommand: SlashCommand;

package/dist/cli/commands/builtin/more-commands.d.ts

@@ -1,5 +0,0 @@
-/**
- * Additional slash commands — /files, /release-notes, /security-review, /feedback
- */
-import type { SlashCommand } from "../registry.js";
-export declare const moreCommands: SlashCommand[];

package/dist/cli/commands/builtin/permissions-command.d.ts

@@ -1,5 +0,0 @@
-/**
- * /permissions command — show and toggle permission mode.
- */
-import type { SlashCommand } from "../registry.js";
-export declare const permissionsCommand: SlashCommand;

package/dist/cli/commands/builtin/plugin-commands-registration.d.ts

@@ -1,12 +0,0 @@
-/**
- * Convert PluginCommand[] (from pluginCommandsLoader) to SlashCommand[]
- * registrable on the CommandRegistry. Each command's execute() reads
- * the body, substitutes $ARGUMENTS / {args}, and stages the result via
- * ctx.setNextContext so the user can submit by pressing Enter.
- */
-import type { SlashCommand } from "../registry.js";
-/**
- * Returns the full list of SlashCommands derived from currently-installed
- * plugins. Caller registers them on the CommandRegistry.
- */
-export declare function buildPluginSlashCommands(): SlashCommand[];

package/dist/cli/commands/builtin/plugin-handler.d.ts

@@ -1,6 +0,0 @@
-/**
- * `/plugin` slash command dispatcher. Parses subcommand args and calls
- * into the plugin marketplace modules. Returns a multi-line status
- * string the slash command can pass to ctx.addStatus.
- */
-export declare function runPluginCommand(rawArg: string): Promise<string>;

package/dist/cli/commands/builtin/utility-commands.d.ts

@@ -1,5 +0,0 @@
-/**
- * Utility slash commands — /copy, /undo, /theme, /hooks, /update
- */
-import type { SlashCommand } from "../registry.js";
-export declare const utilityCommands: SlashCommand[];

package/dist/cli/commands/registry.d.ts

@@ -1,79 +0,0 @@
-/**
- * Slash command registry — replaces the monolithic switch-case in App.tsx.
- *
- * Commands are registered with a name, aliases, and an execute function.
- * The registry handles parsing, dispatch, and help generation.
- */
-import type { AgentClient } from "../../protocol/client.js";
-import type { TaskInfo } from "../../types.js";
-/** A reconstructed chat entry for loading into the UI. */
-export interface RestoredChatEntry {
-    type: "user" | "assistant_text" | "tool_start" | "tool_result" | "status";
-    text?: string;
-    toolName?: string;
-    args?: Record<string, unknown>;
-    result?: string;
-    error?: string;
-}
-/** Context passed to every slash command handler. */
-export interface CommandContext {
-    client: AgentClient;
-    cwd: string;
-    model: string;
-    setModel: (model: string) => void;
-    sessionId: string | undefined;
-    setSessionId: (id: string) => void;
-    queryGuard: import("../../ui/query-guard.js").QueryGuard;
-    addStatus: (msg: string) => void;
-    /** Add a message that renders with full markdown formatting (like assistant output). */
-    addMessage: (text: string) => void;
-    /** Set context that will be prepended to the next user message sent to the engine. */
-    setNextContext: (text: string) => void;
-    exit: () => void;
-    effort: string;
-    setEffort: (e: string) => void;
-    tasks: TaskInfo[];
-    clearChat: () => void;
-    chatLog: unknown[];
-    /** Load restored chat entries into the UI (used by /resume). */
-    loadChatEntries?: (entries: RestoredChatEntry[]) => void;
-    /** Open the Ink onboarding wizard (used by /login). */
-    startOnboarding?: () => void;
-    /** Open the Ink model selector (used by /model with no args). */
-    openModelSelector?: () => void;
-    /** Open the Ink session picker (used by /resume with no args). */
-    openSessionPicker?: () => void;
-    /** Open the Ink model management panel (used by /models). */
-    openModelManager?: () => void;
-    /** Current fullscreen mode (used by /fullscreen status check). */
-    fullscreen?: boolean;
-    /** Set fullscreen mode explicitly (used by /fullscreen on|off). */
-    setFullscreen?: (next: boolean) => void;
-    /** Toggle fullscreen mode (used by bare /fullscreen). */
-    toggleFullscreen?: () => void;
-}
-export type CommandGroup = "core" | "git" | "context" | "config" | "advanced";
-export interface SlashCommand {
-    name: string;
-    aliases?: string[];
-    description: string;
-    usage?: string;
-    group?: CommandGroup;
-    execute: (arg: string, ctx: CommandContext) => void | Promise<void>;
-}
-export declare class CommandRegistry {
-    private commands;
-    register(cmd: SlashCommand): void;
-    registerAll(cmds: SlashCommand[]): void;
-    get(name: string): SlashCommand | undefined;
-    dispatch(input: string, ctx: CommandContext): void | Promise<void>;
-    /** Generate grouped help text from all registered commands. */
-    helpText(): string;
-    listNames(): string[];
-    /** Return deduplicated list of { name, description, usage } sorted by name. */
-    listCommands(): Array<{
-        name: string;
-        description: string;
-        usage?: string;
-    }>;
-}

package/dist/cli/commands/repl.d.ts

@@ -1,21 +0,0 @@
-/**
- * Interactive REPL mode — uses Ink (React for CLI) for the terminal UI.
- *
- * Wiring: Engine → AgentServer → [in-process transport] → AgentClient → UI
- */
-import type { AgentPresetName } from "../../preset/index.js";
-export type EffortLevel = "low" | "medium" | "high" | "max";
-export interface ReplOptions {
-    model?: string;
-    provider?: string;
-    preset?: AgentPresetName;
-    baseUrl?: string;
-    apiKey?: string;
-    permissionMode?: string;
-    maxTurns?: number;
-    output?: string;
-    resume?: string;
-    effort?: EffortLevel;
-    prefill?: string;
-}
-export declare function replCommand(options: ReplOptions): Promise<void>;

package/dist/cli/commands/run.d.ts

@@ -1,21 +0,0 @@
-/**
- * `run` command — headless single-prompt execution.
- *
- * Uses the same Engine → AgentServer → AgentClient pipeline,
- * but with a headless renderer instead of Ink UI.
- */
-import { type OutputFormat } from "../output/renderer.js";
-import type { AgentPresetName } from "../../preset/index.js";
-export interface RunOptions {
-    task: string;
-    model?: string;
-    provider?: string;
-    preset?: AgentPresetName;
-    baseUrl?: string;
-    output?: OutputFormat;
-    permissionMode?: string;
-    resume?: string;
-    apiKey?: string;
-    maxTurns?: number;
-}
-export declare function runCommand(options: RunOptions): Promise<void>;

package/dist/cli/commands/runs.d.ts

@@ -1,14 +0,0 @@
-/**
- * `runs` command group — manage long-running agent tasks.
- *
- * Subcommands:
- *   code-shell runs list     — List recent runs
- *   code-shell runs get      — Inspect a run
- *   code-shell runs submit   — Submit a new managed run
- *   code-shell runs resume   — Resume a waiting/blocked run
- *   code-shell runs cancel   — Cancel a run
- *   code-shell runs events   — View run event log
- *   code-shell runs recover  — Recover crashed runs
- */
-import { Command } from "commander";
-export declare function createRunsCommand(): Command;

package/dist/cli/cost-tracker.d.ts

@@ -1,63 +0,0 @@
-/**
- * Cost tracker — tracks token usage and calculates estimated costs.
- */
-export interface UsageRecord {
-    model: string;
-    promptTokens: number;
-    completionTokens: number;
-    cacheReadTokens: number;
-    cacheWriteTokens: number;
-    totalTokens: number;
-    timestamp: number;
-    isSubAgent?: boolean;
-}
-export declare class CostTracker {
-    private records;
-    private sessionStart;
-    private _hasUnknownModel;
-    record(model: string, promptTokens: number, completionTokens: number, isSubAgent?: boolean, cacheReadTokens?: number, cacheWriteTokens?: number): void;
-    getTotalTokens(): {
-        prompt: number;
-        completion: number;
-        total: number;
-    };
-    getEstimatedCost(): number;
-    getRequestCount(): number;
-    getSessionDuration(): number;
-    /** Estimate cost for a specific set of tokens without recording them. */
-    estimateForTokens(model: string, promptTokens: number, completionTokens: number, cacheReadTokens?: number, cacheWriteTokens?: number): number;
-    /**
-     * Get total cache token counts.
-     */
-    getCacheTokens(): {
-        cacheRead: number;
-        cacheWrite: number;
-    };
-    /**
-     * Format a styled cost summary for terminal display.
-     */
-    formatSummary(): string;
-    /**
-     * Format a compact one-line cost display for the prompt footer.
-     */
-    formatCompact(): string;
-    reset(): void;
-    /** Serialize cost state for session persistence. */
-    serialize(): SessionCostState;
-    /** Restore cost state from a previous session. */
-    restore(state: SessionCostState): void;
-}
-export interface SessionCostState {
-    records: UsageRecord[];
-    sessionStart: number;
-    totalPromptTokens: number;
-    totalCompletionTokens: number;
-    estimatedCost: number;
-}
-export declare const costTracker: CostTracker;
-/**
- * Wire the LLM base-class usage hook into the singleton cost tracker.
- * Called once from main.ts so every LLM call (REPL, run, arena, sub-agents)
- * records into a single tracker without each call site having to remember.
- */
-export declare function installCostTracking(): Promise<void>;

package/dist/cli/exit.d.ts

@@ -1,12 +0,0 @@
-/**
- * CLI exit helpers for subcommand handlers.
- *
- * Consolidates the 4-5 line "print + lint-suppress + exit" block that was
- * copy-pasted ~60 times across `claude mcp *` / `claude plugin *` handlers.
- * The `: never` return type lets TypeScript narrow control flow at call sites
- * without a trailing `return`.
- */
-/** Write an error message to stderr (if given) and exit with code 1. */
-export declare function cliError(msg?: string): never;
-/** Write a message to stdout (if given) and exit with code 0. */
-export declare function cliOk(msg?: string): never;

package/dist/cli/input/ndjson-reader.d.ts

@@ -1,31 +0,0 @@
-/**
- * NDJSON input reader — parses structured input from stdin for SDK mode.
- *
- * Protocol:
- *   {"type": "message", "content": "user text"}
- *   {"type": "approval", "toolCallId": "xxx", "approved": true}
- *   {"type": "abort"}
- */
-import type { Readable } from "node:stream";
-export type NdjsonMessage = {
-    type: "message";
-    content: string;
-} | {
-    type: "approval";
-    toolCallId: string;
-    approved: boolean;
-    reason?: string;
-} | {
-    type: "abort";
-} | {
-    type: "ping";
-};
-export declare class NdjsonReader {
-    private readonly input;
-    private handlers;
-    constructor(input?: Readable);
-    on(type: NdjsonMessage["type"], handler: (msg: NdjsonMessage) => void): void;
-    start(): void;
-    /** Async iterator for messages. */
-    messages(): AsyncGenerator<NdjsonMessage>;
-}

package/dist/cli/input-compiler.d.ts

@@ -1,5 +0,0 @@
-/**
- * Input compiler — transforms raw user input into structured messages.
- */
-import type { CompiledInput } from "../types.js";
-export declare function compileInput(rawText: string): CompiledInput;

package/dist/cli/main.d.ts

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-/**
- * code-shell — general orchestration framework with a terminal coding preset
- */
-export {};