@cline/core 0.0.64 → 0.0.65-nightly.1784776435

package/dist/cron/service/schedule-service.d.ts

@@ -1,4 +1,4 @@
-import type { BasicLogger, ChatRunTurnRequest, ChatStartSessionArtifacts, ChatStartSessionRequest, HubScheduleCreateInput, HubScheduleUpdateInput, ScheduleExecutionRecord, ScheduleExecutionStatus, ScheduleRecord } from "@cline/shared";
+import { type BasicLogger, type ChatRunTurnRequest, type ChatStartSessionArtifacts, type ChatStartSessionRequest, type HubScheduleCreateInput, type HubScheduleUpdateInput, type ScheduleExecutionRecord, type ScheduleExecutionStatus, type ScheduleRecord } from "@cline/shared";
 type HubScheduleTurnResult = {
     text: string;
     usage?: {
@@ -82,6 +82,7 @@ export declare class HubScheduleService {
     getSchedule(scheduleId: string): ScheduleRecord | undefined;
     listSchedules(options?: ListSchedulesOptions): ScheduleRecord[];
     updateSchedule(scheduleId: string, updates: HubScheduleUpdateInput): ScheduleRecord | undefined;
+    private validateScheduleTiming;
     deleteSchedule(scheduleId: string): boolean;
     pauseSchedule(scheduleId: string): ScheduleRecord | undefined;
     resumeSchedule(scheduleId: string): ScheduleRecord | undefined;

package/dist/cron/store/sqlite-cron-store.d.ts

@@ -1,4 +1,4 @@
-import type { AutomationEventEnvelope, CronSpec, CronSpecExtensionKind, CronTriggerKind, HubScheduleCreateInput, HubScheduleUpdateInput } from "@cline/shared";
+import { type AutomationEventEnvelope, type CronSpec, type CronSpecExtensionKind, type CronTriggerKind, type HubScheduleCreateInput, type HubScheduleUpdateInput } from "@cline/shared";
 /**
  * Generalized cron/automation store backed by `cron.db`. Sessions stay in
  * their own database (see @cline/shared `ensureSessionSchema`). cron_runs
@@ -170,8 +170,10 @@ export declare class SqliteCronStore {
         tags?: string[];
     }): CronSpecRecord[];
     updateHubSchedule(scheduleId: string, updates: HubScheduleUpdateInput): CronSpecRecord | undefined;
+    private initializeHubScheduleNextRun;
     deleteHubSchedule(scheduleId: string): boolean;
     enqueueHubScheduleRun(scheduleId: string, triggerKind?: "manual" | "retry"): CronRunRecord | undefined;
+    private consumeOneOffWithManualRun;
     listEventSpecsForType(eventType: string): CronSpecRecord[];
     upsertSpec(input: UpsertSpecInput): UpsertSpecResult;
     private insertSpecRow;
@@ -217,9 +219,10 @@ export declare class SqliteCronStore {
         triggerEventId: string;
         scheduledFor: string;
     }): CronRunRecord | undefined;
-    hasOneOffRunForRevision(specId: string, revision: number): boolean;
+    hasConsumedOneOffRevision(specId: string, revision: number): boolean;
     enqueueRun(input: EnqueueRunInput): CronRunRecord;
     cancelQueuedRunsForSpec(specId: string): number;
+    private cancelQueuedOneOffRunsForSpec;
     claimDueRuns(options: ClaimRunOptions): ClaimedCronRun[];
     renewClaim(runId: string, claimToken: string, leaseUntilAt: string): boolean;
     completeRun(runId: string, update: {

package/dist/extensions/context/basic-compaction.d.ts

@@ -1,6 +1,15 @@
-import { type BasicLogger } from "@cline/shared";
+import type { BasicLogger } from "@cline/shared";
 import type { CoreCompactionContext, CoreCompactionResult } from "../../types/config";
 import { type EstimateMessageTokens } from "./compaction-shared";
+/**
+ * Fold the conversation history without a summarizer model. Typed user
+ * prompts always survive. The latest typed turn keeps its newest messages
+ * verbatim within the token target, dropping only the oldest ones (the
+ * kept suffix starts at an assistant message so no tool pair is split).
+ * Older turns keep their concluding assistant answer when it fits, newest
+ * turns first. Everything else is dropped and re-surfaced as dropped-work
+ * summaries attached to the surviving prompts.
+ */
 export declare function runBasicCompaction(options: {
     context: CoreCompactionContext;
     estimateMessageTokens: EstimateMessageTokens;

package/dist/extensions/context/compaction-shared.d.ts

@@ -51,6 +51,26 @@ export declare function findCutIndex(messages: MessageWithMetadata[], preserveRe
 export declare function collectPaths(value: unknown): string[];
 export declare function mergeUnique(base: string[], next: Iterable<string>): string[];
 export declare function extractFileOps(messages: MessageWithMetadata[]): FileOperationSummary;
+/** Commands longer than this are truncated in dropped-work summaries. */
+export declare const COMMAND_SUMMARY_CHAR_LIMIT = 100;
+/**
+ * Compact record of the tool work performed inside a span of dropped
+ * messages: which files were read and edited (with line ranges when
+ * known) and which commands ran.
+ */
+export interface ToolActivitySummary {
+    readFiles: string[];
+    editedFiles: string[];
+    commands: string[];
+}
+export declare function hasToolActivity(summary: ToolActivitySummary): boolean;
+/**
+ * Summarize the tool work inside a span of messages that compaction is
+ * dropping. Read ranges come from read_files inputs; edited ranges come
+ * from the numbered diff in the matching editor result when present.
+ */
+export declare function summarizeToolActivity(messages: MessageWithMetadata[]): ToolActivitySummary;
+export declare function formatToolActivitySummary(summary: ToolActivitySummary): string;
 export declare function renderFilesSection(fileOps: FileOperationSummary): string;
 export declare function ensureFilesSection(summary: string, fileOps: FileOperationSummary): string;
 export declare function buildSummaryRequest(options: {

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