@cline/core 0.0.46 → 0.0.47-nightly.1781493618

package/dist/ClineCore.d.ts

@@ -1,5 +1,6 @@
 import type { ClineCoreAutomationApi, ClineCoreListHistoryOptions, ClineCoreOptions, ClineCoreSettingsApi, ClineCoreStartInput, RestoreInput, RestoreResult } from "./cline-core/types";
 import type { PendingPromptsServiceApi, RuntimeHost, RuntimeHostSubscribeOptions, SessionModelRuntimeService, SessionUsageRuntimeService, StartSessionInput, StartSessionResult } from "./runtime/host/runtime-host";
+import { FeatureFlagsService } from "./services/feature-flags";
 import type { CoreSessionEvent } from "./types/events";
 import type { SessionHistoryRecord } from "./types/sessions";
 export type { ClineAutomationEventIngressResult, ClineAutomationEventLog, ClineAutomationEventSuppression, ClineAutomationListEventsOptions, ClineAutomationListRunsOptions, ClineAutomationListSpecsOptions, ClineAutomationRun, ClineAutomationRunStatus, ClineAutomationSpec, ClineCoreAutomationApi, ClineCoreAutomationOptions, ClineCoreListHistoryOptions, ClineCoreOptions, ClineCoreSettingsApi, ClineCoreStartInput, HubOptions, RemoteOptions, RestoreInput, RestoreOptions, RestoreResult, RuntimeHostMode, StartSessionBootstrap, } from "./cline-core/types";
@@ -19,6 +20,7 @@ export declare class ClineCore {
     readonly runtimeAddress: string | undefined;
     readonly automation: ClineCoreAutomationApi;
     readonly settings: ClineCoreSettingsApi;
+    readonly featureFlags: FeatureFlagsService;
     readonly pendingPrompts: PendingPromptsServiceApi;
     private readonly host;
     private readonly prepare;

package/dist/cline-core/types.d.ts

@@ -7,6 +7,7 @@ import type { RuntimeCapabilities } from "../runtime/capabilities";
 import type { SessionHistoryListOptions } from "../runtime/host/history";
 import type { SessionBackend } from "../runtime/host/host";
 import type { LocalRuntimeStartOptions, RuntimeHostMode, StartSessionInput, StartSessionResult } from "../runtime/host/runtime-host";
+import type { FeatureFlagsService } from "../services/feature-flags";
 import type { CoreSessionConfig } from "../types/config";
 import type { SessionMessagesArtifactUploader } from "../types/session";
 export type { RuntimeHostMode } from "../runtime/host/runtime-host";
@@ -160,6 +161,11 @@ export interface ClineCoreOptions {
      * If omitted, telemetry is a no-op.
      */
     telemetry?: ITelemetryService;
+    /**
+     * Feature flags service for this ClineCore instance.
+     * If omitted, Core uses a no-op provider with default flag values.
+     */
+    featureFlags?: FeatureFlagsService;
     /**
      * Optional structured logger for core-side operational diagnostics such as
      * runtime-host selection and fallback decisions.

package/dist/extensions/tools/executors/bash.d.ts

@@ -4,6 +4,11 @@
  * Built-in implementation for running shell commands using Node.js spawn.
  */
 import type { BashExecutor } from "../types";
+export declare class CommandExitError extends Error {
+    readonly exitCode: number;
+    readonly output: string;
+    constructor(exitCode: number, output: string);
+}
 /**
  * Options for the bash executor
  */
@@ -19,8 +24,17 @@ export interface BashExecutorOptions {
      */
     timeoutMs?: number;
     /**
-     * Maximum output size in bytes
-     * @default 1_000_000 (1MB)
+     * Maximum output kept, in characters. Output beyond this is
+     * middle-truncated: the head and tail are preserved and the middle is
+     * elided, since build and test failures usually live at the end of the
+     * output.
+     * @default 48_000 — see MAX_COMMAND_OUTPUT_CHARS in output-limits.ts
+     */
+    maxOutputChars?: number;
+    /**
+     * @deprecated Misnamed — the limit was always enforced in characters,
+     * not bytes. Use {@link maxOutputChars}; this alias is honored when
+     * maxOutputChars is not set.
      */
     maxOutputBytes?: number;
     /**

package/dist/extensions/tools/executors/output-limits.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared caps for how much tool output may enter the conversation. Every
+ * character returned by an executor is re-sent to the model on each
+ * subsequent request, so oversized outputs cost quadratically over the
+ * remaining run. Limits are measured in characters (UTF-16 code units),
+ * which tracks token cost more closely than bytes and is what JS strings
+ * measure exactly. Executors enforce these caps; tool descriptions
+ * reference them so the model pages or narrows instead of retrying.
+ *
+ * Truncation notices always live in the preserved head/tail of an entry,
+ * never in the elided middle. Provider-request building may re-truncate
+ * long strings with its own (possibly tighter) middle-cut backstop
+ * (session/services/message-builder.ts); keeping the notices at the edges
+ * means the recovery guidance survives that cut too.
+ */
+/** Max characters of command output kept; beyond this the middle is elided. */
+export declare const MAX_COMMAND_OUTPUT_CHARS = 48000;
+/** Max lines returned per file read when the range is larger or absent. */
+export declare const MAX_READ_LINES = 2000;
+/** Max characters kept per line in file reads (defangs minified files). */
+export declare const MAX_LINE_CHARS = 2000;
+/** Max characters returned per file read window. */
+export declare const MAX_READ_OUTPUT_CHARS = 48000;
+/** Max characters returned per search query; beyond this the middle is elided. */
+export declare const MAX_SEARCH_OUTPUT_CHARS = 48000;

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

@@ -16,3 +16,16 @@ export declare function formatReadFileQuery(request: ReadFileRequest): string;
 export declare function getReadFileRangeError(request: ReadFileRequest): string | null;
 export declare function normalizeRunCommandsInput(input: unknown): Array<string | StructuredCommandInput>;
 export declare function formatRunCommandQuery(command: string | StructuredCommandInput): string;
+/**
+ * Max characters of the executed command echoed back in the tool result's
+ * `query` field. The full command already exists in the assistant tool-call
+ * input, so repeating it in the result only duplicates tokens in the
+ * provider request (expensive for large heredoc/file-generation commands).
+ */
+export declare const RUN_COMMAND_QUERY_PREVIEW_LIMIT = 200;
+/**
+ * Bound the command echo placed in a provider-facing tool result.
+ * Short commands pass through unchanged; long commands keep a short
+ * prefix plus a truncation note so the result is still identifiable.
+ */
+export declare function formatRunCommandQueryPreview(command: string | StructuredCommandInput): string;

package/dist/hub/client/index.d.ts

@@ -1,4 +1,5 @@
 import { type HubCommandEnvelope, type HubEventEnvelope, type HubReplyEnvelope } from "@cline/shared";
+import { type HubOwnerContext } from "../discovery";
 export interface HubClientOptions {
     url: string;
     clientId?: string;
@@ -80,7 +81,7 @@ export declare function verifyHubConnection(url: string, options?: Pick<HubClien
 export declare function resolveCompatibleLocalHubUrl(options?: LocalHubResolutionOptions): Promise<string | undefined>;
 export declare function ensureCompatibleLocalHubUrl(options?: LocalHubResolutionOptions): Promise<string | undefined>;
 export declare function requestHubShutdown(url: string, authToken?: string): Promise<boolean>;
-export declare function stopLocalHubServerGracefully(): Promise<boolean>;
+export declare function stopLocalHubServerGracefully(owner?: HubOwnerContext): Promise<boolean>;
 export declare function restartLocalHubIfIdleAfterStartupTimeout(options: {
     url: string;
     workspaceRoot?: string;