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

package/dist/tool-system/validation.d.ts

@@ -1,5 +0,0 @@
-/**
- * Validate tool args against the tool's inputSchema.
- * Returns null if valid, error string if invalid.
- */
-export declare function validateToolArgs(toolName: string, args: Record<string, unknown>, schema: Record<string, unknown>): string | null;

package/dist/types.d.ts

@@ -1,356 +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;
-    name?: string;
-    description: string;
-} | {
-    type: "agent_end";
-    agentId: string;
-    name?: string;
-    description: string;
-    text?: 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>;
-}
-/**
- * Shell-hook configuration entry from settings.json. Each entry binds
- * a hook event to a shell command. The command runs as a child process
- * on every emit (filtered by `matcher` when present), receives ctx
- * JSON on stdin, and returns a HookResult JSON on stdout. See
- * src/hooks/shell-runner.ts for the protocol spec.
- */
-export interface SettingsHookConfig {
-    event: string;
-    command: string;
-    /**
-     * Optional regex (matched with new RegExp(matcher).test(toolName)) to
-     * filter which tools fire this hook. Currently honored for
-     * pre_tool_use / post_tool_use / on_tool_start / on_tool_end /
-     * on_permission_check / file_changed. Ignored for events without a
-     * meaningful toolName (session/turn/prompt/notification/compact).
-     */
-    matcher?: string;
-    /** Per-hook timeout in milliseconds. Defaults to 60_000. */
-    timeout_ms?: number;
-    /**
-     * Optional working directory for the spawned command. Defaults to
-     * Engine.cwd. Useful for hooks that need to run in a sibling repo.
-     */
-    cwd?: 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";
-    };
-    /**
-     * Optional shell-hook entries. Engine reads on construction and
-     * registers a wrapper handler per entry that spawns the command and
-     * parses the HookResult. Empty / missing = no shell hooks.
-     */
-    hooks?: SettingsHookConfig[];
-}

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,35 +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 {
-    name?: string;
-    description: string;
-    running?: boolean;
-    isLast?: boolean;
-}
-export declare function AgentBlockStart({ name, description, running, isLast }: AgentBlockStartProps): import("react/jsx-runtime").JSX.Element;
-interface AgentBlockEndProps {
-    name?: string;
-    description: string;
-    text?: string;
-    error?: string;
-    isLast?: boolean;
-}
-export declare function AgentBlockEnd({ name, description, text, 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/AgentDock.d.ts

@@ -1,36 +0,0 @@
-import React from "react";
-import { type AsyncAgentEntry } from "../../tool-system/builtin/agent-registry.js";
-export declare const MAX_VISIBLE = 5;
-export type DockViewMode = {
-    kind: "main";
-} | {
-    kind: "agent";
-    agentId: string;
-};
-export interface AgentDockProps {
-    viewMode: DockViewMode;
-    /** null = dock is not the keyboard target; integer = focused row index. */
-    focusedIndex: number | null;
-}
-/**
- * AgentDock — vertical list of running and recently-finished sub-agents,
- * pinned at the very bottom of the UI. Updates elapsed text once per
- * second; redraws are local to this subtree (no app-wide re-render).
- *
- * See docs/superpowers/specs/2026-05-18-subagent-dock-revisions-design.md.
- */
-export declare function AgentDock({ viewMode, focusedIndex, }: AgentDockProps): React.ReactElement | null;
-/**
- * Filter the registry snapshot down to rows the dock should show:
- * running agents + recently-finished agents still inside the fade window.
- * Successful completions are dropped immediately — their final text already
- * surfaced via agent_end in the main feed, so the dock row is redundant.
- * Failures and cancellations linger so the user can investigate.
- *
- * Exported so App.tsx's keyboard handler shares the same predicate.
- */
-export declare function getVisibleAgents(all: AsyncAgentEntry[], now: number): AsyncAgentEntry[];
-/**
- * Format an elapsed-millisecond duration as "23s" / "4m 23s" / "1h 4m 23s".
- */
-export declare function formatElapsed(ms: number): string;

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,24 +0,0 @@
-interface CommandDef {
-    name: string;
-    description: string;
-    /** Optional usage string like "/fullscreen [on|off|toggle]" — the
-     *  bracketed portion is rendered dim after the command name once the
-     *  user has finished typing it. */
-    usage?: string;
-}
-interface CommandInputProps {
-    value: string;
-    onChange: (value: string) => void;
-    onSubmit: (value: string) => void;
-    commands: CommandDef[];
-    placeholder?: string;
-    /** Fired when ↓ is pressed and input is empty and history is exhausted.
-     *  Used by App.tsx to move keyboard focus into the AgentDock.  */
-    onArrowOut?: (direction: "down") => void;
-    /** When true, skip ALL key handling. Used while another part of the UI
-     *  (e.g. the AgentDock) owns the keyboard. The text input still renders;
-     *  only the useInput body short-circuits. */
-    disabled?: boolean;
-}
-export declare function CommandInput({ value, onChange, onSubmit, commands, placeholder, onArrowOut, disabled, }: 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 {};