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

package/dist/utils/earlyInput.d.ts

@@ -1,43 +0,0 @@
-/**
- * Early Input Capture
- *
- * This module captures terminal input that is typed before the REPL is fully
- * initialized. Users often type `claude` and immediately start typing their
- * prompt, but those early keystrokes would otherwise be lost during startup.
- *
- * Usage:
- * 1. Call startCapturingEarlyInput() as early as possible in cli.tsx
- * 2. When REPL is ready, call consumeEarlyInput() to get any buffered text
- * 3. stopCapturingEarlyInput() is called automatically when input is consumed
- */
-/**
- * Start capturing stdin data early, before the REPL is initialized.
- * Should be called as early as possible in the startup sequence.
- *
- * Only captures if stdin is a TTY (interactive terminal).
- */
-export declare function startCapturingEarlyInput(): void;
-/**
- * Stop capturing early input.
- * Called automatically when input is consumed, or can be called manually.
- */
-export declare function stopCapturingEarlyInput(): void;
-/**
- * Consume any early input that was captured.
- * Returns the captured input and clears the buffer.
- * Automatically stops capturing when called.
- */
-export declare function consumeEarlyInput(): string;
-/**
- * Check if there is any early input available without consuming it.
- */
-export declare function hasEarlyInput(): boolean;
-/**
- * Seed the early input buffer with text that will appear pre-filled
- * in the prompt input when the REPL renders. Does not auto-submit.
- */
-export declare function seedEarlyInput(text: string): void;
-/**
- * Check if early input capture is currently active.
- */
-export declare function isCapturingEarlyInput(): boolean;

package/dist/utils/env.d.ts

@@ -1,24 +0,0 @@
-/**
- * Environment detection — platform, runtime, config paths, network.
- */
-export declare const env: {
-    platform: "darwin" | "linux" | "win32";
-    terminal: string;
-    shell: string;
-    isCI: boolean;
-};
-export declare function getHostPlatform(): "macos" | "linux" | "windows";
-export declare function getHostPlatformForAnalytics(): string;
-export declare function isWSL(): boolean;
-/** ~/.claude/ directory (Claude Code compatible) */
-export declare function getGlobalClaudeDir(): string;
-/** ~/.code-shell/ directory */
-export declare function getGlobalCodeShellDir(): string;
-/** Resolve a file in ~/.claude/ or ~/.code-shell/ (claude takes precedence) */
-export declare function getGlobalClaudeFile(filename: string): string | undefined;
-export declare function getRuntime(): "bun" | "deno" | "node";
-export declare function getPackageManager(cwd?: string): "bun" | "pnpm" | "yarn" | "npm";
-export declare function hasInternetAccess(): Promise<boolean>;
-export declare const JETBRAINS_IDES: readonly ["idea", "pycharm", "webstorm", "phpstorm", "rubymine", "clion", "goland", "rider", "datagrip", "fleet"];
-export declare function isJetBrainsTerminal(): boolean;
-export declare function isVSCodeTerminal(): boolean;

package/dist/utils/envUtils.d.ts

@@ -1,51 +0,0 @@
-/**
- * Environment variable helpers — ported from CC's utils/envUtils with full implementations.
- */
-/**
- * Returns the Claude/Code Shell config home directory.
- * Defaults to ~/.claude, overridable via CLAUDE_CONFIG_DIR env var.
- * Memoized — keyed off CLAUDE_CONFIG_DIR so tests that change the env var get a fresh value.
- */
-export declare function getClaudeConfigHomeDir(): string;
-export declare function getTeamsDir(): string;
-export declare function isEnvTruthy(val: string | boolean | undefined): boolean;
-export declare function isEnvDefinedFalsy(envVar: string | boolean | undefined): boolean;
-/**
- * Check if NODE_OPTIONS contains a specific flag.
- */
-export declare function hasNodeOption(flag: string): boolean;
-/**
- * --bare / CLAUDE_CODE_SIMPLE — skip hooks, LSP, plugin sync, skill dir-walk,
- * attribution, background prefetches, and ALL keychain/credential reads.
- */
-export declare function isBareMode(): boolean;
-/**
- * Parses an array of environment variable strings into a key-value object.
- * @param rawEnvArgs Array of strings in KEY=VALUE format
- */
-export declare function parseEnvVars(rawEnvArgs: string[] | undefined): Record<string, string>;
-/**
- * Get the AWS region with fallback to default.
- */
-export declare function getAWSRegion(): string;
-/**
- * Get the default Vertex AI region.
- */
-export declare function getDefaultVertexRegion(): string;
-/**
- * Check if bash commands should maintain project working directory.
- */
-export declare function shouldMaintainProjectWorkingDir(): boolean;
-/**
- * Check if running on Homespace (ant-internal cloud environment).
- */
-export declare function isRunningOnHomespace(): boolean;
-/**
- * Get the Vertex AI region for a specific model.
- */
-export declare function getVertexRegionForModel(model: string | undefined): string | undefined;
-/**
- * Stub: Check if running inside a protected namespace.
- * Always returns false in Code Shell (Anthropic-internal feature).
- */
-export declare function isInProtectedNamespace(): boolean;

package/dist/utils/execFileNoThrow.d.ts

@@ -1,39 +0,0 @@
-/**
- * Execute a child process without throwing on non-zero exit.
- *
- * Distinguishes between:
- * - Spawn failure (file not found, permission denied) → code = null
- * - Non-zero exit (process ran but returned error) → code = exit code
- * - Success → code = 0
- */
-export interface ExecFileNoThrowResult {
-    /** Process exit code (0 = success, null = spawn failed). */
-    code: number | null;
-    stdout: string;
-    stderr: string;
-}
-export interface ExecFileNoThrowOptions {
-    /** stdin input to pipe to the process. */
-    input?: string;
-    /** Working directory. */
-    cwd?: string;
-    /** Timeout in ms (default 10_000). */
-    timeout?: number;
-    /** Environment variables to merge. */
-    env?: Record<string, string | undefined>;
-    /** Shell to run in (if true, uses platform default). */
-    shell?: boolean | string;
-}
-/**
- * Run a command and return exit code + stdout/stderr.
- * Never throws — spawn failures return code=null.
- */
-export declare function execFileNoThrow(file: string, args: string[], options?: ExecFileNoThrowOptions): Promise<ExecFileNoThrowResult>;
-/**
- * execFileNoThrow with explicit cwd (convenience wrapper).
- */
-export declare function execFileNoThrowWithCwd(cwd: string, file: string, args: string[], options?: Omit<ExecFileNoThrowOptions, "cwd">): Promise<ExecFileNoThrowResult>;
-/**
- * @deprecated Use execFileNoThrow directly.
- */
-export declare function execSyncWithDefaults_DEPRECATED(..._args: any[]): any;

package/dist/utils/format.d.ts

@@ -1,44 +0,0 @@
-/**
- * Formats a byte count to a human-readable string (KB, MB, GB).
- * @example formatFileSize(1536) → "1.5KB"
- */
-export declare function formatFileSize(sizeInBytes: number): string;
-/**
- * Formats milliseconds as seconds with 1 decimal place (e.g. `1234` → `"1.2s"`).
- * Unlike formatDuration, always keeps the decimal — use for sub-minute timings
- * where the fractional second is meaningful (TTFT, hook durations, etc.).
- */
-export declare function formatSecondsShort(ms: number): string;
-export declare function formatDuration(ms: number, options?: {
-    hideTrailingZeros?: boolean;
-    mostSignificantOnly?: boolean;
-}): string;
-export declare function formatNumber(number: number): string;
-export declare function formatTokens(count: number): string;
-type RelativeTimeStyle = 'long' | 'short' | 'narrow';
-type RelativeTimeOptions = {
-    style?: RelativeTimeStyle;
-    numeric?: 'always' | 'auto';
-};
-export declare function formatRelativeTime(date: Date, options?: RelativeTimeOptions & {
-    now?: Date;
-}): string;
-export declare function formatRelativeTimeAgo(date: Date, options?: RelativeTimeOptions & {
-    now?: Date;
-}): string;
-/**
- * Formats log metadata for display (time, size or message count, branch, tag, PR)
- */
-export declare function formatLogMetadata(log: {
-    modified: Date;
-    messageCount: number;
-    fileSize?: number;
-    gitBranch?: string;
-    tag?: string;
-    agentSetting?: string;
-    prNumber?: number;
-    prRepository?: string;
-}): string;
-export declare function formatResetTime(timestampInSeconds: number | undefined, showTimezone?: boolean, showTime?: boolean): string | undefined;
-export declare function formatResetText(resetsAt: string, showTimezone?: boolean, showTime?: boolean): string;
-export { truncate, truncatePathMiddle, truncateStartToWidth, truncateToWidth, truncateToWidthNoEllipsis, wrapText, } from './truncate.js';

package/dist/utils/fullscreen.d.ts

@@ -1,47 +0,0 @@
-/**
- * True when running under `tmux -CC` (iTerm2 integration mode).
- *
- * The alt-screen / mouse-tracking path in fullscreen mode is unrecoverable
- * in -CC mode (double-click corrupts terminal state; mouse wheel is dead),
- * so callers auto-disable fullscreen.
- */
-export declare function isTmuxControlMode(): boolean;
-export declare function _resetTmuxControlModeProbeForTesting(): void;
-/**
- * Runtime env-var check only. Ants default to on (CLAUDE_CODE_NO_FLICKER=0
- * to opt out); external users default to off (CLAUDE_CODE_NO_FLICKER=1 to
- * opt in).
- */
-export declare function isFullscreenEnvEnabled(): boolean;
-/**
- * Whether fullscreen mode should enable SGR mouse tracking (DEC 1000/1002/1006).
- * Set CLAUDE_CODE_DISABLE_MOUSE=1 to keep alt-screen + virtualized scroll
- * but skip mouse capture, so tmux/kitty/terminal-native copy-on-select keeps working.
- */
-export declare function isMouseTrackingEnabled(): boolean;
-/**
- * Whether mouse click handling is disabled (clicks/drags ignored, wheel still
- * works). Set CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1 to prevent accidental clicks
- * from triggering cursor positioning, text selection, or message expansion.
- */
-export declare function isMouseClicksDisabled(): boolean;
-/**
- * True when the fullscreen alt-screen layout is actually rendering —
- * requires an interactive REPL session AND the env var not explicitly
- * set falsy.
- */
-export declare function isFullscreenActive(): boolean;
-/**
- * One-time hint for tmux users in fullscreen with `mouse off`.
- *
- * Fire-and-forget from REPL startup. Returns the hint text once per
- * session if TMUX is set, fullscreen is active, and tmux's current
- * `mouse` option is off; null otherwise.
- */
-export declare function maybeGetTmuxMouseHint(): Promise<string | null>;
-/** Test-only: reset module-level once-per-session flags. */
-export declare function _resetForTesting(): void;
-/**
- * Whether fullscreen mode is available (alias for isFullscreenActive).
- */
-export declare function isFullscreen(): boolean;

package/dist/utils/intl.d.ts

@@ -1,22 +0,0 @@
-/**
- * Shared Intl object instances with lazy initialization.
- *
- * Intl constructors are expensive (~0.05-0.1ms each), so we cache instances
- * for reuse across the codebase instead of creating new ones each time.
- * Lazy initialization ensures we only pay the cost when actually needed.
- */
-export declare function getGraphemeSegmenter(): Intl.Segmenter;
-/**
- * Extract the first grapheme cluster from a string.
- * Returns '' for empty strings.
- */
-export declare function firstGrapheme(text: string): string;
-/**
- * Extract the last grapheme cluster from a string.
- * Returns '' for empty strings.
- */
-export declare function lastGrapheme(text: string): string;
-export declare function getWordSegmenter(): Intl.Segmenter;
-export declare function getRelativeTimeFormat(style: 'long' | 'short' | 'narrow', numeric: 'always' | 'auto'): Intl.RelativeTimeFormat;
-export declare function getTimeZone(): string;
-export declare function getSystemLocaleLanguage(): string | undefined;

package/dist/utils/lockfile.d.ts

@@ -1,15 +0,0 @@
-/**
- * Lazy accessor for proper-lockfile.
- *
- * proper-lockfile depends on graceful-fs, which monkey-patches every fs
- * method on first require (~8ms). Static imports of proper-lockfile pull this
- * cost into the startup path even when no locking happens (e.g. `--help`).
- *
- * Import this module instead of `proper-lockfile` directly. The underlying
- * package is only loaded the first time a lock function is actually called.
- */
-import type { CheckOptions, LockOptions, UnlockOptions } from 'proper-lockfile';
-export declare function lock(file: string, options?: LockOptions): Promise<() => Promise<void>>;
-export declare function lockSync(file: string, options?: LockOptions): () => void;
-export declare function unlock(file: string, options?: UnlockOptions): Promise<void>;
-export declare function check(file: string, options?: CheckOptions): Promise<boolean>;

package/dist/utils/semver.d.ts

@@ -1,6 +0,0 @@
-/**
- * Shim for CC's utils/semver — re-exports semver comparison helpers.
- */
-export declare function gte(a: string, b: string): boolean;
-export declare function gt(a: string, b: string): boolean;
-export declare function lt(a: string, b: string): boolean;

package/dist/utils/sliceAnsi.d.ts

@@ -1,12 +0,0 @@
-/**
- * Shim for CC's utils/sliceAnsi — slices an ANSI-styled string by display
- * column position while preserving escape sequences.
- *
- * This is a lightweight implementation. For full fidelity with wide characters
- * and complex ANSI sequences, consider installing `slice-ansi`.
- */
-/**
- * Slice a string that may contain ANSI escape codes by *visible* character
- * positions (start inclusive, end exclusive).
- */
-export default function sliceAnsi(text: string, start: number, end?: number): string;

package/dist/utils/systemTheme.d.ts

@@ -1,40 +0,0 @@
-/**
- * Terminal dark/light mode detection for the 'auto' theme setting.
- *
- * Detection is based on the terminal's actual background color (queried via
- * OSC 11 by systemThemeWatcher.ts) rather than the OS appearance setting —
- * a dark terminal on a light-mode OS should still resolve to 'dark'.
- *
- * The detected theme is cached module-level so callers can resolve 'auto'
- * without awaiting the async OSC round-trip. The cache is seeded from
- * $COLORFGBG (synchronous, set by some terminals at launch) and then
- * updated by the watcher once the OSC 11 response arrives.
- */
-import type { ThemeName, ThemeSetting } from './theme.js';
-export type SystemTheme = 'dark' | 'light';
-/**
- * Get the current terminal theme. Cached after first detection; the watcher
- * updates the cache on live changes.
- */
-export declare function getSystemThemeName(): SystemTheme;
-/**
- * Update the cached terminal theme. Called by the watcher when the OSC 11
- * query returns so non-React call sites stay in sync.
- */
-export declare function setCachedSystemTheme(theme: SystemTheme): void;
-/**
- * Resolve a ThemeSetting (which may be 'auto') to a concrete ThemeName.
- */
-export declare function resolveThemeSetting(setting: ThemeSetting): ThemeName;
-/**
- * Parse an OSC color response data string into a theme.
- *
- * Accepts XParseColor formats returned by OSC 10/11 queries:
- * - `rgb:R/G/B` where each component is 1–4 hex digits (each scaled to
- *   [0, 16^n - 1] for n digits). This is what xterm, iTerm2, Terminal.app,
- *   Ghostty, kitty, Alacritty, etc. return.
- * - `#RRGGBB` / `#RRRRGGGGBBBB` (rare, but cheap to accept).
- *
- * Returns undefined for unrecognized formats so callers can fall back.
- */
-export declare function themeFromOscColor(data: string): SystemTheme | undefined;

package/dist/utils/task-sanitizer.d.ts

@@ -1,6 +0,0 @@
-export interface NoiseResult {
-    isNoise: boolean;
-    reason: string;
-    cleaned: string;
-}
-export declare function detectPastedNoise(task: string): NoiseResult;

package/dist/utils/theme.d.ts

@@ -1,91 +0,0 @@
-export type Theme = {
-    autoAccept: string;
-    bashBorder: string;
-    claude: string;
-    claudeShimmer: string;
-    claudeBlue_FOR_SYSTEM_SPINNER: string;
-    claudeBlueShimmer_FOR_SYSTEM_SPINNER: string;
-    permission: string;
-    permissionShimmer: string;
-    planMode: string;
-    ide: string;
-    promptBorder: string;
-    promptBorderShimmer: string;
-    text: string;
-    inverseText: string;
-    inactive: string;
-    inactiveShimmer: string;
-    subtle: string;
-    suggestion: string;
-    remember: string;
-    background: string;
-    success: string;
-    error: string;
-    warning: string;
-    merged: string;
-    warningShimmer: string;
-    diffAdded: string;
-    diffRemoved: string;
-    diffAddedDimmed: string;
-    diffRemovedDimmed: string;
-    diffAddedWord: string;
-    diffRemovedWord: string;
-    red_FOR_SUBAGENTS_ONLY: string;
-    blue_FOR_SUBAGENTS_ONLY: string;
-    green_FOR_SUBAGENTS_ONLY: string;
-    yellow_FOR_SUBAGENTS_ONLY: string;
-    purple_FOR_SUBAGENTS_ONLY: string;
-    orange_FOR_SUBAGENTS_ONLY: string;
-    pink_FOR_SUBAGENTS_ONLY: string;
-    cyan_FOR_SUBAGENTS_ONLY: string;
-    professionalBlue: string;
-    chromeYellow: string;
-    clawd_body: string;
-    clawd_background: string;
-    userMessageBackground: string;
-    userMessageBackgroundHover: string;
-    /** Message-actions selection. Cool shift toward `suggestion` blue; distinct from default AND userMessageBackground. */
-    messageActionsBackground: string;
-    /** Text-selection highlight background (alt-screen mouse selection). Solid
-     *  bg that REPLACES the cell's bg while preserving its fg — matches native
-     *  terminal selection. Previously SGR-7 inverse (swapped fg/bg per cell),
-     *  which fragmented badly over syntax highlighting. */
-    selectionBg: string;
-    bashMessageBackgroundColor: string;
-    memoryBackgroundColor: string;
-    rate_limit_fill: string;
-    rate_limit_empty: string;
-    fastMode: string;
-    fastModeShimmer: string;
-    briefLabelYou: string;
-    briefLabelClaude: string;
-    rainbow_red: string;
-    rainbow_orange: string;
-    rainbow_yellow: string;
-    rainbow_green: string;
-    rainbow_blue: string;
-    rainbow_indigo: string;
-    rainbow_violet: string;
-    rainbow_red_shimmer: string;
-    rainbow_orange_shimmer: string;
-    rainbow_yellow_shimmer: string;
-    rainbow_green_shimmer: string;
-    rainbow_blue_shimmer: string;
-    rainbow_indigo_shimmer: string;
-    rainbow_violet_shimmer: string;
-};
-export declare const THEME_NAMES: readonly ["dark", "light", "light-daltonized", "dark-daltonized", "light-ansi", "dark-ansi"];
-/** A renderable theme. Always resolvable to a concrete color palette. */
-export type ThemeName = (typeof THEME_NAMES)[number];
-export declare const THEME_SETTINGS: readonly ["auto", "dark", "light", "light-daltonized", "dark-daltonized", "light-ansi", "dark-ansi"];
-/**
- * A theme preference as stored in user config. `'auto'` follows the system
- * dark/light mode and is resolved to a ThemeName at runtime.
- */
-export type ThemeSetting = (typeof THEME_SETTINGS)[number];
-export declare function getTheme(themeName: ThemeName): Theme;
-/**
- * Converts a theme color to an ANSI escape sequence for use with asciichart.
- * Uses chalk to generate the escape codes, with 256-color mode for Apple Terminal.
- */
-export declare function themeColorToAnsi(themeColor: string): string;

package/dist/utils/toolDisplay.d.ts

@@ -1,31 +0,0 @@
-/**
- * Shared formatting utilities for tool call display.
- *
- * Used by both:
- * - ui/components/ToolCall.tsx (Ink REPL)
- * - cli/output/renderer.ts (headless text output)
- */
-/** Maximum preview lines for tool output. */
-export declare const MAX_PREVIEW_LINES = 4;
-export declare const MAX_LINE_WIDTH = 88;
-/** Tool name → display color for the dot indicator. */
-export declare const TOOL_DOT_COLORS: Record<string, string>;
-/**
- * Format tool arguments into a compact one-line summary.
- */
-export declare function formatToolArgs(toolName: string, args: Record<string, unknown>): string;
-/** Truncate a string to max length with ellipsis. */
-export declare function truncate(s: string, max: number): string;
-/** Collapse multiline text to a single line. */
-export declare function singleLine(s: string): string;
-/** Format byte count in human-readable form. */
-export declare function formatBytes(n: number): string;
-export interface CompactResult {
-    summary: string;
-    preview: string[];
-    moreLines: number;
-}
-/**
- * Produce a compact summary of tool output for display.
- */
-export declare function compactOutput(toolName: string, content: string): CompactResult;

package/dist/utils/truncate.d.ts

@@ -1,40 +0,0 @@
-/**
- * Truncates a file path in the middle to preserve both directory context and filename.
- * Width-aware: uses stringWidth() for correct CJK/emoji measurement.
- * For example: "src/components/deeply/nested/folder/MyComponent.tsx" becomes
- * "src/components/…/MyComponent.tsx" when maxLength is 30.
- *
- * @param path The file path to truncate
- * @param maxLength Maximum display width of the result in terminal columns (must be > 0)
- * @returns The truncated path, or original if it fits within maxLength
- */
-export declare function truncatePathMiddle(path: string, maxLength: number): string;
-/**
- * Truncates a string to fit within a maximum display width, measured in terminal columns.
- * Splits on grapheme boundaries to avoid breaking emoji or surrogate pairs.
- * Appends '…' when truncation occurs.
- */
-export declare function truncateToWidth(text: string, maxWidth: number): string;
-/**
- * Truncates from the start of a string, keeping the tail end.
- * Prepends '…' when truncation occurs.
- * Width-aware and grapheme-safe.
- */
-export declare function truncateStartToWidth(text: string, maxWidth: number): string;
-/**
- * Truncates a string to fit within a maximum display width, without appending an ellipsis.
- * Useful when the caller adds its own separator (e.g. middle-truncation with '…' between parts).
- * Width-aware and grapheme-safe.
- */
-export declare function truncateToWidthNoEllipsis(text: string, maxWidth: number): string;
-/**
- * Truncates a string to fit within a maximum display width (terminal columns),
- * splitting on grapheme boundaries to avoid breaking emoji, CJK, or surrogate pairs.
- * Appends '…' when truncation occurs.
- * @param str The string to truncate
- * @param maxWidth Maximum display width in terminal columns
- * @param singleLine If true, also truncates at the first newline
- * @returns The truncated string with ellipsis if needed
- */
-export declare function truncate(str: string, maxWidth: number, singleLine?: boolean): string;
-export declare function wrapText(text: string, width: number): string[];

package/dist/voice/index.d.ts

@@ -1,35 +0,0 @@
-/**
- * Voice mode — STT (speech-to-text) and TTS (text-to-speech) integration.
- *
- * STT: Uses Whisper API via OpenRouter (or local whisper.cpp)
- * TTS: Uses system speech synthesis (macOS `say`, Linux `espeak`)
- */
-export interface VoiceConfig {
-    sttProvider?: "whisper-api" | "local";
-    ttsProvider?: "system" | "none";
-    apiKey?: string;
-    baseUrl?: string;
-}
-export declare function isVoiceEnabled(): boolean;
-export declare function enableVoice(config?: VoiceConfig): void;
-export declare function disableVoice(): void;
-/**
- * Speak text using system TTS.
- */
-export declare function speak(text: string): void;
-/**
- * Stop any currently speaking TTS.
- */
-export declare function stopSpeaking(): void;
-/**
- * Check if audio recording is available.
- */
-export declare function isRecordingAvailable(): boolean;
-/**
- * Record audio and transcribe via Whisper API.
- * Returns the transcribed text.
- *
- * Note: Full implementation requires audio capture setup.
- * This is a stub that shows the architecture.
- */
-export declare function recordAndTranscribe(_durationSeconds?: number): Promise<string>;