@comate/zulu 1.3.3-internal.1 → 1.3.3-internal.3

package/comate-engine/server.js

@@ -232,7 +232,7 @@ object-assign
  * strip-dirs | MIT (c) Shinnosuke Watanabe
  * https://github.com/shinnn/node-strip-dirs
 */
-const path$7=path__default$1,util$9=t$1,isNaturalNumber=isNaturalNumber$1;var stripDirs$1=function(e,t,r){if("string"!=typeof e)throw new TypeError(util$9.inspect(e)+" is not a string. First argument to strip-dirs must be a path string.");if(path$7.posix.isAbsolute(e)||path$7.win32.isAbsolute(e))throw new Error(`${e} is an absolute path. strip-dirs requires a relative path.`);if(!isNaturalNumber(t,{includeZero:!0}))throw new Error("The Second argument of strip-dirs must be a natural number or 0, but received "+util$9.inspect(t)+".");if(r){if("object"!=typeof r)throw new TypeError(util$9.inspect(r)+" is not an object. Expected an object with a boolean `disallowOverflow` property.");if(Array.isArray(r))throw new TypeError(util$9.inspect(r)+" is an array. Expected an object with a boolean `disallowOverflow` property.");if("disallowOverflow"in r&&"boolean"!=typeof r.disallowOverflow)throw new TypeError(util$9.inspect(r.disallowOverflow)+" is neither true nor false. `disallowOverflow` option must be a Boolean value.")}else r={disallowOverflow:!1};const n=path$7.normalize(e).split(path$7.sep);if(n.length>1&&"."===n[0]&&n.shift(),t>n.length-1){if(r.disallowOverflow)throw new RangeError("Cannot strip more directories than there are.");t=n.length-1}return path$7.join.apply(null,n.slice(t))};const path$6=path__default$1,fs$5=gracefulFs,decompressTar=decompressTar$3,decompressTarbz2=decompressTarbz2$1,decompressTargz=decompressTargz$1,decompressUnzip=decompressUnzip$1,makeDir=makeDirExports,pify=pifyExports,stripDirs=stripDirs$1,fsP=pify(fs$5),runPlugins=(e,t)=>0===t.plugins.length?Promise.resolve([]):Promise.all(t.plugins.map((r=>r(e,t)))).then((e=>e.reduce(((e,t)=>e.concat(t))))),safeMakeDir=(e,t)=>fsP.realpath(e).catch((r=>{const n=path$6.dirname(e);return safeMakeDir(n,t)})).then((r=>{if(0!==r.indexOf(t))throw new Error("Refusing to create a directory outside the output path.");return makeDir(e).then(fsP.realpath)})),preventWritingThroughSymlink=(e,t)=>fsP.readlink(e).catch((e=>null)).then((e=>{if(e)throw new Error("Refusing to write into a symlink");return t})),extractFile=(e,t,r)=>runPlugins(e,r).then((e=>(r.strip>0&&(e=e.map((e=>(e.path=stripDirs(e.path,r.strip),e))).filter((e=>"."!==e.path))),"function"==typeof r.filter&&(e=e.filter(r.filter)),"function"==typeof r.map&&(e=e.map(r.map)),t?Promise.all(e.map((e=>{const r=path$6.join(t,e.path),n=e.mode&~process.umask(),i=new Date;return"directory"===e.type?makeDir(t).then((e=>fsP.realpath(e))).then((e=>safeMakeDir(r,e))).then((()=>fsP.utimes(r,i,e.mtime))).then((()=>e)):makeDir(t).then((e=>fsP.realpath(e))).then((e=>safeMakeDir(path$6.dirname(r),e).then((()=>e)))).then((t=>"file"===e.type?preventWritingThroughSymlink(r,t):t)).then((e=>fsP.realpath(path$6.dirname(r)).then((t=>{if(0!==t.indexOf(e))throw new Error("Refusing to write outside output directory: "+t)})))).then((()=>"link"===e.type||"symlink"===e.type&&"win32"===process.platform?fsP.link(e.linkname,r):"symlink"===e.type?fsP.symlink(e.linkname,r):fsP.writeFile(r,e.data,{mode:n}))).then((()=>"file"===e.type&&fsP.utimes(r,i,e.mtime))).then((()=>e))}))):e)));var decompress$1=(e,t,r)=>{if("string"!=typeof e&&!Buffer.isBuffer(e))return Promise.reject(new TypeError("Input file required"));"object"==typeof t&&(r=t,t=null),r=Object.assign({plugins:[decompressTar(),decompressTarbz2(),decompressTargz(),decompressUnzip()]},r);return("string"==typeof e?fsP.readFile(e):Promise.resolve(e)).then((e=>extractFile(e,t,r)))},decompress$2=getDefaultExportFromCjs(decompress$1),__decorate$3=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s},__metadata$2=function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};function getSkillsBaseDir(e){if("global"===e)return path__default$1.join(os__default.homedir(),".comate","skills");const t=kernel.env.workspaceInfo.rootPath;if(!t)throw new Error("No workspace folder open for project-scoped skill installation");return path__default$1.join(t,".comate","skills")}let SkillsManager=class{disposables=[];constructor(){this.disposables.push(kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_INSTALL,this.handleInstall),kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_UNINSTALL,this.handleUninstall),kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_TOGGLE,this.handleToggle),kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_EDIT,this.handleEdit))}handleInstall=async e=>{const{key:t,identifier:r,scope:n}=e,i=kernel.config.key;if(!t)return{success:!1,message:"没有找到该Skill"};try{const e=getSkillsBaseDir(n);await fs$1j.mkdir(e,{recursive:!0});const o=path__default$1.join(e,r);try{return await fs$1j.access(o),{success:!1,message:"该Skill已经安装"}}catch{}const s=path__default$1.join(e,`${r}.zip`),a=await axiosInstance.get(`/api/aidevops/autocomate/rest/autowork/v2/skill/market/download?id=${t}`,{headers:{"login-name":i},responseType:"arraybuffer"});return await fs$1j.writeFile(s,new Uint8Array(a.data)),await decompress$2(s,e,{filter:e=>!e.path.startsWith("__MACOSX")&&!e.path.includes(".DS_Store")}),await fs$1j.unlink(s),kernel.logger.trace(`[SkillsManager] Installed skill "${r}" (id: ${t}) to ${e} (scope: ${n})`),{success:!0,message:"Skill 安装成功"}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to install skill "${r}" (id: ${t}):`,e),{success:!1,message:e?.message??"Unknown error"}}};handleUninstall=async e=>{const{directory:t}=e;if(!t)return{success:!1,message:"没有找到该Skill"};try{try{await fs$1j.access(t)}catch{return{success:!0,message:"该Skill已经删除"}}return await fs$1j.rm(t,{recursive:!0,force:!0}),kernel.logger.trace(`[SkillsManager] Uninstalled skill at "${t}"`),{success:!0,message:"Skill 卸载成功"}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to uninstall skill at "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleToggle=async e=>{const{directory:t,disabled:r}=e;try{const e=path__default$1.join(t,"SKILL.md"),n=await fs$1j.readFile(e,"utf-8"),i=matter$1(n);i.data["disable-model-invocation"]=r;const o=matter$1.stringify(i.content,i.data);return await fs$1j.writeFile(e,o,"utf-8"),kernel.logger.trace(`[SkillsManager] Toggled skill at "${t}" disabled=${r}`),{success:!0,message:r?"Skill 已关闭":"Skill 已开启"}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to toggle skill at "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleEdit=async e=>{const{directory:t}=e;try{const e=path__default$1.join(t,"SKILL.md");return await fs$1j.access(e),{success:!0,message:"",filePath:e}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to locate skill file at "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};dispose(){for(const e of this.disposables)e();this.disposables.length=0}};SkillsManager=__decorate$3([injectable(),__metadata$2("design:paramtypes",[])],SkillsManager);var __decorate$2=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s},__metadata$1=function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};const MIME_TYPES={".png":"image/png",".jpg":"image/jpeg",".jpeg":"image/jpeg",".gif":"image/gif",".svg":"image/svg+xml",".webp":"image/webp",".bmp":"image/bmp",".ico":"image/x-icon"};let ImageResolveService=class{disposables=[];constructor(){this.disposables.push(kernel.connect.onWebviewMessage(PT_WEBVIEW_IMAGE_RESOLVE_REQUEST,this.handleMessage))}handleMessage=async e=>{const{src:t}=e;try{return/^https?:\/\//.test(t)?await this.resolveRemoteImage(t):await this.resolveLocalImage(t)}catch(e){return kernel.logger.warn("[ImageResolveService] resolve failed",e?.message),{success:!1,error:e?.message||"Failed to resolve image"}}};async resolveLocalImage(e){const t=kernel.env.workspaceInfo.rootPath,r=this.decodeLocalPath(e);let n=r;if(!isAbsolute$2(r)){if(!t)return{success:!1,error:"No workspace root available"};n=resolve$e(t,r)}if(!existsSync(n))return{success:!1,error:`File not found: ${r}`};const i=await readFile$3(n),o=extname$5(n).toLowerCase();return{success:!0,data:`data:${MIME_TYPES[o]||"image/png"};base64,${i.toString("base64")}`}}decodeLocalPath(e){try{return decodeURIComponent(e)}catch{return e}}async resolveRemoteImage(e){try{const t=await axiosInstance.get(e,{responseType:"arraybuffer",timeout:15e3}),r=t.headers["content-type"]||"image/png";return{success:!0,data:`data:${r};base64,${Buffer.from(t.data).toString("base64")}`}}catch(t){return{success:!1,error:`Failed to fetch remote image: ${t?.message||e}`}}}dispose(){for(const e of this.disposables)e();this.disposables.length=0}};async function fetchFeatures(e){if(!e||0===e.length)return{};try{const t=e.join(",");return(await axiosInstance.get(`${getBaseUrl$1()}/rest/autowork/v2/abtest/features?featureKeys=${t}`,{headers:getRequestUserHeader()})).data.data||{}}catch(e){return kernel.logger.error("FeatureSetProvider","fetchFeatures failed",e),{}}}ImageResolveService=__decorate$2([injectable(),__metadata$1("design:paramtypes",[])],ImageResolveService);var __decorate$1=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s};let FeatureSetProvider=class{async getFeatures(e){return fetchFeatures(e)}};FeatureSetProvider=__decorate$1([injectable()],FeatureSetProvider);var __decorate=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s},__metadata=function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};const execFileAsync=promisify$7(execFile),TAG="[PluginMarketManager]";function getPluginsBaseDir(e){if("global"===e)return path__default$1.join(os__default.homedir(),".comate","plugins");const t=kernel.env.workspaceInfo.rootPath;if(!t)throw new Error("No workspace folder open for project-scoped plugin installation");return path__default$1.join(t,".comate","plugins")}function getPluginConfigPath(e){if("global"===e)return path__default$1.join(os__default.homedir(),".comate","plugin.json");const t=kernel.env.workspaceInfo.rootPath;if(!t)throw new Error("No workspace folder open for project-scoped plugin configuration");return path__default$1.join(t,".comate","plugin.json")}const pluginOpQueue={promise:Promise.resolve()};function withPluginLock(e){const t=pluginOpQueue.promise.then(e,e);return pluginOpQueue.promise=t.then((()=>{}),(()=>{})),t}async function readPluginConfig(e){const t=getPluginConfigPath(e);try{const r=await fs$1j.readFile(t,"utf-8"),n=JSON.parse(r);return console.log(`${TAG} readPluginConfig(${e}) path=${t} keys=[${Object.keys(n).join(",")}]`),n}catch{return console.log(`${TAG} readPluginConfig(${e}) path=${t} -> empty (file not found or parse error)`),{}}}async function writePluginConfig(e,t){const r=getPluginConfigPath(e),n=path__default$1.dirname(r);await fs$1j.mkdir(n,{recursive:!0}),await fs$1j.writeFile(r,JSON.stringify(t,null,2),"utf-8"),console.log(`${TAG} writePluginConfig(${e}) path=${r} keys=[${Object.keys(t).join(",")}]`)}const PLUGIN_COMPONENT_DIRS=[{dirName:"agents",type:"agents"},{dirName:"skills",type:"skills"},{dirName:"commands",type:"commands"},{dirName:"hooks",type:"hooks"},{dirName:"mcps",type:"mcps"},{dirName:"rules",type:"rules"}],PLUGIN_METADATA_FILES=["plugin.json","package.json",".claude-plugin/plugin.json",".cursor-plugin/plugin.json"];async function isValidPluginDir(e){const t=[...PLUGIN_METADATA_FILES.map((t=>fs$1j.access(path__default$1.join(e,t)).then((()=>!0)).catch((()=>!1)))),...PLUGIN_COMPONENT_DIRS.map((({dirName:t})=>fs$1j.access(path__default$1.join(e,t)).then((()=>!0)).catch((()=>!1))))];return(await Promise.all(t)).some(Boolean)}async function detectSubPlugins(e){const t=["plugins","external_plugins"],r=[];for(const n of t){const t=path__default$1.join(e,n);try{const e=await fs$1j.readdir(t,{withFileTypes:!0});for(const n of e){if(!n.isDirectory())continue;const e=path__default$1.join(t,n.name);await isValidPluginDir(e)&&r.push(e)}}catch{}}return r}async function scanPluginComponents(e){const t=[];return await Promise.all(PLUGIN_COMPONENT_DIRS.map((({dirName:r,type:n})=>(async(r,n)=>{const i=path__default$1.join(e,r);try{const e=await fs$1j.readdir(i,{withFileTypes:!0});for(const r of e)(r.isFile()||r.isDirectory())&&t.push({name:r.name,type:n})}catch{}})(r,n)))),t}let PluginMarketManager=class{disposables=[];constructor(){console.log(`${TAG} constructor: registering event handlers`),this.disposables.push(kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_MARKET_FETCH_REQUEST,this.handleMarketFetch),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_INSTALL_REQUEST,(e=>withPluginLock((()=>this.handleInstall(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_UNINSTALL_REQUEST,(e=>withPluginLock((()=>this.handleUninstall(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_TOGGLE_REQUEST,(e=>withPluginLock((()=>this.handleToggle(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_UPDATE_REQUEST,(e=>withPluginLock((()=>this.handleUpdate(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_UPDATE_ALL_REQUEST,(()=>withPluginLock((()=>this.handleUpdateAll())))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_COPY_REQUEST,(e=>withPluginLock((()=>this.handleCopy(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_MANUAL_INSTALL_REQUEST,(e=>withPluginLock((()=>this.handleManualInstall(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_DETAIL_FETCH_REQUEST,this.handleDetailFetch),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_REFRESH_REQUEST,(()=>this.notifyPluginConfig()))),this.notifyPluginConfig()}notifyPluginConfig=async()=>{console.log(`${TAG} notifyPluginConfig: start`);try{const e=await this.getInstalledPlugins("global"),t=await this.getInstalledPlugins("project"),r={layered:{global:{plugins:e},project:{plugins:t}}};console.log(`${TAG} notifyPluginConfig: sending to webview, global=[${Object.keys(e).join(",")}] project=[${Object.keys(t).join(",")}]`),kernel.connect.sendWebviewMessage(PT_KERNEL_PLUGIN_CONFIG_UPDATED_NOTIFICATION,r),kernel.connect.sendWebviewMessage(PT_KERNEL_SKILL_METADATA_CHANGED_NOTIFICATION,{});let n=!1;const i=JSON.stringify(e),o=JSON.stringify(t);await Promise.all([this.checkForUpdates(e,"global"),this.checkForUpdates(t,"project")]),JSON.stringify(e)===i&&JSON.stringify(t)===o||(n=!0),n?(console.log(`${TAG} notifyPluginConfig: updates detected, sending second notification`),kernel.connect.sendWebviewMessage(PT_KERNEL_PLUGIN_CONFIG_UPDATED_NOTIFICATION,{layered:{global:{plugins:e},project:{plugins:t}}})):console.log(`${TAG} notifyPluginConfig: no updates detected`)}catch(e){console.error(`${TAG} notifyPluginConfig: FAILED`,e),kernel.logger.error(`${TAG} Failed to notify plugin config:`,e)}};getInstalledPlugins=async e=>{const t=await readPluginConfig(e),r=getPluginsBaseDir(e),n={};console.log(`${TAG} getInstalledPlugins(${e}): scanning dir=${r}`);try{const i=await fs$1j.readdir(r,{withFileTypes:!0}),o=i.filter((e=>e.isDirectory())).map((e=>e.name));console.log(`${TAG} getInstalledPlugins(${e}): found directories=[${o.join(",")}]`);for(const o of i){if(!o.isDirectory())continue;const i=path__default$1.join(r,o.name),s=t[o.name]||{},a=await scanPluginComponents(i);let c,l=o.name,A="",u="";const d=await this.readPluginMetadata(i,o.name);d?(l=d.name||o.name,A=d.description||"",u=d.version||"",console.log(`${TAG} getInstalledPlugins(${e}): [${o.name}] metadata from ${d.source}, name=${l} version=${u}`)):(c="未找到有效的插件描述文件（plugin.json、package.json、.claude-plugin/plugin.json 等均缺失或解析失败）",console.log(`${TAG} getInstalledPlugins(${e}): [${o.name}] no metadata file found`));const h=!!s.disabled;let p;p=c?"error":h?"disabled":"enabled",n[o.name]={name:l,key:o.name,description:A,version:u,icon:"",status:p,disabled:h,error:c,gitUrl:s.gitUrl,ref:s.ref,components:a},console.log(`${TAG} getInstalledPlugins(${e}): [${o.name}] status=${p} hasConfig=${!!t[o.name]}`)}}catch(t){console.log(`${TAG} getInstalledPlugins(${e}): dir not found or read error: ${t?.message}`)}console.log(`${TAG} getInstalledPlugins(${e}): result keys=[${Object.keys(n).join(",")}]`);for(const[r,i]of Object.entries(t))if(i?.expandedDirectory&&!n[r]){const t=i.subPlugins||[],o=[];for(const e of t)n[e]&&o.push(...n[e].components);n[r]={name:r,key:r,description:`插件目录（包含 ${t.length} 个子插件：${t.slice(0,5).join("、")}${t.length>5?"...":""}）`,version:"",icon:"",status:"enabled",disabled:!!i.disabled,gitUrl:i.gitUrl,ref:i.ref,components:o},console.log(`${TAG} getInstalledPlugins(${e}): [${r}] virtual entry for expanded directory repo (${t.length} sub-plugins)`)}return n};handleMarketFetch=async()=>{console.log(`${TAG} handleMarketFetch: start`);try{const e=kernel.config.key,t=getApiHost();console.log(`${TAG} handleMarketFetch: apiHost=${t} loginKey=${e}`);const r=await axiosInstance.get("/rest/autowork/v2/plugin/market/list",{baseURL:t,headers:{"login-name":e}}),n=r.data?.data??[];console.log(`${TAG} handleMarketFetch: API returned ${n.length} items, names=[${n.map((e=>e.name)).join(",")}]`);const i=await Promise.all(n.map((async e=>{const{description:t,version:r}=await this.fetchRemotePluginJson(e.gitUrl,e.ref);return{name:e.name,key:e.name,description:t,version:r,icon:"",source:e.source??"",gitUrl:e.gitUrl,ref:e.ref,components:[]}})));return console.log(`${TAG} handleMarketFetch: returning ${i.length} enriched items`),i}catch(e){return console.error(`${TAG} handleMarketFetch: API failed. error=${e?.message}`),kernel.logger.error(`${TAG} Failed to fetch market list:`,JSON.stringify({message:e?.message,status:e?.response?.status,data:e?.response?.data})),[]}};handleInstall=async e=>{const{name:t,gitUrl:r,ref:n,source:i}=e;console.log(`${TAG} handleInstall: name=${t} gitUrl=${r} ref=${n} source=${i}`);try{const e=getPluginsBaseDir(i);console.log(`${TAG} handleInstall: pluginsDir=${e}`),await fs$1j.mkdir(e,{recursive:!0});const o=path__default$1.join(e,t);let s=!1;try{await fs$1j.access(o),s=!0}catch{}if(s){if((await readPluginConfig(i))[t])return console.log(`${TAG} handleInstall: dir AND config both exist -> already installed`),await this.notifyPluginConfig(),{success:!1,message:"该 Plugin 已经安装"};console.log(`${TAG} handleInstall: dir exists but NO config entry -> orphaned dir, cleaning up`),await fs$1j.rm(o,{recursive:!0,force:!0})}if(!r)return console.log(`${TAG} handleInstall: missing gitUrl`),{success:!1,message:"缺少 gitUrl，无法安装"};console.log(`${TAG} handleInstall: starting git clone ${r} ref=${n||"main"}`),await this.gitClone(r,n||"main",t,e),console.log(`${TAG} handleInstall: git clone SUCCESS`);const a=await detectSubPlugins(o);if(a.length>0)return console.log(`${TAG} handleInstall: detected plugin directory repo with ${a.length} sub-plugins`),this.installFromPluginDirectory(o,a,i,r,n||"main");if(!await isValidPluginDir(o))return console.log(`${TAG} handleInstall: cloned repo is not a valid plugin, cleaning up`),await fs$1j.rm(o,{recursive:!0,force:!0}),{success:!1,message:"仓库不是有效的插件（缺少元数据文件和组件目录）"};const c=await this.getLocalCommit(o);console.log(`${TAG} handleInstall: localCommit=${c}`);const l=await readPluginConfig(i);return l[t]={enabled:!0,gitUrl:r,ref:n||"main",installedCommit:c},await writePluginConfig(i,l),await this.notifyPluginConfig(),console.log(`${TAG} handleInstall: DONE, plugin "${t}" installed (scope: ${i})`),{success:!0,message:"Plugin 安装成功"}}catch(e){return console.error(`${TAG} handleInstall: FAILED for "${t}":`,e?.message||e),kernel.logger.error(`${TAG} Failed to install plugin "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};installFromPluginDirectory=async(e,t,r,n,i)=>{const o=path__default$1.dirname(e),s=path__default$1.basename(e),a=await readPluginConfig(r),c=await this.getLocalCommit(e);let l=0,A=0;for(const e of t){const t=path__default$1.basename(e),r=path__default$1.join(o,t);if(a[t])console.log(`${TAG} installFromPluginDirectory: "${t}" already exists, skipping`),A++;else{try{await fs$1j.access(r),console.log(`${TAG} installFromPluginDirectory: orphaned dir "${t}" found, cleaning`),await fs$1j.rm(r,{recursive:!0,force:!0})}catch{}await fs$1j.cp(e,r,{recursive:!0}),a[t]={enabled:!0,gitUrl:n,ref:i,installedCommit:c,parentRepo:s},l++,console.log(`${TAG} installFromPluginDirectory: installed "${t}"`)}}const u=t.map((e=>path__default$1.basename(e)));a[s]={enabled:!0,gitUrl:n,ref:i,installedCommit:c,expandedDirectory:!0,subPlugins:u},await writePluginConfig(r,a),await fs$1j.rm(e,{recursive:!0,force:!0}),await this.notifyPluginConfig();const d=`从插件目录安装了 ${l} 个插件`+(A>0?`，跳过 ${A} 个已存在`:"");return console.log(`${TAG} installFromPluginDirectory: DONE. ${d}`),{success:!0,message:d}};handleUninstall=async e=>{const{name:t,source:r}=e;console.log(`${TAG} handleUninstall: name=${t} source=${r}`);try{const e=await readPluginConfig(r),n=getPluginsBaseDir(r);if(e[t]?.expandedDirectory){const r=e[t].subPlugins||[];console.log(`${TAG} handleUninstall: "${t}" is expanded directory, uninstalling ${r.length} sub-plugins`);for(const t of r){const r=path__default$1.join(n,t);await fs$1j.rm(r,{recursive:!0,force:!0}),delete e[t]}delete e[t]}else{const r=path__default$1.join(n,t);await fs$1j.rm(r,{recursive:!0,force:!0}),delete e[t]}return await writePluginConfig(r,e),await this.notifyPluginConfig(),console.log(`${TAG} handleUninstall: DONE for "${t}"`),{success:!0,message:"Plugin 卸载成功"}}catch(e){return console.error(`${TAG} handleUninstall: FAILED for "${t}":`,e?.message),kernel.logger.error(`${TAG} Failed to uninstall plugin "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleToggle=async e=>{const{name:t,disabled:r,source:n}=e;console.log(`${TAG} handleToggle: name=${t} disabled=${r} source=${n}`);try{const e=await readPluginConfig(n);e[t]||(e[t]={}),e[t].disabled=r,await writePluginConfig(n,e),await this.notifyPluginConfig()}catch(e){console.error(`${TAG} handleToggle: FAILED for "${t}":`,e),kernel.logger.error(`${TAG} Failed to toggle plugin "${t}":`,e)}};handleUpdate=async e=>{const{name:t,source:r}=e;console.log(`${TAG} handleUpdate: name=${t} source=${r}`);try{const n=await readPluginConfig(r),i=n[t]||{};if(i.expandedDirectory)return console.log(`${TAG} handleUpdate: "${t}" is expanded directory, re-installing`),await this.handleUninstall({name:t,source:r}),this.handleInstall({name:t,gitUrl:e.gitUrl||i.gitUrl,ref:e.ref||i.ref||"main",source:r});const o=e.gitUrl||i.gitUrl,s=e.ref||i.ref||"main";if(!o)return{success:!1,message:"缺少 gitUrl，无法更新"};const a=getPluginsBaseDir(r),c=path__default$1.join(a,t);await fs$1j.rm(c,{recursive:!0,force:!0}),await this.gitClone(o,s,t,a);const l=await this.getLocalCommit(path__default$1.join(a,t));return n[t]={...i,gitUrl:o,ref:s,installedCommit:l},await writePluginConfig(r,n),await this.notifyPluginConfig(),console.log(`${TAG} handleUpdate: DONE for "${t}"`),{success:!0,message:"Plugin 更新成功"}}catch(e){return console.error(`${TAG} handleUpdate: FAILED for "${t}":`,e?.message),kernel.logger.error(`${TAG} Failed to update plugin "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleUpdateAll=async()=>{console.log(`${TAG} handleUpdateAll: starting batch update`);let e=0,t=0;const r=["global","project"];for(const n of r){const r=await readPluginConfig(n);for(const[i,o]of Object.entries(r)){if(!o?.gitUrl||o.disabled)continue;(await this.handleUpdate({name:i,source:n})).success?e++:t++}}return console.log(`${TAG} handleUpdateAll: done updated=${e} failed=${t}`),{updated:e,failed:t}};handleCopy=async e=>{const{name:t,fromSource:r,toSource:n}=e;console.log(`${TAG} handleCopy: name=${t} from=${r} to=${n}`);try{const e=path__default$1.join(getPluginsBaseDir(r),t),i=path__default$1.join(getPluginsBaseDir(n),t);await fs$1j.mkdir(path__default$1.dirname(i),{recursive:!0}),await fs$1j.cp(e,i,{recursive:!0});const o=await readPluginConfig(r),s=await readPluginConfig(n);s[t]=o[t]||{enabled:!0},await writePluginConfig(n,s),await this.notifyPluginConfig()}catch(e){throw console.error(`${TAG} handleCopy: FAILED for "${t}":`,e),kernel.logger.error(`${TAG} Failed to copy plugin "${t}":`,e),e}};handleManualInstall=async e=>{const{folderPath:t,source:r}=e;console.log(`${TAG} handleManualInstall: folderPath=${t} source=${r}`);try{if(!(await fs$1j.stat(t)).isDirectory())return{success:!1,message:"所选路径不是文件夹"};const e=path__default$1.basename(t),n=getPluginsBaseDir(r);await fs$1j.mkdir(n,{recursive:!0});const i=path__default$1.join(n,e);let o=!1;try{await fs$1j.access(i),o=!0}catch{}if(o){if((await readPluginConfig(r))[e])return{success:!1,message:`Plugin "${e}" 已存在`};console.log(`${TAG} handleManualInstall: orphaned dir found, cleaning up`),await fs$1j.rm(i,{recursive:!0,force:!0})}if(!await isValidPluginDir(t))return{success:!1,message:"所选文件夹不是有效的插件（需包含 plugin.json、package.json、.claude-plugin/plugin.json 等元数据文件，或 skills/agents/commands 等组件目录）"};await fs$1j.cp(t,i,{recursive:!0});const s=await readPluginConfig(r);return s[e]={enabled:!0},await writePluginConfig(r,s),await this.notifyPluginConfig(),console.log(`${TAG} handleManualInstall: DONE for "${e}"`),{success:!0,message:"Plugin 安装成功"}}catch(e){return console.error(`${TAG} handleManualInstall: FAILED:`,e?.message),kernel.logger.error(`${TAG} Manual install failed:`,e),{success:!1,message:e?.message??"Unknown error"}}};handleDetailFetch=async e=>{const{name:t,source:r}=e;try{const e=getPluginsBaseDir(r),n=path__default$1.join(e,t),i=await scanPluginComponents(n);return{name:t,components:i,configPath:path__default$1.join(n,"plugin.json")}}catch(e){return kernel.logger.error(`${TAG} Failed to fetch plugin detail "${t}":`,e),{name:t,components:[],configPath:""}}};readPluginMetadata=async(e,t)=>{let r=t,n="",i="",o="";for(const s of PLUGIN_METADATA_FILES){if(o)break;try{const a=await fs$1j.readFile(path__default$1.join(e,s),"utf-8"),c=JSON.parse(a);r=c.name||t,n=c.description||"",i=c.version||"",o=s}catch{}}if(!o)return null;if(!n)try{const t=(await fs$1j.readFile(path__default$1.join(e,"README.md"),"utf-8")).split("\n");for(const e of t){const t=e.trim();if(t&&!t.startsWith("#")&&!t.startsWith("!")&&!t.startsWith("[")){n=t.length>120?t.slice(0,120)+"...":t;break}}}catch{}return{name:r,description:n,version:i,source:o}};gitClone=async(e,t,r,n)=>{const i=path__default$1.join(n,r);console.log(`${TAG} gitClone: git clone --depth 1 --branch ${t} ${e} ${i}`);try{const{stdout:r,stderr:n}=await execFileAsync("git",["clone","--depth","1","--branch",t,e,i]);r&&console.log(`${TAG} gitClone stdout: ${r.trim()}`),n&&console.log(`${TAG} gitClone stderr: ${n.trim()}`)}catch(e){throw console.error(`${TAG} gitClone FAILED: ${e?.message}`),e?.stderr&&console.error(`${TAG} gitClone stderr: ${e.stderr}`),e}};getLocalCommit=async e=>{try{const{stdout:t}=await execFileAsync("git",["-C",e,"rev-parse","HEAD"]);return t.trim()}catch{return""}};checkForUpdates=async(e,t)=>{const r=await readPluginConfig(t);for(const[n,i]of Object.entries(e)){const e=r[n]||{},{gitUrl:o,ref:s,installedCommit:a}=e;if(o&&a&&"error"!==i.status)try{const{stdout:e}=await execFileAsync("git",["ls-remote",o,s||"main"]),r=e.split(/\s/)[0]||"";r&&r!==a?(i.status="update",console.log(`${TAG} checkForUpdates(${t}): [${n}] UPDATE available (local=${a.slice(0,8)} remote=${r.slice(0,8)})`)):console.log(`${TAG} checkForUpdates(${t}): [${n}] up to date`)}catch(e){console.log(`${TAG} checkForUpdates(${t}): [${n}] ls-remote failed: ${e?.message}`)}else console.log(`${TAG} checkForUpdates(${t}): [${n}] skipped (gitUrl=${!!o} installedCommit=${!!a} status=${i.status})`)}};fetchRemotePluginJson=async(e,t)=>{for(const r of PLUGIN_METADATA_FILES)try{const n=this.buildRawUrl(e,t,r);if(!n)continue;const i=await axiosInstance.get(n,{timeout:5e3}),o="string"==typeof i.data?JSON.parse(i.data):i.data;if(o?.description||o?.version)return console.log(`${TAG} fetchRemotePluginJson: got metadata from ${r} for ${e}`),{description:o?.description||"",version:o?.version||""}}catch{}return{description:"",version:""}};buildRawUrl=(e,t,r)=>{const n=/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/.exec(e);return n?`https://raw.githubusercontent.com/${n[1]}/${n[2]}/${t}/${r}`:null};dispose(){for(const e of this.disposables)e();this.disposables.length=0}};function logInjection(e){return t=>e(t)}PluginMarketManager=__decorate([injectable(),__metadata("design:paramtypes",[])],PluginMarketManager);const iocContainer=new Container;iocContainer.applyMiddleware(logInjection);let serviceIsReady=!1;function updateServiceStatus(e){serviceIsReady=e}function active(){iocContainer.bind(EmbeddingsController).toSelf().inSingletonScope(),iocContainer.get(EmbeddingsController).run(),iocContainer.bind(PassthroughDemoService).toSelf().inSingletonScope(),iocContainer.get(PassthroughDemoService).start(),iocContainer.bind(PassthroughGitRepoService).toSelf().inSingletonScope(),iocContainer.get(PassthroughGitRepoService),iocContainer.bind(PassthroughModelListService).toSelf().inSingletonScope(),iocContainer.get(PassthroughModelListService),iocContainer.bind(PlusService).toSelf().inSingletonScope(),iocContainer.get(PlusService).start(),iocContainer.bind(HistoryService).toSelf().inSingletonScope(),iocContainer.get(HistoryService),iocContainer.bind(QuotaService).toSelf().inSingletonScope(),iocContainer.get(QuotaService),iocContainer.bind(SecurityFilter$1).toSelf().inSingletonScope(),iocContainer.get(SecurityFilter$1).start(),iocContainer.bind(MemoryService).toSelf().inSingletonScope(),iocContainer.get(MemoryService),iocContainer.bind(TabsController).toSelf().inSingletonScope(),iocContainer.get(TabsController),iocContainer.bind(LSPService).toSelf().inSingletonScope(),iocContainer.get(LSPService).run(),iocContainer.bind(UpdateNotificationService).toSelf().inSingletonScope(),iocContainer.get(UpdateNotificationService),isVscode&&(iocContainer.bind(ScanScheduler).toSelf().inSingletonScope(),iocContainer.get(ScanScheduler).initialize()),iocContainer.bind(SkillsManager).toSelf().inSingletonScope(),iocContainer.get(SkillsManager),iocContainer.bind(ImageResolveService).toSelf().inSingletonScope(),iocContainer.get(ImageResolveService),iocContainer.bind(FeatureSetProvider).toSelf().inSingletonScope(),iocContainer.get(FeatureSetProvider),iocContainer.bind(PluginMarketManager).toSelf().inSingletonScope(),iocContainer.get(PluginMarketManager)}const VALID_STATUSES=["pending","in_progress","completed"];class TodoWrite extends Handler{constructor(e,t,r){super("todo_write",e,t,r)}todos=[];async beforeExecute(){const e=this.getJSONParam("todos");e&&Array.isArray(e)||this.throwValidationError(ToolError.todo_write.parameter_required),e.length<2&&this.throwValidationError(ToolError.todo_write.todos_too_few({number:e.length}));const t=e.find((e=>!e.content)),r=e.find((e=>!e.status));t&&r&&this.throwValidationError(ToolError.todo_write.missing_required_params({params:"content, status"})),t&&this.throwValidationError(ToolError.todo_write.missing_required_params({params:"content"})),r&&this.throwValidationError(ToolError.todo_write.missing_required_params({params:"status"}));const n=e.map((e=>e.status)).find((e=>!VALID_STATUSES.includes(e)));n&&this.throwValidationError(ToolError.todo_write.invalid_status({status:n})),this.todos=e}async execute(e){const t=this.todos.filter((e=>"completed"===e.status)).length;let r=`Todos have been modified successfully. Current Todo States: ${t} complete, ${this.todos.filter((e=>"in_progress"===e.status)).length} in_progress, ${this.todos.filter((e=>"pending"===e.status)).length} pending\nEnsure that you continue to use the todo list to track your progress. Please proceed with the current tasks if applicable`;const n=iocContainer.get(FeatureSetProvider),i=(await n.getFeatures(["en_verif_sub"])).en_verif_sub;if(i?.enabled&&i?.value){if(this.todos.length>0&&t===this.todos.length){this.todos.slice(-3).some((e=>e.content.toLowerCase().includes("verif")))||(r+="\n\n"+systemReminderBuilder('You just closed all tasks and none of the last 3 steps was a verification step. Before writing your final summary, spawn the verification agent (agent_type="Verification"). You cannot self-assign PARTIAL by listing caveats in your summary — only the verifier issues a verdict.'))}}return this.result={output:r,metadata:{todos:this.todos}},this.result}}const MEMORY_LIMIT=100;class MemoryHandler extends FsHandler{get path(){return join$6(this.ctx.rootPath,WORKSPACE_MEMORY_PATH)}constructor(e,t,r,n){super(e,t,r,n)}async getAllMemories(){return await getWorkspaceMemories()}async getMemory(e){return await getWorkspaceMemory(e)}async createMemory(e,t){return(await this.getAllMemories()).length>=MEMORY_LIMIT&&this.throwExecuteError(`Memory limit exceeded: ${MEMORY_LIMIT}`),await createWorkspaceMemory({topic:e,memory_to_store:t})}async updateMemory(e,t,r){return await this.getMemory(e)||this.throwExecuteError(`Memory not found: ${e}`),await updateWorkspaceMemory({memory_id:e,topic:t,memory_to_store:r})}async deleteMemory(e){return await this.getMemory(e)||this.throwExecuteError(`Memory not found: ${e}`),await deleteWorkspaceMemory(e)}async backupMemories(){try{const e=await this.ctx.virtualEditor.getDocument({absolutePath:this.path});return e.existed?e.content:null}catch{return null}}}class UpdateMemory extends MemoryHandler{constructor(e,t,r){super("update_memory",e,t,r)}async beforeExecute(){super.beforeExecute(),this.originalContent=await this.backupMemories();const e=this.getParam("action");this.validateAction(e)}validateAction(e){"create"!==e&&"update"!==e&&"delete"!==e&&this.throwValidationError(ToolError.update_memory.invalid_action({action:e||""})),"create"===e?this.validateCreateParams():"update"===e?this.validateUpdateParams():"delete"===e&&this.validateDeleteParams()}validateCreateParams(){const e=this.getStringParam("topic"),t=this.getStringParam("memory_to_store");e||this.throwValidationError(ToolError.update_memory.parameter_required({action:"create",param:"topic"})),t||this.throwValidationError(ToolError.update_memory.parameter_required({action:"create",param:"memory_to_store"}))}validateUpdateParams(){const e=this.getStringParam("memory_id"),t=this.getStringParam("topic"),r=this.getStringParam("memory_to_store");e||this.throwValidationError(ToolError.update_memory.parameter_required({action:"update",param:"memory_id"})),t||this.throwValidationError(ToolError.update_memory.parameter_required({action:"update",param:"topic"})),r||this.throwValidationError(ToolError.update_memory.parameter_required({action:"update",param:"memory_to_store"}))}validateDeleteParams(){this.getStringParam("memory_id")||this.throwValidationError(ToolError.update_memory.parameter_required({action:"delete",param:"memory_id"}))}async execute(e){const t=this.getParam("action"),r=this.getStringParam("memory_id"),n=this.getStringParam("topic"),i=this.getStringParam("memory_to_store");try{let e;"create"===t?e=await super.createMemory(n,i):"update"===t?e=await super.updateMemory(r,n,i):"delete"===t?e=await super.deleteMemory(r):this.throwExecuteError(ToolError.update_memory.invalid_action({action:t}));const o=await this.getAllMemories(),s=JSON.stringify(o,null,2);return this.result.output=`Memory ${e.memory_id} ${"create"===t?"created":"updated"} successfully`,this.result.metadata.originalContent=this.originalContent,this.result.metadata.content=s,this.result.metadata.memoryId=e.memory_id,this.result.metadata.topic=e.topic,this.result}catch(e){if(e instanceof Error&&e.cause===MEMORY_FORMAT_ERROR_CAUSE)throw e.message+MEMORY_FORMAT_VALIDATION_TOOLTIP_FOR_API;const t=e instanceof Error?e.message:String(e);if((t.includes("找不到ID为")||t.includes("Memory not found"))&&this.throwExecuteError(ToolError.update_memory.memory_not_found({memory_id:r||""})),e instanceof Error&&t.includes("Failed to read/write")){const e=t.slice(0,50);this.throwExecuteError(ToolError.update_memory.file_io_error({detail:e}))}throw e}}async cancel(){await super.revert()}}async function webSearch(e){try{return(await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/agent/websearch",e,{headers:getRequestUserHeader()})).data.data}catch(e){return kernel.logger.error("Zulu","webSearch failed",e),[]}}class WebSearch extends Handler{constructor(e,t,r){super("web_search",e,t,r)}async beforeExecute(){this.getStringParam("query")||this.throwValidationError(ToolError.common.parameter_required({arg:"query"}))}async execute(e){const t=this.getStringParam("query");try{const r=e.traceId,n=e.conversationId,i=e.taskId,o=this.toolId,s=await webSearch({conversationId:n,taskId:i,toolId:o,query:t,traceId:r});if(0===s.length)throw ToolError.web_search.no_results;const a=`Web search results for query: ${t}\n\n${s.map((e=>`Title: ${e.title}\nURL: ${e.url}\nContent: ${e.content||e.text_markdown}`)).join("\n\n---\n\n")}`;return this.result.output=a,this.result.metadata.sites=s.map((e=>({content:e.content?.length>500?e.content.slice(0,500)+"...":e.content,title:e.title,url:e.url,favicon:e.favicon,source:e.source}))),this.result}catch(e){kernel.logger.error("websearch",`Web search failed: ${e.message}`),e instanceof CanceledError&&this.throwExecuteError(ToolError.common.execution_aborted),this.throwExecuteError(ToolError.web_search.execution_failed({error:e.message}))}}}async function webFetch(e){try{return(await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/agent/webfetch",e,{headers:getRequestUserHeader()})).data.data}catch(e){return kernel.logger.error("Zulu","webFetch failed",e),null}}class WebFetch extends Handler{constructor(e,t,r){super("web_fetch",e,t,r)}async beforeExecute(){this.getStringParam("url")||this.throwValidationError(ToolError.common.parameter_required({arg:"url"}))}async execute(e){const t=this.getStringParam("url"),r=this.getStringParam("prompt");try{const n=e.traceId,i=e.conversationId,o=e.taskId,s=this.toolId,a=await webFetch({conversationId:i,taskId:o,toolId:s,urls:[t],query:r,traceId:n});if(!a||0===a.length)throw ToolError.web_fetch.no_results;const c=a[0],l=`${c.content}`;return this.result.output=l,this.result.metadata.site={content:c.content?.length>500?c.content.slice(0,500)+"...":c.content,title:c.title,url:c.url,source:c.source},this.result}catch(e){kernel.logger.error("webfetch",`Web fetch failed: ${e.message}`),e instanceof CanceledError&&this.throwExecuteError(ToolError.common.execution_aborted),this.throwExecuteError(ToolError.web_fetch.execution_failed({error:e.message}))}}}class WriteFile extends FsHandler{constructor(e,t,r){super("write_file",e,t,r)}get path(){return this.getStringParam("path")}get content(){return this.getStringParam("content")}onUpdateParams(e){super.onUpdateParams(e);const t=this.getStringParam("content");this.result.metadata.diff=t?{add:t.split(/\r?\n/).length,remove:0}:void 0}async beforeExecute(){await super.beforeExecute();const e=this.getStringParam("path"),t=this.getStringParam("content");e||this.throwValidationError(ToolError.common.parameter_required({arg:"path"})),void 0===t&&this.throwValidationError(ToolError.common.parameter_required({arg:"content"})),isFileEditable(e)||this.throwValidationError(ToolError.write_file.can_not_edit({path:e}));const r=await this.ctx.virtualEditor.getDocument({absolutePath:this.absolutePath});this.assertFileConsistency(r),this.originalContent=r.existed?r.content:null}async execute(){const e=this.getStringParam("content"),t=this.ctx.specEditor?.isSpec&&isDocOrTasksFile(this.absolutePath)&&this.getBooleanParam("ask_review");await this.createDocument(e),this.ctx.fileConsistencyChecker.save(this.absolutePath,e,"write_file");const r=this.computeDiffLine(this.originalContent||"",e);return this.result.output="Write file success",this.result.metadata.originalContent=this.originalContent,this.result.metadata.content=e,this.result.metadata.diff=r,this.result.metadata.askReview=t,this.result}async afterExecute(){this.ctx.specEditor?.afterFileChange(this)}}function generateUniqueOptionId(e){const t=new Set(e.map((e=>e.id))),r="other_option";if(!t.has(r))return r;let n=1;for(;t.has(`${r}_${n}`);)n++;return`${r}_${n}`}class AskUserQuestion extends Handler{constructor(e,t){super("ask_user_question",e,t),t.onNotify((e=>{if("conversationStart"===e.name)return void this.completeIfPending();if(e.payload?.toolId!==this.toolId)return;const t=e.name;"confirm"===t?(this.result.metadata.state="completed",this.updateOutput(),this.token.getRoot().broadcast("resume-stream",{})):"updateAnswer"===t&&this.updateAnswer(e.payload.payload)}))}rebuildResult(e){super.rebuildResult(e),this.result.metadata.state="completed"}async beforeExecute(){const e=this.getStringParam("title"),t=this.getJSONParam("questions");t&&Array.isArray(t)||this.throwValidationError(ToolError.ask_user_question.parameter_required),t.length<1&&this.throwValidationError(ToolError.ask_user_question.questions_empty);for(const e of t){e.id||this.throwValidationError(ToolError.ask_user_question.missing_question_fields({field:"id"})),e.prompt||this.throwValidationError(ToolError.ask_user_question.missing_question_fields({field:"prompt"})),e.options&&Array.isArray(e.options)||this.throwValidationError(ToolError.ask_user_question.missing_question_fields({field:"options"})),e.options.length<2&&this.throwValidationError(ToolError.ask_user_question.options_too_few({questionId:e.id}));for(const t of e.options)t.id||this.throwValidationError(ToolError.ask_user_question.missing_option_fields({field:"id"})),t.label||this.throwValidationError(ToolError.ask_user_question.missing_option_fields({field:"label"}))}this.result={output:"",metadata:{title:e,questions:this.buildQuestionsWithOtherOption(t),state:"pending"}},this.updateOutput()}async execute(){return this.updateOutput(),this.result}updateOutput(){const{questions:e=[]}=this.result.metadata,t=["User questions responses:"];for(const r of e)t.push(`Question ${r.id}: ${this.formatSelectedOptions(r)}`);this.result.output=t.join("\n")}formatSelectedOptions(e){const t=e.options[e.options.length-1],r=e.selectedOptionIds?.filter((e=>e!==t.id)),n=[];return r.length>0&&n.push(`Selected option(s) ${r.join(", ")}`),e.selectedOptionIds.includes(t.id)&&n.push(`freeform: ${t.label}`),0===n.length?"No answer provided":n.join(", ")}updateAnswer(e){if(!e)return;const t=this.result.metadata.questions?.find((t=>t.id===e.questionId));if(!t)return;const{selectedOptionIds:r,otherAnswer:n}=e;if(Array.isArray(r)&&(t.selectedOptionIds=r),"string"==typeof n){t.options[t.options.length-1].label=n}this.updateOutput(),this.token.update()}buildQuestionsWithOtherOption(e){return e.map((e=>({...e,options:[...e.options,{id:generateUniqueOptionId(e.options),label:""}],selectedOptionIds:[]})))}completeIfPending(){"completed"!==this.result.metadata.state&&(this.result.metadata.state="completed",this.updateOutput())}}const MOCK_QUERY="Implement the plan as specified, it is attached for your reference. Do NOT edit the plan file itself.";function buildExecuteOutput(e,t,r){const n=[`Plan file created at: ${e}`];return r&&n.push("","After the file is written, the user modifies it as follows:",r),n.push("",`You can read the plan contents from this file. Note that this is currently in the user's home directory. If at any point you can no longer find it there, the user may have moved it to the workspace ${t} directory.`,"","To update this plan, use your file editing tools directly on this file. Do NOT call create_plan again to update the plan."),n.join("\n")}function getFirstNonEmptyLines(e,t){const r=e.split("\n"),n=[];let i=0;for(const e of r)if(n.push(e),e.trim()&&i++,i>=t)break;return n.join("\n")}class CreatePlan extends FsHandler{static plansDir=join$7(homedir$1(),".comate","plans");randomId=randomBytes$2(4).toString("hex");constructor(e,t){super("create_plan",e,t),t.onNotify((e=>{"conversationStart"!==e.name&&"conversationEnd"!==e.name?e.payload?.toolId===this.toolId?"buildPlan"===e.name&&this.startPlanBuild():"buildPlan"===e.name&&this.completeIfPending():this.completeIfRunning()}))}get path(){const e=this.getStringParam("name");if(!e)return"";const t=`${e.replace(/[<>:"/\\|?*\s]/g,"_")}_${this.randomId}.plan.md`;return join$7(CreatePlan.plansDir,t)}get content(){return this.getStringParam("plan")}get workspacePlansDir(){return join$7(this.ctx.rootPath,".comate","plans")}onUpdateParams(e){super.onUpdateParams(e);const t=this.getStringParam("name");t&&(this.result.metadata.name=t);const r=this.getStringParam("plan");r&&(this.result.metadata.overview=getFirstNonEmptyLines(r,8))}rebuildResult(e){super.rebuildResult(e),this.result.metadata.state="completed"}async beforeExecute(){await super.beforeExecute();const e=this.getStringParam("name"),t=this.getStringParam("plan");e||this.throwValidationError(ToolError.common.parameter_required({arg:"name"})),t||this.throwValidationError(ToolError.common.parameter_required({arg:"plan"})),this.originalContent=null}async execute(){const e=this.getStringParam("plan");return await this.createDocument(e),this.ctx.fileConsistencyChecker.save(this.absolutePath,e,"create_plan"),isComateIDE?await this.syncPlanStateToIde("pending",!0):await this.ctx.virtualEditor.openDocument({absolutePath:this.absolutePath}),this.result.output=buildExecuteOutput(this.absolutePath,this.workspacePlansDir),this.result.metadata.state="pending",this.result.metadata.originalContent=null,this.result}updateState(e,t=!1){this.result.metadata.state=e,t&&this.forceUpdateCurrentToolWebview(),this.syncPlanStateToIde(e,!1)}async revert(){await super.revert(),isComateIDE&&await this.ctx.virtualEditor.closePlanDocument({conversationId:this.ctx.traceId,toolId:this.toolId})}async syncPlanStateToIde(e,t){isComateIDE&&await this.ctx.virtualEditor.openPlanDocument({filePath:this.absolutePath,conversationId:this.ctx.traceId,toolId:this.toolId,status:e,isOpen:t})}completeIfRunning(){"running"===this.result.metadata.state&&this.updateState("completed",!1)}completeIfPending(){"pending"===this.result.metadata.state&&this.updateState("completed",!0)}async updateOutputWithDiff(){try{const{existed:e,content:t}=await this.ctx.virtualEditor.getDocument({absolutePath:this.absolutePath});if(!e)return;const r=this.getStringParam("plan");if(r&&t!==r){const e=markDiffContent(r,t);this.result.output=buildExecuteOutput(this.absolutePath,this.workspacePlansDir,e)}}catch{}}async startPlanBuild(){this.updateState("running",!0),await this.updateOutputWithDiff();const e={query:MOCK_QUERY,isMockQuery:!0,agent:{agentId:1,agentName:"Agent",isProjectAgent:!1},knowledgeList:[{id:this.result.metadata.absolutePath,type:ContextType$2.FILE,path:this.result.metadata.absolutePath}]};this.token.getRoot().broadcast("resume-stream",e)}}class DocRead extends FsHandler{constructor(e,t,r){super("doc_read",e,t,r)}get relativePath(){return this.getStringParam("target_file")}async beforeExecute(){this.getStringParam("target_file")||this.throwValidationError('Parameter "target_file" is required')}async execute(){const e=this.getStringParam("target_file"),[t,...r]=e.replace(/^\//,"").split("/"),n=r.join("/"),i=knowledgeService.queryKnowledge(t,n);i||this.throwExecuteError(`Knowledge file "${n}" not found`);const o=i.knowledgeId,s=(await readKnowledgeContentById({knowledgeIds:[o],traceId:this.ctx.traceId})).find((e=>e.knowledgeId===o));if(!s?.content)return this.result.output="<file>\n</file>\n<metadata>The file is empty.</metadata>",this.result.metadata.startLine=1,this.result.metadata.endLine=0,this.result.metadata.url=s?.url,this.result;const a=this.getNumberParam("offset")||1,c=safeSplitEol(s.content).length,l=this.getNumberParam("limit"),A=l?Math.min(c,a+l):c,u=toReadFileResult(s.content,a,A);return this.result.output=u.output,this.result.metadata.startLine=a,this.result.metadata.endLine=u.endLine,this.result.metadata.url=s?.url,this.result}}class DocList extends Handler{constructor(e,t,r){super("doc_list",e,t,r)}async beforeExecute(){this.getStringParam("target_directory")||this.throwValidationError('Parameter "target_directory" is required')}async execute(){const e=this.getStringParam("target_directory"),t=e.split("/").filter(Boolean)[0],r=knowledgeService.queryFolder(t);if(!r){const e=generateKnowledgeSummary(this.ctx.parameterCollector.getKnowledgeContexts());this.throwExecuteError(`Directory '${t}' does not exist. You can access the following content of knowledge base: \n${e}`)}const n=await knowledgeService.getWorksaceKnowledges({query:"",workspaceId:r.uuid,traceId:this.ctx.traceId}),i=n.length;if(0===i)this.result.output="The knowledge base is empty";else{const e=[`${t}/`];for(const t of n)e.push(`  - ${t.knowledgeName}`);this.result.output=`${t}\\\n`+e.join("\n")}return this.result.metadata.relativePath=e,this.result.metadata.totalCount=i,this.result.metadata.isTruncated=!1,this.result}}class DocSearch extends Handler{constructor(e,t,r){super("doc_search",e,t,r)}async beforeExecute(){this.getStringParam("query")||this.throwValidationError('Parameter "query" is required')}async execute(e){const t=this.getStringParam("query"),r=e.parameterCollector.getKnowledgeContexts(),n=(await knowledgeService.searchEmbeddingKnowledgeChunk({additionalQueries:[t],contexts:reformatKnowledgeContextType(r),traceId:e.traceId})).map((e=>({...e,match:e.content,path:e.knowledgeName})));return this.result.output=formatCodebaseSearchOutput(n),this.result.metadata.relevantFiles=n.map((e=>_$H.pick(e,["path","startLine","endLine","url","retrievalType"]))),this.result}}class RemoteVscodeAPI{commands={executeCommand:(e,...t)=>kernel.connect.sendRequest(PT_KERNEL_BROWSER_COMMAND_EXECUTE,{command:e,args:t})};onClose(e){return kernel.connect.onNotification(PT_KERNEL_BROWSER_COMMAND_NOTIFICATION,(t=>{"close"===t.type&&t.id&&e({id:t.id})}))}onOpen(e){return kernel.connect.onNotification(PT_KERNEL_BROWSER_COMMAND_NOTIFICATION,(t=>{"open"===t.type&&t.id&&e({id:t.id})}))}onConsole(e){return kernel.connect.onNotification(PT_KERNEL_BROWSER_COMMAND_NOTIFICATION,(t=>{"console"===t.type&&e(t.messages??[])}))}}const CORE_SPECIFIER="@baidu/comate-browser-use/core",VSCODE_SPECIFIER="@baidu/comate-browser-use/adapter-vscode",CHROME_ADAPTER_SPECIFIER="@baidu/comate-browser-use/adapter-chrome",CHROME_LAUNCH_SPECIFIER="@baidu/comate-browser-use/launch-chrome";let browserUseCorePromise=null,browserUseVscodePromise=null,browserUseChromePromise=null;function getResolvedEntry(e){try{const t=import.meta.resolve;return"function"==typeof t?t(e):void 0}catch{return}}async function loadBrowserUseCore(){if(!browserUseCorePromise){const e=getResolvedEntry(CORE_SPECIFIER);kernel.logger.info("[AutomationBrowser] loading browser-use core",{resolvedEntry:e}),browserUseCorePromise=import(CORE_SPECIFIER).then((t=>(kernel.logger.info("[AutomationBrowser] loaded browser-use core",{resolvedEntry:e,exports:Object.keys(t).sort()}),t))).catch((t=>{throw browserUseCorePromise=null,kernel.logger.error("[AutomationBrowser] failed to load browser-use core",{resolvedEntry:e,error:t}),t}))}return browserUseCorePromise}async function loadBrowserUseVscode(){if(!browserUseVscodePromise){const e=getResolvedEntry(VSCODE_SPECIFIER);kernel.logger.info("[AutomationBrowser] loading browser-use vscode adapter",{resolvedEntry:e}),browserUseVscodePromise=import(VSCODE_SPECIFIER).then((t=>(kernel.logger.info("[AutomationBrowser] loaded browser-use vscode adapter",{resolvedEntry:e,exports:Object.keys(t).sort()}),t))).catch((t=>{throw browserUseVscodePromise=null,kernel.logger.error("[AutomationBrowser] failed to load browser-use vscode adapter",{resolvedEntry:e,error:t}),t}))}return browserUseVscodePromise}async function loadBrowserUseChrome(){if(!browserUseChromePromise){const e=getResolvedEntry(CHROME_ADAPTER_SPECIFIER),t=getResolvedEntry(CHROME_LAUNCH_SPECIFIER);kernel.logger.info("[AutomationBrowser] loading browser-use chrome runtime",{adapterEntry:e,launchEntry:t}),browserUseChromePromise=Promise.all([import(CHROME_ADAPTER_SPECIFIER),import(CHROME_LAUNCH_SPECIFIER)]).then((([r,n])=>{const i={ChromeContext:r.ChromeContext,ChromeBrowserManager:n.ChromeBrowserManager};return kernel.logger.info("[AutomationBrowser] loaded browser-use chrome runtime",{adapterEntry:e,launchEntry:t,exports:Object.keys(i).sort()}),i})).catch((r=>{throw browserUseChromePromise=null,kernel.logger.error("[AutomationBrowser] failed to load browser-use chrome runtime",{adapterEntry:e,launchEntry:t,error:r}),r}))}return browserUseChromePromise}const STANDALONE_BROWSER_EXECUTABLE_CANDIDATES={darwin:[["chrome-mac","Chromium.app","Contents","MacOS","Chromium"]],linux:[["chrome-linux","chrome"]],win32:[["chrome-win","chrome.exe"],["chrome-win64","chrome.exe"]]};function parseChromiumRevision(e){const t=e.match(/^chromium-(\d+)$/u);return t?Number(t[1]):-1}function resolveStandaloneBrowserExecutablePath(e,t=process.platform){const r=STANDALONE_BROWSER_EXECUTABLE_CANDIDATES[t];if(!r||!fs__default$1.existsSync(e))return;const n=fs__default$1.readdirSync(e,{withFileTypes:!0}).filter((e=>e.isDirectory())).map((e=>e.name)).filter((e=>e.startsWith("chromium-"))).sort(((e,t)=>parseChromiumRevision(t)-parseChromiumRevision(e)));for(const t of n)for(const n of r){const r=path__default.join(e,t,...n);if(fs__default$1.existsSync(r))return r}}class BrowserRuntimeService{static instance=null;runtime=null;listenersBound=!1;initializingPromise=null;static getInstance(){return BrowserRuntimeService.instance||(BrowserRuntimeService.instance=new BrowserRuntimeService),BrowserRuntimeService.instance}constructor(){}async getContext(){this.ensureConfigListeners();const e=this.resolveMode();if("off"===e)throw new Error("Browser use is disabled. Please enable it in settings.");this.runtime||(this.initializingPromise||(this.initializingPromise=this.createRuntime(e).finally((()=>{this.initializingPromise=null}))),this.runtime=await this.initializingPromise);return this.runtime.mode===e&&await this.isRuntimeAlive(this.runtime)||await this.reset(e),this.runtime||(this.runtime=await this.createRuntime(e)),await this.ensureRuntimeReady(this.runtime),this.runtime.context}async reset(e=this.resolveMode(),t={}){await this.closeRuntime(),t.eager&&"off"!==e&&(this.runtime=await this.createRuntime(e))}async clearData(){const e=this.resolveMode();await this.reset(e,{eager:!0})}async dispose(){await this.closeRuntime()}resolveMode(){return kernel.config?.browserConfig?.browserMode??"chrome"}ensureConfigListeners(){if(this.listenersBound)return;const e=kernel.config?.onDidChangeConfig;if("function"!=typeof e)return;let t=this.resolveMode();const r=async(e=this.resolveMode())=>{e!==t&&(t=e,await this.reset(e))};e("browserMode",(async e=>{await r(e??this.resolveMode())})),e("browserConfig",(async e=>{await r(e?.browserMode??this.resolveMode())})),this.listenersBound=!0}async createRuntime(e){switch(kernel.logger.info("[AutomationBrowser] creating runtime",{mode:e}),e){case"standalone":{const t=await loadBrowserUseChrome(),r=this.getStandaloneUserProfilePath(),n=this.resolveStandaloneExecutablePath();if(!n)throw new Error("Standalone browser executable not found in ~/.comate-engine/browser.");const i=9223,o=new t.ChromeBrowserManager;try{let s;try{s=await o.launch({executablePath:n,userDataDir:r,debuggingPort:i,timeout:3e4})}catch(e){this.killStandaloneOrphan(r),s=await o.launch({executablePath:n,userDataDir:r,debuggingPort:i,timeout:3e4})}const a=o.getPersistentContext();if(!a)throw new Error("Standalone browser launched without a persistent context.");const c=await t.ChromeContext.fromBrowser(s,a);return kernel.logger.info("[AutomationBrowser] standalone runtime ready",{mode:e,executablePath:n}),{manager:o,context:c,mode:e}}catch(t){throw await o.close().catch((()=>null)),kernel.logger.error("[AutomationBrowser] standalone runtime failed",{mode:e,error:t}),t}}case"chrome":{const t=await loadBrowserUseChrome(),r=new t.ChromeBrowserManager,n=await r.launchAndConnectCDP(),i=r.getPersistentContext(),o={manager:r,context:await t.ChromeContext.fromBrowser(n,i),mode:"chrome"};return await this.ensureRuntimeReady(o),kernel.logger.info("[AutomationBrowser] chrome runtime ready",{mode:e}),o}case"builtin":{const t=await loadBrowserUseVscode(),r=new RemoteVscodeAPI,n=await t.VscodeContext.create(r);return kernel.logger.info("[AutomationBrowser] builtin runtime ready",{mode:e}),{manager:null,context:n,mode:e}}default:throw new Error(`Unsupported browser mode: ${e}`)}}getStandaloneUserProfilePath(){return path__default.join(os__default$1.homedir(),".comate-engine","browser","comate-automation-browser-profile")}getStandaloneBrowserRootPath(){return path__default.join(os__default$1.homedir(),".comate-engine","browser")}resolveStandaloneExecutablePath(){return resolveStandaloneBrowserExecutablePath(this.getStandaloneBrowserRootPath())}killStandaloneOrphan(e){try{"win32"===process.platform?spawnSync$2("powershell.exe",["-NoProfile","-NonInteractive","-Command",`Get-WmiObject Win32_Process | Where-Object {$_.CommandLine -like '*${e}*'} | ForEach-Object {$_.Terminate()}`],{stdio:"ignore"}):spawnSync$2("pkill",["-f",e],{stdio:"ignore"})}catch{}}async closeRuntime(){const e=this.runtime;if(this.runtime=null,e){try{await e.context.close()}catch{}if(e.manager)try{await e.manager.close()}catch{}}}async isRuntimeAlive(e){if(e.context.isClose)return!1;if(e.manager&&!e.manager.isRunning())return!1;if("chrome"!==e.mode)return!0;try{return(await e.context.getPages()).some((e=>!e.isClosed()))}catch{return!1}}async ensureRuntimeReady(e){if("chrome"===e.mode)try{const t=(await e.context.getPages()).find((e=>!e.isClosed()))??await e.context.getSelectedPage();if(!t||t.isClosed())throw new Error("Chrome runtime has no active page");await t.bringToFront()}catch(t){if(this.runtime===e)return await this.closeRuntime(),void(this.runtime=await this.createRuntime("chrome"));throw t}}}function buildAutomationBrowserOutput(e,t=""){return"skipped"===e?"Browser action was skipped by user.":"aborted"===e?"Browser action was aborted by user.":"success"!==e||t?t:"Browser action completed successfully."}const COMMAND_MAP={navigate:"browser_navigate",open:"browser_navigate",go:"browser_navigate",click:"browser_click",dblclick:"browser_click",rightclick:"browser_click",click_at:"browser_click_at",type:"browser_type",screenshot:"browser_take_screenshot",snapshot:"browser_take_snapshot",html:"browser_get_html",scroll:"browser_scroll",back:"browser_go_back",forward:"browser_go_forward",reload:"browser_reload",status:"browser_get_state",evaluate:"browser_evaluate",eval:"browser_evaluate",new_page:"browser_new_page",close_page:"browser_close_page",select_page:"browser_select_page",fill_form:"browser_fill_form",console:"browser_get_console_messages",drag:"browser_drag"},SCREENSHOT_FORMATS$1=new Set(["png","jpeg","webp"]),SCROLL_DIRECTIONS=new Set(["up","down","left","right"]),CLICK_BUTTONS=new Set(["left","right","middle"]),MODIFIER_ALIASES={alt:"Alt",cmd:"Meta",command:"Meta",control:"Control",controlormeta:"ControlOrMeta",ctrl:"Control",meta:"Meta",shift:"Shift"};function tokenizeAutomationBrowserCommand(e){const t=e.trim(),r=[];let n="",i=null,o=!1,s=!1;for(let e=0;e<t.length;e++){const a=t[e],c=t[e+1];if(o)n+=a,s=!0,o=!1;else if("\\"!==a)i?a===i?i=null:(n+=a,s=!0):'"'!==a&&"'"!==a?/\s/u.test(a)?s&&(r.push(n),n="",s=!1):(n+=a,s=!0):(i=a,s=!0);else{if(c&&(i&&c===i||!i&&('"'===c||"'"===c||"\\"===c||/\s/u.test(c)))){o=!0,s=!0;continue}n+=a,s=!0}}return o&&(n+="\\",s=!0),s&&r.push(n),r}function parseInteger(e,t){const r=Number.parseInt(e||"",10);if(Number.isNaN(r))throw new Error(`${t} expects an integer value.`);return r}function parseNumber(e,t){const r=Number(e);if(!Number.isFinite(r))throw new Error(`${t} expects a numeric value.`);return r}function collectOptionValues(e,t){const r=[];let n=t;for(;n<e.length&&!e[n].startsWith("--");)r.push(e[n]),n++;return{values:r,nextIndex:n-1}}function normalizeModifiers(e){return e.flatMap((e=>e.split(","))).map((e=>e.trim())).filter(Boolean).map((e=>MODIFIER_ALIASES[e.toLowerCase()]||e))}function normalizeFillFormFields(e){if(!Array.isArray(e))throw new Error("fill_form expects a JSON array of fields or an object with a fields array.");return e.map((e=>{if(!e||"object"!=typeof e)return e;const t=e;return t.ref||!t.uid?t:{...t,ref:t.uid}}))}function parseFillFormParams(e){let t,r="";for(let t=0;t<e.length;t++){const n=e[t];if(("--fields"===n||"--json"===n)&&e[t+1]){r=e.slice(t+1).join(" ");break}if(!n.startsWith("--")){r=e.slice(t).join(" ");break}}if(!r.trim())throw new Error("fill_form expects JSON field definitions.");try{t=JSON.parse(r)}catch(e){throw new Error(`fill_form expects valid JSON. ${e instanceof Error?e.message:String(e)}`)}return{fields:normalizeFillFormFields(Array.isArray(t)?t:t&&"object"==typeof t?t.fields:void 0)}}function parseAutomationBrowserCommand(e){const t=tokenizeAutomationBrowserCommand(e),r=t[0]?.toLowerCase();if(!r)return null;const n=COMMAND_MAP[r];if(!n)return null;const i=t.slice(1),o={};switch(r){case"navigate":case"open":case"go":o.url=i[0]||"";break;case"click":case"dblclick":case"rightclick":{const e=[];"dblclick"===r&&(o.doubleClick=!0),"rightclick"===r&&(o.button="right");for(let t=0;t<i.length;t++){const r=i[t];if("--double"!==r&&"--double-click"!==r)if("--button"===r&&i[t+1]){const e=i[t+1].toLowerCase();if(!CLICK_BUTTONS.has(e))throw new Error(`Unsupported click button: ${i[t+1]}`);o.button=e,t++}else if("--modifiers"!==r)r.startsWith("--")||e.push(r);else{const{values:e,nextIndex:r}=collectOptionValues(i,t+1);o.modifiers=normalizeModifiers(e),t=r}else o.doubleClick=!0}o.uid=e[0]||"";break}case"click_at":o.x=parseNumber(i[0],"click_at x"),o.y=parseNumber(i[1],"click_at y");break;case"type":{const e=[];for(let t=0;t<i.length;t++){const r=i[t];"--uid"===r&&i[t+1]?(o.uid=i[t+1],t++):"--submit"!==r?"--slowly"!==r?r.startsWith("--")||e.push(r):o.slowly=!0:o.submit=!0}o.text=e.join(" ");break}case"screenshot":{const e=[];for(let t=0;t<i.length;t++){const r=i[t];"--format"===r&&i[t+1]?(o.format=i[t+1],t++):"--full-page"!==r?"--uid"===r&&i[t+1]?(o.uid=i[t+1],t++):r.startsWith("--")||e.push(r):o.fullPage=!0}!o.format&&e[0]&&SCREENSHOT_FORMATS$1.has(e[0])&&(o.format=e.shift()),e[0]&&(o.filePath=e[0]);break}case"snapshot":case"status":case"back":case"forward":case"reload":break;case"html":o.selector=i.filter((e=>!e.startsWith("--"))).join(" ")||void 0;break;case"scroll":{const e=[];for(let t=0;t<i.length;t++){const r=i[t];"--amount"===r&&i[t+1]?(o.amount=parseInteger(i[t+1],"--amount"),t++):r.startsWith("--")||e.push(r)}e[0]&&SCROLL_DIRECTIONS.has(e[0].toLowerCase())?o.direction=e[0].toLowerCase():o.direction="down",void 0===o.amount&&e[1]&&(o.amount=parseInteger(e[1],"scroll amount"));break}case"evaluate":case"eval":o.script=i.join(" ");break;case"new_page":i[0]&&(o.url=i[0]);break;case"close_page":case"select_page":o.pageIndex=parseInteger(i[0],`${r} index`);break;case"console":for(let e=0;e<i.length;e++){const t=i[e];if("--types"!==t)"--limit"===t&&i[e+1]?(o.limit=parseInteger(i[e+1],"--limit"),e++):"--offset"===t&&i[e+1]?(o.offset=parseInteger(i[e+1],"--offset"),e++):"--include-preserved"!==t&&"--include-preserved-messages"!==t||(o.includePreservedMessages=!0);else{const{values:t,nextIndex:r}=collectOptionValues(i,e+1);o.types=t.flatMap((e=>e.split(","))).map((e=>e.trim())).filter(Boolean),e=r}}break;case"fill_form":Object.assign(o,parseFillFormParams(i));break;case"drag":o.startRef=i[0]||"",o.endRef=i[1]||"",o.startElement=o.startRef,o.endElement=o.endRef}return{toolName:n,params:o}}const MAX_SCREENSHOT_BASE64_SIZE=512e3,MAX_TOOL_RESPONSE_LINES=200,DEFAULT_DIRECTORY=path__default.join(os__default$1.tmpdir(),"browser-use-cache"),SCREENSHOT_FORMATS=new Set(["png","jpeg","webp"]);class AutomationBrowser extends Handler{static runtimeService=BrowserRuntimeService.getInstance();aborted=!1;state="pending";configChangeDisposables=[];constructor(e,t,r){super("automation_browser",e,t,r),t.onNotify((e=>{if(e.payload?.toolId!==this.toolId)return;const t=e.name;if("skip"===t||"confirm"===t)this.promptResolver(t);else if("stop"===t)this.cancel();else if("autoRun"===t){const t=e.payload?.payload;this.handleAutoRunAction(t)}}));const n=()=>{"pending"===this.state&&(this.shouldAutoRun()&&this.promptResolver("confirm"),this.updateResult(this.state,!0))};this.configChangeDisposables.push(kernel.config.onDidChangeConfig("autoExecute",n),kernel.config.onDidChangeConfig("browserConfig",n))}async beforeExecute(){this.getStringParam("command")||this.throwValidationError(ToolError.common.parameter_required({arg:"command"}))}async execute(e){try{const e=this.getStringParam("command"),t=kernel.config.browserConfig?.browserMode;if("off"===t)return this.updateResult("failed"),this.result.output="Browser use is disabled. Please enable it in settings.",this.result;if("skip"===await this.prompt(e))return this.updateResult("skipped"),this.result;this.updateResult("running",!0);try{const t=parseAutomationBrowserCommand(e);if(!t)return this.updateResult("failed"),this.result.output=`Unknown browser command: ${e.split(/\s+/)[0]}`,this.result;const{toolName:r,params:n}=t,i=await loadBrowserUseCore(),o=i.getToolByName(r);if(!o)return this.updateResult("failed"),this.result.output=`Browser tool not found: ${r}`,this.result;const s=await AutomationBrowser.runtimeService.getContext();if(this.aborted)return this.updateResult("aborted"),this.result;const a=await this.normalizeToolParams(r,n,s);kernel.logger.info("[AutomationBrowser] executing tool",{toolName:r,mode:kernel.config.browserConfig?.browserMode,paramKeys:Object.keys(a)});const c=new i.ToolResponse(s,{maxInlineTextLength:MAX_TOOL_RESPONSE_LINES,maxScreenshotBase64Length:MAX_TOOL_RESPONSE_LINES,maxHtmlContentLength:MAX_TOOL_RESPONSE_LINES});await o.handler({params:a},c,s);const l=await c.toMcpResponse();return await this.processMcpResult(l,r,"browser_take_screenshot"===r?a.filePath:void 0),kernel.logger.info("[AutomationBrowser] tool executed successfully",{toolName:r}),this.updateResult("success"),this.forceUpdateToolTurnElement(),this.result}catch(t){if(this.aborted)return this.updateResult("aborted"),this.result;this.updateResult("failed");const r=t?.message||String(t);throw kernel.logger.error("[AutomationBrowser] tool execution failed",{command:e,error:t}),this.throwExecuteError(ToolError.automation_browser.execution_failed({error:r}))}}finally{this.disposeConfigListeners()}}disposeConfigListeners(){this.configChangeDisposables.forEach((e=>e.dispose())),this.configChangeDisposables=[]}rebuildResult(e){super.rebuildResult(e);const t=this.result.metadata.state;"pending"===t?this.result.metadata.state="skipped":"running"===t&&(this.result.metadata.state="aborted")}cancel(){this.aborted=!0,this.updateResult("aborted",!0)}async processMcpResult(e,t,r){const n=[];let i;for(const t of e.content||[])"text"===t.type&&t.text?n.push(t.text):"image"===t.type&&t.data&&(i=t.data);let o=this.truncateResponseText(n.join("\n")||"Command completed successfully.");if("browser_get_html"===t){const e=await import("@baidu/comate-browser-use"),t=e.resolveToolResponseOptions();if(!e.shouldInlineHtmlContent(o,t)){const r=await e.saveTextToLocalFile(o,t,"html","html");o=`HTML content (truncated):\n\`\`\`html\n${e.truncateTextForInlineDisplay(o,t.maxHtmlContentLength)}\n\`\`\`\n${e.buildReadMorePrompt(r.filename)}`}}if(this.result.output=o,r&&(this.result.metadata.screenshotPath=r),i)this.result.metadata.screenshot=i;else if(r){const e=await this.loadScreenshotBase64(r);e&&(this.result.metadata.screenshot=e)}}promptResolver=()=>{};async prompt(e){return this.shouldAutoRun()?Promise.resolve("confirm"):(this.updateResult("pending",!0),new Promise((e=>{this.promptResolver=e})))}shouldAutoRun(){if("zulucli"===process.env.IDE)return!0;return kernel.config.browserConfig?.autoExecute??!1}async handleAutoRunAction(e){if(e&&"enableAutoRun"===e.action){const t=!!e.autoRun;if(await kernel.config.updateBrowserConfig("autoExecute",t),"pending"===this.state){if(this.shouldAutoRun())return this.promptResolver("confirm"),void this.updateResult(this.state,!0)}this.updateResult(this.state,!0)}}async normalizeToolParams(e,t,r){let n={...t};if("browser_type"===e&&!n.uid){const e=await this.resolveFocusedElementUid(r);if(!e)throw new Error("No focused element available. Focus an input first or pass --uid from snapshot.");n.uid=e}if("browser_take_screenshot"!==e)return n;const i=this.normalizeScreenshotFormat(n.format),o=this.resolveScreenshotFilePath(n.filePath,i);return await mkdir$c(path__default.dirname(o),{recursive:!0}),{...n,format:i,filePath:o}}async resolveFocusedElementUid(e){return(await e.getSelectedPage()).evaluate("\n            (() => {\n                const activeElement = document.activeElement;\n                if (!activeElement || activeElement === document.body) {\n                    return null;\n                }\n\n                const existingUid = activeElement.getAttribute('aria-ref') || activeElement.getAttribute('data-comate-uid');\n                if (existingUid) {\n                    return existingUid;\n                }\n\n                const uid = 'focused-' + Date.now();\n                activeElement.setAttribute('data-comate-uid', uid);\n                return uid;\n            })()\n        ")}isScreenshotFormat(e){return!!e&&SCREENSHOT_FORMATS.has(e)}normalizeScreenshotFormat(e){return this.isScreenshotFormat(e)?e:"png"}resolveScreenshotFilePath(e,t){const r=e?.trim();if(!r)return path__default.join(this.getDefaultScreenshotDirectory(),this.buildScreenshotFilename(t));const n=this.expandHomeDirectory(r),i=path__default.isAbsolute(n)?n:path__default.join(this.getRelativeScreenshotBaseDirectory(),n);return this.normalizeScreenshotTargetPath(i,t)}getRelativeScreenshotBaseDirectory(){const e=kernel.env.workspaceInfo.rootPath;return e||this.getDefaultScreenshotDirectory()}getDefaultScreenshotDirectory(){return path__default.join(DEFAULT_DIRECTORY,"images")}normalizeScreenshotTargetPath(e,t){const r=path__default.resolve(e);return path__default.extname(r)?r:path__default.join(r,this.buildScreenshotFilename(t))}buildScreenshotFilename(e){return`screenshot-${Date.now()}.${e}`}expandHomeDirectory(e){return"~"===e?os__default$1.homedir():e.startsWith("~/")||e.startsWith("~\\")?path__default.join(os__default$1.homedir(),e.slice(2)):e}truncateResponseText(e){const t=e.split("\n");return t.length<=MAX_TOOL_RESPONSE_LINES?e:t.slice(0,MAX_TOOL_RESPONSE_LINES).join("\n")+`\n... (truncated, showing ${MAX_TOOL_RESPONSE_LINES} of ${t.length} lines)`}async loadScreenshotBase64(e){try{const t=await readFile$3(e);if(t.byteLength>MAX_SCREENSHOT_BASE64_SIZE)return;return t.toString("base64")}catch{return}}updateResult(e,t=!1){("pending"===this.state||"running"===this.state)&&(this.state=e);const r=buildAutomationBrowserOutput(this.state,this.result.output);return this.result={output:r,metadata:{...this.result.metadata,output:r,state:this.state,autoRun:this.shouldAutoRun()}},t&&this.ctx.userTurn&&this.ctx.userTurn.updateWebviewMessages(),this.result}forceUpdateToolTurnElement(){const e=this.ctx.userTurn.toolTurns.find((e=>e.tools.find((e=>e.toolId===this.toolId))));e&&this.ctx.userTurn.updateWebviewMessages({elementId:e.rollbackMessageId})}}const STOP_TASK_TIMEOUT_MS=1500;class StopTask extends Handler{constructor(e,t,r){super("stop_task",e,t,r)}async beforeExecute(){this.getStringParam("task_id")||this.throwValidationError(ToolError.common.parameter_required({arg:"task_id"})),this.result.metadata.taskId=this.getStringParam("task_id")}async execute(){const e=this.getStringParam("task_id"),t=await this.triggerAndWait(e);t||this.throwExecuteError(ToolError.stop_task.task_not_found({taskId:e})),t.success||this.throwExecuteError(t.reason),this.result.metadata.description=t.description,this.result.metadata.command=t.command;const r=[`Task ${e} stopped.`];return t.description&&r.push(`Description: ${t.description}`),r.push(`Output file: ${t.outputFile}`),this.result.output=r.join("\n"),this.result}triggerAndWait(e){return new Promise((t=>{const r=setTimeout((()=>t(void 0)),STOP_TASK_TIMEOUT_MS);this.token.getRoot()?.broadcast?.("stop-task",{taskId:e,onStopped:e=>{clearTimeout(r),t(e)}})}))}}class TaskComplete extends Handler{constructor(e,t,r){super("task_complete",e,t,r)}async execute(){return this.result.metadata.tasks=this.params.tasks,this.result}}class FileReadTracker{readRanges=new Map;track(e,t,r){if(!e||t<=0||r<t)return;const n=this.normalizePath(e);this.readRanges.has(n)||this.readRanges.set(n,[]),this.readRanges.get(n).push({startLine:t,endLine:r})}isLineRead(e,t){const r=this.normalizePath(e),n=this.readRanges.get(r);return!!n&&n.some((e=>t>=e.startLine&&t<=e.endLine))}getReadRanges(e){const t=this.normalizePath(e);return this.readRanges.get(t)||[]}getAllReadFiles(){return new Map(this.readRanges)}filterCandidates(e,t){if(t.length<=1)return t;const r=t.filter((t=>this.isLineRead(e,t.startLine)));return r.length>0?r:t}trackFromToolResult(e,t,r){"read_file"===e?this.trackReadFile(t,r):"extract_content_blocks"===e?this.trackExtractContentBlocks(t,r):"grep_content"===e&&this.trackGrepContent(t,r)}trackReadFile(e,t){const r=e.path||e.target_file;if(!r)return;const n=parseInt(e.start_line||e.offset||"1",10)||1;let i=parseInt(e.end_line||e.limit||"0",10);if(!i||i<=0){i=n+(t||"").split("\n").length-1}this.track(r,n,i)}trackExtractContentBlocks(e,t){const r=e.pathes;if(!r||"string"!=typeof r)return;const n=r.split("\n").filter((e=>e.trim())),i=/@LINE\[(\d+)\.\.(\d+)\]/g;for(const e of n){const t=e.replace(/@LINE\[.*/,"").trim();if(!t)continue;let r,n=!1;const o=new RegExp(i.source,i.flags);for(;null!==(r=o.exec(e));){const e=parseInt(r[1],10),i=parseInt(r[2],10);e>0&&i>=e&&(this.track(t,e,i),n=!0)}n||this.track(t,1,1e5)}}trackGrepContent(e,t){if(!t)return;const r=t.split("\n"),n=r.some((e=>/^\s*Line\s+\d+:/.test(e)));if(!n)return;let i="";for(const e of r){const t=e.trim();if(!t)continue;if(t.startsWith("Found ")||t.startsWith("Error")||t.startsWith("error"))continue;const r=t.match(/^((?:\/|\.\/)[^:]+):$/);if(r){i=r[1];continue}const n=t.match(/^Line\s+(\d+):/);if(n&&i){const e=parseInt(n[1],10);e>0&&this.track(i,Math.max(1,e-5),e+5)}}}normalizePath(e){return e.replace(/^\.\//,"").trim()}}const normalizeLine=e=>e.trim().replace(/\s+/g," "),EVIDENCE_PATTERN=/<<<EVIDENCE\s+file="([^"]+)"(?:\s+scope="([^"]*)")?(?:\s+startLine="(\d+)")?(?:\s+endLine="(\d+)")?\s*>>>([\s\S]*?)<<<END_EVIDENCE>>>/g,parseEvidenceBlocks=e=>{const t=[];let r;const n=new RegExp(EVIDENCE_PATTERN.source,EVIDENCE_PATTERN.flags);for(;null!==(r=n.exec(e));){const e=r[1],n=r[2]||"",i=r[3]?parseInt(r[3],10):void 0,o=r[4]?parseInt(r[4],10):void 0,s=r[5],a=r[0],c=s.split("\n").filter((e=>""!==e.trim())),l=c.some((e=>"..."===e.trim())),A="<<<CORE_EVIDENCE>>>",u="<<<CORE_EVIDENCE_END>>>",d=s.indexOf(A),h=s.indexOf(u);let p;if(-1!==d&&-1!==h&&h>d){const e=s.slice(d+A.length,h).split("\n").filter((e=>""!==e.trim()));e.length>0&&(p=e.join("\n"))}const g=s.replace(/<<<CORE_EVIDENCE>>>\n?/g,"").replace(/<<<CORE_EVIDENCE_END>>>\n?/g,"").split("\n").filter((e=>""!==e.trim())),f=l;let m,E,C;if(f){const e=g.findIndex((e=>"..."===e.trim()));m=g.slice(0,Math.min(2,e)),E=g.slice(e+1).slice(-2),C=""}else m=g.slice(0,2),E=g.slice(-2),C=g.join("\n");t.push({file:e,scope:n,headLines:m,tailLines:E,fullSnippet:C,isLong:f,rawText:s,originalMatch:a,knownStartLine:i,knownEndLine:o,coreSummary:p})}return t},findMatchPositions=(e,t,r=0,n)=>{if(0===t.length)return[];const i=t.map(normalizeLine),o=n??e.length,s=[];for(let t=r;t<o;t++){if(normalizeLine(e[t])===i[0]){let r=1;for(let n=1;n<i.length;n++)t+n<o&&normalizeLine(e[t+n])===i[n]&&r++;r>=Math.max(i.length-1,1)&&s.push(t+1)}}return s},extractScopeHint=(e,t)=>{const r=[/^\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)/,/^\s*(?:export\s+)?class\s+(\w+)/,/^\s*(?:(?:public|private|protected|static|async)\s+)*(\w+)\s*\(/,/^\s*(?:const|let|var)\s+(\w+)\s*=/,/^\s*def\s+(\w+)\s*\(/,/^\s*func\s+(?:\([^)]*\)\s+)?(\w+)\s*\(/,/^(\w+)\s*\(\)\s*\{/,/^\s*function\s+(\w+)/,/^#\s*(.+)/,/^\/\/\s*(.+)/],n=Math.max(0,t-20);for(let i=t;i>=n;i--){const t=e[i];for(const e of r){const r=t.match(e);if(r)return`位于 ${r[1].trim()} 内`}}return""},anchorLineNumbers=async(e,t,r)=>{const n=new Map,i=async e=>{if(n.has(e))return n.get(e);try{const r=(await t(e)).split("\n");return n.set(e,r),r}catch{return[]}},o=[];for(const t of e){const e=await i(t.file);if(0!==e.length)if(t.knownStartLine&&t.knownEndLine&&t.knownStartLine>0)o.push({file:t.file,startLine:t.knownStartLine,endLine:Math.min(t.knownEndLine,e.length),confidence:"high",matchDetail:"Known line range from code block registry",candidates:[]});else if(!t.isLong&&t.fullSnippet){const n=t.fullSnippet.split("\n").filter((e=>""!==e.trim())),i=findMatchPositions(e,n.slice(0,2)),s=[];for(const e of i){const t=e+n.length-1;s.push({start:e,end:t})}if(0===s.length){const t=findMatchPositions(e,n.slice(0,1));for(const e of t)s.push({start:e,end:e+n.length-1})}o.push(buildAnchorResult(t,s,e,r))}else{const n=findMatchPositions(e,t.headLines),i=findMatchPositions(e,t.tailLines),s=[];if(n.length>0&&i.length>0)for(const e of n)for(const r of i){const n=r+t.tailLines.length-1;n>e&&s.push({start:e,end:n})}if(0===s.length&&n.length>0)for(const e of n)s.push({start:e,end:e+20});if(0===s.length&&i.length>0)for(const e of i){const r=e+t.tailLines.length-1;s.push({start:Math.max(1,r-20),end:r})}o.push(buildAnchorResult(t,s,e,r))}else o.push({file:t.file,startLine:0,endLine:0,confidence:"low",matchDetail:"File not readable",candidates:[]})}return o},buildAnchorResult=(e,t,r,n)=>{if(0===t.length)return{file:e.file,startLine:0,endLine:0,confidence:"low",matchDetail:"No matching position found",candidates:[]};let i=t;if(n&&t.length>1){const r=t.filter((t=>n.isLineRead(e.file,t.start)));r.length>0&&(i=r)}if(1===i.length)return{file:e.file,startLine:i[0].start,endLine:i[0].end,confidence:"high",matchDetail:`Unique match at lines ${i[0].start}-${i[0].end}`,candidates:[]};const o=i.map(((e,t)=>{const n=String.fromCharCode(65+t),i=Math.max(0,e.start-1-3),o=Math.min(r.length,e.end+3),s=r.slice(i,o).map(((e,t)=>`${(i+t+1).toString().padStart(4," ")} | ${e}`)),a=extractScopeHint(r,e.start-1);return{label:n,startLine:e.start,endLine:e.end,contextSnippet:s.join("\n"),scopeHint:a}}));return{file:e.file,startLine:i[0].start,endLine:i[0].end,confidence:"medium",matchDetail:`${i.length} candidates found, needs LLM selection`,candidates:o}},formatFinalReport=(e,t,r)=>{let n=e;for(let e=0;e<t.length;e++){const i=t[e],o=r[e];let s;s="low"===o.confidence||0===o.startLine?`- 📄 \`${i.file}\`\n${i.rawText?formatCodeBlock(i.rawText):""}`:`- 📄 \`${i.file}:${o.startLine}-${o.endLine}\`\n${formatCodeBlock(i.rawText)}`,n=n.replace(i.originalMatch,s)}return n},formatCodeBlock=e=>{const t=e.trim();if(!t)return"";const r=t.split("\n").filter((e=>"..."!==e.trim())).join("\n");return"```\n"+r+"\n```"};function extractReasonAfterEvidence(e,t){const r="<<<END_EVIDENCE>>>",n=e.indexOf(t.originalMatch);if(n<0)return"";const i=e.indexOf(r,n);if(i<0)return"";const o=e.substring(i+18),s=o.indexOf("<<<EVIDENCE"),a=o.indexOf("<annotation_complete");let c=o.length;s>=0&&(c=Math.min(c,s)),a>=0&&(c=Math.min(c,a));const l=o.substring(0,c).trim().split("\n").filter((e=>e.trim())).slice(0,6).join(" ");return l.substring(0,500)}function parseAnnotationPlan(e,t){const r=e.match(/<annotation_plan>([\s\S]*?)<\/annotation_plan>/);if(!r)return null;const n=r[1],i=/<batch\s+id="(\d+)"\s+priority_budget="([^"]*)">\s*<focus>([\s\S]*?)<\/focus>\s*<\/batch>/g,o=[];let s;for(;null!==(s=i.exec(n));){const e=parseInt(s[1],10),t=s[2],r=s[3].trim(),n=t.match(/UNFOLD-1:\s*(\d+)/),i=t.match(/UNFOLD-2:\s*(\d+)/),a=t.match(/UNFOLD-3:\s*(\d+)/),c=t.match(/UNFOLD-4:\s*(\d+)/),l=t.match(/FOLD:\s*(\d+)/);o.push({id:e,priorityBudget:{p1:n?parseInt(n[1],10):1,p2:i?parseInt(i[1],10):2,p3:a?parseInt(a[1],10):3,p4:c?parseInt(c[1],10):2,fold:l?parseInt(l[1],10):2},focus:r})}if(0===o.length)return null;const a=o.reduce(((e,t)=>e+t.priorityBudget.p1),0);if(a>5){const e=5/a;let t=5;for(let r=0;r<o.length;r++)if(r===o.length-1)o[r].priorityBudget.p1=t;else{const n=Math.max(0,Math.floor(o[r].priorityBudget.p1*e));o[r].priorityBudget.p1=n,t-=n}}return{batches:o}}class RetrievalAgent extends Handler{executor=null;combinedSubtaskId="";toolTurns=[];roundCount=0;maxRounds=10;originalMaxRounds=10;roundsExpanded=!1;expansionHint="";toolCallSignatures=[];repetitiveToolHint="";maxSummaryRounds=7;fileReadTracker=new FileReadTracker;retrievalLog=[];effectiveBlocksMap=new Map;codeBlockRegistry=new Map;roundSummaries=[];initialQuery="";retryCount=0;traceEdgesMap=new Map;traceEdgeCounter=0;breadthProbesMap=new Map;breadthProbeCounter=0;unreadTargetsMap=new Map;stuckUnreadHints=[];pathCorrectionHints=new Map;failedToolPaths=new Set;blockFlipCount=new Map;blockLockedAsValid=new Set;blockUnfoldSince=new Map;reasonTooLongWarnings=new Map;foldRereadWarnings=[];readFilesHistory=new Map;exhaustedFiles=new Set;grepFilesHistory=new Map;lastProbeConclusion="";confirmedCount=0;pendingReasoningWarning=null;annotationHasDegradedEvidence=!1;queryIntent="fix";retrievalType="code";modeSwitchRound=-1;modeSwitchCount=0;invalidBlockReasons=new Map;terminationReason="unknown";executeStartTime=0;static ALL_FAIL_LOOP_THRESHOLD=3;consecutiveAllFailRounds=0;lastAllFailSignature="";static MIN_VALID_OUTPUT_LENGTH=50;static MAX_RETRY_COUNT=2;static MAX_BREAK_RETRIES=2;static PHASE_TIMEOUT_MS=12e4;static DOC_SUMMARY_TIMEOUT_MS=18e4;static CLEAN_RETRY_TIMEOUT_MS=3e5;static MAX_TIMEOUT_RETRIES=3;constructor(e,t,r){const n=new Token(`retrieval_agent-${t.id}`);super("retrieval_agent",e,n,r),t.children.push(n)}push(...e){this.toolTurns.push(...e);for(const t of e){const e=this.exhaustedFiles;t.preExecuteHook=async t=>{try{if("read_file"!==t.name)return!1;const r=t.toolHandler?.params?.target_file||"";if(!r||!e.has(r))return!1;const n=`wc -l "${r}" && echo "---HEAD---" && head -5 "${r}" && echo "---TAIL---" && tail -20 "${r}"`;let i="";try{i=(await import("node:child_process")).execSync(n,{encoding:"utf8",timeout:5e3})}catch(e){i=`[stuck_read_intercept] wc/head/tail 执行失败: ${e}`}return t.result.output=`[stuck_read_intercept] 文件 ${r} 已被标记为 exhausted（重复读取 ≥3 次或已完整读取）。\n已自动执行 wc -l / head -5 / tail -20 以提供文件信息：\n\n${i}\n\n请基于以上信息判断是否仍需继续检索该文件，若文件内容已确认则请切换到其他目标。`,t.toolState="executed",console.log(`[stuck_read_intercept] file=${r} redirected to wc-l/head/tail`),!0}catch{return!1}}}}agentInfo;static RETRIEVAL_PHASE_PROMPT='你是一个专注于代码检索的智能体（Retrieval Agent），由 Main Agent 委派执行检索任务。你的唯一职责是：高效、精准地从代码库中收集充分的代码证据。\n\n你不编写代码、不修改文件、不执行部署——你只负责**搜索、阅读和筛选**。\n\n## 核心检索原则\n\n### 1. 批判性验证\n搜到内容后，必须问自己：**"这真的是核心实现吗？"**\n- 找到"相关代码"≠ 找到"实现代码"\n- 常量定义、类型声明、测试用例往往只是**引用**，不是**实现**\n- 如果搜索结果看起来像辅助代码，要继续追踪到真正的实现\n\n### 2. 代码级证据原则（最重要，必须严格遵守）\n**区分"线索"和"证据"——只有读过代码才有证据：**\n- **线索**：grep/search/list_dir 返回的文件路径或匹配摘要。它们只说明"文件中存在某个文本模式"，不能确定其语义角色（可能是注释、文档引用、测试断言、真正的实现）\n- **证据**：通过 read_file 读取并分析了文件的实际代码后，确认某段代码确实实现了目标功能\n\n**硬性规则**：\n- 在 round_summary 中，对**未读代码的文件**只能使用推测性语言（如"可能包含…"、"需下一轮读取确认"），**禁止**使用断言性结论（如"找到了 X 的实现"）\n- 在 effective_blocks 中，**只标注已通过 read_file 实际读取并分析过代码逻辑的块**为 valid。如果某一轮只做了搜索/定位而未读取代码，该轮不应有任何 valid 标注\n- 你作为子 agent，token 预算充裕。**宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论**\n\n❌ 错误：grep 返回 key-bindings.bash → round_summary 写"找到了键绑定实现" → effective_blocks 标 valid\n✅ 正确：grep 返回 key-bindings.bash → round_summary 写"发现该文件包含关键词，可能是实现，需读取确认" → 下一轮 read_file → 确认后 round_summary 写"读取代码确认了第166行的键绑定逻辑" → effective_blocks 标 valid\n\n### 3. 多文件类型覆盖\n功能实现可能跨越多种文件类型，必须全面搜索：\n- **主语言源码**：.go, .py, .ts, .java, .rs 等\n- **Shell 脚本**：.sh, .bash, .zsh, .fish（键绑定、CLI 命令常在此实现）\n- **配置文件**：.json, .yaml, .toml, Makefile\n- **文档**：README.md, *.md（可能包含架构说明）\n\n### 检索意图预分析（第一轮开始前）\n在第一轮搜索之前，先对检索意图（来自 Main Agent 的任务描述）做快速结构化分析：\n\n1. **Stack Trace / 报错路径提取**：如果检索意图中包含 stack trace、编译错误、运行时异常，系统会自动提取其中的源码文件路径并注入到第一轮上下文。你应优先对这些文件执行 read_file，它们是最高置信度的起始点。\n2. **明确提及的文件/函数/类名**：从检索意图中提取所有被直接提及的标识符（文件名、函数名、类名、变量名），作为第一轮搜索的精确关键词。\n3. **多模块特征词识别**：如果检索意图涉及"跨模块"、"前后端"、"多个文件"、"不同目录"等表述，预期检索范围较广，应在搜索策略中安排多方向并行探索。\n4. **修改范围预估**：根据检索意图的复杂度（单函数 bug / 多函数交互 / 架构级变更），预估需要覆盖的文件数和调用深度，合理规划搜索轮次。\n\n### 4. 搜索策略调整\n当初步搜索结果不理想时：\n- **换关键词**：尝试同义词、缩写、变体（如 alt-c, AltC, ALT_C）\n- **换文件类型**：从 *.go 扩展到 *.sh, *.bash\n- **换目录**：从 src/ 扩展到 shell/, scripts/, bin/\n- **用 grep 兜底**：`grep -rn "pattern" . --include="*.sh"`\n\n### 5. 双向追溯调用链（重要）\n找到核心实现代码后，**必须双向追溯**：\n\n**向上追溯**："谁调用了这个函数/类？"\n- **从实现向上追溯**：函数被谁调用 → 调用者被谁调起 → 启动入口 → CLI 命令 → 构建配置（Makefile 等）\n- **从问题描述向外扩展**：检索意图或 issue 中提到的关键词（如 CI、test、timeout、make target、system start）都应该主动 grep 搜索，即使它们看起来与核心功能不直接相关\n- **大胆查看相关文件**：Makefile、测试文件、CLI 命令定义、配置文件等都可能是修复所需的关键上下文\n\n**向下追溯**："这个函数把关键参数传给了谁？"\n- 当函数 A 将关键参数传给子函数 B 时，**必须 read_file 子函数 B 的实现**，确认参数的实际处理逻辑\n- 特别是：参数经过了 if/else 分支、默认值赋值、类型转换等操作后再传递的情况\n- 不能仅看调用方的代码就断言"参数传递正确"——参数可能在 callee 中被覆盖、忽略或错误处理\n- **同文件也要追溯**：即使 callee 在同一文件中，也必须 read_file 对应行范围确认其实现\n\n典型追溯链路：\n- 找到 bulk_create 中 batch_size 参数 → 搜索 batch_size 传递给 _batched_insert → read_file _batched_insert 确认 batch_size 的实际使用逻辑\n- 找到 _parse_annotation 处理类型标注 → 搜索同文件中其他处理类型标注的函数 → 发现 make_xrefs 是另一条独立路径\n- 找到 DNSHandler.swift → 搜索 "DNSHandler" 的所有调用者 → 找到 APIServer+Start.swift → 搜索 "system start" → 找到 SystemStart.swift 和 Makefile\n\n❌ 常见错误：找到函数 A 调用了函数 B 后，只看 A 的代码就断言"参数传递正确"，不去读取 B 的实现\n❌ 常见错误：找到核心实现后就停止搜索，认为"已经足够了"\n✅ 正确做法：找到调用关系后，read_file 被调用函数 B 的完整实现，特别关注 B 中对该参数的实际处理逻辑\n✅ 正确做法：找到核心实现后，继续搜索调用者、启动入口、构建脚本和相关测试，确保覆盖完整的修复链路\n\n### 6. 效率纪律\n- **调研充分性优先**：你作为子 agent，token 预算充裕。**优先保证调研充分性，而非追求最少轮次**。宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论\n- **不重复搜索**：记住已经搜过的文件和模式，不要对同一文件或相同关键词重复发起搜索\n- **存疑即全读**：当你认为某个文件或函数与问题相关但尚不确定具体哪几行，应直接 read_file 该函数/类的完整定义（通常 100-300 行），而非每轮微调 offset/limit 反复读取重叠的小片段。碎片化读取既浪费轮次又导致上下文割裂，无法形成完整理解。正确做法是一次性读取足够范围后在 round_summary 中完整分析\n- **读后必蒸馏**：每次 read_file 完成后，在 <effective_blocks> 的 reason 中记录关键函数名、类名、核心逻辑结论（如"renderBorder() 负责边框绘制，style 为 nil 时跳过渲染；事件循环入口在 UpdateModel()；光标状态由 Model.cursor 字段管理"）。⚠️ 禁止在 reason 中写具体行号——行号易产生幻觉导致后续决策错误；应使用函数名/结构体名/逻辑描述作为语义锚点。reason 是跨轮知识的唯一载体，fold 后仅凭 reason 判断是否需重读。较长的摘要可用 <reason id="blockId">多行内容</reason> 格式\n- **正则保持简单**：使用简单的正则表达式，避免复杂转义。如果需要搜多个变体，拆成多次简单搜索而不是用一个复杂正则\n- **先定位再阅读（严格两轮制）**：read_file 只能读取**前面轮次**已通过搜索、list_dir 或 grep_content 确认存在的文件路径。**同一轮**内不允许既调用 list_dir 又对同一目录调用 read_file——因为 list_dir 的结果要到下一轮你才能看到，本轮的 read_file 参数只能基于上一轮已确认的路径\n\n### 7. 禁止猜测文件名（最高优先级，违反则严重扣分）\n**绝对禁止**凭直觉猜测文件路径来调用 read_file。你不知道项目的文件命名规范（例如 Go 项目不一定有 key.go、action.go、types.go），猜测会导致大量 "File does not exist" 错误，严重浪费轮次。\n\n**典型错误模式**：\n- 你看到 src/ 目录存在，就猜测 src/key.go、src/action.go、src/types.go 存在 → 全部失败\n- 你在同一轮同时调用 list_dir("src/") + read_file("src/key.go") → key.go 是猜测，list_dir 还没返回结果\n\n**正确做法**：分两轮——\n- 轮次 N：用 list_dir 查看目录下实际有哪些文件，或用 glob_path/grep_content 确认文件路径\n- 轮次 N+1：基于上一轮返回的**真实文件列表**，read_file 已确认存在的文件\n\n注意：list_dir 的参数名是 target_directory（不是 path），read_file 的参数名是 target_file。\n\n❌ 错误示例：猜测存在 src/key.go、src/action.go、src/types.go 然后直接 read_file → 全部失败\n❌ 错误示例：同一轮 list_dir("src/") + read_file("src/key.go") → key.go 是猜测路径\n✅ 正确示例：轮次 N 调用 list_dir("src/") 看到实际文件列表，轮次 N+1 再 read_file 已确认存在的文件\n\n### 8. 并行工具调用（重要）\n如果你打算调用多个工具且它们之间没有依赖关系，必须在同一轮并行发起所有独立的工具调用。\n优先选择并行调用而非串行调用，以最大化每轮的信息获取效率。\n\n例如：需要读 3 个文件时，同一轮发 3 个 read_file 并行读取，而不是分 3 轮逐个读取。\n\n**可并行的场景**：\n- 多个 read_file（不同文件无依赖）\n- 多个 grep_content（不同关键词/模式无依赖）\n- list_dir(根目录) + grep_content("关键词", files_with_matches)（无依赖，首轮推荐）\n- grep 返回 5 个文件 → 下一轮同时 read_file 其中最相关的 3 个\n\n**必须串行的场景**（工具调用结果会影响后续参数）：\n- list_dir 探索目录 → 下一轮基于结果 read_file（有依赖）\n- read_file 确认内容 → 下一轮根据内容发起更深搜索（有依赖）\n\n每轮仅发 1 个工具调用是严重的效率浪费，在轮次限制下尤其致命。\n\n**首轮并行探测**（以下两步应在第 1 轮同时发起）：\n- list_dir 根目录，了解仓库结构\n- 同时用 grep_content(pattern="核心关键词", -i, files_with_matches) 快速定位候选文件\n\n❌ 错误：第 1 轮只发 list_dir，等结果后第 2 轮再搜索 → 浪费 1 轮\n✅ 正确：第 1 轮同时 list_dir + grep_content，第 2 轮基于两者结果并行 read_file 多个文件\n\n## 工具使用\n\n### 搜索定位（按优先级）\n1. **codebase_search**: 语义搜索，适合不确定关键词时的探索。**当你对文件名不确定时，应优先使用此工具而不是猜测文件名**。\n2. **grep_content**: 正则匹配，支持指定文件类型。在已知文件名或路径时，用它进行符号级精确验证。\n3. **glob_path**: 了解目录结构，发现非标准目录（如 shell/, scripts/）\n\n### 文件阅读\n- **read_file**: 深度阅读目标文件（逐文件精读）\n\n### 命令行兜底\n- **run_command**: 只读命令，当其他工具不够灵活时使用\n- **文件信息确认（常用）**：\n  - `wc -l {path}` → 确认文件总行数，判断是否已读完\n  - `tail -20 {path}` → 查看文件末尾内容\n  - `head -20 {path}` → 查看文件开头内容\n  - `cat {path}` → 小文件完整查看（建议 < 100 行时使用）\n- **内容搜索兜底**：`grep -rn "pattern" /path --include="*.sh"`、`find /path -name "*.ts"`\n- **严格限制**: 仅限只读操作，禁止修改文件\n\n## 逐轮思考与证据筛选（最重要，必须严格遵守）\n\n**每轮工具调用结束后**，你必须先输出思考摘要，再对工具返回结果做有效性判断。系统会从你的输出中提取这两段内容，作为下一轮的历史上下文注入——如果你不输出，下一轮你将看不到之前的检索进展。\n\n### 第一步：输出思考摘要\n\n用 <round_summary> 标签包裹本轮的思考。\n\n⚠️ **round_summary 防幻觉规则（必须严格遵守）**：\nround_summary 会被注入到后续每一轮的上下文中。如果其中包含不准确的代码细节（方法名、行号、代码片段），会在多轮累积后导致严重幻觉。因此：\n- ✅ 记录：搜索了什么、找到了什么文件、分析结论的**概括**、排除方向、下一步计划、向上追溯的思路\n- ❌ **禁止**记录：具体行号、方法签名、代码片段、API 名称等代码细节（这些已由 effective_blocks 的 reason 字段精确记录，无需在 round_summary 中重复）\n\n搜索/定位轮示例（未读代码，只有线索）：\n<round_summary>\n本轮线索：grep 发现 shell/ 下三个脚本文件包含 Alt-C 关键词，可能是键绑定实现，需下一轮读取确认。src/options.go 也匹配，可能是配置相关。\n排除方向：src/ 下没有 action/ 子目录。\n下一步：读取 shell/ 下的三个脚本文件代码。\n</round_summary>\n\n代码阅读轮示例（已读代码，可下结论）：\n<round_summary>\n本轮证据：读取了 key-bindings.bash 和 key-bindings.zsh，确认了 bash 和 zsh 中的键绑定实现机制。具体代码细节见 effective_blocks 标注。\n排除方向：docs/ 下的文档文件只是用法说明，不含实现。\n下一步：读取 key-bindings.fish 确认 fish shell 实现；追溯调用链——搜索谁调用了这些键绑定函数。\n</round_summary>\n\nBug fix 场景示例（形成假设并追踪验证状态）：\n<round_summary>\n本轮证据：读取了 lookups.py 中 In.process_rhs 和 related_lookups.py 中 RelatedIn.as_sql，确认了 has_select_fields 检查逻辑。\n当前假设：[推测] Q.__or__ 绕过了 has_select_fields 检查导致子查询返回多列。\n假设依赖的未验证前提：\n  - resolve_expression() 中 Query 被 clone 后的 has_select_fields 实际值未确认\n  - default_cols 属性在 clone 过程中的传递逻辑未读取\n下一步：read_file resolve_expression 和 clone 相关代码，验证上述前提。\n⚠️ 深度审查：\n- [待补充] resolve_expression() 中 Query clone 后的状态变化未追踪\n- [待补充] default_cols 的设置和传递逻辑未确认\n</round_summary>\n\n假设验证后更新示例：\n<round_summary>\n本轮证据：读取了 query.py 中 resolve_expression，确认 clone 会保留 default_cols=True。\n当前假设：[已验证] → 修正：问题不在 lookup 的 has_select_fields 检查，而在 resolve_expression 中 clone 后的 Query 未被限制为单列。修正后的假设：resolve_expression 应在 clone 时对非 has_select_fields 的子查询执行 clear_select_clause + add_fields([\'pk\'])。\n下一步：确认 clear_select_clause 和 add_fields 的实现是否支持此修复方向。\n⚠️ 深度审查：\n- [待补充] clear_select_clause 的副作用（是否会影响其他 query 属性）需确认\n</round_summary>\n\n### 深度审查（每轮必做，全局视角）\n\n在 round_summary 末尾，回顾以下深度缺口：\n\n1. **追溯边状态**：检查系统注入的追溯状态表，是否有 pending 边被遗忘超过 2 轮？如果有，本轮应优先处理。标记 valid 代码块时，检查该块中是否有需要注册为新追溯边的 callee/caller/override。\n   - **新增 override 类型**：当某个代码块定义了基类方法（如 `as_sql`、`convert_durationfield_value`、`get_db_converters`），且该方法可能被多个后端/子类 override（如 mysql、sqlite3、oracle 后端）时，必须注册一条 `direction: "override"` 追溯边，target 写 "检索 [backends/子模块] 目录下的 override 实现"。格式：`- edge: "new" | from: "R1-A" | direction: "override" | target: "检索 django/db/backends/mysql/ 中 convert_durationfield_value 的 override 实现" | status: "pending" | reason: "基类方法可能被各后端 override，需验证各后端实现"`\n2. **同文件未覆盖路径**：纵观所有轮次已标记为 valid 的代码块所涉及的文件，是否存在处理同类输入的其他函数/方法？特别是名称相似但用途不同的函数（如 _parse_annotation vs make_xrefs，__iter__ vs _new）。\n3. **根因假设的未验证前提**：如果你已经在 round_summary 中形成了关于根因/机制的假设（如"问题出在 X 函数的 Y 逻辑"），检查这个假设是否依赖了尚未通过 read_file 验证的前提。典型的未验证前提包括：\n   - 假设 A 调用 B 时传递了某个参数值，但 A→B 的调用链中间经过了 clone/transform/resolve 等操作，中间状态未被 read_file 确认\n   - 假设某个属性/变量在执行到某处时的值为 X，但该值的设置逻辑未被追踪\n   - 假设某个条件分支会/不会被触发，但触发条件依赖的上游逻辑未被读取\n   如果存在未验证前提，该假设只能作为"推测方向"而非"确认结论"——必须在后续轮次中 read_file 验证这些前提，验证通过才能升级为确认结论。\n\n⚠️ 当基类/父类的方法与当前子类的方法处理同类逻辑时，必须分别验证两者的实现，不能仅验证子类就断言"基类也正确"。\n\n### 第二步：标记有效代码块\n\n系统会在每轮工具返回后自动对代码内容进行编码（如 [R1-A]、[R1-B]），并在下一轮注入编号列表和首尾代码摘要。**你只需引用编号做选择，不要手写文件路径和行号。**\n\n⚠️ **只有通过 read_file 实际读取并分析过代码的块才能标记为 valid**。如果某一轮只做了 grep/search/list_dir/glob_path（未读代码），该轮不应有 valid 标注——因为搜索结果只是线索，不是证据。\n\n#### 导航类返回 vs 代码类返回\n工具返回分为两类，标记方式不同：\n- **导航类**（grep_content files_with_matches / glob_path）：返回的是文件名列表，**不包含代码内容**。这些块一律标 invalid，reason 写"定位到关键文件：xxx、yyy，非代码块"即可。关键文件位置应记录在 round_summary 中以保持记忆。\n- **代码类**（read_file / grep_content content 模式 / codebase_search）：返回的是实际代码（codebase_search 返回带行号的代码片段）。必须**仔细阅读代码逻辑**后判断 valid/invalid，reason 中说明具体的代码逻辑分析结果。\n\n用 <effective_blocks> 标签对本轮代码块做 valid_unfold/valid_fold/invalid 判断：\n\n<effective_blocks>\n- block: "R1-A" | status: "invalid" | reason: "定位到关键文件：key-bindings.bash/zsh/fish，非代码块"\n- block: "R2-A" | status: "valid_unfold" | reason: "bash 中的键绑定核心实现，后续需基于代码追踪调用链"\n- block: "R2-B" | status: "valid_fold" | reason: "zsh 键绑定实现，已确认机制，不需要反复查看"\n- block: "R2-C" | status: "invalid" | reason: "只是 UI 颜色处理，与快捷键绑定无关"\n</effective_blocks>\n\n后续轮次中切换已有代码块的展示模式：\n<effective_blocks>\n- block: "R2-A" | status: "valid_fold" | reason: "键绑定实现已充分分析，释放空间"\n- block: "R3-A" | status: "valid_unfold" | reason: "需要重新确认 fish shell 的实现细节"\n</effective_blocks>\n\n如果之前标记为 valid 的代码块后续发现不相关，用 status: "invalid" 移除：\n<effective_blocks>\n- block: "R1-A" | status: "invalid" | reason: "之前误标，实际是通用工具函数"\n</effective_blocks>\n\n### 检索完成信号\n当你认为已经收集到**足够的证据**来完整回答检索意图时，在输出 <round_summary> 和 <effective_blocks> 之后，额外输出一个 `<retrieval_complete/>` 标签：\n\n<round_summary>\n...本轮的思考总结...\n</round_summary>\n\n<effective_blocks>\n...本轮的代码块标记...\n</effective_blocks>\n\n<retrieval_complete/>\n\n系统会检测到此信号，自动进入汇总阶段——为你提供所有已标记有效代码块的完整内容，届时按汇总格式输出最终报告。\n\n⚠️ **输出 `<retrieval_complete/>` 前必须满足以下条件**：\n1. **至少对核心实现文件做过 read_file 精读**。codebase_search / grep_content 返回的是索引级摘要片段（通常只有几十行），不能替代对核心模块的完整阅读。如果你的 valid 代码块全部来自 codebase_search 而没有经过 read_file 精读，说明检索深度不足，不应结束\n2. **round_summary 中不能存在未执行的"下一步计划"**。如果你在 round_summary 中写了"下一步需要读取/搜索 XXX"，那就必须先执行这些计划，不能一边写计划一边输出 retrieval_complete\n3. **有效代码块数量不能为 0**。如果你已经搜索了多轮但没有标记任何代码块为 valid，说明搜索策略可能有问题——尝试换用不同的搜索关键词、换用 codebase_search 进行语义搜索、或扩大搜索范围。不要在 0 个有效证据的情况下结束检索\n4. **请勿自行编写最终检索报告**。输出 `<retrieval_complete/>` 后等待系统注入汇总指令即可。如果你不确定证据是否充分，就继续搜索，不要输出此标签\n5. **根因假设已验证或标记为推测**：如果你在 round_summary 中提出了关于根因/机制的假设，检查该假设依赖的所有前提是否已通过 read_file 验证。对于涉及多层调用链（如 A→B→C）的 bug fix 场景，仅 read_file 了 A 和 C 而跳过了中间的 B 是不够的——调用链中任何未读取的中间环节都可能改变参数、状态或执行路径。如果假设依赖的前提仍有未验证项，必须在 round_summary 中将假设显式标记为"推测方向"（而非"已确认"），并在下一步计划中列出需要验证的具体代码路径。\n6. **追溯边和广度探测已完成**：如果系统在检索进度摘要中显示了"待完成追溯"（pending trace edges）或"广度探索提醒"（needs_exploration breadth probes），必须先处理完这些项（标记为 resolved/explored 或 not_applicable）才能结束检索。\n7. **必须先输出 `<retrieval_exit_check>` 自检块**：在满足上述 1–6 条的基础上，还需完成以下结构化自检。系统将解析该块，若缺失或 `exit_verdict=BLOCKED`，`<retrieval_complete/>` 将被视为 `plan_action_conflict` 并触发干净重试。\n\n**退出自检格式（紧接 round_summary 输出，位于 `<retrieval_complete/>` 之前）**：\n\n```xml\n<retrieval_exit_check>\n  <evidence_density status="PASS|INSUFFICIENT">\n    valid effective_blocks: N 个，涉及 M 个文件。\n    [INSUFFICIENT 原因：哪些核心路径尚无 valid block]\n  </evidence_density>\n\n  <core_read_depth status="PASS|INSUFFICIENT">\n    已 read_file 精读的文件列表（每项需有明确理由）：\n    - [文件名]：[原因]\n    callee 追溯：已追溯到叶节点 / 边界明确（[原因]）\n    [INSUFFICIENT：哪个 callee 未精读及原因]\n  </core_read_depth>\n\n  <expected_behavior_coverage status="PASS|INSUFFICIENT|N/A">\n    （fix/understand 类查询强制填写；N/A 仅适用于纯架构探索类）\n    是否查阅了 test 文件 / 注释 / 文档以确认期望行为：[是/否]\n    [否时：必须说明为何可以在不知期望行为的情况下完成检索]\n  </expected_behavior_coverage>\n\n  <coverage_gaps>\n    本次检索主动未探索的相关区域及排除原因：\n    - [区域/文件/方向]：[排除原因，"与核心路径无关因为..."]\n    （若有遗漏但无法确定是否相关，标记为"推测可忽略，原因..."）\n  </coverage_gaps>\n\n  <exit_verdict status="APPROVED|BLOCKED">\n    [BLOCKED：指出哪个维度不通过，需要补做什么]\n  </exit_verdict>\n</retrieval_exit_check>\n```\n\n### 第二步半：管理追溯边\n\n在输出 <effective_blocks> 之后，输出 <trace_edges> 标签管理调用链追溯状态。\n\n**注册新追溯边**：当你标记一个代码块为 valid_unfold/valid_fold 时，检查该块中是否存在：\n1. **向下调用**：该函数/方法将关键参数传递给了子函数，且子函数尚未被 read_file\n2. **向上调用**：该函数/方法的调用者尚未确认\n\n如果存在，注册为 pending 追溯边：\n<trace_edges>\n- edge: "new" | from: "R2-A" | direction: "callee" | target: "compiler.py:_batched_insert()" | status: "pending" | reason: "bulk_create 将 batch_size 传给此函数，需确认处理逻辑"\n</trace_edges>\n\n**更新追溯边**：当你在后续轮次中追溯到了目标代码并标记了对应代码块时，更新边状态：\n<trace_edges>\n- edge: "TE-1" | status: "resolved" | resolved_block: "R4-B" | reason: "已读取 _batched_insert 实现，确认参数处理"\n</trace_edges>\n\n**标记不需要追溯**：如果某条边经分析不需要追溯（目标是标准库、日志函数等），标记为 not_applicable：\n<trace_edges>\n- edge: "TE-2" | status: "not_applicable" | reason: "调用的是 logging.debug()，标准库无需追溯"\n</trace_edges>\n\n**追溯链延续规则**：当某条追溯边 resolved 到一个 valid 代码块时，检查这个新的 valid 块是否也有需要追溯的 callee/caller。如果有，注册新的 pending 边。追溯链直到末端块被判为 invalid（离开修改影响范围）或 not_applicable（无需追溯）时自然终止。\n\n⚠️ 存在 pending 追溯边时，**禁止输出 <retrieval_complete/>**。\n⚠️ 如果本轮没有新的追溯边需要注册或更新，可以不输出 <trace_edges> 标签。\n\n### 第二步 C：广度探测响应\n\n系统会自动检测：当某个目录下已有 2 个以上 valid 代码块时，会在检索进度摘要中显示"广度探索提醒"。\n\n看到提醒后，你需要评估该目录下未检查的文件和同级目录是否可能与检索意图相关，并在 <breadth_status> 中输出判断结果：\n\n<breadth_status>\n- probe: "BP-1" | status: "explored" | reason: "已检查 backends/ 下所有 4 个后端，确认都需要同步修改"\n</breadth_status>\n\n或者：\n<breadth_status>\n- probe: "BP-1" | status: "not_applicable" | reason: "同目录其他文件是 __init__.py 和 utils.py，与当前检索意图无关"\n</breadth_status>\n\n⚠️ 存在 needs_exploration 的广度探测时，**禁止输出 <retrieval_complete/>**。\n⚠️ 如果当前没有广度探测提醒，不需要输出 <breadth_status> 标签。\n\n### 第二步 D：未读目标间隙上报\n\n当你在某一轮通过 grep_content / glob_path / codebase_search 等方式**识别了需要 read_file 的目标文件**，但**本轮实际未对这些文件完成 read_file 调用**时，在 <round_gaps> 中列出：\n\n<round_gaps status="PENDING">\n- file: "src/foo/bar.ts" | reason: "grep 命中但本轮 token 不足，留到下轮读"\n- file: "src/baz/qux.ts" | reason: "目录浏览发现相关文件，尚未读取"\n</round_gaps>\n\n如果本轮所有识别的目标文件均已完成 read_file，或本轮未识别任何新的目标文件，输出：\n\n<round_gaps status="CLEAN"/>\n\n⚠️ 连续 2 轮或以上报告同一文件为 PENDING，说明该文件被反复推迟——**下一轮必须优先 read_file 读取**。\n⚠️ <round_gaps> 不是可选项：每轮都必须输出，要么 PENDING（列出未读文件），要么 CLEAN。\n\n### 第三步：输出下一轮工具调用（如果不输出 <retrieval_complete/>）\n\n### 格式规则\n- **所有字段统一为 key: "value" 格式**，方便系统自动解析\n- **block**（必填）：系统编码的代码块编号，如 "R2-A"、"R3-B"。只引用系统注入的编号，不要自己编造\n- **status**（必填）：`"valid_unfold"` / `"valid_fold"` / `"invalid"` 三选一\n  - `"valid_unfold"`：标记为有效，展开完整代码到后续轮次上下文。用于核心实现代码，后续多轮需基于代码细节做串行推理\n  - `"valid_fold"`：标记为有效，只保留 snippet 摘要。用于有效但不需要反复查看细节的代码\n  - `"invalid"`：不相关，或需要移除之前标记的块\n- **reason**（status 为 valid_unfold/valid_fold/invalid 时必填）：记录关键函数名、类名和核心逻辑结论（语义锚点）。⚠️ 禁止写具体行号（行号易产生幻觉导致后续决策错误）。支持扩展格式 `<reason id="blockId">多行内容</reason>` 用于较长摘要\n- ⚠️ **不需要写 file 和 lines 字段**——系统已通过编码精确记录了每个代码块的文件路径和行号\n\n### 规则\n1. **每轮都必须输出 <round_summary> 和 <effective_blocks>**，对本轮所有系统编码的块逐一做 valid_unfold/valid_fold/invalid 判断。即使本轮只做了导航类操作，系统也会对工具返回编码，你必须对每个编码块做显式分析（导航类标 invalid 并记录关键文件位置），这能确保你的推理链条完整连贯\n2. 只标记与检索意图**直接相关**的工具返回为 valid_unfold 或 valid_fold，无关的标记为 invalid\n3. status: "valid_unfold" / "valid_fold" 的代码块会被系统保留到 Map 中，下一轮你会在历史摘要中看到\n4. status: "invalid" 的不会被保留，但 round_summary 中应说明排除原因\n5. 如果发现之前标记的代码块实际无关，用 status: "invalid" 移除\n6. 如果本轮所有编码块全部无关，<effective_blocks> 中全部标记为 invalid 即可\n7. **连续多轮全部 invalid 自检**：如果你已经连续 2 轮以上将所有代码块标记为 invalid，说明搜索方向可能有偏差。此时应在 round_summary 中反思搜索策略，主动调整方向（换关键词、用语义搜索 codebase_search、尝试 list_dir 探索目录结构），而不是继续相同模式的无效搜索\n8. status: "valid_unfold" 的代码块会在后续每轮上下文中展示完整代码，无需重新 read_file\n8b. 已收起（valid_fold）的块同样是你已经读取过的内容——fold 后通过 reason 摘要判断是否需要重新查看细节。若需要，请用 "valid_unfold" 展开，而非重新发起 read_file（重新 read_file 会被系统拦截并提示补充 reason）\n9. 当不再需要查看某个展开块的细节时，及时用 "valid_fold" 收起以释放上下文空间\n10. 同时展开的代码块建议不超过 2-3 个，当你只需要记住结论时用 valid_fold\n11. **完整性判断**：当标记一个代码块为 valid_unfold 或 valid_fold 时，如果该块只覆盖了某个方法/函数/类的部分实现（例如只读到了方法的前 50 行，但该方法还有后续逻辑未读取；或者只读了类的部分方法），应在 reason 中标注"⚠️ 部分覆盖：该方法/类的 XXX 部分尚未读取"，并在 round_summary 的下一步计划中列入"读取剩余部分"\n12. **追溯边联动**：当标记代码块为 valid_unfold 或 valid_fold 时，检查该块是否存在尚未追溯的 callee/caller 关键调用。如果有，在同一轮的 <trace_edges> 中注册为 pending 边。这能确保依赖链不被遗漏\n12b. **数据流上游追踪（N3 逆向追溯）**：\n   - **调用方追踪**：找到报错/症状函数 B 后，额外搜索"谁调用了 B"（call site），判断 fix 是在 B 内部还是在调用方 A 侧（过滤输入/边界控制）。典型错误：只修改了 B 的内部实现，而实际 fix 应在调用方传入前做过滤。\n   - **数据流上游追踪**：找到变量的"使用点"后，额外追溯该变量的"来源路径"——它在哪个类/函数中被初始化？经过哪些中间处理？是否在某个环节被丢弃/覆盖？这类信息通常在比工厂函数/调用函数更靠前的类定义中（如 Options/Metaclass 层）。典型错误：只看到变量的"使用端"，遗漏了"定义端"导致修改了症状而非根因。\n13. **完成标准（最高优先级）**：**禁止在 effective_blocks 中没有任何 valid_unfold 或 valid_fold 记录的情况下输出 <retrieval_complete/>**。即便你认为自己已经知道答案，也必须通过工具实际搜索、read_file 读取文件内容、在 effective_blocks 中标记至少一条 valid 记录，才可以输出 retrieval_complete。导航类操作（glob_path/list_dir/grep_content）的返回结果可以标 invalid，但这不代表你完成了检索——必须 read_file 读取实际内容并标记 valid 块。\n   - ❌ 错误：调用了 glob_path 获取文件列表后直接输出 retrieval_complete（文件列表不是有效证据，effective_blocks 中无 valid 块）\n   - ❌ 错误：没有调用任何工具就直接输出 retrieval_complete（禁止行为）\n   - ✅ 正确：glob_path/grep_content 找到候选文件 → read_file 读取内容 → 确认内容与检索意图相关 → effective_blocks 标 valid → 再输出 retrieval_complete\n14. **架构查询豁免**：若检索意图属于"分析架构"/"了解模块分布"/"理解系统设计"/"找相关模块"类型，已通过 read_file 读取的**各核心模块文件**（入口文件、接口定义、关键子包）应优先标为 `valid_fold`，而非因"不是核心实现"而标 invalid。架构查询的证据价值在于确认模块存在及其组织关系，漏掉任何一个相关模块文件都会导致汇总阶段架构图不完整。\n   - ❌ 错误：架构查询时，把 tui/terminal.go、tui/light.go 等"已读取的子包文件"标为 invalid，导致汇总时模块缺席\n   - ✅ 正确：架构查询时，所有已读取的核心模块文件标 valid_fold，reason 写明该模块在架构中的角色\n\n### ❌ 错误做法\n- 直接输出工具调用而不先输出 <round_summary>\n- 省略 status 字段或使用非标准值\n- 不输出 <round_summary>（会导致下一轮丢失检索上下文）\n- 自己手写文件路径和行号（如 file: "/path" | lines: "48-51"）而不使用系统编号\n\n完成检索后会有专门的汇总指令，届时基于已筛选的有效代码块组织输出。当前阶段专注于：搜索 → 阅读 → 思考总结 → 标记证据 → 下一轮搜索。';static SUMMARY_PHASE_PROMPT='【汇总阶段】你已完成所有检索。请立即停止调用工具，基于已筛选的有效代码块输出结构化检索报告。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 已确认的有效代码块（元数据索引）\n以下是检索过程中你标记为有效的代码块索引信息（包括文件路径、行范围、标记原因、代码预览）：\n{{EFFECTIVE_BLOCKS}}\n\n⚠️ **代码来源约束（最高优先级）**：\nEVIDENCE 标签中的代码**必须**基于上方索引中列出的文件路径和 scope，结合你在检索过程中实际阅读的代码内容来组织。\n上方索引提供了每个有效代码块的精确位置（文件路径、行范围、所属函数/类），以及简短的代码预览，请以此作为定位依据。\n**绝对禁止**凭空编造不存在的文件路径或函数名。如果某段代码你记忆模糊、无法确信其准确性，应标注为"需进一步确认"而非猜测。\n\n## 报告格式\n\n请基于以上有效代码块，生成最终报告。格式如下：\n\n---\n## 检索结论\n\n（3-5句话，直接回答原始检索意图的核心问题，点明关键文件和模块。必须基于上方有效代码块中的具体细节得出结论。特别注意：代码中的可选参数、条件分支对方案的影响；用关键边界值（0, None, 空集）验证你的结论逻辑；如果建议参考某处代码，说明两者的差异）\n\n## 关键证据\n\n每条证据**必须**使用 <<<EVIDENCE>>> 标记包裹代码片段。**绝对禁止在标签中写任何行号**，行号由系统自动锚定。\n\n⚠️ **关键要求**：如果你不使用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 标签包裹代码，系统将**无法锚定行号**，你的检索报告将**不完整且无法被下游使用**。每一条代码证据都必须用此标签包裹，没有例外。\n\n- **短代码片段（≤30行）**：完整列出所有代码行：\n  <<<EVIDENCE file="/绝对路径" scope="所在函数/类/方法名">>>\n  完整代码内容（每一行都要包含）\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明与检索意图的关联。\n\n- **长代码片段（>30行）**：首尾各保留2行，中间用 ... 省略：\n  <<<EVIDENCE file="/绝对路径" scope="所在函数/类/方法名">>>\n  首行1\n  首行2\n  ...\n  尾行1\n  尾行2\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明核心逻辑。\n\n### ✅ 正确示例\n- **Bash 中的 Alt-C 绑定**：\n  <<<EVIDENCE file="/data/repos/fzf/shell/key-bindings.bash" scope="ALT-C binding section">>>\n  # ALT-C - cd into the selected directory\n  if [[ ${FZF_ALT_C_COMMAND-x} != "" ]]; then\n    bind -m emacs-standard \'"\\ec": " \\C-b\\C-k \\C-u`__fzf_cd__`\\e\\C-e..."\'\n  fi\n  <<<END_EVIDENCE>>>\n  这段代码通过 bash 的 bind 命令将 \\ec（Alt-C）绑定到 __fzf_cd__ 函数。\n\n### ❌ 禁止的格式\n- ❌ 📄 `/data/repos/fzf/shell/key-bindings.bash:166-167`（禁止直接写行号）\n- ❌ 在 <<<EVIDENCE>>> 标签属性中包含任何行号数字\n- ❌ 省略 scope 属性\n- ❌ 代码内容与上方"已确认的有效代码块"索引中的文件路径/scope 不对应\n\n## 未解决问题\n\n（列出检索中未能确认的疑点。特别是：如果你在标注证据时发现代码中调用了未在检索范围内的函数/引用了未在检索范围内的定义（即 [DEPTH-GAP] 情况），在此汇总这些未充分探索的区域及其与检索意图的潜在关联。若无则写"无"）\n\n---\n\n### 🔍 输出前自检清单（必须逐条检查）\n1. 每条证据是否都用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 包裹？**如果有任何一条代码未包裹，整个报告将被系统判定为格式不合规。**\n2. 是否有任何行号数字出现在标签中或 📄 格式中？\n3. file 属性是否为绝对路径？scope 是否已填写？\n4. 代码首尾行是否与检索过程中实际阅读的内容一致？\n5. 关键证据部分是否至少包含 1 个 <<<EVIDENCE>>> 块？**空的关键证据部分是不可接受的。**\n6. 每条 EVIDENCE 中的 file 和 scope 是否能在上方"已确认的有效代码块"索引中找到对应条目？**禁止编造不存在的文件路径或函数名。**\n\n## 汇总质量自检（必须附加在报告之后）\n\n输出完检索结论和未解决问题后，附加以下自检块：\n\n```\n<summary_retrieval_selfcheck>\n  <intent_satisfaction status="SATISFIED|PARTIAL|UNSATISFIED">\n    验证原始检索意图的核心问题是否已被EVIDENCE充分覆盖：\n    SATISFIED：检索意图已有充分证据回答；\n    PARTIAL：部分维度缺乏证据（说明哪些维度）；\n    UNSATISFIED：主要维度缺乏证据，结论可信度低。\n  </intent_satisfaction>\n  <summary_verdict status="APPROVED|NEEDS_REANNOTATION">\n    APPROVED：汇总质量达标，结论可信；\n    NEEDS_REANNOTATION：按以下格式指出需要重新标注的文件及原因：\n    - 文件路径 → 重标注原因\n  </summary_verdict>\n  <type_risk status="NO_RISK|TYPE_RISK">\n    当 FIX-HINT 中建议将某变量初始化为 None/0/空列表/空字符串等默认值时，验证类型兼容性：\n    NO_RISK：已验证下游用法与初始化类型兼容（纯赋值、不涉及 in/+/.[] 操作）；\n    TYPE_RISK：FIX-HINT 存在类型不兼容风险（如 None 赋值但下游调用 .keys()），在 FIX-HINT 中修正或补充类型说明。\n  </type_risk>\n  <fix_hint_4principles status="COMPLIANT|NEEDS_REVISION">\n    对照 4 条 FIX-HINT 原则逐条检查：\n    1. 修改最小化（不引入无关变更）；2. 类型兼容；3. 架构层次约束；4. 调用链层次选择（实现层而非调用侧）。\n    COMPLIANT：FIX-HINT 符合全部 4 条原则；\n    NEEDS_REVISION：说明违反了哪条原则（及影响点）。\n  </fix_hint_4principles>\n  <factory_completeness status="FACTORY_COMPLETE|FACTORY_INCOMPLETE|NOT_APPLICABLE">\n    当 FIX-HINT 目标函数名含 factory/make/create/_base 或目标是元类/基类时：\n    FACTORY_COMPLETE：已验证同模块其他工厂函数/子类无需同步修改；\n    FACTORY_INCOMPLETE：存在其他工厂函数/子类可能需要同步修改，已在 FIX-HINT 中列出；\n    NOT_APPLICABLE：目标不涉及工厂/基类模式。\n  </factory_completeness>\n  <layer_verification status="LAYER_CONFIRMED|LAYER_CHECK_REQUIRED|NOT_APPLICABLE">\n    当 effective_blocks 包含多层级文件时（调用侧+实现侧并存）：\n    LAYER_CONFIRMED：FIX-HINT 选择的是实现/转换层（字段转换器、序列化器、类方法），而非调用侧直接赋值；\n    LAYER_CHECK_REQUIRED：FIX-HINT 目前指向调用侧直接赋值，需评估是否改为修改深层实现；\n    NOT_APPLICABLE：effective_blocks 均在同一层级，无需判断。\n  </layer_verification>\n</summary_retrieval_selfcheck>\n```';static DOC_SUMMARY_PHASE_PROMPT='【汇总阶段】你已完成所有检索。请立即停止调用工具，基于已筛选的有效内容块输出结构化检索报告。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 已确认的有效内容块（元数据索引）\n以下是检索过程中你标记为有效的内容块索引信息（包括文件路径、行范围、标记原因、内容预览）：\n{{EFFECTIVE_BLOCKS}}\n\n⚠️ **内容来源约束（最高优先级）**：\nEVIDENCE 标签中的内容**必须**基于上方索引中列出的文件路径和 scope，结合你在检索过程中实际阅读的文档/代码内容来组织。\n上方索引提供了每个有效内容块的精确位置（文件路径、行范围、所属章节/函数/类），以及简短的内容预览，请以此作为定位依据。\n**绝对禁止**凭空编造不存在的文件路径或章节名。如果某段内容你记忆模糊、无法确信其准确性，应标注为"需进一步确认"而非猜测。\n\n## 报告格式\n\n请基于以上有效内容块，生成最终报告。格式如下：\n\n---\n## 检索结论\n\n（3-5句话，直接回答原始检索意图的核心问题，点明关键文件和模块。必须基于上方有效内容块中的具体细节得出结论。特别注意：内容中的可选参数、条件分支对方案的影响；如果建议参考某处内容，说明两者的差异）\n\n## 关键证据\n\n每条证据**必须**使用 <<<EVIDENCE>>> 标记包裹内容片段。**绝对禁止在标签中写任何行号**，行号由系统自动锚定。\n\n⚠️ **关键要求**：如果你不使用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 标签包裹内容，系统将**无法锚定行号**，你的检索报告将**不完整且无法被下游使用**。每一条内容证据都必须用此标签包裹，没有例外。\n\n- **短片段（≤30行）**：完整列出所有行：\n  <<<EVIDENCE file="/绝对路径" scope="函数/类/方法名或章节名">>>\n  完整内容（每一行都要包含）\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明与检索意图的关联。\n\n- **长片段（>30行）**：首尾各保留2行，中间用 ... 省略：\n  <<<EVIDENCE file="/绝对路径" scope="函数/类/方法名或章节名">>>\n  首行1\n  首行2\n  ...\n  尾行1\n  尾行2\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明核心内容。\n\n### ✅ 正确示例\n- **HelloGitHub 推荐的爬虫工具**：\n  <<<EVIDENCE file="/data/repos/HelloGitHub/content/HelloGitHub86.md" scope="爬虫工具推荐章节">>>\n  ### Scrapy\n  强大的 Python 爬虫框架，支持异步处理...\n  <<<END_EVIDENCE>>>\n  该段落列出了爬虫工具的具体名称和说明，直接回答检索意图。\n\n### ❌ 禁止的格式\n- ❌ 📄 `/data/repos/HelloGitHub/content/HelloGitHub86.md:139-141`（禁止直接写行号）\n- ❌ 在 <<<EVIDENCE>>> 标签属性中包含任何行号数字\n- ❌ 省略 scope 属性\n- ❌ 内容与上方"已确认的有效内容块"索引中的文件路径/scope 不对应\n\n## 未解决问题\n\n（列出检索中未能确认的疑点。若无则写"无"）\n\n---\n\n### 🔍 输出前自检清单（必须逐条检查）\n1. 每条证据是否都用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 包裹？**如果有任何一条内容未包裹，整个报告将被系统判定为格式不合规。**\n2. 是否有任何行号数字出现在标签中或 📄 格式中？\n3. file 属性是否为绝对路径？scope 是否已填写？\n4. 内容首尾行是否与检索过程中实际阅读的内容一致？\n5. 关键证据部分是否至少包含 1 个 <<<EVIDENCE>>> 块？**空的关键证据部分是不可接受的。**\n6. 每条 EVIDENCE 中的 file 和 scope 是否能在上方"已确认的有效内容块"索引中找到对应条目？**禁止编造不存在的文件路径或章节名。**';static ANNOTATION_PHASE_PROMPT='你是一个代码证据标注专家，正在对检索阶段筛选出的有效代码块进行精细标注。\n\n## 你的唯一任务\n从系统提供的代码块中，精确标记与检索意图直接相关的代码片段，使用 <<<EVIDENCE>>> 标签包裹。\n\n## EVIDENCE 格式规范\n\n每条证据**必须**使用以下格式：\n\n<<<EVIDENCE file="/绝对路径" scope="所在函数/类/方法名">>>\n代码内容\n<<<END_EVIDENCE>>>\n（2-3句话说明与检索意图的关联）\n\n- **短代码片段（≤30行）**：完整列出所有代码行\n- **中等代码片段（31-100行）**：首尾各保留2行，中间用 ... 省略\n- **无法拆分的长片段（>30行且逻辑上不可分割）**：当代码块内部高度耦合、裁剪任意部分都会丢失理解上下文时（如完整的状态机、密集的数据结构定义、整体都相关的核心算法），先按正常规则写出完整代码（短代码全量，长代码首尾2行+...），再用 CORE_EVIDENCE **嵌套在完整代码内部**圈出最关键的那些行：\n\n```\n<<<EVIDENCE file="/绝对路径" scope="函数名">>>\nfunc longFunc() {\n    setup()\n    ...\n<<<CORE_EVIDENCE>>>\n    criticalLine1()\n    criticalLine2()\n<<<CORE_EVIDENCE_END>>>\n    ...\n    cleanup()\n}\n<<<END_EVIDENCE>>>\n```\n  ⚠️ CORE_EVIDENCE 内的行必须是上方完整代码中实际存在的行，直接复制不要改写；能用 ... 直接省略掉的就不要用此标记\n\n## 精标原则\n\n1. 代码**必须**从系统提供的代码块中直接引用或摘取，**绝对禁止**凭记忆编写代码\n2. 同一个代码块中有多处分散的相关代码，输出多条独立 EVIDENCE\n3. 跳过与检索意图无关的部分（辅助函数、无关常量、样板代码）\n4. 如果整个代码块与检索意图都不相关，可以不输出任何 EVIDENCE\n5. 每条 EVIDENCE 的 scope 应精确到具体函数/方法名\n6. 每条 EVIDENCE 后面的说明开头，用优先级标记该证据对汇总结论的重要程度：\n   - **[UNFOLD-1]**：核心证据——该代码是回答检索意图的核心实现，缺失此代码会导致结论错误。要求：EVIDENCE 代码尽量精简到关键部分（≤30行）。**所有标注轮合计 UNFOLD-1 按文件级计数不超过 5 个文件**（同文件多条 UNFOLD-1 只占 1 个文件配额）。\n   - **[UNFOLD-2]**：重要证据——代码中的参数/分支/边界逻辑对结论准确性有明显影响。要求：同上。\n   - **[UNFOLD-3]**：间接关联——与 query 相关但非直接因果链上的内容（如配置、注册、类型定义、外部文档）。要求：同上。\n   - **[UNFOLD-4]**：辅助参考——有助于理解背景但不直接影响结论的内容（如测试用例、示例、历史变更）。要求：同上。\n   - **[FOLD]**：辅助证据——汇总结论不需要看具体代码行即可得出。要求：说明中必须包含足够详细的分析以替代代码本身（关键参数的行为、边界条件的影响、与其他代码的差异等）。\n   ⚠️ 汇总阶段展开预算约 8000 字符，大多数证据应标为 UNFOLD-2/3/4 或 FOLD，只有"不看代码必然导致结论错误"的才标 UNFOLD-1。\n7. 无论 UNFOLD 还是 FOLD，如果代码中存在以下情况，必须在说明中指出：\n   - **可选参数或条件分支**：指出这些参数/分支对理解或修复方案的影响（如"注意 condition 参数使 partial constraint 不等于 unique=True"）\n   - **边界值行为**：用关键边界值（0, None, 空集）验证代码逻辑，指出异常行为（如"当 min_lines=0 时，num < min_lines 等价于 num < 0，永远不成立"）\n8. **控制流块完整性（Pattern E 规则）**：当修复目标代码位于 if/else/elif/for/while/try/except/match 等控制流结构**内部**时，EVIDENCE **必须覆盖完整的控制流块（包含所有分支）**：\n   - 完整块 ≤50行：直接包含全部分支（if 块 + else/elif 块 + 可能的 else 终止块）\n   - 完整块 >50行：使用 CORE_EVIDENCE 圈出关键行，但 EVIDENCE 框架必须保留所有分支的首行（保留 if/elif/else 各分支的入口行）\n   - **严禁只取一个分支**：if 修复在某分支，仍需包含其余分支（分支间的对比是审阅者判断修复是否完整的关键）\n   - 仅当目标行处于函数顶层（无任何控制流嵌套）时，才可以直接截取目标行 ±N 行\n   - **同类代码差异**：如果检索意图涉及参考其他代码，指出两者在作用范围、粒度、调用时机上的差异\n8. **深度缺口标记**：如果你在阅读代码时发现以下情况，**必须**在对应 EVIDENCE 的说明末尾添加 [DEPTH-GAP] 标记并说明缺失了什么：\n   - 代码中调用了某个函数/方法，但该函数的实现未出现在当前或其他批次的代码块中\n   - 代码中引用了某个变量/常量的定义，但定义未在检索范围内\n   - 当前代码块只覆盖了某个类/模块的部分方法，其他方法可能与检索意图相关但未被检索\n   格式：`[DEPTH-GAP: _batched_insert() 的实现未在检索范围内，该函数接收 batch_size 参数并可能有独立的批次逻辑]`\n   ⚠️ 这个标记非常重要——它帮助汇总阶段区分"已确认无关"和"因探索不足而无法判断"，避免汇总阶段做出过度自信的断言。\n\n## 输出规范\n\n- 直接输出 <<<EVIDENCE>>> 块，不要输出 <round_summary> 或 <effective_blocks> 等标签\n- 完成所有标注后，先输出 `<annotation_coverage_check>` 自检块（见下方格式），再输出 `<annotation_complete/>` 信号\n- 不要调用任何工具\n\n## 标注覆盖自检（必须在 annotation_complete 之前输出）\n\n完成全部 EVIDENCE 标注后，输出以下自检块：\n\n```\n<annotation_coverage_check>\n  <covered_files>已输出EVIDENCE的文件列表（逗号分隔）</covered_files>\n  <skipped_files>未输出EVIDENCE的文件及原因，如"file.go（与检索意图无关）"，若无则写"无"</skipped_files>\n  <evidence_precision status="PASS|IMPRECISE">\n    PASS：所有EVIDENCE的scope范围准确精简（≤30行关键代码）；\n    IMPRECISE：指出哪些EVIDENCE范围过宽，如"xxx.go EVIDENCE 包含了无关辅助代码，应只保留核心函数体"\n  </evidence_precision>\n  <retrieval_reason_alignment status="ALIGNED|PARTIAL|MISALIGNED">\n    逐文件对照检索阶段标记为valid的原因（代码块注释中的reason字段）与实际代码内容是否吻合：\n    ALIGNED：所有文件的检索原因与代码实际行为完全吻合；\n    PARTIAL：部分文件原因与代码有偏差（说明具体文件和偏差点）；\n    MISALIGNED：检索原因与代码实际行为明显不符（说明具体文件和偏差点）。\n  </retrieval_reason_alignment>\n  <coverage_verdict status="COMPLETE|INCOMPLETE">\n    COMPLETE：系统提供的所有valid_unfold代码块均已有对应EVIDENCE输出；\n    INCOMPLETE：指出遗漏的文件，如"tui.go、terminal.go 未标注，原因：XXX"（系统将触发补充标注）。\n  </coverage_verdict>\n  <block_completeness status="BLOCK_COMPLETE|BLOCK_PARTIAL">\n    BLOCK_COMPLETE：所有EVIDENCE块已覆盖完整逻辑块（if/else/elif/for/while 等控制流结构的完整分支）；\n    BLOCK_PARTIAL：某些EVIDENCE范围落在控制流中间，未覆盖完整分支（说明哪个EVIDENCE、缺少哪个分支，系统将扩展范围）。\n    注意：如修复点在 if/else 内，必须确保 EVIDENCE 同时包含所有分支（不能只取一个 branch）。\n  </block_completeness>\n  <reference_bridging status="BRIDGED|UNBRIDGED|NOT_APPLICABLE">\n    当 evidence 中同时存在 [UNFOLD-3]/[UNFOLD-4]（参考实现）和 [UNFOLD-1]/[UNFOLD-2]（修复目标）时：\n    BRIDGED：FIX-HINT 中已明确写出"参照 EVIDENCE X 的模式修改 EVIDENCE Y"；\n    UNBRIDGED：存在参考+目标组合，但 FIX-HINT 未明确桥接（需要补充桥接说明）；\n    NOT_APPLICABLE：evidence 中不存在参考实现与修复目标并存的情况，无需检查。\n  </reference_bridging>\n</annotation_coverage_check>\n```\n\n⚠️ **自检规则**：coverage_verdict=INCOMPLETE 或 evidence_precision=IMPRECISE 时，系统会自动触发补充标注（无需你在此轮内重复输出）；retrieval_reason_alignment=MISALIGNED 时系统记录告警，不阻断标注流程；block_completeness=BLOCK_PARTIAL 时系统记录警告，提示检索轮补充完整分支；reference_bridging=UNBRIDGED 时在 FIX-HINT 中补充桥接说明。';static DOC_ANNOTATION_PHASE_PROMPT='你是一个文档内容标注专家，正在对检索阶段筛选出的有效文档块进行精细标注。\n\n## 你的唯一任务\n从系统提供的文档块中，精确标记与检索意图直接相关的内容片段，使用 <<<EVIDENCE>>> 标签包裹。\n\n## EVIDENCE 格式规范\n\n每条证据**必须**使用以下格式：\n\n<<<EVIDENCE file="/绝对路径" scope="所在章节/小节名">>>\n文档内容\n<<<END_EVIDENCE>>>\n（2-3句话说明与检索意图的关联）\n\n- **短片段（≤30行）**：完整列出所有内容行\n- **中等片段（31-100行）**：首尾各保留2行，中间用 ... 省略\n- **无法拆分的长片段（>30行且逻辑上不可分割）**：当内容内部高度耦合时，先按正常规则写出完整内容（短内容全量，长内容首尾2行+...），再用 CORE_EVIDENCE **嵌套在完整内容内部**圈出最关键的行：\n\n```\n<<<EVIDENCE file="/绝对路径" scope="章节名">>>\n前置内容\n...\n<<<CORE_EVIDENCE>>>\n关键行1\n关键行2\n<<<CORE_EVIDENCE_END>>>\n...\n后续内容\n<<<END_EVIDENCE>>>\n```\n  ⚠️ CORE_EVIDENCE 内的行必须是上方完整内容中实际存在的行，直接复制不要改写；能用 ... 直接省略掉的就不要用此标记\n\n## 精标原则\n\n1. 内容**必须**从系统提供的文档块中直接引用或摘取，**绝对禁止**凭记忆编写内容\n2. 同一个文档块中有多处分散的相关内容，输出多条独立 EVIDENCE\n3. 跳过与检索意图无关的部分（目录、版权声明、无关段落）\n4. 如果整个文档块与检索意图都不相关，可以不输出任何 EVIDENCE\n5. 每条 EVIDENCE 的 scope 应精确到具体章节或小节名\n6. 每条 EVIDENCE 后面的说明开头，用优先级标记该证据对汇总结论的重要程度：\n   - **[UNFOLD-1]**：核心证据——该内容是回答检索意图的核心信息，缺失会导致结论错误。要求：EVIDENCE 内容尽量精简到关键部分（≤30行）。**所有标注轮合计 UNFOLD-1 按文件级计数不超过 5 个文件**（同文件多条 UNFOLD-1 只占 1 个文件配额）。\n   - **[UNFOLD-2]**：重要证据——内容中的具体数据/参数/条件对结论准确性有明显影响。\n   - **[UNFOLD-3]**：间接关联——与 query 相关但非直接因果链上的内容（如背景说明、概念定义）。\n   - **[UNFOLD-4]**：辅助参考——有助于理解背景但不直接影响结论的内容（如示例、注意事项）。\n   - **[FOLD]**：辅助证据——汇总结论不需要看具体内容行即可得出。要求：说明中必须包含足够详细的分析以替代内容本身。\n   ⚠️ 汇总阶段展开预算约 8000 字符，大多数证据应标为 UNFOLD-2/3/4 或 FOLD，只有"不看内容必然导致结论错误"的才标 UNFOLD-1。\n7. **深度缺口标记**：如果你在阅读内容时发现引用了其他章节/文档但未被检索到，**必须**在对应 EVIDENCE 的说明末尾添加 [DEPTH-GAP] 标记并说明缺失了什么。\n\n## 输出规范\n\n- 直接输出 <<<EVIDENCE>>> 块，不要输出 <round_summary> 或 <effective_blocks> 等标签\n- 完成所有标注后输出 <annotation_complete/> 信号\n- 不要调用任何工具';static AUTO_ANNOTATION_PHASE_PROMPT='你是一个内容证据标注专家，正在对检索阶段筛选出的有效内容块进行精细标注。\n\n## 你的唯一任务\n从系统提供的内容块中，精确标记与检索意图直接相关的内容片段，使用 <<<EVIDENCE>>> 标签包裹。\n\n## EVIDENCE 格式规范\n\n每条证据**必须**使用以下格式：\n\n<<<EVIDENCE file="/绝对路径" scope="函数/类/方法名或章节名">>>\n内容\n<<<END_EVIDENCE>>>\n（2-3句话说明与检索意图的关联）\n\n- **短片段（≤30行）**：完整列出所有行\n- **中等片段（31-100行）**：首尾各保留2行，中间用 ... 省略\n- **无法拆分的长片段（>30行且逻辑上不可分割）**：先按正常规则写出完整内容，再用 CORE_EVIDENCE **嵌套在完整内容内部**圈出最关键的行：\n\n```\n<<<EVIDENCE file="/绝对路径" scope="函数名或章节名">>>\n前置内容\n...\n<<<CORE_EVIDENCE>>>\n关键行1\n关键行2\n<<<CORE_EVIDENCE_END>>>\n...\n后续内容\n<<<END_EVIDENCE>>>\n```\n  ⚠️ CORE_EVIDENCE 内的行必须是上方完整内容中实际存在的行，直接复制不要改写；能用 ... 直接省略掉的就不要用此标记\n\n## 精标原则\n\n1. 内容**必须**从系统提供的内容块中直接引用或摘取，**绝对禁止**凭记忆编写\n2. 同一个内容块中有多处分散的相关内容，输出多条独立 EVIDENCE\n3. 跳过与检索意图无关的部分（辅助函数、无关常量、目录、版权声明等）\n4. 如果整个内容块与检索意图都不相关，可以不输出任何 EVIDENCE\n5. 每条 EVIDENCE 的 scope 应精确到具体函数/方法名（代码）或章节名（文档）\n6. 每条 EVIDENCE 后面的说明开头，用优先级标记该证据对汇总结论的重要程度：\n   - **[UNFOLD-1]**：核心证据——该内容是回答检索意图的核心，缺失会导致结论错误。要求：EVIDENCE 内容尽量精简到关键部分（≤30行）。**所有标注轮合计 UNFOLD-1 按文件级计数不超过 5 个文件**（同文件多条 UNFOLD-1 只占 1 个文件配额）。\n   - **[UNFOLD-2]**：重要证据——内容中的参数/分支/数据对结论准确性有明显影响。\n   - **[UNFOLD-3]**：间接关联——与 query 相关但非直接因果链上的内容。\n   - **[UNFOLD-4]**：辅助参考——有助于理解背景但不直接影响结论的内容。\n   - **[FOLD]**：辅助证据——汇总结论不需要看具体内容行即可得出。要求：说明中必须包含足够详细的分析以替代内容本身。\n   ⚠️ 汇总阶段展开预算约 8000 字符，大多数证据应标为 UNFOLD-2/3/4 或 FOLD，只有"不看内容必然导致结论错误"的才标 UNFOLD-1。\n7. 无论 UNFOLD 还是 FOLD，如果内容中存在可选参数/条件分支/边界值行为/同类差异，必须在说明中指出。\n8. **深度缺口标记**：如果内容中引用了未被检索到的函数实现或文档章节，**必须**在对应 EVIDENCE 的说明末尾添加 [DEPTH-GAP] 标记并说明缺失了什么。\n\n## 输出规范\n\n- 直接输出 <<<EVIDENCE>>> 块，不要输出 <round_summary> 或 <effective_blocks> 等标签\n- 完成所有标注后输出 <annotation_complete/> 信号\n- 不要调用任何工具';static FIX_HINT_REQUIREMENT_SEGMENT='\n\n## 修复建议标注（仅修复类 query）\n\n对于标记为 UNFOLD 级别（UNFOLD-1/2/3）的证据，需附加 FIX-HINT 字段：\n- [UNFOLD-1] 核心证据：FIX-HINT 为必填项，必须包含以下三项（格式：`[FIX-HINT] 修改：... | 层次：... | 约束：...`）：\n  1. **修改内容**：此处代码应如何修改（≤150字符）\n  2. **层次选择**：为何在此层实现而非调用方或被调用方？若涉及数据流中间层（类型转换/值设置/状态更新），说明是否存在更合适的上游聚合点（≤100字符）；若无层次分歧则写"当前层次合适"\n  3. **关键约束**：是否有边界条件、多字段/多分支需同步、副作用需验证？若有则明确列出；若无则写"无特殊约束"（≤100字符）\n  如果无法确定修复方向，写：[FIX-HINT] 修改：UNCERTAIN - 需进一步确认（简述不确定原因）| 层次：待总结轮综合确定 | 约束：未知\n- [UNFOLD-2] / [UNFOLD-3] 证据：建议附加 FIX-HINT，如有修复相关见解则写，无则可省略\n- [FOLD] 辅助证据：不需要附加 FIX-HINT\n\n## 修复位置选择原则（FIX-HINT 撰写时需遵守）\n\n1. **根因 vs 症状**：FIX-HINT 应精准指向根本原因，而非仅描述症状触发位置。区分"此处代码触发了错误"（症状）和"此处代码是问题根源"（根因），优先标注根因所在位置。\n2. **修改范围最小化**：优先改最底层的共享逻辑（工具函数 / 基类 / util），避免在多个调用方重复打补丁。同样的逻辑只改一处。\n3. **跨模块依赖标注**：若修改存在跨文件 / 跨模块的联动影响（如基类变更需同步子类），在 FIX-HINT 中显式标注"同步修改: [文件或类名]"。\n4. **架构层次约束**：不要将 model 层逻辑上移到 view 层，不要用应用层代码绕过 DB 约束，保持修改在其所属的架构层次内。\n5. **调用链层次选择（N4）**：当有多个候选修复文件时，优先选择"职责最专一"的实现/转换层（如字段转换应在转换层，序列化应在序列化层），而非调用侧直接赋值层。浅层（调用方直接赋值/访问）的修复是临时绕过，不是根本修复；深层（字段转换层、序列化层、类方法层）的修复让所有调用方自动受益，且符合架构边界。\n\n⚠️ **【Fix F Seg1】禁止全 FOLD（修复类检索专用）**：对于修复类检索（fix intent），至少需要将最相关的 1-2 个证据标为 [UNFOLD-1]，以便总结轮进行跨批次层次推理。若所有证据均为 [FOLD]，请重新评估并至少将修复位置最直接的证据块升级为 [UNFOLD-1]。';static SUMMARY_ANNOTATION_PROMPT='【精细标注轮 {{CURRENT_ROUND}}/{{TOTAL_ROUNDS}}】\n\n系统将有效代码块分批展示，每轮你只需标注当前批次。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n{{PREVIOUS_ANNOTATIONS}}\n\n## 全局有效代码块概览（共 {{TOTAL_BLOCKS}} 个，仅 snippet 预览）\n{{VALID_BLOCKS_OVERVIEW}}\n\n## 本轮待精读的代码块（{{BLOCK_COUNT}} 个，共 {{LINE_COUNT}} 行）\n\n⚠️ **代码来源约束**：EVIDENCE 标签中的代码**必须**从下方代码块中直接引用或摘取。\n\n{{CURRENT_BLOCKS}}\n\n⚠️ **分析性标注要求**：\n1. 每条 EVIDENCE 后用优先级标记重要程度：\n   - [UNFOLD-1]：核心证据，缺失会导致结论错误（代码精简到 ≤30 行）\n   - [UNFOLD-2]：重要证据，参数/分支/边界影响结论准确性\n   - [UNFOLD-3]：间接关联，与 query 相关但非直接因果链上的内容\n   - [UNFOLD-4]：辅助参考，有助于理解背景但不直接影响结论\n   - [FOLD]：辅助证据，说明要写得足够详细以替代代码（关键参数行为、边界条件、差异分析等）\n2. 说明中指出代码的特殊参数/条件分支、边界值行为、与参考对象的差异\n3. **深度缺口标记**：如果代码中调用了未在检索范围内的函数/引用了未在检索范围内的定义，在 EVIDENCE 说明末尾添加 `[DEPTH-GAP: 缺失内容描述]`\n4. ⚠️ **预算约束**：汇总阶段只能展开约 8000 字符的代码（约 5-8 个中等函数）。所有标注轮合计，UNFOLD-1 按文件级计数应控制在 5 个文件以内（同文件多条 UNFOLD-1 只占 1 个配额）——只标注"不看代码就一定会得出错误结论"的证据。大多数证据应该是 UNFOLD-2/3/4 或 FOLD。\n5. **CORE_EVIDENCE（不可拆分的长片段）**：当代码块内部高度耦合、裁剪任意部分都会丢失理解上下文时（>30行且逻辑上不可分割），先按正常规则写出完整代码，再用 `<<<CORE_EVIDENCE>>>` / `<<<CORE_EVIDENCE_END>>>` **嵌套在完整代码内部**圈出最关键的行（必须是完整代码中实际存在的行，直接复制）。能用 `...` 直接省略的就不要用此标记；系统会在预算不足时优先保留 CORE_EVIDENCE 内容。\n\n请对上方代码块中与检索意图相关的代码片段输出 <<<EVIDENCE>>> 标注。\n完成后输出 <annotation_complete/> 信号。';static SUMMARY_FINAL_PROMPT='【汇总阶段 - 最终汇总】\n\n所有代码块已完成精细标注。标注轮中标记为关键（[UNFOLD]）的证据代码已注入下方，辅助证据（[FOLD]）以代码预览 + 分析摘要形式提供。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 各轮标注摘要\n{{ANNOTATION_SUMMARIES}}\n\n## 关键证据代码（标注轮标记为 [UNFOLD]，完整代码）\n{{CRITICAL_EVIDENCES}}\n\n{{UNFOLD_CODE_REINJECTION}}\n\n## 辅助证据摘要（标注轮标记为 [FOLD]，代码预览 + 分析）\n{{FOLD_EVIDENCES}}\n\n## 请输出以下内容\n\n---\n## 检索结论\n\n（3-5句话，直接回答原始检索意图的核心问题。必须基于上方关键证据代码中的具体细节得出结论，不要忽略标注轮分析中指出的边界条件和注意事项。\n\n⚠️ **确定性层级要求**：对涉及的每个关键模块/文件，根据证据充分程度使用不同措辞：\n- 已有 EVIDENCE 覆盖且无 DEPTH-GAP，且检索阶段的根因假设已标记为 [已验证] → 可做确定性结论（如"X 函数的实现逻辑是..."）\n- 标注中标记了 [DEPTH-GAP]，或检索阶段的根因假设仍为 [推测] 状态 → 只能做推测性结论（如"X 函数调用了 Y，但 Y 的实现未被检索，无法确认其内部逻辑"），**禁止**将未充分探索的区域断言为"已确认根因"\n- 特别注意：如果根因涉及多层调用链（A→B→C），仅验证了 A 和 C 而跳过了 B，即使 A 和 C 都有 EVIDENCE 覆盖，结论仍应标记为推测性——因为中间环节可能改变了执行路径\n\n如果输出了多条 EVIDENCE，必须在结论中说明各 evidence 之间的关系：哪些需要同时修改、修改的先后依赖、互补性关系。避免给出一个只基于单条 evidence 的结论而忽略其他 evidence 的约束。\n）\n\n## 未解决问题\n\n（汇总标注轮中所有 [DEPTH-GAP] 标记，列出未被充分探索的函数/模块及其与检索意图的潜在关联。若无 DEPTH-GAP 则写"无"。\n\n格式示例：\n- `_batched_insert()` 的实现未被检索，该函数接收 batch_size 参数，可能存在独立的批次逻辑\n- `make_xrefs()` 与已检索的 `_parse_annotation()` 在同一文件但属于不同代码路径，未确认是否也处理类型标注\n）\n\n---\n\n⚠️ **结论自检**：\n1. 对照关键证据代码，检查标注轮分析中的逻辑是否与代码实际行为一致（如：标注轮称"过滤 X < Y"，代码中 Y=0 时是否真的能过滤？）\n2. 关键证据代码中的特殊参数/条件分支是否已在结论中体现？\n3. 辅助证据的分析摘要中标注的注意事项是否已纳入结论？\n4. 如果结论建议"参考某处的做法"，是否已说明两者的差异？\n5. 标注轮中是否存在 [DEPTH-GAP] 标记？如果存在，结论中是否避免了对相关区域的断言性结论？"未解决问题"中是否已汇总所有 DEPTH-GAP？\n\n## 汇总质量自检（必须附加在结论之后）\n\n输出完检索结论和未解决问题后，附加以下自检块：\n\n```\n<summary_retrieval_selfcheck>\n  <annotation_quality_review status="GOOD|PARTIAL|POOR">\n    评估标注轮整体质量：证据覆盖是否充分、精度是否合格、DEPTH-GAP是否合理标记。\n    GOOD：标注覆盖充分、精度准确；PARTIAL：部分文件标注不足；POOR：大量文件缺失或精度差。\n  </annotation_quality_review>\n  <retrieval_evidence_alignment status="ALIGNED|PARTIAL|MISALIGNED">\n    交叉验证：检索过程中各轮round_summary的结论，在EVIDENCE代码中是否有具体代码行支撑：\n    ALIGNED：所有主要结论都有充分EVIDENCE支持；\n    PARTIAL：部分结论缺乏EVIDENCE代码支撑（说明哪些结论）；\n    MISALIGNED：结论与EVIDENCE代码存在矛盾（说明具体冲突点）。\n  </retrieval_evidence_alignment>\n  <intent_satisfaction status="SATISFIED|PARTIAL|UNSATISFIED">\n    验证原始检索意图的核心问题是否已被EVIDENCE充分覆盖：\n    SATISFIED：检索意图已有充分证据回答；\n    PARTIAL：部分维度缺乏证据（说明哪些维度）；\n    UNSATISFIED：主要维度缺乏证据，结论可信度低。\n  </intent_satisfaction>\n  <summary_verdict status="APPROVED|NEEDS_REANNOTATION">\n    APPROVED：汇总质量达标，结论可信；\n    NEEDS_REANNOTATION：按以下格式指出需要重新标注的文件及原因（系统将触发重标注并重新汇总）：\n    - 文件路径 → 重标注原因（如"tui.go → 该文件被检索标记为valid但未生成EVIDENCE，需补充标注终端渲染相关逻辑"）\n  </summary_verdict>\n</summary_retrieval_selfcheck>\n```\n\n⚠️ **自检说明**：summary_verdict=APPROVED 时汇总完成；NEEDS_REANNOTATION 时系统会对指定文件触发重新标注并重新汇总，无需你重复输出结论。\n\n⚠️ **注意**：不要输出"关键证据"的代码复述，系统会自动从标注轮中提取完整的 EVIDENCE 块并拼接到你的输出后面。';static SUMMARY_PHASE_SYSTEM_PROMPT="你是一个代码检索报告的汇总专家。基于检索过程中收集的证据和摘要，输出结构化的检索结论。不要调用任何工具。";static DOC_SUMMARY_PHASE_SYSTEM_PROMPT="你是一个检索报告的汇总专家。基于检索过程中收集的文档/代码内容证据和摘要，输出结构化的检索结论。不要调用任何工具。";static ANNOTATION_PLAN_PROMPT='【标注规划轮】\n\n你需要为接下来的并行标注阶段制定计划。系统已将 {{TOTAL_BLOCKS}} 个有效代码块分为 {{BATCH_COUNT}} 个批次，每个批次将由独立的 LLM 并行标注（各批次之间无法看到彼此的标注结果）。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 批次分组（系统预计算，同文件代码块已聚合到同一批次）\n{{BATCHES_OVERVIEW}}\n\n## 全局约束\n- 所有批次合计 UNFOLD-1（核心证据：缺失会导致结论错误）按文件级计数不超过 5 个文件\n- 汇总阶段展开预算约 8000 字符（约 5-8 个中等函数）\n- 大多数证据应标为 UNFOLD-2/3 或 FOLD，只有"不看代码必然导致结论错误"的才标 UNFOLD-1\n\n请输出 <annotation_plan> 标签，为每个批次分配优先级预算和标注重点：\n\n<annotation_plan>\n  <batch id="1" priority_budget="UNFOLD-1:N, UNFOLD-2:N, UNFOLD-3:N, FOLD:N">\n    <focus>该批次的标注重点指引（基于检索结论，该批次代码中最应关注什么）</focus>\n  </batch>\n  ...（为每个批次输出一个 batch 标签）\n</annotation_plan>\n\n输出后以 <plan_complete/> 结束。';static PARALLEL_ANNOTATION_PROMPT='【精细标注轮 {{CURRENT_ROUND}}/{{TOTAL_ROUNDS}}（并行执行）】\n\n本轮与其他批次的标注由独立 LLM 并行执行，你无法看到其他批次的标注结果。请专注于标注当前批次。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 本批次标注计划\n- 标注重点：{{BATCH_FOCUS}}\n- 优先级预算：{{PRIORITY_BUDGET}}\n- 全局 UNFOLD-1 上限：5 个文件（本批次建议 ≤ {{P1_BUDGET}} 条）\n\n## 全局有效代码块概览（共 {{TOTAL_BLOCKS}} 个，仅 snippet 预览）\n{{VALID_BLOCKS_OVERVIEW}}\n\n## 本轮待精读的代码块（{{BLOCK_COUNT}} 个，共 {{LINE_COUNT}} 行）\n\n⚠️ **代码来源约束**：EVIDENCE 标签中的代码**必须**从下方代码块中直接引用或摘取。\n\n{{CURRENT_BLOCKS}}\n\n⚠️ **分析性标注要求**：\n1. 每条 EVIDENCE 后用优先级标记重要程度：\n   - [UNFOLD-1]：核心证据，缺失会导致结论错误（代码精简到 ≤30 行）\n   - [UNFOLD-2]：重要证据，参数/分支/边界影响结论准确性\n   - [UNFOLD-3]：参考证据，有助于理解上下文但不直接决定结论\n   - [FOLD]：辅助证据，说明要写得足够详细以替代代码（关键参数行为、边界条件、差异分析等）\n2. 说明中指出代码的特殊参数/条件分支、边界值行为、与参考对象的差异\n3. **深度缺口标记**：如果代码中调用了未在检索范围内的函数/引用了未在检索范围内的定义，在 EVIDENCE 说明末尾添加 `[DEPTH-GAP: 缺失内容描述]`\n4. ⚠️ **预算约束**：请参照上方本批次的优先级预算分配标注。\n\n请对上方代码块中与检索意图相关的代码片段输出 <<<EVIDENCE>>> 标注。\n\n完成标注后，输出以下自检块（**必须在 `<annotation_complete/>` 之前**）：\n\n```\n<annotation_coverage_check>\n  <covered_files>已输出EVIDENCE的文件列表（逗号分隔）</covered_files>\n  <skipped_files>未输出EVIDENCE的文件及原因，若无则写"无"</skipped_files>\n  <evidence_precision status="PASS|IMPRECISE">\n    PASS：所有EVIDENCE的scope范围准确精简；\n    IMPRECISE：指出哪些EVIDENCE范围过宽或偏离检索意图\n  </evidence_precision>\n  <retrieval_reason_alignment status="ALIGNED|PARTIAL|MISALIGNED">\n    对照本批次代码块注释中的reason字段，验证检索原因与代码实际行为是否吻合\n  </retrieval_reason_alignment>\n  <coverage_verdict status="COMPLETE|INCOMPLETE">\n    COMPLETE：本批次所有valid_unfold代码块均已有对应EVIDENCE；\n    INCOMPLETE：指出本批次遗漏的文件（系统将触发补充标注）\n  </coverage_verdict>\n</annotation_coverage_check>\n```\n\n完成后输出 `<annotation_complete/>` 信号。';static RETRIEVAL_AGENT_TOOLS=["codebase_search","grep_content","glob_path","read_file","run_command"];buildRetrievalPrompt(e){if("code"===e)return RetrievalAgent.RETRIEVAL_PHASE_PROMPT;const t="doc"===e?'### 2. 文档级证据原则（文档检索模式，最重要，必须严格遵守）\n**区分"线索"和"证据"——只有读过文档内容才有证据：**\n- **线索**：grep/search/list_dir 返回的文件路径或匹配摘要\n- **证据**：通过 read_file 读取文档内容后，确认该段内容与检索意图直接相关\n\n**有效证据的判断标准**：\n- 项目列表、架构说明、表格数据、知识点解释——只要内容回答了检索问题，即为 valid\n- 不需要找"实现某功能的代码"，而是找"包含目标信息的内容片段"\n- **所有文件类型均为知识来源**：.cpp、.py、.ts、.go 等代码文件与 .md 文件地位相同。文档仓库中的代码文件通常是知识示例（如 C++ 语法演示），不要因文件后缀是代码类型就跳过读取\n\n❌ 错误：read_file 读到项目推荐列表 → 标 invalid（理由：不是代码实现）\n❌ 错误：list_dir 发现 override.cpp → 跳过（理由：是代码文件）\n✅ 正确：read_file 读到项目推荐列表 → 确认包含目标项目 → 标 valid_unfold\n✅ 正确：list_dir 发现 override.cpp → read_file 读取 → 内容是 override 关键字示例 → 标 valid':"### 2. 通用相关性证据原则（自由探索模式）\n**证据 = read_file 读取后，内容与检索意图相关——无论是代码还是文档：**\n- 代码文件中的实现逻辑 → valid（如代码实现了目标功能）\n- 文档文件中的说明内容 → valid（如文档直接回答了检索问题）\n- 不按文件类型区分有效性，只按内容相关性判断";let r=RetrievalAgent.RETRIEVAL_PHASE_PROMPT.replace('### 2. 代码级证据原则（最重要，必须严格遵守）\n**区分"线索"和"证据"——只有读过代码才有证据：**\n- **线索**：grep/search/list_dir 返回的文件路径或匹配摘要。它们只说明"文件中存在某个文本模式"，不能确定其语义角色（可能是注释、文档引用、测试断言、真正的实现）\n- **证据**：通过 read_file 读取并分析了文件的实际代码后，确认某段代码确实实现了目标功能\n\n**硬性规则**：\n- 在 round_summary 中，对**未读代码的文件**只能使用推测性语言（如"可能包含…"、"需下一轮读取确认"），**禁止**使用断言性结论（如"找到了 X 的实现"）\n- 在 effective_blocks 中，**只标注已通过 read_file 实际读取并分析过代码逻辑的块**为 valid。如果某一轮只做了搜索/定位而未读取代码，该轮不应有任何 valid 标注\n- 你作为子 agent，token 预算充裕。**宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论**\n\n❌ 错误：grep 返回 key-bindings.bash → round_summary 写"找到了键绑定实现" → effective_blocks 标 valid\n✅ 正确：grep 返回 key-bindings.bash → round_summary 写"发现该文件包含关键词，可能是实现，需读取确认" → 下一轮 read_file → 确认后 round_summary 写"读取代码确认了第166行的键绑定逻辑" → effective_blocks 标 valid',t);const n="doc"===e?'### 5. 文档广度覆盖策略（重要）\n文档仓库的核心挑战是**覆盖广度**，不是调用链深度。\n\n**首轮并行探测**（以下两步应在第 1 轮同时发起）：\n- list_dir 根目录，检测是否存在目录/索引文件\n- 同时用 grep_content(pattern="核心关键词", glob="*.md", -i, files_with_matches) 快速定位候选文件\n\n**后续广度搜索**：\n- 如果首轮发现目录/索引文件：优先 read_file 索引文件，通过索引定位目标\n- 如果首轮 grep 已返回候选文件：直接 read_file 候选文件（不需要等 list_dir 结果）\n- 从多个语义侧面发起搜索，**pattern 必须同时覆盖中文分类词 + 英文名称/项目名**：\n  - 例：查询"Python爬虫相关项目" → grep_content(pattern="爬虫|抓取|crawler|spider|scrapy|pyspider|playwright|requests-html", ...)\n  - 例：查询"排序算法" → grep_content(pattern="冒泡|快速排序|归并|堆排序|bubble|quicksort|mergesort|heapsort", ...)\n  - ⚠️ **强制规则**：查询中出现的具体工具名/框架名/项目名必须直接包含在 pattern 中，不能仅依赖中文分类词\n\n**聚焦精读**：\n- 对候选文件用 read_file(offset=行号, limit=30) 精读相关段落\n- 确认内容与检索意图直接相关后，在 effective_blocks 中标记为 valid\n\n**round_summary 待办追踪（防止计划遗忘）**：\n- 每轮 round_summary 末尾必须列出**本轮未完成的待执行任务**，例如：\n  `待执行：grep scrapy|pyspider 英文关键词（本轮仅完成中文搜索）`\n  `待探索：content/en/ 子目录（本轮仅扫描了中文期数）`\n- 只要 round_summary 中存在待执行项，就不允许输出 retrieval_complete（守卫循环会自动检测并拦截）\n\n❌ 错误：第 1 轮只发 list_dir，等结果后第 2 轮再搜索 → 浪费 1 轮\n❌ 错误：找到一个相关文档就沿引用继续深入 → 单点深挖，漏掉横向分布的内容\n❌ 错误：只搜"爬虫"等中文分类词，未搜 Scrapy/pyspider 等项目英文名 → 漏掉仅出现英文名的文件\n✅ 正确：第 1 轮同时 list_dir + grep_content（中英文合并），第 2 轮基于两者结果并行 read_file 多个文件':'### 5. 内容相关性检索策略（重要）\n你的目标是找到与检索问题**直接相关**的所有内容。\n\n**首轮并行探测**（以下两步应在第 1 轮同时发起）：\n- list_dir 根目录，了解仓库结构\n- 同时用 grep_content(pattern="核心关键词", -i, files_with_matches) 快速定位候选文件\n\n**后续检索**：\n- 如果首轮发现索引/配置文件：优先 read_file 了解组织方式\n- 如果首轮 grep 已返回候选文件：直接 read_file 候选文件\n- 从多个语义侧面分别发起搜索，确保覆盖面\n\n**精读确认**：\n- 对候选文件用 read_file(offset=行号, limit=30) 精读相关段落\n- 确认内容与检索意图直接相关后，在 effective_blocks 中标记为 valid\n\n❌ 错误：第 1 轮只发 list_dir，等结果后第 2 轮再搜索 → 浪费 1 轮\n✅ 正确：第 1 轮同时 list_dir + grep_content，第 2 轮基于两者结果并行 read_file 多个文件\n\n### 5b. 依赖信号追踪（重要）\n读取代码文件后，若发现指向本仓库内**尚未探索**模块的引用，必须在本轮 `<round_summary>` 中将其列为"待探索"计划项。\n\n**依赖信号识别（语言无关）**：\n- **导入语句**：任意语言的 `import`、`include`、`require`、`use`、`#include`、`from ... import` 等，路径指向本仓库子目录/包时，视为待探索信号\n- **未定义类型/接口**：当前文件中使用了但未定义的类型、结构体、接口，说明定义在其他模块，需追踪来源\n- **注释/配置引用**：注释、配置文件、Makefile 中明确提到的模块路径或文件名，也应列为候选\n\n**追踪格式**（写入 round_summary 的待探索项）：\n- `待探索：src/tui/ 子包（terminal.go 中发现 import "github.com/xxx/tui"）`\n- `待探索：pkg/config/ 模块（main.go 中使用了未定义的 Config 类型）`\n- `待探索：lib/render.js（注释中提到渲染逻辑入口）`\n\n⚠️ round_summary 中存在"待探索"项时，守卫循环会拦截 retrieval_complete，强制继续探索。必须明确写出待探索路径及其来源依据。';if(r=r.replace('### 5. 双向追溯调用链（重要）\n找到核心实现代码后，**必须双向追溯**：\n\n**向上追溯**："谁调用了这个函数/类？"\n- **从实现向上追溯**：函数被谁调用 → 调用者被谁调起 → 启动入口 → CLI 命令 → 构建配置（Makefile 等）\n- **从问题描述向外扩展**：检索意图或 issue 中提到的关键词（如 CI、test、timeout、make target、system start）都应该主动 grep 搜索，即使它们看起来与核心功能不直接相关\n- **大胆查看相关文件**：Makefile、测试文件、CLI 命令定义、配置文件等都可能是修复所需的关键上下文\n\n**向下追溯**："这个函数把关键参数传给了谁？"\n- 当函数 A 将关键参数传给子函数 B 时，**必须 read_file 子函数 B 的实现**，确认参数的实际处理逻辑\n- 特别是：参数经过了 if/else 分支、默认值赋值、类型转换等操作后再传递的情况\n- 不能仅看调用方的代码就断言"参数传递正确"——参数可能在 callee 中被覆盖、忽略或错误处理\n- **同文件也要追溯**：即使 callee 在同一文件中，也必须 read_file 对应行范围确认其实现\n\n典型追溯链路：\n- 找到 bulk_create 中 batch_size 参数 → 搜索 batch_size 传递给 _batched_insert → read_file _batched_insert 确认 batch_size 的实际使用逻辑\n- 找到 _parse_annotation 处理类型标注 → 搜索同文件中其他处理类型标注的函数 → 发现 make_xrefs 是另一条独立路径\n- 找到 DNSHandler.swift → 搜索 "DNSHandler" 的所有调用者 → 找到 APIServer+Start.swift → 搜索 "system start" → 找到 SystemStart.swift 和 Makefile\n\n❌ 常见错误：找到函数 A 调用了函数 B 后，只看 A 的代码就断言"参数传递正确"，不去读取 B 的实现\n❌ 常见错误：找到核心实现后就停止搜索，认为"已经足够了"\n✅ 正确做法：找到调用关系后，read_file 被调用函数 B 的完整实现，特别关注 B 中对该参数的实际处理逻辑\n✅ 正确做法：找到核心实现后，继续搜索调用者、启动入口、构建脚本和相关测试，确保覆盖完整的修复链路\n\n**round_summary 待办追踪（防止计划遗忘）**：\n- 每轮 round_summary 末尾必须列出**本轮未完成的待执行任务**，例如：\n  `待执行：grep scrapy|pyspider 英文关键词（本轮仅完成中文搜索）`\n  `待探索：src/tui/ 子包（发现 import 引用但尚未读取）`\n- 只要 round_summary 中存在待执行项，就不允许输出 retrieval_complete（守卫循环会自动检测并拦截）',n),r=r.replace('### 6. 效率纪律\n- **调研充分性优先**：你作为子 agent，token 预算充裕。**优先保证调研充分性，而非追求最少轮次**。宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论\n- **不重复搜索**：记住已经搜过的文件和模式，不要对同一文件或相同关键词重复发起搜索\n- **存疑即全读**：当你认为某个文件或函数与问题相关但尚不确定具体哪几行，应直接 read_file 该函数/类的完整定义（通常 100-300 行），而非每轮微调 offset/limit 反复读取重叠的小片段。碎片化读取既浪费轮次又导致上下文割裂，无法形成完整理解。正确做法是一次性读取足够范围后在 round_summary 中完整分析\n- **读后必蒸馏**：每次 read_file 完成后，在 <effective_blocks> 的 reason 中记录关键函数名、类名、核心逻辑结论（如"renderBorder() 负责边框绘制，style 为 nil 时跳过渲染；事件循环入口在 UpdateModel()；光标状态由 Model.cursor 字段管理"）。⚠️ 禁止在 reason 中写具体行号——行号易产生幻觉导致后续决策错误；应使用函数名/结构体名/逻辑描述作为语义锚点。reason 是跨轮知识的唯一载体，fold 后仅凭 reason 判断是否需重读。较长的摘要可用 <reason id="blockId">多行内容</reason> 格式\n- **正则保持简单**：使用简单的正则表达式，避免复杂转义。如果需要搜多个变体，拆成多次简单搜索而不是用一个复杂正则\n- **先定位再阅读（严格两轮制）**：read_file 只能读取**前面轮次**已通过搜索、list_dir 或 grep_content 确认存在的文件路径。**同一轮**内不允许既调用 list_dir 又对同一目录调用 read_file——因为 list_dir 的结果要到下一轮你才能看到，本轮的 read_file 参数只能基于上一轮已确认的路径','### 6. 效率纪律（文档模式）\n- **广度优先，充分探索**：文档检索的核心挑战是覆盖面，优先扫描更多目录和文件而非深读单个文件。**找到少量答案后不要立即停止**，继续探索其他目录，确认没有遗漏的相关内容后再声明 <retrieval_complete/>\n- **所有文件类型一视同仁**：使用 list_dir 扫描目录时，对 .md 文件和 .cpp/.py/.ts 等代码文件一视同仁，都列入候选读取列表。判断是否读取的唯一依据是**文件名/内容是否与检索目标相关**，而非文件后缀\n- **不重复搜索**：记住已经搜过的文件和模式，不要对同一文件或相同关键词重复发起搜索\n- **精确读取**：对超过 100 行的文档文件，优先用 grep_content(output_mode="content", -C 3) 定位相关段落行号，然后用 read_file(offset=行号, limit=30) 精读相关段落。避免一次读取整个大文档（200+ 行）\n- **首轮抽样**：前 2 轮内必须至少 read_file 1 个目标文件（如 read_file(target_file="xxx", limit=50)），了解文件内部结构（标题格式、分段方式、内容组织）后再规划后续搜索。不要用 5 轮以上 list_dir 探索目录却从不读文件\n- **正则保持简单**：使用简单的正则表达式，避免复杂转义\n- **定位即可读取**：通过 grep_content(files_with_matches) 或 glob_path 返回的文件路径已确认存在，可在同一轮用 read_file 读取，不需要等下一轮。仍禁止猜测文件名直接 read_file\n- **全局多角度扫描（必须）**：在精读任何文件之前，先用至少 2 个不同关键词视角发起 grep_content 或 codebase_search 对整个仓库做全局搜索（如"功能名称"+"模块名"+"作者名"等不同角度）。单一关键词无法覆盖全部相关文件，多角度搜索结果合并后再选文件精读\n- **证据不足时优先扩展而非收尾**：当 effective_blocks 数量不足 10 个时，禁止输出 <retrieval_complete/>，应继续探索：(1) 换关键词搜索；(2) 探索尚未访问的子目录；(3) 检查非 .md 的知识文件（代码注释、配置说明等）'),r=r.replace('### 7. 禁止猜测文件名（最高优先级，违反则严重扣分）\n**绝对禁止**凭直觉猜测文件路径来调用 read_file。你不知道项目的文件命名规范（例如 Go 项目不一定有 key.go、action.go、types.go），猜测会导致大量 "File does not exist" 错误，严重浪费轮次。\n\n**典型错误模式**：\n- 你看到 src/ 目录存在，就猜测 src/key.go、src/action.go、src/types.go 存在 → 全部失败\n- 你在同一轮同时调用 list_dir("src/") + read_file("src/key.go") → key.go 是猜测，list_dir 还没返回结果\n\n**正确做法**：分两轮——\n- 轮次 N：用 list_dir 查看目录下实际有哪些文件，或用 glob_path/grep_content 确认文件路径\n- 轮次 N+1：基于上一轮返回的**真实文件列表**，read_file 已确认存在的文件\n\n❌ 错误示例：猜测存在 src/key.go、src/action.go、src/types.go 然后直接 read_file → 全部失败\n❌ 错误示例：同一轮 list_dir("src/") + read_file("src/key.go") → key.go 是猜测路径\n✅ 正确示例：轮次 N 调用 list_dir("src/") 看到实际文件列表，轮次 N+1 再 read_file 已确认存在的文件','### 7. 文件访问与搜索规则（文档模式）\n**禁止猜测文件名**：不要凭直觉猜测文件路径来调用 read_file 或 list_dir。\n\n**工具参数格式（严格遵守）**：\n- list_dir 的参数名是 target_directory（不是 path）：list_dir(target_directory="/data/repos/xxx")\n- read_file 的参数名是 target_file：read_file(target_file="/data/repos/xxx/file.md")\n- read_file 支持 offset 和 limit 参数：read_file(target_file="...", offset=100, limit=30)\n\n**允许同轮读取的情况**：\n- grep_content(files_with_matches) 返回的路径 → 可同轮 read_file（路径已确认存在）\n- glob_path 返回的路径 → 可同轮 read_file\n- 上一轮 list_dir 返回的文件列表中的路径 → 可同轮 read_file\n\n**仍然禁止的情况**：\n- 同一轮内 list_dir + read_file 同一目录（list_dir 结果本轮看不到）\n- 凭项目名/目录名猜测 list_dir 子路径（如看到 content/ 就猜测 content/en/001 存在）\n\n**搜索覆盖要求**：\n- 同一检索目标必须从多个词汇角度搜索，使用 grep_content 的多关键词 regex 一步扫全库：\n  grep_content(pattern="关键词1|keyword2|synonym3", glob="*.md", -i, output_mode="files_with_matches", head_limit=0)\n- **必须设置 head_limit=0**：默认截断约 20 条，在 100+ 文件仓库中会漏掉按 mtime 排序后较旧的所有文件\n- 中英文关键词都要覆盖，且项目/工具英文名必须包含在 pattern 中（不能仅搜中文分类词）\n- 持续搜索直到确信没有遗漏重要结果\n\n**两步扫描策略**（对大型仓库，候选文件 > 10 个时推荐）：\n- 第一步：grep_content(files_with_matches, head_limit=0) 获取完整候选列表\n- 第二步：对内容不确定的候选文件，用 grep_content(output_mode="content", -C 3) 预览匹配行，判断是否值得 read_file，避免读取无关文件（如反爬虫工具、英文版无关内容）\n\n**glob_path 的适用范围（严格限制）**：\n- glob_path 只适用于**不知道文件扩展名或命名规律**时探索目录结构（如 glob_path("*.md") 查看有哪些文件）\n- **禁止用 glob_path 逐页浏览文件内容**：看到 content/ 目录有文件后，应该立即用 grep_content 全库搜索关键词，而不是用 glob_path 一批一批地浏览文件列表\n- **典型错误**：调用 glob_path 10 次以上来遍历目录，却不用 grep_content 做全库关键词扫描\n- **正确做法**：1 次 list_dir 了解目录结构 + 1 次 grep_content(head_limit=0) 全库扫描 → 直接 read_file 命中文件'),r=r.replace("## 工具使用",'### 8. 并行工具调用（重要）\n如果你打算调用多个工具且它们之间没有依赖关系，必须在同一轮并行发起所有独立的工具调用。\n优先选择并行调用而非串行调用，以最大化每轮的信息获取效率。\n\n例如：需要读 3 个文件时，同一轮发 3 个 read_file 并行读取，而不是分 3 轮逐个读取。\n\n**可并行的场景**：\n- 多个 read_file（不同文件无依赖）\n- 多个 grep_content（不同关键词/模式无依赖）\n- list_dir(根目录) + grep_content("关键词", files_with_matches)（无依赖，首轮推荐）\n- grep 返回 5 个文件 → 下一轮同时 read_file 其中最相关的 3 个\n\n**必须串行的场景**（工具调用结果会影响后续参数）：\n- list_dir 探索目录 → 下一轮基于结果 read_file（有依赖）\n- read_file 确认内容 → 下一轮根据内容发起更深搜索（有依赖）\n\n每轮仅发 1 个工具调用是严重的效率浪费，在 10 轮限制下尤其致命。\n\n### 9. 大量候选文件的处理策略\n当 grep_content 或 glob_path 返回大量候选文件（>5 个）且无法确定哪些最相关时：\n1. 用 grep_content(pattern, output_mode="content", -C=3) 对候选文件做**二次内容搜索**，直接获取匹配行及上下文，一次调用覆盖所有候选文件\n2. 或用 codebase_search("更精确的语义描述") 做语义搜索缩小范围\n3. 确定最相关的 2-3 个文件后再 read_file 精读\n4. **避免**对所有候选文件逐个 read_file 的低效模式——10 轮内无法覆盖 20+ 个文件\n\n## 工具使用'),"doc"===e){r=r.replace("你是一个专注于代码检索的智能体（Retrieval Agent），由 Main Agent 委派执行检索任务。你的唯一职责是：高效、精准地从代码库中收集充分的代码证据。","你是一个专注于文档检索的智能体（Retrieval Agent），由 Main Agent 委派执行检索任务。你的唯一职责是：高效、精准地从仓库中收集与检索问题直接相关的文档证据。"),r=r.replace('#### 导航类返回 vs 代码类返回\n工具返回分为两类，标记方式不同：\n- **导航类**（grep_content files_with_matches / glob_path）：返回的是文件名列表，**不包含代码内容**。这些块一律标 invalid，reason 写"定位到关键文件：xxx、yyy，非代码块"即可。关键文件位置应记录在 round_summary 中以保持记忆。\n- **代码类**（read_file / grep_content content 模式 / codebase_search）：返回的是实际代码（codebase_search 返回带行号的代码片段）。必须**仔细阅读代码逻辑**后判断 valid/invalid，reason 中说明具体的代码逻辑分析结果。','#### 导航类返回 vs 内容类返回（文档模式）\n工具返回分为两类，标记方式不同：\n- **导航类**（grep_content files_with_matches / glob_path）：返回的是文件名列表，**不包含文档内容**。这些块标 invalid，reason 写"定位到候选文件：xxx、yyy，需下一轮 read_file 读取内容"。\n- **内容类**（read_file / grep_content content 模式）：返回的是实际文档内容。判断内容是否与检索意图相关后决定 valid/invalid。\n\n⚠️ 文档模式下，"不是代码"不是 invalid 的理由。只要内容与检索意图相关，就应标 valid。'),r=r.replace('### 1. 批判性验证\n搜到内容后，必须问自己：**"这真的是核心实现吗？"**\n- 找到"相关代码"≠ 找到"实现代码"\n- 常量定义、类型声明、测试用例往往只是**引用**，不是**实现**\n- 如果搜索结果看起来像辅助代码，要继续追踪到真正的实现','### 1. 批判性验证（文档模式）\n搜到文件后，必须问自己：**"这个文档是否直接回答了检索问题？"**\n- 找到"提及关键词的文件"≠ 找到"包含目标内容的文档"\n- 目录索引、链接列表、文件名匹配往往只是**线索**，不是**证据**\n- 如果搜索结果只是索引或导航页，要继续深入阅读实际内容'),r=r.replace("### 第二步：标记有效代码块","### 第二步：标记有效内容块（文档模式）");r+='\n\n---\n\n## doc 模式专项：完成标准与充分性评估\n\n### 9.1 什么算 valid？——通用判断原则\n\n**核心准则：内容直接回答了检索问题的某个维度，就是 valid。**\n\n文档检索面对的内容形式多样（项目列表、概念解释、API 说明、教程步骤、数据表格、架构描述、配置说明……），但 valid/invalid 的判断逻辑是统一的：\n\n**✅ valid_unfold 的条件（满足任意一条）**：\n- 内容包含检索意图要求的**具体信息**（名称、数据、定义、步骤、示例等），可直接用于回答问题\n- 内容覆盖了检索问题的一个完整子维度，后续分析需要多次引用其细节\n- 内容包含关键代码示例、数据表格、或配置片段，这些本身就是答案的一部分\n\n**✅ valid_fold 的条件**：\n- 内容与检索意图相关，但只是补充说明或上下文，不是核心答案\n- 内容覆盖了检索问题的一个子维度，但细节不需要反复查看\n\n**❌ invalid 的条件（满足任意一条）**：\n- 搜索/列目录返回的文件路径列表——路径不是内容，必须 read_file 后才能判断\n- 内容只是目录/索引/导航页，本身不包含答案，只是指向其他文档的链接\n- 内容提到了关键词，但讨论的是不同问题（关键词匹配 ≠ 内容相关）\n- 内容只是表面提及（如仅一句"参见 X 章"、"X 是重要概念"），没有实质信息\n\n**valid_unfold vs valid_fold 选择**：\n- 需要在后续轮次中引用其具体内容进行推理 → valid_unfold\n- 只需要记录"这个文件有相关内容"作为佐证 → valid_fold\n\n**通用示例（覆盖不同文档类型）**：\n- 项目推荐列表：read_file 读到包含项目名+简介的段落 → valid_unfold；read_file 只读到"## 项目列表"标题行 → invalid\n- API 文档：read_file 读到接口参数说明+返回值格式 → valid_unfold；read_file 只读到"本章介绍 API 用法" → invalid\n- 教程/指南：read_file 读到操作步骤或配置示例 → valid_unfold；read_file 只读到章节目录 → invalid\n- 概念解释：read_file 读到原理说明+机制描述 → valid_unfold；read_file 只读到"X 是一种重要技术" → invalid\n- 数据/表格：read_file 读到含具体数值的表格行 → valid_unfold；read_file 只读到表格标题行 → invalid\n\n---\n\n### 9.2 深度充分性——检索何时可以结束？\n\n**深度充分 = 检索意图的所有维度都有对应的 valid 证据，且没有靠推测填充的空白。**\n\n**第一步：拆解检索意图的维度**\n\n拿到检索问题后，先在首轮 round_summary 中明确列出需要覆盖的所有维度：\n- "找出至少 N 个 X" → 维度：X 的定义特征（用于判断是否符合条件）+ N 个符合条件的具体实例\n- "描述 Y 的结构并列出 K 种类别" → 维度：整体结构描述 + K 个具体类别（各需独立证据）\n- "解释 Z 的原理并给出示例" → 维度：原理/机制说明 + 具体代码/数据示例\n- "分别比较 A/B/C 的差异" → 维度：A 的特性、B 的特性、C 的特性（各需独立证据）\n- "汇总 N 个对象各自的 M 项指标" → 维度：N×M 个数据单元，每个都需要有文档证据\n\n**第二步：对照维度检查 valid 块的覆盖情况**\n\n每轮 round_summary 结尾必须自查：\n  "维度覆盖：[维度1]→已找到/未找到，[维度2]→已找到/未找到，…，待补充维度：[列出]"\n\n**只有所有维度都已找到对应 valid 证据时，才允许输出 retrieval_complete。**\n\n**常见的深度不足陷阱**：\n- 检索意图要求"分别"说明多个对象，只找到其中一部分就停止\n- 检索意图要求"给出示例"，但 valid 块中只有原理描述，没有代码/数据示例\n- 检索意图要求"至少 N 个"，只找到 N 个就立刻停止，没有确认这 N 个是否真的各自独立且符合条件\n- 某个维度的证据来自推测（round_summary 中写了"应该包含…"）而不是已读取的内容\n\n---\n\n### 9.3 广度充分性——多工具多角度探索才算充分\n\n**广度充分 = 用多种工具从多个角度探索后，新增发现趋于零（收益递减）。**\n\n不要依赖单一工具或单一搜索词就声明完成。以下三类工具各有覆盖盲区，必须配合使用：\n\n**工具组合策略**：\n\n| 工具 | 覆盖的角度 | 盲区 |\n|------|-----------|------|\n| list_dir | 目录结构、文件组织方式、文件名规律 | 不知道文件内容 |\n| grep_content | 精确关键词匹配、跨文件扫描 | 只能找到明确出现的词，漏掉同义表达 |\n| codebase_search | 语义相关性搜索 | 依赖嵌入向量，有时漏掉精确匹配但语义距离较远的内容 |\n| read_file | 深度阅读具体文件内容 | 只能看已知路径的文件 |\n\n**广度探索流程（推荐）**：\n1. **目录探索**（list_dir）：了解仓库整体结构，找出所有可能包含目标内容的目录和文件名规律\n2. **关键词扫描**（grep_content，多角度）：\n   - 先用核心词（中文/英文/缩写/同义词）并行扫描，获取候选文件列表\n   - 如果第一轮关键词没有覆盖所有可能的表达方式，补充其他关键词再搜一轮\n3. **语义搜索**（codebase_search）：对 grep 未能覆盖的语义角度（如行业术语的多种表达）发起语义查询\n4. **分散精读**（read_file，来自不同目录/文件）：从不同目录、不同深度的候选文件中各取样读取，确认内容分布\n\n**广度充分的判断标准（以下条件同时满足）**：\n- list_dir 已覆盖根目录和所有一级子目录，了解了仓库的文件分布结构\n- grep_content 发起了 ≥2 种不同角度的关键词搜索（如中文词 + 英文词，或主概念 + 子概念）\n- 如果仓库有语义搜索支持，codebase_search 发起了 ≥1 次针对不同语义角度的查询\n- read_file 读取的文件来自 ≥2 个不同目录（或对小型仓库，覆盖了所有候选文件）\n- 最近一轮的新搜索没有带来新的候选文件，或新候选文件读取后全为 invalid → 收益递减，可以结束\n\n**广度不足的警告信号（出现任意一条都必须继续探索）**：\n- 只用了 1 种工具（如只用 grep，未尝试 list_dir 了解目录结构或 codebase_search 覆盖语义）\n- 所有 read_file 都在同一个目录，未探索其他目录下是否有相关文档\n- grep_content 只搜了 1 个关键词，未尝试同义词、英文词或相关子概念\n- 仓库有多级目录结构，但只探索了根目录，未检查子目录中的文档\n- 轮次已过半（≥5 轮）但 read_file 的文件数 < 2'}return"doc"!==e&&"auto"!==e||(r=r.replace('  <core_read_depth status="PASS|INSUFFICIENT">\n    已 read_file 精读的文件列表（每项需有明确理由）：\n    - [文件名]：[原因]\n    callee 追溯：已追溯到叶节点 / 边界明确（[原因]）\n    [INSUFFICIENT：哪个 callee 未精读及原因]\n  </core_read_depth>','  <exploration_breadth status="PASS|INSUFFICIENT">\n    已 list_dir 探索的目录（至少 2 个层级）：\n    - [目录名]：[原因/发现]\n    已使用的搜索关键词角度（至少 2 个不同关键词）：\n    - [关键词]：[找到了什么]\n    [INSUFFICIENT：还有哪些目录/关键词未探索]\n  </exploration_breadth>'),r=r.replace('  <expected_behavior_coverage status="PASS|INSUFFICIENT|N/A">\n    （fix/understand 类查询强制填写；N/A 仅适用于纯架构探索类）\n    是否查阅了 test 文件 / 注释 / 文档以确认期望行为：[是/否]\n    [否时：必须说明为何可以在不知期望行为的情况下完成检索]\n  </expected_behavior_coverage>','  <knowledge_type_coverage status="PASS|PARTIAL">\n    除 .md 文件外，是否检查过 .py/.ts/.cpp 等代码文件中的注释/README/配置信息：[是/否]\n    是否查看过 examples/、docs/、config/ 等知识密集型目录：[是/否]\n    [PARTIAL：说明哪类文件被跳过及原因]\n  </knowledge_type_coverage>')),r}async beforeExecute(){const e=this.getStringParam("query");e||this.throwValidationError(ToolError.retrieval_agent.query_required);const t=this.getStringParam("retrieval_type");if("doc"===t||"auto"===t)this.retrievalType=t;else if(!t){const e=this.ctx.rootPath;if(e){const t=Date.now(),r=this.sampleRepoProfile(e);if(kernel.logger.info("zulu",`[retrieval_agent][repo_profile] doc=${r.docCount} code=${r.codeCount} total=${r.total} suggestion=${r.suggestion} elapsed=${Date.now()-t}ms`),"code"!==r.suggestion){const e=this.getStringParam("query")||"";"fix"===this.classifyQueryIntent(e)?kernel.logger.info("zulu",`[retrieval_agent][retrieval_type_autodetect] fix intent detected, keeping code mode (repo suggestion=${r.suggestion})`):(this.retrievalType=r.suggestion,kernel.logger.info("zulu",`[retrieval_agent][retrieval_type_autodetect] override to ${this.retrievalType}`))}}}this.agentInfo={agentName:"retrieval_agent",agentId:0,isProjectAgent:!0,agentPrompt:this.buildRetrievalPrompt(this.retrievalType),tools:RetrievalAgent.RETRIEVAL_AGENT_TOOLS};const r=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:this.agentInfo,taskInfo:{description:"Retrieval agent: search and analyze codebase",query:e},signal:this.ctx.signal});this.combinedSubtaskId=`retrieval_agent_${r}`}get subtaskId(){const e=this.combinedSubtaskId.lastIndexOf("_");return Number(this.combinedSubtaskId.slice(e+1))}async agentLoop(e){this.executor||(this.executor=new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:this.subtaskId,userTurn:this.ctx.userTurn},this.toolTurns,this.token)),await this.executor.executeStream({updatedParams:e,onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()})}toResult(e,t){kernel.logger.info("zulu",`[retrieval_agent][debug] retrieval_id=${this.combinedSubtaskId} summary=${truncateLine(e||"",2e3)}`);const r=t?.length??0,n=r>0,i=0===r?"\n<system_reminder>\n⚠️ **检索置信度：低（无有效证据块）**\n本次检索未能锁定任何有效代码块，以下分析结论为 LLM 推断，可靠性低于正常检索。\n在执行 edit_file / patch_file 前，请先用 read_file 自行定位并验证修复位置，不要直接采纳 FIX-HINT 中指定的文件路径和行号。\n</system_reminder>":"",o=n?'\n<system_reminder>\n## 检索证据使用指南\n\n上方 evidence_package 中的每条证据已包含：\n- 📄 文件绝对路径:精确行号范围（经系统自动锚定，非 LLM 猜测）\n- 完整的代码块内容\n\n**操作规则**：\n1. 证据代码块中的行号和代码内容已经过系统验证，可直接作为 patch_file 的定位依据\n2. 如果证据已覆盖修改目标区域的完整上下文，**直接基于证据代码编写 patch_file**，无需 read_file\n3. 仅在以下情况才需要 read_file：\n   - 需要查看证据未覆盖的**其他**文件或**其他**行范围\n   - 需要确认证据代码块的上下文（如函数签名、import 语句），且该上下文未在证据中提供\n4. **严禁**对证据中已包含完整代码的同一文件同一行范围重复 read_file\n\n## 证据优先级含义（N2 防止过度复制）\n\nevidence_package 中每条证据携带 UNFOLD 层级标签，含义如下：\n- **[UNFOLD-1]** / **[UNFOLD-2]**：**【核心修复目标】** —— 直接与修复目标相关的代码，需要修改的位置就在这里，请聚焦于此\n- **[UNFOLD-3]** / **[UNFOLD-4]**：**【上下文参考】** —— 仅提供架构/背景理解，**不要照搬其实现复杂度**；核心修复应以最小改动实现，而非模仿参考实现的完整结构\n\n## retrieval_agent 使用指南\n\nretrieval_agent 支持以下参数，请根据任务类型正确传参：\n\n**retrieval_type 参数（检索模式）**：\n| retrieval_type | 适用场景 | 示例 |\n|----------------|---------|------|\n| `code`（默认） | 代码缺陷修复、函数实现理解、调用链追踪 | bug 修复、代码 review |\n| `doc` | 文档型仓库内容检索，答案在 .md/.rst 等文档文件中 | README 聚合、知识库问答 |\n| `auto` | 代码和文档混合仓库，不确定答案在哪类文件 | 通用探索、架构调研 |\n\n**query 写法与检索意图（自动推断，无需额外参数）**：\nRA 根据 query 文本自动判断意图，影响标注阶段的输出质量：\n- **fix 模式**：query 以 `[FIX]` 开头，或包含 fix/bug/issue/error/patch 等关键词 → 标注阶段输出 FIX-HINT（修复目标文件和修复方向），适用于缺陷修复任务\n- **understand 模式**：其他 query → 输出功能描述和调用关系分析，适用于代码理解任务\n\n**context 参数（可选）**：传入报错堆栈、issue 描述、已知相关文件路径等背景信息，帮助 RA 缩小检索范围。\n\n**轮次参数（可选，通常不需要手动指定）**：\n- `max_rounds`：检索阶段最大轮数，默认 10；大型仓库或需要深度追踪调用链时可设为 15~20；证据不充分时系统自动翻倍扩容\n- `max_summary_rounds`：标注+总结阶段轮次预算，默认 7；检索到大量代码块时可适当提高（每轮处理约 1500 行代码）\n\n调用示例：\n- retrieval_agent(query="[FIX] ChoiceWidget 返回错误状态码", retrieval_type="code")\n- retrieval_agent(query="[UNDERSTAND] cache_clear 的调用链", context="已知入口: cache.py")\n- retrieval_agent(query="HelloGitHub 收录了哪些 Python 爬虫工具", retrieval_type="doc")\n</system_reminder>':"",s=n&&r>=2?`\n<system_reminder>\n5. **多条证据的综合使用**：本次检索返回了 ${r} 条证据。这些证据可能指向需要同时修改的多个位置（如基类+子类、调用端+被调端）。在制定修复方案前，请先通读所有证据，识别它们之间的关联关系（继承、调用、数据流），避免只采纳部分证据而遗漏互补性修改。\n</system_reminder>`:"";kernel.logger.info("zulu",`[retrieval_agent][reminder] injected=${n}, evidence_count=${r}`);const a=this.annotationHasDegradedEvidence?"\n⚠️ EVIDENCE_QUALITY=PARTIAL（标注阶段发生超时降级，部分证据未经 LLM 精细标注，可靠性降低）\n建议主 agent：(1) 对修复点不确定时，先用 read_file 读取原文核验；(2) 调用 API 前先 hasattr 检查方法是否存在；(3) 避免基于此 evidence 做大范围改动。\n":"";this.annotationHasDegradedEvidence&&kernel.logger.info("zulu","[x2][partial_warning] injected, annotationHasDegradedEvidence=true");const c=[`<retrieval_id>${this.combinedSubtaskId}</retrieval_id>`,"<evidence_package>",a+`${e}`,"</evidence_package>",i,o,s].join("\n");return this.result={output:c,metadata:{summary:e||"",evidence:t||[],unresolvedGaps:[],status:"completed"}},this.result}static parseFixHint(e){const t=e.match(/\[FIX-HINT\]\s*(.+)/i);if(!t)return;const r=t[1].trim();return r.length>200?r.substring(0,200):r}static parseAnnotationCoverageCheck(e){const t=e.match(/<annotation_coverage_check>([\s\S]*?)<\/annotation_coverage_check>/);if(!t)return null;const r=t[1],n=r.match(/<covered_files>([\s\S]*?)<\/covered_files>/),i=r.match(/<skipped_files>([\s\S]*?)<\/skipped_files>/),o=r.match(/<evidence_precision\s+status="([^"]+)">([\s\S]*?)<\/evidence_precision>/),s=r.match(/<retrieval_reason_alignment\s+status="([^"]+)">([\s\S]*?)<\/retrieval_reason_alignment>/),a=r.match(/<coverage_verdict\s+status="([^"]+)">([\s\S]*?)<\/coverage_verdict>/),c=n?.[1]?.trim()||"",l=c?c.split(",").map((e=>e.trim())).filter(Boolean):[],A=i?.[1]?.trim()||"",u=A&&"无"!==A?[A]:[],d="IMPRECISE"===(o?.[1]||"").toUpperCase().trim()?"IMPRECISE":"PASS",h=o?.[2]?.trim()||"",p=(s?.[1]||"").toUpperCase().trim();return{coveredFiles:l,skippedFiles:u,evidencePrecision:d,precisionDetail:h,retrievalReasonAlignment:"MISALIGNED"===p?"MISALIGNED":"PARTIAL"===p?"PARTIAL":"ALIGNED",alignmentDetail:s?.[2]?.trim()||"",coverageVerdict:"INCOMPLETE"===(a?.[1]||"").toUpperCase().trim()?"INCOMPLETE":"COMPLETE",verdictDetail:a?.[2]?.trim()||""}}static parseSummarySelfcheck(e){const t=e.match(/<summary_retrieval_selfcheck>([\s\S]*?)<\/summary_retrieval_selfcheck>/);if(!t)return null;const r=t[1],n=r.match(/<annotation_quality_review\s+status="([^"]+)"/),i=r.match(/<retrieval_evidence_alignment\s+status="([^"]+)"/),o=r.match(/<intent_satisfaction\s+status="([^"]+)"/),s=r.match(/<summary_verdict\s+status="([^"]+)">([\s\S]*?)<\/summary_verdict>/),a=r.match(/<type_risk\s+status="([^"]+)"/),c=r.match(/<fix_hint_4principles\s+status="([^"]+)"/),l=r.match(/<factory_completeness\s+status="([^"]+)"/),A=r.match(/<layer_verification\s+status="([^"]+)"/),u=(n?.[1]||"").toUpperCase().trim(),d=(i?.[1]||"").toUpperCase().trim(),h=(o?.[1]||"").toUpperCase().trim(),p=(s?.[1]||"").toUpperCase().trim(),g=s?.[2]||"",f=(a?.[1]||"").toUpperCase().trim(),m=(c?.[1]||"").toUpperCase().trim(),E=(l?.[1]||"").toUpperCase().trim(),C=(A?.[1]||"").toUpperCase().trim(),I=[];if("NEEDS_REANNOTATION"===p){const e=/[-•*]\s*([^\s\n→]+)\s*→\s*(.+)/g;let t;for(;null!==(t=e.exec(g));)I.push({file:t[1].trim(),reason:t[2].trim()})}return{annotationQualityReview:"GOOD"===u?"GOOD":"PARTIAL"===u?"PARTIAL":"POOR"===u?"POOR":null,retrievalEvidenceAlignment:"ALIGNED"===d?"ALIGNED":"MISALIGNED"===d?"MISALIGNED":"PARTIAL"===d?"PARTIAL":null,intentSatisfaction:"SATISFIED"===h?"SATISFIED":"PARTIAL"===h?"PARTIAL":"UNSATISFIED"===h?"UNSATISFIED":null,summaryVerdict:"APPROVED"===p?"APPROVED":"NEEDS_REANNOTATION"===p?"NEEDS_REANNOTATION":null,verdictDetail:g.trim(),reannotationTargets:I,typeRisk:"TYPE_RISK"===f?"TYPE_RISK":"NO_RISK"===f?"NO_RISK":null,fixHint4Principles:"NEEDS_REVISION"===m?"NEEDS_REVISION":"COMPLIANT"===m?"COMPLIANT":null,factoryCompleteness:"FACTORY_INCOMPLETE"===E?"FACTORY_INCOMPLETE":"FACTORY_COMPLETE"===E?"FACTORY_COMPLETE":"NOT_APPLICABLE"===E?"NOT_APPLICABLE":null,layerVerification:"LAYER_CHECK_REQUIRED"===C?"LAYER_CHECK_REQUIRED":"LAYER_CONFIRMED"===C?"LAYER_CONFIRMED":"NOT_APPLICABLE"===C?"NOT_APPLICABLE":null}}logExecutionMetrics(){const e={query_intent:this.queryIntent,total_rounds:this.roundCount,max_rounds_config:this.maxRounds,original_max_rounds:this.originalMaxRounds,rounds_expanded:this.roundsExpanded,effective_blocks_count:this.effectiveBlocksMap.size,code_blocks_count:this.codeBlockRegistry.size,trace_edges_count:this.traceEdgesMap.size,breadth_probes_count:this.breadthProbesMap.size,elapsed_ms:this.executeStartTime>0?Date.now()-this.executeStartTime:0,termination_reason:this.terminationReason};kernel.logger.info("zulu",`[retrieval_agent][metrics] ${JSON.stringify(e)}`)}classifyQueryIntent(e){const t=/^\[(?:FIX|VERIFY)\]|^【(?:修复|验证)】|\b(fix|bug|issue|error|fail|resolve|patch|repair|broken|crash|regression)\b|修复|报错|异常|问题|缺陷|崩溃/i.test(e)?"fix":"understand";return kernel.logger.info("zulu",`[fix_a][intent] query_prefix="${e.slice(0,12)}" classified=${t}`),t}sampleRepoProfile(e,t=500,r=3){const n=new Set([".md",".rst",".txt",".adoc",".wiki",".org"]),i=new Set([".ts",".js",".mjs",".cjs",".tsx",".jsx",".py",".go",".java",".c",".cpp",".cc",".h",".hpp",".rs",".rb",".php",".cs",".swift",".kt",".scala",".dart",".lua",".sh",".bash",".zsh",".ps1"]);let o=0,s=0,a=0;const c=(e,l)=>{if(l>r||a>=t)return;let A;try{A=readdirSync$1(e)}catch{return}for(const r of A){if(a>=t)break;if(r.startsWith("."))continue;const A=path__default$1.join(e,r);let u;try{u=statSync$2(A)}catch{continue}if(u.isDirectory())c(A,l+1);else{a++;const e=path__default$1.extname(r).toLowerCase();n.has(e)?o++:i.has(e)&&s++}}};c(e,0);let l;return l=(a>0?o/a:0)>=.7?"doc":(a>0?s/a:0)>=.6?"code":"auto",{docCount:o,codeCount:s,total:a,suggestion:l}}async execute(){this.token.onNotify(this.handleTokenNotification.bind(this)),this.executeStartTime=Date.now();const e=this.getStringParam("context")||"",t=this.getStringParam("query");this.queryIntent=this.classifyQueryIntent(t||""),kernel.logger.info("zulu",`[retrieval_agent][intent] classified as: ${this.queryIntent}`);const r=this.getStringParam("retrieval_type");"doc"!==r&&"auto"!==r||(this.retrievalType=r),kernel.logger.info("zulu",`[retrieval_agent][retrieval_type] type=${this.retrievalType}`);const n=this.getStringParam("max_rounds");if(n){const e=parseInt(n,10);!isNaN(e)&&e>0&&(this.maxRounds=e)}this.originalMaxRounds=this.maxRounds;const i=this.getStringParam("max_summary_rounds");if(i){const e=parseInt(i,10);!isNaN(e)&&e>0&&(this.maxSummaryRounds=e)}const o=e?`检索意图：${t}\n\n已知上下文：${e}`:t,s=o;this.initialQuery=s;const a=RetrievalAgent.extractStackTraceFiles(o);let c="";a.length>0&&(c=`\n\n【系统提取的 Stack Trace 文件】以下文件从查询中的报错/堆栈信息自动提取，建议第一轮优先 read_file：\n${a.map((e=>`- ${e}`)).join("\n")}`,kernel.logger.info("zulu",`[retrieval_agent][stack_trace] files_extracted=${a.length}, files=[${a.join(", ")}]`));const l=s+c+`\n\n【当前轮次】第 1 轮 / 共 ${this.maxRounds} 轮\n\n【首轮输出要求】在调用工具之前，你必须先输出 <round_summary> 标签，包含你对检索问题的分析、拆解和检索规划（打算搜什么、为什么这样搜、预期找到什么），然后再输出工具调用。格式示例：\n<round_summary>\n问题分析：...\n检索规划：...\n</round_summary>\n（然后输出工具调用）`,A=this.agentInfo?.agentPrompt??RetrievalAgent.RETRIEVAL_PHASE_PROMPT;kernel.logger.info("zulu",`[retrieval_agent][system_prompt] length=${A.length} retrieval_type=${this.retrievalType}\n---PROMPT_START---\n${A}\n---PROMPT_END---`),kernel.logger.info("zulu",`[retrieval_agent][initial_query] length=${s.length}\n---QUERY_START---\n${s}\n---QUERY_END---`),this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,query:l,isUserQuery:!0,subAgents:[]});try{const e=await this.token.waitForCompletion(),t=e[0]?.output?.length||0;let r=!1;t>5e4&&(r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Abnormally long output: ${t} chars (normal P95=5K). Likely LLM repetitive degeneration. retrieval_id=${this.combinedSubtaskId}`));let n=truncateLine(e[0]?.output||"",3e4);kernel.logger.info("zulu",`[retrieval_agent][debug] waitForCompletion success, retrieval_id=${this.combinedSubtaskId}, output_length=${t}`);const i=(n.match(/<effective_blocks>/g)||[]).length;if(i>1){r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Detected ${i} repeated <effective_blocks> in rawSummary (output_length=${t}), deduplicating to first occurrence`);const e=n.indexOf("</effective_blocks>");if(e>0){const t=e+19,r=n.substring(t).replace(/<effective_blocks>[\s\S]*?<\/effective_blocks>/g,"");n=n.substring(0,t)+r}}let o=0;const s={},a=2,c=4;for(;;){const e=/<retrieval_complete\s*\/?>/.test(n),t=0===this.effectiveBlocksMap.size&&!e&&this.roundCount<this.maxRounds-1,i=r,l=this.parseRoundSummary(n),A=l.length>0&&/下一步|接下来|还需要|需要进一步|然后再|待探索|待执行|待处理/.test(l),u=A&&e,d=l.length>0&&/未确认|未验证|待补充|未探索|未追踪|未读取|缺失|尚未|未能确认|需要进一步/.test(l),h=this.effectiveBlocksMap.size<("code"===this.retrievalType?3:6)&&this.roundCount<this.maxRounds-1,p=this.effectiveBlocksMap.size>0&&Array.from(this.effectiveBlocksMap.values()).every((e=>/[/\\]tests?[/\\]|[/\\]test_|_test\.[^.]+$/.test(e.file))),g=Array.from(this.traceEdgesMap.values()).filter((e=>"pending"===e.status)),f=g.length>0&&this.traceEdgesMap.size<=15,m=Array.from(this.breadthProbesMap.values()).some((e=>"needs_exploration"===e.status)),E=n.match(/<retrieval_exit_check>([\s\S]*?)<\/retrieval_exit_check>/),C=null!==E,I=E?.[1]??"",y=I.match(/<evidence_density\s+status="(\w+)"/)?.[1]??null,B=I.match(/<expected_behavior_coverage\s+status="(\w+)"/)?.[1]??null,b=I.match(/<exit_verdict\s+status="(\w+)"/)?.[1]??null,v=I.match(/<exploration_breadth\s+status="(\w+)"/)?.[1]??null,w=e&&!C,S=e&&C&&"BLOCKED"===b,_=e&&C&&"PASS"===y&&this.effectiveBlocksMap.size<2,Q=e&&C&&"N/A"===B&&"code"===this.retrievalType,D=e&&C&&("doc"===this.retrievalType||"auto"===this.retrievalType)&&"PASS"===y&&this.effectiveBlocksMap.size<6,x=e&&C&&("doc"===this.retrievalType||"auto"===this.retrievalType)&&"INSUFFICIENT"===v&&"APPROVED"===b;(D||x)&&kernel.logger.warn("zulu",`[retrieval_agent][exit_check_doc_fake] doc/auto mode round=${this.roundCount}, reason=${D?"density_fake":"breadth_contradiction"}, effectiveBlocks=${this.effectiveBlocksMap.size}, explorationBreadthStatus=${v??"N/A"}`);const k=w||S||_||Q||D||x,R=e&&!u&&(d||h||f||m||p);p&&e&&kernel.logger.info("zulu",`[x1][all_from_tests] blocked premature complete, effectiveBlocksSize=${this.effectiveBlocksMap.size}`);const T=""===n&&h;if(!((t||i||u||R||T||k)&&o<c)){o>=c&&(u||R)&&(n=n.replace(/<retrieval_complete\s*\/?>/g,""),kernel.logger.warn("zulu",`[retrieval_agent][guard] Retries exhausted but conflict persists (plan_action_conflict=${u}, premature_complete=${R}). Stripped retrieval_complete from rawSummary to continue retrieval.`));break}o++;const $=t?"format_degradation":i?"repetitive_degeneration":u?"plan_action_conflict":f?"unfinished_tracing":m?"unfinished_breadth":T?"early_exit_sparse":k?"exit_check_failed":p?"all_from_tests":"premature_complete";if(s[$]=(s[$]||0)+1,s[$]>a){kernel.logger.warn("zulu",`[retrieval_agent][guard] Per-type retry budget exhausted for ${$} (${s[$]}/${a}), skipping`);break}const N=/<(codebase_search|grep_content|search_files|read_file|list_files|run_command|extract_content_blocks|glob_path)[\s>]/.test(n);kernel.logger.warn("zulu",`[retrieval_agent][guard] Abnormal round detected (${$}): roundCount=${this.roundCount}/${this.maxRounds}, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}, hasRetrievalComplete=${e}, xmlToolCalls=${N}, hasPendingPlan=${A}, hasUnresolvedGaps=${d}, sparseEvidence=${h}, earlyExitSparse=${T}, pendingTraceEdges=${g.length}, unfinishedBreadth=${m}, exitCheckPresent=${C}, exitVerdict=${b}, evidenceDensityStatus=${y}, behaviorCoverage=${B}. Discarding current round, clean retry ${o}/${c} (${$}: ${s[$]}/${a})`);const F="format_degradation"===$&&N?`（上一轮你调用了工具但未产生有效代码块。${(()=>{try{return"工具执行成功但未找到相关内容。"}catch{return""}})()}请调整搜索策略：换关键词、用 codebase_search 语义搜索、或 list_dir 探索其他目录。）`:"format_degradation"===$?"（上一轮 LLM 响应未正确发起工具调用。请使用工具继续检索，不要输出纯文本格式的工具调用。）":"repetitive_degeneration"===$?"（上一轮 LLM 输出异常（重复退化），已被丢弃。请重新对当前搜索结果进行标注和分析。）":"early_exit_sparse"===$?`【证据不足，禁止结束】你在上一轮没有调用任何工具就结束了检索，但当前 effective_blocks 中只有 ${this.effectiveBlocksMap.size} 个 valid 块，远低于所需的 ${"code"===this.retrievalType?3:6} 个。证据严重不足时禁止输出 retrieval_complete。请立即继续检索：调用工具搜索和读取更多文件，在 effective_blocks 中标注更多 valid 块，确认证据充分后再决定是否结束。`:"plan_action_conflict"===$&&0===this.effectiveBlocksMap.size?"【严重错误】你在 effective_blocks 中没有标记任何有效块（0 个 valid），却同时在 round_summary 中写了未完成的计划并输出了 retrieval_complete。这两点都是错误的：(1) 在没有任何 valid 块的情况下禁止输出 retrieval_complete；(2) 有未完成的计划就不能声明完成。你必须：先完成计划中的所有搜索 → 用 read_file 读取候选文件内容 → 在 effective_blocks 中标记至少一个 valid_unfold 或 valid_fold → 确认有有效证据后才可输出 retrieval_complete。":"plan_action_conflict"===$?`（上一轮你在 round_summary 中写了: "${l.substring(0,200)}"，但同时输出了 retrieval_complete。这两者矛盾。请先执行上述计划中的操作，完成后再决定是否结束。）`:"exit_check_failed"===$&&w?"doc"===this.retrievalType||"auto"===this.retrievalType?"【缺少退出自检】你输出了 retrieval_complete 但未提供 <retrieval_exit_check> 自检块。必须在 retrieval_complete 之前完成五维度自检（evidence_density、exploration_breadth、knowledge_type_coverage、coverage_gaps、exit_verdict），且 exit_verdict=APPROVED 时系统才会接受 retrieval_complete。请补充自检块后重新决定是否结束。":"【缺少退出自检】你输出了 retrieval_complete 但未提供 <retrieval_exit_check> 自检块。必须在 retrieval_complete 之前完成五维度自检（evidence_density、core_read_depth、expected_behavior_coverage、coverage_gaps、exit_verdict），且 exit_verdict=APPROVED 时系统才会接受 retrieval_complete。请补充自检块后重新决定是否结束。":"exit_check_failed"===$&&S?"【自检未通过】你的 <retrieval_exit_check> 中 exit_verdict=BLOCKED，说明你自己认为检索尚未完成。请根据自检中指出的不足继续探索，完成后重新自检并更新为 APPROVED 再输出 retrieval_complete。":"exit_check_failed"===$&&_?`【自检与指标矛盾】你声明 evidence_density=PASS，但系统检测到 effective_blocks 中只有 ${this.effectiveBlocksMap.size} 个 valid 块（可信阈值为 2）。请补充更多 valid 代码块后重新自检，确保自检结论与实际证据数量一致。`:"exit_check_failed"===$&&D?`【自检与指标矛盾（广度模式）】你声明 evidence_density=PASS，但系统检测到 effective_blocks 只有 ${this.effectiveBlocksMap.size} 个 valid 块（doc/auto 模式可信阈值为 6）。请继续探索更多目录和文件，标注更多 valid 块后重新自检。`:"exit_check_failed"===$&&x?"【广度探索自评矛盾】你的 exploration_breadth=INSUFFICIENT，但 exit_verdict=APPROVED，自评存在矛盾。请先完成广度探索（多目录 list_dir + 多关键词 grep_content），确认 exploration_breadth=PASS 后再输出 exit_verdict=APPROVED。":"exit_check_failed"===$?"【期望行为覆盖缺失】检索类型为 code，但 expected_behavior_coverage=N/A，未说明期望行为来源。code 类型任务必须查阅相关 test 文件、注释或文档确认期望行为，否则不能通过自检。请查阅相关 test 文件后重新自检。":N?"all_from_tests"===$?`（当前 effective_blocks 全部来自测试文件（${this.effectiveBlocksMap.size} 个），尚未找到任何实现文件。测试文件只能辅助理解预期行为，不能作为修复证据。请继续检索实现文件（非 tests/ 目录）：用 grep_content 搜索关键词、用 list_dir 探索 src/ 或对应模块目录、用 read_file 读取实现文件内容后标注 valid_unfold/valid_fold，确保有实现文件的证据后再结束。）`:d?'（上一轮你在 round_summary 中存在未解决的深度缺口（如"未确认"、"未验证"、"待补充"等），但同时输出了 retrieval_complete。请先逐一验证这些缺口，确认所有关键假设已通过 read_file 验证后再决定是否结束。）':"（上一轮你在仅有少量有效代码块的情况下就输出了 retrieval_complete，且距离检索轮次上限还有余量。请继续深入检索，扩大搜索范围，确保证据充分后再结束。）":"【严重错误】你上一轮没有调用任何工具就直接输出了 retrieval_complete，这是绝对禁止的行为。无论你对答案有多大把握，都必须通过工具实际搜索和读取文件后才能结束。请立即执行：(1) 调用 grep_content 搜索相关关键词（支持 -i 不区分大小写），或调用 glob_path 获取候选文件列表；(2) 调用 read_file 读取最相关的候选文件内容；(3) 在 effective_blocks 中标记至少一个 valid_unfold 或 valid_fold 块；(4) 完成以上步骤后再决定是否输出 retrieval_complete。",M=this.buildRoundContext([],F),P=this.toolTurns[this.toolTurns.length-1],L=P?.rollbackMessageId;this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:[],query:M,isUserQuery:!0,rollbackMessageId:L});let O=[],U=0;for(;;){const e=this.token.waitForCompletion();try{O=await Promise.race([e,new Promise(((e,t)=>setTimeout((()=>t(new Error("clean_retry_timeout"))),RetrievalAgent.CLEAN_RETRY_TIMEOUT_MS)))]);break}catch(t){if("clean_retry_timeout"!==(t instanceof Error?t.message:String(t)))throw t;if(U++,kernel.logger.warn("zulu",`[retrieval_agent][guard] Clean retry ${o} timed out after ${RetrievalAgent.CLEAN_RETRY_TIMEOUT_MS}ms (timeout retry ${U}/${RetrievalAgent.MAX_TIMEOUT_RETRIES})`),U>=RetrievalAgent.MAX_TIMEOUT_RETRIES)throw kernel.logger.error("zulu",`[retrieval_agent][guard] Clean retry ${o}: exhausted all ${RetrievalAgent.MAX_TIMEOUT_RETRIES} timeout retries. effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`),new Error(`[clean_retry_timeout_exhausted] Guard clean retry timed out ${RetrievalAgent.MAX_TIMEOUT_RETRIES} times consecutively. RA failed to complete retrieval. Main agent should proceed with independent retrieval.`);e.catch((()=>{})),this.token.cancel(),this.token.reset(),kernel.logger.warn("zulu",`[retrieval_agent][guard] Cancelled hung agentLoop, starting timeout retry ${U}/${RetrievalAgent.MAX_TIMEOUT_RETRIES}`),this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:[],query:M,isUserQuery:!0,rollbackMessageId:L})}}const G=O[0]?.output?.length||0;n=truncateLine(O[0]?.output||"",3e4),r=!1,G>5e4&&(r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Retry output still abnormally long: ${G} chars`));const H=(n.match(/<effective_blocks>/g)||[]).length;if(H>1){r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Retry output still has ${H} repeated <effective_blocks>, deduplicating`);const e=n.indexOf("</effective_blocks>");if(e>0){const t=e+19,r=n.substring(t).replace(/<effective_blocks>[\s\S]*?<\/effective_blocks>/g,"");n=n.substring(0,t)+r}}kernel.logger.info("zulu",`[retrieval_agent][guard] Clean retry ${o} completed: output_length=${G}, degenerated=${r}`)}o>0&&kernel.logger.info("zulu",`[retrieval_agent][guard] Guard loop exited after ${o} clean retries, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`);try{if(/<retrieval_complete\s*\/?>/.test(n)){this.roundCount+=1;let e=!1,t=0;const r=this.parseRoundSummary(n);r&&(this.roundSummaries.push(r),e=!0,t=r.length);const i=this.parseEffectiveBlocks(n,this.roundCount),o=this.parseTraceEdges(n,this.roundCount);this.updateBreadthProbes();const s=this.parseBreadthStatus(n,this.roundCount);kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} round_summary_parsed=${e}, summary_length=${t}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} effective_blocks_parsed=${i.found}, added=${i.added}, removed=${i.removed}, map_total=${this.effectiveBlocksMap.size}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} final_trace_edges=${o.found}, final_breadth_status=${s.found}`)}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][debug] Failed to parse final round: ${e.message}`)}const l=this.effectiveBlocksMap.size>0;if(kernel.logger.info("zulu",`[retrieval_agent][summary] using_main_path=${l}, effective_blocks_count=${this.effectiveBlocksMap.size}`),l){const e=2;for(let t=0;t<=e;t++)try{const e=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):this.retrievalLog.join("\n")||"（无检索记录）",t=await this.buildFromEffectiveBlocksBatched();kernel.logger.info("zulu",`[retrieval_agent][summary] batches=${t.length}, maxSummaryRounds=${this.maxSummaryRounds}`);let r="";if(t.length<=1){const n=t.length>0?t[0].blocks:"（无有效代码块）",i=("code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_PROMPT).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{EFFECTIVE_BLOCKS}}",n);kernel.logger.info("zulu",`[retrieval_agent][summary] Single-round summary, effective context length=${n.length}`);const o={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};let s=0,a=!1;for(;!a;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:o,subAgents:[],query:i,isUserQuery:!0});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("single_summary_timeout"))),"code"!==this.retrievalType?RetrievalAgent.DOC_SUMMARY_TIMEOUT_MS:RetrievalAgent.PHASE_TIMEOUT_MS)))]);if(r=truncateLine(e[0]?.output||"",3e4),r.trim().length>0&&r.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&s<RetrievalAgent.MAX_RETRY_COUNT){s++,kernel.logger.warn("zulu",`[retrieval_agent][retry] single-round summary short_reply (${r.trim().length} chars), retryCount=${s}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}a=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(s<RetrievalAgent.MAX_RETRY_COUNT){s++,kernel.logger.warn("zulu",`[retrieval_agent][retry] single-round summary attempt failed: ${t.substring(0,200)}, retryCount=${s}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] single-round summary exhausted retries: ${t.substring(0,200)}`),a=!0}{const e=RetrievalAgent.parseSummarySelfcheck(r);e?("UNSATISFIED"===e.intentSatisfaction&&kernel.logger.warn("zulu","[retrieval_agent][summary_intent_unsatisfied] Path A: intent_satisfaction=UNSATISFIED"),"NEEDS_REANNOTATION"===e.summaryVerdict?kernel.logger.warn("zulu",`[retrieval_agent][summary_selfcheck_reannotation] Path A: summary_verdict=NEEDS_REANNOTATION, targets: ${e.reannotationTargets.map((e=>e.file)).join(", ")}`):kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_ok] Path A: verdict=${e.summaryVerdict??"null"}, intent=${e.intentSatisfaction??"null"}`)):kernel.logger.warn("zulu","[retrieval_agent][summary_selfcheck_missing] Path A: no summary_retrieval_selfcheck block")}}else{kernel.logger.info("zulu",`[retrieval_agent][summary] Multi-round annotation: ${t.length} annotation rounds + 1 final round`);const n=[],i=[],o=t.length,s="doc"===this.retrievalType?RetrievalAgent.DOC_ANNOTATION_PHASE_PROMPT:"auto"===this.retrievalType?RetrievalAgent.AUTO_ANNOTATION_PHASE_PROMPT:RetrievalAgent.ANNOTATION_PHASE_PROMPT,a="fix"===this.queryIntent?s+RetrievalAgent.FIX_HINT_REQUIREMENT_SEGMENT:s,c={...this.agentInfo,agentPrompt:a,tools:[]},l=Array.from(this.effectiveBlocksMap.entries()).map((([e,t],r)=>{const n=this.codeBlockRegistry.get(e),i=(n?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n");return`${r+1}. [${e}] ${t.file}:${t.startLine}-${t.endLine} — ${t.reason}\n${i}`})).join("\n");if(t.length>=3){kernel.logger.info("zulu",`[retrieval_agent][summary] Parallel annotation mode: ${t.length} batches (>= 3 threshold)`);const r=t.map(((e,t)=>`批次 ${t+1}（${e.blockCount} 个代码块，${e.totalLines} 行）:\n${e.blocks.split("\n").filter((e=>e.startsWith("[代码块]")||e.startsWith("[信息块]"))).map((e=>`  ${e}`)).join("\n")||"  (详见代码块)"}`)).join("\n\n"),s=RetrievalAgent.ANNOTATION_PLAN_PROMPT.replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BATCH_COUNT}}",String(t.length)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{BATCHES_OVERVIEW}}",r);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation planning round: prompt_length=${s.length}`);const a={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};let A,u="";for(let e=1;e<=RetrievalAgent.MAX_RETRY_COUNT+1;e++)try{this.agentLoop({taskId:this.subtaskId,agentInfo:a,subAgents:[],query:s,isUserQuery:!0});const t=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("planning_timeout"))),RetrievalAgent.PHASE_TIMEOUT_MS)))]);u=truncateLine(t[0]?.output||"",3e4);const r=this.toolTurns[this.toolTurns.length-1];if(A=r?.rollbackMessageId,kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation planning output_length=${u.length} (attempt ${e})`),u.length>0)break;if(e<=RetrievalAgent.MAX_RETRY_COUNT){kernel.logger.warn("zulu",`[retrieval_agent][retry] planning round empty output, retrying ${e}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}}catch(t){const r=t instanceof Error?t.message:String(t);if(kernel.logger.warn("zulu",`[retrieval_agent][retry] planning round attempt ${e} failed: ${r.substring(0,200)}`),e>RetrievalAgent.MAX_RETRY_COUNT)break}const d=parseAnnotationPlan(u,t.length);if(d){kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation plan parsed: ${d.batches.length} batch plans, P1_total=${d.batches.reduce(((e,t)=>e+t.priorityBudget.p1),0)}`);const r=Date.now(),s=12e4,a=3,A=(e,t)=>{const r=[],n=/\[代码块[^\]]*\]\s*(\S+):(\d+)-(\d+)\s*\(([^)]*)\)/g;let i;for(;null!==(i=n.exec(e.blocks));){const[,n,o,s,a]=i,c=e.blocks.substring(i.index+i[0].length).match(/```\n([\s\S]*?)```/),l=(c?.[1]||"").split("\n"),A=l.slice(0,5).join("\n")+(l.length>5?"\n...":"");r.push({file:n,scope:`${o}-${s}`,rawText:A,originalMatch:"",annotationRound:t,reason:`[ANNOTATION-FAILED] ${a}`})}const o=r.length>0?r.map(((e,t)=>`- EVIDENCE ${t+1} (标注失败降级): ${e.file}:${e.scope} — ${e.reason}`)).join("\n"):"- （标注失败，且未能提取代码块信息）";return{evidences:r,summary:`### 标注轮 ${t}（标注失败，已降级为粗粒度 evidence）\n${o}`,output:""}},u=async(t,r,n)=>{for(let i=1;i<=a;i++)try{const A=`UNFOLD-1: ${n.priorityBudget.p1}, UNFOLD-2: ${n.priorityBudget.p2}, UNFOLD-3: ${n.priorityBudget.p3}, UNFOLD-4: ${n.priorityBudget.p4}, FOLD: ${n.priorityBudget.fold}`,u=RetrievalAgent.PARALLEL_ANNOTATION_PROMPT.replace("{{CURRENT_ROUND}}",String(r)).replace("{{TOTAL_ROUNDS}}",String(o)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{BATCH_FOCUS}}",n.focus).replace("{{PRIORITY_BUDGET}}",A).replace("{{P1_BUDGET}}",String(n.priorityBudget.p1)).replace("{{VALID_BLOCKS_OVERVIEW}}",l).replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BLOCK_COUNT}}",String(t.blockCount)).replace("{{LINE_COUNT}}",String(t.totalLines)).replace("{{CURRENT_BLOCKS}}",t.blocks),d=i>1?` (retry ${i-1})`:"";kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${r}/${o} (parallel${d}): ${t.blockCount} blocks, ${t.totalLines} lines, prompt_length=${u.length}, focus="${n.focus.substring(0,80)}"`);const h=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:c,taskInfo:{description:`Annotation batch ${r}/${o}`,query:u},signal:this.ctx.signal});kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation batch ${r} created subtask: subtaskId=${h}`);const p=[],g=new Token(`annotation-parallel-${r}-attempt-${i}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:h,userTurn:this.ctx.userTurn},p,g).executeStream({updatedParams:{taskId:h,agentInfo:c,subAgents:[],query:u,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const f=await Promise.race([g.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error(`Annotation batch ${r} attempt ${i} timeout after ${s}ms`))),s)))]),m=truncateLine(f?.[0]?.output||"",3e4);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${r} completed (parallel${d}), output_length=${m.length}`);const E=parseEvidenceBlocks(m),C=[];for(const e of E){const t=extractReasonAfterEvidence(m,e);C.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:r,reason:t,fixHint:RetrievalAgent.parseFixHint(t)})}if("fix"===this.queryIntent){const e=C.filter((e=>/\[UNFOLD-1\]/i.test(e.reason)&&!e.fixHint));if(e.length>0&&i<a){kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_retry] round=${r} ${e.length} UNFOLD-1 evidences missing FIX-HINT, retrying`);continue}for(const t of e)t.reason+="\n[FIX-HINT] UNCERTAIN - 标注重试后仍未给出修复建议",t.fixHint="UNCERTAIN - 标注重试后仍未给出修复建议",kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_fallback] ${t.file}:${t.scope} retry exhausted, auto-filled UNCERTAIN`)}const I=E.length>0?Math.round(E.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0)/E.length):0;kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${r} (parallel${d}): evidence_count=${C.length}, avg_evidence_lines=${I}`);const y=RetrievalAgent.parseAnnotationCoverageCheck(m);if(y){kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_check] round=${r}: coverage_verdict=${y.coverageVerdict}, evidence_precision=${y.evidencePrecision}, alignment=${y.retrievalReasonAlignment}`),"MISALIGNED"===y.retrievalReasonAlignment&&kernel.logger.warn("zulu",`[retrieval_agent][annotation_reason_misaligned] round=${r}: ${y.alignmentDetail.substring(0,300)}`);const e="INCOMPLETE"===y.coverageVerdict,t="IMPRECISE"===y.evidencePrecision;if((e||t)&&i<a){kernel.logger.warn("zulu",`[retrieval_agent][${e?"isCoverageIncomplete":"isEvidenceImprecise"}] round=${r} attempt=${i}: verdict=${y.coverageVerdict} precision=${y.evidencePrecision}, retrying. detail: ${y.verdictDetail.substring(0,200)}`);continue}}else kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_missing] round=${r} attempt=${i}: no annotation_coverage_check block found`);const B=C.length>0?C.map(((e,t)=>`- EVIDENCE ${t+1}: ${e.file} scope="${e.scope}" — ${e.reason||"(无说明)"}`)).join("\n"):"- （本轮未产生有效标注）";return{evidences:C,summary:`### 标注轮 ${r}\n${B}`,output:m}}catch(e){const n=e instanceof Error?e.message:String(e);if(i<a){kernel.logger.warn("zulu",`[retrieval_agent][summary] Annotation round ${r} attempt ${i}/${a} failed: ${n.substring(0,200)}, clean retrying`);continue}return kernel.logger.warn("zulu",`[retrieval_agent][summary] Annotation round ${r} failed after ${a} attempts: ${n.substring(0,200)}, degrading to raw evidence`),this.annotationHasDegradedEvidence=!0,A(t,r)}return A(t,r)},h=t.map(((e,t)=>{const r=t+1,n=d.batches[t]||{id:r,priorityBudget:{p1:1,p2:2,p3:3,p4:2,fold:2},focus:"按检索意图标注相关代码"};return u(e,r,n)})),p=await Promise.all(h),g=Date.now()-r;let f=0;for(const e of p){for(const t of e.evidences)n.push(t),f++;i.push(e.summary)}const m=n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))),E=new Set(m.map((e=>e.file))).size;if(E>5){kernel.logger.warn("zulu",`[retrieval_agent][summary] Parallel annotation UNFOLD-1 file overflow: ${E} files > 5, degrading excess to UNFOLD-2`);const e=[];for(const t of m)e.includes(t.file)||e.push(t.file);const t=new Set(e.slice(0,5));for(const e of m)t.has(e.file)||(e.reason=e.reason.replace(/\[UNFOLD-1\]/i,"[UNFOLD-2]"))}kernel.logger.info("zulu",`[retrieval_agent][summary] Parallel annotation completed: duration=${g}ms, total_evidences=${n.length}, batches=${t.length}`)}else{kernel.logger.warn("zulu","[retrieval_agent][summary] Annotation plan parse failed, falling back to serial annotation");let r=A;const s=new Map;for(let a=0;a<t.length;a++){const l=t[a],A=a+1,u=n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))).length,d=n.filter((e=>/\[UNFOLD-2\]/i.test(e.reason))).length,h=n.filter((e=>/\[UNFOLD-3\]/i.test(e.reason))).length,p=n.filter((e=>/\[FOLD\]/i.test(e.reason))).length,g=n.length>0?`\n📊 前轮优先级统计：共 ${n.length} 条证据（UNFOLD-1: ${u}, UNFOLD-2: ${d}, UNFOLD-3: ${h}, FOLD: ${p}）。汇总阶段的展开预算有限，如果 UNFOLD-1 已较多，请将本轮中相对次要的证据标为 UNFOLD-2 或 UNFOLD-3，只将真正核心的标为 UNFOLD-1。\n`:"",f=i.length>0?`## 前轮已标注的证据摘要\n${i.join("\n")}\n${g}\n（注意：以上仅为前轮已标注证据的路径和摘要，完整代码由系统单独存储。请专注于标注下方当前批次的代码块，无需重复标注前轮内容。）\n`:"",m=new Set;for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&l.blocks.includes(`${t.startLine}-${t.endLine}`)&&m.add(e);const E=Array.from(this.effectiveBlocksMap.entries()).map((([e,t],r)=>{const n=this.codeBlockRegistry.get(e),i=(n?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n"),o=m.has(e)?" ★当前批次":"",a=s.get(e),c=a&&a.length>0?` [已标注] ${a.join(", ")}`:"";return`${r+1}. [${e}] ${t.file}:${t.startLine}-${t.endLine}${o} — ${t.reason}${c}\n${i}`})).join("\n"),C=RetrievalAgent.SUMMARY_ANNOTATION_PROMPT.replace("{{CURRENT_ROUND}}",String(A)).replace("{{TOTAL_ROUNDS}}",String(o)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{PREVIOUS_ANNOTATIONS}}",f).replace("{{VALID_BLOCKS_OVERVIEW}}",E).replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BLOCK_COUNT}}",String(l.blockCount)).replace("{{LINE_COUNT}}",String(l.totalLines)).replace("{{CURRENT_BLOCKS}}",l.blocks);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A}/${o} (serial fallback): ${l.blockCount} blocks, ${l.totalLines} lines, prompt_length=${C.length}`);let I="",y=0,B=!1;for(;!B;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:c,subAgents:[],query:C,isUserQuery:!0,rollbackMessageId:r});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error(`serial_fallback_annotation_${A}_timeout`))),RetrievalAgent.PHASE_TIMEOUT_MS)))]),t=this.toolTurns[this.toolTurns.length-1];if(r=t?.rollbackMessageId,I=truncateLine(e[0]?.output||"",3e4),I.trim().length>0&&I.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&y<RetrievalAgent.MAX_RETRY_COUNT){y++,kernel.logger.warn("zulu",`[retrieval_agent][retry] annotation round ${A} short_reply (serial fallback), retryCount=${y}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}B=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(y<RetrievalAgent.MAX_RETRY_COUNT){y++,kernel.logger.warn("zulu",`[retrieval_agent][retry] serial fallback annotation round ${A} attempt failed: ${t.substring(0,200)}, retryCount=${y}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] serial fallback annotation round ${A} exhausted retries: ${t.substring(0,200)}, using degraded evidence`),this.annotationHasDegradedEvidence=!0;for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&n.push({file:t.file,scope:`${t.startLine}-${t.endLine}`,rawText:"（标注超时，降级证据）",originalMatch:"",annotationRound:A,reason:"[ANNOTATION-TIMEOUT] 标注轮超时，此代码块未经 LLM 精细标注"});i.push(`### 标注轮 ${A}\n- （标注超时，已降级为粗粒度证据）`),B=!0}if(y>RetrievalAgent.MAX_RETRY_COUNT)continue;const b=parseEvidenceBlocks(I);for(const e of b){const t=extractReasonAfterEvidence(I,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:A,reason:t,coreSummary:e.coreSummary})}for(const e of b)for(const[t,r]of this.effectiveBlocksMap.entries())if(r.file===e.file){s.has(t)||s.set(t,[]),s.get(t).push(e.scope);break}const v=b.length>0?b.map(((e,t)=>{const r=n.length-b.length+t+1,i=extractReasonAfterEvidence(I,e);return`- EVIDENCE ${r}: ${e.file} scope="${e.scope}" — ${i||"(无说明)"}`})).join("\n"):"- （本轮未产生有效标注）";i.push(`### 标注轮 ${A}\n${v}`);const w=b.length>0?Math.round(b.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0)/b.length):0;kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A} completed (serial fallback), output_length=${I.length}, stored_evidence_count=${n.length}, evidence_count_this_round=${b.length}, avg_evidence_lines=${w}`)}}}else{let r;const s=new Map;for(let a=0;a<t.length;a++){const l=t[a],A=a+1,u=n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))).length,d=new Set(n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))).map((e=>e.file))).size,h=n.filter((e=>/\[UNFOLD-2\]/i.test(e.reason))).length,p=n.filter((e=>/\[UNFOLD-3\]/i.test(e.reason))).length,g=n.filter((e=>/\[FOLD\]/i.test(e.reason))).length,f=n.length>0?`\n📊 前轮优先级统计：共 ${n.length} 条证据（UNFOLD-1: ${u}条/${d}文件, UNFOLD-2: ${h}, UNFOLD-3: ${p}, FOLD: ${g}）。注意：UNFOLD-1 按文件级计数，同文件多条 UNFOLD-1 只占 1 个配额（上限 5 文件）。如果已覆盖较多文件，请将本轮中相对次要的证据标为 UNFOLD-2 或 UNFOLD-3。\n`:"",m=i.length>0?`## 前轮已标注的证据摘要\n${i.join("\n")}\n${f}\n（注意：以上仅为前轮已标注证据的路径和摘要，完整代码由系统单独存储。请专注于标注下方当前批次的代码块，无需重复标注前轮内容。）\n`:"",E=new Set;for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&l.blocks.includes(`${t.startLine}-${t.endLine}`)&&E.add(e);const C=Array.from(this.effectiveBlocksMap.entries()).map((([e,t],r)=>{const n=this.codeBlockRegistry.get(e),i=(n?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n"),o=E.has(e)?" ★当前批次":"",a=s.get(e),c=a&&a.length>0?` [已标注] ${a.join(", ")}`:"";return`${r+1}. [${e}] ${t.file}:${t.startLine}-${t.endLine}${o} — ${t.reason}${c}\n${i}`})).join("\n"),I=RetrievalAgent.SUMMARY_ANNOTATION_PROMPT.replace("{{CURRENT_ROUND}}",String(A)).replace("{{TOTAL_ROUNDS}}",String(o)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{PREVIOUS_ANNOTATIONS}}",m).replace("{{VALID_BLOCKS_OVERVIEW}}",C).replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BLOCK_COUNT}}",String(l.blockCount)).replace("{{LINE_COUNT}}",String(l.totalLines)).replace("{{CURRENT_BLOCKS}}",l.blocks);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A}/${o}: ${l.blockCount} blocks, ${l.totalLines} lines, prompt_length=${I.length}, rollbackId=${r||"none"}`);let y="",B=0,b=!1;for(;!b;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:c,subAgents:[],query:I,isUserQuery:!0,rollbackMessageId:r});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error(`serial_annotation_${A}_timeout`))),RetrievalAgent.PHASE_TIMEOUT_MS)))]),t=this.toolTurns[this.toolTurns.length-1];if(r=t?.rollbackMessageId,y=truncateLine(e[0]?.output||"",3e4),y.trim().length>0&&y.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&B<RetrievalAgent.MAX_RETRY_COUNT){B++,kernel.logger.warn("zulu",`[retrieval_agent][retry] annotation round ${A} short_reply detected (${y.trim().length} chars), retryCount=${B}/${RetrievalAgent.MAX_RETRY_COUNT}, re-issuing same batch`);continue}b=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(B<RetrievalAgent.MAX_RETRY_COUNT){B++,kernel.logger.warn("zulu",`[retrieval_agent][retry] serial annotation round ${A} attempt failed: ${t.substring(0,200)}, retryCount=${B}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] serial annotation round ${A} exhausted retries: ${t.substring(0,200)}, using degraded evidence`);for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&n.push({file:t.file,scope:`${t.startLine}-${t.endLine}`,rawText:"（标注超时，降级证据）",originalMatch:"",annotationRound:A,reason:"[ANNOTATION-TIMEOUT] 标注轮超时，此代码块未经 LLM 精细标注"});i.push(`### 标注轮 ${A}\n- （标注超时，已降级为粗粒度证据）`),b=!0}if(B>RetrievalAgent.MAX_RETRY_COUNT)continue;const v=parseEvidenceBlocks(y);for(const e of v){const t=extractReasonAfterEvidence(y,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:A,reason:t,fixHint:RetrievalAgent.parseFixHint(t),coreSummary:e.coreSummary})}if("fix"===this.queryIntent){const e=n.filter((e=>e.annotationRound===A&&/\[UNFOLD-1\]/i.test(e.reason)&&!e.fixHint));if(e.length>0&&B<RetrievalAgent.MAX_RETRY_COUNT){kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_retry] serial round=${A} ${e.length} UNFOLD-1 evidences missing FIX-HINT, retryCount=${B}`),B++;continue}for(const t of e)t.reason+="\n[FIX-HINT] UNCERTAIN - 标注重试后仍未给出修复建议",t.fixHint="UNCERTAIN - 标注重试后仍未给出修复建议",kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_fallback] ${t.file}:${t.scope} retry exhausted, auto-filled UNCERTAIN`)}for(const e of v)for(const[t,r]of this.effectiveBlocksMap.entries())if(r.file===e.file){s.has(t)||s.set(t,[]),s.get(t).push(e.scope);break}const w=RetrievalAgent.parseAnnotationCoverageCheck(y);w?(kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_check] serial round=${A}: coverage_verdict=${w.coverageVerdict}, evidence_precision=${w.evidencePrecision}, alignment=${w.retrievalReasonAlignment}`),"MISALIGNED"===w.retrievalReasonAlignment&&kernel.logger.warn("zulu",`[retrieval_agent][annotation_reason_misaligned] serial round=${A}: ${w.alignmentDetail.substring(0,300)}`),"INCOMPLETE"===w.coverageVerdict&&kernel.logger.warn("zulu",`[retrieval_agent][isCoverageIncomplete] serial round=${A}: ${w.verdictDetail.substring(0,200)}`),"IMPRECISE"===w.evidencePrecision&&kernel.logger.warn("zulu",`[retrieval_agent][isEvidenceImprecise] serial round=${A}: ${w.precisionDetail.substring(0,200)}`)):kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_missing] serial round=${A}: no annotation_coverage_check block found`);const S=v.length>0?v.map(((e,t)=>{const r=n.length-v.length+t+1,i=extractReasonAfterEvidence(y,e);return`- EVIDENCE ${r}: ${e.file} scope="${e.scope}" — ${i||"(无说明)"}`})).join("\n"):"- （本轮未产生有效标注）";i.push(`### 标注轮 ${A}\n${S}`);const _=v.length>0?Math.round(v.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0)/v.length):0;kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A} completed, output_length=${y.length}, stored_evidence_count=${n.length}, annotation_summary_length=${S.length}, evidence_count_this_round=${v.length}, avg_evidence_lines=${_}`)}}{const t=new Set;for(const[,e]of this.effectiveBlocksMap.entries())"unfold"===e.displayMode&&t.add(e.file);const r=new Set(n.map((e=>e.file))),o=[...t].filter((e=>!r.has(e)));if(0===o.length)kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_ok] All ${t.size} valid_unfold file(s) have EVIDENCE coverage`);else{kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_gap] ${o.length} valid_unfold file(s) missing EVIDENCE: ${o.slice(0,5).join(", ")}`);const t=[];for(const[,e]of this.effectiveBlocksMap.entries())o.includes(e.file)&&e.fullContent&&t.length<4&&t.push(`[代码块] ${e.file}:${e.startLine}-${e.endLine} (${e.reason})\n${e.fullContent.substring(0,4e3)}`);if(t.length>0){const r=3;let s=!1;for(let a=1;a<=r;a++){const l=1===a?4e3:2e3,A=1===a?12e4:6e4,u=t.map((e=>{if(1===a)return e;const t=e.indexOf("\n");return-1===t?e:e.substring(0,t+1)+e.substring(t+1,t+1+l)})),d=RetrievalAgent.ANNOTATION_PHASE_PROMPT+`\n\n## 检索过程概要\n${e}`+`\n\n## 需要补充标注的代码块（之前标注轮未产生EVIDENCE）\n\n以下文件被检索阶段标记为valid_unfold，但标注轮中未生成EVIDENCE，请仔细阅读并标注：\n\n${u.join("\n\n")}`;try{const e=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:c,taskInfo:{description:`Recovery annotation attempt=${a}/${r} for ${o.length} missing file(s): ${o.slice(0,3).join(", ")}`,query:d},signal:this.ctx.signal}),t=[],l=new Token(`annotation-recovery-${Date.now()}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:e,userTurn:this.ctx.userTurn},t,l).executeStream({updatedParams:{taskId:e,agentInfo:c,subAgents:[],query:d,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const u=await Promise.race([l.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("recovery_annotation_timeout"))),A)))]),h=truncateLine(u?.[0]?.output||"",3e4),p=parseEvidenceBlocks(h);if(p.length>0){kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_ok] Recovery annotation attempt=${a}/${r} produced ${p.length} EVIDENCE(s) for: ${o.join(", ")}`);for(const e of p){const t=extractReasonAfterEvidence(h,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:-1,reason:t,fixHint:RetrievalAgent.parseFixHint(t),coreSummary:e.coreSummary})}i.push(`### 补充标注轮（recovery attempt=${a}）\n${p.map(((e,t)=>`- EVIDENCE ${t+1}: ${e.file} scope="${e.scope}"`)).join("\n")}`),s=!0;break}kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_gap_recovery_failed] attempt=${a}/${r} produced 0 evidences for: ${o.join(", ")}`),a<r&&kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_retry] attempt=${a+1}/${r} files=${o.join(",")} reason=zero_evidence`)}catch(e){const t=String(e).includes("timeout")?"timeout":"error";kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_gap_recovery_failed] attempt=${a}/${r} exception: ${String(e).substring(0,200)}`),a<r&&kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_retry] attempt=${a+1}/${r} files=${o.join(",")} reason=${t}`)}}if(!s){const e=n.filter((e=>/\[UNFOLD/i.test(e.reason))).reduce(((e,t)=>e+t.originalMatch.length),0),t=8e3-e;for(const e of o){const i=[...this.effectiveBlocksMap.values()].filter((t=>t.file===e)),o=i.map((e=>`L${e.startLine}-${e.endLine}`)).join(", ")||"未知";if(t>500){const o=i.filter((e=>e.fullContent)).map((e=>`// ${e.file}:${e.startLine}-${e.endLine}\n${e.fullContent}`)).join("\n\n").substring(0,t),s=`[UNFOLD-4] [FALLBACK] recovery 重试 ${r} 次失败，以下为文件原始内容，主 agent 请自行理解相关性`;n.push({file:e,scope:"file",rawText:o,originalMatch:o,annotationRound:-2,reason:s,fixHint:"",coreSummary:""}),kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_fallback] file=${e} budget_mode=unfold remaining_budget=${t} rawText_length=${o.length}`)}else{const i=`[FALLBACK-UNREAD] 文件 ${e}：该文件在检索阶段被标记为关键但未完成精确标注（recovery 重试 ${r} 次失败）。主 agent 请根据检索意图自行判断该文件是否需要修改及修改方式。已知相关行号：${o}`;n.push({file:e,scope:"file",rawText:i,originalMatch:"[fallback-note]",annotationRound:-2,reason:"[FALLBACK-UNREAD] 预算不足，以 note 形式兜底",fixHint:"",coreSummary:""}),kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_fallback] file=${e} budget_mode=note remaining_budget=${t}`)}}}}}}const A=8e3,u=e=>{const t=e.match(/\[UNFOLD-(\d)\]/i);return t?parseInt(t[1],10):/\[UNFOLD\]/i.test(e)?2:0},d=n.filter((e=>u(e.reason)>0)),h=n.filter((e=>0===u(e.reason))),p=e=>/(?:^|\/)(tests?|__tests?__|spec)\//i.test(e)||/(?:^|\/)test_[\w]+\./i.test(e)||/(?:^|\/)[\w]+_test\./i.test(e);d.sort(((e,t)=>{const r=u(e.reason),n=u(t.reason);if(r!==n)return r-n;const i=p(e.file)?1:0,o=p(t.file)?1:0;return i!==o?i-o:e.originalMatch.length-t.originalMatch.length}));const g=[];let f=d.reduce(((e,t)=>e+t.originalMatch.length),0);for(;f>A&&d.length>0;){const e=d.pop();f-=e.originalMatch.length,g.push(e)}const m=f,E=d.map((e=>`${e.originalMatch}\n${e.reason}`)),C=[...h,...g].map((e=>{let t;if(e.coreSummary){const r=e.coreSummary.split("\n"),n=2e3,i=80;let o=(r.length>i?r.slice(-i):r).join("\n");if(o.length>n){o=o.slice(-n);const e=o.indexOf("\n");-1!==e&&(o=o.slice(e+1))}t=r.length>i||e.coreSummary.length>n?`...（超出预算，已从末尾截取）\n${o}`:o}else{const r=e.rawText.split("\n").filter((e=>e.trim()));t=r.length<=6?r.join("\n"):[...r.slice(0,3),"...",...r.slice(-3)].join("\n")}return`- ${e.file} scope="${e.scope}"\n  \`\`\`\n  ${t}\n  \`\`\`\n  ${e.reason}`})).join("\n\n"),I=E.length>0?E.join("\n\n"):"（无关键证据标记，所有证据以摘要形式提供）",y=C||"（无辅助证据）",B="fix"===this.queryIntent?'\n\n## 修复方向建议（仅修复类 query）\n\n在结论中，你需要：\n1. 描述问题根因和代码定位\n2. 如果证据充分（存在 UNFOLD-1 核心证据且根因明确），给出修复方向建议：\n   - 【修复目标文件】：列出需要修改的文件路径（按优先级排序）\n   - 【修复方向】：对每个目标文件，说明应该做什么修改\n   - 【修复范围约束】：明确指出不需要修改的文件，避免过度修改\n3. 如果证据不充分或根因不确定，明确声明：\n   "当前证据不足以确定修复方案，建议进一步阅读以下文件后判断：[文件列表]"':"\n\n## 理解类结论要求\n\n在结论中，你需要：\n1. 描述目标代码的功能、调用关系和关键逻辑\n2. 回答检索 query 中提出的具体问题\n3. 不需要给出修改建议";let b="";if(t.length>1){const e=new Set(n.filter((e=>/\[UNFOLD-[12]\]/i.test(e.reason))).map((e=>e.file))),t=[];let r=0;const i=8e3;for(const[,n]of this.effectiveBlocksMap.entries())if(e.has(n.file)&&n.fullContent&&"unfold"===n.displayMode){const e=`// ${n.file}:${n.startLine}-${n.endLine}\n\`\`\`\n${n.fullContent}\n\`\`\``;r+e.length<=i&&(t.push(e),r+=e.length)}t.length>0?(b="fix"===this.queryIntent?"## 核心证据原始代码（二次合成用，仅 UNFOLD-1/2 对应文件）\n\n以下为 UNFOLD-1/2 证据对应的完整原始代码（来自各标注批次，供跨批次层次推理）：\n\n"+t.join("\n\n")+"\n\n> **跨批次合成要求**：请综合各批次 FIX-HINT 中的层次分析，对比上方原始代码，判断：\n> 1. 各批次建议的修复位置是否存在层次冲突？\n> 2. 结合完整代码，哪一层实现最合适？\n> 3. 最终综合 FIX-HINT 应覆盖所有 UNFOLD-1/2 证据的统一修复指导\n":"## 核心证据原始代码（总结校验用，仅 UNFOLD-1/2 对应文件）\n\n以下为 UNFOLD-1/2 证据对应的完整原始代码，供总结时对照校验：\n\n"+t.join("\n\n")+"\n\n> **总结校验要求**：请对照上方原始代码，确保总结中引用的函数签名、数据流、调用关系与代码一致，修正标注阶段可能的偏差。\n",kernel.logger.info("zulu",`[fix_c][reinjection] injected=true intent=${this.queryIntent} blocks=${t.length} totalChars=${r}`)):(b="",kernel.logger.info("zulu","[fix_c][reinjection] injected=false reason=no_unfold12_fullContent"))}else kernel.logger.info("zulu","[fix_c][reinjection] injected=false reason=single_batch");const v=RetrievalAgent.SUMMARY_FINAL_PROMPT.replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{ANNOTATION_SUMMARIES}}",i.join("\n\n")).replace("{{CRITICAL_EVIDENCES}}",I).replace("{{UNFOLD_CODE_REINJECTION}}",b).replace("{{FOLD_EVIDENCES}}",y)+B;let w="";try{const e=2e4,t=3e5-v.length-e;if(t>1e4){const e=new Set(b.length>0?Array.from(this.effectiveBlocksMap.values()).filter((e=>"unfold"===e.displayMode&&n.some((t=>t.file===e.file&&/\[UNFOLD-[12]\]/i.test(t.reason))))).map((e=>e.file)):[]),r=Array.from(this.effectiveBlocksMap.entries()).filter((([,t])=>t.fullContent&&t.fullContent.length>0&&!e.has(t.file))).sort((([,e],[,t])=>t.round!==e.round?t.round-e.round:t.reason.length-e.reason.length)),i=[];let o=0;for(const[e,n]of r){const r=`// [${e}] ${n.file}:${n.startLine}-${n.endLine}\n// reason: ${n.reason}\n`,s=r+`\`\`\`\n${n.fullContent}\n\`\`\``,a=t-o;if(a<200)break;const c=s.length<=a?s:r+`\`\`\`\n${n.fullContent.substring(0,a-r.length-10)}\n\`\`\``;i.push(c),o+=c.length}if(i.length>0){const e=o<.9*t;w=`\n\n## 证据完整源码 ${e?`（预算充足，已完整展开全部 ${i.length} 个证据块）`:`（预算有限，已按优先级展开 ${i.length} 个证据块，共 ${o} 字符）`}\n\n> 以下为所有证据块的完整原始代码，请基于真实代码而非仅凭摘要做出修复判断。\n\n`+i.join("\n\n"),kernel.logger.info("zulu",`[fix_f_dynamic_budget] injected=${i.length} blocks, chars=${o}/${t}, full_expand=${e}`)}}else kernel.logger.info("zulu",`[fix_f_dynamic_budget] skipped, remainingBudget=${t} < 10000`)}catch(e){kernel.logger.warn("zulu",`[fix_f_dynamic_budget] error: ${e}`)}const S=w?v+w:v,_=d.filter((e=>1===u(e.reason))).length,Q=d.filter((e=>2===u(e.reason))).length,D=d.filter((e=>3===u(e.reason))).length,x=d.filter((e=>4===u(e.reason))).length,k=new Set(d.map((e=>e.file))).size,R=new Set(n.map((e=>e.file))).size,T=n.filter((e=>-2===e.annotationRound)).length;kernel.logger.info("zulu",`[retrieval_agent][summary] Final summary round, prompt_length=${S.length}, total_stored_evidences=${n.length}(${R} files), unfold_count=${E.length}(P1:${_},P2:${Q},P3:${D},P4:${x}, ${k} files), fold_count=${h.length}, degraded_count=${g.length}, unfold_chars=${m}/${A}, fallback_count=${T}`);const $={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};let N=0,F="",M=!1;for(;!M;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:$,subAgents:[],query:S,isUserQuery:!0});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("final_summary_timeout"))),"code"!==this.retrievalType?RetrievalAgent.DOC_SUMMARY_TIMEOUT_MS:RetrievalAgent.PHASE_TIMEOUT_MS)))]);if(F=truncateLine(e[0]?.output||"",3e4),F.trim().length>0&&F.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&N<RetrievalAgent.MAX_RETRY_COUNT){N++,kernel.logger.warn("zulu",`[retrieval_agent][retry] final summary short_reply (${F.trim().length} chars), retryCount=${N}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}M=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(N<RetrievalAgent.MAX_RETRY_COUNT){N++,kernel.logger.warn("zulu",`[retrieval_agent][retry] final summary attempt failed: ${t.substring(0,200)}, retryCount=${N}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] final summary exhausted retries: ${t.substring(0,200)}`),F="（总结轮超时，以下为标注轮收集的原始证据）",M=!0}const P=RetrievalAgent.parseSummarySelfcheck(F);if(P){const{intentSatisfaction:t,summaryVerdict:r,retrievalEvidenceAlignment:i,reannotationTargets:o}=P;if("MISALIGNED"===i&&kernel.logger.warn("zulu","[retrieval_agent][summary_evidence_misaligned] summary: retrieval_evidence_alignment=MISALIGNED"),"UNSATISFIED"===t&&kernel.logger.warn("zulu","[retrieval_agent][summary_intent_unsatisfied] summary: intent_satisfaction=UNSATISFIED"),"NEEDS_REANNOTATION"===r&&o.length>0){kernel.logger.warn("zulu",`[retrieval_agent][summary_selfcheck_reannotation] summary_verdict=NEEDS_REANNOTATION, re-annotating ${o.length} file(s): ${o.map((e=>e.file)).join(", ")}`);try{const t=[];for(const e of o){const r=[...this.effectiveBlocksMap.values()].find((t=>t.file.includes(e.file)||e.file.includes(t.file)));r?.fullContent&&t.push(`[代码块] ${r.file}:${r.startLine}-${r.endLine}\n重标注原因：${e.reason}\n\n${r.fullContent.substring(0,4e3)}`)}if(t.length>0){const r=RetrievalAgent.ANNOTATION_PHASE_PROMPT+`\n\n## 检索过程概要\n${e}`+`\n\n## 汇总轮要求重新标注的代码块\n以下文件经汇总阶段自检发现标注质量不足，请按给出的重标注原因重新标注：\n\n${t.join("\n\n")}`,i=12e4,s=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:c,taskInfo:{description:`Summary-triggered reannotation for ${o.length} file(s)`,query:r},signal:this.ctx.signal}),a=[],l=new Token(`annotation-reannotation-${Date.now()}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:s,userTurn:this.ctx.userTurn},a,l).executeStream({updatedParams:{taskId:s,agentInfo:c,subAgents:[],query:r,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const A=await Promise.race([l.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("reannotation_timeout"))),i)))]),u=truncateLine(A?.[0]?.output||"",3e4),d=parseEvidenceBlocks(u);if(d.length>0){kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_reannotation] Re-annotation produced ${d.length} EVIDENCE(s), adding to storedEvidences`);for(const e of d){const t=extractReasonAfterEvidence(u,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:-2,reason:t,fixHint:RetrievalAgent.parseFixHint(t),coreSummary:e.coreSummary})}}else kernel.logger.warn("zulu","[retrieval_agent][summary_selfcheck_reannotation] Re-annotation produced 0 evidences")}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][summary_selfcheck_reannotation] Re-annotation exception: ${String(e).substring(0,200)}`)}}else kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_ok] summary_verdict=${r??"null"}, intent=${t??"null"}`);const{typeRisk:s,fixHint4Principles:a,factoryCompleteness:l,layerVerification:A}=P;"TYPE_RISK"===s&&kernel.logger.warn("zulu","[retrieval_agent][summary_type_risk] TYPE_RISK detected in FIX-HINT"),"NEEDS_REVISION"===a&&kernel.logger.warn("zulu","[retrieval_agent][summary_fix_hint_violation] FIX-HINT violates 4-principles, NEEDS_REVISION"),"FACTORY_INCOMPLETE"===l&&kernel.logger.warn("zulu","[retrieval_agent][summary_factory_incomplete] Factory/base class fix may miss sibling factories"),"LAYER_CHECK_REQUIRED"===A&&kernel.logger.warn("zulu","[retrieval_agent][summary_layer_check] FIX-HINT targets call-site assignment, consider fixing at implementation layer"),kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_extended] type_risk=${s} fix_hint_4p=${a} factory=${l} layer=${A}`)}else kernel.logger.warn("zulu","[retrieval_agent][summary_selfcheck_missing] No summary_retrieval_selfcheck block found in final summary output");const L=n.length>0?n.map((e=>`${e.originalMatch}\n${e.reason}`)).join("\n\n"):"";if(r=L?`${F}\n\n## 关键证据\n\n${L}`:F,n.length>0){const e=e=>e.rawText.split("\n").filter((e=>e.trim())).length,t=n.filter((e=>/\[UNFOLD-[12]\]/i.test(e.reason))).reduce(((t,r)=>t+e(r)),0),i=n.filter((e=>/\[UNFOLD-[34]\]/i.test(e.reason))).reduce(((t,r)=>t+e(r)),0);if(t>0&&i>3*t){r+=`\n\n⚠️ **BACKGROUND_HEAVY**：背景参考证据（UNFOLD-3/4）代码量（${i} 行）超过核心修复目标（UNFOLD-1/2）代码量（${t} 行）的 3 倍。主 Agent 请注意：修复方案应聚焦于 UNFOLD-1/2 目标，不要照搬参考实现的完整结构，以最小改动实现核心修复。`,kernel.logger.warn("zulu",`[retrieval_agent][background_heavy] core_lines=${t} ref_lines=${i} ratio=${(i/t).toFixed(1)}x`)}}const O=n.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0);kernel.logger.info("zulu",`[retrieval_agent][summary] Final summary: llm_conclusion_length=${F.length}, stored_evidence_text_length=${L.length}, combined_length=${r.length}, total_evidence_count=${n.length}, total_evidence_lines=${O}`)}kernel.logger.info("zulu",`[retrieval_agent][summary] Summary phase completed, output_length=${r.length}`);const n=0===parseEvidenceBlocks(r).length?await this.synthesizeEvidence(r):r,i=await this.anchorEvidence(n);return this.terminationReason="retrieval_complete",this.logExecutionMetrics(),this.toResult(i.summary,i.evidence)}catch(r){const n=r instanceof Error?r.message:String(r);if(kernel.logger.error("zulu",`[retrieval_agent][summary_retry] Summary phase attempt ${t+1}/${e+1} failed: ${n.substring(0,300)}, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`),t>=e)return kernel.logger.warn("zulu",`[retrieval_agent][summary_fallback] All summary retries exhausted, synthesizing evidence from ${this.effectiveBlocksMap.size} effective blocks`),this.terminationReason="summary_exhausted",this.logExecutionMetrics(),this.synthesizeFromEffectiveBlocks()}}const A=await this.anchorEvidence(n);return this.terminationReason="no_effective_blocks",this.logExecutionMetrics(),this.toResult(A.summary,A.evidence)}catch(e){const t=e instanceof Error?e.message:String(e);if(kernel.logger.error("zulu",`[retrieval_agent][error] execute() top-level catch: ${t}, roundCount=${this.roundCount}, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`),this.effectiveBlocksMap.size>0)return kernel.logger.info("zulu",`[retrieval_agent][graceful_degradation] Caught "${t}" but ${this.effectiveBlocksMap.size} effective blocks available, synthesizing evidence`),this.terminationReason="unknown"===this.terminationReason?"graceful_degradation":this.terminationReason,this.logExecutionMetrics(),this.synthesizeFromEffectiveBlocks();this.terminationReason="unknown"===this.terminationReason?"error":this.terminationReason,this.logExecutionMetrics();const r=t.includes("[clean_retry_timeout_exhausted]")?"RA retrieval failed due to repeated LLM timeout (clean retry exhausted). Please proceed with independent code retrieval and analysis without relying on RA evidence.":"The retrieval task did not complete successfully.";return this.toResult(r)}}async synthesizeEvidence(e){kernel.logger.info("zulu",`[retrieval_agent][synthesize] LLM 未输出 EVIDENCE 标签，从 effectiveBlocksMap (${this.effectiveBlocksMap.size} 块) 合成`);const t=[];for(const e of Array.from(this.effectiveBlocksMap.values())){const r=this.codeBlockRegistry.get(e.blockId);if(!r?.rawOutput)try{const r=(await readFile$4(e.file,"utf-8")).split("\n"),n=Math.max(0,e.startLine-1),i=Math.min(r.length,e.endLine),o=r.slice(n,i);let s;s=o.length<=30?o.join("\n"):[...o.slice(0,2),"...",...o.slice(-2)].join("\n"),t.push(`<<<EVIDENCE file="${e.file}" scope="${e.reason}" startLine="${e.startLine}" endLine="${e.endLine}">>>\n`+s+"\n<<<END_EVIDENCE>>>")}catch{kernel.logger.warn("zulu",`[retrieval_agent][synthesize] Failed to read ${e.file}, skipping`)}}return 0===t.length?e:(kernel.logger.info("zulu",`[retrieval_agent][synthesize] 合成了 ${t.length} 个 EVIDENCE 块`),e+"\n\n## 关键证据（由系统从已标记的有效代码块自动合成）\n\n"+t.join("\n\n"))}async synthesizeFromEffectiveBlocks(){kernel.logger.info("zulu",`[retrieval_agent][summary_fallback] Synthesizing from ${this.effectiveBlocksMap.size} effective blocks`);const e=[],t=[];for(const[,r]of this.effectiveBlocksMap.entries())try{const n=(await readFile$4(r.file,"utf-8")).split("\n"),i=Math.max(0,r.startLine-1),o=Math.min(n.length,r.endLine),s=n.slice(i,o).join("\n");e.push(`📄 \`${r.file}:${r.startLine}-${r.endLine}\`\n\`\`\`\n${s}\n\`\`\`\n${r.reason}`),t.push({file:r.file,lines:`${r.startLine}-${r.endLine}`,snippet:null,relevance:"medium"})}catch{kernel.logger.warn("zulu",`[retrieval_agent][summary_fallback] Failed to read ${r.file}, skipping`)}const r=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):"（无检索记录）",n=["## 检索结论","（汇总阶段异常中断，以下为检索阶段积累的有效代码块降级输出）","","## 检索过程概要",r,"","## 降级证据",...e].join("\n");return kernel.logger.info("zulu",`[retrieval_agent][summary_fallback] Synthesized ${t.length} evidence blocks`),this.toResult(n,t)}async anchorEvidence(e){try{let t=parseEvidenceBlocks(e);if(0===t.length)return kernel.logger.info("zulu","[retrieval_agent][anchor] No EVIDENCE markers found, returning raw summary"),{summary:e,evidence:[]};kernel.logger.info("zulu",`[retrieval_agent][anchor] Found ${t.length} evidence blocks, starting line anchoring`);const r=new Map;for(const e of t)try{(await stat$i(e.file)).isDirectory()&&r.set(e.file,"路径是目录而非文件")}catch(t){"ENOENT"===t?.code&&r.set(e.file,"文件不存在")}if(r.size>0){kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] ${r.size} evidence blocks have invalid file paths: ${[...r.entries()].map((([e,t])=>`${e} (${t})`)).join(", ")}`);try{const n=t.filter((e=>r.has(e.file))),i=await this.requestAnchorCorrection(n,r);if(i.length>0){for(const o of i){const i=n.find((e=>o.scope&&e.scope&&o.scope===e.scope||o.headLines[0]&&e.headLines[0]&&o.headLines[0]===e.headLines[0]))||n.find((e=>r.has(e.file)));if(i){e=e.replace(i.originalMatch,o.originalMatch);const r=t.indexOf(i);-1!==r&&(t[r]=o),kernel.logger.info("zulu",`[retrieval_agent][anchor][self-correction] Replaced evidence: ${i.file} → ${o.file}`)}}t=parseEvidenceBlocks(e)}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] Correction failed: ${e.message}, continuing with original blocks`)}}const n=async e=>{try{return await readFile$4(e,"utf-8")}catch{return kernel.logger.warn("zulu",`[retrieval_agent][anchor] Failed to read file: ${e}`),""}},i=await anchorLineNumbers(t,n,this.fileReadTracker),o=i.map(((e,t)=>`evidence${t+1}: ${e.file}:${e.startLine}-${e.endLine} (${e.confidence}, ${e.candidates.length} candidates)`)).join("; ");kernel.logger.info("zulu",`[retrieval_agent][anchor] Results: ${o}`);const s=formatFinalReport(e,t,i),a=i.filter((e=>"low"!==e.confidence&&e.startLine>0)).map((e=>({file:e.file,lines:`${e.startLine}-${e.endLine}`,snippet:null,relevance:e.confidence})));return{summary:s,evidence:a}}catch(t){return kernel.logger.error("zulu",`[retrieval_agent][anchor] Post-processing failed: ${t.message}, returning raw summary`),{summary:e,evidence:[]}}}async requestAnchorCorrection(e,t){const r=[];for(const[,e]of this.effectiveBlocksMap.entries())e.file&&!r.includes(e.file)&&r.push(e.file);const n=e.map((e=>{const r=t.get(e.file)||"未知错误";return`${e.originalMatch}\n错误原因: ${r}`})).join("\n\n"),i=`以下 EVIDENCE 块的 file 路径无法访问，需要根据可用文件列表进行修正。\n\n【失败的 EVIDENCE 块】\n${n}\n\n【可用文件路径候选】\n${r.length>0?r.join("\n"):"（无可用文件信息）"}\n\n请仅重新输出修正后的 EVIDENCE 块（格式不变，file 属性使用正确路径），每个块之间用换行分隔。\n不需要输出其他内容。`,o={...this.agentInfo,agentPrompt:"你是一位文件路径纠错专家。根据错误信息和可用文件路径候选列表，修正 EVIDENCE 块中的 file 属性。",tools:[]},s=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:o,taskInfo:{description:"anchor-correction",query:i},signal:this.ctx.signal}),a=new Token(`anchor-correction-${Date.now()}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:s,userTurn:this.ctx.userTurn},[],a).executeStream({updatedParams:{taskId:s,agentInfo:o,subAgents:[],query:i,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const c=await Promise.race([a.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("anchor_correction_timeout"))),6e4)))]),l=truncateLine(c?.[0]?.output||"",3e4);if(kernel.logger.info("zulu",`[retrieval_agent][anchor][self-correction] LLM response length: ${l.length}`),!l)return[];const A=parseEvidenceBlocks(l),u=[];for(const e of A)try{(await stat$i(e.file)).isDirectory()?kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] Corrected path still a directory: ${e.file}`):u.push(e)}catch{kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] Corrected path still invalid: ${e.file}`)}return kernel.logger.info("zulu",`[retrieval_agent][anchor][self-correction] ${u.length}/${A.length} corrected blocks validated`),u}buildEffectiveBlocksSummary(){if(0===this.effectiveBlocksMap.size)return"（无有效代码块）";const e=[];let t=0;for(const[r,n]of this.effectiveBlocksMap.entries()){t++;const i=this.codeBlockRegistry.get(r),o=(i?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n");e.push(`${t}. [${r}] ${n.file}:${n.startLine}-${n.endLine} — ${n.reason}\n${o}`)}return e.join("\n")}async buildEffectiveBlocksContext(){if(this.effectiveBlocksMap.size>0){kernel.logger.info("zulu","[retrieval_agent][summary] using_main_path=true");const e=await this.buildFromEffectiveBlocks();return kernel.logger.info("zulu",`[retrieval_agent][summary] effective_blocks_count=${this.effectiveBlocksMap.size}, effective_context_length=${e.length}`),e}return kernel.logger.info("zulu","[retrieval_agent][summary] using_main_path=false"),this.buildFromTracker()}async buildFromEffectiveBlocks(){const e=[];let t=0;for(const r of Array.from(this.effectiveBlocksMap.values())){t++;const n=this.codeBlockRegistry.get(r.blockId);if(n?.rawOutput)e.push(`[信息块${t}] ${r.blockId} — ${r.reason}\n\`\`\`\n`+n.rawOutput+"\n```");else try{const n=(await readFile$4(r.file,"utf-8")).split("\n"),i=Math.max(0,r.startLine-1),o=Math.min(n.length,r.endLine),s=n.slice(i,o);let a;a=s.length<=1500?s.join("\n"):[...s.slice(0,30),`... (省略 ${s.length-60} 行) ...`,...s.slice(-30)].join("\n");const c=`${r.startLine}-${r.endLine}`;e.push(`[代码块${t}] ${r.file}:${c} (${r.reason})\n\`\`\`\n`+a+"\n```")}catch{const n=`${r.startLine}-${r.endLine}`;e.push(`[代码块${t}] ${r.file}:${n}\n（文件读取失败，请从对话历史中引用）`)}}return e.length>0?e.join("\n\n"):"（无有效代码块）"}async buildFromTracker(){const e=this.fileReadTracker.getAllReadFiles();if(0===e.size)return"（无已读文件记录）";const t=[];let r=0;for(const[n,i]of Array.from(e)){const e=this.mergeRanges(i);for(const i of e){const e=i.endLine-i.startLine>500?i.startLine+300:i.endLine;r++;try{const o=(await readFile$4(n,"utf-8")).split("\n"),s=Math.max(0,i.startLine-1),a=Math.min(o.length,e),c=o.slice(s,a);let l;l=c.length<=1500?c.join("\n"):[...c.slice(0,30),`... (省略 ${c.length-60} 行) ...`,...c.slice(-30)].join("\n"),t.push(`[代码块${r}] ${n}:${i.startLine}-${e}\n\`\`\`\n`+l+"\n```")}catch{t.push(`[代码块${r}] ${n}:${i.startLine}-${e}\n（文件读取失败，请从对话历史中引用）`)}}}return t.length>0?t.join("\n\n"):"（无有效代码块）"}async buildFromEffectiveBlocksBatched(){const e=1500,t=[];for(const r of Array.from(this.effectiveBlocksMap.values())){const n=this.codeBlockRegistry.get(r.blockId);if(n?.rawOutput){const e=n.rawOutput.split("\n").length,i=`[信息块] ${r.blockId} — ${r.reason}\n\`\`\`\n${n.rawOutput}\n\`\`\``;t.push({block:r,content:i,lineCount:e,registryEntry:n})}else try{const i=(await readFile$4(r.file,"utf-8")).split("\n"),o=Math.max(0,r.startLine-1),s=Math.min(i.length,r.endLine),a=i.slice(o,s),c=a.length;if(c>e)for(let i=0;i<c;i+=e){const o=Math.min(i+e,c),s=a.slice(i,o),l=r.startLine+i,A=`${l}-${r.startLine+o-1}`,u=0===i?"":" (续)",d=s.join("\n"),h=`[代码块${u}] ${r.file}:${A} (${r.reason})\n\`\`\`\n${d}\n\`\`\``;t.push({block:r,content:h,lineCount:s.length,registryEntry:n})}else{const e=`${r.startLine}-${r.endLine}`,i=a.join("\n"),o=`[代码块] ${r.file}:${e} (${r.reason})\n\`\`\`\n${i}\n\`\`\``;t.push({block:r,content:o,lineCount:c,registryEntry:n})}}catch{const e=`${r.startLine}-${r.endLine}`,n=`[代码块] ${r.file}:${e}\n（文件读取失败，请从对话历史中引用）`;t.push({block:r,content:n,lineCount:2})}}const r=new Map;for(const e of t){const t=e.block.file;r.has(t)||r.set(t,[]),r.get(t).push(e)}for(const e of r.values())e.sort(((e,t)=>e.block.startLine-t.block.startLine));const n=Array.from(r.entries()).map((([e,t])=>({filePath:e,blocks:t,totalLines:t.reduce(((e,t)=>e+t.lineCount),0)}))).sort(((e,t)=>e.totalLines-t.totalLines)),i=[];for(const e of n)i.push(...e.blocks);const o=i.reduce(((e,t)=>e+t.lineCount),0);if(o<=e){const e=i.map((e=>e.content)).join("\n\n");return[{blocks:e,totalLines:o,blockCount:i.length}]}const s=[];let a=[],c=0;const l=Math.ceil(o/e);let A=this.maxSummaryRounds;l>this.maxSummaryRounds&&l<=2*this.maxSummaryRounds?(A=2*this.maxSummaryRounds,kernel.logger.info("zulu",`[retrieval_agent][batching] expanding summary rounds from ${this.maxSummaryRounds} to ${A} (required=${l})`)):l>2*this.maxSummaryRounds&&(A=2*this.maxSummaryRounds,kernel.logger.info("zulu",`[retrieval_agent][batching] capping summary rounds at ${A}, will use Plan C for overflow (required=${l})`));const u=Math.max(1,A-1);for(const t of n)if(c+t.totalLines<=e||0===a.length)a.push(...t.blocks),c+=t.totalLines;else if(s.push({blocks:a.map((e=>e.content)).join("\n\n"),totalLines:c,blockCount:a.length}),a=[...t.blocks],c=t.totalLines,s.length>=u)break;a.length>0&&s.push({blocks:a.map((e=>e.content)).join("\n\n"),totalLines:c,blockCount:a.length});const d=s.reduce(((e,t)=>e+t.blockCount),0);if(d<i.length){const e=i.slice(d),t=[];let r=0;for(const n of e){const e=await this.truncateBlockPlanC(n.block);t.push(e),r+=Math.min(n.lineCount,60)}if(kernel.logger.info("zulu",`[retrieval_agent][batching] Plan C overflow: ${e.length} blocks truncated`),s.length>0){const n=s[s.length-1];n.blocks+="\n\n"+t.join("\n\n"),n.totalLines+=r,n.blockCount+=e.length}else s.push({blocks:t.join("\n\n"),totalLines:r,blockCount:e.length})}return kernel.logger.info("zulu",`[retrieval_agent][batching] total_blocks=${i.length} total_lines=${o} batches=${s.length} file_groups=${n.length} effectiveMaxRounds=${A}`),s}async truncateBlockPlanC(e){try{const t=(await readFile$4(e.file,"utf-8")).split("\n"),r=Math.max(0,e.startLine-1),n=Math.min(t.length,e.endLine),i=t.slice(r,n),o=i.length<=60?i.join("\n"):[...i.slice(0,30),`... (省略 ${i.length-60} 行，因轮次预算不足使用截断展示) ...`,...i.slice(-30)].join("\n"),s=`${e.startLine}-${e.endLine}`;return`[代码块·截断] ${e.file}:${s} (${e.reason})\n\`\`\`\n${o}\n\`\`\``}catch{const t=`${e.startLine}-${e.endLine}`;return`[代码块·截断] ${e.file}:${t}\n（文件读取失败）`}}mergeRanges(e){if(e.length<=1)return[...e];const t=[...e].sort(((e,t)=>e.startLine-t.startLine)),r=[t[0]];for(let e=1;e<t.length;e++){const n=r[r.length-1];t[e].startLine<=n.endLine+1?n.endLine=Math.max(n.endLine,t[e].endLine):r.push({...t[e]})}return r}truncateFullContent(e,t=8e3){if(e.length<=t)return e;const r=Math.floor(t/2);return e.substring(0,r)+"\n...(truncated)...\n"+e.substring(e.length-r)}encodeToolReturns(e,t){const r=[];let n=0;const i=()=>{if(n<26)return`R${t}-${String.fromCharCode(65+n++)}`;const e=n++;return`R${t}-${String.fromCharCode(65+Math.floor((e-26)/26))}${String.fromCharCode(65+e%26)}`},o=e=>e.length>100?e.substring(0,100)+"...":e,s=e=>e.length<=10?e.map(o).join("\n"):[...e.slice(0,3).map(o),"...",...e.slice(-3).map(o)].join("\n");for(const n of e||[]){const e=n.metadata?.tool;if(!e||"executed"!==e.toolState)continue;const o=e.name,a=n.output||"";if(!a.trim())continue;const c=r.length;try{if("read_file"===o||"extract_content_blocks"===o){const n=e.toolHandler?.params?.path||e.toolHandler?.params?.target_file||e.toolHandler?.params?.file_path||"";if(!n){kernel.logger.warn("zulu",`[retrieval_agent][encoding] ${o} missing file path`);continue}const c=[],l=[],A=/^\s*(\d+)(?:→|->)(.*)$/gm;let u;for(;null!==(u=A.exec(a));)c.push(parseInt(u[1],10)),l.push(u[2]);c.length>0&&r.push({id:i(),file:n,startLine:Math.min(...c),endLine:Math.max(...c),toolName:o,snippet:s(l),round:t,fullContent:this.truncateFullContent(l.join("\n"))})}else if("grep_content"===o||"search_files"===o){let e=!1;if(a.includes("<file>")&&/\d+(?:→|->)/.test(a)){const n=/<file>(.*?)(?:\n|$)([\s\S]*?)(?=<\/file>|<file>|$)/g;let l;for(;null!==(l=n.exec(a));){const e=l[1].trim(),n=l[2]||"";if(!e)continue;const a=[],c=[],A=/^\s*(\d+)(?:→|->)(.*)$/gm;let u;for(;null!==(u=A.exec(n));)a.push(parseInt(u[1],10)),c.push(u[2]);a.length>0&&r.push({id:i(),file:e,startLine:Math.min(...a),endLine:Math.max(...a),toolName:o,snippet:s(c),round:t,fullContent:this.truncateFullContent(c.join("\n"))})}e=r.length>c}if(!e&&a.includes("Line ")&&!/no\s+match/i.test(a)){const e=new Map;let n="";for(const t of a.split("\n")){const r=/^(\/[^:]+):\s*$/.exec(t.trim());if(r){n=r[1],e.has(n)||e.set(n,{lines:[],contents:[]});continue}const i=/^\s*Line\s+(\d+):\s*(.*)$/.exec(t);if(i&&n){const t=e.get(n);t.lines.push(parseInt(i[1],10)),t.contents.push(i[2])}}for(const[n,a]of Array.from(e))a.lines.length>0&&r.push({id:i(),file:n,startLine:Math.min(...a.lines),endLine:Math.max(...a.lines),toolName:o,snippet:s(a.contents),round:t,fullContent:this.truncateFullContent(a.contents.join("\n"))})}}else if("codebase_search"===o){const e=/\u{1F4C4}\s*`?([^`\n:]+?)(?::(\d+)[-\u2013](\d+))?`?\s*\n```[^\n]*\n([\s\S]*?)```/gu;let n;for(;null!==(n=e.exec(a));){const e=n[1].trim(),a=n[2]?parseInt(n[2],10):1,c=n[3]?parseInt(n[3],10):a,l=n[4].trim().split("\n");r.push({id:i(),file:e,startLine:a,endLine:c,toolName:o,snippet:s(l),round:t,fullContent:this.truncateFullContent(l.join("\n"))})}if(r.length===c&&a.includes("Line ")&&!/no\s+match/i.test(a)){const e=new Map;let n="";for(const t of a.split("\n")){const r=/^(\/[^:]+):\s*$/.exec(t.trim());if(r){n=r[1],e.has(n)||e.set(n,{lines:[],contents:[]});continue}const i=/^\s*Line\s+(\d+):\s*(.*)$/.exec(t);if(i&&n){const t=e.get(n);t.lines.push(parseInt(i[1],10)),t.contents.push(i[2])}}for(const[n,a]of Array.from(e))a.lines.length>0&&r.push({id:i(),file:n,startLine:Math.min(...a.lines),endLine:Math.max(...a.lines),toolName:o,snippet:s(a.contents),round:t,fullContent:this.truncateFullContent(a.contents.join("\n"))})}}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][encoding] Failed to encode ${o} output: ${e.message}`)}if(r.length===c){const e=a.trim().split("\n");r.push({id:i(),file:`[${o}]`,startLine:0,endLine:0,toolName:o,snippet:s(e),round:t,rawOutput:a.trim()})}}for(const e of r)this.codeBlockRegistry.set(e.id,e);const a=r.map((e=>`${e.id}(${e.file}:${e.startLine}-${e.endLine})`)).join(", ");return kernel.logger.info("zulu",`[retrieval_agent][encoding] round=${t} encoded=${r.length} blocks: ${a}`),r}parseEffectiveBlocks(e,t){let r=0,n=0,i=!1;const o=/<effective_blocks>([\s\S]*?)<\/effective_blocks>/g;let s;for(;null!==(s=o.exec(e));){i=!0;const e=s[1],o=new Map,a=/<reason\s+id="([^"]+)">([\s\S]*?)<\/reason>/g;let c;for(;null!==(c=a.exec(e));)o.set(c[1],c[2].trim());const l=/^-\s*block:\s*"([^"]+)"\s*\|\s*status:\s*"(valid_unfold|valid_fold|valid|invalid|remove)"(?:\s*\|\s*reason:\s*"([^"]*)")?/gm;let A;for(;null!==(A=l.exec(e));){const e=A[1],i=A[2],s=o.get(e)||A[3]||"";if("invalid"===i||"remove"===i){if(this.blockLockedAsValid.has(e)){kernel.logger.info("zulu",`[retrieval_agent][flip_guard] block=${e} locked as valid_fold, ignoring invalid declaration`);const t=this.codeBlockRegistry.get(e);t&&s&&this.invalidBlockReasons.set(e,{file:t.file,lines:`${t.startLine}-${t.endLine}`,reason:s});continue}if(this.effectiveBlocksMap.has(e)){const t=(this.blockFlipCount.get(e)??0)+1;if(this.blockFlipCount.set(e,t),t>=2){const r=this.effectiveBlocksMap.get(e);this.effectiveBlocksMap.set(e,{...r,displayMode:"fold"}),this.blockLockedAsValid.add(e),this.blockUnfoldSince.delete(e),kernel.logger.info("zulu",`[retrieval_agent][flip_guard] block=${e} flip_count=${t}, locked as valid_fold (evidence preserved)`);const n=this.codeBlockRegistry.get(e);n&&s&&this.invalidBlockReasons.set(e,{file:n.file,lines:`${n.startLine}-${n.endLine}`,reason:s});continue}this.effectiveBlocksMap.delete(e),this.blockUnfoldSince.delete(e),n++}const t=this.codeBlockRegistry.get(e);t&&s&&this.invalidBlockReasons.set(e,{file:t.file,lines:`${t.startLine}-${t.endLine}`,reason:s});continue}const a=this.codeBlockRegistry.get(e);if(!a){kernel.logger.warn("zulu",`[retrieval_agent][parse] block ID "${e}" not found in registry, skipping`);continue}if(0===a.startLine&&0===a.endLine){kernel.logger.warn("zulu",`[retrieval_agent][parse] block ID "${e}" has 0-0 line range (registry parse failure), skipping`);continue}const c="valid_unfold"===i;let l;if(c&&(l=a.fullContent,l||kernel.logger.warn("zulu",`[retrieval_agent] unfold block ${e} has no fullContent, falling back to snippet`)),this.effectiveBlocksMap.set(e,{blockId:e,file:a.file,startLine:a.startLine,endLine:a.endLine,reason:s,round:t,displayMode:c?"unfold":"fold",fullContent:l}),s){const t=a.endLine-a.startLine,r=t<100?200:t<500?400:t<1500?600:800;s.length>1.5*r?(this.reasonTooLongWarnings.set(e,{limit:r,actual:s.length}),kernel.logger.warn("zulu",`[retrieval_agent][reason_overflow] block=${e} reason=${s.length}chars > ${Math.round(1.5*r)} (1.5x softLimit=${r})`)):this.reasonTooLongWarnings.delete(e)}c?this.blockUnfoldSince.has(e)||this.blockUnfoldSince.set(e,t):this.blockUnfoldSince.delete(e),r++}}return{added:r,removed:n,found:i}}static extractStackTraceFiles(e){const t=new Set,r=[{regex:/File\s+"([^"]+\.py)",\s*line\s+\d+/g,group:1},{regex:/at\s+[\w.$]+\(([A-Za-z][\w]*\.java):(\d+)\)/g,group:1},{regex:/\s([\w/.\\-]+\.go):(\d+)/g,group:1},{regex:/\(?([^\s()]+\.(?:js|ts|jsx|tsx|mjs|cjs)):(\d+)(?::(\d+))?\)?/g,group:1},{regex:/-->\s*([\w/.\\-]+\.rs):(\d+):(\d+)/g,group:1},{regex:/([\w/.\\-]+\.(?:c|cc|cpp|cxx|h|hpp)):(\d+):(\d+)?:?\s*(?:error|warning|note)?/g,group:1},{regex:/^([\w/.\\-]+\.\w+):(\d+):(\d+):\s*(?:error|warning)/gm,group:1},{regex:/^\s+([\w/.\\-]+\.py)\s*$/gm,group:1}],n=[/site-packages/i,/node_modules/i,/vendor\//i,/\/usr\/lib/i,/\/usr\/local\/lib/i,/\.cargo\/registry/i,/\.rustup\//i,/\/go\/pkg\//i,/GOROOT/i,/python\d+\.\d+\//i,/lib\/python/i,/jre\/lib/i,/jdk.*\/lib/i,/\.gradle\//i,/\.m2\/repository/i,/<frozen\s/i,/<builtin>/i,/<anonymous>/i,/<internal\//i];for(const{regex:i,group:o}of r){let r;for(;null!==(r=i.exec(e));){const e=r[o];if(!e)continue;n.some((t=>t.test(e)))||(e.length<3||!e.includes(".")||t.add(e))}}return Array.from(t).slice(0,10)}parseTraceEdges(e,t){let r=0,n=0,i=!1;const o=/<trace_edges>([\s\S]*?)<\/trace_edges>/g;let s;for(;null!==(s=o.exec(e));){i=!0;const e=s[1],o=/^-\s*edge:\s*"new"\s*\|\s*from:\s*"([^"]+)"\s*\|\s*direction:\s*"(callee|caller|override)"\s*\|\s*target:\s*"([^"]+)"\s*\|\s*status:\s*"pending"\s*(?:\|\s*reason:\s*"([^"]*)")?/gm;let a;for(;null!==(a=o.exec(e));){this.traceEdgeCounter++;const e=`TE-${this.traceEdgeCounter}`;this.traceEdgesMap.set(e,{edgeId:e,fromBlockId:a[1],direction:a[2],targetDesc:a[3],status:"pending",reason:a[4]||"",registeredRound:t}),r++}const c=/^-\s*edge:\s*"(TE-\d+)"\s*\|\s*status:\s*"(resolved|not_applicable)"(?:\s*\|\s*resolved_block:\s*"([^"]+)")?(?:\s*\|\s*reason:\s*"([^"]*)")?/gm;let l;for(;null!==(l=c.exec(e));){const e=l[1],r=this.traceEdgesMap.get(e);r&&"pending"===r.status&&(r.status=l[2],r.resolvedBlockId=l[3]||void 0,l[4]&&(r.reason=l[4]),r.resolvedRound=t,n++)}}return{added:r,resolved:n,found:i}}updateBreadthProbes(){const e=new Map;for(const[t,r]of this.effectiveBlocksMap){const n=r.file.lastIndexOf("/"),i=n>=0?r.file.substring(0,n):".";e.has(i)||e.set(i,new Set),e.get(i).add(t)}for(const[t,r]of e)if(r.size>=2)if(this.breadthProbesMap.has(t)){this.breadthProbesMap.get(t).validBlockIds=r}else this.breadthProbeCounter++,this.breadthProbesMap.set(t,{probeId:`BP-${this.breadthProbeCounter}`,directory:t,validBlockIds:r,exploredFiles:new Set,totalFiles:[],siblingDirs:[],siblingExplored:new Set,status:"needs_exploration",reason:`目录下已有 ${r.size} 个 valid 块`,registeredRound:this.roundCount}),kernel.logger.info("zulu",`[retrieval_agent][breadth] Registered probe BP-${this.breadthProbeCounter} for dir="${t}" with ${r.size} valid blocks`)}parseBreadthStatus(e,t){let r=0,n=!1;const i=/<breadth_status>([\s\S]*?)<\/breadth_status>/g;let o;for(;null!==(o=i.exec(e));){n=!0;const e=o[1],t=/^-\s*probe:\s*"(BP-\d+)"\s*\|\s*status:\s*"(explored|not_applicable)"(?:\s*\|\s*reason:\s*"([^"]*)")?/gm;let i;for(;null!==(i=t.exec(e));){const e=i[1];for(const t of this.breadthProbesMap.values())if(t.probeId===e&&"needs_exploration"===t.status){t.status=i[2],i[3]&&(t.reason=i[3]),r++;break}}}return{updated:r,found:n}}parseRoundSummary(e){const t=/<round_summary>([\s\S]*?)<\/round_summary>/.exec(e);if(!t)return"";const r=t[1].trim();return r.length>1500?r.substring(0,1500)+"...":r}parseRoundGaps(e){if(/<round_gaps\s+status="CLEAN"\s*\/>/.test(e))return{status:"CLEAN",files:[]};const t=/<round_gaps\s+status="PENDING">([\s\S]*?)<\/round_gaps>/.exec(e);if(t){const e=[],r=t[1],n=/^\s*-\s+file:\s*"([^"]+)"/gm;let i;for(;null!==(i=n.exec(r));)e.push(i[1].trim());return{status:"PENDING",files:e}}return{status:null,files:[]}}buildToolResultsSummary(e,t){if(!e||0===e.length)return"";const r=[];for(let n=0;n<e.length;n++){const i=e[n],o=i.params?.path||i.params?.target_file||i.params?.file_path||i.params?.query||i.params?.pattern||i.params?.regex||"",s="string"==typeof o&&o.length>80?o.substring(0,80)+"...":o,a=i.success?"成功":"失败";let c="";if(i.success){const e=t.filter((e=>e.toolName===i.name));if(e.length>0){const t=e.map((e=>`[${e.id}] ${e.file}:${e.startLine}-${e.endLine}`)).join(", ");c=`→ 已编码: ${t}`}else c="→ (无编码块)"}else{c=`→ 错误: ${(i.message||"").substring(0,200)}`}r.push(`${n+1}. ${i.name}(${s}): ${a}\n   ${c}`)}let n=r.join("\n");return n.length>3e3&&(n=n.substring(0,2900)+"\n... (工具结果摘要已截断)"),n}detectAndResolveEnoent(e){const t=e.filter((e=>!e.success&&"read_file"===e.name&&/does not exist|ENOENT|no such file/i.test(e.message)));if(0===t.length)return;const r=this.ctx.rootPath;if(!r)return;const{execSync:n}=require("child_process");for(const e of t){const t=e.params?.target_file||e.params?.path||"";if(!t)continue;const i=t.split("/").pop()||"";if(!i||i.length<2)continue;if(this.pathCorrectionHints.has(t))continue;const o=new Set;try{const e=n(`find "${r}" -name "${i}" -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/vendor/*" 2>/dev/null | head -20`,{encoding:"utf-8",timeout:5e3}).trim();if(e)for(const t of e.split("\n")){const e=t.trim();e&&o.add(e)}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][enoent_autocorrect] find(exact) failed for "${i}": ${e.message}`)}if(0===o.size)try{const e=t.split("/").filter(Boolean),s=n(`find "${r}" -path "*/${e.length>=2?e.slice(-2).join("/"):i}" -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null | head -20`,{encoding:"utf-8",timeout:5e3}).trim();if(s)for(const e of s.split("\n")){const t=e.trim();t&&o.add(t)}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][enoent_autocorrect] find(suffix) failed: ${e.message}`)}const s=[...o].filter((e=>e!==t));s.length>0?(this.pathCorrectionHints.set(t,s),kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} guessed="${t}" → found ${s.length} candidates: ${s.slice(0,5).join(", ")}`)):kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} guessed="${t}" → no candidates found`)}}buildRoundContext(e,t){if(!(0!==this.roundSummaries.length||0!==this.effectiveBlocksMap.size||e&&0!==e.length||t))return"";const r=[],n=this.roundCount+1,i=this.maxRounds-n;if(r.push(`【当前轮次】第 ${n} 轮 / 共 ${this.maxRounds} 轮（剩余 ${i} 轮）`),r.push(""),this.initialQuery){const e=this.initialQuery.length>2e3?this.initialQuery.substring(0,2e3)+"...":this.initialQuery;r.push("【初始检索意图】"),r.push(e),r.push("")}if(t&&(r.push("【上一轮工具调用结果】"),r.push(t),r.push("")),r.push("【检索进度摘要】（由系统从你之前的输出中提取，请基于此继续检索）\n"),this.roundSummaries.length>0&&(r.push("## 历史轮次摘要"),this.roundSummaries.forEach(((e,t)=>{r.push(`轮次${t+1}: ${e}`)})),r.push("")),e&&e.length>0){r.push("## 本轮工具返回代码块编码"),r.push("以下是系统对本轮工具返回的编码（行号由系统精确记录，你只需引用编号选择）：");for(const t of e){r.push(`[${t.id}] ${t.file}:${t.startLine}-${t.endLine} (${t.toolName})`);for(const e of t.snippet.split("\n"))r.push(`  > ${e}`)}r.push("")}if(this.effectiveBlocksMap.size>0){const e=Array.from(this.effectiveBlocksMap.values()),t=e.filter((e=>"unfold"===e.displayMode)),n=e.filter((e=>"unfold"!==e.displayMode));if(t.length>0){const e=16e3;let n=0;const i=t.sort(((e,t)=>t.round-e.round)),o=[],s=[];for(const t of i){const r=t.fullContent?.length||0;t.fullContent&&n+r<=e?(o.push(t),n+=r):s.push(t)}r.push(`## 当前展开的有效代码块（${o.length} 个，可用 status: "valid_fold" 收起释放空间）`);const a=o.filter((e=>{const t=this.blockUnfoldSince.get(e.blockId);return void 0!==t&&this.roundCount-t>=4}));a.length>0&&r.push(`⚠️ 以下块已展开 ≥4 轮：${a.map((e=>e.blockId)).join(", ")}。若核心内容已理解，请及时 valid_fold 收起以避免注意力稀释（超过 5 轮系统将自动收起）。`);for(const e of o)r.push(`[${e.blockId}] ${e.file}:${e.startLine}-${e.endLine} — ${e.reason}`),r.push("```"),r.push(e.fullContent),r.push("```");if(s.length>0){r.push(`（以下 ${s.length} 个展开块因空间限制已自动收起，可 valid_fold 其他块后重新 valid_unfold）`);for(const e of s){const t=this.codeBlockRegistry.get(e.blockId),n=t?.snippet||"";if(r.push(`[${e.blockId}] ${e.file}:${e.startLine}-${e.endLine} — ${e.reason}`),n)for(const e of n.split("\n"))r.push(`  > ${e}`)}}r.push("")}if(n.length>0){r.push(`## 已收起的有效代码块（${n.length} 个，可用 status: "valid_unfold" 展开查看；已读文件无需重新 read_file）`);let e=0;for(const t of n){e++;const n=this.codeBlockRegistry.get(t.blockId),i=this.reasonTooLongWarnings.get(t.blockId),o=i?` ⚠️ [reason过长 ${i.actual}字符，请重写精简至≤${i.limit}字符]`:"";if(t.reason)r.push(`${e}. [${t.blockId}] ${t.file}:${t.startLine}-${t.endLine}${o}`),r.push(`   📋 ${t.reason}`);else{const i=n?.snippet||"";if(r.push(`${e}. [${t.blockId}] ${t.file}:${t.startLine}-${t.endLine} ⚠️ [未写 reason，请在本轮 <effective_blocks> 中补充关键函数名和逻辑结论]`),i){const e=i.split("\n").slice(0,3);for(const t of e)r.push(`  > ${t}`);i.split("\n").length>3&&r.push("  > ...")}}}r.push("")}if(this.foldRereadWarnings.length>0){r.push("## ⚠️ 【重读拦截提醒】"),r.push("以下文件你已读取过并已收起，本轮 read_file 被系统拦截并自动展开。请在 <effective_blocks> 中更新该块的 reason，记录关键函数名和逻辑结论（勿写行号）：");for(const e of this.foldRereadWarnings)r.push(e);r.push(""),this.foldRereadWarnings=[]}try{const e=[];for(const[t,r]of this.readFilesHistory){if(r.length<2)continue;r.length>=3&&!this.exhaustedFiles.has(t)&&(this.exhaustedFiles.add(t),kernel.logger.info("zulu",`[fix_d_repeat_exhausted] file=${t} readCount=${r.length} → exhausted`));const n=Array.from(this.effectiveBlocksMap.values()).some((e=>e.file===t||t.endsWith(e.file)||e.file.endsWith(t)));if(n&&!this.exhaustedFiles.has(t)){const n=t.split("/").slice(-2).join("/");e.push(`- \`${n}\`（已读 ${r.length} 次）`)}}if(e.length>0){r.push("## ⚠️ 【重复读文件提醒】[repeat_read_reminder]"),r.push("以下文件已读取过且 effectiveBlocksMap 中有完整内容，请勿再次 read_file：");for(const t of e)r.push(t);r.push("若需确认文件边界，请改用 run_command："),r.push("  `wc -l {path}` → 确认总行数"),r.push("  `tail -20 {path}` → 查看末尾内容"),r.push("  `head -20 {path}` → 查看开头内容"),r.push("  `cat {path}` → 小文件完整查看（< 100 行）"),r.push("⚠️ 若继续 read_file 该文件，系统将自动替换为上述命令的执行结果。"),r.push("")}}catch{}}else r.push("## 当前尚未标记有效代码块\n");if(this.modeSwitchRound>=0){const e=[".md",".rst",".txt",".adoc"],t=[];for(const[r,n]of this.invalidBlockReasons)e.some((e=>n.file.toLowerCase().endsWith(e)))&&!this.effectiveBlocksMap.has(r)&&t.push([r,n]);if(t.length>0){const e=5,n=20,i=t.slice(0,n),o=t.length<=e?"snippet":"reason";r.push("## 【模式切换重评估】以下文档块在旧证据原则下被标为 invalid，请在新的文档级证据原则下重新判断："),r.push("（你在之前轮次已读取过这些文件，可结合下列标注原因直接判断；若 ≤5 块则附有内容摘要）");for(const[e,t]of i)if(r.push(`- [${e}] ${t.file}:${t.lines} — 旧标注原因: "${t.reason}"`),"snippet"===o){const t=this.codeBlockRegistry.get(e);if(t?.snippet)for(const e of t.snippet.split("\n").slice(0,5))r.push(`  > ${e}`)}t.length>n&&r.push(`（仅展示前 ${n} 条，共 ${t.length} 条）`),r.push("如内容与检索意图直接相关，请在 <effective_blocks> 中标注为 valid_unfold 或 valid_fold。"),r.push(""),kernel.logger.info("zulu",`[RA_MODE_SWITCH_REINJECT] overlooked_doc_blocks=${t.length} injected=${i.length} mode=${o}`)}this.modeSwitchRound=-1}if(this.traceEdgesMap.size>0){const e=Array.from(this.traceEdgesMap.values()),t=e.filter((e=>"pending"===e.status)),n=e.filter((e=>"resolved"===e.status)),i=e.filter((e=>"not_applicable"===e.status));if(r.push(`## 追溯状态（${t.length} 条 pending / ${n.length} 条 resolved / ${i.length} 条 not_applicable）`),t.length>0){r.push("### ⚠️ 待完成追溯"),r.push("| 编号 | 源代码块 | 方向 | 待追溯目标 | 已挂起轮数 |"),r.push("|------|---------|------|-----------|-----------|");const e=t.sort(((e,t)=>e.registeredRound-t.registeredRound)).slice(0,10);for(const t of e){const e=this.roundCount+1-t.registeredRound;r.push(`| ${t.edgeId} | ${t.fromBlockId} | ${t.direction} | ${t.targetDesc} | ${e} 轮 |`)}t.length>10&&r.push(`（还有 ${t.length-10} 条 pending 边未展示）`),r.push(""),r.push("⚠️ 以上追溯任务尚未完成。请优先处理挂起时间最长的边，或显式在 <trace_edges> 中标记为 not_applicable 并说明原因。存在 pending 追溯边时不允许输出 <retrieval_complete/>。"),r.push("")}if(n.length>0){r.push("### ✅ 已完成追溯");for(const e of n.slice(0,8))r.push(`- ${e.edgeId}: ${e.fromBlockId} → ${e.resolvedBlockId||"?"} (${e.direction}) — ${e.reason}`);n.length>8&&r.push(`（还有 ${n.length-8} 条已完成边未展示）`),r.push("")}}const o=Array.from(this.breadthProbesMap.values()).filter((e=>"needs_exploration"===e.status));if(o.length>0){r.push(`## 📁 广度探索提醒（${o.length} 个目录待探索）`);for(const e of o){const t=[...e.validBlockIds].map((e=>{const t=this.effectiveBlocksMap.get(e);if(!t)return e;const r=t.file.lastIndexOf("/");return r>=0?t.file.substring(r+1):t.file})).join(", ");if(r.push(`### ${e.probeId}: \`${e.directory}\``),r.push(`- 已有 valid 块涉及文件: ${t}`),e.totalFiles.length>0){const t=e.totalFiles.filter((t=>!e.exploredFiles.has(t))).map((e=>{const t=e.lastIndexOf("/");return t>=0?e.substring(t+1):e}));r.push(`- 该目录共 ${e.totalFiles.length} 个源码文件，尚有 ${t.length} 个未检查: ${t.slice(0,8).join(", ")}${t.length>8?"...":""}`)}else r.push("- 该目录文件列表未获取，建议使用 glob_path 查看");if(e.siblingDirs.length>0){const t=e.siblingDirs.filter((t=>!e.siblingExplored.has(t))),n=t.map((e=>{const t=e.lastIndexOf("/");return t>=0?e.substring(t+1):e}));n.length>0&&r.push(`- 同级目录中尚未探索: ${n.slice(0,6).join(", ")}`)}r.push("- 请在 <breadth_status> 中标记为 explored（已检查完）或 not_applicable（无需扩展）并说明原因"),r.push("")}r.push("⚠️ 存在 needs_exploration 的广度探测时不允许输出 <retrieval_complete/>。"),r.push("")}if(this.failedToolPaths.size>0){r.push("## ⚠️ 【已失败路径列表（禁止重试）】"),r.push("以下路径在之前的轮次中已确认不存在，不要再次尝试：");for(const e of this.failedToolPaths)r.push(`- ${e}`);r.push("")}if(this.pathCorrectionHints.size>0){r.push("## ⚠️ 【路径纠正提示】"),r.push("以下 read_file 调用因路径不存在而失败，系统已自动查找到可能的正确路径：");for(const[e,t]of this.pathCorrectionHints)if(r.push(`- 猜测路径: \`${e}\`（不存在）`),1===t.length)r.push(`  正确路径: \`${t[0]}\``);else{r.push(`  候选路径（${t.length} 个）:`);for(const e of t.slice(0,5))r.push(`  - \`${e}\``)}r.push("请使用上述正确路径重新读取文件，不要重复使用已知错误的路径。"),r.push("")}if(this.stuckUnreadHints.length>0){r.push("## ⚠️ 【未读目标警告】"),r.push("以下文件你已连续多轮在 <round_gaps> 中标记为 PENDING 但始终未 read_file：");for(const e of this.stuckUnreadHints)r.push(e);r.push("**本轮必须优先对上述文件调用 read_file**，否则会造成证据缺口。"),r.push(""),this.stuckUnreadHints=[]}if(this.pendingReasoningWarning){const e=this.pendingReasoningWarning;r.push("## ⚠️ 【推理链一致性警告】[probe_reasoning_inconsistency]"),r.push(`- ${e.id}：你的推理描述为 "${e.claimed}"，但该 block 在标注时的记录是 "${e.actual}"，两者关键词不重叠。`),r.push("请确认你描述的内容确实来自该 block，而非混淆了其他文件。"),r.push(""),this.pendingReasoningWarning=null}if(n>=this.maxRounds&&(r.push("## ⚠️ 【轮次预算即将耗尽】"),r.push(`这是你的最后一轮工具调用（第 ${n}/${this.maxRounds} 轮）。`),r.push("请在本轮 <round_summary> 中评估当前证据的充分性："),r.push("- 如果你认为已收集到足够证据覆盖检索意图的核心问题，请输出 <retrieval_complete/>"),r.push("- 如果你认为还有重要方向未覆盖（如未追溯调用链、未读取关键文件），请在 round_summary 中明确说明缺失的方向和原因，系统将自动延长检索轮次"),r.push("")),this.expansionHint&&(r.push(this.expansionHint),r.push(""),this.expansionHint=""),"doc"===this.retrievalType||"auto"===this.retrievalType){const e=this.effectiveBlocksMap.size,t=10;if(0===e&&this.roundCount>=2)r.push(""),r.push(`⚠️ **[系统提示：证据标注缺失]** 你已完成 ${this.roundCount} 轮检索，但 effective_blocks 中仍然没有任何 valid 块。这意味着你在读取文件后没有标注证据。请检查：\n1. 你已读取的文件是否包含与检索目标相关的内容？若是，立即在 effective_blocks 中补标 valid_unfold 或 valid_fold。\n2. 如果你读取的文件确实无关，请换方向：尝试 list_dir 探索其他目录，或用 grep_content 搜索更精准的关键词。\n3. **在 effective_blocks 中标注至少 1 个 valid 块之前，禁止输出 <retrieval_complete/>。**`),r.push(""),kernel.logger.warn("zulu",`[retrieval_agent][zero_blocks_warn] doc/auto mode, round=${this.roundCount}, effectiveBlocksMap.size=0, injecting zero-blocks hint`);else if(e>0&&e<t&&this.roundCount>=2&&this.roundCount<this.maxRounds-1){const n=Array.from(this.effectiveBlocksMap.keys()).slice(0,5).join(", "),i=this.effectiveBlocksMap.size>5?"...":"";r.push(""),r.push(`📊 **[系统提示：证据数量偏少]** 当前已收集 ${e} 个 valid 块（涉及文件：${n}${i}）。距目标 ${t} 个证据还有差距，建议在结束前：\n1. 换关键词角度重新 grep_content（如换同义词、换函数名、换模块名）\n2. 探索尚未访问的子目录（用 list_dir 检查是否有遗漏目录）\n3. 检查非 .md 文件（.py/.ts/.cpp 等代码文件可能包含知识性注释和示例）`),r.push(""),kernel.logger.info("zulu",`[retrieval_agent][sparse_blocks_hint] doc/auto mode, round=${this.roundCount}, effectiveBlocksMap.size=${e}, threshold=${t}`)}}if(this.lastProbeConclusion&&(r.push(""),r.push(`## 📊 【上轮探针结论】上轮周期性探针输出：${this.lastProbeConclusion}`),r.push("如有 HYPOTHESIS_REVISED / DIRECTION_RESET，请在本轮延续执行该新方向，不要回退。"),r.push(""),this.lastProbeConclusion=""),this.roundCount%4==0&&this.roundCount>0){const e=this.consecutiveAllFailRounds>=2?`\n   ⚠️ **当前已连续 ${this.consecutiveAllFailRounds} 轮全部失败**：此时必须输出 \`DIRECTION_RESET: [新策略]\`，不允许输出 DIRECTION_OK。`:"";r.push(""),r.push("## 🔍 【周期性自检探针（每4轮触发）】"),r.push(`你已完成 ${this.roundCount} 轮检索，请在本轮 <round_summary> 末尾**额外输出以下三项判断**（必填，不可省略）：`),r.push(""),r.push("**1. 假设验证**（初始假设是否仍然成立？）"),r.push("   - `HYPOTHESIS_CONFIRMED`：最初的分析方向已被证据证实，继续当前策略"),r.push("   - `HYPOTHESIS_REVISED: [新假设描述]`：证据表明初始假设有偏差，已修正为新方向"),r.push("   - `HYPOTHESIS_UNCERTAIN`：目前证据不足以确认假设，需要进一步探索"),r.push(""),r.push("**2. 上游追溯验证**（是否已追溯数据流/调用链到根源？）"),r.push("   - `UPSTREAM_CHECKED`：已向上追溯到数据/调用的根源（定义/初始化/转换层）"),r.push("   - `UPSTREAM_MISSING: [未追溯的来源描述]`：存在尚未追溯的上游来源，需要补充"),r.push(""),r.push("**3. 方向有效性评估**（当前搜索策略是否有效？）"),r.push("   - `DIRECTION_OK`：当前搜索方向正确，继续推进"),r.push(`   - \`DIRECTION_RESET: [新策略描述]\`：当前方向效率低（如多轮未找到有效块），重新定向${e}`),r.push(""),r.push("**4. 依据 blocks 声明**（假设验证类必填）"),r.push("请按如下格式输出推理链和依据 block 列表："),r.push("```"),r.push("REASONING_CHAIN:"),r.push("- 基于 R3-A(fields/__init__.py) 中的导入语句，确认使用了 enums.py 中的 TextChoices 类"),r.push("- 由此读取 R4-B(enums.py)，发现 __str__ 当前返回 Enum 默认格式而非 .value"),r.push("BASIS_BLOCKS: [R3-A(fields/__init__.py), R4-B(enums.py)]"),r.push("```"),r.push("规则："),r.push("1. REASONING_CHAIN 每行必须说明某个 block 在推理中的具体作用，以及它如何指向下一步"),r.push("2. 每个 block 引用格式为 `block编号(文件名末段)`，必须是已标记为 valid 的块"),r.push("3. BASIS_BLOCKS 是 REASONING_CHAIN 中所有引用 block 的汇总列表"),r.push("4. 若为 HYPOTHESIS_REVISED，需额外说明哪个 block 导致了假设修正"),r.push(""),kernel.logger.info("zulu",`[retrieval_agent][periodic_probe] injected probe at round=${this.roundCount}`)}return r.push("## ⚠️ 必须输出"),r.push("- 请阅读本轮工具返回结果后，**必须先输出 <round_summary>** 记录你的思考和结论"),r.push("- ⛔ **round_summary 防幻觉规则**：禁止在 round_summary 中写具体行号、方法签名、代码片段（这些已由 effective_blocks 精确记录）。只记录：搜索策略、分析结论概括、排除方向、下一步计划"),r.push('- **必须再输出 <effective_blocks>** 对本轮每个编码块逐一做 valid_unfold/valid_fold/invalid 判断（如 block: "R3-A"），不要手写文件路径和行号'),r.push("- ⚡ **必须并行发起下一轮所有独立的工具调用**——无依赖的工具同一轮一次性全部发出，禁止每轮只发 1 个"),r.push('- 如果发现之前标记的代码块不相关，用 status: "invalid" 移除'),r.join("\n")}cancel(){this.toolTurns.forEach((e=>e.cancel()))}handleTokenNotification(e){if(kernel.logger.info("zulu",`[retrieval_agent][diag_htn] event.name=${e.name} token_match=${e.token.parent===this.token} round=${this.roundCount}`),e.token.parent===this.token){const t=e.payload;if("completed"===e.name){try{const e=(t||[]).map((e=>{const t=e.metadata?.tool;return t?`${t.name}(${t.toolState})`:"unknown"}));kernel.logger.info("zulu",`[retrieval_agent][diag_payload] round=${this.roundCount} payload_len=${t?.length??0} tools=[${e.join(", ")}]`)}catch(e){}if(t.length>0&&t.every((e=>{const t=e.metadata?.tool;return t&&"executed"!==t.toolState}))){const e=t.map((e=>{const t=e.metadata.tool;return`${t.name}:${JSON.stringify(t.toolHandler?.params||{})}`})).sort().join("|");if(e===this.lastAllFailSignature?this.consecutiveAllFailRounds++:(this.consecutiveAllFailRounds=1,this.lastAllFailSignature=e),kernel.logger.warn("zulu",`[retrieval_agent][loop_breaker] round=${this.roundCount+1} all_tools_failed=true, consecutive=${this.consecutiveAllFailRounds}/${RetrievalAgent.ALL_FAIL_LOOP_THRESHOLD}, signature=${truncateLine(e,200)}`),this.consecutiveAllFailRounds>=RetrievalAgent.ALL_FAIL_LOOP_THRESHOLD){kernel.logger.error("zulu",`[retrieval_agent][loop_breaker] BREAKING dead loop: ${this.consecutiveAllFailRounds} consecutive identical all-fail rounds detected. Forcing summary phase with current evidence.`),this.terminationReason="loop_breaker",this.roundCount+=1;const e=this.buildEffectiveBlocksSummary(),t=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):"（检索因工具调用死循环被中断，无有效检索记录）",r=("code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_PROMPT).replace("{{RETRIEVAL_SUMMARY}}",t).replace("{{EFFECTIVE_BLOCKS}}",e),n=this.toolTurns[this.toolTurns.length-1],i=n?.rollbackMessageId,o={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};return void this.agentLoop({taskId:this.subtaskId,agentInfo:o,subAgents:[],query:r,isUserQuery:!0,toolUseResults:[],rollbackMessageId:i})}}else this.consecutiveAllFailRounds=0,this.lastAllFailSignature="";const e=this.toolTurns[this.toolTurns.length-1],r=e?.toText()?.trim()||"";if(r.length>0&&r.length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&this.retryCount<RetrievalAgent.MAX_RETRY_COUNT){this.retryCount++,kernel.logger.warn("zulu",`[retrieval_agent][retry] round=${this.roundCount+1} short_reply detected (${r.length} chars < ${RetrievalAgent.MIN_VALID_OUTPUT_LENGTH}), retryCount=${this.retryCount}/${RetrievalAgent.MAX_RETRY_COUNT}, re-issuing same round`);let n=[];try{n=this.encodeToolReturns(t,this.roundCount+1)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][retry] Failed to encode tool returns: ${e.message}`)}const i=t?.map((e=>{const t=e.metadata.tool,r="executed"===t.toolState,i=t.name;let o=e.output||"";if(r&&o.length>200){const e=n.filter((e=>e.toolName===i));if(e.length>0){const t=e.map((e=>`[${e.id}] ${e.file}:${e.startLine}-${e.endLine}`)).join("\n");o=`[系统已编码为以下代码块，详见检索进度摘要]\n${t}`}else o=o.substring(0,200)+"... (已压缩)"}return{id:t.toolId,name:t.name,success:r,params:t.toolHandler.params,result:r?o:null,message:o}})),o=this.buildToolResultsSummary(i||[],n),s=this.buildRoundContext(n,o),a=e?.rollbackMessageId;return void this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:[],query:s,isUserQuery:!0,rollbackMessageId:a})}this.retryCount=0,this.roundCount+=1;try{const e=[];for(const[t,r]of this.effectiveBlocksMap)if("unfold"===r.displayMode){const n=this.blockUnfoldSince.get(t)??r.round;this.roundCount-n>=5&&(this.effectiveBlocksMap.set(t,{...r,displayMode:"fold"}),this.blockUnfoldSince.delete(t),e.push(t))}e.length>0&&kernel.logger.info("zulu",`[retrieval_agent][auto_fold] round=${this.roundCount} auto_folded=${e.join(", ")}`)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][auto_fold] failed: ${e.message}`)}try{const e=(t||[]).map((e=>{const t=e.metadata?.tool;return t?{name:t.name,state:t.toolState,outputPreview:truncateLine(e.output||"",120)}:{name:"unknown",state:"unknown",outputPreview:truncateLine(e.output||"",120)}}));kernel.logger.info("zulu",`[retrieval_agent][debug] retrieval_id=${this.combinedSubtaskId} round=${this.roundCount}/${this.maxRounds} tool_round=${JSON.stringify(e)}`);const r=e.filter((e=>"executed"===e.state)).length;kernel.logger.info("zulu",`[retrieval_agent][round_tools] round=${this.roundCount} tool_count=${r}`)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][debug] failed to serialize tool round: ${e.message}`)}try{const e=new Set(["read_file","grep_content","extract_content_blocks"]);for(const r of t||[]){const t=r.metadata?.tool,n=t?.name;t&&e.has(n)&&this.fileReadTracker.trackFromToolResult(n,t.toolHandler?.params||{},r.output||"")}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][tracker] Failed to track file reads: ${e.message}`)}try{const e=[];for(const r of t||[]){const t=r.metadata?.tool;if(t){const r=t.toolHandler?.params||{};e.push(`${t.name}|${r.path||r.target_file||r.target_directory||""}|${r.pattern||""}`)}}const r=e.sort().join(";");this.toolCallSignatures.push(r);const n=this.toolCallSignatures.length;if(n>=3&&r.length>0&&this.toolCallSignatures[n-2]===r&&this.toolCallSignatures[n-3]===r){const e=r.split("|"),t=e[1]||"同一文件",n=e[2]||"同一关键词";this.repetitiveToolHint=`【重复操作警告】你已经连续 3 轮对 ${t} 使用相同的搜索模式（${n}），但始终未找到有效内容。这是严重的效率浪费。你必须立即改变策略：\n1. 换文件：round_summary 中提到的其他候选文件（如其他期刊文件）你还没有读取\n2. 换关键词：当前关键词搜索效果不佳，尝试同义词、英文等变体\n3. 换工具：如果 grep_content 定位不准，改用 read_file 直接读取文件的 Python 相关区域\n4. 换目录：搜索其他目录或子目录\n禁止再对同一文件使用相同搜索模式。`,kernel.logger.warn("zulu",`[retrieval_agent][guard] Repetitive tool call detected: round=${this.roundCount}, signature="${r}", consecutive_count=3. Injecting correction hint.`)}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][sig_track] Failed: ${e.message}`)}let n=[];try{n=this.encodeToolReturns(t,this.roundCount)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][encoding] Failed to encode tool returns: ${e.message}`)}let i=0,o=0,s=!1,a=!1,c=0;try{const e=this.toolTurns[this.toolTurns.length-1];if(e){const t=e.toText()||"";kernel.logger.info("zulu",`[retrieval_agent][debug] round=${this.roundCount} llm_text_preview=${truncateLine(t,500)}`);const r=this.parseEffectiveBlocks(t,this.roundCount);i=r.added,o=r.removed,s=r.found;const n=this.parseTraceEdges(t,this.roundCount);this.updateBreadthProbes();const l=this.parseBreadthStatus(t,this.roundCount),A=Array.from(this.traceEdgesMap.values()).filter((e=>"pending"===e.status)).length,u=Array.from(this.breadthProbesMap.values()).filter((e=>"needs_exploration"===e.status)).length;kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} trace_edges_parsed=${n.found}, te_added=${n.added}, te_resolved=${n.resolved}, te_pending=${A}, te_total=${this.traceEdgesMap.size}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} breadth_probes_total=${this.breadthProbesMap.size}, needs_exploration=${u}, breadth_status_parsed=${l.found}, bp_updated=${l.updated}`);const d=this.parseRoundGaps(t);if("CLEAN"===d.status)this.unreadTargetsMap.clear();else if("PENDING"===d.status){for(const e of d.files){const t=this.unreadTargetsMap.get(e)??0;this.unreadTargetsMap.set(e,t+1)}for(const[e,t]of this.unreadTargetsMap)t>=2&&(this.stuckUnreadHints.push(`- \`${e}\`（已连续 ${t} 轮识别但未 read_file，下轮必须优先读取）`),kernel.logger.warn("zulu",`[retrieval_agent][round_gaps] round=${this.roundCount} stuck_unread=true file=${e} consecutive_rounds=${t}`))}const h="CLEAN"===d.status&&this.effectiveBlocksMap.size<1;kernel.logger.info("zulu",`[retrieval_agent][round_gaps] round=${this.roundCount} round_gaps_parsed=${null!==d.status} gap_status=${d.status??"omitted"} unread_targets=${d.files.length} stuck_unread=${this.stuckUnreadHints.length} gap_clean_fake=${h}`);const p=this.parseRoundSummary(t);if(p){this.roundSummaries.push(p),a=!0,c=p.length;const e=p.match(/(HYPOTHESIS_(?:CONFIRMED|REVISED[^\n]*)|UPSTREAM_(?:CHECKED|MISSING[^\n]*)|DIRECTION_(?:OK|RESET[^\n]*))/g);if(e&&e.length>0){this.lastProbeConclusion=e.map((e=>e.trim())).join(" | "),kernel.logger.info("zulu",`[retrieval_agent][periodic_probe] parsed conclusions: ${this.lastProbeConclusion}`);try{const t=e.some((e=>e.startsWith("HYPOTHESIS_CONFIRMED")));if(t||e.some((e=>e.startsWith("HYPOTHESIS_")))){const e=[],r=p.match(/REASONING_CHAIN:[\s\S]*?(?=BASIS_BLOCKS:|$)/)?.[0]||"",n=p.match(/BASIS_BLOCKS:\s*\[([^\]]*)\]/)?.[1]||"";let i;const o=/\b(R\d+-[A-Z]+)\(([^)]+)\)/g;for(;null!==(i=o.exec(r));)e.push({id:i[1],declaredFile:i[2],inReasoning:!0});const s=/\b(R\d+-[A-Z]+)\(([^)]+)\)/g;for(;null!==(i=s.exec(n));)e.some((e=>e.id===i[1]))||e.push({id:i[1],declaredFile:i[2],inReasoning:!1});const a=[];for(const{id:t,declaredFile:r,inReasoning:n}of e){const e=this.effectiveBlocksMap.get(t);e?e.file.endsWith(r)||e.file.includes(r)||a.push({entry:`${t}(${r})`,reason:"file_mismatch",actual:e.file}):a.push({entry:`${t}(${r})`,reason:n?"reasoning_ref_invalid":"id_not_found"})}const c=r.split("\n").filter((e=>e.trim().startsWith("-")));for(const e of c){const t=e.match(/\b(R\d+-[A-Z]+)\(([^)]+)\)/);if(!t)continue;const r=t[1],n=this.effectiveBlocksMap.get(r);if(!n)continue;const i=new Set(e.toLowerCase().split(/\s+/).filter((e=>e.length>3))),o=new Set(n.reason.toLowerCase().split(/\s+/).filter((e=>e.length>3))),s=[...i].filter((e=>o.has(e))).length;i.size>0&&0===s&&(kernel.logger.warn("zulu",`[probe_reasoning_inconsistency] ${r}: claimed="${e.trim().substring(0,100)}" stored_reason="${n.reason.substring(0,100)}"`),this.pendingReasoningWarning||(this.pendingReasoningWarning={id:r,claimed:e.trim().substring(0,150),actual:n.reason.substring(0,150)}))}if(a.length>0){const e=a.map((e=>"id_not_found"===e.reason||"reasoning_ref_invalid"===e.reason?`- ${e.entry}：该编号不在 effectiveBlocksMap 中，你在推理链中引用了一个从未实际读取的 block。请先 read_file 获取真实编号。`:`- ${e.entry}：编号存在，但实际文件是 ${e.actual}，与声明不符。请核查推理链中对该 block 的描述。`)).join("\n");this.stuckUnreadHints.push(`⚠️ [probe_hallucination] 发现以下幻觉引用，在核查并修正之前不得输出 HYPOTHESIS_CONFIRMED：\n${e}`),this.confirmedCount=0,kernel.logger.warn("zulu",`[probe_hallucination] detected ${a.length} hallucinated refs: ${a.map((e=>e.entry)).join(", ")}`)}else t&&(this.confirmedCount++,kernel.logger.info("zulu",`[probe_confirmed] confirmedCount=${this.confirmedCount}, no hallucination detected`));t&&this.confirmedCount>=2&&this.stuckUnreadHints.push(`[probe_expand] 你的假设已通过 ${this.confirmedCount} 次验证，依据 blocks 均已实际读取。\n为避免遗漏平行路径，请额外检查：\n1. 是否存在多后端/子类 override 路径未覆盖当前修复位置？\n2. 当前假设文件的调用方中，是否有绕过修复位置的快捷路径？\n输出 EXPANSION_DONE: [检查结论] 后继续。`)}}catch(e){kernel.logger.warn("zulu",`[fix_e_hallucination] error: ${e}`)}}}else if(t.trim().length>0){const e=t.trim().length>500?t.trim().substring(0,500)+"...":t.trim();this.roundSummaries.push(e),a=!0,c=e.length,kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} round_summary_fallback=true, used LLM raw text (${e.length} chars)`)}const g=t.match(/<mode_switch>(doc|auto)<\/mode_switch>/);if(g&&"code"===this.retrievalType&&this.modeSwitchCount<1){const e=g[1],r=t.match(/<mode_switch_reason>([\s\S]*?)<\/mode_switch_reason>/),n=r?r[1].trim():"";if(n){const t=this.retrievalType;this.retrievalType=e,this.modeSwitchRound=this.roundCount,this.modeSwitchCount++,kernel.logger.info("zulu",`[RA_MODE_SWITCH] round=${this.roundCount} old=${t} new=${e} reason=${n}`)}else this.roundSummaries.push("【系统消息】模式切换被拒绝：检测到 <mode_switch> 声明但缺少 <mode_switch_reason> 字段，已忽略。如需切换，请在 <mode_switch_reason> 中说明证据分布依据。"),kernel.logger.warn("zulu",`[RA_MODE_SWITCH] round=${this.roundCount} rejected: missing reason`)}}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][debug] Failed to parse effective blocks/round_summary: ${e.message}`)}try{const e=this.toolTurns[this.toolTurns.length-1];if(e){const t=((e.toText()||"").match(/<effective_blocks>/g)||[]).length;if(t>4){let e=0;for(const[t,r]of this.effectiveBlocksMap)"unfold"===r.displayMode&&(this.effectiveBlocksMap.set(t,{...r,displayMode:"fold"}),this.blockUnfoldSince.delete(t),e++);this.roundSummaries.length>0&&(this.roundSummaries[this.roundSummaries.length-1]=`[系统警告] 上轮输出异常冗长（<effective_blocks> 重复 ${t} 次），已自动 fold 全部展开块（${e} 个）。请在本轮重新评估哪些块需要展开，避免重复声明。`),kernel.logger.warn("zulu",`[retrieval_agent][runaway] round=${this.roundCount} repetition_count=${t} force_folded=${e}`)}}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][runaway] detection failed: ${e.message}`)}kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} round_summary_parsed=${a}, summary_length=${c}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} effective_blocks_parsed=${s}, added=${i}, removed=${o}, map_total=${this.effectiveBlocksMap.size}`);try{const e=(t||[]).map((e=>e.metadata?.tool?.name)).filter(Boolean).join(", ");this.retrievalLog.push(`轮次${this.roundCount}: 调用了 ${e}，当前有效代码块 ${this.effectiveBlocksMap.size} 个（新增${i}/移除${o}）`)}catch{}const l=t?.map((e=>{const t=e.metadata.tool,r="executed"===t.toolState,i=t.name;let o=e.output||"";if(r&&o.length>200){const e=n.filter((e=>e.toolName===i));if(e.length>0){const t=e.map((e=>`[${e.id}] ${e.file}:${e.startLine}-${e.endLine}`)).join("\n");o=`[系统已编码为以下代码块，详见检索进度摘要]\n${t}`}else o=o.substring(0,200)+"... (已压缩)"}return{id:t.toolId,name:t.name,success:r,params:t.toolHandler.params,message:o}}));try{for(const e of t||[]){const t=e.metadata?.tool;if(!t||"read_file"!==t.name||"executed"!==t.toolState)continue;const r=t.toolHandler?.params?.target_file||"";if(!r)continue;const n=e.metadata?.endLine,i=e.metadata?.totalLines;null!=n&&null!=i&&n>=i&&(this.exhaustedFiles.add(r),kernel.logger.info("zulu",`[fix_d_fully_read] file=${r} endLine=${n} totalLines=${i} → exhausted`))}}catch{}try{for(const e of l||[]){if(!e.success||"read_file"!==e.name)continue;const t=e.params?.target_file||"";if(!t)continue;const r=e.params?.offset||1,n=e.params?.limit,i=n?r+n-1:Number.MAX_SAFE_INTEGER;for(const[e,n]of this.effectiveBlocksMap){if("fold"!==n.displayMode)continue;if(!(t.endsWith(n.file)||n.file.endsWith(t)||t.includes(n.file)||n.file.includes(t)))continue;const o=Math.max(r,n.startLine),s=Math.min(i,n.endLine);if(s<o)continue;const a=i===Number.MAX_SAFE_INTEGER?n.endLine-n.startLine+1:i-r+1,c=a>0?(s-o+1)/a:0;if(c>=.6){this.effectiveBlocksMap.set(e,{...n,displayMode:"unfold"}),this.blockUnfoldSince.has(e)||this.blockUnfoldSince.set(e,this.roundCount),kernel.logger.info("zulu",`[retrieval_agent][fold_reread_intercept] round=${this.roundCount} block=${e} file=${n.file} overlap=${Math.round(100*c)}% auto-unfolded`),this.foldRereadWarnings.push(`- [${e}] ${n.file}:${n.startLine}-${n.endLine}（第${n.round}轮已读）已自动展开。请在本轮 <effective_blocks> 中更新该块的 reason，补充关键函数名和逻辑结论（语义描述，勿写行号）。`);break}}}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][fold_reread_intercept] failed: ${e.message}`)}try{for(const e of l||[]){if(!e.success||"read_file"!==e.name)continue;const t=e.params?.target_file||"";if(!t)continue;const r=this.readFilesHistory.get(t)||[];r.includes(this.roundCount)||(r.push(this.roundCount),this.readFilesHistory.set(t,r))}for(const e of l||[]){if(!e.success||"grep_content"!==e.name)continue;const t=e.params?.file||"";if(!t)continue;const r=(this.grepFilesHistory.get(t)||0)+1;this.grepFilesHistory.set(t,r),r>=2&&!this.foldRereadWarnings.some((e=>e.includes(t)&&e.includes("grep")))&&(this.foldRereadWarnings.push(`- [grep-upgrade] 已对 \`${t}\` 进行 ${r} 次 grep_content 搜索。grep 片段可能不足以定位精确调用点，建议改用 \`read_file\` 并指定 offset/limit 精确读取目标行范围，避免在大文件中反复搜索。`),kernel.logger.info("zulu",`[retrieval_agent][grep_upgrade_prompt] round=${this.roundCount} file=${t} grep_count=${r}`))}const e=/\b(set_[a-z_]+|clear_[a-z_]+|[a-z_]+_reset\b|[a-z_]+_invalidate\b|invalidate_[a-z_]+|\.cache\b|_cache\b|cache_[a-z_]+|flush_[a-z_]+|expire_[a-z_]+)\s*[\(\=]/i;for(const t of l||[]){if(!t.success||"grep_content"!==t.name)continue;const r=t.message||"";if(!e.test(r))continue;const n=t.params?.file||t.params?.path||"",i=`[side-effect-check]${n}`;this.foldRereadWarnings.some((e=>e.includes(i)))||(this.foldRereadWarnings.push(`- ${i} grep 结果中发现含副作用/缓存操作的函数（如 set_*/clear_*/*_reset/cache_*）。这类函数通常是状态管理的关键路径，**必须 read_file 补充完整上下文**，确认：(1) 该副作用是否是 bug 的真实原因；(2) 是否有其他调用方也受影响。不得仅凭 snippet 直接做结论。`),kernel.logger.info("zulu",`[retrieval_agent][side_effect_check] round=${this.roundCount} file=${n} grep_contains_side_effect`))}for(const[e,t]of this.readFilesHistory){if(t.length<2)continue;const r=Array.from(this.effectiveBlocksMap.values()).some((t=>t.file===e||e.endsWith(t.file)||t.file.endsWith(e)));if(r)continue;const n=t[t.length-1];let i=0;for(const[r,o]of this.codeBlockRegistry)o.round===n&&"read_file"===o.toolName&&(this.effectiveBlocksMap.has(r)||(o.file===e||e.endsWith(o.file)||o.file.endsWith(e))&&(this.effectiveBlocksMap.set(r,{blockId:r,file:o.file,startLine:o.startLine,endLine:o.endLine,reason:`[auto-promote] 该文件已被读取 ${t.length} 次但无有效标注块，系统自动升格为 valid_unfold 以防止遗漏`,round:o.round,displayMode:"unfold",fullContent:o.fullContent}),i++,kernel.logger.info("zulu",`[retrieval_agent][repeat_read_autopromote] round=${this.roundCount} block=${r} file=${e} read_rounds=${t.join(",")} auto-promoted to valid_unfold`)));i>0&&!this.foldRereadWarnings.some((t=>t.includes(e)))&&this.foldRereadWarnings.push(`- [auto-promote] ${e} 已被读取 ${t.length} 次但始终未标注有效块，系统已自动升格最近一次读取的内容为 valid_unfold。请在本轮 <effective_blocks> 中为这些块补充 reason。`)}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][repeat_read_autopromote] failed: ${e.message}`)}if(this.pathCorrectionHints.size>0){const e=new Set((l||[]).filter((e=>e.success&&"read_file"===e.name)).map((e=>e.params?.target_file||e.params?.path||"")).filter(Boolean));for(const[t,r]of this.pathCorrectionHints)r.some((t=>e.has(t)))&&(this.pathCorrectionHints.delete(t),kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} cleared hint for "${t}" (LLM used correct path)`))}try{this.detectAndResolveEnoent(l||[])}catch(e){kernel.logger.error("zulu",`[retrieval_agent][enoent_autocorrect] detectAndResolveEnoent failed: ${e.message}`)}if(this.roundSummaries.length>0){const e=(l||[]).filter((e=>!e.success&&"read_file"===e.name&&/does not exist|ENOENT|no such file/i.test(e.message)));if(e.length>0){const t=e.map((e=>{const t=e.params?.target_file||e.params?.path||"(unknown)",r=this.pathCorrectionHints.get(t);return`read_file("${t}") 路径不存在${r&&r.length>0?`，系统发现正确路径: ${r[0]}`:"，未找到同名文件"}`})).join("；"),r=this.roundSummaries.length-1;this.roundSummaries[r]+=`\n⚠️ 路径猜测失败: ${t}`,kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} injected ENOENT note into round_summary: ${t}`)}}for(const e of l||[])if(!e.success&&("list_dir"===e.name||"read_file"===e.name)){const t=e.params?.target_directory||e.params?.target_file||e.params?.path||"";t&&this.failedToolPaths.add(t)}let A=!1;try{const e=this.toolTurns[this.toolTurns.length-1];if(e){const t=e.toText()||"";A=/<retrieval_complete\s*\/?>/.test(t),A&&kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} retrieval_complete=true, LLM 主动结束检索，进入汇总阶段`)}}catch{}if(A){const e=this.roundSummaries.length>0?this.roundSummaries[this.roundSummaries.length-1]:"",t=/未确认|未验证|待补充|未探索|未追踪|未读取|缺失|尚未|未能确认|需要进一步/.test(e),r="code"===this.retrievalType?3:6,n=this.effectiveBlocksMap.size<r&&this.roundCount<this.maxRounds-1;let i=!1;if(("doc"===this.retrievalType||"auto"===this.retrievalType)&&this.ctx.rootPath)try{const e=readdirSync$1(this.ctx.rootPath).filter((e=>{try{return statSync$2(`${this.ctx.rootPath}/${e}`).isDirectory()}catch{return!1}}));let t=1;if(1===e.length){const r=`${this.ctx.rootPath}/${e[0]}`;let n=0;try{n=readdirSync$1(r).filter((e=>!e.startsWith("."))).length}catch{}const o=new Set;for(const t of this.effectiveBlocksMap.values()){const r=t.file.split("/");r[0]===e[0]&&r.length>=2&&o.add(r[1])}t=n>0?o.size/n:1,i=t<.3}else if(e.length>1){const r=new Set;for(const[e]of this.effectiveBlocksMap){const t=e.split("/")[0];t&&r.add(t)}t=r.size/e.length,i=t<.6}kernel.logger.info("zulu",`[retrieval_agent][guard] broadness check: mode=${this.retrievalType}, topDirs=${e.length}, coveredRatio=${t.toFixed(2)}, broadnessDeficit=${i}`)}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][guard] broadness check failed: ${e.message}`)}(t||n||i)&&(A=!1,kernel.logger.warn("zulu",`[retrieval_agent][guard] Premature complete blocked in handleTokenNotification: mode=${this.retrievalType}, round=${this.roundCount}/${this.maxRounds}, effectiveBlocks=${this.effectiveBlocksMap.size}, sparseThreshold=${r}, hasGaps=${t}, sparseEvidence=${n}, broadnessDeficit=${i}. Forcing continued retrieval.`))}let u=!1;const d=Math.floor(.7*this.originalMaxRounds);if(!A&&this.roundCount>=d&&!this.roundsExpanded){const e=this.roundSummaries.length>0?this.roundSummaries[this.roundSummaries.length-1]:"";/未覆盖|缺失|需要继续|不充分|还有.*方向|未追溯|未读取|不够|需补充|需进一步|待探索|待执行/.test(e)&&(u=!0,this.maxRounds=2*this.originalMaxRounds,this.roundsExpanded=!0,this.expansionHint=`【轮次扩容通知】检索轮次已从 ${this.originalMaxRounds} 扩展至 ${this.maxRounds} 轮。你还有 ${this.maxRounds-this.roundCount-1} 轮余量。请重新规划剩余检索策略：回顾 round_summary 中的待处理项，按优先级依次完成，不要急于结束。`,kernel.logger.info("zulu",`[retrieval_agent][adaptive] round=${this.roundCount} detected insufficient evidence signals, expanding maxRounds from ${this.originalMaxRounds} to ${this.maxRounds}`))}if(this.roundCount>=this.maxRounds-1&&!u||A){this.terminationReason=A?"retrieval_complete":"max_rounds";const e=l?.map((e=>({...e,message:"[已编码，详见汇总指令中的有效代码块]"}))),t=this.buildEffectiveBlocksSummary(),r=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):this.retrievalLog.join("\n")||"（无检索记录）",n=("code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_PROMPT).replace("{{RETRIEVAL_SUMMARY}}",r).replace("{{EFFECTIVE_BLOCKS}}",t);kernel.logger.info("zulu",`[retrieval_agent][summary] Injecting summary prompt, ${this.retrievalLog.length} rounds logged, effective summary length=${t.length}`);const i=this.toolTurns[this.toolTurns.length-1],o=i?.rollbackMessageId,s={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};this.agentLoop({taskId:this.subtaskId,agentInfo:s,subAgents:[],query:n,isUserQuery:!0,toolUseResults:e,rollbackMessageId:o})}else{const e=this.buildRoundContext(n),t=this.toolTurns[this.toolTurns.length-1],r=t?.rollbackMessageId;kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} stateless_mode=true, context_length=${e.length}, rollbackId=${r||"none"}, toolUseResults_count=${(l||[]).length}`),e.length>0?this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:l||[],query:e,isUserQuery:!0,rollbackMessageId:r}):this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:l})}}}}}function createHandler(e,t,r,n){const i=n??e;switch(getCanonicalToolName(e)){case"list_dir":return new ListDir(t,r,i);case"delete_file":return new DeleteFile(t,r,i);case"edit_file":return new EditFile(t,r,i);case"write_file":return new WriteFile(t,r,i);case"grep_content":return new GrepContent(t,r,i);case"glob_path":return new GlobPath(t,r,i);case"delegate_subtask":return new DelegateSubtask(t,r,i);case"todo_write":return new TodoWrite(t,r,i);case"run_command":return new RunCommand(t,r,i);case"read_file":return new ReadFile(t,r,i);case"codebase_search":return new CodebaseSearch(t,r,i);case"web_search":return new WebSearch(t,r,i);case"web_fetch":return new WebFetch(t,r,i);case"update_memory":return new UpdateMemory(t,r,i);case"use_mcp_tool":return new McpTool(t,r,i);case"read_lints":return new ReadLints(t,r,i);case"skill":return new Skill(t,r,i);case"compress_message":return new CompressMessage(t,r,i);case"ask_user_question":return new AskUserQuestion(t,r);case"create_plan":return new CreatePlan(t,r);case"doc_read":return new DocRead(t,r,i);case"doc_list":return new DocList(t,r,i);case"doc_search":return new DocSearch(t,r,i);case"automation_browser":return new AutomationBrowser(t,r,i);case"stop_task":return new StopTask(t,r,i);case"task_complete":return new TaskComplete(t,r,i);case"retrieval_agent":return new RetrievalAgent(t,r,i);default:return new UnknownHandler("unknown",t,r,i)}}class Tool{token;ctx;acceptState="accepted";handler;toolState="pending";constructor(e,t){this.token=e,this.ctx=t,this.handler=new UnknownHandler("unknown",this.ctx,new Token("unknown")),e.onNotify?.((e=>{e.name}))}get result(){return this.handler.result}get state(){return this.token.state}get name(){return this.handler.name}get toolId(){return this.token.id}get accepted(){return"accepted"===this.acceptState}get rejected(){return"rejected"===this.acceptState}get toolHandler(){return this.handler}get isSubtask(){return this.handler instanceof DelegateSubtask}get rollbackActionName(){return this.handler instanceof DeleteFile?"willCreate":null===this.handler.result?.metadata?.originalContent?"willDelete":"willChange"}get isTouchFileHandler(){return this.handler instanceof WriteFile||this.handler instanceof EditFile||this.handler instanceof DeleteFile||this.handler instanceof UpdateMemory||this.handler instanceof CreatePlan}initialized=!1;static createHandlerTokenId(e){return`handler-${e}`}match(e){return this.toolId===e}async mergeParams(e,t){this.handler.onUpdateParams({...this.handler.params,...t}),this.normalizeHandlerFromParams(e)}async appendParamContent(e,t){const r=this.handler.params;for(const[e,n]of Object.entries(t??{})){const t=r[e]??"";"string"==typeof t&&"string"==typeof n&&(r[e]=t+n)}this.handler.onUpdateParams(r),this.normalizeHandlerFromParams(e)}update(e,t,r){if(!this.initialized){this.initialized=!0;const t=this.token.fork(Tool.createHandlerTokenId(this.toolId));this.handler=createHandler(e,this.ctx,t,e),t.onNotify((e=>{"completed"===e.name&&(this.handler.result=e.payload?.result??this.handler.result)}))}"FUNCTION_CALL_PARAMS_APPEND"===t||"FUNCTION_CALL_END"===t?this.appendParamContent(e,r):"FUNCTION_CALL_PARAMS_MERGE"===t&&this.mergeParams(e,r)}normalizeHandlerFromParams(e){const t=getCanonicalToolName(this.name),r=getCanonicalToolName(e),n=this.handler.params?.command;if("string"!=typeof n)return;const i=extractAutomationBrowserCommand(n);if(i&&"run_command"===t){const e=this.handler.token;return this.handler=createHandler("automation_browser",this.ctx,e,"automation_browser"),void this.handler.onUpdateParams({command:i})}"automation_browser"!==t&&"automation_browser"!==r||null!==i&&i!==n&&this.handler.onUpdateParams({command:i})}error;async execute(){try{this.toolState="beforeExecute";const e=await hookService.triggerHook(HookEvent.PreToolUse,{...hookService.buildCommonInput(this.ctx.traceId,{sessionId:this.ctx.conversationId,taskId:this.ctx.taskId}),hook_event_name:HookEvent.PreToolUse,tool_name:this.name,tool_input:this.handler.params??{},tool_use_id:this.toolId},this.name);if("deny"===e.decision){const t=e.reason||"Blocked by hook";this.handler.result.output=t;const r=[buildHookSystemReminder(e.hookSource,t)];throw e.additionalContext&&r.push(buildAdditionalContextReminder(e.hookSource,e.additionalContext)),this.handler.result.metadata.hookSystemReminder=r.filter(Boolean).join("\n"),new ToolSkipExecuteError(t)}if(!1===e.continue){const t=e.stopReason||"Execution stopped by hook";this.handler.result.output=t;const r=[buildHookSystemReminder(e.hookSource,t)];throw e.additionalContext&&r.push(buildAdditionalContextReminder(e.hookSource,e.additionalContext)),this.handler.result.metadata.hookSystemReminder=r.filter(Boolean).join("\n"),kernel.connect.sendWebviewMessage(PT_WEBVIEW_HOOK_BLOCKED,{hookEventName:"executionStopped",message:t}).catch((()=>{})),new HookStopExecutionError(t)}const t=await this.handler.beforeExecute();if(t?.substituteHandler){const{name:e,params:r}=t.substituteHandler;this.handler=createHandler(e,this.ctx,this.handler.token,e),this.handler.onUpdateParams(r),await this.handler.beforeExecute()}this.onDidExecute(t),this.toolState="executing",await this.handler.execute(this.ctx),this.toolState="executed";const r=await this.firePostToolUse();this.attachHookReminder(r),this.token.complete(this.result)}catch(e){if(e instanceof ToolValidationError||e instanceof ToolExecuteError){this.toolState="failed";const t=await this.firePostToolUseFailure(this.result.output,e instanceof ToolValidationError?"validation":"error");return this.attachHookReminder(t),void this.token.fail(this.result.output)}if(e instanceof ToolSkipExecuteError){this.toolState="skipped";const e=await this.firePostToolUseFailure(this.result.output,"skipped");return this.attachHookReminder(e),void this.token.fail(this.result.output)}if(e instanceof HookStopExecutionError){this.toolState="hook_stopped";const e=await this.firePostToolUseFailure(this.result.output,"skipped");return this.attachHookReminder(e),void this.token.fail(this.result.output)}if(e instanceof SubtaskInterruptError)return this.handler.result=e.toolResult,void("cancelled"!==this.toolState&&(this.toolState="failed",this.token.fail(e.toolResult.output)));const t=e instanceof Error?e.message:"string"==typeof e?e:"Unknown error";this.handler.result.output=t,this.toolState="failed";const r=await this.firePostToolUseFailure(t,"error");this.attachHookReminder(r),this.token.fail(t)}finally{await this.handler.afterExecute()}}complete(e){this.token.complete(e)}fail(e){this.token.fail(e)}onDidExecute(e){this.token.onDidExecute(e,this)}toMessage(){const e={id:this.token.id,type:"TOOL",toolName:this.name,params:this.handler.params,toolState:this.toolState,error:this.error,result:this.result};return this.handler instanceof DelegateSubtask&&(e.children=this.handler.toolTurns.map((e=>e.toMessage()))),this.isTouchFileHandler&&(e.accepted=this.accepted),e}async accept(){this.acceptState="accepted"}async reject(){this.acceptState="rejected"}static rebuild(e,t,r){const n=Token.createSnapshotToken(e.id,r),i=new Tool(n,t);i.initialized=!0;const o=getCanonicalToolName(e.toolName);if(i.handler=createHandler(o,t,Token.createSnapshotToken(Tool.createHandlerTokenId(e.id),n),e.toolName),i.handler.rebuildResult(e.result??{output:"",metadata:{}}),i.update(e.toolName,"FUNCTION_CALL_PARAMS_MERGE",e.params),i.toolState="executed"===e.toolState||"failed"===e.toolState?e.toolState:"cancelled","delegate_subtask"===o){const r=e.children.map((e=>ToolTurn.rebuild(e,t,n)));i.toolHandler.push(...r)}return i}toText(){return`\`\`\`${this.name}\n${JSON.stringify(this.handler.params)}\n\`\`\``}cancel(){"executed"!==this.toolState&&"failed"!==this.toolState&&(this.isSubtask&&this.handler.result.output||(this.handler.result.output=ToolError.common.execution_aborted),this.handler.result.metadata.success=!1,this.toolState="cancelled","function"==typeof this.handler.cancel&&this.handler.cancel())}async firePostToolUse(){try{return await hookService.triggerHook(HookEvent.PostToolUse,{...hookService.buildCommonInput(this.ctx.traceId,{sessionId:this.ctx.conversationId,taskId:this.ctx.taskId}),hook_event_name:HookEvent.PostToolUse,tool_name:this.name,tool_input:this.handler.params??{},tool_use_id:this.toolId,tool_response:this.result?.output??""},this.name)}catch{return{decision:"allow"}}}async firePostToolUseFailure(e,t){try{return await hookService.triggerHook(HookEvent.PostToolUseFailure,{...hookService.buildCommonInput(this.ctx.traceId,{sessionId:this.ctx.conversationId,taskId:this.ctx.taskId}),hook_event_name:HookEvent.PostToolUseFailure,tool_name:this.name,tool_input:this.handler.params??{},tool_use_id:this.toolId,error:e,failure_type:t},this.name)}catch{return{decision:"allow"}}}attachHookReminder(e){if(this.handler.result.metadata.hookSystemReminder)return;const t=e.additionalContext;t&&(this.handler.result.metadata.hookSystemReminder=buildAdditionalContextReminder(e.hookSource,t))}}function buildHookSystemReminder(e,t){if(!e)return;const r="command"===e.type?`from command. "${e.command}"`:`from url: "${e.url}"`,n=e.matcher||"*";return`<system-reminder>\n${e.event}: ${n} hook blocking error ${r}: ${t}\n</system-reminder>`}function buildAdditionalContextReminder(e,t){return`<system-reminder>\n${e?.event||"hook"} hook additional context: ${t}\n</system-reminder>`}class Element{text;end;id=randomUUID();lastModifiedTime=Date.now();startTime=Date.now();constructor(e,t){this.text=e,this.end=t}updateText(e,t){this.end||(this.lastModifiedTime=Date.now(),this.end=t,this.text=(this.text+e).replace(/^(\r?\n)+/,""))}cancel(){this.end=!0}toText(){return this.text}toMessage(){return{id:this.id,type:"TEXT"}}}class Text extends Element{toMessage(){return{...super.toMessage(),end:this.end,content:this.text,type:"TEXT"}}}class Thinking extends Element{toMessage(){return{...super.toMessage(),end:this.end,content:this.text,startTime:this.startTime,lastModifiedTime:this.lastModifiedTime,type:"REASON"}}}class Exception extends Element{toMessage(){return{...super.toMessage(),content:this.text,type:"EXCEPTION"}}}class ToolTurn{rollbackMessageId;token;ctx;discard=!1;elements=[];preExecuteHook;constructor(e,t,r){this.rollbackMessageId=e,this.token=t,this.ctx=r,this.token.onNotify?.((e=>{"cancel"===e.name&&this.tools.forEach((e=>{e.cancel()}))}))}get tools(){return this.elements.filter((e=>e instanceof Tool))}get acceptedFsTools(){return this.executedFsTools.filter((e=>e.accepted))}get executedFsTools(){return this.tools.reduce(((e,t)=>"delegate_subtask"===t.name?(t.toolHandler.toolTurns.map((t=>e.push(...t.acceptedFsTools))),e):(t.isTouchFileHandler&&"executed"===t.toolState&&e.push(t),e)),[])}static createTokenId(e){return`turn-${e}`}getToolById(e){const t=this.tools.find((t=>t.toolId===e));if(!t){const t=this.token.fork(e),r=new Tool(t,this.ctx);return this.elements.push(r),r}return t}getToolsByAbosultePath(e){return this.tools.filter((e=>e.isTouchFileHandler)).filter((t=>"executed"===t.toolState&&t.result?.metadata?.absolutePath===e))}isText(e){return e instanceof Text}isThinking(e){return e instanceof Thinking}isException(e){return e instanceof Exception}async replaceFilePathInText(){const e=this.elements.find(this.isText);if(e){const t=await replaceFilePathInCodeSpan(e.text,Array.from(this.ctx.parameterCollector.touchedAbsolutePaths));e.text=t}}updateText(e,t){const r=this.elements[this.elements.length-1];if(this.isText(r))r.updateText(e,t);else if(!(r instanceof Tool)&&e.length){const r=new Text(e,t);this.elements.push(r)}}updateThinking(e,t){const r=this.elements[0];if(this.isThinking(r))r.updateText(e,t);else if(!this.elements.length&&e.length){const r=new Thinking(e,t);this.elements.push(r)}}updateException(e){const t=this.elements[this.elements.length-1];if(this.isException(t))t.updateText(e,!0);else{const t=new Exception(e,!0);this.elements.push(t)}}async cancel(e){"string"==typeof e&&e.length&&this.updateException(e),await Promise.all(this.elements.map((e=>e.cancel()))),await this.replaceFilePathInText()}getCompressionTool(){const e=this.tools[this.tools.length-1];if("compress_message"===e?.name&&"pending"===e.toolState)return e;const t=this.token.fork(randomUUID()),r=new Tool(t,this.ctx);return this.elements.push(r),r}match(e){return this.rollbackMessageId===e}push(...e){for(const t of e){this.getToolById(t.toolId)||this.elements.push(t);const e=this.token.fork(t.toolId),r=new Tool(e,this.ctx);this.elements.push(r)}}toMessage(){return{id:this.rollbackMessageId,discard:this.discard,children:this.elements.filter((e=>!(e instanceof Tool&&e.toolHandler instanceof UnknownHandler))).map((e=>e.toMessage()))}}async waitForAllToolCompletion(){if(this.tools.every((e=>e.isSubtask)))await Promise.all(this.tools.map((e=>e.execute())));else for(const e of this.tools){if(this.preExecuteHook){if(await this.preExecuteHook(e))continue}if(await e.execute(),"hook_stopped"===e.toolState)break}if(this.elements.forEach((e=>{e instanceof Tool||e.cancel()})),await this.replaceFilePathInText(),0===this.tools.length){const e=this.elements.find(this.isText)?.text||"";this.token.break([{output:e,metadata:{}}])}else this.token.complete(this.tools.map((e=>({...e.result,metadata:{...e.result,tool:e}}))))}static rebuild(e,t,r){const n=Token.createSnapshotToken(ToolTurn.createTokenId(e.id),r),i=new ToolTurn(e.id,n,t);i.discard=!!e.discard;for(const r of e.children)if("REASON"===r.type)i.updateThinking(r.content,!0);else if("TEXT"===r.type)i.updateText(r.content,!0);else if("EXCEPTION"===r.type)i.cancel(r.content);else{const e=Tool.rebuild(r,t,n);i.elements.push(e)}return i}toText(){return this.elements.map((e=>e.toText())).join("\n\n")}static omitUnnecessaryFields(e){const t=e.children;return{...e,children:t.map((e=>{if("TOOL"===e.type){const t=getCanonicalToolName(e.toolName);return"delegate_subtask"===t?{..._$H.omit(e,"result.output"),toolName:t,children:e.children?.map((e=>({...e,children:e.children?.map((e=>{const t=_$H.omit(e,"result.output","result.metadata.originalContent","result.metadata.content");return"TOOL"===e.type?{...t,toolName:getCanonicalToolName(e.toolName)}:t}))})))}:{..._$H.omit(e,"result.output","result.metadata.originalContent","result.metadata.content"),toolName:t}}return e}))}}}const{findLast:findLast}=_$H;var RoundtripStatus;!function(e){e.Failed="failed",e.Completed="completed",e.Cancelled="cancelled",e.Analyzing="analyzing",e.Generating="generating",e.Compressing="compressing"}(RoundtripStatus||(RoundtripStatus={}));const isToolCallMessage=e=>e instanceof ToolCallMessage,isTextMessage=e=>e instanceof TextMessage;class Roundtrip{conversationId;repo;logger;virtualEditor;updateWebviewMessages;editToolCount=0;v2=!1;disabledRollback=!1;foreground=!1;newAddedMessages=[];multiSuggestions=[];responses=[];status=RoundtripStatus.Analyzing;uuid;request;assistantMessageContent={};context={};reportedId="";systemNotificationService;toolTurns=[];quotaExceedMessage="";appliedRules=[];static extractPayloadFromSnapshot(e){return{...e.payload,id:e.id,query:e.payload?.query??""}}constructor(e,t,r,n,i,o){this.conversationId=e,this.repo=t,this.logger=r,this.virtualEditor=n,this.updateWebviewMessages=i;const s=this.virtualEditor.getActiveDocument();this.request=new UserRequestMessage(o.id,o,s),this.uuid=crypto$8.randomUUID(),this.systemNotificationService=SystemNotificationService.getInstance(),this.systemNotificationService.setVirtualEditor(n),this.updateNotificationConfig(),kernel.config.onDidChangeConfig("enableNotification",(()=>{this.updateNotificationConfig()}))}updateNotificationConfig(){const e=kernel.config.enableNotification??!0;this.systemNotificationService.setEnabled(e)}get inProgress(){return this.status===RoundtripStatus.Generating||this.status===RoundtripStatus.Analyzing}get textMessages(){return this.responses.filter((e=>e instanceof TextMessage))}get toolCallMessages(){return this.responses.filter((e=>e instanceof ToolCallMessage&&!e.discard))}discardMessagesAfterRetryMessageId(e){const t=this.responses.findIndex((t=>t.retryMessageId===e));for(const[e,r]of this.responses.entries())e>t&&(r.discard=!0)}discard=!1;appendTextResponse(e,t,r=""){if(!this.inProgress||!e)return;const n=t?.replace?"replaceText":"appendText",i=this.getLatestProgressTextMessage();if(i)return void i[n](e);const o=this.createNewTextMessage();r&&(o.parentMessageId=r),o[n](e)}async appendReasonResponse(e,t,r,n=""){if(this.status!==RoundtripStatus.Generating)return;if(!t&&r){const t=this.getLatestReasonMessage(e);return void(t&&t.inProgress&&(t.end(),this.updateWebviewMessages()))}if(!t)return;const i=this.getLatestReasonMessage(e);if(i)return void(i.inProgress&&(i.appendText(t),r&&i.end(),this.updateWebviewMessages()));const o=new ReasonMessage(e,"",Date.now(),Date.now());n&&(o.parentMessageId=n),this.addNewMessage(o),o.appendText(t),this.updateWebviewMessages()}async appendTodoResponse(e,t,r,n=""){if(this.status!==RoundtripStatus.Generating)return;let i=new TodoMessage(e);if(n&&(i.parentMessageId=n),r){const r=this.getLatestTodoMessage(e);r||this.addNewMessage(i),i=r||i,await i.update(t)}else this.addNewMessage(i);this.updateWebviewMessages()}async appendToolCallResponse(e,t){if(this.status!==RoundtripStatus.Generating)return;const{eventType:r,...n}=e,i=this.getLatestProgressToolCallMessage();switch(r){case"TOOL_CALL_END":i?.startWorkflow();break;case"TOOL_CALL_START":await this.createNewToolCallMessage(n,t);break;case"TOOL_CALL_ABORT":i?.abort();break;case"TOOL_CALL_CREATE":(await this.createNewToolCallMessage(n,t)).startWorkflow();break;case"TOOL_CALL_PARAMS_MERGE":await(i?.mergeParams(e.params));break;case"TOOL_CALL_PARAMS_APPEND":await(i?.appendParamContent(e.params))}}async appendNotificationResponse(e,t){this.status===RoundtripStatus.Generating&&"compression"===e.detail.type&&await this.handleCompressionNotification(e.detail,t)}setAssistantMessageContent(e){this.assistantMessageContent=e}getLatestMessage(){return this.responses[this.responses.length-1]}getLatestToolCallMessage(){const e=this.getLatestMessage();return e instanceof ToolCallMessage?e:void 0}getLastToolTurnTools(){for(let e=this.toolTurns.length-1;e>=0;e--){const t=this.toolTurns[e];if(!t.discard)return t.tools}return[]}getAllToolTurnTools(){return this.toolTurns.filter((e=>!e.discard)).flatMap((e=>e.tools))}findTool(e){return this.getAllToolTurnTools().find((t=>t.toolId===e))}toMessages(){const e=[],t={...this.request.toMessage(),discard:!!this.discard,context:this.context,disabledRollback:!!this.disabledRollback,appliedRules:this.appliedRules.map((({content:e,...t})=>t))};!this.request.payload.query&&!this.request.payload.selfDefineInstruction||e.push(t);const r=this.request.payload.agent;let n=[];n=this.v2?this.toolTurns.map((e=>e.toMessage())):this.responses.filter((e=>!e.discard)).map((e=>e.toMessage()));const i={id:this.uuid,v2:!!this.toolTurns.length,quotaExceedMessage:this.quotaExceedMessage,discard:!!this.discard,userMessageId:this.request.uuid,reportedId:this.reportedId,agentInfo:r?{avatar:r.agentImage,name:r.agentName}:void 0,role:"assistant",status:this.roundtripStatus2MessageStatus(),tokenUsage:this.tokenUsage,content:this.assistantMessageContent,elements:n};return e.push(i),e}roundtripStatus2MessageStatus(){switch(this.status){case RoundtripStatus.Analyzing:case RoundtripStatus.Generating:return AgentMessageStatus.InProgress;case RoundtripStatus.Compressing:return AgentMessageStatus.Compressing;case RoundtripStatus.Completed:return AgentMessageStatus.Success;case RoundtripStatus.Cancelled:return AgentMessageStatus.Cancelled;case RoundtripStatus.Failed:return AgentMessageStatus.Failed}}toJSON(){return{payload:this.request.payload,elements:this.responses.map((e=>e.toJSON()))}}rebuildV2(e,t,r){const n=(e.elements??[]).map((e=>ToolTurn.rebuild(e,t,r)));this.toolTurns.push(...n),this.discard=!!e.discard,this.status=e.status===RoundtripStatus.Completed||e.status===RoundtripStatus.Failed?e.status:RoundtripStatus.Cancelled}rebuild(e){const t=e.elements??[];for(const e of t)if(e.type===MessageType.Text){const t=TextMessage.createFromSnapshot(this.conversationId,this.virtualEditor,this.repo,this.logger,e);this.responses.push(t)}else if(e.type===MessageType.ToolCall){const t=ToolCallMessage.createFromSnapshot(this.conversationId,this.virtualEditor,this.repo,this.logger,e,(()=>this.updateWebviewMessages()),this.uuid);this.responses.push(t)}else if(e.type===MessageType.REASON){const t=ReasonMessage.createFromSnapshot(e);t.status="success"===e.status?e.status:AgentMessageStatus.Cancelled,this.responses.push(t)}else if(e.type===MessageType.TODO){const t=TodoMessage.createFromSnapshot(e);this.responses.push(t)}this.status=e.status===RoundtripStatus.Completed||e.status===RoundtripStatus.Failed?e.status:RoundtripStatus.Cancelled,this.setAssistantMessageContent(e.content??{}),this.editToolCount=this.responses.filter((e=>e instanceof ToolCallMessage&&EDIT_WORKFLOW_TYPES.has(e.toMessage().toolName))).length}complete(){this.ensureAllMessageFinished(!0),this.status===RoundtripStatus.Generating&&(this.status=RoundtripStatus.Completed,this.notifyTaskDone("success")),this.updateWebviewMessages()}cancel(){this.status!==RoundtripStatus.Generating&&this.status!==RoundtripStatus.Analyzing||(this.status=RoundtripStatus.Cancelled);for(const e of this.responses)e.cancel();this.newAddedMessages=[]}fail(e){const t=this.getLatestMessage();e&&this.appendErrorMessage(e,t?.parentMessageId);for(const e of this.responses)e.fail();this.ensureAllMessageFinished(!1),this.status!==RoundtripStatus.Generating&&this.status!==RoundtripStatus.Analyzing||(this.status=RoundtripStatus.Failed,this.notifyTaskDone("failed")),this.updateWebviewMessages()}quotaTip(e){const t=this.getLatestMessage();e&&this.appendErrorMessage(e,t?.parentMessageId),this.updateWebviewMessages()}resolveNewAddedMessages(){this.ensureToolCallMessageWorkflowStarted(),this.updateWebviewMessages({forceUpdate:!0});const e=this.newAddedMessages;return this.newAddedMessages=[],e}getComposerTasks(e){const t=e?this.responses.filter((e=>e instanceof ToolCallMessage&&!e.discard)).filter((t=>t.uuid===e)):this.responses.filter((e=>e instanceof ToolCallMessage&&!e.discard));return t.map((e=>e.composer.tasks.filter((e=>e.completed)))).flat()}getTextMessage(e){if(e)return this.textMessages.find((t=>t.uuid===e))}getToolCallMessage(e){if(e)return this.toolCallMessages.find((t=>t.uuid===e))}setForeground(e){this.foreground=e,this.textMessages.forEach((t=>t.composer.setForeground(e))),this.toolCallMessages.forEach((t=>t.workflow.setForeground(e)))}ensurePreviousMessageWorkflowStarted(){const e=this.getLatestProgressToolCallMessage();e&&e.workflow.isInitializing&&(e.workflow.markStartedWithIncompleteParams(),e.startWorkflow())}async updateTextMessageComposerStatus(){for(const e of this.textMessages)await e.updateComposerStatus()}updateWebSearchResult(e){const t=_$H.findLast(this.responses,(e=>e instanceof ToolCallMessage&&"web_search"===e.workflow.type&&e.workflow.status===WorkflowStatus.RUNNING));if(t){t.workflow.update(e),t.end()}}setNewAddMessageParentMessageId(e){this.newAddedMessages.forEach((t=>{t.parentMessageId=e}))}getLatestProgressTextMessage(){const e=this.getLatestMessage();return e instanceof TextMessage&&e.inProgress?e:void 0}getLatestReasonMessage(e){return findLast(this.responses,(t=>t instanceof ReasonMessage&&t.id===e))}getLatestTodoMessage(e){return findLast(this.responses,(t=>t instanceof TodoMessage&&t.id===e))}getLatestProgressToolCallMessage(){const e=this.getLatestMessage();return e instanceof ToolCallMessage&&e.inProgress?e:void 0}addNewMessage(e){this.ensurePreviousMessageWorkflowStarted(),this.responses.push(e),this.newAddedMessages.push(e)}async createNewToolCallMessage(e,t){const{name:r,params:n,...i}=e;r&&EDIT_WORKFLOW_TYPES.has(r)&&this.editToolCount++;const o={...t,messageId:this.uuid,repo:this.repo,virtualEditor:this.virtualEditor,conversationId:this.conversationId,updateWebviewMessages:e=>this.updateWebviewMessages(e)},s=new ToolCallMessage(this.conversationId,this.repo,this.logger,this.virtualEditor,o,r,n,i);return n&&await s.workflow.setParams(n),s.workflow.setForeground(this.foreground),this.addNewMessage(s),s}createNewTextMessage(){const e=new TextMessage(this.conversationId,this.virtualEditor,this.repo,this.logger);return e.composer.setForeground(this.foreground),this.addNewMessage(e),e}ensureToolCallMessageWorkflowStarted(){for(const e of this.responses)e instanceof ToolCallMessage&&e.workflow.isInitializing&&(e.workflow.markStartedWithIncompleteParams(),e.startWorkflow())}ensureAllMessageFinished(e){for(const t of this.responses)t instanceof TextMessage?(t.composer.tasks.forEach((e=>!0!==e.finish&&e.cancel())),t.inProgress&&t.markStatus(e?AgentMessageStatus.Success:AgentMessageStatus.Failed)):t instanceof ToolCallMessage?(t.composer.tasks.forEach((e=>!0!==e.finish&&e.cancel())),t.workflow instanceof WebSearchWorkflow||(t.workflow.cancel(),t.inProgress&&t.markStatus(e?AgentMessageStatus.Success:AgentMessageStatus.Failed))):t instanceof ReasonMessage&&t.inProgress&&t.markStatus(e?AgentMessageStatus.Success:AgentMessageStatus.Failed)}appendErrorMessage(e,t=""){const r=new TextMessage(this.conversationId,this.virtualEditor,this.repo,this.logger);t&&(r.parentMessageId=t),r.composer.setForeground(this.foreground),r.isErrorMessage=!0,this.responses.push(r),r.originalContent=e,r.content=e,r.end()}async updateAcceptSuggestions(e){const t=this.toolCallMessages.filter((e=>e.composer.tasks[0]instanceof EditComposerTask&&e.composer.tasks[0].completed)),r={};for(const e of t){const t=e.composer.tasks[0];r[t.key]={filePath:t.key,originalContent:r[t.key]?.originalContent||t.originalContent||"",modifiedContent:t.content,accepted:t.accepted===AcceptState.ACCEPT}}const n=this.textMessages,i=[],o=Object.values(r).length;for(const t of n){const r=t.content,n=await extractCodeBlocks$1(r);n.length&&i.push(...n.map((({lang:t,content:r},n)=>({id:String(o+i.length+n),lang:t,path:e.path||this.request.activeDocumentPath||"agent.java",row:"1",col:"1",isCodeBlock:!0,generatedContent:codeBlock2TrimedGenerateLines(r),accepted:!1}))))}return this.multiSuggestions=Object.values(r).map((({filePath:e,accepted:t,originalContent:r,modifiedContent:n},i)=>{const o=createPatch(e,r,n).split(/\n/).slice(4).filter((e=>e.startsWith("+")||e.startsWith("-"))).join("\n");return{id:String(i),path:e,row:"1",col:"1",generatedContent:o,accepted:t}})).concat(i),this.logger.info(`[Zulu] reported ${this.multiSuggestions.length} suggestions successfully`),{suggestions:this.multiSuggestions,changes:r}}async updateAcceptSuggestionsV2(e){const t=_$H.flatten(this.toolTurns.map((e=>e.executedFsTools))),r={};for(const e of t){const t=e.result.metadata.absolutePath,n=e.result.metadata.originalContent,i=e.result.metadata.content;t&&(r[t]={filePath:t,originalContent:r[t]?.originalContent||n||"",modifiedContent:i,accepted:e.accepted})}const n=this.textMessages,i=[],o=Object.values(r).length;for(const t of n){const r=t.content,n=await extractCodeBlocks$1(r);n.length&&i.push(...n.map((({lang:t,content:r},n)=>({id:String(o+i.length+n),lang:t,path:e.path||this.request.activeDocumentPath||"agent.java",row:"1",col:"1",isCodeBlock:!0,generatedContent:codeBlock2TrimedGenerateLines(r),accepted:!1}))))}return this.multiSuggestions=Object.values(r).map((({filePath:e,accepted:t,originalContent:r,modifiedContent:n},i)=>{const o=createPatch(e,r,n).split(/\n/).slice(4).filter((e=>e.startsWith("+")||e.startsWith("-"))).join("\n");return{id:String(i),path:e,row:"1",col:"1",generatedContent:o,accepted:t}})).concat(i),this.logger.info(`[Zulu] reported ${this.multiSuggestions.length} suggestions successfully`),{suggestions:this.multiSuggestions,changes:r}}removeLineStartWithPrefix(e,t,r){const n=[];let i=0;for(;i<e.length;)r>0&&e[i].startsWith(t)?r--:n.push(e[i]),i++;return n}popLatestResponse(){const e=this.responses.pop();e instanceof ToolCallMessage&&EDIT_WORKFLOW_TYPES.has(e.toMessage().toolName)&&this.editToolCount--,this.responses.at(-1)instanceof ReasonMessage&&this.responses.pop()}updateSuggestionsByPath(e,t,r){return this.multiSuggestions=this.multiSuggestions.map((n=>{if(isFilePathEqual(n.path,e)&&!n.isCodeBlock){if(r){const e=n.generatedContent.split(/\n/),t=this.removeLineStartWithPrefix(this.removeLineStartWithPrefix(e,"+",r.addLines),"-",r.removeLines);return n.generatedContent=t.join("\n"),{...n,accepted:t.length>0}}return{...n,accepted:t===AcceptState.ACCEPT}}return n})),this.multiSuggestions}updateCodeBlockSuggestion(e){const t=codeBlock2TrimedGenerateLines(e);return this.multiSuggestions=this.multiSuggestions.map((e=>e.isCodeBlock&&e.generatedContent===t?{...e,accepted:!0}:e)),this.multiSuggestions}async replacePathsToMarkdownLinks(e){const t=this.newAddedMessages.filter(isTextMessage);await Promise.all(t.map((async t=>{t.content=await replacePathTextInMarkdown(t.content,e)})))}async handleCompressionNotification(e,t){const{data:r}=e;if(!r)return;const n=this.getLatestProgressToolCallMessage(),i=n&&"compress_message"===n.workflow.type,o="running"===r.status.toLowerCase();o&&!i?await this.createNewToolCallMessage({params:r,name:"compress_message"},t):!o&&i&&(await n.mergeParams(r),n.startWorkflow())}tokenUsage;async calculateTokenUsage(e,t){t&&await sleep$3(t);const r=await getTokenUsage(e);r&&(this.tokenUsage={...this.tokenUsage,usagePercentage:r.usagePercentage,contextUsed:r.contextUsed,contextLimit:r.contextLimit,needCompression:r.needCompression,savedPercentage:this.tokenUsage?.savedPercentage||0})}async compressTokenUsage(e){this.status=RoundtripStatus.Compressing,this.updateWebviewMessages({forceUpdate:!0});const t=await compressSessionTokenUsage(e),r=!t||"failed"===t?.status?t?.errorMessage||"压缩失败":"";this.tokenUsage={...this.tokenUsage,failReason:r,savedPercentage:t?.savedPercentage||0},this.status=RoundtripStatus.Completed,"success"===t?.status&&await this.calculateTokenUsage(e),this.updateWebviewMessages({forceUpdate:!0})}notifyTaskDone(e){this.systemNotificationService&&this.systemNotificationService.notifyTaskDone({workspaceName:this.getNotificationWorkspaceName(),summary:this.request.summary?.trim(),conversationTitle:this.resolveNotificationConversationTitle(),conversationId:this.conversationId,result:e})}notifyApprovalBlocked(e){if("use_mcp_tool"!==e.type)e.command&&this.systemNotificationService.notifyApprovalBlocked({workspaceName:this.getNotificationWorkspaceName(),kind:"run_command",conversationId:this.conversationId,command:e.command});else{if(!e.serverName||!e.toolName)return;this.systemNotificationService.notifyApprovalBlocked({workspaceName:this.getNotificationWorkspaceName(),kind:"use_mcp_tool",conversationId:this.conversationId,serverName:e.serverName,toolName:e.toolName})}}getNotificationWorkspaceName(){return path__default.basename(this.repo.rootPath)||"workspace"}resolveNotificationConversationTitle(){const e=this.request.payload?.query?.trim();if(e)return e;const t="command"in this.request.payload&&"string"==typeof this.request.payload.command?this.request.payload.command.trim():"";return t||void 0}toText(e=""){if(this.v2){return this.toolTurns.map((e=>e.toText())).join("\n\n")+"\n"+e}return""}}const nameMap=new Map([[24,["Sequoia","15"]],[23,["Sonoma","14"]],[22,["Ventura","13"]],[21,["Monterey","12"]],[20,["Big Sur","11"]],[19,["Catalina","10.15"]],[18,["Mojave","10.14"]],[17,["High Sierra","10.13"]],[16,["Sierra","10.12"]],[15,["El Capitan","10.11"]],[14,["Yosemite","10.10"]],[13,["Mavericks","10.9"]],[12,["Mountain Lion","10.8"]],[11,["Lion","10.7"]],[10,["Snow Leopard","10.6"]],[9,["Leopard","10.5"]],[8,["Tiger","10.4"]],[7,["Panther","10.3"]],[6,["Jaguar","10.2"]],[5,["Puma","10.1"]]]);function macosRelease(e){e=Number((e||os__default$1.release()).split(".")[0]);const[t,r]=nameMap.get(e)||["Unknown",""];return{name:t,version:r}}const names=new Map([["10.0.2","11"],["10.0","10"],["6.3","8.1"],["6.2","8"],["6.1","7"],["6.0","Vista"],["5.2","Server 2003"],["5.1","XP"],["5.0","2000"],["4.90","ME"],["4.10","98"],["4.03","95"],["4.00","95"]]);function windowsRelease(e){const t=/(\d+\.\d+)(?:\.(\d+))?/.exec(e||os__default$1.release());if(e&&!t)throw new Error("`release` argument doesn't match `n.n`");let r=t[1]||"";const n=t[2]||"";if((!e||e===os__default$1.release())&&["6.1","6.2","6.3","10.0"].includes(r)){let e;try{e=execaSync("wmic",["os","get","Caption"]).stdout||""}catch{e=execaSync("powershell",["(Get-CimInstance -ClassName Win32_OperatingSystem).caption"]).stdout||""}const t=(e.match(/2008|2012|2016|2019|2022/)||[])[0];if(t)return`Server ${t}`}return"10.0"===r&&n.startsWith("2")&&(r="10.0.2"),names.get(r)}function osName(e,t){if(!e&&t)throw new Error("You can't specify a `release` without specifying `platform`");let r;if("darwin"===(e=e??os__default$1.platform())){t||"darwin"!==os__default$1.platform()||(t=os__default$1.release());const e=t?Number(t.split(".")[0])>15?"macOS":"OS X":"macOS";try{if(r=t?macosRelease(t).name:"","Unknown"===r)return e}catch{}return e+(r?" "+r:"")}return"linux"===e?(t||"linux"!==os__default$1.platform()||(t=os__default$1.release()),r=t?t.replace(/^(\d+\.\d+).*/,"$1"):"","Linux"+(r?" "+r:"")):"win32"===e?(t||"win32"!==os__default$1.platform()||(t=os__default$1.release()),r=t?windowsRelease(t):"","Windows"+(r?" "+r:"")):e}function getOsName(){try{return osName()}catch{return os__default.platform()}}function getBaseSysInfo(){return{os:getOsName(),defaultShell:defaultShell,homeDir:os__default.homedir()}}function getDefaultSysInfo(e){return{...getBaseSysInfo(),defaultShell:"",installedCommands:[],notInstalledCommands:[],workspacePath:e}}async function getShellWithVersion(e){if(e.toLowerCase().includes("powershell"))try{const{stdout:t}=await execa("$PSVersionTable.PSVersion.ToString()",{shell:e,timeout:3e3});if(t&&t.trim())return`${e} (v${t.trim()})`}catch{}return e}function contentEqualRough(e,t){if("string"!=typeof e||"string"!=typeof t)return!1;const r=e.split(/\r?\n/),n=t.split(/\r?\n/);return r.length===n.length&&r.every(((e,t)=>e.trim()===n[t].trim()))}function equalFilePathOrUniqKey(e){return t=>!e||isFilePathEqual(t.key,e)}async function reportAbortedZuluMessage({messageId:e,reason:t,traceId:r}){try{await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/record",{messageId:e,reason:t,...getRequestClienInfo()},{headers:{...getRequestUserHeader(),"X-Trace-Id":r}})}catch(e){kernel.logger.error("zulu",e.message)}}const beautifyError=(e,t)=>{try{if(e instanceof Error){const r=e.message||e.errors.at(-1).message;if(/getaddrinfo EAI_AGAIN|getaddrinfo ENOTFOUND/i.test(r)){const e=r.match(/getaddrinfo (EAI_AGAIN|ENOTFOUND) (.*)/)?.[2];return t("kernel.zulu.error.network",e)}return/ECONNABORTED|ECONNRESET|ECONNREFUSED|socket hang up/i.test(r)?t("kernel.zulu.error.connAborted"):/ETIMEDOUT/i.test(r)?t("kernel.zulu.error.connTimeout"):/SSL.*ALERT|EPROTO|TLS/i.test(r)?t("kernel.zulu.error.tls"):/certificate/i.test(r)?t("kernel.zulu.error.certificate"):"aborted"===r?t("kernel.zulu.error.aborted"):r}return""}catch{return""}};function forEachRollbackToolTurn(e,t,r,n){const i=t?e.findIndex((e=>e.request.uuid===t)):e.findIndex((e=>e.toolTurns[0]?.match(r)));if(-1!==i)return e.slice(i).forEach((e=>{e.toolTurns.forEach((e=>n(e)))})),!0;const o=e[e.length-1];if(!o)return!1;const s=o.toolTurns,a=s.findIndex((e=>e.match(r)));return-1!==a&&(s.slice(a).forEach((e=>{n(e)})),!0)}const removeDiscardMsgAfterConsumed=async(e,t)=>{const r=await t.find(e),n=r.messages.map((e=>{if(e.discard)return null;if("assistant"===e.role){const t=e.elements.findIndex((e=>e.discard));return-1===t?e:{...e,elements:e.elements.slice(0,t)}}return e}));await t.save({...r,messages:n.filter(Boolean)})},{isEqual:isEqual,omit:omit}=_$H;class ConversationThread extends AbstractConversation{foreground=!1;roundtrips=[];lastUpdatedMessage=null;get latestRoundtrip(){return this.roundtrips[this.roundtrips.length-1]}get previousRoundtrip(){let e=this.roundtrips.length-2;for(;this.roundtrips[e]?.discard&&e>=0;)e--;return this.roundtrips[e]}getRoundtripByMessageId(e){return this.roundtrips.find((t=>t.uuid===e||t.request.uuid===e))}getConversationTitle(){const e=this.roundtrips[0]?.request;return e?.summary||e?.payload.query||""}async onConversationMessage(e){switch(this.logger.info("onConversationMessage",e),e.messageType){case"add-message":this.startNewWork(e.payload);break;case"stop-generating":await this.stopGenerating();break;case"message-operation":{const t=await this.handleNewMessage(e?.payload);return this.updateLatestMessage(!0),t}case"quota-exceed":{const t=e?.payload,r=this.startRoundtrip(t);r.v2?(await this.handleNewMessage({action:"quota-exceed",...t}),this.updateAllMessages()):r.fail(t?.quotaAction),this.updateStatus(AgentConversationStatus.Failed);break}case"refresh-messages":this.updateAllMessages()}}async startNewWork(e,t){this.logger.info("startNewWork",e),t&&this.logger.info(`isQuotaFallbackAuto: ${!!t}`);const r=t||this.startRoundtrip(e);this.updateStatus(AgentConversationStatus.Running),this.updateAllMessages();try{this.beforeStartWork(),await this.startWork(r),r.complete();const t=await this.onRoundtripComplete();if(t?.followup)return void await this.startNewWork({...e,query:t.followup});if(this.status===AgentConversationStatus.Cancelled)return void this.afterStartWork();if(this.latestRoundtrip.uuid!==r.uuid)return;this.updateStatus(AgentConversationStatus.Completed),this.afterStartWork()}catch(n){if(n instanceof ResourceUsageOverlimitError$1&&!t)try{const t=JSON.parse(n.message);if(t?.autoModel)return r.request.payload.model={displayName:"Auto",modelId:t.autoModel,requestType:"COMATE_DEFAULT_MODE",mode:"NORMAL"},void await this.startNewWork(e,r);r.quotaTip(JSON.stringify(t.userActions))}catch{this.logger.info("autoModelContinue failed")}if(this.afterStartWork(),reportAbortedZuluMessage({reason:n.message,messageId:r.context.userMessageId,traceId:this.id}),n instanceof CanceledError)return;if(axios.isAxiosError(n)&&n.response&&kernel.logger.error("Zulu",`Status: ${n.response.status} Headers: ${JSON.stringify(n.response.headers)} Data: ${JSON.stringify(n.response.data)}`),n instanceof AuthenticationError)return r.fail(n.message),void this.updateStatus(AgentConversationStatus.Failed);if(n instanceof Error){const e=n.message;this.type===AgentConversationType.AgentConversation&&!e.startsWith("{")&&!(n instanceof ReadWorkspacePermissionError)&&e.length<1e3&&this.logger.logUploader?.logUserAction({category:"new-agent",action:"abortConversation",label:n.message,content:this.id});if(/[\u4E00-\u9FA5]/.test(n.message))return r.fail(n.message),void this.updateStatus(AgentConversationStatus.Failed)}if(this.logger.error("[Zulu] failed create conversaion, reason:",n.message,n),this.latestRoundtrip.uuid!==r.uuid)return;r.fail(beautifyError(n,kernel.t)||kernel.t(ZuluText.GENERATE_ERROR)),this.updateStatus(AgentConversationStatus.Failed)}}async reportZuluError(e){}previousRollbackSummary=[];async getRollbackSummary({userMessageId:e,retryMessageId:t}){const r=e?this.roundtrips.findIndex((t=>t.request.uuid===e)):this.roundtrips.length-1,n=this.roundtrips.slice(r,this.roundtrips.length).reduce(((e,r)=>{const n=t?r.toolCallMessages.findIndex((e=>e.uuid===t)):-1,i=r.toolCallMessages.slice(n+1,r.toolCallMessages.length);for(const t of i){const r=t?.composer.tasks[0];if(r&&r.completed&&r.accepted===AcceptState.ACCEPT){const t=e.find((e=>e.absolutePath===r.absolutePath));t?t.changes.push(r):e.push({absolutePath:r.absolutePath,relativePath:r.filePath,action:r.rollbackAction,selected:!0,changes:[r]})}}return e}),[]);for(const e of n){const{absolutePath:t,changes:r,action:n}=e;if("willDelete"===n);else if("willCreate"===n){const{existed:r}=await this.virtualEditor.getDocument({absolutePath:t});r&&(e.conflict=!0,e.selected=!1)}else if("willChange"===n){const{content:n,existed:i}=await this.virtualEditor.getDocument({absolutePath:t});i||(e.action="willCreate");r.some((e=>contentEqualRough(e.content,n)))||(e.conflict=!0,e.selected=!1)}}return this.previousRollbackSummary=n,n}async getRollbackSummaryV2(e){if(!e)return[];const t=[];forEachRollbackToolTurn(this.roundtrips,void 0,e,(e=>t.push(...e.acceptedFsTools)));const r=t.reduce(((e,t)=>{const r=t.result?.metadata?.absolutePath,n=t.result?.metadata?.content,i=t.result?.metadata?.originalContent,o=t.result?.metadata?.relativePath;if(r){const s=e.find((e=>e.absolutePath===r)),a={absolutePath:r,relativePath:o,content:n,originalContent:i,rollbackAction:t.rollbackActionName,rollback:()=>t.toolHandler.revert()};s?s.changes.push(a):e.push({absolutePath:r,relativePath:o,action:t.rollbackActionName,selected:!0,changes:[a]})}return e}),[]);for(const e of r){const{absolutePath:t,changes:r,action:n}=e;if("willDelete"===n);else if("willCreate"===n){const{existed:r}=await this.virtualEditor.getDocument({absolutePath:t});r&&(e.conflict=!0,e.selected=!1)}else if("willChange"===n){const{content:n,existed:i}=await this.virtualEditor.getDocument({absolutePath:t});i||(e.action="willCreate");r.some((e=>contentEqualRough(e.content,n)))||(e.conflict=!0,e.selected=!1)}}return this.previousRollbackSummary=r,r}async openRollbackDiff(e){const t=this.previousRollbackSummary.find((t=>e===t.absolutePath)),r=t?.changes[0],{content:n}=await this.virtualEditor.getDocument({absolutePath:e});await this.virtualEditor.openVirtualDiffDocument({absolutePath:e,content:n,modified:r.originalContent||"",source:AgentConversationType.E2EBotConversation,action:VirtualDocumentAction.PREVIEW})}async rollbackAllFileChanges(e){for await(const t of this.previousRollbackSummary)if(e.includes(t.absolutePath)){const e=this.previousRollbackSummary.find((({absolutePath:e})=>e===t.absolutePath));await(e?.changes[0].rollback())}}rollbackMessageId;async executeRollback({userMessageId:e,retryMessageId:t},r){try{await this.rollbackAllFileChanges(r);const n=e;if(t){const e=this.roundtrips[this.roundtrips.length-1];e?.discardMessagesAfterRetryMessageId(t),this.rollbackMessageId=t}else if(n){const t=this.roundtrips.findIndex((t=>t.request.uuid===e));if(0===t)this.roundtrips.length=0,await this.chatSessionManager.delete(this.id);else{const e=this.roundtrips.slice(t,this.roundtrips.length);e.forEach((e=>{e.discard=!0}));const r=e[0];this.rollbackMessageId=r.responses[0]?.retryMessageId}}this.updateAllMessages()}catch(e){return{error:e.message}}}async getRollbackMessageId(){return this.rollbackMessageId}toMessages(){const e=this.roundtrips.map((e=>e.toMessages())).flat(),t=e.map((e=>{if("assistant"===e.role){const t=(e.elements??[]).map((t=>e.v2?ToolTurn.omitUnnecessaryFields(t):{...omit(t,"workflowSnapshot","params")}));return{...e,elements:t}}return e}));return{processedMessages:e,webviewMessages:t}}toJSON(){return this.roundtrips.map((e=>e.toJSON())).flat()}setForeground(e){this.foreground=e}startRoundtrip(e){const t=new Roundtrip(this.id,this.repo,this.logger,this.virtualEditor,(e=>this.updateMessageByStrategy(e)),e);return t.v2=this.type===AgentConversationType.AgentConversation,t.request.generateQuerySummary((e=>{this.afterGenerateQuerySummary(e,t)})),t.setForeground(this.foreground),this.roundtrips.push(t),t}async stopGenerating(){!1!==await this.beforeStop()&&(this.logger.info("stopGenerating"),this.latestRoundtrip?.cancel(),this.afterStop&&await this.afterStop(),this.updateLatestMessage(!0),this.updateStatus(AgentConversationStatus.Cancelled))}rebuildRollbackMessageId(e){const t=e.find((e=>"assistant"===e.role&&!!e.discard));if(t)return t.elements.find((e=>"TOOL_CALL"===e.type))?.id;const r=e[e.length-1].elements.find((e=>"TOOL_CALL"===e.type&&e.discard));return r?r.id:void 0}rebuildRoundtrips(e,t,r){let n=null;this.rollbackMessageId=this.rebuildRollbackMessageId(e);for(const i of e)"user"===i.role?(n=new Roundtrip(this.id,this.repo,this.logger,this.virtualEditor,(e=>this.updateMessageByStrategy(e)),Roundtrip.extractPayloadFromSnapshot(i)),n.v2=this.type===AgentConversationType.AgentConversation,n.context=i.context??{},n.appliedRules=i.appliedRules??[],n.request.setSummary(i.summary??""),n.disabledRollback=i.disabledRollback,this.roundtrips.push(n)):"assistant"===i.role&&n&&(i.v2?n.rebuildV2(i,t,r):n.rebuild(i),n.quotaExceedMessage=i.quotaExceedMessage||"",n.tokenUsage=i.tokenUsage,n.reportedId=i.reportedId,n=null)}getToolMessage(e){for(const t of this.roundtrips){const r=t.getToolCallMessage(e);if(r)return r}return null}getConversationToolCallMessages(){const e=[];for(const t of this.roundtrips)e.push(...t.toolCallMessages);return e}updateAllMessages(){const{processedMessages:e,webviewMessages:t}=this.toMessages();this.doUpdateAllMessages(e,t)}updateMessageByStrategy(e){e?.elementId?this.forceUpdateMessageElement(e.elementId):this.updateLatestMessage(e?.forceUpdate)}updateLatestMessage(e=!1){const{processedMessages:t,webviewMessages:r}=this.toMessages(),n=r[r.length-1];if(!n)return void this.doUpdateAllMessages(t,r);const i=e?{scope:"message",message:n}:this.getMessageUpdateOptions(n);this.lastUpdatedMessage=n,"elements"===i.scope&&0===i.messageData.elements.length||this.onMessageChange(this.id,t,i)}forceUpdateMessageElement(e){const{processedMessages:t,webviewMessages:r}=this.toMessages(),n=r.find((t=>"assistant"===t.role&&t.elements.some((t=>t.id===e))));if(!n)return;const i=n.elements.find((t=>t.id===e));if(!i)return;const o={scope:"elements",messageData:{id:n.id,elements:[i]}};this.onMessageChange(this.id,t,o)}deriveConversationStatus(){const e=this.latestRoundtrip;if(!e)return AgentConversationStatus.Ready;switch(e.status){case RoundtripStatus.Analyzing:case RoundtripStatus.Generating:case RoundtripStatus.Compressing:return AgentConversationStatus.Running;case RoundtripStatus.Failed:return AgentConversationStatus.Failed;case RoundtripStatus.Cancelled:return AgentConversationStatus.Cancelled;case RoundtripStatus.Completed:return AgentConversationStatus.Completed;default:return AgentConversationStatus.Ready}}doUpdateAllMessages(e,t){this.onMessageChange(this.id,e,{scope:"conversation",messages:t})}getMessageUpdateOptions(e){const t={scope:"message",message:e};if(!this.lastUpdatedMessage||this.lastUpdatedMessage.id!==e.id)return t;if("assistant"!==this.lastUpdatedMessage.role||"assistant"!==e.role)return t;if(!isEqual(omit(this.lastUpdatedMessage,"elements"),omit(e,"elements")))return t;const r=e.elements,n=this.lastUpdatedMessage.elements,i=r.some(((e,t)=>!n[t]||n[t].id!==e.id));if(i)return t;const o=[];for(let e=0;e<r.length;e++){const t=r[e],i=n[e];isEqual(t,i)||o.push(t)}return{scope:"elements",messageData:{id:e.id,elements:o}}}beforeStartWork(){}afterStartWork(){}beforeStop(){return Promise.resolve()}onRoundtripComplete(){return Promise.resolve(null)}afterStop(){return Promise.resolve()}afterGenerateQuerySummary(e,t){}}async function filterCommandFromPathOutput(e,t){const r=e.split(/\r?\n/).map((e=>e.split(sep$3))).filter((e=>e.length>1)).map((e=>e.pop()));return t.filter((e=>r.find((t=>t===e||t===`${e}.exe`))))}async function filterSupportedCommandWindows(e,t){const{stdout:r="",stderr:n=""}=await execa("where",e,{cwd:homedir$1(),shell:t,reject:!1,timeout:3e3});return filterCommandFromPathOutput(`${r}\n${n}`,e)}async function filterSupportedCommandUnix(e,t){const{stdout:r="",stderr:n=""}=await execa("command",["-v",...e],{cwd:homedir$1(),shell:t,reject:!1,timeout:3e3});return filterCommandFromPathOutput(`${r}\n${n}`,e)}async function filterSupportedCommand(e){try{const t=kernel.env.ideTerminalInfo?.defaultShell??defaultShell,r="win32"===os__default.platform()?await filterSupportedCommandWindows(e,t):await filterSupportedCommandUnix(e,t);return{notInstalledCommands:e.filter((e=>!r.includes(e))),installedCommands:r}}catch(e){return{installedCommands:[],notInstalledCommands:[]}}}const THROTTLE_DELAY=500,sleep$1=e=>new Promise((t=>setTimeout(t,e)));async function*throttleAsyncIterator(e,t=THROTTLE_DELAY){let r=0,n=[],i=await e.next();for(;!i.done;){n.push(i.value);const o=Date.now();o-r>=t&&(yield n,n=[],r=o);const s=e.next();!await Promise.race([s,sleep$1(t)])&&n.length&&(yield n,n=[],r=Date.now()),i=await s}n.length&&(yield n)}const{flow:flow}=_$H;class ExceptionAbortedError extends Error{chatParams;err;retryMessageId;constructor(e,t,r){super(t.message),this.chatParams=e,this.err=t,this.retryMessageId=r}}const safeJSONParse=e=>{try{return JSON.parse(e)}catch(e){return""}},assignPromptVersion=e=>({...e,extend:{...e.extend,promptVersion:9}}),isSpecAskApprovalQuery=e=>{if(!e.toolUseResults)return!1;const t=e.toolUseResults[0];if(!t)return!1;const r="write_file"===t.name||"patch_file"===t.name,n=!(!t.result?.query&&!t.result?.stage);return r&&n},omitRecursiveUselessParams=e=>{if(e.toolUseResults?.length||e.taskInfo){const t=isSpecAskApprovalQuery(e);return{...e,rollbackMessageId:t?e.rollbackMessageId:void 0,messageId:void 0,selfDefineInstruction:"",query:"",codeChunks:e.codeChunks?.filter((e=>"rule"===e.type)),knowledgeList:[],isCurrentFileSelected:e.isCurrentFileSelected}}return e},reformatContexts=e=>({...e,contexts:reformatKnowledgeContextType(e.contexts)}),assignParams=flow([assignPromptVersion,reformatContexts,omitRecursiveUselessParams]);async function*chat({username:e,cancelToken:t,agentInfo:r,...n}){process.env.ZULU_QUERY_DELAY&&await sleep$4(Number(process.env.ZULU_QUERY_DELAY||0));const i=n.analyze.traceId;let o="";const s=n.subAgents.find((e=>e.agentName===n.taskInfo?.subagent)),a=n.taskInfo?s:r;try{let e=n.taskId||n.analyze.taskId;n.taskInfo&&e&&(e=await createSubagentTask({traceId:i,cancelToken:t,agentInfo:{agentId:a.isProjectAgent?void 0:a.agentId,agentName:a.agentName,isProjectAgent:!!a.isProjectAgent},taskInfo:n.taskInfo,taskId:e}));const r=await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/chat/stream",{...assignParams(n),...getRequestClienInfo(),slash:"Composer",taskId:e,agentInfo:a,agentId:a.isProjectAgent?void 0:a.agentId,incremental:!0},{headers:{...getRequestUserHeader(),"X-Trace-Id":i},timeout:36e5,responseType:"stream",cancelToken:t}),s=new SSEProcessor(r.data,safeJSONParse);let c="",l=!1,A=!1;for await(const t of s.processSSE()){if(t.taskId=e,t.agentInfo=a,o=t.content.detail.retryMessageId,"EXCEPTION"===t.content.type)throw new InternalServerError$1(t.content.detail.exceptionMsg);"NOTIFICATION"!==t.content.type?(t.content.detail.planDelta||t.content.detail.reasoningDelta||t.content.detail.delta||t.content.detail.toolUse)&&(A&&(t.content.uriMetas=void 0),Array.isArray(t.content.uriMetas)&&(A=!0),l||!t.content.detail.planDelta&&!c?(t.content.detail.planDelta="",yield t):t.content.detail.planEnd?(t.content.detail.planDelta=c+t.content.detail.planDelta,c="",l=!0,yield t):t.content.detail.planDelta&&(c||(yield t),c+=t.content.detail.planDelta)):yield t}}catch(i){if(!o||i instanceof CanceledError)throw i;throw new ExceptionAbortedError({username:e,cancelToken:t,agentInfo:r,...n},i,o)}}class Agent{basePath;relativePath;metadata;content;id;constructor(e,t,r,n){this.basePath=e,this.relativePath=t,this.metadata=r,this.content=n;try{const r=statSync$2(join$7(e,t));this.id=-1*r.birthtimeMs}catch{this.id=-1*Date.now()}}get absolutePath(){return join$7(this.basePath,this.relativePath)}getAgentId(){return this.id}setAgentId(e){this.id=e}static pickTaskProperties(e,t){const r=_$H.keyBy(t,"serverName"),n=Array.isArray(e.mcpInfos)?e.mcpInfos.filter((e=>r[e])).map((e=>r[e])):[];return{..._$H.pick(e,["agentName","agentImage","description","agentPrompt"]),isProjectAgent:!!e.isProjectAgent,agentId:e.isProjectAgent?void 0:e.agentId,mcpInfos:n}}toString(){return matter$1.stringify(this.content,_$H.pickBy(this.metadata,(e=>Array.isArray(e)?e.length>0:"boolean"==typeof e?!1===e:!!e)))}toJSON(){return{agentId:this.id,isProjectAgent:this.isProjectAgent,relativePath:this.relativePath,agentName:this.metadata.name.trim(),description:this.metadata.description,agentImage:this.metadata.icon,agentPrompt:this.content,visibility:this.visibility,subAgents:[],mcpInfos:Array.isArray(this.metadata.mcpServers)?this.metadata.mcpServers:[],parentAgents:Array.isArray(this.metadata.parentAgents)?this.metadata.parentAgents:[],reportAgentName:this.reportAgentName,absolutePath:this.absolutePath}}async ensureAgentDir(){await lib$f.ensureDir(join$7(this.basePath,"agents"))}async save(){const e=join$7(this.basePath,this.relativePath);await this.ensureAgentDir(),await writeFile$2(e,this.toString()),this.id=-1*statSync$2(e).birthtimeMs}update(e,t){this.metadata=e,this.content=t}static async readAgentsFromPath(e,t,r){const n=await globby(t,{cwd:e});kernel.logger.info(`Found agents in ${e}: ${n.join(",")}`);const i=await Promise.all(n.map((async t=>{try{const n=await readFile$4(join$7(e,t),"utf-8"),{data:i,content:o}=matter$1(n);return i.name?r(e,t,i,o):null}catch(e){return kernel.logger.info(`Failed to read agent ${t}: ${e}`),null}})));return i.filter((e=>null!==e)).sort(((e,t)=>t.getAgentId()-e.getAgentId()))}static async deleteAgent(e,t){try{await rm$1(join$7(e,t))}catch{}}}class ProjectAgent extends Agent{agentGlob=".comate/agents/**.md";isProjectAgent=!0;reportAgentName="PROJECT_AGENT";visibility="PUBLIC";constructor(e,t,r,n){super(e,t,r,n)}static async find(e,t){return(await this.readFromWorkspace(e)).find((e=>e.toJSON().agentName===t))}static async write(e,t){const r=t.relativePath??join$7(".comate","agents",t.agentName+".md"),n=new ProjectAgent(e,r,{name:t.agentName,enable:"boolean"!=typeof t.enable||t.enable,description:t.description,icon:t.agentImage,tools:Array.isArray(t.tools)?t.tools:[],mcpServers:Array.isArray(t.mcpInfos)?t.mcpInfos:[],parentAgents:Array.isArray(t.parentAgents)?t.parentAgents:[]},t.agentPrompt);return await n.save(),n.toJSON()}static async delete(e,t){await Agent.deleteAgent(e,t)}static async update(e,t,r){const n=await this.find(e,t.name);if(n)return n.update(t,r),await n.save(),n;{const n=join$7(".comate","agents",`${t.name}.md`),i=new ProjectAgent(e,n,t,r);return await i.save(),i}}static async readFromWorkspace(e){return Agent.readAgentsFromPath(e,".comate/agents/**.md",((e,t,r,n)=>new ProjectAgent(e,t,r,n)))}}class AgentStatistics{contexts=[];tools=[];appendContexts(e){const t=e.filter((e=>e.type!==ContextType.RULE)).map((e=>_$H.pick(e,["id","name","type"])));this.contexts.push(...t)}appendRuleContexts(e){const t=e.map((e=>{const{path:t,subType:r}=e.toJSON();return{id:t,name:t,type:ContextType.RULE,subType:r}}));this.contexts.push(...t)}appendTool(e){if(isExtractContentBlocks(e))for(const t of e.displayResult.fileBlocks)isComateOrCursorRulePath(t.path)&&this.contexts.push({id:t.path,name:t.path,type:ContextType.RULE,subType:"readedRule"});this.tools.push({tool:e.type,params:_$H.pick(e.params,e.identityParamKeys)})}export(e){const t={agentContexts:[...this.contexts],agentTools:[...this.tools],assistantContent:e.v2?e.toText():e.textMessages.map((e=>e.content)).join("\n\n")};return this.contexts=[],this.tools=[],t}}const COMMON_COMMANDS=["python","python3","pip","pip3","go","docker","curl","ffmpeg","brew","pip","jq","nuget"];class E2EBotConversation extends ConversationThread{codeWrittenMetric;type=AgentConversationType.E2EBotConversation;inlineDiffView=!0;status=AgentConversationStatus.Ready;cancelTokenSource=createAxiosCancelTokenSource();mcpManager;previewProxyServerManager;quotaService;statistics=new AgentStatistics;specEditor;constructor(e,t,r,n){super(e),this.codeWrittenMetric=n,this.quotaService=iocContainer.get(QuotaService),this.mcpManager=t,this.status=AgentConversationStatus.Running,this.previewProxyServerManager=r,this.specEditor=new SpecEditor(this.roundtrips,(()=>this.status),this.mediator,this.id)}firstTokenStartTime=0;async startWork(e){this.firstTokenStartTime=performance.now();const t=await this.injectExtendParamsIfPreviousMessageExisted(e.request.payload);this.shouldIncludePreviousToolResult()?await this.createFollowupConversation(e,t):await this.createConversation(e,t)}async injectExtendParamsIfPreviousMessageExisted(e){const t=e.agent||{agentId:1,agentName:"Zulu",agentImage:"zulu",subagents:[]};updateLastUsedKnowledgeContext(e.knowledgeList);const r={fileOperate:{acceptedFiles:[],rejectedFiles:[]},contextMode:e.model?.mode,requestType:e.model?.requestType,promptENName:this.metrics?.function},n=this.previousRoundtrip;if(n){const i=n.getComposerTasks();for(const e of i){const t=e.toAcceptedLabel();e.accepted!==AcceptState.ACCEPT||r.fileOperate.acceptedFiles.includes(t)?e.accepted!==AcceptState.REJECT||r.fileOperate.rejectedFiles.includes(t)||r.fileOperate.rejectedFiles.push(t):r.fileOperate.acceptedFiles.push(t)}return{query:e.query,agent:t,taskId:n.context.taskId,conversationId:n.context.conversationId,knowledgeList:e.knowledgeList??[],extend:r,selfDefineInstruction:e.selfDefineInstruction,isCurrentFileSelected:e.isCurrentFileSelected}}return{query:e.query,agent:t,knowledgeList:e.knowledgeList??[],extend:r,selfDefineInstruction:e.selfDefineInstruction,isCurrentFileSelected:e.isCurrentFileSelected}}recreateCancelTokenSource(){return this.cancelTokenSource.cancel(),this.cancelTokenSource=createAxiosCancelTokenSource(),this.cancelTokenSource}async getMcpServers(e){const t=(await this.mcpManager.getConnectionsForWebview()).filter((({status:e,disabled:t})=>"connected"===e&&!t)).map((({name:e,tools:t})=>({serverName:e,tools:t?.map((({name:e,description:t,inputSchema:r})=>({name:e,description:t,inputSchema:r})))})));if(Array.isArray(e)){const r=e;return t.filter((({serverName:e})=>r.includes(e)))}return t}shouldIncludePreviousToolResult(){const e=this.previousRoundtrip;if(!e)return!1;const t=e.getLatestMessage();return!(!t||!isToolCallMessage(t))&&!0===t.workflow.includeInNextRoundtrip}async createFollowupConversation(e,t){this.logger.logUploader?.logUserAction({category:"zulu",action:"startFollowupConversation"}),this.recreateCancelTokenSource(),e.status=RoundtripStatus.Generating;const r=this.previousRoundtrip,n=r?.context.chatParams,i=r.getLatestMessage();if(!n||!i||!isToolCallMessage(i))return this.createConversation(e,t);const{conversationId:o}=n;e.context.userMessageId=n.analyze?.messageId,e.context.taskId=n.analyze?.taskId,this.logger.info("E2EBot start followup roundtrip: "+o);const s={...n,rollbackMessageId:this.rollbackMessageId,cancelToken:this.cancelTokenSource.token};this.performanceLog("agent-readenv-end"),kernel.logger.info("[Zulu] start followup chat");const a=await i.workflow.getResultForNextRoundtrip(e.request.payload);await this.startChat(e,s,a?[a]:[])}async createConversation(e,t){this.logger.logUploader?.logUserAction({category:"zulu",action:"startConversation"}),this.recreateCancelTokenSource(),e.status=RoundtripStatus.Analyzing;const r=e.request.payload?.model,n=await this.getMcpServers(this.getAgentMcpServers(e));this.performanceLog("agent-start-analyze");const i=analyze({username:this.repo.username,query:t.query,sessionId:this.id,conversationId:t?.conversationId,slash:"Composer",taskId:t?.taskId,contexts:[],mcpInfo:n,agentInfo:t.agent,traceId:this.id,modelKey:r?.modelId,extend:{contextMode:r?.mode,requestType:r?.requestType}});e.status=RoundtripStatus.Generating,this.logger.info("E2EBot start new roundtrip");const o=await this.virtualEditor.getActiveDocument(),{existed:s,selections:a,absolutePath:c}=o,l=s?relative$2(this.repo.rootPath.replace(/\\/g,"/"),c.replace(/\\/g,"/")):void 0;t.knowledgeList=transformKnowledges(t.knowledgeList,{relativePath:l});const A=transformContexts(t.knowledgeList),u=await transformQuery(t.query,t.knowledgeList),d=context2CodeChunks(A,o,this.repo.rootPath,this.virtualEditor);kernel.logger.info("[Zulu] start get system info");const h=this.getSysInfo(),p=getTraceRepoInfo(o,this.repo.rootPath),g=getContextsConfigList(),f=this.getRollbackMessageId(),m=this.getAgentInfo(e),E=t.agent?.subagents??[],C=excludeIllegalContexts(A);this.statistics.appendContexts(C);const{conversationId:I,extend:y,messageId:B,taskId:b,quotaMessages:v}=await i;this.performanceLog("agent-end-analyze"),e.context.taskId=b,v?(e.context.quotaActions=v.userActions,this.updateWebviewQuota({exceeded:!0,autoModel:v.autoModel,userActions:v.userActions})):(e.context.quotaActions=void 0,this.updateWebviewQuota({exceeded:!1,autoModel:"",userActions:{}})),e.request.replaceUuidWithUserMessageId(String(B)),e.context.conversationId=I,e.context.userMessageId=B;const w={messageId:B,rollbackMessageId:await f,username:this.repo.username,query:u,contexts:C,conversationId:I,codeChunks:await d,extend:{...t.extend,...y},analyze:await i,sysInfo:await h,cancelToken:this.cancelTokenSource.token,paths:[],mcpInfo:n,modelKey:r?.modelId,selfDefineInstruction:t.selfDefineInstruction,isCurrentFileSelected:t.isCurrentFileSelected,...await p,...m,agentInfo:ProjectAgent.pickTaskProperties(t.agent,n),subAgents:E.map((e=>ProjectAgent.pickTaskProperties(e,n))),configContexts:await g};this.performanceLog("agent-readenv-end"),kernel.logger.info("[Zulu] start chat "),await this.startChat(e,w)}endConversation(){this.virtualEditor.endConversationEditSession({conversationId:this.id}),this.acceptLogOnEnd("end")}onEndShowQuotaMessage(e){const t=e.context.quotaActions;t&&e.quotaTip(JSON.stringify(t))}async updateWebviewQuota(e){this.quotaService.updateWebviewQuota(e)}async startChat(e,t,r=[]){try{this.virtualEditor.startConversationEditSession({conversationId:this.id,source:this.type}),this.fileConsistencyChecker.saveCodeChunks(t.codeChunks),await this.recursivelyRegenerate(e,t,r),this.logger.logUploader?.logUserAction({category:"zulu",action:"endConversation"}),this.onEndShowQuotaMessage(e)}catch(e){throw e}finally{if(this.rollbackMessageId){this.rollbackMessageId=void 0;const e=await this.chatSessionManager.find(this.id),t=e.messages.map(((e,t)=>{if(e.discard)return null;if("assistant"===e.role){const t=e.elements.findIndex((e=>e.discard));return-1===t?e:{...e,elements:e.elements.slice(0,t)}}return e}));await this.chatSessionManager.save({...e,messages:t.filter(Boolean)})}this.endConversation()}}async beforeStop(){if(this.cancelTokenSource){this.logger.logUploader?.logUserAction({category:"zulu",action:"cancelConveration"}),this.latestRoundtrip.status===RoundtripStatus.Analyzing&&(this.latestRoundtrip.appendTextResponse("您已主动终止本次会话。",{replace:!0}),this.latestRoundtrip.updateWebviewMessages({forceUpdate:!0})),this.cancelTokenSource.cancel();const e=this.latestRoundtrip.getLatestToolCallMessage();e&&e.workflow.type===WorkflowType.RunCommand&&e.workflow.status===WorkflowStatus.READY&&(e.workflow.cancel(),this.endConversation())}}sanitizeDiffString(e){const t=e=>e.filter((e=>!/@@(.*)@@/.test(e))),r=e.split(/\r?\n/);return r[0].startsWith("---")&&r[1].startsWith("+++")?t(r.slice(2)).join("\n"):t(r).join("\n")}get metrics(){const e=this.latestRoundtrip.request.metrics,t=this.latestRoundtrip.request.payload?.model?.modelId||"Auto",r=this.latestRoundtrip.request.metrics?.path;return{...e,path:r,modelKey:t}}async acceptLogOnEnd(e){if(!this.latestRoundtrip)return;const{suggestions:t,changes:r}=await this.latestRoundtrip.updateAcceptSuggestions(this.metrics),n="CODE_EXPLAIN"===this.latestRoundtrip.request.payload.metrics?.function,i=this.latestRoundtrip.request.payload?.query?.trim(),{agentContexts:o,agentTools:s,assistantContent:a}=this.statistics.export(this.latestRoundtrip);if(void 0!==this.latestRoundtrip.getLatestMessage()){if("end"===e){this.codeWrittenMetric.agentEdit(Object.values(r));const e=await this.generateMessageId(this.metrics,t,i,a,o,s);this.logger.info("[Zulu] Roundtrip completed: uuid=",e),this.latestRoundtrip.reportedId=e,this.latestRoundtrip.updateWebviewMessages()}this.logger.info("[Zulu] Track roundtrip completed: reportedId=",this.latestRoundtrip.reportedId),this.acceptLog(this.metrics,this.latestRoundtrip.reportedId,t,!(n||!t.length))}this.onAcceptLog(t,e)}async onFileAcceptedChange(e,t,r){if(!this.latestRoundtrip)return;const n=this.latestRoundtrip.updateSuggestionsByPath(relative$2(this.repo.rootPath,e),t,r);return n.length&&(this.logger.info("[Zulu] Track file accepted: reportedId=",this.latestRoundtrip.reportedId),this.acceptLog(this.metrics,this.latestRoundtrip.reportedId,n)),this.onAcceptLog(n,"action"),n}acceptCodeBlock(e){if(!this.latestRoundtrip)return;const t=this.latestRoundtrip.updateCodeBlockSuggestion(e);t.length&&(this.logger.info("[Zulu] update code block acceptance"),this.acceptLog(this.metrics,this.latestRoundtrip.reportedId,t))}async acceptLog(e,t,r,n=!0){if(!t)return;const i={fileContent:r};await acceptCode({uuid:t,accepted:n,content:"",multiSuggestions:i})}async handleNewMessage(e){switch(e.action){case"execute-shell":{const{output:t}=await this.virtualEditor.executeTerminalShell({cmd:e.shell,cwd:this.repo.rootPath,duration:5e3,run:!0});if(e.id!==this.latestRoundtrip?.uuid)return;const r=extractLocalhostAddressFromOutput(t);if(r)try{const{port:t}=new URL(r);if(await isPortAvailable$1(Number(t))){const t=this.latestRoundtrip.getTextMessage(e.elementId);t?.composer.updatePreview(r)}}catch(e){this.logger.error("execute-shell failed, reason:",e)}break}case"insert-shell":await this.virtualEditor.executeTerminalShell({cmd:e.shell,cwd:this.repo.rootPath,duration:5e3,run:!1}),this.acceptCodeBlock(e.shell);break;case"copy-code":this.acceptCodeBlock(e.content);break;case"file-diff":case"file-view":{if(this.specEditor.isSpec&&!this.specEditor.isProjectFileChange(e.elementId)){await this.specEditor.openSpecEditor(e.elementId);break}const t=this.roundtrips.reduce(((t,r)=>{if(t)return t;return r.getTextMessage(e.elementId)||r.getToolCallMessage(e.elementId)?r:null}),null);if(!t)return;const r=this.roundtrips.at(-1)===t,n=t.getComposerTasks().filter(equalFilePathOrUniqKey(e.absolutePath??e.filePath)),i={stream:!1,elementId:e.elementId};if(1===n.length){const e=n[0];if(r){const{content:t}=await this.virtualEditor.getDocument({absolutePath:e.absolutePath});await e.openDiff({...i,content:e.originalContent||"",modified:t,acceptable:!0})}else await e.openDiff({stream:!1,content:e.originalContent||"",modified:e.content,acceptable:!1})}else if(n.length>1){const e=n[n.length-1],t=n[0].originalContent||"";if(r){const{content:r}=await this.virtualEditor.getDocument({absolutePath:e.absolutePath});await e.openDiff({...i,acceptable:!0,content:t,modified:r})}else{const r=n[n.length-1].content;await e.openDiff({stream:!1,acceptable:!1,content:t,modified:r})}}break}case"file-tool-result-view":{if(this.specEditor.isSpec&&!this.specEditor.isProjectFileChange(e.elementId)){await this.specEditor.openSpecEditor(e.elementId);break}const t=e.elementId,r=this.getToolMessage(t),n=r?.composer.tasks[0];n&&await n.openDiff({stream:!1,acceptable:!1,content:n.originalContent||"",modified:n.content||""});break}case"file-accept":{const t=this.latestRoundtrip.getComposerTasks()?.filter(equalFilePathOrUniqKey(e.filePath))||[];for(const e of t)await e.save();this.onFileAcceptedChange(e.filePath,AcceptState.ACCEPT);break}case"file-reject":{const t=this.latestRoundtrip.getComposerTasks()?.filter(equalFilePathOrUniqKey(e.filePath))||[];for(const e of t.reverse())await e.revert();this.onFileAcceptedChange(e.filePath,AcceptState.REJECT);break}case"file-accept-block":{const t=this.latestRoundtrip.getComposerTasks()?.find(equalFilePathOrUniqKey(e.filePath));t?.accept();break}case"file-reject-block":{const t=this.latestRoundtrip.getComposerTasks()?.find(equalFilePathOrUniqKey(e.filePath));if(t&&"edit"===e.source){if(!e.acceptance)return void t.reject();const r=await this.onFileAcceptedChange(e.filePath,AcceptState.REJECT,e.acceptance);if(r){const n=r.find((t=>isFilePathEqual(relative$2(this.repo.rootPath,e.filePath),t.path)));(!1===e.accepted||n&&!n.accepted)&&t.reject()}}break}case"tool-call-accept":{const t=this.getToolMessage(e.elementId);t?.workflow.acceptToRunWorkflow();break}case"tool-call-reject":{const t=this.getToolMessage(e.elementId);t?.workflow.rejectToRunWorkflow();break}case"tool-call-action":{const t=this.getToolMessage(e.elementId);t?.workflow.executeCustomAction(e.params);break}case"file-accept-all":{const e=this.latestRoundtrip?.getComposerTasks()||[];for(const t of e)t.completed&&await t.save({openDocument:!1});this.acceptLogOnEnd("action");break}case"file-reject-all":{const e=this.latestRoundtrip?.getComposerTasks()||[];for(const t of e.reverse())t.completed&&await t.revert({openDocument:!1});this.acceptLogOnEnd("action");break}case"regenerate-chat":{const e=this.latestRoundtrip;e&&super.startNewWork(e.request.payload);break}case"inquire-rollback-message":await this.stopGenerating();return(await this.getRollbackSummary({userMessageId:e.userMessageId,retryMessageId:e.retryMessageId})).map((e=>_$H.omit(e,"changes")));case"rollback-message":{this.specEditor.beforeRollback();const t=await this.executeRollback({userMessageId:e.userMessageId,retryMessageId:e.retryMessageId},e.selectedAbsolutePaths);return t||(this.specEditor.afterRollback(),this.fileConsistencyChecker.clear()),t}case"copy-all":return this.handleCopyFullContent(e.id);case"user-feedback":this.onUserFeedBack(e.id,e.options);break;case"compress-token-usage":{const e=this.latestRoundtrip.context.sessionId;await this.latestRoundtrip.compressTokenUsage({sessionId:e});break}}}rebuildConversation(e){this.rebuildRoundtrips(e.messages),this.status=this.deriveConversationStatus(),this.specEditor.rebuild(),this.fileConsistencyChecker.rebuild(e.fileCache)}getSessionState(){if(this.specEditor.isSpec){if(this.specEditor.hasDocOrTasksPending)return SessionState.Pending;if(this.specEditor.hasSummaryFile)return SessionState.Summarized}return super.getSessionState()}async recursivelyRegenerate(e,t,r,n,i){kernel.logger.info("[Zulu] start collect chat params");const o=await this.updateDynamicChatParams(e,t,r);if(!e.inProgress)return{content:"",taskId:0,sessionId:0,agentInfo:{}};kernel.logger.info("[Zulu] request chat response");try{const{sessionId:r,taskId:s,content:a,agentInfo:c}=await this.doRequestAndParseResponse(e,o,n,i);n||this.rememberSessionId(e,r);const{nextRequestResults:l,nextRoundtripResults:A}=await this.processNewAddedMessages(e,t),u=t.analyze.needMock,d="cancelled"===e.status,h={...t,taskInfo:void 0};return h.sessionId=h.sessionId||r,h.taskId=h.taskId||s,h.agentInfo=c,A.length>0&&(e.context.chatParams=_$H.omit(h,["cancelToken"])),!u&&!d&&l.length>0?this.recursivelyRegenerate(e,h,l,n):(await this.latestRoundtrip.calculateTokenUsage({sessionId:r}),{sessionId:r,taskId:s,agentInfo:c,content:a})}catch(e){const t=this.latestRoundtrip.context.sessionId;throw t&&await this.latestRoundtrip.calculateTokenUsage({sessionId:t},1e3),e}}performanceLog(e){if(this.firstTokenStartTime){const t=performance.now()-this.firstTokenStartTime;this.logger.logUploader?.performanceLog({plugin:this.metrics.modelKey,skill:this.metrics.function,duration:t,type:e}),this.logger.info(`[Performance] ${e} take ${t} ms`),"agent-first-token"===e&&(this.firstTokenStartTime=0)}}async doRequestAndParseResponse(e,t,r,n){const i=iocContainer.get(SecurityFilter$1);if(i.isEnable){const e=i.filterUserInput(t.query);"replace"===e.action&&(t.query=e.filteredText),i.triggerNotification(e)}this.performanceLog("agent-start-stream");const o=await chat({...t,extend:{...t.extend}});let s="",a=0,c=0,l={},A=n;for await(const n of throttleAsyncIterator(o)){for(const i of n){if(c=i.taskId,l=i.agentInfo,this.performanceLog("agent-first-token"),i.sessionId&&!a&&(a=i.sessionId),i.taskId&&!c&&(c=i.taskId),"NOTIFICATION"===i.content.type){await e.appendNotificationResponse(i.content,{fileConsistencyChecker:this.fileConsistencyChecker});continue}Array.isArray(i.content.uriMetas)&&await e.updateWebSearchResult(i.content.uriMetas),i.content.detail.planDelta&&await e.appendTodoResponse(i.messageId,i.content.detail.planDelta,!!i.content.detail.planEnd,r);const{type:n,detail:o,end:u}=i.content,{reasoningDelta:d="",reasoningEnd:h,retryMessageId:p}=i.content.detail;if(A=p,await e.appendReasonResponse(i.messageId,d,h,r),"ANSWER"===n){const t=o.delta??"";s+=t,e.appendTextResponse(t,void 0,r);continue}const g=o.toolUse??[];for(const o of g){const{input:s,...a}=o,c={mcpManager:this.mcpManager,previewProxyServerManager:this.previewProxyServerManager,parentMessageId:r,specEditor:this.specEditor,fileConsistencyChecker:this.fileConsistencyChecker,requestInfo:{contexts:t.contexts,sessionId:t.sessionId,messageId:i.messageId,conversationId:i.conversationId,agentName:t.agentInfo?.agentName}};await e.appendToolCallResponse({eventType:n.replace("FUNCTION_CALL","TOOL_CALL"),params:s,...a},c)}if(!0===u){s="";break}}e.updateWebviewMessages()}return this.latestRoundtrip.responses.forEach((e=>{e.retryMessageId=e.retryMessageId||A})),{sessionId:a,taskId:c,agentInfo:l,content:s}}async processNewAddedMessages(e,t){const r=this.aggregateRelativeFilePathsFromContext(t.codeChunks),n=t.analyze.needMock,i=[],o=[],s=e.resolveNewAddedMessages();for(const a of s){if(isTextMessage(a)&&r.length>0)a.content=await replacePathTextInMarkdown(a.content,r);else if(isToolCallMessage(a)){if(a.workflow instanceof SubtaskWorkflow&&!n)try{const r=a.workflow.getSubtaskParams(),n=await this.getMcpServers(this.getAgentMcpServers(e,r.subagent)),i={...t,sessionId:void 0,taskId:void 0,taskInfo:r,mcpInfo:n},o=await this.recursivelyRegenerate(e,i,[],a.uuid);a.workflow.setResult(o)}catch(e){a.workflow.fail(e)}await a.workflow.workflowPromise,a.workflow.result&&(a.workflow.includeInNextRoundtrip?o.push(a.workflow.result):a.workflow.includeInNextRequest&&i.push(a.workflow.result)),this.statistics.appendTool(a.workflow),e.updateWebviewMessages()}a.end()}return{nextRequestResults:i,nextRoundtripResults:o}}reportMessageRetryStatus(e){this.logger.logUploader?.logUserAction({category:"zulu",action:"retryAbortedMessage",label:e?"success":"failed"})}aggregateRelativeFilePathsFromContext(e){const t=this.latestRoundtrip;if(!t)return[];const r=new Set;for(const t of e)t.path&&t.path.length>=3&&r.add(t.path);for(const e of t.toolCallMessages)for(const t of e.workflow.paths)t.length>=3&&r.add(t);return Array.from(r)}aggregateKnowledgeAndPaths(){const e=[],t=new Set;for(const r of this.roundtrips){const n=r.request.payload.knowledgeList??[];e.push(...n);for(const e of r.toolCallMessages)for(const r of e.workflow.paths)t.add(r)}const r=uniqKnowledges(transformRuleKnowledge(e).reverse());for(const e of r)[ContextType.FILE,ContextType.CURRENT_FILE].includes(e.type)&&e.id&&t.add(e.id);return{knowledgeList:r,filePaths:Array.from(t)}}computeRecrusiveToolUse(e,t){if(t.length>0){const r=e.toolCallMessages,n=r[r.length-1],i=n?.workflow.type,o=[WorkflowType.ReadFile,WorkflowType.WriteFile,WorkflowType.ExtractContentBlocks,WorkflowType.PatchFile,WorkflowType.SearchFiles,WorkflowType.ListFiles,WorkflowType.RunCommand];if(r.length>2&&o.includes(i)){const r=[...e.toolCallMessages].reverse(),i=r.findIndex((e=>e.workflow.status!==WorkflowStatus.FAILED)),o=i>2?i:r.findIndex((e=>!n.workflow.isEqual(e.workflow))),s=-1===o?r.length:o;if(s>2){const e=r.slice(0,s).map((e=>({params:e.workflow.params,status:e.workflow.status===WorkflowStatus.SUCCESS})));return[{...t[0],prevToolUse:e},...t.slice(1)]}}}return t}async updateDynamicChatParams(e,t,r){kernel.logger.info("[Zulu] start collect command info");const n=e.toolCallMessages[e.toolCallMessages.length-1];let i=t.sysInfo.notInstalledCommands,o=t.sysInfo.installedCommands;if(!o||!i||n?.workflow.type===WorkflowType.RunCommand){const e=await filterSupportedCommand(COMMON_COMMANDS);i=e.notInstalledCommands,o=e.installedCommands}kernel.logger.info("[Zulu] start collect rule info");const s=await this.getAppliedWorkspaceRules();this.statistics.appendRuleContexts(s),kernel.logger.info("[Zulu] start collect share memory info");const a=await this.getShareMemory(),c=await this.getWorkspaceMemory();return{...t,toolUseResults:this.computeRecrusiveToolUse(e,r),sysInfo:{...t.sysInfo,notInstalledCommands:i,installedCommands:o},cancelToken:this.cancelTokenSource.token,codeChunks:[...t.codeChunks,...s],shareMemory:a,projectMemory:c}}async getSysInfo(){const e=getBaseSysInfo(),t=kernel.env.ideTerminalInfo?.defaultShell,[{tree:r},n,{installedCommands:i,notInstalledCommands:o}]=await Promise.all([streamingListEntries(this.repo.rootPath),getShellWithVersion(t??e.defaultShell),filterSupportedCommand(COMMON_COMMANDS)]);return{...e,installedCommands:i,notInstalledCommands:o,workspaceDirTree:r.toOverviewStructure().tree,workspacePath:this.repo.rootPath,defaultShell:n}}async getAppliedWorkspaceRules(){if(!this.repo.rootPath)return[];const e=await getWorkspaceRules(this.repo.rootPath,this.virtualEditor),{knowledgeList:t,filePaths:r}=this.aggregateKnowledgeAndPaths(),{globRules:n,alwaysApplyRules:i}=getActiveRules(this.repo.rootPath,e,r),o=[],s=t.filter((e=>e.type===ContextType.RULE));for(const t of s){const r=e.find((e=>isFilePathEqual(e.path,t.id)));r&&o.push(createRuleCodeChunk(this.repo.rootPath,r))}for(const e of n)o.push(createRuleCodeChunk(this.repo.rootPath,e));for(const e of i)o.push(createRuleCodeChunk(this.repo.rootPath,e));return _$H.uniqBy(o,"path")}getAgentInfo(e){const t=e.request.payload.agent,r=t?.agentId,n=this.previousRoundtrip;if(!n)return{agentId:r,sessionId:void 0};const i=n.request.payload.agent;return i&&i.agentId===r?{agentId:r,sessionId:n.context.sessionId}:{agentId:r,sessionId:void 0}}rememberSessionId(e,t){!e.context.sessionId&&t&&(e.context.sessionId=t)}async getShareMemory(){try{return await getAgentShareMemory(this.id,this.virtualEditor)}catch(e){return void this.logger.error("Failed to get agent share memory:",e)}}async getWorkspaceMemory(){try{return await getWorkspaceMemories()}catch(e){return this.logger.error("Failed to get workspace memory:",e),[]}}getAgentMcpServers(e,t){const r=e.request.payload.agent;if(r){if(t){const e=r.subagents?.find((e=>e.agentName===t));return e?e.mcpInfos:[]}return r.mcpInfos}}beforeStartWork(){this.specEditor.beforeStartWork()}afterStartWork(){this.specEditor.afterStartWork()}afterGenerateQuerySummary(e,t){this.specEditor.afterGenerateQuerySummary(e,t)}onAcceptLog(e,t){}onUserFeedBack(e,t){const r=this.roundtrips.find((t=>t.uuid===e)),n=r?.reportedId;n?modifyCode({uuid:n,...t}):this.logger.warn("[Zulu] Roundtrip reportedId missing: message uuid=",e)}elementToText(e){switch(e.type){case"TEXT":return e.content;case"TOOL_CALL":return`\`\`\`${e.toolName}\n${JSON.stringify(e.params??"")}\n\`\`\``;default:return""}}handleCopyFullContent(e){const t=this.roundtrips.find((t=>t.uuid===e));if(!t)return void this.logger.warn("[Zulu] Roundtrip invalid: message uuid=",e);const r=t.toMessages().find((e=>"assistant"===e.role));if(!r)return void this.logger.warn("[Zulu] Roundtrip assistantMessage missing: message uuid=",e);const n=t.reportedId?`\nReportID: ${t.reportedId}`:"",i=this.id?`\nConversationID: ${this.id}`:"";return r.elements.map((e=>{const t=this.elementToText(e);if(e.parentMessageId){const e="    ";return e+t.split("\n").join("\n"+e)}return t})).join("\n\n")+n+i}}const{isEmpty:isEmpty$1}=_$H,getQuery=e=>e.customPrompt?e.customPrompt:`请帮我分析终端的报错日志，并提供解决方案。只解决第一个报错\n${e.code??""}`;class DebugBotConversation extends E2EBotConversation{codeWrittenMetrics;type=AgentConversationType.DebugBotConversation;sendCustomEventToIde;constructor(e,t,r,n,i){super(e,t,n,i),this.codeWrittenMetrics=i,this.sendCustomEventToIde=r}async startWork(e){if(1===this.roundtrips.length)await this.startDebugConversation(e);else if(2===this.roundtrips.length){const t=await this.injectExtendParamsIfPreviousMessageExisted(e.request.payload);await this.createConversation(e,t)}else{const t=await this.injectExtendParamsIfPreviousMessageExisted(e.request.payload);await this.createConversation(e,t)}this.endConversation()}async afterStop(){this.latestRoundtrip.reportedId&&this.reportConversationStatusChange("ABORT")}async startDebugConversation(e){const t=e.request.payload,r=await this.analyze(e.uuid,t);e.appendTextResponse(r?.errorReason??"");const n=await this.searchCode(r),i=await this.buildParams(e.uuid,t,r,n);e.status=RoundtripStatus.Generating,await this.recursivelyChat(e,i,[])}async analyze(e,t){const{platform:r,cwd:n,contexts:i}=t;return await agenticAnalyze({userDetail:{...this.userDetail,username:this.repo.username},conversationId:this.id,taskId:e,query:getQuery(t),cwd:n,platform:r,contexts:"object"==typeof i?JSON.stringify(i):i})}async searchCode(e){return e&&!isEmpty$1(e.context)?await this.sendIdeAction("search",e.context):{}}async buildParams(e,t,r,n){const[i]=await listFiles(this.repo.rootPath,this.repo.rootPath,!0,200),o={...getBaseSysInfo(),workspaceFolder:this.repo.rootPath,workspaceFolderTrees:i.map((e=>"folder"===e.type?`${e.path}/`:e.path))};return{userDetail:{...this.userDetail,username:this.repo.username},query:getQuery(t),taskId:e,context:{...n,sysInfo:o},device:this.userDetail.device,recordId:r?.recordId,conversationId:this.id,queryType:r?.queryType,toolUseResults:[],type:"NORMAL"}}async recursivelyChat(e,t,r){try{this.virtualEditor.startConversationEditSession({conversationId:this.id,source:this.type}),await this.doRecursivelyChat(e,t,r),this.virtualEditor.endConversationEditSession({conversationId:this.id})}catch(e){throw this.virtualEditor.endConversationEditSession({conversationId:this.id}),e}}async doRecursivelyChat(e,t,r){const n=await agenticAutoDebugFix({...t,toolUseResults:r});let i="";const o=new SSEProcessor(n).processSSE();for await(const t of throttleAsyncIterator(o,200)){for(const r of t){!i&&r.requestId&&(i=r.requestId);const{data:t,code:n,message:o}=r;if(200!==n)throw new Error(o);if(t){if((t.content||t.result)&&e.appendTextResponse(t.content||t.result),Array.isArray(t.toolUse))for(const r of t.toolUse)await e.appendToolCallResponse(r);if(t.isEnd)break}}e.updateWebviewMessages()}const s=await this.getNewWorkflowResults(e);if(s.length>0){const r={...t,query:"",context:void 0,type:"NORMAL"};await this.doRecursivelyChat(e,r,s)}}async getNewWorkflowResults(e){const t=e.resolveNewAddedMessages(),r=t.filter(isToolCallMessage),n=await Promise.all(r.map((async t=>{const r=t.workflow;return await r.workflowPromise,e.updateWebviewMessages(),r.includeInNextRequest?r.result:null})));return t.forEach((e=>e.end())),"cancelled"===e.status?[]:n.filter((e=>null!==e))}sendIdeAction=(e,t)=>this.sendCustomEventToIde(AGENT_DEBUG_CUSTOM_ACTION,{action:e,data:t});onAcceptLog(e,t){this.latestRoundtrip&&this.latestRoundtrip.reportedId&&("end"===t?this.onCodeGenerated(this.latestRoundtrip.reportedId,e):"action"===t&&this.onCodeAccepted(e))}onCodeAccepted(e){const t=e.filter((e=>!0===e.accepted)).map((e=>e.generatedContent)).join("\n");codeAdopt({userDetail:{...this.userDetail,username:this.repo.username},conversationId:this.id,adoptedCode:t})}onCodeGenerated(e,t){const r=t.map((e=>e.generatedContent)).join("\n");codeGenerate({userDetail:{...this.userDetail,username:this.repo.username},uuid:e,generatedCode:r,conversationId:this.id})}reportConversationStatusChange(e){taskStatus({userDetail:{...this.userDetail,username:this.repo.username},conversationId:this.id,status:e})}}const UserQuerySystemReminder={askModeActived:systemReminderBuilder(dedent`
+const path$7=path__default$1,util$9=t$1,isNaturalNumber=isNaturalNumber$1;var stripDirs$1=function(e,t,r){if("string"!=typeof e)throw new TypeError(util$9.inspect(e)+" is not a string. First argument to strip-dirs must be a path string.");if(path$7.posix.isAbsolute(e)||path$7.win32.isAbsolute(e))throw new Error(`${e} is an absolute path. strip-dirs requires a relative path.`);if(!isNaturalNumber(t,{includeZero:!0}))throw new Error("The Second argument of strip-dirs must be a natural number or 0, but received "+util$9.inspect(t)+".");if(r){if("object"!=typeof r)throw new TypeError(util$9.inspect(r)+" is not an object. Expected an object with a boolean `disallowOverflow` property.");if(Array.isArray(r))throw new TypeError(util$9.inspect(r)+" is an array. Expected an object with a boolean `disallowOverflow` property.");if("disallowOverflow"in r&&"boolean"!=typeof r.disallowOverflow)throw new TypeError(util$9.inspect(r.disallowOverflow)+" is neither true nor false. `disallowOverflow` option must be a Boolean value.")}else r={disallowOverflow:!1};const n=path$7.normalize(e).split(path$7.sep);if(n.length>1&&"."===n[0]&&n.shift(),t>n.length-1){if(r.disallowOverflow)throw new RangeError("Cannot strip more directories than there are.");t=n.length-1}return path$7.join.apply(null,n.slice(t))};const path$6=path__default$1,fs$5=gracefulFs,decompressTar=decompressTar$3,decompressTarbz2=decompressTarbz2$1,decompressTargz=decompressTargz$1,decompressUnzip=decompressUnzip$1,makeDir=makeDirExports,pify=pifyExports,stripDirs=stripDirs$1,fsP=pify(fs$5),runPlugins=(e,t)=>0===t.plugins.length?Promise.resolve([]):Promise.all(t.plugins.map((r=>r(e,t)))).then((e=>e.reduce(((e,t)=>e.concat(t))))),safeMakeDir=(e,t)=>fsP.realpath(e).catch((r=>{const n=path$6.dirname(e);return safeMakeDir(n,t)})).then((r=>{if(0!==r.indexOf(t))throw new Error("Refusing to create a directory outside the output path.");return makeDir(e).then(fsP.realpath)})),preventWritingThroughSymlink=(e,t)=>fsP.readlink(e).catch((e=>null)).then((e=>{if(e)throw new Error("Refusing to write into a symlink");return t})),extractFile=(e,t,r)=>runPlugins(e,r).then((e=>(r.strip>0&&(e=e.map((e=>(e.path=stripDirs(e.path,r.strip),e))).filter((e=>"."!==e.path))),"function"==typeof r.filter&&(e=e.filter(r.filter)),"function"==typeof r.map&&(e=e.map(r.map)),t?Promise.all(e.map((e=>{const r=path$6.join(t,e.path),n=e.mode&~process.umask(),i=new Date;return"directory"===e.type?makeDir(t).then((e=>fsP.realpath(e))).then((e=>safeMakeDir(r,e))).then((()=>fsP.utimes(r,i,e.mtime))).then((()=>e)):makeDir(t).then((e=>fsP.realpath(e))).then((e=>safeMakeDir(path$6.dirname(r),e).then((()=>e)))).then((t=>"file"===e.type?preventWritingThroughSymlink(r,t):t)).then((e=>fsP.realpath(path$6.dirname(r)).then((t=>{if(0!==t.indexOf(e))throw new Error("Refusing to write outside output directory: "+t)})))).then((()=>"link"===e.type||"symlink"===e.type&&"win32"===process.platform?fsP.link(e.linkname,r):"symlink"===e.type?fsP.symlink(e.linkname,r):fsP.writeFile(r,e.data,{mode:n}))).then((()=>"file"===e.type&&fsP.utimes(r,i,e.mtime))).then((()=>e))}))):e)));var decompress$1=(e,t,r)=>{if("string"!=typeof e&&!Buffer.isBuffer(e))return Promise.reject(new TypeError("Input file required"));"object"==typeof t&&(r=t,t=null),r=Object.assign({plugins:[decompressTar(),decompressTarbz2(),decompressTargz(),decompressUnzip()]},r);return("string"==typeof e?fsP.readFile(e):Promise.resolve(e)).then((e=>extractFile(e,t,r)))},decompress$2=getDefaultExportFromCjs(decompress$1),__decorate$3=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s},__metadata$2=function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};function getSkillsBaseDir(e){if("global"===e)return path__default$1.join(os__default.homedir(),".comate","skills");const t=kernel.env.workspaceInfo.rootPath;if(!t)throw new Error("No workspace folder open for project-scoped skill installation");return path__default$1.join(t,".comate","skills")}let SkillsManager=class{disposables=[];constructor(){this.disposables.push(kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_INSTALL,this.handleInstall),kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_UNINSTALL,this.handleUninstall),kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_TOGGLE,this.handleToggle),kernel.connect.onWebviewMessage(PT_WEBVIEW_SKILL_EDIT,this.handleEdit))}handleInstall=async e=>{const{key:t,identifier:r,scope:n}=e,i=kernel.config.key;if(!t)return{success:!1,message:"没有找到该Skill"};try{const e=getSkillsBaseDir(n);await fs$1j.mkdir(e,{recursive:!0});const o=path__default$1.join(e,r);try{return await fs$1j.access(o),{success:!1,message:"该Skill已经安装"}}catch{}const s=path__default$1.join(e,`${r}.zip`),a=await axiosInstance.get(`/api/aidevops/autocomate/rest/autowork/v2/skill/market/download?id=${t}`,{headers:{"login-name":i},responseType:"arraybuffer"});return await fs$1j.writeFile(s,new Uint8Array(a.data)),await decompress$2(s,e,{filter:e=>!e.path.startsWith("__MACOSX")&&!e.path.includes(".DS_Store")}),await fs$1j.unlink(s),kernel.logger.trace(`[SkillsManager] Installed skill "${r}" (id: ${t}) to ${e} (scope: ${n})`),{success:!0,message:"Skill 安装成功"}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to install skill "${r}" (id: ${t}):`,e),{success:!1,message:e?.message??"Unknown error"}}};handleUninstall=async e=>{const{directory:t}=e;if(!t)return{success:!1,message:"没有找到该Skill"};try{try{await fs$1j.access(t)}catch{return{success:!0,message:"该Skill已经删除"}}return await fs$1j.rm(t,{recursive:!0,force:!0}),kernel.logger.trace(`[SkillsManager] Uninstalled skill at "${t}"`),{success:!0,message:"Skill 卸载成功"}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to uninstall skill at "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleToggle=async e=>{const{directory:t,disabled:r}=e;try{const e=path__default$1.join(t,"SKILL.md"),n=await fs$1j.readFile(e,"utf-8"),i=matter$1(n);i.data["disable-model-invocation"]=r;const o=matter$1.stringify(i.content,i.data);return await fs$1j.writeFile(e,o,"utf-8"),kernel.logger.trace(`[SkillsManager] Toggled skill at "${t}" disabled=${r}`),{success:!0,message:r?"Skill 已关闭":"Skill 已开启"}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to toggle skill at "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleEdit=async e=>{const{directory:t}=e;try{const e=path__default$1.join(t,"SKILL.md");return await fs$1j.access(e),{success:!0,message:"",filePath:e}}catch(e){return kernel.logger.error(`[SkillsManager] Failed to locate skill file at "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};dispose(){for(const e of this.disposables)e();this.disposables.length=0}};SkillsManager=__decorate$3([injectable(),__metadata$2("design:paramtypes",[])],SkillsManager);var __decorate$2=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s},__metadata$1=function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};const MIME_TYPES={".png":"image/png",".jpg":"image/jpeg",".jpeg":"image/jpeg",".gif":"image/gif",".svg":"image/svg+xml",".webp":"image/webp",".bmp":"image/bmp",".ico":"image/x-icon"};let ImageResolveService=class{disposables=[];constructor(){this.disposables.push(kernel.connect.onWebviewMessage(PT_WEBVIEW_IMAGE_RESOLVE_REQUEST,this.handleMessage))}handleMessage=async e=>{const{src:t}=e;try{return/^https?:\/\//.test(t)?await this.resolveRemoteImage(t):await this.resolveLocalImage(t)}catch(e){return kernel.logger.warn("[ImageResolveService] resolve failed",e?.message),{success:!1,error:e?.message||"Failed to resolve image"}}};async resolveLocalImage(e){const t=kernel.env.workspaceInfo.rootPath,r=this.decodeLocalPath(e);let n=r;if(!isAbsolute$2(r)){if(!t)return{success:!1,error:"No workspace root available"};n=resolve$e(t,r)}if(!existsSync(n))return{success:!1,error:`File not found: ${r}`};const i=await readFile$3(n),o=extname$5(n).toLowerCase();return{success:!0,data:`data:${MIME_TYPES[o]||"image/png"};base64,${i.toString("base64")}`}}decodeLocalPath(e){try{return decodeURIComponent(e)}catch{return e}}async resolveRemoteImage(e){try{const t=await axiosInstance.get(e,{responseType:"arraybuffer",timeout:15e3}),r=t.headers["content-type"]||"image/png";return{success:!0,data:`data:${r};base64,${Buffer.from(t.data).toString("base64")}`}}catch(t){return{success:!1,error:`Failed to fetch remote image: ${t?.message||e}`}}}dispose(){for(const e of this.disposables)e();this.disposables.length=0}};async function fetchFeatures(e){if(!e||0===e.length)return{};try{const t=e.join(",");return(await axiosInstance.get(`${getBaseUrl$1()}/rest/autowork/v2/abtest/features?featureKeys=${t}`,{headers:getRequestUserHeader()})).data.data||{}}catch(e){return kernel.logger.error("FeatureSetProvider","fetchFeatures failed",e),{}}}ImageResolveService=__decorate$2([injectable(),__metadata$1("design:paramtypes",[])],ImageResolveService);var __decorate$1=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s};let FeatureSetProvider=class{async getFeatures(e){return fetchFeatures(e)}};FeatureSetProvider=__decorate$1([injectable()],FeatureSetProvider);var __decorate=function(e,t,r,n){var i,o=arguments.length,s=o<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,r,n);else for(var a=e.length-1;a>=0;a--)(i=e[a])&&(s=(o<3?i(s):o>3?i(t,r,s):i(t,r))||s);return o>3&&s&&Object.defineProperty(t,r,s),s},__metadata=function(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)};const execFileAsync=promisify$7(execFile),TAG="[PluginMarketManager]";function getPluginsBaseDir(e){if("global"===e)return path__default$1.join(os__default.homedir(),".comate","plugins");const t=kernel.env.workspaceInfo.rootPath;if(!t)throw new Error("No workspace folder open for project-scoped plugin installation");return path__default$1.join(t,".comate","plugins")}function getPluginConfigPath(e){if("global"===e)return path__default$1.join(os__default.homedir(),".comate","plugin.json");const t=kernel.env.workspaceInfo.rootPath;if(!t)throw new Error("No workspace folder open for project-scoped plugin configuration");return path__default$1.join(t,".comate","plugin.json")}const pluginOpQueue={promise:Promise.resolve()};function withPluginLock(e){const t=pluginOpQueue.promise.then(e,e);return pluginOpQueue.promise=t.then((()=>{}),(()=>{})),t}async function readPluginConfig(e){const t=getPluginConfigPath(e);try{const r=await fs$1j.readFile(t,"utf-8"),n=JSON.parse(r);return console.log(`${TAG} readPluginConfig(${e}) path=${t} keys=[${Object.keys(n).join(",")}]`),n}catch{return console.log(`${TAG} readPluginConfig(${e}) path=${t} -> empty (file not found or parse error)`),{}}}async function writePluginConfig(e,t){const r=getPluginConfigPath(e),n=path__default$1.dirname(r);await fs$1j.mkdir(n,{recursive:!0}),await fs$1j.writeFile(r,JSON.stringify(t,null,2),"utf-8"),console.log(`${TAG} writePluginConfig(${e}) path=${r} keys=[${Object.keys(t).join(",")}]`)}const PLUGIN_COMPONENT_DIRS=[{dirName:"agents",type:"agents"},{dirName:"skills",type:"skills"},{dirName:"commands",type:"commands"},{dirName:"hooks",type:"hooks"},{dirName:"mcps",type:"mcps"},{dirName:"rules",type:"rules"}],PLUGIN_METADATA_FILES=["plugin.json","package.json",".claude-plugin/plugin.json",".cursor-plugin/plugin.json"];async function isValidPluginDir(e){const t=[...PLUGIN_METADATA_FILES.map((t=>fs$1j.access(path__default$1.join(e,t)).then((()=>!0)).catch((()=>!1)))),...PLUGIN_COMPONENT_DIRS.map((({dirName:t})=>fs$1j.access(path__default$1.join(e,t)).then((()=>!0)).catch((()=>!1))))];return(await Promise.all(t)).some(Boolean)}async function detectSubPlugins(e){const t=["plugins","external_plugins"],r=[];for(const n of t){const t=path__default$1.join(e,n);try{const e=await fs$1j.readdir(t,{withFileTypes:!0});for(const n of e){if(!n.isDirectory())continue;const e=path__default$1.join(t,n.name);await isValidPluginDir(e)&&r.push(e)}}catch{}}return r}async function scanPluginComponents(e){const t=[];return await Promise.all(PLUGIN_COMPONENT_DIRS.map((({dirName:r,type:n})=>(async(r,n)=>{const i=path__default$1.join(e,r);try{const e=await fs$1j.readdir(i,{withFileTypes:!0});for(const r of e)(r.isFile()||r.isDirectory())&&t.push({name:r.name,type:n})}catch{}})(r,n)))),t}let PluginMarketManager=class{disposables=[];constructor(){console.log(`${TAG} constructor: registering event handlers`),this.disposables.push(kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_MARKET_FETCH_REQUEST,this.handleMarketFetch),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_INSTALL_REQUEST,(e=>withPluginLock((()=>this.handleInstall(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_UNINSTALL_REQUEST,(e=>withPluginLock((()=>this.handleUninstall(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_TOGGLE_REQUEST,(e=>withPluginLock((()=>this.handleToggle(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_UPDATE_REQUEST,(e=>withPluginLock((()=>this.handleUpdate(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_UPDATE_ALL_REQUEST,(()=>withPluginLock((()=>this.handleUpdateAll())))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_COPY_REQUEST,(e=>withPluginLock((()=>this.handleCopy(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_MANUAL_INSTALL_REQUEST,(e=>withPluginLock((()=>this.handleManualInstall(e))))),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_DETAIL_FETCH_REQUEST,this.handleDetailFetch),kernel.connect.onWebviewMessage(PT_WEBVIEW_PLUGIN_REFRESH_REQUEST,(()=>this.notifyPluginConfig()))),this.notifyPluginConfig()}notifyPluginConfig=async()=>{console.log(`${TAG} notifyPluginConfig: start`);try{const e=await this.getInstalledPlugins("global"),t=await this.getInstalledPlugins("project"),r={layered:{global:{plugins:e},project:{plugins:t}}};console.log(`${TAG} notifyPluginConfig: sending to webview, global=[${Object.keys(e).join(",")}] project=[${Object.keys(t).join(",")}]`),kernel.connect.sendWebviewMessage(PT_KERNEL_PLUGIN_CONFIG_UPDATED_NOTIFICATION,r),kernel.connect.sendWebviewMessage(PT_KERNEL_SKILL_METADATA_CHANGED_NOTIFICATION,{});let n=!1;const i=JSON.stringify(e),o=JSON.stringify(t);await Promise.all([this.checkForUpdates(e,"global"),this.checkForUpdates(t,"project")]),JSON.stringify(e)===i&&JSON.stringify(t)===o||(n=!0),n?(console.log(`${TAG} notifyPluginConfig: updates detected, sending second notification`),kernel.connect.sendWebviewMessage(PT_KERNEL_PLUGIN_CONFIG_UPDATED_NOTIFICATION,{layered:{global:{plugins:e},project:{plugins:t}}})):console.log(`${TAG} notifyPluginConfig: no updates detected`)}catch(e){console.error(`${TAG} notifyPluginConfig: FAILED`,e),kernel.logger.error(`${TAG} Failed to notify plugin config:`,e)}};getInstalledPlugins=async e=>{const t=await readPluginConfig(e),r=getPluginsBaseDir(e),n={};console.log(`${TAG} getInstalledPlugins(${e}): scanning dir=${r}`);try{const i=await fs$1j.readdir(r,{withFileTypes:!0}),o=i.filter((e=>e.isDirectory())).map((e=>e.name));console.log(`${TAG} getInstalledPlugins(${e}): found directories=[${o.join(",")}]`);for(const o of i){if(!o.isDirectory())continue;const i=path__default$1.join(r,o.name),s=t[o.name]||{},a=await scanPluginComponents(i);let c,l=o.name,A="",u="";const d=await this.readPluginMetadata(i,o.name);d?(l=d.name||o.name,A=d.description||"",u=d.version||"",console.log(`${TAG} getInstalledPlugins(${e}): [${o.name}] metadata from ${d.source}, name=${l} version=${u}`)):(c="未找到有效的插件描述文件（plugin.json、package.json、.claude-plugin/plugin.json 等均缺失或解析失败）",console.log(`${TAG} getInstalledPlugins(${e}): [${o.name}] no metadata file found`));const h=!!s.disabled;let p;p=c?"error":h?"disabled":"enabled",n[o.name]={name:l,key:o.name,description:A,version:u,icon:"",status:p,disabled:h,error:c,gitUrl:s.gitUrl,ref:s.ref,components:a},console.log(`${TAG} getInstalledPlugins(${e}): [${o.name}] status=${p} hasConfig=${!!t[o.name]}`)}}catch(t){console.log(`${TAG} getInstalledPlugins(${e}): dir not found or read error: ${t?.message}`)}console.log(`${TAG} getInstalledPlugins(${e}): result keys=[${Object.keys(n).join(",")}]`);for(const[r,i]of Object.entries(t))if(i?.expandedDirectory&&!n[r]){const t=i.subPlugins||[],o=[];for(const e of t)n[e]&&o.push(...n[e].components);n[r]={name:r,key:r,description:`插件目录（包含 ${t.length} 个子插件：${t.slice(0,5).join("、")}${t.length>5?"...":""}）`,version:"",icon:"",status:"enabled",disabled:!!i.disabled,gitUrl:i.gitUrl,ref:i.ref,components:o},console.log(`${TAG} getInstalledPlugins(${e}): [${r}] virtual entry for expanded directory repo (${t.length} sub-plugins)`)}return n};handleMarketFetch=async()=>{console.log(`${TAG} handleMarketFetch: start`);try{const e=kernel.config.key,t=getApiHost();console.log(`${TAG} handleMarketFetch: apiHost=${t} loginKey=${e}`);const r=await axiosInstance.get("/rest/autowork/v2/plugin/market/list",{baseURL:t,headers:{"login-name":e}}),n=r.data?.data??[];console.log(`${TAG} handleMarketFetch: API returned ${n.length} items, names=[${n.map((e=>e.name)).join(",")}]`);const i=await Promise.all(n.map((async e=>{const{description:t,version:r}=await this.fetchRemotePluginJson(e.gitUrl,e.ref);return{name:e.name,key:e.name,description:t,version:r,icon:"",source:e.source??"",gitUrl:e.gitUrl,ref:e.ref,components:[]}})));return console.log(`${TAG} handleMarketFetch: returning ${i.length} enriched items`),i}catch(e){return console.error(`${TAG} handleMarketFetch: API failed. error=${e?.message}`),kernel.logger.error(`${TAG} Failed to fetch market list:`,JSON.stringify({message:e?.message,status:e?.response?.status,data:e?.response?.data})),[]}};handleInstall=async e=>{const{name:t,gitUrl:r,ref:n,source:i}=e;console.log(`${TAG} handleInstall: name=${t} gitUrl=${r} ref=${n} source=${i}`);try{const e=getPluginsBaseDir(i);console.log(`${TAG} handleInstall: pluginsDir=${e}`),await fs$1j.mkdir(e,{recursive:!0});const o=path__default$1.join(e,t);let s=!1;try{await fs$1j.access(o),s=!0}catch{}if(s){if((await readPluginConfig(i))[t])return console.log(`${TAG} handleInstall: dir AND config both exist -> already installed`),await this.notifyPluginConfig(),{success:!1,message:"该 Plugin 已经安装"};console.log(`${TAG} handleInstall: dir exists but NO config entry -> orphaned dir, cleaning up`),await fs$1j.rm(o,{recursive:!0,force:!0})}if(!r)return console.log(`${TAG} handleInstall: missing gitUrl`),{success:!1,message:"缺少 gitUrl，无法安装"};console.log(`${TAG} handleInstall: starting git clone ${r} ref=${n||"main"}`),await this.gitClone(r,n||"main",t,e),console.log(`${TAG} handleInstall: git clone SUCCESS`);const a=await detectSubPlugins(o);if(a.length>0)return console.log(`${TAG} handleInstall: detected plugin directory repo with ${a.length} sub-plugins`),this.installFromPluginDirectory(o,a,i,r,n||"main");if(!await isValidPluginDir(o))return console.log(`${TAG} handleInstall: cloned repo is not a valid plugin, cleaning up`),await fs$1j.rm(o,{recursive:!0,force:!0}),{success:!1,message:"仓库不是有效的插件（缺少元数据文件和组件目录）"};const c=await this.getLocalCommit(o);console.log(`${TAG} handleInstall: localCommit=${c}`);const l=await readPluginConfig(i);return l[t]={enabled:!0,gitUrl:r,ref:n||"main",installedCommit:c},await writePluginConfig(i,l),await this.notifyPluginConfig(),console.log(`${TAG} handleInstall: DONE, plugin "${t}" installed (scope: ${i})`),{success:!0,message:"Plugin 安装成功"}}catch(e){return console.error(`${TAG} handleInstall: FAILED for "${t}":`,e?.message||e),kernel.logger.error(`${TAG} Failed to install plugin "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};installFromPluginDirectory=async(e,t,r,n,i)=>{const o=path__default$1.dirname(e),s=path__default$1.basename(e),a=await readPluginConfig(r),c=await this.getLocalCommit(e);let l=0,A=0;for(const e of t){const t=path__default$1.basename(e),r=path__default$1.join(o,t);if(a[t])console.log(`${TAG} installFromPluginDirectory: "${t}" already exists, skipping`),A++;else{try{await fs$1j.access(r),console.log(`${TAG} installFromPluginDirectory: orphaned dir "${t}" found, cleaning`),await fs$1j.rm(r,{recursive:!0,force:!0})}catch{}await fs$1j.cp(e,r,{recursive:!0}),a[t]={enabled:!0,gitUrl:n,ref:i,installedCommit:c,parentRepo:s},l++,console.log(`${TAG} installFromPluginDirectory: installed "${t}"`)}}const u=t.map((e=>path__default$1.basename(e)));a[s]={enabled:!0,gitUrl:n,ref:i,installedCommit:c,expandedDirectory:!0,subPlugins:u},await writePluginConfig(r,a),await fs$1j.rm(e,{recursive:!0,force:!0}),await this.notifyPluginConfig();const d=`从插件目录安装了 ${l} 个插件`+(A>0?`，跳过 ${A} 个已存在`:"");return console.log(`${TAG} installFromPluginDirectory: DONE. ${d}`),{success:!0,message:d}};handleUninstall=async e=>{const{name:t,source:r}=e;console.log(`${TAG} handleUninstall: name=${t} source=${r}`);try{const e=await readPluginConfig(r),n=getPluginsBaseDir(r);if(e[t]?.expandedDirectory){const r=e[t].subPlugins||[];console.log(`${TAG} handleUninstall: "${t}" is expanded directory, uninstalling ${r.length} sub-plugins`);for(const t of r){const r=path__default$1.join(n,t);await fs$1j.rm(r,{recursive:!0,force:!0}),delete e[t]}delete e[t]}else{const r=path__default$1.join(n,t);await fs$1j.rm(r,{recursive:!0,force:!0}),delete e[t]}return await writePluginConfig(r,e),await this.notifyPluginConfig(),console.log(`${TAG} handleUninstall: DONE for "${t}"`),{success:!0,message:"Plugin 卸载成功"}}catch(e){return console.error(`${TAG} handleUninstall: FAILED for "${t}":`,e?.message),kernel.logger.error(`${TAG} Failed to uninstall plugin "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleToggle=async e=>{const{name:t,disabled:r,source:n}=e;console.log(`${TAG} handleToggle: name=${t} disabled=${r} source=${n}`);try{const e=await readPluginConfig(n);e[t]||(e[t]={}),e[t].disabled=r,await writePluginConfig(n,e),await this.notifyPluginConfig()}catch(e){console.error(`${TAG} handleToggle: FAILED for "${t}":`,e),kernel.logger.error(`${TAG} Failed to toggle plugin "${t}":`,e)}};handleUpdate=async e=>{const{name:t,source:r}=e;console.log(`${TAG} handleUpdate: name=${t} source=${r}`);try{const n=await readPluginConfig(r),i=n[t]||{};if(i.expandedDirectory)return console.log(`${TAG} handleUpdate: "${t}" is expanded directory, re-installing`),await this.handleUninstall({name:t,source:r}),this.handleInstall({name:t,gitUrl:e.gitUrl||i.gitUrl,ref:e.ref||i.ref||"main",source:r});const o=e.gitUrl||i.gitUrl,s=e.ref||i.ref||"main";if(!o)return{success:!1,message:"缺少 gitUrl，无法更新"};const a=getPluginsBaseDir(r),c=path__default$1.join(a,t);await fs$1j.rm(c,{recursive:!0,force:!0}),await this.gitClone(o,s,t,a);const l=await this.getLocalCommit(path__default$1.join(a,t));return n[t]={...i,gitUrl:o,ref:s,installedCommit:l},await writePluginConfig(r,n),await this.notifyPluginConfig(),console.log(`${TAG} handleUpdate: DONE for "${t}"`),{success:!0,message:"Plugin 更新成功"}}catch(e){return console.error(`${TAG} handleUpdate: FAILED for "${t}":`,e?.message),kernel.logger.error(`${TAG} Failed to update plugin "${t}":`,e),{success:!1,message:e?.message??"Unknown error"}}};handleUpdateAll=async()=>{console.log(`${TAG} handleUpdateAll: starting batch update`);let e=0,t=0;const r=["global","project"];for(const n of r){const r=await readPluginConfig(n);for(const[i,o]of Object.entries(r)){if(!o?.gitUrl||o.disabled)continue;(await this.handleUpdate({name:i,source:n})).success?e++:t++}}return console.log(`${TAG} handleUpdateAll: done updated=${e} failed=${t}`),{updated:e,failed:t}};handleCopy=async e=>{const{name:t,fromSource:r,toSource:n}=e;console.log(`${TAG} handleCopy: name=${t} from=${r} to=${n}`);try{const e=path__default$1.join(getPluginsBaseDir(r),t),i=path__default$1.join(getPluginsBaseDir(n),t);await fs$1j.mkdir(path__default$1.dirname(i),{recursive:!0}),await fs$1j.cp(e,i,{recursive:!0});const o=await readPluginConfig(r),s=await readPluginConfig(n);s[t]=o[t]||{enabled:!0},await writePluginConfig(n,s),await this.notifyPluginConfig()}catch(e){throw console.error(`${TAG} handleCopy: FAILED for "${t}":`,e),kernel.logger.error(`${TAG} Failed to copy plugin "${t}":`,e),e}};handleManualInstall=async e=>{const{folderPath:t,source:r}=e;console.log(`${TAG} handleManualInstall: folderPath=${t} source=${r}`);try{if(!(await fs$1j.stat(t)).isDirectory())return{success:!1,message:"所选路径不是文件夹"};const e=path__default$1.basename(t),n=getPluginsBaseDir(r);await fs$1j.mkdir(n,{recursive:!0});const i=path__default$1.join(n,e);let o=!1;try{await fs$1j.access(i),o=!0}catch{}if(o){if((await readPluginConfig(r))[e])return{success:!1,message:`Plugin "${e}" 已存在`};console.log(`${TAG} handleManualInstall: orphaned dir found, cleaning up`),await fs$1j.rm(i,{recursive:!0,force:!0})}if(!await isValidPluginDir(t))return{success:!1,message:"所选文件夹不是有效的插件（需包含 plugin.json、package.json、.claude-plugin/plugin.json 等元数据文件，或 skills/agents/commands 等组件目录）"};await fs$1j.cp(t,i,{recursive:!0});const s=await readPluginConfig(r);return s[e]={enabled:!0},await writePluginConfig(r,s),await this.notifyPluginConfig(),console.log(`${TAG} handleManualInstall: DONE for "${e}"`),{success:!0,message:"Plugin 安装成功"}}catch(e){return console.error(`${TAG} handleManualInstall: FAILED:`,e?.message),kernel.logger.error(`${TAG} Manual install failed:`,e),{success:!1,message:e?.message??"Unknown error"}}};handleDetailFetch=async e=>{const{name:t,source:r}=e;try{const e=getPluginsBaseDir(r),n=path__default$1.join(e,t),i=await scanPluginComponents(n);return{name:t,components:i,configPath:path__default$1.join(n,"plugin.json")}}catch(e){return kernel.logger.error(`${TAG} Failed to fetch plugin detail "${t}":`,e),{name:t,components:[],configPath:""}}};readPluginMetadata=async(e,t)=>{let r=t,n="",i="",o="";for(const s of PLUGIN_METADATA_FILES){if(o)break;try{const a=await fs$1j.readFile(path__default$1.join(e,s),"utf-8"),c=JSON.parse(a);r=c.name||t,n=c.description||"",i=c.version||"",o=s}catch{}}if(!o)return null;if(!n)try{const t=(await fs$1j.readFile(path__default$1.join(e,"README.md"),"utf-8")).split("\n");for(const e of t){const t=e.trim();if(t&&!t.startsWith("#")&&!t.startsWith("!")&&!t.startsWith("[")){n=t.length>120?t.slice(0,120)+"...":t;break}}}catch{}return{name:r,description:n,version:i,source:o}};gitClone=async(e,t,r,n)=>{const i=path__default$1.join(n,r);console.log(`${TAG} gitClone: git clone --depth 1 --branch ${t} ${e} ${i}`);try{const{stdout:r,stderr:n}=await execFileAsync("git",["clone","--depth","1","--branch",t,e,i]);r&&console.log(`${TAG} gitClone stdout: ${r.trim()}`),n&&console.log(`${TAG} gitClone stderr: ${n.trim()}`)}catch(e){throw console.error(`${TAG} gitClone FAILED: ${e?.message}`),e?.stderr&&console.error(`${TAG} gitClone stderr: ${e.stderr}`),e}};getLocalCommit=async e=>{try{const{stdout:t}=await execFileAsync("git",["-C",e,"rev-parse","HEAD"]);return t.trim()}catch{return""}};checkForUpdates=async(e,t)=>{const r=await readPluginConfig(t);for(const[n,i]of Object.entries(e)){const e=r[n]||{},{gitUrl:o,ref:s,installedCommit:a}=e;if(o&&a&&"error"!==i.status)try{const{stdout:e}=await execFileAsync("git",["ls-remote",o,s||"main"]),r=e.split(/\s/)[0]||"";r&&r!==a?(i.status="update",console.log(`${TAG} checkForUpdates(${t}): [${n}] UPDATE available (local=${a.slice(0,8)} remote=${r.slice(0,8)})`)):console.log(`${TAG} checkForUpdates(${t}): [${n}] up to date`)}catch(e){console.log(`${TAG} checkForUpdates(${t}): [${n}] ls-remote failed: ${e?.message}`)}else console.log(`${TAG} checkForUpdates(${t}): [${n}] skipped (gitUrl=${!!o} installedCommit=${!!a} status=${i.status})`)}};fetchRemotePluginJson=async(e,t)=>{for(const r of PLUGIN_METADATA_FILES)try{const n=this.buildRawUrl(e,t,r);if(!n)continue;const i=await axiosInstance.get(n,{timeout:5e3}),o="string"==typeof i.data?JSON.parse(i.data):i.data;if(o?.description||o?.version)return console.log(`${TAG} fetchRemotePluginJson: got metadata from ${r} for ${e}`),{description:o?.description||"",version:o?.version||""}}catch{}return{description:"",version:""}};buildRawUrl=(e,t,r)=>{const n=/github\.com[/:]([^/]+)\/([^/.]+?)(?:\.git)?$/.exec(e);return n?`https://raw.githubusercontent.com/${n[1]}/${n[2]}/${t}/${r}`:null};dispose(){for(const e of this.disposables)e();this.disposables.length=0}};function logInjection(e){return t=>e(t)}PluginMarketManager=__decorate([injectable(),__metadata("design:paramtypes",[])],PluginMarketManager);const iocContainer=new Container;iocContainer.applyMiddleware(logInjection);let serviceIsReady=!1;function updateServiceStatus(e){serviceIsReady=e}function active(){iocContainer.bind(EmbeddingsController).toSelf().inSingletonScope(),iocContainer.get(EmbeddingsController).run(),iocContainer.bind(PassthroughDemoService).toSelf().inSingletonScope(),iocContainer.get(PassthroughDemoService).start(),iocContainer.bind(PassthroughGitRepoService).toSelf().inSingletonScope(),iocContainer.get(PassthroughGitRepoService),iocContainer.bind(PassthroughModelListService).toSelf().inSingletonScope(),iocContainer.get(PassthroughModelListService),iocContainer.bind(PlusService).toSelf().inSingletonScope(),iocContainer.get(PlusService).start(),iocContainer.bind(HistoryService).toSelf().inSingletonScope(),iocContainer.get(HistoryService),iocContainer.bind(QuotaService).toSelf().inSingletonScope(),iocContainer.get(QuotaService),iocContainer.bind(SecurityFilter$1).toSelf().inSingletonScope(),iocContainer.get(SecurityFilter$1).start(),iocContainer.bind(MemoryService).toSelf().inSingletonScope(),iocContainer.get(MemoryService),iocContainer.bind(TabsController).toSelf().inSingletonScope(),iocContainer.get(TabsController),iocContainer.bind(LSPService).toSelf().inSingletonScope(),iocContainer.get(LSPService).run(),iocContainer.bind(UpdateNotificationService).toSelf().inSingletonScope(),iocContainer.get(UpdateNotificationService),isVscode&&(iocContainer.bind(ScanScheduler).toSelf().inSingletonScope(),iocContainer.get(ScanScheduler).initialize()),iocContainer.bind(SkillsManager).toSelf().inSingletonScope(),iocContainer.get(SkillsManager),iocContainer.bind(ImageResolveService).toSelf().inSingletonScope(),iocContainer.get(ImageResolveService),iocContainer.bind(FeatureSetProvider).toSelf().inSingletonScope(),iocContainer.get(FeatureSetProvider),iocContainer.bind(PluginMarketManager).toSelf().inSingletonScope(),iocContainer.get(PluginMarketManager)}const VALID_STATUSES=["pending","in_progress","completed"];class TodoWrite extends Handler{constructor(e,t,r){super("todo_write",e,t,r)}todos=[];async beforeExecute(){const e=this.getJSONParam("todos");e&&Array.isArray(e)||this.throwValidationError(ToolError.todo_write.parameter_required),e.length<2&&this.throwValidationError(ToolError.todo_write.todos_too_few({number:e.length}));const t=e.find((e=>!e.content)),r=e.find((e=>!e.status));t&&r&&this.throwValidationError(ToolError.todo_write.missing_required_params({params:"content, status"})),t&&this.throwValidationError(ToolError.todo_write.missing_required_params({params:"content"})),r&&this.throwValidationError(ToolError.todo_write.missing_required_params({params:"status"}));const n=e.map((e=>e.status)).find((e=>!VALID_STATUSES.includes(e)));n&&this.throwValidationError(ToolError.todo_write.invalid_status({status:n})),this.todos=e}async execute(e){const t=this.todos.filter((e=>"completed"===e.status)).length;let r=`Todos have been modified successfully. Current Todo States: ${t} complete, ${this.todos.filter((e=>"in_progress"===e.status)).length} in_progress, ${this.todos.filter((e=>"pending"===e.status)).length} pending\nEnsure that you continue to use the todo list to track your progress. Please proceed with the current tasks if applicable`;const n=iocContainer.get(FeatureSetProvider),i=(await n.getFeatures(["en_verif_sub"])).en_verif_sub;if(i?.enabled&&i?.value){if(this.todos.length>0&&t===this.todos.length){this.todos.slice(-3).some((e=>e.content.toLowerCase().includes("verif")))||(r+="\n\n"+systemReminderBuilder('You just closed all tasks and none of the last 3 steps was a verification step. Before writing your final summary, spawn the verification agent (agent_type="Verification"). You cannot self-assign PARTIAL by listing caveats in your summary — only the verifier issues a verdict.'))}}return this.result={output:r,metadata:{todos:this.todos}},this.result}}const MEMORY_LIMIT=100;class MemoryHandler extends FsHandler{get path(){return join$6(this.ctx.rootPath,WORKSPACE_MEMORY_PATH)}constructor(e,t,r,n){super(e,t,r,n)}async getAllMemories(){return await getWorkspaceMemories()}async getMemory(e){return await getWorkspaceMemory(e)}async createMemory(e,t){return(await this.getAllMemories()).length>=MEMORY_LIMIT&&this.throwExecuteError(`Memory limit exceeded: ${MEMORY_LIMIT}`),await createWorkspaceMemory({topic:e,memory_to_store:t})}async updateMemory(e,t,r){return await this.getMemory(e)||this.throwExecuteError(`Memory not found: ${e}`),await updateWorkspaceMemory({memory_id:e,topic:t,memory_to_store:r})}async deleteMemory(e){return await this.getMemory(e)||this.throwExecuteError(`Memory not found: ${e}`),await deleteWorkspaceMemory(e)}async backupMemories(){try{const e=await this.ctx.virtualEditor.getDocument({absolutePath:this.path});return e.existed?e.content:null}catch{return null}}}class UpdateMemory extends MemoryHandler{constructor(e,t,r){super("update_memory",e,t,r)}async beforeExecute(){super.beforeExecute(),this.originalContent=await this.backupMemories();const e=this.getParam("action");this.validateAction(e)}validateAction(e){"create"!==e&&"update"!==e&&"delete"!==e&&this.throwValidationError(ToolError.update_memory.invalid_action({action:e||""})),"create"===e?this.validateCreateParams():"update"===e?this.validateUpdateParams():"delete"===e&&this.validateDeleteParams()}validateCreateParams(){const e=this.getStringParam("topic"),t=this.getStringParam("memory_to_store");e||this.throwValidationError(ToolError.update_memory.parameter_required({action:"create",param:"topic"})),t||this.throwValidationError(ToolError.update_memory.parameter_required({action:"create",param:"memory_to_store"}))}validateUpdateParams(){const e=this.getStringParam("memory_id"),t=this.getStringParam("topic"),r=this.getStringParam("memory_to_store");e||this.throwValidationError(ToolError.update_memory.parameter_required({action:"update",param:"memory_id"})),t||this.throwValidationError(ToolError.update_memory.parameter_required({action:"update",param:"topic"})),r||this.throwValidationError(ToolError.update_memory.parameter_required({action:"update",param:"memory_to_store"}))}validateDeleteParams(){this.getStringParam("memory_id")||this.throwValidationError(ToolError.update_memory.parameter_required({action:"delete",param:"memory_id"}))}async execute(e){const t=this.getParam("action"),r=this.getStringParam("memory_id"),n=this.getStringParam("topic"),i=this.getStringParam("memory_to_store");try{let e;"create"===t?e=await super.createMemory(n,i):"update"===t?e=await super.updateMemory(r,n,i):"delete"===t?e=await super.deleteMemory(r):this.throwExecuteError(ToolError.update_memory.invalid_action({action:t}));const o=await this.getAllMemories(),s=JSON.stringify(o,null,2);return this.result.output=`Memory ${e.memory_id} ${"create"===t?"created":"updated"} successfully`,this.result.metadata.originalContent=this.originalContent,this.result.metadata.content=s,this.result.metadata.memoryId=e.memory_id,this.result.metadata.topic=e.topic,this.result}catch(e){if(e instanceof Error&&e.cause===MEMORY_FORMAT_ERROR_CAUSE)throw e.message+MEMORY_FORMAT_VALIDATION_TOOLTIP_FOR_API;const t=e instanceof Error?e.message:String(e);if((t.includes("找不到ID为")||t.includes("Memory not found"))&&this.throwExecuteError(ToolError.update_memory.memory_not_found({memory_id:r||""})),e instanceof Error&&t.includes("Failed to read/write")){const e=t.slice(0,50);this.throwExecuteError(ToolError.update_memory.file_io_error({detail:e}))}throw e}}async cancel(){await super.revert()}}async function webSearch(e){try{return(await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/agent/websearch",e,{headers:getRequestUserHeader()})).data.data}catch(e){return kernel.logger.error("Zulu","webSearch failed",e),[]}}class WebSearch extends Handler{constructor(e,t,r){super("web_search",e,t,r)}async beforeExecute(){this.getStringParam("query")||this.throwValidationError(ToolError.common.parameter_required({arg:"query"}))}async execute(e){const t=this.getStringParam("query");try{const r=e.traceId,n=e.conversationId,i=e.taskId,o=this.toolId,s=await webSearch({conversationId:n,taskId:i,toolId:o,query:t,traceId:r});if(0===s.length)throw ToolError.web_search.no_results;const a=`Web search results for query: ${t}\n\n${s.map((e=>`Title: ${e.title}\nURL: ${e.url}\nContent: ${e.content||e.text_markdown}`)).join("\n\n---\n\n")}`;return this.result.output=a,this.result.metadata.sites=s.map((e=>({content:e.content?.length>500?e.content.slice(0,500)+"...":e.content,title:e.title,url:e.url,favicon:e.favicon,source:e.source}))),this.result}catch(e){kernel.logger.error("websearch",`Web search failed: ${e.message}`),e instanceof CanceledError&&this.throwExecuteError(ToolError.common.execution_aborted),this.throwExecuteError(ToolError.web_search.execution_failed({error:e.message}))}}}async function webFetch(e){try{return(await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/agent/webfetch",e,{headers:getRequestUserHeader()})).data.data}catch(e){return kernel.logger.error("Zulu","webFetch failed",e),null}}class WebFetch extends Handler{constructor(e,t,r){super("web_fetch",e,t,r)}async beforeExecute(){this.getStringParam("url")||this.throwValidationError(ToolError.common.parameter_required({arg:"url"}))}async execute(e){const t=this.getStringParam("url"),r=this.getStringParam("prompt");try{const n=e.traceId,i=e.conversationId,o=e.taskId,s=this.toolId,a=await webFetch({conversationId:i,taskId:o,toolId:s,urls:[t],query:r,traceId:n});if(!a||0===a.length)throw ToolError.web_fetch.no_results;const c=a[0],l=`${c.content}`;return this.result.output=l,this.result.metadata.site={content:c.content?.length>500?c.content.slice(0,500)+"...":c.content,title:c.title,url:c.url,source:c.source},this.result}catch(e){kernel.logger.error("webfetch",`Web fetch failed: ${e.message}`),e instanceof CanceledError&&this.throwExecuteError(ToolError.common.execution_aborted),this.throwExecuteError(ToolError.web_fetch.execution_failed({error:e.message}))}}}class WriteFile extends FsHandler{constructor(e,t,r){super("write_file",e,t,r)}get path(){return this.getStringParam("path")}get content(){return this.getStringParam("content")}onUpdateParams(e){super.onUpdateParams(e);const t=this.getStringParam("content");this.result.metadata.diff=t?{add:t.split(/\r?\n/).length,remove:0}:void 0}async beforeExecute(){await super.beforeExecute();const e=this.getStringParam("path"),t=this.getStringParam("content");e||this.throwValidationError(ToolError.common.parameter_required({arg:"path"})),void 0===t&&this.throwValidationError(ToolError.common.parameter_required({arg:"content"})),isFileEditable(e)||this.throwValidationError(ToolError.write_file.can_not_edit({path:e}));const r=await this.ctx.virtualEditor.getDocument({absolutePath:this.absolutePath});this.assertFileConsistency(r),this.originalContent=r.existed?r.content:null}async execute(){const e=this.getStringParam("content"),t=this.ctx.specEditor?.isSpec&&isDocOrTasksFile(this.absolutePath)&&this.getBooleanParam("ask_review");await this.createDocument(e),this.ctx.fileConsistencyChecker.save(this.absolutePath,e,"write_file");const r=this.computeDiffLine(this.originalContent||"",e);return this.result.output="Write file success",this.result.metadata.originalContent=this.originalContent,this.result.metadata.content=e,this.result.metadata.diff=r,this.result.metadata.askReview=t,this.result}async afterExecute(){this.ctx.specEditor?.afterFileChange(this)}}function generateUniqueOptionId(e){const t=new Set(e.map((e=>e.id))),r="other_option";if(!t.has(r))return r;let n=1;for(;t.has(`${r}_${n}`);)n++;return`${r}_${n}`}class AskUserQuestion extends Handler{constructor(e,t){super("ask_user_question",e,t),t.onNotify((e=>{if("conversationStart"===e.name)return void this.completeIfPending();if(e.payload?.toolId!==this.toolId)return;const t=e.name;"confirm"===t?(this.result.metadata.state="completed",this.updateOutput(),this.token.getRoot().broadcast("resume-stream",{})):"updateAnswer"===t&&this.updateAnswer(e.payload.payload)}))}rebuildResult(e){super.rebuildResult(e),this.result.metadata.state="completed"}async beforeExecute(){const e=this.getStringParam("title"),t=this.getJSONParam("questions");t&&Array.isArray(t)||this.throwValidationError(ToolError.ask_user_question.parameter_required),t.length<1&&this.throwValidationError(ToolError.ask_user_question.questions_empty);for(const e of t){e.id||this.throwValidationError(ToolError.ask_user_question.missing_question_fields({field:"id"})),e.prompt||this.throwValidationError(ToolError.ask_user_question.missing_question_fields({field:"prompt"})),e.options&&Array.isArray(e.options)||this.throwValidationError(ToolError.ask_user_question.missing_question_fields({field:"options"})),e.options.length<2&&this.throwValidationError(ToolError.ask_user_question.options_too_few({questionId:e.id}));for(const t of e.options)t.id||this.throwValidationError(ToolError.ask_user_question.missing_option_fields({field:"id"})),t.label||this.throwValidationError(ToolError.ask_user_question.missing_option_fields({field:"label"}))}this.result={output:"",metadata:{title:e,questions:this.buildQuestionsWithOtherOption(t),state:"pending"}},this.updateOutput()}async execute(){return this.updateOutput(),this.result}updateOutput(){const{questions:e=[]}=this.result.metadata,t=["User questions responses:"];for(const r of e)t.push(`Question ${r.id}: ${this.formatSelectedOptions(r)}`);this.result.output=t.join("\n")}formatSelectedOptions(e){const t=e.options[e.options.length-1],r=e.selectedOptionIds?.filter((e=>e!==t.id)),n=[];return r.length>0&&n.push(`Selected option(s) ${r.join(", ")}`),e.selectedOptionIds.includes(t.id)&&n.push(`freeform: ${t.label}`),0===n.length?"No answer provided":n.join(", ")}updateAnswer(e){if(!e)return;const t=this.result.metadata.questions?.find((t=>t.id===e.questionId));if(!t)return;const{selectedOptionIds:r,otherAnswer:n}=e;if(Array.isArray(r)&&(t.selectedOptionIds=r),"string"==typeof n){t.options[t.options.length-1].label=n}this.updateOutput(),this.token.update()}buildQuestionsWithOtherOption(e){return e.map((e=>({...e,options:[...e.options,{id:generateUniqueOptionId(e.options),label:""}],selectedOptionIds:[]})))}completeIfPending(){"completed"!==this.result.metadata.state&&(this.result.metadata.state="completed",this.updateOutput())}}const MOCK_QUERY="Implement the plan as specified, it is attached for your reference. Do NOT edit the plan file itself.";function buildExecuteOutput(e,t,r){const n=[`Plan file created at: ${e}`];return r&&n.push("","After the file is written, the user modifies it as follows:",r),n.push("",`You can read the plan contents from this file. Note that this is currently in the user's home directory. If at any point you can no longer find it there, the user may have moved it to the workspace ${t} directory.`,"","To update this plan, use your file editing tools directly on this file. Do NOT call create_plan again to update the plan."),n.join("\n")}function getFirstNonEmptyLines(e,t){const r=e.split("\n"),n=[];let i=0;for(const e of r)if(n.push(e),e.trim()&&i++,i>=t)break;return n.join("\n")}class CreatePlan extends FsHandler{static plansDir=join$7(homedir$1(),".comate","plans");randomId=randomBytes$2(4).toString("hex");constructor(e,t){super("create_plan",e,t),t.onNotify((e=>{"conversationStart"!==e.name&&"conversationEnd"!==e.name?e.payload?.toolId===this.toolId?"buildPlan"===e.name&&this.startPlanBuild():"buildPlan"===e.name&&this.completeIfPending():this.completeIfRunning()}))}get path(){const e=this.getStringParam("name");if(!e)return"";const t=`${e.replace(/[<>:"/\\|?*\s]/g,"_")}_${this.randomId}.plan.md`;return join$7(CreatePlan.plansDir,t)}get content(){return this.getStringParam("plan")}get workspacePlansDir(){return join$7(this.ctx.rootPath,".comate","plans")}onUpdateParams(e){super.onUpdateParams(e);const t=this.getStringParam("name");t&&(this.result.metadata.name=t);const r=this.getStringParam("plan");r&&(this.result.metadata.overview=getFirstNonEmptyLines(r,8))}rebuildResult(e){super.rebuildResult(e),this.result.metadata.state="completed"}async beforeExecute(){await super.beforeExecute();const e=this.getStringParam("name"),t=this.getStringParam("plan");e||this.throwValidationError(ToolError.common.parameter_required({arg:"name"})),t||this.throwValidationError(ToolError.common.parameter_required({arg:"plan"})),this.originalContent=null}async execute(){const e=this.getStringParam("plan");return await this.createDocument(e),this.ctx.fileConsistencyChecker.save(this.absolutePath,e,"create_plan"),isComateIDE?await this.syncPlanStateToIde("pending",!0):await this.ctx.virtualEditor.openDocument({absolutePath:this.absolutePath}),this.result.output=buildExecuteOutput(this.absolutePath,this.workspacePlansDir),this.result.metadata.state="pending",this.result.metadata.originalContent=null,this.result}updateState(e,t=!1){this.result.metadata.state=e,t&&this.forceUpdateCurrentToolWebview(),this.syncPlanStateToIde(e,!1)}async revert(){await super.revert(),isComateIDE&&await this.ctx.virtualEditor.closePlanDocument({conversationId:this.ctx.traceId,toolId:this.toolId})}async syncPlanStateToIde(e,t){isComateIDE&&await this.ctx.virtualEditor.openPlanDocument({filePath:this.absolutePath,conversationId:this.ctx.traceId,toolId:this.toolId,status:e,isOpen:t})}completeIfRunning(){"running"===this.result.metadata.state&&this.updateState("completed",!1)}completeIfPending(){"pending"===this.result.metadata.state&&this.updateState("completed",!0)}async updateOutputWithDiff(){try{const{existed:e,content:t}=await this.ctx.virtualEditor.getDocument({absolutePath:this.absolutePath});if(!e)return;const r=this.getStringParam("plan");if(r&&t!==r){const e=markDiffContent(r,t);this.result.output=buildExecuteOutput(this.absolutePath,this.workspacePlansDir,e)}}catch{}}async startPlanBuild(){this.updateState("running",!0),await this.updateOutputWithDiff();const e={query:MOCK_QUERY,isMockQuery:!0,agent:{agentId:1,agentName:"Agent",isProjectAgent:!1},knowledgeList:[{id:this.result.metadata.absolutePath,type:ContextType$2.FILE,path:this.result.metadata.absolutePath}]};this.token.getRoot().broadcast("resume-stream",e)}}class DocRead extends FsHandler{constructor(e,t,r){super("doc_read",e,t,r)}get relativePath(){return this.getStringParam("target_file")}async beforeExecute(){this.getStringParam("target_file")||this.throwValidationError('Parameter "target_file" is required')}async execute(){const e=this.getStringParam("target_file"),[t,...r]=e.replace(/^\//,"").split("/"),n=r.join("/"),i=knowledgeService.queryKnowledge(t,n);i||this.throwExecuteError(`Knowledge file "${n}" not found`);const o=i.knowledgeId,s=(await readKnowledgeContentById({knowledgeIds:[o],traceId:this.ctx.traceId})).find((e=>e.knowledgeId===o));if(!s?.content)return this.result.output="<file>\n</file>\n<metadata>The file is empty.</metadata>",this.result.metadata.startLine=1,this.result.metadata.endLine=0,this.result.metadata.url=s?.url,this.result;const a=this.getNumberParam("offset")||1,c=safeSplitEol(s.content).length,l=this.getNumberParam("limit"),A=l?Math.min(c,a+l):c,u=toReadFileResult(s.content,a,A);return this.result.output=u.output,this.result.metadata.startLine=a,this.result.metadata.endLine=u.endLine,this.result.metadata.url=s?.url,this.result}}class DocList extends Handler{constructor(e,t,r){super("doc_list",e,t,r)}async beforeExecute(){this.getStringParam("target_directory")||this.throwValidationError('Parameter "target_directory" is required')}async execute(){const e=this.getStringParam("target_directory"),t=e.split("/").filter(Boolean)[0],r=knowledgeService.queryFolder(t);if(!r){const e=generateKnowledgeSummary(this.ctx.parameterCollector.getKnowledgeContexts());this.throwExecuteError(`Directory '${t}' does not exist. You can access the following content of knowledge base: \n${e}`)}const n=await knowledgeService.getWorksaceKnowledges({query:"",workspaceId:r.uuid,traceId:this.ctx.traceId}),i=n.length;if(0===i)this.result.output="The knowledge base is empty";else{const e=[`${t}/`];for(const t of n)e.push(`  - ${t.knowledgeName}`);this.result.output=`${t}\\\n`+e.join("\n")}return this.result.metadata.relativePath=e,this.result.metadata.totalCount=i,this.result.metadata.isTruncated=!1,this.result}}class DocSearch extends Handler{constructor(e,t,r){super("doc_search",e,t,r)}async beforeExecute(){this.getStringParam("query")||this.throwValidationError('Parameter "query" is required')}async execute(e){const t=this.getStringParam("query"),r=e.parameterCollector.getKnowledgeContexts(),n=(await knowledgeService.searchEmbeddingKnowledgeChunk({additionalQueries:[t],contexts:reformatKnowledgeContextType(r),traceId:e.traceId})).map((e=>({...e,match:e.content,path:e.knowledgeName})));return this.result.output=formatCodebaseSearchOutput(n),this.result.metadata.relevantFiles=n.map((e=>_$H.pick(e,["path","startLine","endLine","url","retrievalType"]))),this.result}}class RemoteVscodeAPI{commands={executeCommand:(e,...t)=>kernel.connect.sendRequest(PT_KERNEL_BROWSER_COMMAND_EXECUTE,{command:e,args:t})};onClose(e){return kernel.connect.onNotification(PT_KERNEL_BROWSER_COMMAND_NOTIFICATION,(t=>{"close"===t.type&&t.id&&e({id:t.id})}))}onOpen(e){return kernel.connect.onNotification(PT_KERNEL_BROWSER_COMMAND_NOTIFICATION,(t=>{"open"===t.type&&t.id&&e({id:t.id})}))}onConsole(e){return kernel.connect.onNotification(PT_KERNEL_BROWSER_COMMAND_NOTIFICATION,(t=>{"console"===t.type&&e(t.messages??[])}))}}const CORE_SPECIFIER="@baidu/comate-browser-use/core",VSCODE_SPECIFIER="@baidu/comate-browser-use/adapter-vscode",CHROME_ADAPTER_SPECIFIER="@baidu/comate-browser-use/adapter-chrome",CHROME_LAUNCH_SPECIFIER="@baidu/comate-browser-use/launch-chrome";let browserUseCorePromise=null,browserUseVscodePromise=null,browserUseChromePromise=null;function getResolvedEntry(e){try{const t=import.meta.resolve;return"function"==typeof t?t(e):void 0}catch{return}}async function loadBrowserUseCore(){if(!browserUseCorePromise){const e=getResolvedEntry(CORE_SPECIFIER);kernel.logger.info("[AutomationBrowser] loading browser-use core",{resolvedEntry:e}),browserUseCorePromise=import(CORE_SPECIFIER).then((t=>(kernel.logger.info("[AutomationBrowser] loaded browser-use core",{resolvedEntry:e,exports:Object.keys(t).sort()}),t))).catch((t=>{throw browserUseCorePromise=null,kernel.logger.error("[AutomationBrowser] failed to load browser-use core",{resolvedEntry:e,error:t}),t}))}return browserUseCorePromise}async function loadBrowserUseVscode(){if(!browserUseVscodePromise){const e=getResolvedEntry(VSCODE_SPECIFIER);kernel.logger.info("[AutomationBrowser] loading browser-use vscode adapter",{resolvedEntry:e}),browserUseVscodePromise=import(VSCODE_SPECIFIER).then((t=>(kernel.logger.info("[AutomationBrowser] loaded browser-use vscode adapter",{resolvedEntry:e,exports:Object.keys(t).sort()}),t))).catch((t=>{throw browserUseVscodePromise=null,kernel.logger.error("[AutomationBrowser] failed to load browser-use vscode adapter",{resolvedEntry:e,error:t}),t}))}return browserUseVscodePromise}async function loadBrowserUseChrome(){if(!browserUseChromePromise){const e=getResolvedEntry(CHROME_ADAPTER_SPECIFIER),t=getResolvedEntry(CHROME_LAUNCH_SPECIFIER);kernel.logger.info("[AutomationBrowser] loading browser-use chrome runtime",{adapterEntry:e,launchEntry:t}),browserUseChromePromise=Promise.all([import(CHROME_ADAPTER_SPECIFIER),import(CHROME_LAUNCH_SPECIFIER)]).then((([r,n])=>{const i={ChromeContext:r.ChromeContext,ChromeBrowserManager:n.ChromeBrowserManager};return kernel.logger.info("[AutomationBrowser] loaded browser-use chrome runtime",{adapterEntry:e,launchEntry:t,exports:Object.keys(i).sort()}),i})).catch((r=>{throw browserUseChromePromise=null,kernel.logger.error("[AutomationBrowser] failed to load browser-use chrome runtime",{adapterEntry:e,launchEntry:t,error:r}),r}))}return browserUseChromePromise}const STANDALONE_BROWSER_EXECUTABLE_CANDIDATES={darwin:[["chrome-mac","Chromium.app","Contents","MacOS","Chromium"]],linux:[["chrome-linux","chrome"]],win32:[["chrome-win","chrome.exe"],["chrome-win64","chrome.exe"]]};function parseChromiumRevision(e){const t=e.match(/^chromium-(\d+)$/u);return t?Number(t[1]):-1}function resolveStandaloneBrowserExecutablePath(e,t=process.platform){const r=STANDALONE_BROWSER_EXECUTABLE_CANDIDATES[t];if(!r||!fs__default$1.existsSync(e))return;const n=fs__default$1.readdirSync(e,{withFileTypes:!0}).filter((e=>e.isDirectory())).map((e=>e.name)).filter((e=>e.startsWith("chromium-"))).sort(((e,t)=>parseChromiumRevision(t)-parseChromiumRevision(e)));for(const t of n)for(const n of r){const r=path__default.join(e,t,...n);if(fs__default$1.existsSync(r))return r}}class BrowserRuntimeService{static instance=null;runtime=null;listenersBound=!1;initializingPromise=null;static getInstance(){return BrowserRuntimeService.instance||(BrowserRuntimeService.instance=new BrowserRuntimeService),BrowserRuntimeService.instance}constructor(){}async getContext(){this.ensureConfigListeners();const e=this.resolveMode();if("off"===e)throw new Error("Browser use is disabled. Please enable it in settings.");this.runtime||(this.initializingPromise||(this.initializingPromise=this.createRuntime(e).finally((()=>{this.initializingPromise=null}))),this.runtime=await this.initializingPromise);return this.runtime.mode===e&&await this.isRuntimeAlive(this.runtime)||await this.reset(e),this.runtime||(this.runtime=await this.createRuntime(e)),await this.ensureRuntimeReady(this.runtime),this.runtime.context}async reset(e=this.resolveMode(),t={}){await this.closeRuntime(),t.eager&&"off"!==e&&(this.runtime=await this.createRuntime(e))}async clearData(){const e=this.resolveMode();await this.reset(e,{eager:!0})}async dispose(){await this.closeRuntime()}resolveMode(){return kernel.config?.browserConfig?.browserMode??"chrome"}ensureConfigListeners(){if(this.listenersBound)return;const e=kernel.config?.onDidChangeConfig;if("function"!=typeof e)return;let t=this.resolveMode();const r=async(e=this.resolveMode())=>{e!==t&&(t=e,await this.reset(e))};e("browserMode",(async e=>{await r(e??this.resolveMode())})),e("browserConfig",(async e=>{await r(e?.browserMode??this.resolveMode())})),this.listenersBound=!0}async createRuntime(e){switch(kernel.logger.info("[AutomationBrowser] creating runtime",{mode:e}),e){case"standalone":{const t=await loadBrowserUseChrome(),r=this.getStandaloneUserProfilePath(),n=this.resolveStandaloneExecutablePath();if(!n)throw new Error("Standalone browser executable not found in ~/.comate-engine/browser.");const i=9223,o=new t.ChromeBrowserManager;try{let s;try{s=await o.launch({executablePath:n,userDataDir:r,debuggingPort:i,timeout:3e4})}catch(e){this.killStandaloneOrphan(r),s=await o.launch({executablePath:n,userDataDir:r,debuggingPort:i,timeout:3e4})}const a=o.getPersistentContext();if(!a)throw new Error("Standalone browser launched without a persistent context.");const c=await t.ChromeContext.fromBrowser(s,a);return kernel.logger.info("[AutomationBrowser] standalone runtime ready",{mode:e,executablePath:n}),{manager:o,context:c,mode:e}}catch(t){throw await o.close().catch((()=>null)),kernel.logger.error("[AutomationBrowser] standalone runtime failed",{mode:e,error:t}),t}}case"chrome":{const t=await loadBrowserUseChrome(),r=new t.ChromeBrowserManager,n=await r.launchAndConnectCDP(),i=r.getPersistentContext(),o={manager:r,context:await t.ChromeContext.fromBrowser(n,i),mode:"chrome"};return await this.ensureRuntimeReady(o),kernel.logger.info("[AutomationBrowser] chrome runtime ready",{mode:e}),o}case"builtin":{const t=await loadBrowserUseVscode(),r=new RemoteVscodeAPI,n=await t.VscodeContext.create(r);return kernel.logger.info("[AutomationBrowser] builtin runtime ready",{mode:e}),{manager:null,context:n,mode:e}}default:throw new Error(`Unsupported browser mode: ${e}`)}}getStandaloneUserProfilePath(){return path__default.join(os__default$1.homedir(),".comate-engine","browser","comate-automation-browser-profile")}getStandaloneBrowserRootPath(){return path__default.join(os__default$1.homedir(),".comate-engine","browser")}resolveStandaloneExecutablePath(){return resolveStandaloneBrowserExecutablePath(this.getStandaloneBrowserRootPath())}killStandaloneOrphan(e){try{"win32"===process.platform?spawnSync$2("powershell.exe",["-NoProfile","-NonInteractive","-Command",`Get-WmiObject Win32_Process | Where-Object {$_.CommandLine -like '*${e}*'} | ForEach-Object {$_.Terminate()}`],{stdio:"ignore"}):spawnSync$2("pkill",["-f",e],{stdio:"ignore"})}catch{}}async closeRuntime(){const e=this.runtime;if(this.runtime=null,e){try{await e.context.close()}catch{}if(e.manager)try{await e.manager.close()}catch{}}}async isRuntimeAlive(e){if(e.context.isClose)return!1;if(e.manager&&!e.manager.isRunning())return!1;if("chrome"!==e.mode)return!0;try{return(await e.context.getPages()).some((e=>!e.isClosed()))}catch{return!1}}async ensureRuntimeReady(e){if("chrome"===e.mode)try{const t=(await e.context.getPages()).find((e=>!e.isClosed()))??await e.context.getSelectedPage();if(!t||t.isClosed())throw new Error("Chrome runtime has no active page");await t.bringToFront()}catch(t){if(this.runtime===e)return await this.closeRuntime(),void(this.runtime=await this.createRuntime("chrome"));throw t}}}function buildAutomationBrowserOutput(e,t=""){return"skipped"===e?"Browser action was skipped by user.":"aborted"===e?"Browser action was aborted by user.":"success"!==e||t?t:"Browser action completed successfully."}const COMMAND_MAP={navigate:"browser_navigate",open:"browser_navigate",go:"browser_navigate",click:"browser_click",dblclick:"browser_click",rightclick:"browser_click",click_at:"browser_click_at",type:"browser_type",screenshot:"browser_take_screenshot",snapshot:"browser_take_snapshot",html:"browser_get_html",scroll:"browser_scroll",back:"browser_go_back",forward:"browser_go_forward",reload:"browser_reload",status:"browser_get_state",evaluate:"browser_evaluate",eval:"browser_evaluate",new_page:"browser_new_page",close_page:"browser_close_page",select_page:"browser_select_page",fill_form:"browser_fill_form",console:"browser_get_console_messages",drag:"browser_drag"},SCREENSHOT_FORMATS$1=new Set(["png","jpeg","webp"]),SCROLL_DIRECTIONS=new Set(["up","down","left","right"]),CLICK_BUTTONS=new Set(["left","right","middle"]),MODIFIER_ALIASES={alt:"Alt",cmd:"Meta",command:"Meta",control:"Control",controlormeta:"ControlOrMeta",ctrl:"Control",meta:"Meta",shift:"Shift"};function tokenizeAutomationBrowserCommand(e){const t=e.trim(),r=[];let n="",i=null,o=!1,s=!1;for(let e=0;e<t.length;e++){const a=t[e],c=t[e+1];if(o)n+=a,s=!0,o=!1;else if("\\"!==a)i?a===i?i=null:(n+=a,s=!0):'"'!==a&&"'"!==a?/\s/u.test(a)?s&&(r.push(n),n="",s=!1):(n+=a,s=!0):(i=a,s=!0);else{if(c&&(i&&c===i||!i&&('"'===c||"'"===c||"\\"===c||/\s/u.test(c)))){o=!0,s=!0;continue}n+=a,s=!0}}return o&&(n+="\\",s=!0),s&&r.push(n),r}function parseInteger(e,t){const r=Number.parseInt(e||"",10);if(Number.isNaN(r))throw new Error(`${t} expects an integer value.`);return r}function parseNumber(e,t){const r=Number(e);if(!Number.isFinite(r))throw new Error(`${t} expects a numeric value.`);return r}function collectOptionValues(e,t){const r=[];let n=t;for(;n<e.length&&!e[n].startsWith("--");)r.push(e[n]),n++;return{values:r,nextIndex:n-1}}function normalizeModifiers(e){return e.flatMap((e=>e.split(","))).map((e=>e.trim())).filter(Boolean).map((e=>MODIFIER_ALIASES[e.toLowerCase()]||e))}function normalizeFillFormFields(e){if(!Array.isArray(e))throw new Error("fill_form expects a JSON array of fields or an object with a fields array.");return e.map((e=>{if(!e||"object"!=typeof e)return e;const t=e;return t.ref||!t.uid?t:{...t,ref:t.uid}}))}function parseFillFormParams(e){let t,r="";for(let t=0;t<e.length;t++){const n=e[t];if(("--fields"===n||"--json"===n)&&e[t+1]){r=e.slice(t+1).join(" ");break}if(!n.startsWith("--")){r=e.slice(t).join(" ");break}}if(!r.trim())throw new Error("fill_form expects JSON field definitions.");try{t=JSON.parse(r)}catch(e){throw new Error(`fill_form expects valid JSON. ${e instanceof Error?e.message:String(e)}`)}return{fields:normalizeFillFormFields(Array.isArray(t)?t:t&&"object"==typeof t?t.fields:void 0)}}function parseAutomationBrowserCommand(e){const t=tokenizeAutomationBrowserCommand(e),r=t[0]?.toLowerCase();if(!r)return null;const n=COMMAND_MAP[r];if(!n)return null;const i=t.slice(1),o={};switch(r){case"navigate":case"open":case"go":o.url=i[0]||"";break;case"click":case"dblclick":case"rightclick":{const e=[];"dblclick"===r&&(o.doubleClick=!0),"rightclick"===r&&(o.button="right");for(let t=0;t<i.length;t++){const r=i[t];if("--double"!==r&&"--double-click"!==r)if("--button"===r&&i[t+1]){const e=i[t+1].toLowerCase();if(!CLICK_BUTTONS.has(e))throw new Error(`Unsupported click button: ${i[t+1]}`);o.button=e,t++}else if("--modifiers"!==r)r.startsWith("--")||e.push(r);else{const{values:e,nextIndex:r}=collectOptionValues(i,t+1);o.modifiers=normalizeModifiers(e),t=r}else o.doubleClick=!0}o.uid=e[0]||"";break}case"click_at":o.x=parseNumber(i[0],"click_at x"),o.y=parseNumber(i[1],"click_at y");break;case"type":{const e=[];for(let t=0;t<i.length;t++){const r=i[t];"--uid"===r&&i[t+1]?(o.uid=i[t+1],t++):"--submit"!==r?"--slowly"!==r?r.startsWith("--")||e.push(r):o.slowly=!0:o.submit=!0}o.text=e.join(" ");break}case"screenshot":{const e=[];for(let t=0;t<i.length;t++){const r=i[t];"--format"===r&&i[t+1]?(o.format=i[t+1],t++):"--full-page"!==r?"--uid"===r&&i[t+1]?(o.uid=i[t+1],t++):r.startsWith("--")||e.push(r):o.fullPage=!0}!o.format&&e[0]&&SCREENSHOT_FORMATS$1.has(e[0])&&(o.format=e.shift()),e[0]&&(o.filePath=e[0]);break}case"snapshot":case"status":case"back":case"forward":case"reload":break;case"html":o.selector=i.filter((e=>!e.startsWith("--"))).join(" ")||void 0;break;case"scroll":{const e=[];for(let t=0;t<i.length;t++){const r=i[t];"--amount"===r&&i[t+1]?(o.amount=parseInteger(i[t+1],"--amount"),t++):r.startsWith("--")||e.push(r)}e[0]&&SCROLL_DIRECTIONS.has(e[0].toLowerCase())?o.direction=e[0].toLowerCase():o.direction="down",void 0===o.amount&&e[1]&&(o.amount=parseInteger(e[1],"scroll amount"));break}case"evaluate":case"eval":o.script=i.join(" ");break;case"new_page":i[0]&&(o.url=i[0]);break;case"close_page":case"select_page":o.pageIndex=parseInteger(i[0],`${r} index`);break;case"console":for(let e=0;e<i.length;e++){const t=i[e];if("--types"!==t)"--limit"===t&&i[e+1]?(o.limit=parseInteger(i[e+1],"--limit"),e++):"--offset"===t&&i[e+1]?(o.offset=parseInteger(i[e+1],"--offset"),e++):"--include-preserved"!==t&&"--include-preserved-messages"!==t||(o.includePreservedMessages=!0);else{const{values:t,nextIndex:r}=collectOptionValues(i,e+1);o.types=t.flatMap((e=>e.split(","))).map((e=>e.trim())).filter(Boolean),e=r}}break;case"fill_form":Object.assign(o,parseFillFormParams(i));break;case"drag":o.startRef=i[0]||"",o.endRef=i[1]||"",o.startElement=o.startRef,o.endElement=o.endRef}return{toolName:n,params:o}}const MAX_SCREENSHOT_BASE64_SIZE=512e3,MAX_TOOL_RESPONSE_LINES=200,DEFAULT_DIRECTORY=path__default.join(os__default$1.tmpdir(),"browser-use-cache"),SCREENSHOT_FORMATS=new Set(["png","jpeg","webp"]);class AutomationBrowser extends Handler{static runtimeService=BrowserRuntimeService.getInstance();aborted=!1;state="pending";configChangeDisposables=[];constructor(e,t,r){super("automation_browser",e,t,r),t.onNotify((e=>{if(e.payload?.toolId!==this.toolId)return;const t=e.name;if("skip"===t||"confirm"===t)this.promptResolver(t);else if("stop"===t)this.cancel();else if("autoRun"===t){const t=e.payload?.payload;this.handleAutoRunAction(t)}}));const n=()=>{"pending"===this.state&&(this.shouldAutoRun()&&this.promptResolver("confirm"),this.updateResult(this.state,!0))};this.configChangeDisposables.push(kernel.config.onDidChangeConfig("autoExecute",n),kernel.config.onDidChangeConfig("browserConfig",n))}async beforeExecute(){this.getStringParam("command")||this.throwValidationError(ToolError.common.parameter_required({arg:"command"}))}async execute(e){try{const e=this.getStringParam("command"),t=kernel.config.browserConfig?.browserMode;if("off"===t)return this.updateResult("failed"),this.result.output="Browser use is disabled. Please enable it in settings.",this.result;if("skip"===await this.prompt(e))return this.updateResult("skipped"),this.result;this.updateResult("running",!0);try{const t=parseAutomationBrowserCommand(e);if(!t)return this.updateResult("failed"),this.result.output=`Unknown browser command: ${e.split(/\s+/)[0]}`,this.result;const{toolName:r,params:n}=t,i=await loadBrowserUseCore(),o=i.getToolByName(r);if(!o)return this.updateResult("failed"),this.result.output=`Browser tool not found: ${r}`,this.result;const s=await AutomationBrowser.runtimeService.getContext();if(this.aborted)return this.updateResult("aborted"),this.result;const a=await this.normalizeToolParams(r,n,s);kernel.logger.info("[AutomationBrowser] executing tool",{toolName:r,mode:kernel.config.browserConfig?.browserMode,paramKeys:Object.keys(a)});const c=new i.ToolResponse(s,{maxInlineTextLength:MAX_TOOL_RESPONSE_LINES,maxScreenshotBase64Length:MAX_TOOL_RESPONSE_LINES,maxHtmlContentLength:MAX_TOOL_RESPONSE_LINES});await o.handler({params:a},c,s);const l=await c.toMcpResponse();return await this.processMcpResult(l,r,"browser_take_screenshot"===r?a.filePath:void 0),kernel.logger.info("[AutomationBrowser] tool executed successfully",{toolName:r}),this.updateResult("success"),this.forceUpdateToolTurnElement(),this.result}catch(t){if(this.aborted)return this.updateResult("aborted"),this.result;this.updateResult("failed");const r=t?.message||String(t);throw kernel.logger.error("[AutomationBrowser] tool execution failed",{command:e,error:t}),this.throwExecuteError(ToolError.automation_browser.execution_failed({error:r}))}}finally{this.disposeConfigListeners()}}disposeConfigListeners(){this.configChangeDisposables.forEach((e=>e.dispose())),this.configChangeDisposables=[]}rebuildResult(e){super.rebuildResult(e);const t=this.result.metadata.state;"pending"===t?this.result.metadata.state="skipped":"running"===t&&(this.result.metadata.state="aborted")}cancel(){this.aborted=!0,this.updateResult("aborted",!0)}async processMcpResult(e,t,r){const n=[];let i;for(const t of e.content||[])"text"===t.type&&t.text?n.push(t.text):"image"===t.type&&t.data&&(i=t.data);let o=this.truncateResponseText(n.join("\n")||"Command completed successfully.");if("browser_get_html"===t){const e=await import("@baidu/comate-browser-use"),t=e.resolveToolResponseOptions();if(!e.shouldInlineHtmlContent(o,t)){const r=await e.saveTextToLocalFile(o,t,"html","html");o=`HTML content (truncated):\n\`\`\`html\n${e.truncateTextForInlineDisplay(o,t.maxHtmlContentLength)}\n\`\`\`\n${e.buildReadMorePrompt(r.filename)}`}}if(this.result.output=o,r&&(this.result.metadata.screenshotPath=r),i)this.result.metadata.screenshot=i;else if(r){const e=await this.loadScreenshotBase64(r);e&&(this.result.metadata.screenshot=e)}}promptResolver=()=>{};async prompt(e){return this.shouldAutoRun()?Promise.resolve("confirm"):(this.updateResult("pending",!0),new Promise((e=>{this.promptResolver=e})))}shouldAutoRun(){if("zulucli"===process.env.IDE)return!0;return kernel.config.browserConfig?.autoExecute??!1}async handleAutoRunAction(e){if(e&&"enableAutoRun"===e.action){const t=!!e.autoRun;if(await kernel.config.updateBrowserConfig("autoExecute",t),"pending"===this.state){if(this.shouldAutoRun())return this.promptResolver("confirm"),void this.updateResult(this.state,!0)}this.updateResult(this.state,!0)}}async normalizeToolParams(e,t,r){let n={...t};if("browser_type"===e&&!n.uid){const e=await this.resolveFocusedElementUid(r);if(!e)throw new Error("No focused element available. Focus an input first or pass --uid from snapshot.");n.uid=e}if("browser_take_screenshot"!==e)return n;const i=this.normalizeScreenshotFormat(n.format),o=this.resolveScreenshotFilePath(n.filePath,i);return await mkdir$c(path__default.dirname(o),{recursive:!0}),{...n,format:i,filePath:o}}async resolveFocusedElementUid(e){return(await e.getSelectedPage()).evaluate("\n            (() => {\n                const activeElement = document.activeElement;\n                if (!activeElement || activeElement === document.body) {\n                    return null;\n                }\n\n                const existingUid = activeElement.getAttribute('aria-ref') || activeElement.getAttribute('data-comate-uid');\n                if (existingUid) {\n                    return existingUid;\n                }\n\n                const uid = 'focused-' + Date.now();\n                activeElement.setAttribute('data-comate-uid', uid);\n                return uid;\n            })()\n        ")}isScreenshotFormat(e){return!!e&&SCREENSHOT_FORMATS.has(e)}normalizeScreenshotFormat(e){return this.isScreenshotFormat(e)?e:"png"}resolveScreenshotFilePath(e,t){const r=e?.trim();if(!r)return path__default.join(this.getDefaultScreenshotDirectory(),this.buildScreenshotFilename(t));const n=this.expandHomeDirectory(r),i=path__default.isAbsolute(n)?n:path__default.join(this.getRelativeScreenshotBaseDirectory(),n);return this.normalizeScreenshotTargetPath(i,t)}getRelativeScreenshotBaseDirectory(){const e=kernel.env.workspaceInfo.rootPath;return e||this.getDefaultScreenshotDirectory()}getDefaultScreenshotDirectory(){return path__default.join(DEFAULT_DIRECTORY,"images")}normalizeScreenshotTargetPath(e,t){const r=path__default.resolve(e);return path__default.extname(r)?r:path__default.join(r,this.buildScreenshotFilename(t))}buildScreenshotFilename(e){return`screenshot-${Date.now()}.${e}`}expandHomeDirectory(e){return"~"===e?os__default$1.homedir():e.startsWith("~/")||e.startsWith("~\\")?path__default.join(os__default$1.homedir(),e.slice(2)):e}truncateResponseText(e){const t=e.split("\n");return t.length<=MAX_TOOL_RESPONSE_LINES?e:t.slice(0,MAX_TOOL_RESPONSE_LINES).join("\n")+`\n... (truncated, showing ${MAX_TOOL_RESPONSE_LINES} of ${t.length} lines)`}async loadScreenshotBase64(e){try{const t=await readFile$3(e);if(t.byteLength>MAX_SCREENSHOT_BASE64_SIZE)return;return t.toString("base64")}catch{return}}updateResult(e,t=!1){("pending"===this.state||"running"===this.state)&&(this.state=e);const r=buildAutomationBrowserOutput(this.state,this.result.output);return this.result={output:r,metadata:{...this.result.metadata,output:r,state:this.state,autoRun:this.shouldAutoRun()}},t&&this.ctx.userTurn&&this.ctx.userTurn.updateWebviewMessages(),this.result}forceUpdateToolTurnElement(){const e=this.ctx.userTurn.toolTurns.find((e=>e.tools.find((e=>e.toolId===this.toolId))));e&&this.ctx.userTurn.updateWebviewMessages({elementId:e.rollbackMessageId})}}const STOP_TASK_TIMEOUT_MS=1500;class StopTask extends Handler{constructor(e,t,r){super("stop_task",e,t,r)}async beforeExecute(){this.getStringParam("task_id")||this.throwValidationError(ToolError.common.parameter_required({arg:"task_id"})),this.result.metadata.taskId=this.getStringParam("task_id")}async execute(){const e=this.getStringParam("task_id"),t=await this.triggerAndWait(e);t||this.throwExecuteError(ToolError.stop_task.task_not_found({taskId:e})),t.success||this.throwExecuteError(t.reason),this.result.metadata.description=t.description,this.result.metadata.command=t.command;const r=[`Task ${e} stopped.`];return t.description&&r.push(`Description: ${t.description}`),r.push(`Output file: ${t.outputFile}`),this.result.output=r.join("\n"),this.result}triggerAndWait(e){return new Promise((t=>{const r=setTimeout((()=>t(void 0)),STOP_TASK_TIMEOUT_MS);this.token.getRoot()?.broadcast?.("stop-task",{taskId:e,onStopped:e=>{clearTimeout(r),t(e)}})}))}}class TaskComplete extends Handler{constructor(e,t,r){super("task_complete",e,t,r)}async execute(){return this.result.metadata.tasks=this.params.tasks,this.result}}class FileReadTracker{readRanges=new Map;track(e,t,r){if(!e||t<=0||r<t)return;const n=this.normalizePath(e);this.readRanges.has(n)||this.readRanges.set(n,[]),this.readRanges.get(n).push({startLine:t,endLine:r})}isLineRead(e,t){const r=this.normalizePath(e),n=this.readRanges.get(r);return!!n&&n.some((e=>t>=e.startLine&&t<=e.endLine))}getReadRanges(e){const t=this.normalizePath(e);return this.readRanges.get(t)||[]}getAllReadFiles(){return new Map(this.readRanges)}filterCandidates(e,t){if(t.length<=1)return t;const r=t.filter((t=>this.isLineRead(e,t.startLine)));return r.length>0?r:t}trackFromToolResult(e,t,r){"read_file"===e?this.trackReadFile(t,r):"extract_content_blocks"===e?this.trackExtractContentBlocks(t,r):"grep_content"===e&&this.trackGrepContent(t,r)}trackReadFile(e,t){const r=e.path||e.target_file;if(!r)return;const n=parseInt(e.start_line||e.offset||"1",10)||1;let i=parseInt(e.end_line||e.limit||"0",10);if(!i||i<=0){i=n+(t||"").split("\n").length-1}this.track(r,n,i)}trackExtractContentBlocks(e,t){const r=e.pathes;if(!r||"string"!=typeof r)return;const n=r.split("\n").filter((e=>e.trim())),i=/@LINE\[(\d+)\.\.(\d+)\]/g;for(const e of n){const t=e.replace(/@LINE\[.*/,"").trim();if(!t)continue;let r,n=!1;const o=new RegExp(i.source,i.flags);for(;null!==(r=o.exec(e));){const e=parseInt(r[1],10),i=parseInt(r[2],10);e>0&&i>=e&&(this.track(t,e,i),n=!0)}n||this.track(t,1,1e5)}}trackGrepContent(e,t){if(!t)return;const r=t.split("\n"),n=r.some((e=>/^\s*Line\s+\d+:/.test(e)));if(!n)return;let i="";for(const e of r){const t=e.trim();if(!t)continue;if(t.startsWith("Found ")||t.startsWith("Error")||t.startsWith("error"))continue;const r=t.match(/^((?:\/|\.\/)[^:]+):$/);if(r){i=r[1];continue}const n=t.match(/^Line\s+(\d+):/);if(n&&i){const e=parseInt(n[1],10);e>0&&this.track(i,Math.max(1,e-5),e+5)}}}normalizePath(e){return e.replace(/^\.\//,"").trim()}}const normalizeLine=e=>e.trim().replace(/\s+/g," "),EVIDENCE_PATTERN=/<<<EVIDENCE\s+file="([^"]+)"(?:\s+scope="([^"]*)")?(?:\s+startLine="(\d+)")?(?:\s+endLine="(\d+)")?\s*>>>([\s\S]*?)<<<END_EVIDENCE>>>/g,parseEvidenceBlocks=e=>{const t=[];let r;const n=new RegExp(EVIDENCE_PATTERN.source,EVIDENCE_PATTERN.flags);for(;null!==(r=n.exec(e));){const e=r[1],n=r[2]||"",i=r[3]?parseInt(r[3],10):void 0,o=r[4]?parseInt(r[4],10):void 0,s=r[5],a=r[0],c=s.split("\n").filter((e=>""!==e.trim())),l=c.some((e=>"..."===e.trim())),A="<<<CORE_EVIDENCE>>>",u="<<<CORE_EVIDENCE_END>>>",d=s.indexOf(A),h=s.indexOf(u);let p;if(-1!==d&&-1!==h&&h>d){const e=s.slice(d+A.length,h).split("\n").filter((e=>""!==e.trim()));e.length>0&&(p=e.join("\n"))}const g=s.replace(/<<<CORE_EVIDENCE>>>\n?/g,"").replace(/<<<CORE_EVIDENCE_END>>>\n?/g,"").split("\n").filter((e=>""!==e.trim())),f=l;let m,E,C;if(f){const e=g.findIndex((e=>"..."===e.trim()));m=g.slice(0,Math.min(2,e)),E=g.slice(e+1).slice(-2),C=""}else m=g.slice(0,2),E=g.slice(-2),C=g.join("\n");t.push({file:e,scope:n,headLines:m,tailLines:E,fullSnippet:C,isLong:f,rawText:s,originalMatch:a,knownStartLine:i,knownEndLine:o,coreSummary:p})}return t},findMatchPositions=(e,t,r=0,n)=>{if(0===t.length)return[];const i=t.map(normalizeLine),o=n??e.length,s=[];for(let t=r;t<o;t++){if(normalizeLine(e[t])===i[0]){let r=1;for(let n=1;n<i.length;n++)t+n<o&&normalizeLine(e[t+n])===i[n]&&r++;r>=Math.max(i.length-1,1)&&s.push(t+1)}}return s},extractScopeHint=(e,t)=>{const r=[/^\s*(?:export\s+)?(?:async\s+)?function\s+(\w+)/,/^\s*(?:export\s+)?class\s+(\w+)/,/^\s*(?:(?:public|private|protected|static|async)\s+)*(\w+)\s*\(/,/^\s*(?:const|let|var)\s+(\w+)\s*=/,/^\s*def\s+(\w+)\s*\(/,/^\s*func\s+(?:\([^)]*\)\s+)?(\w+)\s*\(/,/^(\w+)\s*\(\)\s*\{/,/^\s*function\s+(\w+)/,/^#\s*(.+)/,/^\/\/\s*(.+)/],n=Math.max(0,t-20);for(let i=t;i>=n;i--){const t=e[i];for(const e of r){const r=t.match(e);if(r)return`位于 ${r[1].trim()} 内`}}return""},anchorLineNumbers=async(e,t,r)=>{const n=new Map,i=async e=>{if(n.has(e))return n.get(e);try{const r=(await t(e)).split("\n");return n.set(e,r),r}catch{return[]}},o=[];for(const t of e){const e=await i(t.file);if(0!==e.length)if(t.knownStartLine&&t.knownEndLine&&t.knownStartLine>0)o.push({file:t.file,startLine:t.knownStartLine,endLine:Math.min(t.knownEndLine,e.length),confidence:"high",matchDetail:"Known line range from code block registry",candidates:[]});else if(!t.isLong&&t.fullSnippet){const n=t.fullSnippet.split("\n").filter((e=>""!==e.trim())),i=findMatchPositions(e,n.slice(0,2)),s=[];for(const e of i){const t=e+n.length-1;s.push({start:e,end:t})}if(0===s.length){const t=findMatchPositions(e,n.slice(0,1));for(const e of t)s.push({start:e,end:e+n.length-1})}o.push(buildAnchorResult(t,s,e,r))}else{const n=findMatchPositions(e,t.headLines),i=findMatchPositions(e,t.tailLines),s=[];if(n.length>0&&i.length>0)for(const e of n)for(const r of i){const n=r+t.tailLines.length-1;n>e&&s.push({start:e,end:n})}if(0===s.length&&n.length>0)for(const e of n)s.push({start:e,end:e+20});if(0===s.length&&i.length>0)for(const e of i){const r=e+t.tailLines.length-1;s.push({start:Math.max(1,r-20),end:r})}o.push(buildAnchorResult(t,s,e,r))}else o.push({file:t.file,startLine:0,endLine:0,confidence:"low",matchDetail:"File not readable",candidates:[]})}return o},buildAnchorResult=(e,t,r,n)=>{if(0===t.length)return{file:e.file,startLine:0,endLine:0,confidence:"low",matchDetail:"No matching position found",candidates:[]};let i=t;if(n&&t.length>1){const r=t.filter((t=>n.isLineRead(e.file,t.start)));r.length>0&&(i=r)}if(1===i.length)return{file:e.file,startLine:i[0].start,endLine:i[0].end,confidence:"high",matchDetail:`Unique match at lines ${i[0].start}-${i[0].end}`,candidates:[]};const o=i.map(((e,t)=>{const n=String.fromCharCode(65+t),i=Math.max(0,e.start-1-3),o=Math.min(r.length,e.end+3),s=r.slice(i,o).map(((e,t)=>`${(i+t+1).toString().padStart(4," ")} | ${e}`)),a=extractScopeHint(r,e.start-1);return{label:n,startLine:e.start,endLine:e.end,contextSnippet:s.join("\n"),scopeHint:a}}));return{file:e.file,startLine:i[0].start,endLine:i[0].end,confidence:"medium",matchDetail:`${i.length} candidates found, needs LLM selection`,candidates:o}},formatFinalReport=(e,t,r)=>{let n=e;for(let e=0;e<t.length;e++){const i=t[e],o=r[e];let s;s="low"===o.confidence||0===o.startLine?`- 📄 \`${i.file}\`\n${i.rawText?formatCodeBlock(i.rawText):""}`:`- 📄 \`${i.file}:${o.startLine}-${o.endLine}\`\n${formatCodeBlock(i.rawText)}`,n=n.replace(i.originalMatch,s)}return n},formatCodeBlock=e=>{const t=e.trim();if(!t)return"";const r=t.split("\n").filter((e=>"..."!==e.trim())).join("\n");return"```\n"+r+"\n```"};function extractReasonAfterEvidence(e,t){const r="<<<END_EVIDENCE>>>",n=e.indexOf(t.originalMatch);if(n<0)return"";const i=e.indexOf(r,n);if(i<0)return"";const o=e.substring(i+18),s=o.indexOf("<<<EVIDENCE"),a=o.indexOf("<annotation_complete");let c=o.length;s>=0&&(c=Math.min(c,s)),a>=0&&(c=Math.min(c,a));const l=o.substring(0,c).trim().split("\n").filter((e=>e.trim())).slice(0,6).join(" ");return l.substring(0,500)}function parseAnnotationPlan(e,t){const r=e.match(/<annotation_plan>([\s\S]*?)<\/annotation_plan>/);if(!r)return null;const n=r[1],i=/<batch\s+id="(\d+)"\s+priority_budget="([^"]*)">\s*<focus>([\s\S]*?)<\/focus>\s*<\/batch>/g,o=[];let s;for(;null!==(s=i.exec(n));){const e=parseInt(s[1],10),t=s[2],r=s[3].trim(),n=t.match(/UNFOLD-1:\s*(\d+)/),i=t.match(/UNFOLD-2:\s*(\d+)/),a=t.match(/UNFOLD-3:\s*(\d+)/),c=t.match(/UNFOLD-4:\s*(\d+)/),l=t.match(/FOLD:\s*(\d+)/);o.push({id:e,priorityBudget:{p1:n?parseInt(n[1],10):1,p2:i?parseInt(i[1],10):2,p3:a?parseInt(a[1],10):3,p4:c?parseInt(c[1],10):2,fold:l?parseInt(l[1],10):2},focus:r})}if(0===o.length)return null;const a=o.reduce(((e,t)=>e+t.priorityBudget.p1),0);if(a>5){const e=5/a;let t=5;for(let r=0;r<o.length;r++)if(r===o.length-1)o[r].priorityBudget.p1=t;else{const n=Math.max(0,Math.floor(o[r].priorityBudget.p1*e));o[r].priorityBudget.p1=n,t-=n}}return{batches:o}}class RetrievalAgent extends Handler{executor=null;combinedSubtaskId="";toolTurns=[];roundCount=0;maxRounds=10;originalMaxRounds=10;roundsExpanded=!1;expansionHint="";toolCallSignatures=[];repetitiveToolHint="";maxSummaryRounds=7;maxParallelism=4;fileReadTracker=new FileReadTracker;retrievalLog=[];effectiveBlocksMap=new Map;codeBlockRegistry=new Map;roundSummaries=[];initialQuery="";retryCount=0;traceEdgesMap=new Map;traceEdgeCounter=0;breadthProbesMap=new Map;breadthProbeCounter=0;unreadTargetsMap=new Map;stuckUnreadHints=[];pathCorrectionHints=new Map;failedToolPaths=new Set;blockFlipCount=new Map;blockLockedAsValid=new Set;blockUnfoldSince=new Map;reasonTooLongWarnings=new Map;foldRereadWarnings=[];readFilesHistory=new Map;exhaustedFiles=new Set;grepFilesHistory=new Map;lastProbeConclusion="";confirmedCount=0;pendingReasoningWarning=null;annotationHasDegradedEvidence=!1;queryIntent="fix";retrievalType="code";modeSwitchRound=-1;modeSwitchCount=0;invalidBlockReasons=new Map;terminationReason="unknown";executeStartTime=0;static ALL_FAIL_LOOP_THRESHOLD=3;consecutiveAllFailRounds=0;lastAllFailSignature="";static MIN_VALID_OUTPUT_LENGTH=50;static MAX_RETRY_COUNT=2;static MAX_BREAK_RETRIES=2;static PHASE_TIMEOUT_MS=12e4;static DOC_SUMMARY_TIMEOUT_MS=18e4;static CLEAN_RETRY_TIMEOUT_MS=3e5;static MAX_TIMEOUT_RETRIES=3;constructor(e,t,r){const n=new Token(`retrieval_agent-${t.id}`);super("retrieval_agent",e,n,r),t.children.push(n)}push(...e){this.toolTurns.push(...e);for(const t of e){const e=this.exhaustedFiles;t.preExecuteHook=async t=>{try{if("read_file"!==t.name)return!1;const r=t.toolHandler?.params?.target_file||"";if(!r||!e.has(r))return!1;const n=`wc -l "${r}" && echo "---HEAD---" && head -5 "${r}" && echo "---TAIL---" && tail -20 "${r}"`;let i="";try{i=(await import("node:child_process")).execSync(n,{encoding:"utf8",timeout:5e3})}catch(e){i=`[stuck_read_intercept] wc/head/tail 执行失败: ${e}`}return t.result.output=`[stuck_read_intercept] 文件 ${r} 已被标记为 exhausted（重复读取 ≥3 次或已完整读取）。\n已自动执行 wc -l / head -5 / tail -20 以提供文件信息：\n\n${i}\n\n请基于以上信息判断是否仍需继续检索该文件，若文件内容已确认则请切换到其他目标。`,t.toolState="executed",console.log(`[stuck_read_intercept] file=${r} redirected to wc-l/head/tail`),!0}catch{return!1}}}}agentInfo;static RETRIEVAL_PHASE_PROMPT='你是一个专注于代码检索的智能体（Retrieval Agent），由 Main Agent 委派执行检索任务。你的唯一职责是：高效、精准地从代码库中收集充分的代码证据。\n\n你不编写代码、不修改文件、不执行部署——你只负责**搜索、阅读和筛选**。\n\n## 核心检索原则\n\n### 1. 批判性验证\n搜到内容后，必须问自己：**"这真的是核心实现吗？"**\n- 找到"相关代码"≠ 找到"实现代码"\n- 常量定义、类型声明、测试用例往往只是**引用**，不是**实现**\n- 如果搜索结果看起来像辅助代码，要继续追踪到真正的实现\n\n### 2. 代码级证据原则（最重要，必须严格遵守）\n**区分"线索"和"证据"——只有读过代码才有证据：**\n- **线索**：grep/search/list_dir 返回的文件路径或匹配摘要。它们只说明"文件中存在某个文本模式"，不能确定其语义角色（可能是注释、文档引用、测试断言、真正的实现）\n- **证据**：通过 read_file 读取并分析了文件的实际代码后，确认某段代码确实实现了目标功能\n\n**硬性规则**：\n- 在 round_summary 中，对**未读代码的文件**只能使用推测性语言（如"可能包含…"、"需下一轮读取确认"），**禁止**使用断言性结论（如"找到了 X 的实现"）\n- 在 effective_blocks 中，**只标注已通过 read_file 实际读取并分析过代码逻辑的块**为 valid。如果某一轮只做了搜索/定位而未读取代码，该轮不应有任何 valid 标注\n- 你作为子 agent，token 预算充裕。**宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论**\n\n❌ 错误：grep 返回 key-bindings.bash → round_summary 写"找到了键绑定实现" → effective_blocks 标 valid\n✅ 正确：grep 返回 key-bindings.bash → round_summary 写"发现该文件包含关键词，可能是实现，需读取确认" → 下一轮 read_file → 确认后 round_summary 写"读取代码确认了第166行的键绑定逻辑" → effective_blocks 标 valid\n\n### 3. 多文件类型覆盖\n功能实现可能跨越多种文件类型，必须全面搜索：\n- **主语言源码**：.go, .py, .ts, .java, .rs 等\n- **Shell 脚本**：.sh, .bash, .zsh, .fish（键绑定、CLI 命令常在此实现）\n- **配置文件**：.json, .yaml, .toml, Makefile\n- **文档**：README.md, *.md（可能包含架构说明）\n\n### 检索意图预分析（第一轮开始前）\n在第一轮搜索之前，先对检索意图（来自 Main Agent 的任务描述）做快速结构化分析：\n\n1. **Stack Trace / 报错路径提取**：如果检索意图中包含 stack trace、编译错误、运行时异常，系统会自动提取其中的源码文件路径并注入到第一轮上下文。你应优先对这些文件执行 read_file，它们是最高置信度的起始点。\n2. **明确提及的文件/函数/类名**：从检索意图中提取所有被直接提及的标识符（文件名、函数名、类名、变量名），作为第一轮搜索的精确关键词。\n3. **多模块特征词识别**：如果检索意图涉及"跨模块"、"前后端"、"多个文件"、"不同目录"等表述，预期检索范围较广，应在搜索策略中安排多方向并行探索。\n4. **修改范围预估**：根据检索意图的复杂度（单函数 bug / 多函数交互 / 架构级变更），预估需要覆盖的文件数和调用深度，合理规划搜索轮次。\n\n### 4. 搜索策略调整\n当初步搜索结果不理想时：\n- **换关键词**：尝试同义词、缩写、变体（如 alt-c, AltC, ALT_C）\n- **换文件类型**：从 *.go 扩展到 *.sh, *.bash\n- **换目录**：从 src/ 扩展到 shell/, scripts/, bin/\n- **用 grep 兜底**：`grep -rn "pattern" . --include="*.sh"`\n\n### 5. 双向追溯调用链（重要）\n找到核心实现代码后，**必须双向追溯**：\n\n**向上追溯**："谁调用了这个函数/类？"\n- **从实现向上追溯**：函数被谁调用 → 调用者被谁调起 → 启动入口 → CLI 命令 → 构建配置（Makefile 等）\n- **从问题描述向外扩展**：检索意图或 issue 中提到的关键词（如 CI、test、timeout、make target、system start）都应该主动 grep 搜索，即使它们看起来与核心功能不直接相关\n- **大胆查看相关文件**：Makefile、测试文件、CLI 命令定义、配置文件等都可能是修复所需的关键上下文\n\n**向下追溯**："这个函数把关键参数传给了谁？"\n- 当函数 A 将关键参数传给子函数 B 时，**必须 read_file 子函数 B 的实现**，确认参数的实际处理逻辑\n- 特别是：参数经过了 if/else 分支、默认值赋值、类型转换等操作后再传递的情况\n- 不能仅看调用方的代码就断言"参数传递正确"——参数可能在 callee 中被覆盖、忽略或错误处理\n- **同文件也要追溯**：即使 callee 在同一文件中，也必须 read_file 对应行范围确认其实现\n\n典型追溯链路：\n- 找到 bulk_create 中 batch_size 参数 → 搜索 batch_size 传递给 _batched_insert → read_file _batched_insert 确认 batch_size 的实际使用逻辑\n- 找到 _parse_annotation 处理类型标注 → 搜索同文件中其他处理类型标注的函数 → 发现 make_xrefs 是另一条独立路径\n- 找到 DNSHandler.swift → 搜索 "DNSHandler" 的所有调用者 → 找到 APIServer+Start.swift → 搜索 "system start" → 找到 SystemStart.swift 和 Makefile\n\n❌ 常见错误：找到函数 A 调用了函数 B 后，只看 A 的代码就断言"参数传递正确"，不去读取 B 的实现\n❌ 常见错误：找到核心实现后就停止搜索，认为"已经足够了"\n✅ 正确做法：找到调用关系后，read_file 被调用函数 B 的完整实现，特别关注 B 中对该参数的实际处理逻辑\n✅ 正确做法：找到核心实现后，继续搜索调用者、启动入口、构建脚本和相关测试，确保覆盖完整的修复链路\n\n### 6. 效率纪律\n- **调研充分性优先**：你作为子 agent，token 预算充裕。**优先保证调研充分性，而非追求最少轮次**。宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论\n- **不重复搜索**：记住已经搜过的文件和模式，不要对同一文件或相同关键词重复发起搜索\n- **存疑即全读**：当你认为某个文件或函数与问题相关但尚不确定具体哪几行，应直接 read_file 该函数/类的完整定义（通常 100-300 行），而非每轮微调 offset/limit 反复读取重叠的小片段。碎片化读取既浪费轮次又导致上下文割裂，无法形成完整理解。正确做法是一次性读取足够范围后在 round_summary 中完整分析\n- **读后必蒸馏**：每次 read_file 完成后，在 <effective_blocks> 的 reason 中记录关键函数名、类名、核心逻辑结论（如"renderBorder() 负责边框绘制，style 为 nil 时跳过渲染；事件循环入口在 UpdateModel()；光标状态由 Model.cursor 字段管理"）。⚠️ 禁止在 reason 中写具体行号——行号易产生幻觉导致后续决策错误；应使用函数名/结构体名/逻辑描述作为语义锚点。reason 是跨轮知识的唯一载体，fold 后仅凭 reason 判断是否需重读。较长的摘要可用 <reason id="blockId">多行内容</reason> 格式\n- **正则保持简单**：使用简单的正则表达式，避免复杂转义。如果需要搜多个变体，拆成多次简单搜索而不是用一个复杂正则\n- **先定位再阅读（严格两轮制）**：read_file 只能读取**前面轮次**已通过搜索、list_dir 或 grep_content 确认存在的文件路径。**同一轮**内不允许既调用 list_dir 又对同一目录调用 read_file——因为 list_dir 的结果要到下一轮你才能看到，本轮的 read_file 参数只能基于上一轮已确认的路径\n\n### 7. 禁止猜测文件名（最高优先级，违反则严重扣分）\n**绝对禁止**凭直觉猜测文件路径来调用 read_file。你不知道项目的文件命名规范（例如 Go 项目不一定有 key.go、action.go、types.go），猜测会导致大量 "File does not exist" 错误，严重浪费轮次。\n\n**典型错误模式**：\n- 你看到 src/ 目录存在，就猜测 src/key.go、src/action.go、src/types.go 存在 → 全部失败\n- 你在同一轮同时调用 list_dir("src/") + read_file("src/key.go") → key.go 是猜测，list_dir 还没返回结果\n\n**正确做法**：分两轮——\n- 轮次 N：用 list_dir 查看目录下实际有哪些文件，或用 glob_path/grep_content 确认文件路径\n- 轮次 N+1：基于上一轮返回的**真实文件列表**，read_file 已确认存在的文件\n\n注意：list_dir 的参数名是 target_directory（不是 path），read_file 的参数名是 target_file。\n\n❌ 错误示例：猜测存在 src/key.go、src/action.go、src/types.go 然后直接 read_file → 全部失败\n❌ 错误示例：同一轮 list_dir("src/") + read_file("src/key.go") → key.go 是猜测路径\n✅ 正确示例：轮次 N 调用 list_dir("src/") 看到实际文件列表，轮次 N+1 再 read_file 已确认存在的文件\n\n### 8. 并行工具调用（重要）\n{{PARALLELISM_TARGET}}\n如果你打算调用多个工具且它们之间没有依赖关系，必须在同一轮并行发起所有独立的工具调用。\n优先选择并行调用而非串行调用，以最大化每轮的信息获取效率。\n\n例如：需要读 3 个文件时，同一轮发 3 个 read_file 并行读取，而不是分 3 轮逐个读取。\n\n**可并行的场景**：\n- 多个 read_file（不同文件无依赖）\n- 多个 grep_content（不同关键词/模式无依赖）\n- list_dir(根目录) + grep_content("关键词", files_with_matches)（无依赖，首轮推荐）\n- grep 返回 5 个文件 → 下一轮同时 read_file 其中最相关的 3 个\n\n**必须串行的场景**（工具调用结果会影响后续参数）：\n- list_dir 探索目录 → 下一轮基于结果 read_file（有依赖）\n- read_file 确认内容 → 下一轮根据内容发起更深搜索（有依赖）\n\n每轮仅发 1 个工具调用是严重的效率浪费，在轮次限制下尤其致命。\n\n**首轮并行探测**（以下两步应在第 1 轮同时发起）：\n- list_dir 根目录，了解仓库结构\n- 同时用 grep_content(pattern="核心关键词", -i, files_with_matches) 快速定位候选文件\n\n❌ 错误：第 1 轮只发 list_dir，等结果后第 2 轮再搜索 → 浪费 1 轮\n✅ 正确：第 1 轮同时 list_dir + grep_content，第 2 轮基于两者结果并行 read_file 多个文件\n\n## 工具使用\n\n### 搜索定位（按优先级）\n1. **codebase_search**: 语义搜索，适合不确定关键词时的探索。**当你对文件名不确定时，应优先使用此工具而不是猜测文件名**。\n2. **grep_content**: 正则匹配，支持指定文件类型。在已知文件名或路径时，用它进行符号级精确验证。\n3. **glob_path**: 了解目录结构，发现非标准目录（如 shell/, scripts/）\n\n### 文件阅读\n- **read_file**: 深度阅读目标文件（逐文件精读）\n\n### 命令行兜底\n- **run_command**: 只读命令，当其他工具不够灵活时使用\n- **文件信息确认（常用）**：\n  - `wc -l {path}` → 确认文件总行数，判断是否已读完\n  - `tail -20 {path}` → 查看文件末尾内容\n  - `head -20 {path}` → 查看文件开头内容\n  - `cat {path}` → 小文件完整查看（建议 < 100 行时使用）\n- **内容搜索兜底**：`grep -rn "pattern" /path --include="*.sh"`、`find /path -name "*.ts"`\n- **严格限制**: 仅限只读操作，禁止修改文件\n\n## 逐轮思考与证据筛选（最重要，必须严格遵守）\n\n**每轮工具调用结束后**，你必须先输出思考摘要，再对工具返回结果做有效性判断。系统会从你的输出中提取这两段内容，作为下一轮的历史上下文注入——如果你不输出，下一轮你将看不到之前的检索进展。\n\n### 第一步：输出思考摘要\n\n用 <round_summary> 标签包裹本轮的思考。\n\n⚠️ **round_summary 防幻觉规则（必须严格遵守）**：\nround_summary 会被注入到后续每一轮的上下文中。如果其中包含不准确的代码细节（方法名、行号、代码片段），会在多轮累积后导致严重幻觉。因此：\n- ✅ 记录：搜索了什么、找到了什么文件、分析结论的**概括**、排除方向、下一步计划、向上追溯的思路\n- ❌ **禁止**记录：具体行号、方法签名、代码片段、API 名称等代码细节（这些已由 effective_blocks 的 reason 字段精确记录，无需在 round_summary 中重复）\n\n搜索/定位轮示例（未读代码，只有线索）：\n<round_summary>\n本轮线索：grep 发现 shell/ 下三个脚本文件包含 Alt-C 关键词，可能是键绑定实现，需下一轮读取确认。src/options.go 也匹配，可能是配置相关。\n排除方向：src/ 下没有 action/ 子目录。\n下一步：读取 shell/ 下的三个脚本文件代码。\n</round_summary>\n\n代码阅读轮示例（已读代码，可下结论）：\n<round_summary>\n本轮证据：读取了 key-bindings.bash 和 key-bindings.zsh，确认了 bash 和 zsh 中的键绑定实现机制。具体代码细节见 effective_blocks 标注。\n排除方向：docs/ 下的文档文件只是用法说明，不含实现。\n下一步：读取 key-bindings.fish 确认 fish shell 实现；追溯调用链——搜索谁调用了这些键绑定函数。\n</round_summary>\n\nBug fix 场景示例（形成假设并追踪验证状态）：\n<round_summary>\n本轮证据：读取了 lookups.py 中 In.process_rhs 和 related_lookups.py 中 RelatedIn.as_sql，确认了 has_select_fields 检查逻辑。\n当前假设：[推测] Q.__or__ 绕过了 has_select_fields 检查导致子查询返回多列。\n假设依赖的未验证前提：\n  - resolve_expression() 中 Query 被 clone 后的 has_select_fields 实际值未确认\n  - default_cols 属性在 clone 过程中的传递逻辑未读取\n下一步：read_file resolve_expression 和 clone 相关代码，验证上述前提。\n⚠️ 深度审查：\n- [待补充] resolve_expression() 中 Query clone 后的状态变化未追踪\n- [待补充] default_cols 的设置和传递逻辑未确认\n</round_summary>\n\n假设验证后更新示例：\n<round_summary>\n本轮证据：读取了 query.py 中 resolve_expression，确认 clone 会保留 default_cols=True。\n当前假设：[已验证] → 修正：问题不在 lookup 的 has_select_fields 检查，而在 resolve_expression 中 clone 后的 Query 未被限制为单列。修正后的假设：resolve_expression 应在 clone 时对非 has_select_fields 的子查询执行 clear_select_clause + add_fields([\'pk\'])。\n下一步：确认 clear_select_clause 和 add_fields 的实现是否支持此修复方向。\n⚠️ 深度审查：\n- [待补充] clear_select_clause 的副作用（是否会影响其他 query 属性）需确认\n</round_summary>\n\n### 深度审查（每轮必做，全局视角）\n\n在 round_summary 末尾，回顾以下深度缺口：\n\n1. **追溯边状态**：检查系统注入的追溯状态表，是否有 pending 边被遗忘超过 2 轮？如果有，本轮应优先处理。标记 valid 代码块时，检查该块中是否有需要注册为新追溯边的 callee/caller/override。\n   - **新增 override 类型**：当某个代码块定义了基类方法（如 `as_sql`、`convert_durationfield_value`、`get_db_converters`），且该方法可能被多个后端/子类 override（如 mysql、sqlite3、oracle 后端）时，必须注册一条 `direction: "override"` 追溯边，target 写 "检索 [backends/子模块] 目录下的 override 实现"。格式：`- edge: "new" | from: "R1-A" | direction: "override" | target: "检索 django/db/backends/mysql/ 中 convert_durationfield_value 的 override 实现" | status: "pending" | reason: "基类方法可能被各后端 override，需验证各后端实现"`\n2. **同文件未覆盖路径**：纵观所有轮次已标记为 valid 的代码块所涉及的文件，是否存在处理同类输入的其他函数/方法？特别是名称相似但用途不同的函数（如 _parse_annotation vs make_xrefs，__iter__ vs _new）。\n3. **根因假设的未验证前提**：如果你已经在 round_summary 中形成了关于根因/机制的假设（如"问题出在 X 函数的 Y 逻辑"），检查这个假设是否依赖了尚未通过 read_file 验证的前提。典型的未验证前提包括：\n   - 假设 A 调用 B 时传递了某个参数值，但 A→B 的调用链中间经过了 clone/transform/resolve 等操作，中间状态未被 read_file 确认\n   - 假设某个属性/变量在执行到某处时的值为 X，但该值的设置逻辑未被追踪\n   - 假设某个条件分支会/不会被触发，但触发条件依赖的上游逻辑未被读取\n   如果存在未验证前提，该假设只能作为"推测方向"而非"确认结论"——必须在后续轮次中 read_file 验证这些前提，验证通过才能升级为确认结论。\n\n⚠️ 当基类/父类的方法与当前子类的方法处理同类逻辑时，必须分别验证两者的实现，不能仅验证子类就断言"基类也正确"。\n\n### 第二步：标记有效代码块\n\n系统会在每轮工具返回后自动对代码内容进行编码（如 [R1-A]、[R1-B]），并在下一轮注入编号列表和首尾代码摘要。**你只需引用编号做选择，不要手写文件路径和行号。**\n\n⚠️ **只有通过 read_file 实际读取并分析过代码的块才能标记为 valid**。如果某一轮只做了 grep/search/list_dir/glob_path（未读代码），该轮不应有 valid 标注——因为搜索结果只是线索，不是证据。\n\n#### 导航类返回 vs 代码类返回\n工具返回分为两类，标记方式不同：\n- **导航类**（grep_content files_with_matches / glob_path）：返回的是文件名列表，**不包含代码内容**。这些块一律标 invalid，reason 写"定位到关键文件：xxx、yyy，非代码块"即可。关键文件位置应记录在 round_summary 中以保持记忆。\n- **代码类**（read_file / grep_content content 模式 / codebase_search）：返回的是实际代码（codebase_search 返回带行号的代码片段）。必须**仔细阅读代码逻辑**后判断 valid/invalid，reason 中说明具体的代码逻辑分析结果。\n\n用 <effective_blocks> 标签对本轮代码块做 valid_unfold/valid_fold/invalid 判断：\n\n<effective_blocks>\n- block: "R1-A" | status: "invalid" | reason: "定位到关键文件：key-bindings.bash/zsh/fish，非代码块"\n- block: "R2-A" | status: "valid_unfold" | reason: "bash 中的键绑定核心实现，后续需基于代码追踪调用链"\n- block: "R2-B" | status: "valid_fold" | reason: "zsh 键绑定实现，已确认机制，不需要反复查看"\n- block: "R2-C" | status: "invalid" | reason: "只是 UI 颜色处理，与快捷键绑定无关"\n</effective_blocks>\n\n后续轮次中切换已有代码块的展示模式：\n<effective_blocks>\n- block: "R2-A" | status: "valid_fold" | reason: "键绑定实现已充分分析，释放空间"\n- block: "R3-A" | status: "valid_unfold" | reason: "需要重新确认 fish shell 的实现细节"\n</effective_blocks>\n\n如果之前标记为 valid 的代码块后续发现不相关，用 status: "invalid" 移除：\n<effective_blocks>\n- block: "R1-A" | status: "invalid" | reason: "之前误标，实际是通用工具函数"\n</effective_blocks>\n\n### 检索完成信号\n当你认为已经收集到**足够的证据**来完整回答检索意图时，在输出 <round_summary> 和 <effective_blocks> 之后，额外输出一个 `<retrieval_complete/>` 标签：\n\n<round_summary>\n...本轮的思考总结...\n</round_summary>\n\n<effective_blocks>\n...本轮的代码块标记...\n</effective_blocks>\n\n<retrieval_complete/>\n\n系统会检测到此信号，自动进入汇总阶段——为你提供所有已标记有效代码块的完整内容，届时按汇总格式输出最终报告。\n\n⚠️ **输出 `<retrieval_complete/>` 前必须满足以下条件**：\n1. **至少对核心实现文件做过 read_file 精读**。codebase_search / grep_content 返回的是索引级摘要片段（通常只有几十行），不能替代对核心模块的完整阅读。如果你的 valid 代码块全部来自 codebase_search 而没有经过 read_file 精读，说明检索深度不足，不应结束\n2. **round_summary 中不能存在未执行的"下一步计划"**。如果你在 round_summary 中写了"下一步需要读取/搜索 XXX"，那就必须先执行这些计划，不能一边写计划一边输出 retrieval_complete\n3. **有效代码块数量不能为 0**。如果你已经搜索了多轮但没有标记任何代码块为 valid，说明搜索策略可能有问题——尝试换用不同的搜索关键词、换用 codebase_search 进行语义搜索、或扩大搜索范围。不要在 0 个有效证据的情况下结束检索\n4. **请勿自行编写最终检索报告**。输出 `<retrieval_complete/>` 后等待系统注入汇总指令即可。如果你不确定证据是否充分，就继续搜索，不要输出此标签\n5. **根因假设已验证或标记为推测**：如果你在 round_summary 中提出了关于根因/机制的假设，检查该假设依赖的所有前提是否已通过 read_file 验证。对于涉及多层调用链（如 A→B→C）的 bug fix 场景，仅 read_file 了 A 和 C 而跳过了中间的 B 是不够的——调用链中任何未读取的中间环节都可能改变参数、状态或执行路径。如果假设依赖的前提仍有未验证项，必须在 round_summary 中将假设显式标记为"推测方向"（而非"已确认"），并在下一步计划中列出需要验证的具体代码路径。\n6. **追溯边和广度探测已完成**：如果系统在检索进度摘要中显示了"待完成追溯"（pending trace edges）或"广度探索提醒"（needs_exploration breadth probes），必须先处理完这些项（标记为 resolved/explored 或 not_applicable）才能结束检索。\n7. **必须先输出 `<retrieval_exit_check>` 自检块**：在满足上述 1–6 条的基础上，还需完成以下结构化自检。系统将解析该块，若缺失或 `exit_verdict=BLOCKED`，`<retrieval_complete/>` 将被视为 `plan_action_conflict` 并触发干净重试。\n\n**退出自检格式（紧接 round_summary 输出，位于 `<retrieval_complete/>` 之前）**：\n\n```xml\n<retrieval_exit_check>\n  <evidence_density status="PASS|INSUFFICIENT">\n    valid effective_blocks: N 个，涉及 M 个文件。\n    [INSUFFICIENT 原因：哪些核心路径尚无 valid block]\n  </evidence_density>\n\n  <core_read_depth status="PASS|INSUFFICIENT">\n    已 read_file 精读的文件列表（每项需有明确理由）：\n    - [文件名]：[原因]\n    callee 追溯：已追溯到叶节点 / 边界明确（[原因]）\n    [INSUFFICIENT：哪个 callee 未精读及原因]\n  </core_read_depth>\n\n  <expected_behavior_coverage status="PASS|INSUFFICIENT|N/A">\n    （fix/understand 类查询强制填写；N/A 仅适用于纯架构探索类）\n    是否查阅了 test 文件 / 注释 / 文档以确认期望行为：[是/否]\n    [否时：必须说明为何可以在不知期望行为的情况下完成检索]\n  </expected_behavior_coverage>\n\n  <coverage_gaps>\n    本次检索主动未探索的相关区域及排除原因：\n    - [区域/文件/方向]：[排除原因，"与核心路径无关因为..."]\n    （若有遗漏但无法确定是否相关，标记为"推测可忽略，原因..."）\n  </coverage_gaps>\n\n  <exit_verdict status="APPROVED|BLOCKED">\n    [BLOCKED：指出哪个维度不通过，需要补做什么]\n  </exit_verdict>\n</retrieval_exit_check>\n```\n\n### 第二步半：管理追溯边\n\n在输出 <effective_blocks> 之后，输出 <trace_edges> 标签管理调用链追溯状态。\n\n**注册新追溯边**：当你标记一个代码块为 valid_unfold/valid_fold 时，检查该块中是否存在：\n1. **向下调用**：该函数/方法将关键参数传递给了子函数，且子函数尚未被 read_file\n2. **向上调用**：该函数/方法的调用者尚未确认\n\n如果存在，注册为 pending 追溯边：\n<trace_edges>\n- edge: "new" | from: "R2-A" | direction: "callee" | target: "compiler.py:_batched_insert()" | status: "pending" | reason: "bulk_create 将 batch_size 传给此函数，需确认处理逻辑"\n</trace_edges>\n\n**更新追溯边**：当你在后续轮次中追溯到了目标代码并标记了对应代码块时，更新边状态：\n<trace_edges>\n- edge: "TE-1" | status: "resolved" | resolved_block: "R4-B" | reason: "已读取 _batched_insert 实现，确认参数处理"\n</trace_edges>\n\n**标记不需要追溯**：如果某条边经分析不需要追溯（目标是标准库、日志函数等），标记为 not_applicable：\n<trace_edges>\n- edge: "TE-2" | status: "not_applicable" | reason: "调用的是 logging.debug()，标准库无需追溯"\n</trace_edges>\n\n**追溯链延续规则**：当某条追溯边 resolved 到一个 valid 代码块时，检查这个新的 valid 块是否也有需要追溯的 callee/caller。如果有，注册新的 pending 边。追溯链直到末端块被判为 invalid（离开修改影响范围）或 not_applicable（无需追溯）时自然终止。\n\n⚠️ 存在 pending 追溯边时，**禁止输出 <retrieval_complete/>**。\n⚠️ 如果本轮没有新的追溯边需要注册或更新，可以不输出 <trace_edges> 标签。\n\n### 第二步 C：广度探测响应\n\n系统会自动检测：当某个目录下已有 2 个以上 valid 代码块时，会在检索进度摘要中显示"广度探索提醒"。\n\n看到提醒后，你需要评估该目录下未检查的文件和同级目录是否可能与检索意图相关，并在 <breadth_status> 中输出判断结果：\n\n<breadth_status>\n- probe: "BP-1" | status: "explored" | reason: "已检查 backends/ 下所有 4 个后端，确认都需要同步修改"\n</breadth_status>\n\n或者：\n<breadth_status>\n- probe: "BP-1" | status: "not_applicable" | reason: "同目录其他文件是 __init__.py 和 utils.py，与当前检索意图无关"\n</breadth_status>\n\n⚠️ 存在 needs_exploration 的广度探测时，**禁止输出 <retrieval_complete/>**。\n⚠️ 如果当前没有广度探测提醒，不需要输出 <breadth_status> 标签。\n\n### 第二步 D：未读目标间隙上报\n\n当你在某一轮通过 grep_content / glob_path / codebase_search 等方式**识别了需要 read_file 的目标文件**，但**本轮实际未对这些文件完成 read_file 调用**时，在 <round_gaps> 中列出：\n\n<round_gaps status="PENDING">\n- file: "src/foo/bar.ts" | reason: "grep 命中但本轮 token 不足，留到下轮读"\n- file: "src/baz/qux.ts" | reason: "目录浏览发现相关文件，尚未读取"\n</round_gaps>\n\n如果本轮所有识别的目标文件均已完成 read_file，或本轮未识别任何新的目标文件，输出：\n\n<round_gaps status="CLEAN"/>\n\n⚠️ 连续 2 轮或以上报告同一文件为 PENDING，说明该文件被反复推迟——**下一轮必须优先 read_file 读取**。\n⚠️ <round_gaps> 不是可选项：每轮都必须输出，要么 PENDING（列出未读文件），要么 CLEAN。\n\n### 第三步：输出下一轮工具调用（如果不输出 <retrieval_complete/>）\n\n### 格式规则\n- **所有字段统一为 key: "value" 格式**，方便系统自动解析\n- **block**（必填）：系统编码的代码块编号，如 "R2-A"、"R3-B"。只引用系统注入的编号，不要自己编造\n- **status**（必填）：`"valid_unfold"` / `"valid_fold"` / `"invalid"` 三选一\n  - `"valid_unfold"`：标记为有效，展开完整代码到后续轮次上下文。用于核心实现代码，后续多轮需基于代码细节做串行推理\n  - `"valid_fold"`：标记为有效，只保留 snippet 摘要。用于有效但不需要反复查看细节的代码\n  - `"invalid"`：不相关，或需要移除之前标记的块\n- **reason**（status 为 valid_unfold/valid_fold/invalid 时必填）：记录关键函数名、类名和核心逻辑结论（语义锚点）。⚠️ 禁止写具体行号（行号易产生幻觉导致后续决策错误）。支持扩展格式 `<reason id="blockId">多行内容</reason>` 用于较长摘要\n- ⚠️ **不需要写 file 和 lines 字段**——系统已通过编码精确记录了每个代码块的文件路径和行号\n\n### 规则\n1. **每轮都必须输出 <round_summary> 和 <effective_blocks>**，对本轮所有系统编码的块逐一做 valid_unfold/valid_fold/invalid 判断。即使本轮只做了导航类操作，系统也会对工具返回编码，你必须对每个编码块做显式分析（导航类标 invalid 并记录关键文件位置），这能确保你的推理链条完整连贯\n2. 只标记与检索意图**直接相关**的工具返回为 valid_unfold 或 valid_fold，无关的标记为 invalid\n3. status: "valid_unfold" / "valid_fold" 的代码块会被系统保留到 Map 中，下一轮你会在历史摘要中看到\n4. status: "invalid" 的不会被保留，但 round_summary 中应说明排除原因\n5. 如果发现之前标记的代码块实际无关，用 status: "invalid" 移除\n6. 如果本轮所有编码块全部无关，<effective_blocks> 中全部标记为 invalid 即可\n7. **连续多轮全部 invalid 自检**：如果你已经连续 2 轮以上将所有代码块标记为 invalid，说明搜索方向可能有偏差。此时应在 round_summary 中反思搜索策略，主动调整方向（换关键词、用语义搜索 codebase_search、尝试 list_dir 探索目录结构），而不是继续相同模式的无效搜索\n8. status: "valid_unfold" 的代码块会在后续每轮上下文中展示完整代码，无需重新 read_file\n8b. 已收起（valid_fold）的块同样是你已经读取过的内容——fold 后通过 reason 摘要判断是否需要重新查看细节。若需要，请用 "valid_unfold" 展开，而非重新发起 read_file（重新 read_file 会被系统拦截并提示补充 reason）\n9. 当不再需要查看某个展开块的细节时，及时用 "valid_fold" 收起以释放上下文空间\n10. 同时展开的代码块建议不超过 2-3 个，当你只需要记住结论时用 valid_fold\n11. **完整性判断**：当标记一个代码块为 valid_unfold 或 valid_fold 时，如果该块只覆盖了某个方法/函数/类的部分实现（例如只读到了方法的前 50 行，但该方法还有后续逻辑未读取；或者只读了类的部分方法），应在 reason 中标注"⚠️ 部分覆盖：该方法/类的 XXX 部分尚未读取"，并在 round_summary 的下一步计划中列入"读取剩余部分"\n12. **追溯边联动**：当标记代码块为 valid_unfold 或 valid_fold 时，检查该块是否存在尚未追溯的 callee/caller 关键调用。如果有，在同一轮的 <trace_edges> 中注册为 pending 边。这能确保依赖链不被遗漏\n12b. **数据流上游追踪（N3 逆向追溯）**：\n   - **调用方追踪**：找到报错/症状函数 B 后，额外搜索"谁调用了 B"（call site），判断 fix 是在 B 内部还是在调用方 A 侧（过滤输入/边界控制）。典型错误：只修改了 B 的内部实现，而实际 fix 应在调用方传入前做过滤。\n   - **数据流上游追踪**：找到变量的"使用点"后，额外追溯该变量的"来源路径"——它在哪个类/函数中被初始化？经过哪些中间处理？是否在某个环节被丢弃/覆盖？这类信息通常在比工厂函数/调用函数更靠前的类定义中（如 Options/Metaclass 层）。典型错误：只看到变量的"使用端"，遗漏了"定义端"导致修改了症状而非根因。\n13. **完成标准（最高优先级）**：**禁止在 effective_blocks 中没有任何 valid_unfold 或 valid_fold 记录的情况下输出 <retrieval_complete/>**。即便你认为自己已经知道答案，也必须通过工具实际搜索、read_file 读取文件内容、在 effective_blocks 中标记至少一条 valid 记录，才可以输出 retrieval_complete。导航类操作（glob_path/list_dir/grep_content）的返回结果可以标 invalid，但这不代表你完成了检索——必须 read_file 读取实际内容并标记 valid 块。\n   - ❌ 错误：调用了 glob_path 获取文件列表后直接输出 retrieval_complete（文件列表不是有效证据，effective_blocks 中无 valid 块）\n   - ❌ 错误：没有调用任何工具就直接输出 retrieval_complete（禁止行为）\n   - ✅ 正确：glob_path/grep_content 找到候选文件 → read_file 读取内容 → 确认内容与检索意图相关 → effective_blocks 标 valid → 再输出 retrieval_complete\n14. **架构查询豁免**：若检索意图属于"分析架构"/"了解模块分布"/"理解系统设计"/"找相关模块"类型，已通过 read_file 读取的**各核心模块文件**（入口文件、接口定义、关键子包）应优先标为 `valid_fold`，而非因"不是核心实现"而标 invalid。架构查询的证据价值在于确认模块存在及其组织关系，漏掉任何一个相关模块文件都会导致汇总阶段架构图不完整。\n   - ❌ 错误：架构查询时，把 tui/terminal.go、tui/light.go 等"已读取的子包文件"标为 invalid，导致汇总时模块缺席\n   - ✅ 正确：架构查询时，所有已读取的核心模块文件标 valid_fold，reason 写明该模块在架构中的角色\n\n### ❌ 错误做法\n- 直接输出工具调用而不先输出 <round_summary>\n- 省略 status 字段或使用非标准值\n- 不输出 <round_summary>（会导致下一轮丢失检索上下文）\n- 自己手写文件路径和行号（如 file: "/path" | lines: "48-51"）而不使用系统编号\n\n完成检索后会有专门的汇总指令，届时基于已筛选的有效代码块组织输出。当前阶段专注于：搜索 → 阅读 → 思考总结 → 标记证据 → 下一轮搜索。';static SUMMARY_PHASE_PROMPT='【汇总阶段】你已完成所有检索。请立即停止调用工具，基于已筛选的有效代码块输出结构化检索报告。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 已确认的有效代码块（元数据索引）\n以下是检索过程中你标记为有效的代码块索引信息（包括文件路径、行范围、标记原因、代码预览）：\n{{EFFECTIVE_BLOCKS}}\n\n⚠️ **代码来源约束（最高优先级）**：\nEVIDENCE 标签中的代码**必须**基于上方索引中列出的文件路径和 scope，结合你在检索过程中实际阅读的代码内容来组织。\n上方索引提供了每个有效代码块的精确位置（文件路径、行范围、所属函数/类），以及简短的代码预览，请以此作为定位依据。\n**绝对禁止**凭空编造不存在的文件路径或函数名。如果某段代码你记忆模糊、无法确信其准确性，应标注为"需进一步确认"而非猜测。\n\n## 报告格式\n\n请基于以上有效代码块，生成最终报告。格式如下：\n\n---\n## 检索结论\n\n（3-5句话，直接回答原始检索意图的核心问题，点明关键文件和模块。必须基于上方有效代码块中的具体细节得出结论。特别注意：代码中的可选参数、条件分支对方案的影响；用关键边界值（0, None, 空集）验证你的结论逻辑；如果建议参考某处代码，说明两者的差异）\n\n## 关键证据\n\n每条证据**必须**使用 <<<EVIDENCE>>> 标记包裹代码片段。**绝对禁止在标签中写任何行号**，行号由系统自动锚定。\n\n⚠️ **关键要求**：如果你不使用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 标签包裹代码，系统将**无法锚定行号**，你的检索报告将**不完整且无法被下游使用**。每一条代码证据都必须用此标签包裹，没有例外。\n\n- **短代码片段（≤30行）**：完整列出所有代码行：\n  <<<EVIDENCE file="/绝对路径" scope="所在函数/类/方法名">>>\n  完整代码内容（每一行都要包含）\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明与检索意图的关联。\n\n- **长代码片段（>30行）**：首尾各保留2行，中间用 ... 省略：\n  <<<EVIDENCE file="/绝对路径" scope="所在函数/类/方法名">>>\n  首行1\n  首行2\n  ...\n  尾行1\n  尾行2\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明核心逻辑。\n\n### ✅ 正确示例\n- **Bash 中的 Alt-C 绑定**：\n  <<<EVIDENCE file="/data/repos/fzf/shell/key-bindings.bash" scope="ALT-C binding section">>>\n  # ALT-C - cd into the selected directory\n  if [[ ${FZF_ALT_C_COMMAND-x} != "" ]]; then\n    bind -m emacs-standard \'"\\ec": " \\C-b\\C-k \\C-u`__fzf_cd__`\\e\\C-e..."\'\n  fi\n  <<<END_EVIDENCE>>>\n  这段代码通过 bash 的 bind 命令将 \\ec（Alt-C）绑定到 __fzf_cd__ 函数。\n\n### ❌ 禁止的格式\n- ❌ 📄 `/data/repos/fzf/shell/key-bindings.bash:166-167`（禁止直接写行号）\n- ❌ 在 <<<EVIDENCE>>> 标签属性中包含任何行号数字\n- ❌ 省略 scope 属性\n- ❌ 代码内容与上方"已确认的有效代码块"索引中的文件路径/scope 不对应\n\n## 未解决问题\n\n（列出检索中未能确认的疑点。特别是：如果你在标注证据时发现代码中调用了未在检索范围内的函数/引用了未在检索范围内的定义（即 [DEPTH-GAP] 情况），在此汇总这些未充分探索的区域及其与检索意图的潜在关联。若无则写"无"）\n\n---\n\n### 🔍 输出前自检清单（必须逐条检查）\n1. 每条证据是否都用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 包裹？**如果有任何一条代码未包裹，整个报告将被系统判定为格式不合规。**\n2. 是否有任何行号数字出现在标签中或 📄 格式中？\n3. file 属性是否为绝对路径？scope 是否已填写？\n4. 代码首尾行是否与检索过程中实际阅读的内容一致？\n5. 关键证据部分是否至少包含 1 个 <<<EVIDENCE>>> 块？**空的关键证据部分是不可接受的。**\n6. 每条 EVIDENCE 中的 file 和 scope 是否能在上方"已确认的有效代码块"索引中找到对应条目？**禁止编造不存在的文件路径或函数名。**\n\n## 汇总质量自检（必须附加在报告之后）\n\n输出完检索结论和未解决问题后，附加以下自检块：\n\n```\n<summary_retrieval_selfcheck>\n  <intent_satisfaction status="SATISFIED|PARTIAL|UNSATISFIED">\n    验证原始检索意图的核心问题是否已被EVIDENCE充分覆盖：\n    SATISFIED：检索意图已有充分证据回答；\n    PARTIAL：部分维度缺乏证据（说明哪些维度）；\n    UNSATISFIED：主要维度缺乏证据，结论可信度低。\n  </intent_satisfaction>\n  <summary_verdict status="APPROVED|NEEDS_REANNOTATION">\n    APPROVED：汇总质量达标，结论可信；\n    NEEDS_REANNOTATION：按以下格式指出需要重新标注的文件及原因：\n    - 文件路径 → 重标注原因\n  </summary_verdict>\n  <type_risk status="NO_RISK|TYPE_RISK">\n    当 FIX-HINT 中建议将某变量初始化为 None/0/空列表/空字符串等默认值时，验证类型兼容性：\n    NO_RISK：已验证下游用法与初始化类型兼容（纯赋值、不涉及 in/+/.[] 操作）；\n    TYPE_RISK：FIX-HINT 存在类型不兼容风险（如 None 赋值但下游调用 .keys()），在 FIX-HINT 中修正或补充类型说明。\n  </type_risk>\n  <fix_hint_4principles status="COMPLIANT|NEEDS_REVISION">\n    对照 4 条 FIX-HINT 原则逐条检查：\n    1. 修改最小化（不引入无关变更）；2. 类型兼容；3. 架构层次约束；4. 调用链层次选择（实现层而非调用侧）。\n    COMPLIANT：FIX-HINT 符合全部 4 条原则；\n    NEEDS_REVISION：说明违反了哪条原则（及影响点）。\n  </fix_hint_4principles>\n  <factory_completeness status="FACTORY_COMPLETE|FACTORY_INCOMPLETE|NOT_APPLICABLE">\n    当 FIX-HINT 目标函数名含 factory/make/create/_base 或目标是元类/基类时：\n    FACTORY_COMPLETE：已验证同模块其他工厂函数/子类无需同步修改；\n    FACTORY_INCOMPLETE：存在其他工厂函数/子类可能需要同步修改，已在 FIX-HINT 中列出；\n    NOT_APPLICABLE：目标不涉及工厂/基类模式。\n  </factory_completeness>\n  <layer_verification status="LAYER_CONFIRMED|LAYER_CHECK_REQUIRED|NOT_APPLICABLE">\n    当 effective_blocks 包含多层级文件时（调用侧+实现侧并存）：\n    LAYER_CONFIRMED：FIX-HINT 选择的是实现/转换层（字段转换器、序列化器、类方法），而非调用侧直接赋值；\n    LAYER_CHECK_REQUIRED：FIX-HINT 目前指向调用侧直接赋值，需评估是否改为修改深层实现；\n    NOT_APPLICABLE：effective_blocks 均在同一层级，无需判断。\n  </layer_verification>\n</summary_retrieval_selfcheck>\n```';static DOC_SUMMARY_PHASE_PROMPT='【汇总阶段】你已完成所有检索。请立即停止调用工具，基于已筛选的有效内容块输出结构化检索报告。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 已确认的有效内容块（元数据索引）\n以下是检索过程中你标记为有效的内容块索引信息（包括文件路径、行范围、标记原因、内容预览）：\n{{EFFECTIVE_BLOCKS}}\n\n⚠️ **内容来源约束（最高优先级）**：\nEVIDENCE 标签中的内容**必须**基于上方索引中列出的文件路径和 scope，结合你在检索过程中实际阅读的文档/代码内容来组织。\n上方索引提供了每个有效内容块的精确位置（文件路径、行范围、所属章节/函数/类），以及简短的内容预览，请以此作为定位依据。\n**绝对禁止**凭空编造不存在的文件路径或章节名。如果某段内容你记忆模糊、无法确信其准确性，应标注为"需进一步确认"而非猜测。\n\n## 报告格式\n\n请基于以上有效内容块，生成最终报告。格式如下：\n\n---\n## 检索结论\n\n（3-5句话，直接回答原始检索意图的核心问题，点明关键文件和模块。必须基于上方有效内容块中的具体细节得出结论。特别注意：内容中的可选参数、条件分支对方案的影响；如果建议参考某处内容，说明两者的差异）\n\n## 关键证据\n\n每条证据**必须**使用 <<<EVIDENCE>>> 标记包裹内容片段。**绝对禁止在标签中写任何行号**，行号由系统自动锚定。\n\n⚠️ **关键要求**：如果你不使用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 标签包裹内容，系统将**无法锚定行号**，你的检索报告将**不完整且无法被下游使用**。每一条内容证据都必须用此标签包裹，没有例外。\n\n- **短片段（≤30行）**：完整列出所有行：\n  <<<EVIDENCE file="/绝对路径" scope="函数/类/方法名或章节名">>>\n  完整内容（每一行都要包含）\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明与检索意图的关联。\n\n- **长片段（>30行）**：首尾各保留2行，中间用 ... 省略：\n  <<<EVIDENCE file="/绝对路径" scope="函数/类/方法名或章节名">>>\n  首行1\n  首行2\n  ...\n  尾行1\n  尾行2\n  <<<END_EVIDENCE>>>\n  后面跟 2-3 句话说明核心内容。\n\n### ✅ 正确示例\n- **HelloGitHub 推荐的爬虫工具**：\n  <<<EVIDENCE file="/data/repos/HelloGitHub/content/HelloGitHub86.md" scope="爬虫工具推荐章节">>>\n  ### Scrapy\n  强大的 Python 爬虫框架，支持异步处理...\n  <<<END_EVIDENCE>>>\n  该段落列出了爬虫工具的具体名称和说明，直接回答检索意图。\n\n### ❌ 禁止的格式\n- ❌ 📄 `/data/repos/HelloGitHub/content/HelloGitHub86.md:139-141`（禁止直接写行号）\n- ❌ 在 <<<EVIDENCE>>> 标签属性中包含任何行号数字\n- ❌ 省略 scope 属性\n- ❌ 内容与上方"已确认的有效内容块"索引中的文件路径/scope 不对应\n\n## 未解决问题\n\n（列出检索中未能确认的疑点。若无则写"无"）\n\n---\n\n### 🔍 输出前自检清单（必须逐条检查）\n1. 每条证据是否都用 <<<EVIDENCE>>> 和 <<<END_EVIDENCE>>> 包裹？**如果有任何一条内容未包裹，整个报告将被系统判定为格式不合规。**\n2. 是否有任何行号数字出现在标签中或 📄 格式中？\n3. file 属性是否为绝对路径？scope 是否已填写？\n4. 内容首尾行是否与检索过程中实际阅读的内容一致？\n5. 关键证据部分是否至少包含 1 个 <<<EVIDENCE>>> 块？**空的关键证据部分是不可接受的。**\n6. 每条 EVIDENCE 中的 file 和 scope 是否能在上方"已确认的有效内容块"索引中找到对应条目？**禁止编造不存在的文件路径或章节名。**';static ANNOTATION_PHASE_PROMPT='你是一个代码证据标注专家，正在对检索阶段筛选出的有效代码块进行精细标注。\n\n## 你的唯一任务\n从系统提供的代码块中，精确标记与检索意图直接相关的代码片段，使用 <<<EVIDENCE>>> 标签包裹。\n\n## EVIDENCE 格式规范\n\n每条证据**必须**使用以下格式：\n\n<<<EVIDENCE file="/绝对路径" scope="所在函数/类/方法名">>>\n代码内容\n<<<END_EVIDENCE>>>\n（2-3句话说明与检索意图的关联）\n\n- **短代码片段（≤30行）**：完整列出所有代码行\n- **中等代码片段（31-100行）**：首尾各保留2行，中间用 ... 省略\n- **无法拆分的长片段（>30行且逻辑上不可分割）**：当代码块内部高度耦合、裁剪任意部分都会丢失理解上下文时（如完整的状态机、密集的数据结构定义、整体都相关的核心算法），先按正常规则写出完整代码（短代码全量，长代码首尾2行+...），再用 CORE_EVIDENCE **嵌套在完整代码内部**圈出最关键的那些行：\n\n```\n<<<EVIDENCE file="/绝对路径" scope="函数名">>>\nfunc longFunc() {\n    setup()\n    ...\n<<<CORE_EVIDENCE>>>\n    criticalLine1()\n    criticalLine2()\n<<<CORE_EVIDENCE_END>>>\n    ...\n    cleanup()\n}\n<<<END_EVIDENCE>>>\n```\n  ⚠️ CORE_EVIDENCE 内的行必须是上方完整代码中实际存在的行，直接复制不要改写；能用 ... 直接省略掉的就不要用此标记\n\n## 精标原则\n\n1. 代码**必须**从系统提供的代码块中直接引用或摘取，**绝对禁止**凭记忆编写代码\n2. 同一个代码块中有多处分散的相关代码，输出多条独立 EVIDENCE\n3. 跳过与检索意图无关的部分（辅助函数、无关常量、样板代码）\n4. 如果整个代码块与检索意图都不相关，可以不输出任何 EVIDENCE\n5. 每条 EVIDENCE 的 scope 应精确到具体函数/方法名\n6. 每条 EVIDENCE 后面的说明开头，用优先级标记该证据对汇总结论的重要程度：\n   - **[UNFOLD-1]**：核心证据——该代码是回答检索意图的核心实现，缺失此代码会导致结论错误。要求：EVIDENCE 代码尽量精简到关键部分（≤30行）。**所有标注轮合计 UNFOLD-1 按文件级计数不超过 5 个文件**（同文件多条 UNFOLD-1 只占 1 个文件配额）。\n   - **[UNFOLD-2]**：重要证据——代码中的参数/分支/边界逻辑对结论准确性有明显影响。要求：同上。\n   - **[UNFOLD-3]**：间接关联——与 query 相关但非直接因果链上的内容（如配置、注册、类型定义、外部文档）。要求：同上。\n   - **[UNFOLD-4]**：辅助参考——有助于理解背景但不直接影响结论的内容（如测试用例、示例、历史变更）。要求：同上。\n   - **[FOLD]**：辅助证据——汇总结论不需要看具体代码行即可得出。要求：说明中必须包含足够详细的分析以替代代码本身（关键参数的行为、边界条件的影响、与其他代码的差异等）。\n   ⚠️ 汇总阶段展开预算约 8000 字符，大多数证据应标为 UNFOLD-2/3/4 或 FOLD，只有"不看代码必然导致结论错误"的才标 UNFOLD-1。\n7. 无论 UNFOLD 还是 FOLD，如果代码中存在以下情况，必须在说明中指出：\n   - **可选参数或条件分支**：指出这些参数/分支对理解或修复方案的影响（如"注意 condition 参数使 partial constraint 不等于 unique=True"）\n   - **边界值行为**：用关键边界值（0, None, 空集）验证代码逻辑，指出异常行为（如"当 min_lines=0 时，num < min_lines 等价于 num < 0，永远不成立"）\n8. **控制流块完整性（Pattern E 规则）**：当修复目标代码位于 if/else/elif/for/while/try/except/match 等控制流结构**内部**时，EVIDENCE **必须覆盖完整的控制流块（包含所有分支）**：\n   - 完整块 ≤50行：直接包含全部分支（if 块 + else/elif 块 + 可能的 else 终止块）\n   - 完整块 >50行：使用 CORE_EVIDENCE 圈出关键行，但 EVIDENCE 框架必须保留所有分支的首行（保留 if/elif/else 各分支的入口行）\n   - **严禁只取一个分支**：if 修复在某分支，仍需包含其余分支（分支间的对比是审阅者判断修复是否完整的关键）\n   - 仅当目标行处于函数顶层（无任何控制流嵌套）时，才可以直接截取目标行 ±N 行\n   - **同类代码差异**：如果检索意图涉及参考其他代码，指出两者在作用范围、粒度、调用时机上的差异\n8. **深度缺口标记**：如果你在阅读代码时发现以下情况，**必须**在对应 EVIDENCE 的说明末尾添加 [DEPTH-GAP] 标记并说明缺失了什么：\n   - 代码中调用了某个函数/方法，但该函数的实现未出现在当前或其他批次的代码块中\n   - 代码中引用了某个变量/常量的定义，但定义未在检索范围内\n   - 当前代码块只覆盖了某个类/模块的部分方法，其他方法可能与检索意图相关但未被检索\n   格式：`[DEPTH-GAP: _batched_insert() 的实现未在检索范围内，该函数接收 batch_size 参数并可能有独立的批次逻辑]`\n   ⚠️ 这个标记非常重要——它帮助汇总阶段区分"已确认无关"和"因探索不足而无法判断"，避免汇总阶段做出过度自信的断言。\n\n## 输出规范\n\n- 直接输出 <<<EVIDENCE>>> 块，不要输出 <round_summary> 或 <effective_blocks> 等标签\n- 完成所有标注后，先输出 `<annotation_coverage_check>` 自检块（见下方格式），再输出 `<annotation_complete/>` 信号\n- 不要调用任何工具\n\n## 标注覆盖自检（必须在 annotation_complete 之前输出）\n\n完成全部 EVIDENCE 标注后，输出以下自检块：\n\n```\n<annotation_coverage_check>\n  <covered_files>已输出EVIDENCE的文件列表（逗号分隔）</covered_files>\n  <skipped_files>未输出EVIDENCE的文件及原因，如"file.go（与检索意图无关）"，若无则写"无"</skipped_files>\n  <evidence_precision status="PASS|IMPRECISE">\n    PASS：所有EVIDENCE的scope范围准确精简（≤30行关键代码）；\n    IMPRECISE：指出哪些EVIDENCE范围过宽，如"xxx.go EVIDENCE 包含了无关辅助代码，应只保留核心函数体"\n  </evidence_precision>\n  <retrieval_reason_alignment status="ALIGNED|PARTIAL|MISALIGNED">\n    逐文件对照检索阶段标记为valid的原因（代码块注释中的reason字段）与实际代码内容是否吻合：\n    ALIGNED：所有文件的检索原因与代码实际行为完全吻合；\n    PARTIAL：部分文件原因与代码有偏差（说明具体文件和偏差点）；\n    MISALIGNED：检索原因与代码实际行为明显不符（说明具体文件和偏差点）。\n  </retrieval_reason_alignment>\n  <coverage_verdict status="COMPLETE|INCOMPLETE">\n    COMPLETE：系统提供的所有valid_unfold代码块均已有对应EVIDENCE输出；\n    INCOMPLETE：指出遗漏的文件，如"tui.go、terminal.go 未标注，原因：XXX"（系统将触发补充标注）。\n  </coverage_verdict>\n  <block_completeness status="BLOCK_COMPLETE|BLOCK_PARTIAL">\n    BLOCK_COMPLETE：所有EVIDENCE块已覆盖完整逻辑块（if/else/elif/for/while 等控制流结构的完整分支）；\n    BLOCK_PARTIAL：某些EVIDENCE范围落在控制流中间，未覆盖完整分支（说明哪个EVIDENCE、缺少哪个分支，系统将扩展范围）。\n    注意：如修复点在 if/else 内，必须确保 EVIDENCE 同时包含所有分支（不能只取一个 branch）。\n  </block_completeness>\n  <reference_bridging status="BRIDGED|UNBRIDGED|NOT_APPLICABLE">\n    当 evidence 中同时存在 [UNFOLD-3]/[UNFOLD-4]（参考实现）和 [UNFOLD-1]/[UNFOLD-2]（修复目标）时：\n    BRIDGED：FIX-HINT 中已明确写出"参照 EVIDENCE X 的模式修改 EVIDENCE Y"；\n    UNBRIDGED：存在参考+目标组合，但 FIX-HINT 未明确桥接（需要补充桥接说明）；\n    NOT_APPLICABLE：evidence 中不存在参考实现与修复目标并存的情况，无需检查。\n  </reference_bridging>\n</annotation_coverage_check>\n```\n\n⚠️ **自检规则**：coverage_verdict=INCOMPLETE 或 evidence_precision=IMPRECISE 时，系统会自动触发补充标注（无需你在此轮内重复输出）；retrieval_reason_alignment=MISALIGNED 时系统记录告警，不阻断标注流程；block_completeness=BLOCK_PARTIAL 时系统记录警告，提示检索轮补充完整分支；reference_bridging=UNBRIDGED 时在 FIX-HINT 中补充桥接说明。';static DOC_ANNOTATION_PHASE_PROMPT='你是一个文档内容标注专家，正在对检索阶段筛选出的有效文档块进行精细标注。\n\n## 你的唯一任务\n从系统提供的文档块中，精确标记与检索意图直接相关的内容片段，使用 <<<EVIDENCE>>> 标签包裹。\n\n## EVIDENCE 格式规范\n\n每条证据**必须**使用以下格式：\n\n<<<EVIDENCE file="/绝对路径" scope="所在章节/小节名">>>\n文档内容\n<<<END_EVIDENCE>>>\n（2-3句话说明与检索意图的关联）\n\n- **短片段（≤30行）**：完整列出所有内容行\n- **中等片段（31-100行）**：首尾各保留2行，中间用 ... 省略\n- **无法拆分的长片段（>30行且逻辑上不可分割）**：当内容内部高度耦合时，先按正常规则写出完整内容（短内容全量，长内容首尾2行+...），再用 CORE_EVIDENCE **嵌套在完整内容内部**圈出最关键的行：\n\n```\n<<<EVIDENCE file="/绝对路径" scope="章节名">>>\n前置内容\n...\n<<<CORE_EVIDENCE>>>\n关键行1\n关键行2\n<<<CORE_EVIDENCE_END>>>\n...\n后续内容\n<<<END_EVIDENCE>>>\n```\n  ⚠️ CORE_EVIDENCE 内的行必须是上方完整内容中实际存在的行，直接复制不要改写；能用 ... 直接省略掉的就不要用此标记\n\n## 精标原则\n\n1. 内容**必须**从系统提供的文档块中直接引用或摘取，**绝对禁止**凭记忆编写内容\n2. 同一个文档块中有多处分散的相关内容，输出多条独立 EVIDENCE\n3. 跳过与检索意图无关的部分（目录、版权声明、无关段落）\n4. 如果整个文档块与检索意图都不相关，可以不输出任何 EVIDENCE\n5. 每条 EVIDENCE 的 scope 应精确到具体章节或小节名\n6. 每条 EVIDENCE 后面的说明开头，用优先级标记该证据对汇总结论的重要程度：\n   - **[UNFOLD-1]**：核心证据——该内容是回答检索意图的核心信息，缺失会导致结论错误。要求：EVIDENCE 内容尽量精简到关键部分（≤30行）。**所有标注轮合计 UNFOLD-1 按文件级计数不超过 5 个文件**（同文件多条 UNFOLD-1 只占 1 个文件配额）。\n   - **[UNFOLD-2]**：重要证据——内容中的具体数据/参数/条件对结论准确性有明显影响。\n   - **[UNFOLD-3]**：间接关联——与 query 相关但非直接因果链上的内容（如背景说明、概念定义）。\n   - **[UNFOLD-4]**：辅助参考——有助于理解背景但不直接影响结论的内容（如示例、注意事项）。\n   - **[FOLD]**：辅助证据——汇总结论不需要看具体内容行即可得出。要求：说明中必须包含足够详细的分析以替代内容本身。\n   ⚠️ 汇总阶段展开预算约 8000 字符，大多数证据应标为 UNFOLD-2/3/4 或 FOLD，只有"不看内容必然导致结论错误"的才标 UNFOLD-1。\n7. **深度缺口标记**：如果你在阅读内容时发现引用了其他章节/文档但未被检索到，**必须**在对应 EVIDENCE 的说明末尾添加 [DEPTH-GAP] 标记并说明缺失了什么。\n\n## 输出规范\n\n- 直接输出 <<<EVIDENCE>>> 块，不要输出 <round_summary> 或 <effective_blocks> 等标签\n- 完成所有标注后输出 <annotation_complete/> 信号\n- 不要调用任何工具';static AUTO_ANNOTATION_PHASE_PROMPT='你是一个内容证据标注专家，正在对检索阶段筛选出的有效内容块进行精细标注。\n\n## 你的唯一任务\n从系统提供的内容块中，精确标记与检索意图直接相关的内容片段，使用 <<<EVIDENCE>>> 标签包裹。\n\n## EVIDENCE 格式规范\n\n每条证据**必须**使用以下格式：\n\n<<<EVIDENCE file="/绝对路径" scope="函数/类/方法名或章节名">>>\n内容\n<<<END_EVIDENCE>>>\n（2-3句话说明与检索意图的关联）\n\n- **短片段（≤30行）**：完整列出所有行\n- **中等片段（31-100行）**：首尾各保留2行，中间用 ... 省略\n- **无法拆分的长片段（>30行且逻辑上不可分割）**：先按正常规则写出完整内容，再用 CORE_EVIDENCE **嵌套在完整内容内部**圈出最关键的行：\n\n```\n<<<EVIDENCE file="/绝对路径" scope="函数名或章节名">>>\n前置内容\n...\n<<<CORE_EVIDENCE>>>\n关键行1\n关键行2\n<<<CORE_EVIDENCE_END>>>\n...\n后续内容\n<<<END_EVIDENCE>>>\n```\n  ⚠️ CORE_EVIDENCE 内的行必须是上方完整内容中实际存在的行，直接复制不要改写；能用 ... 直接省略掉的就不要用此标记\n\n## 精标原则\n\n1. 内容**必须**从系统提供的内容块中直接引用或摘取，**绝对禁止**凭记忆编写\n2. 同一个内容块中有多处分散的相关内容，输出多条独立 EVIDENCE\n3. 跳过与检索意图无关的部分（辅助函数、无关常量、目录、版权声明等）\n4. 如果整个内容块与检索意图都不相关，可以不输出任何 EVIDENCE\n5. 每条 EVIDENCE 的 scope 应精确到具体函数/方法名（代码）或章节名（文档）\n6. 每条 EVIDENCE 后面的说明开头，用优先级标记该证据对汇总结论的重要程度：\n   - **[UNFOLD-1]**：核心证据——该内容是回答检索意图的核心，缺失会导致结论错误。要求：EVIDENCE 内容尽量精简到关键部分（≤30行）。**所有标注轮合计 UNFOLD-1 按文件级计数不超过 5 个文件**（同文件多条 UNFOLD-1 只占 1 个文件配额）。\n   - **[UNFOLD-2]**：重要证据——内容中的参数/分支/数据对结论准确性有明显影响。\n   - **[UNFOLD-3]**：间接关联——与 query 相关但非直接因果链上的内容。\n   - **[UNFOLD-4]**：辅助参考——有助于理解背景但不直接影响结论的内容。\n   - **[FOLD]**：辅助证据——汇总结论不需要看具体内容行即可得出。要求：说明中必须包含足够详细的分析以替代内容本身。\n   ⚠️ 汇总阶段展开预算约 8000 字符，大多数证据应标为 UNFOLD-2/3/4 或 FOLD，只有"不看内容必然导致结论错误"的才标 UNFOLD-1。\n7. 无论 UNFOLD 还是 FOLD，如果内容中存在可选参数/条件分支/边界值行为/同类差异，必须在说明中指出。\n8. **深度缺口标记**：如果内容中引用了未被检索到的函数实现或文档章节，**必须**在对应 EVIDENCE 的说明末尾添加 [DEPTH-GAP] 标记并说明缺失了什么。\n\n## 输出规范\n\n- 直接输出 <<<EVIDENCE>>> 块，不要输出 <round_summary> 或 <effective_blocks> 等标签\n- 完成所有标注后输出 <annotation_complete/> 信号\n- 不要调用任何工具';static FIX_HINT_REQUIREMENT_SEGMENT='\n\n## 修复建议标注（仅修复类 query）\n\n对于标记为 UNFOLD 级别（UNFOLD-1/2/3）的证据，需附加 FIX-HINT 字段：\n- [UNFOLD-1] 核心证据：FIX-HINT 为必填项，必须包含以下三项（格式：`[FIX-HINT] 修改：... | 层次：... | 约束：...`）：\n  1. **修改内容**：此处代码应如何修改（≤150字符）\n  2. **层次选择**：为何在此层实现而非调用方或被调用方？若涉及数据流中间层（类型转换/值设置/状态更新），说明是否存在更合适的上游聚合点（≤100字符）；若无层次分歧则写"当前层次合适"\n  3. **关键约束**：是否有边界条件、多字段/多分支需同步、副作用需验证？若有则明确列出；若无则写"无特殊约束"（≤100字符）\n  如果无法确定修复方向，写：[FIX-HINT] 修改：UNCERTAIN - 需进一步确认（简述不确定原因）| 层次：待总结轮综合确定 | 约束：未知\n- [UNFOLD-2] / [UNFOLD-3] 证据：建议附加 FIX-HINT，如有修复相关见解则写，无则可省略\n- [FOLD] 辅助证据：不需要附加 FIX-HINT\n\n## 修复位置选择原则（FIX-HINT 撰写时需遵守）\n\n1. **根因 vs 症状**：FIX-HINT 应精准指向根本原因，而非仅描述症状触发位置。区分"此处代码触发了错误"（症状）和"此处代码是问题根源"（根因），优先标注根因所在位置。\n2. **修改范围最小化**：优先改最底层的共享逻辑（工具函数 / 基类 / util），避免在多个调用方重复打补丁。同样的逻辑只改一处。\n3. **跨模块依赖标注**：若修改存在跨文件 / 跨模块的联动影响（如基类变更需同步子类），在 FIX-HINT 中显式标注"同步修改: [文件或类名]"。\n4. **架构层次约束**：不要将 model 层逻辑上移到 view 层，不要用应用层代码绕过 DB 约束，保持修改在其所属的架构层次内。\n5. **调用链层次选择（N4）**：当有多个候选修复文件时，优先选择"职责最专一"的实现/转换层（如字段转换应在转换层，序列化应在序列化层），而非调用侧直接赋值层。浅层（调用方直接赋值/访问）的修复是临时绕过，不是根本修复；深层（字段转换层、序列化层、类方法层）的修复让所有调用方自动受益，且符合架构边界。\n\n⚠️ **【Fix F Seg1】禁止全 FOLD（修复类检索专用）**：对于修复类检索（fix intent），至少需要将最相关的 1-2 个证据标为 [UNFOLD-1]，以便总结轮进行跨批次层次推理。若所有证据均为 [FOLD]，请重新评估并至少将修复位置最直接的证据块升级为 [UNFOLD-1]。';static SUMMARY_ANNOTATION_PROMPT='【精细标注轮 {{CURRENT_ROUND}}/{{TOTAL_ROUNDS}}】\n\n系统将有效代码块分批展示，每轮你只需标注当前批次。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n{{PREVIOUS_ANNOTATIONS}}\n\n## 全局有效代码块概览（共 {{TOTAL_BLOCKS}} 个，仅 snippet 预览）\n{{VALID_BLOCKS_OVERVIEW}}\n\n## 本轮待精读的代码块（{{BLOCK_COUNT}} 个，共 {{LINE_COUNT}} 行）\n\n⚠️ **代码来源约束**：EVIDENCE 标签中的代码**必须**从下方代码块中直接引用或摘取。\n\n{{CURRENT_BLOCKS}}\n\n⚠️ **分析性标注要求**：\n1. 每条 EVIDENCE 后用优先级标记重要程度：\n   - [UNFOLD-1]：核心证据，缺失会导致结论错误（代码精简到 ≤30 行）\n   - [UNFOLD-2]：重要证据，参数/分支/边界影响结论准确性\n   - [UNFOLD-3]：间接关联，与 query 相关但非直接因果链上的内容\n   - [UNFOLD-4]：辅助参考，有助于理解背景但不直接影响结论\n   - [FOLD]：辅助证据，说明要写得足够详细以替代代码（关键参数行为、边界条件、差异分析等）\n2. 说明中指出代码的特殊参数/条件分支、边界值行为、与参考对象的差异\n3. **深度缺口标记**：如果代码中调用了未在检索范围内的函数/引用了未在检索范围内的定义，在 EVIDENCE 说明末尾添加 `[DEPTH-GAP: 缺失内容描述]`\n4. ⚠️ **预算约束**：汇总阶段只能展开约 8000 字符的代码（约 5-8 个中等函数）。所有标注轮合计，UNFOLD-1 按文件级计数应控制在 5 个文件以内（同文件多条 UNFOLD-1 只占 1 个配额）——只标注"不看代码就一定会得出错误结论"的证据。大多数证据应该是 UNFOLD-2/3/4 或 FOLD。\n5. **CORE_EVIDENCE（不可拆分的长片段）**：当代码块内部高度耦合、裁剪任意部分都会丢失理解上下文时（>30行且逻辑上不可分割），先按正常规则写出完整代码，再用 `<<<CORE_EVIDENCE>>>` / `<<<CORE_EVIDENCE_END>>>` **嵌套在完整代码内部**圈出最关键的行（必须是完整代码中实际存在的行，直接复制）。能用 `...` 直接省略的就不要用此标记；系统会在预算不足时优先保留 CORE_EVIDENCE 内容。\n\n请对上方代码块中与检索意图相关的代码片段输出 <<<EVIDENCE>>> 标注。\n完成后输出 <annotation_complete/> 信号。';static SUMMARY_FINAL_PROMPT='【汇总阶段 - 最终汇总】\n\n所有代码块已完成精细标注。标注轮中标记为关键（[UNFOLD]）的证据代码已注入下方，辅助证据（[FOLD]）以代码预览 + 分析摘要形式提供。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 各轮标注摘要\n{{ANNOTATION_SUMMARIES}}\n\n## 关键证据代码（标注轮标记为 [UNFOLD]，完整代码）\n{{CRITICAL_EVIDENCES}}\n\n{{UNFOLD_CODE_REINJECTION}}\n\n## 辅助证据摘要（标注轮标记为 [FOLD]，代码预览 + 分析）\n{{FOLD_EVIDENCES}}\n\n## 请输出以下内容\n\n---\n## 检索结论\n\n（3-5句话，直接回答原始检索意图的核心问题。必须基于上方关键证据代码中的具体细节得出结论，不要忽略标注轮分析中指出的边界条件和注意事项。\n\n⚠️ **确定性层级要求**：对涉及的每个关键模块/文件，根据证据充分程度使用不同措辞：\n- 已有 EVIDENCE 覆盖且无 DEPTH-GAP，且检索阶段的根因假设已标记为 [已验证] → 可做确定性结论（如"X 函数的实现逻辑是..."）\n- 标注中标记了 [DEPTH-GAP]，或检索阶段的根因假设仍为 [推测] 状态 → 只能做推测性结论（如"X 函数调用了 Y，但 Y 的实现未被检索，无法确认其内部逻辑"），**禁止**将未充分探索的区域断言为"已确认根因"\n- 特别注意：如果根因涉及多层调用链（A→B→C），仅验证了 A 和 C 而跳过了 B，即使 A 和 C 都有 EVIDENCE 覆盖，结论仍应标记为推测性——因为中间环节可能改变了执行路径\n\n如果输出了多条 EVIDENCE，必须在结论中说明各 evidence 之间的关系：哪些需要同时修改、修改的先后依赖、互补性关系。避免给出一个只基于单条 evidence 的结论而忽略其他 evidence 的约束。\n）\n\n## 未解决问题\n\n（汇总标注轮中所有 [DEPTH-GAP] 标记，列出未被充分探索的函数/模块及其与检索意图的潜在关联。若无 DEPTH-GAP 则写"无"。\n\n格式示例：\n- `_batched_insert()` 的实现未被检索，该函数接收 batch_size 参数，可能存在独立的批次逻辑\n- `make_xrefs()` 与已检索的 `_parse_annotation()` 在同一文件但属于不同代码路径，未确认是否也处理类型标注\n）\n\n---\n\n⚠️ **结论自检**：\n1. 对照关键证据代码，检查标注轮分析中的逻辑是否与代码实际行为一致（如：标注轮称"过滤 X < Y"，代码中 Y=0 时是否真的能过滤？）\n2. 关键证据代码中的特殊参数/条件分支是否已在结论中体现？\n3. 辅助证据的分析摘要中标注的注意事项是否已纳入结论？\n4. 如果结论建议"参考某处的做法"，是否已说明两者的差异？\n5. 标注轮中是否存在 [DEPTH-GAP] 标记？如果存在，结论中是否避免了对相关区域的断言性结论？"未解决问题"中是否已汇总所有 DEPTH-GAP？\n\n## 汇总质量自检（必须附加在结论之后）\n\n输出完检索结论和未解决问题后，附加以下自检块：\n\n```\n<summary_retrieval_selfcheck>\n  <annotation_quality_review status="GOOD|PARTIAL|POOR">\n    评估标注轮整体质量：证据覆盖是否充分、精度是否合格、DEPTH-GAP是否合理标记。\n    GOOD：标注覆盖充分、精度准确；PARTIAL：部分文件标注不足；POOR：大量文件缺失或精度差。\n  </annotation_quality_review>\n  <retrieval_evidence_alignment status="ALIGNED|PARTIAL|MISALIGNED">\n    交叉验证：检索过程中各轮round_summary的结论，在EVIDENCE代码中是否有具体代码行支撑：\n    ALIGNED：所有主要结论都有充分EVIDENCE支持；\n    PARTIAL：部分结论缺乏EVIDENCE代码支撑（说明哪些结论）；\n    MISALIGNED：结论与EVIDENCE代码存在矛盾（说明具体冲突点）。\n  </retrieval_evidence_alignment>\n  <intent_satisfaction status="SATISFIED|PARTIAL|UNSATISFIED">\n    验证原始检索意图的核心问题是否已被EVIDENCE充分覆盖：\n    SATISFIED：检索意图已有充分证据回答；\n    PARTIAL：部分维度缺乏证据（说明哪些维度）；\n    UNSATISFIED：主要维度缺乏证据，结论可信度低。\n  </intent_satisfaction>\n  <summary_verdict status="APPROVED|NEEDS_REANNOTATION">\n    APPROVED：汇总质量达标，结论可信；\n    NEEDS_REANNOTATION：按以下格式指出需要重新标注的文件及原因（系统将触发重标注并重新汇总）：\n    - 文件路径 → 重标注原因（如"tui.go → 该文件被检索标记为valid但未生成EVIDENCE，需补充标注终端渲染相关逻辑"）\n  </summary_verdict>\n</summary_retrieval_selfcheck>\n```\n\n⚠️ **自检说明**：summary_verdict=APPROVED 时汇总完成；NEEDS_REANNOTATION 时系统会对指定文件触发重新标注并重新汇总，无需你重复输出结论。\n\n⚠️ **注意**：不要输出"关键证据"的代码复述，系统会自动从标注轮中提取完整的 EVIDENCE 块并拼接到你的输出后面。';static SUMMARY_PHASE_SYSTEM_PROMPT="你是一个代码检索报告的汇总专家。基于检索过程中收集的证据和摘要，输出结构化的检索结论。不要调用任何工具。";static DOC_SUMMARY_PHASE_SYSTEM_PROMPT="你是一个检索报告的汇总专家。基于检索过程中收集的文档/代码内容证据和摘要，输出结构化的检索结论。不要调用任何工具。";static ANNOTATION_PLAN_PROMPT='【标注规划轮】\n\n你需要为接下来的并行标注阶段制定计划。系统已将 {{TOTAL_BLOCKS}} 个有效代码块分为 {{BATCH_COUNT}} 个批次，每个批次将由独立的 LLM 并行标注（各批次之间无法看到彼此的标注结果）。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 批次分组（系统预计算，同文件代码块已聚合到同一批次）\n{{BATCHES_OVERVIEW}}\n\n## 全局约束\n- 所有批次合计 UNFOLD-1（核心证据：缺失会导致结论错误）按文件级计数不超过 5 个文件\n- 汇总阶段展开预算约 8000 字符（约 5-8 个中等函数）\n- 大多数证据应标为 UNFOLD-2/3 或 FOLD，只有"不看代码必然导致结论错误"的才标 UNFOLD-1\n\n请输出 <annotation_plan> 标签，为每个批次分配优先级预算和标注重点：\n\n<annotation_plan>\n  <batch id="1" priority_budget="UNFOLD-1:N, UNFOLD-2:N, UNFOLD-3:N, FOLD:N">\n    <focus>该批次的标注重点指引（基于检索结论，该批次代码中最应关注什么）</focus>\n  </batch>\n  ...（为每个批次输出一个 batch 标签）\n</annotation_plan>\n\n输出后以 <plan_complete/> 结束。';static PARALLEL_ANNOTATION_PROMPT='【精细标注轮 {{CURRENT_ROUND}}/{{TOTAL_ROUNDS}}（并行执行）】\n\n本轮与其他批次的标注由独立 LLM 并行执行，你无法看到其他批次的标注结果。请专注于标注当前批次。\n\n## 检索过程概要\n{{RETRIEVAL_SUMMARY}}\n\n## 本批次标注计划\n- 标注重点：{{BATCH_FOCUS}}\n- 优先级预算：{{PRIORITY_BUDGET}}\n- 全局 UNFOLD-1 上限：5 个文件（本批次建议 ≤ {{P1_BUDGET}} 条）\n\n## 全局有效代码块概览（共 {{TOTAL_BLOCKS}} 个，仅 snippet 预览）\n{{VALID_BLOCKS_OVERVIEW}}\n\n## 本轮待精读的代码块（{{BLOCK_COUNT}} 个，共 {{LINE_COUNT}} 行）\n\n⚠️ **代码来源约束**：EVIDENCE 标签中的代码**必须**从下方代码块中直接引用或摘取。\n\n{{CURRENT_BLOCKS}}\n\n⚠️ **分析性标注要求**：\n1. 每条 EVIDENCE 后用优先级标记重要程度：\n   - [UNFOLD-1]：核心证据，缺失会导致结论错误（代码精简到 ≤30 行）\n   - [UNFOLD-2]：重要证据，参数/分支/边界影响结论准确性\n   - [UNFOLD-3]：参考证据，有助于理解上下文但不直接决定结论\n   - [FOLD]：辅助证据，说明要写得足够详细以替代代码（关键参数行为、边界条件、差异分析等）\n2. 说明中指出代码的特殊参数/条件分支、边界值行为、与参考对象的差异\n3. **深度缺口标记**：如果代码中调用了未在检索范围内的函数/引用了未在检索范围内的定义，在 EVIDENCE 说明末尾添加 `[DEPTH-GAP: 缺失内容描述]`\n4. ⚠️ **预算约束**：请参照上方本批次的优先级预算分配标注。\n\n请对上方代码块中与检索意图相关的代码片段输出 <<<EVIDENCE>>> 标注。\n\n完成标注后，输出以下自检块（**必须在 `<annotation_complete/>` 之前**）：\n\n```\n<annotation_coverage_check>\n  <covered_files>已输出EVIDENCE的文件列表（逗号分隔）</covered_files>\n  <skipped_files>未输出EVIDENCE的文件及原因，若无则写"无"</skipped_files>\n  <evidence_precision status="PASS|IMPRECISE">\n    PASS：所有EVIDENCE的scope范围准确精简；\n    IMPRECISE：指出哪些EVIDENCE范围过宽或偏离检索意图\n  </evidence_precision>\n  <retrieval_reason_alignment status="ALIGNED|PARTIAL|MISALIGNED">\n    对照本批次代码块注释中的reason字段，验证检索原因与代码实际行为是否吻合\n  </retrieval_reason_alignment>\n  <coverage_verdict status="COMPLETE|INCOMPLETE">\n    COMPLETE：本批次所有valid_unfold代码块均已有对应EVIDENCE；\n    INCOMPLETE：指出本批次遗漏的文件（系统将触发补充标注）\n  </coverage_verdict>\n</annotation_coverage_check>\n```\n\n完成后输出 `<annotation_complete/>` 信号。';static RETRIEVAL_AGENT_TOOLS=["codebase_search","grep_content","glob_path","read_file","run_command"];buildRetrievalPrompt(e){const t=`**目标并行度：每轮发起 ${this.maxParallelism} 个独立工具调用**（无依赖时尽量达到此数量，且不应超过此数量）。`;if("code"===e)return RetrievalAgent.RETRIEVAL_PHASE_PROMPT.replace("{{PARALLELISM_TARGET}}",t);const r="doc"===e?'### 2. 文档级证据原则（文档检索模式，最重要，必须严格遵守）\n**区分"线索"和"证据"——只有读过文档内容才有证据：**\n- **线索**：grep/search/list_dir 返回的文件路径或匹配摘要\n- **证据**：通过 read_file 读取文档内容后，确认该段内容与检索意图直接相关\n\n**有效证据的判断标准**：\n- 项目列表、架构说明、表格数据、知识点解释——只要内容回答了检索问题，即为 valid\n- 不需要找"实现某功能的代码"，而是找"包含目标信息的内容片段"\n- **所有文件类型均为知识来源**：.cpp、.py、.ts、.go 等代码文件与 .md 文件地位相同。文档仓库中的代码文件通常是知识示例（如 C++ 语法演示），不要因文件后缀是代码类型就跳过读取\n\n❌ 错误：read_file 读到项目推荐列表 → 标 invalid（理由：不是代码实现）\n❌ 错误：list_dir 发现 override.cpp → 跳过（理由：是代码文件）\n✅ 正确：read_file 读到项目推荐列表 → 确认包含目标项目 → 标 valid_unfold\n✅ 正确：list_dir 发现 override.cpp → read_file 读取 → 内容是 override 关键字示例 → 标 valid':"### 2. 通用相关性证据原则（自由探索模式）\n**证据 = read_file 读取后，内容与检索意图相关——无论是代码还是文档：**\n- 代码文件中的实现逻辑 → valid（如代码实现了目标功能）\n- 文档文件中的说明内容 → valid（如文档直接回答了检索问题）\n- 不按文件类型区分有效性，只按内容相关性判断";let n=RetrievalAgent.RETRIEVAL_PHASE_PROMPT.replace('### 2. 代码级证据原则（最重要，必须严格遵守）\n**区分"线索"和"证据"——只有读过代码才有证据：**\n- **线索**：grep/search/list_dir 返回的文件路径或匹配摘要。它们只说明"文件中存在某个文本模式"，不能确定其语义角色（可能是注释、文档引用、测试断言、真正的实现）\n- **证据**：通过 read_file 读取并分析了文件的实际代码后，确认某段代码确实实现了目标功能\n\n**硬性规则**：\n- 在 round_summary 中，对**未读代码的文件**只能使用推测性语言（如"可能包含…"、"需下一轮读取确认"），**禁止**使用断言性结论（如"找到了 X 的实现"）\n- 在 effective_blocks 中，**只标注已通过 read_file 实际读取并分析过代码逻辑的块**为 valid。如果某一轮只做了搜索/定位而未读取代码，该轮不应有任何 valid 标注\n- 你作为子 agent，token 预算充裕。**宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论**\n\n❌ 错误：grep 返回 key-bindings.bash → round_summary 写"找到了键绑定实现" → effective_blocks 标 valid\n✅ 正确：grep 返回 key-bindings.bash → round_summary 写"发现该文件包含关键词，可能是实现，需读取确认" → 下一轮 read_file → 确认后 round_summary 写"读取代码确认了第166行的键绑定逻辑" → effective_blocks 标 valid',r);const i="doc"===e?'### 5. 文档广度覆盖策略（重要）\n文档仓库的核心挑战是**覆盖广度**，不是调用链深度。\n\n**首轮并行探测**（以下两步应在第 1 轮同时发起）：\n- list_dir 根目录，检测是否存在目录/索引文件\n- 同时用 grep_content(pattern="核心关键词", glob="*.md", -i, files_with_matches) 快速定位候选文件\n\n**后续广度搜索**：\n- 如果首轮发现目录/索引文件：优先 read_file 索引文件，通过索引定位目标\n- 如果首轮 grep 已返回候选文件：直接 read_file 候选文件（不需要等 list_dir 结果）\n- 从多个语义侧面发起搜索，**pattern 必须同时覆盖中文分类词 + 英文名称/项目名**：\n  - 例：查询"Python爬虫相关项目" → grep_content(pattern="爬虫|抓取|crawler|spider|scrapy|pyspider|playwright|requests-html", ...)\n  - 例：查询"排序算法" → grep_content(pattern="冒泡|快速排序|归并|堆排序|bubble|quicksort|mergesort|heapsort", ...)\n  - ⚠️ **强制规则**：查询中出现的具体工具名/框架名/项目名必须直接包含在 pattern 中，不能仅依赖中文分类词\n\n**聚焦精读**：\n- 对候选文件用 read_file(offset=行号, limit=30) 精读相关段落\n- 确认内容与检索意图直接相关后，在 effective_blocks 中标记为 valid\n\n**round_summary 待办追踪（防止计划遗忘）**：\n- 每轮 round_summary 末尾必须列出**本轮未完成的待执行任务**，例如：\n  `待执行：grep scrapy|pyspider 英文关键词（本轮仅完成中文搜索）`\n  `待探索：content/en/ 子目录（本轮仅扫描了中文期数）`\n- 只要 round_summary 中存在待执行项，就不允许输出 retrieval_complete（守卫循环会自动检测并拦截）\n\n❌ 错误：第 1 轮只发 list_dir，等结果后第 2 轮再搜索 → 浪费 1 轮\n❌ 错误：找到一个相关文档就沿引用继续深入 → 单点深挖，漏掉横向分布的内容\n❌ 错误：只搜"爬虫"等中文分类词，未搜 Scrapy/pyspider 等项目英文名 → 漏掉仅出现英文名的文件\n✅ 正确：第 1 轮同时 list_dir + grep_content（中英文合并），第 2 轮基于两者结果并行 read_file 多个文件':'### 5. 内容相关性检索策略（重要）\n你的目标是找到与检索问题**直接相关**的所有内容。\n\n**首轮并行探测**（以下两步应在第 1 轮同时发起）：\n- list_dir 根目录，了解仓库结构\n- 同时用 grep_content(pattern="核心关键词", -i, files_with_matches) 快速定位候选文件\n\n**后续检索**：\n- 如果首轮发现索引/配置文件：优先 read_file 了解组织方式\n- 如果首轮 grep 已返回候选文件：直接 read_file 候选文件\n- 从多个语义侧面分别发起搜索，确保覆盖面\n\n**精读确认**：\n- 对候选文件用 read_file(offset=行号, limit=30) 精读相关段落\n- 确认内容与检索意图直接相关后，在 effective_blocks 中标记为 valid\n\n❌ 错误：第 1 轮只发 list_dir，等结果后第 2 轮再搜索 → 浪费 1 轮\n✅ 正确：第 1 轮同时 list_dir + grep_content，第 2 轮基于两者结果并行 read_file 多个文件\n\n### 5b. 依赖信号追踪（重要）\n读取代码文件后，若发现指向本仓库内**尚未探索**模块的引用，必须在本轮 `<round_summary>` 中将其列为"待探索"计划项。\n\n**依赖信号识别（语言无关）**：\n- **导入语句**：任意语言的 `import`、`include`、`require`、`use`、`#include`、`from ... import` 等，路径指向本仓库子目录/包时，视为待探索信号\n- **未定义类型/接口**：当前文件中使用了但未定义的类型、结构体、接口，说明定义在其他模块，需追踪来源\n- **注释/配置引用**：注释、配置文件、Makefile 中明确提到的模块路径或文件名，也应列为候选\n\n**追踪格式**（写入 round_summary 的待探索项）：\n- `待探索：src/tui/ 子包（terminal.go 中发现 import "github.com/xxx/tui"）`\n- `待探索：pkg/config/ 模块（main.go 中使用了未定义的 Config 类型）`\n- `待探索：lib/render.js（注释中提到渲染逻辑入口）`\n\n⚠️ round_summary 中存在"待探索"项时，守卫循环会拦截 retrieval_complete，强制继续探索。必须明确写出待探索路径及其来源依据。';if(n=n.replace('### 5. 双向追溯调用链（重要）\n找到核心实现代码后，**必须双向追溯**：\n\n**向上追溯**："谁调用了这个函数/类？"\n- **从实现向上追溯**：函数被谁调用 → 调用者被谁调起 → 启动入口 → CLI 命令 → 构建配置（Makefile 等）\n- **从问题描述向外扩展**：检索意图或 issue 中提到的关键词（如 CI、test、timeout、make target、system start）都应该主动 grep 搜索，即使它们看起来与核心功能不直接相关\n- **大胆查看相关文件**：Makefile、测试文件、CLI 命令定义、配置文件等都可能是修复所需的关键上下文\n\n**向下追溯**："这个函数把关键参数传给了谁？"\n- 当函数 A 将关键参数传给子函数 B 时，**必须 read_file 子函数 B 的实现**，确认参数的实际处理逻辑\n- 特别是：参数经过了 if/else 分支、默认值赋值、类型转换等操作后再传递的情况\n- 不能仅看调用方的代码就断言"参数传递正确"——参数可能在 callee 中被覆盖、忽略或错误处理\n- **同文件也要追溯**：即使 callee 在同一文件中，也必须 read_file 对应行范围确认其实现\n\n典型追溯链路：\n- 找到 bulk_create 中 batch_size 参数 → 搜索 batch_size 传递给 _batched_insert → read_file _batched_insert 确认 batch_size 的实际使用逻辑\n- 找到 _parse_annotation 处理类型标注 → 搜索同文件中其他处理类型标注的函数 → 发现 make_xrefs 是另一条独立路径\n- 找到 DNSHandler.swift → 搜索 "DNSHandler" 的所有调用者 → 找到 APIServer+Start.swift → 搜索 "system start" → 找到 SystemStart.swift 和 Makefile\n\n❌ 常见错误：找到函数 A 调用了函数 B 后，只看 A 的代码就断言"参数传递正确"，不去读取 B 的实现\n❌ 常见错误：找到核心实现后就停止搜索，认为"已经足够了"\n✅ 正确做法：找到调用关系后，read_file 被调用函数 B 的完整实现，特别关注 B 中对该参数的实际处理逻辑\n✅ 正确做法：找到核心实现后，继续搜索调用者、启动入口、构建脚本和相关测试，确保覆盖完整的修复链路\n\n**round_summary 待办追踪（防止计划遗忘）**：\n- 每轮 round_summary 末尾必须列出**本轮未完成的待执行任务**，例如：\n  `待执行：grep scrapy|pyspider 英文关键词（本轮仅完成中文搜索）`\n  `待探索：src/tui/ 子包（发现 import 引用但尚未读取）`\n- 只要 round_summary 中存在待执行项，就不允许输出 retrieval_complete（守卫循环会自动检测并拦截）',i),n=n.replace('### 6. 效率纪律\n- **调研充分性优先**：你作为子 agent，token 预算充裕。**优先保证调研充分性，而非追求最少轮次**。宁可多花一轮读取代码确认，也不要基于文件名或搜索摘要就跳过阅读直接下结论\n- **不重复搜索**：记住已经搜过的文件和模式，不要对同一文件或相同关键词重复发起搜索\n- **存疑即全读**：当你认为某个文件或函数与问题相关但尚不确定具体哪几行，应直接 read_file 该函数/类的完整定义（通常 100-300 行），而非每轮微调 offset/limit 反复读取重叠的小片段。碎片化读取既浪费轮次又导致上下文割裂，无法形成完整理解。正确做法是一次性读取足够范围后在 round_summary 中完整分析\n- **读后必蒸馏**：每次 read_file 完成后，在 <effective_blocks> 的 reason 中记录关键函数名、类名、核心逻辑结论（如"renderBorder() 负责边框绘制，style 为 nil 时跳过渲染；事件循环入口在 UpdateModel()；光标状态由 Model.cursor 字段管理"）。⚠️ 禁止在 reason 中写具体行号——行号易产生幻觉导致后续决策错误；应使用函数名/结构体名/逻辑描述作为语义锚点。reason 是跨轮知识的唯一载体，fold 后仅凭 reason 判断是否需重读。较长的摘要可用 <reason id="blockId">多行内容</reason> 格式\n- **正则保持简单**：使用简单的正则表达式，避免复杂转义。如果需要搜多个变体，拆成多次简单搜索而不是用一个复杂正则\n- **先定位再阅读（严格两轮制）**：read_file 只能读取**前面轮次**已通过搜索、list_dir 或 grep_content 确认存在的文件路径。**同一轮**内不允许既调用 list_dir 又对同一目录调用 read_file——因为 list_dir 的结果要到下一轮你才能看到，本轮的 read_file 参数只能基于上一轮已确认的路径','### 6. 效率纪律（文档模式）\n- **广度优先，充分探索**：文档检索的核心挑战是覆盖面，优先扫描更多目录和文件而非深读单个文件。**找到少量答案后不要立即停止**，继续探索其他目录，确认没有遗漏的相关内容后再声明 <retrieval_complete/>\n- **所有文件类型一视同仁**：使用 list_dir 扫描目录时，对 .md 文件和 .cpp/.py/.ts 等代码文件一视同仁，都列入候选读取列表。判断是否读取的唯一依据是**文件名/内容是否与检索目标相关**，而非文件后缀\n- **不重复搜索**：记住已经搜过的文件和模式，不要对同一文件或相同关键词重复发起搜索\n- **精确读取**：对超过 100 行的文档文件，优先用 grep_content(output_mode="content", -C 3) 定位相关段落行号，然后用 read_file(offset=行号, limit=30) 精读相关段落。避免一次读取整个大文档（200+ 行）\n- **首轮抽样**：前 2 轮内必须至少 read_file 1 个目标文件（如 read_file(target_file="xxx", limit=50)），了解文件内部结构（标题格式、分段方式、内容组织）后再规划后续搜索。不要用 5 轮以上 list_dir 探索目录却从不读文件\n- **正则保持简单**：使用简单的正则表达式，避免复杂转义\n- **定位即可读取**：通过 grep_content(files_with_matches) 或 glob_path 返回的文件路径已确认存在，可在同一轮用 read_file 读取，不需要等下一轮。仍禁止猜测文件名直接 read_file\n- **全局多角度扫描（必须）**：在精读任何文件之前，先用至少 2 个不同关键词视角发起 grep_content 或 codebase_search 对整个仓库做全局搜索（如"功能名称"+"模块名"+"作者名"等不同角度）。单一关键词无法覆盖全部相关文件，多角度搜索结果合并后再选文件精读\n- **证据不足时优先扩展而非收尾**：当 effective_blocks 数量不足 10 个时，禁止输出 <retrieval_complete/>，应继续探索：(1) 换关键词搜索；(2) 探索尚未访问的子目录；(3) 检查非 .md 的知识文件（代码注释、配置说明等）'),n=n.replace('### 7. 禁止猜测文件名（最高优先级，违反则严重扣分）\n**绝对禁止**凭直觉猜测文件路径来调用 read_file。你不知道项目的文件命名规范（例如 Go 项目不一定有 key.go、action.go、types.go），猜测会导致大量 "File does not exist" 错误，严重浪费轮次。\n\n**典型错误模式**：\n- 你看到 src/ 目录存在，就猜测 src/key.go、src/action.go、src/types.go 存在 → 全部失败\n- 你在同一轮同时调用 list_dir("src/") + read_file("src/key.go") → key.go 是猜测，list_dir 还没返回结果\n\n**正确做法**：分两轮——\n- 轮次 N：用 list_dir 查看目录下实际有哪些文件，或用 glob_path/grep_content 确认文件路径\n- 轮次 N+1：基于上一轮返回的**真实文件列表**，read_file 已确认存在的文件\n\n❌ 错误示例：猜测存在 src/key.go、src/action.go、src/types.go 然后直接 read_file → 全部失败\n❌ 错误示例：同一轮 list_dir("src/") + read_file("src/key.go") → key.go 是猜测路径\n✅ 正确示例：轮次 N 调用 list_dir("src/") 看到实际文件列表，轮次 N+1 再 read_file 已确认存在的文件','### 7. 文件访问与搜索规则（文档模式）\n**禁止猜测文件名**：不要凭直觉猜测文件路径来调用 read_file 或 list_dir。\n\n**工具参数格式（严格遵守）**：\n- list_dir 的参数名是 target_directory（不是 path）：list_dir(target_directory="/data/repos/xxx")\n- read_file 的参数名是 target_file：read_file(target_file="/data/repos/xxx/file.md")\n- read_file 支持 offset 和 limit 参数：read_file(target_file="...", offset=100, limit=30)\n\n**允许同轮读取的情况**：\n- grep_content(files_with_matches) 返回的路径 → 可同轮 read_file（路径已确认存在）\n- glob_path 返回的路径 → 可同轮 read_file\n- 上一轮 list_dir 返回的文件列表中的路径 → 可同轮 read_file\n\n**仍然禁止的情况**：\n- 同一轮内 list_dir + read_file 同一目录（list_dir 结果本轮看不到）\n- 凭项目名/目录名猜测 list_dir 子路径（如看到 content/ 就猜测 content/en/001 存在）\n\n**搜索覆盖要求**：\n- 同一检索目标必须从多个词汇角度搜索，使用 grep_content 的多关键词 regex 一步扫全库：\n  grep_content(pattern="关键词1|keyword2|synonym3", glob="*.md", -i, output_mode="files_with_matches", head_limit=0)\n- **必须设置 head_limit=0**：默认截断约 20 条，在 100+ 文件仓库中会漏掉按 mtime 排序后较旧的所有文件\n- 中英文关键词都要覆盖，且项目/工具英文名必须包含在 pattern 中（不能仅搜中文分类词）\n- 持续搜索直到确信没有遗漏重要结果\n\n**两步扫描策略**（对大型仓库，候选文件 > 10 个时推荐）：\n- 第一步：grep_content(files_with_matches, head_limit=0) 获取完整候选列表\n- 第二步：对内容不确定的候选文件，用 grep_content(output_mode="content", -C 3) 预览匹配行，判断是否值得 read_file，避免读取无关文件（如反爬虫工具、英文版无关内容）\n\n**glob_path 的适用范围（严格限制）**：\n- glob_path 只适用于**不知道文件扩展名或命名规律**时探索目录结构（如 glob_path("*.md") 查看有哪些文件）\n- **禁止用 glob_path 逐页浏览文件内容**：看到 content/ 目录有文件后，应该立即用 grep_content 全库搜索关键词，而不是用 glob_path 一批一批地浏览文件列表\n- **典型错误**：调用 glob_path 10 次以上来遍历目录，却不用 grep_content 做全库关键词扫描\n- **正确做法**：1 次 list_dir 了解目录结构 + 1 次 grep_content(head_limit=0) 全库扫描 → 直接 read_file 命中文件'),n=n.replace("## 工具使用",'### 8. 并行工具调用（重要）\n如果你打算调用多个工具且它们之间没有依赖关系，必须在同一轮并行发起所有独立的工具调用。\n优先选择并行调用而非串行调用，以最大化每轮的信息获取效率。\n\n例如：需要读 3 个文件时，同一轮发 3 个 read_file 并行读取，而不是分 3 轮逐个读取。\n\n**可并行的场景**：\n- 多个 read_file（不同文件无依赖）\n- 多个 grep_content（不同关键词/模式无依赖）\n- list_dir(根目录) + grep_content("关键词", files_with_matches)（无依赖，首轮推荐）\n- grep 返回 5 个文件 → 下一轮同时 read_file 其中最相关的 3 个\n\n**必须串行的场景**（工具调用结果会影响后续参数）：\n- list_dir 探索目录 → 下一轮基于结果 read_file（有依赖）\n- read_file 确认内容 → 下一轮根据内容发起更深搜索（有依赖）\n\n每轮仅发 1 个工具调用是严重的效率浪费，在 10 轮限制下尤其致命。\n\n### 9. 大量候选文件的处理策略\n当 grep_content 或 glob_path 返回大量候选文件（>5 个）且无法确定哪些最相关时：\n1. 用 grep_content(pattern, output_mode="content", -C=3) 对候选文件做**二次内容搜索**，直接获取匹配行及上下文，一次调用覆盖所有候选文件\n2. 或用 codebase_search("更精确的语义描述") 做语义搜索缩小范围\n3. 确定最相关的 2-3 个文件后再 read_file 精读\n4. **避免**对所有候选文件逐个 read_file 的低效模式——10 轮内无法覆盖 20+ 个文件\n\n## 工具使用'),"doc"===e){n=n.replace("你是一个专注于代码检索的智能体（Retrieval Agent），由 Main Agent 委派执行检索任务。你的唯一职责是：高效、精准地从代码库中收集充分的代码证据。","你是一个专注于文档检索的智能体（Retrieval Agent），由 Main Agent 委派执行检索任务。你的唯一职责是：高效、精准地从仓库中收集与检索问题直接相关的文档证据。"),n=n.replace('#### 导航类返回 vs 代码类返回\n工具返回分为两类，标记方式不同：\n- **导航类**（grep_content files_with_matches / glob_path）：返回的是文件名列表，**不包含代码内容**。这些块一律标 invalid，reason 写"定位到关键文件：xxx、yyy，非代码块"即可。关键文件位置应记录在 round_summary 中以保持记忆。\n- **代码类**（read_file / grep_content content 模式 / codebase_search）：返回的是实际代码（codebase_search 返回带行号的代码片段）。必须**仔细阅读代码逻辑**后判断 valid/invalid，reason 中说明具体的代码逻辑分析结果。','#### 导航类返回 vs 内容类返回（文档模式）\n工具返回分为两类，标记方式不同：\n- **导航类**（grep_content files_with_matches / glob_path）：返回的是文件名列表，**不包含文档内容**。这些块标 invalid，reason 写"定位到候选文件：xxx、yyy，需下一轮 read_file 读取内容"。\n- **内容类**（read_file / grep_content content 模式）：返回的是实际文档内容。判断内容是否与检索意图相关后决定 valid/invalid。\n\n⚠️ 文档模式下，"不是代码"不是 invalid 的理由。只要内容与检索意图相关，就应标 valid。'),n=n.replace('### 1. 批判性验证\n搜到内容后，必须问自己：**"这真的是核心实现吗？"**\n- 找到"相关代码"≠ 找到"实现代码"\n- 常量定义、类型声明、测试用例往往只是**引用**，不是**实现**\n- 如果搜索结果看起来像辅助代码，要继续追踪到真正的实现','### 1. 批判性验证（文档模式）\n搜到文件后，必须问自己：**"这个文档是否直接回答了检索问题？"**\n- 找到"提及关键词的文件"≠ 找到"包含目标内容的文档"\n- 目录索引、链接列表、文件名匹配往往只是**线索**，不是**证据**\n- 如果搜索结果只是索引或导航页，要继续深入阅读实际内容'),n=n.replace("### 第二步：标记有效代码块","### 第二步：标记有效内容块（文档模式）");n+='\n\n---\n\n## doc 模式专项：完成标准与充分性评估\n\n### 9.1 什么算 valid？——通用判断原则\n\n**核心准则：内容直接回答了检索问题的某个维度，就是 valid。**\n\n文档检索面对的内容形式多样（项目列表、概念解释、API 说明、教程步骤、数据表格、架构描述、配置说明……），但 valid/invalid 的判断逻辑是统一的：\n\n**✅ valid_unfold 的条件（满足任意一条）**：\n- 内容包含检索意图要求的**具体信息**（名称、数据、定义、步骤、示例等），可直接用于回答问题\n- 内容覆盖了检索问题的一个完整子维度，后续分析需要多次引用其细节\n- 内容包含关键代码示例、数据表格、或配置片段，这些本身就是答案的一部分\n\n**✅ valid_fold 的条件**：\n- 内容与检索意图相关，但只是补充说明或上下文，不是核心答案\n- 内容覆盖了检索问题的一个子维度，但细节不需要反复查看\n\n**❌ invalid 的条件（满足任意一条）**：\n- 搜索/列目录返回的文件路径列表——路径不是内容，必须 read_file 后才能判断\n- 内容只是目录/索引/导航页，本身不包含答案，只是指向其他文档的链接\n- 内容提到了关键词，但讨论的是不同问题（关键词匹配 ≠ 内容相关）\n- 内容只是表面提及（如仅一句"参见 X 章"、"X 是重要概念"），没有实质信息\n\n**valid_unfold vs valid_fold 选择**：\n- 需要在后续轮次中引用其具体内容进行推理 → valid_unfold\n- 只需要记录"这个文件有相关内容"作为佐证 → valid_fold\n\n**通用示例（覆盖不同文档类型）**：\n- 项目推荐列表：read_file 读到包含项目名+简介的段落 → valid_unfold；read_file 只读到"## 项目列表"标题行 → invalid\n- API 文档：read_file 读到接口参数说明+返回值格式 → valid_unfold；read_file 只读到"本章介绍 API 用法" → invalid\n- 教程/指南：read_file 读到操作步骤或配置示例 → valid_unfold；read_file 只读到章节目录 → invalid\n- 概念解释：read_file 读到原理说明+机制描述 → valid_unfold；read_file 只读到"X 是一种重要技术" → invalid\n- 数据/表格：read_file 读到含具体数值的表格行 → valid_unfold；read_file 只读到表格标题行 → invalid\n\n---\n\n### 9.2 深度充分性——检索何时可以结束？\n\n**深度充分 = 检索意图的所有维度都有对应的 valid 证据，且没有靠推测填充的空白。**\n\n**第一步：拆解检索意图的维度**\n\n拿到检索问题后，先在首轮 round_summary 中明确列出需要覆盖的所有维度：\n- "找出至少 N 个 X" → 维度：X 的定义特征（用于判断是否符合条件）+ N 个符合条件的具体实例\n- "描述 Y 的结构并列出 K 种类别" → 维度：整体结构描述 + K 个具体类别（各需独立证据）\n- "解释 Z 的原理并给出示例" → 维度：原理/机制说明 + 具体代码/数据示例\n- "分别比较 A/B/C 的差异" → 维度：A 的特性、B 的特性、C 的特性（各需独立证据）\n- "汇总 N 个对象各自的 M 项指标" → 维度：N×M 个数据单元，每个都需要有文档证据\n\n**第二步：对照维度检查 valid 块的覆盖情况**\n\n每轮 round_summary 结尾必须自查：\n  "维度覆盖：[维度1]→已找到/未找到，[维度2]→已找到/未找到，…，待补充维度：[列出]"\n\n**只有所有维度都已找到对应 valid 证据时，才允许输出 retrieval_complete。**\n\n**常见的深度不足陷阱**：\n- 检索意图要求"分别"说明多个对象，只找到其中一部分就停止\n- 检索意图要求"给出示例"，但 valid 块中只有原理描述，没有代码/数据示例\n- 检索意图要求"至少 N 个"，只找到 N 个就立刻停止，没有确认这 N 个是否真的各自独立且符合条件\n- 某个维度的证据来自推测（round_summary 中写了"应该包含…"）而不是已读取的内容\n\n---\n\n### 9.3 广度充分性——多工具多角度探索才算充分\n\n**广度充分 = 用多种工具从多个角度探索后，新增发现趋于零（收益递减）。**\n\n不要依赖单一工具或单一搜索词就声明完成。以下三类工具各有覆盖盲区，必须配合使用：\n\n**工具组合策略**：\n\n| 工具 | 覆盖的角度 | 盲区 |\n|------|-----------|------|\n| list_dir | 目录结构、文件组织方式、文件名规律 | 不知道文件内容 |\n| grep_content | 精确关键词匹配、跨文件扫描 | 只能找到明确出现的词，漏掉同义表达 |\n| codebase_search | 语义相关性搜索 | 依赖嵌入向量，有时漏掉精确匹配但语义距离较远的内容 |\n| read_file | 深度阅读具体文件内容 | 只能看已知路径的文件 |\n\n**广度探索流程（推荐）**：\n1. **目录探索**（list_dir）：了解仓库整体结构，找出所有可能包含目标内容的目录和文件名规律\n2. **关键词扫描**（grep_content，多角度）：\n   - 先用核心词（中文/英文/缩写/同义词）并行扫描，获取候选文件列表\n   - 如果第一轮关键词没有覆盖所有可能的表达方式，补充其他关键词再搜一轮\n3. **语义搜索**（codebase_search）：对 grep 未能覆盖的语义角度（如行业术语的多种表达）发起语义查询\n4. **分散精读**（read_file，来自不同目录/文件）：从不同目录、不同深度的候选文件中各取样读取，确认内容分布\n\n**广度充分的判断标准（以下条件同时满足）**：\n- list_dir 已覆盖根目录和所有一级子目录，了解了仓库的文件分布结构\n- grep_content 发起了 ≥2 种不同角度的关键词搜索（如中文词 + 英文词，或主概念 + 子概念）\n- 如果仓库有语义搜索支持，codebase_search 发起了 ≥1 次针对不同语义角度的查询\n- read_file 读取的文件来自 ≥2 个不同目录（或对小型仓库，覆盖了所有候选文件）\n- 最近一轮的新搜索没有带来新的候选文件，或新候选文件读取后全为 invalid → 收益递减，可以结束\n\n**广度不足的警告信号（出现任意一条都必须继续探索）**：\n- 只用了 1 种工具（如只用 grep，未尝试 list_dir 了解目录结构或 codebase_search 覆盖语义）\n- 所有 read_file 都在同一个目录，未探索其他目录下是否有相关文档\n- grep_content 只搜了 1 个关键词，未尝试同义词、英文词或相关子概念\n- 仓库有多级目录结构，但只探索了根目录，未检查子目录中的文档\n- 轮次已过半（≥5 轮）但 read_file 的文件数 < 2'}return"doc"!==e&&"auto"!==e||(n=n.replace('  <core_read_depth status="PASS|INSUFFICIENT">\n    已 read_file 精读的文件列表（每项需有明确理由）：\n    - [文件名]：[原因]\n    callee 追溯：已追溯到叶节点 / 边界明确（[原因]）\n    [INSUFFICIENT：哪个 callee 未精读及原因]\n  </core_read_depth>','  <exploration_breadth status="PASS|INSUFFICIENT">\n    已 list_dir 探索的目录（至少 2 个层级）：\n    - [目录名]：[原因/发现]\n    已使用的搜索关键词角度（至少 2 个不同关键词）：\n    - [关键词]：[找到了什么]\n    [INSUFFICIENT：还有哪些目录/关键词未探索]\n  </exploration_breadth>'),n=n.replace('  <expected_behavior_coverage status="PASS|INSUFFICIENT|N/A">\n    （fix/understand 类查询强制填写；N/A 仅适用于纯架构探索类）\n    是否查阅了 test 文件 / 注释 / 文档以确认期望行为：[是/否]\n    [否时：必须说明为何可以在不知期望行为的情况下完成检索]\n  </expected_behavior_coverage>','  <knowledge_type_coverage status="PASS|PARTIAL">\n    除 .md 文件外，是否检查过 .py/.ts/.cpp 等代码文件中的注释/README/配置信息：[是/否]\n    是否查看过 examples/、docs/、config/ 等知识密集型目录：[是/否]\n    [PARTIAL：说明哪类文件被跳过及原因]\n  </knowledge_type_coverage>')),n.replace("{{PARALLELISM_TARGET}}",t)}async beforeExecute(){const e=this.getStringParam("query");e||this.throwValidationError(ToolError.retrieval_agent.query_required);const t=this.getStringParam("retrieval_type");if("doc"===t||"auto"===t)this.retrievalType=t;else if(!t){const e=this.ctx.rootPath;if(e){const t=Date.now(),r=this.sampleRepoProfile(e);if(kernel.logger.info("zulu",`[retrieval_agent][repo_profile] doc=${r.docCount} code=${r.codeCount} total=${r.total} suggestion=${r.suggestion} elapsed=${Date.now()-t}ms`),"code"!==r.suggestion){const e=this.getStringParam("query")||"";"fix"===this.classifyQueryIntent(e)?kernel.logger.info("zulu",`[retrieval_agent][retrieval_type_autodetect] fix intent detected, keeping code mode (repo suggestion=${r.suggestion})`):(this.retrievalType=r.suggestion,kernel.logger.info("zulu",`[retrieval_agent][retrieval_type_autodetect] override to ${this.retrievalType}`))}}}this.agentInfo={agentName:"retrieval_agent",agentId:0,isProjectAgent:!0,agentPrompt:this.buildRetrievalPrompt(this.retrievalType),tools:RetrievalAgent.RETRIEVAL_AGENT_TOOLS};const r=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:this.agentInfo,taskInfo:{description:"Retrieval agent: search and analyze codebase",query:e},signal:this.ctx.signal});this.combinedSubtaskId=`retrieval_agent_${r}`}get subtaskId(){const e=this.combinedSubtaskId.lastIndexOf("_");return Number(this.combinedSubtaskId.slice(e+1))}async agentLoop(e){this.executor||(this.executor=new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:this.subtaskId,userTurn:this.ctx.userTurn},this.toolTurns,this.token)),await this.executor.executeStream({updatedParams:e,onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()})}toResult(e,t){kernel.logger.info("zulu",`[retrieval_agent][debug] retrieval_id=${this.combinedSubtaskId} summary=${truncateLine(e||"",2e3)}`);const r=t?.length??0,n=r>0,i=0===r?"\n<system_reminder>\n⚠️ **检索置信度：低（无有效证据块）**\n本次检索未能锁定任何有效代码块，以下分析结论为 LLM 推断，可靠性低于正常检索。\n在执行 edit_file / patch_file 前，请先用 read_file 自行定位并验证修复位置，不要直接采纳 FIX-HINT 中指定的文件路径和行号。\n</system_reminder>":"",o=n?'\n<system_reminder>\n## 检索证据使用指南\n\n上方 evidence_package 中的每条证据已包含：\n- 📄 文件绝对路径:精确行号范围（经系统自动锚定，非 LLM 猜测）\n- 完整的代码块内容\n\n**操作规则**：\n1. 证据代码块中的行号和代码内容已经过系统验证，可直接作为 patch_file 的定位依据\n2. 如果证据已覆盖修改目标区域的完整上下文，**直接基于证据代码编写 patch_file**，无需 read_file\n3. 仅在以下情况才需要 read_file：\n   - 需要查看证据未覆盖的**其他**文件或**其他**行范围\n   - 需要确认证据代码块的上下文（如函数签名、import 语句），且该上下文未在证据中提供\n4. **严禁**对证据中已包含完整代码的同一文件同一行范围重复 read_file\n\n## 证据优先级含义（N2 防止过度复制）\n\nevidence_package 中每条证据携带 UNFOLD 层级标签，含义如下：\n- **[UNFOLD-1]** / **[UNFOLD-2]**：**【核心修复目标】** —— 直接与修复目标相关的代码，需要修改的位置就在这里，请聚焦于此\n- **[UNFOLD-3]** / **[UNFOLD-4]**：**【上下文参考】** —— 仅提供架构/背景理解，**不要照搬其实现复杂度**；核心修复应以最小改动实现，而非模仿参考实现的完整结构\n\n## retrieval_agent 使用指南\n\nretrieval_agent 支持以下参数，请根据任务类型正确传参：\n\n**retrieval_type 参数（检索模式）**：\n| retrieval_type | 适用场景 | 示例 |\n|----------------|---------|------|\n| `code`（默认） | 代码缺陷修复、函数实现理解、调用链追踪 | bug 修复、代码 review |\n| `doc` | 文档型仓库内容检索，答案在 .md/.rst 等文档文件中 | README 聚合、知识库问答 |\n| `auto` | 代码和文档混合仓库，不确定答案在哪类文件 | 通用探索、架构调研 |\n\n**query 写法与检索意图（自动推断，无需额外参数）**：\nRA 根据 query 文本自动判断意图，影响标注阶段的输出质量：\n- **fix 模式**：query 以 `[FIX]` 开头，或包含 fix/bug/issue/error/patch 等关键词 → 标注阶段输出 FIX-HINT（修复目标文件和修复方向），适用于缺陷修复任务\n- **understand 模式**：其他 query → 输出功能描述和调用关系分析，适用于代码理解任务\n\n**context 参数（可选）**：传入报错堆栈、issue 描述、已知相关文件路径等背景信息，帮助 RA 缩小检索范围。\n\n**轮次参数（可选，通常不需要手动指定）**：\n- `max_rounds`：检索阶段最大轮数，默认 10；大型仓库或需要深度追踪调用链时可设为 15~20；证据不充分时系统自动翻倍扩容\n- `max_summary_rounds`：标注+总结阶段轮次预算，默认 7；检索到大量代码块时可适当提高（每轮处理约 1500 行代码）\n\n调用示例：\n- retrieval_agent(query="[FIX] ChoiceWidget 返回错误状态码", retrieval_type="code")\n- retrieval_agent(query="[UNDERSTAND] cache_clear 的调用链", context="已知入口: cache.py")\n- retrieval_agent(query="HelloGitHub 收录了哪些 Python 爬虫工具", retrieval_type="doc")\n</system_reminder>':"",s=n&&r>=2?`\n<system_reminder>\n5. **多条证据的综合使用**：本次检索返回了 ${r} 条证据。这些证据可能指向需要同时修改的多个位置（如基类+子类、调用端+被调端）。在制定修复方案前，请先通读所有证据，识别它们之间的关联关系（继承、调用、数据流），避免只采纳部分证据而遗漏互补性修改。\n</system_reminder>`:"";kernel.logger.info("zulu",`[retrieval_agent][reminder] injected=${n}, evidence_count=${r}`);const a=this.annotationHasDegradedEvidence?"\n⚠️ EVIDENCE_QUALITY=PARTIAL（标注阶段发生超时降级，部分证据未经 LLM 精细标注，可靠性降低）\n建议主 agent：(1) 对修复点不确定时，先用 read_file 读取原文核验；(2) 调用 API 前先 hasattr 检查方法是否存在；(3) 避免基于此 evidence 做大范围改动。\n":"";this.annotationHasDegradedEvidence&&kernel.logger.info("zulu","[x2][partial_warning] injected, annotationHasDegradedEvidence=true");const c=[`<retrieval_id>${this.combinedSubtaskId}</retrieval_id>`,"<evidence_package>",a+`${e}`,"</evidence_package>",i,o,s].join("\n");return this.result={output:c,metadata:{summary:e||"",evidence:t||[],unresolvedGaps:[],status:"completed"}},this.result}static parseFixHint(e){const t=e.match(/\[FIX-HINT\]\s*(.+)/i);if(!t)return;const r=t[1].trim();return r.length>200?r.substring(0,200):r}static parseAnnotationCoverageCheck(e){const t=e.match(/<annotation_coverage_check>([\s\S]*?)<\/annotation_coverage_check>/);if(!t)return null;const r=t[1],n=r.match(/<covered_files>([\s\S]*?)<\/covered_files>/),i=r.match(/<skipped_files>([\s\S]*?)<\/skipped_files>/),o=r.match(/<evidence_precision\s+status="([^"]+)">([\s\S]*?)<\/evidence_precision>/),s=r.match(/<retrieval_reason_alignment\s+status="([^"]+)">([\s\S]*?)<\/retrieval_reason_alignment>/),a=r.match(/<coverage_verdict\s+status="([^"]+)">([\s\S]*?)<\/coverage_verdict>/),c=n?.[1]?.trim()||"",l=c?c.split(",").map((e=>e.trim())).filter(Boolean):[],A=i?.[1]?.trim()||"",u=A&&"无"!==A?[A]:[],d="IMPRECISE"===(o?.[1]||"").toUpperCase().trim()?"IMPRECISE":"PASS",h=o?.[2]?.trim()||"",p=(s?.[1]||"").toUpperCase().trim();return{coveredFiles:l,skippedFiles:u,evidencePrecision:d,precisionDetail:h,retrievalReasonAlignment:"MISALIGNED"===p?"MISALIGNED":"PARTIAL"===p?"PARTIAL":"ALIGNED",alignmentDetail:s?.[2]?.trim()||"",coverageVerdict:"INCOMPLETE"===(a?.[1]||"").toUpperCase().trim()?"INCOMPLETE":"COMPLETE",verdictDetail:a?.[2]?.trim()||""}}static parseSummarySelfcheck(e){const t=e.match(/<summary_retrieval_selfcheck>([\s\S]*?)<\/summary_retrieval_selfcheck>/);if(!t)return null;const r=t[1],n=r.match(/<annotation_quality_review\s+status="([^"]+)"/),i=r.match(/<retrieval_evidence_alignment\s+status="([^"]+)"/),o=r.match(/<intent_satisfaction\s+status="([^"]+)"/),s=r.match(/<summary_verdict\s+status="([^"]+)">([\s\S]*?)<\/summary_verdict>/),a=r.match(/<type_risk\s+status="([^"]+)"/),c=r.match(/<fix_hint_4principles\s+status="([^"]+)"/),l=r.match(/<factory_completeness\s+status="([^"]+)"/),A=r.match(/<layer_verification\s+status="([^"]+)"/),u=(n?.[1]||"").toUpperCase().trim(),d=(i?.[1]||"").toUpperCase().trim(),h=(o?.[1]||"").toUpperCase().trim(),p=(s?.[1]||"").toUpperCase().trim(),g=s?.[2]||"",f=(a?.[1]||"").toUpperCase().trim(),m=(c?.[1]||"").toUpperCase().trim(),E=(l?.[1]||"").toUpperCase().trim(),C=(A?.[1]||"").toUpperCase().trim(),I=[];if("NEEDS_REANNOTATION"===p){const e=/[-•*]\s*([^\s\n→]+)\s*→\s*(.+)/g;let t;for(;null!==(t=e.exec(g));)I.push({file:t[1].trim(),reason:t[2].trim()})}return{annotationQualityReview:"GOOD"===u?"GOOD":"PARTIAL"===u?"PARTIAL":"POOR"===u?"POOR":null,retrievalEvidenceAlignment:"ALIGNED"===d?"ALIGNED":"MISALIGNED"===d?"MISALIGNED":"PARTIAL"===d?"PARTIAL":null,intentSatisfaction:"SATISFIED"===h?"SATISFIED":"PARTIAL"===h?"PARTIAL":"UNSATISFIED"===h?"UNSATISFIED":null,summaryVerdict:"APPROVED"===p?"APPROVED":"NEEDS_REANNOTATION"===p?"NEEDS_REANNOTATION":null,verdictDetail:g.trim(),reannotationTargets:I,typeRisk:"TYPE_RISK"===f?"TYPE_RISK":"NO_RISK"===f?"NO_RISK":null,fixHint4Principles:"NEEDS_REVISION"===m?"NEEDS_REVISION":"COMPLIANT"===m?"COMPLIANT":null,factoryCompleteness:"FACTORY_INCOMPLETE"===E?"FACTORY_INCOMPLETE":"FACTORY_COMPLETE"===E?"FACTORY_COMPLETE":"NOT_APPLICABLE"===E?"NOT_APPLICABLE":null,layerVerification:"LAYER_CHECK_REQUIRED"===C?"LAYER_CHECK_REQUIRED":"LAYER_CONFIRMED"===C?"LAYER_CONFIRMED":"NOT_APPLICABLE"===C?"NOT_APPLICABLE":null}}logExecutionMetrics(){const e={query_intent:this.queryIntent,total_rounds:this.roundCount,max_rounds_config:this.maxRounds,original_max_rounds:this.originalMaxRounds,rounds_expanded:this.roundsExpanded,effective_blocks_count:this.effectiveBlocksMap.size,code_blocks_count:this.codeBlockRegistry.size,trace_edges_count:this.traceEdgesMap.size,breadth_probes_count:this.breadthProbesMap.size,elapsed_ms:this.executeStartTime>0?Date.now()-this.executeStartTime:0,termination_reason:this.terminationReason};kernel.logger.info("zulu",`[retrieval_agent][metrics] ${JSON.stringify(e)}`)}classifyQueryIntent(e){const t=/^\[(?:FIX|VERIFY)\]|^【(?:修复|验证)】|\b(fix|bug|issue|error|fail|resolve|patch|repair|broken|crash|regression)\b|修复|报错|异常|问题|缺陷|崩溃/i.test(e)?"fix":"understand";return kernel.logger.info("zulu",`[fix_a][intent] query_prefix="${e.slice(0,12)}" classified=${t}`),t}sampleRepoProfile(e,t=500,r=3){const n=new Set([".md",".rst",".txt",".adoc",".wiki",".org"]),i=new Set([".ts",".js",".mjs",".cjs",".tsx",".jsx",".py",".go",".java",".c",".cpp",".cc",".h",".hpp",".rs",".rb",".php",".cs",".swift",".kt",".scala",".dart",".lua",".sh",".bash",".zsh",".ps1"]);let o=0,s=0,a=0;const c=(e,l)=>{if(l>r||a>=t)return;let A;try{A=readdirSync$1(e)}catch{return}for(const r of A){if(a>=t)break;if(r.startsWith("."))continue;const A=path__default$1.join(e,r);let u;try{u=statSync$2(A)}catch{continue}if(u.isDirectory())c(A,l+1);else{a++;const e=path__default$1.extname(r).toLowerCase();n.has(e)?o++:i.has(e)&&s++}}};c(e,0);let l;return l=(a>0?o/a:0)>=.7?"doc":(a>0?s/a:0)>=.6?"code":"auto",{docCount:o,codeCount:s,total:a,suggestion:l}}async execute(){this.token.onNotify(this.handleTokenNotification.bind(this)),this.executeStartTime=Date.now();const e=this.getStringParam("context")||"",t=this.getStringParam("query");this.queryIntent=this.classifyQueryIntent(t||""),kernel.logger.info("zulu",`[retrieval_agent][intent] classified as: ${this.queryIntent}`);const r=this.getStringParam("retrieval_type");"doc"!==r&&"auto"!==r||(this.retrievalType=r),kernel.logger.info("zulu",`[retrieval_agent][retrieval_type] type=${this.retrievalType}`);const n=this.getStringParam("max_rounds");if(n){const e=parseInt(n,10);!isNaN(e)&&e>0&&(this.maxRounds=e)}this.originalMaxRounds=this.maxRounds;const i=this.getStringParam("max_summary_rounds");if(i){const e=parseInt(i,10);!isNaN(e)&&e>0&&(this.maxSummaryRounds=e)}const o=this.params.max_parallelism;if(o){const e=parseInt(o,10);!isNaN(e)&&e>=1&&e<=8&&(this.maxParallelism=e)}const s=e?`检索意图：${t}\n\n已知上下文：${e}`:t,a=s;this.initialQuery=a;const c=RetrievalAgent.extractStackTraceFiles(s);let l="";c.length>0&&(l=`\n\n【系统提取的 Stack Trace 文件】以下文件从查询中的报错/堆栈信息自动提取，建议第一轮优先 read_file：\n${c.map((e=>`- ${e}`)).join("\n")}`,kernel.logger.info("zulu",`[retrieval_agent][stack_trace] files_extracted=${c.length}, files=[${c.join(", ")}]`));const A=a+l+`\n\n【当前轮次】第 1 轮 / 共 ${this.maxRounds} 轮\n\n【首轮输出要求】在调用工具之前，你必须先输出 <round_summary> 标签，包含你对检索问题的分析、拆解和检索规划（打算搜什么、为什么这样搜、预期找到什么），然后再输出工具调用。格式示例：\n<round_summary>\n问题分析：...\n检索规划：...\n</round_summary>\n（然后输出工具调用）`,u=this.agentInfo?.agentPrompt??RetrievalAgent.RETRIEVAL_PHASE_PROMPT;kernel.logger.info("zulu",`[retrieval_agent][system_prompt] length=${u.length} retrieval_type=${this.retrievalType}\n---PROMPT_START---\n${u}\n---PROMPT_END---`),kernel.logger.info("zulu",`[retrieval_agent][initial_query] length=${a.length}\n---QUERY_START---\n${a}\n---QUERY_END---`),this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,query:A,isUserQuery:!0,subAgents:[]});try{const e=await this.token.waitForCompletion(),t=e[0]?.output?.length||0;let r=!1;t>5e4&&(r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Abnormally long output: ${t} chars (normal P95=5K). Likely LLM repetitive degeneration. retrieval_id=${this.combinedSubtaskId}`));let n=truncateLine(e[0]?.output||"",3e4);kernel.logger.info("zulu",`[retrieval_agent][debug] waitForCompletion success, retrieval_id=${this.combinedSubtaskId}, output_length=${t}`);const i=(n.match(/<effective_blocks>/g)||[]).length;if(i>1){r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Detected ${i} repeated <effective_blocks> in rawSummary (output_length=${t}), deduplicating to first occurrence`);const e=n.indexOf("</effective_blocks>");if(e>0){const t=e+19,r=n.substring(t).replace(/<effective_blocks>[\s\S]*?<\/effective_blocks>/g,"");n=n.substring(0,t)+r}}let o=0;const s={},a=2,c=4;for(;;){const e=/<retrieval_complete\s*\/?>/.test(n),t=0===this.effectiveBlocksMap.size&&!e&&this.roundCount<this.maxRounds-1,i=r,l=this.parseRoundSummary(n),A=l.length>0&&/下一步|接下来|还需要|需要进一步|然后再|待探索|待执行|待处理/.test(l),u=A&&e,d=l.length>0&&/未确认|未验证|待补充|未探索|未追踪|未读取|缺失|尚未|未能确认|需要进一步/.test(l),h=this.effectiveBlocksMap.size<("code"===this.retrievalType?3:6)&&this.roundCount<this.maxRounds-1,p=this.effectiveBlocksMap.size>0&&Array.from(this.effectiveBlocksMap.values()).every((e=>/[/\\]tests?[/\\]|[/\\]test_|_test\.[^.]+$/.test(e.file))),g=Array.from(this.traceEdgesMap.values()).filter((e=>"pending"===e.status)),f=g.length>0&&this.traceEdgesMap.size<=15,m=Array.from(this.breadthProbesMap.values()).some((e=>"needs_exploration"===e.status)),E=n.match(/<retrieval_exit_check>([\s\S]*?)<\/retrieval_exit_check>/),C=null!==E,I=E?.[1]??"",y=I.match(/<evidence_density\s+status="(\w+)"/)?.[1]??null,B=I.match(/<expected_behavior_coverage\s+status="(\w+)"/)?.[1]??null,b=I.match(/<exit_verdict\s+status="(\w+)"/)?.[1]??null,v=I.match(/<exploration_breadth\s+status="(\w+)"/)?.[1]??null,w=e&&!C,S=e&&C&&"BLOCKED"===b,_=e&&C&&"PASS"===y&&this.effectiveBlocksMap.size<2,Q=e&&C&&"N/A"===B&&"code"===this.retrievalType,D=e&&C&&("doc"===this.retrievalType||"auto"===this.retrievalType)&&"PASS"===y&&this.effectiveBlocksMap.size<6,x=e&&C&&("doc"===this.retrievalType||"auto"===this.retrievalType)&&"INSUFFICIENT"===v&&"APPROVED"===b;(D||x)&&kernel.logger.warn("zulu",`[retrieval_agent][exit_check_doc_fake] doc/auto mode round=${this.roundCount}, reason=${D?"density_fake":"breadth_contradiction"}, effectiveBlocks=${this.effectiveBlocksMap.size}, explorationBreadthStatus=${v??"N/A"}`);const k=w||S||_||Q||D||x,R=e&&!u&&(d||h||f||m||p);p&&e&&kernel.logger.info("zulu",`[x1][all_from_tests] blocked premature complete, effectiveBlocksSize=${this.effectiveBlocksMap.size}`);const T=""===n&&h;if(!((t||i||u||R||T||k)&&o<c)){o>=c&&(u||R)&&(n=n.replace(/<retrieval_complete\s*\/?>/g,""),kernel.logger.warn("zulu",`[retrieval_agent][guard] Retries exhausted but conflict persists (plan_action_conflict=${u}, premature_complete=${R}). Stripped retrieval_complete from rawSummary to continue retrieval.`));break}o++;const $=t?"format_degradation":i?"repetitive_degeneration":u?"plan_action_conflict":f?"unfinished_tracing":m?"unfinished_breadth":T?"early_exit_sparse":k?"exit_check_failed":p?"all_from_tests":"premature_complete";if(s[$]=(s[$]||0)+1,s[$]>a){kernel.logger.warn("zulu",`[retrieval_agent][guard] Per-type retry budget exhausted for ${$} (${s[$]}/${a}), skipping`);break}const N=/<(codebase_search|grep_content|search_files|read_file|list_files|run_command|extract_content_blocks|glob_path)[\s>]/.test(n);kernel.logger.warn("zulu",`[retrieval_agent][guard] Abnormal round detected (${$}): roundCount=${this.roundCount}/${this.maxRounds}, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}, hasRetrievalComplete=${e}, xmlToolCalls=${N}, hasPendingPlan=${A}, hasUnresolvedGaps=${d}, sparseEvidence=${h}, earlyExitSparse=${T}, pendingTraceEdges=${g.length}, unfinishedBreadth=${m}, exitCheckPresent=${C}, exitVerdict=${b}, evidenceDensityStatus=${y}, behaviorCoverage=${B}. Discarding current round, clean retry ${o}/${c} (${$}: ${s[$]}/${a})`);const F="format_degradation"===$&&N?`（上一轮你调用了工具但未产生有效代码块。${(()=>{try{return"工具执行成功但未找到相关内容。"}catch{return""}})()}请调整搜索策略：换关键词、用 codebase_search 语义搜索、或 list_dir 探索其他目录。）`:"format_degradation"===$?"（上一轮 LLM 响应未正确发起工具调用。请使用工具继续检索，不要输出纯文本格式的工具调用。）":"repetitive_degeneration"===$?"（上一轮 LLM 输出异常（重复退化），已被丢弃。请重新对当前搜索结果进行标注和分析。）":"early_exit_sparse"===$?`【证据不足，禁止结束】你在上一轮没有调用任何工具就结束了检索，但当前 effective_blocks 中只有 ${this.effectiveBlocksMap.size} 个 valid 块，远低于所需的 ${"code"===this.retrievalType?3:6} 个。证据严重不足时禁止输出 retrieval_complete。请立即继续检索：调用工具搜索和读取更多文件，在 effective_blocks 中标注更多 valid 块，确认证据充分后再决定是否结束。`:"plan_action_conflict"===$&&0===this.effectiveBlocksMap.size?"【严重错误】你在 effective_blocks 中没有标记任何有效块（0 个 valid），却同时在 round_summary 中写了未完成的计划并输出了 retrieval_complete。这两点都是错误的：(1) 在没有任何 valid 块的情况下禁止输出 retrieval_complete；(2) 有未完成的计划就不能声明完成。你必须：先完成计划中的所有搜索 → 用 read_file 读取候选文件内容 → 在 effective_blocks 中标记至少一个 valid_unfold 或 valid_fold → 确认有有效证据后才可输出 retrieval_complete。":"plan_action_conflict"===$?`（上一轮你在 round_summary 中写了: "${l.substring(0,200)}"，但同时输出了 retrieval_complete。这两者矛盾。请先执行上述计划中的操作，完成后再决定是否结束。）`:"exit_check_failed"===$&&w?"doc"===this.retrievalType||"auto"===this.retrievalType?"【缺少退出自检】你输出了 retrieval_complete 但未提供 <retrieval_exit_check> 自检块。必须在 retrieval_complete 之前完成五维度自检（evidence_density、exploration_breadth、knowledge_type_coverage、coverage_gaps、exit_verdict），且 exit_verdict=APPROVED 时系统才会接受 retrieval_complete。请补充自检块后重新决定是否结束。":"【缺少退出自检】你输出了 retrieval_complete 但未提供 <retrieval_exit_check> 自检块。必须在 retrieval_complete 之前完成五维度自检（evidence_density、core_read_depth、expected_behavior_coverage、coverage_gaps、exit_verdict），且 exit_verdict=APPROVED 时系统才会接受 retrieval_complete。请补充自检块后重新决定是否结束。":"exit_check_failed"===$&&S?"【自检未通过】你的 <retrieval_exit_check> 中 exit_verdict=BLOCKED，说明你自己认为检索尚未完成。请根据自检中指出的不足继续探索，完成后重新自检并更新为 APPROVED 再输出 retrieval_complete。":"exit_check_failed"===$&&_?`【自检与指标矛盾】你声明 evidence_density=PASS，但系统检测到 effective_blocks 中只有 ${this.effectiveBlocksMap.size} 个 valid 块（可信阈值为 2）。请补充更多 valid 代码块后重新自检，确保自检结论与实际证据数量一致。`:"exit_check_failed"===$&&D?`【自检与指标矛盾（广度模式）】你声明 evidence_density=PASS，但系统检测到 effective_blocks 只有 ${this.effectiveBlocksMap.size} 个 valid 块（doc/auto 模式可信阈值为 6）。请继续探索更多目录和文件，标注更多 valid 块后重新自检。`:"exit_check_failed"===$&&x?"【广度探索自评矛盾】你的 exploration_breadth=INSUFFICIENT，但 exit_verdict=APPROVED，自评存在矛盾。请先完成广度探索（多目录 list_dir + 多关键词 grep_content），确认 exploration_breadth=PASS 后再输出 exit_verdict=APPROVED。":"exit_check_failed"===$?"【期望行为覆盖缺失】检索类型为 code，但 expected_behavior_coverage=N/A，未说明期望行为来源。code 类型任务必须查阅相关 test 文件、注释或文档确认期望行为，否则不能通过自检。请查阅相关 test 文件后重新自检。":N?"all_from_tests"===$?`（当前 effective_blocks 全部来自测试文件（${this.effectiveBlocksMap.size} 个），尚未找到任何实现文件。测试文件只能辅助理解预期行为，不能作为修复证据。请继续检索实现文件（非 tests/ 目录）：用 grep_content 搜索关键词、用 list_dir 探索 src/ 或对应模块目录、用 read_file 读取实现文件内容后标注 valid_unfold/valid_fold，确保有实现文件的证据后再结束。）`:d?'（上一轮你在 round_summary 中存在未解决的深度缺口（如"未确认"、"未验证"、"待补充"等），但同时输出了 retrieval_complete。请先逐一验证这些缺口，确认所有关键假设已通过 read_file 验证后再决定是否结束。）':"（上一轮你在仅有少量有效代码块的情况下就输出了 retrieval_complete，且距离检索轮次上限还有余量。请继续深入检索，扩大搜索范围，确保证据充分后再结束。）":"【严重错误】你上一轮没有调用任何工具就直接输出了 retrieval_complete，这是绝对禁止的行为。无论你对答案有多大把握，都必须通过工具实际搜索和读取文件后才能结束。请立即执行：(1) 调用 grep_content 搜索相关关键词（支持 -i 不区分大小写），或调用 glob_path 获取候选文件列表；(2) 调用 read_file 读取最相关的候选文件内容；(3) 在 effective_blocks 中标记至少一个 valid_unfold 或 valid_fold 块；(4) 完成以上步骤后再决定是否输出 retrieval_complete。",M=this.buildRoundContext([],F),P=this.toolTurns[this.toolTurns.length-1],L=P?.rollbackMessageId;this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:[],query:M,isUserQuery:!0,rollbackMessageId:L});let O=[],U=0;for(;;){const e=this.token.waitForCompletion();try{O=await Promise.race([e,new Promise(((e,t)=>setTimeout((()=>t(new Error("clean_retry_timeout"))),RetrievalAgent.CLEAN_RETRY_TIMEOUT_MS)))]);break}catch(t){if("clean_retry_timeout"!==(t instanceof Error?t.message:String(t)))throw t;if(U++,kernel.logger.warn("zulu",`[retrieval_agent][guard] Clean retry ${o} timed out after ${RetrievalAgent.CLEAN_RETRY_TIMEOUT_MS}ms (timeout retry ${U}/${RetrievalAgent.MAX_TIMEOUT_RETRIES})`),U>=RetrievalAgent.MAX_TIMEOUT_RETRIES)throw kernel.logger.error("zulu",`[retrieval_agent][guard] Clean retry ${o}: exhausted all ${RetrievalAgent.MAX_TIMEOUT_RETRIES} timeout retries. effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`),new Error(`[clean_retry_timeout_exhausted] Guard clean retry timed out ${RetrievalAgent.MAX_TIMEOUT_RETRIES} times consecutively. RA failed to complete retrieval. Main agent should proceed with independent retrieval.`);e.catch((()=>{})),this.token.cancel(),this.token.reset(),kernel.logger.warn("zulu",`[retrieval_agent][guard] Cancelled hung agentLoop, starting timeout retry ${U}/${RetrievalAgent.MAX_TIMEOUT_RETRIES}`),this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:[],query:M,isUserQuery:!0,rollbackMessageId:L})}}const G=O[0]?.output?.length||0;n=truncateLine(O[0]?.output||"",3e4),r=!1,G>5e4&&(r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Retry output still abnormally long: ${G} chars`));const H=(n.match(/<effective_blocks>/g)||[]).length;if(H>1){r=!0,kernel.logger.warn("zulu",`[retrieval_agent][guard] Retry output still has ${H} repeated <effective_blocks>, deduplicating`);const e=n.indexOf("</effective_blocks>");if(e>0){const t=e+19,r=n.substring(t).replace(/<effective_blocks>[\s\S]*?<\/effective_blocks>/g,"");n=n.substring(0,t)+r}}kernel.logger.info("zulu",`[retrieval_agent][guard] Clean retry ${o} completed: output_length=${G}, degenerated=${r}`)}o>0&&kernel.logger.info("zulu",`[retrieval_agent][guard] Guard loop exited after ${o} clean retries, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`);try{if(/<retrieval_complete\s*\/?>/.test(n)){this.roundCount+=1;let e=!1,t=0;const r=this.parseRoundSummary(n);r&&(this.roundSummaries.push(r),e=!0,t=r.length);const i=this.parseEffectiveBlocks(n,this.roundCount),o=this.parseTraceEdges(n,this.roundCount);this.updateBreadthProbes();const s=this.parseBreadthStatus(n,this.roundCount);kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} round_summary_parsed=${e}, summary_length=${t}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} effective_blocks_parsed=${i.found}, added=${i.added}, removed=${i.removed}, map_total=${this.effectiveBlocksMap.size}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} final_trace_edges=${o.found}, final_breadth_status=${s.found}`)}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][debug] Failed to parse final round: ${e.message}`)}const l=this.effectiveBlocksMap.size>0;if(kernel.logger.info("zulu",`[retrieval_agent][summary] using_main_path=${l}, effective_blocks_count=${this.effectiveBlocksMap.size}`),l){const e=2;for(let t=0;t<=e;t++)try{const e=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):this.retrievalLog.join("\n")||"（无检索记录）",t=await this.buildFromEffectiveBlocksBatched();kernel.logger.info("zulu",`[retrieval_agent][summary] batches=${t.length}, maxSummaryRounds=${this.maxSummaryRounds}`);let r="";if(t.length<=1){const n=t.length>0?t[0].blocks:"（无有效代码块）",i=("code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_PROMPT).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{EFFECTIVE_BLOCKS}}",n);kernel.logger.info("zulu",`[retrieval_agent][summary] Single-round summary, effective context length=${n.length}`);const o={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};let s=0,a=!1;for(;!a;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:o,subAgents:[],query:i,isUserQuery:!0});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("single_summary_timeout"))),"code"!==this.retrievalType?RetrievalAgent.DOC_SUMMARY_TIMEOUT_MS:RetrievalAgent.PHASE_TIMEOUT_MS)))]);if(r=truncateLine(e[0]?.output||"",3e4),r.trim().length>0&&r.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&s<RetrievalAgent.MAX_RETRY_COUNT){s++,kernel.logger.warn("zulu",`[retrieval_agent][retry] single-round summary short_reply (${r.trim().length} chars), retryCount=${s}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}a=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(s<RetrievalAgent.MAX_RETRY_COUNT){s++,kernel.logger.warn("zulu",`[retrieval_agent][retry] single-round summary attempt failed: ${t.substring(0,200)}, retryCount=${s}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] single-round summary exhausted retries: ${t.substring(0,200)}`),a=!0}{const e=RetrievalAgent.parseSummarySelfcheck(r);e?("UNSATISFIED"===e.intentSatisfaction&&kernel.logger.warn("zulu","[retrieval_agent][summary_intent_unsatisfied] Path A: intent_satisfaction=UNSATISFIED"),"NEEDS_REANNOTATION"===e.summaryVerdict?kernel.logger.warn("zulu",`[retrieval_agent][summary_selfcheck_reannotation] Path A: summary_verdict=NEEDS_REANNOTATION, targets: ${e.reannotationTargets.map((e=>e.file)).join(", ")}`):kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_ok] Path A: verdict=${e.summaryVerdict??"null"}, intent=${e.intentSatisfaction??"null"}`)):kernel.logger.warn("zulu","[retrieval_agent][summary_selfcheck_missing] Path A: no summary_retrieval_selfcheck block")}}else{kernel.logger.info("zulu",`[retrieval_agent][summary] Multi-round annotation: ${t.length} annotation rounds + 1 final round`);const n=[],i=[],o=t.length,s="doc"===this.retrievalType?RetrievalAgent.DOC_ANNOTATION_PHASE_PROMPT:"auto"===this.retrievalType?RetrievalAgent.AUTO_ANNOTATION_PHASE_PROMPT:RetrievalAgent.ANNOTATION_PHASE_PROMPT,a="fix"===this.queryIntent?s+RetrievalAgent.FIX_HINT_REQUIREMENT_SEGMENT:s,c={...this.agentInfo,agentPrompt:a,tools:[]},l=Array.from(this.effectiveBlocksMap.entries()).map((([e,t],r)=>{const n=this.codeBlockRegistry.get(e),i=(n?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n");return`${r+1}. [${e}] ${t.file}:${t.startLine}-${t.endLine} — ${t.reason}\n${i}`})).join("\n");if(t.length>=3){kernel.logger.info("zulu",`[retrieval_agent][summary] Parallel annotation mode: ${t.length} batches (>= 3 threshold)`);const r=t.map(((e,t)=>`批次 ${t+1}（${e.blockCount} 个代码块，${e.totalLines} 行）:\n${e.blocks.split("\n").filter((e=>e.startsWith("[代码块]")||e.startsWith("[信息块]"))).map((e=>`  ${e}`)).join("\n")||"  (详见代码块)"}`)).join("\n\n"),s=RetrievalAgent.ANNOTATION_PLAN_PROMPT.replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BATCH_COUNT}}",String(t.length)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{BATCHES_OVERVIEW}}",r);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation planning round: prompt_length=${s.length}`);const a={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};let A,u="";for(let e=1;e<=RetrievalAgent.MAX_RETRY_COUNT+1;e++)try{this.agentLoop({taskId:this.subtaskId,agentInfo:a,subAgents:[],query:s,isUserQuery:!0});const t=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("planning_timeout"))),RetrievalAgent.PHASE_TIMEOUT_MS)))]);u=truncateLine(t[0]?.output||"",3e4);const r=this.toolTurns[this.toolTurns.length-1];if(A=r?.rollbackMessageId,kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation planning output_length=${u.length} (attempt ${e})`),u.length>0)break;if(e<=RetrievalAgent.MAX_RETRY_COUNT){kernel.logger.warn("zulu",`[retrieval_agent][retry] planning round empty output, retrying ${e}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}}catch(t){const r=t instanceof Error?t.message:String(t);if(kernel.logger.warn("zulu",`[retrieval_agent][retry] planning round attempt ${e} failed: ${r.substring(0,200)}`),e>RetrievalAgent.MAX_RETRY_COUNT)break}const d=parseAnnotationPlan(u,t.length);if(d){kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation plan parsed: ${d.batches.length} batch plans, P1_total=${d.batches.reduce(((e,t)=>e+t.priorityBudget.p1),0)}`);const r=Date.now(),s=12e4,a=3,A=(e,t)=>{const r=[],n=/\[代码块[^\]]*\]\s*(\S+):(\d+)-(\d+)\s*\(([^)]*)\)/g;let i;for(;null!==(i=n.exec(e.blocks));){const[,n,o,s,a]=i,c=e.blocks.substring(i.index+i[0].length).match(/```\n([\s\S]*?)```/),l=(c?.[1]||"").split("\n"),A=l.slice(0,5).join("\n")+(l.length>5?"\n...":"");r.push({file:n,scope:`${o}-${s}`,rawText:A,originalMatch:"",annotationRound:t,reason:`[ANNOTATION-FAILED] ${a}`})}const o=r.length>0?r.map(((e,t)=>`- EVIDENCE ${t+1} (标注失败降级): ${e.file}:${e.scope} — ${e.reason}`)).join("\n"):"- （标注失败，且未能提取代码块信息）";return{evidences:r,summary:`### 标注轮 ${t}（标注失败，已降级为粗粒度 evidence）\n${o}`,output:""}},u=async(t,r,n)=>{for(let i=1;i<=a;i++)try{const A=`UNFOLD-1: ${n.priorityBudget.p1}, UNFOLD-2: ${n.priorityBudget.p2}, UNFOLD-3: ${n.priorityBudget.p3}, UNFOLD-4: ${n.priorityBudget.p4}, FOLD: ${n.priorityBudget.fold}`,u=RetrievalAgent.PARALLEL_ANNOTATION_PROMPT.replace("{{CURRENT_ROUND}}",String(r)).replace("{{TOTAL_ROUNDS}}",String(o)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{BATCH_FOCUS}}",n.focus).replace("{{PRIORITY_BUDGET}}",A).replace("{{P1_BUDGET}}",String(n.priorityBudget.p1)).replace("{{VALID_BLOCKS_OVERVIEW}}",l).replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BLOCK_COUNT}}",String(t.blockCount)).replace("{{LINE_COUNT}}",String(t.totalLines)).replace("{{CURRENT_BLOCKS}}",t.blocks),d=i>1?` (retry ${i-1})`:"";kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${r}/${o} (parallel${d}): ${t.blockCount} blocks, ${t.totalLines} lines, prompt_length=${u.length}, focus="${n.focus.substring(0,80)}"`);const h=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:c,taskInfo:{description:`Annotation batch ${r}/${o}`,query:u},signal:this.ctx.signal});kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation batch ${r} created subtask: subtaskId=${h}`);const p=[],g=new Token(`annotation-parallel-${r}-attempt-${i}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:h,userTurn:this.ctx.userTurn},p,g).executeStream({updatedParams:{taskId:h,agentInfo:c,subAgents:[],query:u,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const f=await Promise.race([g.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error(`Annotation batch ${r} attempt ${i} timeout after ${s}ms`))),s)))]),m=truncateLine(f?.[0]?.output||"",3e4);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${r} completed (parallel${d}), output_length=${m.length}`);const E=parseEvidenceBlocks(m),C=[];for(const e of E){const t=extractReasonAfterEvidence(m,e);C.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:r,reason:t,fixHint:RetrievalAgent.parseFixHint(t)})}if("fix"===this.queryIntent){const e=C.filter((e=>/\[UNFOLD-1\]/i.test(e.reason)&&!e.fixHint));if(e.length>0&&i<a){kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_retry] round=${r} ${e.length} UNFOLD-1 evidences missing FIX-HINT, retrying`);continue}for(const t of e)t.reason+="\n[FIX-HINT] UNCERTAIN - 标注重试后仍未给出修复建议",t.fixHint="UNCERTAIN - 标注重试后仍未给出修复建议",kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_fallback] ${t.file}:${t.scope} retry exhausted, auto-filled UNCERTAIN`)}const I=E.length>0?Math.round(E.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0)/E.length):0;kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${r} (parallel${d}): evidence_count=${C.length}, avg_evidence_lines=${I}`);const y=RetrievalAgent.parseAnnotationCoverageCheck(m);if(y){kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_check] round=${r}: coverage_verdict=${y.coverageVerdict}, evidence_precision=${y.evidencePrecision}, alignment=${y.retrievalReasonAlignment}`),"MISALIGNED"===y.retrievalReasonAlignment&&kernel.logger.warn("zulu",`[retrieval_agent][annotation_reason_misaligned] round=${r}: ${y.alignmentDetail.substring(0,300)}`);const e="INCOMPLETE"===y.coverageVerdict,t="IMPRECISE"===y.evidencePrecision;if((e||t)&&i<a){kernel.logger.warn("zulu",`[retrieval_agent][${e?"isCoverageIncomplete":"isEvidenceImprecise"}] round=${r} attempt=${i}: verdict=${y.coverageVerdict} precision=${y.evidencePrecision}, retrying. detail: ${y.verdictDetail.substring(0,200)}`);continue}}else kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_missing] round=${r} attempt=${i}: no annotation_coverage_check block found`);const B=C.length>0?C.map(((e,t)=>`- EVIDENCE ${t+1}: ${e.file} scope="${e.scope}" — ${e.reason||"(无说明)"}`)).join("\n"):"- （本轮未产生有效标注）";return{evidences:C,summary:`### 标注轮 ${r}\n${B}`,output:m}}catch(e){const n=e instanceof Error?e.message:String(e);if(i<a){kernel.logger.warn("zulu",`[retrieval_agent][summary] Annotation round ${r} attempt ${i}/${a} failed: ${n.substring(0,200)}, clean retrying`);continue}return kernel.logger.warn("zulu",`[retrieval_agent][summary] Annotation round ${r} failed after ${a} attempts: ${n.substring(0,200)}, degrading to raw evidence`),this.annotationHasDegradedEvidence=!0,A(t,r)}return A(t,r)},h=t.map(((e,t)=>{const r=t+1,n=d.batches[t]||{id:r,priorityBudget:{p1:1,p2:2,p3:3,p4:2,fold:2},focus:"按检索意图标注相关代码"};return u(e,r,n)})),p=await Promise.all(h),g=Date.now()-r;let f=0;for(const e of p){for(const t of e.evidences)n.push(t),f++;i.push(e.summary)}const m=n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))),E=new Set(m.map((e=>e.file))).size;if(E>5){kernel.logger.warn("zulu",`[retrieval_agent][summary] Parallel annotation UNFOLD-1 file overflow: ${E} files > 5, degrading excess to UNFOLD-2`);const e=[];for(const t of m)e.includes(t.file)||e.push(t.file);const t=new Set(e.slice(0,5));for(const e of m)t.has(e.file)||(e.reason=e.reason.replace(/\[UNFOLD-1\]/i,"[UNFOLD-2]"))}kernel.logger.info("zulu",`[retrieval_agent][summary] Parallel annotation completed: duration=${g}ms, total_evidences=${n.length}, batches=${t.length}`)}else{kernel.logger.warn("zulu","[retrieval_agent][summary] Annotation plan parse failed, falling back to serial annotation");let r=A;const s=new Map;for(let a=0;a<t.length;a++){const l=t[a],A=a+1,u=n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))).length,d=n.filter((e=>/\[UNFOLD-2\]/i.test(e.reason))).length,h=n.filter((e=>/\[UNFOLD-3\]/i.test(e.reason))).length,p=n.filter((e=>/\[FOLD\]/i.test(e.reason))).length,g=n.length>0?`\n📊 前轮优先级统计：共 ${n.length} 条证据（UNFOLD-1: ${u}, UNFOLD-2: ${d}, UNFOLD-3: ${h}, FOLD: ${p}）。汇总阶段的展开预算有限，如果 UNFOLD-1 已较多，请将本轮中相对次要的证据标为 UNFOLD-2 或 UNFOLD-3，只将真正核心的标为 UNFOLD-1。\n`:"",f=i.length>0?`## 前轮已标注的证据摘要\n${i.join("\n")}\n${g}\n（注意：以上仅为前轮已标注证据的路径和摘要，完整代码由系统单独存储。请专注于标注下方当前批次的代码块，无需重复标注前轮内容。）\n`:"",m=new Set;for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&l.blocks.includes(`${t.startLine}-${t.endLine}`)&&m.add(e);const E=Array.from(this.effectiveBlocksMap.entries()).map((([e,t],r)=>{const n=this.codeBlockRegistry.get(e),i=(n?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n"),o=m.has(e)?" ★当前批次":"",a=s.get(e),c=a&&a.length>0?` [已标注] ${a.join(", ")}`:"";return`${r+1}. [${e}] ${t.file}:${t.startLine}-${t.endLine}${o} — ${t.reason}${c}\n${i}`})).join("\n"),C=RetrievalAgent.SUMMARY_ANNOTATION_PROMPT.replace("{{CURRENT_ROUND}}",String(A)).replace("{{TOTAL_ROUNDS}}",String(o)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{PREVIOUS_ANNOTATIONS}}",f).replace("{{VALID_BLOCKS_OVERVIEW}}",E).replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BLOCK_COUNT}}",String(l.blockCount)).replace("{{LINE_COUNT}}",String(l.totalLines)).replace("{{CURRENT_BLOCKS}}",l.blocks);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A}/${o} (serial fallback): ${l.blockCount} blocks, ${l.totalLines} lines, prompt_length=${C.length}`);let I="",y=0,B=!1;for(;!B;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:c,subAgents:[],query:C,isUserQuery:!0,rollbackMessageId:r});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error(`serial_fallback_annotation_${A}_timeout`))),RetrievalAgent.PHASE_TIMEOUT_MS)))]),t=this.toolTurns[this.toolTurns.length-1];if(r=t?.rollbackMessageId,I=truncateLine(e[0]?.output||"",3e4),I.trim().length>0&&I.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&y<RetrievalAgent.MAX_RETRY_COUNT){y++,kernel.logger.warn("zulu",`[retrieval_agent][retry] annotation round ${A} short_reply (serial fallback), retryCount=${y}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}B=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(y<RetrievalAgent.MAX_RETRY_COUNT){y++,kernel.logger.warn("zulu",`[retrieval_agent][retry] serial fallback annotation round ${A} attempt failed: ${t.substring(0,200)}, retryCount=${y}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] serial fallback annotation round ${A} exhausted retries: ${t.substring(0,200)}, using degraded evidence`),this.annotationHasDegradedEvidence=!0;for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&n.push({file:t.file,scope:`${t.startLine}-${t.endLine}`,rawText:"（标注超时，降级证据）",originalMatch:"",annotationRound:A,reason:"[ANNOTATION-TIMEOUT] 标注轮超时，此代码块未经 LLM 精细标注"});i.push(`### 标注轮 ${A}\n- （标注超时，已降级为粗粒度证据）`),B=!0}if(y>RetrievalAgent.MAX_RETRY_COUNT)continue;const b=parseEvidenceBlocks(I);for(const e of b){const t=extractReasonAfterEvidence(I,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:A,reason:t,coreSummary:e.coreSummary})}for(const e of b)for(const[t,r]of this.effectiveBlocksMap.entries())if(r.file===e.file){s.has(t)||s.set(t,[]),s.get(t).push(e.scope);break}const v=b.length>0?b.map(((e,t)=>{const r=n.length-b.length+t+1,i=extractReasonAfterEvidence(I,e);return`- EVIDENCE ${r}: ${e.file} scope="${e.scope}" — ${i||"(无说明)"}`})).join("\n"):"- （本轮未产生有效标注）";i.push(`### 标注轮 ${A}\n${v}`);const w=b.length>0?Math.round(b.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0)/b.length):0;kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A} completed (serial fallback), output_length=${I.length}, stored_evidence_count=${n.length}, evidence_count_this_round=${b.length}, avg_evidence_lines=${w}`)}}}else{let r;const s=new Map;for(let a=0;a<t.length;a++){const l=t[a],A=a+1,u=n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))).length,d=new Set(n.filter((e=>/\[UNFOLD-1\]/i.test(e.reason))).map((e=>e.file))).size,h=n.filter((e=>/\[UNFOLD-2\]/i.test(e.reason))).length,p=n.filter((e=>/\[UNFOLD-3\]/i.test(e.reason))).length,g=n.filter((e=>/\[FOLD\]/i.test(e.reason))).length,f=n.length>0?`\n📊 前轮优先级统计：共 ${n.length} 条证据（UNFOLD-1: ${u}条/${d}文件, UNFOLD-2: ${h}, UNFOLD-3: ${p}, FOLD: ${g}）。注意：UNFOLD-1 按文件级计数，同文件多条 UNFOLD-1 只占 1 个配额（上限 5 文件）。如果已覆盖较多文件，请将本轮中相对次要的证据标为 UNFOLD-2 或 UNFOLD-3。\n`:"",m=i.length>0?`## 前轮已标注的证据摘要\n${i.join("\n")}\n${f}\n（注意：以上仅为前轮已标注证据的路径和摘要，完整代码由系统单独存储。请专注于标注下方当前批次的代码块，无需重复标注前轮内容。）\n`:"",E=new Set;for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&l.blocks.includes(`${t.startLine}-${t.endLine}`)&&E.add(e);const C=Array.from(this.effectiveBlocksMap.entries()).map((([e,t],r)=>{const n=this.codeBlockRegistry.get(e),i=(n?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n"),o=E.has(e)?" ★当前批次":"",a=s.get(e),c=a&&a.length>0?` [已标注] ${a.join(", ")}`:"";return`${r+1}. [${e}] ${t.file}:${t.startLine}-${t.endLine}${o} — ${t.reason}${c}\n${i}`})).join("\n"),I=RetrievalAgent.SUMMARY_ANNOTATION_PROMPT.replace("{{CURRENT_ROUND}}",String(A)).replace("{{TOTAL_ROUNDS}}",String(o)).replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{PREVIOUS_ANNOTATIONS}}",m).replace("{{VALID_BLOCKS_OVERVIEW}}",C).replace("{{TOTAL_BLOCKS}}",String(this.effectiveBlocksMap.size)).replace("{{BLOCK_COUNT}}",String(l.blockCount)).replace("{{LINE_COUNT}}",String(l.totalLines)).replace("{{CURRENT_BLOCKS}}",l.blocks);kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A}/${o}: ${l.blockCount} blocks, ${l.totalLines} lines, prompt_length=${I.length}, rollbackId=${r||"none"}`);let y="",B=0,b=!1;for(;!b;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:c,subAgents:[],query:I,isUserQuery:!0,rollbackMessageId:r});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error(`serial_annotation_${A}_timeout`))),RetrievalAgent.PHASE_TIMEOUT_MS)))]),t=this.toolTurns[this.toolTurns.length-1];if(r=t?.rollbackMessageId,y=truncateLine(e[0]?.output||"",3e4),y.trim().length>0&&y.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&B<RetrievalAgent.MAX_RETRY_COUNT){B++,kernel.logger.warn("zulu",`[retrieval_agent][retry] annotation round ${A} short_reply detected (${y.trim().length} chars), retryCount=${B}/${RetrievalAgent.MAX_RETRY_COUNT}, re-issuing same batch`);continue}b=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(B<RetrievalAgent.MAX_RETRY_COUNT){B++,kernel.logger.warn("zulu",`[retrieval_agent][retry] serial annotation round ${A} attempt failed: ${t.substring(0,200)}, retryCount=${B}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] serial annotation round ${A} exhausted retries: ${t.substring(0,200)}, using degraded evidence`);for(const[e,t]of this.effectiveBlocksMap.entries())l.blocks.includes(t.file)&&n.push({file:t.file,scope:`${t.startLine}-${t.endLine}`,rawText:"（标注超时，降级证据）",originalMatch:"",annotationRound:A,reason:"[ANNOTATION-TIMEOUT] 标注轮超时，此代码块未经 LLM 精细标注"});i.push(`### 标注轮 ${A}\n- （标注超时，已降级为粗粒度证据）`),b=!0}if(B>RetrievalAgent.MAX_RETRY_COUNT)continue;const v=parseEvidenceBlocks(y);for(const e of v){const t=extractReasonAfterEvidence(y,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:A,reason:t,fixHint:RetrievalAgent.parseFixHint(t),coreSummary:e.coreSummary})}if("fix"===this.queryIntent){const e=n.filter((e=>e.annotationRound===A&&/\[UNFOLD-1\]/i.test(e.reason)&&!e.fixHint));if(e.length>0&&B<RetrievalAgent.MAX_RETRY_COUNT){kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_retry] serial round=${A} ${e.length} UNFOLD-1 evidences missing FIX-HINT, retryCount=${B}`),B++;continue}for(const t of e)t.reason+="\n[FIX-HINT] UNCERTAIN - 标注重试后仍未给出修复建议",t.fixHint="UNCERTAIN - 标注重试后仍未给出修复建议",kernel.logger.warn("zulu",`[retrieval_agent][fix_hint_fallback] ${t.file}:${t.scope} retry exhausted, auto-filled UNCERTAIN`)}for(const e of v)for(const[t,r]of this.effectiveBlocksMap.entries())if(r.file===e.file){s.has(t)||s.set(t,[]),s.get(t).push(e.scope);break}const w=RetrievalAgent.parseAnnotationCoverageCheck(y);w?(kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_check] serial round=${A}: coverage_verdict=${w.coverageVerdict}, evidence_precision=${w.evidencePrecision}, alignment=${w.retrievalReasonAlignment}`),"MISALIGNED"===w.retrievalReasonAlignment&&kernel.logger.warn("zulu",`[retrieval_agent][annotation_reason_misaligned] serial round=${A}: ${w.alignmentDetail.substring(0,300)}`),"INCOMPLETE"===w.coverageVerdict&&kernel.logger.warn("zulu",`[retrieval_agent][isCoverageIncomplete] serial round=${A}: ${w.verdictDetail.substring(0,200)}`),"IMPRECISE"===w.evidencePrecision&&kernel.logger.warn("zulu",`[retrieval_agent][isEvidenceImprecise] serial round=${A}: ${w.precisionDetail.substring(0,200)}`)):kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_missing] serial round=${A}: no annotation_coverage_check block found`);const S=v.length>0?v.map(((e,t)=>{const r=n.length-v.length+t+1,i=extractReasonAfterEvidence(y,e);return`- EVIDENCE ${r}: ${e.file} scope="${e.scope}" — ${i||"(无说明)"}`})).join("\n"):"- （本轮未产生有效标注）";i.push(`### 标注轮 ${A}\n${S}`);const _=v.length>0?Math.round(v.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0)/v.length):0;kernel.logger.info("zulu",`[retrieval_agent][summary] Annotation round ${A} completed, output_length=${y.length}, stored_evidence_count=${n.length}, annotation_summary_length=${S.length}, evidence_count_this_round=${v.length}, avg_evidence_lines=${_}`)}}{const t=new Set;for(const[,e]of this.effectiveBlocksMap.entries())"unfold"===e.displayMode&&t.add(e.file);const r=new Set(n.map((e=>e.file))),o=[...t].filter((e=>!r.has(e)));if(0===o.length)kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_ok] All ${t.size} valid_unfold file(s) have EVIDENCE coverage`);else{kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_gap] ${o.length} valid_unfold file(s) missing EVIDENCE: ${o.slice(0,5).join(", ")}`);const t=[];for(const[,e]of this.effectiveBlocksMap.entries())o.includes(e.file)&&e.fullContent&&t.length<4&&t.push(`[代码块] ${e.file}:${e.startLine}-${e.endLine} (${e.reason})\n${e.fullContent.substring(0,4e3)}`);if(t.length>0){const r=3;let s=!1;for(let a=1;a<=r;a++){const l=1===a?4e3:2e3,A=1===a?12e4:6e4,u=t.map((e=>{if(1===a)return e;const t=e.indexOf("\n");return-1===t?e:e.substring(0,t+1)+e.substring(t+1,t+1+l)})),d=RetrievalAgent.ANNOTATION_PHASE_PROMPT+`\n\n## 检索过程概要\n${e}`+`\n\n## 需要补充标注的代码块（之前标注轮未产生EVIDENCE）\n\n以下文件被检索阶段标记为valid_unfold，但标注轮中未生成EVIDENCE，请仔细阅读并标注：\n\n${u.join("\n\n")}`;try{const e=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:c,taskInfo:{description:`Recovery annotation attempt=${a}/${r} for ${o.length} missing file(s): ${o.slice(0,3).join(", ")}`,query:d},signal:this.ctx.signal}),t=[],l=new Token(`annotation-recovery-${Date.now()}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:e,userTurn:this.ctx.userTurn},t,l).executeStream({updatedParams:{taskId:e,agentInfo:c,subAgents:[],query:d,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const u=await Promise.race([l.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("recovery_annotation_timeout"))),A)))]),h=truncateLine(u?.[0]?.output||"",3e4),p=parseEvidenceBlocks(h);if(p.length>0){kernel.logger.info("zulu",`[retrieval_agent][annotation_coverage_ok] Recovery annotation attempt=${a}/${r} produced ${p.length} EVIDENCE(s) for: ${o.join(", ")}`);for(const e of p){const t=extractReasonAfterEvidence(h,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:-1,reason:t,fixHint:RetrievalAgent.parseFixHint(t),coreSummary:e.coreSummary})}i.push(`### 补充标注轮（recovery attempt=${a}）\n${p.map(((e,t)=>`- EVIDENCE ${t+1}: ${e.file} scope="${e.scope}"`)).join("\n")}`),s=!0;break}kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_gap_recovery_failed] attempt=${a}/${r} produced 0 evidences for: ${o.join(", ")}`),a<r&&kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_retry] attempt=${a+1}/${r} files=${o.join(",")} reason=zero_evidence`)}catch(e){const t=String(e).includes("timeout")?"timeout":"error";kernel.logger.warn("zulu",`[retrieval_agent][annotation_coverage_gap_recovery_failed] attempt=${a}/${r} exception: ${String(e).substring(0,200)}`),a<r&&kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_retry] attempt=${a+1}/${r} files=${o.join(",")} reason=${t}`)}}if(!s){const e=n.filter((e=>/\[UNFOLD/i.test(e.reason))).reduce(((e,t)=>e+t.originalMatch.length),0),t=8e3-e;for(const e of o){const i=[...this.effectiveBlocksMap.values()].filter((t=>t.file===e)),o=i.map((e=>`L${e.startLine}-${e.endLine}`)).join(", ")||"未知";if(t>500){const o=i.filter((e=>e.fullContent)).map((e=>`// ${e.file}:${e.startLine}-${e.endLine}\n${e.fullContent}`)).join("\n\n").substring(0,t),s=`[UNFOLD-4] [FALLBACK] recovery 重试 ${r} 次失败，以下为文件原始内容，主 agent 请自行理解相关性`;n.push({file:e,scope:"file",rawText:o,originalMatch:o,annotationRound:-2,reason:s,fixHint:"",coreSummary:""}),kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_fallback] file=${e} budget_mode=unfold remaining_budget=${t} rawText_length=${o.length}`)}else{const i=`[FALLBACK-UNREAD] 文件 ${e}：该文件在检索阶段被标记为关键但未完成精确标注（recovery 重试 ${r} 次失败）。主 agent 请根据检索意图自行判断该文件是否需要修改及修改方式。已知相关行号：${o}`;n.push({file:e,scope:"file",rawText:i,originalMatch:"[fallback-note]",annotationRound:-2,reason:"[FALLBACK-UNREAD] 预算不足，以 note 形式兜底",fixHint:"",coreSummary:""}),kernel.logger.info("zulu",`[retrieval_agent][annotation_recovery_fallback] file=${e} budget_mode=note remaining_budget=${t}`)}}}}}}const A=8e3,u=e=>{const t=e.match(/\[UNFOLD-(\d)\]/i);return t?parseInt(t[1],10):/\[UNFOLD\]/i.test(e)?2:0},d=n.filter((e=>u(e.reason)>0)),h=n.filter((e=>0===u(e.reason))),p=e=>/(?:^|\/)(tests?|__tests?__|spec)\//i.test(e)||/(?:^|\/)test_[\w]+\./i.test(e)||/(?:^|\/)[\w]+_test\./i.test(e);d.sort(((e,t)=>{const r=u(e.reason),n=u(t.reason);if(r!==n)return r-n;const i=p(e.file)?1:0,o=p(t.file)?1:0;return i!==o?i-o:e.originalMatch.length-t.originalMatch.length}));const g=[];let f=d.reduce(((e,t)=>e+t.originalMatch.length),0);for(;f>A&&d.length>0;){const e=d.pop();f-=e.originalMatch.length,g.push(e)}const m=f,E=d.map((e=>`${e.originalMatch}\n${e.reason}`)),C=[...h,...g].map((e=>{let t;if(e.coreSummary){const r=e.coreSummary.split("\n"),n=2e3,i=80;let o=(r.length>i?r.slice(-i):r).join("\n");if(o.length>n){o=o.slice(-n);const e=o.indexOf("\n");-1!==e&&(o=o.slice(e+1))}t=r.length>i||e.coreSummary.length>n?`...（超出预算，已从末尾截取）\n${o}`:o}else{const r=e.rawText.split("\n").filter((e=>e.trim()));t=r.length<=6?r.join("\n"):[...r.slice(0,3),"...",...r.slice(-3)].join("\n")}return`- ${e.file} scope="${e.scope}"\n  \`\`\`\n  ${t}\n  \`\`\`\n  ${e.reason}`})).join("\n\n"),I=E.length>0?E.join("\n\n"):"（无关键证据标记，所有证据以摘要形式提供）",y=C||"（无辅助证据）",B="fix"===this.queryIntent?'\n\n## 修复方向建议（仅修复类 query）\n\n在结论中，你需要：\n1. 描述问题根因和代码定位\n2. 如果证据充分（存在 UNFOLD-1 核心证据且根因明确），给出修复方向建议：\n   - 【修复目标文件】：列出需要修改的文件路径（按优先级排序）\n   - 【修复方向】：对每个目标文件，说明应该做什么修改\n   - 【修复范围约束】：明确指出不需要修改的文件，避免过度修改\n3. 如果证据不充分或根因不确定，明确声明：\n   "当前证据不足以确定修复方案，建议进一步阅读以下文件后判断：[文件列表]"':"\n\n## 理解类结论要求\n\n在结论中，你需要：\n1. 描述目标代码的功能、调用关系和关键逻辑\n2. 回答检索 query 中提出的具体问题\n3. 不需要给出修改建议";let b="";if(t.length>1){const e=new Set(n.filter((e=>/\[UNFOLD-[12]\]/i.test(e.reason))).map((e=>e.file))),t=[];let r=0;const i=8e3;for(const[,n]of this.effectiveBlocksMap.entries())if(e.has(n.file)&&n.fullContent&&"unfold"===n.displayMode){const e=`// ${n.file}:${n.startLine}-${n.endLine}\n\`\`\`\n${n.fullContent}\n\`\`\``;r+e.length<=i&&(t.push(e),r+=e.length)}t.length>0?(b="fix"===this.queryIntent?"## 核心证据原始代码（二次合成用，仅 UNFOLD-1/2 对应文件）\n\n以下为 UNFOLD-1/2 证据对应的完整原始代码（来自各标注批次，供跨批次层次推理）：\n\n"+t.join("\n\n")+"\n\n> **跨批次合成要求**：请综合各批次 FIX-HINT 中的层次分析，对比上方原始代码，判断：\n> 1. 各批次建议的修复位置是否存在层次冲突？\n> 2. 结合完整代码，哪一层实现最合适？\n> 3. 最终综合 FIX-HINT 应覆盖所有 UNFOLD-1/2 证据的统一修复指导\n":"## 核心证据原始代码（总结校验用，仅 UNFOLD-1/2 对应文件）\n\n以下为 UNFOLD-1/2 证据对应的完整原始代码，供总结时对照校验：\n\n"+t.join("\n\n")+"\n\n> **总结校验要求**：请对照上方原始代码，确保总结中引用的函数签名、数据流、调用关系与代码一致，修正标注阶段可能的偏差。\n",kernel.logger.info("zulu",`[fix_c][reinjection] injected=true intent=${this.queryIntent} blocks=${t.length} totalChars=${r}`)):(b="",kernel.logger.info("zulu","[fix_c][reinjection] injected=false reason=no_unfold12_fullContent"))}else kernel.logger.info("zulu","[fix_c][reinjection] injected=false reason=single_batch");const v=RetrievalAgent.SUMMARY_FINAL_PROMPT.replace("{{RETRIEVAL_SUMMARY}}",e).replace("{{ANNOTATION_SUMMARIES}}",i.join("\n\n")).replace("{{CRITICAL_EVIDENCES}}",I).replace("{{UNFOLD_CODE_REINJECTION}}",b).replace("{{FOLD_EVIDENCES}}",y)+B;let w="";try{const e=2e4,t=3e5-v.length-e;if(t>1e4){const e=new Set(b.length>0?Array.from(this.effectiveBlocksMap.values()).filter((e=>"unfold"===e.displayMode&&n.some((t=>t.file===e.file&&/\[UNFOLD-[12]\]/i.test(t.reason))))).map((e=>e.file)):[]),r=Array.from(this.effectiveBlocksMap.entries()).filter((([,t])=>t.fullContent&&t.fullContent.length>0&&!e.has(t.file))).sort((([,e],[,t])=>t.round!==e.round?t.round-e.round:t.reason.length-e.reason.length)),i=[];let o=0;for(const[e,n]of r){const r=`// [${e}] ${n.file}:${n.startLine}-${n.endLine}\n// reason: ${n.reason}\n`,s=r+`\`\`\`\n${n.fullContent}\n\`\`\``,a=t-o;if(a<200)break;const c=s.length<=a?s:r+`\`\`\`\n${n.fullContent.substring(0,a-r.length-10)}\n\`\`\``;i.push(c),o+=c.length}if(i.length>0){const e=o<.9*t;w=`\n\n## 证据完整源码 ${e?`（预算充足，已完整展开全部 ${i.length} 个证据块）`:`（预算有限，已按优先级展开 ${i.length} 个证据块，共 ${o} 字符）`}\n\n> 以下为所有证据块的完整原始代码，请基于真实代码而非仅凭摘要做出修复判断。\n\n`+i.join("\n\n"),kernel.logger.info("zulu",`[fix_f_dynamic_budget] injected=${i.length} blocks, chars=${o}/${t}, full_expand=${e}`)}}else kernel.logger.info("zulu",`[fix_f_dynamic_budget] skipped, remainingBudget=${t} < 10000`)}catch(e){kernel.logger.warn("zulu",`[fix_f_dynamic_budget] error: ${e}`)}const S=w?v+w:v,_=d.filter((e=>1===u(e.reason))).length,Q=d.filter((e=>2===u(e.reason))).length,D=d.filter((e=>3===u(e.reason))).length,x=d.filter((e=>4===u(e.reason))).length,k=new Set(d.map((e=>e.file))).size,R=new Set(n.map((e=>e.file))).size,T=n.filter((e=>-2===e.annotationRound)).length;kernel.logger.info("zulu",`[retrieval_agent][summary] Final summary round, prompt_length=${S.length}, total_stored_evidences=${n.length}(${R} files), unfold_count=${E.length}(P1:${_},P2:${Q},P3:${D},P4:${x}, ${k} files), fold_count=${h.length}, degraded_count=${g.length}, unfold_chars=${m}/${A}, fallback_count=${T}`);const $={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};let N=0,F="",M=!1;for(;!M;)try{this.agentLoop({taskId:this.subtaskId,agentInfo:$,subAgents:[],query:S,isUserQuery:!0});const e=await Promise.race([this.token.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("final_summary_timeout"))),"code"!==this.retrievalType?RetrievalAgent.DOC_SUMMARY_TIMEOUT_MS:RetrievalAgent.PHASE_TIMEOUT_MS)))]);if(F=truncateLine(e[0]?.output||"",3e4),F.trim().length>0&&F.trim().length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&N<RetrievalAgent.MAX_RETRY_COUNT){N++,kernel.logger.warn("zulu",`[retrieval_agent][retry] final summary short_reply (${F.trim().length} chars), retryCount=${N}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}M=!0}catch(e){const t=e instanceof Error?e.message:String(e);if(N<RetrievalAgent.MAX_RETRY_COUNT){N++,kernel.logger.warn("zulu",`[retrieval_agent][retry] final summary attempt failed: ${t.substring(0,200)}, retryCount=${N}/${RetrievalAgent.MAX_RETRY_COUNT}`);continue}kernel.logger.error("zulu",`[retrieval_agent][retry] final summary exhausted retries: ${t.substring(0,200)}`),F="（总结轮超时，以下为标注轮收集的原始证据）",M=!0}const P=RetrievalAgent.parseSummarySelfcheck(F);if(P){const{intentSatisfaction:t,summaryVerdict:r,retrievalEvidenceAlignment:i,reannotationTargets:o}=P;if("MISALIGNED"===i&&kernel.logger.warn("zulu","[retrieval_agent][summary_evidence_misaligned] summary: retrieval_evidence_alignment=MISALIGNED"),"UNSATISFIED"===t&&kernel.logger.warn("zulu","[retrieval_agent][summary_intent_unsatisfied] summary: intent_satisfaction=UNSATISFIED"),"NEEDS_REANNOTATION"===r&&o.length>0){kernel.logger.warn("zulu",`[retrieval_agent][summary_selfcheck_reannotation] summary_verdict=NEEDS_REANNOTATION, re-annotating ${o.length} file(s): ${o.map((e=>e.file)).join(", ")}`);try{const t=[];for(const e of o){const r=[...this.effectiveBlocksMap.values()].find((t=>t.file.includes(e.file)||e.file.includes(t.file)));r?.fullContent&&t.push(`[代码块] ${r.file}:${r.startLine}-${r.endLine}\n重标注原因：${e.reason}\n\n${r.fullContent.substring(0,4e3)}`)}if(t.length>0){const r=RetrievalAgent.ANNOTATION_PHASE_PROMPT+`\n\n## 检索过程概要\n${e}`+`\n\n## 汇总轮要求重新标注的代码块\n以下文件经汇总阶段自检发现标注质量不足，请按给出的重标注原因重新标注：\n\n${t.join("\n\n")}`,i=12e4,s=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:c,taskInfo:{description:`Summary-triggered reannotation for ${o.length} file(s)`,query:r},signal:this.ctx.signal}),a=[],l=new Token(`annotation-reannotation-${Date.now()}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:s,userTurn:this.ctx.userTurn},a,l).executeStream({updatedParams:{taskId:s,agentInfo:c,subAgents:[],query:r,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const A=await Promise.race([l.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("reannotation_timeout"))),i)))]),u=truncateLine(A?.[0]?.output||"",3e4),d=parseEvidenceBlocks(u);if(d.length>0){kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_reannotation] Re-annotation produced ${d.length} EVIDENCE(s), adding to storedEvidences`);for(const e of d){const t=extractReasonAfterEvidence(u,e);n.push({file:e.file,scope:e.scope,rawText:e.rawText,originalMatch:e.originalMatch,annotationRound:-2,reason:t,fixHint:RetrievalAgent.parseFixHint(t),coreSummary:e.coreSummary})}}else kernel.logger.warn("zulu","[retrieval_agent][summary_selfcheck_reannotation] Re-annotation produced 0 evidences")}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][summary_selfcheck_reannotation] Re-annotation exception: ${String(e).substring(0,200)}`)}}else kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_ok] summary_verdict=${r??"null"}, intent=${t??"null"}`);const{typeRisk:s,fixHint4Principles:a,factoryCompleteness:l,layerVerification:A}=P;"TYPE_RISK"===s&&kernel.logger.warn("zulu","[retrieval_agent][summary_type_risk] TYPE_RISK detected in FIX-HINT"),"NEEDS_REVISION"===a&&kernel.logger.warn("zulu","[retrieval_agent][summary_fix_hint_violation] FIX-HINT violates 4-principles, NEEDS_REVISION"),"FACTORY_INCOMPLETE"===l&&kernel.logger.warn("zulu","[retrieval_agent][summary_factory_incomplete] Factory/base class fix may miss sibling factories"),"LAYER_CHECK_REQUIRED"===A&&kernel.logger.warn("zulu","[retrieval_agent][summary_layer_check] FIX-HINT targets call-site assignment, consider fixing at implementation layer"),kernel.logger.info("zulu",`[retrieval_agent][summary_selfcheck_extended] type_risk=${s} fix_hint_4p=${a} factory=${l} layer=${A}`)}else kernel.logger.warn("zulu","[retrieval_agent][summary_selfcheck_missing] No summary_retrieval_selfcheck block found in final summary output");const L=n.length>0?n.map((e=>`${e.originalMatch}\n${e.reason}`)).join("\n\n"):"";if(r=L?`${F}\n\n## 关键证据\n\n${L}`:F,n.length>0){const e=e=>e.rawText.split("\n").filter((e=>e.trim())).length,t=n.filter((e=>/\[UNFOLD-[12]\]/i.test(e.reason))).reduce(((t,r)=>t+e(r)),0),i=n.filter((e=>/\[UNFOLD-[34]\]/i.test(e.reason))).reduce(((t,r)=>t+e(r)),0);if(t>0&&i>3*t){r+=`\n\n⚠️ **BACKGROUND_HEAVY**：背景参考证据（UNFOLD-3/4）代码量（${i} 行）超过核心修复目标（UNFOLD-1/2）代码量（${t} 行）的 3 倍。主 Agent 请注意：修复方案应聚焦于 UNFOLD-1/2 目标，不要照搬参考实现的完整结构，以最小改动实现核心修复。`,kernel.logger.warn("zulu",`[retrieval_agent][background_heavy] core_lines=${t} ref_lines=${i} ratio=${(i/t).toFixed(1)}x`)}}const O=n.reduce(((e,t)=>e+t.rawText.split("\n").filter((e=>e.trim())).length),0);kernel.logger.info("zulu",`[retrieval_agent][summary] Final summary: llm_conclusion_length=${F.length}, stored_evidence_text_length=${L.length}, combined_length=${r.length}, total_evidence_count=${n.length}, total_evidence_lines=${O}`)}kernel.logger.info("zulu",`[retrieval_agent][summary] Summary phase completed, output_length=${r.length}`);const n=0===parseEvidenceBlocks(r).length?await this.synthesizeEvidence(r):r,i=await this.anchorEvidence(n);return this.terminationReason="retrieval_complete",this.logExecutionMetrics(),this.toResult(i.summary,i.evidence)}catch(r){const n=r instanceof Error?r.message:String(r);if(kernel.logger.error("zulu",`[retrieval_agent][summary_retry] Summary phase attempt ${t+1}/${e+1} failed: ${n.substring(0,300)}, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`),t>=e)return kernel.logger.warn("zulu",`[retrieval_agent][summary_fallback] All summary retries exhausted, synthesizing evidence from ${this.effectiveBlocksMap.size} effective blocks`),this.terminationReason="summary_exhausted",this.logExecutionMetrics(),this.synthesizeFromEffectiveBlocks()}}const A=await this.anchorEvidence(n);return this.terminationReason="no_effective_blocks",this.logExecutionMetrics(),this.toResult(A.summary,A.evidence)}catch(e){const t=e instanceof Error?e.message:String(e);if(kernel.logger.error("zulu",`[retrieval_agent][error] execute() top-level catch: ${t}, roundCount=${this.roundCount}, effectiveBlocksMap.size=${this.effectiveBlocksMap.size}`),this.effectiveBlocksMap.size>0)return kernel.logger.info("zulu",`[retrieval_agent][graceful_degradation] Caught "${t}" but ${this.effectiveBlocksMap.size} effective blocks available, synthesizing evidence`),this.terminationReason="unknown"===this.terminationReason?"graceful_degradation":this.terminationReason,this.logExecutionMetrics(),this.synthesizeFromEffectiveBlocks();this.terminationReason="unknown"===this.terminationReason?"error":this.terminationReason,this.logExecutionMetrics();const r=t.includes("[clean_retry_timeout_exhausted]")?"RA retrieval failed due to repeated LLM timeout (clean retry exhausted). Please proceed with independent code retrieval and analysis without relying on RA evidence.":"The retrieval task did not complete successfully.";return this.toResult(r)}}async synthesizeEvidence(e){kernel.logger.info("zulu",`[retrieval_agent][synthesize] LLM 未输出 EVIDENCE 标签，从 effectiveBlocksMap (${this.effectiveBlocksMap.size} 块) 合成`);const t=[];for(const e of Array.from(this.effectiveBlocksMap.values())){const r=this.codeBlockRegistry.get(e.blockId);if(!r?.rawOutput)try{const r=(await readFile$4(e.file,"utf-8")).split("\n"),n=Math.max(0,e.startLine-1),i=Math.min(r.length,e.endLine),o=r.slice(n,i);let s;s=o.length<=30?o.join("\n"):[...o.slice(0,2),"...",...o.slice(-2)].join("\n"),t.push(`<<<EVIDENCE file="${e.file}" scope="${e.reason}" startLine="${e.startLine}" endLine="${e.endLine}">>>\n`+s+"\n<<<END_EVIDENCE>>>")}catch{kernel.logger.warn("zulu",`[retrieval_agent][synthesize] Failed to read ${e.file}, skipping`)}}return 0===t.length?e:(kernel.logger.info("zulu",`[retrieval_agent][synthesize] 合成了 ${t.length} 个 EVIDENCE 块`),e+"\n\n## 关键证据（由系统从已标记的有效代码块自动合成）\n\n"+t.join("\n\n"))}async synthesizeFromEffectiveBlocks(){kernel.logger.info("zulu",`[retrieval_agent][summary_fallback] Synthesizing from ${this.effectiveBlocksMap.size} effective blocks`);const e=[],t=[];for(const[,r]of this.effectiveBlocksMap.entries())try{const n=(await readFile$4(r.file,"utf-8")).split("\n"),i=Math.max(0,r.startLine-1),o=Math.min(n.length,r.endLine),s=n.slice(i,o).join("\n");e.push(`📄 \`${r.file}:${r.startLine}-${r.endLine}\`\n\`\`\`\n${s}\n\`\`\`\n${r.reason}`),t.push({file:r.file,lines:`${r.startLine}-${r.endLine}`,snippet:null,relevance:"medium"})}catch{kernel.logger.warn("zulu",`[retrieval_agent][summary_fallback] Failed to read ${r.file}, skipping`)}const r=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):"（无检索记录）",n=["## 检索结论","（汇总阶段异常中断，以下为检索阶段积累的有效代码块降级输出）","","## 检索过程概要",r,"","## 降级证据",...e].join("\n");return kernel.logger.info("zulu",`[retrieval_agent][summary_fallback] Synthesized ${t.length} evidence blocks`),this.toResult(n,t)}async anchorEvidence(e){try{let t=parseEvidenceBlocks(e);if(0===t.length)return kernel.logger.info("zulu","[retrieval_agent][anchor] No EVIDENCE markers found, returning raw summary"),{summary:e,evidence:[]};kernel.logger.info("zulu",`[retrieval_agent][anchor] Found ${t.length} evidence blocks, starting line anchoring`);const r=new Map;for(const e of t)try{(await stat$i(e.file)).isDirectory()&&r.set(e.file,"路径是目录而非文件")}catch(t){"ENOENT"===t?.code&&r.set(e.file,"文件不存在")}if(r.size>0){kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] ${r.size} evidence blocks have invalid file paths: ${[...r.entries()].map((([e,t])=>`${e} (${t})`)).join(", ")}`);try{const n=t.filter((e=>r.has(e.file))),i=await this.requestAnchorCorrection(n,r);if(i.length>0){for(const o of i){const i=n.find((e=>o.scope&&e.scope&&o.scope===e.scope||o.headLines[0]&&e.headLines[0]&&o.headLines[0]===e.headLines[0]))||n.find((e=>r.has(e.file)));if(i){e=e.replace(i.originalMatch,o.originalMatch);const r=t.indexOf(i);-1!==r&&(t[r]=o),kernel.logger.info("zulu",`[retrieval_agent][anchor][self-correction] Replaced evidence: ${i.file} → ${o.file}`)}}t=parseEvidenceBlocks(e)}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] Correction failed: ${e.message}, continuing with original blocks`)}}const n=async e=>{try{return await readFile$4(e,"utf-8")}catch{return kernel.logger.warn("zulu",`[retrieval_agent][anchor] Failed to read file: ${e}`),""}},i=await anchorLineNumbers(t,n,this.fileReadTracker),o=i.map(((e,t)=>`evidence${t+1}: ${e.file}:${e.startLine}-${e.endLine} (${e.confidence}, ${e.candidates.length} candidates)`)).join("; ");kernel.logger.info("zulu",`[retrieval_agent][anchor] Results: ${o}`);const s=formatFinalReport(e,t,i),a=i.filter((e=>"low"!==e.confidence&&e.startLine>0)).map((e=>({file:e.file,lines:`${e.startLine}-${e.endLine}`,snippet:null,relevance:e.confidence})));return{summary:s,evidence:a}}catch(t){return kernel.logger.error("zulu",`[retrieval_agent][anchor] Post-processing failed: ${t.message}, returning raw summary`),{summary:e,evidence:[]}}}async requestAnchorCorrection(e,t){const r=[];for(const[,e]of this.effectiveBlocksMap.entries())e.file&&!r.includes(e.file)&&r.push(e.file);const n=e.map((e=>{const r=t.get(e.file)||"未知错误";return`${e.originalMatch}\n错误原因: ${r}`})).join("\n\n"),i=`以下 EVIDENCE 块的 file 路径无法访问，需要根据可用文件列表进行修正。\n\n【失败的 EVIDENCE 块】\n${n}\n\n【可用文件路径候选】\n${r.length>0?r.join("\n"):"（无可用文件信息）"}\n\n请仅重新输出修正后的 EVIDENCE 块（格式不变，file 属性使用正确路径），每个块之间用换行分隔。\n不需要输出其他内容。`,o={...this.agentInfo,agentPrompt:"你是一位文件路径纠错专家。根据错误信息和可用文件路径候选列表，修正 EVIDENCE 块中的 file 属性。",tools:[]},s=await createSubagentTaskV2({traceId:this.ctx.traceId,taskId:this.ctx.taskId,agentInfo:o,taskInfo:{description:"anchor-correction",query:i},signal:this.ctx.signal}),a=new Token(`anchor-correction-${Date.now()}`);new AgentExecutor({parameterCollector:this.ctx.parameterCollector,rootPath:this.ctx.rootPath,rootPaths:this.ctx.rootPaths,virtualEditor:this.ctx.virtualEditor,traceId:this.ctx.traceId,conversationId:this.ctx.conversationId,fileConsistencyChecker:this.ctx.fileConsistencyChecker,mcpManager:this.ctx.mcpManager,specEditor:this.ctx.specEditor,signal:this.ctx.signal,taskId:s,userTurn:this.ctx.userTurn},[],a).executeStream({updatedParams:{taskId:s,agentInfo:o,subAgents:[],query:i,isUserQuery:!0},onUpdate:()=>this.ctx.userTurn.updateWebviewMessages()});const c=await Promise.race([a.waitForCompletion(),new Promise(((e,t)=>setTimeout((()=>t(new Error("anchor_correction_timeout"))),6e4)))]),l=truncateLine(c?.[0]?.output||"",3e4);if(kernel.logger.info("zulu",`[retrieval_agent][anchor][self-correction] LLM response length: ${l.length}`),!l)return[];const A=parseEvidenceBlocks(l),u=[];for(const e of A)try{(await stat$i(e.file)).isDirectory()?kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] Corrected path still a directory: ${e.file}`):u.push(e)}catch{kernel.logger.warn("zulu",`[retrieval_agent][anchor][self-correction] Corrected path still invalid: ${e.file}`)}return kernel.logger.info("zulu",`[retrieval_agent][anchor][self-correction] ${u.length}/${A.length} corrected blocks validated`),u}buildEffectiveBlocksSummary(){if(0===this.effectiveBlocksMap.size)return"（无有效代码块）";const e=[];let t=0;for(const[r,n]of this.effectiveBlocksMap.entries()){t++;const i=this.codeBlockRegistry.get(r),o=(i?.snippet||"").split("\n").slice(0,3).map((e=>`  > ${e}`)).join("\n");e.push(`${t}. [${r}] ${n.file}:${n.startLine}-${n.endLine} — ${n.reason}\n${o}`)}return e.join("\n")}async buildEffectiveBlocksContext(){if(this.effectiveBlocksMap.size>0){kernel.logger.info("zulu","[retrieval_agent][summary] using_main_path=true");const e=await this.buildFromEffectiveBlocks();return kernel.logger.info("zulu",`[retrieval_agent][summary] effective_blocks_count=${this.effectiveBlocksMap.size}, effective_context_length=${e.length}`),e}return kernel.logger.info("zulu","[retrieval_agent][summary] using_main_path=false"),this.buildFromTracker()}async buildFromEffectiveBlocks(){const e=[];let t=0;for(const r of Array.from(this.effectiveBlocksMap.values())){t++;const n=this.codeBlockRegistry.get(r.blockId);if(n?.rawOutput)e.push(`[信息块${t}] ${r.blockId} — ${r.reason}\n\`\`\`\n`+n.rawOutput+"\n```");else try{const n=(await readFile$4(r.file,"utf-8")).split("\n"),i=Math.max(0,r.startLine-1),o=Math.min(n.length,r.endLine),s=n.slice(i,o);let a;a=s.length<=1500?s.join("\n"):[...s.slice(0,30),`... (省略 ${s.length-60} 行) ...`,...s.slice(-30)].join("\n");const c=`${r.startLine}-${r.endLine}`;e.push(`[代码块${t}] ${r.file}:${c} (${r.reason})\n\`\`\`\n`+a+"\n```")}catch{const n=`${r.startLine}-${r.endLine}`;e.push(`[代码块${t}] ${r.file}:${n}\n（文件读取失败，请从对话历史中引用）`)}}return e.length>0?e.join("\n\n"):"（无有效代码块）"}async buildFromTracker(){const e=this.fileReadTracker.getAllReadFiles();if(0===e.size)return"（无已读文件记录）";const t=[];let r=0;for(const[n,i]of Array.from(e)){const e=this.mergeRanges(i);for(const i of e){const e=i.endLine-i.startLine>500?i.startLine+300:i.endLine;r++;try{const o=(await readFile$4(n,"utf-8")).split("\n"),s=Math.max(0,i.startLine-1),a=Math.min(o.length,e),c=o.slice(s,a);let l;l=c.length<=1500?c.join("\n"):[...c.slice(0,30),`... (省略 ${c.length-60} 行) ...`,...c.slice(-30)].join("\n"),t.push(`[代码块${r}] ${n}:${i.startLine}-${e}\n\`\`\`\n`+l+"\n```")}catch{t.push(`[代码块${r}] ${n}:${i.startLine}-${e}\n（文件读取失败，请从对话历史中引用）`)}}}return t.length>0?t.join("\n\n"):"（无有效代码块）"}async buildFromEffectiveBlocksBatched(){const e=1500,t=[];for(const r of Array.from(this.effectiveBlocksMap.values())){const n=this.codeBlockRegistry.get(r.blockId);if(n?.rawOutput){const e=n.rawOutput.split("\n").length,i=`[信息块] ${r.blockId} — ${r.reason}\n\`\`\`\n${n.rawOutput}\n\`\`\``;t.push({block:r,content:i,lineCount:e,registryEntry:n})}else try{const i=(await readFile$4(r.file,"utf-8")).split("\n"),o=Math.max(0,r.startLine-1),s=Math.min(i.length,r.endLine),a=i.slice(o,s),c=a.length;if(c>e)for(let i=0;i<c;i+=e){const o=Math.min(i+e,c),s=a.slice(i,o),l=r.startLine+i,A=`${l}-${r.startLine+o-1}`,u=0===i?"":" (续)",d=s.join("\n"),h=`[代码块${u}] ${r.file}:${A} (${r.reason})\n\`\`\`\n${d}\n\`\`\``;t.push({block:r,content:h,lineCount:s.length,registryEntry:n})}else{const e=`${r.startLine}-${r.endLine}`,i=a.join("\n"),o=`[代码块] ${r.file}:${e} (${r.reason})\n\`\`\`\n${i}\n\`\`\``;t.push({block:r,content:o,lineCount:c,registryEntry:n})}}catch{const e=`${r.startLine}-${r.endLine}`,n=`[代码块] ${r.file}:${e}\n（文件读取失败，请从对话历史中引用）`;t.push({block:r,content:n,lineCount:2})}}const r=new Map;for(const e of t){const t=e.block.file;r.has(t)||r.set(t,[]),r.get(t).push(e)}for(const e of r.values())e.sort(((e,t)=>e.block.startLine-t.block.startLine));const n=Array.from(r.entries()).map((([e,t])=>({filePath:e,blocks:t,totalLines:t.reduce(((e,t)=>e+t.lineCount),0)}))).sort(((e,t)=>e.totalLines-t.totalLines)),i=[];for(const e of n)i.push(...e.blocks);const o=i.reduce(((e,t)=>e+t.lineCount),0);if(o<=e){const e=i.map((e=>e.content)).join("\n\n");return[{blocks:e,totalLines:o,blockCount:i.length}]}const s=[];let a=[],c=0;const l=Math.ceil(o/e);let A=this.maxSummaryRounds;l>this.maxSummaryRounds&&l<=2*this.maxSummaryRounds?(A=2*this.maxSummaryRounds,kernel.logger.info("zulu",`[retrieval_agent][batching] expanding summary rounds from ${this.maxSummaryRounds} to ${A} (required=${l})`)):l>2*this.maxSummaryRounds&&(A=2*this.maxSummaryRounds,kernel.logger.info("zulu",`[retrieval_agent][batching] capping summary rounds at ${A}, will use Plan C for overflow (required=${l})`));const u=Math.max(1,A-1);for(const t of n)if(c+t.totalLines<=e||0===a.length)a.push(...t.blocks),c+=t.totalLines;else if(s.push({blocks:a.map((e=>e.content)).join("\n\n"),totalLines:c,blockCount:a.length}),a=[...t.blocks],c=t.totalLines,s.length>=u)break;a.length>0&&s.push({blocks:a.map((e=>e.content)).join("\n\n"),totalLines:c,blockCount:a.length});const d=s.reduce(((e,t)=>e+t.blockCount),0);if(d<i.length){const e=i.slice(d),t=[];let r=0;for(const n of e){const e=await this.truncateBlockPlanC(n.block);t.push(e),r+=Math.min(n.lineCount,60)}if(kernel.logger.info("zulu",`[retrieval_agent][batching] Plan C overflow: ${e.length} blocks truncated`),s.length>0){const n=s[s.length-1];n.blocks+="\n\n"+t.join("\n\n"),n.totalLines+=r,n.blockCount+=e.length}else s.push({blocks:t.join("\n\n"),totalLines:r,blockCount:e.length})}return kernel.logger.info("zulu",`[retrieval_agent][batching] total_blocks=${i.length} total_lines=${o} batches=${s.length} file_groups=${n.length} effectiveMaxRounds=${A}`),s}async truncateBlockPlanC(e){try{const t=(await readFile$4(e.file,"utf-8")).split("\n"),r=Math.max(0,e.startLine-1),n=Math.min(t.length,e.endLine),i=t.slice(r,n),o=i.length<=60?i.join("\n"):[...i.slice(0,30),`... (省略 ${i.length-60} 行，因轮次预算不足使用截断展示) ...`,...i.slice(-30)].join("\n"),s=`${e.startLine}-${e.endLine}`;return`[代码块·截断] ${e.file}:${s} (${e.reason})\n\`\`\`\n${o}\n\`\`\``}catch{const t=`${e.startLine}-${e.endLine}`;return`[代码块·截断] ${e.file}:${t}\n（文件读取失败）`}}mergeRanges(e){if(e.length<=1)return[...e];const t=[...e].sort(((e,t)=>e.startLine-t.startLine)),r=[t[0]];for(let e=1;e<t.length;e++){const n=r[r.length-1];t[e].startLine<=n.endLine+1?n.endLine=Math.max(n.endLine,t[e].endLine):r.push({...t[e]})}return r}truncateFullContent(e,t=8e3){if(e.length<=t)return e;const r=Math.floor(t/2);return e.substring(0,r)+"\n...(truncated)...\n"+e.substring(e.length-r)}encodeToolReturns(e,t){const r=[];let n=0;const i=()=>{if(n<26)return`R${t}-${String.fromCharCode(65+n++)}`;const e=n++;return`R${t}-${String.fromCharCode(65+Math.floor((e-26)/26))}${String.fromCharCode(65+e%26)}`},o=e=>e.length>100?e.substring(0,100)+"...":e,s=e=>e.length<=10?e.map(o).join("\n"):[...e.slice(0,3).map(o),"...",...e.slice(-3).map(o)].join("\n");for(const n of e||[]){const e=n.metadata?.tool;if(!e||"executed"!==e.toolState)continue;const o=e.name,a=n.output||"";if(!a.trim())continue;const c=r.length;try{if("read_file"===o||"extract_content_blocks"===o){const n=e.toolHandler?.params?.path||e.toolHandler?.params?.target_file||e.toolHandler?.params?.file_path||"";if(!n){kernel.logger.warn("zulu",`[retrieval_agent][encoding] ${o} missing file path`);continue}const c=[],l=[],A=/^\s*(\d+)(?:→|->)(.*)$/gm;let u;for(;null!==(u=A.exec(a));)c.push(parseInt(u[1],10)),l.push(u[2]);c.length>0&&r.push({id:i(),file:n,startLine:Math.min(...c),endLine:Math.max(...c),toolName:o,snippet:s(l),round:t,fullContent:this.truncateFullContent(l.join("\n"))})}else if("grep_content"===o||"search_files"===o){let e=!1;if(a.includes("<file>")&&/\d+(?:→|->)/.test(a)){const n=/<file>(.*?)(?:\n|$)([\s\S]*?)(?=<\/file>|<file>|$)/g;let l;for(;null!==(l=n.exec(a));){const e=l[1].trim(),n=l[2]||"";if(!e)continue;const a=[],c=[],A=/^\s*(\d+)(?:→|->)(.*)$/gm;let u;for(;null!==(u=A.exec(n));)a.push(parseInt(u[1],10)),c.push(u[2]);a.length>0&&r.push({id:i(),file:e,startLine:Math.min(...a),endLine:Math.max(...a),toolName:o,snippet:s(c),round:t,fullContent:this.truncateFullContent(c.join("\n"))})}e=r.length>c}if(!e&&a.includes("Line ")&&!/no\s+match/i.test(a)){const e=new Map;let n="";for(const t of a.split("\n")){const r=/^(\/[^:]+):\s*$/.exec(t.trim());if(r){n=r[1],e.has(n)||e.set(n,{lines:[],contents:[]});continue}const i=/^\s*Line\s+(\d+):\s*(.*)$/.exec(t);if(i&&n){const t=e.get(n);t.lines.push(parseInt(i[1],10)),t.contents.push(i[2])}}for(const[n,a]of Array.from(e))a.lines.length>0&&r.push({id:i(),file:n,startLine:Math.min(...a.lines),endLine:Math.max(...a.lines),toolName:o,snippet:s(a.contents),round:t,fullContent:this.truncateFullContent(a.contents.join("\n"))})}}else if("codebase_search"===o){const e=/\u{1F4C4}\s*`?([^`\n:]+?)(?::(\d+)[-\u2013](\d+))?`?\s*\n```[^\n]*\n([\s\S]*?)```/gu;let n;for(;null!==(n=e.exec(a));){const e=n[1].trim(),a=n[2]?parseInt(n[2],10):1,c=n[3]?parseInt(n[3],10):a,l=n[4].trim().split("\n");r.push({id:i(),file:e,startLine:a,endLine:c,toolName:o,snippet:s(l),round:t,fullContent:this.truncateFullContent(l.join("\n"))})}if(r.length===c&&a.includes("Line ")&&!/no\s+match/i.test(a)){const e=new Map;let n="";for(const t of a.split("\n")){const r=/^(\/[^:]+):\s*$/.exec(t.trim());if(r){n=r[1],e.has(n)||e.set(n,{lines:[],contents:[]});continue}const i=/^\s*Line\s+(\d+):\s*(.*)$/.exec(t);if(i&&n){const t=e.get(n);t.lines.push(parseInt(i[1],10)),t.contents.push(i[2])}}for(const[n,a]of Array.from(e))a.lines.length>0&&r.push({id:i(),file:n,startLine:Math.min(...a.lines),endLine:Math.max(...a.lines),toolName:o,snippet:s(a.contents),round:t,fullContent:this.truncateFullContent(a.contents.join("\n"))})}}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][encoding] Failed to encode ${o} output: ${e.message}`)}if(r.length===c){const e=a.trim().split("\n");r.push({id:i(),file:`[${o}]`,startLine:0,endLine:0,toolName:o,snippet:s(e),round:t,rawOutput:a.trim()})}}for(const e of r)this.codeBlockRegistry.set(e.id,e);const a=r.map((e=>`${e.id}(${e.file}:${e.startLine}-${e.endLine})`)).join(", ");return kernel.logger.info("zulu",`[retrieval_agent][encoding] round=${t} encoded=${r.length} blocks: ${a}`),r}parseEffectiveBlocks(e,t){let r=0,n=0,i=!1;const o=/<effective_blocks>([\s\S]*?)<\/effective_blocks>/g;let s;for(;null!==(s=o.exec(e));){i=!0;const e=s[1],o=new Map,a=/<reason\s+id="([^"]+)">([\s\S]*?)<\/reason>/g;let c;for(;null!==(c=a.exec(e));)o.set(c[1],c[2].trim());const l=/^-\s*block:\s*"([^"]+)"\s*\|\s*status:\s*"(valid_unfold|valid_fold|valid|invalid|remove)"(?:\s*\|\s*reason:\s*"([^"]*)")?/gm;let A;for(;null!==(A=l.exec(e));){const e=A[1],i=A[2],s=o.get(e)||A[3]||"";if("invalid"===i||"remove"===i){if(this.blockLockedAsValid.has(e)){kernel.logger.info("zulu",`[retrieval_agent][flip_guard] block=${e} locked as valid_fold, ignoring invalid declaration`);const t=this.codeBlockRegistry.get(e);t&&s&&this.invalidBlockReasons.set(e,{file:t.file,lines:`${t.startLine}-${t.endLine}`,reason:s});continue}if(this.effectiveBlocksMap.has(e)){const t=(this.blockFlipCount.get(e)??0)+1;if(this.blockFlipCount.set(e,t),t>=2){const r=this.effectiveBlocksMap.get(e);this.effectiveBlocksMap.set(e,{...r,displayMode:"fold"}),this.blockLockedAsValid.add(e),this.blockUnfoldSince.delete(e),kernel.logger.info("zulu",`[retrieval_agent][flip_guard] block=${e} flip_count=${t}, locked as valid_fold (evidence preserved)`);const n=this.codeBlockRegistry.get(e);n&&s&&this.invalidBlockReasons.set(e,{file:n.file,lines:`${n.startLine}-${n.endLine}`,reason:s});continue}this.effectiveBlocksMap.delete(e),this.blockUnfoldSince.delete(e),n++}const t=this.codeBlockRegistry.get(e);t&&s&&this.invalidBlockReasons.set(e,{file:t.file,lines:`${t.startLine}-${t.endLine}`,reason:s});continue}const a=this.codeBlockRegistry.get(e);if(!a){kernel.logger.warn("zulu",`[retrieval_agent][parse] block ID "${e}" not found in registry, skipping`);continue}if(0===a.startLine&&0===a.endLine){kernel.logger.warn("zulu",`[retrieval_agent][parse] block ID "${e}" has 0-0 line range (registry parse failure), skipping`);continue}const c="valid_unfold"===i;let l;if(c&&(l=a.fullContent,l||kernel.logger.warn("zulu",`[retrieval_agent] unfold block ${e} has no fullContent, falling back to snippet`)),this.effectiveBlocksMap.set(e,{blockId:e,file:a.file,startLine:a.startLine,endLine:a.endLine,reason:s,round:t,displayMode:c?"unfold":"fold",fullContent:l}),s){const t=a.endLine-a.startLine,r=t<100?200:t<500?400:t<1500?600:800;s.length>1.5*r?(this.reasonTooLongWarnings.set(e,{limit:r,actual:s.length}),kernel.logger.warn("zulu",`[retrieval_agent][reason_overflow] block=${e} reason=${s.length}chars > ${Math.round(1.5*r)} (1.5x softLimit=${r})`)):this.reasonTooLongWarnings.delete(e)}c?this.blockUnfoldSince.has(e)||this.blockUnfoldSince.set(e,t):this.blockUnfoldSince.delete(e),r++}}return{added:r,removed:n,found:i}}static extractStackTraceFiles(e){const t=new Set,r=[{regex:/File\s+"([^"]+\.py)",\s*line\s+\d+/g,group:1},{regex:/at\s+[\w.$]+\(([A-Za-z][\w]*\.java):(\d+)\)/g,group:1},{regex:/\s([\w/.\\-]+\.go):(\d+)/g,group:1},{regex:/\(?([^\s()]+\.(?:js|ts|jsx|tsx|mjs|cjs)):(\d+)(?::(\d+))?\)?/g,group:1},{regex:/-->\s*([\w/.\\-]+\.rs):(\d+):(\d+)/g,group:1},{regex:/([\w/.\\-]+\.(?:c|cc|cpp|cxx|h|hpp)):(\d+):(\d+)?:?\s*(?:error|warning|note)?/g,group:1},{regex:/^([\w/.\\-]+\.\w+):(\d+):(\d+):\s*(?:error|warning)/gm,group:1},{regex:/^\s+([\w/.\\-]+\.py)\s*$/gm,group:1}],n=[/site-packages/i,/node_modules/i,/vendor\//i,/\/usr\/lib/i,/\/usr\/local\/lib/i,/\.cargo\/registry/i,/\.rustup\//i,/\/go\/pkg\//i,/GOROOT/i,/python\d+\.\d+\//i,/lib\/python/i,/jre\/lib/i,/jdk.*\/lib/i,/\.gradle\//i,/\.m2\/repository/i,/<frozen\s/i,/<builtin>/i,/<anonymous>/i,/<internal\//i];for(const{regex:i,group:o}of r){let r;for(;null!==(r=i.exec(e));){const e=r[o];if(!e)continue;n.some((t=>t.test(e)))||(e.length<3||!e.includes(".")||t.add(e))}}return Array.from(t).slice(0,10)}parseTraceEdges(e,t){let r=0,n=0,i=!1;const o=/<trace_edges>([\s\S]*?)<\/trace_edges>/g;let s;for(;null!==(s=o.exec(e));){i=!0;const e=s[1],o=/^-\s*edge:\s*"new"\s*\|\s*from:\s*"([^"]+)"\s*\|\s*direction:\s*"(callee|caller|override)"\s*\|\s*target:\s*"([^"]+)"\s*\|\s*status:\s*"pending"\s*(?:\|\s*reason:\s*"([^"]*)")?/gm;let a;for(;null!==(a=o.exec(e));){this.traceEdgeCounter++;const e=`TE-${this.traceEdgeCounter}`;this.traceEdgesMap.set(e,{edgeId:e,fromBlockId:a[1],direction:a[2],targetDesc:a[3],status:"pending",reason:a[4]||"",registeredRound:t}),r++}const c=/^-\s*edge:\s*"(TE-\d+)"\s*\|\s*status:\s*"(resolved|not_applicable)"(?:\s*\|\s*resolved_block:\s*"([^"]+)")?(?:\s*\|\s*reason:\s*"([^"]*)")?/gm;let l;for(;null!==(l=c.exec(e));){const e=l[1],r=this.traceEdgesMap.get(e);r&&"pending"===r.status&&(r.status=l[2],r.resolvedBlockId=l[3]||void 0,l[4]&&(r.reason=l[4]),r.resolvedRound=t,n++)}}return{added:r,resolved:n,found:i}}updateBreadthProbes(){const e=new Map;for(const[t,r]of this.effectiveBlocksMap){const n=r.file.lastIndexOf("/"),i=n>=0?r.file.substring(0,n):".";e.has(i)||e.set(i,new Set),e.get(i).add(t)}for(const[t,r]of e)if(r.size>=2)if(this.breadthProbesMap.has(t)){this.breadthProbesMap.get(t).validBlockIds=r}else this.breadthProbeCounter++,this.breadthProbesMap.set(t,{probeId:`BP-${this.breadthProbeCounter}`,directory:t,validBlockIds:r,exploredFiles:new Set,totalFiles:[],siblingDirs:[],siblingExplored:new Set,status:"needs_exploration",reason:`目录下已有 ${r.size} 个 valid 块`,registeredRound:this.roundCount}),kernel.logger.info("zulu",`[retrieval_agent][breadth] Registered probe BP-${this.breadthProbeCounter} for dir="${t}" with ${r.size} valid blocks`)}parseBreadthStatus(e,t){let r=0,n=!1;const i=/<breadth_status>([\s\S]*?)<\/breadth_status>/g;let o;for(;null!==(o=i.exec(e));){n=!0;const e=o[1],t=/^-\s*probe:\s*"(BP-\d+)"\s*\|\s*status:\s*"(explored|not_applicable)"(?:\s*\|\s*reason:\s*"([^"]*)")?/gm;let i;for(;null!==(i=t.exec(e));){const e=i[1];for(const t of this.breadthProbesMap.values())if(t.probeId===e&&"needs_exploration"===t.status){t.status=i[2],i[3]&&(t.reason=i[3]),r++;break}}}return{updated:r,found:n}}parseRoundSummary(e){const t=/<round_summary>([\s\S]*?)<\/round_summary>/.exec(e);if(!t)return"";const r=t[1].trim();return r.length>1500?r.substring(0,1500)+"...":r}parseRoundGaps(e){if(/<round_gaps\s+status="CLEAN"\s*\/>/.test(e))return{status:"CLEAN",files:[]};const t=/<round_gaps\s+status="PENDING">([\s\S]*?)<\/round_gaps>/.exec(e);if(t){const e=[],r=t[1],n=/^\s*-\s+file:\s*"([^"]+)"/gm;let i;for(;null!==(i=n.exec(r));)e.push(i[1].trim());return{status:"PENDING",files:e}}return{status:null,files:[]}}buildToolResultsSummary(e,t){if(!e||0===e.length)return"";const r=[];for(let n=0;n<e.length;n++){const i=e[n],o=i.params?.path||i.params?.target_file||i.params?.file_path||i.params?.query||i.params?.pattern||i.params?.regex||"",s="string"==typeof o&&o.length>80?o.substring(0,80)+"...":o,a=i.success?"成功":"失败";let c="";if(i.success){const e=t.filter((e=>e.toolName===i.name));if(e.length>0){const t=e.map((e=>`[${e.id}] ${e.file}:${e.startLine}-${e.endLine}`)).join(", ");c=`→ 已编码: ${t}`}else c="→ (无编码块)"}else{c=`→ 错误: ${(i.message||"").substring(0,200)}`}r.push(`${n+1}. ${i.name}(${s}): ${a}\n   ${c}`)}let n=r.join("\n");return n.length>3e3&&(n=n.substring(0,2900)+"\n... (工具结果摘要已截断)"),n}detectAndResolveEnoent(e){const t=e.filter((e=>!e.success&&"read_file"===e.name&&/does not exist|ENOENT|no such file/i.test(e.message)));if(0===t.length)return;const r=this.ctx.rootPath;if(!r)return;const{execSync:n}=require("child_process");for(const e of t){const t=e.params?.target_file||e.params?.path||"";if(!t)continue;const i=t.split("/").pop()||"";if(!i||i.length<2)continue;if(this.pathCorrectionHints.has(t))continue;const o=new Set;try{const e=n(`find "${r}" -name "${i}" -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/vendor/*" 2>/dev/null | head -20`,{encoding:"utf-8",timeout:5e3}).trim();if(e)for(const t of e.split("\n")){const e=t.trim();e&&o.add(e)}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][enoent_autocorrect] find(exact) failed for "${i}": ${e.message}`)}if(0===o.size)try{const e=t.split("/").filter(Boolean),s=n(`find "${r}" -path "*/${e.length>=2?e.slice(-2).join("/"):i}" -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null | head -20`,{encoding:"utf-8",timeout:5e3}).trim();if(s)for(const e of s.split("\n")){const t=e.trim();t&&o.add(t)}}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][enoent_autocorrect] find(suffix) failed: ${e.message}`)}const s=[...o].filter((e=>e!==t));s.length>0?(this.pathCorrectionHints.set(t,s),kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} guessed="${t}" → found ${s.length} candidates: ${s.slice(0,5).join(", ")}`)):kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} guessed="${t}" → no candidates found`)}}buildRoundContext(e,t){if(!(0!==this.roundSummaries.length||0!==this.effectiveBlocksMap.size||e&&0!==e.length||t))return"";const r=[],n=this.roundCount+1,i=this.maxRounds-n;if(r.push(`【当前轮次】第 ${n} 轮 / 共 ${this.maxRounds} 轮（剩余 ${i} 轮）`),r.push(""),this.initialQuery){const e=this.initialQuery.length>2e3?this.initialQuery.substring(0,2e3)+"...":this.initialQuery;r.push("【初始检索意图】"),r.push(e),r.push("")}if(t&&(r.push("【上一轮工具调用结果】"),r.push(t),r.push("")),r.push("【检索进度摘要】（由系统从你之前的输出中提取，请基于此继续检索）\n"),this.roundSummaries.length>0&&(r.push("## 历史轮次摘要"),this.roundSummaries.forEach(((e,t)=>{r.push(`轮次${t+1}: ${e}`)})),r.push("")),e&&e.length>0){r.push("## 本轮工具返回代码块编码"),r.push("以下是系统对本轮工具返回的编码（行号由系统精确记录，你只需引用编号选择）：");for(const t of e){r.push(`[${t.id}] ${t.file}:${t.startLine}-${t.endLine} (${t.toolName})`);for(const e of t.snippet.split("\n"))r.push(`  > ${e}`)}r.push("")}if(this.effectiveBlocksMap.size>0){const e=Array.from(this.effectiveBlocksMap.values()),t=e.filter((e=>"unfold"===e.displayMode)),n=e.filter((e=>"unfold"!==e.displayMode));if(t.length>0){const e=16e3;let n=0;const i=t.sort(((e,t)=>t.round-e.round)),o=[],s=[];for(const t of i){const r=t.fullContent?.length||0;t.fullContent&&n+r<=e?(o.push(t),n+=r):s.push(t)}r.push(`## 当前展开的有效代码块（${o.length} 个，可用 status: "valid_fold" 收起释放空间）`);const a=o.filter((e=>{const t=this.blockUnfoldSince.get(e.blockId);return void 0!==t&&this.roundCount-t>=4}));a.length>0&&r.push(`⚠️ 以下块已展开 ≥4 轮：${a.map((e=>e.blockId)).join(", ")}。若核心内容已理解，请及时 valid_fold 收起以避免注意力稀释（超过 5 轮系统将自动收起）。`);for(const e of o)r.push(`[${e.blockId}] ${e.file}:${e.startLine}-${e.endLine} — ${e.reason}`),r.push("```"),r.push(e.fullContent),r.push("```");if(s.length>0){r.push(`（以下 ${s.length} 个展开块因空间限制已自动收起，可 valid_fold 其他块后重新 valid_unfold）`);for(const e of s){const t=this.codeBlockRegistry.get(e.blockId),n=t?.snippet||"";if(r.push(`[${e.blockId}] ${e.file}:${e.startLine}-${e.endLine} — ${e.reason}`),n)for(const e of n.split("\n"))r.push(`  > ${e}`)}}r.push("")}if(n.length>0){r.push(`## 已收起的有效代码块（${n.length} 个，可用 status: "valid_unfold" 展开查看；已读文件无需重新 read_file）`);let e=0;for(const t of n){e++;const n=this.codeBlockRegistry.get(t.blockId),i=this.reasonTooLongWarnings.get(t.blockId),o=i?` ⚠️ [reason过长 ${i.actual}字符，请重写精简至≤${i.limit}字符]`:"";if(t.reason)r.push(`${e}. [${t.blockId}] ${t.file}:${t.startLine}-${t.endLine}${o}`),r.push(`   📋 ${t.reason}`);else{const i=n?.snippet||"";if(r.push(`${e}. [${t.blockId}] ${t.file}:${t.startLine}-${t.endLine} ⚠️ [未写 reason，请在本轮 <effective_blocks> 中补充关键函数名和逻辑结论]`),i){const e=i.split("\n").slice(0,3);for(const t of e)r.push(`  > ${t}`);i.split("\n").length>3&&r.push("  > ...")}}}r.push("")}if(this.foldRereadWarnings.length>0){r.push("## ⚠️ 【重读拦截提醒】"),r.push("以下文件你已读取过并已收起，本轮 read_file 被系统拦截并自动展开。请在 <effective_blocks> 中更新该块的 reason，记录关键函数名和逻辑结论（勿写行号）：");for(const e of this.foldRereadWarnings)r.push(e);r.push(""),this.foldRereadWarnings=[]}try{const e=[];for(const[t,r]of this.readFilesHistory){if(r.length<2)continue;r.length>=3&&!this.exhaustedFiles.has(t)&&(this.exhaustedFiles.add(t),kernel.logger.info("zulu",`[fix_d_repeat_exhausted] file=${t} readCount=${r.length} → exhausted`));const n=Array.from(this.effectiveBlocksMap.values()).some((e=>e.file===t||t.endsWith(e.file)||e.file.endsWith(t)));if(n&&!this.exhaustedFiles.has(t)){const n=t.split("/").slice(-2).join("/");e.push(`- \`${n}\`（已读 ${r.length} 次）`)}}if(e.length>0){r.push("## ⚠️ 【重复读文件提醒】[repeat_read_reminder]"),r.push("以下文件已读取过且 effectiveBlocksMap 中有完整内容，请勿再次 read_file：");for(const t of e)r.push(t);r.push("若需确认文件边界，请改用 run_command："),r.push("  `wc -l {path}` → 确认总行数"),r.push("  `tail -20 {path}` → 查看末尾内容"),r.push("  `head -20 {path}` → 查看开头内容"),r.push("  `cat {path}` → 小文件完整查看（< 100 行）"),r.push("⚠️ 若继续 read_file 该文件，系统将自动替换为上述命令的执行结果。"),r.push("")}}catch{}}else r.push("## 当前尚未标记有效代码块\n");if(this.modeSwitchRound>=0){const e=[".md",".rst",".txt",".adoc"],t=[];for(const[r,n]of this.invalidBlockReasons)e.some((e=>n.file.toLowerCase().endsWith(e)))&&!this.effectiveBlocksMap.has(r)&&t.push([r,n]);if(t.length>0){const e=5,n=20,i=t.slice(0,n),o=t.length<=e?"snippet":"reason";r.push("## 【模式切换重评估】以下文档块在旧证据原则下被标为 invalid，请在新的文档级证据原则下重新判断："),r.push("（你在之前轮次已读取过这些文件，可结合下列标注原因直接判断；若 ≤5 块则附有内容摘要）");for(const[e,t]of i)if(r.push(`- [${e}] ${t.file}:${t.lines} — 旧标注原因: "${t.reason}"`),"snippet"===o){const t=this.codeBlockRegistry.get(e);if(t?.snippet)for(const e of t.snippet.split("\n").slice(0,5))r.push(`  > ${e}`)}t.length>n&&r.push(`（仅展示前 ${n} 条，共 ${t.length} 条）`),r.push("如内容与检索意图直接相关，请在 <effective_blocks> 中标注为 valid_unfold 或 valid_fold。"),r.push(""),kernel.logger.info("zulu",`[RA_MODE_SWITCH_REINJECT] overlooked_doc_blocks=${t.length} injected=${i.length} mode=${o}`)}this.modeSwitchRound=-1}if(this.traceEdgesMap.size>0){const e=Array.from(this.traceEdgesMap.values()),t=e.filter((e=>"pending"===e.status)),n=e.filter((e=>"resolved"===e.status)),i=e.filter((e=>"not_applicable"===e.status));if(r.push(`## 追溯状态（${t.length} 条 pending / ${n.length} 条 resolved / ${i.length} 条 not_applicable）`),t.length>0){r.push("### ⚠️ 待完成追溯"),r.push("| 编号 | 源代码块 | 方向 | 待追溯目标 | 已挂起轮数 |"),r.push("|------|---------|------|-----------|-----------|");const e=t.sort(((e,t)=>e.registeredRound-t.registeredRound)).slice(0,10);for(const t of e){const e=this.roundCount+1-t.registeredRound;r.push(`| ${t.edgeId} | ${t.fromBlockId} | ${t.direction} | ${t.targetDesc} | ${e} 轮 |`)}t.length>10&&r.push(`（还有 ${t.length-10} 条 pending 边未展示）`),r.push(""),r.push("⚠️ 以上追溯任务尚未完成。请优先处理挂起时间最长的边，或显式在 <trace_edges> 中标记为 not_applicable 并说明原因。存在 pending 追溯边时不允许输出 <retrieval_complete/>。"),r.push("")}if(n.length>0){r.push("### ✅ 已完成追溯");for(const e of n.slice(0,8))r.push(`- ${e.edgeId}: ${e.fromBlockId} → ${e.resolvedBlockId||"?"} (${e.direction}) — ${e.reason}`);n.length>8&&r.push(`（还有 ${n.length-8} 条已完成边未展示）`),r.push("")}}const o=Array.from(this.breadthProbesMap.values()).filter((e=>"needs_exploration"===e.status));if(o.length>0){r.push(`## 📁 广度探索提醒（${o.length} 个目录待探索）`);for(const e of o){const t=[...e.validBlockIds].map((e=>{const t=this.effectiveBlocksMap.get(e);if(!t)return e;const r=t.file.lastIndexOf("/");return r>=0?t.file.substring(r+1):t.file})).join(", ");if(r.push(`### ${e.probeId}: \`${e.directory}\``),r.push(`- 已有 valid 块涉及文件: ${t}`),e.totalFiles.length>0){const t=e.totalFiles.filter((t=>!e.exploredFiles.has(t))).map((e=>{const t=e.lastIndexOf("/");return t>=0?e.substring(t+1):e}));r.push(`- 该目录共 ${e.totalFiles.length} 个源码文件，尚有 ${t.length} 个未检查: ${t.slice(0,8).join(", ")}${t.length>8?"...":""}`)}else r.push("- 该目录文件列表未获取，建议使用 glob_path 查看");if(e.siblingDirs.length>0){const t=e.siblingDirs.filter((t=>!e.siblingExplored.has(t))),n=t.map((e=>{const t=e.lastIndexOf("/");return t>=0?e.substring(t+1):e}));n.length>0&&r.push(`- 同级目录中尚未探索: ${n.slice(0,6).join(", ")}`)}r.push("- 请在 <breadth_status> 中标记为 explored（已检查完）或 not_applicable（无需扩展）并说明原因"),r.push("")}r.push("⚠️ 存在 needs_exploration 的广度探测时不允许输出 <retrieval_complete/>。"),r.push("")}if(this.failedToolPaths.size>0){r.push("## ⚠️ 【已失败路径列表（禁止重试）】"),r.push("以下路径在之前的轮次中已确认不存在，不要再次尝试：");for(const e of this.failedToolPaths)r.push(`- ${e}`);r.push("")}if(this.pathCorrectionHints.size>0){r.push("## ⚠️ 【路径纠正提示】"),r.push("以下 read_file 调用因路径不存在而失败，系统已自动查找到可能的正确路径：");for(const[e,t]of this.pathCorrectionHints)if(r.push(`- 猜测路径: \`${e}\`（不存在）`),1===t.length)r.push(`  正确路径: \`${t[0]}\``);else{r.push(`  候选路径（${t.length} 个）:`);for(const e of t.slice(0,5))r.push(`  - \`${e}\``)}r.push("请使用上述正确路径重新读取文件，不要重复使用已知错误的路径。"),r.push("")}if(this.stuckUnreadHints.length>0){r.push("## ⚠️ 【未读目标警告】"),r.push("以下文件你已连续多轮在 <round_gaps> 中标记为 PENDING 但始终未 read_file：");for(const e of this.stuckUnreadHints)r.push(e);r.push("**本轮必须优先对上述文件调用 read_file**，否则会造成证据缺口。"),r.push(""),this.stuckUnreadHints=[]}if(this.pendingReasoningWarning){const e=this.pendingReasoningWarning;r.push("## ⚠️ 【推理链一致性警告】[probe_reasoning_inconsistency]"),r.push(`- ${e.id}：你的推理描述为 "${e.claimed}"，但该 block 在标注时的记录是 "${e.actual}"，两者关键词不重叠。`),r.push("请确认你描述的内容确实来自该 block，而非混淆了其他文件。"),r.push(""),this.pendingReasoningWarning=null}if(n>=this.maxRounds&&(r.push("## ⚠️ 【轮次预算即将耗尽】"),r.push(`这是你的最后一轮工具调用（第 ${n}/${this.maxRounds} 轮）。`),r.push("请在本轮 <round_summary> 中评估当前证据的充分性："),r.push("- 如果你认为已收集到足够证据覆盖检索意图的核心问题，请输出 <retrieval_complete/>"),r.push("- 如果你认为还有重要方向未覆盖（如未追溯调用链、未读取关键文件），请在 round_summary 中明确说明缺失的方向和原因，系统将自动延长检索轮次"),r.push("")),this.expansionHint&&(r.push(this.expansionHint),r.push(""),this.expansionHint=""),"doc"===this.retrievalType||"auto"===this.retrievalType){const e=this.effectiveBlocksMap.size,t=10;if(0===e&&this.roundCount>=2)r.push(""),r.push(`⚠️ **[系统提示：证据标注缺失]** 你已完成 ${this.roundCount} 轮检索，但 effective_blocks 中仍然没有任何 valid 块。这意味着你在读取文件后没有标注证据。请检查：\n1. 你已读取的文件是否包含与检索目标相关的内容？若是，立即在 effective_blocks 中补标 valid_unfold 或 valid_fold。\n2. 如果你读取的文件确实无关，请换方向：尝试 list_dir 探索其他目录，或用 grep_content 搜索更精准的关键词。\n3. **在 effective_blocks 中标注至少 1 个 valid 块之前，禁止输出 <retrieval_complete/>。**`),r.push(""),kernel.logger.warn("zulu",`[retrieval_agent][zero_blocks_warn] doc/auto mode, round=${this.roundCount}, effectiveBlocksMap.size=0, injecting zero-blocks hint`);else if(e>0&&e<t&&this.roundCount>=2&&this.roundCount<this.maxRounds-1){const n=Array.from(this.effectiveBlocksMap.keys()).slice(0,5).join(", "),i=this.effectiveBlocksMap.size>5?"...":"";r.push(""),r.push(`📊 **[系统提示：证据数量偏少]** 当前已收集 ${e} 个 valid 块（涉及文件：${n}${i}）。距目标 ${t} 个证据还有差距，建议在结束前：\n1. 换关键词角度重新 grep_content（如换同义词、换函数名、换模块名）\n2. 探索尚未访问的子目录（用 list_dir 检查是否有遗漏目录）\n3. 检查非 .md 文件（.py/.ts/.cpp 等代码文件可能包含知识性注释和示例）`),r.push(""),kernel.logger.info("zulu",`[retrieval_agent][sparse_blocks_hint] doc/auto mode, round=${this.roundCount}, effectiveBlocksMap.size=${e}, threshold=${t}`)}}if(this.lastProbeConclusion&&(r.push(""),r.push(`## 📊 【上轮探针结论】上轮周期性探针输出：${this.lastProbeConclusion}`),r.push("如有 HYPOTHESIS_REVISED / DIRECTION_RESET，请在本轮延续执行该新方向，不要回退。"),r.push(""),this.lastProbeConclusion=""),this.roundCount%4==0&&this.roundCount>0){const e=this.consecutiveAllFailRounds>=2?`\n   ⚠️ **当前已连续 ${this.consecutiveAllFailRounds} 轮全部失败**：此时必须输出 \`DIRECTION_RESET: [新策略]\`，不允许输出 DIRECTION_OK。`:"";r.push(""),r.push("## 🔍 【周期性自检探针（每4轮触发）】"),r.push(`你已完成 ${this.roundCount} 轮检索，请在本轮 <round_summary> 末尾**额外输出以下三项判断**（必填，不可省略）：`),r.push(""),r.push("**1. 假设验证**（初始假设是否仍然成立？）"),r.push("   - `HYPOTHESIS_CONFIRMED`：最初的分析方向已被证据证实，继续当前策略"),r.push("   - `HYPOTHESIS_REVISED: [新假设描述]`：证据表明初始假设有偏差，已修正为新方向"),r.push("   - `HYPOTHESIS_UNCERTAIN`：目前证据不足以确认假设，需要进一步探索"),r.push(""),r.push("**2. 上游追溯验证**（是否已追溯数据流/调用链到根源？）"),r.push("   - `UPSTREAM_CHECKED`：已向上追溯到数据/调用的根源（定义/初始化/转换层）"),r.push("   - `UPSTREAM_MISSING: [未追溯的来源描述]`：存在尚未追溯的上游来源，需要补充"),r.push(""),r.push("**3. 方向有效性评估**（当前搜索策略是否有效？）"),r.push("   - `DIRECTION_OK`：当前搜索方向正确，继续推进"),r.push(`   - \`DIRECTION_RESET: [新策略描述]\`：当前方向效率低（如多轮未找到有效块），重新定向${e}`),r.push(""),r.push("**4. 依据 blocks 声明**（假设验证类必填）"),r.push("请按如下格式输出推理链和依据 block 列表："),r.push("```"),r.push("REASONING_CHAIN:"),r.push("- 基于 R3-A(fields/__init__.py) 中的导入语句，确认使用了 enums.py 中的 TextChoices 类"),r.push("- 由此读取 R4-B(enums.py)，发现 __str__ 当前返回 Enum 默认格式而非 .value"),r.push("BASIS_BLOCKS: [R3-A(fields/__init__.py), R4-B(enums.py)]"),r.push("```"),r.push("规则："),r.push("1. REASONING_CHAIN 每行必须说明某个 block 在推理中的具体作用，以及它如何指向下一步"),r.push("2. 每个 block 引用格式为 `block编号(文件名末段)`，必须是已标记为 valid 的块"),r.push("3. BASIS_BLOCKS 是 REASONING_CHAIN 中所有引用 block 的汇总列表"),r.push("4. 若为 HYPOTHESIS_REVISED，需额外说明哪个 block 导致了假设修正"),r.push(""),kernel.logger.info("zulu",`[retrieval_agent][periodic_probe] injected probe at round=${this.roundCount}`)}return r.push("## ⚠️ 必须输出"),r.push("- 请阅读本轮工具返回结果后，**必须先输出 <round_summary>** 记录你的思考和结论"),r.push("- ⛔ **round_summary 防幻觉规则**：禁止在 round_summary 中写具体行号、方法签名、代码片段（这些已由 effective_blocks 精确记录）。只记录：搜索策略、分析结论概括、排除方向、下一步计划"),r.push('- **必须再输出 <effective_blocks>** 对本轮每个编码块逐一做 valid_unfold/valid_fold/invalid 判断（如 block: "R3-A"），不要手写文件路径和行号'),r.push(`- ⚡ **目标并行度 ${this.maxParallelism}**：下一轮发起约 ${this.maxParallelism} 个独立工具调用，无依赖的工具同一轮一次性全部发出，禁止每轮只发 1 个`),r.push('- 如果发现之前标记的代码块不相关，用 status: "invalid" 移除'),r.join("\n")}cancel(){this.toolTurns.forEach((e=>e.cancel()))}handleTokenNotification(e){if(kernel.logger.info("zulu",`[retrieval_agent][diag_htn] event.name=${e.name} token_match=${e.token.parent===this.token} round=${this.roundCount}`),e.token.parent===this.token){const t=e.payload;if("completed"===e.name){try{const e=(t||[]).map((e=>{const t=e.metadata?.tool;return t?`${t.name}(${t.toolState})`:"unknown"}));kernel.logger.info("zulu",`[retrieval_agent][diag_payload] round=${this.roundCount} payload_len=${t?.length??0} tools=[${e.join(", ")}]`)}catch(e){}if(t.length>0&&t.every((e=>{const t=e.metadata?.tool;return t&&"executed"!==t.toolState}))){const e=t.map((e=>{const t=e.metadata.tool;return`${t.name}:${JSON.stringify(t.toolHandler?.params||{})}`})).sort().join("|");if(e===this.lastAllFailSignature?this.consecutiveAllFailRounds++:(this.consecutiveAllFailRounds=1,this.lastAllFailSignature=e),kernel.logger.warn("zulu",`[retrieval_agent][loop_breaker] round=${this.roundCount+1} all_tools_failed=true, consecutive=${this.consecutiveAllFailRounds}/${RetrievalAgent.ALL_FAIL_LOOP_THRESHOLD}, signature=${truncateLine(e,200)}`),this.consecutiveAllFailRounds>=RetrievalAgent.ALL_FAIL_LOOP_THRESHOLD){kernel.logger.error("zulu",`[retrieval_agent][loop_breaker] BREAKING dead loop: ${this.consecutiveAllFailRounds} consecutive identical all-fail rounds detected. Forcing summary phase with current evidence.`),this.terminationReason="loop_breaker",this.roundCount+=1;const e=this.buildEffectiveBlocksSummary(),t=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):"（检索因工具调用死循环被中断，无有效检索记录）",r=("code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_PROMPT).replace("{{RETRIEVAL_SUMMARY}}",t).replace("{{EFFECTIVE_BLOCKS}}",e),n=this.toolTurns[this.toolTurns.length-1],i=n?.rollbackMessageId,o={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};return void this.agentLoop({taskId:this.subtaskId,agentInfo:o,subAgents:[],query:r,isUserQuery:!0,toolUseResults:[],rollbackMessageId:i})}}else this.consecutiveAllFailRounds=0,this.lastAllFailSignature="";const e=this.toolTurns[this.toolTurns.length-1],r=e?.toText()?.trim()||"";if(r.length>0&&r.length<RetrievalAgent.MIN_VALID_OUTPUT_LENGTH&&this.retryCount<RetrievalAgent.MAX_RETRY_COUNT){this.retryCount++,kernel.logger.warn("zulu",`[retrieval_agent][retry] round=${this.roundCount+1} short_reply detected (${r.length} chars < ${RetrievalAgent.MIN_VALID_OUTPUT_LENGTH}), retryCount=${this.retryCount}/${RetrievalAgent.MAX_RETRY_COUNT}, re-issuing same round`);let n=[];try{n=this.encodeToolReturns(t,this.roundCount+1)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][retry] Failed to encode tool returns: ${e.message}`)}const i=t?.map((e=>{const t=e.metadata.tool,r="executed"===t.toolState,i=t.name;let o=e.output||"";if(r&&o.length>200){const e=n.filter((e=>e.toolName===i));if(e.length>0){const t=e.map((e=>`[${e.id}] ${e.file}:${e.startLine}-${e.endLine}`)).join("\n");o=`[系统已编码为以下代码块，详见检索进度摘要]\n${t}`}else o=o.substring(0,200)+"... (已压缩)"}return{id:t.toolId,name:t.name,success:r,params:t.toolHandler.params,result:r?o:null,message:o}})),o=this.buildToolResultsSummary(i||[],n),s=this.buildRoundContext(n,o),a=e?.rollbackMessageId;return void this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:[],query:s,isUserQuery:!0,rollbackMessageId:a})}this.retryCount=0,this.roundCount+=1;try{const e=[];for(const[t,r]of this.effectiveBlocksMap)if("unfold"===r.displayMode){const n=this.blockUnfoldSince.get(t)??r.round;this.roundCount-n>=5&&(this.effectiveBlocksMap.set(t,{...r,displayMode:"fold"}),this.blockUnfoldSince.delete(t),e.push(t))}e.length>0&&kernel.logger.info("zulu",`[retrieval_agent][auto_fold] round=${this.roundCount} auto_folded=${e.join(", ")}`)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][auto_fold] failed: ${e.message}`)}try{const e=(t||[]).map((e=>{const t=e.metadata?.tool;return t?{name:t.name,state:t.toolState,outputPreview:truncateLine(e.output||"",120)}:{name:"unknown",state:"unknown",outputPreview:truncateLine(e.output||"",120)}}));kernel.logger.info("zulu",`[retrieval_agent][debug] retrieval_id=${this.combinedSubtaskId} round=${this.roundCount}/${this.maxRounds} tool_round=${JSON.stringify(e)}`);const r=e.filter((e=>"executed"===e.state)).length;kernel.logger.info("zulu",`[retrieval_agent][round_tools] round=${this.roundCount} tool_count=${r}`)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][debug] failed to serialize tool round: ${e.message}`)}try{const e=new Set(["read_file","grep_content","extract_content_blocks"]);for(const r of t||[]){const t=r.metadata?.tool,n=t?.name;t&&e.has(n)&&this.fileReadTracker.trackFromToolResult(n,t.toolHandler?.params||{},r.output||"")}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][tracker] Failed to track file reads: ${e.message}`)}try{const e=[];for(const r of t||[]){const t=r.metadata?.tool;if(t){const r=t.toolHandler?.params||{};e.push(`${t.name}|${r.path||r.target_file||r.target_directory||""}|${r.pattern||""}`)}}const r=e.sort().join(";");this.toolCallSignatures.push(r);const n=this.toolCallSignatures.length;if(n>=3&&r.length>0&&this.toolCallSignatures[n-2]===r&&this.toolCallSignatures[n-3]===r){const e=r.split("|"),t=e[1]||"同一文件",n=e[2]||"同一关键词";this.repetitiveToolHint=`【重复操作警告】你已经连续 3 轮对 ${t} 使用相同的搜索模式（${n}），但始终未找到有效内容。这是严重的效率浪费。你必须立即改变策略：\n1. 换文件：round_summary 中提到的其他候选文件（如其他期刊文件）你还没有读取\n2. 换关键词：当前关键词搜索效果不佳，尝试同义词、英文等变体\n3. 换工具：如果 grep_content 定位不准，改用 read_file 直接读取文件的 Python 相关区域\n4. 换目录：搜索其他目录或子目录\n禁止再对同一文件使用相同搜索模式。`,kernel.logger.warn("zulu",`[retrieval_agent][guard] Repetitive tool call detected: round=${this.roundCount}, signature="${r}", consecutive_count=3. Injecting correction hint.`)}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][sig_track] Failed: ${e.message}`)}let n=[];try{n=this.encodeToolReturns(t,this.roundCount)}catch(e){kernel.logger.error("zulu",`[retrieval_agent][encoding] Failed to encode tool returns: ${e.message}`)}let i=0,o=0,s=!1,a=!1,c=0;try{const e=this.toolTurns[this.toolTurns.length-1];if(e){const t=e.toText()||"";kernel.logger.info("zulu",`[retrieval_agent][debug] round=${this.roundCount} llm_text_preview=${truncateLine(t,500)}`);const r=this.parseEffectiveBlocks(t,this.roundCount);i=r.added,o=r.removed,s=r.found;const n=this.parseTraceEdges(t,this.roundCount);this.updateBreadthProbes();const l=this.parseBreadthStatus(t,this.roundCount),A=Array.from(this.traceEdgesMap.values()).filter((e=>"pending"===e.status)).length,u=Array.from(this.breadthProbesMap.values()).filter((e=>"needs_exploration"===e.status)).length;kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} trace_edges_parsed=${n.found}, te_added=${n.added}, te_resolved=${n.resolved}, te_pending=${A}, te_total=${this.traceEdgesMap.size}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} breadth_probes_total=${this.breadthProbesMap.size}, needs_exploration=${u}, breadth_status_parsed=${l.found}, bp_updated=${l.updated}`);const d=this.parseRoundGaps(t);if("CLEAN"===d.status)this.unreadTargetsMap.clear();else if("PENDING"===d.status){for(const e of d.files){const t=this.unreadTargetsMap.get(e)??0;this.unreadTargetsMap.set(e,t+1)}for(const[e,t]of this.unreadTargetsMap)t>=2&&(this.stuckUnreadHints.push(`- \`${e}\`（已连续 ${t} 轮识别但未 read_file，下轮必须优先读取）`),kernel.logger.warn("zulu",`[retrieval_agent][round_gaps] round=${this.roundCount} stuck_unread=true file=${e} consecutive_rounds=${t}`))}const h="CLEAN"===d.status&&this.effectiveBlocksMap.size<1;kernel.logger.info("zulu",`[retrieval_agent][round_gaps] round=${this.roundCount} round_gaps_parsed=${null!==d.status} gap_status=${d.status??"omitted"} unread_targets=${d.files.length} stuck_unread=${this.stuckUnreadHints.length} gap_clean_fake=${h}`);const p=this.parseRoundSummary(t);if(p){this.roundSummaries.push(p),a=!0,c=p.length;const e=p.match(/(HYPOTHESIS_(?:CONFIRMED|REVISED[^\n]*)|UPSTREAM_(?:CHECKED|MISSING[^\n]*)|DIRECTION_(?:OK|RESET[^\n]*))/g);if(e&&e.length>0){this.lastProbeConclusion=e.map((e=>e.trim())).join(" | "),kernel.logger.info("zulu",`[retrieval_agent][periodic_probe] parsed conclusions: ${this.lastProbeConclusion}`);try{const t=e.some((e=>e.startsWith("HYPOTHESIS_CONFIRMED")));if(t||e.some((e=>e.startsWith("HYPOTHESIS_")))){const e=[],r=p.match(/REASONING_CHAIN:[\s\S]*?(?=BASIS_BLOCKS:|$)/)?.[0]||"",n=p.match(/BASIS_BLOCKS:\s*\[([^\]]*)\]/)?.[1]||"";let i;const o=/\b(R\d+-[A-Z]+)\(([^)]+)\)/g;for(;null!==(i=o.exec(r));)e.push({id:i[1],declaredFile:i[2],inReasoning:!0});const s=/\b(R\d+-[A-Z]+)\(([^)]+)\)/g;for(;null!==(i=s.exec(n));)e.some((e=>e.id===i[1]))||e.push({id:i[1],declaredFile:i[2],inReasoning:!1});const a=[];for(const{id:t,declaredFile:r,inReasoning:n}of e){const e=this.effectiveBlocksMap.get(t);e?e.file.endsWith(r)||e.file.includes(r)||a.push({entry:`${t}(${r})`,reason:"file_mismatch",actual:e.file}):a.push({entry:`${t}(${r})`,reason:n?"reasoning_ref_invalid":"id_not_found"})}const c=r.split("\n").filter((e=>e.trim().startsWith("-")));for(const e of c){const t=e.match(/\b(R\d+-[A-Z]+)\(([^)]+)\)/);if(!t)continue;const r=t[1],n=this.effectiveBlocksMap.get(r);if(!n)continue;const i=new Set(e.toLowerCase().split(/\s+/).filter((e=>e.length>3))),o=new Set(n.reason.toLowerCase().split(/\s+/).filter((e=>e.length>3))),s=[...i].filter((e=>o.has(e))).length;i.size>0&&0===s&&(kernel.logger.warn("zulu",`[probe_reasoning_inconsistency] ${r}: claimed="${e.trim().substring(0,100)}" stored_reason="${n.reason.substring(0,100)}"`),this.pendingReasoningWarning||(this.pendingReasoningWarning={id:r,claimed:e.trim().substring(0,150),actual:n.reason.substring(0,150)}))}if(a.length>0){const e=a.map((e=>"id_not_found"===e.reason||"reasoning_ref_invalid"===e.reason?`- ${e.entry}：该编号不在 effectiveBlocksMap 中，你在推理链中引用了一个从未实际读取的 block。请先 read_file 获取真实编号。`:`- ${e.entry}：编号存在，但实际文件是 ${e.actual}，与声明不符。请核查推理链中对该 block 的描述。`)).join("\n");this.stuckUnreadHints.push(`⚠️ [probe_hallucination] 发现以下幻觉引用，在核查并修正之前不得输出 HYPOTHESIS_CONFIRMED：\n${e}`),this.confirmedCount=0,kernel.logger.warn("zulu",`[probe_hallucination] detected ${a.length} hallucinated refs: ${a.map((e=>e.entry)).join(", ")}`)}else t&&(this.confirmedCount++,kernel.logger.info("zulu",`[probe_confirmed] confirmedCount=${this.confirmedCount}, no hallucination detected`));t&&this.confirmedCount>=2&&this.stuckUnreadHints.push(`[probe_expand] 你的假设已通过 ${this.confirmedCount} 次验证，依据 blocks 均已实际读取。\n为避免遗漏平行路径，请额外检查：\n1. 是否存在多后端/子类 override 路径未覆盖当前修复位置？\n2. 当前假设文件的调用方中，是否有绕过修复位置的快捷路径？\n输出 EXPANSION_DONE: [检查结论] 后继续。`)}}catch(e){kernel.logger.warn("zulu",`[fix_e_hallucination] error: ${e}`)}}}else if(t.trim().length>0){const e=t.trim().length>500?t.trim().substring(0,500)+"...":t.trim();this.roundSummaries.push(e),a=!0,c=e.length,kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} round_summary_fallback=true, used LLM raw text (${e.length} chars)`)}const g=t.match(/<mode_switch>(doc|auto)<\/mode_switch>/);if(g&&"code"===this.retrievalType&&this.modeSwitchCount<1){const e=g[1],r=t.match(/<mode_switch_reason>([\s\S]*?)<\/mode_switch_reason>/),n=r?r[1].trim():"";if(n){const t=this.retrievalType;this.retrievalType=e,this.modeSwitchRound=this.roundCount,this.modeSwitchCount++,kernel.logger.info("zulu",`[RA_MODE_SWITCH] round=${this.roundCount} old=${t} new=${e} reason=${n}`)}else this.roundSummaries.push("【系统消息】模式切换被拒绝：检测到 <mode_switch> 声明但缺少 <mode_switch_reason> 字段，已忽略。如需切换，请在 <mode_switch_reason> 中说明证据分布依据。"),kernel.logger.warn("zulu",`[RA_MODE_SWITCH] round=${this.roundCount} rejected: missing reason`)}}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][debug] Failed to parse effective blocks/round_summary: ${e.message}`)}try{const e=this.toolTurns[this.toolTurns.length-1];if(e){const t=((e.toText()||"").match(/<effective_blocks>/g)||[]).length;if(t>4){let e=0;for(const[t,r]of this.effectiveBlocksMap)"unfold"===r.displayMode&&(this.effectiveBlocksMap.set(t,{...r,displayMode:"fold"}),this.blockUnfoldSince.delete(t),e++);this.roundSummaries.length>0&&(this.roundSummaries[this.roundSummaries.length-1]=`[系统警告] 上轮输出异常冗长（<effective_blocks> 重复 ${t} 次），已自动 fold 全部展开块（${e} 个）。请在本轮重新评估哪些块需要展开，避免重复声明。`),kernel.logger.warn("zulu",`[retrieval_agent][runaway] round=${this.roundCount} repetition_count=${t} force_folded=${e}`)}}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][runaway] detection failed: ${e.message}`)}kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} round_summary_parsed=${a}, summary_length=${c}`),kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} effective_blocks_parsed=${s}, added=${i}, removed=${o}, map_total=${this.effectiveBlocksMap.size}`);try{const e=(t||[]).map((e=>e.metadata?.tool?.name)).filter(Boolean).join(", ");this.retrievalLog.push(`轮次${this.roundCount}: 调用了 ${e}，当前有效代码块 ${this.effectiveBlocksMap.size} 个（新增${i}/移除${o}）`)}catch{}const l=t?.map((e=>{const t=e.metadata.tool,r="executed"===t.toolState,i=t.name;let o=e.output||"";if(r&&o.length>200){const e=n.filter((e=>e.toolName===i));if(e.length>0){const t=e.map((e=>`[${e.id}] ${e.file}:${e.startLine}-${e.endLine}`)).join("\n");o=`[系统已编码为以下代码块，详见检索进度摘要]\n${t}`}else o=o.substring(0,200)+"... (已压缩)"}return{id:t.toolId,name:t.name,success:r,params:t.toolHandler.params,message:o}}));try{for(const e of t||[]){const t=e.metadata?.tool;if(!t||"read_file"!==t.name||"executed"!==t.toolState)continue;const r=t.toolHandler?.params?.target_file||"";if(!r)continue;const n=e.metadata?.endLine,i=e.metadata?.totalLines;null!=n&&null!=i&&n>=i&&(this.exhaustedFiles.add(r),kernel.logger.info("zulu",`[fix_d_fully_read] file=${r} endLine=${n} totalLines=${i} → exhausted`))}}catch{}try{for(const e of l||[]){if(!e.success||"read_file"!==e.name)continue;const t=e.params?.target_file||"";if(!t)continue;const r=e.params?.offset||1,n=e.params?.limit,i=n?r+n-1:Number.MAX_SAFE_INTEGER;for(const[e,n]of this.effectiveBlocksMap){if("fold"!==n.displayMode)continue;if(!(t.endsWith(n.file)||n.file.endsWith(t)||t.includes(n.file)||n.file.includes(t)))continue;const o=Math.max(r,n.startLine),s=Math.min(i,n.endLine);if(s<o)continue;const a=i===Number.MAX_SAFE_INTEGER?n.endLine-n.startLine+1:i-r+1,c=a>0?(s-o+1)/a:0;if(c>=.6){this.effectiveBlocksMap.set(e,{...n,displayMode:"unfold"}),this.blockUnfoldSince.has(e)||this.blockUnfoldSince.set(e,this.roundCount),kernel.logger.info("zulu",`[retrieval_agent][fold_reread_intercept] round=${this.roundCount} block=${e} file=${n.file} overlap=${Math.round(100*c)}% auto-unfolded`),this.foldRereadWarnings.push(`- [${e}] ${n.file}:${n.startLine}-${n.endLine}（第${n.round}轮已读）已自动展开。请在本轮 <effective_blocks> 中更新该块的 reason，补充关键函数名和逻辑结论（语义描述，勿写行号）。`);break}}}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][fold_reread_intercept] failed: ${e.message}`)}try{for(const e of l||[]){if(!e.success||"read_file"!==e.name)continue;const t=e.params?.target_file||"";if(!t)continue;const r=this.readFilesHistory.get(t)||[];r.includes(this.roundCount)||(r.push(this.roundCount),this.readFilesHistory.set(t,r))}for(const e of l||[]){if(!e.success||"grep_content"!==e.name)continue;const t=e.params?.file||"";if(!t)continue;const r=(this.grepFilesHistory.get(t)||0)+1;this.grepFilesHistory.set(t,r),r>=2&&!this.foldRereadWarnings.some((e=>e.includes(t)&&e.includes("grep")))&&(this.foldRereadWarnings.push(`- [grep-upgrade] 已对 \`${t}\` 进行 ${r} 次 grep_content 搜索。grep 片段可能不足以定位精确调用点，建议改用 \`read_file\` 并指定 offset/limit 精确读取目标行范围，避免在大文件中反复搜索。`),kernel.logger.info("zulu",`[retrieval_agent][grep_upgrade_prompt] round=${this.roundCount} file=${t} grep_count=${r}`))}const e=/\b(set_[a-z_]+|clear_[a-z_]+|[a-z_]+_reset\b|[a-z_]+_invalidate\b|invalidate_[a-z_]+|\.cache\b|_cache\b|cache_[a-z_]+|flush_[a-z_]+|expire_[a-z_]+)\s*[\(\=]/i;for(const t of l||[]){if(!t.success||"grep_content"!==t.name)continue;const r=t.message||"";if(!e.test(r))continue;const n=t.params?.file||t.params?.path||"",i=`[side-effect-check]${n}`;this.foldRereadWarnings.some((e=>e.includes(i)))||(this.foldRereadWarnings.push(`- ${i} grep 结果中发现含副作用/缓存操作的函数（如 set_*/clear_*/*_reset/cache_*）。这类函数通常是状态管理的关键路径，**必须 read_file 补充完整上下文**，确认：(1) 该副作用是否是 bug 的真实原因；(2) 是否有其他调用方也受影响。不得仅凭 snippet 直接做结论。`),kernel.logger.info("zulu",`[retrieval_agent][side_effect_check] round=${this.roundCount} file=${n} grep_contains_side_effect`))}for(const[e,t]of this.readFilesHistory){if(t.length<2)continue;const r=Array.from(this.effectiveBlocksMap.values()).some((t=>t.file===e||e.endsWith(t.file)||t.file.endsWith(e)));if(r)continue;const n=t[t.length-1];let i=0;for(const[r,o]of this.codeBlockRegistry)o.round===n&&"read_file"===o.toolName&&(this.effectiveBlocksMap.has(r)||(o.file===e||e.endsWith(o.file)||o.file.endsWith(e))&&(this.effectiveBlocksMap.set(r,{blockId:r,file:o.file,startLine:o.startLine,endLine:o.endLine,reason:`[auto-promote] 该文件已被读取 ${t.length} 次但无有效标注块，系统自动升格为 valid_unfold 以防止遗漏`,round:o.round,displayMode:"unfold",fullContent:o.fullContent}),i++,kernel.logger.info("zulu",`[retrieval_agent][repeat_read_autopromote] round=${this.roundCount} block=${r} file=${e} read_rounds=${t.join(",")} auto-promoted to valid_unfold`)));i>0&&!this.foldRereadWarnings.some((t=>t.includes(e)))&&this.foldRereadWarnings.push(`- [auto-promote] ${e} 已被读取 ${t.length} 次但始终未标注有效块，系统已自动升格最近一次读取的内容为 valid_unfold。请在本轮 <effective_blocks> 中为这些块补充 reason。`)}}catch(e){kernel.logger.error("zulu",`[retrieval_agent][repeat_read_autopromote] failed: ${e.message}`)}if(this.pathCorrectionHints.size>0){const e=new Set((l||[]).filter((e=>e.success&&"read_file"===e.name)).map((e=>e.params?.target_file||e.params?.path||"")).filter(Boolean));for(const[t,r]of this.pathCorrectionHints)r.some((t=>e.has(t)))&&(this.pathCorrectionHints.delete(t),kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} cleared hint for "${t}" (LLM used correct path)`))}try{this.detectAndResolveEnoent(l||[])}catch(e){kernel.logger.error("zulu",`[retrieval_agent][enoent_autocorrect] detectAndResolveEnoent failed: ${e.message}`)}if(this.roundSummaries.length>0){const e=(l||[]).filter((e=>!e.success&&"read_file"===e.name&&/does not exist|ENOENT|no such file/i.test(e.message)));if(e.length>0){const t=e.map((e=>{const t=e.params?.target_file||e.params?.path||"(unknown)",r=this.pathCorrectionHints.get(t);return`read_file("${t}") 路径不存在${r&&r.length>0?`，系统发现正确路径: ${r[0]}`:"，未找到同名文件"}`})).join("；"),r=this.roundSummaries.length-1;this.roundSummaries[r]+=`\n⚠️ 路径猜测失败: ${t}`,kernel.logger.info("zulu",`[retrieval_agent][enoent_autocorrect] round=${this.roundCount} injected ENOENT note into round_summary: ${t}`)}}for(const e of l||[])if(!e.success&&("list_dir"===e.name||"read_file"===e.name)){const t=e.params?.target_directory||e.params?.target_file||e.params?.path||"";t&&this.failedToolPaths.add(t)}let A=!1;try{const e=this.toolTurns[this.toolTurns.length-1];if(e){const t=e.toText()||"";A=/<retrieval_complete\s*\/?>/.test(t),A&&kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} retrieval_complete=true, LLM 主动结束检索，进入汇总阶段`)}}catch{}if(A){const e=this.roundSummaries.length>0?this.roundSummaries[this.roundSummaries.length-1]:"",t=/未确认|未验证|待补充|未探索|未追踪|未读取|缺失|尚未|未能确认|需要进一步/.test(e),r="code"===this.retrievalType?3:6,n=this.effectiveBlocksMap.size<r&&this.roundCount<this.maxRounds-1;let i=!1;if(("doc"===this.retrievalType||"auto"===this.retrievalType)&&this.ctx.rootPath)try{const e=readdirSync$1(this.ctx.rootPath).filter((e=>{try{return statSync$2(`${this.ctx.rootPath}/${e}`).isDirectory()}catch{return!1}}));let t=1;if(1===e.length){const r=`${this.ctx.rootPath}/${e[0]}`;let n=0;try{n=readdirSync$1(r).filter((e=>!e.startsWith("."))).length}catch{}const o=new Set;for(const t of this.effectiveBlocksMap.values()){const r=t.file.split("/");r[0]===e[0]&&r.length>=2&&o.add(r[1])}t=n>0?o.size/n:1,i=t<.3}else if(e.length>1){const r=new Set;for(const[e]of this.effectiveBlocksMap){const t=e.split("/")[0];t&&r.add(t)}t=r.size/e.length,i=t<.6}kernel.logger.info("zulu",`[retrieval_agent][guard] broadness check: mode=${this.retrievalType}, topDirs=${e.length}, coveredRatio=${t.toFixed(2)}, broadnessDeficit=${i}`)}catch(e){kernel.logger.warn("zulu",`[retrieval_agent][guard] broadness check failed: ${e.message}`)}(t||n||i)&&(A=!1,kernel.logger.warn("zulu",`[retrieval_agent][guard] Premature complete blocked in handleTokenNotification: mode=${this.retrievalType}, round=${this.roundCount}/${this.maxRounds}, effectiveBlocks=${this.effectiveBlocksMap.size}, sparseThreshold=${r}, hasGaps=${t}, sparseEvidence=${n}, broadnessDeficit=${i}. Forcing continued retrieval.`))}let u=!1;const d=Math.floor(.7*this.originalMaxRounds);if(!A&&this.roundCount>=d&&!this.roundsExpanded){const e=this.roundSummaries.length>0?this.roundSummaries[this.roundSummaries.length-1]:"";/未覆盖|缺失|需要继续|不充分|还有.*方向|未追溯|未读取|不够|需补充|需进一步|待探索|待执行/.test(e)&&(u=!0,this.maxRounds=2*this.originalMaxRounds,this.roundsExpanded=!0,this.expansionHint=`【轮次扩容通知】检索轮次已从 ${this.originalMaxRounds} 扩展至 ${this.maxRounds} 轮。你还有 ${this.maxRounds-this.roundCount-1} 轮余量。请重新规划剩余检索策略：回顾 round_summary 中的待处理项，按优先级依次完成，不要急于结束。`,kernel.logger.info("zulu",`[retrieval_agent][adaptive] round=${this.roundCount} detected insufficient evidence signals, expanding maxRounds from ${this.originalMaxRounds} to ${this.maxRounds}`))}if(this.roundCount>=this.maxRounds-1&&!u||A){this.terminationReason=A?"retrieval_complete":"max_rounds";const e=l?.map((e=>({...e,message:"[已编码，详见汇总指令中的有效代码块]"}))),t=this.buildEffectiveBlocksSummary(),r=this.roundSummaries.length>0?this.roundSummaries.map(((e,t)=>`轮次${t+1}: ${e}`)).join("\n"):this.retrievalLog.join("\n")||"（无检索记录）",n=("code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_PROMPT).replace("{{RETRIEVAL_SUMMARY}}",r).replace("{{EFFECTIVE_BLOCKS}}",t);kernel.logger.info("zulu",`[retrieval_agent][summary] Injecting summary prompt, ${this.retrievalLog.length} rounds logged, effective summary length=${t.length}`);const i=this.toolTurns[this.toolTurns.length-1],o=i?.rollbackMessageId,s={...this.agentInfo,agentPrompt:"code"===this.retrievalType?RetrievalAgent.SUMMARY_PHASE_SYSTEM_PROMPT:RetrievalAgent.DOC_SUMMARY_PHASE_SYSTEM_PROMPT,tools:[]};this.agentLoop({taskId:this.subtaskId,agentInfo:s,subAgents:[],query:n,isUserQuery:!0,toolUseResults:e,rollbackMessageId:o})}else{const e=this.buildRoundContext(n),t=this.toolTurns[this.toolTurns.length-1],r=t?.rollbackMessageId;kernel.logger.info("zulu",`[retrieval_agent][round_context] round=${this.roundCount} stateless_mode=true, context_length=${e.length}, rollbackId=${r||"none"}, toolUseResults_count=${(l||[]).length}`),e.length>0?this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:l||[],query:e,isUserQuery:!0,rollbackMessageId:r}):this.agentLoop({taskId:this.subtaskId,agentInfo:this.agentInfo,subAgents:[],toolUseResults:l})}}}}}function createHandler(e,t,r,n){const i=n??e;switch(getCanonicalToolName(e)){case"list_dir":return new ListDir(t,r,i);case"delete_file":return new DeleteFile(t,r,i);case"edit_file":return new EditFile(t,r,i);case"write_file":return new WriteFile(t,r,i);case"grep_content":return new GrepContent(t,r,i);case"glob_path":return new GlobPath(t,r,i);case"delegate_subtask":return new DelegateSubtask(t,r,i);case"todo_write":return new TodoWrite(t,r,i);case"run_command":return new RunCommand(t,r,i);case"read_file":return new ReadFile(t,r,i);case"codebase_search":return new CodebaseSearch(t,r,i);case"web_search":return new WebSearch(t,r,i);case"web_fetch":return new WebFetch(t,r,i);case"update_memory":return new UpdateMemory(t,r,i);case"use_mcp_tool":return new McpTool(t,r,i);case"read_lints":return new ReadLints(t,r,i);case"skill":return new Skill(t,r,i);case"compress_message":return new CompressMessage(t,r,i);case"ask_user_question":return new AskUserQuestion(t,r);case"create_plan":return new CreatePlan(t,r);case"doc_read":return new DocRead(t,r,i);case"doc_list":return new DocList(t,r,i);case"doc_search":return new DocSearch(t,r,i);case"automation_browser":return new AutomationBrowser(t,r,i);case"stop_task":return new StopTask(t,r,i);case"task_complete":return new TaskComplete(t,r,i);case"retrieval_agent":return new RetrievalAgent(t,r,i);default:return new UnknownHandler("unknown",t,r,i)}}class Tool{token;ctx;acceptState="accepted";handler;toolState="pending";constructor(e,t){this.token=e,this.ctx=t,this.handler=new UnknownHandler("unknown",this.ctx,new Token("unknown")),e.onNotify?.((e=>{e.name}))}get result(){return this.handler.result}get state(){return this.token.state}get name(){return this.handler.name}get toolId(){return this.token.id}get accepted(){return"accepted"===this.acceptState}get rejected(){return"rejected"===this.acceptState}get toolHandler(){return this.handler}get isSubtask(){return this.handler instanceof DelegateSubtask}get rollbackActionName(){return this.handler instanceof DeleteFile?"willCreate":null===this.handler.result?.metadata?.originalContent?"willDelete":"willChange"}get isTouchFileHandler(){return this.handler instanceof WriteFile||this.handler instanceof EditFile||this.handler instanceof DeleteFile||this.handler instanceof UpdateMemory||this.handler instanceof CreatePlan}initialized=!1;static createHandlerTokenId(e){return`handler-${e}`}match(e){return this.toolId===e}async mergeParams(e,t){this.handler.onUpdateParams({...this.handler.params,...t}),this.normalizeHandlerFromParams(e)}async appendParamContent(e,t){const r=this.handler.params;for(const[e,n]of Object.entries(t??{})){const t=r[e]??"";"string"==typeof t&&"string"==typeof n&&(r[e]=t+n)}this.handler.onUpdateParams(r),this.normalizeHandlerFromParams(e)}update(e,t,r){if(!this.initialized){this.initialized=!0;const t=this.token.fork(Tool.createHandlerTokenId(this.toolId));this.handler=createHandler(e,this.ctx,t,e),t.onNotify((e=>{"completed"===e.name&&(this.handler.result=e.payload?.result??this.handler.result)}))}"FUNCTION_CALL_PARAMS_APPEND"===t||"FUNCTION_CALL_END"===t?this.appendParamContent(e,r):"FUNCTION_CALL_PARAMS_MERGE"===t&&this.mergeParams(e,r)}normalizeHandlerFromParams(e){const t=getCanonicalToolName(this.name),r=getCanonicalToolName(e),n=this.handler.params?.command;if("string"!=typeof n)return;const i=extractAutomationBrowserCommand(n);if(i&&"run_command"===t){const e=this.handler.token;return this.handler=createHandler("automation_browser",this.ctx,e,"automation_browser"),void this.handler.onUpdateParams({command:i})}"automation_browser"!==t&&"automation_browser"!==r||null!==i&&i!==n&&this.handler.onUpdateParams({command:i})}error;async execute(){try{this.toolState="beforeExecute";const e=await hookService.triggerHook(HookEvent.PreToolUse,{...hookService.buildCommonInput(this.ctx.traceId,{sessionId:this.ctx.conversationId,taskId:this.ctx.taskId}),hook_event_name:HookEvent.PreToolUse,tool_name:this.name,tool_input:this.handler.params??{},tool_use_id:this.toolId},this.name);if("deny"===e.decision){const t=e.reason||"Blocked by hook";this.handler.result.output=t;const r=[buildHookSystemReminder(e.hookSource,t)];throw e.additionalContext&&r.push(buildAdditionalContextReminder(e.hookSource,e.additionalContext)),this.handler.result.metadata.hookSystemReminder=r.filter(Boolean).join("\n"),new ToolSkipExecuteError(t)}if(!1===e.continue){const t=e.stopReason||"Execution stopped by hook";this.handler.result.output=t;const r=[buildHookSystemReminder(e.hookSource,t)];throw e.additionalContext&&r.push(buildAdditionalContextReminder(e.hookSource,e.additionalContext)),this.handler.result.metadata.hookSystemReminder=r.filter(Boolean).join("\n"),kernel.connect.sendWebviewMessage(PT_WEBVIEW_HOOK_BLOCKED,{hookEventName:"executionStopped",message:t}).catch((()=>{})),new HookStopExecutionError(t)}const t=await this.handler.beforeExecute();if(t?.substituteHandler){const{name:e,params:r}=t.substituteHandler;this.handler=createHandler(e,this.ctx,this.handler.token,e),this.handler.onUpdateParams(r),await this.handler.beforeExecute()}this.onDidExecute(t),this.toolState="executing",await this.handler.execute(this.ctx),this.toolState="executed";const r=await this.firePostToolUse();this.attachHookReminder(r),this.token.complete(this.result)}catch(e){if(e instanceof ToolValidationError||e instanceof ToolExecuteError){this.toolState="failed";const t=await this.firePostToolUseFailure(this.result.output,e instanceof ToolValidationError?"validation":"error");return this.attachHookReminder(t),void this.token.fail(this.result.output)}if(e instanceof ToolSkipExecuteError){this.toolState="skipped";const e=await this.firePostToolUseFailure(this.result.output,"skipped");return this.attachHookReminder(e),void this.token.fail(this.result.output)}if(e instanceof HookStopExecutionError){this.toolState="hook_stopped";const e=await this.firePostToolUseFailure(this.result.output,"skipped");return this.attachHookReminder(e),void this.token.fail(this.result.output)}if(e instanceof SubtaskInterruptError)return this.handler.result=e.toolResult,void("cancelled"!==this.toolState&&(this.toolState="failed",this.token.fail(e.toolResult.output)));const t=e instanceof Error?e.message:"string"==typeof e?e:"Unknown error";this.handler.result.output=t,this.toolState="failed";const r=await this.firePostToolUseFailure(t,"error");this.attachHookReminder(r),this.token.fail(t)}finally{await this.handler.afterExecute()}}complete(e){this.token.complete(e)}fail(e){this.token.fail(e)}onDidExecute(e){this.token.onDidExecute(e,this)}toMessage(){const e={id:this.token.id,type:"TOOL",toolName:this.name,params:this.handler.params,toolState:this.toolState,error:this.error,result:this.result};return this.handler instanceof DelegateSubtask&&(e.children=this.handler.toolTurns.map((e=>e.toMessage()))),this.isTouchFileHandler&&(e.accepted=this.accepted),e}async accept(){this.acceptState="accepted"}async reject(){this.acceptState="rejected"}static rebuild(e,t,r){const n=Token.createSnapshotToken(e.id,r),i=new Tool(n,t);i.initialized=!0;const o=getCanonicalToolName(e.toolName);if(i.handler=createHandler(o,t,Token.createSnapshotToken(Tool.createHandlerTokenId(e.id),n),e.toolName),i.handler.rebuildResult(e.result??{output:"",metadata:{}}),i.update(e.toolName,"FUNCTION_CALL_PARAMS_MERGE",e.params),i.toolState="executed"===e.toolState||"failed"===e.toolState?e.toolState:"cancelled","delegate_subtask"===o){const r=e.children.map((e=>ToolTurn.rebuild(e,t,n)));i.toolHandler.push(...r)}return i}toText(){return`\`\`\`${this.name}\n${JSON.stringify(this.handler.params)}\n\`\`\``}cancel(){"executed"!==this.toolState&&"failed"!==this.toolState&&(this.isSubtask&&this.handler.result.output||(this.handler.result.output=ToolError.common.execution_aborted),this.handler.result.metadata.success=!1,this.toolState="cancelled","function"==typeof this.handler.cancel&&this.handler.cancel())}async firePostToolUse(){try{return await hookService.triggerHook(HookEvent.PostToolUse,{...hookService.buildCommonInput(this.ctx.traceId,{sessionId:this.ctx.conversationId,taskId:this.ctx.taskId}),hook_event_name:HookEvent.PostToolUse,tool_name:this.name,tool_input:this.handler.params??{},tool_use_id:this.toolId,tool_response:this.result?.output??""},this.name)}catch{return{decision:"allow"}}}async firePostToolUseFailure(e,t){try{return await hookService.triggerHook(HookEvent.PostToolUseFailure,{...hookService.buildCommonInput(this.ctx.traceId,{sessionId:this.ctx.conversationId,taskId:this.ctx.taskId}),hook_event_name:HookEvent.PostToolUseFailure,tool_name:this.name,tool_input:this.handler.params??{},tool_use_id:this.toolId,error:e,failure_type:t},this.name)}catch{return{decision:"allow"}}}attachHookReminder(e){if(this.handler.result.metadata.hookSystemReminder)return;const t=e.additionalContext;t&&(this.handler.result.metadata.hookSystemReminder=buildAdditionalContextReminder(e.hookSource,t))}}function buildHookSystemReminder(e,t){if(!e)return;const r="command"===e.type?`from command. "${e.command}"`:`from url: "${e.url}"`,n=e.matcher||"*";return`<system-reminder>\n${e.event}: ${n} hook blocking error ${r}: ${t}\n</system-reminder>`}function buildAdditionalContextReminder(e,t){return`<system-reminder>\n${e?.event||"hook"} hook additional context: ${t}\n</system-reminder>`}class Element{text;end;id=randomUUID();lastModifiedTime=Date.now();startTime=Date.now();constructor(e,t){this.text=e,this.end=t}updateText(e,t){this.end||(this.lastModifiedTime=Date.now(),this.end=t,this.text=(this.text+e).replace(/^(\r?\n)+/,""))}cancel(){this.end=!0}toText(){return this.text}toMessage(){return{id:this.id,type:"TEXT"}}}class Text extends Element{toMessage(){return{...super.toMessage(),end:this.end,content:this.text,type:"TEXT"}}}class Thinking extends Element{toMessage(){return{...super.toMessage(),end:this.end,content:this.text,startTime:this.startTime,lastModifiedTime:this.lastModifiedTime,type:"REASON"}}}class Exception extends Element{toMessage(){return{...super.toMessage(),content:this.text,type:"EXCEPTION"}}}class ToolTurn{rollbackMessageId;token;ctx;discard=!1;elements=[];preExecuteHook;constructor(e,t,r){this.rollbackMessageId=e,this.token=t,this.ctx=r,this.token.onNotify?.((e=>{"cancel"===e.name&&this.tools.forEach((e=>{e.cancel()}))}))}get tools(){return this.elements.filter((e=>e instanceof Tool))}get acceptedFsTools(){return this.executedFsTools.filter((e=>e.accepted))}get executedFsTools(){return this.tools.reduce(((e,t)=>"delegate_subtask"===t.name?(t.toolHandler.toolTurns.map((t=>e.push(...t.acceptedFsTools))),e):(t.isTouchFileHandler&&"executed"===t.toolState&&e.push(t),e)),[])}static createTokenId(e){return`turn-${e}`}getToolById(e){const t=this.tools.find((t=>t.toolId===e));if(!t){const t=this.token.fork(e),r=new Tool(t,this.ctx);return this.elements.push(r),r}return t}getToolsByAbosultePath(e){return this.tools.filter((e=>e.isTouchFileHandler)).filter((t=>"executed"===t.toolState&&t.result?.metadata?.absolutePath===e))}isText(e){return e instanceof Text}isThinking(e){return e instanceof Thinking}isException(e){return e instanceof Exception}async replaceFilePathInText(){const e=this.elements.find(this.isText);if(e){const t=await replaceFilePathInCodeSpan(e.text,Array.from(this.ctx.parameterCollector.touchedAbsolutePaths));e.text=t}}updateText(e,t){const r=this.elements[this.elements.length-1];if(this.isText(r))r.updateText(e,t);else if(!(r instanceof Tool)&&e.length){const r=new Text(e,t);this.elements.push(r)}}updateThinking(e,t){const r=this.elements[0];if(this.isThinking(r))r.updateText(e,t);else if(!this.elements.length&&e.length){const r=new Thinking(e,t);this.elements.push(r)}}updateException(e){const t=this.elements[this.elements.length-1];if(this.isException(t))t.updateText(e,!0);else{const t=new Exception(e,!0);this.elements.push(t)}}async cancel(e){"string"==typeof e&&e.length&&this.updateException(e),await Promise.all(this.elements.map((e=>e.cancel()))),await this.replaceFilePathInText()}getCompressionTool(){const e=this.tools[this.tools.length-1];if("compress_message"===e?.name&&"pending"===e.toolState)return e;const t=this.token.fork(randomUUID()),r=new Tool(t,this.ctx);return this.elements.push(r),r}match(e){return this.rollbackMessageId===e}push(...e){for(const t of e){this.getToolById(t.toolId)||this.elements.push(t);const e=this.token.fork(t.toolId),r=new Tool(e,this.ctx);this.elements.push(r)}}toMessage(){return{id:this.rollbackMessageId,discard:this.discard,children:this.elements.filter((e=>!(e instanceof Tool&&e.toolHandler instanceof UnknownHandler))).map((e=>e.toMessage()))}}async waitForAllToolCompletion(){if(this.tools.every((e=>e.isSubtask)))await Promise.all(this.tools.map((e=>e.execute())));else for(const e of this.tools){if(this.preExecuteHook){if(await this.preExecuteHook(e))continue}if(await e.execute(),"hook_stopped"===e.toolState)break}if(this.elements.forEach((e=>{e instanceof Tool||e.cancel()})),await this.replaceFilePathInText(),0===this.tools.length){const e=this.elements.find(this.isText)?.text||"";this.token.break([{output:e,metadata:{}}])}else this.token.complete(this.tools.map((e=>({...e.result,metadata:{...e.result,tool:e}}))))}static rebuild(e,t,r){const n=Token.createSnapshotToken(ToolTurn.createTokenId(e.id),r),i=new ToolTurn(e.id,n,t);i.discard=!!e.discard;for(const r of e.children)if("REASON"===r.type)i.updateThinking(r.content,!0);else if("TEXT"===r.type)i.updateText(r.content,!0);else if("EXCEPTION"===r.type)i.cancel(r.content);else{const e=Tool.rebuild(r,t,n);i.elements.push(e)}return i}toText(){return this.elements.map((e=>e.toText())).join("\n\n")}static omitUnnecessaryFields(e){const t=e.children;return{...e,children:t.map((e=>{if("TOOL"===e.type){const t=getCanonicalToolName(e.toolName);return"delegate_subtask"===t?{..._$H.omit(e,"result.output"),toolName:t,children:e.children?.map((e=>({...e,children:e.children?.map((e=>{const t=_$H.omit(e,"result.output","result.metadata.originalContent","result.metadata.content");return"TOOL"===e.type?{...t,toolName:getCanonicalToolName(e.toolName)}:t}))})))}:{..._$H.omit(e,"result.output","result.metadata.originalContent","result.metadata.content"),toolName:t}}return e}))}}}const{findLast:findLast}=_$H;var RoundtripStatus;!function(e){e.Failed="failed",e.Completed="completed",e.Cancelled="cancelled",e.Analyzing="analyzing",e.Generating="generating",e.Compressing="compressing"}(RoundtripStatus||(RoundtripStatus={}));const isToolCallMessage=e=>e instanceof ToolCallMessage,isTextMessage=e=>e instanceof TextMessage;class Roundtrip{conversationId;repo;logger;virtualEditor;updateWebviewMessages;editToolCount=0;v2=!1;disabledRollback=!1;foreground=!1;newAddedMessages=[];multiSuggestions=[];responses=[];status=RoundtripStatus.Analyzing;uuid;request;assistantMessageContent={};context={};reportedId="";systemNotificationService;toolTurns=[];quotaExceedMessage="";appliedRules=[];static extractPayloadFromSnapshot(e){return{...e.payload,id:e.id,query:e.payload?.query??""}}constructor(e,t,r,n,i,o){this.conversationId=e,this.repo=t,this.logger=r,this.virtualEditor=n,this.updateWebviewMessages=i;const s=this.virtualEditor.getActiveDocument();this.request=new UserRequestMessage(o.id,o,s),this.uuid=crypto$8.randomUUID(),this.systemNotificationService=SystemNotificationService.getInstance(),this.systemNotificationService.setVirtualEditor(n),this.updateNotificationConfig(),kernel.config.onDidChangeConfig("enableNotification",(()=>{this.updateNotificationConfig()}))}updateNotificationConfig(){const e=kernel.config.enableNotification??!0;this.systemNotificationService.setEnabled(e)}get inProgress(){return this.status===RoundtripStatus.Generating||this.status===RoundtripStatus.Analyzing}get textMessages(){return this.responses.filter((e=>e instanceof TextMessage))}get toolCallMessages(){return this.responses.filter((e=>e instanceof ToolCallMessage&&!e.discard))}discardMessagesAfterRetryMessageId(e){const t=this.responses.findIndex((t=>t.retryMessageId===e));for(const[e,r]of this.responses.entries())e>t&&(r.discard=!0)}discard=!1;appendTextResponse(e,t,r=""){if(!this.inProgress||!e)return;const n=t?.replace?"replaceText":"appendText",i=this.getLatestProgressTextMessage();if(i)return void i[n](e);const o=this.createNewTextMessage();r&&(o.parentMessageId=r),o[n](e)}async appendReasonResponse(e,t,r,n=""){if(this.status!==RoundtripStatus.Generating)return;if(!t&&r){const t=this.getLatestReasonMessage(e);return void(t&&t.inProgress&&(t.end(),this.updateWebviewMessages()))}if(!t)return;const i=this.getLatestReasonMessage(e);if(i)return void(i.inProgress&&(i.appendText(t),r&&i.end(),this.updateWebviewMessages()));const o=new ReasonMessage(e,"",Date.now(),Date.now());n&&(o.parentMessageId=n),this.addNewMessage(o),o.appendText(t),this.updateWebviewMessages()}async appendTodoResponse(e,t,r,n=""){if(this.status!==RoundtripStatus.Generating)return;let i=new TodoMessage(e);if(n&&(i.parentMessageId=n),r){const r=this.getLatestTodoMessage(e);r||this.addNewMessage(i),i=r||i,await i.update(t)}else this.addNewMessage(i);this.updateWebviewMessages()}async appendToolCallResponse(e,t){if(this.status!==RoundtripStatus.Generating)return;const{eventType:r,...n}=e,i=this.getLatestProgressToolCallMessage();switch(r){case"TOOL_CALL_END":i?.startWorkflow();break;case"TOOL_CALL_START":await this.createNewToolCallMessage(n,t);break;case"TOOL_CALL_ABORT":i?.abort();break;case"TOOL_CALL_CREATE":(await this.createNewToolCallMessage(n,t)).startWorkflow();break;case"TOOL_CALL_PARAMS_MERGE":await(i?.mergeParams(e.params));break;case"TOOL_CALL_PARAMS_APPEND":await(i?.appendParamContent(e.params))}}async appendNotificationResponse(e,t){this.status===RoundtripStatus.Generating&&"compression"===e.detail.type&&await this.handleCompressionNotification(e.detail,t)}setAssistantMessageContent(e){this.assistantMessageContent=e}getLatestMessage(){return this.responses[this.responses.length-1]}getLatestToolCallMessage(){const e=this.getLatestMessage();return e instanceof ToolCallMessage?e:void 0}getLastToolTurnTools(){for(let e=this.toolTurns.length-1;e>=0;e--){const t=this.toolTurns[e];if(!t.discard)return t.tools}return[]}getAllToolTurnTools(){return this.toolTurns.filter((e=>!e.discard)).flatMap((e=>e.tools))}findTool(e){return this.getAllToolTurnTools().find((t=>t.toolId===e))}toMessages(){const e=[],t={...this.request.toMessage(),discard:!!this.discard,context:this.context,disabledRollback:!!this.disabledRollback,appliedRules:this.appliedRules.map((({content:e,...t})=>t))};!this.request.payload.query&&!this.request.payload.selfDefineInstruction||e.push(t);const r=this.request.payload.agent;let n=[];n=this.v2?this.toolTurns.map((e=>e.toMessage())):this.responses.filter((e=>!e.discard)).map((e=>e.toMessage()));const i={id:this.uuid,v2:!!this.toolTurns.length,quotaExceedMessage:this.quotaExceedMessage,discard:!!this.discard,userMessageId:this.request.uuid,reportedId:this.reportedId,agentInfo:r?{avatar:r.agentImage,name:r.agentName}:void 0,role:"assistant",status:this.roundtripStatus2MessageStatus(),tokenUsage:this.tokenUsage,content:this.assistantMessageContent,elements:n};return e.push(i),e}roundtripStatus2MessageStatus(){switch(this.status){case RoundtripStatus.Analyzing:case RoundtripStatus.Generating:return AgentMessageStatus.InProgress;case RoundtripStatus.Compressing:return AgentMessageStatus.Compressing;case RoundtripStatus.Completed:return AgentMessageStatus.Success;case RoundtripStatus.Cancelled:return AgentMessageStatus.Cancelled;case RoundtripStatus.Failed:return AgentMessageStatus.Failed}}toJSON(){return{payload:this.request.payload,elements:this.responses.map((e=>e.toJSON()))}}rebuildV2(e,t,r){const n=(e.elements??[]).map((e=>ToolTurn.rebuild(e,t,r)));this.toolTurns.push(...n),this.discard=!!e.discard,this.status=e.status===RoundtripStatus.Completed||e.status===RoundtripStatus.Failed?e.status:RoundtripStatus.Cancelled}rebuild(e){const t=e.elements??[];for(const e of t)if(e.type===MessageType.Text){const t=TextMessage.createFromSnapshot(this.conversationId,this.virtualEditor,this.repo,this.logger,e);this.responses.push(t)}else if(e.type===MessageType.ToolCall){const t=ToolCallMessage.createFromSnapshot(this.conversationId,this.virtualEditor,this.repo,this.logger,e,(()=>this.updateWebviewMessages()),this.uuid);this.responses.push(t)}else if(e.type===MessageType.REASON){const t=ReasonMessage.createFromSnapshot(e);t.status="success"===e.status?e.status:AgentMessageStatus.Cancelled,this.responses.push(t)}else if(e.type===MessageType.TODO){const t=TodoMessage.createFromSnapshot(e);this.responses.push(t)}this.status=e.status===RoundtripStatus.Completed||e.status===RoundtripStatus.Failed?e.status:RoundtripStatus.Cancelled,this.setAssistantMessageContent(e.content??{}),this.editToolCount=this.responses.filter((e=>e instanceof ToolCallMessage&&EDIT_WORKFLOW_TYPES.has(e.toMessage().toolName))).length}complete(){this.ensureAllMessageFinished(!0),this.status===RoundtripStatus.Generating&&(this.status=RoundtripStatus.Completed,this.notifyTaskDone("success")),this.updateWebviewMessages()}cancel(){this.status!==RoundtripStatus.Generating&&this.status!==RoundtripStatus.Analyzing||(this.status=RoundtripStatus.Cancelled);for(const e of this.responses)e.cancel();this.newAddedMessages=[]}fail(e){const t=this.getLatestMessage();e&&this.appendErrorMessage(e,t?.parentMessageId);for(const e of this.responses)e.fail();this.ensureAllMessageFinished(!1),this.status!==RoundtripStatus.Generating&&this.status!==RoundtripStatus.Analyzing||(this.status=RoundtripStatus.Failed,this.notifyTaskDone("failed")),this.updateWebviewMessages()}quotaTip(e){const t=this.getLatestMessage();e&&this.appendErrorMessage(e,t?.parentMessageId),this.updateWebviewMessages()}resolveNewAddedMessages(){this.ensureToolCallMessageWorkflowStarted(),this.updateWebviewMessages({forceUpdate:!0});const e=this.newAddedMessages;return this.newAddedMessages=[],e}getComposerTasks(e){const t=e?this.responses.filter((e=>e instanceof ToolCallMessage&&!e.discard)).filter((t=>t.uuid===e)):this.responses.filter((e=>e instanceof ToolCallMessage&&!e.discard));return t.map((e=>e.composer.tasks.filter((e=>e.completed)))).flat()}getTextMessage(e){if(e)return this.textMessages.find((t=>t.uuid===e))}getToolCallMessage(e){if(e)return this.toolCallMessages.find((t=>t.uuid===e))}setForeground(e){this.foreground=e,this.textMessages.forEach((t=>t.composer.setForeground(e))),this.toolCallMessages.forEach((t=>t.workflow.setForeground(e)))}ensurePreviousMessageWorkflowStarted(){const e=this.getLatestProgressToolCallMessage();e&&e.workflow.isInitializing&&(e.workflow.markStartedWithIncompleteParams(),e.startWorkflow())}async updateTextMessageComposerStatus(){for(const e of this.textMessages)await e.updateComposerStatus()}updateWebSearchResult(e){const t=_$H.findLast(this.responses,(e=>e instanceof ToolCallMessage&&"web_search"===e.workflow.type&&e.workflow.status===WorkflowStatus.RUNNING));if(t){t.workflow.update(e),t.end()}}setNewAddMessageParentMessageId(e){this.newAddedMessages.forEach((t=>{t.parentMessageId=e}))}getLatestProgressTextMessage(){const e=this.getLatestMessage();return e instanceof TextMessage&&e.inProgress?e:void 0}getLatestReasonMessage(e){return findLast(this.responses,(t=>t instanceof ReasonMessage&&t.id===e))}getLatestTodoMessage(e){return findLast(this.responses,(t=>t instanceof TodoMessage&&t.id===e))}getLatestProgressToolCallMessage(){const e=this.getLatestMessage();return e instanceof ToolCallMessage&&e.inProgress?e:void 0}addNewMessage(e){this.ensurePreviousMessageWorkflowStarted(),this.responses.push(e),this.newAddedMessages.push(e)}async createNewToolCallMessage(e,t){const{name:r,params:n,...i}=e;r&&EDIT_WORKFLOW_TYPES.has(r)&&this.editToolCount++;const o={...t,messageId:this.uuid,repo:this.repo,virtualEditor:this.virtualEditor,conversationId:this.conversationId,updateWebviewMessages:e=>this.updateWebviewMessages(e)},s=new ToolCallMessage(this.conversationId,this.repo,this.logger,this.virtualEditor,o,r,n,i);return n&&await s.workflow.setParams(n),s.workflow.setForeground(this.foreground),this.addNewMessage(s),s}createNewTextMessage(){const e=new TextMessage(this.conversationId,this.virtualEditor,this.repo,this.logger);return e.composer.setForeground(this.foreground),this.addNewMessage(e),e}ensureToolCallMessageWorkflowStarted(){for(const e of this.responses)e instanceof ToolCallMessage&&e.workflow.isInitializing&&(e.workflow.markStartedWithIncompleteParams(),e.startWorkflow())}ensureAllMessageFinished(e){for(const t of this.responses)t instanceof TextMessage?(t.composer.tasks.forEach((e=>!0!==e.finish&&e.cancel())),t.inProgress&&t.markStatus(e?AgentMessageStatus.Success:AgentMessageStatus.Failed)):t instanceof ToolCallMessage?(t.composer.tasks.forEach((e=>!0!==e.finish&&e.cancel())),t.workflow instanceof WebSearchWorkflow||(t.workflow.cancel(),t.inProgress&&t.markStatus(e?AgentMessageStatus.Success:AgentMessageStatus.Failed))):t instanceof ReasonMessage&&t.inProgress&&t.markStatus(e?AgentMessageStatus.Success:AgentMessageStatus.Failed)}appendErrorMessage(e,t=""){const r=new TextMessage(this.conversationId,this.virtualEditor,this.repo,this.logger);t&&(r.parentMessageId=t),r.composer.setForeground(this.foreground),r.isErrorMessage=!0,this.responses.push(r),r.originalContent=e,r.content=e,r.end()}async updateAcceptSuggestions(e){const t=this.toolCallMessages.filter((e=>e.composer.tasks[0]instanceof EditComposerTask&&e.composer.tasks[0].completed)),r={};for(const e of t){const t=e.composer.tasks[0];r[t.key]={filePath:t.key,originalContent:r[t.key]?.originalContent||t.originalContent||"",modifiedContent:t.content,accepted:t.accepted===AcceptState.ACCEPT}}const n=this.textMessages,i=[],o=Object.values(r).length;for(const t of n){const r=t.content,n=await extractCodeBlocks$1(r);n.length&&i.push(...n.map((({lang:t,content:r},n)=>({id:String(o+i.length+n),lang:t,path:e.path||this.request.activeDocumentPath||"agent.java",row:"1",col:"1",isCodeBlock:!0,generatedContent:codeBlock2TrimedGenerateLines(r),accepted:!1}))))}return this.multiSuggestions=Object.values(r).map((({filePath:e,accepted:t,originalContent:r,modifiedContent:n},i)=>{const o=createPatch(e,r,n).split(/\n/).slice(4).filter((e=>e.startsWith("+")||e.startsWith("-"))).join("\n");return{id:String(i),path:e,row:"1",col:"1",generatedContent:o,accepted:t}})).concat(i),this.logger.info(`[Zulu] reported ${this.multiSuggestions.length} suggestions successfully`),{suggestions:this.multiSuggestions,changes:r}}async updateAcceptSuggestionsV2(e){const t=_$H.flatten(this.toolTurns.map((e=>e.executedFsTools))),r={};for(const e of t){const t=e.result.metadata.absolutePath,n=e.result.metadata.originalContent,i=e.result.metadata.content;t&&(r[t]={filePath:t,originalContent:r[t]?.originalContent||n||"",modifiedContent:i,accepted:e.accepted})}const n=this.textMessages,i=[],o=Object.values(r).length;for(const t of n){const r=t.content,n=await extractCodeBlocks$1(r);n.length&&i.push(...n.map((({lang:t,content:r},n)=>({id:String(o+i.length+n),lang:t,path:e.path||this.request.activeDocumentPath||"agent.java",row:"1",col:"1",isCodeBlock:!0,generatedContent:codeBlock2TrimedGenerateLines(r),accepted:!1}))))}return this.multiSuggestions=Object.values(r).map((({filePath:e,accepted:t,originalContent:r,modifiedContent:n},i)=>{const o=createPatch(e,r,n).split(/\n/).slice(4).filter((e=>e.startsWith("+")||e.startsWith("-"))).join("\n");return{id:String(i),path:e,row:"1",col:"1",generatedContent:o,accepted:t}})).concat(i),this.logger.info(`[Zulu] reported ${this.multiSuggestions.length} suggestions successfully`),{suggestions:this.multiSuggestions,changes:r}}removeLineStartWithPrefix(e,t,r){const n=[];let i=0;for(;i<e.length;)r>0&&e[i].startsWith(t)?r--:n.push(e[i]),i++;return n}popLatestResponse(){const e=this.responses.pop();e instanceof ToolCallMessage&&EDIT_WORKFLOW_TYPES.has(e.toMessage().toolName)&&this.editToolCount--,this.responses.at(-1)instanceof ReasonMessage&&this.responses.pop()}updateSuggestionsByPath(e,t,r){return this.multiSuggestions=this.multiSuggestions.map((n=>{if(isFilePathEqual(n.path,e)&&!n.isCodeBlock){if(r){const e=n.generatedContent.split(/\n/),t=this.removeLineStartWithPrefix(this.removeLineStartWithPrefix(e,"+",r.addLines),"-",r.removeLines);return n.generatedContent=t.join("\n"),{...n,accepted:t.length>0}}return{...n,accepted:t===AcceptState.ACCEPT}}return n})),this.multiSuggestions}updateCodeBlockSuggestion(e){const t=codeBlock2TrimedGenerateLines(e);return this.multiSuggestions=this.multiSuggestions.map((e=>e.isCodeBlock&&e.generatedContent===t?{...e,accepted:!0}:e)),this.multiSuggestions}async replacePathsToMarkdownLinks(e){const t=this.newAddedMessages.filter(isTextMessage);await Promise.all(t.map((async t=>{t.content=await replacePathTextInMarkdown(t.content,e)})))}async handleCompressionNotification(e,t){const{data:r}=e;if(!r)return;const n=this.getLatestProgressToolCallMessage(),i=n&&"compress_message"===n.workflow.type,o="running"===r.status.toLowerCase();o&&!i?await this.createNewToolCallMessage({params:r,name:"compress_message"},t):!o&&i&&(await n.mergeParams(r),n.startWorkflow())}tokenUsage;async calculateTokenUsage(e,t){t&&await sleep$3(t);const r=await getTokenUsage(e);r&&(this.tokenUsage={...this.tokenUsage,usagePercentage:r.usagePercentage,contextUsed:r.contextUsed,contextLimit:r.contextLimit,needCompression:r.needCompression,savedPercentage:this.tokenUsage?.savedPercentage||0})}async compressTokenUsage(e){this.status=RoundtripStatus.Compressing,this.updateWebviewMessages({forceUpdate:!0});const t=await compressSessionTokenUsage(e),r=!t||"failed"===t?.status?t?.errorMessage||"压缩失败":"";this.tokenUsage={...this.tokenUsage,failReason:r,savedPercentage:t?.savedPercentage||0},this.status=RoundtripStatus.Completed,"success"===t?.status&&await this.calculateTokenUsage(e),this.updateWebviewMessages({forceUpdate:!0})}notifyTaskDone(e){this.systemNotificationService&&this.systemNotificationService.notifyTaskDone({workspaceName:this.getNotificationWorkspaceName(),summary:this.request.summary?.trim(),conversationTitle:this.resolveNotificationConversationTitle(),conversationId:this.conversationId,result:e})}notifyApprovalBlocked(e){if("use_mcp_tool"!==e.type)e.command&&this.systemNotificationService.notifyApprovalBlocked({workspaceName:this.getNotificationWorkspaceName(),kind:"run_command",conversationId:this.conversationId,command:e.command});else{if(!e.serverName||!e.toolName)return;this.systemNotificationService.notifyApprovalBlocked({workspaceName:this.getNotificationWorkspaceName(),kind:"use_mcp_tool",conversationId:this.conversationId,serverName:e.serverName,toolName:e.toolName})}}getNotificationWorkspaceName(){return path__default.basename(this.repo.rootPath)||"workspace"}resolveNotificationConversationTitle(){const e=this.request.payload?.query?.trim();if(e)return e;const t="command"in this.request.payload&&"string"==typeof this.request.payload.command?this.request.payload.command.trim():"";return t||void 0}toText(e=""){if(this.v2){return this.toolTurns.map((e=>e.toText())).join("\n\n")+"\n"+e}return""}}const nameMap=new Map([[24,["Sequoia","15"]],[23,["Sonoma","14"]],[22,["Ventura","13"]],[21,["Monterey","12"]],[20,["Big Sur","11"]],[19,["Catalina","10.15"]],[18,["Mojave","10.14"]],[17,["High Sierra","10.13"]],[16,["Sierra","10.12"]],[15,["El Capitan","10.11"]],[14,["Yosemite","10.10"]],[13,["Mavericks","10.9"]],[12,["Mountain Lion","10.8"]],[11,["Lion","10.7"]],[10,["Snow Leopard","10.6"]],[9,["Leopard","10.5"]],[8,["Tiger","10.4"]],[7,["Panther","10.3"]],[6,["Jaguar","10.2"]],[5,["Puma","10.1"]]]);function macosRelease(e){e=Number((e||os__default$1.release()).split(".")[0]);const[t,r]=nameMap.get(e)||["Unknown",""];return{name:t,version:r}}const names=new Map([["10.0.2","11"],["10.0","10"],["6.3","8.1"],["6.2","8"],["6.1","7"],["6.0","Vista"],["5.2","Server 2003"],["5.1","XP"],["5.0","2000"],["4.90","ME"],["4.10","98"],["4.03","95"],["4.00","95"]]);function windowsRelease(e){const t=/(\d+\.\d+)(?:\.(\d+))?/.exec(e||os__default$1.release());if(e&&!t)throw new Error("`release` argument doesn't match `n.n`");let r=t[1]||"";const n=t[2]||"";if((!e||e===os__default$1.release())&&["6.1","6.2","6.3","10.0"].includes(r)){let e;try{e=execaSync("wmic",["os","get","Caption"]).stdout||""}catch{e=execaSync("powershell",["(Get-CimInstance -ClassName Win32_OperatingSystem).caption"]).stdout||""}const t=(e.match(/2008|2012|2016|2019|2022/)||[])[0];if(t)return`Server ${t}`}return"10.0"===r&&n.startsWith("2")&&(r="10.0.2"),names.get(r)}function osName(e,t){if(!e&&t)throw new Error("You can't specify a `release` without specifying `platform`");let r;if("darwin"===(e=e??os__default$1.platform())){t||"darwin"!==os__default$1.platform()||(t=os__default$1.release());const e=t?Number(t.split(".")[0])>15?"macOS":"OS X":"macOS";try{if(r=t?macosRelease(t).name:"","Unknown"===r)return e}catch{}return e+(r?" "+r:"")}return"linux"===e?(t||"linux"!==os__default$1.platform()||(t=os__default$1.release()),r=t?t.replace(/^(\d+\.\d+).*/,"$1"):"","Linux"+(r?" "+r:"")):"win32"===e?(t||"win32"!==os__default$1.platform()||(t=os__default$1.release()),r=t?windowsRelease(t):"","Windows"+(r?" "+r:"")):e}function getOsName(){try{return osName()}catch{return os__default.platform()}}function getBaseSysInfo(){return{os:getOsName(),defaultShell:defaultShell,homeDir:os__default.homedir()}}function getDefaultSysInfo(e){return{...getBaseSysInfo(),defaultShell:"",installedCommands:[],notInstalledCommands:[],workspacePath:e}}async function getShellWithVersion(e){if(e.toLowerCase().includes("powershell"))try{const{stdout:t}=await execa("$PSVersionTable.PSVersion.ToString()",{shell:e,timeout:3e3});if(t&&t.trim())return`${e} (v${t.trim()})`}catch{}return e}function contentEqualRough(e,t){if("string"!=typeof e||"string"!=typeof t)return!1;const r=e.split(/\r?\n/),n=t.split(/\r?\n/);return r.length===n.length&&r.every(((e,t)=>e.trim()===n[t].trim()))}function equalFilePathOrUniqKey(e){return t=>!e||isFilePathEqual(t.key,e)}async function reportAbortedZuluMessage({messageId:e,reason:t,traceId:r}){try{await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/record",{messageId:e,reason:t,...getRequestClienInfo()},{headers:{...getRequestUserHeader(),"X-Trace-Id":r}})}catch(e){kernel.logger.error("zulu",e.message)}}const beautifyError=(e,t)=>{try{if(e instanceof Error){const r=e.message||e.errors.at(-1).message;if(/getaddrinfo EAI_AGAIN|getaddrinfo ENOTFOUND/i.test(r)){const e=r.match(/getaddrinfo (EAI_AGAIN|ENOTFOUND) (.*)/)?.[2];return t("kernel.zulu.error.network",e)}return/ECONNABORTED|ECONNRESET|ECONNREFUSED|socket hang up/i.test(r)?t("kernel.zulu.error.connAborted"):/ETIMEDOUT/i.test(r)?t("kernel.zulu.error.connTimeout"):/SSL.*ALERT|EPROTO|TLS/i.test(r)?t("kernel.zulu.error.tls"):/certificate/i.test(r)?t("kernel.zulu.error.certificate"):"aborted"===r?t("kernel.zulu.error.aborted"):r}return""}catch{return""}};function forEachRollbackToolTurn(e,t,r,n){const i=t?e.findIndex((e=>e.request.uuid===t)):e.findIndex((e=>e.toolTurns[0]?.match(r)));if(-1!==i)return e.slice(i).forEach((e=>{e.toolTurns.forEach((e=>n(e)))})),!0;const o=e[e.length-1];if(!o)return!1;const s=o.toolTurns,a=s.findIndex((e=>e.match(r)));return-1!==a&&(s.slice(a).forEach((e=>{n(e)})),!0)}const removeDiscardMsgAfterConsumed=async(e,t)=>{const r=await t.find(e),n=r.messages.map((e=>{if(e.discard)return null;if("assistant"===e.role){const t=e.elements.findIndex((e=>e.discard));return-1===t?e:{...e,elements:e.elements.slice(0,t)}}return e}));await t.save({...r,messages:n.filter(Boolean)})},{isEqual:isEqual,omit:omit}=_$H;class ConversationThread extends AbstractConversation{foreground=!1;roundtrips=[];lastUpdatedMessage=null;get latestRoundtrip(){return this.roundtrips[this.roundtrips.length-1]}get previousRoundtrip(){let e=this.roundtrips.length-2;for(;this.roundtrips[e]?.discard&&e>=0;)e--;return this.roundtrips[e]}getRoundtripByMessageId(e){return this.roundtrips.find((t=>t.uuid===e||t.request.uuid===e))}getConversationTitle(){const e=this.roundtrips[0]?.request;return e?.summary||e?.payload.query||""}async onConversationMessage(e){switch(this.logger.info("onConversationMessage",e),e.messageType){case"add-message":this.startNewWork(e.payload);break;case"stop-generating":await this.stopGenerating();break;case"message-operation":{const t=await this.handleNewMessage(e?.payload);return this.updateLatestMessage(!0),t}case"quota-exceed":{const t=e?.payload,r=this.startRoundtrip(t);r.v2?(await this.handleNewMessage({action:"quota-exceed",...t}),this.updateAllMessages()):r.fail(t?.quotaAction),this.updateStatus(AgentConversationStatus.Failed);break}case"refresh-messages":this.updateAllMessages()}}async startNewWork(e,t){this.logger.info("startNewWork",e),t&&this.logger.info(`isQuotaFallbackAuto: ${!!t}`);const r=t||this.startRoundtrip(e);this.updateStatus(AgentConversationStatus.Running),this.updateAllMessages();try{this.beforeStartWork(),await this.startWork(r),r.complete();const t=await this.onRoundtripComplete();if(t?.followup)return void await this.startNewWork({...e,query:t.followup});if(this.status===AgentConversationStatus.Cancelled)return void this.afterStartWork();if(this.latestRoundtrip.uuid!==r.uuid)return;this.updateStatus(AgentConversationStatus.Completed),this.afterStartWork()}catch(n){if(n instanceof ResourceUsageOverlimitError$1&&!t)try{const t=JSON.parse(n.message);if(t?.autoModel)return r.request.payload.model={displayName:"Auto",modelId:t.autoModel,requestType:"COMATE_DEFAULT_MODE",mode:"NORMAL"},void await this.startNewWork(e,r);r.quotaTip(JSON.stringify(t.userActions))}catch{this.logger.info("autoModelContinue failed")}if(this.afterStartWork(),reportAbortedZuluMessage({reason:n.message,messageId:r.context.userMessageId,traceId:this.id}),n instanceof CanceledError)return;if(axios.isAxiosError(n)&&n.response&&kernel.logger.error("Zulu",`Status: ${n.response.status} Headers: ${JSON.stringify(n.response.headers)} Data: ${JSON.stringify(n.response.data)}`),n instanceof AuthenticationError)return r.fail(n.message),void this.updateStatus(AgentConversationStatus.Failed);if(n instanceof Error){const e=n.message;this.type===AgentConversationType.AgentConversation&&!e.startsWith("{")&&!(n instanceof ReadWorkspacePermissionError)&&e.length<1e3&&this.logger.logUploader?.logUserAction({category:"new-agent",action:"abortConversation",label:n.message,content:this.id});if(/[\u4E00-\u9FA5]/.test(n.message))return r.fail(n.message),void this.updateStatus(AgentConversationStatus.Failed)}if(this.logger.error("[Zulu] failed create conversaion, reason:",n.message,n),this.latestRoundtrip.uuid!==r.uuid)return;r.fail(beautifyError(n,kernel.t)||kernel.t(ZuluText.GENERATE_ERROR)),this.updateStatus(AgentConversationStatus.Failed)}}async reportZuluError(e){}previousRollbackSummary=[];async getRollbackSummary({userMessageId:e,retryMessageId:t}){const r=e?this.roundtrips.findIndex((t=>t.request.uuid===e)):this.roundtrips.length-1,n=this.roundtrips.slice(r,this.roundtrips.length).reduce(((e,r)=>{const n=t?r.toolCallMessages.findIndex((e=>e.uuid===t)):-1,i=r.toolCallMessages.slice(n+1,r.toolCallMessages.length);for(const t of i){const r=t?.composer.tasks[0];if(r&&r.completed&&r.accepted===AcceptState.ACCEPT){const t=e.find((e=>e.absolutePath===r.absolutePath));t?t.changes.push(r):e.push({absolutePath:r.absolutePath,relativePath:r.filePath,action:r.rollbackAction,selected:!0,changes:[r]})}}return e}),[]);for(const e of n){const{absolutePath:t,changes:r,action:n}=e;if("willDelete"===n);else if("willCreate"===n){const{existed:r}=await this.virtualEditor.getDocument({absolutePath:t});r&&(e.conflict=!0,e.selected=!1)}else if("willChange"===n){const{content:n,existed:i}=await this.virtualEditor.getDocument({absolutePath:t});i||(e.action="willCreate");r.some((e=>contentEqualRough(e.content,n)))||(e.conflict=!0,e.selected=!1)}}return this.previousRollbackSummary=n,n}async getRollbackSummaryV2(e){if(!e)return[];const t=[];forEachRollbackToolTurn(this.roundtrips,void 0,e,(e=>t.push(...e.acceptedFsTools)));const r=t.reduce(((e,t)=>{const r=t.result?.metadata?.absolutePath,n=t.result?.metadata?.content,i=t.result?.metadata?.originalContent,o=t.result?.metadata?.relativePath;if(r){const s=e.find((e=>e.absolutePath===r)),a={absolutePath:r,relativePath:o,content:n,originalContent:i,rollbackAction:t.rollbackActionName,rollback:()=>t.toolHandler.revert()};s?s.changes.push(a):e.push({absolutePath:r,relativePath:o,action:t.rollbackActionName,selected:!0,changes:[a]})}return e}),[]);for(const e of r){const{absolutePath:t,changes:r,action:n}=e;if("willDelete"===n);else if("willCreate"===n){const{existed:r}=await this.virtualEditor.getDocument({absolutePath:t});r&&(e.conflict=!0,e.selected=!1)}else if("willChange"===n){const{content:n,existed:i}=await this.virtualEditor.getDocument({absolutePath:t});i||(e.action="willCreate");r.some((e=>contentEqualRough(e.content,n)))||(e.conflict=!0,e.selected=!1)}}return this.previousRollbackSummary=r,r}async openRollbackDiff(e){const t=this.previousRollbackSummary.find((t=>e===t.absolutePath)),r=t?.changes[0],{content:n}=await this.virtualEditor.getDocument({absolutePath:e});await this.virtualEditor.openVirtualDiffDocument({absolutePath:e,content:n,modified:r.originalContent||"",source:AgentConversationType.E2EBotConversation,action:VirtualDocumentAction.PREVIEW})}async rollbackAllFileChanges(e){for await(const t of this.previousRollbackSummary)if(e.includes(t.absolutePath)){const e=this.previousRollbackSummary.find((({absolutePath:e})=>e===t.absolutePath));await(e?.changes[0].rollback())}}rollbackMessageId;async executeRollback({userMessageId:e,retryMessageId:t},r){try{await this.rollbackAllFileChanges(r);const n=e;if(t){const e=this.roundtrips[this.roundtrips.length-1];e?.discardMessagesAfterRetryMessageId(t),this.rollbackMessageId=t}else if(n){const t=this.roundtrips.findIndex((t=>t.request.uuid===e));if(0===t)this.roundtrips.length=0,await this.chatSessionManager.delete(this.id);else{const e=this.roundtrips.slice(t,this.roundtrips.length);e.forEach((e=>{e.discard=!0}));const r=e[0];this.rollbackMessageId=r.responses[0]?.retryMessageId}}this.updateAllMessages()}catch(e){return{error:e.message}}}async getRollbackMessageId(){return this.rollbackMessageId}toMessages(){const e=this.roundtrips.map((e=>e.toMessages())).flat(),t=e.map((e=>{if("assistant"===e.role){const t=(e.elements??[]).map((t=>e.v2?ToolTurn.omitUnnecessaryFields(t):{...omit(t,"workflowSnapshot","params")}));return{...e,elements:t}}return e}));return{processedMessages:e,webviewMessages:t}}toJSON(){return this.roundtrips.map((e=>e.toJSON())).flat()}setForeground(e){this.foreground=e}startRoundtrip(e){const t=new Roundtrip(this.id,this.repo,this.logger,this.virtualEditor,(e=>this.updateMessageByStrategy(e)),e);return t.v2=this.type===AgentConversationType.AgentConversation,t.request.generateQuerySummary((e=>{this.afterGenerateQuerySummary(e,t)})),t.setForeground(this.foreground),this.roundtrips.push(t),t}async stopGenerating(){!1!==await this.beforeStop()&&(this.logger.info("stopGenerating"),this.latestRoundtrip?.cancel(),this.afterStop&&await this.afterStop(),this.updateLatestMessage(!0),this.updateStatus(AgentConversationStatus.Cancelled))}rebuildRollbackMessageId(e){const t=e.find((e=>"assistant"===e.role&&!!e.discard));if(t)return t.elements.find((e=>"TOOL_CALL"===e.type))?.id;const r=e[e.length-1].elements.find((e=>"TOOL_CALL"===e.type&&e.discard));return r?r.id:void 0}rebuildRoundtrips(e,t,r){let n=null;this.rollbackMessageId=this.rebuildRollbackMessageId(e);for(const i of e)"user"===i.role?(n=new Roundtrip(this.id,this.repo,this.logger,this.virtualEditor,(e=>this.updateMessageByStrategy(e)),Roundtrip.extractPayloadFromSnapshot(i)),n.v2=this.type===AgentConversationType.AgentConversation,n.context=i.context??{},n.appliedRules=i.appliedRules??[],n.request.setSummary(i.summary??""),n.disabledRollback=i.disabledRollback,this.roundtrips.push(n)):"assistant"===i.role&&n&&(i.v2?n.rebuildV2(i,t,r):n.rebuild(i),n.quotaExceedMessage=i.quotaExceedMessage||"",n.tokenUsage=i.tokenUsage,n.reportedId=i.reportedId,n=null)}getToolMessage(e){for(const t of this.roundtrips){const r=t.getToolCallMessage(e);if(r)return r}return null}getConversationToolCallMessages(){const e=[];for(const t of this.roundtrips)e.push(...t.toolCallMessages);return e}updateAllMessages(){const{processedMessages:e,webviewMessages:t}=this.toMessages();this.doUpdateAllMessages(e,t)}updateMessageByStrategy(e){e?.elementId?this.forceUpdateMessageElement(e.elementId):this.updateLatestMessage(e?.forceUpdate)}updateLatestMessage(e=!1){const{processedMessages:t,webviewMessages:r}=this.toMessages(),n=r[r.length-1];if(!n)return void this.doUpdateAllMessages(t,r);const i=e?{scope:"message",message:n}:this.getMessageUpdateOptions(n);this.lastUpdatedMessage=n,"elements"===i.scope&&0===i.messageData.elements.length||this.onMessageChange(this.id,t,i)}forceUpdateMessageElement(e){const{processedMessages:t,webviewMessages:r}=this.toMessages(),n=r.find((t=>"assistant"===t.role&&t.elements.some((t=>t.id===e))));if(!n)return;const i=n.elements.find((t=>t.id===e));if(!i)return;const o={scope:"elements",messageData:{id:n.id,elements:[i]}};this.onMessageChange(this.id,t,o)}deriveConversationStatus(){const e=this.latestRoundtrip;if(!e)return AgentConversationStatus.Ready;switch(e.status){case RoundtripStatus.Analyzing:case RoundtripStatus.Generating:case RoundtripStatus.Compressing:return AgentConversationStatus.Running;case RoundtripStatus.Failed:return AgentConversationStatus.Failed;case RoundtripStatus.Cancelled:return AgentConversationStatus.Cancelled;case RoundtripStatus.Completed:return AgentConversationStatus.Completed;default:return AgentConversationStatus.Ready}}doUpdateAllMessages(e,t){this.onMessageChange(this.id,e,{scope:"conversation",messages:t})}getMessageUpdateOptions(e){const t={scope:"message",message:e};if(!this.lastUpdatedMessage||this.lastUpdatedMessage.id!==e.id)return t;if("assistant"!==this.lastUpdatedMessage.role||"assistant"!==e.role)return t;if(!isEqual(omit(this.lastUpdatedMessage,"elements"),omit(e,"elements")))return t;const r=e.elements,n=this.lastUpdatedMessage.elements,i=r.some(((e,t)=>!n[t]||n[t].id!==e.id));if(i)return t;const o=[];for(let e=0;e<r.length;e++){const t=r[e],i=n[e];isEqual(t,i)||o.push(t)}return{scope:"elements",messageData:{id:e.id,elements:o}}}beforeStartWork(){}afterStartWork(){}beforeStop(){return Promise.resolve()}onRoundtripComplete(){return Promise.resolve(null)}afterStop(){return Promise.resolve()}afterGenerateQuerySummary(e,t){}}async function filterCommandFromPathOutput(e,t){const r=e.split(/\r?\n/).map((e=>e.split(sep$3))).filter((e=>e.length>1)).map((e=>e.pop()));return t.filter((e=>r.find((t=>t===e||t===`${e}.exe`))))}async function filterSupportedCommandWindows(e,t){const{stdout:r="",stderr:n=""}=await execa("where",e,{cwd:homedir$1(),shell:t,reject:!1,timeout:3e3});return filterCommandFromPathOutput(`${r}\n${n}`,e)}async function filterSupportedCommandUnix(e,t){const{stdout:r="",stderr:n=""}=await execa("command",["-v",...e],{cwd:homedir$1(),shell:t,reject:!1,timeout:3e3});return filterCommandFromPathOutput(`${r}\n${n}`,e)}async function filterSupportedCommand(e){try{const t=kernel.env.ideTerminalInfo?.defaultShell??defaultShell,r="win32"===os__default.platform()?await filterSupportedCommandWindows(e,t):await filterSupportedCommandUnix(e,t);return{notInstalledCommands:e.filter((e=>!r.includes(e))),installedCommands:r}}catch(e){return{installedCommands:[],notInstalledCommands:[]}}}const THROTTLE_DELAY=500,sleep$1=e=>new Promise((t=>setTimeout(t,e)));async function*throttleAsyncIterator(e,t=THROTTLE_DELAY){let r=0,n=[],i=await e.next();for(;!i.done;){n.push(i.value);const o=Date.now();o-r>=t&&(yield n,n=[],r=o);const s=e.next();!await Promise.race([s,sleep$1(t)])&&n.length&&(yield n,n=[],r=Date.now()),i=await s}n.length&&(yield n)}const{flow:flow}=_$H;class ExceptionAbortedError extends Error{chatParams;err;retryMessageId;constructor(e,t,r){super(t.message),this.chatParams=e,this.err=t,this.retryMessageId=r}}const safeJSONParse=e=>{try{return JSON.parse(e)}catch(e){return""}},assignPromptVersion=e=>({...e,extend:{...e.extend,promptVersion:9}}),isSpecAskApprovalQuery=e=>{if(!e.toolUseResults)return!1;const t=e.toolUseResults[0];if(!t)return!1;const r="write_file"===t.name||"patch_file"===t.name,n=!(!t.result?.query&&!t.result?.stage);return r&&n},omitRecursiveUselessParams=e=>{if(e.toolUseResults?.length||e.taskInfo){const t=isSpecAskApprovalQuery(e);return{...e,rollbackMessageId:t?e.rollbackMessageId:void 0,messageId:void 0,selfDefineInstruction:"",query:"",codeChunks:e.codeChunks?.filter((e=>"rule"===e.type)),knowledgeList:[],isCurrentFileSelected:e.isCurrentFileSelected}}return e},reformatContexts=e=>({...e,contexts:reformatKnowledgeContextType(e.contexts)}),assignParams=flow([assignPromptVersion,reformatContexts,omitRecursiveUselessParams]);async function*chat({username:e,cancelToken:t,agentInfo:r,...n}){process.env.ZULU_QUERY_DELAY&&await sleep$4(Number(process.env.ZULU_QUERY_DELAY||0));const i=n.analyze.traceId;let o="";const s=n.subAgents.find((e=>e.agentName===n.taskInfo?.subagent)),a=n.taskInfo?s:r;try{let e=n.taskId||n.analyze.taskId;n.taskInfo&&e&&(e=await createSubagentTask({traceId:i,cancelToken:t,agentInfo:{agentId:a.isProjectAgent?void 0:a.agentId,agentName:a.agentName,isProjectAgent:!!a.isProjectAgent},taskInfo:n.taskInfo,taskId:e}));const r=await axiosInstance.post(getBaseUrl$1()+"/rest/autowork/v1/chat/stream",{...assignParams(n),...getRequestClienInfo(),slash:"Composer",taskId:e,agentInfo:a,agentId:a.isProjectAgent?void 0:a.agentId,incremental:!0},{headers:{...getRequestUserHeader(),"X-Trace-Id":i},timeout:36e5,responseType:"stream",cancelToken:t}),s=new SSEProcessor(r.data,safeJSONParse);let c="",l=!1,A=!1;for await(const t of s.processSSE()){if(t.taskId=e,t.agentInfo=a,o=t.content.detail.retryMessageId,"EXCEPTION"===t.content.type)throw new InternalServerError$1(t.content.detail.exceptionMsg);"NOTIFICATION"!==t.content.type?(t.content.detail.planDelta||t.content.detail.reasoningDelta||t.content.detail.delta||t.content.detail.toolUse)&&(A&&(t.content.uriMetas=void 0),Array.isArray(t.content.uriMetas)&&(A=!0),l||!t.content.detail.planDelta&&!c?(t.content.detail.planDelta="",yield t):t.content.detail.planEnd?(t.content.detail.planDelta=c+t.content.detail.planDelta,c="",l=!0,yield t):t.content.detail.planDelta&&(c||(yield t),c+=t.content.detail.planDelta)):yield t}}catch(i){if(!o||i instanceof CanceledError)throw i;throw new ExceptionAbortedError({username:e,cancelToken:t,agentInfo:r,...n},i,o)}}class Agent{basePath;relativePath;metadata;content;id;constructor(e,t,r,n){this.basePath=e,this.relativePath=t,this.metadata=r,this.content=n;try{const r=statSync$2(join$7(e,t));this.id=-1*r.birthtimeMs}catch{this.id=-1*Date.now()}}get absolutePath(){return join$7(this.basePath,this.relativePath)}getAgentId(){return this.id}setAgentId(e){this.id=e}static pickTaskProperties(e,t){const r=_$H.keyBy(t,"serverName"),n=Array.isArray(e.mcpInfos)?e.mcpInfos.filter((e=>r[e])).map((e=>r[e])):[];return{..._$H.pick(e,["agentName","agentImage","description","agentPrompt"]),isProjectAgent:!!e.isProjectAgent,agentId:e.isProjectAgent?void 0:e.agentId,mcpInfos:n}}toString(){return matter$1.stringify(this.content,_$H.pickBy(this.metadata,(e=>Array.isArray(e)?e.length>0:"boolean"==typeof e?!1===e:!!e)))}toJSON(){return{agentId:this.id,isProjectAgent:this.isProjectAgent,relativePath:this.relativePath,agentName:this.metadata.name.trim(),description:this.metadata.description,agentImage:this.metadata.icon,agentPrompt:this.content,visibility:this.visibility,subAgents:[],mcpInfos:Array.isArray(this.metadata.mcpServers)?this.metadata.mcpServers:[],parentAgents:Array.isArray(this.metadata.parentAgents)?this.metadata.parentAgents:[],reportAgentName:this.reportAgentName,absolutePath:this.absolutePath}}async ensureAgentDir(){await lib$f.ensureDir(join$7(this.basePath,"agents"))}async save(){const e=join$7(this.basePath,this.relativePath);await this.ensureAgentDir(),await writeFile$2(e,this.toString()),this.id=-1*statSync$2(e).birthtimeMs}update(e,t){this.metadata=e,this.content=t}static async readAgentsFromPath(e,t,r){const n=await globby(t,{cwd:e});kernel.logger.info(`Found agents in ${e}: ${n.join(",")}`);const i=await Promise.all(n.map((async t=>{try{const n=await readFile$4(join$7(e,t),"utf-8"),{data:i,content:o}=matter$1(n);return i.name?r(e,t,i,o):null}catch(e){return kernel.logger.info(`Failed to read agent ${t}: ${e}`),null}})));return i.filter((e=>null!==e)).sort(((e,t)=>t.getAgentId()-e.getAgentId()))}static async deleteAgent(e,t){try{await rm$1(join$7(e,t))}catch{}}}class ProjectAgent extends Agent{agentGlob=".comate/agents/**.md";isProjectAgent=!0;reportAgentName="PROJECT_AGENT";visibility="PUBLIC";constructor(e,t,r,n){super(e,t,r,n)}static async find(e,t){return(await this.readFromWorkspace(e)).find((e=>e.toJSON().agentName===t))}static async write(e,t){const r=t.relativePath??join$7(".comate","agents",t.agentName+".md"),n=new ProjectAgent(e,r,{name:t.agentName,enable:"boolean"!=typeof t.enable||t.enable,description:t.description,icon:t.agentImage,tools:Array.isArray(t.tools)?t.tools:[],mcpServers:Array.isArray(t.mcpInfos)?t.mcpInfos:[],parentAgents:Array.isArray(t.parentAgents)?t.parentAgents:[]},t.agentPrompt);return await n.save(),n.toJSON()}static async delete(e,t){await Agent.deleteAgent(e,t)}static async update(e,t,r){const n=await this.find(e,t.name);if(n)return n.update(t,r),await n.save(),n;{const n=join$7(".comate","agents",`${t.name}.md`),i=new ProjectAgent(e,n,t,r);return await i.save(),i}}static async readFromWorkspace(e){return Agent.readAgentsFromPath(e,".comate/agents/**.md",((e,t,r,n)=>new ProjectAgent(e,t,r,n)))}}class AgentStatistics{contexts=[];tools=[];appendContexts(e){const t=e.filter((e=>e.type!==ContextType.RULE)).map((e=>_$H.pick(e,["id","name","type"])));this.contexts.push(...t)}appendRuleContexts(e){const t=e.map((e=>{const{path:t,subType:r}=e.toJSON();return{id:t,name:t,type:ContextType.RULE,subType:r}}));this.contexts.push(...t)}appendTool(e){if(isExtractContentBlocks(e))for(const t of e.displayResult.fileBlocks)isComateOrCursorRulePath(t.path)&&this.contexts.push({id:t.path,name:t.path,type:ContextType.RULE,subType:"readedRule"});this.tools.push({tool:e.type,params:_$H.pick(e.params,e.identityParamKeys)})}export(e){const t={agentContexts:[...this.contexts],agentTools:[...this.tools],assistantContent:e.v2?e.toText():e.textMessages.map((e=>e.content)).join("\n\n")};return this.contexts=[],this.tools=[],t}}const COMMON_COMMANDS=["python","python3","pip","pip3","go","docker","curl","ffmpeg","brew","pip","jq","nuget"];class E2EBotConversation extends ConversationThread{codeWrittenMetric;type=AgentConversationType.E2EBotConversation;inlineDiffView=!0;status=AgentConversationStatus.Ready;cancelTokenSource=createAxiosCancelTokenSource();mcpManager;previewProxyServerManager;quotaService;statistics=new AgentStatistics;specEditor;constructor(e,t,r,n){super(e),this.codeWrittenMetric=n,this.quotaService=iocContainer.get(QuotaService),this.mcpManager=t,this.status=AgentConversationStatus.Running,this.previewProxyServerManager=r,this.specEditor=new SpecEditor(this.roundtrips,(()=>this.status),this.mediator,this.id)}firstTokenStartTime=0;async startWork(e){this.firstTokenStartTime=performance.now();const t=await this.injectExtendParamsIfPreviousMessageExisted(e.request.payload);this.shouldIncludePreviousToolResult()?await this.createFollowupConversation(e,t):await this.createConversation(e,t)}async injectExtendParamsIfPreviousMessageExisted(e){const t=e.agent||{agentId:1,agentName:"Zulu",agentImage:"zulu",subagents:[]};updateLastUsedKnowledgeContext(e.knowledgeList);const r={fileOperate:{acceptedFiles:[],rejectedFiles:[]},contextMode:e.model?.mode,requestType:e.model?.requestType,promptENName:this.metrics?.function},n=this.previousRoundtrip;if(n){const i=n.getComposerTasks();for(const e of i){const t=e.toAcceptedLabel();e.accepted!==AcceptState.ACCEPT||r.fileOperate.acceptedFiles.includes(t)?e.accepted!==AcceptState.REJECT||r.fileOperate.rejectedFiles.includes(t)||r.fileOperate.rejectedFiles.push(t):r.fileOperate.acceptedFiles.push(t)}return{query:e.query,agent:t,taskId:n.context.taskId,conversationId:n.context.conversationId,knowledgeList:e.knowledgeList??[],extend:r,selfDefineInstruction:e.selfDefineInstruction,isCurrentFileSelected:e.isCurrentFileSelected}}return{query:e.query,agent:t,knowledgeList:e.knowledgeList??[],extend:r,selfDefineInstruction:e.selfDefineInstruction,isCurrentFileSelected:e.isCurrentFileSelected}}recreateCancelTokenSource(){return this.cancelTokenSource.cancel(),this.cancelTokenSource=createAxiosCancelTokenSource(),this.cancelTokenSource}async getMcpServers(e){const t=(await this.mcpManager.getConnectionsForWebview()).filter((({status:e,disabled:t})=>"connected"===e&&!t)).map((({name:e,tools:t})=>({serverName:e,tools:t?.map((({name:e,description:t,inputSchema:r})=>({name:e,description:t,inputSchema:r})))})));if(Array.isArray(e)){const r=e;return t.filter((({serverName:e})=>r.includes(e)))}return t}shouldIncludePreviousToolResult(){const e=this.previousRoundtrip;if(!e)return!1;const t=e.getLatestMessage();return!(!t||!isToolCallMessage(t))&&!0===t.workflow.includeInNextRoundtrip}async createFollowupConversation(e,t){this.logger.logUploader?.logUserAction({category:"zulu",action:"startFollowupConversation"}),this.recreateCancelTokenSource(),e.status=RoundtripStatus.Generating;const r=this.previousRoundtrip,n=r?.context.chatParams,i=r.getLatestMessage();if(!n||!i||!isToolCallMessage(i))return this.createConversation(e,t);const{conversationId:o}=n;e.context.userMessageId=n.analyze?.messageId,e.context.taskId=n.analyze?.taskId,this.logger.info("E2EBot start followup roundtrip: "+o);const s={...n,rollbackMessageId:this.rollbackMessageId,cancelToken:this.cancelTokenSource.token};this.performanceLog("agent-readenv-end"),kernel.logger.info("[Zulu] start followup chat");const a=await i.workflow.getResultForNextRoundtrip(e.request.payload);await this.startChat(e,s,a?[a]:[])}async createConversation(e,t){this.logger.logUploader?.logUserAction({category:"zulu",action:"startConversation"}),this.recreateCancelTokenSource(),e.status=RoundtripStatus.Analyzing;const r=e.request.payload?.model,n=await this.getMcpServers(this.getAgentMcpServers(e));this.performanceLog("agent-start-analyze");const i=analyze({username:this.repo.username,query:t.query,sessionId:this.id,conversationId:t?.conversationId,slash:"Composer",taskId:t?.taskId,contexts:[],mcpInfo:n,agentInfo:t.agent,traceId:this.id,modelKey:r?.modelId,extend:{contextMode:r?.mode,requestType:r?.requestType}});e.status=RoundtripStatus.Generating,this.logger.info("E2EBot start new roundtrip");const o=await this.virtualEditor.getActiveDocument(),{existed:s,selections:a,absolutePath:c}=o,l=s?relative$2(this.repo.rootPath.replace(/\\/g,"/"),c.replace(/\\/g,"/")):void 0;t.knowledgeList=transformKnowledges(t.knowledgeList,{relativePath:l});const A=transformContexts(t.knowledgeList),u=await transformQuery(t.query,t.knowledgeList),d=context2CodeChunks(A,o,this.repo.rootPath,this.virtualEditor);kernel.logger.info("[Zulu] start get system info");const h=this.getSysInfo(),p=getTraceRepoInfo(o,this.repo.rootPath),g=getContextsConfigList(),f=this.getRollbackMessageId(),m=this.getAgentInfo(e),E=t.agent?.subagents??[],C=excludeIllegalContexts(A);this.statistics.appendContexts(C);const{conversationId:I,extend:y,messageId:B,taskId:b,quotaMessages:v}=await i;this.performanceLog("agent-end-analyze"),e.context.taskId=b,v?(e.context.quotaActions=v.userActions,this.updateWebviewQuota({exceeded:!0,autoModel:v.autoModel,userActions:v.userActions})):(e.context.quotaActions=void 0,this.updateWebviewQuota({exceeded:!1,autoModel:"",userActions:{}})),e.request.replaceUuidWithUserMessageId(String(B)),e.context.conversationId=I,e.context.userMessageId=B;const w={messageId:B,rollbackMessageId:await f,username:this.repo.username,query:u,contexts:C,conversationId:I,codeChunks:await d,extend:{...t.extend,...y},analyze:await i,sysInfo:await h,cancelToken:this.cancelTokenSource.token,paths:[],mcpInfo:n,modelKey:r?.modelId,selfDefineInstruction:t.selfDefineInstruction,isCurrentFileSelected:t.isCurrentFileSelected,...await p,...m,agentInfo:ProjectAgent.pickTaskProperties(t.agent,n),subAgents:E.map((e=>ProjectAgent.pickTaskProperties(e,n))),configContexts:await g};this.performanceLog("agent-readenv-end"),kernel.logger.info("[Zulu] start chat "),await this.startChat(e,w)}endConversation(){this.virtualEditor.endConversationEditSession({conversationId:this.id}),this.acceptLogOnEnd("end")}onEndShowQuotaMessage(e){const t=e.context.quotaActions;t&&e.quotaTip(JSON.stringify(t))}async updateWebviewQuota(e){this.quotaService.updateWebviewQuota(e)}async startChat(e,t,r=[]){try{this.virtualEditor.startConversationEditSession({conversationId:this.id,source:this.type}),this.fileConsistencyChecker.saveCodeChunks(t.codeChunks),await this.recursivelyRegenerate(e,t,r),this.logger.logUploader?.logUserAction({category:"zulu",action:"endConversation"}),this.onEndShowQuotaMessage(e)}catch(e){throw e}finally{if(this.rollbackMessageId){this.rollbackMessageId=void 0;const e=await this.chatSessionManager.find(this.id),t=e.messages.map(((e,t)=>{if(e.discard)return null;if("assistant"===e.role){const t=e.elements.findIndex((e=>e.discard));return-1===t?e:{...e,elements:e.elements.slice(0,t)}}return e}));await this.chatSessionManager.save({...e,messages:t.filter(Boolean)})}this.endConversation()}}async beforeStop(){if(this.cancelTokenSource){this.logger.logUploader?.logUserAction({category:"zulu",action:"cancelConveration"}),this.latestRoundtrip.status===RoundtripStatus.Analyzing&&(this.latestRoundtrip.appendTextResponse("您已主动终止本次会话。",{replace:!0}),this.latestRoundtrip.updateWebviewMessages({forceUpdate:!0})),this.cancelTokenSource.cancel();const e=this.latestRoundtrip.getLatestToolCallMessage();e&&e.workflow.type===WorkflowType.RunCommand&&e.workflow.status===WorkflowStatus.READY&&(e.workflow.cancel(),this.endConversation())}}sanitizeDiffString(e){const t=e=>e.filter((e=>!/@@(.*)@@/.test(e))),r=e.split(/\r?\n/);return r[0].startsWith("---")&&r[1].startsWith("+++")?t(r.slice(2)).join("\n"):t(r).join("\n")}get metrics(){const e=this.latestRoundtrip.request.metrics,t=this.latestRoundtrip.request.payload?.model?.modelId||"Auto",r=this.latestRoundtrip.request.metrics?.path;return{...e,path:r,modelKey:t}}async acceptLogOnEnd(e){if(!this.latestRoundtrip)return;const{suggestions:t,changes:r}=await this.latestRoundtrip.updateAcceptSuggestions(this.metrics),n="CODE_EXPLAIN"===this.latestRoundtrip.request.payload.metrics?.function,i=this.latestRoundtrip.request.payload?.query?.trim(),{agentContexts:o,agentTools:s,assistantContent:a}=this.statistics.export(this.latestRoundtrip);if(void 0!==this.latestRoundtrip.getLatestMessage()){if("end"===e){this.codeWrittenMetric.agentEdit(Object.values(r));const e=await this.generateMessageId(this.metrics,t,i,a,o,s);this.logger.info("[Zulu] Roundtrip completed: uuid=",e),this.latestRoundtrip.reportedId=e,this.latestRoundtrip.updateWebviewMessages()}this.logger.info("[Zulu] Track roundtrip completed: reportedId=",this.latestRoundtrip.reportedId),this.acceptLog(this.metrics,this.latestRoundtrip.reportedId,t,!(n||!t.length))}this.onAcceptLog(t,e)}async onFileAcceptedChange(e,t,r){if(!this.latestRoundtrip)return;const n=this.latestRoundtrip.updateSuggestionsByPath(relative$2(this.repo.rootPath,e),t,r);return n.length&&(this.logger.info("[Zulu] Track file accepted: reportedId=",this.latestRoundtrip.reportedId),this.acceptLog(this.metrics,this.latestRoundtrip.reportedId,n)),this.onAcceptLog(n,"action"),n}acceptCodeBlock(e){if(!this.latestRoundtrip)return;const t=this.latestRoundtrip.updateCodeBlockSuggestion(e);t.length&&(this.logger.info("[Zulu] update code block acceptance"),this.acceptLog(this.metrics,this.latestRoundtrip.reportedId,t))}async acceptLog(e,t,r,n=!0){if(!t)return;const i={fileContent:r};await acceptCode({uuid:t,accepted:n,content:"",multiSuggestions:i})}async handleNewMessage(e){switch(e.action){case"execute-shell":{const{output:t}=await this.virtualEditor.executeTerminalShell({cmd:e.shell,cwd:this.repo.rootPath,duration:5e3,run:!0});if(e.id!==this.latestRoundtrip?.uuid)return;const r=extractLocalhostAddressFromOutput(t);if(r)try{const{port:t}=new URL(r);if(await isPortAvailable$1(Number(t))){const t=this.latestRoundtrip.getTextMessage(e.elementId);t?.composer.updatePreview(r)}}catch(e){this.logger.error("execute-shell failed, reason:",e)}break}case"insert-shell":await this.virtualEditor.executeTerminalShell({cmd:e.shell,cwd:this.repo.rootPath,duration:5e3,run:!1}),this.acceptCodeBlock(e.shell);break;case"copy-code":this.acceptCodeBlock(e.content);break;case"file-diff":case"file-view":{if(this.specEditor.isSpec&&!this.specEditor.isProjectFileChange(e.elementId)){await this.specEditor.openSpecEditor(e.elementId);break}const t=this.roundtrips.reduce(((t,r)=>{if(t)return t;return r.getTextMessage(e.elementId)||r.getToolCallMessage(e.elementId)?r:null}),null);if(!t)return;const r=this.roundtrips.at(-1)===t,n=t.getComposerTasks().filter(equalFilePathOrUniqKey(e.absolutePath??e.filePath)),i={stream:!1,elementId:e.elementId};if(1===n.length){const e=n[0];if(r){const{content:t}=await this.virtualEditor.getDocument({absolutePath:e.absolutePath});await e.openDiff({...i,content:e.originalContent||"",modified:t,acceptable:!0})}else await e.openDiff({stream:!1,content:e.originalContent||"",modified:e.content,acceptable:!1})}else if(n.length>1){const e=n[n.length-1],t=n[0].originalContent||"";if(r){const{content:r}=await this.virtualEditor.getDocument({absolutePath:e.absolutePath});await e.openDiff({...i,acceptable:!0,content:t,modified:r})}else{const r=n[n.length-1].content;await e.openDiff({stream:!1,acceptable:!1,content:t,modified:r})}}break}case"file-tool-result-view":{if(this.specEditor.isSpec&&!this.specEditor.isProjectFileChange(e.elementId)){await this.specEditor.openSpecEditor(e.elementId);break}const t=e.elementId,r=this.getToolMessage(t),n=r?.composer.tasks[0];n&&await n.openDiff({stream:!1,acceptable:!1,content:n.originalContent||"",modified:n.content||""});break}case"file-accept":{const t=this.latestRoundtrip.getComposerTasks()?.filter(equalFilePathOrUniqKey(e.filePath))||[];for(const e of t)await e.save();this.onFileAcceptedChange(e.filePath,AcceptState.ACCEPT);break}case"file-reject":{const t=this.latestRoundtrip.getComposerTasks()?.filter(equalFilePathOrUniqKey(e.filePath))||[];for(const e of t.reverse())await e.revert();this.onFileAcceptedChange(e.filePath,AcceptState.REJECT);break}case"file-accept-block":{const t=this.latestRoundtrip.getComposerTasks()?.find(equalFilePathOrUniqKey(e.filePath));t?.accept();break}case"file-reject-block":{const t=this.latestRoundtrip.getComposerTasks()?.find(equalFilePathOrUniqKey(e.filePath));if(t&&"edit"===e.source){if(!e.acceptance)return void t.reject();const r=await this.onFileAcceptedChange(e.filePath,AcceptState.REJECT,e.acceptance);if(r){const n=r.find((t=>isFilePathEqual(relative$2(this.repo.rootPath,e.filePath),t.path)));(!1===e.accepted||n&&!n.accepted)&&t.reject()}}break}case"tool-call-accept":{const t=this.getToolMessage(e.elementId);t?.workflow.acceptToRunWorkflow();break}case"tool-call-reject":{const t=this.getToolMessage(e.elementId);t?.workflow.rejectToRunWorkflow();break}case"tool-call-action":{const t=this.getToolMessage(e.elementId);t?.workflow.executeCustomAction(e.params);break}case"file-accept-all":{const e=this.latestRoundtrip?.getComposerTasks()||[];for(const t of e)t.completed&&await t.save({openDocument:!1});this.acceptLogOnEnd("action");break}case"file-reject-all":{const e=this.latestRoundtrip?.getComposerTasks()||[];for(const t of e.reverse())t.completed&&await t.revert({openDocument:!1});this.acceptLogOnEnd("action");break}case"regenerate-chat":{const e=this.latestRoundtrip;e&&super.startNewWork(e.request.payload);break}case"inquire-rollback-message":await this.stopGenerating();return(await this.getRollbackSummary({userMessageId:e.userMessageId,retryMessageId:e.retryMessageId})).map((e=>_$H.omit(e,"changes")));case"rollback-message":{this.specEditor.beforeRollback();const t=await this.executeRollback({userMessageId:e.userMessageId,retryMessageId:e.retryMessageId},e.selectedAbsolutePaths);return t||(this.specEditor.afterRollback(),this.fileConsistencyChecker.clear()),t}case"copy-all":return this.handleCopyFullContent(e.id);case"user-feedback":this.onUserFeedBack(e.id,e.options);break;case"compress-token-usage":{const e=this.latestRoundtrip.context.sessionId;await this.latestRoundtrip.compressTokenUsage({sessionId:e});break}}}rebuildConversation(e){this.rebuildRoundtrips(e.messages),this.status=this.deriveConversationStatus(),this.specEditor.rebuild(),this.fileConsistencyChecker.rebuild(e.fileCache)}getSessionState(){if(this.specEditor.isSpec){if(this.specEditor.hasDocOrTasksPending)return SessionState.Pending;if(this.specEditor.hasSummaryFile)return SessionState.Summarized}return super.getSessionState()}async recursivelyRegenerate(e,t,r,n,i){kernel.logger.info("[Zulu] start collect chat params");const o=await this.updateDynamicChatParams(e,t,r);if(!e.inProgress)return{content:"",taskId:0,sessionId:0,agentInfo:{}};kernel.logger.info("[Zulu] request chat response");try{const{sessionId:r,taskId:s,content:a,agentInfo:c}=await this.doRequestAndParseResponse(e,o,n,i);n||this.rememberSessionId(e,r);const{nextRequestResults:l,nextRoundtripResults:A}=await this.processNewAddedMessages(e,t),u=t.analyze.needMock,d="cancelled"===e.status,h={...t,taskInfo:void 0};return h.sessionId=h.sessionId||r,h.taskId=h.taskId||s,h.agentInfo=c,A.length>0&&(e.context.chatParams=_$H.omit(h,["cancelToken"])),!u&&!d&&l.length>0?this.recursivelyRegenerate(e,h,l,n):(await this.latestRoundtrip.calculateTokenUsage({sessionId:r}),{sessionId:r,taskId:s,agentInfo:c,content:a})}catch(e){const t=this.latestRoundtrip.context.sessionId;throw t&&await this.latestRoundtrip.calculateTokenUsage({sessionId:t},1e3),e}}performanceLog(e){if(this.firstTokenStartTime){const t=performance.now()-this.firstTokenStartTime;this.logger.logUploader?.performanceLog({plugin:this.metrics.modelKey,skill:this.metrics.function,duration:t,type:e}),this.logger.info(`[Performance] ${e} take ${t} ms`),"agent-first-token"===e&&(this.firstTokenStartTime=0)}}async doRequestAndParseResponse(e,t,r,n){const i=iocContainer.get(SecurityFilter$1);if(i.isEnable){const e=i.filterUserInput(t.query);"replace"===e.action&&(t.query=e.filteredText),i.triggerNotification(e)}this.performanceLog("agent-start-stream");const o=await chat({...t,extend:{...t.extend}});let s="",a=0,c=0,l={},A=n;for await(const n of throttleAsyncIterator(o)){for(const i of n){if(c=i.taskId,l=i.agentInfo,this.performanceLog("agent-first-token"),i.sessionId&&!a&&(a=i.sessionId),i.taskId&&!c&&(c=i.taskId),"NOTIFICATION"===i.content.type){await e.appendNotificationResponse(i.content,{fileConsistencyChecker:this.fileConsistencyChecker});continue}Array.isArray(i.content.uriMetas)&&await e.updateWebSearchResult(i.content.uriMetas),i.content.detail.planDelta&&await e.appendTodoResponse(i.messageId,i.content.detail.planDelta,!!i.content.detail.planEnd,r);const{type:n,detail:o,end:u}=i.content,{reasoningDelta:d="",reasoningEnd:h,retryMessageId:p}=i.content.detail;if(A=p,await e.appendReasonResponse(i.messageId,d,h,r),"ANSWER"===n){const t=o.delta??"";s+=t,e.appendTextResponse(t,void 0,r);continue}const g=o.toolUse??[];for(const o of g){const{input:s,...a}=o,c={mcpManager:this.mcpManager,previewProxyServerManager:this.previewProxyServerManager,parentMessageId:r,specEditor:this.specEditor,fileConsistencyChecker:this.fileConsistencyChecker,requestInfo:{contexts:t.contexts,sessionId:t.sessionId,messageId:i.messageId,conversationId:i.conversationId,agentName:t.agentInfo?.agentName}};await e.appendToolCallResponse({eventType:n.replace("FUNCTION_CALL","TOOL_CALL"),params:s,...a},c)}if(!0===u){s="";break}}e.updateWebviewMessages()}return this.latestRoundtrip.responses.forEach((e=>{e.retryMessageId=e.retryMessageId||A})),{sessionId:a,taskId:c,agentInfo:l,content:s}}async processNewAddedMessages(e,t){const r=this.aggregateRelativeFilePathsFromContext(t.codeChunks),n=t.analyze.needMock,i=[],o=[],s=e.resolveNewAddedMessages();for(const a of s){if(isTextMessage(a)&&r.length>0)a.content=await replacePathTextInMarkdown(a.content,r);else if(isToolCallMessage(a)){if(a.workflow instanceof SubtaskWorkflow&&!n)try{const r=a.workflow.getSubtaskParams(),n=await this.getMcpServers(this.getAgentMcpServers(e,r.subagent)),i={...t,sessionId:void 0,taskId:void 0,taskInfo:r,mcpInfo:n},o=await this.recursivelyRegenerate(e,i,[],a.uuid);a.workflow.setResult(o)}catch(e){a.workflow.fail(e)}await a.workflow.workflowPromise,a.workflow.result&&(a.workflow.includeInNextRoundtrip?o.push(a.workflow.result):a.workflow.includeInNextRequest&&i.push(a.workflow.result)),this.statistics.appendTool(a.workflow),e.updateWebviewMessages()}a.end()}return{nextRequestResults:i,nextRoundtripResults:o}}reportMessageRetryStatus(e){this.logger.logUploader?.logUserAction({category:"zulu",action:"retryAbortedMessage",label:e?"success":"failed"})}aggregateRelativeFilePathsFromContext(e){const t=this.latestRoundtrip;if(!t)return[];const r=new Set;for(const t of e)t.path&&t.path.length>=3&&r.add(t.path);for(const e of t.toolCallMessages)for(const t of e.workflow.paths)t.length>=3&&r.add(t);return Array.from(r)}aggregateKnowledgeAndPaths(){const e=[],t=new Set;for(const r of this.roundtrips){const n=r.request.payload.knowledgeList??[];e.push(...n);for(const e of r.toolCallMessages)for(const r of e.workflow.paths)t.add(r)}const r=uniqKnowledges(transformRuleKnowledge(e).reverse());for(const e of r)[ContextType.FILE,ContextType.CURRENT_FILE].includes(e.type)&&e.id&&t.add(e.id);return{knowledgeList:r,filePaths:Array.from(t)}}computeRecrusiveToolUse(e,t){if(t.length>0){const r=e.toolCallMessages,n=r[r.length-1],i=n?.workflow.type,o=[WorkflowType.ReadFile,WorkflowType.WriteFile,WorkflowType.ExtractContentBlocks,WorkflowType.PatchFile,WorkflowType.SearchFiles,WorkflowType.ListFiles,WorkflowType.RunCommand];if(r.length>2&&o.includes(i)){const r=[...e.toolCallMessages].reverse(),i=r.findIndex((e=>e.workflow.status!==WorkflowStatus.FAILED)),o=i>2?i:r.findIndex((e=>!n.workflow.isEqual(e.workflow))),s=-1===o?r.length:o;if(s>2){const e=r.slice(0,s).map((e=>({params:e.workflow.params,status:e.workflow.status===WorkflowStatus.SUCCESS})));return[{...t[0],prevToolUse:e},...t.slice(1)]}}}return t}async updateDynamicChatParams(e,t,r){kernel.logger.info("[Zulu] start collect command info");const n=e.toolCallMessages[e.toolCallMessages.length-1];let i=t.sysInfo.notInstalledCommands,o=t.sysInfo.installedCommands;if(!o||!i||n?.workflow.type===WorkflowType.RunCommand){const e=await filterSupportedCommand(COMMON_COMMANDS);i=e.notInstalledCommands,o=e.installedCommands}kernel.logger.info("[Zulu] start collect rule info");const s=await this.getAppliedWorkspaceRules();this.statistics.appendRuleContexts(s),kernel.logger.info("[Zulu] start collect share memory info");const a=await this.getShareMemory(),c=await this.getWorkspaceMemory();return{...t,toolUseResults:this.computeRecrusiveToolUse(e,r),sysInfo:{...t.sysInfo,notInstalledCommands:i,installedCommands:o},cancelToken:this.cancelTokenSource.token,codeChunks:[...t.codeChunks,...s],shareMemory:a,projectMemory:c}}async getSysInfo(){const e=getBaseSysInfo(),t=kernel.env.ideTerminalInfo?.defaultShell,[{tree:r},n,{installedCommands:i,notInstalledCommands:o}]=await Promise.all([streamingListEntries(this.repo.rootPath),getShellWithVersion(t??e.defaultShell),filterSupportedCommand(COMMON_COMMANDS)]);return{...e,installedCommands:i,notInstalledCommands:o,workspaceDirTree:r.toOverviewStructure().tree,workspacePath:this.repo.rootPath,defaultShell:n}}async getAppliedWorkspaceRules(){if(!this.repo.rootPath)return[];const e=await getWorkspaceRules(this.repo.rootPath,this.virtualEditor),{knowledgeList:t,filePaths:r}=this.aggregateKnowledgeAndPaths(),{globRules:n,alwaysApplyRules:i}=getActiveRules(this.repo.rootPath,e,r),o=[],s=t.filter((e=>e.type===ContextType.RULE));for(const t of s){const r=e.find((e=>isFilePathEqual(e.path,t.id)));r&&o.push(createRuleCodeChunk(this.repo.rootPath,r))}for(const e of n)o.push(createRuleCodeChunk(this.repo.rootPath,e));for(const e of i)o.push(createRuleCodeChunk(this.repo.rootPath,e));return _$H.uniqBy(o,"path")}getAgentInfo(e){const t=e.request.payload.agent,r=t?.agentId,n=this.previousRoundtrip;if(!n)return{agentId:r,sessionId:void 0};const i=n.request.payload.agent;return i&&i.agentId===r?{agentId:r,sessionId:n.context.sessionId}:{agentId:r,sessionId:void 0}}rememberSessionId(e,t){!e.context.sessionId&&t&&(e.context.sessionId=t)}async getShareMemory(){try{return await getAgentShareMemory(this.id,this.virtualEditor)}catch(e){return void this.logger.error("Failed to get agent share memory:",e)}}async getWorkspaceMemory(){try{return await getWorkspaceMemories()}catch(e){return this.logger.error("Failed to get workspace memory:",e),[]}}getAgentMcpServers(e,t){const r=e.request.payload.agent;if(r){if(t){const e=r.subagents?.find((e=>e.agentName===t));return e?e.mcpInfos:[]}return r.mcpInfos}}beforeStartWork(){this.specEditor.beforeStartWork()}afterStartWork(){this.specEditor.afterStartWork()}afterGenerateQuerySummary(e,t){this.specEditor.afterGenerateQuerySummary(e,t)}onAcceptLog(e,t){}onUserFeedBack(e,t){const r=this.roundtrips.find((t=>t.uuid===e)),n=r?.reportedId;n?modifyCode({uuid:n,...t}):this.logger.warn("[Zulu] Roundtrip reportedId missing: message uuid=",e)}elementToText(e){switch(e.type){case"TEXT":return e.content;case"TOOL_CALL":return`\`\`\`${e.toolName}\n${JSON.stringify(e.params??"")}\n\`\`\``;default:return""}}handleCopyFullContent(e){const t=this.roundtrips.find((t=>t.uuid===e));if(!t)return void this.logger.warn("[Zulu] Roundtrip invalid: message uuid=",e);const r=t.toMessages().find((e=>"assistant"===e.role));if(!r)return void this.logger.warn("[Zulu] Roundtrip assistantMessage missing: message uuid=",e);const n=t.reportedId?`\nReportID: ${t.reportedId}`:"",i=this.id?`\nConversationID: ${this.id}`:"";return r.elements.map((e=>{const t=this.elementToText(e);if(e.parentMessageId){const e="    ";return e+t.split("\n").join("\n"+e)}return t})).join("\n\n")+n+i}}const{isEmpty:isEmpty$1}=_$H,getQuery=e=>e.customPrompt?e.customPrompt:`请帮我分析终端的报错日志，并提供解决方案。只解决第一个报错\n${e.code??""}`;class DebugBotConversation extends E2EBotConversation{codeWrittenMetrics;type=AgentConversationType.DebugBotConversation;sendCustomEventToIde;constructor(e,t,r,n,i){super(e,t,n,i),this.codeWrittenMetrics=i,this.sendCustomEventToIde=r}async startWork(e){if(1===this.roundtrips.length)await this.startDebugConversation(e);else if(2===this.roundtrips.length){const t=await this.injectExtendParamsIfPreviousMessageExisted(e.request.payload);await this.createConversation(e,t)}else{const t=await this.injectExtendParamsIfPreviousMessageExisted(e.request.payload);await this.createConversation(e,t)}this.endConversation()}async afterStop(){this.latestRoundtrip.reportedId&&this.reportConversationStatusChange("ABORT")}async startDebugConversation(e){const t=e.request.payload,r=await this.analyze(e.uuid,t);e.appendTextResponse(r?.errorReason??"");const n=await this.searchCode(r),i=await this.buildParams(e.uuid,t,r,n);e.status=RoundtripStatus.Generating,await this.recursivelyChat(e,i,[])}async analyze(e,t){const{platform:r,cwd:n,contexts:i}=t;return await agenticAnalyze({userDetail:{...this.userDetail,username:this.repo.username},conversationId:this.id,taskId:e,query:getQuery(t),cwd:n,platform:r,contexts:"object"==typeof i?JSON.stringify(i):i})}async searchCode(e){return e&&!isEmpty$1(e.context)?await this.sendIdeAction("search",e.context):{}}async buildParams(e,t,r,n){const[i]=await listFiles(this.repo.rootPath,this.repo.rootPath,!0,200),o={...getBaseSysInfo(),workspaceFolder:this.repo.rootPath,workspaceFolderTrees:i.map((e=>"folder"===e.type?`${e.path}/`:e.path))};return{userDetail:{...this.userDetail,username:this.repo.username},query:getQuery(t),taskId:e,context:{...n,sysInfo:o},device:this.userDetail.device,recordId:r?.recordId,conversationId:this.id,queryType:r?.queryType,toolUseResults:[],type:"NORMAL"}}async recursivelyChat(e,t,r){try{this.virtualEditor.startConversationEditSession({conversationId:this.id,source:this.type}),await this.doRecursivelyChat(e,t,r),this.virtualEditor.endConversationEditSession({conversationId:this.id})}catch(e){throw this.virtualEditor.endConversationEditSession({conversationId:this.id}),e}}async doRecursivelyChat(e,t,r){const n=await agenticAutoDebugFix({...t,toolUseResults:r});let i="";const o=new SSEProcessor(n).processSSE();for await(const t of throttleAsyncIterator(o,200)){for(const r of t){!i&&r.requestId&&(i=r.requestId);const{data:t,code:n,message:o}=r;if(200!==n)throw new Error(o);if(t){if((t.content||t.result)&&e.appendTextResponse(t.content||t.result),Array.isArray(t.toolUse))for(const r of t.toolUse)await e.appendToolCallResponse(r);if(t.isEnd)break}}e.updateWebviewMessages()}const s=await this.getNewWorkflowResults(e);if(s.length>0){const r={...t,query:"",context:void 0,type:"NORMAL"};await this.doRecursivelyChat(e,r,s)}}async getNewWorkflowResults(e){const t=e.resolveNewAddedMessages(),r=t.filter(isToolCallMessage),n=await Promise.all(r.map((async t=>{const r=t.workflow;return await r.workflowPromise,e.updateWebviewMessages(),r.includeInNextRequest?r.result:null})));return t.forEach((e=>e.end())),"cancelled"===e.status?[]:n.filter((e=>null!==e))}sendIdeAction=(e,t)=>this.sendCustomEventToIde(AGENT_DEBUG_CUSTOM_ACTION,{action:e,data:t});onAcceptLog(e,t){this.latestRoundtrip&&this.latestRoundtrip.reportedId&&("end"===t?this.onCodeGenerated(this.latestRoundtrip.reportedId,e):"action"===t&&this.onCodeAccepted(e))}onCodeAccepted(e){const t=e.filter((e=>!0===e.accepted)).map((e=>e.generatedContent)).join("\n");codeAdopt({userDetail:{...this.userDetail,username:this.repo.username},conversationId:this.id,adoptedCode:t})}onCodeGenerated(e,t){const r=t.map((e=>e.generatedContent)).join("\n");codeGenerate({userDetail:{...this.userDetail,username:this.repo.username},uuid:e,generatedCode:r,conversationId:this.id})}reportConversationStatusChange(e){taskStatus({userDetail:{...this.userDetail,username:this.repo.username},conversationId:this.id,status:e})}}const UserQuerySystemReminder={askModeActived:systemReminderBuilder(dedent`
             Ask mode is active; only read-only tools are available.
             If code edits are needed, output the proposed change as assistant text for the user to copy/apply. Begin your codeblocks using \`\`\`language format, and do NOT include filepaths.
             Do your best to answer using read-only tools, but if write/edit/terminal tools are required, or the user explicitly asks you to apply changes, let them know they're in ask mode and should switch to agent mode.
@@ -425,6 +425,7 @@ const path$7=path__default$1,util$9=t$1,isNaturalNumber=isNaturalNumber$1;var st
         ### 轮次参数（可选，通常不需要手动指定）
         - \`max_rounds\`：检索阶段最大轮数，默认 10；大型仓库或需要深度追踪调用链时可设为 15~20；证据不充分时系统会自动翻倍扩容
         - \`max_summary_rounds\`：标注+总结阶段轮次预算，默认 7；检索到大量代码块时可适当提高（每轮处理约 1500 行代码）
+        - \`max_parallelism\`（可选）：每轮目标并行工具调用数，默认 4；宽泛探索（大型仓库）可设为 5-6，精准深读可设为 2-3；不传则使用默认值 4
 
         ### 调用示例
         retrieval_agent(query="[FIX] ChoiceWidget 在 GET 请求中返回错误状态码", retrieval_type="code")