aws-runtime-bridge 1.9.134 → 1.9.137

package/dist/services/plugin-manager.js

@@ -0,0 +1,10 @@
+import{spawn as C}from"node:child_process";import{cpSync as F,existsSync as S,lstatSync as X,mkdirSync as L,readFileSync as E,readdirSync as H,renameSync as V,rmSync as v,symlinkSync as Q,writeFileSync as B}from"node:fs";import{dirname as Z,join as g,resolve as R,sep as ee}from"node:path";import{pathToFileURL as te}from"node:url";import{parseAcodeCommandMarkdown as ne}from"@agentswork/acode";import{getAcodePluginDataHome as K}from"../config.js";import{createLogger as re}from"../utils/logger.js";import{sanitizeAgentId as M,withFileLock as W}from"../utils/file-utils.js";import{isCapabilityEnabled as se,getAgentPluginSources as ie}from"./instance-features.js";import{setDeployedDefaultsProvider as oe,reconcileDefaultsFromDeployed as ae}from"./capability-config.js";import{downloadPluginZip as le,sanitizeArchiveFileName as ue}from"../utils/file-utils.js";import{PluginEventBuffer as ce}from"./plugin-event-buffer.js";import{extractPluginZip as j}from"./plugin-package.js";const d=re("plugin-manager"),de=200,_=256*1024,fe=4*1024,ge=6e4,J=6e4,pe=/^[a-zA-Z0-9_][a-zA-Z0-9_-]*$/,I=/^[a-z0-9][a-z0-9-]*$/,he=["system.","aws-","acode-"],me=new Set(["NODE_OPTIONS","NODE_PATH","NODE_EXTRA_CA_CERTS","NODE_REPL_HISTORY","LD_PRELOAD","LD_LIBRARY_PATH","LD_AUDIT","DYLD_INSERT_LIBRARIES","DYLD_LIBRARY_PATH","DYLD_FRAMEWORK_PATH","PYTHONPATH","PYTHONSTARTUP","PYTHONHOME","PERL5LIB","PERL5OPT","RUBYOPT","RUBYLIB","BASH_ENV","ENV","SHELLOPTS","BASHOPTS","IFS","PS1","PS4","GIT_SSH","GIT_SSH_COMMAND","GIT_CONFIG","GIT_CONFIG_GLOBAL","PATH","HOME","USERPROFILE","SYSTEMROOT","COMSPEC","TEMP","TMP","LANG","TZ"]),ye=/^[A-Za-z_][A-Za-z0-9_]*$/,Se=process.platform==="win32"?"junction":"dir",we=/[^\x20-\x7E]/,$e=6e4,x=20,Pe=80;function P(l){return typeof l=="object"&&l!==null&&!Array.isArray(l)}function O(l,e){let t=l;for(const n of e.split(".")){if(!P(t))return;t=t[n]}return t}function A(l,e){return l.length<=e?l:`${l.slice(0,e)}\u2026(\u622A\u65AD,\u5171 ${l.length} \u5B57\u7B26)`}async function b(l,e=8,t=200){for(let n=0;;n++)try{v(l,{recursive:!0,force:!0});return}catch(r){if(n>=e-1)throw r;await new Promise(s=>setTimeout(s,t))}}function k(l,e){l.logs.push(`${new Date().toISOString()} ${e}`),l.logs.length>de&&l.logs.shift()}function q(l,e,t="params"){if(!P(l))return[];const n=[],r=l.type;if(typeof r=="string"&&!ve(r,e))return[`${t}: \u671F\u671B ${r}\uFF0C\u5B9E\u9645 ${De(e)}`];if(Array.isArray(l.enum)&&l.enum.length>0&&(l.enum.some(o=>JSON.stringify(o)===JSON.stringify(e))||n.push(`${t}: \u503C ${JSON.stringify(e)} \u4E0D\u5728\u679A\u4E3E ${JSON.stringify(l.enum)} \u5185`)),r==="object"&&P(e)){const s=P(l.properties)?l.properties:{},o=Array.isArray(l.required)?l.required:[];for(const i of o)(!(i in e)||e[i]===void 0)&&n.push(`${t}.${i}: \u5FC5\u586B\u53C2\u6570\u7F3A\u5931`);for(const[i,a]of Object.entries(s))i in e&&e[i]!==void 0&&n.push(...q(a,e[i],`${t}.${i}`));if(l.additionalProperties===!1)for(const i of Object.keys(e))i in s||n.push(`${t}.${i}: \u4E0D\u5141\u8BB8\u7684\u672A\u77E5\u53C2\u6570\uFF08schema additionalProperties=false\uFF09`)}return r==="array"&&Array.isArray(e)&&P(l.items)&&e.forEach((s,o)=>{n.push(...q(l.items,s,`${t}[${o}]`))}),n}function ve(l,e){switch(l){case"string":return typeof e=="string";case"number":return typeof e=="number"&&Number.isFinite(e);case"boolean":return typeof e=="boolean";case"object":return P(e);case"array":return Array.isArray(e);case"null":return e===null;default:return!0}}function De(l){return l===null?"null":Array.isArray(l)?"array":typeof l}class Ee{constructor(e={}){this.agents=new Map,this.templatePullInFlight=new Set,this.backgroundTemplatePulls=new Set,this.rootDir=e.rootDir??g(K(),"plugins"),this.runtimeRootDir=e.runtimeRootDir??g(K(),"plugins-runtime")}forAgent(e){return{listPlugins:()=>this.list(e),getCatalog:()=>this.getCatalog(e),getToolSchema:t=>this.getToolSchema(e,t),invokeTool:(t,n,r,s)=>this.invokeTool(e,t,n,r,s),manage:t=>this.manage(e,t),getCommandDirs:()=>this.getCommandDirs(e)}}setOnPluginsChanged(e){this.onPluginsChanged=e}notifyPluginsChanged(e){try{this.onPluginsChanged?.(e)}catch(t){d.warn("[agent:%s] onPluginsChanged \u56DE\u8C03\u5931\u8D25: %s",e,t instanceof Error?t.message:String(t))}}async getCommandDirs(e){return[...(await this.hydrate(e)).plugins.values()].filter(n=>n.enabled&&n.commandDir).map(n=>n.commandDir)}async getPluginCommands(e){const t=await this.hydrate(e),n=[];for(const r of t.plugins.values())!r.enabled||!r.commandDir||n.push(...this.parsePluginCommandDir(r));return n}parsePluginCommandDir(e){const t=[];try{for(const n of H(e.commandDir)){if(!n.endsWith(".md"))continue;const r=g(e.commandDir,n);try{t.push(ne(r,E(r,"utf8")))}catch(s){d.warn("[plugin:%s] \u547D\u4EE4\u89E3\u6790\u5931\u8D25 %s: %s",e.name,n,s instanceof Error?s.message:String(s))}}}catch{}return t}async list(e){const t=await this.hydrate(e),n=new Map;for(const r of t.plugins.values()){const s=this.toSummary(r);n.set(s.name,s)}for(const r of this.readSharedManifest()){const s=r.pluginName;if(!this.deployedPluginHealthy(s))continue;const i=n.get(s);if(i){String(i.source||"").startsWith("shared:")&&(i.enabled=this.effectiveSharedEnabled(e,r));continue}n.set(s,{name:s,version:this.deployedPluginVersion(s),status:"enabled",enabled:this.effectiveSharedEnabled(e,r),source:`shared:${r.fileName??`${s}.zip`}`,installedAt:new Date().toISOString(),toolCount:0,listeners:[]})}return[...n.values()].sort((r,s)=>r.name.localeCompare(s.name))}deployedPluginVersion(e){try{const t=JSON.parse(E(g(this.deployedPluginDir(e),"plugin.json"),"utf8"));return typeof t.version=="string"?t.version:void 0}catch{return}}async getCatalog(e){const t=await this.hydrate(e),n=[];for(const r of t.plugins.values()){if(!r.enabled||r.status==="error")continue;const s=r.tools.slice(0,x).map(o=>({name:o.name,description:A(o.title||o.description,Pe),requiredParams:this.requiredParamsOf(o)}));r.tools.length>x&&s.push({name:`(\u53E6\u6709 ${r.tools.length-x} \u4E2A\u5DE5\u5177\u672A\u5217\u51FA)`,description:'\u7528 function_call {action:"catalog"} \u67E5\u770B\u5168\u91CF',requiredParams:void 0}),n.push({plugin:r.name,version:r.version,description:r.description,status:r.status,tools:s})}return{revision:t.buffer.currentRevision,plugins:n}}async getToolSchema(e,t){const n=ke(t);if(!n)return null;const s=(await this.hydrate(e)).plugins.get(n.plugin);if(!s||!s.enabled)return null;const o=s.tools.find(i=>i.name===n.tool);return o?{plugin:s.name,name:o.name,title:o.title,description:o.description,inputSchema:o.inputSchema??{type:"object",properties:{}}}:null}async invokeTool(e,t,n,r,s){const o=await this.hydrate(e),i=o.plugins.get(t);if(!i)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5\uFF08\u53EF\u7528\u63D2\u4EF6: ${[...o.plugins.keys()].join(", ")||"\u65E0"}\uFF09`};if(!i.enabled)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u5DF2\u505C\u7528\uFF0C\u53EF\u8BA9\u7528\u6237\u5728\u9762\u677F\u6216\u7528 plugin_manage enable \u542F\u7528`};const a=i.tools.find(u=>u.name===n);if(!a)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u65E0\u5DE5\u5177 ${n}\uFF08\u53EF\u7528: ${i.tools.map(u=>u.name).join(", ")||"\u65E0"}\uFF09`};if(a.inputSchema){const u=q(a.inputSchema,r);if(u.length>0)return{ok:!1,error:`\u53C2\u6570\u6821\u9A8C\u5931\u8D25: ${u.join("; ")}`,inputSchema:a.inputSchema}}return this.executeHandler(e,i,a,r,s)}async executeHandler(e,t,n,r,s){const o=Date.now(),i=n.handler??{type:"process"};try{return i.type==="mcp"?{ok:!1,error:"handler.type=mcp \u5C06\u5728\u540E\u7EED\u7248\u672C\u652F\u6301\uFF0C\u8BF7\u6539\u7528 process/module handler"}:i.type==="module"?{ok:!0,result:await this.invokeModuleHandler(t,i,r,e,s),durationMs:Date.now()-o}:!i.command||!i.command.trim()?{ok:!1,error:`\u5DE5\u5177 ${n.name} \u7684 process handler \u7F3A\u5C11 command`}:{ok:!0,result:await this.invokeProcessHandler(t,i,r,e,s),durationMs:Date.now()-o}}catch(a){return{ok:!1,error:a instanceof Error?a.message:String(a),durationMs:Date.now()-o}}}async invokeProcessHandler(e,t,n,r,s){const o=U(t.command??"",{params:n});if(o.length===0)throw new Error("process handler command \u4E3A\u7A7A");const i=typeof t.timeoutMs=="number"&&t.timeoutMs>0?t.timeoutMs:ge,a=new AbortController,u=()=>a.abort();s?.signal?.addEventListener("abort",u,{once:!0});const c=setTimeout(()=>a.abort(),i);try{return await new Promise((f,y)=>{d.info("[plugin:%s] spawn: %s",e.name,o.join(" "));const m=C(o[0],o.slice(1),{cwd:e.dir,env:this.buildPluginEnv(e,r),shell:t.shell===!0,windowsHide:!0,signal:a.signal});let p="",w="";m.stdin?.on("error",()=>{}),m.stdout?.on("data",$=>{p.length<_&&(p+=$.toString("utf8"))}),m.stderr?.on("data",$=>{w.length<_&&(w+=$.toString("utf8"))}),m.on("error",$=>{y(new Error(`\u63D2\u4EF6\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${$.message}`))}),m.on("close",$=>{const D=p.trim();if($!==0){const N=A(w.trim()||D||"(\u65E0\u8F93\u51FA)",600);y(new Error(a.signal.aborted?`\u63D2\u4EF6\u8FDB\u7A0B\u8D85\u65F6(${i}ms)\u6216\u88AB\u4E2D\u6B62`:`\u63D2\u4EF6\u8FDB\u7A0B\u9000\u51FA\u7801 ${$}: ${N}`));return}if(!D){f({ok:!0});return}try{f(JSON.parse(D))}catch{f(D)}});try{t.stdin==="params"?m.stdin?.end(`${JSON.stringify(n)}
+`):m.stdin?.end()}catch{}})}finally{clearTimeout(c),s?.signal?.removeEventListener("abort",u)}}async invokeModuleHandler(e,t,n,r,s){if(!t.module)throw new Error("module handler \u7F3A\u5C11 module \u8DEF\u5F84");const o=g(e.dir,t.module);let i=e.moduleCache.get(o);i||(i=await import(te(o).href),e.moduleCache.set(o,i));const a=t.export||"default",c=i[a];if(typeof c!="function")throw new Error(`\u6A21\u5757 ${t.module} \u672A\u5BFC\u51FA\u51FD\u6570 ${a}`);return await c(n,{agentId:r,signal:s?.signal,pluginRoot:e.dir})}buildPluginEnv(e,t){const n={};for(const s of["PATH","HOME","USERPROFILE","SystemRoot","COMSPEC","TEMP","TMP","LANG","TZ"]){const o=process.env[s];o!==void 0&&(n[s]=o)}n.ACODE_PLUGIN_ROOT=e.dir,n.ACODE_AGENT_ID=t,n.ACODE_PLUGIN_NAME=e.name;const r=new Set((e.userConfig??[]).map(s=>s.key));for(const[s,o]of Object.entries(e.configValues))r.has(s)&&(!ye.test(s)||me.has(s.toUpperCase())||(n[s]=o));return n}async manage(e,t){const n=this.agentState(e),r=n.queue.then(async()=>{const s=await this.hydrate(e);return this.doManage(s,t)});return n.queue=r.catch(()=>{}),r}async doManage(e,t){switch(t.action){case"list":return{ok:!0,plugins:[...e.plugins.values()].map(n=>this.toSummary(n))};case"install":return this.installPlugin(e,t);case"uninstall":return this.uninstallPlugin(e,t);case"reload":return this.reloadPlugin(e,t);case"enable":case"disable":return this.setEnabled(e,t,t.action==="enable");default:return{ok:!1,error:`\u672A\u77E5 action: ${String(t.action)}`}}}async installPlugin(e,t){const n=(t.source??"").trim();if(!n)return{ok:!1,error:"install \u9700\u8981 source\uFF08\u5F53\u524D\u652F\u6301 local:<\u63D2\u4EF6\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84>\uFF09"};const r=n.split(":",1)[0];if(r!=="local")return{ok:!1,error:`\u6682\u4E0D\u652F\u6301\u63D2\u4EF6\u6765\u6E90 "${r}:"\uFF08npm:/git: \u5728\u8DEF\u7EBF\u56FE\u4E2D\uFF1Bzip \u5305\u8BF7\u7528\u9762\u677F\u5BFC\u5165\u6216 POST /runtime/plugins/:agentId/upload\uFF09`};const s=n.slice(6).trim();if(!s||!S(g(s,"plugin.json")))return{ok:!1,error:`\u63D2\u4EF6\u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u7F3A\u5C11 plugin.json: ${s}`};const o=R(this.rootDir),i=R(s);return i!==o&&!i.startsWith(o+ee)?{ok:!1,error:`local \u6765\u6E90\u5FC5\u987B\u5728\u63D2\u4EF6\u76EE\u5F55\uFF08${this.rootDir}\uFF09\u5185\u52A0\u8F7D\uFF0C\u4E0D\u5141\u8BB8\u4EFB\u610F\u8DEF\u5F84: ${s}`}:this.installFromDirectory(e,s,n,t.config)}async installFromZip(e,t,n,r){if(!t||t.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};const s=await this.hydrate(e),o=s.queue.then(async()=>{const i=g(this.rootDir,"tmp",`upload-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const a=await j(t,i);return S(g(a.pluginDir,"plugin.json"))?(d.info("[agent:%s] zip \u5BFC\u5165: %s\uFF08%d \u4E2A\u6587\u4EF6\uFF09",e,n,a.fileCount),await this.installFromDirectory(s,a.pluginDir,`upload:${n}`,r)):{ok:!1,error:"zip \u5185\u672A\u627E\u5230 plugin.json\uFF08\u8BF7\u6253\u5305\u63D2\u4EF6\u76EE\u5F55\uFF0C\u4E14 zip \u5185\u8DEF\u5F84\u4F7F\u7528\u82F1\u6587\uFF09"}}catch(a){const u=a instanceof Error?a.message:String(a);return d.warn("[agent:%s] zip \u5BFC\u5165\u5931\u8D25: %s",e,u),{ok:!1,error:`zip \u5BFC\u5165\u5931\u8D25: ${u}`}}finally{await b(i,3,100).catch(()=>{})}});return s.queue=o.catch(()=>{}),o}async installFromDirectory(e,t,n,r){const s=this.loadManifestOnly(t);if(!s.ok)return s;const o=s.manifest.name,i=g(this.rootDir,"cache",M(e.agentId),o),a=e.plugins.get(o);a&&this.stopAllListeners(a);try{await b(i),L(Z(i),{recursive:!0}),F(t,i,{recursive:!0,filter:f=>!/[\\/]\.git([\\/]|$)/.test(f)&&!/[\\/]node_modules([\\/]|$)/.test(f)})}catch(f){const y=f instanceof Error?f.message:String(f);return d.warn("[agent:%s] \u63D2\u4EF6\u7269\u5316\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,n,y),a&&this.startAllListeners(e,a),{ok:!1,error:`\u63D2\u4EF6\u7269\u5316\u5931\u8D25: ${y}`}}const u=this.loadPluginFromDir(e,i,n,new Date().toISOString(),r??{});if(!u.ok)return d.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,n,u.error),await b(i),u;const c=u.plugin;return e.plugins.set(c.name,c),this.persistInstalled(e),this.startAllListeners(e,c),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u5B89\u88C5: %s@%s",e.agentId,c.name,c.version??"?"),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:this.toSummary(c)}}async uninstallPlugin(e,t){const n=(t.name??"").trim(),r=e.plugins.get(n);return r?(this.stopAllListeners(r),e.plugins.delete(n),this.readSharedManifest().some(o=>o.pluginName===n)&&this.removeRuntimeLink(e.agentId,n),this.persistInstalled(e),await b(r.dir),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u5378\u8F7D: %s",e.agentId,n),this.notifyPluginsChanged(e.agentId),{ok:!0}):{ok:!1,error:`\u63D2\u4EF6 ${n} \u672A\u5B89\u88C5`}}async reloadPlugin(e,t){const n=(t.name??"").trim(),r=e.plugins.get(n);if(!r)return{ok:!1,error:`\u63D2\u4EF6 ${n} \u672A\u5B89\u88C5`};const s=this.loadPluginFromDir(e,r.dir,r.source,r.installedAt,r.configValues);if(!s.ok)return{ok:!1,error:`\u91CD\u8F7D\u5931\u8D25\uFF08\u4FDD\u7559\u65E7\u7248\u672C\u8FD0\u884C\uFF09: ${s.error}`};const o=s.plugin;return this.stopAllListeners(r),e.plugins.set(n,o),this.persistInstalled(e),this.startAllListeners(e,o),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u91CD\u8F7D: %s",e.agentId,n),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:this.toSummary(o)}}async setEnabled(e,t,n){const r=(t.name??"").trim(),s=e.plugins.get(r);return s?(s.enabled=n,n?this.startAllListeners(e,s):this.stopAllListeners(s),this.persistInstalled(e),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:this.toSummary(s)}):{ok:!1,error:`\u63D2\u4EF6 ${r} \u672A\u5B89\u88C5`}}deployedDir(){return g(this.rootDir,"deployed")}deployedManifestFile(){return g(this.deployedDir(),"manifest.json")}deployedPluginDir(e){if(!z(e))throw new Error(`\u975E\u6CD5\u63D2\u4EF6\u540D\uFF08\u4EC5\u5141\u8BB8 ${I}\uFF09: ${JSON.stringify(e)}`);const t=g(this.deployedDir(),e),n=R(this.deployedDir());if(R(t)!==g(n,e))throw new Error(`\u63D2\u4EF6\u76EE\u5F55\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return t}legacySharedDir(){return g(this.rootDir,"shared")}readSharedManifest(){try{const e=JSON.parse(E(this.deployedManifestFile(),"utf8"));return Array.isArray(e.plugins)?e.plugins.filter(t=>t&&z(t.pluginName)):[]}catch{return[]}}writeSharedManifest(e){L(this.deployedDir(),{recursive:!0}),B(this.deployedManifestFile(),`${JSON.stringify({version:2,plugins:e},null,2)}
+`,"utf8")}async migrateLegacySharedIfNeeded(){try{if(S(this.deployedManifestFile()))return;const e=g(this.legacySharedDir(),"manifest.json");if(!S(e))return;const t=JSON.parse(E(e,"utf8")),n=Array.isArray(t.plugins)?t.plugins:[];if(n.length===0)return;const r=[];for(const s of n){const o=g(this.legacySharedDir(),s.zipFile);if(!(!s.pluginName||!S(o)))try{const i=await this.deployPluginZipToPersistentDir(E(o),s.pluginName);if(!i)continue;r.push(i),d.info("[shared] \u65E7\u5171\u4EAB\u63D2\u4EF6\u8FC1\u79FB\u5230\u90E8\u7F72\u533A: %s",s.pluginName)}catch(i){d.warn("[shared] \u65E7\u5171\u4EAB\u63D2\u4EF6 %s \u8FC1\u79FB\u5931\u8D25: %s",s.pluginName,i instanceof Error?i.message:String(i))}}r.length>0&&this.writeSharedManifest(r),v(this.legacySharedDir(),{recursive:!0,force:!0})}catch(e){d.warn("[shared] \u65E7\u5171\u4EAB\u63D2\u4EF6\u8FC1\u79FB\u672A\u6267\u884C\uFF08\u4E0B\u6B21\u91CD\u8BD5\uFF09: %s",e instanceof Error?e.message:String(e))}}deployedPluginHealthy(e){return S(g(this.deployedPluginDir(e),"plugin.json"))}runtimeDirFor(e){return g(this.runtimeRootDir,M(e))}runtimeLinkPath(e,t){return g(this.runtimeDirFor(e),t)}ensureRuntimeLink(e,t){const n=this.runtimeLinkPath(e,t),r=this.deployedPluginDir(t);if(!S(g(r,"plugin.json")))return!1;L(this.runtimeDirFor(e),{recursive:!0});try{if(S(n)){let s=!1;try{s=X(n).isSymbolicLink()}catch{s=!1}if(s)try{return H(n),!0}catch{}v(n,{recursive:!0,force:!0})}return Q(r,n,Se),d.info("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5DF2\u5EFA\u7ACB: %s \u2192 %s",e,n,r),!0}catch(s){return d.warn("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5931\u8D25\uFF08%s \u2192 %s\uFF09: %s",e,t,r,s instanceof Error?s.message:String(s)),!1}}removeRuntimeLink(e,t){const n=this.runtimeLinkPath(e,t);try{S(n)&&(v(n,{recursive:!0,force:!0}),d.info("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5DF2\u79FB\u9664: %s",e,t))}catch(r){d.warn("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u79FB\u9664\u5931\u8D25\uFF08%s\uFF09: %s",e,t,r instanceof Error?r.message:String(r))}}async saveSharedPlugin(e,t,n=!0,r){if(!e||e.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};await this.migrateLegacySharedIfNeeded();const s=g(this.rootDir,"tmp",`deploy-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const o=await j(e,s),i=this.loadManifestOnly(o.pluginDir);if(!i.ok)return i;const a=i.manifest.name,u=this.readSharedManifest().find(p=>p.pluginName===a);if(u&&u.sha256===r&&this.deployedPluginHealthy(a))return{ok:!0,pluginName:a};await this.suspendDeployedPluginAcrossAgents(a),L(this.deployedDir(),{recursive:!0});const c=this.deployedPluginDir(a),f=g(this.deployedDir(),`.old-${a}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);if(S(c))try{V(c,f)}catch{v(c,{recursive:!0,force:!0})}try{F(o.pluginDir,c,{recursive:!0,filter:p=>!/[\\/]\.git([\\/]|$)/.test(p)&&!/[\\/]node_modules([\\/]|$)/.test(p)})}catch(p){throw S(f)&&(v(c,{recursive:!0,force:!0}),V(f,c)),p}S(f)&&v(f,{recursive:!0,force:!0}),await W(this.deployedManifestFile(),async()=>{const p=this.readSharedManifest().filter(w=>w.pluginName!==a);p.push({pluginName:a,zipFile:u?.zipFile??`${a}.zip`,fileName:t,defaultEnabled:n,sha256:r}),this.writeSharedManifest(p)}),d.info("[shared] \u63D2\u4EF6\u5DF2\u90E8\u7F72\u5230 bridge: %s\uFF08\u6765\u6E90 %s%s\uFF09",a,t,r?`, sha256=${r.slice(0,12)}\u2026`:"");const m=(await this.applySharedToKnownAgents()).find(p=>p.installed.includes(a));return m&&d.info("[shared] \u5DF2\u540C\u6B65\u5230\u8FD0\u884C\u4E2D agent: %s",m.agentId),{ok:!0,pluginName:a}}catch(o){const i=o instanceof Error?o.message:String(o);return d.warn("[shared] \u63D2\u4EF6\u90E8\u7F72\u5931\u8D25\uFF08%s\uFF09: %s",t,i),{ok:!1,error:`\u63D2\u4EF6\u90E8\u7F72\u5931\u8D25: ${i}`}}finally{await b(s,3,100).catch(()=>{})}}async deployPluginZipToPersistentDir(e,t){if(!e||e.length===0)return null;const n=g(this.rootDir,"tmp",`migrate-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const r=await j(e,n),s=this.loadManifestOnly(r.pluginDir);if(!s.ok)return null;const o=s.manifest.name;if(t&&o!==t)return null;L(this.deployedDir(),{recursive:!0});const i=this.deployedPluginDir(o);return S(i)&&v(i,{recursive:!0,force:!0}),F(r.pluginDir,i,{recursive:!0,filter:a=>!/[\\/]\.git([\\/]|$)/.test(a)&&!/[\\/]node_modules([\\/]|$)/.test(a)}),{pluginName:o,zipFile:`${o}.zip`,fileName:`${o}.zip`,defaultEnabled:!0}}finally{v(n,{recursive:!0,force:!0})}}async suspendDeployedPluginAcrossAgents(e){for(const t of[...this.agents.values()]){if(!t.hydrated)continue;const n=t.queue.then(async()=>{const r=t.plugins.get(e);r&&(this.stopAllListeners(r),t.plugins.delete(e),d.info("[agent:%s] \u5DF2\u6458\u9664\u63D2\u4EF6\u7B49\u5F85\u90E8\u7F72\u533A\u66F4\u65B0: %s",t.agentId,e))});t.queue=n.catch(()=>{}),await n}}async applySharedToKnownAgents(){const e=[];for(const t of this.agents.values()){if(!t.hydrated)continue;const n=await this.syncSharedIntoStateQueued(t);n.length>0&&e.push({agentId:t.agentId,installed:n})}return e}async syncSharedIntoStateQueued(e){const t=e.queue.then(()=>this.syncSharedIntoState(e));return e.queue=t.catch(()=>[]),t}effectiveSharedEnabled(e,t){return se(e,"plugins",t.pluginName)&&(t.defaultEnabled??!0)}async pullTemplatePluginsFromCapabilities(e){const t=ie(e.agentId);if(!t)return;const n=this.readSharedManifest();for(const[r,s]of Object.entries(t)){if(!s.url)continue;const o=n.find(a=>a.pluginName===r);if(!o||!o.sha256||o.sha256===s.sha256&&this.deployedPluginHealthy(r)||this.templatePullInFlight.has(r))continue;this.templatePullInFlight.add(r);const i=g(this.rootDir,"tmp",`pull-${M(e.agentId)}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{L(i,{recursive:!0});let a=`${r}.zip`;try{const y=decodeURIComponent(s.url.split("/").pop()||"");y.toLowerCase().endsWith(".zip")&&(a=ue(y,`${r}.zip`))}catch{}const u=await le({downloadUrl:s.url,fileName:a,sha256:s.sha256},i);if(!u)continue;const c=E(u.outputPath),f=await this.saveSharedPlugin(c,u.fileName,o.defaultEnabled??!0,s.sha256);f.ok?d.info("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u81EA\u52A8\u5BF9\u8D26\u66F4\u65B0\u6210\u529F: %s",e.agentId,f.pluginName??r):d.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u66F4\u65B0\u5931\u8D25: %s: %s",e.agentId,r,f.error)}catch(a){d.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6 %s \u66F4\u65B0\u5931\u8D25: %s",e.agentId,r,a instanceof Error?a.message:String(a))}finally{this.templatePullInFlight.delete(r),await b(i,3,100).catch(()=>{})}}}queueTemplatePull(e){this.backgroundTemplatePulls.has(e.agentId)||(this.backgroundTemplatePulls.add(e.agentId),this.pullTemplatePluginsFromCapabilities(e).catch(t=>{d.warn("[agent:%s] \u540E\u53F0\u63D2\u4EF6\u5BF9\u8D26\u66F4\u65B0\u5931\u8D25: %s",e.agentId,t instanceof Error?t.message:String(t))}).finally(()=>{this.backgroundTemplatePulls.delete(e.agentId)}))}async syncSharedIntoState(e){this.queueTemplatePull(e);const t=this.readSharedManifest(),n=new Set,r=[];for(const s of t)if(n.add(s.pluginName),this.effectiveSharedEnabled(e.agentId,s)){const i=e.plugins.get(s.pluginName);if(!this.ensureRuntimeLink(e.agentId,s.pluginName))continue;const a=this.runtimeLinkPath(e.agentId,s.pluginName);if(!i){const u=this.loadPluginFromDir(e,a,`shared:${s.fileName}`,new Date().toISOString(),{});u.ok?(e.plugins.set(u.plugin.name,u.plugin),r.push(u.plugin.name),d.info("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u5DF2\u6309\u5F00\u542F\u6001\u52A0\u8F7D: %s",e.agentId,s.pluginName)):d.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u52A0\u8F7D\u5931\u8D25: %s: %s",e.agentId,s.pluginName,u.error)}}else{const i=e.plugins.get(s.pluginName);i&&(this.stopAllListeners(i),e.plugins.delete(s.pluginName)),this.removeRuntimeLink(e.agentId,s.pluginName)}return this.cleanupRuntimeDir(e,n),this.persistInstalled(e),r}cleanupRuntimeDir(e,t){const n=this.runtimeDirFor(e.agentId);try{if(!S(n))return;const r=new Set(t);for(const s of H(n))!r.has(s)&&!e.plugins.has(s)&&this.removeRuntimeLink(e.agentId,s)}catch{}}async applyCapabilities(e){const t=await this.hydrate(e);await this.pullTemplatePluginsFromCapabilities(t),await this.syncSharedIntoState(t)}async drainEvents(e,t={}){const n=await this.hydrate(e);this.ensureListenersRunning(n);const r=n.buffer.drain(t),s=await this.getCatalog(e);return{revision:r.revision,events:r.events,catalog:s,compactionSeq:n.compactionSeq}}markAgentCompacted(e){const t=this.agentState(e);t.compactionSeq++,d.debug("[agent:%s] \u4E0A\u4E0B\u6587\u538B\u7F29\u6807\u8BB0: compactionSeq=%d",e,t.compactionSeq)}async enqueueExternalEvent(e,t,n){const r=await this.hydrate(e),s=r.plugins.get(t);if(!s||!s.enabled)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5\u6216\u5DF2\u505C\u7528`};const o=typeof n.event=="string"?n.event:"",i=s.listeners.find(a=>a.transport.type==="http-callback"&&(!o||a.event===o));return i?(this.enqueueEvent(r,s,i,n),{ok:!0}):{ok:!1,error:`\u63D2\u4EF6 ${t} \u65E0\u5339\u914D\u7684 http-callback \u76D1\u542C\u5668\uFF08event=${o||"(\u7A7A)"}\uFF09`}}agentState(e){let t=this.agents.get(e);return t||(t={agentId:e,plugins:new Map,buffer:new ce(e),hydrated:!1,queue:Promise.resolve(),eventSeq:0,compactionSeq:0},this.agents.set(e,t)),t}async hydrate(e){await this.migrateLegacySharedIfNeeded();const t=this.agentState(e);if(t.hydrated)return t;t.hydrated=!0;const n=this.installedFile(e);if(!S(n))return await this.syncSharedIntoState(t).catch(()=>{}),t;try{const r=JSON.parse(E(n,"utf8"));for(const s of r.plugins??[]){if(String(s.source||"").startsWith("shared:"))continue;const i=g(this.rootDir,"cache",M(e),s.name);if(!S(g(i,"plugin.json"))){d.warn("[agent:%s] \u5DF2\u5B89\u88C5\u63D2\u4EF6\u76EE\u5F55\u7F3A\u5931\uFF0C\u8DF3\u8FC7: %s",e,s.name);continue}const a=this.loadPluginFromDir(t,i,s.source,s.installedAt,s.config??{});if(a.ok){const u=a.plugin;u.enabled=s.enabled,t.plugins.set(u.name,u)}else d.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u5931\u8D25: %s: %s",e,s.name,a.error)}}catch(r){const s=r instanceof Error?r.message:String(r);d.error("[agent:%s] installed.json \u89E3\u6790\u5931\u8D25: %s",e,s)}return await this.syncSharedIntoState(t).catch(r=>{d.warn("[agent:%s] \u5171\u4EAB\u63D2\u4EF6\u540C\u6B65\u5931\u8D25: %s",e,r instanceof Error?r.message:String(r))}),t}installedFile(e){return g(this.rootDir,"agents",M(e),"installed.json")}persistInstalled(e){const t=this.installedFile(e.agentId);L(Z(t),{recursive:!0});const n=[...e.plugins.values()].map(r=>({name:r.name,source:r.source,installedAt:r.installedAt,enabled:r.enabled,config:r.configValues}));B(t,`${JSON.stringify({version:1,plugins:n},null,2)}
+`,"utf8")}readJsonFile(e){if(!S(e))return{ok:!0,data:{}};try{const t=JSON.parse(E(e,"utf8"));return P(t)?{ok:!0,data:t}:{ok:!1,error:`${e}: \u6839\u8282\u70B9\u987B\u4E3A\u5BF9\u8C61`}}catch(t){const n=t instanceof Error?t.message:String(t);return{ok:!1,error:`${e}: JSON \u89E3\u6790\u5931\u8D25: ${n}`}}}loadManifestOnly(e){const t=this.readJsonFile(g(e,"plugin.json"));if(!t.ok)return t;const n=t.data,r=Ae(n);return r?{ok:!1,error:r}:{ok:!0,manifest:n}}loadPluginFromDir(e,t,n,r,s){const o=this.loadManifestOnly(t);if(!o.ok)return o;const i=o.manifest,a=g(t,i.tools??"tools/tools.json"),u=this.readJsonFile(a);if(!u.ok)return u;const c=[],f=Array.isArray(u.data.tools)?u.data.tools:[];for(const h of f){const T=Le(h);if(T)return{ok:!1,error:`${i.tools??"tools/tools.json"}: ${T}`};c.push(h)}const y=g(t,i.listeners??"listeners/listeners.json"),m=this.readJsonFile(y);if(!m.ok)return m;const p=[],w=Array.isArray(m.data.listeners)?m.data.listeners:[];for(const h of w){const T=Te(h);if(T)return{ok:!1,error:`${i.listeners??"listeners/listeners.json"}: ${T}`};p.push(h)}const $=Array.isArray(i.userConfig)?i.userConfig:[],D={...s};for(const h of $){if(!h||typeof h.key!="string"||!/^[A-Za-z_][A-Za-z0-9_]*$/.test(h.key))return{ok:!1,error:"plugin.json: userConfig.key \u975E\u6CD5\uFF08\u987B\u4E3A\u73AF\u5883\u53D8\u91CF\u540D\uFF09"};if(!(typeof D[h.key]=="string"&&D[h.key].length>0)&&h.required){const G=h.default!==void 0&&typeof h.default=="string"?h.default:"";if(G)D[h.key]=G;else return{ok:!1,error:`\u7F3A\u5C11\u5FC5\u9700\u914D\u7F6E ${h.key}${h.description?`\uFF08${h.description}\uFF09`:""}\uFF0C\u5B89\u88C5\u65F6\u8BF7\u5728 config \u4E2D\u63D0\u4F9B`}}}const N=i.commands;let Y;if(typeof N=="string"&&N.trim()){const h=g(t,N.trim());S(h)&&(Y=h)}return{ok:!0,plugin:{name:i.name,version:typeof i.version=="string"?i.version:void 0,description:typeof i.description=="string"?i.description:void 0,source:n,installedAt:r,dir:t,enabled:!0,tools:c,listeners:p,commandDir:Y,userConfig:$,configValues:D,status:"enabled",runtimes:p.map(h=>({def:h,stopping:!1,restarts:0,logs:[]})),moduleCache:new Map}}}ensureListenersRunning(e){for(const t of e.plugins.values())if(t.enabled)for(const n of t.runtimes)!n.child&&!n.timer&&!n.backoffTimer&&!n.stopping&&this.startListener(e,t,n)}startAllListeners(e,t){for(const n of t.runtimes)this.stopListener(n),t.enabled&&this.startListener(e,t,n)}stopAllListeners(e){for(const t of e.runtimes)this.stopListener(t)}startListener(e,t,n){const r=n.def.transport??{type:"command-stream"};if(r.type==="http-callback"){n.stopping=!1;return}if(r.type==="poll-command"){const s=Math.max(5e3,r.intervalMs??3e4);n.stopping=!1,n.timer=setInterval(()=>{this.pollListenerOnce(e,t,n)},s),this.pollListenerOnce(e,t,n);return}if(!r.command){n.lastError="command-stream \u7F3A\u5C11 command",k(n,`ERROR ${n.lastError}`);return}n.stopping=!1,this.spawnListenerChild(e,t,n)}spawnListenerChild(e,t,n){const s=n.def.transport?.command??"",o=U(s,{});try{k(n,`spawn: ${o.join(" ")}`);const i=C(o[0],o.slice(1),{cwd:t.dir,env:this.buildPluginEnv(t,e.agentId),shell:!1,windowsHide:!0,stdio:["ignore","pipe","pipe"]});n.child=i,n.lastError=void 0;let a="";i.stdout?.on("data",u=>{a+=u.toString("utf8");let c=a.indexOf(`
+`);for(;c>=0;){const f=a.slice(0,c).trim();a=a.slice(c+1),f&&this.handleListenerLine(e,t,n,f),c=a.indexOf(`
+`)}a.length>1024*1024&&(a=a.slice(-4096))}),i.stderr?.on("data",u=>{k(n,`stderr: ${A(u.toString("utf8").trimEnd(),400)}`)}),i.on("error",u=>{n.lastError=`\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${u.message}`,k(n,`ERROR ${n.lastError}`)}),i.on("close",u=>{n.child=void 0,!n.stopping&&(n.lastError=`\u76D1\u542C\u8FDB\u7A0B\u9000\u51FA\uFF08code=${u??"signal"}\uFF09`,k(n,`exit code=${u??"signal"}\uFF0C\u51C6\u5907\u91CD\u542F`),this.scheduleListenerRestart(e,t,n))})}catch(i){const a=i instanceof Error?i.message:String(i);n.lastError=a,k(n,`ERROR spawn: ${a}`),this.scheduleListenerRestart(e,t,n)}}scheduleListenerRestart(e,t,n){if(n.stopping)return;const r=Math.max(500,n.def.transport?.restartBackoffMs??2e3),s=Math.min($e,r*2**Math.min(n.restarts,6));n.restarts++,k(n,`restart #${n.restarts} in ${s}ms`),n.backoffTimer=setTimeout(()=>{n.backoffTimer=void 0,n.stopping||this.spawnListenerChild(e,t,n)},s)}async pollListenerOnce(e,t,n){if(n.polling)return;const r=n.def.transport?.command??"",s=U(r,{});if(s.length===0)return;n.polling=!0;const o=new AbortController,i=setTimeout(()=>o.abort(),J);try{const a=await new Promise((u,c)=>{const f=C(s[0],s.slice(1),{cwd:t.dir,env:this.buildPluginEnv(t,e.agentId),shell:!1,windowsHide:!0,stdio:["ignore","pipe","pipe"],signal:o.signal});let y="",m="";f.stdout?.on("data",w=>{y.length<_&&(y+=w.toString("utf8"))}),f.stderr?.on("data",w=>{m.length<_&&(m+=w.toString("utf8"))});const p=()=>o.signal.aborted;f.on("error",w=>{c(p()?new Error(`poll \u8D85\u65F6(${J}ms)`):w)}),f.on("close",w=>{p()?c(new Error(`poll \u8D85\u65F6(${J}ms)`)):w===0?u(y):c(new Error(`exit ${w}: ${A(m||y,300)}`))})});n.lastError=void 0;for(const u of a.split(`
+`)){const c=u.trim();c&&this.handleListenerLine(e,t,n,c)}}catch(a){const u=a instanceof Error?a.message:String(a);n.lastError=u,k(n,`poll \u5931\u8D25: ${u}`)}finally{clearTimeout(i),n.polling=!1}}stopListener(e){if(e.stopping=!0,e.restarts=0,e.child){try{e.child.kill()}catch{}e.child=void 0}e.timer&&(clearInterval(e.timer),e.timer=void 0),e.backoffTimer&&(clearTimeout(e.backoffTimer),e.backoffTimer=void 0)}handleListenerLine(e,t,n,r){k(n,`event: ${A(r,300)}`);let s;try{s=JSON.parse(r)}catch{n.lastError="\u4E8B\u4EF6\u884C\u4E0D\u662F\u5408\u6CD5 JSON\uFF08\u8981\u6C42 JSONL\uFF09";return}if(!P(s))return;const o=typeof s.event=="string"?s.event:n.def.event,i=o===n.def.event?n.def:t.listeners.find(a=>a.event===o);i&&(i.delivery&&i.delivery!=="poll"&&d.debug("[plugin:%s] delivery=%s \u6682\u6309 poll \u4EA4\u4ED8",t.name,i.delivery),this.enqueueEvent(e,t,i,s))}enqueueEvent(e,t,n,r){for(const[y,m]of Object.entries(n.matcher??{})){const p=O(r,y);if(!(Array.isArray(m)?m:[m]).some($=>JSON.stringify($)===JSON.stringify(p)))return}let s;if(n.dedupKey){const y=O(r,n.dedupKey);y!=null&&(s=A(String(y),256))}e.eventSeq++;const o=A(be(r.data??r),fe),i=n.promptTemplate?Oe(n.promptTemplate,r):`\u3010\u63D2\u4EF6\u4E8B\u4EF6\u3011${t.name} \xB7 ${n.event}${n.description?`
+${n.description}`:""}`,a=(n.toolHints??[]).join(","),u=`${i}
+[plugin-event] plugin=${t.name} event=${n.event}`+(a?` toolHints=${a}`:"")+` payload=${o}`,c={msgId:A(s?`plugin-event-${t.name}-${s}`:`plugin-event-${t.name}-${n.event}-${e.eventSeq}`,512),channel:"plugin-event",senderId:`plugin:${t.name}`,senderName:`\u63D2\u4EF6[${t.name}]`,receiverId:e.agentId||void 0,content:u,requireReply:!1,role:"system",timestamp:new Date().toISOString()},f=n.priority??"normal";e.buffer.push({plugin:t.name,event:n.event,priority:f,dedupKey:s,receivedAt:Date.now(),message:c})}requiredParamsOf(e){const t=e.inputSchema;if(!(!t||!Array.isArray(t.required)))return t.required.filter(n=>typeof n=="string")}toSummary(e){return{name:e.name,version:e.version,description:e.description,status:e.status,enabled:e.enabled,source:e.source,installedAt:e.installedAt,toolCount:e.tools.length,listeners:e.runtimes.map(t=>({event:t.def.event,delivery:t.def.delivery??"poll",running:!!(t.child||t.timer)||t.def.transport?.type==="http-callback",error:t.lastError})),error:e.error}}async getLogs(e,t){const r=(await this.hydrate(e)).plugins.get(t);if(!r)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5`,logs:[]};const s=[];for(const o of r.runtimes)s.push(`\u2500\u2500 listener ${o.def.event} (${o.def.transport?.type}) ${o.lastError?`[error: ${o.lastError}]`:""}`),s.push(...o.logs);return{ok:!0,logs:s}}async stopAgent(e){const t=this.agents.get(e);if(t){for(const n of t.plugins.values())this.stopAllListeners(n);this.agents.delete(e)}}async stopAll(){for(const e of[...this.agents.keys()])await this.stopAgent(e)}async listDeployed(){await this.migrateLegacySharedIfNeeded();const e=this.readSharedManifest(),t=[];for(const n of e){const r=this.deployedPluginDir(n.pluginName),s=this.deployedPluginHealthy(n.pluginName);let o;if(s)try{const i=JSON.parse(E(g(r,"plugin.json"),"utf8"));typeof i.version=="string"&&(o=i.version)}catch{}t.push({pluginName:n.pluginName,version:o,fileName:n.fileName??`${n.pluginName}.zip`,defaultEnabled:n.defaultEnabled!==!1,sha256:n.sha256,deployed:s})}return t}deployedDefaultEnabled(){const e=this.readSharedManifest(),t={};for(const n of e)t[n.pluginName]=n.defaultEnabled!==!1;return t}async removeDeployedPlugin(e){if(!z(e))return{ok:!1,error:"pluginName \u975E\u6CD5\uFF08\u987B\u4E3A kebab-case\uFF0C1~64 \u5B57\u7B26\uFF09"};await this.migrateLegacySharedIfNeeded();for(const t of[...this.agents.values()]){if(!t.hydrated)continue;const n=t.queue.then(async()=>{const r=t.plugins.get(e);r&&(this.stopAllListeners(r),t.plugins.delete(e)),this.removeRuntimeLink(t.agentId,e),this.persistInstalled(t)});t.queue=n.catch(()=>{}),await n}await W(this.deployedManifestFile(),async()=>{const t=this.readSharedManifest().filter(n=>n.pluginName!==e);this.writeSharedManifest(t)});try{v(this.deployedPluginDir(e),{recursive:!0,force:!0})}catch(t){return{ok:!1,error:`\u90E8\u7F72\u76EE\u5F55\u6E05\u7406\u5931\u8D25: ${t instanceof Error?t.message:String(t)}`}}return d.info("[shared] \u63D2\u4EF6\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",e),{ok:!0}}}function ke(l){const e=l.indexOf(".");if(e<=0||e>=l.length-1)return null;const t=l.slice(0,e),n=l.slice(e+1);return!I.test(t)||!n.trim()?null:{plugin:t,tool:n.trim()}}function z(l){return typeof l=="string"&&l.length>0&&l.length<=64&&I.test(l)}function Ae(l){const e=l.name;if(typeof e!="string"||!I.test(e))return`plugin.json: name \u975E\u6CD5\uFF08\u987B\u4E3A kebab-case\uFF09: ${String(e)}`;if(e.length>64)return"plugin.json: name \u8FC7\u957F\uFF08\u226464\uFF09";for(const t of he)if(e===t.replace(/\.$/,"")||e.startsWith(t))return`plugin.json: name \u4F7F\u7528\u4E86\u4FDD\u7559\u524D\u7F00 ${t}`;return we.test(e)?"plugin.json: name \u542B\u975E ASCII \u5B57\u7B26\uFF08\u540C\u5F62\u5B57\u9632\u62A4\uFF09":l.version!==void 0&&typeof l.version!="string"?"plugin.json: version \u987B\u4E3A\u5B57\u7B26\u4E32":l.userConfig!==void 0&&!Array.isArray(l.userConfig)?"plugin.json: userConfig \u987B\u4E3A\u6570\u7EC4":null}function Le(l){if(!P(l))return"\u5DE5\u5177\u6761\u76EE\u987B\u4E3A\u5BF9\u8C61";const e=l.name;if(typeof e!="string"||!pe.test(e))return`\u5DE5\u5177 name \u975E\u6CD5: ${String(e)}`;if(typeof l.description!="string"||!l.description.trim())return`\u5DE5\u5177 ${e} \u7F3A\u5C11 description`;const t=l.handler;if(!P(t))return`\u5DE5\u5177 ${e} \u7F3A\u5C11 handler`;const n=t.type;return n!=="process"&&n!=="module"&&n!=="mcp"?`\u5DE5\u5177 ${e} handler.type \u975E\u6CD5: ${String(n)}`:n==="process"&&typeof t.command!="string"?`\u5DE5\u5177 ${e} \u7684 process handler \u7F3A\u5C11 command`:n==="module"&&typeof t.module!="string"?`\u5DE5\u5177 ${e} \u7684 module handler \u7F3A\u5C11 module`:l.inputSchema!==void 0&&!P(l.inputSchema)?`\u5DE5\u5177 ${e} inputSchema \u987B\u4E3A\u5BF9\u8C61`:null}function Te(l){if(!P(l))return"\u76D1\u542C\u5668\u6761\u76EE\u987B\u4E3A\u5BF9\u8C61";if(typeof l.event!="string"||!l.event.trim())return"\u76D1\u542C\u5668\u7F3A\u5C11 event";const e=l.transport;if(!P(e))return`\u76D1\u542C\u5668 ${String(l.event)} \u7F3A\u5C11 transport`;const t=e.type;if(t!=="command-stream"&&t!=="poll-command"&&t!=="http-callback")return`\u76D1\u542C\u5668 ${String(l.event)} transport.type \u975E\u6CD5: ${String(t)}`;if((t==="command-stream"||t==="poll-command")&&typeof e.command!="string")return`\u76D1\u542C\u5668 ${String(l.event)} \u7684 ${t} transport \u7F3A\u5C11 command`;const n=l.delivery;return n!==void 0&&n!=="poll"&&n!=="force"&&n!=="wake"?`\u76D1\u542C\u5668 ${String(l.event)} delivery \u975E\u6CD5: ${String(n)}`:null}function U(l,e){return l.trim().split(/\s+/).map(t=>{const n=/^\{\{(.+)\}\}$/.exec(t);if(n){const r=O(e,n[1].trim());return r==null?"":typeof r=="string"?r:JSON.stringify(r)}return t.replace(/\{\{(.+?)\}\}/g,(r,s)=>{const o=O(e,s.trim());return o==null?"":typeof o=="string"?o:JSON.stringify(o)})}).filter(t=>t!=="")}function Oe(l,e){return l.replace(/\{\{(.+?)\}\}/g,(t,n)=>{let r=O(e,n.trim());return r===void 0&&!n.trim().startsWith("params.")&&(r=O(e,`data.${n.trim()}`)),r==null?"":typeof r=="string"?r:JSON.stringify(r)})}function be(l){try{return JSON.stringify(l)??"null"}catch{return"(\u4E0D\u53EF\u5E8F\u5217\u5316\u7684\u4E8B\u4EF6\u8D1F\u8F7D)"}}const Ne=new Ee;oe("plugins",()=>Ne.deployedDefaultEnabled());const Ge=()=>ae("plugins");export{Ee as PluginManager,z as isValidPluginName,Ne as pluginManager,Ge as reconcilePluginsDefaultsFromDeployed,U as renderCommandArgv,ke as splitQualifiedName,q as validateAgainstSchema,Ae as validateManifest};
+

package/dist/services/plugin-package.d.ts

@@ -0,0 +1,8 @@
+
+export interface PluginZipExtractResult {
+    
+    pluginDir: string;
+    fileCount: number;
+}
+
+export declare function extractPluginZip(zipBuffer: Buffer, stagingRoot: string): Promise<PluginZipExtractResult>;

package/dist/services/plugin-package.js

@@ -0,0 +1,2 @@
+import{createWriteStream as w}from"node:fs";import{mkdir as m,readdir as h,rm as p}from"node:fs/promises";import u from"node:path";import{Readable as d,Transform as f}from"node:stream";import{pipeline as y}from"node:stream/promises";import x from"unzipper";const s={maxEntries:2e3,maxFileBytes:100*1024*1024,maxTotalBytes:200*1024*1024,maxPathLength:400,maxPathDepth:24};function z(t,e){let r=0;return new f({transform(i,o,a){if(r+=i.length,r>t){a(new Error(`${e} \u8D85\u51FA\u4E0A\u9650\uFF08${t} \u5B57\u8282\uFF09`));return}a(null,i)}})}function E(t,e){let r=0;return{transform(){return new f({transform(i,o,a){if(r+=i.length,r>t){a(new Error(`${e} \u8D85\u51FA\u603B\u91CF\u4E0A\u9650\uFF08${t} \u5B57\u8282\uFF09`));return}a(null,i)}})}}}function $(t,e){const r=String(e||"").replace(/\\/g,"/");if(!r||r.startsWith("/")||/^[A-Za-z]:/.test(r)||r.split("/").includes(".."))throw new Error(`zip \u6761\u76EE\u8DEF\u5F84\u975E\u6CD5: ${e}`);if(r.length>s.maxPathLength)throw new Error(`zip \u6761\u76EE\u8DEF\u5F84\u8FC7\u957F: ${e}`);if(r.split("/").filter(Boolean).length>s.maxPathDepth)throw new Error(`zip \u6761\u76EE\u8DEF\u5F84\u8FC7\u6DF1: ${e}`);const i=u.resolve(t,r),o=u.resolve(t)+u.sep;if(i!==u.resolve(t)&&!i.startsWith(o))throw new Error(`zip \u6761\u76EE\u8D8A\u754C\uFF08zip-slip\uFF09: ${e}`);return i}async function F(t,e){await p(e,{recursive:!0,force:!0}),await m(e,{recursive:!0});const r=d.from([t]),i=r.pipe(x.Parse({forceStream:!0}));let o=0,a=0;const c=E(s.maxTotalBytes,"zip \u89E3\u538B\u603B\u91CF");try{for await(const n of i){const l=$(e,n.path);if(n.type==="Directory"){await m(l,{recursive:!0}),n.autodrain?.();continue}if(n.type!=="File"){n.autodrain?.();continue}if(o++,o>s.maxEntries)throw new Error(`zip \u6761\u76EE\u6570\u8D85\u51FA\u4E0A\u9650\uFF08${s.maxEntries}\uFF09`);if(a+=Number(n.size??0),a>s.maxTotalBytes)throw new Error(`zip \u603B\u91CF\u8D85\u51FA\u4E0A\u9650\uFF08${s.maxTotalBytes} \u5B57\u8282\uFF09`);await m(u.dirname(l),{recursive:!0}),await y(n,z(s.maxFileBytes,`zip \u6761\u76EE ${n.path}`),c.transform(),w(l))}}catch(n){throw await p(e,{recursive:!0,force:!0}).catch(()=>{}),n}finally{r.destroy(),i.destroy?.()}if(o===0)throw new Error("zip \u5185\u6CA1\u6709\u6587\u4EF6\uFF08\u9700\u8981\u5305\u542B plugin.json\uFF09");return{pluginDir:await v(e),fileCount:o}}async function v(t){const r=(await h(t,{withFileTypes:!0})).filter(i=>!i.name.startsWith("."));return r.length===1&&r[0].isDirectory()?u.join(t,r[0].name):t}export{F as extractPluginZip};
+

package/dist/services/skill-manager.d.ts

@@ -0,0 +1,41 @@
+
+export interface DeployedSkillEntry {
+    skillName: string;
+    zipFile: string;
+    fileName: string;
+    defaultEnabled: boolean;
+    sha256?: string;
+}
+export interface DeployedSkillResult {
+    ok: boolean;
+    error?: string;
+    skillName?: string;
+}
+
+export declare function isValidSkillName(name: unknown): name is string;
+export declare class SkillManager {
+    private readonly rootDir;
+    private static _instance;
+    static getInstance(): SkillManager;
+    private constructor();
+    private manifestFile;
+    private skillDir;
+    private isHealthy;
+    private readManifest;
+    private writeManifest;
+    
+    saveSharedSkill(zipBuffer: Buffer, originalName: string, defaultEnabled?: boolean, sha256?: string, requestedSkillName?: string): Promise<DeployedSkillResult>;
+    
+    removeDeployedSkill(skillName: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    
+    listDeployed(): DeployedSkillEntry[];
+    
+    deployedDefaultEnabled(): Record<string, boolean>;
+    
+    private applyToKnownAgents;
+}
+export declare const skillManager: SkillManager;
+export declare const reconcileSkillsDefaultsFromDeployed: () => number;

package/dist/services/skill-manager.js

@@ -0,0 +1,3 @@
+import{promises as g}from"node:fs";import{cpSync as S,existsSync as c,mkdirSync as $,readFileSync as j,readdirSync as A,rmSync as d,writeFileSync as E}from"node:fs";import i from"node:path";import{getAcodeSkillDataHome as I}from"../config.js";import{createLogger as b}from"../utils/logger.js";import{extractSkillZip as x,resolveSkillSourceDirFromExtractRoot as L}from"../utils/file-utils.js";import{getSkillFarmRoot as N,syncAgentSkillFarm as _}from"./agent-capability-sync.js";import{getAgentInitRoot as D}from"./instance-state.js";import{setDeployedDefaultsProvider as K,reconcileDefaultsFromDeployed as z}from"./capability-config.js";const h=b("skill-manager");function F(n){return typeof n=="string"&&n.length>0&&n.length<=128&&/^[a-zA-Z0-9_.-]+$/.test(n)}const O=1;class p{static getInstance(){return this._instance||(this._instance=new p(i.join(I(),"skills","deployed"))),this._instance}constructor(r){this.rootDir=r}manifestFile(){return i.join(this.rootDir,"manifest.json")}skillDir(r){const t=i.join(this.rootDir,r),e=i.resolve(this.rootDir);if(i.resolve(t)!==i.join(e,r))throw new Error(`\u6280\u80FD\u76EE\u5F55\u8D8A\u51FA\u90E8\u7F72\u533A: ${r}`);return t}isHealthy(r){return c(i.join(this.skillDir(r),"SKILL.md"))}readManifest(){try{const r=JSON.parse(j(this.manifestFile(),"utf8"));return Array.isArray(r.skills)?r.skills.filter(t=>t&&t.skillName):[]}catch{return[]}}writeManifest(r){$(this.rootDir,{recursive:!0}),E(this.manifestFile(),`${JSON.stringify({version:O,skills:r},null,2)}
+`,"utf8")}async saveSharedSkill(r,t,e=!0,m,w){if(!r||r.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};const y=i.join(D("_tmp"),`skill-deploy-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{await R(r,y);const o=await L(y),l=i.basename(i.resolve(o)),M=String(t||"").replace(/\.zip$/i,"").trim(),s=w&&w.trim()||(l&&!l.startsWith("skill-deploy-")?l:"")||M;if(!F(s))return{ok:!1,error:`\u6280\u80FD\u540D\u975E\u6CD5: ${JSON.stringify(s)}`};if(!c(i.join(o,"SKILL.md")))return{ok:!1,error:`\u6280\u80FD\u5305\u7F3A\u5C11 SKILL.md: ${t}`};const k=this.readManifest().find(u=>u.skillName===s);if(k&&k.sha256===m&&this.isHealthy(s))return{ok:!0,skillName:s};$(this.rootDir,{recursive:!0});const a=this.skillDir(s),f=i.join(this.rootDir,`.old-${s}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);if(c(a))try{S(a,f,{recursive:!0})}catch{d(a,{recursive:!0,force:!0})}try{S(o,a,{recursive:!0})}catch(u){throw c(f)&&(d(a,{recursive:!0,force:!0}),S(f,a,{recursive:!0})),u}c(f)&&d(f,{recursive:!0,force:!0});const v=this.readManifest().filter(u=>u.skillName!==s);return v.push({skillName:s,zipFile:k?.zipFile??`${s}.zip`,fileName:t,defaultEnabled:e,sha256:m}),this.writeManifest(v),h.info("[shared] \u6280\u80FD\u5DF2\u90E8\u7F72\u5230 bridge: %s\uFF08\u6765\u6E90 %s%s\uFF09",s,t,m?`, sha256=${m.slice(0,12)}\u2026`:""),this.applyToKnownAgents(),{ok:!0,skillName:s}}catch(o){const l=o instanceof Error?o.message:String(o);return h.warn("[shared] \u6280\u80FD\u90E8\u7F72\u5931\u8D25\uFF08%s\uFF09: %s",t,l),{ok:!1,error:`\u6280\u80FD\u90E8\u7F72\u5931\u8D25: ${l}`}}finally{try{d(y,{recursive:!0,force:!0})}catch{}}}async removeDeployedSkill(r){if(!F(r))return{ok:!1,error:"skillName \u975E\u6CD5"};const t=this.readManifest().filter(e=>e.skillName!==r);this.writeManifest(t);try{d(this.skillDir(r),{recursive:!0,force:!0})}catch(e){return{ok:!1,error:`\u90E8\u7F72\u76EE\u5F55\u6E05\u7406\u5931\u8D25: ${e instanceof Error?e.message:String(e)}`}}return this.applyToKnownAgents(),h.info("[shared] \u6280\u80FD\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",r),{ok:!0}}listDeployed(){return this.readManifest().filter(r=>!/^skill-deploy-/.test(r.skillName)).map(r=>({...r,deployed:this.isHealthy(r.skillName)}))}deployedDefaultEnabled(){const r={};for(const t of this.readManifest())/^skill-deploy-/.test(t.skillName)||(r[t.skillName]=t.defaultEnabled);return r}applyToKnownAgents(){const r=new Set;for(const t of[N(),i.dirname(i.resolve(D("_")))])try{if(c(t))for(const e of A(t))e.startsWith(".")||r.add(e)}catch{}for(const t of r)try{_(t)}catch(e){h.warn("[shared] \u540C\u6B65\u6280\u80FD\u519C\u573A\u5931\u8D25 agent=%s: %s",t,e instanceof Error?e.message:String(e))}}}p._instance=null;async function R(n,r){const t=i.join(D("_tmp"),`skill-${Date.now()}-${Math.random().toString(36).slice(2,8)}.zip`);await g.mkdir(i.dirname(t),{recursive:!0}),await g.writeFile(t,n);try{await x(t,r)}finally{await g.rm(t,{force:!0}).catch(()=>{})}}const H=p.getInstance();K("skills",()=>H.deployedDefaultEnabled());const U=()=>z("skills");export{p as SkillManager,F as isValidSkillName,U as reconcileSkillsDefaultsFromDeployed,H as skillManager};
+

package/dist/types.d.ts

@@ -1,19 +1,17 @@
-import type { AppFlags } from '@cc-switch/sdk';
 import type { Request, Response, NextFunction } from 'express';
-export type { McpServerSpec, AppFlags } from '@cc-switch/sdk';
 
 export interface CreateMcpServerInput {
     name: string;
-    server: import('@cc-switch/sdk').McpServerSpec;
+    server: McpServerConfig;
     description?: string;
-    apps?: Partial<AppFlags>;
+    apps?: Partial<SdkApps>;
 }
 
 export interface UpdateMcpServerInput {
     name?: string;
-    server?: import('@cc-switch/sdk').McpServerSpec;
+    server?: McpServerConfig;
     description?: string;
-    apps?: Partial<AppFlags>;
+    apps?: Partial<SdkApps>;
 }
 export interface Session {
     agentId: string;
@@ -29,6 +27,13 @@ export interface SkillPackage {
     sha256?: string;
     skillName?: string;
 }
+
+export interface PluginPackage {
+    downloadUrl?: string;
+    fileName?: string;
+    sha256?: string;
+    pluginName?: string;
+}
 export interface McpPayload {
     id?: string;
     name: string;
@@ -157,18 +162,6 @@ export interface AiSourceApplyPayload {
     codex?: Record<string, unknown> | null;
     opencode?: Record<string, unknown> | null;
 }
-export interface CcSwitchAppPaths {
-    runtimeHome: string;
-    acodeConfigFile: string;
-    acodeSkillsDir: string;
-    claudeConfigFile: string;
-    claudeMcpConfigFile: string;
-    claudeSkillsDir: string;
-    codexConfigFile: string;
-    codexSkillsDir: string;
-    opencodeConfigFile: string;
-    opencodeSkillsDir: string;
-}
 export interface DownloadResult {
     fileName: string;
     outputPath: string;
@@ -179,49 +172,6 @@ export interface CallbackResponse {
     ok: boolean;
     [key: string]: unknown;
 }
-export interface InitResult {
-    ok: boolean;
-    agentId: string;
-    workspacePath: string;
-    initRoot: string;
-    enabledTools: string[];
-    toolStatus?: Record<string, ToolInstallStatus>;
-    logs?: InitLogEntry[];
-    skill: {
-        enabled: boolean;
-        packagePresent: boolean;
-        installedCount?: number;
-        installed?: LegacySkillStateItem[];
-    };
-    mcp: {
-        enabled: boolean;
-        configPath: string | null;
-        installedCount?: number;
-    };
-    adapterResult?: unknown;
-    installed?: {
-        skills: LegacySkillStateItem[];
-        mcpServers: LegacyMcpStateItem[];
-    };
-}
-export interface SyncStateResult {
-    state: InstanceState;
-    configPath: string;
-    skills: LegacySkillStateItem[];
-    mcpServers: LegacyMcpStateItem[];
-}
-export interface AdapterResult {
-    ok: boolean;
-    adapter: string;
-    action: string;
-    agentId: string;
-    payload: unknown;
-    paths: CcSwitchAppPaths;
-    snapshot: {
-        skills: number;
-        mcpServers: number;
-    };
-}
 export interface PersistedSession {
     sessionId: string;
     agentId: string;

package/dist/utils/file-utils.d.ts

@@ -1,16 +1,19 @@
-import type { AppFlags, InstalledSkill, CcSwitchSdk } from '@cc-switch/sdk';
-import type { SkillPackage, DownloadResult, Skill } from '../types.js';
+import type { SkillPackage, PluginPackage, DownloadResult } from '../types.js';
 export declare function ensureDir(targetDir: string): Promise<string>;
 export declare function withFileLock<T>(targetPath: string, operation: () => Promise<T>): Promise<T>;
 export declare function stringifyStableJson(value: unknown): string;
+
+export declare function sanitizeAgentId(agentId: string): string;
+
+export declare function sanitizeArchiveFileName(fileName: string, fallback: string): string;
 export declare function atomicWriteFile(targetPath: string, content: string): Promise<void>;
+
+export declare function atomicWriteFileSync(targetPath: string, content: string): void;
 export declare function atomicWriteJsonFile(targetPath: string, value: unknown): Promise<void>;
 export declare function downloadSkillZip(skillPackage: SkillPackage, targetDir: string): Promise<DownloadResult | null>;
 export declare function runCommand(command: string, args: string[]): Promise<void>;
 export declare function escapePowerShellLiteral(text: string): string;
+
 export declare function extractSkillZip(zipFilePath: string, extractRootDir: string): Promise<void>;
 export declare function resolveSkillSourceDirFromExtractRoot(extractRootDir: string): Promise<string>;
-export declare function toSdkAppsFromEnabledTools(enabledTools: string[]): AppFlags;
-export declare function resolveSkillSourceDir(skill: Skill): string;
-export declare function ensureDirectoryExists(directoryPath: string): Promise<void>;
-export declare function installSkillPackageToSdk(sdk: CcSwitchSdk, skillPackage: SkillPackage, skillDir: string, sdkApps: AppFlags): Promise<InstalledSkill | null>;
+export declare function downloadPluginZip(pluginPackage: PluginPackage, targetDir: string): Promise<DownloadResult | null>;

package/dist/utils/file-utils.js

@@ -1,3 +1,3 @@
-import{spawn as g}from"node:child_process";import{createHash as x,randomUUID as $}from"node:crypto";import{promises as c}from"node:fs";import a from"node:path";import b from"axios";import{schedulerBaseUrl as d}from"../config.js";import{getRuntimeAccessToken as w}from"../services/runtime-binding.js";const p=new Map;async function N(e){return await c.mkdir(e,{recursive:!0}),e}async function W(e,t){const r=a.resolve(e),i=p.get(r)??Promise.resolve();let n;const s=new Promise(l=>{n=l}),o=i.then(()=>s);p.set(r,o),await i;try{return await t()}finally{n(),p.get(r)===o&&p.delete(r)}}function E(e){if(!e||typeof e!="object")return!1;const t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function f(e){return Array.isArray(e)?e.map(t=>f(t)):E(e)?Object.keys(e).sort().reduce((t,r)=>(t[r]=f(e[r]),t),{}):e}function j(e){return`${JSON.stringify(f(e),null,2)}
-`}async function k(e,t){await N(a.dirname(e));const r=a.dirname(e),i=a.basename(e),n=a.join(r,`.${i}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);try{await c.writeFile(n,t,"utf-8"),await c.rename(n,e)}catch(s){throw await c.rm(n,{force:!0}).catch(()=>{}),s}}async function z(e,t){await k(e,j(t))}async function A(e,t){if(!e||!e.downloadUrl)return null;const r=String(e.downloadUrl).trim();if(!r)return null;let i=r;i.startsWith("/")&&(i=`${d}${i}`);const n=e.fileName&&String(e.fileName).trim()?String(e.fileName).trim():"skill-package.zip",s=a.join(t,n),o=w(d)||w();if(!o)throw new Error("runtime access token is required to download skill package");const l=await b.get(i,{responseType:"arraybuffer",headers:{"X-Runtime-Token":o}}),u=Buffer.from(l.data);if(await c.writeFile(s,u),e.sha256&&x("sha256").update(u).digest("hex")!==String(e.sha256).trim().toLowerCase())throw new Error("skill zip checksum mismatch");return{fileName:n,outputPath:s,bytes:u.length}}async function h(e,t){await new Promise((r,i)=>{const n=g(e,t,{stdio:["ignore","pipe","pipe"]});let s="";n.stderr?.on("data",o=>{s+=String(o||"")}),n.on("error",o=>{i(o)}),n.on("close",o=>{if(o!==0){i(new Error(s||`${e} exited with code ${o}`));return}r()})})}function y(e){return String(e||"").replace(/'/g,"''")}async function D(e,t){if(await c.rm(t,{recursive:!0,force:!0}),await c.mkdir(t,{recursive:!0}),process.platform==="win32"){const r=y(e),i=y(t);await h("powershell.exe",["-NoLogo","-NoProfile","-Command",`Expand-Archive -LiteralPath '${r}' -DestinationPath '${i}' -Force`]);return}await h("unzip",["-o",e,"-d",t])}async function F(e){const r=(await c.readdir(e,{withFileTypes:!0})).filter(i=>!i.name.startsWith("."));return r.length===1&&r[0].isDirectory()?a.join(e,r[0].name):e}function B(e){const t=Array.isArray(e)?e:[],r=i=>t.includes(i);return{acode:r("acode"),claude:r("claude"),claudecode:r("claudecode"),codex:r("codex"),gemini:r("gemini"),opencode:r("opencode"),openclaw:r("openclaw")}}function q(e){const t=String(e?.sourceDir||e?.directory||e?.filePath||"").trim();if(!t)throw new Error("skill.sourceDir is required");return a.resolve(t)}async function M(e){if(!(await c.stat(e)).isDirectory())throw new Error(`not a directory: ${e}`)}async function Z(e,t,r,i){const n=await A(t,r);if(!n)return null;const s=a.join(r,`${a.parse(n.fileName).name}-${$()}`);await D(n.outputPath,s);const o=await F(s),l=String(t?.skillName||n.fileName||"").trim()||n.fileName,m=e.getAllSkills().find(S=>String(S?.name||"").trim()===l);return m?e.updateSkill(m.id,{name:l,apps:i}):e.installSkill({sourceDir:o,name:l,apps:i})}export{k as atomicWriteFile,z as atomicWriteJsonFile,A as downloadSkillZip,N as ensureDir,M as ensureDirectoryExists,y as escapePowerShellLiteral,D as extractSkillZip,Z as installSkillPackageToSdk,q as resolveSkillSourceDir,F as resolveSkillSourceDirFromExtractRoot,h as runCommand,j as stringifyStableJson,B as toSdkAppsFromEnabledTools,W as withFileLock};
+import{spawn as E}from"node:child_process";import{createHash as h}from"node:crypto";import{createWriteStream as B,mkdirSync as b,renameSync as z,rmSync as U,writeFileSync as k}from"node:fs";import{promises as c}from"node:fs";import a from"node:path";import{Readable as T,Transform as y}from"node:stream";import{pipeline as v}from"node:stream/promises";import F from"unzipper";import S from"axios";import{DEFAULT_SCHEDULER_BASE_URL as L,schedulerBaseUrl as _}from"../config.js";import{getRuntimeAccessToken as p,loadRuntimeBinding as A}from"../services/runtime-binding.js";const d=new Map;function g(){const e=String(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL||"").trim();if(e)return e;const t=A(),r=String(t.schedulerBaseUrl||"").trim();return t.status==="paired"&&r?r:_||L}async function W(e){return await c.mkdir(e,{recursive:!0}),e}async function Y(e,t){const r=a.resolve(e),n=d.get(r)??Promise.resolve();let i;const o=new Promise(m=>{i=m}),s=n.then(()=>o);d.set(r,s),await n;try{return await t()}finally{i(),d.get(r)===s&&d.delete(r)}}function j(e){if(!e||typeof e!="object")return!1;const t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function w(e){return Array.isArray(e)?e.map(t=>w(t)):j(e)?Object.keys(e).sort().reduce((t,r)=>(t[r]=w(e[r]),t),{}):e}function N(e){return`${JSON.stringify(w(e),null,2)}
+`}function P(e){return String(e??"").replace(/[^a-zA-Z0-9_.-]/g,"_").replace(/^\.+/g,"").slice(0,128)}function x(e,t){const r=String(e??"").trim();if(!r||/[\\/]/.test(r))return t;const n=a.basename(r);return!n||n==="."||n===".."?t:n}async function C(e,t){await W(a.dirname(e));const r=a.dirname(e),n=a.basename(e),i=a.join(r,`.${n}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);try{await c.writeFile(i,t,"utf-8"),await c.rename(i,e)}catch(o){throw await c.rm(i,{force:!0}).catch(()=>{}),o}}function ee(e,t){b(a.dirname(e),{recursive:!0});const r=a.dirname(e),n=a.basename(e),i=a.join(r,`.${n}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`);try{k(i,t,"utf-8"),z(i,e)}catch(o){try{U(i,{force:!0})}catch{}throw o}}async function re(e,t){await C(e,N(t))}async function te(e,t){if(!e||!e.downloadUrl)return null;const r=String(e.downloadUrl).trim();if(!r)return null;const n=g();let i=r;i.startsWith("/")&&(i=`${n}${i}`);const o=x(e.fileName,"skill-package.zip"),s=a.join(t,o),m=p(n)||p();if(!m)throw new Error("runtime access token is required to download skill package");const l=await S.get(i,{responseType:"arraybuffer",timeout:3e4,headers:{"X-Runtime-Token":m}}),u=Buffer.from(l.data);if(await c.writeFile(s,u),e.sha256&&h("sha256").update(u).digest("hex")!==String(e.sha256).trim().toLowerCase())throw new Error("skill zip checksum mismatch");return{fileName:o,outputPath:s,bytes:u.length}}async function ne(e,t){await new Promise((r,n)=>{const i=E(e,t,{stdio:["ignore","pipe","pipe"]});let o="";i.stderr?.on("data",s=>{o+=String(s||"")}),i.on("error",s=>{n(s)}),i.on("close",s=>{if(s!==0){n(new Error(o||`${e} exited with code ${s}`));return}r()})})}function ie(e){return String(e||"").replace(/'/g,"''")}const f={maxEntries:2e3,maxFileBytes:100*1024*1024,maxTotalBytes:200*1024*1024,maxPathLength:400,maxPathDepth:24};function D(e,t){const r=String(t||"").replace(/\\/g,"/");if(!r||r.startsWith("/")||/^[A-Za-z]:/.test(r)||r.split("/").includes(".."))throw new Error(`skill zip \u6761\u76EE\u8DEF\u5F84\u975E\u6CD5: ${t}`);if(r.length>f.maxPathLength)throw new Error(`skill zip \u6761\u76EE\u8DEF\u5F84\u8FC7\u957F: ${t}`);if(r.split("/").filter(Boolean).length>f.maxPathDepth)throw new Error(`skill zip \u6761\u76EE\u8DEF\u5F84\u8FC7\u6DF1: ${t}`);const n=a.resolve(e,r),i=a.resolve(e)+a.sep;if(n!==a.resolve(e)&&!n.startsWith(i))throw new Error(`skill zip \u6761\u76EE\u8D8A\u754C\uFF08zip-slip\uFF09: ${t}`);return n}function I(e,t){let r=0;return new y({transform(n,i,o){if(r+=n.length,r>e){o(new Error(`${t} \u8D85\u51FA\u4E0A\u9650\uFF08${e} \u5B57\u8282\uFF09`));return}o(null,n)}})}function O(e,t){let r=0;return{transform(){return new y({transform(n,i,o){if(r+=n.length,r>e){o(new Error(`${t} \u8D85\u51FA\u603B\u91CF\u4E0A\u9650\uFF08${e} \u5B57\u8282\uFF09`));return}o(null,n)}})}}}async function oe(e,t){await c.rm(t,{recursive:!0,force:!0}),await c.mkdir(t,{recursive:!0});const r=await c.readFile(e),n=T.from([r]),i=n.pipe(F.Parse({forceStream:!0}));let o=0,s=0;const m=O(f.maxTotalBytes,"skill zip \u89E3\u538B\u603B\u91CF");try{for await(const l of i){const u=D(t,l.path);if(l.type==="Directory"){await c.mkdir(u,{recursive:!0}),l.autodrain?.();continue}if(l.type!=="File"){l.autodrain?.();continue}if(o++,o>f.maxEntries)throw new Error(`skill zip \u6761\u76EE\u6570\u8D85\u51FA\u4E0A\u9650\uFF08${f.maxEntries}\uFF09`);if(s+=Number(l.size??0),s>f.maxTotalBytes)throw new Error(`skill zip \u603B\u91CF\u8D85\u51FA\u4E0A\u9650\uFF08${f.maxTotalBytes} \u5B57\u8282\uFF09`);await c.mkdir(a.dirname(u),{recursive:!0}),await v(l,I(f.maxFileBytes,`skill zip \u6761\u76EE ${l.path}`),m.transform(),B(u))}}catch(l){throw await c.rm(t,{recursive:!0,force:!0}).catch(()=>{}),l}finally{n.destroy(),i.destroy?.()}}async function se(e){const r=(await c.readdir(e,{withFileTypes:!0})).filter(n=>!n.name.startsWith("."));return r.length===1&&r[0].isDirectory()?a.join(e,r[0].name):e}async function ae(e,t){if(!e||!e.downloadUrl)return null;const r=String(e.downloadUrl).trim();if(!r)return null;const n=g();let i=r;i.startsWith("/")&&(i=`${n}${i}`);const o=x(e.fileName,"plugin-package.zip"),s=a.join(t,o),m=p(n)||p();if(!m)throw new Error("runtime access token is required to download plugin package");const l=await S.get(i,{responseType:"arraybuffer",timeout:3e4,headers:{"X-Runtime-Token":m}}),u=Buffer.from(l.data);if(await c.writeFile(s,u),e.sha256&&h("sha256").update(u).digest("hex")!==String(e.sha256).trim().toLowerCase())throw new Error(`plugin package sha256 mismatch: ${o}`);return{fileName:o,outputPath:s,bytes:u.length}}export{C as atomicWriteFile,ee as atomicWriteFileSync,re as atomicWriteJsonFile,ae as downloadPluginZip,te as downloadSkillZip,W as ensureDir,ie as escapePowerShellLiteral,oe as extractSkillZip,se as resolveSkillSourceDirFromExtractRoot,ne as runCommand,P as sanitizeAgentId,x as sanitizeArchiveFileName,N as stringifyStableJson,Y as withFileLock};
 

package/dist/utils/mcp-utils.d.ts

@@ -1,38 +1,2 @@
-
-import type { LegacyMcpStateItem, McpPayload, McpServerConfig, SdkApps } from '../types.js';
-import type { McpServerSpec } from '@cc-switch/sdk';
-
-export declare function buildMcpConfigContent(mcpServers: LegacyMcpStateItem[]): string;
-
+import type { McpPayload } from "../types.js";
 export declare function normalizeMcpPayload(payload: unknown): McpPayload | null;
-
-export declare function normalizeSdkAppFlags(rawApps: unknown): SdkApps | undefined;
-
-export declare function normalizeSdkMcpServerSpec(rawMcp: unknown): McpServerSpec;
-
-export interface McpServerFromSdk {
-    id?: string;
-    name?: string;
-    server?: McpServerConfig;
-    apps?: SdkApps;
-}
-
-export declare function toLegacyMcpStateItem(mcpServer: McpServerFromSdk): LegacyMcpStateItem;
-
-export declare function toLegacySkillStateItem(skill: {
-    id?: string;
-    name?: string;
-    directory?: string;
-    sourceDir?: string;
-    filePath?: string;
-    apps?: SdkApps;
-    installedAt?: string | number;
-}): {
-    id: string;
-    name: string;
-    fileName: string;
-    filePath: string;
-    bytes: number;
-    apps?: SdkApps;
-    installedAt: string;
-};

package/dist/utils/mcp-utils.js

@@ -1,2 +1,2 @@
-import s from"node:path";import{randomUUID as c}from"node:crypto";import{parseBoolean as a}from"./validation.js";function u(n){const e=Array.isArray(n)?n:[],o={};for(const t of e){if(!t||!a(t.enabled,!0))continue;const r=String(t.name||"").trim();if(!r)continue;const i={transport:String(t.transport||"stdio").trim().toLowerCase()};t.command!=null&&String(t.command).trim()&&(i.command=String(t.command).trim()),t.url!=null&&String(t.url).trim()&&(i.url=String(t.url).trim()),t.args!=null&&(i.args=Array.isArray(t.args)?t.args:[]),t.env!=null&&typeof t.env=="object"&&(i.env=t.env),o[r]=i}return JSON.stringify({mcpServers:o},null,2)}function g(n){if(!n||typeof n!="object")return null;const e=n,o=String(e.name||"").trim();return o?{id:String(e.id||c()),name:o,transport:String(e.transport||"stdio").trim().toLowerCase(),command:e.command==null?"":String(e.command),url:e.url==null?"":String(e.url),args:Array.isArray(e.args)?e.args.map(t=>String(t)):[],env:e.env&&typeof e.env=="object"?e.env:{},enabled:a(e.enabled,!0),installedAt:e.installedAt||new Date().toISOString()}:null}function f(n){if(!n||typeof n!="object")return;const e=n,o=a(e.claudecode,!1)||a(e.claude,!1);return{acode:a(e.acode,!1),claude:!1,claudecode:o,codex:a(e.codex,!1),gemini:a(e.gemini,!1),opencode:a(e.opencode,!1),openclaw:a(e.openclaw,!1)}}function S(n){const e=n&&typeof n=="object"?n:{},o=e.server&&typeof e.server=="object"?e.server:{},t=String(o.type||e.transport||"stdio").trim().toLowerCase(),r={...o,type:t};return e.command!=null&&String(e.command).trim()&&(r.command=String(e.command).trim()),e.url!=null&&String(e.url).trim()&&(r.url=String(e.url).trim()),e.args!=null&&(r.args=Array.isArray(e.args)?e.args.map(l=>String(l)):[]),e.env!=null&&typeof e.env=="object"&&(r.env=e.env),e.headers!=null&&typeof e.headers=="object"&&(r.headers=e.headers),r}function y(n){const e=n?.server&&typeof n.server=="object"?n.server:{},o=n?.apps&&typeof n.apps=="object"?n.apps:{};return{id:String(n?.id||c()),name:String(n?.name||"").trim(),transport:String(e.type||"stdio").trim().toLowerCase(),command:e.command==null?"":String(e.command),url:e.url==null?"":String(e.url),args:Array.isArray(e.args)?e.args.map(t=>String(t)):[],env:e.env&&typeof e.env=="object"?e.env:{},enabled:!!(o.acode||o.claudecode||o.codex||o.gemini||o.opencode||o.openclaw),apps:{acode:!!o.acode,claude:!1,claudecode:!!o.claudecode,codex:!!o.codex,gemini:!!o.gemini,opencode:!!o.opencode,openclaw:!!o.openclaw},installedAt:new Date().toISOString()}}function v(n){const e=String(n?.directory||n?.sourceDir||n?.filePath||"").trim(),o=n?.apps&&typeof n.apps=="object"?n.apps:{};return{id:String(n?.id||c()),name:String(n?.name||s.basename(e||"skill")).trim(),fileName:e?s.basename(e):"",filePath:e,bytes:0,apps:{acode:!!o.acode,claude:!1,claudecode:!!o.claudecode,codex:!!o.codex,gemini:!!o.gemini,opencode:!!o.opencode,openclaw:!!o.openclaw},installedAt:n?.installedAt?new Date(n.installedAt).toISOString():new Date().toISOString()}}export{u as buildMcpConfigContent,g as normalizeMcpPayload,f as normalizeSdkAppFlags,S as normalizeSdkMcpServerSpec,y as toLegacyMcpStateItem,v as toLegacySkillStateItem};
+import{randomUUID as o}from"node:crypto";import{parseBoolean as a}from"./validation.js";function m(n){if(!n||typeof n!="object")return null;const r=n,t=String(r.name||"").trim();return t?{id:String(r.id||o()),name:t,transport:String(r.transport||"stdio").trim().toLowerCase(),command:r.command==null?"":String(r.command),url:r.url==null?"":String(r.url),args:Array.isArray(r.args)?r.args.map(e=>String(e)):[],env:r.env&&typeof r.env=="object"?r.env:{},enabled:a(r.enabled,!0),installedAt:r.installedAt||new Date().toISOString()}:null}export{m as normalizeMcpPayload};
 

package/package/acode/dist/built-in-file-tools.js

@@ -1,4 +1,4 @@
-import{randomUUID as nt}from"node:crypto";import{promises as m,createReadStream as G}from"node:fs";import it from"node:os";import d from"node:path";import X from"node:readline";import{runShellCommand as at}from"./builtins/shellCommandRunner.js";import{createOutputEventCollector as rt}from"./builtins/commandOutputEvents.js";import{symbolsTool as st}from"./built-in-symbols-tool.js";import{createListBackgroundCommandsTool as ct,createKillBackgroundCommandTool as lt,createReadBackgroundOutputTool as ut}from"./background-command-tools.js";import{detectImageFormatFromBuffer as dt,formatBytes as T,imageMediaType as Y,readImageDimensions as pt,tryResizeWithSharp as ht}from"./image-utils.js";const ft=2e3,O=2e3,mt=50*1024,H=4096,wt=.3,gt=new Set([".png",".jpg",".jpeg",".gif",".bmp",".ico",".webp",".tiff",".tif",".zip",".gz",".tar",".rar",".7z",".bz2",".xz",".lz",".exe",".dll",".so",".dylib",".bin",".o",".a",".pdf",".doc",".docx",".xls",".xlsx",".ppt",".pptx",".mp3",".mp4",".avi",".mov",".wav",".flv",".mkv",".ogg",".woff",".woff2",".ttf",".otf",".eot",".class",".jar",".war",".ear",".pyc",".pyo",".node",".sqlite",".db",".mdb",".wasm"]),_t=new Set(["png","jpg","jpeg","gif","webp"]),K=20*1024*1024,L=10*1024*1024,U=Math.floor(3.75*1024*1024),C=2e3,yt=15e3,bt=1e3,kt=1024*1024,Pt=256*1024,Et=1e3,vt=new Set([".git","node_modules","dist","build",".next",".nuxt",".cache",".turbo",".output","coverage",".nyc_output"]),te={fileReadOutside:"allow",commandExecution:"allow",fileModification:"allow"};async function F(n,o,e){if(!n)return;const t=n.getLevel(o);if(t==="deny")throw new Error(`Operation blocked by tool permission policy (${o} = deny). Explain this restriction to the user if needed.`);if(t==="ask"&&!await n.requestPermission(o,e))throw new Error(`Operation denied by the user (${o}). Do not retry the same operation without asking the user.`)}function v(n){return n.replace(/\\/g,"/")}async function V(n){try{return await m.access(n),!0}catch{return!1}}function xt(n,o){if(!o)return 0;let e=0,t=n.indexOf(o);for(;t>=0;)e+=1,t=n.indexOf(o,t+o.length);return e}function $(n,o,e){for(const t of o){const i=n[t];if(typeof i=="string")return i}throw new Error(`${e} is required`)}function I(n,o){for(const e of o){const t=n[e];if(typeof t=="string"&&t.trim())return t}}function B(n,o,e){for(const t of o){const i=n[t],s=typeof i=="number"?i:typeof i=="string"?Number(i):NaN;if(Number.isFinite(s)&&s>0)return Math.floor(s)}return e}async function Z(n){const o=d.extname(n).toLowerCase();if(gt.has(o))return!0;const e=await m.open(n,"r");try{const t=Buffer.alloc(H),{bytesRead:i}=await e.read(t,0,H,0);if(i===0)return!1;const s=t.subarray(0,i);if(s.includes(0))return!0;let r=0;for(let a=0;a<i;a++){const c=s[a];(c<9||c>13&&c<32)&&r++}return r/i>wt}finally{await e.close()}}function M(n,o){const e=d.resolve(o),t=d.relative(n,e);if(t.startsWith("..")||d.isAbsolute(t))throw new Error(`Target path is outside workspace: ${e}`);return e}function D(n){return n==="~"||n.startsWith("~/")?d.join(it.homedir(),n.slice(1)):n}async function Tt(n,o){const e=d.resolve(String(n||"").trim()),t=await m.realpath(e);if(!(await m.stat(t)).isDirectory())throw new Error(`Workspace path is not a directory: ${e}`);if(!o?.trim())return{workspaceRoot:t,cwd:t};const s=D(o.trim()),r=d.isAbsolute(s)?d.resolve(s):d.resolve(e,s),a=d.relative(e,r);if(a.startsWith("..")||d.isAbsolute(a))throw new Error(`Command cwd is outside workspace: ${r}`);const c=M(t,await m.realpath(r));if(!(await m.stat(c)).isDirectory())throw new Error(`Command cwd is not a directory: ${c}`);return{workspaceRoot:t,cwd:c}}async function Rt(n,o){const e=await m.realpath(d.dirname(o));M(n,e);try{if((await m.lstat(o)).isSymbolicLink())throw new Error(`Refusing to write through symbolic link: ${o}`)}catch(t){if((typeof t=="object"&&t!==null?Reflect.get(t,"code"):void 0)!=="ENOENT")throw t}}async function A(n,o){const e=d.resolve(String(n||"").trim()),t=await m.realpath(e);if(!(await m.stat(t)).isDirectory())throw new Error(`Workspace path is not a directory: ${e}`);const s=D(o.trim());if(!s)throw new Error("file_path is required");const r=d.isAbsolute(s)?d.resolve(s):d.resolve(e,s),a=d.relative(e,r);if(a.startsWith("..")||d.isAbsolute(a))throw new Error(`Target path is outside workspace: ${r}`);return{workspaceRoot:t,requestedPath:r,targetPath:M(t,d.join(t,a))}}async function J(n,o,e){const t=d.resolve(String(n||"").trim()),i=await m.realpath(t);if(!(await m.stat(i)).isDirectory())throw new Error(`Workspace path is not a directory: ${t}`);const r=D(o.trim());if(!r)throw new Error("file_path is required");const a=d.isAbsolute(r)?d.resolve(r):d.resolve(t,r),c=d.relative(t,a),u=await m.realpath(a).catch(()=>a),l=d.relative(i,u);if(c.startsWith("..")||d.isAbsolute(c)||l.startsWith("..")||d.isAbsolute(l)){if(!e)throw new Error(`Target path is outside workspace: ${a}`);return await F(e,"fileReadOutside",{path:a}),{workspaceRoot:i,requestedPath:a,targetPath:u}}return{workspaceRoot:i,requestedPath:a,targetPath:M(i,u)}}async function Q(n,o,e){const t=await A(n,o),i=d.dirname(t.targetPath),s=!await V(i);await m.mkdir(i,{recursive:!0}),await Rt(t.workspaceRoot,t.targetPath);const r=d.join(i,`.${d.basename(t.targetPath)}.${process.pid}.${nt()}.tmp`);try{await m.writeFile(r,e,"utf-8"),await m.rename(r,t.targetPath)}catch(a){throw await m.rm(r,{force:!0}),a}return{workspaceRoot:t.workspaceRoot,targetPath:t.targetPath,bytes:Buffer.byteLength(e,"utf-8"),createdParentDirectory:s}}async function $t(n,o){const e=await A(n,o),t=M(e.workspaceRoot,await m.realpath(e.targetPath));if(!(await m.stat(t)).isFile())throw new Error(`Path is not a file: ${t}`);return{workspaceRoot:e.workspaceRoot,targetPath:t,content:await m.readFile(t,"utf-8")}}async function St(n,o,e,t,i){const s=await J(n,o,i),r=s.targetPath;if(!(await m.stat(r)).isFile())throw new Error(`Path is not a file: ${r}`);if(await Z(r))return{workspaceRoot:s.workspaceRoot,targetPath:r,content:"[Binary file, content skipped]",isBinary:!0,truncated:!1,totalLines:0,shownFromLine:0,shownToLine:0};const c=G(r,{encoding:"utf-8"}),u=X.createInterface({input:c,crlfDelay:1/0});try{const l=[];let w=0,h=0,g=0,p=!1,P=!1;const f=e-1;for await(const _ of u){if(h++,w<f){w++;continue}if(l.length>=t){p=!0,w++;continue}let R=_;R.length>O&&(R=R.slice(0,O)+`... (line truncated to ${O} chars)`);const S=`${w+1}: ${R}`,x=Buffer.byteLength(S,"utf-8")+1;if(g+x>mt){P=!0;break}l.push(S),g+=x,w++}if(h>0&&l.length===0&&!p&&!P&&f>=h)throw new Error(`offset ${e} exceeds total line count ${h} in file: ${r}`);const y=l.length>0?e:0,E=l.length>0?e+l.length-1:0;let b;P?b=`Output capped at 50 KB. Showing lines ${y}-${E}. Use offset=${E+1} to continue.`:p?b=`Showing lines ${y}-${E} of ${h}. Use offset=${E+1} to continue.`:b=`End of file - total ${h} lines`;const k=l.length>0?l.join(`
+import{randomUUID as nt}from"node:crypto";import{promises as m,createReadStream as G}from"node:fs";import it from"node:os";import d from"node:path";import X from"node:readline";import{runShellCommand as at}from"./builtins/shellCommandRunner.js";import{createOutputEventCollector as rt}from"./builtins/commandOutputEvents.js";import{symbolsTool as st}from"./built-in-symbols-tool.js";import{createListBackgroundCommandsTool as ct,createKillBackgroundCommandTool as lt,createReadBackgroundOutputTool as ut}from"./background-command-tools.js";import{detectImageFormatFromBuffer as dt,formatBytes as x,imageMediaType as Y,readImageDimensions as ht,tryResizeWithSharp as pt}from"./image-utils.js";const ft=2e3,O=2e3,mt=50*1024,H=4096,wt=.3,gt=new Set([".png",".jpg",".jpeg",".gif",".bmp",".ico",".webp",".tiff",".tif",".zip",".gz",".tar",".rar",".7z",".bz2",".xz",".lz",".exe",".dll",".so",".dylib",".bin",".o",".a",".pdf",".doc",".docx",".xls",".xlsx",".ppt",".pptx",".mp3",".mp4",".avi",".mov",".wav",".flv",".mkv",".ogg",".woff",".woff2",".ttf",".otf",".eot",".class",".jar",".war",".ear",".pyc",".pyo",".node",".sqlite",".db",".mdb",".wasm"]),_t=new Set(["png","jpg","jpeg","gif","webp"]),K=20*1024*1024,L=10*1024*1024,U=Math.floor(3.75*1024*1024),C=2e3,yt=15e3,bt=1e3,kt=1024*1024,Et=256*1024,Pt=1e3,vt=new Set([".git","node_modules","dist","build",".next",".nuxt",".cache",".turbo",".output","coverage",".nyc_output"]),te={fileReadOutside:"allow",commandExecution:"allow",fileModification:"allow"};async function F(n,o,e){if(!n)return;const t=n.getLevel(o);if(t==="deny")throw new Error(`Operation blocked by tool permission policy (${o} = deny). Explain this restriction to the user if needed.`);if(t==="ask"&&!await n.requestPermission(o,e))throw new Error(`Operation denied by the user (${o}). Do not retry the same operation without asking the user.`)}function $(n){return n.replace(/\\/g,"/")}async function V(n){try{return await m.access(n),!0}catch{return!1}}function xt(n,o){if(!o)return 0;let e=0,t=n.indexOf(o);for(;t>=0;)e+=1,t=n.indexOf(o,t+o.length);return e}function R(n,o,e){for(const t of o){const i=n[t];if(typeof i=="string")return i}throw new Error(`${e} is required`)}function I(n,o){for(const e of o){const t=n[e];if(typeof t=="string"&&t.trim())return t}}function B(n,o,e){for(const t of o){const i=n[t],s=typeof i=="number"?i:typeof i=="string"?Number(i):NaN;if(Number.isFinite(s)&&s>0)return Math.floor(s)}return e}async function Z(n){const o=d.extname(n).toLowerCase();if(gt.has(o))return!0;const e=await m.open(n,"r");try{const t=Buffer.alloc(H),{bytesRead:i}=await e.read(t,0,H,0);if(i===0)return!1;const s=t.subarray(0,i);if(s.includes(0))return!0;let a=0;for(let r=0;r<i;r++){const c=s[r];(c<9||c>13&&c<32)&&a++}return a/i>wt}finally{await e.close()}}function M(n,o){const e=d.resolve(o),t=d.relative(n,e);if(t.startsWith("..")||d.isAbsolute(t))throw new Error(`Target path is outside workspace: ${e}`);return e}function D(n){return n==="~"||n.startsWith("~/")?d.join(it.homedir(),n.slice(1)):n}async function Tt(n,o){const e=d.resolve(String(n||"").trim()),t=await m.realpath(e);if(!(await m.stat(t)).isDirectory())throw new Error(`Workspace path is not a directory: ${e}`);if(!o?.trim())return{workspaceRoot:t,cwd:t};const s=D(o.trim()),a=d.isAbsolute(s)?d.resolve(s):d.resolve(e,s),r=d.relative(e,a);if(r.startsWith("..")||d.isAbsolute(r))throw new Error(`Command cwd is outside workspace: ${a}`);const c=M(t,await m.realpath(a));if(!(await m.stat(c)).isDirectory())throw new Error(`Command cwd is not a directory: ${c}`);return{workspaceRoot:t,cwd:c}}async function $t(n,o){const e=await m.realpath(d.dirname(o));M(n,e);try{if((await m.lstat(o)).isSymbolicLink())throw new Error(`Refusing to write through symbolic link: ${o}`)}catch(t){if((typeof t=="object"&&t!==null?Reflect.get(t,"code"):void 0)!=="ENOENT")throw t}}async function A(n,o){const e=d.resolve(String(n||"").trim()),t=await m.realpath(e);if(!(await m.stat(t)).isDirectory())throw new Error(`Workspace path is not a directory: ${e}`);const s=D(o.trim());if(!s)throw new Error("file_path is required");const a=d.isAbsolute(s)?d.resolve(s):d.resolve(e,s),r=d.relative(e,a);if(r.startsWith("..")||d.isAbsolute(r))throw new Error(`Target path is outside workspace: ${a}`);return{workspaceRoot:t,requestedPath:a,targetPath:M(t,d.join(t,r))}}async function J(n,o,e){const t=d.resolve(String(n||"").trim()),i=await m.realpath(t);if(!(await m.stat(i)).isDirectory())throw new Error(`Workspace path is not a directory: ${t}`);const a=D(o.trim());if(!a)throw new Error("file_path is required");const r=d.isAbsolute(a)?d.resolve(a):d.resolve(t,a),c=d.relative(t,r),u=await m.realpath(r).catch(()=>r),l=d.relative(i,u);if(c.startsWith("..")||d.isAbsolute(c)||l.startsWith("..")||d.isAbsolute(l)){if(!e)throw new Error(`Target path is outside workspace: ${r}`);return await F(e,"fileReadOutside",{path:r}),{workspaceRoot:i,requestedPath:r,targetPath:u}}return{workspaceRoot:i,requestedPath:r,targetPath:M(i,u)}}async function Q(n,o,e){const t=await A(n,o),i=d.dirname(t.targetPath),s=!await V(i);await m.mkdir(i,{recursive:!0}),await $t(t.workspaceRoot,t.targetPath);const a=d.join(i,`.${d.basename(t.targetPath)}.${process.pid}.${nt()}.tmp`);try{await m.writeFile(a,e,"utf-8"),await m.rename(a,t.targetPath)}catch(r){throw await m.rm(a,{force:!0}),r}return{workspaceRoot:t.workspaceRoot,targetPath:t.targetPath,bytes:Buffer.byteLength(e,"utf-8"),createdParentDirectory:s}}async function Rt(n,o){const e=await A(n,o),t=M(e.workspaceRoot,await m.realpath(e.targetPath));if(!(await m.stat(t)).isFile())throw new Error(`Path is not a file: ${t}`);return{workspaceRoot:e.workspaceRoot,targetPath:t,content:await m.readFile(t,"utf-8")}}async function St(n,o,e,t,i){const s=await J(n,o,i),a=s.targetPath;if(!(await m.stat(a)).isFile())throw new Error(`Path is not a file: ${a}`);if(await Z(a))return{workspaceRoot:s.workspaceRoot,targetPath:a,content:"[Binary file, content skipped]",isBinary:!0,truncated:!1,totalLines:0,shownFromLine:0,shownToLine:0};const c=G(a,{encoding:"utf-8"}),u=X.createInterface({input:c,crlfDelay:1/0});try{const l=[];let w=0,p=0,_=0,h=!1,k=!1;const f=e-1;for await(const g of u){if(p++,w<f){w++;continue}if(l.length>=t){h=!0,w++;continue}let T=g;T.length>O&&(T=T.slice(0,O)+`... (line truncated to ${O} chars)`);const S=`${w+1}: ${T}`,v=Buffer.byteLength(S,"utf-8")+1;if(_+v>mt){k=!0;break}l.push(S),_+=v,w++}if(p>0&&l.length===0&&!h&&!k&&f>=p)throw new Error(`offset ${e} exceeds total line count ${p} in file: ${a}`);const y=l.length>0?e:0,b=l.length>0?e+l.length-1:0;let E;k?E=`Output capped at 50 KB. Showing lines ${y}-${b}. Use offset=${b+1} to continue.`:h?E=`Showing lines ${y}-${b} of ${p}. Use offset=${b+1} to continue.`:E=`End of file - total ${p} lines`;const P=l.length>0?l.join(`
 `)+`
-`+b:b;return{workspaceRoot:s.workspaceRoot,targetPath:r,content:k,isBinary:!1,truncated:p||P,totalLines:P?-1:h,shownFromLine:y,shownToLine:E}}finally{u.close(),c.destroy()}}function W(n){return/^https?:\/\//i.test(n)}async function It(n){let o;try{o=new URL(n)}catch{throw new Error(`Invalid image URL: ${n}`)}if(o.protocol!=="http:"&&o.protocol!=="https:")throw new Error(`Unsupported image URL protocol: ${o.protocol} (only http/https)`);let e;try{e=await fetch(n,{signal:AbortSignal.timeout(yt)})}catch(u){const l=u instanceof Error?u.message:String(u);throw new Error(`Image URL fetch failed: ${n} (${l})`)}if(!e.ok)throw new Error(`Image URL fetch failed: ${n} (HTTP ${e.status})`);const t=(e.headers.get("content-type")||"").split(";")[0]?.trim().toLowerCase()||"";if(t&&!t.startsWith("image/"))throw new Error(`URL did not return an image (content-type: ${t}): ${n}`);const i=Number(e.headers.get("content-length")||"");if(Number.isFinite(i)&&i>L)throw new Error(`Image too large to fetch: ${n} (${T(i)} > ${T(L)})`);const s=e.body;if(!s){const u=await e.arrayBuffer();if(u.byteLength>L)throw new Error(`Image too large to fetch: ${n} (${T(u.byteLength)} > ${T(L)})`);return Buffer.from(u)}const r=s.getReader(),a=[];let c=0;for(;;){const{done:u,value:l}=await r.read();if(u)break;if(l){if(c+=l.byteLength,c>L)throw r.cancel().catch(()=>{}),new Error(`Image too large to fetch: ${n} (${T(c)} > ${T(L)})`);a.push(Buffer.from(l))}}return Buffer.concat(a,c)}async function Mt(n,o,e){let t,i,s;if(W(o))t=await It(o),i=o;else{const E=await J(n,o,e),b=E.targetPath,k=await m.stat(b);if(!k.isFile())throw new Error(`Path is not a file: ${b}`);if(k.size>K)throw new Error(`Image file too large to read: ${v(b)} (${T(k.size)} > ${T(K)}). Downscale it first.`);t=await m.readFile(b),i=v(b),s=v(E.workspaceRoot)}if(t.length===0)throw new Error(`Image file is empty: ${i}`);const r=dt(t);if(!r)throw new Error(`Unsupported or corrupt image (unrecognized format): ${i}`);const a=pt(t);let c=r,u=t,l=a?.width,w=a?.height,h=!1;const g=await ht(t,r,{maxWidth:C,maxHeight:C,maxBytes:U});if(g)u=g.buffer,c=g.mediaType,l=g.width,w=g.height,h=g.changed;else if(t.length>U)throw new Error(`Image too large to inline: ${i} (${T(t.length)} > ${T(U)}). Downscale it first, e.g. via Bash: magick "${o}" -resize ${C}x${C} "${o}". Installing sharp enables automatic downscaling.`);const p=l&&w?`${l}x${w}`:"unknown dimensions",P=h&&a&&a.width!==l?` (resized from ${a.width}x${a.height})`:h?" (resized)":"",f=`[Image: ${i}, ${p}${P}, ${T(u.length)}]`,y=W(o)?d.basename(new URL(o).pathname)||"image":d.basename(i);return{ok:!0,tool:"read_file",...s!==void 0?{workspacePath:s}:{},filePath:i,content:f,isBinary:!1,image:{mediaType:Y(c),width:l??null,height:w??null,originalWidth:a?.width??null,originalHeight:a?.height??null,resized:h,size:u.length},attachments:[{type:"image",name:y,mediaType:Y(c),base64Data:u.toString("base64")}]}}function tt(n){let o="",e=0;for(;e<n.length;){const t=n[e];if(t==="*")o+="[^/]*";else if(t==="?")o+="[^/]";else if(t==="{"){const i=n.indexOf("}",e);if(i>=0){const s=n.slice(e+1,i);o+=`(${s.split(",").join("|")})`,e=i}else o+="\\{"}else if(t==="["){const i=n.indexOf("]",e);i>=0?(o+=n.slice(e,i+1),e=i):o+="\\["}else"+^$.()|\\".includes(t)?o+="\\"+t:o+=t;e++}return new RegExp(`^${o}$`)}async function Ot(n,o,e,t){const i=[];async function s(r){if(i.length>=t)return;const a=await m.readdir(r,{withFileTypes:!0});for(const c of a){if(i.length>=t)return;if(c.name.startsWith(".")&&c.isDirectory())continue;const u=d.join(r,c.name);if(c.isDirectory()){if(vt.has(c.name))continue;await s(u)}else if(c.isFile()){if(o&&!o.test(c.name)||e&&e.test(c.name))continue;i.push(u)}}}return await s(n),i}async function Lt(n,o,e){if((await m.stat(n)).size>kt)return{matches:[],count:0};if(await Z(n))return{matches:[],count:0};const i=d.relative(o,n).replace(/\\/g,"/"),s=[];let r=0;const a=G(n,{encoding:"utf-8"}),c=X.createInterface({input:a,crlfDelay:1/0});try{let u=0;for await(const l of c)if(u++,e.regex.test(l)){if(r++,e.collectContent){let w=l;if(w.length>O&&(w=w.slice(0,O)+`... (line truncated to ${O} chars)`),s.push({file:i,line:u,content:w}),s.length>=e.maxResults)break}if(e.stopOnFirstMatch)break}}finally{c.close(),a.destroy()}return{matches:s,count:r}}const et=10*6e4,At=et,Ft=6e4,Bt=10*6e4;function Nt(n,o,e){return{kind:"builtin",toolName:"write_file",exposedName:"write_file",description:"Create or overwrite a UTF-8 text file inside the current workspace. Parent directories are created automatically.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to write."},content:{type:"string",description:"Complete UTF-8 file content."},reason:{type:"string",description:"Optional reason for this change, e.g. what bug is being fixed. Helps humans understand the change later."}},required:["file_path","content"],additionalProperties:!1},async execute(t){const i=$(t,["file_path","filePath"],"file_path"),s=$(t,["content"],"content"),r=I(t,["reason"]),a=await A(n,i);await F(e,"fileModification",{operation:"write",path:a.targetPath});const c=await V(a.targetPath),u=c?await m.readFile(a.targetPath,"utf-8").catch(()=>null):null,l=await Q(n,i,s);if(o){const w=d.relative(l.workspaceRoot,l.targetPath).replace(/\\/g,"/");await o({filePath:w,operation:c?"UPDATE":"CREATE",beforeContent:u,afterContent:s,reason:r})}return{ok:!0,tool:"write_file",workspacePath:v(l.workspaceRoot),filePath:v(l.targetPath),bytes:l.bytes,createdParentDirectory:l.createdParentDirectory}}}}function Ct(n,o,e){return{kind:"builtin",toolName:"edit_file",exposedName:"edit_file",description:"Replace exactly one occurrence of old_string with new_string in a UTF-8 workspace text file.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to edit."},old_string:{type:"string",description:"Existing text to replace. Must occur exactly once."},new_string:{type:"string",description:"Replacement text."},reason:{type:"string",description:"Optional reason for this change, e.g. what bug is being fixed. Helps humans understand the change later."}},required:["file_path","old_string","new_string"],additionalProperties:!1},async execute(t){const i=$(t,["file_path","filePath"],"file_path"),s=$(t,["old_string","oldString"],"old_string"),r=$(t,["new_string","newString"],"new_string"),a=I(t,["reason"]);if(!s)throw new Error("old_string must not be empty");const c=await A(n,i);await F(e,"fileModification",{operation:"edit",path:c.targetPath});const u=await $t(n,i),l=xt(u.content,s);if(l===0)throw new Error("old_string was not found in file");if(l>1)throw new Error(`old_string occurs ${l} times; provide a unique match`);const w=u.content.replace(s,r),h=await Q(n,i,w);if(o){const g=d.relative(h.workspaceRoot,h.targetPath).replace(/\\/g,"/");await o({filePath:g,operation:"UPDATE",beforeContent:u.content,afterContent:w,reason:a})}return{ok:!0,tool:"edit_file",workspacePath:v(h.workspaceRoot),filePath:v(h.targetPath),replacements:1,bytes:h.bytes}}}}function Ut(n,o,e){return{kind:"builtin",toolName:"delete_file",exposedName:"delete_file",description:"Delete a file inside the current workspace. Returns an error if the file does not exist.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to delete."},reason:{type:"string",description:"Optional reason for this change, e.g. what bug is being fixed. Helps humans understand the change later."}},required:["file_path"],additionalProperties:!1},async execute(t){const i=$(t,["file_path","filePath"],"file_path"),s=I(t,["reason"]),r=await A(n,i);await F(e,"fileModification",{operation:"delete",path:r.targetPath});const a=M(r.workspaceRoot,await m.realpath(r.targetPath).catch(()=>r.targetPath)),c=await m.stat(a).catch(()=>null);if(!c)throw new Error(`File does not exist: ${a}`);if(!c.isFile())throw new Error(`Path is not a file: ${a}`);const u=await m.readFile(a,"utf-8").catch(()=>null);if(await m.rm(a,{force:!0}),o){const l=d.relative(r.workspaceRoot,a).replace(/\\/g,"/");await o({filePath:l,operation:"DELETE",beforeContent:u,afterContent:null,reason:s})}return{ok:!0,tool:"delete_file",workspacePath:v(r.workspaceRoot),filePath:v(a),deleted:!0}}}}function Dt(n,o){return{kind:"builtin",toolName:"read_file",exposedName:"read_file",description:"Read a UTF-8 text file inside the current workspace. Returns content with line numbers in the format '<line>: <content>'. Supports offset (1-indexed line number to start from) and limit (max lines to return, default 2000). Output is capped at 2000 lines or 50 KB, whichever is reached first. Individual lines longer than 2000 characters are truncated. Avoid tiny repeated slices (e.g. 30-line chunks); read a larger window if more context is needed. Images (.png/.jpg/.jpeg/.gif/.webp) and http(s) image URLs are also supported: the image is inlined into the conversation so you can see it (requires a model with image input). offset/limit are ignored for images; oversized images are automatically downscaled when sharp is available.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to read. Also accepts an http(s) URL pointing to an image."},offset:{type:"number",description:"Line number to start reading from (1-indexed). Defaults to 1."},limit:{type:"number",description:"Maximum number of lines to return. Defaults to 2000."}},required:["file_path"],additionalProperties:!1},async execute(e){const t=$(e,["file_path","filePath"],"file_path"),i=d.extname(t).toLowerCase().slice(1);if(W(t)||_t.has(i))return await Mt(n,t,o);const s=B(e,["offset"],1),r=B(e,["limit"],ft),a=await St(n,t,s,r,o);return{ok:!0,tool:"read_file",workspacePath:v(a.workspaceRoot),filePath:v(a.targetPath),content:a.content,isBinary:a.isBinary,truncated:a.truncated,totalLines:a.totalLines,shownFromLine:a.shownFromLine,shownToLine:a.shownToLine}}}}function Wt(n,o,e,t){return{kind:"builtin",toolName:"Bash",exposedName:"Bash",description:"Execute a shell command in the current workspace. Use for local diagnostics, builds, tests, and OS commands. The command runs with a bounded timeout and returns stdout, stderr, exit code, and (if interrupted) partial output. By default (wait_seconds omitted or -1) the command runs in the FOREGROUND and streams output in real time; if the 5-minute adapter watchdog fires while it is still running, the command is interrupted and the partial output produced so far is returned (large output is spilled to a file via outputFilePath to avoid context overflow), with watchdogInterrupted=true. For long-running commands use wait_seconds=0 or n>0 to run in the BACKGROUND, then manage them via list_background_commands / read_background_output / kill_background_command / await_complete.",inputSchema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute."},cwd:{type:"string",description:"Optional workspace-relative working directory. Defaults to the workspace root."},timeout_ms:{type:"number",description:"Optional timeout in milliseconds. Defaults to 600000 and is capped at 600000."},inactivity_timeout_ms:{type:"number",description:"Optional no-output timeout in milliseconds. Defaults to 60000 and is capped at 600000."},wait_seconds:{type:"number",description:"How to wait for the command to finish. Omitted values (or -1, the default): run in the FOREGROUND until completion; if the 5-minute adapter watchdog fires first, the command is interrupted and only the partial output already produced is returned (watchdogInterrupted=true; large output spills to outputFilePath). 0: spawn and immediately execute in the background, return task_id. n>0: wait up to n seconds; if still running, move to the background and return task_id. Background commands remain subject to timeout_ms (total upper bound); inactivity_timeout_ms is ignored once backgrounded.",minimum:-1},description:{type:"string",description:"Optional short reason for running the command."}},required:["command"],additionalProperties:!1},async execute(i,s){const r=$(i,["command"],"command").trim();if(!r)throw new Error("command must not be empty");const a=B(i,["timeout_ms","timeoutMs"],At),c=Math.min(a,et),u=B(i,["inactivity_timeout_ms","inactivityTimeoutMs"],Ft),l=Math.min(u,Bt),w=I(i,["cwd"]),h=await Tt(n,w);await F(t,"commandExecution",{command:r,cwd:v(h.cwd)});const g=i.wait_seconds,P=typeof g=="number"&&Number.isFinite(g)?g:-1;if(P!==-1&&e)return await qt({deps:e,command:r,agentId:o,workspaceRoot:h.workspaceRoot,cwd:h.cwd,timeoutMs:c,inactivityTimeoutMs:l,waitSeconds:P,onOutput:s?.onOutput,settleSignal:s?.settleSignal});const f=await at({commandText:r,agentId:o,workspaceRoot:h.workspaceRoot,cwd:h.cwd,timeoutMs:c,inactivityTimeoutMs:l,onOutput:s?.onOutput,watchdogSignal:s?.settleSignal}),y={ok:f.exitCode===0&&!f.timedOut,tool:"Bash",command:r,cwd:v(h.cwd),exitCode:f.exitCode,signal:f.signal,timedOut:f.timedOut,inactivityTimedOut:f.inactivityTimedOut,watchdogInterrupted:f.watchdogInterrupted,timeoutMs:c,inactivityTimeoutMs:l,durationMs:f.durationMs,outputSpilled:f.outputSpilled,outputFilePath:f.outputFilePath,outputLineCount:f.outputLineCount,commandFilePath:f.commandFilePath,commandLineCount:f.commandLineCount,stdout:f.stdout,stderr:f.stderr};return f.watchdogInterrupted?{...y,message:"Command was interrupted by the adapter watchdog after ~5 minutes of synchronous (foreground) execution. Only the partial output produced so far is returned above"+(f.outputFilePath?` (full output spilled to "${f.outputFilePath}"; read it if you need more)`:"")+". For long-running commands, re-run with wait_seconds=0 (or n>0) to execute in the background, then manage via await_complete / list_background_commands / read_background_output / kill_background_command."}:y}}}async function qt(n){const{deps:o,command:e,agentId:t,workspaceRoot:i,cwd:s,timeoutMs:r,inactivityTimeoutMs:a,waitSeconds:c,onOutput:u,settleSignal:l}=n,w=u?rt({cwd:s,commandLineCount:0,onOutput:u}):void 0;let h=!!w;const g=()=>{h&&(h=!1,w?.close())};try{const{taskId:p,completion:P}=o.manager.startCommand({commandText:e,agentId:t,workspaceRoot:i,cwd:s,timeoutMs:r,inactivityTimeoutMs:a,onOutput:h?k=>{h&&w?.push(k.stream,k.text)}:void 0,onCompleted:o.emitCompleted});if(c===0)return o.manager.disableInactivityTimeout(t,p),g(),{ok:!0,tool:"Bash",command:e,backgrounded:!0,taskId:p,status:"backgrounded",reason:"immediate",message:`Command moved to background. Use await_complete(bg_cmd_ids=["${p}"]) to block until it finishes, read_background_output(task_id="${p}", mode="tail") to read output, list_background_commands to view all, or kill_background_command(task_id="${p}") to stop.`};const f=c===-1?0:Math.max(0,Math.floor(c*1e3));let y,E;c===-1?E=Promise.resolve("__never__"):E=new Promise(k=>{y=setTimeout(()=>k("__timeout__"),f),y.unref?.()});const b=l?l.then(()=>"__settle__"):Promise.resolve("__never__");try{const k=await Promise.race([P,E,b]);if(k==="__settle__")return o.manager.disableInactivityTimeout(t,p),{ok:!0,tool:"Bash",command:e,backgrounded:!0,taskId:p,status:"backgrounded",reason:"watchdog_timeout",waitedMs:f,message:`Command still running after watchdog timeout; moved to background. Use await_complete(bg_cmd_ids=["${p}"]) to block until it finishes, read_background_output(task_id="${p}", mode="tail") to read output, or kill_background_command(task_id="${p}") to stop.`};if(k==="__timeout__")return o.manager.disableInactivityTimeout(t,p),{ok:!0,tool:"Bash",command:e,backgrounded:!0,taskId:p,status:"backgrounded",reason:"timeout",waitedMs:f,message:`Command still running after ${c}s; moved to background. Use await_complete(bg_cmd_ids=["${p}"]) to block until it finishes, or read_background_output(task_id="${p}", mode="tail") / kill_background_command(task_id="${p}") to inspect.`};const _=k;return{ok:_.exitCode===0&&!_.timedOut,tool:"Bash",command:e,backgrounded:!1,taskId:p,exitCode:_.exitCode,signal:_.signal,timedOut:_.timedOut,inactivityTimedOut:_.inactivityTimedOut,timeoutMs:_.timeoutMs,inactivityTimeoutMs:_.inactivityTimeoutMs,durationMs:_.durationMs,outputSpilled:_.outputSpilled,outputFilePath:_.outputFilePath,outputLineCount:_.outputLineCount,commandFilePath:_.commandFilePath,commandLineCount:_.commandLineCount,stdout:_.stdout,stderr:_.stderr}}finally{y&&clearTimeout(y),g()}}catch(p){if(p?.code==="too_many_tasks"||p?.code==="global_limit_reached")return{ok:!1,tool:"Bash",command:e,backgrounded:!1,status:"not_executed",error:p.code,message:`Command was NOT executed: ${p.message}. Wait for some background tasks to finish/cleanup (per-agent limit 16, global 256), or reduce concurrent background commands, then retry.`};throw p}}function jt(n){return{kind:"builtin",toolName:"grep",exposedName:"grep",description:"Search file contents using regular expressions within the workspace. Returns matched lines with file paths and line numbers. Supports include/exclude glob patterns, case-insensitive matching, and three output modes (content, files_with_matches, count). Searches recursively through directories, skipping binary files, hidden directories, and common build/dependency directories (node_modules, .git, dist, etc.).",inputSchema:{type:"object",properties:{pattern:{type:"string",description:"Regular expression pattern to search for in file contents."},path:{type:"string",description:"Workspace-relative file or directory path to search in. Defaults to the workspace root."},include:{type:"string",description:"Glob pattern to filter files by name (e.g. '*.ts', '*.{js,ts}'). Only matching files are searched."},exclude:{type:"string",description:"Glob pattern to exclude files by name (e.g. '*.test.ts'). Matching files are skipped."},case_insensitive:{type:"boolean",description:"Case-insensitive matching. Default false."},output_mode:{type:"string",enum:["content","files_with_matches","count"],description:"Output format: 'content' returns matched lines with line numbers (default), 'files_with_matches' returns only file paths with matches, 'count' returns match counts per file."},max_results:{type:"number",description:"Maximum number of matched lines to return (content mode). Default 1000."}},required:["pattern"],additionalProperties:!1},async execute(o){const e=$(o,["pattern"],"pattern"),t=I(o,["path"])||".",i=I(o,["include"]),s=I(o,["exclude"]),r=o.case_insensitive===!0,a=(()=>{const x=o.output_mode;return x==="files_with_matches"||x==="count"?x:"content"})(),c=B(o,["max_results"],Et),u=r?"i":"";let l;try{l=new RegExp(e,u)}catch(x){throw new Error(`Invalid regex pattern: ${x instanceof Error?x.message:String(x)}`)}const w=i?tt(i):null,h=s?tt(s):null,g=await A(n,t),p=M(g.workspaceRoot,await m.realpath(g.targetPath)),P=await m.stat(p);let f;if(P.isFile())f=[p];else if(P.isDirectory())f=await Ot(p,w,h,bt);else throw new Error(`Path is neither a file nor a directory: ${p}`);const y=[],E=[],b=[];let k=0,_=0,R=!1;for(const x of f){if(a==="content"&&y.length>=c){R=!0;break}const ot={regex:l,maxResults:a==="content"?c-y.length:Number.MAX_SAFE_INTEGER,collectContent:a==="content",stopOnFirstMatch:a==="files_with_matches"},N=await Lt(x,g.workspaceRoot,ot);if(N.count>0){const q=d.relative(g.workspaceRoot,x).replace(/\\/g,"/");if(b.push(q),k+=N.count,a==="content"){for(const j of N.matches){const z=Buffer.byteLength(j.content,"utf-8")+64;if(_+z>Pt){R=!0;break}_+=z,y.push(j)}if(R)break;if(y.length>=c){R=!0;break}}else a==="count"&&E.push({file:q,count:N.count})}}const S={ok:!0,tool:"grep",pattern:e,searchPath:v(g.targetPath),outputMode:a,filesSearched:f.length,filesMatched:b.length,totalMatches:k,truncated:R};return a==="content"?S.matches=y:a==="files_with_matches"?S.matches=b:S.matches=E,S}}}function ee(n,o,e,t,i){const s=o||"unknown",r=[Dt(n,i),Nt(n,e,i),Ct(n,e,i),Ut(n,e,i),jt(n),Wt(n,s,t,i),st(n)];return t&&r.push(ct(s,t),lt(s,t),ut(s,t)),r}export{te as DEFAULT_TOOL_PERMISSION_POLICY,ee as createBuiltInFileTools,M as ensureInsideWorkspace,A as resolveWorkspaceTarget};
+`+E:E;return{workspaceRoot:s.workspaceRoot,targetPath:a,content:P,isBinary:!1,truncated:h||k,totalLines:k?-1:p,shownFromLine:y,shownToLine:b}}finally{u.close(),c.destroy()}}function W(n){return/^https?:\/\//i.test(n)}async function It(n){let o;try{o=new URL(n)}catch{throw new Error(`Invalid image URL: ${n}`)}if(o.protocol!=="http:"&&o.protocol!=="https:")throw new Error(`Unsupported image URL protocol: ${o.protocol} (only http/https)`);let e;try{e=await fetch(n,{signal:AbortSignal.timeout(yt)})}catch(u){const l=u instanceof Error?u.message:String(u);throw new Error(`Image URL fetch failed: ${n} (${l})`)}if(!e.ok)throw new Error(`Image URL fetch failed: ${n} (HTTP ${e.status})`);const t=(e.headers.get("content-type")||"").split(";")[0]?.trim().toLowerCase()||"";if(t&&!t.startsWith("image/"))throw new Error(`URL did not return an image (content-type: ${t}): ${n}`);const i=Number(e.headers.get("content-length")||"");if(Number.isFinite(i)&&i>L)throw new Error(`Image too large to fetch: ${n} (${x(i)} > ${x(L)})`);const s=e.body;if(!s){const u=await e.arrayBuffer();if(u.byteLength>L)throw new Error(`Image too large to fetch: ${n} (${x(u.byteLength)} > ${x(L)})`);return Buffer.from(u)}const a=s.getReader(),r=[];let c=0;for(;;){const{done:u,value:l}=await a.read();if(u)break;if(l){if(c+=l.byteLength,c>L)throw a.cancel().catch(()=>{}),new Error(`Image too large to fetch: ${n} (${x(c)} > ${x(L)})`);r.push(Buffer.from(l))}}return Buffer.concat(r,c)}async function Mt(n,o,e){let t,i;if(W(o))t=await It(o),i=o;else{const b=(await J(n,o,e)).targetPath,E=await m.stat(b);if(!E.isFile())throw new Error(`Path is not a file: ${b}`);if(E.size>K)throw new Error(`Image file too large to read: ${$(b)} (${x(E.size)} > ${x(K)}). Downscale it first.`);t=await m.readFile(b),i=$(b)}if(t.length===0)throw new Error(`Image file is empty: ${i}`);const s=dt(t);if(!s)throw new Error(`Unsupported or corrupt image (unrecognized format): ${i}`);const a=ht(t);let r=s,c=t,u=a?.width,l=a?.height,w=!1;const p=await pt(t,s,{maxWidth:C,maxHeight:C,maxBytes:U});if(p)c=p.buffer,r=p.mediaType,u=p.width,l=p.height,w=p.changed;else if(t.length>U)throw new Error(`Image too large to inline: ${i} (${x(t.length)} > ${x(U)}). Downscale it first, e.g. via Bash: magick "${o}" -resize ${C}x${C} "${o}". Installing sharp enables automatic downscaling.`);const _=u&&l?`${u}x${l}`:"unknown dimensions",h=w&&a&&a.width!==u?` (resized from ${a.width}x${a.height})`:w?" (resized)":"",k=`[Image: ${i}, ${_}${h}, ${x(c.length)}]`,f=W(o)?d.basename(new URL(o).pathname)||"image":d.basename(i);return{ok:!0,filePath:i,content:k,isBinary:!1,image:{mediaType:Y(r),width:u??null,height:l??null,originalWidth:a?.width??null,originalHeight:a?.height??null,resized:w,size:c.length},attachments:[{type:"image",name:f,mediaType:Y(r),base64Data:c.toString("base64")}]}}function tt(n){let o="",e=0;for(;e<n.length;){const t=n[e];if(t==="*")o+="[^/]*";else if(t==="?")o+="[^/]";else if(t==="{"){const i=n.indexOf("}",e);if(i>=0){const s=n.slice(e+1,i);o+=`(${s.split(",").join("|")})`,e=i}else o+="\\{"}else if(t==="["){const i=n.indexOf("]",e);i>=0?(o+=n.slice(e,i+1),e=i):o+="\\["}else"+^$.()|\\".includes(t)?o+="\\"+t:o+=t;e++}return new RegExp(`^${o}$`)}async function Ot(n,o,e,t){const i=[];async function s(a){if(i.length>=t)return;const r=await m.readdir(a,{withFileTypes:!0});for(const c of r){if(i.length>=t)return;if(c.name.startsWith(".")&&c.isDirectory())continue;const u=d.join(a,c.name);if(c.isDirectory()){if(vt.has(c.name))continue;await s(u)}else if(c.isFile()){if(o&&!o.test(c.name)||e&&e.test(c.name))continue;i.push(u)}}}return await s(n),i}async function Lt(n,o,e){if((await m.stat(n)).size>kt)return{matches:[],count:0};if(await Z(n))return{matches:[],count:0};const i=d.relative(o,n).replace(/\\/g,"/"),s=[];let a=0;const r=G(n,{encoding:"utf-8"}),c=X.createInterface({input:r,crlfDelay:1/0});try{let u=0;for await(const l of c)if(u++,e.regex.test(l)){if(a++,e.collectContent){let w=l;if(w.length>O&&(w=w.slice(0,O)+`... (line truncated to ${O} chars)`),s.push({file:i,line:u,content:w}),s.length>=e.maxResults)break}if(e.stopOnFirstMatch)break}}finally{c.close(),r.destroy()}return{matches:s,count:a}}const et=10*6e4,At=et,Ft=6e4,Bt=10*6e4;function Nt(n,o,e){return{kind:"builtin",toolName:"write_file",exposedName:"write_file",description:"Create or overwrite a UTF-8 text file inside the current workspace. Parent directories are created automatically.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to write."},content:{type:"string",description:"Complete UTF-8 file content."},reason:{type:"string",description:"Optional reason for this change, e.g. what bug is being fixed. Helps humans understand the change later."}},required:["file_path","content"],additionalProperties:!1},async execute(t){const i=R(t,["file_path","filePath"],"file_path"),s=R(t,["content"],"content"),a=I(t,["reason"]),r=await A(n,i);await F(e,"fileModification",{operation:"write",path:r.targetPath});const c=await V(r.targetPath),u=c?await m.readFile(r.targetPath,"utf-8").catch(()=>null):null,l=await Q(n,i,s);if(o){const w=d.relative(l.workspaceRoot,l.targetPath).replace(/\\/g,"/");await o({filePath:w,operation:c?"UPDATE":"CREATE",beforeContent:u,afterContent:s,reason:a})}return{ok:!0,filePath:$(l.targetPath),bytes:l.bytes,createdParentDirectory:l.createdParentDirectory}}}}function Ct(n,o,e){return{kind:"builtin",toolName:"edit_file",exposedName:"edit_file",description:"Replace exactly one occurrence of old_string with new_string in a UTF-8 workspace text file.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to edit."},old_string:{type:"string",description:"Existing text to replace. Must occur exactly once."},new_string:{type:"string",description:"Replacement text."},reason:{type:"string",description:"Optional reason for this change, e.g. what bug is being fixed. Helps humans understand the change later."}},required:["file_path","old_string","new_string"],additionalProperties:!1},async execute(t){const i=R(t,["file_path","filePath"],"file_path"),s=R(t,["old_string","oldString"],"old_string"),a=R(t,["new_string","newString"],"new_string"),r=I(t,["reason"]);if(!s)throw new Error("old_string must not be empty");const c=await A(n,i);await F(e,"fileModification",{operation:"edit",path:c.targetPath});const u=await Rt(n,i),l=xt(u.content,s);if(l===0)throw new Error("old_string was not found in file");if(l>1)throw new Error(`old_string occurs ${l} times; provide a unique match`);const w=u.content.replace(s,a),p=await Q(n,i,w);if(o){const _=d.relative(p.workspaceRoot,p.targetPath).replace(/\\/g,"/");await o({filePath:_,operation:"UPDATE",beforeContent:u.content,afterContent:w,reason:r})}return{ok:!0,filePath:$(p.targetPath),bytes:p.bytes}}}}function Ut(n,o,e){return{kind:"builtin",toolName:"delete_file",exposedName:"delete_file",description:"Delete a file inside the current workspace. Returns an error if the file does not exist.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to delete."},reason:{type:"string",description:"Optional reason for this change, e.g. what bug is being fixed. Helps humans understand the change later."}},required:["file_path"],additionalProperties:!1},async execute(t){const i=R(t,["file_path","filePath"],"file_path"),s=I(t,["reason"]),a=await A(n,i);await F(e,"fileModification",{operation:"delete",path:a.targetPath});const r=M(a.workspaceRoot,await m.realpath(a.targetPath).catch(()=>a.targetPath)),c=await m.stat(r).catch(()=>null);if(!c)throw new Error(`File does not exist: ${r}`);if(!c.isFile())throw new Error(`Path is not a file: ${r}`);const u=await m.readFile(r,"utf-8").catch(()=>null);if(await m.rm(r,{force:!0}),o){const l=d.relative(a.workspaceRoot,r).replace(/\\/g,"/");await o({filePath:l,operation:"DELETE",beforeContent:u,afterContent:null,reason:s})}return{ok:!0,filePath:$(r),deleted:!0}}}}function Dt(n,o){return{kind:"builtin",toolName:"read_file",exposedName:"read_file",description:"Read a UTF-8 text file inside the current workspace. Returns content with line numbers in the format '<line>: <content>'. Supports offset (1-indexed line number to start from) and limit (max lines to return, default 2000). Output is capped at 2000 lines or 50 KB, whichever is reached first. Individual lines longer than 2000 characters are truncated. Avoid tiny repeated slices (e.g. 30-line chunks); read a larger window if more context is needed. Images (.png/.jpg/.jpeg/.gif/.webp) and http(s) image URLs are also supported: the image is inlined into the conversation so you can see it (requires a model with image input). offset/limit are ignored for images; oversized images are automatically downscaled when sharp is available.",inputSchema:{type:"object",properties:{file_path:{type:"string",description:"Workspace-relative file path to read. Also accepts an http(s) URL pointing to an image."},offset:{type:"number",description:"Line number to start reading from (1-indexed). Defaults to 1."},limit:{type:"number",description:"Maximum number of lines to return. Defaults to 2000."}},required:["file_path"],additionalProperties:!1},async execute(e){const t=R(e,["file_path","filePath"],"file_path"),i=d.extname(t).toLowerCase().slice(1);if(W(t)||_t.has(i))return await Mt(n,t,o);const s=B(e,["offset"],1),a=B(e,["limit"],ft),r=await St(n,t,s,a,o);return{ok:!0,filePath:$(r.targetPath),content:r.content,isBinary:r.isBinary,truncated:r.truncated,totalLines:r.totalLines,shownFromLine:r.shownFromLine,shownToLine:r.shownToLine}}}}function Wt(n,o,e,t){return{kind:"builtin",toolName:"Bash",exposedName:"Bash",description:"Execute a shell command in the current workspace. Use for local diagnostics, builds, tests, and OS commands. The command runs with a bounded timeout and returns stdout, stderr, exit code, and (if interrupted) partial output. By default (wait_seconds omitted or -1) the command runs in the FOREGROUND and streams output in real time; if the 5-minute adapter watchdog fires while it is still running, the command is interrupted and the partial output produced so far is returned (large output is spilled to a file via outputFilePath to avoid context overflow), with watchdogInterrupted=true. For long-running commands use wait_seconds=0 or n>0 to run in the BACKGROUND, then manage them via list_background_commands / read_background_output / kill_background_command / await_complete.",inputSchema:{type:"object",properties:{command:{type:"string",description:"Shell command to execute."},cwd:{type:"string",description:"Optional workspace-relative working directory. Defaults to the workspace root."},timeout_ms:{type:"number",description:"Optional timeout in milliseconds. Defaults to 600000 and is capped at 600000."},inactivity_timeout_ms:{type:"number",description:"Optional no-output timeout in milliseconds. Defaults to 60000 and is capped at 600000."},wait_seconds:{type:"number",description:"How to wait for the command to finish. Omitted values (or -1, the default): run in the FOREGROUND until completion; if the 5-minute adapter watchdog fires first, the command is interrupted and only the partial output already produced is returned (watchdogInterrupted=true; large output spills to outputFilePath). 0: spawn and immediately execute in the background, return task_id. n>0: wait up to n seconds; if still running, move to the background and return task_id. Background commands remain subject to timeout_ms (total upper bound); inactivity_timeout_ms is ignored once backgrounded.",minimum:-1},description:{type:"string",description:"Optional short reason for running the command."}},required:["command"],additionalProperties:!1},async execute(i,s){const a=R(i,["command"],"command").trim();if(!a)throw new Error("command must not be empty");const r=B(i,["timeout_ms","timeoutMs"],At),c=Math.min(r,et),u=B(i,["inactivity_timeout_ms","inactivityTimeoutMs"],Ft),l=Math.min(u,Bt),w=I(i,["cwd"]),p=await Tt(n,w);await F(t,"commandExecution",{command:a,cwd:$(p.cwd)});const _=i.wait_seconds,k=typeof _=="number"&&Number.isFinite(_)?_:-1;if(k!==-1&&e)return await qt({deps:e,command:a,agentId:o,workspaceRoot:p.workspaceRoot,cwd:p.cwd,timeoutMs:c,inactivityTimeoutMs:l,waitSeconds:k,onOutput:s?.onOutput,settleSignal:s?.settleSignal});const f=await at({commandText:a,agentId:o,workspaceRoot:p.workspaceRoot,cwd:p.cwd,timeoutMs:c,inactivityTimeoutMs:l,onOutput:s?.onOutput,watchdogSignal:s?.settleSignal}),y={ok:f.exitCode===0&&!f.timedOut,tool:"Bash",command:a,cwd:$(p.cwd),exitCode:f.exitCode,signal:f.signal,timedOut:f.timedOut,inactivityTimedOut:f.inactivityTimedOut,watchdogInterrupted:f.watchdogInterrupted,timeoutMs:c,inactivityTimeoutMs:l,durationMs:f.durationMs,outputSpilled:f.outputSpilled,outputFilePath:f.outputFilePath,outputLineCount:f.outputLineCount,commandFilePath:f.commandFilePath,commandLineCount:f.commandLineCount,stdout:f.stdout,stderr:f.stderr};return f.watchdogInterrupted?{...y,message:"Command was interrupted by the adapter watchdog after ~5 minutes of synchronous (foreground) execution. Only the partial output produced so far is returned above"+(f.outputFilePath?` (full output spilled to "${f.outputFilePath}"; read it if you need more)`:"")+". For long-running commands, re-run with wait_seconds=0 (or n>0) to execute in the background, then manage via await_complete / list_background_commands / read_background_output / kill_background_command."}:y}}}async function qt(n){const{deps:o,command:e,agentId:t,workspaceRoot:i,cwd:s,timeoutMs:a,inactivityTimeoutMs:r,waitSeconds:c,onOutput:u,settleSignal:l}=n,w=u?rt({cwd:s,commandLineCount:0,onOutput:u}):void 0;let p=!!w;const _=()=>{p&&(p=!1,w?.close())};try{const{taskId:h,completion:k}=o.manager.startCommand({commandText:e,agentId:t,workspaceRoot:i,cwd:s,timeoutMs:a,inactivityTimeoutMs:r,onOutput:p?P=>{p&&w?.push(P.stream,P.text)}:void 0,onCompleted:o.emitCompleted});if(c===0)return o.manager.disableInactivityTimeout(t,h),_(),{ok:!0,tool:"Bash",command:e,backgrounded:!0,taskId:h,status:"backgrounded",reason:"immediate",message:`Command moved to background. Use await_complete(bg_cmd_ids=["${h}"]) to block until it finishes, read_background_output(task_id="${h}", mode="tail") to read output, list_background_commands to view all, or kill_background_command(task_id="${h}") to stop.`};const f=c===-1?0:Math.max(0,Math.floor(c*1e3));let y,b;c===-1?b=Promise.resolve("__never__"):b=new Promise(P=>{y=setTimeout(()=>P("__timeout__"),f),y.unref?.()});const E=l?l.then(()=>"__settle__"):Promise.resolve("__never__");try{const P=await Promise.race([k,b,E]);if(P==="__settle__")return o.manager.disableInactivityTimeout(t,h),{ok:!0,tool:"Bash",command:e,backgrounded:!0,taskId:h,status:"backgrounded",reason:"watchdog_timeout",waitedMs:f,message:`Command still running after watchdog timeout; moved to background. Use await_complete(bg_cmd_ids=["${h}"]) to block until it finishes, read_background_output(task_id="${h}", mode="tail") to read output, or kill_background_command(task_id="${h}") to stop.`};if(P==="__timeout__")return o.manager.disableInactivityTimeout(t,h),{ok:!0,tool:"Bash",command:e,backgrounded:!0,taskId:h,status:"backgrounded",reason:"timeout",waitedMs:f,message:`Command still running after ${c}s; moved to background. Use await_complete(bg_cmd_ids=["${h}"]) to block until it finishes, or read_background_output(task_id="${h}", mode="tail") / kill_background_command(task_id="${h}") to inspect.`};const g=P;return{ok:g.exitCode===0&&!g.timedOut,tool:"Bash",command:e,backgrounded:!1,taskId:h,exitCode:g.exitCode,signal:g.signal,timedOut:g.timedOut,inactivityTimedOut:g.inactivityTimedOut,timeoutMs:g.timeoutMs,inactivityTimeoutMs:g.inactivityTimeoutMs,durationMs:g.durationMs,outputSpilled:g.outputSpilled,outputFilePath:g.outputFilePath,outputLineCount:g.outputLineCount,commandFilePath:g.commandFilePath,commandLineCount:g.commandLineCount,stdout:g.stdout,stderr:g.stderr}}finally{y&&clearTimeout(y),_()}}catch(h){if(h?.code==="too_many_tasks"||h?.code==="global_limit_reached")return{ok:!1,tool:"Bash",command:e,backgrounded:!1,status:"not_executed",error:h.code,message:`Command was NOT executed: ${h.message}. Wait for some background tasks to finish/cleanup (per-agent limit 16, global 256), or reduce concurrent background commands, then retry.`};throw h}}function jt(n){return{kind:"builtin",toolName:"grep",exposedName:"grep",description:"Search file contents using regular expressions within the workspace. Returns matched lines with file paths and line numbers. Supports include/exclude glob patterns, case-insensitive matching, and three output modes (content, files_with_matches, count). Searches recursively through directories, skipping binary files, hidden directories, and common build/dependency directories (node_modules, .git, dist, etc.).",inputSchema:{type:"object",properties:{pattern:{type:"string",description:"Regular expression pattern to search for in file contents."},path:{type:"string",description:"Workspace-relative file or directory path to search in. Defaults to the workspace root."},include:{type:"string",description:"Glob pattern to filter files by name (e.g. '*.ts', '*.{js,ts}'). Only matching files are searched."},exclude:{type:"string",description:"Glob pattern to exclude files by name (e.g. '*.test.ts'). Matching files are skipped."},case_insensitive:{type:"boolean",description:"Case-insensitive matching. Default false."},output_mode:{type:"string",enum:["content","files_with_matches","count"],description:"Output format: 'content' returns matched lines with line numbers (default), 'files_with_matches' returns only file paths with matches, 'count' returns match counts per file."},max_results:{type:"number",description:"Maximum number of matched lines to return (content mode). Default 1000."}},required:["pattern"],additionalProperties:!1},async execute(o){const e=R(o,["pattern"],"pattern"),t=I(o,["path"])||".",i=I(o,["include"]),s=I(o,["exclude"]),a=o.case_insensitive===!0,r=(()=>{const v=o.output_mode;return v==="files_with_matches"||v==="count"?v:"content"})(),c=B(o,["max_results"],Pt),u=a?"i":"";let l;try{l=new RegExp(e,u)}catch(v){throw new Error(`Invalid regex pattern: ${v instanceof Error?v.message:String(v)}`)}const w=i?tt(i):null,p=s?tt(s):null,_=await A(n,t),h=M(_.workspaceRoot,await m.realpath(_.targetPath)),k=await m.stat(h);let f;if(k.isFile())f=[h];else if(k.isDirectory())f=await Ot(h,w,p,bt);else throw new Error(`Path is neither a file nor a directory: ${h}`);const y=[],b=[],E=[];let P=0,g=0,T=!1;for(const v of f){if(r==="content"&&y.length>=c){T=!0;break}const ot={regex:l,maxResults:r==="content"?c-y.length:Number.MAX_SAFE_INTEGER,collectContent:r==="content",stopOnFirstMatch:r==="files_with_matches"},N=await Lt(v,_.workspaceRoot,ot);if(N.count>0){const q=d.relative(_.workspaceRoot,v).replace(/\\/g,"/");if(E.push(q),P+=N.count,r==="content"){for(const j of N.matches){const z=Buffer.byteLength(j.content,"utf-8")+64;if(g+z>Et){T=!0;break}g+=z,y.push(j)}if(T)break;if(y.length>=c){T=!0;break}}else r==="count"&&b.push({file:q,count:N.count})}}const S={ok:!0,tool:"grep",pattern:e,searchPath:$(_.targetPath),outputMode:r,filesSearched:f.length,filesMatched:E.length,totalMatches:P,truncated:T};return r==="content"?S.matches=y:r==="files_with_matches"?S.matches=E:S.matches=b,S}}}function ee(n,o,e,t,i){const s=o||"unknown",a=[Dt(n,i),Nt(n,e,i),Ct(n,e,i),Ut(n,e,i),jt(n),Wt(n,s,t,i),st(n)];return t&&a.push(ct(s,t),lt(s,t),ut(s,t)),a}export{te as DEFAULT_TOOL_PERMISSION_POLICY,ee as createBuiltInFileTools,M as ensureInsideWorkspace,A as resolveWorkspaceTarget};
 

package/package/acode/dist/commands/commandRegistry.d.ts

@@ -8,5 +8,7 @@ export declare class ACodeCommandRegistry {
     private readonly commands;
     constructor(commands: readonly ACodeCommandSpec[]);
     list(): ACodeCommandSpec[];
+    
+    addCommands(commands: readonly ACodeCommandSpec[]): void;
     expand(input: string): ExpandedAcodeCommand | null;
 }

package/package/acode/dist/commands/commandRegistry.js

@@ -1,2 +1,2 @@
-function r(e){return e.replace(/^\/+/,"").trim().toLowerCase()}class s{constructor(n){this.commands=new Map;for(const t of n)this.commands.set(r(t.name),t)}list(){return[...this.commands.values()]}expand(n){const t=n.trim().match(/^\/([^\s]+)(?:\s+(.*))?$/s);if(!t)return null;const m=this.commands.get(r(t[1]??""));if(!m)return null;const o=(t[2]??"").trim();return{command:m,argumentsText:o,prompt:m.body.replace(/\$ARGUMENTS/g,o)}}}export{s as ACodeCommandRegistry};
+function o(s){return s.replace(/^\/+/,"").trim().toLowerCase()}class e{constructor(t){this.commands=new Map;for(const m of t)this.commands.set(o(m.name),m)}list(){return[...this.commands.values()]}addCommands(t){for(const m of t)this.commands.set(o(m.name),m)}expand(t){const m=t.trim().match(/^\/([^\s]+)(?:\s+(.*))?$/s);if(!m)return null;const n=this.commands.get(o(m[1]??""));if(!n)return null;const a=(m[2]??"").trim();return{command:n,argumentsText:a,prompt:n.body.replace(/\$ARGUMENTS/g,a)}}}export{e as ACodeCommandRegistry};
 

package/package/acode/dist/index.d.ts

@@ -11,6 +11,8 @@ export * from './sub-agent-manager.js';
 export * from './sub-agent-tools.js';
 export * from './built-in-file-tools.js';
 export * from './terminal-types.js';
+export * from './plugin-types.js';
+export * from './plugin-tools.js';
 export * from './parsers/types.js';
 export * from './parsers/tree-sitter-loader.js';
 export * from './parsers/ast-cache.js';

package/package/acode/dist/index.js

@@ -1,2 +1,2 @@
-export*from"./commands/commandRegistry.js";export*from"./commands/commandLoader.js";export*from"./commands/commandParser.js";export*from"./config.js";export*from"./hooks/hookBus.js";export*from"./runtime.js";export*from"./types.js";export*from"./sub-agent-types.js";export*from"./sub-agent-store.js";export*from"./sub-agent-manager.js";export*from"./sub-agent-tools.js";export*from"./built-in-file-tools.js";export*from"./terminal-types.js";export*from"./parsers/types.js";export*from"./parsers/tree-sitter-loader.js";export*from"./parsers/ast-cache.js";export*from"./parsers/language-detector.js";export*from"./parsers/language-queries.js";export*from"./parsers/symbol-extractor.js";export*from"./built-in-symbols-tool.js";
+export*from"./commands/commandRegistry.js";export*from"./commands/commandLoader.js";export*from"./commands/commandParser.js";export*from"./config.js";export*from"./hooks/hookBus.js";export*from"./runtime.js";export*from"./types.js";export*from"./sub-agent-types.js";export*from"./sub-agent-store.js";export*from"./sub-agent-manager.js";export*from"./sub-agent-tools.js";export*from"./built-in-file-tools.js";export*from"./terminal-types.js";export*from"./plugin-types.js";export*from"./plugin-tools.js";export*from"./parsers/types.js";export*from"./parsers/tree-sitter-loader.js";export*from"./parsers/ast-cache.js";export*from"./parsers/language-detector.js";export*from"./parsers/language-queries.js";export*from"./parsers/symbol-extractor.js";export*from"./built-in-symbols-tool.js";
 

package/package/acode/dist/plugin-tools.d.ts

@@ -0,0 +1,14 @@
+
+import type { ACodeBuiltInTool } from "./built-in-file-tools.js";
+import type { ACodePluginBridge } from "./plugin-types.js";
+export interface PluginToolsDeps {
+    pluginBridge?: ACodePluginBridge;
+}
+
+export declare function splitQualifiedToolName(qualifiedName: string): {
+    plugin: string;
+    tool: string;
+} | null;
+export declare function createPluginTools(deps: PluginToolsDeps): ACodeBuiltInTool[];
+
+export declare function buildPluginPrompt(): string;