aws-runtime-bridge 1.9.172 → 1.9.179

package/dist/services/mcp-deploy.js

@@ -1,5 +1,5 @@
-import{existsSync as f,mkdirSync as p,readFileSync as d,renameSync as y,rmSync as h,writeFileSync as M}from"node:fs";import s from"node:path";import{getBridgeTemplateMcpDir as v,getBridgeTemplateMcpPackagesDir as $}from"../config.js";import{downloadPluginZip as N}from"../utils/file-utils.js";import{createLogger as j}from"../utils/logger.js";import{setDeployedDefaultsProvider as C,reconcileDefaultsFromDeployed as F}from"./capability-config.js";import{isCapabilityEnabled as P}from"./instance-features.js";import{extractMcpPackageZip as E,runMcpPackageInstall as b}from"./mcp-package.js";const g=j("mcp-deploy"),O=1;class c{static getInstance(){return this._instance||(this._instance=new c(s.join(v(),"deployed"))),this._instance}constructor(e){this.rootDir=e}static isValidName(e){return!e||e==="."||e===".."||e!==s.basename(e)?!1:/^[a-zA-Z0-9_.-]+$/.test(e)}manifestFile(){return s.join(this.rootDir,"manifest.json")}specFile(e){const r=s.join(this.rootDir,`${e}.json`),t=s.resolve(this.rootDir);if(s.resolve(r)!==s.join(t,`${e}.json`))throw new Error(`MCP \u6A21\u677F\u6587\u4EF6\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return r}isHealthy(e){return f(this.specFile(e))}readManifest(){try{const e=JSON.parse(d(this.manifestFile(),"utf8"));return Array.isArray(e.servers)?e.servers.filter(r=>r&&r.name):[]}catch{return[]}}writeManifest(e){p(this.rootDir,{recursive:!0}),M(this.manifestFile(),`${JSON.stringify({version:O,servers:e},null,2)}
-`,"utf8")}saveMcp(e,r,t=!0,i){if(!c.isValidName(e))return{ok:!1,error:`MCP \u540D\u975E\u6CD5: ${JSON.stringify(e)}`};p(this.rootDir,{recursive:!0});try{M(this.specFile(e),`${JSON.stringify(r,null,2)}
-`,"utf8")}catch(n){return{ok:!1,error:`MCP \u6A21\u677F\u5199\u5165\u5931\u8D25: ${n instanceof Error?n.message:String(n)}`}}const a=this.readManifest().filter(n=>n.name!==e);return a.push({name:e,fileName:`${e}.json`,defaultEnabled:t,sha256:i}),this.writeManifest(a),g.info("[mcp] MCP \u6A21\u677F\u5DF2\u90E8\u7F72\u5230 bridge: %s",e),{ok:!0,name:e}}removeMcp(e){if(!c.isValidName(e))return{ok:!1,error:"name \u975E\u6CD5"};const r=this.readManifest().filter(t=>t.name!==e);this.writeManifest(r);try{h(this.specFile(e),{force:!0})}catch(t){return{ok:!1,error:`\u6A21\u677F\u6587\u4EF6\u6E05\u7406\u5931\u8D25: ${t instanceof Error?t.message:String(t)}`}}return this.removeMcpPackage(e),g.info("[mcp] MCP \u6A21\u677F\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",e),{ok:!0}}packagesDir(){return $()}packagesManifestFile(){return s.join(this.packagesDir(),"manifest.json")}packageDir(e){if(!c.isValidName(e))throw new Error(`\u975E\u6CD5 MCP \u540D: ${JSON.stringify(e)}`);const r=s.join(this.packagesDir(),e),t=s.resolve(this.packagesDir());if(s.resolve(r)!==s.join(t,e))throw new Error(`MCP \u5305\u76EE\u5F55\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return r}isPackageHealthy(e){try{return f(s.join(this.packageDir(e),"mcp.json"))}catch{return!1}}readPackagesManifest(){try{const e=JSON.parse(d(this.packagesManifestFile(),"utf8"));return Array.isArray(e.packages)?e.packages.filter(r=>r&&r.name):[]}catch{return[]}}writePackagesManifest(e){p(this.packagesDir(),{recursive:!0}),M(this.packagesManifestFile(),`${JSON.stringify({version:1,packages:e},null,2)}
-`,"utf8")}packageUpToDate(e,r){return this.isPackageHealthy(e)?r?this.readPackagesManifest().find(i=>i.name===e)?.packageSha256===r:!0:!1}async ensureMcpPackage(e,r){if(!c.isValidName(e))return{ok:!1,error:`MCP \u540D\u975E\u6CD5: ${JSON.stringify(e)}`};const t=String(r?.packageUrl??"").trim();if(!t)return{ok:!1,error:"packageUrl \u4E3A\u7A7A"};if(this.packageUpToDate(e,r.packageSha256))return{ok:!0,name:e};const i=s.join(this.packagesDir(),"tmp",`pull-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{p(i,{recursive:!0});const a=r.fileName?.trim()||`${e}.zip`,n=await N({downloadUrl:t,fileName:a,sha256:r.packageSha256},i);if(!n)return{ok:!1,error:`\u4E0B\u8F7D MCP \u5305\u65E0\u54CD\u5E94: ${t}`};const S=d(n.outputPath),w=s.join(i,"extract"),o=await E(S,w);await b(o.packageDir,o.manifest),p(this.packagesDir(),{recursive:!0});const l=this.packageDir(e),u=s.join(this.packagesDir(),`.old-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);let k=!1;f(l)&&(y(l,u),k=!0);try{y(o.packageDir,l)}catch(m){throw k&&f(u)&&(h(l,{recursive:!0,force:!0}),y(u,l)),m}k&&f(u)&&h(u,{recursive:!0,force:!0});const D=this.readPackagesManifest().filter(m=>m.name!==e);return D.push({name:e,fileName:n.fileName,packageSha256:r.packageSha256,dependencies:o.manifest.dependencies}),this.writePackagesManifest(D),g.info("[mcp] \u5305\u578B MCP \u5DF2\u90E8\u7F72\u5230 bridge: %s\uFF08%d \u4E2A\u6587\u4EF6, dependencies=%s\uFF09",e,o.fileCount,o.manifest.dependencies),{ok:!0,name:e}}catch(a){const n=a instanceof Error?a.message:String(a);return g.warn("[mcp] \u5305\u578B MCP \u90E8\u7F72\u5931\u8D25\uFF08%s\uFF09: %s",e,n),{ok:!1,error:`MCP \u5305\u90E8\u7F72\u5931\u8D25: ${n}`}}finally{try{h(i,{recursive:!0,force:!0})}catch{}}}removeMcpPackage(e){try{const t=this.packageDir(e);f(t)&&h(t,{recursive:!0,force:!0})}catch(t){g.warn("[mcp] MCP \u5305\u76EE\u5F55\u6E05\u7406\u5931\u8D25\uFF08%s\uFF09: %s",e,t instanceof Error?t.message:String(t))}const r=this.readPackagesManifest().filter(t=>t.name!==e);try{this.writePackagesManifest(r)}catch{}}listDeployed(){return this.readManifest().map(e=>({...e,deployed:this.isHealthy(e.name)}))}getSpec(e){if(!this.isHealthy(e))return null;try{return JSON.parse(d(this.specFile(e),"utf8"))}catch{return null}}resolveEnabledMcp(e,r){const t={};for(const i of this.readManifest()){if(!P(e,"mcp",i.name)||!this.isHealthy(i.name))continue;const a=this.getSpec(i.name);a&&(t[i.name]={...a,type:a.type||"stdio"})}for(const[i,a]of Object.entries(r))P(e,"mcp",i)&&(t[i]||(t[i]=a));return t}deployedDefaultEnabled(){const e={};for(const r of this.readManifest())e[r.name]=r.defaultEnabled;return e}}c._instance=null;const J=c.getInstance();C("mcp",()=>J.deployedDefaultEnabled());const z=()=>F("mcp");export{c as McpDeployManager,J as mcpDeployManager,z as reconcileMcpDefaultsFromDeployed};
+import{existsSync as l,mkdirSync as h,readFileSync as d,renameSync as M,rmSync as g,writeFileSync as D}from"node:fs";import s from"node:path";import{downloadPluginZip as $}from"../utils/file-utils.js";import{createLogger as N}from"../utils/logger.js";import{setDeployedDefaultsProvider as j,reconcileDefaultsFromDeployed as C}from"./capability-config.js";import{isCapabilityEnabled as P}from"./instance-features.js";import{extractMcpPackageZip as F,runMcpPackageInstall as E}from"./mcp-package.js";import{getUserMcpDeployedDir as b,getUserMcpPackagesDir as O}from"./user-scope.js";const k=N("mcp-deploy"),J=1;class o{static forScope(e){const r=b(e),t=s.resolve(r);let i=this.instances.get(t);return i||(i=new o(e,r,O(e)),this.instances.set(t,i)),i}constructor(e,r,t){this.scope=e,this.rootDir=r,this.packagesRootDir=t}static isValidName(e){return!e||e==="."||e===".."||e!==s.basename(e)?!1:/^[a-zA-Z0-9_.-]+$/.test(e)}manifestFile(){return s.join(this.rootDir,"manifest.json")}specFile(e){const r=s.join(this.rootDir,`${e}.json`),t=s.resolve(this.rootDir);if(s.resolve(r)!==s.join(t,`${e}.json`))throw new Error(`MCP \u6A21\u677F\u6587\u4EF6\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return r}isHealthy(e){return l(this.specFile(e))}readManifest(){try{const e=JSON.parse(d(this.manifestFile(),"utf8"));return Array.isArray(e.servers)?e.servers.filter(r=>r&&r.name):[]}catch{return[]}}writeManifest(e){h(this.rootDir,{recursive:!0}),D(this.manifestFile(),`${JSON.stringify({version:J,servers:e},null,2)}
+`,"utf8")}saveMcp(e,r,t=!0,i){if(!o.isValidName(e))return{ok:!1,error:`MCP \u540D\u975E\u6CD5: ${JSON.stringify(e)}`};h(this.rootDir,{recursive:!0});try{D(this.specFile(e),`${JSON.stringify(r,null,2)}
+`,"utf8")}catch(n){return{ok:!1,error:`MCP \u6A21\u677F\u5199\u5165\u5931\u8D25: ${n instanceof Error?n.message:String(n)}`}}const a=this.readManifest().filter(n=>n.name!==e);return a.push({name:e,fileName:`${e}.json`,defaultEnabled:t,sha256:i}),this.writeManifest(a),k.info("[mcp] MCP \u6A21\u677F\u5DF2\u90E8\u7F72\u5230 bridge: %s",e),{ok:!0,name:e}}removeMcp(e){if(!o.isValidName(e))return{ok:!1,error:"name \u975E\u6CD5"};const r=this.readManifest().filter(t=>t.name!==e);this.writeManifest(r);try{g(this.specFile(e),{force:!0})}catch(t){return{ok:!1,error:`\u6A21\u677F\u6587\u4EF6\u6E05\u7406\u5931\u8D25: ${t instanceof Error?t.message:String(t)}`}}return this.removeMcpPackage(e),k.info("[mcp] MCP \u6A21\u677F\u5DF2\u4ECE bridge \u79FB\u9664\u90E8\u7F72: %s",e),{ok:!0}}packagesDir(){return this.packagesRootDir}packagesManifestFile(){return s.join(this.packagesDir(),"manifest.json")}packageDir(e){if(!o.isValidName(e))throw new Error(`\u975E\u6CD5 MCP \u540D: ${JSON.stringify(e)}`);const r=s.join(this.packagesDir(),e),t=s.resolve(this.packagesDir());if(s.resolve(r)!==s.join(t,e))throw new Error(`MCP \u5305\u76EE\u5F55\u8D8A\u51FA\u90E8\u7F72\u533A: ${e}`);return r}isPackageHealthy(e){try{return l(s.join(this.packageDir(e),"mcp.json"))}catch{return!1}}readPackagesManifest(){try{const e=JSON.parse(d(this.packagesManifestFile(),"utf8"));return Array.isArray(e.packages)?e.packages.filter(r=>r&&r.name):[]}catch{return[]}}writePackagesManifest(e){h(this.packagesDir(),{recursive:!0}),D(this.packagesManifestFile(),`${JSON.stringify({version:1,packages:e},null,2)}
+`,"utf8")}packageUpToDate(e,r){return this.isPackageHealthy(e)?r?this.readPackagesManifest().find(i=>i.name===e)?.packageSha256===r:!0:!1}async ensureMcpPackage(e,r){if(!o.isValidName(e))return{ok:!1,error:`MCP \u540D\u975E\u6CD5: ${JSON.stringify(e)}`};const t=String(r?.packageUrl??"").trim();if(!t)return{ok:!1,error:"packageUrl \u4E3A\u7A7A"};if(this.packageUpToDate(e,r.packageSha256))return{ok:!0,name:e};const i=s.join(this.packagesDir(),"tmp",`pull-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);try{h(i,{recursive:!0});const a=r.fileName?.trim()||`${e}.zip`,n=await $({downloadUrl:t,fileName:a,sha256:r.packageSha256},i);if(!n)return{ok:!1,error:`\u4E0B\u8F7D MCP \u5305\u65E0\u54CD\u5E94: ${t}`};const w=d(n.outputPath),v=s.join(i,"extract"),f=await F(w,v);await E(f.packageDir,f.manifest),h(this.packagesDir(),{recursive:!0});const u=this.packageDir(e),p=s.join(this.packagesDir(),`.old-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`);let y=!1;l(u)&&(M(u,p),y=!0);try{M(f.packageDir,u)}catch(m){throw y&&l(p)&&(g(u,{recursive:!0,force:!0}),M(p,u)),m}y&&l(p)&&g(p,{recursive:!0,force:!0});const S=this.readPackagesManifest().filter(m=>m.name!==e);return S.push({name:e,fileName:n.fileName,packageSha256:r.packageSha256,dependencies:f.manifest.dependencies}),this.writePackagesManifest(S),k.info("[mcp] \u5305\u578B MCP \u5DF2\u90E8\u7F72\u5230 bridge: %s\uFF08%d \u4E2A\u6587\u4EF6, dependencies=%s\uFF09",e,f.fileCount,f.manifest.dependencies),{ok:!0,name:e}}catch(a){const n=a instanceof Error?a.message:String(a);return k.warn("[mcp] \u5305\u578B MCP \u90E8\u7F72\u5931\u8D25\uFF08%s\uFF09: %s",e,n),{ok:!1,error:`MCP \u5305\u90E8\u7F72\u5931\u8D25: ${n}`}}finally{try{g(i,{recursive:!0,force:!0})}catch{}}}removeMcpPackage(e){try{const t=this.packageDir(e);l(t)&&g(t,{recursive:!0,force:!0})}catch(t){k.warn("[mcp] MCP \u5305\u76EE\u5F55\u6E05\u7406\u5931\u8D25\uFF08%s\uFF09: %s",e,t instanceof Error?t.message:String(t))}const r=this.readPackagesManifest().filter(t=>t.name!==e);try{this.writePackagesManifest(r)}catch{}}listDeployed(){return this.readManifest().map(e=>({...e,deployed:this.isHealthy(e.name)}))}getSpec(e){if(!this.isHealthy(e))return null;try{return JSON.parse(d(this.specFile(e),"utf8"))}catch{return null}}resolveEnabledMcp(e,r){const t={};for(const i of this.readManifest()){if(!P(e,"mcp",i.name)||!this.isHealthy(i.name))continue;const a=this.getSpec(i.name);a&&(t[i.name]={...a,type:a.type||"stdio"})}for(const[i,a]of Object.entries(r))P(e,"mcp",i)&&(t[i]||(t[i]=a));return t}deployedDefaultEnabled(){const e={};for(const r of this.readManifest())e[r.name]=r.defaultEnabled;return e}}o.instances=new Map;function Z(c){return o.forScope(c)}j("mcp",c=>c?o.forScope(c).deployedDefaultEnabled():{});const B=c=>C(c,"mcp");export{o as McpDeployManager,Z as getMcpDeployManager,B as reconcileMcpDefaultsFromDeployed};
 

package/dist/services/mcp-env-injector.d.ts

@@ -4,10 +4,30 @@ export declare function isStdioMcpSpec(spec: unknown): boolean;
 export declare const MCP_PACKAGE_DIR_PLACEHOLDER = "${MCP_PACKAGE_DIR}";
 export declare const MCP_NODE_PLACEHOLDER = "${MCP_NODE}";
 
+
+
+
+
+
+
+
+
+
+
 export declare function expandMcpPackagePlaceholders(record: Record<string, unknown>, packageDir?: string, nodePath?: string): boolean;
 
 export declare function isBuiltinMcpName(name: string): boolean;
 
+
+
+
+
+
+
+
+
+
+
 export declare const AGENT_META_ENV_KEYS: {
     readonly agentId: "AWS_AGENT_ID";
     readonly roleId: "AWS_AGENT_ROLE_ID";
@@ -21,16 +41,48 @@ export interface AgentMetaEnvInput {
     projectId?: string;
 }
 
+
+
+
 export declare function buildAgentMetaEnv(meta: AgentMetaEnvInput | undefined): Record<string, string>;
 
+
+
+
+
+
+
 export declare function expandEnvPlaceholders(text: string, env: Record<string, string>): string;
 export interface InjectEnvOptions {
     
+
+
+
     overwriteExisting?: boolean;
     
+
+
+
+
     resolvePackageDir?: (name: string) => string | undefined;
     
+
+
+
+
     agentMeta?: AgentMetaEnvInput;
 }
 
+
+
+
+
+
+
+
+
+
+
+
+
 export declare function injectEffectiveEnvIntoMcpServers(servers: Record<string, unknown>, effectiveEnv: Record<string, string>, options?: InjectEnvOptions): string[];

package/dist/services/mcp-launch-binding-queue.d.ts

@@ -32,17 +32,29 @@ export declare function enqueueMcpLaunchBinding(input: McpLaunchBindingInput): M
 export declare function claimMcpLaunchBinding(request: McpLaunchBindingClaimRequest): ClaimedMcpLaunchBinding | null;
 export declare function getMcpLaunchQueueSize(workspacePath: unknown): number;
 
+
+
+
 export declare function removeMcpLaunchBinding(bindingId: string): boolean;
 export declare function clearMcpLaunchBindingQueues(): void;
 
+
+
+
 export declare function getLatestAgentToken(agentId: string): {
     runtimeAccessToken: string;
 } | null;
 
+
+
+
 export declare function getLatestAgentTokenEntry(agentId: string): {
     runtimeAccessToken: string;
     schedulerBaseUrl?: string;
     updatedAt: number;
 } | null;
 
+
+
+
 export declare function updateLatestAgentToken(agentId: string, runtimeAccessToken: string, schedulerBaseUrl?: string): void;

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

@@ -1,4 +1,15 @@
 
+
+
+
+
+
+
+
+
+
+
+
 export interface McpPackageManifestEnvField {
     key: string;
     required?: boolean;
@@ -17,9 +28,14 @@ export interface McpPackageManifest {
     install?: string;
     description?: string;
     
+
+
+
     env?: McpPackageManifestEnvField[];
 }
 
+
+
 export declare function validateMcpPackageManifest(raw: unknown): McpPackageManifest;
 
 export declare function readMcpPackageManifest(packageDir: string): McpPackageManifest;
@@ -30,6 +46,12 @@ export interface McpPackageExtractResult {
     manifest: McpPackageManifest;
 }
 
+
+
+
 export declare function extractMcpPackageZip(zipBuffer: Buffer, stagingRoot: string): Promise<McpPackageExtractResult>;
 
+
+
+
 export declare function runMcpPackageInstall(packageDir: string, manifest: McpPackageManifest): Promise<void>;

package/dist/services/mcp-package.js

@@ -1,2 +1,2 @@
-import{spawn as l}from"node:child_process";import{existsSync as E,readFileSync as g}from"node:fs";import h from"node:path";import{createLogger as S}from"../utils/logger.js";import{BLOCKED_ENV_KEYS as w,ENV_KEY_PATTERN as y}from"../utils/env-safety.js";import{extractPluginZip as T}from"./plugin-package.js";const A=S("mcp-package"),$=new Set(["node","python","binary"]),M=new Set(["bundled","npm"]),d="mcp.json",N=/^[A-Za-z0-9_./@+-]+$/,a=/^(npm|pnpm|yarn)\s+(ci|install)(\s+[A-Za-z0-9@._/:=+-]+)*$/,u=5*60*1e3,P=64*1024;function f(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function _(n){if(n==null)return;if(!Array.isArray(n))throw new Error("mcp.json \u7684 env \u975E\u6CD5\uFF08\u987B\u4E3A\u6570\u7EC4\uFF09");if(n.length===0)return;if(n.length>64)throw new Error("mcp.json \u7684 env \u6700\u591A\u58F0\u660E 64 \u9879");const i=new Set,e=[];for(const r of n){if(!f(r))throw new Error("mcp.json \u7684 env \u5143\u7D20\u975E\u6CD5\uFF08\u987B\u4E3A\u5BF9\u8C61\uFF09");const t=String(r.key??"").trim();if(!t)throw new Error("mcp.json \u7684 env \u5143\u7D20\u7F3A\u5C11 key");if(!y.test(t))throw new Error(`mcp.json \u7684 env \u53D8\u91CF\u540D\u975E\u6CD5: ${t}`);if(w.has(t.toUpperCase()))throw new Error(`mcp.json \u58F0\u660E\u4E86\u7981\u6B62\u7684\u5371\u9669\u73AF\u5883\u53D8\u91CF: ${t}`);if(i.has(t))throw new Error(`mcp.json \u7684 env \u91CD\u590D\u58F0\u660E: ${t}`);i.add(t),e.push({key:t,required:r.required===!0,sensitive:r.sensitive===!0,description:r.description!==void 0?String(r.description):void 0,example:r.example!==void 0?String(r.example):void 0})}return e}function v(n){if(!f(n))throw new Error("mcp.json \u5FC5\u987B\u662F JSON \u5BF9\u8C61");const i=String(n.runtime??"").trim().toLowerCase();if(!$.has(i))throw new Error(`mcp.json \u7684 runtime \u975E\u6CD5\uFF08\u4EC5 node/python/binary\uFF09: ${String(n.runtime)}`);const e=String(n.entry??"").trim();if(!e||!N.test(e)||e.startsWith("/")||/^[A-Za-z]:/.test(e)||e.split(/[\\/]/).includes(".."))throw new Error(`mcp.json \u7684 entry \u975E\u6CD5\uFF08\u987B\u4E3A\u5305\u5185\u76F8\u5BF9\u8DEF\u5F84\uFF09: ${e}`);const r=String(n.dependencies??"bundled").trim().toLowerCase()||"bundled";if(!M.has(r))throw new Error(`mcp.json \u7684 dependencies \u975E\u6CD5\uFF08\u4EC5 bundled/npm\uFF09: ${r}`);let t;if(r==="npm"&&(t=String(n.install??"").trim(),!t||!a.test(t)))throw new Error(`dependencies=npm \u65F6\u5FC5\u987B\u58F0\u660E\u5408\u6CD5\u7684 install \u547D\u4EE4\uFF08\u4EC5 npm/pnpm/yarn \u7684 install/ci\uFF09: ${t}`);const o=Array.isArray(n.args)?n.args.filter(s=>s!=null).map(String):void 0;return{name:n.name!==void 0?String(n.name):void 0,version:n.version!==void 0?String(n.version):void 0,runtime:i,entry:e,args:o,dependencies:r,install:t,description:n.description!==void 0?String(n.description):void 0,env:_(n.env)}}function j(n){const i=h.join(n,d);if(!E(i))throw new Error(`MCP \u5305\u5185\u7F3A\u5C11 ${d}\uFF08\u5305\u578B MCP \u5FC5\u987B\u81EA\u63CF\u8FF0 runtime/entry\uFF09`);let e;try{e=JSON.parse(g(i,"utf8"))}catch(r){throw new Error(`MCP \u5305\u5185 ${d} \u89E3\u6790\u5931\u8D25: ${r instanceof Error?r.message:String(r)}`)}return v(e)}async function O(n,i){const{pluginDir:e,fileCount:r}=await T(n,i),t=j(e);return{packageDir:e,fileCount:r,manifest:t}}async function R(n,i){if(i.dependencies!=="npm")return;const e=String(i.install??"").trim();if(!a.test(e))throw new Error(`\u62D2\u7EDD\u6267\u884C\u975E\u767D\u540D\u5355\u5B89\u88C5\u547D\u4EE4: ${e}`);await new Promise((r,t)=>{A.info("[mcp-package] \u6267\u884C\u4F9D\u8D56\u5B89\u88C5: %s (cwd=%s)",e,n);const o=l(e,{cwd:n,shell:!0,windowsHide:!0});let s="";const p=c=>{s.length<P&&(s+=c.toString("utf8"))};o.stdout?.on("data",p),o.stderr?.on("data",p);const m=setTimeout(()=>{o.kill(),t(new Error(`\u4F9D\u8D56\u5B89\u88C5\u8D85\u65F6\uFF08${u}ms\uFF09: ${e}`))},u);o.on("error",c=>{clearTimeout(m),t(new Error(`\u4F9D\u8D56\u5B89\u88C5\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${c.message}`))}),o.on("close",c=>{if(clearTimeout(m),c!==0){t(new Error(`\u4F9D\u8D56\u5B89\u88C5\u5931\u8D25\uFF08\u9000\u51FA\u7801 ${c}\uFF09: ${s.trim().slice(0,600)||"(\u65E0\u8F93\u51FA)"}`));return}r()})})}export{O as extractMcpPackageZip,j as readMcpPackageManifest,R as runMcpPackageInstall,v as validateMcpPackageManifest};
+import{spawn as l}from"node:child_process";import{existsSync as E,readFileSync as g}from"node:fs";import h from"node:path";import{BLOCKED_ENV_KEYS as S,ENV_KEY_PATTERN as w}from"../utils/env-safety.js";import{createLogger as y}from"../utils/logger.js";import{extractPluginZip as T}from"./plugin-package.js";const A=y("mcp-package"),$=new Set(["node","python","binary"]),M=new Set(["bundled","npm"]),d="mcp.json",N=/^[A-Za-z0-9_./@+-]+$/,a=/^(npm|pnpm|yarn)\s+(ci|install)(\s+[A-Za-z0-9@._/:=+-]+)*$/,u=5*60*1e3,P=64*1024;function f(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function _(n){if(n==null)return;if(!Array.isArray(n))throw new Error("mcp.json \u7684 env \u975E\u6CD5\uFF08\u987B\u4E3A\u6570\u7EC4\uFF09");if(n.length===0)return;if(n.length>64)throw new Error("mcp.json \u7684 env \u6700\u591A\u58F0\u660E 64 \u9879");const i=new Set,e=[];for(const r of n){if(!f(r))throw new Error("mcp.json \u7684 env \u5143\u7D20\u975E\u6CD5\uFF08\u987B\u4E3A\u5BF9\u8C61\uFF09");const t=String(r.key??"").trim();if(!t)throw new Error("mcp.json \u7684 env \u5143\u7D20\u7F3A\u5C11 key");if(!w.test(t))throw new Error(`mcp.json \u7684 env \u53D8\u91CF\u540D\u975E\u6CD5: ${t}`);if(S.has(t.toUpperCase()))throw new Error(`mcp.json \u58F0\u660E\u4E86\u7981\u6B62\u7684\u5371\u9669\u73AF\u5883\u53D8\u91CF: ${t}`);if(i.has(t))throw new Error(`mcp.json \u7684 env \u91CD\u590D\u58F0\u660E: ${t}`);i.add(t),e.push({key:t,required:r.required===!0,sensitive:r.sensitive===!0,description:r.description!==void 0?String(r.description):void 0,example:r.example!==void 0?String(r.example):void 0})}return e}function v(n){if(!f(n))throw new Error("mcp.json \u5FC5\u987B\u662F JSON \u5BF9\u8C61");const i=String(n.runtime??"").trim().toLowerCase();if(!$.has(i))throw new Error(`mcp.json \u7684 runtime \u975E\u6CD5\uFF08\u4EC5 node/python/binary\uFF09: ${String(n.runtime)}`);const e=String(n.entry??"").trim();if(!e||!N.test(e)||e.startsWith("/")||/^[A-Za-z]:/.test(e)||e.split(/[\\/]/).includes(".."))throw new Error(`mcp.json \u7684 entry \u975E\u6CD5\uFF08\u987B\u4E3A\u5305\u5185\u76F8\u5BF9\u8DEF\u5F84\uFF09: ${e}`);const r=String(n.dependencies??"bundled").trim().toLowerCase()||"bundled";if(!M.has(r))throw new Error(`mcp.json \u7684 dependencies \u975E\u6CD5\uFF08\u4EC5 bundled/npm\uFF09: ${r}`);let t;if(r==="npm"&&(t=String(n.install??"").trim(),!t||!a.test(t)))throw new Error(`dependencies=npm \u65F6\u5FC5\u987B\u58F0\u660E\u5408\u6CD5\u7684 install \u547D\u4EE4\uFF08\u4EC5 npm/pnpm/yarn \u7684 install/ci\uFF09: ${t}`);const o=Array.isArray(n.args)?n.args.filter(s=>s!=null).map(String):void 0;return{name:n.name!==void 0?String(n.name):void 0,version:n.version!==void 0?String(n.version):void 0,runtime:i,entry:e,args:o,dependencies:r,install:t,description:n.description!==void 0?String(n.description):void 0,env:_(n.env)}}function j(n){const i=h.join(n,d);if(!E(i))throw new Error(`MCP \u5305\u5185\u7F3A\u5C11 ${d}\uFF08\u5305\u578B MCP \u5FC5\u987B\u81EA\u63CF\u8FF0 runtime/entry\uFF09`);let e;try{e=JSON.parse(g(i,"utf8"))}catch(r){throw new Error(`MCP \u5305\u5185 ${d} \u89E3\u6790\u5931\u8D25: ${r instanceof Error?r.message:String(r)}`)}return v(e)}async function O(n,i){const{pluginDir:e,fileCount:r}=await T(n,i),t=j(e);return{packageDir:e,fileCount:r,manifest:t}}async function R(n,i){if(i.dependencies!=="npm")return;const e=String(i.install??"").trim();if(!a.test(e))throw new Error(`\u62D2\u7EDD\u6267\u884C\u975E\u767D\u540D\u5355\u5B89\u88C5\u547D\u4EE4: ${e}`);await new Promise((r,t)=>{A.info("[mcp-package] \u6267\u884C\u4F9D\u8D56\u5B89\u88C5: %s (cwd=%s)",e,n);const o=l(e,{cwd:n,shell:!0,windowsHide:!0});let s="";const p=c=>{s.length<P&&(s+=c.toString("utf8"))};o.stdout?.on("data",p),o.stderr?.on("data",p);const m=setTimeout(()=>{o.kill(),t(new Error(`\u4F9D\u8D56\u5B89\u88C5\u8D85\u65F6\uFF08${u}ms\uFF09: ${e}`))},u);o.on("error",c=>{clearTimeout(m),t(new Error(`\u4F9D\u8D56\u5B89\u88C5\u8FDB\u7A0B\u542F\u52A8\u5931\u8D25: ${c.message}`))}),o.on("close",c=>{if(clearTimeout(m),c!==0){t(new Error(`\u4F9D\u8D56\u5B89\u88C5\u5931\u8D25\uFF08\u9000\u51FA\u7801 ${c}\uFF09: ${s.trim().slice(0,600)||"(\u65E0\u8F93\u51FA)"}`));return}r()})})}export{O as extractMcpPackageZip,j as readMcpPackageManifest,R as runMcpPackageInstall,v as validateMcpPackageManifest};
 

package/dist/services/mcp-probe-client.d.ts

@@ -1,4 +1,16 @@
 
+
+
+
+
+
+
+
+
+
+
+
+
 import { type AgentMetaEnvInput } from "./mcp-env-injector.js";
 export interface McpProbeTool {
     name: string;
@@ -15,6 +27,8 @@ export interface McpProbeResult {
 }
 export interface McpProbeOptions {
     
+    scope?: import("./user-scope.js").UserScope;
+    
     effectiveEnv?: Record<string, string>;
     
     agentMeta?: AgentMetaEnvInput;
@@ -22,4 +36,9 @@ export interface McpProbeOptions {
     listToolsTimeoutMs?: number;
 }
 
+
+
+
+
+
 export declare function probeDeployedMcp(name: string, options?: McpProbeOptions): Promise<McpProbeResult>;

package/dist/services/mcp-probe-client.js

@@ -1,2 +1,2 @@
-import{Client as C}from"@modelcontextprotocol/sdk/client/index.js";import{StdioClientTransport as P}from"@modelcontextprotocol/sdk/client/stdio.js";import{SSEClientTransport as k}from"@modelcontextprotocol/sdk/client/sse.js";import{StreamableHTTPClientTransport as _}from"@modelcontextprotocol/sdk/client/streamableHttp.js";import{mcpDeployManager as f}from"./mcp-deploy.js";import{buildAgentMetaEnv as b,expandEnvPlaceholders as u,expandMcpPackagePlaceholders as v,isBuiltinMcpName as y}from"./mcp-env-injector.js";import{sanitizeEnvForChild as g}from"../utils/env-safety.js";import{createLogger as L}from"../utils/logger.js";const $=L("mcp-probe"),O=1e4,D=1e4;async function N(t,n={}){const e=String(t??"").trim();if(!e)return{ok:!1,name:e,tools:[],error:"name is required"};if(!/^[a-zA-Z0-9_.-]+$/.test(e))return{ok:!1,name:e,tools:[],error:`MCP \u540D\u975E\u6CD5: ${e}`};if(y(e))return{ok:!1,name:e,tools:[],error:`\u300C${e}\u300D\u662F\u5185\u7F6E\u901A\u8BAF MCP\uFF0C\u4E0D\u63A5\u53D7\u63A2\u6D4B`};const m=f.getSpec(e);if(!m)return{ok:!1,name:e,tools:[],error:`\u672A\u5728\u90E8\u7F72\u533A\u627E\u5230\u8BE5 MCP: ${e}\uFF08\u8BF7\u5148\u5B89\u88C5/\u90E8\u7F72\uFF09`};const i=n.connectTimeoutMs??O,s=n.listToolsTimeoutMs??D,r=new C({name:"aws-runtime-bridge-probe",version:"1.0.0"});try{const a=U(m,n.effectiveEnv??{},e,n.agentMeta);await M(r.connect(a),i,`MCP initialize timeout after ${i}ms`);const{tools:c}=await M(r.listTools(),s,`MCP listTools timeout after ${s}ms`),l=r.getInstructions();return{ok:!0,name:e,tools:(c??[]).map(o=>({name:o.name,...o.description?{description:o.description}:{},...o.inputSchema?{inputSchema:o.inputSchema}:{}})),...l?{instructions:l}:{}}}catch(a){const c=a instanceof Error?a.message:String(a);return $.warn(`[mcp] \u63A2\u6D4B\u5931\u8D25: ${e}: ${c}`),{ok:!1,name:e,tools:[],error:c}}finally{try{await r.close()}catch{}}}function U(t,n,e,m){const i=String(t.type??"stdio").toLowerCase();if(i==="stdio"||t.command){if(!t.command)throw new Error("stdio MCP server requires command");const l=g(n),o=g(t.env??{}),d={...l,...o,...b(m)},w=e&&f.isPackageHealthy(e)?f.packageDir(e):void 0,p={command:t.command,args:t.args??[]};v(p,w);const S=u(String(p.command),d),E=p.args.map(h=>u(String(h),d)),T=new P({command:S,args:E,env:d,stderr:"pipe"});return T.stderr?.on("data",()=>{}),T}if(!t.url)throw new Error("remote MCP server requires url");const s=g(n),r=u(t.url,s),a=t.headers?Object.fromEntries(Object.entries(t.headers).map(([l,o])=>[l,u(String(o),s)])):void 0,c=a?{headers:a}:void 0;return i==="sse"?new k(new URL(r),{requestInit:c}):new _(new URL(r),{requestInit:c})}function M(t,n,e){return new Promise((m,i)=>{const s=setTimeout(()=>i(new Error(e)),n);t.then(r=>{clearTimeout(s),m(r)},r=>{clearTimeout(s),i(r instanceof Error?r:new Error(String(r)))})})}export{N as probeDeployedMcp};
+import{Client as k}from"@modelcontextprotocol/sdk/client/index.js";import{SSEClientTransport as _}from"@modelcontextprotocol/sdk/client/sse.js";import{StdioClientTransport as b}from"@modelcontextprotocol/sdk/client/stdio.js";import{StreamableHTTPClientTransport as v}from"@modelcontextprotocol/sdk/client/streamableHttp.js";import{sanitizeEnvForChild as T}from"../utils/env-safety.js";import{createLogger as y}from"../utils/logger.js";import{McpDeployManager as S}from"./mcp-deploy.js";import{buildAgentMetaEnv as $,expandEnvPlaceholders as u,expandMcpPackagePlaceholders as L,isBuiltinMcpName as O}from"./mcp-env-injector.js";const D=y("mcp-probe"),U=1e4,I=1e4;async function B(r,t={}){const e=String(r??"").trim();if(!e)return{ok:!1,name:e,tools:[],error:"name is required"};if(!/^[a-zA-Z0-9_.-]+$/.test(e))return{ok:!1,name:e,tools:[],error:`MCP \u540D\u975E\u6CD5: ${e}`};if(O(e))return{ok:!1,name:e,tools:[],error:`\u300C${e}\u300D\u662F\u5185\u7F6E\u901A\u8BAF MCP\uFF0C\u4E0D\u63A5\u53D7\u63A2\u6D4B`};const c=t.scope?S.forScope(t.scope).getSpec(e):null;if(!c&&!t.scope)return{ok:!1,name:e,tools:[],error:`\u672A\u5728\u90E8\u7F72\u533A\u627E\u5230\u8BE5 MCP: ${e}\uFF08\u7F3A\u7528\u6237\u4F5C\u7528\u57DF\uFF09`};if(!c)return{ok:!1,name:e,tools:[],error:`\u672A\u5728\u90E8\u7F72\u533A\u627E\u5230\u8BE5 MCP: ${e}\uFF08\u8BF7\u5148\u5B89\u88C5/\u90E8\u7F72\uFF09`};const s=t.connectTimeoutMs??U,i=t.listToolsTimeoutMs??I,n=new k({name:"aws-runtime-bridge-probe",version:"1.0.0"});try{const a=q(c,t.effectiveEnv??{},e,t.agentMeta,t.scope);await w(n.connect(a),s,`MCP initialize timeout after ${s}ms`);const{tools:m}=await w(n.listTools(),i,`MCP listTools timeout after ${i}ms`),l=n.getInstructions();return{ok:!0,name:e,tools:(m??[]).map(o=>({name:o.name,...o.description?{description:o.description}:{},...o.inputSchema?{inputSchema:o.inputSchema}:{}})),...l?{instructions:l}:{}}}catch(a){const m=a instanceof Error?a.message:String(a);return D.warn(`[mcp] \u63A2\u6D4B\u5931\u8D25: ${e}: ${m}`),{ok:!1,name:e,tools:[],error:m}}finally{try{await n.close()}catch{}}}function q(r,t,e,c,s){const i=String(r.type??"stdio").toLowerCase();if(i==="stdio"||r.command){if(!r.command)throw new Error("stdio MCP server requires command");const o=T(t),d=T(r.env??{}),f={...o,...d,...$(c)},p=s?S.forScope(s):null,E=p&&e&&p.isPackageHealthy(e)?p.packageDir(e):void 0,g={command:r.command,args:r.args??[]};L(g,E);const h=u(String(g.command),f),C=g.args.map(P=>u(String(P),f)),M=new b({command:h,args:C,env:f,stderr:"pipe"});return M.stderr?.on("data",()=>{}),M}if(!r.url)throw new Error("remote MCP server requires url");const n=T(t),a=u(r.url,n),m=r.headers?Object.fromEntries(Object.entries(r.headers).map(([o,d])=>[o,u(String(d),n)])):void 0,l=m?{headers:m}:void 0;return i==="sse"?new _(new URL(a),{requestInit:l}):new v(new URL(a),{requestInit:l})}function w(r,t,e){return new Promise((c,s)=>{const i=setTimeout(()=>s(new Error(e)),t);r.then(n=>{clearTimeout(i),c(n)},n=>{clearTimeout(i),s(n instanceof Error?n:new Error(String(n)))})})}export{B as probeDeployedMcp};
 

package/dist/services/open-doc-events.d.ts

@@ -0,0 +1,43 @@
+
+
+
+
+
+
+
+
+
+
+
+import type { OpenDocKind } from "./open-doc-registry.js";
+
+export type OpenDocEvent = {
+    action: "open";
+    kind: OpenDocKind;
+    docId: string;
+    name: string;
+    detail?: string;
+} | {
+    action: "close";
+    kind: OpenDocKind;
+} | {
+    action: "delete";
+    kind: OpenDocKind;
+    docId: string;
+};
+
+
+
+
+
+
+export declare function normalizeSemanticToolName(raw: string | undefined): string;
+
+
+
+
+
+
+
+
+export declare function resolveOpenDocEvent(toolName: string | undefined, args: Record<string, unknown> | undefined, result: unknown): OpenDocEvent | null;

package/dist/services/open-doc-events.js

@@ -0,0 +1,2 @@
+const d={pencil_open_document:"pencil",pencil_close_document:"pencil",pencil_delete_document:"pencil",draw_open_document:"draw",draw_close_document:"draw",draw_delete_document:"draw",office_open_document:"office",office_close_document:"office",office_delete_document:"office"};function s(t){let e=String(t??"").trim().toLowerCase();if(!e)return"";const n=e.lastIndexOf("/");return n>=0&&(e=e.slice(n+1)),e.includes("__")&&(e=e.split("__").pop()??e),e}function p(t,e){if(t!=="call_tool"||!e)return null;const n=e.name;if(typeof n!="string"||!n.trim())return null;const r=e.arguments&&typeof e.arguments=="object"&&!Array.isArray(e.arguments)?e.arguments:{};return{innerName:s(n),innerArgs:r}}function a(t){const e=String(t??"").trim().replace(/\\/g,"/"),n=e.lastIndexOf("/");return n>=0?e.slice(n+1):e}function _(t){if(t&&typeof t=="object"&&!Array.isArray(t))return t;if(typeof t!="string")return null;try{const e=JSON.parse(t);return!e||typeof e!="object"||Array.isArray(e)?null:e}catch{return null}}function g(t,e,n){let r=s(t),c=e;if(r==="call_tool"){const u=p(r,e);if(!u)return null;r=u.innerName,c=u.innerArgs}const o=d[r];if(!o)return null;if(r.endsWith("_close_document"))return{action:"close",kind:o};const i=_(n),f=typeof i?.docId=="string"?i.docId.trim():typeof c?.docId=="string"?c.docId.trim():"";if(r.endsWith("_delete_document"))return f?{action:"delete",kind:o,docId:f}:null;if(!i||i.ok===!1)return null;const l=y(r,o,i,c);if(!l)return null;const m=o==="office"&&typeof i.kind=="string"&&i.kind.trim()?i.kind.trim():void 0;return{action:"open",kind:o,docId:f,name:l,...m?{detail:m}:{}}}function y(t,e,n,r){if(e!=="office"){const f=typeof n.name=="string"?n.name.trim():"";return f||(typeof r?.name=="string"?r.name.trim():"")}const c=typeof n.fileName=="string"?n.fileName.trim():"";if(c)return c;const o=typeof n.file=="string"?n.file.trim():"";if(o)return a(o);const i=typeof r?.file=="string"?r.file.trim():"";return i?a(i):""}export{s as normalizeSemanticToolName,g as resolveOpenDocEvent};
+

package/dist/services/open-doc-registry.d.ts

@@ -0,0 +1,59 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export type OpenDocKind = "pencil" | "draw" | "office";
+
+export interface OpenDocEntry {
+    
+    kind: OpenDocKind;
+    
+    docId: string;
+    
+    name: string;
+    
+    detail?: string;
+}
+
+
+
+
+
+
+export declare function recordOpenDocument(agentId: string | undefined, entry: OpenDocEntry): void;
+
+
+
+
+export declare function closeOpenDocument(agentId: string | undefined, kind: OpenDocKind): void;
+
+
+
+
+
+
+export declare function removeOpenDocument(agentId: string | undefined, kind: OpenDocKind, docId: string): void;
+
+export declare function listOpenDocuments(agentId: string | undefined): OpenDocEntry[];
+
+export declare function clearOpenDocuments(agentId: string | undefined): void;

package/dist/services/open-doc-registry.js

@@ -0,0 +1,2 @@
+const o=new Map;function s(r,t){const e=String(r??"").trim();if(!e||!t.name.trim())return;let n=o.get(e);n||(n=new Map,o.set(e,n)),n.set(t.kind,{...t,docId:t.docId.trim(),name:t.name.trim()})}function f(r,t){const e=String(r??"").trim();e&&o.get(e)?.delete(t)}function g(r,t,e){const n=String(r??"").trim();if(!n)return;const c=e.trim();if(!c)return;const i=o.get(n)?.get(t);i&&i.docId&&i.docId===c&&o.get(n)?.delete(t)}function m(r){const t=String(r??"").trim();if(!t)return[];const e=o.get(t);if(!e)return[];const n=["pencil","draw","office"],c=[];for(const i of n){const u=e.get(i);u&&c.push(u)}return c}function d(r){const t=String(r??"").trim();t&&o.delete(t)}export{d as clearOpenDocuments,f as closeOpenDocument,m as listOpenDocuments,s as recordOpenDocument,g as removeOpenDocument};
+

package/dist/services/orphan-monitor.d.ts

@@ -1,7 +1,15 @@
 
 
+
+
+
+
+
+
 export type OrphanEventType = 'orphan_detected' | 'orphan_cleaned' | 'process_unresponsive' | 'process_high_cpu' | 'process_high_memory' | 'health_check';
 
+
+
 export interface OrphanEvent {
     type: OrphanEventType;
     agentId: string;
@@ -11,36 +19,65 @@ export interface OrphanEvent {
     details?: Record<string, unknown>;
 }
 
+
+
 export declare class OrphanMonitor {
     private intervalId;
     private lastScanTime;
     private eventListeners;
     private stopped;
     
+
+
     start(): Promise<void>;
     
+
+
     stop(): void;
     
+
+
     scan(): Promise<void>;
     
+
+
     private handleOrphanDetected;
     
+
+
     private handleHealthIssue;
     
+
+
     private autoCleanOrphan;
     
+
+
     private cleanupDeadSessions;
     
+
+
+
     private checkAgentExistsOnServer;
     
+
+
     private reportToScheduler;
     
+
+
     onEvent(listener: (event: OrphanEvent) => void): void;
     
+
+
     offEvent(listener: (event: OrphanEvent) => void): void;
     
+
+
     private emit;
     
+
+
     getStatus(): {
         running: boolean;
         lastScanTime: Date | null;
@@ -48,8 +85,14 @@ export declare class OrphanMonitor {
     };
 }
 
+
+
 export declare function getOrphanMonitor(): OrphanMonitor;
 
+
+
 export declare function startOrphanMonitor(): Promise<void>;
 
+
+
 export declare function stopOrphanMonitor(): void;

package/dist/services/panel-auth.d.ts

@@ -1,5 +1,12 @@
 
 
+
+
+
+
+
+
+
 export declare function createSession(): string;
 
 export declare function validateSession(token: string | undefined | null): boolean;
@@ -34,11 +41,28 @@ export declare function validateCredentials(username: string, password: string):
 
 export declare function clearCredentialsCache(): void;
 
+
+
+
+
 export declare function hasConfiguredCredentials(): boolean;
 
+
+
 export declare function isDefaultCredentials(): boolean;
 
+
+
+
+
+
 export declare function setPanelCredentials(username: string, password: string): Promise<void>;
 
+
+
+
+
+
+
 export declare function migrateLegacyPanelCredentials(): Promise<boolean>;
 export {};

package/dist/services/panel-env.d.ts

@@ -1,12 +1,40 @@
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 import type { AgentMetaEnvInput } from "./mcp-env-injector.js";
 
+
+
+
 export declare function setPanelEnvVars(agentId: string | undefined, env: unknown): void;
 
 export declare function getPanelEnvVars(agentId?: string): Record<string, string>;
 
+
+
+
 export declare function setAgentMeta(agentId: string | undefined, meta: unknown): void;
 
+
+
+
 export declare function getAgentMeta(agentId?: string): AgentMetaEnvInput | undefined;
 
 export declare function clearPanelEnvVars(agentId: string | undefined): void;

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

@@ -1,19 +1,46 @@
 
+
+
+
+
+
+
+
+
+
 import type { PluginLoader } from "./plugin-loader.js";
 import type { SharedPluginEntry } from "./plugin-runtime.js";
 export declare class PluginDeploymentStore {
     private readonly rootDir;
     private readonly runtimeRootDir;
     private readonly loader;
-    constructor(rootDir: string, runtimeRootDir: string | undefined, loader: PluginLoader);
+    
+    private readonly legacyRootDir?;
+    constructor(rootDir: string, runtimeRootDir: string | undefined, loader: PluginLoader, 
+    
+    legacyRootDir?: string | undefined);
     deployedDir(): string;
     deployedManifestFile(): string;
     
+    private legacyDeployedDir;
+    private legacyDeployedManifestFile;
+    
+
+
+
+
     deployedPluginDir(name: string): string;
     
     private legacySharedDir;
     
     deployedPluginHealthy(name: string): boolean;
+    
+    private legacyPluginHealthy;
+    
+
+
+
+    resolveDeployedSourceDir(name: string): string | null;
     readSharedManifest(): SharedPluginEntry[];
     writeSharedManifest(entries: SharedPluginEntry[]): void;
     
@@ -21,12 +48,18 @@ export declare class PluginDeploymentStore {
     
     deployPluginZipToPersistentDir(zipBuffer: Buffer, expectedName?: string): Promise<SharedPluginEntry | null>;
     
+
+
+
     replaceDeployedDir(pluginName: string, sourceDir: string): void;
     
     removeDeployedDir(pluginName: string): void;
     
     updateSharedManifest(mutator: (entries: SharedPluginEntry[]) => SharedPluginEntry[]): Promise<void>;
     
+
+
+
     runtimeDirFor(agentId: string): string;
     runtimeLinkPath(agentId: string, name: string): string;