@kodax-ai/kodax 0.7.76 → 0.7.78
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.
- package/CHANGELOG.md +758 -371
- package/LICENSE +158 -158
- package/README.md +1702 -1508
- package/README_CN.md +1019 -869
- package/config-templates/config.example.jsonc +86 -4
- package/config-templates/integrations/a2a.example.jsonc +98 -98
- package/config-templates/integrations/extensions.example.jsonc +7 -7
- package/config-templates/integrations/mcp.example.jsonc +16 -16
- package/dist/builtin/code-review/SKILL.md +22 -22
- package/dist/builtin/skill-creator/scripts/aggregate-benchmark.d.ts +46 -46
- package/dist/builtin/skill-creator/scripts/analyze-benchmark.d.ts +46 -46
- package/dist/builtin/skill-creator/scripts/compare-runs.d.ts +62 -62
- package/dist/builtin/skill-creator/scripts/generate-review.d.ts +33 -33
- package/dist/builtin/skill-creator/scripts/grade-evals.d.ts +73 -73
- package/dist/builtin/skill-creator/scripts/improve-description.d.ts +23 -23
- package/dist/builtin/skill-creator/scripts/init-skill.d.ts +14 -14
- package/dist/builtin/skill-creator/scripts/install-skill.d.ts +29 -29
- package/dist/builtin/skill-creator/scripts/package-skill.d.ts +38 -38
- package/dist/builtin/skill-creator/scripts/quick-validate.d.ts +8 -8
- package/dist/builtin/skill-creator/scripts/run-eval.d.ts +66 -66
- package/dist/builtin/skill-creator/scripts/run-loop.d.ts +49 -49
- package/dist/builtin/skill-creator/scripts/run-trigger-eval.d.ts +58 -58
- package/dist/chunks/agent-ASP4MS3X.js +2 -0
- package/dist/chunks/argument-completer-JYQ7FX3W.js +2 -0
- package/dist/chunks/chunk-2CFHBKRE.js +5 -0
- package/dist/chunks/chunk-35PPHOQ2.js +292 -0
- package/dist/chunks/chunk-43QNNDHR.js +29 -0
- package/dist/chunks/chunk-5BNQXXGY.js +1 -0
- package/dist/chunks/chunk-5GO6FH7L.js +458 -0
- package/dist/chunks/chunk-5NDCSFOP.js +78 -0
- package/dist/chunks/chunk-6FOJVETH.js +22 -0
- package/dist/chunks/chunk-6XM4B6K2.js +48 -0
- package/dist/chunks/chunk-6YZUE6NC.js +240 -0
- package/dist/chunks/{chunk-RDXRM3UI.js → chunk-7OEBJGHK.js} +1 -1
- package/dist/chunks/chunk-KQLQYHWU.js +386 -0
- package/dist/chunks/chunk-NXO6GWSY.js +46 -0
- package/dist/chunks/chunk-T2XZTLYE.js +316 -0
- package/dist/chunks/chunk-TQDBTTIM.js +348 -0
- package/dist/chunks/{chunk-SMT2JSM3.js → chunk-UID7BLAB.js} +9 -9
- package/dist/chunks/chunk-VAT2QYXM.js +765 -0
- package/dist/chunks/chunk-YAZQTC2L.js +5 -0
- package/dist/chunks/chunk-YVRYHC4C.js +655 -0
- package/dist/chunks/{chunk-PXKSE54E.js → chunk-Z3KFRTSB.js} +1 -1
- package/dist/chunks/compaction-config-BQSSIWK5.js +2 -0
- package/dist/chunks/{construction-bootstrap-5F5KF2BZ.js → construction-bootstrap-VQLQGWPY.js} +1 -1
- package/dist/chunks/dist-BFT5YIGU.js +2 -0
- package/dist/chunks/dist-PCFE24YP.js +2 -0
- package/dist/chunks/host-UTFXCYYM.js +2 -0
- package/dist/chunks/run-manager-PJU3WIFJ.js +2 -0
- package/dist/chunks/utils-SID4HW2Q.js +2 -0
- package/dist/index.d.ts +21 -19
- package/dist/index.js +6 -6
- package/dist/kodax_bootstrap.js +25 -25
- package/dist/kodax_cli.js +1787 -1341
- package/dist/kodax_resume.js +17 -17
- package/dist/provider-capabilities.json +392 -362
- package/dist/runtime-worker.js +1707 -1279
- package/dist/sandbox-workspace-session.js +563 -0
- package/dist/sdk-a2a.d.ts +18 -17
- package/dist/sdk-a2a.js +8 -8
- package/dist/sdk-agent.d.ts +320 -70
- package/dist/sdk-agent.js +1 -1
- package/dist/sdk-coding.d.ts +135 -168
- package/dist/sdk-coding.js +1 -1
- package/dist/sdk-experimental-memory.d.ts +14 -597
- package/dist/sdk-experimental-memory.js +1 -1
- package/dist/sdk-llm.d.ts +219 -6
- package/dist/sdk-llm.js +1 -1
- package/dist/sdk-mcp.js +1 -1
- package/dist/sdk-media.d.ts +1 -1
- package/dist/sdk-media.js +1 -1
- package/dist/sdk-repl.d.ts +70 -27
- package/dist/sdk-repl.js +2 -2
- package/dist/sdk-runtime.d.ts +212 -149
- package/dist/sdk-runtime.js +1 -1
- package/dist/sdk-sandbox.d.ts +93 -0
- package/dist/sdk-sandbox.js +2 -0
- package/dist/sdk-session.d.ts +8 -8
- package/dist/sdk-session.js +1 -1
- package/dist/sdk-skills.d.ts +2 -2
- package/dist/sdk-skills.js +1 -1
- package/dist/semantic-worker.js +15 -15
- package/dist/types-chunks/{base.d-ChvpaKjZ.d.ts → base.d-4e74xDdy.d.ts} +13 -1
- package/dist/types-chunks/{bash-prefix-extractor.d-r1beOESM.d.ts → bash-prefix-extractor.d-uAe2Oqda.d.ts} +319 -9
- package/dist/types-chunks/{capability-learning.d-DPrYxRjF.d.ts → capability-learning.d-CVsdHw4j.d.ts} +1 -1
- package/dist/types-chunks/{capsule.d-zeqV4IQX.d.ts → capsule.d-BlSv9l3V.d.ts} +2 -2
- package/dist/types-chunks/{guardrail.d-CWYD1bdL.d.ts → guardrail.d-BRE_ErEj.d.ts} +1 -1
- package/dist/types-chunks/{guardrail.d-qjuKJZ31.d.ts → guardrail.d-CXDYRgZ3.d.ts} +201 -35
- package/dist/types-chunks/{history-retrieval.d-BKTJIrVd.d.ts → history-retrieval.d-DtCy7x64.d.ts} +2 -2
- package/dist/types-chunks/{integration-config.d-ojG4swOP.d.ts → integration-config.d-BNowXE8k.d.ts} +23 -8
- package/dist/types-chunks/{public-api.d-CX4B11qY.d.ts → public-api.d-B3AohsxN.d.ts} +37 -8
- package/dist/types-chunks/{commands.d-DUxnK2TU.d.ts → repl.d-Ie_ZXb_U.d.ts} +89 -78
- package/dist/types-chunks/{side-query.d-DWTMsndP.d.ts → resolver.d-iAQ9ocLB.d.ts} +23 -74
- package/dist/types-chunks/{run-manager.d-B9fEIjZk.d.ts → run-manager.d-D1twIhF9.d.ts} +1 -1
- package/dist/types-chunks/{sdk-session-B0fhAOPa.d.ts → sdk-session-DB9KksIx.d.ts} +3 -3
- package/dist/types-chunks/side-query.d-DTuLPcC5.d.ts +77 -0
- package/dist/types-chunks/types-D3g6XUQr.d.ts +662 -0
- package/dist/types-chunks/{types.d-sRLugmjy.d.ts → types.d-BA-Jwpfs.d.ts} +506 -11
- package/dist/types-chunks/{types.d-DEctY20M.d.ts → types.d-BH0ZkTGf.d.ts} +2 -2
- package/dist/types-chunks/{types.d-DCQVBqVn.d.ts → types.d-BbtGlKZu.d.ts} +25 -3
- package/dist/types-chunks/{types.d-CSmF0t0n.d.ts → types.d-DIpZJKUl.d.ts} +15 -0
- package/dist/types-chunks/{types.d-Bm_y6YuM.d.ts → types.d-DVDTIfB_.d.ts} +4 -4
- package/dist/types-chunks/{utils.d-D0wPxz8y.d.ts → utils.d-CVp6bFl9.d.ts} +23 -7
- package/docs/SDK_EMBEDDER_GUIDE.md +592 -119
- package/package.json +9 -1
- package/scripts/kodax-bin.cjs +28 -28
- package/scripts/production-env.cjs +25 -25
- package/dist/chunks/agent-7X5CFET2.js +0 -2
- package/dist/chunks/argument-completer-3NHIKB4N.js +0 -2
- package/dist/chunks/chunk-4PWPNCNK.js +0 -158
- package/dist/chunks/chunk-7FJNLJLF.js +0 -369
- package/dist/chunks/chunk-COQYLD4U.js +0 -5
- package/dist/chunks/chunk-D3T24FJW.js +0 -78
- package/dist/chunks/chunk-EI4JBQKL.js +0 -46
- package/dist/chunks/chunk-HGT6WQ24.js +0 -321
- package/dist/chunks/chunk-HS3XHF3R.js +0 -622
- package/dist/chunks/chunk-IDCGNQ4H.js +0 -5
- package/dist/chunks/chunk-KAY2XLCP.js +0 -74
- package/dist/chunks/chunk-OD6LVXU6.js +0 -329
- package/dist/chunks/chunk-OSF3H4RR.js +0 -22
- package/dist/chunks/chunk-TGMBHGZO.js +0 -427
- package/dist/chunks/chunk-VWSLC2WO.js +0 -770
- package/dist/chunks/chunk-Y3AMP22L.js +0 -37
- package/dist/chunks/compaction-config-7J2XE35D.js +0 -2
- package/dist/chunks/dist-2RA7LSH3.js +0 -2
- package/dist/chunks/dist-URKXBOC6.js +0 -2
- package/dist/chunks/host-RKZ2OGFT.js +0 -2
- package/dist/chunks/run-manager-7RM4HEH6.js +0 -2
- package/dist/chunks/utils-X3TEH6IO.js +0 -2
- package/dist/types-chunks/center-types.d-BBT122uJ.d.ts +0 -91
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
|
|
2
|
+
import{Td as ge,Ud as Ge,Wd as Xe,Xd as Ye,Yd as Ze,de as Qe,pb as Ke,qb as Le,tb as ze,ub as Je}from"./chunk-KQLQYHWU.js";import{Q as Ne}from"./chunk-5NDCSFOP.js";import{Ad as pe,Bd as B,Cd as we,Dd as Ue,Kd as Ve,Ld as Be,Md as He,kd as re,nd as De,od as je,qd as Z,ud as me}from"./chunk-VAT2QYXM.js";import{d as fe}from"./chunk-6XM4B6K2.js";import{a as i}from"./chunk-ONUPGMER.js";import{basename as kr,dirname as vr}from"node:path";import{execFile as Qt}from"node:child_process";import oe from"node:path";import{promisify as en}from"node:util";var tn=en(Qt),nn=1e4,at=2,et=new Set(["write","edit","multi_edit","insert_after_anchor"]),tt=new Set(["read"]);function rn(e,t){if(t.includes("*"))return e;if(e.includes("*"))return t;let n=new Set(t);return e.filter(r=>n.has(r))}i(rn,"intersectWorkflowToolCeilings");var on=/^\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 an(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(an,"normalizeWaitTimeoutMs");function he(e){return e?.requiresMutation===!0||(e?.requiredChangedPaths?.length??0)>0}i(he,"hasVerificationWork");function H(e){return e.replace(/\\/g,"/").replace(/^\.\//,"").trim()}i(H,"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 H(r)}i(ye,"normalizeRequiredPath");function sn(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(sn,"resolveVerificationForInput");function cn(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(cn,"resolveSpawnAgentInput");function st(e){let t=e.trim();return t.length>0&&on.test(t)}i(st,"isPreparatoryOnlyText");function dn(e,t){let n=e.trim(),r=t?.trim();return r&&(n.length===0||st(n))?r:e}i(dn,"selectWorkflowFinalText");async function ie(e,t){return(await tn("git",[...e],{cwd:t,timeout:nn,windowsHide:!0,maxBuffer:4194304})).stdout.toString()}i(ie,"runGit");async function un(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(H).filter(a=>a.length>0))]}i(un,"listGitChangedFiles");async function ke(e,t){try{return{paths:(await t(e)).map(H).filter(r=>r.length>0)}}catch(n){return{paths:[],error:n instanceof Error?n.message:String(n)}}}i(ke,"captureChangedPaths");function ln(){return{toolNameById:new Map,toolPathById:new Map,succeededToolCalls:[],succeededPaths:[],readPathById:new Map,succeededReadPaths:[]}}i(ln,"createMutationRecorder");function nt(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 H(n)}}i(nt,"readMutationPath");function fn(e,t){return{...e??{},onToolUseStart:i((n,r)=>{if(et.has(n.name)){t.toolNameById.set(n.id,n.name);let a=nt(n.input);a!==void 0&&t.toolPathById.set(n.id,a)}if(tt.has(n.name)){let a=nt(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(et.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(tt.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(fn,"wrapEventsForMutationRecording");function ae(e){return[...new Set(e.filter(t=>t.trim().length>0))]}i(ae,"uniqueItems");function rt(e){let t=e.verification;if(!t)return;let n=[],r=new Set(e.before.paths.map(H)),a=ae(e.after.paths.map(H)),o=a.filter(m=>!r.has(m)),s=ae(e.mutationRecorder.succeededToolCalls),d=e.acceptToolMutationEvidence?s:[],w=e.acceptToolMutationEvidence?ae(e.mutationRecorder.succeededPaths.map(H)):[],h=o.length>0||d.length>0,y=t.enforcement??"hard",g=(t.requiredChangedPaths??[]).map(m=>ye(m,e.ctx)),b=ae(e.mutationRecorder.succeededReadPaths.map(m=>ye(m,e.ctx))),v=(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}`):h||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&&!h&&n.push("workflow child reached its iteration limit before satisfying the task");for(let m of g)!a.includes(m)&&!w.includes(m)&&n.push(`required changed path was not present in workspace changes: ${m}`);for(let m of v)b.includes(m)||n.push(`required review evidence was not read: ${m}`);let W=t.minFinalTextChars;return W!==void 0&&!h&&e.term.finalText.trim().length<W&&n.push(`finalText was shorter than the required ${W} characters`),t.rejectPreparatoryFinalText===!0&&!h&&st(e.term.finalText)&&n.push("finalText looks preparatory instead of terminal"),{ok:n.length===0,enforcement:y,reasons:n,changedPaths:a,mutationToolCalls:s,mutationEvidence:h,...b.length>0?{readPaths:b}:{}}}i(rt,"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 ot(){return{ok:!1,enforcement:"warn",reasons:["workflow child reached its iteration limit before satisfying the task"],mutationEvidence:!1}}i(ot,"limitReachedWarningVerification");function mn(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(mn,"shouldRepairVerificationFailure");function pn(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}/${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(`
|
|
10
|
+
`)}i(pn,"buildVerificationRepairPrompt");function it(e,t,n,r,a=!1){return t.outputSchema!==void 0&&Ge(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?.map(o=>{if(!o.startsWith("task_id:"))return o;let s=o.slice(8).trim(),d=r?.get(s);if(!d)throw new Error(`Workflow task ${s} has no Actor path.`);return`agent:${d}`})??[],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(it,"buildBundle");function xe(e,t){if(e.cancelledChildren.includes(t))return{status:"stopped",snapStatus:"aborted",finalText:""};let n=e.results[0],r=dn(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 wn(){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(wn,"createPendingChildResult");function gn(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(gn,"workflowActorTaskName");function hn(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(hn,"workflowActorMetadata");function yn(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(yn,"actorExecutionResult");function ct(e){let{ctx:t,childOptions:n}=e,r=e.runChild??Xe,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??un,d=0,w=0,h=e.generateId??(()=>`wf-child-${d+=1}`),y=new Map,g=new Set,b=i(()=>e.onTaskSummary!==void 0||g.size>0,"hasTaskSummaryObservers"),v=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 g)try{u(f,l)}catch(p){fe({source:"coding:workflow-summary",level:"warn",message:p instanceof Error?p.message:String(p)})}},"notifyTaskSummary"),W=i((f,l,u,p)=>{let S=`workflow:${e.runId??"inline"}:${f}:${p}`,I=wn(),P=i(()=>{},"unregister"),A={async execute(c){try{let E=await u(l,c,o.bindActor(c.actor.path));return I.resolve(E),yn(E,f)}catch(E){throw I.reject(E),E}finally{P()}}};return P=o.registerTurnExecutor(S,A),{key:S,promise:I.promise,cancel:P}},"registerExecution"),m=i(async f=>{let l=cn(f,e.defaultChildReadOnly),u=l.subagentType?"constructed":"native",p=l.subagentType,S=p?(()=>{let R=Le(p,t.agentScope);return R?Ke(R):void 0})():void 0,I,P;if(l.target&&l.subagentType)throw new Error("Workflow target and subagentType are mutually exclusive.");if(l.target){let R=t.agentExecutorPlane;if(!R)throw new Error("Workflow target requires a host-bound agent executor plane.");let k=Je(l.target.agentId,R.context,t.agentScope);if(k){if(l.target.expectedConfigurationRevision!==void 0&&l.target.expectedConfigurationRevision!==k.descriptor.configurationRevision)throw new Error("Workflow target configuration revision changed.");let{target:x,...q}=l;l={...q,...k.subagentType?{subagentType:k.subagentType}:{}},u=k.kind,p=k.subagentType,S=k.toolCeiling}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 x=await R.plane.describe(l.target.agentId,{...R.context,readOnly:l.readOnly},ze(R.context,t.agentScope));if(!x||x.descriptor.origin!=="external")throw new Error(`Workflow target is not dispatchable: ${l.target.agentId}`);if(l.target.expectedConfigurationRevision!==void 0&&l.target.expectedConfigurationRevision!==x.descriptor.configurationRevision)throw new Error("Workflow target configuration revision changed.");let q=x.descriptor.capabilities;u="external",P=l.target.agentId,I={followup:q.inputRequired!=="unsupported",interrupt:q.cancellation!=="unsupported",streaming:q.streaming!=="unsupported",artifacts:q.artifacts!=="unsupported"}}}let A=h(),c=it(A,l,new Set(y.keys()),new Map([...y].map(([R,k])=>[R,k.actorPath])),e.kodaxAuthored===!0),_=sn(l).verification,N=ln(),X=l.isolation!=="worktree",L=he(_)?ke(t,s):Promise.resolve({paths:[]}),z=i(async(R,k,x)=>{let q={...n,parentOptions:{...n.parentOptions,events:fn(n.parentOptions.events,N)},maxParallel:1,workflowChild:!0,...e.runId!==void 0?{workflowCorrelation:{workflowRunId:e.runId,childAgentId:A,itemId:`agent:${A}`}}:{},childActivityName:l.name,workflowDigestMode:b()?"async":"blocking",...b()?{onWorkflowChildDigest:i(O=>{v(O.childId,{...O.digest?{summary:O.digest}:{},summaryKind:O.digest?"digest":"digest-failed",...O.totalTokensUsed>0?{usage:O.usage??{totalTokens:O.totalTokensUsed}}:{}})},"onWorkflowChildDigest")}:{},abortSignal:k.signal,actorControl:void 0,actorHost:void 0,actorCapabilities:k.actor.capabilities,contextAgentId:k.actor.path,...k.actor.parentPath!==void 0?{contextParentAgentId:k.actor.parentPath}:{}};return await L,r([R],t,q)},"runBundle"),D=u==="external"?void 0:W(A,c,z,1);w+=1;let V;try{V=await a.spawn({taskName:gn(l.name,w),objective:l.prompt,kind:u,capabilities:{filesystem:l.readOnly!==!1?"read":"write",canAskUser:!1,...S!==void 0?{tools:rn(S,a.get(a.callerPath).actor.capabilities.tools)}:{},...I?{control:I}:{}},metadata:hn({workflow:l,...D?{executionKey:D.key}:{},...P?{agentId:P}:{},...p?{specialistName:p}:{},...e.runId?{workflowRunId:e.runId}:{}})})}catch(R){throw D?.cancel(),R}return y.set(A,{name:l.name,input:l,bundle:c,actorPath:V.actorPath,turnId:V.turnId,...D?{promise:D.promise}:{},runBundle:z,external:u==="external",verification:_,changedPathBaseline:L,mutationRecorder:N,acceptToolMutationEvidence:X,repairAttempts:0}),{taskId:A,name:l.name}},"spawn"),T=i(async(f,l,u=l)=>{let p=i(()=>{let c=a.output(f.actorPath,f.turnId).state;return c==="completed"||c==="failed"||c==="interrupted"},"isTurnTerminal"),S=i(c=>c.turnId===f.turnId&&(c.kind==="turn_completed"||c.kind==="turn_failed"||c.kind==="turn_interrupted"),"isTerminalEvent"),I=i(async()=>{if(p())return!1;try{return await a.interrupt(f.actorPath,"workflow wait timeout"),!0}catch(c){if(p())return!1;throw c}},"interruptOrAcceptTerminal"),P=l===void 0?void 0:Date.now()+l,A=0;for(;;){if(p())return;let c=a.eventSnapshot(A);if(c.find(S))return;A=c.at(-1)?.sequence??A;let _=P===void 0?void 0:P-Date.now();if(_!==void 0&&_<=0){if(await I())throw new Error(`workflow task ${f.name} timed out after ${u??l}ms`);return}let N=await a.wait(A,_);if(N){if(S(N))return;A=N.sequence}}},"waitForActorTurn");return{spawn:m,waitForAgentCapacity:i(f=>o.waitForAgentCapacity(f),"waitForAgentCapacity"),wait:i(async(f,l)=>{let u=y.get(f);if(!u)throw new Error(`unknown workflow task: ${f}`);let p=an(l),S=Date.now(),I=i(async x=>{let q=Date.now()-S,O=p===void 0?void 0:Math.max(0,p-q);if(await T(u,O,p),!x)throw new Error(`workflow task ${f} has no local execution result`);return x},"waitForAttempt");if(u.external){await T(u,p);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 P=await I(u.promise),A=P.totalTokensUsed,c=xe(P,f),E=c.routeFacts,_=c.routeFacts?.inputTokens??0,N=c.routeFacts?.outputTokens??0,X=c.routeFacts?.cacheReadTokens??0,L=c.routeFacts?.iterations??0,z=c.routeFacts?.durationMs??0,D=c.routeFacts?.fallbackReason,V=c.digestTokensUsed??0,R=c.digestUsage,k=u.verification?rt({verification:u.verification,term:c,before:await u.changedPathBaseline,after:he(u.verification)?await ke(t,s):{paths:[]},mutationRecorder:u.mutationRecorder,ctx:t,acceptToolMutationEvidence:u.acceptToolMutationEvidence}):void 0;for(c.limitReached===!0&&k===void 0&&c.status==="completed"&&(k=ot(),c={...c,status:"completed_unverified",snapStatus:"completed",finalText:ve(c.finalText,k)});mn({entry:u,term:c,verification:k});){u.repairAttempts+=1;let x=pn({originalPrompt:u.input.prompt,previousFinalText:c.finalText,verification:k,attempt:u.repairAttempts}),q=it(f,{...u.input,prompt:x},new Set(y.keys()),new Map([...y].map(([Y,Zt])=>[Y,Zt.actorPath])),e.kodaxAuthored===!0),O=W(f,q,u.runBundle,u.repairAttempts+1);u.promise=O.promise;try{let Y=await a.followup(u.actorPath,x,{executionKey:O.key});u.turnId=Y.turn.turnId}catch(Y){throw O.cancel(),Y}P=await I(u.promise),A+=P.totalTokensUsed,c=xe(P,f),_+=c.routeFacts?.inputTokens??0,N+=c.routeFacts?.outputTokens??0,X+=c.routeFacts?.cacheReadTokens??0,L+=c.routeFacts?.iterations??0,z+=c.routeFacts?.durationMs??0,D??=c.routeFacts?.fallbackReason,V+=c.digestTokensUsed??0,c.digestUsage&&(R={inputTokens:(R?.inputTokens??0)+(c.digestUsage.inputTokens??0),outputTokens:(R?.outputTokens??0)+(c.digestUsage.outputTokens??0),totalTokens:(R?.totalTokens??0)+(c.digestUsage.totalTokens??0),cacheReadTokens:(R?.cacheReadTokens??0)+(c.digestUsage.cacheReadTokens??0)}),k=u.verification?rt({verification:u.verification,term:c,before:await u.changedPathBaseline,after:he(u.verification)?await ke(t,s):{paths:[]},mutationRecorder:u.mutationRecorder,ctx:t,acceptToolMutationEvidence:u.acceptToolMutationEvidence}):void 0,c.limitReached===!0&&k===void 0&&c.status==="completed"&&(k=ot(),c={...c,status:"completed_unverified",snapStatus:"completed",finalText:ve(c.finalText,k)})}if(k!==void 0&&!k.ok&&c.status==="completed"){let x=k.enforcement==="warn";c={...c,status:x?"completed_unverified":"failed",snapStatus:x?"completed":"failed",finalText:ve(c.finalText,k)}}return{taskId:f,name:u.name,status:c.status,finalText:c.finalText,...c.digest?{digest:c.digest}:{},...c.digestFailed?{digestFailed:!0}:{},...c.digestPending?{digestPending:!0}:{},...k!==void 0?{verification:k}:{},...c.limitReached?{limitReached:!0}:{},...c.provider?{provider:c.provider}:{},...c.model?{model:c.model}:{},...c.structured!==void 0?{structured:c.structured}:{},...P.mergedArtifacts.length>0?{artifacts:P.mergedArtifacts.filter(Boolean)}:{},...V>0?{digestUsage:R??{totalTokens:V}}:{},...c.routeFacts?{requestedTier:E?.requestedTier??c.routeFacts.requestedTier,tierOutcome:c.routeFacts.tierOutcome,providerSource:E?.providerSource??c.routeFacts.providerSource,...E?.modelSource??c.routeFacts.modelSource?{modelSource:E?.modelSource??c.routeFacts.modelSource}:{},...E?.initialProvider??c.routeFacts.initialProvider?{initialProvider:E?.initialProvider??c.routeFacts.initialProvider}:{},...E?.initialModel??c.routeFacts.initialModel?{initialModel:E?.initialModel??c.routeFacts.initialModel}:{},...c.routeFacts.finalProvider?{finalProvider:c.routeFacts.finalProvider}:{},...c.routeFacts.finalModel?{finalModel:c.routeFacts.finalModel}:{},...D?{fallbackReason:D}:{},...c.routeFacts.resolvedEffort?{resolvedEffort:c.routeFacts.resolvedEffort}:{},...L>0?{iterations:L}:{},...z>0?{durationMs:z}:{}}:{},usage:{totalTokens:A,..._>0?{inputTokens:_}:{},...N>0?{outputTokens:N}:{},...X>0?{cacheReadTokens:X}:{}}}},"wait"),output:i(async f=>{let l=y.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 p=a.output(l.actorPath,l.turnId),S=p.state==="completed"?"completed":p.state==="interrupted"?"stopped":"failed",I=p.output??p.error;return I===void 0?{taskId:f,name:l.name,status:S}:{taskId:f,name:l.name,status:S,lastText:I}},"output"),send:i(async(f,l)=>{let u=y.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=y.get(f);if(!u)throw new Error(`unknown workflow task: ${f}`);await a.interrupt(u.actorPath,l)},"stop"),subscribeTaskSummaryUpdates:i(f=>(g.add(f),()=>{g.delete(f)}),"subscribeTaskSummaryUpdates")}}i(ct,"createCodingWorkflowBackend");import{homedir as tr}from"node:os";import{join as Et}from"node:path";var kn=["structure, entry points, and control flow","edge cases, error handling, and failure modes","tests, validation, and existing coverage"],vn="Deduplicate overlapping findings, keep concrete evidence (file:line), rank by relevance to the question, and explicitly note gaps left by any failed investigation.",xn={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 Sn(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(Sn,"readStructuredFinding");function Rn(e){let t=Sn(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(Rn,"pickFindingText");function bn(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(bn,"buildInvestigatorPrompt");function Tn(e){let t=Math.max(1,(e.maxAgents??8)-1);return(e.targets&&e.targets.length>0?e.targets:kn).slice(0,t).map((r,a)=>({name:`investigate-${a+1}`,prompt:bn(e.question,r)}))}i(Tn,"resolveAngles");async function In(e,t){try{let n=await e.runAgent({name:t.name,prompt:t.prompt,readOnly:!0,modelHint:"balanced",outputSchema:xn});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:Rn(n)}}catch(n){let r=n instanceof Error?n.message:String(n);return{angle:t.name,status:"failed",text:`[investigation failed] ${r}`}}}i(In,"investigate");async function Pn(e,t){let n=Tn(t),r=(await e.phase("investigate",()=>e.parallel(n.map(s=>()=>In(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??vn}))).text,findings:r,degraded:a}}i(Pn,"runParallelInvestigation");var dt={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:Pn};import{createHash as Mn}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 j(e){return e.normalize("NFC").replace(/\r\n?/g,`
|
|
13
|
+
`).trim().replace(/[\t\n\f\r ]+/g," ")}i(j,"normalizeText");function lt(e){return j(e).replace(/\\/g,"/")}i(lt,"normalizeLocation");function se(e){return[...new Set(e.map(j).filter(Boolean))].sort((t,n)=>t<n?-1:t>n?1:0)}i(se,"uniqueSorted");function An(e,t,n){return Mn("sha256").update(`${e}\0${lt(t)}\0${j(n)}`,"utf8").digest("hex")}i(An,"findingId");function ft(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=j(r.claim),s=j(r.evidence);return{findingId:An(e,a,o),severity:r.severity,location:a,claim:o,evidence:s,...r.suggestedFix?{suggestedFix:j(r.suggestedFix)}:{}}}).sort((r,a)=>r.findingId<a.findingId?-1:r.findingId>a.findingId?1:0),unverifiedRequirements:se(n.unverifiedRequirements)}}i(ft,"normalizeScopedReviewResult");var ut={low:0,medium:1,high:2,critical:3};function En(e){return e.reduce((t,n)=>ut[n]>ut[t]?n:t,"low")}i(En,"maxSeverity");function mt(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:En(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(mt,"mergeScopedReviewResults");function pt(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 w=d.severityReason?.trim(),h=d.effectiveSeverity!==void 0&&!!w;return[{...s,disposition:d.disposition,severity:h?d.effectiveSeverity:s.severity,verificationEvidence:j(d.evidence),...w?{severityReason:j(w)}:{}}]});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(pt,"applyFindingVerification");var Wn={type:"object",additionalProperties:!1,required:["summary"],properties:{summary:{type:"string"}}};function gt(e){return[e.packetPath,...e.evidenceChunks.map(t=>t.path)]}i(gt,"evidencePaths");function Fn(e){let t=ge(e,Se);if(t.length>0)throw new Error(`primary reviewer structured result is invalid: ${t.join("; ")}`);return e}i(Fn,"rawReview");function On(e){let t=ge(e,Re);if(t.length>0)throw new Error(`finding verifier structured result is invalid: ${t.join("; ")}`);return e}i(On,"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 qn(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(qn,"buildScopedReviewPrimaryPrompt");function Cn(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(Cn,"buildScopedReviewVerificationPrompt");function $n(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($n,"buildScopedReviewFinalPrompt");async function wt(e,t,n,r){let a=be(await e.runAgent({name:`${n?"high-risk-":""}primary-${t.partitionKey}`,phase:"primary-review",prompt:qn(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:gt(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}}),Fn(a.structured)}i(wt,"runPrimary");async function _n(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:Cn(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:gt(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"}}),pt(n,On(r.structured))}i(_n,"verifyFindings");async function Nn(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=>ft(t.contentHash,t.requirementsPresent,d)),o=mt(a),s=await _n(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(Nn,"reviewPacket");async function Dn(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=>()=>Nn(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=be(await e.runAgent({name:"final-review-synthesis",phase:"final-synthesis",prompt:$n(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:Wn,terseResult:!0}),"final synthesis"),o=a.structured;return{summary:typeof o?.summary=="string"?o.summary:a.finalText,packetResults:r}}i(Dn,"runScopedReview");var ht={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:Dn};function yt(e){return{meta:e.meta,run:i((t,n)=>e.run(t,n),"run")}}i(yt,"erase");var kt=[yt(dt),yt(ht)];function vt(e){return kt.find(t=>t.meta.name===e)}i(vt,"getBuiltinWorkflow");function no(){return kt.map(e=>e.meta)}i(no,"listBuiltinWorkflows");import{mkdir as Tt,readdir as jn,readFile as Q,rename as Un,unlink as Pe,writeFile as Me}from"node:fs/promises";import{basename as Vn,dirname as Ie,join as K}from"node:path";import{pathToFileURL as Bn}from"node:url";var It=[".workflow.json",".ts",".mjs",".js"],ee="0.7.49";function Pt(){return"0.7.78"}i(Pt,"currentKodaxWorkflowVersion");function Hn(e){return e.endsWith(".workflow.json")?"capability-generated":"trusted-local"}i(Hn,"executionForPath");function Kn(e){let t=It.find(n=>e.endsWith(n));return t?e.slice(0,-t.length):void 0}i(Kn,"stripWorkflowSuffix");function Ae(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(Ae,"safeWorkflowName");function Ee(e){return typeof e=="object"&&e!==null}i(Ee,"isRecord");function xt(e,t){let n=e[t];if(typeof n!="string"||n.length===0)throw new Error(`workflow run.json missing ${t}`);return n}i(xt,"readRequiredString");async function St(e,t){if(!e)return[];let n;try{n=await jn(e)}catch{return[]}let r=new Map;for(let a of It)for(let o of n){if(!o.endsWith(a))continue;let s=Kn(o);if(!s||s.length===0||r.has(s))continue;let d=K(e,o);r.set(s,{name:s,path:d,source:t,execution:Hn(d)})}return[...r.values()]}i(St,"scanDir");async function te(e){let t=await St(e.personal,"personal"),n=await St(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 Ln(e){return typeof e=="object"&&e!==null&&"meta"in e&&"run"in e&&typeof e.run=="function"}i(Ln,"isWorkflowModule");function zn(e){let t=e.default;if(Ln(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(zn,"normalizeWorkflowModule");function Jn(e){let t=JSON.parse(e);if(!Ee(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:B({minKodaxVersion:ee,manifest:r,source:n}),legacy:!0}}i(Jn,"parseGeneratedWorkflowFile");async function We(e){let t=Jn(await Q(e,"utf8"));return t.capsule??B({minKodaxVersion:ee,manifest:t.manifest,source:t.source})}i(We,"loadSavedWorkflowCapsule");async function Mt(e){if(e.endsWith(".workflow.json"))return we(await We(e));let t=await import(Bn(e).href);return zn(t)}i(Mt,"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 Gn(e){let t=Ae(e.name),n=Z(e.manifest);ce(n,e.source);let r=e.requires??Fe(n),a=B({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 Tt(e.dir,{recursive:!0});let o=K(e.dir,`${t}.workflow.json`);return await Me(o,`${JSON.stringify(a,null,2)}
|
|
17
|
+
`,"utf8"),{name:t,path:o,source:"project",execution:"capability-generated"}}i(Gn,"saveGeneratedWorkflow");async function Rt(e,t){await Me(e,`${JSON.stringify(t,null,2)}
|
|
18
|
+
`,"utf8")}i(Rt,"writeCapsuleFile");async function Xn(e){try{return await Q(e,"utf8"),!0}catch{return!1}}i(Xn,"fileExists");async function uo(e){let t=(await te(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=Ae(e.newName),a=K(Ie(n.path),`${r}.workflow.json`);if(a!==n.path&&await Xn(a))throw new Error(`saved workflow already exists: ${r}`);let o=await We(n.path);ce(o.manifest,o.source);let s=B({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)}
|
|
19
|
+
`,"utf8"),a!==n.path&&await Pe(n.path),{name:r,path:a,source:n.source,execution:"capability-generated"}}i(uo,"renameSavedWorkflow");async function lo(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 Pe(n.path),n}i(lo,"deleteSavedWorkflow");async function fo(e){let t=Ae(e.name),n=(await te(e.dirs)).filter(v=>v.name===t).filter(v=>e.savedSource===void 0||v.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=B({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}:{}}),d=await We(r.path),w=new Date().toISOString().replace(/[:.]/g,"-"),h=K(Ie(r.path),".revisions",t),y=`${w}-${process.hrtime.bigint().toString(36)}`,g=K(h,`${t}-${y}.workflow.json`),b=K(Ie(r.path),`.${t}.${process.pid}.${Date.now().toString(36)}.tmp`);await Tt(h,{recursive:!0}),await Rt(g,d);try{await Rt(b,s),await Un(b,r.path)}catch(v){try{await Pe(b)}catch{}throw v}return{name:t,path:r.path,source:r.source,execution:"capability-generated",previousPath:g}}i(fo,"replaceSavedWorkflow");function Yn(e){if(!Ee(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(Yn,"readOptionalOriginalRequest");function At(e){return Zn(e)}i(At,"buildCapsuleFromRun");async function Zn(e){let t=JSON.parse(await Q(K(e.runDir,"run.json"),"utf8"));if(!Ee(t))throw new Error("workflow run.json must be an object");let n=xt(t,"scriptSnapshotPath"),r=xt(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:Vn(e.runDir),d=Yn(t.args),w=Fe(o),h=Ue(o,d!==void 0?{originalRequest:d}:{}),y={description:"Provide new workflow args matching the generated request shape.",..."args"in t?{examples:[t.args]}:{}};return B({minKodaxVersion:ee,manifest:o,source:a,intent:h,inputs:y,...w!==void 0?{requires:w}:{},provenance:{fromRunId:s,createdAt:new Date().toISOString(),kodaxVersion:Pt()}})}i(Zn,"readCapsuleFromRun");async function mo(e){let t=await At(e);return{capsule:t,module:we(t)}}i(mo,"loadGeneratedWorkflowFromRun");async function po(e){let t=await At(e);return Gn({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(po,"saveGeneratedWorkflowFromRun");function U(e,t,n,r){e.push({severity:t,requirement:n,message:r})}i(U,"addRequirementIssue");function bt(e){let t=/^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(e.trim());if(t)return[Number(t[1]),Number(t[2]),Number(t[3])]}i(bt,"parseSemver");function Qn(e,t){for(let n=0;n<3;n+=1){let r=e[n]-t[n];if(r!==0)return r}return 0}i(Qn,"compareSemver");function er(e,t,n){let r=bt(t),a=bt(n);if(!r){U(e,"error","kodax:min-version",`workflow minKodaxVersion is not valid semver: ${t}`);return}if(!a){U(e,"warning","kodax:min-version",`cannot verify workflow minKodaxVersion ${t}; current version is unknown`);return}Qn(a,r)<0&&U(e,"error","kodax:min-version",`workflow requires KodaX >= ${t}, current version is ${n}`)}i(er,"addMinVersionIssue");function Te(e,t,n,r){if(!n)return;if(!r){for(let o of n)U(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)||U(e,"error",`${t}:${o}`,`missing required workflow ${t}: ${o}`)}i(Te,"addMissingItems");function wo(e,t={}){let n=pe(e),r=[],a=n.requires;er(r,n.minKodaxVersion,t.kodaxVersion??Pt()),a?.environment?.includes("git-repo")&&t.isGitRepo===!1&&U(r,"error","environment:git-repo","workflow requires a git repository"),a?.environment?.includes("worktree-capable")&&t.worktreeCapable===!1&&U(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);U(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(wo,"preflightWorkflowCapsule");function nr(e){return{project:Et(e,".kodax","workflows"),personal:Et(tr(),".kodax","workflows")}}i(nr,"defaultSavedWorkflowDirs");async function rr(e,t){let r=(await te(t)).find(a=>a.name===e);if(r)return Mt(r.path)}i(rr,"resolveSavedByName");function Wt(e){let t=nr(e);return async n=>vt(n)??await rr(n,t)}i(Wt,"createNestedWorkflowResolver");import{existsSync as or,mkdirSync as ir,readFileSync as ar,writeFileSync as Ft}from"node:fs";import{join as ne}from"node:path";var Ot="results";function qt(e){return e.replace(/[^a-zA-Z0-9._-]/g,"_")}i(qt,"safeKey");function Ct(e,t){let n=ne(e,t);if(or(n))try{return JSON.parse(ar(n,"utf8"))}catch{return}}i(Ct,"readResult");function $t(e,t={}){let n=ne(e,Ot);ir(n,{recursive:!0});let r=t.readFrom?ne(t.readFrom,Ot):void 0;return{get:i(a=>{let o=`${qt(a)}.json`,s=Ct(n,o);if(s!==void 0)return s;if(r===void 0)return;let d=Ct(r,o);if(d!==void 0){try{Ft(ne(n,o),JSON.stringify(d),"utf8")}catch{}return d}},"get"),set:i((a,o)=>{try{Ft(ne(n,`${qt(a)}.json`),JSON.stringify(o),"utf8")}catch{}},"set")}}i($t,"createFsResultCache");import{mkdirSync as sr,appendFileSync as cr,writeFileSync as ue}from"node:fs";import{join as J}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=[],d=[],w=0,h=0,y=0,g=0,b=0,v=0,W=0,m=0,T={},$=[];for(let C of e){let M=C.data??{};if(C.type==="agent_spawned"){let u=typeof M.taskId=="string"?M.taskId:void 0;u&&t.set(u,M),M.role==="primary-review"&&(v+=1);let p=typeof M.role=="string"?M.role:"agent",S=typeof M.requestedTier=="string"?M.requestedTier:"inherited",I=`${p}/${S}`;T[I]=(T[I]??0)+1;continue}if(C.type==="agent_completed"||C.type==="agent_unverified"||C.type==="agent_failed"){let u=typeof M.taskId=="string"?M.taskId:void 0;if(!u||n.has(u))continue;n.add(u);let p=de(M.usage);!p||typeof p.totalTokens!="number"?typeof t.get(u)?.externalTarget=="string"?a.push(u):r.push(u):(w+=F(p.totalTokens),h+=F(p.inputTokens),y+=F(p.cacheReadTokens??p.cachedReadTokens),g+=F(p.outputTokens));let S=de(M.digestUsage);b+=F(S?.totalTokens),h+=F(S?.inputTokens),g+=F(S?.outputTokens),y+=F(S?.cacheReadTokens??S?.cachedReadTokens),W+=F(M.iterations);continue}if(C.type==="agent_summary_updated"){let u=de(M.usage),p=M.summaryKind;if((p==="digest"||p==="digest-failed")&&u){let S=F(u.totalTokens);w+=S,b+=S,h+=F(u.inputTokens),g+=F(u.outputTokens),y+=F(u.cacheReadTokens??u.cachedReadTokens)}continue}if(C.type!=="workflow_log")continue;let f=de(M.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"&&d.push(l)}for(let C of t.keys())n.has(C)||r.push(C);let G=[...new Set(r)].sort();return{totalModelTokens:w,inputTokens:h,cacheReadTokens:y,outputTokens:g,digestTokens:b,agentStarts:t.size,childTurns:W,agentStartsByRoleTier:T,primaryReviewStarts:v,duplicatePrimaryPacketReads:m,verificationPacketReads:s,synthesisPacketReads:d,reviewWaves:v>0?1:0,fixWaves:0,rereviewWaves:0,qualityGateOutcomes:$,tokenCoverage:{ok:G.length===0,missingTaskIds:G},excludedExternalTaskIds:[...new Set(a)].sort()}}i(_t,"buildWorkflowCostReport");function dr(e){let t=e.replace(/[^a-zA-Z0-9._-]/g,"_").slice(0,120);return t.length>0?t:"artifact"}i(dr,"safeWorkflowArtifactName");function Nt(e,t={}){let n=t.now??(()=>Date.now()),r=J(e,"artifacts");sr(r,{recursive:!0});let a=J(e,"events.jsonl");return{runDir:e,onEvent:i(o=>{cr(a,`${JSON.stringify({...o,ts:n()})}
|
|
20
|
+
`,"utf8")},"onEvent"),writeArtifact:i((o,s)=>{let d=J(r,`${dr(o)}.json`);return ue(d,JSON.stringify(s,null,2),"utf8"),{name:o,path:d}},"writeArtifact"),writeScriptSnapshot:i(o=>{let s=J(e,"script.js");if(ue(s,o.source,"utf8"),!o.manifest)return{scriptPath:s};let d=J(e,"manifest.json");return ue(d,`${JSON.stringify(o.manifest,null,2)}
|
|
21
|
+
`,"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(w=>w.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(J(e,"run.json"),`${JSON.stringify(d,null,2)}
|
|
22
|
+
`,"utf8")},"writeRunJson")}}i(Nt,"createRunGraphWriter");import{execFile as ur}from"node:child_process";import{promisify as lr}from"node:util";import{statSync as fr}from"node:fs";import{join as mr}from"node:path";var pr=lr(ur);function qe(e){return mr(e,"worktrees")}i(qe,"workflowWorktreeBaseDir");var wr=360*60*1e3;function jt(e,t){return pr("git",[...e],{cwd:t,windowsHide:!0}).then(n=>n.stdout)}i(jt,"defaultRunGit");function gr(e){return fr(e).mtimeMs}i(gr,"defaultMtimeMs");function hr(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(hr,"parseWorktreeList");function Dt(e){return e.replace(/\\/g,"/").replace(/\/+$/,"")}i(Dt,"normalize");function Ut(e,t){let n=Dt(e),r=Dt(t);return n===r||n.startsWith(`${r}/`)}i(Ut,"isUnder");async function yr(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(yr,"worktreeHasChanges");async function Vt(e,t,n,r,a){if(await yr(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(Vt,"removeWorktree");async function Bt(e,t,n){try{let r=await t(["worktree","list","--porcelain"],e);return hr(r)}catch(r){n.push(`list worktrees: ${r instanceof Error?r.message:String(r)}`);return}}i(Bt,"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 Ht(e,t={}){let n=[],r=[];if(!e.gitRoot)return{removed:r,warnings:n};let a=t.runGit??jt,o=await Bt(e.gitRoot,a,n);if(!o)return{removed:r,warnings:n};for(let s of o)Ut(s.path,e.baseDir)&&await Vt(s,e.gitRoot,a,r,n);return r.length>0&&await Oe(e.gitRoot,a,n),{removed:r,warnings:n}}i(Ht,"sweepWorkflowRunWorktrees");async function Kt(e,t={}){let n=[],r=[];if(!e.gitRoot)return{removed:r,warnings:n};let a=t.runGit??jt,o=t.mtimeMs??gr,s=t.now??(()=>Date.now()),d=e.maxAgeMs??wr;await Oe(e.gitRoot,a,n);let w=await Bt(e.gitRoot,a,n);if(!w)return{removed:r,warnings:n};for(let h of w){if(!Ut(h.path,e.workflowRunsRoot))continue;let y;try{y=s()-o(h.path)}catch{continue}y>=d&&await Vt(h,e.gitRoot,a,r,n)}return r.length>0&&await Oe(e.gitRoot,a,n),{removed:r,warnings:n}}i(Kt,"pruneStaleWorkflowWorktrees");var xr=200,Lt={maxAgents:64,tokenBudget:2e5};function Sr(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(Sr,"buildApprovalSummary");function Ce(e,t){if(e!==void 0)return!Number.isInteger(e)||e<=0?1:Math.min(e,t)}i(Ce,"clampLimit");function Rr(e,t,n){let r=Ce(e,n),a=Ce(t,n);return r===void 0?a:a===void 0?r:Math.min(r,a)}i(Rr,"clampEffectiveLimit");function zt(e,t){if(!(e==null||!Number.isFinite(e)||e<=0))return Math.min(Math.floor(e),t)}i(zt,"clampTokenBudget");function br(e,t,n){let r=zt(e,n),a=zt(t,n);return r===void 0?a:a===void 0?r:Math.min(r,a)}i(br,"clampEffectiveTokenBudget");function le(e,t){let n=Rr(e.maxAgents,t?.maxAgents,Lt.maxAgents),r=Ne(),a=[e.maxConcurrency,t?.maxConcurrency].map(d=>Ce(d,r)).filter(d=>d!==void 0),o=a.length===0?r:Math.min(r,...a),s=br(e.tokenBudget,t?.tokenBudget,Lt.tokenBudget);return{...n!==void 0?{maxAgents:n}:{},...o!==void 0?{maxConcurrency:o}:{},...s!==void 0?{tokenBudget:s}:{}}}i(le,"clampWorkflowLimits");function $e(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($e,"workflowResultSummary");async function _e(e){let t=le(e.module.meta,e.hostPolicy),n=Sr(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:vr(e.runDir),gitRoot:a},{now:r,...e.worktreeSweepDeps});let o=Nt(e.runDir,{now:r}),s=e.resumeFromRunDir!==void 0?kr(e.resumeFromRunDir):void 0,d=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,w=e.scriptSnapshot?o.writeScriptSnapshot(e.scriptSnapshot):void 0,h=e.backend??Tr(e),g={...e.beforeSpawn?Ir(h,e.beforeSpawn):h,writeArtifact:i(async(m,T)=>o.writeArtifact(m,T),"writeArtifact")},b=r(),v;try{v=await Ve({runId:e.runId,args:e.args,backend:g,limits:t,...e.signal?{signal:e.signal}:{},summarizeResult:$e,resolveWorkflowModule:Wt(a??process.cwd()),resultCache:$t(e.runDir,e.resumeFromRunDir?{readFrom:e.resumeFromRunDir}:{}),onEvent:i(m=>{o.onEvent(m),d&&e.onWorkflowProcessEvent?.(d.applyEvent(m)),e.onEvent?.(m)},"onEvent")},m=>e.module.run(m,e.args))}finally{await Ht({baseDir:qe(e.runDir),gitRoot:a},{now:r,...e.worktreeSweepDeps})}let W=v.ok?$e(v.result):void 0;return o.writeRunJson({meta:e.module.meta,args:e.args,state:v.state,startedAt:b,endedAt:r(),...w?{scriptSnapshot:w}:{},...W!==void 0?{resultSummary:W}:{},...e.processMetadata!==void 0||s!==void 0?{processMetadata:{...e.processMetadata,...s!==void 0?{resumedFromRunId:s}:{}}}:{}}),v.ok?{kind:"completed",result:v.result,state:v.state}:{kind:"failed",error:v.error,state:v.state}}i(_e,"runWorkflowModule");function Tr(e){if(!e.ctx||!e.childOptions)throw new Error("runWorkflowModule requires either a backend or ctx + childOptions");return ct({ctx:e.ctx,childOptions:e.childOptions,runId:e.runId,defaultChildReadOnly:e.module.meta.readOnly===!0,kodaxAuthored:e.processMetadata?.hostMetadata?.workflowAuthorship==="kodax-generated"})}i(Tr,"buildBackend");function Ir(e,t){return{...e,spawn:i(async n=>(await t(),e.spawn(n)),"spawn")}}i(Ir,"withBeforeSpawn");function Pr(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(Pr,"emitWorkflowAgentDigest");async function Xt(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 Ze({maxConcurrentThreadsPerSession:e.options.maxConcurrentThreadsPerSession}),a=r?{...e.options,context:{...e.options.context,actorSession:r}}:e.options,o=Qe({options:a,runtime:a.extensionRuntime,managedProtocolPayloadRef:{current:void 0}}),s=o.actorControl,d=o.actorHost;if(!s||!d)throw new Error("Workflow execution requires the Runtime-owned Actor control plane.");let w=await d.createWorkflowOwner(s.callerPath,e.runId),h=d.workflowOwnerSignal(w.callerPath),y=Ar(e.signal,h);o.actorControl=w,o.actorHost=d;let g={...a,context:{...a.context,actorControl:w,actorHost:d}};Object.assign(o,{workflowWorktreeBaseDir:qe(e.runDir)});let b={maxIterationsPerChild:xr,...g.session?.storage!==void 0?{historyStorage:g.session.storage}:{},parentRole:"worker",parentHarness:"tool-dispatch",parentOptions:{provider:g.provider,model:g.modelOverride??g.model,effort:g.effort,reasoningMode:g.reasoningMode,repoIntelligenceMode:g.context?.repoIntelligenceMode,repoIntelligenceTrace:g.context?.repoIntelligenceTrace,compaction:g.compaction,contextDiagnostics:g.context?.contextDiagnostics,disablePromptCache:g.disablePromptCache,extensionRuntime:g.extensionRuntime,events:g.events},...e.options.guardrails?{guardrails:e.options.guardrails}:{},...o.planModeBlockCheck?{planModeBlockCheck:o.planModeBlockCheck}:{}},v=e.onWorkflowProcessEvent||e.options.events?.onWorkflowProcessEvent?m=>{e.onWorkflowProcessEvent?.(m),g.events?.onWorkflowProcessEvent?.(m)}:void 0,W=e.onEvent||g.events?.onWorkflowAgentDigest?m=>{e.onEvent?.(m),Pr(g.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:b,...e.approval?{approval:e.approval}:{},signal:y,...W?{onEvent:W}:{},...v?{onWorkflowProcessEvent:v}:{},...g.workflowHostPolicy?{hostPolicy:g.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}:{}}),T=Mr(e.runId,m);return await d.settleWorkflowOwner(w.callerPath,Jt(T),{output:JSON.stringify(T),structured:Gt(T),artifacts:T.artifacts.map($=>$.path??$.name).filter(Boolean),...m.kind==="failed"?{error:m.error.message}:{}}),m}catch(m){let T=m instanceof Error?m:new Error(String(m)),$=re({state:{runId:e.runId,status:h.aborted?"stopped":"failed",totalSpawned:0,results:[],events:[],artifacts:[]},error:T});try{await d.settleWorkflowOwner(w.callerPath,Jt($),{output:JSON.stringify($),structured:Gt($),error:T.message})}catch(G){throw new AggregateError([T,G],"Workflow execution and owner settlement failed.")}throw T}finally{await r?.close("workflow run finished")}}i(Xt,"runWorkflowFromOptions");function Mr(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:$e(t.result)}:{error:t.error}})}i(Mr,"workflowProtocolOutcome");function Jt(e){return e.status==="failed"?"failed":e.status==="interrupted"?"interrupted":"completed"}i(Jt,"protocolOwnerState");function Ar(e,t){return e?AbortSignal.any([e,t]):t}i(Ar,"combineAbortSignals");function Gt(e){return JSON.parse(JSON.stringify(e))}i(Gt,"toAgentMetadata");function Er(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(Er,"resultText");function Wr(e){if(e.kind==="completed"){let t=Er(e.result);return t!==void 0?{status:"completed",resultText:t}:{status:"completed"}}return e.kind==="denied"?{status:"denied"}:{status:"failed",error:e.error}}i(Wr,"classifyOutcome");function Fr(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(Fr,"failedOutcome");var Or=1e3;function qr(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>Or){let h=new Set(t.list().map(y=>y.runId));for(let y of n.keys())y!==o.runId&&!h.has(y)&&n.delete(y)}let d=le(o.meta,o.hostPolicy),w=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:Wr,onError:i(h=>Fr(o.runId,h),"onError")});return{runId:w.runId,done:w.done,getSnapshot:i(()=>r(w.getSnapshot()),"getSnapshot"),getProcessSnapshot:i(()=>w.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(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(qr,"createWorkflowRunManager");var Yt;function ni(){return Yt??=qr({},He()),Yt}i(ni,"getDefaultWorkflowRunManager");export{ct as a,dt as b,Se as c,Re as d,ft as e,mt as f,pt as g,qn as h,Cn as i,$n as j,ht as k,kt as l,vt as m,no as n,te as o,zn as p,We as q,Mt as r,Gn as s,uo as t,lo as u,fo as v,mo as w,po as x,wo as y,_t as z,dr as A,Nt as B,Lt as C,Sr as D,le as E,_e as F,Pr as G,Xt as H,qr as I,ni as J};
|