@cline/shared 0.0.60 → 0.0.62-nightly.1784171655

package/dist/llms/requests.d.ts

@@ -1,21 +1 @@
-import type { ClientName } from "../extensions/context";
-export declare const DEFAULT_REQUEST_HEADERS: Record<string, string>;
-export interface ClineClientRequestHeadersInput {
-    providerId: string;
-    sessionId: string;
-    source?: string;
-    defaultSource: string;
-    clientName?: ClientName;
-    clientVersion?: string;
-    clientVersionHeaderFallback?: string;
-    platform?: string;
-    platformVersion?: string;
-    isMultiRoot?: boolean;
-    coreVersion: string;
-}
-export declare function buildClineClientRequestHeaders(input: ClineClientRequestHeadersInput): Record<string, string> | undefined;
-export interface MergeClineClientRequestHeadersInput extends ClineClientRequestHeadersInput {
-    headers: ReadonlyArray<Record<string, string> | undefined>;
-}
-export declare function mergeClineClientRequestHeaders(input: MergeClineClientRequestHeadersInput): Record<string, string> | undefined;
 export declare function serializeAbortReason(reason: unknown): unknown;

package/dist/llms/tokens.d.ts

@@ -6,3 +6,13 @@
  */
 export declare const CHARS_PER_TOKEN = 3;
 export declare function estimateTokens(chars: number): number;
+export interface TokenEstimatedRequest {
+    systemPrompt?: string;
+    messages: readonly unknown[];
+    tools?: readonly unknown[];
+}
+/**
+ * Estimate the complete provider request payload so request execution and
+ * pre-request policies use the same definition of input utilization.
+ */
+export declare function estimateRequestInputTokens(request: TokenEstimatedRequest): number;

package/dist/parse/jwt.d.ts

@@ -0,0 +1 @@
+export declare function decodeJwtPayload(token?: string): Record<string, unknown> | null;

package/dist/prompt/cline.d.ts

@@ -1,5 +1,24 @@
 import type { WorkspaceContext } from "../extensions/context";
 import type { WorkspaceInfo } from "../session/workspace";
+/**
+ * Explains the <user_input mode="..."> wrapper and <mode_notice> elements the
+ * runtime stamps on user messages (prepareTurnInput / formatUserInputBlock).
+ * Every host that sends through the SDK runtime produces those tags, so every
+ * host's system prompt must explain them: without this section the model has
+ * no idea what the attribute means, and a mid-conversation mode switch is an
+ * invisible system-prompt swap it cannot diff. Included for BOTH modes, since
+ * after a switch the transcript still contains messages tagged with the other
+ * mode.
+ */
+export declare const MODE_TAG_INSTRUCTIONS = "# Plan / Act Modes\n\nUser messages arrive wrapped in a <user_input mode=\"...\"> tag. The mode attribute is the interaction mode the user was in when they sent that message: \"plan\" means plan-mode constraints applied (explore, analyze, and align on a plan -- no edits or state-changing commands), while \"act\" (or \"yolo\") means implementation was allowed. If the mode attribute changes between messages, the user switched modes -- the newest message's mode is what governs right now, regardless of what earlier messages allowed. A <mode_notice> block inside a message marks exactly when such a switch happened.";
+/**
+ * Plan-mode behavioral contract, appended when the session mode is "plan".
+ * run_commands intentionally stays available in plan mode -- it is essential
+ * for read-only investigation -- so the contract must spell out that it is
+ * inspection-only there; the mitigation for plan-mode mutations is prompting
+ * plus mode-switch notices, not tool removal.
+ */
+export declare const PLAN_MODE_INSTRUCTIONS = "# Plan Mode\n\nYou are in Plan mode. Your role is to explore, analyze, and plan -- not to execute.\n\n- Read files, search the codebase, and gather context to understand the problem\n- Ask clarifying questions when requirements are ambiguous\n- Present your plan as a structured outline with clear steps\n- Explain tradeoffs between different approaches when they exist\n- Do NOT edit files, write code, run destructive commands, or make any changes\n- Do NOT implement anything -- focus on understanding and alignment first\n\nThe run_commands tool remains available in plan mode strictly for read-only inspection -- listing files, searching (grep), reading configs, inspecting git history and diffs, checking tool versions, and the like. Never use it to change anything: no creating, modifying, or deleting files, no writing scripts that make changes, and no state-changing commands (installs, migrations, database or schema changes, container commands that mutate state, etc.). If the task requires a mutation, put it in the plan; it happens only after the user switches to act mode.\n\nOnce the user has reviewed your plan and explicitly approved it in a follow-up message, use the switch_to_act_mode tool to switch to act mode and begin implementation. Calling switch_to_act_mode immediately starts execution, so never call it in the same turn you present a plan and never treat the original task request as approval -- end your turn after presenting the plan and wait for the user's response.";
 export declare function processWorkspaceInfo(info: WorkspaceInfo): string;
 /**
  * Options for building the Cline system prompt.

package/dist/prompt/format.d.ts

@@ -15,6 +15,23 @@ export declare function parseUserInputMode(input?: string): "act" | "plan" | "yo
  * display by stripModeNotices at display boundaries.
  */
 export declare function formatModeSwitchNotice(from: "act" | "plan", to: "act" | "plan"): string;
+export type ModeSwitchNotice = {
+    from: "act" | "plan";
+    to: "act" | "plan";
+};
+/**
+ * Tracks a user-initiated mode switch so the next user message can carry a
+ * <mode_notice> marking it. Only UI toggles should be recorded: the
+ * model-initiated switch_to_act_mode path already announces itself via the
+ * continuation prompt. A round trip (plan -> act -> plan before sending
+ * anything) cancels out, since the mode the model last saw never effectively
+ * changed.
+ */
+export declare function createModeSwitchNoticeTracker(): {
+    record(from: "act" | "plan", to: "act" | "plan"): void;
+    consume(): ModeSwitchNotice | null;
+};
+export type ModeSwitchNoticeTracker = ReturnType<typeof createModeSwitchNoticeTracker>;
 export type UserCommandEnvelope = {
     slash: string;
     content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cline/shared",
-	"version": "0.0.60",
+	"version": "0.0.62-nightly.1784171655",
 	"description": "Shared utilities, types, and schemas for Cline packages",
 	"repository": {
 		"type": "git",