@xenosystem/agent-sdk 0.10.13 → 0.10.14

package/dist/electron/index.js

@@ -1056,7 +1056,7 @@ ${Wx}`,n=zx("sha256").update(e).digest("hex"),r=pn(tm(),"xeno-agent-sdk","window
 `)}function ep(t,e){return PT(t,e)}function Ma(t){let e=t.command,n=t.runInBackground??!1,r=Math.min(Math.max(1,t.requestedTimeout??12e4),36e5),o=Aa(e,r,n);if(Ke(t.sandbox)&&t.tty)return $o("","Secured process-hardened or contained interactive PTY tasks are not supported. Use a pipe-backed command.");if(Pa(e))return _t(`Blocked dangerous command attempt: ${e}`),$o("","Command blocked: potentially dangerous operation detected. This command could destroy data or compromise system security.");if(fe()&&Ld(e))return $o("",Pt(e));let s=[{output:Nd(e),error:"Benchmark reference overwrite blocked"},{output:qm(e,t.cwd),error:"Vim macro script preflight failed"},{output:Wm(e),error:"SQL newline deletion would corrupt query text"},{output:Gm(e,r,n),error:"Long foreground SQLite full-output comparison should stay bounded"},{output:Ra(e,r,n),error:"Benchmark compute/search command needs an explicit budget and checkpoint"},{output:n?null:Km(e,o),error:"Long-running foreground interactive script should run in background"},{output:n?null:Ym(e,o),error:"Foreground serial-control automation should run in background or use a short timeout"},{output:n?null:Qm(e,o),error:"Foreground client polling loop should use short bounded checks"},{output:n?null:Jm(e,o),error:"Long-running foreground command should run in background"},{output:n?null:Zm(e),error:"Unbounded foreground socket command needs a timeout"}];for(let i of s)if(i.output)return $o(i.output,i.error);return{allowed:!0,execution:{command:e,cwd:t.cwd,requestedTimeout:r,timeout:o,runInBackground:n,env:mn(t.env??process.env,t.allowedSensitiveEnvironmentKeys)}}}function $o(t,e){return{allowed:!1,result:{success:!1,output:t,error:e}}}import{randomUUID as Bp}from"node:crypto";import{existsSync as Za,statSync as Up}from"node:fs";import{createHash as Oa,randomUUID as Uo}from"node:crypto";import{accessSync as RT,appendFileSync as CT,constants as tp,existsSync as MT,lstatSync as OT,mkdirSync as La,readFileSync as LT,readdirSync as NT,renameSync as DT,statSync as BT,writeFileSync as $T}from"node:fs";import{join as Na,resolve as UT}from"node:path";var FT=new Set(["completed","failed","timed_out","cancelled","orphaned"]),jo=Number.MAX_SAFE_INTEGER,qT=3,np=2e3,Da=8e3,Fo=1;function lr(t){if(t!==void 0){if(!t||["sessionId","goalId","requestId"].some(e=>{let n=t[e];return typeof n!="string"||!n.trim()||n.length>1024}))throw new Error("Invalid host goal continuation scope");return{sessionId:t.sessionId,goalId:t.goalId,requestId:t.requestId}}}var Ba=class{constructor(e=Na(De(),"tool-operations")){this.storeRoot=e}storeRoot;get continuationOriginVersion(){return 1}operations=new Map;taskToOperation=new Map;continuations=new Map;listeners=new Set;loadedOwners=new Set;register(e){let n=`op_${Uo()}`,r=Date.now(),o=e.presentation??"foreground",s=o==="background"?"running_background":"registered",a={snapshot:{schemaVersion:Fo,operationId:n,turnId:e.turnId,generation:e.generation,toolCallId:e.toolCallId,toolName:e.toolName,displayName:e.displayName,ownerSessionId:e.ownerSessionId,state:s,terminal:!1,presentation:o,completionPolicy:e.completionPolicy??"await",promotable:e.promotable??!1,startedAt:new Date(r).toISOString(),lastActivityAt:new Date(r).toISOString(),deadlineAt:e.deadlineAt,elapsedMs:0,idleMs:0,outputBytes:0,nextOffset:0,expectedOutputs:qo(e.expectedOutputs),evidence:[],suggestedNextAction:"execute the tool"},startedAtMs:r,lastActivityAtMs:r,promotionRequested:!1,previousRunningState:o==="background"?"running_background":"running_foreground",eventSink:e.eventSink,renewableDeadlineMs:e.renewableDeadlineMs};return this.operations.set(n,a),this.armDeadline(a),this.emit("started",a),this.persistOwner(e.ownerSessionId),this.snapshot(a)}onEvent(e){return this.listeners.add(e),()=>this.listeners.delete(e)}get(e){let n=this.operations.get(e);return n?this.snapshot(n):null}getByTaskId(e){let n=this.taskToOperation.get(e);return n?this.get(n):null}list(e={}){return Array.from(this.operations.values()).map(n=>this.snapshot(n)).filter(n=>!e.ownerSessionId||n.ownerSessionId===e.ownerSessionId).filter(n=>!e.turnId||n.turnId===e.turnId).filter(n=>e.terminal===void 0||n.terminal===e.terminal).filter(n=>!e.completionPolicy||n.completionPolicy===e.completionPolicy)}listPendingAwaited(e){return this.list({turnId:e,terminal:!1,completionPolicy:"await"})}getDiagnostics(){let e=!0,n=0;try{La(this.storeRoot,{recursive:!0,mode:448}),RT(this.storeRoot,tp.R_OK|tp.W_OK),n=NT(this.storeRoot).filter(r=>r.endsWith(".json")).length}catch{e=!1}return{schemaVersion:Fo,storeRoot:this.storeRoot,storeHealthy:e,persistedOwnerCount:n,activeOperationCount:this.list({terminal:!1}).length,orphanedOperationCount:this.list().filter(r=>r.state==="orphaned").length,pendingContinuationCount:Array.from(this.continuations.values()).filter(r=>r.status==="waiting"||r.status==="ready"||r.status==="running").length}}setOwner(e,n){let r=this.operations.get(e);return r?(r.snapshot.ownerSessionId=n,this.touch(r,"state"),this.persistOwner(n),this.snapshot(r)):null}configure(e,n){let r=this.operations.get(e);return!r||r.snapshot.terminal?r?this.snapshot(r):null:(n.ownerSessionId!==void 0&&(r.snapshot.ownerSessionId=n.ownerSessionId),n.completionPolicy&&(r.snapshot.completionPolicy=n.completionPolicy),n.promotable!==void 0&&(r.snapshot.promotable=n.promotable),n.deadlineAt!==void 0&&(r.snapshot.deadlineAt=n.deadlineAt,this.armDeadline(r)),n.renewableDeadlineMs!==void 0&&(r.renewableDeadlineMs=n.renewableDeadlineMs===null?void 0:Math.max(1e3,Math.floor(n.renewableDeadlineMs))),n.expectedOutputs!==void 0&&(r.snapshot.expectedOutputs=qo(n.expectedOutputs)),this.touch(r,"state"),this.emit("state",r),this.persistOwner(r.snapshot.ownerSessionId),this.snapshot(r))}setDeadlineAbortHandler(e,n){let r=this.operations.get(e);if(!r)return null;if(r.abortOnDeadline=n,r.snapshot.state==="timed_out")try{n()}catch{}else this.armDeadline(r);return this.snapshot(r)}transition(e,n,r={}){let o=this.operations.get(e);return o?o.snapshot.terminal?this.snapshot(o):((n==="running_foreground"||n==="running_background")&&(o.previousRunningState=n),o.snapshot.state=n,o.snapshot.terminal=FT.has(n),Object.assign(o.snapshot,r),r.presentation&&(o.snapshot.presentation=r.presentation),n==="stalled"?o.snapshot.elapsedMs=Math.max(0,Date.now()-o.startedAtMs):this.touch(o,"state"),this.emit(o.snapshot.terminal?"terminal":"state",o),this.persistOwner(o.snapshot.ownerSessionId),this.snapshot(o)):null}resumeFromDiagnosticState(e){let n=this.operations.get(e);return!n||n.snapshot.terminal?n?this.snapshot(n):null:n.snapshot.state!=="stalled"&&n.snapshot.state!=="waiting_for_input"?this.snapshot(n):this.transition(e,n.previousRunningState)}reportProgress(e,n){let r=this.operations.get(e);if(!r||r.snapshot.terminal)return r?this.snapshot(r):null;let o=Number.isFinite(n.outputBytes)?Math.max(r.snapshot.outputBytes,Math.floor(n.outputBytes)):r.snapshot.outputBytes+Math.max(0,Math.floor(n.bytes??0));return r.snapshot.outputBytes=o,r.snapshot.nextOffset=Math.max(r.snapshot.nextOffset,n.nextOffset??o),r.snapshot.suggestedNextAction=n.message??r.snapshot.suggestedNextAction,n.activity==="waiting_for_input"?r.snapshot.state="waiting_for_input":(r.snapshot.state==="stalled"||r.snapshot.state==="waiting_for_input")&&(r.snapshot.state=r.previousRunningState),this.touch(r,n.activity),this.emit("progress",r,n),this.persistOwner(r.snapshot.ownerSessionId),this.snapshot(r)}attachTask(e,n,r){let o=this.operations.get(e);return o?(o.snapshot.taskId=n.id,o.snapshot.displayName=n.displayName??o.snapshot.displayName,o.snapshot.processId=n.processId,o.snapshot.pid=n.pid,o.snapshot.outputPath=n.outputFile,o.snapshot.commandFingerprint=n.command?Oa("sha256").update(n.command).digest("hex"):o.snapshot.commandFingerprint,o.snapshot.ownerSessionId=n.ownerSessionId??o.snapshot.ownerSessionId,o.snapshot.presentation=n.presentation??o.snapshot.presentation,o.snapshot.state=o.snapshot.presentation==="background"?"running_background":"running_foreground",o.previousRunningState=o.snapshot.state,this.taskToOperation.set(n.id,e),o.disposeTaskEvents?.(),r&&(o.readTaskOutput=r.getOutput?()=>{let i=r.get(n.id)?.outputSize??0;return r.getOutput(n.id,Math.max(0,i-Da),Da)?.output??""}:void 0,o.disposeTaskEvents=r.onTaskEvent(s=>{if(s.task.id===n.id){if(s.type==="task.output"){this.reportProgress(e,{activity:s.chunk?.stream??"stdout",bytes:s.chunk?.bytes??0,outputBytes:s.task.outputSize,nextOffset:s.task.outputSize});return}if(s.type==="task.promoted"){this.markPromoted(e,s.task);return}s.type==="task.completed"&&this.finishFromTask(e,s.task)}})),this.touch(o,"state"),this.emit("state",o),this.persistOwner(o.snapshot.ownerSessionId),this.snapshot(o)):null}requestPromotion(e){let n=this.operations.get(e);return n?n.snapshot.terminal?{ok:!1,code:"TERMINAL"}:n.snapshot.presentation==="background"?{ok:!1,code:"ALREADY_BACKGROUND"}:n.snapshot.promotable?(n.promotionRequested=!0,this.touch(n,"state"),this.emit("promotion_requested",n),{ok:!0,operation:this.snapshot(n)}):{ok:!1,code:"NOT_PROMOTABLE"}:{ok:!1,code:"NOT_FOUND"}}consumePromotionRequest(e){let n=this.operations.get(e);return!n?.promotionRequested||n.snapshot.terminal?!1:(n.promotionRequested=!1,!0)}markPromoted(e,n){let r=this.operations.get(e);return!r||r.snapshot.terminal?r?this.snapshot(r):null:(r.promotionRequested=!1,r.snapshot.presentation="background",r.snapshot.state="running_background",r.previousRunningState="running_background",n&&(r.snapshot.taskId=n.id,r.snapshot.processId=n.processId,r.snapshot.pid=n.pid),r.snapshot.suggestedNextAction=r.snapshot.completionPolicy==="await"?"wait for completion; do not claim expected outputs yet":"continue independent work and observe task status",this.touch(r,"state"),this.emit("promoted",r),this.persistOwner(r.snapshot.ownerSessionId),this.snapshot(r))}addEvidence(e,n){let r=this.operations.get(e);if(!r)return null;let o=r.snapshot.evidence??[],s=o.findIndex(i=>i.id===n.id);return s>=0?o[s]=Mt(n):o.push(Mt(n)),r.snapshot.evidence=o,this.persistOwner(r.snapshot.ownerSessionId),this.snapshot(r)}finalize(e,n,r={}){let o=this.operations.get(e);if(!o)return null;if(o.snapshot.terminal)return this.snapshot(o);r.evidence&&(o.snapshot.evidence=r.evidence.map(Mt)),o.snapshot.exitCode=r.exitCode,o.snapshot.completionReason=r.reason,o.snapshot.suggestedNextAction=VT(n,r.reason),o.disposeTaskEvents?.(),o.disposeTaskEvents=void 0,o.deadlineTimer&&clearTimeout(o.deadlineTimer),o.deadlineTimer=void 0;let s=this.transition(e,n);return o.abortOnDeadline=void 0,this.refreshContinuations(e),s}async completeSynchronous(e,n,r){let o=this.operations.get(e);if(!o||o.snapshot.terminal)return o?this.snapshot(o):null;this.transition(e,"verifying",{completionReason:r,suggestedNextAction:"verify operation postconditions"});let s=await this.verifyExpectedOutputs(o),i=s.some(a=>a.status==="failed");return this.finalize(e,n&&!i?"completed":"failed",{reason:n&&i?"POSTCONDITION_FAILED":r??(n?"tool_result":"tool_error"),evidence:s})}async waitForTerminal(e,n={}){let r=this.get(e);return!r||r.terminal||(n.timeoutMs??0)<=0?r:new Promise(o=>{let s=!1,i=()=>{s||(s=!0,c(),l&&clearTimeout(l),n.signal?.removeEventListener("abort",a),o(this.get(e)))},a=()=>i(),c=this.onEvent(u=>{u.operation.operationId===e&&u.operation.terminal&&i()}),l=setTimeout(i,Math.max(1,n.timeoutMs??3e4));n.signal?.aborted?i():n.signal?.addEventListener("abort",a,{once:!0})})}createContinuation(e){this.loadOwner(e.ownerSessionId);let n=lr(e.goalTurn),r=new Date().toISOString(),o=e.parentContinuationId?this.assertContinuationOrigin(e.ownerSessionId,e.parentContinuationId,n):void 0,s=o??Array.from(this.continuations.values()).filter(p=>p.ownerSessionId===e.ownerSessionId).filter(p=>e.sourceMessageId!==void 0?p.sourceMessageId===e.sourceMessageId:e.goalTurn?p.goalTurn?.requestId===n?.requestId:!p.goalTurn).filter(p=>p.status==="waiting"||p.status==="ready"||p.status==="running").sort((p,g)=>g.updatedAt.localeCompare(p.updatedAt))[0];if(!o&&s&&(s.goalTurn?.sessionId!==n?.sessionId||s.goalTurn?.goalId!==n?.goalId||s.goalTurn?.requestId!==n?.requestId))throw new Error("An existing continuation message cannot change goal scope");let i=s?.status==="running"?void 0:s,a=s?.continuationTurns??0,c=s?.objective??e.objective,l=s?.contextDigest??e.contextDigest??c,d=(e.maxContinuationTurns===void 0?void 0:e.maxContinuationTurns>=jo?"unbounded":"bounded")??s?.continuationPolicy??"unbounded",m={schemaVersion:1,continuationId:i?.continuationId??`cont_${Uo()}`,ownerSessionId:e.ownerSessionId,objective:c.slice(0,np),sourceTurnId:e.sourceTurnId,...e.sourceMessageId?{sourceMessageId:e.sourceMessageId}:{},...o?{parentContinuationId:o.continuationId}:{},...n?{goalTurn:n}:{},status:"waiting",operationIds:[...new Set([...s?.operationIds??s?.pendingOperationIds??[],...e.pendingOperationIds])],pendingOperationIds:[...new Set(e.pendingOperationIds)],expectedOutputs:e.pendingOperationIds.flatMap(p=>this.get(p)?.expectedOutputs??[]),verifiedEvidenceIds:e.pendingOperationIds.flatMap(p=>(this.get(p)?.evidence??[]).filter(g=>g.status==="verified").map(g=>g.id)),lastSuccessfulAction:e.lastSuccessfulAction??"tool operation started",nextAction:e.nextAction??"continue when the awaited operation reaches a terminal state",outputOffsets:Object.fromEntries(e.pendingOperationIds.map(p=>{let g=this.get(p);return[g?.taskId??p,g?.nextOffset??0]})),contextDigest:l.slice(0,np),continuationTurns:a,maxContinuationTurns:d==="unbounded"?jo:Math.max(1,e.maxContinuationTurns??s?.maxContinuationTurns??1),continuationPolicy:d,createdAt:i?.createdAt??r,updatedAt:r};return this.continuations.set(m.continuationId,m),this.refreshContinuation(m),this.persistOwner(e.ownerSessionId),Be(m)}assertContinuationOrigin(e,n,r){this.loadOwner(e);let o=this.continuations.get(n);if(!o||o.ownerSessionId!==e||o.status!=="running")throw new Error("Continuation parent is not running in the owned scope");let s=lr(r);if(o.goalTurn?.sessionId!==s?.sessionId||o.goalTurn?.goalId!==s?.goalId)throw new Error("Continuation parent goal scope does not match this turn");return Be(o)}listContinuations(e,n){return this.loadOwner(e),Array.from(this.continuations.values()).filter(r=>r.ownerSessionId===e).filter(r=>!n||r.status===n).map(Be)}markContinuationRunning(e,n){let r=this.continuations.get(e);if(!r||r.status!=="ready")return!n&&r?Be(r):null;if(n&&(typeof n.messageId!="string"||!n.messageId.trim()||n.messageId.length>1024))throw new Error("Invalid continuation delivery identity");return r.continuationTurns+=1,n&&(r.lastDeliveryMessageId=n.messageId),r.status=r.continuationPolicy==="unbounded"?"running":r.continuationTurns>r.maxContinuationTurns?"exhausted":"running",r.status==="running"&&(r.deliveredAt=new Date().toISOString(),r.notification&&(r.notification.deliveredAt=r.deliveredAt)),r.updatedAt=new Date().toISOString(),this.persistOwner(r.ownerSessionId),Be(r)}markContinuationCompleted(e){let n=this.continuations.get(e);return n?(n.acknowledgedAt=new Date().toISOString(),n.notification&&(n.notification.acknowledgedAt=n.acknowledgedAt),this.setContinuationStatus(e,"completed")):null}retryContinuation(e){let n=this.continuations.get(e);return!n||n.status!=="running"?n?Be(n):null:(n.status=n.continuationPolicy==="unbounded"?"ready":n.continuationTurns>=n.maxContinuationTurns?"exhausted":"ready",n.updatedAt=new Date().toISOString(),this.persistOwner(n.ownerSessionId),Be(n))}cancelContinuation(e){return this.setContinuationStatus(e,"cancelled")}cancelContinuationsForOperation(e){let n=[];for(let r of this.continuations.values())r.pendingOperationIds.includes(e)&&(r.status!=="waiting"&&r.status!=="ready"&&r.status!=="running"||(r.status="cancelled",r.updatedAt=new Date().toISOString(),this.persistOwner(r.ownerSessionId),n.push(Be(r))));return n}cancelContinuationsForOwner(e){this.loadOwner(e);let n=[];for(let r of this.continuations.values())r.ownerSessionId===e&&(r.status!=="waiting"&&r.status!=="ready"&&r.status!=="running"||(r.status="cancelled",r.updatedAt=new Date().toISOString(),n.push(Be(r))));return n.length>0&&this.persistOwner(e),n}reconcileOwner(e,n){this.loadOwner(e);let r=[];for(let o of this.operations.values()){if(o.snapshot.ownerSessionId!==e||o.snapshot.terminal||o.snapshot.taskId&&n.has(o.snapshot.taskId))continue;let s=this.finalize(o.snapshot.operationId,"orphaned",{reason:"host/session recovery found no live process owner"});s&&r.push(s)}return r}async finishFromTask(e,n){let r=this.operations.get(e);if(!r||r.snapshot.terminal)return;this.transition(e,"verifying",{exitCode:n.exitCode,completionReason:n.completionReason,suggestedNextAction:"verify expected outputs"});let o=await this.verifyExpectedOutputs(r),s=o.some(a=>a.status==="failed"),i=s?"POSTCONDITION_FAILED":n.completionReason??(n.status==="completed"?"exit":n.status);n.completionReason==="timeout"?this.finalize(e,"timed_out",{exitCode:n.exitCode,reason:i,evidence:o}):n.status==="killed"||n.completionReason==="terminated"?this.finalize(e,"cancelled",{exitCode:n.exitCode,reason:i,evidence:o}):n.status==="completed"&&(n.exitCode??0)===0&&!s?this.finalize(e,"completed",{exitCode:n.exitCode,reason:i,evidence:o}):this.finalize(e,"failed",{exitCode:n.exitCode,reason:i,evidence:o})}async verifyExpectedOutputs(e){let n=e.snapshot.expectedOutputs??[],r=[];for(let o of n){let s=new Date().toISOString(),i=`evidence_${Oa("sha256").update(`${e.snapshot.operationId}:${o.path}`).digest("hex").slice(0,20)}`;try{let a=OT(o.path);if(a.isSymbolicLink())throw new Error("Expected output is a symbolic link or junction; direct artifact evidence is required");await GT(25);let c=BT(o.path),l=a.isDirectory()?"directory":a.isFile()?"file":"other",u=!o.kind||o.kind===l,d=!o.nonEmpty||c.size>0,m=a.size===c.size&&a.mtimeMs===c.mtimeMs,p=u&&d&&m;r.push({id:i,kind:"artifact",status:p?"verified":"failed",path:o.path,observedAt:s,operationId:e.snapshot.operationId,detail:{expectedKind:o.kind??"any",actualKind:l,size:c.size,device:c.dev,inode:c.ino,stable:m,nonEmptyRequired:o.nonEmpty??!1}})}catch(a){r.push({id:i,kind:"artifact",status:"failed",path:o.path,observedAt:s,operationId:e.snapshot.operationId,detail:{error:a instanceof Error?a.message:String(a)}})}}return e.snapshot.evidence=r.map(Mt),r}refreshContinuations(e){for(let n of this.continuations.values())n.pendingOperationIds.includes(e)&&this.refreshContinuation(n)}refreshContinuation(e){let n=e.operationIds??e.pendingOperationIds;e.operationIds=[...new Set(n)];let r=e.pendingOperationIds.map(o=>this.get(o)).filter(o=>!!(o&&!o.terminal));if(e.pendingOperationIds=r.map(o=>o.operationId),r.length===0&&e.status==="waiting"){e.status="ready",e.notificationId??=`notification_${Uo()}`;let o=e.operationIds.map(s=>this.operations.get(s)).filter(s=>!!s);e.notification??={notificationId:e.notificationId,continuationId:e.continuationId,ownerSessionId:e.ownerSessionId,operationIds:o.map(s=>s.snapshot.operationId),taskIds:o.flatMap(s=>s.snapshot.taskId?[s.snapshot.taskId]:[]),terminal:o.map(s=>({operationId:s.snapshot.operationId,state:s.snapshot.state,completionReason:s.snapshot.completionReason,exitCode:s.snapshot.exitCode})),outputTail:zT(o.flatMap(s=>{let i=s.readTaskOutput?.()??"";return i?[`[${s.snapshot.taskId??s.snapshot.operationId}]
 ${i}`]:[]}).join(`
 `)),evidence:o.flatMap(s=>s.snapshot.evidence??[]).map(Mt),createdAt:new Date().toISOString()}}e.verifiedEvidenceIds=Array.from(this.operations.values()).filter(o=>o.snapshot.ownerSessionId===e.ownerSessionId).flatMap(o=>o.snapshot.evidence??[]).filter(o=>o.status==="verified").map(o=>o.id),e.updatedAt=new Date().toISOString(),this.persistOwner(e.ownerSessionId)}setContinuationStatus(e,n){let r=this.continuations.get(e);return r?(r.status=n,r.updatedAt=new Date().toISOString(),this.persistOwner(r.ownerSessionId),Be(r)):null}armDeadline(e){if(e.deadlineTimer&&clearTimeout(e.deadlineTimer),e.deadlineTimer=void 0,e.snapshot.terminal||!e.snapshot.deadlineAt)return;let n=Date.parse(e.snapshot.deadlineAt);if(!Number.isFinite(n))return;let r=()=>{if(e.deadlineTimer=void 0,e.snapshot.terminal)return;let o=e.abortOnDeadline;this.finalize(e.snapshot.operationId,"timed_out",{reason:"OPERATION_DEADLINE_EXCEEDED"});try{o?.()}catch{}};e.deadlineTimer=setTimeout(r,Math.max(0,n-Date.now())),e.deadlineTimer.unref?.()}touch(e,n){let r=Date.now();e.lastActivityAtMs=r,e.snapshot.lastActivityAt=new Date(r).toISOString(),e.snapshot.elapsedMs=Math.max(0,r-e.startedAtMs),e.snapshot.idleMs=0,e.renewableDeadlineMs&&(n==="stdout"||n==="stderr"||n==="heartbeat"||n==="input")&&(e.snapshot.deadlineAt=new Date(r+e.renewableDeadlineMs).toISOString(),this.armDeadline(e)),n&&(e.snapshot.suggestedNextAction=HT(n,e.snapshot))}snapshot(e){let n=Date.now();return{...e.snapshot,elapsedMs:Math.max(0,n-e.startedAtMs),idleMs:e.snapshot.terminal?e.snapshot.idleMs:Math.max(0,n-e.lastActivityAtMs),expectedOutputs:qo(e.snapshot.expectedOutputs),evidence:e.snapshot.evidence?.map(Mt)}}emit(e,n,r){let o=this.snapshot(n),s={type:e,operation:o,...r?{progress:r}:{}};this.appendOperationEvent(e,o,r);for(let a of this.listeners)a(s);let i=WT(e,o.state);i&&Promise.resolve(n.eventSink?.({type:i,turnId:o.turnId,toolName:o.toolName,operation:o,...r?{progress:r}:{}})).catch(()=>{})}ownerFile(e){return Na(this.storeRoot,`${this.ownerKey(e)}.json`)}ownerKey(e){return Oa("sha256").update(e).digest("hex").slice(0,32)}appendOperationEvent(e,n,r){if(n.ownerSessionId)try{La(this.storeRoot,{recursive:!0,mode:448});let o=Na(this.storeRoot,`${this.ownerKey(n.ownerSessionId)}.events.jsonl`);CT(o,`${JSON.stringify({schemaVersion:Fo,type:e,at:new Date().toISOString(),operation:n,progress:r?{...r,message:r.message?.slice(0,500)}:void 0})}
-`,{encoding:"utf8",mode:384})}catch{}}persistOwner(e){if(!e)return;let n=Array.from(this.continuations.values()).some(r=>r.ownerSessionId===e&&r.goalTurn!==void 0);try{La(this.storeRoot,{recursive:!0,mode:448});let r={schemaVersion:n?2:1,ownerSessionId:e,operations:this.list({ownerSessionId:e}),continuations:Array.from(this.continuations.values()).filter(i=>i.ownerSessionId===e).map(Be)},o=this.ownerFile(e),s=`${o}.${process.pid}.${Uo()}.tmp`;$T(s,JSON.stringify(r,null,2),{encoding:"utf8",mode:384}),DT(s,o)}catch(r){if(n)throw Object.assign(new Error("Goal continuation persistence is unconfirmed; inspect state before retrying",{cause:r}),{code:"CONTINUATION_PERSISTENCE_UNCONFIRMED",retryable:!1})}}loadOwner(e){if(this.loadedOwners.has(e))return;this.loadedOwners.add(e);let n=this.ownerFile(e);if(MT(n))try{let r=JSON.parse(LT(n,"utf8"));if(![1,2].includes(r.schemaVersion)||r.ownerSessionId!==e)throw new Error("Unsupported or foreign operation state");if(!Array.isArray(r.operations)||!Array.isArray(r.continuations))throw new Error("Invalid operation state collections");let o=r.continuations.map(s=>{if(s.ownerSessionId!==e)throw new Error("Foreign continuation in operation state");return jT(s)});for(let s of r.operations??[]){if(this.operations.has(s.operationId))continue;let i=Date.parse(s.startedAt),a=Date.parse(s.lastActivityAt),c={snapshot:{...s,schemaVersion:Fo,expectedOutputs:qo(s.expectedOutputs),evidence:s.evidence?.map(Mt)},startedAtMs:Number.isFinite(i)?i:Date.now(),lastActivityAtMs:Number.isFinite(a)?a:Date.now(),promotionRequested:!1,previousRunningState:s.presentation==="background"?"running_background":"running_foreground"};this.operations.set(s.operationId,c),this.armDeadline(c),s.taskId&&this.taskToOperation.set(s.taskId,s.operationId)}for(let s of o)if(!this.continuations.has(s.continuationId)){let i=s;i.status==="running"&&!i.acknowledgedAt&&(i.status="ready"),this.continuations.set(s.continuationId,i)}}catch(r){throw this.loadedOwners.delete(e),Object.assign(new Error("Operation state could not be read; original state was preserved",{cause:r}),{code:"CONTINUATION_STATE_UNAVAILABLE",retryable:!1})}}};function qo(t){return t?.map(e=>({...e,path:UT(e.path)}))}function Mt(t){return{...t,detail:t.detail?{...t.detail}:void 0}}function Be(t){return{...t,...t.goalTurn!==void 0?{goalTurn:lr(t.goalTurn)}:{},operationIds:[...t.operationIds??t.pendingOperationIds],pendingOperationIds:[...t.pendingOperationIds],expectedOutputs:t.expectedOutputs.map(e=>({...e})),verifiedEvidenceIds:[...t.verifiedEvidenceIds],outputOffsets:{...t.outputOffsets},notification:t.notification?XT(t.notification):void 0}}function jT(t){let e=t.continuationPolicy===void 0&&t.maxContinuationTurns===qT,n=t.continuationPolicy??(t.maxContinuationTurns>=jo||e?"unbounded":"bounded"),r=Be({...t,continuationPolicy:n,maxContinuationTurns:n==="unbounded"?jo:Math.max(1,t.maxContinuationTurns)});return e&&r.status==="exhausted"&&!r.acknowledgedAt&&(r.status="ready"),r}function XT(t){return{...t,operationIds:[...t.operationIds],taskIds:[...t.taskIds],terminal:t.terminal.map(e=>({...e})),evidence:t.evidence.map(Mt)}}function zT(t){return t.replace(/\u001b\[[0-?]*[ -\/]*[@-~]/g,"").replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g,"").slice(-Da)}function GT(t){return new Promise(e=>setTimeout(e,t))}function WT(t,e){return t==="started"?"tool.operation.started":t==="progress"?"tool.operation.progress":t==="promotion_requested"?"tool.operation.promotion_requested":t==="promoted"?"tool.operation.promoted":t==="terminal"?e==="completed"?"tool.operation.completed":e==="timed_out"?"tool.operation.timed_out":e==="cancelled"?"tool.operation.cancelled":"tool.operation.failed":e==="stalled"?"tool.operation.stalled":e==="verifying"?"tool.operation.verifying":null}function HT(t,e){return t==="stdout"||t==="stderr"?"output is changing; continue waiting":t==="waiting_for_input"?"wait for user input without extending the operation deadline":t==="input"?"input accepted; wait for the next prompt or completion":e.completionPolicy==="await"?"wait for completion; do not finalize yet":e.suggestedNextAction??"observe operation state"}function VT(t,e){return t==="completed"?"validate semantic postconditions and synthesize the final answer":t==="orphaned"?"inspect partial artifacts; do not restart automatically":e==="POSTCONDITION_FAILED"?"inspect the missing or unstable expected output before retrying":"inspect terminal output and partial artifacts before choosing a bounded retry"}var z=new Ba;import{createHash as mS,randomUUID as pS}from"node:crypto";import{closeSync as fS,createWriteStream as fp,existsSync as gS,mkdirSync as hS,openSync as bS,readSync as wp,rmSync as gp,statSync as hp}from"node:fs";import{join as Xa,resolve as bp,sep as yS}from"node:path";import{spawn as up}from"node:child_process";import{randomUUID as QT}from"node:crypto";import{platform as ja}from"node:os";import{StringDecoder as rp}from"node:string_decoder";var JT=Symbol.for("@xenosystem/agent-sdk/shutdown-registry"),KT=globalThis,$a=KT[JT]??={cleanups:new Set,exitHandlerRegistered:!1,signalHandlersInstalled:!1},Ua=$a.cleanups;function YT(){for(let t of Ua)try{t()}catch{}}function bn(t){return Ua.add(t),!$a.exitHandlerRegistered&&typeof process<"u"&&typeof process.on=="function"&&($a.exitHandlerRegistered=!0,process.on("exit",YT)),()=>{Ua.delete(t)}}var Ye=class extends Error{constructor(n,r){super(r.startsWith(`${n}:`)?r:`${n}: ${r}`);this.code=n;this.name="UnifiedExecError"}code},op=256e3,ZT=128e3,sp=256,eS=64,tS=16,nS=8192,rS=8,oS=2e3,sS=1e4,ip=2,iS=1e3,aS=500,qa=class{processes=new Map;listeners=new Set;maxProcesses;maxPtyProcesses;ptyAdapter;disposeShutdown;constructor(e={}){this.maxProcesses=zo(e.maxProcesses,eS),this.maxPtyProcesses=zo(e.maxPtyProcesses,tS),(e.registerCleanup??!0)&&(this.disposeShutdown=bn(()=>this.terminateAll({force:!0})))}registerPtyAdapter(e){return this.ptyAdapter=e,()=>{this.ptyAdapter===e&&(this.ptyAdapter=void 0)}}getPtyCapability(){return this.ptyAdapter?{available:!0,adapter:this.ptyAdapter.name??"registered"}:{available:!1}}onEvent(e){return this.listeners.add(e),()=>this.listeners.delete(e)}start(e,n={}){if(this.pruneTerminalProcesses(),this.processes.size>=this.maxProcesses)throw new Ye("PROCESS_LIMIT",`Too many managed exec processes (${this.maxProcesses})`);let r=e.trim();if(!r)throw new Error("exec.start requires a non-empty command");let o=n.tty?"pty":"pipe";if(o==="pty"&&this.countPtyProcesses()>=this.maxPtyProcesses)throw new Ye("PROCESS_LIMIT",`Too many managed PTY processes (${this.maxPtyProcesses})`);if(o==="pty"&&Ke(n.sandbox))throw new Ye("PTY_UNAVAILABLE","Process-hardened and contained interactive terminals are not supported");if(n.invocation&&(o==="pty"||Ke(n.sandbox)))throw new Ye("INVOCATION_UNSUPPORTED","An explicit interpreter runs pipe-backed and unsecured only; a secured launch wraps the platform shell");let s=n.cwd??process.cwd(),i=new Date().toISOString(),a=o==="pty"?cp(n.cols,n.rows):void 0,c={id:QT(),command:r,cwd:s,mode:o,interactive:o==="pty",...a??{},ownerSessionId:n.ownerSessionId,origin:n.origin??"app_server",presentation:n.presentation??"background",status:"running",startedAt:i,lastActivityAt:i,outputBytes:0};if(o==="pty"&&!this.ptyAdapter)throw c.status="failed",c.endedAt=new Date().toISOString(),c.completionReason="spawn_error",this.emit({type:"process.pty_unavailable",process:c}),new Ye("PTY_UNAVAILABLE","Interactive terminal adapter is unavailable");try{let l=o==="pty"?this.startPty(c,n,a):this.startPipe(c,n);return this.processes.set(c.id,l),this.armTimeout(l,n.timeoutMs),this.emit({type:"process.started",process:c}),yn(c)}catch(l){c.status="failed",c.endedAt=new Date().toISOString(),c.completionReason="spawn_error";let u=l instanceof Error?l.message:String(l);throw this.emit({type:"process.failed",process:c,error:u}),l instanceof Ye?l:new Ye("SPAWN_ERROR",u)}}writeStdin(e,n,r={}){let o=this.processes.get(e);if(!o||o.meta.status!=="running")return!1;let s=r.source??"app_server";if(o.writerLease&&s!=="human")return!1;try{if(o.mode==="pty")o.pty.write(n);else{if(!o.child.stdin||o.child.stdin.destroyed)return!1;o.child.stdin.write(n)}return o.lastUsedMs=Date.now(),o.meta.lastActivityAt=new Date().toISOString(),this.emit({type:"process.input",process:o.meta,inputSource:s,inputBytes:Buffer.byteLength(n,"utf8")}),!0}catch{return!1}}readOutput(e){let n=this.processes.get(e);return n?(n.lastUsedMs=Date.now(),{process:yn(n.meta),output:n.output.toBuffer().toString("utf8"),totalBytes:n.meta.outputBytes,truncated:n.output.omittedBytes>0,omittedBytes:n.output.omittedBytes}):null}readOutputDelta(e,n=0,r={}){let o=this.processes.get(e);if(!o)return null;o.lastUsedMs=Date.now();let s=o.chunks.read(n,r);return{process:yn(o.meta),...s}}resize(e,n,r){let o=this.processes.get(e);if(!o||o.mode!=="pty"||o.meta.status!=="running")return!1;let s;try{s=cp(n,r,!1),o.pty.resize(s.cols,s.rows)}catch{return!1}return o.meta.cols=s.cols,o.meta.rows=s.rows,o.meta.lastActivityAt=new Date().toISOString(),this.emit({type:"process.resized",process:o.meta}),!0}acquireWriterLease(e,n="human"){let r=this.processes.get(e);return!r||r.meta.status!=="running"||r.writerLease?!1:(r.writerLease=n,this.emit({type:"process.attached",process:r.meta}),!0)}releaseWriterLease(e,n="human"){let r=this.processes.get(e);return!r||r.writerLease!==n?!1:(r.writerLease=void 0,this.emit({type:"process.detached",process:r.meta}),!0)}hasWriterLease(e){return!!this.processes.get(e)?.writerLease}updatePresentation(e,n){let r=this.processes.get(e);if(!r||r.meta.status!=="running")return!1;let o=r.meta.presentation??"background";return o===n||(r.meta.presentation=n,r.meta.lastActivityAt=new Date().toISOString(),this.emit({type:"process.presentation_changed",process:r.meta,previousPresentation:o})),!0}terminate(e,n={}){let r=this.processes.get(e);if(!r||this.hasExited(e))return!1;let o=n.reason??"terminated";return r.terminationReason||(r.terminationReason=o),mp(r),Fa(r,n.force??!1)?(!n.force&&!r.forceTimer&&(r.forceTimer=setTimeout(()=>{this.hasExited(e)||Fa(r,!0)},oS),r.forceTimer.unref?.()),!0):!1}terminateOwner(e,n={}){let r=0;for(let o of this.processes.values())o.meta.ownerSessionId!==e||this.hasExited(o.meta.id)||this.terminate(o.meta.id,{force:n.force})&&(r+=1);return r}terminateAll(e={}){let n=0;for(let r of this.processes.values())this.hasExited(r.meta.id)||this.terminate(r.meta.id,{force:e.force})&&(n+=1);return n}list(e={}){return Array.from(this.processes.values()).filter(n=>!e.ownerSessionId||n.meta.ownerSessionId===e.ownerSessionId).map(n=>yn(n.meta))}get(e){let n=this.processes.get(e);return n?yn(n.meta):null}hasExited(e){let n=this.processes.get(e);return n?n.exitObserved===!0||n.mode==="pipe"&&(typeof n.child.exitCode=="number"||typeof n.child.signalCode=="string"):!1}remove(e){let n=this.processes.get(e);return!n||!this.hasExited(e)?!1:(lp(n),n.mode==="pty"&&(n.disposeData(),n.disposeExit()),this.processes.delete(e))}dispose(){this.terminateAll({force:!0}),this.disposeShutdown?.(),this.disposeShutdown=void 0,this.listeners.clear()}startPipe(e,n){let r=ja()==="win32",o=ap(n.env,!1),s=n.sandbox&&Ke(n.sandbox)?Mm(e.command,{...n.sandbox,workingDirectory:e.cwd},process.platform,o,n.timeoutMs):null,i=null;if(r&&!s&&!n.invocation)try{i=nm(e.command,e.cwd)}catch{i=null}let a=s?.file??i?.file??n.invocation?.file??(r?process.env.COMSPEC??"cmd.exe":process.env.SHELL??"/bin/bash"),c=s?.args??i?.args??n.invocation?.args??(r?["/d","/s","/c",`"${e.command}"`]:["-lc",e.command]);e.processTreeAdapter=s?s.effectiveLevel:i?"windows-job-object":r?"windows-tree-fallback":"posix-process-group",e.processTreeCleanupVerified=!!(s||i||!r);let l=up(a,c,{cwd:s?.hostCwd??i?.hostCwd??e.cwd,env:{...o,...s?.env??i?.env??{}},stdio:[n.stdin==="ignore"?"ignore":"pipe","pipe","pipe"],windowsHide:!0,detached:!r,windowsVerbatimArguments:r&&!s&&!i&&!n.invocation});e.pid=l.pid;let u={mode:"pipe",meta:e,child:l,output:new Go(Math.max(1024,n.maxOutputBytes??op)),chunks:new Xo,stdoutDecoder:new rp("utf8"),stderrDecoder:new rp("utf8"),lastUsedMs:Date.now()};l.stdout?.on("data",m=>this.captureBuffer(u,"stdout",m)),l.stderr?.on("data",m=>this.captureBuffer(u,"stderr",m)),l.once("spawn",()=>pp(u)),l.on("error",m=>{l.pid==null&&this.observeExit(u),this.finalize(u,{error:m})}),l.on("close",(m,p)=>{this.observeExit(u),this.finalize(u,{exitCode:m,signal:p})});let d=Math.max(1,n.startupTimeoutMs??sS);return u.startupTimer=setTimeout(()=>{u.meta.status==="running"&&(Fa(u,!0),this.finalize(u,{error:new Error(`Process startup exceeded ${d}ms`)}))},d),u.startupTimer.unref?.(),u}startPty(e,n,r){let o=cS(e.command),s=this.ptyAdapter.spawn({file:o.file,args:o.args,cwd:e.cwd,env:ap(n.env,!0),cols:r.cols,rows:r.rows});e.pid=s.pid;let i={mode:"pty",meta:e,pty:s,output:new Go(Math.max(1024,n.maxOutputBytes??op)),chunks:new Xo,lastUsedMs:Date.now(),disposeData:()=>{},disposeExit:()=>{}};return i.disposeData=s.onData(a=>this.captureText(i,"stdout",a)),i.disposeExit=s.onExit(a=>{this.observeExit(i),this.finalize(i,{exitCode:a.exitCode,signalNumber:a.signal??null})}),i}observeExit(e){e.exitObserved||(e.exitObserved=!0,this.emit({type:"process.settled",process:e.meta}))}captureBuffer(e,n,r){e.meta.outputBytes+=r.length,e.meta.lastActivityAt=new Date().toISOString(),e.output.push(r);let o=n==="stdout"?e.stdoutDecoder:e.stderrDecoder;this.appendText(e,n,o.write(r))}captureText(e,n,r){if(!r)return;let o=Buffer.from(r,"utf8");e.meta.outputBytes+=o.length,e.meta.lastActivityAt=new Date().toISOString(),e.output.push(o),this.appendText(e,n,r)}appendText(e,n,r){for(let o of uS(r,nS)){let s=e.chunks.append(n,o);this.emit({type:"process.output",process:e.meta,chunk:s})}}finalize(e,n){if(e.meta.status==="running"){if(e.mode==="pipe"&&(this.appendText(e,"stdout",e.stdoutDecoder.end()),this.appendText(e,"stderr",e.stderrDecoder.end())),lp(e),e.writerLease=void 0,e.meta.endedAt=new Date().toISOString(),e.meta.lastActivityAt=e.meta.endedAt,e.meta.exitCode=n.exitCode??null,e.meta.signal=n.signal??null,e.meta.signalNumber=n.signalNumber??null,n.error&&!e.terminationReason){e.meta.status="failed",e.meta.completionReason="spawn_error",this.emit({type:"process.failed",process:e.meta,error:n.error.message});return}if(e.terminationReason){e.meta.status="terminated",e.meta.completionReason=e.terminationReason,this.emit({type:e.terminationReason==="output_limit"?"process.output_limit":"process.terminated",process:e.meta});return}e.meta.status="exited",e.meta.completionReason="exit",this.emit({type:"process.exited",process:e.meta})}}armTimeout(e,n){!n||n<=0||(e.timeout=setTimeout(()=>{this.terminate(e.meta.id,{reason:"timeout"})},n),e.timeout.unref?.())}countPtyProcesses(){let e=0;for(let n of this.processes.values())n.mode==="pty"&&n.meta.status==="running"&&(e+=1);return e}pruneTerminalProcesses(){if(this.processes.size<this.maxProcesses)return;let e=Array.from(this.processes.entries()),n=new Set(e.slice().sort((o,s)=>s[1].lastUsedMs-o[1].lastUsedMs).slice(0,rS).map(([o])=>o)),r=e.filter(([o])=>!n.has(o)&&this.hasExited(o)).sort((o,s)=>o[1].lastUsedMs-s[1].lastUsedMs)[0];r&&this.remove(r[0])}emit(e){let n={...e,process:yn(e.process),chunk:e.chunk?{...e.chunk}:void 0,timestamp:new Date().toISOString()};for(let r of this.listeners)try{r(n)}catch{}}},dp=new qa;function cS(t){return ja()==="win32"?{file:process.env.COMSPEC??"cmd.exe",args:`/d /s /c "${t}"`}:{file:process.env.SHELL??"/bin/bash",args:["-lc",t]}}function ap(t,e){let n={...process.env};for(let[o,s]of Object.entries(t??{})){if(s!==void 0){n[o]=s;continue}let i=o.toLowerCase();for(let a of Object.keys(n))a.toLowerCase()===i&&delete n[a]}let r=mn(n);return e?(r.TERM=t?.TERM??process.env.TERM??"xterm-256color",r.COLORTERM=t?.COLORTERM??process.env.COLORTERM??"truecolor",delete r.NO_COLOR,delete r.CI,delete r.XENO_CI,r):(r.NO_COLOR=t?.NO_COLOR??"1",r.TERM=t?.TERM??"dumb",r.PAGER=t?.PAGER??"cat",r.CI=t?.CI??process.env.CI??"1",r.XENO_CI=t?.XENO_CI??"1",r)}function cp(t,e,n=!0){let r=n&&t===void 0?80:t,o=n&&e===void 0?24:e;if(typeof r!="number"||typeof o!="number"||!Number.isFinite(r)||!Number.isFinite(o)||!Number.isInteger(r)||!Number.isInteger(o)||r<ip||r>iS||o<ip||o>aS)throw new Ye("INVALID_SIZE","Terminal dimensions are outside supported bounds");return{cols:r,rows:o}}function Fa(t,e){try{if(t.mode==="pty")return t.meta.processTreeAdapter="pty-adapter",t.meta.processTreeCleanupVerified=!0,t.pty.terminateTree({force:e}),!0;let n=t.child.pid;if(!n)return t.child.kill(e?"SIGKILL":"SIGTERM");if(ja()==="win32")return t.meta.processTreeAdapter==="windows-job-object"||t.meta.processTreeAdapter==="process-hardened"||t.meta.processTreeAdapter==="contained"?t.child.kill(e?"SIGKILL":"SIGTERM"):(lS(t),!0);try{return process.kill(-n,e?"SIGKILL":"SIGTERM"),!0}catch{return t.child.kill(e?"SIGKILL":"SIGTERM")}}catch{return!1}}function lS(t){let e=t.child.pid;if(!e){t.child.kill("SIGKILL");return}let n=`
+`,{encoding:"utf8",mode:384})}catch{}}persistOwner(e){if(!e)return;let n=Array.from(this.continuations.values()).some(r=>r.ownerSessionId===e&&r.goalTurn!==void 0);try{La(this.storeRoot,{recursive:!0,mode:448});let r={schemaVersion:n?2:1,ownerSessionId:e,operations:this.list({ownerSessionId:e}),continuations:Array.from(this.continuations.values()).filter(i=>i.ownerSessionId===e).map(Be)},o=this.ownerFile(e),s=`${o}.${process.pid}.${Uo()}.tmp`;$T(s,JSON.stringify(r,null,2),{encoding:"utf8",mode:384}),DT(s,o)}catch(r){if(n)throw Object.assign(new Error("Goal continuation persistence is unconfirmed; inspect state before retrying",{cause:r}),{code:"CONTINUATION_PERSISTENCE_UNCONFIRMED",retryable:!1})}}loadOwner(e){if(this.loadedOwners.has(e))return;this.loadedOwners.add(e);let n=this.ownerFile(e);if(MT(n))try{let r=JSON.parse(LT(n,"utf8"));if(![1,2].includes(r.schemaVersion)||r.ownerSessionId!==e)throw new Error("Unsupported or foreign operation state");if(!Array.isArray(r.operations)||!Array.isArray(r.continuations))throw new Error("Invalid operation state collections");let o=r.continuations.map(s=>{if(s.ownerSessionId!==e)throw new Error("Foreign continuation in operation state");return jT(s)});for(let s of r.operations??[]){if(this.operations.has(s.operationId))continue;let i=Date.parse(s.startedAt),a=Date.parse(s.lastActivityAt),c={snapshot:{...s,schemaVersion:Fo,expectedOutputs:qo(s.expectedOutputs),evidence:s.evidence?.map(Mt)},startedAtMs:Number.isFinite(i)?i:Date.now(),lastActivityAtMs:Number.isFinite(a)?a:Date.now(),promotionRequested:!1,previousRunningState:s.presentation==="background"?"running_background":"running_foreground"};this.operations.set(s.operationId,c),this.armDeadline(c),s.taskId&&this.taskToOperation.set(s.taskId,s.operationId)}for(let s of o)if(!this.continuations.has(s.continuationId)){let i=s;i.status==="running"&&!i.acknowledgedAt&&(i.status="ready"),this.continuations.set(s.continuationId,i)}}catch(r){throw this.loadedOwners.delete(e),Object.assign(new Error("Operation state could not be read; original state was preserved",{cause:r}),{code:"CONTINUATION_STATE_UNAVAILABLE",retryable:!1})}}};function qo(t){return t?.map(e=>({...e,path:UT(e.path)}))}function Mt(t){return{...t,detail:t.detail?{...t.detail}:void 0}}function Be(t){return{...t,...t.goalTurn!==void 0?{goalTurn:lr(t.goalTurn)}:{},operationIds:[...t.operationIds??t.pendingOperationIds],pendingOperationIds:[...t.pendingOperationIds],expectedOutputs:t.expectedOutputs.map(e=>({...e})),verifiedEvidenceIds:[...t.verifiedEvidenceIds],outputOffsets:{...t.outputOffsets},notification:t.notification?XT(t.notification):void 0}}function jT(t){let e=t.continuationPolicy===void 0&&t.maxContinuationTurns===qT,n=t.continuationPolicy??(t.maxContinuationTurns>=jo||e?"unbounded":"bounded"),r=Be({...t,continuationPolicy:n,maxContinuationTurns:n==="unbounded"?jo:Math.max(1,t.maxContinuationTurns)});return e&&r.status==="exhausted"&&!r.acknowledgedAt&&(r.status="ready"),r}function XT(t){return{...t,operationIds:[...t.operationIds],taskIds:[...t.taskIds],terminal:t.terminal.map(e=>({...e})),evidence:t.evidence.map(Mt)}}function zT(t){return t.replace(/\u001b\[[0-?]*[ -\/]*[@-~]/g,"").replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g,"").slice(-Da)}function GT(t){return new Promise(e=>setTimeout(e,t))}function WT(t,e){return t==="started"?"tool.operation.started":t==="progress"?"tool.operation.progress":t==="promotion_requested"?"tool.operation.promotion_requested":t==="promoted"?"tool.operation.promoted":t==="terminal"?e==="completed"?"tool.operation.completed":e==="timed_out"?"tool.operation.timed_out":e==="cancelled"?"tool.operation.cancelled":"tool.operation.failed":e==="stalled"?"tool.operation.stalled":e==="verifying"?"tool.operation.verifying":null}function HT(t,e){return t==="stdout"||t==="stderr"?"output is changing; continue waiting":t==="waiting_for_input"?"wait for user input without extending the operation deadline":t==="input"?"input accepted; wait for the next prompt or completion":e.completionPolicy==="await"?"wait for completion; do not finalize yet":e.suggestedNextAction??"observe operation state"}function VT(t,e){return t==="completed"?"validate semantic postconditions and synthesize the final answer":t==="orphaned"?"inspect partial artifacts; do not restart automatically":e==="POSTCONDITION_FAILED"?"inspect the missing or unstable expected output before retrying":"inspect terminal output and partial artifacts before choosing a bounded retry"}var z=new Ba;import{createHash as mS,randomUUID as pS}from"node:crypto";import{closeSync as fS,createWriteStream as fp,existsSync as gS,mkdirSync as hS,openSync as bS,readSync as wp,rmSync as gp,statSync as hp}from"node:fs";import{join as Xa,resolve as bp,sep as yS}from"node:path";import{spawn as up}from"node:child_process";import{randomUUID as QT}from"node:crypto";import{platform as ja}from"node:os";import{StringDecoder as rp}from"node:string_decoder";var JT=Symbol.for("@xenosystem/agent-sdk/shutdown-registry"),KT=globalThis,$a=KT[JT]??={cleanups:new Set,exitHandlerRegistered:!1,signalHandlersInstalled:!1},Ua=$a.cleanups;function YT(){for(let t of Ua)try{t()}catch{}}function bn(t){return Ua.add(t),!$a.exitHandlerRegistered&&typeof process<"u"&&typeof process.on=="function"&&($a.exitHandlerRegistered=!0,process.on("exit",YT)),()=>{Ua.delete(t)}}var Ye=class extends Error{constructor(n,r){super(r.startsWith(`${n}:`)?r:`${n}: ${r}`);this.code=n;this.name="UnifiedExecError"}code},op=256e3,ZT=128e3,sp=256,eS=64,tS=16,nS=8192,rS=8,oS=2e3,sS=1e4,ip=2,iS=1e3,aS=500,qa=class{processes=new Map;listeners=new Set;maxProcesses;maxPtyProcesses;ptyAdapter;disposeShutdown;constructor(e={}){this.maxProcesses=zo(e.maxProcesses,eS),this.maxPtyProcesses=zo(e.maxPtyProcesses,tS),(e.registerCleanup??!0)&&(this.disposeShutdown=bn(()=>this.terminateAll({force:!0})))}registerPtyAdapter(e){return this.ptyAdapter=e,()=>{this.ptyAdapter===e&&(this.ptyAdapter=void 0)}}getPtyCapability(){return this.ptyAdapter?{available:!0,adapter:this.ptyAdapter.name??"registered"}:{available:!1}}onEvent(e){return this.listeners.add(e),()=>this.listeners.delete(e)}start(e,n={}){if(this.pruneTerminalProcesses(),this.processes.size>=this.maxProcesses)throw new Ye("PROCESS_LIMIT",`Too many managed exec processes (${this.maxProcesses})`);let r=e.trim();if(!r)throw new Error("exec.start requires a non-empty command");let o=n.tty?"pty":"pipe";if(o==="pty"&&this.countPtyProcesses()>=this.maxPtyProcesses)throw new Ye("PROCESS_LIMIT",`Too many managed PTY processes (${this.maxPtyProcesses})`);if(o==="pty"&&Ke(n.sandbox))throw new Ye("PTY_UNAVAILABLE","Process-hardened and contained interactive terminals are not supported");if(n.invocation&&(o==="pty"||Ke(n.sandbox)))throw new Ye("INVOCATION_UNSUPPORTED","An explicit interpreter runs pipe-backed and unsecured only; a secured launch wraps the platform shell");let s=n.cwd??process.cwd(),i=new Date().toISOString(),a=o==="pty"?cp(n.cols,n.rows):void 0,c={id:QT(),command:r,cwd:s,mode:o,interactive:o==="pty",...a??{},ownerSessionId:n.ownerSessionId,origin:n.origin??"app_server",presentation:n.presentation??"background",status:"running",startedAt:i,lastActivityAt:i,outputBytes:0};if(o==="pty"&&!this.ptyAdapter)throw c.status="failed",c.endedAt=new Date().toISOString(),c.completionReason="spawn_error",this.emit({type:"process.pty_unavailable",process:c}),new Ye("PTY_UNAVAILABLE","Interactive terminal adapter is unavailable");try{let l=o==="pty"?this.startPty(c,n,a):this.startPipe(c,n);return this.processes.set(c.id,l),this.armTimeout(l,n.timeoutMs),this.emit({type:"process.started",process:c}),yn(c)}catch(l){c.status="failed",c.endedAt=new Date().toISOString(),c.completionReason="spawn_error";let u=l instanceof Error?l.message:String(l);throw this.emit({type:"process.failed",process:c,error:u}),l instanceof Ye?l:new Ye("SPAWN_ERROR",u)}}writeStdin(e,n,r={}){let o=this.processes.get(e);if(!o||o.meta.status!=="running")return!1;let s=r.source??"app_server";if(o.writerLease&&s!=="human")return!1;try{if(o.mode==="pty")o.pty.write(n);else{if(!o.child.stdin||o.child.stdin.destroyed)return!1;o.child.stdin.write(n)}return o.lastUsedMs=Date.now(),o.meta.lastActivityAt=new Date().toISOString(),this.emit({type:"process.input",process:o.meta,inputSource:s,inputBytes:Buffer.byteLength(n,"utf8")}),!0}catch{return!1}}readOutput(e){let n=this.processes.get(e);return n?(n.lastUsedMs=Date.now(),{process:yn(n.meta),output:n.output.toBuffer().toString("utf8"),totalBytes:n.meta.outputBytes,truncated:n.output.omittedBytes>0,omittedBytes:n.output.omittedBytes}):null}readOutputDelta(e,n=0,r={}){let o=this.processes.get(e);if(!o)return null;o.lastUsedMs=Date.now();let s=o.chunks.read(n,r);return{process:yn(o.meta),...s}}resize(e,n,r){let o=this.processes.get(e);if(!o||o.mode!=="pty"||o.meta.status!=="running")return!1;let s;try{s=cp(n,r,!1),o.pty.resize(s.cols,s.rows)}catch{return!1}return o.meta.cols=s.cols,o.meta.rows=s.rows,o.meta.lastActivityAt=new Date().toISOString(),this.emit({type:"process.resized",process:o.meta}),!0}acquireWriterLease(e,n="human"){let r=this.processes.get(e);return!r||r.meta.status!=="running"||r.writerLease?!1:(r.writerLease=n,this.emit({type:"process.attached",process:r.meta}),!0)}releaseWriterLease(e,n="human"){let r=this.processes.get(e);return!r||r.writerLease!==n?!1:(r.writerLease=void 0,this.emit({type:"process.detached",process:r.meta}),!0)}hasWriterLease(e){return!!this.processes.get(e)?.writerLease}updatePresentation(e,n){let r=this.processes.get(e);if(!r||r.meta.status!=="running")return!1;let o=r.meta.presentation??"background";return o===n||(r.meta.presentation=n,r.meta.lastActivityAt=new Date().toISOString(),this.emit({type:"process.presentation_changed",process:r.meta,previousPresentation:o})),!0}terminate(e,n={}){let r=this.processes.get(e);if(!r||this.hasExited(e))return!1;let o=n.reason??"terminated";return r.terminationReason||(r.terminationReason=o),mp(r),Fa(r,n.force??!1)?(!n.force&&!r.forceTimer&&(r.forceTimer=setTimeout(()=>{this.hasExited(e)||Fa(r,!0)},oS),r.forceTimer.unref?.()),!0):!1}terminateOwner(e,n={}){let r=0;for(let o of this.processes.values())o.meta.ownerSessionId!==e||this.hasExited(o.meta.id)||this.terminate(o.meta.id,{force:n.force})&&(r+=1);return r}terminateAll(e={}){let n=0;for(let r of this.processes.values())this.hasExited(r.meta.id)||this.terminate(r.meta.id,{force:e.force})&&(n+=1);return n}list(e={}){return Array.from(this.processes.values()).filter(n=>!e.ownerSessionId||n.meta.ownerSessionId===e.ownerSessionId).map(n=>yn(n.meta))}get(e){let n=this.processes.get(e);return n?yn(n.meta):null}hasExited(e){let n=this.processes.get(e);return n?n.exitObserved===!0||n.mode==="pipe"&&(typeof n.child.exitCode=="number"||typeof n.child.signalCode=="string"):!1}remove(e){let n=this.processes.get(e);return!n||!this.hasExited(e)?!1:(!n.exitObserved&&n.mode==="pipe"&&(this.observeExit(n),this.finalize(n,{exitCode:n.child.exitCode,signal:n.child.signalCode})),lp(n),n.mode==="pty"&&(n.disposeData(),n.disposeExit()),this.processes.delete(e))}dispose(){this.terminateAll({force:!0}),this.disposeShutdown?.(),this.disposeShutdown=void 0,this.listeners.clear()}startPipe(e,n){let r=ja()==="win32",o=ap(n.env,!1),s=n.sandbox&&Ke(n.sandbox)?Mm(e.command,{...n.sandbox,workingDirectory:e.cwd},process.platform,o,n.timeoutMs):null,i=null;if(r&&!s&&!n.invocation)try{i=nm(e.command,e.cwd)}catch{i=null}let a=s?.file??i?.file??n.invocation?.file??(r?process.env.COMSPEC??"cmd.exe":process.env.SHELL??"/bin/bash"),c=s?.args??i?.args??n.invocation?.args??(r?["/d","/s","/c",`"${e.command}"`]:["-lc",e.command]);e.processTreeAdapter=s?s.effectiveLevel:i?"windows-job-object":r?"windows-tree-fallback":"posix-process-group",e.processTreeCleanupVerified=!!(s||i||!r);let l=up(a,c,{cwd:s?.hostCwd??i?.hostCwd??e.cwd,env:{...o,...s?.env??i?.env??{}},stdio:[n.stdin==="ignore"?"ignore":"pipe","pipe","pipe"],windowsHide:!0,detached:!r,windowsVerbatimArguments:r&&!s&&!i&&!n.invocation});e.pid=l.pid;let u={mode:"pipe",meta:e,child:l,output:new Go(Math.max(1024,n.maxOutputBytes??op)),chunks:new Xo,stdoutDecoder:new rp("utf8"),stderrDecoder:new rp("utf8"),lastUsedMs:Date.now()};l.stdout?.on("data",m=>this.captureBuffer(u,"stdout",m)),l.stderr?.on("data",m=>this.captureBuffer(u,"stderr",m)),l.once("spawn",()=>pp(u)),l.on("error",m=>{l.pid==null&&this.observeExit(u),this.finalize(u,{error:m})}),l.on("close",(m,p)=>{this.observeExit(u),this.finalize(u,{exitCode:m,signal:p})});let d=Math.max(1,n.startupTimeoutMs??sS);return u.startupTimer=setTimeout(()=>{u.meta.status==="running"&&(Fa(u,!0),this.finalize(u,{error:new Error(`Process startup exceeded ${d}ms`)}))},d),u.startupTimer.unref?.(),u}startPty(e,n,r){let o=cS(e.command),s=this.ptyAdapter.spawn({file:o.file,args:o.args,cwd:e.cwd,env:ap(n.env,!0),cols:r.cols,rows:r.rows});e.pid=s.pid;let i={mode:"pty",meta:e,pty:s,output:new Go(Math.max(1024,n.maxOutputBytes??op)),chunks:new Xo,lastUsedMs:Date.now(),disposeData:()=>{},disposeExit:()=>{}};return i.disposeData=s.onData(a=>this.captureText(i,"stdout",a)),i.disposeExit=s.onExit(a=>{this.observeExit(i),this.finalize(i,{exitCode:a.exitCode,signalNumber:a.signal??null})}),i}observeExit(e){e.exitObserved||(e.exitObserved=!0,this.emit({type:"process.settled",process:e.meta}))}captureBuffer(e,n,r){e.meta.outputBytes+=r.length,e.meta.lastActivityAt=new Date().toISOString(),e.output.push(r);let o=n==="stdout"?e.stdoutDecoder:e.stderrDecoder;this.appendText(e,n,o.write(r))}captureText(e,n,r){if(!r)return;let o=Buffer.from(r,"utf8");e.meta.outputBytes+=o.length,e.meta.lastActivityAt=new Date().toISOString(),e.output.push(o),this.appendText(e,n,r)}appendText(e,n,r){for(let o of uS(r,nS)){let s=e.chunks.append(n,o);this.emit({type:"process.output",process:e.meta,chunk:s})}}finalize(e,n){if(e.meta.status==="running"){if(e.mode==="pipe"&&(this.appendText(e,"stdout",e.stdoutDecoder.end()),this.appendText(e,"stderr",e.stderrDecoder.end())),lp(e),e.writerLease=void 0,e.meta.endedAt=new Date().toISOString(),e.meta.lastActivityAt=e.meta.endedAt,e.meta.exitCode=n.exitCode??null,e.meta.signal=n.signal??null,e.meta.signalNumber=n.signalNumber??null,n.error&&!e.terminationReason){e.meta.status="failed",e.meta.completionReason="spawn_error",this.emit({type:"process.failed",process:e.meta,error:n.error.message});return}if(e.terminationReason){e.meta.status="terminated",e.meta.completionReason=e.terminationReason,this.emit({type:e.terminationReason==="output_limit"?"process.output_limit":"process.terminated",process:e.meta});return}e.meta.status="exited",e.meta.completionReason="exit",this.emit({type:"process.exited",process:e.meta})}}armTimeout(e,n){!n||n<=0||(e.timeout=setTimeout(()=>{this.terminate(e.meta.id,{reason:"timeout"})},n),e.timeout.unref?.())}countPtyProcesses(){let e=0;for(let n of this.processes.values())n.mode==="pty"&&n.meta.status==="running"&&(e+=1);return e}pruneTerminalProcesses(){if(this.processes.size<this.maxProcesses)return;let e=Array.from(this.processes.entries()),n=new Set(e.slice().sort((o,s)=>s[1].lastUsedMs-o[1].lastUsedMs).slice(0,rS).map(([o])=>o)),r=e.filter(([o])=>!n.has(o)&&this.hasExited(o)).sort((o,s)=>o[1].lastUsedMs-s[1].lastUsedMs)[0];r&&this.remove(r[0])}emit(e){let n={...e,process:yn(e.process),chunk:e.chunk?{...e.chunk}:void 0,timestamp:new Date().toISOString()};for(let r of this.listeners)try{r(n)}catch{}}},dp=new qa;function cS(t){return ja()==="win32"?{file:process.env.COMSPEC??"cmd.exe",args:`/d /s /c "${t}"`}:{file:process.env.SHELL??"/bin/bash",args:["-lc",t]}}function ap(t,e){let n={...process.env};for(let[o,s]of Object.entries(t??{})){if(s!==void 0){n[o]=s;continue}let i=o.toLowerCase();for(let a of Object.keys(n))a.toLowerCase()===i&&delete n[a]}let r=mn(n);return e?(r.TERM=t?.TERM??process.env.TERM??"xterm-256color",r.COLORTERM=t?.COLORTERM??process.env.COLORTERM??"truecolor",delete r.NO_COLOR,delete r.CI,delete r.XENO_CI,r):(r.NO_COLOR=t?.NO_COLOR??"1",r.TERM=t?.TERM??"dumb",r.PAGER=t?.PAGER??"cat",r.CI=t?.CI??process.env.CI??"1",r.XENO_CI=t?.XENO_CI??"1",r)}function cp(t,e,n=!0){let r=n&&t===void 0?80:t,o=n&&e===void 0?24:e;if(typeof r!="number"||typeof o!="number"||!Number.isFinite(r)||!Number.isFinite(o)||!Number.isInteger(r)||!Number.isInteger(o)||r<ip||r>iS||o<ip||o>aS)throw new Ye("INVALID_SIZE","Terminal dimensions are outside supported bounds");return{cols:r,rows:o}}function Fa(t,e){try{if(t.mode==="pty")return t.meta.processTreeAdapter="pty-adapter",t.meta.processTreeCleanupVerified=!0,t.pty.terminateTree({force:e}),!0;let n=t.child.pid;if(!n)return t.child.kill(e?"SIGKILL":"SIGTERM");if(ja()==="win32")return t.meta.processTreeAdapter==="windows-job-object"||t.meta.processTreeAdapter==="process-hardened"||t.meta.processTreeAdapter==="contained"?t.child.kill(e?"SIGKILL":"SIGTERM"):(lS(t),!0);try{return process.kill(-n,e?"SIGKILL":"SIGTERM"),!0}catch{return t.child.kill(e?"SIGKILL":"SIGTERM")}}catch{return!1}}function lS(t){let e=t.child.pid;if(!e){t.child.kill("SIGKILL");return}let n=`
 Add-Type -TypeDefinition @'
 using System;
 using System.Collections.Generic;