aws-runtime-bridge 1.9.172 → 1.9.179

package/dist/services/bridge-package-publish-hooks.d.ts

@@ -1,4 +1,9 @@
 
+
+
+
+
+
 import axios from "axios";
 import { type Logger } from "../utils/logger.js";
 export interface BridgePackageInfo {
@@ -23,11 +28,20 @@ interface NotifyOptions {
     post?: typeof axios.post;
 }
 
+
+
 export declare function readBridgePackageInfo(): Promise<BridgePackageInfo>;
 
+
+
 export declare function createBridgePackagePublishPayload(packageInfo: BridgePackageInfo, env?: NodeJS.ProcessEnv, now?: () => Date): BridgePackagePublishPayload;
 
+
+
 export declare function createBridgePublishSignature(body: string, secret: string): string;
 
+
+
+
 export declare function notifyBridgePackagePublished(options?: NotifyOptions): Promise<boolean>;
 export {};

package/dist/services/bridge-pairing.d.ts

@@ -0,0 +1,82 @@
+
+
+
+
+
+
+
+
+
+
+
+
+export interface PairBridgeOptions {
+    
+    ticket: string;
+    
+    serverUrl?: string;
+    
+    instanceId?: string;
+    
+    targetIdentity?: string;
+    
+    instanceName?: string;
+    
+    registerAddr?: string;
+    
+    configPath?: string;
+    
+    postPair?: (url: string, body: Record<string, unknown>) => Promise<PairApiResponse>;
+}
+export interface PairApiResponse {
+    success: boolean;
+    message?: string;
+    instanceId?: string;
+    machineToken?: string;
+    connectionKey?: string;
+    serverUrl?: string;
+    instanceName?: string;
+    credentialType?: string;
+    tenantId?: string;
+    userId?: string;
+}
+export interface PairBridgeResult {
+    success: boolean;
+    instanceId?: string;
+    serverUrl?: string;
+    error?: string;
+}
+interface ResolvedTarget {
+    
+    index: number;
+    target: Record<string, unknown>;
+    serverUrl: string;
+    tunnel: boolean;
+    instanceId?: string;
+    
+    connectionKey: string;
+    instanceName: string;
+    runtimeBridgeBaseUrl: string;
+    
+    isNewTarget: boolean;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function resolvePairTarget(config: Record<string, unknown>, options: Pick<PairBridgeOptions, "serverUrl" | "instanceName" | "registerAddr" | "instanceId" | "targetIdentity">): ResolvedTarget;
+
+
+
+
+
+export declare function pairBridge(options: PairBridgeOptions): Promise<PairBridgeResult>;
+export {};

package/dist/services/bridge-pairing.js

@@ -0,0 +1,2 @@
+import{randomBytes as N}from"node:crypto";import{existsSync as $,mkdirSync as B,readFileSync as x,writeFileSync as E}from"node:fs";import K from"node:os";import R from"node:path";import A from"axios";import{getActiveBridgeHttpPort as P,getAutoRegisterConfigFilePath as k,schedulerBaseUrl as b}from"../config.js";import{runExclusiveConfigWrite as C}from"../utils/config-write-queue.js";import{logger as F}from"../utils/logger.js";import{normalizeTargetServerUrl as I}from"../utils/target-identity.js";const q="awsp_";function S(t){if(!$(t))return{};try{return JSON.parse(x(t,"utf-8"))}catch(s){throw new Error(`\u65E0\u6CD5\u89E3\u6790\u914D\u7F6E\u6587\u4EF6 ${t}: ${s.message}`)}}function w(t){return Array.isArray(t.autoRegisterTargets)?t.autoRegisterTargets.filter(s=>!!(s&&typeof s=="object"&&!Array.isArray(s))):[]}function O(){return`bridge-${N(6).toString("hex")}`}function _(t,s){return/^https?:\/\//i.test(t)?t:/:[0-9]+$/.test(t)?`http://${t}`:`http://${t}:${s}`}function j(t,s){const o=w(t),h=s.serverUrl?.trim(),e=h?I(h):"",m=String(s.instanceId||"").trim(),v=String(s.targetIdentity||"").trim();let n=-1,c=t,d=!1;if(o.length>0){const g=o.map((a,T)=>({item:a,itemIndex:T})).filter(({item:a})=>!e||I(a.serverUrl||a.schedulerBaseUrl)===e);let u=g;if(m){const a=g.filter(({item:T})=>String(T.instanceId||"").trim()===m);if(a.length>1)throw new Error(`\u5339\u914D\u5230\u591A\u4E2A instanceId=${m} \u7684\u914D\u5BF9\u76EE\u6807\uFF0C\u8BF7\u68C0\u67E5 config.json`);a.length===1?u=a:(u=[],d=!0)}else if(v){if(u=g.filter(({item:a})=>String(a.credentialId||a.userKey||"").trim()===v),u.length>1)throw new Error("\u5339\u914D\u5230\u591A\u4E2A\u914D\u5BF9\u76EE\u6807\uFF0C\u8BF7\u7528 --instance-id \u6216 --target-identity \u7CBE\u786E\u6307\u5B9A");if(u.length===0)throw new Error("\u6307\u5B9A targetIdentity \u7684\u914D\u5BF9\u76EE\u6807\u4E0D\u5B58\u5728")}else if(g.length>1)throw new Error("\u5B58\u5728\u591A\u4E2A\u6CE8\u518C\u76EE\u6807\uFF0C\u8BF7\u7528 --server-url \u642D\u914D --instance-id / --target-identity \u6307\u5B9A\u672C\u6B21\u914D\u5BF9\u76EE\u6807");if(d)n=o.length;else if(n=u[0]?.itemIndex??-1,n<0){if(!e)throw new Error("\u65E0\u6CD5\u786E\u5B9A\u914D\u5BF9\u76EE\u6807\uFF0C\u8BF7\u7528 --server-url \u6307\u5B9A");c={serverUrl:h},n=o.length,d=!0}else c=o[n]||{}}const y=I(h||c.serverUrl||c.schedulerBaseUrl||b);if(!y)throw new Error("\u65E0\u6CD5\u786E\u5B9A\u8C03\u5EA6\u4E2D\u5FC3\u5730\u5740\uFF0C\u8BF7\u7528 --server-url \u6307\u5B9A");const i=s.registerAddr||String(c.registerAddr||c.registerIp||c.virtualIp||"").trim(),l=c.tunnel===!0?!0:c.tunnel===!1?!1:!i;let r=m||String(c.instanceId||"").trim()||void 0,f;if(l){r||(r=O());const g=new URL(y);f=`${g.protocol}//${g.host}/tunnel/${r}`}else f=_(i,P());const p=String(c.connectionKey||"").trim(),U=s.instanceName?.trim()||String(c.instanceName||"").trim()||K.hostname();return{index:n,target:c,serverUrl:y,tunnel:l,instanceId:r,connectionKey:p,instanceName:U,runtimeBridgeBaseUrl:f,isNewTarget:d}}async function M(t,s){return(await A.post(t,s,{headers:{"Content-Type":"application/json"},timeout:15e3})).data}async function V(t){const s=String(t.ticket||"").trim();if(!s.startsWith(q))return{success:!1,error:"\u914D\u5BF9\u7968\u636E\u683C\u5F0F\u4E0D\u6B63\u786E\uFF08\u5E94\u4EE5 awsp_ \u5F00\u5934\uFF09\uFF0C\u8BF7\u4ECE\u7BA1\u7406\u9875\u91CD\u65B0\u590D\u5236"};const o=t.configPath||k(),h=S(o);let e;try{e=j(h,t)}catch(i){return{success:!1,error:i.message}}const m={pairingTicket:s,instanceName:e.instanceName,runtimeBridgeBaseUrl:e.runtimeBridgeBaseUrl};e.instanceId&&(m.instanceId=e.instanceId);const v=t.postPair||M;let n;try{n=await v(`${e.serverUrl}/api/instances/pair`,m)}catch(i){const l=i;return{success:!1,error:l.response?.data?.message||l.message||"\u914D\u5BF9\u8BF7\u6C42\u5931\u8D25"}}if(!n?.success||!n.machineToken||!n.instanceId)return{success:!1,error:n?.message||"\u8C03\u5EA6\u4E2D\u5FC3\u672A\u8FD4\u56DE\u673A\u5668\u51ED\u636E"};const c=String(n.connectionKey||"").trim();if(!c)return{success:!1,error:"\u8C03\u5EA6\u4E2D\u5FC3\u672A\u8FD4\u56DE\u8FDE\u63A5\u5BC6\u94A5\uFF08server \u7248\u672C\u8FC7\u65E7\uFF1F\uFF09\uFF0C\u8BF7\u5347\u7EA7 server \u540E\u91CD\u8BD5"};const d=n.instanceId,y=n.instanceName||e.instanceName;try{await C(o,()=>{const i=S(o),l=w(i);let r;if(Array.isArray(i.autoRegisterTargets)&&l.length>0){const f=l.filter(a=>I(a.serverUrl||a.schedulerBaseUrl)===I(e.serverUrl)),p=String(e.target.userKey||"").trim(),U=e.instanceId?f.filter(a=>String(a.instanceId||"").trim()===e.instanceId):[],g=p?f.filter(a=>String(a.userKey||"").trim()===p):[];if(U.length>1||g.length>1)throw new Error(`\u914D\u5BF9\u5199\u56DE\u5931\u8D25\uFF1A\u5339\u914D\u5230\u591A\u4E2A\u76EE\u6807\uFF08server=${e.serverUrl}\uFF09\uFF0C\u8BF7\u7528 instanceId / target identity \u7CBE\u786E\u6307\u5B9A`);const u=U[0]||g[0]||(f.length===1&&!e.isNewTarget?f[0]:void 0);u?r=u:!e.isNewTarget&&e.index>=0&&l[e.index]?r=l[e.index]:(r={serverUrl:e.serverUrl},l.push(r),i.autoRegisterTargets=l)}else r=i;r.serverUrl=r.serverUrl||e.serverUrl,r.instanceName=r.instanceName||y,r.instanceId=d,r.credentialId=d,delete r.credentialRef,r.credentialType=n.credentialType||"MACHINE_TOKEN",r.machineToken=n.machineToken,r.connectionKey=c,n.tenantId&&(r.tenantId=n.tenantId),n.userId&&(r.userId=n.userId),Array.isArray(i.autoRegisterTargets)&&i.autoRegisterTargets.length>0&&String(i.connectionKey||"").trim()&&delete i.connectionKey,B(R.dirname(o),{recursive:!0}),E(o,JSON.stringify(i,null,2),"utf-8")})}catch(i){return{success:!1,error:i.message}}return F.info(`[Pair] \u914D\u5BF9\u6210\u529F: server=${e.serverUrl}, instanceId=${d}, machineToken \u5DF2\u5199\u5165 ${o}`),{success:!0,instanceId:d,serverUrl:e.serverUrl}}export{V as pairBridge,j as resolvePairTarget};
+

package/dist/services/bridge-temp-files.d.ts

@@ -0,0 +1,65 @@
+
+export declare const BRIDGE_TEMP_ROOT: string;
+
+
+
+
+
+
+
+export declare const BRIDGE_TEMP_MAX_BYTES: number;
+
+
+
+
+export declare function normalizeTempFileExtension(originalName: string): string;
+
+
+
+
+
+
+
+export declare function decodePossiblyLatin1Utf8FileName(rawName: string): string;
+export interface WriteBridgeTempFileParams {
+    
+    originalName: string;
+    
+    bytes: Buffer;
+    
+    mediaType?: string;
+}
+export interface BridgeTempFileResult {
+    
+    path: string;
+    
+    name: string;
+    
+    mediaType: string;
+    
+    size: number;
+}
+
+
+
+
+
+export declare function writeBridgeTempFile(params: WriteBridgeTempFileParams): Promise<BridgeTempFileResult>;
+
+
+
+
+export declare function resolveBridgeTempFilePath(rawPath: string): string | null;
+
+
+
+
+export declare function readBridgeTempFile(rawPath: string): Promise<Buffer | null>;
+
+
+
+export declare function deleteBridgeTempFile(rawPath: string): Promise<boolean>;
+
+
+
+export declare function guessTempFileMediaType(filePath: string): string;

package/dist/services/bridge-temp-files.js

@@ -0,0 +1,2 @@
+import{randomUUID as m}from"node:crypto";import{promises as a}from"node:fs";import f from"node:os";import n from"node:path";import{createLogger as d}from"../utils/logger.js";const s=d("bridge-temp-files"),p=n.join(f.tmpdir(),"aw-temp","ATT"),u=7,F=Number.POSITIVE_INFINITY;function g(r=new Date){const e=r.getFullYear(),t=String(r.getMonth()+1).padStart(2,"0"),i=String(r.getDate()).padStart(2,"0");return n.join(p,`${e}${t}${i}`)}async function x(){const r=Date.now()-u*24*60*60*1e3;try{const e=await a.readdir(p,{withFileTypes:!0});for(const t of e){if(!t.isDirectory())continue;const i=n.join(p,t.name);try{(await a.stat(i)).mtimeMs<r&&(await a.rm(i,{recursive:!0,force:!0}),s.info(`[bridge-temp-files] removed expired temp dir: ${i}`))}catch{}}}catch(e){const t=e;t.code!=="ENOENT"&&s.warn("[bridge-temp-files] cleanup expired dirs failed:",t)}}function w(r){const e=n.basename(c(r).replace(/\\/g,"/")),t=e.lastIndexOf(".");if(t<=0||t===e.length-1)return"";const o=e.slice(t+1).toLowerCase().replace(/[^a-z0-9]/g,"");return!o||o.length>16?"":`.${o}`}function c(r){const e=String(r||"");if(!/[\u00c0-\u00ff]/.test(e))return e;const t=Buffer.from(e,"latin1").toString("utf8");return!t||t.includes("\uFFFD")?e:t}async function b(r){const e=r.bytes;if(!e||e.length===0)throw new Error("file content is empty");const t=c(r.originalName),i=g();await a.mkdir(i,{recursive:!0});const o=n.join(i,`${m()}${w(t)}`);return await a.writeFile(o,e),x(),s.info(`[bridge-temp-files] wrote temp file: name=${t} path=${o} size=${e.length}`),{path:o.replace(/\\/g,"/"),name:t,mediaType:r.mediaType||"application/octet-stream",size:e.length}}function l(r){const e=String(r||"").trim();if(!e)return null;const t=n.resolve(e),i=n.resolve(p);return t!==i&&!t.startsWith(i+n.sep)?null:t}async function N(r){const e=l(r);if(!e)return null;try{return(await a.stat(e)).isFile()?await a.readFile(e):null}catch(t){const i=t;return i.code!=="ENOENT"&&s.warn("[bridge-temp-files] read temp file failed:",i),null}}async function D(r){const e=l(r);if(!e)return!1;try{return await a.rm(e,{force:!0}),!0}catch(t){return s.warn("[bridge-temp-files] delete temp file failed:",t),!1}}function I(r){const e=n.extname(r).toLowerCase();return{".txt":"text/plain",".md":"text/markdown",".json":"application/json",".csv":"text/csv",".xml":"application/xml",".html":"text/html",".pdf":"application/pdf",".png":"image/png",".jpg":"image/jpeg",".jpeg":"image/jpeg",".gif":"image/gif",".webp":"image/webp",".svg":"image/svg+xml",".zip":"application/zip",".gz":"application/gzip",".tar":"application/x-tar",".doc":"application/msword",".docx":"application/vnd.openxmlformats-officedocument.wordprocessingml.document",".xls":"application/vnd.ms-excel",".xlsx":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",".ppt":"application/vnd.ms-powerpoint",".pptx":"application/vnd.openxmlformats-officedocument.presentationml.presentation"}[e]||"application/octet-stream"}export{F as BRIDGE_TEMP_MAX_BYTES,p as BRIDGE_TEMP_ROOT,c as decodePossiblyLatin1Utf8FileName,D as deleteBridgeTempFile,I as guessTempFileMediaType,w as normalizeTempFileExtension,N as readBridgeTempFile,l as resolveBridgeTempFilePath,b as writeBridgeTempFile};
+

package/dist/services/browser-session-manager.d.ts

@@ -1,4 +1,15 @@
 
+
+
+
+
+
+
+
+
+
+
+
 import { type BrowserPool } from "../browser/browser-pool.js";
 import { createBuiltInBrowserTools } from "../browser/built-in-browser-tools.js";
 import type { AddListenerParams, UpdateListenerParams } from "../browser/page-listener-manager.js";
@@ -13,28 +24,65 @@ interface BrowserSessionManagerState {
     wsHost: string;
 }
 
+
+
+
+
+
 export declare function startBrowserSessionManager(poolConfig?: Partial<BrowserPoolConfig>, wsConfig?: Partial<WsServerConfig>): Promise<BrowserSessionManagerState>;
 
+
+
+
+
+
+
 export declare function getBrowserWsUrl(agentId: string, browserId?: string): string | null;
 
+
+
+
 export declare function listBrowserWsUrls(agentId: string): Array<{
     browserId: string;
     title: string;
     wsUrl: string;
 }>;
 
+
+
+
 export declare function getBrowserWsPort(): number | null;
 
+
+
+
+
+
+
+
+
+
+
 export declare function getBrowserTools(agentId: string | undefined, scopeKey?: string, ssrfConfig?: SsrfConfig): Promise<ReturnType<typeof createBuiltInBrowserTools>>;
 
+
+
+
 export declare function closeBrowserSession(agentId: string): Promise<void>;
 
+
+
 export declare function closeBrowserSessionById(agentId: string, browserId?: string): Promise<void>;
 
+
+
 export declare function disposeBrowserSessionManager(): Promise<void>;
 
 export declare function isBrowserSessionManagerStarted(): boolean;
 
+
+
+
 export declare function addBrowserListener(agentId: string, browserId: string, params: AddListenerParams): Promise<PageListener>;
 
 export declare function updateBrowserListener(agentId: string, browserId: string, listenerId: ListenerId, params: Omit<UpdateListenerParams, "listenerId">): Promise<PageListener | undefined>;
@@ -45,11 +93,34 @@ export declare function toggleBrowserListener(agentId: string, browserId: string
 
 export declare function listBrowserListeners(agentId: string, browserId: string): Promise<PageListenerInfo[]>;
 
+
+
+
+
 export declare function collectAgentListenerEvents(agentId: string): Promise<ListenerTriggerEvent[]>;
 
 export declare function registerListenerWakeHook(agentId: string | undefined, fn: () => void): void;
 
+
+
+
+
 export declare function unregisterListenerWakeHook(agentId: string | undefined, fn?: () => void): void;
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 export declare function buildListenerInjectionPrompt(events: ListenerTriggerEvent[]): string;
 export {};

package/dist/services/capability-config.d.ts

@@ -1,29 +1,74 @@
-export type CapabilityType = "skills" | "mcp" | "plugins";
+import { type CapabilityType, type UserScope } from "./user-scope.js";
+export type { CapabilityType } from "./user-scope.js";
 export declare const CAPABILITY_TYPES: readonly CapabilityType[];
-export declare function setDeployedDefaultsProvider(type: CapabilityType, provider: (() => Record<string, boolean>) | null): void;
+export declare function setDeployedDefaultsProvider(type: CapabilityType, provider: ((scope: UserScope | null) => Record<string, boolean>) | null): void;
 
-export declare function getDefaults(type: CapabilityType): Record<string, boolean>;
 
-export declare function getOverrides(agentId: string, type: CapabilityType): Record<string, boolean>;
 
-export declare function getInherited(agentId: string, type: CapabilityType): Record<string, boolean>;
 
-export declare function getEffective(agentId: string, type: CapabilityType, name: string, fallback?: boolean): boolean;
+export declare function getDefaults(scope: UserScope | null, type: CapabilityType): Record<string, boolean>;
 
-export declare function getEffectiveSource(agentId: string, type: CapabilityType, name: string): "agent" | "inherited" | "bridge" | "deployed" | "default";
 
-export declare function setDefault(type: CapabilityType, name: string, value: boolean | null): boolean;
 
-export declare function setOverride(agentId: string, type: CapabilityType, name: string, value: boolean | null): boolean;
 
-export declare function setInherited(agentId: string, type: CapabilityType, map: Record<string, boolean> | null): boolean;
+export declare function getOverrides(scope: UserScope | null, agentId: string, type: CapabilityType): Record<string, boolean>;
 
-export declare function listOverrideAgents(type: CapabilityType): string[];
 
-export declare function reconcileDefaultsFromDeployed(type: CapabilityType): number;
 
-export declare function hasAnyDefault(type: CapabilityType): boolean;
 
-export declare function getEffectiveMap(agentId: string, type: CapabilityType, names: Iterable<string>): Record<string, boolean>;
+export declare function getInherited(scope: UserScope | null, agentId: string, type: CapabilityType): Record<string, boolean>;
 
-export declare function setInheritedMap(agentId: string, byType: Partial<Record<CapabilityType, Record<string, boolean>>> | null): CapabilityType[];
+
+
+
+
+
+
+
+export declare function getEffective(scope: UserScope | null, agentId: string, type: CapabilityType, name: string, fallback?: boolean): boolean;
+
+export declare function getEffectiveSource(scope: UserScope | null, agentId: string, type: CapabilityType, name: string): "agent" | "inherited" | "bridge" | "deployed" | "default";
+
+
+
+
+export declare function setDefault(scope: UserScope, type: CapabilityType, name: string, value: boolean | null): boolean;
+
+
+
+
+
+export declare function setOverride(scope: UserScope, agentId: string, type: CapabilityType, name: string, value: boolean | null): boolean;
+
+
+
+
+
+
+export declare function setInherited(scope: UserScope, agentId: string, type: CapabilityType, map: Record<string, boolean> | null): boolean;
+
+
+
+export declare function listOverrideAgents(scope: UserScope | null, type: CapabilityType): string[];
+
+
+
+
+
+
+
+export declare function reconcileDefaultsFromDeployed(scope: UserScope, type: CapabilityType): number;
+
+
+
+
+
+export declare function hasAnyDefault(scope: UserScope | null, type: CapabilityType): boolean;
+
+export declare function getEffectiveMap(scope: UserScope | null, agentId: string, type: CapabilityType, names: Iterable<string>): Record<string, boolean>;
+
+
+
+
+
+export declare function setInheritedMap(scope: UserScope, agentId: string, byType: Partial<Record<CapabilityType, Record<string, boolean>>> | null): CapabilityType[];

package/dist/services/capability-config.js

@@ -1,3 +1,3 @@
-import{existsSync as y,readFileSync as j,readdirSync as F}from"node:fs";import A from"node:path";import{getBridgeTemplateMcpDir as M,getBridgeTemplatePluginsDir as k,getBridgeTemplateSkillsDir as E}from"../config.js";import{atomicWriteFileSync as T,sanitizeAgentId as B}from"../utils/file-utils.js";const x=["skills","mcp","plugins"];function O(e){switch(e){case"skills":return E();case"mcp":return M();case"plugins":return k();default:throw new Error(`\u672A\u77E5\u80FD\u529B\u7C7B\u578B: ${String(e)}`)}}const a=new Map;function C(e,r){r?a.set(e,r):a.delete(e)}function S(e,r){const t=a.get(e);if(t)try{return t()[r]}catch{return}}function v(e){try{if(!y(e))return{};const r=JSON.parse(j(e,"utf8"));return!r||typeof r!="object"||Array.isArray(r)?{}:r}catch{return{}}}function m(e,r){T(e,`${JSON.stringify(r,null,2)}
-`)}function c(e,r){const t=r[e];if(!t||typeof t!="object"||Array.isArray(t))return{};const n={};for(const[i,o]of Object.entries(t))i.trim()&&typeof o=="boolean"&&(n[i.trim()]=o);return n}function L(e,r,t,n){const i={...c(r,e)};n==null?delete i[t]:i[t]=n,e[r]=i}function D(e){try{if(!y(e))return{};const r=JSON.parse(j(e,"utf8"));return!r||typeof r!="object"||Array.isArray(r)?{}:r}catch{return{}}}function d(e,r,t){const n=D(e),i=n[t];return i&&typeof i=="object"&&!Array.isArray(i)?c(r,i):t==="overrides"?c(r,n):{}}function b(e,r,t,n){const i=D(e),o={};for(const f of["overrides","inherited"]){const s=f===t?n:d(e,r,f),h={};for(const u of x){const l=u===r?s:d(e,u,f);h[u]=l}o[f]=h}m(e,o)}function w(e){return A.join(O(e),"config.json")}function p(e,r){return A.join(O(e),"agents",`${B(r)}.json`)}function g(e){return c(e,v(w(e)))}function J(e,r){return e?d(p(r,e),r,"overrides"):{}}function N(e,r){return e?d(p(r,e),r,"inherited"):{}}function P(e,r,t,n){const o=J(e,r)[t];if(o!==void 0)return o;const s=N(e,r)[t];if(s!==void 0)return s;const u=g(r)[t];if(u!==void 0)return u;if(n!==void 0)return n;const l=S(r,t);return l!==void 0?l:!1}function _(e,r,t){return J(e,r)[t]!==void 0?"agent":N(e,r)[t]!==void 0?"inherited":g(r)[t]!==void 0?"bridge":S(r,t)!==void 0?"deployed":"default"}function V(e,r,t){const n=w(e),i=v(n),o=c(e,i);L(i,e,r,t);const f=c(e,i);return JSON.stringify(o)===JSON.stringify(f)?!1:(m(n,i),!0)}function q(e,r,t,n){if(!e)return!1;const i=p(r,e),o=d(i,r,"overrides"),f={...o};return n==null?delete f[t]:f[t]=n,JSON.stringify(o)===JSON.stringify(f)?!1:(b(i,r,"overrides",f),!0)}function W(e,r,t){if(!e)return!1;const n=p(r,e),i=d(n,r,"inherited"),o={};if(t&&typeof t=="object"&&!Array.isArray(t))for(const[f,s]of Object.entries(t))f.trim()&&typeof s=="boolean"&&(o[f.trim()]=s);return JSON.stringify(i)===JSON.stringify(o)?!1:(b(n,r,"inherited",o),!0)}function G(e){const r=A.join(O(e),"agents");try{return y(r)?F(r).filter(t=>t.endsWith(".json")&&!t.startsWith(".")).map(t=>t.slice(0,-5)):[]}catch{return[]}}function H(e){const r=a.get(e);if(!r)return 0;let t=0;const n=g(e),i=r()??{};for(const o of Object.keys(i))o in n||i[o]===!0&&(V(e,o,!1),t++);return t}function K(e){return Object.keys(g(e)).length>0}function Q(e,r,t){const n={};for(const i of t)n[i]=P(e,r,i);return n}function U(e,r){const t=[];if(!e)return t;for(const n of x){const i=r&&typeof r=="object"?r[n]??{}:{};W(e,n,i)&&t.push(n)}return t}export{x as CAPABILITY_TYPES,g as getDefaults,P as getEffective,Q as getEffectiveMap,_ as getEffectiveSource,N as getInherited,J as getOverrides,K as hasAnyDefault,G as listOverrideAgents,H as reconcileDefaultsFromDeployed,V as setDefault,C as setDeployedDefaultsProvider,W as setInherited,U as setInheritedMap,q as setOverride};
+import{existsSync as A,readFileSync as x,readdirSync as B}from"node:fs";import h from"node:path";import{getBridgeTemplateMcpDir as P,getBridgeTemplatePluginsDir as W,getBridgeTemplateSkillsDir as C}from"../config.js";import{atomicWriteFileSync as $,sanitizeAgentId as z}from"../utils/file-utils.js";import{getAgentOwner as F}from"./agent-ownership.js";import{getUserCapabilityAgentFile as R,getUserCapabilityDefaultsFile as U,isLegacyFallbackDisabled as v,scopeEquals as Y}from"./user-scope.js";const J=["skills","mcp","plugins"];function a(r,e){if(e){const t=F(e);if(t)return t}return r}function N(r,e){if(!e)return;const t=F(e);if(t&&!Y(t,r))throw new Error("agent-ownership-mismatch")}function j(r){switch(r){case"skills":return C();case"mcp":return P();case"plugins":return W();default:throw new Error(`\u672A\u77E5\u80FD\u529B\u7C7B\u578B: ${String(r)}`)}}function k(r){return h.join(j(r),"config.json")}function O(r,e){return h.join(j(r),"agents",`${z(e)}.json`)}function E(r,e){return U(r,e)}function g(r,e,t){return R(r,e,t)}const y=new Map;function ie(r,e){e?y.set(r,e):y.delete(r)}function S(r,e,t){const n=y.get(r);if(n)try{return n(t)[e]}catch{return}}function b(r){try{if(!A(r))return{};const e=JSON.parse(x(r,"utf8"));return!e||typeof e!="object"||Array.isArray(e)?{}:e}catch{return{}}}function M(r,e){$(r,`${JSON.stringify(e,null,2)}
+`)}function l(r,e){const t=e[r];if(!t||typeof t!="object"||Array.isArray(t))return{};const n={};for(const[i,o]of Object.entries(t))i.trim()&&typeof o=="boolean"&&(n[i.trim()]=o);return n}function _(r,e,t,n){const i={...l(e,r)};n==null?delete i[t]:i[t]=n,r[e]=i}function q(r){try{if(!A(r))return{};const e=JSON.parse(x(r,"utf8"));return!e||typeof e!="object"||Array.isArray(e)?{}:e}catch{return{}}}function c(r,e,t){const n=q(r),i=n[t];return i&&typeof i=="object"&&!Array.isArray(i)?l(e,i):t==="overrides"?l(e,n):{}}function T(r,e,t,n){const i={};for(const o of["overrides","inherited"]){const s=o===t?n:c(r,e,o),f={};for(const u of J){const d=u===e?s:c(r,u,o);f[u]=d}i[o]=f}M(r,i)}function p(r,e){const t={};return r?(Object.assign(t,l(e,b(E(r,e)))),t):(v()||Object.assign(t,l(e,b(k(e)))),t)}function L(r,e,t){if(!e)return{};const n=a(r,e);return n?c(g(n,t,e),t,"overrides"):v()?{}:c(O(t,e),t,"overrides")}function V(r,e,t){if(!e)return{};const n=a(r,e);return n?c(g(n,t,e),t,"inherited"):v()?{}:c(O(t,e),t,"inherited")}function G(r,e,t,n,i){const o=a(r,e),f=L(o,e,t)[n];if(f!==void 0)return f;const d=V(o,e,t)[n];if(d!==void 0)return d;const D=p(o,t)[n];if(D!==void 0)return D;if(i!==void 0)return i;const m=S(t,n,o);if(m!==void 0)return m;if(o&&!v()){const w=H(e,t,n);if(w!==void 0)return w}return!1}function H(r,e,t){if(r){const i=c(O(e,r),e,"overrides")[t];if(i!==void 0)return i;const o=c(O(e,r),e,"inherited")[t];if(o!==void 0)return o}const n=l(e,b(k(e)))[t];return n!==void 0?n:S(e,t,null)}function oe(r,e,t,n){const i=a(r,e);return L(i,e,t)[n]!==void 0?"agent":V(i,e,t)[n]!==void 0?"inherited":p(i,t)[n]!==void 0?"bridge":S(t,n,i)!==void 0?"deployed":"default"}function K(r,e,t,n){const i=E(r,e),o=b(i),s=l(e,o);_(o,e,t,n);const f=l(e,o);return JSON.stringify(s)===JSON.stringify(f)?!1:(M(i,o),!0)}function fe(r,e,t,n,i){if(!e)return!1;N(r,e);const o=a(r,e)??r,s=g(o,t,e),f=c(s,t,"overrides"),u={...f};return i==null?delete u[n]:u[n]=i,JSON.stringify(f)===JSON.stringify(u)?!1:(T(s,t,"overrides",u),!0)}function Q(r,e,t,n){if(!e)return!1;N(r,e);const i=a(r,e)??r,o=g(i,t,e),s=c(o,t,"inherited"),f={};if(n&&typeof n=="object"&&!Array.isArray(n))for(const[u,d]of Object.entries(n))u.trim()&&typeof d=="boolean"&&(f[u.trim()]=d);return JSON.stringify(s)===JSON.stringify(f)?!1:(T(o,t,"inherited",f),!0)}function se(r,e){const t=r?h.dirname(g(r,e,"_probe")):h.join(j(e),"agents");try{return A(t)?B(t).filter(n=>n.endsWith(".json")&&!n.startsWith(".")).map(n=>n.slice(0,-5)):[]}catch{return[]}}function ue(r,e){const t=y.get(e);if(!t)return 0;let n=0;const i=p(r,e),o=t(r)??{};for(const s of Object.keys(o))s in i||o[s]===!0&&(K(r,e,s,!1),n++);return n}function ce(r,e){return Object.keys(p(r,e)).length>0}function le(r,e,t,n){const i={};for(const o of n)i[o]=G(r,e,t,o);return i}function de(r,e,t){const n=[];if(!e)return n;for(const i of J){const o=t&&typeof t=="object"?t[i]??{}:{};Q(r,e,i,o)&&n.push(i)}return n}export{J as CAPABILITY_TYPES,p as getDefaults,G as getEffective,le as getEffectiveMap,oe as getEffectiveSource,V as getInherited,L as getOverrides,ce as hasAnyDefault,se as listOverrideAgents,ue as reconcileDefaultsFromDeployed,K as setDefault,ie as setDeployedDefaultsProvider,Q as setInherited,de as setInheritedMap,fe as setOverride};
 

package/dist/services/change-cache-retention.d.ts

@@ -1,5 +1,14 @@
 
 
+
+
+
+
+
+
+
+
+
 export declare function setChangeCacheRetentionDays(days: unknown): void;
 
 export declare function getChangeCacheRetentionDays(): number | null;

package/dist/services/changelog.d.ts

@@ -1,8 +1,17 @@
 
+
+
+
+
+
 export declare function readChangelog(version: string): Promise<{
     found: boolean;
     content: string;
     path: string;
 }>;
 
+
+
+
+
 export declare function appendChangelogSection(version: string, body: string): Promise<void>;

package/dist/services/cli-commands.d.ts

@@ -1,3 +1,4 @@
+import { type PairBridgeOptions, type PairBridgeResult } from "./bridge-pairing.js";
 import type { StartupConfigWizardResult } from "./startup-config-wizard.js";
 import { type WindowsServiceManager } from "./windows-service-manager.js";
 export interface CliCommandResult {
@@ -29,6 +30,9 @@ export interface CliCommandOptions {
     
     launchdLogPath?: string;
     
+
+
+
     launchdDomainTarget?: string;
     
     findRunningBridgeProcesses?: (platform: NodeJS.Platform) => number[];
@@ -37,32 +41,110 @@ export interface CliCommandOptions {
     
     prompt?: (question: string) => Promise<string>;
     
+
+
+
+
     globalModulePath?: () => string | null;
     
+
+
+
+
     queryWindowsServiceState?: (serviceName: string) => string | null;
     
+    pair?: (options: PairBridgeOptions) => Promise<PairBridgeResult>;
+    
+
+
+
+
     assumeYes?: boolean;
     
+
+
+
+
+
     skipKill?: boolean;
 }
 export declare function readPackageVersion(packageRoot?: string): string;
 
+
+
 export declare function createSystemdUnitContent(executablePath: string): string;
 
+
+
+
+
+
+
+
+
+
+
+
+
 export declare function createLaunchdPlistContent(executablePath: string, options?: {
     userHomeDir?: string;
     logPath?: string;
 }): string;
 
+
+
+
+
+
+
+
+
+
+
+
+
+
 export declare function defaultFindRunningBridgeProcesses(platform: NodeJS.Platform): number[];
 
+
+
+
+
+
+
+
+
+
 export declare function defaultKillBridgeProcess(pid: number, platform: NodeJS.Platform, waitTimeoutMs?: number, waitIntervalMs?: number): void;
 
+
+
+
+
 export declare function defaultProcessIsGone(pid: number, platform: NodeJS.Platform): boolean;
 
+
+
+
+
+
+
+
 export declare function waitForProcessGone(isProcessGone: (pid: number, platform: NodeJS.Platform) => boolean, pid: number, platform: NodeJS.Platform, timeoutMs?: number, intervalMs?: number): boolean;
 
+
+
+
+
 export declare function removeDirWithRetry(targetDir: string, retries?: number, baseDelayMs?: number): void;
 
+
+
+
+
+
+
+
+
 export declare function removeUpdateFseventsResidue(globalRoot: string): void;
 export declare function handleCliCommand(options?: CliCommandOptions): Promise<CliCommandResult>;