aws-runtime-bridge 1.9.135 → 1.9.139

package/dist/services/instance-features.js

@@ -1,2 +1,2 @@
-const c={},_="desktop",u="browser",d="agentSys.launchItem",T="agentSys.hire",f=new Set([u]),a=new Set,i=new Map,s=new Map,E=["fileReadOutside","commandExecution","fileModification"],A=new Set(["allow","ask","deny"]);function p(e){if(typeof e!="object"||e===null||Array.isArray(e))return null;const t=e,n={};let o=!1;for(const r of E){const l=t[r];typeof l=="string"&&A.has(l)?(n[r]=l,o=!0):n[r]="allow"}return o?n:null}function y(e){if(e==null)return{...c};let t=e;if(typeof e=="string")try{t=JSON.parse(e)}catch{t=null}if(typeof t!="object"||t===null||Array.isArray(t))return{...c};const n={};for(const[o,r]of Object.entries(t))a.has(o)||typeof r=="boolean"&&(n[o]=r);return n}function F(e,t){if(!e)return;i.set(e,y(t));let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n=="object"&&n!==null&&!Array.isArray(n)){const o=p(n.toolPermissions);o?s.set(e,o):s.delete(e)}else s.delete(e)}function S(e){return i.get(e)??{...c}}function R(e,t){const n=S(e)[t];return n!==void 0?n:f.has(t)}function m(e){i.delete(e),s.delete(e)}function x(e){return s.get(e)??null}function O(e){return s.get(e)??{fileReadOutside:"allow",commandExecution:"allow",fileModification:"allow"}}function g(){return i.size}export{u as BROWSER_FEATURE_KEY,_ as DESKTOP_FEATURE_KEY,T as HIRE_FEATURE_KEY,d as LAUNCH_ITEM_FEATURE_KEY,m as clearAgentFeatures,S as getAgentFeatures,x as getAgentToolPermissions,g as instanceFeaturesCacheSize,R as isFeatureEnabled,O as resolveAgentToolPermissions,F as setAgentFeatures};
+import{getEffective as _,hasAnyDefault as x}from"./capability-config.js";const E={},C="desktop",F="browser",D="agentSys.launchItem",N="agentSys.hire",h=new Set([F]),O=new Set,y=new Map,c=new Map,R=["fileReadOutside","commandExecution","fileModification"],P=new Set(["allow","ask","deny"]);function M(e){if(typeof e!="object"||e===null||Array.isArray(e))return null;const t=e,n={};let o=!1;for(const r of R){const s=t[r];typeof s=="string"&&P.has(s)?(n[r]=s,o=!0):n[r]="allow"}return o?n:null}function j(e){if(e==null)return{...E};let t=e;if(typeof e=="string")try{t=JSON.parse(e)}catch{t=null}if(typeof t!="object"||t===null||Array.isArray(t))return{...E};const n={};for(const[o,r]of Object.entries(t))O.has(o)||typeof r=="boolean"&&(n[o]=r);return n}function z(e,t){if(!e)return;y.set(e,j(t));let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n=="object"&&n!==null&&!Array.isArray(n)){const o=M(n.toolPermissions);o?c.set(e,o):c.delete(e)}else c.delete(e)}function L(e){return y.get(e)??{...E}}function Y(e,t){const n=L(e)[t];return n!==void 0?n:h.has(t)}function K(e){y.delete(e),c.delete(e),u.delete(e),A.delete(e)}function k(e){return c.get(e)??null}function H(e){return c.get(e)??{fileReadOutside:"allow",commandExecution:"allow",fileModification:"allow"}}const U=["skills","mcp","plugins"],u=new Map,A=new Map;function v(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const t={};for(const[n,o]of Object.entries(e))n.trim()&&typeof o=="boolean"&&(t[n.trim()]=o);return t}function J(e,t){if(!e)return;if(t==null){u.delete(e);return}let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n!="object"||n===null||Array.isArray(n)){u.delete(e);return}const o=n,r={};let s=!1;for(const a of U){const i=v(o[a]);i&&(r[a]=i,s=!0)}s?u.set(e,r):u.delete(e);const f=o.plugins,d={};let g=!1;if(typeof f=="object"&&f!==null&&!Array.isArray(f))for(const[a,i]of Object.entries(f)){const p=a.trim();if(p){if(typeof i=="boolean"){const l=r.plugins??{};l[p]=i,r.plugins=l,s=!0;continue}if(i!==null&&typeof i=="object"&&!Array.isArray(i)){const l=i,S=l.enabled!==!1,b=typeof l.url=="string"?l.url:void 0,T=typeof l.sha256=="string"?l.sha256:void 0,m=r.plugins??{};m[p]=S,r.plugins=m,s=!0,b&&(d[p]={url:b,sha256:T},g=!0)}}}g?A.set(e,d):A.delete(e)}function V(e){return u.get(e)??null}function W(e){return A.get(e)??null}function q(e,t,n){if(x(t))return _(e,t,n);const o=u.get(e);if(!o)return!0;const r=o[t];if(!r)return!0;const s=r[n];return s===void 0?!0:s}function w(){return y.size}export{F as BROWSER_FEATURE_KEY,U as CAPABILITY_TYPES,C as DESKTOP_FEATURE_KEY,N as HIRE_FEATURE_KEY,D as LAUNCH_ITEM_FEATURE_KEY,K as clearAgentFeatures,V as getAgentCapabilities,L as getAgentFeatures,W as getAgentPluginSources,k as getAgentToolPermissions,w as instanceFeaturesCacheSize,q as isCapabilityEnabled,Y as isFeatureEnabled,H as resolveAgentToolPermissions,J as setAgentCapabilities,z as setAgentFeatures};
 

package/dist/services/instance-init-service.d.ts

@@ -1,12 +1,11 @@
-import type { CcSwitchSdk } from '@cc-switch/sdk';
-import type { AdapterResult, InitLogEntry, LegacyMcpStateItem, LegacySkillStateItem, McpPayload, SkillPackage, SyncStateResult } from '../types.js';
-export declare function syncLegacyStateFromSdk(agentId: string, sdk: CcSwitchSdk): Promise<SyncStateResult>;
+import type { InitLogEntry, LegacyMcpStateItem, LegacySkillStateItem, McpPayload, PluginPackage, SkillPackage } from '../types.js';
 export declare function initInstance(agentId: string, workspacePath: string, options: {
     skillEnabled?: boolean;
     mcpEnabled?: boolean;
     ccSwitchEnabledTools?: string[];
     skillPackage?: SkillPackage;
     skillPackages?: SkillPackage[];
+    pluginPackages?: PluginPackage[];
     mcpServers?: McpPayload[];
 }): Promise<{
     ok: boolean;
@@ -26,7 +25,11 @@ export declare function initInstance(agentId: string, workspacePath: string, opt
         configPath: string | null;
         installedCount?: number;
     };
-    adapterResult?: AdapterResult;
+    plugin?: {
+        enabled: boolean;
+        packagePresent: boolean;
+        installedCount?: number;
+    };
     installed?: {
         skills: LegacySkillStateItem[];
         mcpServers: LegacyMcpStateItem[];

package/dist/services/instance-init-service.js

@@ -1,2 +1,2 @@
-import{promises as L}from"node:fs";import b from"node:path";import{ensureDir as P,installSkillPackageToSdk as F}from"../utils/file-utils.js";import{buildMcpConfigContent as I,normalizeSdkMcpServerSpec as K,toLegacyMcpStateItem as M,toLegacySkillStateItem as E}from"../utils/mcp-utils.js";import{normalizeMcpPayload as B}from"../utils/mcp-utils.js";import{ensureEnabledTools as W,parseBoolean as j}from"../utils/validation.js";import{loadCcSwitchSdk as q,runCcSwitchAdapter as G,toSdkAppsFromEnabledTools as H}from"./cc-switch-sdk.js";import{getAgentInitRoot as D,loadInstanceState as z,saveInstanceState as O}from"./instance-state.js";import{detectToolStatuses as J}from"./tool-installer.js";function N(a,m){const s=new Set(Object.values(m).filter(n=>n.installed).map(n=>n.tool));return a.filter(n=>s.has(n))}async function Q(a,m){const s=await z(a),n=m.getAllMcpServers().map(k=>M(k)),p=m.getAllSkills().map(k=>E(k));s.mcpServers=n,s.skills=p;const f=D(a),e=await P(b.join(f,"mcp")),c=b.join(e,"mcp-servers.json");return await L.writeFile(c,I(n),"utf-8"),{state:await O(a,s),configPath:c,skills:p,mcpServers:n}}async function te(a,m,s){const n=b.resolve(m),p=D(a),f=[];function e(t,r,l,S){f.push({step:t,status:r,message:l,timestamp:new Date().toISOString(),details:S})}e("prepare","running","\u5F00\u59CB\u521D\u59CB\u5316\u5B9E\u4F8B",{agentId:String(a),workspacePath:n}),await P(p),e("prepare","success","\u521D\u59CB\u5316\u76EE\u5F55\u5DF2\u5C31\u7EEA",{initRoot:p});const c=W(s.ccSwitchEnabledTools);e("detect-tools","running","\u5F00\u59CB\u68C0\u6D4B\u5DE5\u5177\u5B89\u88C5\u72B6\u6001",{tools:c});const d=await J(c);e("detect-tools","success","\u5DE5\u5177\u5B89\u88C5\u72B6\u6001\u68C0\u6D4B\u5B8C\u6210",{installedTools:Object.values(d).filter(t=>t.installed).map(t=>t.tool),missingTools:Object.values(d).filter(t=>!t.installed).map(t=>t.tool)});const k=N(c,d),v=Object.values(d).filter(t=>!t.installed),i={ok:!0,agentId:String(a),workspacePath:n,initRoot:p,enabledTools:c,toolStatus:d,logs:f,skill:{enabled:j(s.skillEnabled,!0),packagePresent:!1},mcp:{enabled:j(s.mcpEnabled,!0),configPath:null}},u=await z(a);v.length>0&&e("skip-uninstalled-tools","skipped","\u5DF2\u8DF3\u8FC7\u672A\u5B89\u88C5\u5DE5\u5177",{skippedTools:v.map(t=>({tool:t.tool,error:t.error}))}),e("select-installed-tools","success","\u5DF2\u9009\u62E9\u53EF\u521D\u59CB\u5316\u5DE5\u5177",{enabledTools:c,installedTools:k}),e("load-sdk","running","\u5F00\u59CB\u52A0\u8F7D CC Switch SDK");const g=await q(a),w=H(k);if(e("load-sdk","success","CC Switch SDK \u52A0\u8F7D\u5B8C\u6210",{sdkApps:w}),i.skill.enabled){e("install-skills","running","\u5F00\u59CB\u5B89\u88C5\u6280\u80FD\u5305",{count:Array.isArray(s.skillPackages)?s.skillPackages.length:s.skillPackage?1:0});const t=await P(b.join(p,"skills")),r=Array.isArray(s.skillPackages)&&s.skillPackages.length>0?s.skillPackages:s.skillPackage?[s.skillPackage]:[],l=[];for(const S of r){const h=await F(g,S,t,w);h&&l.push(E(h))}l.length>0?(i.skill.packagePresent=!0,i.skill.installedCount=l.length,i.skill.installed=l,e("install-skills","success","\u6280\u80FD\u5305\u5B89\u88C5\u5B8C\u6210",{installedCount:l.length,skills:l.map(S=>S.name)})):e("install-skills","skipped","\u6CA1\u6709\u53EF\u5B89\u88C5\u7684\u6280\u80FD\u5305")}else e("install-skills","skipped","\u5DF2\u8DF3\u8FC7\u6280\u80FD\u5305\u5B89\u88C5\uFF08skillEnabled=false\uFF09");if(i.mcp.enabled){e("install-mcp","running","\u5F00\u59CB\u5199\u5165 MCP \u914D\u7F6E",{count:Array.isArray(s.mcpServers)?s.mcpServers.length:0});const t=(Array.isArray(s.mcpServers)?s.mcpServers:[]).map(l=>B(l)).filter(l=>l!==null),r=[];for(const l of t){const h=g.getAllMcpServers().find(x=>String(x?.name||"").trim()===l.name),T={name:l.name,server:K(l),apps:w},A=String(h?.id||"").trim(),R=A?await g.updateMcpServer(A,T):await g.createMcpServer(T);r.push(M(R))}i.mcp.installedCount=r.length,e("install-mcp","success","MCP \u914D\u7F6E\u5199\u5165\u5B8C\u6210",{installedCount:r.length,mcpServers:r.map(l=>l.name)})}else e("install-mcp","skipped","\u5DF2\u8DF3\u8FC7 MCP \u914D\u7F6E\uFF08mcpEnabled=false\uFF09");e("persist-state","running","\u5F00\u59CB\u4FDD\u5B58\u5B9E\u4F8B\u72B6\u6001"),u.initialized=!0,u.enabledTools=c,u.toolStatus=d,u.skillEnabled=i.skill.enabled,u.mcpEnabled=i.mcp.enabled,await O(a,u),e("persist-state","success","\u5B9E\u4F8B\u72B6\u6001\u4FDD\u5B58\u5B8C\u6210"),e("sync-state","running","\u5F00\u59CB\u540C\u6B65 CC Switch \u72B6\u6001\u5FEB\u7167");const C=await Q(a,g),o=C.state;i.mcp.configPath=C.configPath,e("sync-state","success","CC Switch \u72B6\u6001\u540C\u6B65\u5B8C\u6210",{skillCount:o.skills.length,mcpCount:o.mcpServers.length,configPath:C.configPath}),e("adapter","running","\u5F00\u59CB\u6267\u884C\u9002\u914D\u5668\u56DE\u5199");const y=await G("init-instance",a,{enabledTools:o.enabledTools,skillEnabled:o.skillEnabled,mcpEnabled:o.mcpEnabled,skillCount:o.skills.length,mcpCount:o.mcpServers.length},g);return e("adapter","success","\u9002\u914D\u5668\u56DE\u5199\u5B8C\u6210",{snapshot:y.snapshot}),e("complete","success",v.length>0?"\u5B9E\u4F8B\u521D\u59CB\u5316\u5B8C\u6210\uFF0C\u672A\u5B89\u88C5\u5DE5\u5177\u5DF2\u8DF3\u8FC7":"\u5B9E\u4F8B\u521D\u59CB\u5316\u5B8C\u6210"),{...i,adapterResult:y,installed:{skills:o.skills,mcpServers:o.mcpServers}}}export{te as initInstance,Q as syncLegacyStateFromSdk};
+import{promises as P}from"node:fs";import w from"node:path";import{downloadPluginZip as A,downloadSkillZip as D,ensureDir as y}from"../utils/file-utils.js";import{createLogger as O}from"../utils/logger.js";import{normalizeMcpPayload as j}from"../utils/mcp-utils.js";import{ensureEnabledTools as z,parseBoolean as T}from"../utils/validation.js";import{getAgentInitRoot as I,loadInstanceState as F,saveInstanceState as $}from"./instance-state.js";import{mcpDeployManager as B,reconcileMcpDefaultsFromDeployed as R}from"./mcp-deploy.js";import{reconcilePluginsDefaultsFromDeployed as L,pluginManager as Z}from"./plugin-manager.js";import{reconcileSkillsDefaultsFromDeployed as q,skillManager as x}from"./skill-manager.js";import{detectToolStatuses as U}from"./tool-installer.js";const W=O("instance-init");function G(i,m){const s=new Set(Object.values(m).filter(o=>o.installed).map(o=>o.tool));return i.filter(o=>s.has(o))}async function H(i,m){try{const s=await D(i,m);if(!s)return null;const o=await P.readFile(s.outputPath),c=i.defaultEnabled!==!1,f=String(i.skillName||"").trim()||void 0,e=await x.saveSharedSkill(o,s.fileName,c,i.sha256,f);return!e.ok||!e.skillName?null:{id:e.skillName,name:e.skillName,fileName:s.fileName,filePath:"",bytes:s.bytes,installedAt:new Date().toISOString()}}catch(s){return W.warn("\u6280\u80FD\u5305\u90E8\u7F72\u5230 bridge \u5931\u8D25\uFF08\u6309\u8DF3\u8FC7\u5904\u7406\uFF09: %s. %s",i.skillName||i.fileName||"(\u672A\u547D\u540D)",s instanceof Error?s.message:String(s)),null}}async function ne(i,m,s){const o=w.resolve(m),c=I(i),f=[];function e(t,l,n,a){f.push({step:t,status:l,message:n,timestamp:new Date().toISOString(),details:a})}e("prepare","running","\u5F00\u59CB\u521D\u59CB\u5316\u5B9E\u4F8B",{agentId:String(i),workspacePath:o}),await y(c),e("prepare","success","\u521D\u59CB\u5316\u76EE\u5F55\u5DF2\u5C31\u7EEA",{initRoot:c});const d=z(s.ccSwitchEnabledTools);e("detect-tools","running","\u5F00\u59CB\u68C0\u6D4B\u5DE5\u5177\u5B89\u88C5\u72B6\u6001",{tools:d});const u=await U(d);e("detect-tools","success","\u5DE5\u5177\u5B89\u88C5\u72B6\u6001\u68C0\u6D4B\u5B8C\u6210",{installedTools:Object.values(u).filter(t=>t.installed).map(t=>t.tool),missingTools:Object.values(u).filter(t=>!t.installed).map(t=>t.tool)});const C=G(d,u),b=Object.values(u).filter(t=>!t.installed),r={ok:!0,agentId:String(i),workspacePath:o,initRoot:c,enabledTools:d,toolStatus:u,logs:f,skill:{enabled:T(s.skillEnabled,!0),packagePresent:!1},mcp:{enabled:T(s.mcpEnabled,!0),configPath:null}},p=await F(i);if(b.length>0&&e("skip-uninstalled-tools","skipped","\u5DF2\u8DF3\u8FC7\u672A\u5B89\u88C5\u5DE5\u5177",{skippedTools:b.map(t=>({tool:t.tool,error:t.error}))}),e("select-installed-tools","success","\u5DF2\u9009\u62E9\u53EF\u521D\u59CB\u5316\u5DE5\u5177",{enabledTools:d,installedTools:C}),e("load-sdk","running","\u5F00\u59CB\u90E8\u7F72\u6280\u80FD/MCP \u6A21\u677F\u5230\u672C bridge"),e("load-sdk","success","\u6280\u80FD/MCP \u6A21\u677F\u90E8\u7F72\u51C6\u5907\u5B8C\u6210",{tools:d}),r.skill.enabled){e("install-skills","running","\u5F00\u59CB\u90E8\u7F72\u6280\u80FD\u5305",{count:Array.isArray(s.skillPackages)?s.skillPackages.length:s.skillPackage?1:0});const t=await y(w.join(c,"skills")),l=Array.isArray(s.skillPackages)&&s.skillPackages.length>0?s.skillPackages:s.skillPackage?[s.skillPackage]:[],n=[];for(const a of l){const S=await H(a,t);S&&n.push(S)}n.length>0?(r.skill.packagePresent=!0,r.skill.installedCount=n.length,r.skill.installed=n,e("install-skills","success","\u6280\u80FD\u5305\u90E8\u7F72\u5B8C\u6210",{installedCount:n.length,skills:n.map(a=>a.name)})):e("install-skills","skipped","\u6CA1\u6709\u53EF\u90E8\u7F72\u7684\u6280\u80FD\u5305")}else e("install-skills","skipped","\u5DF2\u8DF3\u8FC7\u6280\u80FD\u5305\u90E8\u7F72\uFF08skillEnabled=false\uFF09");const k=Array.isArray(s.pluginPackages)?s.pluginPackages:[];if(k.length>0){e("install-plugins","running","\u5F00\u59CB\u90E8\u7F72\u63D2\u4EF6\u6A21\u677F\u5305",{count:k.length});const t=await y(w.join(c,"plugins-tmp"));let l=0;for(const n of k)if(!(!n||!String(n.downloadUrl||"").trim()))try{const a=await A(n,t);if(!a)continue;const S=await P.readFile(a.outputPath),E=n.defaultEnabled!==!1,h=await Z.saveSharedPlugin(S,a.fileName,E,n.sha256);h.ok?(l++,e("install-plugins","success",`\u63D2\u4EF6 ${h.pluginName||a.fileName} \u5DF2\u90E8\u7F72\u5230\u672C bridge`)):e("install-plugins","error",`\u63D2\u4EF6 ${a.fileName} \u90E8\u7F72\u5931\u8D25: ${h.error||"\u672A\u77E5\u9519\u8BEF"}`)}catch(a){e("install-plugins","error",`\u63D2\u4EF6 ${n.fileName||"(\u672A\u547D\u540D)"} \u90E8\u7F72\u5931\u8D25: ${a instanceof Error?a.message:String(a)}`)}r.plugin={enabled:!0,packagePresent:k.length>0,installedCount:l},l>0?e("install-plugins","success","\u63D2\u4EF6\u6A21\u677F\u5305\u90E8\u7F72\u5B8C\u6210",{installedCount:l}):e("install-plugins","skipped","\u6CA1\u6709\u53EF\u90E8\u7F72\u7684\u63D2\u4EF6\u5305"),await P.rm(t,{recursive:!0,force:!0}).catch(()=>{})}const g=[];if(r.mcp.enabled){e("install-mcp","running","\u5F00\u59CB\u90E8\u7F72 MCP \u6A21\u677F",{count:Array.isArray(s.mcpServers)?s.mcpServers.length:0});const t=(Array.isArray(s.mcpServers)?s.mcpServers:[]).map(l=>j(l)).filter(l=>l!==null);for(const l of t){const n={type:l.transport||"stdio",command:l.command||void 0,url:l.url||void 0,args:l.args||void 0,env:l.env||void 0};B.saveMcp(l.name,n,l.enabled!==!1).ok&&g.push({id:l.id||"",name:l.name,transport:l.transport||"stdio",command:l.command||"",url:l.url||"",args:l.args||[],env:l.env||{},enabled:l.enabled!==!1,installedAt:new Date().toISOString()})}r.mcp.installedCount=g.length,e("install-mcp","success","MCP \u6A21\u677F\u90E8\u7F72\u5B8C\u6210",{installedCount:g.length,mcpServers:g.map(l=>l.name)})}else e("install-mcp","skipped","\u5DF2\u8DF3\u8FC7 MCP \u6A21\u677F\uFF08mcpEnabled=false\uFF09");e("persist-state","running","\u5F00\u59CB\u4FDD\u5B58\u5B9E\u4F8B\u72B6\u6001"),p.initialized=!0,p.enabledTools=d,p.toolStatus=u,p.skillEnabled=r.skill.enabled,p.mcpEnabled=r.mcp.enabled,await $(i,p),e("persist-state","success","\u5B9E\u4F8B\u72B6\u6001\u4FDD\u5B58\u5B8C\u6210");const v=q(),M=R(),N=L();return(v||M||N)&&e("sync-state","success","\u80FD\u529B\u9ED8\u8BA4\u5F00\u5173\u5DF2\u5BF9\u8D26\uFF08\u65B0\u589E\u9879\u9ED8\u8BA4\u5173\u95ED\uFF09",{reconciledSkills:v,reconciledMcp:M,reconciledPlugins:N}),e("sync-state","success","\u6280\u80FD/MCP \u6A21\u677F\u90E8\u7F72\u72B6\u6001\u5DF2\u5C31\u7EEA"),e("complete","success",b.length>0?"\u5B9E\u4F8B\u521D\u59CB\u5316\u5B8C\u6210\uFF0C\u672A\u5B89\u88C5\u5DE5\u5177\u5DF2\u8DF3\u8FC7":"\u5B9E\u4F8B\u521D\u59CB\u5316\u5B8C\u6210"),{...r,installed:{skills:r.skill.installed||[],mcpServers:g}}}export{ne as initInstance};
 

package/dist/services/instance-state.js

@@ -1,2 +1,2 @@
-import{promises as i}from"node:fs";import d from"node:os";import a from"node:path";import{getRuntimeHomeDir as l}from"../config.js";import{atomicWriteJsonFile as s,ensureDir as p}from"../utils/file-utils.js";import{ensureEnabledTools as m,parseBoolean as c}from"../utils/validation.js";function S(e){return a.join(d.tmpdir(),"agentswork-runtime-init",String(e),"state.json")}function f(){return{initialized:!1,skills:[],mcpServers:[],enabledTools:["acode","claude","opencode","codex"],toolStatus:{},skillEnabled:!0,mcpEnabled:!0,updatedAt:null}}function u(e){return a.join(l(),".aws-bridge","instances",String(e),"state.json")}async function E(e){const t=u(e),n=S(e);try{const r=await i.readFile(t,"utf-8");return JSON.parse(r)}catch{try{const r=await i.readFile(n,"utf-8"),o=JSON.parse(r);return await s(t,o),o}catch{return f()}}}async function h(e,t){const n=u(e);await p(a.dirname(n));const r={initialized:!!t?.initialized,skills:Array.isArray(t?.skills)?t.skills:[],mcpServers:Array.isArray(t?.mcpServers)?t.mcpServers:[],enabledTools:m(t?.enabledTools),toolStatus:t?.toolStatus&&typeof t.toolStatus=="object"&&!Array.isArray(t.toolStatus)?t.toolStatus:{},skillEnabled:c(t?.skillEnabled,!0),mcpEnabled:c(t?.mcpEnabled,!0),updatedAt:new Date().toISOString()};return await s(n,r),r}function j(e){return a.join(l(),".aws-bridge","instances",String(e))}export{j as getAgentInitRoot,u as getInstanceStateFile,E as loadInstanceState,h as saveInstanceState};
+import{promises as s}from"node:fs";import p from"node:os";import a from"node:path";import{getRuntimeHomeDir as l}from"../config.js";import{atomicWriteJsonFile as c,ensureDir as m,sanitizeAgentId as o}from"../utils/file-utils.js";import{ensureEnabledTools as S,parseBoolean as u}from"../utils/validation.js";function f(e){return a.join(p.tmpdir(),"agentswork-runtime-init",o(String(e)),"state.json")}function g(){return{initialized:!1,skills:[],mcpServers:[],enabledTools:["acode","claude","opencode","codex"],toolStatus:{},skillEnabled:!0,mcpEnabled:!0,updatedAt:null}}function d(e){return a.join(l(),".aws-bridge","instances",o(String(e)),"state.json")}async function I(e){const t=d(e),r=f(e);try{const n=await s.readFile(t,"utf-8");return JSON.parse(n)}catch{try{const n=await s.readFile(r,"utf-8"),i=JSON.parse(n);return await c(t,i),i}catch{return g()}}}async function h(e,t){const r=d(e);await m(a.dirname(r));const n={initialized:!!t?.initialized,skills:Array.isArray(t?.skills)?t.skills:[],mcpServers:Array.isArray(t?.mcpServers)?t.mcpServers:[],enabledTools:S(t?.enabledTools),toolStatus:t?.toolStatus&&typeof t.toolStatus=="object"&&!Array.isArray(t.toolStatus)?t.toolStatus:{},skillEnabled:u(t?.skillEnabled,!0),mcpEnabled:u(t?.mcpEnabled,!0),updatedAt:new Date().toISOString()};return await c(r,n),n}function j(e){return a.join(l(),".aws-bridge","instances",o(String(e)))}export{j as getAgentInitRoot,d as getInstanceStateFile,I as loadInstanceState,h as saveInstanceState};
 

package/dist/services/jdk-scanner.js

@@ -1,2 +1,2 @@
-import i from"node:os";import n from"node:path";import d from"node:crypto";import{promises as c}from"node:fs";import{createLogger as g}from"../utils/logger.js";import{atomicWriteJsonFile as y,withFileLock as j}from"../utils/file-utils.js";const f=g("jdk-scanner");function h(){return n.join(i.tmpdir(),"agentswork-runtime-bridge","jdk-registry.json")}function k(){const a=[];return process.env.JAVA_HOME&&a.push(process.env.JAVA_HOME),i.platform()==="win32"?a.push(n.join(process.env.ProgramFiles||"C:\\Program Files","Java"),n.join(process.env.ProgramFiles||"C:\\Program Files","Eclipse Adoptium"),n.join(process.env.ProgramFiles||"C:\\Program Files","Microsoft"),n.join(process.env.ProgramFiles||"C:\\Program Files","Amazon Corretto"),n.join(process.env.ProgramFiles||"C:\\Program Files","Zulu")):i.platform()==="darwin"?a.push("/Library/Java/JavaVirtualMachines"):a.push("/usr/lib/jvm","/opt/java","/opt/jdk","/usr/local/opt"),a.filter(Boolean)}function w(){return i.platform()==="win32"?"java.exe":"java"}async function u(a){try{return await c.access(n.join(a,"bin",w())),!0}catch{return!1}}async function m(a){try{return(await c.readFile(n.join(a,"release"),"utf-8")).match(/^JAVA_VERSION="?([^"\n]+)"?/m)?.[1]?.trim()||""}catch{return""}}async function C(a){try{return(await c.readdir(a,{withFileTypes:!0})).filter(r=>r.isDirectory()).map(r=>n.join(a,r.name))}catch{return[]}}function v(a){return`scan-${d.createHash("sha1").update(a.toLowerCase()).digest("hex").slice(0,12)}`}async function A(){const a=[],e=new Set,r=k();for(const t of r){const o=await C(t);for(const s of o){const p=s.toLowerCase();e.has(p)||(e.add(p),await u(s)&&a.push({id:v(s),name:n.basename(s),path:s,version:await m(s),source:"scan"}))}}if(process.env.JAVA_HOME&&!e.has(process.env.JAVA_HOME.toLowerCase())){const t=process.env.JAVA_HOME;e.add(t.toLowerCase()),await u(t)&&a.push({id:v(t),name:n.basename(t),path:t,version:await m(t),source:"scan"})}return a.sort((t,o)=>(o.version||"").localeCompare(t.version||"")||t.name.localeCompare(o.name)),a}async function l(){try{const a=await c.readFile(h(),"utf-8"),e=JSON.parse(a);return Array.isArray(e)?e:[]}catch{return[]}}async function J(a){const e=h();await j(e,async()=>{await y(e,a)})}async function D(){const a=await A(),e=await l();if(e.length===0)return a;const r=new Set(a.map(o=>o.path.toLowerCase())),t=[...a];for(const o of e){const s=o.path.toLowerCase();r.has(s)||await u(o.path)&&t.push({id:o.id,name:n.basename(o.path),path:o.path,version:await m(o.path),source:"manual"})}return t}async function V(a){const e=a.trim();if(!e)throw new Error("JDK \u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A");const r=n.resolve(e);if(!await u(r))throw new Error(`\u4E0D\u662F\u6709\u6548\u7684 JDK \u76EE\u5F55\uFF08\u7F3A\u5C11 bin/${w()}\uFF09: ${r}`);const t=await l();if(t.some(s=>s.path.toLowerCase()===r.toLowerCase()))throw new Error("\u8BE5 JDK \u5DF2\u6DFB\u52A0");const o=`manual-${d.randomUUID().slice(0,8)}`;return t.push({id:o,path:r}),await J(t),f.info(`[jdk] \u624B\u52A8\u6DFB\u52A0 JDK: id=${o}, path=${r}`),{id:o,name:n.basename(r),path:r,version:await m(r),source:"manual"}}async function x(a){if(!a.startsWith("manual-"))throw new Error("\u4EC5\u652F\u6301\u5220\u9664\u624B\u52A8\u6DFB\u52A0\u7684 JDK");const e=await l(),r=e.filter(t=>t.id!==a);return r.length===e.length?!1:(await J(r),f.info(`[jdk] \u5220\u9664\u624B\u52A8 JDK: id=${a}`),!0)}export{V as addManualJdk,D as listJdks,x as removeManualJdk,A as scanInstalledJdks};
+import d from"node:crypto";import{promises as i}from"node:fs";import c from"node:os";import n from"node:path";import{atomicWriteJsonFile as g,withFileLock as y}from"../utils/file-utils.js";import{createLogger as j}from"../utils/logger.js";const f=j("jdk-scanner");function h(){return n.join(c.tmpdir(),"agentswork-runtime-bridge","jdk-registry.json")}function k(){const a=[];return process.env.JAVA_HOME&&a.push(process.env.JAVA_HOME),c.platform()==="win32"?a.push(n.join(process.env.ProgramFiles||"C:\\Program Files","Java"),n.join(process.env.ProgramFiles||"C:\\Program Files","Eclipse Adoptium"),n.join(process.env.ProgramFiles||"C:\\Program Files","Microsoft"),n.join(process.env.ProgramFiles||"C:\\Program Files","Amazon Corretto"),n.join(process.env.ProgramFiles||"C:\\Program Files","Zulu")):c.platform()==="darwin"?a.push("/Library/Java/JavaVirtualMachines"):a.push("/usr/lib/jvm","/opt/java","/opt/jdk","/usr/local/opt"),a.filter(Boolean)}function w(){return c.platform()==="win32"?"java.exe":"java"}async function u(a){try{return await i.access(n.join(a,"bin",w())),!0}catch{return!1}}async function m(a){try{return(await i.readFile(n.join(a,"release"),"utf-8")).match(/^JAVA_VERSION="?([^"\n]+)"?/m)?.[1]?.trim()||""}catch{return""}}async function C(a){try{return(await i.readdir(a,{withFileTypes:!0})).filter(r=>r.isDirectory()).map(r=>n.join(a,r.name))}catch{return[]}}function v(a){return`scan-${d.createHash("sha1").update(a.toLowerCase()).digest("hex").slice(0,12)}`}async function A(){const a=[],e=new Set,r=k();for(const t of r){const o=await C(t);for(const s of o){const p=s.toLowerCase();e.has(p)||(e.add(p),await u(s)&&a.push({id:v(s),name:n.basename(s),path:s,version:await m(s),source:"scan"}))}}if(process.env.JAVA_HOME&&!e.has(process.env.JAVA_HOME.toLowerCase())){const t=process.env.JAVA_HOME;e.add(t.toLowerCase()),await u(t)&&a.push({id:v(t),name:n.basename(t),path:t,version:await m(t),source:"scan"})}return a.sort((t,o)=>(o.version||"").localeCompare(t.version||"")||t.name.localeCompare(o.name)),a}async function l(){try{const a=await i.readFile(h(),"utf-8"),e=JSON.parse(a);return Array.isArray(e)?e:[]}catch{return[]}}async function J(a){const e=h();await y(e,async()=>{await g(e,a)})}async function D(){const a=await A(),e=await l();if(e.length===0)return a;const r=new Set(a.map(o=>o.path.toLowerCase())),t=[...a];for(const o of e){const s=o.path.toLowerCase();r.has(s)||await u(o.path)&&t.push({id:o.id,name:n.basename(o.path),path:o.path,version:await m(o.path),source:"manual"})}return t}async function V(a){const e=a.trim();if(!e)throw new Error("JDK \u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A");const r=n.resolve(e);if(!await u(r))throw new Error(`\u4E0D\u662F\u6709\u6548\u7684 JDK \u76EE\u5F55\uFF08\u7F3A\u5C11 bin/${w()}\uFF09: ${r}`);const t=await l();if(t.some(s=>s.path.toLowerCase()===r.toLowerCase()))throw new Error("\u8BE5 JDK \u5DF2\u6DFB\u52A0");const o=`manual-${d.randomUUID().slice(0,8)}`;return t.push({id:o,path:r}),await J(t),f.info(`[jdk] \u624B\u52A8\u6DFB\u52A0 JDK: id=${o}, path=${r}`),{id:o,name:n.basename(r),path:r,version:await m(r),source:"manual"}}async function x(a){if(!a.startsWith("manual-"))throw new Error("\u4EC5\u652F\u6301\u5220\u9664\u624B\u52A8\u6DFB\u52A0\u7684 JDK");const e=await l(),r=e.filter(t=>t.id!==a);return r.length===e.length?!1:(await J(r),f.info(`[jdk] \u5220\u9664\u624B\u52A8 JDK: id=${a}`),!0)}export{V as addManualJdk,D as listJdks,x as removeManualJdk,A as scanInstalledJdks};
 

package/dist/services/launch-manager.js

@@ -1,4 +1,4 @@
-import{exec as _,spawn as j}from"node:child_process";import{promises as z}from"node:fs";import A from"node:os";import M from"node:path";import{promisify as F}from"node:util";import{atomicWriteJsonFile as J,withFileLock as U}from"../utils/file-utils.js";import{createLogger as G}from"../utils/logger.js";import{getListeningPortsForProcessTrees as L}from"./port-detector.js";import{LaunchMetricsMonitor as V}from"./launch-metrics.js";import{isProcessRunning as E,terminateProcessTree as k}from"./process-detector.js";import{RingBuffer as O}from"./ring-buffer.js";import{getLaunchStreamHub as P}from"./launch-streams.js";const C=F(_),g=G("launch-manager"),D=5e3,B=4096,X=1500,K=20;function H(){return M.join(A.tmpdir(),"agentswork-runtime-bridge","launch-runs.json")}function Y(l,t){return l.replace(/\$\{([^}]+)\}/g,(e,s)=>{const r=s.trim(),i=r.toUpperCase();if(i==="WORKSPACE")return t.workspacePath||"";if(i==="JAVA_HOME")return t.jdkPath||process.env.JAVA_HOME||"";if(i==="HOME")return A.homedir();if(t.env&&t.env[r]!==void 0)return t.env[r];if(t.env){for(const[n,a]of Object.entries(t.env))if(n.toUpperCase()===i)return a}return e})}function Z(l){const t={...process.env};l.env&&Object.assign(t,l.env);for(const e of Object.keys(t))if(e.toUpperCase()==="PATH"&&e!=="PATH"){const s=t[e];delete t[e],t.PATH===void 0&&typeof s=="string"&&(t.PATH=s)}if(l.jdkPath){t.JAVA_HOME=l.jdkPath;const e=M.join(l.jdkPath,"bin"),s=M.delimiter;t.PATH=t.PATH?`${e}${s}${t.PATH}`:e}return t}const Q=256,q=120;class N{constructor(t=()=>{}){this.utf8Probe=new TextDecoder("utf-8",{fatal:!0}),this.utf8=new TextDecoder("utf-8"),this.gbk=new TextDecoder("gbk"),this.mode=null,this.buffered=[],this.bufferedSize=0,this.flushTimer=null,this.onFlush=t}decode(t){return this.mode!==null?(this.mode==="gbk"?this.gbk:this.utf8).decode(t,{stream:!0}):(this.buffered.push(t),this.bufferedSize+=t.length,this.bufferedSize>=Q?this.commit():(this.flushTimer===null&&(this.flushTimer=setTimeout(()=>{this.flushTimer=null,this.onFlush(this.commit())},q)),""))}finalize(){return this.flushTimer!==null&&(clearTimeout(this.flushTimer),this.flushTimer=null),this.mode===null?this.commit():(this.mode==="gbk"?this.gbk:this.utf8).decode()}commit(){if(this.flushTimer!==null&&(clearTimeout(this.flushTimer),this.flushTimer=null),this.mode!==null)return"";const t=Buffer.concat(this.buffered,this.bufferedSize);this.buffered=[],this.bufferedSize=0;try{return this.utf8Probe.decode(t),this.mode="utf8",this.utf8.decode(t)}catch{return this.mode="gbk",this.gbk.decode(t)}}}function tt(l){const t=l.length>0&&!l.endsWith(`
+import{exec as _,spawn as j}from"node:child_process";import{promises as z}from"node:fs";import A from"node:os";import M from"node:path";import{promisify as F}from"node:util";import{atomicWriteJsonFile as J,withFileLock as U}from"../utils/file-utils.js";import{createLogger as G}from"../utils/logger.js";import{LaunchMetricsMonitor as V}from"./launch-metrics.js";import{getLaunchStreamHub as P}from"./launch-streams.js";import{getListeningPortsForProcessTrees as L}from"./port-detector.js";import{isProcessRunning as E,terminateProcessTree as k}from"./process-detector.js";import{RingBuffer as O}from"./ring-buffer.js";const C=F(_),g=G("launch-manager"),D=5e3,B=4096,X=1500,K=20;function H(){return M.join(A.tmpdir(),"agentswork-runtime-bridge","launch-runs.json")}function Y(l,t){return l.replace(/\$\{([^}]+)\}/g,(e,s)=>{const r=s.trim(),i=r.toUpperCase();if(i==="WORKSPACE")return t.workspacePath||"";if(i==="JAVA_HOME")return t.jdkPath||process.env.JAVA_HOME||"";if(i==="HOME")return A.homedir();if(t.env&&t.env[r]!==void 0)return t.env[r];if(t.env){for(const[n,a]of Object.entries(t.env))if(n.toUpperCase()===i)return a}return e})}function Z(l){const t={...process.env};l.env&&Object.assign(t,l.env);for(const e of Object.keys(t))if(e.toUpperCase()==="PATH"&&e!=="PATH"){const s=t[e];delete t[e],t.PATH===void 0&&typeof s=="string"&&(t.PATH=s)}if(l.jdkPath){t.JAVA_HOME=l.jdkPath;const e=M.join(l.jdkPath,"bin"),s=M.delimiter;t.PATH=t.PATH?`${e}${s}${t.PATH}`:e}return t}const Q=256,q=120;class N{constructor(t=()=>{}){this.utf8Probe=new TextDecoder("utf-8",{fatal:!0}),this.utf8=new TextDecoder("utf-8"),this.gbk=new TextDecoder("gbk"),this.mode=null,this.buffered=[],this.bufferedSize=0,this.flushTimer=null,this.onFlush=t}decode(t){return this.mode!==null?(this.mode==="gbk"?this.gbk:this.utf8).decode(t,{stream:!0}):(this.buffered.push(t),this.bufferedSize+=t.length,this.bufferedSize>=Q?this.commit():(this.flushTimer===null&&(this.flushTimer=setTimeout(()=>{this.flushTimer=null,this.onFlush(this.commit())},q)),""))}finalize(){return this.flushTimer!==null&&(clearTimeout(this.flushTimer),this.flushTimer=null),this.mode===null?this.commit():(this.mode==="gbk"?this.gbk:this.utf8).decode()}commit(){if(this.flushTimer!==null&&(clearTimeout(this.flushTimer),this.flushTimer=null),this.mode!==null)return"";const t=Buffer.concat(this.buffered,this.bufferedSize);this.buffered=[],this.bufferedSize=0;try{return this.utf8Probe.decode(t),this.mode="utf8",this.utf8.decode(t)}catch{return this.mode="gbk",this.gbk.decode(t)}}}function tt(l){const t=l.length>0&&!l.endsWith(`
 `)?l+`
 `:l;return t.length>B?t.slice(-B):t}async function et(l){const t=A.platform();for(let e=0;e<6;e+=1){try{if(t==="win32"){const s=`Get-CimInstance Win32_Process -Filter "ParentProcessId = ${l} AND Name <> 'conhost.exe'" | Select-Object -First 1 ProcessId | ConvertTo-Json -Compress`,r=Buffer.from(s,"utf16le").toString("base64"),{stdout:i}=await C(`powershell -NoProfile -NonInteractive -EncodedCommand ${r}`,{encoding:"utf8",timeout:5e3,windowsHide:!0}),n=i.replace(/#\s*<\s*CLIXML[\s\S]*?(?=\{|\[|$)/g,"").trim(),a=JSON.parse(n||"null"),h=Number(a?.ProcessId);if(Number.isFinite(h)&&h>0)return h}else{const{stdout:s}=await C(`pgrep -P ${l} | head -n 1`,{encoding:"utf8",timeout:3e3}),r=Number(s.trim());if(Number.isFinite(r)&&r>0)return r}}catch{}await new Promise(s=>setTimeout(s,300))}return null}class S{constructor(){this.runs=new Map,this.logs=new Map,this.startupWaiters=new Map,this.readinessMatchers=new Map,this.logListeners=new Map,this.metricsMonitor=new V(()=>this.runningRefs()),this.restored=!1}static getInstance(){return S.instance===null&&(S.instance=new S),S.instance}runningRefs(){const t=[];for(const e of this.runs.values())e.state==="running"&&e.pid>0&&t.push({configId:e.configId,pid:e.pid});return t}async start(t){const e=t.configId;if(!e||!e.trim())throw new Error("configId is required");if(!t.command||!t.command.trim())throw new Error("command is required");let s=null;if(t.readinessPattern&&t.readinessPattern.trim())try{s=new RegExp(t.readinessPattern.trim())}catch(o){throw new Error(`readinessPattern \u6B63\u5219\u8BED\u6CD5\u65E0\u6548: ${o.message}`)}const r=t.startedBy?.trim()||void 0;await this.ensureRestored();const i=this.runs.get(e);if(i&&i.state==="running"&&E(i.pid))throw new Error(`\u542F\u52A8\u9879\u5DF2\u5728\u8FD0\u884C: pid=${i.pid}`);const n=Y(t.command,{workspacePath:t.workspacePath,jdkPath:t.jdkPath,env:t.env}),a=t.cwd||t.workspacePath||process.cwd(),h=Z(t);g.info(`[start] \u542F\u52A8\u547D\u4EE4: configId=${e}, cwd=${a}, command=${n}`);let m;try{m=j(n,{cwd:a,env:h,shell:!0,windowsHide:!0})}catch(o){const c=`\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${o.message}`;throw g.error(`[start] spawn \u5931\u8D25: configId=${e}, error=${c}`),new Error(c)}const w=m.pid??0,T={configId:e,pid:w,state:"running",startedAt:new Date().toISOString(),command:n,cwd:a,...r?{startedBy:r}:{}};this.runs.set(e,T),this.publishRunStatus(e,!0),this.metricsMonitor.clear(e),this.metricsMonitor.ensureRunning();let p=this.logs.get(e);p||(p=new O(D),this.logs.set(e,p));const $=p.getSinceIndex(-1).nextIndex;s?this.readinessMatchers.set(e,{pattern:s,fromIndex:$+1}):this.readinessMatchers.delete(e);const b=p.append({stream:"stdout",text:`> ${n}
 `});P().publish(e,"logs",b.index,b.data);let R=null;(async()=>{const o=await et(w),c=this.runs.get(e);o&&c?.pid===w&&(R=o,this.runs.set(e,{...c,pid:o}),await this.persist(),this.publishRunStatus(e))})();const x=o=>o!==void 0&&(o.pid===w||o.pid===R),u=new N(o=>{f("stdout",o)}),d=new N(o=>{f("stderr",o)}),f=(o,c)=>{const y=tt(c);if(y){const v=p.append({stream:o,text:y});P().publish(e,"logs",v.index,v.data);const I=this.logListeners.get(e);if(I&&I.size>0)for(const W of I)try{W(v)}catch{}}};return m.stdout.on("data",o=>{f("stdout",u.decode(o))}),m.stderr.on("data",o=>{f("stderr",d.decode(o))}),m.on("error",o=>{f("stderr",`[\u542F\u52A8\u5931\u8D25] ${o.message}

package/dist/services/legacy-path-migration.d.ts

@@ -1,2 +1,4 @@
 
 export declare function migrateOldPathsOnStartup(): void;
+
+export declare function migrateSkillPaths(): void;

package/dist/services/legacy-path-migration.js

@@ -1,2 +1,2 @@
-import{existsSync as i,mkdirSync as a,copyFileSync as f,readdirSync as u}from"node:fs";import o from"node:path";import{getRuntimeHomeDir as r}from"../config.js";import{createLogger as p}from"../utils/logger.js";import{migrateOldBindingDir as j}from"./runtime-binding.js";const e=p("legacy-path-migration");function m(){return o.join(r(),".agentswork","runtime-bridge")}function s(){return o.join(r(),".aws-bridge")}function y(){const n=o.join(m(),"lifecycle-state.json"),t=o.join(s(),"lifecycle-state.json");i(n)&&!i(t)&&(a(s(),{recursive:!0}),f(n,t),e.info(`[runtime-bridge] \u5DF2\u8FC1\u79FB lifecycle-state.json \u2192 ${t}`))}function h(){const n=o.join(r(),".agentswork","snapshots"),t=o.join(s(),"snapshots");if(i(n)&&!i(t)){a(t,{recursive:!0});try{const g=u(n);for(const c of g){const d=o.join(n,c),l=o.join(t,c);f(d,l)}e.info(`[runtime-bridge] \u5DF2\u8FC1\u79FB snapshots/ \u5230 ${t}`)}catch{e.warn("[runtime-bridge] snapshots/ \u8FC1\u79FB\u5931\u8D25\uFF08\u90E8\u5206\u6587\u4EF6\u53EF\u80FD\u88AB\u8DF3\u8FC7\uFF09")}}}function R(){const n=m();if(!i(n)){const t=o.join(r(),".agentswork","snapshots");if(!i(t))return}e.info("[runtime-bridge] \u68C0\u6D4B\u5230\u65E7\u8DEF\u5F84 ~/.agentswork/\uFF0C\u6B63\u5728\u8FC1\u79FB\u5230 ~/.aws-bridge/ ..."),j(),y(),h()}export{R as migrateOldPathsOnStartup};
+import{existsSync as o,mkdirSync as g,copyFileSync as m,readdirSync as d,cpSync as p}from"node:fs";import e from"node:path";import{getAcodeDataHome as h,getAcodeSkillDataHome as y,getRuntimeHomeDir as a}from"../config.js";import{createLogger as S}from"../utils/logger.js";import{migrateOldBindingDir as k}from"./runtime-binding.js";const r=S("legacy-path-migration");function j(){return e.join(a(),".agentswork","runtime-bridge")}function u(){return e.join(a(),".aws-bridge")}function w(){const n=e.join(j(),"lifecycle-state.json"),t=e.join(u(),"lifecycle-state.json");o(n)&&!o(t)&&(g(u(),{recursive:!0}),m(n,t),r.info(`[runtime-bridge] \u5DF2\u8FC1\u79FB lifecycle-state.json \u2192 ${t}`))}function b(){const n=e.join(a(),".agentswork","snapshots"),t=e.join(u(),"snapshots");if(o(n)&&!o(t)){g(t,{recursive:!0});try{const s=d(n);for(const i of s){const l=e.join(n,i),c=e.join(t,i);m(l,c)}r.info(`[runtime-bridge] \u5DF2\u8FC1\u79FB snapshots/ \u5230 ${t}`)}catch{r.warn("[runtime-bridge] snapshots/ \u8FC1\u79FB\u5931\u8D25\uFF08\u90E8\u5206\u6587\u4EF6\u53EF\u80FD\u88AB\u8DF3\u8FC7\uFF09")}}}function O(){D();const n=j();if(!o(n)){const t=e.join(a(),".agentswork","snapshots");if(!o(t))return}r.info("[runtime-bridge] \u68C0\u6D4B\u5230\u65E7\u8DEF\u5F84 ~/.agentswork/\uFF0C\u6B63\u5728\u8FC1\u79FB\u5230 ~/.aws-bridge/ ..."),k(),w(),b()}function D(){const n=e.join(y(),"skills","deployed"),t=e.join(y(),"skills-runtime");R(n),v(t)}function $(n,t,s){if(!(!o(n)||o(t)))try{p(n,t,{recursive:!0}),r.info(`[runtime-bridge] \u5DF2\u8FC1\u79FB ${s} \u2192 ${t}`)}catch(i){r.warn(`[runtime-bridge] ${s} \u8FC1\u79FB\u5931\u8D25: ${i instanceof Error?i.message:String(i)}`)}}function R(n){const t=e.join(h(),"skills-deployed");$(t,n,"\u6280\u80FD\u90E8\u7F72\u533A")}function v(n){const t=e.join(a(),".aws-bridge","instances");if(!o(t))return;let s=[];try{s=d(t).filter(i=>!i.startsWith("."))}catch{return}for(const i of s){const l=e.join(t,i,"skills");if(!o(l))continue;const c=e.join(n,i);if(!o(c))try{p(l,c,{recursive:!0}),r.info(`[runtime-bridge] \u5DF2\u8FC1\u79FB\u5B9E\u4F8B\u6280\u80FD\u519C\u573A ${i} \u2192 ${c}`)}catch(f){r.warn(`[runtime-bridge] \u5B9E\u4F8B\u6280\u80FD\u519C\u573A ${i} \u8FC1\u79FB\u5931\u8D25: ${f instanceof Error?f.message:String(f)}`)}}}export{O as migrateOldPathsOnStartup,D as migrateSkillPaths};
 

package/dist/services/lifecycle-state.js

@@ -1,3 +1,3 @@
-import s from"node:fs/promises";import o from"node:path";import{randomUUID as p}from"node:crypto";import g from"axios";import{getRuntimeHomeDir as y,resolveSchedulerBaseUrlFrom as c}from"../config.js";import{getRuntimeAccessToken as B,loadRuntimeBinding as w,normalizeSchedulerBaseUrl as n}from"./runtime-binding.js";import{createLogger as U}from"../utils/logger.js";const d=U("bridge-lifecycle");function l(){return o.join(y(),".aws-bridge","lifecycle-state.json")}function u(e){return String(e||"").trim()||void 0}async function a(){try{const e=await s.readFile(l(),"utf8"),t=JSON.parse(e);return{operations:Array.isArray(t.operations)?t.operations:[]}}catch{return{operations:[]}}}async function f(e){const t=l();await s.mkdir(o.dirname(t),{recursive:!0}),await s.writeFile(t,`${JSON.stringify(e,null,2)}
-`,{encoding:"utf8",mode:384})}function D(e){const t=new Date().toISOString(),r=n(e.schedulerBaseUrl)||c(void 0).url;return{operationId:p(),operationType:e.operationType,status:e.status||"accepted",requestedByUserId:e.requestedByUserId,requestedAt:t,updatedAt:t,schedulerBaseUrl:r,runtimeBridgeBaseUrl:u(e.runtimeBridgeBaseUrl),message:e.message,latestVersion:u(e.latestVersion)}}async function V(e){const r=(await a()).operations.filter(i=>i.operationId!==e.operationId);r.push({...e,updatedAt:new Date().toISOString()}),await f({operations:r})}async function I(e){const t=await a();await f({operations:t.operations.filter(r=>r.operationId!==e)})}function h(e){return["succeeded","failed","startup-confirmed"].includes(e.status)}async function S(e){const t=n(e.schedulerBaseUrl)||n(w().schedulerBaseUrl)||c(void 0).url,r=B(t);if(!r)throw new Error("runtime access token is missing");await g.post(`${t}/api/runtime/callback/bridge-lifecycle`,{operationId:e.operationId,operationType:e.operationType,status:e.status,requestedByUserId:e.requestedByUserId,message:e.message,error:e.error,runtimeBridgeBaseUrl:e.runtimeBridgeBaseUrl,latestVersion:e.latestVersion},{headers:{"X-Runtime-Token":r}})}function v(e){return e.operationType==="update"&&(e.status==="accepted"||e.status==="running")?{...e,status:"failed",message:"Bridge \u66F4\u65B0\u4E2D\u65AD\uFF0C\u8FDB\u7A0B\u5DF2\u91CD\u542F\uFF0C\u8BF7\u91CD\u65B0\u53D1\u8D77\u66F4\u65B0\u3002",error:e.error||"update interrupted by process restart"}:{...e,status:"startup-confirmed",message:e.operationType==="update"?e.latestVersion?`\u66F4\u65B0\u5E76\u91CD\u542F\u5B8C\u6210\uFF0C\u5F53\u524D\u7248\u672C v${e.latestVersion}\u3002`:"\u66F4\u65B0\u5E76\u91CD\u542F\u5B8C\u6210\u3002":"Bridge \u91CD\u542F\u5B8C\u6210\uFF0C\u5B9E\u4F8B\u5DF2\u6062\u590D\u8FD0\u884C\u3002"}}async function $(){const e=await a();for(const t of e.operations){const r=v(t);if(h(r))try{await S(r),await I(t.operationId),d.info(`[bridge-lifecycle] notification delivered: ${t.operationId}`)}catch(i){const m=i;d.warn(`[bridge-lifecycle] notification delivery failed: ${t.operationId}, ${m.message}`)}}}export{D as createBridgeLifecycleOperation,$ as deliverPendingBridgeLifecycleNotifications,a as loadLifecycleState,I as removeBridgeLifecycleOperation,V as upsertBridgeLifecycleOperation};
+import{randomUUID as p}from"node:crypto";import s from"node:fs/promises";import o from"node:path";import g from"axios";import{getRuntimeHomeDir as y,resolveSchedulerBaseUrlFrom as c}from"../config.js";import{createLogger as B}from"../utils/logger.js";import{getRuntimeAccessToken as w,loadRuntimeBinding as U,normalizeSchedulerBaseUrl as n}from"./runtime-binding.js";const d=B("bridge-lifecycle");function l(){return o.join(y(),".aws-bridge","lifecycle-state.json")}function u(e){return String(e||"").trim()||void 0}async function a(){try{const e=await s.readFile(l(),"utf8"),t=JSON.parse(e);return{operations:Array.isArray(t.operations)?t.operations:[]}}catch{return{operations:[]}}}async function f(e){const t=l();await s.mkdir(o.dirname(t),{recursive:!0}),await s.writeFile(t,`${JSON.stringify(e,null,2)}
+`,{encoding:"utf8",mode:384})}function D(e){const t=new Date().toISOString(),r=n(e.schedulerBaseUrl)||c(void 0).url;return{operationId:p(),operationType:e.operationType,status:e.status||"accepted",requestedByUserId:e.requestedByUserId,requestedAt:t,updatedAt:t,schedulerBaseUrl:r,runtimeBridgeBaseUrl:u(e.runtimeBridgeBaseUrl),message:e.message,latestVersion:u(e.latestVersion)}}async function V(e){const r=(await a()).operations.filter(i=>i.operationId!==e.operationId);r.push({...e,updatedAt:new Date().toISOString()}),await f({operations:r})}async function I(e){const t=await a();await f({operations:t.operations.filter(r=>r.operationId!==e)})}function h(e){return["succeeded","failed","startup-confirmed"].includes(e.status)}async function S(e){const t=n(e.schedulerBaseUrl)||n(U().schedulerBaseUrl)||c(void 0).url,r=w(t);if(!r)throw new Error("runtime access token is missing");await g.post(`${t}/api/runtime/callback/bridge-lifecycle`,{operationId:e.operationId,operationType:e.operationType,status:e.status,requestedByUserId:e.requestedByUserId,message:e.message,error:e.error,runtimeBridgeBaseUrl:e.runtimeBridgeBaseUrl,latestVersion:e.latestVersion},{headers:{"X-Runtime-Token":r}})}function v(e){return e.operationType==="update"&&(e.status==="accepted"||e.status==="running")?{...e,status:"failed",message:"Bridge \u66F4\u65B0\u4E2D\u65AD\uFF0C\u8FDB\u7A0B\u5DF2\u91CD\u542F\uFF0C\u8BF7\u91CD\u65B0\u53D1\u8D77\u66F4\u65B0\u3002",error:e.error||"update interrupted by process restart"}:{...e,status:"startup-confirmed",message:e.operationType==="update"?e.latestVersion?`\u66F4\u65B0\u5E76\u91CD\u542F\u5B8C\u6210\uFF0C\u5F53\u524D\u7248\u672C v${e.latestVersion}\u3002`:"\u66F4\u65B0\u5E76\u91CD\u542F\u5B8C\u6210\u3002":"Bridge \u91CD\u542F\u5B8C\u6210\uFF0C\u5B9E\u4F8B\u5DF2\u6062\u590D\u8FD0\u884C\u3002"}}async function $(){const e=await a();for(const t of e.operations){const r=v(t);if(h(r))try{await S(r),await I(t.operationId),d.info(`[bridge-lifecycle] notification delivered: ${t.operationId}`)}catch(i){const m=i;d.warn(`[bridge-lifecycle] notification delivery failed: ${t.operationId}, ${m.message}`)}}}export{D as createBridgeLifecycleOperation,$ as deliverPendingBridgeLifecycleNotifications,a as loadLifecycleState,I as removeBridgeLifecycleOperation,V as upsertBridgeLifecycleOperation};
 

package/dist/services/mcp-deploy.d.ts

@@ -0,0 +1,49 @@
+
+export interface DeployedMcpEntry {
+    name: string;
+    fileName: string;
+    defaultEnabled: boolean;
+    sha256?: string;
+}
+export interface McpDeployResult {
+    ok: boolean;
+    error?: string;
+    name?: string;
+}
+
+export interface McpDeploySpec {
+    type: string;
+    command?: string;
+    url?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+export declare class McpDeployManager {
+    private readonly rootDir;
+    private static _instance;
+    static getInstance(): McpDeployManager;
+    private constructor();
+    private manifestFile;
+    private specFile;
+    private isHealthy;
+    private readManifest;
+    private writeManifest;
+    
+    saveMcp(name: string, spec: McpDeploySpec, defaultEnabled?: boolean, sha256?: string): McpDeployResult;
+    
+    removeMcp(name: string): {
+        ok: boolean;
+        error?: string;
+    };
+    
+    listDeployed(): DeployedMcpEntry[];
+    
+    getSpec(name: string): McpDeploySpec | null;
+    
+    resolveEnabledMcp(agentId: string, globalMcpServers: Record<string, unknown>): Record<string, unknown>;
+    
+    deployedDefaultEnabled(): Record<string, boolean>;
+}
+export declare const mcpDeployManager: McpDeployManager;
+export declare const reconcileMcpDefaultsFromDeployed: () => number;

package/dist/services/mcp-deploy.js

@@ -0,0 +1,4 @@
+import{existsSync as h,mkdirSync as a,readFileSync as l,rmSync as m,writeFileSync as f}from"node:fs";import n from"node:path";import{getAcodeDataHome as y}from"../config.js";import{createLogger as d}from"../utils/logger.js";import{setDeployedDefaultsProvider as M,reconcileDefaultsFromDeployed as g}from"./capability-config.js";import{isCapabilityEnabled as p}from"./instance-features.js";const u=d("mcp-deploy"),D=1;class c{static getInstance(){return this._instance||(this._instance=new c(n.join(y(),"mcp-deployed"))),this._instance}constructor(e){this.rootDir=e}manifestFile(){return n.join(this.rootDir,"manifest.json")}specFile(e){const t=n.join(this.rootDir,`${e}.json`),r=n.resolve(this.rootDir);if(n.resolve(t)!==n.join(r,`${e}.json`))throw new Error(`MCP \u6A21\u677F\u6587\u4EF6\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return t}isHealthy(e){return h(this.specFile(e))}readManifest(){try{const e=JSON.parse(l(this.manifestFile(),"utf8"));return Array.isArray(e.servers)?e.servers.filter(t=>t&&t.name):[]}catch{return[]}}writeManifest(e){a(this.rootDir,{recursive:!0}),f(this.manifestFile(),`${JSON.stringify({version:D,servers:e},null,2)}
+`,"utf8")}saveMcp(e,t,r=!0,i){if(!e||!/^[a-zA-Z0-9_.-]+$/.test(e))return{ok:!1,error:`MCP \u540D\u975E\u6CD5: ${JSON.stringify(e)}`};a(this.rootDir,{recursive:!0});try{f(this.specFile(e),`${JSON.stringify(t,null,2)}
+`,"utf8")}catch(o){return{ok:!1,error:`MCP \u6A21\u677F\u5199\u5165\u5931\u8D25: ${o instanceof Error?o.message:String(o)}`}}const s=this.readManifest().filter(o=>o.name!==e);return s.push({name:e,fileName:`${e}.json`,defaultEnabled:r,sha256:i}),this.writeManifest(s),u.info("[mcp] MCP \u6A21\u677F\u5DF2\u90E8\u7F72\u5230 bridge: %s",e),{ok:!0,name:e}}removeMcp(e){if(!e||!/^[a-zA-Z0-9_.-]+$/.test(e))return{ok:!1,error:"name \u975E\u6CD5"};const t=this.readManifest().filter(r=>r.name!==e);this.writeManifest(t);try{m(this.specFile(e),{force:!0})}catch(r){return{ok:!1,error:`\u6A21\u677F\u6587\u4EF6\u6E05\u7406\u5931\u8D25: ${r instanceof Error?r.message:String(r)}`}}return u.info("[mcp] MCP \u6A21\u677F\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",e),{ok:!0}}listDeployed(){return this.readManifest().map(e=>({...e,deployed:this.isHealthy(e.name)}))}getSpec(e){if(!this.isHealthy(e))return null;try{return JSON.parse(l(this.specFile(e),"utf8"))}catch{return null}}resolveEnabledMcp(e,t){const r={};for(const i of this.readManifest()){if(!p(e,"mcp",i.name)||!this.isHealthy(i.name))continue;const s=this.getSpec(i.name);s&&(r[i.name]={...s,type:s.type||"stdio"})}for(const[i,s]of Object.entries(t))p(e,"mcp",i)&&(r[i]||(r[i]=s));return r}deployedDefaultEnabled(){const e={};for(const t of this.readManifest())e[t.name]=t.defaultEnabled;return e}}c._instance=null;const S=c.getInstance();M("mcp",()=>S.deployedDefaultEnabled());const w=()=>g("mcp");export{c as McpDeployManager,S as mcpDeployManager,w as reconcileMcpDefaultsFromDeployed};
+

package/dist/services/orphan-monitor.js

@@ -1,2 +1,2 @@
-import{createLogger as m}from"../utils/logger.js";import{loadPersistedSessions as f,savePersistedSessions as g}from"./terminal-persistence.js";import{detectOrphanProcesses as w,checkAllSessionsHealth as S,terminateProcessTree as $,waitForProcessExit as y}from"./process-detector.js";import{ORPHAN_SCAN_INTERVAL as d,ORPHAN_AUTO_CLEAN_MODE as r,ORPHAN_SCAN_ENABLED as v,schedulerBaseUrl as o}from"../config.js";import{getRuntimeAccessToken as c}from"./runtime-binding.js";import{shouldAutoCleanOrphanProcesses as l}from"./runtime-lifecycle-policy.js";const n=m("orphan-monitor");class O{constructor(){this.intervalId=null,this.lastScanTime=null,this.eventListeners=[],this.stopped=!1}async start(){if(!v){n.info("\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\u5DF2\u7981\u7528 (AWS_ORPHAN_SCAN_ENABLED=false)");return}this.stopped=!1,n.info(`\u542F\u52A8\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\uFF0C\u626B\u63CF\u95F4\u9694: ${d}ms, \u81EA\u52A8\u6E05\u7406\u6A21\u5F0F: ${r}`),await this.scan(),this.intervalId=setInterval(async()=>{await this.scan()},d),n.info("\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\u5DF2\u542F\u52A8")}stop(){this.stopped=!0,this.intervalId&&(clearInterval(this.intervalId),this.intervalId=null,n.info("\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\u5DF2\u505C\u6B62"))}async scan(){if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u8DF3\u8FC7\u626B\u63CF");return}this.lastScanTime=new Date,n.debug("\u5F00\u59CB\u626B\u63CF\u5B64\u513F\u8FDB\u7A0B...");try{const e=await f();if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u4E2D\u65AD\u626B\u63CF");return}if(e.length===0){n.debug("\u65E0\u6301\u4E45\u5316\u4F1A\u8BDD\uFF0C\u8DF3\u8FC7\u626B\u63CF");return}const t=await w(e.map(s=>({agentId:s.agentId,pid:s.pid,workspacePath:s.workspacePath,command:s.command})));if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u4E2D\u65AD\u626B\u63CF");return}const a=await S(e.filter(s=>s.pid).map(s=>({agentId:s.agentId,pid:s.pid})));if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u4E2D\u65AD\u626B\u63CF");return}for(const s of t){if(this.stopped)break;await this.handleOrphanDetected(s.agentId,s.process.pid)}for(const[s,i]of a){if(this.stopped)break;i.status!=="healthy"&&i.alive&&await this.handleHealthIssue(s,i)}this.stopped||await this.cleanupDeadSessions(e,a)}catch(e){n.warn("\u626B\u63CF\u5B64\u513F\u8FDB\u7A0B\u5931\u8D25:",e)}}async handleOrphanDetected(e,t){const a={type:"orphan_detected",agentId:e,pid:t,message:`\u68C0\u6D4B\u5230\u5B64\u513F\u8FDB\u7A0B: agentId=${e}, pid=${t}`,timestamp:new Date};if(this.emit(a),n.warn(`\u68C0\u6D4B\u5230\u5B64\u513F\u8FDB\u7A0B: agentId=${e}, pid=${t}`),await this.checkAgentExistsOnServer(e)===!1){n.info(`agent ${e} \u5DF2\u4ECE\u670D\u52A1\u7AEF\u5220\u9664\uFF0C\u81EA\u52A8\u7EC8\u6B62\u6B8B\u7559\u8FDB\u7A0B pid=${t}`),await this.autoCleanOrphan(e,t);return}switch(r){case"auto":l()?await this.autoCleanOrphan(e,t):(n.warn("auto \u6A21\u5F0F\u672A\u542F\u7528\u7834\u574F\u6027\u6E05\u7406\u5F00\u5173\uFF0C\u6539\u4E3A\u544A\u8B66\u5E76\u4FDD\u7559\u5B64\u513F\u8FDB\u7A0B"),await this.reportToScheduler(e,"orphan_detected",{pid:t}));break;case"alert":await this.reportToScheduler(e,"orphan_detected",{pid:t});break;case"manual":n.info("manual \u6A21\u5F0F\uFF0C\u4EC5\u8BB0\u5F55\u65E5\u5FD7\uFF0C\u4E0D\u81EA\u52A8\u5904\u7406");break}}async handleHealthIssue(e,t){const a=t.status==="unresponsive"?"process_unresponsive":t.status==="high_cpu"?"process_high_cpu":"process_high_memory",s={type:a,agentId:e,pid:t.pid,message:`\u8FDB\u7A0B\u5065\u5EB7\u5F02\u5E38: ${t.status}, CPU=${t.cpu}%, Memory=${t.memoryMB}MB`,timestamp:new Date,details:{cpu:t.cpu,memoryMB:t.memoryMB}};this.emit(s),await this.reportToScheduler(e,a,{pid:t.pid,cpu:t.cpu,memoryMB:t.memoryMB}),r==="auto"&&t.status!=="healthy"&&l()?(n.warn(`auto \u6A21\u5F0F: \u7EC8\u6B62\u5F02\u5E38\u8FDB\u7A0B ${t.pid} (${t.status})`),await this.autoCleanOrphan(e,t.pid)):r==="auto"&&t.status!=="healthy"&&n.warn(`auto \u6A21\u5F0F\u672A\u542F\u7528\u7834\u574F\u6027\u6E05\u7406\u5F00\u5173\uFF0C\u4FDD\u7559\u5F02\u5E38\u8FDB\u7A0B ${t.pid} (${t.status})`)}async autoCleanOrphan(e,t){n.info(`\u81EA\u52A8\u6E05\u7406\u5B64\u513F\u8FDB\u7A0B\uFF1AagentId=${e}, pid=${t}`);const a=await $(t),s=await y(t,5e3);if(a.terminated>0&&s){const i={type:"orphan_cleaned",agentId:e,pid:t,message:`\u81EA\u52A8\u6E05\u7406\u6210\u529F\uFF1AagentId=${e}, pid=${t}, \u7EC8\u6B62\u4E86 ${a.terminated} \u4E2A\u8FDB\u7A0B`,timestamp:new Date,details:{terminated:a.terminated,failed:a.failed}};this.emit(i),await this.reportToScheduler(e,"orphan_cleaned",{pid:t,terminated:a.terminated,failed:a.failed})}else n.warn(`\u81EA\u52A8\u6E05\u7406\u5931\u8D25\uFF1AagentId=${e}, pid=${t}, terminated=${a.terminated}, exited=${s}`),await this.reportToScheduler(e,"orphan_clean_failed",{pid:t,terminated:a.terminated,failed:a.failed})}async cleanupDeadSessions(e,t){const a=e.filter(s=>s.pid?!t.get(s.agentId)?.alive:!1);if(a.length>0){n.info(`\u6E05\u7406 ${a.length} \u4E2A\u5DF2\u6B7B\u4EA1\u4F1A\u8BDD\u8BB0\u5F55`);const s=e.filter(i=>t.get(i.agentId)?.alive!==!1);await g(s)}}async checkAgentExistsOnServer(e){if(this.stopped)return null;try{const t=c(o)||c();if(!t)return n.debug("\u7F3A\u5C11 runtimeAccessToken\uFF0C\u65E0\u6CD5\u67E5\u8BE2 agent \u5B58\u5728\u6027"),null;const a=await fetch(`${o}/api/runtime/callback/agent-exists`,{method:"POST",headers:{"Content-Type":"application/json","X-Runtime-Token":t},body:JSON.stringify({agentId:e}),signal:AbortSignal.timeout(5e3)});return a.ok?(await a.json()).exists===!0:(n.debug(`\u67E5\u8BE2 agent \u5B58\u5728\u6027\u5931\u8D25: ${a.status}`),null)}catch(t){return n.debug("\u67E5\u8BE2 agent \u5B58\u5728\u6027\u5F02\u5E38:",t),null}}async reportToScheduler(e,t,a){if(this.stopped){n.debug(`\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u8DF3\u8FC7\u4E0A\u62A5: ${t}`);return}try{const s=c(o)||c();if(!s){n.debug(`\u7F3A\u5C11 runtimeAccessToken\uFF0C\u8DF3\u8FC7\u4E0A\u62A5: ${t}`);return}const i=await fetch(`${o}/api/runtime/callback/orphan-event`,{method:"POST",headers:{"Content-Type":"application/json","X-Runtime-Token":s},body:JSON.stringify({agentId:e,eventType:t,details:a,timestamp:new Date().toISOString()})});i.ok||(i.status===404?n.debug(`\u4E0A\u62A5\u5931\u8D25: \u8C03\u5EA6\u4E2D\u5FC3\u4E0D\u53EF\u8FBE (404)\uFF0C\u4E8B\u4EF6: ${t}`):n.warn(`\u4E0A\u62A5\u5931\u8D25: ${i.status}`))}catch(s){n.debug("\u4E0A\u62A5\u5230\u8C03\u5EA6\u4E2D\u5FC3\u5931\u8D25:",s)}}onEvent(e){this.eventListeners.push(e)}offEvent(e){const t=this.eventListeners.indexOf(e);t>-1&&this.eventListeners.splice(t,1)}emit(e){for(const t of this.eventListeners)try{t(e)}catch(a){n.warn("\u4E8B\u4EF6\u76D1\u542C\u5668\u6267\u884C\u5931\u8D25:",a)}}getStatus(){return{running:this.intervalId!==null,lastScanTime:this.lastScanTime,mode:r}}}let p=null;function h(){return p||(p=new O),p}async function E(){await h().start()}function M(){h().stop()}export{O as OrphanMonitor,h as getOrphanMonitor,E as startOrphanMonitor,M as stopOrphanMonitor};
+import{ORPHAN_SCAN_INTERVAL as d,ORPHAN_AUTO_CLEAN_MODE as r,ORPHAN_SCAN_ENABLED as m,schedulerBaseUrl as o}from"../config.js";import{createLogger as f}from"../utils/logger.js";import{detectOrphanProcesses as g,checkAllSessionsHealth as w,terminateProcessTree as S,waitForProcessExit as $}from"./process-detector.js";import{getRuntimeAccessToken as c}from"./runtime-binding.js";import{shouldAutoCleanOrphanProcesses as l}from"./runtime-lifecycle-policy.js";import{loadPersistedSessions as y,savePersistedSessions as v}from"./terminal-persistence.js";const n=f("orphan-monitor");class O{constructor(){this.intervalId=null,this.lastScanTime=null,this.eventListeners=[],this.stopped=!1}async start(){if(!m){n.info("\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\u5DF2\u7981\u7528 (AWS_ORPHAN_SCAN_ENABLED=false)");return}this.stopped=!1,n.info(`\u542F\u52A8\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\uFF0C\u626B\u63CF\u95F4\u9694: ${d}ms, \u81EA\u52A8\u6E05\u7406\u6A21\u5F0F: ${r}`),await this.scan(),this.intervalId=setInterval(async()=>{await this.scan()},d),n.info("\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\u5DF2\u542F\u52A8")}stop(){this.stopped=!0,this.intervalId&&(clearInterval(this.intervalId),this.intervalId=null,n.info("\u5B64\u513F\u8FDB\u7A0B\u76D1\u63A7\u5DF2\u505C\u6B62"))}async scan(){if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u8DF3\u8FC7\u626B\u63CF");return}this.lastScanTime=new Date,n.debug("\u5F00\u59CB\u626B\u63CF\u5B64\u513F\u8FDB\u7A0B...");try{const e=await y();if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u4E2D\u65AD\u626B\u63CF");return}if(e.length===0){n.debug("\u65E0\u6301\u4E45\u5316\u4F1A\u8BDD\uFF0C\u8DF3\u8FC7\u626B\u63CF");return}const t=await g(e.map(s=>({agentId:s.agentId,pid:s.pid,workspacePath:s.workspacePath,command:s.command})));if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u4E2D\u65AD\u626B\u63CF");return}const a=await w(e.filter(s=>s.pid).map(s=>({agentId:s.agentId,pid:s.pid})));if(this.stopped){n.debug("\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u4E2D\u65AD\u626B\u63CF");return}for(const s of t){if(this.stopped)break;await this.handleOrphanDetected(s.agentId,s.process.pid)}for(const[s,i]of a){if(this.stopped)break;i.status!=="healthy"&&i.alive&&await this.handleHealthIssue(s,i)}this.stopped||await this.cleanupDeadSessions(e,a)}catch(e){n.warn("\u626B\u63CF\u5B64\u513F\u8FDB\u7A0B\u5931\u8D25:",e)}}async handleOrphanDetected(e,t){const a={type:"orphan_detected",agentId:e,pid:t,message:`\u68C0\u6D4B\u5230\u5B64\u513F\u8FDB\u7A0B: agentId=${e}, pid=${t}`,timestamp:new Date};if(this.emit(a),n.warn(`\u68C0\u6D4B\u5230\u5B64\u513F\u8FDB\u7A0B: agentId=${e}, pid=${t}`),await this.checkAgentExistsOnServer(e)===!1){n.info(`agent ${e} \u5DF2\u4ECE\u670D\u52A1\u7AEF\u5220\u9664\uFF0C\u81EA\u52A8\u7EC8\u6B62\u6B8B\u7559\u8FDB\u7A0B pid=${t}`),await this.autoCleanOrphan(e,t);return}switch(r){case"auto":l()?await this.autoCleanOrphan(e,t):(n.warn("auto \u6A21\u5F0F\u672A\u542F\u7528\u7834\u574F\u6027\u6E05\u7406\u5F00\u5173\uFF0C\u6539\u4E3A\u544A\u8B66\u5E76\u4FDD\u7559\u5B64\u513F\u8FDB\u7A0B"),await this.reportToScheduler(e,"orphan_detected",{pid:t}));break;case"alert":await this.reportToScheduler(e,"orphan_detected",{pid:t});break;case"manual":n.info("manual \u6A21\u5F0F\uFF0C\u4EC5\u8BB0\u5F55\u65E5\u5FD7\uFF0C\u4E0D\u81EA\u52A8\u5904\u7406");break}}async handleHealthIssue(e,t){const a=t.status==="unresponsive"?"process_unresponsive":t.status==="high_cpu"?"process_high_cpu":"process_high_memory",s={type:a,agentId:e,pid:t.pid,message:`\u8FDB\u7A0B\u5065\u5EB7\u5F02\u5E38: ${t.status}, CPU=${t.cpu}%, Memory=${t.memoryMB}MB`,timestamp:new Date,details:{cpu:t.cpu,memoryMB:t.memoryMB}};this.emit(s),await this.reportToScheduler(e,a,{pid:t.pid,cpu:t.cpu,memoryMB:t.memoryMB}),r==="auto"&&t.status!=="healthy"&&l()?(n.warn(`auto \u6A21\u5F0F: \u7EC8\u6B62\u5F02\u5E38\u8FDB\u7A0B ${t.pid} (${t.status})`),await this.autoCleanOrphan(e,t.pid)):r==="auto"&&t.status!=="healthy"&&n.warn(`auto \u6A21\u5F0F\u672A\u542F\u7528\u7834\u574F\u6027\u6E05\u7406\u5F00\u5173\uFF0C\u4FDD\u7559\u5F02\u5E38\u8FDB\u7A0B ${t.pid} (${t.status})`)}async autoCleanOrphan(e,t){n.info(`\u81EA\u52A8\u6E05\u7406\u5B64\u513F\u8FDB\u7A0B\uFF1AagentId=${e}, pid=${t}`);const a=await S(t),s=await $(t,5e3);if(a.terminated>0&&s){const i={type:"orphan_cleaned",agentId:e,pid:t,message:`\u81EA\u52A8\u6E05\u7406\u6210\u529F\uFF1AagentId=${e}, pid=${t}, \u7EC8\u6B62\u4E86 ${a.terminated} \u4E2A\u8FDB\u7A0B`,timestamp:new Date,details:{terminated:a.terminated,failed:a.failed}};this.emit(i),await this.reportToScheduler(e,"orphan_cleaned",{pid:t,terminated:a.terminated,failed:a.failed})}else n.warn(`\u81EA\u52A8\u6E05\u7406\u5931\u8D25\uFF1AagentId=${e}, pid=${t}, terminated=${a.terminated}, exited=${s}`),await this.reportToScheduler(e,"orphan_clean_failed",{pid:t,terminated:a.terminated,failed:a.failed})}async cleanupDeadSessions(e,t){const a=e.filter(s=>s.pid?!t.get(s.agentId)?.alive:!1);if(a.length>0){n.info(`\u6E05\u7406 ${a.length} \u4E2A\u5DF2\u6B7B\u4EA1\u4F1A\u8BDD\u8BB0\u5F55`);const s=e.filter(i=>t.get(i.agentId)?.alive!==!1);await v(s)}}async checkAgentExistsOnServer(e){if(this.stopped)return null;try{const t=c(o)||c();if(!t)return n.debug("\u7F3A\u5C11 runtimeAccessToken\uFF0C\u65E0\u6CD5\u67E5\u8BE2 agent \u5B58\u5728\u6027"),null;const a=await fetch(`${o}/api/runtime/callback/agent-exists`,{method:"POST",headers:{"Content-Type":"application/json","X-Runtime-Token":t},body:JSON.stringify({agentId:e}),signal:AbortSignal.timeout(5e3)});return a.ok?(await a.json()).exists===!0:(n.debug(`\u67E5\u8BE2 agent \u5B58\u5728\u6027\u5931\u8D25: ${a.status}`),null)}catch(t){return n.debug("\u67E5\u8BE2 agent \u5B58\u5728\u6027\u5F02\u5E38:",t),null}}async reportToScheduler(e,t,a){if(this.stopped){n.debug(`\u76D1\u63A7\u5668\u5DF2\u505C\u6B62\uFF0C\u8DF3\u8FC7\u4E0A\u62A5: ${t}`);return}try{const s=c(o)||c();if(!s){n.debug(`\u7F3A\u5C11 runtimeAccessToken\uFF0C\u8DF3\u8FC7\u4E0A\u62A5: ${t}`);return}const i=await fetch(`${o}/api/runtime/callback/orphan-event`,{method:"POST",headers:{"Content-Type":"application/json","X-Runtime-Token":s},body:JSON.stringify({agentId:e,eventType:t,details:a,timestamp:new Date().toISOString()})});i.ok||(i.status===404?n.debug(`\u4E0A\u62A5\u5931\u8D25: \u8C03\u5EA6\u4E2D\u5FC3\u4E0D\u53EF\u8FBE (404)\uFF0C\u4E8B\u4EF6: ${t}`):n.warn(`\u4E0A\u62A5\u5931\u8D25: ${i.status}`))}catch(s){n.debug("\u4E0A\u62A5\u5230\u8C03\u5EA6\u4E2D\u5FC3\u5931\u8D25:",s)}}onEvent(e){this.eventListeners.push(e)}offEvent(e){const t=this.eventListeners.indexOf(e);t>-1&&this.eventListeners.splice(t,1)}emit(e){for(const t of this.eventListeners)try{t(e)}catch(a){n.warn("\u4E8B\u4EF6\u76D1\u542C\u5668\u6267\u884C\u5931\u8D25:",a)}}getStatus(){return{running:this.intervalId!==null,lastScanTime:this.lastScanTime,mode:r}}}let p=null;function h(){return p||(p=new O),p}async function E(){await h().start()}function M(){h().stop()}export{O as OrphanMonitor,h as getOrphanMonitor,E as startOrphanMonitor,M as stopOrphanMonitor};
 

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

@@ -0,0 +1,49 @@
+
+export type PluginEventPriority = "urgent" | "normal" | "low";
+
+export interface PluginEventMessage {
+    msgId: string;
+    
+    channel?: string;
+    senderId: string;
+    senderName: string;
+    receiverId?: string;
+    content: string;
+    requireReply: boolean;
+    role?: "system" | "user" | "assistant";
+    timestamp: string;
+}
+export interface PluginEventRecord {
+    plugin: string;
+    event: string;
+    priority: PluginEventPriority;
+    dedupKey?: string;
+    receivedAt: number;
+    message: PluginEventMessage;
+}
+export interface PluginEventDrainOptions {
+    
+    maxPerKey?: number;
+}
+export interface PluginEventDrainResult {
+    
+    revision: number;
+    events: PluginEventMessage[];
+}
+export declare class PluginEventBuffer {
+    private readonly agentId;
+    private revision;
+    private records;
+    private dedup;
+    private nextSeq;
+    constructor(agentId: string);
+    get currentRevision(): number;
+    
+    push(record: PluginEventRecord): boolean;
+    
+    drain(opts?: PluginEventDrainOptions): PluginEventDrainResult;
+    
+    private dropOldestLowestPriority;
+    
+    private pruneDedup;
+}

package/dist/services/plugin-event-buffer.js

@@ -0,0 +1,2 @@
+const D=6e4,_=2e3,m=500,u={urgent:0,normal:1,low:2};class v{constructor(i){this.agentId=i,this.revision=0,this.records=[],this.dedup=new Map,this.nextSeq=1}get currentRevision(){return this.revision}push(i){const n=i.dedupKey||i.message.msgId,t=Date.now();if(n){const e=this.dedup.get(n);if(e!==void 0&&t-e<6e4)return!1;this.dedup.set(n,t)}for(this.pruneDedup(t),this.records.push({seq:this.nextSeq++,record:i});this.records.length>500;)this.dropOldestLowestPriority();return this.revision++,!0}drain(i={}){const n=Math.max(1,i.maxPerKey??10),t=this.revision;if(this.records.length===0)return{revision:t,events:[]};const e=[...this.records].sort((s,o)=>{const r=u[s.record.priority]-u[o.record.priority];return r!==0?r:s.seq-o.seq}),d=[],p=new Map,c=new Map;for(const s of e){const o=s.record,r=`${o.plugin}:${o.event}`,l=p.get(r)??0;if(l<n)p.set(r,l+1),d.push(s);else{const a=c.get(r);a?a.count++:c.set(r,{count:1,sample:o})}}const f=new Set(d.map(s=>s.seq));this.records=this.records.filter(s=>!f.has(s.seq));const h=d.map(s=>s.record.message);for(const[s,{count:o,sample:r}]of c)h.push({msgId:`plugin-collapse-${s}-${t}`,channel:"plugin-event",senderId:`plugin:${r.plugin}`,senderName:`\u63D2\u4EF6[${r.plugin}]`,receiverId:this.agentId||void 0,content:`\u3010\u63D2\u4EF6\u4E8B\u4EF6\u6298\u53E0\u3011\u63D2\u4EF6 ${r.plugin} \u7684 ${r.event} \u4E8B\u4EF6\u8FD8\u6709 ${o} \u6761\u5F85\u5904\u7406\uFF08\u672C\u6279\u6B21\u6BCF\u4E2A\u4E8B\u4EF6\u952E\u6700\u591A\u4EA4\u4ED8 ${n} \u6761\uFF0C\u5176\u4F59\u5DF2\u6298\u53E0\uFF1B\u7EE7\u7EED\u8C03\u7528\u63D2\u4EF6\u5DE5\u5177\u6216\u7B49\u5F85\u4E0B\u6279 poll \u4EA4\u4ED8\uFF09\u3002`,requireReply:!1,role:"system",timestamp:new Date(r.receivedAt).toISOString()});return{revision:t,events:h}}dropOldestLowestPriority(){if(this.records.length===0)return;let i=0,n=-1;for(let t=0;t<this.records.length;t++){const e=u[this.records[t].record.priority];if(e>n&&(n=e,i=t,e===2))break}this.records.splice(i,1)}pruneDedup(i){if(this.dedup.size<=2e3)return;for(const[e,d]of this.dedup)i-d>=6e4&&this.dedup.delete(e);if(this.dedup.size<=2e3)return;const n=[...this.dedup.entries()].sort((e,d)=>e[1]-d[1]),t=this.dedup.size-2e3;for(let e=0;e<t;e++)this.dedup.delete(n[e][0])}}export{v as PluginEventBuffer};
+

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

@@ -0,0 +1,262 @@
+
+import { type ACodeCommandSpec, type ACodePluginBridge, type PluginCatalogSnapshot, type PluginInvokeContext, type PluginManageRequest, type PluginManageResult, type PluginSummary, type PluginToolInvocationResult, type PluginToolSchema, type JsonObject } from "@agentswork/acode";
+import { type PluginEventMessage, type PluginEventPriority } from "./plugin-event-buffer.js";
+
+export declare const BUILTIN_PLUGIN_NAME = "plugin-manager";
+export declare const BUILTIN_PLUGIN_DESCRIPTION = "\u7CFB\u7EDF\u5185\u7F6E\uFF1A\u7BA1\u7406\u63D2\u4EF6\u7684\u751F\u547D\u5468\u671F\uFF08\u5B89\u88C5/\u5378\u8F7D/\u542F\u505C/\u91CD\u8F7D\uFF09\uFF1B\u5F00\u53D1\u63D2\u4EF6\u7528\u5185\u7F6E /create-plugin \u547D\u4EE4";
+
+export declare const BUILTIN_PLUGIN_MANAGE_DESC = "\u300C\u63D2\u4EF6\u7BA1\u7406\u63D2\u4EF6\u300D\u7684\u751F\u547D\u5468\u671F\u5DE5\u5177\uFF1A\u7BA1\u7406\u63D2\u4EF6\uFF08\u5B89\u88C5/\u5378\u8F7D/\u91CD\u8F7D/\u542F\u505C/\u5217\u8868\uFF09\u3002\u4EC5\u5F53\u7528\u6237\u660E\u786E\u8981\u6C42\u5B89\u88C5\u3001\u79FB\u9664\u6216\u4FEE\u590D\u63D2\u4EF6\u65F6\u4F7F\u7528\u3002\n- action=list\uFF1A\u5217\u51FA\u5DF2\u5B89\u88C5\u63D2\u4EF6\uFF08\u72B6\u6001\u3001\u76D1\u542C\u5668\u5065\u5EB7\u3001\u5DE5\u5177\u6570\uFF09\u3002\n- action=install\uFF1Asource \u4E3A\u63D2\u4EF6\u6765\u6E90\uFF0C\u5F53\u524D\u652F\u6301 \"local:<\u4EFB\u610F\u63D2\u4EF6\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84>\"\uFF08\u4E0D\u505A\u76EE\u5F55\u4F4D\u7F6E\u9650\u5236\uFF09\uFF1Bconfig \u4F20\u63D2\u4EF6 manifest \u91CC userConfig \u58F0\u660E\u7684\u914D\u7F6E\u503C\u3002\u5B89\u88C5\u65F6\u4F1A\u5148\u628A\u8BE5\u76EE\u5F55\u79FB\u52A8\u5230\u672C agent \u52A0\u8F7D\u63D2\u4EF6\u7684\u4F4D\u7F6E\uFF0C\u518D\u52A0\u8F7D\u79FB\u52A8\u540E\u7684\u526F\u672C\uFF08\u79FB\u52A8\u540E\u6E90\u76EE\u5F55\u4E0D\u518D\u4FDD\u7559\uFF09\uFF0C\u5B89\u88C5\u540E\u7ACB\u5373\u751F\u6548\uFF1A\u4E0B\u4E00\u6B21 poll_message \u7684 pluginCatalog \u5373\u53EF\u89C1\u3002\n- action=reload\uFF1A\u91CD\u8F7D\u6307\u5B9A\u63D2\u4EF6\uFF08\u6539\u8FC7\u63D2\u4EF6\u6587\u4EF6\u540E\u4F7F\u7528\uFF09\uFF0C\u539F\u5B50\u6362\u88C5\uFF0C\u76D1\u542C\u5668\u91CD\u542F\u3002\n- action=enable / disable\uFF1A\u505C\u7528/\u542F\u7528\uFF08disable \u4FDD\u7559\u5B89\u88C5\u4E0E\u914D\u7F6E\uFF0C\u4EC5\u505C\u6B62\u76D1\u542C\u4E0E\u5DE5\u5177\u8C03\u7528\uFF09\u3002\n- action=uninstall\uFF1A\u5378\u8F7D\u5E76\u5220\u9664\u63D2\u4EF6\u76EE\u5F55\uFF08\u4E0D\u53EF\u9006\uFF0C\u9700\u7528\u6237\u660E\u786E\u8981\u6C42\uFF09\u3002";
+
+export declare function getBuiltinCommandDir(): string;
+export interface PluginUserConfigField {
+    key: string;
+    type?: "string" | "number" | "boolean";
+    required?: boolean;
+    sensitive?: boolean;
+    description?: string;
+    default?: string;
+}
+export interface PluginHandlerDef {
+    type: "process" | "module" | "mcp";
+    
+    command?: string;
+    
+    shell?: boolean;
+    
+    stdin?: "none" | "params";
+    
+    timeoutMs?: number;
+    
+    module?: string;
+    
+    export?: string;
+}
+export interface PluginToolDef {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    handler: PluginHandlerDef;
+}
+export interface PluginTransportDef {
+    type: "command-stream" | "poll-command" | "http-callback";
+    
+    command?: string;
+    
+    intervalMs?: number;
+    
+    restartBackoffMs?: number;
+}
+export interface PluginListenerDef {
+    event: string;
+    description?: string;
+    transport: PluginTransportDef;
+    
+    delivery?: "poll" | "force" | "wake";
+    priority?: PluginEventPriority;
+    
+    matcher?: Record<string, string | number | boolean | Array<string | number | boolean>>;
+    
+    dedupKey?: string;
+    
+    toolHints?: string[];
+    
+    promptTemplate?: string;
+}
+export interface PluginManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    author?: Record<string, unknown>;
+    tools?: string;
+    listeners?: string;
+    commands?: string;
+    userConfig?: PluginUserConfigField[];
+    [key: string]: unknown;
+}
+export declare function validateAgainstSchema(schema: unknown, value: unknown, path?: string): string[];
+export interface PluginManagerOptions {
+    
+    rootDir?: string;
+    
+    runtimeRootDir?: string;
+}
+export declare class PluginManager {
+    private agents;
+    private readonly rootDir;
+    private readonly runtimeRootDir;
+    
+    private moduleNonce;
+    constructor(options?: PluginManagerOptions);
+    forAgent(agentId: string): ACodePluginBridge;
+    
+    setOnPluginsChanged(cb: (agentId: string) => void): void;
+    private onPluginsChanged?;
+    private notifyPluginsChanged;
+    
+    getCommandDirs(agentId: string): Promise<string[]>;
+    
+    getPluginCommands(agentId: string): Promise<ACodeCommandSpec[]>;
+    private parsePluginCommandDir;
+    private parseCommandDir;
+    list(agentId: string): Promise<PluginSummary[]>;
+    
+    private deployedPluginVersion;
+    getCatalog(agentId: string): Promise<PluginCatalogSnapshot>;
+    getToolSchema(agentId: string, qualifiedName: string): Promise<PluginToolSchema | null>;
+    invokeTool(agentId: string, pluginName: string, toolName: string, params: JsonObject, ctx?: PluginInvokeContext): Promise<PluginToolInvocationResult>;
+    
+    private buildManageRequest;
+    private executeHandler;
+    private invokeProcessHandler;
+    private invokeModuleHandler;
+    
+    private buildPluginEnv;
+    manage(agentId: string, request: PluginManageRequest): Promise<PluginManageResult>;
+    private doManage;
+    private installPlugin;
+    
+    installFromZip(agentId: string, zipBuffer: Buffer, originalName: string, config?: Record<string, string>): Promise<PluginManageResult>;
+    
+    private installFromDirectory;
+    private uninstallPlugin;
+    private reloadPlugin;
+    private setEnabled;
+    private deployedDir;
+    private deployedManifestFile;
+    
+    private deployedPluginDir;
+    
+    private legacySharedDir;
+    private readSharedManifest;
+    private writeSharedManifest;
+    
+    private migrateLegacySharedIfNeeded;
+    
+    private deployedPluginHealthy;
+    
+    private runtimeDirFor;
+    private runtimeLinkPath;
+    
+    private ensureRuntimeLink;
+    
+    private removeRuntimeLink;
+    
+    saveSharedPlugin(zipBuffer: Buffer, originalName: string, defaultEnabled?: boolean, sha256?: string): Promise<{
+        ok: boolean;
+        error?: string;
+        pluginName?: string;
+    }>;
+    
+    private deployPluginZipToPersistentDir;
+    
+    private suspendDeployedPluginAcrossAgents;
+    
+    applySharedToKnownAgents(): Promise<Array<{
+        agentId: string;
+        installed: string[];
+    }>>;
+    
+    private syncSharedIntoStateQueued;
+    
+    private effectiveSharedEnabled;
+    
+    private templatePullInFlight;
+    
+    private backgroundTemplatePulls;
+    
+    private pullTemplatePluginsFromCapabilities;
+    
+    private queueTemplatePull;
+    
+    private syncSharedIntoState;
+    
+    private cleanupRuntimeDir;
+    
+    applyCapabilities(agentId: string): Promise<void>;
+    drainEvents(agentId: string, opts?: {
+        maxPerKey?: number;
+    }): Promise<{
+        revision: number;
+        events: PluginEventMessage[];
+        catalog: PluginCatalogSnapshot;
+        
+        compactionSeq: number;
+    }>;
+    
+    markAgentCompacted(agentId: string): void;
+    
+    enqueueExternalEvent(agentId: string, pluginName: string, payload: Record<string, unknown>): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    
+    private bumpCatalogRevision;
+    private agentState;
+    
+    private hydrate;
+    private doHydrate;
+    private installedFile;
+    private persistInstalled;
+    
+    private sensitiveKeysOf;
+    
+    private stripSensitiveValues;
+    private secretsFile;
+    
+    private readSecrets;
+    
+    private persistSecrets;
+    private readJsonFile;
+    private loadManifestOnly;
+    
+    private validateUserConfigValues;
+    private loadPluginFromDir;
+    
+    private ensureListenersRunning;
+    private startAllListeners;
+    private stopAllListeners;
+    private startListener;
+    private spawnListenerChild;
+    private scheduleListenerRestart;
+    
+    private pollListenerOnce;
+    private stopListener;
+    private handleListenerLine;
+    private enqueueEvent;
+    private requiredParamsOf;
+    private toSummary;
+    getLogs(agentId: string, pluginName: string): Promise<{
+        ok: boolean;
+        error?: string;
+        logs: string[];
+    }>;
+    
+    stopAgent(agentId: string): Promise<void>;
+    
+    stopAll(): Promise<void>;
+    
+    listDeployed(): Promise<Array<{
+        pluginName: string;
+        version?: string;
+        fileName: string;
+        defaultEnabled: boolean;
+        sha256?: string;
+        deployed: boolean;
+    }>>;
+    
+    deployedDefaultEnabled(): Record<string, boolean>;
+    
+    removeDeployedPlugin(pluginName: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+}
+
+export declare function isValidPluginName(name: unknown): name is string;
+export declare function validateManifest(manifest: Record<string, unknown>): string | null;
+
+export declare function renderCommandArgv(command: string, lookup: Record<string, unknown>): string[];
+
+export declare const pluginManager: PluginManager;
+export declare const reconcilePluginsDefaultsFromDeployed: () => number;