@cjhyy/code-shell-core 0.6.0-rc.4 → 0.6.0-rc.5

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Public API exports.
  */
-export declare const VERSION = "0.6.0-rc.4";
+export declare const VERSION = "0.6.0-rc.5";
 export type { Message, ContentBlock, ToolDefinition, ToolCall, ToolResult, RegisteredTool, TranscriptEvent, TranscriptEventType, SessionState, SessionStatus, TokenUsage, CompiledInput, PermissionDecision, PermissionMode, PermissionRule, TurnPhase, TurnResult, TerminalReason, StreamEvent, StreamCallback, LLMConfig, ClientDefaults, LLMResponse, Settings, MCPServerConfig, } from "./types.js";
 export { FrameworkError, LLMError, LLMRateLimitError, ContextLimitError, ToolError, ToolNotFoundError, ToolExecutionError, ToolTimeoutError, PermissionDeniedError, SessionError, TranscriptError, ConfigError, SandboxUnavailableError, } from "./exceptions.js";
 export { Engine, loadAgentDefinitionsForCwd } from "./engine/engine.js";

package/dist/index.js

@@ -3,7 +3,7 @@
  *
  * Public API exports.
  */
-export const VERSION = "0.6.0-rc.4";
+export const VERSION = "0.6.0-rc.5";
 // ─── Exceptions ──────────────────────────────────────────────────
 export { FrameworkError, LLMError, LLMRateLimitError, ContextLimitError, ToolError, ToolNotFoundError, ToolExecutionError, ToolTimeoutError, PermissionDeniedError, SessionError, TranscriptError, ConfigError, SandboxUnavailableError, } from "./exceptions.js";
 // ─── Engine (primary API) ────────────────────────────────────────

package/dist/prompt/sections/base.md

@@ -31,6 +31,7 @@ When you encounter an obstacle, do not use destructive actions as a shortcut to
   - To search for files use Glob instead of find or ls
   - To search the content of files, use Grep instead of grep or rg
   - Reserve using the Bash exclusively for system commands and terminal operations that require shell execution.
+ - Shell choice: when Bash is available, use it for ordinary shell commands, git operations, package-manager commands, test/build scripts, and POSIX-style command lines. On Windows, Bash uses Git Bash when it is available, so do not choose PowerShell merely because the OS is Windows. Use PowerShell only when the user explicitly asks for it or the task requires PowerShell-specific cmdlets, Windows APIs, registry access, or `.ps1` behavior.
  - For long-lived processes that don't exit on their own — a dev server (`npm run dev`, `vite`), a watcher, a tunnel — call Bash with `run_in_background: true`. It returns a `shell_id` immediately instead of blocking until a timeout. Then use `BashOutput(shell_id)` to read its logs (e.g. to confirm it started or to see an error), `ListShells()` to see what's running, and `KillShell(shell_id)` to stop it. Never run such a command in the foreground — it will just block until it's killed. Plain one-shot commands (build, test, git) stay foreground.
  - Break down and manage multi-step work with the TodoWrite tool. Pass the complete todo list each call; rewrite it as items move pending → in_progress → completed.
  - You can call multiple tools in a single response. If you intend to call multiple tools and there are no dependencies between them, make all independent tool calls in parallel.

package/dist/protocol/client.d.ts

@@ -23,6 +23,7 @@ export interface AgentRunOptions {
     cwd?: string;
     sessionId?: string;
     permissionMode?: PermissionMode;
+    model?: string;
     planMode?: boolean;
 }
 export type BackgroundAgentCompletedHandler = (sessionId: string, event: BackgroundAgentCompletedEvent) => void;

package/dist/protocol/server.js

@@ -307,6 +307,19 @@ export class AgentServer {
             this.transport.send(createErrorResponse(req.id, ErrorCodes.SessionNotFound, `session ${params.sessionId} does not exist`));
             return;
         }
+        if (params.model !== undefined) {
+            if (typeof params.model !== "string" || params.model.length === 0) {
+                this.transport.send(createErrorResponse(req.id, ErrorCodes.InvalidParams, "model must be a non-empty string"));
+                return;
+            }
+            try {
+                session.requestModelSwitch(params.model);
+            }
+            catch (err) {
+                this.transport.send(createErrorResponse(req.id, ErrorCodes.InvalidParams, err.message));
+                return;
+            }
+        }
         if (typeof params.planMode === "boolean") {
             session.engine.setPlanMode(params.planMode);
         }
@@ -387,6 +400,19 @@ export class AgentServer {
             // Engine.setPermissionMode now keeps this.permissionMode + this.planMode
             // in sync and tools read them via ToolContext.permissionMode/planMode.
         }
+        if (params.model !== undefined) {
+            if (typeof params.model !== "string" || params.model.length === 0) {
+                this.transport.send(createErrorResponse(req.id, ErrorCodes.InvalidParams, "model must be a non-empty string"));
+                return;
+            }
+            try {
+                this.legacyEngine.switchModel(params.model);
+            }
+            catch (err) {
+                this.transport.send(createErrorResponse(req.id, ErrorCodes.InvalidParams, err.message));
+                return;
+            }
+        }
         this.running = true;
         this.abortController = new AbortController();
         this.notify(Methods.Status, { status: "running" });

package/dist/protocol/types.d.ts

@@ -61,6 +61,12 @@ export interface RunParams {
      * When omitted, the engine keeps its configured default.
      */
     permissionMode?: PermissionMode;
+    /**
+     * Per-run model pool key. Applied after the session exists and before the
+     * turn starts, so cold desktop runs don't need a separate pre-run configure
+     * request to a worker that has not been spawned yet.
+     */
+    model?: string;
     /**
      * Workspace trust for this run's project (`cwd`), asserted by the host
      * (desktop main from its trust-store) — never by the renderer. When false,

package/dist/tool-system/builtin/bash.js

@@ -29,8 +29,10 @@ function sandboxMark(backend) {
 export const bashToolDef = {
     name: "Bash",
     description: "Execute a shell command and return its output. " +
-        "Commands run in the user's default shell. Use for system operations, " +
-        "git commands, running tests, installing packages, etc.",
+        "Use for ordinary shell commands, system operations, git commands, " +
+        "package-manager commands, running tests, installing packages, etc. " +
+        "On Windows this tool prefers Git Bash when available, so prefer Bash over " +
+        "PowerShell unless the task needs PowerShell-specific syntax or APIs.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tool-system/builtin/powershell.js

@@ -8,7 +8,10 @@
 import { safeSpawn } from "../../runtime/safe-spawn.js";
 export const powershellToolDef = {
     name: "PowerShell",
-    description: "Execute PowerShell commands. Available on Windows and cross-platform where PowerShell Core is installed.",
+    description: "Execute PowerShell commands. Use only when the user explicitly asks for PowerShell " +
+        "or the task requires PowerShell-specific cmdlets, Windows APIs, registry access, " +
+        "or .ps1 behavior. For ordinary shell/git/package/test commands, prefer Bash " +
+        "(Git Bash on Windows when available).",
     inputSchema: {
         type: "object",
         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjhyy/code-shell-core",
-  "version": "0.6.0-rc.4",
+  "version": "0.6.0-rc.5",
   "description": "Core engine for code-shell — agent orchestration, tool execution, hooks, protocol. UI-agnostic.",
   "type": "module",
   "main": "./dist/index.js",