@kodax-ai/kodax 0.7.71 → 0.7.72

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/CHANGELOG.md +602 -487
  2. package/README.md +46 -27
  3. package/README_CN.md +30 -13
  4. package/dist/chunks/agent-YKGU4USA.js +2 -0
  5. package/dist/chunks/argument-completer-QZETLNAB.js +2 -0
  6. package/dist/chunks/{chunk-SX2WFHIS.js → chunk-2RI252RN.js} +1 -1
  7. package/dist/chunks/chunk-CLFP6UGU.js +71 -0
  8. package/dist/chunks/chunk-E27LHEIP.js +37 -0
  9. package/dist/chunks/chunk-EDZ5KJFT.js +5 -0
  10. package/dist/chunks/chunk-GIK4SGAT.js +364 -0
  11. package/dist/chunks/chunk-GVWPHE23.js +310 -0
  12. package/dist/chunks/{chunk-A2TFSV5M.js → chunk-IR5KIK7E.js} +1 -1
  13. package/dist/chunks/chunk-JSDLBXME.js +755 -0
  14. package/dist/chunks/chunk-MVARIMQV.js +22 -0
  15. package/dist/chunks/chunk-PKQOEDHJ.js +628 -0
  16. package/dist/chunks/{chunk-64NQBOSN.js → chunk-SQODXBLX.js} +1 -1
  17. package/dist/chunks/chunk-VDGCGOQH.js +328 -0
  18. package/dist/chunks/chunk-VVE3UM4F.js +410 -0
  19. package/dist/chunks/chunk-WIBLZK4G.js +151 -0
  20. package/dist/chunks/{compaction-config-5KKKXYFT.js → compaction-config-TWCDFLX6.js} +1 -1
  21. package/dist/chunks/{construction-bootstrap-OXDDDW6O.js → construction-bootstrap-ZJPXUPXQ.js} +1 -1
  22. package/dist/chunks/dist-JT4ATXVM.js +2 -0
  23. package/dist/chunks/host-SVEDZUC5.js +2 -0
  24. package/dist/chunks/{run-manager-Z3W6MDO7.js → run-manager-RX42UNEM.js} +1 -1
  25. package/dist/chunks/{utils-CFOXDCB5.js → utils-OTT5CG5J.js} +1 -1
  26. package/dist/index.d.ts +13 -13
  27. package/dist/index.js +4 -4
  28. package/dist/kodax_bootstrap.js +28 -0
  29. package/dist/kodax_cli.js +1325 -1333
  30. package/dist/kodax_resume.js +44 -0
  31. package/dist/provider-capabilities.json +50 -48
  32. package/dist/runtime-worker.js +1322 -1330
  33. package/dist/sdk-a2a.d.ts +10 -9
  34. package/dist/sdk-a2a.js +1 -1
  35. package/dist/sdk-agent.d.ts +382 -206
  36. package/dist/sdk-agent.js +1 -1
  37. package/dist/sdk-coding.d.ts +80 -128
  38. package/dist/sdk-coding.js +1 -1
  39. package/dist/sdk-experimental-memory.js +1 -1
  40. package/dist/sdk-mcp.js +1 -1
  41. package/dist/sdk-media.d.ts +3 -0
  42. package/dist/sdk-media.js +1 -1
  43. package/dist/sdk-repl.d.ts +71 -23
  44. package/dist/sdk-repl.js +2 -2
  45. package/dist/sdk-runtime.d.ts +143 -31
  46. package/dist/sdk-runtime.js +1 -1
  47. package/dist/sdk-session.d.ts +6 -5
  48. package/dist/sdk-session.js +1 -1
  49. package/dist/sdk-skills.d.ts +5 -5
  50. package/dist/sdk-skills.js +1 -1
  51. package/dist/semantic-worker.js +14 -14
  52. package/dist/types-chunks/{bash-prefix-extractor.d-YoiZl5yt.d.ts → bash-prefix-extractor.d-CHJO5y94.d.ts} +107 -248
  53. package/dist/types-chunks/{capsule.d-CK5Pfz1k.d.ts → capsule.d-DxtdE-GD.d.ts} +24 -95
  54. package/dist/types-chunks/center-types.d-BBT122uJ.d.ts +91 -0
  55. package/dist/types-chunks/{commands.d-D6g2jq8V.d.ts → commands.d-DZxHzH5-.d.ts} +6 -4
  56. package/dist/types-chunks/{guardrail.d-DilYC1dh.d.ts → guardrail.d-DlpMnd-Y.d.ts} +1 -1
  57. package/dist/types-chunks/{guardrail.d-DdeDWnVu.d.ts → guardrail.d-auV61_h5.d.ts} +83 -10
  58. package/dist/types-chunks/public-api.d--IDNJsu1.d.ts +1342 -0
  59. package/dist/types-chunks/{run-manager.d-DxU3SSGR.d.ts → run-manager.d-Bh50OdVl.d.ts} +1 -1
  60. package/dist/types-chunks/sdk-session-Cfw6NFu-.d.ts +82 -0
  61. package/dist/types-chunks/{types.d-CEZZSY9s.d.ts → types.d-CNZgY52F.d.ts} +2 -2
  62. package/dist/types-chunks/{types.d-vJExiRje.d.ts → types.d-DCQVBqVn.d.ts} +10 -5
  63. package/dist/types-chunks/{types.d-CRCaLt_s.d.ts → types.d-DH1mvdcl.d.ts} +284 -164
  64. package/dist/types-chunks/{types.d-CzsLFqmf.d.ts → types.d-EqQmHztg.d.ts} +9 -10
  65. package/dist/types-chunks/{utils.d-Cb6vdvFM.d.ts → utils.d-gmn3c5U4.d.ts} +9 -12
  66. package/docs/SDK_EMBEDDER_GUIDE.md +171 -26
  67. package/package.json +4 -4
  68. package/scripts/kodax-bin.cjs +4 -2
  69. package/scripts/production-env.cjs +9 -0
  70. package/dist/chunks/agent-X2EWQADL.js +0 -2
  71. package/dist/chunks/argument-completer-BLNXDO2F.js +0 -2
  72. package/dist/chunks/chunk-4DY756KL.js +0 -70
  73. package/dist/chunks/chunk-52JSZ77P.js +0 -37
  74. package/dist/chunks/chunk-A574DBTV.js +0 -422
  75. package/dist/chunks/chunk-F7KGYHJ3.js +0 -624
  76. package/dist/chunks/chunk-GVTM4Z6O.js +0 -151
  77. package/dist/chunks/chunk-PHH4TRGF.js +0 -22
  78. package/dist/chunks/chunk-PVUXONQB.js +0 -366
  79. package/dist/chunks/chunk-T7LYK53M.js +0 -329
  80. package/dist/chunks/chunk-VRSVNU2Y.js +0 -7
  81. package/dist/chunks/chunk-Y5XKAN7C.js +0 -755
  82. package/dist/chunks/chunk-Z535BARK.js +0 -306
  83. package/dist/chunks/dist-IXJRJ27U.js +0 -2
  84. package/dist/chunks/host-VRKDAN26.js +0 -2
  85. package/dist/types-chunks/public-api.d-BvCp5VkW.d.ts +0 -601
  86. package/dist/types-chunks/sdk-session-wGpa7X_U.d.ts +0 -796
@@ -0,0 +1,22 @@
1
+ // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
+ import{$a as Ke,Ad as ge,Bd as ze,Cd as Je,Dd as Ge,Ed as Xe,Hd as Ye,ab as Le}from"./chunk-GIK4SGAT.js";import{Q as Ne}from"./chunk-ZJIMT5I3.js";import{$d as Be,Ad as re,Dd as De,Ed as je,Gd as Z,Kd as me,Qd as pe,Rd as U,Sd as we,Td as Ue,_d as Ve,ae as He}from"./chunk-JSDLBXME.js";import{b as fe}from"./chunk-E27LHEIP.js";import{a as i}from"./chunk-ONUPGMER.js";import{basename as gr,dirname as hr}from"node:path";import{execFile as Yt}from"node:child_process";import oe from"node:path";import{promisify as Zt}from"node:util";var Qt=Zt(Yt),en=1e4,ot=2,Ze=new Set(["write","edit","multi_edit","insert_after_anchor"]),Qe=new Set(["read"]),tn=/^\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 nn(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(nn,"normalizeWaitTimeoutMs");function he(e){return e?.requiresMutation===!0||(e?.requiredChangedPaths?.length??0)>0}i(he,"hasVerificationWork");function V(e){return e.replace(/\\/g,"/").replace(/^\.\//,"").trim()}i(V,"normalizeWorkspacePath");function ye(e,t){let n=t.gitRoot?oe.resolve(t.gitRoot):void 0,r=oe.isAbsolute(e)&&n?oe.relative(n,oe.resolve(e)):e;return V(r)}i(ye,"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 it(e){let t=e.trim();return t.length>0&&tn.test(t)}i(it,"isPreparatoryOnlyText");function an(e,t){let n=e.trim(),r=t?.trim();return r&&(n.length===0||it(n))?r:e}i(an,"selectWorkflowFinalText");async function ie(e,t){return(await Qt("git",[...e],{cwd:t,timeout:en,windowsHide:!0,maxBuffer:4194304})).stdout.toString()}i(ie,"runGit");async function sn(e){let t=e.gitRoot??e.executionCwd??process.cwd(),n=(await ie(["rev-parse","--show-toplevel"],t)).trim(),r=await Promise.all([ie(["diff","--name-only","--"],n),ie(["diff","--cached","--name-only","--"],n),ie(["ls-files","--others","--exclude-standard"],n)]);return[...new Set(r.flatMap(a=>a.split(/\r?\n/)).map(V).filter(a=>a.length>0))]}i(sn,"listGitChangedFiles");async function ke(e,t){try{return{paths:(await t(e)).map(V).filter(r=>r.length>0)}}catch(n){return{paths:[],error:n instanceof Error?n.message:String(n)}}}i(ke,"captureChangedPaths");function cn(){return{toolNameById:new Map,toolPathById:new Map,succeededToolCalls:[],succeededPaths:[],readPathById:new Map,succeededReadPaths:[]}}i(cn,"createMutationRecorder");function et(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 V(n)}}i(et,"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=et(n.input);a!==void 0&&t.toolPathById.set(n.id,a)}if(Qe.has(n.name)){let a=et(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 ae(e){return[...new Set(e.filter(t=>t.trim().length>0))]}i(ae,"uniqueItems");function tt(e){let t=e.verification;if(!t)return;let n=[],r=new Set(e.before.paths.map(V)),a=ae(e.after.paths.map(V)),o=a.filter(m=>!r.has(m)),s=ae(e.mutationRecorder.succeededToolCalls),c=e.acceptToolMutationEvidence?s:[],p=e.acceptToolMutationEvidence?ae(e.mutationRecorder.succeededPaths.map(V)):[],g=o.length>0||c.length>0,h=t.enforcement??"hard",y=(t.requiredChangedPaths??[]).map(m=>ye(m,e.ctx)),I=ae(e.mutationRecorder.succeededReadPaths.map(m=>ye(m,e.ctx))),k=(t.requiredReadPaths??[]).map(m=>ye(m,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}`):g||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&&!g&&n.push("workflow child reached its iteration limit before satisfying the task");for(let m of y)!a.includes(m)&&!p.includes(m)&&n.push(`required changed path was not present in workspace changes: ${m}`);for(let m of k)I.includes(m)||n.push(`required review evidence was not read: ${m}`);let A=t.minFinalTextChars;return A!==void 0&&!g&&e.term.finalText.trim().length<A&&n.push(`finalText was shorter than the required ${A} characters`),t.rejectPreparatoryFinalText===!0&&!g&&it(e.term.finalText)&&n.push("finalText looks preparatory instead of terminal"),{ok:n.length===0,enforcement:h,reasons:n,changedPaths:a,mutationToolCalls:s,mutationEvidence:g,...I.length>0?{readPaths:I}:{}}}i(tt,"evaluateVerification");function ve(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(`
3
+ `);return e.trim().length>0?`${e}
4
+
5
+ ${r}`:r}i(ve,"appendVerificationFailure");function nt(){return{ok:!1,enforcement:"warn",reasons:["workflow child reached its iteration limit before satisfying the task"],mutationEvidence:!1}}i(nt,"limitReachedWarningVerification");function un(e){return e.entry.bundle.readOnly!==!0&&e.entry.repairAttempts<ot&&e.term.status==="completed"&&e.verification!==void 0&&e.verification.ok!==!0&&e.verification.enforcement!=="warn"}i(un,"shouldRepairVerificationFailure");function ln(e){let t=e.verification.reasons.map(r=>`- ${r}`).join(`
6
+ `),n=(e.verification.changedPaths??[]).length>0?`
7
+ Workspace changes already present before this repair attempt:
8
+ ${e.verification.changedPaths?.map(r=>`- ${r}`).join(`
9
+ `)??""}`:"";return[e.originalPrompt,"","[Workflow verification repair]",`Repair attempt ${e.attempt}/${ot}.`,"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(`
10
+ `)}i(ln,"buildVerificationRepairPrompt");function rt(e,t,n,r,a=!1){return t.outputSchema!==void 0&&ze(t.outputSchema),Ge(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?.map(o=>{if(!o.startsWith("task_id:"))return o;let s=o.slice(8).trim(),c=r?.get(s);if(!c)throw new Error(`Workflow task ${s} has no Actor path.`);return`agent:${c}`})??[],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}:{},...a?{workflowOutputContract:{kodaxAuthored:!0,terseResult:t.terseResult===!0}}:{},...t.effort?{effort:t.effort}:{}}}i(rt,"buildBundle");function xe(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(xe,"deriveTerminal");function fn(){let e=i(()=>{},"resolvePromise"),t=i(()=>{},"rejectPromise"),n=new Promise((r,a)=>{e=r,t=a});return n.catch(()=>{}),{promise:n,resolve:e,reject:t}}i(fn,"createPendingChildResult");function mn(e,t){let n=e.normalize("NFKD").replace(/[^A-Za-z0-9_-]+/g,"-").replace(/^-+|-+$/g,"").slice(0,48);return`${/^[A-Za-z]/.test(n)&&!/^(?:root|workflow|external)(?:[-_]|$)/i.test(n)?n:"step"}-${t}`}i(mn,"workflowActorTaskName");function pn(e){let t=e.workflow;return{readOnly:t.readOnly!==!1,constraints:[...t.constraints??[]],evidenceRefs:[...t.evidenceRefs??[]],...t.scopeSummary?{scope:t.scopeSummary}:{},...t.modelHint?{modelHint:t.modelHint}:{},...t.isolation?{isolation:t.isolation}:{},...t.effort?{effort:t.effort}:{},...e.executionKey?{executionKey:e.executionKey}:{},...e.agentId?{agentId:e.agentId}:{},...e.specialistName?{specialistName:e.specialistName}:{},...e.workflowRunId?{workflowRunId:e.workflowRunId}:{},...t.target?.expectedConfigurationRevision?{expectedConfigurationRevision:t.target.expectedConfigurationRevision}:{}}}i(pn,"workflowActorMetadata");function wn(e,t){let n=xe(e,t);if(n.status!=="completed"&&n.status!=="completed_unverified")throw new Error(n.finalText||`Workflow Agent ${t} ${n.status}.`);let r=e.mergedArtifacts.filter(Boolean);return{output:n.finalText,...r.length>0?{artifacts:r}:{}}}i(wn,"actorExecutionResult");function at(e){let{ctx:t,childOptions:n}=e,r=e.runChild??Je,a=t.actorControl,o=t.actorHost;if(!a||!o)throw new Error("Workflow execution requires the Runtime-owned Actor control plane.");let s=e.listChangedFiles??sn,c=0,p=0,g=e.generateId??(()=>`wf-child-${c+=1}`),h=new Map,y=new Set,I=i(()=>e.onTaskSummary!==void 0||y.size>0,"hasTaskSummaryObservers"),k=i((f,l)=>{try{e.onTaskSummary?.(f,l)}catch(u){fe({source:"coding:workflow-summary",level:"warn",message:u instanceof Error?u.message:String(u)})}for(let u of y)try{u(f,l)}catch(w){fe({source:"coding:workflow-summary",level:"warn",message:w instanceof Error?w.message:String(w)})}},"notifyTaskSummary"),A=i((f,l,u,w)=>{let S=`workflow:${e.runId??"inline"}:${f}:${w}`,b=fn(),v=i(()=>{},"unregister"),_={async execute(d){try{let T=await u(l,d,o.bindActor(d.actor.path));return b.resolve(T),wn(T,f)}catch(T){throw b.reject(T),T}finally{v()}}};return v=o.registerTurnExecutor(S,_),{key:S,promise:b.promise,cancel:v}},"registerExecution"),m=i(async f=>{let l=on(f,e.defaultChildReadOnly),u=l.subagentType?"constructed":"native",w=l.subagentType,S,b;if(l.target&&l.subagentType)throw new Error("Workflow target and subagentType are mutually exclusive.");if(l.target){let W=t.agentExecutorPlane;if(!W)throw new Error("Workflow target requires a host-bound agent executor plane.");let E=Le(l.target.agentId,W.context,t.agentScope);if(E){if(l.target.expectedConfigurationRevision!==void 0&&l.target.expectedConfigurationRevision!==E.descriptor.configurationRevision)throw new Error("Workflow target configuration revision changed.");let{target:R,...x}=l;l={...x,...E.subagentType?{subagentType:E.subagentType}:{}},u=E.kind,w=E.subagentType}else{if(l.modelHint!==void 0||l.effort!==void 0)throw new Error("External Workflow targets cannot combine local modelHint/effort routing selectors.");if(l.verification?.requiresMutation===!0)throw new Error("External Workflow targets cannot directly satisfy workspace mutation verification.");let R=await W.plane.describe(l.target.agentId,{...W.context,readOnly:l.readOnly},Ke(W.context,t.agentScope));if(!R||R.descriptor.origin!=="external")throw new Error(`Workflow target is not dispatchable: ${l.target.agentId}`);if(l.target.expectedConfigurationRevision!==void 0&&l.target.expectedConfigurationRevision!==R.descriptor.configurationRevision)throw new Error("Workflow target configuration revision changed.");let x=R.descriptor.capabilities;u="external",b=l.target.agentId,S={followup:x.inputRequired!=="unsupported",interrupt:x.cancellation!=="unsupported",streaming:x.streaming!=="unsupported",artifacts:x.artifacts!=="unsupported"}}}let v=g(),_=rt(v,l,new Set(h.keys()),new Map([...h].map(([W,E])=>[W,E.actorPath])),e.kodaxAuthored===!0),T=rn(l).verification,H=cn(),G=l.isolation!=="worktree",K=he(T)?ke(t,s):Promise.resolve({paths:[]}),L=i(async(W,E,R)=>{let x={...n,parentOptions:{...n.parentOptions,events:dn(n.parentOptions.events,H)},maxParallel:1,workflowChild:!0,...e.runId!==void 0?{workflowCorrelation:{workflowRunId:e.runId,childAgentId:v,itemId:`agent:${v}`}}:{},childActivityName:l.name,workflowDigestMode:I()?"async":"blocking",...I()?{onWorkflowChildDigest:i(q=>{k(q.childId,{...q.digest?{summary:q.digest}:{},summaryKind:q.digest?"digest":"digest-failed",...q.totalTokensUsed>0?{usage:q.usage??{totalTokens:q.totalTokensUsed}}:{}})},"onWorkflowChildDigest")}:{},abortSignal:E.signal,actorControl:void 0,actorHost:void 0};return await K,r([W],t,x)},"runBundle"),C=u==="external"?void 0:A(v,_,L,1);p+=1;let j;try{j=await a.spawn({taskName:mn(l.name,p),objective:l.prompt,kind:u,capabilities:{filesystem:l.readOnly!==!1?"read":"write",canAskUser:!1,...S?{control:S}:{}},metadata:pn({workflow:l,...C?{executionKey:C.key}:{},...b?{agentId:b}:{},...w?{specialistName:w}:{},...e.runId?{workflowRunId:e.runId}:{}})})}catch(W){throw C?.cancel(),W}return h.set(v,{name:l.name,input:l,bundle:_,actorPath:j.actorPath,turnId:j.turnId,...C?{promise:C.promise}:{},runBundle:L,external:u==="external",verification:T,changedPathBaseline:K,mutationRecorder:H,acceptToolMutationEvidence:G,repairAttempts:0}),{taskId:v,name:l.name}},"spawn"),M=i(async(f,l,u=l)=>{let w=i(v=>v.turnId===f.turnId&&(v.kind==="turn_completed"||v.kind==="turn_failed"||v.kind==="turn_interrupted"),"isTerminalEvent"),S=l===void 0?void 0:Date.now()+l,b=0;for(;;){let v=a.eventSnapshot(b);if(v.find(w))return;b=v.at(-1)?.sequence??b;let d=S===void 0?void 0:S-Date.now();if(d!==void 0&&d<=0)throw await a.interrupt(f.actorPath,"workflow wait timeout"),new Error(`workflow task ${f.name} timed out after ${u??l}ms`);let T=await a.wait(b,d);if(!T)throw await a.interrupt(f.actorPath,"workflow wait timeout"),new Error(`workflow task ${f.name} timed out after ${u??l}ms`);if(w(T))return;b=T.sequence}},"waitForActorTurn");return{spawn:m,waitForAgentCapacity:i(f=>o.waitForAgentCapacity(f),"waitForAgentCapacity"),wait:i(async(f,l)=>{let u=h.get(f);if(!u)throw new Error(`unknown workflow task: ${f}`);let w=nn(l),S=Date.now(),b=i(async x=>{let q=Date.now()-S,X=w===void 0?void 0:Math.max(0,w-q);if(await M(u,X,w),!x)throw new Error(`workflow task ${f} has no local execution result`);return x},"waitForAttempt");if(u.external){await M(u,w);let x=a.output(u.actorPath,u.turnId);return{taskId:f,name:u.name,status:x.state==="completed"?"completed":x.state==="interrupted"?"stopped":"failed",finalText:x.output??x.error??"",...x.structured===void 0?{}:{structured:x.structured},...x.artifacts.length===0?{}:{artifacts:x.artifacts}}}let v=await b(u.promise),_=v.totalTokensUsed,d=xe(v,f),T=d.routeFacts,H=d.routeFacts?.inputTokens??0,G=d.routeFacts?.outputTokens??0,K=d.routeFacts?.cacheReadTokens??0,L=d.routeFacts?.iterations??0,C=d.routeFacts?.durationMs??0,j=d.routeFacts?.fallbackReason,W=d.digestTokensUsed??0,E=d.digestUsage,R=u.verification?tt({verification:u.verification,term:d,before:await u.changedPathBaseline,after:he(u.verification)?await ke(t,s):{paths:[]},mutationRecorder:u.mutationRecorder,ctx:t,acceptToolMutationEvidence:u.acceptToolMutationEvidence}):void 0;for(d.limitReached===!0&&R===void 0&&d.status==="completed"&&(R=nt(),d={...d,status:"completed_unverified",snapStatus:"completed",finalText:ve(d.finalText,R)});un({entry:u,term:d,verification:R});){u.repairAttempts+=1;let x=ln({originalPrompt:u.input.prompt,previousFinalText:d.finalText,verification:R,attempt:u.repairAttempts}),q=rt(f,{...u.input,prompt:x},new Set(h.keys()),new Map([...h].map(([Y,Xt])=>[Y,Xt.actorPath])),e.kodaxAuthored===!0),X=A(f,q,u.runBundle,u.repairAttempts+1);u.promise=X.promise;try{let Y=await a.followup(u.actorPath,x,{executionKey:X.key});u.turnId=Y.turn.turnId}catch(Y){throw X.cancel(),Y}v=await b(u.promise),_+=v.totalTokensUsed,d=xe(v,f),H+=d.routeFacts?.inputTokens??0,G+=d.routeFacts?.outputTokens??0,K+=d.routeFacts?.cacheReadTokens??0,L+=d.routeFacts?.iterations??0,C+=d.routeFacts?.durationMs??0,j??=d.routeFacts?.fallbackReason,W+=d.digestTokensUsed??0,d.digestUsage&&(E={inputTokens:(E?.inputTokens??0)+(d.digestUsage.inputTokens??0),outputTokens:(E?.outputTokens??0)+(d.digestUsage.outputTokens??0),totalTokens:(E?.totalTokens??0)+(d.digestUsage.totalTokens??0),cacheReadTokens:(E?.cacheReadTokens??0)+(d.digestUsage.cacheReadTokens??0)}),R=u.verification?tt({verification:u.verification,term:d,before:await u.changedPathBaseline,after:he(u.verification)?await ke(t,s):{paths:[]},mutationRecorder:u.mutationRecorder,ctx:t,acceptToolMutationEvidence:u.acceptToolMutationEvidence}):void 0,d.limitReached===!0&&R===void 0&&d.status==="completed"&&(R=nt(),d={...d,status:"completed_unverified",snapStatus:"completed",finalText:ve(d.finalText,R)})}if(R!==void 0&&!R.ok&&d.status==="completed"){let x=R.enforcement==="warn";d={...d,status:x?"completed_unverified":"failed",snapStatus:x?"completed":"failed",finalText:ve(d.finalText,R)}}return{taskId:f,name:u.name,status:d.status,finalText:d.finalText,...d.digest?{digest:d.digest}:{},...d.digestFailed?{digestFailed:!0}:{},...d.digestPending?{digestPending:!0}:{},...R!==void 0?{verification:R}:{},...d.limitReached?{limitReached:!0}:{},...d.provider?{provider:d.provider}:{},...d.model?{model:d.model}:{},...d.structured!==void 0?{structured:d.structured}:{},...v.mergedArtifacts.length>0?{artifacts:v.mergedArtifacts.filter(Boolean)}:{},...W>0?{digestUsage:E??{totalTokens:W}}:{},...d.routeFacts?{requestedTier:T?.requestedTier??d.routeFacts.requestedTier,tierOutcome:d.routeFacts.tierOutcome,providerSource:T?.providerSource??d.routeFacts.providerSource,...T?.modelSource??d.routeFacts.modelSource?{modelSource:T?.modelSource??d.routeFacts.modelSource}:{},...T?.initialProvider??d.routeFacts.initialProvider?{initialProvider:T?.initialProvider??d.routeFacts.initialProvider}:{},...T?.initialModel??d.routeFacts.initialModel?{initialModel:T?.initialModel??d.routeFacts.initialModel}:{},...d.routeFacts.finalProvider?{finalProvider:d.routeFacts.finalProvider}:{},...d.routeFacts.finalModel?{finalModel:d.routeFacts.finalModel}:{},...j?{fallbackReason:j}:{},...d.routeFacts.resolvedEffort?{resolvedEffort:d.routeFacts.resolvedEffort}:{},...L>0?{iterations:L}:{},...C>0?{durationMs:C}:{}}:{},usage:{totalTokens:_,...H>0?{inputTokens:H}:{},...G>0?{outputTokens:G}:{},...K>0?{cacheReadTokens:K}:{}}}},"wait"),output:i(async f=>{let l=h.get(f);if(!l)throw new Error(`unknown workflow task: ${f}`);if(a.get(l.actorPath).actor.currentTurnId===l.turnId)return{taskId:f,name:l.name,status:"running"};let w=a.output(l.actorPath,l.turnId),S=w.state==="completed"?"completed":w.state==="interrupted"?"stopped":"failed",b=w.output??w.error;return b===void 0?{taskId:f,name:l.name,status:S}:{taskId:f,name:l.name,status:S,lastText:b}},"output"),send:i(async(f,l)=>{let u=h.get(f);if(!u)throw new Error(`unknown workflow task: ${f}`);await a.send(u.actorPath,l)},"send"),stop:i(async(f,l)=>{let u=h.get(f);if(!u)throw new Error(`unknown workflow task: ${f}`);await a.interrupt(u.actorPath,l)},"stop"),subscribeTaskSummaryUpdates:i(f=>(y.add(f),()=>{y.delete(f)}),"subscribeTaskSummaryUpdates")}}i(at,"createCodingWorkflowBackend");import{homedir as Zn}from"node:os";import{join as Pt}from"node:path";var gn=["structure, entry points, and control flow","edge cases, error handling, and failure modes","tests, validation, and existing coverage"],hn="Deduplicate overlapping findings, keep concrete evidence (file:line), rank by relevance to the question, and explicitly note gaps left by any failed investigation.",yn={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 kn(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(kn,"readStructuredFinding");function vn(e){let t=kn(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(vn,"pickFindingText");function xn(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(`
11
+ `)}i(xn,"buildInvestigatorPrompt");function Sn(e){let t=Math.max(1,(e.maxAgents??8)-1);return(e.targets&&e.targets.length>0?e.targets:gn).slice(0,t).map((r,a)=>({name:`investigate-${a+1}`,prompt:xn(e.question,r)}))}i(Sn,"resolveAngles");async function Rn(e,t){try{let n=await e.runAgent({name:t.name,prompt:t.prompt,readOnly:!0,modelHint:"balanced",outputSchema:yn});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:vn(n)}}catch(n){let r=n instanceof Error?n.message:String(n);return{angle:t.name,status:"failed",text:`[investigation failed] ${r}`}}}i(Rn,"investigate");async function bn(e,t){let n=Sn(t),r=(await e.phase("investigate",()=>e.parallel(n.map(s=>()=>Rn(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})
12
+ ${s.text}`),rubric:t.rubric??hn}))).text,findings:r,degraded:a}}i(bn,"runParallelInvestigation");var st={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:bn};import{createHash as Tn}from"node:crypto";var Se={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"}}}},Re={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 N(e){return e.normalize("NFC").replace(/\r\n?/g,`
13
+ `).trim().replace(/[\t\n\f\r ]+/g," ")}i(N,"normalizeText");function dt(e){return N(e).replace(/\\/g,"/")}i(dt,"normalizeLocation");function se(e){return[...new Set(e.map(N).filter(Boolean))].sort((t,n)=>t<n?-1:t>n?1:0)}i(se,"uniqueSorted");function In(e,t,n){return Tn("sha256").update(`${e}\0${dt(t)}\0${N(n)}`,"utf8").digest("hex")}i(In,"findingId");function ut(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=dt(r.location),o=N(r.claim),s=N(r.evidence);return{findingId:In(e,a,o),severity:r.severity,location:a,claim:o,evidence:s,...r.suggestedFix?{suggestedFix:N(r.suggestedFix)}:{}}}).sort((r,a)=>r.findingId<a.findingId?-1:r.findingId>a.findingId?1:0),unverifiedRequirements:se(n.unverifiedRequirements)}}i(ut,"normalizeScopedReviewResult");var ct={low:0,medium:1,high:2,critical:3};function Mn(e){return e.reduce((t,n)=>ct[n]>ct[t]?n:t,"low")}i(Mn,"maxSeverity");function lt(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:Mn(o.map(s=>s.severity)),location:o[0].location,claim:o[0].claim,evidence:se(o.map(s=>s.evidence)),suggestedFixes:se(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:se(e.flatMap(a=>a.unverifiedRequirements))}}i(lt,"mergeScopedReviewResults");function ft(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 c=a.get(s.findingId);if(c.disposition==="refuted")return[];let p=c.severityReason?.trim(),g=c.effectiveSeverity!==void 0&&!!p;return[{...s,disposition:c.disposition,severity:g?c.effectiveSeverity:s.severity,verificationEvidence:N(c.evidence),...p?{severityReason:N(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(ft,"applyFindingVerification");var Pn={type:"object",additionalProperties:!1,required:["summary"],properties:{summary:{type:"string"}}};function pt(e){return[e.packetPath,...e.evidenceChunks.map(t=>t.path)]}i(pt,"evidencePaths");function En(e){let t=ge(e,Se);if(t.length>0)throw new Error(`primary reviewer structured result is invalid: ${t.join("; ")}`);return e}i(En,"rawReview");function An(e){let t=ge(e,Re);if(t.length>0)throw new Error(`finding verifier structured result is invalid: ${t.join("; ")}`);return e}i(An,"rawVerification");function be(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(be,"resultOrThrow");function Wn(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(`
14
+ `)}i(Wn,"buildScopedReviewPrimaryPrompt");function Fn(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(`
15
+ `)}i(Fn,"buildScopedReviewVerificationPrompt");function On(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(`
16
+ `)}i(On,"buildScopedReviewFinalPrompt");async function mt(e,t,n,r){let a=be(await e.runAgent({name:`${n?"high-risk-":""}primary-${t.partitionKey}`,phase:"primary-review",prompt:Wn(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:pt(t)},outputSchema:Se,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(mt,"runPrimary");async function qn(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=be(await e.runAgent({name:`verify-${t.partitionKey}`,phase:"verifier",prompt:Fn(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:pt(t)},outputSchema:Re,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"}}),ft(n,An(r.structured))}i(qn,"verifyFindings");async function $n(e,t,n){let r=[await mt(e,t,!1,n)];t.riskFlags.includes("routing-high")&&r.push(await mt(e,t,!0,n));let a=r.map(c=>ut(t.contentHash,t.requirementsPresent,c)),o=lt(a),s=await qn(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(c=>c.disposition==="unresolved").length,unqualifiedApprovalAllowed:s.unqualifiedApprovalAllowed}}),{contentHash:t.contentHash,result:s}}i($n,"reviewPacket");async function Cn(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(c=>()=>$n(e,c,t)),{concurrency:4});if(n.some(c=>c===null))throw new Error("one or more scope packets failed review; no final verdict was accepted");let r=n.filter(c=>c!==null);await e.artifact("scoped-review-audit",r);let a=be(await e.runAgent({name:"final-review-synthesis",phase:"final-synthesis",prompt:On(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:Pn,terseResult:!0}),"final synthesis"),o=a.structured;return{summary:typeof o?.summary=="string"?o.summary:a.finalText,packetResults:r}}i(Cn,"runScopedReview");var wt={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:Cn};function gt(e){return{meta:e.meta,run:i((t,n)=>e.run(t,n),"run")}}i(gt,"erase");var ht=[gt(st),gt(wt)];function yt(e){return ht.find(t=>t.meta.name===e)}i(yt,"getBuiltinWorkflow");function Zr(){return ht.map(e=>e.meta)}i(Zr,"listBuiltinWorkflows");import{mkdir as Rt,readdir as _n,readFile as Q,rename as Nn,unlink as Me,writeFile as Pe}from"node:fs/promises";import{basename as Dn,dirname as Ie,join as B}from"node:path";import{pathToFileURL as jn}from"node:url";var bt=[".workflow.json",".ts",".mjs",".js"],ee="0.7.49";function Tt(){return"0.7.72"}i(Tt,"currentKodaxWorkflowVersion");function Un(e){return e.endsWith(".workflow.json")?"capability-generated":"trusted-local"}i(Un,"executionForPath");function Vn(e){let t=bt.find(n=>e.endsWith(n));return t?e.slice(0,-t.length):void 0}i(Vn,"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 Ae(e){return typeof e=="object"&&e!==null}i(Ae,"isRecord");function kt(e,t){let n=e[t];if(typeof n!="string"||n.length===0)throw new Error(`workflow run.json missing ${t}`);return n}i(kt,"readRequiredString");async function vt(e,t){if(!e)return[];let n;try{n=await _n(e)}catch{return[]}let r=new Map;for(let a of bt)for(let o of n){if(!o.endsWith(a))continue;let s=Vn(o);if(!s||s.length===0||r.has(s))continue;let c=B(e,o);r.set(s,{name:s,path:c,source:t,execution:Un(c)})}return[...r.values()]}i(vt,"scanDir");async function te(e){let t=await vt(e.personal,"personal"),n=await vt(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(te,"discoverSavedWorkflows");function Bn(e){return typeof e=="object"&&e!==null&&"meta"in e&&"run"in e&&typeof e.run=="function"}i(Bn,"isWorkflowModule");function Hn(e){let t=e.default;if(Bn(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(Hn,"normalizeWorkflowModule");function Kn(e){let t=JSON.parse(e);if(!Ae(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=pe(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=Z(t.manifest);return{manifest:r,source:n,capsule:U({minKodaxVersion:ee,manifest:r,source:n}),legacy:!0}}i(Kn,"parseGeneratedWorkflowFile");async function We(e){let t=Kn(await Q(e,"utf8"));return t.capsule??U({minKodaxVersion:ee,manifest:t.manifest,source:t.source})}i(We,"loadSavedWorkflowCapsule");async function It(e){if(e.endsWith(".workflow.json"))return we(await We(e));let t=await import(jn(e).href);return Hn(t)}i(It,"loadSavedWorkflow");function Fe(e){if(e.mayUseWorktree===!0)return{environment:["git-repo","worktree-capable"]}}i(Fe,"deriveRequirements");function ce(e,t){me(t,{filename:`${e.name}.workflow.js`,requireAsyncRun:!0})}i(ce,"assertGeneratedCapsuleSource");async function Ln(e){let t=Ee(e.name),n=Z(e.manifest);ce(n,e.source);let r=e.requires??Fe(n),a=U({minKodaxVersion:e.minKodaxVersion??ee,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 Rt(e.dir,{recursive:!0});let o=B(e.dir,`${t}.workflow.json`);return await Pe(o,`${JSON.stringify(a,null,2)}
17
+ `,"utf8"),{name:t,path:o,source:"project",execution:"capability-generated"}}i(Ln,"saveGeneratedWorkflow");async function xt(e,t){await Pe(e,`${JSON.stringify(t,null,2)}
18
+ `,"utf8")}i(xt,"writeCapsuleFile");async function zn(e){try{return await Q(e,"utf8"),!0}catch{return!1}}i(zn,"fileExists");async function io(e){let t=(await te(e.dirs)).filter(c=>c.name===e.name).filter(c=>e.source===void 0||c.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=B(Ie(n.path),`${r}.workflow.json`);if(a!==n.path&&await zn(a))throw new Error(`saved workflow already exists: ${r}`);let o=await We(n.path);ce(o.manifest,o.source);let s=U({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 Pe(a,`${JSON.stringify(s,null,2)}
19
+ `,"utf8"),a!==n.path&&await Me(n.path),{name:r,path:a,source:n.source,execution:"capability-generated"}}i(io,"renameSavedWorkflow");async function ao(e){let t=(await te(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 Me(n.path),n}i(ao,"deleteSavedWorkflow");async function so(e){let t=Ee(e.name),n=(await te(e.dirs)).filter(k=>k.name===t).filter(k=>e.savedSource===void 0||k.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=Z({...e.manifest,name:t});ce(a,e.source);let o=e.requires??Fe(a),s=U({minKodaxVersion:e.minKodaxVersion??ee,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}:{}}),c=await We(r.path),p=new Date().toISOString().replace(/[:.]/g,"-"),g=B(Ie(r.path),".revisions",t),h=`${p}-${process.hrtime.bigint().toString(36)}`,y=B(g,`${t}-${h}.workflow.json`),I=B(Ie(r.path),`.${t}.${process.pid}.${Date.now().toString(36)}.tmp`);await Rt(g,{recursive:!0}),await xt(y,c);try{await xt(I,s),await Nn(I,r.path)}catch(k){try{await Me(I)}catch{}throw k}return{name:t,path:r.path,source:r.source,execution:"capability-generated",previousPath:y}}i(so,"replaceSavedWorkflow");function Jn(e){if(!Ae(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(Jn,"readOptionalOriginalRequest");function Mt(e){return Gn(e)}i(Mt,"buildCapsuleFromRun");async function Gn(e){let t=JSON.parse(await Q(B(e.runDir,"run.json"),"utf8"));if(!Ae(t))throw new Error("workflow run.json must be an object");let n=kt(t,"scriptSnapshotPath"),r=kt(t,"manifestSnapshotPath"),a=await Q(n,"utf8"),o=Z(JSON.parse(await Q(r,"utf8")));ce(o,a);let s=typeof t.runId=="string"&&t.runId.length>0?t.runId:Dn(e.runDir),c=Jn(t.args),p=Fe(o),g=Ue(o,c!==void 0?{originalRequest:c}:{}),h={description:"Provide new workflow args matching the generated request shape.",..."args"in t?{examples:[t.args]}:{}};return U({minKodaxVersion:ee,manifest:o,source:a,intent:g,inputs:h,...p!==void 0?{requires:p}:{},provenance:{fromRunId:s,createdAt:new Date().toISOString(),kodaxVersion:Tt()}})}i(Gn,"readCapsuleFromRun");async function co(e){let t=await Mt(e);return{capsule:t,module:we(t)}}i(co,"loadGeneratedWorkflowFromRun");async function uo(e){let t=await Mt(e);return Ln({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(uo,"saveGeneratedWorkflowFromRun");function D(e,t,n,r){e.push({severity:t,requirement:n,message:r})}i(D,"addRequirementIssue");function St(e){let t=/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e.trim());if(t)return[Number(t[1]),Number(t[2]),Number(t[3])]}i(St,"parseSemver");function Xn(e,t){for(let n=0;n<3;n+=1){let r=e[n]-t[n];if(r!==0)return r}return 0}i(Xn,"compareSemver");function Yn(e,t,n){let r=St(t),a=St(n);if(!r){D(e,"error","kodax:min-version",`workflow minKodaxVersion is not valid semver: ${t}`);return}if(!a){D(e,"warning","kodax:min-version",`cannot verify workflow minKodaxVersion ${t}; current version is unknown`);return}Xn(a,r)<0&&D(e,"error","kodax:min-version",`workflow requires KodaX >= ${t}, current version is ${n}`)}i(Yn,"addMinVersionIssue");function Te(e,t,n,r){if(!n)return;if(!r){for(let o of n)D(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)||D(e,"error",`${t}:${o}`,`missing required workflow ${t}: ${o}`)}i(Te,"addMissingItems");function lo(e,t={}){let n=pe(e),r=[],a=n.requires;Yn(r,n.minKodaxVersion,t.kodaxVersion??Tt()),a?.environment?.includes("git-repo")&&t.isGitRepo===!1&&D(r,"error","environment:git-repo","workflow requires a git repository"),a?.environment?.includes("worktree-capable")&&t.worktreeCapable===!1&&D(r,"error","environment:worktree-capable","workflow may request git worktree isolation");try{me(n.source,{filename:`${n.manifest.name}.workflow.js`,requireAsyncRun:!0})}catch(o){let s=o instanceof Error?o.message:String(o);D(r,"error","workflow:source",s)}return Te(r,"tools",a?.tools,t.availableTools),Te(r,"mcp",a?.mcp,t.availableMcp),Te(r,"skills",a?.skills,t.availableSkills),{ok:!r.some(o=>o.severity==="error"),issues:r}}i(lo,"preflightWorkflowCapsule");function Qn(e){return{project:Pt(e,".kodax","workflows"),personal:Pt(Zn(),".kodax","workflows")}}i(Qn,"defaultSavedWorkflowDirs");async function er(e,t){let r=(await te(t)).find(a=>a.name===e);if(r)return It(r.path)}i(er,"resolveSavedByName");function Et(e){let t=Qn(e);return async n=>yt(n)??await er(n,t)}i(Et,"createNestedWorkflowResolver");import{existsSync as tr,mkdirSync as nr,readFileSync as rr,writeFileSync as At}from"node:fs";import{join as ne}from"node:path";var Wt="results";function Ft(e){return e.replace(/[^a-zA-Z0-9._-]/g,"_")}i(Ft,"safeKey");function Ot(e,t){let n=ne(e,t);if(tr(n))try{return JSON.parse(rr(n,"utf8"))}catch{return}}i(Ot,"readResult");function qt(e,t={}){let n=ne(e,Wt);nr(n,{recursive:!0});let r=t.readFrom?ne(t.readFrom,Wt):void 0;return{get:i(a=>{let o=`${Ft(a)}.json`,s=Ot(n,o);if(s!==void 0)return s;if(r===void 0)return;let c=Ot(r,o);if(c!==void 0){try{At(ne(n,o),JSON.stringify(c),"utf8")}catch{}return c}},"get"),set:i((a,o)=>{try{At(ne(n,`${Ft(a)}.json`),JSON.stringify(o),"utf8")}catch{}},"set")}}i(qt,"createFsResultCache");import{mkdirSync as or,appendFileSync as ir,writeFileSync as ue}from"node:fs";import{join as z}from"node:path";function de(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)?e:void 0}i(de,"record");function F(e){return typeof e=="number"&&Number.isFinite(e)&&e>=0?e:0}i(F,"finiteNumber");function $t(e){let t=new Map,n=new Set,r=[],a=[],o=new Set,s=[],c=[],p=0,g=0,h=0,y=0,I=0,k=0,A=0,m=0,M={},$=[];for(let O of e){let P=O.data??{};if(O.type==="agent_spawned"){let u=typeof P.taskId=="string"?P.taskId:void 0;u&&t.set(u,P),P.role==="primary-review"&&(k+=1);let w=typeof P.role=="string"?P.role:"agent",S=typeof P.requestedTier=="string"?P.requestedTier:"inherited",b=`${w}/${S}`;M[b]=(M[b]??0)+1;continue}if(O.type==="agent_completed"||O.type==="agent_unverified"||O.type==="agent_failed"){let u=typeof P.taskId=="string"?P.taskId:void 0;if(!u||n.has(u))continue;n.add(u);let w=de(P.usage);!w||typeof w.totalTokens!="number"?typeof t.get(u)?.externalTarget=="string"?a.push(u):r.push(u):(p+=F(w.totalTokens),g+=F(w.inputTokens),h+=F(w.cacheReadTokens??w.cachedReadTokens),y+=F(w.outputTokens));let S=de(P.digestUsage);I+=F(S?.totalTokens),g+=F(S?.inputTokens),y+=F(S?.outputTokens),h+=F(S?.cacheReadTokens??S?.cachedReadTokens),A+=F(P.iterations);continue}if(O.type==="agent_summary_updated"){let u=de(P.usage),w=P.summaryKind;if((w==="digest"||w==="digest-failed")&&u){let S=F(u.totalTokens);p+=S,I+=S,g+=F(u.inputTokens),y+=F(u.outputTokens),h+=F(u.cacheReadTokens??u.cachedReadTokens)}continue}if(O.type!=="workflow_log")continue;let f=de(P.data);if(f?.kind==="review_quality_gate"&&typeof f.contentHash=="string"){$.push({contentHash:f.contentHash,actionableFindings:F(f.actionableFindings),unresolvedFindings:F(f.unresolvedFindings),unqualifiedApprovalAllowed:f.unqualifiedApprovalAllowed===!0});continue}if(f?.kind!=="review_packet_read"||typeof f.contentHash!="string")continue;let l={contentHash:f.contentHash,...typeof f.reason=="string"?{reason:f.reason}:{}};f.role==="primary"?(o.has(f.contentHash)&&(m+=1),o.add(f.contentHash)):f.role==="verification"?s.push(l):f.role==="synthesis"&&c.push(l)}for(let O of t.keys())n.has(O)||r.push(O);let J=[...new Set(r)].sort();return{totalModelTokens:p,inputTokens:g,cacheReadTokens:h,outputTokens:y,digestTokens:I,agentStarts:t.size,childTurns:A,agentStartsByRoleTier:M,primaryReviewStarts:k,duplicatePrimaryPacketReads:m,verificationPacketReads:s,synthesisPacketReads:c,reviewWaves:k>0?1:0,fixWaves:0,rereviewWaves:0,qualityGateOutcomes:$,tokenCoverage:{ok:J.length===0,missingTaskIds:J},excludedExternalTaskIds:[...new Set(a)].sort()}}i($t,"buildWorkflowCostReport");function ar(e){let t=e.replace(/[^a-zA-Z0-9._-]/g,"_").slice(0,120);return t.length>0?t:"artifact"}i(ar,"safeWorkflowArtifactName");function Ct(e,t={}){let n=t.now??(()=>Date.now()),r=z(e,"artifacts");or(r,{recursive:!0});let a=z(e,"events.jsonl");return{runDir:e,onEvent:i(o=>{ir(a,`${JSON.stringify({...o,ts:n()})}
20
+ `,"utf8")},"onEvent"),writeArtifact:i((o,s)=>{let c=z(r,`${ar(o)}.json`);return ue(c,JSON.stringify(s,null,2),"utf8"),{name:o,path:c}},"writeArtifact"),writeScriptSnapshot:i(o=>{let s=z(e,"script.js");if(ue(s,o.source,"utf8"),!o.manifest)return{scriptPath:s};let c=z(e,"manifest.json");return ue(c,`${JSON.stringify(o.manifest,null,2)}
21
+ `,"utf8"),{scriptPath:s,manifestPath:c}},"writeScriptSnapshot"),writeRunJson:i(o=>{let s=De(o.processMetadata?.hostMetadata),c={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:{...$t(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}:{}}:{}};ue(z(e,"run.json"),`${JSON.stringify(c,null,2)}
22
+ `,"utf8")},"writeRunJson")}}i(Ct,"createRunGraphWriter");import{execFile as sr}from"node:child_process";import{promisify as cr}from"node:util";import{statSync as dr}from"node:fs";import{join as ur}from"node:path";var lr=cr(sr);function qe(e){return ur(e,"worktrees")}i(qe,"workflowWorktreeBaseDir");var fr=360*60*1e3;function Nt(e,t){return lr("git",[...e],{cwd:t}).then(n=>n.stdout)}i(Nt,"defaultRunGit");function mr(e){return dr(e).mtimeMs}i(mr,"defaultMtimeMs");function pr(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(pr,"parseWorktreeList");function _t(e){return e.replace(/\\/g,"/").replace(/\/+$/,"")}i(_t,"normalize");function Dt(e,t){let n=_t(e),r=_t(t);return n===r||n.startsWith(`${r}/`)}i(Dt,"isUnder");async function wr(e,t,n){try{let a=(await t(["status","--porcelain"],e.path)).split(/\r?\n/).filter(c=>c.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(wr,"worktreeHasChanges");async function jt(e,t,n,r,a){if(await wr(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(jt,"removeWorktree");async function Ut(e,t,n){try{let r=await t(["worktree","list","--porcelain"],e);return pr(r)}catch(r){n.push(`list worktrees: ${r instanceof Error?r.message:String(r)}`);return}}i(Ut,"listWorktrees");async function Oe(e,t,n){try{await t(["worktree","prune"],e)}catch(r){n.push(`prune: ${r instanceof Error?r.message:String(r)}`)}}i(Oe,"prune");async function Vt(e,t={}){let n=[],r=[];if(!e.gitRoot)return{removed:r,warnings:n};let a=t.runGit??Nt,o=await Ut(e.gitRoot,a,n);if(!o)return{removed:r,warnings:n};for(let s of o)Dt(s.path,e.baseDir)&&await jt(s,e.gitRoot,a,r,n);return r.length>0&&await Oe(e.gitRoot,a,n),{removed:r,warnings:n}}i(Vt,"sweepWorkflowRunWorktrees");async function Bt(e,t={}){let n=[],r=[];if(!e.gitRoot)return{removed:r,warnings:n};let a=t.runGit??Nt,o=t.mtimeMs??mr,s=t.now??(()=>Date.now()),c=e.maxAgeMs??fr;await Oe(e.gitRoot,a,n);let p=await Ut(e.gitRoot,a,n);if(!p)return{removed:r,warnings:n};for(let g of p){if(!Dt(g.path,e.workflowRunsRoot))continue;let h;try{h=s()-o(g.path)}catch{continue}h>=c&&await jt(g,e.gitRoot,a,r,n)}return r.length>0&&await Oe(e.gitRoot,a,n),{removed:r,warnings:n}}i(Bt,"pruneStaleWorkflowWorktrees");var yr=200,Ht={maxAgents:64,tokenBudget:2e5};function kr(e,t){let n=e.meta,r=le(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(kr,"buildApprovalSummary");function $e(e,t){if(e!==void 0)return!Number.isInteger(e)||e<=0?1:Math.min(e,t)}i($e,"clampLimit");function vr(e,t,n){let r=$e(e,n),a=$e(t,n);return r===void 0?a:a===void 0?r:Math.min(r,a)}i(vr,"clampEffectiveLimit");function Kt(e,t){if(!(e==null||!Number.isFinite(e)||e<=0))return Math.min(Math.floor(e),t)}i(Kt,"clampTokenBudget");function xr(e,t,n){let r=Kt(e,n),a=Kt(t,n);return r===void 0?a:a===void 0?r:Math.min(r,a)}i(xr,"clampEffectiveTokenBudget");function le(e,t){let n=vr(e.maxAgents,t?.maxAgents,Ht.maxAgents),r=Ne(),a=[e.maxConcurrency,t?.maxConcurrency].map(c=>$e(c,r)).filter(c=>c!==void 0),o=a.length===0?r:Math.min(r,...a),s=xr(e.tokenBudget,t?.tokenBudget,Ht.tokenBudget);return{...n!==void 0?{maxAgents:n}:{},...o!==void 0?{maxConcurrency:o}:{},...s!==void 0?{tokenBudget:s}:{}}}i(le,"clampWorkflowLimits");function Ce(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(Ce,"workflowResultSummary");async function _e(e){let t=le(e.module.meta,e.hostPolicy),n=kr(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 Bt({workflowRunsRoot:hr(e.runDir),gitRoot:a},{now:r,...e.worktreeSweepDeps});let o=Ct(e.runDir,{now:r}),s=e.resumeFromRunDir!==void 0?gr(e.resumeFromRunDir):void 0,c=e.onWorkflowProcessEvent?je({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,g=e.backend??Sr(e),y={...e.beforeSpawn?Rr(g,e.beforeSpawn):g,writeArtifact:i(async(m,M)=>o.writeArtifact(m,M),"writeArtifact")},I=r(),k;try{k=await Ve({runId:e.runId,args:e.args,backend:y,limits:t,...e.signal?{signal:e.signal}:{},summarizeResult:Ce,resolveWorkflowModule:Et(a??process.cwd()),resultCache:qt(e.runDir,e.resumeFromRunDir?{readFrom:e.resumeFromRunDir}:{}),onEvent:i(m=>{o.onEvent(m),c&&e.onWorkflowProcessEvent?.(c.applyEvent(m)),e.onEvent?.(m)},"onEvent")},m=>e.module.run(m,e.args))}finally{await Vt({baseDir:qe(e.runDir),gitRoot:a},{now:r,...e.worktreeSweepDeps})}let A=k.ok?Ce(k.result):void 0;return o.writeRunJson({meta:e.module.meta,args:e.args,state:k.state,startedAt:I,endedAt:r(),...p?{scriptSnapshot:p}:{},...A!==void 0?{resultSummary:A}:{},...e.processMetadata!==void 0||s!==void 0?{processMetadata:{...e.processMetadata,...s!==void 0?{resumedFromRunId:s}:{}}}:{}}),k.ok?{kind:"completed",result:k.result,state:k.state}:{kind:"failed",error:k.error,state:k.state}}i(_e,"runWorkflowModule");function Sr(e){if(!e.ctx||!e.childOptions)throw new Error("runWorkflowModule requires either a backend or ctx + childOptions");return at({ctx:e.ctx,childOptions:e.childOptions,runId:e.runId,defaultChildReadOnly:e.module.meta.readOnly===!0,kodaxAuthored:e.processMetadata?.hostMetadata?.workflowAuthorship==="kodax-generated"})}i(Sr,"buildBackend");function Rr(e,t){return{...e,spawn:i(async n=>(await t(),e.spawn(n)),"spawn")}}i(Rr,"withBeforeSpawn");function br(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(br,"emitWorkflowAgentDigest");async function Jt(e){let t=e.options.context?.actorControl,n=e.options.context?.actorHost;if(t===void 0!=(n===void 0))throw new Error("Workflow Runtime requires actorControl and actorHost together.");let r=t?void 0:new Xe({maxConcurrentThreadsPerSession:e.options.maxConcurrentThreadsPerSession}),a=r?{...e.options,context:{...e.options.context,actorSession:r}}:e.options,o=Ye({options:a,runtime:a.extensionRuntime,managedProtocolPayloadRef:{current:void 0}}),s=o.actorControl,c=o.actorHost;if(!s||!c)throw new Error("Workflow execution requires the Runtime-owned Actor control plane.");let p=await c.createWorkflowOwner(s.callerPath,e.runId),g=c.workflowOwnerSignal(p.callerPath),h=Ir(e.signal,g);o.actorControl=p,o.actorHost=c;let y={...a,context:{...a.context,actorControl:p,actorHost:c}};Object.assign(o,{workflowWorktreeBaseDir:qe(e.runDir)});let I={maxIterationsPerChild:yr,parentRole:"worker",parentHarness:"tool-dispatch",parentOptions:{provider:y.provider,model:y.modelOverride??y.model,effort:y.effort,reasoningMode:y.reasoningMode,repoIntelligenceMode:y.context?.repoIntelligenceMode,repoIntelligenceTrace:y.context?.repoIntelligenceTrace,extensionRuntime:y.extensionRuntime,events:y.events},...e.options.guardrails?{guardrails:e.options.guardrails}:{},...o.planModeBlockCheck?{planModeBlockCheck:o.planModeBlockCheck}:{}},k=e.onWorkflowProcessEvent||e.options.events?.onWorkflowProcessEvent?m=>{e.onWorkflowProcessEvent?.(m),y.events?.onWorkflowProcessEvent?.(m)}:void 0,A=e.onEvent||y.events?.onWorkflowAgentDigest?m=>{e.onEvent?.(m),br(y.events,e.runId,m)}:void 0;try{let m=await _e({module:e.module,args:e.args,runId:e.runId,runDir:e.runDir,ctx:o,childOptions:I,...e.approval?{approval:e.approval}:{},signal:h,...A?{onEvent:A}:{},...k?{onWorkflowProcessEvent:k}:{},...y.workflowHostPolicy?{hostPolicy:y.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}:{}}),M=Tr(e.runId,m);return await c.settleWorkflowOwner(p.callerPath,Lt(M),{output:JSON.stringify(M),structured:zt(M),artifacts:M.artifacts.map($=>$.path??$.name).filter(Boolean),...m.kind==="failed"?{error:m.error.message}:{}}),m}catch(m){let M=m instanceof Error?m:new Error(String(m)),$=re({state:{runId:e.runId,status:g.aborted?"stopped":"failed",totalSpawned:0,results:[],events:[],artifacts:[]},error:M});try{await c.settleWorkflowOwner(p.callerPath,Lt($),{output:JSON.stringify($),structured:zt($),error:M.message})}catch(J){throw new AggregateError([M,J],"Workflow execution and owner settlement failed.")}throw M}finally{await r?.close("workflow run finished")}}i(Jt,"runWorkflowFromOptions");function Tr(e,t){return t.kind==="denied"?re({state:{runId:e,status:"stopped",totalSpawned:0,results:[],events:[],artifacts:[]},summary:`Workflow ${e} was declined.`}):re({state:t.state,...t.kind==="completed"?{summary:Ce(t.result)}:{error:t.error}})}i(Tr,"workflowProtocolOutcome");function Lt(e){return e.status==="failed"?"failed":e.status==="interrupted"?"interrupted":"completed"}i(Lt,"protocolOwnerState");function Ir(e,t){return e?AbortSignal.any([e,t]):t}i(Ir,"combineAbortSignals");function zt(e){return JSON.parse(JSON.stringify(e))}i(zt,"toAgentMetadata");function Mr(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(Mr,"resultText");function Pr(e){if(e.kind==="completed"){let t=Mr(e.result);return t!==void 0?{status:"completed",resultText:t}:{status:"completed"}}return e.kind==="denied"?{status:"denied"}:{status:"failed",error:e.error}}i(Pr,"classifyOutcome");function Er(e,t){return{kind:"failed",error:t instanceof Error?t:new Error(String(t)),state:{runId:e,status:"failed",totalSpawned:0,results:[],events:[],artifacts:[]}}}i(Er,"failedOutcome");var Ar=1e3;function Wr(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>Ar){let g=new Set(t.list().map(h=>h.runId));for(let h of n.keys())h!==o.runId&&!g.has(h)&&n.delete(h)}let c=le(o.meta,o.hostPolicy),p=t.start({runId:o.runId,workflow:o.meta.name,...o.meta.phases!==void 0?{phases:o.meta.phases}:{},...c.maxAgents!==void 0?{maxAgents:c.maxAgents}:{},...o.meta.plannedAgents!==void 0?{plannedAgents:o.meta.plannedAgents}:{},...c.tokenBudget!==void 0?{tokenBudget:c.tokenBudget}:{},...o.processMetadata!==void 0?{processMetadata:o.processMetadata}:{},...o.signal?{signal:o.signal}:{},runFn:s,classify:Pr,onError:i(g=>Er(o.runId,g),"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=>_e({...o,signal:s.signal,beforeSpawn:s.beforeSpawn,onEvent:i(c=>{s.onEvent(c),o.onEvent?.(c)},"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=>Jt({...o,signal:s.signal,beforeSpawn:s.beforeSpawn,onEvent:i(c=>{s.onEvent(c),o.onEvent?.(c)},"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(Wr,"createWorkflowRunManager");var Gt;function Zo(){return Gt??=Wr({},He()),Gt}i(Zo,"getDefaultWorkflowRunManager");export{at as a,st as b,Se as c,Re as d,ut as e,lt as f,ft as g,Wn as h,Fn as i,On as j,wt as k,ht as l,yt as m,Zr as n,te as o,Hn as p,We as q,It as r,Ln as s,io as t,ao as u,so as v,co as w,uo as x,lo as y,$t as z,ar as A,Ct as B,Ht as C,kr as D,le as E,_e as F,br as G,Jt as H,Wr as I,Zo as J};