@cjhyy/code-shell 0.1.0-alpha.1 → 0.1.0-alpha.3

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

@@ -5,14 +5,29 @@ import type { ToolCall, ToolResult, Message } from "../types.js";
 import type { HookRegistry } from "../hooks/registry.js";
 import { ToolRegistry } from "./registry.js";
 import { PermissionClassifier } from "./permission.js";
+import { logger as rootLogger } from "../logging/logger.js";
+import type { ToolContext } from "./context.js";
+type Logger = typeof rootLogger;
 export declare class ToolExecutor {
     private readonly registry;
     private readonly permission;
     private readonly hooks;
     private signal?;
+    /** Per-Engine ToolContext injected for every tool call. */
+    private toolCtx?;
+    /**
+     * Turn-scoped logger set by TurnLoop at the top of each iteration.
+     * Falls back to the root logger so executor calls outside the turn loop
+     * (tests, ad-hoc tool runs) still write log lines, just without turn tags.
+     */
+    private log;
     constructor(registry: ToolRegistry, permission: PermissionClassifier, hooks: HookRegistry);
     /** Set the abort signal for cascading cancellation. */
     setSignal(signal?: AbortSignal): void;
+    /** Set the per-Engine ToolContext (askUser, llmConfig, modelPool, etc.). */
+    setContext(ctx: ToolContext | undefined): void;
+    /** Inject a turn-scoped logger so tool-execution lines carry turn/turnId. */
+    setLogger(log: Logger): void;
     /** Check if a tool is safe for concurrent execution (read-only). */
     isConcurrencySafe(toolName: string): boolean;
     executeSingle(call: ToolCall): Promise<ToolResult>;
@@ -23,3 +38,4 @@ export declare class ToolExecutor {
      */
     resultsToMessages(toolCalls: ToolCall[], results: ToolResult[]): Message[];
 }
+export {};

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

@@ -2,6 +2,7 @@
  * Permission system — classifier + approval backend.
  */
 import type { PermissionDecision, PermissionMode, PermissionRule, ApprovalRequest, ApprovalResult } from "../types.js";
+import { logger as rootPermLogger } from "../logging/logger.js";
 export interface ApprovalBackend {
     requestApproval(request: ApprovalRequest): Promise<ApprovalResult>;
 }
@@ -22,14 +23,33 @@ export declare class AutoApprovalBackend implements ApprovalBackend {
 }
 /**
  * Interactive approval backend — prompts the user via a callback.
- * Supports "always allow" rules that persist for the session.
+ *
+ * Stores "always allow" decisions at two scopes:
+ *   - session: in-memory map, lost when the process exits
+ *   - project: persisted to <cwd>/.code-shell/settings.local.json so the
+ *              same project remembers the rule across REPL restarts
+ *
+ * The classifier reads project rules from settings on session start (see
+ * Engine.buildPermissionConfig), so persisted rules become "auto-allow"
+ * the next time the user opens the project.
  */
 export declare class InteractiveApprovalBackend implements ApprovalBackend {
     private sessionRules;
     private promptFn;
+    private cwd;
+    private savedProjectRules;
+    private onProjectRules;
     setPromptFn(fn: (request: ApprovalRequest) => Promise<ApprovalResult>): void;
+    /** Inject the project root so persistence writes to the right settings file. */
+    setCwd(cwd: string): void;
+    /**
+     * Inject a callback fired when the user approves "for this project". The
+     * callback receives the *full* accumulated list of project rules saved in
+     * this session, so the classifier can be reconfigured without losing
+     * earlier approvals.
+     */
+    setOnProjectRules(fn: (rules: PermissionRule[]) => void): void;
     requestApproval(req: ApprovalRequest): Promise<ApprovalResult>;
-    private ruleKeyFromArgs;
 }
 export declare function getInteractiveApprovalBackend(): InteractiveApprovalBackend;
 export declare function setInteractiveApprovalFn(fn: (request: ApprovalRequest) => Promise<ApprovalResult>): void;
@@ -52,11 +72,21 @@ export declare class DenialTracker {
 export declare function setRuntimeBypass(enabled: boolean): void;
 export declare function isRuntimeBypass(): boolean;
 export declare class PermissionClassifier {
-    private readonly rules;
-    private readonly defaultMode;
-    private readonly approvalBackend;
+    private rules;
+    private defaultMode;
+    private approvalBackend;
     private denialTracker;
+    /**
+     * Turn-scoped logger so permission events (ask/decision/auto-deny) are
+     * tagged with the current turn/turnId. Falls back to the root logger so
+     * tests and ad-hoc usages still write log lines.
+     */
+    private log;
     constructor(rules: PermissionRule[], defaultMode?: PermissionMode, approvalBackend?: ApprovalBackend);
+    setLogger(log: typeof rootPermLogger): void;
+    /** Replace mode + backend in place so live tool execution sees the change. */
+    reconfigure(mode: PermissionMode, approvalBackend: ApprovalBackend, rules?: PermissionRule[]): void;
+    getMode(): PermissionMode;
     classify(toolName: string, args: Record<string, unknown>): PermissionDecision;
     handleAsk(toolName: string, args: Record<string, unknown>): Promise<boolean>;
     /** Get denial warning message if the model keeps getting denied. */
@@ -64,6 +94,11 @@ export declare class PermissionClassifier {
     private matchesRule;
     private isDangerousCommand;
     private assessRisk;
+    /**
+     * Short, human-friendly subtitle. The UI shows this under the tool title;
+     * full args (command bodies, diffs, etc.) come from the args field, so this
+     * stays compact — no truncation here, just a label.
+     */
     private describeToolCall;
 }
 export {};

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

@@ -3,6 +3,7 @@
  */
 import type { RegisteredTool, ToolDefinition, ToolResult } from "../types.js";
 import { type BuiltinToolFn } from "./builtin/index.js";
+import type { ToolContext } from "./context.js";
 /**
  * Default execution timeout for any tool that does not declare its own
  * timeoutMs at registration time. Tools that need to run longer (Agent,
@@ -24,6 +25,7 @@ export declare class ToolRegistry {
     executeTool(name: string, args: Record<string, unknown>, options?: {
         timeoutMs?: number;
         signal?: AbortSignal;
+        ctx?: ToolContext;
     }): Promise<ToolResult>;
     listTools(): string[];
     listToolsDetailed(): RegisteredTool[];

package/dist/types.d.ts

@@ -2,7 +2,7 @@
  * Core type definitions for the code-shell orchestration framework.
  */
 export interface ContentBlock {
-    type: "text" | "tool_use" | "tool_result" | "image";
+    type: "text" | "tool_use" | "tool_result" | "image" | "reasoning";
     text?: string;
     id?: string;
     name?: string;
@@ -14,6 +14,7 @@ export interface ContentBlock {
         media_type: string;
         data: string;
     };
+    reasoningContent?: string;
 }
 export interface Message {
     role: "system" | "user" | "assistant" | "tool";
@@ -124,14 +125,25 @@ export interface ApprovalRequest {
     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 {
@@ -148,6 +160,9 @@ export interface TaskInfo {
     status: "pending" | "in_progress" | "completed" | "stopped";
 }
 export type StreamEvent = {
+    type: "session_started";
+    sessionId: string;
+} | {
     type: "stream_request_start";
     turnNumber: number;
     agentId?: string;
@@ -159,6 +174,11 @@ export type StreamEvent = {
     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;
@@ -197,6 +217,12 @@ export type StreamEvent = {
 } | {
     type: "tool_summary";
     summary: string;
+} | {
+    type: "context_compact";
+    strategy: "summary" | "window" | "snip" | "emergency";
+    before: number;
+    after: number;
+    agentId?: string;
 };
 export type StreamCallback = (event: StreamEvent) => void | Promise<void>;
 export interface LLMConfig {
@@ -216,6 +242,7 @@ export interface LLMResponse {
     toolCalls: ToolCall[];
     usage?: TokenUsage;
     stopReason?: string;
+    reasoningContent?: string;
 }
 export interface LLMStreamChunk {
     type: "text" | "tool_use_start" | "tool_use_delta" | "tool_use_end" | "stop";

package/dist/ui/App.d.ts

@@ -10,5 +10,5 @@ interface AppProps {
     /** 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 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

@@ -25,7 +25,7 @@ export declare function AgentBlockEnd({ description, error, isLast }: AgentBlock
 /**
  * Tree line prefix for nested content under an agent.
  */
-export declare function NestedPrefix({ children, isLast }: {
+export declare function NestedPrefix({ children, isLast, }: {
     children: React.ReactNode;
     isLast?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,7 @@
+interface AskUserPromptProps {
+    question: string;
+    onAnswer: (answer: string) => void;
+    onCancel: () => void;
+}
+export declare function AskUserPrompt({ question, onAnswer, onCancel }: AskUserPromptProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -1,22 +1,26 @@
 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 }: MessageContentProps): import("react/jsx-runtime").JSX.Element | null;
+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 }: ErrorMessageProps): import("react/jsx-runtime").JSX.Element;
+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 }: {
+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

@@ -0,0 +1,35 @@
+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;
+};
+interface ModelManagerProps {
+    entries: ProtocolModelEntry[];
+    snapshot: SnapshotInfo;
+    arenaParticipants: ArenaParticipantEntry[];
+    /** 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>;
+    onClose: () => void;
+}
+export declare function ModelManager({ entries, snapshot, arenaParticipants, onSwitch, onSync, onSaveArena, onClose, }: ModelManagerProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1,7 @@
+import { type OnboardingResult } from "../../cli/onboarding.js";
+interface OnboardingPromptProps {
+    onComplete: (result: OnboardingResult) => void;
+    onCancel: () => void;
+}
+export declare function OnboardingPrompt({ onComplete, onCancel }: OnboardingPromptProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

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

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

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

@@ -0,0 +1,14 @@
+export interface SessionPickerEntry {
+    sessionId: string;
+    startedAt: number;
+    turnCount: number;
+    preview?: string;
+    cwd?: string;
+}
+interface SessionPickerProps {
+    entries: SessionPickerEntry[];
+    onSelect: (sessionId: string) => void;
+    onCancel: () => void;
+}
+export declare function SessionPicker({ entries, onSelect, onCancel }: SessionPickerProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -12,11 +12,13 @@ interface StatusLineProps {
     tokens: number;
     cost: number;
     sessionId?: string;
-    contextPercent?: number;
+    /** Last known prompt tokens from completed turn. Live streaming is added on top. */
+    baseContextTokens?: number;
+    maxContextTokens?: number;
     gitBranch?: string;
     isRunning?: boolean;
     streamingCharsRef?: MutableRefObject<number>;
     runStartRef?: MutableRefObject<number>;
 }
-export declare function StatusLine({ model, effort, tokens, cost, sessionId, contextPercent, gitBranch, isRunning, streamingCharsRef, runStartRef, }: StatusLineProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusLine({ model, effort, tokens, cost, sessionId, baseContextTokens, maxContextTokens, gitBranch, isRunning, streamingCharsRef, runStartRef, }: StatusLineProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -7,7 +7,7 @@
  * version uses the lightweight ui/theme.ts context.
  */
 import React from "react";
-import { type BoxProps } from "../../ink/index.js";
+import { type BoxProps } from "../../render/index.js";
 import type { Theme } from "../../utils/theme.js";
 type ColorProp = keyof Theme | string;
 export interface ThemedBoxProps extends Omit<BoxProps, "borderColor" | "backgroundColor"> {

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

@@ -16,6 +16,13 @@ interface ToolCallResultProps {
     nested?: boolean;
     /** When true, show full output instead of collapsed preview. */
     expanded?: boolean;
+    /**
+     * When true, render as a single dim line — used for transient
+     * "this attempt failed and was retried" cases (e.g. Arena's
+     * fail-fast endpoint check) so the feed isn't swamped with scary
+     * red error cards for what was just a parameter fix-up.
+     */
+    compact?: boolean;
 }
-export declare function ToolCallResult({ toolName, result, error, nested, expanded: forceExpand }: ToolCallResultProps): import("react/jsx-runtime").JSX.Element;
+export declare function ToolCallResult({ toolName, result, error, nested, expanded: forceExpand, compact, }: ToolCallResultProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,5 @@
+interface WelcomeTipsProps {
+    cwd: string;
+}
+export declare function WelcomeTips({ cwd }: WelcomeTipsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ui/onboarding-runner.d.ts

@@ -0,0 +1,2 @@
+import type { OnboardingResult } from "../cli/onboarding.js";
+export declare function runInkOnboarding(): Promise<OnboardingResult | null>;

package/dist/ui/store.d.ts

@@ -17,6 +17,7 @@ type ChatEntryData = {
     type: "tool_start";
     toolName: string;
     args: Record<string, unknown>;
+    toolCallId?: string;
     agentId?: string;
 } | {
     type: "tool_running";

package/dist/{updater-2N6745WR.cjs → updater-J7L7R6BY.cjs}

@@ -8,7 +8,7 @@ var require_package = _chunkIJSHQGMPcjs.__commonJS.call(void 0, {
   "package.json"(exports, module) {
     module.exports = {
       name: "@cjhyy/code-shell",
-      version: "0.1.0-alpha.1",
+      version: "0.1.0-alpha.3",
       description: "Code Shell \u2014 general-purpose agent orchestration framework with a terminal coding preset",
       type: "module",
       main: "./dist/index.cjs",
@@ -52,9 +52,11 @@ var require_package = _chunkIJSHQGMPcjs.__commonJS.call(void 0, {
         access: "public"
       },
       scripts: {
-        build: "bun run tsup && bun run build:dts",
+        preinstall: "node scripts/check-node.cjs",
+        build: "bun run sync-models && bun run tsup && bun run build:dts",
         "build:dts": "tsc --emitDeclarationOnly --declaration --outDir dist || true",
-        dev: "bun run src/cli/main.ts",
+        "sync-models": "bun run scripts/sync-models.ts",
+        dev: "CODE_SHELL_DEV=1 bun run src/cli/main.ts",
         test: "bun test",
         "test:watch": "bun test --watch",
         lint: "eslint src/",
@@ -63,10 +65,11 @@ var require_package = _chunkIJSHQGMPcjs.__commonJS.call(void 0, {
         prepublishOnly: "bun run build"
       },
       engines: {
-        node: ">=20"
+        node: ">=20.10"
       },
       files: [
         "dist",
+        "scripts/check-node.cjs",
         "README.md",
         "LICENSE",
         "CHANGELOG.md"
@@ -100,7 +103,6 @@ var require_package = _chunkIJSHQGMPcjs.__commonJS.call(void 0, {
         "get-east-asian-width": "^1.5.0",
         glob: "^11.0.0",
         "indent-string": "^5.0.0",
-        ink: "^6.8.0",
         "lodash-es": "^4.17.23",
         marked: "^17.0.5",
         "marked-terminal": "^7.3.0",

package/dist/{updater-PV7FKSUI.js → updater-LDBNYCAO.js}

@@ -8,7 +8,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@cjhyy/code-shell",
-      version: "0.1.0-alpha.1",
+      version: "0.1.0-alpha.3",
       description: "Code Shell \u2014 general-purpose agent orchestration framework with a terminal coding preset",
       type: "module",
       main: "./dist/index.cjs",
@@ -52,9 +52,11 @@ var require_package = __commonJS({
         access: "public"
       },
       scripts: {
-        build: "bun run tsup && bun run build:dts",
+        preinstall: "node scripts/check-node.cjs",
+        build: "bun run sync-models && bun run tsup && bun run build:dts",
         "build:dts": "tsc --emitDeclarationOnly --declaration --outDir dist || true",
-        dev: "bun run src/cli/main.ts",
+        "sync-models": "bun run scripts/sync-models.ts",
+        dev: "CODE_SHELL_DEV=1 bun run src/cli/main.ts",
         test: "bun test",
         "test:watch": "bun test --watch",
         lint: "eslint src/",
@@ -63,10 +65,11 @@ var require_package = __commonJS({
         prepublishOnly: "bun run build"
       },
       engines: {
-        node: ">=20"
+        node: ">=20.10"
       },
       files: [
         "dist",
+        "scripts/check-node.cjs",
         "README.md",
         "LICENSE",
         "CHANGELOG.md"
@@ -100,7 +103,6 @@ var require_package = __commonJS({
         "get-east-asian-width": "^1.5.0",
         glob: "^11.0.0",
         "indent-string": "^5.0.0",
-        ink: "^6.8.0",
         "lodash-es": "^4.17.23",
         marked: "^17.0.5",
         "marked-terminal": "^7.3.0",

package/dist/utils/debug.d.ts

@@ -1,35 +1,26 @@
 /**
- * Debug logging — category-filtered, leveled output with file support.
+ * Debug logging — thin facade over the unified logger.
  *
- * Activation:
- *   CODE_SHELL_DEBUG=1          — all debug output to stderr
- *   --debug                     — all debug output to file (~/.code-shell/debug/<session>.txt)
- *   --debug=api,hooks           — filtered categories only
- *   --debug-file=/path/to/file  — explicit output file
- *   --debug-to-stderr / -d2e    — force stderr output
+ * Historically this module wrote to ~/.code-shell/debug/<session>.txt.
+ * It now delegates to logger so all output lands in ~/.code-shell/logs/.
  *
- * Levels: verbose < debug < info < warn < error
- *   Set CODE_SHELL_DEBUG_LOG_LEVEL=verbose to include high-volume diagnostics.
+ * Activation knobs (still honored, parsed inside logger):
+ *   CODE_SHELL_LOG_LEVEL=debug        — explicit level
+ *   CODE_SHELL_DEBUG=mcp,api          — category filter
+ *   --debug                           — local dev: defaults to debug level
+ *   --debug=mcp,api                   — category filter (CLI form)
+ *   --debug-to-stderr / -d2e          — echo to stderr instead of file
  */
-export type DebugLogLevel = "verbose" | "debug" | "info" | "warn" | "error";
-type DebugFilter = {
-    categories: Set<string>;
-};
+import { type LogLevel } from "../logging/logger.js";
+export type DebugLogLevel = "verbose" | LogLevel;
 export declare function setDebugSessionId(id: string): void;
-export declare function getMinDebugLogLevel(): DebugLogLevel;
 export declare function isDebugMode(): boolean;
-/**
- * Enable debug logging mid-session (e.g. via /debug command).
- * Returns true if logging was already active.
- */
 export declare function enableDebugLogging(): boolean;
 export declare function isDebugToStdErr(): boolean;
-export declare function getDebugFilter(): DebugFilter | null;
-export declare function getDebugFilePath(): string | null;
+export declare function getMinDebugLogLevel(): DebugLogLevel;
 /**
- * Log a debug message with optional level.
- * Output goes to stderr (--debug-to-stderr / CODE_SHELL_DEBUG=1)
- * or to a file (~/.code-shell/debug/<session>.txt).
+ * Log a debug message. Optional level via opts.level.
+ * Embedded `[category]` tags are extracted into the structured `cat` field.
  */
 export declare function logForDebugging(message: string, opts?: {
     level?: DebugLogLevel | string;
@@ -40,18 +31,11 @@ export declare function logForDebugging(message: string, opts?: {
  */
 export declare function debugCategory(category: string): (msg: string) => void;
 /**
- * Time a function and log the duration.
+ * Time a function and log the duration at debug level.
  */
 export declare function debugTiming<T>(label: string, fn: () => T | Promise<T>): Promise<T>;
-/**
- * CC compatibility: log errors for Anthropic internal users.
- * In Code Shell this is a debug-level error log.
- */
 export declare function logAntError(msg: string, _err?: unknown): void;
-/**
- * CC compatibility exports.
- */
-export declare function setHasFormattedOutput(_value: boolean): void;
+export declare function getDebugFilePath(): string | null;
+export declare function setHasFormattedOutput(_v: boolean): void;
 export declare function getHasFormattedOutput(): boolean;
 export declare function flushDebugLogs(): Promise<void>;
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjhyy/code-shell",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Code Shell — general-purpose agent orchestration framework with a terminal coding preset",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -44,9 +44,11 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bun run tsup && bun run build:dts",
+    "preinstall": "node scripts/check-node.cjs",
+    "build": "bun run sync-models && bun run tsup && bun run build:dts",
     "build:dts": "tsc --emitDeclarationOnly --declaration --outDir dist || true",
-    "dev": "bun run src/cli/main.ts",
+    "sync-models": "bun run scripts/sync-models.ts",
+    "dev": "CODE_SHELL_DEV=1 bun run src/cli/main.ts",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "lint": "eslint src/",
@@ -55,10 +57,11 @@
     "prepublishOnly": "bun run build"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20.10"
   },
   "files": [
     "dist",
+    "scripts/check-node.cjs",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -92,7 +95,6 @@
     "get-east-asian-width": "^1.5.0",
     "glob": "^11.0.0",
     "indent-string": "^5.0.0",
-    "ink": "^6.8.0",
     "lodash-es": "^4.17.23",
     "marked": "^17.0.5",
     "marked-terminal": "^7.3.0",

package/scripts/check-node.cjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+const REQUIRED_MAJOR = 20;
+const REQUIRED_MINOR = 10;
+
+const [major, minor] = process.versions.node.split('.').map(Number);
+
+if (major < REQUIRED_MAJOR || (major === REQUIRED_MAJOR && minor < REQUIRED_MINOR)) {
+  const red = (s) => `\x1b[31m${s}\x1b[0m`;
+  const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+  console.error('');
+  console.error(red(bold('✖ @cjhyy/code-shell requires Node.js >= 20.10')));
+  console.error(`  current: ${process.versions.node}`);
+  console.error('');
+  console.error('  Some dependencies use ESM import attributes (`with { type: "json" }`),');
+  console.error('  which Node 16/18 do not support.');
+  console.error('');
+  console.error('  Fix: install Node 20.10+ (or 22 LTS) via nvm:');
+  console.error('    nvm install 22 && nvm use 22');
+  console.error('');
+  process.exit(1);
+}