aws-runtime-bridge 1.9.175 → 1.9.180

package/dist/browser/types.d.ts

@@ -1,4 +1,13 @@
 
+
+
+
+
+
+
+
+
+
 import type { Browser, BrowserContext, Page } from "playwright";
 import type { PageListenerManager } from "./page-listener-manager.js";
 import type { ScreencastManager } from "./screencast-manager.js";
@@ -41,6 +50,9 @@ export interface SessionBrowser {
     
     browserId: string;
     
+
+
+
     title: string;
     
     browser: Browser;
@@ -59,17 +71,36 @@ export interface SessionBrowser {
     
     lastActivityAt: number;
     
+
+
+
     humanTakeover: boolean;
     
+
+
+
     takeoverClientId?: string;
     
+
+
+
     qualityPreset: QualityPreset;
     
+
+
+
+
     listenerManager: PageListenerManager;
     
+
+
+
     autoSaveTimer?: ReturnType<typeof setInterval>;
 }
 
+
+
+
 export declare function makeBrowserKey(agentId: string, browserId: string): string;
 
 export declare function parseBrowserKey(key: string): {
@@ -105,6 +136,11 @@ export interface StepArchiveConfig {
 
 export interface SsrfConfig {
     
+
+
+
+
+
     allowPrivate?: boolean;
     
     blocklist?: string[];
@@ -131,6 +167,15 @@ export interface BrowserPoolConfig {
     
     executablePath?: string;
     
+
+
+
+
+
+
+
+
+
     stealth?: boolean;
     
     viewportWidth?: number;
@@ -157,23 +202,66 @@ export interface BrowserPoolConfig {
     
     timezone?: string;
     
+
+
+
+
+
+
+
+
     profileDir?: string;
 }
 
 export declare const MAX_SESSIONS = 8;
 
+
+
+
+
+
 export declare const MAX_SESSIONS_PER_AGENT = 4;
 
 export declare const MAX_PAGES_PER_SESSION = 5;
 
+
+
+
+
+
+
 export declare const SESSION_TIMEOUT_MS = 0;
 
+
+
+
+
+
 export declare const IDLE_TIMEOUT_MS = 0;
 
+
+
+
+
+
 export declare const WS_PORT = 7891;
 
+
+
+
+
+
+
+
 export declare const WS_HOST = "127.0.0.1";
 
+
+
+
+
+
+
+
 export declare const WS_DEFAULT_MAX_SEND_BYTES: number;
 
 export declare const WS_DEFAULT_HEARTBEAT_MS: number;
@@ -188,6 +276,11 @@ export interface QualityPresetConfig {
     
     format: ImageFormat;
     
+
+
+
+
+
     quality: number;
     
     maxWidth: number;
@@ -195,6 +288,11 @@ export interface QualityPresetConfig {
     maxHeight: number;
 }
 
+
+
+
+
+
 export declare const QUALITY_PRESETS: Record<QualityPreset, QualityPresetConfig>;
 
 export declare function isQualityPreset(value: unknown): value is QualityPreset;
@@ -203,6 +301,8 @@ export declare const TILE_DIFF_CONFIG: {
     
     readonly tileSize: 160;
     
+
+
     readonly sampleStep: 8;
     
     readonly diffThreshold: 24;

package/dist/browser/ws-server.d.ts

@@ -1,8 +1,26 @@
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 import type { BrowserPool } from "./browser-pool.js";
 import type { PageListenerInfo } from "./page-listener-types.js";
 import { type WsServerConfig } from "./types.js";
 
+
+
+
+
 export declare class BrowserWsServer {
     private readonly pool;
     private readonly config;
@@ -19,6 +37,13 @@ export declare class BrowserWsServer {
     private lastCursor;
     constructor(pool: BrowserPool, config?: WsServerConfig);
     
+
+
+
+
+
+
+
     start(): Promise<{
         port: number;
         host: string;
@@ -30,14 +55,30 @@ export declare class BrowserWsServer {
     
     getPort(): number;
     
+
+
+
+
+
     getUrl(agentId: string, browserId?: string): string;
     private attachHandlers;
     private handleConnection;
     
+
+
     private handleInputMessage;
     
+
+
+
+
+
+
     private queryAndPushSelection;
     
+
+
+
     private queryAndPushCursor;
     
     private sendFrame;
@@ -49,8 +90,17 @@ export declare class BrowserWsServer {
     private startMainHeartbeat;
     private stopMainHeartbeat;
     
+
+
+
+
+
     broadcastListenerUpdate(agentId: string, browserId: string, listeners: PageListenerInfo[]): void;
     
+
+
+
+
     broadcastListenerTriggered(agentId: string, browserId: string, payload: {
         listenerId: string;
         selector: string;
@@ -62,6 +112,10 @@ export declare class BrowserWsServer {
     }): void;
 }
 
+
+
+
+
 export declare function getBrowserWsServer(pool: BrowserPool, config?: WsServerConfig): Promise<BrowserWsServer>;
 
 export declare function stopBrowserWsServer(): Promise<void>;

package/dist/config.d.ts

@@ -1,15 +1,55 @@
 
 
+
+
+
+
+
+
+
+
+
 export declare function isDevMode(): boolean;
 
+
+
+
+
+
+
+
+
+
+export declare function isDesktopAppMode(): boolean;
+
+
+
+
+
+export declare function getBridgeListenHost(): string | undefined;
+
+
+
+
+
 export declare function getUserHomeDir(): string;
 
+
+
+
+
+
+
 export declare function getRuntimeHomeDir(): string;
 
 export declare const DEFAULT_BRIDGE_PORT = 18081;
 
 export declare const DEV_DEFAULT_BRIDGE_PORT = 28081;
 
+
+
+
+
 export declare const port: number;
 
 export declare function getActiveBridgeHttpPort(): number;
@@ -18,9 +58,19 @@ export declare function setActiveBridgeHttpPort(value: number): void;
 
 export declare function resetActiveBridgeHttpPort(): void;
 
-export declare function findAvailableListenPort(preferred: number, maxAttempts?: number): Promise<number>;
 
-export declare function reserveBridgeListenPort(preferred?: number): Promise<number>;
+
+
+export declare function findAvailableListenPort(preferred: number, maxAttempts?: number, host?: string): Promise<number>;
+
+
+
+
+
+
+
+
+export declare function reserveBridgeListenPort(preferred?: number, host?: string | undefined): Promise<number>;
 
 export declare const DEFAULT_SCHEDULER_BASE_URL = "http://localhost:8080";
 export type SchedulerBaseUrlSource = "request" | "instance-id-match" | "env" | "single-auto-register-target" | "default" | "ambiguous-auto-register-targets" | "token-match";
@@ -32,16 +82,41 @@ export interface SchedulerBaseUrlResolution {
     instanceId?: string;
     
     instanceName?: string;
+    
+
+
+
+
+    userKey?: string;
 }
 
+
+
+
+
 export declare function getAutoRegisterConfigFilePath(): string;
 
+
+
+
+
 export declare function getBridgeRuntimePropertiesFilePath(): string;
 
+
+
+
+
 export declare function writeBridgeRuntimePropertiesFile(): void;
 
+
+
+
 export declare function resolveSchedulerBaseUrl(): SchedulerBaseUrlResolution;
 
+
+
+
+
 export declare function resolveSchedulerBaseUrlFrom(requestSchedulerBaseUrl: unknown, instanceId?: unknown, instanceName?: unknown): SchedulerBaseUrlResolution;
 
 export declare const schedulerBaseUrl: string;
@@ -61,21 +136,64 @@ export declare function getClaudeMcpConfigFile(runtimeHome: string): string;
 export declare function getClaudeSkillsDir(runtimeHome: string): string;
 
 export declare function getOpencodeConfigFile(runtimeHome: string): string;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 export declare function getBridgeDataHome(): string;
 
+
+
+
+
 export declare function getBridgeTemplateDir(): string;
 
+
+
+
 export declare function getBridgeTemplateConfigFile(): string;
 
+
+
+
 export declare function getBridgeTemplateSkillsDir(): string;
 
+
+
+
 export declare function getBridgeTemplatePluginsDir(): string;
 
+
+
+
 export declare function getBridgeTemplateMcpDir(): string;
 
+
+
+
+
 export declare function getBridgeTemplateMcpPackagesDir(): string;
 
+
+
+
 export declare function getBridgeTemplateAgentsDir(): string;
 
 export declare function getBridgeInstanceRuntimeDir(agentId: string): string;
@@ -86,12 +204,23 @@ export declare function getBridgeInstanceSkillsDir(agentId: string): string;
 
 export declare function getBridgeInstancePluginsDir(agentId: string): string;
 
+
+
+
+
+
+
 export declare function getBridgeInstancePrivateSkillsDir(agentId: string): string;
 
 export declare function getBridgeInstancePrivateSkillsManifest(agentId: string): string;
 
 export declare function getBridgeInstanceMcpExtraFile(agentId: string): string;
 
+
+
+
+
+
 export declare function getAcodeDataHome(): string;
 
 export declare function getCodexConfigFile(runtimeHome: string): string;
@@ -101,6 +230,8 @@ export declare function getCodexSkillsDir(runtimeHome: string): string;
 export declare function getOpencodeSkillsDir(runtimeHome: string): string;
 
 
+
+
 export declare const ORPHAN_SCAN_INTERVAL: number;
 
 export declare const ORPHAN_AUTO_CLEAN_MODE: "auto" | "alert" | "manual";
@@ -114,6 +245,8 @@ export declare const ORPHAN_CPU_THRESHOLD: number;
 export declare const ORPHAN_MEMORY_THRESHOLD: number;
 
 
+
+
 export declare const AUTO_REGISTER_ENABLED: boolean;
 
 export declare const AUTO_REGISTER_TENANT_ID: string;
@@ -130,4 +263,7 @@ export declare const AUTO_REGISTER_WORKSPACE_PATH: string;
 
 export declare const AUTO_REGISTER_VIRTUAL_IP: string;
 
+
+
+
 export declare function getBridgeVersion(): string;

package/dist/config.js

@@ -1,4 +1,4 @@
-import u from"node:fs";import L from"node:net";import{homedir as C}from"node:os";import t from"node:path";import{fileURLToPath as I}from"node:url";import{logger as B}from"./utils/logger.js";function M(e){return String(e??"").replace(/[^a-zA-Z0-9_.-]/g,"_").replace(/^\.+/g,"")}function N(){return String(process.env.AWS_RUNTIME_ENV||"").trim().toLowerCase()==="development"}let S;function h(){if(S!==void 0)return S;const e=t.dirname(I(import.meta.url)),r=t.resolve(e,".."),n=t.resolve(r,".."),o=u.existsSync(t.join(n,".git"))||u.existsSync(t.join(n,"package.json"));return S=t.join(o?n:r,".dev-home"),S}function O(){return String(process.env.AWS_TEST_HOME||"").trim()||String(process.env.AWS_RUNTIME_HOME_DIR||"").trim()||C()}function f(){return N()?String(process.env.AWS_TEST_HOME||"").trim()||String(process.env.AWS_RUNTIME_HOME_DIR||"").trim()||h():O()}const H=18081,j=28081,v=Number(process.env.AWS_RUNTIME_BRIDGE_PORT||(N()?j:H));let R;function W(){return R??v}function k(e){R=e}function X(){R=void 0}function U(e){return new Promise(r=>{const n=L.createServer();n.once("error",o=>{const i=o.code==="EADDRINUSE"||o.code==="EACCES"||o.code==="EPERM";r(!i)}),n.once("listening",()=>{n.close(()=>r(!0))}),n.listen(e)})}async function x(e){return await U({port:e})&&await U({port:e,host:"0.0.0.0"})?e:null}async function w(e,r=20){let n=Math.floor(e);for(let i=0;i<r;i+=1){if(n>=1&&n<=65535){const c=await x(n);if(c!==null)return c}n+=1}return await x(0)??e}async function Z(e=v){const r=await w(e);return k(r),process.env.AWS_RUNTIME_BRIDGE_PORT=String(r),r!==e&&B.warn(`[runtime-bridge] \u9996\u9009\u7AEF\u53E3 ${e} \u5DF2\u88AB\u5360\u7528\uFF0C\u81EA\u52A8\u6539\u7528 ${r} \u542F\u52A8`),r}const d="http://localhost:8080";function m(e){return e==null?void 0:String(e).trim()||void 0}function _(e){const r=m(e);if(!r)return;const n=r.replace(/^((?:https?|wss?):\/\/(?:\[[^\]]+\]|[^/:?#]+):\d+):\d+(?=\/|$)/i,"$1");try{const o=new URL(n);return o.protocol==="ws:"?o.protocol="http:":o.protocol==="wss:"?o.protocol="https:":o.protocol=o.protocol.toLowerCase(),o.hostname=o.hostname.toLowerCase(),o.origin}catch{return n.replace(/\/+$/,"")}}function F(){return t.join(f(),".aws-bridge","config.json")}function y(){return t.join(f(),".aws-bridge","bridge-runtime.properties")}function Q(){const e=y();u.mkdirSync(t.dirname(e),{recursive:!0});const r=[`port=${W()}`,`pid=${process.pid}`,`startedAt=${new Date().toISOString()}`];u.writeFileSync(e,`${r.join(`
+import a from"node:fs";import C from"node:net";import{homedir as B}from"node:os";import r from"node:path";import{fileURLToPath as v}from"node:url";import{logger as M}from"./utils/logger.js";function h(e){return String(e??"").replace(/[^a-zA-Z0-9_.-]/g,"_").replace(/^\.+/g,"")}function U(){return String(process.env.AWS_RUNTIME_ENV||"").trim().toLowerCase()==="development"}function ee(){return String(process.env.AWS_BRIDGE_APP_MODE||"").trim().toLowerCase()==="desktop"}function H(){return String(process.env.AWS_BRIDGE_LISTEN_HOST||"").trim()||void 0}let S;function W(){if(S!==void 0)return S;const e=r.dirname(v(import.meta.url)),n=r.resolve(e,".."),t=r.resolve(n,".."),o=a.existsSync(r.join(t,".git"))||a.existsSync(r.join(t,"package.json"));return S=r.join(o?t:n,".dev-home"),S}function x(){return String(process.env.AWS_TEST_HOME||"").trim()||String(process.env.AWS_RUNTIME_HOME_DIR||"").trim()||B()}function m(){return U()?String(process.env.AWS_TEST_HOME||"").trim()||String(process.env.AWS_RUNTIME_HOME_DIR||"").trim()||W():x()}const j=18081,k=28081,D=Number(process.env.AWS_RUNTIME_BRIDGE_PORT||(U()?k:j));let T;function w(){return T??D}function y(e){T=e}function te(){T=void 0}function I(e){return new Promise(n=>{const t=C.createServer();t.once("error",o=>{const s=o.code==="EADDRINUSE"||o.code==="EACCES"||o.code==="EPERM";n(!s)}),t.once("listening",()=>{t.close(()=>n(!0))}),t.listen(e)})}async function P(e,n){return n?await I({port:e,host:n})?e:null:await I({port:e})&&await I({port:e,host:"0.0.0.0"})?e:null}async function F(e,n=20,t){let o=Math.floor(e);for(let c=0;c<n;c+=1){if(o>=1&&o<=65535){const i=await P(o,t);if(i!==null)return i}o+=1}return await P(0,t)??e}async function re(e=D,n=H()){const t=await F(e,20,n);return y(t),process.env.AWS_RUNTIME_BRIDGE_PORT=String(t),t!==e&&M.warn(`[runtime-bridge] \u9996\u9009\u7AEF\u53E3 ${e} \u5DF2\u88AB\u5360\u7528\uFF0C\u81EA\u52A8\u6539\u7528 ${t} \u542F\u52A8`),t}const d="http://localhost:8080";function A(e){return e==null?void 0:String(e).trim()||void 0}function _(e){const n=A(e);if(!n)return;const t=n.replace(/^((?:https?|wss?):\/\/(?:\[[^\]]+\]|[^/:?#]+):\d+):\d+(?=\/|$)/i,"$1");try{const o=new URL(t);return o.protocol==="ws:"?o.protocol="http:":o.protocol==="wss:"?o.protocol="https:":o.protocol=o.protocol.toLowerCase(),o.hostname=o.hostname.toLowerCase(),o.origin}catch{return t.replace(/\/+$/,"")}}function G(){return r.join(m(),".aws-bridge","config.json")}function b(){return r.join(m(),".aws-bridge","bridge-runtime.properties")}function ne(){const e=b();a.mkdirSync(r.dirname(e),{recursive:!0});const n=[`port=${w()}`,`pid=${process.pid}`,`startedAt=${new Date().toISOString()}`];a.writeFileSync(e,`${n.join(`
 `)}
-`,{encoding:"utf8",mode:384})}function D(){const e=F();try{if(!u.existsSync(e))return[];const r=JSON.parse(u.readFileSync(e,"utf-8")),n=s=>({serverUrl:_(s.serverUrl)||_(s.schedulerBaseUrl),instanceId:m(s.instanceId),instanceName:m(s.instanceName)}),i=(Array.isArray(r.autoRegisterTargets)?r.autoRegisterTargets:[]).filter(s=>!!(s&&typeof s=="object"&&!Array.isArray(s))).map(n).filter(s=>!!s.serverUrl);if(i.length>0)return i;const c=n(r);return c.serverUrl?[c]:[]}catch{return[]}}function b(){const r=D().map(n=>n.serverUrl).filter(n=>!!n);return Array.from(new Set(r))}function ee(){return G(void 0)}function G(e,r,n){const o=_(e);if(o)return{url:o,source:"request",ambiguousTargetUrls:[]};const i=typeof r=="string"?r.trim():"",c=typeof n=="string"?n.trim():"";if(i||c){const A=D();let a;if(i&&(a=A.find(g=>g.instanceId===i)),!a&&c&&(a=A.find(g=>g.instanceName===c)),!a&&i&&!c&&(a=A.find(g=>g.instanceName===i)),a?.serverUrl)return{url:a.serverUrl,source:"instance-id-match",ambiguousTargetUrls:[],instanceId:a.instanceId,instanceName:a.instanceName}}const s=_(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL);if(s)return{url:s,source:"env",ambiguousTargetUrls:[]};const l=b();return l.length===1?{url:l[0]||d,source:"single-auto-register-target",ambiguousTargetUrls:[]}:l.length>1?{url:d,source:"ambiguous-auto-register-targets",ambiguousTargetUrls:l}:{url:d,source:"default",ambiguousTargetUrls:[]}}const te=_(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL)||d,re=process.env.NODE_ENV||"development",ne=process.env.AWS_ALLOW_HOST_FILE_BROWSER==="true",oe=String(process.env.AWS_RUNTIME_CORS_ORIGINS||"http://localhost:3000,http://127.0.0.1:3000,http://localhost:5173,http://127.0.0.1:5173").split(",").map(e=>e.trim()).filter(e=>e.length>0);function ie(){}function se(e){return String(process.env.AWS_RUNTIME_CLAUDE_CONFIG_FILE||"").trim()||t.join(e,".claude","settings.json")}function ce(e){return String(process.env.AWS_RUNTIME_CLAUDE_MCP_CONFIG_FILE||"").trim()||t.join(e,".claude.json")}function ae(e){return String(process.env.AWS_RUNTIME_CLAUDE_SKILLS_DIR||"").trim()||t.join(e,".claude","skills")}function ue(e){return String(process.env.AWS_RUNTIME_OPENCODE_CONFIG_FILE||"").trim()||t.join(e,".config","opencode","opencode.json")}function P(){return t.join(f(),".aws-bridge")}function E(){return t.join(P(),"instance-template")}function pe(){return String(process.env.AWS_RUNTIME_ACODE_CONFIG_FILE||"").trim()||t.join(E(),"config.json")}function le(){return String(process.env.AWS_RUNTIME_ACODE_SKILLS_DIR||"").trim()||t.join(E(),"skills")}function ge(){return String(process.env.AWS_RUNTIME_ACODE_PLUGINS_DIR||"").trim()||t.join(E(),"plugins")}function V(){return t.join(E(),"mcp")}function _e(){return t.join(V(),"packages")}function Ee(){return t.join(E(),"agents")}function p(e){return t.join(P(),"instance-runtime",M(String(e)))}function Se(e){return t.join(p(e),"config.json")}function de(e){return t.join(p(e),"skills")}function Ae(e){return t.join(p(e),"plugins")}function fe(e){return t.join(p(e),"private-skills")}function Re(e){return t.join(p(e),"private-skills.json")}function me(e){return t.join(p(e),"mcp-extra.json")}function Te(){return String(process.env.ACODE_HOME||"").trim()||t.join(O(),".acode")}function Ie(e){return String(process.env.AWS_RUNTIME_CODEX_CONFIG_FILE||"").trim()||t.join(e,".codex","config.toml")}function Ne(e){return String(process.env.AWS_RUNTIME_CODEX_SKILLS_DIR||"").trim()||t.join(e,".codex","skills")}function Oe(e){return String(process.env.AWS_RUNTIME_OPENCODE_SKILLS_DIR||"").trim()||t.join(e,".opencode","skills")}const ve=Number(process.env.AWS_ORPHAN_SCAN_INTERVAL||3e4),Ue=process.env.AWS_ORPHAN_AUTO_CLEAN_MODE||"alert",xe=process.env.AWS_ORPHAN_SCAN_ENABLED!=="false",De=Number(process.env.AWS_ORPHAN_UNRESPONSIVE_TIMEOUT||3e5),Pe=Number(process.env.AWS_ORPHAN_CPU_THRESHOLD||100),Le=Number(process.env.AWS_ORPHAN_MEMORY_THRESHOLD||2048),Ce=process.env.AWS_AUTO_REGISTER==="true",Be=process.env.AWS_TENANT_ID||"",Me=process.env.AWS_USER_KEY||"",he=process.env.AWS_INSTANCE_NAME||"",He=process.env.AWS_PROJECT_NAME||"",je=process.env.AWS_ROLE_NAME||"",We=process.env.AWS_WORKSPACE_PATH||"",ke=process.env.AWS_REGISTER_IP||process.env.AWS_VIRTUAL_IP||"";let T;function we(){if(T!==void 0)return T;let e="unknown";try{const r=t.dirname(I(import.meta.url)),n=t.resolve(r,"..","package.json");u.existsSync(n)&&(e=JSON.parse(u.readFileSync(n,"utf-8")).version||"unknown")}catch{}return T=e,e}export{Ce as AUTO_REGISTER_ENABLED,he as AUTO_REGISTER_INSTANCE_NAME,He as AUTO_REGISTER_PROJECT_NAME,je as AUTO_REGISTER_ROLE_NAME,Be as AUTO_REGISTER_TENANT_ID,Me as AUTO_REGISTER_USER_KEY,ke as AUTO_REGISTER_VIRTUAL_IP,We as AUTO_REGISTER_WORKSPACE_PATH,H as DEFAULT_BRIDGE_PORT,d as DEFAULT_SCHEDULER_BASE_URL,j as DEV_DEFAULT_BRIDGE_PORT,Ue as ORPHAN_AUTO_CLEAN_MODE,Pe as ORPHAN_CPU_THRESHOLD,Le as ORPHAN_MEMORY_THRESHOLD,xe as ORPHAN_SCAN_ENABLED,ve as ORPHAN_SCAN_INTERVAL,De as ORPHAN_UNRESPONSIVE_TIMEOUT,ne as allowHostFileBrowser,oe as allowedCorsOrigins,w as findAvailableListenPort,Te as getAcodeDataHome,W as getActiveBridgeHttpPort,F as getAutoRegisterConfigFilePath,P as getBridgeDataHome,Se as getBridgeInstanceConfigFile,me as getBridgeInstanceMcpExtraFile,Ae as getBridgeInstancePluginsDir,fe as getBridgeInstancePrivateSkillsDir,Re as getBridgeInstancePrivateSkillsManifest,p as getBridgeInstanceRuntimeDir,de as getBridgeInstanceSkillsDir,y as getBridgeRuntimePropertiesFilePath,Ee as getBridgeTemplateAgentsDir,pe as getBridgeTemplateConfigFile,E as getBridgeTemplateDir,V as getBridgeTemplateMcpDir,_e as getBridgeTemplateMcpPackagesDir,ge as getBridgeTemplatePluginsDir,le as getBridgeTemplateSkillsDir,we as getBridgeVersion,se as getClaudeConfigFile,ce as getClaudeMcpConfigFile,ae as getClaudeSkillsDir,Ie as getCodexConfigFile,Ne as getCodexSkillsDir,ue as getOpencodeConfigFile,Oe as getOpencodeSkillsDir,f as getRuntimeHomeDir,O as getUserHomeDir,N as isDevMode,re as nodeEnv,v as port,Z as reserveBridgeListenPort,X as resetActiveBridgeHttpPort,ee as resolveSchedulerBaseUrl,G as resolveSchedulerBaseUrlFrom,te as schedulerBaseUrl,k as setActiveBridgeHttpPort,ie as validateProductionToken,Q as writeBridgeRuntimePropertiesFile};
+`,{encoding:"utf8",mode:384})}function f(){const e=G();try{if(!a.existsSync(e))return[];const n=JSON.parse(a.readFileSync(e,"utf-8")),t=i=>({serverUrl:_(i.serverUrl)||_(i.schedulerBaseUrl),instanceId:A(i.instanceId),instanceName:A(i.instanceName),userKey:A(i.userKey)}),s=(Array.isArray(n.autoRegisterTargets)?n.autoRegisterTargets:[]).filter(i=>!!(i&&typeof i=="object"&&!Array.isArray(i))).map(t).filter(i=>!!i.serverUrl);if(s.length>0)return s;const c=t(n);return c.serverUrl?[c]:[]}catch{return[]}}function K(){const n=f().map(t=>t.serverUrl).filter(t=>!!t);return Array.from(new Set(n))}function V(){return f().length}function oe(){return $(void 0)}function $(e,n,t){const o=_(e);if(o)return{url:o,source:"request",ambiguousTargetUrls:[]};const s=typeof n=="string"?n.trim():"",c=typeof t=="string"?t.trim():"";if(s||c){const R=f();let u;if(s&&(u=R.find(g=>g.instanceId===s)),!u&&c&&(u=R.find(g=>g.instanceName===c)),!u&&s&&!c&&(u=R.find(g=>g.instanceName===s)),u?.serverUrl)return{url:u.serverUrl,source:"instance-id-match",ambiguousTargetUrls:[],instanceId:u.instanceId,instanceName:u.instanceName,userKey:u.userKey}}const i=_(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL);if(i)return{url:i,source:"env",ambiguousTargetUrls:[]};const l=K(),N=V();return N===1&&l.length===1?{url:l[0]||d,source:"single-auto-register-target",ambiguousTargetUrls:[],userKey:f()[0]?.userKey}:N>1||l.length>1?{url:d,source:"ambiguous-auto-register-targets",ambiguousTargetUrls:l}:{url:d,source:"default",ambiguousTargetUrls:[]}}const ie=_(process.env.AWS_RUNTIME_SCHEDULER_BASE_URL)||d,se=process.env.NODE_ENV||"development",ce=process.env.AWS_ALLOW_HOST_FILE_BROWSER==="true",ue=String(process.env.AWS_RUNTIME_CORS_ORIGINS||"http://localhost:3000,http://127.0.0.1:3000,http://localhost:5173,http://127.0.0.1:5173").split(",").map(e=>e.trim()).filter(e=>e.length>0);function ae(){}function pe(e){return String(process.env.AWS_RUNTIME_CLAUDE_CONFIG_FILE||"").trim()||r.join(e,".claude","settings.json")}function le(e){return String(process.env.AWS_RUNTIME_CLAUDE_MCP_CONFIG_FILE||"").trim()||r.join(e,".claude.json")}function ge(e){return String(process.env.AWS_RUNTIME_CLAUDE_SKILLS_DIR||"").trim()||r.join(e,".claude","skills")}function _e(e){return String(process.env.AWS_RUNTIME_OPENCODE_CONFIG_FILE||"").trim()||r.join(e,".config","opencode","opencode.json")}function L(){return r.join(m(),".aws-bridge")}function E(){return r.join(L(),"instance-template")}function Ee(){return String(process.env.AWS_RUNTIME_ACODE_CONFIG_FILE||"").trim()||r.join(E(),"config.json")}function Se(){return String(process.env.AWS_RUNTIME_ACODE_SKILLS_DIR||"").trim()||r.join(E(),"skills")}function de(){return String(process.env.AWS_RUNTIME_ACODE_PLUGINS_DIR||"").trim()||r.join(E(),"plugins")}function z(){return r.join(E(),"mcp")}function Ae(){return r.join(z(),"packages")}function fe(){return r.join(E(),"agents")}function p(e){return r.join(L(),"instance-runtime",h(String(e)))}function Re(e){return r.join(p(e),"config.json")}function me(e){return r.join(p(e),"skills")}function Te(e){return r.join(p(e),"plugins")}function Ie(e){return r.join(p(e),"private-skills")}function Oe(e){return r.join(p(e),"private-skills.json")}function Ne(e){return r.join(p(e),"mcp-extra.json")}function ve(){return String(process.env.ACODE_HOME||"").trim()||r.join(x(),".acode")}function Ue(e){return String(process.env.AWS_RUNTIME_CODEX_CONFIG_FILE||"").trim()||r.join(e,".codex","config.toml")}function xe(e){return String(process.env.AWS_RUNTIME_CODEX_SKILLS_DIR||"").trim()||r.join(e,".codex","skills")}function De(e){return String(process.env.AWS_RUNTIME_OPENCODE_SKILLS_DIR||"").trim()||r.join(e,".opencode","skills")}const Pe=Number(process.env.AWS_ORPHAN_SCAN_INTERVAL||3e4),Le=process.env.AWS_ORPHAN_AUTO_CLEAN_MODE||"alert",Ce=process.env.AWS_ORPHAN_SCAN_ENABLED!=="false",Be=Number(process.env.AWS_ORPHAN_UNRESPONSIVE_TIMEOUT||3e5),Me=Number(process.env.AWS_ORPHAN_CPU_THRESHOLD||100),he=Number(process.env.AWS_ORPHAN_MEMORY_THRESHOLD||2048),He=process.env.AWS_AUTO_REGISTER==="true",We=process.env.AWS_TENANT_ID||"",je=process.env.AWS_USER_KEY||"",ke=process.env.AWS_INSTANCE_NAME||"",we=process.env.AWS_PROJECT_NAME||"",ye=process.env.AWS_ROLE_NAME||"",Fe=process.env.AWS_WORKSPACE_PATH||"",Ge=process.env.AWS_REGISTER_IP||process.env.AWS_VIRTUAL_IP||"";let O;function be(){if(O!==void 0)return O;let e="unknown";try{const n=r.dirname(v(import.meta.url)),t=r.resolve(n,"..","package.json");a.existsSync(t)&&(e=JSON.parse(a.readFileSync(t,"utf-8")).version||"unknown")}catch{}return O=e,e}export{He as AUTO_REGISTER_ENABLED,ke as AUTO_REGISTER_INSTANCE_NAME,we as AUTO_REGISTER_PROJECT_NAME,ye as AUTO_REGISTER_ROLE_NAME,We as AUTO_REGISTER_TENANT_ID,je as AUTO_REGISTER_USER_KEY,Ge as AUTO_REGISTER_VIRTUAL_IP,Fe as AUTO_REGISTER_WORKSPACE_PATH,j as DEFAULT_BRIDGE_PORT,d as DEFAULT_SCHEDULER_BASE_URL,k as DEV_DEFAULT_BRIDGE_PORT,Le as ORPHAN_AUTO_CLEAN_MODE,Me as ORPHAN_CPU_THRESHOLD,he as ORPHAN_MEMORY_THRESHOLD,Ce as ORPHAN_SCAN_ENABLED,Pe as ORPHAN_SCAN_INTERVAL,Be as ORPHAN_UNRESPONSIVE_TIMEOUT,ce as allowHostFileBrowser,ue as allowedCorsOrigins,F as findAvailableListenPort,ve as getAcodeDataHome,w as getActiveBridgeHttpPort,G as getAutoRegisterConfigFilePath,L as getBridgeDataHome,Re as getBridgeInstanceConfigFile,Ne as getBridgeInstanceMcpExtraFile,Te as getBridgeInstancePluginsDir,Ie as getBridgeInstancePrivateSkillsDir,Oe as getBridgeInstancePrivateSkillsManifest,p as getBridgeInstanceRuntimeDir,me as getBridgeInstanceSkillsDir,H as getBridgeListenHost,b as getBridgeRuntimePropertiesFilePath,fe as getBridgeTemplateAgentsDir,Ee as getBridgeTemplateConfigFile,E as getBridgeTemplateDir,z as getBridgeTemplateMcpDir,Ae as getBridgeTemplateMcpPackagesDir,de as getBridgeTemplatePluginsDir,Se as getBridgeTemplateSkillsDir,be as getBridgeVersion,pe as getClaudeConfigFile,le as getClaudeMcpConfigFile,ge as getClaudeSkillsDir,Ue as getCodexConfigFile,xe as getCodexSkillsDir,_e as getOpencodeConfigFile,De as getOpencodeSkillsDir,m as getRuntimeHomeDir,x as getUserHomeDir,ee as isDesktopAppMode,U as isDevMode,se as nodeEnv,D as port,re as reserveBridgeListenPort,te as resetActiveBridgeHttpPort,oe as resolveSchedulerBaseUrl,$ as resolveSchedulerBaseUrlFrom,ie as schedulerBaseUrl,y as setActiveBridgeHttpPort,ae as validateProductionToken,ne as writeBridgeRuntimePropertiesFile};
 

package/dist/desktop/built-in-desktop-tools.d.ts

@@ -1,5 +1,46 @@
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 export type DesktopJsonValue = string | number | boolean | null | DesktopJsonValue[] | {
     [key: string]: DesktopJsonValue;
 };
@@ -34,19 +75,46 @@ export interface CreateBuiltInDesktopToolsOptions {
     
     forwarder: DesktopToolForwarder;
     
+
+
+
+    internalForwarder?: DesktopToolForwarder;
+    
+    agentId?: string;
+    
     screenshotDir?: string;
 }
 
+
+
+
 export declare function createBuiltInDesktopTools(options: CreateBuiltInDesktopToolsOptions): ACodeBuiltInToolLike[];
 
+
+
+
+
 export declare function injectRememberedOrigin(args: DesktopJsonObject): DesktopJsonObject;
 
+
+
+
+
+
 export declare function rememberScreenshotOrigin(toolName: string, args: DesktopJsonObject, result: string): void;
 
 export declare function clearScreenshotOrigins(): void;
 
+
+
+
+
 export declare function injectScreenshotPath(toolName: string, args: DesktopJsonObject, screenshotDir: string): Promise<DesktopJsonObject>;
 
+
+
+
+
 export declare function pruneOldScreenshots(dir: string, options?: {
     now?: number;
     force?: boolean;

package/dist/desktop/built-in-desktop-tools.js

@@ -1,2 +1,3 @@
-import{mkdir as _,readdir as w,rm as N,stat as O}from"node:fs/promises";import{dirname as x,join as f}from"node:path";const d=new Set(["desktop_screenshot","desktop_window_screenshot"]),g=" Note: when no `path` is given, the bridge auto-saves the PNG to a local file and returns its path (NOT base64). COORDINATES: the bridge remembers each auto-saved screenshot's screen origin \u2014 running desktop_perceive on that file returns SCREEN coordinates directly, ready for desktop_mouse. Never do coordinate arithmetic yourself. For native windows prefer desktop_uia_tree + desktop_uia_click instead \u2014 precise and vision-free.";function j(e){const{tools:t,forwarder:o}=e,i=e.screenshotDir??f(process.cwd(),".desktop-mcp","screenshots");return t.filter(r=>r.name.startsWith("desktop_")).map(r=>{const s=d.has(r.name),c=r.name==="desktop_perceive",p=s?`${r.description??r.name}${g}`:r.description??r.name;return{kind:"builtin",toolName:r.name,exposedName:r.name,description:p,inputSchema:I(r.inputSchema),category:"desktop",async execute(n){let u=n;s?u=await T(r.name,n,i):c&&(u=k(n));const h=await o(r.name,u);return s&&b(r.name,u,h),h}}})}const a=new Map,E=500;function l(e){return e.trim().replace(/\//g,"\\").toLowerCase()}function m(e){return e!=null}function k(e){const t=typeof e.path=="string"?e.path.trim():"";if(!t||m(e.origin_x)||m(e.origin_y))return e;const o=a.get(l(t));return o?{...e,origin_x:o.x,origin_y:o.y}:e}function b(e,t,o){let i=null;try{i=JSON.parse(o)}catch{i=null}const s=(typeof i?.path=="string"?i.path:"")||(typeof t.path=="string"?t.path:"");if(!s.trim())return;let c=null;if(e==="desktop_window_screenshot"){const n=i?.origin;n&&typeof n.x=="number"&&typeof n.y=="number"&&(c={x:n.x,y:n.y,at:Date.now()})}else{const n=t.region;n&&typeof n.x=="number"&&typeof n.y=="number"?c={x:n.x,y:n.y,at:Date.now()}:n||(c={x:0,y:0,at:Date.now()})}if(!c)return;const p=l(s);for(a.delete(p),a.set(p,c);a.size>E;){const n=a.keys().next().value;if(n===void 0)break;a.delete(n)}}function M(){a.clear()}async function T(e,t,o){if(!d.has(e)||typeof t.path=="string"&&t.path.trim())return t;const i=D(o);return await _(x(i),{recursive:!0}).catch(()=>{}),P(o).catch(()=>{}),{...t,path:i}}const y=(()=>{const e=Number.parseInt(process.env.AWS_DESKTOP_MCP_SCREENSHOT_RETENTION_DAYS??"",10);return Number.isFinite(e)&&e>=0?e:7})(),v=2*36e5;let S=0;async function P(e,t){const o=t?.now??Date.now();if(y===0||!t?.force&&o-S<v)return;S=o;const i=o-y*864e5;let r;try{r=await w(e)}catch{return}await Promise.all(r.filter(s=>s.startsWith("shot-")&&s.endsWith(".png")).map(async s=>{const c=f(e,s);try{(await O(c)).mtimeMs<i&&await N(c,{force:!0})}catch{}}))}let R=0;function D(e){const t=(++R).toString(36).padStart(3,"0"),o=new Date().toISOString().replace(/[:.]/g,"-");return f(e,`shot-${o}-${t}.png`)}function I(e){if(!e||typeof e!="object")return{type:"object",properties:{}};try{return JSON.parse(JSON.stringify(e))}catch{return{type:"object",properties:{}}}}export{M as clearScreenshotOrigins,j as createBuiltInDesktopTools,k as injectRememberedOrigin,T as injectScreenshotPath,D as nextScreenshotFilePath,P as pruneOldScreenshots,b as rememberScreenshotOrigin};
+import{mkdir as g,readdir as k,rm as E,stat as T}from"node:fs/promises";import{dirname as b,join as f}from"node:path";import{markFreshObservation as x,normalizePathKey as A,recordPerceiveBasis as v,recordScreenshotCapture as I,resolveStalenessNote as R}from"./desktop-staleness.js";const S=new Set(["desktop_screenshot","desktop_window_screenshot"]),P=" Note: when no `path` is given, the bridge auto-saves the PNG to a local file and returns its path (NOT base64). COORDINATES: the bridge remembers each auto-saved screenshot's screen origin \u2014 running desktop_perceive on that file returns SCREEN coordinates directly, ready for desktop_mouse. Never do coordinate arithmetic yourself. For native windows prefer desktop_uia_tree + desktop_uia_click instead \u2014 precise and vision-free.",D=new Set(["desktop_mouse","desktop_mouse_drag","desktop_click_mark"]),C=' FRESHNESS: the bridge tracks which screenshot your coordinates came from \u2014 if the screen changed since, the tool result carries a "[bridge] STALE COORDINATES" warning. When you see it, re-capture with desktop_screenshot + desktop_perceive before retrying.';function q(e){const{tools:n,forwarder:o,internalForwarder:i,agentId:s}=e,a=e.screenshotDir??f(process.cwd(),".desktop-mcp","screenshots");return n.filter(t=>t.name.startsWith("desktop_")).map(t=>{const p=S.has(t.name),r=t.name==="desktop_perceive",l=D.has(t.name),O=p?`${t.description??t.name}${P}`:l?`${t.description??t.name}${C}`:t.description??t.name;return{kind:"builtin",toolName:t.name,exposedName:t.name,description:O,inputSchema:z(t.inputSchema),category:"desktop",async execute(d){let c=d;p?c=await F(t.name,d,a):r&&(c=H(d));const m=s&&l?await R({agentId:s,toolName:t.name,args:c,internalForwarder:i,screenshotDir:a}):null,h=await o(t.name,c);return p?(j(t.name,c,h),I(s??"",t.name,c,h)):r&&typeof c.path=="string"&&c.path.trim()?await v(s??"",c.path):r&&s&&x(s),m?`${h}
+${m}`:h}}})}const u=new Map,$=500;function _(e){return A(e)}function y(e){return e!=null}function H(e){const n=typeof e.path=="string"?e.path.trim():"";if(!n||y(e.origin_x)||y(e.origin_y))return e;const o=u.get(_(n));return o?{...e,origin_x:o.x,origin_y:o.y}:e}function j(e,n,o){let i=null;try{i=JSON.parse(o)}catch{i=null}const a=(typeof i?.path=="string"?i.path:"")||(typeof n.path=="string"?n.path:"");if(!a.trim())return;let t=null;if(e==="desktop_window_screenshot"){const r=i?.origin;r&&typeof r.x=="number"&&typeof r.y=="number"&&(t={x:r.x,y:r.y,at:Date.now()})}else{const r=n.region;r&&typeof r.x=="number"&&typeof r.y=="number"?t={x:r.x,y:r.y,at:Date.now()}:r||(t={x:0,y:0,at:Date.now()})}if(!t)return;const p=_(a);for(u.delete(p),u.set(p,t);u.size>$;){const r=u.keys().next().value;if(r===void 0)break;u.delete(r)}}function B(){u.clear()}async function F(e,n,o){if(!S.has(e)||typeof n.path=="string"&&n.path.trim())return n;const i=G(o);return await g(b(i),{recursive:!0}).catch(()=>{}),L(o).catch(()=>{}),{...n,path:i}}const w=(()=>{const e=Number.parseInt(process.env.AWS_DESKTOP_MCP_SCREENSHOT_RETENTION_DAYS??"",10);return Number.isFinite(e)&&e>=0?e:7})(),M=2*36e5;let N=0;async function L(e,n){const o=n?.now??Date.now();if(w===0||!n?.force&&o-N<M)return;N=o;const i=o-w*864e5;let s;try{s=await k(e)}catch{return}await Promise.all(s.filter(a=>a.startsWith("shot-")&&a.endsWith(".png")).map(async a=>{const t=f(e,a);try{(await T(t)).mtimeMs<i&&await E(t,{force:!0})}catch{}}))}let W=0;function G(e){const n=(++W).toString(36).padStart(3,"0"),o=new Date().toISOString().replace(/[:.]/g,"-");return f(e,`shot-${o}-${n}.png`)}function z(e){if(!e||typeof e!="object")return{type:"object",properties:{}};try{return JSON.parse(JSON.stringify(e))}catch{return{type:"object",properties:{}}}}export{B as clearScreenshotOrigins,q as createBuiltInDesktopTools,H as injectRememberedOrigin,F as injectScreenshotPath,G as nextScreenshotFilePath,L as pruneOldScreenshots,j as rememberScreenshotOrigin};