@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/session/server.js

@@ -1,7 +1,1194 @@
-"use strict";var re=exports&&exports.__createBinding||(Object.create?(function(e,t,n,r){r===void 0&&(r=n);var s=Object.getOwnPropertyDescriptor(t,n);(!s||("get"in s?!t.__esModule:s.writable||s.configurable))&&(s={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,s)}):(function(e,t,n,r){r===void 0&&(r=n),e[r]=t[n]})),oe=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),$=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var r=[];for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(r[r.length]=s);return r},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var r=e(t),s=0;s<r.length;s++)r[s]!=="default"&&re(n,t,r[s]);return oe(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.CliSessionServer=void 0,exports.runSessionServerCli=Be;const D=$(require("node:fs")),se=$(require("node:http")),ie=require("../config/product-storage"),ae=require("../shared/agent-text"),ce=require("../shared/event-loop"),h=require("../shared/errors"),I=require("../shared/metrics"),ue=require("../shared/stdout"),j=require("../shared/presentation"),le=require("../tracing/trace"),A=require("../runtime/run-command"),de=require("../config/resolve-command-alias"),x=require("../config/auto-start-ide"),o=require("../config/env-vars"),me=require("../client/transport-options"),L=require("./paths"),H=require("./daemon-state"),b=require("../commands/module-plan-cache"),fe=require("../commands/execution-command"),O=require("../payloads/read-stdin-json"),F=require("../commands/module-plan-timeout"),S=require("../diagnostics/module-plan-timeline"),U=require("../commands/mutation-execution-cache"),Ie=require("../rg-wrapper/core"),pe=require("../rg-wrapper/options"),w=require("../rtk-wrapper/core"),ge=!1,Se=!1;function he(e){D.mkdirSync((0,L.getSessionDir)(),{recursive:!0}),G((0,L.getSessionInfoPath)(),JSON.stringify(e,null,2)),G((0,L.getSessionUrlPath)(),`${e.url}
-`)}function _e(){D.rmSync((0,L.getSessionInfoPath)(),{force:!0}),D.rmSync((0,L.getSessionUrlPath)(),{force:!0})}function G(e,t){const n=`${e}.${process.pid}.tmp`;D.writeFileSync(n,t),D.renameSync(n,e)}async function q(e){const t=[];for await(const n of e)t.push(Buffer.isBuffer(n)?n:Buffer.from(String(n)));return Buffer.concat(t).toString("utf8")}function _(e,t,n){const r=JSON.stringify(n,null,2);e.writeHead(t,{"content-type":"application/json; charset=utf-8","content-length":Buffer.byteLength(r)}),e.end(r)}function ye(e){const t=new Set(["NO_COLOR","CLICOLOR","CLICOLOR_FORCE","TERM","RG_CONFIG_PATH","RIPGREP_CONFIG_PATH","AIB_RG_TRIM_SPACES","AIB_RG_ALIASES",o.CLI_ENV.rgPath,o.CLI_ENV.rtkPath,o.CLI_ENV.productStorageDir,o.CLI_ENV.helpShell]),n={};for(const[r,s]of e.entries()){if(!r.startsWith("env."))continue;const a=r.slice(4);t.has(a)&&(n[a]=s)}return n}function Ee(e){if((0,w.isRtkPassthroughCommand)(e.command))return(0,w.runRtkPassthrough)({tool:e.command,args:e.restArgs,cwd:e.cwd,env:{...process.env,...e.env},...e.stdinText!==void 0?{stdinText:e.stdinText}:{}});if(e.command!=="rg")throw new h.CliError("UNSUPPORTED_EXEC_COMMAND",`Unsupported exec command: ${e.command}`,{supported:["rg --",...w.RTK_PASSTHROUGH_COMMANDS.map(t=>`${t} --`)]});return(0,Ie.runBrgFormatted)({args:e.restArgs,cwd:e.cwd,env:{...process.env,...e.env},...e.stdinText!==void 0?{stdinText:e.stdinText}:{}},(0,pe.resolveBrgFormatOptions)(e.cwd,e.restArgs,{...process.env,...e.env}))}function R(e,t){if(e.destroyed||e.writableEnded)return;e.write(`${JSON.stringify(t)}
-`);const n=e;typeof n.flush=="function"&&n.flush()}function Me(e,t,n,r){if(e!==null)return(0,O.parseStdinPayload)(e,{command:t,restArgs:n,...r!==void 0?{format:r}:{}})}function Pe(e,t,n,r){if(e!==null)return(0,O.parseInputPayloadWithSource)(e,{command:t,restArgs:n,...r!==void 0?{format:r}:{}}).source}function Ce(e){if(e==null)return;if(!e||typeof e!="object"||Array.isArray(e))throw new h.CliError("INVALID_SESSION_REQUEST","Invalid stdin input source.");const t=e;if(t.format!=="json"&&t.format!=="dsl"||typeof t.text!="string")throw new h.CliError("INVALID_SESSION_REQUEST","Invalid stdin input source.");return{format:t.format,text:t.text}}function J(e){if(e==null||e==="")return;const t=(0,me.parseExtensionTransport)(e);if(!t)throw new h.CliError("INVALID_TRANSPORT","Expected transport to be either http or websocket.");return t}function ve(e){if(!e||typeof e!="object"||Array.isArray(e))return{};const t=new Set([o.CLI_ENV.managedHostScript,o.CLI_ENV.managedHostKind,o.CLI_ENV.managedHostRunDir,o.CLI_ENV.codeServerPath,o.CLI_ENV.extensionVsix,o.CLI_ENV.ideCommand,o.CLI_ENV.chromePath,o.CLI_ENV.managedHostWaitMs,o.CLI_ENV.workspaceRoot,o.CLI_ENV.helpShell,o.CLI_ENV.disableWatchers,o.CLI_ENV.trace,o.CLI_ENV.traceDir,o.CLI_ENV.failureSnapshots,o.CLI_ENV.productStorageDir,o.CLI_ENV.metrics,o.CLI_ENV.metricsDir,o.CLI_ENV.metricsTag,o.CLI_ENV.mutationImpactMetrics,o.CLI_ENV.mutationImpactStream,o.CLI_ENV.testMoveToFileFailEntity,o.CLI_ENV.testPostMutationCyclesDelayMs,o.CLI_ENV.testRefactorBatchDelayMs,o.CLI_ENV.testRenameDelayMs,o.CLI_ENV.testFileMoveToDirDelayMs,o.CLI_ENV.testFileMoveToDirRowDelayMs,o.CLI_ENV.testFileMoveToDirImportsDelayMs,o.CLI_ENV.testFileMoveToDirFailImports,o.CLI_ENV.testFileRenameDelayMs,o.CLI_ENV.testFileRenameRowDelayMs,o.CLI_ENV.testFileRenameImportsDelayMs,o.CLI_ENV.testFileRenameFailImports,o.CLI_ENV.testFileRefactorBatchDelayMs,o.CLI_ENV.testFileRefactorBatchRowDelayMs,o.CLI_ENV.testFileRefactorBatchImportsDelayMs,o.CLI_ENV.testFileRefactorBatchFailImports,o.CLI_ENV.disableFileMutationImportPostProcess,o.CLI_ENV.disableFileMoveImportPostProcess,o.CLI_ENV.modulePlanSyncWaitMs,o.CLI_ENV.refactorBatchSyncWaitMs,o.CLI_ENV.renameSyncWaitMs,o.CLI_ENV.fileMoveToDirSyncWaitMs,o.CLI_ENV.fileRenameSyncWaitMs,o.CLI_ENV.fileRefactorBatchSyncWaitMs,o.CLI_ENV.modulePlanDebugTimeline]),n={};for(const[r,s]of Object.entries(e))t.has(r)&&typeof s=="string"&&(n[r]=s);return n}async function B(e,t){const n=Object.entries(e);if(n.length===0)return t();const r=new Map;for(const[s,a]of n)r.set(s,process.env[s]),process.env[s]=a;try{return await t()}finally{for(const[s,a]of r)a===void 0?delete process.env[s]:process.env[s]=a}}function K(e,t){e.setHeader("x-aib-execution-mode",t)}async function Q(e,t,n){return(0,S.recordModulePlanTimeline)(e.cwd,e.modulePlanExecutionId,"session.deadline.wait.start",{deadlineMs:n}),(0,U.waitForMutationDeadline)(t.then(r=>((0,S.recordModulePlanTimeline)(e.cwd,e.modulePlanExecutionId,"session.deadline.runPromise.resolved"),r)),n,()=>(0,S.recordModulePlanTimeline)(e.cwd,e.modulePlanExecutionId,"session.deadline.timer.fired",{deadlineMs:n}))}function z(e){if(e.command!=="modulePlan")return 0;const t=e.restArgs[0]??"";return t!=="execute"&&t!=="apply"?0:(0,U.readMutationSyncWaitMs)(process.env[o.CLI_ENV.modulePlanSyncWaitMs],12e4)}async function X(e,t){const n=e.modulePlanExecutionId??"last";await(0,ce.yieldToEventLoop)();let r;try{(0,S.recordModulePlanTimeline)(e.cwd,n,"session.inProgress.status.read.start",{elapsedMs:t}),r=(0,fe.runExecutionCommand)(e.cwd,["status",n]),(0,S.recordModulePlanTimeline)(e.cwd,n,"session.inProgress.status.read.end",{status:typeof r.status=="string"?r.status:null,phase:typeof r.phase=="string"?r.phase:null,summary:typeof r.summary=="string"?r.summary:null})}catch{(0,S.recordModulePlanTimeline)(e.cwd,n,"session.inProgress.status.read.failed",{elapsedMs:t}),r={operation:"execution.status",executionId:n,status:"running",summary:"in progress"}}const s=ne(e),a=s?s.estimatedDurationMs-t:null,i=we(r,e,a);return(0,ae.attachAgentText)({...r,operation:r.operation??"execution.status",executionId:n,status:r.status??"running",...a!==null?{estimatedRemainingMs:Math.max(0,a)}:{}},i)}function we(e,t,n){const r=typeof e.executionId=="string"?e.executionId:t.modulePlanExecutionId??"last",a=[`modulePlan.${t.restArgs[0]??"execute"} ${r}`];return typeof e.summary=="string"&&e.summary.length>0&&a.push(e.summary),e.phase==="preview"&&a.push("previewing plan"),e.phase==="mutation"&&a.push("applying mutation"),e.phase==="postMutation.cycles"&&(a.push("mutation completed"),a.push("checking cycles")),n!==null&&a.push(n>0?`estimated remaining: ${(0,F.formatModulePlanTimeoutEstimate)(Math.max(n,5e3))}`:"estimated remaining: check status again soon"),a.join(`
-`)}class Y{server;daemonId=`${process.pid}-${Date.now().toString(36)}`;daemonStartedAt=new Date().toISOString();daemonPackage=(0,H.currentCliDaemonPackage)();runningExecutions=new Map;activeInvokeCount=0;heartbeatTimer=null;constructor(){this.server=se.createServer((t,n)=>{this.handleRequest(t,n)})}async handleRequest(t,n){if(t.method==="GET"&&t.url==="/health"){_(n,200,{ok:!0,pid:process.pid});return}if(t.method==="POST"&&t.url==="/run")try{const r=await q(t),s=r?JSON.parse(r):{};if(typeof s.command!="string"||!Array.isArray(s.restArgs)||typeof s.cwd!="string")throw new h.CliError("INVALID_SESSION_REQUEST","Invalid session request payload.");const a=Ce(s.stdinInputSource),i={command:s.command,restArgs:s.restArgs.filter(f=>typeof f=="string"),cwd:s.cwd,stdinPayload:s.stdinPayload,metricsEnabled:s.metricsEnabled===!0};a!==void 0&&(i.stdinInputSource=a);const c=J(s.transport),u=ve(s.env);c&&(i.transport=c),i.autoStartIde=(0,x.autoStartIdePolicyFromSession)(s.autoStartIde)??(0,x.resolveAutoStartIdePolicy)();const d=i.metricsEnabled?[]:void 0;d&&(i.metricsSpans=d),typeof s.instanceId=="string"&&(i.instanceId=s.instanceId),typeof s.sessionId=="string"&&(i.sessionId=s.sessionId),typeof s.modulePlanExecutionId=="string"&&(i.modulePlanExecutionId=s.modulePlanExecutionId),s.suppressModulePlanStreamStart===!0&&(i.suppressModulePlanStreamStart=!0);const M=(0,I.metricsNow)(),P=this.beginInvocation(i),E=B(u,()=>(0,A.runCommand)(i)).then(f=>((0,I.recordSpan)(d,"session.runCommand",M),f),f=>{throw(0,I.recordSpan)(d,"session.runCommand",M),f}).finally(P),m=z(i);if(m>0){const f=await Q(i,E,m);if(f.status==="deadline"){E.catch(()=>{}),(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.deadline.output.start",{deadlineMs:m});const p=await X(i,m);(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.response.write.start",{mode:"deadline"}),_(n,200,p),(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.response.write.end",{mode:"deadline"});return}const l=f.result;(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.response.write.start",{mode:"result"}),_(n,200,d?(0,I.appendMetrics)(l,d):l),(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.response.write.end",{mode:"result"});return}const C=await E;(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.response.write.start",{mode:"no-deadline"}),_(n,200,d?(0,I.appendMetrics)(C,d):C),(0,S.recordModulePlanTimeline)(i.cwd,i.modulePlanExecutionId,"session.run.response.write.end",{mode:"no-deadline"});return}catch(r){_(n,500,(0,h.errorPayload)(r));return}if(t.method==="POST"&&t.url==="/invoke"){let r=null,s=null,a=0,i=null;try{const c=await q(t);i=await Le(c);const u=ee(i.input);if(K(n,u),u==="process"){const l=this.beginInvocation(i.input),p=Ne(()=>Ee(Te(i)),l);_(n,200,p);return}if(u==="stream"){De(n),a=Date.now(),s=te(i,a),r=Ve(n,i.input);const l=i.env,p=(0,I.metricsNow)(),g=this.beginInvocation(i.input),y=await B(l,()=>(0,A.runCommand)(i.input)).then(V=>((0,I.recordSpan)(i.spans,"session.runCommand",p),V),V=>{throw(0,I.recordSpan)(i.spans,"session.runCommand",p),V}).finally(g),k=T(i.spans?(0,I.appendMetrics)(y,i.spans):y);N(s,i,k,0,a),R(n,{type:"result",payload:k}),n.end();return}a=Date.now(),s=te(i,a);const d=i.env,M=(0,I.metricsNow)(),P=this.beginInvocation(i.input),E=B(d,()=>(0,A.runCommand)(i.input)).then(l=>((0,I.recordSpan)(i.spans,"session.runCommand",M),l),l=>{throw(0,I.recordSpan)(i.spans,"session.runCommand",M),l}).finally(P),m=z(i.input);if(m>0){const l=await Q(i.input,E,m);if(l.status==="deadline"){E.catch(()=>{});const v=T(await X(i.input,m));N(s,i,v,0,a),_(n,200,v);return}const p=l.result,g=T(i.spans?(0,I.appendMetrics)(p,i.spans):p);N(s,i,g,0,a),_(n,200,g);return}const C=await E,f=T(i.spans?(0,I.appendMetrics)(C,i.spans):C);N(s,i,f,0,a),_(n,200,f);return}catch(c){const u=T((0,h.errorPayload)(c));if(!n.headersSent){K(n,"structured"),_(n,500,u);return}if(n.getHeader("x-aib-execution-mode")==="stream"){N(s,i,u,1,a),R(n,{type:"error",payload:u}),n.end();return}N(s,i,u,1,a),_(n,500,u);return}finally{r&&clearInterval(r)}}_(n,404,{ok:!1,error:"Not found"})}async serve(){await new Promise((s,a)=>{this.server.once("error",a),this.server.listen(0,"127.0.0.1",()=>s())});const t=this.server.address();if(!t||typeof t=="string")throw new Error("Failed to determine aib session address.");he({pid:process.pid,host:"127.0.0.1",port:t.port,url:`http://127.0.0.1:${t.port}`,startedAt:new Date().toISOString()}),this.writeDaemonState("running"),this.heartbeatTimer=setInterval(()=>this.writeDaemonState("running"),1e4),this.heartbeatTimer.unref();let n=!1;const r=()=>{n||(n=!0,this.heartbeatTimer&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=null),this.writeDaemonState("stopped"),_e(),this.server.close(()=>{process.exit(0)}),setTimeout(()=>{process.exit(0)},1e3).unref())};process.on("SIGTERM",r),process.on("SIGINT",r),await new Promise(()=>{})}beginInvocation(t){this.activeInvokeCount+=1;const n=typeof t.modulePlanExecutionId=="string"?t.modulePlanExecutionId:null;n&&this.runningExecutions.set(n,{executionId:n,command:`${t.command} ${t.restArgs.join(" ")}`.trim(),startedAt:new Date().toISOString()}),this.writeDaemonState("running");let r=!1;return()=>{r||(r=!0,this.activeInvokeCount=Math.max(0,this.activeInvokeCount-1),n&&this.runningExecutions.delete(n),this.writeDaemonState("running"))}}writeDaemonState(t){(0,H.writeCliDaemonIdentity)((0,ie.productStorageRoot)(),{schemaVersion:1,daemonId:this.daemonId,pid:process.pid,status:t,startedAt:this.daemonStartedAt,updatedAt:new Date().toISOString(),heartbeatAt:new Date().toISOString(),invokeProtocol:"http-session-v1",supportedModes:["structured","process","stream"],activeInvokeCount:this.activeInvokeCount,runningExecutions:Array.from(this.runningExecutions.values()),cliPath:this.daemonPackage.cliPath,packageRoot:this.daemonPackage.packageRoot})}}exports.CliSessionServer=Y;function Ne(e,t){try{return e()}finally{t()}}function Z(e){return e.command==="diagnostics"&&e.restArgs[0]==="timeout-stream"}function De(e){e.writeHead(200,{"content-type":"application/x-ndjson; charset=utf-8","cache-control":"no-cache","x-accel-buffering":"no"}),e.flushHeaders()}async function Le(e){const t=new URLSearchParams(e);return{...await Re(t,{invokeGate:!0}),params:t}}async function Re(e,t={}){const n=e.get("command")??e.get("method")??"",r=e.get("cwd")??"",s=e.get("instanceId")??void 0,a=e.get("sessionId")??void 0,i=e.get("modulePlanExecutionId")??void 0,c=e.get("suppressModulePlanStreamStart")==="true",u=e.get("metricsEnabled")==="true",d=J(e.get("transport")),M=(0,x.autoStartIdePolicyFromSession)(e.get("autoStartIde"))??(0,x.resolveAutoStartIdePolicy)(),P=Fe(e.get("traceDir")),E=xe(e);if(!n.trim())throw new h.CliError("MISSING_COMMAND","Missing command.");if(!r.trim())throw new h.CliError("MISSING_CWD","Missing cwd.");const m=u?[]:void 0,C=(0,I.metricsNow)(),f=await(0,de.resolveCanonicalCommandAlias)(n.trim(),r,s,M);(0,I.recordSpan)(m,"session.aliasResolution",C);const l=(0,O.stripStdinFormatFlags)(e.getAll("arg")),p=l.restArgs,g={command:f,restArgs:p,cwd:r,metricsEnabled:u,autoStartIde:M};if(d&&(g.transport=d),s&&(g.instanceId=s),a&&(g.sessionId=a),i&&(g.modulePlanExecutionId=i),c&&(g.suppressModulePlanStreamStart=!0),m&&(g.metricsSpans=m),t.streamGate===!0&&!Z(g)||t.invokeGate===!0&&ee(g)==="process")return{input:g,spans:m,...P!==void 0?{traceDir:P}:{},env:E};const v=Pe(e.get("stdin"),f,p,l.format),y={command:f,restArgs:p,cwd:r,stdinPayload:Me(e.get("stdin"),f,p,l.format),metricsEnabled:u,autoStartIde:M};return v!==void 0&&(y.stdinInputSource=v),d&&(y.transport=d),s&&(y.instanceId=s),a&&(y.sessionId=a),i&&(y.modulePlanExecutionId=i),c&&(y.suppressModulePlanStreamStart=!0),m&&(y.metricsSpans=m),{input:y,spans:m,...P!==void 0?{traceDir:P}:{},env:E}}function ee(e){return e.command==="rg"&&e.restArgs[0]==="--"||(0,w.isRtkPassthroughCommand)(e.command)&&e.restArgs[0]==="--"?"process":Z(e)?"stream":"structured"}function Te(e){if(!((e.input.command==="rg"||(0,w.isRtkPassthroughCommand)(e.input.command))&&e.input.restArgs[0]==="--"))throw new h.CliError("UNSUPPORTED_INVOKE_PROCESS_COMMAND",`Unsupported process invocation: ${e.input.command}`,{supported:["rg --",...w.RTK_PASSTHROUGH_COMMANDS.map(r=>`${r} --`)]});const n={command:e.input.command,restArgs:e.input.restArgs.slice(1),cwd:e.input.cwd,env:ye(e.params)};return e.params.has("stdin")&&(n.stdinText=e.params.get("stdin")??""),n}function xe(e){const t={},n=[[o.CLI_ENV.metrics,e.get("metrics")??""],[o.CLI_ENV.metricsDir,e.get("metricsDir")??""],[o.CLI_ENV.metricsTag,e.get("metricsTag")??""],[o.CLI_ENV.mutationImpactMetrics,e.get("mutationImpactMetrics")??""],[o.CLI_ENV.mutationImpactStream,e.get("mutationImpactStream")??""],[o.CLI_ENV.testMoveToFileFailEntity,e.get("testMoveToFileFailEntity")??""],[o.CLI_ENV.testPostMutationCyclesDelayMs,e.get("testPostMutationCyclesDelayMs")??""],[o.CLI_ENV.testRefactorBatchDelayMs,e.get("testRefactorBatchDelayMs")??""],[o.CLI_ENV.testRenameDelayMs,e.get("testRenameDelayMs")??""],[o.CLI_ENV.testFileMoveToDirDelayMs,e.get("testFileMoveToDirDelayMs")??""],[o.CLI_ENV.testFileMoveToDirRowDelayMs,e.get("testFileMoveToDirRowDelayMs")??""],[o.CLI_ENV.testFileMoveToDirImportsDelayMs,e.get("testFileMoveToDirImportsDelayMs")??""],[o.CLI_ENV.testFileMoveToDirFailImports,e.get("testFileMoveToDirFailImports")??""],[o.CLI_ENV.testFileRenameDelayMs,e.get("testFileRenameDelayMs")??""],[o.CLI_ENV.testFileRenameRowDelayMs,e.get("testFileRenameRowDelayMs")??""],[o.CLI_ENV.testFileRenameImportsDelayMs,e.get("testFileRenameImportsDelayMs")??""],[o.CLI_ENV.testFileRenameFailImports,e.get("testFileRenameFailImports")??""],[o.CLI_ENV.testFileRefactorBatchDelayMs,e.get("testFileRefactorBatchDelayMs")??""],[o.CLI_ENV.testFileRefactorBatchRowDelayMs,e.get("testFileRefactorBatchRowDelayMs")??""],[o.CLI_ENV.testFileRefactorBatchImportsDelayMs,e.get("testFileRefactorBatchImportsDelayMs")??""],[o.CLI_ENV.testFileRefactorBatchFailImports,e.get("testFileRefactorBatchFailImports")??""],[o.CLI_ENV.disableFileMutationImportPostProcess,e.get("disableFileMutationImportPostProcess")??""],[o.CLI_ENV.disableFileMoveImportPostProcess,e.get("disableFileMoveImportPostProcess")??""],[o.CLI_ENV.modulePlanSyncWaitMs,e.get("modulePlanSyncWaitMs")??""],[o.CLI_ENV.refactorBatchSyncWaitMs,e.get("refactorBatchSyncWaitMs")??""],[o.CLI_ENV.renameSyncWaitMs,e.get("renameSyncWaitMs")??""],[o.CLI_ENV.fileMoveToDirSyncWaitMs,e.get("fileMoveToDirSyncWaitMs")??""],[o.CLI_ENV.fileRenameSyncWaitMs,e.get("fileRenameSyncWaitMs")??""],[o.CLI_ENV.fileRefactorBatchSyncWaitMs,e.get("fileRefactorBatchSyncWaitMs")??""],[o.CLI_ENV.modulePlanDebugTimeline,e.get("modulePlanDebugTimeline")??""],[o.CLI_ENV.trace,e.get("trace")??""],[o.CLI_ENV.failureSnapshots,e.get("failureSnapshots")??""],[o.CLI_ENV.productStorageDir,e.get("productStorageDir")??""],[o.CLI_ENV.helpShell,e.get(`env.${o.CLI_ENV.helpShell}`)??""]];for(const[r,s]of n){const a=s.trim();a&&(t[r]=a)}return t}function Fe(e){if(e===null)return;const t=e.trim();return t||void 0}function te(e,t){return e.traceDir?(0,le.startTrace)({cwd:e.input.cwd,argv:[e.input.command,...e.input.restArgs],command:e.input.command,restArgs:e.input.restArgs,...e.input.stdinPayload!==void 0?{stdinPayload:e.input.stdinPayload}:{},...e.input.stdinInputSource!==void 0?{stdinSource:e.input.stdinInputSource}:{},traceDir:e.traceDir,startedAtMs:t}):null}function N(e,t,n,r,s){if(!e?.enabled||!t)return;const a=(0,j.createCliPresentationEnvelope)(n);e.complete({output:a.tracePayload,stdoutText:a.text?`${a.text.trimEnd()}
-`:`${JSON.stringify(a.tracePayload,null,2)}
-`,exitCode:n.ok===!1?1:r,durationMs:Date.now()-s,...t.input.transport?{transport:t.input.transport}:{}})}function T(e){return(0,j.createCliPresentationEnvelope)(e).payload}function Ve(e,t){if(!be(t))return null;const n=t.modulePlanExecutionId??(0,b.buildModulePlanExecutionId)();t.modulePlanExecutionId=n;const r=Date.now(),s=ne(t),a=s?`
-estimated: ${(0,F.formatModulePlanTimeoutEstimate)(s.estimatedDurationMs)}`:"";if(t.suppressModulePlanStreamStart||R(e,{type:"start",text:`modulePlan.${t.restArgs[0]??"execute"} ${n}${a}`,data:{operation:`modulePlan.${t.restArgs[0]??"execute"}`,executionId:n,...s?{estimatedTimeoutMs:s.recommendedTimeoutMs,estimatedDurationMs:s.estimatedDurationMs,suggestedFirstCheckMs:s.suggestedFirstCheckMs,rowCount:s.rowCount,symbolCount:s.symbolCount}:{}}}),!Se)return null;let i=r;return setInterval(()=>{try{const c=(0,b.readModulePlanExecutionStatus)(t.cwd,n),u=Date.parse(c.startedAt);if(Number.isFinite(u)&&u+1e3<r){i=W(e,i);return}if(!(c.completedRows>0||c.failedRows>0||c.filesWritten.length>0)){i=W(e,i);return}R(e,{type:"progress",text:`progress: ${c.completedRows}/${c.rowCount} rows${Ae(c.completedEntities,c.entityCount)}, ${c.filesWritten.length} files`,data:{operation:c.operation,executionId:c.executionId,status:c.status,completedRows:c.completedRows,failedRows:c.failedRows,rowCount:c.rowCount,completedEntities:c.completedEntities,entityCount:c.entityCount,filesWritten:c.filesWritten.length}})}catch{i=W(e,i)}},5e3)}function W(e,t){if(!ge)return t;const n=Date.now();return n-t<3e4?t:(R(e,{type:"progress",text:"modulePlan still running",data:{operation:"modulePlan",status:"running"}}),n)}function Ae(e,t){return!t||t<=0?"":`, ${Math.floor((e??0)/t*100)}% entities`}function be(e){if(e.command!=="modulePlan")return!1;const t=e.restArgs[0]??"";return t==="execute"||t==="apply"}function ne(e){const t=e.restArgs[0]??"";if(t==="execute")return(0,F.estimateModulePlanTimeoutFromRequest)(e.stdinPayload);if(t!=="apply")return null;const n=Oe(e.restArgs);if(!n)return null;try{return(0,F.estimateModulePlanTimeoutFromRequest)((0,b.readModulePlanRecord)(e.cwd,n).normalizedRequest)}catch{return null}}function Oe(e){const t=e.indexOf("--plan");if(t>=0){const r=e[t+1];return r&&!r.startsWith("--")?r:null}return e.slice(1).find(r=>!r.startsWith("--"))??null}async function Be(){const e=process.argv[3]||"status";if(e!=="serve"){(0,ue.printJson)((0,h.errorPayload)(new h.CliError("UNKNOWN_SESSION_COMMAND",`Unknown aib session command: ${e}`))),process.exitCode=1;return}await new Y().serve()}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliSessionServer = void 0;
+exports.runSessionServerCli = runSessionServerCli;
+const fs = __importStar(require("node:fs"));
+const http = __importStar(require("node:http"));
+const product_storage_1 = require("../config/product-storage");
+const request_routing_context_1 = require("../config/request-routing-context");
+const workspace_root_1 = require("../config/workspace-root");
+const agent_text_1 = require("../shared/agent-text");
+const event_loop_1 = require("../shared/event-loop");
+const errors_1 = require("../shared/errors");
+const metrics_1 = require("../shared/metrics");
+const stdout_1 = require("../shared/stdout");
+const presentation_1 = require("../shared/presentation");
+const trace_1 = require("../tracing/trace");
+const run_command_1 = require("../runtime/run-command");
+const resolve_command_alias_1 = require("../config/resolve-command-alias");
+const env_vars_1 = require("../config/env-vars");
+const paths_1 = require("./paths");
+const lane_owner_1 = require("./lane-owner");
+const daemon_state_1 = require("./daemon-state");
+const module_plan_cache_1 = require("../commands/module-plan-cache");
+const execution_command_1 = require("../commands/execution-command");
+const read_stdin_json_1 = require("../payloads/read-stdin-json");
+const module_plan_timeout_1 = require("../commands/module-plan-timeout");
+const module_plan_timeline_1 = require("../diagnostics/module-plan-timeline");
+const mutation_execution_cache_1 = require("../commands/mutation-execution-cache");
+const mutation_eta_1 = require("../commands/mutation-eta");
+const core_1 = require("../rtk-wrapper/core");
+const workspace_semantic_context_pools_1 = require("../semantic/workspace-semantic-context-pools");
+const semantic_worker_manager_1 = require("../semantic/semantic-worker-manager");
+const lexical_worker_manager_1 = require("../workers/lexical-worker-manager");
+const external_tool_coordinator_1 = require("./external-tool-coordinator");
+const runtime_lifecycle_1 = require("./runtime-lifecycle");
+const runtime_shutdown_1 = require("./runtime-shutdown");
+const session_health_1 = require("./session-health");
+const external_tool_request_1 = require("./external-tool-request");
+const MODULE_PLAN_HEARTBEAT_ENABLED = false;
+const MODULE_PLAN_PROGRESS_STREAM_ENABLED = false;
+function writeSessionInfo(info) {
+    fs.mkdirSync((0, paths_1.getSessionDir)(), { recursive: true });
+    atomicWriteText((0, paths_1.getSessionInfoPath)(), JSON.stringify(info, null, 2));
+    atomicWriteText((0, paths_1.getSessionUrlPath)(), `${info.url}\n`);
+}
+function removeSessionInfo(ownerPid = process.pid) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync((0, paths_1.getSessionInfoPath)(), "utf8"));
+        if (parsed.pid !== ownerPid)
+            return;
+    }
+    catch {
+        return;
+    }
+    fs.rmSync((0, paths_1.getSessionInfoPath)(), { force: true });
+    fs.rmSync((0, paths_1.getSessionUrlPath)(), { force: true });
+}
+function atomicWriteText(filePath, text) {
+    const tmpPath = `${filePath}.${process.pid}.tmp`;
+    fs.writeFileSync(tmpPath, text);
+    fs.renameSync(tmpPath, filePath);
+}
+async function collectRequestBody(request) {
+    const chunks = [];
+    for await (const chunk of request) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function writeJson(response, statusCode, payload) {
+    const body = JSON.stringify(payload, null, 2);
+    response.writeHead(statusCode, {
+        "content-type": "application/json; charset=utf-8",
+        "content-length": Buffer.byteLength(body)
+    });
+    response.end(body);
+}
+function parseExecEnv(params) {
+    const allowed = new Set([
+        "NO_COLOR",
+        "CLICOLOR",
+        "CLICOLOR_FORCE",
+        "TERM",
+        "RG_CONFIG_PATH",
+        "RIPGREP_CONFIG_PATH",
+        "AIB_RG_TRIM_SPACES",
+        "AIB_RG_ALIASES",
+        env_vars_1.CLI_ENV.rgPath,
+        env_vars_1.CLI_ENV.rtkPath,
+        env_vars_1.CLI_ENV.tscPath,
+        env_vars_1.CLI_ENV.workspaceRoot,
+        env_vars_1.CLI_ENV.productStorageDir,
+        env_vars_1.CLI_ENV.helpShell
+    ]);
+    const env = {};
+    for (const [key, value] of params.entries()) {
+        if (!key.startsWith("env.")) {
+            continue;
+        }
+        const envName = key.slice("env.".length);
+        if (allowed.has(envName)) {
+            env[envName] = value;
+        }
+    }
+    return env;
+}
+function writeStreamEvent(response, event) {
+    if (response.destroyed || response.writableEnded) {
+        return;
+    }
+    response.write(`${JSON.stringify(event)}\n`);
+    const flushable = response;
+    if (typeof flushable.flush === "function") {
+        flushable.flush();
+    }
+}
+function parseCliStdinPayload(rawValue, command, restArgs, format) {
+    if (rawValue === null) {
+        return undefined;
+    }
+    return (0, read_stdin_json_1.parseStdinPayload)(rawValue, {
+        command,
+        restArgs,
+        ...(format !== undefined ? { format } : {})
+    });
+}
+function parseCliStdinInputSource(rawValue, command, restArgs, format) {
+    if (rawValue === null) {
+        return undefined;
+    }
+    return (0, read_stdin_json_1.parseInputPayloadWithSource)(rawValue, {
+        command,
+        restArgs,
+        ...(format !== undefined ? { format } : {})
+    }).source;
+}
+function parseSessionInputSource(rawValue) {
+    if (rawValue === undefined || rawValue === null) {
+        return undefined;
+    }
+    if (!rawValue || typeof rawValue !== "object" || Array.isArray(rawValue)) {
+        throw new errors_1.CliError("INVALID_SESSION_REQUEST", "Invalid stdin input source.");
+    }
+    const source = rawValue;
+    if ((source.format !== "json" && source.format !== "dsl") || typeof source.text !== "string") {
+        throw new errors_1.CliError("INVALID_SESSION_REQUEST", "Invalid stdin input source.");
+    }
+    return {
+        format: source.format,
+        text: source.text
+    };
+}
+function parseSessionEnv(rawValue) {
+    if (!rawValue || typeof rawValue !== "object" || Array.isArray(rawValue)) {
+        return {};
+    }
+    const allowed = new Set([
+        env_vars_1.CLI_ENV.workspaceRoot,
+        env_vars_1.CLI_ENV.helpShell,
+        env_vars_1.CLI_ENV.disableWatchers,
+        env_vars_1.CLI_ENV.trace,
+        env_vars_1.CLI_ENV.traceDir,
+        env_vars_1.CLI_ENV.failureSnapshots,
+        env_vars_1.CLI_ENV.productStorageDir,
+        env_vars_1.CLI_ENV.metrics,
+        env_vars_1.CLI_ENV.metricsDir,
+        env_vars_1.CLI_ENV.metricsTag,
+        env_vars_1.CLI_ENV.mutationImpactMetrics,
+        env_vars_1.CLI_ENV.mutationImpactStream,
+        env_vars_1.CLI_ENV.testMoveToFileFailEntity,
+        env_vars_1.CLI_ENV.testPostMutationCyclesDelayMs,
+        env_vars_1.CLI_ENV.testRefactorBatchDelayMs,
+        env_vars_1.CLI_ENV.testRenameDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirRowDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileMoveToDirFailImports,
+        env_vars_1.CLI_ENV.testFileRenameDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameRowDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileRenameFailImports,
+        env_vars_1.CLI_ENV.testFileRefactorBatchDelayMs,
+        env_vars_1.CLI_ENV.testFileRefactorBatchRowDelayMs,
+        env_vars_1.CLI_ENV.testFileRefactorBatchImportsDelayMs,
+        env_vars_1.CLI_ENV.testFileRefactorBatchFailImports,
+        env_vars_1.CLI_ENV.testFileRefactorBatchCrashAfterFsMove,
+        env_vars_1.CLI_ENV.testMutateDelayMs,
+        env_vars_1.CLI_ENV.testInspectWorkerFailure,
+        env_vars_1.CLI_ENV.disableFileMutationImportPostProcess,
+        env_vars_1.CLI_ENV.disableFileMoveImportPostProcess,
+        env_vars_1.CLI_ENV.modulePlanSyncWaitMs,
+        env_vars_1.CLI_ENV.refactorBatchSyncWaitMs,
+        env_vars_1.CLI_ENV.renameSyncWaitMs,
+        env_vars_1.CLI_ENV.fileMoveToDirSyncWaitMs,
+        env_vars_1.CLI_ENV.fileRenameSyncWaitMs,
+        env_vars_1.CLI_ENV.fileRefactorBatchSyncWaitMs,
+        env_vars_1.CLI_ENV.mutateSyncWaitMs,
+        env_vars_1.CLI_ENV.modulePlanDebugTimeline,
+        env_vars_1.CLI_ENV.debugWorkspaceContext
+    ]);
+    const env = {};
+    for (const [key, value] of Object.entries(rawValue)) {
+        if (allowed.has(key) && typeof value === "string") {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+async function withLegacySessionEnv(env, fn) {
+    const entries = Object.entries(env);
+    if (entries.length === 0) {
+        return fn();
+    }
+    const previous = new Map();
+    for (const [key, value] of entries) {
+        previous.set(key, process.env[key]);
+        process.env[key] = value;
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        for (const [key, value] of previous) {
+            if (value === undefined) {
+                delete process.env[key];
+            }
+            else {
+                process.env[key] = value;
+            }
+        }
+    }
+}
+async function withSessionRequestContext(cwd, env, fn) {
+    const legacyEnv = { ...env };
+    delete legacyEnv[env_vars_1.CLI_ENV.workspaceRoot];
+    delete legacyEnv[env_vars_1.CLI_ENV.productStorageDir];
+    return (0, request_routing_context_1.runWithRequestRoutingContext)(cwd, env, () => withLegacySessionEnv(legacyEnv, fn));
+}
+function writeInvokeModeHeader(response, mode) {
+    response.setHeader("x-aib-execution-mode", mode);
+}
+async function waitForSessionMutationDeadline(input, runPromise, deadlineMs) {
+    (0, module_plan_timeline_1.recordModulePlanTimeline)(input.cwd, input.modulePlanExecutionId, "session.deadline.wait.start", { deadlineMs });
+    return (0, mutation_execution_cache_1.waitForMutationDeadline)(runPromise.then((result) => {
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(input.cwd, input.modulePlanExecutionId, "session.deadline.runPromise.resolved");
+        return result;
+    }), deadlineMs, () => (0, module_plan_timeline_1.recordModulePlanTimeline)(input.cwd, input.modulePlanExecutionId, "session.deadline.timer.fired", { deadlineMs }));
+}
+function readSessionMutationSyncWaitMs(input) {
+    if (!isSessionModulePlanMutation(input)) {
+        return 0;
+    }
+    return (0, mutation_execution_cache_1.readMutationSyncWaitMs)(process.env[env_vars_1.CLI_ENV.modulePlanSyncWaitMs], 120_000);
+}
+async function buildModulePlanInProgressOutput(input, elapsedMs) {
+    const executionId = input.modulePlanExecutionId ?? "last";
+    await (0, event_loop_1.yieldToEventLoop)();
+    let output;
+    try {
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(input.cwd, executionId, "session.inProgress.status.read.start", { elapsedMs });
+        output = (0, execution_command_1.runExecutionCommand)(input.cwd, ["status", executionId]);
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(input.cwd, executionId, "session.inProgress.status.read.end", {
+            status: typeof output.status === "string" ? output.status : null,
+            phase: typeof output.phase === "string" ? output.phase : null,
+            summary: typeof output.summary === "string" ? output.summary : null
+        });
+    }
+    catch {
+        (0, module_plan_timeline_1.recordModulePlanTimeline)(input.cwd, executionId, "session.inProgress.status.read.failed", { elapsedMs });
+        output = {
+            operation: "execution.status",
+            executionId,
+            status: "running",
+            summary: "in progress"
+        };
+    }
+    const estimate = estimateModulePlanTimeoutForStream(input);
+    const estimatedRemainingMs = estimate
+        ? estimate.estimatedDurationMs - elapsedMs
+        : null;
+    const eta = estimatedRemainingMs !== null
+        ? (0, mutation_eta_1.buildMutationEtaHint)(executionId, estimatedRemainingMs)
+        : null;
+    const text = formatModulePlanInProgressText(output, input, eta);
+    return (0, agent_text_1.attachAgentText)({
+        ...output,
+        operation: output.operation ?? "execution.status",
+        executionId,
+        status: output.status ?? "running",
+        ...(eta ? {
+            estimatedRemainingMs: eta.estimatedRemainingMs,
+            suggestedFirstCheckMs: eta.suggestedFirstCheckMs,
+            next: eta.next
+        } : {})
+    }, text);
+}
+function formatModulePlanInProgressText(output, input, eta) {
+    const executionId = typeof output.executionId === "string"
+        ? output.executionId
+        : input.modulePlanExecutionId ?? "last";
+    const action = input.restArgs[0] ?? "execute";
+    const operation = input.command === "mutate" ? "mutate" : "modulePlan";
+    const lines = [
+        `${operation}.${action} ${executionId}`
+    ];
+    if (typeof output.summary === "string" && output.summary.length > 0) {
+        lines.push(output.summary);
+    }
+    if (output.phase === "preview") {
+        lines.push("previewing plan");
+    }
+    if (output.phase === "mutation") {
+        lines.push("applying mutation");
+    }
+    if (output.phase === "postMutation.cycles") {
+        lines.push("mutation completed");
+        lines.push("checking cycles");
+    }
+    if (eta) {
+        lines.push(...(0, mutation_eta_1.formatMutationEtaLines)(eta));
+    }
+    return lines.join("\n");
+}
+class CliSessionServer {
+    server;
+    daemonId = `${process.pid}-${Date.now().toString(36)}`;
+    daemonStartedAt = new Date().toISOString();
+    daemonPackage = (0, daemon_state_1.currentCliDaemonPackage)();
+    runningExecutions = new Map();
+    semanticContextPools = new workspace_semantic_context_pools_1.WorkspaceSemanticContextPools();
+    semanticWorker;
+    lexicalWorker;
+    externalTools = new external_tool_coordinator_1.ExternalToolCoordinator({ timeoutMs: readExternalToolTimeoutMs() });
+    runtimeLifecycle;
+    drainTimeoutMs = (0, runtime_lifecycle_1.readSessionDrainTimeoutMs)();
+    activeInvokeCount = 0;
+    heartbeatTimer = null;
+    shutdownPromise = null;
+    laneLease = null;
+    stoppedPromise;
+    resolveStopped;
+    constructor() {
+        this.stoppedPromise = new Promise((resolve) => { this.resolveStopped = resolve; });
+        const semanticWorkerMode = (0, semantic_worker_manager_1.readSemanticWorkerSessionMode)();
+        this.semanticWorker = semanticWorkerMode === "off"
+            ? null
+            : new semantic_worker_manager_1.SemanticWorkerManager({ executionMode: semanticWorkerMode, deadlineMs: (0, semantic_worker_manager_1.readSemanticWorkerDeadlineMs)() });
+        const lexicalWorkerMode = (0, lexical_worker_manager_1.readLexicalWorkerSessionMode)();
+        this.lexicalWorker = lexicalWorkerMode === "off"
+            ? null
+            : new lexical_worker_manager_1.LexicalWorkerManager({ mode: lexicalWorkerMode, deadlineMs: (0, lexical_worker_manager_1.readLexicalWorkerDeadlineMs)() });
+        this.runtimeLifecycle = new runtime_lifecycle_1.SessionRuntimeLifecycle({
+            idleTtlMs: (0, runtime_lifecycle_1.readSessionIdleTtlMs)(),
+            onIdle: () => this.shutdown("idle-ttl"),
+            externalRetainers: () => this.ownedResourceRetainers()
+        });
+        this.server = http.createServer((request, response) => {
+            if (request.method === "GET" && request.url === "/health") {
+                void this.handleRequest(request, response);
+                return;
+            }
+            let finishRequest = null;
+            try {
+                finishRequest = this.runtimeLifecycle.beginRequest();
+            }
+            catch (error) {
+                writeJson(response, 503, (0, errors_1.errorPayload)(error));
+                return;
+            }
+            void (0, runtime_lifecycle_1.runWithSessionRuntimeLifecycle)(this.runtimeLifecycle, () => this.handleRequest(request, response))
+                .finally(() => finishRequest?.());
+        });
+    }
+    async handleRequest(request, response) {
+        if (request.method === "GET" && request.url === "/health") {
+            writeJson(response, 200, (0, session_health_1.buildSessionHealthPayload)(process.pid, this.runtimeLifecycle.state));
+            return;
+        }
+        if (request.method === "POST" && request.url === "/shutdown") {
+            writeJson(response, 202, {
+                ok: true,
+                accepted: true,
+                pid: process.pid
+            });
+            setImmediate(() => { void this.shutdown("session-stop"); });
+            return;
+        }
+        if (request.method === "POST" && request.url === "/run") {
+            try {
+                const rawBody = await collectRequestBody(request);
+                const parsed = rawBody ? JSON.parse(rawBody) : {};
+                if (typeof parsed.command !== "string" ||
+                    !Array.isArray(parsed.restArgs) ||
+                    typeof parsed.cwd !== "string") {
+                    throw new errors_1.CliError("INVALID_SESSION_REQUEST", "Invalid session request payload.");
+                }
+                const stdinInputSource = parseSessionInputSource(parsed.stdinInputSource);
+                const runCommandInput = {
+                    command: parsed.command,
+                    restArgs: parsed.restArgs.filter((item) => typeof item === "string"),
+                    cwd: parsed.cwd,
+                    stdinPayload: parsed.stdinPayload,
+                    metricsEnabled: parsed.metricsEnabled === true
+                };
+                runCommandInput.lifecycle = this.lifecycleServices();
+                if (stdinInputSource !== undefined) {
+                    runCommandInput.stdinInputSource = stdinInputSource;
+                }
+                const sessionEnv = parseSessionEnv(parsed.env);
+                const spans = runCommandInput.metricsEnabled ? [] : undefined;
+                if (spans) {
+                    runCommandInput.metricsSpans = spans;
+                }
+                if (typeof parsed.sessionId === "string") {
+                    runCommandInput.sessionId = parsed.sessionId;
+                }
+                if (typeof parsed.modulePlanExecutionId === "string") {
+                    runCommandInput.modulePlanExecutionId = parsed.modulePlanExecutionId;
+                }
+                if (parsed.suppressModulePlanStreamStart === true) {
+                    runCommandInput.suppressModulePlanStreamStart = true;
+                }
+                if (parsed.debugWorkspaceContext === true) {
+                    runCommandInput.debugWorkspaceContext = true;
+                }
+                ensureSessionModulePlanExecutionId(runCommandInput);
+                const runStartedAt = (0, metrics_1.metricsNow)();
+                const finishInvocation = this.beginInvocation(runCommandInput);
+                const runPromise = withSessionRequestContext(runCommandInput.cwd, sessionEnv, () => (0, run_command_1.runCommand)(runCommandInput)).then((result) => {
+                    (0, metrics_1.recordSpan)(spans, "session.runCommand", runStartedAt);
+                    return result;
+                }, (error) => {
+                    (0, metrics_1.recordSpan)(spans, "session.runCommand", runStartedAt);
+                    throw error;
+                }).finally(finishInvocation);
+                const deadlineMs = readSessionMutationSyncWaitMs(runCommandInput);
+                if (deadlineMs > 0) {
+                    const deadlineResult = await waitForSessionMutationDeadline(runCommandInput, runPromise, deadlineMs);
+                    if (deadlineResult.status === "deadline") {
+                        runPromise.catch(() => undefined);
+                        (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.deadline.output.start", { deadlineMs });
+                        const output = await buildModulePlanInProgressOutput(runCommandInput, deadlineMs);
+                        (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.response.write.start", { mode: "deadline" });
+                        writeJson(response, 200, output);
+                        (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.response.write.end", { mode: "deadline" });
+                        return;
+                    }
+                    const result = deadlineResult.result;
+                    (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.response.write.start", { mode: "result" });
+                    writeJson(response, 200, spans ? (0, metrics_1.appendMetrics)(result, spans) : result);
+                    (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.response.write.end", { mode: "result" });
+                    return;
+                }
+                const result = await runPromise;
+                (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.response.write.start", { mode: "no-deadline" });
+                writeJson(response, 200, spans ? (0, metrics_1.appendMetrics)(result, spans) : result);
+                (0, module_plan_timeline_1.recordModulePlanTimeline)(runCommandInput.cwd, runCommandInput.modulePlanExecutionId, "session.run.response.write.end", { mode: "no-deadline" });
+                return;
+            }
+            catch (error) {
+                writeJson(response, 500, (0, errors_1.errorPayload)(error));
+                return;
+            }
+        }
+        if (request.method === "POST" && request.url === "/invoke") {
+            let progressTimer = null;
+            let trace = null;
+            let traceStartedAtMs = 0;
+            let invokeRequest = null;
+            try {
+                const rawBody = await collectRequestBody(request);
+                const rawParams = new URLSearchParams(rawBody);
+                const requestCwd = rawParams.get("cwd") ?? "";
+                invokeRequest = await (0, workspace_root_1.runWithWorkspaceRequestContext)(requestCwd, undefined, () => parseInvokeFormRequest(rawBody));
+                invokeRequest.input.lifecycle = this.lifecycleServices();
+                const mode = classifyInvokeMode(invokeRequest.input);
+                writeInvokeModeHeader(response, mode);
+                if (mode === "process") {
+                    const finishInvocation = this.beginInvocation(invokeRequest.input);
+                    const requestAbort = new AbortController();
+                    const onResponseClose = () => {
+                        if (!response.writableEnded)
+                            requestAbort.abort("client-disconnected");
+                    };
+                    response.once("close", onResponseClose);
+                    try {
+                        const execRequest = buildExecRequestFromInvoke(invokeRequest);
+                        (0, external_tool_request_1.assertExternalToolRequestContext)(execRequest);
+                        const output = await this.externalTools.execute((signal) => (0, external_tool_request_1.runExternalToolRequest)(execRequest, signal), requestAbort.signal);
+                        writeJson(response, 200, output);
+                        return;
+                    }
+                    finally {
+                        response.removeListener("close", onResponseClose);
+                        finishInvocation();
+                    }
+                }
+                if (mode === "stream") {
+                    writeCliStreamHeaders(response);
+                    traceStartedAtMs = Date.now();
+                    trace = startCliFormTrace(invokeRequest, traceStartedAtMs);
+                    progressTimer = startCliProgressStream(response, invokeRequest.input);
+                    const requestEnv = invokeRequest.env;
+                    const runStartedAt = (0, metrics_1.metricsNow)();
+                    const finishInvocation = this.beginInvocation(invokeRequest.input);
+                    const runPromise = withSessionRequestContext(invokeRequest.input.cwd, requestEnv, () => (0, run_command_1.runCommand)(invokeRequest.input)).then((result) => {
+                        (0, metrics_1.recordSpan)(invokeRequest.spans, "session.runCommand", runStartedAt);
+                        return result;
+                    }, (error) => {
+                        (0, metrics_1.recordSpan)(invokeRequest.spans, "session.runCommand", runStartedAt);
+                        throw error;
+                    }).finally(finishInvocation);
+                    const result = await runPromise;
+                    const output = prepareCliPresentationPayload(invokeRequest.spans ? (0, metrics_1.appendMetrics)(result, invokeRequest.spans) : result);
+                    completeCliFormTrace(trace, invokeRequest, output, 0, traceStartedAtMs);
+                    writeStreamEvent(response, {
+                        type: "result",
+                        payload: output
+                    });
+                    response.end();
+                    return;
+                }
+                traceStartedAtMs = Date.now();
+                trace = startCliFormTrace(invokeRequest, traceStartedAtMs);
+                const requestEnv = invokeRequest.env;
+                const runStartedAt = (0, metrics_1.metricsNow)();
+                const finishInvocation = this.beginInvocation(invokeRequest.input);
+                const runPromise = withSessionRequestContext(invokeRequest.input.cwd, requestEnv, () => (0, run_command_1.runCommand)(invokeRequest.input)).then((result) => {
+                    (0, metrics_1.recordSpan)(invokeRequest.spans, "session.runCommand", runStartedAt);
+                    return result;
+                }, (error) => {
+                    (0, metrics_1.recordSpan)(invokeRequest.spans, "session.runCommand", runStartedAt);
+                    throw error;
+                }).finally(finishInvocation);
+                const deadlineMs = readSessionMutationSyncWaitMs(invokeRequest.input);
+                if (deadlineMs > 0) {
+                    const deadlineResult = await waitForSessionMutationDeadline(invokeRequest.input, runPromise, deadlineMs);
+                    if (deadlineResult.status === "deadline") {
+                        runPromise.catch(() => undefined);
+                        const output = prepareCliPresentationPayload(await buildModulePlanInProgressOutput(invokeRequest.input, deadlineMs));
+                        completeCliFormTrace(trace, invokeRequest, output, 0, traceStartedAtMs);
+                        writeJson(response, 200, output);
+                        return;
+                    }
+                    const result = deadlineResult.result;
+                    const output = prepareCliPresentationPayload(invokeRequest.spans ? (0, metrics_1.appendMetrics)(result, invokeRequest.spans) : result);
+                    completeCliFormTrace(trace, invokeRequest, output, 0, traceStartedAtMs);
+                    writeJson(response, 200, output);
+                    return;
+                }
+                const result = await runPromise;
+                const output = prepareCliPresentationPayload(invokeRequest.spans ? (0, metrics_1.appendMetrics)(result, invokeRequest.spans) : result);
+                completeCliFormTrace(trace, invokeRequest, output, 0, traceStartedAtMs);
+                writeJson(response, 200, output);
+                return;
+            }
+            catch (error) {
+                if (response.destroyed)
+                    return;
+                const output = prepareCliPresentationPayload((0, errors_1.errorPayload)(error));
+                if (!response.headersSent) {
+                    writeInvokeModeHeader(response, "structured");
+                    writeJson(response, 500, output);
+                    return;
+                }
+                if (response.getHeader("x-aib-execution-mode") === "stream") {
+                    completeCliFormTrace(trace, invokeRequest, output, 1, traceStartedAtMs);
+                    writeStreamEvent(response, {
+                        type: "error",
+                        payload: output
+                    });
+                    response.end();
+                    return;
+                }
+                completeCliFormTrace(trace, invokeRequest, output, 1, traceStartedAtMs);
+                writeJson(response, 500, output);
+                return;
+            }
+            finally {
+                if (progressTimer) {
+                    clearInterval(progressTimer);
+                }
+            }
+        }
+        writeJson(response, 404, {
+            ok: false,
+            error: "Not found"
+        });
+    }
+    async serve() {
+        const laneLease = (0, lane_owner_1.acquireSessionLaneLease)(this.daemonPackage.cliPath);
+        this.laneLease = laneLease;
+        try {
+            await new Promise((resolve, reject) => {
+                this.server.once("error", reject);
+                this.server.listen(0, "127.0.0.1", () => resolve());
+            });
+        }
+        catch (error) {
+            laneLease.release();
+            throw error;
+        }
+        const address = this.server.address();
+        if (!address || typeof address === "string") {
+            laneLease.release();
+            this.laneLease = null;
+            throw new Error("Failed to determine aib session address.");
+        }
+        writeSessionInfo({
+            pid: process.pid,
+            host: "127.0.0.1",
+            port: address.port,
+            url: `http://127.0.0.1:${address.port}`,
+            startedAt: this.daemonStartedAt
+        });
+        this.writeDaemonState("running");
+        this.heartbeatTimer = setInterval(() => this.writeDaemonState("running"), 10_000);
+        this.heartbeatTimer.unref();
+        this.runtimeLifecycle.start();
+        const onSigterm = () => { void this.shutdown("SIGTERM"); };
+        const onSigint = () => { void this.shutdown("SIGINT"); };
+        process.once("SIGTERM", onSigterm);
+        process.once("SIGINT", onSigint);
+        await this.stoppedPromise;
+        process.removeListener("SIGTERM", onSigterm);
+        process.removeListener("SIGINT", onSigint);
+    }
+    beginInvocation(input) {
+        this.activeInvokeCount += 1;
+        const executionId = typeof input.modulePlanExecutionId === "string" ? input.modulePlanExecutionId : null;
+        if (executionId) {
+            this.runningExecutions.set(executionId, {
+                executionId,
+                command: `${input.command} ${input.restArgs.join(" ")}`.trim(),
+                startedAt: new Date().toISOString()
+            });
+        }
+        this.writeDaemonState("running");
+        let finished = false;
+        return () => {
+            if (finished) {
+                return;
+            }
+            finished = true;
+            this.activeInvokeCount = Math.max(0, this.activeInvokeCount - 1);
+            if (executionId) {
+                this.runningExecutions.delete(executionId);
+            }
+            this.writeDaemonState("running");
+        };
+    }
+    lifecycleServices() {
+        return {
+            semanticContexts: {
+                forWorkspace: (workspaceRoot) => this.semanticContextPools.forWorkspace(workspaceRoot),
+                invalidateWorkspace: (workspaceRoot, change) => {
+                    this.semanticContextPools.invalidateWorkspace(workspaceRoot, change);
+                    this.semanticWorker?.invalidateWorkspace(workspaceRoot, change);
+                }
+            },
+            ...(this.semanticWorker ? { semanticBoundaries: this.semanticWorker } : {}),
+            ...(this.lexicalWorker ? { lexicalGraph: this.lexicalWorker } : {})
+        };
+    }
+    writeDaemonState(status) {
+        if (status === "running" && this.runtimeLifecycle.state.phase === "stopped")
+            return;
+        const runtime = this.runtimeLifecycle.state;
+        (0, daemon_state_1.tryWriteCliDaemonIdentity)((0, product_storage_1.productStorageRoot)(), {
+            schemaVersion: 1,
+            daemonId: this.daemonId,
+            pid: process.pid,
+            status,
+            startedAt: this.daemonStartedAt,
+            updatedAt: new Date().toISOString(),
+            heartbeatAt: new Date().toISOString(),
+            invokeProtocol: "http-session-v1",
+            supportedModes: ["structured", "process", "stream"],
+            activeInvokeCount: this.activeInvokeCount,
+            runningExecutions: Array.from(this.runningExecutions.values()),
+            lastActivityAt: runtime.lastActivityAt,
+            idleDeadlineAt: runtime.idleDeadlineAt,
+            idleTtlMs: runtime.idleTtlMs,
+            acceptingRequests: runtime.acceptingRequests,
+            idleRetainers: runtime.retainers,
+            shutdownReason: runtime.shutdownReason,
+            cliPath: this.daemonPackage.cliPath,
+            packageRoot: this.daemonPackage.packageRoot
+        });
+    }
+    ownedResourceRetainers() {
+        const retainers = [];
+        const external = this.externalTools.state;
+        if (external.active > 0)
+            retainers.push(`external-tools-active:${external.active}`);
+        if (external.queued > 0)
+            retainers.push(`external-tools-queued:${external.queued}`);
+        const semantic = this.semanticWorker?.state;
+        if (semantic?.active)
+            retainers.push("semantic-worker-active:1");
+        if ((semantic?.queued ?? 0) > 0)
+            retainers.push(`semantic-worker-queued:${semantic.queued}`);
+        const lexical = this.lexicalWorker?.state;
+        if (lexical?.active)
+            retainers.push("lexical-worker-active:1");
+        if ((lexical?.queued ?? 0) > 0)
+            retainers.push(`lexical-worker-queued:${lexical.queued}`);
+        const semanticLeases = this.semanticContextPools.state.workspaces.reduce((total, workspace) => total + workspace.pool.activeLeases, 0);
+        if (semanticLeases > 0)
+            retainers.push(`semantic-context-leases:${semanticLeases}`);
+        return retainers;
+    }
+    shutdown(reason) {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        this.runtimeLifecycle.beginShutdown(reason);
+        this.writeDaemonState("running");
+        const shutdownPromise = (0, runtime_shutdown_1.shutdownSessionRuntime)({
+            lifecycle: this.runtimeLifecycle,
+            drainTimeoutMs: this.drainTimeoutMs,
+            server: this.server,
+            shutdownResources: async () => {
+                await Promise.allSettled([
+                    this.semanticWorker?.shutdown() ?? Promise.resolve(),
+                    this.lexicalWorker?.shutdown() ?? Promise.resolve(),
+                    this.externalTools.shutdown()
+                ]);
+                this.semanticContextPools.dispose();
+            },
+            finalize: () => this.finalizeShutdown(false),
+            hardExit: () => this.finalizeShutdown(true)
+        }).then(() => undefined);
+        this.shutdownPromise = shutdownPromise;
+        return shutdownPromise;
+    }
+    finalizeShutdown(exitProcess) {
+        (0, runtime_shutdown_1.finalizeSessionRuntimeBestEffort)([
+            () => {
+                if (!this.heartbeatTimer)
+                    return;
+                clearInterval(this.heartbeatTimer);
+                this.heartbeatTimer = null;
+            },
+            () => {
+                this.runtimeLifecycle.markStopped();
+                this.writeDaemonState("stopped");
+            },
+            () => removeSessionInfo(),
+            () => this.laneLease?.release()
+        ], () => {
+            this.laneLease = null;
+            this.resolveStopped();
+            if (exitProcess)
+                process.exit(0);
+        });
+    }
+}
+exports.CliSessionServer = CliSessionServer;
+function readExternalToolTimeoutMs() {
+    const raw = process.env[env_vars_1.CLI_ENV.externalToolTimeoutMs];
+    const parsed = raw ? Number.parseInt(raw, 10) : Number.NaN;
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 30 * 60_000;
+}
+function canRunViaCliStream(input) {
+    return input.command === "diagnostics" && input.restArgs[0] === "timeout-stream";
+}
+function writeCliStreamHeaders(response) {
+    response.writeHead(200, {
+        "content-type": "application/x-ndjson; charset=utf-8",
+        "cache-control": "no-cache",
+        "x-accel-buffering": "no"
+    });
+    response.flushHeaders();
+}
+async function parseInvokeFormRequest(rawBody) {
+    const params = new URLSearchParams(rawBody);
+    return {
+        ...await parseCliFormParams(params, { invokeGate: true }),
+        params
+    };
+}
+async function parseCliFormParams(params, options = {}) {
+    const rawCommand = params.get("command") ?? params.get("method") ?? "";
+    const cwd = params.get("cwd") ?? "";
+    const sessionId = params.get("sessionId") ?? undefined;
+    const modulePlanExecutionId = params.get("modulePlanExecutionId") ?? undefined;
+    const suppressModulePlanStreamStart = params.get("suppressModulePlanStreamStart") === "true";
+    const metricsEnabled = params.get("metricsEnabled") === "true";
+    const traceDir = nonEmptyString(params.get("traceDir"));
+    const env = parseCliFormEnv(params);
+    if (!rawCommand.trim()) {
+        throw new errors_1.CliError("MISSING_COMMAND", "Missing command.");
+    }
+    if (!cwd.trim()) {
+        throw new errors_1.CliError("MISSING_CWD", "Missing cwd.");
+    }
+    const spans = metricsEnabled ? [] : undefined;
+    const aliasStartedAt = (0, metrics_1.metricsNow)();
+    const command = await (0, resolve_command_alias_1.resolveCanonicalCommandAlias)(rawCommand.trim(), cwd);
+    (0, metrics_1.recordSpan)(spans, "session.aliasResolution", aliasStartedAt);
+    const stdinFormat = (0, read_stdin_json_1.stripStdinFormatFlags)(params.getAll("arg"));
+    const restArgs = stdinFormat.restArgs;
+    const preliminaryInput = {
+        command,
+        restArgs,
+        cwd,
+        metricsEnabled
+    };
+    if (sessionId) {
+        preliminaryInput.sessionId = sessionId;
+    }
+    if (modulePlanExecutionId) {
+        preliminaryInput.modulePlanExecutionId = modulePlanExecutionId;
+    }
+    if (suppressModulePlanStreamStart) {
+        preliminaryInput.suppressModulePlanStreamStart = true;
+    }
+    if (spans) {
+        preliminaryInput.metricsSpans = spans;
+    }
+    if ((options.streamGate === true && !canRunViaCliStream(preliminaryInput)) ||
+        (options.invokeGate === true && classifyInvokeMode(preliminaryInput) === "process")) {
+        return {
+            input: preliminaryInput,
+            spans,
+            ...(traceDir !== undefined ? { traceDir } : {}),
+            env
+        };
+    }
+    const stdinInputSource = parseCliStdinInputSource(params.get("stdin"), command, restArgs, stdinFormat.format);
+    const input = {
+        command,
+        restArgs,
+        cwd,
+        stdinPayload: parseCliStdinPayload(params.get("stdin"), command, restArgs, stdinFormat.format),
+        metricsEnabled
+    };
+    if (stdinInputSource !== undefined) {
+        input.stdinInputSource = stdinInputSource;
+    }
+    if (sessionId) {
+        input.sessionId = sessionId;
+    }
+    if (modulePlanExecutionId) {
+        input.modulePlanExecutionId = modulePlanExecutionId;
+    }
+    if (suppressModulePlanStreamStart) {
+        input.suppressModulePlanStreamStart = true;
+    }
+    if (spans) {
+        input.metricsSpans = spans;
+    }
+    return {
+        input,
+        spans,
+        ...(traceDir !== undefined ? { traceDir } : {}),
+        env
+    };
+}
+function classifyInvokeMode(input) {
+    if (input.command === "rg" && input.restArgs[0] === "--") {
+        return "process";
+    }
+    if (input.command === "tsc" && input.restArgs[0] === "--") {
+        return "process";
+    }
+    if ((0, core_1.isRtkPassthroughCommand)(input.command) && input.restArgs[0] === "--") {
+        return "process";
+    }
+    if (canRunViaCliStream(input)) {
+        return "stream";
+    }
+    return "structured";
+}
+function buildExecRequestFromInvoke(request) {
+    const supported = ((request.input.command === "rg" || request.input.command === "tsc" || (0, core_1.isRtkPassthroughCommand)(request.input.command)) &&
+        request.input.restArgs[0] === "--");
+    if (!supported) {
+        throw new errors_1.CliError("UNSUPPORTED_INVOKE_PROCESS_COMMAND", `Unsupported process invocation: ${request.input.command}`, {
+            supported: ["rg --", "tsc --", ...core_1.RTK_PASSTHROUGH_COMMANDS.map((command) => `${command} --`)]
+        });
+    }
+    const execRequest = {
+        command: request.input.command,
+        restArgs: request.input.restArgs.slice(1),
+        cwd: request.input.cwd,
+        env: parseExecEnv(request.params)
+    };
+    if (request.params.has("stdin")) {
+        execRequest.stdinText = request.params.get("stdin") ?? "";
+    }
+    return execRequest;
+}
+function parseCliFormEnv(params) {
+    const env = {};
+    const entries = [
+        [env_vars_1.CLI_ENV.metrics, params.get("metrics") ?? ""],
+        [env_vars_1.CLI_ENV.metricsDir, params.get("metricsDir") ?? ""],
+        [env_vars_1.CLI_ENV.metricsTag, params.get("metricsTag") ?? ""],
+        [env_vars_1.CLI_ENV.mutationImpactMetrics, params.get("mutationImpactMetrics") ?? ""],
+        [env_vars_1.CLI_ENV.mutationImpactStream, params.get("mutationImpactStream") ?? ""],
+        [env_vars_1.CLI_ENV.testMoveToFileFailEntity, params.get("testMoveToFileFailEntity") ?? ""],
+        [env_vars_1.CLI_ENV.testPostMutationCyclesDelayMs, params.get("testPostMutationCyclesDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testRefactorBatchDelayMs, params.get("testRefactorBatchDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testRenameDelayMs, params.get("testRenameDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileMoveToDirDelayMs, params.get("testFileMoveToDirDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileMoveToDirRowDelayMs, params.get("testFileMoveToDirRowDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileMoveToDirImportsDelayMs, params.get("testFileMoveToDirImportsDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileMoveToDirFailImports, params.get("testFileMoveToDirFailImports") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRenameDelayMs, params.get("testFileRenameDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRenameRowDelayMs, params.get("testFileRenameRowDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRenameImportsDelayMs, params.get("testFileRenameImportsDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRenameFailImports, params.get("testFileRenameFailImports") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRefactorBatchDelayMs, params.get("testFileRefactorBatchDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRefactorBatchRowDelayMs, params.get("testFileRefactorBatchRowDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRefactorBatchImportsDelayMs, params.get("testFileRefactorBatchImportsDelayMs") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRefactorBatchFailImports, params.get("testFileRefactorBatchFailImports") ?? ""],
+        [env_vars_1.CLI_ENV.testFileRefactorBatchCrashAfterFsMove, params.get("testFileRefactorBatchCrashAfterFsMove") ?? ""],
+        [env_vars_1.CLI_ENV.disableFileMutationImportPostProcess, params.get("disableFileMutationImportPostProcess") ?? ""],
+        [env_vars_1.CLI_ENV.disableFileMoveImportPostProcess, params.get("disableFileMoveImportPostProcess") ?? ""],
+        [env_vars_1.CLI_ENV.modulePlanSyncWaitMs, params.get("modulePlanSyncWaitMs") ?? ""],
+        [env_vars_1.CLI_ENV.refactorBatchSyncWaitMs, params.get("refactorBatchSyncWaitMs") ?? ""],
+        [env_vars_1.CLI_ENV.renameSyncWaitMs, params.get("renameSyncWaitMs") ?? ""],
+        [env_vars_1.CLI_ENV.fileMoveToDirSyncWaitMs, params.get("fileMoveToDirSyncWaitMs") ?? ""],
+        [env_vars_1.CLI_ENV.fileRenameSyncWaitMs, params.get("fileRenameSyncWaitMs") ?? ""],
+        [env_vars_1.CLI_ENV.fileRefactorBatchSyncWaitMs, params.get("fileRefactorBatchSyncWaitMs") ?? ""],
+        [env_vars_1.CLI_ENV.modulePlanDebugTimeline, params.get("modulePlanDebugTimeline") ?? ""],
+        [env_vars_1.CLI_ENV.trace, params.get("trace") ?? ""],
+        [env_vars_1.CLI_ENV.failureSnapshots, params.get("failureSnapshots") ?? ""],
+        [env_vars_1.CLI_ENV.productStorageDir, params.get("productStorageDir") ?? ""],
+        [env_vars_1.CLI_ENV.helpShell, params.get(`env.${env_vars_1.CLI_ENV.helpShell}`) ?? ""]
+    ];
+    for (const [key, value] of entries) {
+        const trimmed = value.trim();
+        if (trimmed) {
+            env[key] = trimmed;
+        }
+    }
+    return env;
+}
+function nonEmptyString(value) {
+    if (value === null) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function startCliFormTrace(cliRequest, startedAtMs) {
+    if (!cliRequest.traceDir) {
+        return null;
+    }
+    return (0, trace_1.startTrace)({
+        cwd: cliRequest.input.cwd,
+        argv: [cliRequest.input.command, ...cliRequest.input.restArgs],
+        command: cliRequest.input.command,
+        restArgs: cliRequest.input.restArgs,
+        ...(cliRequest.input.stdinPayload !== undefined ? { stdinPayload: cliRequest.input.stdinPayload } : {}),
+        ...(cliRequest.input.stdinInputSource !== undefined ? { stdinSource: cliRequest.input.stdinInputSource } : {}),
+        traceDir: cliRequest.traceDir,
+        startedAtMs
+    });
+}
+function completeCliFormTrace(trace, cliRequest, output, exitCode, startedAtMs) {
+    if (!trace?.enabled || !cliRequest) {
+        return;
+    }
+    const envelope = (0, presentation_1.createCliPresentationEnvelope)(output);
+    trace.complete({
+        output: envelope.tracePayload,
+        stdoutText: envelope.text ? `${envelope.text.trimEnd()}\n` : `${JSON.stringify(envelope.tracePayload, null, 2)}\n`,
+        exitCode: output.ok === false ? 1 : exitCode,
+        durationMs: Date.now() - startedAtMs
+    });
+}
+function prepareCliPresentationPayload(output) {
+    return (0, presentation_1.createCliPresentationEnvelope)(output).payload;
+}
+function startCliProgressStream(response, input) {
+    if (!shouldStreamModulePlanProgress(input)) {
+        return null;
+    }
+    const executionId = input.modulePlanExecutionId ?? (0, module_plan_cache_1.buildModulePlanExecutionId)();
+    input.modulePlanExecutionId = executionId;
+    const streamStartedAtMs = Date.now();
+    const timeoutEstimate = estimateModulePlanTimeoutForStream(input);
+    const estimatedLine = timeoutEstimate
+        ? `\nestimated: ${(0, module_plan_timeout_1.formatModulePlanTimeoutEstimate)(timeoutEstimate.estimatedDurationMs)}`
+        : "";
+    if (!input.suppressModulePlanStreamStart) {
+        writeStreamEvent(response, {
+            type: "start",
+            text: `modulePlan.${input.restArgs[0] ?? "execute"} ${executionId}${estimatedLine}`,
+            data: {
+                operation: `modulePlan.${input.restArgs[0] ?? "execute"}`,
+                executionId,
+                ...(timeoutEstimate ? {
+                    estimatedTimeoutMs: timeoutEstimate.recommendedTimeoutMs,
+                    estimatedDurationMs: timeoutEstimate.estimatedDurationMs,
+                    suggestedFirstCheckMs: timeoutEstimate.suggestedFirstCheckMs,
+                    rowCount: timeoutEstimate.rowCount,
+                    symbolCount: timeoutEstimate.symbolCount
+                } : {})
+            }
+        });
+    }
+    if (!MODULE_PLAN_PROGRESS_STREAM_ENABLED) {
+        return null;
+    }
+    let lastHeartbeatAtMs = streamStartedAtMs;
+    return setInterval(() => {
+        try {
+            const status = (0, module_plan_cache_1.readModulePlanExecutionStatus)(input.cwd, executionId);
+            const executionStartedAtMs = Date.parse(status.startedAt);
+            if (Number.isFinite(executionStartedAtMs) && executionStartedAtMs + 1_000 < streamStartedAtMs) {
+                lastHeartbeatAtMs = writeModulePlanHeartbeat(response, lastHeartbeatAtMs);
+                return;
+            }
+            const hasVisibleProgress = status.completedRows > 0 || status.failedRows > 0 || status.filesWritten.length > 0;
+            if (!hasVisibleProgress) {
+                lastHeartbeatAtMs = writeModulePlanHeartbeat(response, lastHeartbeatAtMs);
+                return;
+            }
+            writeStreamEvent(response, {
+                type: "progress",
+                text: `progress: ${status.completedRows}/${status.rowCount} rows${formatModulePlanEntityProgress(status.completedEntities, status.entityCount)}, ${status.filesWritten.length} files`,
+                data: {
+                    operation: status.operation,
+                    executionId: status.executionId,
+                    status: status.status,
+                    completedRows: status.completedRows,
+                    failedRows: status.failedRows,
+                    rowCount: status.rowCount,
+                    completedEntities: status.completedEntities,
+                    entityCount: status.entityCount,
+                    filesWritten: status.filesWritten.length
+                }
+            });
+        }
+        catch {
+            lastHeartbeatAtMs = writeModulePlanHeartbeat(response, lastHeartbeatAtMs);
+        }
+    }, 5_000);
+}
+function writeModulePlanHeartbeat(response, lastHeartbeatAtMs) {
+    if (!MODULE_PLAN_HEARTBEAT_ENABLED) {
+        return lastHeartbeatAtMs;
+    }
+    const now = Date.now();
+    if (now - lastHeartbeatAtMs < 30_000) {
+        return lastHeartbeatAtMs;
+    }
+    writeStreamEvent(response, {
+        type: "progress",
+        text: "modulePlan still running",
+        data: {
+            operation: "modulePlan",
+            status: "running"
+        }
+    });
+    return now;
+}
+function formatModulePlanEntityProgress(completedEntities, entityCount) {
+    if (!entityCount || entityCount <= 0) {
+        return "";
+    }
+    const completed = completedEntities ?? 0;
+    return `, ${Math.floor((completed / entityCount) * 100)}% entities`;
+}
+function shouldStreamModulePlanProgress(input) {
+    return isSessionModulePlanMutation(input);
+}
+function estimateModulePlanTimeoutForStream(input) {
+    const mutateModulePlanRequest = readSingleModulePlanMutateRequest(input);
+    if (mutateModulePlanRequest) {
+        return (0, module_plan_timeout_1.estimateModulePlanTimeoutFromRequest)(mutateModulePlanRequest);
+    }
+    const action = input.restArgs[0] ?? "";
+    if (action === "execute") {
+        return (0, module_plan_timeout_1.estimateModulePlanTimeoutFromRequest)(input.stdinPayload);
+    }
+    if (action !== "apply") {
+        return null;
+    }
+    const planId = readModulePlanApplyPlanId(input.restArgs);
+    if (!planId) {
+        return null;
+    }
+    try {
+        return (0, module_plan_timeout_1.estimateModulePlanTimeoutFromRequest)((0, module_plan_cache_1.readModulePlanRecord)(input.cwd, planId).normalizedRequest);
+    }
+    catch {
+        return null;
+    }
+}
+function ensureSessionModulePlanExecutionId(input) {
+    if (input.modulePlanExecutionId || !isSessionModulePlanMutation(input)) {
+        return;
+    }
+    input.modulePlanExecutionId = (0, module_plan_cache_1.buildModulePlanExecutionId)();
+}
+function isSessionModulePlanMutation(input) {
+    if (input.command === "modulePlan") {
+        const action = input.restArgs[0] ?? "";
+        return action === "execute" || action === "apply";
+    }
+    return Boolean(readSingleModulePlanMutateRequest(input));
+}
+function readSingleModulePlanMutateRequest(input) {
+    if (input.command !== "mutate" || input.restArgs[0] !== "execute") {
+        return null;
+    }
+    if (!isJsonObject(input.stdinPayload)) {
+        return null;
+    }
+    const segments = Array.isArray(input.stdinPayload.segments) ? input.stdinPayload.segments.filter(isJsonObject) : [];
+    if (segments.length !== 1 || segments[0]?.kind !== "modulePlan") {
+        return null;
+    }
+    const segment = segments[0];
+    const sourceFile = typeof segment.sourceFile === "string" ? segment.sourceFile : null;
+    const modules = Array.isArray(segment.modules) ? segment.modules.filter(isJsonObject) : [];
+    if (!sourceFile || modules.length === 0) {
+        return null;
+    }
+    return {
+        sourceFile,
+        modules: modules.map((module) => ({
+            target: typeof module.targetFile === "string"
+                ? module.targetFile
+                : typeof module.target === "string"
+                    ? module.target
+                    : "",
+            entities: readStringArray(module.symbols).length > 0 ? readStringArray(module.symbols) : readStringArray(module.entities)
+        }))
+    };
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readModulePlanApplyPlanId(restArgs) {
+    const flagIndex = restArgs.indexOf("--plan");
+    if (flagIndex >= 0) {
+        const value = restArgs[flagIndex + 1];
+        return value && !value.startsWith("--") ? value : null;
+    }
+    const positional = restArgs.slice(1).find((arg) => !arg.startsWith("--"));
+    return positional ?? null;
+}
+async function runSessionServerCli() {
+    const command = process.argv[3] || "status";
+    if (command !== "serve") {
+        (0, stdout_1.printJson)((0, errors_1.errorPayload)(new errors_1.CliError("UNKNOWN_SESSION_COMMAND", `Unknown aib session command: ${command}`)));
+        process.exitCode = 1;
+        return;
+    }
+    const server = new CliSessionServer();
+    await server.serve();
+}