@cline/shared 0.0.75 → 0.0.76

package/dist/remote-config/runtime.d.ts

@@ -1,5 +1,10 @@
 import type { AgentExtension } from "../agents/types";
-import type { PreparedRemoteConfigRuntime, PrepareRemoteConfigRuntimeOptions, RemoteConfigBundle, RemoteConfigProjectContext, RemoteConfigSyncResult, RemoteConfigSyncServiceOptions } from "./bundle";
+import type { PreparedRemoteConfigRuntime, PrepareRemoteConfigRuntimeOptions, RemoteConfigBundle, RemoteConfigManagedArtifactStore, RemoteConfigProjectContext, RemoteConfigSyncResult, RemoteConfigSyncServiceOptions } from "./bundle";
+export declare function clearMaterializedRemoteConfigRuntime(options: {
+    workspacePath: string;
+    pluginName?: string;
+    artifactStore?: RemoteConfigManagedArtifactStore;
+}): Promise<void>;
 export declare function withRemoteConfigBundlePaths<T extends RemoteConfigBundle>(bundle: T, paths: RemoteConfigSyncResult["materialized"]["paths"]): T;
 export declare class RemoteConfigSyncService {
     private readonly options;

package/dist/rpc/runtime.d.ts

@@ -1,5 +1,6 @@
 import z from "zod";
 import type { HubToolExecutorName } from "../hub";
+import type { ModelModality, ModelOperation, ModelOperationMode } from "../llms/model-info";
 import type { ReasoningLevel } from "../llms/reasoning-options";
 import type { RuntimeConfigExtensionKind, SessionExecutionConfig, SessionPromptConfig } from "../session/runtime-config";
 export interface ChatRuntimeConfig extends SessionPromptConfig {
@@ -120,13 +121,33 @@ export interface EnterpriseStatusRequest {
     rootPath?: string;
 }
 export type EnterpriseStatusResponse = EnterpriseSyncResponse;
+/** Which tier of the Cline recommended-models feed featured a model. */
+export type ProviderModelFeaturedTier = "recommended" | "free" | "subscribed";
+export interface ProviderModelFeatured {
+    tier: ProviderModelFeaturedTier;
+    /** Position within the tier, preserving the feed's intentional order. */
+    rank: number;
+    /** Feed marketing tags, e.g. "NEW" or "BEST". */
+    tags: string[];
+}
 export interface ProviderModel {
     id: string;
     name: string;
+    description?: string;
+    /**
+     * Present when the Cline recommended-models feed features this model
+     * (cline / cline-pass providers only), so pickers can lead with the
+     * feed's tiers without fetching and joining the feed themselves.
+     */
+    featured?: ProviderModelFeatured;
+    operation?: ModelOperation;
     contextWindow?: number;
     supportsAttachments?: boolean;
     supportsVision?: boolean;
     supportsReasoning?: boolean;
+    operationModes?: ModelOperationMode[];
+    inputModalities?: ModelModality[];
+    outputModalities?: ModelModality[];
 }
 export type ProviderConfigFieldType = "text" | "password" | "url" | "number" | "select" | "boolean";
 export type ProviderConfigFieldPrimitive = string | number | boolean | null;
@@ -166,9 +187,14 @@ export interface ProviderListItem {
     modelList?: ProviderModel[];
     family?: string;
 }
+export interface VoiceInputSelection {
+    providerId: string;
+    modelId: string;
+}
 export interface ProviderCatalogResponse {
     providers: ProviderListItem[];
     settingsPath: string;
+    voiceInput?: VoiceInputSelection;
 }
 export interface ProviderModelsResponse {
     providerId: string;

package/dist/session/runtime-config.d.ts

@@ -1,8 +1,8 @@
 import type { ToolPolicy } from "../llms/tools";
 export type AgentMode = "act" | "plan" | "yolo" | "zen";
-export type RuntimeConfigExtensionKind = "rules" | "skills" | "workflows" | "plugins";
-export declare const RUNTIME_CONFIG_EXTENSION_KINDS: readonly ["rules", "skills", "workflows", "plugins"];
-export declare const DEFAULT_RUNTIME_CONFIG_EXTENSIONS: readonly ["rules", "skills", "workflows", "plugins"];
+export type RuntimeConfigExtensionKind = "rules" | "skills" | "workflows" | "plugins" | "hooks";
+export declare const RUNTIME_CONFIG_EXTENSION_KINDS: readonly ["rules", "skills", "workflows", "plugins", "hooks"];
+export declare const DEFAULT_RUNTIME_CONFIG_EXTENSIONS: readonly ["rules", "skills", "workflows", "plugins", "hooks"];
 export declare function isRuntimeConfigExtensionKind(value: unknown): value is RuntimeConfigExtensionKind;
 export declare function parseRuntimeConfigExtensions(value: unknown): RuntimeConfigExtensionKind[] | undefined;
 export declare function hasRuntimeConfigExtension(extensions: ReadonlyArray<RuntimeConfigExtensionKind> | undefined, kind: RuntimeConfigExtensionKind): boolean;

package/dist/storage/index.d.ts

@@ -1,2 +1,2 @@
 export { resolveExistingFilePath } from "./path-resolution";
-export { AGENT_CONFIG_DIRECTORY_NAME, AGENTS_RULES_FILE_NAME, CLINE_CHAT_WORKSPACE_DIRECTORY_NAME, CLINE_CONNECTOR_SETTINGS_FILE_NAME, CLINE_MCP_SETTINGS_FILE_NAME, CLINE_WORKSPACES_DIRECTORY_NAME, type CronSpecsScope, discoverPluginModulePaths, ensureFileExists, ensureHookLogDir, ensureParentDir, getPluginDisplayName, HOOKS_CONFIG_DIRECTORY_NAME, isChatWorkspacePath, isPluginModulePath, type ResolveCronSpecsDirOptions, RULES_CONFIG_DIRECTORY_NAME, resolveAgentConfigSearchPaths, resolveAgentsConfigDirPath, resolveChatWorkspacePath, resolveClineDataDir, resolveClineDir, resolveConfiguredPluginModulePaths, resolveConnectorDataDir, resolveConnectorLogPath, resolveConnectorSettingsPath, resolveConnectorsDbPath, resolveCronDbPath, resolveCronEventsDir, resolveCronReportsDir, resolveCronSpecsDir, resolveDbDataDir, resolveDocumentsClineDirectoryPath, resolveDocumentsExtensionPath, resolveGlobalAgentsRulesPath, resolveGlobalCronSpecsDir, resolveGlobalSettingsPath, resolveHooksConfigSearchPaths, resolveMcpSettingsPath, resolvePluginConfigSearchPaths, resolvePluginModuleEntries, resolveProviderSettingsPath, resolveRulesConfigSearchPaths, resolveSessionDataDir, resolveSkillsConfigSearchPaths, resolveTeamDataDir, resolveWorkflowsConfigSearchPaths, resolveWorkspaceCronSpecsDir, SKILLS_CONFIG_DIRECTORY_NAME, setClineDir, setClineDirIfUnset, setHomeDir, setHomeDirIfUnset, WORKFLOWS_CONFIG_DIRECTORY_NAME, } from "./paths";
+export { AGENT_CONFIG_DIRECTORY_NAME, AGENTS_RULES_FILE_NAME, CLINE_CHAT_WORKSPACE_DIRECTORY_NAME, CLINE_CONNECTOR_SETTINGS_FILE_NAME, CLINE_MCP_SETTINGS_FILE_NAME, CLINE_WORKSPACES_DIRECTORY_NAME, type CronSpecsScope, discoverPluginModulePaths, ensureFileExists, ensureHookLogDir, ensureParentDir, getPluginDisplayName, HOOKS_CONFIG_DIRECTORY_NAME, isChatWorkspacePath, isPluginModulePath, type ResolveCronSpecsDirOptions, type ResolveTaskSpecsDirOptions, RULES_CONFIG_DIRECTORY_NAME, resolveAgentConfigSearchPaths, resolveAgentsConfigDirPath, resolveChatWorkspacePath, resolveClineDataDir, resolveClineDir, resolveConfiguredPluginModulePaths, resolveConnectorDataDir, resolveConnectorLogPath, resolveConnectorSettingsPath, resolveConnectorsDbPath, resolveCronDbPath, resolveCronEventsDir, resolveCronReportsDir, resolveCronSpecsDir, resolveDbDataDir, resolveDocumentsClineDirectoryPath, resolveDocumentsExtensionPath, resolveGlobalAgentsRulesPath, resolveGlobalCronSpecsDir, resolveGlobalSettingsPath, resolveGlobalTaskSpecsDir, resolveHooksConfigSearchPaths, resolveMcpSettingsPath, resolvePluginConfigSearchPaths, resolvePluginModuleEntries, resolveProviderSettingsPath, resolveRulesConfigSearchPaths, resolveSessionDataDir, resolveSkillsConfigSearchPaths, resolveTaskSpecsDir, resolveTasksDbPath, resolveTeamDataDir, resolveWorkflowsConfigSearchPaths, resolveWorkspaceCronSpecsDir, resolveWorkspaceTaskSpecsDir, SKILLS_CONFIG_DIRECTORY_NAME, setClineDir, setClineDirIfUnset, setHomeDir, setHomeDirIfUnset, type TaskSpecsScope, WORKFLOWS_CONFIG_DIRECTORY_NAME, } from "./paths";

package/dist/storage/index.js

@@ -1 +1 @@
-var MC=Object.defineProperty;var DC=(C)=>C;function FC(C,S){this[C]=DC.bind(null,S)}var GS=(C,S)=>{for(var E in S)MC(C,E,{get:S[E],enumerable:!0,configurable:!0,set:FC.bind(S,E)})};import{existsSync as K,readdirSync as WC}from"node:fs";import{basename as o,dirname as p,join as s}from"node:path";var YC=/[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g,vC=" ";function l(C){return C.normalize("NFC").replace(YC," ")}function KC(C){let S=o(C),E=S.replace(/ (AM|PM)\./gi,`${vC}$1.`);return E===S?C:s(p(C),E)}function qC(C){return C.normalize("NFD")}function d(C){return C.replace(/'/g,"’")}function QC(C){let S=p(C),E=l(o(C));try{for(let I of WC(S))if(l(I)===E)return s(S,I)}catch{}return}function RC(C){if(K(C))return C;let S=KC(C);if(S!==C&&K(S))return S;let E=qC(C);if(E!==C&&K(E))return E;let I=d(C);if(I!==C&&K(I))return I;let G=d(E);if(G!==E&&G!==I&&K(G))return G;return QC(C)}import{appendFileSync as ZC,existsSync as T,mkdirSync as b,readdirSync as $C,readFileSync as n,statSync as q}from"node:fs";import{homedir as AC}from"node:os";import{basename as BC,dirname as U,extname as XC,isAbsolute as jC,join as _,relative as UC,resolve as D}from"node:path";var Z="workspaces",$="chat";function P(C){let S=C.trim(),E=/^[A-Za-z]:[\\/]/.test(S)||S.startsWith("\\\\"),I=S.startsWith("/");if(!E&&!I)return!1;let G=S.split(E?/[\\/]+/:/\/+/).filter(Boolean),O=G.at(-1)??"",N=G.at(-2)??"",M=G.at(-3)??"";return(G.at(-4)??"")===".cline"&&M==="data"&&N==="workspaces"&&O==="chat"}var V=".clinerules",z=".cline",x=".agents",u="agents",A="hooks",X="skills",g="rules",B="workflows",c="plugins",w="AGENTS.md";function zC(){return _(L(),Z,$)}var h="cline_mcp_settings.json",r="settings.json";function HC(){let C=process?.env?.HOME?.trim();if(C&&C!=="~")return C;let S=process?.env?.USERPROFILE?.trim();if(S)return S;let E=process?.env?.HOMEDRIVE?.trim(),I=process?.env?.HOMEPATH?.trim();if(E&&I)return`${E}${I}`;let G=AC().trim();if(G&&G!=="~")return G;return"~"}var W=HC(),i=!1;function gC(C){let S=C.trim();if(!S)return;W=S,i=!0}function JC(C){if(i)return;let S=C.trim();if(!S)return;W=S}var j,e=!1;function bC(C){let S=C.trim();if(!S)return;j=S,e=!0}function VC(C){if(e)return;let S=C.trim();if(!S)return;j=S}function F(){if(j)return j;let C=process.env.CLINE_DIR?.trim();if(C)return C;return _(W,".cline")}function t(){return _(W,"Documents","Cline")}function R(C){return _(t(),C)}function L(){let C=process.env.CLINE_DATA_DIR?.trim();if(C)return C;return _(F(),"data")}function xC(){let C=process.env.CLINE_SESSION_DATA_DIR?.trim();if(C)return C;return _(L(),"sessions")}function uC(){let C=process.env.CLINE_TEAM_DATA_DIR?.trim();if(C)return C;return _(L(),"teams")}function a(){let C=process.env.CLINE_CONNECTOR_DATA_DIR?.trim();if(C)return C;return _(L(),"connectors")}function wC(C,S){let E=C.replace(/[^a-zA-Z0-9._-]+/g,"_"),I=S.replace(/[^a-zA-Z0-9._-]+/g,"_");return _(L(),"logs","connectors",E,`${I}.log`)}function yC(){let C=process.env.CLINE_CONNECTOR_SETTINGS_PATH?.trim();if(C)return C;return _(a(),r)}function y(){let C=process.env.CLINE_DB_DATA_DIR?.trim();if(C)return C;return _(L(),"db")}function kC(){let C=process.env.CLINE_CONNECTORS_DB_PATH?.trim();if(C)return C;return _(y(),"connectors.db")}function mC(){let C=process.env.CLINE_CRON_DB_PATH?.trim();if(C)return C;return _(y(),"cron.db")}function CC(){return _(F(),"cron")}function J(C){return _(C,".cline","cron")}function k(C){if(typeof C==="string")return J(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 J(S)}return CC()}function fC(C){return _(k(C),"reports")}function lC(C){return _(k(C),"events")}function dC(){let C=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(C)return C;return _(L(),"settings","providers.json")}function oC(){let C=process.env.CLINE_GLOBAL_SETTINGS_PATH?.trim();if(C)return C;return _(L(),"settings","global-settings.json")}function pC(){let C=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(C)return C;return _(L(),"settings",h)}function Y(C){let S=new Set,E=[];for(let I of C){if(!I||S.has(I))continue;S.add(I),E.push(I)}return E}function sC(C){if(!C)return[];return[V,z,x].map((S)=>_(C,S,X))}function SC(){return _(F(),u)}function PC(C){return Y([C?_(C,z,u):"",SC()])}function cC(C){let S=[R("Hooks"),_(F(),A)];if(C)S.push(_(C,V,A),_(C,z,A));return Y(S)}function nC(C){return Y([...sC(C),_(F(),X),_(W,x,X)])}function EC(){return _(W,x,w)}function hC(C){let S=C?[_(C,V),_(C,z,g)]:[],E=C?[_(C,w)]:[];return Y([...E,...S,EC(),_(F(),g),R("Rules")])}function rC(C){return Y([C?_(C,".clinerules",B):"",R("Workflows"),_(F(),B),C?_(C,".cline",B):""])}function iC(C){return Y([C?_(C,".cline",c):"",_(F(),c),R("Plugins")])}var _C=new Set([".js",".ts"]),m="package.json",eC=["index.ts","index.js"];function Q(C){let S=C.lastIndexOf(".");if(S===-1)return!1;return _C.has(C.slice(S))}function GC(C){try{let S=JSON.parse(n(C,"utf8"));if(!S.cline||typeof S.cline!=="object")return null;return S.cline}catch{return null}}function IC(C){let S=C?.plugins;if(!Array.isArray(S))return[];return S.flatMap((E)=>E.paths??[])}function OC(C){let S=D(C);if(!T(S)||!q(S).isDirectory())return null;let E=_(S,m);if(T(E)){let I=GC(E),G=IC(I).map((O)=>D(S,O)).filter((O)=>T(O)&&q(O).isFile()&&Q(O));if(G.length>0)return G}for(let I of eC){let G=_(S,I);if(T(G)&&q(G).isFile())return[G]}return null}function tC(C){try{let S=JSON.parse(n(C,"utf8"));return typeof S.name==="string"&&S.name.trim()?S.name.trim():void 0}catch{return}}function aC(C,S){let E=UC(D(C),D(S));return E===""||!E.startsWith("..")&&!jC(E)}function CS(C,S){let E=U(C),I=D(S);while(aC(I,E)){let G=_(E,m);if(T(G)){let N=tC(G);if(N)return N;break}let O=D(E,"..");if(O===E)break;E=O}return BC(C,XC(C))}function TC(C){let S=D(C);if(!T(S))return[];let E=[],I=[S];while(I.length>0){let G=I.pop();if(!G)continue;let O;try{O=$C(G,{withFileTypes:!0})}catch{continue}for(let N of O){let M=_(G,N.name);if(N.isDirectory()){let H=_(M,m);if(T(H)){let NC=GC(H),f=IC(NC).map((v)=>D(M,v)).filter((v)=>T(v)&&q(v).isFile()&&Q(v));if(f.length>0){E.push(...f);continue}}I.push(M);continue}if(N.name.startsWith("."))continue;if(N.isFile()&&Q(M))E.push(M)}}return E.sort((G,O)=>G.localeCompare(O))}function SS(C,S){let E=[];for(let I of C){let G=I.trim();if(!G)continue;let O=D(S,G);if(!T(O))throw Error(`Plugin path does not exist: ${O}`);if(q(O).isDirectory()){let M=OC(O);if(M){E.push(...M);continue}E.push(...TC(O));continue}if(!Q(O))throw Error(`Plugin file must use a supported extension (${[..._C].join(", ")}): ${O}`);E.push(O)}return E}function LC(C){let S=U(C);if(!T(S))b(S,{recursive:!0})}function ES(C){b(U(C),{recursive:!0}),ZC(C,"")}function _S(C){if(C?.trim())return LC(C),U(C);let S=_(L(),"logs");if(!T(S))b(S,{recursive:!0});return S}export{JC as setHomeDirIfUnset,gC as setHomeDir,VC as setClineDirIfUnset,bC as setClineDir,J as resolveWorkspaceCronSpecsDir,rC as resolveWorkflowsConfigSearchPaths,uC as resolveTeamDataDir,nC as resolveSkillsConfigSearchPaths,xC as resolveSessionDataDir,hC as resolveRulesConfigSearchPaths,dC as resolveProviderSettingsPath,OC as resolvePluginModuleEntries,iC as resolvePluginConfigSearchPaths,pC as resolveMcpSettingsPath,cC as resolveHooksConfigSearchPaths,oC as resolveGlobalSettingsPath,CC as resolveGlobalCronSpecsDir,EC as resolveGlobalAgentsRulesPath,RC as resolveExistingFilePath,R as resolveDocumentsExtensionPath,t as resolveDocumentsClineDirectoryPath,y as resolveDbDataDir,k as resolveCronSpecsDir,fC as resolveCronReportsDir,lC as resolveCronEventsDir,mC as resolveCronDbPath,kC as resolveConnectorsDbPath,yC as resolveConnectorSettingsPath,wC as resolveConnectorLogPath,a as resolveConnectorDataDir,SS as resolveConfiguredPluginModulePaths,F as resolveClineDir,L as resolveClineDataDir,zC as resolveChatWorkspacePath,SC as resolveAgentsConfigDirPath,PC as resolveAgentConfigSearchPaths,Q as isPluginModulePath,P as isChatWorkspacePath,CS as getPluginDisplayName,LC as ensureParentDir,_S as ensureHookLogDir,ES as ensureFileExists,TC as discoverPluginModulePaths,B as WORKFLOWS_CONFIG_DIRECTORY_NAME,X as SKILLS_CONFIG_DIRECTORY_NAME,g as RULES_CONFIG_DIRECTORY_NAME,A as HOOKS_CONFIG_DIRECTORY_NAME,Z as CLINE_WORKSPACES_DIRECTORY_NAME,h as CLINE_MCP_SETTINGS_FILE_NAME,r as CLINE_CONNECTOR_SETTINGS_FILE_NAME,$ as CLINE_CHAT_WORKSPACE_DIRECTORY_NAME,u as AGENT_CONFIG_DIRECTORY_NAME,w as AGENTS_RULES_FILE_NAME};
+var MC=Object.defineProperty;var FC=(C)=>C;function WC(C,S){this[C]=FC.bind(null,S)}var DS=(C,S)=>{for(var T in S)MC(C,T,{get:S[T],enumerable:!0,configurable:!0,set:WC.bind(S,T)})};import{existsSync as K,readdirSync as YC}from"node:fs";import{basename as s,dirname as o,join as p}from"node:path";var KC=/[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g,qC=" ";function l(C){return C.normalize("NFC").replace(KC," ")}function QC(C){let S=s(C),T=S.replace(/ (AM|PM)\./gi,`${qC}$1.`);return T===S?C:p(o(C),T)}function ZC(C){return C.normalize("NFD")}function d(C){return C.replace(/'/g,"’")}function $C(C){let S=o(C),T=l(s(C));try{for(let G of YC(S))if(l(G)===T)return p(S,G)}catch{}return}function AC(C){if(K(C))return C;let S=QC(C);if(S!==C&&K(S))return S;let T=ZC(C);if(T!==C&&K(T))return T;let G=d(C);if(G!==C&&K(G))return G;let _=d(T);if(_!==T&&_!==G&&K(_))return _;return $C(C)}import{appendFileSync as RC,existsSync as I,mkdirSync as V,readdirSync as BC,readFileSync as h,statSync as q}from"node:fs";import{homedir as XC}from"node:os";import{basename as jC,dirname as U,extname as UC,isAbsolute as HC,join as E,relative as zC,resolve as M}from"node:path";var $="workspaces",A="chat";function P(C){let S=C.trim(),T=/^[A-Za-z]:[\\/]/.test(S)||S.startsWith("\\\\"),G=S.startsWith("/");if(!T&&!G)return!1;let _=S.split(T?/[\\/]+/:/\/+/).filter(Boolean),O=_.at(-1)??"",v=_.at(-2)??"",L=_.at(-3)??"";return(_.at(-4)??"")===".cline"&&L==="data"&&v==="workspaces"&&O==="chat"}var x=".clinerules",H=".cline",u=".agents",y="agents",R="hooks",X="skills",b="rules",B="workflows",c="plugins",w="AGENTS.md";function gC(){return E(D(),$,A)}var n="cline_mcp_settings.json",r="settings.json";function bC(){let C=process?.env?.HOME?.trim();if(C&&C!=="~")return C;let S=process?.env?.USERPROFILE?.trim();if(S)return S;let T=process?.env?.HOMEDRIVE?.trim(),G=process?.env?.HOMEPATH?.trim();if(T&&G)return`${T}${G}`;let _=XC().trim();if(_&&_!=="~")return _;return"~"}var F=bC(),i=!1;function JC(C){let S=C.trim();if(!S)return;F=S,i=!0}function VC(C){if(i)return;let S=C.trim();if(!S)return;F=S}var j,e=!1;function xC(C){let S=C.trim();if(!S)return;j=S,e=!0}function uC(C){if(e)return;let S=C.trim();if(!S)return;j=S}function N(){if(j)return j;let C=process.env.CLINE_DIR?.trim();if(C)return C;return E(F,".cline")}function t(){return E(F,"Documents","Cline")}function Z(C){return E(t(),C)}function D(){let C=process.env.CLINE_DATA_DIR?.trim();if(C)return C;return E(N(),"data")}function yC(){let C=process.env.CLINE_SESSION_DATA_DIR?.trim();if(C)return C;return E(D(),"sessions")}function wC(){let C=process.env.CLINE_TEAM_DATA_DIR?.trim();if(C)return C;return E(D(),"teams")}function a(){let C=process.env.CLINE_CONNECTOR_DATA_DIR?.trim();if(C)return C;return E(D(),"connectors")}function kC(C,S){let T=C.replace(/[^a-zA-Z0-9._-]+/g,"_"),G=S.replace(/[^a-zA-Z0-9._-]+/g,"_");return E(D(),"logs","connectors",T,`${G}.log`)}function mC(){let C=process.env.CLINE_CONNECTOR_SETTINGS_PATH?.trim();if(C)return C;return E(a(),r)}function z(){let C=process.env.CLINE_DB_DATA_DIR?.trim();if(C)return C;return E(D(),"db")}function fC(){let C=process.env.CLINE_CONNECTORS_DB_PATH?.trim();if(C)return C;return E(z(),"connectors.db")}function lC(){let C=process.env.CLINE_CRON_DB_PATH?.trim();if(C)return C;return E(z(),"cron.db")}function dC(){let C=process.env.CLINE_TASKS_DB_PATH?.trim();if(C)return C;return E(z(),"tasks.db")}function CC(){return E(N(),"tasks")}function SC(C){let S=C.trim();if(!S)throw Error("workspaceRoot is required for workspace task scope");return E(S,".cline","tasks")}function sC(C){let S=C.taskSpecsDir?.trim();if(S)return S;if(C.scope==="workspace")return SC(C.workspaceRoot??"");return CC()}function TC(){return E(N(),"cron")}function J(C){return E(C,".cline","cron")}function k(C){if(typeof C==="string")return J(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 J(S)}return TC()}function oC(C){return E(k(C),"reports")}function pC(C){return E(k(C),"events")}function PC(){let C=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(C)return C;return E(D(),"settings","providers.json")}function cC(){let C=process.env.CLINE_GLOBAL_SETTINGS_PATH?.trim();if(C)return C;return E(D(),"settings","global-settings.json")}function hC(){let C=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(C)return C;return E(D(),"settings",n)}function W(C){let S=new Set,T=[];for(let G of C){if(!G||S.has(G))continue;S.add(G),T.push(G)}return T}function nC(C){if(!C)return[];return[x,H,u].map((S)=>E(C,S,X))}function EC(){return E(N(),y)}function rC(C){return W([C?E(C,H,y):"",EC()])}function iC(C){let S=[Z("Hooks"),E(N(),R)];if(C)S.push(E(C,x,R),E(C,H,R));return W(S)}function eC(C){return W([...nC(C),E(N(),X),E(F,u,X)])}function _C(){return E(F,u,w)}function tC(C){let S=C?[E(C,x),E(C,H,b)]:[],T=C?[E(C,w)]:[];return W([...T,...S,_C(),E(N(),b),Z("Rules")])}function aC(C){return W([C?E(C,".clinerules",B):"",Z("Workflows"),E(N(),B),C?E(C,".cline",B):""])}function CS(C){return W([C?E(C,".cline",c):"",E(N(),c),Z("Plugins")])}var GC=new Set([".js",".ts"]),m="package.json",SS=["index.ts","index.js"];function Q(C){let S=C.lastIndexOf(".");if(S===-1)return!1;return GC.has(C.slice(S))}function OC(C){try{let S=JSON.parse(h(C,"utf8"));if(!S.cline||typeof S.cline!=="object")return null;return S.cline}catch{return null}}function IC(C){let S=C?.plugins;if(!Array.isArray(S))return[];return S.flatMap((T)=>T.paths??[])}function DC(C){let S=M(C);if(!I(S)||!q(S).isDirectory())return null;let T=E(S,m);if(I(T)){let G=OC(T),_=IC(G).map((O)=>M(S,O)).filter((O)=>I(O)&&q(O).isFile()&&Q(O));if(_.length>0)return _}for(let G of SS){let _=E(S,G);if(I(_)&&q(_).isFile())return[_]}return null}function TS(C){try{let S=JSON.parse(h(C,"utf8"));return typeof S.name==="string"&&S.name.trim()?S.name.trim():void 0}catch{return}}function ES(C,S){let T=zC(M(C),M(S));return T===""||!T.startsWith("..")&&!HC(T)}function _S(C,S){let T=U(C),G=M(S);while(ES(G,T)){let _=E(T,m);if(I(_)){let v=TS(_);if(v)return v;break}let O=M(T,"..");if(O===T)break;T=O}return jC(C,UC(C))}function vC(C){let S=M(C);if(!I(S))return[];let T=[],G=[S];while(G.length>0){let _=G.pop();if(!_)continue;let O;try{O=BC(_,{withFileTypes:!0})}catch{continue}for(let v of O){let L=E(_,v.name);if(v.isDirectory()){let g=E(L,m);if(I(g)){let NC=OC(g),f=IC(NC).map((Y)=>M(L,Y)).filter((Y)=>I(Y)&&q(Y).isFile()&&Q(Y));if(f.length>0){T.push(...f);continue}}G.push(L);continue}if(v.name.startsWith("."))continue;if(v.isFile()&&Q(L))T.push(L)}}return T.sort((_,O)=>_.localeCompare(O))}function GS(C,S){let T=[];for(let G of C){let _=G.trim();if(!_)continue;let O=M(S,_);if(!I(O))throw Error(`Plugin path does not exist: ${O}`);if(q(O).isDirectory()){let L=DC(O);if(L){T.push(...L);continue}T.push(...vC(O));continue}if(!Q(O))throw Error(`Plugin file must use a supported extension (${[...GC].join(", ")}): ${O}`);T.push(O)}return T}function LC(C){let S=U(C);if(!I(S))V(S,{recursive:!0})}function OS(C){V(U(C),{recursive:!0}),RC(C,"")}function IS(C){if(C?.trim())return LC(C),U(C);let S=E(D(),"logs");if(!I(S))V(S,{recursive:!0});return S}export{VC as setHomeDirIfUnset,JC as setHomeDir,uC as setClineDirIfUnset,xC as setClineDir,SC as resolveWorkspaceTaskSpecsDir,J as resolveWorkspaceCronSpecsDir,aC as resolveWorkflowsConfigSearchPaths,wC as resolveTeamDataDir,dC as resolveTasksDbPath,sC as resolveTaskSpecsDir,eC as resolveSkillsConfigSearchPaths,yC as resolveSessionDataDir,tC as resolveRulesConfigSearchPaths,PC as resolveProviderSettingsPath,DC as resolvePluginModuleEntries,CS as resolvePluginConfigSearchPaths,hC as resolveMcpSettingsPath,iC as resolveHooksConfigSearchPaths,CC as resolveGlobalTaskSpecsDir,cC as resolveGlobalSettingsPath,TC as resolveGlobalCronSpecsDir,_C as resolveGlobalAgentsRulesPath,AC as resolveExistingFilePath,Z as resolveDocumentsExtensionPath,t as resolveDocumentsClineDirectoryPath,z as resolveDbDataDir,k as resolveCronSpecsDir,oC as resolveCronReportsDir,pC as resolveCronEventsDir,lC as resolveCronDbPath,fC as resolveConnectorsDbPath,mC as resolveConnectorSettingsPath,kC as resolveConnectorLogPath,a as resolveConnectorDataDir,GS as resolveConfiguredPluginModulePaths,N as resolveClineDir,D as resolveClineDataDir,gC as resolveChatWorkspacePath,EC as resolveAgentsConfigDirPath,rC as resolveAgentConfigSearchPaths,Q as isPluginModulePath,P as isChatWorkspacePath,_S as getPluginDisplayName,LC as ensureParentDir,IS as ensureHookLogDir,OS as ensureFileExists,vC as discoverPluginModulePaths,B as WORKFLOWS_CONFIG_DIRECTORY_NAME,X as SKILLS_CONFIG_DIRECTORY_NAME,b as RULES_CONFIG_DIRECTORY_NAME,R as HOOKS_CONFIG_DIRECTORY_NAME,$ as CLINE_WORKSPACES_DIRECTORY_NAME,n as CLINE_MCP_SETTINGS_FILE_NAME,r as CLINE_CONNECTOR_SETTINGS_FILE_NAME,A as CLINE_CHAT_WORKSPACE_DIRECTORY_NAME,y as AGENT_CONFIG_DIRECTORY_NAME,w as AGENTS_RULES_FILE_NAME};

package/dist/storage/paths.d.ts

@@ -48,6 +48,21 @@ export declare function resolveConnectorsDbPath(): string;
  * retention, and query patterns stay decoupled from session storage.
  */
 export declare function resolveCronDbPath(): string;
+/** Path to the dedicated agenda task queue database. */
+export declare function resolveTasksDbPath(): string;
+export type TaskSpecsScope = "global" | "workspace";
+export interface ResolveTaskSpecsDirOptions {
+    /** Explicit directory, primarily for tests and embedded hosts. */
+    taskSpecsDir?: string;
+    scope: TaskSpecsScope;
+    /** Required for workspace-scoped task specs. */
+    workspaceRoot?: string;
+}
+/** Global file-backed agenda tasks: `~/.cline/tasks/`. */
+export declare function resolveGlobalTaskSpecsDir(): string;
+/** Workspace file-backed agenda tasks: `<workspace>/.cline/tasks/`. */
+export declare function resolveWorkspaceTaskSpecsDir(workspaceRoot: string): string;
+export declare function resolveTaskSpecsDir(options: ResolveTaskSpecsDirOptions): string;
 export type CronSpecsScope = "global" | "workspace";
 export interface ResolveCronSpecsDirOptions {
     /**

package/dist/tasks.d.ts

@@ -0,0 +1,156 @@
+import type { GatewayModelSelection } from "./llms/gateway";
+/** Semantic labels used to group work on a user's agenda. */
+export type AgendaTaskType = "suggestion" | "follow-up" | "todo" | "handoff" | "idea" | "reminder";
+export type AgendaTaskStatus = "pending_approval" | "approved" | "in_progress" | "completed" | "failed" | "cancelled" | "expired";
+/** Lower numbers are more urgent. P3 is the default priority. */
+export type AgendaTaskPriority = 0 | 1 | 2 | 3 | 4 | 5;
+export type AgendaTaskScope = "workspace" | "global";
+export interface AgendaTaskActor {
+    kind: "user" | "agent" | "system" | "automation_policy";
+    id?: string;
+    displayName?: string;
+    clientId?: string;
+    sessionId?: string;
+    agentId?: string;
+}
+export type AgendaTaskRunStatus = "starting" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
+export interface AgendaTaskRecord {
+    taskId: string;
+    type: AgendaTaskType;
+    status: AgendaTaskStatus;
+    title: string;
+    description?: string;
+    instructions: string;
+    scope: AgendaTaskScope;
+    workspaceRoot?: string;
+    cwd?: string;
+    resourcePaths: string[];
+    priority: AgendaTaskPriority;
+    assignee?: string;
+    modelSelection?: GatewayModelSelection;
+    mode?: "act" | "plan" | "yolo";
+    systemPrompt?: string;
+    maxIterations?: number;
+    timeoutSeconds?: number;
+    /** Task cannot be started before this ISO-8601 timestamp. */
+    availableAt: string;
+    /** Required latest-start timestamp. */
+    expiresAt: string;
+    automationEligible: boolean;
+    revision: number;
+    approvedRevision?: number;
+    createdBy: AgendaTaskActor;
+    updatedBy: AgendaTaskActor;
+    originSessionId?: string;
+    originTaskId?: string;
+    currentRunId?: string;
+    lastRunId?: string;
+    lastSessionId?: string;
+    /** Canonical Markdown source file backing this task. */
+    specPath?: string;
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    archivedAt?: string;
+}
+export interface AgendaTaskRunRecord {
+    runId: string;
+    taskId: string;
+    taskRevision: number;
+    attempt: number;
+    status: AgendaTaskRunStatus;
+    claimToken?: string;
+    claimUntilAt?: string;
+    requestedByClientId?: string;
+    sessionId?: string;
+    claimedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    resultSummary?: string;
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgendaTaskCreateInput {
+    taskId?: string;
+    type: AgendaTaskType;
+    title: string;
+    description?: string;
+    instructions: string;
+    scope: AgendaTaskScope;
+    workspaceRoot?: string;
+    cwd?: string;
+    resourcePaths?: string[];
+    priority?: AgendaTaskPriority;
+    assignee?: string;
+    modelSelection?: GatewayModelSelection;
+    mode?: "act" | "plan" | "yolo";
+    systemPrompt?: string;
+    maxIterations?: number;
+    timeoutSeconds?: number;
+    availableAt?: string;
+    expiresAt: string;
+    automationEligible?: boolean;
+    /** False only when a trusted interactive user directly authored the item. */
+    requiresApproval?: boolean;
+    createdBy: AgendaTaskActor;
+    originSessionId?: string;
+    originTaskId?: string;
+    /** Optional explicit source path; managers normally derive this. */
+    specPath?: string;
+}
+/** Editable task fields. Lifecycle transitions are owned by the task manager. */
+export interface AgendaTaskUpdateInput {
+    taskId: string;
+    expectedRevision: number;
+    type?: AgendaTaskType;
+    title?: string;
+    description?: string | null;
+    instructions?: string;
+    scope?: AgendaTaskScope;
+    workspaceRoot?: string | null;
+    cwd?: string | null;
+    resourcePaths?: string[];
+    priority?: AgendaTaskPriority;
+    assignee?: string | null;
+    modelSelection?: GatewayModelSelection | null;
+    mode?: "act" | "plan" | "yolo" | null;
+    systemPrompt?: string | null;
+    maxIterations?: number | null;
+    timeoutSeconds?: number | null;
+    availableAt?: string;
+    expiresAt?: string;
+    automationEligible?: boolean;
+    updatedBy: AgendaTaskActor;
+}
+export interface AgendaTaskListInput {
+    statuses?: AgendaTaskStatus[];
+    types?: AgendaTaskType[];
+    /** Explicit scope filtering. Omit to include global tasks with a workspace view. */
+    scope?: AgendaTaskScope;
+    /**
+     * Selected workspace. With no explicit scope, results contain global tasks plus
+     * tasks for this workspace. `scope: "workspace"` is workspace-only, while
+     * `scope: "global"` ignores this value and remains global-only.
+     */
+    workspaceRoot?: string;
+    priorities?: AgendaTaskPriority[];
+    automationEligible?: boolean;
+    availableBefore?: string;
+    includeArchived?: boolean;
+    limit?: number;
+}
+export type AgendaAutomationMode = "manual" | "auto_start" | "unattended";
+export interface AgendaAutomationPolicy {
+    /** `global` in v1; allows workspace/type-specific policies later. */
+    scopeKey: string;
+    mode: AgendaAutomationMode;
+    applyToAgentCreated: boolean;
+    maxConcurrentRuns: number;
+    maxChainDepth: number;
+    maxStartsPerHour: number;
+    enabledBy?: AgendaTaskActor;
+    enabledAt?: string;
+    updatedAt: string;
+}

package/dist/team/schema.d.ts

@@ -39,8 +39,8 @@ export declare const TeamTaskInputSchema: z.ZodObject<{
     assignee: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
     status: z.ZodPreprocess<z.ZodOptional<z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>>>;
     taskId: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
@@ -63,8 +63,8 @@ export declare const TeamListRunsInputSchema: z.ZodObject<{
         completed: "completed";
         failed: "failed";
         cancelled: "cancelled";
-        queued: "queued";
         interrupted: "interrupted";
+        queued: "queued";
     }>>>;
     agentId: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
     includeCompleted: z.ZodPreprocess<z.ZodOptional<z.ZodBoolean>>;
@@ -93,10 +93,10 @@ export declare const TeamReadMailboxInputSchema: z.ZodObject<{
 export declare const TeamMissionLogInputSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         error: "error";
+        handoff: "handoff";
         done: "done";
         blocked: "blocked";
         progress: "progress";
-        handoff: "handoff";
         decision: "decision";
     }>;
     summary: z.ZodString;
@@ -160,8 +160,8 @@ export declare const TeamStatusToolResultSchema: z.ZodObject<{
     }, z.core.$strip>>;
     taskCounts: z.ZodRecord<z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>, z.ZodNumber>;
     unreadMessages: z.ZodNumber;
@@ -180,8 +180,8 @@ export declare const TeamTaskListItemToolResultSchema: z.ZodObject<{
     description: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>;
     createdAt: z.ZodPreprocess<z.ZodString>;
@@ -198,8 +198,8 @@ export declare const TeamTaskToolResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     taskId: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>;
     ignoredFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -212,8 +212,8 @@ export declare const TeamTaskToolResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
         description: z.ZodString;
         status: z.ZodEnum<{
             completed: "completed";
-            pending: "pending";
             in_progress: "in_progress";
+            pending: "pending";
             blocked: "blocked";
         }>;
         createdAt: z.ZodPreprocess<z.ZodString>;
@@ -230,8 +230,8 @@ export declare const TeamTaskToolResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     taskId: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>;
     nextStep: z.ZodString;
@@ -240,8 +240,8 @@ export declare const TeamTaskToolResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     taskId: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>;
 }, z.core.$strip>, z.ZodObject<{
@@ -249,8 +249,8 @@ export declare const TeamTaskToolResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     taskId: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
-        pending: "pending";
         in_progress: "in_progress";
+        pending: "pending";
         blocked: "blocked";
     }>;
 }, z.core.$strip>], "action">;
@@ -295,8 +295,8 @@ export declare const TeamRunToolSummarySchema: z.ZodObject<{
         completed: "completed";
         failed: "failed";
         cancelled: "cancelled";
-        queued: "queued";
         interrupted: "interrupted";
+        queued: "queued";
     }>;
     messagePreview: z.ZodString;
     priority: z.ZodNumber;
@@ -371,8 +371,8 @@ export declare const TeamCancelRunToolResultSchema: z.ZodObject<{
         completed: "completed";
         failed: "failed";
         cancelled: "cancelled";
-        queued: "queued";
         interrupted: "interrupted";
+        queued: "queued";
     }>;
 }, z.core.$strip>;
 export declare const TeamSendMessageToolResultSchema: z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cline/shared",
-	"version": "0.0.75",
+	"version": "0.0.76",
 	"description": "Shared utilities, types, and schemas for Cline packages",
 	"repository": {
 		"type": "git",