@kodax-ai/kodax 0.7.78 → 0.7.80
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 +3556 -3197
- package/README.md +371 -277
- package/README_CN.md +295 -215
- package/config-templates/config.example.jsonc +24 -2
- package/config-templates/integrations/a2a.example.jsonc +23 -7
- package/dist/builtin/skill-creator/scripts/aggregate-benchmark.js +2 -1
- package/dist/builtin/skill-creator/scripts/analyze-benchmark.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/analyze-benchmark.js +4 -3
- package/dist/builtin/skill-creator/scripts/compare-runs.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/compare-runs.js +4 -3
- package/dist/builtin/skill-creator/scripts/generate-review.js +2 -1
- package/dist/builtin/skill-creator/scripts/grade-evals.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/grade-evals.js +4 -3
- package/dist/builtin/skill-creator/scripts/improve-description.js +2 -1
- package/dist/builtin/skill-creator/scripts/init-skill.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/init-skill.js +4 -3
- package/dist/builtin/skill-creator/scripts/install-skill.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/install-skill.js +4 -3
- package/dist/builtin/skill-creator/scripts/package-skill.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/package-skill.js +4 -3
- package/dist/builtin/skill-creator/scripts/quick-validate.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/quick-validate.js +4 -3
- package/dist/builtin/skill-creator/scripts/run-eval.d.ts +1 -0
- package/dist/builtin/skill-creator/scripts/run-eval.js +4 -3
- package/dist/builtin/skill-creator/scripts/run-loop.js +2 -1
- package/dist/builtin/skill-creator/scripts/run-trigger-eval.js +2 -1
- package/dist/builtin/skill-creator/scripts/utils.d.ts +3 -0
- package/dist/builtin/skill-creator/scripts/utils.js +5 -1
- package/dist/chunks/agent-5PHGNFW3.js +2 -0
- package/dist/chunks/argument-completer-FXRZFMTC.js +2 -0
- package/dist/chunks/chunk-6UENDY33.js +89 -0
- package/dist/chunks/{chunk-6FOJVETH.js → chunk-BWX4YZX3.js} +7 -7
- package/dist/chunks/chunk-CDCCTM5I.js +278 -0
- package/dist/chunks/chunk-CEB5FDND.js +810 -0
- package/dist/chunks/{chunk-2CFHBKRE.js → chunk-E7C4DRD2.js} +2 -2
- package/dist/chunks/chunk-EVXIJPZ6.js +218 -0
- package/dist/chunks/chunk-FQ7NVMSU.js +319 -0
- package/dist/chunks/chunk-GC4JBMBS.js +385 -0
- package/dist/chunks/{chunk-Z3KFRTSB.js → chunk-HTVLCHWH.js} +1 -1
- package/dist/chunks/chunk-IHPH3444.js +655 -0
- package/dist/chunks/{chunk-YAZQTC2L.js → chunk-KHEFUT6O.js} +1 -1
- package/dist/chunks/{chunk-7OEBJGHK.js → chunk-PMKAG4SZ.js} +1 -1
- package/dist/chunks/chunk-RPF5RGWZ.js +479 -0
- package/dist/chunks/{chunk-UID7BLAB.js → chunk-RXXKDR6Y.js} +1 -1
- package/dist/chunks/chunk-T5U4OP2N.js +292 -0
- package/dist/chunks/chunk-TRNAWSXP.js +123 -0
- package/dist/chunks/chunk-UZSHBQER.js +30 -0
- package/dist/chunks/{chunk-TQDBTTIM.js → chunk-VECRQTSD.js} +44 -44
- package/dist/chunks/compaction-config-6J6XCBJS.js +2 -0
- package/dist/chunks/{construction-bootstrap-VQLQGWPY.js → construction-bootstrap-KPCAE3VN.js} +1 -1
- package/dist/chunks/dist-RWEVZOFK.js +2 -0
- package/dist/chunks/{dist-BFT5YIGU.js → dist-WWL2DNIJ.js} +1 -1
- package/dist/chunks/host-OGS2R5J4.js +2 -0
- package/dist/chunks/run-manager-2YMM3BOT.js +2 -0
- package/dist/chunks/{utils-SID4HW2Q.js → utils-2YHRUZYC.js} +1 -1
- package/dist/index.d.ts +21 -20
- package/dist/index.js +4 -4
- package/dist/kodax_bootstrap.js +2 -1
- package/dist/kodax_cli.js +1850 -1476
- package/dist/kodax_resume.js +570 -34
- package/dist/provider-capabilities.json +85 -50
- package/dist/runtime-worker.js +1737 -1369
- package/dist/sandbox-workspace-session.js +285 -19
- package/dist/sdk-a2a.d.ts +19 -13
- package/dist/sdk-a2a.js +8 -8
- package/dist/sdk-agent.d.ts +80 -150
- package/dist/sdk-agent.js +1 -1
- package/dist/sdk-coding.d.ts +186 -66
- package/dist/sdk-coding.js +1 -1
- package/dist/sdk-experimental-memory.d.ts +3 -3
- package/dist/sdk-experimental-memory.js +1 -1
- package/dist/sdk-llm.d.ts +7 -7
- package/dist/sdk-llm.js +1 -1
- package/dist/sdk-mcp.d.ts +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 +31 -213
- package/dist/sdk-repl.js +2 -2
- package/dist/sdk-runtime.d.ts +230 -31
- package/dist/sdk-runtime.js +1 -1
- package/dist/sdk-sandbox.js +1 -1
- package/dist/sdk-session.d.ts +8 -8
- package/dist/sdk-session.js +1 -1
- package/dist/sdk-skills.js +1 -1
- package/dist/semantic-worker.js +283 -18
- package/dist/types-chunks/{base.d-4e74xDdy.d.ts → base.d-DxG0m09Z.d.ts} +1 -1
- package/dist/types-chunks/{bash-prefix-extractor.d-uAe2Oqda.d.ts → bash-prefix-extractor.d-DStqKIlu.d.ts} +31 -8
- package/dist/types-chunks/{capability-learning.d-CVsdHw4j.d.ts → capability-learning.d-iPSiAmc_.d.ts} +1 -1
- package/dist/types-chunks/{capsule.d-BlSv9l3V.d.ts → capsule.d-BuFJaYxA.d.ts} +14 -21
- package/dist/types-chunks/{types.d-BA-Jwpfs.d.ts → controller.d-C2aHqzHj.d.ts} +344 -11
- package/dist/types-chunks/{guardrail.d-CXDYRgZ3.d.ts → guardrail.d-DM-OK0m3.d.ts} +187 -116
- package/dist/types-chunks/{history-retrieval.d-DtCy7x64.d.ts → history-retrieval.d-DImTKgO6.d.ts} +16 -3
- package/dist/types-chunks/{oauth-login.d-Bgb4rdLN.d.ts → oauth-login.d-6i-vidxv.d.ts} +6 -2
- package/dist/types-chunks/{public-api.d-B3AohsxN.d.ts → public-api.d-CewTvUKV.d.ts} +335 -38
- package/dist/types-chunks/{repl.d-Ie_ZXb_U.d.ts → repl.d-DvXQtgr7.d.ts} +5 -5
- package/dist/types-chunks/{resolver.d-iAQ9ocLB.d.ts → resolver.d-C9IW4fmU.d.ts} +5 -2
- package/dist/types-chunks/{run-manager.d-D1twIhF9.d.ts → run-manager.d-C6ahvZqK.d.ts} +1 -1
- package/dist/types-chunks/{sdk-session-DB9KksIx.d.ts → sdk-session-C59RUrri.d.ts} +3 -3
- package/dist/types-chunks/shell-command-sets.d-Dp4UvPLL.d.ts +297 -0
- package/dist/types-chunks/{side-query.d-DTuLPcC5.d.ts → side-query.d-CP1LiRiH.d.ts} +8 -2
- package/dist/types-chunks/{types-D3g6XUQr.d.ts → types-Bf3Y3mW-.d.ts} +1 -1
- package/dist/types-chunks/{types.d-BH0ZkTGf.d.ts → types.d-BzpPDBPV.d.ts} +2 -2
- package/dist/types-chunks/{types.d-DIpZJKUl.d.ts → types.d-CgrXrFrq.d.ts} +16 -2
- package/dist/types-chunks/{types.d-DVDTIfB_.d.ts → types.d-yuJzE82x.d.ts} +4 -4
- package/dist/types-chunks/{utils.d-CVp6bFl9.d.ts → utils.d-BpACJmzt.d.ts} +24 -6
- package/docs/SDK_EMBEDDER_GUIDE.md +1148 -598
- package/package.json +6 -3
- package/dist/chunks/agent-ASP4MS3X.js +0 -2
- package/dist/chunks/argument-completer-JYQ7FX3W.js +0 -2
- package/dist/chunks/chunk-35PPHOQ2.js +0 -292
- package/dist/chunks/chunk-43QNNDHR.js +0 -29
- package/dist/chunks/chunk-5GO6FH7L.js +0 -458
- package/dist/chunks/chunk-5NDCSFOP.js +0 -78
- package/dist/chunks/chunk-6XM4B6K2.js +0 -48
- package/dist/chunks/chunk-6YZUE6NC.js +0 -240
- package/dist/chunks/chunk-KQLQYHWU.js +0 -386
- package/dist/chunks/chunk-NXO6GWSY.js +0 -46
- package/dist/chunks/chunk-T2XZTLYE.js +0 -316
- package/dist/chunks/chunk-VAT2QYXM.js +0 -765
- package/dist/chunks/chunk-YVRYHC4C.js +0 -655
- package/dist/chunks/compaction-config-BQSSIWK5.js +0 -2
- package/dist/chunks/dist-PCFE24YP.js +0 -2
- package/dist/chunks/host-UTFXCYYM.js +0 -2
- package/dist/chunks/run-manager-PJU3WIFJ.js +0 -2
- package/dist/types-chunks/guardrail.d-BRE_ErEj.d.ts +0 -156
|
@@ -0,0 +1,655 @@
|
|
|
1
|
+
// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
|
|
2
|
+
import{A as Be,C as cs,D as ds,E as us,F as Zn,I as Vo,K as fs,O as ms,Q as Yo,Y as Se,ba as ps,c as ts,d as rs,da as gs,ea as ws,f as ss,fa as hs,h as Yn,i as Jn,m as is,n as as,y as ls}from"./chunk-CDCCTM5I.js";import{a as ys}from"./chunk-PMKAG4SZ.js";import{Ba as Xn,Ga as po,Ha as Vn,ea as He,sb as Qr,ta as mo,tb as es,xb as os,ya as Xo,za as be,zb as ns}from"./chunk-RPF5RGWZ.js";import{Ta as Jr,Ua as Zr,Z as Gr}from"./chunk-VECRQTSD.js";import{i as Ko}from"./chunk-RXXKDR6Y.js";import{A as Yr,D as ke,J as Fe,m as Go,n as qo,o as je,q as uo,r as zo,s as qr,t as zr,v as Xr,w as zn,x as Vr,y as fo}from"./chunk-BWX4YZX3.js";import{$b as qn,Gb as jr,Ib as Fr,Jb as Hr,Mb as Gn,Na as Ho,S as Ur,Tc as Kr,Vc as ne,ac as Bo,dc as Br}from"./chunk-GC4JBMBS.js";import{C as Sr,Pa as Hn,Qa as Oe,Ra as Ne,ka as co,ma as jn,ya as Fn}from"./chunk-TRNAWSXP.js";import{Ac as Or,Fa as xr,Ga as Ar,Ha as Bn,Nd as Dr,hd as Ue,id as Nr,md as Kn,wd as Fo}from"./chunk-CEB5FDND.js";import{$a as ve,J as Ir,K as Tr,L as Pr,X as Uo,Z as jo,_ as Lr,a as Do,aa as Mr,ab as De,d as K,fb as _r,g as ue,h as _,i as oe,j as $r,lb as Wr,s as Rr,t as Er,y as Cr}from"./chunk-EVXIJPZ6.js";import{a as i}from"./chunk-ONUPGMER.js";import*as _n from"fs";import*as Wo from"path";import*as Tn from"fs";import In from"path";import s from"chalk";var Jo=["plan","accept-edits","auto","auto-in-project"];function _a(e){return e==="auto"||e==="auto-in-project"}i(_a,"isAutoMode");function zf(e,o){return _a(e)&&o==="llm"}i(zf,"isAutoLlmMode");function Wa(e){switch(e){case"plan":return"Plan";case"accept-edits":return"Edits";case"auto":case"auto-in-project":return"Auto"}}i(Wa,"permissionModeDisplayName");var Oa='[deprecated] permissionMode "auto-in-project" is now an alias for "auto" (FEATURE_092, v0.7.33). The alias will be removed in v0.7.38 \u2014 please update ~/.kodax/config.json to use "auto".';function Xf(e=o=>{K({source:"repl:permission",level:"warn",message:o})}){let o=!1;return()=>{o||(o=!0,e(Oa))}}i(Xf,"createAutoInProjectDeprecationEmitter");function Zo(e){switch(e){case"plan":return new Set(["bash","write","edit","undo"]);case"accept-edits":return new Set(["bash"]);case"auto":case"auto-in-project":return new Set}}i(Zo,"computeConfirmTools");function ks(e){return e!==void 0&&Jo.includes(e)}i(ks,"isPermissionMode");function go(e,o){return ks(e)?e:o}i(go,"normalizePermissionMode");import{createHash as Na,randomUUID as Da}from"node:crypto";import Ke from"node:fs";import bs from"node:path";var ho=class extends Error{static{i(this,"ProviderSetupConfigConflictError")}constructor(o){super(`KodaX configuration changed while setup was open: ${o}. Re-run \`kodax setup\`.`),this.name="ProviderSetupConfigConflictError"}},Ge=class extends Error{static{i(this,"ProviderSetupInvalidConfigError")}constructor(o,n){super(`KodaX configuration cannot be safely updated: ${o}. ${n}`),this.name="ProviderSetupInvalidConfigError"}},Es=/^[A-Za-z_][A-Za-z0-9_]*$/,Ua=new Set(["accesskey","apikey","accesstoken","auth","authorization","bearertoken","clientsecret","credential","key","password","privatekey","refreshtoken","secret","sig","signature","token","xapikey"]);function qe(){return Object.entries(co).filter(([,e])=>e.capabilityProfile.transport!=="cli-bridge").map(([e,o])=>({name:e,apiKeyEnv:o.apiKeyEnv,defaultModel:o.model,models:[...new Set(o.models?[o.model,...o.models.map(n=>n.id)]:[o.model])]})).sort((e,o)=>e.name===jn?-1:o.name===jn?1:e.name.localeCompare(o.name))}i(qe,"getProviderSetupCatalog");function Cs(e={}){let o=e.configPath??_("config.json"),n=e.catalog??qe(),t=e.environment??process.env,r=Qn(o);if(!r.config)return{status:"invalid-config",configPath:o,configRevision:r.revision,reason:r.error??"config.json is not a JSON object."};let a=Ps(r.config);if(a)return{status:"invalid-config",configPath:o,configRevision:r.revision,reason:a};let l=xs(e.explicitProvider);if(l){let d=Rs(r.config,l,n);return d&&(!d.requiresCredential||As(t,d.apiKeyEnv))?Ss(o,r.revision,l):$s(o,r.revision,l,d?.apiKeyEnv)}if(!r.exists)return{status:"needs-provider",configPath:o,configRevision:r.revision};let c=xs(r.config.provider);if(c){let d=Rs(r.config,c,n);return d?!d.requiresCredential||As(t,d.apiKeyEnv)?Ss(o,r.revision,c):$s(o,r.revision,c,d.apiKeyEnv):{status:"invalid-config",configPath:o,configRevision:r.revision,reason:`provider "${c}" is not a valid built-in or custom provider.`}}return{status:"needs-provider",configPath:o,configRevision:r.revision}}i(Cs,"inspectProviderSetupReadiness");function Is(e){let o=e.configPath??_("config.json"),n=e.catalog??qe();try{return ss(o,()=>{let t=Qn(o);if(!t.config)throw new Ge(o,t.error??"config.json is invalid JSON.");if(t.revision!==e.expectedRevision)throw new ho(o);ja(t.config,o);let r=Ha(e.choice,n,t.config),a={...t.config,provider:r.provider,model:r.model,...r.customProviders?{customProviders:r.customProviders}:{}};if(Qn(o).revision!==e.expectedRevision)throw new ho(o);return Ba(o,a),{provider:r.provider,model:r.model,apiKeyEnv:r.apiKeyEnv,configPath:o}})}catch(t){throw t instanceof rs?new ho(o):t}}i(Is,"persistProviderSetupChoice");function Ts(e){let n=(e.platform??process.platform)==="win32"?`Required next step: use this provider's API key as the value of the user environment variable "${e.apiKeyEnv}" in Windows Environment Variables.`:`Required next step: use this provider's API key as the value of the environment variable "${e.apiKeyEnv}" in your shell profile.`;return[`config.json stores the environment-variable name only: "${e.apiKeyEnv}"; it never stores the API key.`,n,"KodaX cannot set this environment variable for you.","Close and restart this terminal so the environment is refreshed.","Then run `kodax` again.","Optional: run `kodax doctor` to verify local configuration without an LLM request."]}i(Ts,"providerSetupRestartInstructions");function Ss(e,o,n){return{status:"ready",configPath:e,configRevision:o,...n?{provider:n}:{}}}i(Ss,"ready");function $s(e,o,n,t){return{status:"needs-credential",configPath:e,configRevision:o,provider:n,...t?{apiKeyEnv:t}:{}}}i($s,"needsCredential");function xs(e){return typeof e=="string"&&e.trim()?e.trim():void 0}i(xs,"normalizedString");function As(e,o){return o!==void 0&&!!e[o]?.trim()}i(As,"hasEnvironmentValue");function Rs(e,o,n){let t=n.find(l=>l.name===o);if(t)return{apiKeyEnv:t.apiKeyEnv,requiresCredential:!0};if(Object.entries(co).find(([l])=>l===o)?.[1]?.capabilityProfile.transport==="cli-bridge")return{requiresCredential:!1};let a=Fa(e,o);return a?{apiKeyEnv:a.apiKeyEnv,requiresCredential:!0}:void 0}i(Rs,"resolveConfiguredProvider");function ja(e,o){let n=Ps(e);if(n)throw new Ge(o,n)}i(ja,"assertCustomProvidersPreservable");function Ps(e){let o=e.customProviders;if(o===void 0)return;if(!Array.isArray(o))return"Existing customProviders must be an array; repair it before running setup.";let n=new Set;for(let t of o){let r=et(t);if(!r)return"Existing customProviders contains an invalid entry; repair it before running setup.";let a=Ls(r.baseUrl);if(a)return`Existing customProviders entry "${r.name}" is unsafe: ${a}`;if(n.has(r.name))return`Existing customProviders contains duplicate name "${r.name}"; repair it before running setup.`;n.add(r.name)}}i(Ps,"existingCustomProvidersError");function Fa(e,o){let n=e.customProviders;if(Array.isArray(n))for(let t of n){let r=et(t);if(r?.name===o)return r}}i(Fa,"findValidCustomProvider");function et(e){if(!Ms(e))return;let{name:o,protocol:n,baseUrl:t,apiKeyEnv:r,model:a}=e;if(typeof o!="string"||n!=="openai"&&n!=="anthropic"||typeof t!="string"||typeof r!="string"||typeof a!="string")return;let l={...e,name:o,protocol:n,baseUrl:t,apiKeyEnv:r,model:a};try{return Fn(l),Es.test(l.apiKeyEnv)?l:void 0}catch{return}}i(et,"toValidCustomProvider");function Ha(e,o,n){if(e.kind==="builtin"){let d=o.find(u=>u.name===e.provider);if(!d||!d.models.includes(e.model))throw new Error("Choose a supported built-in provider and model.");return{provider:d.name,model:e.model,apiKeyEnv:d.apiKeyEnv}}let t=ot(e.provider);if(o.some(d=>d.name===t.name))throw new Error(`Custom provider name "${t.name}" conflicts with a built-in provider.`);let r=n.customProviders,a=Array.isArray(r)?r.flatMap(d=>{let u=et(d);return u?[u]:[]}):[],c=a.find(d=>d.name===t.name)?a.map(d=>d.name===t.name?t:d):[...a,t];return{provider:t.name,model:t.model,apiKeyEnv:t.apiKeyEnv,customProviders:c}}i(Ha,"normalizeProviderSetupChoice");function ot(e){let o={name:e.name.trim(),protocol:e.protocol,baseUrl:e.baseUrl.trim(),apiKeyEnv:e.apiKeyEnv.trim(),model:e.model.trim()},n=Ls(o.baseUrl);if(n)throw new Error(n);if(Fn(o),!Es.test(o.apiKeyEnv))throw new Error("Custom provider API key environment variable name is invalid.");return o}i(ot,"validateProviderSetupCustomMetadata");function Ls(e){let o;try{o=new URL(e)}catch{return"Custom provider Base URL must be a valid absolute URL."}if(o.protocol!=="https:"&&o.protocol!=="http:")return"Custom provider Base URL must use http or https.";if(o.username||o.password)return"Custom provider Base URL must not contain credentials.";let n=[...o.searchParams.keys()].find(t=>Ua.has(t.toLowerCase().replace(/[-_.]/g,"")));return n===void 0?void 0:`Custom provider Base URL must not contain credential query parameter "${n}".`}i(Ls,"customProviderEndpointError");function Qn(e){if(!Ke.existsSync(e))return{configPath:e,revision:wo(void 0),exists:!1,config:{}};let o;try{o=Ke.readFileSync(e,"utf8")}catch(n){return{configPath:e,revision:wo(void 0),exists:!0,error:n instanceof Error?n.message:"config.json cannot be read."}}try{let n=JSON.parse(o);return Ms(n)?{configPath:e,revision:wo(o),exists:!0,config:n}:{configPath:e,revision:wo(o),exists:!0,error:"config.json must contain a JSON object."}}catch(n){return{configPath:e,revision:wo(o),exists:!0,error:n instanceof Error?n.message:"config.json is invalid JSON."}}}i(Qn,"readConfig");function wo(e){return Na("sha256").update(e??"<missing>","utf8").digest("hex")}i(wo,"revisionFor");function Ms(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}i(Ms,"isRecord");function Ba(e,o){let n=bs.dirname(e);Ke.mkdirSync(n,{recursive:!0});let t=bs.join(n,`.config.${process.pid}.${Da()}.tmp`);try{Ke.writeFileSync(t,`${JSON.stringify(o,null,2)}
|
|
3
|
+
`,{encoding:"utf8",mode:384}),Ke.renameSync(t,e)}catch(r){throw Ke.rmSync(t,{force:!0}),r}}i(Ba,"writeConfigAtomically");import{existsSync as _s,mkdirSync as Ka,readFileSync as Ws,writeFileSync as Ga}from"node:fs";import ze from"node:path";var qa={core:{},mcp:{version:1,servers:{}},extensions:{version:1,paths:[]},a2a:{version:2,agents:{}}},za=["core","mcp","extensions","a2a"];function nt(e,o){return o==="core"?ze.join(e,"config.json"):ze.join(e,"integrations",`${o}.json`)}i(nt,"activePath");function Xa(e,o){return o==="core"?ze.join(e,"config.example.jsonc"):ze.join(e,"integrations",`${o}.example.jsonc`)}i(Xa,"templatePath");function Va(e){let o=e.replaceAll("\\","/");return za.flatMap(n=>[{domain:n,kind:"active",path:nt(e,n),content:`${JSON.stringify(qa[n],null,2)}
|
|
4
|
+
`},{domain:n,kind:"template",path:Xa(e,n),content:ts(n).replaceAll("~/.kodax",o)}])}i(Va,"configFiles");function yo(e,o){if(e===null||typeof e!="object"||Array.isArray(e))throw new Error(`${o} must contain a JSON object.`);return e}i(yo,"requireRecord");function Ya(e,o){let n=yo(e,"A2A config"),t=Object.keys(n).find(a=>!["version","agents","server"].includes(a));if(t)throw new Error(`A2A config contains unknown field "${t}".`);if(n.version!==1&&n.version!==2)throw new Error("A2A config version must be 1 or 2.");let r=yo(n.agents,"A2A config agents");if(n.server!==void 0&&yo(n.server,"A2A config server"),o)o(e);else if(Object.keys(r).length>0||n.server!==void 0)throw new Error("A2A config contains active declarations that require the KodaX host validator.")}i(Ya,"validateA2ADocument");function Ja(e,o){let n=Ws(e.path,"utf8"),t;try{t=JSON.parse(n)}catch{throw new Error(`${e.domain} config is invalid JSON.`)}e.domain==="core"?yo(t,"Core config"):e.domain==="mcp"?Yn(t):e.domain==="extensions"?Jn(t):Ya(t,o)}i(Ja,"validateActiveFile");function Os(e,o){if(!_s(e.path))return{domain:e.domain,kind:e.kind,path:e.path,status:"missing"};if(e.kind==="template")return{domain:e.domain,kind:e.kind,path:e.path,status:"existing"};try{return Ja(e,o),{domain:e.domain,kind:e.kind,path:e.path,status:"existing"}}catch(n){return{domain:e.domain,kind:e.kind,path:e.path,status:"invalid",diagnostic:n instanceof Error?n.message:`${e.domain} config is invalid.`}}}i(Os,"existingFileResult");function Za(e){return e instanceof Error&&"code"in e&&e.code==="EEXIST"}i(Za,"isAlreadyExists");function Qa(e,o){Ka(ze.dirname(e.path),{recursive:!0,mode:448});try{return Ga(e.path,e.content,{encoding:"utf8",flag:"wx",mode:384}),{domain:e.domain,kind:e.kind,path:e.path,status:"created"}}catch(n){if(Za(n))return Os(e,o);throw n}}i(Qa,"createIfMissing");function el(e){let o=nt(e,"core");if(_s(o))try{let n=yo(JSON.parse(Ws(o,"utf8")),"Core config"),t=is(e);t.mcp.action==="create"&&Yn({version:1,servers:n.mcpServers}),t.extensions.action==="create"&&Jn({version:1,paths:n.extensions})}catch(n){return`Legacy integration configuration is invalid: ${n instanceof Error?n.message:"Legacy integration config is invalid."}`}}i(el,"legacyIntegrationDiagnostic");function Ns(e={}){let o=ze.resolve(e.configHome??ue()),n=Va(o),t=n.map(a=>Os(a,e.validateA2A));if(t.some(a=>a.status==="invalid"))return{configHome:o,files:t};let r=el(o);if(r){let a=nt(o,"core");return t=t.map(l=>l.path===a?{...l,status:"invalid",diagnostic:r}:l),{configHome:o,files:t}}return as({configHome:o}),{configHome:o,files:n.map(a=>Qa(a,e.validateA2A))}}i(Ns,"initializeSetupConfiguration");import $e from"node:path";var Ds=[{id:"interrupt",name:"Interrupt",description:"Interrupt the current streaming response",defaultBindings:[{key:"c",ctrl:!0}],context:"global",priority:200,category:"global",configurable:!1},{id:"showHelp",name:"Toggle Help",description:"Show or hide shortcut help when the input is empty",defaultBindings:[{key:"?"}],context:"global",priority:150,category:"global",configurable:!0},{id:"toggleThinking",name:"Cycle Reasoning Effort",description:"Cycle reasoning effort for the active model: off, low \u2026 max, auto",defaultBindings:[{key:"t",ctrl:!0}],context:"global",priority:150,category:"mode",configurable:!0},{id:"toggleTranscriptMode",name:"Toggle Transcript Mode",description:"Toggle transcript mode on or off",defaultBindings:[{key:"o",ctrl:!0}],context:"global",priority:150,category:"mode",configurable:!0},{id:"openTranscriptSearch",name:"Search Transcript",description:"Open transcript search",defaultBindings:[{key:"f",ctrl:!0}],context:"global",priority:150,category:"navigation",configurable:!0},{id:"togglePermissionMode",name:"Cycle Permissions",description:"Cycle permission mode: plan, accept-edits, auto-in-project",defaultBindings:[{key:"tab",shift:!0}],context:"global",priority:150,category:"mode",configurable:!0},{id:"toggleAgentMode",name:"Cycle Agent Mode",description:"Cycle agent mode: AMA, SA",defaultBindings:[{key:"m",meta:!0}],context:"global",priority:150,category:"mode",configurable:!0},{id:"submitInput",name:"Submit Input",description:"Submit the current input",defaultBindings:[{key:"enter"}],context:"input",priority:50,category:"global",configurable:!1},{id:"acceptCompletion",name:"Accept Completion",description:"Accept the current autocomplete suggestion",defaultBindings:[{key:"tab"}],context:"input",priority:60,category:"editing",configurable:!0},{id:"cancelInput",name:"Cancel Input",description:"Cancel or clear the current input",defaultBindings:[{key:"escape"}],context:"input",priority:70,category:"editing",configurable:!0},{id:"newline",name:"Insert Newline",description:"Insert a newline in the current input",defaultBindings:[{key:"enter",shift:!0},{key:"j",ctrl:!0}],context:"input",priority:40,category:"editing",configurable:!0},{id:"historyUp",name:"History Up",description:"Browse previous input history",defaultBindings:[{key:"up"}],context:"input",priority:30,category:"navigation",configurable:!0},{id:"historyDown",name:"History Down",description:"Browse next input history",defaultBindings:[{key:"down"}],context:"input",priority:30,category:"navigation",configurable:!0},{id:"moveLeft",name:"Move Left",description:"Move the cursor left",defaultBindings:[{key:"left"}],context:"input",priority:20,category:"navigation",configurable:!1},{id:"moveRight",name:"Move Right",description:"Move the cursor right",defaultBindings:[{key:"right"}],context:"input",priority:20,category:"navigation",configurable:!1},{id:"moveToStart",name:"Move To Start",description:"Move the cursor to the start of the line",defaultBindings:[{key:"a",ctrl:!0}],context:"input",priority:25,category:"navigation",configurable:!0},{id:"moveToEnd",name:"Move To End",description:"Move the cursor to the end of the line",defaultBindings:[{key:"e",ctrl:!0}],context:"input",priority:25,category:"navigation",configurable:!0},{id:"killLineRight",name:"Delete To End",description:"Delete from the cursor to the end of the current line",defaultBindings:[{key:"k",ctrl:!0}],context:"input",priority:25,category:"editing",configurable:!0},{id:"killLineLeft",name:"Delete To Start",description:"Delete from the start of the line to the cursor",defaultBindings:[{key:"u",ctrl:!0}],context:"input",priority:25,category:"editing",configurable:!0},{id:"deleteWordLeft",name:"Delete Word Left",description:"Delete the word before the cursor",defaultBindings:[{key:"w",ctrl:!0},{key:"backspace",meta:!0}],context:"input",priority:25,category:"editing",configurable:!0},{id:"moveLineUp",name:"Move Line Up",description:"Move to the previous visual line in multiline input",defaultBindings:[{key:"up",ctrl:!0}],context:"input",priority:20,category:"navigation",configurable:!0},{id:"moveLineDown",name:"Move Line Down",description:"Move to the next visual line in multiline input",defaultBindings:[{key:"down",ctrl:!0}],context:"input",priority:20,category:"navigation",configurable:!0},{id:"backspace",name:"Backspace",description:"Delete the previous character",defaultBindings:[{key:"backspace"}],context:"input",priority:10,category:"editing",configurable:!1},{id:"delete",name:"Delete",description:"Delete the next character",defaultBindings:[{key:"delete"}],context:"input",priority:10,category:"editing",configurable:!1}];function ol(e){let o=[];e.ctrl&&o.push("Ctrl"),e.meta&&o.push("Alt"),e.shift&&o.push("Shift");let n={tab:"Tab",escape:"Esc",enter:"Enter",backspace:"Backspace"};return o.push(n[e.key]??(e.key.length===1?e.key.toUpperCase():e.key)),o.join("+")}i(ol,"formatBinding");function tt(e){let n=Ds.find(t=>t.id===e)?.defaultBindings[0];return n?ol(n):"<unavailable>"}i(tt,"shortcut");function nl(){return Object.entries(co).filter(([,e])=>e.capabilityProfile.transport==="cli-bridge").map(([e])=>e).sort()}i(nl,"defaultCliBridges");function rt(e={}){let o=$e.resolve(e.configHome??ue()),n=e.catalog??qe(),t=e.cliBridges??nl(),r=n.map(a=>` ${a.name.padEnd(18)} ${a.apiKeyEnv} (default model: ${a.defaultModel})`);return["KodaX setup guide","","Configuration files (existing files are never overwritten by setup):",` Core: ${$e.join(o,"config.json")}`,` Annotated template: ${$e.join(o,"config.example.jsonc")}`,` MCP: ${$e.join(o,"integrations","mcp.json")}`,` Extensions: ${$e.join(o,"integrations","extensions.json")}`,` A2A: ${$e.join(o,"integrations","a2a.json")}`,` Integration templates: ${$e.join(o,"integrations","*.example.jsonc")}`," Existing active files are validated first. If one is invalid, setup reports"," it and stops without creating or overwriting any configuration file."," The annotated core template includes `sandbox.envPass` for exact command-target"," environment passthrough; setup never stores an environment-variable value.","","Built-in API providers and credential environment variables:",...r,...t.length>0?[` CLI bridges: ${t.join(", ")} (authenticate with the provider CLI; no KodaX API-key variable)`]:[],"","Set the variable named for your provider; keep the credential out of config.json:"," Custom providers: `apiKeyEnv` is the environment-variable name stored in config.json,"," never the API key value."," Put the provider's actual API key in the value of that exact environment variable."," KodaX does not set this environment variable for you."," Windows PowerShell (persistent user variable):",' [Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<your-key>", "User")'," macOS/Linux shell profile:",' export OPENAI_API_KEY="<your-key>"'," Obtain the key from the provider console, then close and restart the terminal."," Run `kodax doctor` to verify local configuration without sending an LLM request.","","Setup commands:"," kodax setup Initialize missing files and choose a built-in or custom provider"," kodax setup --custom Configure only a custom OpenAI/Anthropic-compatible provider"," kodax setup --help Show this guide without changing files","","Sandbox containment (optional; permission decisions still work when it is unavailable):"," `kodax setup`, first-run setup, and `/setup` check sandbox readiness once."," Windows: setup can launch the one-time UAC provisioning flow; the terminal itself"," does not need to run as Administrator. Declining UAC is non-fatal."," macOS: ASRT uses Seatbelt/sandbox-exec; install ripgrep with `brew install ripgrep`."," Linux: ASRT uses bubblewrap; install bubblewrap, socat, and ripgrep with apt,"," dnf, or pacman. KodaX never invokes sudo or a package manager automatically."," Ordinary startup and tool calls do not repeat setup reminders or trigger UAC."," Inspect/activate explicitly: `kodax sandbox doctor` / `kodax sandbox setup`."," Model-issued commands filter credential-shaped variables by default. Add exact names"," such as GH_TOKEN to user-level `sandbox.envPass` only when command access is intended."," The default list is empty; NODE_OPTIONS and BASH_ENV remain blocked."," Restart KodaX (and any persistent daemon) after changing the list or host variables."," SDK: `@kodax-ai/kodax/sandbox` exposes doctor, activation, capability metadata,"," and policy-controlled command execution independent of Auto[LLM].","","CLI basics:"," kodax Enter the interactive REPL",' kodax -p "task" Run one task and exit'," kodax -r Search and resume a saved session"," kodax -c Continue the most recent non-empty session","","Inside the REPL:"," /model [provider[/model]] List or switch provider/model"," /mode [plan|accept-edits|auto] Switch permission mode"," /effort [off|auto|low|medium|high|xhigh|max] Set reasoning depth"," /agent-mode [ama|sa|toggle] Switch AMA/SA execution"," /setup --help Show this guide","","Default shortcuts:",` ${tt("toggleThinking")} Cycle reasoning effort`,` ${tt("togglePermissionMode")} Cycle permission mode`,` ${tt("toggleAgentMode")} Cycle AMA/SA`," Tab Accept completion"," Esc Cancel or clear input"].join(`
|
|
5
|
+
`)}i(rt,"renderSetupGuide");import*as Us from"node:readline";import st from"chalk";async function js(e={}){let o=e.catalog??qe(),n=Cs({...e.configPath?{configPath:e.configPath}:{},catalog:o});if(n.status==="invalid-config")throw new Ge(n.configPath,n.reason);if(o.length===0)throw new Error("No built-in API providers are available for setup.");let t=e.interaction===void 0,r=e.interaction??il({input:e.input??process.stdin,output:e.output??process.stdout});try{let a=e.customOnly?"custom":await r.choose("Choose a provider. KodaX will save metadata only and will never ask for an API key.",[...o.map(u=>({value:`builtin:${u.name}`,label:`${u.name} \u2014 ${u.defaultModel} (set ${u.apiKeyEnv})`})),{value:"custom",label:"Custom OpenAI/Anthropic-compatible provider"},{value:"cancel",label:"Cancel"}]);if(!a||a==="cancel")return{status:"cancelled"};let l=a==="custom"?await rl(r):await tl(r,o,a.slice(8));if(!l)return{status:"cancelled"};let c=sl(l,o);return await r.confirm(`Save ${c}? config.json will store the environment-variable name only. You must set that variable to the provider's API key after setup. No credential value will be written.`)?{status:"configured",selection:Is({configPath:n.configPath,expectedRevision:n.configRevision,catalog:o,choice:l})}:{status:"cancelled"}}finally{t&&r.close?.()}}i(js,"runProviderSetupWizard");async function tl(e,o,n){let t=o.find(l=>l.name===n);if(!t)throw new Error(`Unknown setup provider: ${n}`);let r=[...new Set(t.models)],a=await e.choose(`Choose a model for ${t.name}.`,r.map(l=>({value:l,label:l===t.defaultModel?`${l} (default)`:l})));return a?{kind:"builtin",provider:t.name,model:a}:void 0}i(tl,"collectBuiltinChoice");async function rl(e){let o=await Qo(e,"Custom provider name (a unique local alias used by /model and config.json)");if(!o)return;let n=await e.choose("Protocol family (check the provider API documentation for OpenAI or Anthropic compatibility)",[{value:"openai",label:"OpenAI-compatible"},{value:"anthropic",label:"Anthropic-compatible"}]);if(n!=="openai"&&n!=="anthropic")return;let t=await Qo(e,"API Base URL from the provider documentation, for example https://example.com/v1");if(!t)return;let r=await Qo(e,["Environment-variable name only (for example MY_PROVIDER_API_KEY).","Do not paste an API key here.","config.json stores this name only.","After setup, set this environment variable's value to this provider's API key."].join(" "));if(!r)return;let a=await Qo(e,"Model identifier from the provider documentation, for example provider/model-name");if(a)return{kind:"custom",provider:ot({name:o,protocol:n,baseUrl:t,apiKeyEnv:r,model:a})}}i(rl,"collectCustomChoice");async function Qo(e,o){let t=(await e.text(o))?.trim();return t||void 0}i(Qo,"requiredText");function sl(e,o){if(e.kind==="custom"){let t=e.provider;return`provider=${t.name}, protocol=${t.protocol}, baseUrl=${t.baseUrl}, model=${t.model}, apiKeyEnv=${t.apiKeyEnv}`}let n=o.find(t=>t.name===e.provider);return`provider=${e.provider}, model=${e.model}, apiKeyEnv=${n?.apiKeyEnv??"<unknown>"}`}i(sl,"summarizeChoice");function il(e){let o=Us.createInterface({input:e.input,output:e.output}),n=!1;o.on("close",()=>{n=!0}),o.on("SIGINT",()=>o.close());let t=i(r=>new Promise((a,l)=>{let c=!1,d=i(f=>{c||(c=!0,o.removeListener("close",u),a(f))},"finish"),u=i(()=>d(void 0),"onClose");if(n){d(void 0);return}o.once("close",u);try{o.question(r,f=>d(f))}catch(f){o.removeListener("close",u),n?d(void 0):l(f)}}),"question");return{async choose(r,a){for(e.output.write(`
|
|
6
|
+
${st.cyan(r)}
|
|
7
|
+
`),a.forEach((l,c)=>e.output.write(` ${c+1}. ${l.label}
|
|
8
|
+
`));;){let l=await t(st.dim(`Select 1-${a.length} (q to cancel): `));if(l===void 0||l.trim().toLowerCase()==="q")return;let c=Number.parseInt(l.trim(),10)-1,d=a[c];if(d)return d.value;e.output.write(st.yellow(`Choose one of the numbered options.
|
|
9
|
+
`))}},async text(r,a){let l=a?` [${a}]`:"",c=await t(`${r}${l} (q to cancel): `);if(!(c===void 0||c.trim().toLowerCase()==="q"))return c.trim()||a},async confirm(r){return(await t(`${r} [y/N]: `))?.trim().toLowerCase()==="y"},close:i(()=>o.close(),"close")}}i(il,"createTerminalProviderSetupInteraction");async function Fs(e){let o=e.resolve(e.provider),n=[];for(let t of e.efforts){if(e.signal?.aborted)break;let r=!1;try{await o.stream([{role:"user",content:"ping"}],[],"",{effort:t},{modelOverride:e.model,maxOutputTokensOverride:1,onReasoningEffortRejected:i(()=>{r=!0},"onReasoningEffortRejected"),onTextDelta:i(()=>{},"onTextDelta")},e.signal)}catch(a){n.push({effort:t,status:"error",error:a instanceof Error?a.message:String(a)});continue}r?(Ar(e.provider,e.model,t,"probed",e.now()),n.push({effort:t,status:"rejected"})):n.push({effort:t,status:"accepted"})}return n}i(Fs,"probeProviderReasoningEfforts");import on from"fs";import Ys from"path";import at from"node:path";var ml=Zo("accept-edits");function pl(e,o,n){if(e.name==="bash"){let t=typeof e.input.command=="string"?e.input.command:"";return t.length>0&&mo(t)}if(He.has(e.name)){let t=typeof e.input.path=="string"?e.input.path:"";if(!t||!o)return!1;let r=at.isAbsolute(t)?at.resolve(t):at.resolve(n||o,t);return!be(r,o)}return!ml.has(e.name)}i(pl,"allowsAcceptEditsClassifierFallback");import en from"node:path";import ct from"node:os";function zs(){try{return ue()}catch{return}}i(zs,"safeGetAgentConfigHome");function lt(e,o){let n=process.platform==="win32"?/^(?:\$\{home\}|\$home|\$env:(?:home|userprofile)|%userprofile%)(?=$|[\\/])/i:/^(?:\$\{HOME\}|\$HOME)(?=$|[\\/])/;return $r(e.replace(n,ct.homedir()),o)}i(lt,"resolveShellWriteTarget");function qs(e,o){let n=zs();if(n&&oe(e,n))return"user-kodax";let t=en.join(en.resolve(o),".kodax");if(oe(e,t))return"project-kodax"}i(qs,"resolveProtectedZone");function gl(){let e=new Set;try{e.add(ct.tmpdir())}catch{}for(let o of["TEMP","TMP","TMPDIR"]){let n=process.env[o];n&&n.length>0&&e.add(n)}return Array.from(e)}i(gl,"getSystemTempDirs");var wl=new Set(["bash"]),hl={toolNames:wl,collect(e,o,n=o){let t=typeof e.input.command=="string"?e.input.command:"";if(!t||!o)return[];let r=[],a=new Set,l=new Set,c=gl(),d=en.resolve(o);for(let u of Xn(t)){let f;try{f=lt(u,n)}catch{continue}let m=qs(f,o);if(m){a.has(f)||(a.add(f),r.push({kind:"protected_path",path:u,zone:m}));continue}if(be(f,o)){let b=c.some(C=>oe(f,C)),S=oe(f,d);!b&&!S&&!l.has(f)&&(l.add(f),r.push({kind:"outside_project",path:u}))}}for(let u of po(t)){let f;try{f=lt(u,n)}catch{continue}qs(f,o)||oe(f,d)||c.some(S=>oe(f,S))||r.push({kind:"shell_redirect_outside",target:u})}return r}},np=i((e,o,n)=>{if(e.name!=="bash")return{denied:!1};let t=typeof e.input.command=="string"?e.input.command:"",r=new Set([en.join(ct.homedir(),".kodax")]),a=zs();a&&r.add(a);for(let l of Vn(t)){let c=lt(l,n);if([...r].some(d=>oe(c,d)))return{denied:!0,patternId:"user_kodax_write",reason:`Shell write to credential-zone path \`${l}\` (under ~/.kodax/) is permanently denied. KodaX config edits must use the \`kodax config\` CLI or SDK config API.`}}return{denied:!1}},"replBashUserKodaxWriteDeny");var nn=_("config.json");function Js(){return Ys.join(process.cwd(),".kodax","config.local.json")}i(Js,"getProjectConfigFile");function hp(e=process.env){let o=vo(nn);return yl({settings:o.autoMode,env:e})}i(hp,"loadAutoModeSettings");function yl(e={}){let o=e.settings??{},n=e.env??{},t=n.KODAX_AUTO_MODE_ENGINE?.trim(),r=t==="llm"||t==="rules"?t:void 0,a=o.engine==="llm"||o.engine==="rules"?o.engine:void 0,l=r??a??"llm",c=Vs(o.classifierModel),d=Vs(n.KODAX_AUTO_MODE_CLASSIFIER_MODEL),u=n.KODAX_AUTO_MODE_TIMEOUT_MS?.trim(),f=u!==void 0?Number(u):NaN,m=Number.isFinite(f)&&f>0?Math.floor(f):void 0,b=typeof o.timeoutMs=="number"&&o.timeoutMs>0?Math.floor(o.timeoutMs):void 0,S=Xs(n.KODAX_AUTO_SPECULATIVE_WINDOW_MS?.trim()),C=typeof o.speculativeWindowMs=="number"?Xs(String(o.speculativeWindowMs)):void 0;return{engine:l,classifierModel:c,classifierModelEnv:d,timeoutMs:m??b,speculativeWindowMs:S??C}}i(yl,"resolveAutoModeSettings");function Xs(e){if(e===void 0||e==="")return;let o=Number(e);if(Number.isFinite(o))return o<0?0:Math.floor(o)}i(Xs,"parseSpeculativeWindow");function Vs(e){if(typeof e!="string")return;let o=e.trim();return o.length===0?void 0:o}i(Vs,"nonEmptyString");function vo(e){try{if(on.existsSync(e))return JSON.parse(on.readFileSync(e,"utf-8"))}catch{}return{}}i(vo,"readJsonFile");function Zs(e,o){on.mkdirSync(Ys.dirname(e),{recursive:!0}),on.writeFileSync(e,JSON.stringify(o,null,2))}i(Zs,"writeJsonFile");function dt(e){let o=vo(nn);Zs(nn,{...o,permissionMode:e})}i(dt,"savePermissionModeUser");function yp(){let e=vo(nn),o=vo(Js()),n=e.alwaysAllowTools??[],t=o.alwaysAllowTools??[];return[...new Set([...n,...t])]}i(yp,"loadAlwaysAllowTools");function vp(e,o,n=!1){let t=Xo(e,o,n);if(!t)return;let r=Js(),a=vo(r),l=a.alwaysAllowTools??[];l.includes(t)||Zs(r,{...a,alwaysAllowTools:[...l,t]})}i(vp,"saveAlwaysAllowToolPattern");var ut=["ama","sa"];function Qs(e){let o=ut.indexOf(e);return ut[(o+1)%ut.length]??"ama"}i(Qs,"nextAgentMode");var fe=class{static{i(this,"CommandRegistry")}commands=new Map;aliases=new Map;register(o){let n=o.name.toLowerCase();if(this.commands.has(n))throw new Error(`Command "${o.name}" is already registered`);if(this.aliases.has(n)){let r=this.aliases.get(n);throw new Error(`Command "${o.name}" conflicts with existing alias for "${r}"`)}let t=new Set;for(let r of o.aliases??[]){let a=r.toLowerCase();if(a!==n){if(t.has(a))throw new Error(`Alias "${r}" is duplicated within command "${o.name}"`);if(this.commands.has(a))throw new Error(`Alias "${r}" conflicts with existing command "${a}"`);if(this.aliases.has(a)){let l=this.aliases.get(a);throw new Error(`Alias "${r}" is already registered for "${l}"`)}t.add(a)}}if(this.commands.set(n,{...o,source:o.source??"builtin"}),o.aliases)for(let r of o.aliases){let a=r.toLowerCase();a!==n&&this.aliases.set(a,n)}}unregister(o){let n=o.toLowerCase(),t=this.aliases.get(n)??n;if(!this.commands.has(t))return!1;let r=this.commands.get(t);if(r?.aliases)for(let a of r.aliases)this.aliases.delete(a.toLowerCase());return this.commands.delete(t),!0}get(o){let n=o.toLowerCase(),t=this.aliases.get(n)??n;return this.commands.get(t)}has(o){let n=o.toLowerCase(),t=this.aliases.get(n)??n;return this.commands.has(t)}getAll(o){let n=new Map;for(let[t,r]of this.commands)o&&r.source!==o||n.has(t)||n.set(t,{name:r.name,aliases:r.aliases,description:r.description,source:r.source??"builtin",usage:r.usage,priority:r.priority,location:r.location,path:r.path,userInvocable:r.userInvocable,disableModelInvocation:r.disableModelInvocation,allowedTools:r.allowedTools,context:r.context,agent:r.agent,argumentHint:r.argumentHint,model:r.model});return Array.from(n.values()).sort((t,r)=>t.name.localeCompare(r.name))}getBySource(o){return this.getAll(o)}getNames(){return Array.from(this.commands.keys()).sort()}clear(){this.commands.clear(),this.aliases.clear()}get size(){return this.commands.size}get aliasCount(){return this.aliases.size}},vl=new fe;function ft(e){return[`ready=${e.ready}`,`new=${e.newlyActive}`,`attention=${e.attention}`,`active=${e.active}`].join(" ")}i(ft,"formatLearningStatus");function Rp(e){if(e.ready+e.newlyActive+e.attention!==0)return`Learning recovery: ${ft(e)} [/learn]`}i(Rp,"formatLearningRecoverySummary");import G from"chalk";import{Buffer as ti}from"node:buffer";import{spawn as kl}from"node:child_process";import ei from"node:process";var xe="\x1B",bl="\x07",mt=`${xe}\\`;function oi(e,o){return e.SSH_CONNECTION?!1:o==="win32"||o==="darwin"||o==="linux"}i(oi,"shouldPreferNativeClipboard");function Sl(e,o){let n=ti.from(e,"utf8").toString("base64"),t=o.TERM==="xterm-kitty"?mt:bl,r=`${xe}]52;c;${n}${t}`;return o.TMUX?`${xe}Ptmux;${r.replaceAll(xe,`${xe}${xe}`)}${mt}`:o.STY?`${xe}P${r}${mt}`:r}i(Sl,"buildOscSequence");async function tn(e,o,n){return new Promise((t,r)=>{let a=kl(e,o,{stdio:["pipe","ignore","pipe"],windowsHide:!0}),l="";a.on("error",r),a.stderr?.on("data",c=>{l+=c.toString()}),a.on("close",c=>{if(c===0){t(!0);return}r(new Error(l.trim()||`${e} exited with code ${c??"unknown"}`))}),a.stdin?.write(n),a.stdin?.end()})}i(tn,"execClipboardCommand");function $l(e){let o="$stream = [Console]::OpenStandardInput(); $buffer = New-Object byte[] 8192; $memory = New-Object System.IO.MemoryStream; while (($read = $stream.Read($buffer, 0, $buffer.Length)) -gt 0) { $memory.Write($buffer, 0, $read) }; $text = [System.Text.Encoding]::UTF8.GetString($memory.ToArray()); Set-Clipboard -Value $text",n=ti.from(e,"utf8");return[["powershell",["-NoProfile","-NonInteractive","-Command",o],n],["pwsh",["-NoProfile","-NonInteractive","-Command",o],n],["cmd",["/c","chcp 65001 >nul & clip"],n]]}i($l,"buildWindowsClipboardCandidates");async function ni(e,o,n){if(o.SSH_CONNECTION)return!1;switch(n){case"win32":{let t=$l(e);for(let[r,a,l]of t)try{if(await tn(r,a,l))return!0}catch{}return!1}case"darwin":return tn("pbcopy",[],e);case"linux":{let t=[["wl-copy",[]],["xclip",["-selection","clipboard"]],["xsel",["--clipboard","--input"]]];for(let[r,a]of t)try{if(await tn(r,a,e))return!0}catch{}return!1}default:return!1}}i(ni,"tryNativeClipboard");async function xl(e,o){if(!o.TMUX)return!1;let n=o.LC_TERMINAL==="iTerm2"?["load-buffer","-"]:["load-buffer","-w","-"];try{return await tn("tmux",n,e)}catch{return!1}}i(xl,"tryTmuxClipboard");async function ri(e,o={}){let n=o.env??ei.env,t=o.platform??ei.platform,r=e.trimEnd(),a=Sl(r,n);if(!r)throw new Error("Nothing to copy.");if(oi(n,t))try{if(await ni(r,n,t))return{path:"native"}}catch{}if(await xl(r,n))return{path:"tmux-buffer"};if(o.terminalWrite?.(a))return{path:"osc52"};if(!oi(n,t))try{if(await ni(r,n,t))return{path:"native"}}catch{}throw new Error("Unable to access any clipboard path.")}i(ri,"copyTextToClipboard");var pt;(function(e){e.Idle="idle",e.Responding="responding",e.WaitingForConfirmation="waiting_for_confirmation"})(pt||(pt={}));var B;(function(e){e.Scheduled="scheduled",e.Validating="validating",e.AwaitingApproval="awaiting_approval",e.Executing="executing",e.Success="success",e.Error="error",e.Cancelled="cancelled"})(B||(B={}));var _p={[B.Scheduled]:"\u25CB",[B.Validating]:"\u25CC",[B.AwaitingApproval]:"?",[B.Executing]:"\u25CB",[B.Success]:"\u2713",[B.Error]:"\u2717",[B.Cancelled]:"-"},si;(function(e){e[e.Low=-100]="Low",e[e.Normal=0]="Normal",e[e.High=100]="High",e[e.Critical=200]="Critical"})(si||(si={}));var Wp={streamingState:pt.Idle,currentResponse:"",history:[],pendingToolCalls:[],sessionId:"",provider:"",model:"",isLoading:!1};var Al="[redacted]",ii="[truncated]";function te(e,o=2e3){return e.length>o?`${e.slice(0,o-3)}...`:e}i(te,"truncateToolReplayText");function Rl(e){let o=e.toLowerCase().replace(/[\s_-]/g,"");return o.includes("token")||o.includes("password")||o.includes("secret")||o.includes("apikey")||o.includes("accesstoken")||o==="authorization"||o==="cookie"||o==="setcookie"}i(Rl,"isSensitiveToolInputKey");function ai(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}i(ai,"isRecord");function gt(e,o=0,n=new WeakSet){if(e===null||typeof e=="number"||typeof e=="boolean")return e;if(typeof e=="string")return te(e);if(o>=6)return ii;if(typeof e=="object"&&e!==null){if(n.has(e))return ii;if(n.add(e),Array.isArray(e))return e.slice(0,50).map(r=>gt(r,o+1,n));if(!ai(e))return te(String(e));let t={};for(let[r,a]of Object.entries(e).slice(0,50))t[r]=Rl(r)?Al:gt(a,o+1,n);return t}return te(String(e))}i(gt,"sanitizeToolJsonValue");function li(e){if(!e)return;let o=gt(e);return ai(o)?o:void 0}i(li,"sanitizeToolInput");function ci(e){if(e!==void 0){if(typeof e=="string")return te(e);try{return te(JSON.stringify(e))}catch{return te(String(e))}}}i(ci,"stringifyToolReplayValue");function Fp(e){return e.type==="tool_summary"||e.type==="task_completed"?{type:"event",text:e.text,icon:"tool",...e.timestamp===void 0?{}:{timestamp:e.timestamp}}:e.type==="tool_group"?{type:"tool_group",tools:e.tools.map(_l),...e.timestamp===void 0?{}:{timestamp:e.timestamp}}:e}i(Fp,"seedToHistoryItem");var El="[Thinking]",Cl="[/Thinking]",Il="Untitled Session",di=50,Tl=60,fi="...",mi=["[Managed Task]","[Managed Task Protocol Retry]","Assigned native agent identity:","Tool policy:","Blocked tools:","Allowed shell patterns:","Dependency handoff artifacts:","Dependency summary preview:","Preferred agent:","Read structured bundle first:","Read human summary next:"],pi=[/(?:^|\n)You are the [^\n]+ role for a managed KodaX task\./,/(?:^|\n)Primary task:/,/(?:^|\n)Work intent:/,/(?:^|\n)Complexity:/,/(?:^|\n)Risk:/,/(?:^|\n)Harness:/,/(?:^|\n)Brainstorm required:/],Pl=/(^|\r?\n)\[Thinking\]\r?\n([\s\S]*?)\r?\n\[\/Thinking\](?=\r?\n|$)/g,Ll="Session ended before the tool completed.";function Ml(e){switch(e){case"success":return B.Success;case"error":return B.Error;case"cancelled":return B.Cancelled;case"awaiting_approval":return B.AwaitingApproval;default:return e}}i(Ml,"toolCallSeedToHistoryToolStatus");function _l(e){return{id:e.id,name:e.name,status:Ml(e.status),...e.input!==void 0?{input:e.input}:{},...e.preview!==void 0?{preview:e.preview}:{},...e.output!==void 0?{output:e.output}:{},...e.error!==void 0?{error:e.error}:{},startTime:e.startTime??Date.now(),...e.endTime!==void 0?{endTime:e.endTime}:{}}}i(_l,"toolCallSeedToHistoryToolCall");function Wl(e){let o=-1;for(let n of mi){let t=e.indexOf(n);t>=0&&(o===-1||t<o)&&(o=t)}for(let n of pi){let t=n.exec(e);t&&t.index>=0&&(o===-1||t.index<o)&&(o=t.index)}return o}i(Wl,"findControlPlaneCutIndex");function Ol(e){return mi.some(o=>e.includes(o))||pi.some(o=>o.test(e))}i(Ol,"hasControlPlaneSignal");function gi(e){let o=[];for(let n of e)n&&typeof n=="object"&&"type"in n&&n.type==="text"&&"text"in n&&o.push(String(n.text));return o}i(gi,"collectTextBlocks");function sn(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}i(sn,"isRecord");function Nl(e){if(typeof e=="string")return te(e);if(e===void 0)return"";try{return ci(e)??""}catch{return te(String(e))}}i(Nl,"toolResultContentToString");function Dl(e){let o=Nl(e.content),n=o.trimStart(),t=e.is_error===!0||n.startsWith("[Tool Error]")||n.startsWith("[Error]"),r=n.startsWith("[Cancelled]")||n.startsWith("[Blocked]");return t?{status:"error",error:o}:r?{status:"cancelled",error:o}:{status:"success",output:o}}i(Dl,"inferToolResultSeed");function Ul(e){let o=new Map;if(!e||e.role!=="user"||!Array.isArray(e.content))return o;for(let n of e.content)!sn(n)||n.type!=="tool_result"||typeof n.tool_use_id!="string"||o.set(n.tool_use_id,Dl(n));return o}i(Ul,"collectToolResultSeeds");function jl(e,o){if(e.type!=="tool_use"||typeof e.id!="string"||typeof e.name!="string")return;let n=o.get(e.id)??{status:"cancelled",error:Ll};return{id:e.id,name:e.name,status:n.status,...e.input!==void 0?{input:li(sn(e.input)?e.input:{})??{}}:{},...n.output!==void 0?{output:n.output}:{},...n.error!==void 0?{error:n.error}:{}}}i(jl,"buildToolCallSeed");function Fl(e){return typeof e=="string"?e:Array.isArray(e)?gi(e).join(`
|
|
10
|
+
`):""}i(Fl,"extractAssistantTextOnly");function bo(e,o,n){n.trim().length!==0&&e.push({type:o,text:n})}i(bo,"pushSeed");function ui(e){return e.replace(/^\n+/,"").replace(/\n+$/,"")}i(ui,"stripLegacyTagBoundaryNewlines");function Hl(e){let o=e.name,n=e.input;if(!n)return`\u26A1 ${o}`;let t=o==="bash"?ko(String(n.command??"")):o==="read"||o==="write"||o==="edit"?ko(String(n.file_path??n.path??"")):o==="grep"||o==="glob"?ko(String(n.pattern??"")):o==="web_search"||o==="web_fetch"?ko(String(n.query??n.url??"")):void 0;return t?`\u26A1 ${o}(${t})`:`\u26A1 ${o}`}i(Hl,"formatToolUseSummary");function ko(e,o=60){let n=e.replace(/\s+/g," ").trim();return n.length>o?`${n.slice(0,o)}...`:n}i(ko,"truncateToolHint");function Bl(e){if(!e.includes(El)||!e.includes(Cl))return e.trim().length>0?[{type:"assistant",text:e}]:[];let o=[],n=0;for(let t of e.matchAll(Pl)){let r=t.index??-1,a=t[1]??"",l=t[2]??"";if(r<0)continue;let c=r+a.length;bo(o,"assistant",ui(e.slice(n,c))),bo(o,"thinking",l),n=r+t[0].length}return bo(o,"assistant",ui(e.slice(n))),o.length===0?e.trim().length>0?[{type:"assistant",text:e}]:[]:o}i(Bl,"parseLegacyAssistantContent");function wi(e,o){if(typeof e=="string")return Bl(e);if(!Array.isArray(e))return[];let n=[],t=[],r=[],a=i(()=>{t.length!==0&&(bo(n,"assistant",t.join(`
|
|
11
|
+
`)),t.length=0)},"flushAssistantBuffer"),l=i(()=>{r.length!==0&&(n.push({type:"tool_group",tools:[...r]}),r.length=0)},"flushToolBuffer");for(let c of e)if(!(!sn(c)||typeof c.type!="string"))switch(c.type){case"text":l(),"text"in c&&t.push(String(c.text));break;case"thinking":a(),l(),"thinking"in c&&bo(n,"thinking",String(c.thinking));break;case"tool_use":if(a(),o){let d=jl(c,o);d&&r.push(d)}else if(typeof c.name=="string"){let d=Hl({name:c.name,...sn(c.input)?{input:c.input}:{}});d&&n.push({type:"tool_summary",text:d})}break;case"tool_result":case"redacted_thinking":break;default:break}return l(),a(),n}i(wi,"extractAssistantHistorySeeds");var Kl=["You are the Scout role","You are the Generator role","You are the Planner role","You are the Evaluator role"],Gl=/\r?\n?\`\`\`kodax[\w-]*[\s\S]*?\`\`\`\s*/g;function ql(e){return Kl.some(o=>e.includes(o))}i(ql,"isManagedWorkerPrompt");function hi(e){return e.replace(Gl,"").trim()}i(hi,"stripManagedProtocolBlocks");function zl(e){switch(e.role){case"assistant":return wi(e.content).flatMap(n=>{if(n.type!=="assistant")return[n];let t=hi(n.text);return t.length>0&&t.trim()!=="..."?[{...n,text:t}]:[]});case"user":{if(e._source==="sidecar-verifier"){let n=rn(e.content).trim();return n?[{type:"sidecar",text:n,verdict:"revise"}]:[]}if(e._source==="agent-completed"||e._source==="task-completed"){let n=rn(e.content).trim();return n?[{type:"task_completed",text:n}]:[]}if(e._synthetic)return[];let o=rn(e.content);return o.trim().length===0||ql(o)?[]:[{type:"user",text:o}]}case"system":return[];default:return[]}}i(zl,"extractHistorySeedsFromMessageWithoutTimestamp");function yi(e,o){if(o===void 0)return[...e];let n=Date.parse(o);return!Number.isFinite(n)||n<0?[...e]:e.map(t=>({...t,timestamp:n}))}i(yi,"withMessageTimestamp");function Xl(e){return yi(zl(e),e.timestamp)}i(Xl,"extractHistorySeedsFromMessage");function Hp(e){let o=[];for(let n=0;n<e.length;n+=1){let t=e[n];if(t){if(t.role==="assistant"){let r=Ul(e[n+1]),a=yi(wi(t.content,r),t.timestamp);o.push(...a.map(l=>l.type==="assistant"?{...l,text:hi(l.text)}:l).filter(l=>l.type!=="assistant"||l.text.length>0&&l.text.trim()!=="..."));continue}o.push(...Xl(t))}}return o}i(Hp,"extractHistorySeedsFromMessages");function rn(e){return typeof e=="string"?e:Array.isArray(e)?gi(e).join(`
|
|
12
|
+
`):""}i(rn,"extractTextContent");function Vl(e){let o=e.replace(/\s+/g," ").trim();return o?o.length>di?`${o.slice(0,di)}${fi}`:o:Il}i(Vl,"formatSessionTitle");function Yl(e){if(e.role!=="user")return!1;let o=e.content;return!Array.isArray(o)||o.length===0?!1:o.every(n=>!!n&&typeof n=="object"&&"type"in n&&n.type==="tool_result")}i(Yl,"isPureToolResultUserMessage");function wt(e){for(let o=e.length-1;o>=0;o--){let n=e[o];if(n){if(n.role==="assistant"){let t=Fl(n.content);return t&&t.trim()!=="..."?t:""}if(!Yl(n))return""}}return""}i(wt,"extractLastAssistantText");function Bp(e,o,n,t){let r=[wt(e),o.trim(),n?.trim()??"",t?.trim()??""];for(let a of r){let l=vi(a);if(l)return l}return""}i(Bp,"resolveCompletedAssistantText");function vi(e){let o=e.trim();if(!o||o==="...")return"";let n=Wl(o);return n===0?"":(n>0?o.slice(0,n):o).trim()}i(vi,"sanitizeUserFacingAssistantText");function Kp(e){let o=e.trim();return o.length>0&&vi(o).length===0&&Ol(o)}i(Kp,"isControlPlaneOnlyAssistantText");function Gp(e){let o=e.find(t=>t.role==="user"),n=o?rn(o.content):"";return Vl(n)}i(Gp,"extractTitle");function qp(e,o=Tl){let n=e.replace(/\n/g," "),t=n.length>o?fi:"";return n.slice(0,o)+t}i(qp,"formatMessagePreview");var ht={name:"copy",description:"Copy last assistant message to clipboard",usage:"/copy",handler:i(async(e,o)=>{let n=wt(o.messages);if(!n){console.log(G.yellow(`
|
|
13
|
+
No assistant message found to copy.`)),console.log(G.dim("The assistant needs to respond first before you can copy its message."));return}try{await ri(n);let t=n.length>50?n.slice(0,50)+"...":n;console.log(G.green(`
|
|
14
|
+
Copied to clipboard!`)),console.log(G.dim(`Preview: ${t}`))}catch(t){let r=t instanceof Error?t.message:String(t);console.log(G.red(`
|
|
15
|
+
Failed to copy to clipboard: ${r}`)),console.log(G.dim("You may need to check clipboard permissions or manually copy the message."))}},"handler"),detailedHelp:i(()=>{console.log(G.bold(`
|
|
16
|
+
/copy - Copy Last Assistant Message
|
|
17
|
+
`)),console.log("Usage:"),console.log(G.cyan(" /copy")+` - Copy the last assistant message to clipboard
|
|
18
|
+
`),console.log("Description:"),console.log(" This command copies the most recent assistant response to your system clipboard."),console.log(` Useful for quickly sharing or saving AI responses.
|
|
19
|
+
`),console.log("Examples:"),console.log(G.dim(" User: Explain how async/await works")),console.log(G.dim(" AI: [responds with explanation]")),console.log(G.cyan(" /copy")+G.dim(` - Copies the explanation to clipboard
|
|
20
|
+
`)),console.log("Notes:"),console.log(" - Only copies assistant messages, not user messages"),console.log(" - Works with both plain text and formatted responses"),console.log(" - Requires clipboard permissions on some systems")},"detailedHelp")};import y from"chalk";function Jl(e){return e.runtimeInfo?.workspaceRoot??e.runtimeInfo?.executionCwd??process.cwd()}i(Jl,"resolveCwd");function Zl(e){let o=e.proposal;switch(o.destination){case"skill_patch":case"skill_create":return`${o.userLabel} ${o.destination} ${o.skillName}`;case"workflow_handoff":return`${o.userLabel} ${o.suggestedAction} ${o.evidenceRunIds.join(",")}`;case"memdir_handoff":return`${o.userLabel} ${o.memoryKind}`;case"reasoning_handoff":return`${o.userLabel} ${o.title}`}}i(Zl,"proposalLabel");function w(e=""){process.stdout.write(`${e}
|
|
21
|
+
`)}i(w,"writeOutput");function Ql(e){for(let o of e)w(y.yellow(`[learn] ${o}`))}i(Ql,"printWarnings");function ki(e){w(y.yellow(`
|
|
22
|
+
Consumer impact:`)),w(y.dim(` action: ${e.action}`));let o=[["workflow capsules",e.workflowCapsules],["saved workflows",e.savedWorkflows],["constructed agents",e.constructedAgents],["prompt references",e.promptReferences]];for(let[n,t]of o)if(t.length!==0){w(y.dim(` ${n}:`));for(let r of t)w(y.dim(` - ${r}`))}}i(ki,"printConsumerImpact");async function ec(e){let o=jo(e),n=await Uo(o);return Ql(n.warnings),{storePath:o,store:n}}i(ec,"readStore");function oc(e,o){return e.find(n=>n.proposalId===o)}i(oc,"findProposal");function nc(e,o){let n=e.filter(t=>t.status==="pending");if(w(y.cyan(`
|
|
23
|
+
[learn] pending learning suggestions`)),w(y.dim(` ${o}`)),n.length===0){w(y.dim(` (none)
|
|
24
|
+
`));return}for(let t of n){let r=t.applyPlan?"apply-plan":"handoff";w(` ${y.cyan(t.proposalId)} ${y.dim(`[${r}]`)} ${Zl(t)}`)}w(y.dim(`
|
|
25
|
+
Use /learn diff <id>, /learn approve <id>, or /learn reject <id>.
|
|
26
|
+
`))}i(nc,"printPending");function tc(e){if(w(y.cyan(`
|
|
27
|
+
[learn] ${e.proposalId}`)),w(y.dim(` status: ${e.status}`)),w(y.dim(` kind : ${e.proposal.destination}`)),w(`
|
|
28
|
+
Proposal:`),w(JSON.stringify(e.proposal,null,2)),e.proposal.destination==="workflow_handoff"&&ki(e.proposal.consumerImpact),!e.applyPlan){w(y.dim(`
|
|
29
|
+
No F224 apply plan is attached. Approval records the handoff only.
|
|
30
|
+
`));return}w(`
|
|
31
|
+
Apply plan:`),w(y.dim(` kind : ${e.applyPlan.kind}`)),w(y.dim(` skillRoot: ${e.applyPlan.skillRoot}`));for(let o of e.applyPlan.changes)w(y.dim(` - ${o.kind} ${o.relativePath}`)),o.kind==="write"&&w(o.content);w()}i(tc,"printDiff");async function rc(e,o,n={}){let t=await Mr(e,o,n);switch(t.status){case"approved_already_applied":w(y.green(`
|
|
32
|
+
[learn] approved ${o.proposalId}; files already match the apply plan.`)),w(y.dim(` recovered a pending proposal without applying it again.
|
|
33
|
+
`));return;case"blocked_snapshot_conflict":w(y.red(`
|
|
34
|
+
[learn] refusing to reapply ${o.proposalId}; ${t.relativePath} changed after the last snapshot.`)),w(y.dim(` snapshot: ${t.snapshotPath}`)),w(y.dim(` Review the file manually, then reject or recreate the learning proposal.
|
|
35
|
+
`));return;case"approved_applied":w(y.green(`
|
|
36
|
+
[learn] approved and applied ${o.proposalId}.`)),w(y.dim(` changed: ${t.changedPaths.join(", ")||"(none)"}
|
|
37
|
+
`));return;case"blocked_missing_apply_plan":w(y.red(`
|
|
38
|
+
[learn] ${o.proposalId} has no skill apply plan; nothing was applied.
|
|
39
|
+
`));return;case"blocked_consumer_impact":w(y.yellow(`
|
|
40
|
+
[learn] ${o.proposalId} requires manual consumer-impact review before approval.`)),w(y.dim(` Run /learn diff ${o.proposalId}, then /learn approve ${o.proposalId} --ack-impact after review.
|
|
41
|
+
`)),ki(t.impact),w();return;case"approved_handoff":w(y.green(`
|
|
42
|
+
[learn] approved ${o.proposalId} as a downstream handoff.`)),w(y.dim(` F224 does not mutate workflow, memory, or reasoning carriers directly.
|
|
43
|
+
`));return;case"blocked_not_pending":w(y.dim(`
|
|
44
|
+
[learn] ${o.proposalId} is already ${t.reviewStatus}.
|
|
45
|
+
`));return}}i(rc,"approveProposal");function an(){w(y.cyan(`
|
|
46
|
+
/learn - Inspect and control learned capabilities`)),w(y.dim(" /learn Open the Learning Center")),w(y.dim(" /learn list [search] List learned capabilities")),w(y.dim(" /learn show <name|slug> Inspect a capability")),w(y.dim(" /learn trust|reject|disable|rollback <name|slug>")),w(y.dim(" /learn promote <name|slug|capability-id> [--scope user]")),w(y.dim(" /learn promote --help Explain formal user-catalog promotion")),w(y.dim(" Compatibility: pending, diff, approve and reject remain accepted.")),w(y.dim(` /learn help
|
|
47
|
+
`))}i(an,"printHelp");function me(e,o){return{...o===void 0?{}:{target:o},scope:"user",help:!1,error:e}}i(me,"invalidPromoteInvocation");function sc(e,o){let n="user",t=!1;for(let r=0;r<o.length;r+=1){let a=o[r];if(a==="--scope"){if(t)return me("duplicate --scope option",e);let c=o[r+1];if(!c)return me("missing value for --scope",e);n=c,t=!0,r+=1;continue}if(a.startsWith("--scope=")){if(t)return me("duplicate --scope option",e);if(n=a.slice(8),!n)return me("missing value for --scope",e);t=!0;continue}let l=a.startsWith("-")?`unknown promote option: ${a}`:`unexpected promote argument: ${a}`;return me(l,e)}return n!=="user"?me(`unsupported promote scope: ${n}; only user is supported`,e):{target:e,scope:"user",help:!1}}i(sc,"parsePromoteOptions");function bi(e){let o=e.slice(1);if(o.some(t=>t==="--help"||t==="-h")||o[0]?.toLowerCase()==="help")return{scope:"user",help:!0};let n=o[0];return n?n.startsWith("-")?me(`unknown promote option: ${n}`):sc(n,o.slice(1)):me("missing learned Skill name, slug, or capability ID")}i(bi,"parseLearnPromoteInvocation");function ln(){w(y.cyan(`
|
|
48
|
+
/learn promote - Move one learned Skill into the formal user catalog`)),w(y.bold(`
|
|
49
|
+
Usage:`)),w(y.dim(" /learn promote <name|slug|capability-id> [--scope user]")),w(y.dim(" /learn promote --help")),w(y.dim(" /help learn promote")),w(y.bold(`
|
|
50
|
+
What it does:`)),w(y.dim(" Promote is an explicit ownership transfer, not automatic canary activation.")),w(y.dim(" Automatic evidence: testing -> active_learned inside the project Learned Area.")),w(y.dim(" Explicit promote: reviewed ready or active_learned -> promoted_user.")),w(y.dim(" The exact fingerprinted revision is copied to the configured KodaX")),w(y.dim(" user Skill directory (normally ~/.kodax/skills/<slug>/SKILL.md).")),w(y.dim(" Promotion never overwrites different formal Skill content.")),w(y.bold(`
|
|
51
|
+
Before promoting:`)),w(y.dim(" Use /learn show <name|slug> to inspect the exact revision and lifecycle.")),w(y.dim(" The Learning Center offers this action for active_learned Skills.")),w(y.bold(`
|
|
52
|
+
Examples:`)),w(y.dim(" /learn promote normalize-release-notes")),w(y.dim(` /learn promote normalize-release-notes --scope user
|
|
53
|
+
`))}i(ln,"printPromoteHelp");async function ic(e,o){let n=o.learning;if(!n)return!1;let t=(e[0]??"").toLowerCase();if(t===""&&o.openLearningCenter)return await o.openLearningCenter(),!0;if(t===""||t==="list"||t==="pending"){let d=await n.list({search:e.slice(1).join(" ").trim()||void 0,...t==="pending"?{lifecycle:"ready"}:{},limit:200});w(y.cyan(`
|
|
54
|
+
[learn] Learning Center`)),d.items.length===0&&w(y.dim(" (none)"));let u=new Map;for(let f of d.items)u.set(f.slug,(u.get(f.slug)??0)+1);for(let f of d.items){let m=(u.get(f.slug)??0)>1?` ${y.dim(`id=${f.capabilityId}`)}`:"";w(` ${y.cyan(f.slug)}${m} ${y.dim(`[${f.carrier}/${f.lifecycle}]`)} ${f.displayName}`)}return w(),!0}let r=t==="promote"?bi(e):void 0,a=r?.target??e[1],l=a?await ac(n,a):void 0;if((t==="show"||t==="diff")&&l)return o.openLearningCenter?await o.openLearningCenter(l):w(`${JSON.stringify(await n.get(l),null,2)}
|
|
55
|
+
`),!0;if(!l)return!1;if(t==="trust"||t==="approve")await n.trust(l);else if(t==="reject")await n.reject(l);else if(t==="disable")await n.disable(l);else if(t==="rollback")await n.rollback(l);else if(t==="promote"){if(!r||r.help||r.error)return!1;await n.promote(l,r.scope)}else if(t==="review")await n.review(l);else return!1;let c=a??l;return w(t==="promote"?y.green(`
|
|
56
|
+
[learn] promoted ${c} to the formal user Skill catalog.
|
|
57
|
+
`):y.dim(`
|
|
58
|
+
[learn] ${t} accepted for ${c}.
|
|
59
|
+
`)),!0}i(ic,"runLearningCenterCommand");async function ac(e,o){try{return(await e.get(o)).capabilityId}catch(n){let r=(await e.list({limit:200})).items.find(a=>a.source.kind==="f224_proposal"&&a.source.proposalId===o);if(r)return r.capabilityId;throw n}}i(ac,"resolveLearningCapabilityId");var yt={name:"learn",description:"Inspect and control the Learning Center",usage:"/learn [list|show|review|trust|reject|disable|rollback|promote|help] [name|slug|capability-id] [--scope user]",argumentHint:"list | show <slug> | trust <slug> | disable <slug> | promote <slug> [--scope user] | help [promote]",handler:i(async(e,o,n)=>{let t=Jl(o),r=(e[0]??"pending").toLowerCase();if(r==="help"||r==="-h"||r==="--help"){e[1]?.toLowerCase()==="promote"?ln():an();return}if(r==="promote"){let u=bi(e);if(u.help){ln();return}if(u.error){w(y.yellow(`
|
|
60
|
+
[learn] ${u.error}.
|
|
61
|
+
`)),ln();return}}if(await ic(e,n))return;if(r==="promote"){w(y.yellow(`
|
|
62
|
+
[learn] Learning Center controls are unavailable in this runtime.
|
|
63
|
+
`));return}let{storePath:a,store:l}=await ec(t);if(r==="pending"||r==="list"){nc(l.proposals,a);return}let c=e[1];if(!c){w(y.yellow(`
|
|
64
|
+
[learn] missing proposal id for ${r}.
|
|
65
|
+
`)),an();return}let d=oc(l.proposals,c);if(!d){w(y.yellow(`
|
|
66
|
+
[learn] proposal not found: ${c}
|
|
67
|
+
`));return}if(r==="diff"){tc(d);return}if(r==="approve"){if(l.warnings.length>0){w(y.red(`
|
|
68
|
+
[learn] refusing to mutate a corrupt learning store.
|
|
69
|
+
`));return}if(d.status!=="pending"){w(y.dim(`
|
|
70
|
+
[learn] ${d.proposalId} is already ${d.status}.
|
|
71
|
+
`));return}let u=new Set(e.slice(2));await rc(a,d,{acknowledgeImpact:u.has("--ack-impact")});return}if(r==="reject"){if(l.warnings.length>0){w(y.red(`
|
|
72
|
+
[learn] refusing to mutate a corrupt learning store.
|
|
73
|
+
`));return}if(d.status!=="pending"){w(y.dim(`
|
|
74
|
+
[learn] ${d.proposalId} is already ${d.status}.
|
|
75
|
+
`));return}let u=e.slice(2).join(" ").trim();await Lr(a,c,"rejected",u.length>0?{rejectedReason:u}:{}),w(y.dim(`
|
|
76
|
+
[learn] rejected ${c}.
|
|
77
|
+
`));return}w(y.yellow(`
|
|
78
|
+
[learn] unknown subcommand: ${r}
|
|
79
|
+
`)),an()},"handler"),detailedHelp:i((e=[])=>{e[0]?.toLowerCase()==="promote"?ln():an()},"detailedHelp")};import*as Y from"node:fs";import*as dn from"node:path";import p from"chalk";var xi=900*1e3,Ae=new Map;function Si(e){return e instanceof Error?e.message:String(e)}i(Si,"formatMemoryError");function lc(e){return e.runtimeInfo?.workspaceRoot??e.runtimeInfo?.executionCwd??process.cwd()}i(lc,"resolveCwd");function Ai(e){let o;try{o=Y.readdirSync(e,{withFileTypes:!0})}catch(t){return t.code!=="ENOENT"&&console.log(p.red(`[memory] failed to read memory directory ${e}: ${Si(t)}`)),[]}let n=[];for(let t of o){if(!t.isFile()||!t.name.endsWith(".md")||t.name==="MEMORY.md")continue;let r=dn.join(e,t.name),a="",l=0;try{a=Y.readFileSync(r,"utf-8"),l=Y.statSync(r).mtimeMs}catch(m){console.log(p.red(`[memory] failed to read ${r}: ${Si(m)}`));continue}let d=Cr(a).frontmatter,u=d.name!==void 0||d.description!==void 0||d.type!==void 0,f=dn.basename(t.name,".md");n.push({filename:t.name,absPath:r,mtimeMs:l,title:d.name?.trim()||f,description:d.description?.trim()||f,type:d.type,parseOk:u})}return n}i(Ai,"readTopicFiles");function cc(e){return e.map(o=>`- [${o.title}](${o.filename}) \u2014 ${o.description}`)}i(cc,"buildIndexLines");async function dc(e,o){console.log(p.cyan(`
|
|
80
|
+
[memory] per-project memory directory`)),console.log(p.dim(` ${e}`));let n=Ai(e),t=n.filter(l=>!l.parseOk);console.log(p.dim(` ${n.length} topic file${n.length===1?"":"s"}`+(t.length>0?`, ${t.length} without parsable frontmatter`:"")));let r=!1,a="";try{a=Y.readFileSync(o,"utf-8"),r=!0}catch{r=!1}if(!r){console.log(p.yellow(`
|
|
81
|
+
MEMORY.md does not exist yet.`)),n.length>0?console.log(p.dim(" Run `/memory rebuild` to seed it from existing topic files.")):console.log(p.dim(" The LLM will create it on first save \u2014 no action needed.")),console.log();return}console.log(p.cyan(`
|
|
82
|
+
--- MEMORY.md ---`)),a.trim().length===0?console.log(p.dim(" (empty)")):console.log(a.trimEnd()),console.log(p.cyan(`--- end ---
|
|
83
|
+
`))}i(dc,"listMemory");async function uc(e,o){let n=!1;try{n=Y.statSync(e).isDirectory()}catch{n=!1}if(!n){console.log(p.yellow(`
|
|
84
|
+
[memory] memory directory does not exist yet \u2014 nothing to rebuild.`)),console.log(p.dim(` ${e}`)),console.log(p.dim(` The LLM will create both the directory and MEMORY.md on first save.
|
|
85
|
+
`));return}let t=Ai(e);if(t.length===0){console.log(p.yellow(`
|
|
86
|
+
[memory] no topic files found \u2014 nothing to rebuild.`)),console.log(p.dim(` ${e}
|
|
87
|
+
`));return}let r=[...t].sort((d,u)=>u.mtimeMs-d.mtimeMs),l=cc(r).join(`
|
|
88
|
+
`)+`
|
|
89
|
+
`;Y.writeFileSync(o,l,"utf-8"),console.log(p.green(`
|
|
90
|
+
[memory] rebuilt MEMORY.md with ${r.length} entries (newest first).`)),console.log(p.dim(` ${o}`));let c=r.filter(d=>!d.parseOk);if(c.length>0){console.log(p.yellow(` ${c.length} file(s) had no parsable frontmatter \u2014 used filename as fallback:`));for(let d of c)console.log(p.dim(` - ${d.filename}`));console.log(p.dim(" Tip: add `---\\nname: ...\\ndescription: ...\\ntype: ...\\n---` at the top of those files."))}console.log()}i(uc,"rebuildMemory");function fc(e,o){console.log(p.cyan(`
|
|
91
|
+
[memory] open these paths in your editor:`)),console.log(p.dim(" index :"),o),console.log(p.dim(" dir :"),e),console.log(p.dim(`
|
|
92
|
+
(No in-REPL editor is provided \u2014 open the file in your usual editor.
|
|
93
|
+
Use \`/memory rebuild\` after manual edits if you renamed any topic file.)
|
|
94
|
+
`))}i(fc,"openMemory");function mc(e){let o=e.targetRefs.map(n=>n.title??n.id).join(", ");return`${e.action} ${o||"(report only)"}`}i(mc,"proposalLabel");function pc(e){if(console.log(p.cyan(`
|
|
95
|
+
[memory] pending memory proposals`)),e.length===0){console.log(p.dim(` (none)
|
|
96
|
+
`));return}for(let o of e)console.log(` ${p.cyan(o.id)} ${p.dim(`[${o.action}]`)} ${mc(o)}`);console.log(p.dim(`
|
|
97
|
+
Use /memory show <id>, /memory approve <id>, or /memory reject <id>.
|
|
98
|
+
`))}i(pc,"printMemoryInbox");function gc(e){if(console.log(p.cyan(`
|
|
99
|
+
[memory] ${e.id}`)),console.log(p.dim(` action : ${e.action}`)),console.log(p.dim(` risk : ${e.risk}`)),console.log(p.dim(` reason : ${e.rationale}`)),console.log(p.dim(` summary: ${e.preview.summary}`)),e.preview.changedPaths.length>0){console.log(p.dim(" changed paths:"));for(let o of e.preview.changedPaths)console.log(p.dim(` - ${o}`))}if(e.preview.warnings.length>0){console.log(p.yellow(" warnings:"));for(let o of e.preview.warnings)console.log(p.yellow(` - ${o}`))}e.preview.diff!==void 0&&e.preview.diff.trim().length>0&&(console.log(p.cyan(`
|
|
100
|
+
--- preview ---`)),console.log(e.preview.diff.trimEnd()),console.log(p.cyan("--- end ---"))),console.log()}i(gc,"printMemoryProposal");function wc(e){if(!e.applied){console.log(p.yellow(`
|
|
101
|
+
[memory] ${e.proposalId} was not applied.`)),console.log(p.dim(` ${e.skippedReason??"no reason provided"}
|
|
102
|
+
`));return}console.log(p.green(`
|
|
103
|
+
[memory] approved and applied ${e.proposalId}.`)),e.changedPaths.length>0&&console.log(p.dim(` changed: ${e.changedPaths.join(", ")}`)),console.log()}i(wc,"printApplyResult");function hc(e){if(!e.rejected){console.log(p.yellow(`
|
|
104
|
+
[memory] ${e.proposalId} was not rejected.`)),console.log(p.dim(` ${e.skippedReason??"no reason provided"}
|
|
105
|
+
`));return}console.log(p.dim(`
|
|
106
|
+
[memory] rejected ${e.proposalId}.`)),e.review!==void 0&&console.log(p.dim(` review actions: ${e.review.actions.length}`));for(let o of e.warnings)console.log(p.dim(` review warning: ${o}`));console.log()}i(hc,"printRejectResult");function yc(e){console.log(p.cyan(`
|
|
107
|
+
[memory] governance report ${e.reportId}`));for(let o of e.warnings)console.log(p.yellow(` warning: ${o}`));for(let o of e.findings)console.log(` ${p.dim(`[${o.severity}]`)} ${o.kind}: ${o.summary}`),o.refIds.length>0&&console.log(p.dim(` refs: ${o.refIds.join(", ")}`));console.log()}i(yc,"printGovernanceReport");function $i(){console.log(p.cyan(`
|
|
108
|
+
/memory - Inspect or rebuild per-project memory`)),console.log(p.dim(" /memory List MEMORY.md + memory directory")),console.log(p.dim(" /memory list Same as `/memory`")),console.log(p.dim(" /memory pending List pending memory learning proposals")),console.log(p.dim(" /memory show <id> Preview a memory proposal")),console.log(p.dim(" /memory approve <id> Approve and apply a memory proposal")),console.log(p.dim(" /memory reject <id> Reject a memory proposal")),console.log(p.dim(" /memory curate Report duplicate/stale/quarantined refs")),console.log(p.dim(" /memory rebuild Regenerate MEMORY.md from topic frontmatter")),console.log(p.dim(" /memory open Print paths so you can open them in your editor")),console.log(p.dim(" /memory help Show this help")),console.log()}i($i,"printHelp");function vc(){console.log(p.bold(`
|
|
109
|
+
/memory - Inspect or rebuild project memory
|
|
110
|
+
`)),console.log("Usage:"),console.log(p.cyan(" /memory ")+p.dim("Show MEMORY.md + topic file count")),console.log(p.cyan(" /memory list ")+p.dim("Alias for `/memory`")),console.log(p.cyan(" /memory pending ")+p.dim("List pending memory learning proposals")),console.log(p.cyan(" /memory show <id> ")+p.dim("Preview a memory proposal")),console.log(p.cyan(" /memory approve <id> ")+p.dim("Approve and apply a memory proposal")),console.log(p.cyan(" /memory reject <id> ")+p.dim("Reject a memory proposal")),console.log(p.cyan(" /memory curate ")+p.dim("Report duplicate/stale/quarantined refs")),console.log(p.cyan(" /memory rebuild ")+p.dim("Regenerate MEMORY.md (newest first by mtime)")),console.log(p.cyan(" /memory open ")+p.dim("Print the index + dir paths for editor use")),console.log(p.cyan(" /memory help ")+p.dim(`Show this help
|
|
111
|
+
`)),console.log("Description:"),console.log(p.dim(` Each project gets its own memory directory under your KodaX agent
|
|
112
|
+
home \u2014 \`<agentConfigHome>/projects/<project-key>/memory/\`. The LLM
|
|
113
|
+
owns reads/writes; this command is your escape hatch when the
|
|
114
|
+
MEMORY.md index drifts from the topic files on disk.
|
|
115
|
+
`)),console.log("Notes:"),console.log(p.dim(" \u2022 Rebuild ONLY rewrites MEMORY.md. Topic files are never touched.")),console.log(p.dim(" \u2022 Rebuild sorts entries by file mtime descending \u2014 the same")),console.log(p.dim(" natural-LRU order the LLM produces by prepending new entries.")),console.log(p.dim(" \u2022 Files missing or with malformed frontmatter still appear in")),console.log(p.dim(" the rebuilt index using their filename as fallback; the command")),console.log(p.dim(` prints a warning so you can fix the frontmatter.
|
|
116
|
+
`))}i(vc,"printDetailedHelp");var vt={name:"memory",description:"Inspect, govern, or rebuild per-project memory",usage:"/memory [list|pending|show|approve|reject|curate|rebuild|open|help]",argumentHint:"list | pending | show <id> | approve <id> | reject <id> [reason] | curate | rebuild | open | help",handler:i(async(e,o,n)=>{let t=lc(o),r=Rr(t),a=Er(t),l=(e[0]??"list").toLowerCase(),c=n.createKodaXOptions?.().memoryReviewer,d=Wr({cwd:t,...c!==void 0?{memoryReviewer:c}:{}});if(l==="help"||l==="--help"||l==="-h"){$i();return}if(l==="list"){await dc(r,a);return}if(l==="pending"||l==="inbox"){pc(await d.listInbox());return}if(l==="show"){let u=e[1];if(u===void 0){console.log(p.yellow(`
|
|
117
|
+
[memory] missing proposal id for show.
|
|
118
|
+
`));return}let f=await d.showProposal(u);if(f===void 0){console.log(p.yellow(`
|
|
119
|
+
[memory] proposal not found: ${u}
|
|
120
|
+
`));return}gc(f),kc(t,f.id,f.expectedFingerprints);return}if(l==="approve"){let u=e[1];if(u===void 0){console.log(p.yellow(`
|
|
121
|
+
[memory] missing proposal id for approve.
|
|
122
|
+
`));return}let f=bc(t,u);if(f===void 0){console.log(p.yellow(`
|
|
123
|
+
[memory] preview required before approve: /memory show ${u}
|
|
124
|
+
`));return}let m=await d.approveProposal(u,f);Ae.delete(cn(t,u)),wc(m);return}if(l==="reject"){let u=e[1];if(u===void 0){console.log(p.yellow(`
|
|
125
|
+
[memory] missing proposal id for reject.
|
|
126
|
+
`));return}let f=await d.rejectProposal(u,e.slice(2).join(" ").trim());Ae.delete(cn(t,u)),hc(f);return}if(l==="curate"){yc(await d.runCurator());return}if(l==="rebuild"){await uc(r,a);return}if(l==="open"){fc(r,a);return}console.log(p.yellow(`
|
|
127
|
+
[memory] unknown subcommand: ${l}`)),$i()},"handler"),detailedHelp:vc};function cn(e,o){return`${e}\0${o}`}i(cn,"previewCacheKey");function kc(e,o,n){Sc(Date.now()),Ae.set(cn(e,o),{fingerprints:n,createdAtMs:Date.now()})}i(kc,"cachePreviewFingerprints");function bc(e,o){let n=cn(e,o),t=Ae.get(n);if(t!==void 0){if(Date.now()-t.createdAtMs>xi){Ae.delete(n);return}return t.fingerprints}}i(bc,"readCachedPreviewFingerprints");function Sc(e){for(let[o,n]of Ae)e-n.createdAtMs>xi&&Ae.delete(o)}i(Sc,"pruneExpiredPreviewFingerprints");import E from"chalk";function Ri(){console.log(`
|
|
128
|
+
${E.bold("/goal")} \u2014 persistent session goal
|
|
129
|
+
|
|
130
|
+
${E.bold("Subcommands:")}
|
|
131
|
+
${E.cyan("/goal <objective> [--tokens N]")} Create a new persistent goal.
|
|
132
|
+
${E.cyan("/goal status")} Show current goal (default).
|
|
133
|
+
${E.cyan("/goal pause")} Pause an active goal.
|
|
134
|
+
${E.cyan("/goal resume")} Resume a paused goal.
|
|
135
|
+
${E.cyan("/goal clear")} Clear the current goal.
|
|
136
|
+
${E.cyan("/goal help")} Show this help.
|
|
137
|
+
|
|
138
|
+
${E.bold("Notes:")}
|
|
139
|
+
- The agent auto-continues toward an active goal on every Worker turn end.
|
|
140
|
+
- Token budget is optional; set it only when you want a hard ceiling.
|
|
141
|
+
- update_goal({complete}) is verifier-gated; the agent cannot
|
|
142
|
+
self-declare done without runtime confirmation.
|
|
143
|
+
`.trim())}i(Ri,"printHelp");function $c(e){let o=null,n=[];for(let r=0;r<e.length;r++){let a=e[r];if(a==="--tokens"){let l=e[r+1];if(!l)return{error:"--tokens requires a value (e.g. `--tokens 50000`)"};let c=Number(l);if(!Gn(c))return{error:"--tokens value must be a positive integer"};o=c,r++;continue}if(a.startsWith("--tokens=")){let l=a.slice(9),c=Number(l);if(!Gn(c))return{error:"--tokens value must be a positive integer"};o=c;continue}if(a.startsWith("--"))return{error:`unknown flag: ${a}`};n.push(a)}let t=n.join(" ").trim();return t?{objective:t,tokenBudget:o}:{error:"objective is required"}}i($c,"parseCreateArgs");function xc(e){if(!e)return E.dim("No goal set. Use `/goal <objective>` to create one.");let o=[`${E.bold("Goal:")} ${e.objective}`,`${E.bold("Status:")} ${e.status}`,`${E.bold("Tokens used:")} ${e.tokensUsed}`];if(e.tokenBudget!==null){let n=Math.max(0,e.tokenBudget-e.tokensUsed);o.push(`${E.bold("Token budget:")} ${e.tokenBudget} (remaining ${n})`)}else o.push(`${E.bold("Token budget:")} ${E.dim("none")}`);return o.push(`${E.bold("Elapsed:")} ${e.timeUsedSeconds}s`),e.status==="blocked"&&e.lastBlockerKind&&o.push(`${E.bold("Blocker:")} ${e.lastBlockerKind}`),o.join(`
|
|
144
|
+
`)}i(xc,"renderStatus");async function So(e,o,n,t){if(!e.lineage)throw new Error("session lineage unavailable \u2014 open or start a new session before using /goal");e.lineage=Nr(e.lineage,n,t),await o.saveSession()}i(So,"persist");async function Ac(e,o,n){if(!o.lineage){console.log(E.red("[/goal] no active session lineage"));return}let t=Ue(o.lineage);if(t&&t.status!=="complete"){console.log(E.yellow(`[/goal] a goal is already active (status: ${t.status}). Clear it first with \`/goal clear\` before creating a new one.`));return}let r=$c(e);if("error"in r){console.log(E.red(`[/goal] ${r.error}`));return}try{t&&t.status==="complete"&&await So(o,n,null,"cleared");let a=jr(r.objective,r.tokenBudget);await So(o,n,a,"created"),console.log(E.green(`[/goal] created: "${a.objective}"`)),a.tokenBudget!==null&&console.log(E.dim(` budget: ${a.tokenBudget} tokens`))}catch(a){let l=a instanceof Error?a.message:String(a);console.log(E.red(`[/goal] ${l}`))}}i(Ac,"doCreate");async function Rc(e){if(!e.lineage){console.log(E.red("[/goal] no active session lineage"));return}let o=Ue(e.lineage);console.log(xc(o))}i(Rc,"doStatus");async function Ec(e,o){if(!e.lineage){console.log(E.red("[/goal] no active session lineage"));return}let n=Ue(e.lineage);if(!n){console.log(E.yellow("[/goal] no goal to pause"));return}if(n.status!=="active"){console.log(E.yellow(`[/goal] cannot pause from status '${n.status}' (only 'active' is pausable)`));return}let t=Fr(n);await So(e,o,t,"paused"),console.log(E.green("[/goal] paused"))}i(Ec,"doPause");async function Cc(e,o){if(!e.lineage){console.log(E.red("[/goal] no active session lineage"));return}let n=Ue(e.lineage);if(!n){console.log(E.yellow("[/goal] no goal to resume"));return}if(n.status!=="paused"){console.log(E.yellow(`[/goal] cannot resume from status '${n.status}' (only 'paused' is resumable)`));return}let t=Hr(n);await So(e,o,t,"resumed"),console.log(E.green("[/goal] resumed"))}i(Cc,"doResume");async function Ic(e,o){if(!e.lineage){console.log(E.red("[/goal] no active session lineage"));return}if(!Ue(e.lineage)){console.log(E.yellow("[/goal] no goal to clear"));return}await So(e,o,null,"cleared"),console.log(E.green("[/goal] cleared"))}i(Ic,"doClear");var Ei={name:"goal",description:"Manage a persistent session goal (FEATURE_192)",usage:"/goal [<objective> [--tokens N] | status | pause | resume | clear | help]",argumentHint:"<objective> | status | pause | resume | clear | help",handler:i(async(e,o,n)=>{let t=(e[0]??"status").toLowerCase();if(t==="help"||t==="--help"||t==="-h"){Ri();return}if(t==="status"){await Rc(o);return}if(t==="pause"){await Ec(o,n);return}if(t==="resume"){await Cc(o,n);return}if(t==="clear"){await Ic(o,n);return}await Ac(e,o,n)},"handler"),detailedHelp:Ri};import{existsSync as Ji}from"node:fs";import{join as Z}from"node:path";import g from"chalk";import St from"path";import{createHash as Wc}from"crypto";import{execFile as Tc}from"child_process";import Pc from"fs";import kt from"path";import{promisify as Lc}from"util";var Mc=Lc(Tc);function pe(e){if(!(!e||!e.trim()))return kt.resolve(e).replace(/\\/g,"/")}i(pe,"normalizePath");async function $o(e,o){try{let{stdout:n}=await Mc("git",o,{cwd:e,windowsHide:!0,maxBuffer:1048576}),t=n.trim();return t||void 0}catch{return}}i($o,"gitStdout");function _c(e){let o=pe(e);if(o)return kt.posix.basename(o)===".git"?kt.posix.dirname(o):o}i(_c,"deriveCanonicalRepoRoot");async function hg(e={}){let o=pe(e.cwd??process.cwd())??process.cwd().replace(/\\/g,"/"),n=pe(await $o(o,["rev-parse","--show-toplevel"])),t=n??o,[r,a]=await Promise.all([$o(t,["rev-parse","--path-format=absolute","--git-common-dir"]).then(l=>l??$o(t,["rev-parse","--git-common-dir"])),$o(t,["branch","--show-current"]).then(l=>l??$o(t,["rev-parse","--abbrev-ref","HEAD"]))]);return{canonicalRepoRoot:_c(r)??n,workspaceRoot:n,executionCwd:o,branch:a&&a!=="HEAD"?a:void 0,workspaceKind:e.workspaceKind??"detected"}}i(hg,"inspectWorkspaceRuntime");function yg(e,o){return!e?.canonicalRepoRoot||!o?.canonicalRepoRoot?!1:pe(e.canonicalRepoRoot)===pe(o.canonicalRepoRoot)}i(yg,"isSameCanonicalRepo");function vg(e){return!!(e?.workspaceRoot&&Pc.existsSync(e.workspaceRoot))}i(vg,"workspaceExists");function Ci(e){let o=pe(e.runtimeInfo?.workspaceRoot??e.gitRoot),n=pe(e.runtimeInfo?.executionCwd??o),t=pe(e.runtimeInfo?.canonicalRepoRoot??o);if(!(!o&&!n&&!t))return{canonicalRepoRoot:t,workspaceRoot:o,executionCwd:n,branch:e.runtimeInfo?.branch,workspaceKind:e.runtimeInfo?.workspaceKind??"detected"}}i(Ci,"resolveSessionRuntimeInfo");function bt(e){if(!e?.workspaceRoot)return"No git workspace detected";let o=e.branch?` @ ${e.branch}`:"",n=e.workspaceKind??"detected";return`${e.workspaceRoot}${o} [${n}]`}i(bt,"formatWorkspaceTruth");var Ii="_unknown",Ti=80;function Oc(e){return process.platform==="win32"||process.platform==="darwin"?e.toLowerCase():e}i(Oc,"caseFold");function Nc(e){return Oc(St.resolve(e).replace(/\\/g,"/"))}i(Nc,"normalizeRoot");function Pi(e){return Wc("sha256").update(e).digest("hex").slice(0,10)}i(Pi,"shortHash");function Dc(e){let o=e.replace(/[^a-z0-9]+/gi,"-").replace(/^-+|-+$/g,"");return o.length>Ti?o.slice(o.length-Ti):o}i(Dc,"slugify");function Re(e){if(!e||!e.trim())return{key:Ii,canonicalRoot:null,displayName:Ii};let o=Nc(e),n=Dc(o),t=n?`${n}-${Pi(o)}`:Pi(o),r=St.basename(St.resolve(e).replace(/\\/g,"/"))||e;return{key:t,canonicalRoot:o,displayName:r}}i(Re,"deriveProjectKeyFromRoot");function Ag(e){let o=Ci({gitRoot:e.gitRoot??"",runtimeInfo:e.runtimeInfo}),n=o?.canonicalRepoRoot??o?.executionCwd??(e.gitRoot&&e.gitRoot.trim()?e.gitRoot:void 0);return Re(n)}i(Ag,"deriveProjectKeyFromData");import Ee from"chalk";function un(e){return e.runtimeInfo?.workspaceRoot??e.runtimeInfo?.executionCwd??process.cwd()}i(un,"resolveLearningCommandCwd");function Xe(e=""){process.stdout.write(`${e}
|
|
145
|
+
`)}i(Xe,"writeOutput");function Uc(e,o){return o==="skill"?e.proposal.destination==="skill_patch"||e.proposal.destination==="skill_create":o==="workflow"?e.proposal.destination==="workflow_handoff":e.proposal.destination==="memdir_handoff"||e.proposal.destination==="reasoning_handoff"}i(Uc,"matchesFilter");function jc(e){return e==="skill"?"pending method guides":e==="workflow"?"pending runnable workflows":"pending memory handoffs"}i(jc,"headingForFilter");function Fc(e){let o=e.proposal;switch(o.destination){case"skill_patch":case"skill_create":return`${o.destination} ${o.skillName}`;case"workflow_handoff":return`${o.suggestedAction} ${o.evidenceRunIds.join(",")}`;case"memdir_handoff":return`${o.memoryKind}`;case"reasoning_handoff":return o.title}}i(Fc,"proposalLabel");async function fn(e,o){let n=jo(e),t=await Uo(n);for(let a of t.warnings)Xe(Ee.yellow(`[learn] ${a}`));let r=t.proposals.filter(a=>a.status==="pending").filter(a=>Uc(a,o));if(Xe(Ee.cyan(`
|
|
146
|
+
[learn] ${jc(o)}`)),Xe(Ee.dim(` ${n}`)),r.length===0){Xe(Ee.dim(` (none)
|
|
147
|
+
`));return}for(let a of r)Xe(` ${Ee.cyan(a.proposalId)} ${Ee.dim(`[${a.proposal.destination}]`)} ${Fc(a)}`);Xe(Ee.dim(`
|
|
148
|
+
Use /learn diff <id>, /learn approve <id>, or /learn reject <id>.
|
|
149
|
+
`))}i(fn,"printLearningPendingForFilter");import{join as Ed}from"node:path";import xn from"chalk";import{existsSync as re,readdirSync as ed,readFileSync as wn,writeFileSync as Ug}from"node:fs";import{dirname as od,join as J}from"node:path";import R from"chalk";import{existsSync as Hc,readFileSync as Bc}from"node:fs";var Li=4,Mi=180,_i=6e3,Wi=360,$t="[truncated]";function Ce(e){return/[\u3400-\u9fff]/u.test(e)?"zh":"en"}i(Ce,"detectWorkflowLocale");function xo(...e){return Ce(e.filter(o=>typeof o=="string").join(`
|
|
150
|
+
`))}i(xo,"inferWorkflowLocaleFromParts");function ge(e,o={}){let n=e.trim();return o.full===!0||n.length<=_i?n:`${n.slice(0,_i).trimEnd()}
|
|
151
|
+
|
|
152
|
+
${$t}`}i(ge,"trimResultPreview");function xt(e){return e.includes($t)}i(xt,"isWorkflowResultPreviewTruncated");function Kc(e,o){return o==="zh"?`[\u7ED3\u679C\u9884\u89C8\u5DF2\u622A\u65AD\u3002\u5B8C\u6574\u7ED3\u679C\u8BF7\u7528 /workflow show --full ${e} \u67E5\u770B\uFF1Bartifact \u6587\u4EF6\u4E5F\u4FDD\u5B58\u5728\u672C\u6B21 run \u76EE\u5F55\u3002]`:`[Result preview truncated. Use /workflow show --full ${e} for the complete result; artifacts are also saved in the run directory.]`}i(Kc,"formatWorkflowResultTruncationHint");function Ve(e,o,n){let t=e.lastIndexOf($t);return t<0?e:`${e.slice(0,t).trimEnd()}
|
|
153
|
+
|
|
154
|
+
${Kc(o,n)}`}i(Ve,"replaceWorkflowResultTruncationMarker");function Gc(e){let o=e.replace(/\s+/g," ").trim();return o.length<=Wi?o:`${o.slice(0,Wi).trimEnd()}...`}i(Gc,"trimWorkflowLaunchSummary");function we(e,o={}){if(typeof e=="string"&&e.trim().length>0)return ge(e,o);if(e&&typeof e=="object"&&"synthesis"in e){let n=e.synthesis;if(typeof n=="string"&&n.trim().length>0)return ge(n,o);if(n&&typeof n=="object"&&"text"in n){let t=n.text;if(typeof t=="string"&&t.trim().length>0)return ge(t,o)}}if(e&&typeof e=="object")for(let n of["summary","report","text","result"]){let t=e[n];if(typeof t=="string"&&t.trim().length>0)return ge(t,o)}if(e!=null)try{let n=JSON.stringify(e,null,2);if(typeof n=="string"){let t=n.trim();if(t.length>0&&t!=="{}"&&t!=="[]"&&t!=='""')return ge(n,o)}}catch{}}i(we,"formatResult");function Ao(e,o={}){let n=[...e].reverse().filter(d=>d.type==="agent_completed"&&z(d,"status")==="completed"||d.type==="agent_unverified"),r=n.find(d=>z(d,"name")==="synthesize")??n[0],a=r?z(r,"summary"):void 0;if(a)return ge(a,o);let l=[...e].reverse().find(d=>d.type==="agent_failed"),c=l?z(l,"summary")??z(l,"error"):void 0;return c?ge(c,o):void 0}i(Ao,"formatFinalEventSummary");function qc(e,o={}){if(!(!e.path||!Hc(e.path)))try{let n=JSON.parse(Bc(e.path,"utf8")),t=we(n,o);if(t)return t;let r=JSON.stringify(n,null,2);return typeof r=="string"&&r.trim().length>0?ge(r,o):void 0}catch(n){return`artifact preview unavailable: ${n instanceof Error?n.message:String(n)}`}}i(qc,"formatArtifactPreview");function Ye(e,o,n={}){for(let r=e.length-1;r>=0;r-=1){let a=e[r];if(!a)continue;let l=qc(a,n);if(l)return o==="zh"?`\u4EA7\u7269 ${a.name}:
|
|
155
|
+
${l}`:`Artifact ${a.name}:
|
|
156
|
+
${l}`}if(e.length===0)return;let t=e.map(r=>r.name).join(", ");return o==="zh"?`\u5DF2\u751F\u6210\u4EA7\u7269: ${t}`:`Artifacts created: ${t}`}i(Ye,"formatArtifactResult");function At(e){let o=e.resultText?Ve(e.resultText,e.runId,e.locale):void 0;if(e.locale==="zh"){let t=e.resultText&&e.isFallbackPreview!==!0?`Workflow \u5DF2\u5B8C\u6210\uFF08${e.totalSpawned} \u4E2A\u667A\u80FD\u4F53\uFF0Crun ${e.runId}\uFF09\u3002`:`Workflow \u8FD0\u884C\u7ED3\u675F\uFF0C\u4F46\u7ED3\u679C\u5951\u7EA6\u5931\u8D25\uFF08${e.totalSpawned} \u4E2A\u667A\u80FD\u4F53\uFF0Crun ${e.runId}\uFF09\u3002`;if(o){let r=e.isFallbackPreview===!0?"\u7ED3\u679C\u5951\u7EA6\u5F02\u5E38\uFF1Aworkflow \u8FD0\u884C\u7ED3\u675F\uFF0C\u4F46\u6CA1\u6709\u8FD4\u56DE\u5B8C\u6574\u6700\u7EC8\u7ED3\u679C\u3002\u4EE5\u4E0B\u662F\u6700\u540E\u7EFC\u5408\u8F93\u51FA\uFF1A":"\u6700\u7EC8\u7ED3\u679C\uFF1A";return`${t}
|
|
157
|
+
|
|
158
|
+
${r}
|
|
159
|
+
|
|
160
|
+
${o}`}return[t,"","\u8FD9\u6B21 workflow \u8FD0\u884C\u7ED3\u675F\uFF0C\u4F46\u751F\u6210\u811A\u672C\u8FDD\u53CD\u7ED3\u679C\u5951\u7EA6\uFF1A\u6CA1\u6709\u8FD4\u56DE\u53EF\u76F4\u63A5\u5C55\u793A\u7684\u6700\u7EC8\u7ED3\u679C\u6216\u53EF\u9884\u89C8\u4EA7\u7269\u3002\u8FD9\u4E0D\u662F\u6B63\u5E38\u5B8C\u6210\u72B6\u6001\uFF0C\u9700\u8981\u4FEE\u590D\u751F\u6210\u811A\u672C\u540E\u91CD\u65B0\u8FD0\u884C\u3002"].join(`
|
|
161
|
+
`)}let n=e.resultText&&e.isFallbackPreview!==!0?`Workflow completed (${e.totalSpawned} agents, run ${e.runId}).`:`Workflow ended with a result contract failure (${e.totalSpawned} agents, run ${e.runId}).`;if(o){let t=e.isFallbackPreview===!0?"Result contract violation: the workflow ended without returning a complete final result. Last synthesis output:":"Final result:";return`${n}
|
|
162
|
+
|
|
163
|
+
${t}
|
|
164
|
+
|
|
165
|
+
${o}`}return[n,"","The workflow ended, but the generated script violated the result contract: it did not return displayable final text or a previewable artifact. This is not a normal completion state; fix the generated script and rerun it."].join(`
|
|
166
|
+
`)}i(At,"formatWorkflowCompletionAnswer");function Rt(e){let o=e.summary.phases.length>0?e.summary.phases.join(" -> "):"dynamic",n=e.summary.maxAgents===null?"unbounded":String(e.summary.maxAgents),t=e.summary.plannedAgents===void 0?e.locale==="zh"?`\u6700\u591A ${n} \u4E2A\u667A\u80FD\u4F53`:`up to ${n} agents`:e.locale==="zh"?`\u8BA1\u5212\u7EA6 ${e.summary.plannedAgents} \u4E2A\u667A\u80FD\u4F53\uFF0C\u5B89\u5168\u4E0A\u9650 ${n}`:`about ${e.summary.plannedAgents} planned agents, safety cap ${n}`,r=e.summary.maxConcurrency===null?"unbounded":String(e.summary.maxConcurrency),a=Gc(e.approvalSummary);if(e.locale==="zh"){let c=e.summary.writesFiles?"\u5982\u9700\u5199\u6587\u4EF6\uFF0C\u4ECD\u4F1A\u7ECF\u8FC7\u6B63\u5E38\u6743\u9650\u786E\u8BA4\u3002":"\u8FD9\u662F\u53EA\u8BFB\u63A2\u67E5\uFF0C\u4E0D\u4F1A\u4E3B\u52A8\u4FEE\u6539\u6587\u4EF6\u3002";return[`\u6211\u4F1A\u7528 workflow \u505A\u8FD9\u6B21\u4EFB\u52A1\uFF0C\u5DF2\u542F\u52A8 ${e.summary.name}\uFF08${e.runId}\uFF09\u3002`,`\u8BA1\u5212\uFF1A${a}`,`\u9636\u6BB5\uFF1A${o}\uFF1B\u89C4\u6A21\uFF1A${t}\uFF0C\u5E76\u53D1 ${r}\u3002${c}`,"\u8FD0\u884C\u8FC7\u7A0B\u4F1A\u5728\u4E0B\u65B9\u52A8\u6001\u66F4\u65B0\uFF0C\u5B8C\u6210\u540E\u6211\u4F1A\u76F4\u63A5\u6C47\u603B\u7ED3\u8BBA\u3002"].join(`
|
|
167
|
+
`)}let l=e.summary.writesFiles?"File-writing work still goes through normal permission gates.":"This is read-only and will not modify files.";return[`I will use a workflow for this task: ${e.summary.name} (${e.runId}).`,`Plan: ${a}`,`Phases: ${o}; scale: ${t}, ${r} concurrent. ${l}`,"Progress will update below, and I will summarize the result when it finishes."].join(`
|
|
168
|
+
`)}i(Rt,"formatWorkflowLaunchAnswer");function z(e,o){let n=e.data?.[o];return typeof n=="string"&&n.trim().length>0?n.trim():void 0}i(z,"readEventString");function Et(e,o="en",n){if(e.type!=="agent_completed"&&e.type!=="agent_unverified"&&e.type!=="agent_failed"&&e.type!=="agent_summary_updated"||e.type==="agent_completed"&&z(e,"status")!=="completed")return;let t=z(e,"summary")??z(e,"error");if(!t)return;let r=z(e,"summaryKind");if(r==="pending")return;let a=r==="digest"?"digest":r==="digest-failed"?"digest-failed":"excerpt",l=z(e,"name")??z(e,"taskId")??"agent";return Qc(l,t,o,n,a)}i(Et,"formatWorkflowAgentDigest");function zc(e){let o=e.replace(/\s+/g," ").trim();return o.length<=Mi?o:`${o.slice(0,Mi).trimEnd()}...`}i(zc,"trimWorkflowAgentDigestExcerpt");function Xc(e){return/^(?:conclusion|finding|confirmed issue|issue|evidence|risk|next|unresolved|decision|result|summary|结论|发现|问题|证据|风险|下一步|未决|判断|决定|结果|摘要)[::]/i.test(e)||/^(?:[A-Z]{1,3}-?\d+|[HMSLP]\d+)[.)::\s-]/i.test(e)?!0:/(?:critical|high|medium|low)\s+severity|(?:严重|高危|中危|低危)/i.test(e)}i(Xc,"isHighSignalWorkflowAgentDigestLine");function Vc(e){let o=e.toLowerCase();return!!(/\[\/?workflow handoff\]/i.test(e)||/^\|.*\|$/.test(e)||/^\|?\s*:?-{3,}:?\s*(?:\|\s*:?-{3,}:?\s*)+\|?$/.test(e)||/^(?:i now have|i have|i now understand|here is|let me|i will|this report|the report)\b/.test(o)||/^(?:scope|review scope|范围|审查范围)[::]/i.test(e)||/^feature[_\s-]*\d+.*(?:report|review|audit|map|审查|报告|地图|变更地图)/i.test(e)||/^feature[_\s-]*\d+.*改动分布.*feature/i.test(e)||/(?:review report|audit|审查报告|综合报告|分析报告|变更地图)$/i.test(e)&&e.length<140)}i(Vc,"isLowInformationWorkflowAgentDigestLine");function Yc(e){return e.replace(/\s+/g," ").trim()}i(Yc,"compactWorkflowAgentDigestLine");function Jc(e,o={}){let n=e.replace(/^#{1,6}\s+/,"").replace(/^[-*]\s+/,"").replace(/^\d+[.)]\s+/,"").replace(/^`{3,}.*$/,"").replace(/^[`"'“”‘’)\]},,、。;;::.\s]+/,"").trim(),t=Yc(n);if(!(t.length<12)&&!/^[-*_`#\s]+$/.test(t)&&!Vc(t))return o.truncateLines===!1?t:zc(t)}i(Jc,"normalizeWorkflowAgentDigestLine");function Zc(e,o={}){let n=[],t=[];for(let r of e.split(/\r?\n+/)){let a=Jc(r,o);if(!a)continue;let l=Xc(a)?n:t;n.includes(a)||t.includes(a)||l.push(a)}return n.length>0?n.slice(0,Li):t.length>0?t.slice(0,Li):[]}i(Zc,"extractWorkflowAgentDigestExcerpts");function Qc(e,o,n,t,r="excerpt"){let a=r==="digest",c=Zc(o,{truncateLines:!a}).map(f=>`- ${f}`),d=t?n==="zh"?`\u8FD9\u662F\u5B50 Agent \u7684\u6709\u754C\u6458\u8981\uFF1B/workflow show ${t} \u53EF\u67E5\u770B\u8FD0\u884C\u4E8B\u4EF6\u65F6\u95F4\u7EBF\u3002`:`This is a child-agent digest; use /workflow show ${t} for the event timeline.`:n==="zh"?"\u8FD9\u662F\u5B50 Agent \u7684\u6709\u754C\u6458\u8981\uFF1B/workflow show \u53EF\u67E5\u770B\u8FD0\u884C\u4E8B\u4EF6\u65F6\u95F4\u7EBF\u3002":"This is a child-agent digest; use /workflow show for the event timeline.",u=n==="zh"?a?`\u5B50 Agent ${e} \u5DF2\u5B8C\u6210\u3002\u6458\u8981\uFF1A`:r==="digest-failed"?`\u5B50 Agent ${e} \u5DF2\u5B8C\u6210\uFF08\u667A\u80FD\u6458\u8981\u4E0D\u53EF\u7528\uFF0C\u4EE5\u4E0B\u4E3A\u672C\u5730\u6458\u5F55\uFF09\uFF1A`:`\u5B50 Agent ${e} \u5DF2\u5B8C\u6210\u3002\u6458\u5F55\u6458\u8981\uFF1A`:a?`Agent ${e} completed. Summary:`:r==="digest-failed"?`Agent ${e} completed (smart summary unavailable; local excerpt):`:`Agent ${e} completed. Extracted summary:`;return c.length===0?[n==="zh"?`\u5B50 Agent ${e} \u5DF2\u5B8C\u6210\uFF0C\u4F46\u672A\u80FD\u63D0\u53D6\u5230\u6709\u6548\u6458\u8981\u3002`:`Agent ${e} completed. No useful summary could be extracted.`,d].join(`
|
|
169
|
+
`):[u,...c,d].join(`
|
|
170
|
+
`)}i(Qc,"formatWorkflowAgentLongDigest");function mn(e){return(o,n="en")=>Et(o,n,e)}i(mn,"createWorkflowAgentDigestLimiter");import T from"chalk";function Ct(){return[`${T.bold("/workflow")} - dynamic multi-agent workflow harness`,"",`${T.bold("Subcommands:")}`,` ${T.cyan("/workflow list")} List built-in, pattern, and saved workflows. Alias: /workflow`,` ${T.cyan("/workflow create <request>")} Build & run a workflow for a request. The Worker investigates first, then authors it (scout-then-author). Requires AMA \u2014 Solo (SA) mode runs no workflows.`,` ${T.cyan("/workflow <request>")} Shorthand for create when the first word isn't a known workflow name or subcommand.`,` ${T.cyan("/workflow <name> [args]")} Run a built-in or saved workflow by name. Args may be JSON or bare text.`,` ${T.cyan("/workflow runs [--all|--limit N]")} List active and recent workflow runs for this project.`,` ${T.cyan("/workflow show [--full] [runId]")} Show the latest run; use --full for complete result artifacts.`,` ${T.cyan("/workflow pause <runId>")} Pause future child launches for an active run.`,` ${T.cyan("/workflow resume <runId>")} Resume a paused run.`,` ${T.cyan("/workflow stop [runId]")} Stop an active run through abort propagation. Defaults to the active run.`,` ${T.cyan("/workflow delete [--force] [--run|--saved] <runId|savedName>")} Delete one persisted run record or generated saved capsule; --force removes stale non-terminal run records.`,` ${T.cyan("/workflow prune --dry-run|--keep N|--older-than Nd")}`," Preview or delete old terminal run records.",` ${T.cyan("/workflow rerun <runId|savedName> [args]")} Rerun a historical generated run, or run the current saved workflow by name.`,` ${T.cyan("/workflow save <runId> <name>")} Save a generated run as a workflow capsule.`,` ${T.cyan("/workflow rename <runId|alias|savedName> <newName>")} Rename a run display name or generated saved capsule.`,` ${T.cyan("/workflow revise [--replace] <runId|alias|savedName> <change>")} Generate and save a capsule revision.`,` ${T.cyan("/workflow help")} Show this help. Also available as /help workflow.`,"",`${T.bold("Examples:")}`,` ${T.dim("/workflow create Compare three flaky-test hypotheses and verify each one")}`,` ${T.dim('/workflow parallel-investigation {"question":"\u8BF7\u68C0\u67E5\u8FD9\u4E2A\u7ADE\u6001\u5728\u54EA\u91CC","targets":["packages/agent"]}')}`,` ${T.dim('/workflow rerun run-lx3 {"request":"\u8BF7\u7528\u540C\u6837\u6D41\u7A0B\u590D\u67E5 packages/repl"}')}`,` ${T.dim('/workflow rerun generated-audit {"request":"reuse the saved workflow for packages/repl"}')}`,` ${T.dim("/workflow prune --dry-run")}`,` ${T.dim("/workflow save run-lx3 generated-audit")}`,"",`${T.bold("Safety:")}`," - Generated and workflow capsule (.workflow.json) workflows run in the capability WorkflowApi runner."," - For rerun, a run id reruns its saved snapshot; a saved name runs the current saved capsule version."," - For revise --replace, only a saved generated capsule name can move; the previous capsule is archived."," - Local .ts/.mjs/.js workflows are trusted-local and require explicit confirmation."," - File, shell, MCP, and web effects still go through child agents and existing permission gates."].join(`
|
|
171
|
+
`)}i(Ct,"renderWorkflowHelp");function pn(){console.log(`
|
|
172
|
+
${Ct()}
|
|
173
|
+
`)}i(pn,"printWorkflowHelp");var nd=new Set(["completed","failed","stopped","denied","cancelled"]);function It(e){return e.length===0?" (no built-in workflows)":e.map(o=>` ${R.cyan(o.name)} \u2014 ${o.description}`).join(`
|
|
174
|
+
`)}i(It,"formatWorkflowList");var td=6,rd=900;function sd(e){let o=e.replace(/\r\n/g,`
|
|
175
|
+
`).replace(/\r/g,`
|
|
176
|
+
`).split(`
|
|
177
|
+
`),n=[],t=0,r=!1;for(let l of o){if(n.length>=td)break;let c=` ${l}`,d=rd-t;if(d<=0){r=!0;break}if(c.length>d){d>16&&n.push(`${c.slice(0,d-4)} ...`),r=!0;break}n.push(c),t+=c.length+1}let a=Math.max(0,o.length-n.length);if(a>0||r){let l=a>0?`${a} more line(s)`:"source truncated";n.push(` ... (${l}; full source omitted from prompt)`)}return n}i(sd,"renderApprovalScriptPreview");function se(e,o){let n=i(a=>a===null?"\u221E":String(a),"cap"),t=e.plannedAgents===void 0?void 0:String(e.plannedAgents),r=t===void 0?`agent total cap: ${n(e.maxAgents)}`:`planned agents: ${t} \xB7 agent safety cap: ${n(e.maxAgents)}`;return[`Run workflow ${R.cyan(e.name)}?`,` ${e.description}`,` phases: ${e.phases.length>0?e.phases.join(" \u2192 "):"(dynamic)"}`,` ${r} \xB7 max concurrency: ${n(e.maxConcurrency)} \xB7 token budget: ${n(e.tokenBudget)}`,` writes files: ${e.writesFiles?R.yellow("yes"):"no (read-only)"}`,...o?[` source: ${o.source}`,` sandbox/trust: ${o.sandbox}`,` worktree isolation: ${o.mayUseWorktree?"may request worktree":"shared cwd / per-child default"}`,...o.rawScriptPath?[` raw script: ${o.rawScriptPath}`]:o.rawScript?[" raw script: preview below"]:[],...o.rawScript&&!o.rawScriptPath?[" raw script preview:",...sd(o.rawScript)]:[]]:[]].join(`
|
|
178
|
+
`)}i(se,"renderApprovalPrompt");function Eo(e){if(!re(e))return[];let o=[];for(let n of ed(e)){let t=J(e,n,"run.json");if(re(t))try{let r=JSON.parse(wn(t,"utf8"));o.push({runId:n,workflow:typeof r.workflow=="string"?r.workflow:"?",status:typeof r.status=="string"?r.status:"?",totalSpawned:typeof r.totalSpawned=="number"?r.totalSpawned:0,endedAt:typeof r.endedAt=="number"?r.endedAt:0})}catch{}}return o.sort((n,t)=>t.endedAt-n.endedAt)}i(Eo,"readWorkflowRuns");function id(e){let o=J(e,"events.jsonl");if(!re(o))return[];let n=wn(o,"utf8").split(/\r?\n/).filter(r=>r.trim().length>0),t=[];for(let r of n)try{let a=JSON.parse(r);if(typeof a!="object"||a===null)continue;let l=a;if(typeof l.seq!="number"||typeof l.type!="string")continue;let c=l.data;t.push({seq:l.seq,type:l.type,...typeof c=="object"&&c!==null?{data:c}:{}})}catch{}return t}i(id,"readWorkflowEvents");function ad(e){return Array.isArray(e)?e.filter(o=>typeof o=="string"):[]}i(ad,"readStringArray");function gn(e){return typeof e=="string"&&e.trim().length>0?e:void 0}i(gn,"readNonEmptyString");function Oi(e,o){let n=o?gn(o.scriptSnapshotPath):J(e,"script.js"),t=o?gn(o.manifestSnapshotPath):J(e,"manifest.json");return!n||!t?!1:re(n)&&re(t)}i(Oi,"hasGeneratedWorkflowSnapshot");function Di(e,o){if(o)return Oi(e,o);let n=J(e,"run.json");if(!re(n))return!1;try{let t=JSON.parse(wn(n,"utf8"));return typeof t=="object"&&t!==null?Oi(e,t):!1}catch{return!1}}i(Di,"hasRerunnableGeneratedWorkflowRun");function ld(e){for(let o of[...e].reverse()){if(o.type!=="workflow_failed")continue;let n=o.data?.error;if(typeof n=="string"&&n.trim().length>0)return n}}i(ld,"readWorkflowFailure");function Co(e,o){let n=J(e,o),t=J(n,"run.json"),r=id(n),a=ld(r);if(!(!re(t)&&r.length===0)){if(!re(t))return{runId:o,workflow:"?",status:a?"failed":"running",totalSpawned:r.filter(l=>l.type==="agent_spawned").length,eventCount:r.length,runDir:n,canRerun:!1,artifacts:[],events:r,...a?{error:a}:{}};try{let l=JSON.parse(wn(t,"utf8")),c=gn(l.scriptSnapshotPath),d=gn(l.manifestSnapshotPath);return{runId:o,workflow:typeof l.workflow=="string"?l.workflow:"?",status:typeof l.status=="string"?l.status:"?",totalSpawned:typeof l.totalSpawned=="number"?l.totalSpawned:0,eventCount:r.length,runDir:n,canRerun:Di(n,l),...c?{scriptSnapshotPath:c}:{},...d?{manifestSnapshotPath:d}:{},...typeof l.startedAt=="number"?{startedAt:l.startedAt}:{},...typeof l.endedAt=="number"?{endedAt:l.endedAt}:{},...a?{error:a}:{},artifacts:ad(l.artifacts),events:r}}catch{return{runId:o,workflow:"?",status:a?"failed":"unknown",totalSpawned:r.filter(l=>l.type==="agent_spawned").length,eventCount:r.length,runDir:n,canRerun:!1,artifacts:[],events:r,...a?{error:a}:{}}}}}i(Co,"readWorkflowRunDetail");function Ro(e){return e==="completed"?R.green("ok"):e==="failed"?R.red("x"):e==="running"?R.cyan("run"):e==="paused"?R.yellow("pause"):e==="stopped"?R.dim("stop"):e==="denied"?R.dim("deny"):e==="cancelled"?R.dim("cancel"):R.dim("-")}i(Ro,"statusIcon");function Tt(e){return nd.has(e)}i(Tt,"isTerminalWorkflowStatus");function Ui(e){if(!e)return;let o=[];return e.displayName&&e.displayName!==e.workflowName&&o.push(`display: ${e.displayName}`),e.source&&o.push(`source: ${e.source}`),e.savedWorkflowName&&o.push(`saved: ${e.savedWorkflowName}`),e.revisionOf&&o.push(`revision of: ${e.revisionOf}`),o.length>0?o.join(", "):void 0}i(Ui,"formatProcessListMeta");function Pt(e,o={}){if(e.length===0)return" (no workflow runs yet)";let n=o.limit===void 0?void 0:Math.max(1,Math.floor(o.limit)),t=n===void 0?e:e.slice(0,n);if(o.processSnapshots){let a=t.map(l=>{let c=Ui(o.processSnapshots?.get(l.runId));return` ${Ro(l.status)} ${R.cyan(l.workflow)} ${R.dim(l.runId)} - ${l.status} (${l.totalSpawned} agents)${c?R.dim(` [${c}]`):""}`});return o.showLimitHint===!0&&n!==void 0&&e.length>t.length&&a.push(R.dim(` Showing ${t.length} of ${e.length} persisted runs. Use /workflow runs --all to show all.`)),a.join(`
|
|
179
|
+
`)}let r=t.map(a=>` ${Ro(a.status)} ${R.cyan(a.workflow)} ${R.dim(a.runId)} \u2014 ${a.status} (${a.totalSpawned} agents)`);return o.showLimitHint===!0&&n!==void 0&&e.length>t.length&&r.push(R.dim(` Showing ${t.length} of ${e.length} persisted runs. Use /workflow runs --all to show all.`)),r.join(`
|
|
180
|
+
`)}i(Pt,"formatRunsList");function Lt(e,o={}){return e.length===0?" (no active workflow runs)":o.processSnapshots?e.map(n=>{let t=Ui(o.processSnapshots?.get(n.runId));return` ${Ro(n.status)} ${R.cyan(n.workflow)} ${R.dim(n.runId)} - ${n.status} (${n.totalSpawned} agents, ${n.eventCount} events)${t?R.dim(` [${t}]`):""}`}).join(`
|
|
181
|
+
`):e.map(n=>` ${Ro(n.status)} ${R.cyan(n.workflow)} ${R.dim(n.runId)} - ${n.status} (${n.totalSpawned} agents, ${n.eventCount} events)`).join(`
|
|
182
|
+
`)}i(Lt,"formatManagedRunsList");function Je(e){return e.status==="running"||e.status==="paused"}i(Je,"isActiveManagedWorkflowRun");function Mt(e){return e.length===0?" (no workflow runs match the cleanup rule)":e.map(o=>` ${Ro(o.status)} ${R.cyan(o.workflow)} ${R.dim(o.runId)} - ${o.status}`).join(`
|
|
183
|
+
`)}i(Mt,"formatWorkflowPruneCandidates");function _t(e,o){return e.filter(Je)[0]?.runId??e[0]?.runId??o[0]?.runId}i(_t,"selectDefaultWorkflowRunId");function Wt(e){return e.find(Je)?.runId}i(Wt,"selectDefaultActiveWorkflowRunId");function Ni(e){if(e!==void 0)return typeof e=="number"?new Date(e).toLocaleString():e}i(Ni,"formatTime");function cd(e,o=10){let n=e.map(kn).filter(t=>t!==void 0);return n.slice(Math.max(0,n.length-o))}i(cd,"formatRecentWorkflowEvents");function Ot(e,o){return o?.canRerun??(e?.runDir?Di(e.runDir):!1)}i(Ot,"canRerunWorkflowRun");function dd(e){return e?e.artifacts.map(o=>({name:o,path:J(e.runDir,"artifacts",`${Yr(o)}.json`)})):[]}i(dd,"workflowArtifactRefs");function Nt(e,o){return o?`/workflow show ${e} | /workflow rerun ${e}`:`/workflow show ${e}`}i(Nt,"formatWorkflowNextActions");function ji(e,o){return o?`Use /workflow show ${e} for events. /workflow revise ${e} <change> can repair the saved script; /workflow rerun ${e} repeats it unchanged.`:`Use /workflow show ${e} for events.`}i(ji,"formatWorkflowFailureAction");function Dt(e,o,n={}){let t=n.processSnapshot;if(!e&&!o&&!t)return" (unknown workflow run)";let r=t?.workflowName??e?.workflow??o?.workflow??"?",a=t?.runId??e?.runId??o?.runId??"?",l=t?.status??e?.status??o?.status??"?",c=t?.progress.spawnedAgents??e?.totalSpawned??o?.totalSpawned??0,d=e?.eventCount??o?.eventCount??0,u=e?.runDir??o?.runDir??"",f=Ni(e?.startedAt??o?.startedAt??t?.startedAt),m=t&&t.status!=="running"&&t.status!=="paused"?t.updatedAt:void 0,b=Ni(e?.endedAt??o?.endedAt??m),S=t?.error??e?.error??o?.error,C=o?.artifacts??t?.artifacts?.map(le=>le.name)??[],A=dd(o),v=e?.resultText,x=n.full===!0||v===void 0?Ye(A,Ce(r),{full:n.full===!0}):void 0,M=n.full===!0?x??v??t?.resultSummary:v!==void 0?we(v):t?.resultSummary!==void 0?we(t.resultSummary):x,O=M?Ve(M,a,Ce(M)):void 0,_e=n.full===!0||!M||!xt(M)?"result:":"result preview:",We=o?cd(o.events):[],io=Ot(e,o);return[` ${R.cyan(r)} ${R.dim(a)}`,...t?.displayName&&t.displayName!==r?[` display name: ${t.displayName}`]:[],` status: ${l}`,...t?.source?[` source: ${t.source}`]:[],...t?.savedWorkflowName?[` saved workflow: ${t.savedWorkflowName}`]:[],...t?.sourceRunId?[` source run: ${t.sourceRunId}`]:[],...t?.sourceWorkflowName?[` source workflow: ${t.sourceWorkflowName}`]:[],...t?.revisionOf?[` revision of: ${t.revisionOf}`]:[],` agents: ${c}`,` events: ${d}`,...f?[` started: ${f}`]:[],...b?[` ended: ${b}`]:[],...u?[` run dir: ${u}`]:[],...C.length>0?[` artifacts: ${C.join(", ")}`]:[],...S?[` error: ${S}`]:[],...O?["",` ${_e}`,...O.split(`
|
|
184
|
+
`).map(le=>` ${le}`)]:[],...We.length>0?[""," recent events:",...We.map(le=>` ${le.trimEnd()}`)]:[],"",` next: ${Nt(a,io)}`].join(`
|
|
185
|
+
`)}i(Dt,"formatWorkflowRunSnapshot");function Ut(e){return{project:J(e,".kodax","workflows"),personal:_("workflows")}}i(Ut,"savedWorkflowDirs");async function Fi(e,o){return new Set((await je(e)).map(t=>t.name)).has(o)?`${o}-revision-${Date.now().toString(36)}`:o}i(Fi,"nextRevisionWorkflowName");function Hi(e){let o=e.resolution.kind==="run"?e.resolution.runId:e.capsule.provenance?.fromRunId,n=e.resolution.kind==="saved"?e.resolution.savedWorkflow.name:e.capsule.provenance?.fromWorkflowName,t=e.resolution.kind==="run"?e.resolution.runId:e.resolution.kind==="saved"?e.resolution.savedWorkflow.name:void 0;return{...o!==void 0?{fromRunId:o}:{},...n!==void 0?{fromWorkflowName:n}:{},...t!==void 0?{revisionOf:t}:{},...e.replacesWorkflowName!==void 0?{replacesWorkflowName:e.replacesWorkflowName}:{},createdAt:new Date().toISOString(),kodaxVersion:ls}}i(Hi,"buildWorkflowRevisionProvenance");function jt(e){return e.length===0?" (no saved workflows)":e.map(o=>` ${R.cyan(o.name)} ${R.dim(`(${o.source}, ${o.execution}: ${o.path})`)}`).join(`
|
|
186
|
+
`)}i(jt,"formatSavedList");function Bi(e){return/^[a-zA-Z0-9._-]{1,120}$/.test(e)&&!e.startsWith(".")&&!e.includes("..")}i(Bi,"isSafeWorkflowRunId");function Ie(e){if(e.confirm)return e.confirm;let o=e.readline;if(o)return n=>new Promise(t=>{o.question(`${n} (y/N) `,r=>t(/^y(es)?$/i.test(r.trim())))})}i(Ie,"resolveConfirm");function ud(e){console.log(R.red(`
|
|
187
|
+
[workflow] invalid run id: ${e||"<empty>"}
|
|
188
|
+
`))}i(ud,"printInvalidRunId");function he(e){return Bi(e)?!0:(ud(e),!1)}i(he,"ensureSafeRunId");function hn(){let e=fd(process.cwd());return{isGitRepo:e,worktreeCapable:e}}i(hn,"currentWorkflowPreflightEnv");function fd(e){let o=e;for(;;){if(re(J(o,".git")))return!0;let n=od(o);if(n===o)return!1;o=n}}i(fd,"hasGitMarker");function yn(e){console.log(R.red(`
|
|
189
|
+
[workflow] capsule preflight failed:`));for(let o of e.issues)console.log(R.red(` - ${o.requirement}: ${o.message}`));console.log()}i(yn,"printPreflightFailure");function vn(e){let o=e.issues.filter(n=>n.severity==="warning");if(o.length!==0){console.log(R.yellow(`
|
|
190
|
+
[workflow] capsule preflight warnings:`));for(let n of o)console.log(R.yellow(` - ${n.requirement}: ${n.message}`));console.log()}}i(vn,"printPreflightWarnings");async function Ki(e,o){if(e.execution==="trusted-local"&&!await o(`Run local workflow file? This EXECUTES local code:
|
|
191
|
+
${e.path}`)){console.log(R.dim(`Workflow cancelled.
|
|
192
|
+
`));return}try{let n={source:`saved:${e.source}`,sandbox:e.execution,mayUseWorktree:!1},t,r;if(e.execution==="capability-generated"){let l=await uo(e.path),c=fo(l,hn());if(!c.ok){yn(c);return}vn(c),n={source:`saved:${e.source}`,sandbox:e.execution,mayUseWorktree:l.manifest.mayUseWorktree===!0,rawScriptPath:e.path,rawScript:l.source},t={manifest:l.manifest,source:l.source},r=l.provenance}return{module:await zo(e.path),approvalContext:n,...t!==void 0?{scriptSnapshot:t}:{},...r!==void 0?{provenance:r}:{}}}catch(n){let t=n instanceof Error?n.message:String(n);console.log(R.red(`
|
|
193
|
+
[workflow] failed to load ${e.path}: ${t}
|
|
194
|
+
`));return}}i(Ki,"prepareSavedWorkflow");function Ft(e){let o=e.data?.status;return typeof o=="string"?o:void 0}i(Ft,"workflowEventStatus");function kn(e){let o=e.data?.name??e.data?.taskId??"",n=Ft(e);switch(e.type){case"phase_started":return` > phase: ${e.data?.name??""}`;case"phase_finished":return` done phase: ${e.data?.name??""}`;case"agent_spawned":return` + ${o}`;case"agent_completed":return n==="failed"?` failed ${o}`:n==="completed_unverified"?` unverified ${o}`:` done ${o}`;case"agent_unverified":return` unverified ${o}`;case"agent_failed":return` failed ${o}`;case"agent_stopped":return` stopped ${o}`;case"workflow_log":return` log ${e.data?.message??""}`;case"artifact_written":return` artifact ${e.data?.name??""}`;case"synthesis_completed":return" synthesis complete";case"workflow_completed":return" workflow completed";case"workflow_stopped":return" workflow stopped";case"workflow_failed":return` workflow failed: ${e.data?.error??"unknown error"}`;default:return}}i(kn,"formatWorkflowEvent");function Gi(e){let o=kn(e);o&&console.log(R.dim(o))}i(Gi,"renderWorkflowEvent");import Sn from"chalk";import md from"string-width";var pd=9;function gd(e,o=pd){let n=md(e);return n>=o?e:`${e}${" ".repeat(o-n)}`}i(gd,"padWorkflowLiveSymbol");function Xi(e,o={}){let n=e.items.filter(m=>m.kind==="agent"),t=n.filter(m=>m.status==="running").map(m=>m.title),r=n.filter(m=>m.status==="completed").length,a=n.filter(m=>m.status==="failed").length,l=n.filter(m=>m.status==="cancelled").length,c=e.status==="completed"?"completed":e.status==="failed"?"failed":e.status==="cancelled"?"stopped":"running",d=e.activePhaseId===void 0?void 0:e.items.find(m=>m.id===e.activePhaseId)?.title,u=Date.parse(e.startedAt),f=o.message??e.latestMessage;return{runId:e.runId,workflow:e.displayName??e.workflowName,status:c,...d!==void 0?{phase:d}:{},...e.activePhaseIndex!==void 0?{phaseIndex:e.activePhaseIndex}:{},...e.phaseCount!==void 0?{phaseTotal:e.phaseCount}:{},...Number.isFinite(u)?{startedAt:u}:{},elapsedMs:e.elapsedMs,activeAgents:t,totalSpawned:e.progress.spawnedAgents,...e.progress.plannedItems!==void 0?{plannedAgents:e.progress.plannedItems}:{},...e.progress.agentCap!==void 0?{agentCap:e.progress.agentCap}:{},...e.tokens!==void 0?{tokenBudgetSpent:e.tokens.spent}:{},...e.tokens?.total!==void 0?{tokenBudgetTotal:e.tokens.total}:{},completedAgents:r,failedAgents:a,stoppedAgents:l,...f!==void 0?{message:f}:{},...o.locale!==void 0?{locale:o.locale}:{}}}i(Xi,"workflowLiveSnapshotFromProcess");function Jg(e){return!e.shouldRender||e.rows.length===0?[]:e.rows.map(o=>`${gd(o.symbol)}${o.text}`)}i(Jg,"formatWorkflowLiveViewModelForTranscript");var wd=6,qi={en:{workflow:"workflow",phase:"phase",agent:"agent",more:"more",progress:"progress",waiting:"waiting",hint:"hint",finished:"finished",failed:"failed",stopped:"stopped",started:"started",cap:"cap",budget:"budget",spent:"spent",waitingForFirstAgent:"waiting for first agent",showStopHint:i(e=>`show: /workflow show ${e} | stop: /workflow stop ${e}`,"showStopHint"),activeAgents:i(e=>`${e} active agent${e===1?"":"s"}`,"activeAgents")},zh:{workflow:"\u5DE5\u4F5C\u6D41",phase:"\u9636\u6BB5",agent:"\u667A\u80FD\u4F53",more:"\u66F4\u591A",progress:"\u8FDB\u5EA6",waiting:"\u7B49\u5F85",hint:"\u63D0\u793A",finished:"\u5B8C\u6210",failed:"\u5931\u8D25",stopped:"\u505C\u6B62",started:"\u5DF2\u542F\u52A8",cap:"\u4E0A\u9650",budget:"\u9884\u7B97",spent:"\u5DF2\u7528",waitingForFirstAgent:"\u7B49\u5F85\u7B2C\u4E00\u4E2A\u667A\u80FD\u4F53\u542F\u52A8",showStopHint:i(e=>`\u67E5\u770B: /workflow show ${e} | \u505C\u6B62: /workflow stop ${e}`,"showStopHint"),activeAgents:i(e=>`${e} \u4E2A\u667A\u80FD\u4F53\u8FD0\u884C\u4E2D`,"activeAgents")}},hd={shouldRender:!1,workflow:"",runId:"",activeCount:0,totalSpawned:0,completedAgents:0,failedAgents:0,stoppedAgents:0,rows:[]};function yd(e){return e.length>14?`${e.slice(0,14)}...`:e}i(yd,"shortRunId");function bn(e){return e==="zh"?qi.zh:qi.en}i(bn,"workflowLiveLabels");function vd(e,o){let n=Math.max(0,Math.floor(e)),t=Math.floor(n/1e3),r=t%60,a=Math.floor(t/60),l=a%60,c=Math.floor(a/60);return o==="zh"?c>0?`${c}\u5C0F\u65F6${String(l).padStart(2,"0")}\u5206`:l>0?`${l}\u5206${String(r).padStart(2,"0")}\u79D2`:`${r}\u79D2`:c>0?`${c}h${l}m${r}s`:l>0?`${l}m${r}s`:`${r}s`}i(vd,"formatElapsedMs");function zi(e){let o=Math.max(0,Math.floor(e));return o>=1e6?`${(o/1e6).toFixed(1).replace(/\.0$/,"")}M`:o>=1e3?`${(o/1e3).toFixed(1).replace(/\.0$/,"")}k`:String(o)}i(zi,"formatTokenCount");function kd(e){if(e.tokenBudgetSpent===void 0)return;let o=bn(e.locale),n=zi(e.tokenBudgetSpent);if(e.tokenBudgetTotal!==void 0&&Number.isFinite(e.tokenBudgetTotal)){let t=zi(e.tokenBudgetTotal);return e.tokenBudgetSpent<=0?`${o.budget} ${t} tokens`:`${o.spent} ${n}/${t} tokens`}if(!(e.tokenBudgetSpent<=0))return`${o.spent} ${n} tokens`}i(kd,"formatWorkflowTokenUsage");function bd(e,o){let n=[],t=e.startedAt===void 0?e.elapsedMs:o-e.startedAt;t!==void 0&&n.push(vd(t,e.locale));let r=kd(e);return r!==void 0&&n.push(r),n}i(bd,"formatWorkflowHeaderMetrics");function Sd(e){let o=bn(e.locale),n=e.completedAgents+e.failedAgents+e.stoppedAgents;if(e.totalSpawned===0&&n===0)return;let t=Vi(e,n),r=[];e.activeAgents.length>0&&r.push(o.activeAgents(e.activeAgents.length)),e.plannedAgents!==void 0&&r.push(`${o.started} ${e.totalSpawned}`),e.failedAgents>0&&r.push(`${e.failedAgents} ${o.failed}`),e.stoppedAgents>0&&r.push(`${e.stoppedAgents} ${o.stopped}`),e.agentCap!==void 0&&r.push(`${o.cap} ${e.agentCap}`);let a=r.length===0?"":e.locale==="zh"?`\uFF08${r.join("\uFF0C")}\uFF09`:` (${r.join(", ")})`;return`${n}/${t} ${o.finished}${a}`}i(Sd,"formatWorkflowProgress");function $d(e){let o=bn(e.locale);if(e.totalSpawned===0)return o.waiting;let n=e.activeAgents.length,t=Vi(e),r=e.locale==="zh"?`${n}/${t} \u4E2A\u667A\u80FD\u4F53\u8FD0\u884C\u4E2D`:`${n}/${t} active agent${n===1?"":"s"}`,a=[];return e.failedAgents>0&&a.push(`${e.failedAgents} ${o.failed}`),e.stoppedAgents>0&&a.push(`${e.stoppedAgents} ${o.stopped}`),a.length===0?r:e.locale==="zh"?`${r}\uFF0C${a.join("\uFF0C")}`:`${r}, ${a.join(", ")}`}i($d,"formatWorkflowCounter");function Vi(e,o){let n=o??e.completedAgents+e.failedAgents+e.stoppedAgents;return Math.max(e.plannedAgents??0,e.totalSpawned,n)}i(Vi,"workflowProgressDenominator");function xd(e){if(e.phase)return e.phaseIndex!==void 0&&e.phaseTotal!==void 0&&e.phaseIndex>0&&e.phaseTotal>0?`${e.phaseIndex}/${e.phaseTotal} ${e.phase}`:e.phase}i(xd,"formatWorkflowPhase");function Zg(e,o=Date.now()){if(!e||e.status!=="running")return hd;let n=[],t=bn(e.locale),r=bd(e,o),a=r.length===0?"":` \xB7 ${r.join(" \xB7 ")}`;n.push({kind:"header",id:"header",symbol:t.workflow,symbolColor:e.failedAgents>0?"red":"cyan",text:`${e.workflow} (${yd(e.runId)}) - ${t.activeAgents(e.activeAgents.length)}${a}`,isActive:!0});let l=xd(e);l&&n.push({kind:"phase",id:"phase",symbol:t.phase,symbolColor:"cyan",text:l,isActive:!0});let c=Sd(e);c&&n.push({kind:"summary",id:"progress",symbol:t.progress,symbolColor:e.failedAgents>0?"red":"green",text:c,isActive:!1}),e.totalSpawned===0&&e.activeAgents.length===0&&n.push({kind:"summary",id:"waiting",symbol:t.waiting,symbolColor:"dim",text:t.waitingForFirstAgent,isActive:!1}),n.push({kind:"hint",id:"controls",symbol:t.hint,symbolColor:"dim",text:e.message??t.showStopHint(e.runId),isActive:!1});let d=n.slice(0,wd);return{shouldRender:!0,workflow:e.workflow,runId:e.runId,...e.phase!==void 0?{phase:e.phase}:{},...e.phaseIndex!==void 0?{phaseIndex:e.phaseIndex}:{},...e.phaseTotal!==void 0?{phaseTotal:e.phaseTotal}:{},activeCount:e.activeAgents.length,totalSpawned:e.totalSpawned,...e.plannedAgents!==void 0?{plannedAgents:e.plannedAgents}:{},completedAgents:e.completedAgents,failedAgents:e.failedAgents,stoppedAgents:e.stoppedAgents,counterText:$d(e),rows:d}}i(Zg,"buildWorkflowLiveViewModel");function Ad(e,o){return o!==0?!1:e.name==="WorkflowScriptExecutionError"||/restricted workflow script|workflow generation source|workflow command .* must|unsupported workflow command/i.test(e.message)}i(Ad,"isWorkflowHarnessFailure");function Ht(e){let o=ji(e.runId,e.canRerun),n=e.partialResultText?Ve(e.partialResultText,e.runId,e.locale??"en"):void 0,t=n?["","Partial results before failure:",n]:[];return Ad(e.error,e.totalSpawned)?[`Workflow harness failed before launching child agents (${e.runId}): ${e.error.message}`,"This points to an invalid generated workflow script or saved capsule, not a failed child-agent task.",...t,o].join(`
|
|
195
|
+
`):[`Workflow failed (${e.runId}): ${e.error.message}`,...t,o].join(`
|
|
196
|
+
`)}i(Ht,"formatWorkflowFailedMessage");function Rd(e,o,n){return Ye(e.artifacts,o,n)??Ao(e.events,n)}i(Rd,"formatWorkflowFailurePartialResult");function $n(e){let o=e?.usage;if(typeof o!="object"||o===null)return 0;let n=o,t=n.totalTokens;if(typeof t=="number"&&Number.isFinite(t)&&t>0)return t;let r=n.inputTokens,a=n.outputTokens,l=typeof r=="number"&&Number.isFinite(r)&&r>0?r:0,c=typeof a=="number"&&Number.isFinite(a)&&a>0?a:0;return l+c}i($n,"readWorkflowEventUsageTokens");function D(e,o){if(e.onWorkflowRunMessage){e.onWorkflowRunMessage(o);return}if(o.type==="error"){console.log(Sn.red(`
|
|
197
|
+
${o.text}
|
|
198
|
+
`));return}if(o.type==="success"){console.log(Sn.green(`
|
|
199
|
+
${o.text}
|
|
200
|
+
`));return}if(o.type==="event"){console.log(Sn.dim(o.text));return}if(o.type==="assistant"){console.log(`
|
|
201
|
+
${o.text}
|
|
202
|
+
`);return}console.log(Sn.dim(`
|
|
203
|
+
${o.text}
|
|
204
|
+
`))}i(D,"emitWorkflowRunMessage");function Ze(e,o,n={}){let t=n.presentation==="agentic"?mn(n.runId??"current"):void 0,r=!1;return a=>{if(r&&(a.type==="agent_completed"||a.type==="agent_unverified"||a.type==="agent_failed"||a.type==="agent_summary_updated"))return;o?.onEvent(a);let l=kn(a);if(e.onWorkflowRunMessage){if(l&&D(e,{type:"event",text:l}),t){let c=t(a,n.locale??"en");c&&D(e,{type:"assistant",text:c,final:!1})}(a.type==="workflow_completed"||a.type==="workflow_failed"||a.type==="workflow_stopped")&&(r=!0);return}(a.type==="workflow_completed"||a.type==="workflow_failed"||a.type==="workflow_stopped")&&(r=!0),l&&Gi(a)}}i(Ze,"workflowEventSink");function Qe(e,o,n){return e.subscribeWorkflowProcess(t=>{t.snapshot.runId===n&&o.onProcessEvent(t)})}i(Qe,"subscribeWorkflowLiveProcess");function Te(e,o,n,t="en"){let r=Date.now(),a=new Map,l,c=0,d=0,u=0,f=0,m=0,b=!1,S=n.phases??[],C=n.tokenBudget!==void 0&&Number.isFinite(n.tokenBudget)?n.tokenBudget:void 0,A=i((v,x)=>{let M=l===void 0?-1:S.indexOf(l),O=M>=0?M+1:void 0,_e=S.length>0?S.length:void 0;e.onWorkflowRunUpdate?.({runId:o,workflow:n.name,status:v,...l!==void 0?{phase:l}:{},...O!==void 0?{phaseIndex:O}:{},..._e!==void 0?{phaseTotal:_e}:{},startedAt:r,elapsedMs:Math.max(0,Date.now()-r),activeAgents:[...a.values()],totalSpawned:c,...n.plannedAgents!==void 0?{plannedAgents:n.plannedAgents}:{},...n.maxAgents!==void 0?{agentCap:n.maxAgents}:{},tokenBudgetSpent:m,...C!==void 0?{tokenBudgetTotal:C}:{},completedAgents:d,failedAgents:u,stoppedAgents:f,...x!==void 0?{message:x}:{},locale:t})},"emit");return{running:i(v=>{b||A("running",v)},"running"),onProcessEvent:i(v=>{if(b&&v.type!=="workflow_finished")return;let x=v.snapshot.status;(v.type==="workflow_finished"||x==="completed"||x==="failed"||x==="cancelled")&&(b=!0);let M=v.type==="workflow_updated"?v.message:void 0;e.onWorkflowRunUpdate?.(Xi(v.snapshot,M===void 0?{locale:t}:{locale:t,message:M}))},"onProcessEvent"),onEvent:i(v=>{if(!b)switch(v.type){case"phase_started":{let x=v.data?.name;l=typeof x=="string"?x:l,A("running");break}case"agent_spawned":{let x=typeof v.data?.taskId=="string"?v.data.taskId:`task-${c+1}`,M=typeof v.data?.name=="string"?v.data.name:x;a.set(x,M),c+=1,A("running");break}case"agent_completed":{let x=typeof v.data?.taskId=="string"?v.data.taskId:void 0;x&&a.delete(x),m+=$n(v.data),Ft(v)==="failed"?u+=1:d+=1,A("running");break}case"agent_unverified":{let x=typeof v.data?.taskId=="string"?v.data.taskId:void 0;x&&a.delete(x),m+=$n(v.data),d+=1,A("running");break}case"agent_failed":{let x=typeof v.data?.taskId=="string"?v.data.taskId:void 0;x&&a.delete(x),m+=$n(v.data),u+=1,A("running");break}case"agent_stopped":{let x=typeof v.data?.taskId=="string"?v.data.taskId:void 0;x&&a.delete(x),m+=$n(v.data),f+=1,A("running");break}case"synthesis_completed":{A("running","synthesis complete");break}default:break}},"onEvent"),complete:i((v,x)=>{b||(b=!0,A(v,x))},"complete")}}i(Te,"createWorkflowLiveUpdateEmitter");function Pe(e,o,n,t,r={}){e.done.then(a=>{if(a.kind==="failed"){if(e.getSnapshot?.()?.status==="stopped"){t?.complete("stopped","Workflow stopped by user.");return}let l=r.locale??"en",c={full:r.presentation==="agentic"},d=Rd(a.state,l,c),u=Ht({runId:n,error:a.error,canRerun:r.canRerun===!0,totalSpawned:a.state.totalSpawned,...d!==void 0?{partialResultText:d}:{},locale:l});t?.complete("failed",a.error.message),D(o,{type:"error",text:r.presentation==="agentic"&&d!==void 0?Ht({runId:n,error:a.error,canRerun:r.canRerun===!0,totalSpawned:a.state.totalSpawned,locale:l}):u}),r.presentation==="agentic"&&d!==void 0&&D(o,{type:"assistant",text:u,final:!0});return}if(a.kind==="completed"){let l=r.locale??"en",c={full:r.presentation==="agentic"},d=we(a.result,c)??Ye(a.state.artifacts,l,c),u=d===void 0?Ao(a.state.events,c):void 0,f=d??u;if(t?.complete("completed",f?"completed with result":"completed"),r.presentation==="agentic"){D(o,{type:"assistant",text:At({runId:n,totalSpawned:a.state.totalSpawned,...f!==void 0?{resultText:f}:{},...d===void 0&&u!==void 0?{isFallbackPreview:!0}:{},locale:l}),final:!0});return}D(o,{type:"success",text:[`Workflow completed (${a.state.totalSpawned} agents, run ${n}).`,`Use /workflow show ${n} for the event timeline.`].join(`
|
|
205
|
+
`)}),f&&D(o,{type:"info",text:`Workflow result:
|
|
206
|
+
${f}`})}}).catch(a=>{let l=a instanceof Error?a.message:String(a);if(e.getSnapshot?.()?.status==="stopped"){t?.complete("stopped","Workflow stopped by user.");return}t?.complete("failed",l),D(o,{type:"error",text:Ht({runId:n,error:a instanceof Error?a:new Error(l),canRerun:r.canRerun===!0})})})}i(Pe,"observeManagedWorkflowDone");function Le(e,o){e.done.finally(()=>{try{o()}catch{}}).catch(()=>{})}i(Le,"unsubscribeWorkflowLiveProcessOnDone");function ye(e,o){if(e.onBuilderEvent?.(o),o.stage==="failed"){D(e.callbacks,{type:"error",text:`Workflow builder failed: ${o.message}`});return}!e.onBuilderEvent&&(o.stage==="started"||o.stage==="generating"||o.stage==="validating"||o.stage==="ready")&&console.log(xn.dim(`
|
|
207
|
+
[workflow] ${o.message}
|
|
208
|
+
`))}i(ye,"emitWorkflowBuilderEvent");function Io(e){return{source:e.source,displayName:e.displayName,...e.goal!==void 0?{goal:e.goal}:{},...e.savedWorkflowName!==void 0?{savedWorkflowName:e.savedWorkflowName}:{},...e.sourceRunId!==void 0?{sourceRunId:e.sourceRunId}:{},...e.sourceWorkflowName!==void 0?{sourceWorkflowName:e.sourceWorkflowName}:{},...e.revisionOf!==void 0?{revisionOf:e.revisionOf}:{},...e.hostMetadata!==void 0?{hostMetadata:{...e.hostMetadata}}:{}}}i(Io,"buildWorkflowProcessMetadata");async function Cd(e){let o=e.approval==="required"?Ie(e.callbacks):void 0;if(e.approval==="required"&&!o)return console.log(xn.red(`
|
|
209
|
+
[workflow] refusing to start a workflow without an interactive approval channel.
|
|
210
|
+
`)),"failed";let n=e.callbacks.createKodaXOptions;if(!n)return console.log(xn.red(`
|
|
211
|
+
[workflow] cannot start - REPL options unavailable in this context.
|
|
212
|
+
`)),"failed";let t=Ce(e.request),r,a;try{if(ye(e,{stage:"started",message:"Workflow builder started"}),r=n(),e.builtin){let v=Go(e.builtin.name);if(!v)throw new Error(`unknown built-in workflow: ${e.builtin.name}`);a={module:v,args:e.builtin.args,approvalDescription:v.meta.description,mayUseWorktree:!1,sandbox:"built-in"}}else{ye(e,{stage:"generating",message:"Workflow - generating harness"});let x=await(e.generateWorkflow??Ko)({request:e.request,options:r});if(x.kind==="declined")return ye(e,{stage:"declined",message:x.reason}),console.log(xn.dim(`
|
|
213
|
+
Workflow not created: ${x.reason}
|
|
214
|
+
`)),"declined";a={module:x.module,args:{request:e.request},approvalDescription:x.approvalSummary,mayUseWorktree:x.manifest.mayUseWorktree===!0,sandbox:"capability-generated",scriptSnapshot:x.scriptSnapshot,rawScript:x.scriptSnapshot.source}}ye(e,{stage:"validating",message:"Workflow - validating harness"})}catch(v){let x=v instanceof Error?v.message:String(v);return ye(e,{stage:"failed",message:x}),"failed"}ye(e,{stage:"ready",message:"Workflow - harness ready"});let l=e.presentation??"command",c=ke(a.module);l!=="agentic"&&D(e.callbacks,{type:"info",text:`${e.builtin?"Built-in":"Generated"} workflow: ${a.approvalDescription}`});let d=Re(process.cwd()).key,u=e.runBaseDir??_("workflow-runs",d),f=e.runManager??Fe(),m=`run-${Date.now().toString(36)}`,b=Ed(u,m);if(o){if(!await o(se(c,{source:e.sourceLabel??"generated",sandbox:a.sandbox,mayUseWorktree:a.mayUseWorktree,...a.rawScript!==void 0?{rawScript:a.rawScript}:{}})))return ye(e,{stage:"cancelled",message:"Workflow cancelled"}),D(e.callbacks,{type:"info",text:"Workflow cancelled."}),"cancelled"}else l!=="agentic"&&(D(e.callbacks,{type:"info",text:se(c,{source:e.sourceLabel??"generated",sandbox:a.sandbox,mayUseWorktree:a.mayUseWorktree})}),D(e.callbacks,{type:"info",text:`Auto-started ${e.builtin?"built-in":"generated"} workflow (${a.sandbox}); normal permission gates still apply.`}));l==="agentic"?D(e.callbacks,{type:"assistant",text:Rt({runId:m,summary:c,approvalSummary:a.approvalDescription,locale:t}),final:!1}):D(e.callbacks,{type:"info",text:`Started workflow ${a.module.meta.name} (${m}). Use /workflow show ${m} for status.`});let S=Te(e.callbacks,m,a.module.meta,t);S.running(`Use /workflow show ${m} for status or /workflow stop ${m} to stop.`);let C=Qe(f,S,m),A=f.startFromOptions({module:a.module,args:a.args,options:r,runId:m,runDir:b,...a.scriptSnapshot!==void 0?{scriptSnapshot:a.scriptSnapshot}:{},processMetadata:Io({source:e.processSource??"command",displayName:a.module.meta.name,goal:e.request,hostMetadata:{workflowAuthorship:"kodax-generated"}}),onEvent:Ze(e.callbacks,void 0,{presentation:e.presentation??"command",locale:t,runId:m})});return Le(A,C),ye(e,{stage:"launched",message:`Workflow ${a.module.meta.name} started`}),Pe(A,e.callbacks,m,S,{canRerun:!0,presentation:l,locale:t}),"started"}i(Cd,"startGeneratedWorkflowFromRequest");function Bt(e){let o=e[0]?.toLowerCase();if(o==="help"||o==="--help"||o==="-h")return{kind:"help"};if(!o||o==="list")return{kind:"list"};if(o==="runs")return{kind:"runs",rawArgs:e.slice(1)};if(o==="show"){let n=e.slice(1),t=n.includes("--full"),r=n.find(a=>a!=="--full")??"";return t?{kind:"show",runId:r,full:!0}:{kind:"show",runId:r}}if(o==="pause")return{kind:"pause",runId:e[1]??""};if(o==="resume")return{kind:"resume",runId:e[1]??""};if(o==="stop")return{kind:"stop",runId:e[1]??""};if(o==="delete"){let n=e.slice(1),t=n.includes("--force"),r=n.includes("--saved"),a=n.includes("--run"),l=n.find(d=>d!=="--force"&&d!=="--saved"&&d!=="--run")??"",c=r&&a?"conflict":r?"saved":a?"run":void 0;return{kind:"delete",target:l,...t?{force:!0}:{},...c?{scope:c}:{}}}if(o==="prune")return{kind:"prune",rawArgs:e.slice(1)};if(o==="save")return{kind:"save",runId:e[1]??"",name:e[2]??""};if(o==="rename")return{kind:"rename",target:e[1]??"",newName:e.slice(2).join(" ").trim()};if(o==="revise"){let n=e.slice(1),t=n.includes("--replace"),r=n.filter(a=>a!=="--replace");return{kind:"revise",target:r[0]??"",request:r.slice(1).join(" ").trim(),...t?{replace:!0}:{}}}return o==="rerun"?{kind:"rerun",runId:e[1]??"",rawArgs:e.slice(2).join(" ").trim()}:o==="create"?{kind:"create",request:e.slice(1).join(" ").trim()}:{kind:"start",name:e[0],rawArgs:e.slice(1).join(" ").trim()}}i(Bt,"parseWorkflowInvocation");function To(e){let o=e.trim();if(!o)return{};if(o.startsWith("{"))try{return JSON.parse(o)}catch{return{question:o}}return{question:o}}i(To,"parseWorkflowArgs");function Kt(e){return["Revise this existing KodaX dynamic workflow capsule.","Return a complete revised workflow, not a patch.","Preserve the reusable workflow intent, safety requirements, and compatible args shape unless the requested change explicitly requires otherwise.","",`Target: ${e.target}`,"","Original manifest:",JSON.stringify(e.capsule.manifest,null,2),"","Original source:","```js",e.capsule.source,"```","",`Change request: ${e.changeRequest}`].join(`
|
|
215
|
+
`)}i(Kt,"buildWorkflowRevisionRequest");function Yi(e){if(!e)return;let o=Number(e);return Number.isInteger(o)&&o>=0?o:void 0}i(Yi,"parseNonNegativeInteger");function Gt(e){let o=!1,n=20;for(let t=0;t<e.length;t+=1){let r=e[t];if(r==="--all"){o=!0;continue}if(r==="--limit"){let a=Yi(e[t+1]);if(a===void 0||a<1)return{all:o,limit:n,error:"--limit expects a positive integer"};n=Math.min(a,200),t+=1;continue}return{all:o,limit:n,error:`unknown option: ${r??""}`}}return{all:o,limit:n}}i(Gt,"parseWorkflowRunsOptions");function Id(e){if(!e)return;let o=/^(\d+)([dh]?)$/i.exec(e.trim());if(!o)return;let n=Number(o[1]);return!Number.isInteger(n)||n<=0?void 0:(o[2]?.toLowerCase()||"d")==="h"?n*60*60*1e3:n*24*60*60*1e3}i(Id,"parseOlderThanMs");function qt(e){let o=!1,n,t;for(let r=0;r<e.length;r+=1){let a=e[r];if(a==="--dry-run"){o=!0;continue}if(a==="--keep"){let l=Yi(e[r+1]);if(l===void 0)return{dryRun:o,error:"--keep expects a non-negative integer"};n=l,r+=1;continue}if(a==="--older-than"){let l=Id(e[r+1]);if(l===void 0)return{dryRun:o,error:"--older-than expects a value like 7d or 24h"};t=l,r+=1;continue}return{dryRun:o,error:`unknown option: ${a??""}`}}return o&&n===void 0&&t===void 0?{dryRun:o,keep:50}:{dryRun:o,...n!==void 0?{keep:n}:{},...t!==void 0?{olderThanMs:t}:{}}}i(qt,"parseWorkflowPruneOptions");var Td=1440*60*1e3;function Pd(e){return new Map(e.map(o=>[o.runId,o]))}i(Pd,"processSnapshotsByRunId");function Ld(e){return{dryRun:e.dryRun,...e.keep!==void 0?{keep:e.keep}:{},...e.olderThanMs!==void 0?{olderThanDays:e.olderThanMs/Td}:{}}}i(Ld,"workflowPruneRetentionOptions");function Md(e,o){let n=new Map(e.map(t=>[t.runId,t]));return o.map(t=>{let r=n.get(t);return{runId:t,workflow:r?.workflow??"?",status:r?.status??"?",endedAt:r?.endedAt??0}})}i(Md,"workflowPruneCandidateSummaries");function Zi(e){return Io({source:"capsule",displayName:e.displayName,savedWorkflowName:e.savedWorkflowName,sourceRunId:e.provenance?.fromRunId,sourceWorkflowName:e.provenance?.fromWorkflowName??e.savedWorkflowName,revisionOf:e.provenance?.revisionOf})}i(Zi,"buildSavedWorkflowProcessMetadata");var Qi={name:"workflow",description:"Run a dynamic multi-agent workflow (FEATURE_217)",usage:"/workflow [help | list | pending | runs | show | pause | resume | stop | delete | prune | rerun | save | rename | revise | create | <name> [args] | <request>]",argumentHint:"help | list | pending | runs [--all|--limit N] | show [runId] | pause <runId> | resume <runId> | stop [runId] | delete [--force] [--run|--saved] <runId|savedName> | prune --dry-run|--keep N|--older-than Nd | rerun <runId|savedName> [args] | save <runId> <name> | rename <runId|alias|savedName> <newName> | revise [--replace] <runId|alias|savedName> <change> | create <request> | <name> [args]",detailedHelp:pn,handler:i(async(e,o,n,t)=>{if((e[0]??"").toLowerCase()==="pending"){await fn(un(o),"workflow");return}let r=Bt(e);if(t.agentMode==="sa"&&(r.kind==="create"||r.kind==="rerun"||r.kind==="start")){console.log(g.yellow(`
|
|
216
|
+
[workflow] Workflows run multiple agents, which Solo (SA) mode does not support.
|
|
217
|
+
Switch with /agent-mode ama, then request it explicitly via /workflow.
|
|
218
|
+
`));return}let a=Re(process.cwd()).key,l=_("workflow-runs",a),c=Fe(),d=Ut(process.cwd()),u=Qr({runManager:c,runBaseDir:l,savedWorkflowDirs:d}),f=i(async h=>({invocation:{source:"prompt",displayName:"workflow create",disableModelInvocation:!1,workflowIntent:"explicit",prompt:os(h)}}),"createWorkflowFromText");if(r.kind==="help"){pn();return}if(r.kind==="list"){console.log(g.bold(`
|
|
219
|
+
Built-in workflows:`)),console.log(It(qo())),console.log(g.bold(`
|
|
220
|
+
Pattern templates:`));for(let $ of es())console.log(` ${g.cyan($.name)} ${g.dim(`(${$.pattern})`)} - ${$.description}`);let h=await je(d);h.length>0&&(console.log(g.bold(`
|
|
221
|
+
Saved workflows:`)),console.log(jt(h))),console.log(g.dim(`
|
|
222
|
+
Run one with: /workflow <name> <question or JSON args>`)),console.log(g.dim(` Show usage with: /workflow help
|
|
223
|
+
`));return}if(r.kind==="runs"){let h=Gt(r.rawArgs);if(h.error){console.log(g.yellow(`
|
|
224
|
+
Usage: /workflow runs [--all] [--limit N]
|
|
225
|
+
${h.error}
|
|
226
|
+
`));return}let $=Pd(u.listWorkflowProcessSnapshots({activeOnly:!1})),k=c.list().filter(Je);k.length>0&&(console.log(g.bold(`
|
|
227
|
+
Active workflow runs:`)),console.log(Lt(k,{processSnapshots:$}))),console.log(g.bold(`
|
|
228
|
+
Workflow runs:`)),console.log(Pt(Eo(l),{limit:h.all?void 0:h.limit,showLimitHint:!h.all,processSnapshots:$})),console.log();return}if(r.kind==="show"){let h=Eo(l),$=r.runId||_t(c.list(),h);if(!$){console.log(g.yellow(`
|
|
229
|
+
No workflow runs yet. Start one with /workflow create <request>.
|
|
230
|
+
`));return}if(!he($))return;let k=c.get($),P=Co(l,$),I=u.getWorkflowProcessSnapshot($);console.log(g.bold(`
|
|
231
|
+
Workflow run:`)),console.log(Dt(k,P,{full:r.full===!0,...I?{processSnapshot:I}:{}})),console.log();return}if(r.kind==="pause"){if(!he(r.runId))return;let h=c.pause(r.runId);console.log(h?g.dim(`Paused workflow ${r.runId}.
|
|
232
|
+
`):g.yellow(`No running workflow ${r.runId}.
|
|
233
|
+
`));return}if(r.kind==="resume"){if(!he(r.runId))return;let h=c.resume(r.runId);console.log(h?g.dim(`Resumed workflow ${r.runId}.
|
|
234
|
+
`):g.yellow(`No paused workflow ${r.runId}.
|
|
235
|
+
`));return}if(r.kind==="stop"){let h=r.runId||Wt(c.list());if(!h){console.log(g.yellow(`
|
|
236
|
+
No active workflow to stop.
|
|
237
|
+
`));return}if(!he(h))return;let $=await u.stopWorkflow(h,"stopped by user"),k=c.get(h),P=Co(l,h),I=u.getWorkflowProcessSnapshot(h),U=k?.status??P?.status??I?.status,q=k?!Je(k):P?Tt(P.status):I!==void 0&&Fo(I.status),N=Nt(h,Ot(k,P));console.log($?g.dim(`Stopped workflow ${h}.
|
|
238
|
+
`):U&&q?g.yellow(`Workflow ${h} is already ${U}. Next: ${N}.
|
|
239
|
+
`):g.yellow(`No active workflow ${h}.
|
|
240
|
+
`));return}if(r.kind==="delete"){if(!r.target){console.log(g.yellow(`
|
|
241
|
+
Usage: /workflow delete [--force] [--run|--saved] <runId|savedName>
|
|
242
|
+
`));return}if(r.scope==="conflict"){console.log(g.red(`
|
|
243
|
+
[workflow] choose only one delete scope: --run or --saved.
|
|
244
|
+
`));return}let h=i(async(ce,X)=>{try{let de=await u.deleteSavedWorkflow(ce,X);if(!de){console.log(g.red(`
|
|
245
|
+
[workflow] saved workflow deletion is unavailable in this context.
|
|
246
|
+
`));return}console.log(g.dim(`
|
|
247
|
+
Deleted saved workflow ${de.name}.
|
|
248
|
+
`))}catch(de){let j=de instanceof Error?de.message:String(de);console.log(g.red(`
|
|
249
|
+
[workflow] delete failed: ${j}
|
|
250
|
+
`))}},"deleteSavedWorkflowTarget");if(r.scope==="saved"){await h(r.target);return}let $=c.getWorkflowProcessSnapshot(r.target),k=$?void 0:await u.resolveWorkflowIdentity(r.target),P;if(k?.kind==="ambiguous")if(k.run)P=k.run.runId;else{console.log(g.red(`
|
|
251
|
+
[workflow] ambiguous delete target: ${r.target} matches multiple workflow run/display names${k.matches.includes("saved")?" and a saved workflow name":""}. Use the concrete run id, or --saved when deleting a generated saved capsule.
|
|
252
|
+
`));return}if(k?.kind==="saved"){if(r.scope==="run"){console.log(g.yellow(`
|
|
253
|
+
No persisted workflow run ${r.target}. Use --saved to delete the saved workflow.
|
|
254
|
+
`));return}await h(k.savedWorkflow.name,k.savedWorkflow.source);return}if(k?.kind==="missing"){console.log(g.yellow(`
|
|
255
|
+
No persisted workflow run or generated saved workflow ${r.target}.
|
|
256
|
+
`));return}let I=k?.kind==="run"?k.runId:P??r.target;if(!he(I))return;if(await u.deleteWorkflowRun(I,{force:r.force})){console.log(g.dim(`
|
|
257
|
+
Deleted workflow run ${I}${r.force?" with --force":""}.
|
|
258
|
+
`));return}let q=$??c.getWorkflowProcessSnapshot(I),N=u.getWorkflowProcessSnapshot(I);if(!N&&!Ji(Z(l,I,"run.json"))){console.log(g.yellow(`
|
|
259
|
+
No persisted workflow run or generated saved workflow ${r.target}.
|
|
260
|
+
`));return}if(q&&!Fo(q.status)){console.log(g.yellow(`
|
|
261
|
+
Workflow ${I} is ${q.status}. Stop it before deleting the run record.
|
|
262
|
+
`));return}if(N&&!Fo(N.status)){console.log(g.yellow(`
|
|
263
|
+
Workflow ${I} is a non-terminal persisted ${N.status} record. If it is stale, run /workflow delete --force ${I}.
|
|
264
|
+
`));return}console.log(g.yellow(`
|
|
265
|
+
Workflow ${I} is not a deletable terminal run.
|
|
266
|
+
`));return}if(r.kind==="prune"){let h=qt(r.rawArgs);if(h.error){console.log(g.yellow(`
|
|
267
|
+
Usage: /workflow prune --dry-run | --keep N | --older-than Nd
|
|
268
|
+
${h.error}
|
|
269
|
+
`));return}if(!h.dryRun&&h.keep===void 0&&h.olderThanMs===void 0){console.log(g.yellow(`
|
|
270
|
+
Usage: /workflow prune --dry-run | --keep N | --older-than Nd
|
|
271
|
+
No cleanup rule was provided.
|
|
272
|
+
`));return}let $=Eo(l),k=await u.pruneWorkflowRuns(Ld(h)),P=Md($,k.candidates);console.log(g.bold(h.dryRun?`
|
|
273
|
+
Workflow prune preview:`:`
|
|
274
|
+
Workflow prune:`)),console.log(Mt(P)),k.protectedRuns>0&&console.log(g.dim(`
|
|
275
|
+
Protected ${k.protectedRuns} active workflow run${k.protectedRuns===1?"":"s"} from pruning.`)),h.dryRun?console.log(g.dim(`
|
|
276
|
+
Dry run only. Add --keep N or --older-than Nd without --dry-run to delete.
|
|
277
|
+
`)):console.log(g.dim(`
|
|
278
|
+
Deleted ${k.deleted} workflow run${k.deleted===1?"":"s"}.
|
|
279
|
+
`));return}if(r.kind==="save"){if(!r.runId||!r.name){console.log(g.yellow(`
|
|
280
|
+
Usage: /workflow save <runId> <name>
|
|
281
|
+
`));return}if(!he(r.runId))return;try{let h=await Vr({runDir:Z(l,r.runId),targetDir:d.project??Z(process.cwd(),".kodax","workflows"),name:r.name});console.log(g.green(`
|
|
282
|
+
Saved workflow ${h.name} to ${h.path}
|
|
283
|
+
`))}catch(h){let $=h instanceof Error?h.message:String(h);console.log(g.red(`
|
|
284
|
+
[workflow] save failed: ${$}
|
|
285
|
+
`))}return}if(r.kind==="rename"){if(!r.target||!r.newName){console.log(g.yellow(`
|
|
286
|
+
Usage: /workflow rename <runId|alias|savedName> <newName>
|
|
287
|
+
`));return}let h=await u.resolveWorkflowIdentity(r.target);if(h.kind==="ambiguous"){console.log(g.red(`
|
|
288
|
+
[workflow] ambiguous rename target: ${r.target} matches both a workflow run id and a saved workflow name.
|
|
289
|
+
`));return}if(h.kind==="missing"){console.log(g.red(`
|
|
290
|
+
[workflow] rename target not found: ${r.target}
|
|
291
|
+
`));return}if(h.kind==="run"){if(!await u.renameWorkflowRun(h.runId,r.newName)){console.log(g.red(`
|
|
292
|
+
[workflow] rename failed: ${h.runId}
|
|
293
|
+
`));return}console.log(g.green(`
|
|
294
|
+
Renamed workflow run ${h.runId} to ${r.newName.trim()}.
|
|
295
|
+
`));return}try{let $=await zr({dirs:d,name:h.savedWorkflow.name,newName:r.newName,source:h.savedWorkflow.source});console.log(g.green(`
|
|
296
|
+
Renamed saved workflow ${r.target} to ${$.name}.
|
|
297
|
+
`))}catch($){let k=$ instanceof Error?$.message:String($);console.log(g.red(`
|
|
298
|
+
[workflow] rename failed: ${k}
|
|
299
|
+
`))}return}if(r.kind==="revise"){if(!r.target||!r.request){console.log(g.yellow(`
|
|
300
|
+
Usage: /workflow revise [--replace] <runId|alias|savedName> <change request>
|
|
301
|
+
`));return}let h=Ie(n);if(!h){console.log(g.red(`
|
|
302
|
+
[workflow] refusing to revise a workflow without an interactive approval channel.
|
|
303
|
+
`));return}let $=n.createKodaXOptions;if(!$){console.log(g.red(`
|
|
304
|
+
[workflow] cannot revise - REPL options unavailable in this context.
|
|
305
|
+
`));return}let k=await u.resolveWorkflowIdentity(r.target);if(k.kind==="ambiguous"){console.log(g.red(`
|
|
306
|
+
[workflow] ambiguous revise target: ${r.target} matches both a workflow run id and a saved workflow name.
|
|
307
|
+
`));return}if(k.kind==="missing"){console.log(g.red(`
|
|
308
|
+
[workflow] revise target not found: ${r.target}
|
|
309
|
+
`));return}if(r.replace===!0&&k.kind!=="saved"){console.log(g.red(`
|
|
310
|
+
[workflow] revise --replace requires a saved workflow name target.
|
|
311
|
+
`));return}let P;try{if(k.kind==="run")P=(await zn({runDir:k.runDir})).capsule;else{if(k.savedWorkflow.execution!=="capability-generated"){console.log(g.red(`
|
|
312
|
+
[workflow] only generated workflow capsules can be revised.
|
|
313
|
+
`));return}P=await uo(k.savedWorkflow.path)}}catch(F){let ao=F instanceof Error?F.message:String(F);console.log(g.red(`
|
|
314
|
+
[workflow] revise failed: ${ao}
|
|
315
|
+
`));return}let I=Kt({target:r.target,capsule:P,changeRequest:r.request}),U;try{U=await Ko({request:I,options:$()})}catch(F){let ao=F instanceof Error?F.message:String(F);console.log(g.red(`
|
|
316
|
+
[workflow] revise generation failed: ${ao}
|
|
317
|
+
`));return}if(U.kind==="declined"){console.log(g.dim(`
|
|
318
|
+
Workflow revision not created: ${U.reason}
|
|
319
|
+
`));return}let q=r.replace===!0&&k.kind==="saved"?k:void 0,N=q?.savedWorkflow.name,ce=N??await Fi(d,U.manifest.name),X=ce===U.manifest.name?U.manifest:{...U.manifest,name:ce};if(!await h(se(ke({meta:X,run:U.module.run}),{source:N?`revision-replace:${N}`:`revision:${r.target}`,sandbox:"capability-generated",mayUseWorktree:X.mayUseWorktree===!0,rawScript:U.source}))){console.log(g.dim(`Workflow revision cancelled.
|
|
320
|
+
`));return}let j={name:ce,manifest:X,source:U.source,intent:Dr(X,{originalRequest:r.request}),...P.inputs!==void 0?{inputs:P.inputs}:{},...P.requires!==void 0?{requires:P.requires}:{},provenance:Hi({capsule:P,resolution:k,...N!==void 0?{replacesWorkflowName:N}:{}})};if(q){let F=await Xr({...j,dirs:d,savedSource:q.savedWorkflow.source});console.log(g.green(`
|
|
321
|
+
Replaced saved workflow ${F.name} with revised capsule at ${F.path}
|
|
322
|
+
`)),console.log(g.dim(`Previous capsule archived at ${F.previousPath}
|
|
323
|
+
`));return}let No=await qr({...j,dir:d.project??Z(process.cwd(),".kodax","workflows")});console.log(g.green(`
|
|
324
|
+
Saved workflow revision ${No.name} to ${No.path}
|
|
325
|
+
`));return}if(r.kind==="rerun"){if(!r.runId){console.log(g.yellow(`
|
|
326
|
+
Usage: /workflow rerun <runId|savedName> [args]
|
|
327
|
+
`));return}if(!he(r.runId))return;let h=Ie(n);if(!h){console.log(g.red(`
|
|
328
|
+
[workflow] refusing to rerun a workflow without an interactive approval channel.
|
|
329
|
+
`));return}let $=n.createKodaXOptions;if(!$){console.log(g.red(`
|
|
330
|
+
[workflow] cannot start \u2014 REPL options unavailable in this context.
|
|
331
|
+
`));return}let k=(await je(d)).find(L=>L.name===r.runId),P=c.list().some(L=>L.runId===r.runId)||Ji(Z(l,r.runId,"run.json"));if(k&&P){console.log(g.red(`
|
|
332
|
+
[workflow] ambiguous rerun target: ${r.runId} matches both a workflow run id and a saved workflow name.
|
|
333
|
+
`)),console.log(g.yellow(`Use /workflow ${r.runId} to run the saved workflow, or rerun a unique run id/name.
|
|
334
|
+
`));return}if(k&&!P){let L=await Ki(k,h);if(!L)return;let lo=xo(r.rawArgs,L.module.meta.name,L.module.meta.description,L.scriptSnapshot?.source),kr="agentic";if(!await h(se(ke(L.module),L.approvalContext))){console.log(g.dim(`Workflow cancelled.
|
|
335
|
+
`));return}let V=`run-${Date.now().toString(36)}`,La=Z(l,V);console.log(g.dim(`
|
|
336
|
+
Started workflow ${L.module.meta.name} (${V}). Use /workflow show ${V} for status.
|
|
337
|
+
`));let Un=Te(n,V,L.module.meta,lo);Un.running(`Use /workflow show ${V} for status or /workflow stop ${V} to stop.`);let Ma=Qe(c,Un,V),br=c.startFromOptions({module:L.module,args:To(r.rawArgs),options:$(),runId:V,runDir:La,...L.scriptSnapshot?{scriptSnapshot:L.scriptSnapshot}:{},processMetadata:Zi({displayName:L.module.meta.name,savedWorkflowName:k.name,provenance:L.provenance}),onEvent:Ze(n,void 0,{presentation:kr,locale:lo,runId:V})});Le(br,Ma),Pe(br,n,V,Un,{canRerun:L.scriptSnapshot!==void 0,presentation:kr,locale:lo});return}let I;try{I=await zn({runDir:Z(l,r.runId)})}catch(L){let lo=L instanceof Error?L.message:String(L);console.log(g.red(`
|
|
338
|
+
[workflow] rerun failed: ${lo}
|
|
339
|
+
`));return}let q=Co(l,r.runId)?.scriptSnapshotPath??Z(l,r.runId,"script.js"),N=xo(r.rawArgs,I.capsule.manifest.name,I.capsule.manifest.description,I.capsule.source),ce="agentic",X=fo(I.capsule,hn());if(!X.ok){yn(X);return}if(vn(X),!await h(se(ke(I.module),{source:`run:${r.runId}`,sandbox:"capability-generated",mayUseWorktree:I.capsule.manifest.mayUseWorktree===!0,rawScriptPath:q,rawScript:I.capsule.source}))){console.log(g.dim(`Workflow cancelled.
|
|
340
|
+
`));return}let j=`run-${Date.now().toString(36)}`,No=Z(l,j);console.log(g.dim(`
|
|
341
|
+
Started workflow ${I.module.meta.name} (${j}). Use /workflow show ${j} for status.
|
|
342
|
+
`));let F=Te(n,j,I.module.meta,N);F.running(`Use /workflow show ${j} for status or /workflow stop ${j} to stop.`);let ao=Qe(c,F,j),vr=c.startFromOptions({module:I.module,args:To(r.rawArgs),options:$(),runId:j,runDir:No,scriptSnapshot:{manifest:I.capsule.manifest,source:I.capsule.source},processMetadata:Io({source:"command",displayName:I.module.meta.name,sourceRunId:r.runId}),onEvent:Ze(n,void 0,{presentation:ce,locale:N,runId:j})});Le(vr,ao),Pe(vr,n,j,F,{canRerun:!0,presentation:ce,locale:N});return}if(r.kind==="create"){if(!r.request){console.log(g.yellow(`
|
|
343
|
+
Usage: /workflow create <request>
|
|
344
|
+
`));return}return await f(r.request)}let m=Ie(n);if(!m){console.log(g.red(`
|
|
345
|
+
[workflow] refusing to start a workflow without an interactive approval channel.
|
|
346
|
+
`));return}let b={source:"built-in",sandbox:"trusted package",mayUseWorktree:!1},S,C=Go(r.name),A,v;if(!C){let h=(await je(d)).find($=>$.name===r.name);if(!h){let $=[r.name,r.rawArgs].filter(k=>k&&k.length>0).join(" ").trim();return await f($)}if(A=h,h.execution==="trusted-local"&&!await m(`Run local workflow file? This EXECUTES local code:
|
|
347
|
+
${h.path}`)){console.log(g.dim(`Workflow cancelled.
|
|
348
|
+
`));return}try{if(h.execution==="capability-generated"){let $=await uo(h.path),k=fo($,hn());if(!k.ok){yn(k);return}vn(k),b={source:`saved:${h.source}`,sandbox:h.execution,mayUseWorktree:$.manifest.mayUseWorktree===!0,rawScriptPath:h.path,rawScript:$.source},S={manifest:$.manifest,source:$.source},v=$.provenance}C=await zo(h.path),h.execution==="trusted-local"&&(b={source:`saved:${h.source}`,sandbox:h.execution,mayUseWorktree:!1})}catch($){let k=$ instanceof Error?$.message:String($);console.log(g.red(`
|
|
349
|
+
[workflow] failed to load ${h.path}: ${k}
|
|
350
|
+
`));return}}let x=n.createKodaXOptions;if(!x){console.log(g.red(`
|
|
351
|
+
[workflow] cannot start \u2014 REPL options unavailable in this context.
|
|
352
|
+
`));return}if(!await m(se(ke(C),b))){console.log(g.dim(`Workflow cancelled.
|
|
353
|
+
`));return}let O=`run-${Date.now().toString(36)}`,_e=Z(l,O);console.log(g.dim(`
|
|
354
|
+
Started workflow ${C.meta.name} (${O}). Use /workflow show ${O} for status.
|
|
355
|
+
`));let We=xo(r.rawArgs,C.meta.name,C.meta.description,S?.source),io=Te(n,O,C.meta,We);io.running(`Use /workflow show ${O} for status or /workflow stop ${O} to stop.`);let le="agentic",Pa=Qe(c,io,O),yr=c.startFromOptions({module:C,args:To(r.rawArgs),options:x(),runId:O,runDir:_e,...S?{scriptSnapshot:S}:{},processMetadata:A?Zi({displayName:C.meta.name,savedWorkflowName:A.name,provenance:v}):Io({source:"command",displayName:C.meta.name}),onEvent:Ze(n,void 0,{presentation:le,locale:We,runId:O})});Le(yr,Pa),Pe(yr,n,O,io,{canRerun:S!==void 0,presentation:le,locale:We})},"handler")};import H from"chalk";var zt={name:"new",description:"Start a new conversation session",usage:"/new",handler:i(async(e,o,n)=>{if(o.messages.length===0){console.log(H.yellow(`
|
|
356
|
+
Current session is already empty.`)),console.log(H.dim("You can start a new conversation directly."));return}if(n.confirm&&!await n.confirm("Start a new session? This will clear the current conversation history.")){console.log(H.dim(`
|
|
357
|
+
Cancelled. Current session preserved.`));return}try{await n.saveSession(),console.log(H.dim(`
|
|
358
|
+
[Previous session saved]`))}catch{console.log(H.yellow(`
|
|
359
|
+
[Warning: Failed to save previous session]`))}n.startNewSession?.(),o.messages=[],n.clearHistory(),console.log(H.green(`
|
|
360
|
+
\u2713 Started new session`)),console.log(H.dim("Conversation history cleared. Ready for a fresh start!"))},"handler"),detailedHelp:i(()=>{console.log(H.bold(`
|
|
361
|
+
/new - Start New Session
|
|
362
|
+
`)),console.log("Usage:"),console.log(H.cyan(" /new")+` - Clear current session and start fresh
|
|
363
|
+
`),console.log("Description:"),console.log(" This command clears the current conversation history and starts a new session."),console.log(" It automatically saves the previous session before clearing."),console.log(` Useful for switching contexts or starting a new topic.
|
|
364
|
+
`),console.log("Examples:"),console.log(H.dim(" User: Help me refactor the authentication module")),console.log(H.dim(" AI: [provides refactoring help]")),console.log(H.cyan(" /new")),console.log(H.dim(" \u2713 Started new session")),console.log(H.dim(" User: Now I need help with database optimization")),console.log(H.dim(` AI: [provides database help]
|
|
365
|
+
`)),console.log("Notes:"),console.log(" \u2022 Automatically saves previous session before clearing"),console.log(" \u2022 Prompts for confirmation if there are messages in the current session"),console.log(" \u2022 Use /load to resume a previous session"),console.log(" \u2022 Use /sessions to see all saved sessions")},"detailedHelp")};import W from"chalk";var Xw="The provider may be rejecting the current session history. Create a new session from a safe summary and continue there?",Vw="The current LLM API may be rejecting this session history. Run /recover [prompt] to continue in a fresh session from safe memory.";function Yw(e){return Gr(e.error,e.messageCount)}i(Yw,"shouldOfferSessionRecovery");var Xt={name:"recover",aliases:["handoff"],description:"Create a fresh session from safe memory and continue",usage:"/recover [prompt]",handler:i(async(e,o,n)=>{if(o.messages.length===0){console.log(W.yellow(`
|
|
366
|
+
Current session is empty. Start a normal message instead.`));return}if(!n.recoverSession){console.log(W.red(`
|
|
367
|
+
[Recover is not available in this host]
|
|
368
|
+
`));return}if(n.confirm&&!await n.confirm("Create a new session from a safe summary of this one and continue there?")){console.log(W.dim(`
|
|
369
|
+
Cancelled. Current session preserved.`));return}let t;try{t=await n.recoverSession(Kn(e.join(" ")))}catch(r){let a=r instanceof Error?r.message:String(r);console.log(W.red(`
|
|
370
|
+
[Recover failed] ${a}
|
|
371
|
+
`));return}t==="blocked"?console.log(W.yellow(`
|
|
372
|
+
[Recover blocked by the current session transition guard]
|
|
373
|
+
`)):t==="failed"?console.log(W.red(`
|
|
374
|
+
[Recover failed]
|
|
375
|
+
`)):t==="empty"&&console.log(W.yellow(`
|
|
376
|
+
[Nothing to recover from this session]
|
|
377
|
+
`))},"handler"),detailedHelp:i(()=>{console.log(W.cyan(`
|
|
378
|
+
/recover - Continue in a Fresh Session
|
|
379
|
+
`)),console.log(W.bold("Usage:")),console.log(W.dim(" /recover ")+"Continue with a safe memory summary"),console.log(W.dim(" /recover <prompt> ")+"Continue with a custom first prompt"),console.log(W.dim(" /handoff <prompt> ")+"Alias for /recover"),console.log(),console.log(W.bold("Description:")),console.log(W.dim(" Saves the current session, creates a new local session,")),console.log(W.dim(" carries over only a compact memory summary, and runs the")),console.log(W.dim(" first continuation prompt there. Raw tool calls and provider")),console.log(W.dim(" history are not replayed to the model.")),console.log()},"detailedHelp")};import{execFile as _d}from"node:child_process";import{promisify as Wd}from"node:util";import Q from"chalk";var Od=Wd(_d),Vt=1e5;async function Lo(e,o){let{stdout:n}=await Od("git",e,{cwd:o,maxBuffer:67108864,windowsHide:!0});return n}i(Lo,"git");async function Nd(e){for(let o of["main","master","develop"])try{return await Lo(["rev-parse","--verify",o],e),o}catch{}return"HEAD"}i(Nd,"detectBaseBranch");async function Po(e,o){return(await Lo(["rev-parse",e],o)).trim()}i(Po,"resolveRef");async function Dd(e,o){try{return await Po(e,o)}catch{return}}i(Dd,"tryResolveRef");async function Ud(e,o){let n=e[0];if(n==="base"){let t=await Nd(o);return{diff:await Lo(["diff",`${t}...HEAD`],o),label:`changes against ${t}`,scope:"compare",baseRef:await Po(t,o),headRef:await Po("HEAD",o)}}if(n==="sha"&&e[1]){let t=await Dd(`${e[1]}^`,o);return{diff:await Lo(["show",e[1]],o),label:`commit ${e[1]}`,scope:"commit",...t?{baseRef:t}:{},headRef:await Po(e[1],o)}}if(n==="sha")throw new Error("missing commit hash for sha scope; use /review sha <hash>");return{diff:await Lo(["diff","HEAD"],o),label:"uncommitted changes",scope:"all",headRef:await Po("HEAD",o)}}i(Ud,"getDiff");function jd(e){let o=!1,n=!1,t=!1,r=!1,a=[],l=[],c=i(f=>f==="--workflow"||f==="workflow"?(o=!0,!0):f==="--lean"||f==="lean"?(n=!0,!0):!1,"applyModeArg");for(let f=0;f<e.length;f+=1){let m=e[f];if(m!==void 0){if(r){l.push(m);continue}if(m==="--"){r=!0;continue}if(!c(m)){if(!t&&m==="base"){a.push("base"),t=!0;continue}if(!t&&m==="sha"){for(a.push("sha"),t=!0;f+1<e.length;){let b=e[f+1];if(b===void 0)break;if(b==="--"){r=!0,f+=1;break}if(c(b)){f+=1;continue}a.push(b),f+=1;break}continue}l.push(m)}}}let d=l.join(" ").trim(),u=a[0]==="sha"&&!a[1]?"missing commit hash for sha scope; use /review sha <hash>":void 0;return{workflow:o,lean:n,diffArgs:a,prompt:d.length>0?d:void 0,...u?{error:u}:{}}}i(jd,"parseReviewInvocation");function Fd(e,o={}){let n=[`Review ${e} with KodaX's built-in scoped-review workflow.`,"Use the captured immutable review packets as the sole review input.","The built-in gives each ordinary packet one primary with both specVerdict and qualityVerdict, adds a second primary only for routing-high, sends only candidate findings to a fresh independent verifier, and performs capable final synthesis.","Final output must lead with verified findings, cite files or diff hunks, and state when no issues are found."];return o.lean===!0&&n.splice(2,0,"Add one lean/minimal-diff reviewer: find code that can be deleted or replaced by existing repo code, stdlib/native platform features, or already-installed dependencies.","Lean review must not recommend cutting trust-boundary validation, security checks, data-loss protection, accessibility basics, or explicitly requested behavior."),o.customPrompt&&n.push(`User review focus: ${o.customPrompt}`),o.packets&&o.packets.length>0&&n.push(`Captured packets: ${o.packets.length}.`,"Do not call changed_scope or recapture Git: these packets are the sole immutable review input."),n.join(`
|
|
380
|
+
`)}i(Fd,"buildReviewWorkflowRequest");function Hd(e){return e.length<=Vt?e:`${e.slice(0,Vt)}
|
|
381
|
+
|
|
382
|
+
[diff truncated to ${Vt} chars - review the rest with a narrower scope]`}i(Hd,"truncateDiff");function Bd(e){let o=Hd(e.diff),n=[`Review the following ${e.label} as a third-party reviewer (not the author).`,"Look for bugs (logic errors, null/undefined handling, off-by-one, races),","security (injection, secret exposure, auth bypass), performance hotpaths,","and design (over-engineering vs missing abstraction).","Cite specific diff lines. For each finding, note whether it is verifiable by","tsc / lint / test / build. If the diff is small or risk-free, say so briefly."];return e.lean===!0&&n.push("","Lean pass:","- After correctness/security findings, look for unnecessary code introduced by the diff.","- Prefer deletion or replacement with existing repo code, stdlib/native platform features, or already-installed dependencies when that is verifiably simpler.","- Do not recommend cutting trust-boundary validation, security checks, data-loss protection, accessibility basics, or explicitly requested behavior.","- For each lean suggestion, say what was skipped or can be removed, and when it should be added back."),e.customPrompt&&n.push("",`User review focus: ${e.customPrompt}`),n.push("","```diff",o,"```"),n.join(`
|
|
383
|
+
`)}i(Bd,"buildReviewPrompt");function ea(e){let o=[e.workflow?"--workflow":void 0,e.lean?"--lean":void 0].filter(n=>n!==void 0);return o.length>0?`/review ${o.join(" ")}`:"/review"}i(ea,"buildDisplayName");function Kd(){console.log(Q.bold(`
|
|
384
|
+
/review - Review Git Changes
|
|
385
|
+
`)),console.log("Usage:"),console.log(Q.cyan(" /review [--lean] [--workflow] [base | sha <hash>] [prompt...]")),console.log(),console.log("Scopes:"),console.log(Q.dim(" default ")+"Review uncommitted changes against HEAD"),console.log(Q.dim(" base ")+"Review changes against the detected base branch"),console.log(Q.dim(" sha <hash> ")+"Review a specific commit"),console.log(),console.log("Options:"),console.log(Q.dim(" --lean ")+"Add a minimal-diff/YAGNI review pass"),console.log(Q.dim(" --workflow ")+"Run the deterministic scoped-review workflow"),console.log(),console.log("Examples:"),console.log(Q.dim(" /review --lean")),console.log(Q.dim(" /review base focus on auth and data loss")),console.log(Q.dim(" /review sha abc123 --lean -- check for native platform replacements"))}i(Kd,"printReviewHelp");var oa={name:"review",description:"Review git changes for bugs, security, performance, design, and optional lean diffs",usage:"/review [--lean] [--workflow] [base | sha <hash>] [prompt...]",argumentHint:"[--lean] [--workflow] [base | sha <hash>] [prompt...]",detailedHelp:Kd,handler:i(async(e,o)=>{let n=o.gitRoot??process.cwd(),t=jd(e);if(t.error)return{success:!1,message:`/review: ${t.error}`};let r;try{r=await Ud(t.diffArgs,n)}catch(a){return{success:!1,message:`/review: git failed - ${a instanceof Error?a.message:String(a)}`}}if(!r.diff.trim())return{success:!0,message:"No changes to review."};if(t.workflow){let a;try{a=await ns({cwd:n,sessionId:o.sessionId,label:r.label,diff:r.diff,scope:r.scope,...r.baseRef?{baseRef:r.baseRef}:{},...r.headRef?{headRef:r.headRef}:{},customPrompt:t.prompt})}catch(l){return{success:!1,message:`/review: could not create review packet - ${l instanceof Error?l.message:String(l)}`}}return{success:!0,workflow:{request:Fd(r.label,{lean:t.lean,customPrompt:t.prompt,packets:a}),source:"command",displayName:ea(t),processSource:"review",builtin:{name:"scoped-review",args:{packets:a,...t.lean?{lean:!0}:{},...t.prompt?{reviewFocus:t.prompt}:{}}}}}}return{success:!0,invocation:{prompt:Bd({label:r.label,diff:r.diff,lean:t.lean,customPrompt:t.prompt}),source:"prompt",displayName:ea(t)}}},"handler")};import{constants as Gd}from"node:fs";import{access as qd,readFile as zd,writeFile as Xd}from"node:fs/promises";import{join as Vd}from"node:path";import ee from"chalk";var sa=`# KodaX Lean Mode
|
|
386
|
+
|
|
387
|
+
Before writing code:
|
|
388
|
+
1. Do we need to build this at all?
|
|
389
|
+
2. Does the codebase already have this?
|
|
390
|
+
3. Can stdlib or native platform solve it?
|
|
391
|
+
4. Can an existing dependency solve it?
|
|
392
|
+
5. Can this be a minimal diff?
|
|
393
|
+
6. Only then write code.
|
|
394
|
+
|
|
395
|
+
Never cut:
|
|
396
|
+
- trust-boundary validation
|
|
397
|
+
- security checks
|
|
398
|
+
- data-loss protection
|
|
399
|
+
- accessibility basics
|
|
400
|
+
- explicitly requested behavior
|
|
401
|
+
|
|
402
|
+
After coding:
|
|
403
|
+
- explain what was skipped
|
|
404
|
+
- say when to add it back
|
|
405
|
+
`;function Yd(e){return e.runtimeInfo?.workspaceRoot??e.runtimeInfo?.executionCwd??e.gitRoot??process.cwd()}i(Yd,"resolveTargetRoot");async function ia(e){try{return await qd(e,Gd.F_OK),!0}catch(o){if(o.code==="ENOENT")return!1;throw o}}i(ia,"pathExists");function na(e){return console.log(ee.dim(`AGENTS.md already exists at ${e}; left unchanged.`)),{success:!0,message:`AGENTS.md already exists and was left unchanged: ${e}`}}i(na,"existingAgentsResult");function An(e){return e instanceof Error?e.message:String(e)}i(An,"errorMessage");async function ta(e,o){let n;try{n=await ia(e)}catch(t){return{success:!1,message:`/agents init: failed to inspect ${e}: ${An(t)}`}}if(n)return na(e);try{await Xd(e,sa,{encoding:"utf8",flag:"wx"})}catch(t){return t.code==="EEXIST"?na(e):{success:!1,message:`/agents init: failed to write ${e}: ${An(t)}`}}if(o.reloadAgentsFiles)try{await o.reloadAgentsFiles()}catch(t){return{success:!1,message:`/agents init: created ${e} but failed to reload AGENTS.md files: ${An(t)}`}}return console.log(ee.green(`Created ${e}`)),{success:!0,message:`Created ${e}`}}i(ta,"initializeAgentsFile");function Jd(e,o){return[`Review and update the target project's AGENTS.md at ${e}.`,"","Goal: ensure the project instructions include KodaX Lean Mode guidance, without duplicating equivalent existing guidance.","","Required behavior:","- First inspect the existing AGENTS.md content and decide whether lean/minimal-diff constraints are already present.","- If equivalent guidance already exists, leave the file unchanged and explain that no change was needed.","- If guidance is missing or partial, edit AGENTS.md with the smallest clear diff that merges the Lean Mode ideas into the existing structure.","- Do not add duplicate headings or repeat bullets that already exist with equivalent meaning.","- Preserve existing project-specific instructions and ordering unless a small local insertion is clearly better.","- Never weaken trust-boundary validation, security checks, data-loss protection, accessibility basics, or explicitly requested behavior.","","Lean Mode guidance to merge when missing:","","```markdown",sa.trimEnd(),"```","","Current AGENTS.md content:","","```markdown",o,"```"].join(`
|
|
406
|
+
`)}i(Jd,"buildLeanReviewPrompt");function ra(){console.log(ee.bold(`
|
|
407
|
+
/agents - Manage Target Project Instructions
|
|
408
|
+
`)),console.log("Usage:"),console.log(ee.cyan(" /agents init")),console.log(ee.cyan(" /agents lean")),console.log(),console.log("Commands:"),console.log(ee.dim(" init ")+"Create AGENTS.md in the target project if it is absent"),console.log(ee.dim(" lean ")+"Initialize or LLM-review AGENTS.md for Lean Mode guidance"),console.log(),console.log("Notes:"),console.log(ee.dim(" - Existing AGENTS.md files are never overwritten.")),console.log(ee.dim(" - /agents lean asks the LLM to merge missing lean guidance without duplicates.")),console.log(ee.dim(" - The generated file belongs to the target project, not KodaX itself."))}i(ra,"printAgentsHelp");var Yt={name:"agents",description:"Initialize target-project AGENTS.md instructions",usage:"/agents init | lean",argumentHint:"init | lean",detailedHelp:ra,handler:i(async(e,o,n)=>{let t=e[0]?.toLowerCase()??"help";if(t!=="init"&&t!=="lean")return ra(),!0;let r=Yd(o),a=Vd(r,"AGENTS.md");if(t==="init")return await ta(a,n);let l;try{l=await ia(a)}catch(d){return{success:!1,message:`/agents lean: failed to inspect ${a}: ${An(d)}`}}if(!l)return await ta(a,n);let c;try{c=await zd(a,"utf8")}catch(d){let u=d instanceof Error?d.message:String(d);return{success:!1,message:`/agents lean: failed to read ${a}: ${u}`}}return{success:!0,invocation:{prompt:Jd(a,c),source:"prompt",displayName:"/agents lean"}}},"handler")};function En(e){let o=e.match(/\r\n|\r|\n/g);return o?o.length:0}i(En,"getPastedTextRefNumLines");function Zd(e,o){return o===0?`[Pasted text #${e}]`:`[Pasted text #${e} +${o} lines]`}i(Zd,"formatPastedTextRef");function Qd(e,o){return`[...Truncated text #${e} +${o} lines...]`}i(Qd,"formatTruncatedTextRef");var eu=/\[(Pasted text|Image|\.\.\.Truncated text) #(\d+)(?: \+\d+ lines)?(\.*)\]/g;function ou(e){let o=[],n=new RegExp(eu.source,"g");for(let t of e.matchAll(n)){let r=Number.parseInt(t[2]??"0",10);!Number.isFinite(r)||r<=0||o.push({id:r,kind:t[1],match:t[0],index:t.index??0})}return o}i(ou,"parseReferences");function nu(e,o){let n=ou(e);if(n.length===0)return e;let t=i(a=>o instanceof Map?o.get(a):o[a],"getContent"),r=e;for(let a=n.length-1;a>=0;a--){let l=n[a];if(l.kind==="Image")continue;let c=t(l.id);!c||c.type!=="text"||(r=r.slice(0,l.index)+c.content+r.slice(l.index+l.match.length))}return r}i(nu,"expandPastedTextRefs");var tu=/\[(Pasted text|Image|\.\.\.Truncated text) #(\d+)(?: \+\d+ lines)?(\.*)\]$/,ru=/^\[(Pasted text|Image|\.\.\.Truncated text) #(\d+)(?: \+\d+ lines)?(\.*)\]/;function su(e,o){if(o>=e.length)return!0;let n=e[o];return!n||/\s/.test(n)}i(su,"isAtWordBoundaryAfter");function iu(e,o){if(o===0)return!0;let n=e[o-1];return!n||/\s/.test(n)}i(iu,"isAtWordBoundaryBefore");function gh(e,o){if(o<=0||!su(e,o))return null;let t=e.slice(0,o).match(tu);if(!t)return null;let r=o-t[0].length,a=Number.parseInt(t[2]??"0",10);return!Number.isFinite(a)||a<=0?null:{start:r,end:o,id:a,kind:t[1]}}i(gh,"findPlaceholderBeforeCursor");function wh(e,o){if(o>=e.length||!iu(e,o))return null;let t=e.slice(o).match(ru);if(!t)return null;let r=Number.parseInt(t[2]??"0",10);return!Number.isFinite(r)||r<=0?null:{start:o,end:o+t[0].length,id:r,kind:t[1]}}i(wh,"findPlaceholderAfterCursor");function hh(e){return e.length>800||En(e)>2}i(hh,"shouldReplacePasteWithPlaceholder");function yh(e,o){if(e.length<=1e4)return{truncatedText:e,placeholderContent:""};let n=Math.floor(1e3/2),t=Math.floor(1e3/2),r=e.slice(0,n),a=e.slice(-t),l=e.slice(n,-t),c=En(l),d=Qd(o,c);return{truncatedText:r+d+a,placeholderContent:l}}i(yh,"maybeTruncateLongInput");var Jt=class{static{i(this,"PasteStore")}contents=new Map;nextId=1;registerText(o){let n=this.nextId++,t=En(o);return this.contents.set(n,{id:n,type:"text",content:o}),{id:n,placeholder:Zd(n,t),numLines:t}}registerTruncatedText(o){let n=this.nextId++,t=En(o);return this.contents.set(n,{id:n,type:"text",content:o}),{id:n,numLines:t}}adopt(o){this.contents.set(o.id,o),o.id>=this.nextId&&(this.nextId=o.id+1)}peekNextId(){return this.nextId}get(o){return this.contents.get(o)}expand(o){return nu(o,this.contents)}snapshot(){return new Map(this.contents)}restore(o){this.contents.clear();for(let[n,t]of o)this.contents.set(n,t);for(let n of o.keys())n>=this.nextId&&(this.nextId=n+1)}reset(){this.contents.clear(),this.nextId=1}size(){return this.contents.size}export(){return Array.from(this.contents.values())}},Rn=null;function vh(){return Rn===null&&(Rn=new Jt),Rn}i(vh,"getOrCreateModulePasteStore");function aa(){return Rn??void 0}i(aa,"getActivePasteStore");import{createHash as au}from"node:crypto";import{mkdir as lu,readdir as cu,readFile as du,stat as uu,unlink as fu,writeFile as mu}from"node:fs/promises";import*as Zt from"node:path";var pu="paste-cache",gu=720*60*60*1e3;function Qt(){return _(pu)}i(Qt,"getPasteCacheDir");function la(e){return Zt.join(Qt(),`${e}.txt`)}i(la,"getPastePath");function Ah(e){return au("sha256").update(e).digest("hex").slice(0,16)}i(Ah,"hashPastedText");async function Rh(e,o){try{let n=Qt();return await lu(n,{recursive:!0}),await mu(la(e),o,{encoding:"utf8",mode:384}),!0}catch{return!1}}i(Rh,"storePastedText");async function ca(e){try{return await du(la(e),{encoding:"utf8"})}catch{return null}}i(ca,"retrievePastedText");async function Eh(e=gu){let o=Qt(),n=Date.now()-e,t=0,r=0,a;try{a=await cu(o)}catch{return{scanned:t,removed:r}}for(let l of a){if(!l.endsWith(".txt"))continue;t+=1;let c=Zt.join(o,l);try{(await uu(c)).mtimeMs<n&&(await fu(c),r+=1)}catch{}}return{scanned:t,removed:r}}i(Eh,"cleanupOldPastes");import*as rr from"path";import*as ua from"os";function wu(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}i(wu,"escapeRegExp");function hu(e,o){if(!e)return;let n=e.trim();if(!n.startsWith("/"))return;let t=new RegExp(`^/${wu(o)}(?:\\s+)?`,"i"),r=n.replace(t,"").trim();return r.length>0?r:void 0}i(hu,"deriveArgumentHintFromUsage");function er(e,o="builtin"){return{...e,source:e.source??o,userInvocable:e.userInvocable??!0,disableModelInvocation:e.disableModelInvocation??!1,argumentHint:e.argumentHint??hu(e.usage,e.name)}}i(er,"toCommandDefinition");function or(e){for(let o of da)try{let n=er(o,"builtin");e.register(n)}catch(n){K({source:"repl:commands",level:"error",message:`Failed to register command "${o.name}".`,detail:n})}}i(or,"registerBuiltinCommands");import*as ie from"fs";import*as Me from"path";function yu(e){if(Array.isArray(e))return e.map(o=>String(o).trim()).filter(o=>o.length>0);if(typeof e=="string")return e.split(",").map(o=>o.trim()).filter(o=>o.length>0)}i(yu,"normalizeAliases");function vu(e){if(e==="critical"||e==="high"||e==="medium"||e==="low")return e}i(vu,"normalizePriority");function ku(e){return{disableModelInvocation:e["disable-model-invocation"]===!0,userInvocable:e["user-invocable"]!==!1,allowedTools:Tr(e["allowed-tools"]),context:e.context==="fork"?"fork":void 0,agent:typeof e.agent=="string"?e.agent:void 0,argumentHint:typeof e["argument-hint"]=="string"?e["argument-hint"]:void 0,model:typeof e.model=="string"?e.model:void 0,hooks:Pr(e.hooks),frontmatter:e}}i(ku,"buildExecutionMetadata");function bu(e,o){try{let n=ie.readFileSync(e,"utf-8"),[t,r]=Ir(n),a=t??{},l=Me.basename(e,".md"),c=typeof a.name=="string"&&a.name.trim()?a.name.trim():l;if(!c||r.trim().length===0)return;let d=typeof a.description=="string"&&a.description.trim()?a.description.trim():`Custom command from ${o} level`;return{name:c,description:d,aliases:yu(a.aliases),priority:vu(a.priority),content:r.trim(),location:o,path:e,frontmatter:a,execution:ku(a)}}catch(n){K({source:"repl:commands",level:"error",message:`Error parsing command file ${e}.`,detail:n});return}}i(bu,"parseCommandFile");function nr(e){let o=[],n=new Set;for(let t=0;t<e.length;t++){let r=e[t],a=typeof r=="string"?r:r.path,l=typeof r=="string"?t===0?"user":"project":r.location;if(!ie.existsSync(a))continue;let c=Me.resolve(a);try{c=ie.realpathSync.native?.(a)??ie.realpathSync(a)}catch{c=Me.resolve(a)}if(!n.has(c)){n.add(c);try{let d=ie.readdirSync(a);for(let u of d){if(!u.endsWith(".md"))continue;let f=Me.join(a,u),m=bu(f,l);m&&o.push(m)}}catch(d){K({source:"repl:commands",level:"error",message:`Error scanning directory ${a}.`,detail:d})}}}return o}i(nr,"discoverCommands");function tr(e,o){for(let n of e)try{o.register({name:n.name,aliases:n.aliases,description:n.description,source:"extension",priority:n.priority,location:n.location,path:n.path,userInvocable:n.execution.userInvocable,disableModelInvocation:n.execution.disableModelInvocation,allowedTools:n.execution.allowedTools,context:n.execution.context,agent:n.execution.agent,argumentHint:n.execution.argumentHint,model:n.execution.model,hooks:n.execution.hooks,frontmatter:n.frontmatter,handler:i(async()=>({success:!0,invocation:{...n.execution,prompt:n.content,source:"prompt",displayName:n.name,path:n.path}}),"handler")})}catch(t){K({source:"repl:commands",level:"error",message:`Error registering command ${n.name}.`,detail:t})}}i(tr,"registerDiscoveredCommands");function sr(e,o){or(e);try{let n=ua.homedir(),t=o??process.cwd(),r=nr([{path:rr.join(t,".kodax","commands"),location:"project"},{path:_("commands"),location:"user"},{path:rr.join(n,".agents","commands"),location:"user"}]);tr(r,e)}catch(n){K({source:"repl:commands",level:"error",message:"Failed to discover commands.",detail:n})}}i(sr,"registerAllCommands");function qh(e){let o=new fe;return sr(o,e),o.getAll()}i(qh,"listRegisteredCommands");function Su(e){return{global:e.filter(o=>o.scope==="global").length,directory:e.filter(o=>o.scope==="directory").length,project:e.filter(o=>o.scope==="project").length}}i(Su,"summarizeAgentsFiles");async function ya(e){let o=ve(e);return await o.reload(),o.size}i(ya,"reloadSkillRegistry");function $u(e,o){if(!Array.isArray(o))return[];let n=[];for(let t of o){if(typeof t!="string")continue;let r=t.trim();r&&n.push(In.isAbsolute(r)?r:In.resolve(In.dirname(e),r))}return n}i($u,"normalizeConfiguredExtensionPaths");function xu(){let e=In.join(ue(),"config.json");try{if(!Tn.existsSync(e))return{};let o=JSON.parse(Tn.readFileSync(e,"utf-8"));if(!o||typeof o!="object"||Array.isArray(o))return{};let n=o;return{...n,extensions:$u(e,n.extensions)}}catch(o){let n=o instanceof Error?o.message:String(o);return console.log(s.yellow(`[extensions] Failed to read configured extensions: ${n}`)),{}}}i(xu,"loadExtensionReloadConfig");async function Au(){try{return await Br()}catch(e){let o=e instanceof Error?e.message:String(e);return console.log(s.yellow(`[extensions] Failed to discover default extensions: ${o}`)),[]}}i(Au,"discoverDefaultExtensionsForReload");async function Ru(){let e=xu(),o=await qn(e.extensions??[]),n=await qn(await Au()),t=await Bo(n,o),r=[...t,...o],a=ne();if(!a&&r.length>0&&(a=Kr({config:e}).activate()),!a)return{reloaded:0,loaded:0,failures:0};let l=no(a),c=l.failures.length;await a.reloadExtensions({continueOnError:!0});let d=no(a),u=Math.max(0,d.failures.length-c),f=d.loadedExtensions.map(C=>C.path),m=await Bo(t,f),b=await Bo(o,[...f,...m]);await a.loadExtensions(m,{continueOnError:!0,loadSource:"discovery",stage:"reload"}),await a.loadExtensions(b,{continueOnError:!0,loadSource:"config",stage:"reload"});let S=no(a);return{reloaded:Math.max(0,l.loadedExtensions.length-u),loaded:Math.max(0,S.loadedExtensions.length-d.loadedExtensions.length),failures:Math.max(0,S.failures.length-c)}}i(Ru,"reloadExtensionRuntimeFromDisk");function Eu(e){return{...e,enabled:!0}}i(Eu,"createManualCompactionConfig");function ir(e){e.runtimeInfo?.workspaceRoot?console.log(s.dim(` Workspace unchanged: ${bt(e.runtimeInfo)}`)):console.log(s.dim(" Workspace unchanged."))}i(ir,"printWorkspaceUnchangedNote");var da=[{name:"help",aliases:["h","?"],description:"Show all available commands",usage:"/help [command]",handler:i(async e=>{if(e.length>0){let o=e[0];ae.size===0&&Pn(),ae.has(o.toLowerCase())||!!Ln(o)?dr(o,e.slice(1)):Fu(o)}else ju()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
409
|
+
/help - Show Command Help
|
|
410
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /help ")+"Show all available commands"),console.log(s.dim(" /help <command> ")+"Show detailed help for a specific command"),console.log(s.dim(" /<command> help ")+"Shortcut for command-specific help"),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /help ")+"# List all commands"),console.log(s.dim(" /help mode ")+"# Detailed help for /mode"),console.log(s.dim(" /mode help ")+"# Same detailed help shortcut"),console.log()},"detailedHelp")},{name:"setup",description:"Initialize configuration and configure a provider",usage:"/setup [--custom|--help]",handler:i(async(e,o,n)=>{let t=e.length===1&&e[0]==="--custom";if(e.length>0&&!t){console.log(s.red(`
|
|
411
|
+
[Usage: /setup [--custom|--help]]`));return}if(console.log(`
|
|
412
|
+
${rt()}
|
|
413
|
+
`),n.prepareSetupSandbox){let c=await n.prepareSetupSandbox(),d=c.status==="ready"?s.green("active"):c.status==="cancelled"?s.yellow("cancelled"):s.yellow("not active");console.log(`Sandbox: [${d}]`);for(let u of c.lines)console.log(` ${u}`);console.log()}let r=Ns({validateA2A:n.validateSetupA2AConfig});for(let c of r.files){let d=c.status==="created"?s.green("created"):c.status==="invalid"?s.red("invalid"):c.status==="missing"?s.yellow("missing"):s.dim("existing");console.log(` [${d}] ${c.path}`),c.diagnostic&&console.log(` ${s.red(c.diagnostic)}`)}if(console.log(),r.files.some(c=>c.status==="invalid")){console.log(s.red("Setup stopped: fix the invalid active configuration above, then run /setup again."));return}let l=await js({interaction:{choose:i(async(c,d)=>{let u=d.map(m=>m.label),f=await n.ui.select(c,u);return d.find(m=>m.label===f)?.value},"choose"),text:i((c,d)=>n.ui.input(c,d),"text"),confirm:i(c=>n.ui.confirm(c),"confirm")},customOnly:t});if(l.status==="cancelled"){console.log(s.dim(`
|
|
414
|
+
Provider setup cancelled. Configuration files remain initialized.
|
|
415
|
+
`));return}console.log(s.green(`
|
|
416
|
+
Provider setup saved: ${l.selection.provider}/${l.selection.model}`)),console.log(s.dim(`Config: ${l.selection.configPath}`));for(let c of Ts({apiKeyEnv:l.selection.apiKeyEnv}))console.log(` ${c}`);console.log()},"handler"),detailedHelp:i(()=>{console.log(`
|
|
417
|
+
${rt()}
|
|
418
|
+
`)},"detailedHelp")},{name:"exit",aliases:["quit","q","bye"],description:"Exit interactive mode",handler:i(async(e,o,n)=>{await n.saveSession(),console.log(s.green(`
|
|
419
|
+
Session saved. Goodbye!`)),await n.exit()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
420
|
+
/exit - Exit Interactive Mode
|
|
421
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /exit ")+"Save session and exit"),console.log(s.dim(" /quit, /q, /bye ")+"Aliases for /exit"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Saves the current conversation session and exits interactive mode.")),console.log(s.dim(" Sessions can be resumed later with /load or CLI -c option.")),console.log(s.dim(" Exiting never removes or mutates the current workspace.")),console.log()},"detailedHelp")},{name:"clear",description:"Clear conversation history",handler:i(async(e,o,n)=>{o.messages=[],o.contextTokenSnapshot=void 0,n.clearHistory(),console.log(s.yellow(`
|
|
422
|
+
[Conversation cleared]`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
423
|
+
/clear - Clear Conversation History
|
|
424
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /clear ")+"Clear all messages in current session"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Removes all messages from the current conversation context.")),console.log(s.dim(" Useful for starting fresh while keeping the session.")),console.log(),console.log(s.yellow(" Warning: This action cannot be undone!")),console.log()},"detailedHelp")},{name:"cost",description:"Show session cost report",usage:"/cost",handler:i(async(e,o,n)=>{let t=n.getCostReport?.();if(!t){console.log(s.dim(`
|
|
425
|
+
[No cost data available yet]`));return}console.log(s.cyan(`
|
|
426
|
+
`+t))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
427
|
+
/cost - Session Cost Report
|
|
428
|
+
`)),console.log(s.bold("Description:")),console.log(s.dim(" Shows token usage and estimated cost for the current session,")),console.log(s.dim(" broken down by provider and AMA role.")),console.log()},"detailedHelp")},{name:"paste",description:"Inspect pasted text stored in the input buffer",usage:"/paste show <id> | /paste list",argumentHint:"show <id> | list",handler:i(async e=>{let o=e[0]?.toLowerCase();if(!o||o==="help"){console.log(s.cyan(`
|
|
429
|
+
/paste - Inspect stored paste contents`)),console.log(s.dim(" /paste list - Show all pasted text ids in this session")),console.log(s.dim(" /paste show <id> - Print the full content of paste #<id>")),console.log();return}let n=aa();if(!n){console.log(s.yellow(`
|
|
430
|
+
[No paste registry active]`)),console.log(s.dim(" The REPL composer is not mounted, or no paste has been captured yet."));return}if(o==="list"){let t=n.export();if(t.length===0){console.log(s.dim(`
|
|
431
|
+
[No pasted content in this session yet]`));return}console.log(s.bold(`
|
|
432
|
+
Pasted content in this session:
|
|
433
|
+
`));for(let r of t){let a=r.content?.length??0,l=r.contentHash?` (hash ${r.contentHash.slice(0,8)})`:"";console.log(` ${s.cyan(`#${r.id}`)} ${r.type} ${a} chars${l}`)}console.log();return}if(o==="show"){let t=e[1],r=t?Number.parseInt(t,10):NaN;if(!Number.isFinite(r)||r<=0){console.log(s.yellow(`
|
|
434
|
+
Usage: /paste show <id>`));return}let a=n.get(r);if(!a){console.log(s.dim(`
|
|
435
|
+
[No paste registered with id #${r}]`));return}let l=a.content??"";if(!l&&a.contentHash){let c=await ca(a.contentHash);c&&(l=c)}if(!l){console.log(s.yellow(`
|
|
436
|
+
[Paste #${r} has no stored content (hash ${a.contentHash??"n/a"})]`));return}console.log(s.bold(`
|
|
437
|
+
Pasted text #${r} (${l.length} chars):
|
|
438
|
+
`)),console.log(l),console.log();return}console.log(s.yellow(`
|
|
439
|
+
[Unknown /paste subcommand: ${o}]`)),console.log(s.dim(" Try /paste show <id> or /paste list"))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
440
|
+
/paste - Inspect stored paste contents
|
|
441
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /paste list - Show all pasted text ids in this session")),console.log(s.dim(" /paste show <id> - Print the full content of paste #<id>")),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" When you paste more than ~800 chars into the input bar, KodaX")),console.log(s.dim(" replaces the pasted text with a `[Pasted text #N +K lines]` anchor")),console.log(s.dim(" to keep the UI responsive. The full content is preserved and sent")),console.log(s.dim(" to the LLM on submit. Use this command to see what was captured.")),console.log()},"detailedHelp")},{name:"compact",description:"Manually trigger context compaction",usage:"/compact [instructions]",handler:i(async(e,o,n,t)=>{try{let r=await ys(o.gitRoot),a=t.provider,l=Hn(a);if(!l){console.log(s.red(`
|
|
442
|
+
[Provider not found: ${a}]`));return}let c=e.length>0?e.join(" "):void 0,d=r.contextWindow??l.getEffectiveContextWindow?.(t.model)??l.getContextWindow?.()??2e5,u=o.contextTokenSnapshot?.currentTokens??Do(o.messages),f=Eu(r);console.log(s.dim(`
|
|
443
|
+
[Compacting conversation...]`)),n.startCompacting?.();try{let m=await Or(o.messages,f,l,d,c,void 0,u,Jr,Zr,t.model,!0,l.getEffectiveMaxOutputTokens(t.model));if(!m.compacted){console.log(s.green(`
|
|
444
|
+
[No compaction needed]`)),console.log(s.dim(`Current token usage: ${m.tokensBefore.toLocaleString()}
|
|
445
|
+
`));return}o.messages=m.messages,o.contextTokenSnapshot={currentTokens:m.tokensAfter,baselineEstimatedTokens:Do(m.messages),source:o.contextTokenSnapshot?.source??"estimate"},n.onCompactStats?.({tokensBefore:m.tokensBefore,tokensAfter:m.tokensAfter}),n.clearHistory?.(),await n.saveSession(),console.log(s.green(`
|
|
446
|
+
[Compaction complete: ${Math.round(m.tokensBefore/1e3)}k -> ${Math.round(m.tokensAfter/1e3)}k tokens, ${Math.round((1-m.tokensAfter/m.tokensBefore)*100)}% reduced]`)),console.log()}finally{n.stopCompacting?.()}}catch(r){let a=r instanceof Error?r.message:String(r);console.log(s.red(`
|
|
447
|
+
[Compaction failed: ${a}]
|
|
448
|
+
`))}},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
449
|
+
/compact - Manual Context Compaction
|
|
450
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /compact ")+"Compact conversation with default instructions"),console.log(s.dim(" /compact <text> ")+"Compact with custom instructions for the summary"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Manually triggers context compaction using LLM-generated summaries.")),console.log(s.dim(" All eligible older messages are replaced atomically with a structured checkpoint.")),console.log(s.dim(" Automatic large compaction is always enabled; /compact bypasses its trigger comparison.")),console.log(),console.log(s.bold("What it does:")),console.log(s.dim(" 1. Protects 20% of the effective trigger as recent raw context")),console.log(s.dim(" 2. Summarizes the complete eligible prefix in one atomic wave")),console.log(s.dim(" 3. Tracks files that were read/modified in the conversation")),console.log(s.dim(" 4. Replaces old messages with summary to save tokens")),console.log(),console.log(s.bold("Configuration:")),console.log(s.dim(" Config file: ~/.kodax/config.json")),console.log(s.dim(" Settings:")),console.log(s.dim(" - compaction.triggerPercent: 15-90, default 75")),console.log(s.dim(" - compaction.triggerTokens: Optional absolute token threshold; 0 disables this limiter")),console.log(s.dim(" - The smaller percentage/absolute threshold wins")),console.log(s.dim(" - compaction.enabled: deprecated and ignored; automatic compaction stays on")),console.log(s.dim(" - compaction.contextWindow: Optional token-window override")),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /compact ")+"# Compact with default instructions"),console.log(s.dim(" /compact focus on auth logic ")+"# Emphasize authentication in summary"),console.log(),console.log(s.dim(" See also: /help status (shows token usage)")),console.log()},"detailedHelp")},{name:"reload",description:"Reload project rules, skills, and active extensions",handler:i(async(e,o,n,t)=>{console.log(s.cyan(`
|
|
451
|
+
Reloading project rule files, skills, and runtime extensions...
|
|
452
|
+
`));try{let r=await n.reloadAgentsFiles?.()??[],a=Su(r),l=await ya(o.gitRoot),c=await Ru(),d=c.reloaded+c.loaded,u=c.failures;if(r.length===0&&l===0&&d===0&&u===0){console.log(s.yellow(`No project rule files, skills, or active extensions found.
|
|
453
|
+
`)),console.log(s.dim(" Create AGENTS.md or CLAUDE.md in your project, add skills, or load extensions with --extension.")),console.log();return}console.log(s.green(`Reloaded successfully:
|
|
454
|
+
`)),a.global>0&&console.log(s.dim(` - Global: ${a.global} file(s)`)),a.directory>0&&console.log(s.dim(` - Directory: ${a.directory} file(s)`)),a.project>0&&console.log(s.dim(` - Project: ${a.project} file(s)`)),c.reloaded>0&&console.log(s.dim(` - Extensions reloaded: ${c.reloaded} module(s)`)),c.loaded>0&&console.log(s.dim(` - Extensions loaded: ${c.loaded} module(s)`)),l>0&&console.log(s.dim(` - Skills: ${l} skill(s)`)),u>0&&console.log(s.yellow(` - Failures: ${u} recorded (run /extensions for details)`)),console.log(s.dim(" Updated rules, skills, and extensions will apply to subsequent requests in this session.")),console.log();return}catch(r){console.log(s.red(`Failed to reload.
|
|
455
|
+
`)),console.log(s.dim(` Error: ${r instanceof Error?r.message:String(r)}`)),console.log()}},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
456
|
+
/reload - Reload Project Context
|
|
457
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /reload ")+"Reload project rule files, skills, and active extensions"),console.log(),console.log(s.bold("Description:")),console.log(" Reloads project-level context rules from AGENTS.md, CLAUDE.md, and .kodax/AGENTS.md files."),console.log(" Reloads skills from .kodax/skills/, ~/.kodax/skills/, ~/.agents/skills/, plugins, and builtins."),console.log(" Rediscovers default/configured extensions, creates a runtime if needed, and hot-reloads loaded extensions."),console.log(),console.log(s.bold("Rule Priority:")),console.log(s.dim(" 1. Global: ")+"~/.kodax/AGENTS.md"),console.log(s.dim(" 2. Directory: ")+"AGENTS.md or CLAUDE.md from project root to current directory"),console.log(s.dim(" 3. Project: ")+".kodax/AGENTS.md at the project root"),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /reload ")+"# Reload and show loaded rules"),console.log()},"detailedHelp")},{name:"extensions",aliases:["ext"],description:"Show active extension runtime diagnostics",usage:"/extensions",handler:i(async()=>{let e=ne();if(!e){console.log(s.yellow(`
|
|
458
|
+
[No active extension runtime]
|
|
459
|
+
`));return}let o=no(e),n=o.tools.filter(t=>t.source.kind==="extension");if(console.log(s.bold(`
|
|
460
|
+
Extension Runtime:
|
|
461
|
+
`)),console.log(s.dim(` Loaded: ${o.loadedExtensions.length}`)),console.log(s.dim(` Capabilities: ${o.capabilityProviders.length}`)),console.log(s.dim(` Commands: ${o.commands.length}`)),console.log(s.dim(` Hooks: ${o.hooks.length}`)),console.log(s.dim(` Failures: ${o.failures.length}`)),console.log(s.dim(` Extension Tools: ${n.length}`)),o.defaults.activeTools!==void 0&&console.log(s.dim(` Active Tools: ${o.defaults.activeTools.join(", ")||"(none)"}`)),(o.defaults.modelSelection.provider||o.defaults.modelSelection.model)&&console.log(s.dim(` Model Override: ${o.defaults.modelSelection.provider??"(inherit)"} / ${o.defaults.modelSelection.model??"(inherit)"}`)),o.defaults.thinkingLevel&&console.log(s.dim(` Thinking: ${o.defaults.thinkingLevel}`)),console.log(),o.loadedExtensions.length>0){console.log(s.bold("Loaded Extensions:"));for(let t of o.loadedExtensions)console.log(s.dim(` - ${t.label} [${t.loadSource}] (${t.path})`));console.log()}if(o.commands.length>0){console.log(s.bold("Extension Commands:"));for(let t of o.commands){let r=t.aliases?.length?` [${t.aliases.join(", ")}]`:"";console.log(s.dim(` - /${t.name}${r} ${t.description}`))}console.log()}if(o.capabilityProviders.length>0){console.log(s.bold("Capability Providers:"));for(let t of o.capabilityProviders){let r=Yu(t.metadata);console.log(s.dim(` - ${t.id} [${t.kinds.join(", ")}]${r?` ${r}`:""}`))}console.log()}if(n.length>0){console.log(s.bold("Extension Tools:"));for(let t of n){let r=t.shadowedSources.length>0?` overrides: ${t.shadowedSources.map(a=>a.label??a.id??a.kind).join(", ")}`:"";console.log(s.dim(` - ${t.name}${r}`))}console.log()}if(o.hooks.length>0){console.log(s.bold("Hook Participation:"));for(let t of o.hooks)console.log(s.dim(` - ${t.hook} [#${t.order}] ${t.source.label}`));console.log()}if(o.failures.length>0){console.log(s.bold("Recent Failures:"));for(let t of o.failures.slice(-10))console.log(s.dim(` - [${t.stage}] ${t.source.label}: ${t.target} -> ${t.message}`));console.log()}},"handler")},{name:"sandbox",description:"Inspect the optional ASRT sandbox backend",usage:"/sandbox",handler:i(async(e,o,n)=>{if(e.length>0){console.log(s.red(`
|
|
462
|
+
[Usage: /sandbox]`));return}if(!n.inspectSandbox){console.log(s.dim(`
|
|
463
|
+
Sandbox diagnostics are unavailable because this host did not provide them.
|
|
464
|
+
`));return}let t=await n.inspectSandbox(),r=t.ready?s.green("ready"):s.yellow("unavailable");console.log(s.bold(`
|
|
465
|
+
Sandbox
|
|
466
|
+
`)),console.log(s.dim(` Status: ${r}`)),console.log(s.dim(` Platform: ${t.platform}`)),console.log(s.dim(` Backend: ${t.backend}`)),console.log(s.dim(` ASRT: ${t.version}`));for(let a of t.diagnostics)console.log(s.dim(` Diagnostic: ${a}`));if(!t.ready)for(let a of t.guidance)console.log(s.dim(` Guidance: ${a}`));console.log()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
467
|
+
/sandbox - Inspect Sandbox Readiness
|
|
468
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /sandbox ")+"Refresh and display ASRT readiness"),console.log(),console.log(s.dim("This command is read-only. It never activates ASRT or requests elevation.")),console.log(s.dim("Use `kodax sandbox setup` explicitly when activation is required.")),console.log()},"detailedHelp")},{name:"status",aliases:["info","ctx"],description:"Show current session status",handler:i(async(e,o,n,t)=>{await Hu(o,t,e,n)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
469
|
+
/status - Show Session Status
|
|
470
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /status ")+"Display current session information"),console.log(s.dim(" /status workspace ")+"Show deeper workspace/runtime details"),console.log(s.dim(" /status runtime ")+"Show SDK runtime mode, identity, and queue counters"),console.log(s.dim(" /info, /ctx ")+"Aliases for /status"),console.log(),console.log(s.bold("Displays:")),console.log(s.dim(" - Current mode (code/ask)")),console.log(s.dim(" - Session ID")),console.log(s.dim(" - Message count")),console.log(s.dim(" - Estimated token usage")),console.log(s.dim(" - Current workspace truth")),console.log(s.dim(" - Session timestamps")),console.log(s.dim(" - Repo-intelligence mode and active runtime summary")),console.log()},"detailedHelp")},{name:"mcp",description:"Show MCP server status or refresh catalogs",usage:"/mcp [status|refresh]",handler:i(async e=>{let o=ne();if(!o){console.log(s.yellow(`
|
|
471
|
+
[No extension runtime active \u2014 MCP is not available]`));return}let t=no(o).capabilityProviders.find(c=>c.id==="mcp");if((e[0]?.toLowerCase()??"status")==="refresh"){console.log(s.dim(`
|
|
472
|
+
Refreshing MCP catalogs...`));try{await o.refreshCapabilityProviders("mcp"),console.log(s.green("MCP catalogs refreshed."))}catch(c){console.log(s.red(`Refresh failed: ${c instanceof Error?c.message:String(c)}`))}return}if(console.log(s.cyan(`
|
|
473
|
+
MCP Status
|
|
474
|
+
`)),!t){console.log(s.yellow(" No MCP provider registered.")),console.log(s.dim(" Add servers to ~/.kodax/integrations/mcp.json or run `kodax mcp add`.\n"));return}let l=t.metadata?.servers??[];console.log(s.dim(` Servers: ${l.length}`)),console.log();for(let c of l){let d=c.status==="ready"?s.green:c.status==="error"?s.red:s.yellow;console.log(` ${s.bold(c.serverId)} ${d(c.status)} connect=${s.dim(c.connect)}`),c.cachedAt&&console.log(s.dim(` tools=${c.tools} resources=${c.resources} prompts=${c.prompts}`)),c.lastError&&console.log(s.red(` error: ${c.lastError}`))}console.log()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
475
|
+
/mcp - MCP Server Management
|
|
476
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /mcp ")+"Show MCP server status"),console.log(s.dim(" /mcp status ")+"Same as /mcp"),console.log(s.dim(" /mcp refresh ")+"Force-refresh all MCP server catalogs"),console.log(s.dim(" Config: ~/.kodax/integrations/mcp.json")),console.log(s.dim(" Template: ~/.kodax/integrations/mcp.example.jsonc")),console.log()},"detailedHelp")},{name:"repo-intel",description:"Inspect built-in repo intelligence",usage:"/repo-intel [status|mode|trace]",handler:i(async(e,o,n,t)=>{let r=e[0]?.toLowerCase()??"status";if(r==="status"){let a=await Ho({mode:t.repoIntelligenceMode,trace:t.repoIntelligenceTrace,probe:!0,workspaceRoot:cr(o)});ga(a);return}if(r==="mode"){if(e.length===1){console.log(s.dim(`
|
|
477
|
+
Current repo-intelligence mode: ${s.cyan(t.repoIntelligenceMode??"auto")}`)),console.log(s.dim(`Usage: /repo-intel mode [auto|full|light|off]
|
|
478
|
+
`));return}let a=Pu(e[1]);if(!a){console.log(s.red(`
|
|
479
|
+
[Invalid repo-intelligence mode: ${e[1]}]`)),console.log(s.dim(`Usage: /repo-intel mode [auto|full|light|off]
|
|
480
|
+
`));return}let l=pa({mode:a},{repoIntelligenceMode:a},n,t);oo(`Repo intelligence mode: ${a}`,l);return}if(r==="trace"){let a=e[1]?.toLowerCase();if(!a){console.log(s.dim(`
|
|
481
|
+
Current repo-intelligence trace: ${s.cyan(t.repoIntelligenceTrace?"on":"off")}`)),console.log(s.dim(`Usage: /repo-intel trace [on|off|toggle]
|
|
482
|
+
`));return}let l=Lu(a,t.repoIntelligenceTrace??!1);if(l===null){console.log(s.red(`
|
|
483
|
+
[Invalid trace value: ${e[1]}]`)),console.log(s.dim(`Usage: /repo-intel trace [on|off|toggle]
|
|
484
|
+
`));return}let c=pa({trace:l},{repoIntelligenceTrace:l},n,t);oo(`Repo intelligence trace: ${l?"on":"off"}`,c);return}if(r==="refresh"){console.log(s.yellow(`
|
|
485
|
+
[Repo intelligence refresh is automatic in this build]`)),console.log(s.dim(`Use /repo-intel status to inspect the current engine state.
|
|
486
|
+
`));return}console.log(s.red(`
|
|
487
|
+
[Unknown /repo-intel subcommand: ${e[0]}]`)),console.log(s.dim(`Usage: /repo-intel [status|mode|trace]
|
|
488
|
+
`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
489
|
+
/repo-intel - Built-in Repo Intelligence
|
|
490
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /repo-intel ")+"Show built-in repo-intelligence status"),console.log(s.dim(" /repo-intel status ")+"Show built-in engine status without probing an external daemon"),console.log(s.dim(" /repo-intel mode auto ")+"Let KodaX pick the best repo-intelligence engine"),console.log(s.dim(" /repo-intel mode full ")+"Prefer the full repo-intelligence engine"),console.log(s.dim(" /repo-intel mode light ")+"Use the light repo-intelligence engine"),console.log(s.dim(" /repo-intel mode off ")+"Disable repo-intelligence injection"),console.log(s.dim(" /repo-intel trace on|off|toggle ")+"Toggle repo-intelligence trace output"),console.log(),console.log(s.bold("Notes:")),console.log(s.dim(" - /status now includes a compact repo-intelligence summary.")),console.log(s.dim(" - External repointel endpoint/bin controls are deprecated for built-in KodaX.")),console.log()},"detailedHelp")},{name:"repointel",aliases:["ri"],description:"Deprecated alias for /repo-intel status",usage:"/repointel [status]",userInvocable:!1,handler:i(async(e,o,n,t)=>{let r=e[0]?.toLowerCase()??"status";if(console.log(s.yellow(`
|
|
491
|
+
[/repointel is deprecated; use /repo-intel status]
|
|
492
|
+
`)),r==="status"){let a=await Ho({mode:t.repoIntelligenceMode,trace:t.repoIntelligenceTrace,probe:!0,workspaceRoot:cr(o)});ga(a);return}if(r==="mode"){console.log(s.dim(`Use /repo-intel mode [auto|full|light|off] to change repo-intelligence mode.
|
|
493
|
+
`));return}if(r==="trace"){console.log(s.dim(`Use /repo-intel trace [on|off|toggle] to change repo-intelligence trace output.
|
|
494
|
+
`));return}if(r==="warm"||r==="endpoint"||r==="bin"){console.log(s.dim("Repo intelligence is built into KodaX; external daemon/bin controls are no longer a normal REPL command surface.")),console.log(s.dim(`Use /repo-intel status to inspect the active engine.
|
|
495
|
+
`));return}console.log(s.dim(`Usage: /repointel [status]
|
|
496
|
+
`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
497
|
+
/repointel - Deprecated
|
|
498
|
+
`)),console.log(s.dim("Use /repo-intel status for built-in repo-intelligence diagnostics.")),console.log(s.dim("External endpoint/bin/warm controls are deprecated for KodaX.")),console.log()},"detailedHelp")},{name:"fallback",description:"Configure the cross-provider fallback chain for child tasks",usage:"/fallback [status | <p1,p2,...> | off]",handler:i(async(e,o,n,t)=>{let r=(process.env.KODAX_FALLBACK_PROVIDERS??"").split(",").map(c=>c.trim()).filter(Boolean),a=e[0]?.toLowerCase();if(!a||a==="status"){r.length===0?console.log(s.dim(`
|
|
499
|
+
Child-task provider fallback: `)+s.yellow("off")+s.dim(" (no chain configured)")):(console.log(s.dim(`
|
|
500
|
+
Child-task provider fallback: `)+s.green("on")),console.log(s.dim(" Order: ")+s.cyan(r.join(" \u2192 ")))),console.log(s.dim(`
|
|
501
|
+
When a child's primary provider is exhausted/down, KodaX re-runs it`)),console.log(s.dim(` on the next provider in this list. Set: /fallback ark-coding,kimi-code
|
|
502
|
+
`));return}if(a==="off"||a==="clear"||a==="none"){Se({fallbackProviders:void 0}),delete process.env.KODAX_FALLBACK_PROVIDERS,console.log(s.green(`
|
|
503
|
+
\u2713 `)+s.dim(`Child-task provider fallback disabled.
|
|
504
|
+
`));return}let l=e.join(",").split(",").map(c=>c.trim()).filter(Boolean);if(l.length===0){console.log(s.red(`
|
|
505
|
+
[/fallback: no provider ids given]`)),console.log(s.dim(`Usage: /fallback ark-coding,kimi-code (or /fallback off)
|
|
506
|
+
`));return}Se({fallbackProviders:l}),process.env.KODAX_FALLBACK_PROVIDERS=l.join(","),console.log(s.green(`
|
|
507
|
+
\u2713 `)+s.dim("Child-task fallback order: ")+s.cyan(l.join(" \u2192 "))),console.log(s.dim(` Provider ids must match your configured providers (see /status or kodax doctor).
|
|
508
|
+
`))},"handler")},{name:"mode",description:"Show or switch permission mode (plan/accept-edits/auto)",usage:"/mode [plan|accept-edits|auto]",handler:i(async(e,o,n,t)=>{if(e.length===0){let a=go(t.permissionMode,"accept-edits")??"accept-edits";console.log(s.dim(`
|
|
509
|
+
Current mode: ${s.cyan(a)}`)),console.log(s.dim("Usage: /mode [plan|accept-edits|auto]"));return}let r=e[0];Jo.includes(r)?(n.setPermissionMode?await n.setPermissionMode(r):t.permissionMode=r,dt(r),console.log(s.cyan(`
|
|
510
|
+
[Switched to ${r} mode] (saved)`))):console.log(s.red(`
|
|
511
|
+
[Unknown mode: ${e[0]}. Use: plan | accept-edits | auto]`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
512
|
+
/mode - Switch Permission Mode
|
|
513
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /mode ")+"Show current permission mode"),console.log(s.dim(" /mode plan ")+"Read-only: blocks all modifications"),console.log(s.dim(" /mode accept-edits ")+"File edits auto, bash requires confirmation"),console.log(s.dim(" /mode auto ")+"LLM classifier reviews each tool call (FEATURE_092)"),console.log(s.dim(" /mode auto-in-project ")+s.gray("(deprecated alias for auto; will be removed in v0.7.38)")),console.log(),console.log(s.bold("Permission Levels:")),console.log(s.yellow(" plan ")+s.dim("- Read-only planning, no file/command modifications")),console.log(s.green(" accept-edits ")+s.dim("- File edits auto-approved, bash still requires confirmation")),console.log(s.green(" auto ")+s.dim("- LLM classifier (engine=llm, default) or rules engine reviews each call")),console.log(),console.log(s.bold("Notes:")),console.log(s.dim(" - .kodax/ directory and project-external paths always require confirmation")),console.log(s.dim(" - Mode is saved to ~/.kodax/config.json (user-level)")),console.log()},"detailedHelp")},{name:"auto-engine",description:"Show or set auto-mode classifier engine (llm | rules)",usage:"/auto-engine [llm|rules]",handler:i(async(e,o,n)=>{let t=await n.getAutoModeStats?.();if(!t){console.log(s.yellow(`
|
|
514
|
+
[auto-engine] not in auto mode \u2014 switch via /mode auto first`));return}if(e.length===0){console.log(s.dim(`
|
|
515
|
+
Classifier engine: ${s.cyan(t.engine)}`)),console.log(s.dim(` classifier health: ${t.classifierHealth}`)),t.classifierModel&&console.log(s.dim(` classifier model: ${t.classifierModel}`)),console.log(s.dim(` consecutive denials: ${t.denials.consecutive}`)),console.log(s.dim(` cumulative denials: ${t.denials.cumulative}`)),console.log(s.dim(` breaker errors: ${t.breaker.timestamps.filter(a=>a>=Date.now()-600*1e3).length}`)),console.log(s.dim("Usage: /auto-engine [llm|rules]"));return}let r=e[0];if(r!=="llm"&&r!=="rules"){console.log(s.red(`
|
|
516
|
+
[auto-engine] unknown engine "${e[0]}" \u2014 use llm or rules`));return}await n.setAutoModeEngine?.(r),console.log(s.cyan(`
|
|
517
|
+
[auto-engine] switched to ${r}`)),console.log(r==="rules"?s.dim(" deterministic workspace/temp rules are now active"):s.dim(" classifier selected; degraded health temporarily uses Accept-edits fallback"))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
518
|
+
/auto-engine - Auto-Mode Classifier Engine Toggle
|
|
519
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /auto-engine ")+"Show current engine + denial/breaker counts"),console.log(s.dim(" /auto-engine llm ")+"Resume classifier consultation (default)"),console.log(s.dim(" /auto-engine rules ")+"Skip classifier; use deterministic workspace/temp rules"),console.log(),console.log(s.bold("Notes:")),console.log(s.dim(" - Only meaningful in auto mode (/mode auto).")),console.log(s.dim(" - Denial counters are diagnostic only; they do not change the selected engine.")),console.log(s.dim(" - Five classifier failures in 10 minutes temporarily skip classifier calls")),console.log(s.dim(" and apply Accept-edits fallback; the selected engine remains llm.")),console.log(s.dim(" - Override via env: KODAX_AUTO_MODE_ENGINE=rules.")),console.log()},"detailedHelp")},{name:"auto-denials",description:"Show auto-mode classifier denial tracker + circuit breaker stats",usage:"/auto-denials",handler:i(async(e,o,n)=>{let t=await n.getAutoModeStats?.();if(!t){console.log(s.yellow(`
|
|
520
|
+
[auto-denials] not in auto mode \u2014 switch via /mode auto first`));return}console.log(s.cyan(`
|
|
521
|
+
[auto-mode classifier stats]`)),console.log(s.dim(` engine: ${s.cyan(t.engine)}`)),console.log(s.dim(` classifier health: ${t.classifierHealth}`)),console.log(s.dim(" Denial tracker:")),console.log(s.dim(` consecutive blocks: ${t.denials.consecutive} / 3`)),console.log(s.dim(` cumulative blocks: ${t.denials.cumulative} / 20`)),console.log(s.dim(" Circuit breaker:")),console.log(s.dim(` errors in window: ${t.breaker.timestamps.filter(r=>r>=Date.now()-600*1e3).length} / 5 (10 min)`)),console.log(),t.engine==="rules"?console.log(s.yellow(" \u21AA rules engine is active. /auto-engine llm to enable the classifier.")):t.classifierHealth==="degraded"&&console.log(s.yellow(" \u21AA classifier calls are temporarily skipped; Accept-edits fallback is active and engine remains llm.")),console.log()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
522
|
+
/auto-denials - Auto-Mode Classifier Diagnostic Dump
|
|
523
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /auto-denials ")+"Print engine + tracker + breaker counters"),console.log(),console.log(s.bold("Diagnostics and fallback (FEATURE_092):")),console.log(s.dim(" - Block counters are diagnostic only; they never select rules.")),console.log(s.dim(" - 5 errors in 10 min \u2192 skip classifier temporarily and use Accept-edits fallback.")),console.log(s.dim(" - The selected engine remains llm unless the user/host explicitly selects rules.")),console.log()},"detailedHelp")},{name:"save",description:"Save current session",handler:i(async(e,o,n)=>{await n.saveSession(),console.log(s.green(`
|
|
524
|
+
[Session saved]`)),ir(o)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
525
|
+
/save - Save Current Session
|
|
526
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /save ")+"Save current conversation to session storage"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Manually saves the current conversation session.")),console.log(s.dim(" Sessions are auto-saved after each message, but you can")),console.log(s.dim(" use this to ensure the session is persisted.")),console.log(s.dim(" Saving updates session storage only; the current workspace stays untouched.")),console.log(),console.log(s.dim(" See also: /help load, /help sessions")),console.log()},"detailedHelp")},{name:"load",aliases:["resume"],description:"Load a session",usage:"/load <session-id>",handler:i(async(e,o,n)=>{if(e.length===0){console.log(s.red(`
|
|
527
|
+
[Usage: /load <session-id>]`)),await n.listSessions();return}await n.loadSession(e[0])==="missing"&&console.log(s.red(`
|
|
528
|
+
[Session not found: ${e[0]}]`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
529
|
+
/load - Load a Saved Session
|
|
530
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /load ")+"List available sessions"),console.log(s.dim(" /load <session-id> ")+"Load a specific session"),console.log(s.dim(" /resume <id> ")+"Alias for /load"),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /load ")+"# See all sessions"),console.log(s.dim(" /load 20260219_143052")+"# Load session by ID"),console.log(),console.log(s.bold("Workspace behavior:")),console.log(s.dim(" /load can resume sessions from sibling workspaces in the same canonical repo.")),console.log(s.dim(" If a saved workspace is unavailable, KodaX explains the fallback before loading.")),console.log(),console.log(s.dim(" See also: /help sessions, /help save")),console.log()},"detailedHelp")},{name:"tree",description:"Inspect or switch the current session tree",usage:"/tree [entry-id|label] | /tree label <entry-id|label> <name> | /tree unlabel <entry-id|label>",handler:i(async(e,o,n)=>{if(e.length===0){await n.printSessionTree?.();return}let t=e[0]?.trim().toLowerCase();if(t==="label"){if(e.length<3){console.log(s.red(`
|
|
531
|
+
[Usage: /tree label <entry-id|label> <name>]`));return}await n.labelSessionBranch?.(e[1],e.slice(2).join(" "))||console.log(s.red(`
|
|
532
|
+
[Tree entry not found: ${e[1]}]`));return}if(t==="unlabel"){if(e.length<2){console.log(s.red(`
|
|
533
|
+
[Usage: /tree unlabel <entry-id|label>]`));return}await n.labelSessionBranch?.(e[1],void 0)||console.log(s.red(`
|
|
534
|
+
[Tree entry not found: ${e[1]}]`));return}await n.switchSessionBranch?.(e[0])==="missing"&&console.log(s.red(`
|
|
535
|
+
[Tree entry not found: ${e[0]}]`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
536
|
+
/tree - Inspect Session Lineage
|
|
537
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /tree ")+"Show the current session tree"),console.log(s.dim(" /tree <entry-id|label> ")+"Jump to a previous branch point"),console.log(s.dim(" /tree label <entry-id|label> <name>")+"Attach a lightweight checkpoint label"),console.log(s.dim(" /tree unlabel <entry-id|label> ")+"Clear an existing checkpoint label"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Session history is stored as a branchable tree. Use /tree to")),console.log(s.dim(" inspect the lineage, revisit an earlier branch safely, and add")),console.log(s.dim(" bookmark-style checkpoint labels without changing git state.")),console.log()},"detailedHelp")},{name:"fork",description:"Fork the current branch into a new session",usage:"/fork [entry-id|label]",handler:i(async(e,o,n)=>{await n.forkSession?.(e[0])==="failed"&&console.log(s.red(`
|
|
538
|
+
[Unable to fork session${e[0]?` from ${e[0]}`:""}]`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
539
|
+
/fork - Export a Branch to a New Session
|
|
540
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /fork ")+"Fork from the active branch"),console.log(s.dim(" /fork <entry-id|label>")+"Fork from a selected tree node"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Creates a new session file from the selected branch so you can")),console.log(s.dim(" continue there without mutating the current session lineage.")),console.log()},"detailedHelp")},{name:"rewind",description:"Rewind the current session to a previous point",usage:"/rewind [entry-id|label]",handler:i(async(e,o,n)=>{await n.rewindSession?.(e[0])==="failed"&&console.log(s.red(`
|
|
541
|
+
[Unable to rewind${e[0]?` to ${e[0]}`:" \u2014 no previous turn found"}]`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
542
|
+
/rewind - Rewind Session to a Previous Point
|
|
543
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /rewind ")+"Rewind to the previous user input"),console.log(s.dim(" /rewind <entry-id|label>")+"Rewind to a specific tree node"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Truncates the session after the target entry. Unlike /fork,")),console.log(s.dim(" this modifies the current session in place. The rewind event")),console.log(s.dim(" is recorded in the lineage for auditability.")),console.log(),console.log(s.yellow(" \u26A0 This is irreversible. Use /fork first to preserve a copy.")),console.log()},"detailedHelp")},{name:"sessions",aliases:["ls","list"],description:"List recent sessions",handler:i(async(e,o,n)=>{await n.listSessions()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
544
|
+
/sessions - List Saved Sessions
|
|
545
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /sessions ")+"List all saved sessions"),console.log(s.dim(" /ls, /list ")+"Aliases for /sessions"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Shows recent conversation sessions with their IDs,")),console.log(s.dim(" message counts, titles, and workspace truth. Use /load <id> to resume.")),console.log(s.dim(" This keeps sibling worktree sessions inspectable without a persistent cockpit.")),console.log(),console.log(s.dim(" See also: /help load, /help delete")),console.log()},"detailedHelp")},{name:"history",aliases:["hist"],description:"Show conversation history",handler:i(async(e,o,n)=>{n.printHistory()},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
546
|
+
/history - Show Conversation History
|
|
547
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /history ")+"Display recent messages in current session"),console.log(s.dim(" /hist ")+"Alias for /history"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Shows the last 20 messages in the current conversation.")),console.log(s.dim(" Useful for reviewing what has been discussed.")),console.log()},"detailedHelp")},{name:"delete",aliases:["rm","del"],description:"Delete a session",usage:"/delete <session-id> or /delete all",handler:i(async(e,o,n)=>{if(e.length===0){console.log(s.red(`
|
|
548
|
+
[Usage: /delete <session-id> or /delete all]`)),await n.listSessions?.();return}e[0]==="all"?(await n.deleteAllSessions?.(),console.log(s.green(`
|
|
549
|
+
[All sessions deleted]`)),ir(o)):(await n.deleteSession?.(e[0]),console.log(s.green(`
|
|
550
|
+
[Session deleted: ${e[0]}]`)),ir(o))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
551
|
+
/delete - Delete Saved Sessions
|
|
552
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /delete ")+"Show usage (lists sessions)"),console.log(s.dim(" /delete <id> ")+"Delete a specific session"),console.log(s.dim(" /delete all ")+"Delete ALL sessions"),console.log(s.dim(" /rm, /del ")+"Aliases for /delete"),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /delete 20260219_143052")+" # Delete specific session"),console.log(s.dim(" /delete all ")+"# Delete all sessions"),console.log(),console.log(s.bold("Workspace behavior:")),console.log(s.dim(" Deletes saved session records only.")),console.log(s.dim(" Current workspaces and checkouts remain untouched.")),console.log(),console.log(s.yellow(" Warning: /delete all cannot be undone!")),console.log()},"detailedHelp")},{name:"model",aliases:["m"],description:"Show or switch provider/model",usage:"/model [<provider>[/<model>] | /<model>]",handler:i(async(e,o,n,t)=>{let r=Yo().providerModels;if(e.length===0){console.log(s.bold(`
|
|
553
|
+
Available Providers:
|
|
554
|
+
`));let c=ms(r);for(let d of c){let u=d.configured?s.green("[configured]"):s.red("[not configured]"),f=d.custom?s.yellow(" [custom]"):"",m=d.name===t.provider,b=m?s.cyan(" *"):"";console.log(` ${s.bold(d.name)}${b} ${u}${f}`),d.capabilityProfile.transport==="cli-bridge"&&console.log(s.yellow(` ! ${Zn(d.capabilityProfile)}`));let S=Be(d.name,r),C=m?t.model:null;for(let A of S){let x=m&&(C===A||!C&&A===d.model)?s.cyan(">"):" ";console.log(` ${x} ${A}`)}console.log()}console.log(s.dim(`Current: provider=${t.provider}${t.model?`, model=${t.model}`:""}`)),console.log(s.dim("Usage:")),console.log(s.dim(" /model <provider> Switch provider")),console.log(s.dim(" /model <provider>/<model> Switch to specific model")),console.log(s.dim(` /model /<model> Switch model within current provider
|
|
555
|
+
`));return}let a=(e[0]??"").trim();if(!a)return;if(a.startsWith("/")){let c=a.slice(1);if(!c){console.log(s.red(`
|
|
556
|
+
[Missing model name after /]`));return}let d=Be(t.provider,r);if(!d.includes(c)){console.log(s.red(`
|
|
557
|
+
[Unknown model: ${c}]`)),console.log(s.dim(`Available models for ${t.provider}: ${d.join(", ")}
|
|
558
|
+
`));return}Se({model:c}),n.switchProvider?.(t.provider,c),console.log(s.cyan(`
|
|
559
|
+
[Switched to ${c}] (saved)`));return}if(a.includes("/")){let c=a.indexOf("/"),d=a.slice(0,c),u=a.slice(c+1);if(!u||!d){console.log(s.red(`
|
|
560
|
+
[Invalid format. Use: /model <provider>/<model>]`));return}if(!Oe(d)){console.log(s.red(`
|
|
561
|
+
[Unknown provider: ${d}]`)),console.log(s.dim(`Available: ${Ne().join(", ")}
|
|
562
|
+
`));return}let f=Be(d,r);if(!f.includes(u)){console.log(s.red(`
|
|
563
|
+
[Unknown model: ${u}]`)),console.log(s.dim(`Available models for ${d}: ${f.join(", ")}
|
|
564
|
+
`));return}Se({provider:d,model:u}),n.switchProvider?.(d,u),console.log(s.cyan(`
|
|
565
|
+
[Switched to ${d}/${u}] (saved)`));return}let l=a;Oe(l)?(Se({provider:l,model:void 0}),n.switchProvider?.(l),console.log(s.cyan(`
|
|
566
|
+
[Switched to ${l}] (saved)`))):(console.log(s.red(`
|
|
567
|
+
[Unknown provider: ${l}]`)),console.log(s.dim(`Available: ${Ne().join(", ")}
|
|
568
|
+
`)))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
569
|
+
/model - Switch LLM Provider/Model
|
|
570
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /model ")+"List all providers with models"),console.log(s.dim(" /model <provider> ")+"Switch to a provider (default model)"),console.log(s.dim(" /model <provider>/<model> ")+"Switch to a specific model"),console.log(s.dim(" /model /<model> ")+"Switch model within current provider"),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /model ")+"# See available providers & models"),console.log(s.dim(" /model anthropic ")+"# Switch to Anthropic (default model)"),console.log(s.dim(" /model openai/gpt-5.4 ")+"# Switch to OpenAI GPT-5.4"),console.log(s.dim(" /model /claude-opus-4-6 ")+"# Switch to Opus within current provider"),console.log()},"detailedHelp")},{name:"provider",description:"Inspect provider semantics and policy constraints",usage:"/provider [<provider>[/<model>]]",handler:i(async(e,o,n,t)=>{let r=(e[0]??"").trim();if(r==="forget-capability"){let f=(e[1]??"").trim();if(!f){Bn(),console.log(s.dim(`
|
|
571
|
+
[Cleared all learned capability overrides]
|
|
572
|
+
`));return}let m=f.indexOf("/"),b=m===-1?f:f.slice(0,m),S=m===-1?void 0:f.slice(m+1)||void 0;Bn(b,S),console.log(s.dim(`
|
|
573
|
+
[Cleared learned capability overrides for ${b}${S?`/${S}`:""}]
|
|
574
|
+
`));return}if(r==="probe"){let f=Vo(t.provider,t.model).filter(b=>b!=="auto"&&b!=="off"),m=`${t.provider}/${t.model??"(default)"}`;console.log(s.dim(`
|
|
575
|
+
[Probing ${m} \u2014 ${f.length} efforts, minimal requests\u2026]`));try{let b=await Fs({provider:t.provider,model:t.model,efforts:f,resolve:Hn,now:i(()=>new Date().toISOString(),"now")});for(let S of b){let C=S.status==="accepted"?s.green("\u2713"):S.status==="rejected"?s.red("\u2717"):s.yellow("!");console.log(s.dim(` ${C} ${S.effort}${S.error?` \u2014 ${S.error}`:""}`))}console.log(s.dim(` (rejections recorded; undo with /provider forget-capability)
|
|
576
|
+
`))}catch(b){let S=b instanceof Error?b.message:String(b);console.log(s.red(`
|
|
577
|
+
[Probe failed: ${S}]
|
|
578
|
+
`))}return}let a=t.provider,l=t.model;if(r)if(r.includes("/")){let f=r.indexOf("/");a=r.slice(0,f).trim(),l=r.slice(f+1).trim()||void 0}else a=r,l=void 0;if(!Oe(a)){console.log(s.red(`
|
|
579
|
+
[Unknown provider: ${a}]`)),console.log(s.dim(`Available: ${Ne().join(", ")}
|
|
580
|
+
`));return}let c=ds(a,l);if(!c){console.log(s.red(`
|
|
581
|
+
[Provider details unavailable: ${a}]`)),console.log();return}let d=hs(a,l,t.reasoningMode);console.log(s.bold(`
|
|
582
|
+
Provider Details:
|
|
583
|
+
`)),console.log(s.dim(` Provider: ${s.cyan(c.provider)}${c.model?` / ${s.cyan(c.model)}`:""}`)),console.log(s.dim(` Source: ${gs(c.sourceKind)}`)),console.log(),console.log(s.bold("Capability Matrix:"));for(let f of ws(c))console.log(s.dim(` - ${f}`));console.log(s.dim(` - Session effort: ${ka(t.effort)}`));let u=xr(a,l);if(u.length>0&&console.log(s.dim(` - Learned unsupported: ${u.join(", ")} (clear with /provider forget-capability)`)),console.log(),d.length>0){console.log(s.bold("Common Scenarios:"));for(let f of d){let m=f.decision.status==="block"?s.red:f.decision.status==="warn"?s.yellow:s.green;console.log(m(` - ${f.label}: ${f.decision.status.toUpperCase()}`)),console.log(s.dim(` ${f.decision.summary}`))}console.log()}},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
584
|
+
/provider - Inspect Provider Semantics
|
|
585
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /provider ")+"Inspect the current provider/model"),console.log(s.dim(" /provider <provider> ")+"Inspect a provider using its default model"),console.log(s.dim(" /provider <provider>/<model> ")+"Inspect a specific provider/model pair"),console.log(s.dim(" /provider probe ")+"Send minimal requests to learn which efforts the model rejects"),console.log(s.dim(" /provider forget-capability [<provider>[/<model>]]")),console.log(s.dim(" ")+"Clear learned (observed/probed) effort rejections; re-offer those rungs"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Shows the provider capability matrix and common 029 policy outcomes.")),console.log(s.dim(" Use this to understand why long-running, harness, or evidence-heavy flows may warn or block.")),console.log()},"detailedHelp")},{name:"thinking",aliases:["think","t"],description:"Show or set native reasoning effort",usage:"/thinking [none|auto|low|medium|high|xhigh|max]",handler:i(async(e,o,n,t)=>{await ar("thinking",e,n,t)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
586
|
+
/thinking - Set Native Reasoning Effort
|
|
587
|
+
`)),console.log(s.bold("Usage:")),ma("thinking"),console.log(s.dim(" /t ")+"Alias for /thinking"),console.log()},"detailedHelp")},{name:"reasoning",aliases:["reason"],description:"Show or set native reasoning effort",usage:"/reasoning [none|auto|low|medium|high|xhigh|max]",handler:i(async(e,o,n,t)=>{await ar("reasoning",e,n,t)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
588
|
+
/reasoning - Set Native Reasoning Effort
|
|
589
|
+
`)),console.log(s.bold("Usage:")),ma("reasoning"),console.log(s.dim(" /reason ")+"Alias for /reasoning"),console.log()},"detailedHelp")},{name:"effort",description:"Show or set native reasoning effort",usage:"/effort [level]",handler:i(async(e,o,n,t)=>{await ar("effort",e,n,t)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
590
|
+
/effort - Set Native Reasoning Effort
|
|
591
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /effort ")+"Show current native reasoning effort"),console.log(s.dim(" /effort auto ")+"Clear the explicit effort override"),console.log(s.dim(" /effort off ")+"Disable reasoning effort"),console.log(s.dim(" /effort low ")+"Use low native reasoning effort"),console.log(s.dim(" /effort medium ")+"Use medium native reasoning effort"),console.log(s.dim(" /effort high ")+"Use high native reasoning effort"),console.log(s.dim(" /effort xhigh ")+"Use extra-high effort when the model supports it"),console.log(s.dim(" /effort max ")+"Use max effort when the model supports it"),console.log(s.dim(" /effort none ")+"Legacy alias for /effort off"),console.log(s.dim(`
|
|
592
|
+
Run /effort to see the active model's supported values.`)),console.log()},"detailedHelp")},{name:"agent-mode",aliases:["am"],description:"Show or set agent mode",usage:"/agent-mode [ama|sa|toggle]",handler:i(async(e,o,n,t)=>{if(e.length===0){console.log(s.dim(`
|
|
593
|
+
Agent mode: ${s.cyan(t.agentMode.toUpperCase())}`)),console.log(s.dim(`Usage: /agent-mode [ama|sa|toggle]
|
|
594
|
+
`));return}let r=e[0]?.toLowerCase();if(r==="amaw"||r==="ama-workflow"){console.log(s.yellow(`
|
|
595
|
+
[AMAW was retired in v0.7.72. Use AMA; Workflow execution now requires an explicit /workflow request.]`));return}let a=r==="toggle"?Qs(t.agentMode):r==="ama"||r==="sa"?r:void 0;if(!a){console.log(s.red(`
|
|
596
|
+
[Invalid agent mode: ${e[0]}]`)),console.log(s.dim(`Usage: /agent-mode [ama|sa|toggle]
|
|
597
|
+
`));return}let l=Ou(a,n,t);oo(`Agent mode: ${a.toUpperCase()}`,l)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
598
|
+
/agent-mode - Adaptive Multi-Agent Mode Control
|
|
599
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /agent-mode ")+"Show current agent mode"),console.log(s.dim(" /agent-mode ama ")+"Adaptive multi-agent mode; workflows require an explicit /workflow request"),console.log(s.dim(" /agent-mode sa ")+"Force single-agent execution"),console.log(s.dim(" /agent-mode toggle ")+"Cycle AMA -> SA"),console.log(s.dim(" /am ")+"Alias for /agent-mode"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" AMA runs the adaptive multi-agent harness. Sub-agents are available when parallel")),console.log(s.dim(" work materially improves speed or quality. Workflows only run when explicitly")),console.log(s.dim(" requested with /workflow or by naming a Workflow.")),console.log(s.dim(" SA forces a single solo agent \u2014 no sub-agents and no workflows \u2014 to save tokens.")),console.log()},"detailedHelp")},{name:"auto",aliases:["a"],description:"Quick switch to auto mode",handler:i(async(e,o,n,t)=>{t.permissionMode="auto",n.setPermissionMode?.("auto"),dt("auto"),console.log(s.cyan(`
|
|
600
|
+
[Switched to auto mode] (saved)`))},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
601
|
+
/auto - Quick Switch to Auto Mode
|
|
602
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /auto ")+"Switch to auto mode"),console.log(s.dim(" /a ")+"Alias for /auto"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Equivalent to /mode auto.")),console.log(s.dim(" Auto-mode classifier evaluates each non-Tier-1 tool call;")),console.log(s.dim(" benign actions auto-approve, risky ones escalate to user confirm.")),console.log(),console.log(s.dim(" See also: /help mode, /auto-engine, /auto-denials")),console.log()},"detailedHelp")},{name:"skill",description:"Skill namespace - list, invoke, or review skill learning",usage:"/skill[:name] [pending|args]",handler:i(async(e,o)=>{if((e[0]??"").toLowerCase()==="pending"){await fn(un(o),"skill");return}await Gu(e,o)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
603
|
+
/skill - Skill Namespace
|
|
604
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /skill ")+"List all available skills"),console.log(s.dim(" /<skill-name> [args] ")+"Invoke a skill when no command uses that name"),console.log(s.dim(" /skill:<name> [args] ")+"Invoke a skill with the compatibility form"),console.log(s.dim(" /skill reload ")+"Reload skills from disk"),console.log(s.dim(" /skill pending ")+"List pending method-guide learning suggestions"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" Direct slash skill invocation follows the Claude Code style.")),console.log(s.dim(" Built-in and extension commands keep priority when names overlap.")),console.log(s.dim(" The /skill:<name> form remains supported for compatibility.")),console.log(s.dim(" Skills can also be triggered by natural language - just ask!")),console.log(),console.log(s.bold("Examples:")),console.log(s.dim(" /skill ")+"# List all skills"),console.log(s.dim(" /skill reload ")+"# Reload skills after editing ~/.kodax/skills"),console.log(s.dim(" /code-review src/ ")+"# Invoke code-review skill"),console.log(s.dim(" /skill:code-review src/ ")+"# Compatibility form"),console.log(s.dim(" /skill:tdd auth ")+"# Invoke TDD skill"),console.log()},"detailedHelp")},{name:"verifier-log",description:"Toggle Sidecar Verifier log line (off by default)",usage:"/verifier-log [on|off]",argumentHint:"on | off",handler:i(async e=>{let o=e[0]?.toLowerCase(),n=process.env.KODAX_VERIFIER_LOG==="1";if(!o){let a=Yo().verifierLog===!0,l=n?"on":"off",c=a===n?"":` (env=${n?"on":"off"}, config=${a?"on":"off"})`;console.log(s.dim(`
|
|
605
|
+
Sidecar Verifier log: ${s.cyan(l)}${c}`)),console.log(s.dim(" When on, a one-line summary persists per verifier call:\n `[Sidecar Verifier] {verdict} \xB7 {provider}/{model} \xB7 {ms}ms \xB7 {trace}`")),console.log(s.dim(`Usage: /verifier-log [on|off]
|
|
606
|
+
`));return}let t;if(o==="on"||o==="true"||o==="1")t=!0;else if(o==="off"||o==="false"||o==="0")t=!1;else{console.log(s.red(`
|
|
607
|
+
[Invalid value: ${e[0]}]`)),console.log(s.dim(`Usage: /verifier-log [on|off]
|
|
608
|
+
`));return}t?process.env.KODAX_VERIFIER_LOG="1":delete process.env.KODAX_VERIFIER_LOG;let r=Mo({verifierLog:t});oo(`Sidecar Verifier log: ${t?"on":"off"}`,r)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
609
|
+
/verifier-log - Sidecar Verifier Log Toggle
|
|
610
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /verifier-log ")+"Show current state"),console.log(s.dim(" /verifier-log on ")+"Enable + persist to config"),console.log(s.dim(" /verifier-log off ")+"Disable + persist to config"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" The Sidecar Verifier is the second-pass LLM judgment that fires")),console.log(s.dim(" after a Worker terminates text-only. Off by default (silent happy")),console.log(s.dim(" path). When on, every verifier call emits a one-line summary:")),console.log(s.dim(" [Sidecar Verifier] accept \xB7 anthropic/claude-sonnet-4-6 \xB7 3214ms \xB7 verifier_ok")),console.log(),console.log(s.bold("Equivalent env var:")),console.log(s.dim(" KODAX_VERIFIER_LOG=1 ")+"Same effect, env wins over config"),console.log()},"detailedHelp")},{name:"stall-log",description:"Toggle Stall Sidecar log line (off by default)",usage:"/stall-log [on|off]",argumentHint:"on | off",handler:i(async e=>{let o=e[0]?.toLowerCase(),n=process.env.KODAX_STALL_LOG==="1";if(!o){let a=Yo().stallLog===!0,l=n?"on":"off",c=a===n?"":` (env=${n?"on":"off"}, config=${a?"on":"off"})`;console.log(s.dim(`
|
|
611
|
+
Stall Sidecar log: ${s.cyan(l)}${c}`)),console.log(s.dim(" When on, a one-line summary persists per L2 stall verdict:\n `[Stall Sidecar] isStuck={true|false} \xB7 {provider}/{model} \xB7 {ms}ms \xB7 {trace}`")),console.log(s.dim(`Usage: /stall-log [on|off]
|
|
612
|
+
`));return}let t;if(o==="on"||o==="true"||o==="1")t=!0;else if(o==="off"||o==="false"||o==="0")t=!1;else{console.log(s.red(`
|
|
613
|
+
[Invalid value: ${e[0]}]`)),console.log(s.dim(`Usage: /stall-log [on|off]
|
|
614
|
+
`));return}t?process.env.KODAX_STALL_LOG="1":delete process.env.KODAX_STALL_LOG;let r=Mo({stallLog:t});oo(`Stall Sidecar log: ${t?"on":"off"}`,r)},"handler"),detailedHelp:i(()=>{console.log(s.cyan(`
|
|
615
|
+
/stall-log - Stall Sidecar Log Toggle
|
|
616
|
+
`)),console.log(s.bold("Usage:")),console.log(s.dim(" /stall-log ")+"Show current state"),console.log(s.dim(" /stall-log on ")+"Enable + persist to config"),console.log(s.dim(" /stall-log off ")+"Disable + persist to config"),console.log(),console.log(s.bold("Description:")),console.log(s.dim(" The Stall Sidecar (FEATURE_178) is the L2 anti-loop LLM judge that")),console.log(s.dim(" fires when the L1 rule-based detector spots a repeat-tool pattern.")),console.log(s.dim(" Off by default (silent happy path). When on, every L2 verdict emits")),console.log(s.dim(" a one-line summary:")),console.log(s.dim(" [Stall Sidecar] isStuck=true \xB7 zhipu/glm-5.1 (inherit) \xB7 1842ms \xB7 sidecar_ok")),console.log(),console.log(s.bold("Equivalent env var:")),console.log(s.dim(" KODAX_STALL_LOG=1 ")+"Same effect, env wins over config"),console.log()},"detailedHelp")},ht,yt,vt,Ei,Qi,zt,Xt,oa,Yt],Cu={General:["help","copy","exit","clear","compact","reload","extensions","status","agents"],Permission:["mode","auto"],Session:["new","recover","save","load","sessions","history","delete"],Settings:["model","provider","thinking","reasoning","effort","agent-mode","plan","repo-intel"],Skills:["skill","learn"]};function Iu(e){let o=_o();return e.map(n=>o.get(n)).filter(n=>n!==void 0).filter(n=>n.userInvocable!==!1)}i(Iu,"getCommandsForCategory");function va(e){return e!=="off"}i(va,"reasoningModeToLegacyThinking");function ka(e){return e==="none"?"off":e??"auto"}i(ka,"formatReasoningEffortDisplay");function ba(e){return Vo(e.provider,e.model).map(o=>o==="off"?"none":o)}i(ba,"getCanonicalReasoningEffortOptions");function Tu(e,o){return`Usage: /${e} ${ba(o).join("|")}|<provider-value>`}i(Tu,"formatReasoningEffortUsage");function fa(e){let o=ps(e);return fs({provider:e.provider,model:e.model,effort:o,effortOverride:e.effortOverride,thinking:e.thinking,reasoningMode:e.reasoningMode})}i(fa,"formatCurrentReasoningEffortStatus");function Pu(e){let o=e?.trim().toLowerCase();return o==="auto"?"auto":o==="full"?"full":o==="light"?"light":o==="off"?"off":null}i(Pu,"normalizeRepoIntelPublicMode");function Lu(e,o){return e?e==="toggle"?!o:e==="on"||e==="true"||e==="1"?!0:e==="off"||e==="false"||e==="0"?!1:null:null}i(Lu,"resolveToggleFlag");function Mo(e){try{return Se(e),{saved:!0}}catch(o){return{saved:!1,error:o instanceof Error?o:new Error(String(o))}}}i(Mo,"persistUserConfig");function oo(e,o){if(o.saved){console.log(s.cyan(`
|
|
617
|
+
[${e}] (saved)`));return}console.log(s.yellow(`
|
|
618
|
+
[${e}]`)),console.log(s.red(`[Config save failed: ${o.error.message}]`))}i(oo,"printPersistedCommandStatus");var Mu={on:"auto",off:"none",quick:"low",balanced:"medium",deep:"high",med:"medium"};async function ar(e,o,n,t){let r=Tu(e,t);if(o.length===0){let f=fa(t);console.log(s.dim(`
|
|
619
|
+
Reasoning effort: ${s.cyan(f)}`)),console.log(s.dim(`Compatibility: ${s.cyan(t.reasoningMode)}`)),console.log(s.dim(`Available: ${ba(t).join(", ")}`)),console.log(s.dim(`${r}
|
|
620
|
+
`));return}if(o.length>1){console.log(s.red(`
|
|
621
|
+
[Reasoning effort accepts exactly one value]`)),console.log(s.dim(`${r}
|
|
622
|
+
`));return}let a=o[0].toLowerCase(),l;try{l=Sr(Mu[a]??a)}catch(f){let m=f instanceof Error?f.message:String(f);console.log(s.red(`
|
|
623
|
+
[Invalid reasoning effort: ${m}]`)),console.log(s.dim(`${r}
|
|
624
|
+
`));return}let c=l==="auto"||l==="unset"||l==="clear"||l==="reset"?void 0:l;if(c==="none"&&!Vo(t.provider,t.model).includes("off")){let f=t.model?`${t.provider}/${t.model}`:t.provider;console.log(s.red(`
|
|
625
|
+
[${f} does not support disabling reasoning]`)),console.log(s.dim(`${r}
|
|
626
|
+
`));return}let d=_u(c,t),u=Wu(c,n,t);oo(`Reasoning effort: ${fa(d)}`,u)}i(ar,"handleReasoningEffortCommand");function ma(e){console.log(s.dim(` /${e} `)+"Show current native reasoning effort"),console.log(s.dim(` /${e} none `)+"Disable reasoning when supported"),console.log(s.dim(` /${e} auto `)+"Clear the explicit effort override"),console.log(s.dim(` /${e} low `)+"Use low native reasoning effort"),console.log(s.dim(` /${e} medium `)+"Use medium native reasoning effort"),console.log(s.dim(` /${e} high `)+"Use high native reasoning effort"),console.log(s.dim(` /${e} xhigh `)+"Use extra-high native reasoning effort"),console.log(s.dim(` /${e} max `)+"Use maximum native reasoning effort")}i(ma,"printReasoningEffortHelp");function Sa(e){return e==="none"?"off":"auto"}i(Sa,"resolveReasoningModeAfterEffort");function _u(e,o){let n=Sa(e);return{...o,effort:e,effortOverride:e!==void 0,reasoningMode:n,thinking:va(n)}}i(_u,"resolveConfigAfterReasoningEffort");function Wu(e,o,n){let t=Sa(e),r=va(t),a=Mo({effort:e,reasoningMode:t,thinking:r});return o.setEffort?o.setEffort(e):(n.effort=e,n.effortOverride=e!==void 0),o.setReasoningMode?o.setReasoningMode(t):(n.reasoningMode=t,n.thinking=r),a}i(Wu,"applyReasoningEffort");function Ou(e,o,n){let t=Mo({agentMode:e});return o.setAgentMode?o.setAgentMode(e):n.agentMode=e,t}i(Ou,"applyAgentMode");function pa(e,o,n,t){let r=Mo(o);return n.setRepoIntelligenceRuntime?n.setRepoIntelligenceRuntime(e):(e.mode!==void 0&&(t.repoIntelligenceMode=e.mode),e.trace!==void 0&&(t.repoIntelligenceTrace=e.trace)),r}i(pa,"applyRepoIntelligenceRuntimeConfig");function Nu(e){let o=e.configuredMode===e.requestedMode?e.configuredMode:`${e.configuredMode} -> ${e.requestedMode}`,n=e.fallbackToLight?", fallback=light":"";return`${o} => ${e.effectiveEngine} (${e.status}${n})`}i(Nu,"formatRepoIntelligenceSummary");function cr(e){return e.runtimeInfo?.workspaceRoot??e.gitRoot??e.runtimeInfo?.executionCwd}i(cr,"getRepoIntelInspectionWorkspaceRoot");function Du(e){return e.status}i(Du,"formatRepoIntelStatusLabel");function Uu(e){return e.effectiveEngine==="off"?"off":e.effectiveEngine}i(Uu,"formatRepoIntelActiveEngine");function ga(e){console.log(s.bold(`
|
|
627
|
+
Repo Intelligence:
|
|
628
|
+
`)),console.log(s.dim(` Mode: ${s.cyan(e.configuredMode)}`)),console.log(s.dim(` Engine: ${s.cyan(Uu(e))}`)),console.log(s.dim(` Status: ${s.cyan(Du(e))}`)),console.log(s.dim(` Trace: ${s.cyan(e.traceEnabled?"on":"off")}`)),e.workerPath&&console.log(s.dim(` Worker: ${e.workerPath}`)),e.storageRoot&&console.log(s.dim(` Cache: ${e.storageRoot}`)),e.fallbackToLight&&console.log(s.yellow(" Fallback: light engine is currently active")),e.error&&console.log(s.red(` Error: ${e.error}`));for(let o of e.warnings)console.log(s.yellow(` Warning: ${o}`));console.log()}i(ga,"printRepoIntelStatus");function wa(e,o){if(o.length!==0){console.log(s.dim(`${e}:`));for(let n of o){let t=n.aliases?.length?` (${n.aliases.join(", ")})`:"";console.log(` ${s.cyan(`/${n.name}`)}${s.dim(t)} ${n.description}`)}console.log()}}i(wa,"printCommandSection");function ju(){console.log(s.bold(`
|
|
629
|
+
Available Commands:
|
|
630
|
+
`));let e=_o(),o=new Set;for(let[t,r]of Object.entries(Cu)){let a=Iu(r);if(a.length!==0){for(let l of a)o.add(l.name.toLowerCase());wa(t,a)}}let n=new Map;for(let t of e.getAll()){if(t.userInvocable===!1||o.has(t.name.toLowerCase()))continue;let r=t.source==="extension"?"Extensions":t.source==="skill"?"Skill Commands":t.source==="prompt"?"Prompt Commands":"Other Commands",a=n.get(r)??[];a.push(t),n.set(r,a)}for(let t of zu()){if(o.has(t.name.toLowerCase()))continue;let r=n.get("Extensions")??[];r.push({name:t.name,aliases:t.aliases,description:t.description}),n.set("Extensions",r)}for(let t of["Extensions","Skill Commands","Prompt Commands","Other Commands"])wa(t,n.get(t)??[]);console.log(s.dim("Special syntax:")),console.log(` ${s.cyan("@path")} Attach image to context`),console.log(` ${s.cyan("!command")} Execute shell command`),console.log(),console.log(s.dim("Skills:")),console.log(` ${s.cyan("/skill")} List all available skills`),console.log(` ${s.cyan("/<skill-name>")} Invoke a skill when no command has that name`),console.log(` ${s.cyan("/skill:<name>")} Compatibility form (e.g., /skill:code-review)`),console.log(` ${s.cyan("/skill pending")} Review pending skill learning suggestions`),console.log(),console.log(s.dim(`Tip: ${s.cyan("/<command> help")} shows command-specific help.`)),console.log()}i(ju,"printHelp");function Fu(e){let o=Ur({topic:e});if(console.log(`
|
|
631
|
+
${s.cyan(o.title)}`),console.log(o.content),o.topics.length>0){console.log();for(let n of o.topics)console.log(`- ${n.id}: ${n.summary}`)}o.topics.length===0&&o.nextTopics.length>0&&console.log(s.dim(`
|
|
632
|
+
Related topics: ${o.nextTopics.join(", ")}`)),console.log()}i(Fu,"printManualTopic");function dr(e,o=[]){ae.size===0&&Pn();let n=ae.get(e.toLowerCase());if(!n){let t=Ln(e);if(!t){console.log(s.yellow(`
|
|
633
|
+
[Unknown command: /${e}. Type /help for available commands]`));return}console.log(s.cyan(`
|
|
634
|
+
/${t.name}`)),t.aliases?.length&&console.log(s.dim(`Aliases: ${t.aliases.join(", ")}`)),console.log(s.dim(`
|
|
635
|
+
${t.description}`)),console.log(s.dim(`
|
|
636
|
+
Usage: ${Xu(t)}`)),console.log();return}n.detailedHelp?n.detailedHelp(o):(console.log(s.cyan(`
|
|
637
|
+
/${n.name}`)),n.aliases?.length&&console.log(s.dim(`Aliases: ${n.aliases.join(", ")}`)),console.log(s.dim(`
|
|
638
|
+
${n.description}`)),n.usage&&console.log(s.dim(`
|
|
639
|
+
Usage: ${n.usage}`)),console.log())}i(dr,"printDetailedHelp");async function Hu(e,o,n=[],t){let r=n[0]?.toLowerCase(),a=e.contextTokenSnapshot?.currentTokens??Do(e.messages),l=e.contextTokenSnapshot?.source??"estimate",c=cs(o.provider),d=us(o.provider,o.model,o.reasoningMode);if(console.log(s.bold(`
|
|
640
|
+
Session Status:
|
|
641
|
+
`)),console.log(s.dim(` Provider: ${s.cyan(o.provider)}${o.model?` / ${s.cyan(o.model)}`:""}`)),console.log(s.dim(` Permission: ${s.cyan(o.permissionMode)}`)),console.log(s.dim(` Reasoning: ${s.cyan(o.reasoningMode)}`)),console.log(s.dim(` Effort: ${s.cyan(ka(o.effort))}`)),console.log(s.dim(` Agent Mode: ${s.cyan(o.agentMode.toUpperCase())}`)),c){let f=Zn(c),m=c.transport==="cli-bridge"?s.yellow(f):s.cyan(f);console.log(s.dim(` Provider Cap: ${m}`))}if(d&&d.status!=="allow"){let f=d.status==="block"?s.red:s.yellow;console.log(s.dim(` Provider Policy: ${f(d.summary)}`))}console.log(s.dim(` Session ID: ${e.sessionId}`)),console.log(s.dim(` Messages: ${e.messages.length}`)),console.log(s.dim(` Tokens: ~${a} (${l})`));let u=await Ho({mode:o.repoIntelligenceMode,trace:o.repoIntelligenceTrace,probe:!0,workspaceRoot:cr(e)});console.log(s.dim(` Repo Intel: ${s.cyan(Nu(u))}`)),e.runtimeInfo?.workspaceRoot?console.log(s.dim(` Workspace: ${s.cyan(bt(e.runtimeInfo))}`)):e.gitRoot&&console.log(s.dim(` Workspace: ${s.cyan(e.gitRoot)}`)),(r==="workspace"||r==="worktree"||r==="runtime")&&(e.runtimeInfo?.canonicalRepoRoot&&console.log(s.dim(` Canonical: ${e.runtimeInfo.canonicalRepoRoot}`)),e.runtimeInfo?.executionCwd&&console.log(s.dim(` Exec CWD: ${e.runtimeInfo.executionCwd}`)),e.runtimeInfo?.workspaceKind&&console.log(s.dim(` Kind: ${e.runtimeInfo.workspaceKind}`))),r==="runtime"&&await Ku(t),await Bu(t),console.log(s.dim(` Created: ${e.createdAt}`)),console.log(s.dim(` Last Active: ${e.lastAccessed}`)),console.log()}i(Hu,"printStatus");async function Bu(e){if(e?.getLearningSummary)try{console.log(s.dim(` Learning: ${ft(await e.getLearningSummary())}`))}catch(o){console.log(s.dim(` Learning: unavailable (${o instanceof Error?o.message:String(o)})`))}}i(Bu,"printLearningSurfaceStatus");async function Ku(e){if(!e?.getRuntimeStatus){console.log(s.dim(" SDK Runtime: unavailable (host did not provide runtime status)"));return}let o;try{o=await e.getRuntimeStatus()}catch(t){console.log(s.dim(` SDK Runtime: unavailable (${t instanceof Error?t.message:String(t)})`));return}if(!o){console.log(s.dim(" SDK Runtime: unavailable"));return}console.log(s.dim(` SDK Runtime: ${s.cyan(o.mode)} profile=${s.cyan(o.profile)}`)),console.log(s.dim(` Runtime ID: ${o.runtimeId}`)),o.health&&console.log(s.dim(` Health: ${o.health}`)),o.endpoint&&console.log(s.dim(` Endpoint: ${o.endpoint}`)),o.startedAt&&console.log(s.dim(` Runtime Up: ${o.startedAt}`));let n=[eo("sessions",o.sessions),eo("runs",o.runs),eo("active",o.activeRuns),eo("queued",o.queuedRuns),eo("pending permissions",o.pendingPermissions),eo("workflows",o.workflows)].filter(t=>t!==void 0);n.length>0&&console.log(s.dim(` Runtime Ctrs: ${n.join(" ")}`))}i(Ku,"printRuntimeSurfaceStatus");function eo(e,o){return o===void 0?void 0:`${e}=${o}`}i(eo,"formatRuntimeCount");async function Gu(e,o){let n=ve(o.gitRoot);if(e[0]?.toLowerCase()==="reload"){let r=await ya(o.gitRoot);console.log(s.green(`
|
|
642
|
+
Skills reloaded: ${r} skill(s)`)),console.log(s.dim("Updated skills will apply to subsequent requests in this session.")),console.log();return}n.size===0&&await De(o.gitRoot),qu(n.listUserInvocable())}i(Gu,"handleSkillNamespaceCommand");function qu(e){if(console.log(s.bold(`
|
|
643
|
+
Available Skills:
|
|
644
|
+
`)),e.length===0){console.log(s.dim(" No skills found.")),console.log(s.dim(`
|
|
645
|
+
Skills can be placed in:`)),console.log(s.dim(" - .kodax/skills/")),console.log(s.dim(" - ~/.kodax/skills/")),console.log(s.dim(" - ~/.agents/skills/"));return}let o=_o(),n=e.map(r=>{let a=o.get(r.name)!==void 0||Ln(r.name)!==void 0;return{skill:r,invocation:a?`/skill:${r.name}`:`/${r.name}`,commandNameTaken:a}}),t=Math.max(...n.map(r=>r.invocation.length));for(let r of n){let{skill:a}=r,l=r.invocation.padEnd(t),c=a.argumentHint?` ${a.argumentHint}`:"",d=a.source==="builtin"?" [builtin]":a.source==="user"?" [user]":a.source==="plugin"?" [plugin]":"",u=r.commandNameTaken?" [command name exists]":"",f=a.description.length>50?a.description.slice(0,50)+"...":a.description;console.log(` ${s.cyan(l)}${s.dim(c)}${s.dim(d)}${s.dim(u)} ${s.dim(f)}`)}console.log(),console.log(s.dim(`Total: ${e.length} skills`)),console.log(s.dim("Usage: /<skill-name> [args], legacy /skill:<name> [args], or ask naturally")),console.log(s.dim("Review pending skill learning suggestions with /skill pending")),console.log()}i(qu,"printSkillsListPiMonoStyle");var ae=new fe;function Pn(e){ae.size>0||sr(ae,e)}i(Pn,"initCommandRegistry");function _o(e){return Pn(e),ae}i(_o,"getCommandRegistry");function zu(){return ne()?.listCommands().filter(o=>o.metadata?.userInvocable!==!1)??[]}i(zu,"getActiveExtensionCommands");function Ln(e){let o=ne(),n=e.trim().toLowerCase();if(!n)return;let t=o?.listCommands().find(r=>r.name.trim().toLowerCase()===n||(r.aliases??[]).some(a=>a.trim().toLowerCase()===n));if(t)return t.metadata?.userInvocable===!1?void 0:t}i(Ln,"getActiveExtensionCommand");function Xu(e){return e.usage??`/${e.name}`}i(Xu,"formatExtensionCommandUsage");function Vu(e){return Array.isArray(e)?e.map(o=>String(o)).join(", "):e&&typeof e=="object"?JSON.stringify(e):String(e)}i(Vu,"formatExtensionDiagnosticValue");function Yu(e){if(!e)return;let o=Object.entries(e).filter(([,n])=>n!==void 0).map(([n,t])=>`${n}=${Vu(t)}`);return o.length>0?o.join(" | "):void 0}i(Yu,"formatExtensionDiagnosticMetadata");function no(e){let o=e.getDiagnostics;if(typeof o=="function")return o.call(e);let n=e.getDefaults,t=typeof n=="function"?n.call(e):void 0;return{loadedExtensions:[],capabilityProviders:e.listCapabilityProviders().map(r=>({id:r.id,kinds:[...r.kinds],source:{kind:"extension",id:`extension:${r.id}`,label:r.id,path:"(runtime)"}})),commands:e.listCommands().map(r=>({name:r.name,aliases:r.aliases,description:r.description,usage:r.usage,metadata:r.metadata,source:{kind:"extension",id:`extension-command:${r.name}`,label:r.name,path:"(runtime)"}})),tools:[],hooks:[],failures:[],defaults:{activeTools:t?.activeTools,modelSelection:t?.modelSelection??{},thinkingLevel:t?.thinkingLevel}}}i(no,"getExtensionRuntimeDiagnostics");function Ju(e,o){if(o.invocation)return{prompt:o.invocation.prompt,source:"extension",displayName:o.invocation.displayName??`/${e.name}`,disableModelInvocation:o.invocation.disableModelInvocation,allowedTools:o.invocation.allowedTools,context:o.invocation.context,model:o.invocation.model}}i(Ju,"toExtensionInvocationRequest");function Zu(e){return e.map(o=>{if(typeof o=="string")return o;if(o instanceof Error)return o.stack??o.message;try{return JSON.stringify(o)}catch{return String(o)}}).join(" ")}i(Zu,"formatDiagnosticParts");function Cn(e,o,n){K({source:e,level:o,message:Zu(n)})}i(Cn,"emitCommandDiagnostic");async function Qu(e,o,n){let t=ne();if(!t)return console.log(s.yellow(`
|
|
646
|
+
[Extension runtime is not active for /${e.name}]`)),!1;let r=await e.handler(o,{sessionId:n.sessionId,gitRoot:n.gitRoot,workingDirectory:n.runtimeInfo?.executionCwd??n.gitRoot??process.cwd(),reloadExtensions:i(()=>t.reloadExtensions(),"reloadExtensions"),getDiagnostics:i(()=>no(t),"getDiagnostics"),logger:{debug:i((...l)=>Cn(`repl:extension-command:${e.name}`,"debug",l),"debug"),info:i((...l)=>Cn(`repl:extension-command:${e.name}`,"info",l),"info"),warn:i((...l)=>Cn(`repl:extension-command:${e.name}`,"warn",l),"warn"),error:i((...l)=>Cn(`repl:extension-command:${e.name}`,"error",l),"error")}});if(!r)return!0;r.message&&console.log(r.message);let a=Ju(e,r);return a?{invocation:a}:!0}i(Qu,"executeExtensionCommand");function Oy(e){let o=e.trim();if(!o.startsWith("/"))return null;let n=o.slice(1).split(/\s+/),r=n[0]?.toLowerCase(),a=n.slice(1).filter(Boolean);if(!r)return null;if(r.startsWith("skill:")){let c=r.slice(6);return c?{command:"skill",args:a,skillInvocation:{name:c}}:{command:"skill",args:a}}let l=r.indexOf(":");if(l>0){let c=r.slice(l+1).trim();r=r.slice(0,l),a=c?[c,...a]:a}return{command:r,args:a}}i(Oy,"parseCommand");function ha(e){let o=e[0]?.trim().toLowerCase();return o==="help"||o==="--help"||o==="-h"}i(ha,"isCommandHelpRequest");async function Ny(e,o,n,t){if(ae.size===0&&Pn(o.gitRoot),e.skillInvocation)return await lr({command:e.skillInvocation.name,args:e.args},o);let r=ae.get(e.command);if(r){if(r.userInvocable===!1)return console.log(s.yellow(`
|
|
647
|
+
[Command /${r.name} is not user-invocable]`)),!1;if(ha(e.args))return dr(e.command,e.args.slice(1)),!0;try{let d=await r.handler(e.args,o,n,t);return d&&typeof d=="object"?d:!0}catch(d){return console.log(s.red(`
|
|
648
|
+
[Command failed: ${d instanceof Error?d.message:String(d)}]`)),!1}}let a=Ln(e.command);if(a){if(ha(e.args))return dr(e.command),!0;try{return await Qu(a,e.args,o)}catch(d){return console.log(s.red(`
|
|
649
|
+
[Extension command failed: ${d instanceof Error?d.message:String(d)}]`)),!1}}let l=await ef(e,o);if(l)return await lr({command:l.skill.name,args:l.args},o);let c=await $a(e.command,o);return c?await lr({command:c.name,args:e.args},o):(console.log(s.yellow(`
|
|
650
|
+
[Unknown command: /${e.command}. Type /help for available commands]`)),!1)}i(Ny,"executeCommand");async function ef(e,o){let n=e.args[0];if(!n)return;let t=`${e.command}:${n}`,r=await $a(t,o);if(r)return{skill:r,args:e.args.slice(1)}}i(ef,"resolveNamespacedDirectSkillCommand");async function $a(e,o){let n=ve(o.gitRoot);n.size===0&&await De(o.gitRoot);let t=n.get(e);return t?.userInvocable?t:void 0}i($a,"resolveDirectSkillCommand");async function lr(e,o){let n=ve(o.gitRoot),t=e.command,r=e.args.join(" ");n.size===0&&await De(o.gitRoot);try{let a=n.get(t);if(!a)return console.log(s.red(`
|
|
651
|
+
[Skill not found: ${t}]`)),!1;if(!a.userInvocable)return console.log(s.yellow(`
|
|
652
|
+
[Skill "${t}" is not user-invocable]`)),!1;console.log(s.cyan(`
|
|
653
|
+
[Invoking skill: ${t}]`)),a.argumentHint&&console.log(s.dim(`Arguments: ${r||"(none)"}`)),console.log();let l=await n.loadFull(t),c={workingDirectory:process.cwd(),projectRoot:o.gitRoot??void 0,sessionId:o.sessionId,environment:{},executeDynamicContext:o.skillDynamicContext?.execute,disableDynamicContext:o.skillDynamicContext?.disable},d=await _r(l,r,c);return console.log(s.green(`Skill activated: ${t}`)),console.log(s.dim("The skill context has been prepared for the AI.")),console.log(),{invocation:{prompt:d.content,source:"skill",displayName:t,path:l.skillFilePath,disableModelInvocation:d.disableModelInvocation,userInvocable:l.userInvocable,allowedTools:l.allowedTools,context:l.context,agent:l.agent,argumentHint:l.argumentHint,model:l.model,hooks:l.hooks,skillInvocation:{name:t,path:l.skillFilePath,description:l.description,arguments:r||void 0,allowedTools:l.allowedTools,context:l.context,agent:l.agent,argumentHint:l.argumentHint,model:l.model,hookEvents:l.hooks?Object.entries(l.hooks).filter(([,u])=>Array.isArray(u)&&u.length>0).map(([u])=>u):void 0,expandedContent:d.content}}}}catch(a){return console.log(s.red(`
|
|
654
|
+
[Error invoking skill: ${a instanceof Error?a.message:String(a)}]`)),!1}}i(lr,"executeSkillCommand");var Mn=class{static{i(this,"SkillCompleter")}gitRoot;constructor(o){this.gitRoot=o}canComplete(o,n){return this.parseTrigger(o.slice(0,n))!==void 0}async getCompletions(o,n){let t=this.parseTrigger(o.slice(0,n));if(!t)return[];let r=t.partial.toLowerCase();return(await this.getSkills()).filter(l=>{let c=l.name.toLowerCase();return c.includes(r)||this.fuzzyIncludes(r,c)}).map(l=>({text:`${t.invocationPrefix}${l.name}`,display:l.name,description:this.truncateDescription(l.description),type:"skill"})).sort((l,c)=>{let d=l.display.toLowerCase().startsWith(r),u=c.display.toLowerCase().startsWith(r);return d&&!u?-1:!d&&u?1:l.display.length-c.display.length})}setGitRoot(o){this.gitRoot!==o&&(this.gitRoot=o)}parseTrigger(o){let n=o.match(/(^|\s)\/skill:([^\s]*)$/);if(n)return{partial:n[2]??"",invocationPrefix:"/skill:"};let t=o.match(/(^|\s)\/([^\s]*)$/);if(t)return{partial:t[2]??"",invocationPrefix:"/"}}async getSkills(){try{let o=ve(this.gitRoot);return o.size===0&&await De(this.gitRoot),o.listUserInvocable()}catch{return[]}}fuzzyIncludes(o,n){let t=0;for(let r=0;r<n.length&&t<o.length;r+=1)n[r]===o[t]&&(t+=1);return t===o.length}truncateDescription(o,n=50){return o.length<=n?o:o.slice(0,n-3)+"..."}};import{exec as of}from"node:child_process";import*as to from"node:path";import{promisify as nf}from"node:util";var xa=nf(of);function tf(e){let o=e.slice(3);if(!o)return;let n=o.indexOf(" -> ");return(n===-1?o:o.slice(n+4)).replace(/^"(.*)"$/,"$1").trim()||void 0}i(tf,"pathFromPorcelainLine");async function Aa(e,o=10){try{let[{stdout:n},{stdout:t}]=await Promise.all([xa("git rev-parse --show-toplevel",{cwd:e,windowsHide:!0}),xa("git status --porcelain=v1 -uall",{cwd:e,windowsHide:!0})]),r=n.trim(),a=[],l=new Set;for(let c of t.split(`
|
|
655
|
+
`)){if(!c.trim())continue;let d=tf(c);if(!d)continue;let u=to.resolve(r,d),f=to.relative(e,u).split(to.sep).join("/");if(!(!f||f.startsWith("..")||l.has(f))&&(l.add(f),a.push(f),a.length>=o))break}return a}catch{return[]}}i(Aa,"getRecentWorkingSetFiles");function ro(e){let o=e.lastIndexOf("/");if(o===-1)return-1;for(;o>0&&!/\s/.test(e[o-1]??"");)if(o=e.lastIndexOf("/",o-1),o===-1)return-1;return o}i(ro,"findCommandSlashIndex");var ur=class{static{i(this,"FileCompleter")}cwdSource;cache=new Map;cacheTimeout=5e3;recentCache=new Map;recentFilesProvider;constructor(o,n=Aa){this.cwdSource=o,this.recentFilesProvider=n}canComplete(o,n){let t=o.slice(0,n),r=t.lastIndexOf("@");return!(r===-1||r>0&&!/\s/.test(t[r-1]??"")||t.slice(r+1).includes(" "))}async getCompletions(o,n){let t=o.slice(0,n),r=t.lastIndexOf("@");if(r===-1)return[];let a=t.slice(r+1),l=[],c=this.resolveCwd(),d=a.lastIndexOf("/"),u=d===-1?c:Wo.join(c,a.slice(0,d)),f=d===-1?a:a.slice(d+1);try{let b=(await this.readdir(u)).filter(S=>S.toLowerCase().startsWith(f.toLowerCase()));for(let S of b){let C=Wo.join(u,S),A=await this.isDirectory(C),v=d===-1?S:a.slice(0,d+1)+S;l.push({text:"@"+v+(A?"/":""),display:S+(A?"/":""),description:A?"directory":"file",type:"file"})}}catch{}if(d===-1){let m=await this.getRecentFiles(c),b=new Set(l.map(A=>A.text)),S=f.toLowerCase(),C=[];for(let A of m){if(f&&!Wo.basename(A).toLowerCase().startsWith(S))continue;let v="@"+A;b.has(v)||(b.add(v),C.push({text:v,display:A,description:"recent",type:"file"}))}l.unshift(...C)}return l}async getRecentFiles(o){let n=Date.now(),t=this.recentCache.get(o);if(t&&t.expiresAt>n)return t.files;let r=await this.recentFilesProvider(o);return this.recentCache.set(o,{files:r,expiresAt:Date.now()+this.cacheTimeout}),r}resolveCwd(){return typeof this.cwdSource=="function"?this.cwdSource():this.cwdSource??process.cwd()}async readdir(o){let n=Date.now(),t=this.cache.get(o);return t&&t.expiresAt>n?t.entries:(t&&this.cache.delete(o),new Promise(r=>{_n.readdir(o,(a,l)=>{a?r([]):(this.cache.set(o,{entries:l,expiresAt:Date.now()+this.cacheTimeout}),r(l))})}))}async isDirectory(o){return new Promise(n=>{_n.stat(o,(t,r)=>{n(!t&&r.isDirectory())})})}},fr=class{static{i(this,"CommandCompleter")}commands;constructor(){this.commands=new Map,this.loadCommands()}loadCommands(){for(let n of _o().getAll())n.userInvocable!==!1&&this.commands.set(n.name,{description:n.description,aliases:n.aliases??[]});let o=ne();for(let n of o?.listCommands()??[])n.metadata?.userInvocable!==!1&&this.commands.set(n.name,{description:n.description,aliases:n.aliases??[]})}canComplete(o,n){let t=o.slice(0,n),r=ro(t);return r===-1?!1:!t.slice(r).includes(" ")}async getCompletions(o,n){let t=o.slice(0,n),r=ro(t);if(r===-1)return[];this.commands.clear(),this.loadCommands();let a=t.slice(r+1).toLowerCase(),l=[];for(let[c,d]of this.commands){this.fuzzyMatch(a,c)&&l.push({text:"/"+c,display:"/"+c,description:d.description,type:"command"});for(let u of d.aliases)u!==c&&this.fuzzyMatch(a,u)&&l.push({text:"/"+u,display:"/"+u,description:`Alias for /${c}: ${d.description}`,type:"command"})}return l}fuzzyMatch(o,n){if(!o)return!0;let t=o.toLowerCase(),r=n.toLowerCase(),a=0;for(let l=0;l<r.length&&a<t.length;l++)r[l]===t[a]&&a++;return a===t.length}};function Jy(e){let o=new ur(e),n=new Mn,t=new fr;return async r=>{let a=r.includes("@"),l=r.includes("/");if(!a&&!l)return[[],r];let c=[];if(l){let u=await rf(r,r.length);c.push(...u)}if(l&&n.canComplete(r,r.length)){let u=await n.getCompletions(r,r.length);c.push(...u)}if(l&&t.canComplete(r,r.length)){let u=await t.getCompletions(r,r.length);c.push(...u)}if(a&&o.canComplete(r,r.length)){let u=await o.getCompletions(r,r.length);c.push(...u)}return[c.map(u=>sf(r,u)),r]}}i(Jy,"createCompleter");async function rf(e,o){let{ArgumentCompleter:n}=await import("./argument-completer-FXRZFMTC.js"),t=new n;return t.canComplete(e,o)?t.getCompletions(e,o):[]}i(rf,"getArgumentCompletions");function sf(e,o){if(o.type!=="argument")return o.text;let n=ro(e);if(n!==-1&&!/\s/.test(e.slice(n)))return`${e} ${o.text}`;let r=e.match(/\S+$/)?.[0]??"";return`${r?e.slice(0,e.length-r.length):e}${o.text}`}i(sf,"formatReadlineCompletion");import{existsSync as Wn,readdirSync as Ia,readFileSync as Ta}from"node:fs";import{join as On}from"node:path";var af=[{name:"plan",description:"Read-only planning mode - blocks all modifications",type:"enum"},{name:"accept-edits",description:"File edits auto-approved, bash requires confirmation",type:"enum"},{name:"auto",description:"Use auto-mode classifier for tool permissions",type:"enum"}],so=[{name:"none",description:"Disable reasoning when the model supports it",type:"enum"},{name:"auto",description:"Clear the explicit effort override",type:"enum"},{name:"low",description:"Use low reasoning effort",type:"enum"},{name:"medium",description:"Use medium reasoning effort",type:"enum"},{name:"high",description:"Use high reasoning effort",type:"enum"},{name:"xhigh",description:"Use extra-high reasoning effort",type:"enum"},{name:"max",description:"Use maximum reasoning effort",type:"enum"}];function lf(e){if(e&&e.includes("/")){let o=e.indexOf("/"),n=e.slice(0,o),t=e.slice(o+1);if(Oe(n))try{return Be(n).filter(a=>!t||a.toLowerCase().includes(t.toLowerCase())).map(a=>({name:`${n}/${a}`,description:a,type:"enum"}))}catch{}return[]}return Ne().map(o=>({name:o,description:`Switch to ${o} provider`,type:"enum"}))}i(lf,"getModelArgs");var mr=[{name:"workspace",description:"Inspect current workspace/runtime truth in more detail",type:"enum"},{name:"runtime",description:"Alias for workspace runtime inspection",type:"enum"},{name:"worktree",description:"Alias for workspace runtime inspection",type:"enum"}],pr=[{name:"all",description:"Delete ALL sessions",type:"enum"}],cf=[{name:"status",description:"Show MCP server status",type:"enum"},{name:"refresh",description:"Refresh MCP server catalogs",type:"enum"}],df=[{name:"status",description:"Show child-task fallback order",type:"enum"},{name:"off",description:"Disable child-task fallback providers",type:"enum"}],uf=[{name:"llm",description:"Use LLM classifier for auto mode",type:"enum"},{name:"rules",description:"Use rules-only auto mode",type:"enum"}],Ra=[{name:"ama",description:"Use AMA agent mode",type:"enum"},{name:"sa",description:"Use single-agent mode",type:"enum"},{name:"toggle",description:"Cycle to the next agent mode",type:"enum"}],Ea=[{name:"on",description:"Enable logging",type:"enum"},{name:"off",description:"Disable logging",type:"enum"}],ff=[{name:"list",description:"List project memory files",type:"enum"},{name:"pending",description:"List pending memory proposals",type:"enum"},{name:"show",description:"Preview a memory proposal",type:"enum"},{name:"approve",description:"Approve a memory proposal",type:"enum"},{name:"reject",description:"Reject a memory proposal",type:"enum"},{name:"curate",description:"Report memory governance findings",type:"enum"},{name:"rebuild",description:"Rebuild MEMORY.md index",type:"enum"},{name:"open",description:"Print the memory entrypoint path",type:"enum"},{name:"help",description:"Show memory help",type:"enum"}],mf=[{name:"list",description:"List learned capabilities",type:"enum"},{name:"show",description:"Inspect one exact learned capability",type:"enum"},{name:"review",description:"Start or restart bounded canary review",type:"enum"},{name:"trust",description:"Explicitly trust a reviewed revision",type:"enum"},{name:"reject",description:"Reject a learned capability",type:"enum"},{name:"disable",description:"Disable an active learned capability",type:"enum"},{name:"rollback",description:"Restore the previous good revision",type:"enum"},{name:"promote",description:"Promote an exact revision to the user Skill catalog",type:"enum"},{name:"help",description:"Show Learning Center help",type:"enum"}];function pf(e){let[o=""]=e,n=o.toLowerCase(),t=e.length===1&&e[0]===""?0:e.length;return t<=1?mf:n==="help"&&t<=2?[{name:"promote",description:"Show dedicated promotion help",type:"enum"}]:n!=="promote"?[]:t<=2?[{name:"--help",description:"Show dedicated promotion help",type:"enum"}]:t<=3?[{name:"--scope",description:"Choose the formal user Skill scope",type:"enum"}]:e[2]?.toLowerCase()==="--scope"&&t<=4?[{name:"user",description:"Promote to the formal user Skill catalog",type:"enum"}]:[]}i(pf,"getLearnArgs");var gf=[{name:"status",description:"Show current persistent goal",type:"enum"},{name:"pause",description:"Pause the active goal",type:"enum"},{name:"resume",description:"Resume a paused goal",type:"enum"},{name:"clear",description:"Clear the current goal",type:"enum"},{name:"help",description:"Show goal help",type:"enum"},{name:"--tokens",description:"Set an optional goal token budget",type:"enum"}],wf=[{name:"show",description:"Show a captured paste by id",type:"enum"},{name:"list",description:"List captured pastes",type:"enum"}],hf=[{name:"--lean",description:"Add a minimal-diff/YAGNI review pass",type:"enum"},{name:"--workflow",description:"Review through a dynamic workflow",type:"enum"},{name:"base",description:"Review changes against the detected base branch",type:"enum"},{name:"sha",description:"Review a specific commit",type:"enum"},{name:"help",description:"Show review help",type:"enum"}],yf=[{name:"init",description:"Create AGENTS.md in the target project if absent",type:"enum"},{name:"lean",description:"Initialize or LLM-review AGENTS.md for Lean Mode guidance",type:"enum"},{name:"help",description:"Show agents help",type:"enum"}],vf=[{name:"status",description:"Inspect the current repo-intelligence runtime state",type:"enum"},{name:"mode",description:"Switch repo-intelligence runtime mode",type:"enum"},{name:"trace",description:"Toggle repo-intelligence trace output",type:"enum"}],kf=[{name:"auto",description:"Let KodaX pick the best repo-intelligence engine",type:"enum"},{name:"full",description:"Prefer the full repo-intelligence engine",type:"enum"},{name:"light",description:"Use the light repo-intelligence engine",type:"enum"},{name:"off",description:"Disable repo-intelligence injection",type:"enum"}],bf=[{name:"on",description:"Enable repo-intelligence trace output",type:"enum"},{name:"off",description:"Disable repo-intelligence trace output",type:"enum"},{name:"toggle",description:"Toggle repo-intelligence trace output",type:"enum"}],Sf=[{name:"status",description:"Deprecated alias for /repo-intel status",type:"enum"}],$f=[{name:"list",description:"List built-in and saved workflows",type:"enum"},{name:"create",description:"Generate and run a workflow from a request",type:"enum"},{name:"runs",description:"List active and recent workflow runs",type:"enum"},{name:"show",description:"Show latest run or a specific workflow run",type:"enum"},{name:"pause",description:"Pause future child launches for a run",type:"enum"},{name:"resume",description:"Resume a paused run",type:"enum"},{name:"stop",description:"Stop an active workflow run",type:"enum"},{name:"delete",description:"Delete one persisted workflow run or generated saved capsule",type:"enum"},{name:"prune",description:"Preview or delete old terminal workflow runs",type:"enum"},{name:"rerun",description:"Rerun a run id or saved workflow name",type:"enum"},{name:"save",description:"Save a generated run as a workflow capsule",type:"enum"},{name:"rename",description:"Rename a run display name or saved workflow capsule",type:"enum"},{name:"revise",description:"Generate a revised workflow capsule",type:"enum"},{name:"help",description:"Show workflow help",type:"enum"}],xf=new Set(["show","pause","resume","stop","delete","rerun","save","rename","revise"]),Af=new Set(["show","delete","rerun","save","rename","revise"]),Rf=[{name:"--all",description:"Show all persisted workflow runs",type:"enum"},{name:"--limit",description:"Show at most N persisted workflow runs",type:"enum"}],Ef=[{name:"--dry-run",description:"Preview cleanup without deleting runs",type:"enum"},{name:"--keep",description:"Keep the newest N terminal runs",type:"enum"},{name:"--older-than",description:"Delete terminal runs older than Nd or Nh",type:"enum"}],Cf=[{name:"--force",description:"Delete stale non-terminal run records",type:"enum"},{name:"--run",description:"Treat the target as a workflow run record",type:"enum"},{name:"--saved",description:"Treat the target as a generated saved workflow capsule",type:"enum"}],If=[".workflow.json",".ts",".mjs",".js"];function Tf(e,o){switch(e){case"pause":return o==="running";case"resume":return o==="paused";case"stop":return o==="running"||o==="paused";case"delete":return o!=="running"&&o!=="paused";default:return!0}}i(Tf,"workflowRunMatchesSubcommand");function Nn(e){return/^[a-zA-Z0-9._-]{1,120}$/.test(e)&&!e.startsWith(".")&&!e.includes("..")}i(Nn,"isWorkflowRunEntryName");function Pf(e,o){let n=On(e,"workflow-metadata.json");if(Wn(n))try{let r=JSON.parse(Ta(n,"utf8"));if(typeof r=="object"&&r!==null){let a=r.displayName;if(typeof a=="string"&&Nn(a.trim()))return a.trim()}}catch{}let t=o.displayName;return typeof t=="string"&&Nn(t.trim())?t.trim():void 0}i(Pf,"readWorkflowRunDisplayName");function Lf(){let e=Re(process.cwd()).key,o=_("workflow-runs",e);if(!Wn(o))return[];let n=[];for(let t of Ia(o)){if(!Nn(t))continue;let r=On(o,t,"run.json");if(Wn(r))try{let a=JSON.parse(Ta(r,"utf8")),l=typeof a.workflow=="string"?a.workflow:"?",c=typeof a.status=="string"?a.status:"?",d=typeof a.endedAt=="number"?a.endedAt:0;n.push({arg:{name:t,description:`${l} - ${c}`,type:"string"},endedAt:d});let u=Pf(On(o,t),a);u&&u!==t&&n.push({arg:{name:u,description:`${l} alias for ${t} - ${c}`,type:"string"},endedAt:d})}catch{}}return n.sort((t,r)=>r.endedAt-t.endedAt).map(t=>t.arg)}i(Lf,"getPersistedWorkflowRunIdArgs");function Dn(e){let o=Fe().list().filter(r=>Tf(e,r.status)).map(r=>({name:r.runId,description:`${r.workflow} - ${r.status}`,type:"string"})),n=Af.has(e)?Lf():[],t=new Set;return[...o,...n].filter(r=>t.has(r.name)?!1:(t.add(r.name),!0))}i(Dn,"getWorkflowRunIdArgs");function Mf(e){for(let o of If)if(e.endsWith(o)){let n=e.slice(0,-o.length);return Nn(n)?n:void 0}}i(Mf,"savedWorkflowNameFromFile");function Oo(e={}){let o=[{path:_("workflows"),source:"personal"},{path:On(process.cwd(),".kodax","workflows"),source:"project"}],n=new Map;for(let t of o)if(Wn(t.path))try{for(let r of Ia(t.path)){if(e.generatedOnly===!0&&!r.endsWith(".workflow.json"))continue;let a=Mf(r);a&&n.set(a,{name:a,description:`${t.source} saved workflow`,type:"enum"})}}catch{}return[...n.values()].sort((t,r)=>t.name.localeCompare(r.name))}i(Oo,"getSavedWorkflowNameArgs");function _f(){let e=new Map;for(let o of Dn("rerun"))e.set(o.name,{...o,description:`recent run: ${o.description}`,type:"string"});for(let o of Oo()){let n=e.get(o.name);if(n){e.set(o.name,{...n,description:`${n.description}; also ${o.description}`});continue}e.set(o.name,{...o,description:o.description,type:"string"})}return[...e.values()]}i(_f,"getWorkflowRerunArgs");function gr(e){let o=new Map;for(let n of Dn(e))o.set(n.name,{...n,description:`workflow run: ${n.description}`,type:"string"});for(let n of Oo({generatedOnly:e==="delete"})){let t=o.get(n.name);if(t){o.set(n.name,{...t,description:`${t.description}; also ${n.description}`});continue}o.set(n.name,{...n,description:n.description,type:"string"})}return[...o.values()]}i(gr,"getWorkflowRunOrSavedNameArgs");function Ca(e){let o=new Set(e.slice(1).filter(n=>n.startsWith("--")));return o.has("--saved")?Oo({generatedOnly:!0}):o.has("--run")?Dn("delete"):gr("delete")}i(Ca,"getWorkflowDeleteTargetArgs");function Wf(e){let[o=""]=e,n=o.toLowerCase(),t=e.length===1&&e[0]===""?0:e.length;if(t<=1)return[...$f,...qo().map(r=>({name:r.name,description:r.description,type:"enum"})),...Oo()];if(n==="rerun"&&t<=2)return _f();if(n==="rename"&&t<=2)return gr("rename");if(n==="delete"&&t<=2)return[...Cf,...Ca(e)];if(n==="delete"&&t<=3&&e.slice(1).some(r=>r.startsWith("--")))return Ca(e);if(n==="revise"){if(t<=2)return[{name:"--replace",description:"Replace a saved workflow after confirmation",type:"enum"},...gr("revise")];if(e[1]==="--replace"&&t<=3)return Oo()}return xf.has(n)&&t<=2?Dn(n):n==="runs"&&t<=2?Rf:n==="prune"&&t<=2?Ef:[]}i(Wf,"getWorkflowArgs");function Of(e){let[o=""]=e,n=o.toLowerCase(),t=e.length===1&&e[0]===""?0:e.length;return t<=1?vf:t>2?[]:n==="mode"?kf:n==="trace"?bf:[]}i(Of,"getRepoIntelArgs");var Nf=new Map([["mode",af],["thinking",so],["think",so],["t",so],["reasoning",so],["reason",so],["effort",so],["status",mr],["info",mr],["ctx",mr],["mcp",cf],["fallback",df],["auto-engine",uf],["agent-mode",Ra],["am",Ra],["verifier-log",Ea],["stall-log",Ea],["memory",ff],["goal",gf],["paste",wf],["review",hf],["agents",yf],["delete",pr],["rm",pr],["del",pr]]),Df=new Set(["model","m","provider"]),Uf=new Set(["repo-intel"]),jf=new Set(["repointel","ri"]),Ff=new Set(["workflow"]),Hf=new Set(["learn"]);function wr(e,o,n=[]){let t=e.toLowerCase();return Df.has(t)?lf(o):Uf.has(t)?Of(n):jf.has(t)?n.length<=1?Sf:[]:Ff.has(t)?Wf(n):Hf.has(t)?pf(n):Nf.get(t)??[]}i(wr,"getCommandArguments");var hr=class{static{i(this,"ArgumentCompleter")}canComplete(o,n){let t=o.slice(0,n),r=ro(t);if(r===-1)return!1;let a=t.slice(r),l=a.split(/\s+/);if(l.length>=2&&l[0]!=="")return!0;let c=a.slice(1).toLowerCase();return wr(c).length>0}async getCompletions(o,n){let t=o.slice(0,n),r=ro(t);if(r===-1)return[];let a=t.slice(r),l=a.indexOf(" "),c=(l===-1?a.slice(1):a.slice(1,l)).toLowerCase(),d=l===-1?"":a.slice(l+1),u=d?d.split(/\s+/):[""],f=u.length-1,m=(u[f]??"").toLowerCase(),b=wr(c,m,u);if(!b||b.length===0)return[];let S=new Set(u.slice(0,-1).map(A=>A.toLowerCase()));return b.filter(A=>!S.has(A.name.toLowerCase())).filter(A=>!m||A.name.includes("/")?!0:A.name.toLowerCase().includes(m)).map(A=>({text:A.name,display:A.name,description:A.description,type:"argument"})).sort((A,v)=>{if(!m)return 0;let x=A.display.toLowerCase().startsWith(m),M=v.display.toLowerCase().startsWith(m);return x&&!M?-1:!x&&M?1:A.display.length-v.display.length})}};function dv(){return new hr}i(dv,"createArgumentCompleter");export{pt as a,B as b,_p as c,si as d,Wp as e,Jo as f,_a as g,zf as h,Wa as i,Xf as j,Zo as k,ks as l,go as m,ho as n,Ge as o,qe as p,Cs as q,Is as r,Ts as s,Ns as t,Ds as u,rt as v,js as w,pl as x,hl as y,np as z,hp as A,yl as B,dt as C,yp as D,vp as E,Qs as F,Rp as G,ri as H,te as I,li as J,ci as K,Fp as L,_l as M,Xl as N,Hp as O,rn as P,wt as Q,Bp as R,vi as S,Kp as T,Gp as U,qp as V,hg as W,yg as X,vg as Y,Ci as Z,bt as _,Ii as $,Re as aa,Ag as ba,xo as ca,Et as da,Ie as ea,pd as fa,gd as ga,Xi as ha,Jg as ia,Zg as ja,Cd as ka,Xw as la,Vw as ma,Yw as na,gh as oa,wh as pa,hh as qa,yh as ra,vh as sa,aa as ta,Ah as ua,Rh as va,ca as wa,Eh as xa,qh as ya,da as za,_o as Aa,Oy as Ba,Ny as Ca,Mn as Da,hr as Ea,dv as Fa,ro as Ga,ur as Ha,fr as Ia,Jy as Ja};
|