@cjhyy/code-shell 0.1.0-alpha.0

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

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

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Extra slash commands — /dream, /login, /logout, /mcp, /context, /stats,
+ * /summary, /skills, /agents, /theme, /output-style
+ */
+import type { SlashCommand } from "../registry.js";
+export declare const extraCommands: SlashCommand[];

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

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

@@ -0,0 +1,7 @@
+/**
+ * Additional slash commands to match restored-src parity:
+ * /fast, /rewind, /usage, /files, /release-notes, /security-review,
+ * /env, /brief, /feedback, /tag
+ */
+import type { SlashCommand } from "../registry.js";
+export declare const moreCommands: SlashCommand[];

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

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * 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;
+    setIsRunning: (running: boolean) => void;
+    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;
+}
+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 } sorted by name. */
+    listCommands(): Array<{
+        name: string;
+        description: string;
+    }>;
+}

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

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

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

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

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

package/dist/cli/exit.d.ts

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

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

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