@seanhogg/builderforce-agents 2026.10.3 → 2026.10.4

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.
Files changed (143) hide show
  1. package/dist/{agent-CxhUn-aN.js → agent-Cu57zjv6.js} +1 -1
  2. package/dist/{agent-CiEaiH-p.js → agent-LoZ_09Jv.js} +1 -1
  3. package/dist/{agents-DkKFDcYq.js → agents-Dgrr6E7S.js} +1 -1
  4. package/dist/{agents-IZrPoZIi.js → agents-DiRof4zA.js} +1 -1
  5. package/dist/{audio-preflight-COZAlqnx.js → audio-preflight-Cg4vjX8I.js} +1 -1
  6. package/dist/{auth-choice-CrYQF7zX.js → auth-choice-BJmosINc.js} +1 -1
  7. package/dist/{auth-choice-DhUBmu6y.js → auth-choice-CDoW8QDy.js} +1 -1
  8. package/dist/{auth-choice.apply-Botyf6Sg.js → auth-choice.apply-25j_lhua.js} +1 -1
  9. package/dist/{auth-choice.apply-k9tk1hGj.js → auth-choice.apply-CE1TC_Ts.js} +1 -1
  10. package/dist/{auth-choice.apply-Cch5UXis.js → auth-choice.apply-DSHzvYNu.js} +1 -1
  11. package/dist/{auth-choice.apply-CXRcLO-h.js → auth-choice.apply-ND2C2oSe.js} +1 -1
  12. package/dist/{auth-choice.apply.transformers-BkN8HlZJ.js → auth-choice.apply.transformers-BF-qyu2L.js} +1 -1
  13. package/dist/{auth-choice.apply.transformers-B9SieNNk.js → auth-choice.apply.transformers-CBQbUAwr.js} +1 -1
  14. package/dist/{auth-choice.apply.transformers-D02W3zy7.js → auth-choice.apply.transformers-DE9QrzbX.js} +1 -1
  15. package/dist/{auth-choice.apply.transformers-Dnr7Izx1.js → auth-choice.apply.transformers-vr05ATPq.js} +1 -1
  16. package/dist/{banner-Bd45EXyp.js → banner-Bx4c92N8.js} +1 -1
  17. package/dist/build-info.json +3 -3
  18. package/dist/{builderforce-BxVfTQsc.js → builderforce-DHU87PJG.js} +1 -1
  19. package/dist/{builderforce-C86noipf.js → builderforce-DgYCZ3Up.js} +1 -1
  20. package/dist/bundled/boot-md/handler.js +1 -1
  21. package/dist/bundled/session-memory/handler.js +1 -1
  22. package/dist/{channel-options-BHetVK54.js → channel-options-BZoCW2EZ.js} +1 -1
  23. package/dist/{channel-options-D5PmuxT-.js → channel-options-DAkHvC-x.js} +1 -1
  24. package/dist/{channel-web-B5QgCj6B.js → channel-web-BWEX1FnI.js} +1 -1
  25. package/dist/{channels-cli-sHtDH37K.js → channels-cli-DHFIXbTT.js} +1 -1
  26. package/dist/{channels-cli-CgZqXqUm.js → channels-cli-DvkQEBwz.js} +1 -1
  27. package/dist/chrome-CbBg1ngA.js +4 -0
  28. package/dist/{cli-DKoe6Ywl.js → cli-C9bsC2UP.js} +1 -1
  29. package/dist/{cli-DlaHihmr.js → cli-DnMFuBeA.js} +1 -1
  30. package/dist/{command-registry-FQIQbQAx.js → command-registry-DUOpdtcT.js} +1 -1
  31. package/dist/{command-registry-BhyY4aXy.js → command-registry-DrRz6Wgg.js} +1 -1
  32. package/dist/{completion-cli-D86ydD3X.js → completion-cli-BtLeKqh_.js} +1 -1
  33. package/dist/{completion-cli-H4iKy2_f.js → completion-cli-Cq33pQdJ.js} +1 -1
  34. package/dist/{completion-cli-CoFRiwNp.js → completion-cli-EbyCUnCP.js} +1 -1
  35. package/dist/{completion-cli-DF6vmGRs.js → completion-cli-mzQa8oTd.js} +1 -1
  36. package/dist/{config-cli-D6KAk3vw.js → config-cli-BIQl_nrn.js} +1 -1
  37. package/dist/{config-cli-9HoPtGDR.js → config-cli-Dw1pr9MW.js} +1 -1
  38. package/dist/{configure-B_FvthXy.js → configure-B1HJIRSM.js} +1 -1
  39. package/dist/{configure-CYwCU0Hw.js → configure-BPX5i4at.js} +1 -1
  40. package/dist/{configure-BgZGeNXf.js → configure-CKm9_xkS.js} +1 -1
  41. package/dist/{configure-6QCgecON.js → configure-CQPFd8N9.js} +1 -1
  42. package/dist/{deps-jUQM2eq1.js → deps-DN7fhGiB.js} +1 -1
  43. package/dist/{doctor-completion-CZrfkBfj.js → doctor-completion-B7JXY8EJ.js} +1 -1
  44. package/dist/{doctor-completion-BSbAN5p1.js → doctor-completion-BEVC1EV7.js} +1 -1
  45. package/dist/{embedded-CA0n2tyG.js → embedded-BBM-usEa.js} +7 -7
  46. package/dist/{embedded-SSuKQ6Yc.js → embedded-CIuP-6Ex.js} +2 -2
  47. package/dist/entry.js +1 -1
  48. package/dist/extensionAPI.js +1 -1
  49. package/dist/{gateway-cli-8SuDvuCq.js → gateway-cli-CvdguqNO.js} +2 -2
  50. package/dist/{gateway-cli-D5pW1jLs.js → gateway-cli-DvMzpFIF.js} +2 -2
  51. package/dist/{health-BLW40WUJ.js → health-Bd0YvHPq.js} +1 -1
  52. package/dist/{health-DqZB_jd8.js → health-CcUquV5P.js} +1 -1
  53. package/dist/{health-Cggr6c-2.js → health-CoTbsx1p.js} +1 -1
  54. package/dist/{hooks-cli-BQZjt-Fk.js → hooks-cli-D1mx0_F_.js} +1 -1
  55. package/dist/{hooks-cli-D5Zt0sN4.js → hooks-cli-Dr0hMOiz.js} +1 -1
  56. package/dist/index.js +2 -2
  57. package/dist/llm-slug-generator.js +1 -1
  58. package/dist/{models-DH9Vrv7O.js → models-D3MukbTO.js} +1 -1
  59. package/dist/{models-cli-DLZZwy_m.js → models-cli-CBUEjJ_T.js} +1 -1
  60. package/dist/{models-cli-CAaWi4TX.js → models-cli-nD2MyRO3.js} +1 -1
  61. package/dist/{models-bp562zNz.js → models-px2EtCBB.js} +1 -1
  62. package/dist/{onboard-pzmSj6MG.js → onboard-CelRLEbD.js} +1 -1
  63. package/dist/{onboard-CpFQ-bpz.js → onboard-D_Ja6cJL.js} +1 -1
  64. package/dist/{onboard-channels-BsMS0Ehd.js → onboard-channels-C5v3gxTE.js} +1 -1
  65. package/dist/{onboard-channels-D1FMu5M8.js → onboard-channels-CEMtoVzX.js} +1 -1
  66. package/dist/{onboard-channels-CKWKLbTn.js → onboard-channels-DIvxrZLb.js} +1 -1
  67. package/dist/{onboard-channels-CqXCWPaQ.js → onboard-channels-pPjt4AF5.js} +1 -1
  68. package/dist/{onboard-interactive-BAcb1Yd8.js → onboard-interactive-BIVMtUaZ.js} +1 -1
  69. package/dist/{onboard-interactive-COTt-hGf.js → onboard-interactive-CeQp6fAt.js} +1 -1
  70. package/dist/{onboard-interactive-B_YG0JwA.js → onboard-interactive-D3YgFz9n.js} +1 -1
  71. package/dist/{onboard-interactive-BdwTeKJ2.js → onboard-interactive-tVpsWM3V.js} +1 -1
  72. package/dist/{onboarding-C8IDtM8O.js → onboarding-B9P9Rocf.js} +2 -2
  73. package/dist/{onboarding-BhMZqtBx.js → onboarding-DXxufSuN.js} +2 -2
  74. package/dist/{onboarding.finalize-DpyMh92r.js → onboarding.finalize-BJbv33Sa.js} +1 -1
  75. package/dist/{onboarding.finalize-DEhEHZPV.js → onboarding.finalize-CiIdxWgH.js} +1 -1
  76. package/dist/{outbound-send-deps-CKOfRpqk.js → outbound-send-deps-DL5n0r7v.js} +1 -1
  77. package/dist/{plugin-registry-Bi-9AQMd.js → plugin-registry-B5gTbK3m.js} +1 -1
  78. package/dist/{plugin-registry-nxUQWv6l.js → plugin-registry-CBXZbshG.js} +1 -1
  79. package/dist/{plugin-registry-BlKyKAq2.js → plugin-registry-DEWbh_9i.js} +1 -1
  80. package/dist/{plugin-registry-CqGq9jzk.js → plugin-registry-Glc-xriO.js} +1 -1
  81. package/dist/plugin-sdk/{channel-web-C3UtHX6b.js → channel-web-CW5s6vEZ.js} +1 -1
  82. package/dist/plugin-sdk/index.js +1 -1
  83. package/dist/plugin-sdk/{reply-BTKDKB2t.js → reply-pngAtrhW.js} +2 -2
  84. package/dist/plugin-sdk/{web-CsPSK9U2.js → web-DfrDkFj_.js} +1 -1
  85. package/dist/{plugins-CUhWH9-E.js → plugins-BJNBD6Si.js} +1 -1
  86. package/dist/{plugins-B8Lge-oB.js → plugins-BZnMash4.js} +1 -1
  87. package/dist/{plugins-cli-c36MSKiX.js → plugins-cli-Cv_bwpr4.js} +1 -1
  88. package/dist/{plugins-cli-CgjC_YvF.js → plugins-cli-DkFN_JgK.js} +1 -1
  89. package/dist/{program-QMtnfrM_.js → program-DYU1raxm.js} +2 -2
  90. package/dist/{program-context-BgCNjcCh.js → program-context-D4S-3zNt.js} +1 -1
  91. package/dist/{prompt-select-styled-CWG9o2CX.js → prompt-select-styled-BhKY5Oj4.js} +1 -1
  92. package/dist/{prompt-select-styled-m1_NXutn.js → prompt-select-styled-D1StbM6j.js} +1 -1
  93. package/dist/{provider-auth-helpers-BFCTgzr_.js → provider-auth-helpers-5ZQb3SEz.js} +1 -1
  94. package/dist/{provider-auth-helpers-D0eiRpeb.js → provider-auth-helpers-Cibq8oDi.js} +1 -1
  95. package/dist/{provider-dispatcher-Djomkp5i.js → provider-dispatcher-Bwaplzm8.js} +1 -1
  96. package/dist/{provider-dispatcher-B6kumPDM.js → provider-dispatcher-kL8Yl9XU.js} +1 -1
  97. package/dist/{push-apns-DalSFp-6.js → push-apns-BXmSvfvx.js} +1 -1
  98. package/dist/{push-apns-DwSjHMuA.js → push-apns-C9hsLIBU.js} +1 -1
  99. package/dist/{pw-ai-1DyAPekE.js → pw-ai-BLyUwyRC.js} +1 -1
  100. package/dist/{register.agent-BZn434eF.js → register.agent-C4x77WJe.js} +1 -1
  101. package/dist/{register.agent-DNaHcARI.js → register.agent-CbP_v3k5.js} +1 -1
  102. package/dist/{register.configure-GTH7BPIx.js → register.configure-B-j2lVkz.js} +1 -1
  103. package/dist/{register.configure-Bflad790.js → register.configure-BsBerk8U.js} +1 -1
  104. package/dist/{register.maintenance-Dl7P66Jm.js → register.maintenance-B83yzc-P.js} +1 -1
  105. package/dist/{register.maintenance-B1XK1zeY.js → register.maintenance-WLPWJ7vr.js} +1 -1
  106. package/dist/{register.message-CJS3PPCy.js → register.message-BVo8xLbS.js} +1 -1
  107. package/dist/{register.message-CA5LiG16.js → register.message-DZ9zcORn.js} +1 -1
  108. package/dist/{register.onboard-Bj6wFSzC.js → register.onboard-CWCqKyU7.js} +1 -1
  109. package/dist/{register.onboard-4y1mzgCn.js → register.onboard-D9mB9MLj.js} +1 -1
  110. package/dist/{register.setup-Cvk8SB1q.js → register.setup-BMFb9IC4.js} +1 -1
  111. package/dist/{register.setup-zLIWO_nF.js → register.setup-C22fWTFR.js} +1 -1
  112. package/dist/{register.status-health-sessions-CjxA4ATI.js → register.status-health-sessions-BqMqFeMA.js} +1 -1
  113. package/dist/{register.status-health-sessions-CIYKmgKO.js → register.status-health-sessions-C-jqKRZ5.js} +1 -1
  114. package/dist/{register.subclis-Ua7PkPpv.js → register.subclis-Ceyv8kgc.js} +1 -1
  115. package/dist/{register.subclis-Ct4QBaKi.js → register.subclis-DxcQwaQg.js} +1 -1
  116. package/dist/{reply-gZ_yr2mJ.js → reply-BeKidf2F.js} +4 -4
  117. package/dist/{run-main-Cyc_C0B-.js → run-main-EhlBxGJB.js} +1 -1
  118. package/dist/{runner-C1sy_uJN.js → runner-P3IfAnSL.js} +3 -3
  119. package/dist/{server-node-events-CSsH-eIF.js → server-node-events-BZuSkcbo.js} +1 -1
  120. package/dist/{server-node-events-Bz_Qo5BV.js → server-node-events-CIsEZSfR.js} +1 -1
  121. package/dist/{session-dirs-fh5kvbyH.js → session-dirs-DH7k5ehu.js} +1 -1
  122. package/dist/{session-dirs-DVL9vHmq.js → session-dirs-DgwMogyJ.js} +1 -1
  123. package/dist/{status-sAc6yoa3.js → status-BY0kS_wo.js} +1 -1
  124. package/dist/{status-SPonEO1J.js → status-B_SXw9W4.js} +1 -1
  125. package/dist/{status-DZYF4S6_.js → status-BqEzSHhZ.js} +1 -1
  126. package/dist/{status-ChEjU5un.js → status-Ca-hgLW_.js} +1 -1
  127. package/dist/{status-CpxCM8BO.js → status-_KIJcQH-.js} +1 -1
  128. package/dist/{subagent-registry-BHP3_ka8.js → subagent-registry-98yia-RN.js} +4 -4
  129. package/dist/{subagent-registry-BYK0Wq_w.js → subagent-registry-Ch9dN-TR.js} +1 -1
  130. package/dist/{subagent-registry-DR5M5QUP.js → subagent-registry-CiYeuaym.js} +1 -1
  131. package/dist/{tui-Ujq2bTco.js → tui-BIpdEy5i.js} +2 -2
  132. package/dist/{tui-BsMw6I4Y.js → tui-DeG1am8h.js} +2 -2
  133. package/dist/{tui-cli-CLYxMYyC.js → tui-cli-3mxSu-O0.js} +1 -1
  134. package/dist/{tui-cli-BBKMdwDt.js → tui-cli-CXRFHYWv.js} +1 -1
  135. package/dist/{update-cli-uQLI7RCN.js → update-cli-BYhJHTZ0.js} +1 -1
  136. package/dist/{update-cli-BKcCNOzz.js → update-cli-DkgHl95y.js} +1 -1
  137. package/dist/{web-Bkk568P6.js → web--D7qJmx6.js} +1 -1
  138. package/dist/{web-wR7gzEVJ.js → web-CgypI7gs.js} +1 -1
  139. package/dist/{web-CGo9DnE4.js → web-DKmwaw7q.js} +1 -1
  140. package/dist/{web-DktK5vCb.js → web-Dvcfg5Kd.js} +1 -1
  141. package/extensions/memory-lancedb/package.json +2 -2
  142. package/package.json +1 -1
  143. package/dist/chrome-CAuboFG7.js +0 -4
@@ -235,7 +235,7 @@ REPORT every issue by calling the \`builtin_security_record\` tool, ONE call per
235
235
  - tsc: which Trust Service Criterion it maps to — 'security' | 'availability' | 'processing_integrity' | 'confidentiality' | 'privacy'.
236
236
  - location: file:line or component.
237
237
  - recommendation: a concrete, actionable fix.
238
- Each call mints an access-restricted SECURITY ticket. Do not put real finding details anywhere except these tool calls. If a criterion is clean, say so in your summary rather than filing a ticket.`,persona:{voice:`precise, skeptical, and evidence-driven`,perspective:`a control is only satisfied if the code proves it — assume nothing, verify against the real files and data flows`,decisionStyle:`risk-first: rate by exploitability and blast radius; map every finding to its Trust Service Criterion`},outputFormat:{structure:`markdown`,requiredSections:[`## SOC 2 Coverage`,`## Findings by Criterion`,`## Summary`],outputPrefix:`SECURITY:`},thinking:`high`},AGENT_ROLE_MODEL_ROLES={"code-creator":`code`,"test-generator":`code`,"refactor-agent":`code`,"code-reviewer":`verify`,"validator-agent":`verify`,"security-agent":`verify`,"bug-analyzer":`plan`,"architecture-advisor":`plan`,"documentation-agent":`utility`};function modelRoleForAgentRole(name){if(!(!name||!Object.hasOwn(AGENT_ROLE_MODEL_ROLES,name)))return AGENT_ROLE_MODEL_ROLES[name]}function getBuiltInAgentRoles(){return[CODE_CREATOR_ROLE,CODE_REVIEWER_ROLE,TEST_GENERATOR_ROLE,BUG_ANALYZER_ROLE,REFACTOR_AGENT_ROLE,DOCUMENTATION_AGENT_ROLE,ARCHITECTURE_ADVISOR_ROLE,VALIDATOR_AGENT_ROLE,SECURITY_AGENT_ROLE]}function registerPlatformPersonasAsRoles(personas){for(let p of personas){let psychometric=parsePsychometricProfile(p.psychometric),plugin={name:p.slug,description:p.description??``,capabilities:[],tools:[],persona:p.voice||p.perspective||psychometric?{voice:p.voice??``,perspective:p.perspective??``,decisionStyle:``,psychometric}:void 0,outputFormat:p.outputPrefix?{structure:`markdown`,outputPrefix:p.outputPrefix}:void 0,source:`builderforce-assigned`,active:!0};globalPersonaRegistry.register(plugin)}}function registerHiredAgentsAsRoles(agents){for(let a of agents){let basePlugin={description:`Hired agent: ${a.name}`,capabilities:a.skills,tools:a.skills,systemPrompt:a.systemPrompt,model:a.model,source:`builderforce-assigned`,active:!0},aliases=a.roleKey===a.id?[a.roleKey]:[a.roleKey,a.id];for(let alias of aliases)!alias||!alias.trim()||globalPersonaRegistry.register({...basePlugin,name:alias})}}function findAgentRole(name){return getBuiltInAgentRoles().find(role=>role.name===name)||globalPersonaRegistry.resolve(name)}const TOKENS_PER_MILLION=1e6,LOCAL_APIS=new Set([`ollama`,`llama`,`transformers`]),LOCAL_PROVIDERS=new Set([`ollama`,`lmstudio`,`freetoken`,`synapse`,`vllm`,`llama`,`builderforcellm-local`]),LOOPBACK_HOSTS=new Set([`localhost`,`127.0.0.1`,`[::1]`,`::1`,`0.0.0.0`]),finiteNonNegative=n=>typeof n==`number`&&Number.isFinite(n)&&n>=0?n:void 0;function priceForCost(cost){let input=finiteNonNegative(cost?.input),output=finiteNonNegative(cost?.output);if(!(input===void 0||output===void 0))return{input:input/TOKENS_PER_MILLION,output:output/TOKENS_PER_MILLION}}function tierForCost(cost){let price=priceForCost(cost);if(!price)return;let outputPerMillion=price.output*TOKENS_PER_MILLION;return price.input===0&&price.output===0?`FREE`:outputPerMillion<8?`STANDARD`:outputPerMillion<20?`PREMIUM`:`ULTRA`}const FREE_POOL_PROVIDERS=new Set([`builderforcellm`]),FREE_ID_MARKER=/[:-]free$/i;function isExplicitlyFree(provider,id){return FREE_POOL_PROVIDERS.has(normalizeProviderId(provider))||FREE_ID_MARKER.test(id.trim())}const isZeroCost=cost=>cost!==void 0&&cost.input===0&&cost.output===0;function isLoopbackUrl(baseUrl){if(!baseUrl)return!1;try{return LOOPBACK_HOSTS.has(new URL(baseUrl).hostname.toLowerCase())}catch{return!1}}function isLocalModel(provider,entry){return LOCAL_PROVIDERS.has(normalizeProviderId(provider))?!0:entry?.api!=null&&LOCAL_APIS.has(entry.api)||isLoopbackUrl(entry?.baseUrl)}function vendorOfCandidateKey(key){let slash=key.indexOf(`/`);return normalizeProviderId(slash===-1?key:key.slice(0,slash))}function catalogViewFromEntries(entries){let byKey=new Map;for(let entry of entries){let provider=normalizeProviderId(entry.provider??``),id=entry.id?.trim();if(!provider||!id)continue;let key=modelKey(provider,id);byKey.has(key)||byKey.set(key,{...entry,provider,id})}let rowOf=model=>{let slash=model.indexOf(`/`);if(slash!==-1)return byKey.get(modelKey(normalizeProviderId(model.slice(0,slash)),model.slice(slash+1)))},residency=model=>isLocalModel(vendorOfCandidateKey(model),rowOf(model))?`local`:`cloud`,trustedCost=model=>{if(residency(model)===`local`)return{input:0,output:0};let row=rowOf(model);if(!(!row||isZeroCost(row.cost)&&!isExplicitlyFree(row.provider,row.id)))return row.cost};return{vendorOf:vendorOfCandidateKey,tierOf:model=>tierForCost(trustedCost(model)),priceOf:model=>priceForCost(trustedCost(model)),residencyOf:residency}}function configuredEntries(cfg){let providers=cfg?.models?.providers??{};return Object.entries(providers).flatMap(([provider,pc])=>(pc?.models??[]).map(m=>({provider,id:m.id,cost:m.cost,api:m.api??pc.api,baseUrl:pc.baseUrl})))}function registryEntries(agentDir){return discoverModels(discoverAuthStorage(agentDir),agentDir).getAll().map(m=>({provider:m.provider,id:m.id,cost:m.cost,api:m.api,baseUrl:m.baseUrl}))}function loadOnPremCatalogView(params){let entries=configuredEntries(params?.cfg);try{entries.push(...registryEntries(params?.agentDir??resolveBuilderForceAgentsAgentDir()))}catch{}return catalogViewFromEntries(entries)}async function resolveRoleRoutedModel(params){try{let resolved=resolveModelRefFromString({raw:params.lead,defaultProvider:DEFAULT_PROVIDER,aliasIndex:buildModelAliasIndex({cfg:params.cfg,defaultProvider:DEFAULT_PROVIDER})});if(!resolved)return params.lead;let winner=(await seedLearnedModel({candidates:resolveFallbackCandidates({cfg:params.cfg,provider:resolved.ref.provider,model:resolved.ref.model}),...params.prompt==null?{}:{prompt:params.prompt},routing:{role:params.role,view:params.view??loadOnPremCatalogView({cfg:params.cfg})}})).ranked[0];return winner?candidateKey(winner):params.lead}catch(err){return logDebug(`[model-routing] role routing failed, keeping ${params.lead}: ${String(err)}`),params.lead}}async function resolveSubagentSpawnModel(params){let selection=resolveSubagentSpawnModelSelection(params);return(normalizeModelSelection(params.modelOverride)??resolveSubagentConfiguredModelSelection({cfg:params.cfg,agentId:params.agentId}))||!params.role?selection:resolveRoleRoutedModel({cfg:params.cfg,lead:selection,role:params.role,prompt:params.task})}async function resolveRelayTaskModel(params){try{let cfg=params.cfg??loadConfig(),gateway=normalizeProviderId(DEFAULT_PROVIDER),candidates=resolveFallbackCandidates({cfg,provider:``,model:``}).filter(c=>normalizeProviderId(c.provider)===gateway&&c.model!==DEFAULT_MODEL);return candidates.length===0?void 0:(await seedLearnedModel({candidates,prompt:params.prompt,routing:{role:`code`,view:loadOnPremCatalogView({cfg})}})).ranked[0]?.model}catch(err){logDebug(`[model-routing] relay task routing failed, engine default stands: ${String(err)}`);return}}function normalizeSpawnDepth(value){if(typeof value==`number`)return Number.isInteger(value)&&value>=0?value:void 0;if(typeof value==`string`){let trimmed=value.trim();if(!trimmed)return;let numeric=Number(trimmed);return Number.isInteger(numeric)&&numeric>=0?numeric:void 0}}function normalizeSessionKey(value){if(typeof value==`string`)return value.trim()||void 0}function readSessionStore(storePath){try{let raw=fs.readFileSync(storePath,`utf-8`),parsed=JSON5.parse(raw);if(parsed&&typeof parsed==`object`&&!Array.isArray(parsed))return parsed}catch{}return{}}function buildKeyCandidates(rawKey,cfg){if(!cfg||rawKey===`global`||rawKey===`unknown`||parseAgentSessionKey(rawKey))return[rawKey];let prefixed=`agent:${resolveDefaultAgentId(cfg)}:${rawKey}`;return prefixed===rawKey?[rawKey]:[rawKey,prefixed]}function findEntryBySessionId(store,sessionId){let normalizedSessionId=normalizeSessionKey(sessionId);if(normalizedSessionId)for(let entry of Object.values(store)){let candidateSessionId=normalizeSessionKey(entry?.sessionId);if(candidateSessionId&&candidateSessionId===normalizedSessionId)return entry}}function resolveEntryForSessionKey(params){let candidates=buildKeyCandidates(params.sessionKey,params.cfg);if(params.store){for(let key of candidates){let entry=params.store[key];if(entry)return entry}return findEntryBySessionId(params.store,params.sessionKey)}if(params.cfg)for(let key of candidates){let parsed=parseAgentSessionKey(key);if(!parsed?.agentId)continue;let storePath=resolveStorePath(params.cfg.session?.store,{agentId:parsed.agentId}),store=params.cache.get(storePath);store||(store=readSessionStore(storePath),params.cache.set(storePath,store));let entry=store[key]??findEntryBySessionId(store,params.sessionKey);if(entry)return entry}}function getSubagentDepthFromSessionStore(sessionKey,opts){let raw=(sessionKey??``).trim(),fallbackDepth=getSubagentDepth(raw);if(!raw)return fallbackDepth;let cache=new Map,visited=new Set,depthFromStore=key=>{let normalizedKey=normalizeSessionKey(key);if(!normalizedKey||visited.has(normalizedKey))return;visited.add(normalizedKey);let entry=resolveEntryForSessionKey({sessionKey:normalizedKey,cfg:opts?.cfg,store:opts?.store,cache}),storedDepth=normalizeSpawnDepth(entry?.spawnDepth);if(storedDepth!==void 0)return storedDepth;let spawnedBy=normalizeSessionKey(entry?.spawnedBy);if(!spawnedBy)return;let parentDepth=depthFromStore(spawnedBy);return parentDepth===void 0?getSubagentDepth(spawnedBy)+1:parentDepth+1};return depthFromStore(raw)??fallbackDepth}function splitModelRef(ref){if(!ref)return{provider:void 0,model:void 0};let trimmed=ref.trim();if(!trimmed)return{provider:void 0,model:void 0};let[provider,model]=trimmed.split(`/`,2);return model?{provider,model}:{provider:void 0,model:trimmed}}async function spawnSubagentDirect(params,ctx){let task=params.task,label=params.label?.trim()||``,requestedAgentId=params.agentId,modelOverride=params.model,thinkingOverrideRaw=params.thinking,cleanup=params.cleanup===`keep`||params.cleanup===`delete`?params.cleanup:`keep`,requesterOrigin=normalizeDeliveryContext({channel:ctx.agentChannel,accountId:ctx.agentAccountId,to:ctx.agentTo,threadId:ctx.agentThreadId}),runTimeoutSeconds=typeof params.runTimeoutSeconds==`number`&&Number.isFinite(params.runTimeoutSeconds)?Math.max(0,Math.floor(params.runTimeoutSeconds)):0,modelApplied=!1,cfg=loadConfig(),{mainKey,alias}=resolveMainSessionAlias(cfg),requesterSessionKey=ctx.agentSessionKey,requesterInternalKey=requesterSessionKey?resolveInternalSessionKey({key:requesterSessionKey,alias,mainKey}):alias,requesterDisplayKey=resolveDisplaySessionKey({key:requesterInternalKey,alias,mainKey}),callerDepth=getSubagentDepthFromSessionStore(requesterInternalKey,{cfg}),maxSpawnDepth=cfg.agents?.defaults?.subagents?.maxSpawnDepth??1;if(callerDepth>=maxSpawnDepth)return{status:`forbidden`,error:`sessions_spawn is not allowed at this depth (current depth: ${callerDepth}, max: ${maxSpawnDepth})`};let maxChildren=cfg.agents?.defaults?.subagents?.maxChildrenPerAgent??5,activeChildren=await countActiveRunsForSession(requesterInternalKey);if(activeChildren>=maxChildren)return{status:`forbidden`,error:`sessions_spawn has reached max active children for this session (${activeChildren}/${maxChildren})`};let requesterAgentId=normalizeAgentId(ctx.requesterAgentIdOverride??parseAgentSessionKey(requesterInternalKey)?.agentId),targetAgentId=requestedAgentId?normalizeAgentId(requestedAgentId):requesterAgentId;if(targetAgentId!==requesterAgentId){let allowAgents=resolveAgentConfig(cfg,requesterAgentId)?.subagents?.allowAgents??[],allowAny=allowAgents.some(value=>value.trim()===`*`),normalizedTargetId=targetAgentId.toLowerCase(),allowSet=new Set(allowAgents.filter(value=>value.trim()&&value.trim()!==`*`).map(value=>normalizeAgentId(value).toLowerCase()));if(!allowAny&&!allowSet.has(normalizedTargetId))return{status:`forbidden`,error:`agentId is not allowed for sessions_spawn (allowed: ${allowSet.size>0?Array.from(allowSet).join(`, `):`none`})`}}if(params.roleConfig){cfg.agents||={list:[]};let agentsList=cfg.agents.list??(cfg.agents.list=[]),existingIdx=agentsList.findIndex(e=>normalizeAgentId(e.id)===targetAgentId),role=params.roleConfig,newEntry={id:targetAgentId,skills:role.tools,...role.model?{model:role.model}:{}};existingIdx>=0?agentsList[existingIdx]={...agentsList[existingIdx],...newEntry}:agentsList.push(newEntry),!modelOverride&&role.model&&(modelOverride=role.model),!thinkingOverrideRaw&&role.thinking&&(thinkingOverrideRaw=role.thinking)}let childSessionKey=`agent:${targetAgentId}:subagent:${crypto.randomUUID()}`,childDepth=callerDepth+1,spawnedByKey=requesterInternalKey,targetAgentConfig=resolveAgentConfig(cfg,targetAgentId),resolvedModel=await resolveSubagentSpawnModel({cfg,agentId:targetAgentId,modelOverride,role:modelRoleForAgentRole(params.roleConfig?.name),task}),resolvedThinkingDefaultRaw=readStringParam(targetAgentConfig?.subagents??{},`thinking`)??readStringParam(cfg.agents?.defaults?.subagents??{},`thinking`),thinkingOverride,thinkingCandidateRaw=thinkingOverrideRaw||resolvedThinkingDefaultRaw;if(thinkingCandidateRaw){let normalized=normalizeThinkLevel(thinkingCandidateRaw);if(!normalized){let{provider,model}=splitModelRef(resolvedModel);return{status:`error`,error:`Invalid thinking level "${thinkingCandidateRaw}". Use one of: ${formatThinkingLevels(provider,model)}.`}}thinkingOverride=normalized}try{await callGateway({method:`sessions.patch`,params:{key:childSessionKey,spawnDepth:childDepth},timeoutMs:1e4})}catch(err){return{status:`error`,error:err instanceof Error?err.message:typeof err==`string`?err:`error`,childSessionKey}}if(resolvedModel)try{await callGateway({method:`sessions.patch`,params:{key:childSessionKey,model:resolvedModel},timeoutMs:1e4}),modelApplied=!0}catch(err){return{status:`error`,error:err instanceof Error?err.message:typeof err==`string`?err:`error`,childSessionKey}}if(thinkingOverride!==void 0)try{await callGateway({method:`sessions.patch`,params:{key:childSessionKey,thinkingLevel:thinkingOverride===`off`?null:thinkingOverride},timeoutMs:1e4})}catch(err){return{status:`error`,error:err instanceof Error?err.message:typeof err==`string`?err:`error`,childSessionKey}}let childSystemPrompt=buildSubagentSystemPrompt({requesterSessionKey,requesterOrigin,childSessionKey,label:label||void 0,task,childDepth,maxSpawnDepth});if(params.roleConfig){params.roleConfig.systemPrompt&&(childSystemPrompt+=`
238
+ Each call mints an access-restricted SECURITY ticket. Do not put real finding details anywhere except these tool calls. If a criterion is clean, say so in your summary rather than filing a ticket.`,persona:{voice:`precise, skeptical, and evidence-driven`,perspective:`a control is only satisfied if the code proves it — assume nothing, verify against the real files and data flows`,decisionStyle:`risk-first: rate by exploitability and blast radius; map every finding to its Trust Service Criterion`},outputFormat:{structure:`markdown`,requiredSections:[`## SOC 2 Coverage`,`## Findings by Criterion`,`## Summary`],outputPrefix:`SECURITY:`},thinking:`high`},AGENT_ROLE_MODEL_ROLES={"code-creator":`code`,"test-generator":`code`,"refactor-agent":`code`,"code-reviewer":`verify`,"validator-agent":`verify`,"security-agent":`verify`,"bug-analyzer":`plan`,"architecture-advisor":`plan`,"documentation-agent":`utility`};function modelRoleForAgentRole(name){if(!(!name||!Object.hasOwn(AGENT_ROLE_MODEL_ROLES,name)))return AGENT_ROLE_MODEL_ROLES[name]}function getBuiltInAgentRoles(){return[CODE_CREATOR_ROLE,CODE_REVIEWER_ROLE,TEST_GENERATOR_ROLE,BUG_ANALYZER_ROLE,REFACTOR_AGENT_ROLE,DOCUMENTATION_AGENT_ROLE,ARCHITECTURE_ADVISOR_ROLE,VALIDATOR_AGENT_ROLE,SECURITY_AGENT_ROLE]}function registerPlatformPersonasAsRoles(personas){for(let p of personas){let psychometric=parsePsychometricProfile(p.psychometric),plugin={name:p.slug,description:p.description??``,capabilities:[],tools:[],persona:p.voice||p.perspective||psychometric?{voice:p.voice??``,perspective:p.perspective??``,decisionStyle:``,psychometric}:void 0,outputFormat:p.outputPrefix?{structure:`markdown`,outputPrefix:p.outputPrefix}:void 0,source:`builderforce-assigned`,active:!0};globalPersonaRegistry.register(plugin)}}function registerHiredAgentsAsRoles(agents){for(let a of agents){let basePlugin={description:`Hired agent: ${a.name}`,capabilities:a.skills,tools:a.skills,systemPrompt:a.systemPrompt,model:a.model,source:`builderforce-assigned`,active:!0},aliases=a.roleKey===a.id?[a.roleKey]:[a.roleKey,a.id];for(let alias of aliases)!alias||!alias.trim()||globalPersonaRegistry.register({...basePlugin,name:alias})}}function findAgentRole(name){return getBuiltInAgentRoles().find(role=>role.name===name)||globalPersonaRegistry.resolve(name)}const TOKENS_PER_MILLION=1e6,LOCAL_APIS=new Set([`ollama`,`llama`,`transformers`]),LOCAL_PROVIDERS=new Set([`ollama`,`lmstudio`,`freetoken`,`synapse`,`vllm`,`llama`,`builderforcellm-local`]),LOOPBACK_HOSTS=new Set([`localhost`,`127.0.0.1`,`[::1]`,`::1`,`0.0.0.0`]),finiteNonNegative=n=>typeof n==`number`&&Number.isFinite(n)&&n>=0?n:void 0;function priceForCost(cost){let input=finiteNonNegative(cost?.input),output=finiteNonNegative(cost?.output);if(!(input===void 0||output===void 0))return{input:input/TOKENS_PER_MILLION,output:output/TOKENS_PER_MILLION}}function tierForCost(cost){let price=priceForCost(cost);if(!price)return;let outputPerMillion=price.output*TOKENS_PER_MILLION;return price.input===0&&price.output===0?`FREE`:outputPerMillion<8?`STANDARD`:outputPerMillion<20?`PREMIUM`:`ULTRA`}const FREE_POOL_PROVIDERS=new Set([`builderforcellm`]),FREE_ID_MARKER=/[:-]free$/i;function isExplicitlyFree(provider,id){return FREE_POOL_PROVIDERS.has(normalizeProviderId(provider))||FREE_ID_MARKER.test(id.trim())}const isZeroCost=cost=>cost!==void 0&&cost.input===0&&cost.output===0;function isLoopbackUrl(baseUrl){if(!baseUrl)return!1;try{return LOOPBACK_HOSTS.has(new URL(baseUrl).hostname.toLowerCase())}catch{return!1}}function isLocalModel(provider,entry){return LOCAL_PROVIDERS.has(normalizeProviderId(provider))?!0:entry?.api!=null&&LOCAL_APIS.has(entry.api)||isLoopbackUrl(entry?.baseUrl)}function vendorOfCandidateKey(key){let slash=key.indexOf(`/`);return normalizeProviderId(slash===-1?key:key.slice(0,slash))}function catalogViewFromEntries(entries){let byKey=new Map;for(let entry of entries){let provider=normalizeProviderId(entry.provider??``),id=entry.id?.trim();if(!provider||!id)continue;let key=modelKey(provider,id);byKey.has(key)||byKey.set(key,{...entry,provider,id})}let rowOf=model=>{let slash=model.indexOf(`/`);if(slash!==-1)return byKey.get(modelKey(normalizeProviderId(model.slice(0,slash)),model.slice(slash+1)))},residency=model=>isLocalModel(vendorOfCandidateKey(model),rowOf(model))?`local`:`cloud`,trustedCost=model=>{if(residency(model)===`local`)return{input:0,output:0};let row=rowOf(model);if(!(!row||isZeroCost(row.cost)&&!isExplicitlyFree(row.provider,row.id)))return row.cost};return{vendorOf:vendorOfCandidateKey,tierOf:model=>tierForCost(trustedCost(model)),priceOf:model=>priceForCost(trustedCost(model)),residencyOf:residency}}function configuredEntries(cfg){let providers=cfg?.models?.providers??{};return Object.entries(providers).flatMap(([provider,pc])=>(pc?.models??[]).map(m=>({provider,id:m.id,cost:m.cost,api:m.api??pc.api,baseUrl:pc.baseUrl})))}function registryEntries(agentDir){return discoverModels(discoverAuthStorage(agentDir),agentDir).getAll().map(m=>({provider:m.provider,id:m.id,cost:m.cost,api:m.api,baseUrl:m.baseUrl}))}function loadOnPremCatalogView(params){let entries=configuredEntries(params?.cfg);try{entries.push(...registryEntries(params?.agentDir??resolveBuilderForceAgentsAgentDir()))}catch(err){logDebug(`[model-catalog-view] models.json unreadable, configured rows only: ${String(err)}`)}return catalogViewFromEntries(entries)}async function resolveRoleRoutedModel(params){try{let resolved=resolveModelRefFromString({raw:params.lead,defaultProvider:DEFAULT_PROVIDER,aliasIndex:buildModelAliasIndex({cfg:params.cfg,defaultProvider:DEFAULT_PROVIDER})});if(!resolved)return params.lead;let winner=(await seedLearnedModel({candidates:resolveFallbackCandidates({cfg:params.cfg,provider:resolved.ref.provider,model:resolved.ref.model}),...params.prompt==null?{}:{prompt:params.prompt},routing:{role:params.role,view:params.view??loadOnPremCatalogView({cfg:params.cfg})}})).ranked[0];return winner?candidateKey(winner):params.lead}catch(err){return logDebug(`[model-routing] role routing failed, keeping ${params.lead}: ${String(err)}`),params.lead}}async function resolveSubagentSpawnModel(params){let selection=resolveSubagentSpawnModelSelection(params);return(normalizeModelSelection(params.modelOverride)??resolveSubagentConfiguredModelSelection({cfg:params.cfg,agentId:params.agentId}))||!params.role?selection:resolveRoleRoutedModel({cfg:params.cfg,lead:selection,role:params.role,prompt:params.task})}async function resolveRelayTaskModel(params){try{let cfg=params.cfg??loadConfig(),gateway=normalizeProviderId(DEFAULT_PROVIDER),candidates=resolveFallbackCandidates({cfg,provider:``,model:``}).filter(c=>normalizeProviderId(c.provider)===gateway&&c.model!==DEFAULT_MODEL);return candidates.length===0?void 0:(await seedLearnedModel({candidates,prompt:params.prompt,routing:{role:`code`,view:loadOnPremCatalogView({cfg})}})).ranked[0]?.model}catch(err){logDebug(`[model-routing] relay task routing failed, engine default stands: ${String(err)}`);return}}function normalizeSpawnDepth(value){if(typeof value==`number`)return Number.isInteger(value)&&value>=0?value:void 0;if(typeof value==`string`){let trimmed=value.trim();if(!trimmed)return;let numeric=Number(trimmed);return Number.isInteger(numeric)&&numeric>=0?numeric:void 0}}function normalizeSessionKey(value){if(typeof value==`string`)return value.trim()||void 0}function readSessionStore(storePath){try{let raw=fs.readFileSync(storePath,`utf-8`),parsed=JSON5.parse(raw);if(parsed&&typeof parsed==`object`&&!Array.isArray(parsed))return parsed}catch{}return{}}function buildKeyCandidates(rawKey,cfg){if(!cfg||rawKey===`global`||rawKey===`unknown`||parseAgentSessionKey(rawKey))return[rawKey];let prefixed=`agent:${resolveDefaultAgentId(cfg)}:${rawKey}`;return prefixed===rawKey?[rawKey]:[rawKey,prefixed]}function findEntryBySessionId(store,sessionId){let normalizedSessionId=normalizeSessionKey(sessionId);if(normalizedSessionId)for(let entry of Object.values(store)){let candidateSessionId=normalizeSessionKey(entry?.sessionId);if(candidateSessionId&&candidateSessionId===normalizedSessionId)return entry}}function resolveEntryForSessionKey(params){let candidates=buildKeyCandidates(params.sessionKey,params.cfg);if(params.store){for(let key of candidates){let entry=params.store[key];if(entry)return entry}return findEntryBySessionId(params.store,params.sessionKey)}if(params.cfg)for(let key of candidates){let parsed=parseAgentSessionKey(key);if(!parsed?.agentId)continue;let storePath=resolveStorePath(params.cfg.session?.store,{agentId:parsed.agentId}),store=params.cache.get(storePath);store||(store=readSessionStore(storePath),params.cache.set(storePath,store));let entry=store[key]??findEntryBySessionId(store,params.sessionKey);if(entry)return entry}}function getSubagentDepthFromSessionStore(sessionKey,opts){let raw=(sessionKey??``).trim(),fallbackDepth=getSubagentDepth(raw);if(!raw)return fallbackDepth;let cache=new Map,visited=new Set,depthFromStore=key=>{let normalizedKey=normalizeSessionKey(key);if(!normalizedKey||visited.has(normalizedKey))return;visited.add(normalizedKey);let entry=resolveEntryForSessionKey({sessionKey:normalizedKey,cfg:opts?.cfg,store:opts?.store,cache}),storedDepth=normalizeSpawnDepth(entry?.spawnDepth);if(storedDepth!==void 0)return storedDepth;let spawnedBy=normalizeSessionKey(entry?.spawnedBy);if(!spawnedBy)return;let parentDepth=depthFromStore(spawnedBy);return parentDepth===void 0?getSubagentDepth(spawnedBy)+1:parentDepth+1};return depthFromStore(raw)??fallbackDepth}function splitModelRef(ref){if(!ref)return{provider:void 0,model:void 0};let trimmed=ref.trim();if(!trimmed)return{provider:void 0,model:void 0};let[provider,model]=trimmed.split(`/`,2);return model?{provider,model}:{provider:void 0,model:trimmed}}async function spawnSubagentDirect(params,ctx){let task=params.task,label=params.label?.trim()||``,requestedAgentId=params.agentId,modelOverride=params.model,thinkingOverrideRaw=params.thinking,cleanup=params.cleanup===`keep`||params.cleanup===`delete`?params.cleanup:`keep`,requesterOrigin=normalizeDeliveryContext({channel:ctx.agentChannel,accountId:ctx.agentAccountId,to:ctx.agentTo,threadId:ctx.agentThreadId}),runTimeoutSeconds=typeof params.runTimeoutSeconds==`number`&&Number.isFinite(params.runTimeoutSeconds)?Math.max(0,Math.floor(params.runTimeoutSeconds)):0,modelApplied=!1,cfg=loadConfig(),{mainKey,alias}=resolveMainSessionAlias(cfg),requesterSessionKey=ctx.agentSessionKey,requesterInternalKey=requesterSessionKey?resolveInternalSessionKey({key:requesterSessionKey,alias,mainKey}):alias,requesterDisplayKey=resolveDisplaySessionKey({key:requesterInternalKey,alias,mainKey}),callerDepth=getSubagentDepthFromSessionStore(requesterInternalKey,{cfg}),maxSpawnDepth=cfg.agents?.defaults?.subagents?.maxSpawnDepth??1;if(callerDepth>=maxSpawnDepth)return{status:`forbidden`,error:`sessions_spawn is not allowed at this depth (current depth: ${callerDepth}, max: ${maxSpawnDepth})`};let maxChildren=cfg.agents?.defaults?.subagents?.maxChildrenPerAgent??5,activeChildren=await countActiveRunsForSession(requesterInternalKey);if(activeChildren>=maxChildren)return{status:`forbidden`,error:`sessions_spawn has reached max active children for this session (${activeChildren}/${maxChildren})`};let requesterAgentId=normalizeAgentId(ctx.requesterAgentIdOverride??parseAgentSessionKey(requesterInternalKey)?.agentId),targetAgentId=requestedAgentId?normalizeAgentId(requestedAgentId):requesterAgentId;if(targetAgentId!==requesterAgentId){let allowAgents=resolveAgentConfig(cfg,requesterAgentId)?.subagents?.allowAgents??[],allowAny=allowAgents.some(value=>value.trim()===`*`),normalizedTargetId=targetAgentId.toLowerCase(),allowSet=new Set(allowAgents.filter(value=>value.trim()&&value.trim()!==`*`).map(value=>normalizeAgentId(value).toLowerCase()));if(!allowAny&&!allowSet.has(normalizedTargetId))return{status:`forbidden`,error:`agentId is not allowed for sessions_spawn (allowed: ${allowSet.size>0?Array.from(allowSet).join(`, `):`none`})`}}if(params.roleConfig){cfg.agents||={list:[]};let agentsList=cfg.agents.list??(cfg.agents.list=[]),existingIdx=agentsList.findIndex(e=>normalizeAgentId(e.id)===targetAgentId),role=params.roleConfig,newEntry={id:targetAgentId,skills:role.tools,...role.model?{model:role.model}:{}};existingIdx>=0?agentsList[existingIdx]={...agentsList[existingIdx],...newEntry}:agentsList.push(newEntry),!modelOverride&&role.model&&(modelOverride=role.model),!thinkingOverrideRaw&&role.thinking&&(thinkingOverrideRaw=role.thinking)}let childSessionKey=`agent:${targetAgentId}:subagent:${crypto.randomUUID()}`,childDepth=callerDepth+1,spawnedByKey=requesterInternalKey,targetAgentConfig=resolveAgentConfig(cfg,targetAgentId),resolvedModel=await resolveSubagentSpawnModel({cfg,agentId:targetAgentId,modelOverride,role:modelRoleForAgentRole(params.roleConfig?.name),task}),resolvedThinkingDefaultRaw=readStringParam(targetAgentConfig?.subagents??{},`thinking`)??readStringParam(cfg.agents?.defaults?.subagents??{},`thinking`),thinkingOverride,thinkingCandidateRaw=thinkingOverrideRaw||resolvedThinkingDefaultRaw;if(thinkingCandidateRaw){let normalized=normalizeThinkLevel(thinkingCandidateRaw);if(!normalized){let{provider,model}=splitModelRef(resolvedModel);return{status:`error`,error:`Invalid thinking level "${thinkingCandidateRaw}". Use one of: ${formatThinkingLevels(provider,model)}.`}}thinkingOverride=normalized}try{await callGateway({method:`sessions.patch`,params:{key:childSessionKey,spawnDepth:childDepth},timeoutMs:1e4})}catch(err){return{status:`error`,error:err instanceof Error?err.message:typeof err==`string`?err:`error`,childSessionKey}}if(resolvedModel)try{await callGateway({method:`sessions.patch`,params:{key:childSessionKey,model:resolvedModel},timeoutMs:1e4}),modelApplied=!0}catch(err){return{status:`error`,error:err instanceof Error?err.message:typeof err==`string`?err:`error`,childSessionKey}}if(thinkingOverride!==void 0)try{await callGateway({method:`sessions.patch`,params:{key:childSessionKey,thinkingLevel:thinkingOverride===`off`?null:thinkingOverride},timeoutMs:1e4})}catch(err){return{status:`error`,error:err instanceof Error?err.message:typeof err==`string`?err:`error`,childSessionKey}}let childSystemPrompt=buildSubagentSystemPrompt({requesterSessionKey,requesterOrigin,childSessionKey,label:label||void 0,task,childDepth,maxSpawnDepth});if(params.roleConfig){params.roleConfig.systemPrompt&&(childSystemPrompt+=`
239
239
 
240
240
  --- Role Guidance ---
241
241
  `+params.roleConfig.systemPrompt);let personaBlock=buildPersonaSystemBlock(params.roleConfig);personaBlock&&(childSystemPrompt+=`
@@ -472,7 +472,7 @@ Critical rules from AGENTS.md:
472
472
  `)||``;if(!rawBody)return null;let ackReaction=resolveAckReaction(cfg,route.agentId,{channel:`slack`,accountId:account.accountId}),ackReactionValue=ackReaction??``,shouldAckReaction$2=()=>!!(ackReaction&&shouldAckReaction({scope:ctx.ackReactionScope,isDirect:isDirectMessage,isGroup:isRoomish,isMentionableGroup:isRoom,requireMention:!!shouldRequireMention,canDetectMention,effectiveWasMentioned,shouldBypassMention:mentionGate.shouldBypassMention})),ackReactionMessageTs=message.ts,ackReactionPromise=shouldAckReaction$2()&&ackReactionMessageTs&&ackReactionValue?reactSlackMessage(message.channel,ackReactionMessageTs,ackReactionValue,{token:ctx.botToken,client:ctx.app.client}).then(()=>!0,err=>(logVerbose(`slack react failed for channel ${message.channel}: ${String(err)}`),!1)):null,roomLabel=channelName?`#${channelName}`:`#${message.channel}`,preview=rawBody.replace(/\s+/g,` `).slice(0,160),inboundLabel=isDirectMessage?`Slack DM from ${senderName}`:`Slack message in ${roomLabel} from ${senderName}`,slackFrom=isDirectMessage?`slack:${message.user}`:isRoom?`slack:channel:${message.channel}`:`slack:group:${message.channel}`;enqueueSystemEvent(`${inboundLabel}: ${preview}`,{sessionKey,contextKey:`slack:message:${message.channel}:${message.ts??`unknown`}`});let envelopeFrom=resolveConversationLabel({ChatType:isDirectMessage?`direct`:`channel`,SenderName:senderName,GroupSubject:isRoomish?roomLabel:void 0,From:slackFrom})??(isDirectMessage?senderName:roomLabel),threadInfo=isThreadReply&&threadTs?` thread_ts: ${threadTs}${message.parent_user_id?` parent_user_id: ${message.parent_user_id}`:``}`:``,textWithId=`${rawBody}\n[slack message id: ${message.ts} channel: ${message.channel}${threadInfo}]`,storePath=resolveStorePath(ctx.cfg.session?.store,{agentId:route.agentId}),envelopeOptions=resolveEnvelopeFormatOptions(ctx.cfg),previousTimestamp=readSessionUpdatedAt({storePath,sessionKey:route.sessionKey}),combinedBody=formatInboundEnvelope({channel:`Slack`,from:envelopeFrom,timestamp:message.ts?Math.round(Number(message.ts)*1e3):void 0,body:textWithId,chatType:isDirectMessage?`direct`:`channel`,sender:{name:senderName,id:senderId},previousTimestamp,envelope:envelopeOptions});isRoomish&&ctx.historyLimit>0&&(combinedBody=buildPendingHistoryContextFromMap({historyMap:ctx.channelHistories,historyKey,limit:ctx.historyLimit,currentMessage:combinedBody,formatEntry:entry=>formatInboundEnvelope({channel:`Slack`,from:roomLabel,timestamp:entry.timestamp,body:`${entry.body}${entry.messageId?` [id:${entry.messageId} channel:${message.channel}]`:``}`,chatType:`channel`,senderLabel:entry.sender,envelope:envelopeOptions})}));let slackTo=isDirectMessage?`user:${message.user}`:`channel:${message.channel}`,{untrustedChannelMetadata,groupSystemPrompt}=resolveSlackRoomContextHints({isRoomish,channelInfo,channelConfig}),threadStarterBody,threadHistoryBody,threadSessionPreviousTimestamp,threadLabel,threadStarterMedia=null;if(isThreadReply&&threadTs){let starter=await resolveSlackThreadStarter({channelId:message.channel,threadTs,client:ctx.app.client});if(starter?.text){threadStarterBody=starter.text;let snippet=starter.text.replace(/\s+/g,` `).slice(0,80);threadLabel=`Slack thread ${roomLabel}${snippet?`: ${snippet}`:``}`,!effectiveDirectMedia&&starter.files&&starter.files.length>0&&(threadStarterMedia=await resolveSlackMedia({files:starter.files,token:ctx.botToken,maxBytes:ctx.mediaMaxBytes}),threadStarterMedia&&logVerbose(`slack: hydrated thread starter file ${threadStarterMedia.map(m=>m.placeholder).join(`, `)} from root message`))}else threadLabel=`Slack thread ${roomLabel}`;let threadInitialHistoryLimit=account.config?.thread?.initialHistoryLimit??20;if(threadSessionPreviousTimestamp=readSessionUpdatedAt({storePath,sessionKey}),threadInitialHistoryLimit>0&&!threadSessionPreviousTimestamp){let threadHistory=await resolveSlackThreadHistory({channelId:message.channel,threadTs,client:ctx.app.client,currentMessageTs:message.ts,limit:threadInitialHistoryLimit});if(threadHistory.length>0){let uniqueUserIds=[...new Set(threadHistory.map(m=>m.userId).filter(id=>!!id))],userMap=new Map;await Promise.all(uniqueUserIds.map(async id=>{let user=await ctx.resolveUserName(id);user&&userMap.set(id,user)}));let historyParts=[];for(let historyMsg of threadHistory){let msgSenderName=(historyMsg.userId?userMap.get(historyMsg.userId):null)?.name??(historyMsg.botId?`Bot (${historyMsg.botId})`:`Unknown`),role=historyMsg.botId?`assistant`:`user`,msgWithId=`${historyMsg.text}\n[slack message id: ${historyMsg.ts??`unknown`} channel: ${message.channel}]`;historyParts.push(formatInboundEnvelope({channel:`Slack`,from:`${msgSenderName} (${role})`,timestamp:historyMsg.ts?Math.round(Number(historyMsg.ts)*1e3):void 0,body:msgWithId,chatType:`channel`,envelope:envelopeOptions}))}threadHistoryBody=historyParts.join(`
473
473
 
474
474
  `),logVerbose(`slack: populated thread history with ${threadHistory.length} messages for new session`)}}}let effectiveMedia=effectiveDirectMedia??threadStarterMedia,firstMedia=effectiveMedia?.[0],inboundHistory=isRoomish&&ctx.historyLimit>0?(ctx.channelHistories.get(historyKey)??[]).map(entry=>({sender:entry.sender,body:entry.body,timestamp:entry.timestamp})):void 0,ctxPayload=finalizeInboundContext({Body:combinedBody,BodyForAgent:rawBody,InboundHistory:inboundHistory,RawBody:rawBody,CommandBody:rawBody,From:slackFrom,To:slackTo,SessionKey:sessionKey,AccountId:route.accountId,ChatType:isDirectMessage?`direct`:`channel`,ConversationLabel:envelopeFrom,GroupSubject:isRoomish?roomLabel:void 0,GroupSystemPrompt:isRoomish?groupSystemPrompt:void 0,UntrustedContext:untrustedChannelMetadata?[untrustedChannelMetadata]:void 0,SenderName:senderName,SenderId:senderId,Provider:`slack`,Surface:`slack`,MessageSid:message.ts,ReplyToId:threadContext.replyToId,MessageThreadId:threadContext.messageThreadId,ParentSessionKey:threadKeys.parentSessionKey,ThreadStarterBody:threadStarterBody,ThreadHistoryBody:threadHistoryBody,IsFirstThreadTurn:isThreadReply&&threadTs&&!threadSessionPreviousTimestamp?!0:void 0,ThreadLabel:threadLabel,Timestamp:message.ts?Math.round(Number(message.ts)*1e3):void 0,WasMentioned:isRoomish?effectiveWasMentioned:void 0,MediaPath:firstMedia?.path,MediaType:firstMedia?.contentType,MediaUrl:firstMedia?.path,MediaPaths:effectiveMedia&&effectiveMedia.length>0?effectiveMedia.map(m=>m.path):void 0,MediaUrls:effectiveMedia&&effectiveMedia.length>0?effectiveMedia.map(m=>m.path):void 0,MediaTypes:effectiveMedia&&effectiveMedia.length>0?effectiveMedia.map(m=>m.contentType??``):void 0,CommandAuthorized:commandAuthorized,OriginatingChannel:`slack`,OriginatingTo:slackTo});await recordInboundSession({storePath,sessionKey,ctx:ctxPayload,updateLastRoute:isDirectMessage?{sessionKey:route.mainSessionKey,channel:`slack`,to:`user:${message.user}`,accountId:route.accountId}:void 0,onRecordError:err=>{ctx.logger.warn({error:String(err),storePath,sessionKey},`failed updating session meta`)}});let replyTarget=ctxPayload.To??void 0;return replyTarget?(shouldLogVerbose()&&logVerbose(`slack inbound: channel=${message.channel} from=${slackFrom} preview="${preview}"`),{ctx,account,message,route,channelConfig,replyTarget,ctxPayload,isDirectMessage,isRoomish,historyKey,preview,ackReactionMessageTs,ackReactionValue,ackReactionPromise}):null}const normalizeThreadTs=threadTs=>threadTs?.trim()||void 0;async function resolveThreadTsFromHistory(params){try{let response=await params.client.conversations.history({channel:params.channelId,latest:params.messageTs,oldest:params.messageTs,inclusive:!0,limit:1});return normalizeThreadTs((response.messages?.find(entry=>entry.ts===params.messageTs)??response.messages?.[0])?.thread_ts)}catch(err){shouldLogVerbose()&&logVerbose(`slack inbound: failed to resolve thread_ts via conversations.history for channel=${params.channelId} ts=${params.messageTs}: ${String(err)}`);return}}function createSlackThreadTsResolver(params){let ttlMs=Math.max(0,params.cacheTtlMs??6e4),maxSize=Math.max(0,params.maxSize??500),cache=new Map,inflight=new Map,getCached=(key,now)=>{let entry=cache.get(key);if(entry){if(ttlMs>0&&now-entry.updatedAt>ttlMs){cache.delete(key);return}return cache.delete(key),cache.set(key,{...entry,updatedAt:now}),entry.threadTs}},setCached=(key,threadTs,now)=>{cache.delete(key),cache.set(key,{threadTs,updatedAt:now}),pruneMapToMaxSize(cache,maxSize)};return{resolve:async request=>{let{message}=request;if(!message.parent_user_id||message.thread_ts||!message.ts)return message;let cacheKey=`${message.channel}:${message.ts}`,cached=getCached(cacheKey,Date.now());if(cached!==void 0)return cached?{...message,thread_ts:cached}:message;shouldLogVerbose()&&logVerbose(`slack inbound: missing thread_ts for thread reply channel=${message.channel} ts=${message.ts} source=${request.source}`);let pending=inflight.get(cacheKey);pending||(pending=resolveThreadTsFromHistory({client:params.client,channelId:message.channel,messageTs:message.ts}),inflight.set(cacheKey,pending));let resolved;try{resolved=await pending}finally{inflight.delete(cacheKey)}return setCached(cacheKey,resolved??null,Date.now()),resolved?(shouldLogVerbose()&&logVerbose(`slack inbound: resolved missing thread_ts channel=${message.channel} ts=${message.ts} -> thread_ts=${resolved}`),{...message,thread_ts:resolved}):(shouldLogVerbose()&&logVerbose(`slack inbound: could not resolve missing thread_ts channel=${message.channel} ts=${message.ts}`),message)}}}function createSlackMessageHandler(params){let{ctx,account}=params,debounceMs=resolveInboundDebounceMs({cfg:ctx.cfg,channel:`slack`}),threadTsResolver=createSlackThreadTsResolver({client:ctx.app.client}),debouncer=createInboundDebouncer({debounceMs,buildKey:entry=>{let senderId=entry.message.user??entry.message.bot_id;if(!senderId)return null;let messageTs=entry.message.ts??entry.message.event_ts,threadKey=entry.message.thread_ts?`${entry.message.channel}:${entry.message.thread_ts}`:entry.message.parent_user_id&&messageTs?`${entry.message.channel}:maybe-thread:${messageTs}`:entry.message.channel;return`slack:${ctx.accountId}:${threadKey}:${senderId}`},shouldDebounce:entry=>{let text=entry.message.text??``;return!text.trim()||entry.message.files&&entry.message.files.length>0?!1:!hasControlCommand(stripSlackMentionsForCommandDetection(text),ctx.cfg)},onFlush:async entries=>{let last=entries.at(-1);if(!last)return;let combinedText=entries.length===1?last.message.text??``:entries.map(entry=>entry.message.text??``).filter(Boolean).join(`
475
- `),combinedMentioned=entries.some(entry=>!!entry.opts.wasMentioned),prepared=await prepareSlackMessage({ctx,account,message:{...last.message,text:combinedText},opts:{...last.opts,wasMentioned:combinedMentioned||last.opts.wasMentioned}});if(prepared){if(entries.length>1){let ids=entries.map(entry=>entry.message.ts).filter(Boolean);ids.length>0&&(prepared.ctxPayload.MessageSids=ids,prepared.ctxPayload.MessageSidFirst=ids[0],prepared.ctxPayload.MessageSidLast=ids[ids.length-1])}await dispatchPreparedSlackMessage(prepared)}},onError:err=>{ctx.runtime.error?.(`slack inbound debounce flush failed: ${String(err)}`)}});return async(message,opts)=>{if(opts.source===`message`&&message.type!==`message`||opts.source===`message`&&message.subtype&&message.subtype!==`file_share`&&message.subtype!==`bot_message`||ctx.markMessageSeen(message.channel,message.ts))return;let resolvedMessage=await threadTsResolver.resolve({message,source:opts.source});await debouncer.enqueue({message:resolvedMessage,opts})}}const SLACK_COMMAND_ARG_ACTION_ID=`builderforce_cmdarg`,SLACK_COMMAND_ARG_VALUE_PREFIX=`cmdarg`,SLACK_COMMAND_ARG_EXTERNAL_PREFIX=`builderforce_cmdarg_ext:`,slackExternalArgMenuStore=new Map;function truncatePlainText(value,max){let trimmed=value.trim();return trimmed.length<=max?trimmed:max<=1?trimmed.slice(0,max):`${trimmed.slice(0,max-1)}…`}function escapeSlackMrkdwn(value){return value.replaceAll(`\\`,`\\\\`).replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replace(/([*_`~])/g,`\\$1`)}function buildSlackArgMenuConfirm(params){return{title:{type:`plain_text`,text:`Confirm selection`},text:{type:`mrkdwn`,text:`Run */${escapeSlackMrkdwn(params.command)}* with *${escapeSlackMrkdwn(params.arg)}* set to this value?`},confirm:{type:`plain_text`,text:`Run command`},deny:{type:`plain_text`,text:`Cancel`}}}function pruneSlackExternalArgMenuStore(now=Date.now()){for(let[token,entry]of slackExternalArgMenuStore.entries())entry.expiresAt<=now&&slackExternalArgMenuStore.delete(token)}function storeSlackExternalArgMenu(params){pruneSlackExternalArgMenuStore();let token=`${Date.now().toString(36)}${Math.random().toString(36).slice(2,10)}`;return slackExternalArgMenuStore.set(token,{choices:params.choices,userId:params.userId,expiresAt:Date.now()+6e5}),token}function readSlackExternalArgMenuToken(raw){if(typeof raw!=`string`||!raw.startsWith(SLACK_COMMAND_ARG_EXTERNAL_PREFIX))return;let token=raw.slice(24).trim();return token.length>0?token:void 0}function encodeSlackCommandArgValue(parts){return[SLACK_COMMAND_ARG_VALUE_PREFIX,encodeURIComponent(parts.command),encodeURIComponent(parts.arg),encodeURIComponent(parts.value),encodeURIComponent(parts.userId)].join(`|`)}function parseSlackCommandArgValue(raw){if(!raw)return null;let parts=raw.split(`|`);if(parts.length!==5||parts[0]!==SLACK_COMMAND_ARG_VALUE_PREFIX)return null;let[,command,arg,value,userId]=parts;if(!command||!arg||!value||!userId)return null;let decode=text=>{try{return decodeURIComponent(text)}catch{return null}},decodedCommand=decode(command),decodedArg=decode(arg),decodedValue=decode(value),decodedUserId=decode(userId);return!decodedCommand||!decodedArg||!decodedValue||!decodedUserId?null:{command:decodedCommand,arg:decodedArg,value:decodedValue,userId:decodedUserId}}function buildSlackCommandArgMenuBlocks(params){let encodedChoices=params.choices.map(choice=>({label:choice.label,value:encodeSlackCommandArgValue({command:params.command,arg:params.arg,value:choice.value,userId:params.userId})})),canUseStaticSelect=encodedChoices.every(choice=>choice.value.length<=75),canUseOverflow=canUseStaticSelect&&encodedChoices.length>=3&&encodedChoices.length<=5,canUseExternalSelect=params.supportsExternalSelect&&canUseStaticSelect&&encodedChoices.length>100,rows=canUseOverflow?[{type:`actions`,elements:[{type:`overflow`,action_id:SLACK_COMMAND_ARG_ACTION_ID,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg}),options:encodedChoices.map(choice=>({text:{type:`plain_text`,text:choice.label.slice(0,75)},value:choice.value}))}]}]:canUseExternalSelect?[{type:`actions`,block_id:`${SLACK_COMMAND_ARG_EXTERNAL_PREFIX}${params.createExternalMenuToken(encodedChoices)}`,elements:[{type:`external_select`,action_id:SLACK_COMMAND_ARG_ACTION_ID,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg}),min_query_length:0,placeholder:{type:`plain_text`,text:`Search ${params.arg}`}}]}]:encodedChoices.length<=5||!canUseStaticSelect?chunkItems(encodedChoices,5).map(choices=>({type:`actions`,elements:choices.map(choice=>({type:`button`,action_id:SLACK_COMMAND_ARG_ACTION_ID,text:{type:`plain_text`,text:choice.label},value:choice.value,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg})}))})):chunkItems(encodedChoices,100).map((choices,index)=>({type:`actions`,elements:[{type:`static_select`,action_id:SLACK_COMMAND_ARG_ACTION_ID,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg}),placeholder:{type:`plain_text`,text:index===0?`Choose ${params.arg}`:`Choose ${params.arg} (${index+1})`},options:choices.map(choice=>({text:{type:`plain_text`,text:choice.label.slice(0,75)},value:choice.value}))}]})),headerText=truncatePlainText(`/${params.command}: choose ${params.arg}`,150),sectionText=truncatePlainText(params.title,3e3),contextText=truncatePlainText(`Select one option to continue /${params.command} (${params.arg})`,3e3);return[{type:`header`,text:{type:`plain_text`,text:headerText}},{type:`section`,text:{type:`mrkdwn`,text:sectionText}},{type:`context`,elements:[{type:`mrkdwn`,text:contextText}]},...rows]}async function registerSlackMonitorSlashCommands(params){let{ctx,account}=params,cfg=ctx.cfg,runtime=ctx.runtime,supportsInteractiveArgMenus=typeof ctx.app.action==`function`,supportsExternalArgMenus=typeof ctx.app.options==`function`,slashCommand=resolveSlackSlashCommandConfig(ctx.slashCommand??account.config.slashCommand),handleSlashCommand=async p=>{let{command,ack,respond,prompt,commandArgs,commandDefinition}=p;try{if(!prompt.trim()){await ack({text:`Message required.`,response_type:`ephemeral`});return}if(await ack(),ctx.botUserId&&command.user_id===ctx.botUserId)return;let channelInfo=await ctx.resolveChannelName(command.channel_id),channelType=normalizeSlackChannelType(channelInfo?.type??(command.channel_name===`directmessage`?`im`:void 0),command.channel_id),isDirectMessage=channelType===`im`,isGroupDm=channelType===`mpim`,isRoom=channelType===`channel`||channelType===`group`,isRoomish=isRoom||isGroupDm;if(!ctx.isChannelAllowed({channelId:command.channel_id,channelName:channelInfo?.name,channelType})){await respond({text:`This channel is not allowed.`,response_type:`ephemeral`});return}let storeAllowFrom=await readChannelAllowFromStore(`slack`).catch(()=>[]),effectiveAllowFromLower=normalizeAllowListLower(normalizeAllowList$2([...ctx.allowFrom,...storeAllowFrom])),commandAuthorized=!1,channelConfig=null;if(isDirectMessage){if(!ctx.dmEnabled||ctx.dmPolicy===`disabled`){await respond({text:`Slack DMs are disabled.`,response_type:`ephemeral`});return}if(ctx.dmPolicy!==`open`){let senderName=(await ctx.resolveUserName(command.user_id))?.name??void 0,allowMatch=resolveSlackAllowListMatch({allowList:effectiveAllowFromLower,id:command.user_id,name:senderName}),allowMatchMeta=formatAllowlistMatchMeta(allowMatch);if(!allowMatch.allowed){if(ctx.dmPolicy===`pairing`){let{code,created}=await upsertChannelPairingRequest({channel:`slack`,id:command.user_id,meta:{name:senderName}});created&&(logVerbose(`slack pairing request sender=${command.user_id} name=${senderName??`unknown`} (${allowMatchMeta})`),await respond({text:buildPairingReply({channel:`slack`,idLine:`Your Slack user id: ${command.user_id}`,code}),response_type:`ephemeral`}))}else logVerbose(`slack: blocked slash sender ${command.user_id} (dmPolicy=${ctx.dmPolicy}, ${allowMatchMeta})`),await respond({text:`You are not authorized to use this command.`,response_type:`ephemeral`});return}}}if(isRoom&&(channelConfig=resolveSlackChannelConfig({channelId:command.channel_id,channelName:channelInfo?.name,channels:ctx.channelsConfig,defaultRequireMention:ctx.defaultRequireMention}),ctx.useAccessGroups)){let channelAllowlistConfigured=!!ctx.channelsConfig&&Object.keys(ctx.channelsConfig??{}).length>0,channelAllowed=channelConfig?.allowed!==!1;if(!isSlackChannelAllowedByPolicy({groupPolicy:ctx.groupPolicy,channelAllowlistConfigured,channelAllowed})){await respond({text:`This channel is not allowed.`,response_type:`ephemeral`});return}let hasExplicitConfig=!!channelConfig?.matchSource;if(!channelAllowed&&(ctx.groupPolicy!==`open`||hasExplicitConfig)){await respond({text:`This channel is not allowed.`,response_type:`ephemeral`});return}}let senderName=(await ctx.resolveUserName(command.user_id))?.name??command.user_name??command.user_id,channelUsersAllowlistConfigured=isRoom&&Array.isArray(channelConfig?.users)&&channelConfig.users.length>0,channelUserAllowed=channelUsersAllowlistConfigured?resolveSlackUserAllowed({allowList:channelConfig?.users,userId:command.user_id,userName:senderName}):!1;if(channelUsersAllowlistConfigured&&!channelUserAllowed){await respond({text:`You are not authorized to use this command here.`,response_type:`ephemeral`});return}let ownerAllowed=resolveSlackAllowListMatch({allowList:effectiveAllowFromLower,id:command.user_id,name:senderName}).allowed;if(commandAuthorized=resolveCommandAuthorizedFromAuthorizers({useAccessGroups:ctx.useAccessGroups,authorizers:[{configured:effectiveAllowFromLower.length>0,allowed:ownerAllowed}],modeWhenAccessGroupsOff:`configured`}),isRoomish&&(commandAuthorized=resolveCommandAuthorizedFromAuthorizers({useAccessGroups:ctx.useAccessGroups,authorizers:[{configured:effectiveAllowFromLower.length>0,allowed:ownerAllowed},{configured:channelUsersAllowlistConfigured,allowed:channelUserAllowed}],modeWhenAccessGroupsOff:`configured`}),ctx.useAccessGroups&&!commandAuthorized)){await respond({text:`You are not authorized to use this command.`,response_type:`ephemeral`});return}if(commandDefinition&&supportsInteractiveArgMenus){let menu=resolveCommandArgMenu({command:commandDefinition,args:commandArgs,cfg});if(menu){let commandLabel=commandDefinition.nativeName??commandDefinition.key,title=menu.title??`Choose ${menu.arg.description||menu.arg.name} for /${commandLabel}.`;await respond({text:title,blocks:buildSlackCommandArgMenuBlocks({title,command:commandLabel,arg:menu.arg.name,choices:menu.choices,userId:command.user_id,supportsExternalSelect:supportsExternalArgMenus,createExternalMenuToken:choices=>storeSlackExternalArgMenu({choices,userId:command.user_id})}),response_type:`ephemeral`});return}}let channelName=channelInfo?.name,roomLabel=channelName?`#${channelName}`:`#${command.channel_id}`,[{resolveAgentRoute},{finalizeInboundContext},{dispatchReplyWithDispatcher}]=await Promise.all([import(`./resolve-route-cKRJeWLf.js`),import(`./inbound-context-CDIkHDDR.js`),import(`./provider-dispatcher-Djomkp5i.js`)]),[{resolveConversationLabel},{createReplyPrefixOptions}]=await Promise.all([import(`./conversation-label-KkzPOmk2.js`),import(`./reply-prefix-BCHZqFk0.js`)]),route=resolveAgentRoute({cfg,channel:`slack`,accountId:account.accountId,teamId:ctx.teamId||void 0,peer:{kind:isDirectMessage?`direct`:isRoom?`channel`:`group`,id:isDirectMessage?command.user_id:command.channel_id}}),{untrustedChannelMetadata,groupSystemPrompt}=resolveSlackRoomContextHints({isRoomish,channelInfo,channelConfig}),ctxPayload=finalizeInboundContext({Body:prompt,BodyForAgent:prompt,RawBody:prompt,CommandBody:prompt,CommandArgs:commandArgs,From:isDirectMessage?`slack:${command.user_id}`:isRoom?`slack:channel:${command.channel_id}`:`slack:group:${command.channel_id}`,To:`slash:${command.user_id}`,ChatType:isDirectMessage?`direct`:`channel`,ConversationLabel:resolveConversationLabel({ChatType:isDirectMessage?`direct`:`channel`,SenderName:senderName,GroupSubject:isRoomish?roomLabel:void 0,From:isDirectMessage?`slack:${command.user_id}`:isRoom?`slack:channel:${command.channel_id}`:`slack:group:${command.channel_id}`})??(isDirectMessage?senderName:roomLabel),GroupSubject:isRoomish?roomLabel:void 0,GroupSystemPrompt:isRoomish?groupSystemPrompt:void 0,UntrustedContext:untrustedChannelMetadata?[untrustedChannelMetadata]:void 0,SenderName:senderName,SenderId:command.user_id,Provider:`slack`,Surface:`slack`,WasMentioned:!0,MessageSid:command.trigger_id,Timestamp:Date.now(),SessionKey:`agent:${route.agentId}:${slashCommand.sessionPrefix}:${command.user_id}`.toLowerCase(),CommandTargetSessionKey:route.sessionKey,AccountId:route.accountId,CommandSource:`native`,CommandAuthorized:commandAuthorized,OriginatingChannel:`slack`,OriginatingTo:`user:${command.user_id}`}),{onModelSelected,...prefixOptions}=createReplyPrefixOptions({cfg,agentId:route.agentId,channel:`slack`,accountId:route.accountId}),deliverSlashPayloads=async replies=>{let[{deliverSlackSlashReplies},{resolveChunkMode},{resolveMarkdownTableMode}]=await Promise.all([import(`./replies-DNc24mQf.js`),import(`./chunk-BIVaOXre.js`),import(`./markdown-tables-BuiwWVry.js`)]);await deliverSlackSlashReplies({replies,respond,ephemeral:slashCommand.ephemeral,textLimit:ctx.textLimit,chunkMode:resolveChunkMode(cfg,`slack`,route.accountId),tableMode:resolveMarkdownTableMode({cfg,channel:`slack`,accountId:route.accountId})})},{counts}=await dispatchReplyWithDispatcher({ctx:ctxPayload,cfg,dispatcherOptions:{...prefixOptions,deliver:async payload=>deliverSlashPayloads([payload]),onError:(err,info)=>{runtime.error?.(danger(`slack slash ${info.kind} reply failed: ${String(err)}`))}},replyOptions:{skillFilter:channelConfig?.skills,onModelSelected}});counts.final+counts.tool+counts.block===0&&await deliverSlashPayloads([])}catch(err){runtime.error?.(danger(`slack slash handler failed: ${String(err)}`)),await respond({text:`Sorry, something went wrong handling that command.`,response_type:`ephemeral`})}},nativeEnabled=resolveNativeCommandsEnabled({providerId:`slack`,providerSetting:account.config.commands?.native,globalSetting:cfg.commands?.native}),nativeSkillsEnabled=resolveNativeSkillsEnabled({providerId:`slack`,providerSetting:account.config.commands?.nativeSkills,globalSetting:cfg.commands?.nativeSkills}),nativeCommands=[];if(nativeEnabled&&(nativeCommands=listNativeCommandSpecsForConfig(cfg,{skillCommands:nativeSkillsEnabled?listSkillCommandsForAgents({cfg}):[],provider:`slack`})),nativeCommands.length>0)for(let command of nativeCommands)ctx.app.command(`/${command.name}`,async({command:cmd,ack,respond})=>{let commandDefinition=findCommandByNativeName(command.name,`slack`),rawText=cmd.text?.trim()??``,commandArgs=commandDefinition?parseCommandArgs(commandDefinition,rawText):rawText?{raw:rawText}:void 0;await handleSlashCommand({command:cmd,ack,respond,prompt:commandDefinition?buildCommandTextFromArgs(commandDefinition,commandArgs):rawText?`/${command.name} ${rawText}`:`/${command.name}`,commandArgs,commandDefinition:commandDefinition??void 0})});else slashCommand.enabled?ctx.app.command(buildSlackSlashCommandMatcher(slashCommand.name),async({command,ack,respond})=>{await handleSlashCommand({command,ack,respond,prompt:command.text?.trim()??``})}):logVerbose(`slack: slash commands disabled`);nativeCommands.length===0||!supportsInteractiveArgMenus||((()=>{let optionsHandler=ctx.app.options;typeof optionsHandler==`function`&&optionsHandler(SLACK_COMMAND_ARG_ACTION_ID,async({ack,body})=>{let typedBody=body;pruneSlackExternalArgMenuStore();let token=readSlackExternalArgMenuToken(typedBody.actions?.[0]?.block_id??typedBody.block_id);if(!token){await ack({options:[]});return}let entry=slackExternalArgMenuStore.get(token);if(!entry){await ack({options:[]});return}if(typedBody.user?.id&&typedBody.user.id!==entry.userId){await ack({options:[]});return}let query=typedBody.value?.trim().toLowerCase()??``;await ack({options:entry.choices.filter(choice=>!query||choice.label.toLowerCase().includes(query)).slice(0,100).map(choice=>({text:{type:`plain_text`,text:choice.label.slice(0,75)},value:choice.value}))})})})(),(actionId=>{ctx.app.action(actionId,async args=>{let{ack,body,respond}=args,action=args.action;await ack();let respondFn=respond??(async payload=>{!body.channel?.id||!body.user?.id||await ctx.app.client.chat.postEphemeral({token:ctx.botToken,channel:body.channel.id,user:body.user.id,text:payload.text,blocks:payload.blocks})}),parsed=parseSlackCommandArgValue(action?.value??action?.selected_option?.value);if(!parsed){await respondFn({text:`Sorry, that button is no longer valid.`,response_type:`ephemeral`});return}if(body.user?.id&&parsed.userId!==body.user.id){await respondFn({text:`That menu is for another user.`,response_type:`ephemeral`});return}let commandDefinition=findCommandByNativeName(parsed.command,`slack`),commandArgs={values:{[parsed.arg]:parsed.value}},prompt=commandDefinition?buildCommandTextFromArgs(commandDefinition,commandArgs):`/${parsed.command} ${parsed.value}`,user=body.user,userName=user&&`name`in user&&user.name?user.name:user&&`username`in user&&user.username?user.username:user?.id??``,triggerId=`trigger_id`in body?body.trigger_id:void 0;await handleSlashCommand({command:{user_id:user?.id??``,user_name:userName,channel_id:body.channel?.id??``,channel_name:body.channel?.name??body.channel?.id??``,trigger_id:triggerId??String(Date.now())},ack:async()=>{},respond:respondFn,prompt,commandArgs,commandDefinition:commandDefinition??void 0})})})(SLACK_COMMAND_ARG_ACTION_ID))}const slackBoltModule=SlackBolt,{App,HTTPReceiver}=(slackBoltModule.App?slackBoltModule:slackBoltModule.default)??slackBoltModule;function parseApiAppIdFromAppToken(raw){let token=raw?.trim();if(token)return/^xapp-\d-([a-z0-9]+)-/i.exec(token)?.[1]?.toUpperCase()}async function monitorSlackProvider(opts={}){let cfg=opts.config??loadConfig(),account=resolveSlackAccount({cfg,accountId:opts.accountId}),historyLimit=Math.max(0,account.config.historyLimit??cfg.messages?.groupChat?.historyLimit??50),sessionCfg=cfg.session,sessionScope=sessionCfg?.scope??`per-sender`,mainKey=normalizeMainKey(sessionCfg?.mainKey),slackMode=opts.mode??account.config.mode??`socket`,slackWebhookPath=normalizeSlackWebhookPath(account.config.webhookPath),signingSecret=account.config.signingSecret?.trim(),botToken=resolveSlackBotToken(opts.botToken??account.botToken),appToken=resolveSlackAppToken(opts.appToken??account.appToken);if(!botToken||slackMode!==`http`&&!appToken){let missing=slackMode===`http`?`Slack bot token missing for account "${account.accountId}" (set channels.slack.accounts.${account.accountId}.botToken or SLACK_BOT_TOKEN for default).`:`Slack bot + app tokens missing for account "${account.accountId}" (set channels.slack.accounts.${account.accountId}.botToken/appToken or SLACK_BOT_TOKEN/SLACK_APP_TOKEN for default).`;throw Error(missing)}if(slackMode===`http`&&!signingSecret)throw Error(`Slack signing secret missing for account "${account.accountId}" (set channels.slack.signingSecret or channels.slack.accounts.${account.accountId}.signingSecret).`);let runtime=opts.runtime??createNonExitingRuntime(),slackCfg=account.config,dmConfig=slackCfg.dm,dmEnabled=dmConfig?.enabled??!0,dmPolicy=slackCfg.dmPolicy??dmConfig?.policy??`pairing`,allowFrom=slackCfg.allowFrom??dmConfig?.allowFrom,groupDmEnabled=dmConfig?.groupEnabled??!1,groupDmChannels=dmConfig?.groupChannels,channelsConfig=slackCfg.channels,defaultGroupPolicy=cfg.channels?.defaults?.groupPolicy,groupPolicy=slackCfg.groupPolicy??defaultGroupPolicy??`open`;slackCfg.groupPolicy===void 0&&slackCfg.channels===void 0&&defaultGroupPolicy===void 0&&groupPolicy===`open`&&runtime.log?.(warn(`slack: groupPolicy defaults to "open" when channels.slack is missing; set channels.slack.groupPolicy (or channels.defaults.groupPolicy) or add channels.slack.channels to restrict access.`));let resolveToken=slackCfg.userToken?.trim()||botToken,useAccessGroups=cfg.commands?.useAccessGroups!==!1,reactionMode=slackCfg.reactionNotifications??`own`,reactionAllowlist=slackCfg.reactionAllowlist??[],replyToMode=slackCfg.replyToMode??`all`,threadHistoryScope=slackCfg.thread?.historyScope??`thread`,threadInheritParent=slackCfg.thread?.inheritParent??!1,slashCommand=resolveSlackSlashCommandConfig(opts.slashCommand??slackCfg.slashCommand),textLimit=resolveTextChunkLimit(cfg,`slack`,account.accountId),ackReactionScope=cfg.messages?.ackReactionScope??`group-mentions`,mediaMaxBytes=(opts.mediaMaxMb??slackCfg.mediaMaxMb??20)*1024*1024,removeAckAfterReply=cfg.messages?.removeAckAfterReply??!1,receiver=slackMode===`http`?new HTTPReceiver({signingSecret:signingSecret??``,endpoints:slackWebhookPath}):null,clientOptions=resolveSlackWebClientOptions(),app=new App(slackMode===`socket`?{token:botToken,appToken,socketMode:!0,clientOptions}:{token:botToken,receiver:receiver??void 0,clientOptions}),slackHttpHandler=slackMode===`http`&&receiver?async(req,res)=>{let guard=installRequestBodyLimitGuard(req,res,{maxBytes:1048576,timeoutMs:3e4,responseFormat:`text`});if(!guard.isTripped())try{await Promise.resolve(receiver.requestListener(req,res))}catch(err){if(!guard.isTripped())throw err}finally{guard.dispose()}}:null,unregisterHttpHandler=null,botUserId=``,teamId=``,apiAppId=``,expectedApiAppIdFromAppToken=parseApiAppIdFromAppToken(appToken);try{let auth=await app.client.auth.test({token:botToken});botUserId=auth.user_id??``,teamId=auth.team_id??``,apiAppId=auth.api_app_id??``}catch{}apiAppId&&expectedApiAppIdFromAppToken&&apiAppId!==expectedApiAppIdFromAppToken&&runtime.error?.(`slack token mismatch: bot token api_app_id=${apiAppId} but app token looks like api_app_id=${expectedApiAppIdFromAppToken}`);let ctx=createSlackMonitorContext({cfg,accountId:account.accountId,botToken,app,runtime,botUserId,teamId,apiAppId,historyLimit,sessionScope,mainKey,dmEnabled,dmPolicy,allowFrom,groupDmEnabled,groupDmChannels,defaultRequireMention:slackCfg.requireMention,channelsConfig,groupPolicy,useAccessGroups,reactionMode,reactionAllowlist,replyToMode,threadHistoryScope,threadInheritParent,slashCommand,textLimit,ackReactionScope,mediaMaxBytes,removeAckAfterReply});registerSlackMonitorEvents({ctx,account,handleSlackMessage:createSlackMessageHandler({ctx,account})}),await registerSlackMonitorSlashCommands({ctx,account}),slackMode===`http`&&slackHttpHandler&&(unregisterHttpHandler=registerSlackHttpHandler({path:slackWebhookPath,handler:slackHttpHandler,log:runtime.log,accountId:account.accountId})),resolveToken&&(async()=>{if(opts.abortSignal?.aborted)return;if(channelsConfig&&Object.keys(channelsConfig).length>0)try{let entries=Object.keys(channelsConfig).filter(key=>key!==`*`);if(entries.length>0){let resolved=await resolveSlackChannelAllowlist({token:resolveToken,entries}),nextChannels={...channelsConfig},mapping=[],unresolved=[];for(let entry of resolved){let source=channelsConfig?.[entry.input];if(!source)continue;if(!entry.resolved||!entry.id){unresolved.push(entry.input);continue}mapping.push(`${entry.input}→${entry.id}${entry.archived?` (archived)`:``}`);let existing=nextChannels[entry.id]??{};nextChannels[entry.id]={...source,...existing}}channelsConfig=nextChannels,ctx.channelsConfig=nextChannels,summarizeMapping(`slack channels`,mapping,unresolved,runtime)}}catch(err){runtime.log?.(`slack channel resolve failed; using config entries. ${String(err)}`)}let allowEntries=allowFrom?.filter(entry=>String(entry).trim()&&String(entry).trim()!==`*`)??[];if(allowEntries.length>0)try{let{mapping,unresolved,additions}=buildAllowlistResolutionSummary(await resolveSlackUserAllowlist({token:resolveToken,entries:allowEntries.map(entry=>String(entry))}),{formatResolved:entry=>{let note=entry.note?` (${entry.note})`:``;return`${entry.input}→${entry.id}${note}`}});allowFrom=mergeAllowlist({existing:allowFrom,additions}),ctx.allowFrom=normalizeAllowList$2(allowFrom),summarizeMapping(`slack users`,mapping,unresolved,runtime)}catch(err){runtime.log?.(`slack user resolve failed; using config entries. ${String(err)}`)}if(channelsConfig&&Object.keys(channelsConfig).length>0){let userEntries=new Set;for(let channel of Object.values(channelsConfig))addAllowlistUserEntriesFromConfigEntry(userEntries,channel);if(userEntries.size>0)try{let{resolvedMap,mapping,unresolved}=buildAllowlistResolutionSummary(await resolveSlackUserAllowlist({token:resolveToken,entries:Array.from(userEntries)})),nextChannels=patchAllowlistUsersInConfigEntries({entries:channelsConfig,resolvedMap});channelsConfig=nextChannels,ctx.channelsConfig=nextChannels,summarizeMapping(`slack channel users`,mapping,unresolved,runtime)}catch(err){runtime.log?.(`slack channel user resolve failed; using config entries. ${String(err)}`)}}})();let stopOnAbort=()=>{opts.abortSignal?.aborted&&slackMode===`socket`&&app.stop()};opts.abortSignal?.addEventListener(`abort`,stopOnAbort,{once:!0});try{if(slackMode===`socket`?(await app.start(),runtime.log?.(`slack socket mode connected`)):runtime.log?.(`slack http mode listening at ${slackWebhookPath}`),opts.abortSignal?.aborted)return;await new Promise(resolve=>{opts.abortSignal?.addEventListener(`abort`,()=>resolve(),{once:!0})})}finally{opts.abortSignal?.removeEventListener(`abort`,stopOnAbort),unregisterHttpHandler?.(),await app.stop().catch(()=>void 0)}}async function probeSlack(token,timeoutMs=2500){let client=createSlackWebClient(token),start=Date.now();try{let result=await withTimeout(client.auth.test(),timeoutMs);return result.ok?{ok:!0,status:200,elapsedMs:Date.now()-start,bot:{id:result.user_id??void 0,name:result.user??void 0},team:{id:result.team_id??void 0,name:result.team??void 0}}:{ok:!1,status:200,error:result.error??`unknown`,elapsedMs:Date.now()-start}}catch(err){let message=err instanceof Error?err.message:String(err);return{ok:!1,status:typeof err.status==`number`?err.status:null,error:message,elapsedMs:Date.now()-start}}}function collectTelegramUnmentionedGroupIds(groups){if(!groups||typeof groups!=`object`)return{groupIds:[],unresolvedGroups:0,hasWildcardUnmentionedGroups:!1};let hasWildcardUnmentionedGroups=groups[`*`]?.requireMention===!1&&groups[`*`]?.enabled!==!1,groupIds=[],unresolvedGroups=0;for(let[key,value]of Object.entries(groups)){if(key===`*`||!value||typeof value!=`object`||value.enabled===!1||value.requireMention!==!1)continue;let id=String(key).trim();id&&(/^-?\d+$/.test(id)?groupIds.push(id):unresolvedGroups+=1)}return groupIds.sort((a,b)=>a.localeCompare(b)),{groupIds,unresolvedGroups,hasWildcardUnmentionedGroups}}async function auditTelegramGroupMembership(params){let started=Date.now(),token=params.token?.trim()??``;if(!token||params.groupIds.length===0)return{ok:!0,checkedGroups:0,unresolvedGroups:0,hasWildcardUnmentionedGroups:!1,groups:[],elapsedMs:Date.now()-started};let fetcher=params.proxyUrl?makeProxyFetch(params.proxyUrl):fetch,base=`https://api.telegram.org/bot${token}`,groups=[];for(let chatId of params.groupIds)try{let res=await fetchWithTimeout(`${base}/getChatMember?chat_id=${encodeURIComponent(chatId)}&user_id=${encodeURIComponent(String(params.botId))}`,{},params.timeoutMs,fetcher),json=await res.json();if(!res.ok||!isRecord$1(json)||!json.ok){let desc=isRecord$1(json)&&!json.ok&&typeof json.description==`string`?json.description:`getChatMember failed (${res.status})`;groups.push({chatId,ok:!1,status:null,error:desc,matchKey:chatId,matchSource:`id`});continue}let status=isRecord$1(json.result)?json.result.status??null:null,ok=status===`creator`||status===`administrator`||status===`member`;groups.push({chatId,ok,status,error:ok?null:`bot not in group`,matchKey:chatId,matchSource:`id`})}catch(err){groups.push({chatId,ok:!1,status:null,error:err instanceof Error?err.message:String(err),matchKey:chatId,matchSource:`id`})}return{ok:groups.every(g=>g.ok),checkedGroups:groups.length,unresolvedGroups:0,hasWildcardUnmentionedGroups:!1,groups,elapsedMs:Date.now()-started}}function resolveTelegramAllowedUpdates(){let updates=[...API_CONSTANTS.DEFAULT_UPDATE_TYPES];return updates.includes(`message_reaction`)||updates.push(`message_reaction`),updates.includes(`channel_post`)||updates.push(`channel_post`),updates}const resolveTelegramUpdateId=ctx=>ctx.update?.update_id??ctx.update_id,buildTelegramUpdateKey=ctx=>{let updateId=resolveTelegramUpdateId(ctx);if(typeof updateId==`number`)return`update:${updateId}`;let callbackId=ctx.callbackQuery?.id;if(callbackId)return`callback:${callbackId}`;let msg=ctx.message??ctx.channelPost??ctx.editedChannelPost??ctx.update?.message??ctx.update?.edited_message??ctx.update?.channel_post??ctx.update?.edited_channel_post??ctx.callbackQuery?.message,chatId=msg?.chat?.id,messageId=msg?.message_id;if(chatId!==void 0&&typeof messageId==`number`)return`message:${chatId}:${messageId}`},createTelegramUpdateDedupe=()=>createDedupeCache({ttlMs:3e5,maxSize:2e3}),PARSE_ERR_RE=/can't parse entities|parse entities|find end of the entity/i,VOICE_FORBIDDEN_RE=/VOICE_MESSAGES_FORBIDDEN/,FILE_TOO_BIG_RE=/file is too big/i;async function deliverReplies(params){let{replies,chatId,runtime,bot,replyToMode,textLimit,thread,linkPreview,replyQuoteText}=params,chunkMode=params.chunkMode??`length`,hasReplied=!1,hasDelivered=!1,markDelivered=()=>{hasDelivered=!0},chunkText=markdown=>{let markdownChunks=chunkMode===`newline`?chunkMarkdownTextWithMode(markdown,textLimit,chunkMode):[markdown],chunks=[];for(let chunk of markdownChunks){let nested=markdownToTelegramChunks(chunk,textLimit,{tableMode:params.tableMode});if(!nested.length&&chunk){chunks.push({html:wrapFileReferencesInHtml(markdownToTelegramHtml(chunk,{tableMode:params.tableMode,wrapFileRefs:!1})),text:chunk});continue}chunks.push(...nested)}return chunks};for(let reply of replies){let hasMedia=!!reply?.mediaUrl||(reply?.mediaUrls?.length??0)>0;if(!reply?.text&&!hasMedia){if(reply?.audioAsVoice){logVerbose(`telegram reply has audioAsVoice without media/text; skipping`);continue}runtime.error?.(danger(`reply missing text/media`));continue}let replyToId=replyToMode===`off`?void 0:resolveTelegramReplyId(reply.replyToId),replyToMessageIdForPayload=replyToId&&(replyToMode===`all`||!hasReplied)?replyToId:void 0,mediaList=reply.mediaUrls?.length?reply.mediaUrls:reply.mediaUrl?[reply.mediaUrl]:[],telegramData=reply.channelData?.telegram,replyMarkup=buildInlineKeyboard(telegramData?.buttons);if(mediaList.length===0){let chunks=chunkText(reply.text||``),sentTextChunk=!1;for(let i=0;i<chunks.length;i+=1){let chunk=chunks[i];if(!chunk)continue;let shouldAttachButtons=i===0&&replyMarkup;await sendTelegramText(bot,chatId,chunk.html,runtime,{replyToMessageId:replyToMessageIdForPayload,replyQuoteText,thread,textMode:`html`,plainText:chunk.text,linkPreview,replyMarkup:shouldAttachButtons?replyMarkup:void 0}),sentTextChunk=!0,markDelivered()}replyToMessageIdForPayload&&!hasReplied&&sentTextChunk&&(hasReplied=!0);continue}let first=!0,pendingFollowUpText;for(let mediaUrl of mediaList){let isFirstMedia=first,media=await loadWebMedia(mediaUrl,{localRoots:params.mediaLocalRoots}),kind=mediaKindFromMime(media.contentType??void 0),isGif=isGifMedia({contentType:media.contentType,fileName:media.fileName}),fileName=media.fileName??(isGif?`animation.gif`:`file`),file=new InputFile(media.buffer,fileName),{caption,followUpText}=splitTelegramCaption(isFirstMedia?reply.text??void 0:void 0),htmlCaption=caption?renderTelegramHtmlText(caption,{tableMode:params.tableMode}):void 0;followUpText&&(pendingFollowUpText=followUpText),first=!1;let replyToMessageId=replyToMessageIdForPayload,shouldAttachButtonsToMedia=isFirstMedia&&replyMarkup&&!followUpText,mediaParams={caption:htmlCaption,...htmlCaption?{parse_mode:`HTML`}:{},...shouldAttachButtonsToMedia?{reply_markup:replyMarkup}:{},...buildTelegramSendParams({replyToMessageId,thread})};if(isGif)await withTelegramApiErrorLogging({operation:`sendAnimation`,runtime,fn:()=>bot.api.sendAnimation(chatId,file,{...mediaParams})}),markDelivered();else if(kind===`image`)await withTelegramApiErrorLogging({operation:`sendPhoto`,runtime,fn:()=>bot.api.sendPhoto(chatId,file,{...mediaParams})}),markDelivered();else if(kind===`video`)await withTelegramApiErrorLogging({operation:`sendVideo`,runtime,fn:()=>bot.api.sendVideo(chatId,file,{...mediaParams})}),markDelivered();else if(kind===`audio`){let{useVoice}=resolveTelegramVoiceSend({wantsVoice:reply.audioAsVoice===!0,contentType:media.contentType,fileName,logFallback:logVerbose});if(useVoice){await params.onVoiceRecording?.();try{await withTelegramApiErrorLogging({operation:`sendVoice`,runtime,shouldLog:err=>!isVoiceMessagesForbidden(err),fn:()=>bot.api.sendVoice(chatId,file,{...mediaParams})}),markDelivered()}catch(voiceErr){if(isVoiceMessagesForbidden(voiceErr)){let fallbackText=reply.text;if(!fallbackText||!fallbackText.trim())throw voiceErr;logVerbose(`telegram sendVoice forbidden (recipient has voice messages blocked in privacy settings); falling back to text`),await sendTelegramVoiceFallbackText({bot,chatId,runtime,text:fallbackText,chunkText,replyToId:replyToMessageIdForPayload,thread,linkPreview,replyMarkup,replyQuoteText}),replyToMessageIdForPayload&&!hasReplied&&(hasReplied=!0),markDelivered();continue}throw voiceErr}}else await withTelegramApiErrorLogging({operation:`sendAudio`,runtime,fn:()=>bot.api.sendAudio(chatId,file,{...mediaParams})}),markDelivered()}else await withTelegramApiErrorLogging({operation:`sendDocument`,runtime,fn:()=>bot.api.sendDocument(chatId,file,{...mediaParams})}),markDelivered();if(replyToId&&!hasReplied&&(hasReplied=!0),pendingFollowUpText&&isFirstMedia){let chunks=chunkText(pendingFollowUpText);for(let i=0;i<chunks.length;i+=1){let chunk=chunks[i];await sendTelegramText(bot,chatId,chunk.html,runtime,{replyToMessageId:replyToMessageIdForPayload,thread,textMode:`html`,plainText:chunk.text,linkPreview,replyMarkup:i===0?replyMarkup:void 0}),markDelivered()}pendingFollowUpText=void 0}replyToMessageIdForPayload&&!hasReplied&&(hasReplied=!0)}}return{delivered:hasDelivered}}async function resolveMedia(ctx,maxBytes,token,proxyFetch){let msg=ctx.message,downloadAndSaveTelegramFile=async(filePath,fetchImpl)=>{let fetched=await fetchRemoteMedia({url:`https://api.telegram.org/file/bot${token}/${filePath}`,fetchImpl,filePathHint:filePath}),originalName=fetched.fileName??filePath;return saveMediaBuffer(fetched.buffer,fetched.contentType,`inbound`,maxBytes,originalName)};if(msg.sticker){let sticker=msg.sticker;if(sticker.is_animated||sticker.is_video)return logVerbose(`telegram: skipping animated/video sticker (only static stickers supported)`),null;if(!sticker.file_id)return null;try{let file=await ctx.getFile();if(!file.file_path)return logVerbose(`telegram: getFile returned no file_path for sticker`),null;let fetchImpl=proxyFetch??globalThis.fetch;if(!fetchImpl)return logVerbose(`telegram: fetch not available for sticker download`),null;let saved=await downloadAndSaveTelegramFile(file.file_path,fetchImpl),cached=sticker.file_unique_id?await getCachedSticker(sticker.file_unique_id):null;if(cached){logVerbose(`telegram: sticker cache hit for ${sticker.file_unique_id}`);let fileId=sticker.file_id??cached.fileId,emoji=sticker.emoji??cached.emoji,setName=sticker.set_name??cached.setName;return(fileId!==cached.fileId||emoji!==cached.emoji||setName!==cached.setName)&&cacheSticker({...cached,fileId,emoji,setName}),{path:saved.path,contentType:saved.contentType,placeholder:`<media:sticker>`,stickerMetadata:{emoji,setName,fileId,fileUniqueId:sticker.file_unique_id,cachedDescription:cached.description}}}return{path:saved.path,contentType:saved.contentType,placeholder:`<media:sticker>`,stickerMetadata:{emoji:sticker.emoji??void 0,setName:sticker.set_name??void 0,fileId:sticker.file_id,fileUniqueId:sticker.file_unique_id}}}catch(err){return logVerbose(`telegram: failed to process sticker: ${String(err)}`),null}}if(!(msg.photo?.[msg.photo.length-1]??msg.video??msg.video_note??msg.document??msg.audio??msg.voice)?.file_id)return null;let file;try{file=await retryAsync(()=>ctx.getFile(),{attempts:3,minDelayMs:1e3,maxDelayMs:4e3,jitter:.2,label:`telegram:getFile`,shouldRetry:isRetryableGetFileError,onRetry:({attempt,maxAttempts})=>logVerbose(`telegram: getFile retry ${attempt}/${maxAttempts}`)})}catch(err){return isFileTooBigError(err)?(logVerbose(warn(`telegram: getFile failed - file exceeds Telegram Bot API 20MB limit; skipping attachment`)),null):(logVerbose(`telegram: getFile failed after retries: ${String(err)}`),null)}if(!file.file_path)throw Error(`Telegram getFile returned no file_path`);let fetchImpl=proxyFetch??globalThis.fetch;if(!fetchImpl)throw Error(`fetch is not available; set channels.telegram.proxy in config`);let saved=await downloadAndSaveTelegramFile(file.file_path,fetchImpl),placeholder=resolveTelegramMediaPlaceholder(msg)??`<media:document>`;return{path:saved.path,contentType:saved.contentType,placeholder}}function isVoiceMessagesForbidden(err){return err instanceof GrammyError?VOICE_FORBIDDEN_RE.test(err.description):VOICE_FORBIDDEN_RE.test(formatErrorMessage(err))}function isFileTooBigError(err){return err instanceof GrammyError?FILE_TOO_BIG_RE.test(err.description):FILE_TOO_BIG_RE.test(formatErrorMessage(err))}function isRetryableGetFileError(err){return!isFileTooBigError(err)}async function sendTelegramVoiceFallbackText(opts){let chunks=opts.chunkText(opts.text);for(let i=0;i<chunks.length;i+=1){let chunk=chunks[i];await sendTelegramText(opts.bot,opts.chatId,chunk.html,opts.runtime,{replyToMessageId:opts.replyToId,replyQuoteText:opts.replyQuoteText,thread:opts.thread,textMode:`html`,plainText:chunk.text,linkPreview:opts.linkPreview,replyMarkup:i===0?opts.replyMarkup:void 0})}}function buildTelegramSendParams(opts){let threadParams=buildTelegramThreadParams(opts?.thread),params={};return opts?.replyToMessageId&&(params.reply_to_message_id=opts.replyToMessageId),threadParams&&(params.message_thread_id=threadParams.message_thread_id),params}async function sendTelegramText(bot,chatId,text,runtime,opts){let baseParams=buildTelegramSendParams({replyToMessageId:opts?.replyToMessageId,thread:opts?.thread}),linkPreviewOptions=opts?.linkPreview??!0?void 0:{is_disabled:!0},htmlText=(opts?.textMode??`markdown`)===`html`?text:markdownToTelegramHtml(text);try{return(await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,shouldLog:err=>!PARSE_ERR_RE.test(formatErrorMessage(err)),fn:()=>bot.api.sendMessage(chatId,htmlText,{parse_mode:`HTML`,...linkPreviewOptions?{link_preview_options:linkPreviewOptions}:{},...opts?.replyMarkup?{reply_markup:opts.replyMarkup}:{},...baseParams})})).message_id}catch(err){let errText=formatErrorMessage(err);if(PARSE_ERR_RE.test(errText)){runtime.log?.(`telegram HTML parse failed; retrying without formatting: ${errText}`);let fallbackText=opts?.plainText??text;return(await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,fn:()=>bot.api.sendMessage(chatId,fallbackText,{...linkPreviewOptions?{link_preview_options:linkPreviewOptions}:{},...opts?.replyMarkup?{reply_markup:opts.replyMarkup}:{},...baseParams})})).message_id}throw err}}const evaluateTelegramGroupBaseAccess=params=>{if(!params.isGroup)return{allowed:!0};if(params.groupConfig?.enabled===!1)return{allowed:!1,reason:`group-disabled`};if(params.topicConfig?.enabled===!1)return{allowed:!1,reason:`topic-disabled`};if(!params.enforceAllowOverride||!params.hasGroupAllowOverride)return{allowed:!0};let senderId=params.senderId??``;return params.requireSenderForAllowOverride&&!senderId||!isSenderAllowed$1({allow:params.effectiveGroupAllow,senderId,senderUsername:params.senderUsername??``})?{allowed:!1,reason:`group-override-unauthorized`}:{allowed:!0}},evaluateTelegramGroupPolicyAccess=params=>{let fallbackPolicy=firstDefined$2(params.telegramCfg.groupPolicy,params.cfg.channels?.defaults?.groupPolicy,`open`)??`open`,groupPolicy=params.useTopicAndGroupOverrides?firstDefined$2(params.topicConfig?.groupPolicy,params.groupConfig?.groupPolicy,params.telegramCfg.groupPolicy,params.cfg.channels?.defaults?.groupPolicy,`open`)??`open`:fallbackPolicy;if(!params.isGroup||!params.enforcePolicy)return{allowed:!0,groupPolicy};if(groupPolicy===`disabled`)return{allowed:!1,reason:`group-policy-disabled`,groupPolicy};if(groupPolicy===`allowlist`&&params.enforceAllowlistAuthorization){let senderId=params.senderId??``;if(params.requireSenderForAllowlistAuthorization&&!senderId)return{allowed:!1,reason:`group-policy-allowlist-no-sender`,groupPolicy};if(!params.allowEmptyAllowlistEntries&&!params.effectiveGroupAllow.hasEntries)return{allowed:!1,reason:`group-policy-allowlist-empty`,groupPolicy};let senderUsername=params.senderUsername??``;if(!isSenderAllowed$1({allow:params.effectiveGroupAllow,senderId,senderUsername}))return{allowed:!1,reason:`group-policy-allowlist-unauthorized`,groupPolicy}}if(params.checkChatAllowlist){let groupAllowlist=params.resolveGroupPolicy(params.chatId);if(groupAllowlist.allowlistEnabled&&!groupAllowlist.allowed)return{allowed:!1,reason:`group-chat-not-allowed`,groupPolicy}}return{allowed:!0,groupPolicy}};function resolveAccountGroups(cfg,accountId){if(!accountId)return{};let normalized=normalizeAccountId$2(accountId),accounts=cfg.channels?.telegram?.accounts;if(!accounts||typeof accounts!=`object`)return{};let exact=accounts[normalized];if(exact?.groups)return{groups:exact.groups};let matchKey=Object.keys(accounts).find(key=>key.toLowerCase()===normalized.toLowerCase());return{groups:matchKey?accounts[matchKey]?.groups:void 0}}function migrateTelegramGroupsInPlace(groups,oldChatId,newChatId){return!groups||oldChatId===newChatId||!Object.hasOwn(groups,oldChatId)?{migrated:!1,skippedExisting:!1}:Object.hasOwn(groups,newChatId)?{migrated:!1,skippedExisting:!0}:(groups[newChatId]=groups[oldChatId],delete groups[oldChatId],{migrated:!0,skippedExisting:!1})}function migrateTelegramGroupConfig(params){let scopes=[],migrated=!1,skippedExisting=!1,migrationTargets=[{scope:`account`,groups:resolveAccountGroups(params.cfg,params.accountId).groups},{scope:`global`,groups:params.cfg.channels?.telegram?.groups}];for(let target of migrationTargets){let result=migrateTelegramGroupsInPlace(target.groups,params.oldChatId,params.newChatId);result.migrated&&(migrated=!0,scopes.push(target.scope)),result.skippedExisting&&(skippedExisting=!0)}return{migrated,skippedExisting,scopes}}const registerTelegramHandlers=({cfg,accountId,bot,opts,runtime,mediaMaxBytes,telegramCfg,groupAllowFrom,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,processMessage,logger})=>{let TELEGRAM_TEXT_FRAGMENT_MAX_GAP_MS=typeof opts.testTimings?.textFragmentGapMs==`number`&&Number.isFinite(opts.testTimings.textFragmentGapMs)?Math.max(10,Math.floor(opts.testTimings.textFragmentGapMs)):1500,mediaGroupTimeoutMs=typeof opts.testTimings?.mediaGroupFlushMs==`number`&&Number.isFinite(opts.testTimings.mediaGroupFlushMs)?Math.max(10,Math.floor(opts.testTimings.mediaGroupFlushMs)):500,mediaGroupBuffer=new Map,mediaGroupProcessing=Promise.resolve(),textFragmentBuffer=new Map,textFragmentProcessing=Promise.resolve(),debounceMs=resolveInboundDebounceMs({cfg,channel:`telegram`}),buildSyntheticTextMessage=params=>({...params.base,...params.from?{from:params.from}:{},text:params.text,caption:void 0,caption_entities:void 0,entities:void 0,...params.date==null?{}:{date:params.date}}),buildSyntheticContext=(ctx,message)=>{let getFile=typeof ctx.getFile==`function`?ctx.getFile.bind(ctx):async()=>({});return{message,me:ctx.me,getFile}},inboundDebouncer=createInboundDebouncer({debounceMs,buildKey:entry=>entry.debounceKey,shouldDebounce:entry=>{if(entry.allMedia.length>0)return!1;let text=entry.msg.text??entry.msg.caption??``;return text.trim()?!hasControlCommand(text,cfg,{botUsername:entry.botUsername}):!1},onFlush:async entries=>{let last=entries.at(-1);if(!last)return;if(entries.length===1){await processMessage(last.ctx,last.allMedia,last.storeAllowFrom);return}let combinedText=entries.map(entry=>entry.msg.text??entry.msg.caption??``).filter(Boolean).join(`
475
+ `),combinedMentioned=entries.some(entry=>!!entry.opts.wasMentioned),prepared=await prepareSlackMessage({ctx,account,message:{...last.message,text:combinedText},opts:{...last.opts,wasMentioned:combinedMentioned||last.opts.wasMentioned}});if(prepared){if(entries.length>1){let ids=entries.map(entry=>entry.message.ts).filter(Boolean);ids.length>0&&(prepared.ctxPayload.MessageSids=ids,prepared.ctxPayload.MessageSidFirst=ids[0],prepared.ctxPayload.MessageSidLast=ids[ids.length-1])}await dispatchPreparedSlackMessage(prepared)}},onError:err=>{ctx.runtime.error?.(`slack inbound debounce flush failed: ${String(err)}`)}});return async(message,opts)=>{if(opts.source===`message`&&message.type!==`message`||opts.source===`message`&&message.subtype&&message.subtype!==`file_share`&&message.subtype!==`bot_message`||ctx.markMessageSeen(message.channel,message.ts))return;let resolvedMessage=await threadTsResolver.resolve({message,source:opts.source});await debouncer.enqueue({message:resolvedMessage,opts})}}const SLACK_COMMAND_ARG_ACTION_ID=`builderforce_cmdarg`,SLACK_COMMAND_ARG_VALUE_PREFIX=`cmdarg`,SLACK_COMMAND_ARG_EXTERNAL_PREFIX=`builderforce_cmdarg_ext:`,slackExternalArgMenuStore=new Map;function truncatePlainText(value,max){let trimmed=value.trim();return trimmed.length<=max?trimmed:max<=1?trimmed.slice(0,max):`${trimmed.slice(0,max-1)}…`}function escapeSlackMrkdwn(value){return value.replaceAll(`\\`,`\\\\`).replaceAll(`&`,`&amp;`).replaceAll(`<`,`&lt;`).replaceAll(`>`,`&gt;`).replace(/([*_`~])/g,`\\$1`)}function buildSlackArgMenuConfirm(params){return{title:{type:`plain_text`,text:`Confirm selection`},text:{type:`mrkdwn`,text:`Run */${escapeSlackMrkdwn(params.command)}* with *${escapeSlackMrkdwn(params.arg)}* set to this value?`},confirm:{type:`plain_text`,text:`Run command`},deny:{type:`plain_text`,text:`Cancel`}}}function pruneSlackExternalArgMenuStore(now=Date.now()){for(let[token,entry]of slackExternalArgMenuStore.entries())entry.expiresAt<=now&&slackExternalArgMenuStore.delete(token)}function storeSlackExternalArgMenu(params){pruneSlackExternalArgMenuStore();let token=`${Date.now().toString(36)}${Math.random().toString(36).slice(2,10)}`;return slackExternalArgMenuStore.set(token,{choices:params.choices,userId:params.userId,expiresAt:Date.now()+6e5}),token}function readSlackExternalArgMenuToken(raw){if(typeof raw!=`string`||!raw.startsWith(SLACK_COMMAND_ARG_EXTERNAL_PREFIX))return;let token=raw.slice(24).trim();return token.length>0?token:void 0}function encodeSlackCommandArgValue(parts){return[SLACK_COMMAND_ARG_VALUE_PREFIX,encodeURIComponent(parts.command),encodeURIComponent(parts.arg),encodeURIComponent(parts.value),encodeURIComponent(parts.userId)].join(`|`)}function parseSlackCommandArgValue(raw){if(!raw)return null;let parts=raw.split(`|`);if(parts.length!==5||parts[0]!==SLACK_COMMAND_ARG_VALUE_PREFIX)return null;let[,command,arg,value,userId]=parts;if(!command||!arg||!value||!userId)return null;let decode=text=>{try{return decodeURIComponent(text)}catch{return null}},decodedCommand=decode(command),decodedArg=decode(arg),decodedValue=decode(value),decodedUserId=decode(userId);return!decodedCommand||!decodedArg||!decodedValue||!decodedUserId?null:{command:decodedCommand,arg:decodedArg,value:decodedValue,userId:decodedUserId}}function buildSlackCommandArgMenuBlocks(params){let encodedChoices=params.choices.map(choice=>({label:choice.label,value:encodeSlackCommandArgValue({command:params.command,arg:params.arg,value:choice.value,userId:params.userId})})),canUseStaticSelect=encodedChoices.every(choice=>choice.value.length<=75),canUseOverflow=canUseStaticSelect&&encodedChoices.length>=3&&encodedChoices.length<=5,canUseExternalSelect=params.supportsExternalSelect&&canUseStaticSelect&&encodedChoices.length>100,rows=canUseOverflow?[{type:`actions`,elements:[{type:`overflow`,action_id:SLACK_COMMAND_ARG_ACTION_ID,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg}),options:encodedChoices.map(choice=>({text:{type:`plain_text`,text:choice.label.slice(0,75)},value:choice.value}))}]}]:canUseExternalSelect?[{type:`actions`,block_id:`${SLACK_COMMAND_ARG_EXTERNAL_PREFIX}${params.createExternalMenuToken(encodedChoices)}`,elements:[{type:`external_select`,action_id:SLACK_COMMAND_ARG_ACTION_ID,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg}),min_query_length:0,placeholder:{type:`plain_text`,text:`Search ${params.arg}`}}]}]:encodedChoices.length<=5||!canUseStaticSelect?chunkItems(encodedChoices,5).map(choices=>({type:`actions`,elements:choices.map(choice=>({type:`button`,action_id:SLACK_COMMAND_ARG_ACTION_ID,text:{type:`plain_text`,text:choice.label},value:choice.value,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg})}))})):chunkItems(encodedChoices,100).map((choices,index)=>({type:`actions`,elements:[{type:`static_select`,action_id:SLACK_COMMAND_ARG_ACTION_ID,confirm:buildSlackArgMenuConfirm({command:params.command,arg:params.arg}),placeholder:{type:`plain_text`,text:index===0?`Choose ${params.arg}`:`Choose ${params.arg} (${index+1})`},options:choices.map(choice=>({text:{type:`plain_text`,text:choice.label.slice(0,75)},value:choice.value}))}]})),headerText=truncatePlainText(`/${params.command}: choose ${params.arg}`,150),sectionText=truncatePlainText(params.title,3e3),contextText=truncatePlainText(`Select one option to continue /${params.command} (${params.arg})`,3e3);return[{type:`header`,text:{type:`plain_text`,text:headerText}},{type:`section`,text:{type:`mrkdwn`,text:sectionText}},{type:`context`,elements:[{type:`mrkdwn`,text:contextText}]},...rows]}async function registerSlackMonitorSlashCommands(params){let{ctx,account}=params,cfg=ctx.cfg,runtime=ctx.runtime,supportsInteractiveArgMenus=typeof ctx.app.action==`function`,supportsExternalArgMenus=typeof ctx.app.options==`function`,slashCommand=resolveSlackSlashCommandConfig(ctx.slashCommand??account.config.slashCommand),handleSlashCommand=async p=>{let{command,ack,respond,prompt,commandArgs,commandDefinition}=p;try{if(!prompt.trim()){await ack({text:`Message required.`,response_type:`ephemeral`});return}if(await ack(),ctx.botUserId&&command.user_id===ctx.botUserId)return;let channelInfo=await ctx.resolveChannelName(command.channel_id),channelType=normalizeSlackChannelType(channelInfo?.type??(command.channel_name===`directmessage`?`im`:void 0),command.channel_id),isDirectMessage=channelType===`im`,isGroupDm=channelType===`mpim`,isRoom=channelType===`channel`||channelType===`group`,isRoomish=isRoom||isGroupDm;if(!ctx.isChannelAllowed({channelId:command.channel_id,channelName:channelInfo?.name,channelType})){await respond({text:`This channel is not allowed.`,response_type:`ephemeral`});return}let storeAllowFrom=await readChannelAllowFromStore(`slack`).catch(()=>[]),effectiveAllowFromLower=normalizeAllowListLower(normalizeAllowList$2([...ctx.allowFrom,...storeAllowFrom])),commandAuthorized=!1,channelConfig=null;if(isDirectMessage){if(!ctx.dmEnabled||ctx.dmPolicy===`disabled`){await respond({text:`Slack DMs are disabled.`,response_type:`ephemeral`});return}if(ctx.dmPolicy!==`open`){let senderName=(await ctx.resolveUserName(command.user_id))?.name??void 0,allowMatch=resolveSlackAllowListMatch({allowList:effectiveAllowFromLower,id:command.user_id,name:senderName}),allowMatchMeta=formatAllowlistMatchMeta(allowMatch);if(!allowMatch.allowed){if(ctx.dmPolicy===`pairing`){let{code,created}=await upsertChannelPairingRequest({channel:`slack`,id:command.user_id,meta:{name:senderName}});created&&(logVerbose(`slack pairing request sender=${command.user_id} name=${senderName??`unknown`} (${allowMatchMeta})`),await respond({text:buildPairingReply({channel:`slack`,idLine:`Your Slack user id: ${command.user_id}`,code}),response_type:`ephemeral`}))}else logVerbose(`slack: blocked slash sender ${command.user_id} (dmPolicy=${ctx.dmPolicy}, ${allowMatchMeta})`),await respond({text:`You are not authorized to use this command.`,response_type:`ephemeral`});return}}}if(isRoom&&(channelConfig=resolveSlackChannelConfig({channelId:command.channel_id,channelName:channelInfo?.name,channels:ctx.channelsConfig,defaultRequireMention:ctx.defaultRequireMention}),ctx.useAccessGroups)){let channelAllowlistConfigured=!!ctx.channelsConfig&&Object.keys(ctx.channelsConfig??{}).length>0,channelAllowed=channelConfig?.allowed!==!1;if(!isSlackChannelAllowedByPolicy({groupPolicy:ctx.groupPolicy,channelAllowlistConfigured,channelAllowed})){await respond({text:`This channel is not allowed.`,response_type:`ephemeral`});return}let hasExplicitConfig=!!channelConfig?.matchSource;if(!channelAllowed&&(ctx.groupPolicy!==`open`||hasExplicitConfig)){await respond({text:`This channel is not allowed.`,response_type:`ephemeral`});return}}let senderName=(await ctx.resolveUserName(command.user_id))?.name??command.user_name??command.user_id,channelUsersAllowlistConfigured=isRoom&&Array.isArray(channelConfig?.users)&&channelConfig.users.length>0,channelUserAllowed=channelUsersAllowlistConfigured?resolveSlackUserAllowed({allowList:channelConfig?.users,userId:command.user_id,userName:senderName}):!1;if(channelUsersAllowlistConfigured&&!channelUserAllowed){await respond({text:`You are not authorized to use this command here.`,response_type:`ephemeral`});return}let ownerAllowed=resolveSlackAllowListMatch({allowList:effectiveAllowFromLower,id:command.user_id,name:senderName}).allowed;if(commandAuthorized=resolveCommandAuthorizedFromAuthorizers({useAccessGroups:ctx.useAccessGroups,authorizers:[{configured:effectiveAllowFromLower.length>0,allowed:ownerAllowed}],modeWhenAccessGroupsOff:`configured`}),isRoomish&&(commandAuthorized=resolveCommandAuthorizedFromAuthorizers({useAccessGroups:ctx.useAccessGroups,authorizers:[{configured:effectiveAllowFromLower.length>0,allowed:ownerAllowed},{configured:channelUsersAllowlistConfigured,allowed:channelUserAllowed}],modeWhenAccessGroupsOff:`configured`}),ctx.useAccessGroups&&!commandAuthorized)){await respond({text:`You are not authorized to use this command.`,response_type:`ephemeral`});return}if(commandDefinition&&supportsInteractiveArgMenus){let menu=resolveCommandArgMenu({command:commandDefinition,args:commandArgs,cfg});if(menu){let commandLabel=commandDefinition.nativeName??commandDefinition.key,title=menu.title??`Choose ${menu.arg.description||menu.arg.name} for /${commandLabel}.`;await respond({text:title,blocks:buildSlackCommandArgMenuBlocks({title,command:commandLabel,arg:menu.arg.name,choices:menu.choices,userId:command.user_id,supportsExternalSelect:supportsExternalArgMenus,createExternalMenuToken:choices=>storeSlackExternalArgMenu({choices,userId:command.user_id})}),response_type:`ephemeral`});return}}let channelName=channelInfo?.name,roomLabel=channelName?`#${channelName}`:`#${command.channel_id}`,[{resolveAgentRoute},{finalizeInboundContext},{dispatchReplyWithDispatcher}]=await Promise.all([import(`./resolve-route-cKRJeWLf.js`),import(`./inbound-context-CDIkHDDR.js`),import(`./provider-dispatcher-Bwaplzm8.js`)]),[{resolveConversationLabel},{createReplyPrefixOptions}]=await Promise.all([import(`./conversation-label-KkzPOmk2.js`),import(`./reply-prefix-BCHZqFk0.js`)]),route=resolveAgentRoute({cfg,channel:`slack`,accountId:account.accountId,teamId:ctx.teamId||void 0,peer:{kind:isDirectMessage?`direct`:isRoom?`channel`:`group`,id:isDirectMessage?command.user_id:command.channel_id}}),{untrustedChannelMetadata,groupSystemPrompt}=resolveSlackRoomContextHints({isRoomish,channelInfo,channelConfig}),ctxPayload=finalizeInboundContext({Body:prompt,BodyForAgent:prompt,RawBody:prompt,CommandBody:prompt,CommandArgs:commandArgs,From:isDirectMessage?`slack:${command.user_id}`:isRoom?`slack:channel:${command.channel_id}`:`slack:group:${command.channel_id}`,To:`slash:${command.user_id}`,ChatType:isDirectMessage?`direct`:`channel`,ConversationLabel:resolveConversationLabel({ChatType:isDirectMessage?`direct`:`channel`,SenderName:senderName,GroupSubject:isRoomish?roomLabel:void 0,From:isDirectMessage?`slack:${command.user_id}`:isRoom?`slack:channel:${command.channel_id}`:`slack:group:${command.channel_id}`})??(isDirectMessage?senderName:roomLabel),GroupSubject:isRoomish?roomLabel:void 0,GroupSystemPrompt:isRoomish?groupSystemPrompt:void 0,UntrustedContext:untrustedChannelMetadata?[untrustedChannelMetadata]:void 0,SenderName:senderName,SenderId:command.user_id,Provider:`slack`,Surface:`slack`,WasMentioned:!0,MessageSid:command.trigger_id,Timestamp:Date.now(),SessionKey:`agent:${route.agentId}:${slashCommand.sessionPrefix}:${command.user_id}`.toLowerCase(),CommandTargetSessionKey:route.sessionKey,AccountId:route.accountId,CommandSource:`native`,CommandAuthorized:commandAuthorized,OriginatingChannel:`slack`,OriginatingTo:`user:${command.user_id}`}),{onModelSelected,...prefixOptions}=createReplyPrefixOptions({cfg,agentId:route.agentId,channel:`slack`,accountId:route.accountId}),deliverSlashPayloads=async replies=>{let[{deliverSlackSlashReplies},{resolveChunkMode},{resolveMarkdownTableMode}]=await Promise.all([import(`./replies-DNc24mQf.js`),import(`./chunk-BIVaOXre.js`),import(`./markdown-tables-BuiwWVry.js`)]);await deliverSlackSlashReplies({replies,respond,ephemeral:slashCommand.ephemeral,textLimit:ctx.textLimit,chunkMode:resolveChunkMode(cfg,`slack`,route.accountId),tableMode:resolveMarkdownTableMode({cfg,channel:`slack`,accountId:route.accountId})})},{counts}=await dispatchReplyWithDispatcher({ctx:ctxPayload,cfg,dispatcherOptions:{...prefixOptions,deliver:async payload=>deliverSlashPayloads([payload]),onError:(err,info)=>{runtime.error?.(danger(`slack slash ${info.kind} reply failed: ${String(err)}`))}},replyOptions:{skillFilter:channelConfig?.skills,onModelSelected}});counts.final+counts.tool+counts.block===0&&await deliverSlashPayloads([])}catch(err){runtime.error?.(danger(`slack slash handler failed: ${String(err)}`)),await respond({text:`Sorry, something went wrong handling that command.`,response_type:`ephemeral`})}},nativeEnabled=resolveNativeCommandsEnabled({providerId:`slack`,providerSetting:account.config.commands?.native,globalSetting:cfg.commands?.native}),nativeSkillsEnabled=resolveNativeSkillsEnabled({providerId:`slack`,providerSetting:account.config.commands?.nativeSkills,globalSetting:cfg.commands?.nativeSkills}),nativeCommands=[];if(nativeEnabled&&(nativeCommands=listNativeCommandSpecsForConfig(cfg,{skillCommands:nativeSkillsEnabled?listSkillCommandsForAgents({cfg}):[],provider:`slack`})),nativeCommands.length>0)for(let command of nativeCommands)ctx.app.command(`/${command.name}`,async({command:cmd,ack,respond})=>{let commandDefinition=findCommandByNativeName(command.name,`slack`),rawText=cmd.text?.trim()??``,commandArgs=commandDefinition?parseCommandArgs(commandDefinition,rawText):rawText?{raw:rawText}:void 0;await handleSlashCommand({command:cmd,ack,respond,prompt:commandDefinition?buildCommandTextFromArgs(commandDefinition,commandArgs):rawText?`/${command.name} ${rawText}`:`/${command.name}`,commandArgs,commandDefinition:commandDefinition??void 0})});else slashCommand.enabled?ctx.app.command(buildSlackSlashCommandMatcher(slashCommand.name),async({command,ack,respond})=>{await handleSlashCommand({command,ack,respond,prompt:command.text?.trim()??``})}):logVerbose(`slack: slash commands disabled`);nativeCommands.length===0||!supportsInteractiveArgMenus||((()=>{let optionsHandler=ctx.app.options;typeof optionsHandler==`function`&&optionsHandler(SLACK_COMMAND_ARG_ACTION_ID,async({ack,body})=>{let typedBody=body;pruneSlackExternalArgMenuStore();let token=readSlackExternalArgMenuToken(typedBody.actions?.[0]?.block_id??typedBody.block_id);if(!token){await ack({options:[]});return}let entry=slackExternalArgMenuStore.get(token);if(!entry){await ack({options:[]});return}if(typedBody.user?.id&&typedBody.user.id!==entry.userId){await ack({options:[]});return}let query=typedBody.value?.trim().toLowerCase()??``;await ack({options:entry.choices.filter(choice=>!query||choice.label.toLowerCase().includes(query)).slice(0,100).map(choice=>({text:{type:`plain_text`,text:choice.label.slice(0,75)},value:choice.value}))})})})(),(actionId=>{ctx.app.action(actionId,async args=>{let{ack,body,respond}=args,action=args.action;await ack();let respondFn=respond??(async payload=>{!body.channel?.id||!body.user?.id||await ctx.app.client.chat.postEphemeral({token:ctx.botToken,channel:body.channel.id,user:body.user.id,text:payload.text,blocks:payload.blocks})}),parsed=parseSlackCommandArgValue(action?.value??action?.selected_option?.value);if(!parsed){await respondFn({text:`Sorry, that button is no longer valid.`,response_type:`ephemeral`});return}if(body.user?.id&&parsed.userId!==body.user.id){await respondFn({text:`That menu is for another user.`,response_type:`ephemeral`});return}let commandDefinition=findCommandByNativeName(parsed.command,`slack`),commandArgs={values:{[parsed.arg]:parsed.value}},prompt=commandDefinition?buildCommandTextFromArgs(commandDefinition,commandArgs):`/${parsed.command} ${parsed.value}`,user=body.user,userName=user&&`name`in user&&user.name?user.name:user&&`username`in user&&user.username?user.username:user?.id??``,triggerId=`trigger_id`in body?body.trigger_id:void 0;await handleSlashCommand({command:{user_id:user?.id??``,user_name:userName,channel_id:body.channel?.id??``,channel_name:body.channel?.name??body.channel?.id??``,trigger_id:triggerId??String(Date.now())},ack:async()=>{},respond:respondFn,prompt,commandArgs,commandDefinition:commandDefinition??void 0})})})(SLACK_COMMAND_ARG_ACTION_ID))}const slackBoltModule=SlackBolt,{App,HTTPReceiver}=(slackBoltModule.App?slackBoltModule:slackBoltModule.default)??slackBoltModule;function parseApiAppIdFromAppToken(raw){let token=raw?.trim();if(token)return/^xapp-\d-([a-z0-9]+)-/i.exec(token)?.[1]?.toUpperCase()}async function monitorSlackProvider(opts={}){let cfg=opts.config??loadConfig(),account=resolveSlackAccount({cfg,accountId:opts.accountId}),historyLimit=Math.max(0,account.config.historyLimit??cfg.messages?.groupChat?.historyLimit??50),sessionCfg=cfg.session,sessionScope=sessionCfg?.scope??`per-sender`,mainKey=normalizeMainKey(sessionCfg?.mainKey),slackMode=opts.mode??account.config.mode??`socket`,slackWebhookPath=normalizeSlackWebhookPath(account.config.webhookPath),signingSecret=account.config.signingSecret?.trim(),botToken=resolveSlackBotToken(opts.botToken??account.botToken),appToken=resolveSlackAppToken(opts.appToken??account.appToken);if(!botToken||slackMode!==`http`&&!appToken){let missing=slackMode===`http`?`Slack bot token missing for account "${account.accountId}" (set channels.slack.accounts.${account.accountId}.botToken or SLACK_BOT_TOKEN for default).`:`Slack bot + app tokens missing for account "${account.accountId}" (set channels.slack.accounts.${account.accountId}.botToken/appToken or SLACK_BOT_TOKEN/SLACK_APP_TOKEN for default).`;throw Error(missing)}if(slackMode===`http`&&!signingSecret)throw Error(`Slack signing secret missing for account "${account.accountId}" (set channels.slack.signingSecret or channels.slack.accounts.${account.accountId}.signingSecret).`);let runtime=opts.runtime??createNonExitingRuntime(),slackCfg=account.config,dmConfig=slackCfg.dm,dmEnabled=dmConfig?.enabled??!0,dmPolicy=slackCfg.dmPolicy??dmConfig?.policy??`pairing`,allowFrom=slackCfg.allowFrom??dmConfig?.allowFrom,groupDmEnabled=dmConfig?.groupEnabled??!1,groupDmChannels=dmConfig?.groupChannels,channelsConfig=slackCfg.channels,defaultGroupPolicy=cfg.channels?.defaults?.groupPolicy,groupPolicy=slackCfg.groupPolicy??defaultGroupPolicy??`open`;slackCfg.groupPolicy===void 0&&slackCfg.channels===void 0&&defaultGroupPolicy===void 0&&groupPolicy===`open`&&runtime.log?.(warn(`slack: groupPolicy defaults to "open" when channels.slack is missing; set channels.slack.groupPolicy (or channels.defaults.groupPolicy) or add channels.slack.channels to restrict access.`));let resolveToken=slackCfg.userToken?.trim()||botToken,useAccessGroups=cfg.commands?.useAccessGroups!==!1,reactionMode=slackCfg.reactionNotifications??`own`,reactionAllowlist=slackCfg.reactionAllowlist??[],replyToMode=slackCfg.replyToMode??`all`,threadHistoryScope=slackCfg.thread?.historyScope??`thread`,threadInheritParent=slackCfg.thread?.inheritParent??!1,slashCommand=resolveSlackSlashCommandConfig(opts.slashCommand??slackCfg.slashCommand),textLimit=resolveTextChunkLimit(cfg,`slack`,account.accountId),ackReactionScope=cfg.messages?.ackReactionScope??`group-mentions`,mediaMaxBytes=(opts.mediaMaxMb??slackCfg.mediaMaxMb??20)*1024*1024,removeAckAfterReply=cfg.messages?.removeAckAfterReply??!1,receiver=slackMode===`http`?new HTTPReceiver({signingSecret:signingSecret??``,endpoints:slackWebhookPath}):null,clientOptions=resolveSlackWebClientOptions(),app=new App(slackMode===`socket`?{token:botToken,appToken,socketMode:!0,clientOptions}:{token:botToken,receiver:receiver??void 0,clientOptions}),slackHttpHandler=slackMode===`http`&&receiver?async(req,res)=>{let guard=installRequestBodyLimitGuard(req,res,{maxBytes:1048576,timeoutMs:3e4,responseFormat:`text`});if(!guard.isTripped())try{await Promise.resolve(receiver.requestListener(req,res))}catch(err){if(!guard.isTripped())throw err}finally{guard.dispose()}}:null,unregisterHttpHandler=null,botUserId=``,teamId=``,apiAppId=``,expectedApiAppIdFromAppToken=parseApiAppIdFromAppToken(appToken);try{let auth=await app.client.auth.test({token:botToken});botUserId=auth.user_id??``,teamId=auth.team_id??``,apiAppId=auth.api_app_id??``}catch{}apiAppId&&expectedApiAppIdFromAppToken&&apiAppId!==expectedApiAppIdFromAppToken&&runtime.error?.(`slack token mismatch: bot token api_app_id=${apiAppId} but app token looks like api_app_id=${expectedApiAppIdFromAppToken}`);let ctx=createSlackMonitorContext({cfg,accountId:account.accountId,botToken,app,runtime,botUserId,teamId,apiAppId,historyLimit,sessionScope,mainKey,dmEnabled,dmPolicy,allowFrom,groupDmEnabled,groupDmChannels,defaultRequireMention:slackCfg.requireMention,channelsConfig,groupPolicy,useAccessGroups,reactionMode,reactionAllowlist,replyToMode,threadHistoryScope,threadInheritParent,slashCommand,textLimit,ackReactionScope,mediaMaxBytes,removeAckAfterReply});registerSlackMonitorEvents({ctx,account,handleSlackMessage:createSlackMessageHandler({ctx,account})}),await registerSlackMonitorSlashCommands({ctx,account}),slackMode===`http`&&slackHttpHandler&&(unregisterHttpHandler=registerSlackHttpHandler({path:slackWebhookPath,handler:slackHttpHandler,log:runtime.log,accountId:account.accountId})),resolveToken&&(async()=>{if(opts.abortSignal?.aborted)return;if(channelsConfig&&Object.keys(channelsConfig).length>0)try{let entries=Object.keys(channelsConfig).filter(key=>key!==`*`);if(entries.length>0){let resolved=await resolveSlackChannelAllowlist({token:resolveToken,entries}),nextChannels={...channelsConfig},mapping=[],unresolved=[];for(let entry of resolved){let source=channelsConfig?.[entry.input];if(!source)continue;if(!entry.resolved||!entry.id){unresolved.push(entry.input);continue}mapping.push(`${entry.input}→${entry.id}${entry.archived?` (archived)`:``}`);let existing=nextChannels[entry.id]??{};nextChannels[entry.id]={...source,...existing}}channelsConfig=nextChannels,ctx.channelsConfig=nextChannels,summarizeMapping(`slack channels`,mapping,unresolved,runtime)}}catch(err){runtime.log?.(`slack channel resolve failed; using config entries. ${String(err)}`)}let allowEntries=allowFrom?.filter(entry=>String(entry).trim()&&String(entry).trim()!==`*`)??[];if(allowEntries.length>0)try{let{mapping,unresolved,additions}=buildAllowlistResolutionSummary(await resolveSlackUserAllowlist({token:resolveToken,entries:allowEntries.map(entry=>String(entry))}),{formatResolved:entry=>{let note=entry.note?` (${entry.note})`:``;return`${entry.input}→${entry.id}${note}`}});allowFrom=mergeAllowlist({existing:allowFrom,additions}),ctx.allowFrom=normalizeAllowList$2(allowFrom),summarizeMapping(`slack users`,mapping,unresolved,runtime)}catch(err){runtime.log?.(`slack user resolve failed; using config entries. ${String(err)}`)}if(channelsConfig&&Object.keys(channelsConfig).length>0){let userEntries=new Set;for(let channel of Object.values(channelsConfig))addAllowlistUserEntriesFromConfigEntry(userEntries,channel);if(userEntries.size>0)try{let{resolvedMap,mapping,unresolved}=buildAllowlistResolutionSummary(await resolveSlackUserAllowlist({token:resolveToken,entries:Array.from(userEntries)})),nextChannels=patchAllowlistUsersInConfigEntries({entries:channelsConfig,resolvedMap});channelsConfig=nextChannels,ctx.channelsConfig=nextChannels,summarizeMapping(`slack channel users`,mapping,unresolved,runtime)}catch(err){runtime.log?.(`slack channel user resolve failed; using config entries. ${String(err)}`)}}})();let stopOnAbort=()=>{opts.abortSignal?.aborted&&slackMode===`socket`&&app.stop()};opts.abortSignal?.addEventListener(`abort`,stopOnAbort,{once:!0});try{if(slackMode===`socket`?(await app.start(),runtime.log?.(`slack socket mode connected`)):runtime.log?.(`slack http mode listening at ${slackWebhookPath}`),opts.abortSignal?.aborted)return;await new Promise(resolve=>{opts.abortSignal?.addEventListener(`abort`,()=>resolve(),{once:!0})})}finally{opts.abortSignal?.removeEventListener(`abort`,stopOnAbort),unregisterHttpHandler?.(),await app.stop().catch(()=>void 0)}}async function probeSlack(token,timeoutMs=2500){let client=createSlackWebClient(token),start=Date.now();try{let result=await withTimeout(client.auth.test(),timeoutMs);return result.ok?{ok:!0,status:200,elapsedMs:Date.now()-start,bot:{id:result.user_id??void 0,name:result.user??void 0},team:{id:result.team_id??void 0,name:result.team??void 0}}:{ok:!1,status:200,error:result.error??`unknown`,elapsedMs:Date.now()-start}}catch(err){let message=err instanceof Error?err.message:String(err);return{ok:!1,status:typeof err.status==`number`?err.status:null,error:message,elapsedMs:Date.now()-start}}}function collectTelegramUnmentionedGroupIds(groups){if(!groups||typeof groups!=`object`)return{groupIds:[],unresolvedGroups:0,hasWildcardUnmentionedGroups:!1};let hasWildcardUnmentionedGroups=groups[`*`]?.requireMention===!1&&groups[`*`]?.enabled!==!1,groupIds=[],unresolvedGroups=0;for(let[key,value]of Object.entries(groups)){if(key===`*`||!value||typeof value!=`object`||value.enabled===!1||value.requireMention!==!1)continue;let id=String(key).trim();id&&(/^-?\d+$/.test(id)?groupIds.push(id):unresolvedGroups+=1)}return groupIds.sort((a,b)=>a.localeCompare(b)),{groupIds,unresolvedGroups,hasWildcardUnmentionedGroups}}async function auditTelegramGroupMembership(params){let started=Date.now(),token=params.token?.trim()??``;if(!token||params.groupIds.length===0)return{ok:!0,checkedGroups:0,unresolvedGroups:0,hasWildcardUnmentionedGroups:!1,groups:[],elapsedMs:Date.now()-started};let fetcher=params.proxyUrl?makeProxyFetch(params.proxyUrl):fetch,base=`https://api.telegram.org/bot${token}`,groups=[];for(let chatId of params.groupIds)try{let res=await fetchWithTimeout(`${base}/getChatMember?chat_id=${encodeURIComponent(chatId)}&user_id=${encodeURIComponent(String(params.botId))}`,{},params.timeoutMs,fetcher),json=await res.json();if(!res.ok||!isRecord$1(json)||!json.ok){let desc=isRecord$1(json)&&!json.ok&&typeof json.description==`string`?json.description:`getChatMember failed (${res.status})`;groups.push({chatId,ok:!1,status:null,error:desc,matchKey:chatId,matchSource:`id`});continue}let status=isRecord$1(json.result)?json.result.status??null:null,ok=status===`creator`||status===`administrator`||status===`member`;groups.push({chatId,ok,status,error:ok?null:`bot not in group`,matchKey:chatId,matchSource:`id`})}catch(err){groups.push({chatId,ok:!1,status:null,error:err instanceof Error?err.message:String(err),matchKey:chatId,matchSource:`id`})}return{ok:groups.every(g=>g.ok),checkedGroups:groups.length,unresolvedGroups:0,hasWildcardUnmentionedGroups:!1,groups,elapsedMs:Date.now()-started}}function resolveTelegramAllowedUpdates(){let updates=[...API_CONSTANTS.DEFAULT_UPDATE_TYPES];return updates.includes(`message_reaction`)||updates.push(`message_reaction`),updates.includes(`channel_post`)||updates.push(`channel_post`),updates}const resolveTelegramUpdateId=ctx=>ctx.update?.update_id??ctx.update_id,buildTelegramUpdateKey=ctx=>{let updateId=resolveTelegramUpdateId(ctx);if(typeof updateId==`number`)return`update:${updateId}`;let callbackId=ctx.callbackQuery?.id;if(callbackId)return`callback:${callbackId}`;let msg=ctx.message??ctx.channelPost??ctx.editedChannelPost??ctx.update?.message??ctx.update?.edited_message??ctx.update?.channel_post??ctx.update?.edited_channel_post??ctx.callbackQuery?.message,chatId=msg?.chat?.id,messageId=msg?.message_id;if(chatId!==void 0&&typeof messageId==`number`)return`message:${chatId}:${messageId}`},createTelegramUpdateDedupe=()=>createDedupeCache({ttlMs:3e5,maxSize:2e3}),PARSE_ERR_RE=/can't parse entities|parse entities|find end of the entity/i,VOICE_FORBIDDEN_RE=/VOICE_MESSAGES_FORBIDDEN/,FILE_TOO_BIG_RE=/file is too big/i;async function deliverReplies(params){let{replies,chatId,runtime,bot,replyToMode,textLimit,thread,linkPreview,replyQuoteText}=params,chunkMode=params.chunkMode??`length`,hasReplied=!1,hasDelivered=!1,markDelivered=()=>{hasDelivered=!0},chunkText=markdown=>{let markdownChunks=chunkMode===`newline`?chunkMarkdownTextWithMode(markdown,textLimit,chunkMode):[markdown],chunks=[];for(let chunk of markdownChunks){let nested=markdownToTelegramChunks(chunk,textLimit,{tableMode:params.tableMode});if(!nested.length&&chunk){chunks.push({html:wrapFileReferencesInHtml(markdownToTelegramHtml(chunk,{tableMode:params.tableMode,wrapFileRefs:!1})),text:chunk});continue}chunks.push(...nested)}return chunks};for(let reply of replies){let hasMedia=!!reply?.mediaUrl||(reply?.mediaUrls?.length??0)>0;if(!reply?.text&&!hasMedia){if(reply?.audioAsVoice){logVerbose(`telegram reply has audioAsVoice without media/text; skipping`);continue}runtime.error?.(danger(`reply missing text/media`));continue}let replyToId=replyToMode===`off`?void 0:resolveTelegramReplyId(reply.replyToId),replyToMessageIdForPayload=replyToId&&(replyToMode===`all`||!hasReplied)?replyToId:void 0,mediaList=reply.mediaUrls?.length?reply.mediaUrls:reply.mediaUrl?[reply.mediaUrl]:[],telegramData=reply.channelData?.telegram,replyMarkup=buildInlineKeyboard(telegramData?.buttons);if(mediaList.length===0){let chunks=chunkText(reply.text||``),sentTextChunk=!1;for(let i=0;i<chunks.length;i+=1){let chunk=chunks[i];if(!chunk)continue;let shouldAttachButtons=i===0&&replyMarkup;await sendTelegramText(bot,chatId,chunk.html,runtime,{replyToMessageId:replyToMessageIdForPayload,replyQuoteText,thread,textMode:`html`,plainText:chunk.text,linkPreview,replyMarkup:shouldAttachButtons?replyMarkup:void 0}),sentTextChunk=!0,markDelivered()}replyToMessageIdForPayload&&!hasReplied&&sentTextChunk&&(hasReplied=!0);continue}let first=!0,pendingFollowUpText;for(let mediaUrl of mediaList){let isFirstMedia=first,media=await loadWebMedia(mediaUrl,{localRoots:params.mediaLocalRoots}),kind=mediaKindFromMime(media.contentType??void 0),isGif=isGifMedia({contentType:media.contentType,fileName:media.fileName}),fileName=media.fileName??(isGif?`animation.gif`:`file`),file=new InputFile(media.buffer,fileName),{caption,followUpText}=splitTelegramCaption(isFirstMedia?reply.text??void 0:void 0),htmlCaption=caption?renderTelegramHtmlText(caption,{tableMode:params.tableMode}):void 0;followUpText&&(pendingFollowUpText=followUpText),first=!1;let replyToMessageId=replyToMessageIdForPayload,shouldAttachButtonsToMedia=isFirstMedia&&replyMarkup&&!followUpText,mediaParams={caption:htmlCaption,...htmlCaption?{parse_mode:`HTML`}:{},...shouldAttachButtonsToMedia?{reply_markup:replyMarkup}:{},...buildTelegramSendParams({replyToMessageId,thread})};if(isGif)await withTelegramApiErrorLogging({operation:`sendAnimation`,runtime,fn:()=>bot.api.sendAnimation(chatId,file,{...mediaParams})}),markDelivered();else if(kind===`image`)await withTelegramApiErrorLogging({operation:`sendPhoto`,runtime,fn:()=>bot.api.sendPhoto(chatId,file,{...mediaParams})}),markDelivered();else if(kind===`video`)await withTelegramApiErrorLogging({operation:`sendVideo`,runtime,fn:()=>bot.api.sendVideo(chatId,file,{...mediaParams})}),markDelivered();else if(kind===`audio`){let{useVoice}=resolveTelegramVoiceSend({wantsVoice:reply.audioAsVoice===!0,contentType:media.contentType,fileName,logFallback:logVerbose});if(useVoice){await params.onVoiceRecording?.();try{await withTelegramApiErrorLogging({operation:`sendVoice`,runtime,shouldLog:err=>!isVoiceMessagesForbidden(err),fn:()=>bot.api.sendVoice(chatId,file,{...mediaParams})}),markDelivered()}catch(voiceErr){if(isVoiceMessagesForbidden(voiceErr)){let fallbackText=reply.text;if(!fallbackText||!fallbackText.trim())throw voiceErr;logVerbose(`telegram sendVoice forbidden (recipient has voice messages blocked in privacy settings); falling back to text`),await sendTelegramVoiceFallbackText({bot,chatId,runtime,text:fallbackText,chunkText,replyToId:replyToMessageIdForPayload,thread,linkPreview,replyMarkup,replyQuoteText}),replyToMessageIdForPayload&&!hasReplied&&(hasReplied=!0),markDelivered();continue}throw voiceErr}}else await withTelegramApiErrorLogging({operation:`sendAudio`,runtime,fn:()=>bot.api.sendAudio(chatId,file,{...mediaParams})}),markDelivered()}else await withTelegramApiErrorLogging({operation:`sendDocument`,runtime,fn:()=>bot.api.sendDocument(chatId,file,{...mediaParams})}),markDelivered();if(replyToId&&!hasReplied&&(hasReplied=!0),pendingFollowUpText&&isFirstMedia){let chunks=chunkText(pendingFollowUpText);for(let i=0;i<chunks.length;i+=1){let chunk=chunks[i];await sendTelegramText(bot,chatId,chunk.html,runtime,{replyToMessageId:replyToMessageIdForPayload,thread,textMode:`html`,plainText:chunk.text,linkPreview,replyMarkup:i===0?replyMarkup:void 0}),markDelivered()}pendingFollowUpText=void 0}replyToMessageIdForPayload&&!hasReplied&&(hasReplied=!0)}}return{delivered:hasDelivered}}async function resolveMedia(ctx,maxBytes,token,proxyFetch){let msg=ctx.message,downloadAndSaveTelegramFile=async(filePath,fetchImpl)=>{let fetched=await fetchRemoteMedia({url:`https://api.telegram.org/file/bot${token}/${filePath}`,fetchImpl,filePathHint:filePath}),originalName=fetched.fileName??filePath;return saveMediaBuffer(fetched.buffer,fetched.contentType,`inbound`,maxBytes,originalName)};if(msg.sticker){let sticker=msg.sticker;if(sticker.is_animated||sticker.is_video)return logVerbose(`telegram: skipping animated/video sticker (only static stickers supported)`),null;if(!sticker.file_id)return null;try{let file=await ctx.getFile();if(!file.file_path)return logVerbose(`telegram: getFile returned no file_path for sticker`),null;let fetchImpl=proxyFetch??globalThis.fetch;if(!fetchImpl)return logVerbose(`telegram: fetch not available for sticker download`),null;let saved=await downloadAndSaveTelegramFile(file.file_path,fetchImpl),cached=sticker.file_unique_id?await getCachedSticker(sticker.file_unique_id):null;if(cached){logVerbose(`telegram: sticker cache hit for ${sticker.file_unique_id}`);let fileId=sticker.file_id??cached.fileId,emoji=sticker.emoji??cached.emoji,setName=sticker.set_name??cached.setName;return(fileId!==cached.fileId||emoji!==cached.emoji||setName!==cached.setName)&&cacheSticker({...cached,fileId,emoji,setName}),{path:saved.path,contentType:saved.contentType,placeholder:`<media:sticker>`,stickerMetadata:{emoji,setName,fileId,fileUniqueId:sticker.file_unique_id,cachedDescription:cached.description}}}return{path:saved.path,contentType:saved.contentType,placeholder:`<media:sticker>`,stickerMetadata:{emoji:sticker.emoji??void 0,setName:sticker.set_name??void 0,fileId:sticker.file_id,fileUniqueId:sticker.file_unique_id}}}catch(err){return logVerbose(`telegram: failed to process sticker: ${String(err)}`),null}}if(!(msg.photo?.[msg.photo.length-1]??msg.video??msg.video_note??msg.document??msg.audio??msg.voice)?.file_id)return null;let file;try{file=await retryAsync(()=>ctx.getFile(),{attempts:3,minDelayMs:1e3,maxDelayMs:4e3,jitter:.2,label:`telegram:getFile`,shouldRetry:isRetryableGetFileError,onRetry:({attempt,maxAttempts})=>logVerbose(`telegram: getFile retry ${attempt}/${maxAttempts}`)})}catch(err){return isFileTooBigError(err)?(logVerbose(warn(`telegram: getFile failed - file exceeds Telegram Bot API 20MB limit; skipping attachment`)),null):(logVerbose(`telegram: getFile failed after retries: ${String(err)}`),null)}if(!file.file_path)throw Error(`Telegram getFile returned no file_path`);let fetchImpl=proxyFetch??globalThis.fetch;if(!fetchImpl)throw Error(`fetch is not available; set channels.telegram.proxy in config`);let saved=await downloadAndSaveTelegramFile(file.file_path,fetchImpl),placeholder=resolveTelegramMediaPlaceholder(msg)??`<media:document>`;return{path:saved.path,contentType:saved.contentType,placeholder}}function isVoiceMessagesForbidden(err){return err instanceof GrammyError?VOICE_FORBIDDEN_RE.test(err.description):VOICE_FORBIDDEN_RE.test(formatErrorMessage(err))}function isFileTooBigError(err){return err instanceof GrammyError?FILE_TOO_BIG_RE.test(err.description):FILE_TOO_BIG_RE.test(formatErrorMessage(err))}function isRetryableGetFileError(err){return!isFileTooBigError(err)}async function sendTelegramVoiceFallbackText(opts){let chunks=opts.chunkText(opts.text);for(let i=0;i<chunks.length;i+=1){let chunk=chunks[i];await sendTelegramText(opts.bot,opts.chatId,chunk.html,opts.runtime,{replyToMessageId:opts.replyToId,replyQuoteText:opts.replyQuoteText,thread:opts.thread,textMode:`html`,plainText:chunk.text,linkPreview:opts.linkPreview,replyMarkup:i===0?opts.replyMarkup:void 0})}}function buildTelegramSendParams(opts){let threadParams=buildTelegramThreadParams(opts?.thread),params={};return opts?.replyToMessageId&&(params.reply_to_message_id=opts.replyToMessageId),threadParams&&(params.message_thread_id=threadParams.message_thread_id),params}async function sendTelegramText(bot,chatId,text,runtime,opts){let baseParams=buildTelegramSendParams({replyToMessageId:opts?.replyToMessageId,thread:opts?.thread}),linkPreviewOptions=opts?.linkPreview??!0?void 0:{is_disabled:!0},htmlText=(opts?.textMode??`markdown`)===`html`?text:markdownToTelegramHtml(text);try{return(await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,shouldLog:err=>!PARSE_ERR_RE.test(formatErrorMessage(err)),fn:()=>bot.api.sendMessage(chatId,htmlText,{parse_mode:`HTML`,...linkPreviewOptions?{link_preview_options:linkPreviewOptions}:{},...opts?.replyMarkup?{reply_markup:opts.replyMarkup}:{},...baseParams})})).message_id}catch(err){let errText=formatErrorMessage(err);if(PARSE_ERR_RE.test(errText)){runtime.log?.(`telegram HTML parse failed; retrying without formatting: ${errText}`);let fallbackText=opts?.plainText??text;return(await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,fn:()=>bot.api.sendMessage(chatId,fallbackText,{...linkPreviewOptions?{link_preview_options:linkPreviewOptions}:{},...opts?.replyMarkup?{reply_markup:opts.replyMarkup}:{},...baseParams})})).message_id}throw err}}const evaluateTelegramGroupBaseAccess=params=>{if(!params.isGroup)return{allowed:!0};if(params.groupConfig?.enabled===!1)return{allowed:!1,reason:`group-disabled`};if(params.topicConfig?.enabled===!1)return{allowed:!1,reason:`topic-disabled`};if(!params.enforceAllowOverride||!params.hasGroupAllowOverride)return{allowed:!0};let senderId=params.senderId??``;return params.requireSenderForAllowOverride&&!senderId||!isSenderAllowed$1({allow:params.effectiveGroupAllow,senderId,senderUsername:params.senderUsername??``})?{allowed:!1,reason:`group-override-unauthorized`}:{allowed:!0}},evaluateTelegramGroupPolicyAccess=params=>{let fallbackPolicy=firstDefined$2(params.telegramCfg.groupPolicy,params.cfg.channels?.defaults?.groupPolicy,`open`)??`open`,groupPolicy=params.useTopicAndGroupOverrides?firstDefined$2(params.topicConfig?.groupPolicy,params.groupConfig?.groupPolicy,params.telegramCfg.groupPolicy,params.cfg.channels?.defaults?.groupPolicy,`open`)??`open`:fallbackPolicy;if(!params.isGroup||!params.enforcePolicy)return{allowed:!0,groupPolicy};if(groupPolicy===`disabled`)return{allowed:!1,reason:`group-policy-disabled`,groupPolicy};if(groupPolicy===`allowlist`&&params.enforceAllowlistAuthorization){let senderId=params.senderId??``;if(params.requireSenderForAllowlistAuthorization&&!senderId)return{allowed:!1,reason:`group-policy-allowlist-no-sender`,groupPolicy};if(!params.allowEmptyAllowlistEntries&&!params.effectiveGroupAllow.hasEntries)return{allowed:!1,reason:`group-policy-allowlist-empty`,groupPolicy};let senderUsername=params.senderUsername??``;if(!isSenderAllowed$1({allow:params.effectiveGroupAllow,senderId,senderUsername}))return{allowed:!1,reason:`group-policy-allowlist-unauthorized`,groupPolicy}}if(params.checkChatAllowlist){let groupAllowlist=params.resolveGroupPolicy(params.chatId);if(groupAllowlist.allowlistEnabled&&!groupAllowlist.allowed)return{allowed:!1,reason:`group-chat-not-allowed`,groupPolicy}}return{allowed:!0,groupPolicy}};function resolveAccountGroups(cfg,accountId){if(!accountId)return{};let normalized=normalizeAccountId$2(accountId),accounts=cfg.channels?.telegram?.accounts;if(!accounts||typeof accounts!=`object`)return{};let exact=accounts[normalized];if(exact?.groups)return{groups:exact.groups};let matchKey=Object.keys(accounts).find(key=>key.toLowerCase()===normalized.toLowerCase());return{groups:matchKey?accounts[matchKey]?.groups:void 0}}function migrateTelegramGroupsInPlace(groups,oldChatId,newChatId){return!groups||oldChatId===newChatId||!Object.hasOwn(groups,oldChatId)?{migrated:!1,skippedExisting:!1}:Object.hasOwn(groups,newChatId)?{migrated:!1,skippedExisting:!0}:(groups[newChatId]=groups[oldChatId],delete groups[oldChatId],{migrated:!0,skippedExisting:!1})}function migrateTelegramGroupConfig(params){let scopes=[],migrated=!1,skippedExisting=!1,migrationTargets=[{scope:`account`,groups:resolveAccountGroups(params.cfg,params.accountId).groups},{scope:`global`,groups:params.cfg.channels?.telegram?.groups}];for(let target of migrationTargets){let result=migrateTelegramGroupsInPlace(target.groups,params.oldChatId,params.newChatId);result.migrated&&(migrated=!0,scopes.push(target.scope)),result.skippedExisting&&(skippedExisting=!0)}return{migrated,skippedExisting,scopes}}const registerTelegramHandlers=({cfg,accountId,bot,opts,runtime,mediaMaxBytes,telegramCfg,groupAllowFrom,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,processMessage,logger})=>{let TELEGRAM_TEXT_FRAGMENT_MAX_GAP_MS=typeof opts.testTimings?.textFragmentGapMs==`number`&&Number.isFinite(opts.testTimings.textFragmentGapMs)?Math.max(10,Math.floor(opts.testTimings.textFragmentGapMs)):1500,mediaGroupTimeoutMs=typeof opts.testTimings?.mediaGroupFlushMs==`number`&&Number.isFinite(opts.testTimings.mediaGroupFlushMs)?Math.max(10,Math.floor(opts.testTimings.mediaGroupFlushMs)):500,mediaGroupBuffer=new Map,mediaGroupProcessing=Promise.resolve(),textFragmentBuffer=new Map,textFragmentProcessing=Promise.resolve(),debounceMs=resolveInboundDebounceMs({cfg,channel:`telegram`}),buildSyntheticTextMessage=params=>({...params.base,...params.from?{from:params.from}:{},text:params.text,caption:void 0,caption_entities:void 0,entities:void 0,...params.date==null?{}:{date:params.date}}),buildSyntheticContext=(ctx,message)=>{let getFile=typeof ctx.getFile==`function`?ctx.getFile.bind(ctx):async()=>({});return{message,me:ctx.me,getFile}},inboundDebouncer=createInboundDebouncer({debounceMs,buildKey:entry=>entry.debounceKey,shouldDebounce:entry=>{if(entry.allMedia.length>0)return!1;let text=entry.msg.text??entry.msg.caption??``;return text.trim()?!hasControlCommand(text,cfg,{botUsername:entry.botUsername}):!1},onFlush:async entries=>{let last=entries.at(-1);if(!last)return;if(entries.length===1){await processMessage(last.ctx,last.allMedia,last.storeAllowFrom);return}let combinedText=entries.map(entry=>entry.msg.text??entry.msg.caption??``).filter(Boolean).join(`
476
476
  `);if(!combinedText.trim())return;let first=entries[0],baseCtx=first.ctx,syntheticMessage=buildSyntheticTextMessage({base:first.msg,text:combinedText,date:last.msg.date??first.msg.date}),messageIdOverride=last.msg.message_id?String(last.msg.message_id):void 0;await processMessage(buildSyntheticContext(baseCtx,syntheticMessage),[],first.storeAllowFrom,messageIdOverride?{messageIdOverride}:void 0)},onError:err=>{runtime.error?.(danger(`telegram debounce flush failed: ${String(err)}`))}}),resolveTelegramSessionModel=params=>{let resolvedThreadId=params.resolvedThreadId??resolveTelegramForumThreadId({isForum:params.isForum,messageThreadId:params.messageThreadId}),peerId=params.isGroup?buildTelegramGroupPeerId(params.chatId,resolvedThreadId):String(params.chatId),parentPeer=buildTelegramParentPeer({isGroup:params.isGroup,resolvedThreadId,chatId:params.chatId}),route=resolveAgentRoute({cfg,channel:`telegram`,accountId,peer:{kind:params.isGroup?`group`:`direct`,id:peerId},parentPeer}),baseSessionKey=route.sessionKey,dmThreadId=params.isGroup?void 0:params.messageThreadId,sessionKey=(dmThreadId==null?null:resolveThreadSessionKeys({baseSessionKey,threadId:String(dmThreadId)}))?.sessionKey??baseSessionKey,store=loadSessionStore(resolveStorePath(cfg.session?.store,{agentId:route.agentId})),entry=store[sessionKey],storedOverride=resolveStoredModelOverride({sessionEntry:entry,sessionStore:store,sessionKey});if(storedOverride)return storedOverride.provider?`${storedOverride.provider}/${storedOverride.model}`:storedOverride.model;let provider=entry?.modelProvider?.trim(),model=entry?.model?.trim();if(provider&&model)return`${provider}/${model}`;let modelCfg=cfg.agents?.defaults?.model;return typeof modelCfg==`string`?modelCfg:modelCfg?.primary},processMediaGroup=async entry=>{try{entry.messages.sort((a,b)=>a.msg.message_id-b.msg.message_id);let primaryEntry=entry.messages.find(m=>m.msg.caption||m.msg.text)??entry.messages[0],allMedia=[];for(let{ctx}of entry.messages){let media=await resolveMedia(ctx,mediaMaxBytes,opts.token,opts.proxyFetch);media&&allMedia.push({path:media.path,contentType:media.contentType,stickerMetadata:media.stickerMetadata})}let storeAllowFrom=await loadStoreAllowFrom();await processMessage(primaryEntry.ctx,allMedia,storeAllowFrom)}catch(err){runtime.error?.(danger(`media group handler failed: ${String(err)}`))}},flushTextFragments=async entry=>{try{entry.messages.sort((a,b)=>a.msg.message_id-b.msg.message_id);let first=entry.messages[0],last=entry.messages.at(-1);if(!first||!last)return;let combinedText=entry.messages.map(m=>m.msg.text??``).join(``);if(!combinedText.trim())return;let syntheticMessage=buildSyntheticTextMessage({base:first.msg,text:combinedText,date:last.msg.date??first.msg.date}),storeAllowFrom=await loadStoreAllowFrom(),baseCtx=first.ctx;await processMessage(buildSyntheticContext(baseCtx,syntheticMessage),[],storeAllowFrom,{messageIdOverride:String(last.msg.message_id)})}catch(err){runtime.error?.(danger(`text fragment handler failed: ${String(err)}`))}},queueTextFragmentFlush=async entry=>{textFragmentProcessing=textFragmentProcessing.then(async()=>{await flushTextFragments(entry)}).catch(()=>void 0),await textFragmentProcessing},runTextFragmentFlush=async entry=>{textFragmentBuffer.delete(entry.key),await queueTextFragmentFlush(entry)},scheduleTextFragmentFlush=entry=>{clearTimeout(entry.timer),entry.timer=setTimeout(async()=>{await runTextFragmentFlush(entry)},TELEGRAM_TEXT_FRAGMENT_MAX_GAP_MS)},loadStoreAllowFrom=async()=>readChannelAllowFromStore(`telegram`,process.env,accountId).catch(()=>[]),isAllowlistAuthorized=(allow,senderId,senderUsername)=>allow.hasWildcard||allow.hasEntries&&isSenderAllowed$1({allow,senderId,senderUsername}),shouldSkipGroupMessage=params=>{let{isGroup,chatId,chatTitle,resolvedThreadId,senderId,senderUsername,effectiveGroupAllow,hasGroupAllowOverride,groupConfig,topicConfig}=params,baseAccess=evaluateTelegramGroupBaseAccess({isGroup,groupConfig,topicConfig,hasGroupAllowOverride,effectiveGroupAllow,senderId,senderUsername,enforceAllowOverride:!0,requireSenderForAllowOverride:!0});if(!baseAccess.allowed)return baseAccess.reason===`group-disabled`?(logVerbose(`Blocked telegram group ${chatId} (group disabled)`),!0):baseAccess.reason===`topic-disabled`?(logVerbose(`Blocked telegram topic ${chatId} (${resolvedThreadId??`unknown`}) (topic disabled)`),!0):(logVerbose(`Blocked telegram group sender ${senderId||`unknown`} (group allowFrom override)`),!0);if(!isGroup)return!1;let policyAccess=evaluateTelegramGroupPolicyAccess({isGroup,chatId,cfg,telegramCfg,topicConfig,groupConfig,effectiveGroupAllow,senderId,senderUsername,resolveGroupPolicy,enforcePolicy:!0,useTopicAndGroupOverrides:!0,enforceAllowlistAuthorization:!0,allowEmptyAllowlistEntries:!1,requireSenderForAllowlistAuthorization:!0,checkChatAllowlist:!0});return policyAccess.allowed?!1:policyAccess.reason===`group-policy-disabled`?(logVerbose(`Blocked telegram group message (groupPolicy: disabled)`),!0):policyAccess.reason===`group-policy-allowlist-no-sender`?(logVerbose(`Blocked telegram group message (no sender ID, groupPolicy: allowlist)`),!0):policyAccess.reason===`group-policy-allowlist-empty`?(logVerbose(`Blocked telegram group message (groupPolicy: allowlist, no group allowlist entries)`),!0):policyAccess.reason===`group-policy-allowlist-unauthorized`?(logVerbose(`Blocked telegram group message from ${senderId} (groupPolicy: allowlist)`),!0):(logger.info({chatId,title:chatTitle,reason:`not-allowed`},`skipping group message`),!0)};bot.on(`message_reaction`,async ctx=>{try{let reaction=ctx.messageReaction;if(!reaction||shouldSkipUpdate(ctx))return;let chatId=reaction.chat.id,messageId=reaction.message_id,user=reaction.user,reactionMode=telegramCfg.reactionNotifications??`own`;if(reactionMode===`off`||user?.is_bot||reactionMode===`own`&&!wasSentByBot(chatId,messageId))return;let oldEmojis=new Set(reaction.old_reaction.filter(r=>r.type===`emoji`).map(r=>r.emoji)),addedReactions=reaction.new_reaction.filter(r=>r.type===`emoji`).filter(r=>!oldEmojis.has(r.emoji));if(addedReactions.length===0)return;let senderName=user?[user.first_name,user.last_name].filter(Boolean).join(` `).trim()||user.username:void 0,senderUsername=user?.username?`@${user.username}`:void 0,senderLabel=senderName;senderName&&senderUsername?senderLabel=`${senderName} (${senderUsername})`:!senderName&&senderUsername&&(senderLabel=senderUsername),!senderLabel&&user?.id&&(senderLabel=`id:${user.id}`),senderLabel||=`unknown`;let isGroup=reaction.chat.type===`group`||reaction.chat.type===`supergroup`,isForum=reaction.chat.is_forum===!0,resolvedThreadId=isForum?resolveTelegramForumThreadId({isForum,messageThreadId:void 0}):void 0,peerId=isGroup?buildTelegramGroupPeerId(chatId,resolvedThreadId):String(chatId),parentPeer=buildTelegramParentPeer({isGroup,resolvedThreadId,chatId}),sessionKey=resolveAgentRoute({cfg:loadConfig(),channel:`telegram`,accountId,peer:{kind:isGroup?`group`:`direct`,id:peerId},parentPeer}).sessionKey;for(let r of addedReactions){let emoji=r.emoji,text=`Telegram reaction added: ${emoji} by ${senderLabel} on msg ${messageId}`;enqueueSystemEvent(text,{sessionKey,contextKey:`telegram:reaction:add:${chatId}:${messageId}:${user?.id??`anon`}:${emoji}`}),logVerbose(`telegram: reaction event enqueued: ${text}`)}}catch(err){runtime.error?.(danger(`telegram reaction handler failed: ${String(err)}`))}});let processInboundMessage=async params=>{let{ctx,msg,chatId,resolvedThreadId,storeAllowFrom,sendOversizeWarning,oversizeLogMessage}=params,text=typeof msg.text==`string`?msg.text:void 0,isCommandLike=(text??``).trim().startsWith(`/`);if(text&&!isCommandLike){let nowMs=Date.now(),senderId=msg.from?.id==null?`unknown`:String(msg.from.id),key=`text:${chatId}:${resolvedThreadId??`main`}:${senderId}`,existing=textFragmentBuffer.get(key);if(existing){let last=existing.messages.at(-1),lastMsgId=last?.msg.message_id,lastReceivedAtMs=last?.receivedAtMs??nowMs,idGap=typeof lastMsgId==`number`?msg.message_id-lastMsgId:1/0,timeGapMs=nowMs-lastReceivedAtMs;if(idGap>0&&idGap<=1&&timeGapMs>=0&&timeGapMs<=TELEGRAM_TEXT_FRAGMENT_MAX_GAP_MS){let nextTotalChars=existing.messages.reduce((sum,m)=>sum+(m.msg.text?.length??0),0)+text.length;if(existing.messages.length+1<=12&&nextTotalChars<=5e4){existing.messages.push({msg,ctx,receivedAtMs:nowMs}),scheduleTextFragmentFlush(existing);return}}clearTimeout(existing.timer),textFragmentBuffer.delete(key),textFragmentProcessing=textFragmentProcessing.then(async()=>{await flushTextFragments(existing)}).catch(()=>void 0),await textFragmentProcessing}if(text.length>=4e3){let entry={key,messages:[{msg,ctx,receivedAtMs:nowMs}],timer:setTimeout(()=>{},TELEGRAM_TEXT_FRAGMENT_MAX_GAP_MS)};textFragmentBuffer.set(key,entry),scheduleTextFragmentFlush(entry);return}}let mediaGroupId=msg.media_group_id;if(mediaGroupId){let existing=mediaGroupBuffer.get(mediaGroupId);if(existing)clearTimeout(existing.timer),existing.messages.push({msg,ctx}),existing.timer=setTimeout(async()=>{mediaGroupBuffer.delete(mediaGroupId),mediaGroupProcessing=mediaGroupProcessing.then(async()=>{await processMediaGroup(existing)}).catch(()=>void 0),await mediaGroupProcessing},mediaGroupTimeoutMs);else{let entry={messages:[{msg,ctx}],timer:setTimeout(async()=>{mediaGroupBuffer.delete(mediaGroupId),mediaGroupProcessing=mediaGroupProcessing.then(async()=>{await processMediaGroup(entry)}).catch(()=>void 0),await mediaGroupProcessing},mediaGroupTimeoutMs)};mediaGroupBuffer.set(mediaGroupId,entry)}return}let media=null;try{media=await resolveMedia(ctx,mediaMaxBytes,opts.token,opts.proxyFetch)}catch(mediaErr){let errMsg=String(mediaErr);if(errMsg.includes(`exceeds`)&&errMsg.includes(`MB limit`)){if(sendOversizeWarning){let limitMb=Math.round(mediaMaxBytes/(1024*1024));await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,fn:()=>bot.api.sendMessage(chatId,`⚠️ File too large. Maximum size is ${limitMb}MB.`,{reply_to_message_id:msg.message_id})}).catch(()=>{})}logger.warn({chatId,error:errMsg},oversizeLogMessage);return}throw mediaErr}let hasText=!!(msg.text??msg.caption??``).trim();if(msg.sticker&&!media&&!hasText){logVerbose(`telegram: skipping sticker-only message (unsupported sticker type)`);return}let allMedia=media?[{path:media.path,contentType:media.contentType,stickerMetadata:media.stickerMetadata}]:[],senderId=msg.from?.id?String(msg.from.id):``,conversationKey=resolvedThreadId==null?String(chatId):`${chatId}:topic:${resolvedThreadId}`,debounceKey=senderId?`telegram:${accountId??`default`}:${conversationKey}:${senderId}`:null;await inboundDebouncer.enqueue({ctx,msg,allMedia,storeAllowFrom,debounceKey,botUsername:ctx.me?.username})};bot.on(`callback_query`,async ctx=>{let callback=ctx.callbackQuery;if(callback&&!shouldSkipUpdate(ctx)){await withTelegramApiErrorLogging({operation:`answerCallbackQuery`,runtime,fn:typeof ctx.answerCallbackQuery==`function`?()=>ctx.answerCallbackQuery():()=>bot.api.answerCallbackQuery(callback.id)}).catch(()=>{});try{let data=(callback.data??``).trim(),callbackMessage=callback.message;if(!data||!callbackMessage)return;let editCallbackMessage=async(text,params)=>typeof ctx.editMessageText==`function`?await ctx.editMessageText(text,params):await bot.api.editMessageText(callbackMessage.chat.id,callbackMessage.message_id,text,params),deleteCallbackMessage=async()=>typeof ctx.deleteMessage==`function`?await ctx.deleteMessage():await bot.api.deleteMessage(callbackMessage.chat.id,callbackMessage.message_id),replyToCallbackChat=async(text,params)=>typeof ctx.reply==`function`?await ctx.reply(text,params):await bot.api.sendMessage(callbackMessage.chat.id,text,params),inlineButtonsScope=resolveTelegramInlineButtonsScope({cfg,accountId});if(inlineButtonsScope===`off`)return;let chatId=callbackMessage.chat.id,isGroup=callbackMessage.chat.type===`group`||callbackMessage.chat.type===`supergroup`;if(inlineButtonsScope===`dm`&&isGroup||inlineButtonsScope===`group`&&!isGroup)return;let messageThreadId=callbackMessage.message_thread_id,isForum=callbackMessage.chat.is_forum===!0,{resolvedThreadId,storeAllowFrom,groupConfig,topicConfig,effectiveGroupAllow,hasGroupAllowOverride}=await resolveTelegramGroupAllowFromContext({chatId,accountId,isForum,messageThreadId,groupAllowFrom,resolveTelegramGroupConfig}),effectiveDmAllow=normalizeAllowFromWithStore$1({allowFrom:telegramCfg.allowFrom,storeAllowFrom}),dmPolicy=telegramCfg.dmPolicy??`pairing`,senderId=callback.from?.id?String(callback.from.id):``,senderUsername=callback.from?.username??``;if(shouldSkipGroupMessage({isGroup,chatId,chatTitle:callbackMessage.chat.title,resolvedThreadId,senderId,senderUsername,effectiveGroupAllow,hasGroupAllowOverride,groupConfig,topicConfig}))return;if(inlineButtonsScope===`allowlist`){if(!isGroup){if(dmPolicy===`disabled`||dmPolicy!==`open`&&!isAllowlistAuthorized(effectiveDmAllow,senderId,senderUsername))return}else if(!isAllowlistAuthorized(effectiveGroupAllow,senderId,senderUsername))return}let paginationMatch=data.match(/^commands_page_(\d+|noop)(?::(.+))?$/);if(paginationMatch){let pageValue=paginationMatch[1];if(pageValue===`noop`)return;let page=Number.parseInt(pageValue,10);if(Number.isNaN(page)||page<1)return;let agentId=paginationMatch[2]?.trim()||resolveDefaultAgentId(cfg)||void 0,result=buildCommandsMessagePaginated(cfg,listSkillCommandsForAgents({cfg,agentIds:agentId?[agentId]:void 0}),{page,surface:`telegram`}),keyboard=result.totalPages>1?buildInlineKeyboard(buildCommandsPaginationKeyboard(result.currentPage,result.totalPages,agentId)):void 0;try{await editCallbackMessage(result.text,keyboard?{reply_markup:keyboard}:void 0)}catch(editErr){if(!String(editErr).includes(`message is not modified`))throw editErr}return}let modelCallback=parseModelCallbackData(data);if(modelCallback){let{byProvider,providers}=await buildModelsProviderData(cfg),editMessageWithButtons=async(text,buttons)=>{let keyboard=buildInlineKeyboard(buttons);try{await editCallbackMessage(text,keyboard?{reply_markup:keyboard}:void 0)}catch(editErr){let errStr=String(editErr);if(errStr.includes(`no text in the message`)){try{await deleteCallbackMessage()}catch{}await replyToCallbackChat(text,keyboard?{reply_markup:keyboard}:void 0)}else if(!errStr.includes(`message is not modified`))throw editErr}};if(modelCallback.type===`providers`||modelCallback.type===`back`){if(providers.length===0){await editMessageWithButtons(`No providers available.`,[]);return}await editMessageWithButtons(`Select a provider:`,buildProviderKeyboard(providers.map(p=>({id:p,count:byProvider.get(p)?.size??0}))));return}if(modelCallback.type===`list`){let{provider,page}=modelCallback,modelSet=byProvider.get(provider);if(!modelSet||modelSet.size===0){let buttons=buildProviderKeyboard(providers.map(p=>({id:p,count:byProvider.get(p)?.size??0})));await editMessageWithButtons(`Unknown provider: ${provider}\n\nSelect a provider:`,buttons);return}let models=[...modelSet].toSorted(),pageSize=getModelsPageSize(),totalPages=calculateTotalPages(models.length,pageSize),safePage=Math.max(1,Math.min(page,totalPages)),buttons=buildModelsKeyboard({provider,models,currentModel:resolveTelegramSessionModel({chatId,isGroup,isForum,messageThreadId,resolvedThreadId}),currentPage:safePage,totalPages,pageSize});await editMessageWithButtons(`Models (${provider}) — ${models.length} available`,buttons);return}if(modelCallback.type===`select`){let{provider,model}=modelCallback;await processMessage(buildSyntheticContext(ctx,buildSyntheticTextMessage({base:callbackMessage,from:callback.from,text:`/model ${provider}/${model}`})),[],storeAllowFrom,{forceWasMentioned:!0,messageIdOverride:callback.id});return}return}await processMessage(buildSyntheticContext(ctx,buildSyntheticTextMessage({base:callbackMessage,from:callback.from,text:data})),[],storeAllowFrom,{forceWasMentioned:!0,messageIdOverride:callback.id})}catch(err){runtime.error?.(danger(`callback handler failed: ${String(err)}`))}}}),bot.on(`message:migrate_to_chat_id`,async ctx=>{try{let msg=ctx.message;if(!msg?.migrate_to_chat_id||shouldSkipUpdate(ctx))return;let oldChatId=String(msg.chat.id),newChatId=String(msg.migrate_to_chat_id),chatTitle=msg.chat.title??`Unknown`;if(runtime.log?.(warn(`[telegram] Group migrated: "${chatTitle}" ${oldChatId} → ${newChatId}`)),!resolveChannelConfigWrites({cfg,channelId:`telegram`,accountId})){runtime.log?.(warn(`[telegram] Config writes disabled; skipping group config migration.`));return}let currentConfig=loadConfig(),migration=migrateTelegramGroupConfig({cfg:currentConfig,accountId,oldChatId,newChatId});migration.migrated?(runtime.log?.(warn(`[telegram] Migrating group config from ${oldChatId} to ${newChatId}`)),migrateTelegramGroupConfig({cfg,accountId,oldChatId,newChatId}),await writeConfigFile(currentConfig),runtime.log?.(warn(`[telegram] Group config migrated and saved successfully`))):migration.skippedExisting?runtime.log?.(warn(`[telegram] Group config already exists for ${newChatId}; leaving ${oldChatId} unchanged`)):runtime.log?.(warn(`[telegram] No config found for old group ID ${oldChatId}, migration logged only`))}catch(err){runtime.error?.(danger(`[telegram] Group migration handler failed: ${String(err)}`))}});let handleInboundMessageLike=async event=>{try{if(shouldSkipUpdate(event.ctxForDedupe))return;let{resolvedThreadId,storeAllowFrom,groupConfig,topicConfig,effectiveGroupAllow,hasGroupAllowOverride}=await resolveTelegramGroupAllowFromContext({chatId:event.chatId,accountId,isForum:event.isForum,messageThreadId:event.messageThreadId,groupAllowFrom,resolveTelegramGroupConfig});if(event.requireConfiguredGroup&&(!groupConfig||groupConfig.enabled===!1)){logVerbose(`Blocked telegram channel ${event.chatId} (channel disabled)`);return}if(shouldSkipGroupMessage({isGroup:event.isGroup,chatId:event.chatId,chatTitle:event.msg.chat.title,resolvedThreadId,senderId:event.senderId,senderUsername:event.senderUsername,effectiveGroupAllow,hasGroupAllowOverride,groupConfig,topicConfig}))return;await processInboundMessage({ctx:event.ctx,msg:event.msg,chatId:event.chatId,resolvedThreadId,storeAllowFrom,sendOversizeWarning:event.sendOversizeWarning,oversizeLogMessage:event.oversizeLogMessage})}catch(err){runtime.error?.(danger(`${event.errorMessage}: ${String(err)}`))}};bot.on(`message`,async ctx=>{let msg=ctx.message;msg&&await handleInboundMessageLike({ctxForDedupe:ctx,ctx:buildSyntheticContext(ctx,msg),msg,chatId:msg.chat.id,isGroup:msg.chat.type===`group`||msg.chat.type===`supergroup`,isForum:msg.chat.is_forum===!0,messageThreadId:msg.message_thread_id,senderId:msg.from?.id==null?``:String(msg.from.id),senderUsername:msg.from?.username??``,requireConfiguredGroup:!1,sendOversizeWarning:!0,oversizeLogMessage:`media exceeds size limit`,errorMessage:`handler failed`})}),bot.on(`channel_post`,async ctx=>{let post=ctx.channelPost;if(!post)return;let chatId=post.chat.id,syntheticFrom=post.sender_chat?{id:post.sender_chat.id,is_bot:!0,first_name:post.sender_chat.title||`Channel`,username:post.sender_chat.username}:{id:chatId,is_bot:!0,first_name:post.chat.title||`Channel`,username:post.chat.username},syntheticMsg={...post,from:post.from??syntheticFrom,chat:{...post.chat,type:`supergroup`}};await handleInboundMessageLike({ctxForDedupe:ctx,ctx:buildSyntheticContext(ctx,syntheticMsg),msg:syntheticMsg,chatId,isGroup:!0,isForum:!1,senderId:post.sender_chat?.id==null?post.from?.id==null?``:String(post.from.id):String(post.sender_chat.id),senderUsername:post.sender_chat?.username??post.from?.username??``,requireConfiguredGroup:!0,sendOversizeWarning:!1,oversizeLogMessage:`channel post media exceeds size limit`,errorMessage:`channel_post handler failed`})})};async function resolveStickerVisionSupport$1(params){try{let catalog=await loadModelCatalog({config:params.cfg}),defaultModel=resolveDefaultModelForAgent({cfg:params.cfg,agentId:params.agentId}),entry=findModelInCatalog(catalog,defaultModel.provider,defaultModel.model);return entry?modelSupportsVision(entry):!1}catch{return!1}}const buildTelegramMessageContext=async({primaryCtx,allMedia,storeAllowFrom,options,bot,cfg,account,historyLimit,groupHistories,dmPolicy,allowFrom,groupAllowFrom,ackReactionScope,logger,resolveGroupActivation,resolveGroupRequireMention,resolveTelegramGroupConfig})=>{let msg=primaryCtx.message;recordChannelActivity({channel:`telegram`,accountId:account.accountId,direction:`inbound`});let chatId=msg.chat.id,isGroup=msg.chat.type===`group`||msg.chat.type===`supergroup`,messageThreadId=msg.message_thread_id,isForum=msg.chat.is_forum===!0,threadSpec=resolveTelegramThreadSpec({isGroup,isForum,messageThreadId}),resolvedThreadId=threadSpec.scope===`forum`?threadSpec.id:void 0,replyThreadId=threadSpec.id,{groupConfig,topicConfig}=resolveTelegramGroupConfig(chatId,resolvedThreadId),peerId=isGroup?buildTelegramGroupPeerId(chatId,resolvedThreadId):String(chatId),parentPeer=buildTelegramParentPeer({isGroup,resolvedThreadId,chatId}),route=resolveAgentRoute({cfg:loadConfig(),channel:`telegram`,accountId:account.accountId,peer:{kind:isGroup?`group`:`direct`,id:peerId},parentPeer}),baseSessionKey=route.sessionKey,dmThreadId=threadSpec.scope===`dm`?threadSpec.id:void 0,sessionKey=(dmThreadId==null?null:resolveThreadSessionKeys({baseSessionKey,threadId:String(dmThreadId)}))?.sessionKey??baseSessionKey,mentionRegexes=buildMentionRegexes(cfg,route.agentId),effectiveDmAllow=normalizeAllowFromWithStore$1({allowFrom,storeAllowFrom}),groupAllowOverride=firstDefined$2(topicConfig?.allowFrom,groupConfig?.allowFrom),effectiveGroupAllow=normalizeAllowFromWithStore$1({allowFrom:groupAllowOverride??groupAllowFrom,storeAllowFrom}),hasGroupAllowOverride=groupAllowOverride!==void 0,senderId=msg.from?.id?String(msg.from.id):``,senderUsername=msg.from?.username??``,baseAccess=evaluateTelegramGroupBaseAccess({isGroup,groupConfig,topicConfig,hasGroupAllowOverride,effectiveGroupAllow,senderId,senderUsername,enforceAllowOverride:!0,requireSenderForAllowOverride:!1});if(!baseAccess.allowed)return baseAccess.reason===`group-disabled`?(logVerbose(`Blocked telegram group ${chatId} (group disabled)`),null):baseAccess.reason===`topic-disabled`?(logVerbose(`Blocked telegram topic ${chatId} (${resolvedThreadId??`unknown`}) (topic disabled)`),null):(logVerbose(`Blocked telegram group sender ${senderId||`unknown`} (group allowFrom override)`),null);let activationOverride=resolveGroupActivation({chatId,messageThreadId:resolvedThreadId,sessionKey,agentId:route.agentId}),baseRequireMention=resolveGroupRequireMention(chatId),requireMention=firstDefined$2(activationOverride,topicConfig?.requireMention,groupConfig?.requireMention,baseRequireMention),sendTyping=async()=>{await withTelegramApiErrorLogging({operation:`sendChatAction`,fn:()=>bot.api.sendChatAction(chatId,`typing`,buildTypingThreadParams(replyThreadId))})},sendRecordVoice=async()=>{try{await withTelegramApiErrorLogging({operation:`sendChatAction`,fn:()=>bot.api.sendChatAction(chatId,`record_voice`,buildTypingThreadParams(replyThreadId))})}catch(err){logVerbose(`telegram record_voice cue failed for chat ${chatId}: ${String(err)}`)}};if(!isGroup){if(dmPolicy===`disabled`)return null;if(dmPolicy!==`open`){let senderUsername=msg.from?.username??``,senderUserId=msg.from?.id==null?null:String(msg.from.id),candidate=senderUserId??String(chatId),allowMatch=resolveSenderAllowMatch({allow:effectiveDmAllow,senderId:candidate,senderUsername}),allowMatchMeta=`matchKey=${allowMatch.matchKey??`none`} matchSource=${allowMatch.matchSource??`none`}`;if(!(effectiveDmAllow.hasWildcard||effectiveDmAllow.hasEntries&&allowMatch.allowed)){if(dmPolicy===`pairing`)try{let from=msg.from,telegramUserId=from?.id?String(from.id):candidate,{code,created}=await upsertChannelPairingRequest({channel:`telegram`,id:telegramUserId,accountId:account.accountId,meta:{username:from?.username,firstName:from?.first_name,lastName:from?.last_name}});created&&(logger.info({chatId:String(chatId),senderUserId:senderUserId??void 0,username:from?.username,firstName:from?.first_name,lastName:from?.last_name,matchKey:allowMatch.matchKey??`none`,matchSource:allowMatch.matchSource??`none`},`telegram pairing request`),await withTelegramApiErrorLogging({operation:`sendMessage`,fn:()=>bot.api.sendMessage(chatId,buildPairingReply({channel:`telegram`,idLine:`Your Telegram user id: ${telegramUserId}`,code}))}))}catch(err){logVerbose(`telegram pairing reply failed for chat ${chatId}: ${String(err)}`)}else logVerbose(`Blocked unauthorized telegram sender ${candidate} (dmPolicy=${dmPolicy}, ${allowMatchMeta})`);return null}}}let botUsername=primaryCtx.me?.username?.toLowerCase(),allowForCommands=isGroup?effectiveGroupAllow:effectiveDmAllow,senderAllowedForCommands=isSenderAllowed$1({allow:allowForCommands,senderId,senderUsername}),useAccessGroups=cfg.commands?.useAccessGroups!==!1,hasControlCommandInMessage=hasControlCommand(msg.text??msg.caption??``,cfg,{botUsername}),commandGate=resolveControlCommandGate({useAccessGroups,authorizers:[{configured:allowForCommands.hasEntries,allowed:senderAllowedForCommands}],allowTextCommands:!0,hasControlCommand:hasControlCommandInMessage}),commandAuthorized=commandGate.commandAuthorized,historyKey=isGroup?buildTelegramGroupPeerId(chatId,resolvedThreadId):void 0,placeholder=resolveTelegramMediaPlaceholder(msg)??``,cachedStickerDescription=allMedia[0]?.stickerMetadata?.cachedDescription,stickerSupportsVision=msg.sticker?await resolveStickerVisionSupport$1({cfg,agentId:route.agentId}):!1,stickerCacheHit=!!cachedStickerDescription&&!stickerSupportsVision;if(stickerCacheHit){let emoji=allMedia[0]?.stickerMetadata?.emoji,setName=allMedia[0]?.stickerMetadata?.setName,stickerContext=[emoji,setName?`from "${setName}"`:null].filter(Boolean).join(` `);placeholder=`[Sticker${stickerContext?` ${stickerContext}`:``}] ${cachedStickerDescription}`}let locationData=extractTelegramLocation(msg),locationText=locationData?formatLocationText(locationData):void 0,rawText=expandTextLinks(msg.text??msg.caption??``,msg.entities??msg.caption_entities).trim(),hasUserText=!!(rawText||locationText),rawBody=[rawText,locationText].filter(Boolean).join(`
477
477
  `).trim();if(rawBody||=placeholder,!rawBody&&allMedia.length===0)return null;let bodyText=rawBody,hasAudio=allMedia.some(media=>media.contentType?.startsWith(`audio/`)),preflightTranscript;if(isGroup&&requireMention&&hasAudio&&!hasUserText&&mentionRegexes.length>0)try{let{transcribeFirstAudio}=await import(`./audio-preflight-CXboJ77D.js`);preflightTranscript=await transcribeFirstAudio({ctx:{MediaPaths:allMedia.length>0?allMedia.map(m=>m.path):void 0,MediaTypes:allMedia.length>0?allMedia.map(m=>m.contentType).filter(Boolean):void 0},cfg,agentDir:void 0})}catch(err){logVerbose(`telegram: audio preflight transcription failed: ${String(err)}`)}hasAudio&&bodyText===`<media:audio>`&&preflightTranscript&&(bodyText=preflightTranscript),!bodyText&&allMedia.length>0&&(bodyText=hasAudio?preflightTranscript||`<media:audio>`:`<media:image>${allMedia.length>1?` (${allMedia.length} images)`:``}`);let hasAnyMention=(msg.entities??msg.caption_entities??[]).some(ent=>ent.type===`mention`),explicitlyMentioned=botUsername?hasBotMention(msg,botUsername):!1,computedWasMentioned=matchesMentionWithExplicit({text:msg.text??msg.caption??``,mentionRegexes,explicit:{hasAnyMention,isExplicitlyMentioned:explicitlyMentioned,canResolveExplicit:!!botUsername},transcript:preflightTranscript}),wasMentioned=options?.forceWasMentioned===!0?!0:computedWasMentioned;if(isGroup&&commandGate.shouldBlock)return logInboundDrop({log:logVerbose,channel:`telegram`,reason:`control command (unauthorized)`,target:senderId??`unknown`}),null;let botId=primaryCtx.me?.id,replyFromId=msg.reply_to_message?.from?.id,implicitMention=botId!=null&&replyFromId===botId,canDetectMention=!!botUsername||mentionRegexes.length>0,mentionGate=resolveMentionGatingWithBypass({isGroup,requireMention:!!requireMention,canDetectMention,wasMentioned,implicitMention:isGroup&&!!requireMention&&implicitMention,hasAnyMention,allowTextCommands:!0,hasControlCommand:hasControlCommandInMessage,commandAuthorized}),effectiveWasMentioned=mentionGate.effectiveWasMentioned;if(isGroup&&requireMention&&canDetectMention&&mentionGate.shouldSkip)return logger.info({chatId,reason:`no-mention`},`skipping group message`),recordPendingHistoryEntryIfEnabled({historyMap:groupHistories,historyKey:historyKey??``,limit:historyLimit,entry:historyKey?{sender:buildSenderLabel(msg,senderId||chatId),body:rawBody,timestamp:msg.date?msg.date*1e3:void 0,messageId:typeof msg.message_id==`number`?String(msg.message_id):void 0}:null}),null;let ackReaction=resolveAckReaction(cfg,route.agentId,{channel:`telegram`,accountId:account.accountId}),removeAckAfterReply=cfg.messages?.removeAckAfterReply??!1,shouldAckReaction$1=()=>!!(ackReaction&&shouldAckReaction({scope:ackReactionScope,isDirect:!isGroup,isGroup,isMentionableGroup:isGroup,requireMention:!!requireMention,canDetectMention,effectiveWasMentioned,shouldBypassMention:mentionGate.shouldBypassMention})),api=bot.api,reactionApi=typeof api.setMessageReaction==`function`?api.setMessageReaction.bind(api):null,ackReactionPromise=shouldAckReaction$1()&&msg.message_id&&reactionApi?withTelegramApiErrorLogging({operation:`setMessageReaction`,fn:()=>reactionApi(chatId,msg.message_id,[{type:`emoji`,emoji:ackReaction}])}).then(()=>!0,err=>(logVerbose(`telegram react failed for chat ${chatId}: ${String(err)}`),!1)):null,replyTarget=describeReplyTarget(msg),forwardOrigin=normalizeForwardedContext(msg),replySuffix=replyTarget?replyTarget.kind===`quote`?`\n\n[Quoting ${replyTarget.sender}${replyTarget.id?` id:${replyTarget.id}`:``}]\n"${replyTarget.body}"\n[/Quoting]`:`\n\n[Replying to ${replyTarget.sender}${replyTarget.id?` id:${replyTarget.id}`:``}]\n${replyTarget.body}\n[/Replying]`:``,forwardPrefix=forwardOrigin?`[Forwarded from ${forwardOrigin.from}${forwardOrigin.date?` at ${new Date(forwardOrigin.date*1e3).toISOString()}`:``}]\n`:``,groupLabel=isGroup?buildGroupLabel(msg,chatId,resolvedThreadId):void 0,senderName=buildSenderName(msg),conversationLabel=isGroup?groupLabel??`group:${chatId}`:buildSenderLabel(msg,senderId||chatId),storePath=resolveStorePath(cfg.session?.store,{agentId:route.agentId}),envelopeOptions=resolveEnvelopeFormatOptions(cfg),previousTimestamp=readSessionUpdatedAt({storePath,sessionKey}),body=formatInboundEnvelope({channel:`Telegram`,from:conversationLabel,timestamp:msg.date?msg.date*1e3:void 0,body:`${forwardPrefix}${bodyText}${replySuffix}`,chatType:isGroup?`group`:`direct`,sender:{name:senderName,username:senderUsername||void 0,id:senderId||void 0},previousTimestamp,envelope:envelopeOptions}),combinedBody=body;isGroup&&historyKey&&historyLimit>0&&(combinedBody=buildPendingHistoryContextFromMap({historyMap:groupHistories,historyKey,limit:historyLimit,currentMessage:combinedBody,formatEntry:entry=>formatInboundEnvelope({channel:`Telegram`,from:groupLabel??`group:${chatId}`,timestamp:entry.timestamp,body:`${entry.body} [id:${entry.messageId??`unknown`} chat:${chatId}]`,chatType:`group`,senderLabel:entry.sender,envelope:envelopeOptions})}));let skillFilter=firstDefined$2(topicConfig?.skills,groupConfig?.skills),systemPromptParts=[groupConfig?.systemPrompt?.trim()||null,topicConfig?.systemPrompt?.trim()||null].filter(entry=>!!entry),groupSystemPrompt=systemPromptParts.length>0?systemPromptParts.join(`
478
478
 
@@ -493,7 +493,7 @@ Critical rules from AGENTS.md:
493
493
  `)?fenceSplit.reopenFenceLine:`${fenceSplit.reopenFenceLine}\n`}${nextBuffer}`}if(emit(rawChunk),fenceSplit)this.#buffer=nextBuffer;else{let nextStart=breakIdx<this.#buffer.length&&/\s/.test(this.#buffer[breakIdx])?breakIdx+1:breakIdx;this.#buffer=stripLeadingNewlines(this.#buffer.slice(nextStart))}return!0}#pickSoftBreakIndex(buffer,minCharsOverride){let minChars=Math.max(1,Math.floor(minCharsOverride??this.#chunking.minChars));if(buffer.length<minChars)return{index:-1};let fenceSpans=parseFenceSpans(buffer),preference=this.#chunking.breakPreference??`paragraph`;if(preference===`paragraph`){let paragraphIdx=findSafeParagraphBreakIndex({text:buffer,fenceSpans,minChars,reverse:!1});if(paragraphIdx!==-1)return{index:paragraphIdx}}if(preference===`paragraph`||preference===`newline`){let newlineIdx=findSafeNewlineBreakIndex({text:buffer,fenceSpans,minChars,reverse:!1});if(newlineIdx!==-1)return{index:newlineIdx}}if(preference!==`newline`){let sentenceIdx=findSafeSentenceBreakIndex(buffer,fenceSpans,minChars);if(sentenceIdx!==-1)return{index:sentenceIdx}}return{index:-1}}#pickBreakIndex(buffer,minCharsOverride){let minChars=Math.max(1,Math.floor(minCharsOverride??this.#chunking.minChars)),maxChars=Math.max(minChars,Math.floor(this.#chunking.maxChars));if(buffer.length<minChars)return{index:-1};let window=buffer.slice(0,Math.min(maxChars,buffer.length)),fenceSpans=parseFenceSpans(buffer),preference=this.#chunking.breakPreference??`paragraph`;if(preference===`paragraph`){let paragraphIdx=findSafeParagraphBreakIndex({text:window,fenceSpans,minChars,reverse:!0});if(paragraphIdx!==-1)return{index:paragraphIdx}}if(preference===`paragraph`||preference===`newline`){let newlineIdx=findSafeNewlineBreakIndex({text:window,fenceSpans,minChars,reverse:!0});if(newlineIdx!==-1)return{index:newlineIdx}}if(preference!==`newline`){let sentenceIdx=findSafeSentenceBreakIndex(window,fenceSpans,minChars);if(sentenceIdx!==-1)return{index:sentenceIdx}}if(preference===`newline`&&buffer.length<maxChars)return{index:-1};for(let i=window.length-1;i>=minChars;i--)if(/\s/.test(window[i])&&isSafeFenceBreak(fenceSpans,i))return{index:i};if(buffer.length>=maxChars){if(isSafeFenceBreak(fenceSpans,maxChars))return{index:maxChars};let fence=findFenceSpanAt(fenceSpans,maxChars);return fence?{index:maxChars,fenceSplit:{closeFenceLine:`${fence.indent}${fence.marker}`,reopenFenceLine:fence.openLine}}:{index:maxChars}}return{index:-1}}};function stripLeadingNewlines(value){let i=0;for(;i<value.length&&value[i]===`
494
494
  `;)i++;return i>0?value.slice(i):value}function findNextParagraphBreak(buffer,fenceSpans,startIndex=0){if(startIndex<0)return null;let re=/\n[\t ]*\n+/g;re.lastIndex=startIndex;let match;for(;(match=re.exec(buffer))!==null;){let index=match.index??-1;if(!(index<0)&&isSafeFenceBreak(fenceSpans,index))return{index,length:match[0].length}}return null}function resolveTelegramDraftStreamingChunking(cfg,accountId){let providerChunkLimit=getChannelDock(`telegram`)?.outbound?.textChunkLimit,textLimit=resolveTextChunkLimit(cfg,`telegram`,accountId,{fallbackLimit:providerChunkLimit}),normalizedAccountId=normalizeAccountId$2(accountId),draftCfg=cfg?.channels?.telegram?.accounts?.[normalizedAccountId]?.draftChunk??cfg?.channels?.telegram?.draftChunk,maxRequested=Math.max(1,Math.floor(draftCfg?.maxChars??800)),maxChars=Math.max(1,Math.min(maxRequested,textLimit)),minRequested=Math.max(1,Math.floor(draftCfg?.minChars??200));return{minChars:Math.min(minRequested,maxChars),maxChars,breakPreference:draftCfg?.breakPreference===`newline`||draftCfg?.breakPreference===`sentence`?draftCfg.breakPreference:`paragraph`}}const TELEGRAM_STREAM_MAX_CHARS=4096;function createTelegramDraftStream(params){let maxChars=Math.min(params.maxChars??TELEGRAM_STREAM_MAX_CHARS,TELEGRAM_STREAM_MAX_CHARS),throttleMs=Math.max(250,params.throttleMs??1e3),minInitialChars=params.minInitialChars,chatId=params.chatId,threadParams=buildTelegramThreadParams(params.thread),replyParams=params.replyToMessageId==null?threadParams:{...threadParams,reply_to_message_id:params.replyToMessageId},streamMessageId,lastSentText=``,stopped=!1,isFinal=!1,loop=createDraftStreamLoop({throttleMs,isStopped:()=>stopped,sendOrEditStreamMessage:async text=>{if(stopped&&!isFinal)return!1;let trimmed=text.trimEnd();if(!trimmed)return!1;if(trimmed.length>maxChars)return stopped=!0,params.warn?.(`telegram stream preview stopped (text length ${trimmed.length} > ${maxChars})`),!1;if(trimmed===lastSentText)return!0;if(typeof streamMessageId!=`number`&&minInitialChars!=null&&!isFinal&&trimmed.length<minInitialChars)return!1;lastSentText=trimmed;try{if(typeof streamMessageId==`number`)return await params.api.editMessageText(chatId,streamMessageId,trimmed),!0;let sentMessageId=(await params.api.sendMessage(chatId,trimmed,replyParams))?.message_id;return typeof sentMessageId!=`number`||!Number.isFinite(sentMessageId)?(stopped=!0,params.warn?.(`telegram stream preview stopped (missing message id from sendMessage)`),!1):(streamMessageId=Math.trunc(sentMessageId),!0)}catch(err){return stopped=!0,params.warn?.(`telegram stream preview failed: ${err instanceof Error?err.message:String(err)}`),!1}}});return params.log?.(`telegram stream preview ready (maxChars=${maxChars}, throttleMs=${throttleMs})`),{update:text=>{stopped||isFinal||loop.update(text)},flush:loop.flush,messageId:()=>streamMessageId,clear:async()=>{stopped=!0,loop.stop(),await loop.waitForInFlight();let messageId=streamMessageId;if(streamMessageId=void 0,typeof messageId==`number`)try{await params.api.deleteMessage(chatId,messageId)}catch(err){params.warn?.(`telegram stream preview cleanup failed: ${err instanceof Error?err.message:String(err)}`)}},stop:async()=>{isFinal=!0,await loop.flush()},forceNewMessage:()=>{streamMessageId=void 0,lastSentText=``,loop.resetPending()}}}async function resolveStickerVisionSupport(cfg,agentId){try{let catalog=await loadModelCatalog({config:cfg}),defaultModel=resolveDefaultModelForAgent({cfg,agentId}),entry=findModelInCatalog(catalog,defaultModel.provider,defaultModel.model);return entry?modelSupportsVision(entry):!1}catch{return!1}}const dispatchTelegramMessage=async({context,bot,cfg,runtime,replyToMode,streamMode,textLimit,telegramCfg,opts})=>{let{ctxPayload,msg,chatId,isGroup,threadSpec,historyKey,historyLimit,groupHistories,route,skillFilter,sendTyping,sendRecordVoice,ackReactionPromise,reactionApi,removeAckAfterReply}=context,draftMaxChars=Math.min(textLimit,4096),accountBlockStreamingEnabled=typeof telegramCfg.blockStreaming==`boolean`?telegramCfg.blockStreaming:cfg.agents?.defaults?.blockStreamingDefault===`on`,canStreamDraft=streamMode!==`off`&&!accountBlockStreamingEnabled,draftReplyToMessageId=replyToMode!==`off`&&typeof msg.message_id==`number`?msg.message_id:void 0,draftStream=canStreamDraft?createTelegramDraftStream({api:bot.api,chatId,maxChars:draftMaxChars,thread:threadSpec,replyToMessageId:draftReplyToMessageId,minInitialChars:30,log:logVerbose,warn:logVerbose}):void 0,draftChunking=draftStream&&streamMode===`block`?resolveTelegramDraftStreamingChunking(cfg,route.accountId):void 0,shouldSplitPreviewMessages=streamMode===`block`,draftChunker=draftChunking?new EmbeddedBlockChunker(draftChunking):void 0,mediaLocalRoots=getAgentScopedMediaLocalRoots(cfg,route.agentId),lastPartialText=``,draftText=``,hasStreamedMessage=!1,updateDraftFromPartial=text=>{if(!draftStream||!text||text===lastPartialText)return;if(hasStreamedMessage=!0,streamMode===`partial`){if(lastPartialText&&lastPartialText.startsWith(text)&&text.length<lastPartialText.length)return;lastPartialText=text,draftStream.update(text);return}let delta=text;if(text.startsWith(lastPartialText)?delta=text.slice(lastPartialText.length):(draftChunker?.reset(),draftText=``),lastPartialText=text,delta){if(!draftChunker){draftText=text,draftStream.update(draftText);return}draftChunker.append(delta),draftChunker.drain({force:!1,emit:chunk=>{draftText+=chunk,draftStream.update(draftText)}})}},flushDraft=async()=>{draftStream&&(draftChunker?.hasBuffered()&&(draftChunker.drain({force:!0,emit:chunk=>{draftText+=chunk}}),draftChunker.reset(),draftText&&draftStream.update(draftText)),await draftStream.flush())},disableBlockStreaming=typeof telegramCfg.blockStreaming==`boolean`?!telegramCfg.blockStreaming:draftStream||streamMode===`off`?!0:void 0,{onModelSelected,...prefixOptions}=createReplyPrefixOptions({cfg,agentId:route.agentId,channel:`telegram`,accountId:route.accountId}),tableMode=resolveMarkdownTableMode({cfg,channel:`telegram`,accountId:route.accountId}),chunkMode=resolveChunkMode(cfg,`telegram`,route.accountId),sticker=ctxPayload.Sticker;if(sticker?.fileId&&sticker.fileUniqueId&&ctxPayload.MediaPath){let agentDir=resolveAgentDir(cfg,route.agentId),stickerSupportsVision=await resolveStickerVisionSupport(cfg,route.agentId),description=sticker.cachedDescription??null;if(description||=await describeStickerImage({imagePath:ctxPayload.MediaPath,cfg,agentDir,agentId:route.agentId}),description){let stickerContext=[sticker.emoji,sticker.setName?`from "${sticker.setName}"`:null].filter(Boolean).join(` `),formattedDesc=`[Sticker${stickerContext?` ${stickerContext}`:``}] ${description}`;sticker.cachedDescription=description,stickerSupportsVision||(ctxPayload.Body=formattedDesc,ctxPayload.BodyForAgent=formattedDesc,ctxPayload.MediaPath=void 0,ctxPayload.MediaType=void 0,ctxPayload.MediaUrl=void 0,ctxPayload.MediaPaths=void 0,ctxPayload.MediaUrls=void 0,ctxPayload.MediaTypes=void 0),sticker.fileId?(cacheSticker({fileId:sticker.fileId,fileUniqueId:sticker.fileUniqueId,emoji:sticker.emoji,setName:sticker.setName,description,cachedAt:new Date().toISOString(),receivedFrom:ctxPayload.From}),logVerbose(`telegram: cached sticker description for ${sticker.fileUniqueId}`)):logVerbose(`telegram: skipped sticker cache (missing fileId)`)}}let replyQuoteText=ctxPayload.ReplyToIsQuote&&ctxPayload.ReplyToBody&&ctxPayload.ReplyToBody.trim()||void 0,deliveryState={delivered:!1,skippedNonSilent:0},finalizedViaPreviewMessage=!1,clearGroupHistory=()=>{isGroup&&historyKey&&clearHistoryEntriesIfEnabled({historyMap:groupHistories,historyKey,limit:historyLimit})},deliveryBaseOptions={chatId:String(chatId),token:opts.token,runtime,bot,mediaLocalRoots,replyToMode,textLimit,thread:threadSpec,tableMode,chunkMode,linkPreview:telegramCfg.linkPreview,replyQuoteText},queuedFinal=!1;try{({queuedFinal}=await dispatchReplyWithBufferedBlockDispatcher({ctx:ctxPayload,cfg,dispatcherOptions:{...prefixOptions,deliver:async(payload,info)=>{if(info.kind===`final`){await flushDraft();let hasMedia=!!payload.mediaUrl||(payload.mediaUrls?.length??0)>0,previewMessageId=draftStream?.messageId(),finalText=payload.text,currentPreviewText=streamMode===`block`?draftText:lastPartialText,previewButtons=payload.channelData?.telegram?.buttons,draftStoppedForPreviewEdit=!1;if(!finalizedViaPreviewMessage&&!hasMedia&&typeof finalText==`string`&&finalText.length>0&&typeof previewMessageId==`number`&&finalText.length<=draftMaxChars&&!payload.isError){if(await draftStream?.stop(),draftStoppedForPreviewEdit=!0,currentPreviewText&&currentPreviewText.startsWith(finalText)&&finalText.length<currentPreviewText.length)return;try{await editMessageTelegram(chatId,previewMessageId,finalText,{api:bot.api,cfg,accountId:route.accountId,linkPreview:telegramCfg.linkPreview,buttons:previewButtons}),finalizedViaPreviewMessage=!0,deliveryState.delivered=!0;return}catch(err){logVerbose(`telegram: preview final edit failed; falling back to standard send (${String(err)})`)}}!hasMedia&&!payload.isError&&typeof finalText==`string`&&finalText.length>draftMaxChars&&logVerbose(`telegram: preview final too long for edit (${finalText.length} > ${draftMaxChars}); falling back to standard send`),draftStoppedForPreviewEdit||await draftStream?.stop();let messageIdAfterStop=draftStream?.messageId();if(!finalizedViaPreviewMessage&&typeof messageIdAfterStop==`number`&&typeof finalText==`string`&&finalText.length>0&&finalText.length<=draftMaxChars&&!hasMedia&&!payload.isError)try{await editMessageTelegram(chatId,messageIdAfterStop,finalText,{api:bot.api,cfg,accountId:route.accountId,linkPreview:telegramCfg.linkPreview,buttons:previewButtons}),finalizedViaPreviewMessage=!0,deliveryState.delivered=!0;return}catch(err){logVerbose(`telegram: post-stop preview edit failed; falling back to standard send (${String(err)})`)}}(await deliverReplies({...deliveryBaseOptions,replies:[payload],onVoiceRecording:sendRecordVoice})).delivered&&(deliveryState.delivered=!0)},onSkip:(_payload,info)=>{info.reason!==`silent`&&(deliveryState.skippedNonSilent+=1)},onError:(err,info)=>{runtime.error?.(danger(`telegram ${info.kind} reply failed: ${String(err)}`))},onReplyStart:createTypingCallbacks({start:sendTyping,onStartError:err=>{logTypingFailure({log:logVerbose,channel:`telegram`,target:String(chatId),error:err})}}).onReplyStart},replyOptions:{skillFilter,disableBlockStreaming,onPartialReply:draftStream?payload=>updateDraftFromPartial(payload.text):void 0,onAssistantMessageStart:draftStream?()=>{logVerbose(`telegram: onAssistantMessageStart called, hasStreamedMessage=${hasStreamedMessage}`),shouldSplitPreviewMessages&&hasStreamedMessage&&(logVerbose(`telegram: calling forceNewMessage()`),draftStream.forceNewMessage()),lastPartialText=``,draftText=``,draftChunker?.reset()}:void 0,onReasoningEnd:draftStream?()=>{shouldSplitPreviewMessages&&hasStreamedMessage&&draftStream.forceNewMessage(),lastPartialText=``,draftText=``,draftChunker?.reset()}:void 0,onModelSelected}}))}finally{await draftStream?.stop(),finalizedViaPreviewMessage||await draftStream?.clear()}let sentFallback=!1;if(!deliveryState.delivered&&deliveryState.skippedNonSilent>0&&(sentFallback=(await deliverReplies({replies:[{text:`No response generated. Please try again.`}],...deliveryBaseOptions})).delivered),!(queuedFinal||sentFallback)){clearGroupHistory();return}removeAckReactionAfterReply({removeAfterReply:removeAckAfterReply,ackReactionPromise,ackReactionValue:ackReactionPromise?`ack`:null,remove:()=>reactionApi?.(chatId,msg.message_id??0,[])??Promise.resolve(),onError:err=>{msg.message_id&&logAckFailure({log:logVerbose,channel:`telegram`,target:`${chatId}/${msg.message_id}`,error:err})}}),clearGroupHistory()},createTelegramMessageProcessor=deps=>{let{bot,cfg,account,telegramCfg,historyLimit,groupHistories,dmPolicy,allowFrom,groupAllowFrom,ackReactionScope,logger,resolveGroupActivation,resolveGroupRequireMention,resolveTelegramGroupConfig,runtime,replyToMode,streamMode,textLimit,opts}=deps;return async(primaryCtx,allMedia,storeAllowFrom,options)=>{let context=await buildTelegramMessageContext({primaryCtx,allMedia,storeAllowFrom,options,bot,cfg,account,historyLimit,groupHistories,dmPolicy,allowFrom,groupAllowFrom,ackReactionScope,logger,resolveGroupActivation,resolveGroupRequireMention,resolveTelegramGroupConfig});context&&await dispatchTelegramMessage({context,bot,cfg,runtime,replyToMode,streamMode,textLimit,telegramCfg,opts})}};function buildPluginTelegramMenuCommands(params){let{specs,existingCommands}=params,commands=[],issues=[],pluginCommandNames=new Set;for(let spec of specs){let normalized=normalizeTelegramCommandName(spec.name);if(!normalized||!TELEGRAM_COMMAND_NAME_PATTERN.test(normalized)){issues.push(`Plugin command "/${spec.name}" is invalid for Telegram (use a-z, 0-9, underscore; max 32 chars).`);continue}let description=spec.description.trim();if(!description){issues.push(`Plugin command "/${normalized}" is missing a description.`);continue}if(existingCommands.has(normalized)){pluginCommandNames.has(normalized)?issues.push(`Plugin command "/${normalized}" is duplicated.`):issues.push(`Plugin command "/${normalized}" conflicts with an existing Telegram command.`);continue}pluginCommandNames.add(normalized),existingCommands.add(normalized),commands.push({command:normalized,description})}return{commands,issues}}function buildCappedTelegramMenuCommands(params){let{allCommands}=params,maxCommands=params.maxCommands??100,totalCommands=allCommands.length,overflowCount=Math.max(0,totalCommands-maxCommands);return{commandsToRegister:allCommands.slice(0,maxCommands),totalCommands,maxCommands,overflowCount}}function syncTelegramMenuCommands(params){let{bot,runtime,commandsToRegister}=params;(async()=>{typeof bot.api.deleteMyCommands==`function`&&await withTelegramApiErrorLogging({operation:`deleteMyCommands`,runtime,fn:()=>bot.api.deleteMyCommands()}).catch(()=>{}),commandsToRegister.length!==0&&await withTelegramApiErrorLogging({operation:`setMyCommands`,runtime,fn:()=>bot.api.setMyCommands(commandsToRegister)})})().catch(err=>{runtime.error?.(`Telegram command sync failed: ${String(err)}`)})}async function resolveTelegramCommandAuth(params){let{msg,bot,cfg,accountId,telegramCfg,allowFrom,groupAllowFrom,useAccessGroups,resolveGroupPolicy,resolveTelegramGroupConfig,requireAuth}=params,chatId=msg.chat.id,isGroup=msg.chat.type===`group`||msg.chat.type===`supergroup`,messageThreadId=msg.message_thread_id,isForum=msg.chat.is_forum===!0,{resolvedThreadId,storeAllowFrom,groupConfig,topicConfig,effectiveGroupAllow,hasGroupAllowOverride}=await resolveTelegramGroupAllowFromContext({chatId,accountId,isForum,messageThreadId,groupAllowFrom,resolveTelegramGroupConfig}),senderId=msg.from?.id?String(msg.from.id):``,senderUsername=msg.from?.username??``,sendAuthMessage=async text=>(await withTelegramApiErrorLogging({operation:`sendMessage`,fn:()=>bot.api.sendMessage(chatId,text)}),null),rejectNotAuthorized=async()=>await sendAuthMessage(`You are not authorized to use this command.`),baseAccess=evaluateTelegramGroupBaseAccess({isGroup,groupConfig,topicConfig,hasGroupAllowOverride,effectiveGroupAllow,senderId,senderUsername,enforceAllowOverride:requireAuth,requireSenderForAllowOverride:!0});if(!baseAccess.allowed)return baseAccess.reason===`group-disabled`?await sendAuthMessage(`This group is disabled.`):baseAccess.reason===`topic-disabled`?await sendAuthMessage(`This topic is disabled.`):await rejectNotAuthorized();let policyAccess=evaluateTelegramGroupPolicyAccess({isGroup,chatId,cfg,telegramCfg,topicConfig,groupConfig,effectiveGroupAllow,senderId,senderUsername,resolveGroupPolicy,enforcePolicy:useAccessGroups,useTopicAndGroupOverrides:!1,enforceAllowlistAuthorization:requireAuth,allowEmptyAllowlistEntries:!0,requireSenderForAllowlistAuthorization:!0,checkChatAllowlist:useAccessGroups});if(!policyAccess.allowed){if(policyAccess.reason===`group-policy-disabled`)return await sendAuthMessage(`Telegram group commands are disabled.`);if(policyAccess.reason===`group-policy-allowlist-no-sender`||policyAccess.reason===`group-policy-allowlist-unauthorized`)return await rejectNotAuthorized();if(policyAccess.reason===`group-chat-not-allowed`)return await sendAuthMessage(`This group is not allowed.`)}let dmAllow=normalizeAllowFromWithStore$1({allowFrom,storeAllowFrom}),senderAllowed=isSenderAllowed$1({allow:dmAllow,senderId,senderUsername}),commandAuthorized=resolveCommandAuthorizedFromAuthorizers({useAccessGroups,authorizers:[{configured:dmAllow.hasEntries,allowed:senderAllowed}],modeWhenAccessGroupsOff:`configured`});return requireAuth&&!commandAuthorized?await rejectNotAuthorized():{chatId,isGroup,isForum,resolvedThreadId,senderId,senderUsername,groupConfig,topicConfig,commandAuthorized}}const registerTelegramNativeCommands=({bot,cfg,runtime,accountId,telegramCfg,allowFrom,groupAllowFrom,replyToMode,textLimit,useAccessGroups,nativeEnabled,nativeSkillsEnabled,nativeDisabledExplicit,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,opts})=>{let boundRoute=nativeEnabled&&nativeSkillsEnabled?resolveAgentRoute({cfg,channel:`telegram`,accountId}):null,boundAgentIds=boundRoute?[boundRoute.agentId]:null,skillCommands=nativeEnabled&&nativeSkillsEnabled?listSkillCommandsForAgents(boundAgentIds?{cfg,agentIds:boundAgentIds}:{cfg}):[],nativeCommands=nativeEnabled?listNativeCommandSpecsForConfig(cfg,{skillCommands,provider:`telegram`}):[],reservedCommands=new Set(listNativeCommandSpecs().map(command=>normalizeTelegramCommandName(command.name)));for(let command of skillCommands)reservedCommands.add(command.name.toLowerCase());let customResolution=resolveTelegramCustomCommands({commands:telegramCfg.customCommands,reservedCommands});for(let issue of customResolution.issues)runtime.error?.(danger(issue.message));let customCommands=customResolution.commands,pluginCatalog=buildPluginTelegramMenuCommands({specs:getPluginCommandSpecs(),existingCommands:new Set([...nativeCommands.map(command=>normalizeTelegramCommandName(command.name)),...customCommands.map(command=>command.command)].map(command=>command.toLowerCase()))});for(let issue of pluginCatalog.issues)runtime.error?.(danger(issue));let{commandsToRegister,totalCommands,maxCommands,overflowCount}=buildCappedTelegramMenuCommands({allCommands:[...nativeCommands.map(command=>{let normalized=normalizeTelegramCommandName(command.name);return TELEGRAM_COMMAND_NAME_PATTERN.test(normalized)?{command:normalized,description:command.description}:(runtime.error?.(danger(`Native command "${command.name}" is invalid for Telegram (resolved to "${normalized}"). Skipping.`)),null)}).filter(cmd=>cmd!==null),...nativeEnabled?pluginCatalog.commands:[],...customCommands]});overflowCount>0&&runtime.log?.(`Telegram limits bots to ${maxCommands} commands. ${totalCommands} configured; registering first ${maxCommands}. Use channels.telegram.commands.native: false to disable, or reduce plugin/skill/custom commands.`),syncTelegramMenuCommands({bot,runtime,commandsToRegister});let resolveCommandRuntimeContext=params=>{let{msg,isGroup,isForum,resolvedThreadId}=params,chatId=msg.chat.id,messageThreadId=msg.message_thread_id,threadSpec=resolveTelegramThreadSpec({isGroup,isForum,messageThreadId}),parentPeer=buildTelegramParentPeer({isGroup,resolvedThreadId,chatId}),route=resolveAgentRoute({cfg,channel:`telegram`,accountId,peer:{kind:isGroup?`group`:`direct`,id:isGroup?buildTelegramGroupPeerId(chatId,resolvedThreadId):String(chatId)},parentPeer});return{chatId,threadSpec,route,mediaLocalRoots:getAgentScopedMediaLocalRoots(cfg,route.agentId),tableMode:resolveMarkdownTableMode({cfg,channel:`telegram`,accountId:route.accountId}),chunkMode:resolveChunkMode(cfg,`telegram`,route.accountId)}},buildCommandDeliveryBaseOptions=params=>({chatId:String(params.chatId),token:opts.token,runtime,bot,mediaLocalRoots:params.mediaLocalRoots,replyToMode,textLimit,thread:params.threadSpec,tableMode:params.tableMode,chunkMode:params.chunkMode,linkPreview:telegramCfg.linkPreview});if(commandsToRegister.length>0||pluginCatalog.commands.length>0)if(typeof bot.command!=`function`)logVerbose(`telegram: bot.command unavailable; skipping native handlers`);else{for(let command of nativeCommands){let normalizedCommandName=normalizeTelegramCommandName(command.name);bot.command(normalizedCommandName,async ctx=>{let msg=ctx.message;if(!msg||shouldSkipUpdate(ctx))return;let auth=await resolveTelegramCommandAuth({msg,bot,cfg,accountId,telegramCfg,allowFrom,groupAllowFrom,useAccessGroups,resolveGroupPolicy,resolveTelegramGroupConfig,requireAuth:!0});if(!auth)return;let{chatId,isGroup,isForum,resolvedThreadId,senderId,senderUsername,groupConfig,topicConfig,commandAuthorized}=auth,{threadSpec,route,mediaLocalRoots,tableMode,chunkMode}=resolveCommandRuntimeContext({msg,isGroup,isForum,resolvedThreadId}),deliveryBaseOptions=buildCommandDeliveryBaseOptions({chatId,mediaLocalRoots,threadSpec,tableMode,chunkMode}),threadParams=buildTelegramThreadParams(threadSpec)??{},commandDefinition=findCommandByNativeName(command.name,`telegram`),rawText=ctx.match?.trim()??``,commandArgs=commandDefinition?parseCommandArgs(commandDefinition,rawText):rawText?{raw:rawText}:void 0,prompt=commandDefinition?buildCommandTextFromArgs(commandDefinition,commandArgs):rawText?`/${command.name} ${rawText}`:`/${command.name}`,menu=commandDefinition?resolveCommandArgMenu({command:commandDefinition,args:commandArgs,cfg}):null;if(menu&&commandDefinition){let title=menu.title??`Choose ${menu.arg.description||menu.arg.name} for /${commandDefinition.nativeName??commandDefinition.key}.`,rows=[];for(let i=0;i<menu.choices.length;i+=2){let slice=menu.choices.slice(i,i+2);rows.push(slice.map(choice=>{let args={values:{[menu.arg.name]:choice.value}};return{text:choice.label,callback_data:buildCommandTextFromArgs(commandDefinition,args)}}))}let replyMarkup=buildInlineKeyboard(rows);await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,fn:()=>bot.api.sendMessage(chatId,title,{...replyMarkup?{reply_markup:replyMarkup}:{},...threadParams})});return}let baseSessionKey=route.sessionKey,dmThreadId=threadSpec.scope===`dm`?threadSpec.id:void 0,sessionKey=(dmThreadId==null?null:resolveThreadSessionKeys({baseSessionKey,threadId:String(dmThreadId)}))?.sessionKey??baseSessionKey,skillFilter=firstDefined$2(topicConfig?.skills,groupConfig?.skills),systemPromptParts=[groupConfig?.systemPrompt?.trim()||null,topicConfig?.systemPrompt?.trim()||null].filter(entry=>!!entry),groupSystemPrompt=systemPromptParts.length>0?systemPromptParts.join(`
495
495
 
496
- `):void 0,conversationLabel=isGroup?msg.chat.title?`${msg.chat.title} id:${chatId}`:`group:${chatId}`:buildSenderName(msg)??String(senderId||chatId),ctxPayload=finalizeInboundContext({Body:prompt,BodyForAgent:prompt,RawBody:prompt,CommandBody:prompt,CommandArgs:commandArgs,From:isGroup?buildTelegramGroupFrom(chatId,resolvedThreadId):`telegram:${chatId}`,To:`slash:${senderId||chatId}`,ChatType:isGroup?`group`:`direct`,ConversationLabel:conversationLabel,GroupSubject:isGroup?msg.chat.title??void 0:void 0,GroupSystemPrompt:isGroup?groupSystemPrompt:void 0,SenderName:buildSenderName(msg),SenderId:senderId||void 0,SenderUsername:senderUsername||void 0,Surface:`telegram`,MessageSid:String(msg.message_id),Timestamp:msg.date?msg.date*1e3:void 0,WasMentioned:!0,CommandAuthorized:commandAuthorized,CommandSource:`native`,SessionKey:`telegram:slash:${senderId||chatId}`,AccountId:route.accountId,CommandTargetSessionKey:sessionKey,MessageThreadId:threadSpec.id,IsForum:isForum,OriginatingChannel:`telegram`,OriginatingTo:`telegram:${chatId}`}),disableBlockStreaming=typeof telegramCfg.blockStreaming==`boolean`?!telegramCfg.blockStreaming:void 0,deliveryState={delivered:!1,skippedNonSilent:0},{onModelSelected,...prefixOptions}=createReplyPrefixOptions({cfg,agentId:route.agentId,channel:`telegram`,accountId:route.accountId});await dispatchReplyWithBufferedBlockDispatcher({ctx:ctxPayload,cfg,dispatcherOptions:{...prefixOptions,deliver:async(payload,_info)=>{(await deliverReplies({replies:[payload],...deliveryBaseOptions})).delivered&&(deliveryState.delivered=!0)},onSkip:(_payload,info)=>{info.reason!==`silent`&&(deliveryState.skippedNonSilent+=1)},onError:(err,info)=>{runtime.error?.(danger(`telegram slash ${info.kind} reply failed: ${String(err)}`))}},replyOptions:{skillFilter,disableBlockStreaming,onModelSelected}}),!deliveryState.delivered&&deliveryState.skippedNonSilent>0&&await deliverReplies({replies:[{text:`No response generated. Please try again.`}],...deliveryBaseOptions})})}for(let pluginCommand of pluginCatalog.commands)bot.command(pluginCommand.command,async ctx=>{let msg=ctx.message;if(!msg||shouldSkipUpdate(ctx))return;let chatId=msg.chat.id,rawText=ctx.match?.trim()??``,commandBody=`/${pluginCommand.command}${rawText?` ${rawText}`:``}`,match=matchPluginCommand(commandBody);if(!match){await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,fn:()=>bot.api.sendMessage(chatId,`Command not found.`)});return}let auth=await resolveTelegramCommandAuth({msg,bot,cfg,accountId,telegramCfg,allowFrom,groupAllowFrom,useAccessGroups,resolveGroupPolicy,resolveTelegramGroupConfig,requireAuth:match.command.requireAuth!==!1});if(!auth)return;let{senderId,commandAuthorized,isGroup,isForum,resolvedThreadId}=auth,{threadSpec,mediaLocalRoots,tableMode,chunkMode}=resolveCommandRuntimeContext({msg,isGroup,isForum,resolvedThreadId}),deliveryBaseOptions=buildCommandDeliveryBaseOptions({chatId,mediaLocalRoots,threadSpec,tableMode,chunkMode}),from=isGroup?buildTelegramGroupFrom(chatId,threadSpec.id):`telegram:${chatId}`,to=`telegram:${chatId}`;await deliverReplies({replies:[await executePluginCommand({command:match.command,args:match.args,senderId,channel:`telegram`,isAuthorizedSender:commandAuthorized,commandBody,config:cfg,from,to,accountId,messageThreadId:threadSpec.id})],...deliveryBaseOptions})})}else nativeDisabledExplicit&&withTelegramApiErrorLogging({operation:`setMyCommands`,runtime,fn:()=>bot.api.setMyCommands([])}).catch(()=>{})};function getTelegramSequentialKey(ctx){let reaction=ctx.update?.message_reaction;if(reaction?.chat?.id)return`telegram:${reaction.chat.id}`;let msg=ctx.message??ctx.channelPost??ctx.editedChannelPost??ctx.update?.message??ctx.update?.edited_message??ctx.update?.channel_post??ctx.update?.edited_channel_post??ctx.update?.callback_query?.message,chatId=msg?.chat?.id??ctx.chat?.id,rawText=msg?.text??msg?.caption,botUsername=ctx.me?.username;if(isAbortRequestText(rawText,botUsername?{botUsername}:void 0))return typeof chatId==`number`?`telegram:${chatId}:control`:`telegram:control`;let isGroup=msg?.chat?.type===`group`||msg?.chat?.type===`supergroup`,messageThreadId=msg?.message_thread_id,isForum=msg?.chat?.is_forum,threadId=isGroup?resolveTelegramForumThreadId({isForum,messageThreadId}):messageThreadId;return typeof chatId==`number`?threadId==null?`telegram:${chatId}`:`telegram:${chatId}:topic:${threadId}`:`telegram:unknown`}function createTelegramBot(opts){let runtime=opts.runtime??{log:console.log,error:console.error,exit:code=>{throw Error(`exit ${code}`)}},cfg=opts.config??loadConfig(),account=resolveTelegramAccount({cfg,accountId:opts.accountId}),telegramCfg=account.config,fetchImpl=resolveTelegramFetch(opts.proxyFetch,{network:telegramCfg.network}),shouldProvideFetch=!!fetchImpl,fetchForClient=fetchImpl,timeoutSeconds=typeof telegramCfg?.timeoutSeconds==`number`&&Number.isFinite(telegramCfg.timeoutSeconds)?Math.max(1,Math.floor(telegramCfg.timeoutSeconds)):void 0,client=shouldProvideFetch||timeoutSeconds?{...shouldProvideFetch&&fetchImpl?{fetch:fetchForClient}:{},...timeoutSeconds?{timeoutSeconds}:{}}:void 0,bot=new Bot(opts.token,client?{client}:void 0);bot.api.config.use(apiThrottler()),bot.use(sequentialize(getTelegramSequentialKey)),bot.catch(err=>{runtime.error?.(danger(`telegram bot error: ${formatUncaughtError(err)}`))});let recentUpdates=createTelegramUpdateDedupe(),lastUpdateId=typeof opts.updateOffset?.lastUpdateId==`number`?opts.updateOffset.lastUpdateId:null,recordUpdateId=ctx=>{let updateId=resolveTelegramUpdateId(ctx);typeof updateId==`number`&&(lastUpdateId!==null&&updateId<=lastUpdateId||(lastUpdateId=updateId,opts.updateOffset?.onUpdateId?.(updateId)))},shouldSkipUpdate=ctx=>{let updateId=resolveTelegramUpdateId(ctx);if(typeof updateId==`number`&&lastUpdateId!==null&&updateId<=lastUpdateId)return!0;let key=buildTelegramUpdateKey(ctx),skipped=recentUpdates.check(key);return skipped&&key&&shouldLogVerbose()&&logVerbose(`telegram dedupe: skipped ${key}`),skipped},rawUpdateLogger=createSubsystemLogger(`gateway/channels/telegram/raw-update`),MAX_RAW_UPDATE_CHARS=8e3,stringifyUpdate=update=>{let seen=new WeakSet;return JSON.stringify(update??null,(key,value)=>{if(typeof value==`string`&&value.length>500)return`${value.slice(0,500)}...`;if(Array.isArray(value)&&value.length>20)return[...value.slice(0,20),`...(${value.length-20} more)`];if(value&&typeof value==`object`){if(seen.has(value))return`[Circular]`;seen.add(value)}return value})};bot.use(async(ctx,next)=>{if(shouldLogVerbose())try{let raw=stringifyUpdate(ctx.update),preview=raw.length>MAX_RAW_UPDATE_CHARS?`${raw.slice(0,MAX_RAW_UPDATE_CHARS)}...`:raw;rawUpdateLogger.debug(`telegram update: ${preview}`)}catch(err){rawUpdateLogger.debug(`telegram update log failed: ${String(err)}`)}await next(),recordUpdateId(ctx)});let historyLimit=Math.max(0,telegramCfg.historyLimit??cfg.messages?.groupChat?.historyLimit??50),groupHistories=new Map,textLimit=resolveTextChunkLimit(cfg,`telegram`,account.accountId),dmPolicy=telegramCfg.dmPolicy??`pairing`,allowFrom=opts.allowFrom??telegramCfg.allowFrom,groupAllowFrom=opts.groupAllowFrom??telegramCfg.groupAllowFrom??(telegramCfg.allowFrom&&telegramCfg.allowFrom.length>0?telegramCfg.allowFrom:void 0)??(opts.allowFrom&&opts.allowFrom.length>0?opts.allowFrom:void 0),replyToMode=opts.replyToMode??telegramCfg.replyToMode??`off`,nativeEnabled=resolveNativeCommandsEnabled({providerId:`telegram`,providerSetting:telegramCfg.commands?.native,globalSetting:cfg.commands?.native}),nativeSkillsEnabled=resolveNativeSkillsEnabled({providerId:`telegram`,providerSetting:telegramCfg.commands?.nativeSkills,globalSetting:cfg.commands?.nativeSkills}),nativeDisabledExplicit=isNativeCommandsExplicitlyDisabled({providerSetting:telegramCfg.commands?.native,globalSetting:cfg.commands?.native}),useAccessGroups=cfg.commands?.useAccessGroups!==!1,ackReactionScope=cfg.messages?.ackReactionScope??`group-mentions`,mediaMaxBytes=(opts.mediaMaxMb??telegramCfg.mediaMaxMb??5)*1024*1024,logger=getChildLogger({module:`telegram-auto-reply`}),streamMode=resolveTelegramStreamMode(telegramCfg),resolveGroupPolicy=chatId=>resolveChannelGroupPolicy({cfg,channel:`telegram`,accountId:account.accountId,groupId:String(chatId)}),resolveGroupActivation=params=>{let agentId=params.agentId??resolveDefaultAgentId(cfg),sessionKey=params.sessionKey??`agent:${agentId}:telegram:group:${buildTelegramGroupPeerId(params.chatId,params.messageThreadId)}`,storePath=resolveStorePath(cfg.session?.store,{agentId});try{let entry=loadSessionStore(storePath)[sessionKey];if(entry?.groupActivation===`always`)return!1;if(entry?.groupActivation===`mention`)return!0}catch(err){logVerbose(`Failed to load session for activation check: ${String(err)}`)}},resolveGroupRequireMention=chatId=>resolveChannelGroupRequireMention({cfg,channel:`telegram`,accountId:account.accountId,groupId:String(chatId),requireMentionOverride:opts.requireMention,overrideOrder:`after-config`}),resolveTelegramGroupConfig=(chatId,messageThreadId)=>{let groups=telegramCfg.groups;if(!groups)return{groupConfig:void 0,topicConfig:void 0};let groupConfig=groups[String(chatId)]??groups[`*`];return{groupConfig,topicConfig:messageThreadId==null?void 0:groupConfig?.topics?.[String(messageThreadId)]}},processMessage=createTelegramMessageProcessor({bot,cfg,account,telegramCfg,historyLimit,groupHistories,dmPolicy,allowFrom,groupAllowFrom,ackReactionScope,logger,resolveGroupActivation,resolveGroupRequireMention,resolveTelegramGroupConfig,runtime,replyToMode,streamMode,textLimit,opts});return registerTelegramNativeCommands({bot,cfg,runtime,accountId:account.accountId,telegramCfg,allowFrom,groupAllowFrom,replyToMode,textLimit,useAccessGroups,nativeEnabled,nativeSkillsEnabled,nativeDisabledExplicit,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,opts}),registerTelegramHandlers({cfg,accountId:account.accountId,bot,opts,runtime,mediaMaxBytes,telegramCfg,groupAllowFrom,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,processMessage,logger}),bot}function normalizeAccountId(accountId){let trimmed=accountId?.trim();return trimmed?trimmed.replace(/[^a-z0-9._-]+/gi,`_`):`default`}function resolveTelegramUpdateOffsetPath(accountId,env=process.env){let stateDir=resolveStateDir(env,os.homedir),normalized=normalizeAccountId(accountId);return path.join(stateDir,`telegram`,`update-offset-${normalized}.json`)}function safeParseState(raw){try{let parsed=JSON.parse(raw);return parsed?.version!==1||parsed.lastUpdateId!==null&&typeof parsed.lastUpdateId!=`number`?null:parsed}catch{return null}}async function readTelegramUpdateOffset(params){let filePath=resolveTelegramUpdateOffsetPath(params.accountId,params.env);try{return safeParseState(await fs$1.readFile(filePath,`utf-8`))?.lastUpdateId??null}catch(err){return err.code,null}}async function writeTelegramUpdateOffset(params){let filePath=resolveTelegramUpdateOffsetPath(params.accountId,params.env),dir=path.dirname(filePath);await fs$1.mkdir(dir,{recursive:!0,mode:448});let tmp=path.join(dir,`${path.basename(filePath)}.${crypto.randomUUID()}.tmp`),payload={version:1,lastUpdateId:params.updateId};await fs$1.writeFile(tmp,`${JSON.stringify(payload,null,2)}\n`,{encoding:`utf-8`}),await fs$1.chmod(tmp,384),await fs$1.rename(tmp,filePath)}async function deleteTelegramUpdateOffset(params){let filePath=resolveTelegramUpdateOffsetPath(params.accountId,params.env);try{await fs$1.unlink(filePath)}catch(err){if(err.code===`ENOENT`)return;throw err}}async function startTelegramWebhook(opts){let path=opts.path??`/telegram-webhook`,healthPath=opts.healthPath??`/healthz`,port=opts.port??8787,host=opts.host??`127.0.0.1`,secret=typeof opts.secret==`string`?opts.secret.trim():``;if(!secret)throw Error(`Telegram webhook mode requires a non-empty secret token. Set channels.telegram.webhookSecret in your config.`);let runtime=opts.runtime??defaultRuntime,diagnosticsEnabled=isDiagnosticsEnabled(opts.config),bot=createTelegramBot({token:opts.token,runtime,proxyFetch:opts.fetch,config:opts.config,accountId:opts.accountId}),handler=webhookCallback(bot,`http`,{secretToken:secret,onTimeout:`return`,timeoutMilliseconds:1e4});diagnosticsEnabled&&startDiagnosticHeartbeat();let server=createServer((req,res)=>{if(req.url===healthPath){res.writeHead(200),res.end(`ok`);return}if(req.url!==path||req.method!==`POST`){res.writeHead(404),res.end();return}let startTime=Date.now();diagnosticsEnabled&&logWebhookReceived({channel:`telegram`,updateType:`telegram-post`});let guard=installRequestBodyLimitGuard(req,res,{maxBytes:1048576,timeoutMs:3e4,responseFormat:`text`});if(guard.isTripped())return;let handled=handler(req,res);if(handled&&typeof handled.catch==`function`){handled.then(()=>{diagnosticsEnabled&&logWebhookProcessed({channel:`telegram`,updateType:`telegram-post`,durationMs:Date.now()-startTime})}).catch(err=>{if(guard.isTripped())return;let errMsg=formatErrorMessage(err);diagnosticsEnabled&&logWebhookError({channel:`telegram`,updateType:`telegram-post`,error:errMsg}),runtime.log?.(`webhook handler failed: ${errMsg}`),res.headersSent||res.writeHead(500),res.end()}).finally(()=>{guard.dispose()});return}guard.dispose()}),publicUrl=opts.publicUrl??`http://${host===`0.0.0.0`?`localhost`:host}:${port}${path}`;await withTelegramApiErrorLogging({operation:`setWebhook`,runtime,fn:()=>bot.api.setWebhook(publicUrl,{secret_token:secret,allowed_updates:resolveTelegramAllowedUpdates()})}),await new Promise(resolve=>server.listen(port,host,resolve)),runtime.log?.(`webhook listening on ${publicUrl}`);let shutdown=()=>{server.close(),bot.stop(),diagnosticsEnabled&&stopDiagnosticHeartbeat()};return opts.abortSignal&&opts.abortSignal.addEventListener(`abort`,shutdown,{once:!0}),{server,bot,stop:shutdown}}function createTelegramRunnerOptions(cfg){return{sink:{concurrency:resolveAgentMaxConcurrent(cfg)},runner:{fetch:{timeout:30,allowed_updates:resolveTelegramAllowedUpdates()},silent:!0,maxRetryTime:300*1e3,retryInterval:`exponential`}}}const TELEGRAM_POLL_RESTART_POLICY={initialMs:2e3,maxMs:3e4,factor:1.8,jitter:.25},isGetUpdatesConflict=err=>{if(!err||typeof err!=`object`)return!1;let typed=err;return(typed.error_code??typed.errorCode)===409?[typed.method,typed.description,typed.message].filter(value=>typeof value==`string`).join(` `).toLowerCase().includes(`getupdates`):!1},isGrammyHttpError=err=>!err||typeof err!=`object`?!1:err.name===`HttpError`;async function monitorTelegramProvider(opts={}){let log=opts.runtime?.error??console.error,unregisterHandler=registerUnhandledRejectionHandler(err=>isGrammyHttpError(err)&&isRecoverableTelegramNetworkError(err,{context:`polling`})?(log(`[telegram] Suppressed network error: ${formatErrorMessage(err)}`),!0):!1);try{let cfg=opts.config??loadConfig(),account=resolveTelegramAccount({cfg,accountId:opts.accountId}),token=opts.token?.trim()||account.token;if(!token)throw Error(`Telegram bot token missing for account "${account.accountId}" (set channels.telegram.accounts.${account.accountId}.botToken/tokenFile or TELEGRAM_BOT_TOKEN for default).`);let proxyFetch=opts.proxyFetch??(account.config.proxy?makeProxyFetch(account.config.proxy):void 0),lastUpdateId=await readTelegramUpdateOffset({accountId:account.accountId}),bot=createTelegramBot({token,runtime:opts.runtime,proxyFetch,config:cfg,accountId:account.accountId,updateOffset:{lastUpdateId,onUpdateId:async updateId=>{if(!(lastUpdateId!==null&&updateId<=lastUpdateId)){lastUpdateId=updateId;try{await writeTelegramUpdateOffset({accountId:account.accountId,updateId})}catch(err){(opts.runtime?.error??console.error)(`telegram: failed to persist update offset: ${String(err)}`)}}}}});if(opts.useWebhook){await startTelegramWebhook({token,accountId:account.accountId,config:cfg,path:opts.webhookPath,port:opts.webhookPort,secret:opts.webhookSecret??account.config.webhookSecret,host:opts.webhookHost??account.config.webhookHost,runtime:opts.runtime,fetch:proxyFetch,abortSignal:opts.abortSignal,publicUrl:opts.webhookUrl});return}let restartAttempts=0;for(;!opts.abortSignal?.aborted;){let runner=run(bot,createTelegramRunnerOptions(cfg)),stopOnAbort=()=>{opts.abortSignal?.aborted&&runner.stop()};opts.abortSignal?.addEventListener(`abort`,stopOnAbort,{once:!0});try{await runner.task();return}catch(err){if(opts.abortSignal?.aborted)throw err;let isConflict=isGetUpdatesConflict(err),isRecoverable=isRecoverableTelegramNetworkError(err,{context:`polling`});if(!isConflict&&!isRecoverable)throw err;restartAttempts+=1;let delayMs=computeBackoff(TELEGRAM_POLL_RESTART_POLICY,restartAttempts),reason=isConflict?`getUpdates conflict`:`network error`,errMsg=formatErrorMessage(err);(opts.runtime?.error??console.error)(`Telegram ${reason}: ${errMsg}; retrying in ${formatDurationPrecise(delayMs)}.`);try{await sleepWithAbort(delayMs,opts.abortSignal)}catch(sleepErr){if(opts.abortSignal?.aborted)return;throw sleepErr}}finally{opts.abortSignal?.removeEventListener(`abort`,stopOnAbort)}}}finally{unregisterHandler()}}async function probeTelegram(token,timeoutMs,proxyUrl){let started=Date.now(),fetcher=proxyUrl?makeProxyFetch(proxyUrl):fetch,base=`https://api.telegram.org/bot${token}`,retryDelayMs=Math.max(50,Math.min(1e3,timeoutMs)),result={ok:!1,status:null,error:null,elapsedMs:0};try{let meRes=null,fetchError=null;for(let i=0;i<3;i++)try{meRes=await fetchWithTimeout(`${base}/getMe`,{},timeoutMs,fetcher);break}catch(err){fetchError=err,i<2&&await new Promise(resolve=>setTimeout(resolve,retryDelayMs))}if(!meRes)throw fetchError;let meJson=await meRes.json();if(!meRes.ok||!meJson?.ok)return result.status=meRes.status,result.error=meJson?.description??`getMe failed (${meRes.status})`,{...result,elapsedMs:Date.now()-started};result.bot={id:meJson.result?.id??null,username:meJson.result?.username??null,canJoinGroups:typeof meJson.result?.can_join_groups==`boolean`?meJson.result?.can_join_groups:null,canReadAllGroupMessages:typeof meJson.result?.can_read_all_group_messages==`boolean`?meJson.result?.can_read_all_group_messages:null,supportsInlineQueries:typeof meJson.result?.supports_inline_queries==`boolean`?meJson.result?.supports_inline_queries:null};try{let webhookRes=await fetchWithTimeout(`${base}/getWebhookInfo`,{},timeoutMs,fetcher),webhookJson=await webhookRes.json();webhookRes.ok&&webhookJson?.ok&&(result.webhook={url:webhookJson.result?.url??null,hasCustomCert:webhookJson.result?.has_custom_certificate??null})}catch{}return result.ok=!0,result.status=null,result.error=null,result.elapsedMs=Date.now()-started,result}catch(err){return{...result,status:err instanceof Response?err.status:result.status,error:err instanceof Error?err.message:String(err),elapsedMs:Date.now()-started}}}function formatNativeDependencyHint(params){let manager=params.manager??`pnpm`,rebuildCommand=params.rebuildCommand??(manager===`npm`?`npm rebuild ${params.packageName}`:manager===`yarn`?`yarn rebuild ${params.packageName}`:`pnpm rebuild ${params.packageName}`),steps=[params.approveBuildsCommand??(manager===`pnpm`?`pnpm approve-builds (select ${params.packageName})`:void 0),rebuildCommand,params.downloadCommand].filter(step=>!!step);return steps.length===0?`Install ${params.packageName} and rebuild its native module.`:`Install ${params.packageName} and rebuild its native module (${steps.join(`; `)}).`}let cachedVersion=null;function resolveVersion(){if(cachedVersion)return cachedVersion;try{return cachedVersion=createRequire(import.meta.url)(`../../../package.json`).version??`unknown`,cachedVersion}catch{return cachedVersion=`unknown`,cachedVersion}}const sendMessageWhatsAppLazy=async(...args)=>{let{sendMessageWhatsApp}=await loadWebOutbound();return sendMessageWhatsApp(...args)},sendPollWhatsAppLazy=async(...args)=>{let{sendPollWhatsApp}=await loadWebOutbound();return sendPollWhatsApp(...args)},loginWebLazy=async(...args)=>{let{loginWeb}=await loadWebLogin();return loginWeb(...args)},startWebLoginWithQrLazy=async(...args)=>{let{startWebLoginWithQr}=await loadWebLoginQr();return startWebLoginWithQr(...args)},waitForWebLoginLazy=async(...args)=>{let{waitForWebLogin}=await loadWebLoginQr();return waitForWebLogin(...args)},monitorWebChannelLazy=async(...args)=>{let{monitorWebChannel}=await loadWebChannel();return monitorWebChannel(...args)},handleWhatsAppActionLazy=async(...args)=>{let{handleWhatsAppAction}=await loadWhatsAppActions();return handleWhatsAppAction(...args)};let webOutboundPromise=null,webLoginPromise=null,webLoginQrPromise=null,webChannelPromise=null,whatsappActionsPromise=null;function loadWebOutbound(){return webOutboundPromise??=import(`./outbound-COVHtzaO.js`),webOutboundPromise}function loadWebLogin(){return webLoginPromise??=import(`./login-DPbcOj1t.js`),webLoginPromise}function loadWebLoginQr(){return webLoginQrPromise??=import(`./login-qr-CQZjY4y-.js`),webLoginQrPromise}function loadWebChannel(){return webChannelPromise??=import(`./web-wR7gzEVJ.js`),webChannelPromise}function loadWhatsAppActions(){return whatsappActionsPromise??=import(`./whatsapp-actions-B-UFK43C.js`),whatsappActionsPromise}function createPluginRuntime(){return{version:resolveVersion(),config:{loadConfig,writeConfigFile},system:{enqueueSystemEvent,runCommandWithTimeout,formatNativeDependencyHint},media:{loadWebMedia,detectMime,mediaKindFromMime,isVoiceCompatibleAudio,getImageMetadata,resizeToJpeg},tts:{textToSpeechTelephony},tools:{createMemoryGetTool,createMemorySearchTool,registerMemoryCli},channel:{text:{chunkByNewline,chunkMarkdownText,chunkMarkdownTextWithMode,chunkText,chunkTextWithMode,resolveChunkMode,resolveTextChunkLimit,hasControlCommand,resolveMarkdownTableMode,convertMarkdownTables},reply:{dispatchReplyWithBufferedBlockDispatcher,createReplyDispatcherWithTyping,resolveEffectiveMessagesConfig,resolveHumanDelayConfig,dispatchReplyFromConfig,finalizeInboundContext,formatAgentEnvelope,formatInboundEnvelope,resolveEnvelopeFormatOptions},routing:{resolveAgentRoute},pairing:{buildPairingReply,readAllowFromStore:readChannelAllowFromStore,upsertPairingRequest:upsertChannelPairingRequest},media:{fetchRemoteMedia,saveMediaBuffer},activity:{record:recordChannelActivity,get:getChannelActivity},session:{resolveStorePath,readSessionUpdatedAt,recordSessionMetaFromInbound,recordInboundSession,updateLastRoute},mentions:{buildMentionRegexes,matchesMentionPatterns,matchesMentionWithExplicit},reactions:{shouldAckReaction,removeAckReactionAfterReply},groups:{resolveGroupPolicy:resolveChannelGroupPolicy,resolveRequireMention:resolveChannelGroupRequireMention},debounce:{createInboundDebouncer,resolveInboundDebounceMs},commands:{resolveCommandAuthorizedFromAuthorizers,isControlCommandMessage,shouldComputeCommandAuthorized,shouldHandleTextCommands},discord:{messageActions:discordMessageActions,auditChannelPermissions:auditDiscordChannelPermissions,listDirectoryGroupsLive:listDiscordDirectoryGroupsLive,listDirectoryPeersLive:listDiscordDirectoryPeersLive,probeDiscord,resolveChannelAllowlist:resolveDiscordChannelAllowlist,resolveUserAllowlist:resolveDiscordUserAllowlist,sendMessageDiscord,sendPollDiscord,monitorDiscordProvider},slack:{listDirectoryGroupsLive:listSlackDirectoryGroupsLive,listDirectoryPeersLive:listSlackDirectoryPeersLive,probeSlack,resolveChannelAllowlist:resolveSlackChannelAllowlist,resolveUserAllowlist:resolveSlackUserAllowlist,sendMessageSlack,monitorSlackProvider,handleSlackAction},telegram:{auditGroupMembership:auditTelegramGroupMembership,collectUnmentionedGroupIds:collectTelegramUnmentionedGroupIds,probeTelegram,resolveTelegramToken,sendMessageTelegram,sendPollTelegram,monitorTelegramProvider,messageActions:telegramMessageActions},signal:{probeSignal,sendMessageSignal,monitorSignalProvider,messageActions:signalMessageActions},imessage:{monitorIMessageProvider,probeIMessage,sendMessageIMessage},whatsapp:{getActiveWebListener,getWebAuthAgeMs,logoutWeb,logWebSelfId,readWebSelfId,webAuthExists,sendMessageWhatsApp:sendMessageWhatsAppLazy,sendPollWhatsApp:sendPollWhatsAppLazy,loginWeb:loginWebLazy,startWebLoginWithQr:startWebLoginWithQrLazy,waitForWebLogin:waitForWebLoginLazy,monitorWebChannel:monitorWebChannelLazy,handleWhatsAppAction:handleWhatsAppActionLazy,createLoginTool:createWhatsAppLoginTool},line:{listLineAccountIds,resolveDefaultLineAccountId,resolveLineAccount,normalizeAccountId:normalizeAccountId$1,probeLineBot,sendMessageLine,pushMessageLine,pushMessagesLine,pushFlexMessage,pushTemplateMessage,pushLocationMessage,pushTextMessageWithQuickReplies,createQuickReplyItems,buildTemplateMessageFromPayload,monitorLineProvider}},logging:{shouldLogVerbose,getChildLogger:(bindings,opts)=>{let logger=getChildLogger(bindings,{level:opts?.level?normalizeLogLevel(opts.level):void 0});return{debug:message=>logger.debug?.(message),info:message=>logger.info(message),warn:message=>logger.warn(message),error:message=>logger.error(message)}}},state:{resolveStateDir}}}const registryCache=new Map,defaultLogger=()=>createSubsystemLogger(`plugins`),resolvePluginSdkAliasFile=params=>{try{let modulePath=fileURLToPath(import.meta.url),isTest=process.env.VITEST||!1,cursor=path.dirname(modulePath);for(let i=0;i<6;i+=1){let srcCandidate=path.join(cursor,`src`,`plugin-sdk`,params.srcFile),distCandidate=path.join(cursor,`dist`,`plugin-sdk`,params.distFile),orderedCandidates=isTest?[distCandidate,srcCandidate]:[distCandidate];for(let candidate of orderedCandidates)if(fs.existsSync(candidate))return candidate;let parent=path.dirname(cursor);if(parent===cursor)break;cursor=parent}}catch{}return null},resolvePluginSdkAlias=()=>resolvePluginSdkAliasFile({srcFile:`index.ts`,distFile:`index.js`}),resolvePluginSdkAccountIdAlias=()=>resolvePluginSdkAliasFile({srcFile:`account-id.ts`,distFile:`account-id.js`});function buildCacheKey(params){return`${params.workspaceDir?resolveUserPath(params.workspaceDir):``}::${JSON.stringify(params.plugins)}`}function validatePluginConfig(params){let schema=params.schema;if(!schema)return{ok:!0,value:params.value};let result=validateJsonSchemaValue({schema,cacheKey:params.cacheKey??JSON.stringify(schema),value:params.value??{}});return result.ok?{ok:!0,value:params.value}:{ok:!1,errors:result.errors}}function resolvePluginModuleExport(moduleExport){let resolved=moduleExport&&typeof moduleExport==`object`&&`default`in moduleExport?moduleExport.default:moduleExport;if(typeof resolved==`function`)return{register:resolved};if(resolved&&typeof resolved==`object`){let def=resolved;return{definition:def,register:def.register??def.activate}}return{}}function createPluginRecord(params){return{id:params.id,name:params.name??params.id,description:params.description,version:params.version,source:params.source,origin:params.origin,workspaceDir:params.workspaceDir,enabled:params.enabled,status:params.enabled?`loaded`:`disabled`,toolNames:[],hookNames:[],channelIds:[],providerIds:[],gatewayMethods:[],cliCommands:[],services:[],commands:[],httpHandlers:0,hookCount:0,configSchema:params.configSchema,configUiHints:void 0,configJsonSchema:void 0}}function pushDiagnostics(diagnostics,append){diagnostics.push(...append)}function registerManifestHookDirs(params){for(let hookDir of params.hookDirs){let resolvedDir=path.resolve(params.rootDir,hookDir);registerPluginHooksFromDir(params.api,resolvedDir).then(hookResult=>{for(let message of hookResult.errors)params.diagnostics.push({level:`warn`,pluginId:params.record.id,source:params.record.source,message})}).catch(err=>{params.logger.warn(`[plugins] ${params.record.id} failed loading hooks from ${resolvedDir}: ${String(err)}`)})}}function loadBuilderForceAgentsPlugins(options={}){let cfg=applyTestPluginDefaults(options.config??{},process.env),logger=options.logger??defaultLogger(),validateOnly=options.mode===`validate`,normalized=normalizePluginsConfig(cfg.plugins),cacheKey=buildCacheKey({workspaceDir:options.workspaceDir,plugins:normalized}),cacheEnabled=options.cache!==!1;if(cacheEnabled){let cached=registryCache.get(cacheKey);if(cached)return setActivePluginRegistry(cached,cacheKey),cached}clearPluginCommands();let{registry,createApi}=createPluginRegistry({logger,runtime:createPluginRuntime(),coreGatewayHandlers:options.coreGatewayHandlers}),discovery=discoverBuilderForceAgentsPlugins({workspaceDir:options.workspaceDir,extraPaths:normalized.loadPaths}),manifestRegistry=loadPluginManifestRegistry({config:cfg,workspaceDir:options.workspaceDir,cache:options.cache,candidates:discovery.candidates,diagnostics:discovery.diagnostics});pushDiagnostics(registry.diagnostics,manifestRegistry.diagnostics);let jitiLoader=null,getJiti=()=>{if(jitiLoader)return jitiLoader;let pluginSdkAlias=resolvePluginSdkAlias(),pluginSdkAccountIdAlias=resolvePluginSdkAccountIdAlias();return jitiLoader=createJiti(import.meta.url,{interopDefault:!0,extensions:[`.ts`,`.tsx`,`.mts`,`.cts`,`.mtsx`,`.ctsx`,`.js`,`.mjs`,`.cjs`,`.json`],...pluginSdkAlias||pluginSdkAccountIdAlias?{alias:{...pluginSdkAlias?{"@seanhogg/builderforce-agents/plugin-sdk":pluginSdkAlias}:{},...pluginSdkAccountIdAlias?{"@seanhogg/builderforce-agents/plugin-sdk/account-id":pluginSdkAccountIdAlias}:{}}}:{}}),jitiLoader},manifestByRoot=new Map(manifestRegistry.plugins.map(record=>[record.rootDir,record])),seenIds=new Map,memorySlot=normalized.slots.memory,selectedMemoryPluginId=null,memorySlotMatched=!1;for(let candidate of discovery.candidates){let manifestRecord=manifestByRoot.get(candidate.rootDir);if(!manifestRecord)continue;let pluginId=manifestRecord.id,existingOrigin=seenIds.get(pluginId);if(existingOrigin){let record=createPluginRecord({id:pluginId,name:manifestRecord.name??pluginId,description:manifestRecord.description,version:manifestRecord.version,source:candidate.source,origin:candidate.origin,workspaceDir:candidate.workspaceDir,enabled:!1,configSchema:!!manifestRecord.configSchema});record.status=`disabled`,record.error=`overridden by ${existingOrigin} plugin`,registry.plugins.push(record);continue}let enableState=resolveEnableState(pluginId,candidate.origin,normalized),entry=normalized.entries[pluginId],record=createPluginRecord({id:pluginId,name:manifestRecord.name??pluginId,description:manifestRecord.description,version:manifestRecord.version,source:candidate.source,origin:candidate.origin,workspaceDir:candidate.workspaceDir,enabled:enableState.enabled,configSchema:!!manifestRecord.configSchema});if(record.kind=manifestRecord.kind,record.configUiHints=manifestRecord.configUiHints,record.configJsonSchema=manifestRecord.configSchema,!enableState.enabled){record.status=`disabled`,record.error=enableState.reason,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin);continue}if(!manifestRecord.configSchema){record.status=`error`,record.error=`missing config schema`,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:record.error});continue}let mod=null;try{mod=getJiti()(candidate.source)}catch(err){logger.error(`[plugins] ${record.id} failed to load from ${record.source}: ${String(err)}`),record.status=`error`,record.error=String(err),registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:`failed to load plugin: ${String(err)}`});continue}let resolved=resolvePluginModuleExport(mod),definition=resolved.definition,register=resolved.register;definition?.id&&definition.id!==record.id&&registry.diagnostics.push({level:`warn`,pluginId:record.id,source:record.source,message:`plugin id mismatch (config uses "${record.id}", export uses "${definition.id}")`}),record.name=definition?.name??record.name,record.description=definition?.description??record.description,record.version=definition?.version??record.version;let manifestKind=record.kind,exportKind=definition?.kind;manifestKind&&exportKind&&exportKind!==manifestKind&&registry.diagnostics.push({level:`warn`,pluginId:record.id,source:record.source,message:`plugin kind mismatch (manifest uses "${manifestKind}", export uses "${exportKind}")`}),record.kind=definition?.kind??record.kind,record.kind===`memory`&&memorySlot===record.id&&(memorySlotMatched=!0);let memoryDecision=resolveMemorySlotDecision({id:record.id,kind:record.kind,slot:memorySlot,selectedId:selectedMemoryPluginId});if(!memoryDecision.enabled){record.enabled=!1,record.status=`disabled`,record.error=memoryDecision.reason,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin);continue}memoryDecision.selected&&record.kind===`memory`&&(selectedMemoryPluginId=record.id);let validatedConfig=validatePluginConfig({schema:manifestRecord.configSchema,cacheKey:manifestRecord.schemaCacheKey,value:entry?.config});if(!validatedConfig.ok){logger.error(`[plugins] ${record.id} invalid config: ${validatedConfig.errors?.join(`, `)}`),record.status=`error`,record.error=`invalid config: ${validatedConfig.errors?.join(`, `)}`,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:record.error});continue}if(validateOnly){registry.plugins.push(record),seenIds.set(pluginId,candidate.origin);continue}if(typeof register!=`function`){logger.error(`[plugins] ${record.id} missing register/activate export`),record.status=`error`,record.error=`plugin export missing register/activate`,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:record.error});continue}let api=createApi(record,{config:cfg,pluginConfig:validatedConfig.value});try{let result=register(api);result&&typeof result.then==`function`&&registry.diagnostics.push({level:`warn`,pluginId:record.id,source:record.source,message:`plugin register returned a promise; async registration is ignored`}),registerManifestHookDirs({api,record,rootDir:manifestRecord.rootDir,hookDirs:manifestRecord.hooks,diagnostics:registry.diagnostics,logger}),registry.plugins.push(record),seenIds.set(pluginId,candidate.origin)}catch(err){logger.error(`[plugins] ${record.id} failed during register from ${record.source}: ${String(err)}`),record.status=`error`,record.error=String(err),registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:`plugin failed during register: ${String(err)}`})}}return typeof memorySlot==`string`&&!memorySlotMatched&&registry.diagnostics.push({level:`warn`,message:`memory slot plugin not found or not marked as memory: ${memorySlot}`}),cacheEnabled&&registryCache.set(cacheKey,registry),setActivePluginRegistry(registry,cacheKey),initializeGlobalHookRunner(registry),registry}function createPluginLoaderLogger(logger){return{info:msg=>logger.info(msg),warn:msg=>logger.warn(msg),error:msg=>logger.error(msg),debug:msg=>logger.debug?.(msg)}}const log$5=createSubsystemLogger(`plugins`),pluginToolMeta=new WeakMap;function getPluginToolMeta(tool){return pluginToolMeta.get(tool)}function normalizeAllowlist(list){return new Set((list??[]).map(normalizeToolName).filter(Boolean))}function isOptionalToolAllowed(params){if(params.allowlist.size===0)return!1;let toolName=normalizeToolName(params.toolName);if(params.allowlist.has(toolName))return!0;let pluginKey=normalizeToolName(params.pluginId);return params.allowlist.has(pluginKey)?!0:params.allowlist.has(`group:plugins`)}function resolvePluginTools(params){let effectiveConfig=applyTestPluginDefaults(params.context.config??{},process.env);if(!normalizePluginsConfig(effectiveConfig.plugins).enabled)return[];let registry=loadBuilderForceAgentsPlugins({config:effectiveConfig,workspaceDir:params.context.workspaceDir,logger:createPluginLoaderLogger(log$5)}),tools=[],existing=params.existingToolNames??new Set,existingNormalized=new Set(Array.from(existing,tool=>normalizeToolName(tool))),allowlist=normalizeAllowlist(params.toolAllowlist),blockedPlugins=new Set;for(let entry of registry.tools){if(blockedPlugins.has(entry.pluginId))continue;let pluginIdKey=normalizeToolName(entry.pluginId);if(existingNormalized.has(pluginIdKey)){let message=`plugin id conflicts with core tool name (${entry.pluginId})`;log$5.error(message),registry.diagnostics.push({level:`error`,pluginId:entry.pluginId,source:entry.source,message}),blockedPlugins.add(entry.pluginId);continue}let resolved=null;try{resolved=entry.factory(params.context)}catch(err){log$5.error(`plugin tool failed (${entry.pluginId}): ${String(err)}`);continue}if(!resolved)continue;let listRaw=Array.isArray(resolved)?resolved:[resolved],list=entry.optional?listRaw.filter(tool=>isOptionalToolAllowed({toolName:tool.name,pluginId:entry.pluginId,allowlist})):listRaw;if(list.length===0)continue;let nameSet=new Set;for(let tool of list){if(nameSet.has(tool.name)||existing.has(tool.name)){let message=`plugin tool name conflict (${entry.pluginId}): ${tool.name}`;log$5.error(message),registry.diagnostics.push({level:`error`,pluginId:entry.pluginId,source:entry.source,message});continue}nameSet.add(tool.name),existing.add(tool.name),pluginToolMeta.set(tool,{pluginId:entry.pluginId,optional:entry.optional}),tools.push(tool)}}return tools}async function defaultReadFile(filePath){return fs$1.readFile(filePath,`utf8`)}async function applyUpdateHunk(filePath,chunks,options){let originalLines=(await(options?.readFile??defaultReadFile)(filePath).catch(err=>{throw Error(`Failed to read file to update ${filePath}: ${err}`)})).split(`
496
+ `):void 0,conversationLabel=isGroup?msg.chat.title?`${msg.chat.title} id:${chatId}`:`group:${chatId}`:buildSenderName(msg)??String(senderId||chatId),ctxPayload=finalizeInboundContext({Body:prompt,BodyForAgent:prompt,RawBody:prompt,CommandBody:prompt,CommandArgs:commandArgs,From:isGroup?buildTelegramGroupFrom(chatId,resolvedThreadId):`telegram:${chatId}`,To:`slash:${senderId||chatId}`,ChatType:isGroup?`group`:`direct`,ConversationLabel:conversationLabel,GroupSubject:isGroup?msg.chat.title??void 0:void 0,GroupSystemPrompt:isGroup?groupSystemPrompt:void 0,SenderName:buildSenderName(msg),SenderId:senderId||void 0,SenderUsername:senderUsername||void 0,Surface:`telegram`,MessageSid:String(msg.message_id),Timestamp:msg.date?msg.date*1e3:void 0,WasMentioned:!0,CommandAuthorized:commandAuthorized,CommandSource:`native`,SessionKey:`telegram:slash:${senderId||chatId}`,AccountId:route.accountId,CommandTargetSessionKey:sessionKey,MessageThreadId:threadSpec.id,IsForum:isForum,OriginatingChannel:`telegram`,OriginatingTo:`telegram:${chatId}`}),disableBlockStreaming=typeof telegramCfg.blockStreaming==`boolean`?!telegramCfg.blockStreaming:void 0,deliveryState={delivered:!1,skippedNonSilent:0},{onModelSelected,...prefixOptions}=createReplyPrefixOptions({cfg,agentId:route.agentId,channel:`telegram`,accountId:route.accountId});await dispatchReplyWithBufferedBlockDispatcher({ctx:ctxPayload,cfg,dispatcherOptions:{...prefixOptions,deliver:async(payload,_info)=>{(await deliverReplies({replies:[payload],...deliveryBaseOptions})).delivered&&(deliveryState.delivered=!0)},onSkip:(_payload,info)=>{info.reason!==`silent`&&(deliveryState.skippedNonSilent+=1)},onError:(err,info)=>{runtime.error?.(danger(`telegram slash ${info.kind} reply failed: ${String(err)}`))}},replyOptions:{skillFilter,disableBlockStreaming,onModelSelected}}),!deliveryState.delivered&&deliveryState.skippedNonSilent>0&&await deliverReplies({replies:[{text:`No response generated. Please try again.`}],...deliveryBaseOptions})})}for(let pluginCommand of pluginCatalog.commands)bot.command(pluginCommand.command,async ctx=>{let msg=ctx.message;if(!msg||shouldSkipUpdate(ctx))return;let chatId=msg.chat.id,rawText=ctx.match?.trim()??``,commandBody=`/${pluginCommand.command}${rawText?` ${rawText}`:``}`,match=matchPluginCommand(commandBody);if(!match){await withTelegramApiErrorLogging({operation:`sendMessage`,runtime,fn:()=>bot.api.sendMessage(chatId,`Command not found.`)});return}let auth=await resolveTelegramCommandAuth({msg,bot,cfg,accountId,telegramCfg,allowFrom,groupAllowFrom,useAccessGroups,resolveGroupPolicy,resolveTelegramGroupConfig,requireAuth:match.command.requireAuth!==!1});if(!auth)return;let{senderId,commandAuthorized,isGroup,isForum,resolvedThreadId}=auth,{threadSpec,mediaLocalRoots,tableMode,chunkMode}=resolveCommandRuntimeContext({msg,isGroup,isForum,resolvedThreadId}),deliveryBaseOptions=buildCommandDeliveryBaseOptions({chatId,mediaLocalRoots,threadSpec,tableMode,chunkMode}),from=isGroup?buildTelegramGroupFrom(chatId,threadSpec.id):`telegram:${chatId}`,to=`telegram:${chatId}`;await deliverReplies({replies:[await executePluginCommand({command:match.command,args:match.args,senderId,channel:`telegram`,isAuthorizedSender:commandAuthorized,commandBody,config:cfg,from,to,accountId,messageThreadId:threadSpec.id})],...deliveryBaseOptions})})}else nativeDisabledExplicit&&withTelegramApiErrorLogging({operation:`setMyCommands`,runtime,fn:()=>bot.api.setMyCommands([])}).catch(()=>{})};function getTelegramSequentialKey(ctx){let reaction=ctx.update?.message_reaction;if(reaction?.chat?.id)return`telegram:${reaction.chat.id}`;let msg=ctx.message??ctx.channelPost??ctx.editedChannelPost??ctx.update?.message??ctx.update?.edited_message??ctx.update?.channel_post??ctx.update?.edited_channel_post??ctx.update?.callback_query?.message,chatId=msg?.chat?.id??ctx.chat?.id,rawText=msg?.text??msg?.caption,botUsername=ctx.me?.username;if(isAbortRequestText(rawText,botUsername?{botUsername}:void 0))return typeof chatId==`number`?`telegram:${chatId}:control`:`telegram:control`;let isGroup=msg?.chat?.type===`group`||msg?.chat?.type===`supergroup`,messageThreadId=msg?.message_thread_id,isForum=msg?.chat?.is_forum,threadId=isGroup?resolveTelegramForumThreadId({isForum,messageThreadId}):messageThreadId;return typeof chatId==`number`?threadId==null?`telegram:${chatId}`:`telegram:${chatId}:topic:${threadId}`:`telegram:unknown`}function createTelegramBot(opts){let runtime=opts.runtime??{log:console.log,error:console.error,exit:code=>{throw Error(`exit ${code}`)}},cfg=opts.config??loadConfig(),account=resolveTelegramAccount({cfg,accountId:opts.accountId}),telegramCfg=account.config,fetchImpl=resolveTelegramFetch(opts.proxyFetch,{network:telegramCfg.network}),shouldProvideFetch=!!fetchImpl,fetchForClient=fetchImpl,timeoutSeconds=typeof telegramCfg?.timeoutSeconds==`number`&&Number.isFinite(telegramCfg.timeoutSeconds)?Math.max(1,Math.floor(telegramCfg.timeoutSeconds)):void 0,client=shouldProvideFetch||timeoutSeconds?{...shouldProvideFetch&&fetchImpl?{fetch:fetchForClient}:{},...timeoutSeconds?{timeoutSeconds}:{}}:void 0,bot=new Bot(opts.token,client?{client}:void 0);bot.api.config.use(apiThrottler()),bot.use(sequentialize(getTelegramSequentialKey)),bot.catch(err=>{runtime.error?.(danger(`telegram bot error: ${formatUncaughtError(err)}`))});let recentUpdates=createTelegramUpdateDedupe(),lastUpdateId=typeof opts.updateOffset?.lastUpdateId==`number`?opts.updateOffset.lastUpdateId:null,recordUpdateId=ctx=>{let updateId=resolveTelegramUpdateId(ctx);typeof updateId==`number`&&(lastUpdateId!==null&&updateId<=lastUpdateId||(lastUpdateId=updateId,opts.updateOffset?.onUpdateId?.(updateId)))},shouldSkipUpdate=ctx=>{let updateId=resolveTelegramUpdateId(ctx);if(typeof updateId==`number`&&lastUpdateId!==null&&updateId<=lastUpdateId)return!0;let key=buildTelegramUpdateKey(ctx),skipped=recentUpdates.check(key);return skipped&&key&&shouldLogVerbose()&&logVerbose(`telegram dedupe: skipped ${key}`),skipped},rawUpdateLogger=createSubsystemLogger(`gateway/channels/telegram/raw-update`),MAX_RAW_UPDATE_CHARS=8e3,stringifyUpdate=update=>{let seen=new WeakSet;return JSON.stringify(update??null,(key,value)=>{if(typeof value==`string`&&value.length>500)return`${value.slice(0,500)}...`;if(Array.isArray(value)&&value.length>20)return[...value.slice(0,20),`...(${value.length-20} more)`];if(value&&typeof value==`object`){if(seen.has(value))return`[Circular]`;seen.add(value)}return value})};bot.use(async(ctx,next)=>{if(shouldLogVerbose())try{let raw=stringifyUpdate(ctx.update),preview=raw.length>MAX_RAW_UPDATE_CHARS?`${raw.slice(0,MAX_RAW_UPDATE_CHARS)}...`:raw;rawUpdateLogger.debug(`telegram update: ${preview}`)}catch(err){rawUpdateLogger.debug(`telegram update log failed: ${String(err)}`)}await next(),recordUpdateId(ctx)});let historyLimit=Math.max(0,telegramCfg.historyLimit??cfg.messages?.groupChat?.historyLimit??50),groupHistories=new Map,textLimit=resolveTextChunkLimit(cfg,`telegram`,account.accountId),dmPolicy=telegramCfg.dmPolicy??`pairing`,allowFrom=opts.allowFrom??telegramCfg.allowFrom,groupAllowFrom=opts.groupAllowFrom??telegramCfg.groupAllowFrom??(telegramCfg.allowFrom&&telegramCfg.allowFrom.length>0?telegramCfg.allowFrom:void 0)??(opts.allowFrom&&opts.allowFrom.length>0?opts.allowFrom:void 0),replyToMode=opts.replyToMode??telegramCfg.replyToMode??`off`,nativeEnabled=resolveNativeCommandsEnabled({providerId:`telegram`,providerSetting:telegramCfg.commands?.native,globalSetting:cfg.commands?.native}),nativeSkillsEnabled=resolveNativeSkillsEnabled({providerId:`telegram`,providerSetting:telegramCfg.commands?.nativeSkills,globalSetting:cfg.commands?.nativeSkills}),nativeDisabledExplicit=isNativeCommandsExplicitlyDisabled({providerSetting:telegramCfg.commands?.native,globalSetting:cfg.commands?.native}),useAccessGroups=cfg.commands?.useAccessGroups!==!1,ackReactionScope=cfg.messages?.ackReactionScope??`group-mentions`,mediaMaxBytes=(opts.mediaMaxMb??telegramCfg.mediaMaxMb??5)*1024*1024,logger=getChildLogger({module:`telegram-auto-reply`}),streamMode=resolveTelegramStreamMode(telegramCfg),resolveGroupPolicy=chatId=>resolveChannelGroupPolicy({cfg,channel:`telegram`,accountId:account.accountId,groupId:String(chatId)}),resolveGroupActivation=params=>{let agentId=params.agentId??resolveDefaultAgentId(cfg),sessionKey=params.sessionKey??`agent:${agentId}:telegram:group:${buildTelegramGroupPeerId(params.chatId,params.messageThreadId)}`,storePath=resolveStorePath(cfg.session?.store,{agentId});try{let entry=loadSessionStore(storePath)[sessionKey];if(entry?.groupActivation===`always`)return!1;if(entry?.groupActivation===`mention`)return!0}catch(err){logVerbose(`Failed to load session for activation check: ${String(err)}`)}},resolveGroupRequireMention=chatId=>resolveChannelGroupRequireMention({cfg,channel:`telegram`,accountId:account.accountId,groupId:String(chatId),requireMentionOverride:opts.requireMention,overrideOrder:`after-config`}),resolveTelegramGroupConfig=(chatId,messageThreadId)=>{let groups=telegramCfg.groups;if(!groups)return{groupConfig:void 0,topicConfig:void 0};let groupConfig=groups[String(chatId)]??groups[`*`];return{groupConfig,topicConfig:messageThreadId==null?void 0:groupConfig?.topics?.[String(messageThreadId)]}},processMessage=createTelegramMessageProcessor({bot,cfg,account,telegramCfg,historyLimit,groupHistories,dmPolicy,allowFrom,groupAllowFrom,ackReactionScope,logger,resolveGroupActivation,resolveGroupRequireMention,resolveTelegramGroupConfig,runtime,replyToMode,streamMode,textLimit,opts});return registerTelegramNativeCommands({bot,cfg,runtime,accountId:account.accountId,telegramCfg,allowFrom,groupAllowFrom,replyToMode,textLimit,useAccessGroups,nativeEnabled,nativeSkillsEnabled,nativeDisabledExplicit,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,opts}),registerTelegramHandlers({cfg,accountId:account.accountId,bot,opts,runtime,mediaMaxBytes,telegramCfg,groupAllowFrom,resolveGroupPolicy,resolveTelegramGroupConfig,shouldSkipUpdate,processMessage,logger}),bot}function normalizeAccountId(accountId){let trimmed=accountId?.trim();return trimmed?trimmed.replace(/[^a-z0-9._-]+/gi,`_`):`default`}function resolveTelegramUpdateOffsetPath(accountId,env=process.env){let stateDir=resolveStateDir(env,os.homedir),normalized=normalizeAccountId(accountId);return path.join(stateDir,`telegram`,`update-offset-${normalized}.json`)}function safeParseState(raw){try{let parsed=JSON.parse(raw);return parsed?.version!==1||parsed.lastUpdateId!==null&&typeof parsed.lastUpdateId!=`number`?null:parsed}catch{return null}}async function readTelegramUpdateOffset(params){let filePath=resolveTelegramUpdateOffsetPath(params.accountId,params.env);try{return safeParseState(await fs$1.readFile(filePath,`utf-8`))?.lastUpdateId??null}catch(err){return err.code,null}}async function writeTelegramUpdateOffset(params){let filePath=resolveTelegramUpdateOffsetPath(params.accountId,params.env),dir=path.dirname(filePath);await fs$1.mkdir(dir,{recursive:!0,mode:448});let tmp=path.join(dir,`${path.basename(filePath)}.${crypto.randomUUID()}.tmp`),payload={version:1,lastUpdateId:params.updateId};await fs$1.writeFile(tmp,`${JSON.stringify(payload,null,2)}\n`,{encoding:`utf-8`}),await fs$1.chmod(tmp,384),await fs$1.rename(tmp,filePath)}async function deleteTelegramUpdateOffset(params){let filePath=resolveTelegramUpdateOffsetPath(params.accountId,params.env);try{await fs$1.unlink(filePath)}catch(err){if(err.code===`ENOENT`)return;throw err}}async function startTelegramWebhook(opts){let path=opts.path??`/telegram-webhook`,healthPath=opts.healthPath??`/healthz`,port=opts.port??8787,host=opts.host??`127.0.0.1`,secret=typeof opts.secret==`string`?opts.secret.trim():``;if(!secret)throw Error(`Telegram webhook mode requires a non-empty secret token. Set channels.telegram.webhookSecret in your config.`);let runtime=opts.runtime??defaultRuntime,diagnosticsEnabled=isDiagnosticsEnabled(opts.config),bot=createTelegramBot({token:opts.token,runtime,proxyFetch:opts.fetch,config:opts.config,accountId:opts.accountId}),handler=webhookCallback(bot,`http`,{secretToken:secret,onTimeout:`return`,timeoutMilliseconds:1e4});diagnosticsEnabled&&startDiagnosticHeartbeat();let server=createServer((req,res)=>{if(req.url===healthPath){res.writeHead(200),res.end(`ok`);return}if(req.url!==path||req.method!==`POST`){res.writeHead(404),res.end();return}let startTime=Date.now();diagnosticsEnabled&&logWebhookReceived({channel:`telegram`,updateType:`telegram-post`});let guard=installRequestBodyLimitGuard(req,res,{maxBytes:1048576,timeoutMs:3e4,responseFormat:`text`});if(guard.isTripped())return;let handled=handler(req,res);if(handled&&typeof handled.catch==`function`){handled.then(()=>{diagnosticsEnabled&&logWebhookProcessed({channel:`telegram`,updateType:`telegram-post`,durationMs:Date.now()-startTime})}).catch(err=>{if(guard.isTripped())return;let errMsg=formatErrorMessage(err);diagnosticsEnabled&&logWebhookError({channel:`telegram`,updateType:`telegram-post`,error:errMsg}),runtime.log?.(`webhook handler failed: ${errMsg}`),res.headersSent||res.writeHead(500),res.end()}).finally(()=>{guard.dispose()});return}guard.dispose()}),publicUrl=opts.publicUrl??`http://${host===`0.0.0.0`?`localhost`:host}:${port}${path}`;await withTelegramApiErrorLogging({operation:`setWebhook`,runtime,fn:()=>bot.api.setWebhook(publicUrl,{secret_token:secret,allowed_updates:resolveTelegramAllowedUpdates()})}),await new Promise(resolve=>server.listen(port,host,resolve)),runtime.log?.(`webhook listening on ${publicUrl}`);let shutdown=()=>{server.close(),bot.stop(),diagnosticsEnabled&&stopDiagnosticHeartbeat()};return opts.abortSignal&&opts.abortSignal.addEventListener(`abort`,shutdown,{once:!0}),{server,bot,stop:shutdown}}function createTelegramRunnerOptions(cfg){return{sink:{concurrency:resolveAgentMaxConcurrent(cfg)},runner:{fetch:{timeout:30,allowed_updates:resolveTelegramAllowedUpdates()},silent:!0,maxRetryTime:300*1e3,retryInterval:`exponential`}}}const TELEGRAM_POLL_RESTART_POLICY={initialMs:2e3,maxMs:3e4,factor:1.8,jitter:.25},isGetUpdatesConflict=err=>{if(!err||typeof err!=`object`)return!1;let typed=err;return(typed.error_code??typed.errorCode)===409?[typed.method,typed.description,typed.message].filter(value=>typeof value==`string`).join(` `).toLowerCase().includes(`getupdates`):!1},isGrammyHttpError=err=>!err||typeof err!=`object`?!1:err.name===`HttpError`;async function monitorTelegramProvider(opts={}){let log=opts.runtime?.error??console.error,unregisterHandler=registerUnhandledRejectionHandler(err=>isGrammyHttpError(err)&&isRecoverableTelegramNetworkError(err,{context:`polling`})?(log(`[telegram] Suppressed network error: ${formatErrorMessage(err)}`),!0):!1);try{let cfg=opts.config??loadConfig(),account=resolveTelegramAccount({cfg,accountId:opts.accountId}),token=opts.token?.trim()||account.token;if(!token)throw Error(`Telegram bot token missing for account "${account.accountId}" (set channels.telegram.accounts.${account.accountId}.botToken/tokenFile or TELEGRAM_BOT_TOKEN for default).`);let proxyFetch=opts.proxyFetch??(account.config.proxy?makeProxyFetch(account.config.proxy):void 0),lastUpdateId=await readTelegramUpdateOffset({accountId:account.accountId}),bot=createTelegramBot({token,runtime:opts.runtime,proxyFetch,config:cfg,accountId:account.accountId,updateOffset:{lastUpdateId,onUpdateId:async updateId=>{if(!(lastUpdateId!==null&&updateId<=lastUpdateId)){lastUpdateId=updateId;try{await writeTelegramUpdateOffset({accountId:account.accountId,updateId})}catch(err){(opts.runtime?.error??console.error)(`telegram: failed to persist update offset: ${String(err)}`)}}}}});if(opts.useWebhook){await startTelegramWebhook({token,accountId:account.accountId,config:cfg,path:opts.webhookPath,port:opts.webhookPort,secret:opts.webhookSecret??account.config.webhookSecret,host:opts.webhookHost??account.config.webhookHost,runtime:opts.runtime,fetch:proxyFetch,abortSignal:opts.abortSignal,publicUrl:opts.webhookUrl});return}let restartAttempts=0;for(;!opts.abortSignal?.aborted;){let runner=run(bot,createTelegramRunnerOptions(cfg)),stopOnAbort=()=>{opts.abortSignal?.aborted&&runner.stop()};opts.abortSignal?.addEventListener(`abort`,stopOnAbort,{once:!0});try{await runner.task();return}catch(err){if(opts.abortSignal?.aborted)throw err;let isConflict=isGetUpdatesConflict(err),isRecoverable=isRecoverableTelegramNetworkError(err,{context:`polling`});if(!isConflict&&!isRecoverable)throw err;restartAttempts+=1;let delayMs=computeBackoff(TELEGRAM_POLL_RESTART_POLICY,restartAttempts),reason=isConflict?`getUpdates conflict`:`network error`,errMsg=formatErrorMessage(err);(opts.runtime?.error??console.error)(`Telegram ${reason}: ${errMsg}; retrying in ${formatDurationPrecise(delayMs)}.`);try{await sleepWithAbort(delayMs,opts.abortSignal)}catch(sleepErr){if(opts.abortSignal?.aborted)return;throw sleepErr}}finally{opts.abortSignal?.removeEventListener(`abort`,stopOnAbort)}}}finally{unregisterHandler()}}async function probeTelegram(token,timeoutMs,proxyUrl){let started=Date.now(),fetcher=proxyUrl?makeProxyFetch(proxyUrl):fetch,base=`https://api.telegram.org/bot${token}`,retryDelayMs=Math.max(50,Math.min(1e3,timeoutMs)),result={ok:!1,status:null,error:null,elapsedMs:0};try{let meRes=null,fetchError=null;for(let i=0;i<3;i++)try{meRes=await fetchWithTimeout(`${base}/getMe`,{},timeoutMs,fetcher);break}catch(err){fetchError=err,i<2&&await new Promise(resolve=>setTimeout(resolve,retryDelayMs))}if(!meRes)throw fetchError;let meJson=await meRes.json();if(!meRes.ok||!meJson?.ok)return result.status=meRes.status,result.error=meJson?.description??`getMe failed (${meRes.status})`,{...result,elapsedMs:Date.now()-started};result.bot={id:meJson.result?.id??null,username:meJson.result?.username??null,canJoinGroups:typeof meJson.result?.can_join_groups==`boolean`?meJson.result?.can_join_groups:null,canReadAllGroupMessages:typeof meJson.result?.can_read_all_group_messages==`boolean`?meJson.result?.can_read_all_group_messages:null,supportsInlineQueries:typeof meJson.result?.supports_inline_queries==`boolean`?meJson.result?.supports_inline_queries:null};try{let webhookRes=await fetchWithTimeout(`${base}/getWebhookInfo`,{},timeoutMs,fetcher),webhookJson=await webhookRes.json();webhookRes.ok&&webhookJson?.ok&&(result.webhook={url:webhookJson.result?.url??null,hasCustomCert:webhookJson.result?.has_custom_certificate??null})}catch{}return result.ok=!0,result.status=null,result.error=null,result.elapsedMs=Date.now()-started,result}catch(err){return{...result,status:err instanceof Response?err.status:result.status,error:err instanceof Error?err.message:String(err),elapsedMs:Date.now()-started}}}function formatNativeDependencyHint(params){let manager=params.manager??`pnpm`,rebuildCommand=params.rebuildCommand??(manager===`npm`?`npm rebuild ${params.packageName}`:manager===`yarn`?`yarn rebuild ${params.packageName}`:`pnpm rebuild ${params.packageName}`),steps=[params.approveBuildsCommand??(manager===`pnpm`?`pnpm approve-builds (select ${params.packageName})`:void 0),rebuildCommand,params.downloadCommand].filter(step=>!!step);return steps.length===0?`Install ${params.packageName} and rebuild its native module.`:`Install ${params.packageName} and rebuild its native module (${steps.join(`; `)}).`}let cachedVersion=null;function resolveVersion(){if(cachedVersion)return cachedVersion;try{return cachedVersion=createRequire(import.meta.url)(`../../../package.json`).version??`unknown`,cachedVersion}catch{return cachedVersion=`unknown`,cachedVersion}}const sendMessageWhatsAppLazy=async(...args)=>{let{sendMessageWhatsApp}=await loadWebOutbound();return sendMessageWhatsApp(...args)},sendPollWhatsAppLazy=async(...args)=>{let{sendPollWhatsApp}=await loadWebOutbound();return sendPollWhatsApp(...args)},loginWebLazy=async(...args)=>{let{loginWeb}=await loadWebLogin();return loginWeb(...args)},startWebLoginWithQrLazy=async(...args)=>{let{startWebLoginWithQr}=await loadWebLoginQr();return startWebLoginWithQr(...args)},waitForWebLoginLazy=async(...args)=>{let{waitForWebLogin}=await loadWebLoginQr();return waitForWebLogin(...args)},monitorWebChannelLazy=async(...args)=>{let{monitorWebChannel}=await loadWebChannel();return monitorWebChannel(...args)},handleWhatsAppActionLazy=async(...args)=>{let{handleWhatsAppAction}=await loadWhatsAppActions();return handleWhatsAppAction(...args)};let webOutboundPromise=null,webLoginPromise=null,webLoginQrPromise=null,webChannelPromise=null,whatsappActionsPromise=null;function loadWebOutbound(){return webOutboundPromise??=import(`./outbound-COVHtzaO.js`),webOutboundPromise}function loadWebLogin(){return webLoginPromise??=import(`./login-DPbcOj1t.js`),webLoginPromise}function loadWebLoginQr(){return webLoginQrPromise??=import(`./login-qr-CQZjY4y-.js`),webLoginQrPromise}function loadWebChannel(){return webChannelPromise??=import(`./web-CgypI7gs.js`),webChannelPromise}function loadWhatsAppActions(){return whatsappActionsPromise??=import(`./whatsapp-actions-B-UFK43C.js`),whatsappActionsPromise}function createPluginRuntime(){return{version:resolveVersion(),config:{loadConfig,writeConfigFile},system:{enqueueSystemEvent,runCommandWithTimeout,formatNativeDependencyHint},media:{loadWebMedia,detectMime,mediaKindFromMime,isVoiceCompatibleAudio,getImageMetadata,resizeToJpeg},tts:{textToSpeechTelephony},tools:{createMemoryGetTool,createMemorySearchTool,registerMemoryCli},channel:{text:{chunkByNewline,chunkMarkdownText,chunkMarkdownTextWithMode,chunkText,chunkTextWithMode,resolveChunkMode,resolveTextChunkLimit,hasControlCommand,resolveMarkdownTableMode,convertMarkdownTables},reply:{dispatchReplyWithBufferedBlockDispatcher,createReplyDispatcherWithTyping,resolveEffectiveMessagesConfig,resolveHumanDelayConfig,dispatchReplyFromConfig,finalizeInboundContext,formatAgentEnvelope,formatInboundEnvelope,resolveEnvelopeFormatOptions},routing:{resolveAgentRoute},pairing:{buildPairingReply,readAllowFromStore:readChannelAllowFromStore,upsertPairingRequest:upsertChannelPairingRequest},media:{fetchRemoteMedia,saveMediaBuffer},activity:{record:recordChannelActivity,get:getChannelActivity},session:{resolveStorePath,readSessionUpdatedAt,recordSessionMetaFromInbound,recordInboundSession,updateLastRoute},mentions:{buildMentionRegexes,matchesMentionPatterns,matchesMentionWithExplicit},reactions:{shouldAckReaction,removeAckReactionAfterReply},groups:{resolveGroupPolicy:resolveChannelGroupPolicy,resolveRequireMention:resolveChannelGroupRequireMention},debounce:{createInboundDebouncer,resolveInboundDebounceMs},commands:{resolveCommandAuthorizedFromAuthorizers,isControlCommandMessage,shouldComputeCommandAuthorized,shouldHandleTextCommands},discord:{messageActions:discordMessageActions,auditChannelPermissions:auditDiscordChannelPermissions,listDirectoryGroupsLive:listDiscordDirectoryGroupsLive,listDirectoryPeersLive:listDiscordDirectoryPeersLive,probeDiscord,resolveChannelAllowlist:resolveDiscordChannelAllowlist,resolveUserAllowlist:resolveDiscordUserAllowlist,sendMessageDiscord,sendPollDiscord,monitorDiscordProvider},slack:{listDirectoryGroupsLive:listSlackDirectoryGroupsLive,listDirectoryPeersLive:listSlackDirectoryPeersLive,probeSlack,resolveChannelAllowlist:resolveSlackChannelAllowlist,resolveUserAllowlist:resolveSlackUserAllowlist,sendMessageSlack,monitorSlackProvider,handleSlackAction},telegram:{auditGroupMembership:auditTelegramGroupMembership,collectUnmentionedGroupIds:collectTelegramUnmentionedGroupIds,probeTelegram,resolveTelegramToken,sendMessageTelegram,sendPollTelegram,monitorTelegramProvider,messageActions:telegramMessageActions},signal:{probeSignal,sendMessageSignal,monitorSignalProvider,messageActions:signalMessageActions},imessage:{monitorIMessageProvider,probeIMessage,sendMessageIMessage},whatsapp:{getActiveWebListener,getWebAuthAgeMs,logoutWeb,logWebSelfId,readWebSelfId,webAuthExists,sendMessageWhatsApp:sendMessageWhatsAppLazy,sendPollWhatsApp:sendPollWhatsAppLazy,loginWeb:loginWebLazy,startWebLoginWithQr:startWebLoginWithQrLazy,waitForWebLogin:waitForWebLoginLazy,monitorWebChannel:monitorWebChannelLazy,handleWhatsAppAction:handleWhatsAppActionLazy,createLoginTool:createWhatsAppLoginTool},line:{listLineAccountIds,resolveDefaultLineAccountId,resolveLineAccount,normalizeAccountId:normalizeAccountId$1,probeLineBot,sendMessageLine,pushMessageLine,pushMessagesLine,pushFlexMessage,pushTemplateMessage,pushLocationMessage,pushTextMessageWithQuickReplies,createQuickReplyItems,buildTemplateMessageFromPayload,monitorLineProvider}},logging:{shouldLogVerbose,getChildLogger:(bindings,opts)=>{let logger=getChildLogger(bindings,{level:opts?.level?normalizeLogLevel(opts.level):void 0});return{debug:message=>logger.debug?.(message),info:message=>logger.info(message),warn:message=>logger.warn(message),error:message=>logger.error(message)}}},state:{resolveStateDir}}}const registryCache=new Map,defaultLogger=()=>createSubsystemLogger(`plugins`),resolvePluginSdkAliasFile=params=>{try{let modulePath=fileURLToPath(import.meta.url),isTest=process.env.VITEST||!1,cursor=path.dirname(modulePath);for(let i=0;i<6;i+=1){let srcCandidate=path.join(cursor,`src`,`plugin-sdk`,params.srcFile),distCandidate=path.join(cursor,`dist`,`plugin-sdk`,params.distFile),orderedCandidates=isTest?[distCandidate,srcCandidate]:[distCandidate];for(let candidate of orderedCandidates)if(fs.existsSync(candidate))return candidate;let parent=path.dirname(cursor);if(parent===cursor)break;cursor=parent}}catch{}return null},resolvePluginSdkAlias=()=>resolvePluginSdkAliasFile({srcFile:`index.ts`,distFile:`index.js`}),resolvePluginSdkAccountIdAlias=()=>resolvePluginSdkAliasFile({srcFile:`account-id.ts`,distFile:`account-id.js`});function buildCacheKey(params){return`${params.workspaceDir?resolveUserPath(params.workspaceDir):``}::${JSON.stringify(params.plugins)}`}function validatePluginConfig(params){let schema=params.schema;if(!schema)return{ok:!0,value:params.value};let result=validateJsonSchemaValue({schema,cacheKey:params.cacheKey??JSON.stringify(schema),value:params.value??{}});return result.ok?{ok:!0,value:params.value}:{ok:!1,errors:result.errors}}function resolvePluginModuleExport(moduleExport){let resolved=moduleExport&&typeof moduleExport==`object`&&`default`in moduleExport?moduleExport.default:moduleExport;if(typeof resolved==`function`)return{register:resolved};if(resolved&&typeof resolved==`object`){let def=resolved;return{definition:def,register:def.register??def.activate}}return{}}function createPluginRecord(params){return{id:params.id,name:params.name??params.id,description:params.description,version:params.version,source:params.source,origin:params.origin,workspaceDir:params.workspaceDir,enabled:params.enabled,status:params.enabled?`loaded`:`disabled`,toolNames:[],hookNames:[],channelIds:[],providerIds:[],gatewayMethods:[],cliCommands:[],services:[],commands:[],httpHandlers:0,hookCount:0,configSchema:params.configSchema,configUiHints:void 0,configJsonSchema:void 0}}function pushDiagnostics(diagnostics,append){diagnostics.push(...append)}function registerManifestHookDirs(params){for(let hookDir of params.hookDirs){let resolvedDir=path.resolve(params.rootDir,hookDir);registerPluginHooksFromDir(params.api,resolvedDir).then(hookResult=>{for(let message of hookResult.errors)params.diagnostics.push({level:`warn`,pluginId:params.record.id,source:params.record.source,message})}).catch(err=>{params.logger.warn(`[plugins] ${params.record.id} failed loading hooks from ${resolvedDir}: ${String(err)}`)})}}function loadBuilderForceAgentsPlugins(options={}){let cfg=applyTestPluginDefaults(options.config??{},process.env),logger=options.logger??defaultLogger(),validateOnly=options.mode===`validate`,normalized=normalizePluginsConfig(cfg.plugins),cacheKey=buildCacheKey({workspaceDir:options.workspaceDir,plugins:normalized}),cacheEnabled=options.cache!==!1;if(cacheEnabled){let cached=registryCache.get(cacheKey);if(cached)return setActivePluginRegistry(cached,cacheKey),cached}clearPluginCommands();let{registry,createApi}=createPluginRegistry({logger,runtime:createPluginRuntime(),coreGatewayHandlers:options.coreGatewayHandlers}),discovery=discoverBuilderForceAgentsPlugins({workspaceDir:options.workspaceDir,extraPaths:normalized.loadPaths}),manifestRegistry=loadPluginManifestRegistry({config:cfg,workspaceDir:options.workspaceDir,cache:options.cache,candidates:discovery.candidates,diagnostics:discovery.diagnostics});pushDiagnostics(registry.diagnostics,manifestRegistry.diagnostics);let jitiLoader=null,getJiti=()=>{if(jitiLoader)return jitiLoader;let pluginSdkAlias=resolvePluginSdkAlias(),pluginSdkAccountIdAlias=resolvePluginSdkAccountIdAlias();return jitiLoader=createJiti(import.meta.url,{interopDefault:!0,extensions:[`.ts`,`.tsx`,`.mts`,`.cts`,`.mtsx`,`.ctsx`,`.js`,`.mjs`,`.cjs`,`.json`],...pluginSdkAlias||pluginSdkAccountIdAlias?{alias:{...pluginSdkAlias?{"@seanhogg/builderforce-agents/plugin-sdk":pluginSdkAlias}:{},...pluginSdkAccountIdAlias?{"@seanhogg/builderforce-agents/plugin-sdk/account-id":pluginSdkAccountIdAlias}:{}}}:{}}),jitiLoader},manifestByRoot=new Map(manifestRegistry.plugins.map(record=>[record.rootDir,record])),seenIds=new Map,memorySlot=normalized.slots.memory,selectedMemoryPluginId=null,memorySlotMatched=!1;for(let candidate of discovery.candidates){let manifestRecord=manifestByRoot.get(candidate.rootDir);if(!manifestRecord)continue;let pluginId=manifestRecord.id,existingOrigin=seenIds.get(pluginId);if(existingOrigin){let record=createPluginRecord({id:pluginId,name:manifestRecord.name??pluginId,description:manifestRecord.description,version:manifestRecord.version,source:candidate.source,origin:candidate.origin,workspaceDir:candidate.workspaceDir,enabled:!1,configSchema:!!manifestRecord.configSchema});record.status=`disabled`,record.error=`overridden by ${existingOrigin} plugin`,registry.plugins.push(record);continue}let enableState=resolveEnableState(pluginId,candidate.origin,normalized),entry=normalized.entries[pluginId],record=createPluginRecord({id:pluginId,name:manifestRecord.name??pluginId,description:manifestRecord.description,version:manifestRecord.version,source:candidate.source,origin:candidate.origin,workspaceDir:candidate.workspaceDir,enabled:enableState.enabled,configSchema:!!manifestRecord.configSchema});if(record.kind=manifestRecord.kind,record.configUiHints=manifestRecord.configUiHints,record.configJsonSchema=manifestRecord.configSchema,!enableState.enabled){record.status=`disabled`,record.error=enableState.reason,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin);continue}if(!manifestRecord.configSchema){record.status=`error`,record.error=`missing config schema`,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:record.error});continue}let mod=null;try{mod=getJiti()(candidate.source)}catch(err){logger.error(`[plugins] ${record.id} failed to load from ${record.source}: ${String(err)}`),record.status=`error`,record.error=String(err),registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:`failed to load plugin: ${String(err)}`});continue}let resolved=resolvePluginModuleExport(mod),definition=resolved.definition,register=resolved.register;definition?.id&&definition.id!==record.id&&registry.diagnostics.push({level:`warn`,pluginId:record.id,source:record.source,message:`plugin id mismatch (config uses "${record.id}", export uses "${definition.id}")`}),record.name=definition?.name??record.name,record.description=definition?.description??record.description,record.version=definition?.version??record.version;let manifestKind=record.kind,exportKind=definition?.kind;manifestKind&&exportKind&&exportKind!==manifestKind&&registry.diagnostics.push({level:`warn`,pluginId:record.id,source:record.source,message:`plugin kind mismatch (manifest uses "${manifestKind}", export uses "${exportKind}")`}),record.kind=definition?.kind??record.kind,record.kind===`memory`&&memorySlot===record.id&&(memorySlotMatched=!0);let memoryDecision=resolveMemorySlotDecision({id:record.id,kind:record.kind,slot:memorySlot,selectedId:selectedMemoryPluginId});if(!memoryDecision.enabled){record.enabled=!1,record.status=`disabled`,record.error=memoryDecision.reason,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin);continue}memoryDecision.selected&&record.kind===`memory`&&(selectedMemoryPluginId=record.id);let validatedConfig=validatePluginConfig({schema:manifestRecord.configSchema,cacheKey:manifestRecord.schemaCacheKey,value:entry?.config});if(!validatedConfig.ok){logger.error(`[plugins] ${record.id} invalid config: ${validatedConfig.errors?.join(`, `)}`),record.status=`error`,record.error=`invalid config: ${validatedConfig.errors?.join(`, `)}`,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:record.error});continue}if(validateOnly){registry.plugins.push(record),seenIds.set(pluginId,candidate.origin);continue}if(typeof register!=`function`){logger.error(`[plugins] ${record.id} missing register/activate export`),record.status=`error`,record.error=`plugin export missing register/activate`,registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:record.error});continue}let api=createApi(record,{config:cfg,pluginConfig:validatedConfig.value});try{let result=register(api);result&&typeof result.then==`function`&&registry.diagnostics.push({level:`warn`,pluginId:record.id,source:record.source,message:`plugin register returned a promise; async registration is ignored`}),registerManifestHookDirs({api,record,rootDir:manifestRecord.rootDir,hookDirs:manifestRecord.hooks,diagnostics:registry.diagnostics,logger}),registry.plugins.push(record),seenIds.set(pluginId,candidate.origin)}catch(err){logger.error(`[plugins] ${record.id} failed during register from ${record.source}: ${String(err)}`),record.status=`error`,record.error=String(err),registry.plugins.push(record),seenIds.set(pluginId,candidate.origin),registry.diagnostics.push({level:`error`,pluginId:record.id,source:record.source,message:`plugin failed during register: ${String(err)}`})}}return typeof memorySlot==`string`&&!memorySlotMatched&&registry.diagnostics.push({level:`warn`,message:`memory slot plugin not found or not marked as memory: ${memorySlot}`}),cacheEnabled&&registryCache.set(cacheKey,registry),setActivePluginRegistry(registry,cacheKey),initializeGlobalHookRunner(registry),registry}function createPluginLoaderLogger(logger){return{info:msg=>logger.info(msg),warn:msg=>logger.warn(msg),error:msg=>logger.error(msg),debug:msg=>logger.debug?.(msg)}}const log$5=createSubsystemLogger(`plugins`),pluginToolMeta=new WeakMap;function getPluginToolMeta(tool){return pluginToolMeta.get(tool)}function normalizeAllowlist(list){return new Set((list??[]).map(normalizeToolName).filter(Boolean))}function isOptionalToolAllowed(params){if(params.allowlist.size===0)return!1;let toolName=normalizeToolName(params.toolName);if(params.allowlist.has(toolName))return!0;let pluginKey=normalizeToolName(params.pluginId);return params.allowlist.has(pluginKey)?!0:params.allowlist.has(`group:plugins`)}function resolvePluginTools(params){let effectiveConfig=applyTestPluginDefaults(params.context.config??{},process.env);if(!normalizePluginsConfig(effectiveConfig.plugins).enabled)return[];let registry=loadBuilderForceAgentsPlugins({config:effectiveConfig,workspaceDir:params.context.workspaceDir,logger:createPluginLoaderLogger(log$5)}),tools=[],existing=params.existingToolNames??new Set,existingNormalized=new Set(Array.from(existing,tool=>normalizeToolName(tool))),allowlist=normalizeAllowlist(params.toolAllowlist),blockedPlugins=new Set;for(let entry of registry.tools){if(blockedPlugins.has(entry.pluginId))continue;let pluginIdKey=normalizeToolName(entry.pluginId);if(existingNormalized.has(pluginIdKey)){let message=`plugin id conflicts with core tool name (${entry.pluginId})`;log$5.error(message),registry.diagnostics.push({level:`error`,pluginId:entry.pluginId,source:entry.source,message}),blockedPlugins.add(entry.pluginId);continue}let resolved=null;try{resolved=entry.factory(params.context)}catch(err){log$5.error(`plugin tool failed (${entry.pluginId}): ${String(err)}`);continue}if(!resolved)continue;let listRaw=Array.isArray(resolved)?resolved:[resolved],list=entry.optional?listRaw.filter(tool=>isOptionalToolAllowed({toolName:tool.name,pluginId:entry.pluginId,allowlist})):listRaw;if(list.length===0)continue;let nameSet=new Set;for(let tool of list){if(nameSet.has(tool.name)||existing.has(tool.name)){let message=`plugin tool name conflict (${entry.pluginId}): ${tool.name}`;log$5.error(message),registry.diagnostics.push({level:`error`,pluginId:entry.pluginId,source:entry.source,message});continue}nameSet.add(tool.name),existing.add(tool.name),pluginToolMeta.set(tool,{pluginId:entry.pluginId,optional:entry.optional}),tools.push(tool)}}return tools}async function defaultReadFile(filePath){return fs$1.readFile(filePath,`utf8`)}async function applyUpdateHunk(filePath,chunks,options){let originalLines=(await(options?.readFile??defaultReadFile)(filePath).catch(err=>{throw Error(`Failed to read file to update ${filePath}: ${err}`)})).split(`
497
497
  `);originalLines.length>0&&originalLines[originalLines.length-1]===``&&originalLines.pop();let newLines=applyReplacements(originalLines,computeReplacements(originalLines,filePath,chunks));return(newLines.length===0||newLines[newLines.length-1]!==``)&&(newLines=[...newLines,``]),newLines.join(`
498
498
  `)}function computeReplacements(originalLines,filePath,chunks){let replacements=[],lineIndex=0;for(let chunk of chunks){if(chunk.changeContext){let ctxIndex=seekSequence(originalLines,[chunk.changeContext],lineIndex,!1);if(ctxIndex===null)throw Error(`Failed to find context '${chunk.changeContext}' in ${filePath}`);lineIndex=ctxIndex+1}if(chunk.oldLines.length===0){let insertionIndex=originalLines.length>0&&originalLines[originalLines.length-1]===``?originalLines.length-1:originalLines.length;replacements.push([insertionIndex,0,chunk.newLines]);continue}let pattern=chunk.oldLines,newSlice=chunk.newLines,found=seekSequence(originalLines,pattern,lineIndex,chunk.isEndOfFile);if(found===null&&pattern[pattern.length-1]===``&&(pattern=pattern.slice(0,-1),newSlice.length>0&&newSlice[newSlice.length-1]===``&&(newSlice=newSlice.slice(0,-1)),found=seekSequence(originalLines,pattern,lineIndex,chunk.isEndOfFile)),found===null)throw Error(`Failed to find expected lines in ${filePath}:\n${chunk.oldLines.join(`
499
499
  `)}`);replacements.push([found,pattern.length,newSlice]),lineIndex=found+pattern.length}return replacements.sort((a,b)=>a[0]-b[0]),replacements}function applyReplacements(lines,replacements){let result=[...lines];for(let[startIndex,oldLen,newLines]of[...replacements].toReversed()){for(let i=0;i<oldLen;i+=1)startIndex<result.length&&result.splice(startIndex,1);for(let i=0;i<newLines.length;i+=1)result.splice(startIndex+i,0,newLines[i])}return result}function seekSequence(lines,pattern,start,eof){if(pattern.length===0)return start;if(pattern.length>lines.length)return null;let maxStart=lines.length-pattern.length,searchStart=eof&&lines.length>=pattern.length?maxStart:start;if(searchStart>maxStart)return null;for(let i=searchStart;i<=maxStart;i+=1)if(linesMatch(lines,pattern,i,value=>value))return i;for(let i=searchStart;i<=maxStart;i+=1)if(linesMatch(lines,pattern,i,value=>value.trimEnd()))return i;for(let i=searchStart;i<=maxStart;i+=1)if(linesMatch(lines,pattern,i,value=>value.trim()))return i;for(let i=searchStart;i<=maxStart;i+=1)if(linesMatch(lines,pattern,i,value=>normalizePunctuation(value.trim())))return i;return null}function linesMatch(lines,pattern,start,normalize){for(let idx=0;idx<pattern.length;idx+=1)if(normalize(lines[start+idx])!==normalize(pattern[idx]))return!1;return!0}function normalizePunctuation(value){return Array.from(value).map(char=>{switch(char){case`‐`:case`‑`:case`‒`:case`–`:case`—`:case`―`:case`−`:return`-`;case`‘`:case`’`:case`‚`:case`‛`:return`'`;case`“`:case`”`:case`„`:case`‟`:return`"`;case`\xA0`:case` `:case` `:case` `:case` `:case` `:case` `:case` `:case` `:case` `:case` `:case` `:case` `:return` `;default:return char}}).join(``)}const BEGIN_PATCH_MARKER=`*** Begin Patch`,applyPatchSchema=Type.Object({input:Type.String({description:`Patch content using the *** Begin Patch/End Patch format.`})});function createApplyPatchTool(options={}){let cwd=options.cwd??process.cwd(),sandbox=options.sandbox,workspaceOnly=options.workspaceOnly!==!1;return{name:`apply_patch`,label:`apply_patch`,description:`Apply a patch to one or more files using the apply_patch format. The input should include *** Begin Patch and *** End Patch markers.`,parameters:applyPatchSchema,execute:async(_toolCallId,args,signal)=>{let params=args,input=typeof params.input==`string`?params.input:``;if(!input.trim())throw Error(`Provide a patch input.`);if(signal?.aborted){let err=Error(`Aborted`);throw err.name=`AbortError`,err}let result=await applyPatch(input,{cwd,sandbox,workspaceOnly,signal});return{content:[{type:`text`,text:result.text}],details:{summary:result.summary}}}}}async function applyPatch(input,options){let parsed=parsePatchText(input);if(parsed.hunks.length===0)throw Error(`No files were modified.`);let summary={added:[],modified:[],deleted:[]},seen={added:new Set,modified:new Set,deleted:new Set},fileOps=resolvePatchFileOps(options);for(let hunk of parsed.hunks){if(options.signal?.aborted){let err=Error(`Aborted`);throw err.name=`AbortError`,err}if(hunk.kind===`add`){let target=await resolvePatchPath(hunk.path,options);await ensureDir(target.resolved,fileOps),await fileOps.writeFile(target.resolved,hunk.contents),recordSummary(summary,seen,`added`,target.display);continue}if(hunk.kind===`delete`){let target=await resolvePatchPath(hunk.path,options,`unlink`);await fileOps.remove(target.resolved),recordSummary(summary,seen,`deleted`,target.display);continue}let target=await resolvePatchPath(hunk.path,options),applied=await applyUpdateHunk(target.resolved,hunk.chunks,{readFile:path=>fileOps.readFile(path)});if(hunk.movePath){let moveTarget=await resolvePatchPath(hunk.movePath,options);await ensureDir(moveTarget.resolved,fileOps),await fileOps.writeFile(moveTarget.resolved,applied),await fileOps.remove(target.resolved),recordSummary(summary,seen,`modified`,moveTarget.display)}else await fileOps.writeFile(target.resolved,applied),recordSummary(summary,seen,`modified`,target.display)}return{summary,text:formatSummary(summary)}}function recordSummary(summary,seen,bucket,value){seen[bucket].has(value)||(seen[bucket].add(value),summary[bucket].push(value))}function formatSummary(summary){let lines=[`Success. Updated the following files:`];for(let file of summary.added)lines.push(`A ${file}`);for(let file of summary.modified)lines.push(`M ${file}`);for(let file of summary.deleted)lines.push(`D ${file}`);return lines.join(`
@@ -539,6 +539,6 @@ It is listed as a peerDependency of builderForceAgents.`)}}function convertTools
539
539
 
540
540
  `)};hookResult?.prependContext&&(effectivePrompt=`${hookResult.prependContext}\n\n${params.prompt}`,log$3.debug(`hooks: prepended context to prompt (${hookResult.prependContext.length} chars)`)),log$3.debug(`embedded run prompt start: runId=${params.runId} sessionId=${params.sessionId}`),cacheTrace?.recordStage(`prompt:before`,{prompt:effectivePrompt,messages:activeSession.messages});let leafEntry=sessionManager.getLeafEntry();if(leafEntry?.type===`message`&&leafEntry.message.role===`user`){leafEntry.parentId?sessionManager.branch(leafEntry.parentId):sessionManager.resetLeaf();let sessionContext=sessionManager.buildSessionContext(),sanitizedOrphan=transcriptPolicy.normalizeAntigravityThinkingBlocks?sanitizeAntigravityThinkingBlocks(sessionContext.messages):sessionContext.messages;activeSession.agent.replaceMessages(sanitizedOrphan),log$3.warn(`Removed orphaned user message to prevent consecutive user turns. runId=${params.runId} sessionId=${params.sessionId}`)}try{let imageResult=await detectAndLoadPromptImages({prompt:effectivePrompt,workspaceDir:effectiveWorkspace,model:params.model,existingImages:params.images,historyMessages:activeSession.messages,maxBytes:MAX_IMAGE_BYTES,maxDimensionPx:resolveImageSanitizationLimits(params.config).maxDimensionPx,sandbox:sandbox?.enabled&&sandbox?.fsBridge?{root:sandbox.workspaceDir,bridge:sandbox.fsBridge}:void 0});if(injectHistoryImagesIntoMessages(activeSession.messages,imageResult.historyImagesByIndex)&&activeSession.agent.replaceMessages(activeSession.messages),cacheTrace?.recordStage(`prompt:images`,{prompt:effectivePrompt,messages:activeSession.messages,note:`images: prompt=${imageResult.images.length} history=${imageResult.historyImagesByIndex.size}`}),log$3.isEnabled(`debug`)){let msgCount=activeSession.messages.length,systemLen=systemPromptText?.length??0,promptLen=effectivePrompt.length,sessionSummary=summarizeSessionContext(activeSession.messages);log$3.debug(`[context-diag] pre-prompt: sessionKey=${params.sessionKey??params.sessionId} messages=${msgCount} roleCounts=${sessionSummary.roleCounts} historyTextChars=${sessionSummary.totalTextChars} maxMessageTextChars=${sessionSummary.maxMessageTextChars} historyImageBlocks=${sessionSummary.totalImageBlocks} systemPromptChars=${systemLen} promptChars=${promptLen} promptImages=${imageResult.images.length} historyImageMessages=${imageResult.historyImagesByIndex.size} provider=${params.provider}/${params.modelId} sessionFile=${params.sessionFile}`)}hookRunner?.hasHooks(`llm_input`)&&hookRunner.runLlmInput({runId:params.runId,sessionId:params.sessionId,provider:params.provider,model:params.modelId,systemPrompt:systemPromptText,prompt:effectivePrompt,historyMessages:activeSession.messages,imagesCount:imageResult.images.length},{agentId:hookAgentId,sessionKey:params.sessionKey,sessionId:params.sessionId,workspaceDir:params.workspaceDir,messageProvider:params.messageProvider??void 0}).catch(err=>{log$3.warn(`llm_input hook failed: ${String(err)}`)}),imageResult.images.length>0?await abortable(activeSession.prompt(effectivePrompt,{images:imageResult.images})):await abortable(activeSession.prompt(effectivePrompt))}catch(err){promptError=err,promptErrorSource=`prompt`}finally{log$3.debug(`embedded run prompt end: runId=${params.runId} sessionId=${params.sessionId} durationMs=${Date.now()-promptStartedAt}`)}let wasCompactingBefore=activeSession.isCompacting,snapshot=activeSession.messages.slice(),wasCompactingAfter=activeSession.isCompacting,preCompactionSnapshot=wasCompactingBefore||wasCompactingAfter?null:snapshot,preCompactionSessionId=activeSession.sessionId;try{await abortable(waitForCompactionRetry())}catch(err){if(isRunnerAbortError(err))promptError||(promptError=err,promptErrorSource=`compaction`),isProbeSession||log$3.debug(`compaction wait aborted: runId=${params.runId} sessionId=${params.sessionId}`);else throw err}timedOutDuringCompaction||params.config?.agents?.defaults?.contextPruning?.mode===`cache-ttl`&&isCacheTtlEligibleProvider(params.provider,params.modelId)&&appendCacheTtlTimestamp(sessionManager,{timestamp:Date.now(),provider:params.provider,modelId:params.modelId});let snapshotSelection=selectCompactionTimeoutSnapshot({timedOutDuringCompaction,preCompactionSnapshot,preCompactionSessionId,currentSnapshot:activeSession.messages.slice(),currentSessionId:activeSession.sessionId});if(timedOutDuringCompaction&&(isProbeSession||log$3.warn(`using ${snapshotSelection.source} snapshot: timed out during compaction runId=${params.runId} sessionId=${params.sessionId}`)),messagesSnapshot=snapshotSelection.messagesSnapshot,sessionIdUsed=snapshotSelection.sessionIdUsed,promptError&&promptErrorSource===`prompt`)try{sessionManager.appendCustomEntry(`builderforce:prompt-error`,{timestamp:Date.now(),runId:params.runId,sessionId:params.sessionId,provider:params.provider,model:params.modelId,api:params.model.api,error:describeUnknownError(promptError)})}catch(entryErr){log$3.warn(`failed to persist prompt error entry: ${String(entryErr)}`)}cacheTrace?.recordStage(`session:after`,{messages:messagesSnapshot,note:timedOutDuringCompaction?`compaction timeout`:promptError?`prompt error`:void 0}),anthropicPayloadLogger?.recordUsage(messagesSnapshot,promptError),hookRunner?.hasHooks(`agent_end`)&&hookRunner.runAgentEnd({messages:messagesSnapshot,success:!aborted&&!promptError,error:promptError?describeUnknownError(promptError):void 0,durationMs:Date.now()-promptStartedAt},{agentId:hookAgentId,sessionKey:params.sessionKey,sessionId:params.sessionId,workspaceDir:params.workspaceDir,messageProvider:params.messageProvider??void 0}).catch(err=>{log$3.warn(`agent_end hook failed: ${err}`)})}finally{clearTimeout(abortTimer),abortWarnTimer&&clearTimeout(abortWarnTimer),!isProbeSession&&(aborted||timedOut)&&!timedOutDuringCompaction&&log$3.debug(`run cleanup: runId=${params.runId} sessionId=${params.sessionId} aborted=${aborted} timedOut=${timedOut}`);try{unsubscribe()}catch(err){log$3.error(`CRITICAL: unsubscribe failed, possible resource leak: runId=${params.runId} ${String(err)}`)}clearActiveEmbeddedRun(params.sessionId,queueHandle,params.sessionKey),params.abortSignal?.removeEventListener?.(`abort`,onAbort)}let lastAssistant=messagesSnapshot.slice().toReversed().find(m=>m.role===`assistant`),toolMetasNormalized=toolMetas.filter(entry=>typeof entry.toolName==`string`&&entry.toolName.trim().length>0).map(entry=>({toolName:entry.toolName,meta:entry.meta}));return hookRunner?.hasHooks(`llm_output`)&&hookRunner.runLlmOutput({runId:params.runId,sessionId:params.sessionId,provider:params.provider,model:params.modelId,assistantTexts,lastAssistant,usage:getUsageTotals()},{agentId:hookAgentId,sessionKey:params.sessionKey,sessionId:params.sessionId,workspaceDir:params.workspaceDir,messageProvider:params.messageProvider??void 0}).catch(err=>{log$3.warn(`llm_output hook failed: ${String(err)}`)}),{aborted,timedOut,timedOutDuringCompaction,promptError,sessionIdUsed,systemPromptReport,messagesSnapshot,assistantTexts,toolMetas:toolMetasNormalized,lastAssistant,lastToolError:getLastToolError?.(),didSendViaMessagingTool:didSendViaMessagingTool(),messagingToolSentTexts:getMessagingToolSentTexts(),messagingToolSentMediaUrls:getMessagingToolSentMediaUrls(),messagingToolSentTargets:getMessagingToolSentTargets(),successfulCronAdds:getSuccessfulCronAdds(),cloudCodeAssistFormatError:!!(lastAssistant?.errorMessage&&isCloudCodeAssistFormatError(lastAssistant.errorMessage)),attemptUsage:getUsageTotals(),compactionCount:getCompactionCount(),clientToolCall:clientToolCallDetected??void 0}}finally{removeToolResultContextGuard?.(),await flushPendingToolResultsAfterIdle({agent:session?.agent,sessionManager}),session?.dispose(),await sessionLock.release()}}finally{restoreSkillEnv?.(),process.chdir(prevCwd)}}const RECOVERABLE_TOOL_ERROR_KEYWORDS=[`required`,`missing`,`invalid`,`must be`,`must have`,`needs`,`requires`];function isRecoverableToolError(error){let errorLower=(error??``).toLowerCase();return RECOVERABLE_TOOL_ERROR_KEYWORDS.some(keyword=>errorLower.includes(keyword))}function shouldShowToolErrorWarning(params){if(params.suppressToolErrorWarnings)return!1;let normalizedToolName=params.lastToolError.toolName.trim().toLowerCase(),verboseEnabled=params.verboseLevel===`on`||params.verboseLevel===`full`;return(normalizedToolName===`exec`||normalizedToolName===`bash`)&&!verboseEnabled?!1:params.lastToolError.mutatingAction??isLikelyMutatingToolName(params.lastToolError.toolName)?!0:params.suppressToolErrors?!1:!params.hasUserFacingReply&&!isRecoverableToolError(params.lastToolError.error)}function buildEmbeddedRunPayloads(params){let replyItems=[],useMarkdown=params.toolResultFormat===`markdown`,lastAssistantErrored=params.lastAssistant?.stopReason===`error`,errorText=params.lastAssistant?formatAssistantErrorText(params.lastAssistant,{cfg:params.config,sessionKey:params.sessionKey,provider:params.provider,model:params.model}):void 0,rawErrorMessage=lastAssistantErrored&&params.lastAssistant?.errorMessage?.trim()||void 0,rawErrorFingerprint=rawErrorMessage?getApiErrorPayloadFingerprint(rawErrorMessage):null,formattedRawErrorMessage=rawErrorMessage?formatRawAssistantErrorForUi(rawErrorMessage):null,normalizedFormattedRawErrorMessage=formattedRawErrorMessage?normalizeTextForComparison(formattedRawErrorMessage):null,normalizedRawErrorText=rawErrorMessage?normalizeTextForComparison(rawErrorMessage):null,normalizedErrorText=errorText?normalizeTextForComparison(errorText):null,normalizedGenericBillingErrorText=normalizeTextForComparison(BILLING_ERROR_USER_MESSAGE);if(errorText&&replyItems.push({text:errorText,isError:!0}),params.inlineToolResultsAllowed&&params.verboseLevel!==`off`&&params.toolMetas.length>0)for(let{toolName,meta}of params.toolMetas){let{text:cleanedText,mediaUrls,audioAsVoice,replyToId,replyToTag,replyToCurrent}=parseReplyDirectives(formatToolAggregate(toolName,meta?[meta]:[],{markdown:useMarkdown}));cleanedText&&replyItems.push({text:cleanedText,media:mediaUrls,audioAsVoice,replyToId,replyToTag,replyToCurrent})}let reasoningText=params.lastAssistant&&params.reasoningLevel===`on`?formatReasoningMessage(extractAssistantThinking(params.lastAssistant)):``;reasoningText&&replyItems.push({text:reasoningText});let fallbackAnswerText=params.lastAssistant?extractAssistantText$1(params.lastAssistant):``,shouldSuppressRawErrorText=text=>{if(!lastAssistantErrored)return!1;let trimmed=text.trim();if(!trimmed)return!1;if(errorText){let normalized=normalizeTextForComparison(trimmed);if(normalized&&normalizedErrorText&&normalized===normalizedErrorText||trimmed===`The AI service returned an error. Please try again.`||normalized&&normalizedGenericBillingErrorText&&normalized===normalizedGenericBillingErrorText)return!0}if(rawErrorMessage&&trimmed===rawErrorMessage||formattedRawErrorMessage&&trimmed===formattedRawErrorMessage)return!0;if(normalizedRawErrorText){let normalized=normalizeTextForComparison(trimmed);if(normalized&&normalized===normalizedRawErrorText)return!0}if(normalizedFormattedRawErrorMessage){let normalized=normalizeTextForComparison(trimmed);if(normalized&&normalized===normalizedFormattedRawErrorMessage)return!0}if(rawErrorFingerprint){let fingerprint=getApiErrorPayloadFingerprint(trimmed);if(fingerprint&&fingerprint===rawErrorFingerprint)return!0}return isRawApiErrorPayload(trimmed)},answerTexts=(params.assistantTexts.length?params.assistantTexts:fallbackAnswerText?[fallbackAnswerText]:[]).filter(text=>!shouldSuppressRawErrorText(text)),hasUserFacingAssistantReply=!1;for(let text of answerTexts){let{text:cleanedText,mediaUrls,audioAsVoice,replyToId,replyToTag,replyToCurrent}=parseReplyDirectives(text);!cleanedText&&(!mediaUrls||mediaUrls.length===0)&&!audioAsVoice||(replyItems.push({text:cleanedText,media:mediaUrls,audioAsVoice,replyToId,replyToTag,replyToCurrent}),hasUserFacingAssistantReply=!0)}if(params.lastToolError&&shouldShowToolErrorWarning({lastToolError:params.lastToolError,hasUserFacingReply:hasUserFacingAssistantReply,suppressToolErrors:!!params.config?.messages?.suppressToolErrors,suppressToolErrorWarnings:params.suppressToolErrorWarnings,verboseLevel:params.verboseLevel})){let warningText=`⚠️ ${formatToolAggregate(params.lastToolError.toolName,params.lastToolError.meta?[params.lastToolError.meta]:void 0,{markdown:useMarkdown})} failed${params.lastToolError.error?`: ${params.lastToolError.error}`:``}`,normalizedWarning=normalizeTextForComparison(warningText);normalizedWarning&&replyItems.some(item=>{if(!item.text)return!1;let normalizedExisting=normalizeTextForComparison(item.text);return normalizedExisting.length>0&&normalizedExisting===normalizedWarning})||replyItems.push({text:warningText,isError:!0})}let hasAudioAsVoiceTag=replyItems.some(item=>item.audioAsVoice);return replyItems.map(item=>({text:item.text?.trim()?item.text.trim():void 0,mediaUrls:item.media?.length?item.media:void 0,mediaUrl:item.media?.[0],isError:item.isError,replyToId:item.replyToId,replyToTag:item.replyToTag,replyToCurrent:item.replyToCurrent,audioAsVoice:item.audioAsVoice||!!(hasAudioAsVoiceTag&&item.media?.length)})).filter(p=>!(!p.text&&!p.mediaUrl&&(!p.mediaUrls||p.mediaUrls.length===0)||p.text&&isSilentReplyText(p.text,SILENT_REPLY_TOKEN)))}const ANTHROPIC_MAGIC_STRING_TRIGGER_REFUSAL=`ANTHROPIC_MAGIC_STRING_TRIGGER_REFUSAL`;function scrubAnthropicRefusalMagic(prompt){return prompt.includes(ANTHROPIC_MAGIC_STRING_TRIGGER_REFUSAL)?prompt.replaceAll(ANTHROPIC_MAGIC_STRING_TRIGGER_REFUSAL,`ANTHROPIC MAGIC STRING TRIGGER REFUSAL (redacted)`):prompt}const createUsageAccumulator=()=>({input:0,output:0,cacheRead:0,cacheWrite:0,total:0,lastCacheRead:0,lastCacheWrite:0,lastInput:0});function createCompactionDiagId(){return`ovf-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`}const hasUsageValues=usage=>!!usage&&[usage.input,usage.output,usage.cacheRead,usage.cacheWrite,usage.total].some(value=>typeof value==`number`&&Number.isFinite(value)&&value>0),mergeUsageIntoAccumulator=(target,usage)=>{hasUsageValues(usage)&&(target.input+=usage.input??0,target.output+=usage.output??0,target.cacheRead+=usage.cacheRead??0,target.cacheWrite+=usage.cacheWrite??0,target.total+=usage.total??(usage.input??0)+(usage.output??0)+(usage.cacheRead??0)+(usage.cacheWrite??0),target.lastCacheRead=usage.cacheRead??0,target.lastCacheWrite=usage.cacheWrite??0,target.lastInput=usage.input??0)},toNormalizedUsage=usage=>{if(!(usage.input>0||usage.output>0||usage.cacheRead>0||usage.cacheWrite>0||usage.total>0))return;let lastPromptTokens=usage.lastInput+usage.lastCacheRead+usage.lastCacheWrite;return{input:usage.lastInput||void 0,output:usage.output||void 0,cacheRead:usage.lastCacheRead||void 0,cacheWrite:usage.lastCacheWrite||void 0,total:lastPromptTokens+usage.output||void 0}};function resolveActiveErrorContext(params){return{provider:params.lastAssistant?.provider??params.provider,model:params.lastAssistant?.model??params.model}}async function runEmbeddedAgent(params){let sessionLane=resolveSessionLane(params.sessionKey?.trim()||params.sessionId),globalLane=resolveGlobalLane(params.lane),enqueueGlobal=params.enqueue??((task,opts)=>enqueueCommandInLane(globalLane,task,opts)),enqueueSession=params.enqueue??((task,opts)=>enqueueCommandInLane(sessionLane,task,opts)),channelHint=params.messageChannel??params.messageProvider,resolvedToolResultFormat=params.toolResultFormat??(channelHint?isMarkdownCapableMessageChannel(channelHint)?`markdown`:`plain`:`markdown`),isProbeSession=params.sessionId?.startsWith(`probe-`)??!1,outcome={actionType:DEFAULT_ACTION_TYPE,provider:``,model:``,steps:0,degraded:!1},reportOutcome=(terminalStatus,error)=>{if(!outcome.model||isProbeSession)return;let rateLimited=isFailoverError(error)&&error.reason===`rate_limit`;completeLearnedRun({runId:params.runId,model:`${outcome.provider}/${outcome.model}`,actionType:outcome.actionType,terminalStatus,rateLimited,degraded:outcome.degraded,steps:outcome.steps})};return enqueueSession(()=>enqueueGlobal(async()=>{let started=Date.now(),workspaceResolution=resolveRunWorkspaceDir({workspaceDir:params.workspaceDir,sessionKey:params.sessionKey,agentId:params.agentId,config:params.config}),resolvedWorkspace=workspaceResolution.workspaceDir,redactedSessionId=redactRunIdentifier(params.sessionId),redactedSessionKey=redactRunIdentifier(params.sessionKey),redactedWorkspace=redactRunIdentifier(resolvedWorkspace);workspaceResolution.usedFallback&&log$3.warn(`[workspace-fallback] caller=runEmbeddedAgent reason=${workspaceResolution.fallbackReason} run=${params.runId} session=${redactedSessionId} sessionKey=${redactedSessionKey} agent=${workspaceResolution.agentId} workspace=${redactedWorkspace}`);let prevCwd=process.cwd(),provider=(params.provider??DEFAULT_PROVIDER).trim()||DEFAULT_PROVIDER,modelId=(params.model??DEFAULT_MODEL).trim()||DEFAULT_MODEL,agentDir=params.agentDir??resolveBuilderForceAgentsAgentDir(),fallbackConfigured=(params.config?.agents?.defaults?.model?.fallbacks?.length??0)>0;await ensureBuilderForceAgentsModelsJson(params.config,agentDir);let modelResolveOverride,hookRunner=getGlobalHookRunner(),hookCtx={agentId:workspaceResolution.agentId,sessionKey:params.sessionKey,sessionId:params.sessionId,workspaceDir:resolvedWorkspace,messageProvider:params.messageProvider??void 0};if(hookRunner?.hasHooks(`before_model_resolve`))try{modelResolveOverride=await hookRunner.runBeforeModelResolve({prompt:params.prompt},hookCtx)}catch(hookErr){log$3.warn(`before_model_resolve hook failed: ${String(hookErr)}`)}if(hookRunner?.hasHooks(`before_agent_start`))try{let legacyResult=await hookRunner.runBeforeAgentStart({prompt:params.prompt},hookCtx);modelResolveOverride={providerOverride:modelResolveOverride?.providerOverride??legacyResult?.providerOverride,modelOverride:modelResolveOverride?.modelOverride??legacyResult?.modelOverride}}catch(hookErr){log$3.warn(`before_agent_start hook (legacy model resolve path) failed: ${String(hookErr)}`)}modelResolveOverride?.providerOverride&&(provider=modelResolveOverride.providerOverride,log$3.info(`[hooks] provider overridden to ${provider}`)),modelResolveOverride?.modelOverride&&(modelId=modelResolveOverride.modelOverride,log$3.info(`[hooks] model overridden to ${modelId}`));let learnedSeed=await resolveLearnedModelSeed({provider,modelId,prompt:params.prompt,cfg:params.config});outcome.actionType=learnedSeed.actionType,learnedSeed.reordered&&(learnedSeed.provider!==provider||learnedSeed.modelId!==modelId)&&(log$3.info(`[learned-routing] seeding ${learnedSeed.provider}/${learnedSeed.modelId} over ${provider}/${modelId} (action=${learnedSeed.actionType} scope=${learnedSeed.scope??`none`})`),provider=learnedSeed.provider,modelId=learnedSeed.modelId);let{model,error,authStorage,modelRegistry}=resolveModel(provider,modelId,agentDir,params.config);if(!model)throw Error(error??`Unknown model: ${provider}/${modelId}`);outcome.provider=provider,outcome.model=model.id;let ctxInfo=resolveContextWindowInfo({cfg:params.config,provider,modelId,modelContextWindow:model.contextWindow,defaultTokens:DEFAULT_CONTEXT_TOKENS}),ctxGuard=evaluateContextWindowGuard({info:ctxInfo,warnBelowTokens:CONTEXT_WINDOW_WARN_BELOW_TOKENS,hardMinTokens:CONTEXT_WINDOW_HARD_MIN_TOKENS});if(ctxGuard.shouldWarn&&log$3.warn(`low context window: ${provider}/${modelId} ctx=${ctxGuard.tokens} (warn<${CONTEXT_WINDOW_WARN_BELOW_TOKENS}) source=${ctxGuard.source}`),ctxGuard.shouldBlock)throw log$3.error(`blocked model (context window too small): ${provider}/${modelId} ctx=${ctxGuard.tokens} (min=${CONTEXT_WINDOW_HARD_MIN_TOKENS}) source=${ctxGuard.source}`),new FailoverError(`Model context window too small (${ctxGuard.tokens} tokens). Minimum is ${CONTEXT_WINDOW_HARD_MIN_TOKENS}.`,{reason:`unknown`,provider,model:modelId});let authStore=await ensureAuthProfileStore(agentDir,{allowKeychainPrompt:!1}),preferredProfileId=params.authProfileId?.trim(),lockedProfileId=params.authProfileIdSource===`user`?preferredProfileId:void 0;if(lockedProfileId){let lockedProfile=authStore.profiles[lockedProfileId];(!lockedProfile||normalizeProviderId(lockedProfile.provider)!==normalizeProviderId(provider))&&(lockedProfileId=void 0)}let profileOrder=resolveAuthProfileOrder({cfg:params.config,store:authStore,provider,preferredProfile:preferredProfileId});if(lockedProfileId&&!profileOrder.includes(lockedProfileId))throw Error(`Auth profile "${lockedProfileId}" is not configured for ${provider}.`);let profileCandidates=lockedProfileId?[lockedProfileId]:profileOrder.length>0?profileOrder:[void 0],profileIndex=0,initialThinkLevel=params.thinkLevel??`off`,thinkLevel=initialThinkLevel,attemptedThinking=new Set,apiKeyInfo=null,lastProfileId,resolveAuthProfileFailoverReason=params=>params.allInCooldown?`rate_limit`:classifyFailoverReason(params.message)??`auth`,throwAuthProfileFailover=params=>{let fallbackMessage=`No available auth profile for ${provider} (all in cooldown or unavailable).`,message=params.message?.trim()||(params.error?describeUnknownError(params.error).trim():``)||fallbackMessage,reason=resolveAuthProfileFailoverReason({allInCooldown:params.allInCooldown,message});throw fallbackConfigured?new FailoverError(message,{reason,provider,model:modelId,status:resolveFailoverStatus(reason),cause:params.error}):params.error instanceof Error?params.error:Error(message)},resolveApiKeyForCandidate=async candidate=>getApiKeyForModel({model,cfg:params.config,profileId:candidate,store:authStore,agentDir}),applyApiKeyInfo=async candidate=>{apiKeyInfo=await resolveApiKeyForCandidate(candidate);let resolvedProfileId=apiKeyInfo.profileId??candidate;if(!apiKeyInfo.apiKey){if(apiKeyInfo.mode!==`aws-sdk`)throw Error(`No API key resolved for provider "${model.provider}" (auth mode: ${apiKeyInfo.mode}).`);lastProfileId=resolvedProfileId;return}if(model.provider===`github-copilot`){let{resolveCopilotApiToken}=await import(`./github-copilot-token-5vPF7Jf3.js`),copilotToken=await resolveCopilotApiToken({githubToken:apiKeyInfo.apiKey});authStorage.setRuntimeApiKey(model.provider,copilotToken.token)}else authStorage.setRuntimeApiKey(model.provider,apiKeyInfo.apiKey);lastProfileId=apiKeyInfo.profileId},advanceAuthProfile=async()=>{if(lockedProfileId)return!1;let nextIndex=profileIndex+1;for(;nextIndex<profileCandidates.length;){let candidate=profileCandidates[nextIndex];if(candidate&&isProfileInCooldown(authStore,candidate)){nextIndex+=1;continue}try{return await applyApiKeyInfo(candidate),profileIndex=nextIndex,thinkLevel=initialThinkLevel,attemptedThinking.clear(),!0}catch(err){if(candidate&&candidate===lockedProfileId)throw err;nextIndex+=1}}return!1};try{for(;profileIndex<profileCandidates.length;){let candidate=profileCandidates[profileIndex];if(candidate&&candidate!==lockedProfileId&&isProfileInCooldown(authStore,candidate)){profileIndex+=1;continue}await applyApiKeyInfo(profileCandidates[profileIndex]);break}profileIndex>=profileCandidates.length&&throwAuthProfileFailover({allInCooldown:!0})}catch(err){if(err instanceof FailoverError)throw err;profileCandidates[profileIndex]===lockedProfileId&&throwAuthProfileFailover({allInCooldown:!1,error:err}),await advanceAuthProfile()||throwAuthProfileFailover({allInCooldown:!1,error:err})}let MAX_AUTO_CONTINUE_NUDGES=params.config?.agents?.defaults?.maxAutoContinueNudges??3,overflowCompactionAttempts=0,toolResultTruncationAttempted=!1,autoContinueNudges=0,currentPrompt=params.prompt,usageAccumulator=createUsageAccumulator(),lastRunPromptUsage,autoCompactionCount=0;try{for(;;){attemptedThinking.add(thinkLevel),await fs$1.mkdir(resolvedWorkspace,{recursive:!0});let prompt=provider===`anthropic`?scrubAnthropicRefusalMagic(currentPrompt):currentPrompt,attempt=await runEmbeddedAttempt({sessionId:params.sessionId,sessionKey:params.sessionKey,messageChannel:params.messageChannel,messageProvider:params.messageProvider,agentAccountId:params.agentAccountId,messageTo:params.messageTo,messageThreadId:params.messageThreadId,groupId:params.groupId,groupChannel:params.groupChannel,groupSpace:params.groupSpace,spawnedBy:params.spawnedBy,senderIsOwner:params.senderIsOwner,currentChannelId:params.currentChannelId,currentThreadTs:params.currentThreadTs,replyToMode:params.replyToMode,hasRepliedRef:params.hasRepliedRef,sessionFile:params.sessionFile,workspaceDir:resolvedWorkspace,agentDir,config:params.config,skillsSnapshot:params.skillsSnapshot,prompt,images:params.images,disableTools:params.disableTools,provider,modelId,model,authStorage,modelRegistry,agentId:workspaceResolution.agentId,thinkLevel,verboseLevel:params.verboseLevel,reasoningLevel:params.reasoningLevel,toolResultFormat:resolvedToolResultFormat,execOverrides:params.execOverrides,bashElevated:params.bashElevated,timeoutMs:params.timeoutMs,runId:params.runId,abortSignal:params.abortSignal,shouldEmitToolResult:params.shouldEmitToolResult,shouldEmitToolOutput:params.shouldEmitToolOutput,onPartialReply:params.onPartialReply,onAssistantMessageStart:params.onAssistantMessageStart,onBlockReply:params.onBlockReply,onBlockReplyFlush:params.onBlockReplyFlush,blockReplyBreak:params.blockReplyBreak,blockReplyChunking:params.blockReplyChunking,onReasoningStream:params.onReasoningStream,onReasoningEnd:params.onReasoningEnd,onToolResult:params.onToolResult,onAgentEvent:params.onAgentEvent,extraSystemPrompt:params.extraSystemPrompt,inputProvenance:params.inputProvenance,streamParams:params.streamParams,ownerNumbers:params.ownerNumbers,enforceFinalTag:params.enforceFinalTag}),{aborted,promptError,timedOut,timedOutDuringCompaction,sessionIdUsed,lastAssistant}=attempt,lastAssistantUsage=normalizeUsage(lastAssistant?.usage),attemptUsage=attempt.attemptUsage??lastAssistantUsage;mergeUsageIntoAccumulator(usageAccumulator,attemptUsage),lastRunPromptUsage=lastAssistantUsage??attemptUsage;let lastTurnTotal=lastAssistantUsage?.total??attemptUsage?.total,attemptCompactionCount=Math.max(0,attempt.compactionCount??0);autoCompactionCount+=attemptCompactionCount;let activeErrorContext=resolveActiveErrorContext({lastAssistant,provider,model:modelId}),formattedAssistantErrorText=lastAssistant?formatAssistantErrorText(lastAssistant,{cfg:params.config,sessionKey:params.sessionKey??params.sessionId,provider:activeErrorContext.provider,model:activeErrorContext.model}):void 0,assistantErrorText=lastAssistant?.stopReason===`error`?lastAssistant.errorMessage?.trim()||formattedAssistantErrorText:void 0,contextOverflowError=aborted?null:(()=>{if(promptError){let errorText=describeUnknownError(promptError);return isLikelyContextOverflowError(errorText)?{text:errorText,source:`promptError`}:null}return assistantErrorText&&isLikelyContextOverflowError(assistantErrorText)?{text:assistantErrorText,source:`assistantError`}:null})();if(contextOverflowError){let overflowDiagId=createCompactionDiagId(),errorText=contextOverflowError.text,msgCount=attempt.messagesSnapshot?.length??0;log$3.warn(`[context-overflow-diag] sessionKey=${params.sessionKey??params.sessionId} provider=${provider}/${modelId} source=${contextOverflowError.source} messages=${msgCount} sessionFile=${params.sessionFile} diagId=${overflowDiagId} compactionAttempts=${overflowCompactionAttempts} error=${errorText.slice(0,200)}`);let isCompactionFailure=isCompactionFailureError(errorText),hadAttemptLevelCompaction=attemptCompactionCount>0;if(!isCompactionFailure&&hadAttemptLevelCompaction&&overflowCompactionAttempts<3){overflowCompactionAttempts++,log$3.warn(`context overflow persisted after in-attempt compaction (attempt ${overflowCompactionAttempts}/3); retrying prompt without additional compaction for ${provider}/${modelId}`);continue}if(!isCompactionFailure&&!hadAttemptLevelCompaction&&overflowCompactionAttempts<3){log$3.isEnabled(`debug`)&&log$3.debug(`[compaction-diag] decision diagId=${overflowDiagId} branch=compact isCompactionFailure=${isCompactionFailure} hasOversizedToolResults=unknown attempt=${overflowCompactionAttempts+1} maxAttempts=3`),overflowCompactionAttempts++,log$3.warn(`context overflow detected (attempt ${overflowCompactionAttempts}/3); attempting auto-compaction for ${provider}/${modelId}`);let compactResult=await compactEmbeddedSessionDirect({sessionId:params.sessionId,sessionKey:params.sessionKey,messageChannel:params.messageChannel,messageProvider:params.messageProvider,agentAccountId:params.agentAccountId,authProfileId:lastProfileId,sessionFile:params.sessionFile,workspaceDir:resolvedWorkspace,agentDir,config:params.config,skillsSnapshot:params.skillsSnapshot,senderIsOwner:params.senderIsOwner,provider,model:modelId,runId:params.runId,thinkLevel,reasoningLevel:params.reasoningLevel,bashElevated:params.bashElevated,extraSystemPrompt:params.extraSystemPrompt,ownerNumbers:params.ownerNumbers,trigger:`overflow`,diagId:overflowDiagId,attempt:overflowCompactionAttempts,maxAttempts:3});if(compactResult.compacted){autoCompactionCount+=1,log$3.info(`auto-compaction succeeded for ${provider}/${modelId}; retrying prompt`);continue}log$3.warn(`auto-compaction failed for ${provider}/${modelId}: ${compactResult.reason??`nothing to compact`}`)}if(!toolResultTruncationAttempted){let contextWindowTokens=ctxInfo.tokens,hasOversized=attempt.messagesSnapshot?sessionLikelyHasOversizedToolResults({messages:attempt.messagesSnapshot,contextWindowTokens}):!1;if(hasOversized){log$3.isEnabled(`debug`)&&log$3.debug(`[compaction-diag] decision diagId=${overflowDiagId} branch=truncate_tool_results isCompactionFailure=${isCompactionFailure} hasOversizedToolResults=${hasOversized} attempt=${overflowCompactionAttempts} maxAttempts=3`),toolResultTruncationAttempted=!0,log$3.warn(`[context-overflow-recovery] Attempting tool result truncation for ${provider}/${modelId} (contextWindow=${contextWindowTokens} tokens)`);let truncResult=await truncateOversizedToolResultsInSession({sessionFile:params.sessionFile,contextWindowTokens,sessionId:params.sessionId,sessionKey:params.sessionKey});if(truncResult.truncated){log$3.info(`[context-overflow-recovery] Truncated ${truncResult.truncatedCount} tool result(s); retrying prompt`),overflowCompactionAttempts=0;continue}log$3.warn(`[context-overflow-recovery] Tool result truncation did not help: ${truncResult.reason??`unknown`}`)}else log$3.isEnabled(`debug`)&&log$3.debug(`[compaction-diag] decision diagId=${overflowDiagId} branch=give_up isCompactionFailure=${isCompactionFailure} hasOversizedToolResults=${hasOversized} attempt=${overflowCompactionAttempts} maxAttempts=3`)}(isCompactionFailure||overflowCompactionAttempts>=3||toolResultTruncationAttempted)&&log$3.isEnabled(`debug`)&&log$3.debug(`[compaction-diag] decision diagId=${overflowDiagId} branch=give_up isCompactionFailure=${isCompactionFailure} hasOversizedToolResults=unknown attempt=${overflowCompactionAttempts} maxAttempts=3`);let kind=isCompactionFailure?`compaction_failure`:`context_overflow`;return{payloads:[{text:`Context overflow: prompt too large for the model. Try /reset (or /new) to start a fresh session, or use a larger-context model.`,isError:!0}],meta:{durationMs:Date.now()-started,agentMeta:{sessionId:sessionIdUsed,provider,model:model.id},systemPromptReport:attempt.systemPromptReport,error:{kind,message:errorText}}}}if(promptError&&!aborted){let errorText=describeUnknownError(promptError);if(/incorrect role information|roles must alternate/i.test(errorText))return{payloads:[{text:`Message ordering conflict - please try again. If this persists, use /new to start a fresh session.`,isError:!0}],meta:{durationMs:Date.now()-started,agentMeta:{sessionId:sessionIdUsed,provider,model:model.id},systemPromptReport:attempt.systemPromptReport,error:{kind:`role_ordering`,message:errorText}}};let imageSizeError=parseImageSizeError(errorText);if(imageSizeError){let maxMb=imageSizeError.maxMb,maxMbLabel=typeof maxMb==`number`&&Number.isFinite(maxMb)?`${maxMb}`:null;return{payloads:[{text:`Image too large for the model${maxMbLabel?` (max ${maxMbLabel}MB)`:``}. Please compress or resize the image and try again.`,isError:!0}],meta:{durationMs:Date.now()-started,agentMeta:{sessionId:sessionIdUsed,provider,model:model.id},systemPromptReport:attempt.systemPromptReport,error:{kind:`image_size`,message:errorText}}}}let promptFailoverReason=classifyFailoverReason(errorText);if(promptFailoverReason&&promptFailoverReason!==`timeout`&&lastProfileId&&await markAuthProfileFailure({store:authStore,profileId:lastProfileId,reason:promptFailoverReason,cfg:params.config,agentDir:params.agentDir}),isFailoverErrorMessage(errorText)&&promptFailoverReason!==`timeout`&&await advanceAuthProfile())continue;let fallbackThinking=pickFallbackThinkingLevel({message:errorText,attempted:attemptedThinking});if(fallbackThinking){log$3.warn(`unsupported thinking level for ${provider}/${modelId}; retrying with ${fallbackThinking}`),thinkLevel=fallbackThinking;continue}throw fallbackConfigured&&isFailoverErrorMessage(errorText)?new FailoverError(errorText,{reason:promptFailoverReason??`unknown`,provider,model:modelId,profileId:lastProfileId,status:resolveFailoverStatus(promptFailoverReason??`unknown`)}):promptError}let fallbackThinking=pickFallbackThinkingLevel({message:lastAssistant?.errorMessage,attempted:attemptedThinking});if(fallbackThinking&&!aborted){log$3.warn(`unsupported thinking level for ${provider}/${modelId}; retrying with ${fallbackThinking}`),thinkLevel=fallbackThinking;continue}let authFailure=isAuthAssistantError(lastAssistant),rateLimitFailure=isRateLimitAssistantError(lastAssistant),billingFailure=isBillingAssistantError(lastAssistant),failoverFailure=isFailoverAssistantError(lastAssistant),assistantFailoverReason=classifyFailoverReason(lastAssistant?.errorMessage??``),cloudCodeAssistFormatError=attempt.cloudCodeAssistFormatError,imageDimensionError=parseImageDimensionError(lastAssistant?.errorMessage??``);if(imageDimensionError&&lastProfileId){let details=[imageDimensionError.messageIndex===void 0?null:`message=${imageDimensionError.messageIndex}`,imageDimensionError.contentIndex===void 0?null:`content=${imageDimensionError.contentIndex}`,imageDimensionError.maxDimensionPx===void 0?null:`limit=${imageDimensionError.maxDimensionPx}px`].filter(Boolean).join(` `);log$3.warn(`Profile ${lastProfileId} rejected image payload${details?` (${details})`:``}.`)}if(!aborted&&failoverFailure||timedOut&&!timedOutDuringCompaction){if(lastProfileId&&(await markAuthProfileFailure({store:authStore,profileId:lastProfileId,reason:timedOut||assistantFailoverReason===`timeout`?`timeout`:assistantFailoverReason??`unknown`,cfg:params.config,agentDir:params.agentDir}),timedOut&&!isProbeSession&&log$3.warn(`Profile ${lastProfileId} timed out (possible rate limit). Trying next account...`),cloudCodeAssistFormatError&&log$3.warn(`Profile ${lastProfileId} hit Cloud Code Assist format error. Tool calls will be sanitized on retry.`)),await advanceAuthProfile())continue;if(fallbackConfigured){let message=(lastAssistant?formatAssistantErrorText(lastAssistant,{cfg:params.config,sessionKey:params.sessionKey??params.sessionId,provider:activeErrorContext.provider,model:activeErrorContext.model}):void 0)||lastAssistant?.errorMessage?.trim()||(timedOut?`LLM request timed out.`:rateLimitFailure?`LLM request rate limited.`:billingFailure?formatBillingErrorMessage(activeErrorContext.provider,activeErrorContext.model):authFailure?`LLM request unauthorized.`:`LLM request failed.`),status=resolveFailoverStatus(assistantFailoverReason??`unknown`)??(isTimeoutErrorMessage(message)?408:void 0);throw new FailoverError(message,{reason:assistantFailoverReason??`unknown`,provider:activeErrorContext.provider,model:activeErrorContext.model,profileId:lastProfileId,status})}}let usage=toNormalizedUsage(usageAccumulator);usage&&lastTurnTotal&&lastTurnTotal>0&&(usage.total=lastTurnTotal);let lastCallUsage=normalizeUsage(lastAssistant?.usage),promptTokens=derivePromptTokens(lastRunPromptUsage);outcome.provider=lastAssistant?.provider??provider,outcome.model=lastAssistant?.model??model.id,outcome.steps=(Array.isArray(attempt.toolMetas)?attempt.toolMetas.length:0)+autoContinueNudges+1,outcome.model!==model.id&&(outcome.degraded=!0);let agentMeta={sessionId:sessionIdUsed,provider:lastAssistant?.provider??provider,model:lastAssistant?.model??model.id,usage,lastCallUsage:lastCallUsage??void 0,promptTokens,compactionCount:autoCompactionCount>0?autoCompactionCount:void 0},payloads=buildEmbeddedRunPayloads({assistantTexts:attempt.assistantTexts,toolMetas:attempt.toolMetas,lastAssistant:attempt.lastAssistant,lastToolError:attempt.lastToolError,config:params.config,sessionKey:params.sessionKey??params.sessionId,provider:activeErrorContext.provider,model:activeErrorContext.model,verboseLevel:params.verboseLevel,reasoningLevel:params.reasoningLevel,toolResultFormat:resolvedToolResultFormat,suppressToolErrorWarnings:params.suppressToolErrorWarnings,inlineToolResultsAllowed:!1}),toolMetas=Array.isArray(attempt.toolMetas)?attempt.toolMetas:[],continuationDecision=shouldAutoContinueRun({userPrompt:params.prompt,assistantTexts:attempt.assistantTexts,payloadTexts:payloads.map(payload=>typeof payload.text==`string`?payload.text:``).filter(text=>text.length>0),toolNames:toolMetas.map(entry=>entry.toolName),hasToolError:!!attempt.lastToolError,aborted,timedOut,promptErrored:!!promptError,hasPendingClientToolCall:!!attempt.clientToolCall});if(log$3.debug(`auto-continue decision: shouldContinue=${continuationDecision.shouldContinue} reason=${continuationDecision.reason??`none`} runId=${params.runId} sessionId=${params.sessionId} toolCalls=${toolMetas.length}`),continuationDecision.shouldContinue&&autoContinueNudges<MAX_AUTO_CONTINUE_NUDGES){autoContinueNudges+=1;let latestPayloadText=payloads.map(payload=>typeof payload.text==`string`?payload.text.trim():``).find(text=>text.length>0),latestAssistantText=[...attempt.assistantTexts].toReversed().map(text=>text.trim()).find(text=>text.length>0);currentPrompt=buildAutoContinuePrompt({originalPrompt:params.prompt,lastAssistantText:latestAssistantText??latestPayloadText,reason:continuationDecision.reason}),log$3.warn(`auto-continue nudge ${autoContinueNudges}/${MAX_AUTO_CONTINUE_NUDGES}: reason=${continuationDecision.reason??`policy`} runId=${params.runId} sessionId=${params.sessionId}`);continue}if(timedOut&&!timedOutDuringCompaction&&payloads.length===0)return{payloads:[{text:"Request timed out before a response was generated. Please try again, or increase `agents.defaults.timeoutSeconds` in your config.",isError:!0}],meta:{durationMs:Date.now()-started,agentMeta,aborted,systemPromptReport:attempt.systemPromptReport},didSendViaMessagingTool:attempt.didSendViaMessagingTool,messagingToolSentTexts:attempt.messagingToolSentTexts,messagingToolSentMediaUrls:attempt.messagingToolSentMediaUrls,messagingToolSentTargets:attempt.messagingToolSentTargets,successfulCronAdds:attempt.successfulCronAdds};log$3.debug(`embedded run done: runId=${params.runId} sessionId=${params.sessionId} durationMs=${Date.now()-started} aborted=${aborted}`),lastProfileId&&(await markAuthProfileGood({store:authStore,provider,profileId:lastProfileId,agentDir:params.agentDir}),await markAuthProfileUsed({store:authStore,profileId:lastProfileId,agentDir:params.agentDir}));let finalPayloads=payloads.length?payloads:void 0;return(!finalPayloads||finalPayloads.length===0)&&(finalPayloads=[{text:autoContinueNudges>=MAX_AUTO_CONTINUE_NUDGES?`The agent reached the maximum auto-continue limit (${MAX_AUTO_CONTINUE_NUDGES}) without producing a final response. Consider breaking the task into smaller steps or increasing \`agents.defaults.maxAutoContinueNudges\` in your config.`:`The agent completed without producing any output. This may indicate an issue with the model response or tool execution.`,isError:!0}]),{payloads:finalPayloads,meta:{durationMs:Date.now()-started,agentMeta,aborted,systemPromptReport:attempt.systemPromptReport,stopReason:attempt.clientToolCall?`tool_calls`:void 0,pendingToolCalls:attempt.clientToolCall?[{id:`call_${Date.now()}`,name:attempt.clientToolCall.name,arguments:JSON.stringify(attempt.clientToolCall.params)}]:void 0},didSendViaMessagingTool:attempt.didSendViaMessagingTool,messagingToolSentTexts:attempt.messagingToolSentTexts,messagingToolSentMediaUrls:attempt.messagingToolSentMediaUrls,messagingToolSentTargets:attempt.messagingToolSentTargets,successfulCronAdds:attempt.successfulCronAdds}}}finally{process.chdir(prevCwd)}})).then(result=>(reportOutcome(result.meta?.aborted?`cancelled`:`completed`),result),error=>{throw reportOutcome(`failed`,error),error})}const DEFAULT_QUEUE_DEBOUNCE_MS=1e3,DEFAULT_QUEUE_DROP=`summarize`,FOLLOWUP_QUEUES=new Map;function getFollowupQueue(key,settings){let existing=FOLLOWUP_QUEUES.get(key);if(existing)return applyQueueRuntimeSettings({target:existing,settings}),existing;let created={items:[],draining:!1,lastEnqueuedAt:0,mode:settings.mode,debounceMs:typeof settings.debounceMs==`number`?Math.max(0,settings.debounceMs):DEFAULT_QUEUE_DEBOUNCE_MS,cap:typeof settings.cap==`number`&&settings.cap>0?Math.floor(settings.cap):20,dropPolicy:settings.dropPolicy??DEFAULT_QUEUE_DROP,droppedCount:0,summaryLines:[]};return applyQueueRuntimeSettings({target:created,settings}),FOLLOWUP_QUEUES.set(key,created),created}function clearFollowupQueue(key){let cleaned=key.trim();if(!cleaned)return 0;let queue=FOLLOWUP_QUEUES.get(cleaned);if(!queue)return 0;let cleared=queue.items.length+queue.droppedCount;return queue.items.length=0,queue.droppedCount=0,queue.summaryLines=[],queue.lastRun=void 0,queue.lastEnqueuedAt=0,FOLLOWUP_QUEUES.delete(cleaned),cleared}function clearSessionQueues(keys){let seen=new Set,followupCleared=0,laneCleared=0,clearedKeys=[];for(let key of keys){let cleaned=key?.trim();!cleaned||seen.has(cleaned)||(seen.add(cleaned),clearedKeys.push(cleaned),followupCleared+=clearFollowupQueue(cleaned),laneCleared+=clearCommandLane(resolveEmbeddedSessionLane(cleaned)))}return{followupCleared,laneCleared,keys:clearedKeys}}function scheduleFollowupDrain(key,runFollowup){let queue=FOLLOWUP_QUEUES.get(key);!queue||queue.draining||(queue.draining=!0,(async()=>{try{let forceIndividualCollect=!1;for(;queue.items.length>0||queue.droppedCount>0;){if(await waitForQueueDebounce(queue),queue.mode===`collect`){if(forceIndividualCollect){let next=queue.items[0];if(!next)break;await runFollowup(next),queue.items.shift();continue}if(hasCrossChannelItems(queue.items,item=>{let channel=item.originatingChannel,to=item.originatingTo,accountId=item.originatingAccountId,threadId=item.originatingThreadId;if(!channel&&!to&&!accountId&&threadId==null)return{};if(!isRoutableChannel(channel)||!to)return{cross:!0};let threadKey=threadId==null?``:String(threadId);return{key:[channel,to,accountId||``,threadKey].join(`|`)}})){forceIndividualCollect=!0;let next=queue.items[0];if(!next)break;await runFollowup(next),queue.items.shift();continue}let items=queue.items.slice(),summary=previewQueueSummaryPrompt({state:queue,noun:`message`}),run=items.at(-1)?.run??queue.lastRun;if(!run)break;let originatingChannel=items.find(i=>i.originatingChannel)?.originatingChannel,originatingTo=items.find(i=>i.originatingTo)?.originatingTo,originatingAccountId=items.find(i=>i.originatingAccountId)?.originatingAccountId,originatingThreadId=items.find(i=>i.originatingThreadId!=null)?.originatingThreadId;await runFollowup({prompt:buildCollectPrompt({title:`[Queued messages while agent was busy]`,items,summary,renderItem:(item,idx)=>`---\nQueued #${idx+1}\n${item.prompt}`.trim()}),run,enqueuedAt:Date.now(),originatingChannel,originatingTo,originatingAccountId,originatingThreadId}),queue.items.splice(0,items.length),summary&&clearQueueSummaryState(queue);continue}let summaryPrompt=previewQueueSummaryPrompt({state:queue,noun:`message`});if(summaryPrompt){let run=queue.lastRun;if(!run||!queue.items[0])break;await runFollowup({prompt:summaryPrompt,run,enqueuedAt:Date.now()}),queue.items.shift(),clearQueueSummaryState(queue);continue}let next=queue.items[0];if(!next)break;await runFollowup(next),queue.items.shift()}}catch(err){queue.lastEnqueuedAt=Date.now(),defaultRuntime.error?.(`followup queue drain failed for ${key}: ${String(err)}`)}finally{queue.draining=!1,queue.items.length===0&&queue.droppedCount===0?FOLLOWUP_QUEUES.delete(key):scheduleFollowupDrain(key,runFollowup)}})())}function isRunAlreadyQueued(run,items,allowPromptFallback=!1){let hasSameRouting=item=>item.originatingChannel===run.originatingChannel&&item.originatingTo===run.originatingTo&&item.originatingAccountId===run.originatingAccountId&&item.originatingThreadId===run.originatingThreadId,messageId=run.messageId?.trim();return messageId?items.some(item=>item.messageId?.trim()===messageId&&hasSameRouting(item)):allowPromptFallback?items.some(item=>item.prompt===run.prompt&&hasSameRouting(item)):!1}function enqueueFollowupRun(key,run,settings,dedupeMode=`message-id`){let queue=getFollowupQueue(key,settings),dedupe=dedupeMode===`none`?void 0:(item,items)=>isRunAlreadyQueued(item,items,dedupeMode===`prompt`);return shouldSkipQueueItem({item:run,items:queue.items,dedupe})||(queue.lastEnqueuedAt=Date.now(),queue.lastRun=run.run,!applyQueueDropPolicy({queue,summarize:item=>item.summaryLine?.trim()||item.prompt.trim()}))?!1:(queue.items.push(run),!0)}function getFollowupQueueDepth(key){let cleaned=key.trim();if(!cleaned)return 0;let queue=FOLLOWUP_QUEUES.get(cleaned);return queue?queue.items.length:0}function defaultQueueModeForChannel(_channel){return`collect`}function resolveChannelDebounce(byChannel,channelKey){if(!channelKey||!byChannel)return;let value=byChannel[channelKey];return typeof value==`number`&&Number.isFinite(value)?Math.max(0,value):void 0}function resolvePluginDebounce(channelKey){if(!channelKey)return;let value=getChannelPlugin(channelKey)?.defaults?.queue?.debounceMs;return typeof value==`number`&&Number.isFinite(value)?Math.max(0,value):void 0}function resolveQueueSettings(params){let channelKey=params.channel?.trim().toLowerCase(),queueCfg=params.cfg.messages?.queue,providerModeRaw=channelKey&&queueCfg?.byChannel?queueCfg.byChannel[channelKey]:void 0,resolvedMode=params.inlineMode??normalizeQueueMode(params.sessionEntry?.queueMode)??normalizeQueueMode(providerModeRaw)??normalizeQueueMode(queueCfg?.mode)??defaultQueueModeForChannel(channelKey),debounceRaw=params.inlineOptions?.debounceMs??params.sessionEntry?.queueDebounceMs??resolveChannelDebounce(queueCfg?.debounceMsByChannel,channelKey)??resolvePluginDebounce(channelKey)??queueCfg?.debounceMs??DEFAULT_QUEUE_DEBOUNCE_MS,capRaw=params.inlineOptions?.cap??params.sessionEntry?.queueCap??queueCfg?.cap??20,dropRaw=params.inlineOptions?.dropPolicy??params.sessionEntry?.queueDrop??normalizeQueueDropPolicy(queueCfg?.drop)??DEFAULT_QUEUE_DROP;return{mode:resolvedMode,debounceMs:typeof debounceRaw==`number`?Math.max(0,debounceRaw):void 0,cap:typeof capRaw==`number`?Math.max(1,Math.floor(capRaw)):void 0,dropPolicy:dropRaw}}function buildAnnounceIdFromChildRun(params){return`v1:${params.childSessionKey}:${params.childRunId}`}function buildAnnounceIdempotencyKey(announceId){return`announce:${announceId}`}function resolveQueueAnnounceId(params){return params.announceId?.trim()||`legacy:${params.sessionKey}:${params.enqueuedAt}`}function buildCompletionDeliveryMessage(params){let findingsText=params.findings.trim(),hasFindings=findingsText.length>0&&findingsText!==`(no output)`,header=`✅ Subagent ${params.subagentName} finished`;return hasFindings?`${header}\n\n${findingsText}`:header}function summarizeDeliveryError(error){if(error instanceof Error)return error.message||`error`;if(typeof error==`string`)return error;if(error==null)return`unknown error`;try{return JSON.stringify(error)}catch{return`error`}}function extractToolResultText(content){if(typeof content==`string`)return sanitizeTextContent(content);if(content&&typeof content==`object`&&!Array.isArray(content)){let obj=content;if(typeof obj.text==`string`)return sanitizeTextContent(obj.text);if(typeof obj.output==`string`)return sanitizeTextContent(obj.output);if(typeof obj.content==`string`)return sanitizeTextContent(obj.content);if(typeof obj.result==`string`)return sanitizeTextContent(obj.result);if(typeof obj.error==`string`)return sanitizeTextContent(obj.error);if(typeof obj.summary==`string`)return sanitizeTextContent(obj.summary)}return Array.isArray(content)?extractTextFromChatContent(content,{sanitizeText:sanitizeTextContent,normalizeText:text=>text,joinWith:`
541
541
  `})?.trim()??``:``}function extractInlineTextContent(content){return Array.isArray(content)?extractTextFromChatContent(content,{sanitizeText:sanitizeTextContent,normalizeText:text=>text.trim(),joinWith:``})??``:``}function extractSubagentOutputText(message){if(!message||typeof message!=`object`)return``;let role=message.role,content=message.content;return role===`assistant`?extractAssistantText(message)||(typeof content==`string`?sanitizeTextContent(content):Array.isArray(content)?extractInlineTextContent(content):``):role===`toolResult`||role===`tool`?extractToolResultText(message.content):typeof content==`string`?sanitizeTextContent(content):Array.isArray(content)?extractInlineTextContent(content):``}async function readLatestSubagentOutput(sessionKey){let history=await callGateway({method:`chat.history`,params:{sessionKey,limit:50}}),messages=Array.isArray(history?.messages)?history.messages:[];for(let i=messages.length-1;i>=0;--i){let msg=messages[i],text=extractSubagentOutputText(msg);if(text)return text}}async function readLatestSubagentOutputWithRetry(params){let deadline=Date.now()+Math.max(0,Math.min(params.maxWaitMs,15e3)),result;for(;Date.now()<deadline;){if(result=await readLatestSubagentOutput(params.sessionKey),result?.trim())return result;await new Promise(resolve=>setTimeout(resolve,100))}return result}function formatDurationShort(valueMs){if(!valueMs||!Number.isFinite(valueMs)||valueMs<=0)return`n/a`;let totalSeconds=Math.round(valueMs/1e3),hours=Math.floor(totalSeconds/3600),minutes=Math.floor(totalSeconds%3600/60),seconds=totalSeconds%60;return hours>0?`${hours}h${minutes}m`:minutes>0?`${minutes}m${seconds}s`:`${seconds}s`}function formatTokenCount(value){return typeof value!=`number`||!Number.isFinite(value)||value<=0?`0`:value>=1e6?`${(value/1e6).toFixed(1)}m`:value>=1e3?`${(value/1e3).toFixed(1)}k`:String(Math.round(value))}async function buildCompactAnnounceStatsLine(params){let cfg=loadConfig(),agentId=resolveAgentIdFromSessionKey(params.sessionKey),storePath=resolveStorePath(cfg.session?.store,{agentId}),entry=loadSessionStore(storePath)[params.sessionKey];for(let attempt=0;attempt<3&&!(typeof entry?.inputTokens==`number`||typeof entry?.outputTokens==`number`||typeof entry?.totalTokens==`number`);attempt+=1)await new Promise(resolve=>setTimeout(resolve,150)),entry=loadSessionStore(storePath)[params.sessionKey];let input=typeof entry?.inputTokens==`number`?entry.inputTokens:0,output=typeof entry?.outputTokens==`number`?entry.outputTokens:0,ioTotal=input+output,promptCache=typeof entry?.totalTokens==`number`?entry.totalTokens:void 0,parts=[`runtime ${formatDurationShort(typeof params.startedAt==`number`&&typeof params.endedAt==`number`?Math.max(0,params.endedAt-params.startedAt):void 0)}`,`tokens ${formatTokenCount(ioTotal)} (in ${formatTokenCount(input)} / out ${formatTokenCount(output)})`];return typeof promptCache==`number`&&promptCache>ioTotal&&parts.push(`prompt/cache ${formatTokenCount(promptCache)}`),`Stats: ${parts.join(` • `)}`}function resolveAnnounceOrigin(entry,requesterOrigin){let normalizedRequester=normalizeDeliveryContext(requesterOrigin),normalizedEntry=deliveryContextFromSession(entry);return normalizedRequester?.channel&&!isDeliverableMessageChannel(normalizedRequester.channel)?mergeDeliveryContext({accountId:normalizedRequester.accountId,threadId:normalizedRequester.threadId},normalizedEntry):mergeDeliveryContext(normalizedRequester,normalizedEntry)}async function sendAnnounce(item){let requesterIsSubagent=getSubagentDepthFromSessionStore(item.sessionKey)>=1,origin=item.origin,threadId=origin?.threadId!=null&&origin.threadId!==``?String(origin.threadId):void 0,idempotencyKey=buildAnnounceIdempotencyKey(resolveQueueAnnounceId({announceId:item.announceId,sessionKey:item.sessionKey,enqueuedAt:item.enqueuedAt}));await callGateway({method:`agent`,params:{sessionKey:item.sessionKey,message:item.prompt,channel:requesterIsSubagent?void 0:origin?.channel,accountId:requesterIsSubagent?void 0:origin?.accountId,to:requesterIsSubagent?void 0:origin?.to,threadId:requesterIsSubagent?void 0:threadId,deliver:!requesterIsSubagent,idempotencyKey},timeoutMs:15e3})}function resolveRequesterStoreKey(cfg,requesterSessionKey){let raw=requesterSessionKey.trim();if(!raw||raw===`global`||raw===`unknown`||raw.startsWith(`agent:`))return raw;let mainKey=normalizeMainKey(cfg.session?.mainKey);return raw===`main`||raw===mainKey?resolveMainSessionKey(cfg):`agent:${resolveAgentIdFromSessionKey(raw)}:${raw}`}function loadRequesterSessionEntry(requesterSessionKey){let cfg=loadConfig(),canonicalKey=resolveRequesterStoreKey(cfg,requesterSessionKey),agentId=resolveAgentIdFromSessionKey(canonicalKey);return{cfg,entry:loadSessionStore(resolveStorePath(cfg.session?.store,{agentId}))[canonicalKey],canonicalKey}}async function maybeQueueSubagentAnnounce(params){let{cfg,entry}=loadRequesterSessionEntry(params.requesterSessionKey),canonicalKey=resolveRequesterStoreKey(cfg,params.requesterSessionKey),sessionId=entry?.sessionId;if(!sessionId)return`none`;let queueSettings=resolveQueueSettings({cfg,channel:entry?.channel??entry?.lastChannel,sessionEntry:entry}),isActive=isEmbeddedRunActive(sessionId);if((queueSettings.mode===`steer`||queueSettings.mode===`steer-backlog`)&&queueEmbeddedMessage(sessionId,params.triggerMessage))return`steered`;let shouldFollowup=queueSettings.mode===`followup`||queueSettings.mode===`collect`||queueSettings.mode===`steer-backlog`||queueSettings.mode===`interrupt`;if(isActive&&(shouldFollowup||queueSettings.mode===`steer`)){let origin=resolveAnnounceOrigin(entry,params.requesterOrigin);return enqueueAnnounce({key:canonicalKey,item:{announceId:params.announceId,prompt:params.triggerMessage,summaryLine:params.summaryLine,enqueuedAt:Date.now(),sessionKey:canonicalKey,origin},settings:queueSettings,send:sendAnnounce}),`queued`}return`none`}function queueOutcomeToDeliveryResult(outcome){return outcome===`steered`?{delivered:!0,path:`steered`}:outcome===`queued`?{delivered:!0,path:`queued`}:{delivered:!1,path:`none`}}async function sendSubagentAnnounceDirectly(params){let canonicalRequesterSessionKey=resolveRequesterStoreKey(loadConfig(),params.targetRequesterSessionKey);try{let completionDirectOrigin=normalizeDeliveryContext(params.completionDirectOrigin),completionChannelRaw=typeof completionDirectOrigin?.channel==`string`?completionDirectOrigin.channel.trim():``,completionChannel=completionChannelRaw&&isDeliverableMessageChannel(completionChannelRaw)?completionChannelRaw:``,completionTo=typeof completionDirectOrigin?.to==`string`?completionDirectOrigin.to.trim():``,hasCompletionDirectTarget=!params.requesterIsSubagent&&!!completionChannel&&!!completionTo;if(params.expectsCompletionMessage&&hasCompletionDirectTarget&&params.completionMessage?.trim()){let completionThreadId=completionDirectOrigin?.threadId!=null&&completionDirectOrigin.threadId!==``?String(completionDirectOrigin.threadId):void 0;return await callGateway({method:`send`,params:{channel:completionChannel,to:completionTo,accountId:completionDirectOrigin?.accountId,threadId:completionThreadId,sessionKey:canonicalRequesterSessionKey,message:params.completionMessage,idempotencyKey:params.directIdempotencyKey},timeoutMs:15e3}),{delivered:!0,path:`direct`}}let directOrigin=normalizeDeliveryContext(params.directOrigin),threadId=directOrigin?.threadId!=null&&directOrigin.threadId!==``?String(directOrigin.threadId):void 0;return await callGateway({method:`agent`,params:{sessionKey:canonicalRequesterSessionKey,message:params.triggerMessage,deliver:!params.requesterIsSubagent,channel:params.requesterIsSubagent?void 0:directOrigin?.channel,accountId:params.requesterIsSubagent?void 0:directOrigin?.accountId,to:params.requesterIsSubagent?void 0:directOrigin?.to,threadId:params.requesterIsSubagent?void 0:threadId,idempotencyKey:params.directIdempotencyKey},expectFinal:!0,timeoutMs:15e3}),{delivered:!0,path:`direct`}}catch(err){return{delivered:!1,path:`direct`,error:summarizeDeliveryError(err)}}}async function deliverSubagentAnnouncement(params){if(!params.expectsCompletionMessage){let queued=queueOutcomeToDeliveryResult(await maybeQueueSubagentAnnounce({requesterSessionKey:params.requesterSessionKey,announceId:params.announceId,triggerMessage:params.triggerMessage,summaryLine:params.summaryLine,requesterOrigin:params.requesterOrigin}));if(queued.delivered)return queued}let direct=await sendSubagentAnnounceDirectly({targetRequesterSessionKey:params.targetRequesterSessionKey,triggerMessage:params.triggerMessage,completionMessage:params.completionMessage,directIdempotencyKey:params.directIdempotencyKey,completionDirectOrigin:params.completionDirectOrigin,directOrigin:params.directOrigin,requesterIsSubagent:params.requesterIsSubagent,expectsCompletionMessage:params.expectsCompletionMessage});if(direct.delivered||!params.expectsCompletionMessage)return direct;let queueOutcome=await maybeQueueSubagentAnnounce({requesterSessionKey:params.requesterSessionKey,announceId:params.announceId,triggerMessage:params.triggerMessage,summaryLine:params.summaryLine,requesterOrigin:params.requesterOrigin});return queueOutcome===`steered`||queueOutcome===`queued`?queueOutcomeToDeliveryResult(queueOutcome):direct}function loadSessionEntryByKey(sessionKey){let cfg=loadConfig(),agentId=resolveAgentIdFromSessionKey(sessionKey);return loadSessionStore(resolveStorePath(cfg.session?.store,{agentId}))[sessionKey]}function buildSubagentSystemPrompt(params){let taskText=typeof params.task==`string`&&params.task.trim()?params.task.replace(/\s+/g,` `).trim():`{{TASK_DESCRIPTION}}`,childDepth=typeof params.childDepth==`number`?params.childDepth:1,canSpawn=childDepth<(typeof params.maxSpawnDepth==`number`?params.maxSpawnDepth:1),parentLabel=childDepth>=2?`parent orchestrator`:`main agent`,lines=[`# Subagent Context`,``,`You are a **subagent** spawned by the ${parentLabel} for a specific task.`,``,`## Your Role`,`- You were created to handle: ${taskText}`,`- Complete this task. That's your entire purpose.`,`- You are NOT the ${parentLabel}. Don't try to be.`,``,`## Rules`,`1. **Stay focused** - Do your assigned task, nothing else`,`2. **Complete the task** - Your final message will be automatically reported to the ${parentLabel}`,`3. **Don't initiate** - No heartbeats, no proactive actions, no side quests`,`4. **Be ephemeral** - You may be terminated after task completion. That's fine.`,`5. **Trust push-based completion** - Descendant results are auto-announced back to you; do not busy-poll for status.`,"6. **Recover from compacted/truncated tool output** - If you see `[compacted: tool output removed to free context]` or `[truncated: output exceeded context limit]`, assume prior output was reduced. Re-read only what you need using smaller chunks (`read` with offset/limit, or targeted `rg`/`head`/`tail`) instead of full-file `cat`.",``,`## Output Format`,`When complete, your final response should include:`,`- What you accomplished or found`,`- Any relevant details the ${parentLabel} should know`,`- Keep it concise but informative`,``,`## What You DON'T Do`,`- NO user conversations (that's ${parentLabel}'s job)`,`- NO external messages (email, tweets, etc.) unless explicitly tasked with a specific recipient/channel`,`- NO cron jobs or persistent state`,`- NO pretending to be the ${parentLabel}`,`- Only use the \`message\` tool when explicitly instructed to contact a specific external recipient; otherwise return plain text and let the ${parentLabel} deliver it`,``];return canSpawn?lines.push(`## Sub-Agent Spawning`,"You CAN spawn your own sub-agents for parallel or complex work using `sessions_spawn`.","Use the `subagents` tool to steer, kill, or do an on-demand status check for your spawned sub-agents.",`Your sub-agents will announce their results back to you automatically (not to the main agent).`,`Default workflow: spawn work, continue orchestrating, and wait for auto-announced completions.`,"Do NOT repeatedly poll `subagents list` in a loop unless you are actively debugging or intervening.",`Coordinate their work and synthesize results before reporting back.`,``):childDepth>=2&&lines.push(`## Sub-Agent Spawning`,`You are a leaf worker and CANNOT spawn further sub-agents. Focus on your assigned task.`,``),lines.push(`## Session Context`,...[params.label?`- Label: ${params.label}`:void 0,params.requesterSessionKey?`- Requester session: ${params.requesterSessionKey}.`:void 0,params.requesterOrigin?.channel?`- Requester channel: ${params.requesterOrigin.channel}.`:void 0,`- Your session: ${params.childSessionKey}.`].filter(line=>line!==void 0),``),lines.join(`
542
- `)}function buildAnnounceReplyInstruction(params){if(params.expectsCompletionMessage)return`A completed ${params.announceType} is ready for user delivery. Convert the result above into your normal assistant voice and send that user-facing update now. Keep this internal context private (don't mention system/log/stats/session details or announce type).`;if(params.remainingActiveSubagentRuns>0){let activeRunsLabel=params.remainingActiveSubagentRuns===1?`run`:`runs`;return`There are still ${params.remainingActiveSubagentRuns} active subagent ${activeRunsLabel} for this session. If they are part of the same workflow, wait for the remaining results before sending a user update. If they are unrelated, respond normally using only the result above.`}return params.requesterIsSubagent?`Convert this completion into a concise internal orchestration update for your parent agent in your own words. Keep this internal context private (don't mention system/log/stats/session details or announce type). If this result is duplicate or no update is needed, reply ONLY: ${SILENT_REPLY_TOKEN}.`:`A completed ${params.announceType} is ready for user delivery. Convert the result above into your normal assistant voice and send that user-facing update now. Keep this internal context private (don't mention system/log/stats/session details or announce type), and do not copy the system message verbatim. Reply ONLY: ${SILENT_REPLY_TOKEN} if this exact result was already delivered to the user in this same turn.`}async function runSubagentAnnounceFlow(params){let didAnnounce=!1,expectsCompletionMessage=params.expectsCompletionMessage===!0,shouldDeleteChildSession=params.cleanup===`delete`;try{let targetRequesterSessionKey=params.requesterSessionKey,targetRequesterOrigin=normalizeDeliveryContext(params.requesterOrigin),childSessionId=(()=>{let entry=loadSessionEntryByKey(params.childSessionKey);return typeof entry?.sessionId==`string`&&entry.sessionId.trim()?entry.sessionId.trim():void 0})(),settleTimeoutMs=Math.min(Math.max(params.timeoutMs,1),12e4),reply=params.roundOneReply,outcome=params.outcome;if(!expectsCompletionMessage&&childSessionId&&isEmbeddedRunActive(childSessionId)&&!await waitForEmbeddedRunEnd(childSessionId,settleTimeoutMs)&&isEmbeddedRunActive(childSessionId))return shouldDeleteChildSession=!1,!1;if(!reply&&params.waitForCompletion!==!1){let waitMs=settleTimeoutMs,wait=await callGateway({method:`agent.wait`,params:{runId:params.childRunId,timeoutMs:waitMs},timeoutMs:waitMs+2e3}),waitError=typeof wait?.error==`string`?wait.error:void 0;wait?.status===`timeout`?outcome={status:`timeout`}:wait?.status===`error`?outcome={status:`error`,error:waitError}:wait?.status===`ok`&&(outcome={status:`ok`}),typeof wait?.startedAt==`number`&&!params.startedAt&&(params.startedAt=wait.startedAt),typeof wait?.endedAt==`number`&&!params.endedAt&&(params.endedAt=wait.endedAt),wait?.status===`timeout`&&(outcome||={status:`timeout`}),reply=await readLatestSubagentOutput(params.childSessionKey)}if(reply||=await readLatestSubagentOutput(params.childSessionKey),reply?.trim()||(reply=await readLatestSubagentOutputWithRetry({sessionKey:params.childSessionKey,maxWaitMs:params.timeoutMs})),!expectsCompletionMessage&&!reply?.trim()&&childSessionId&&isEmbeddedRunActive(childSessionId))return shouldDeleteChildSession=!1,!1;outcome||={status:`unknown`};let activeChildDescendantRuns=0;try{let{countActiveDescendantRuns}=await import(`./subagent-registry-BYK0Wq_w.js`);activeChildDescendantRuns=Math.max(0,await countActiveDescendantRuns(params.childSessionKey))}catch{}if(!expectsCompletionMessage&&activeChildDescendantRuns>0)return shouldDeleteChildSession=!1,!1;let statusLabel=outcome.status===`ok`?`completed successfully`:outcome.status===`timeout`?`timed out`:outcome.status===`error`?`failed: ${outcome.error||`unknown error`}`:`finished with unknown status`,announceType=params.announceType??`subagent task`,taskLabel=params.label||params.task||`task`,subagentName=resolveAgentIdFromSessionKey(params.childSessionKey),announceSessionId=childSessionId||`unknown`,findings=reply||`(no output)`,completionMessage=``,triggerMessage=``,requesterDepth=getSubagentDepthFromSessionStore(targetRequesterSessionKey),requesterIsSubagent=!expectsCompletionMessage&&requesterDepth>=1;if(requesterIsSubagent){let{isSubagentSessionRunActive,resolveRequesterForChildSession}=await import(`./subagent-registry-BYK0Wq_w.js`);if(!isSubagentSessionRunActive(targetRequesterSessionKey)){let parentSessionEntry=loadSessionEntryByKey(targetRequesterSessionKey);if(!(parentSessionEntry&&typeof parentSessionEntry.sessionId==`string`&&parentSessionEntry.sessionId.trim())){let fallback=await resolveRequesterForChildSession(targetRequesterSessionKey);if(!fallback?.requesterSessionKey)return shouldDeleteChildSession=!1,!1;targetRequesterSessionKey=fallback.requesterSessionKey,targetRequesterOrigin=normalizeDeliveryContext(fallback.requesterOrigin)??targetRequesterOrigin,requesterDepth=getSubagentDepthFromSessionStore(targetRequesterSessionKey),requesterIsSubagent=requesterDepth>=1}}}let remainingActiveSubagentRuns=0;try{let{countActiveDescendantRuns}=await import(`./subagent-registry-BYK0Wq_w.js`);remainingActiveSubagentRuns=Math.max(0,await countActiveDescendantRuns(targetRequesterSessionKey))}catch{}let replyInstruction=buildAnnounceReplyInstruction({remainingActiveSubagentRuns,requesterIsSubagent,announceType,expectsCompletionMessage}),statsLine=await buildCompactAnnounceStatsLine({sessionKey:params.childSessionKey,startedAt:params.startedAt,endedAt:params.endedAt});completionMessage=buildCompletionDeliveryMessage({findings,subagentName}),triggerMessage=[[`[System Message] [sessionId: ${announceSessionId}] A ${announceType} "${taskLabel}" just ${statusLabel}.`,``,`Result:`,findings,``,statsLine].join(`
542
+ `)}function buildAnnounceReplyInstruction(params){if(params.expectsCompletionMessage)return`A completed ${params.announceType} is ready for user delivery. Convert the result above into your normal assistant voice and send that user-facing update now. Keep this internal context private (don't mention system/log/stats/session details or announce type).`;if(params.remainingActiveSubagentRuns>0){let activeRunsLabel=params.remainingActiveSubagentRuns===1?`run`:`runs`;return`There are still ${params.remainingActiveSubagentRuns} active subagent ${activeRunsLabel} for this session. If they are part of the same workflow, wait for the remaining results before sending a user update. If they are unrelated, respond normally using only the result above.`}return params.requesterIsSubagent?`Convert this completion into a concise internal orchestration update for your parent agent in your own words. Keep this internal context private (don't mention system/log/stats/session details or announce type). If this result is duplicate or no update is needed, reply ONLY: ${SILENT_REPLY_TOKEN}.`:`A completed ${params.announceType} is ready for user delivery. Convert the result above into your normal assistant voice and send that user-facing update now. Keep this internal context private (don't mention system/log/stats/session details or announce type), and do not copy the system message verbatim. Reply ONLY: ${SILENT_REPLY_TOKEN} if this exact result was already delivered to the user in this same turn.`}async function runSubagentAnnounceFlow(params){let didAnnounce=!1,expectsCompletionMessage=params.expectsCompletionMessage===!0,shouldDeleteChildSession=params.cleanup===`delete`;try{let targetRequesterSessionKey=params.requesterSessionKey,targetRequesterOrigin=normalizeDeliveryContext(params.requesterOrigin),childSessionId=(()=>{let entry=loadSessionEntryByKey(params.childSessionKey);return typeof entry?.sessionId==`string`&&entry.sessionId.trim()?entry.sessionId.trim():void 0})(),settleTimeoutMs=Math.min(Math.max(params.timeoutMs,1),12e4),reply=params.roundOneReply,outcome=params.outcome;if(!expectsCompletionMessage&&childSessionId&&isEmbeddedRunActive(childSessionId)&&!await waitForEmbeddedRunEnd(childSessionId,settleTimeoutMs)&&isEmbeddedRunActive(childSessionId))return shouldDeleteChildSession=!1,!1;if(!reply&&params.waitForCompletion!==!1){let waitMs=settleTimeoutMs,wait=await callGateway({method:`agent.wait`,params:{runId:params.childRunId,timeoutMs:waitMs},timeoutMs:waitMs+2e3}),waitError=typeof wait?.error==`string`?wait.error:void 0;wait?.status===`timeout`?outcome={status:`timeout`}:wait?.status===`error`?outcome={status:`error`,error:waitError}:wait?.status===`ok`&&(outcome={status:`ok`}),typeof wait?.startedAt==`number`&&!params.startedAt&&(params.startedAt=wait.startedAt),typeof wait?.endedAt==`number`&&!params.endedAt&&(params.endedAt=wait.endedAt),wait?.status===`timeout`&&(outcome||={status:`timeout`}),reply=await readLatestSubagentOutput(params.childSessionKey)}if(reply||=await readLatestSubagentOutput(params.childSessionKey),reply?.trim()||(reply=await readLatestSubagentOutputWithRetry({sessionKey:params.childSessionKey,maxWaitMs:params.timeoutMs})),!expectsCompletionMessage&&!reply?.trim()&&childSessionId&&isEmbeddedRunActive(childSessionId))return shouldDeleteChildSession=!1,!1;outcome||={status:`unknown`};let activeChildDescendantRuns=0;try{let{countActiveDescendantRuns}=await import(`./subagent-registry-Ch9dN-TR.js`);activeChildDescendantRuns=Math.max(0,await countActiveDescendantRuns(params.childSessionKey))}catch{}if(!expectsCompletionMessage&&activeChildDescendantRuns>0)return shouldDeleteChildSession=!1,!1;let statusLabel=outcome.status===`ok`?`completed successfully`:outcome.status===`timeout`?`timed out`:outcome.status===`error`?`failed: ${outcome.error||`unknown error`}`:`finished with unknown status`,announceType=params.announceType??`subagent task`,taskLabel=params.label||params.task||`task`,subagentName=resolveAgentIdFromSessionKey(params.childSessionKey),announceSessionId=childSessionId||`unknown`,findings=reply||`(no output)`,completionMessage=``,triggerMessage=``,requesterDepth=getSubagentDepthFromSessionStore(targetRequesterSessionKey),requesterIsSubagent=!expectsCompletionMessage&&requesterDepth>=1;if(requesterIsSubagent){let{isSubagentSessionRunActive,resolveRequesterForChildSession}=await import(`./subagent-registry-Ch9dN-TR.js`);if(!isSubagentSessionRunActive(targetRequesterSessionKey)){let parentSessionEntry=loadSessionEntryByKey(targetRequesterSessionKey);if(!(parentSessionEntry&&typeof parentSessionEntry.sessionId==`string`&&parentSessionEntry.sessionId.trim())){let fallback=await resolveRequesterForChildSession(targetRequesterSessionKey);if(!fallback?.requesterSessionKey)return shouldDeleteChildSession=!1,!1;targetRequesterSessionKey=fallback.requesterSessionKey,targetRequesterOrigin=normalizeDeliveryContext(fallback.requesterOrigin)??targetRequesterOrigin,requesterDepth=getSubagentDepthFromSessionStore(targetRequesterSessionKey),requesterIsSubagent=requesterDepth>=1}}}let remainingActiveSubagentRuns=0;try{let{countActiveDescendantRuns}=await import(`./subagent-registry-Ch9dN-TR.js`);remainingActiveSubagentRuns=Math.max(0,await countActiveDescendantRuns(targetRequesterSessionKey))}catch{}let replyInstruction=buildAnnounceReplyInstruction({remainingActiveSubagentRuns,requesterIsSubagent,announceType,expectsCompletionMessage}),statsLine=await buildCompactAnnounceStatsLine({sessionKey:params.childSessionKey,startedAt:params.startedAt,endedAt:params.endedAt});completionMessage=buildCompletionDeliveryMessage({findings,subagentName}),triggerMessage=[[`[System Message] [sessionId: ${announceSessionId}] A ${announceType} "${taskLabel}" just ${statusLabel}.`,``,`Result:`,findings,``,statsLine].join(`
543
543
  `),``,replyInstruction].join(`
544
544
  `);let announceId=buildAnnounceIdFromChildRun({childSessionKey:params.childSessionKey,childRunId:params.childRunId}),directOrigin=targetRequesterOrigin;if(!requesterIsSubagent){let{entry}=loadRequesterSessionEntry(targetRequesterSessionKey);directOrigin=resolveAnnounceOrigin(entry,targetRequesterOrigin)}let directIdempotencyKey=buildAnnounceIdempotencyKey(announceId),delivery=await deliverSubagentAnnouncement({requesterSessionKey:targetRequesterSessionKey,announceId,triggerMessage,completionMessage,summaryLine:taskLabel,requesterOrigin:targetRequesterOrigin,completionDirectOrigin:targetRequesterOrigin,directOrigin,targetRequesterSessionKey,requesterIsSubagent,expectsCompletionMessage,directIdempotencyKey});didAnnounce=delivery.delivered,!delivery.delivered&&delivery.path===`direct`&&delivery.error&&defaultRuntime.error?.(`Subagent completion direct announce failed for run ${params.childRunId}: ${delivery.error}`)}catch(err){defaultRuntime.error?.(`Subagent announce failed: ${String(err)}`)}finally{if(params.label)try{await callGateway({method:`sessions.patch`,params:{key:params.childSessionKey,label:params.label},timeoutMs:1e4})}catch{}if(shouldDeleteChildSession)try{await callGateway({method:`sessions.delete`,params:{key:params.childSessionKey,deleteTranscript:!0},timeoutMs:1e4})}catch{}}return didAnnounce}function resolveSubagentStateDir(env=process.env){return env.BUILDERFORCE_AGENTS_STATE_DIR?.trim()?resolveStateDir(env):env.VITEST||env.NODE_ENV===`test`?path.join(os.tmpdir(),`builderforce-test-state`,String(process.pid)):resolveStateDir(env)}function resolveSubagentRegistryPath(){return path.join(resolveSubagentStateDir(process.env),`subagents`,`runs.json`)}async function loadSubagentRegistryFromDisk(){let raw=await loadJsonFile(resolveSubagentRegistryPath());if(!raw||typeof raw!=`object`)return new Map;let record=raw;if(record.version!==1&&record.version!==2)return new Map;let runsRaw=record.runs;if(!runsRaw||typeof runsRaw!=`object`)return new Map;let out=new Map,isLegacy=record.version===1,migrated=!1;for(let[runId,entry]of Object.entries(runsRaw)){if(!entry||typeof entry!=`object`)continue;let typed=entry;if(!typed.runId||typeof typed.runId!=`string`)continue;let legacyCompletedAt=isLegacy&&typeof typed.announceCompletedAt==`number`?typed.announceCompletedAt:void 0,cleanupCompletedAt=typeof typed.cleanupCompletedAt==`number`?typed.cleanupCompletedAt:legacyCompletedAt,cleanupHandled=typeof typed.cleanupHandled==`boolean`?typed.cleanupHandled:isLegacy?!!(typed.announceHandled??cleanupCompletedAt):void 0,requesterOrigin=normalizeDeliveryContext(typed.requesterOrigin??{channel:typeof typed.requesterChannel==`string`?typed.requesterChannel:void 0,accountId:typeof typed.requesterAccountId==`string`?typed.requesterAccountId:void 0}),{announceCompletedAt:_announceCompletedAt,announceHandled:_announceHandled,requesterChannel:_channel,requesterAccountId:_accountId,...rest}=typed;out.set(runId,{...rest,requesterOrigin,cleanupCompletedAt,cleanupHandled}),isLegacy&&(migrated=!0)}if(migrated)try{await saveSubagentRegistryToDisk(out)}catch{}return out}async function saveSubagentRegistryToDisk(runs){let pathname=resolveSubagentRegistryPath(),serialized={};for(let[runId,entry]of runs.entries())serialized[runId]=entry;await saveJsonFile(pathname,{version:2,runs:serialized})}const subagentRuns=new Map;let sweeper=null,listenerStarted=!1;var restoreAttempted=!1;const ANNOUNCE_EXPIRY_MS=5*6e4;function resolveAnnounceRetryDelayMs(retryCount){let boundedRetryCount=Math.max(0,Math.min(retryCount,10)),baseDelay=1e3*2**Math.max(0,boundedRetryCount-1);return Math.min(baseDelay,8e3)}function logAnnounceGiveUp(entry,reason){let retryCount=entry.announceRetryCount??0,endedAgoMs=typeof entry.endedAt==`number`?Math.max(0,Date.now()-entry.endedAt):void 0,endedAgoLabel=endedAgoMs==null?`n/a`:`${Math.round(endedAgoMs/1e3)}s`;defaultRuntime.log(`[warn] Subagent announce give up (${reason}) run=${entry.runId} child=${entry.childSessionKey} requester=${entry.requesterSessionKey} retries=${retryCount} endedAgo=${endedAgoLabel}`)}let persistChain=Promise.resolve();function persistSubagentRuns(){return persistChain=persistChain.then(()=>saveSubagentRegistryToDisk(subagentRuns)).catch(err=>{logWarn(`subagent registry persist failed: ${String(err)}`)}),persistChain}const resumedRuns=new Set;function suppressAnnounceForSteerRestart(entry){return entry?.suppressAnnounceReason===`steer-restart`}function startSubagentAnnounceCleanupFlow(runId,entry){if(!beginSubagentCleanup(runId))return!1;let requesterOrigin=normalizeDeliveryContext(entry.requesterOrigin);return runSubagentAnnounceFlow({childSessionKey:entry.childSessionKey,childRunId:entry.runId,requesterSessionKey:entry.requesterSessionKey,requesterOrigin,requesterDisplayKey:entry.requesterDisplayKey,task:entry.task,expectsCompletionMessage:entry.expectsCompletionMessage,timeoutMs:12e4,cleanup:entry.cleanup,waitForCompletion:!1,startedAt:entry.startedAt,endedAt:entry.endedAt,label:entry.label,outcome:entry.outcome}).then(didAnnounce=>{finalizeSubagentCleanup(runId,entry.cleanup,didAnnounce)}),!0}function resumeSubagentRun(runId){if(!runId||resumedRuns.has(runId))return;let entry=subagentRuns.get(runId);if(!entry||entry.cleanupCompletedAt)return;if((entry.announceRetryCount??0)>=3){logAnnounceGiveUp(entry,`retry-limit`),entry.cleanupCompletedAt=Date.now(),persistSubagentRuns();return}if(typeof entry.endedAt==`number`&&Date.now()-entry.endedAt>ANNOUNCE_EXPIRY_MS){logAnnounceGiveUp(entry,`expiry`),entry.cleanupCompletedAt=Date.now(),persistSubagentRuns();return}let now=Date.now(),delayMs=resolveAnnounceRetryDelayMs(entry.announceRetryCount??0),earliestRetryAt=(entry.lastAnnounceRetryAt??0)+delayMs;if(entry.expectsCompletionMessage===!0&&entry.lastAnnounceRetryAt&&now<earliestRetryAt){let waitMs=Math.max(1,earliestRetryAt-now);setTimeout(()=>{resumeSubagentRun(runId)},waitMs).unref?.(),resumedRuns.add(runId);return}if(typeof entry.endedAt==`number`&&entry.endedAt>0){if(suppressAnnounceForSteerRestart(entry)){resumedRuns.add(runId);return}if(!startSubagentAnnounceCleanupFlow(runId,entry))return;resumedRuns.add(runId);return}waitForSubagentCompletion(runId,resolveSubagentWaitTimeoutMs(loadConfig(),entry.runTimeoutSeconds)),resumedRuns.add(runId)}async function restoreSubagentRunsOnce(){if(!restoreAttempted){restoreAttempted=!0;try{let restored=await loadSubagentRegistryFromDisk();if(restored.size===0)return;for(let[runId,entry]of restored.entries())!runId||!entry||subagentRuns.has(runId)||subagentRuns.set(runId,entry);ensureListener(),[...subagentRuns.values()].some(entry=>entry.archiveAtMs)&&startSweeper();for(let runId of subagentRuns.keys())resumeSubagentRun(runId)}catch(err){let message=`failed to restore subagent runs: ${String(err)}`;defaultRuntime.error(message)}}}function resolveArchiveAfterMs(cfg){let minutes=(cfg??loadConfig()).agents?.defaults?.subagents?.archiveAfterMinutes??60;if(!(!Number.isFinite(minutes)||minutes<=0))return Math.max(1,Math.floor(minutes))*6e4}function resolveSubagentWaitTimeoutMs(cfg,runTimeoutSeconds){return resolveAgentTimeoutMs({cfg,overrideSeconds:runTimeoutSeconds??0})}function startSweeper(){sweeper||(sweeper=setInterval(()=>{sweepSubagentRuns()},6e4),sweeper.unref?.())}function stopSweeper(){sweeper&&=(clearInterval(sweeper),null)}async function sweepSubagentRuns(){let now=Date.now(),mutated=!1;for(let[runId,entry]of subagentRuns.entries())if(!(!entry.archiveAtMs||entry.archiveAtMs>now)){subagentRuns.delete(runId),mutated=!0;try{await callGateway({method:`sessions.delete`,params:{key:entry.childSessionKey,deleteTranscript:!0},timeoutMs:1e4})}catch{}}mutated&&await persistSubagentRuns(),subagentRuns.size===0&&stopSweeper()}function ensureListener(){listenerStarted||(listenerStarted=!0,onAgentEvent(evt=>{if(!evt||evt.stream!==`lifecycle`)return;let entry=subagentRuns.get(evt.runId);if(!entry)return;let phase=evt.data?.phase;if(phase===`start`){let startedAt=typeof evt.data?.startedAt==`number`?evt.data.startedAt:void 0;startedAt&&(entry.startedAt=startedAt,persistSubagentRuns());return}phase!==`end`&&phase!==`error`||(entry.endedAt=typeof evt.data?.endedAt==`number`?evt.data.endedAt:Date.now(),phase===`error`?entry.outcome={status:`error`,error:typeof evt.data?.error==`string`?evt.data.error:void 0}:evt.data?.aborted?entry.outcome={status:`timeout`}:entry.outcome={status:`ok`},persistSubagentRuns(),!suppressAnnounceForSteerRestart(entry)&&startSubagentAnnounceCleanupFlow(evt.runId,entry))}))}function finalizeSubagentCleanup(runId,cleanup,didAnnounce){let entry=subagentRuns.get(runId);if(entry){if(!didAnnounce){let now=Date.now(),retryCount=(entry.announceRetryCount??0)+1;entry.announceRetryCount=retryCount,entry.lastAnnounceRetryAt=now;let endedAgo=typeof entry.endedAt==`number`?now-entry.endedAt:0;if(retryCount>=3||endedAgo>ANNOUNCE_EXPIRY_MS){logAnnounceGiveUp(entry,retryCount>=3?`retry-limit`:`expiry`),entry.cleanupCompletedAt=now,persistSubagentRuns(),retryDeferredCompletedAnnounces(runId);return}if(entry.cleanupHandled=!1,resumedRuns.delete(runId),persistSubagentRuns(),entry.expectsCompletionMessage!==!0)return;setTimeout(()=>{resumeSubagentRun(runId)},resolveAnnounceRetryDelayMs(entry.announceRetryCount??0)).unref?.();return}if(cleanup===`delete`){subagentRuns.delete(runId),persistSubagentRuns(),retryDeferredCompletedAnnounces(runId);return}entry.cleanupCompletedAt=Date.now(),persistSubagentRuns(),retryDeferredCompletedAnnounces(runId)}}function retryDeferredCompletedAnnounces(excludeRunId){let now=Date.now();for(let[runId,entry]of subagentRuns.entries())if(!(excludeRunId&&runId===excludeRunId)&&typeof entry.endedAt==`number`&&!(entry.cleanupCompletedAt||entry.cleanupHandled)&&!suppressAnnounceForSteerRestart(entry)){if(now-(entry.endedAt??now)>ANNOUNCE_EXPIRY_MS){logAnnounceGiveUp(entry,`expiry`),entry.cleanupCompletedAt=now,persistSubagentRuns();continue}resumedRuns.delete(runId),resumeSubagentRun(runId)}}function beginSubagentCleanup(runId){let entry=subagentRuns.get(runId);return!entry||entry.cleanupCompletedAt||entry.cleanupHandled?!1:(entry.cleanupHandled=!0,persistSubagentRuns(),!0)}function markSubagentRunForSteerRestart(runId){let key=runId.trim();if(!key)return!1;let entry=subagentRuns.get(key);return entry?entry.suppressAnnounceReason===`steer-restart`?!0:(entry.suppressAnnounceReason=`steer-restart`,persistSubagentRuns(),!0):!1}function clearSubagentRunSteerRestart(runId){let key=runId.trim();if(!key)return!1;let entry=subagentRuns.get(key);return entry?entry.suppressAnnounceReason===`steer-restart`?(entry.suppressAnnounceReason=void 0,persistSubagentRuns(),resumedRuns.delete(key),typeof entry.endedAt==`number`&&!entry.cleanupCompletedAt&&resumeSubagentRun(key),!0):!0:!1}function replaceSubagentRunAfterSteer(params){let previousRunId=params.previousRunId.trim(),nextRunId=params.nextRunId.trim();if(!previousRunId||!nextRunId)return!1;let source=subagentRuns.get(previousRunId)??params.fallback;if(!source)return!1;previousRunId!==nextRunId&&(subagentRuns.delete(previousRunId),resumedRuns.delete(previousRunId));let now=Date.now(),cfg=loadConfig(),archiveAfterMs=resolveArchiveAfterMs(cfg),archiveAtMs=archiveAfterMs?now+archiveAfterMs:void 0,runTimeoutSeconds=params.runTimeoutSeconds??source.runTimeoutSeconds??0,waitTimeoutMs=resolveSubagentWaitTimeoutMs(cfg,runTimeoutSeconds),next={...source,runId:nextRunId,startedAt:now,endedAt:void 0,outcome:void 0,cleanupCompletedAt:void 0,cleanupHandled:!1,suppressAnnounceReason:void 0,announceRetryCount:void 0,lastAnnounceRetryAt:void 0,archiveAtMs,runTimeoutSeconds};return subagentRuns.set(nextRunId,next),ensureListener(),persistSubagentRuns(),archiveAfterMs&&startSweeper(),waitForSubagentCompletion(nextRunId,waitTimeoutMs),!0}function registerSubagentRun(params){let now=Date.now(),cfg=loadConfig(),archiveAfterMs=resolveArchiveAfterMs(cfg),archiveAtMs=archiveAfterMs?now+archiveAfterMs:void 0,runTimeoutSeconds=params.runTimeoutSeconds??0,waitTimeoutMs=resolveSubagentWaitTimeoutMs(cfg,runTimeoutSeconds),requesterOrigin=normalizeDeliveryContext(params.requesterOrigin);subagentRuns.set(params.runId,{runId:params.runId,childSessionKey:params.childSessionKey,requesterSessionKey:params.requesterSessionKey,requesterOrigin,requesterDisplayKey:params.requesterDisplayKey,task:params.task,cleanup:params.cleanup,expectsCompletionMessage:params.expectsCompletionMessage,label:params.label,model:params.model,runTimeoutSeconds,createdAt:now,startedAt:now,archiveAtMs,cleanupHandled:!1}),ensureListener(),persistSubagentRuns(),archiveAfterMs&&startSweeper(),waitForSubagentCompletion(params.runId,waitTimeoutMs)}async function waitForSubagentCompletion(runId,waitTimeoutMs){try{let timeoutMs=Math.max(1,Math.floor(waitTimeoutMs)),wait=await callGateway({method:`agent.wait`,params:{runId,timeoutMs},timeoutMs:timeoutMs+1e4});if(wait?.status!==`ok`&&wait?.status!==`error`&&wait?.status!==`timeout`)return;let entry=subagentRuns.get(runId);if(!entry)return;let mutated=!1;typeof wait.startedAt==`number`&&(entry.startedAt=wait.startedAt,mutated=!0),typeof wait.endedAt==`number`&&(entry.endedAt=wait.endedAt,mutated=!0),entry.endedAt||(entry.endedAt=Date.now(),mutated=!0);let waitError=typeof wait.error==`string`?wait.error:void 0;if(entry.outcome=wait.status===`error`?{status:`error`,error:waitError}:wait.status===`timeout`?{status:`timeout`}:{status:`ok`},mutated=!0,mutated&&persistSubagentRuns(),suppressAnnounceForSteerRestart(entry)||!startSubagentAnnounceCleanupFlow(runId,entry))return}catch(err){let message=`failed to wait for subagent completion: ${String(err)}`;defaultRuntime.error(message)}}async function findRunIdsByChildSessionKey(childSessionKey){let key=childSessionKey.trim();if(!key)return[];let runIds=[],snapshot=await getRunsSnapshotForRead();for(let entry of snapshot.values())entry.childSessionKey===key&&runIds.push(entry.runId);return runIds}async function getRunsSnapshotForRead(){let merged=new Map;if(!process.env.VITEST)try{let restored=await loadSubagentRegistryFromDisk();for(let[runId,entry]of restored.entries())merged.set(runId,entry)}catch(err){let message=`failed to load subagent registry from disk: ${String(err)}`;defaultRuntime.error(message)}for(let[runId,entry]of subagentRuns.entries())merged.set(runId,entry);return merged}async function resolveRequesterForChildSession(childSessionKey){let key=childSessionKey.trim();if(!key)return null;let best;for(let entry of(await getRunsSnapshotForRead()).values())entry.childSessionKey===key&&(!best||entry.createdAt>best.createdAt)&&(best=entry);return best?{requesterSessionKey:best.requesterSessionKey,requesterOrigin:normalizeDeliveryContext(best.requesterOrigin)}:null}async function isSubagentSessionRunActive(childSessionKey){let runIds=await findRunIdsByChildSessionKey(childSessionKey);for(let runId of runIds){let entry=subagentRuns.get(runId);if(entry&&typeof entry.endedAt!=`number`)return!0}return!1}async function markSubagentRunTerminated(params){let runIds=new Set;if(typeof params.runId==`string`&&params.runId.trim()&&runIds.add(params.runId.trim()),typeof params.childSessionKey==`string`&&params.childSessionKey.trim())for(let runId of await findRunIdsByChildSessionKey(params.childSessionKey))runIds.add(runId);if(runIds.size===0)return 0;let now=Date.now(),reason=params.reason?.trim()||`killed`,updated=0;for(let runId of runIds){let entry=subagentRuns.get(runId);entry&&typeof entry.endedAt!=`number`&&(entry.endedAt=now,entry.outcome={status:`error`,error:reason},entry.cleanupHandled=!0,entry.cleanupCompletedAt=now,entry.suppressAnnounceReason=`killed`,updated+=1)}return updated>0&&persistSubagentRuns(),updated}function listSubagentRunsForRequester(requesterSessionKey){let key=requesterSessionKey.trim();return key?[...subagentRuns.values()].filter(entry=>entry.requesterSessionKey===key):[]}async function countActiveRunsForSession(requesterSessionKey){let key=requesterSessionKey.trim();if(!key)return 0;let count=0;for(let entry of(await getRunsSnapshotForRead()).values())entry.requesterSessionKey===key&&typeof entry.endedAt!=`number`&&(count+=1);return count}async function countActiveDescendantRuns(rootSessionKey){let root=rootSessionKey.trim();if(!root)return 0;let runs=await getRunsSnapshotForRead(),pending=[root],visited=new Set([root]),count=0;for(;pending.length>0;){let requester=pending.shift();if(requester)for(let entry of runs.values()){if(entry.requesterSessionKey!==requester)continue;typeof entry.endedAt!=`number`&&(count+=1);let childKey=entry.childSessionKey.trim();!childKey||visited.has(childKey)||(visited.add(childKey),pending.push(childKey))}}return count}async function listDescendantRunsForRequester(rootSessionKey){let root=rootSessionKey.trim();if(!root)return[];let runs=await getRunsSnapshotForRead(),pending=[root],visited=new Set([root]),descendants=[];for(;pending.length>0;){let requester=pending.shift();if(requester)for(let entry of runs.values()){if(entry.requesterSessionKey!==requester)continue;descendants.push(entry);let childKey=entry.childSessionKey.trim();!childKey||visited.has(childKey)||(visited.add(childKey),pending.push(childKey))}}return descendants}function initSubagentRegistry(){return restoreSubagentRunsOnce()}export{resolveAnnounceTargetFromKey as $,formatInboundEnvelope as $n,setCommandLaneConcurrency as $r,parseActivationCommand as $t,sleepWithAbort as A,maskApiKey as An,registerTeamMemoryContextBuilder as Ar,persistBrowserProxyFiles as At,createReplyDispatcher as B,peekSystemEvents as Bn,setTtsProvider as Br,dispatchToRemoteAgentNode as Bt,createPluginLoaderLogger as C,verifyPairingToken as Cn,resolveUserTimezone as Cr,CHANNEL_TARGETS_DESCRIPTION as Ct,readJsonBodyWithLimit as D,readJsonFile as Dn,getSsmMemoryService as Dr,getHookType as Dt,handleSlackHttpRequest as E,createAsyncLock as En,initLimbicSystemService as Er,detectSuspiciousPatterns as Et,recordPendingHistoryEntryIfEnabled as F,applyVerboseOverride as Fn,resolveTtsAutoMode as Fr,gitHistoryTool as Ft,appendCronStyleCurrentTimeLine as G,extractFileContentFromSource as Gn,antigravityForwardCompatCandidates as Gr,spawnSubagentDirect as Gt,createDedupeCache as H,DEFAULT_INPUT_IMAGE_MIMES as Hn,OPENAI_TTS_MODELS as Hr,loadHiredAgentsCached as Ht,shouldAckReactionForWhatsApp as I,parseVerboseOverride as In,resolveTtsConfig as Ir,workflowStatusTool as It,setCliSessionId as J,resolveInputFileLimits as Jn,describeFailoverError as Jr,getBuiltInAgentRoles as Jt,resolveCronStyleNow as K,extractImageContentFromSource as Kn,resolveForwardCompatModel as Kr,resolveRelayTaskModel as Kt,dispatchReplyWithBufferedBlockDispatcher as L,enqueueSystemEvent as Ln,resolveTtsPrefsPath as Lr,globalOrchestrator as Lt,resolveMentionGating as M,buildAuthHealthSummary as Mn,isTtsEnabled as Mr,resolveApproval as Mt,DEFAULT_GROUP_HISTORY_LIMIT as N,formatRemainingShort as Nn,isTtsProviderConfigured as Nr,semanticSearchTool as Nt,requestBodyErrorToText as O,writeJsonAtomic as On,initSsmMemoryService as Or,isExternalHookSession as Ot,buildHistoryContextFromEntries as P,applyModelOverrideToSessionEntry as Pn,resolveTtsApiKey as Pr,agentFleetTool as Pt,readLatestAssistantReply as Q,resolveInboundDebounceMs as Qn,resetAllLanes as Qr,normalizeGroupActivation as Qt,dispatchReplyWithDispatcher as R,isSystemEventContextChanged as Rn,resolveTtsProviderOrder as Rr,dispatchChunkToRemoteAgentNode as Rt,getPluginToolMeta as S,generatePairingToken as Sn,writeRestartSentinel as Sr,stripLegacyDeliveryFields as St,deleteTelegramUpdateOffset as T,resolvePairingPaths as Tn,getLimbicSystemService as Tr,buildSafeExternalPrompt as Tt,getReplyFromConfig as U,DEFAULT_INPUT_MAX_REDIRECTS as Un,OPENAI_TTS_VOICES as Ur,projectKnowledgeTool as Ut,getTotalPendingReplies as V,DEFAULT_INPUT_IMAGE_MAX_BYTES as Vn,textToSpeech as Vr,fetchFleetEntries as Vt,BARE_SESSION_RESET_PROMPT as W,DEFAULT_INPUT_TIMEOUT_MS as Wn,resolveModel as Wr,codebaseSearchTool as Wt,sha256HexPrefix as X,resolveAgentTimeoutMs as Xn,getQueueSize as Xr,AGENT_LANE_NESTED as Xt,runCliAgent as Y,estimateBase64DecodedBytes as Yn,getActiveTaskCount as Yr,registerPlatformPersonasAsRoles as Yt,createBuilderForceAgentsTools as Z,createInboundDebouncer as Zn,getTotalQueueSize as Zr,AGENT_LANE_SUBAGENT as Zt,getActiveEmbeddedRunCount as _,rejectNodePairing as _n,formatDoctorNonInteractiveHint as _r,normalizePayloadToSystemText as _t,isSubagentSessionRunActive as a,formatAllowlistMatchMeta as ai,setHeartbeatWakeHandler as an,stopSubagentsForRequester as ar,resolveOutboundTarget as at,buildDefaultToolPolicyPipelineSteps as b,updatePairedNodeMetadata as bn,summarizeRestartSentinel as br,buildDeliveryFromLegacyPayload as bt,markSubagentRunForSteerRestart as c,isHeartbeatContentEffectivelyEmpty as ci,getRemoteSkillEligibility as cn,consumeGatewaySigusr1RestartAuthorization as cr,resetDirectoryCache as ct,replaceSubagentRunAfterSteer as d,clearAgentRunContext as di,refreshRemoteBinsForConnectedNodes as dn,isGatewaySigusr1RestartExternallyAllowed as dr,normalizeCronJobCreate as dt,waitForActiveTasks as ei,buildChannelSummary as en,resolveEnvelopeFormatOptions as er,runMessageAction as et,resolveRequesterForChildSession as f,emitAgentEvent as fi,refreshRemoteNodeBins as fn,markGatewaySigusr1RestartHandled as fr,normalizeCronJobPatch as ft,abortEmbeddedRun as g,listNodePairing as gn,consumeRestartSentinel as gr,normalizeOptionalText as gt,runEmbeddedAgent as h,registerAgentRunContext as hi,approveNodePairing as hn,setPreRestartDeferralCheck as hr,normalizeOptionalSessionKey as ht,initSubagentRegistry as i,isDiagnosticsEnabled as ii,requestHeartbeatNow as in,isAbortTrigger as ir,resolveHeartbeatSenderContext as it,buildPairingReply as j,DEFAULT_OAUTH_WARN_MS as jn,getTtsProvider as jr,initApprovalGate as jt,computeBackoff as k,clearSessionAuthProfileOverride as kn,registerKnowledgeLoop as kr,applyBrowserProxyPaths as kt,markSubagentRunTerminated as l,resolveHeartbeatPrompt as li,primeRemoteSkillsCache as ln,deferGatewayRestartUntilIdle as lr,CHANNEL_MESSAGE_ACTION_NAMES as lt,clearSessionQueues as m,onAgentEvent as mi,setSkillsRemoteRegistry as mn,setGatewaySigusr1RestartPolicy as mr,normalizeOptionalAgentId as mt,countActiveDescendantRuns as n,startDiagnosticHeartbeat as ni,formatChannelAllowFrom as nn,hasControlCommand as nr,resolveOutboundSessionRoute as nt,listDescendantRunsForRequester as o,DEFAULT_HEARTBEAT_ACK_MAX_CHARS as oi,normalizeSendPolicy as on,buildMentionRegexes as or,resolveSessionDeliveryTarget as ot,runSubagentAnnounceFlow as p,getAgentRunContext as pi,removeRemoteNodeInfo as pn,scheduleGatewaySigusr1Restart as pr,inferLegacyName as pt,getCliSessionId as q,normalizeMimeList as qn,runWithModelFallback as qr,findAgentRole as qt,countActiveRunsForSession as r,stopDiagnosticHeartbeat as ri,resolveCommitHash as rn,shouldComputeCommandAuthorized as rr,resolveHeartbeatDeliveryTarget as rt,listSubagentRunsForRequester as s,DEFAULT_HEARTBEAT_EVERY as si,resolveSendPolicy as sn,normalizeMentionText as sr,formatTargetDisplay as st,clearSubagentRunSteerRestart as t,CommandLane as ti,buildChannelAccountSnapshot as tn,formatZonedTimestamp as tr,ensureOutboundSessionEntry as tt,registerSubagentRun as u,stripHeartbeatToken as ui,recordRemoteNodeInfo as un,emitGatewayRestart as ur,normalizeHttpWebhookUrl as ut,waitForEmbeddedRunEnd as v,renamePairedNode as vn,formatRestartSentinelMessage as vr,normalizeRequiredName as vt,loadBuilderForceAgentsPlugins as w,pruneExpiredPending as wn,buildAssignedCapabilityAppend as wr,CHANNEL_TARGET_DESCRIPTION as wt,sniffMimeFromBase64 as x,verifyNodeToken as xn,trimLogTail as xr,hasLegacyDeliveryHints as xt,applyToolPolicyPipeline as y,requestNodePairing as yn,readRestartSentinel as yr,migrateLegacyCronPayload as yt,dispatchInboundMessage as z,peekSystemEventEntries as zn,setTtsEnabled as zr,dispatchResultToRemoteAgentNode as zt};