@cline/core 0.0.64 → 0.0.65

package/dist/extensions/tools/definitions.d.ts

@@ -3,7 +3,7 @@
  *
  * Factory functions for creating the default tools.
  */
-import { type AgentTool } from "@cline/shared";
+import { type AgentTool, type ShellKind } from "@cline/shared";
 import { type ApplyPatchInput, type AskQuestionInput, type EditFileInput, type FetchWebContentInput, type ReadFilesInput, type SearchCodebaseInput, type SkillsInput, type SubmitInput } from "./schemas";
 import type { ApplyPatchExecutor, AskQuestionExecutor, CreateDefaultToolsOptions, DefaultToolsConfig, EditorExecutor, FileReadExecutor, SearchExecutor, ShellExecutor, SkillsExecutorWithMetadata, ToolOperationResult, VerifySubmitExecutor, WebFetchExecutor } from "./types";
 /**
@@ -18,13 +18,31 @@ export declare function createReadFilesTool(executor: FileReadExecutor, config?:
  * Performs regex pattern searches across the codebase.
  */
 export declare function createSearchTool(executor: SearchExecutor, config?: Pick<DefaultToolsConfig, "cwd" | "searchTimeoutMs">): AgentTool<SearchCodebaseInput, ToolOperationResult[]>;
+/**
+ * Build the run_commands tool description for the shell that will actually
+ * execute the commands. The shell kind decides the syntax guidance (quoting,
+ * sequencing, heredocs), and isWindows adds environment context for POSIX
+ * shells running on a Windows host (e.g. Git Bash).
+ */
+export declare function buildRunCommandsDescription(shellKind: ShellKind, isWindows: boolean): string;
 /**
  * Create the run_commands shell tool for the current platform.
  *
  * This preserves the SDK's platform-specific prompting/schema choices while
- * exposing a single generic shell-tool factory for host integrations.
+ * exposing a single generic shell-tool factory for host integrations. Pass
+ * config.shell (matching the executor's shell) so the syntax guidance in the
+ * tool description matches the shell that actually runs the commands.
+ *
+ * config.shell may be a provider function instead of a string. The runtime
+ * reads `description` when building each model request, so a provider is
+ * consulted at that boundary: a shell change made while the model is
+ * generating does not affect the request in flight, and the next request
+ * names the new shell. The provider must return the shell the executor will
+ * use for tool calls issued by that next request.
  */
-export declare function createShellTool(executor: ShellExecutor, config?: Pick<DefaultToolsConfig, "cwd" | "bashTimeoutMs">): AgentTool<unknown, ToolOperationResult[]>;
+export declare function createShellTool(executor: ShellExecutor, config?: Pick<DefaultToolsConfig, "cwd" | "bashTimeoutMs"> & {
+    shell?: string | (() => string);
+}): AgentTool<unknown, ToolOperationResult[]>;
 /**
  * Create the fetch_web_content tool
  *

package/dist/extensions/tools/index.d.ts

@@ -14,7 +14,7 @@ export { type BuiltinToolAvailabilityContext, getCoreAcpToolNames, getCoreBuilti
 export { type ApplyPatchInput, ApplyPatchInputSchema, type AskQuestionInput, AskQuestionInputSchema, type EditFileInput, EditFileInputSchema, type FetchWebContentInput, FetchWebContentInputSchema, type ReadFileRequest, ReadFileRequestSchema, type ReadFilesInput, ReadFilesInputSchema, type RunCommandsInput, RunCommandsInputSchema, type SearchCodebaseInput, SearchCodebaseInputSchema, type SkillsInput, SkillsInputSchema, type StructuredCommandInput, StructuredCommandInputSchema, type SubmitInput, SubmitInputSchema, type WebFetchRequest, WebFetchRequestSchema, } from "./schemas";
 export { TEAM_TOOL_NAMES } from "./team/team-tools";
 export type { ApplyPatchExecutor, AskQuestionExecutor, CreateDefaultToolsOptions, DefaultToolName, DefaultToolsConfig, EditorExecutor, FileReadExecutor, SearchExecutor, ShellExecutor, SkillsExecutor, SkillsExecutorSkillMetadata, SkillsExecutorWithMetadata, ToolExecutors, ToolOperationResult, VerifySubmitExecutor, WebFetchExecutor, } from "./types";
-import type { AgentTool } from "@cline/shared";
+import { type AgentTool } from "@cline/shared";
 import { type DefaultExecutorsOptions } from "./executors/index";
 import type { CreateDefaultToolsOptions, ToolExecutors } from "./types";
 /**
@@ -22,11 +22,16 @@ import type { CreateDefaultToolsOptions, ToolExecutors } from "./types";
  */
 export interface CreateBuiltinToolsOptions extends Omit<CreateDefaultToolsOptions, "executors"> {
     /**
-     * Configuration for the built-in executors
+     * Configuration for the built-in executors. `bash.shell` is used when the
+     * top-level `shell` option is not set; the top-level option takes precedence.
      */
     executorOptions?: DefaultExecutorsOptions;
     /**
-     * Optional executor overrides/additions for tools without built-ins
+     * Optional executor overrides/additions for tools without built-ins.
+     * An overriding `bash` executor replaces the built-in one wholesale: it
+     * decides its own shell, and the resolved `shell` option only shapes the
+     * run_commands description. Overriders must honor that shell themselves
+     * to keep the description truthful.
      */
     executors?: Partial<ToolExecutors>;
 }

package/dist/extensions/tools/team/delegated-agent.d.ts

@@ -1,7 +1,7 @@
 import type { AgentConfig, AgentEvent, AgentHooks, AgentTool, BasicLogger, HookErrorMode, ITelemetryService, ToolApprovalRequest, ToolApprovalResult } from "@cline/shared";
 import { SessionRuntime } from "../../../runtime/orchestration/session-runtime-orchestrator";
 type AgentExtension = NonNullable<AgentConfig["extensions"]>[number];
-export type DelegatedAgentConnectionConfig = Pick<AgentConfig, "providerId" | "modelId" | "apiKey" | "baseUrl" | "headers" | "providerConfig" | "knownModels" | "thinking" | "reasoningEffort" | "thinkingBudgetTokens" | "maxTokensPerTurn" | "temperature">;
+export type DelegatedAgentConnectionConfig = Pick<AgentConfig, "providerId" | "modelId" | "apiKey" | "baseUrl" | "headers" | "onAuthError" | "providerConfig" | "knownModels" | "thinking" | "reasoningEffort" | "thinkingBudgetTokens" | "maxTokensPerTurn" | "temperature">;
 export interface DelegatedAgentRuntimeConfig extends DelegatedAgentConnectionConfig {
     cwd?: string;
     providerId: string;

package/dist/extensions/tools/types.d.ts

@@ -201,6 +201,13 @@ export interface DefaultToolsConfig {
      * Current working directory for tools that need it
      */
     cwd?: string;
+    /**
+     * Shell executable (name or full path) the run_commands executor will use.
+     * The tool description tells the model which shell syntax to write, so this
+     * must match the shell configured on the executor.
+     * @default getDefaultShell(process.platform) — "/bin/bash" on Unix, "powershell" on Windows
+     */
+    shell?: string;
     /**
      * Timeout for file read operations in milliseconds
      * @default 10000