aws-runtime-bridge 1.9.189 → 1.9.192

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

@@ -8,36 +8,22 @@
 
 
 
-import type { PluginLoader } from "./plugin-loader.js";
 import type { SharedPluginEntry } from "./plugin-runtime.js";
 export declare class PluginDeploymentStore {
     private readonly rootDir;
     private readonly runtimeRootDir;
-    private readonly loader;
-    
-    private readonly legacyRootDir?;
-    constructor(rootDir: string, runtimeRootDir: string | undefined, loader: PluginLoader, 
-    
-    legacyRootDir?: string | undefined);
+    constructor(rootDir: string, runtimeRootDir: string | undefined);
     deployedDir(): string;
     deployedManifestFile(): string;
     
-    private legacyDeployedDir;
-    private legacyDeployedManifestFile;
-    
 
 
 
 
     deployedPluginDir(name: string): string;
     
-    private legacySharedDir;
-    
     deployedPluginHealthy(name: string): boolean;
     
-    private legacyPluginHealthy;
-    
-
 
 
     resolveDeployedSourceDir(name: string): string | null;
@@ -45,22 +31,10 @@ export declare class PluginDeploymentStore {
 
 
 
-
-    private readMergedManifest;
-    
-    hasLegacyManifestEntry(pluginName: string): boolean;
-    
-    activeSharedManifest(): SharedPluginEntry[];
-    
-
-
-
     readSharedManifest(): SharedPluginEntry[];
     writeSharedManifest(entries: SharedPluginEntry[]): void;
     
-    migrateLegacySharedIfNeeded(): Promise<void>;
-    
-    deployPluginZipToPersistentDir(zipBuffer: Buffer, expectedName?: string): Promise<SharedPluginEntry | null>;
+    updateSharedManifest(mutator: (entries: SharedPluginEntry[]) => SharedPluginEntry[]): Promise<void>;
     
 
 
@@ -69,8 +43,6 @@ export declare class PluginDeploymentStore {
     
     removeDeployedDir(pluginName: string): void;
     
-    updateSharedManifest(mutator: (entries: SharedPluginEntry[]) => SharedPluginEntry[]): Promise<void>;
-    
 
 
 

package/dist/services/plugin-deployment.js

@@ -1,3 +1,3 @@
-import{cpSync as S,existsSync as a,lstatSync as M,mkdirSync as f,readFileSync as d,readdirSync as P,renameSync as D,rmSync as u,symlinkSync as w,writeFileSync as N}from"node:fs";import{join as n,resolve as m}from"node:path";import{getBridgeInstancePluginsDir as v}from"../config.js";import{sanitizeAgentId as F,sanitizeArchiveFileName as k,withFileLock as L}from"../utils/file-utils.js";import{createLogger as $}from"../utils/logger.js";import{isValidPluginName as h,PLUGIN_NAME_PATTERN as A}from"./plugin-manifest.js";import{extractPluginZip as R}from"./plugin-package.js";const l=$("plugin-manager"),E=process.platform==="win32"?"junction":"dir";class x{constructor(e,i,r,t){this.rootDir=e,this.runtimeRootDir=i,this.loader=r,this.legacyRootDir=t}deployedDir(){return n(this.rootDir,"deployed")}deployedManifestFile(){return n(this.deployedDir(),"manifest.json")}legacyDeployedDir(){return this.legacyRootDir?n(this.legacyRootDir,"deployed"):""}legacyDeployedManifestFile(){return this.legacyDeployedDir()?n(this.legacyDeployedDir(),"manifest.json"):""}deployedPluginDir(e){if(!h(e))throw new Error(`\u975E\u6CD5\u63D2\u4EF6\u540D\uFF08\u4EC5\u5141\u8BB8 ${A}\uFF09: ${JSON.stringify(e)}`);const i=n(this.deployedDir(),e),r=m(this.deployedDir());if(m(i)!==n(r,e))throw new Error(`\u63D2\u4EF6\u76EE\u5F55\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return i}legacySharedDir(){return n(this.rootDir,"shared")}deployedPluginHealthy(e){return a(n(this.deployedPluginDir(e),"plugin.json"))||this.legacyPluginHealthy(e)}legacyPluginHealthy(e){if(!this.legacyDeployedDir())return!1;try{const i=n(this.legacyDeployedDir(),e);return a(n(i,"plugin.json"))}catch{return!1}}resolveDeployedSourceDir(e){return a(n(this.deployedPluginDir(e),"plugin.json"))?this.deployedPluginDir(e):this.legacyPluginHealthy(e)?n(this.legacyDeployedDir(),e):null}readMergedManifest(){const e=new Map;if(this.legacyDeployedManifestFile())try{const i=JSON.parse(d(this.legacyDeployedManifestFile(),"utf8"));for(const r of Array.isArray(i.plugins)?i.plugins:[])r&&h(r.pluginName)&&e.set(r.pluginName,r)}catch{}try{const i=JSON.parse(d(this.deployedManifestFile(),"utf8"));for(const r of Array.isArray(i.plugins)?i.plugins:[])r&&h(r.pluginName)&&e.set(r.pluginName,r)}catch{}return[...e.values()]}hasLegacyManifestEntry(e){if(!this.legacyDeployedManifestFile())return!1;try{const i=JSON.parse(d(this.legacyDeployedManifestFile(),"utf8"));return(Array.isArray(i.plugins)?i.plugins:[]).some(r=>r&&h(r.pluginName)&&r.pluginName===e)}catch{return!1}}activeSharedManifest(){return this.readMergedManifest().filter(e=>!e.removed)}readSharedManifest(){return this.activeSharedManifest()}writeSharedManifest(e){f(this.deployedDir(),{recursive:!0}),N(this.deployedManifestFile(),`${JSON.stringify({version:2,plugins:e},null,2)}
-`,"utf8")}async migrateLegacySharedIfNeeded(){try{if(a(this.deployedManifestFile()))return;const e=n(this.legacySharedDir(),"manifest.json");if(!a(e))return;const i=JSON.parse(d(e,"utf8")),r=Array.isArray(i.plugins)?i.plugins:[];if(r.length===0)return;const t=[];let s=0,o=0;for(const y of r){const g=k(y.zipFile??"","");if(!y.pluginName||!g)continue;const p=n(this.legacySharedDir(),g);if(a(p)){s+=1;try{const c=await this.deployPluginZipToPersistentDir(d(p),y.pluginName);if(!c){o+=1;continue}t.push(c),l.info("[shared] \u65E7\u5171\u4EAB\u63D2\u4EF6\u8FC1\u79FB\u5230\u90E8\u7F72\u533A: %s",y.pluginName)}catch(c){o+=1,l.warn("[shared] \u65E7\u5171\u4EAB\u63D2\u4EF6 %s \u8FC1\u79FB\u5931\u8D25: %s",y.pluginName,c instanceof Error?c.message:String(c))}}}t.length>0&&this.writeSharedManifest(t),o===0?u(this.legacySharedDir(),{recursive:!0,force:!0}):l.warn("[shared] \u65E7\u5171\u4EAB\u63D2\u4EF6\u8FC1\u79FB\u90E8\u5206\u5931\u8D25\uFF08%d/%d\uFF09\uFF0C\u4FDD\u7559 shared/ \u76EE\u5F55\u4EE5\u514D\u6570\u636E\u4E22\u5931",o,s)}catch(e){l.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))}}async deployPluginZipToPersistentDir(e,i){if(!e||e.length===0)return null;const r=n(this.rootDir,"tmp",`migrate-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const t=await R(e,r),s=this.loader.loadManifestOnly(t.pluginDir);if(!s.ok)return null;const o=s.manifest.name;return i&&o!==i?null:(this.replaceDeployedDir(o,t.pluginDir),{pluginName:o,zipFile:`${o}.zip`,fileName:`${o}.zip`,defaultEnabled:!0})}finally{u(r,{recursive:!0,force:!0})}}replaceDeployedDir(e,i){f(this.deployedDir(),{recursive:!0});const r=this.deployedPluginDir(e),t=n(this.deployedDir(),`.old-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);a(r)&&D(r,t);try{S(i,r,{recursive:!0,filter:s=>!/[\\/]\.git([\\/]|$)/.test(s)&&!/[\\/]node_modules([\\/]|$)/.test(s)})}catch(s){throw a(t)&&(u(r,{recursive:!0,force:!0}),D(t,r)),s}a(t)&&u(t,{recursive:!0,force:!0})}removeDeployedDir(e){u(this.deployedPluginDir(e),{recursive:!0,force:!0})}async updateSharedManifest(e){await L(this.deployedManifestFile(),async()=>{this.writeSharedManifest(e(this.readMergedManifest()))})}runtimeDirFor(e){return this.runtimeRootDir?n(this.runtimeRootDir,F(e)):v(e)}runtimeLinkPath(e,i){return n(this.runtimeDirFor(e),i)}ensureRuntimeLink(e,i){const r=this.runtimeLinkPath(e,i),t=this.resolveDeployedSourceDir(i);if(!t)return!1;f(this.runtimeDirFor(e),{recursive:!0});try{if(a(r)){let s=!1;try{s=M(r).isSymbolicLink()}catch{s=!1}if(s)try{return P(r),!0}catch{}u(r,{recursive:!0,force:!0})}return w(t,r,E),l.info("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5DF2\u5EFA\u7ACB: %s \u2192 %s",e,r,t),!0}catch(s){return l.warn("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5931\u8D25\uFF08%s \u2192 %s\uFF09: %s",e,i,t,s instanceof Error?s.message:String(s)),!1}}removeRuntimeLink(e,i){const r=this.runtimeLinkPath(e,i);try{a(r)&&(u(r,{recursive:!0,force:!0}),l.info("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5DF2\u79FB\u9664: %s",e,i))}catch(t){l.warn("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u79FB\u9664\u5931\u8D25\uFF08%s\uFF09: %s",e,i,t instanceof Error?t.message:String(t))}}}export{x as PluginDeploymentStore};
+import{cpSync as y,existsSync as o,lstatSync as p,mkdirSync as c,readFileSync as D,readdirSync as g,renameSync as d,rmSync as u,symlinkSync as m,writeFileSync as S}from"node:fs";import{join as n,resolve as f}from"node:path";import{getBridgeInstancePluginsDir as P}from"../config.js";import{sanitizeAgentId as v,withFileLock as w}from"../utils/file-utils.js";import{createLogger as M}from"../utils/logger.js";import{isValidPluginName as h,PLUGIN_NAME_PATTERN as k}from"./plugin-manifest.js";const l=M("plugin-manager"),F=process.platform==="win32"?"junction":"dir",a=3;class O{constructor(r,i){this.rootDir=r,this.runtimeRootDir=i}deployedDir(){return n(this.rootDir,"deployed")}deployedManifestFile(){return n(this.deployedDir(),"manifest.json")}deployedPluginDir(r){if(!h(r))throw new Error(`\u975E\u6CD5\u63D2\u4EF6\u540D\uFF08\u4EC5\u5141\u8BB8 ${k}\uFF09: ${JSON.stringify(r)}`);const i=n(this.deployedDir(),r),e=f(this.deployedDir());if(f(i)!==n(e,r))throw new Error(`\u63D2\u4EF6\u76EE\u5F55\u8D8A\u51FA\u90E8\u7F72\u533A: ${r}`);return i}deployedPluginHealthy(r){return o(n(this.deployedPluginDir(r),"plugin.json"))}resolveDeployedSourceDir(r){return this.deployedPluginHealthy(r)?this.deployedPluginDir(r):null}readSharedManifest(){try{if(!o(this.deployedManifestFile()))return[];const r=JSON.parse(D(this.deployedManifestFile(),"utf8"));if(r.version!==a)return l.warn("[shared] \u90E8\u7F72\u6E05\u5355\u7248\u672C %s \u975E %d\uFF08\u65E7\u683C\u5F0F\u4E0D\u518D\u517C\u5BB9\uFF09\uFF0C\u6309\u7A7A\u90E8\u7F72\u96C6\u5904\u7406\u2014\u2014\u8BF7\u91CD\u65B0\u90E8\u7F72\u63D2\u4EF6",String(r.version??"(\u7F3A\u5931)"),a),[];const i=[];for(const e of Array.isArray(r.plugins)?r.plugins:[])e&&h(e.pluginName)&&i.push(e);return i}catch{return[]}}writeSharedManifest(r){c(this.deployedDir(),{recursive:!0}),S(this.deployedManifestFile(),`${JSON.stringify({version:a,plugins:r},null,2)}
+`,"utf8")}async updateSharedManifest(r){await w(this.deployedManifestFile(),async()=>{this.writeSharedManifest(r(this.readSharedManifest()))})}replaceDeployedDir(r,i){c(this.deployedDir(),{recursive:!0});const e=this.deployedPluginDir(r),t=n(this.deployedDir(),`.old-${r}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);o(e)&&d(e,t);try{y(i,e,{recursive:!0,filter:s=>!/[\\/]\.git([\\/]|$)/.test(s)&&!/[\\/]node_modules([\\/]|$)/.test(s)})}catch(s){throw o(t)&&(u(e,{recursive:!0,force:!0}),d(t,e)),s}o(t)&&u(t,{recursive:!0,force:!0})}removeDeployedDir(r){u(this.deployedPluginDir(r),{recursive:!0,force:!0})}runtimeDirFor(r){return this.runtimeRootDir?n(this.runtimeRootDir,v(r)):P(r)}runtimeLinkPath(r,i){return n(this.runtimeDirFor(r),i)}ensureRuntimeLink(r,i){const e=this.runtimeLinkPath(r,i),t=this.resolveDeployedSourceDir(i);if(!t)return!1;c(this.runtimeDirFor(r),{recursive:!0});try{if(o(e)){let s=!1;try{s=p(e).isSymbolicLink()}catch{s=!1}if(s)try{return g(e),!0}catch{}u(e,{recursive:!0,force:!0})}return m(t,e,F),l.info("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5DF2\u5EFA\u7ACB: %s \u2192 %s",r,e,t),!0}catch(s){return l.warn("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5931\u8D25\uFF08%s \u2192 %s\uFF09: %s",r,i,t,s instanceof Error?s.message:String(s)),!1}}removeRuntimeLink(r,i){const e=this.runtimeLinkPath(r,i);try{o(e)&&(u(e,{recursive:!0,force:!0}),l.info("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u5DF2\u79FB\u9664: %s",r,i))}catch(t){l.warn("[agent:%s] \u63D2\u4EF6\u8FD0\u884C\u65F6\u94FE\u63A5\u79FB\u9664\u5931\u8D25\uFF08%s\uFF09: %s",r,i,t instanceof Error?t.message:String(t))}}}export{O as PluginDeploymentStore};
 

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

@@ -8,7 +8,6 @@
 
 
 
-
 import type { PluginInvokeContext, PluginToolInvocationResult, JsonObject } from "@agentswork/acode";
 import type { PluginToolDef } from "./plugin-manifest.js";
 import type { LoadedPlugin } from "./plugin-runtime.js";
@@ -17,4 +16,14 @@ export declare function executeHandler(agentId: string, plugin: LoadedPlugin, to
 
 
 
+
+
+
+
+
+export declare function resolveEffectiveConfigValues(plugin: LoadedPlugin, agentId?: string): Record<string, string>;
+
+
+
+
 export declare function buildPluginEnv(plugin: LoadedPlugin, agentId: string): NodeJS.ProcessEnv;

package/dist/services/plugin-handler-adapter.js

@@ -1,3 +1,3 @@
-import{spawn as T}from"node:child_process";import{join as _}from"node:path";import{pathToFileURL as O}from"node:url";import{loadDynamicModule as P}from"../utils/dynamic-import.js";import{BLOCKED_ENV_KEYS as A}from"../utils/env-safety.js";import{createLogger as v}from"../utils/logger.js";import{renderCommandArgv as C,truncate as N}from"./plugin-manifest.js";const S=v("plugin-manager"),g=256*1024,h=6e4,b=/^[A-Za-z_][A-Za-z0-9_]*$/;async function K(t,e,s,a,o){const n=Date.now(),r=s.handler??{type:"process"};try{return r.type==="mcp"?{ok:!1,error:"handler.type=mcp \u5C06\u5728\u540E\u7EED\u7248\u672C\u652F\u6301\uFF0C\u8BF7\u6539\u7528 process/module handler"}:r.type==="module"?{ok:!0,result:await D(e,r,a,t,o),durationMs:Date.now()-n}:!r.command||!r.command.trim()?{ok:!1,error:`\u5DE5\u5177 ${s.name} \u7684 process handler \u7F3A\u5C11 command`}:{ok:!0,result:await k(e,r,a,t,o),durationMs:Date.now()-n}}catch(i){return{ok:!1,error:i instanceof Error?i.message:String(i),durationMs:Date.now()-n}}}async function k(t,e,s,a,o){const n=e.command??"";if(e.shell===!0&&/\{\{.+?\}\}/.test(n))throw new Error('shell:true \u7684 handler \u4E0D\u652F\u6301 {{params.*}} \u63D2\u503C\uFF08\u547D\u4EE4\u6CE8\u5165\u98CE\u9669\uFF09\uFF1B\u8BF7\u6539\u7528 shell:false \u7684 argv \u6A21\u5F0F\u6216 stdin:"params"');const r=C(n,{params:s});if(r.length===0)throw new Error("process handler command \u4E3A\u7A7A");const i=typeof e.timeoutMs=="number"&&e.timeoutMs>0?e.timeoutMs:h,u=new AbortController,d=()=>u.abort();o?.signal?.addEventListener("abort",d,{once:!0});const E=setTimeout(()=>u.abort(),i);try{return await new Promise((l,w)=>{S.info("[plugin:%s] spawn: %s",t.name,r.join(" "));const c=T(r[0],r.slice(1),{cwd:t.dir,env:L(t,a),shell:e.shell===!0,windowsHide:!0,signal:u.signal});let f="",y="";c.stdin?.on("error",()=>{}),c.stdout?.on("data",m=>{f.length<g&&(f+=m.toString("utf8"))}),c.stderr?.on("data",m=>{y.length<g&&(y+=m.toString("utf8"))}),c.on("error",m=>{w(new Error(`\u63D2\u4EF6\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${m.message}`))}),c.on("close",m=>{const p=f.trim();if(m!==0){const M=N(y.trim()||p||"(\u65E0\u8F93\u51FA)",600);w(new Error(u.signal.aborted?`\u63D2\u4EF6\u8FDB\u7A0B\u8D85\u65F6(${i}ms)\u6216\u88AB\u4E2D\u6B62`:`\u63D2\u4EF6\u8FDB\u7A0B\u9000\u51FA\u7801 ${m}: ${M}`));return}if(!p){l({ok:!0});return}try{l(JSON.parse(p))}catch{l(p)}});try{e.stdin==="params"?c.stdin?.end(`${JSON.stringify(s)}
-`):c.stdin?.end()}catch{}})}finally{clearTimeout(E),o?.signal?.removeEventListener("abort",d)}}async function D(t,e,s,a,o){if(!e.module)throw new Error("module handler \u7F3A\u5C11 module \u8DEF\u5F84");const n=_(t.dir,e.module);let r=t.moduleCache.get(n);r||(r=await P(O(n).href,{freshInstanceQuery:`acode_nonce=${t.importNonce}`}),t.moduleCache.set(n,r));const i=e.export||"default",d=r[i];if(typeof d!="function")throw new Error(`\u6A21\u5757 ${e.module} \u672A\u5BFC\u51FA\u51FD\u6570 ${i}`);const E=typeof e.timeoutMs=="number"&&e.timeoutMs>0?e.timeoutMs:h;let l;const w=Promise.resolve().then(()=>d(s,{agentId:a,signal:o?.signal,pluginRoot:t.dir}));try{return await Promise.race([w,new Promise((c,f)=>{l=setTimeout(()=>f(new Error(`\u63D2\u4EF6\u6A21\u5757\u6267\u884C\u8D85\u65F6(${E}ms)`)),E)})])}finally{clearTimeout(l)}}function L(t,e){const s={};for(const o of["PATH","HOME","USERPROFILE","SystemRoot","COMSPEC","TEMP","TMP","LANG","TZ"]){const n=process.env[o];n!==void 0&&(s[o]=n)}s.ACODE_PLUGIN_ROOT=t.dir,s.ACODE_AGENT_ID=e,s.ACODE_PLUGIN_NAME=t.name;const a=new Set((t.userConfig??[]).map(o=>o.key));for(const[o,n]of Object.entries(t.configValues))a.has(o)&&(!b.test(o)||A.has(o.toUpperCase())||(s[o]=n));return s}export{L as buildPluginEnv,K as executeHandler};
+import{spawn as T}from"node:child_process";import{join as _}from"node:path";import{pathToFileURL as O}from"node:url";import{loadDynamicModule as P}from"../utils/dynamic-import.js";import{BLOCKED_ENV_KEYS as k}from"../utils/env-safety.js";import{getPanelEnvVars as A}from"./panel-env.js";import{createLogger as C}from"../utils/logger.js";import{renderCommandArgv as b,truncate as N}from"./plugin-manifest.js";const S=C("plugin-manager"),g=256*1024,h=6e4,D=/^[A-Za-z_][A-Za-z0-9_]*$/;async function Y(o,e,n,s,i){const t=Date.now(),r=n.handler??{type:"process"};try{return r.type==="module"?{ok:!0,result:await $(e,r,s,o,i),durationMs:Date.now()-t}:!r.command||!r.command.trim()?{ok:!1,error:`\u5DE5\u5177 ${n.name} \u7684 process handler \u7F3A\u5C11 command`}:{ok:!0,result:await L(e,r,s,o,i),durationMs:Date.now()-t}}catch(a){return{ok:!1,error:a instanceof Error?a.message:String(a),durationMs:Date.now()-t}}}async function L(o,e,n,s,i){const t=e.command??"";if(e.shell===!0&&/\{\{.+?\}\}/.test(t))throw new Error('shell:true \u7684 handler \u4E0D\u652F\u6301 {{params.*}} \u63D2\u503C\uFF08\u547D\u4EE4\u6CE8\u5165\u98CE\u9669\uFF09\uFF1B\u8BF7\u6539\u7528 shell:false \u7684 argv \u6A21\u5F0F\u6216 stdin:"params"');const r=b(t,{params:n});if(r.length===0)throw new Error("process handler command \u4E3A\u7A7A");const a=typeof e.timeoutMs=="number"&&e.timeoutMs>0?e.timeoutMs:h,f=new AbortController,l=()=>f.abort();i?.signal?.addEventListener("abort",l,{once:!0});const E=setTimeout(()=>f.abort(),a);try{return await new Promise((u,y)=>{S.info("[plugin:%s] spawn: %s",o.name,r.join(" "));const c=T(r[0],r.slice(1),{cwd:o.dir,env:U(o,s),shell:e.shell===!0,windowsHide:!0,signal:f.signal});let d="",p="";c.stdin?.on("error",()=>{}),c.stdout?.on("data",m=>{d.length<g&&(d+=m.toString("utf8"))}),c.stderr?.on("data",m=>{p.length<g&&(p+=m.toString("utf8"))}),c.on("error",m=>{y(new Error(`\u63D2\u4EF6\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${m.message}`))}),c.on("close",m=>{const w=d.trim();if(m!==0){const M=N(p.trim()||w||"(\u65E0\u8F93\u51FA)",600);y(new Error(f.signal.aborted?`\u63D2\u4EF6\u8FDB\u7A0B\u8D85\u65F6(${a}ms)\u6216\u88AB\u4E2D\u6B62`:`\u63D2\u4EF6\u8FDB\u7A0B\u9000\u51FA\u7801 ${m}: ${M}`));return}if(!w){u({ok:!0});return}try{u(JSON.parse(w))}catch{u(w)}});try{e.stdin==="params"?c.stdin?.end(`${JSON.stringify(n)}
+`):c.stdin?.end()}catch{}})}finally{clearTimeout(E),i?.signal?.removeEventListener("abort",l)}}async function $(o,e,n,s,i){if(!e.module)throw new Error("module handler \u7F3A\u5C11 module \u8DEF\u5F84");const t=_(o.dir,e.module);let r=o.moduleCache.get(t);r||(r=await P(O(t).href,{freshInstanceQuery:`acode_nonce=${o.importNonce}`}),o.moduleCache.set(t,r));const a=e.export||"default",l=r[a];if(typeof l!="function")throw new Error(`\u6A21\u5757 ${e.module} \u672A\u5BFC\u51FA\u51FD\u6570 ${a}`);const E=typeof e.timeoutMs=="number"&&e.timeoutMs>0?e.timeoutMs:h;let u;const y=Promise.resolve().then(()=>l(n,{agentId:s,signal:i?.signal,pluginRoot:o.dir,config:v(o,s)}));try{return await Promise.race([y,new Promise((c,d)=>{u=setTimeout(()=>d(new Error(`\u63D2\u4EF6\u6A21\u5757\u6267\u884C\u8D85\u65F6(${E}ms)`)),E)})])}finally{clearTimeout(u)}}function v(o,e){const n={};for(const s of o.userConfig??[]){if(!s||typeof s.key!="string")continue;const i=e?A(e)[s.key]:void 0,t=i!==void 0&&i.length>0?i:process.env[s.key];typeof t=="string"&&t.length>0&&(n[s.key]=t)}for(const[s,i]of Object.entries(o.configValues))typeof i=="string"&&i.length>0&&(n[s]=i);return n}function U(o,e){const n={};for(const t of["PATH","HOME","USERPROFILE","SystemRoot","COMSPEC","TEMP","TMP","LANG","TZ"]){const r=process.env[t];r!==void 0&&(n[t]=r)}n.ACODE_PLUGIN_ROOT=o.dir,n.ACODE_AGENT_ID=e,n.ACODE_PLUGIN_NAME=o.name;const s=new Set((o.userConfig??[]).map(t=>t.key)),i=v(o,e);for(const[t,r]of Object.entries(i))s.has(t)&&(!D.test(t)||k.has(t.toUpperCase())||(n[t]=r));return n}export{U as buildPluginEnv,Y as executeHandler,v as resolveEffectiveConfigValues};
 

package/dist/services/plugin-listener-runner.js

@@ -1,8 +1,8 @@
-import{spawn as $}from"node:child_process";import{createLogger as R}from"../utils/logger.js";import{buildPluginEnv as S}from"./plugin-handler-adapter.js";import{getPath as E,isRecord as _,renderCommandArgv as w,renderTemplate as A,safeStableStringify as b,truncate as h}from"./plugin-manifest.js";const I=R("plugin-manager"),L=200,T=256*1024,M=4*1024,y=6e4,x=6e4;function p(g,n){g.logs.push(`${new Date().toISOString()} ${n}`),g.logs.length>L&&g.logs.shift()}class J{ensureRunning(n){for(const t of n.plugins.values())if(t.enabled)for(const e of t.runtimes)!e.child&&!e.timer&&!e.backoffTimer&&!e.stopping&&this.start(n,t,e)}startAll(n,t){for(const e of t.runtimes)this.stop(e),t.enabled&&this.start(n,t,e)}stopAll(n){for(const t of n.runtimes)this.stop(t)}start(n,t,e){const r=e.def.transport??{type:"command-stream"};if(r.type==="http-callback"){e.stopping=!1;return}if(r.type==="poll-command"){const s=Math.max(5e3,r.intervalMs??3e4);e.stopping=!1,e.timer=setInterval(()=>{this.pollOnce(n,t,e)},s),this.pollOnce(n,t,e);return}if(!r.command){e.lastError="command-stream \u7F3A\u5C11 command",p(e,`ERROR ${e.lastError}`);return}e.stopping=!1,this.spawnChild(n,t,e)}spawnChild(n,t,e){const s=e.def.transport?.command??"",d=w(s,{});try{p(e,`spawn: ${d.join(" ")}`);const i=$(d[0],d.slice(1),{cwd:t.dir,env:S(t,n.agentId),shell:!1,windowsHide:!0,stdio:["ignore","pipe","pipe"]});e.child=i,e.lastError=void 0;let o="";i.stdout?.on("data",a=>{o+=a.toString("utf8");let l=o.indexOf(`
+import{spawn as y}from"node:child_process";import{createLogger as R}from"../utils/logger.js";import{buildPluginEnv as S}from"./plugin-handler-adapter.js";import{getPath as E,isRecord as _,renderCommandArgv as w,renderTemplate as A,safeStableStringify as b,truncate as h}from"./plugin-manifest.js";const P=R("plugin-manager"),I=200,T=256*1024,L=4*1024,v=6e4,M=6e4;function p(g,n){g.logs.push(`${new Date().toISOString()} ${n}`),g.logs.length>I&&g.logs.shift()}class J{ensureRunning(n){for(const t of n.plugins.values())if(t.enabled)for(const e of t.runtimes)!e.child&&!e.timer&&!e.backoffTimer&&!e.stopping&&this.start(n,t,e)}startAll(n,t){for(const e of t.runtimes)this.stop(e),t.enabled&&this.start(n,t,e)}stopAll(n){for(const t of n.runtimes)this.stop(t)}start(n,t,e){const i=e.def.transport??{type:"command-stream"};if(i.type==="http-callback"){e.stopping=!1;return}if(i.type==="poll-command"){const s=Math.max(5e3,i.intervalMs??3e4);e.stopping=!1,e.timer=setInterval(()=>{this.pollOnce(n,t,e)},s),this.pollOnce(n,t,e);return}if(!i.command){e.lastError="command-stream \u7F3A\u5C11 command",p(e,`ERROR ${e.lastError}`);return}e.stopping=!1,this.spawnChild(n,t,e)}spawnChild(n,t,e){const s=e.def.transport?.command??"",d=w(s,{});try{p(e,`spawn: ${d.join(" ")}`);const r=y(d[0],d.slice(1),{cwd:t.dir,env:S(t,n.agentId),shell:!1,windowsHide:!0,stdio:["ignore","pipe","pipe"]});e.child=r,e.lastError=void 0;let o="";r.stdout?.on("data",a=>{o+=a.toString("utf8");let l=o.indexOf(`
 `);for(;l>=0;){const f=o.slice(0,l).trim();o=o.slice(l+1),f&&this.handleLine(n,t,e,f),l=o.indexOf(`
-`)}o.length>1024*1024&&(o=o.slice(-4096))}),i.stderr?.on("data",a=>{p(e,`stderr: ${h(a.toString("utf8").trimEnd(),400)}`)}),i.on("error",a=>{e.lastError=`\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${a.message}`,p(e,`ERROR ${e.lastError}`)}),i.on("close",a=>{e.child=void 0,!e.stopping&&(e.lastError=`\u76D1\u542C\u8FDB\u7A0B\u9000\u51FA\uFF08code=${a??"signal"}\uFF09`,p(e,`exit code=${a??"signal"}\uFF0C\u51C6\u5907\u91CD\u542F`),this.scheduleRestart(n,t,e))})}catch(i){const o=i instanceof Error?i.message:String(i);e.lastError=o,p(e,`ERROR spawn: ${o}`),this.scheduleRestart(n,t,e)}}scheduleRestart(n,t,e){if(e.stopping)return;const r=Math.max(500,e.def.transport?.restartBackoffMs??2e3),s=Math.min(x,r*2**Math.min(e.restarts,6));e.restarts++,p(e,`restart #${e.restarts} in ${s}ms`),e.backoffTimer=setTimeout(()=>{e.backoffTimer=void 0,e.stopping||this.spawnChild(n,t,e)},s)}async pollOnce(n,t,e){if(e.polling)return;const r=e.def.transport?.command??"",s=w(r,{});if(s.length===0)return;e.polling=!0;const d=new AbortController,i=setTimeout(()=>d.abort(),y);try{const o=await new Promise((a,l)=>{const f=$(s[0],s.slice(1),{cwd:t.dir,env:S(t,n.agentId),shell:!1,windowsHide:!0,stdio:["ignore","pipe","pipe"],signal:d.signal});let c="",u="";f.stdout?.on("data",m=>{c.length<T&&(c+=m.toString("utf8"))}),f.stderr?.on("data",m=>{u.length<T&&(u+=m.toString("utf8"))});const v=()=>d.signal.aborted;f.on("error",m=>{l(v()?new Error(`poll \u8D85\u65F6(${y}ms)`):m)}),f.on("close",m=>{v()?l(new Error(`poll \u8D85\u65F6(${y}ms)`)):m===0?a(c):l(new Error(`exit ${m}: ${h(u||c,300)}`))})});e.lastError=void 0;for(const a of o.split(`
-`)){const l=a.trim();l&&this.handleLine(n,t,e,l)}}catch(o){const a=o instanceof Error?o.message:String(o);e.lastError=a,p(e,`poll \u5931\u8D25: ${a}`)}finally{clearTimeout(i),e.polling=!1}}stop(n){if(n.stopping=!0,n.restarts=0,n.child){try{n.child.kill()}catch{}n.child=void 0}n.timer&&(clearInterval(n.timer),n.timer=void 0),n.backoffTimer&&(clearTimeout(n.backoffTimer),n.backoffTimer=void 0)}handleLine(n,t,e,r){p(e,`event: ${h(r,300)}`);let s;try{s=JSON.parse(r)}catch{e.lastError="\u4E8B\u4EF6\u884C\u4E0D\u662F\u5408\u6CD5 JSON\uFF08\u8981\u6C42 JSONL\uFF09";return}if(!_(s))return;const d=typeof s.event=="string"?s.event:e.def.event,i=d===e.def.event?e.def:t.listeners.find(o=>o.event===d);i&&(i.delivery&&i.delivery!=="poll"&&I.debug("[plugin:%s] delivery=%s \u6682\u6309 poll \u4EA4\u4ED8",t.name,i.delivery),this.enqueue(n,t,i,s))}enqueue(n,t,e,r){for(const[c,u]of Object.entries(e.matcher??{})){const v=E(r,c);if(!(Array.isArray(u)?u:[u]).some(O=>JSON.stringify(O)===JSON.stringify(v)))return}let s;if(e.dedupKey){const c=E(r,e.dedupKey);c!=null&&(s=h(String(c),256))}n.eventSeq++;const d=h(b(r.data??r),M),i=e.summary?A(e.summary,r):e.description??"",o=(e.toolHints??[]).join(","),a=`[plugin:${t.name}] ${e.event}`+(i?`
-${i}`:"")+(o?`
+`)}o.length>1024*1024&&(o=o.slice(-4096))}),r.stderr?.on("data",a=>{p(e,`stderr: ${h(a.toString("utf8").trimEnd(),400)}`)}),r.on("error",a=>{e.lastError=`\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${a.message}`,p(e,`ERROR ${e.lastError}`)}),r.on("close",a=>{e.child=void 0,!e.stopping&&(e.lastError=`\u76D1\u542C\u8FDB\u7A0B\u9000\u51FA\uFF08code=${a??"signal"}\uFF09`,p(e,`exit code=${a??"signal"}\uFF0C\u51C6\u5907\u91CD\u542F`),this.scheduleRestart(n,t,e))})}catch(r){const o=r instanceof Error?r.message:String(r);e.lastError=o,p(e,`ERROR spawn: ${o}`),this.scheduleRestart(n,t,e)}}scheduleRestart(n,t,e){if(e.stopping)return;const i=Math.max(500,e.def.transport?.restartBackoffMs??2e3),s=Math.min(M,i*2**Math.min(e.restarts,6));e.restarts++,p(e,`restart #${e.restarts} in ${s}ms`),e.backoffTimer=setTimeout(()=>{e.backoffTimer=void 0,e.stopping||this.spawnChild(n,t,e)},s)}async pollOnce(n,t,e){if(e.polling)return;const i=e.def.transport?.command??"",s=w(i,{});if(s.length===0)return;e.polling=!0;const d=new AbortController,r=setTimeout(()=>d.abort(),v);try{const o=await new Promise((a,l)=>{const f=y(s[0],s.slice(1),{cwd:t.dir,env:S(t,n.agentId),shell:!1,windowsHide:!0,stdio:["ignore","pipe","pipe"],signal:d.signal});let c="",u="";f.stdout?.on("data",m=>{c.length<T&&(c+=m.toString("utf8"))}),f.stderr?.on("data",m=>{u.length<T&&(u+=m.toString("utf8"))});const $=()=>d.signal.aborted;f.on("error",m=>{l($()?new Error(`poll \u8D85\u65F6(${v}ms)`):m)}),f.on("close",m=>{$()?l(new Error(`poll \u8D85\u65F6(${v}ms)`)):m===0?a(c):l(new Error(`exit ${m}: ${h(u||c,300)}`))})});e.lastError=void 0;for(const a of o.split(`
+`)){const l=a.trim();l&&this.handleLine(n,t,e,l)}}catch(o){const a=o instanceof Error?o.message:String(o);e.lastError=a,p(e,`poll \u5931\u8D25: ${a}`)}finally{clearTimeout(r),e.polling=!1}}stop(n){if(n.stopping=!0,n.restarts=0,n.child){try{n.child.kill()}catch{}n.child=void 0}n.timer&&(clearInterval(n.timer),n.timer=void 0),n.backoffTimer&&(clearTimeout(n.backoffTimer),n.backoffTimer=void 0)}handleLine(n,t,e,i){p(e,`event: ${h(i,300)}`);let s;try{s=JSON.parse(i)}catch{e.lastError="\u4E8B\u4EF6\u884C\u4E0D\u662F\u5408\u6CD5 JSON\uFF08\u8981\u6C42 JSONL\uFF09";return}if(!_(s))return;const d=typeof s.event=="string"?s.event:e.def.event,r=d===e.def.event?e.def:t.listeners.find(o=>o.event===d);r&&this.enqueue(n,t,r,s)}enqueue(n,t,e,i){for(const[c,u]of Object.entries(e.matcher??{})){const $=E(i,c);if(!(Array.isArray(u)?u:[u]).some(O=>JSON.stringify(O)===JSON.stringify($)))return}let s;if(e.dedupKey){const c=E(i,e.dedupKey);c!=null&&(s=h(String(c),256))}n.eventSeq++;const d=h(b(i.data??i),L),r=e.summary?A(e.summary,i):e.description??"",o=(e.toolHints??[]).join(","),a=`[plugin:${t.name}] ${e.event}`+(r?`
+${r}`:"")+(o?`
 toolHints=${o}`:"")+`
 payload=${d}`,l={msgId:h(s?`plugin-event-${t.name}-${s}`:`plugin-event-${t.name}-${e.event}-${n.eventSeq}`,512),channel:"plugin-event",senderId:`plugin:${t.name}`,senderName:`\u63D2\u4EF6[${t.name}]`,receiverId:n.agentId||void 0,content:a,requireReply:!1,role:"system",timestamp:new Date().toISOString()},f=e.priority??"normal";n.buffer.push({plugin:t.name,event:e.event,priority:f,dedupKey:s,receivedAt:Date.now(),message:l})}}export{J as ListenerRunner};
 

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

@@ -13,6 +13,7 @@
 
 import type { PluginSummary } from "@agentswork/acode";
 import { type PluginManifest, type PluginToolDef } from "./plugin-manifest.js";
+import type { PluginUiSummary } from "@agentswork/acode";
 import type { LoadedPlugin } from "./plugin-runtime.js";
 export type ManifestReadResult = {
     ok: true;
@@ -44,4 +45,9 @@ export declare class PluginLoader {
 
 export declare function requiredParamsOf(tool: PluginToolDef): string[] | undefined;
 
-export declare function toSummary(plugin: LoadedPlugin): PluginSummary;
+
+
+
+export declare function toFrontendSummary(plugin: LoadedPlugin): PluginUiSummary | undefined;
+
+export declare function toSummary(plugin: LoadedPlugin, agentId?: string): PluginSummary;

package/dist/services/plugin-loader.js

@@ -1,2 +1,2 @@
-import{existsSync as A,readFileSync as S}from"node:fs";import{join as p}from"node:path";import{isRecord as b,validateListenerDef as j,validateManifest as J,validateToolDef as R}from"./plugin-manifest.js";class O{constructor(){this.importNonce=0}readJsonFile(t){if(!A(t))return{ok:!0,data:{}};try{const n=JSON.parse(S(t,"utf8"));return b(n)?{ok:!0,data:n}:{ok:!1,error:`${t}: \u6839\u8282\u70B9\u987B\u4E3A\u5BF9\u8C61`}}catch(n){const i=n instanceof Error?n.message:String(n);return{ok:!1,error:`${t}: JSON \u89E3\u6790\u5931\u8D25: ${i}`}}}loadManifestOnly(t){const n=this.readJsonFile(p(t,"plugin.json"));if(!n.ok)return n;const i=n.data,a=J(i);return a?{ok:!1,error:a}:{ok:!0,manifest:i}}validateUserConfigValues(t,n){const i=Array.isArray(t.userConfig)?t.userConfig:[],a={...n};for(const e of i){if(!e||typeof e.key!="string"||!/^[A-Za-z_][A-Za-z0-9_]*$/.test(e.key))return"plugin.json: userConfig.key \u975E\u6CD5\uFF08\u987B\u4E3A\u73AF\u5883\u53D8\u91CF\u540D\uFF09";if(!(typeof a[e.key]=="string"&&a[e.key].length>0)&&e.required){const f=e.default!==void 0&&typeof e.default=="string"?e.default:"";if(!f)return`\u7F3A\u5C11\u5FC5\u9700\u914D\u7F6E ${e.key}${e.description?`\uFF08${e.description}\uFF09`:""}\uFF0C\u5B89\u88C5\u65F6\u8BF7\u5728 config \u4E2D\u63D0\u4F9B`;a[e.key]=f}}return null}loadPluginFromDir(t,n,i,a){const e=this.loadManifestOnly(t);if(!e.ok)return e;const s=e.manifest,f=p(t,s.tools??"tools/tools.json"),u=this.readJsonFile(f);if(!u.ok)return u;const g=[],C=Array.isArray(u.data.tools)?u.data.tools:[];for(const r of C){const l=R(r);if(l)return{ok:!1,error:`${s.tools??"tools/tools.json"}: ${l}`};g.push(r)}const $=p(t,s.listeners??"listeners/listeners.json"),c=this.readJsonFile($);if(!c.ok)return c;const m=[],F=Array.isArray(c.data.listeners)?c.data.listeners:[];for(const r of F){const l=j(r);if(l)return{ok:!1,error:`${s.listeners??"listeners/listeners.json"}: ${l}`};m.push(r)}const k=Array.isArray(s.userConfig)?s.userConfig:[],h=this.validateUserConfigValues(s,a);if(h)return{ok:!1,error:h};const d={...a};for(const r of k){if(!r||typeof r.key!="string")continue;!(typeof d[r.key]=="string"&&d[r.key].length>0)&&r.required&&r.default!==void 0&&typeof r.default=="string"&&(d[r.key]=r.default)}const y=s.commands;let v;if(typeof y=="string"&&y.trim()){const r=p(t,y.trim());A(r)&&(v=r)}return{ok:!0,plugin:{name:s.name,version:typeof s.version=="string"?s.version:void 0,description:typeof s.description=="string"?s.description:void 0,source:n,installedAt:i,dir:t,enabled:!0,tools:g,listeners:m,commandDir:v,userConfig:k,configValues:d,status:"enabled",runtimes:m.map(r=>({def:r,stopping:!1,restarts:0,logs:[]})),moduleCache:new Map,importNonce:++this.importNonce}}}}function w(o){const t=o.inputSchema;if(!(!t||!Array.isArray(t.required)))return t.required.filter(n=>typeof n=="string")}function x(o){const t=e=>!!(e.child||e.timer)||e.def.transport?.type==="http-callback",n=e=>o.enabled?t(e)?"running":e.stopping?"stopped":"pending":"stopped",i=o.runtimes.map(e=>{const s=n(e);return{event:e.def.event,delivery:e.def.delivery??"poll",running:s==="running",state:s,error:e.lastError}}),a=i.some(e=>e.state==="running")?"running":i.some(e=>e.state==="pending")?"pending":"stopped";return{name:o.name,version:o.version,description:o.description,status:o.status,enabled:o.enabled,source:o.source,installedAt:o.installedAt,toolCount:o.tools.length,tools:o.tools.map(e=>({name:e.name,title:e.title,description:e.description})),listeners:i,running:a==="running",listenerState:a,error:o.error}}export{O as PluginLoader,w as requiredParamsOf,x as toSummary};
+import{existsSync as C,readFileSync as F}from"node:fs";import{join as k}from"node:path";import{isRecord as V,validateListenerDef as b,validateManifest as I,validateToolDef as M,PLUGIN_UI_BUILTIN_ICONS as N}from"./plugin-manifest.js";import{getPanelEnvVars as R}from"./panel-env.js";class L{constructor(){this.importNonce=0}readJsonFile(e){if(!C(e))return{ok:!0,data:{}};try{const r=JSON.parse(F(e,"utf8"));return V(r)?{ok:!0,data:r}:{ok:!1,error:`${e}: \u6839\u8282\u70B9\u987B\u4E3A\u5BF9\u8C61`}}catch(r){const u=r instanceof Error?r.message:String(r);return{ok:!1,error:`${e}: JSON \u89E3\u6790\u5931\u8D25: ${u}`}}}loadManifestOnly(e){const r=this.readJsonFile(k(e,"plugin.json"));if(!r.ok)return r;const u=I(r.data);return u?{ok:!1,error:u}:{ok:!0,manifest:r.data}}validateUserConfigValues(e,r){const u=Array.isArray(e.userConfig)?e.userConfig:[],a={...r};for(const o of u){if(!o||typeof o.key!="string"||!/^[A-Za-z_][A-Za-z0-9_]*$/.test(o.key))return"plugin.json: userConfig.key \u975E\u6CD5\uFF08\u987B\u4E3A\u73AF\u5883\u53D8\u91CF\u540D\uFF09";if(!(typeof a[o.key]=="string"&&a[o.key].length>0)&&o.required){const y=o.default!==void 0&&typeof o.default=="string"?o.default:"";if(!y)return`\u7F3A\u5C11\u5FC5\u9700\u914D\u7F6E ${o.key}${o.description?`\uFF08${o.description}\uFF09`:""}\uFF0C\u5B89\u88C5\u65F6\u8BF7\u5728 config \u4E2D\u63D0\u4F9B`;a[o.key]=y}}return null}loadPluginFromDir(e,r,u,a){const o=this.loadManifestOnly(e);if(!o.ok)return o;const i=o.manifest,y=k(e,i.tools??"tools/tools.json"),c=this.readJsonFile(y);if(!c.ok)return c;const p=[],t=Array.isArray(c.data.tools)?c.data.tools:[];for(const n of t){const l=M(n);if(l)return{ok:!1,error:`${i.tools??"tools/tools.json"}: ${l}`};p.push(n)}const d=k(e,i.listeners??"listeners/listeners.json"),m=this.readJsonFile(d);if(!m.ok)return m;const g=[],S=Array.isArray(m.data.listeners)?m.data.listeners:[];for(const n of S){const l=b(n);if(l)return{ok:!1,error:`${i.listeners??"listeners/listeners.json"}: ${l}`};g.push(n)}const h=Array.isArray(i.userConfig)?i.userConfig:[],$=this.validateUserConfigValues(i,a);if($)return{ok:!1,error:$};const v={...a};for(const n of h){if(!n||typeof n.key!="string")continue;!(typeof v[n.key]=="string"&&v[n.key].length>0)&&n.required&&n.default!==void 0&&typeof n.default=="string"&&(v[n.key]=n.default)}const j=new Set(h.filter(n=>n&&typeof n.key=="string"&&typeof a[n.key]=="string"&&a[n.key].length>0).map(n=>n.key)),w=i.commands;let A;if(typeof w=="string"&&w.trim()){const n=k(e,w.trim());C(n)&&(A=n)}const f=i.ui;if(f){const n=new Set(p.map(l=>l.name));if(f.status&&!n.has(f.status.tool))return{ok:!1,error:`plugin.json: ui.status.tool "${f.status.tool}" \u4E0D\u5728\u672C\u63D2\u4EF6 tools \u5B9A\u4E49\u4E2D`};for(const l of f.view?.invoke??[])if(!n.has(l))return{ok:!1,error:`plugin.json: ui.view.invoke \u5F15\u7528\u7684\u5DE5\u5177 "${l}" \u4E0D\u5728\u672C\u63D2\u4EF6 tools \u5B9A\u4E49\u4E2D`};if(f.view&&!C(k(e,f.view.entry)))return{ok:!1,error:`plugin.json: ui.view.entry \u6587\u4EF6\u4E0D\u5B58\u5728: ${f.view.entry}`}}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:r,installedAt:u,dir:e,enabled:!0,tools:p,listeners:g,commandDir:A,ui:f,userConfig:h,configValues:v,configuredKeys:j,status:"enabled",runtimes:g.map(n=>({def:n,stopping:!1,restarts:0,logs:[]})),moduleCache:new Map,importNonce:++this.importNonce}}}}function P(s){const e=s.inputSchema;if(!(!e||!Array.isArray(e.required)))return e.required.filter(r=>typeof r=="string")}function q(s){const e=s.ui;if(!e)return;const r=e.icon?N.includes(e.icon)?`builtin:${e.icon}`:e.icon:void 0,u=e.status?{tool:e.status.tool,persistent:e.status.persistent===!0,...e.status.hideWhenZero===!0?{hideWhenZero:!0}:{},pollIntervalMs:typeof e.status.pollIntervalMs=="number"&&e.status.pollIntervalMs>=5e3&&e.status.pollIntervalMs<=3e5?e.status.pollIntervalMs:3e4,...e.status.title?{title:e.status.title}:{}}:void 0,a=e.view?{entry:e.view.entry,title:e.view.title,invoke:[...e.view.invoke??[]],...e.view.defaultRoute?{defaultRoute:e.view.defaultRoute}:{}}:void 0;if(!(!u&&!a))return{...r?{icon:r}:{},...u?{status:u}:{},...a?{view:a}:{}}}function U(s,e){const r=t=>!!(t.child||t.timer)||t.def.transport?.type==="http-callback",u=t=>s.enabled?r(t)?"running":t.stopping?"stopped":"pending":"stopped",a=s.runtimes.map(t=>{const d=u(t);return{event:t.def.event,delivery:t.def.delivery??"poll",running:d==="running",state:d,error:t.lastError}}),o=a.some(t=>t.state==="running")?"running":a.some(t=>t.state==="pending")?"pending":"stopped",i=q(s),y=s.configuredKeys??new Set,c=e?R(e):{},p=(s.userConfig??[]).map(t=>{const d=typeof c[t.key]=="string"&&c[t.key].length>0?c[t.key]:typeof process.env[t.key]=="string"&&(process.env[t.key]??"").length>0?process.env[t.key]:void 0,m=y.has(t.key)?"json":d!==void 0?"env":"default",g=typeof s.configValues[t.key]=="string"&&s.configValues[t.key].length>0?s.configValues[t.key]:d!==void 0?d:typeof t.default=="string"?t.default:"";return{key:t.key,...t.description?{description:t.description}:{},...t.required?{required:!0}:{},...t.sensitive?{sensitive:!0}:{},source:m,...g.length>0?{value:g}:{}}});return{name:s.name,version:s.version,description:s.description,status:s.status,enabled:s.enabled,source:s.source,installedAt:s.installedAt,toolCount:s.tools.length,tools:s.tools.map(t=>({name:t.name,title:t.title,description:t.description})),listeners:a,running:o==="running",listenerState:o,error:s.error,...i?{frontend:i}:{},...p.length>0?{userConfig:p}:{}}}export{L as PluginLoader,P as requiredParamsOf,q as toFrontendSummary,U as toSummary};
 

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

@@ -17,11 +17,11 @@
 
 
 
+
 
 import { type ACodeCommandSpec, type ACodePluginBridge, type PluginInvokeContext, type PluginManageRequest, type PluginManageResult, type PluginSummary, type PluginToolInvocationResult, type PluginToolSchema, type JsonObject } from "@agentswork/acode";
 import { type PluginEventMessage } from "./plugin-event-buffer.js";
-export { isValidPluginName, validateManifest, validateAgainstSchema, renderCommandArgv, } from "./plugin-manifest.js";
-export type { PluginUserConfigField, PluginHandlerDef, PluginToolDef, PluginTransportDef, PluginListenerDef, PluginManifest, } from "./plugin-manifest.js";
+import type { AgentState } from "./plugin-runtime.js";
 import { type UserScope } from "./user-scope.js";
 export type { ListenerRuntime, LoadedPlugin, InstalledRecord, AgentState, SharedPluginEntry, } from "./plugin-runtime.js";
 export interface PluginManagerOptions {
@@ -29,14 +29,11 @@ export interface PluginManagerOptions {
     rootDir?: string;
     
     runtimeRootDir?: string;
-    
-    legacyRootDir?: string;
 }
 export declare class PluginManager {
     private agents;
     private readonly rootDir?;
     private readonly runtimeRootDir?;
-    private readonly legacyRootDir?;
     
     private readonly deployStores;
     
@@ -45,18 +42,17 @@ export declare class PluginManager {
     private readonly loader;
     constructor(options?: PluginManagerOptions);
     
-
-
-
     private deployForScope;
     
+    private resolveDeployStore;
+    
+    private deployStagingRoot;
+    
 
 
 
     private deployForAgent;
     
-    private get deploy();
-    
 
 
 
@@ -65,6 +61,17 @@ export declare class PluginManager {
     forAgent(agentId: string): ACodePluginBridge;
     
     setOnPluginsChanged(cb: (agentId: string) => void): void;
+    
+
+
+
+    getEnabledPluginDir(agentId: string, pluginName: string): Promise<string | null>;
+    
+
+
+
+
+    hydrateForAdmin(agentId: string): Promise<AgentState>;
     private onPluginsChanged?;
     private notifyPluginsChanged;
     
@@ -203,6 +210,18 @@ export declare class PluginManager {
     private stopAllListeners;
     
     private enqueueEvent;
+    
+
+
+
+
+
+
+
+
+
+
+    updatePluginConfig(agentId: string, pluginName: string, configPatch: Record<string, unknown>): Promise<PluginManageResult>;
     getLogs(agentId: string, pluginName: string): Promise<{
         ok: boolean;
         error?: string;
@@ -215,7 +234,7 @@ export declare class PluginManager {
     
 
 
-    listDeployed(scope?: UserScope): Promise<Array<{
+    listDeployed(scope: UserScope): Promise<Array<{
         pluginName: string;
         version?: string;
         fileName: string;
@@ -229,7 +248,8 @@ export declare class PluginManager {
 
 
 
-    removeDeployedPlugin(pluginName: string, scope?: UserScope): Promise<{
+
+    removeDeployedPlugin(pluginName: string, scope: UserScope): Promise<{
         ok: boolean;
         error?: string;
     }>;

package/dist/services/plugin-manager.js

@@ -1,5 +1,5 @@
-import{existsSync as y,mkdirSync as $,readFileSync as S,readdirSync as E,rmSync as O,writeFileSync as N}from"node:fs";import{dirname as L,join as f}from"node:path";import{parseAcodeCommandMarkdown as j}from"@agentswork/acode";import{getBridgeTemplatePluginsDir as k}from"../config.js";import{sanitizeAgentId as P,downloadPluginZip as T,sanitizeArchiveFileName as x}from"../utils/file-utils.js";import{createLogger as z}from"../utils/logger.js";import{getAgentOwner as w}from"./agent-ownership.js";import{setDeployedDefaultsProvider as q,reconcileDefaultsFromDeployed as _}from"./capability-config.js";import{isCapabilityEnabled as V,getAgentPluginSources as H}from"./instance-features.js";import{PluginDeploymentStore as A}from"./plugin-deployment.js";import{PluginEventBuffer as J}from"./plugin-event-buffer.js";import{movePluginDir as C,rmWithRetry as I}from"./plugin-fs.js";import{executeHandler as K}from"./plugin-handler-adapter.js";import{ListenerRunner as W}from"./plugin-listener-runner.js";import{PluginLoader as U,toSummary as D}from"./plugin-loader.js";import{isRecord as F,isValidPluginName as Z,validateAgainstSchema as Q}from"./plugin-manifest.js";import{extractPluginZip as M}from"./plugin-package.js";const d=z("plugin-manager");import{isValidPluginName as De,validateManifest as ve,validateAgainstSchema as ke,renderCommandArgv as Pe}from"./plugin-manifest.js";import{getUserPluginsDir as R,isLegacyFallbackDisabled as B}from"./user-scope.js";class G{constructor(e={}){this.agents=new Map,this.deployStores=new Map,this.listeners=new W,this.loader=new U,this.templatePullInFlight=new Set,this.backgroundTemplatePulls=new Set,this.rootDir=e.rootDir,this.runtimeRootDir=e.runtimeRootDir,this.legacyRootDir=e.legacyRootDir}deployForScope(e){const t=this.rootDir??R(e),s=`scope:${t}`;let n=this.deployStores.get(s);return n||(n=new A(t,this.runtimeRootDir,this.loader,this.legacyRootDir??(B()?void 0:k())),this.deployStores.set(s,n)),n}deployForAgent(e){if(this.rootDir){const r="__injected__";let i=this.deployStores.get(r);return i||(i=new A(this.rootDir,this.runtimeRootDir,this.loader,this.legacyRootDir),this.deployStores.set(r,i)),i}const t=w(e);if(t)return this.deployForScope(t);const s="__legacy__";let n=this.deployStores.get(s);return n||(n=new A(k(),this.runtimeRootDir,this.loader),this.deployStores.set(s,n)),n}get deploy(){const e="__legacy__";let t=this.deployStores.get(e);return t||(t=new A(this.rootDir??k(),this.runtimeRootDir,this.loader),this.deployStores.set(e,t)),t}dataRootForAgent(e){if(this.rootDir)return this.rootDir;const t=w(e);return t?R(t):k()}forAgent(e){return{listPlugins:()=>this.list(e),getPluginTools:t=>this.getPluginTools(e,t),invokeTool:(t,s,n,r)=>this.invokeTool(e,t,s,n,r),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(s=>s.enabled&&s.commandDir).map(s=>s.commandDir)}async getPluginCommands(e){const t=await this.hydrate(e),s=[];for(const n of t.plugins.values())!n.enabled||!n.commandDir||s.push(...this.parsePluginCommandDir(n));return s}parsePluginCommandDir(e){return this.parseCommandDir(e.name,e.commandDir)}parseCommandDir(e,t){const s=[];if(!t)return s;try{for(const n of E(t)){if(!n.endsWith(".md"))continue;const r=f(t,n);try{const i=j(r,S(r,"utf8"));i.plugin=e,s.push(i)}catch(i){d.warn("[plugin:%s] \u547D\u4EE4\u89E3\u6790\u5931\u8D25 %s: %s",e,n,i instanceof Error?i.message:String(i))}}}catch{}return s}async list(e){const t=await this.hydrate(e),s=new Map;for(const r of t.plugins.values()){const i=D(r);s.set(i.name,i)}const n=this.deployForAgent(e);for(const r of n.readSharedManifest()){const i=r.pluginName;if(!n.deployedPluginHealthy(i))continue;const o=s.get(i);if(o){String(o.source||"").startsWith("shared:")&&(o.enabled=this.effectiveSharedEnabled(e,r));continue}s.set(i,{name:i,version:this.deployedPluginVersion(e,i),status:"enabled",enabled:this.effectiveSharedEnabled(e,r),source:`shared:${r.fileName??`${i}.zip`}`,installedAt:new Date().toISOString(),toolCount:0,listeners:[]})}return[...s.values()].sort((r,i)=>r.name.localeCompare(i.name))}deployedPluginVersion(e,t){try{const s=this.deployForAgent(e).resolveDeployedSourceDir(t);if(!s)return;const n=JSON.parse(S(f(s,"plugin.json"),"utf8"));return typeof n.version=="string"?n.version:void 0}catch{return}}async getPluginTools(e,t){const n=(await this.hydrate(e)).plugins.get(t);return!n||!n.enabled?[]:n.tools.map(r=>({plugin:n.name,name:r.name,title:r.title,description:r.description,inputSchema:r.inputSchema??{type:"object",properties:{}}}))}async debugMountPlugin(e,t,s={}){const n=String(t??"").trim();if(!n)return{ok:!1,error:"\u63D2\u4EF6\u76EE\u5F55\u4E0D\u80FD\u4E3A\u7A7A"};if(!y(n))return{ok:!1,error:`\u63D2\u4EF6\u76EE\u5F55\u4E0D\u5B58\u5728: ${n}`};const r=this.loader.loadManifestOnly(n);if(!r.ok)return r;const i=r.manifest.name,l=this.agentState(e),o=l.queue.then(async()=>{const a=await this.hydrate(e),u=a.plugins.get(i);u&&this.stopAllListeners(u);const g=this.loader.loadPluginFromDir(n,`debug:${n}`,new Date().toISOString(),s);if(!g.ok)return u&&this.startAllListeners(a,u),{ok:!1,error:`\u8C03\u8BD5\u6302\u8F7D\u5931\u8D25: ${g.error}`};const c=g.plugin;return c.debug=!0,a.plugins.set(c.name,c),this.startAllListeners(a,c),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u8C03\u8BD5\u6302\u8F7D: %s@%s\uFF08dir=%s\uFF09",a.agentId,c.name,c.version??"?",n),this.notifyPluginsChanged(a.agentId),{ok:!0,summary:D(c)}});return l.queue=o.catch(()=>{}),o}async listDebugPlugins(e){return[...(await this.hydrate(e)).plugins.values()].filter(s=>s.debug===!0).map(s=>D(s))}async debugPluginNames(e){return[...(await this.hydrate(e)).plugins.values()].filter(s=>s.debug===!0).map(s=>s.name)}async invokeTool(e,t,s,n,r){const i=await this.hydrate(e),l=i.plugins.get(t);if(!l)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5\uFF08\u53EF\u7528\u63D2\u4EF6: ${[...i.plugins.keys()].join(", ")||"\u65E0"}\uFF09`};if(!l.enabled)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u5DF2\u505C\u7528\uFF0C\u8BF7\u8BA9\u7528\u6237\u5728\u9762\u677F\u542F\u7528`};const o=l.tools.find(a=>a.name===s);if(!o)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u65E0\u5DE5\u5177 ${s}\uFF08\u53EF\u7528: ${l.tools.map(a=>a.name).join(", ")||"\u65E0"}\uFF09`};if(o.inputSchema){const a=Q(o.inputSchema,n);if(a.length>0)return{ok:!1,error:`\u53C2\u6570\u6821\u9A8C\u5931\u8D25: ${a.join("; ")}`,inputSchema:o.inputSchema}}return K(e,l,o,n,r)}async manage(e,t){const s=this.agentState(e),n=s.queue.then(async()=>{const r=await this.hydrate(e);return this.doManage(r,t)});return s.queue=n.catch(()=>{}),n}async doManage(e,t){switch(t.action){case"list":return{ok:!0,plugins:await this.list(e.agentId)};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 s=(t.source??"").trim();if(!s)return{ok:!1,error:"install \u9700\u8981 source\uFF08\u5F53\u524D\u652F\u6301 local:<\u63D2\u4EF6\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84>\uFF09"};const n=s.split(":",1)[0];if(n!=="local")return{ok:!1,error:`\u6682\u4E0D\u652F\u6301\u63D2\u4EF6\u6765\u6E90 "${n}:"\uFF08npm:/git: \u5728\u8DEF\u7EBF\u56FE\u4E2D\uFF1Bzip \u5305\u8BF7\u7528\u9762\u677F\u5BFC\u5165\u6216 POST /runtime/plugins/:agentId/upload\uFF09`};const r=s.slice(6).trim();return!r||!y(f(r,"plugin.json"))?{ok:!1,error:`\u63D2\u4EF6\u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u7F3A\u5C11 plugin.json: ${r}`}:this.installFromDirectory(e,r,s,t.config)}async installFromZip(e,t,s,n){if(!t||t.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};const r=this.agentState(e),i=r.queue.then(async()=>{await this.hydrate(e);const l=f(this.dataRootForAgent(e),"tmp",`upload-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const o=await M(t,l);return y(f(o.pluginDir,"plugin.json"))?(d.info("[agent:%s] zip \u5BFC\u5165: %s\uFF08%d \u4E2A\u6587\u4EF6\uFF09",e,s,o.fileCount),await this.installFromDirectory(r,o.pluginDir,`upload:${s}`,n)):{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(o){const a=o instanceof Error?o.message:String(o);return d.warn("[agent:%s] zip \u5BFC\u5165\u5931\u8D25: %s",e,a),{ok:!1,error:`zip \u5BFC\u5165\u5931\u8D25: ${a}`}}finally{await I(l,3,100).catch(()=>{})}});return r.queue=i.catch(()=>{}),i}async installFromDirectory(e,t,s,n){const r=this.loader.loadManifestOnly(t);if(!r.ok)return r;const i=r.manifest,l=i.name,o=this.loader.validateUserConfigValues(i,n??{});if(o)return{ok:!1,error:o};const a=this.loader.loadPluginFromDir(t,s,new Date().toISOString(),n??{});if(!a.ok)return d.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u6821\u9A8C\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,s,a.error),a;const u=f(this.dataRootForAgent(e.agentId),"cache",P(e.agentId),l),g=t===u,c=e.plugins.get(l);if(c&&this.stopAllListeners(c),!g)try{await I(u),await C(t,u)}catch(h){const b=h instanceof Error?h.message:String(h);return d.warn("[agent:%s] \u63D2\u4EF6\u79FB\u52A8\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,s,b),c&&this.startAllListeners(e,c),{ok:!1,error:`\u63D2\u4EF6\u79FB\u52A8\u5931\u8D25: ${b}`}}const m=this.loader.loadPluginFromDir(u,s,new Date().toISOString(),n??{});if(!m.ok){if(d.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,s,m.error),!g)try{await C(u,t)}catch(h){d.warn("[agent:%s] \u88C5\u8F7D\u5931\u8D25\u540E\u65E0\u6CD5\u79FB\u56DE\u6E90\u76EE\u5F55\uFF08%s\uFF09\uFF0C\u5DF2\u4FDD\u7559\u7F13\u5B58\u526F\u672C",e.agentId,h instanceof Error?h.message:String(h))}if(c)try{this.startAllListeners(e,c)}catch(h){d.warn("[agent:%s] \u6062\u590D\u65E7\u5B9E\u4F8B\u76D1\u542C\u5931\u8D25: %s",e.agentId,h instanceof Error?h.message:String(h))}return m}const p=m.plugin;return e.plugins.set(p.name,p),this.persistInstalled(e),this.startAllListeners(e,p),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u5B89\u88C5: %s@%s",e.agentId,p.name,p.version??"?"),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:D(p)}}async uninstallPlugin(e,t){const s=(t.name??"").trim(),n=e.plugins.get(s);if(!n)return{ok:!1,error:`\u63D2\u4EF6 ${s} \u672A\u5B89\u88C5`};this.stopAllListeners(n),e.plugins.delete(s),n.tools.length>0&&this.pushDeprecatedNotice(e,s,"\u5DF2\u88AB\u5378\u8F7D");const r=this.deployForAgent(e.agentId);return r.readSharedManifest().some(l=>l.pluginName===s)&&r.removeRuntimeLink(e.agentId,s),this.persistInstalled(e),n.debug!==!0&&await I(n.dir),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u5378\u8F7D: %s",e.agentId,s),this.notifyPluginsChanged(e.agentId),{ok:!0}}async reloadPlugin(e,t){const s=(t.name??"").trim(),n=e.plugins.get(s);if(!n)return{ok:!1,error:`\u63D2\u4EF6 ${s} \u672A\u5B89\u88C5`};const r=this.loader.loadPluginFromDir(n.dir,n.source,n.installedAt,n.configValues);if(!r.ok)return{ok:!1,error:`\u91CD\u8F7D\u5931\u8D25\uFF08\u4FDD\u7559\u65E7\u7248\u672C\u8FD0\u884C\uFF09: ${r.error}`};const i=r.plugin;return i.debug=n.debug,this.stopAllListeners(n),e.plugins.set(s,i),this.persistInstalled(e),this.startAllListeners(e,i),d.info("[agent:%s] \u63D2\u4EF6\u5DF2\u91CD\u8F7D: %s",e.agentId,s),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:D(i)}}async setEnabled(e,t,s){const n=(t.name??"").trim(),r=e.plugins.get(n);return r?(r.enabled=s,s?this.startAllListeners(e,r):(r.tools.length>0&&this.pushDeprecatedNotice(e,n,"\u5DF2\u505C\u7528"),this.stopAllListeners(r)),this.persistInstalled(e),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:D(r)}):{ok:!1,error:`\u63D2\u4EF6 ${n} \u672A\u5B89\u88C5`}}async saveSharedPlugin(e,t,s=!0,n,r){if(!e||e.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};const i=r?this.deployForScope(r):this.deploy;await i.migrateLegacySharedIfNeeded();const l=f(r?R(r):this.rootDir??k(),"tmp",`deploy-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const o=await M(e,l),a=this.loader.loadManifestOnly(o.pluginDir);if(!a.ok)return a;const u=a.manifest.name,g=i.readSharedManifest().find(p=>p.pluginName===u);if(g&&g.sha256===n&&i.deployedPluginHealthy(u))return{ok:!0,pluginName:u};await this.suspendDeployedPluginAcrossAgents(u,r),i.replaceDeployedDir(u,o.pluginDir),await i.updateSharedManifest(p=>{const h=p.filter(b=>b.pluginName!==u);return h.push({pluginName:u,zipFile:g?.zipFile??`${u}.zip`,fileName:t,defaultEnabled:s,sha256:n}),h}),d.info("[shared] \u63D2\u4EF6\u5DF2\u90E8\u7F72\u5230 bridge: %s\uFF08\u6765\u6E90 %s%s\uFF09",u,t,n?`, sha256=${n.slice(0,12)}\u2026`:"");const m=(await this.applySharedToKnownAgents(r)).find(p=>p.installed.includes(u));return m&&d.info("[shared] \u5DF2\u540C\u6B65\u5230\u8FD0\u884C\u4E2D agent: %s",m.agentId),{ok:!0,pluginName:u}}catch(o){const a=o instanceof Error?o.message:String(o);return d.warn("[shared] \u63D2\u4EF6\u90E8\u7F72\u5931\u8D25\uFF08%s\uFF09: %s",t,a),{ok:!1,error:`\u63D2\u4EF6\u90E8\u7F72\u5931\u8D25: ${a}`}}finally{await I(l,3,100).catch(()=>{})}}async suspendDeployedPluginAcrossAgents(e,t){for(const s of[...this.agents.values()]){if(!s.hydrated)continue;if(t){const r=w(s.agentId);if(r&&(r.tenantId!==t.tenantId||r.userId!==t.userId))continue}const n=s.queue.then(async()=>{const r=s.plugins.get(e);r&&(this.stopAllListeners(r),s.plugins.delete(e),d.info("[agent:%s] \u5DF2\u6458\u9664\u63D2\u4EF6\u7B49\u5F85\u90E8\u7F72\u533A\u66F4\u65B0: %s",s.agentId,e))});s.queue=n.catch(()=>{}),await n}}async applySharedToKnownAgents(e){const t=[];for(const s of this.agents.values()){if(!s.hydrated)continue;if(e){const r=w(s.agentId);if(r&&(r.tenantId!==e.tenantId||r.userId!==e.userId))continue}const n=await this.syncSharedIntoStateQueued(s);n.length>0&&t.push({agentId:s.agentId,installed:n})}return t}async syncSharedIntoStateQueued(e){const t=e.queue.then(()=>this.syncSharedIntoState(e));return e.queue=t.catch(()=>[]),t}effectiveSharedEnabled(e,t){return V(e,"plugins",t.pluginName)&&(t.defaultEnabled??!0)}async pullTemplatePluginsFromCapabilities(e){const t=H(e.agentId);if(!t)return;const s=this.deployForAgent(e.agentId),n=s.readSharedManifest();for(const[r,i]of Object.entries(t)){if(!i.url)continue;const l=n.find(a=>a.pluginName===r);if(!l||!l.sha256||l.sha256===i.sha256&&s.deployedPluginHealthy(r)||this.templatePullInFlight.has(r))continue;this.templatePullInFlight.add(r);const o=f(this.dataRootForAgent(e.agentId),"tmp",`pull-${P(e.agentId)}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{$(o,{recursive:!0});let a=`${r}.zip`;try{const m=decodeURIComponent(i.url.split("/").pop()||"");m.toLowerCase().endsWith(".zip")&&(a=x(m,`${r}.zip`))}catch{}const u=await T({downloadUrl:i.url,fileName:a,sha256:i.sha256},o);if(!u)continue;const g=S(u.outputPath),c=await this.saveSharedPlugin(g,u.fileName,l.defaultEnabled??!0,i.sha256,w(e.agentId)??void 0);c.ok?d.info("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u81EA\u52A8\u5BF9\u8D26\u66F4\u65B0\u6210\u529F: %s",e.agentId,c.pluginName??r):d.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u66F4\u65B0\u5931\u8D25: %s: %s",e.agentId,r,c.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 I(o,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.deployForAgent(e.agentId),s=t.readSharedManifest(),n=new Set,r=[];for(const i of s)if(n.add(i.pluginName),this.effectiveSharedEnabled(e.agentId,i)){const o=e.plugins.get(i.pluginName);if(!t.ensureRuntimeLink(e.agentId,i.pluginName))continue;const a=t.runtimeLinkPath(e.agentId,i.pluginName);if(!o){const u=this.loader.loadPluginFromDir(a,`shared:${i.fileName??`${i.pluginName}.zip`}`,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,i.pluginName)):d.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u52A0\u8F7D\u5931\u8D25: %s: %s",e.agentId,i.pluginName,u.error)}}else{const o=e.plugins.get(i.pluginName);o&&(this.stopAllListeners(o),e.plugins.delete(i.pluginName)),t.removeRuntimeLink(e.agentId,i.pluginName)}return this.cleanupRuntimeDir(e,n),this.persistInstalled(e),r}cleanupRuntimeDir(e,t){const s=this.deployForAgent(e.agentId).runtimeDirFor(e.agentId);try{if(!y(s))return;const n=new Set(t),r=this.deployForAgent(e.agentId);for(const i of E(s))!n.has(i)&&!e.plugins.has(i)&&r.removeRuntimeLink(e.agentId,i)}catch{}}async applyCapabilities(e){const t=await this.hydrate(e);await this.pullTemplatePluginsFromCapabilities(t),await this.syncSharedIntoState(t)}async drainEvents(e,t={}){const s=await this.hydrate(e);this.ensureListenersRunning(s);const n=s.buffer.drain(t);return{revision:n.revision,events:n.events}}pushDeprecatedNotice(e,t,s){e.buffer.push({plugin:t,event:"plugin-deprecated",priority:"urgent",receivedAt:Date.now(),message:{msgId:`plugin-deprecated-${t}-${Date.now()}`,channel:"plugin-event",senderId:`plugin:${t}`,senderName:`\u63D2\u4EF6[${t}]`,receiverId:e.agentId||void 0,content:`[plugin:${t}] plugin-deprecated
-\u3010\u7CFB\u7EDF\u63D0\u793A\u3011\u63D2\u4EF6 ${t} ${s}\uFF0C\u5176\u63D0\u4F9B\u7684\u5DE5\u5177\u4E0D\u518D\u53EF\u8C03\u7528\uFF08\u5176 plugin:${t} \u6536\u7EB3\u7EC4\u5DF2\u5931\u6548\uFF09\u3002\u5982\u4ECD\u9700\u4F7F\u7528\u8BF7\u91CD\u65B0\u5B89\u88C5/\u542F\u7528\u8BE5\u63D2\u4EF6\u3002`,requireReply:!1,role:"system",timestamp:new Date().toISOString()}})}async enqueueExternalEvent(e,t,s){const n=await this.hydrate(e),r=n.plugins.get(t);if(!r||!r.enabled)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5\u6216\u5DF2\u505C\u7528`};const i=typeof s.event=="string"?s.event:"",l=r.listeners.find(o=>o.transport.type==="http-callback"&&(!i||o.event===i));return l?(this.enqueueEvent(n,r,l,s),{ok:!0}):{ok:!1,error:`\u63D2\u4EF6 ${t} \u65E0\u5339\u914D\u7684 http-callback \u76D1\u542C\u5668\uFF08event=${i||"(\u7A7A)"}\uFF09`}}agentState(e){let t=this.agents.get(e);return t||(t={agentId:e,plugins:new Map,buffer:new J(e),hydrated:!1,queue:Promise.resolve(),eventSeq:0},this.agents.set(e,t)),t}async hydrate(e){const t=this.agentState(e);return t.hydratePromise||(t.hydratePromise=this.doHydrate(t).catch(s=>{throw t.hydratePromise=void 0,s})),await t.hydratePromise,t}async doHydrate(e){const t=e.agentId;await this.deployForAgent(t).migrateLegacySharedIfNeeded();const s=this.installedFile(t);if(!y(s)){await this.syncSharedIntoState(e).catch(()=>{}),e.hydrated=!0;return}try{const n=JSON.parse(S(s,"utf8")),r=this.readSecrets(t);for(const i of n.plugins??[]){if(String(i.source||"").startsWith("shared:"))continue;const o=f(this.dataRootForAgent(t),"cache",P(t),i.name);if(!y(f(o,"plugin.json"))){d.warn("[agent:%s] \u5DF2\u5B89\u88C5\u63D2\u4EF6\u76EE\u5F55\u7F3A\u5931\uFF0C\u8DF3\u8FC7: %s",t,i.name);continue}const a={...i.config,...r[i.name]??{}},u=this.loader.loadPluginFromDir(o,i.source,i.installedAt,a);if(u.ok){const g=u.plugin;g.enabled=i.enabled,e.plugins.set(g.name,g)}else d.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u5931\u8D25: %s: %s",t,i.name,u.error)}}catch(n){const r=n instanceof Error?n.message:String(n);d.error("[agent:%s] installed.json \u89E3\u6790\u5931\u8D25: %s",t,r)}await this.syncSharedIntoState(e).catch(n=>{d.warn("[agent:%s] \u5171\u4EAB\u63D2\u4EF6\u540C\u6B65\u5931\u8D25: %s",t,n instanceof Error?n.message:String(n))}),e.hydrated=!0}installedFile(e){return f(this.dataRootForAgent(e),"agents",P(e),"installed.json")}persistInstalled(e){this.persistSecrets(e);const t=this.installedFile(e.agentId);$(L(t),{recursive:!0});const s=[...e.plugins.values()].filter(n=>n.debug!==!0).map(n=>({name:n.name,source:n.source,installedAt:n.installedAt,enabled:n.enabled,config:this.stripSensitiveValues(n)}));N(t,`${JSON.stringify({version:1,plugins:s},null,2)}
-`,"utf8")}sensitiveKeysOf(e){return(e.userConfig??[]).filter(t=>t?.sensitive===!0&&typeof t.key=="string").map(t=>t.key)}stripSensitiveValues(e){const t=new Set(this.sensitiveKeysOf(e)),s={};for(const[n,r]of Object.entries(e.configValues))t.has(n)||(s[n]=r);return s}secretsFile(e){return f(this.dataRootForAgent(e),"agents",P(e),"secrets.json")}readSecrets(e){try{const t=JSON.parse(S(this.secretsFile(e),"utf8"));if(!F(t)||!F(t.secrets))return{};const s={};for(const[n,r]of Object.entries(t.secrets)){if(!F(r))continue;const i={};for(const[l,o]of Object.entries(r))typeof o=="string"&&(i[l]=o);s[n]=i}return s}catch{return{}}}persistSecrets(e){const t={};for(const n of e.plugins.values()){if(n.debug===!0)continue;const r={};for(const i of this.sensitiveKeysOf(n)){const l=n.configValues[i];typeof l=="string"&&l.length>0&&(r[i]=l)}Object.keys(r).length>0&&(t[n.name]=r)}const s=this.secretsFile(e.agentId);if(Object.keys(t).length===0){try{O(s,{force:!0})}catch{}return}$(L(s),{recursive:!0}),N(s,`${JSON.stringify({version:1,secrets:t},null,2)}
-`,{encoding:"utf8",mode:384})}ensureListenersRunning(e){this.listeners.ensureRunning(e)}startAllListeners(e,t){this.listeners.startAll(e,t)}stopAllListeners(e){this.listeners.stopAll(e)}enqueueEvent(e,t,s,n){this.listeners.enqueue(e,t,s,n)}async getLogs(e,t){const n=(await this.hydrate(e)).plugins.get(t);if(!n)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5`,logs:[]};const r=[];for(const i of n.runtimes)r.push(`\u2500\u2500 listener ${i.def.event} (${i.def.transport?.type}) ${i.lastError?`[error: ${i.lastError}]`:""}`),r.push(...i.logs);return{ok:!0,logs:r}}async stopAgent(e){const t=this.agents.get(e);if(t){for(const s of t.plugins.values())this.stopAllListeners(s);this.agents.delete(e)}}async stopAll(){for(const e of[...this.agents.keys()])await this.stopAgent(e)}async listDeployed(e){const t=e?this.deployForScope(e):this.deploy;await t.migrateLegacySharedIfNeeded();const s=t.readSharedManifest(),n=[];for(const r of s){const i=t.deployedPluginDir(r.pluginName),l=t.deployedPluginHealthy(r.pluginName);let o;if(l)try{const a=JSON.parse(S(f(i,"plugin.json"),"utf8"));typeof a.version=="string"&&(o=a.version)}catch{}n.push({pluginName:r.pluginName,version:o,fileName:r.fileName??`${r.pluginName}.zip`,defaultEnabled:r.defaultEnabled!==!1,sha256:r.sha256,deployed:l})}return n}deployedDefaultEnabled(e){const s=(e?this.deployForScope(e):this.deploy).readSharedManifest(),n={};for(const r of s)n[r.pluginName]=r.defaultEnabled!==!1;return n}async removeDeployedPlugin(e,t){if(!Z(e))return{ok:!1,error:"pluginName \u975E\u6CD5\uFF08\u987B\u4E3A kebab-case\uFF0C1~64 \u5B57\u7B26\uFF09"};const s=t?this.deployForScope(t):this.deploy;await s.migrateLegacySharedIfNeeded();for(const n of[...this.agents.values()]){if(!n.hydrated)continue;if(t){const i=w(n.agentId);if(i&&(i.tenantId!==t.tenantId||i.userId!==t.userId))continue}const r=n.queue.then(async()=>{const i=n.plugins.get(e);i&&(this.stopAllListeners(i),n.plugins.delete(e)),s.removeRuntimeLink(n.agentId,e),this.persistInstalled(n)});n.queue=r.catch(()=>{}),await r}await s.updateSharedManifest(n=>{const r=n.filter(i=>i.pluginName!==e);return s.hasLegacyManifestEntry(e)&&r.push({pluginName:e,removed:!0}),r});try{s.removeDeployedDir(e)}catch(n){return{ok:!1,error:`\u90E8\u7F72\u76EE\u5F55\u6E05\u7406\u5931\u8D25: ${n instanceof Error?n.message:String(n)}`}}return d.info("[shared] \u63D2\u4EF6\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",e),{ok:!0}}}const X=new G;q("plugins",v=>v?X.deployedDefaultEnabled(v):{});const ye=v=>_(v,"plugins");export{G as PluginManager,De as isValidPluginName,X as pluginManager,ye as reconcilePluginsDefaultsFromDeployed,Pe as renderCommandArgv,ke as validateAgainstSchema,ve as validateManifest};
+import{existsSync as S,mkdirSync as A,readFileSync as w,readdirSync as F,rmSync as O,writeFileSync as E}from"node:fs";import{dirname as R,join as m}from"node:path";import{parseAcodeCommandMarkdown as j}from"@agentswork/acode";import{sanitizeAgentId as D,downloadPluginZip as M,sanitizeArchiveFileName as T}from"../utils/file-utils.js";import{createLogger as q}from"../utils/logger.js";import{getAgentOwner as k}from"./agent-ownership.js";import{setDeployedDefaultsProvider as x,reconcileDefaultsFromDeployed as z}from"./capability-config.js";import{isCapabilityEnabled as V,getAgentPluginSources as _}from"./instance-features.js";import{PluginDeploymentStore as C}from"./plugin-deployment.js";import{PluginEventBuffer as H}from"./plugin-event-buffer.js";import{movePluginDir as N,rmWithRetry as P}from"./plugin-fs.js";import{executeHandler as J}from"./plugin-handler-adapter.js";import{ListenerRunner as U}from"./plugin-listener-runner.js";import{PluginLoader as K,toSummary as y}from"./plugin-loader.js";import{isRecord as b,isValidPluginName as W,validateAgainstSchema as Z}from"./plugin-manifest.js";import{extractPluginZip as L}from"./plugin-package.js";const c=q("plugin-manager");import{getUserPluginsDir as $}from"./user-scope.js";class Q{constructor(e={}){this.agents=new Map,this.deployStores=new Map,this.listeners=new U,this.loader=new K,this.templatePullInFlight=new Set,this.backgroundTemplatePulls=new Set,this.rootDir=e.rootDir,this.runtimeRootDir=e.runtimeRootDir}deployForScope(e){const t=this.rootDir??$(e),s=`scope:${t}`;let n=this.deployStores.get(s);return n||(n=new C(t,this.runtimeRootDir),this.deployStores.set(s,n)),n}resolveDeployStore(e){if(e)return this.deployForScope(e);if(this.rootDir)return this.deployForAgent("__injected__");throw new Error("saveSharedPlugin \u9700\u8981\u663E\u5F0F UserScope\uFF08\u751F\u4EA7\u94FE\u8DEF\u65E0\u9057\u7559\u56DE\u9000\uFF09")}deployStagingRoot(e){return e?$(e):this.rootDir??(()=>{throw new Error("saveSharedPlugin \u9700\u8981\u663E\u5F0F UserScope\uFF08\u751F\u4EA7\u94FE\u8DEF\u65E0\u9057\u7559\u56DE\u9000\uFF09")})()}deployForAgent(e){if(this.rootDir){const s="__injected__";let n=this.deployStores.get(s);return n||(n=new C(this.rootDir,this.runtimeRootDir),this.deployStores.set(s,n)),n}const t=k(e);if(!t)throw new Error(`agent ${e} \u5F52\u5C5E\u672A\u767B\u8BB0\uFF08owner.json \u7F3A\u5931\uFF09\uFF0C\u65E0\u6CD5\u89E3\u6790\u63D2\u4EF6\u6570\u636E\u6839`);return this.deployForScope(t)}dataRootForAgent(e){if(this.rootDir)return this.rootDir;const t=k(e);if(!t)throw new Error(`agent ${e} \u5F52\u5C5E\u672A\u767B\u8BB0\uFF08owner.json \u7F3A\u5931\uFF09\uFF0C\u65E0\u6CD5\u89E3\u6790\u63D2\u4EF6\u6570\u636E\u6839`);return $(t)}forAgent(e){return{listPlugins:()=>this.list(e),getPluginTools:t=>this.getPluginTools(e,t),invokeTool:(t,s,n,r)=>this.invokeTool(e,t,s,n,r),manage:t=>this.manage(e,t),getCommandDirs:()=>this.getCommandDirs(e)}}setOnPluginsChanged(e){this.onPluginsChanged=e}async getEnabledPluginDir(e,t){const n=(await this.hydrate(e)).plugins.get(t);return!n||!n.enabled?null:n.dir}async hydrateForAdmin(e){return this.hydrate(e)}notifyPluginsChanged(e){try{this.onPluginsChanged?.(e)}catch(t){c.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(s=>s.enabled&&s.commandDir).map(s=>s.commandDir)}async getPluginCommands(e){const t=await this.hydrate(e),s=[];for(const n of t.plugins.values())!n.enabled||!n.commandDir||s.push(...this.parsePluginCommandDir(n));return s}parsePluginCommandDir(e){return this.parseCommandDir(e.name,e.commandDir)}parseCommandDir(e,t){const s=[];if(!t)return s;try{for(const n of F(t)){if(!n.endsWith(".md"))continue;const r=m(t,n);try{const i=j(r,w(r,"utf8"));i.plugin=e,s.push(i)}catch(i){c.warn("[plugin:%s] \u547D\u4EE4\u89E3\u6790\u5931\u8D25 %s: %s",e,n,i instanceof Error?i.message:String(i))}}}catch{}return s}async list(e){const t=await this.hydrate(e),s=new Map;for(const r of t.plugins.values()){const i=y(r,e);s.set(i.name,i)}const n=this.deployForAgent(e);for(const r of n.readSharedManifest()){const i=r.pluginName;if(!n.deployedPluginHealthy(i))continue;const o=s.get(i);if(o){String(o.source||"").startsWith("shared:")&&(o.enabled=this.effectiveSharedEnabled(e,r));continue}s.set(i,{name:i,version:this.deployedPluginVersion(e,i),status:"enabled",enabled:this.effectiveSharedEnabled(e,r),source:`shared:${r.fileName??`${i}.zip`}`,installedAt:new Date().toISOString(),toolCount:0,listeners:[]})}return[...s.values()].sort((r,i)=>r.name.localeCompare(i.name))}deployedPluginVersion(e,t){try{const s=this.deployForAgent(e).resolveDeployedSourceDir(t);if(!s)return;const n=JSON.parse(w(m(s,"plugin.json"),"utf8"));return typeof n.version=="string"?n.version:void 0}catch{return}}async getPluginTools(e,t){const n=(await this.hydrate(e)).plugins.get(t);return!n||!n.enabled?[]:n.tools.map(r=>({plugin:n.name,name:r.name,title:r.title,description:r.description,inputSchema:r.inputSchema??{type:"object",properties:{}}}))}async debugMountPlugin(e,t,s={}){const n=String(t??"").trim();if(!n)return{ok:!1,error:"\u63D2\u4EF6\u76EE\u5F55\u4E0D\u80FD\u4E3A\u7A7A"};if(!S(n))return{ok:!1,error:`\u63D2\u4EF6\u76EE\u5F55\u4E0D\u5B58\u5728: ${n}`};const r=this.loader.loadManifestOnly(n);if(!r.ok)return r;const i=r.manifest.name,l=this.agentState(e),o=l.queue.then(async()=>{const a=await this.hydrate(e),u=a.plugins.get(i);u&&this.stopAllListeners(u);const g=this.loader.loadPluginFromDir(n,`debug:${n}`,new Date().toISOString(),s);if(!g.ok)return u&&this.startAllListeners(a,u),{ok:!1,error:`\u8C03\u8BD5\u6302\u8F7D\u5931\u8D25: ${g.error}`};const d=g.plugin;return d.debug=!0,a.plugins.set(d.name,d),this.startAllListeners(a,d),c.info("[agent:%s] \u63D2\u4EF6\u5DF2\u8C03\u8BD5\u6302\u8F7D: %s@%s\uFF08dir=%s\uFF09",a.agentId,d.name,d.version??"?",n),this.notifyPluginsChanged(a.agentId),{ok:!0,summary:y(d)}});return l.queue=o.catch(()=>{}),o}async listDebugPlugins(e){return[...(await this.hydrate(e)).plugins.values()].filter(s=>s.debug===!0).map(s=>y(s))}async debugPluginNames(e){return[...(await this.hydrate(e)).plugins.values()].filter(s=>s.debug===!0).map(s=>s.name)}async invokeTool(e,t,s,n,r){const i=await this.hydrate(e),l=i.plugins.get(t);if(!l)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5\uFF08\u53EF\u7528\u63D2\u4EF6: ${[...i.plugins.keys()].join(", ")||"\u65E0"}\uFF09`};if(!l.enabled)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u5DF2\u505C\u7528\uFF0C\u8BF7\u8BA9\u7528\u6237\u5728\u9762\u677F\u542F\u7528`};const o=l.tools.find(a=>a.name===s);if(!o)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u65E0\u5DE5\u5177 ${s}\uFF08\u53EF\u7528: ${l.tools.map(a=>a.name).join(", ")||"\u65E0"}\uFF09`};if(o.inputSchema){const a=Z(o.inputSchema,n);if(a.length>0)return{ok:!1,error:`\u53C2\u6570\u6821\u9A8C\u5931\u8D25: ${a.join("; ")}`,inputSchema:o.inputSchema}}return J(e,l,o,n,r)}async manage(e,t){const s=this.agentState(e),n=s.queue.then(async()=>{const r=await this.hydrate(e);return this.doManage(r,t)});return s.queue=n.catch(()=>{}),n}async doManage(e,t){switch(t.action){case"list":return{ok:!0,plugins:await this.list(e.agentId)};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 s=(t.source??"").trim();if(!s)return{ok:!1,error:"install \u9700\u8981 source\uFF08\u5F53\u524D\u652F\u6301 local:<\u63D2\u4EF6\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84>\uFF09"};const n=s.split(":",1)[0];if(n!=="local")return{ok:!1,error:`\u6682\u4E0D\u652F\u6301\u63D2\u4EF6\u6765\u6E90 "${n}:"\uFF08npm:/git: \u5728\u8DEF\u7EBF\u56FE\u4E2D\uFF1Bzip \u5305\u8BF7\u7528\u9762\u677F\u5BFC\u5165\u6216 POST /runtime/plugins/:agentId/upload\uFF09`};const r=s.slice(6).trim();return!r||!S(m(r,"plugin.json"))?{ok:!1,error:`\u63D2\u4EF6\u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u7F3A\u5C11 plugin.json: ${r}`}:this.installFromDirectory(e,r,s,t.config)}async installFromZip(e,t,s,n){if(!t||t.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};const r=this.agentState(e),i=r.queue.then(async()=>{await this.hydrate(e);const l=m(this.dataRootForAgent(e),"tmp",`upload-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const o=await L(t,l);return S(m(o.pluginDir,"plugin.json"))?(c.info("[agent:%s] zip \u5BFC\u5165: %s\uFF08%d \u4E2A\u6587\u4EF6\uFF09",e,s,o.fileCount),await this.installFromDirectory(r,o.pluginDir,`upload:${s}`,n)):{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(o){const a=o instanceof Error?o.message:String(o);return c.warn("[agent:%s] zip \u5BFC\u5165\u5931\u8D25: %s",e,a),{ok:!1,error:`zip \u5BFC\u5165\u5931\u8D25: ${a}`}}finally{await P(l,3,100).catch(()=>{})}});return r.queue=i.catch(()=>{}),i}async installFromDirectory(e,t,s,n){const r=this.loader.loadManifestOnly(t);if(!r.ok)return r;const i=r.manifest,l=i.name,o=this.loader.validateUserConfigValues(i,n??{});if(o)return{ok:!1,error:o};const a=this.loader.loadPluginFromDir(t,s,new Date().toISOString(),n??{});if(!a.ok)return c.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u6821\u9A8C\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,s,a.error),a;const u=m(this.dataRootForAgent(e.agentId),"cache",D(e.agentId),l),g=t===u,d=e.plugins.get(l);if(d&&this.stopAllListeners(d),!g)try{await P(u),await N(t,u)}catch(f){const I=f instanceof Error?f.message:String(f);return c.warn("[agent:%s] \u63D2\u4EF6\u79FB\u52A8\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,s,I),d&&this.startAllListeners(e,d),{ok:!1,error:`\u63D2\u4EF6\u79FB\u52A8\u5931\u8D25: ${I}`}}const p=this.loader.loadPluginFromDir(u,s,new Date().toISOString(),n??{});if(!p.ok){if(c.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u5931\u8D25\uFF08%s\uFF09: %s",e.agentId,s,p.error),!g)try{await N(u,t)}catch(f){c.warn("[agent:%s] \u88C5\u8F7D\u5931\u8D25\u540E\u65E0\u6CD5\u79FB\u56DE\u6E90\u76EE\u5F55\uFF08%s\uFF09\uFF0C\u5DF2\u4FDD\u7559\u7F13\u5B58\u526F\u672C",e.agentId,f instanceof Error?f.message:String(f))}if(d)try{this.startAllListeners(e,d)}catch(f){c.warn("[agent:%s] \u6062\u590D\u65E7\u5B9E\u4F8B\u76D1\u542C\u5931\u8D25: %s",e.agentId,f instanceof Error?f.message:String(f))}return p}const h=p.plugin;return e.plugins.set(h.name,h),this.persistInstalled(e),this.startAllListeners(e,h),c.info("[agent:%s] \u63D2\u4EF6\u5DF2\u5B89\u88C5: %s@%s",e.agentId,h.name,h.version??"?"),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:y(h)}}async uninstallPlugin(e,t){const s=(t.name??"").trim(),n=e.plugins.get(s);if(!n)return{ok:!1,error:`\u63D2\u4EF6 ${s} \u672A\u5B89\u88C5`};this.stopAllListeners(n),e.plugins.delete(s),n.tools.length>0&&this.pushDeprecatedNotice(e,s,"\u5DF2\u88AB\u5378\u8F7D");const r=this.deployForAgent(e.agentId);return r.readSharedManifest().some(l=>l.pluginName===s)&&r.removeRuntimeLink(e.agentId,s),this.persistInstalled(e),n.debug!==!0&&await P(n.dir),c.info("[agent:%s] \u63D2\u4EF6\u5DF2\u5378\u8F7D: %s",e.agentId,s),this.notifyPluginsChanged(e.agentId),{ok:!0}}async reloadPlugin(e,t){const s=(t.name??"").trim(),n=e.plugins.get(s);if(!n)return{ok:!1,error:`\u63D2\u4EF6 ${s} \u672A\u5B89\u88C5`};const r=this.loader.loadPluginFromDir(n.dir,n.source,n.installedAt,n.configValues);if(!r.ok)return{ok:!1,error:`\u91CD\u8F7D\u5931\u8D25\uFF08\u4FDD\u7559\u65E7\u7248\u672C\u8FD0\u884C\uFF09: ${r.error}`};const i=r.plugin;return i.debug=n.debug,this.stopAllListeners(n),e.plugins.set(s,i),this.persistInstalled(e),this.startAllListeners(e,i),c.info("[agent:%s] \u63D2\u4EF6\u5DF2\u91CD\u8F7D: %s",e.agentId,s),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:y(i)}}async setEnabled(e,t,s){const n=(t.name??"").trim(),r=e.plugins.get(n);return r?(r.enabled=s,s?this.startAllListeners(e,r):(r.tools.length>0&&this.pushDeprecatedNotice(e,n,"\u5DF2\u505C\u7528"),this.stopAllListeners(r)),this.persistInstalled(e),this.notifyPluginsChanged(e.agentId),{ok:!0,summary:y(r)}):{ok:!1,error:`\u63D2\u4EF6 ${n} \u672A\u5B89\u88C5`}}async saveSharedPlugin(e,t,s=!0,n,r){if(!e||e.length===0)return{ok:!1,error:"zip \u5305\u5185\u5BB9\u4E3A\u7A7A"};const i=this.resolveDeployStore(r),l=m(this.deployStagingRoot(r),"tmp",`deploy-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{const o=await L(e,l),a=this.loader.loadManifestOnly(o.pluginDir);if(!a.ok)return a;const u=a.manifest.name,g=i.readSharedManifest().find(h=>h.pluginName===u);if(g&&g.sha256===n&&i.deployedPluginHealthy(u))return{ok:!0,pluginName:u};await this.suspendDeployedPluginAcrossAgents(u,r),i.replaceDeployedDir(u,o.pluginDir),await i.updateSharedManifest(h=>{const f=h.filter(I=>I.pluginName!==u);return f.push({pluginName:u,fileName:t,defaultEnabled:s,sha256:n}),f}),c.info("[shared] \u63D2\u4EF6\u5DF2\u90E8\u7F72\u5230 bridge: %s\uFF08\u6765\u6E90 %s%s\uFF09",u,t,n?`, sha256=${n.slice(0,12)}\u2026`:"");const p=(await this.applySharedToKnownAgents(r)).find(h=>h.installed.includes(u));return p&&c.info("[shared] \u5DF2\u540C\u6B65\u5230\u8FD0\u884C\u4E2D agent: %s",p.agentId),{ok:!0,pluginName:u}}catch(o){const a=o instanceof Error?o.message:String(o);return c.warn("[shared] \u63D2\u4EF6\u90E8\u7F72\u5931\u8D25\uFF08%s\uFF09: %s",t,a),{ok:!1,error:`\u63D2\u4EF6\u90E8\u7F72\u5931\u8D25: ${a}`}}finally{await P(l,3,100).catch(()=>{})}}async suspendDeployedPluginAcrossAgents(e,t){for(const s of[...this.agents.values()]){if(!s.hydrated)continue;if(t){const r=k(s.agentId);if(r&&(r.tenantId!==t.tenantId||r.userId!==t.userId))continue}const n=s.queue.then(async()=>{const r=s.plugins.get(e);r&&(this.stopAllListeners(r),s.plugins.delete(e),c.info("[agent:%s] \u5DF2\u6458\u9664\u63D2\u4EF6\u7B49\u5F85\u90E8\u7F72\u533A\u66F4\u65B0: %s",s.agentId,e))});s.queue=n.catch(()=>{}),await n}}async applySharedToKnownAgents(e){const t=[];for(const s of this.agents.values()){if(!s.hydrated)continue;if(e){const r=k(s.agentId);if(r&&(r.tenantId!==e.tenantId||r.userId!==e.userId))continue}const n=await this.syncSharedIntoStateQueued(s);n.length>0&&t.push({agentId:s.agentId,installed:n})}return t}async syncSharedIntoStateQueued(e){const t=e.queue.then(()=>this.syncSharedIntoState(e));return e.queue=t.catch(()=>[]),t}effectiveSharedEnabled(e,t){return V(e,"plugins",t.pluginName)&&(t.defaultEnabled??!0)}async pullTemplatePluginsFromCapabilities(e){const t=_(e.agentId);if(!t)return;const s=this.deployForAgent(e.agentId),n=s.readSharedManifest();for(const[r,i]of Object.entries(t)){if(!i.url)continue;const l=n.find(a=>a.pluginName===r);if(!l||!l.sha256||l.sha256===i.sha256&&s.deployedPluginHealthy(r)||this.templatePullInFlight.has(r))continue;this.templatePullInFlight.add(r);const o=m(this.dataRootForAgent(e.agentId),"tmp",`pull-${D(e.agentId)}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{A(o,{recursive:!0});let a=`${r}.zip`;try{const p=decodeURIComponent(i.url.split("/").pop()||"");p.toLowerCase().endsWith(".zip")&&(a=T(p,`${r}.zip`))}catch{}const u=await M({downloadUrl:i.url,fileName:a,sha256:i.sha256},o);if(!u)continue;const g=w(u.outputPath),d=await this.saveSharedPlugin(g,u.fileName,l.defaultEnabled??!0,i.sha256,k(e.agentId)??void 0);d.ok?c.info("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u81EA\u52A8\u5BF9\u8D26\u66F4\u65B0\u6210\u529F: %s",e.agentId,d.pluginName??r):c.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u66F4\u65B0\u5931\u8D25: %s: %s",e.agentId,r,d.error)}catch(a){c.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 P(o,3,100).catch(()=>{})}}}queueTemplatePull(e){this.backgroundTemplatePulls.has(e.agentId)||(this.backgroundTemplatePulls.add(e.agentId),this.pullTemplatePluginsFromCapabilities(e).catch(t=>{c.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.deployForAgent(e.agentId),s=t.readSharedManifest(),n=new Set,r=[];for(const i of s)if(n.add(i.pluginName),this.effectiveSharedEnabled(e.agentId,i)){const o=e.plugins.get(i.pluginName);if(!t.ensureRuntimeLink(e.agentId,i.pluginName))continue;const a=t.runtimeLinkPath(e.agentId,i.pluginName);if(!o){const u=this.loader.loadPluginFromDir(a,`shared:${i.fileName??`${i.pluginName}.zip`}`,new Date().toISOString(),{});u.ok?(e.plugins.set(u.plugin.name,u.plugin),r.push(u.plugin.name),c.info("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u5DF2\u6309\u5F00\u542F\u6001\u52A0\u8F7D: %s",e.agentId,i.pluginName)):c.warn("[agent:%s] \u5DF2\u90E8\u7F72\u63D2\u4EF6\u52A0\u8F7D\u5931\u8D25: %s: %s",e.agentId,i.pluginName,u.error)}}else{const o=e.plugins.get(i.pluginName);o&&(this.stopAllListeners(o),e.plugins.delete(i.pluginName)),t.removeRuntimeLink(e.agentId,i.pluginName)}return this.cleanupRuntimeDir(e,n),this.persistInstalled(e),r}cleanupRuntimeDir(e,t){const s=this.deployForAgent(e.agentId).runtimeDirFor(e.agentId);try{if(!S(s))return;const n=new Set(t),r=this.deployForAgent(e.agentId);for(const i of F(s))!n.has(i)&&!e.plugins.has(i)&&r.removeRuntimeLink(e.agentId,i)}catch{}}async applyCapabilities(e){const t=await this.hydrate(e);await this.pullTemplatePluginsFromCapabilities(t),await this.syncSharedIntoState(t)}async drainEvents(e,t={}){const s=await this.hydrate(e);this.ensureListenersRunning(s);const n=s.buffer.drain(t);return{revision:n.revision,events:n.events}}pushDeprecatedNotice(e,t,s){e.buffer.push({plugin:t,event:"plugin-deprecated",priority:"urgent",receivedAt:Date.now(),message:{msgId:`plugin-deprecated-${t}-${Date.now()}`,channel:"plugin-event",senderId:`plugin:${t}`,senderName:`\u63D2\u4EF6[${t}]`,receiverId:e.agentId||void 0,content:`[plugin:${t}] plugin-deprecated
+\u3010\u7CFB\u7EDF\u63D0\u793A\u3011\u63D2\u4EF6 ${t} ${s}\uFF0C\u5176\u63D0\u4F9B\u7684\u5DE5\u5177\u4E0D\u518D\u53EF\u8C03\u7528\uFF08\u5176 plugin:${t} \u6536\u7EB3\u7EC4\u5DF2\u5931\u6548\uFF09\u3002\u5982\u4ECD\u9700\u4F7F\u7528\u8BF7\u91CD\u65B0\u5B89\u88C5/\u542F\u7528\u8BE5\u63D2\u4EF6\u3002`,requireReply:!1,role:"system",timestamp:new Date().toISOString()}})}async enqueueExternalEvent(e,t,s){const n=await this.hydrate(e),r=n.plugins.get(t);if(!r||!r.enabled)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5\u6216\u5DF2\u505C\u7528`};const i=typeof s.event=="string"?s.event:"",l=r.listeners.find(o=>o.transport.type==="http-callback"&&(!i||o.event===i));return l?(this.enqueueEvent(n,r,l,s),{ok:!0}):{ok:!1,error:`\u63D2\u4EF6 ${t} \u65E0\u5339\u914D\u7684 http-callback \u76D1\u542C\u5668\uFF08event=${i||"(\u7A7A)"}\uFF09`}}agentState(e){let t=this.agents.get(e);return t||(t={agentId:e,plugins:new Map,buffer:new H(e),hydrated:!1,queue:Promise.resolve(),eventSeq:0},this.agents.set(e,t)),t}async hydrate(e){const t=this.agentState(e);return t.hydratePromise||(t.hydratePromise=this.doHydrate(t).catch(s=>{throw t.hydratePromise=void 0,s})),await t.hydratePromise,t}async doHydrate(e){const t=e.agentId,s=this.installedFile(t);if(!S(s)){await this.syncSharedIntoState(e).catch(()=>{}),e.hydrated=!0;return}try{const n=JSON.parse(w(s,"utf8")),r=this.readSecrets(t);for(const i of n.plugins??[]){if(String(i.source||"").startsWith("shared:"))continue;const o=m(this.dataRootForAgent(t),"cache",D(t),i.name);if(!S(m(o,"plugin.json"))){c.warn("[agent:%s] \u5DF2\u5B89\u88C5\u63D2\u4EF6\u76EE\u5F55\u7F3A\u5931\uFF0C\u8DF3\u8FC7: %s",t,i.name);continue}const a={...i.config,...r[i.name]??{}},u=this.loader.loadPluginFromDir(o,i.source,i.installedAt,a);if(u.ok){const g=u.plugin;g.enabled=i.enabled,e.plugins.set(g.name,g)}else c.warn("[agent:%s] \u63D2\u4EF6\u88C5\u8F7D\u5931\u8D25: %s: %s",t,i.name,u.error)}}catch(n){const r=n instanceof Error?n.message:String(n);c.error("[agent:%s] installed.json \u89E3\u6790\u5931\u8D25: %s",t,r)}await this.syncSharedIntoState(e).catch(n=>{c.warn("[agent:%s] \u5171\u4EAB\u63D2\u4EF6\u540C\u6B65\u5931\u8D25: %s",t,n instanceof Error?n.message:String(n))}),e.hydrated=!0}installedFile(e){return m(this.dataRootForAgent(e),"agents",D(e),"installed.json")}persistInstalled(e){this.persistSecrets(e);const t=this.installedFile(e.agentId);A(R(t),{recursive:!0});const s=[...e.plugins.values()].filter(n=>n.debug!==!0).map(n=>({name:n.name,source:n.source,installedAt:n.installedAt,enabled:n.enabled,config:this.stripSensitiveValues(n)}));E(t,`${JSON.stringify({version:1,plugins:s},null,2)}
+`,"utf8")}sensitiveKeysOf(e){return(e.userConfig??[]).filter(t=>t?.sensitive===!0&&typeof t.key=="string").map(t=>t.key)}stripSensitiveValues(e){const t=new Set(this.sensitiveKeysOf(e)),s={};for(const[n,r]of Object.entries(e.configValues))t.has(n)||(s[n]=r);return s}secretsFile(e){return m(this.dataRootForAgent(e),"agents",D(e),"secrets.json")}readSecrets(e){try{const t=JSON.parse(w(this.secretsFile(e),"utf8"));if(!b(t)||!b(t.secrets))return{};const s={};for(const[n,r]of Object.entries(t.secrets)){if(!b(r))continue;const i={};for(const[l,o]of Object.entries(r))typeof o=="string"&&(i[l]=o);s[n]=i}return s}catch{return{}}}persistSecrets(e){const t={};for(const n of e.plugins.values()){if(n.debug===!0)continue;const r={};for(const i of this.sensitiveKeysOf(n)){const l=n.configValues[i];typeof l=="string"&&l.length>0&&(r[i]=l)}Object.keys(r).length>0&&(t[n.name]=r)}const s=this.secretsFile(e.agentId);if(Object.keys(t).length===0){try{O(s,{force:!0})}catch{}return}A(R(s),{recursive:!0}),E(s,`${JSON.stringify({version:1,secrets:t},null,2)}
+`,{encoding:"utf8",mode:384})}ensureListenersRunning(e){this.listeners.ensureRunning(e)}startAllListeners(e,t){this.listeners.startAll(e,t)}stopAllListeners(e){this.listeners.stopAll(e)}enqueueEvent(e,t,s,n){this.listeners.enqueue(e,t,s,n)}async updatePluginConfig(e,t,s){const n=await this.hydrate(e),r=n.queue.then(async()=>{const i=n.plugins.get(t);if(!i)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5`};if(!b(s))return{ok:!1,error:"config \u987B\u4E3A JSON \u5BF9\u8C61"};const l="********",o={...i.configValues};for(const[p,h]of Object.entries(s)){if(h===null){delete o[p];continue}const f=String(h);f!==l&&(o[p]=f)}const a={userConfig:i.userConfig},u=this.loader.validateUserConfigValues(a,o);if(u)return{ok:!1,error:u};const g=this.loader.loadPluginFromDir(i.dir,i.source,i.installedAt,o);if(!g.ok)return{ok:!1,error:`\u914D\u7F6E\u4FDD\u5B58\u5931\u8D25\uFF08\u4FDD\u7559\u539F\u914D\u7F6E\uFF09: ${g.error}`};const d=g.plugin;return d.debug=i.debug,this.stopAllListeners(i),n.plugins.set(t,d),this.persistInstalled(n),this.startAllListeners(n,d),c.info("[agent:%s] \u63D2\u4EF6\u914D\u7F6E\u5DF2\u66F4\u65B0\u5E76\u91CD\u8F7D: %s\uFF08\u952E: %s\uFF09",e,t,Object.keys(s).join(", ")||"(\u65E0\u53D8\u66F4)"),this.notifyPluginsChanged(e),{ok:!0,summary:y(d)}});return n.queue=r.catch(()=>{}),r}async getLogs(e,t){const n=(await this.hydrate(e)).plugins.get(t);if(!n)return{ok:!1,error:`\u63D2\u4EF6 ${t} \u672A\u5B89\u88C5`,logs:[]};const r=[];for(const i of n.runtimes)r.push(`\u2500\u2500 listener ${i.def.event} (${i.def.transport?.type}) ${i.lastError?`[error: ${i.lastError}]`:""}`),r.push(...i.logs);return{ok:!0,logs:r}}async stopAgent(e){const t=this.agents.get(e);if(t){for(const s of t.plugins.values())this.stopAllListeners(s);this.agents.delete(e)}}async stopAll(){for(const e of[...this.agents.keys()])await this.stopAgent(e)}async listDeployed(e){const t=this.deployForScope(e),s=t.readSharedManifest(),n=[];for(const r of s){const i=t.deployedPluginDir(r.pluginName),l=t.deployedPluginHealthy(r.pluginName);let o;if(l)try{const a=JSON.parse(w(m(i,"plugin.json"),"utf8"));typeof a.version=="string"&&(o=a.version)}catch{}n.push({pluginName:r.pluginName,version:o,fileName:r.fileName??`${r.pluginName}.zip`,defaultEnabled:r.defaultEnabled!==!1,sha256:r.sha256,deployed:l})}return n}deployedDefaultEnabled(e){if(!e)return{};const s=this.deployForScope(e).readSharedManifest(),n={};for(const r of s)n[r.pluginName]=r.defaultEnabled!==!1;return n}async removeDeployedPlugin(e,t){if(!W(e))return{ok:!1,error:"pluginName \u975E\u6CD5\uFF08\u987B\u4E3A kebab-case\uFF0C1~64 \u5B57\u7B26\uFF09"};const s=this.deployForScope(t);for(const n of[...this.agents.values()]){if(!n.hydrated)continue;if(t){const i=k(n.agentId);if(i&&(i.tenantId!==t.tenantId||i.userId!==t.userId))continue}const r=n.queue.then(async()=>{const i=n.plugins.get(e);i&&(this.stopAllListeners(i),n.plugins.delete(e)),s.removeRuntimeLink(n.agentId,e),this.persistInstalled(n)});n.queue=r.catch(()=>{}),await r}await s.updateSharedManifest(n=>n.filter(r=>r.pluginName!==e));try{s.removeDeployedDir(e)}catch(n){return{ok:!1,error:`\u90E8\u7F72\u76EE\u5F55\u6E05\u7406\u5931\u8D25: ${n instanceof Error?n.message:String(n)}`}}return c.info("[shared] \u63D2\u4EF6\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",e),{ok:!0}}}const B=new Q;x("plugins",v=>v?B.deployedDefaultEnabled(v):{});const he=v=>z(v,"plugins");export{Q as PluginManager,B as pluginManager,he as reconcilePluginsDefaultsFromDeployed};
 

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

@@ -10,6 +10,8 @@
 
 
 import type { PluginEventPriority } from "./plugin-event-buffer.js";
+
+export declare const PLUGIN_MANIFEST_SCHEMA_VERSION = 2;
 export interface PluginUserConfigField {
     key: string;
     type?: "string" | "number" | "boolean";
@@ -19,7 +21,7 @@ export interface PluginUserConfigField {
     default?: string;
 }
 export interface PluginHandlerDef {
-    type: "process" | "module" | "mcp";
+    type: "process" | "module";
     
     command?: string;
     
@@ -54,7 +56,7 @@ export interface PluginListenerDef {
     description?: string;
     transport: PluginTransportDef;
     
-    delivery?: "poll" | "force" | "wake";
+    delivery?: "poll";
     priority?: PluginEventPriority;
     
     matcher?: Record<string, string | number | boolean | Array<string | number | boolean>>;
@@ -65,16 +67,64 @@ export interface PluginListenerDef {
     
     summary?: string;
 }
+
+export declare const PLUGIN_UI_BUILTIN_ICONS: readonly ["puzzle", "github"];
+
+
+
+
+
+
+export interface PluginUiManifest {
+    
+    icon?: string;
+    
+    status?: {
+        
+        tool: string;
+        
+        persistent?: boolean;
+        
+        hideWhenZero?: boolean;
+        
+        pollIntervalMs?: number;
+        
+        title?: string;
+    };
+    
+    view?: {
+        
+        entry: string;
+        
+        title: string;
+        
+        assetsRoot?: string;
+        
+        invoke: string[];
+        
+        defaultRoute?: string;
+    };
+}
+
+export declare function isValidUiIcon(value: string): boolean;
+
+export declare function isValidUiPath(value: string): boolean;
+
+export declare function validateUiManifest(ui: unknown): string | null;
 export interface PluginManifest {
+    
+    schemaVersion: number;
     name: string;
     version?: string;
     description?: string;
+    
     author?: Record<string, unknown>;
     tools?: string;
     listeners?: string;
     commands?: string;
     userConfig?: PluginUserConfigField[];
-    [key: string]: unknown;
+    
+    ui?: PluginUiManifest;
 }
 export declare const PLUGIN_NAME_PATTERN: RegExp;
 export declare function isRecord(value: unknown): value is Record<string, unknown>;