aws-runtime-bridge 1.9.175 → 1.9.179

package/dist/services/debug-mount.d.ts

@@ -1,4 +1,18 @@
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 import type { FSWatcher } from "node:fs";
 import { RingBuffer } from "./ring-buffer.js";
 export type DebugItemKind = "mcp" | "plugin";
@@ -20,6 +34,10 @@ export interface McpHotMounter {
         sessions: number;
     }>;
     
+
+
+
+
     getMcpServerStderr?(agentId: string, name: string, tail: number): string[];
 }
 
@@ -64,6 +82,11 @@ export interface DebugMountResult {
     error?: string;
 }
 
+
+
+
+
+
 export declare function assertWithinWorkspace(workspacePath: string | undefined, targetPath: string): {
     ok: true;
     resolved: string;
@@ -73,10 +96,17 @@ export declare function assertWithinWorkspace(workspacePath: string | undefined,
 };
 export declare function isValidDebugName(name: string): boolean;
 
+
+
+
 export declare function debugMountPlugin(agentId: string, workspacePath: string | undefined, pluginPath: string, hotMounter?: McpHotMounter): Promise<DebugMountResult>;
 
 export declare function debugUnmountPlugin(agentId: string, name: string): Promise<DebugMountResult>;
 
+
+
+
+
 export declare function debugMountMcp(agentId: string, workspacePath: string | undefined, mcpPath: string, hotMounter: McpHotMounter, nameOverride?: string): Promise<DebugMountResult>;
 
 export declare function debugUnmountMcp(agentId: string, name: string, hotMounter: McpHotMounter): Promise<DebugMountResult>;
@@ -92,11 +122,21 @@ export interface DebugMountListItem {
     mountedAt: number;
 }
 
+
+
+
+
+
 export declare function listDebugMounts(agentId: string): {
     mcp: DebugMountListItem[];
     plugin: DebugMountListItem[];
 };
 
+
+
+
+
+
 export declare function getDebugItemLogs(agentId: string, kind: DebugItemKind, name: string, tail?: number, hotMounter?: McpHotMounter): Promise<{
     ok: boolean;
     kind: DebugItemKind;
@@ -119,4 +159,13 @@ export interface DebugPackageResult {
     error?: string;
 }
 
+
+
+
+
+
+
+
+
+
 export declare function packageDebugItem(workspacePath: string | undefined, itemPath: string, kind: DebugItemKind | "skill"): Promise<DebugPackageResult>;

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

@@ -1,4 +1,50 @@
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 import { type ACodeBuiltInToolLike } from "../desktop/built-in-desktop-tools.js";
 import { DesktopMcpConnection, type DesktopMcpToolInfo } from "../desktop/desktop-mcp-client.js";
 
@@ -25,16 +71,72 @@ export interface DesktopAgentAiInfo {
     baseURL?: string;
     apiKey?: string;
     
+
+
+
+
     supportsImage?: boolean;
 }
 
+
+
+
+
+
 export declare function resolveDesktopMcpBinary(): Promise<string | null>;
 
+
+
+
+
+
+
+
+
 export declare function startDesktopMcpManager(agentId?: string): Promise<DesktopMcpManagerState | null>;
 
+
+
+
+
+
+
+
+
+
 export declare function getDesktopTools(agentId: string | undefined, agentAi?: DesktopAgentAiInfo): Promise<ACodeBuiltInToolLike[]>;
 
-export declare function getDesktopToolsIfReady(): ACodeBuiltInToolLike[];
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function forwardDesktopToolGuarded(agentId: string, name: string, args: Record<string, unknown>, baseForward: (name: string, args: Record<string, unknown>) => Promise<string>): Promise<string>;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function getDesktopToolsIfReady(agentId?: string): ACodeBuiltInToolLike[];
 
 export declare function disposeDesktopMcpManager(): Promise<void>;
 

package/dist/services/desktop-mcp-manager.js

@@ -1,2 +1,2 @@
-import{access as M,constants as P}from"node:fs/promises";import{join as w,resolve as O}from"node:path";import{createBuiltInDesktopTools as k}from"../desktop/built-in-desktop-tools.js";import{DesktopMcpConnection as T}from"../desktop/desktop-mcp-client.js";import{logger as C}from"../utils/logger.js";import{DESKTOP_FEATURE_KEY as D,isFeatureEnabled as A}from"./instance-features.js";import{getPanelEnvVars as N,getAgentMeta as U}from"./panel-env.js";import{buildAgentMetaEnv as x}from"./mcp-env-injector.js";const d=C.child("desktop-mcp");let n=null,a=null,r=null,c,f="none";const g=process.platform==="win32"?"nuphus-mcp.exe":"nuphus-mcp",I=12e4,K=6e4;function $(){const e=process.env.AWS_DESKTOP_MCP_TIMEOUT_MS;if(e){const t=parseInt(e,10);if(Number.isFinite(t)&&t>0)return t}return I}function F(){const e=process.env.AWS_DESKTOP_MCP_RETRY_BACKOFF_MS;if(e){const t=parseInt(e,10);if(Number.isFinite(t)&&t>=0)return t}return K}async function R(){const e=process.env.AWS_DESKTOP_MCP_BIN;if(e){const o=O(e);return await h(o)?o:null}const t=w(process.cwd(),".desktop-mcp","bin",g);return await h(t)?t:null}async function h(e){try{return await M(e,P.F_OK),!0}catch{return!1}}function L(){const e={},t="AWS_DESKTOP_MCP_ENV_";for(const[o,s]of Object.entries(process.env))o.startsWith(t)&&s!==void 0&&(e[o.slice(t.length)]=s);return e}function S(e){const t={...L(),...N(e),...x(U(e))},o=t.NUPHUS_MCP_VISION_API_KEY!==void 0||t.NUPHUS_MCP_VISION_MODEL!==void 0;return!o&&c?.apiKey&&c.supportsImage===!0?(f="agent-fallback",t.NUPHUS_MCP_VISION_API_KEY=c.apiKey,t.NUPHUS_MCP_VISION_MODEL=c.model,c.baseURL&&(t.NUPHUS_MCP_VISION_BASE_URL=c.baseURL),d.info(`vision model fallback: reusing agent model ${c.model} for desktop_vision`)):o?f="panel-env":f="none",t}function y(e){return Object.keys(e).sort().map(t=>`${t}=${e[t]}`).join("\0")}async function v(e){if(n){if(n.connection.isConnected())return n;await _(n.connection),n=null}if(a)return a;if(r){if(r.reason==="binary-missing"||Date.now()-r.at<F())return null;r=null}return a=(async()=>{const t=await R();if(!t)return r={reason:"binary-missing",message:`nuphus-mcp binary not found. Set AWS_DESKTOP_MCP_BIN or place it at ${w(process.cwd(),".desktop-mcp","bin",g)}`,at:Date.now()},u(`desktop tools unavailable: ${r.message}`),null;const o=S(e),s=new T({command:t,env:o,onUnexpectedClose:()=>{u("nuphus-mcp process exited unexpectedly; will restart on next use"),n?.connection===s&&(n=null)}});try{const i=await s.start(),l=$();r=null;const p={connection:s,tools:i,binaryPath:t,envSig:y(o),ownerAgentId:e,forwarder:(m,b)=>B(s,m,b,l,e)};return n=p,u(`nuphus-mcp started (${t}), ${i.filter(m=>m.name.startsWith("desktop_")).length} desktop tools available`),p}catch(i){return await _(s),r={reason:"start-failed",message:i.message,at:Date.now()},E(`nuphus-mcp start failed: ${r.message}`),null}finally{a=null}})(),a}async function B(e,t,o,s,i){try{return await e.callTool(t,o,s)}catch(l){if(e.isConnected())throw l;E(`nuphus-mcp connection lost during ${t}: ${l.message}; restarting`),n?.connection===e&&(n=null),await _(e);const p=await v(i);if(!p)throw new Error(`nuphus-mcp restart failed: ${r?.message??"unknown"}`);return p.connection.callTool(t,o,s)}}async function X(e,t){if(!e)return[];t?.model&&(c=t);const o=S(e),s=y(o);n&&n.connection.isConnected()&&n.envSig!==s&&(u("nuphus-mcp env changed; restarting to apply new env"),await V());const i=await v(e);return i?k({tools:i.tools,forwarder:(l,p)=>A(e,D)?i.forwarder(l,p):(d.warn(`tool ${l} blocked: desktop capability disabled for ${e}`),Promise.resolve("desktop capability is disabled for this agent (toggled off while tools were exposed); stop calling desktop_* tools"))}):[]}function Z(){const e=n;return!e||!e.connection.isConnected()?W.map(t=>({kind:"builtin",toolName:t,exposedName:t,description:`${t}\uFF08\u684C\u9762\u81EA\u52A8\u5316\u5DE5\u5177\uFF0Cnuphus-mcp \u672A\u8FD0\u884C\uFF09\u3002\u5206\u914D desktop \u5206\u7C7B\u540E\u6309\u9700\u542F\u52A8\u540E\u7AEF\uFF0C\u5177\u4F53\u5DE5\u5177\u4EE5\u542F\u52A8\u540E\u76EE\u5F55\u4E3A\u51C6\u3002`,inputSchema:{type:"object",properties:{}},category:"desktop",async execute(){return`${t} is not ready: nuphus-mcp backend is not running. Allocate the desktop catalog to lazily start it, then retry.`}})):k({tools:e.tools,forwarder:(t,o)=>e.forwarder(t,o)})}const W=["desktop_screenshot","desktop_window_screenshot","desktop_perceive","desktop_vision","desktop_input","desktop_mouse","desktop_mouse_drag","desktop_screen_size","desktop_clipboard_write","desktop_clipboard_clean","desktop_config","desktop_uia_tree","desktop_uia_click","desktop_window_activate","desktop_window_info","desktop_window_move","desktop_window_resize","desktop_windows_list"];async function V(){const e=n;if(n=null,r=null,a){try{await a}catch{}a=null}e&&(await _(e.connection),u("nuphus-mcp stopped"))}function ee(){return{started:n!==null,binaryPath:n?.binaryPath??null,toolCount:n?n.tools.filter(e=>e.name.startsWith("desktop_")).length:0,failure:r,visionSource:f}}async function _(e){try{await e.close()}catch{}}function u(e){d.info(e)}function E(e){d.warn(e)}export{V as disposeDesktopMcpManager,ee as getDesktopMcpStatus,X as getDesktopTools,Z as getDesktopToolsIfReady,R as resolveDesktopMcpBinary,v as startDesktopMcpManager};
+import{access as g,constants as U}from"node:fs/promises";import{join as y,resolve as N}from"node:path";import{createBuiltInDesktopTools as v}from"../desktop/built-in-desktop-tools.js";import{DESKTOP_INPUT_TOOLS as R,describeDesktopAction as h,emitDesktopAction as _,isHumanControlActive as $,isPaused as x}from"../desktop/desktop-control.js";import{DesktopMcpConnection as F}from"../desktop/desktop-mcp-client.js";import{logger as K}from"../utils/logger.js";import{DESKTOP_FEATURE_KEY as L,isFeatureEnabled as W}from"./instance-features.js";import{buildAgentMetaEnv as B}from"./mcp-env-injector.js";import{getPanelEnvVars as H,getAgentMeta as V}from"./panel-env.js";const f=K.child("desktop-mcp");let s=null,p=null,c=null,d,k="none";const b=process.platform==="win32"?"nuphus-mcp.exe":"nuphus-mcp",j=12e4,Y=6e4;function z(){const t=process.env.AWS_DESKTOP_MCP_TIMEOUT_MS;if(t){const e=parseInt(t,10);if(Number.isFinite(e)&&e>0)return e}return j}function G(){const t=process.env.AWS_DESKTOP_MCP_RETRY_BACKOFF_MS;if(t){const e=parseInt(t,10);if(Number.isFinite(e)&&e>=0)return e}return Y}async function I(){const t=process.env.AWS_DESKTOP_MCP_BIN;if(t){const o=N(t);return await M(o)?o:null}const e=y(process.cwd(),".desktop-mcp","bin",b);return await M(e)?e:null}async function M(t){try{return await g(t,U.F_OK),!0}catch{return!1}}function J(){const t={},e="AWS_DESKTOP_MCP_ENV_";for(const[o,n]of Object.entries(process.env))o.startsWith(e)&&n!==void 0&&(t[o.slice(e.length)]=n);return t}function P(t){const e={...J(),...H(t),...B(V(t))},o=e.NUPHUS_MCP_VISION_API_KEY!==void 0||e.NUPHUS_MCP_VISION_MODEL!==void 0;return!o&&d?.apiKey&&d.supportsImage===!0?(k="agent-fallback",e.NUPHUS_MCP_VISION_API_KEY=d.apiKey,e.NUPHUS_MCP_VISION_MODEL=d.model,d.baseURL&&(e.NUPHUS_MCP_VISION_BASE_URL=d.baseURL),f.info(`vision model fallback: reusing agent model ${d.model} for desktop_vision`)):o?k="panel-env":k="none",e}function T(t){return Object.keys(t).sort().map(e=>`${e}=${t[e]}`).join("\0")}async function O(t){if(s){if(s.connection.isConnected())return s;await m(s.connection),s=null}if(p)return p;if(c){if(c.reason==="binary-missing"||Date.now()-c.at<G())return null;c=null}return p=(async()=>{const e=await I();if(!e)return c={reason:"binary-missing",message:`nuphus-mcp binary not found. Set AWS_DESKTOP_MCP_BIN or place it at ${y(process.cwd(),".desktop-mcp","bin",b)}`,at:Date.now()},w(`desktop tools unavailable: ${c.message}`),null;const o=P(t),n=new F({command:e,env:o,onUnexpectedClose:()=>{w("nuphus-mcp process exited unexpectedly; will restart on next use"),s?.connection===n&&(s=null)}});try{const r=await n.start(),a=z();c=null;const i={connection:n,tools:r,binaryPath:e,envSig:T(o),ownerAgentId:t,forwarder:(u,l)=>X(n,u,l,a,t)};return s=i,w(`nuphus-mcp started (${e}), ${r.filter(u=>u.name.startsWith("desktop_")).length} desktop tools available`),i}catch(r){return await m(n),c={reason:"start-failed",message:r.message,at:Date.now()},C(`nuphus-mcp start failed: ${c.message}`),null}finally{p=null}})(),p}async function X(t,e,o,n,r){try{return await t.callTool(e,o,n)}catch(a){if(t.isConnected())throw a;C(`nuphus-mcp connection lost during ${e}: ${a.message}; restarting`),s?.connection===t&&(s=null),await m(t);const i=await O(r);if(!i)throw new Error(`nuphus-mcp restart failed: ${c?.message??"unknown"}`);return i.connection.callTool(e,o,n)}}async function ut(t,e){if(!t)return[];e?.model&&(d=e);const o=P(t),n=T(o);s&&s.connection.isConnected()&&s.envSig!==n&&(w("nuphus-mcp env changed; restarting to apply new env"),await tt());const r=await O(t);return r?v({tools:r.tools,agentId:t,forwarder:(a,i)=>E(t,a,i,(u,l)=>r.forwarder(u,l)),internalForwarder:(a,i)=>r.forwarder(a,i)}):[]}const D="nuphus-mcp tool error:",q="desktop control is PAUSED by the human operator (kill switch). Stop calling desktop_* tools immediately and inform the user; the operator will resume control when ready.",Q="desktop input is currently held by the human operator via remote desktop; AI input actions are suspended (read-only tools still work). Wait and retry later, or ask the user to release desktop control.";async function E(t,e,o,n){if(!W(t,L))return f.warn(`tool ${e} blocked: desktop capability disabled for ${t}`),"desktop capability is disabled for this agent (toggled off while tools were exposed); stop calling desktop_* tools";if(x(t))return f.warn(`tool ${e} blocked: desktop control paused (kill switch) for ${t}`),_(t,e,h(t,e,o),"rejected",{reason:"paused"}),q;if($(t)&&R.has(e))return f.warn(`tool ${e} blocked: human operator holds desktop control for ${t}`),_(t,e,h(t,e,o),"rejected",{reason:"human-control"}),Q;const r=h(t,e,o),i=r.action==="move"?null:_(t,e,r,"started"),u=Date.now();try{const l=await n(e,o),S=l.startsWith(D);return i&&_(t,e,r,S?"error":"done",{id:i.id,durationMs:Date.now()-u,...S&&{error:A(l.slice(D.length))}}),l}catch(l){throw i&&_(t,e,r,"error",{id:i.id,durationMs:Date.now()-u,error:A(l.message)}),l}}function A(t,e=200){const o=t.trim();return o.length<=e?o:`${o.slice(0,e)}\u2026`}function pt(t){const e=s;if(!e||!e.connection.isConnected())return Z.map(n=>({kind:"builtin",toolName:n,exposedName:n,description:`${n}\uFF08\u684C\u9762\u81EA\u52A8\u5316\u5DE5\u5177\uFF0Cnuphus-mcp \u672A\u8FD0\u884C\uFF09\u3002\u5206\u914D desktop \u5206\u7C7B\u540E\u6309\u9700\u542F\u52A8\u540E\u7AEF\uFF0C\u5177\u4F53\u5DE5\u5177\u4EE5\u542F\u52A8\u540E\u76EE\u5F55\u4E3A\u51C6\u3002`,inputSchema:{type:"object",properties:{}},category:"desktop",async execute(){const r=`${n} is not ready: nuphus-mcp backend is not running. Allocate the desktop catalog to lazily start it, then retry.`;return t?E(t,n,{},async()=>r):r}}));const o=e;return v({tools:o.tools,agentId:t,forwarder:(n,r)=>t?E(t,n,r,(a,i)=>o.forwarder(a,i)):o.forwarder(n,r),internalForwarder:(n,r)=>o.forwarder(n,r)})}const Z=["desktop_screenshot","desktop_window_screenshot","desktop_perceive","desktop_vision","desktop_input","desktop_mouse","desktop_mouse_drag","desktop_screen_size","desktop_clipboard_write","desktop_clipboard_clean","desktop_config","desktop_uia_tree","desktop_uia_click","desktop_window_activate","desktop_window_info","desktop_window_move","desktop_window_resize","desktop_windows_list"];async function tt(){const t=s;if(s=null,c=null,p){try{await p}catch{}p=null}t&&(await m(t.connection),w("nuphus-mcp stopped"))}function dt(){return{started:s!==null,binaryPath:s?.binaryPath??null,toolCount:s?s.tools.filter(t=>t.name.startsWith("desktop_")).length:0,failure:c,visionSource:k}}async function m(t){try{await t.close()}catch{}}function w(t){f.info(t)}function C(t){f.warn(t)}export{tt as disposeDesktopMcpManager,E as forwardDesktopToolGuarded,dt as getDesktopMcpStatus,ut as getDesktopTools,pt as getDesktopToolsIfReady,I as resolveDesktopMcpBinary,O as startDesktopMcpManager};
 

package/dist/services/event-delta-pusher.d.ts

@@ -1,4 +1,9 @@
 
+
+
+
+
+
 import { type BridgeEventPayload } from "./agent-event-store.js";
 import { type RingBufferEntry } from "./ring-buffer.js";
 export interface RuntimeCallbackAuthOptions {
@@ -15,10 +20,20 @@ export interface PushStatEntry {
     lastError?: string;
 }
 
+
+
+
 export declare function scheduleEventPush(agentId: string, _entry: RingBufferEntry<BridgeEventPayload>, _authOptions?: RuntimeCallbackAuthOptions): Promise<void>;
 
+
+
+
 export declare function startHeartbeatScheduler(): void;
 
+
+
 export declare function stopHeartbeatScheduler(): void;
 
+
+
 export declare function getAllPushStats(): PushStatEntry[];

package/dist/services/fileSnapshotStore.d.ts

@@ -1,4 +1,11 @@
 
+
+
+
+
+
+
+
 export interface SnapshotIndexEntry {
     
     backupName: string;
@@ -44,6 +51,13 @@ export interface SnapshotListItem {
     totalBytes: number;
 }
 
+
+
+
+
+
+
+
 export declare function createSnapshot(params: {
     workspacePath: string;
     snapshotId?: string;
@@ -51,19 +65,33 @@ export declare function createSnapshot(params: {
     triggerType?: string;
 }): Promise<CreateSnapshotResult>;
 
+
+
+
+
+
+
+
+
 export declare function restoreSnapshot(params: {
     workspacePath: string;
     snapshotKey: string;
     preRestoreBackup?: boolean;
 }): Promise<RestoreSnapshotResult>;
 
+
+
 export declare function listSnapshots(workspacePath: string): Promise<SnapshotListItem[]>;
 
+
+
 export declare function deleteSnapshot(snapshotKey: string): Promise<{
     ok: boolean;
     error?: string;
 }>;
 
+
+
 export declare function getSnapshotRootPath(): string;
 export interface SnapshotRetentionSweepResult {
     retentionDays: number | null;
@@ -73,4 +101,9 @@ export interface SnapshotRetentionSweepResult {
     bytesFreed: number;
 }
 
+
+
+
+
+
 export declare function sweepExpiredSnapshots(retentionDays: number | null): Promise<SnapshotRetentionSweepResult>;

package/dist/services/gitignore.d.ts

@@ -1,4 +1,9 @@
 
+
+
+
+
+
 export interface GitIgnoreRule {
     pattern: string;
     negated: boolean;
@@ -8,5 +13,9 @@ export interface GitIgnoreRule {
 }
 export declare function parseGitIgnoreRules(content: string): GitIgnoreRule[];
 
+
+
+
+
 export declare function loadGitIgnoreRules(rootPath: string): Promise<GitIgnoreRule[]>;
 export declare function isIgnoredByGitIgnore(relativePath: string, isDirectory: boolean, rules: GitIgnoreRule[]): boolean;

package/dist/services/instance-ai-config-service.d.ts

@@ -1,4 +1,10 @@
 
+
+
+
+
+
+
 export interface AdapterInstanceAiConfig {
     model?: string;
     baseURL?: string;
@@ -25,6 +31,9 @@ interface PrepareResult {
     perInstanceConfigPath: string;
 }
 
+
+
+
 export declare function redactForLog(obj: Record<string, unknown>): Record<string, unknown>;
 
 export declare function getAgentMcpExtraFilePath(agentId: string): string;

package/dist/services/instance-ai-config-service.js

@@ -1,2 +1,2 @@
-import p from"node:fs/promises";import U from"node:path";import{getBridgeInstanceConfigFile as A,getBridgeInstanceMcpExtraFile as F,getBridgeTemplateConfigFile as _}from"../config.js";import{getInstanceAiConfigDebugLogger as D}from"../utils/instance-ai-config-debug-logger.js";import{mcpDeployManager as O}from"./mcp-deploy.js";import{injectEffectiveEnvIntoMcpServers as M,isBuiltinMcpName as h}from"./mcp-env-injector.js";import{getPanelEnvVars as w,getAgentMeta as k}from"./panel-env.js";const P=new Set(["apiKey","api_key","apikey","key","secret","token","password"]);function x(e){const t={...e};for(const r of Object.keys(t))if(P.has(r)){const a=t[r];typeof a=="string"&&a.length>0&&(t[r]=a.length>8?`${a.slice(0,4)}...${a.slice(-4)}`:"***")}else typeof t[r]=="object"&&t[r]!==null&&(t[r]=x(t[r]));return t}function N(){return{...process.env.ACODE_MODEL?{model:process.env.ACODE_MODEL}:{},...process.env.ACODE_BASE_URL?{baseURL:process.env.ACODE_BASE_URL}:{},...process.env.ACODE_API_KEY?{apiKey:process.env.ACODE_API_KEY}:{},...process.env.ACODE_EFFORT?{effort:process.env.ACODE_EFFORT}:{}}}async function j(e){try{const t=await p.readFile(e,"utf-8"),o=JSON.parse(t).provider?.default,n=o?.options;return{...o?.model?{model:o.model}:{},...n?.baseURL||n?.baseUrl?{baseURL:n.baseURL||n.baseUrl}:{},...n?.apiKey?{apiKey:n.apiKey}:{}}}catch{return{}}}function v(e,t,r,a){return t!==void 0?"api":r!==void 0?"env":a!==void 0?"file":"default"}function C(e){return F(e)}async function B(e){try{const t=await p.readFile(C(e),"utf-8"),r=JSON.parse(t);return r.servers&&typeof r.servers=="object"?r.servers:{}}catch{return{}}}function z(e){return C(e)}async function G(e){const t=_(),r=A(e.agentId),a=e.apiOverrides??{},o=N(),n=await j(t),g=a.model??o.model??n.model,y=a.baseURL??o.baseURL??n.baseURL,u=a.apiKey??o.apiKey??n.apiKey,m=a.effort??o.effort,f={};g&&(f.model=g),y&&(f.baseURL=y),u&&(f.apiKey=u),m&&(f.effort=m);const R={model:v("model",a.model,o.model,n.model),baseURL:v("baseURL",a.baseURL,o.baseURL,n.baseURL),apiKey:v("apiKey",a.apiKey,o.apiKey,n.apiKey),effort:v("effort",a.effort,o.effort,void 0)},b=D();try{await p.mkdir(U.dirname(r),{recursive:!0});let c={};try{const i=await p.readFile(t,"utf-8");c=JSON.parse(i)}catch{}const s=JSON.parse(JSON.stringify(c)),E=s.provider??{},L=E.default??{},d=L.options??{};g&&(d.model=g),y&&(d.baseURL=y),u&&(d.apiKey=u),m&&(d.effort=m),L.options=d,E.default=L,s.provider=E;try{const i=s.mcpServers??{},I=O.resolveEnabledMcp(e.agentId,i),K=await B(e.agentId);for(const[l,S]of Object.entries(K))h(l)||(I[l]=S);M(I,w(e.agentId),{resolvePackageDir:l=>O.isPackageHealthy(l)?O.packageDir(l):void 0,agentMeta:k(e.agentId)}),s.mcpServers=I}catch(i){b.log({level:"error",category:"apply",message:`MCP \u80FD\u529B\u8FC7\u6EE4/\u79C1\u6709\u5408\u5E76\u5931\u8D25\uFF08fail-open\uFF0C\u4FDD\u6301\u539F\u914D\u7F6E\uFF09: ${i instanceof Error?i.message:String(i)}`,source:"bridge",agentId:e.agentId,sessionId:e.sessionId})}await p.writeFile(r,JSON.stringify(s,null,2),"utf-8"),b.log({level:"info",category:"apply",message:"per-instance acode.json \u5DF2\u5199\u5165",source:"bridge",agentId:e.agentId,sessionId:e.sessionId,details:{perInstanceConfigPath:r,source:R}})}catch(c){const s=c instanceof Error?c.message:String(c);b.log({level:"error",category:"apply",message:`per-instance acode.json \u5199\u5165\u5931\u8D25: ${s}`,source:"bridge",agentId:e.agentId})}return{instanceConfig:{config:f,source:R},perInstanceConfigPath:r}}export{z as getAgentMcpExtraFilePath,G as prepareAcodeInstanceConfig,x as redactForLog};
+import l from"node:fs/promises";import M from"node:path";import{getBridgeInstanceConfigFile as D,getBridgeInstanceMcpExtraFile as _,getBridgeTemplateConfigFile as U}from"../config.js";import{getInstanceAiConfigDebugLogger as k}from"../utils/instance-ai-config-debug-logger.js";import{getAgentOwner as K}from"./agent-ownership.js";import{McpDeployManager as P}from"./mcp-deploy.js";import{injectEffectiveEnvIntoMcpServers as x,isBuiltinMcpName as N}from"./mcp-env-injector.js";import{getPanelEnvVars as j,getAgentMeta as B}from"./panel-env.js";import{getUserAiConfigFile as J,isLegacyFallbackDisabled as T}from"./user-scope.js";const $=new Set(["apiKey","api_key","apikey","key","secret","token","password"]);function Y(e){const r={...e};for(const t of Object.keys(r))if($.has(t)){const a=r[t];typeof a=="string"&&a.length>0&&(r[t]=a.length>8?`${a.slice(0,4)}...${a.slice(-4)}`:"***")}else typeof r[t]=="object"&&r[t]!==null&&(r[t]=Y(r[t]));return r}function V(){return{...process.env.ACODE_MODEL?{model:process.env.ACODE_MODEL}:{},...process.env.ACODE_BASE_URL?{baseURL:process.env.ACODE_BASE_URL}:{},...process.env.ACODE_API_KEY?{apiKey:process.env.ACODE_API_KEY}:{},...process.env.ACODE_EFFORT?{effort:process.env.ACODE_EFFORT}:{}}}async function H(e){try{const r=await l.readFile(e,"utf-8"),o=JSON.parse(r).provider?.default,n=o?.options;return{...o?.model?{model:o.model}:{},...n?.baseURL||n?.baseUrl?{baseURL:n.baseURL||n.baseUrl}:{},...n?.apiKey?{apiKey:n.apiKey}:{}}}catch{return{}}}function L(e,r,t,a){return r!==void 0?"api":t!==void 0?"env":a!==void 0?"file":"default"}function w(e){return _(e)}async function q(e){try{const r=await l.readFile(w(e),"utf-8"),t=JSON.parse(r);return t.servers&&typeof t.servers=="object"?t.servers:{}}catch{return{}}}function ae(e){return w(e)}async function ne(e){const r=K(e.agentId);let a=r?J(r):"";if(!a)a=U();else try{await l.access(a)}catch{T()||(a=U())}const o=D(e.agentId),n=e.apiOverrides??{},s=V(),f=await H(a),m=n.model??s.model??f.model,v=n.baseURL??s.baseURL??f.baseURL,b=n.apiKey??s.apiKey??f.apiKey,E=n.effort??s.effort,g={};m&&(g.model=m),v&&(g.baseURL=v),b&&(g.apiKey=b),E&&(g.effort=E);const S={model:L("model",n.model,s.model,f.model),baseURL:L("baseURL",n.baseURL,s.baseURL,f.baseURL),apiKey:L("apiKey",n.apiKey,s.apiKey,f.apiKey),effort:L("effort",n.effort,s.effort,void 0)},I=k();try{await l.mkdir(M.dirname(o),{recursive:!0});let d={};try{const i=await l.readFile(a,"utf-8");d=JSON.parse(i)}catch{}const c=JSON.parse(JSON.stringify(d)),A=c.provider??{},C=A.default??{},p=C.options??{};m&&(p.model=m),v&&(p.baseURL=v),b&&(p.apiKey=b),E&&(p.effort=E),C.options=p,A.default=C,c.provider=A;try{const i=c.mcpServers??{},R=K(e.agentId),u=R?P.forScope(R):null,O=u?u.resolveEnabledMcp(e.agentId,i):i,F=await q(e.agentId);for(const[y,h]of Object.entries(F))N(y)||(O[y]=h);x(O,j(e.agentId),{resolvePackageDir:y=>u&&u.isPackageHealthy(y)?u.packageDir(y):void 0,agentMeta:B(e.agentId)}),c.mcpServers=O}catch(i){I.log({level:"error",category:"apply",message:`MCP \u80FD\u529B\u8FC7\u6EE4/\u79C1\u6709\u5408\u5E76\u5931\u8D25\uFF08fail-open\uFF0C\u4FDD\u6301\u539F\u914D\u7F6E\uFF09: ${i instanceof Error?i.message:String(i)}`,source:"bridge",agentId:e.agentId,sessionId:e.sessionId})}await l.writeFile(o,JSON.stringify(c,null,2),"utf-8"),I.log({level:"info",category:"apply",message:"per-instance acode.json \u5DF2\u5199\u5165",source:"bridge",agentId:e.agentId,sessionId:e.sessionId,details:{perInstanceConfigPath:o,source:S}})}catch(d){const c=d instanceof Error?d.message:String(d);I.log({level:"error",category:"apply",message:`per-instance acode.json \u5199\u5165\u5931\u8D25: ${c}`,source:"bridge",agentId:e.agentId})}return{instanceConfig:{config:g,source:S},perInstanceConfigPath:o}}export{ae as getAgentMcpExtraFilePath,ne as prepareAcodeInstanceConfig,Y as redactForLog};
 

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

@@ -1,5 +1,8 @@
 import type { ToolPermissionPolicy } from "@agentswork/acode";
 
+
+
+
 export type FeatureState = "disabled" | "collapsed" | "expanded";
 
 export declare function normalizeFeatureState(raw: unknown): FeatureState | undefined;
@@ -8,52 +11,164 @@ export declare const DESKTOP_FEATURE_KEY = "desktop";
 
 export declare const BROWSER_FEATURE_KEY = "browser";
 
+
+
+
+
+
 export declare const LAUNCH_ITEM_FEATURE_KEY = "agentSys.launchItem";
 
+
+
+
+
+
+
 export declare const HIRE_FEATURE_KEY = "agentSys.hire";
 
+
+
+
+
+
+
+
+
+
+
 export declare const SKILL_INSTALL_FEATURE_KEY = "agentSys.skillInstall";
 
+
+
+
+
+
+
+
+
+
+
+
 export declare const ABILITY_DEV_FEATURE_KEY = "agentSys.abilityDev";
 
+
+
+
+
+
+
 export declare const PENCIL_FEATURE_KEY = "pencil";
 
+
+
+
+
+
+
 export declare const DRAW_FEATURE_KEY = "draw";
 
+
+
+
+
+
+
+
 export declare const OFFICE_FEATURE_KEY = "office";
 
 export declare const COLLABORATION_FEATURE_KEY = "collaboration";
 
+
+
+
 export declare const COLLABORATION_TASK_FEATURE_KEY = "collaboration.task";
 
+
+
+
 export declare const COLLABORATION_MEETING_FEATURE_KEY = "collaboration.meeting";
 
+
+
+
 export declare const COLLABORATION_DEBUG_FEATURE_KEY = "collaboration.debug";
 
+
+
+
 export declare const COLLABORATION_FILE_HISTORY_FEATURE_KEY = "collaboration.fileHistory";
 
+
+
+
+
+
+
+
 export declare const EMAIL_FEATURE_KEY = "email";
 
+
+
+
+
+
+
+
+
 export declare const GROUP_KEY_TO_FEATURE: ReadonlyMap<string, string>;
 
+
+
+
+
 export declare function resolveGroupFeatureKey(key: string): string;
 
 export declare function setAgentFeatures(agentId: string, features: unknown): void;
 
 export declare function getAgentFeatures(agentId: string): Record<string, FeatureState>;
 
+
+
+
+
 export declare function setAgentInheritedFeatures(agentId: string, features: unknown): void;
 
 export declare function getAgentInheritedFeatures(agentId: string): Record<string, FeatureState>;
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 export declare function getFeatureState(agentId: string, key: string): FeatureState;
 
+
+
+
+
 export declare function isFeatureEnabled(agentId: string, key: string): boolean;
 
 export declare function clearAgentFeatures(agentId: string): void;
 
+
+
+
 export declare function getAgentToolPermissions(agentId: string): ToolPermissionPolicy | null;
 
+
+
+
+
+
 export declare function resolveAgentToolPermissions(agentId: string): ToolPermissionPolicy;
 
 export interface AgentCapabilities {
@@ -79,6 +194,18 @@ export declare function getAgentCapabilitiesInherited(agentId: string): AgentCap
 
 export declare function getAgentPluginSources(agentId: string): Record<string, AgentPluginSource> | null;
 
+
+
+
+
+
+
+
+
+
+
+
+
 export declare function isCapabilityEnabled(agentId: string, type: CapabilityType, name: string): boolean;
 
 export declare function instanceFeaturesCacheSize(): number;

package/dist/services/instance-features.js

@@ -1,2 +1,2 @@
-import{getEffective as P,hasAnyDefault as N}from"./capability-config.js";const D=new Set(["disabled","collapsed","expanded"]);function j(e){if(e===!0)return"expanded";if(e===!1)return"disabled";if(typeof e=="string"&&D.has(e))return e}const T={},re="desktop",v="browser",S="agentSys.launchItem",x="agentSys.hire",O="agentSys.skillInstall",R="agentSys.abilityDev",I="pencil",z="draw",G="office",H="collaboration",h="collaboration.task",L="collaboration.meeting",m="collaboration.debug",U="collaboration.fileHistory",k="email",J=new Set,V=new Set([v,I,z,G,S,x,O,R,h,L,m,U,k]),W=[["agentSys","agentSys."],[H,"collaboration."]],X=new Map([["task",h],["meeting",L],["debug",m],["fileHistory",U],["launch",S],["hire",x],["abilityMarket",O],["abilityDev",R]]);function ie(e){return X.get(e)??e}function q(e){for(const[t,n]of W)if(e.startsWith(n))return t}const Q=new Set,d=new Map,y=new Map,a=new Map,Z=["fileReadOutside","commandExecution","fileModification","fileModificationOutside"],$=new Set(["allow","ask","deny"]);function w(e){if(typeof e!="object"||e===null||Array.isArray(e))return null;const t=e,n={};let r=!1;for(const o of Z){const i=t[o];typeof i=="string"&&$.has(i)?(n[o]=i,r=!0):n[o]="allow"}return r?n:null}function K(e){if(e==null)return{...T};let t=e;if(typeof e=="string")try{t=JSON.parse(e)}catch{t=null}if(typeof t!="object"||t===null||Array.isArray(t))return{...T};const n={};for(const[r,o]of Object.entries(t)){if(Q.has(r))continue;const i=j(o);i!==void 0&&(n[r]=i)}return n}function se(e,t){if(!e)return;d.set(e,K(t));let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n=="object"&&n!==null&&!Array.isArray(n)){const r=w(n.toolPermissions);r?a.set(e,r):a.delete(e)}else a.delete(e)}function ee(e){return d.get(e)??{...T}}function le(e,t){if(!e)return;if(t==null){y.delete(e);return}const n=K(t);if(Object.keys(n).length===0){y.delete(e);return}y.set(e,n)}function te(e){return y.get(e)??{}}function ne(e,t){const n=ee(e),r=te(e),o=q(t);if(o&&(n[o]??r[o])==="disabled")return"disabled";const i=n[t]??r[t];return i!==void 0?i:J.has(t)?"expanded":V.has(t)?"collapsed":"disabled"}function ue(e,t){return ne(e,t)!=="disabled"}function ce(e){d.delete(e),a.delete(e),f.delete(e),_.delete(e)}function fe(e){return a.get(e)??null}function ae(e){return a.get(e)??{fileReadOutside:"allow",commandExecution:"allow",fileModification:"allow",fileModificationOutside:"allow"}}const M=["skills","mcp","plugins"],f=new Map,_=new Map;function Y(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const t={};for(const[n,r]of Object.entries(e))n.trim()&&typeof r=="boolean"&&(t[n.trim()]=r);return t}function pe(e,t){if(!e)return;if(t==null){f.delete(e);return}let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n!="object"||n===null||Array.isArray(n)){f.delete(e);return}const r=n,o={};let i=!1;for(const E of M){const l=Y(r[E]);l&&(o[E]=l,i=!0)}i?f.set(e,o):f.delete(e);const s=r.plugins,u={};let b=!1;if(typeof s=="object"&&s!==null&&!Array.isArray(s))for(const[E,l]of Object.entries(s)){const A=E.trim();if(A){if(typeof l=="boolean"){const c=o.plugins??{};c[A]=l,o.plugins=c,i=!0;continue}if(l!==null&&typeof l=="object"&&!Array.isArray(l)){const c=l,B=c.enabled!==!1,g=typeof c.url=="string"?c.url:void 0,C=typeof c.sha256=="string"?c.sha256:void 0,F=o.plugins??{};F[A]=B,o.plugins=F,i=!0,g&&(u[A]={url:g,sha256:C},b=!0)}}}b?_.set(e,u):_.delete(e)}function Ee(e){return f.get(e)??null}const p=new Map;function Ae(e,t){if(!e)return;if(t==null){p.delete(e);return}let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n!="object"||n===null||Array.isArray(n)){p.delete(e);return}const r=n,o={};let i=!1;for(const s of M){const u=Y(r[s]);u&&(o[s]=u,i=!0)}i?p.set(e,o):p.delete(e)}function de(e){return p.get(e)??null}function ye(e){return _.get(e)??null}function _e(e,t,n){if(N(t))return P(e,t,n);const o=p.get(e)?.[t]?.[n];if(o!==void 0)return o;const i=f.get(e);if(!i)return!0;const s=i[t];if(!s)return!0;const u=s[n];return u===void 0?!0:u}function Te(){return d.size}export{R as ABILITY_DEV_FEATURE_KEY,v as BROWSER_FEATURE_KEY,M as CAPABILITY_TYPES,m as COLLABORATION_DEBUG_FEATURE_KEY,H as COLLABORATION_FEATURE_KEY,U as COLLABORATION_FILE_HISTORY_FEATURE_KEY,L as COLLABORATION_MEETING_FEATURE_KEY,h as COLLABORATION_TASK_FEATURE_KEY,re as DESKTOP_FEATURE_KEY,z as DRAW_FEATURE_KEY,k as EMAIL_FEATURE_KEY,X as GROUP_KEY_TO_FEATURE,x as HIRE_FEATURE_KEY,S as LAUNCH_ITEM_FEATURE_KEY,G as OFFICE_FEATURE_KEY,I as PENCIL_FEATURE_KEY,O as SKILL_INSTALL_FEATURE_KEY,ce as clearAgentFeatures,Ee as getAgentCapabilities,de as getAgentCapabilitiesInherited,ee as getAgentFeatures,te as getAgentInheritedFeatures,ye as getAgentPluginSources,fe as getAgentToolPermissions,ne as getFeatureState,Te as instanceFeaturesCacheSize,_e as isCapabilityEnabled,ue as isFeatureEnabled,j as normalizeFeatureState,ae as resolveAgentToolPermissions,ie as resolveGroupFeatureKey,pe as setAgentCapabilities,Ae as setAgentCapabilitiesInherited,se as setAgentFeatures,le as setAgentInheritedFeatures};
+import{getAgentOwner as P}from"./agent-ownership.js";import{getEffective as N,hasAnyDefault as D}from"./capability-config.js";const j=new Set(["disabled","collapsed","expanded"]);function v(e){if(e===!0)return"expanded";if(e===!1)return"disabled";if(typeof e=="string"&&j.has(e))return e}const b={},se="desktop",I="browser",S="agentSys.launchItem",x="agentSys.hire",O="agentSys.skillInstall",R="agentSys.abilityDev",z="pencil",G="draw",H="office",k="collaboration",h="collaboration.task",m="collaboration.meeting",L="collaboration.debug",U="collaboration.fileHistory",J="email",V=new Set,W=new Set([I,z,G,H,S,x,O,R,h,m,L,U,J]),X=[["agentSys","agentSys."],[k,"collaboration."]],q=new Map([["task",h],["meeting",m],["debug",L],["fileHistory",U],["launch",S],["hire",x],["abilityMarket",O],["abilityDev",R]]);function le(e){return q.get(e)??e}function w(e){for(const[t,n]of X)if(e.startsWith(n))return t}const Q=new Set,y=new Map,_=new Map,a=new Map,Z=["fileReadOutside","commandExecution","fileModification","fileModificationOutside"],$=new Set(["allow","ask","deny"]);function ee(e){if(typeof e!="object"||e===null||Array.isArray(e))return null;const t=e,n={};let o=!1;for(const r of Z){const i=t[r];typeof i=="string"&&$.has(i)?(n[r]=i,o=!0):n[r]="allow"}return o?n:null}function K(e){if(e==null)return{...b};let t=e;if(typeof e=="string")try{t=JSON.parse(e)}catch{t=null}if(typeof t!="object"||t===null||Array.isArray(t))return{...b};const n={};for(const[o,r]of Object.entries(t)){if(Q.has(o))continue;const i=v(r);i!==void 0&&(n[o]=i)}return n}function ue(e,t){if(!e)return;y.set(e,K(t));let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n=="object"&&n!==null&&!Array.isArray(n)){const o=ee(n.toolPermissions);o?a.set(e,o):a.delete(e)}else a.delete(e)}function te(e){return y.get(e)??{...b}}function ce(e,t){if(!e)return;if(t==null){_.delete(e);return}const n=K(t);if(Object.keys(n).length===0){_.delete(e);return}_.set(e,n)}function ne(e){return _.get(e)??{}}function oe(e,t){const n=te(e),o=ne(e),r=w(t);if(r&&(n[r]??o[r])==="disabled")return"disabled";const i=n[t]??o[t];return i!==void 0?i:V.has(t)?"expanded":W.has(t)?"collapsed":"disabled"}function fe(e,t){return oe(e,t)!=="disabled"}function ae(e){y.delete(e),a.delete(e),f.delete(e),T.delete(e)}function pe(e){return a.get(e)??null}function Ee(e){return a.get(e)??{fileReadOutside:"allow",commandExecution:"allow",fileModification:"allow",fileModificationOutside:"allow"}}const M=["skills","mcp","plugins"],f=new Map,T=new Map;function Y(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const t={};for(const[n,o]of Object.entries(e))n.trim()&&typeof o=="boolean"&&(t[n.trim()]=o);return t}function Ae(e,t){if(!e)return;if(t==null){f.delete(e);return}let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n!="object"||n===null||Array.isArray(n)){f.delete(e);return}const o=n,r={};let i=!1;for(const A of M){const l=Y(o[A]);l&&(r[A]=l,i=!0)}i?f.set(e,r):f.delete(e);const s=o.plugins,u={};let E=!1;if(typeof s=="object"&&s!==null&&!Array.isArray(s))for(const[A,l]of Object.entries(s)){const d=A.trim();if(d){if(typeof l=="boolean"){const c=r.plugins??{};c[d]=l,r.plugins=c,i=!0;continue}if(l!==null&&typeof l=="object"&&!Array.isArray(l)){const c=l,B=c.enabled!==!1,g=typeof c.url=="string"?c.url:void 0,C=typeof c.sha256=="string"?c.sha256:void 0,F=r.plugins??{};F[d]=B,r.plugins=F,i=!0,g&&(u[d]={url:g,sha256:C},E=!0)}}}E?T.set(e,u):T.delete(e)}function de(e){return f.get(e)??null}const p=new Map;function ye(e,t){if(!e)return;if(t==null){p.delete(e);return}let n=t;if(typeof t=="string")try{n=JSON.parse(t)}catch{n=null}if(typeof n!="object"||n===null||Array.isArray(n)){p.delete(e);return}const o=n,r={};let i=!1;for(const s of M){const u=Y(o[s]);u&&(r[s]=u,i=!0)}i?p.set(e,r):p.delete(e)}function _e(e){return p.get(e)??null}function Te(e){return T.get(e)??null}function be(e,t,n){const o=P(e);if(D(o,t))return N(o,e,t,n);const i=p.get(e)?.[t]?.[n];if(i!==void 0)return i;const s=f.get(e);if(!s)return!0;const u=s[t];if(!u)return!0;const E=u[n];return E===void 0?!0:E}function ge(){return y.size}export{R as ABILITY_DEV_FEATURE_KEY,I as BROWSER_FEATURE_KEY,M as CAPABILITY_TYPES,L as COLLABORATION_DEBUG_FEATURE_KEY,k as COLLABORATION_FEATURE_KEY,U as COLLABORATION_FILE_HISTORY_FEATURE_KEY,m as COLLABORATION_MEETING_FEATURE_KEY,h as COLLABORATION_TASK_FEATURE_KEY,se as DESKTOP_FEATURE_KEY,G as DRAW_FEATURE_KEY,J as EMAIL_FEATURE_KEY,q as GROUP_KEY_TO_FEATURE,x as HIRE_FEATURE_KEY,S as LAUNCH_ITEM_FEATURE_KEY,H as OFFICE_FEATURE_KEY,z as PENCIL_FEATURE_KEY,O as SKILL_INSTALL_FEATURE_KEY,ae as clearAgentFeatures,de as getAgentCapabilities,_e as getAgentCapabilitiesInherited,te as getAgentFeatures,ne as getAgentInheritedFeatures,Te as getAgentPluginSources,pe as getAgentToolPermissions,oe as getFeatureState,ge as instanceFeaturesCacheSize,be as isCapabilityEnabled,fe as isFeatureEnabled,v as normalizeFeatureState,Ee as resolveAgentToolPermissions,le as resolveGroupFeatureKey,Ae as setAgentCapabilities,ye as setAgentCapabilitiesInherited,ue as setAgentFeatures,ce as setAgentInheritedFeatures};
 

package/dist/services/instance-init-service.d.ts

@@ -1,4 +1,5 @@
 import type { InitLogEntry, LegacyMcpStateItem, LegacySkillStateItem, McpPayload, PluginPackage, SkillPackage } from '../types.js';
+import type { UserScope } from './user-scope.js';
 export declare function initInstance(agentId: string, workspacePath: string, options: {
     skillEnabled?: boolean;
     mcpEnabled?: boolean;
@@ -7,6 +8,8 @@ export declare function initInstance(agentId: string, workspacePath: string, opt
     skillPackages?: SkillPackage[];
     pluginPackages?: PluginPackage[];
     mcpServers?: McpPayload[];
+    
+    scope?: UserScope;
 }): Promise<{
     ok: boolean;
     agentId: string;