@kodax-ai/kodax 0.7.63 → 0.7.67

package/dist/chunks/chunk-KBBGDRER.js

@@ -0,0 +1,22 @@
+// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
+import{Gb as Ke,Hb as ze,Ib as pe,Ja as me,Jb as Ge,Ka as Le,Kb as Je,Rc as Xe,Sc as Ye}from"./chunk-YH5BTUQO.js";import{N as $e}from"./chunk-O7N22GJ3.js";import{Be as je,Ce as Be,De as He,_a as de,ee as De,fe as Ue,he as K,ib as Ne,le as ue,re as fe,se as N,te as le,ue as Ve}from"./chunk-NVDK375I.js";import{B as _e}from"./chunk-PZTG2C33.js";import{a as i}from"./chunk-ONUPGMER.js";import{basename as pr,dirname as gr}from"node:path";import{execFile as Zt}from"node:child_process";import Y from"node:path";import{promisify as Qt}from"node:util";var en=Qt(Zt),tn=1e4,at=2,Ze=new Set(["write","edit","multi_edit","insert_after_anchor"]),Qe=new Set(["read"]),nn=/^\s*(?:let me|i will|i'll|i am going to)\b[\s\S]{0,120}\b(?:start|create|implement|write|build|plan)\b|^\s*(?:我将|让我|接下来)[\s\S]{0,80}(?:开始|创建|编写|实现|制定)/i;function et(e){if(e?.timeoutMs!==void 0){if(!Number.isFinite(e.timeoutMs)||e.timeoutMs<=0)throw new Error("workflow wait timeoutMs must be a positive number");return Math.floor(e.timeoutMs)}}i(et,"normalizeWaitTimeoutMs");function ge(e){return e?.requiresMutation===!0||(e?.requiredChangedPaths?.length??0)>0}i(ge,"hasVerificationWork");function D(e){return e.replace(/\\/g,"/").replace(/^\.\//,"").trim()}i(D,"normalizeWorkspacePath");function we(e,t){let n=t.gitRoot?Y.resolve(t.gitRoot):void 0,r=Y.isAbsolute(e)&&n?Y.relative(n,Y.resolve(e)):e;return D(r)}i(we,"normalizeRequiredPath");function rn(e){let t=(e.readOnly??!1)===!1?{enforcement:"warn",requiresMutation:!0,rejectPreparatoryFinalText:!0}:void 0;if(e.verification!==void 0){let n={...t??{},...e.verification,enforcement:e.verification.enforcement??"hard"},r=e.verification.requiredChangedPaths;return{verification:{...n,...r!==void 0&&r.length>0&&n.requiresMutation===void 0?{requiresMutation:!0}:{}}}}return{verification:t}}i(rn,"resolveVerificationForInput");function on(e,t){if(t===!0&&e.readOnly===!1)throw new Error(`workflow manifest readOnly=true cannot spawn write-capable child "${e.name}"; set the workflow manifest readOnly=false or use child readOnly:true`);let n=e.readOnly??t??!1;return e.readOnly===n?e:{...e,readOnly:n}}i(on,"resolveSpawnAgentInput");function st(e){let t=e.trim();return t.length>0&&nn.test(t)}i(st,"isPreparatoryOnlyText");function an(e,t){let n=e.trim(),r=t?.trim();return r&&(n.length===0||st(n))?r:e}i(an,"selectWorkflowFinalText");async function Z(e,t){return(await en("git",[...e],{cwd:t,timeout:tn,windowsHide:!0,maxBuffer:4194304})).stdout.toString()}i(Z,"runGit");async function sn(e){let t=e.gitRoot??e.executionCwd??process.cwd(),n=(await Z(["rev-parse","--show-toplevel"],t)).trim(),r=await Promise.all([Z(["diff","--name-only","--"],n),Z(["diff","--cached","--name-only","--"],n),Z(["ls-files","--others","--exclude-standard"],n)]);return[...new Set(r.flatMap(a=>a.split(/\r?\n/)).map(D).filter(a=>a.length>0))]}i(sn,"listGitChangedFiles");async function he(e,t){try{return{paths:(await t(e)).map(D).filter(r=>r.length>0)}}catch(n){return{paths:[],error:n instanceof Error?n.message:String(n)}}}i(he,"captureChangedPaths");function cn(){return{toolNameById:new Map,toolPathById:new Map,succeededToolCalls:[],succeededPaths:[],readPathById:new Map,succeededReadPaths:[]}}i(cn,"createMutationRecorder");function tt(e){if(e)for(let t of["path","file_path","target_path"]){let n=e[t];if(typeof n=="string"&&n.trim().length>0)return D(n)}}i(tt,"readMutationPath");function dn(e,t){return{...e??{},onToolUseStart:i((n,r)=>{if(Ze.has(n.name)){t.toolNameById.set(n.id,n.name);let a=tt(n.input);a!==void 0&&t.toolPathById.set(n.id,a)}if(Qe.has(n.name)){let a=tt(n.input);a!==void 0&&t.readPathById.set(n.id,a)}e?.onToolUseStart?.(n,r)},"onToolUseStart"),onToolResult:i((n,r)=>{let a=t.toolNameById.get(n.id)??n.name;if(Ze.has(a)&&!n.content.trimStart().startsWith("[Tool Error]")){t.succeededToolCalls.push(a);let o=t.toolPathById.get(n.id);o!==void 0&&t.succeededPaths.push(o)}if(Qe.has(a)&&!n.content.trimStart().startsWith("[Tool Error]")){let o=t.readPathById.get(n.id);o!==void 0&&t.succeededReadPaths.push(o)}e?.onToolResult?.(n,r)},"onToolResult")}}i(dn,"wrapEventsForMutationRecording");function Q(e){return[...new Set(e.filter(t=>t.trim().length>0))]}i(Q,"uniqueItems");function nt(e){let t=e.verification;if(!t)return;let n=[],r=new Set(e.before.paths.map(D)),a=Q(e.after.paths.map(D)),o=a.filter(w=>!r.has(w)),s=Q(e.mutationRecorder.succeededToolCalls),d=e.acceptToolMutationEvidence?s:[],p=e.acceptToolMutationEvidence?Q(e.mutationRecorder.succeededPaths.map(D)):[],m=o.length>0||d.length>0,h=t.enforcement??"hard",S=(t.requiredChangedPaths??[]).map(w=>we(w,e.ctx)),x=Q(e.mutationRecorder.succeededReadPaths.map(w=>we(w,e.ctx))),y=(t.requiredReadPaths??[]).map(w=>we(w,e.ctx));t.requiresMutation===!0&&(e.before.error!==void 0||e.after.error!==void 0?n.push(`workspace mutation verification could not read changed files: ${e.after.error??e.before.error}`):m||n.push(e.acceptToolMutationEvidence||s.length===0?"expected file mutations, but no new workspace changes or successful write tools were observed":"write tools ran in an isolated worktree, but no main workspace changes were present after cleanup")),e.term.limitReached===!0&&!m&&n.push("workflow child reached its iteration limit before satisfying the task");for(let w of S)!a.includes(w)&&!p.includes(w)&&n.push(`required changed path was not present in workspace changes: ${w}`);for(let w of y)x.includes(w)||n.push(`required review evidence was not read: ${w}`);let E=t.minFinalTextChars;return E!==void 0&&!m&&e.term.finalText.trim().length<E&&n.push(`finalText was shorter than the required ${E} characters`),t.rejectPreparatoryFinalText===!0&&!m&&st(e.term.finalText)&&n.push("finalText looks preparatory instead of terminal"),{ok:n.length===0,enforcement:h,reasons:n,changedPaths:a,mutationToolCalls:s,mutationEvidence:m,...x.length>0?{readPaths:x}:{}}}i(nt,"evaluateVerification");function ye(e,t){if(t.ok)return e;let r=[t.enforcement==="warn"?"[Workflow task completed without verification]":"[Workflow task verification failed]",...t.reasons.map(a=>`- ${a}`)].join(`
+`);return e.trim().length>0?`${e}
+
+${r}`:r}i(ye,"appendVerificationFailure");function ct(e){return e.state==="completed"?"completed":e.state==="canceled"?"stopped":e.state==="failed"||e.state==="rejected"||e.state==="unknown"?"failed":"running"}i(ct,"externalWorkflowStatus");function un(e,t){return{taskId:e.taskId,name:t,status:ct(e),finalText:e.output??e.error??"",...e.usage?{usage:e.usage}:{}}}i(un,"externalWorkflowResult");function fn(e,t){let n=ct(e);return{taskId:e.taskId,name:t,status:n,...e.output!==void 0?{lastText:e.output}:{},...e.output===void 0&&e.error!==void 0?{lastText:e.error}:{}}}i(fn,"externalWorkflowSnapshot");function rt(){return{ok:!1,enforcement:"warn",reasons:["workflow child reached its iteration limit before satisfying the task"],mutationEvidence:!1}}i(rt,"limitReachedWarningVerification");function ln(e){return e.entry.bundle.readOnly!==!0&&e.entry.repairAttempts<at&&e.term.status==="completed"&&e.verification!==void 0&&e.verification.ok!==!0&&e.verification.enforcement!=="warn"}i(ln,"shouldRepairVerificationFailure");function mn(e){let t=e.verification.reasons.map(r=>`- ${r}`).join(`
+`),n=(e.verification.changedPaths??[]).length>0?`
+Workspace changes already present before this repair attempt:
+${e.verification.changedPaths?.map(r=>`- ${r}`).join(`
+`)??""}`:"";return[e.originalPrompt,"","[Workflow verification repair]",`Repair attempt ${e.attempt}/${at}.`,"The previous attempt did not satisfy the workflow postconditions.","Do not stop at analysis, planning, or a promise to begin. Complete the required file writes in the real workspace now.","Use the available file editing tools when a file change is required, then report the exact files changed.","","Verification failures:",t,n,"","Previous terminal response:",e.previousFinalText.trim()||"(empty)"].join(`
+`)}i(mn,"buildVerificationRepairPrompt");async function ot(e,t,n,r,a=n){if(n===void 0)return e;let o;try{return await Promise.race([e,new Promise((s,d)=>{o=setTimeout(()=>{r.childAbortControllers?.get(t)?.abort(),d(new Error(`workflow task ${t} timed out after ${a??n}ms`))},n)})])}finally{o&&clearTimeout(o)}}i(ot,"waitForChildPromise");function it(e,t,n,r=!1){return t.outputSchema!==void 0&&Le(t.outputSchema),Ye(t.name,t.evidenceRefs,n),{id:e,fanoutClass:"evidence-scan",objective:t.prompt,...t.scopeSummary?{scopeSummary:t.scopeSummary}:{},readOnly:t.readOnly??!1,evidenceRefs:t.evidenceRefs?[...t.evidenceRefs]:[],constraints:t.constraints?[...t.constraints]:[],...t.modelHint?{modelHint:t.modelHint}:{},...t.isolation?{isolation:t.isolation}:{},...t.subagentType?{specialistName:t.subagentType}:{},...t.outputSchema!==void 0?{outputSchema:t.outputSchema}:{},...r?{workflowOutputContract:{kodaxAuthored:!0,terseResult:t.terseResult===!0}}:{},...t.effort?{effort:t.effort}:{}}}i(it,"buildBundle");function ve(e,t){if(e.cancelledChildren.includes(t))return{status:"stopped",snapStatus:"aborted",finalText:""};let n=e.results[0],r=an(n?.summary??"",n?.digest);return n?.status==="completed"?{status:"completed",snapStatus:"completed",finalText:r,...n.digest?{digest:n.digest}:{},...n.digestFailed?{digestFailed:!0}:{},...n.digestPending?{digestPending:!0}:{},...n.limitReached?{limitReached:!0}:{},...n.provider?{provider:n.provider}:{},...n.model?{model:n.model}:{},...n.structured!==void 0?{structured:n.structured}:{},...n.digestTokensUsed!==void 0?{digestTokensUsed:n.digestTokensUsed}:{},...n.digestUsage!==void 0?{digestUsage:n.digestUsage}:{},...n.routeFacts?{routeFacts:n.routeFacts}:{}}:{status:"failed",snapStatus:"failed",finalText:r,...n?.limitReached?{limitReached:!0}:{},...n?.provider?{provider:n.provider}:{},...n?.model?{model:n.model}:{},...n?.digestTokensUsed!==void 0?{digestTokensUsed:n.digestTokensUsed}:{},...n?.digestUsage!==void 0?{digestUsage:n.digestUsage}:{},...n?.routeFacts?{routeFacts:n.routeFacts}:{}}}i(ve,"deriveTerminal");function dt(e){let{ctx:t,childOptions:n}=e,r=e.runChild??Xe,a=e.queue??_e(),o=e.listChangedFiles??sn,s=e.now??(()=>Date.now()),d=0,p=e.generateId??(()=>`wf-child-${d+=1}`),m=new Map,h=new Map,S=new Set,x=new Map,y=i(()=>e.onTaskSummary!==void 0||S.size>0,"hasTaskSummaryObservers"),E=i((u,f)=>{try{e.onTaskSummary?.(u,f)}catch{}for(let g of S)try{g(u,f)}catch{}},"notifyTaskSummary");return{spawn:i(async u=>{let f=on(u,e.defaultChildReadOnly);if(f.target&&f.subagentType)throw new Error("Workflow target and subagentType are mutually exclusive.");if(f.target){let M=t.agentExecutorPlane;if(!M)throw new Error("Workflow target requires a host-bound agent executor plane.");let W=Ke(f.target.agentId,M.context,t.agentScope);if(W){if(f.target.expectedConfigurationRevision!==void 0&&f.target.expectedConfigurationRevision!==W.descriptor.configurationRevision)throw new Error("Workflow target configuration revision changed.");let{target:I,...F}=f;f={...F,...W.subagentType?{subagentType:W.subagentType}:{}}}else{if(f.modelHint!==void 0||f.effort!==void 0)throw new Error("External Workflow targets cannot combine local modelHint/effort routing selectors.");if(f.verification?.requiresMutation===!0)throw new Error("External Workflow targets cannot directly satisfy workspace mutation verification.");let I=p();return await M.plane.tasks.start({taskId:I,agentId:f.target.agentId,objective:f.prompt,context:{...M.context,...e.runId?{workflowId:e.runId}:{}},readOnly:f.readOnly,...f.target.expectedConfigurationRevision?{expectedConfigurationRevision:f.target.expectedConfigurationRevision}:{}}),h.set(I,{name:f.name}),{taskId:I,name:f.name}}}let g=p(),l=it(g,f,new Set(m.keys()),e.kodaxAuthored===!0),k=rn(f).verification,O=cn(),_=f.isolation!=="worktree",L=ge(k)?he(t,o):Promise.resolve({paths:[]}),c=t.childProgressSnapshots,A=i(async M=>{let W=new AbortController;t.childAbortControllers?.set(g,W),c&&ze(c,{childId:g,startedAt:s(),maxIterations:n.maxIterationsPerChild,parentRole:n.parentRole,readOnly:M.readOnly,specialistName:M.specialistName});let I={...n,parentOptions:{...n.parentOptions,events:dn(n.parentOptions.events,O)},maxParallel:1,workflowChild:!0,...e.runId!==void 0?{workflowCorrelation:{workflowRunId:e.runId,childAgentId:g,itemId:`agent:${g}`}}:{},childActivityName:f.name,workflowDigestMode:y()?"async":"blocking",...y()?{onWorkflowChildDigest:i(R=>{E(R.childId,{...R.digest?{summary:R.digest}:{},summaryKind:R.digest?"digest":"digest-failed",...R.totalTokensUsed>0?{usage:R.usage??{totalTokens:R.totalTokensUsed}}:{}})},"onWorkflowChildDigest")}:{},abortSignal:W.signal,snapshotUpdater:c?R=>Ge(c,g,R):void 0},F;try{return await L,F=await r([M],t,I),F}finally{if(t.childAbortControllers?.delete(g),c){let R=F?ve(F,g):{snapStatus:"failed",finalText:""};pe(c,g,{status:R.snapStatus,finalText:R.finalText,endedAt:s()})}}},"runBundle"),j=A(l);return m.set(g,{name:f.name,input:f,bundle:l,promise:j,runBundle:A,verification:k,changedPathBaseline:L,mutationRecorder:O,acceptToolMutationEvidence:_,repairAttempts:0}),de(x,g,j),{taskId:g,name:f.name}},"spawn"),wait:i(async(u,f)=>{let g=h.get(u);if(g){let q=t.agentExecutorPlane;if(!q)throw new Error("Workflow external-agent binding was removed.");let ce=et(f);return un(await q.plane.tasks.wait(u,ce),g.name)}let l=m.get(u);if(!l)throw new Error(`unknown workflow task: ${u}`);let v=et(f),k=Date.now(),O=i(async q=>{if(v===void 0)return ot(q,u,void 0,t);let ce=Date.now()-k,Ce=v-ce;if(Ce<=0)throw t.childAbortControllers?.get(u)?.abort(),new Error(`workflow task ${u} timed out after ${v}ms`);return ot(q,u,Math.max(1,Math.floor(Ce)),t,v)},"waitForAttempt"),_=await O(l.promise),L=_.totalTokensUsed,c=ve(_,u),A=c.routeFacts,j=c.routeFacts?.inputTokens??0,M=c.routeFacts?.outputTokens??0,W=c.routeFacts?.cacheReadTokens??0,I=c.routeFacts?.iterations??0,F=c.routeFacts?.durationMs??0,R=c.routeFacts?.fallbackReason,se=c.digestTokensUsed??0,B=c.digestUsage,b=l.verification?nt({verification:l.verification,term:c,before:await l.changedPathBaseline,after:ge(l.verification)?await he(t,o):{paths:[]},mutationRecorder:l.mutationRecorder,ctx:t,acceptToolMutationEvidence:l.acceptToolMutationEvidence}):void 0;for(c.limitReached===!0&&b===void 0&&c.status==="completed"&&(b=rt(),c={...c,status:"completed_unverified",snapStatus:"completed",finalText:ye(c.finalText,b)});ln({entry:l,term:c,verification:b});){l.repairAttempts+=1;let q=it(u,{...l.input,prompt:mn({originalPrompt:l.input.prompt,previousFinalText:c.finalText,verification:b,attempt:l.repairAttempts})},void 0,e.kodaxAuthored===!0);l.promise=l.runBundle(q),de(x,u,l.promise),_=await O(l.promise),L+=_.totalTokensUsed,c=ve(_,u),j+=c.routeFacts?.inputTokens??0,M+=c.routeFacts?.outputTokens??0,W+=c.routeFacts?.cacheReadTokens??0,I+=c.routeFacts?.iterations??0,F+=c.routeFacts?.durationMs??0,R??=c.routeFacts?.fallbackReason,se+=c.digestTokensUsed??0,c.digestUsage&&(B={inputTokens:(B?.inputTokens??0)+(c.digestUsage.inputTokens??0),outputTokens:(B?.outputTokens??0)+(c.digestUsage.outputTokens??0),totalTokens:(B?.totalTokens??0)+(c.digestUsage.totalTokens??0),cacheReadTokens:(B?.cacheReadTokens??0)+(c.digestUsage.cacheReadTokens??0)}),b=l.verification?nt({verification:l.verification,term:c,before:await l.changedPathBaseline,after:ge(l.verification)?await he(t,o):{paths:[]},mutationRecorder:l.mutationRecorder,ctx:t,acceptToolMutationEvidence:l.acceptToolMutationEvidence}):void 0,c.limitReached===!0&&b===void 0&&c.status==="completed"&&(b=rt(),c={...c,status:"completed_unverified",snapStatus:"completed",finalText:ye(c.finalText,b)})}if(b!==void 0&&!b.ok&&c.status==="completed"){let q=b.enforcement==="warn";c={...c,status:q?"completed_unverified":"failed",snapStatus:q?"completed":"failed",finalText:ye(c.finalText,b)}}return pe(t.childProgressSnapshots,u,{status:c.snapStatus,finalText:c.finalText,endedAt:s()}),{taskId:u,name:l.name,status:c.status,finalText:c.finalText,...c.digest?{digest:c.digest}:{},...c.digestFailed?{digestFailed:!0}:{},...c.digestPending?{digestPending:!0}:{},...b!==void 0?{verification:b}:{},...c.limitReached?{limitReached:!0}:{},...c.provider?{provider:c.provider}:{},...c.model?{model:c.model}:{},...c.structured!==void 0?{structured:c.structured}:{},...se>0?{digestUsage:B??{totalTokens:se}}:{},...c.routeFacts?{requestedTier:A?.requestedTier??c.routeFacts.requestedTier,tierOutcome:c.routeFacts.tierOutcome,providerSource:A?.providerSource??c.routeFacts.providerSource,...A?.modelSource??c.routeFacts.modelSource?{modelSource:A?.modelSource??c.routeFacts.modelSource}:{},...A?.initialProvider??c.routeFacts.initialProvider?{initialProvider:A?.initialProvider??c.routeFacts.initialProvider}:{},...A?.initialModel??c.routeFacts.initialModel?{initialModel:A?.initialModel??c.routeFacts.initialModel}:{},...c.routeFacts.finalProvider?{finalProvider:c.routeFacts.finalProvider}:{},...c.routeFacts.finalModel?{finalModel:c.routeFacts.finalModel}:{},...R?{fallbackReason:R}:{},...c.routeFacts.resolvedEffort?{resolvedEffort:c.routeFacts.resolvedEffort}:{},...I>0?{iterations:I}:{},...F>0?{durationMs:F}:{}}:{},usage:{totalTokens:L,...j>0?{inputTokens:j}:{},...M>0?{outputTokens:M}:{},...W>0?{cacheReadTokens:W}:{}}}},"wait"),output:i(async u=>{let f=h.get(u);if(f){let k=t.agentExecutorPlane;if(!k)throw new Error("Workflow external-agent binding was removed.");return fn(await k.plane.tasks.get(u),f.name)}if(!m.has(u))throw new Error(`unknown workflow task: ${u}`);let g=m.get(u)?.name??u,l=t.childProgressSnapshots?.get(u);if(!l)return{taskId:u,name:g,status:"running"};let v=l.status==="aborted"?"stopped":l.status;return l.finalText!==void 0?{taskId:u,name:g,status:v,lastText:l.finalText}:{taskId:u,name:g,status:v}},"output"),send:i(async(u,f)=>{if(h.has(u)){let g=t.agentExecutorPlane;if(!g)throw new Error("Workflow external-agent binding was removed.");await g.plane.tasks.sendInput(u,{content:f});return}if(!m.has(u))throw new Error(`unknown workflow task: ${u}`);Ne({to:u,priority:"user",mode:"prompt",content:f,registry:x,queue:a})},"send"),stop:i(async(u,f)=>{if(h.has(u)){let g=t.agentExecutorPlane;if(!g)throw new Error("Workflow external-agent binding was removed.");await g.plane.tasks.cancel(u,f);return}if(!m.has(u))throw new Error(`unknown workflow task: ${u}`);t.childAbortControllers?.get(u)?.abort()},"stop"),subscribeTaskSummaryUpdates:i(u=>(S.add(u),()=>{S.delete(u)}),"subscribeTaskSummaryUpdates")}}i(dt,"createCodingWorkflowBackend");import{homedir as Xn}from"node:os";import{join as It}from"node:path";var pn=["structure, entry points, and control flow","edge cases, error handling, and failure modes","tests, validation, and existing coverage"],gn="Deduplicate overlapping findings, keep concrete evidence (file:line), rank by relevance to the question, and explicitly note gaps left by any failed investigation.",wn={type:"object",additionalProperties:!1,required:["finding"],properties:{finding:{type:"string",description:"Your concrete findings for this focus, with file:line evidence. If nothing relevant was found, a brief note saying so."}}};function hn(e){if(e!==null&&typeof e=="object"&&"finding"in e){let t=e.finding;if(typeof t=="string"&&t.trim().length>0)return t}}i(hn,"readStructuredFinding");function yn(e){let t=hn(e.structured);if(t)return t;let n=e.finalText?.trim();return n&&n.length>0?e.finalText:"[no finding text was returned \u2014 the investigator may have ended on a tool call without a closing summary]"}i(yn,"pickFindingText");function vn(e,t){return["Investigate the following question (READ-ONLY \u2014 do not modify any files):",e,"",`Focus your investigation on: ${t}`,"","Report concrete findings backed by evidence (cite file:line). If you find nothing relevant for this focus, say so briefly."].join(`
+`)}i(vn,"buildInvestigatorPrompt");function kn(e){let t=Math.max(1,(e.maxAgents??8)-1);return(e.targets&&e.targets.length>0?e.targets:pn).slice(0,t).map((r,a)=>({name:`investigate-${a+1}`,prompt:vn(e.question,r)}))}i(kn,"resolveAngles");async function xn(e,t){try{let n=await e.runAgent({name:t.name,prompt:t.prompt,readOnly:!0,modelHint:"balanced",outputSchema:wn});return n===null?{angle:t.name,status:"failed",text:"[investigation failed] agent did not complete"}:{angle:t.name,status:n.status==="completed"?"completed":"failed",text:yn(n)}}catch(n){let r=n instanceof Error?n.message:String(n);return{angle:t.name,status:"failed",text:`[investigation failed] ${r}`}}}i(xn,"investigate");async function Sn(e,t){let n=kn(t),r=(await e.phase("investigate",()=>e.parallel(n.map(s=>()=>xn(e,s)),t.maxConcurrency!==void 0?{concurrency:t.maxConcurrency}:void 0))).filter(s=>s!==null),a=r.some(s=>s.status!=="completed");return{synthesis:(await e.phase("synthesize",()=>e.synthesize({inputs:r.map(s=>`### ${s.angle} (${s.status})
+${s.text}`),rubric:t.rubric??gn}))).text,findings:r,degraded:a}}i(Sn,"runParallelInvestigation");var ut={meta:{name:"parallel-investigation",description:"Fan out read-only investigators over a question (split by target areas), then synthesize ranked, evidence-keeping findings.",maxAgents:8,maxConcurrency:4,readOnly:!0,phases:["investigate","synthesize"]},run:Sn};import{createHash as Rn}from"node:crypto";var ke={type:"object",additionalProperties:!1,required:["specVerdict","qualityVerdict","findings","unverifiedRequirements"],properties:{specVerdict:{enum:["compliant","issues","not-verifiable"]},qualityVerdict:{enum:["approved","needs-fixes"]},findings:{type:"array",items:{type:"object",additionalProperties:!1,required:["severity","location","claim","evidence"],properties:{severity:{enum:["critical","high","medium","low"]},location:{type:"string"},claim:{type:"string"},evidence:{type:"string"},suggestedFix:{type:"string"}}}},unverifiedRequirements:{type:"array",items:{type:"string"}}}},xe={type:"object",additionalProperties:!1,required:["findings"],properties:{findings:{type:"array",items:{type:"object",additionalProperties:!1,required:["findingId","disposition","evidence"],properties:{findingId:{type:"string"},disposition:{enum:["confirmed","refuted","unresolved"]},evidence:{type:"string"},effectiveSeverity:{enum:["critical","high","medium","low"]},severityReason:{type:"string"}}}}}};function C(e){return e.normalize("NFC").replace(/\r\n?/g,`
+`).trim().replace(/[\t\n\f\r ]+/g," ")}i(C,"normalizeText");function lt(e){return C(e).replace(/\\/g,"/")}i(lt,"normalizeLocation");function ee(e){return[...new Set(e.map(C).filter(Boolean))].sort((t,n)=>t<n?-1:t>n?1:0)}i(ee,"uniqueSorted");function bn(e,t,n){return Rn("sha256").update(`${e}\0${lt(t)}\0${C(n)}`,"utf8").digest("hex")}i(bn,"findingId");function mt(e,t,n){if(!t&&n.specVerdict!=="not-verifiable")throw new Error('review result must use specVerdict "not-verifiable" when requirements are absent');return{specVerdict:n.specVerdict,qualityVerdict:n.qualityVerdict,findings:n.findings.map(r=>{let a=lt(r.location),o=C(r.claim),s=C(r.evidence);return{findingId:bn(e,a,o),severity:r.severity,location:a,claim:o,evidence:s,...r.suggestedFix?{suggestedFix:C(r.suggestedFix)}:{}}}).sort((r,a)=>r.findingId<a.findingId?-1:r.findingId>a.findingId?1:0),unverifiedRequirements:ee(n.unverifiedRequirements)}}i(mt,"normalizeScopedReviewResult");var ft={low:0,medium:1,high:2,critical:3};function Tn(e){return e.reduce((t,n)=>ft[n]>ft[t]?n:t,"low")}i(Tn,"maxSeverity");function pt(e){if(e.length===0)throw new Error("at least one primary review result is required");let t=new Map;for(let a of e)for(let o of a.findings)t.set(o.findingId,[...t.get(o.findingId)??[],o]);let n=[...t.entries()].map(([a,o])=>({findingId:a,severity:Tn(o.map(s=>s.severity)),location:o[0].location,claim:o[0].claim,evidence:ee(o.map(s=>s.evidence)),suggestedFixes:ee(o.flatMap(s=>s.suggestedFix?[s.suggestedFix]:[]))})).sort((a,o)=>a.findingId<o.findingId?-1:a.findingId>o.findingId?1:0);return{specVerdict:e.some(a=>a.specVerdict==="issues")?"issues":e.some(a=>a.specVerdict==="not-verifiable")?"not-verifiable":"compliant",qualityVerdict:e.some(a=>a.qualityVerdict==="needs-fixes")?"needs-fixes":"approved",findings:n,unverifiedRequirements:ee(e.flatMap(a=>a.unverifiedRequirements))}}i(pt,"mergeScopedReviewResults");function gt(e,t){let n=new Set(e.findings.map(s=>s.findingId)),r=new Set;for(let s of t.findings){if(!n.has(s.findingId)||r.has(s.findingId))throw new Error("verifier must return every input findingId exactly once");r.add(s.findingId)}if(r.size!==n.size)throw new Error("verifier must return every input findingId exactly once");let a=new Map(t.findings.map(s=>[s.findingId,s])),o=e.findings.flatMap(s=>{let d=a.get(s.findingId);if(d.disposition==="refuted")return[];let p=d.severityReason?.trim(),m=d.effectiveSeverity!==void 0&&!!p;return[{...s,disposition:d.disposition,severity:m?d.effectiveSeverity:s.severity,verificationEvidence:C(d.evidence),...p?{severityReason:C(p)}:{}}]});return{specVerdict:e.specVerdict,qualityVerdict:e.qualityVerdict,unverifiedRequirements:e.unverifiedRequirements,actionable:o,audit:t,unqualifiedApprovalAllowed:o.length===0&&e.unverifiedRequirements.length===0&&e.specVerdict==="compliant"&&e.qualityVerdict==="approved"}}i(gt,"applyFindingVerification");var Mn={type:"object",additionalProperties:!1,required:["summary"],properties:{summary:{type:"string"}}};function ht(e){return[e.packetPath,...e.evidenceChunks.map(t=>t.path)]}i(ht,"evidencePaths");function En(e){let t=me(e,ke);if(t.length>0)throw new Error(`primary reviewer structured result is invalid: ${t.join("; ")}`);return e}i(En,"rawReview");function Pn(e){let t=me(e,xe);if(t.length>0)throw new Error(`finding verifier structured result is invalid: ${t.join("; ")}`);return e}i(Pn,"rawVerification");function Se(e,t){if(e===null||e.status!=="completed")throw new Error(`${t} did not complete; no verdict was accepted`);if(e.verification!==void 0&&!e.verification.ok)throw new Error(`${t} did not read every required packet path; no verdict was accepted`);return e}i(Se,"resultOrThrow");function An(e,t,n){return["Review one immutable KodaX packet as an independent third-party reviewer.",`Packet manifest: ${e.packetPath}`,...e.evidenceChunks.map(r=>`Evidence chunk: ${r.path}`),`This packet has binding requirements: ${e.requirementsPresent?"yes":"no"}.`,t?"This is the additional high-risk primary. Actively seek a disagreement with the first reader; do not assume it was correct.":"Own both specification and implementation-quality verdicts for this scope.",n.lean?"Also identify unnecessary additions, but never remove validation, security, data-loss protection, accessibility, or requested behavior.":"",n.reviewFocus?`Additional user focus: ${n.reviewFocus}`:"","Read the manifest and every listed chunk with the read tool before deciding.","Begin with the required JSON result. No preamble or process narration.","The findings array contains only actionable defects, never approval evidence or positive observations.","When the scope is compliant and approved with no actionable defect, findings must be empty.","If a named requirement cannot be proven compliant or violated from surfaced evidence, use specVerdict not-verifiable, list it in unverifiedRequirements, and emit no finding for that uncertainty; absence of evidence is not proof of a defect.","If requirements are absent, specVerdict must be not-verifiable."].filter(Boolean).join(`
+`)}i(An,"buildScopedReviewPrimaryPrompt");function Wn(e,t){return["Independently attempt to refute every candidate finding in this batch.",`Packet manifest: ${e.packetPath}`,...e.evidenceChunks.map(n=>`Evidence chunk: ${n.path}`),`Canonical candidates: ${JSON.stringify(t.findings)}`,"Read the packet evidence. You may run one focused check after naming the concrete doubt.","Return every findingId exactly once. A severity change requires severityReason.","Begin with the required JSON result; no preamble."].join(`
+`)}i(Wn,"buildScopedReviewVerificationPrompt");function In(e){return["Synthesize the structured review results below without rereading packet bodies.","Lead with confirmed findings, keep unresolved findings visibly unresolved, omit refuted findings from the actionable list, and never silently downgrade severity.","Cite locations and state explicitly when no actionable issue was confirmed.",JSON.stringify(e)].join(`
+`)}i(In,"buildScopedReviewFinalPrompt");async function wt(e,t,n,r){let a=Se(await e.runAgent({name:`${n?"high-risk-":""}primary-${t.partitionKey}`,phase:"primary-review",prompt:An(t,n,r),scopeSummary:`${t.partitionKey}: ${t.scopePaths.join(", ")}`,constraints:["read every required packet path","return both verdicts","cite evidence at each finding"],readOnly:!0,modelHint:n?"deep":"balanced",verification:{enforcement:"hard",requiredReadPaths:ht(t)},outputSchema:ke,terseResult:!0}),"primary reviewer");return e.log({message:`primary read accepted for ${t.partitionKey}`,data:{kind:"review_packet_read",role:"primary",contentHash:t.contentHash}}),En(a.structured)}i(wt,"runPrimary");async function Fn(e,t,n){if(n.findings.length===0)return{specVerdict:n.specVerdict,qualityVerdict:n.qualityVerdict,unverifiedRequirements:n.unverifiedRequirements,actionable:[],audit:{findings:[]},unqualifiedApprovalAllowed:n.unverifiedRequirements.length===0&&n.specVerdict==="compliant"&&n.qualityVerdict==="approved"};let r=Se(await e.runAgent({name:`verify-${t.partitionKey}`,phase:"verifier",prompt:Wn(t,n),scopeSummary:`verify ${n.findings.length} candidate finding(s) in ${t.partitionKey}`,constraints:["fresh context","attempt refutation","one disposition per findingId"],readOnly:!0,modelHint:"deep",verification:{enforcement:"hard",requiredReadPaths:ht(t)},outputSchema:xe,terseResult:!0}),"finding verifier");return e.log({message:`verification read accepted for ${t.partitionKey}`,data:{kind:"review_packet_read",role:"verification",contentHash:t.contentHash,reason:"candidate findings"}}),gt(n,Pn(r.structured))}i(Fn,"verifyFindings");async function qn(e,t,n){let r=[await wt(e,t,!1,n)];t.riskFlags.includes("routing-high")&&r.push(await wt(e,t,!0,n));let a=r.map(d=>mt(t.contentHash,t.requirementsPresent,d)),o=pt(a),s=await Fn(e,t,o);return e.log({message:`quality gate completed for ${t.partitionKey}`,data:{kind:"review_quality_gate",contentHash:t.contentHash,actionableFindings:s.actionable.length,unresolvedFindings:s.actionable.filter(d=>d.disposition==="unresolved").length,unqualifiedApprovalAllowed:s.unqualifiedApprovalAllowed}}),{contentHash:t.contentHash,result:s}}i(qn,"reviewPacket");async function On(e,t){if(!Array.isArray(t.packets)||t.packets.length===0)throw new Error("scoped-review requires at least one review packet");let n=await e.parallel(t.packets.map(d=>()=>qn(e,d,t)),{concurrency:4});if(n.some(d=>d===null))throw new Error("one or more scope packets failed review; no final verdict was accepted");let r=n.filter(d=>d!==null);await e.artifact("scoped-review-audit",r);let a=Se(await e.runAgent({name:"final-review-synthesis",phase:"final-synthesis",prompt:In(r),scopeSummary:`cross-scope synthesis for ${r.length} packet(s)`,constraints:["preserve severity","preserve unresolved uncertainty","do not invent evidence"],readOnly:!0,modelHint:"deep",outputSchema:Mn,terseResult:!0}),"final synthesis"),o=a.structured;return{summary:typeof o?.summary=="string"?o.summary:a.finalText,packetResults:r}}i(On,"runScopedReview");var yt={meta:{name:"scoped-review",description:"Review immutable scope packets once, verify only candidate findings, then synthesize.",readOnly:!0,phases:["primary-review","verifier","final-synthesis"],maxAgents:64,maxConcurrency:4},run:On};function vt(e){return{meta:e.meta,run:i((t,n)=>e.run(t,n),"run")}}i(vt,"erase");var kt=[vt(ut),vt(yt)];function xt(e){return kt.find(t=>t.meta.name===e)}i(xt,"getBuiltinWorkflow");function Jr(){return kt.map(e=>e.meta)}i(Jr,"listBuiltinWorkflows");import{mkdir as Mt,readdir as Cn,readFile as z,rename as $n,unlink as Te,writeFile as Me}from"node:fs/promises";import{basename as _n,dirname as be,join as U}from"node:path";import{pathToFileURL as Nn}from"node:url";var Et=[".workflow.json",".ts",".mjs",".js"],G="0.7.49";function Pt(){return"0.7.67"}i(Pt,"currentKodaxWorkflowVersion");function Dn(e){return e.endsWith(".workflow.json")?"capability-generated":"trusted-local"}i(Dn,"executionForPath");function Un(e){let t=Et.find(n=>e.endsWith(n));return t?e.slice(0,-t.length):void 0}i(Un,"stripWorkflowSuffix");function Ee(e){let t=e.trim().replace(/[^a-zA-Z0-9._-]+/g,"-").replace(/^[.-]+|[.-]+$/g,"").slice(0,80);if(!t||t==="."||t==="..")throw new Error("workflow name must contain at least one safe filename character");return t}i(Ee,"safeWorkflowName");function Pe(e){return typeof e=="object"&&e!==null}i(Pe,"isRecord");function St(e,t){let n=e[t];if(typeof n!="string"||n.length===0)throw new Error(`workflow run.json missing ${t}`);return n}i(St,"readRequiredString");async function Rt(e,t){if(!e)return[];let n;try{n=await Cn(e)}catch{return[]}let r=new Map;for(let a of Et)for(let o of n){if(!o.endsWith(a))continue;let s=Un(o);if(!s||s.length===0||r.has(s))continue;let d=U(e,o);r.set(s,{name:s,path:d,source:t,execution:Dn(d)})}return[...r.values()]}i(Rt,"scanDir");async function J(e){let t=await Rt(e.personal,"personal"),n=await Rt(e.project,"project"),r=new Map;for(let a of t)r.set(a.name,a);for(let a of n)r.set(a.name,a);return[...r.values()].sort((a,o)=>a.name.localeCompare(o.name))}i(J,"discoverSavedWorkflows");function Vn(e){return typeof e=="object"&&e!==null&&"meta"in e&&"run"in e&&typeof e.run=="function"}i(Vn,"isWorkflowModule");function jn(e){let t=e.default;if(Vn(t))return t;let n=typeof t=="function"?t:e.run,r=e.workflow??e.meta;if(typeof n=="function"&&typeof r=="object"&&r!==null&&"name"in r)return{meta:r,run:n};throw new Error("invalid workflow module: expected a `{ meta, run }` default export, or `export const workflow = {...}` + a default run function")}i(jn,"normalizeWorkflowModule");function Bn(e){let t=JSON.parse(e);if(!Pe(t))throw new Error("generated workflow file must be an object");if(t.format!==void 0&&t.format!=="kodax.workflow")throw new Error(`unsupported workflow capsule format: ${String(t.format)}`);if(t.format==="kodax.workflow"){let a=fe(t);return{manifest:a.manifest,source:a.source,capsule:a,legacy:!1}}let n=t.source;if(typeof n!="string"||n.trim().length===0)throw new Error("generated workflow file source must be a non-empty string");let r=K(t.manifest);return{manifest:r,source:n,capsule:N({minKodaxVersion:G,manifest:r,source:n}),legacy:!0}}i(Bn,"parseGeneratedWorkflowFile");async function Ae(e){let t=Bn(await z(e,"utf8"));return t.capsule??N({minKodaxVersion:G,manifest:t.manifest,source:t.source})}i(Ae,"loadSavedWorkflowCapsule");async function At(e){if(e.endsWith(".workflow.json"))return le(await Ae(e));let t=await import(Nn(e).href);return jn(t)}i(At,"loadSavedWorkflow");function We(e){if(e.mayUseWorktree===!0)return{environment:["git-repo","worktree-capable"]}}i(We,"deriveRequirements");function te(e,t){ue(t,{filename:`${e.name}.workflow.js`,requireAsyncRun:!0})}i(te,"assertGeneratedCapsuleSource");async function Hn(e){let t=Ee(e.name),n=K(e.manifest);te(n,e.source);let r=e.requires??We(n),a=N({minKodaxVersion:e.minKodaxVersion??G,manifest:n,source:e.source,...e.intent!==void 0?{intent:e.intent}:{},...e.inputs!==void 0?{inputs:e.inputs}:{},...r!==void 0?{requires:r}:{},...e.provenance!==void 0?{provenance:e.provenance}:{}});await Mt(e.dir,{recursive:!0});let o=U(e.dir,`${t}.workflow.json`);return await Me(o,`${JSON.stringify(a,null,2)}
+`,"utf8"),{name:t,path:o,source:"project",execution:"capability-generated"}}i(Hn,"saveGeneratedWorkflow");async function bt(e,t){await Me(e,`${JSON.stringify(t,null,2)}
+`,"utf8")}i(bt,"writeCapsuleFile");async function Ln(e){try{return await z(e,"utf8"),!0}catch{return!1}}i(Ln,"fileExists");async function no(e){let t=(await J(e.dirs)).filter(d=>d.name===e.name).filter(d=>e.source===void 0||d.source===e.source);if(t.length===0)throw new Error(`saved workflow not found: ${e.name}`);if(t.length>1)throw new Error(`ambiguous saved workflow name: ${e.name}`);let n=t[0];if(!n.path.endsWith(".workflow.json"))throw new Error("only generated workflow capsules can be renamed");let r=Ee(e.newName),a=U(be(n.path),`${r}.workflow.json`);if(a!==n.path&&await Ln(a))throw new Error(`saved workflow already exists: ${r}`);let o=await Ae(n.path);te(o.manifest,o.source);let s=N({minKodaxVersion:o.minKodaxVersion,manifest:{...o.manifest,name:r},source:o.source,...o.intent!==void 0?{intent:o.intent}:{},...o.inputs!==void 0?{inputs:o.inputs}:{},...o.requires!==void 0?{requires:o.requires}:{},...o.provenance!==void 0?{provenance:o.provenance}:{}});return await Me(a,`${JSON.stringify(s,null,2)}
+`,"utf8"),a!==n.path&&await Te(n.path),{name:r,path:a,source:n.source,execution:"capability-generated"}}i(no,"renameSavedWorkflow");async function ro(e){let t=(await J(e.dirs)).filter(r=>r.name===e.name).filter(r=>e.source===void 0||r.source===e.source);if(t.length===0)throw new Error(`saved workflow not found: ${e.name}`);if(t.length>1)throw new Error(`ambiguous saved workflow name: ${e.name}`);let n=t[0];if(!n.path.endsWith(".workflow.json"))throw new Error("only generated workflow capsules can be deleted");return await Te(n.path),n}i(ro,"deleteSavedWorkflow");async function oo(e){let t=Ee(e.name),n=(await J(e.dirs)).filter(y=>y.name===t).filter(y=>e.savedSource===void 0||y.source===e.savedSource);if(n.length===0)throw new Error(`saved workflow not found: ${t}`);if(n.length>1)throw new Error(`ambiguous saved workflow name: ${t}`);let r=n[0];if(!r.path.endsWith(".workflow.json"))throw new Error("only generated workflow capsules can be replaced");let a=K({...e.manifest,name:t});te(a,e.source);let o=e.requires??We(a),s=N({minKodaxVersion:e.minKodaxVersion??G,manifest:a,source:e.source,...e.intent!==void 0?{intent:e.intent}:{},...e.inputs!==void 0?{inputs:e.inputs}:{},...o!==void 0?{requires:o}:{},...e.provenance!==void 0?{provenance:e.provenance}:{}}),d=await Ae(r.path),p=new Date().toISOString().replace(/[:.]/g,"-"),m=U(be(r.path),".revisions",t),h=`${p}-${process.hrtime.bigint().toString(36)}`,S=U(m,`${t}-${h}.workflow.json`),x=U(be(r.path),`.${t}.${process.pid}.${Date.now().toString(36)}.tmp`);await Mt(m,{recursive:!0}),await bt(S,d);try{await bt(x,s),await $n(x,r.path)}catch(y){try{await Te(x)}catch{}throw y}return{name:t,path:r.path,source:r.source,execution:"capability-generated",previousPath:S}}i(oo,"replaceSavedWorkflow");function Kn(e){if(!Pe(e))return;let t=e.request;if(typeof t=="string"&&t.trim().length>0)return t;let n=e.question;if(typeof n=="string"&&n.trim().length>0)return n}i(Kn,"readOptionalOriginalRequest");function Wt(e){return zn(e)}i(Wt,"buildCapsuleFromRun");async function zn(e){let t=JSON.parse(await z(U(e.runDir,"run.json"),"utf8"));if(!Pe(t))throw new Error("workflow run.json must be an object");let n=St(t,"scriptSnapshotPath"),r=St(t,"manifestSnapshotPath"),a=await z(n,"utf8"),o=K(JSON.parse(await z(r,"utf8")));te(o,a);let s=typeof t.runId=="string"&&t.runId.length>0?t.runId:_n(e.runDir),d=Kn(t.args),p=We(o),m=Ve(o,d!==void 0?{originalRequest:d}:{}),h={description:"Provide new workflow args matching the generated request shape.",..."args"in t?{examples:[t.args]}:{}};return N({minKodaxVersion:G,manifest:o,source:a,intent:m,inputs:h,...p!==void 0?{requires:p}:{},provenance:{fromRunId:s,createdAt:new Date().toISOString(),kodaxVersion:Pt()}})}i(zn,"readCapsuleFromRun");async function io(e){let t=await Wt(e);return{capsule:t,module:le(t)}}i(io,"loadGeneratedWorkflowFromRun");async function ao(e){let t=await Wt(e);return Hn({dir:e.targetDir,name:e.name,manifest:t.manifest,source:t.source,...t.intent!==void 0?{intent:t.intent}:{},...t.inputs!==void 0?{inputs:t.inputs}:{},...t.requires!==void 0?{requires:t.requires}:{},...t.provenance!==void 0?{provenance:t.provenance}:{},minKodaxVersion:t.minKodaxVersion})}i(ao,"saveGeneratedWorkflowFromRun");function $(e,t,n,r){e.push({severity:t,requirement:n,message:r})}i($,"addRequirementIssue");function Tt(e){let t=/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e.trim());if(t)return[Number(t[1]),Number(t[2]),Number(t[3])]}i(Tt,"parseSemver");function Gn(e,t){for(let n=0;n<3;n+=1){let r=e[n]-t[n];if(r!==0)return r}return 0}i(Gn,"compareSemver");function Jn(e,t,n){let r=Tt(t),a=Tt(n);if(!r){$(e,"error","kodax:min-version",`workflow minKodaxVersion is not valid semver: ${t}`);return}if(!a){$(e,"warning","kodax:min-version",`cannot verify workflow minKodaxVersion ${t}; current version is unknown`);return}Gn(a,r)<0&&$(e,"error","kodax:min-version",`workflow requires KodaX >= ${t}, current version is ${n}`)}i(Jn,"addMinVersionIssue");function Re(e,t,n,r){if(!n)return;if(!r){for(let o of n)$(e,"warning",`${t}:${o}`,`workflow requires ${t}:${o}, but no ${t} inventory was provided`);return}let a=new Set(r);for(let o of n)a.has(o)||$(e,"error",`${t}:${o}`,`missing required workflow ${t}: ${o}`)}i(Re,"addMissingItems");function so(e,t={}){let n=fe(e),r=[],a=n.requires;Jn(r,n.minKodaxVersion,t.kodaxVersion??Pt()),a?.environment?.includes("git-repo")&&t.isGitRepo===!1&&$(r,"error","environment:git-repo","workflow requires a git repository"),a?.environment?.includes("worktree-capable")&&t.worktreeCapable===!1&&$(r,"error","environment:worktree-capable","workflow may request git worktree isolation");try{ue(n.source,{filename:`${n.manifest.name}.workflow.js`,requireAsyncRun:!0})}catch(o){let s=o instanceof Error?o.message:String(o);$(r,"error","workflow:source",s)}return Re(r,"tools",a?.tools,t.availableTools),Re(r,"mcp",a?.mcp,t.availableMcp),Re(r,"skills",a?.skills,t.availableSkills),{ok:!r.some(o=>o.severity==="error"),issues:r}}i(so,"preflightWorkflowCapsule");function Yn(e){return{project:It(e,".kodax","workflows"),personal:It(Xn(),".kodax","workflows")}}i(Yn,"defaultSavedWorkflowDirs");async function Zn(e,t){let r=(await J(t)).find(a=>a.name===e);if(r)return At(r.path)}i(Zn,"resolveSavedByName");function Ft(e){let t=Yn(e);return async n=>xt(n)??await Zn(n,t)}i(Ft,"createNestedWorkflowResolver");import{existsSync as Qn,mkdirSync as er,readFileSync as tr,writeFileSync as qt}from"node:fs";import{join as X}from"node:path";var Ot="results";function Ct(e){return e.replace(/[^a-zA-Z0-9._-]/g,"_")}i(Ct,"safeKey");function $t(e,t){let n=X(e,t);if(Qn(n))try{return JSON.parse(tr(n,"utf8"))}catch{return}}i($t,"readResult");function _t(e,t={}){let n=X(e,Ot);er(n,{recursive:!0});let r=t.readFrom?X(t.readFrom,Ot):void 0;return{get:i(a=>{let o=`${Ct(a)}.json`,s=$t(n,o);if(s!==void 0)return s;if(r===void 0)return;let d=$t(r,o);if(d!==void 0){try{qt(X(n,o),JSON.stringify(d),"utf8")}catch{}return d}},"get"),set:i((a,o)=>{try{qt(X(n,`${Ct(a)}.json`),JSON.stringify(o),"utf8")}catch{}},"set")}}i(_t,"createFsResultCache");import{mkdirSync as nr,appendFileSync as rr,writeFileSync as re}from"node:fs";import{join as H}from"node:path";function ne(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}i(ne,"record");function T(e){return typeof e=="number"&&Number.isFinite(e)&&e>=0?e:0}i(T,"finiteNumber");function Nt(e){let t=new Map,n=new Set,r=[],a=[],o=new Set,s=[],d=[],p=0,m=0,h=0,S=0,x=0,y=0,E=0,w=0,V={},ie=[];for(let P of e){let u=P.data??{};if(P.type==="agent_spawned"){let l=typeof u.taskId=="string"?u.taskId:void 0;l&&t.set(l,u),u.role==="primary-review"&&(y+=1);let v=typeof u.role=="string"?u.role:"agent",k=typeof u.requestedTier=="string"?u.requestedTier:"inherited",O=`${v}/${k}`;V[O]=(V[O]??0)+1;continue}if(P.type==="agent_completed"||P.type==="agent_unverified"||P.type==="agent_failed"){let l=typeof u.taskId=="string"?u.taskId:void 0;if(!l||n.has(l))continue;n.add(l);let v=ne(u.usage);!v||typeof v.totalTokens!="number"?typeof t.get(l)?.externalTarget=="string"?a.push(l):r.push(l):(p+=T(v.totalTokens),m+=T(v.inputTokens),h+=T(v.cacheReadTokens??v.cachedReadTokens),S+=T(v.outputTokens));let k=ne(u.digestUsage);x+=T(k?.totalTokens),m+=T(k?.inputTokens),S+=T(k?.outputTokens),h+=T(k?.cacheReadTokens??k?.cachedReadTokens),E+=T(u.iterations);continue}if(P.type==="agent_summary_updated"){let l=ne(u.usage),v=u.summaryKind;if((v==="digest"||v==="digest-failed")&&l){let k=T(l.totalTokens);p+=k,x+=k,m+=T(l.inputTokens),S+=T(l.outputTokens),h+=T(l.cacheReadTokens??l.cachedReadTokens)}continue}if(P.type!=="workflow_log")continue;let f=ne(u.data);if(f?.kind==="review_quality_gate"&&typeof f.contentHash=="string"){ie.push({contentHash:f.contentHash,actionableFindings:T(f.actionableFindings),unresolvedFindings:T(f.unresolvedFindings),unqualifiedApprovalAllowed:f.unqualifiedApprovalAllowed===!0});continue}if(f?.kind!=="review_packet_read"||typeof f.contentHash!="string")continue;let g={contentHash:f.contentHash,...typeof f.reason=="string"?{reason:f.reason}:{}};f.role==="primary"?(o.has(f.contentHash)&&(w+=1),o.add(f.contentHash)):f.role==="verification"?s.push(g):f.role==="synthesis"&&d.push(g)}for(let P of t.keys())n.has(P)||r.push(P);let ae=[...new Set(r)].sort();return{totalModelTokens:p,inputTokens:m,cacheReadTokens:h,outputTokens:S,digestTokens:x,agentStarts:t.size,childTurns:E,agentStartsByRoleTier:V,primaryReviewStarts:y,duplicatePrimaryPacketReads:w,verificationPacketReads:s,synthesisPacketReads:d,reviewWaves:y>0?1:0,fixWaves:0,rereviewWaves:0,qualityGateOutcomes:ie,tokenCoverage:{ok:ae.length===0,missingTaskIds:ae},excludedExternalTaskIds:[...new Set(a)].sort()}}i(Nt,"buildWorkflowCostReport");function or(e){let t=e.replace(/[^a-zA-Z0-9._-]/g,"_").slice(0,120);return t.length>0?t:"artifact"}i(or,"safeWorkflowArtifactName");function Dt(e,t={}){let n=t.now??(()=>Date.now()),r=H(e,"artifacts");nr(r,{recursive:!0});let a=H(e,"events.jsonl");return{runDir:e,onEvent:i(o=>{rr(a,`${JSON.stringify({...o,ts:n()})}
+`,"utf8")},"onEvent"),writeArtifact:i((o,s)=>{let d=H(r,`${or(o)}.json`);return re(d,JSON.stringify(s,null,2),"utf8"),{name:o,path:d}},"writeArtifact"),writeScriptSnapshot:i(o=>{let s=H(e,"script.js");if(re(s,o.source,"utf8"),!o.manifest)return{scriptPath:s};let d=H(e,"manifest.json");return re(d,`${JSON.stringify(o.manifest,null,2)}
+`,"utf8"),{scriptPath:s,manifestPath:d}},"writeScriptSnapshot"),writeRunJson:i(o=>{let s=De(o.processMetadata?.hostMetadata),d={runId:o.state.runId,workflow:o.meta.name,status:o.state.status,totalSpawned:o.state.totalSpawned,artifacts:o.state.artifacts.map(p=>p.name),eventCount:o.state.events.length,efficiencyReport:{...Nt(o.state.events),wallClockDurationMs:Math.max(0,o.endedAt-o.startedAt)},startedAt:o.startedAt,endedAt:o.endedAt,args:o.args,...o.resultSummary!==void 0?{resultSummary:o.resultSummary}:{},...o.processMetadata?.displayName!==void 0?{displayName:o.processMetadata.displayName}:{},...o.processMetadata?.goal!==void 0?{goal:o.processMetadata.goal}:{},...o.processMetadata?.source!==void 0?{source:o.processMetadata.source}:{},...o.processMetadata?.savedWorkflowName!==void 0?{savedWorkflowName:o.processMetadata.savedWorkflowName}:{},...o.processMetadata?.sourceRunId!==void 0?{sourceRunId:o.processMetadata.sourceRunId}:{},...o.processMetadata?.sourceWorkflowName!==void 0?{sourceWorkflowName:o.processMetadata.sourceWorkflowName}:{},...o.processMetadata?.revisionOf!==void 0?{revisionOf:o.processMetadata.revisionOf}:{},...o.processMetadata?.resumedFromRunId!==void 0?{resumedFromRunId:o.processMetadata.resumedFromRunId}:{},...s!==void 0?{hostMetadata:s}:{},...o.scriptSnapshot?{scriptSnapshotPath:o.scriptSnapshot.scriptPath,...o.scriptSnapshot.manifestPath?{manifestSnapshotPath:o.scriptSnapshot.manifestPath}:{}}:{}};re(H(e,"run.json"),`${JSON.stringify(d,null,2)}
+`,"utf8")},"writeRunJson")}}i(Dt,"createRunGraphWriter");import{execFile as ir}from"node:child_process";import{promisify as ar}from"node:util";import{statSync as sr}from"node:fs";import{join as cr}from"node:path";var dr=ar(ir);function Fe(e){return cr(e,"worktrees")}i(Fe,"workflowWorktreeBaseDir");var ur=360*60*1e3;function Vt(e,t){return dr("git",[...e],{cwd:t}).then(n=>n.stdout)}i(Vt,"defaultRunGit");function fr(e){return sr(e).mtimeMs}i(fr,"defaultMtimeMs");function lr(e){let t=[],n,r,a=i(()=>{n&&t.push(r?{path:n,branch:r}:{path:n}),n=void 0,r=void 0},"flush");for(let o of e.split(/\r?\n/))o.startsWith("worktree ")?(a(),n=o.slice(9).trim()):o.startsWith("branch ")&&(r=o.slice(7).trim().replace(/^refs\/heads\//,""));return a(),t}i(lr,"parseWorktreeList");function Ut(e){return e.replace(/\\/g,"/").replace(/\/+$/,"")}i(Ut,"normalize");function jt(e,t){let n=Ut(e),r=Ut(t);return n===r||n.startsWith(`${r}/`)}i(jt,"isUnder");async function mr(e,t,n){try{let a=(await t(["status","--porcelain"],e.path)).split(/\r?\n/).filter(d=>d.trim().length>0).length,o=await t(["rev-list","--count","HEAD","--not","--remotes"],e.path),s=Number.parseInt(o.trim(),10)||0;return a>0||s>0}catch(r){return n.push(`retain ${e.path}: cannot verify worktree cleanliness: ${r instanceof Error?r.message:String(r)}`),!0}}i(mr,"worktreeHasChanges");async function Bt(e,t,n,r,a){if(await mr(e,n,a)){a.push(`retain ${e.path}: worktree has unmerged changes`);return}try{await n(["worktree","remove",e.path,"--force"],t),r.push(e.path)}catch(o){a.push(`remove ${e.path}: ${o instanceof Error?o.message:String(o)}`);return}if(e.branch)try{await n(["branch","-D",e.branch],t)}catch{}}i(Bt,"removeWorktree");async function Ht(e,t,n){try{let r=await t(["worktree","list","--porcelain"],e);return lr(r)}catch(r){n.push(`list worktrees: ${r instanceof Error?r.message:String(r)}`);return}}i(Ht,"listWorktrees");async function Ie(e,t,n){try{await t(["worktree","prune"],e)}catch(r){n.push(`prune: ${r instanceof Error?r.message:String(r)}`)}}i(Ie,"prune");async function Lt(e,t={}){let n=[],r=[];if(!e.gitRoot)return{removed:r,warnings:n};let a=t.runGit??Vt,o=await Ht(e.gitRoot,a,n);if(!o)return{removed:r,warnings:n};for(let s of o)jt(s.path,e.baseDir)&&await Bt(s,e.gitRoot,a,r,n);return r.length>0&&await Ie(e.gitRoot,a,n),{removed:r,warnings:n}}i(Lt,"sweepWorkflowRunWorktrees");async function Kt(e,t={}){let n=[],r=[];if(!e.gitRoot)return{removed:r,warnings:n};let a=t.runGit??Vt,o=t.mtimeMs??fr,s=t.now??(()=>Date.now()),d=e.maxAgeMs??ur;await Ie(e.gitRoot,a,n);let p=await Ht(e.gitRoot,a,n);if(!p)return{removed:r,warnings:n};for(let m of p){if(!jt(m.path,e.workflowRunsRoot))continue;let h;try{h=s()-o(m.path)}catch{continue}h>=d&&await Bt(m,e.gitRoot,a,r,n)}return r.length>0&&await Ie(e.gitRoot,a,n),{removed:r,warnings:n}}i(Kt,"pruneStaleWorkflowWorktrees");var wr=200,zt={maxAgents:64,tokenBudget:2e5};function hr(e,t){let n=e.meta,r=oe(n,t);return{name:n.name,description:n.description,phases:n.phases??[],...n.plannedAgents!==void 0?{plannedAgents:n.plannedAgents}:{},maxAgents:r.maxAgents??null,maxConcurrency:r.maxConcurrency??null,tokenBudget:r.tokenBudget??null,writesFiles:n.readOnly!==!0}}i(hr,"buildApprovalSummary");function qe(e,t){if(e!==void 0)return!Number.isInteger(e)||e<=0?1:Math.min(e,t)}i(qe,"clampLimit");function yr(e,t,n){let r=qe(e,n),a=qe(t,n);return r===void 0?a:a===void 0?r:Math.min(r,a)}i(yr,"clampEffectiveLimit");function Gt(e,t){if(!(e==null||!Number.isFinite(e)||e<=0))return Math.min(Math.floor(e),t)}i(Gt,"clampTokenBudget");function vr(e,t,n){let r=Gt(e,n),a=Gt(t,n);return r===void 0?a:a===void 0?r:Math.min(r,a)}i(vr,"clampEffectiveTokenBudget");function oe(e,t){let n=yr(e.maxAgents,t?.maxAgents,zt.maxAgents),r=$e(),a=[e.maxConcurrency,t?.maxConcurrency].map(d=>qe(d,r)).filter(d=>d!==void 0),o=a.length===0?r:Math.min(r,...a),s=vr(e.tokenBudget,t?.tokenBudget,zt.tokenBudget);return{...n!==void 0?{maxAgents:n}:{},...o!==void 0?{maxConcurrency:o}:{},...s!==void 0?{tokenBudget:s}:{}}}i(oe,"clampWorkflowLimits");function Jt(e){if(typeof e=="string"&&e.trim().length>0)return e;if(typeof e!="object"||e===null)return;let t=e,n=t.synthesis;if(typeof n=="string"&&n.trim().length>0)return n;if(typeof n=="object"&&n!==null){let r=n.text;if(typeof r=="string"&&r.trim().length>0)return r}for(let r of["summary","report","text","result"]){let a=t[r];if(typeof a=="string"&&a.trim().length>0)return a}}i(Jt,"workflowResultSummary");async function Oe(e){let t=oe(e.module.meta,e.hostPolicy),n=hr(e.module,e.hostPolicy);if(e.approval&&!await e.approval(n))return{kind:"denied",summary:n};let r=e.now??(()=>Date.now()),a=e.ctx?.executionCwd??e.ctx?.gitRoot;await Kt({workflowRunsRoot:gr(e.runDir),gitRoot:a},{now:r,...e.worktreeSweepDeps});let o=Dt(e.runDir,{now:r}),s=e.resumeFromRunDir!==void 0?pr(e.resumeFromRunDir):void 0,d=e.onWorkflowProcessEvent?Ue({runId:e.runId,workflowName:e.module.meta.name,displayName:e.processMetadata?.displayName??e.module.meta.name,...e.processMetadata?.goal!==void 0?{goal:e.processMetadata.goal}:{},...e.processMetadata?.source!==void 0?{source:e.processMetadata.source}:{},...e.processMetadata?.savedWorkflowName!==void 0?{savedWorkflowName:e.processMetadata.savedWorkflowName}:{},...e.processMetadata?.sourceRunId!==void 0?{sourceRunId:e.processMetadata.sourceRunId}:{},...e.processMetadata?.sourceWorkflowName!==void 0?{sourceWorkflowName:e.processMetadata.sourceWorkflowName}:{},...e.processMetadata?.revisionOf!==void 0?{revisionOf:e.processMetadata.revisionOf}:{},...s!==void 0?{resumedFromRunId:s}:{},...e.processMetadata?.hostMetadata!==void 0?{hostMetadata:{...e.processMetadata.hostMetadata}}:{},...e.module.meta.phases!==void 0?{phases:e.module.meta.phases}:{},...t.maxAgents!==void 0?{maxAgents:t.maxAgents}:{},...e.module.meta.plannedAgents!==void 0?{plannedAgents:e.module.meta.plannedAgents}:{},...t.tokenBudget!==void 0?{tokenBudget:t.tokenBudget}:{},now:i(()=>new Date(r()).toISOString(),"now")}):void 0,p=e.scriptSnapshot?o.writeScriptSnapshot(e.scriptSnapshot):void 0,m=e.backend??kr(e),S={...e.beforeSpawn?xr(m,e.beforeSpawn):m,writeArtifact:i(async(w,V)=>o.writeArtifact(w,V),"writeArtifact")},x=r(),y;try{y=await je({runId:e.runId,args:e.args,backend:S,limits:t,...e.signal?{signal:e.signal}:{},summarizeResult:Jt,resolveWorkflowModule:Ft(a??process.cwd()),resultCache:_t(e.runDir,e.resumeFromRunDir?{readFrom:e.resumeFromRunDir}:{}),onEvent:i(w=>{o.onEvent(w),d&&e.onWorkflowProcessEvent?.(d.applyEvent(w)),e.onEvent?.(w)},"onEvent")},w=>e.module.run(w,e.args))}finally{await Lt({baseDir:Fe(e.runDir),gitRoot:a},{now:r,...e.worktreeSweepDeps})}let E=y.ok?Jt(y.result):void 0;return o.writeRunJson({meta:e.module.meta,args:e.args,state:y.state,startedAt:x,endedAt:r(),...p?{scriptSnapshot:p}:{},...E!==void 0?{resultSummary:E}:{},...e.processMetadata!==void 0||s!==void 0?{processMetadata:{...e.processMetadata,...s!==void 0?{resumedFromRunId:s}:{}}}:{}}),y.ok?{kind:"completed",result:y.result,state:y.state}:{kind:"failed",error:y.error,state:y.state}}i(Oe,"runWorkflowModule");function kr(e){if(!e.ctx||!e.childOptions)throw new Error("runWorkflowModule requires either a backend or ctx + childOptions");return dt({ctx:e.ctx,childOptions:e.childOptions,runId:e.runId,defaultChildReadOnly:e.module.meta.readOnly===!0,kodaxAuthored:e.processMetadata?.hostMetadata?.workflowAuthorship==="kodax-generated"})}i(kr,"buildBackend");function xr(e,t){return{...e,spawn:i(async n=>(await t(),e.spawn(n)),"spawn")}}i(xr,"withBeforeSpawn");function Sr(e,t,n){let r=e?.onWorkflowAgentDigest;r&&(n.type==="agent_completed"||n.type==="agent_unverified"||n.type==="agent_failed"||n.type==="agent_summary_updated")&&r({runId:t,event:n})}i(Sr,"emitWorkflowAgentDigest");async function Xt(e){let t={...Je({options:e.options,runtime:e.options.extensionRuntime,managedProtocolPayloadRef:{current:void 0}}),workflowWorktreeBaseDir:Fe(e.runDir)},n={maxIterationsPerChild:wr,parentRole:"worker",parentHarness:"tool-dispatch",parentOptions:{provider:e.options.provider,model:e.options.modelOverride??e.options.model,effort:e.options.effort,reasoningMode:e.options.reasoningMode,repoIntelligenceMode:e.options.context?.repoIntelligenceMode,repoIntelligenceTrace:e.options.context?.repoIntelligenceTrace,extensionRuntime:e.options.extensionRuntime,events:e.options.events},...e.options.guardrails?{guardrails:e.options.guardrails}:{},...t.planModeBlockCheck?{planModeBlockCheck:t.planModeBlockCheck}:{}},r=e.onWorkflowProcessEvent||e.options.events?.onWorkflowProcessEvent?o=>{e.onWorkflowProcessEvent?.(o),e.options.events?.onWorkflowProcessEvent?.(o)}:void 0,a=e.onEvent||e.options.events?.onWorkflowAgentDigest?o=>{e.onEvent?.(o),Sr(e.options.events,e.runId,o)}:void 0;return Oe({module:e.module,args:e.args,runId:e.runId,runDir:e.runDir,ctx:t,childOptions:n,...e.approval?{approval:e.approval}:{},...e.signal?{signal:e.signal}:{},...a?{onEvent:a}:{},...r?{onWorkflowProcessEvent:r}:{},...e.options.workflowHostPolicy?{hostPolicy:e.options.workflowHostPolicy}:{},...e.now?{now:e.now}:{},...e.scriptSnapshot?{scriptSnapshot:e.scriptSnapshot}:{},...e.resumeFromRunDir?{resumeFromRunDir:e.resumeFromRunDir}:{},...e.processMetadata?{processMetadata:e.processMetadata}:{},...e.beforeSpawn?{beforeSpawn:e.beforeSpawn}:{}})}i(Xt,"runWorkflowFromOptions");function Rr(e){if(typeof e=="string"&&e.trim().length>0)return e;if(typeof e!="object"||e===null)return;let t=e,n=t.synthesis;if(typeof n=="string"&&n.trim().length>0)return n;if(typeof n=="object"&&n!==null){let r=n.text;if(typeof r=="string"&&r.trim().length>0)return r}for(let r of["summary","report","text","result"]){let a=t[r];if(typeof a=="string"&&a.trim().length>0)return a}}i(Rr,"resultText");function br(e){if(e.kind==="completed"){let t=Rr(e.result);return t!==void 0?{status:"completed",resultText:t}:{status:"completed"}}return e.kind==="denied"?{status:"denied"}:{status:"failed",error:e.error}}i(br,"classifyOutcome");function Tr(e,t){return{kind:"failed",error:t instanceof Error?t:new Error(String(t)),state:{runId:e,status:"failed",totalSpawned:0,events:[],artifacts:[]}}}i(Tr,"failedOutcome");var Mr=1e3;function Er(e={},t=Be(e)){let n=new Map,r=i(o=>o?{...o,runDir:n.get(o.runId)??""}:void 0,"withRunDir"),a=i((o,s)=>{if(n.set(o.runId,o.runDir),n.size>Mr){let m=new Set(t.list().map(h=>h.runId));for(let h of n.keys())h!==o.runId&&!m.has(h)&&n.delete(h)}let d=oe(o.meta,o.hostPolicy),p=t.start({runId:o.runId,workflow:o.meta.name,...o.meta.phases!==void 0?{phases:o.meta.phases}:{},...d.maxAgents!==void 0?{maxAgents:d.maxAgents}:{},...o.meta.plannedAgents!==void 0?{plannedAgents:o.meta.plannedAgents}:{},...d.tokenBudget!==void 0?{tokenBudget:d.tokenBudget}:{},...o.processMetadata!==void 0?{processMetadata:o.processMetadata}:{},...o.signal?{signal:o.signal}:{},runFn:s,classify:br,onError:i(m=>Tr(o.runId,m),"onError")});return{runId:p.runId,done:p.done,getSnapshot:i(()=>r(p.getSnapshot()),"getSnapshot"),getProcessSnapshot:i(()=>p.getProcessSnapshot(),"getProcessSnapshot")}},"startManaged");return{start:i(o=>a({runId:o.runId,runDir:o.runDir,meta:o.module.meta,hostPolicy:o.hostPolicy,processMetadata:o.processMetadata,signal:o.signal},s=>Oe({...o,signal:s.signal,beforeSpawn:s.beforeSpawn,onEvent:i(d=>{s.onEvent(d),o.onEvent?.(d)},"onEvent")})),"start"),startFromOptions:i(o=>a({runId:o.runId,runDir:o.runDir,meta:o.module.meta,hostPolicy:o.options.workflowHostPolicy,processMetadata:o.processMetadata,signal:o.signal},s=>Xt({...o,signal:s.signal,beforeSpawn:s.beforeSpawn,onEvent:i(d=>{s.onEvent(d),o.onEvent?.(d)},"onEvent")})),"startFromOptions"),list:i(()=>t.list().map(o=>({...o,runDir:n.get(o.runId)??""})),"list"),get:i(o=>r(t.get(o)),"get"),subscribeWorkflowProcess:i(o=>t.subscribeWorkflowProcess(o),"subscribeWorkflowProcess"),getWorkflowProcessSnapshot:i(o=>t.getWorkflowProcessSnapshot(o),"getWorkflowProcessSnapshot"),listWorkflowProcessSnapshots:i(o=>t.listWorkflowProcessSnapshots(o),"listWorkflowProcessSnapshots"),pause:i(o=>t.pause(o),"pause"),resume:i(o=>t.resume(o),"resume"),stop:i((o,s)=>t.stop(o,s),"stop")}}i(Er,"createWorkflowRunManager");var Yt;function Go(){return Yt??=Er({},He()),Yt}i(Go,"getDefaultWorkflowRunManager");export{dt as a,ut as b,ke as c,xe as d,mt as e,pt as f,gt as g,An as h,Wn as i,In as j,yt as k,kt as l,xt as m,Jr as n,J as o,jn as p,Ae as q,At as r,Hn as s,no as t,ro as u,oo as v,io as w,ao as x,so as y,Nt as z,or as A,Dt as B,zt as C,hr as D,oe as E,Oe as F,Sr as G,Xt as H,Er as I,Go as J};