aws-runtime-bridge 1.9.175 → 1.9.179

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

@@ -1,2 +1,2 @@
-import{promises as P}from"node:fs";import w from"node:path";import{downloadPluginZip as $,downloadSkillZip as I,ensureDir as y}from"../utils/file-utils.js";import{createLogger as O}from"../utils/logger.js";import{normalizeMcpPayload as z}from"../utils/mcp-utils.js";import{ensureEnabledTools as B,parseBoolean as D}from"../utils/validation.js";import{buildBuiltinAwsMcpDeploySpec as j,BUILTIN_AWS_MCP_SERVER_NAME as v}from"./aws-client-agent-mcp.js";import{setDefault as F}from"./capability-config.js";import{getAgentInitRoot as R,loadInstanceState as U,saveInstanceState as _}from"./instance-state.js";import{mcpDeployManager as M,reconcileMcpDefaultsFromDeployed as L}from"./mcp-deploy.js";import{isBuiltinMcpName as W}from"./mcp-env-injector.js";import{reconcilePluginsDefaultsFromDeployed as Z,pluginManager as q}from"./plugin-manager.js";import{reconcileSkillsDefaultsFromDeployed as x,skillManager as V}from"./skill-manager.js";import{detectToolStatuses as G}from"./tool-installer.js";const H=O("instance-init");function J(n,k){const s=new Set(Object.values(k).filter(r=>r.installed).map(r=>r.tool));return n.filter(r=>s.has(r))}async function K(n,k){try{const s=await I(n,k);if(!s)return null;const r=await P.readFile(s.outputPath),d=n.defaultEnabled!==!1,S=String(n.skillName||"").trim()||void 0,l=await V.saveSharedSkill(r,s.fileName,d,n.sha256,S);return!l.ok||!l.skillName?null:{id:l.skillName,name:l.skillName,fileName:s.fileName,filePath:"",bytes:s.bytes,installedAt:new Date().toISOString()}}catch(s){return H.warn("\u6280\u80FD\u5305\u90E8\u7F72\u5230 bridge \u5931\u8D25\uFF08\u6309\u8DF3\u8FC7\u5904\u7406\uFF09: %s. %s",n.skillName||n.fileName||"(\u672A\u547D\u540D)",s instanceof Error?s.message:String(s)),null}}async function ue(n,k,s){const r=w.resolve(k),d=R(n),S=[];function l(t,o,e,a){S.push({step:t,status:o,message:e,timestamp:new Date().toISOString(),details:a})}l("prepare","running","\u5F00\u59CB\u521D\u59CB\u5316\u5B9E\u4F8B",{agentId:String(n),workspacePath:r}),await y(d),l("prepare","success","\u521D\u59CB\u5316\u76EE\u5F55\u5DF2\u5C31\u7EEA",{initRoot:d});const u=B(s.ccSwitchEnabledTools);l("detect-tools","running","\u5F00\u59CB\u68C0\u6D4B\u5DE5\u5177\u5B89\u88C5\u72B6\u6001",{tools:u});const p=await G(u);l("detect-tools","success","\u5DE5\u5177\u5B89\u88C5\u72B6\u6001\u68C0\u6D4B\u5B8C\u6210",{installedTools:Object.values(p).filter(t=>t.installed).map(t=>t.tool),missingTools:Object.values(p).filter(t=>!t.installed).map(t=>t.tool)});const T=J(u,p),b=Object.values(p).filter(t=>!t.installed),i={ok:!0,agentId:String(n),workspacePath:r,initRoot:d,enabledTools:u,toolStatus:p,logs:S,skill:{enabled:D(s.skillEnabled,!0),packagePresent:!1},mcp:{enabled:D(s.mcpEnabled,!0),configPath:null}},m=await U(n);if(b.length>0&&l("skip-uninstalled-tools","skipped","\u5DF2\u8DF3\u8FC7\u672A\u5B89\u88C5\u5DE5\u5177",{skippedTools:b.map(t=>({tool:t.tool,error:t.error}))}),l("select-installed-tools","success","\u5DF2\u9009\u62E9\u53EF\u521D\u59CB\u5316\u5DE5\u5177",{enabledTools:u,installedTools:T}),l("load-sdk","running","\u5F00\u59CB\u90E8\u7F72\u6280\u80FD/MCP \u6A21\u677F\u5230\u672C bridge"),l("load-sdk","success","\u6280\u80FD/MCP \u6A21\u677F\u90E8\u7F72\u51C6\u5907\u5B8C\u6210",{tools:u}),i.skill.enabled){l("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(d,"skills")),o=Array.isArray(s.skillPackages)&&s.skillPackages.length>0?s.skillPackages:s.skillPackage?[s.skillPackage]:[],e=[];for(const a of o){const f=await K(a,t);f&&e.push(f)}e.length>0?(i.skill.packagePresent=!0,i.skill.installedCount=e.length,i.skill.installed=e,l("install-skills","success","\u6280\u80FD\u5305\u90E8\u7F72\u5B8C\u6210",{installedCount:e.length,skills:e.map(a=>a.name)})):l("install-skills","skipped","\u6CA1\u6709\u53EF\u90E8\u7F72\u7684\u6280\u80FD\u5305")}else l("install-skills","skipped","\u5DF2\u8DF3\u8FC7\u6280\u80FD\u5305\u90E8\u7F72\uFF08skillEnabled=false\uFF09");const h=Array.isArray(s.pluginPackages)?s.pluginPackages:[];if(h.length>0){l("install-plugins","running","\u5F00\u59CB\u90E8\u7F72\u63D2\u4EF6\u6A21\u677F\u5305",{count:h.length});const t=await y(w.join(d,"plugins-tmp"));let o=0;for(const e of h)if(!(!e||!String(e.downloadUrl||"").trim()))try{const a=await $(e,t);if(!a)continue;const f=await P.readFile(a.outputPath),A=e.defaultEnabled!==!1,c=await q.saveSharedPlugin(f,a.fileName,A,e.sha256);c.ok?(o++,l("install-plugins","success",`\u63D2\u4EF6 ${c.pluginName||a.fileName} \u5DF2\u90E8\u7F72\u5230\u672C bridge`)):l("install-plugins","error",`\u63D2\u4EF6 ${a.fileName} \u90E8\u7F72\u5931\u8D25: ${c.error||"\u672A\u77E5\u9519\u8BEF"}`)}catch(a){l("install-plugins","error",`\u63D2\u4EF6 ${e.fileName||"(\u672A\u547D\u540D)"} \u90E8\u7F72\u5931\u8D25: ${a instanceof Error?a.message:String(a)}`)}i.plugin={enabled:!0,packagePresent:h.length>0,installedCount:o},o>0?l("install-plugins","success","\u63D2\u4EF6\u6A21\u677F\u5305\u90E8\u7F72\u5B8C\u6210",{installedCount:o}):l("install-plugins","skipped","\u6CA1\u6709\u53EF\u90E8\u7F72\u7684\u63D2\u4EF6\u5305"),await P.rm(t,{recursive:!0,force:!0}).catch(()=>{})}const g=[];if(i.mcp.enabled){l("install-mcp","running","\u5F00\u59CB\u90E8\u7F72 MCP \u6A21\u677F",{count:(Array.isArray(s.mcpServers)?s.mcpServers.length:0)+1});let t;try{const e=j();t=M.saveMcp(v,e,!0),t.ok&&(F("mcp",v,!0),g.push({id:"",name:v,transport:"stdio",command:e.command||"",url:e.url||"",args:e.args||[],env:e.env||{},enabled:!0,installedAt:new Date().toISOString()}))}catch(e){t={ok:!1,error:e instanceof Error?e.message:String(e)}}t.ok||l("install-mcp","error",`\u5185\u7F6E\u901A\u8BAF MCP \u90E8\u7F72\u5931\u8D25: ${t.error||"\u672A\u77E5\u9519\u8BEF"}`);const o=(Array.isArray(s.mcpServers)?s.mcpServers:[]).map(e=>z(e)).filter(e=>e!==null);for(const e of o){if(W(e.name))continue;const a=String(e.packageUrl||"").trim();if(a)try{const c=await M.ensureMcpPackage(e.name,{packageUrl:a,packageSha256:e.packageSha256,fileName:`${e.name}.zip`});c.ok||l("install-mcp","error",`MCP \u5305 ${e.name} \u90E8\u7F72\u5931\u8D25: ${c.error||"\u672A\u77E5\u9519\u8BEF"}`)}catch(c){l("install-mcp","error",`MCP \u5305 ${e.name} \u90E8\u7F72\u5931\u8D25: ${c instanceof Error?c.message:String(c)}`)}const f={type:e.transport||"stdio",command:e.command||void 0,url:e.url||void 0,args:e.args||void 0,env:e.env||void 0,headers:e.headers||void 0,collapsed:e.collapsed===!0,description:e.description||void 0};M.saveMcp(e.name,f,e.enabled!==!1,e.packageSha256).ok&&g.push({id:e.id||"",name:e.name,transport:e.transport||"stdio",command:e.command||"",url:e.url||"",args:e.args||[],env:e.env||{},enabled:e.enabled!==!1,installedAt:new Date().toISOString()})}i.mcp.installedCount=g.length,l("install-mcp","success","MCP \u6A21\u677F\u90E8\u7F72\u5B8C\u6210",{installedCount:g.length,mcpServers:g.map(e=>e.name)})}else l("install-mcp","skipped","\u5DF2\u8DF3\u8FC7 MCP \u6A21\u677F\uFF08mcpEnabled=false\uFF09");l("persist-state","running","\u5F00\u59CB\u4FDD\u5B58\u5B9E\u4F8B\u72B6\u6001"),m.initialized=!0,m.enabledTools=u,m.toolStatus=p,m.skillEnabled=i.skill.enabled,m.mcpEnabled=i.mcp.enabled,await _(n,m),l("persist-state","success","\u5B9E\u4F8B\u72B6\u6001\u4FDD\u5B58\u5B8C\u6210");const E=x(),N=L(),C=Z();return(E||N||C)&&l("sync-state","success","\u80FD\u529B\u9ED8\u8BA4\u5F00\u5173\u5DF2\u5BF9\u8D26\uFF08\u65B0\u589E\u9879\u9ED8\u8BA4\u5173\u95ED\uFF09",{reconciledSkills:E,reconciledMcp:N,reconciledPlugins:C}),l("sync-state","success","\u6280\u80FD/MCP \u6A21\u677F\u90E8\u7F72\u72B6\u6001\u5DF2\u5C31\u7EEA"),l("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"),{...i,installed:{skills:i.skill.installed||[],mcpServers:g}}}export{ue as initInstance};
+import{promises as y}from"node:fs";import M from"node:path";import{downloadPluginZip as $,downloadSkillZip as O,ensureDir as v}from"../utils/file-utils.js";import{createLogger as z}from"../utils/logger.js";import{normalizeMcpPayload as B}from"../utils/mcp-utils.js";import{ensureEnabledTools as j,parseBoolean as T}from"../utils/validation.js";import{buildBuiltinAwsMcpDeploySpec as _,BUILTIN_AWS_MCP_SERVER_NAME as E}from"./aws-client-agent-mcp.js";import{setDefault as F}from"./capability-config.js";import{getAgentInitRoot as R,loadInstanceState as U,saveInstanceState as L}from"./instance-state.js";import{McpDeployManager as W,reconcileMcpDefaultsFromDeployed as Z}from"./mcp-deploy.js";import{isBuiltinMcpName as q}from"./mcp-env-injector.js";import{reconcilePluginsDefaultsFromDeployed as x,pluginManager as V}from"./plugin-manager.js";import{reconcileSkillsDefaultsFromDeployed as G,SkillManager as H}from"./skill-manager.js";import{detectToolStatuses as J}from"./tool-installer.js";const K=z("instance-init");function Q(p,c){const n=new Set(Object.values(c).filter(t=>t.installed).map(t=>t.tool));return p.filter(t=>n.has(t))}async function X(p,c,n){try{const t=await O(c,n);if(!t)return null;const m=await y.readFile(t.outputPath),b=c.defaultEnabled!==!1,i=String(c.skillName||"").trim()||void 0,r=await H.forScope(p).saveSharedSkill(m,t.fileName,b,c.sha256,i);return!r.ok||!r.skillName?null:{id:r.skillName,name:r.skillName,fileName:t.fileName,filePath:"",bytes:t.bytes,installedAt:new Date().toISOString()}}catch(t){return K.warn("\u6280\u80FD\u5305\u90E8\u7F72\u5230 bridge \u5931\u8D25\uFF08\u6309\u8DF3\u8FC7\u5904\u7406\uFF09: %s. %s",c.skillName||c.fileName||"(\u672A\u547D\u540D)",t instanceof Error?t.message:String(t)),null}}async function me(p,c,n){const t=M.resolve(c),m=R(p),b=[],i=n.scope??null,r=i?W.forScope(i):null;function l(s,d,e,a){b.push({step:s,status:d,message:e,timestamp:new Date().toISOString(),details:a})}l("prepare","running","\u5F00\u59CB\u521D\u59CB\u5316\u5B9E\u4F8B",{agentId:String(p),workspacePath:t}),await v(m),l("prepare","success","\u521D\u59CB\u5316\u76EE\u5F55\u5DF2\u5C31\u7EEA",{initRoot:m});const f=j(n.ccSwitchEnabledTools);l("detect-tools","running","\u5F00\u59CB\u68C0\u6D4B\u5DE5\u5177\u5B89\u88C5\u72B6\u6001",{tools:f});const g=await J(f);l("detect-tools","success","\u5DE5\u5177\u5B89\u88C5\u72B6\u6001\u68C0\u6D4B\u5B8C\u6210",{installedTools:Object.values(g).filter(s=>s.installed).map(s=>s.tool),missingTools:Object.values(g).filter(s=>!s.installed).map(s=>s.tool)});const I=Q(f,g),w=Object.values(g).filter(s=>!s.installed),o={ok:!0,agentId:String(p),workspacePath:t,initRoot:m,enabledTools:f,toolStatus:g,logs:b,skill:{enabled:T(n.skillEnabled,!0),packagePresent:!1},mcp:{enabled:T(n.mcpEnabled,!0),configPath:null}},k=await U(p);if(w.length>0&&l("skip-uninstalled-tools","skipped","\u5DF2\u8DF3\u8FC7\u672A\u5B89\u88C5\u5DE5\u5177",{skippedTools:w.map(s=>({tool:s.tool,error:s.error}))}),l("select-installed-tools","success","\u5DF2\u9009\u62E9\u53EF\u521D\u59CB\u5316\u5DE5\u5177",{enabledTools:f,installedTools:I}),l("load-sdk","running","\u5F00\u59CB\u90E8\u7F72\u6280\u80FD/MCP \u6A21\u677F\u5230\u672C bridge"),l("load-sdk","success","\u6280\u80FD/MCP \u6A21\u677F\u90E8\u7F72\u51C6\u5907\u5B8C\u6210",{tools:f}),o.skill.enabled){l("install-skills","running","\u5F00\u59CB\u90E8\u7F72\u6280\u80FD\u5305",{count:Array.isArray(n.skillPackages)?n.skillPackages.length:n.skillPackage?1:0});const s=await v(M.join(m,"skills")),d=Array.isArray(n.skillPackages)&&n.skillPackages.length>0?n.skillPackages:n.skillPackage?[n.skillPackage]:[],e=[];for(const a of d){const h=await X(i??{tenantId:"_legacy",userId:"_legacy"},a,s);h&&e.push(h)}e.length>0?(o.skill.packagePresent=!0,o.skill.installedCount=e.length,o.skill.installed=e,l("install-skills","success","\u6280\u80FD\u5305\u90E8\u7F72\u5B8C\u6210",{installedCount:e.length,skills:e.map(a=>a.name)})):l("install-skills","skipped","\u6CA1\u6709\u53EF\u90E8\u7F72\u7684\u6280\u80FD\u5305")}else l("install-skills","skipped","\u5DF2\u8DF3\u8FC7\u6280\u80FD\u5305\u90E8\u7F72\uFF08skillEnabled=false\uFF09");const P=Array.isArray(n.pluginPackages)?n.pluginPackages:[];if(P.length>0){l("install-plugins","running","\u5F00\u59CB\u90E8\u7F72\u63D2\u4EF6\u6A21\u677F\u5305",{count:P.length});const s=await v(M.join(m,"plugins-tmp"));let d=0;for(const e of P)if(!(!e||!String(e.downloadUrl||"").trim()))try{const a=await $(e,s);if(!a)continue;const h=await y.readFile(a.outputPath),D=e.defaultEnabled!==!1,u=await V.saveSharedPlugin(h,a.fileName,D,e.sha256,i??void 0);u.ok?(d++,l("install-plugins","success",`\u63D2\u4EF6 ${u.pluginName||a.fileName} \u5DF2\u90E8\u7F72\u5230\u672C bridge`)):l("install-plugins","error",`\u63D2\u4EF6 ${a.fileName} \u90E8\u7F72\u5931\u8D25: ${u.error||"\u672A\u77E5\u9519\u8BEF"}`)}catch(a){l("install-plugins","error",`\u63D2\u4EF6 ${e.fileName||"(\u672A\u547D\u540D)"} \u90E8\u7F72\u5931\u8D25: ${a instanceof Error?a.message:String(a)}`)}o.plugin={enabled:!0,packagePresent:P.length>0,installedCount:d},d>0?l("install-plugins","success","\u63D2\u4EF6\u6A21\u677F\u5305\u90E8\u7F72\u5B8C\u6210",{installedCount:d}):l("install-plugins","skipped","\u6CA1\u6709\u53EF\u90E8\u7F72\u7684\u63D2\u4EF6\u5305"),await y.rm(s,{recursive:!0,force:!0}).catch(()=>{})}const S=[];if(o.mcp.enabled){l("install-mcp","running","\u5F00\u59CB\u90E8\u7F72 MCP \u6A21\u677F",{count:(Array.isArray(n.mcpServers)?n.mcpServers.length:0)+1});let s;try{const e=_();if(!r)throw new Error("initInstance: \u7F3A\u5C11\u7528\u6237\u4F5C\u7528\u57DF\uFF0C\u65E0\u6CD5\u90E8\u7F72 MCP");s=r.saveMcp(E,e,!0),s.ok&&(i&&F(i,"mcp",E,!0),S.push({id:"",name:E,transport:"stdio",command:e.command||"",url:e.url||"",args:e.args||[],env:e.env||{},enabled:!0,installedAt:new Date().toISOString()}))}catch(e){s={ok:!1,error:e instanceof Error?e.message:String(e)}}s.ok||l("install-mcp","error",`\u5185\u7F6E\u901A\u8BAF MCP \u90E8\u7F72\u5931\u8D25: ${s.error||"\u672A\u77E5\u9519\u8BEF"}`);const d=(Array.isArray(n.mcpServers)?n.mcpServers:[]).map(e=>B(e)).filter(e=>e!==null);for(const e of d){if(q(e.name))continue;const a=String(e.packageUrl||"").trim();if(a)try{if(!r)throw new Error("\u7F3A\u5C11\u7528\u6237\u4F5C\u7528\u57DF");const u=await r.ensureMcpPackage(e.name,{packageUrl:a,packageSha256:e.packageSha256,fileName:`${e.name}.zip`});u.ok||l("install-mcp","error",`MCP \u5305 ${e.name} \u90E8\u7F72\u5931\u8D25: ${u.error||"\u672A\u77E5\u9519\u8BEF"}`)}catch(u){l("install-mcp","error",`MCP \u5305 ${e.name} \u90E8\u7F72\u5931\u8D25: ${u instanceof Error?u.message:String(u)}`)}const h={type:e.transport||"stdio",command:e.command||void 0,url:e.url||void 0,args:e.args||void 0,env:e.env||void 0,headers:e.headers||void 0,collapsed:e.collapsed===!0,description:e.description||void 0};if(!r)continue;r.saveMcp(e.name,h,e.enabled!==!1,e.packageSha256).ok&&S.push({id:e.id||"",name:e.name,transport:e.transport||"stdio",command:e.command||"",url:e.url||"",args:e.args||[],env:e.env||{},enabled:e.enabled!==!1,installedAt:new Date().toISOString()})}o.mcp.installedCount=S.length,l("install-mcp","success","MCP \u6A21\u677F\u90E8\u7F72\u5B8C\u6210",{installedCount:S.length,mcpServers:S.map(e=>e.name)})}else l("install-mcp","skipped","\u5DF2\u8DF3\u8FC7 MCP \u6A21\u677F\uFF08mcpEnabled=false\uFF09");l("persist-state","running","\u5F00\u59CB\u4FDD\u5B58\u5B9E\u4F8B\u72B6\u6001"),k.initialized=!0,k.enabledTools=f,k.toolStatus=g,k.skillEnabled=o.skill.enabled,k.mcpEnabled=o.mcp.enabled,await L(p,k),l("persist-state","success","\u5B9E\u4F8B\u72B6\u6001\u4FDD\u5B58\u5B8C\u6210");const C=i?G(i):0,N=i?Z(i):0,A=i?x(i):0;return(C||N||A)&&l("sync-state","success","\u80FD\u529B\u9ED8\u8BA4\u5F00\u5173\u5DF2\u5BF9\u8D26\uFF08\u65B0\u589E\u9879\u9ED8\u8BA4\u5173\u95ED\uFF09",{reconciledSkills:C,reconciledMcp:N,reconciledPlugins:A}),l("sync-state","success","\u6280\u80FD/MCP \u6A21\u677F\u90E8\u7F72\u72B6\u6001\u5DF2\u5C31\u7EEA"),l("complete","success",w.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"),{...o,installed:{skills:o.skill.installed||[],mcpServers:S}}}export{me as initInstance};
 

package/dist/services/instance-state.d.ts

@@ -1,10 +1,33 @@
 
+
+
+
+
 import type { InstanceState } from "../types.js";
 
+
+
+
 export declare function getInstanceStateFile(agentId: string): string;
 
+
+
+
+
+
 export declare function loadInstanceState(agentId: string): Promise<InstanceState>;
 
+
+
+
+
+
+
 export declare function saveInstanceState(agentId: string, state: Partial<InstanceState>): Promise<InstanceState>;
 
+
+
+
+
+
 export declare function getAgentInitRoot(agentId: string): string;

package/dist/services/jdk-scanner.d.ts

@@ -1,4 +1,9 @@
 
+
+
+
+
+
 export interface JdkInfo {
     id: string;
     
@@ -11,10 +16,20 @@ export interface JdkInfo {
     source: "scan" | "manual";
 }
 
+
+
 export declare function scanInstalledJdks(): Promise<JdkInfo[]>;
 
+
+
+
 export declare function listJdks(): Promise<JdkInfo[]>;
 
+
+
+
 export declare function addManualJdk(jdkPath: string): Promise<JdkInfo>;
 
+
+
 export declare function removeManualJdk(jdkId: string): Promise<boolean>;

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

@@ -1,4 +1,12 @@
 
+
+
+
+
+
+
+
+
 import { type LaunchHistoryEntry, type LaunchHistorySample, type LaunchMetricSample } from "./launch-metrics.js";
 import { type RingBufferSlice } from "./ring-buffer.js";
 export type LaunchRunState = "running" | "exited" | "stopped";
@@ -58,6 +66,14 @@ export interface LaunchLogsResult {
     oldestIndex: number;
 }
 
+
+
+
+
+
+
+
+
 export interface LaunchStartupWaitResult {
     outcome: "ready" | "exited" | "stopped" | "timeout";
     
@@ -72,12 +88,22 @@ export interface LaunchStartupWaitResult {
     logTail: LaunchLogEntry[];
 }
 
+
+
+
+
+
 export declare class LaunchAlreadyRunningError extends Error {
     
     readonly existing: LaunchRun;
     constructor(existing: LaunchRun);
 }
 
+
+
+
+
+
 export interface LaunchBatchItemResult {
     configId: string;
     ok: boolean;
@@ -105,12 +131,24 @@ export interface LaunchBatchResult {
     };
 }
 
+
+
+
 export declare function resolvePlaceholders(command: string, ctx: {
     workspacePath?: string;
     jdkPath?: string;
     env?: Record<string, string>;
 }): string;
 
+
+
+
+
+
+
+
+
+
 export declare class StreamDecoder {
     private readonly utf8Probe;
     private readonly utf8;
@@ -121,6 +159,10 @@ export declare class StreamDecoder {
     private bufferedSize;
     private flushTimer;
     
+
+
+
+
     constructor(onFlush?: (text: string) => void);
     
     decode(chunk: Buffer): string;
@@ -129,6 +171,8 @@ export declare class StreamDecoder {
     private commit;
 }
 
+
+
 export declare class LaunchManager {
     private static instance;
     
@@ -136,8 +180,16 @@ export declare class LaunchManager {
     
     private readonly logs;
     
+
+
+
+
     private readonly startupWaiters;
     
+
+
+
+
     private readonly readinessMatchers;
     
     private readonly logListeners;
@@ -152,50 +204,136 @@ export declare class LaunchManager {
     
     private runningRefs;
     
+
+
+
+
+
     start(req: LaunchStartRequest): Promise<LaunchRun>;
     
+
+
+
+
+
     stop(configId: string, reason?: "manual" | "shutdown", actor?: string): Promise<{
         success: boolean;
         message: string;
         pid?: number;
     }>;
     
+
+
+
+
+
     restart(req: LaunchStartRequest): Promise<LaunchRun>;
     
+
+
+
+
+
+
     startBatch(items: LaunchStartRequest[], waitTimeoutMs: number): Promise<LaunchBatchResult>;
     
+
+
+
+
+
     stopAll(): Promise<{
         running: number;
         stopped: number;
     }>;
     
+
+
+
+
+
+
+
+
+
+
+
+
     waitStartupResult(configId: string, timeoutMs: number): Promise<LaunchStartupWaitResult>;
     
+
+
+
     private scanReadinessMatch;
     
     private resolveStartupWaiters;
     
+
+
+
+
+
+
+
+
+
     listRuns(options?: {
         withPorts?: boolean;
     }): Promise<LaunchRunSummary[]>;
     
+
+
+
+
     private probePorts;
     
+
+
+
+
+
+
     publishRunningPorts(): Promise<void>;
     
+
+
     getLogs(configId: string, sinceIndex: number): Promise<LaunchLogsResult | null>;
     
+
+
     getRun(configId: string): LaunchRun | undefined;
     
+
+
+
     getMetrics(configId: string, limit?: number): LaunchHistorySample[];
     
+
+
     getMetricsSince(configId: string, sinceIndex: number, limit?: number): LaunchHistoryEntry[];
     
+
+
+
+
+
+
+
     private ensureRestored;
     
+
+
+
+
+
+
     private publishRunStatus;
     
+
+
     private persist;
 }
 
+
+
 export declare function getLaunchManager(): LaunchManager;

package/dist/services/launch-metrics.d.ts

@@ -1,5 +1,23 @@
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 export declare const METRICS_SAMPLE_INTERVAL_MS = 5000;
 
 export declare const METRICS_HISTORY_CAPACITY = 900;
@@ -39,10 +57,19 @@ export interface RunningRunRef {
     pid: number;
 }
 
+
+
+
 export declare function parseWindowsProcessTable(output: string): ProcessEntry[];
 
+
+
+
 export declare function parsePsCpuTime(value: string): number;
 
+
+
+
 export declare function parseUnixProcessTable(output: string, threadsColumn: boolean): ProcessEntry[];
 
 export interface ProcessTreeAggregate {
@@ -53,8 +80,14 @@ export interface ProcessTreeAggregate {
     found: boolean;
 }
 
+
+
+
 export declare function aggregateProcessTree(entries: ProcessEntry[], rootPid: number): ProcessTreeAggregate;
 
+
+
+
 export declare function computeCpuPercent(previous: {
     at: number;
     totalCpuMs: number;
@@ -63,6 +96,12 @@ export declare function computeCpuPercent(previous: {
     totalCpuMs: number;
 }): number;
 
+
+
+
+
+
+
 export declare class LaunchMetricsMonitor {
     private readonly getRuns;
     
@@ -74,6 +113,9 @@ export declare class LaunchMetricsMonitor {
     private ticking;
     constructor(getRuns: () => RunningRunRef[]);
     
+
+
+
     ensureRunning(): void;
     
     stop(): void;

package/dist/services/launch-streams.d.ts

@@ -1,4 +1,15 @@
 
+
+
+
+
+
+
+
+
+
+
+
 export type LaunchStreamKind = "logs" | "metrics";
 export declare class LaunchStreamHub {
     private static instance;
@@ -8,10 +19,18 @@ export declare class LaunchStreamHub {
     private readonly statusSubscribers;
     static getInstance(): LaunchStreamHub;
     
+
+
+
+
     subscribe(configId: string, kind: LaunchStreamKind, send: (frame: string) => void): () => void;
     
     subscriberCount(configId: string, kind: LaunchStreamKind): number;
     
+
+
+
+
     subscribeStatus(send: (frame: string) => void): () => void;
     
     publishStatusRun(run: unknown): void;

package/dist/services/lifecycle-state.d.ts

@@ -30,5 +30,10 @@ export declare function createBridgeLifecycleOperation(input: {
 export declare function upsertBridgeLifecycleOperation(operation: BridgeLifecycleOperation): Promise<void>;
 export declare function removeBridgeLifecycleOperation(operationId: string): Promise<void>;
 
+
+
+
+
+
 export declare function deliverPendingBridgeLifecycleNotifications(): Promise<void>;
 export {};

package/dist/services/log-retention.d.ts

@@ -1,9 +1,41 @@
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 export declare const DEFAULT_LOG_RETENTION_DAYS = 7;
 
 export declare function normalizeLogRetentionDays(value: unknown): number;
 
+
+
+
+
 export declare function setLogRetentionDays(value: unknown): number;
 
 export declare function getLogRetentionDays(): number;
@@ -30,8 +62,14 @@ export interface LogRetentionSweepResult {
     bytesFreed: number;
 }
 
+
+
+
 export declare function sweepExpiredLogs(): Promise<LogRetentionSweepResult>;
 
+
+
+
 export declare function startLogRetention(): void;
 
 export declare function stopLogRetention(): void;

package/dist/services/lsp/install-manager.d.ts

@@ -0,0 +1,55 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+import { type LspProviderSpec } from "./provider-registry.js";
+export type LspInstallPhase = "queued" | "installing" | "done" | "error" | "removing";
+export interface LspInstallTask {
+    providerId: string;
+    phase: LspInstallPhase;
+    startedAt: string;
+    finishedAt?: string;
+    
+    logs: string[];
+    error?: string | null;
+}
+
+
+
+
+export declare function installLspProvider(providerId: string, options?: {
+    registry?: string;
+}): Promise<LspInstallTask>;
+
+export declare function uninstallLspProvider(providerId: string): Promise<LspInstallTask>;
+
+export declare function getLspInstallTask(providerId: string): LspInstallTask | null;
+
+export declare function listLspInstallTasks(): LspInstallTask[];
+
+
+
+
+export declare function getProviderDiskUsage(providerId: string): Promise<number | null>;
+
+export declare function detectNpmRegistry(): Promise<string | null>;
+
+export declare function describeInstallStatus(providerId: string): {
+    providerId: string;
+    task: LspInstallTask | null;
+};
+
+export declare function isInstallBusy(): boolean;
+
+export declare function listNpmProviders(): LspProviderSpec[];

package/dist/services/lsp/install-manager.js

@@ -0,0 +1,2 @@
+import{execFile as v,spawn as x}from"node:child_process";import{promises as l}from"node:fs";import $ from"node:path";import{promisify as k}from"node:util";import{createLogger as L}from"../../utils/logger.js";import{getLspServerDir as d,getProvider as P,listAllProviders as S}from"./provider-registry.js";const A=k(v),m=L("lsp-install"),I=200,p=new Map;let u=null;function c(){return new Date().toISOString()}function w(){return process.platform==="win32"?"npm.cmd":"npm"}function f(t,r){for(const e of r.split(/\r?\n/)){const n=e.trim();n&&t.logs.push(n)}for(;t.logs.length>I;)t.logs.shift()}function h(t){const r=P(t);if(!r)throw new Error(`unknown lsp provider: ${t}`);if(r.kind!=="npm"||!r.npmPackage)throw new Error(r.kind==="builtin"?`${r.label} \u5DF2\u5185\u7F6E\uFF0C\u65E0\u9700\u5B89\u88C5`:`${r.label} \u9700\u8981\u5728\u672C\u673A\u5B89\u88C5\u539F\u751F\u8BED\u8A00\u670D\u52A1\uFF1A${(r.systemBinaries??[]).join(" / ")}`);return r}async function b(t,r,e){const n={...process.env};e.registry&&(n.npm_config_registry=e.registry),await new Promise((i,a)=>{const o=x(w(),r,{env:n,shell:process.platform==="win32",stdio:["ignore","pipe","pipe"]});o.stdout?.on("data",s=>f(t,s.toString("utf8"))),o.stderr?.on("data",s=>f(t,s.toString("utf8"))),o.on("error",s=>a(s)),o.on("exit",s=>{s===0?i():a(new Error(`npm ${r[0]??""} exited with code ${s}`))})})}async function B(t,r={}){const e=h(t),n=p.get(e.id);if(n&&(n.phase==="installing"||n.phase==="queued")||n&&n.phase==="done")return n;const i={providerId:e.id,phase:"queued",startedAt:c(),logs:[],error:null};return p.set(e.id,i),u=(async()=>{i.phase="installing";const o=d(e.id);await l.mkdir(o,{recursive:!0}),f(i,`\u5B89\u88C5 ${e.npmPackage}@${e.npmVersion} \u2192 ${o}`);try{await b(i,["install","--prefix",o,"--no-audit","--no-fund","--loglevel","error",`${e.npmPackage}@${e.npmVersion}`],r),i.phase="done",i.finishedAt=c(),m.info(`[lsp-install] \u5B89\u88C5\u5B8C\u6210 provider=${e.id}`)}catch(s){i.phase="error",i.error=s.message,i.finishedAt=c(),m.warn(`[lsp-install] \u5B89\u88C5\u5931\u8D25 provider=${e.id}: ${i.error}`)}finally{u=null}})(),await u,i}async function M(t){const r=h(t),e={providerId:r.id,phase:"removing",startedAt:c(),logs:[],error:null};p.set(r.id,e);const n=d(r.id);return await l.rm(n,{recursive:!0,force:!0}),e.phase="done",e.finishedAt=c(),f(e,`\u5DF2\u5220\u9664 ${n}`),m.info(`[lsp-install] \u5378\u8F7D\u5B8C\u6210 provider=${r.id}`),e}function D(t){return p.get(String(t||"").trim().toLowerCase())??null}function O(){return[...p.values()]}async function V(t){const r=d(t);try{if(!(await l.stat(r)).isDirectory())return null;let n=0;const i=async a=>{const o=await l.readdir(a,{withFileTypes:!0});for(const s of o){const g=$.join(a,s.name);if(s.isDirectory())await i(g);else if(s.isFile()){const y=await l.stat(g);n+=y.size}}};return await i(r),n}catch{return null}}async function j(){try{const{stdout:t}=await A(w(),["config","get","registry"],{timeout:1e4});return String(t||"").trim()||null}catch{return null}}function z(t){return{providerId:t,task:D(t)}}function C(){return u!==null}function G(){return S().filter(t=>t.kind==="npm")}export{z as describeInstallStatus,j as detectNpmRegistry,D as getLspInstallTask,V as getProviderDiskUsage,B as installLspProvider,C as isInstallBusy,O as listLspInstallTasks,G as listNpmProviders,M as uninstallLspProvider};
+