@cline/shared 0.0.75-nightly.1787107092 → 0.0.76

package/dist/agent.d.ts

@@ -214,7 +214,11 @@ export type AgentModelEvent = {
 } | {
     type: "tool-result";
     toolCallId: string;
-    toolName: import("./llms/model-tools").ModelToolName;
+    /**
+     * Declared model tools carry a ModelToolName; provider-executed tools
+     * (e.g. the Claude Code CLI's own tools) carry arbitrary names.
+     */
+    toolName: string;
     input?: unknown;
     output: unknown;
     isError?: boolean;
@@ -272,6 +276,13 @@ export interface AgentBeforeToolResult {
     reason?: string;
     input?: unknown;
     policy?: ToolPolicy;
+    /**
+     * Text to inject into the conversation as hook context (e.g. a hook's
+     * `contextModification`). Collected across hooks and appended after this
+     * iteration's tool results as a `<hook_context>` user message, so the
+     * model sees it on the next request.
+     */
+    appendContext?: string;
 }
 export interface AgentAfterToolContext {
     snapshot: AgentRuntimeStateSnapshot;
@@ -287,6 +298,13 @@ export interface AgentAfterToolResult {
     stop?: boolean;
     reason?: string;
     result?: AgentToolResult;
+    /**
+     * Text to inject into the conversation as hook context (e.g. a hook's
+     * `contextModification`). Collected across hooks and appended after this
+     * iteration's tool results as a `<hook_context>` user message, so the
+     * model sees it on the next request.
+     */
+    appendContext?: string;
 }
 export interface AgentRunLifecycleContext {
     snapshot: AgentRuntimeStateSnapshot;
@@ -319,6 +337,11 @@ export interface AgentRuntimePlugin {
     setup?: (context: AgentRuntimePluginContext) => AgentRuntimePluginSetup | undefined | Promise<AgentRuntimePluginSetup | undefined>;
 }
 export interface AgentRuntimeConfig {
+    /**
+     * Stable end-user distinct ID used for provider and observability metadata.
+     * This is intentionally separate from the host-owned session id.
+     */
+    distinctId?: string;
     /**
      * Core/hub runtime session identifier.
      *

package/dist/db/index.js

@@ -1,4 +1,4 @@
-var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null,$)}var j0=(Z,$)=>{for(var j in $)FZ(Z,j,{get:$[j],enumerable:!0,configurable:!0,set:YZ.bind($,j)})};import{existsSync as rZ,readFileSync as tZ,renameSync as aZ}from"node:fs";import{appendFileSync as HZ,existsSync as U,mkdirSync as b,readdirSync as LZ,readFileSync as o,statSync as T}from"node:fs";import{homedir as BZ}from"node:os";import{basename as JZ,dirname as D,extname as MZ,isAbsolute as qZ,join as Q,relative as NZ,resolve as Y}from"node:path";var f="workspaces",E="chat";function OZ(Z){let $=Z.trim(),j=/^[A-Za-z]:[\\/]/.test($)||$.startsWith("\\\\"),X=$.startsWith("/");if(!j&&!X)return!1;let K=$.split(j?/[\\/]+/:/\/+/).filter(Boolean),W=K.at(-1)??"",z=K.at(-2)??"",V=K.at(-3)??"";return(K.at(-4)??"")===".cline"&&V==="data"&&z==="workspaces"&&W==="chat"}var g=".clinerules",I=".cline",m=".agents",s="agents",R="hooks",k="skills",l="rules",v="workflows",c="plugins",n="AGENTS.md";function U0(){return Q(F(),f,E)}var AZ="cline_mcp_settings.json",TZ="settings.json";function xZ(){let Z=process?.env?.HOME?.trim();if(Z&&Z!=="~")return Z;let $=process?.env?.USERPROFILE?.trim();if($)return $;let j=process?.env?.HOMEDRIVE?.trim(),X=process?.env?.HOMEPATH?.trim();if(j&&X)return`${j}${X}`;let K=BZ().trim();if(K&&K!=="~")return K;return"~"}var q=xZ(),r=!1;function F0(Z){let $=Z.trim();if(!$)return;q=$,r=!0}function G0(Z){if(r)return;let $=Z.trim();if(!$)return;q=$}var _,t=!1;function Y0(Z){let $=Z.trim();if(!$)return;_=$,t=!0}function O0(Z){if(t)return;let $=Z.trim();if(!$)return;_=$}function O(){if(_)return _;let Z=process.env.CLINE_DIR?.trim();if(Z)return Z;return Q(q,".cline")}function _Z(){return Q(q,"Documents","Cline")}function S(Z){return Q(_Z(),Z)}function F(){let Z=process.env.CLINE_DATA_DIR?.trim();if(Z)return Z;return Q(O(),"data")}function H0(){let Z=process.env.CLINE_SESSION_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"sessions")}function L0(){let Z=process.env.CLINE_TEAM_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"teams")}function CZ(){let Z=process.env.CLINE_CONNECTOR_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"connectors")}function B0(Z,$){let j=Z.replace(/[^a-zA-Z0-9._-]+/g,"_"),X=$.replace(/[^a-zA-Z0-9._-]+/g,"_");return Q(F(),"logs","connectors",j,`${X}.log`)}function a(){let Z=process.env.CLINE_CONNECTOR_SETTINGS_PATH?.trim();if(Z)return Z;return Q(CZ(),TZ)}function e(){let Z=process.env.CLINE_DB_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"db")}function ZZ(){let Z=process.env.CLINE_CONNECTORS_DB_PATH?.trim();if(Z)return Z;return Q(e(),"connectors.db")}function J0(){let Z=process.env.CLINE_CRON_DB_PATH?.trim();if(Z)return Z;return Q(e(),"cron.db")}function DZ(){return Q(O(),"cron")}function i(Z){return Q(Z,".cline","cron")}function $Z(Z){if(typeof Z==="string")return i(Z);if(Z?.cronSpecsDir?.trim())return Z.cronSpecsDir.trim();if(Z?.scope==="workspace"){let $=Z.workspaceRoot?.trim();if(!$)throw Error("workspaceRoot is required for workspace cron scope");return i($)}return DZ()}function M0(Z){return Q($Z(Z),"reports")}function q0(Z){return Q($Z(Z),"events")}function N0(){let Z=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(Z)return Z;return Q(F(),"settings","providers.json")}function A0(){let Z=process.env.CLINE_GLOBAL_SETTINGS_PATH?.trim();if(Z)return Z;return Q(F(),"settings","global-settings.json")}function T0(){let Z=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(Z)return Z;return Q(F(),"settings",AZ)}function N(Z){let $=new Set,j=[];for(let X of Z){if(!X||$.has(X))continue;$.add(X),j.push(X)}return j}function IZ(Z){if(!Z)return[];return[g,I,m].map(($)=>Q(Z,$,k))}function SZ(){return Q(O(),s)}function x0(Z){return N([Z?Q(Z,I,s):"",SZ()])}function _0(Z){let $=[S("Hooks"),Q(O(),R)];if(Z)$.push(Q(Z,g,R),Q(Z,I,R));return N($)}function C0(Z){return N([...IZ(Z),Q(O(),k),Q(q,m,k)])}function fZ(){return Q(q,m,n)}function D0(Z){let $=Z?[Q(Z,g),Q(Z,I,l)]:[],j=Z?[Q(Z,n)]:[];return N([...j,...$,fZ(),Q(O(),l),S("Rules")])}function I0(Z){return N([Z?Q(Z,".clinerules",v):"",S("Workflows"),Q(O(),v),Z?Q(Z,".cline",v):""])}function S0(Z){return N([Z?Q(Z,".cline",c):"",Q(O(),c),S("Plugins")])}var jZ=new Set([".js",".ts"]),y="package.json",EZ=["index.ts","index.js"];function C(Z){let $=Z.lastIndexOf(".");if($===-1)return!1;return jZ.has(Z.slice($))}function XZ(Z){try{let $=JSON.parse(o(Z,"utf8"));if(!$.cline||typeof $.cline!=="object")return null;return $.cline}catch{return null}}function KZ(Z){let $=Z?.plugins;if(!Array.isArray($))return[];return $.flatMap((j)=>j.paths??[])}function RZ(Z){let $=Y(Z);if(!U($)||!T($).isDirectory())return null;let j=Q($,y);if(U(j)){let X=XZ(j),K=KZ(X).map((W)=>Y($,W)).filter((W)=>U(W)&&T(W).isFile()&&C(W));if(K.length>0)return K}for(let X of EZ){let K=Q($,X);if(U(K)&&T(K).isFile())return[K]}return null}function vZ(Z){try{let $=JSON.parse(o(Z,"utf8"));return typeof $.name==="string"&&$.name.trim()?$.name.trim():void 0}catch{return}}function kZ(Z,$){let j=NZ(Y(Z),Y($));return j===""||!j.startsWith("..")&&!qZ(j)}function f0(Z,$){let j=D(Z),X=Y($);while(kZ(X,j)){let K=Q(j,y);if(U(K)){let z=vZ(K);if(z)return z;break}let W=Y(j,"..");if(W===j)break;j=W}return JZ(Z,MZ(Z))}function bZ(Z){let $=Y(Z);if(!U($))return[];let j=[],X=[$];while(X.length>0){let K=X.pop();if(!K)continue;let W;try{W=LZ(K,{withFileTypes:!0})}catch{continue}for(let z of W){let V=Q(K,z.name);if(z.isDirectory()){let L=Q(V,y);if(U(L)){let B=XZ(L),h=KZ(B).map((A)=>Y(V,A)).filter((A)=>U(A)&&T(A).isFile()&&C(A));if(h.length>0){j.push(...h);continue}}X.push(V);continue}if(z.name.startsWith("."))continue;if(z.isFile()&&C(V))j.push(V)}}return j.sort((K,W)=>K.localeCompare(W))}function E0(Z,$){let j=[];for(let X of Z){let K=X.trim();if(!K)continue;let W=Y($,K);if(!U(W))throw Error(`Plugin path does not exist: ${W}`);if(T(W).isDirectory()){let V=RZ(W);if(V){j.push(...V);continue}j.push(...bZ(W));continue}if(!C(W))throw Error(`Plugin file must use a supported extension (${[...jZ].join(", ")}): ${W}`);j.push(W)}return j}function gZ(Z){let $=D(Z);if(!U($))b($,{recursive:!0})}function R0(Z){b(D(Z),{recursive:!0}),HZ(Z,"")}function v0(Z){if(Z?.trim())return gZ(Z),D(Z);let $=Q(F(),"logs");if(!U($))b($,{recursive:!0});return $}import{mkdirSync as mZ}from"node:fs";import{createRequire as yZ}from"node:module";import{dirname as uZ}from"node:path";function QZ(Z){if(Z instanceof Error)return Z.message;return String(Z)}function WZ(Z){if(Z&&typeof Z==="object"&&"code"in Z&&typeof Z.code==="string")return Z.code;return""}var wZ=3,PZ=50;function J(){return new Date().toISOString()}function x(Z){return Z?1:0}function G(Z){return typeof Z==="string"?Z:""}function u(Z){if(typeof Z!=="string")return;let $=Z.trim();return $.length>0?$:void 0}function pZ(Z){return Z===1||Z===!0}function dZ(Z){if(Z<=0)return;try{let $=new SharedArrayBuffer(4),j=new Int32Array($);Atomics.wait(j,0,0,Z)}catch{}}function hZ(Z){if(!Z||typeof Z!=="object")return!1;let $=QZ(Z),j=WZ(Z);return j==="SQLITE_BUSY"||j==="SQLITE_LOCKED"||$.includes("SQLITE_BUSY")||$.includes("SQLITE_LOCKED")||$.includes("database is locked")}function H(Z){let $=0;for(;;)try{return Z()}catch(j){if(!hZ(j)||$>=wZ)throw j;$+=1,dZ(PZ*2**($-1))}}function lZ(Z){return{prepare:($)=>{let j=Z.query($);return{run:(...X)=>H(()=>j.run(...X)),get:(...X)=>H(()=>j.get(...X)),all:(...X)=>H(()=>j.all(...X))}},exec:($)=>H(()=>Z.exec($)),close:()=>Z.close?.()}}function cZ(Z){return{prepare:($)=>{let j=Z.prepare($);return{run:(...X)=>H(()=>j.run(...X)),get:(...X)=>H(()=>j.get(...X)??null),all:(...X)=>H(()=>j.all(...X))}},exec:($)=>H(()=>Z.exec($)),close:()=>Z.close?.()}}function w(Z){mZ(uZ(Z),{recursive:!0});let $=yZ(import.meta.url);if(typeof globalThis.Bun<"u"){let{Database:X}=$("bun:sqlite");return lZ(new X(Z,{create:!0}))}let j=process.emitWarning;process.emitWarning=(X,...K)=>{if((typeof X==="string"?X:X?.message??"").includes("SQLite"))return;return j.call(process,X,...K)};try{let{DatabaseSync:X}=$(["node",":sqlite"].join(""));return cZ(new X(Z))}finally{process.emitWarning=j}}var iZ=[`CREATE TABLE IF NOT EXISTS sessions (
+var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null,$)}var K0=(Z,$)=>{for(var j in $)FZ(Z,j,{get:$[j],enumerable:!0,configurable:!0,set:YZ.bind($,j)})};import{existsSync as aZ,readFileSync as eZ,renameSync as Z0}from"node:fs";import{appendFileSync as HZ,existsSync as U,mkdirSync as b,readdirSync as LZ,readFileSync as o,statSync as T}from"node:fs";import{homedir as BZ}from"node:os";import{basename as JZ,dirname as D,extname as MZ,isAbsolute as qZ,join as Q,relative as NZ,resolve as Y}from"node:path";var f="workspaces",E="chat";function OZ(Z){let $=Z.trim(),j=/^[A-Za-z]:[\\/]/.test($)||$.startsWith("\\\\"),X=$.startsWith("/");if(!j&&!X)return!1;let K=$.split(j?/[\\/]+/:/\/+/).filter(Boolean),V=K.at(-1)??"",W=K.at(-2)??"",z=K.at(-3)??"";return(K.at(-4)??"")===".cline"&&z==="data"&&W==="workspaces"&&V==="chat"}var g=".clinerules",I=".cline",m=".agents",n="agents",R="hooks",k="skills",c="rules",v="workflows",i="plugins",r="AGENTS.md";function G0(){return Q(F(),f,E)}var AZ="cline_mcp_settings.json",TZ="settings.json";function _Z(){let Z=process?.env?.HOME?.trim();if(Z&&Z!=="~")return Z;let $=process?.env?.USERPROFILE?.trim();if($)return $;let j=process?.env?.HOMEDRIVE?.trim(),X=process?.env?.HOMEPATH?.trim();if(j&&X)return`${j}${X}`;let K=BZ().trim();if(K&&K!=="~")return K;return"~"}var q=_Z(),t=!1;function Y0(Z){let $=Z.trim();if(!$)return;q=$,t=!0}function O0(Z){if(t)return;let $=Z.trim();if(!$)return;q=$}var x,a=!1;function H0(Z){let $=Z.trim();if(!$)return;x=$,a=!0}function L0(Z){if(a)return;let $=Z.trim();if(!$)return;x=$}function O(){if(x)return x;let Z=process.env.CLINE_DIR?.trim();if(Z)return Z;return Q(q,".cline")}function xZ(){return Q(q,"Documents","Cline")}function S(Z){return Q(xZ(),Z)}function F(){let Z=process.env.CLINE_DATA_DIR?.trim();if(Z)return Z;return Q(O(),"data")}function B0(){let Z=process.env.CLINE_SESSION_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"sessions")}function J0(){let Z=process.env.CLINE_TEAM_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"teams")}function CZ(){let Z=process.env.CLINE_CONNECTOR_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"connectors")}function M0(Z,$){let j=Z.replace(/[^a-zA-Z0-9._-]+/g,"_"),X=$.replace(/[^a-zA-Z0-9._-]+/g,"_");return Q(F(),"logs","connectors",j,`${X}.log`)}function e(){let Z=process.env.CLINE_CONNECTOR_SETTINGS_PATH?.trim();if(Z)return Z;return Q(CZ(),TZ)}function y(){let Z=process.env.CLINE_DB_DATA_DIR?.trim();if(Z)return Z;return Q(F(),"db")}function ZZ(){let Z=process.env.CLINE_CONNECTORS_DB_PATH?.trim();if(Z)return Z;return Q(y(),"connectors.db")}function q0(){let Z=process.env.CLINE_CRON_DB_PATH?.trim();if(Z)return Z;return Q(y(),"cron.db")}function N0(){let Z=process.env.CLINE_TASKS_DB_PATH?.trim();if(Z)return Z;return Q(y(),"tasks.db")}function DZ(){return Q(O(),"tasks")}function IZ(Z){let $=Z.trim();if(!$)throw Error("workspaceRoot is required for workspace task scope");return Q($,".cline","tasks")}function A0(Z){let $=Z.taskSpecsDir?.trim();if($)return $;if(Z.scope==="workspace")return IZ(Z.workspaceRoot??"");return DZ()}function SZ(){return Q(O(),"cron")}function s(Z){return Q(Z,".cline","cron")}function $Z(Z){if(typeof Z==="string")return s(Z);if(Z?.cronSpecsDir?.trim())return Z.cronSpecsDir.trim();if(Z?.scope==="workspace"){let $=Z.workspaceRoot?.trim();if(!$)throw Error("workspaceRoot is required for workspace cron scope");return s($)}return SZ()}function T0(Z){return Q($Z(Z),"reports")}function _0(Z){return Q($Z(Z),"events")}function x0(){let Z=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(Z)return Z;return Q(F(),"settings","providers.json")}function C0(){let Z=process.env.CLINE_GLOBAL_SETTINGS_PATH?.trim();if(Z)return Z;return Q(F(),"settings","global-settings.json")}function D0(){let Z=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(Z)return Z;return Q(F(),"settings",AZ)}function N(Z){let $=new Set,j=[];for(let X of Z){if(!X||$.has(X))continue;$.add(X),j.push(X)}return j}function fZ(Z){if(!Z)return[];return[g,I,m].map(($)=>Q(Z,$,k))}function EZ(){return Q(O(),n)}function I0(Z){return N([Z?Q(Z,I,n):"",EZ()])}function S0(Z){let $=[S("Hooks"),Q(O(),R)];if(Z)$.push(Q(Z,g,R),Q(Z,I,R));return N($)}function f0(Z){return N([...fZ(Z),Q(O(),k),Q(q,m,k)])}function RZ(){return Q(q,m,r)}function E0(Z){let $=Z?[Q(Z,g),Q(Z,I,c)]:[],j=Z?[Q(Z,r)]:[];return N([...j,...$,RZ(),Q(O(),c),S("Rules")])}function R0(Z){return N([Z?Q(Z,".clinerules",v):"",S("Workflows"),Q(O(),v),Z?Q(Z,".cline",v):""])}function v0(Z){return N([Z?Q(Z,".cline",i):"",Q(O(),i),S("Plugins")])}var jZ=new Set([".js",".ts"]),u="package.json",vZ=["index.ts","index.js"];function C(Z){let $=Z.lastIndexOf(".");if($===-1)return!1;return jZ.has(Z.slice($))}function XZ(Z){try{let $=JSON.parse(o(Z,"utf8"));if(!$.cline||typeof $.cline!=="object")return null;return $.cline}catch{return null}}function KZ(Z){let $=Z?.plugins;if(!Array.isArray($))return[];return $.flatMap((j)=>j.paths??[])}function kZ(Z){let $=Y(Z);if(!U($)||!T($).isDirectory())return null;let j=Q($,u);if(U(j)){let X=XZ(j),K=KZ(X).map((V)=>Y($,V)).filter((V)=>U(V)&&T(V).isFile()&&C(V));if(K.length>0)return K}for(let X of vZ){let K=Q($,X);if(U(K)&&T(K).isFile())return[K]}return null}function bZ(Z){try{let $=JSON.parse(o(Z,"utf8"));return typeof $.name==="string"&&$.name.trim()?$.name.trim():void 0}catch{return}}function gZ(Z,$){let j=NZ(Y(Z),Y($));return j===""||!j.startsWith("..")&&!qZ(j)}function k0(Z,$){let j=D(Z),X=Y($);while(gZ(X,j)){let K=Q(j,u);if(U(K)){let W=bZ(K);if(W)return W;break}let V=Y(j,"..");if(V===j)break;j=V}return JZ(Z,MZ(Z))}function mZ(Z){let $=Y(Z);if(!U($))return[];let j=[],X=[$];while(X.length>0){let K=X.pop();if(!K)continue;let V;try{V=LZ(K,{withFileTypes:!0})}catch{continue}for(let W of V){let z=Q(K,W.name);if(W.isDirectory()){let L=Q(z,u);if(U(L)){let B=XZ(L),l=KZ(B).map((A)=>Y(z,A)).filter((A)=>U(A)&&T(A).isFile()&&C(A));if(l.length>0){j.push(...l);continue}}X.push(z);continue}if(W.name.startsWith("."))continue;if(W.isFile()&&C(z))j.push(z)}}return j.sort((K,V)=>K.localeCompare(V))}function b0(Z,$){let j=[];for(let X of Z){let K=X.trim();if(!K)continue;let V=Y($,K);if(!U(V))throw Error(`Plugin path does not exist: ${V}`);if(T(V).isDirectory()){let z=kZ(V);if(z){j.push(...z);continue}j.push(...mZ(V));continue}if(!C(V))throw Error(`Plugin file must use a supported extension (${[...jZ].join(", ")}): ${V}`);j.push(V)}return j}function yZ(Z){let $=D(Z);if(!U($))b($,{recursive:!0})}function g0(Z){b(D(Z),{recursive:!0}),HZ(Z,"")}function m0(Z){if(Z?.trim())return yZ(Z),D(Z);let $=Q(F(),"logs");if(!U($))b($,{recursive:!0});return $}import{mkdirSync as uZ}from"node:fs";import{createRequire as wZ}from"node:module";import{dirname as PZ}from"node:path";function QZ(Z){if(Z instanceof Error)return Z.message;return String(Z)}function VZ(Z){if(Z&&typeof Z==="object"&&"code"in Z&&typeof Z.code==="string")return Z.code;return""}var pZ=3,dZ=50;function J(){return new Date().toISOString()}function _(Z){return Z?1:0}function G(Z){return typeof Z==="string"?Z:""}function w(Z){if(typeof Z!=="string")return;let $=Z.trim();return $.length>0?$:void 0}function hZ(Z){return Z===1||Z===!0}function lZ(Z){if(Z<=0)return;try{let $=new SharedArrayBuffer(4),j=new Int32Array($);Atomics.wait(j,0,0,Z)}catch{}}function cZ(Z){if(!Z||typeof Z!=="object")return!1;let $=QZ(Z),j=VZ(Z);return j==="SQLITE_BUSY"||j==="SQLITE_LOCKED"||$.includes("SQLITE_BUSY")||$.includes("SQLITE_LOCKED")||$.includes("database is locked")}function H(Z){let $=0;for(;;)try{return Z()}catch(j){if(!cZ(j)||$>=pZ)throw j;$+=1,lZ(dZ*2**($-1))}}function iZ(Z){return{prepare:($)=>{let j=Z.query($);return{run:(...X)=>H(()=>j.run(...X)),get:(...X)=>H(()=>j.get(...X)),all:(...X)=>H(()=>j.all(...X))}},exec:($)=>H(()=>Z.exec($)),close:()=>Z.close?.()}}function sZ(Z){return{prepare:($)=>{let j=Z.prepare($);return{run:(...X)=>H(()=>j.run(...X)),get:(...X)=>H(()=>j.get(...X)??null),all:(...X)=>H(()=>j.all(...X))}},exec:($)=>H(()=>Z.exec($)),close:()=>Z.close?.()}}function P(Z){uZ(PZ(Z),{recursive:!0});let $=wZ(import.meta.url);if(typeof globalThis.Bun<"u"){let{Database:X}=$("bun:sqlite");return iZ(new X(Z,{create:!0}))}let j=process.emitWarning;process.emitWarning=(X,...K)=>{if((typeof X==="string"?X:X?.message??"").includes("SQLite"))return;return j.call(process,X,...K)};try{let{DatabaseSync:X}=$(["node",":sqlite"].join(""));return sZ(new X(Z))}finally{process.emitWarning=j}}var oZ=[`CREATE TABLE IF NOT EXISTS sessions (
 		session_id TEXT PRIMARY KEY,
 		source TEXT NOT NULL,
 		pid INTEGER NOT NULL,
@@ -77,7 +77,7 @@ var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null
 		FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE SET NULL
 	);`,`CREATE INDEX IF NOT EXISTS idx_schedule_executions_schedule
 	ON schedule_executions(schedule_id, triggered_at DESC);`,`CREATE INDEX IF NOT EXISTS idx_schedules_next_run
-	ON schedules(enabled, next_run_at);`],oZ=[{table:"sessions",column:"workspace_root",sql:"ALTER TABLE sessions ADD COLUMN workspace_root TEXT;"},{table:"sessions",column:"parent_session_id",sql:"ALTER TABLE sessions ADD COLUMN parent_session_id TEXT;"},{table:"sessions",column:"parent_agent_id",sql:"ALTER TABLE sessions ADD COLUMN parent_agent_id TEXT;"},{table:"sessions",column:"agent_id",sql:"ALTER TABLE sessions ADD COLUMN agent_id TEXT;"},{table:"sessions",column:"conversation_id",sql:"ALTER TABLE sessions ADD COLUMN conversation_id TEXT;"},{table:"sessions",column:"is_subagent",sql:"ALTER TABLE sessions ADD COLUMN is_subagent INTEGER NOT NULL DEFAULT 0;"},{table:"sessions",column:"messages_path",sql:"ALTER TABLE sessions ADD COLUMN messages_path TEXT;"},{table:"sessions",column:"metadata_json",sql:"ALTER TABLE sessions ADD COLUMN metadata_json TEXT;"},{table:"sessions",column:"transcript_path",sql:"ALTER TABLE sessions ADD COLUMN transcript_path TEXT NOT NULL DEFAULT '';"},{table:"schedules",column:"claim_token",sql:"ALTER TABLE schedules ADD COLUMN claim_token TEXT;"},{table:"schedules",column:"claim_started_at",sql:"ALTER TABLE schedules ADD COLUMN claim_started_at TEXT;"},{table:"schedules",column:"claim_until_at",sql:"ALTER TABLE schedules ADD COLUMN claim_until_at TEXT;"}];function sZ(Z,$){return new Set(Z.prepare(`PRAGMA table_info(${$});`).all().map((j)=>j.name))}function nZ(Z,$={}){Z.exec("PRAGMA journal_mode = WAL;"),Z.exec("PRAGMA busy_timeout = 5000;");for(let K of iZ)Z.exec(K);if(!$.includeLegacyMigrations)return;let j=new Map,X=(K)=>{let W=j.get(K);if(!W)W=sZ(Z,K),j.set(K,W);return W};for(let K of oZ)if(!X(K.table).has(K.column)){if(Z.exec(K.sql),K.column==="workspace_root")Z.exec("UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';");j.delete(K.table)}}var eZ=`CREATE TABLE IF NOT EXISTS connector_configs (
+	ON schedules(enabled, next_run_at);`],nZ=[{table:"sessions",column:"workspace_root",sql:"ALTER TABLE sessions ADD COLUMN workspace_root TEXT;"},{table:"sessions",column:"parent_session_id",sql:"ALTER TABLE sessions ADD COLUMN parent_session_id TEXT;"},{table:"sessions",column:"parent_agent_id",sql:"ALTER TABLE sessions ADD COLUMN parent_agent_id TEXT;"},{table:"sessions",column:"agent_id",sql:"ALTER TABLE sessions ADD COLUMN agent_id TEXT;"},{table:"sessions",column:"conversation_id",sql:"ALTER TABLE sessions ADD COLUMN conversation_id TEXT;"},{table:"sessions",column:"is_subagent",sql:"ALTER TABLE sessions ADD COLUMN is_subagent INTEGER NOT NULL DEFAULT 0;"},{table:"sessions",column:"messages_path",sql:"ALTER TABLE sessions ADD COLUMN messages_path TEXT;"},{table:"sessions",column:"metadata_json",sql:"ALTER TABLE sessions ADD COLUMN metadata_json TEXT;"},{table:"sessions",column:"transcript_path",sql:"ALTER TABLE sessions ADD COLUMN transcript_path TEXT NOT NULL DEFAULT '';"},{table:"schedules",column:"claim_token",sql:"ALTER TABLE schedules ADD COLUMN claim_token TEXT;"},{table:"schedules",column:"claim_started_at",sql:"ALTER TABLE schedules ADD COLUMN claim_started_at TEXT;"},{table:"schedules",column:"claim_until_at",sql:"ALTER TABLE schedules ADD COLUMN claim_until_at TEXT;"}];function rZ(Z,$){return new Set(Z.prepare(`PRAGMA table_info(${$});`).all().map((j)=>j.name))}function tZ(Z,$={}){Z.exec("PRAGMA journal_mode = WAL;"),Z.exec("PRAGMA busy_timeout = 5000;");for(let K of oZ)Z.exec(K);if(!$.includeLegacyMigrations)return;let j=new Map,X=(K)=>{let V=j.get(K);if(!V)V=rZ(Z,K),j.set(K,V);return V};for(let K of nZ)if(!X(K.table).has(K.column)){if(Z.exec(K.sql),K.column==="workspace_root")Z.exec("UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';");j.delete(K.table)}}var $0=`CREATE TABLE IF NOT EXISTS connector_configs (
 	channel TEXT PRIMARY KEY,
 	type TEXT NOT NULL,
 	values_json TEXT NOT NULL DEFAULT '{}',
@@ -85,7 +85,7 @@ var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null
 	security_values_json TEXT NOT NULL DEFAULT '{}',
 	configured_at TEXT NOT NULL,
 	updated_at TEXT NOT NULL
-);`,Z0=`CREATE TABLE IF NOT EXISTS connector_connections (
+);`,j0=`CREATE TABLE IF NOT EXISTS connector_connections (
 	channel TEXT NOT NULL,
 	instance_id TEXT NOT NULL,
 	connect_args_json TEXT NOT NULL,
@@ -94,11 +94,11 @@ var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null
 	updated_at TEXT NOT NULL,
 	last_connected_at TEXT NOT NULL,
 	PRIMARY KEY (channel, instance_id)
-);`;function UZ(Z){Z.exec("PRAGMA journal_mode = WAL;"),Z.exec("PRAGMA busy_timeout = 5000;"),Z.exec(eZ),Z.exec(Z0)}function M(Z){return typeof Z==="object"&&Z!==null&&!Array.isArray(Z)}function zZ(Z){if(typeof Z!=="string"||!Z)return{};try{let $=JSON.parse(Z);if(!M($))return{};let j={};for(let[X,K]of Object.entries($))if(typeof K==="string")j[X]=K;return j}catch{return{}}}function VZ(Z){if(typeof Z!=="string"||!Z)return;try{let $=JSON.parse(Z);if(!Array.isArray($))return;return $.filter((j)=>typeof j==="string")}catch{return}}class d{dbPath;db;constructor(Z={}){this.dbPath=Z.dbPath??ZZ()}getRawDb(){if(this.db)return this.db;let Z=w(this.dbPath);return UZ(Z),this.db=Z,this.importLegacyJsonSettings(),Z}close(){this.db?.close?.(),this.db=void 0}getConfig(Z){let $=this.getRawDb().prepare("SELECT * FROM connector_configs WHERE channel = ?").get(Z);return $?P($):void 0}listConfigs(){return this.getRawDb().prepare("SELECT * FROM connector_configs ORDER BY channel ASC").all().map(P)}getConnection(Z,$){let j=this.getRawDb().prepare(`SELECT * FROM connector_connections
-				 WHERE channel = ? AND instance_id = ?`).get(Z,$);return j?p(j):void 0}listConnections(Z){return(Z?this.getRawDb().prepare(`SELECT * FROM connector_connections
+);`;function UZ(Z){Z.exec("PRAGMA journal_mode = WAL;"),Z.exec("PRAGMA busy_timeout = 5000;"),Z.exec($0),Z.exec(j0)}function M(Z){return typeof Z==="object"&&Z!==null&&!Array.isArray(Z)}function WZ(Z){if(typeof Z!=="string"||!Z)return{};try{let $=JSON.parse(Z);if(!M($))return{};let j={};for(let[X,K]of Object.entries($))if(typeof K==="string")j[X]=K;return j}catch{return{}}}function zZ(Z){if(typeof Z!=="string"||!Z)return;try{let $=JSON.parse(Z);if(!Array.isArray($))return;return $.filter((j)=>typeof j==="string")}catch{return}}class h{dbPath;db;constructor(Z={}){this.dbPath=Z.dbPath??ZZ()}getRawDb(){if(this.db)return this.db;let Z=P(this.dbPath);return UZ(Z),this.db=Z,this.importLegacyJsonSettings(),Z}close(){this.db?.close?.(),this.db=void 0}getConfig(Z){let $=this.getRawDb().prepare("SELECT * FROM connector_configs WHERE channel = ?").get(Z);return $?p($):void 0}listConfigs(){return this.getRawDb().prepare("SELECT * FROM connector_configs ORDER BY channel ASC").all().map(p)}getConnection(Z,$){let j=this.getRawDb().prepare(`SELECT * FROM connector_connections
+				 WHERE channel = ? AND instance_id = ?`).get(Z,$);return j?d(j):void 0}listConnections(Z){return(Z?this.getRawDb().prepare(`SELECT * FROM connector_connections
 						 WHERE channel = ?
 						 ORDER BY instance_id ASC`).all(Z):this.getRawDb().prepare(`SELECT * FROM connector_connections
-						 ORDER BY channel ASC, instance_id ASC`).all()).map(p)}upsertConfig(Z){let $=J(),j=this.getRawDb();j.exec("BEGIN IMMEDIATE;");try{let X=j.prepare("SELECT * FROM connector_configs WHERE channel = ?").get(Z.channel),K=X?P(X):void 0,z=j.prepare("SELECT * FROM connector_connections WHERE channel = ?").all(Z.channel).map(p),V=Z.updateConnectArgs&&z.length===1&&z[0]?Z.updateConnectArgs({config:K,connection:z[0]}):void 0;if(j.prepare(`INSERT INTO connector_configs (
+						 ORDER BY channel ASC, instance_id ASC`).all()).map(d)}upsertConfig(Z){let $=J(),j=this.getRawDb();j.exec("BEGIN IMMEDIATE;");try{let X=j.prepare("SELECT * FROM connector_configs WHERE channel = ?").get(Z.channel),K=X?p(X):void 0,W=j.prepare("SELECT * FROM connector_connections WHERE channel = ?").all(Z.channel).map(d),z=Z.updateConnectArgs&&W.length===1&&W[0]?Z.updateConnectArgs({config:K,connection:W[0]}):void 0;if(j.prepare(`INSERT INTO connector_configs (
 					channel, type, values_json, security_enabled,
 					security_values_json, configured_at, updated_at
 				) VALUES (?, ?, ?, ?, ?, ?, ?)
@@ -108,9 +108,9 @@ var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null
 					security_enabled = excluded.security_enabled,
 					security_values_json = excluded.security_values_json,
 					configured_at = excluded.configured_at,
-					updated_at = excluded.updated_at`).run(Z.channel,Z.type??Z.channel,JSON.stringify(Z.values),x(Z.security?.enabled===!0),JSON.stringify(Z.security?.values??{}),Z.configuredAt??K?.configuredAt??$,Z.updatedAt??$),V&&z[0])j.prepare(`UPDATE connector_connections
+					updated_at = excluded.updated_at`).run(Z.channel,Z.type??Z.channel,JSON.stringify(Z.values),_(Z.security?.enabled===!0),JSON.stringify(Z.security?.values??{}),Z.configuredAt??K?.configuredAt??$,Z.updatedAt??$),z&&W[0])j.prepare(`UPDATE connector_connections
 					 SET connect_args_json = ?, updated_at = ?
-					 WHERE channel = ? AND instance_id = ?`).run(JSON.stringify(V),$,Z.channel,z[0].instanceId);j.exec("COMMIT;")}catch(X){try{j.exec("ROLLBACK;")}catch{}throw X}}recordConnected(Z,$,j){let X=J();this.getRawDb().prepare(`INSERT INTO connector_connections (
+					 WHERE channel = ? AND instance_id = ?`).run(JSON.stringify(z),$,Z.channel,W[0].instanceId);j.exec("COMMIT;")}catch(X){try{j.exec("ROLLBACK;")}catch{}throw X}}recordConnected(Z,$,j){let X=J();this.getRawDb().prepare(`INSERT INTO connector_connections (
 					channel, instance_id, connect_args_json,
 					last_successful_args_json, enabled, updated_at, last_connected_at
 				) VALUES (?, ?, ?, ?, 1, ?, ?)
@@ -121,7 +121,7 @@ var FZ=Object.defineProperty;var GZ=(Z)=>Z;function YZ(Z,$){this[Z]=GZ.bind(null
 					updated_at = excluded.updated_at,
 					last_connected_at = excluded.last_connected_at`).run(Z,$,JSON.stringify(j),JSON.stringify(j),X,X)}setEnabled(Z,$,j){if(j){this.getRawDb().prepare(`UPDATE connector_connections
 					 SET enabled = ?, updated_at = ?
-					 WHERE channel = ? AND instance_id = ?`).run(x($),J(),Z,j);return}this.getRawDb().prepare(`UPDATE connector_connections
+					 WHERE channel = ? AND instance_id = ?`).run(_($),J(),Z,j);return}this.getRawDb().prepare(`UPDATE connector_connections
 				 SET enabled = ?, updated_at = ?
-				 WHERE channel = ?`).run(x($),J(),Z)}deleteConnection(Z,$){return(this.getRawDb().prepare(`DELETE FROM connector_connections
-					 WHERE channel = ? AND instance_id = ?`).run(Z,$).changes??0)>0}disableAll(){this.getRawDb().prepare("UPDATE connector_connections SET enabled = 0, updated_at = ?").run(J())}deleteConfig(Z){return(this.getRawDb().prepare("DELETE FROM connector_configs WHERE channel = ?").run(Z).changes??0)>0}importLegacyJsonSettings(){let Z=a();if(!rZ(Z))return;try{let $=JSON.parse(tZ(Z,"utf8")),j=M($)&&M($.connectors)?$.connectors:{};for(let[X,K]of Object.entries(j)){if(!M(K)||this.getConfig(X))continue;let W={};if(M(K.values)){for(let[L,B]of Object.entries(K.values))if(typeof B==="string")W[L]=B}let z={},V=M(K.security)?K.security:void 0;if(V&&M(V.values)){for(let[L,B]of Object.entries(V.values))if(typeof B==="string")z[L]=B}this.upsertConfig({channel:X,type:typeof K.type==="string"?K.type:X,values:W,security:V?{enabled:V.enabled===!0,values:z}:void 0,configuredAt:typeof K.configuredAt==="string"?K.configuredAt:void 0,updatedAt:typeof K.updatedAt==="string"?K.updatedAt:void 0})}aZ(Z,`${Z}.migrated`)}catch{}}}function P(Z){let $=Z.security_enabled===1,j=zZ(Z.security_values_json),X=$||Object.keys(j).length>0;return{channel:G(Z.channel),type:G(Z.type),values:zZ(Z.values_json),security:X?{enabled:$,values:j}:void 0,configuredAt:G(Z.configured_at),updatedAt:G(Z.updated_at)}}function p(Z){return{channel:G(Z.channel),instanceId:G(Z.instance_id),connectArgs:VZ(Z.connect_args_json)??[],lastSuccessfulArgs:VZ(Z.last_successful_args_json)??[],enabled:Z.enabled===1,updatedAt:G(Z.updated_at),lastConnectedAt:u(Z.last_connected_at)??G(Z.updated_at)}}function $0(Z){let $=new d;try{return Z($)}finally{$.close()}}export{$0 as withConnectorStore,x as toBoolInt,J as nowIso,w as loadSqliteDb,nZ as ensureSessionSchema,UZ as ensureConnectorSchema,G as asString,u as asOptionalString,pZ as asBool,d as SqliteConnectorStore};
+				 WHERE channel = ?`).run(_($),J(),Z)}deleteConnection(Z,$){return(this.getRawDb().prepare(`DELETE FROM connector_connections
+					 WHERE channel = ? AND instance_id = ?`).run(Z,$).changes??0)>0}disableAll(){this.getRawDb().prepare("UPDATE connector_connections SET enabled = 0, updated_at = ?").run(J())}deleteConfig(Z){return(this.getRawDb().prepare("DELETE FROM connector_configs WHERE channel = ?").run(Z).changes??0)>0}importLegacyJsonSettings(){let Z=e();if(!aZ(Z))return;try{let $=JSON.parse(eZ(Z,"utf8")),j=M($)&&M($.connectors)?$.connectors:{};for(let[X,K]of Object.entries(j)){if(!M(K)||this.getConfig(X))continue;let V={};if(M(K.values)){for(let[L,B]of Object.entries(K.values))if(typeof B==="string")V[L]=B}let W={},z=M(K.security)?K.security:void 0;if(z&&M(z.values)){for(let[L,B]of Object.entries(z.values))if(typeof B==="string")W[L]=B}this.upsertConfig({channel:X,type:typeof K.type==="string"?K.type:X,values:V,security:z?{enabled:z.enabled===!0,values:W}:void 0,configuredAt:typeof K.configuredAt==="string"?K.configuredAt:void 0,updatedAt:typeof K.updatedAt==="string"?K.updatedAt:void 0})}Z0(Z,`${Z}.migrated`)}catch{}}}function p(Z){let $=Z.security_enabled===1,j=WZ(Z.security_values_json),X=$||Object.keys(j).length>0;return{channel:G(Z.channel),type:G(Z.type),values:WZ(Z.values_json),security:X?{enabled:$,values:j}:void 0,configuredAt:G(Z.configured_at),updatedAt:G(Z.updated_at)}}function d(Z){return{channel:G(Z.channel),instanceId:G(Z.instance_id),connectArgs:zZ(Z.connect_args_json)??[],lastSuccessfulArgs:zZ(Z.last_successful_args_json)??[],enabled:Z.enabled===1,updatedAt:G(Z.updated_at),lastConnectedAt:w(Z.last_connected_at)??G(Z.updated_at)}}function X0(Z){let $=new h;try{return Z($)}finally{$.close()}}export{X0 as withConnectorStore,_ as toBoolInt,J as nowIso,P as loadSqliteDb,tZ as ensureSessionSchema,UZ as ensureConnectorSchema,G as asString,w as asOptionalString,hZ as asBool,h as SqliteConnectorStore};

package/dist/extensions/contribution-registry.d.ts

@@ -17,6 +17,11 @@ export interface AgentExtensionRule {
     id: string;
     content: string | (() => string | Promise<string>);
     source?: string;
+    /**
+     * Include this rule only while the named tool is available after host,
+     * global-settings, and per-session policy filtering.
+     */
+    whenToolAvailable?: string;
 }
 export interface AgentExtensionMessageBuilder<TMessage = unknown> {
     name: string;

package/dist/hub.d.ts

@@ -2,11 +2,12 @@ import type { AgentMessage } from "./agent";
 import type { GatewayModelSelection, JsonValue } from "./llms/gateway";
 import type { ReasoningEffort } from "./llms/reasoning-options";
 import type { RuntimeConfigExtensionKind } from "./session/runtime-config";
+import type { AgendaAutomationPolicy, AgendaTaskCreateInput, AgendaTaskListInput, AgendaTaskRecord, AgendaTaskRunRecord, AgendaTaskUpdateInput } from "./tasks";
 export type HubProtocolVersion = "v1";
 export declare const CURRENT_HUB_PROTOCOL_VERSION: HubProtocolVersion;
 export declare const MIN_CLIENT_HUB_PROTOCOL_VERSION: HubProtocolVersion;
 export declare const MAX_CLIENT_HUB_PROTOCOL_VERSION: HubProtocolVersion;
-export type HubCapabilityName = "client.register" | "client.list" | "session.create" | "session.list" | "session.get" | "session.run" | "session.abort" | "schedule.create" | "schedule.list" | "settings.get" | "settings.set" | "connector.start" | "connector.stop" | "connector.supervised";
+export type HubCapabilityName = "client.register" | "client.list" | "session.create" | "session.list" | "session.get" | "session.run" | "session.abort" | "schedule.create" | "schedule.list" | "task.create" | "task.list" | "task.get" | "task.update" | "task.approve" | "task.cancel" | "task.run" | "task.automation.get" | "task.automation.set" | "settings.get" | "settings.set" | "connector.start" | "connector.stop" | "connector.supervised";
 export declare const HUB_CAPABILITIES: readonly HubCapabilityName[];
 export interface HubProtocolMetadata {
     protocolVersion: string;
@@ -31,6 +32,8 @@ export interface ClientCapability {
     scopes?: string[];
     payloadSchema?: Record<string, unknown>;
 }
+/** Client capability advertised by a live user surface that can answer tool approvals. */
+export declare const HUB_CLIENT_TOOL_APPROVAL_CAPABILITY = "approval.respond";
 export interface HubClientRegistration {
     clientId?: string;
     clientType: string;
@@ -185,6 +188,7 @@ export interface ScheduleRecord {
     scheduleId: string;
     name: string;
     cronPattern: string;
+    timezone?: string;
     prompt: string;
     workspaceRoot: string;
     cwd?: string;
@@ -229,6 +233,7 @@ export declare function readHubScheduleMode(payload: Record<string, unknown> | u
 export interface HubScheduleCreateInput {
     name: string;
     cronPattern: string;
+    timezone?: string;
     prompt: string;
     workspaceRoot: string;
     cwd?: string;
@@ -248,6 +253,7 @@ export interface HubScheduleUpdateInput {
     scheduleId: string;
     name?: string;
     cronPattern?: string;
+    timezone?: string | null;
     prompt?: string;
     workspaceRoot?: string;
     cwd?: string;
@@ -263,7 +269,71 @@ export interface HubScheduleUpdateInput {
     runtimeOptions?: HubSessionRuntimeOptions;
     metadata?: Record<string, JsonValue | undefined>;
 }
-export type HubCommandName = "client.register" | "client.update" | "client.unregister" | "client.list" | "cline.account.get_current" | "prompt_commands.list" | "prompt_commands.execute" | "mention_files.search" | "catalog.list" | "session.list" | "session.create" | "session.attach" | "session.detach" | "session.get" | "session.messages" | "session.restore" | "session.delete" | "session.update" | "session.update_connection" | "session.compaction.get" | "session.compaction.update" | "session.pending_prompts" | "session.update_pending_prompt" | "session.remove_pending_prompt" | "session.fork" | "session.hook" | "run.start" | "session.send_input" | "run.abort" | "approval.request" | "approval.respond" | "capability.request" | "capability.progress" | "capability.respond" | "peer.register" | "peer.list_sessions" | "peer.attach_session" | "peer.detach_session" | "peer.proxy_command" | "schedule.create" | "schedule.list" | "schedule.get" | "schedule.update" | "schedule.delete" | "schedule.enable" | "schedule.disable" | "schedule.trigger" | "schedule.list_executions" | "schedule.stats" | "schedule.active" | "schedule.upcoming" | "settings.list" | "settings.get" | "settings.patch" | "settings.toggle" | "connector.channels" | "connector.configure" | "connector.delete_config" | "connector.start" | "connector.stop" | "connector.supervised" | "cron.event.ingest" | "cron.event.list" | "cron.event.get" | "ui.notify" | "ui.show_window";
+export interface HubTaskIdInput {
+    taskId: string;
+}
+export type HubTaskCreateInput = Omit<AgendaTaskCreateInput, "createdBy">;
+export type HubTaskUpdateInput = Omit<AgendaTaskUpdateInput, "updatedBy">;
+export interface HubTaskRevisionInput extends HubTaskIdInput {
+    expectedRevision: number;
+}
+export interface HubTaskCancelInput extends HubTaskRevisionInput {
+    reason?: string;
+}
+export interface HubTaskAutomationSetInput {
+    policy: Omit<AgendaAutomationPolicy, "updatedAt">;
+}
+/**
+ * Strongly typed task command payloads. This map is intentionally extensible so
+ * other Hub command families can adopt typed payloads without changing the wire
+ * envelope.
+ */
+export interface HubCommandInputMap {
+    "task.create": HubTaskCreateInput;
+    "task.list": AgendaTaskListInput;
+    "task.get": HubTaskIdInput;
+    "task.update": HubTaskUpdateInput;
+    "task.approve": HubTaskRevisionInput;
+    "task.cancel": HubTaskCancelInput;
+    "task.run": HubTaskRevisionInput;
+    "task.automation.get": Record<string, never>;
+    "task.automation.set": HubTaskAutomationSetInput;
+}
+/** Typed task command results returned in {@link HubReplyEnvelope.payload}. */
+export interface HubCommandOutputMap {
+    "task.create": {
+        task: AgendaTaskRecord;
+    };
+    "task.list": {
+        tasks: AgendaTaskRecord[];
+    };
+    "task.get": {
+        task?: AgendaTaskRecord;
+    };
+    "task.update": {
+        task: AgendaTaskRecord;
+    };
+    "task.approve": {
+        task: AgendaTaskRecord;
+    };
+    "task.cancel": {
+        task: AgendaTaskRecord;
+    };
+    "task.run": {
+        task: AgendaTaskRecord;
+        run?: AgendaTaskRunRecord;
+    };
+    "task.automation.get": {
+        policy: AgendaAutomationPolicy;
+    };
+    "task.automation.set": {
+        policy: AgendaAutomationPolicy;
+    };
+}
+export type HubTypedCommandName = keyof HubCommandInputMap & HubCommandName;
+export type HubCommandInput<TCommand extends HubTypedCommandName> = HubCommandInputMap[TCommand];
+export type HubCommandOutput<TCommand extends HubTypedCommandName> = HubCommandOutputMap[TCommand];
+export type HubCommandName = "client.register" | "client.update" | "client.unregister" | "client.list" | "cline.account.get_current" | "prompt_commands.list" | "prompt_commands.execute" | "mention_files.search" | "catalog.list" | "session.list" | "session.create" | "session.attach" | "session.detach" | "session.get" | "session.messages" | "session.restore" | "session.delete" | "session.update" | "session.update_connection" | "session.compaction.get" | "session.compaction.update" | "session.pending_prompts" | "session.update_pending_prompt" | "session.remove_pending_prompt" | "session.fork" | "session.hook" | "run.start" | "session.send_input" | "run.abort" | "run.proceed_while_running" | "approval.request" | "approval.respond" | "capability.request" | "capability.progress" | "capability.respond" | "peer.register" | "peer.list_sessions" | "peer.attach_session" | "peer.detach_session" | "peer.proxy_command" | "schedule.create" | "schedule.list" | "schedule.get" | "schedule.update" | "schedule.delete" | "schedule.enable" | "schedule.disable" | "schedule.trigger" | "schedule.list_executions" | "schedule.stats" | "schedule.active" | "schedule.upcoming" | "task.create" | "task.list" | "task.get" | "task.update" | "task.approve" | "task.cancel" | "task.run" | "task.automation.get" | "task.automation.set" | "settings.list" | "settings.get" | "settings.patch" | "settings.toggle" | "connector.channels" | "connector.configure" | "connector.delete_config" | "connector.start" | "connector.stop" | "connector.supervised" | "cron.event.ingest" | "cron.event.list" | "cron.event.get" | "ui.notify" | "ui.show_window";
 export declare const HUB_DEFAULT_COMMAND_TIMEOUT_MS = 30000;
 export declare const HUB_COMMAND_SLOW_LOG_MS = 5000;
 export declare function getDefaultHubCommandTimeoutMs(command: HubCommandName): number | null;
@@ -288,7 +358,7 @@ export interface HubReplyEnvelope {
         details?: Record<string, unknown>;
     };
 }
-export type HubEventName = "hub.client.registered" | "hub.client.disconnected" | "session.created" | "session.updated" | "session.attached" | "session.detached" | "session.forked" | "session.pending_prompts" | "session.pending_prompt_submitted" | "run.started" | "run.heartbeat" | "run.aborted" | "run.completed" | "run.failed" | "iteration.started" | "iteration.finished" | "assistant.delta" | "assistant.media" | "assistant.finished" | "session.notice" | "reasoning.delta" | "reasoning.finished" | "agent.done" | "usage.updated" | "tool.started" | "tool.updated" | "tool.finished" | "approval.requested" | "approval.resolved" | "capability.requested" | "capability.resolved" | "team.progress" | "artifact.created" | "diff.created" | "spoke.started" | "spoke.failed" | "spoke.stopped" | "peer.registered" | "peer.session_attached" | "peer.session_detached" | "schedule.created" | "schedule.updated" | "schedule.deleted" | "schedule.triggered" | "schedule.execution_completed" | "schedule.execution_failed" | "settings.changed" | "ui.notify" | "ui.show_window" | "hub.client.updated";
+export type HubEventName = "hub.client.registered" | "hub.client.disconnected" | "session.created" | "session.updated" | "session.attached" | "session.detached" | "session.forked" | "session.pending_prompts" | "session.pending_prompt_submitted" | "run.started" | "run.heartbeat" | "run.aborted" | "run.completed" | "run.failed" | "iteration.started" | "iteration.finished" | "assistant.delta" | "assistant.media" | "assistant.finished" | "session.notice" | "reasoning.delta" | "reasoning.finished" | "agent.done" | "usage.updated" | "tool.started" | "tool.updated" | "tool.finished" | "approval.requested" | "approval.resolved" | "capability.requested" | "capability.resolved" | "team.progress" | "artifact.created" | "diff.created" | "spoke.started" | "spoke.failed" | "spoke.stopped" | "peer.registered" | "peer.session_attached" | "peer.session_detached" | "schedule.created" | "schedule.updated" | "schedule.deleted" | "schedule.triggered" | "schedule.execution_completed" | "schedule.execution_failed" | "task.created" | "task.updated" | "task.deleted" | "task.run.started" | "task.run.completed" | "task.run.failed" | "task.automation.updated" | "settings.changed" | "ui.notify" | "ui.show_window" | "hub.client.updated";
 export interface HubEventEnvelope {
     version: HubProtocolVersion;
     event: HubEventName;

package/dist/index.browser.d.ts

@@ -20,7 +20,7 @@ export { EMPTY_CONTENT_TEXT, formatMessagesForAiSdk, sanitizeSurrogates, toAiSdk
 export * from "./llms/gateway";
 export { type Base64MediaValidationFailure, type Base64MediaValidationResult, type Base64MediaValidationSuccess, createMediaBudgetState, DEFAULT_MAX_IMAGE_BASE64_BYTES, DEFAULT_MAX_IMAGE_DECODED_BYTES, DEFAULT_MAX_IMAGE_ENCODED_BYTES, DEFAULT_MAX_TOTAL_MEDIA_BYTES, type GeneratedMedia, type GeneratedMediaModality, GeneratedMediaModalitySchema, GeneratedMediaSchema, type GeneratedMediaSource, GeneratedMediaSourceSchema, generatedMediaModalityFromMediaType, IMAGE_OMITTED_PLACEHOLDER, IMAGE_UNSUPPORTED_PLACEHOLDER, type ImageMediaLimits, type ImageMediaValidationFailure, type ImageMediaValidationResult, type ImageMediaValidationSuccess, imageBase64DecodedByteLength, imageBase64EncodedByteLength, imageBase64LengthForDecodedBytes, imageFileMaxDecodedBytesForBase64Limit, isBase64Char, isCanonicalBase64, isGeneratedMedia, type MediaBudgetOptions, type MediaBudgetState, type ResolvedMediaBudget, reserveImageMediaBytes, resolveMediaBudget, SUPPORTED_IMAGE_MEDIA_TYPES, validateAndReserveBase64Media, validateAndReserveImageMedia, validateImageMedia, } from "./llms/media";
 export type { ContentBlock, FileContent, ImageContent, MediaContent, Message, MessageRole, MessageWithMetadata, RedactedThinkingContent, TextContent, ThinkingContent, ToolDefinition, ToolResultContent, ToolUseContent, } from "./llms/messages";
-export { ApiFormat, ApiFormatSchema, type ModelCapability, ModelCapabilitySchema, type ModelInfo, ModelInfoSchema, type ModelMetadata, ModelMetadataSchema, type ModelModalities, ModelModalitiesSchema, type ModelModality, ModelModalitySchema, type ModelOperation, type ModelOperationMode, ModelOperationModeSchema, ModelOperationSchema, type ModelPricing, ModelPricingSchema, type ModelStatus, ModelStatusSchema, modelHasCapability, modelProducesImages, modelSupportsToolCalling, type ThinkingConfig, ThinkingConfigSchema, usesImageGenerationOperation, } from "./llms/model-info";
+export { ApiFormat, ApiFormatSchema, type ChatCompatibleModelDescriptor, type ChatModelModalities, isChatCompatibleModel, type ModelCapability, ModelCapabilitySchema, type ModelInfo, ModelInfoSchema, type ModelMetadata, ModelMetadataSchema, type ModelModalities, ModelModalitiesSchema, type ModelModality, ModelModalitySchema, type ModelOperation, type ModelOperationMode, ModelOperationModeSchema, ModelOperationSchema, type ModelPricing, ModelPricingSchema, type ModelStatus, ModelStatusSchema, modelHasCapability, modelProducesImages, modelSupportsToolCalling, supportsChatModalities, type ThinkingConfig, ThinkingConfigSchema, usesImageGenerationOperation, } from "./llms/model-info";
 export { mergeModelOptions } from "./llms/model-options";
 export * from "./llms/model-tools";
 export { DEFAULT_REASONING_EFFORT, REASONING_EFFORT_RATIOS, resolveEffectiveReasoningEffort, resolveReasoningBudgetFromRatio, resolveReasoningEffortRatio, } from "./llms/reasoning-effort";
@@ -49,7 +49,7 @@ export { REMOTE_URI_SCHEME } from "./remote-config/constants";
 export type { AnthropicModel, AnthropicSettings, APIKeySettings, AwsBedrockCustomModel, AwsBedrockModel, AwsBedrockSettings, EnterpriseTelemetry, GlobalInstructionsFile, LiteLLMModel, LiteLLMSettings, MCPServer, OpenAiCompatible, OpenAiCompatibleModel, PromptUploading, ProviderSettings, RemoteConfig, RemoteMCPServer, S3AccessKeySettings, VertexModel, VertexSettings, } from "./remote-config/schema";
 export { AllowedMCPServerSchema, AnthropicModelSchema, AnthropicSchema, APIKeySchema, AwsBedrockCustomModelSchema, AwsBedrockModelSchema, AwsBedrockSettingsSchema, ClineModelSchema, ClineSettingsSchema, EnterpriseTelemetrySchema, GlobalInstructionsFileSchema, LiteLLMModelSchema, LiteLLMSchema, OpenAiCompatibleModelSchema, OpenAiCompatibleSchema, PromptUploadingSchema, RemoteConfigSchema, RemoteMCPServerSchema, S3AccessKeySettingsSchema, VertexModelSchema, VertexSettingsSchema, } from "./remote-config/schema";
 export { CLINE_DEFAULT_RPC_ADDRESS, CLINE_DEFAULT_RPC_PORT } from "./rpc";
-export type { AddProviderActionRequest, ChatAttachmentFile, ChatAttachments, ChatRunTurnRequest, ChatRuntimeConfig, ChatStartSessionArtifacts, ChatStartSessionRequest, ChatStartSessionResponse, ChatToolCallResult, ChatTurnResult, ClineAccountActionRequest, EnterpriseAuthenticateRequest, EnterpriseAuthenticateResponse, EnterpriseStatusRequest, EnterpriseStatusResponse, EnterpriseSyncRequest, EnterpriseSyncResponse, GetProviderModelsActionRequest, ListProvidersActionRequest, ProviderActionRequest, ProviderCapability, ProviderCatalogResponse, ProviderClient, ProviderConfigField, ProviderConfigFieldOption, ProviderConfigFieldPrimitive, ProviderConfigFieldType, ProviderListItem, ProviderModel, ProviderModelsResponse, ProviderOAuthLoginResponse, ProviderProtocol, ProviderSettingsActionRequest, RuntimeLoggerConfig, SaveProviderSettingsActionRequest, VoiceInputSelection, } from "./rpc/runtime";
+export type { AddProviderActionRequest, ChatAttachmentFile, ChatAttachments, ChatRunTurnRequest, ChatRuntimeConfig, ChatStartSessionArtifacts, ChatStartSessionRequest, ChatStartSessionResponse, ChatToolCallResult, ChatTurnResult, ClineAccountActionRequest, EnterpriseAuthenticateRequest, EnterpriseAuthenticateResponse, EnterpriseStatusRequest, EnterpriseStatusResponse, EnterpriseSyncRequest, EnterpriseSyncResponse, GetProviderModelsActionRequest, ListProvidersActionRequest, ProviderActionRequest, ProviderCapability, ProviderCatalogResponse, ProviderClient, ProviderConfigField, ProviderConfigFieldOption, ProviderConfigFieldPrimitive, ProviderConfigFieldType, ProviderListItem, ProviderModel, ProviderModelFeatured, ProviderModelFeaturedTier, ProviderModelsResponse, ProviderOAuthLoginResponse, ProviderProtocol, ProviderSettingsActionRequest, RuntimeLoggerConfig, SaveProviderSettingsActionRequest, VoiceInputSelection, } from "./rpc/runtime";
 export { ProviderCapabilitySchema, ProviderClientSchema, ProviderProtocolSchema, } from "./rpc/runtime";
 export type { TeamProgressCounts, TeamProgressLifecycleEvent, TeamProgressMemberRole, TeamProgressMemberStatus, TeamProgressOutcomeFragmentStatus, TeamProgressOutcomeStatus, TeamProgressProjectionEvent, TeamProgressRunStatus, TeamProgressSummary, TeamProgressTaskStatus, } from "./rpc/team-progress";
 export { TEAM_LIFECYCLE_EVENT_TYPE, TEAM_PROGRESS_EVENT_TYPE, } from "./rpc/team-progress";
@@ -69,6 +69,7 @@ export { DEFAULT_RUNTIME_CONFIG_EXTENSIONS, hasRuntimeConfigExtension, isRuntime
 export type { RuntimeEnv } from "./session/runtime-env";
 export * from "./session/workspace";
 export { CLINE_CHAT_WORKSPACE_DIRECTORY_NAME, CLINE_WORKSPACES_DIRECTORY_NAME, isChatWorkspacePath, } from "./storage/chat-workspace-paths";
+export * from "./tasks";
 export * from "./team";
 export { createTool } from "./tools/create";
 export { AUTH_ERROR_PATTERNS, isLikelyAuthError } from "./types/auth";