@cline/shared 0.0.39 → 0.0.40-nightly.1778642379

package/dist/llms/ai-sdk-format.d.ts

@@ -1,7 +1,20 @@
+/**
+ * Sanitizes unpaired/lone Unicode surrogates in text content.
+ *
+ * Lone surrogates (high surrogates without matching low surrogates, or vice versa)
+ * can cause JSON serialization issues and downstream processing errors when sending
+ * text to LLM providers. This function replaces them with the Unicode replacement
+ * character (U+FFFD).
+ *
+ * @param content - The string to sanitize
+ * @returns The string with lone surrogates replaced by U+FFFD
+ */
+export declare function sanitizeSurrogates(content: string): string;
 export type AiSdkFormatterMessageRole = "user" | "assistant" | "tool";
 export type AiSdkFormatterPart = {
     type: "text";
     text: string;
+    providerOptions?: Record<string, Record<string, unknown>>;
 } | {
     type: "reasoning";
     text: string;

package/dist/llms/gateway.d.ts

@@ -1,16 +1,41 @@
 import type { AgentMessage, AgentModelEvent, AgentToolDefinition } from "../agent";
 import type { BasicLogger } from "../logging/logger";
 import type { ProviderCapability } from "../rpc/runtime";
+import type { ITelemetryService } from "../services/telemetry";
 export type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue | undefined;
 };
-export type GatewayModelCapability = "text" | "tools" | "reasoning" | "images" | "audio" | "structured-output";
+export type GatewayModelCapability = "text" | "tools" | "reasoning" | "prompt-cache" | "images" | "audio" | "structured-output";
 export type GatewayPromptCacheStrategy = "anthropic-automatic";
 export type GatewayUsageCostDisplay = "show" | "hide";
+export type GatewayPromptCacheFormat = "anthropic-cache-control";
+export type GatewayReasoningFormat = "anthropic-thinking";
+export type GatewayModelRoute = {
+    matcher: "anthropic-compatible";
+} | {
+    matcher: "model-family";
+    family: string;
+    requiredCapability?: GatewayModelCapability;
+} | {
+    matcher: "model-id";
+    modelId: string;
+    requiredCapability?: GatewayModelCapability;
+};
+export interface GatewayProviderRouting {
+    promptCache?: {
+        format: GatewayPromptCacheFormat;
+        routes: GatewayModelRoute[];
+    };
+    reasoning?: {
+        format: GatewayReasoningFormat;
+        routes: GatewayModelRoute[];
+    };
+}
 export interface GatewayProviderMetadata {
     promptCacheStrategy?: GatewayPromptCacheStrategy;
     usageCostDisplay?: GatewayUsageCostDisplay;
-    [key: string]: JsonValue | undefined;
+    routing?: GatewayProviderRouting;
+    [key: string]: JsonValue | GatewayProviderRouting | undefined;
 }
 export interface GatewayModelDefinition {
     id: string;
@@ -18,6 +43,7 @@ export interface GatewayModelDefinition {
     providerId: string;
     description?: string;
     contextWindow?: number;
+    maxInputTokens?: number;
     maxOutputTokens?: number;
     capabilities?: readonly GatewayModelCapability[];
     metadata?: Record<string, JsonValue | undefined>;
@@ -69,6 +95,7 @@ export interface GatewayProviderContext {
     config: GatewayResolvedProviderConfig;
     signal?: AbortSignal;
     logger?: BasicLogger;
+    telemetry?: ITelemetryService;
 }
 export interface GatewayStreamRequest {
     providerId: string;
@@ -114,4 +141,5 @@ export interface GatewayConfig {
     providerConfigs?: readonly GatewayProviderConfig[];
     fetch?: typeof fetch;
     logger?: BasicLogger;
+    telemetry?: ITelemetryService;
 }

package/dist/llms/model-info.d.ts

@@ -60,6 +60,7 @@ export declare const ModelInfoSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
     contextWindow: z.ZodOptional<z.ZodNumber>;
+    maxInputTokens: z.ZodOptional<z.ZodNumber>;
     capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         images: "images";
         tools: "tools";

package/dist/llms/tokens.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Conservative chars-per-token approximation used for compaction triggering
+ * and request-size diagnostics. Uses 3 chars/token (slightly over-counts vs
+ * the conventional 4) so trigger thresholds fire before provider rejection
+ * rather than after.
+ */
+export declare function estimateTokens(chars: number): number;

package/dist/rpc/runtime.d.ts

@@ -139,6 +139,7 @@ export interface ProviderListItem {
     defaultModelId?: string;
     protocol?: ProviderProtocol;
     client?: ProviderClient;
+    capabilities?: ProviderCapability[];
     authDescription: string;
     baseUrlDescription: string;
     modelList?: ProviderModel[];
@@ -165,6 +166,7 @@ export declare const ProviderCapabilitySchema: z.ZodEnum<{
     oauth: "oauth";
     vision: "vision";
     "local-auth": "local-auth";
+    popular: "popular";
 }>;
 export type ProviderCapability = z.infer<typeof ProviderCapabilitySchema>;
 export declare const ProviderProtocolSchema: z.ZodEnum<{

package/dist/services/telemetry.d.ts

@@ -5,6 +5,18 @@ export type TelemetryObject = {
 };
 export type TelemetryArray = Array<TelemetryValue>;
 export type TelemetryProperties = TelemetryObject;
+export type SdkTelemetryErrorComponent = "shared" | "llms" | "agents" | "core" | "cli" | "vscode" | "desktop" | (string & {});
+export type SdkTelemetryErrorSeverity = "debug" | "info" | "warn" | "error" | "fatal";
+export interface CaptureSdkErrorInput {
+    component: SdkTelemetryErrorComponent;
+    operation: string;
+    error: unknown;
+    severity?: SdkTelemetryErrorSeverity;
+    handled?: boolean;
+    context?: TelemetryProperties;
+    event?: string;
+    messageLimit?: number;
+}
 export interface TelemetryMetadata {
     extension_version: string;
     cline_type: string;
@@ -33,6 +45,10 @@ export interface ITelemetryService {
     flush(): Promise<void>;
     dispose(): Promise<void>;
 }
+export declare const SDK_ERROR_TELEMETRY_EVENT = "sdk.error";
+export declare function captureSdkError(telemetry: ITelemetryService | undefined, input: CaptureSdkErrorInput): void;
+export declare function buildSdkErrorProperties(input: CaptureSdkErrorInput): TelemetryProperties;
+export declare function normalizeSdkError(error: unknown, messageLimit?: number): TelemetryProperties;
 export interface OpenTelemetryClientConfig {
     /**
      * Whether telemetry is enabled via OTEL_TELEMETRY_ENABLED

package/dist/storage/index.js

@@ -1 +1 @@
-var i=Object.defineProperty;var e=(C)=>C;function a(C,S){this[C]=e.bind(null,S)}var $C=(C,S)=>{for(var M in S)i(C,M,{get:S[M],enumerable:!0,configurable:!0,set:a.bind(S,M)})};import{appendFileSync as t,existsSync as F,mkdirSync as Y,readdirSync as CC,readFileSync as SC,statSync as I}from"node:fs";import{homedir as OC}from"node:os";import{dirname as Z,join as O,resolve as R}from"node:path";var $=".clinerules",L=".cline",H=".agents",U="agents",z="hooks",B="skills",Q="rules",J="workflows",f="plugins",x="cline_mcp_settings.json";function MC(){let C=process?.env?.HOME?.trim();if(C&&C!=="~")return C;let S=process?.env?.USERPROFILE?.trim();if(S)return S;let M=process?.env?.HOMEDRIVE?.trim(),D=process?.env?.HOMEPATH?.trim();if(M&&D)return`${M}${D}`;let N=OC().trim();if(N&&N!=="~")return N;return"~"}var j=MC(),u=!1;function NC(C){let S=C.trim();if(!S)return;j=S,u=!0}function GC(C){if(u)return;let S=C.trim();if(!S)return;j=S}var E,y=!1;function DC(C){let S=C.trim();if(!S)return;E=S,y=!0}function FC(C){if(y)return;let S=C.trim();if(!S)return;E=S}function _(){if(E)return E;let C=process.env.CLINE_DIR?.trim();if(C)return C;return O(j,".cline")}function m(){return O(j,"Documents","Cline")}function q(C){return O(m(),C)}function g(){let C=process.env.CLINE_DATA_DIR?.trim();if(C)return C;return O(_(),"data")}function WC(){let C=process.env.CLINE_SESSION_DATA_DIR?.trim();if(C)return C;return O(g(),"sessions")}function _C(){let C=process.env.CLINE_TEAM_DATA_DIR?.trim();if(C)return C;return O(g(),"teams")}function w(){let C=process.env.CLINE_DB_DATA_DIR?.trim();if(C)return C;return O(g(),"db")}function gC(){let C=process.env.CLINE_CRON_DB_PATH?.trim();if(C)return C;return O(w(),"cron.db")}function s(){return O(_(),"cron")}function V(C){return O(C,".cline","cron")}function X(C){if(typeof C==="string")return V(C);if(C?.cronSpecsDir?.trim())return C.cronSpecsDir.trim();if(C?.scope==="workspace"){let S=C.workspaceRoot?.trim();if(!S)throw Error("workspaceRoot is required for workspace cron scope");return V(S)}return s()}function vC(C){return O(X(C),"reports")}function AC(C){return O(X(C),"events")}function KC(){let C=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(C)return C;return O(g(),"settings","providers.json")}function IC(){let C=process.env.CLINE_GLOBAL_SETTINGS_PATH?.trim();if(C)return C;return O(g(),"settings","global-settings.json")}function RC(){let C=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(C)return C;return O(g(),"settings",x)}function v(C){let S=new Set,M=[];for(let D of C){if(!D||S.has(D))continue;S.add(D),M.push(D)}return M}function TC(C){if(!C)return[];return[$,L,H].map((S)=>O(C,S,B))}function k(){return O(_(),U)}function jC(C){return v([C?O(C,L,U):"",k()])}function qC(C){let S=[q("Hooks"),O(_(),z)];if(C)S.push(O(C,$,z),O(C,L,z));return v(S)}function zC(C){return v([...TC(C),O(_(),B),O(j,H,B)])}function BC(C){let S=C?[O(C,$),O(C,L,Q)]:[],M=C?[O(C,"AGENTS.md")]:[];return v([...M,...S,O(_(),Q),q("Rules")])}function EC(C){return v([C?O(C,".clinerules",J):"",q("Workflows")])}function LC(C){return v([C?O(C,".cline",f):"",O(_(),f),q("Plugins")])}var o=new Set([".js",".ts"]),d="package.json",QC=["index.ts","index.js"];function T(C){let S=C.lastIndexOf(".");if(S===-1)return!1;return o.has(C.slice(S))}function n(C){try{let S=JSON.parse(SC(C,"utf8"));if(!S.cline||typeof S.cline!=="object")return null;return S.cline}catch{return null}}function c(C){let S=C?.plugins;if(!Array.isArray(S))return[];return S.flatMap((M)=>M.paths??[])}function r(C){let S=R(C);if(!F(S)||!I(S).isDirectory())return null;let M=O(S,d);if(F(M)){let D=n(M),N=c(D).map((G)=>R(S,G)).filter((G)=>F(G)&&I(G).isFile()&&T(G));if(N.length>0)return N}for(let D of QC){let N=O(S,D);if(F(N)&&I(N).isFile())return[N]}return null}function p(C){let S=R(C);if(!F(S))return[];let M=[],D=[S];while(D.length>0){let N=D.pop();if(!N)continue;let G;try{G=CC(N,{withFileTypes:!0})}catch{continue}for(let A of G){let W=O(N,A.name);if(A.isDirectory()){let b=O(W,d);if(F(b)){let h=n(b),l=c(h).map((K)=>R(W,K)).filter((K)=>F(K)&&I(K).isFile()&&T(K));if(l.length>0){M.push(...l);continue}}D.push(W);continue}if(A.name.startsWith("."))continue;if(A.isFile()&&T(W))M.push(W)}}return M.sort((N,G)=>N.localeCompare(G))}function VC(C,S){let M=[];for(let D of C){let N=D.trim();if(!N)continue;let G=R(S,N);if(!F(G))throw Error(`Plugin path does not exist: ${G}`);if(I(G).isDirectory()){let W=r(G);if(W){M.push(...W);continue}M.push(...p(G));continue}if(!T(G))throw Error(`Plugin file must use a supported extension (${[...o].join(", ")}): ${G}`);M.push(G)}return M}function P(C){let S=Z(C);if(!F(S))Y(S,{recursive:!0})}function YC(C){Y(Z(C),{recursive:!0}),t(C,"")}function ZC(C){if(C?.trim())return P(C),Z(C);let S=O(g(),"logs");if(!F(S))Y(S,{recursive:!0});return S}export{GC as setHomeDirIfUnset,NC as setHomeDir,FC as setClineDirIfUnset,DC as setClineDir,V as resolveWorkspaceCronSpecsDir,EC as resolveWorkflowsConfigSearchPaths,_C as resolveTeamDataDir,zC as resolveSkillsConfigSearchPaths,WC as resolveSessionDataDir,BC as resolveRulesConfigSearchPaths,KC as resolveProviderSettingsPath,r as resolvePluginModuleEntries,LC as resolvePluginConfigSearchPaths,RC as resolveMcpSettingsPath,qC as resolveHooksConfigSearchPaths,IC as resolveGlobalSettingsPath,s as resolveGlobalCronSpecsDir,q as resolveDocumentsExtensionPath,m as resolveDocumentsClineDirectoryPath,w as resolveDbDataDir,X as resolveCronSpecsDir,vC as resolveCronReportsDir,AC as resolveCronEventsDir,gC as resolveCronDbPath,VC as resolveConfiguredPluginModulePaths,_ as resolveClineDir,g as resolveClineDataDir,k as resolveAgentsConfigDirPath,jC as resolveAgentConfigSearchPaths,T as isPluginModulePath,P as ensureParentDir,ZC as ensureHookLogDir,YC as ensureFileExists,p as discoverPluginModulePaths,J as WORKFLOWS_CONFIG_DIRECTORY_NAME,B as SKILLS_CONFIG_DIRECTORY_NAME,Q as RULES_CONFIG_DIRECTORY_NAME,z as HOOKS_CONFIG_DIRECTORY_NAME,x as CLINE_MCP_SETTINGS_FILE_NAME,U as AGENT_CONFIG_DIRECTORY_NAME};
+var i=Object.defineProperty;var e=(C)=>C;function a(C,S){this[C]=e.bind(null,S)}var $C=(C,S)=>{for(var M in S)i(C,M,{get:S[M],enumerable:!0,configurable:!0,set:a.bind(S,M)})};import{appendFileSync as t,existsSync as F,mkdirSync as Z,readdirSync as CC,readFileSync as SC,statSync as I}from"node:fs";import{homedir as OC}from"node:os";import{dirname as $,join as O,resolve as R}from"node:path";var U=".clinerules",Q=".cline",J=".agents",X="agents",z="hooks",E="skills",V="rules",B="workflows",H="plugins",x="cline_mcp_settings.json";function MC(){let C=process?.env?.HOME?.trim();if(C&&C!=="~")return C;let S=process?.env?.USERPROFILE?.trim();if(S)return S;let M=process?.env?.HOMEDRIVE?.trim(),D=process?.env?.HOMEPATH?.trim();if(M&&D)return`${M}${D}`;let N=OC().trim();if(N&&N!=="~")return N;return"~"}var j=MC(),u=!1;function NC(C){let S=C.trim();if(!S)return;j=S,u=!0}function GC(C){if(u)return;let S=C.trim();if(!S)return;j=S}var L,y=!1;function DC(C){let S=C.trim();if(!S)return;L=S,y=!0}function FC(C){if(y)return;let S=C.trim();if(!S)return;L=S}function W(){if(L)return L;let C=process.env.CLINE_DIR?.trim();if(C)return C;return O(j,".cline")}function m(){return O(j,"Documents","Cline")}function q(C){return O(m(),C)}function g(){let C=process.env.CLINE_DATA_DIR?.trim();if(C)return C;return O(W(),"data")}function WC(){let C=process.env.CLINE_SESSION_DATA_DIR?.trim();if(C)return C;return O(g(),"sessions")}function _C(){let C=process.env.CLINE_TEAM_DATA_DIR?.trim();if(C)return C;return O(g(),"teams")}function w(){let C=process.env.CLINE_DB_DATA_DIR?.trim();if(C)return C;return O(g(),"db")}function gC(){let C=process.env.CLINE_CRON_DB_PATH?.trim();if(C)return C;return O(w(),"cron.db")}function s(){return O(W(),"cron")}function Y(C){return O(C,".cline","cron")}function b(C){if(typeof C==="string")return Y(C);if(C?.cronSpecsDir?.trim())return C.cronSpecsDir.trim();if(C?.scope==="workspace"){let S=C.workspaceRoot?.trim();if(!S)throw Error("workspaceRoot is required for workspace cron scope");return Y(S)}return s()}function vC(C){return O(b(C),"reports")}function AC(C){return O(b(C),"events")}function KC(){let C=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(C)return C;return O(g(),"settings","providers.json")}function IC(){let C=process.env.CLINE_GLOBAL_SETTINGS_PATH?.trim();if(C)return C;return O(g(),"settings","global-settings.json")}function RC(){let C=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(C)return C;return O(g(),"settings",x)}function v(C){let S=new Set,M=[];for(let D of C){if(!D||S.has(D))continue;S.add(D),M.push(D)}return M}function TC(C){if(!C)return[];return[U,Q,J].map((S)=>O(C,S,E))}function k(){return O(W(),X)}function jC(C){return v([C?O(C,Q,X):"",k()])}function qC(C){let S=[q("Hooks"),O(W(),z)];if(C)S.push(O(C,U,z),O(C,Q,z));return v(S)}function zC(C){return v([...TC(C),O(W(),E),O(j,J,E)])}function BC(C){let S=C?[O(C,U),O(C,Q,V)]:[],M=C?[O(C,"AGENTS.md")]:[];return v([...M,...S,O(W(),V),q("Rules")])}function EC(C){return v([C?O(C,".clinerules",B):"",q("Workflows"),O(W(),B),C?O(C,".cline",B):""])}function LC(C){return v([C?O(C,".cline",H):"",O(W(),H),q("Plugins")])}var o=new Set([".js",".ts"]),d="package.json",QC=["index.ts","index.js"];function T(C){let S=C.lastIndexOf(".");if(S===-1)return!1;return o.has(C.slice(S))}function n(C){try{let S=JSON.parse(SC(C,"utf8"));if(!S.cline||typeof S.cline!=="object")return null;return S.cline}catch{return null}}function c(C){let S=C?.plugins;if(!Array.isArray(S))return[];return S.flatMap((M)=>M.paths??[])}function r(C){let S=R(C);if(!F(S)||!I(S).isDirectory())return null;let M=O(S,d);if(F(M)){let D=n(M),N=c(D).map((G)=>R(S,G)).filter((G)=>F(G)&&I(G).isFile()&&T(G));if(N.length>0)return N}for(let D of QC){let N=O(S,D);if(F(N)&&I(N).isFile())return[N]}return null}function p(C){let S=R(C);if(!F(S))return[];let M=[],D=[S];while(D.length>0){let N=D.pop();if(!N)continue;let G;try{G=CC(N,{withFileTypes:!0})}catch{continue}for(let A of G){let _=O(N,A.name);if(A.isDirectory()){let l=O(_,d);if(F(l)){let h=n(l),f=c(h).map((K)=>R(_,K)).filter((K)=>F(K)&&I(K).isFile()&&T(K));if(f.length>0){M.push(...f);continue}}D.push(_);continue}if(A.name.startsWith("."))continue;if(A.isFile()&&T(_))M.push(_)}}return M.sort((N,G)=>N.localeCompare(G))}function VC(C,S){let M=[];for(let D of C){let N=D.trim();if(!N)continue;let G=R(S,N);if(!F(G))throw Error(`Plugin path does not exist: ${G}`);if(I(G).isDirectory()){let _=r(G);if(_){M.push(..._);continue}M.push(...p(G));continue}if(!T(G))throw Error(`Plugin file must use a supported extension (${[...o].join(", ")}): ${G}`);M.push(G)}return M}function P(C){let S=$(C);if(!F(S))Z(S,{recursive:!0})}function YC(C){Z($(C),{recursive:!0}),t(C,"")}function ZC(C){if(C?.trim())return P(C),$(C);let S=O(g(),"logs");if(!F(S))Z(S,{recursive:!0});return S}export{GC as setHomeDirIfUnset,NC as setHomeDir,FC as setClineDirIfUnset,DC as setClineDir,Y as resolveWorkspaceCronSpecsDir,EC as resolveWorkflowsConfigSearchPaths,_C as resolveTeamDataDir,zC as resolveSkillsConfigSearchPaths,WC as resolveSessionDataDir,BC as resolveRulesConfigSearchPaths,KC as resolveProviderSettingsPath,r as resolvePluginModuleEntries,LC as resolvePluginConfigSearchPaths,RC as resolveMcpSettingsPath,qC as resolveHooksConfigSearchPaths,IC as resolveGlobalSettingsPath,s as resolveGlobalCronSpecsDir,q as resolveDocumentsExtensionPath,m as resolveDocumentsClineDirectoryPath,w as resolveDbDataDir,b as resolveCronSpecsDir,vC as resolveCronReportsDir,AC as resolveCronEventsDir,gC as resolveCronDbPath,VC as resolveConfiguredPluginModulePaths,W as resolveClineDir,g as resolveClineDataDir,k as resolveAgentsConfigDirPath,jC as resolveAgentConfigSearchPaths,T as isPluginModulePath,P as ensureParentDir,ZC as ensureHookLogDir,YC as ensureFileExists,p as discoverPluginModulePaths,B as WORKFLOWS_CONFIG_DIRECTORY_NAME,E as SKILLS_CONFIG_DIRECTORY_NAME,V as RULES_CONFIG_DIRECTORY_NAME,z as HOOKS_CONFIG_DIRECTORY_NAME,x as CLINE_MCP_SETTINGS_FILE_NAME,X as AGENT_CONFIG_DIRECTORY_NAME};

package/dist/vcr.d.ts

@@ -22,13 +22,13 @@
  *
  * Usage:
  *   # Record only inference requests
- *   CLINE_VCR=record CLINE_VCR_CASSETTE=./fixtures/my-test.json clite task "hello"
+ *   CLINE_VCR=record CLINE_VCR_CASSETTE=./fixtures/my-test.json cline task "hello"
  *
  *   # Replay — auth/S3/etc. requests go through normally, only inference is mocked
- *   CLINE_VCR=playback CLINE_VCR_CASSETTE=./fixtures/my-test.json clite task "hello"
+ *   CLINE_VCR=playback CLINE_VCR_CASSETTE=./fixtures/my-test.json cline task "hello"
  *
  *   # Record everything (no filter)
- *   CLINE_VCR=record CLINE_VCR_FILTER="" CLINE_VCR_CASSETTE=./fixtures/all.json clite task "hello"
+ *   CLINE_VCR=record CLINE_VCR_FILTER="" CLINE_VCR_CASSETTE=./fixtures/all.json cline task "hello"
  */
 /**
  * Initialize VCR mode based on environment variables.

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@cline/shared",
-	"version": "0.0.39",
+	"version": "0.0.40-nightly.1778642379",
 	"description": "Shared utilities, types, and schemas for Cline packages",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/cline/sdk",
-		"directory": "packages/shared"
+		"url": "https://github.com/cline/cline",
+		"directory": "sdk/packages/shared"
 	},
 	"type": "module",
 	"main": "dist/index.js",
@@ -47,7 +47,6 @@
 	],
 	"scripts": {
 		"build": "BUILD_MODE=package bun bun.mts",
-		"clean": "rm -rf dist node_modules",
 		"typecheck": "bun tsc --noEmit",
 		"test": "bun run test:unit",
 		"test:unit": "vitest run --config vitest.config.ts"