grix-connector 5.0.0 → 5.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/manager.js CHANGED
@@ -1 +1 @@
1
- import{join as b}from"node:path";import{homedir as W}from"node:os";import{AgentInstance as K}from"./bridge/bridge.js";import{isCwdLockedClientType as he,resolveStaticCwd as ue}from"./bridge/cwd-policy.js";import{buildSharedInstanceConfig as me,diffSharedOwners as ge,sharedInstanceKey as fe,SharedOwnersCache as _e}from"./manager-share-config.js";import{AgentDeletedError as we,isAgentDeletedError as $}from"./core/aibot/errors.js";import{GRIX_PATHS as A,log as m}from"./core/log/index.js";import{resolveClientVersion as ye}from"./core/util/client-version.js";import{mergeLoginShellPathIntoProcess as Ae}from"./core/util/cli-probe.js";import{UpgradeChecker as Se}from"./core/upgrade/upgrade-checker.js";import{SkillSyncer as ke}from"./core/skill-sync/skill-syncer.js";import{AgentGlobalConfigStore as be}from"./core/persistence/agent-global-config-store.js";import{resolveSkillScanMode as ve}from"./adapter/claude/skill-scanner.js";import{resolveClaudeConfigPaths as Ce}from"./adapter/claude/config-paths.js";import{buildWireSkills as Ie}from"./core/skill-sync/sync-state.js";import{buildLibrarySkills as Ee}from"./core/skill-sync/library-skills.js";import{AUDIT_LOCAL_ACTION_TYPES as $e}from"./core/aibot/types.js";import{buildReportedSkills as Pe,logDefaultSkillsCheck as Te,cleanupProjectedSkills as z}from"./default-skills/index.js";import{buildProviderEnv as Me,supportsKiroCwRelay as Q,supportsNonMitmRelayConfig as xe}from"./core/config/provider-env.js";import{resolveHermesHomeDir as De}from"./adapter/shared/native-provider-config.js";import{ensureKiroRelay as V,stopKiroRelay as X}from"./core/proxy/kiro-relay.js";import{resolveCopilotCommand as Oe}from"./core/runtime/copilot-resolve.js";import{resolveCursorCommand as Re}from"./core/runtime/cursor-resolve.js";import{probeInstalledClientCommands as Y}from"./core/probe/installed-clients.js";import{AgentInstaller as je}from"./core/installer/installer.js";import{reportInstallFailure as Le}from"./core/observability/sentry.js";import{createDefaultAuditProducer as Ne}from"./audit/runtime/default-audit-recorder.js";import{normalizeCodexConfigOverrides as qe}from"./adapter/codex/config-overrides.js";import{ACP_NEW_SESSION_RESERVED_KEYS as Ge}from"./protocol/acp-client.js";import{resolveCodexDirectHome as Ue}from"./adapter/codex/direct-home.js";import{AgentConfigRepository as J}from"./core/config/agent-config-repository.js";import{expandHomePath as Be}from"./core/config/paths.js";function Z(a){if(a)return{...a.provider_id?.trim()?{providerId:a.provider_id.trim()}:{},...a.base_url?.trim()?{baseUrl:a.base_url.trim()}:{},...a.quota_base_url?.trim()?{quotaBaseUrl:a.quota_base_url.trim()}:{},...a.api_key?.trim()?{apiKey:a.api_key.trim()}:{},...a.quota_api_key?.trim()?{quotaApiKey:a.quota_api_key.trim()}:{},...a.model?.trim()?{model:a.model.trim()}:{},...a.fast_model?.trim()?{fastModel:a.fast_model.trim()}:{},...a.effort?.trim()?{effort:a.effort.trim()}:{}}}const He=8e3,Fe=1e4,We=8e3;function Ke(a,e){switch(a){case"claude":return{adapterType:"claude",command:"claude"};case"codex":return{adapterType:"codex",command:"codex",options:{sandboxMode:"danger-full-access"}};case"gemini":return{adapterType:"acp",command:"gemini",autoInjectArgs:{acp:!0},enableSessionBinding:!0};case"qwen":return{adapterType:"acp",command:"qwen",adapterHint:"qwen/base",autoInjectArgs:{acp:!0},enableSessionBinding:!0};case"pi":return{adapterType:"pi",command:"pi"};case"omp":return{adapterType:"pi",command:"omp",adapterHint:"omp/base",env:{PI_CODING_AGENT_DIR:b(W(),".omp","agent")}};case"cursor":return{adapterType:"cursor",command:Re()};case"reasonix":return{adapterType:"acp",command:"reasonix",args:["acp"],enableSessionBinding:!0};case"codewhale":return{adapterType:"codewhale",command:"codewhale",enableSessionBinding:!0};case"openhuman":return{adapterType:"openhuman",command:"openhuman-core",enableSessionBinding:!0};case"kiro":return{adapterType:"acp",command:"kiro-cli",args:["acp"],enableSessionBinding:!0};case"kimi":return{adapterType:"acp",command:"kimi",args:["acp"],options:{initial_mode:"yolo"},enableSessionBinding:!0};case"qodercli":return{adapterType:"acp",command:"qodercli",args:["--yolo","--acp"],enableSessionBinding:!0};case"qoderclicn":return{adapterType:"acp",command:"qoderclicn",args:["--yolo","--acp"],enableSessionBinding:!0};case"mcode":return{adapterType:"acp",command:"mcode",args:["acp"],enableSessionBinding:!0};case"dim":return{adapterType:"acp",command:"dim",args:["acp"],enableSessionBinding:!0};case"opencode":return{adapterType:"opencode",command:"opencode",args:["serve"],enableSessionBinding:!0};case"deveco":return{adapterType:"opencode",command:"deveco",args:["serve"],adapterHint:"deveco/base",enableSessionBinding:!0};case"copilot":{const n=Oe();return{adapterType:"acp",command:n.command,args:[...n.prefixArgs,"--acp"],enableSessionBinding:!0}}case"agy":return{adapterType:"agy",command:"agy",enableSessionBinding:!0};case"deepseek":return{adapterType:"deepseek-harness",command:"dsh",adapterHint:"deepseek/grix-bridge-v1",options:{integrationMode:"profile_bridge",dshProfile:"web",autoInstallBridge:!0,autoStartProfile:!0},enableSessionBinding:!0};case"hermes":return{adapterType:"acp",command:"hermes",args:["acp"],enableSessionBinding:!0};case"traecli":return{adapterType:"acp",command:"traecli",args:["acp","serve"],adapterHint:"traecli/base",options:{initial_mode:"bypass_permissions"},enableSessionBinding:!0};case"codebuddy":return{adapterType:"acp",command:"codebuddy",args:["--acp"],adapterHint:"codebuddy/base",enableSessionBinding:!0};case"grok":return{adapterType:"acp",command:"grok",args:["--no-auto-update","agent","--always-approve","stdio"],enableSessionBinding:!0};case"qwenpaw":return{adapterType:"acp",command:"qwenpaw",args:["acp"],enableSessionBinding:!0};case"zeroclaw":return{adapterType:"acp",command:"zeroclaw",args:["acp"],enableSessionBinding:!0};case"acp":{const n=typeof e?.command=="string"?e.command.trim():"";if(!n)throw new Error(`agent ${e?.name??"<unknown>"}: client_type=acp requires "command" (the ACP CLI executable) in the agent config; put its ACP subcommand or flag in "args"`);return{adapterType:"acp",command:n,adapterHint:"acp/base",enableSessionBinding:!0}}default:throw new Error(`Unsupported client_type: ${a}`)}}function C(a,e){return String(a??"").trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")||String(e??"").trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")||"default"}function ze(a){return b(A.data,`session-bindings-${C(a,"unknown")}.json`)}function Qe(a,e){return b(A.data,`session-bindings-${C(a,e)}.json`)}function Ve(a,e){return b(A.data,`active-events-${C(a,e)}.json`)}function Xe(a){return b(A.data,`pending-events-${C(a,"unknown")}.json`)}function Ye(a,e){const n=C(a,"agent"),t=C(e,"unknown");return b(A.data,`terminal-outbox-${n}-${t}.json`)}function Je(a,e,n={}){const t=a?{...a,...e}:e;if(t)return Object.fromEntries(Object.entries(t).map(([s,r])=>[s,Be(r,n)]))}function Ze(...a){const e=[],n=new Set;for(const t of a)for(const s of t??[]){const r=String(s??"").trim(),c=r.toLowerCase();!r||n.has(c)||(n.add(c),e.push(r))}return e.length>0?e:void 0}function et(a,e){const n={claude:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},codex:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},cursor:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},acp:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},pi:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},codewhale:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},openhuman:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},opencode:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},agy:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},"deepseek-harness":{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0}},t=n[a]??n.acp;let s=e?.max_concurrent??t.maxConcurrent??1;return a==="acp"&&s>1&&(m.warn("manager",`ACP adapter supports only one active run at a time; clamping max_concurrent from ${s} to 1`),s=1),{maxConcurrent:s,maxQueued:e?.max_queued??t.maxQueued??99,queueTimeoutMs:e?.queue_timeout_ms??t.queueTimeoutMs??0,cancelableQueued:!0,cancelableRunning:!0}}function tt(a,e={}){const n=ye(),t=String(a.client_type??"").trim().toLowerCase(),s=Ke(t,a),r=t==="deepseek"?a.dsh?.integration_mode??"profile_bridge":void 0,c=r==="embedded_jsonrpc",o=String(a.ws_url??"").trim(),u=typeof a.name=="string"?a.name:"",i=u.trim(),l="get_session_usage",g="get_rate_limits",p="get_agent_global_config",d=$e;if(!i)throw new Error("agent name is required");if(u!==i)throw new Error(`agent name must not contain leading or trailing whitespace: "${u}"`);if(!o)throw new Error(`agent ${a.name}: ws_url is required`);if(!a.agent_id?.trim())throw new Error(`agent ${a.name}: agent_id is required`);if(!a.api_key?.trim())throw new Error(`agent ${a.name}: api_key is required`);const h=s.adapterType,_=h==="acp",w=t==="qwen",y={...s.options??{}};if(h==="deepseek-harness"&&(y.integrationMode=r,y.dshProfile=a.dsh?.profile?.trim()||"web",y.autoInstallBridge=a.dsh?.auto_install_bridge??!c,y.autoStartProfile=a.dsh?.auto_start_profile??!c),h==="deepseek-harness"&&a.provider?.model?.trim()&&(y.defaultModel=a.provider.model.trim()),a.codex_config_overrides!==void 0){if(h!=="codex")throw new Error(`agent ${a.name}: codex_config_overrides is only supported for client_type=codex`);qe(a.codex_config_overrides,`agent ${a.name}: codex_config_overrides`),y.codexConfigOverrides=a.codex_config_overrides}if(a.acp_new_session_params!==void 0){if(!_)throw new Error(`agent ${a.name}: acp_new_session_params is only supported for ACP-based client types`);const f=a.acp_new_session_params;if(typeof f!="object"||f===null||Array.isArray(f))throw new Error(`agent ${a.name}: acp_new_session_params must be a JSON object`);const k=Object.keys(f).find(pe=>Ge.has(pe));if(k)throw new Error(`agent ${a.name}: acp_new_session_params cannot set reserved field "${k}" (Grix owns cwd/mcpServers/sessionId/additionalDirectories on every session/new)`);y.newSessionParams=f}if(t==="zeroclaw"){const k=a.acp_new_session_params?.agentAlias;if(typeof k!="string"||!k.trim()||k.trim().startsWith("<REPLACE"))throw new Error(`agent ${a.name}: client_type=zeroclaw requires acp_new_session_params.agentAlias (create one with \`zeroclaw agents create <alias>\` and set it in the agent config); without it session/new fails with -32602 and the connector would silently respawn-retry forever`)}if(h==="codex"&&a.provider?.wire_api!==void 0){const f=a.provider;if(f.wire_api!=="responses"||!f.base_url?.trim()||!f.api_key?.trim()||!f.model?.trim()||!f.catalog_version?.trim()||!f.catalog_sha256?.trim()||!f.catalog_json?.trim())throw Object.assign(new Error(`agent ${a.name}: incomplete Codex direct relay config`),{code:"INVALID_CODEX_DIRECT_CONFIG"});const k=Ue(A.data,a.name);y.codexHome=k,y.codexDirect={codexHome:k,config:{baseUrl:f.base_url.trim(),model:f.model.trim(),...f.reasoning_effort?.trim()?{reasoningEffort:f.reasoning_effort.trim()}:{},token:f.api_key.trim()},catalog:{version:f.catalog_version.trim(),sha256:f.catalog_sha256.trim(),json:f.catalog_json}}}const S=h==="codex"?{capabilities:["stream_chunk","local_action_v1","agent_invoke"],localActions:["session_control","get_context","set_model","set_mode","set_reasoning_effort","set_service_tier","set_sandbox_mode","exec_approve","exec_reject","file_list","create_folder","turn_interrupt","permission_approve","permission_reject","thread_compact",l,g]}:null,te=h==="claude"?{localActions:["session_control","set_mode","set_model","set_reasoning_effort","claude_interaction_reply","exec_approve","exec_reject","file_list","create_folder","thread_compact",l,g]}:null,M=w?{capabilities:["stream_chunk","local_action_v1"],localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","file_list","create_folder",l],adapterHint:"qwen/base"}:null,x=h==="pi"?{adapterHint:"pi/base",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_provider","set_model","get_context","file_list","create_folder",l,g]}:null,D=h==="openhuman"?{adapterHint:"openhuman/base",capabilities:["local_action_v1"],localActions:["session_control","set_model","file_list","create_folder"]}:null,O=h==="cursor"?{adapterHint:"cursor/base",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_model","set_mode","get_context","file_list","create_folder","thread_compact","claude_interaction_reply",g]}:null,q=h==="codewhale"?{capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_model","file_list","create_folder",l]}:null,R=h==="opencode"?{adapterHint:"opencode/base",capabilities:["stream_chunk","local_action_v1"],localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","claude_interaction_reply","file_list","create_folder"]}:null,j=h==="agy"?{adapterHint:"agy/base",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_model","file_list","create_folder",g]}:null,L=h==="deepseek-harness"?{adapterHint:c?"deepseek/jsonrpc-v1":"deepseek/grix-bridge-v1",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_provider","set_model","set_mode","set_thinking","set_reasoning_effort","set_preset","set_profile","create_profile",l,g,"exec_approve","exec_reject","permission_approve","permission_reject","file_list","create_folder","dsh_bridge_status","dsh_install_bridge","dsh_list_plugins","dsh_enable_plugin","dsh_disable_plugin","dsh_refresh_plugins","dsh_list_skills","dsh_enable_skill","dsh_disable_skill","dsh_list_mcp","dsh_list_tools","dsh_list_jobs","dsh_list_goals"]}:null,G=new Set(["hermes","reasonix","kimi","copilot","acp","qodercli","qoderclicn","mcode","dim","traecli","grok","qwenpaw","zeroclaw","codebuddy"]),ne=_&&!G.has(t),se=_&&!w?{localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","claude_interaction_reply","file_list","create_folder",...t==="kimi"?["set_reasoning_effort"]:[],...ne?[l]:[]]}:null,ae=t==="kiro"?{localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","file_list","create_folder","thread_compact",l,g]}:null,re=h==="codex"||h==="claude"||h==="opencode"||h==="deepseek-harness"||t==="gemini"?["session_control","set_model","set_mode",...h==="deepseek-harness"?["set_provider","set_thinking","set_reasoning_effort","set_preset","set_profile","create_profile","dsh_list_plugins","dsh_enable_plugin","dsh_disable_plugin","dsh_refresh_plugins","dsh_list_skills","dsh_enable_skill","dsh_disable_skill"]:[],...h==="claude"?["set_reasoning_effort"]:[]]:void 0,ie=h==="cursor"||h==="opencode"||h==="openhuman"||h==="agy"||_&&G.has(t)?[g]:[l,g];_&&y.raw_transport===void 0&&(y.raw_transport=t==="gemini");const oe=`${t}/base`,I=ve(h,t),ce=I==="kiro"?void 0:process.cwd(),N=Z(a.provider),U=Je(s.env,a.env),v={...process.env,...U};if(I==="hermes"&&!v.HERMES_HOME?.trim()){const f=Me(t,N);v.HERMES_HOME=De({...f,...v},a.name)}const E=h==="claude"?Ce(v):void 0,B=Pe({mode:I,projectDir:ce,env:v,claudeConfigPaths:E}),H=B.filter(f=>f.source==="connector").map(f=>f.name);H.length>0&&!e.quiet&&m.info("manager",`[${a.name}] injecting connector skills: [${H.join(", ")}]`);const F=Ie(B,A.skills);let le=F.length>0?F:void 0;const de=Ee({skillsDir:A.skills,mode:I,home:W(),env:v,claudeConfigPaths:E});return{name:i,adapterType:h,...E?{claudeConfigPaths:E}:{},aibot:{url:o,agentId:a.agent_id,apiKey:a.api_key,clientType:t,clientVersion:n,adapterHint:L?.adapterHint??s.adapterHint??M?.adapterHint??x?.adapterHint??D?.adapterHint??O?.adapterHint??R?.adapterHint??j?.adapterHint??oe,capabilities:L?.capabilities??S?.capabilities??q?.capabilities??x?.capabilities??D?.capabilities??O?.capabilities??R?.capabilities??j?.capabilities??M?.capabilities??["stream_chunk","local_action_v1","connector_upgrade"],localActions:Ze(L?.localActions??S?.localActions??q?.localActions??te?.localActions??x?.localActions??D?.localActions??O?.localActions??R?.localActions??j?.localActions??M?.localActions??ae?.localActions??se?.localActions??["exec_approve","exec_reject"],re,ie,["connector_rollback","connector_upgrade_push",p,"configure_gateway_provider","skill_upload","skill_delete","skill_enable","skill_disable","skill_refresh",...d]),skills:le,librarySkills:de,terminalOutboxPath:Ye(a.name,a.agent_id)},agent:{command:c?"dsh-jsonrpc-agent":s.command,args:[...s.args??[],...a.args??[]],env:U,clientType:t,...N?{provider:N}:{}},adapterOptions:y,acpAuthMethod:y.auth_method,acpInitialMode:y.initial_mode,acpMcpTools:y.acp_mcp_tools,promptTimeoutMs:a.prompt_timeout_ms,bindingsPath:ze(a.agent_id),legacyBindingsPath:Qe(a.name,a.agent_id),activeEventStorePath:Ve(a.name,a.agent_id),pendingEventStorePath:Xe(a.agent_id),...s.enableSessionBinding||_?{enableSessionBinding:!0}:{},...he(t)?{staticCwd:ue(a.cwd)}:{},...s.autoInjectArgs||t==="reasonix"&&a.provider?.model?.trim()?{autoInjectArgs:{...s.autoInjectArgs??{},...t==="reasonix"&&a.provider?.model?.trim()?{model:a.provider.model.trim()}:{}}}:{},poolMaxSize:a.pool?.maxSize??(h==="deepseek-harness"?4:void 0),poolIdleTimeoutMs:a.pool?.idleTimeoutMs,eventQueue:et(h,a.event_queue),logDir:A.log,providerBaseUrl:a.provider_base_url?.trim()||void 0,providerApiKey:a.provider_api_key?.trim()||void 0}}function ee(){const a=process.env.GRIX_AGENT_STARTUP_WAIT_MS,e=Number(a);return Number.isFinite(e)&&e>=500?Math.floor(e):He}function P(){const a=process.env.GRIX_AGENT_STOP_WAIT_MS,e=Number(a);return Number.isFinite(e)&&e>=500?Math.floor(e):Fe}function nt(){return Math.min(P(),We)}function T(a){if(a===null||typeof a!="object")return JSON.stringify(a)??"null";if(Array.isArray(a))return`[${a.map(T).join(",")}]`;const e=a;return`{${Object.keys(e).sort().map(t=>`${JSON.stringify(t)}:${T(e[t])}`).join(",")}}`}function st(a,e){return T(a)===T(e)}class Nt{options;instances=[];configMap=new Map;rawConfigMap=new Map;mutationTail=Promise.resolve();startingInstances=new Set;failedStartAgents=new Set;removingAgents=new Set;instanceGenerations=new WeakMap;sharedInstances=new Map;shareSyncChains=new Map;stopping=!1;lifecycleAdmissionClosed=!1;deletedAgentCleanups=new Set;pendingPlatformDeletes=new Map;upgradeChecker=null;skillSyncer=null;globalConfigStore;configRepository=new J(A.config);sharedOwnersCache=new _e(A.data);installer=new je;relaySecretResolver;auditProducer=Ne();constructor(e={}){this.options=e}runMutation(e,n=[]){const t=this.mutationTail.catch(()=>{}).then(async()=>{if(this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});await this.retryPendingPlatformDeletesUnlocked();const s=new Set([...this.pendingPlatformDeletes.values()].map(c=>c.name)),r=n.find(c=>s.has(c.trim()));if(r)throw Object.assign(new Error(`Agent "${r}" is pending permanent platform-deletion cleanup`),{code:"AGENT_DELETE_PENDING"});return e()});return this.mutationTail=t.then(()=>{},()=>{}),t}async startTrackedInstance(e){this.startingInstances.add(e);try{await e.start()}finally{this.startingInstances.delete(e)}}requestStartCancellation(e){const n=e.requestStop;typeof n=="function"&&n.call(e)}async stopInstance(e,n,t=P()){let s;try{await Promise.race([e.stop(n),new Promise((r,c)=>{s=setTimeout(()=>{c(Object.assign(new Error(`Agent "${e.name}" stop timed out after ${t}ms`),{code:"AGENT_STOP_TIMEOUT"}))},t)})])}finally{s!==void 0&&clearTimeout(s)}}async waitForLifecycleDrain(e,n,t=P()){let s;try{await Promise.race([Promise.allSettled([...e]).then(()=>{}),new Promise((r,c)=>{s=setTimeout(()=>{c(Object.assign(new Error(`${n} timed out after ${t}ms`),{code:"LIFECYCLE_DRAIN_TIMEOUT"}))},t)})])}finally{s!==void 0&&clearTimeout(s)}}async waitForShutdownOperation(e,n,t){let s;try{return await Promise.race([e,new Promise((r,c)=>{s=setTimeout(()=>{c(Object.assign(new Error(`${n} timed out after ${t}ms`),{code:"SHUTDOWN_OPERATION_TIMEOUT"}))},t)})])}finally{s!==void 0&&clearTimeout(s)}}isActiveGeneration(e){const n=this.instanceGenerations.get(e);return!!n&&!n.retired&&this.instances.find(t=>t.name===n.name)===e}retireInstance(e){const n=this.instanceGenerations.get(e);n&&(n.retired=!0)}async start(e){return this.runMutation(()=>this.startUnlocked(e))}async startUnlocked(e){const n=e??A.config;this.configRepository=new J(n),m.info("manager",`Loading configs from ${n}`),Te(),z(),this.globalConfigStore=new be(b(A.data,"agent-global-configs.json")),this.globalConfigStore.load();const{entries:t,fileErrors:s,skipped:r}=this.configRepository.scan();for(const i of s)m.error("manager",`Failed to load ${i.file}: ${i.error}`);for(const i of r)m.info("manager",`Skipped ${i}: not an agent config (no "agents" key)`);if(t.length===0&&s.length===0&&r.length===0){m.warn("manager",`No agent configurations found in ${n}; daemon idle (waiting for config). Add agents under this directory then run: grix-connector reload`);return}const c=[];let o=s.length;for(const{entry:i,file:l}of t)try{const g=this.toRuntimeInstanceConfig(i);c.push({config:g,entry:i,file:l}),m.info("manager",`Loaded ${g.name} (${g.adapterType??"acp"}) from ${l}`)}catch(g){const p=typeof i?.name=="string"?i.name:"<unknown>";m.error("manager",`Invalid agent config in ${l} (name=${p}): ${g}`),o++}c.length>0&&await Ae();let u=0;if(c.length>0){const i=ee();m.info("manager",`Starting ${c.length} agent(s), startup wait=${i}ms`);const l=d=>{this.instances=this.instances.filter(h=>h!==d)},g=c.map(({config:d,entry:h,file:_})=>{const w=this.createConfiguredInstance(d);return this.instances.push(w),this.configMap.set(d.name,d),this.rawConfigMap.set(d.name,{entry:h,file:_}),{config:d,instance:w,startPromise:this.prepareProviderRuntime(d,h).then(()=>{if(this.stopping)throw this.requestStartCancellation(w),Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});return this.startTrackedInstance(w)})}}),p=await Promise.all(g.map(async d=>{const h=await new Promise(_=>{let w=!1;const y=setTimeout(()=>{w||(w=!0,_({kind:"timeout"}))},i);d.startPromise.then(()=>{w||(w=!0,clearTimeout(y),_({kind:"started"}))}).catch(S=>{w||(w=!0,clearTimeout(y),_({kind:"failed",error:S}))})});return{task:d,outcome:h}}));for(const{task:d,outcome:h}of p){if(h.kind==="started"){this.restoreCachedSharedInstances(d.config);continue}if(h.kind==="failed"){if($(h.error)){this.onAgentDeletedByPlatform(d.instance);continue}try{await this.stopInstance(d.instance),l(d.instance),this.failedStartAgents.delete(d.config.name)}catch(_){this.failedStartAgents.add(d.config.name),m.error("manager",`Failed to clean up partially started ${d.config.name}: ${_}`)}m.error("manager",`Failed to start ${d.config.name}: ${h.error}`);continue}u++,m.warn("manager",`Startup pending for ${d.config.name}, continue retrying in background`),d.startPromise.then(()=>{this.stopping||this.removingAgents.has(d.config.name)||this.isActiveGeneration(d.instance)&&(m.info("manager",`Delayed start succeeded: ${d.config.name}`),this.restoreCachedSharedInstances(d.config))}).catch(async _=>{if($(_)){this.onAgentDeletedByPlatform(d.instance);return}if(!(this.stopping||this.removingAgents.has(d.config.name))&&this.isActiveGeneration(d.instance)){try{await this.stopInstance(d.instance),l(d.instance),this.failedStartAgents.delete(d.config.name)}catch(w){this.failedStartAgents.add(d.config.name),m.error("manager",`Failed to clean up delayed start ${d.config.name}: ${w}`)}m.error("manager",`Delayed start failed: ${d.config.name}: ${_}`)}})}if(this.instances.length>0){const d=Math.max(0,this.instances.length-u);m.info("manager",`${d}/${c.length} agent(s) running now`)}u>0&&m.warn("manager",`${u} agent(s) still connecting in background`)}if(this.instances.length===0&&c.length>0)throw new Error("All agent configurations failed to start");await this.ensureAuxServices()}async ensureAuxServices(){if(this.stopping||this.configMap.size===0)return;const e=[...this.configMap.values()].map(n=>({apiKey:n.aibot.apiKey,wsUrl:n.aibot.url}));if(!this.upgradeChecker&&(this.upgradeChecker=new Se(e,()=>this.describeAnyPendingOrBackgroundWork(),()=>this.closeAllLifecycleAdmission(),{requestGracefulShutdown:this.options.requestGracefulShutdown,reopenLifecycleAdmission:()=>this.reopenAllLifecycleAdmission(),isConnected:()=>this.instances.length===0||this.instances.some(n=>n.getStatus().wsConnected),onTransactionSettled:this.options.onTransactionSettled}),await this.upgradeChecker.start(),this.stopping)){this.upgradeChecker.stop();return}this.skillSyncer||(this.skillSyncer=new ke(e,A.skills),this.skillSyncer.setOnSyncSuccess(()=>this.refreshOwnerLibrarySkills()),await this.skillSyncer.start(),this.stopping&&this.skillSyncer.stop())}refreshOwnerLibrarySkills(){const e=new Map,n=t=>{let s;try{s=t.skillsSyncGroupKey()}catch(c){m.warn("manager",`skillsSyncGroupKey failed for ${t.name}: ${c}`);return}const r=e.get(s)??[];r.push(t),e.set(s,r)};for(const t of this.instances)n(t);for(const t of this.sharedInstances.values())n(t);for(const[t,s]of e){let r=!1;const c=[];for(const o of s){if(r){c.push(o);continue}let u=!1;try{u=o.forceRefreshSkills(void 0,{force:!0,ownerLibrarySync:!0})===!0}catch(i){m.warn("manager",`owner library skills reporter threw group=${t} agent=${o.name}: ${i}`)}if(u){r=!0;continue}m.warn("manager",`owner library skills reporter failed group=${t} agent=${o.name}; trying next`)}if(!r){m.warn("manager",`owner library skills: no reporter succeeded group=${t}`);continue}for(const o of c)try{o.adoptSkillsWireHashFromDisk()}catch(u){m.warn("manager",`adoptSkillsWireHashFromDisk failed for ${o.name}: ${u}`)}}}async stop(){m.info("manager","Stopping all agents..."),this.stopping=!0;const e=nt(),n=Date.now()+e,t=()=>Math.max(1,n-Date.now()),s=new Set([...this.instances,...this.sharedInstances.values(),...this.startingInstances]);for(const o of s)this.requestStartCancellation(o);const r=new Map([...s].map(o=>[o,this.stopInstance(o,void 0,e)])),c=[];this.upgradeChecker?.stop(),this.skillSyncer?.stop();try{await this.waitForLifecycleDrain([this.mutationTail,...this.shareSyncChains.values(),...r.values()],"manager shutdown lifecycle drain",t())}catch(o){c.push(o)}this.upgradeChecker?.stop(),this.skillSyncer?.stop(),this.shareSyncChains.clear(),await Promise.all([...[...this.instances].map(async o=>{try{await(r.get(o)??this.stopInstance(o,void 0,t())),this.retireInstance(o),this.instances=this.instances.filter(u=>u!==o),this.startingInstances.delete(o)}catch(u){c.push(u)}}),...[...this.sharedInstances.entries()].map(async([o,u])=>{try{await(r.get(u)??this.stopInstance(u,void 0,t())),this.sharedInstances.get(o)===u&&this.sharedInstances.delete(o),this.startingInstances.delete(u)}catch(i){c.push(i)}})]);try{await this.waitForLifecycleDrain([this.retryPendingPlatformDeletesUnlocked(n)],"platform-delete shutdown drain",t())}catch(o){c.push(o)}try{await this.waitForShutdownOperation(Promise.resolve().then(()=>this.globalConfigStore?.flush()),"global config shutdown flush",t())}catch(o){c.push(o)}if(await this.auditProducer.stop({timeoutMs:Math.min(5e3,t())}).catch(()=>!1),z(),c.length>0)throw new AggregateError(c,"Failed to stop all agents completely");m.info("manager","All stopped")}onShareSet(e,n,t){if(this.stopping||this.removingAgents.has(n.name)||!this.isActiveGeneration(e))return;this.sharedOwnersCache.save(n.name,t);const r=(this.shareSyncChains.get(n.name)??Promise.resolve()).catch(()=>{}).then(()=>{if(!(this.stopping||this.removingAgents.has(n.name))&&this.isActiveGeneration(e))return this.syncSharedInstances(n,t,e)});this.shareSyncChains.set(n.name,r)}async syncSharedInstances(e,n,t){if(this.stopping||this.removingAgents.has(e.name)||t&&!this.isActiveGeneration(t))return;const{toAdd:s,toRemove:r}=ge(e.name,this.sharedInstances.keys(),n);for(const c of s){if(this.stopping||this.removingAgents.has(e.name)||t&&!this.isActiveGeneration(t))break;const o=fe(e.name,c);let u;try{const i=me(e,c);u=new K(i,this.globalConfigStore,this.auditProducer),u.setLifecycleBusyChecker(()=>this.describeAnyPendingOrBackgroundWork()),u.setLifecycleAdmissionCloser(()=>this.closeAllLifecycleAdmission()),u.setLifecycleAdmissionRestorer(()=>this.reopenAllLifecycleAdmission()),this.options.requestGracefulShutdown&&u.setDaemonShutdownRequester(this.options.requestGracefulShutdown),this.lifecycleAdmissionClosed&&u.closeLifecycleAdmission(),this.sharedInstances.set(o,u),await this.startTrackedInstance(u),u.forceRefreshSkills(void 0,{force:!0}),m.info("manager",`shared instance started: ${o}`)}catch(i){if(u&&!this.stopping&&!this.removingAgents.has(e.name))try{await this.stopInstance(u),this.sharedInstances.get(o)===u&&this.sharedInstances.delete(o)}catch(g){m.error("manager",`cleanup shared instance failed ${o}: ${g}`)}const l=i instanceof Error?i.message:String(i);/Auth failed/i.test(l)?(this.sharedOwnersCache.remove(e.name,c),m.warn("manager",`shared instance auth rejected, removed from cache: ${o}`)):m.error("manager",`start shared instance failed ${o}: ${i}`)}}for(const{key:c}of r){const o=this.sharedInstances.get(c);if(o)try{await this.stopInstance(o),this.sharedInstances.get(c)===o&&this.sharedInstances.delete(c),m.info("manager",`shared instance stopped: ${c}`)}catch(u){m.error("manager",`stop shared instance failed ${c}: ${u}`)}}}restoreCachedSharedInstances(e){const n=this.sharedOwnersCache.load(e.name);if(n.length===0)return;const t=this.instances.find(s=>s.name===e.name);!t||!this.isActiveGeneration(t)||(m.info("manager",`restoring ${n.length} cached shared instance(s) for ${e.name}`),this.onShareSet(t,e,n))}getAgentsStatus(){return this.instances.map(e=>e.getStatus())}async addAgent(e){return this.runMutation(()=>this.addAgentUnlocked(e),[String(e.name??"")])}async addAgentUnlocked(e){const n=this.toRuntimeInstanceConfig(e,{quiet:!0});if(this.instances.some(t=>t.name===n.name))throw new Error(`Agent "${n.name}" already exists`);this.configRepository.assertCanAdd(e),await this.addAgentInternal(e,"agents.json",{targetPersisted:!1});try{const t=this.configRepository.insert(e);this.rawConfigMap.set(e.name,t);const s=this.instances.find(c=>c.name===e.name),r=s?this.instanceGenerations.get(s):void 0;if(r){r.persisted=!0;const c=this.configMap.get(e.name);c&&this.restoreCachedSharedInstances(c)}}catch(t){try{await this.removeAgentInternal(e.name)}catch(s){throw new AggregateError([t,s],`Failed to persist and roll back agent "${e.name}"`)}throw t}await this.ensureAuxServices(),m.info("manager",`Added agent: ${e.name}`)}async addAgentInternal(e,n,t){const s=this.toRuntimeInstanceConfig(e);if(this.instances.some(r=>r.name===s.name))throw new Error(`Agent "${s.name}" already exists`);await this.startInstanceFromConfig(s,e,n,t)}createConfiguredInstance(e,n=!0){const t=new K(e,this.globalConfigStore,this.auditProducer);return this.instanceGenerations.set(t,{name:e.name,agentId:e.aibot.agentId,persisted:n,retired:!1,platformDeletedObserved:!1}),t.setUpgradeTrigger(()=>this.upgradeChecker?.triggerCheck()),this.options.requestGracefulShutdown&&t.setDaemonShutdownRequester(this.options.requestGracefulShutdown),t.setLifecycleBusyChecker(()=>this.describeAnyPendingOrBackgroundWork()),t.setLifecycleAdmissionCloser(()=>this.closeAllLifecycleAdmission()),t.setLifecycleAdmissionRestorer(()=>this.reopenAllLifecycleAdmission()),this.lifecycleAdmissionClosed&&t.closeLifecycleAdmission(),t.setInstallAgentHandler(s=>this.installAgent(s)),t.setRemoteAdminPorts({isEnabled:()=>this.remoteAdminGate?.()??!1,listInstallable:()=>this.listInstallable(),installAgent:s=>this.installAgent(s),getInstallProgress:s=>this.getInstallProgress(s),addAgent:s=>this.addAgent(s),probeAll:s=>this.probeAll(s)}),t.setShareSetHandler(s=>this.onShareSet(t,e,s)),t.setAgentDeletedHandler(()=>this.onAgentDeletedByPlatform(t)),t.setSkillSyncHandler(()=>this.skillSyncer?.triggerSync()),t.setProviderConfigHandler(s=>this.setAgentProvider(e.name,s)),t.setRelayStateApplyPorts({getLocalState:()=>this.relayStateApplier?.getLocalState(e.name)??{enabled:!1},getAppliedMode:()=>this.relayStateApplier?.getAppliedMode?.(e.name),applyEnable:(s,r)=>{const c=this.relayStateApplier;return c?c.applyEnable(e.name,s,r):Promise.reject(new Error("relay state applier is not configured"))},applyDisable:()=>{const s=this.relayStateApplier;return s?s.applyDisable(e.name):Promise.reject(new Error("relay state applier is not configured"))}}),t.setRelayEnvSettledHandler(()=>this.relayEnvSettledHandler?.()),t.setProviderResolver(()=>Z(this.getAgentProvider(e.name))),t}describeAnyPendingOrBackgroundWork(){return[...this.instances.flatMap(e=>e.describePendingOrBackgroundWork()),...[...this.sharedInstances.values()].flatMap(e=>e.describePendingOrBackgroundWork())]}closeAllLifecycleAdmission(){this.lifecycleAdmissionClosed=!0;for(const e of this.instances)e.closeLifecycleAdmission();for(const e of this.sharedInstances.values())e.closeLifecycleAdmission()}reopenAllLifecycleAdmission(){if(!this.stopping){this.lifecycleAdmissionClosed=!1;for(const e of this.instances)e.openLifecycleAdmission();for(const e of this.sharedInstances.values())e.openLifecycleAdmission()}}async prepareProviderRuntime(e,n){const t=this.resolveAgentProvider(n.provider);Q(n.client_type)&&t?.base_url?.trim()&&t?.api_key?.trim()&&t?.model?.trim()&&await V(e.name,{baseUrl:t.base_url.trim(),apiKey:t.api_key.trim(),model:t.model.trim()})}async startInstanceFromConfig(e,n,t,s){if(this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});if(await this.prepareProviderRuntime(e,n),this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});const r=this.createConfiguredInstance(e,s.targetPersisted);this.instances.push(r);const c=this.startTrackedInstance(r),o=ee(),u=await new Promise(p=>{let d=!1;const h=setTimeout(()=>{d||(d=!0,p({kind:"timeout"}))},o);c.then(()=>{d||(d=!0,clearTimeout(h),p({kind:"started"}))},_=>{d||(d=!0,clearTimeout(h),p({kind:"failed",error:_}))})}),i=this.instanceGenerations.get(r);if(i?.platformDeletedObserved&&!i.persisted){const p=new we(`Agent "${e.name}" was deleted before its local configuration commit`);try{await this.stopInstance(r),this.retireInstance(r),this.instances=this.instances.filter(d=>d!==r),this.failedStartAgents.delete(e.name)}catch(d){throw this.failedStartAgents.add(e.name),new AggregateError([p,d],`Failed to clean up uncommitted deleted agent "${e.name}"`)}throw p}if(u.kind==="started"){this.configMap.set(e.name,e),this.rawConfigMap.set(e.name,{entry:n,file:t}),this.failedStartAgents.delete(e.name),s.targetPersisted&&this.restoreCachedSharedInstances(e),this.relayEnvSettledHandler?.();return}if(u.kind==="timeout"){this.configMap.set(e.name,e),this.rawConfigMap.set(e.name,{entry:n,file:t}),m.warn("manager",`Start pending for ${e.name}, continue retrying in background`),c.then(async()=>{if(!this.removingAgents.has(e.name)&&this.isActiveGeneration(r)){if(this.stopping){try{await this.stopInstance(r),this.instances=this.instances.filter(p=>p!==r)}catch(p){this.failedStartAgents.add(e.name),m.error("manager",`Failed to stop late-started ${e.name}: ${p}`)}return}this.failedStartAgents.delete(e.name),this.instanceGenerations.get(r)?.persisted&&this.restoreCachedSharedInstances(e),this.relayEnvSettledHandler?.(),m.info("manager",`Delayed start succeeded: ${e.name}`)}},async p=>{if($(p)){this.onAgentDeletedByPlatform(r);return}if(!(this.stopping||this.removingAgents.has(e.name))&&this.isActiveGeneration(r)){try{await this.stopInstance(r),this.instances=this.instances.filter(d=>d!==r),this.failedStartAgents.delete(e.name)}catch(d){this.failedStartAgents.add(e.name),m.error("manager",`Failed to clean up delayed start ${e.name}: ${d}`)}m.error("manager",`Delayed start failed ${e.name}: ${p}`)}}).catch(p=>{m.error("manager",`Delayed start finalizer failed ${e.name}: ${p}`)});return}const l=u.error;$(l)&&this.onAgentDeletedByPlatform(r);let g;try{await this.stopInstance(r),this.instances=this.instances.filter(p=>p!==r),this.failedStartAgents.delete(e.name)}catch(p){g=p,this.failedStartAgents.add(e.name)}throw s.targetPersisted&&(this.configMap.set(e.name,e),this.rawConfigMap.set(e.name,{entry:n,file:t})),g!==void 0?new AggregateError([l,g],`Failed to start and clean up agent "${e.name}"`):l}async removeAgent(e){return this.runMutation(()=>this.removeAgentUnlocked(e),[e])}async removeAgentUnlocked(e){if(!(this.instances.some(t=>t.name===e)||this.rawConfigMap.has(e)||[...this.sharedInstances.keys()].some(t=>t.startsWith(`${e}#shared:`))))throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});this.configRepository.remove(e),await this.removeAgentInternal(e),m.info("manager",`Removed agent: ${e}`),this.relayEnvSettledHandler?.()}async removeAgentInternal(e,n){this.removingAgents.add(e);try{const t=()=>n?.deadlineMs===void 0?P():Math.max(1,n.deadlineMs-Date.now()),s=this.instances.findIndex(p=>p.name===e),r=s===-1?void 0:this.instances[s],c=`${e}#shared:`,o=n?.keepShareCache?void 0:{dropPendingEvents:!0},u=new Map;r&&(this.requestStartCancellation(r),this.startingInstances.has(r)&&u.set(r,this.stopInstance(r,o,t())));for(const[p,d]of this.sharedInstances)p.startsWith(c)&&(this.requestStartCancellation(d),this.startingInstances.has(d)&&u.set(d,this.stopInstance(d,o,t())));const i=this.shareSyncChains.get(e);this.shareSyncChains.delete(e);const l=[];try{await this.waitForLifecycleDrain([...i?[i]:[],...u.values()],`agent "${e}" shared lifecycle drain`,t())}catch(p){l.push(p)}const g=[];for(const[p,d]of[...this.sharedInstances.entries()])p.startsWith(c)&&g.push((u.get(d)??this.stopInstance(d,o,t())).then(()=>{this.sharedInstances.get(p)===d&&this.sharedInstances.delete(p),this.startingInstances.delete(d)}).catch(h=>{l.push(h),m.error("manager",`stop shared instance failed ${p}: ${h}`)}));if(r)try{await(u.get(r)??this.stopInstance(r,o,t())),this.retireInstance(r);const p=this.instances.indexOf(r);p!==-1&&this.instances.splice(p,1),this.startingInstances.delete(r)}catch(p){l.push(p)}if(await Promise.all(g),!n?.keepShareCache){const p=X(e).catch(()=>{});if(n?.deadlineMs===void 0)await p;else try{await this.waitForLifecycleDrain([p],`agent "${e}" relay shutdown`,t())}catch(d){l.push(d)}}if(l.length>0)throw new AggregateError(l,`Failed to stop agent "${e}" completely`);this.configMap.delete(e),this.rawConfigMap.delete(e),this.failedStartAgents.delete(e),n?.keepShareCache||this.sharedOwnersCache.delete(e)}finally{this.removingAgents.delete(e)}}onAgentDeletedByPlatform(e){const n=this.instanceGenerations.get(e);if(!n||(n.platformDeletedObserved=!0,this.requestStartCancellation(e),!n.persisted))return;const t={source:e,name:n.name,agentId:n.agentId};this.pendingPlatformDeletes.set(e,t),!this.stopping&&(this.deletedAgentCleanups.has(e)||(this.deletedAgentCleanups.add(e),this.runMutation(async()=>{}).catch(()=>{}).finally(()=>{this.deletedAgentCleanups.delete(e)})))}async retryPendingPlatformDeletesUnlocked(e){if(this.pendingPlatformDeletes.size!==0)for(const[n,t]of[...this.pendingPlatformDeletes])try{await this.cleanupPlatformDeletedUnlocked(t,e),this.pendingPlatformDeletes.delete(n)}catch(s){m.error("manager",`cleanup for deleted agent "${t.name}" failed: ${s}`)}}async cleanupPlatformDeletedUnlocked(e,n){const{source:t,name:s,agentId:r}=e,c=this.instances.find(g=>g.name===s),o=c?this.instanceGenerations.get(c)?.agentId??String(this.rawConfigMap.get(s)?.entry.agent_id??"").trim():void 0;if(c&&c!==t&&o!==r)return;m.warn("manager",`Agent "${s}" \u5DF2\u5728\u5E73\u53F0\u5220\u9664\uFF0C\u505C\u6B62\u5B9E\u4F8B\u5E76\u6E05\u7406\u672C\u5730\u914D\u7F6E`);const u=this.rawConfigMap.get(s),i=this.configMap.get(s),l=[];if(c&&o===r)try{await this.removeAgentInternal(s,{deadlineMs:n})}catch(g){l.push(g)}try{const g=this.configRepository.scan();if(g.fileErrors.length>0){const h=g.fileErrors.map(_=>`${_.file}: ${_.error}`).join("; ");throw new Error(`cannot inspect deleted agent generation [${h}]`)}const p=g.entries.filter(h=>String(h.entry?.name??"").trim()===s);if(!p.some(h=>String(h.entry?.agent_id??"").trim()!==r)&&p.length>0&&this.configRepository.remove(s),l.length===0){const h=String(this.rawConfigMap.get(s)?.entry.agent_id??"").trim();(!h||h===r)&&(this.rawConfigMap.delete(s),this.configMap.delete(s),this.failedStartAgents.delete(s))}}catch(g){l.push(g),u&&this.rawConfigMap.set(s,u),i&&this.configMap.set(s,i)}if(l.length>0)throw new AggregateError(l,`Failed to fully clean up deleted agent "${s}"`);m.info("manager",`Agent "${s}" \u5DF2\u5728\u5E73\u53F0\u5220\u9664\uFF0C\u672C\u5730\u914D\u7F6E\u5DF2\u6E05\u7406`)}isAgentBusy(e){return this.instances.find(t=>t.name===e)?.hasPendingWork()??!1}getAgentsWithStaleRelayEnv(){return this.instances.filter(e=>e.hasStaleRelayEnv()).map(e=>e.name)}markAgentRelayEnvStale(e){const n=this.instances.find(t=>t.name===e);return n?(n.markRelayEnvStale(),!0):!1}relayEnvSettledHandler;setRelayEnvSettledHandler(e){this.relayEnvSettledHandler=e}remoteAdminGate;setRemoteAdminGate(e){this.remoteAdminGate=e}relayStateApplier;setRelayStateApplier(e){this.relayStateApplier=e}reportRelayStateLocalChange(e){this.instances.find(t=>t.name===e)?.reportRelayStateLocalChange()}setRelaySecretResolver(e){this.relaySecretResolver=e}resolveAgentProvider(e){if(!e?.api_key_ref?.trim())return e;const n=e.api_key_ref.trim(),t=this.relaySecretResolver?.(n);if(!t)throw Object.assign(new Error(`relay credential "${n}" is unavailable`),{code:"RELAY_SECRET_UNAVAILABLE"});return{...e,api_key:t}}toRuntimeInstanceConfig(e,n={}){const t=this.resolveAgentProvider(e.provider);return tt(t===e.provider?e:{...e,provider:t},n)}getAgentProvider(e){return this.resolveAgentProvider(this.rawConfigMap.get(e)?.entry.provider)}async restartAgent(e){return this.runMutation(()=>this.restartAgentUnlocked(e),[e])}async restartAgentUnlocked(e){const n=this.rawConfigMap.get(e);if(!n)throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});await this.replaceInstance(e,n.entry,n.file),m.info("manager",`Restarted agent: ${e}`)}async setAgentProvider(e,n,t){return this.runMutation(()=>this.setAgentProviderUnlocked(e,n,t),[e])}async setAgentProviderUnlocked(e,n,t){if(!this.rawConfigMap.get(e))throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});const r=n?.api_key_ref?.trim()?Object.fromEntries(Object.entries(n).filter(([i])=>i!=="api_key")):n,c=this.configRepository.updateExisting(e,i=>{const l={...i};if(r===void 0)delete l.provider;else{const g=r.quota_api_key?.trim()||i.provider?.quota_api_key?.trim();l.provider=g?{...r,quota_api_key:g}:r}return this.toRuntimeInstanceConfig(l,{quiet:!0}),l}),o=c.entry;this.rawConfigMap.set(e,c);const u=String(o.client_type??"").trim().toLowerCase();try{Q(u)&&(n?.base_url?.trim()&&n?.api_key?.trim()&&n?.model?.trim()?await V(e,{baseUrl:n.base_url.trim(),apiKey:n.api_key.trim(),model:n.model.trim()}):await X(e))}catch(i){throw this.failedStartAgents.add(e),this.instances.find(l=>l.name===e)?.markRelayEnvStale(),i}if(t?.deferRestart){this.instances.find(i=>i.name===e)?.markRelayEnvStale(),m.info("manager",`Updated provider config for agent (deferred restart): ${e}`);return}try{await this.replaceInstance(e,o,c.file)}catch(i){throw this.failedStartAgents.add(e),this.instances.find(l=>l.name===e)?.markRelayEnvStale(),i}m.info("manager",`Updated provider config for agent: ${e}`)}hasDirectRelayConfig(e){const n=this.rawConfigMap.get(e)?.entry.provider;return!!(n?.api_key_ref?.trim()||n?.api_key?.trim())}getDirectRelayConfigAgentNames(){return[...this.rawConfigMap.entries()].filter(([,e])=>!!e.entry.provider&&(xe(e.entry.client_type)||["claude","codex"].includes(String(e.entry.client_type??"").trim().toLowerCase()))).map(([e])=>e)}async fetchRelayCredential(e,n){const t=this.instances.find(s=>s.name===e);if(!t)throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});return t.fetchRelayCredential(n)}async clearDirectProviderConfigs(){const e=this.getDirectRelayConfigAgentNames(),n=[];for(const t of e)try{await this.setAgentProvider(t,void 0,{deferRestart:this.isAgentBusy(t)}),n.push(t)}catch(s){m.warn("manager",`Failed to clear provider config for "${t}": ${s instanceof Error?s.message:String(s)}`)}return n}async replaceInstance(e,n,t){const s=this.toRuntimeInstanceConfig(n);try{await this.removeAgentInternal(e,{keepShareCache:!0})}catch(o){throw this.failedStartAgents.add(e),o}const r=String(n.agent_id??"").trim();if([...this.pendingPlatformDeletes.values()].some(o=>o.name===e&&o.agentId===r))throw await this.retryPendingPlatformDeletesUnlocked(),Object.assign(new Error(`Agent "${e}" was permanently deleted while its instance was stopping`),{code:"AGENT_DELETE_PENDING"});try{await this.startInstanceFromConfig(s,n,t,{targetPersisted:!0})}catch(o){throw this.configMap.set(e,s),this.rawConfigMap.set(e,{entry:n,file:t}),o}}async reload(){return this.runMutation(()=>this.doReload())}async doReload(){if(this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"RELOAD_UNSAFE"});const{entries:e,fileErrors:n,skipped:t}=this.configRepository.scan();for(const i of t)m.info("manager",`reload: skipped ${i}: not an agent config (no "agents" key)`);if(n.length>0){const i=n.map(l=>`${l.file}: ${l.error}`).join("; ");throw Object.assign(new Error(`reload aborted: ${n.length} config file(s) failed to parse [${i}]`),{code:"RELOAD_UNSAFE"})}if(e.length===0)throw Object.assign(new Error("reload aborted: no valid agent config found"),{code:"RELOAD_UNSAFE"});const s=[];for(const{entry:i}of e)try{this.toRuntimeInstanceConfig(i,{quiet:!0})}catch(l){const g=i?.name,p=typeof g=="string"&&g.trim()?g:"<unknown>";s.push({name:p,error:l instanceof Error?l.message:String(l)})}if(s.length>0){const i=s.map(l=>`${l.name}: ${l.error}`).join("; ");throw Object.assign(new Error(`reload aborted: ${s.length} agent config(s) invalid [${i}]`),{code:"RELOAD_UNSAFE"})}const r=new Map,c=new Set([...this.pendingPlatformDeletes.values()].map(i=>i.name));for(const i of e){const l=String(i.entry?.name??"").trim();l&&(c.has(l)||(r.has(l)&&m.warn("manager",`reload: duplicate agent name "${l}", last one wins`),r.set(l,i)))}const o={added:[],removed:[],restarted:[],unchanged:[],failed:[]},u=new Set([...this.rawConfigMap.keys()].filter(i=>!c.has(i)));for(const i of u)if(!r.has(i))try{await this.removeAgentInternal(i),o.removed.push(i)}catch(l){o.failed.push({name:i,error:l instanceof Error?l.message:String(l)})}for(const[i,l]of r){const g=this.rawConfigMap.get(i);if(g)if(!st(g.entry,l.entry)||!this.instances.some(p=>p.name===i)||this.failedStartAgents.has(i))try{await this.replaceInstance(i,l.entry,l.file),o.restarted.push(i)}catch(p){o.failed.push({name:i,error:p instanceof Error?p.message:String(p)})}else this.rawConfigMap.set(i,l),o.unchanged.push(i);else try{await this.addAgentInternal(l.entry,l.file,{targetPersisted:!0}),o.added.push(i)}catch(p){o.failed.push({name:i,error:p instanceof Error?p.message:String(p)})}}return m.info("manager",`reload done: +${o.added.length} -${o.removed.length} ~${o.restarted.length} =${o.unchanged.length} !${o.failed.length}`),await this.ensureAuxServices(),o}async checkUpgrade(){return this.upgradeChecker?this.upgradeChecker.checkForUpdate():{available:!1}}triggerUpgrade(){this.upgradeChecker?.triggerCheck()}async probeAll(e={}){return at(this.instances,e)}async probeOne(e,n={}){return rt(this.instances,e,n)}listInstallable(){return this.installer.listInstallable()}async installAgent(e){const n=await this.installer.install(e);return Le(n),n}getInstallProgress(e){return this.installer.getProgress(e)??null}}async function at(a,e){const n=e.concurrency??4,t=Date.now(),s=new Array(a.length);await new Promise(i=>{let l=0,g=0;const p=a.length;if(p===0){i();return}function d(w){const y=a[w];y.probe(e).then(S=>{s[w]=S,h()},S=>{s[w]={agent_name:y.name,client_type:"unknown",adapter_type:"acp",ok:!1,status:"error",probed_at:Date.now(),duration_ms:0,cached:!1,cli:{command:"",installed:!1,path:null,version:null,error:{code:"internal",message:S?.message??String(S)}},conversation:{attempted:!1,ok:!1,latency_ms:null},config:{model:null,base_url:null,source:{model:"unknown",base_url:"unknown"}},process:{started:!1,alive:!1,busy:!1}},h()})}function h(){g++,l<p?d(l++):g===p&&i()}const _=Math.min(n,p);for(let w=0;w<_;w++)d(l++)});const r=s.filter(i=>i.status==="healthy").length,c=s.filter(i=>i.status==="degraded").length,o=s.filter(i=>i.status==="unavailable").length,u=await Y();return{ok:r===s.length&&s.length>0,total:s.length,healthy:r,degraded:c,unavailable:o,installed_clients:u,agents:s,probed_at:t,duration_ms:Date.now()-t}}async function rt(a,e,n){const t=a.find(s=>s.name===e);if(!t)throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});return t.probe(n)}export{Nt as Manager,Je as mergeAgentEnv,Z as normalizeAgentProviderForRuntime,Y as probeInstalledClientCommands,at as probeInstances,rt as probeOneInstance,tt as toInstanceConfig};
1
+ import{join as b}from"node:path";import{homedir as W}from"node:os";import{AgentInstance as K}from"./bridge/bridge.js";import{isCwdLockedClientType as he,resolveStaticCwd as ue}from"./bridge/cwd-policy.js";import{buildSharedInstanceConfig as me,diffSharedOwners as ge,sharedInstanceKey as fe,SharedOwnersCache as _e}from"./manager-share-config.js";import{AgentDeletedError as we,isAgentDeletedError as $}from"./core/aibot/errors.js";import{GRIX_PATHS as A,log as m}from"./core/log/index.js";import{resolveClientVersion as ye}from"./core/util/client-version.js";import{mergeLoginShellPathIntoProcess as Ae}from"./core/util/cli-probe.js";import{UpgradeChecker as Se}from"./core/upgrade/upgrade-checker.js";import{SkillSyncer as ke}from"./core/skill-sync/skill-syncer.js";import{AgentGlobalConfigStore as be}from"./core/persistence/agent-global-config-store.js";import{resolveSkillScanMode as ve}from"./adapter/claude/skill-scanner.js";import{resolveClaudeConfigPaths as Ce}from"./adapter/claude/config-paths.js";import{buildWireSkills as Ie}from"./core/skill-sync/sync-state.js";import{buildLibrarySkills as Ee}from"./core/skill-sync/library-skills.js";import{AUDIT_LOCAL_ACTION_TYPES as $e}from"./core/aibot/types.js";import{buildReportedSkills as Pe,logDefaultSkillsCheck as Te,cleanupProjectedSkills as z}from"./default-skills/index.js";import{buildProviderEnv as Me,supportsKiroCwRelay as Q,supportsNonMitmRelayConfig as xe}from"./core/config/provider-env.js";import{resolveHermesHomeDir as De}from"./adapter/shared/native-provider-config.js";import{ensureKiroRelay as V,stopKiroRelay as X}from"./core/proxy/kiro-relay.js";import{resolveCopilotCommand as Oe}from"./core/runtime/copilot-resolve.js";import{resolveCursorCommand as Re}from"./core/runtime/cursor-resolve.js";import{probeInstalledClientCommands as Y}from"./core/probe/installed-clients.js";import{AgentInstaller as je}from"./core/installer/installer.js";import{reportInstallFailure as Le}from"./core/observability/sentry.js";import{createDefaultAuditProducer as Ne}from"./audit/runtime/default-audit-recorder.js";import{normalizeCodexConfigOverrides as qe}from"./adapter/codex/config-overrides.js";import{ACP_NEW_SESSION_RESERVED_KEYS as Ge}from"./protocol/acp-client.js";import{resolveCodexDirectHome as Ue}from"./adapter/codex/direct-home.js";import{AgentConfigRepository as J}from"./core/config/agent-config-repository.js";import{expandHomePath as Be}from"./core/config/paths.js";function Z(a){if(a)return{...a.provider_id?.trim()?{providerId:a.provider_id.trim()}:{},...a.base_url?.trim()?{baseUrl:a.base_url.trim()}:{},...a.quota_base_url?.trim()?{quotaBaseUrl:a.quota_base_url.trim()}:{},...a.api_key?.trim()?{apiKey:a.api_key.trim()}:{},...a.quota_api_key?.trim()?{quotaApiKey:a.quota_api_key.trim()}:{},...a.model?.trim()?{model:a.model.trim()}:{},...a.fast_model?.trim()?{fastModel:a.fast_model.trim()}:{},...a.effort?.trim()?{effort:a.effort.trim()}:{}}}const He=8e3,Fe=1e4,We=8e3;function Ke(a,e){switch(a){case"claude":return{adapterType:"claude",command:"claude"};case"codex":return{adapterType:"codex",command:"codex",options:{sandboxMode:"danger-full-access"}};case"gemini":return{adapterType:"acp",command:"gemini",autoInjectArgs:{acp:!0},enableSessionBinding:!0};case"qwen":return{adapterType:"acp",command:"qwen",adapterHint:"qwen/base",autoInjectArgs:{acp:!0},enableSessionBinding:!0};case"pi":return{adapterType:"pi",command:"pi"};case"omp":return{adapterType:"pi",command:"omp",adapterHint:"omp/base",env:{PI_CODING_AGENT_DIR:b(W(),".omp","agent")}};case"cursor":return{adapterType:"cursor",command:Re()};case"reasonix":return{adapterType:"acp",command:"reasonix",args:["acp"],enableSessionBinding:!0};case"codewhale":return{adapterType:"codewhale",command:"codewhale",enableSessionBinding:!0};case"openhuman":return{adapterType:"openhuman",command:"openhuman-core",enableSessionBinding:!0};case"kiro":return{adapterType:"acp",command:"kiro-cli",args:["acp"],enableSessionBinding:!0};case"kimi":return{adapterType:"acp",command:"kimi",args:["acp"],options:{initial_mode:"auto"},enableSessionBinding:!0};case"qodercli":return{adapterType:"acp",command:"qodercli",args:["--yolo","--acp"],enableSessionBinding:!0};case"qoderclicn":return{adapterType:"acp",command:"qoderclicn",args:["--yolo","--acp"],enableSessionBinding:!0};case"mcode":return{adapterType:"acp",command:"mcode",args:["acp"],enableSessionBinding:!0};case"dim":return{adapterType:"acp",command:"dim",args:["acp"],enableSessionBinding:!0};case"opencode":return{adapterType:"opencode",command:"opencode",args:["serve"],enableSessionBinding:!0};case"deveco":return{adapterType:"opencode",command:"deveco",args:["serve"],adapterHint:"deveco/base",enableSessionBinding:!0};case"copilot":{const n=Oe();return{adapterType:"acp",command:n.command,args:[...n.prefixArgs,"--acp"],enableSessionBinding:!0}}case"agy":return{adapterType:"agy",command:"agy",enableSessionBinding:!0};case"deepseek":return{adapterType:"deepseek-harness",command:"dsh",adapterHint:"deepseek/grix-bridge-v1",options:{integrationMode:"profile_bridge",dshProfile:"web",autoInstallBridge:!0,autoStartProfile:!0},enableSessionBinding:!0};case"hermes":return{adapterType:"acp",command:"hermes",args:["acp"],enableSessionBinding:!0};case"traecli":return{adapterType:"acp",command:"traecli",args:["acp","serve"],adapterHint:"traecli/base",options:{initial_mode:"bypass_permissions"},enableSessionBinding:!0};case"codebuddy":return{adapterType:"acp",command:"codebuddy",args:["--acp"],adapterHint:"codebuddy/base",enableSessionBinding:!0};case"grok":return{adapterType:"acp",command:"grok",args:["--no-auto-update","agent","--always-approve","stdio"],enableSessionBinding:!0};case"qwenpaw":return{adapterType:"acp",command:"qwenpaw",args:["acp"],enableSessionBinding:!0};case"zeroclaw":return{adapterType:"acp",command:"zeroclaw",args:["acp"],enableSessionBinding:!0};case"acp":{const n=typeof e?.command=="string"?e.command.trim():"";if(!n)throw new Error(`agent ${e?.name??"<unknown>"}: client_type=acp requires "command" (the ACP CLI executable) in the agent config; put its ACP subcommand or flag in "args"`);return{adapterType:"acp",command:n,adapterHint:"acp/base",enableSessionBinding:!0}}default:throw new Error(`Unsupported client_type: ${a}`)}}function C(a,e){return String(a??"").trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")||String(e??"").trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")||"default"}function ze(a){return b(A.data,`session-bindings-${C(a,"unknown")}.json`)}function Qe(a,e){return b(A.data,`session-bindings-${C(a,e)}.json`)}function Ve(a,e){return b(A.data,`active-events-${C(a,e)}.json`)}function Xe(a){return b(A.data,`pending-events-${C(a,"unknown")}.json`)}function Ye(a,e){const n=C(a,"agent"),t=C(e,"unknown");return b(A.data,`terminal-outbox-${n}-${t}.json`)}function Je(a,e,n={}){const t=a?{...a,...e}:e;if(t)return Object.fromEntries(Object.entries(t).map(([s,r])=>[s,Be(r,n)]))}function Ze(...a){const e=[],n=new Set;for(const t of a)for(const s of t??[]){const r=String(s??"").trim(),c=r.toLowerCase();!r||n.has(c)||(n.add(c),e.push(r))}return e.length>0?e:void 0}function et(a,e){const n={claude:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},codex:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},cursor:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},acp:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},pi:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},codewhale:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},openhuman:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},opencode:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},agy:{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0},"deepseek-harness":{maxConcurrent:1,maxQueued:99,queueTimeoutMs:0}},t=n[a]??n.acp;let s=e?.max_concurrent??t.maxConcurrent??1;return a==="acp"&&s>1&&(m.warn("manager",`ACP adapter supports only one active run at a time; clamping max_concurrent from ${s} to 1`),s=1),{maxConcurrent:s,maxQueued:e?.max_queued??t.maxQueued??99,queueTimeoutMs:e?.queue_timeout_ms??t.queueTimeoutMs??0,cancelableQueued:!0,cancelableRunning:!0}}function tt(a,e={}){const n=ye(),t=String(a.client_type??"").trim().toLowerCase(),s=Ke(t,a),r=t==="deepseek"?a.dsh?.integration_mode??"profile_bridge":void 0,c=r==="embedded_jsonrpc",o=String(a.ws_url??"").trim(),u=typeof a.name=="string"?a.name:"",i=u.trim(),l="get_session_usage",g="get_rate_limits",p="get_agent_global_config",d=$e;if(!i)throw new Error("agent name is required");if(u!==i)throw new Error(`agent name must not contain leading or trailing whitespace: "${u}"`);if(!o)throw new Error(`agent ${a.name}: ws_url is required`);if(!a.agent_id?.trim())throw new Error(`agent ${a.name}: agent_id is required`);if(!a.api_key?.trim())throw new Error(`agent ${a.name}: api_key is required`);const h=s.adapterType,_=h==="acp",w=t==="qwen",y={...s.options??{}};if(h==="deepseek-harness"&&(y.integrationMode=r,y.dshProfile=a.dsh?.profile?.trim()||"web",y.autoInstallBridge=a.dsh?.auto_install_bridge??!c,y.autoStartProfile=a.dsh?.auto_start_profile??!c),h==="deepseek-harness"&&a.provider?.model?.trim()&&(y.defaultModel=a.provider.model.trim()),a.codex_config_overrides!==void 0){if(h!=="codex")throw new Error(`agent ${a.name}: codex_config_overrides is only supported for client_type=codex`);qe(a.codex_config_overrides,`agent ${a.name}: codex_config_overrides`),y.codexConfigOverrides=a.codex_config_overrides}if(a.acp_new_session_params!==void 0){if(!_)throw new Error(`agent ${a.name}: acp_new_session_params is only supported for ACP-based client types`);const f=a.acp_new_session_params;if(typeof f!="object"||f===null||Array.isArray(f))throw new Error(`agent ${a.name}: acp_new_session_params must be a JSON object`);const k=Object.keys(f).find(pe=>Ge.has(pe));if(k)throw new Error(`agent ${a.name}: acp_new_session_params cannot set reserved field "${k}" (Grix owns cwd/mcpServers/sessionId/additionalDirectories on every session/new)`);y.newSessionParams=f}if(t==="zeroclaw"){const k=a.acp_new_session_params?.agentAlias;if(typeof k!="string"||!k.trim()||k.trim().startsWith("<REPLACE"))throw new Error(`agent ${a.name}: client_type=zeroclaw requires acp_new_session_params.agentAlias (create one with \`zeroclaw agents create <alias>\` and set it in the agent config); without it session/new fails with -32602 and the connector would silently respawn-retry forever`)}if(h==="codex"&&a.provider?.wire_api!==void 0){const f=a.provider;if(f.wire_api!=="responses"||!f.base_url?.trim()||!f.api_key?.trim()||!f.model?.trim()||!f.catalog_version?.trim()||!f.catalog_sha256?.trim()||!f.catalog_json?.trim())throw Object.assign(new Error(`agent ${a.name}: incomplete Codex direct relay config`),{code:"INVALID_CODEX_DIRECT_CONFIG"});const k=Ue(A.data,a.name);y.codexHome=k,y.codexDirect={codexHome:k,config:{baseUrl:f.base_url.trim(),model:f.model.trim(),...f.reasoning_effort?.trim()?{reasoningEffort:f.reasoning_effort.trim()}:{},token:f.api_key.trim()},catalog:{version:f.catalog_version.trim(),sha256:f.catalog_sha256.trim(),json:f.catalog_json}}}const S=h==="codex"?{capabilities:["stream_chunk","local_action_v1","agent_invoke"],localActions:["session_control","get_context","set_model","set_mode","set_reasoning_effort","set_service_tier","set_sandbox_mode","exec_approve","exec_reject","file_list","create_folder","turn_interrupt","permission_approve","permission_reject","thread_compact",l,g]}:null,te=h==="claude"?{localActions:["session_control","set_mode","set_model","set_reasoning_effort","claude_interaction_reply","exec_approve","exec_reject","file_list","create_folder","thread_compact",l,g]}:null,M=w?{capabilities:["stream_chunk","local_action_v1"],localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","file_list","create_folder",l],adapterHint:"qwen/base"}:null,x=h==="pi"?{adapterHint:"pi/base",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_provider","set_model","get_context","file_list","create_folder",l,g]}:null,D=h==="openhuman"?{adapterHint:"openhuman/base",capabilities:["local_action_v1"],localActions:["session_control","set_model","file_list","create_folder"]}:null,O=h==="cursor"?{adapterHint:"cursor/base",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_model","set_mode","get_context","file_list","create_folder","thread_compact","claude_interaction_reply",g]}:null,q=h==="codewhale"?{capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_model","file_list","create_folder",l]}:null,R=h==="opencode"?{adapterHint:"opencode/base",capabilities:["stream_chunk","local_action_v1"],localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","claude_interaction_reply","file_list","create_folder"]}:null,j=h==="agy"?{adapterHint:"agy/base",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_model","file_list","create_folder",g]}:null,L=h==="deepseek-harness"?{adapterHint:c?"deepseek/jsonrpc-v1":"deepseek/grix-bridge-v1",capabilities:["stream_chunk","local_action_v1"],localActions:["session_control","set_provider","set_model","set_mode","set_thinking","set_reasoning_effort","set_preset","set_profile","create_profile",l,g,"exec_approve","exec_reject","permission_approve","permission_reject","file_list","create_folder","dsh_bridge_status","dsh_install_bridge","dsh_list_plugins","dsh_enable_plugin","dsh_disable_plugin","dsh_refresh_plugins","dsh_list_skills","dsh_enable_skill","dsh_disable_skill","dsh_list_mcp","dsh_list_tools","dsh_list_jobs","dsh_list_goals"]}:null,G=new Set(["hermes","reasonix","kimi","copilot","acp","qodercli","qoderclicn","mcode","dim","traecli","grok","qwenpaw","zeroclaw","codebuddy"]),ne=_&&!G.has(t),se=_&&!w?{localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","claude_interaction_reply","file_list","create_folder",...t==="kimi"?["set_reasoning_effort"]:[],...ne?[l]:[]]}:null,ae=t==="kiro"?{localActions:["exec_approve","exec_reject","permission_approve","permission_reject","session_control","set_model","set_mode","file_list","create_folder","thread_compact",l,g]}:null,re=h==="codex"||h==="claude"||h==="opencode"||h==="deepseek-harness"||t==="gemini"?["session_control","set_model","set_mode",...h==="deepseek-harness"?["set_provider","set_thinking","set_reasoning_effort","set_preset","set_profile","create_profile","dsh_list_plugins","dsh_enable_plugin","dsh_disable_plugin","dsh_refresh_plugins","dsh_list_skills","dsh_enable_skill","dsh_disable_skill"]:[],...h==="claude"?["set_reasoning_effort"]:[]]:void 0,ie=h==="cursor"||h==="opencode"||h==="openhuman"||h==="agy"||_&&G.has(t)?[g]:[l,g];_&&y.raw_transport===void 0&&(y.raw_transport=t==="gemini");const oe=`${t}/base`,I=ve(h,t),ce=I==="kiro"?void 0:process.cwd(),N=Z(a.provider),U=Je(s.env,a.env),v={...process.env,...U};if(I==="hermes"&&!v.HERMES_HOME?.trim()){const f=Me(t,N);v.HERMES_HOME=De({...f,...v},a.name)}const E=h==="claude"?Ce(v):void 0,B=Pe({mode:I,projectDir:ce,env:v,claudeConfigPaths:E}),H=B.filter(f=>f.source==="connector").map(f=>f.name);H.length>0&&!e.quiet&&m.info("manager",`[${a.name}] injecting connector skills: [${H.join(", ")}]`);const F=Ie(B,A.skills);let le=F.length>0?F:void 0;const de=Ee({skillsDir:A.skills,mode:I,home:W(),env:v,claudeConfigPaths:E});return{name:i,adapterType:h,...E?{claudeConfigPaths:E}:{},aibot:{url:o,agentId:a.agent_id,apiKey:a.api_key,clientType:t,clientVersion:n,adapterHint:L?.adapterHint??s.adapterHint??M?.adapterHint??x?.adapterHint??D?.adapterHint??O?.adapterHint??R?.adapterHint??j?.adapterHint??oe,capabilities:L?.capabilities??S?.capabilities??q?.capabilities??x?.capabilities??D?.capabilities??O?.capabilities??R?.capabilities??j?.capabilities??M?.capabilities??["stream_chunk","local_action_v1","connector_upgrade"],localActions:Ze(L?.localActions??S?.localActions??q?.localActions??te?.localActions??x?.localActions??D?.localActions??O?.localActions??R?.localActions??j?.localActions??M?.localActions??ae?.localActions??se?.localActions??["exec_approve","exec_reject"],re,ie,["connector_rollback","connector_upgrade_push",p,"configure_gateway_provider","skill_upload","skill_delete","skill_enable","skill_disable","skill_refresh",...d]),skills:le,librarySkills:de,terminalOutboxPath:Ye(a.name,a.agent_id)},agent:{command:c?"dsh-jsonrpc-agent":s.command,args:[...s.args??[],...a.args??[]],env:U,clientType:t,...N?{provider:N}:{}},adapterOptions:y,acpAuthMethod:y.auth_method,acpInitialMode:y.initial_mode,acpMcpTools:y.acp_mcp_tools,promptTimeoutMs:a.prompt_timeout_ms,bindingsPath:ze(a.agent_id),legacyBindingsPath:Qe(a.name,a.agent_id),activeEventStorePath:Ve(a.name,a.agent_id),pendingEventStorePath:Xe(a.agent_id),...s.enableSessionBinding||_?{enableSessionBinding:!0}:{},...he(t)?{staticCwd:ue(a.cwd)}:{},...s.autoInjectArgs||t==="reasonix"&&a.provider?.model?.trim()?{autoInjectArgs:{...s.autoInjectArgs??{},...t==="reasonix"&&a.provider?.model?.trim()?{model:a.provider.model.trim()}:{}}}:{},poolMaxSize:a.pool?.maxSize??(h==="deepseek-harness"?4:void 0),poolIdleTimeoutMs:a.pool?.idleTimeoutMs,eventQueue:et(h,a.event_queue),logDir:A.log,providerBaseUrl:a.provider_base_url?.trim()||void 0,providerApiKey:a.provider_api_key?.trim()||void 0}}function ee(){const a=process.env.GRIX_AGENT_STARTUP_WAIT_MS,e=Number(a);return Number.isFinite(e)&&e>=500?Math.floor(e):He}function P(){const a=process.env.GRIX_AGENT_STOP_WAIT_MS,e=Number(a);return Number.isFinite(e)&&e>=500?Math.floor(e):Fe}function nt(){return Math.min(P(),We)}function T(a){if(a===null||typeof a!="object")return JSON.stringify(a)??"null";if(Array.isArray(a))return`[${a.map(T).join(",")}]`;const e=a;return`{${Object.keys(e).sort().map(t=>`${JSON.stringify(t)}:${T(e[t])}`).join(",")}}`}function st(a,e){return T(a)===T(e)}class Nt{options;instances=[];configMap=new Map;rawConfigMap=new Map;mutationTail=Promise.resolve();startingInstances=new Set;failedStartAgents=new Set;removingAgents=new Set;instanceGenerations=new WeakMap;sharedInstances=new Map;shareSyncChains=new Map;stopping=!1;lifecycleAdmissionClosed=!1;deletedAgentCleanups=new Set;pendingPlatformDeletes=new Map;upgradeChecker=null;skillSyncer=null;globalConfigStore;configRepository=new J(A.config);sharedOwnersCache=new _e(A.data);installer=new je;relaySecretResolver;auditProducer=Ne();constructor(e={}){this.options=e}runMutation(e,n=[]){const t=this.mutationTail.catch(()=>{}).then(async()=>{if(this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});await this.retryPendingPlatformDeletesUnlocked();const s=new Set([...this.pendingPlatformDeletes.values()].map(c=>c.name)),r=n.find(c=>s.has(c.trim()));if(r)throw Object.assign(new Error(`Agent "${r}" is pending permanent platform-deletion cleanup`),{code:"AGENT_DELETE_PENDING"});return e()});return this.mutationTail=t.then(()=>{},()=>{}),t}async startTrackedInstance(e){this.startingInstances.add(e);try{await e.start()}finally{this.startingInstances.delete(e)}}requestStartCancellation(e){const n=e.requestStop;typeof n=="function"&&n.call(e)}async stopInstance(e,n,t=P()){let s;try{await Promise.race([e.stop(n),new Promise((r,c)=>{s=setTimeout(()=>{c(Object.assign(new Error(`Agent "${e.name}" stop timed out after ${t}ms`),{code:"AGENT_STOP_TIMEOUT"}))},t)})])}finally{s!==void 0&&clearTimeout(s)}}async waitForLifecycleDrain(e,n,t=P()){let s;try{await Promise.race([Promise.allSettled([...e]).then(()=>{}),new Promise((r,c)=>{s=setTimeout(()=>{c(Object.assign(new Error(`${n} timed out after ${t}ms`),{code:"LIFECYCLE_DRAIN_TIMEOUT"}))},t)})])}finally{s!==void 0&&clearTimeout(s)}}async waitForShutdownOperation(e,n,t){let s;try{return await Promise.race([e,new Promise((r,c)=>{s=setTimeout(()=>{c(Object.assign(new Error(`${n} timed out after ${t}ms`),{code:"SHUTDOWN_OPERATION_TIMEOUT"}))},t)})])}finally{s!==void 0&&clearTimeout(s)}}isActiveGeneration(e){const n=this.instanceGenerations.get(e);return!!n&&!n.retired&&this.instances.find(t=>t.name===n.name)===e}retireInstance(e){const n=this.instanceGenerations.get(e);n&&(n.retired=!0)}async start(e){return this.runMutation(()=>this.startUnlocked(e))}async startUnlocked(e){const n=e??A.config;this.configRepository=new J(n),m.info("manager",`Loading configs from ${n}`),Te(),z(),this.globalConfigStore=new be(b(A.data,"agent-global-configs.json")),this.globalConfigStore.load();const{entries:t,fileErrors:s,skipped:r}=this.configRepository.scan();for(const i of s)m.error("manager",`Failed to load ${i.file}: ${i.error}`);for(const i of r)m.info("manager",`Skipped ${i}: not an agent config (no "agents" key)`);if(t.length===0&&s.length===0&&r.length===0){m.warn("manager",`No agent configurations found in ${n}; daemon idle (waiting for config). Add agents under this directory then run: grix-connector reload`);return}const c=[];let o=s.length;for(const{entry:i,file:l}of t)try{const g=this.toRuntimeInstanceConfig(i);c.push({config:g,entry:i,file:l}),m.info("manager",`Loaded ${g.name} (${g.adapterType??"acp"}) from ${l}`)}catch(g){const p=typeof i?.name=="string"?i.name:"<unknown>";m.error("manager",`Invalid agent config in ${l} (name=${p}): ${g}`),o++}c.length>0&&await Ae();let u=0;if(c.length>0){const i=ee();m.info("manager",`Starting ${c.length} agent(s), startup wait=${i}ms`);const l=d=>{this.instances=this.instances.filter(h=>h!==d)},g=c.map(({config:d,entry:h,file:_})=>{const w=this.createConfiguredInstance(d);return this.instances.push(w),this.configMap.set(d.name,d),this.rawConfigMap.set(d.name,{entry:h,file:_}),{config:d,instance:w,startPromise:this.prepareProviderRuntime(d,h).then(()=>{if(this.stopping)throw this.requestStartCancellation(w),Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});return this.startTrackedInstance(w)})}}),p=await Promise.all(g.map(async d=>{const h=await new Promise(_=>{let w=!1;const y=setTimeout(()=>{w||(w=!0,_({kind:"timeout"}))},i);d.startPromise.then(()=>{w||(w=!0,clearTimeout(y),_({kind:"started"}))}).catch(S=>{w||(w=!0,clearTimeout(y),_({kind:"failed",error:S}))})});return{task:d,outcome:h}}));for(const{task:d,outcome:h}of p){if(h.kind==="started"){this.restoreCachedSharedInstances(d.config);continue}if(h.kind==="failed"){if($(h.error)){this.onAgentDeletedByPlatform(d.instance);continue}try{await this.stopInstance(d.instance),l(d.instance),this.failedStartAgents.delete(d.config.name)}catch(_){this.failedStartAgents.add(d.config.name),m.error("manager",`Failed to clean up partially started ${d.config.name}: ${_}`)}m.error("manager",`Failed to start ${d.config.name}: ${h.error}`);continue}u++,m.warn("manager",`Startup pending for ${d.config.name}, continue retrying in background`),d.startPromise.then(()=>{this.stopping||this.removingAgents.has(d.config.name)||this.isActiveGeneration(d.instance)&&(m.info("manager",`Delayed start succeeded: ${d.config.name}`),this.restoreCachedSharedInstances(d.config))}).catch(async _=>{if($(_)){this.onAgentDeletedByPlatform(d.instance);return}if(!(this.stopping||this.removingAgents.has(d.config.name))&&this.isActiveGeneration(d.instance)){try{await this.stopInstance(d.instance),l(d.instance),this.failedStartAgents.delete(d.config.name)}catch(w){this.failedStartAgents.add(d.config.name),m.error("manager",`Failed to clean up delayed start ${d.config.name}: ${w}`)}m.error("manager",`Delayed start failed: ${d.config.name}: ${_}`)}})}if(this.instances.length>0){const d=Math.max(0,this.instances.length-u);m.info("manager",`${d}/${c.length} agent(s) running now`)}u>0&&m.warn("manager",`${u} agent(s) still connecting in background`)}if(this.instances.length===0&&c.length>0)throw new Error("All agent configurations failed to start");await this.ensureAuxServices()}async ensureAuxServices(){if(this.stopping||this.configMap.size===0)return;const e=[...this.configMap.values()].map(n=>({apiKey:n.aibot.apiKey,wsUrl:n.aibot.url}));if(!this.upgradeChecker&&(this.upgradeChecker=new Se(e,()=>this.describeAnyPendingOrBackgroundWork(),()=>this.closeAllLifecycleAdmission(),{requestGracefulShutdown:this.options.requestGracefulShutdown,reopenLifecycleAdmission:()=>this.reopenAllLifecycleAdmission(),isConnected:()=>this.instances.length===0||this.instances.some(n=>n.getStatus().wsConnected),onTransactionSettled:this.options.onTransactionSettled}),await this.upgradeChecker.start(),this.stopping)){this.upgradeChecker.stop();return}this.skillSyncer||(this.skillSyncer=new ke(e,A.skills),this.skillSyncer.setOnSyncSuccess(()=>this.refreshOwnerLibrarySkills()),await this.skillSyncer.start(),this.stopping&&this.skillSyncer.stop())}refreshOwnerLibrarySkills(){const e=new Map,n=t=>{let s;try{s=t.skillsSyncGroupKey()}catch(c){m.warn("manager",`skillsSyncGroupKey failed for ${t.name}: ${c}`);return}const r=e.get(s)??[];r.push(t),e.set(s,r)};for(const t of this.instances)n(t);for(const t of this.sharedInstances.values())n(t);for(const[t,s]of e){let r=!1;const c=[];for(const o of s){if(r){c.push(o);continue}let u=!1;try{u=o.forceRefreshSkills(void 0,{force:!0,ownerLibrarySync:!0})===!0}catch(i){m.warn("manager",`owner library skills reporter threw group=${t} agent=${o.name}: ${i}`)}if(u){r=!0;continue}m.warn("manager",`owner library skills reporter failed group=${t} agent=${o.name}; trying next`)}if(!r){m.warn("manager",`owner library skills: no reporter succeeded group=${t}`);continue}for(const o of c)try{o.adoptSkillsWireHashFromDisk()}catch(u){m.warn("manager",`adoptSkillsWireHashFromDisk failed for ${o.name}: ${u}`)}}}async stop(){m.info("manager","Stopping all agents..."),this.stopping=!0;const e=nt(),n=Date.now()+e,t=()=>Math.max(1,n-Date.now()),s=new Set([...this.instances,...this.sharedInstances.values(),...this.startingInstances]);for(const o of s)this.requestStartCancellation(o);const r=new Map([...s].map(o=>[o,this.stopInstance(o,void 0,e)])),c=[];this.upgradeChecker?.stop(),this.skillSyncer?.stop();try{await this.waitForLifecycleDrain([this.mutationTail,...this.shareSyncChains.values(),...r.values()],"manager shutdown lifecycle drain",t())}catch(o){c.push(o)}this.upgradeChecker?.stop(),this.skillSyncer?.stop(),this.shareSyncChains.clear(),await Promise.all([...[...this.instances].map(async o=>{try{await(r.get(o)??this.stopInstance(o,void 0,t())),this.retireInstance(o),this.instances=this.instances.filter(u=>u!==o),this.startingInstances.delete(o)}catch(u){c.push(u)}}),...[...this.sharedInstances.entries()].map(async([o,u])=>{try{await(r.get(u)??this.stopInstance(u,void 0,t())),this.sharedInstances.get(o)===u&&this.sharedInstances.delete(o),this.startingInstances.delete(u)}catch(i){c.push(i)}})]);try{await this.waitForLifecycleDrain([this.retryPendingPlatformDeletesUnlocked(n)],"platform-delete shutdown drain",t())}catch(o){c.push(o)}try{await this.waitForShutdownOperation(Promise.resolve().then(()=>this.globalConfigStore?.flush()),"global config shutdown flush",t())}catch(o){c.push(o)}if(await this.auditProducer.stop({timeoutMs:Math.min(5e3,t())}).catch(()=>!1),z(),c.length>0)throw new AggregateError(c,"Failed to stop all agents completely");m.info("manager","All stopped")}onShareSet(e,n,t){if(this.stopping||this.removingAgents.has(n.name)||!this.isActiveGeneration(e))return;this.sharedOwnersCache.save(n.name,t);const r=(this.shareSyncChains.get(n.name)??Promise.resolve()).catch(()=>{}).then(()=>{if(!(this.stopping||this.removingAgents.has(n.name))&&this.isActiveGeneration(e))return this.syncSharedInstances(n,t,e)});this.shareSyncChains.set(n.name,r)}async syncSharedInstances(e,n,t){if(this.stopping||this.removingAgents.has(e.name)||t&&!this.isActiveGeneration(t))return;const{toAdd:s,toRemove:r}=ge(e.name,this.sharedInstances.keys(),n);for(const c of s){if(this.stopping||this.removingAgents.has(e.name)||t&&!this.isActiveGeneration(t))break;const o=fe(e.name,c);let u;try{const i=me(e,c);u=new K(i,this.globalConfigStore,this.auditProducer),u.setLifecycleBusyChecker(()=>this.describeAnyPendingOrBackgroundWork()),u.setLifecycleAdmissionCloser(()=>this.closeAllLifecycleAdmission()),u.setLifecycleAdmissionRestorer(()=>this.reopenAllLifecycleAdmission()),this.options.requestGracefulShutdown&&u.setDaemonShutdownRequester(this.options.requestGracefulShutdown),this.lifecycleAdmissionClosed&&u.closeLifecycleAdmission(),this.sharedInstances.set(o,u),await this.startTrackedInstance(u),u.forceRefreshSkills(void 0,{force:!0}),m.info("manager",`shared instance started: ${o}`)}catch(i){if(u&&!this.stopping&&!this.removingAgents.has(e.name))try{await this.stopInstance(u),this.sharedInstances.get(o)===u&&this.sharedInstances.delete(o)}catch(g){m.error("manager",`cleanup shared instance failed ${o}: ${g}`)}const l=i instanceof Error?i.message:String(i);/Auth failed/i.test(l)?(this.sharedOwnersCache.remove(e.name,c),m.warn("manager",`shared instance auth rejected, removed from cache: ${o}`)):m.error("manager",`start shared instance failed ${o}: ${i}`)}}for(const{key:c}of r){const o=this.sharedInstances.get(c);if(o)try{await this.stopInstance(o),this.sharedInstances.get(c)===o&&this.sharedInstances.delete(c),m.info("manager",`shared instance stopped: ${c}`)}catch(u){m.error("manager",`stop shared instance failed ${c}: ${u}`)}}}restoreCachedSharedInstances(e){const n=this.sharedOwnersCache.load(e.name);if(n.length===0)return;const t=this.instances.find(s=>s.name===e.name);!t||!this.isActiveGeneration(t)||(m.info("manager",`restoring ${n.length} cached shared instance(s) for ${e.name}`),this.onShareSet(t,e,n))}getAgentsStatus(){return this.instances.map(e=>e.getStatus())}async addAgent(e){return this.runMutation(()=>this.addAgentUnlocked(e),[String(e.name??"")])}async addAgentUnlocked(e){const n=this.toRuntimeInstanceConfig(e,{quiet:!0});if(this.instances.some(t=>t.name===n.name))throw new Error(`Agent "${n.name}" already exists`);this.configRepository.assertCanAdd(e),await this.addAgentInternal(e,"agents.json",{targetPersisted:!1});try{const t=this.configRepository.insert(e);this.rawConfigMap.set(e.name,t);const s=this.instances.find(c=>c.name===e.name),r=s?this.instanceGenerations.get(s):void 0;if(r){r.persisted=!0;const c=this.configMap.get(e.name);c&&this.restoreCachedSharedInstances(c)}}catch(t){try{await this.removeAgentInternal(e.name)}catch(s){throw new AggregateError([t,s],`Failed to persist and roll back agent "${e.name}"`)}throw t}await this.ensureAuxServices(),m.info("manager",`Added agent: ${e.name}`)}async addAgentInternal(e,n,t){const s=this.toRuntimeInstanceConfig(e);if(this.instances.some(r=>r.name===s.name))throw new Error(`Agent "${s.name}" already exists`);await this.startInstanceFromConfig(s,e,n,t)}createConfiguredInstance(e,n=!0){const t=new K(e,this.globalConfigStore,this.auditProducer);return this.instanceGenerations.set(t,{name:e.name,agentId:e.aibot.agentId,persisted:n,retired:!1,platformDeletedObserved:!1}),t.setUpgradeTrigger(()=>this.upgradeChecker?.triggerCheck()),this.options.requestGracefulShutdown&&t.setDaemonShutdownRequester(this.options.requestGracefulShutdown),t.setLifecycleBusyChecker(()=>this.describeAnyPendingOrBackgroundWork()),t.setLifecycleAdmissionCloser(()=>this.closeAllLifecycleAdmission()),t.setLifecycleAdmissionRestorer(()=>this.reopenAllLifecycleAdmission()),this.lifecycleAdmissionClosed&&t.closeLifecycleAdmission(),t.setInstallAgentHandler(s=>this.installAgent(s)),t.setRemoteAdminPorts({isEnabled:()=>this.remoteAdminGate?.()??!1,listInstallable:()=>this.listInstallable(),installAgent:s=>this.installAgent(s),getInstallProgress:s=>this.getInstallProgress(s),addAgent:s=>this.addAgent(s),probeAll:s=>this.probeAll(s)}),t.setShareSetHandler(s=>this.onShareSet(t,e,s)),t.setAgentDeletedHandler(()=>this.onAgentDeletedByPlatform(t)),t.setSkillSyncHandler(()=>this.skillSyncer?.triggerSync()),t.setProviderConfigHandler(s=>this.setAgentProvider(e.name,s)),t.setRelayStateApplyPorts({getLocalState:()=>this.relayStateApplier?.getLocalState(e.name)??{enabled:!1},getAppliedMode:()=>this.relayStateApplier?.getAppliedMode?.(e.name),applyEnable:(s,r)=>{const c=this.relayStateApplier;return c?c.applyEnable(e.name,s,r):Promise.reject(new Error("relay state applier is not configured"))},applyDisable:()=>{const s=this.relayStateApplier;return s?s.applyDisable(e.name):Promise.reject(new Error("relay state applier is not configured"))}}),t.setRelayEnvSettledHandler(()=>this.relayEnvSettledHandler?.()),t.setProviderResolver(()=>Z(this.getAgentProvider(e.name))),t}describeAnyPendingOrBackgroundWork(){return[...this.instances.flatMap(e=>e.describePendingOrBackgroundWork()),...[...this.sharedInstances.values()].flatMap(e=>e.describePendingOrBackgroundWork())]}closeAllLifecycleAdmission(){this.lifecycleAdmissionClosed=!0;for(const e of this.instances)e.closeLifecycleAdmission();for(const e of this.sharedInstances.values())e.closeLifecycleAdmission()}reopenAllLifecycleAdmission(){if(!this.stopping){this.lifecycleAdmissionClosed=!1;for(const e of this.instances)e.openLifecycleAdmission();for(const e of this.sharedInstances.values())e.openLifecycleAdmission()}}async prepareProviderRuntime(e,n){const t=this.resolveAgentProvider(n.provider);Q(n.client_type)&&t?.base_url?.trim()&&t?.api_key?.trim()&&t?.model?.trim()&&await V(e.name,{baseUrl:t.base_url.trim(),apiKey:t.api_key.trim(),model:t.model.trim()})}async startInstanceFromConfig(e,n,t,s){if(this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});if(await this.prepareProviderRuntime(e,n),this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"MANAGER_STOPPING"});const r=this.createConfiguredInstance(e,s.targetPersisted);this.instances.push(r);const c=this.startTrackedInstance(r),o=ee(),u=await new Promise(p=>{let d=!1;const h=setTimeout(()=>{d||(d=!0,p({kind:"timeout"}))},o);c.then(()=>{d||(d=!0,clearTimeout(h),p({kind:"started"}))},_=>{d||(d=!0,clearTimeout(h),p({kind:"failed",error:_}))})}),i=this.instanceGenerations.get(r);if(i?.platformDeletedObserved&&!i.persisted){const p=new we(`Agent "${e.name}" was deleted before its local configuration commit`);try{await this.stopInstance(r),this.retireInstance(r),this.instances=this.instances.filter(d=>d!==r),this.failedStartAgents.delete(e.name)}catch(d){throw this.failedStartAgents.add(e.name),new AggregateError([p,d],`Failed to clean up uncommitted deleted agent "${e.name}"`)}throw p}if(u.kind==="started"){this.configMap.set(e.name,e),this.rawConfigMap.set(e.name,{entry:n,file:t}),this.failedStartAgents.delete(e.name),s.targetPersisted&&this.restoreCachedSharedInstances(e),this.relayEnvSettledHandler?.();return}if(u.kind==="timeout"){this.configMap.set(e.name,e),this.rawConfigMap.set(e.name,{entry:n,file:t}),m.warn("manager",`Start pending for ${e.name}, continue retrying in background`),c.then(async()=>{if(!this.removingAgents.has(e.name)&&this.isActiveGeneration(r)){if(this.stopping){try{await this.stopInstance(r),this.instances=this.instances.filter(p=>p!==r)}catch(p){this.failedStartAgents.add(e.name),m.error("manager",`Failed to stop late-started ${e.name}: ${p}`)}return}this.failedStartAgents.delete(e.name),this.instanceGenerations.get(r)?.persisted&&this.restoreCachedSharedInstances(e),this.relayEnvSettledHandler?.(),m.info("manager",`Delayed start succeeded: ${e.name}`)}},async p=>{if($(p)){this.onAgentDeletedByPlatform(r);return}if(!(this.stopping||this.removingAgents.has(e.name))&&this.isActiveGeneration(r)){try{await this.stopInstance(r),this.instances=this.instances.filter(d=>d!==r),this.failedStartAgents.delete(e.name)}catch(d){this.failedStartAgents.add(e.name),m.error("manager",`Failed to clean up delayed start ${e.name}: ${d}`)}m.error("manager",`Delayed start failed ${e.name}: ${p}`)}}).catch(p=>{m.error("manager",`Delayed start finalizer failed ${e.name}: ${p}`)});return}const l=u.error;$(l)&&this.onAgentDeletedByPlatform(r);let g;try{await this.stopInstance(r),this.instances=this.instances.filter(p=>p!==r),this.failedStartAgents.delete(e.name)}catch(p){g=p,this.failedStartAgents.add(e.name)}throw s.targetPersisted&&(this.configMap.set(e.name,e),this.rawConfigMap.set(e.name,{entry:n,file:t})),g!==void 0?new AggregateError([l,g],`Failed to start and clean up agent "${e.name}"`):l}async removeAgent(e){return this.runMutation(()=>this.removeAgentUnlocked(e),[e])}async removeAgentUnlocked(e){if(!(this.instances.some(t=>t.name===e)||this.rawConfigMap.has(e)||[...this.sharedInstances.keys()].some(t=>t.startsWith(`${e}#shared:`))))throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});this.configRepository.remove(e),await this.removeAgentInternal(e),m.info("manager",`Removed agent: ${e}`),this.relayEnvSettledHandler?.()}async removeAgentInternal(e,n){this.removingAgents.add(e);try{const t=()=>n?.deadlineMs===void 0?P():Math.max(1,n.deadlineMs-Date.now()),s=this.instances.findIndex(p=>p.name===e),r=s===-1?void 0:this.instances[s],c=`${e}#shared:`,o=n?.keepShareCache?void 0:{dropPendingEvents:!0},u=new Map;r&&(this.requestStartCancellation(r),this.startingInstances.has(r)&&u.set(r,this.stopInstance(r,o,t())));for(const[p,d]of this.sharedInstances)p.startsWith(c)&&(this.requestStartCancellation(d),this.startingInstances.has(d)&&u.set(d,this.stopInstance(d,o,t())));const i=this.shareSyncChains.get(e);this.shareSyncChains.delete(e);const l=[];try{await this.waitForLifecycleDrain([...i?[i]:[],...u.values()],`agent "${e}" shared lifecycle drain`,t())}catch(p){l.push(p)}const g=[];for(const[p,d]of[...this.sharedInstances.entries()])p.startsWith(c)&&g.push((u.get(d)??this.stopInstance(d,o,t())).then(()=>{this.sharedInstances.get(p)===d&&this.sharedInstances.delete(p),this.startingInstances.delete(d)}).catch(h=>{l.push(h),m.error("manager",`stop shared instance failed ${p}: ${h}`)}));if(r)try{await(u.get(r)??this.stopInstance(r,o,t())),this.retireInstance(r);const p=this.instances.indexOf(r);p!==-1&&this.instances.splice(p,1),this.startingInstances.delete(r)}catch(p){l.push(p)}if(await Promise.all(g),!n?.keepShareCache){const p=X(e).catch(()=>{});if(n?.deadlineMs===void 0)await p;else try{await this.waitForLifecycleDrain([p],`agent "${e}" relay shutdown`,t())}catch(d){l.push(d)}}if(l.length>0)throw new AggregateError(l,`Failed to stop agent "${e}" completely`);this.configMap.delete(e),this.rawConfigMap.delete(e),this.failedStartAgents.delete(e),n?.keepShareCache||this.sharedOwnersCache.delete(e)}finally{this.removingAgents.delete(e)}}onAgentDeletedByPlatform(e){const n=this.instanceGenerations.get(e);if(!n||(n.platformDeletedObserved=!0,this.requestStartCancellation(e),!n.persisted))return;const t={source:e,name:n.name,agentId:n.agentId};this.pendingPlatformDeletes.set(e,t),!this.stopping&&(this.deletedAgentCleanups.has(e)||(this.deletedAgentCleanups.add(e),this.runMutation(async()=>{}).catch(()=>{}).finally(()=>{this.deletedAgentCleanups.delete(e)})))}async retryPendingPlatformDeletesUnlocked(e){if(this.pendingPlatformDeletes.size!==0)for(const[n,t]of[...this.pendingPlatformDeletes])try{await this.cleanupPlatformDeletedUnlocked(t,e),this.pendingPlatformDeletes.delete(n)}catch(s){m.error("manager",`cleanup for deleted agent "${t.name}" failed: ${s}`)}}async cleanupPlatformDeletedUnlocked(e,n){const{source:t,name:s,agentId:r}=e,c=this.instances.find(g=>g.name===s),o=c?this.instanceGenerations.get(c)?.agentId??String(this.rawConfigMap.get(s)?.entry.agent_id??"").trim():void 0;if(c&&c!==t&&o!==r)return;m.warn("manager",`Agent "${s}" \u5DF2\u5728\u5E73\u53F0\u5220\u9664\uFF0C\u505C\u6B62\u5B9E\u4F8B\u5E76\u6E05\u7406\u672C\u5730\u914D\u7F6E`);const u=this.rawConfigMap.get(s),i=this.configMap.get(s),l=[];if(c&&o===r)try{await this.removeAgentInternal(s,{deadlineMs:n})}catch(g){l.push(g)}try{const g=this.configRepository.scan();if(g.fileErrors.length>0){const h=g.fileErrors.map(_=>`${_.file}: ${_.error}`).join("; ");throw new Error(`cannot inspect deleted agent generation [${h}]`)}const p=g.entries.filter(h=>String(h.entry?.name??"").trim()===s);if(!p.some(h=>String(h.entry?.agent_id??"").trim()!==r)&&p.length>0&&this.configRepository.remove(s),l.length===0){const h=String(this.rawConfigMap.get(s)?.entry.agent_id??"").trim();(!h||h===r)&&(this.rawConfigMap.delete(s),this.configMap.delete(s),this.failedStartAgents.delete(s))}}catch(g){l.push(g),u&&this.rawConfigMap.set(s,u),i&&this.configMap.set(s,i)}if(l.length>0)throw new AggregateError(l,`Failed to fully clean up deleted agent "${s}"`);m.info("manager",`Agent "${s}" \u5DF2\u5728\u5E73\u53F0\u5220\u9664\uFF0C\u672C\u5730\u914D\u7F6E\u5DF2\u6E05\u7406`)}isAgentBusy(e){return this.instances.find(t=>t.name===e)?.hasPendingWork()??!1}getAgentsWithStaleRelayEnv(){return this.instances.filter(e=>e.hasStaleRelayEnv()).map(e=>e.name)}markAgentRelayEnvStale(e){const n=this.instances.find(t=>t.name===e);return n?(n.markRelayEnvStale(),!0):!1}relayEnvSettledHandler;setRelayEnvSettledHandler(e){this.relayEnvSettledHandler=e}remoteAdminGate;setRemoteAdminGate(e){this.remoteAdminGate=e}relayStateApplier;setRelayStateApplier(e){this.relayStateApplier=e}reportRelayStateLocalChange(e){this.instances.find(t=>t.name===e)?.reportRelayStateLocalChange()}setRelaySecretResolver(e){this.relaySecretResolver=e}resolveAgentProvider(e){if(!e?.api_key_ref?.trim())return e;const n=e.api_key_ref.trim(),t=this.relaySecretResolver?.(n);if(!t)throw Object.assign(new Error(`relay credential "${n}" is unavailable`),{code:"RELAY_SECRET_UNAVAILABLE"});return{...e,api_key:t}}toRuntimeInstanceConfig(e,n={}){const t=this.resolveAgentProvider(e.provider);return tt(t===e.provider?e:{...e,provider:t},n)}getAgentProvider(e){return this.resolveAgentProvider(this.rawConfigMap.get(e)?.entry.provider)}async restartAgent(e){return this.runMutation(()=>this.restartAgentUnlocked(e),[e])}async restartAgentUnlocked(e){const n=this.rawConfigMap.get(e);if(!n)throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});await this.replaceInstance(e,n.entry,n.file),m.info("manager",`Restarted agent: ${e}`)}async setAgentProvider(e,n,t){return this.runMutation(()=>this.setAgentProviderUnlocked(e,n,t),[e])}async setAgentProviderUnlocked(e,n,t){if(!this.rawConfigMap.get(e))throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});const r=n?.api_key_ref?.trim()?Object.fromEntries(Object.entries(n).filter(([i])=>i!=="api_key")):n,c=this.configRepository.updateExisting(e,i=>{const l={...i};if(r===void 0)delete l.provider;else{const g=r.quota_api_key?.trim()||i.provider?.quota_api_key?.trim();l.provider=g?{...r,quota_api_key:g}:r}return this.toRuntimeInstanceConfig(l,{quiet:!0}),l}),o=c.entry;this.rawConfigMap.set(e,c);const u=String(o.client_type??"").trim().toLowerCase();try{Q(u)&&(n?.base_url?.trim()&&n?.api_key?.trim()&&n?.model?.trim()?await V(e,{baseUrl:n.base_url.trim(),apiKey:n.api_key.trim(),model:n.model.trim()}):await X(e))}catch(i){throw this.failedStartAgents.add(e),this.instances.find(l=>l.name===e)?.markRelayEnvStale(),i}if(t?.deferRestart){this.instances.find(i=>i.name===e)?.markRelayEnvStale(),m.info("manager",`Updated provider config for agent (deferred restart): ${e}`);return}try{await this.replaceInstance(e,o,c.file)}catch(i){throw this.failedStartAgents.add(e),this.instances.find(l=>l.name===e)?.markRelayEnvStale(),i}m.info("manager",`Updated provider config for agent: ${e}`)}hasDirectRelayConfig(e){const n=this.rawConfigMap.get(e)?.entry.provider;return!!(n?.api_key_ref?.trim()||n?.api_key?.trim())}getDirectRelayConfigAgentNames(){return[...this.rawConfigMap.entries()].filter(([,e])=>!!e.entry.provider&&(xe(e.entry.client_type)||["claude","codex"].includes(String(e.entry.client_type??"").trim().toLowerCase()))).map(([e])=>e)}async fetchRelayCredential(e,n){const t=this.instances.find(s=>s.name===e);if(!t)throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});return t.fetchRelayCredential(n)}async clearDirectProviderConfigs(){const e=this.getDirectRelayConfigAgentNames(),n=[];for(const t of e)try{await this.setAgentProvider(t,void 0,{deferRestart:this.isAgentBusy(t)}),n.push(t)}catch(s){m.warn("manager",`Failed to clear provider config for "${t}": ${s instanceof Error?s.message:String(s)}`)}return n}async replaceInstance(e,n,t){const s=this.toRuntimeInstanceConfig(n);try{await this.removeAgentInternal(e,{keepShareCache:!0})}catch(o){throw this.failedStartAgents.add(e),o}const r=String(n.agent_id??"").trim();if([...this.pendingPlatformDeletes.values()].some(o=>o.name===e&&o.agentId===r))throw await this.retryPendingPlatformDeletesUnlocked(),Object.assign(new Error(`Agent "${e}" was permanently deleted while its instance was stopping`),{code:"AGENT_DELETE_PENDING"});try{await this.startInstanceFromConfig(s,n,t,{targetPersisted:!0})}catch(o){throw this.configMap.set(e,s),this.rawConfigMap.set(e,{entry:n,file:t}),o}}async reload(){return this.runMutation(()=>this.doReload())}async doReload(){if(this.stopping)throw Object.assign(new Error("manager is stopping"),{code:"RELOAD_UNSAFE"});const{entries:e,fileErrors:n,skipped:t}=this.configRepository.scan();for(const i of t)m.info("manager",`reload: skipped ${i}: not an agent config (no "agents" key)`);if(n.length>0){const i=n.map(l=>`${l.file}: ${l.error}`).join("; ");throw Object.assign(new Error(`reload aborted: ${n.length} config file(s) failed to parse [${i}]`),{code:"RELOAD_UNSAFE"})}if(e.length===0)throw Object.assign(new Error("reload aborted: no valid agent config found"),{code:"RELOAD_UNSAFE"});const s=[];for(const{entry:i}of e)try{this.toRuntimeInstanceConfig(i,{quiet:!0})}catch(l){const g=i?.name,p=typeof g=="string"&&g.trim()?g:"<unknown>";s.push({name:p,error:l instanceof Error?l.message:String(l)})}if(s.length>0){const i=s.map(l=>`${l.name}: ${l.error}`).join("; ");throw Object.assign(new Error(`reload aborted: ${s.length} agent config(s) invalid [${i}]`),{code:"RELOAD_UNSAFE"})}const r=new Map,c=new Set([...this.pendingPlatformDeletes.values()].map(i=>i.name));for(const i of e){const l=String(i.entry?.name??"").trim();l&&(c.has(l)||(r.has(l)&&m.warn("manager",`reload: duplicate agent name "${l}", last one wins`),r.set(l,i)))}const o={added:[],removed:[],restarted:[],unchanged:[],failed:[]},u=new Set([...this.rawConfigMap.keys()].filter(i=>!c.has(i)));for(const i of u)if(!r.has(i))try{await this.removeAgentInternal(i),o.removed.push(i)}catch(l){o.failed.push({name:i,error:l instanceof Error?l.message:String(l)})}for(const[i,l]of r){const g=this.rawConfigMap.get(i);if(g)if(!st(g.entry,l.entry)||!this.instances.some(p=>p.name===i)||this.failedStartAgents.has(i))try{await this.replaceInstance(i,l.entry,l.file),o.restarted.push(i)}catch(p){o.failed.push({name:i,error:p instanceof Error?p.message:String(p)})}else this.rawConfigMap.set(i,l),o.unchanged.push(i);else try{await this.addAgentInternal(l.entry,l.file,{targetPersisted:!0}),o.added.push(i)}catch(p){o.failed.push({name:i,error:p instanceof Error?p.message:String(p)})}}return m.info("manager",`reload done: +${o.added.length} -${o.removed.length} ~${o.restarted.length} =${o.unchanged.length} !${o.failed.length}`),await this.ensureAuxServices(),o}async checkUpgrade(){return this.upgradeChecker?this.upgradeChecker.checkForUpdate():{available:!1}}triggerUpgrade(){this.upgradeChecker?.triggerCheck()}async probeAll(e={}){return at(this.instances,e)}async probeOne(e,n={}){return rt(this.instances,e,n)}listInstallable(){return this.installer.listInstallable()}async installAgent(e){const n=await this.installer.install(e);return Le(n),n}getInstallProgress(e){return this.installer.getProgress(e)??null}}async function at(a,e){const n=e.concurrency??4,t=Date.now(),s=new Array(a.length);await new Promise(i=>{let l=0,g=0;const p=a.length;if(p===0){i();return}function d(w){const y=a[w];y.probe(e).then(S=>{s[w]=S,h()},S=>{s[w]={agent_name:y.name,client_type:"unknown",adapter_type:"acp",ok:!1,status:"error",probed_at:Date.now(),duration_ms:0,cached:!1,cli:{command:"",installed:!1,path:null,version:null,error:{code:"internal",message:S?.message??String(S)}},conversation:{attempted:!1,ok:!1,latency_ms:null},config:{model:null,base_url:null,source:{model:"unknown",base_url:"unknown"}},process:{started:!1,alive:!1,busy:!1}},h()})}function h(){g++,l<p?d(l++):g===p&&i()}const _=Math.min(n,p);for(let w=0;w<_;w++)d(l++)});const r=s.filter(i=>i.status==="healthy").length,c=s.filter(i=>i.status==="degraded").length,o=s.filter(i=>i.status==="unavailable").length,u=await Y();return{ok:r===s.length&&s.length>0,total:s.length,healthy:r,degraded:c,unavailable:o,installed_clients:u,agents:s,probed_at:t,duration_ms:Date.now()-t}}async function rt(a,e,n){const t=a.find(s=>s.name===e);if(!t)throw Object.assign(new Error(`Agent "${e}" not found`),{code:"NOT_FOUND"});return t.probe(n)}export{Nt as Manager,Je as mergeAgentEnv,Z as normalizeAgentProviderForRuntime,Y as probeInstalledClientCommands,at as probeInstances,rt as probeOneInstance,tt as toInstanceConfig};
@@ -1 +1 @@
1
- import*as n from"node:net";const i={bind:"127.0.0.1",port:0,endpoint:"/mcp",sessionTimeoutMs:18e5,invokeTimeoutMs:3e4};function s(u){const e={bind:u?.bind??i.bind,port:u?.port??i.port,endpoint:u?.endpoint??i.endpoint,sessionTimeoutMs:u?.sessionTimeoutMs??i.sessionTimeoutMs,invokeTimeoutMs:u?.invokeTimeoutMs??i.invokeTimeoutMs,allowedOrigins:u?.allowedOrigins,allowedHosts:u?.allowedHosts};return t(e.bind),e.port!==0&&o(e.port),r(e.sessionTimeoutMs),e}function t(u){if(!u||!n.isIPv4(u)&&!n.isIPv6(u))throw new Error(`\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: bind \u5730\u5740 "${u}" \u4E0D\u662F\u5408\u6CD5\u7684 IPv4 \u6216 IPv6 \u5730\u5740`)}function o(u){if(!Number.isInteger(u)||u<1||u>65535)throw new Error(`\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: port \u503C ${u} \u4E0D\u5728\u5408\u6CD5\u8303\u56F4 1-65535 \u5185\u6216\u4E0D\u662F\u6574\u6570`)}function r(u){if(!Number.isInteger(u)||u<1e3||u>864e5)throw new Error(`\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: session_timeout_ms \u503C ${u} \u4E0D\u5728\u5408\u6CD5\u8303\u56F4 1000-86400000 \u5185`)}export{s as createDefaultGatewayConfig};
1
+ import*as i from"node:net";const e={bind:"127.0.0.1",port:0,endpoint:"/mcp",sessionTimeoutMs:18e5,invokeTimeoutMs:3e4};function n(o){const u={bind:o?.bind??e.bind,port:o?.port??e.port,endpoint:o?.endpoint??e.endpoint,sessionTimeoutMs:o?.sessionTimeoutMs??e.sessionTimeoutMs,invokeTimeoutMs:o?.invokeTimeoutMs??e.invokeTimeoutMs,allowedOrigins:o?.allowedOrigins,allowedHosts:o?.allowedHosts};return s(u.bind),u.port!==0&&t(u.port),r(u.sessionTimeoutMs),u}function s(o){if(!o||!i.isIPv4(o)&&!i.isIPv6(o))throw new Error(`\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: bind \u5730\u5740 "${o}" \u4E0D\u662F\u5408\u6CD5\u7684 IPv4 \u6216 IPv6 \u5730\u5740`)}function t(o){if(!Number.isInteger(o)||o<1||o>65535)throw new Error(`\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: port \u503C ${o} \u4E0D\u5728\u5408\u6CD5\u8303\u56F4 1-65535 \u5185\u6216\u4E0D\u662F\u6574\u6570`)}function r(o){if(!Number.isInteger(o)||o<1e3||o>864e5)throw new Error(`\u914D\u7F6E\u6821\u9A8C\u5931\u8D25: session_timeout_ms \u503C ${o} \u4E0D\u5728\u5408\u6CD5\u8303\u56F4 1000-86400000 \u5185`)}export{n as createDefaultGatewayConfig};
@@ -1 +1 @@
1
- const a=3e4;class c{connectionManager;onDisconnected;bindings=new Map;constructor(n,i){this.connectionManager=n,this.onDisconnected=i}async bind(n,i){if(this.bindings.has(n))throw new Error(`Session ${n} is already bound to a connection`);const e=await this.connectWithTimeout(i),t=[],s=e.onDisconnected(()=>{this.removeBinding(n),this.onDisconnected(n)});return t.push(s),this.bindings.set(n,{sessionId:n,handle:e,subscriptions:t}),e}getHandle(n){return this.bindings.get(n)?.handle}unbind(n){const i=this.bindings.get(n);if(i){this.bindings.delete(n);for(const e of i.subscriptions)e();i.handle.disconnect()}}unbindAll(){const n=[...this.bindings.keys()];for(const i of n)this.unbind(i)}connectWithTimeout(n){return new Promise((i,e)=>{let t=!1;const s=setTimeout(()=>{t||(t=!0,e(new Error("Connection bind timeout after 30000ms")))},3e4);this.connectionManager.connect({agentId:n.agentId,apiKey:n.apiKey,url:n.wsUrl,clientType:n.clientType,capabilities:["agent_invoke"],adapterHint:`${n.clientType}/base`},{maxRetries:0}).then(o=>{t?o.disconnect():(t=!0,clearTimeout(s),i(o))}).catch(o=>{t||(t=!0,clearTimeout(s),e(o))})})}removeBinding(n){const i=this.bindings.get(n);if(i){this.bindings.delete(n);for(const e of i.subscriptions)e()}}}export{c as ConnectionBindingImpl};
1
+ const r=3e4;class c{connectionManager;onDisconnected;bindings=new Map;constructor(n,i){this.connectionManager=n,this.onDisconnected=i}async bind(n,i){if(this.bindings.has(n))throw new Error(`Session ${n} is already bound to a connection`);const e=await this.connectWithTimeout(i),t=[],s=e.onDisconnected(()=>{this.removeBinding(n),this.onDisconnected(n)});return t.push(s),this.bindings.set(n,{sessionId:n,handle:e,subscriptions:t}),e}getHandle(n){return this.bindings.get(n)?.handle}unbind(n){const i=this.bindings.get(n);if(i){this.bindings.delete(n);for(const e of i.subscriptions)e();i.handle.disconnect()}}unbindAll(){const n=[...this.bindings.keys()];for(const i of n)this.unbind(i)}connectWithTimeout(n){return new Promise((i,e)=>{let t=!1;const s=setTimeout(()=>{t||(t=!0,e(new Error("Connection bind timeout after 30000ms")))},3e4);this.connectionManager.connect({agentId:n.agentId,apiKey:n.apiKey,url:n.wsUrl,clientType:n.clientType,capabilities:["agent_invoke"],adapterHint:`${n.clientType}/base`},{maxRetries:0}).then(o=>{t?o.disconnect():(t=!0,clearTimeout(s),i(o))}).catch(o=>{t||(t=!0,clearTimeout(s),e(o))})})}removeBinding(n){const i=this.bindings.get(n);if(i){this.bindings.delete(n);for(const e of i.subscriptions)e()}}}export{c as ConnectionBindingImpl};
@@ -1 +1 @@
1
- function a(e){const t=new Set([`http://127.0.0.1:${e.serverPort}`,`http://localhost:${e.serverPort}`,...e.allowedOrigins]),o=new Set([`127.0.0.1:${e.serverPort}`,`localhost:${e.serverPort}`,...e.allowedHosts]);return{validateRequest(s){const r=i(s,t);if(!r.ok)return r;const n=l(s,o);return n.ok?{ok:!0}:n}}}function i(e,t){const o=e.headers.origin;return o?t.has(o)?{ok:!0}:{ok:!1,statusCode:403,message:`Origin not allowed: ${o}`}:{ok:!0}}function l(e,t){const o=e.headers.host;return o?t.has(o)?{ok:!0}:{ok:!1,statusCode:403,message:`Host not allowed: ${o}`}:{ok:!1,statusCode:403,message:"Missing Host header"}}export{a as createSecurityPolicy};
1
+ function a(o){const e=new Set([`http://127.0.0.1:${o.serverPort}`,`http://localhost:${o.serverPort}`,...o.allowedOrigins]),t=new Set([`127.0.0.1:${o.serverPort}`,`localhost:${o.serverPort}`,...o.allowedHosts]);return{validateRequest(s){const r=i(s,e);if(!r.ok)return r;const n=l(s,t);return n.ok?{ok:!0}:n}}}function i(o,e){const t=o.headers.origin;return t?e.has(t)?{ok:!0}:{ok:!1,statusCode:403,message:`Origin not allowed: ${t}`}:{ok:!0}}function l(o,e){const t=o.headers.host;return t?e.has(t)?{ok:!0}:{ok:!1,statusCode:403,message:`Host not allowed: ${t}`}:{ok:!1,statusCode:403,message:"Missing Host header"}}export{a as createSecurityPolicy};
@@ -1 +1 @@
1
- import{toolCallToInvoke as i}from"../../core/mcp/tools.js";import{ToolRegistryImpl as l}from"./tool-registry.js";import{validateToolArgs as a}from"./tool-schemas.js";import{isEventTool as p,executeEventTool as d}from"./event-tool-executor.js";class y{registry;constructor(){this.registry=new l}async execute(r,e,t,n){if(!this.registry.hasTool(e))return this.errorResult(`\u672A\u77E5\u5DE5\u5177: ${e}`);const s=a(e,t);if(!s.valid)return this.errorResult(`\u53C2\u6570\u6821\u9A8C\u5931\u8D25: ${s.error}`);if(r.status!=="ready")return this.errorResult(`\u8FDE\u63A5\u4E0D\u53EF\u7528: \u5F53\u524D\u72B6\u6001\u4E3A ${r.status}`);if(p(e))return this.executeEventTool(r,e,t);const o=i(e,t);try{const u=await r.agentInvoke(o.action,o.params,n);return this.normalizeResult(u)}catch(u){const c=u instanceof Error?u.message:String(u);return c.toLowerCase().includes("timeout")?this.errorResult(`\u8C03\u7528\u8D85\u65F6: ${c}`):this.errorResult(`\u8C03\u7528\u5931\u8D25: ${c}`)}}normalizeResult(r){if(r==null||typeof r!="object")return this.successResult(r??null);const e=r,t=typeof e.code=="number"?e.code:0;if(t===0){const s="data"in e?e.data:null;return this.successResult(s??null)}const n=typeof e.msg=="string"?e.msg:"\u672A\u77E5\u9519\u8BEF";return this.errorResult(`\u4E0A\u6E38\u9519\u8BEF [code=${t}]: ${n}`)}successResult(r){return{content:[{type:"text",text:JSON.stringify(r)}],isError:!1}}errorResult(r){return{content:[{type:"text",text:r}],isError:!0}}async executeEventTool(r,e,t){return e==="grix_access_control"?this.executeAccessControl(r,t):d(r,e,t)}async executeAccessControl(r,e){const t=String(e.action??""),n={pair_approve:"pair_approve",pair_deny:"pair_deny",allow_sender:"sender_allow",remove_sender:"sender_remove",set_policy:"policy_set"}[t];if(!n)return this.errorResult(`\u672A\u77E5 access_control action: ${t}`);const s={};e.code!=null&&(s.code=e.code),e.sender_id!=null&&(s.sender_id=e.sender_id),e.policy!=null&&(s.policy=e.policy);try{const o=await r.agentInvoke("claude_access_control",{verb:n,payload:s},3e4);return this.successResult(o)}catch(o){const u=o instanceof Error?o.message:String(o);return this.errorResult(`access_control \u8C03\u7528\u5931\u8D25: ${u}`)}}}export{y as ToolExecutorImpl};
1
+ import{toolCallToInvoke as i}from"../../core/mcp/tools.js";import{ToolRegistryImpl as l}from"./tool-registry.js";import{validateToolArgs as a}from"./tool-schemas.js";import{isEventTool as p,executeEventTool as d}from"./event-tool-executor.js";class y{registry;constructor(){this.registry=new l}async execute(t,e,r,n){if(!this.registry.hasTool(e))return this.errorResult(`\u672A\u77E5\u5DE5\u5177: ${e}`);const s=a(e,r);if(!s.valid)return this.errorResult(`\u53C2\u6570\u6821\u9A8C\u5931\u8D25: ${s.error}`);if(t.status!=="ready")return this.errorResult(`\u8FDE\u63A5\u4E0D\u53EF\u7528: \u5F53\u524D\u72B6\u6001\u4E3A ${t.status}`);if(p(e))return this.executeEventTool(t,e,r);const o=i(e,r);try{const u=await t.agentInvoke(o.action,o.params,n);return this.normalizeResult(u)}catch(u){const c=u instanceof Error?u.message:String(u);return c.toLowerCase().includes("timeout")?this.errorResult(`\u8C03\u7528\u8D85\u65F6: ${c}`):this.errorResult(`\u8C03\u7528\u5931\u8D25: ${c}`)}}normalizeResult(t){if(t==null||typeof t!="object")return this.successResult(t??null);const e=t,r=typeof e.code=="number"?e.code:0;if(r===0){const s="data"in e?e.data:null;return this.successResult(s??null)}const n=typeof e.msg=="string"?e.msg:"\u672A\u77E5\u9519\u8BEF";return this.errorResult(`\u4E0A\u6E38\u9519\u8BEF [code=${r}]: ${n}`)}successResult(t){return{content:[{type:"text",text:JSON.stringify(t)}],isError:!1}}errorResult(t){return{content:[{type:"text",text:t}],isError:!0}}async executeEventTool(t,e,r){return e==="grix_access_control"?this.executeAccessControl(t,r):d(t,e,r)}async executeAccessControl(t,e){const r=String(e.action??""),n={pair_approve:"pair_approve",pair_deny:"pair_deny",allow_sender:"sender_allow",remove_sender:"sender_remove",set_policy:"policy_set"}[r];if(!n)return this.errorResult(`\u672A\u77E5 access_control action: ${r}`);const s={};e.code!=null&&(s.code=e.code),e.sender_id!=null&&(s.sender_id=e.sender_id),e.policy!=null&&(s.policy=e.policy);try{const o=await t.agentInvoke("claude_access_control",{verb:n,payload:s},3e4);return this.successResult(o)}catch(o){const u=o instanceof Error?o.message:String(o);return this.errorResult(`access_control \u8C03\u7528\u5931\u8D25: ${u}`)}}}export{y as ToolExecutorImpl};
@@ -1 +1 @@
1
- import{TOOLS as o,EVENT_TOOLS as s}from"../../core/mcp/tools.js";const e=new Set(["grix_query","grix_group","grix_message_send","grix_message_unsend","grix_admin"]),r=new Set(["grix_reply","grix_complete","grix_event_ack","grix_composing","grix_access_control","grix_status"]);class a{tools;toolMap;constructor(){this.tools=[...o.filter(t=>e.has(t.name)),...s.filter(t=>r.has(t.name))],this.toolMap=new Map(this.tools.map(t=>[t.name,t]))}getTools(){return this.tools}getTool(t){return this.toolMap.get(t)}hasTool(t){return this.toolMap.has(t)}}export{a as ToolRegistryImpl};
1
+ import{TOOLS as s,EVENT_TOOLS as t}from"../../core/mcp/tools.js";const e=new Set(["grix_query","grix_group","grix_message_send","grix_message_unsend","grix_admin"]),r=new Set(["grix_reply","grix_complete","grix_event_ack","grix_composing","grix_access_control","grix_status"]);class a{tools;toolMap;constructor(){this.tools=[...s.filter(o=>e.has(o.name)),...t.filter(o=>r.has(o.name))],this.toolMap=new Map(this.tools.map(o=>[o.name,o]))}getTools(){return this.tools}getTool(o){return this.toolMap.get(o)}hasTool(o){return this.toolMap.has(o)}}export{a as ToolRegistryImpl};
@@ -1 +1 @@
1
- const o={required:["action"],properties:{action:{type:"string",enum:["contact_search","session_search","message_history","message_search"]},id:{type:"string"},keyword:{type:"string",maxLength:200},limit:{type:"integer",minimum:1,maximum:100},offset:{type:"integer",minimum:0},sessionId:{type:"string"},beforeId:{type:"string"}}},a={required:["action"],properties:{action:{type:"string",enum:["create","detail","leave","add_members","remove_members","update_member_role","update_all_members_muted","update_member_speaking","dissolve"]},sessionId:{type:"string"},name:{type:"string",maxLength:128},memberIds:{type:"array",items:{type:"string"},maxItems:100},memberTypes:{type:"array",items:{type:"integer",enum:[1,2]}},memberId:{type:"string"},role:{type:"integer",enum:[1,2]},memberType:{type:"integer"},allMembersMuted:{type:"boolean"},isSpeakMuted:{type:"boolean"},canSpeakWhenAllMuted:{type:"boolean"}}},p={required:["sessionId","content"],properties:{sessionId:{type:"string"},content:{type:"string",maxLength:1e4},msgType:{type:"integer"},quotedMessageId:{type:"string"},threadId:{type:"string"}}},m={required:["sessionId","msgId"],properties:{sessionId:{type:"string"},msgId:{type:"string"}}},g={required:["action"],properties:{action:{type:"string",enum:["create_agent","list_categories","create_category","update_category","assign_category","rotate_api_key"]},agentName:{type:"string"},introduction:{type:"string"},isMain:{type:"boolean"},agentId:{type:"string"},categoryId:{type:"string"},name:{type:"string"},parentId:{type:"string"},sortOrder:{type:"integer"}}},y={required:["session_id","text"],properties:{event_id:{type:"string"},session_id:{type:"string"},text:{type:"string",maxLength:5e4},quoted_message_id:{type:"string"},is_final:{type:"boolean"}}},d={required:["event_id","status"],properties:{event_id:{type:"string"},status:{type:"string",enum:["responded","canceled","failed"]},msg:{type:"string",maxLength:500}}},c={required:["event_id"],properties:{event_id:{type:"string"},session_id:{type:"string"}}},l={required:["session_id","active"],properties:{session_id:{type:"string"},active:{type:"boolean"},event_id:{type:"string"}}},_={required:["action"],properties:{action:{type:"string",enum:["pair_approve","pair_deny","allow_sender","remove_sender","set_policy"]},code:{type:"string"},sender_id:{type:"string"},policy:{type:"string",enum:["allowlist","open","disabled"]}}},f={required:[],properties:{}},C={grix_query:o,grix_group:a,grix_message_send:p,grix_message_unsend:m,grix_admin:g,grix_reply:y,grix_complete:d,grix_event_ack:c,grix_composing:l,grix_access_control:_,grix_status:f};function B(r,t){const e=C[r];if(!e)return{valid:!1,error:`\u672A\u77E5\u5DE5\u5177: ${r}`};for(const i of e.required)if(t[i]===void 0||t[i]===null)return{valid:!1,error:`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${i}`};for(const[i,u]of Object.entries(t)){if(u==null)continue;const n=e.properties[i];if(!n)continue;const s=$(i,u,n);if(s)return{valid:!1,error:s}}return{valid:!0}}function $(r,t,e){switch(e.type){case"string":if(typeof t!="string")return`\u53C2\u6570 ${r} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B string\uFF0C\u5B9E\u9645 ${typeof t}`;if(e.maxLength!==void 0&&t.length>e.maxLength)return`\u53C2\u6570 ${r} \u8D85\u8FC7\u6700\u5927\u957F\u5EA6 ${e.maxLength}\uFF0C\u5B9E\u9645 ${t.length}`;if(e.enum&&!e.enum.includes(t))return`\u53C2\u6570 ${r} \u503C "${t}" \u4E0D\u5728\u5141\u8BB8\u8303\u56F4 [${e.enum.join(", ")}]`;break;case"integer":if(typeof t!="number"||!Number.isInteger(t))return`\u53C2\u6570 ${r} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B integer\uFF0C\u5B9E\u9645 ${typeof t=="number"?"\u6D6E\u70B9\u6570":typeof t}`;if(e.minimum!==void 0&&t<e.minimum)return`\u53C2\u6570 ${r} \u503C ${t} \u5C0F\u4E8E\u6700\u5C0F\u503C ${e.minimum}`;if(e.maximum!==void 0&&t>e.maximum)return`\u53C2\u6570 ${r} \u503C ${t} \u5927\u4E8E\u6700\u5927\u503C ${e.maximum}`;if(e.enum&&!e.enum.includes(t))return`\u53C2\u6570 ${r} \u503C ${t} \u4E0D\u5728\u5141\u8BB8\u8303\u56F4 [${e.enum.join(", ")}]`;break;case"boolean":if(typeof t!="boolean")return`\u53C2\u6570 ${r} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B boolean\uFF0C\u5B9E\u9645 ${typeof t}`;break;case"array":if(!Array.isArray(t))return`\u53C2\u6570 ${r} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B array\uFF0C\u5B9E\u9645 ${typeof t}`;if(e.maxItems!==void 0&&t.length>e.maxItems)return`\u53C2\u6570 ${r} \u8D85\u8FC7\u6700\u5927\u5143\u7D20\u6570 ${e.maxItems}\uFF0C\u5B9E\u9645 ${t.length}`;if(e.items)for(let i=0;i<t.length;i++){const u=t[i];if(e.items.type==="string"&&typeof u!="string")return`\u53C2\u6570 ${r}[${i}] \u7C7B\u578B\u9519\u8BEF: \u671F\u671B string\uFF0C\u5B9E\u9645 ${typeof u}`;if(e.items.type==="integer"){if(typeof u!="number"||!Number.isInteger(u))return`\u53C2\u6570 ${r}[${i}] \u7C7B\u578B\u9519\u8BEF: \u671F\u671B integer\uFF0C\u5B9E\u9645 ${typeof u}`;if(e.items.enum&&!e.items.enum.includes(u))return`\u53C2\u6570 ${r}[${i}] \u503C ${u} \u4E0D\u5728\u5141\u8BB8\u8303\u56F4 [${e.items.enum.join(", ")}]`}}break}}export{B as validateToolArgs};
1
+ const o={required:["action"],properties:{action:{type:"string",enum:["contact_search","session_search","message_history","message_search"]},id:{type:"string"},keyword:{type:"string",maxLength:200},limit:{type:"integer",minimum:1,maximum:100},offset:{type:"integer",minimum:0},sessionId:{type:"string"},beforeId:{type:"string"}}},a={required:["action"],properties:{action:{type:"string",enum:["create","detail","leave","add_members","remove_members","update_member_role","update_all_members_muted","update_member_speaking","dissolve"]},sessionId:{type:"string"},name:{type:"string",maxLength:128},memberIds:{type:"array",items:{type:"string"},maxItems:100},memberTypes:{type:"array",items:{type:"integer",enum:[1,2]}},memberId:{type:"string"},role:{type:"integer",enum:[1,2]},memberType:{type:"integer"},allMembersMuted:{type:"boolean"},isSpeakMuted:{type:"boolean"},canSpeakWhenAllMuted:{type:"boolean"}}},p={required:["sessionId","content"],properties:{sessionId:{type:"string"},content:{type:"string",maxLength:1e4},msgType:{type:"integer"},quotedMessageId:{type:"string"},threadId:{type:"string"}}},m={required:["sessionId","msgId"],properties:{sessionId:{type:"string"},msgId:{type:"string"}}},g={required:["action"],properties:{action:{type:"string",enum:["create_agent","list_categories","create_category","update_category","assign_category","rotate_api_key"]},agentName:{type:"string"},introduction:{type:"string"},isMain:{type:"boolean"},agentId:{type:"string"},categoryId:{type:"string"},name:{type:"string"},parentId:{type:"string"},sortOrder:{type:"integer"}}},y={required:["session_id","text"],properties:{event_id:{type:"string"},session_id:{type:"string"},text:{type:"string",maxLength:5e4},quoted_message_id:{type:"string"},is_final:{type:"boolean"}}},d={required:["event_id","status"],properties:{event_id:{type:"string"},status:{type:"string",enum:["responded","canceled","failed"]},msg:{type:"string",maxLength:500}}},c={required:["event_id"],properties:{event_id:{type:"string"},session_id:{type:"string"}}},l={required:["session_id","active"],properties:{session_id:{type:"string"},active:{type:"boolean"},event_id:{type:"string"}}},_={required:["action"],properties:{action:{type:"string",enum:["pair_approve","pair_deny","allow_sender","remove_sender","set_policy"]},code:{type:"string"},sender_id:{type:"string"},policy:{type:"string",enum:["allowlist","open","disabled"]}}},f={required:[],properties:{}},C={grix_query:o,grix_group:a,grix_message_send:p,grix_message_unsend:m,grix_admin:g,grix_reply:y,grix_complete:d,grix_event_ack:c,grix_composing:l,grix_access_control:_,grix_status:f};function B(u,t){const e=C[u];if(!e)return{valid:!1,error:`\u672A\u77E5\u5DE5\u5177: ${u}`};for(const i of e.required)if(t[i]===void 0||t[i]===null)return{valid:!1,error:`\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570: ${i}`};for(const[i,r]of Object.entries(t)){if(r==null)continue;const n=e.properties[i];if(!n)continue;const s=$(i,r,n);if(s)return{valid:!1,error:s}}return{valid:!0}}function $(u,t,e){switch(e.type){case"string":if(typeof t!="string")return`\u53C2\u6570 ${u} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B string\uFF0C\u5B9E\u9645 ${typeof t}`;if(e.maxLength!==void 0&&t.length>e.maxLength)return`\u53C2\u6570 ${u} \u8D85\u8FC7\u6700\u5927\u957F\u5EA6 ${e.maxLength}\uFF0C\u5B9E\u9645 ${t.length}`;if(e.enum&&!e.enum.includes(t))return`\u53C2\u6570 ${u} \u503C "${t}" \u4E0D\u5728\u5141\u8BB8\u8303\u56F4 [${e.enum.join(", ")}]`;break;case"integer":if(typeof t!="number"||!Number.isInteger(t))return`\u53C2\u6570 ${u} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B integer\uFF0C\u5B9E\u9645 ${typeof t=="number"?"\u6D6E\u70B9\u6570":typeof t}`;if(e.minimum!==void 0&&t<e.minimum)return`\u53C2\u6570 ${u} \u503C ${t} \u5C0F\u4E8E\u6700\u5C0F\u503C ${e.minimum}`;if(e.maximum!==void 0&&t>e.maximum)return`\u53C2\u6570 ${u} \u503C ${t} \u5927\u4E8E\u6700\u5927\u503C ${e.maximum}`;if(e.enum&&!e.enum.includes(t))return`\u53C2\u6570 ${u} \u503C ${t} \u4E0D\u5728\u5141\u8BB8\u8303\u56F4 [${e.enum.join(", ")}]`;break;case"boolean":if(typeof t!="boolean")return`\u53C2\u6570 ${u} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B boolean\uFF0C\u5B9E\u9645 ${typeof t}`;break;case"array":if(!Array.isArray(t))return`\u53C2\u6570 ${u} \u7C7B\u578B\u9519\u8BEF: \u671F\u671B array\uFF0C\u5B9E\u9645 ${typeof t}`;if(e.maxItems!==void 0&&t.length>e.maxItems)return`\u53C2\u6570 ${u} \u8D85\u8FC7\u6700\u5927\u5143\u7D20\u6570 ${e.maxItems}\uFF0C\u5B9E\u9645 ${t.length}`;if(e.items)for(let i=0;i<t.length;i++){const r=t[i];if(e.items.type==="string"&&typeof r!="string")return`\u53C2\u6570 ${u}[${i}] \u7C7B\u578B\u9519\u8BEF: \u671F\u671B string\uFF0C\u5B9E\u9645 ${typeof r}`;if(e.items.type==="integer"){if(typeof r!="number"||!Number.isInteger(r))return`\u53C2\u6570 ${u}[${i}] \u7C7B\u578B\u9519\u8BEF: \u671F\u671B integer\uFF0C\u5B9E\u9645 ${typeof r}`;if(e.items.enum&&!e.items.enum.includes(r))return`\u53C2\u6570 ${u}[${i}] \u503C ${r} \u4E0D\u5728\u5141\u8BB8\u8303\u56F4 [${e.items.enum.join(", ")}]`}}break}}export{B as validateToolArgs};
@@ -187,6 +187,9 @@ function computeAibotSendThrottleDelayMs(sentAtMs, nowMs, limit = resolveAibotSe
187
187
  // src/core/protocol/protocol-text.ts
188
188
  var AIBOT_PROTOCOL_MAX_RUNES = 16 * 1024;
189
189
  var AIBOT_PROTOCOL_MAX_BYTES = 12 * 1024;
190
+ var AIBOT_PROTOCOL_MAX_MESSAGE_RUNES = 64 * 1024;
191
+ var AIBOT_PROTOCOL_MAX_EXTRA_BYTES = 32 * 1024;
192
+ var AIBOT_PROTOCOL_MAX_PACKET_BYTES = 1 << 20;
190
193
  var DEFAULT_OUTBOUND_TEXT_CHUNK_LIMIT = 1200;
191
194
  var DEFAULT_STREAM_CHUNK_LIMIT = 48;
192
195
  function normalizePositiveInt(value, fallbackValue) {
@@ -206,10 +209,8 @@ function resolveStreamTextChunkLimit(value) {
206
209
  normalizePositiveInt(value, DEFAULT_STREAM_CHUNK_LIMIT)
207
210
  );
208
211
  }
209
- function splitTextForAibotProtocol(text, preferredRunes) {
210
- const source = String(text ?? "");
212
+ function splitText(source, runeLimit, byteLimit) {
211
213
  if (!source) return [];
212
- const runeLimit = resolveOutboundTextChunkLimit(preferredRunes, DEFAULT_OUTBOUND_TEXT_CHUNK_LIMIT);
213
214
  const chunks = [];
214
215
  let current = "";
215
216
  let currentRunes = 0;
@@ -218,7 +219,7 @@ function splitTextForAibotProtocol(text, preferredRunes) {
218
219
  const runeBytes = Buffer.byteLength(rune, "utf8");
219
220
  const nextRunes = currentRunes + 1;
220
221
  const nextBytes = currentBytes + runeBytes;
221
- if (current && (nextRunes > runeLimit || nextBytes > AIBOT_PROTOCOL_MAX_BYTES)) {
222
+ if (current && (nextRunes > runeLimit || byteLimit !== void 0 && nextBytes > byteLimit)) {
222
223
  chunks.push(current);
223
224
  current = "";
224
225
  currentRunes = 0;
@@ -231,6 +232,11 @@ function splitTextForAibotProtocol(text, preferredRunes) {
231
232
  if (current) chunks.push(current);
232
233
  return chunks;
233
234
  }
235
+ function splitTextForAibotProtocol(text, preferredRunes) {
236
+ const source = String(text ?? "");
237
+ const runeLimit = resolveOutboundTextChunkLimit(preferredRunes, DEFAULT_OUTBOUND_TEXT_CHUNK_LIMIT);
238
+ return splitText(source, runeLimit, AIBOT_PROTOCOL_MAX_BYTES);
239
+ }
234
240
 
235
241
  // src/openclaw/shared/file-listing/handler.ts
236
242
  import * as os2 from "node:os";
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: grix-agent-dispatch
3
- description: Dispatch one of the owner's other agents to do work in a given directory (`grix_dispatch_agent`), and update an agent's display name and/or text introduction (`grix_agent_update`). Dispatched agents write back via the skill procedure `report_dispatch_result` (not a tool; wire format `[dispatch-result]` via `grix_session_send` with `quoted_message_id`). Trigger when the user asks to hand a task to another agent, run work in a specific directory via a sibling agent, stop or redirect a dispatched agent that is still working, rename an agent / change an agent's introduction, or when you were dispatched and must report via `report_dispatch_result`.
3
+ description: Dispatch one of the owner's other agents to do work in a given directory (`grix_dispatch_agent`), and update an agent's display name and/or text introduction (`grix_agent_update`). Dispatched agents write back via the skill procedure `report_dispatch_result` (not a tool; wire format `[dispatch-result]` via `grix_session_send` with `quoted_message_id`). Trigger when the user asks to hand a task to another agent, run work in a specific directory via a sibling agent, add work to an existing dispatched session (check its queue first), stop or redirect a dispatched agent that is still working, rename an agent / change an agent's introduction, or when you were dispatched and must report via `report_dispatch_result`.
4
4
  ---
5
5
 
6
6
  # Grix Agent Dispatch
@@ -120,6 +120,32 @@ You may call `grix_chat_state_query` **once** for the dispatched session id
120
120
 
121
121
  Never query message history as a substitute for the callback or `final_result`.
122
122
 
123
+ ### Adding work to an existing dispatched session — check the queue first
124
+
125
+ `grix_dispatch_agent` always opens a new session. When you instead send more
126
+ work into a session whose dispatched agent may still be busy, remember that it
127
+ runs its queue **serially**: a new message is only seen after everything ahead
128
+ of it finishes. Never just append to the tail:
129
+
130
+ 1. **Look first.** Call `grix_chat_queue` with `action: "list"` and
131
+ `session_id` = the dispatched work session (tool semantics are in the
132
+ `grix-chat-state` skill). Note what is running and what is queued.
133
+ 2. **Decide by what you see:**
134
+
135
+ | Situation | Action |
136
+ | --- | --- |
137
+ | The new task supersedes or voids a queued instruction | `cancel` the stale item, or `edit` it so old and new become one message |
138
+ | Urgent, or the running task is heading the wrong way | `cancel` stale queued items **first**; then, only if the running task must stop, send a standalone `/stop` (next section) before the new task; if other items remain ahead of it, `reorder` the new task to the front |
139
+ | Unrelated to the current task, and the current task is long | Do not queue — dispatch it into a new session with `grix_dispatch_agent` so it runs in parallel |
140
+ | None of the above | Append normally |
141
+
142
+ 3. **Verify.** Call `list` again and confirm the running task is the one that
143
+ should be running. A `confirmed: false` result is unverified until `list`
144
+ shows it.
145
+
146
+ `cancel`, `edit`, and `reorder` only touch queued tasks; only `/stop` reaches
147
+ the running one.
148
+
123
149
  ### Aborting or redirecting a running dispatched task
124
150
 
125
151
  A dispatched agent that is still working **queues** incoming messages: anything
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "grix-connector",
3
- "version": "5.0.0",
3
+ "version": "5.1.1",
4
4
  "description": "Connect local AI coding agents (Claude, Codex, Gemini, Qwen, DeepSeek, Cursor, OpenCode, Pi, OpenHuman, Reasonix) to the Grix scheduling platform. Also serves as an OpenClaw plugin for Grix channel transport.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",