aws-runtime-bridge 1.9.175 → 1.9.180

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

@@ -1,4 +1,14 @@
 
+
+
+
+
+
+
+
+
+
+
 import type { OpenDocKind } from "./open-doc-registry.js";
 
 export type OpenDocEvent = {
@@ -16,6 +26,18 @@ export type OpenDocEvent = {
     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-registry.d.ts

@@ -1,5 +1,27 @@
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 export type OpenDocKind = "pencil" | "draw" | "office";
 
 export interface OpenDocEntry {
@@ -13,10 +35,23 @@ export interface OpenDocEntry {
     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[];

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;
     

package/dist/services/plugin-deployment.js

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

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

@@ -1,4 +1,15 @@
 
+
+
+
+
+
+
+
+
+
+
+
 export type PluginEventPriority = "urgent" | "normal" | "low";
 
 export interface PluginEventMessage {
@@ -39,11 +50,21 @@ export declare class PluginEventBuffer {
     constructor(agentId: string);
     get currentRevision(): number;
     
+
+
+
     push(record: PluginEventRecord): boolean;
     
+
+
+
     drain(opts?: PluginEventDrainOptions): PluginEventDrainResult;
     
     private dropOldestLowestPriority;
     
+
+
+
+
     private pruneDedup;
 }

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

@@ -1,5 +1,16 @@
 
 
+
+
+
+
+
+
 export declare function rmWithRetry(dir: string, attempts?: number, delayMs?: number): Promise<void>;
 
+
+
+
+
+
 export declare function movePluginDir(sourceDir: string, targetDir: string): Promise<void>;

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

@@ -1,7 +1,20 @@
 
+
+
+
+
+
+
+
+
+
+
 import type { PluginInvokeContext, PluginToolInvocationResult, JsonObject } from "@agentswork/acode";
 import type { PluginToolDef } from "./plugin-manifest.js";
 import type { LoadedPlugin } from "./plugin-runtime.js";
 export declare function executeHandler(agentId: string, plugin: LoadedPlugin, tool: PluginToolDef, params: JsonObject, ctx?: PluginInvokeContext): Promise<PluginToolInvocationResult>;
 
+
+
+
 export declare function buildPluginEnv(plugin: LoadedPlugin, agentId: string): NodeJS.ProcessEnv;