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

package/dist/types.d.ts

@@ -1,321 +0,0 @@
-/**
- * Core type definitions for the code-shell orchestration framework.
- */
-export interface ContentBlock {
-    type: "text" | "tool_use" | "tool_result" | "image" | "reasoning";
-    text?: string;
-    id?: string;
-    name?: string;
-    input?: Record<string, unknown>;
-    content?: string | ContentBlock[];
-    tool_use_id?: string;
-    source?: {
-        type: "base64";
-        media_type: string;
-        data: string;
-    };
-    reasoningContent?: string;
-}
-export interface Message {
-    role: "system" | "user" | "assistant" | "tool";
-    content: string | ContentBlock[];
-    name?: string;
-    tool_call_id?: string;
-}
-export interface ToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-}
-export interface ToolCall {
-    id: string;
-    toolName: string;
-    serverName?: string;
-    args: Record<string, unknown>;
-}
-export interface ToolResult {
-    id: string;
-    toolName: string;
-    result?: string;
-    error?: string;
-    isError?: boolean;
-}
-export type ToolSource = "builtin" | "mcp";
-export interface RegisteredTool {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-    source: ToolSource;
-    serverName?: string;
-    permissionDefault: PermissionDecision;
-    isConcurrencySafe?: boolean;
-    isReadOnly?: boolean;
-    /**
-     * Override the default tool execution timeout (ms).
-     * Falls back to DEFAULT_TOOL_TIMEOUT_MS (120s) if unset.
-     * The caller of executeTool() can still override via options.timeoutMs.
-     */
-    timeoutMs?: number;
-}
-export type TranscriptEventType = "message" | "tool_use" | "tool_result" | "summary" | "content_replace" | "file_history" | "plan_operation" | "session_meta" | "turn_boundary" | "error";
-export interface TranscriptEvent {
-    id: string;
-    type: TranscriptEventType;
-    timestamp: number;
-    turnNumber: number;
-    data: Record<string, unknown>;
-}
-/**
- * Session lifecycle state persisted in state.json. `"active"` means a run is
- * currently in flight (or was, at the moment of the last heartbeat). All other
- * values match the {@link TerminalReason} the last run returned, so callers
- * can distinguish a user-cancelled session (`"aborted_streaming"`) from an
- * actual error (`"model_error"`, `"prompt_too_long"`, ...).
- */
-export type SessionStatus = "active" | "paused" | TerminalReason;
-export interface SessionState {
-    sessionId: string;
-    cwd: string;
-    startedAt: number;
-    model: string;
-    provider: string;
-    tokenUsage: TokenUsage;
-    turnCount: number;
-    invokedSkills: string[];
-    parentSessionId?: string;
-    status: SessionStatus;
-    /** Short summary derived from the first user message */
-    summary?: string;
-    /** Persisted cost tracking state (survives process restart). */
-    costState?: Record<string, unknown>;
-}
-export interface TokenUsage {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    cacheReadTokens?: number;
-    cacheCreationTokens?: number;
-}
-export interface CompiledInput {
-    messages: Message[];
-    rawText: string;
-    options: InputOptions;
-}
-export interface InputOptions {
-    slashCommand?: string;
-    attachments?: Attachment[];
-    mentionedFiles?: string[];
-    images?: ImageAttachment[];
-    allowedTools?: string[];
-    modelOverride?: string;
-}
-export interface Attachment {
-    path: string;
-    content: string;
-    mimeType: string;
-}
-export interface ImageAttachment {
-    data: string;
-    mediaType: string;
-}
-export type PermissionDecision = "allow" | "deny" | "ask";
-export type PermissionMode = "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
-export interface PermissionRule {
-    tool: string;
-    argsPattern?: Record<string, string | RegExp>;
-    decision: PermissionDecision;
-    reason?: string;
-}
-export interface ApprovalRequest {
-    toolName: string;
-    args: Record<string, unknown>;
-    description: string;
-    riskLevel: "low" | "medium" | "high";
-}
-/**
- * Scope of an "always allow" decision.
- *   "once"    — this single call only (default when always not set)
- *   "session" — remembered for the rest of the REPL session (in-memory)
- *   "project" — persisted to <cwd>/.code-shell/settings.local.json so it
- *               survives restart for the current project. Not committed.
- */
-export type ApprovalScope = "once" | "session" | "project";
-export type ApprovalResult = {
-    approved: true;
-    permanent?: boolean;
-    always?: boolean;
-    scope?: ApprovalScope;
-    /** Used by AskUserQuestion to carry the user's free-text answer. */ answer?: string;
-} | {
-    approved: false;
-    reason?: string;
-    always?: boolean;
-    scope?: ApprovalScope;
-};
-export type TurnPhase = "pre_check" | "model_call" | "post_check" | "tool_exec" | "context_mgmt" | "hook_notify" | "complete" | "error";
-export interface TurnResult {
-    text: string;
-    toolCalls: ToolCall[];
-    status: "completed" | "tool_use" | "error" | "max_turns" | "aborted";
-    error?: string;
-}
-export type TerminalReason = "completed" | "stop_hook_prevented" | "hook_stopped" | "prompt_too_long" | "model_error" | "aborted_streaming" | "aborted_tools" | "max_turns" | "image_error";
-export interface TaskInfo {
-    id: string;
-    subject: string;
-    activeForm?: string;
-    status: "pending" | "in_progress" | "completed" | "stopped";
-}
-export type StreamEvent = {
-    type: "session_started";
-    sessionId: string;
-    promptTokens: number;
-} | {
-    type: "stream_request_start";
-    turnNumber: number;
-    agentId?: string;
-} | {
-    type: "text_delta";
-    text: string;
-    tokens?: number;
-    agentId?: string;
-} | {
-    type: "tool_use_start";
-    toolCall: ToolCall;
-    agentId?: string;
-} | {
-    type: "tool_use_args_delta";
-    toolCallId: string;
-    args: Record<string, unknown>;
-    agentId?: string;
-} | {
-    type: "tool_result";
-    result: ToolResult;
-    agentId?: string;
-} | {
-    type: "assistant_message";
-    message: Message;
-    agentId?: string;
-} | {
-    type: "turn_complete";
-    reason: TerminalReason;
-    agentId?: string;
-} | {
-    type: "error";
-    error: string;
-    agentId?: string;
-} | {
-    type: "tombstone";
-    messageId: string;
-} | {
-    type: "task_update";
-    tasks: TaskInfo[];
-} | {
-    type: "thinking_delta";
-    text: string;
-    agentId?: string;
-} | {
-    type: "agent_start";
-    agentId: string;
-    description: string;
-} | {
-    type: "agent_end";
-    agentId: string;
-    description: string;
-    error?: string;
-} | {
-    type: "tool_summary";
-    summary: string;
-} | {
-    type: "context_compact";
-    strategy: "micro" | "summary" | "window" | "snip" | "emergency";
-    before: number;
-    after: number;
-    agentId?: string;
-} | {
-    type: "usage_update";
-    promptTokens: number;
-    agentId?: string;
-};
-export type StreamCallback = (event: StreamEvent) => void | Promise<void>;
-export interface LLMConfig {
-    provider: string;
-    model: string;
-    apiKey?: string;
-    baseUrl?: string;
-    temperature?: number;
-    topP?: number;
-    maxTokens?: number;
-    timeout?: number;
-    retryMaxAttempts?: number;
-    enableStreaming?: boolean;
-    /**
-     * Default thinking-mode for DeepSeek V4. Per-call `options.thinking`
-     * (e.g. summarize sub-calls) overrides this. Ignored on other providers.
-     */
-    thinking?: "enabled" | "disabled";
-    /**
-     * The provider's `kind` (deepseek/openai/zai/openrouter/...). Used by
-     * the capability layer to look up per-(kind, model) request-shape rules
-     * (token-limit field, rejected sampling params, thinking shape, etc.).
-     * Distinct from `provider` above, which is the protocol family
-     * ("openai" or "anthropic") that picks which client class to use.
-     */
-    providerKind?: string;
-}
-export interface LLMResponse {
-    text: string;
-    toolCalls: ToolCall[];
-    usage?: TokenUsage;
-    stopReason?: string;
-    reasoningContent?: string;
-}
-export interface LLMStreamChunk {
-    type: "text" | "tool_use_start" | "tool_use_delta" | "tool_use_end" | "stop";
-    text?: string;
-    /** Token count for this text delta, when provider can compute it. */
-    tokens?: number;
-    toolCall?: Partial<ToolCall>;
-    stopReason?: string;
-}
-export type MCPTransport = "stdio" | "sse" | "streamable-http" | "inprocess";
-export interface MCPServerConfig {
-    name: string;
-    command?: string;
-    args?: string[];
-    env?: Record<string, string>;
-    url?: string;
-    transport?: MCPTransport;
-    headers?: Record<string, string>;
-}
-export interface Settings {
-    model: {
-        provider: string;
-        name: string;
-        apiKey?: string;
-        baseUrl?: string;
-        temperature?: number;
-        maxTokens?: number;
-    };
-    permissions: {
-        defaultMode: PermissionMode;
-        rules: PermissionRule[];
-    };
-    context: {
-        maxTokens: number;
-        compactAtRatio: number;
-        summarizeAtRatio: number;
-    };
-    session: {
-        storageDir: string;
-        maxHistory: number;
-    };
-    mcpServers: Record<string, MCPServerConfig>;
-    instructions: {
-        fileName: string;
-        scanDirs: string[];
-    };
-    output: {
-        format: "text" | "json" | "jsonl" | "stream-json";
-    };
-}

package/dist/ui/App.d.ts

@@ -1,14 +0,0 @@
-import { AgentClient } from "../protocol/client.js";
-interface AppProps {
-    client: AgentClient;
-    model: string;
-    effort: string;
-    maxTurns: number;
-    cwd: string;
-    maxContextTokens: number;
-    sessionId?: string;
-    /** Pre-fill the input box without submitting (--prefill flag). */
-    prefill?: string;
-}
-export declare function App({ client, model: initialModel, effort, maxTurns, cwd, maxContextTokens, sessionId: initialSessionId, prefill, }: AppProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/AgentBlock.d.ts

@@ -1,32 +0,0 @@
-/**
- * Agent block — renders sub-agent activity with CC-style tree-line nesting.
- *
- * Running:
- *   ├─ Agent description · Nk tokens
- *   │  ⎿  Running tool…
- *
- * Completed:
- *   └─ Agent description · Done
- *      ⎿  completed
- */
-import React from "react";
-interface AgentBlockStartProps {
-    description: string;
-    running?: boolean;
-    isLast?: boolean;
-}
-export declare function AgentBlockStart({ description, running, isLast }: AgentBlockStartProps): import("react/jsx-runtime").JSX.Element;
-interface AgentBlockEndProps {
-    description: string;
-    error?: string;
-    isLast?: boolean;
-}
-export declare function AgentBlockEnd({ description, error, isLast }: AgentBlockEndProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Tree line prefix for nested content under an agent.
- */
-export declare function NestedPrefix({ children, isLast, }: {
-    children: React.ReactNode;
-    isLast?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/AskUserPrompt.d.ts

@@ -1,14 +0,0 @@
-interface Choice {
-    label: string;
-    description: string;
-}
-interface AskUserPromptProps {
-    question: string;
-    header?: string;
-    options?: Choice[];
-    multiSelect?: boolean;
-    onAnswer: (answer: string) => void;
-    onCancel: () => void;
-}
-export declare function AskUserPrompt({ question, header, options, multiSelect, onAnswer, onCancel, }: AskUserPromptProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/BabyHand.d.ts

@@ -1 +0,0 @@
-export declare function BabyHand(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/Banner.d.ts

@@ -1,8 +0,0 @@
-interface BannerProps {
-    model: string;
-    effort: string;
-    maxTurns: number;
-    cwd: string;
-}
-export declare function Banner({ model, effort, cwd }: BannerProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/CodeBlock.d.ts

@@ -1,7 +0,0 @@
-interface CodeBlockProps {
-    code: string;
-    language?: string;
-    showLineNumbers?: boolean;
-}
-export declare function CodeBlock({ code, language, showLineNumbers }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/CommandInput.d.ts

@@ -1,13 +0,0 @@
-interface CommandDef {
-    name: string;
-    description: string;
-}
-interface CommandInputProps {
-    value: string;
-    onChange: (value: string) => void;
-    onSubmit: (value: string) => void;
-    commands: CommandDef[];
-    placeholder?: string;
-}
-export declare function CommandInput({ value, onChange, onSubmit, commands, placeholder, }: CommandInputProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ContextUsageBar.d.ts

@@ -1,7 +0,0 @@
-interface ContextUsageBarProps {
-    usedTokens: number;
-    maxTokens: number;
-    width?: number;
-}
-export declare function ContextUsageBar({ usedTokens, maxTokens, width }: ContextUsageBarProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/DiffLine.d.ts

@@ -1,33 +0,0 @@
-export type DiffKind = "add" | "remove" | "hunk" | "context";
-interface DiffLineProps {
-    kind: DiffKind;
-    /** Raw text WITHOUT the `+ ` / `- ` prefix — DiffLine renders the marker. */
-    text: string;
-    /**
-     * Left indent applied before the marker (and before the gutter, if any).
-     * Defaults to 0; ToolCallResult passes its own padding so diff blocks
-     * line up under the `✓ ToolName` header.
-     */
-    indent?: number;
-    /**
-     * Optional dim leading glyph rendered before the colored band (e.g. the
-     * `⎿ ` connector ToolCallResult uses to group output under its header).
-     * Padding to terminal width accounts for the glyph so the band still
-     * extends to the right edge.
-     */
-    gutter?: string;
-}
-export declare function DiffLine({ kind, text, indent, gutter }: DiffLineProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Classify a raw diff text line. Matches `+\s` / `-\s` (so `+x` identifiers
- * and `+++ / ---` file headers don't trip it), `@@` hunk markers, and falls
- * through to context.
- *
- * Returns the kind and the text with its marker stripped (since `<DiffLine>`
- * re-renders the marker itself).
- */
-export declare function classifyDiffLine(raw: string): {
-    kind: DiffKind;
-    text: string;
-};
-export {};

package/dist/ui/components/DiffView.d.ts

@@ -1,6 +0,0 @@
-interface DiffViewProps {
-    diff: string;
-    maxLines?: number;
-}
-export declare function DiffView({ diff, maxLines }: DiffViewProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/DogLogo.d.ts

@@ -1 +0,0 @@
-export declare function DogLogo(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/FullscreenLayout.d.ts

@@ -1,51 +0,0 @@
-/**
- * FullscreenLayout — CC-style fullscreen terminal layout.
- *
- * Structure:
- *   ┌──────────────────────────┐
- *   │  scrollable (messages)   │  ← grows, scrollable
- *   │  overlay (permissions)   │  ← renders inside scroll area
- *   ├──────────────────────────┤
- *   │  bottom (prompt/spinner) │  ← pinned at bottom
- *   └──────────────────────────┘
- *   [pill: "N new messages"]      ← absolute, shown when scrolled away
- *
- * Supports:
- * - Scrollable message area with sticky-scroll
- * - Overlay content (permission dialogs inside scroll)
- * - "N new messages" pill when user scrolls up
- * - Modal pane for slash-command dialogs
- */
-import { type ReactNode } from "react";
-interface FullscreenLayoutProps {
-    /** Main scrollable content (messages). */
-    scrollable: ReactNode;
-    /** Bottom-pinned content (prompt input, spinner). */
-    bottom: ReactNode;
-    /** Overlay content rendered after scrollable (permission dialogs). */
-    overlay?: ReactNode;
-    /** Count of unseen messages (for pill display). */
-    newMessageCount?: number;
-    /** Called when user clicks "jump to new" pill. */
-    onJumpToNew?: () => void;
-    /** Whether to show the unseen messages pill. */
-    showPill?: boolean;
-}
-export declare function FullscreenLayout({ scrollable, bottom, overlay, newMessageCount, onJumpToNew, showPill, }: FullscreenLayoutProps): import("react/jsx-runtime").JSX.Element;
-/**
- * Hook for tracking unseen messages when user scrolls up.
- *
- * Returns:
- * - dividerIndex: where the "new messages" boundary is
- * - showPill: whether to display the unseen pill
- * - onNewMessage: call when a new message arrives
- * - onScrollToBottom: call when user scrolls to bottom or types
- */
-export declare function useUnseenDivider(messageCount: number): {
-    dividerIndex: number | null;
-    showPill: boolean;
-    unseenCount: number;
-    onScrollAway: () => void;
-    onScrollToBottom: () => void;
-};
-export {};

package/dist/ui/components/KunHead.d.ts

@@ -1 +0,0 @@
-export declare function KunHead(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/KunLogo.d.ts

@@ -1 +0,0 @@
-export declare function KunLogo(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/MessageContent.d.ts

@@ -1,26 +0,0 @@
-interface MessageContentProps {
-    text: string;
-    streaming?: boolean;
-    /** When rendered inside an agent block, suppress the leading message gap. */
-    nested?: boolean;
-}
-export declare function MessageContent({ text, streaming, nested }: MessageContentProps): import("react/jsx-runtime").JSX.Element | null;
-interface UserMessageProps {
-    text: string;
-}
-export declare function UserMessage({ text }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
-interface ErrorMessageProps {
-    error: string;
-    nested?: boolean;
-}
-export declare function ErrorMessage({ error, nested }: ErrorMessageProps): import("react/jsx-runtime").JSX.Element;
-export declare function RateLimitMessage({ text }: {
-    text: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function ContextLimitMessage(): import("react/jsx-runtime").JSX.Element;
-export declare function ThinkingMessage({ content, collapsed, nested, }: {
-    content?: string;
-    collapsed?: boolean;
-    nested?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ModelManager.d.ts

@@ -1,68 +0,0 @@
-import type { ProtocolModelEntry } from "../../protocol/types.js";
-interface SnapshotInfo {
-    count: number;
-    fetchedAt: string;
-}
-/**
- * Settings stores arena.participants as Array<string | object>. The panel
- * surfaces strings (pool keys); object-form entries are shown read-only so
- * we don't clobber a user's hand-edited config.
- */
-export type ArenaParticipantEntry = {
-    kind: "key";
-    value: string;
-} | {
-    kind: "object";
-    label: string;
-};
-/**
- * Row data shown in the Providers tab. Counts/timestamps are derived by the
- * parent from settings.providers[] + the model cache so this component stays
- * presentational.
- */
-export interface ProviderManagerEntry {
-    key: string;
-    label: string;
-    kind: string;
-    modelCount: number;
-    cachedModels?: number;
-    cachedAt?: string;
-    baseUrl?: string;
-    apiKey?: string;
-    protocol?: string;
-    modelsPath?: string;
-}
-interface ModelManagerProps {
-    entries: ProtocolModelEntry[];
-    snapshot: SnapshotInfo;
-    arenaParticipants: ArenaParticipantEntry[];
-    /** Providers configured in settings.providers[] (Task 11+). */
-    providers?: ProviderManagerEntry[];
-    /** Activate a model. */
-    onSwitch: (key: string) => Promise<void>;
-    /** Trigger an OpenRouter snapshot refresh. */
-    onSync: () => Promise<{
-        ok: boolean;
-        count: number;
-        error?: string;
-    }>;
-    /** Persist updated participant list (string[]) to settings. */
-    onSaveArena: (participants: string[]) => Promise<void>;
-    /** Open the parent-rendered ProviderModelFlow (covers both add-provider and add-model). */
-    onOpenFlow?: () => void;
-    /** Force-refresh a provider's cached model list. */
-    onRefreshProvider?: (key: string) => Promise<{
-        count: number;
-        error?: string;
-    }>;
-    /** Delete a provider (blocked if any model references it). */
-    onDeleteProvider?: (key: string) => Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Delete a model entry. */
-    onDeleteModel?: (key: string) => Promise<void>;
-    onClose: () => void;
-}
-export declare function ModelManager({ entries, snapshot, arenaParticipants, providers, onSwitch, onSync, onSaveArena, onOpenFlow, onRefreshProvider, onDeleteProvider, onDeleteModel, onClose, }: ModelManagerProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/ModelSelector.d.ts

@@ -1,10 +0,0 @@
-import type { ProtocolModelEntry } from "../../protocol/types.js";
-/** Re-export under the UI name for convenience. */
-export type ModelEntry = ProtocolModelEntry;
-interface ModelSelectorProps {
-    entries: ModelEntry[];
-    onSelect: (key: string) => void;
-    onCancel: () => void;
-}
-export declare function ModelSelector({ entries, onSelect, onCancel }: ModelSelectorProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/OnboardingPrompt.d.ts

@@ -1,16 +0,0 @@
-import { type OnboardingResult } from "../../cli/onboarding.js";
-import type { ProviderConfig } from "../../llm/provider-catalog.js";
-interface OnboardingPromptProps {
-    onComplete: (result: OnboardingResult) => void;
-    onCancel: () => void;
-    /** Existing providers — surfaces "Use existing" in the flow's first step.
-     *  Optional: empty by default (first-run case). */
-    existingProviders?: ProviderConfig[];
-    /** Existing model aliases — used by the flow to derive unique aliases. */
-    existingModelKeys?: string[];
-    /** Model ids already in settings.models[] — used by the flow to disable
-     *  rows for models the user has already added. */
-    existingModelIds?: string[];
-}
-export declare function OnboardingPrompt({ onComplete, onCancel, existingProviders, existingModelKeys, existingModelIds, }: OnboardingPromptProps): import("react/jsx-runtime").JSX.Element | null;
-export {};

package/dist/ui/components/PermissionDialog.d.ts

@@ -1,8 +0,0 @@
-interface PermissionDialogProps {
-    toolName: string;
-    description: string;
-    riskLevel: "low" | "medium" | "high";
-    onDecision: (approved: boolean, permanent?: boolean) => void;
-}
-export declare function PermissionDialog({ toolName, description, riskLevel, onDecision }: PermissionDialogProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/ui/components/PermissionPrompt.d.ts

@@ -1,11 +0,0 @@
-import type { ApprovalScope } from "../../types.js";
-interface PermissionPromptProps {
-    toolName: string;
-    description: string;
-    riskLevel: string;
-    args: Record<string, unknown>;
-    cwd: string;
-    onDecision: (approved: boolean, scope: ApprovalScope) => void;
-}
-export declare function PermissionPrompt({ toolName, description, riskLevel, args, cwd, onDecision, }: PermissionPromptProps): import("react/jsx-runtime").JSX.Element;
-export {};