@clinebot/shared 0.0.10 → 0.0.12

package/dist/db/index.js

@@ -1,92 +1,80 @@
-var E=Object.defineProperty;var F=(S)=>S;function G(S,g){this[S]=F.bind(null,g)}var Z=(S,g)=>{for(var z in g)E(S,z,{get:g[z],enumerable:!0,configurable:!0,set:G.bind(g,z)})};import{mkdirSync as J}from"node:fs";import{createRequire as K}from"node:module";import{dirname as L}from"node:path";function Q(){return new Date().toISOString()}function T(S){return S?1:0}function U(S){return typeof S==="string"?S:""}function V(S){if(typeof S!=="string")return;let g=S.trim();return g.length>0?g:void 0}function W(S){return S===1||S===!0}function X(S){J(L(S),{recursive:!0});let g=K(import.meta.url);if(typeof globalThis.Bun<"u"){let{Database:j}=g("bun:sqlite"),x=new j(S,{create:!0});return{prepare:(I)=>{let w=x.query(I);return{run:(...O)=>w.run(...O),get:(...O)=>w.get(...O),all:(...O)=>w.all(...O)}},exec:(I)=>x.exec(I)}}try{let j=["node",":sqlite"].join(""),{DatabaseSync:x}=g(j),I=new x(S);return{prepare:(w)=>{let O=I.prepare(w);return{run:(...A)=>O.run(...A),get:(...A)=>O.get(...A)??null,all:(...A)=>O.all(...A)}},exec:(w)=>I.exec(w)}}catch{}let B=["better","-sqlite3"].join("");return new(g(B))(S)}function Y(S,g={}){if(S.exec("PRAGMA journal_mode = WAL;"),S.exec("PRAGMA busy_timeout = 5000;"),S.exec(`
-		CREATE TABLE IF NOT EXISTS sessions (
-			session_id TEXT PRIMARY KEY,
-			source TEXT NOT NULL,
-			pid INTEGER NOT NULL,
-			started_at TEXT NOT NULL,
-			ended_at TEXT,
-			exit_code INTEGER,
-			status TEXT NOT NULL,
-			status_lock INTEGER NOT NULL DEFAULT 0,
-			interactive INTEGER NOT NULL,
-			provider TEXT NOT NULL,
-			model TEXT NOT NULL,
-			cwd TEXT NOT NULL,
-			workspace_root TEXT NOT NULL,
-			team_name TEXT,
-			enable_tools INTEGER NOT NULL,
-			enable_spawn INTEGER NOT NULL,
-			enable_teams INTEGER NOT NULL,
-			parent_session_id TEXT,
-			parent_agent_id TEXT,
-			agent_id TEXT,
-			conversation_id TEXT,
-			is_subagent INTEGER NOT NULL DEFAULT 0,
-			prompt TEXT,
-			metadata_json TEXT,
-			transcript_path TEXT NOT NULL,
-			hook_path TEXT NOT NULL,
-			messages_path TEXT,
-			updated_at TEXT NOT NULL
-		);
-	`),S.exec(`
-		CREATE TABLE IF NOT EXISTS subagent_spawn_queue (
-			id INTEGER PRIMARY KEY AUTOINCREMENT,
-			root_session_id TEXT NOT NULL,
-			parent_agent_id TEXT NOT NULL,
-			task TEXT,
-			system_prompt TEXT,
-			created_at TEXT NOT NULL,
-			consumed_at TEXT
-		);
-	`),S.exec(`
-		CREATE TABLE IF NOT EXISTS schedules (
-			schedule_id TEXT PRIMARY KEY,
-			name TEXT NOT NULL,
-			cron_pattern TEXT NOT NULL,
-			prompt TEXT NOT NULL,
-			provider TEXT NOT NULL,
-			model TEXT NOT NULL,
-			mode TEXT NOT NULL DEFAULT 'act',
-			workspace_root TEXT,
-			cwd TEXT,
-			system_prompt TEXT,
-			max_iterations INTEGER,
-			timeout_seconds INTEGER,
-			max_parallel INTEGER NOT NULL DEFAULT 1,
-			enabled INTEGER NOT NULL DEFAULT 1,
-			created_at TEXT NOT NULL,
-			updated_at TEXT NOT NULL,
-			last_run_at TEXT,
-			next_run_at TEXT,
-			claim_token TEXT,
-			claim_started_at TEXT,
-			claim_until_at TEXT,
-			created_by TEXT,
-			tags TEXT,
-			metadata_json TEXT
-		);
-	`),S.exec(`
-		CREATE TABLE IF NOT EXISTS schedule_executions (
-			execution_id TEXT PRIMARY KEY,
-			schedule_id TEXT NOT NULL,
-			session_id TEXT,
-			triggered_at TEXT NOT NULL,
-			started_at TEXT,
-			ended_at TEXT,
-			status TEXT NOT NULL,
-			exit_code INTEGER,
-			error_message TEXT,
-			iterations INTEGER,
-			tokens_used INTEGER,
-			cost_usd REAL,
-			FOREIGN KEY (schedule_id) REFERENCES schedules(schedule_id) ON DELETE CASCADE,
-			FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE SET NULL
-		);
-	`),S.exec(`
-		CREATE INDEX IF NOT EXISTS idx_schedule_executions_schedule
-		ON schedule_executions(schedule_id, triggered_at DESC);
-	`),S.exec(`
-		CREATE INDEX IF NOT EXISTS idx_schedules_next_run
-		ON schedules(enabled, next_run_at);
-	`),!g.includeLegacyMigrations)return;let z=S.prepare("PRAGMA table_info(sessions);").all(),B=(x)=>z.some((I)=>I.name===x);if(!B("workspace_root"))S.exec("ALTER TABLE sessions ADD COLUMN workspace_root TEXT;"),S.exec("UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';");if(!B("parent_session_id"))S.exec("ALTER TABLE sessions ADD COLUMN parent_session_id TEXT;");if(!B("parent_agent_id"))S.exec("ALTER TABLE sessions ADD COLUMN parent_agent_id TEXT;");if(!B("agent_id"))S.exec("ALTER TABLE sessions ADD COLUMN agent_id TEXT;");if(!B("conversation_id"))S.exec("ALTER TABLE sessions ADD COLUMN conversation_id TEXT;");if(!B("is_subagent"))S.exec("ALTER TABLE sessions ADD COLUMN is_subagent INTEGER NOT NULL DEFAULT 0;");if(!B("messages_path"))S.exec("ALTER TABLE sessions ADD COLUMN messages_path TEXT;");if(!B("metadata_json"))S.exec("ALTER TABLE sessions ADD COLUMN metadata_json TEXT;");let D=S.prepare("PRAGMA table_info(schedules);").all(),j=(x)=>D.some((I)=>I.name===x);if(!j("claim_token"))S.exec("ALTER TABLE schedules ADD COLUMN claim_token TEXT;");if(!j("claim_started_at"))S.exec("ALTER TABLE schedules ADD COLUMN claim_started_at TEXT;");if(!j("claim_until_at"))S.exec("ALTER TABLE schedules ADD COLUMN claim_until_at TEXT;")}export{T as toBoolInt,Q as nowIso,X as loadSqliteDb,Y as ensureSessionSchema,U as asString,V as asOptionalString,W as asBool};
+var J=Object.defineProperty;var K=(S)=>S;function Q(S,x){this[S]=K.bind(null,x)}var M=(S,x)=>{for(var B in x)J(S,B,{get:x[B],enumerable:!0,configurable:!0,set:Q.bind(x,B)})};import{mkdirSync as U}from"node:fs";import{createRequire as V}from"node:module";import{dirname as W}from"node:path";function X(){return new Date().toISOString()}function Z(S){return S?1:0}function $(S){return typeof S==="string"?S:""}function k(S){if(typeof S!=="string")return;let x=S.trim();return x.length>0?x:void 0}function y(S){return S===1||S===!0}function F(S){return{prepare:(x)=>S.query(x),exec:(x)=>S.exec(x)}}function H(S){return{prepare:(x)=>{let B=S.prepare(x);return{run:(...O)=>B.run(...O),get:(...O)=>B.get(...O)??null,all:(...O)=>B.all(...O)}},exec:(x)=>S.exec(x)}}function L(S){U(W(S),{recursive:!0});let x=V(import.meta.url);if(typeof globalThis.Bun<"u"){let{Database:O}=x("bun:sqlite");return F(new O(S,{create:!0}))}try{let O=process.emitWarning;process.emitWarning=(z,...I)=>{if((typeof z==="string"?z:z?.message??"").includes("SQLite"))return;return O.call(process,z,...I)};let{DatabaseSync:j}=x(["node",":sqlite"].join(""));return process.emitWarning=O,H(new j(S))}catch{}return new(x(["better","-sqlite3"].join("")))(S)}var Y=[`CREATE TABLE IF NOT EXISTS sessions (
+		session_id TEXT PRIMARY KEY,
+		source TEXT NOT NULL,
+		pid INTEGER NOT NULL,
+		started_at TEXT NOT NULL,
+		ended_at TEXT,
+		exit_code INTEGER,
+		status TEXT NOT NULL,
+		status_lock INTEGER NOT NULL DEFAULT 0,
+		interactive INTEGER NOT NULL,
+		provider TEXT NOT NULL,
+		model TEXT NOT NULL,
+		cwd TEXT NOT NULL,
+		workspace_root TEXT NOT NULL,
+		team_name TEXT,
+		enable_tools INTEGER NOT NULL,
+		enable_spawn INTEGER NOT NULL,
+		enable_teams INTEGER NOT NULL,
+		parent_session_id TEXT,
+		parent_agent_id TEXT,
+		agent_id TEXT,
+		conversation_id TEXT,
+		is_subagent INTEGER NOT NULL DEFAULT 0,
+		prompt TEXT,
+		metadata_json TEXT,
+		transcript_path TEXT NOT NULL,
+		hook_path TEXT NOT NULL,
+		messages_path TEXT,
+		updated_at TEXT NOT NULL
+	);`,`CREATE TABLE IF NOT EXISTS subagent_spawn_queue (
+		id INTEGER PRIMARY KEY AUTOINCREMENT,
+		root_session_id TEXT NOT NULL,
+		parent_agent_id TEXT NOT NULL,
+		task TEXT,
+		system_prompt TEXT,
+		created_at TEXT NOT NULL,
+		consumed_at TEXT
+	);`,`CREATE TABLE IF NOT EXISTS schedules (
+		schedule_id TEXT PRIMARY KEY,
+		name TEXT NOT NULL,
+		cron_pattern TEXT NOT NULL,
+		prompt TEXT NOT NULL,
+		provider TEXT NOT NULL,
+		model TEXT NOT NULL,
+		mode TEXT NOT NULL DEFAULT 'act',
+		workspace_root TEXT,
+		cwd TEXT,
+		system_prompt TEXT,
+		max_iterations INTEGER,
+		timeout_seconds INTEGER,
+		max_parallel INTEGER NOT NULL DEFAULT 1,
+		enabled INTEGER NOT NULL DEFAULT 1,
+		created_at TEXT NOT NULL,
+		updated_at TEXT NOT NULL,
+		last_run_at TEXT,
+		next_run_at TEXT,
+		claim_token TEXT,
+		claim_started_at TEXT,
+		claim_until_at TEXT,
+		created_by TEXT,
+		tags TEXT,
+		metadata_json TEXT
+	);`,`CREATE TABLE IF NOT EXISTS schedule_executions (
+		execution_id TEXT PRIMARY KEY,
+		schedule_id TEXT NOT NULL,
+		session_id TEXT,
+		triggered_at TEXT NOT NULL,
+		started_at TEXT,
+		ended_at TEXT,
+		status TEXT NOT NULL,
+		exit_code INTEGER,
+		error_message TEXT,
+		iterations INTEGER,
+		tokens_used INTEGER,
+		cost_usd REAL,
+		FOREIGN KEY (schedule_id) REFERENCES schedules(schedule_id) ON DELETE CASCADE,
+		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);`],D=[{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:"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 G(S,x){return new Set(S.prepare(`PRAGMA table_info(${x});`).all().map((B)=>B.name))}function R(S,x={}){S.exec("PRAGMA journal_mode = WAL;"),S.exec("PRAGMA busy_timeout = 5000;");for(let j of Y)S.exec(j);if(!x.includeLegacyMigrations)return;let B=new Map,O=(j)=>{let z=B.get(j);if(!z)z=G(S,j),B.set(j,z);return z};for(let j of D)if(!O(j.table).has(j.column)){if(S.exec(j.sql),j.column==="workspace_root")S.exec("UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';")}}export{Z as toBoolInt,X as nowIso,L as loadSqliteDb,R as ensureSessionSchema,$ as asString,k as asOptionalString,y as asBool};

package/dist/rpc/runtime.d.ts

@@ -60,6 +60,7 @@ export interface RpcChatRunTurnRequest {
     messages?: RpcChatMessage[];
     prompt: string;
     attachments?: RpcChatAttachments;
+    delivery?: "queue" | "steer";
 }
 export interface RpcChatToolCallResult {
     name: string;

package/dist/storage/index.d.ts

@@ -1 +1 @@
-export { AGENT_CONFIG_DIRECTORY_NAME, CLINE_MCP_SETTINGS_FILE_NAME, ensureHookLogDir, ensureParentDir, HOOKS_CONFIG_DIRECTORY_NAME, RULES_CONFIG_DIRECTORY_NAME, resolveAgentConfigSearchPaths, resolveAgentsConfigDirPath, resolveClineDataDir, resolveClineDir, resolveDocumentsAgentConfigDirectoryPath, resolveDocumentsClineDirectoryPath, resolveDocumentsHooksDirectoryPath, resolveDocumentsRulesDirectoryPath, resolveDocumentsWorkflowsDirectoryPath, resolveHooksConfigSearchPaths, resolveMcpSettingsPath, resolvePluginConfigSearchPaths, resolveProviderSettingsPath, resolveRulesConfigSearchPaths, resolveSessionDataDir, resolveSkillsConfigSearchPaths, resolveTeamDataDir, resolveWorkflowsConfigSearchPaths, SKILLS_CONFIG_DIRECTORY_NAME, setClineDir, setClineDirIfUnset, setHomeDir, setHomeDirIfUnset, WORKFLOWS_CONFIG_DIRECTORY_NAME, } from "./paths";
+export { AGENT_CONFIG_DIRECTORY_NAME, CLINE_MCP_SETTINGS_FILE_NAME, discoverPluginModulePaths, ensureHookLogDir, ensureParentDir, HOOKS_CONFIG_DIRECTORY_NAME, isPluginModulePath, RULES_CONFIG_DIRECTORY_NAME, resolveAgentConfigSearchPaths, resolveAgentsConfigDirPath, resolveClineDataDir, resolveClineDir, resolveConfiguredPluginModulePaths, resolveDocumentsAgentConfigDirectoryPath, resolveDocumentsClineDirectoryPath, resolveDocumentsHooksDirectoryPath, resolveDocumentsPluginsDirectoryPath, resolveDocumentsRulesDirectoryPath, resolveDocumentsWorkflowsDirectoryPath, resolveHooksConfigSearchPaths, resolveMcpSettingsPath, resolvePluginConfigSearchPaths, resolvePluginModuleEntries, resolveProviderSettingsPath, resolveRulesConfigSearchPaths, resolveSessionDataDir, resolveSkillsConfigSearchPaths, resolveTeamDataDir, resolveWorkflowsConfigSearchPaths, SKILLS_CONFIG_DIRECTORY_NAME, setClineDir, setClineDirIfUnset, setHomeDir, setHomeDirIfUnset, WORKFLOWS_CONFIG_DIRECTORY_NAME, } from "./paths";

package/dist/storage/index.js

@@ -1 +1 @@
-var j=Object.defineProperty;var q=(o)=>o;function z(o,v){this[o]=q.bind(null,v)}var i=(o,v)=>{for(var S in v)j(o,S,{get:v[S],enumerable:!0,configurable:!0,set:z.bind(v,S)})};import{existsSync as G,mkdirSync as e}from"node:fs";import{dirname as y,join as n}from"node:path";var F="agents",H="hooks",g="skills",M="rules",f="workflows",O="plugins",T="cline_mcp_settings.json",s=process?.env?.HOME||"~",_=!1;function B(o){let v=o.trim();if(!v)return;s=v,_=!0}function J(o){if(_)return;let v=o.trim();if(!v)return;s=v}var A,K=!1;function Q(o){let v=o.trim();if(!v)return;A=v,K=!0}function V(o){if(K)return;let v=o.trim();if(!v)return;A=v}function N(){if(A)return A;let o=process.env.CLINE_DIR?.trim();if(o)return o;return n(s,".cline")}function D(){return n(s,"Documents","Cline")}function R(){return n(D(),"Agents")}function U(){return n(D(),"Hooks")}function E(){return n(D(),"Rules")}function W(){return n(D(),"Workflows")}function C(){let o=process.env.CLINE_DATA_DIR?.trim();if(o)return o;return n(N(),"data")}function Z(){let o=process.env.CLINE_SESSION_DATA_DIR?.trim();if(o)return o;return n(C(),"sessions")}function $(){let o=process.env.CLINE_TEAM_DATA_DIR?.trim();if(o)return o;return n(C(),"teams")}function I(){let o=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(o)return o;return n(C(),"settings","providers.json")}function X(){let o=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(o)return o;return n(C(),"settings",T)}function l(o){let v=new Set,S=[];for(let u of o){if(!u||v.has(u))continue;v.add(u),S.push(u)}return S}function L(o){if(!o)return[];return[n(o,".clinerules",g),n(o,".cline",g),n(o,".claude",g),n(o,".agents",g)]}function Y(){return n(C(),"settings",F)}function m(){return[R(),Y()]}function r(o){return l([o?n(o,".clinerules",H):"",U()])}function x(o){return l([...L(o),n(C(),"settings",g),n(N(),g),n(s,".agents",g)])}function k(o){return l([o?n(o,".clinerules"):"",n(C(),"settings",M),E()])}function h(o){return l([o?n(o,".clinerules","workflows"):"",n(C(),"settings",f),W()])}function P(o){return l([o?n(o,".clinerules",O):"",n(N(),O),n(s,".agents",O)])}function b(o){let v=y(o);if(!G(v))e(v,{recursive:!0})}function c(o){if(o?.trim())return b(o),y(o);let v=n(C(),"hooks");if(!G(v))e(v,{recursive:!0});return v}export{J as setHomeDirIfUnset,B as setHomeDir,V as setClineDirIfUnset,Q as setClineDir,h as resolveWorkflowsConfigSearchPaths,$ as resolveTeamDataDir,x as resolveSkillsConfigSearchPaths,Z as resolveSessionDataDir,k as resolveRulesConfigSearchPaths,I as resolveProviderSettingsPath,P as resolvePluginConfigSearchPaths,X as resolveMcpSettingsPath,r as resolveHooksConfigSearchPaths,W as resolveDocumentsWorkflowsDirectoryPath,E as resolveDocumentsRulesDirectoryPath,U as resolveDocumentsHooksDirectoryPath,D as resolveDocumentsClineDirectoryPath,R as resolveDocumentsAgentConfigDirectoryPath,N as resolveClineDir,C as resolveClineDataDir,Y as resolveAgentsConfigDirPath,m as resolveAgentConfigSearchPaths,b as ensureParentDir,c as ensureHookLogDir,f as WORKFLOWS_CONFIG_DIRECTORY_NAME,g as SKILLS_CONFIG_DIRECTORY_NAME,M as RULES_CONFIG_DIRECTORY_NAME,H as HOOKS_CONFIG_DIRECTORY_NAME,T as CLINE_MCP_SETTINGS_FILE_NAME,F as AGENT_CONFIG_DIRECTORY_NAME};
+var s=Object.defineProperty;var n=(C)=>C;function w(C,D){this[C]=n.bind(null,D)}var EC=(C,D)=>{for(var N in D)s(C,N,{get:D[N],enumerable:!0,configurable:!0,set:w.bind(D,N)})};import{existsSync as g,mkdirSync as L,readdirSync as k,readFileSync as i,statSync as G}from"node:fs";import{dirname as U,join as S,resolve as H}from"node:path";var Y="agents",j="hooks",A="skills",q="rules",z="workflows",u="plugins",B="cline_mcp_settings.json",I=process?.env?.HOME||"~",Q=!1;function c(C){let D=C.trim();if(!D)return;I=D,Q=!0}function P(C){if(Q)return;let D=C.trim();if(!D)return;I=D}var T,V=!1;function d(C){let D=C.trim();if(!D)return;T=D,V=!0}function r(C){if(V)return;let D=C.trim();if(!D)return;T=D}function l(){if(T)return T;let C=process.env.CLINE_DIR?.trim();if(C)return C;return S(I,".cline")}function M(){return S(I,"Documents","Cline")}function Z(){return S(M(),"Agents")}function $(){return S(M(),"Hooks")}function f(){return S(M(),"Rules")}function X(){return S(M(),"Workflows")}function J(){return S(I,"Documents","Plugins")}function R(){let C=process.env.CLINE_DATA_DIR?.trim();if(C)return C;return S(l(),"data")}function h(){let C=process.env.CLINE_SESSION_DATA_DIR?.trim();if(C)return C;return S(R(),"sessions")}function p(){let C=process.env.CLINE_TEAM_DATA_DIR?.trim();if(C)return C;return S(R(),"teams")}function e(){let C=process.env.CLINE_PROVIDER_SETTINGS_PATH?.trim();if(C)return C;return S(R(),"settings","providers.json")}function t(){let C=process.env.CLINE_MCP_SETTINGS_PATH?.trim();if(C)return C;return S(R(),"settings",B)}function E(C){let D=new Set,N=[];for(let _ of C){if(!_||D.has(_))continue;D.add(_),N.push(_)}return N}function a(C){if(!C)return[];return[S(C,".clinerules",A),S(C,".cline",A),S(C,".claude",A),S(C,".agents",A)]}function x(){return S(R(),"settings",Y)}function CC(){return[Z(),x()]}function DC(C){return E([C?S(C,".clinerules",j):"",$()])}function SC(C){return E([...a(C),S(R(),"settings",A),S(l(),A),S(I,".agents",A)])}function vC(C){return E([C?S(C,".clinerules"):"",S(R(),"settings",q),f()])}function NC(C){return E([C?S(C,".clinerules","workflows"):"",S(R(),"settings",z),X()])}function OC(C){return E([C?S(C,".clinerules",u):"",S(l(),u),J()])}var b=new Set([".js",".mjs",".cjs",".ts",".mts",".cts"]),_C="package.json",RC=["index.ts","index.mts","index.cts","index.js","index.mjs","index.cjs"];function K(C){let D=C.lastIndexOf(".");if(D===-1)return!1;return b.has(C.slice(D))}function gC(C){try{let D=JSON.parse(i(C,"utf8"));if(!D.cline||typeof D.cline!=="object")return null;return D.cline}catch{return null}}function AC(C){let D=C?.plugins??C?.extensions;if(!Array.isArray(D))return[];return D.filter((N)=>typeof N==="string")}function o(C){let D=H(C);if(!g(D)||!G(D).isDirectory())return null;let N=S(D,_C);if(g(N)){let _=gC(N),O=AC(_).map((v)=>H(D,v)).filter((v)=>g(v)&&G(v).isFile()&&K(v));if(O.length>0)return O}for(let _ of RC){let O=S(D,_);if(g(O)&&G(O).isFile())return[O]}return null}function m(C){let D=H(C);if(!g(D))return[];let N=[],_=[D];while(_.length>0){let O=_.pop();if(!O)continue;for(let v of k(O,{withFileTypes:!0})){let F=S(O,v.name);if(v.isDirectory()){_.push(F);continue}if(v.name.startsWith("."))continue;if(v.isFile()&&K(F))N.push(F)}}return N.sort((O,v)=>O.localeCompare(v))}function IC(C,D){let N=[];for(let _ of C){let O=_.trim();if(!O)continue;let v=H(D,O);if(!g(v))throw Error(`Plugin path does not exist: ${v}`);if(G(v).isDirectory()){let W=o(v);if(W){N.push(...W);continue}N.push(...m(v));continue}if(!K(v))throw Error(`Plugin file must use a supported extension (${[...b].join(", ")}): ${v}`);N.push(v)}return N}function y(C){let D=U(C);if(!g(D))L(D,{recursive:!0})}function MC(C){if(C?.trim())return y(C),U(C);let D=S(R(),"hooks");if(!g(D))L(D,{recursive:!0});return D}export{P as setHomeDirIfUnset,c as setHomeDir,r as setClineDirIfUnset,d as setClineDir,NC as resolveWorkflowsConfigSearchPaths,p as resolveTeamDataDir,SC as resolveSkillsConfigSearchPaths,h as resolveSessionDataDir,vC as resolveRulesConfigSearchPaths,e as resolveProviderSettingsPath,o as resolvePluginModuleEntries,OC as resolvePluginConfigSearchPaths,t as resolveMcpSettingsPath,DC as resolveHooksConfigSearchPaths,X as resolveDocumentsWorkflowsDirectoryPath,f as resolveDocumentsRulesDirectoryPath,J as resolveDocumentsPluginsDirectoryPath,$ as resolveDocumentsHooksDirectoryPath,M as resolveDocumentsClineDirectoryPath,Z as resolveDocumentsAgentConfigDirectoryPath,IC as resolveConfiguredPluginModulePaths,l as resolveClineDir,R as resolveClineDataDir,x as resolveAgentsConfigDirPath,CC as resolveAgentConfigSearchPaths,K as isPluginModulePath,y as ensureParentDir,MC as ensureHookLogDir,m as discoverPluginModulePaths,z as WORKFLOWS_CONFIG_DIRECTORY_NAME,A as SKILLS_CONFIG_DIRECTORY_NAME,q as RULES_CONFIG_DIRECTORY_NAME,j as HOOKS_CONFIG_DIRECTORY_NAME,B as CLINE_MCP_SETTINGS_FILE_NAME,Y as AGENT_CONFIG_DIRECTORY_NAME};

package/dist/storage/paths.d.ts

@@ -15,6 +15,7 @@ export declare function resolveDocumentsAgentConfigDirectoryPath(): string;
 export declare function resolveDocumentsHooksDirectoryPath(): string;
 export declare function resolveDocumentsRulesDirectoryPath(): string;
 export declare function resolveDocumentsWorkflowsDirectoryPath(): string;
+export declare function resolveDocumentsPluginsDirectoryPath(): string;
 export declare function resolveClineDataDir(): string;
 export declare function resolveSessionDataDir(): string;
 export declare function resolveTeamDataDir(): string;
@@ -27,5 +28,9 @@ export declare function resolveSkillsConfigSearchPaths(workspacePath?: string):
 export declare function resolveRulesConfigSearchPaths(workspacePath?: string): string[];
 export declare function resolveWorkflowsConfigSearchPaths(workspacePath?: string): string[];
 export declare function resolvePluginConfigSearchPaths(workspacePath?: string): string[];
+export declare function isPluginModulePath(path: string): boolean;
+export declare function resolvePluginModuleEntries(directoryPath: string): string[] | null;
+export declare function discoverPluginModulePaths(directoryPath: string): string[];
+export declare function resolveConfiguredPluginModulePaths(pluginPaths: ReadonlyArray<string>, cwd: string): string[];
 export declare function ensureParentDir(filePath: string): void;
 export declare function ensureHookLogDir(filePath?: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@clinebot/shared",
-	"version": "0.0.10",
+	"version": "0.0.12",
 	"description": "Shared utilities, types, and schemas for Cline packages",
 	"type": "module",
 	"main": "dist/index.js",

package/src/db/sqlite-db.ts

@@ -13,26 +13,6 @@ export type SqliteDb = {
 	exec: (sql: string) => void;
 };
 
-type BunSqliteDb = {
-	query: (sql: string) => {
-		run: (...params: unknown[]) => { changes?: number };
-		get: (...params: unknown[]) => Record<string, unknown> | null;
-		all: (...params: unknown[]) => Record<string, unknown>[];
-	};
-	exec: (sql: string) => void;
-};
-
-type NodeSqliteStatement = {
-	run: (...params: unknown[]) => { changes?: number };
-	get: (...params: unknown[]) => Record<string, unknown> | undefined;
-	all: (...params: unknown[]) => Record<string, unknown>[];
-};
-
-type NodeSqliteDb = {
-	prepare: (sql: string) => NodeSqliteStatement;
-	exec: (sql: string) => void;
-};
-
 export function nowIso(): string {
 	return new Date().toISOString();
 }
@@ -46,9 +26,7 @@ export function asString(value: unknown): string {
 }
 
 export function asOptionalString(value: unknown): string | undefined {
-	if (typeof value !== "string") {
-		return undefined;
-	}
+	if (typeof value !== "string") return undefined;
 	const trimmed = value.trim();
 	return trimmed.length > 0 ? trimmed : undefined;
 }
@@ -57,59 +35,83 @@ export function asBool(value: unknown): boolean {
 	return value === 1 || value === true;
 }
 
+function wrapBunDb(db: {
+	query: (sql: string) => SqliteStatement;
+	exec: (sql: string) => void;
+}): SqliteDb {
+	return {
+		prepare: (sql) => db.query(sql),
+		exec: (sql) => db.exec(sql),
+	};
+}
+
+function wrapNodeDb(db: {
+	prepare: (sql: string) => {
+		run: (...params: unknown[]) => { changes?: number };
+		get: (...params: unknown[]) => Record<string, unknown> | undefined;
+		all: (...params: unknown[]) => Record<string, unknown>[];
+	};
+	exec: (sql: string) => void;
+}): SqliteDb {
+	return {
+		prepare: (sql) => {
+			const stmt = db.prepare(sql);
+			return {
+				run: (...params) => stmt.run(...params),
+				get: (...params) => stmt.get(...params) ?? null,
+				all: (...params) => stmt.all(...params),
+			};
+		},
+		exec: (sql) => db.exec(sql),
+	};
+}
+
 export function loadSqliteDb(filePath: string): SqliteDb {
 	mkdirSync(dirname(filePath), { recursive: true });
 	const require = createRequire(import.meta.url);
-	const isBunRuntime =
-		typeof (globalThis as { Bun?: unknown }).Bun !== "undefined";
 
-	if (isBunRuntime) {
+	if (typeof (globalThis as { Bun?: unknown }).Bun !== "undefined") {
 		const { Database } = require("bun:sqlite") as {
 			Database: new (
 				path: string,
-				options?: { create?: boolean; strict?: boolean },
-			) => BunSqliteDb;
-		};
-		const db = new Database(filePath, { create: true });
-
-		return {
-			prepare: (sql: string): SqliteStatement => {
-				const query = db.query(sql);
-				return {
-					run: (...params: unknown[]) => query.run(...params),
-					get: (...params: unknown[]) => query.get(...params),
-					all: (...params: unknown[]) => query.all(...params),
-				};
-			},
-			exec: (sql: string) => db.exec(sql),
+				options?: { create?: boolean },
+			) => {
+				query: (sql: string) => SqliteStatement;
+				exec: (sql: string) => void;
+			};
 		};
+		return wrapBunDb(new Database(filePath, { create: true }));
 	}
 
 	try {
-		const nodeSqliteModuleName = ["node", ":sqlite"].join("");
-		const { DatabaseSync } = require(nodeSqliteModuleName) as {
-			DatabaseSync: new (path: string) => NodeSqliteDb;
-		};
-		const db = new DatabaseSync(filePath);
-		return {
-			prepare: (sql: string): SqliteStatement => {
-				const statement = db.prepare(sql);
-				return {
-					run: (...params: unknown[]) => statement.run(...params),
-					get: (...params: unknown[]) => statement.get(...params) ?? null,
-					all: (...params: unknown[]) => statement.all(...params),
+		// Suppress "ExperimentalWarning: SQLite is an experimental feature"
+		const originalEmit = process.emitWarning;
+		process.emitWarning = ((warning: string | Error, ...args: unknown[]) => {
+			const msg =
+				typeof warning === "string" ? warning : (warning?.message ?? "");
+			if (msg.includes("SQLite")) return;
+			return (originalEmit as Function).call(process, warning, ...args);
+		}) as typeof process.emitWarning;
+
+		const { DatabaseSync } = require(["node", ":sqlite"].join("")) as {
+			DatabaseSync: new (
+				path: string,
+			) => {
+				prepare: (sql: string) => {
+					run: (...params: unknown[]) => { changes?: number };
+					get: (...params: unknown[]) => Record<string, unknown> | undefined;
+					all: (...params: unknown[]) => Record<string, unknown>[];
 				};
-			},
-			exec: (sql: string) => db.exec(sql),
+				exec: (sql: string) => void;
+			};
 		};
+		process.emitWarning = originalEmit;
+		return wrapNodeDb(new DatabaseSync(filePath));
 	} catch {
-		// Fall through to better-sqlite3 for older Node runtimes without node:sqlite.
+		// Fall through to better-sqlite3 for older Node runtimes.
 	}
 
-	// Keep the module name non-literal so browser/SSR bundlers don't try to resolve
-	// better-sqlite3 when this Node-only path is not executed.
-	const betterSqlite3ModuleName = ["better", "-sqlite3"].join("");
-	const BetterSqlite3 = require(betterSqlite3ModuleName) as new (
+	const BetterSqlite3 = require(["better", "-sqlite3"].join("")) as new (
 		path: string,
 	) => SqliteDb;
 	return new BetterSqlite3(filePath);
@@ -119,156 +121,195 @@ export interface SessionSchemaOptions {
 	includeLegacyMigrations?: boolean;
 }
 
+const SCHEMA_STATEMENTS = [
+	`CREATE TABLE IF NOT EXISTS sessions (
+		session_id TEXT PRIMARY KEY,
+		source TEXT NOT NULL,
+		pid INTEGER NOT NULL,
+		started_at TEXT NOT NULL,
+		ended_at TEXT,
+		exit_code INTEGER,
+		status TEXT NOT NULL,
+		status_lock INTEGER NOT NULL DEFAULT 0,
+		interactive INTEGER NOT NULL,
+		provider TEXT NOT NULL,
+		model TEXT NOT NULL,
+		cwd TEXT NOT NULL,
+		workspace_root TEXT NOT NULL,
+		team_name TEXT,
+		enable_tools INTEGER NOT NULL,
+		enable_spawn INTEGER NOT NULL,
+		enable_teams INTEGER NOT NULL,
+		parent_session_id TEXT,
+		parent_agent_id TEXT,
+		agent_id TEXT,
+		conversation_id TEXT,
+		is_subagent INTEGER NOT NULL DEFAULT 0,
+		prompt TEXT,
+		metadata_json TEXT,
+		transcript_path TEXT NOT NULL,
+		hook_path TEXT NOT NULL,
+		messages_path TEXT,
+		updated_at TEXT NOT NULL
+	);`,
+	`CREATE TABLE IF NOT EXISTS subagent_spawn_queue (
+		id INTEGER PRIMARY KEY AUTOINCREMENT,
+		root_session_id TEXT NOT NULL,
+		parent_agent_id TEXT NOT NULL,
+		task TEXT,
+		system_prompt TEXT,
+		created_at TEXT NOT NULL,
+		consumed_at TEXT
+	);`,
+	`CREATE TABLE IF NOT EXISTS schedules (
+		schedule_id TEXT PRIMARY KEY,
+		name TEXT NOT NULL,
+		cron_pattern TEXT NOT NULL,
+		prompt TEXT NOT NULL,
+		provider TEXT NOT NULL,
+		model TEXT NOT NULL,
+		mode TEXT NOT NULL DEFAULT 'act',
+		workspace_root TEXT,
+		cwd TEXT,
+		system_prompt TEXT,
+		max_iterations INTEGER,
+		timeout_seconds INTEGER,
+		max_parallel INTEGER NOT NULL DEFAULT 1,
+		enabled INTEGER NOT NULL DEFAULT 1,
+		created_at TEXT NOT NULL,
+		updated_at TEXT NOT NULL,
+		last_run_at TEXT,
+		next_run_at TEXT,
+		claim_token TEXT,
+		claim_started_at TEXT,
+		claim_until_at TEXT,
+		created_by TEXT,
+		tags TEXT,
+		metadata_json TEXT
+	);`,
+	`CREATE TABLE IF NOT EXISTS schedule_executions (
+		execution_id TEXT PRIMARY KEY,
+		schedule_id TEXT NOT NULL,
+		session_id TEXT,
+		triggered_at TEXT NOT NULL,
+		started_at TEXT,
+		ended_at TEXT,
+		status TEXT NOT NULL,
+		exit_code INTEGER,
+		error_message TEXT,
+		iterations INTEGER,
+		tokens_used INTEGER,
+		cost_usd REAL,
+		FOREIGN KEY (schedule_id) REFERENCES schedules(schedule_id) ON DELETE CASCADE,
+		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);`,
+];
+
+const LEGACY_MIGRATIONS: Array<{
+	table: string;
+	column: string;
+	sql: string;
+}> = [
+	{
+		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: "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 getColumnNames(db: SqliteDb, table: string): Set<string> {
+	return new Set(
+		db
+			.prepare(`PRAGMA table_info(${table});`)
+			.all()
+			.map((c) => c.name as string),
+	);
+}
+
 export function ensureSessionSchema(
 	db: SqliteDb,
 	options: SessionSchemaOptions = {},
 ): void {
 	db.exec("PRAGMA journal_mode = WAL;");
 	db.exec("PRAGMA busy_timeout = 5000;");
-	db.exec(`
-		CREATE TABLE IF NOT EXISTS sessions (
-			session_id TEXT PRIMARY KEY,
-			source TEXT NOT NULL,
-			pid INTEGER NOT NULL,
-			started_at TEXT NOT NULL,
-			ended_at TEXT,
-			exit_code INTEGER,
-			status TEXT NOT NULL,
-			status_lock INTEGER NOT NULL DEFAULT 0,
-			interactive INTEGER NOT NULL,
-			provider TEXT NOT NULL,
-			model TEXT NOT NULL,
-			cwd TEXT NOT NULL,
-			workspace_root TEXT NOT NULL,
-			team_name TEXT,
-			enable_tools INTEGER NOT NULL,
-			enable_spawn INTEGER NOT NULL,
-			enable_teams INTEGER NOT NULL,
-			parent_session_id TEXT,
-			parent_agent_id TEXT,
-			agent_id TEXT,
-			conversation_id TEXT,
-			is_subagent INTEGER NOT NULL DEFAULT 0,
-			prompt TEXT,
-			metadata_json TEXT,
-			transcript_path TEXT NOT NULL,
-			hook_path TEXT NOT NULL,
-			messages_path TEXT,
-			updated_at TEXT NOT NULL
-		);
-	`);
-	db.exec(`
-		CREATE TABLE IF NOT EXISTS subagent_spawn_queue (
-			id INTEGER PRIMARY KEY AUTOINCREMENT,
-			root_session_id TEXT NOT NULL,
-			parent_agent_id TEXT NOT NULL,
-			task TEXT,
-			system_prompt TEXT,
-			created_at TEXT NOT NULL,
-			consumed_at TEXT
-		);
-	`);
-	db.exec(`
-		CREATE TABLE IF NOT EXISTS schedules (
-			schedule_id TEXT PRIMARY KEY,
-			name TEXT NOT NULL,
-			cron_pattern TEXT NOT NULL,
-			prompt TEXT NOT NULL,
-			provider TEXT NOT NULL,
-			model TEXT NOT NULL,
-			mode TEXT NOT NULL DEFAULT 'act',
-			workspace_root TEXT,
-			cwd TEXT,
-			system_prompt TEXT,
-			max_iterations INTEGER,
-			timeout_seconds INTEGER,
-			max_parallel INTEGER NOT NULL DEFAULT 1,
-			enabled INTEGER NOT NULL DEFAULT 1,
-			created_at TEXT NOT NULL,
-			updated_at TEXT NOT NULL,
-			last_run_at TEXT,
-			next_run_at TEXT,
-			claim_token TEXT,
-			claim_started_at TEXT,
-			claim_until_at TEXT,
-			created_by TEXT,
-			tags TEXT,
-			metadata_json TEXT
-		);
-	`);
-	db.exec(`
-		CREATE TABLE IF NOT EXISTS schedule_executions (
-			execution_id TEXT PRIMARY KEY,
-			schedule_id TEXT NOT NULL,
-			session_id TEXT,
-			triggered_at TEXT NOT NULL,
-			started_at TEXT,
-			ended_at TEXT,
-			status TEXT NOT NULL,
-			exit_code INTEGER,
-			error_message TEXT,
-			iterations INTEGER,
-			tokens_used INTEGER,
-			cost_usd REAL,
-			FOREIGN KEY (schedule_id) REFERENCES schedules(schedule_id) ON DELETE CASCADE,
-			FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE SET NULL
-		);
-	`);
-	db.exec(`
-		CREATE INDEX IF NOT EXISTS idx_schedule_executions_schedule
-		ON schedule_executions(schedule_id, triggered_at DESC);
-	`);
-	db.exec(`
-		CREATE INDEX IF NOT EXISTS idx_schedules_next_run
-		ON schedules(enabled, next_run_at);
-	`);
-
-	if (!options.includeLegacyMigrations) {
-		return;
+	for (const stmt of SCHEMA_STATEMENTS) {
+		db.exec(stmt);
 	}
 
-	const columns = db.prepare("PRAGMA table_info(sessions);").all();
-	const hasColumn = (name: string): boolean =>
-		columns.some((column) => column.name === name);
-	if (!hasColumn("workspace_root")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN workspace_root TEXT;");
-		db.exec(
-			"UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';",
-		);
-	}
-	if (!hasColumn("parent_session_id")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN parent_session_id TEXT;");
-	}
-	if (!hasColumn("parent_agent_id")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN parent_agent_id TEXT;");
-	}
-	if (!hasColumn("agent_id")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN agent_id TEXT;");
-	}
-	if (!hasColumn("conversation_id")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN conversation_id TEXT;");
-	}
-	if (!hasColumn("is_subagent")) {
-		db.exec(
-			"ALTER TABLE sessions ADD COLUMN is_subagent INTEGER NOT NULL DEFAULT 0;",
-		);
-	}
-	if (!hasColumn("messages_path")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN messages_path TEXT;");
-	}
-	if (!hasColumn("metadata_json")) {
-		db.exec("ALTER TABLE sessions ADD COLUMN metadata_json TEXT;");
-	}
-	const scheduleColumns = db.prepare("PRAGMA table_info(schedules);").all();
-	const scheduleHasColumn = (name: string): boolean =>
-		scheduleColumns.some((column) => column.name === name);
-	if (!scheduleHasColumn("claim_token")) {
-		db.exec("ALTER TABLE schedules ADD COLUMN claim_token TEXT;");
-	}
-	if (!scheduleHasColumn("claim_started_at")) {
-		db.exec("ALTER TABLE schedules ADD COLUMN claim_started_at TEXT;");
-	}
-	if (!scheduleHasColumn("claim_until_at")) {
-		db.exec("ALTER TABLE schedules ADD COLUMN claim_until_at TEXT;");
+	if (!options.includeLegacyMigrations) return;
+
+	const columnCache = new Map<string, Set<string>>();
+	const getColumns = (table: string) => {
+		let cols = columnCache.get(table);
+		if (!cols) {
+			cols = getColumnNames(db, table);
+			columnCache.set(table, cols);
+		}
+		return cols;
+	};
+
+	for (const migration of LEGACY_MIGRATIONS) {
+		if (!getColumns(migration.table).has(migration.column)) {
+			db.exec(migration.sql);
+			if (migration.column === "workspace_root") {
+				db.exec(
+					"UPDATE sessions SET workspace_root = cwd WHERE workspace_root IS NULL OR workspace_root = '';",
+				);
+			}
+		}
 	}
 }

package/src/rpc/runtime.ts

@@ -75,6 +75,7 @@ export interface RpcChatRunTurnRequest {
 	messages?: RpcChatMessage[];
 	prompt: string;
 	attachments?: RpcChatAttachments;
+	delivery?: "queue" | "steer";
 }
 
 export interface RpcChatToolCallResult {

package/src/storage/index.ts

@@ -1,22 +1,27 @@
 export {
 	AGENT_CONFIG_DIRECTORY_NAME,
 	CLINE_MCP_SETTINGS_FILE_NAME,
+	discoverPluginModulePaths,
 	ensureHookLogDir,
 	ensureParentDir,
 	HOOKS_CONFIG_DIRECTORY_NAME,
+	isPluginModulePath,
 	RULES_CONFIG_DIRECTORY_NAME,
 	resolveAgentConfigSearchPaths,
 	resolveAgentsConfigDirPath,
 	resolveClineDataDir,
 	resolveClineDir,
+	resolveConfiguredPluginModulePaths,
 	resolveDocumentsAgentConfigDirectoryPath,
 	resolveDocumentsClineDirectoryPath,
 	resolveDocumentsHooksDirectoryPath,
+	resolveDocumentsPluginsDirectoryPath,
 	resolveDocumentsRulesDirectoryPath,
 	resolveDocumentsWorkflowsDirectoryPath,
 	resolveHooksConfigSearchPaths,
 	resolveMcpSettingsPath,
 	resolvePluginConfigSearchPaths,
+	resolvePluginModuleEntries,
 	resolveProviderSettingsPath,
 	resolveRulesConfigSearchPaths,
 	resolveSessionDataDir,

package/src/storage/paths.ts

@@ -1,5 +1,11 @@
-import { existsSync, mkdirSync } from "node:fs";
-import { dirname, join } from "node:path";
+import {
+	existsSync,
+	mkdirSync,
+	readdirSync,
+	readFileSync,
+	statSync,
+} from "node:fs";
+import { dirname, join, resolve } from "node:path";
 
 export const AGENT_CONFIG_DIRECTORY_NAME = "agents";
 export const HOOKS_CONFIG_DIRECTORY_NAME = "hooks";
@@ -86,6 +92,10 @@ export function resolveDocumentsWorkflowsDirectoryPath(): string {
 	return join(resolveDocumentsClineDirectoryPath(), "Workflows");
 }
 
+export function resolveDocumentsPluginsDirectoryPath(): string {
+	return join(HOME_DIR, "Documents", "Plugins");
+}
+
 export function resolveClineDataDir(): string {
 	const explicitDir = process.env.CLINE_DATA_DIR?.trim();
 	if (explicitDir) {
@@ -212,10 +222,164 @@ export function resolvePluginConfigSearchPaths(
 			? join(workspacePath, ".clinerules", PLUGINS_DIRECTORY_NAME)
 			: "",
 		join(resolveClineDir(), PLUGINS_DIRECTORY_NAME),
-		join(HOME_DIR, ".agents", PLUGINS_DIRECTORY_NAME),
+		resolveDocumentsPluginsDirectoryPath(),
 	]);
 }
 
+const PLUGIN_MODULE_EXTENSIONS = new Set([
+	".js",
+	".mjs",
+	".cjs",
+	".ts",
+	".mts",
+	".cts",
+]);
+const PLUGIN_PACKAGE_JSON_FILE_NAME = "package.json";
+const PLUGIN_DIRECTORY_INDEX_CANDIDATES = [
+	"index.ts",
+	"index.mts",
+	"index.cts",
+	"index.js",
+	"index.mjs",
+	"index.cjs",
+];
+
+interface PluginPackageManifest {
+	plugins?: unknown;
+	extensions?: unknown;
+}
+
+export function isPluginModulePath(path: string): boolean {
+	const dot = path.lastIndexOf(".");
+	if (dot === -1) {
+		return false;
+	}
+	return PLUGIN_MODULE_EXTENSIONS.has(path.slice(dot));
+}
+
+function readPluginPackageManifest(
+	packageJsonPath: string,
+): PluginPackageManifest | null {
+	try {
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8")) as {
+			cline?: PluginPackageManifest;
+		};
+		if (!packageJson.cline || typeof packageJson.cline !== "object") {
+			return null;
+		}
+		return packageJson.cline;
+	} catch {
+		return null;
+	}
+}
+
+function getManifestPluginEntries(
+	manifest: PluginPackageManifest | null,
+): string[] {
+	const entries = manifest?.plugins ?? manifest?.extensions;
+	if (!Array.isArray(entries)) {
+		return [];
+	}
+	return entries.filter((entry): entry is string => typeof entry === "string");
+}
+
+export function resolvePluginModuleEntries(
+	directoryPath: string,
+): string[] | null {
+	const root = resolve(directoryPath);
+	if (!existsSync(root) || !statSync(root).isDirectory()) {
+		return null;
+	}
+
+	const packageJsonPath = join(root, PLUGIN_PACKAGE_JSON_FILE_NAME);
+	if (existsSync(packageJsonPath)) {
+		const manifest = readPluginPackageManifest(packageJsonPath);
+		const entries = getManifestPluginEntries(manifest)
+			.map((entry) => resolve(root, entry))
+			.filter(
+				(entryPath) =>
+					existsSync(entryPath) &&
+					statSync(entryPath).isFile() &&
+					isPluginModulePath(entryPath),
+			);
+		if (entries.length > 0) {
+			return entries;
+		}
+	}
+
+	for (const candidate of PLUGIN_DIRECTORY_INDEX_CANDIDATES) {
+		const entryPath = join(root, candidate);
+		if (existsSync(entryPath) && statSync(entryPath).isFile()) {
+			return [entryPath];
+		}
+	}
+
+	return null;
+}
+
+export function discoverPluginModulePaths(directoryPath: string): string[] {
+	const root = resolve(directoryPath);
+	if (!existsSync(root)) {
+		return [];
+	}
+	const discovered: string[] = [];
+	const stack = [root];
+	while (stack.length > 0) {
+		const current = stack.pop();
+		if (!current) {
+			continue;
+		}
+		for (const entry of readdirSync(current, { withFileTypes: true })) {
+			const candidate = join(current, entry.name);
+			if (entry.isDirectory()) {
+				stack.push(candidate);
+				continue;
+			}
+			if (entry.name.startsWith(".")) {
+				continue;
+			}
+			if (entry.isFile() && isPluginModulePath(candidate)) {
+				discovered.push(candidate);
+			}
+		}
+	}
+	return discovered.sort((a, b) => a.localeCompare(b));
+}
+
+export function resolveConfiguredPluginModulePaths(
+	pluginPaths: ReadonlyArray<string>,
+	cwd: string,
+): string[] {
+	const resolvedPaths: string[] = [];
+	for (const pluginPath of pluginPaths) {
+		const trimmed = pluginPath.trim();
+		if (!trimmed) {
+			continue;
+		}
+		const absolutePath = resolve(cwd, trimmed);
+		if (!existsSync(absolutePath)) {
+			throw new Error(`Plugin path does not exist: ${absolutePath}`);
+		}
+		const stats = statSync(absolutePath);
+		if (stats.isDirectory()) {
+			const entries = resolvePluginModuleEntries(absolutePath);
+			if (entries) {
+				resolvedPaths.push(...entries);
+				continue;
+			}
+			resolvedPaths.push(...discoverPluginModulePaths(absolutePath));
+			continue;
+		}
+		if (!isPluginModulePath(absolutePath)) {
+			throw new Error(
+				`Plugin file must use a supported extension (${[...PLUGIN_MODULE_EXTENSIONS].join(", ")}): ${absolutePath}`,
+			);
+		}
+		resolvedPaths.push(absolutePath);
+	}
+	return resolvedPaths;
+}
+
 export function ensureParentDir(filePath: string): void {
 	const parent = dirname(filePath);
 	if (!existsSync(parent)) {